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. 版 本 8.0.10 
E.143. 
. 版 本 8.0.8 
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Appendix G. 额外 提供 的 程序 
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Appendix I. 源 代码 库 
1.1. 获得 源 代 码 通过 Git 
Appendix J. 文档 


J.1. DocBook 

J.2. TAR 
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来 源 : PostgreSQL 9.3.1 中 文 手册 


Dll 


Table of Contents 


{E 4 PostgreSQL ? 
PostgreSQL ff 2 
格式 约定 
更 多 信息 


臭虫 汇报 指导 


本 书 是 PostgreSQL 的 官方 文档 。 它 是 由 PostgreSQL 开 发 人 员 和 其 它 志愿 者 撰写 的 ， 并 且 和 与 
PostgreSQL 软 件 的 开发 同步 进行 。 它 描述 了 当前 版 本 的 PostgreSQL 官 方 支持 的 所 有 功能 。 


为 了 便于 管理 有 关 PostgreSQL 的 大 量 信息 ， 本 书 被 组 织 成 了 几 个 部 分 。 不 同 的 部 分 针对 在 
PostgreSQL 上 有 着 不 同 经 验 、 不 同 认 识 层 次 、 不 同 阶段 的 用 户 : 


Part | 是 一 个 给 新 用 户 的 非 正 式 介 绍 。 


Part ll 记载 了 SQL 查 询 语 言 环境 ， 包 括 数据 类 型 和 男 数 以 及 用 户 层 次 的 性 能 调 优 。 每 个 
PostgreSQL 用 户 都 应 该 阅读 这 些 内 容 。 


Part 川 描述 了 服务 器 的 安装 和 管理 。 每 个 运行 PostgreSQL 的 人 ， 不 管 是 个 人 使 用 还 是 为 
别人 维护 ， 都 应 该 阅读 这 部 分 内 容 。 


Part IV 描 述 PostgreSQL 客 户 端 程序 的 编程 接口 。 


Pat V 包含 了 那些 给 高 级 用 户 查 看 的 信息 。 其 中 的 内 容 包括 用 户 定义 数据 类 型 和 郴 数 
等 。 


Part VI 包含 了 有 关 SQL 命 邻 的 参考 信息 以 及 客户 端 和 服务 器 程序 开发 的 信息 。 这 部 分 支 
持 其 它 部 分 ， 其 中 的 信息 是 结构 化 组 织 并 且 按 照 命 令 / 程 序 名 排序 的 。 


Part Vll 包 含 可 能 用 于 PostgreSQL 开 发 人 员 的 分 类 信息 。 


1 4 PostgreSQL ? 


PostgreSQL 是 以 加 州 大 学 伯克利 分 校 计算 机 系 开 发 的 POSTGRES, Version 4.2 为 基础 的 对 象 
关系 型 数据 库 管 理 系统 (ORDBMS)。POSTGRES 开 创 的 许多 概念 在 很 久 以 后 才 出 现在 商业 数 
据 库 中 。 


PostgreSQL 是 最 初 伯克利 代码 的 一 个 开放 源码 的 继承 者 。 它 支持 大 部 分 SQL 标准 并 且 提 供 了 
许多 其 它 现代 特性 : 


e BREN 

。 外 键 

。 触发 器 

。 可 更 新 的 视图 
。 事务 完整 性 

。 多 版 本 并 发 控制 


另外 ，PostgreSQL 可 以 用 许多 方法 进行 扩展 ， 上 比如 通过 增加 新 的 : 


。 数据 类 型 
。 KR 

。 操作 符 
。 聚合 西数 
。 索引 方法 


。 过 程 语 言 


并 且 ， 因 为 许可 证 的 有 灵活， 任何 人 都 可 以 以 任何 目的 免费 人 使用、 修改、 分 发 PostgreSQL， 不 
管 是 私 用 、 商 用 、 还 是 学 术 研 究 使 用 。 


PostgreSQL fj # 


现在 被 称 为 PostgreSQL 的 对 象 -关系 型 数据 库 管理 系统 是 从 美国 加 州 大 学 伯克利 分 校 编写 的 
POSTGRES 软 件 包 发 展 而 来 的 。 经 过 二 十 几 年 的 发 展 ，PostgreSQL 是 目前 世界 上 可 以 获得 
的 最 先进 的 开放 源码 数据 库 系统 。 


Berkeley 的 POSTGRES 项 目 


Michael Stonebraker 领 导 的 POSTGRES 项 目 是 由 防务 高 级 研究 项 目 局 (DARPA)、 陆 军 研究 
办 公 室 (ARO)、 国 家 科学 基金 (NSF)、ESL 公 司 共同 赞助 的 。POSTGRES 的 实现 始 于 1986 
年 ， 该 系统 最 初 的 概念 详 见 POSTGRES 的 设计 ， 最 早 的 数据 模型 定义 见 POSTGRES 数 据 
模型 。 当 时 的 规则 系统 设计 在 POSTGRES 规 则 系统 的 设计 里 描述 。 存 储 管理 器 的 理论 基础 
和 体系 结构 在 POSTGRES 存 储 系统 设计 里 有 详细 描述 。 


从 那 以 后 ，POSTGRES 经 历 了 几 次 主要 的 版 本 更 新 。 第 一 个 "演示 性 "系统 在 1987 年 便 可 使 用 
T, 并 且 在 1988 年 的 ACM-SIGMOD 大 会 上 展 出 。 在 1989 年 6 月 发 布 了 版 本 1( 在 POSTGRES 
的 实现 里 有 描述 ) 给 一 些 外 部 的 用 户 使 用 。 为 了 回应 用 户 对 第 一 个 规则 系统 的 批评 ( 
POSTGRES 规 则 系统 注解 )， 我 们 重新 设计 了 规则 系统 ( 数据 库 系 统 中 的 规则 ， 过 程 ， 缓 存 
和 视图 )， 并 在 1990 年 6 月 发 布 了 使 用 新 规则 系统 的 版 本 2。 版 本 3 在 1991 年 出 现 ， 增 加 了 多 
存储 管理 器 的 支持 ， 并 且 改 进 了 查询 执行 器 ， 重 新 编写 了 规则 系统 。 从 那 以 后 ， 随 后 的 版 本 
直到 Postgres95 发 布 前 ( 见 下 文 )， 工 作 都 集中 在 移植 性 和 可 靠 性 上 。 


POSTGRES 已 经 在 许多 研究 或 实际 的 应 用 中 得 到 了 应 用 。 这 些 应 用 包括 : 一 个 财务 数据 分 析 
系统 、 一 个 喷气 引擎 性 能 监控 软件 包 、 一 个 小 行星 跟踪 数据 库 、 一 个 医疗 信息 数据 库 和 一 些 
地 理 信息 系统 。POSTGRES 还 被 许多 大 学 用 于 教学 用 途 。 最 后 ，lllustra Information 
Technologies( 后 来 并 入 Informix ， 而 它 现 在 属于 IBM) 拿 到 代码 并 使 之 商业 化 。 在 1992 年 末 
POSTGRES 成 为 Sequoia 2000 scientific computing project 的 首要 数据 管理 器 。 


到 了 1993 年 ， 外 部 用 户 的 数量 几乎 翻番 。 随 着 用 户 的 增加 ， 用 于 源 代 码 维护 的 时 间 日 益 增 
加 ， 以 至 占用 了 太 多 本 应 该 用 于 数据 库 研究 的 时 间 ， 为 了 减少 支持 的 负担 ， 伯 克利 的 
POSTGRES 项 目 在 版 本 4.2 时 正式 终止 。 


Postgres95 


1994 年 ，Andrew Yu 和 Jolly Chen 向 POSTGRES 中 增加 了 SQL 语言 的 解释 器 ， 并 随后 将 
Postgres95 的 源 代 码 发 布 到 互联 网 上 供 大 家 使 用 ， 从 而 成 为 一 个 开放 源码 的 原 伯 克利 
POSTGRES 的 继承 者 。 


Postgres95 所 有 源 代码 都 是 完全 的 ANSI C, 而 且 代 码 量 减少 了 25%， 并 且 有 许多 内 部 修改 以 
利于 提高 性 能 和 代码 的 可 维护 性 。Postgres95 版 本 1.0.x 在 进行 Wisconsin Benchmark 测 试 时 
大 概 比 POSTGRES v4.2 快 30%-50%。 除 了 修正 了 一 些 错误 ， 下 面 的 是 一 些 主要 改进 : 


。 原来 的 查询 语言 PostQUEL 被 SQL 取代 (在 服务 器 端 实现 )。 (接口 库 libpq 是 以 PostQUEL 来 
命名 的 。) 在 PostgreSQL 之 前 还 不 支持 子 查询 ( 见 下 文 )， 但 这 个 功能 可 以 在 Postgres95 
里 面 由 用 户 定义 的 SQL 本 数 实现 ， 重 新 实现 了 聚集 ， 同 时 还 增加 了 对 croup BY 查询 子 
句 的 支持 。 


e 新 增加 了 利用 GNU Readline 进 行 交 互 SQL 坦 询 的 程序 (psql)。 这 个 程序 很 大 程度 上 取代 
了 老 的 monitor 程 序 。 


e 增加 了 新 的 前 端 库 ( libpgtcl )， 用 以 支持 以 Tc 为 基础 的 客户 端 。 一 个 样本 shell 
( pgtclsh )， 提 供 了 新 的 Tcl 命 令 用 于 Tcl 程 序 和 Postgres95 后 端 之 间 的 交互 。 


彻底 重 写 了 大 对 象 的 接口 ， 将 大 对 象 倒转 (inversion) 作 为 存储 大 对 象 的 唯一 机 制 (去掉 
了 倒转 (inversion) 文 件 系统 ) 。 


去 掉 了 实例 级 的 规则 系统 ， 但 我 们 仍然 可 以 通过 重 写 规则 来 使 用 规则 。 


在 发 布 的 源码 中 增加 了 一 个 简短 的 常用 SQL 和 Postgres95 特 有 的 SQL 特性 的 教程 。 


。 用 GNU make 取 代 了 BSD make 用 于 编译 。 Postgres95 可 以 使 用 不 加 补丁 的 GCC 进行 编 
译 (修正 了 偶数 字 节 数据 的 对 齐 问题 )。 


PostgreSQL 


到 了 1996 年 ， 我 们 很 明显 的 看 出 "Postgres95" 这 个 名 字 已 经 经 不 起 时 间 的 考验 了 。 于 是 我 们 
起 了 一 个 新 名 字 PostgreSQL 用 于 反映 最 初 的 POSTGRES 和 最 新 的 使 用 SQL 的 版 本 之 间 的 关 
系 。 同 时 版 本 号 也 重新 从 6.0 开 始 ， 将 版 本 号 放 回 到 最 初 的 由 伯克利 POSTGRES 项 目 开 始 的 
顺序 中 。 


许多 人 出 于 习惯 或 者 发 音 简 单 的 原因 ， 将 PostgreSQL 称 为 "Postgres" (现在 很 少 全 部 用 大 写 
字母 ) ， 这 种 称 法 被 当做 绰号 或 者 别名 而 广泛 接受 。 


Postgres95 版 本 的 开发 重点 放 在 识别 和 理解 服务 器 端 代码 中 已 有 的 问题 上 。PostgreSQL 开 发 
重点 转 到 了 一 些 有 争议 的 特性 和 功能 上 面 ， 当 然 各 个 方面 的 工作 同时 都 在 进行 。 


自 那 以 来 ，PostgreSQL 发 生 的 变化 可 以 在 Appendix E 里 面 找到 。 


TETN 25 E 


下 面 的 格式 用 于 命令 的 大 纲 : 方 括 弧 ( [ 和 ] ) 表 示 可 选 的 部 分 (在 Tcl 命 邻里 使 用 的 是 问号 
(? )。 花 括 弧 ( { 和 } ) MER | ) 表 示 你 必须 选取 一 个 候选 。 连 续 点 (..，. ) 表示 前 面 的 元 
素 可 以 重复 。 


， 那 么 SQL 命令 使 用 前 级 提示 符 =&gt; ， 而 shell 命 令 使 用 前 级 提示 符 $ 。 
示 提 示 符 的 。 


管理 员 通 常 是 一 个 负责 安装 和 运行 服务 器 的 人 。 用 户 可 以 是 任何 使 用 或 者 需要 使 用 
PostgreSQL 系 统 任何 部 分 的 人 。 我 们 不 应 该 对 这 些 术 语 的 概念 理解 得 太 狭 险 。 这 份 文档 集 在 
系统 管理 步骤 方面 没有 固定 的 假设 。 


更 多 信息 

除了 文档 (也 就 是 本 手册 ) 以 外 ， 还 有 一 些 其 他 的 PostgreSQL 相 关 资 源 : 

Wiki 

PostgreSQL wiki 包括 项 目的 FAQ (常见 问题 ) WR, 待 办 事项 列表 ,和 更 多 话题 的 详细 信息 。 
网 站 

PostgreSQL 网 站 有 最 新 版 本 的 详细 信息 以 及 能 让 你 更 高 效 地 使 用 PostgreSQL 的 其 他 信息 。 
邮件 列表 


邮件 列表 是 解决 用 户 问 题 ， 与 其 他 用 户 分 享 经 验 ， 与 开发 者 联系 的 好 地 方 。 详 见 PostgreSQL 
网 站 。 


你 自己 ! 


PostgreSQL 是 一 个 开放 源码 的 项 目 。 也 就 是 说 ， 它 依 靠 用 户 社 区 进行 持续 支持 。 当 你 刚 开 始 
使 用 PostgreSQL 时 ， 你 将 依靠 其 他 人 的 帮助 ， 或 者 是 通过 文档 、 或 者 是 通过 邮件 列表 。 同 
时 也 请 将 你 的 知识 贡献 出 来 。 阅 读 邮 件 列 表 并 回答 问题 。 如 果 你 学 到 了 一 些 文档 里 没有 提 到 
的 东西 ， 请 将 其 写 下 来 并 贡献 出 来 。 如 果 你 给 代码 增加 了 特性 ， 请 贡献 出 来 。 


吴 虫 汇报 指导 


当 你 在 PostgreSQL 里 磁 到 臭虫 时 ， 我 们 也 希望 能 知道 它 。 你 的 臭虫 汇报 是 将 PostgreSQL 做 
得 更 加 可 靠 的 一 个 非常 重要 的 部 分 ， 因为 再 细致 的 工作 也 不 能 保证 在 任何 情况 、 任 何平 台 下 
PostgreSQL 的 每 一 个 部 分 都 能 正常 工作 。 


下 面 的 建议 试图 帮助 你 正确 格式 化 臭虫 报告 ， 这 样 这 些 报 告 就 能 够 以 一 种 有 效 的 方法 处 理 。 
我 们 不 强迫 任何 人 遵循 这 些 东 西 ， 但 是 这 样 做 对 我 们 每 个 人 都 有 好 处 。 

我 们 不 能 保证 能 够 马上 修补 每 个 臭虫 。 如 果 臭 虫 是 显而易见 的 ， 很 关键 的 或 者 影响 许多 用 
È, 那么 很 有 可 能 有 些 人 会 认真 检查 它们 。 同 样 我 们 也 可 能 是 告诉 你 升级 到 一 个 新 版 本 ， 看 
看 臭虫 是 否 仍然 存在 。 否 则 ， 我 们 可 能 会 说 这 个 臭虫 在 我 们 正 计 划 的 几 个 主要 改写 之 前 不 会 
得 到 修补 。 或 者 这 个 臭虫 只 是 太 费 事 了 ， 而 且 目 前 的 日 程 表 上 有 更 重要 的 事情 要 做 。 如 果 你 
立即 需要 帮助 ， 那么 请 考虑 获取 一 个 商业 性 的 支持 。 


标识 奥 虫 


在 你 报告 臭虫 之 前 ， 请 一 再 仔细 地 读 文档 ， 以 确认 你 确实 可 以 做 你 在 做 的 事情 。 如 果 文 档 中 
对 你 能 否 处 理 你 所 做 的 事情 并 不 清楚 ， 也 请 你 汇报 过 来 ， 因 为 这 个 是 文档 的 臭虫 。 MRAM 
你 的 程序 表现 的 不 像 文 档 里 说 的 那样 ， 那 就 是 一 个 臭虫 。 这 时 可 能 包括 (不 过 不 一 定局 限于 ) 
下 面 的 现 像 : 


。 程序 带 着 一 个 致命 信号 或 者 一 个 指向 程序 错误 的 操作 系统 错误 信息 退出 。 一 个 反例 是 一 
"disk full" & BSR, AAR HN BIRD AE Postgres 外 部 进行 修复 。 


。 程序 对 给 出 的 任何 输入 都 产生 错误 的 输出 。 
。 程序 拒绝 接收 (文档 里 定义 的 那些 ) 有 效 的 输入 。 


。 程序 对 非法 输入 没有 生成 任何 提示 或 者 错误 信息 。 但 是 需要 注意 的 是 ， 你 认为 非法 的 输 
入 可 能 是 我 们 设想 的 扩展 或 者 与 传统 兼容 的 做 法 。 


。 在 支持 的 平台 上 根据 指导 未 能 成 功 地 编译 或 安装 PostgreSQL。 
这 里 的 "程序 "代表 任何 可 执行 文件 ， 而 不 仅仅 是 后 端 进程 。 


速度 慢 或 者 资源 消耗 大 不 算是 臭虫 。 请 阅读 文档 或 者 提交 邮件 列表 获取 调节 你 的 应 用 的 性 能 
的 帮助 。 未 能 遵循 SQL 标准 也 不 算是 一 个 臭虫 ， 除 非 文档 明确 声明 了 遵守 该 特定 特性 。 


在 你 准备 继续 汇报 臭虫 之 前 ， 请 检查 TODO 列表 和 FAQ ， 看 看 你 报告 的 臭虫 是 否 已 知 。 如 
果 你 不 能 解析 TODO 列表 里 面 的 信息 ， 请 汇报 你 的 问题 。 至 少 我 们 可 以 把 TODO 列表 做 得 更 
清晰 。 


汇报 什么 


关于 汇报 臭虫 需要 记 住 的 最 重要 的 事 就 是 写 出 所 有 事实 并 且 只 写 事 实 。 不 要 推测 你 认为 是 什 
ABT, 什么 "看 起 来 像 "， 或 者 是 推测 程序 的 哪 一 部 分 失灵 了 。 如 果 你 不 熟悉 PostgreSQL 
的 实现 ， 你 很 可 能 猜 错 因而 不 能 帮 有 我 们 任何 忙 。 而 且 即 使 你 熟悉 Postgres 的 实现 ， 提炼 出 
来 的 解释 也 只 是 事实 的 补充 而 不 是 代替 。 如 果 我 们 准 各 修理 这 个 臭虫 ， 我 们 仍然 需要 首先 亲 
自 看 到 臭虫 的 出 现 。 报 告 简 单 的 事实 相对 而 言 比较 直接 (你 可 以 从 屏幕 上 拷贝 和 粘贴 )， 不 过 
经 常 发 生 的 是 很 多 人 认为 这 些 事实 不 重要 而 忽略 了 重要 的 细节 ， 和 否则 汇报 总 是 能 够 被 我 们 理 
解 。 


下 面 的 条 目 应 该 包含 在 所 有 臭虫 汇报 里 面 : 


。 从 程序 启动 开始 到 重 现 问 题 的 准确 步骤 顺序 。 这 应 该 自 包 含 的 ; 要 知道 如 果 输 出 将 依赖 
于 表 中 的 数据 时 ， 光 把 一 个 光秃秃 的 sELECT 语句 发 过 来 而 不 把 前 面 
的 CREATE TABLE 和 INSERT 语句 发 过 来 是 不 够 的 。 我 们 没有 时 间 分 析 你 的 数据 库 结 构 ， 
而 且 如 果 我 们 试 着 建立 我 们 自己 的 数据 ， 那 我 们 就 有 可 能 错过 问题 。 


测试 与 SQL 语言 有 关 的 问题 的 最 好 的 格式 是 一 个 可 以 通过 psql 前 端 运行 并 显示 问题 的 文 
件 ( 确 保 在 ~/ .psqlrc 启动 文件 里 面 没 有 任何 东西 )。 一 种 比较 简单 的 创建 这 个 文件 的 方法 
就 是 用 pg_dump 导出 表 声 明和 仿真 的 数据 ， 以 及 有 毛病 的 查询 。 我 们 鼓励 你 最 小 化 你 的 
例子 ， 但 这 不 是 非 做 不 可 的 事情 。 如 果 臭 虫 是 可 以 复 现 的 ， 那 么 两 种 方式 都 能 帮助 我 们 


找到 它 。 


如 果 你 的 应 用 使 用 其 它 客 户 端 接 口 ， 比 如 PHP， 那 么 请 设法 隔离 出 有 毛病 的 查询 。 我 们 
可 能 不 会 架设 一 个 web 服务 器 来 复 现 你 的 问题 。 不 管 怎么 说 ， 请 记 住 提 供 准 确 的 输入 文 
4, 而 不 要 猜测 问题 会 在 "大 文件 "或 者 "中 等 尺寸 的 数据 库 " 等 等 的 身上 发 生 。 因为 这 样 
的 信息 太 不 确切 ， 因 而 没有 什么 用 你。 


。 你 得 到 的 输出 。 请 不 要 说 它 "不 起 作用 "或 者 " 失 录 了 "。 如 果 有 错误 信息 ， 请 写 明 ， 即 使 你 
不 能 理解 也 一 样 。 如 果 程 序 带 着 操作 系统 错误 退出 ， 也 请 写 清楚 。 如 果 什 么 也 没有 发 
生 ， 就 照 直 说 。 即 使 你 的 测试 实例 是 程序 崩溃 或 者 其 它 显 而 易 见 的 现 像 ， 它 也 有 可 能 不 
会 在 我 们 的 平台 上 发 生 。 如 果 可 能 ， 最 简单 的 事情 是 从 终端 拷贝 输出 。 


> Note: 如 果 你 报告 一 个 错误 信息 ， 请 从 信息 中 获取 最 宛 长 的 版 本 。 在 psql 里 ， 事先 运 
行 \set VERBOSITY verbose 就 行 。 如 果 你 从 服务 器 日 志 里 抽取 信息 ， 那么 就 把 运行 时 参 
数 log_error_verbosity 设 置 为 verbose, 这 样 就 会 报告 所 有 细节 。 


> Note: 如 果 是 致命 错误 ， 客 户 端 提 供 的 信息 可 能 不 会 包含 所 有 能 得 到 的 信息 。 这 种 情况 
下 ， 还 要 看 看 数据 库 服务 器 的 输出 。 如 果 你 没有 保留 服务 器 输出 ， 那 么 现在 是 做 这 件 事 
的 好 机 会 。 


。 还 有 一 样 很 重要 的 事 是 声明 你 期 望 的 输出 。 如 果 你 只 是 写 到 "这 条 命令 给 我 这 样 的 输出 " 
或 者 "这 不 是 我 期 望 的 "， 我 们 可 能 自己 运行 它 ， 检 查 输出 ， 然后 认为 看 上 去 很 好 并 且 正 
是 我 们 所 期 望 的 输出 。 我 们 不 应 该 把 时 间 花 在 解析 你 的 命令 的 语义 上 。 特别 是 要 避免 仅 


仅 说 "这 不 是 SQL 说 的 "或 "这 不 像 Oracle 做 的 那样 "。 从 SQL 里 挖掘 出 正确 的 行为 可 不 是 
好 玩 的 事情 ， 我 们 也 不 能 知道 所 有 其 它 的 关系 数据 库 的 特性 是 怎样 的 。 如 果 你 的 问题 是 
程序 崩溃 ， 显然 你 可 以 忽略 这 个 条 目 。 


。 任何 命令 行 选项 和 其 它 启 动 选项 ， 包 括 相 关 的 环境 变量 或 者 你 从 缺 省 值 修 改 以 后 的 配置 
文件 。 同时 ， 还 要 准确 。 如 果 你 使 用 启动 系统 时 自动 启动 数据 库 服务 器 的 预 打包 的 版 
A, 你 应 该 试 着 找 出 这 些 东 西 是 怎样 实现 的 。 


。 任何 你 做 的 与 安装 指导 不 一 致 的 东西 。 


e PostgreSQL 版 本 。 你 可 以 运行 SELECT version(); 命令 来 检查 你 正在 运行 的 版 本 是 什 
么 。 大 多 数 可 执行 程序 支持 --version 选项 ; 至 
少 postgres --version 和 psql --version 应 该 是 可 以 用 的 。 如 果 这 个 函数 或 者 选项 不 存 
在 ， 那 我 们 很 可 能 除了 告诉 你 升级 外 不 会 说 别 的 东西 。 如 果 你 运行 预 打包 的 版 本 (例如 
RPM)， 请 说 明 ， 包 括 那 个 包 可 能 有 的 任何 子 版 本 号 。 如 果 你 说 的 是 Git 快照 ， 也 请 说 
明 ， 包 括 提 交 hash。 


如 果 你 的 版 本 比 9.3.1 低 ， 我 们 几乎 肯定 要 告诉 你 升级 。 在 每 个 新 版 本 里 都 修补 了 大 量 的 
臭虫 ， 所 以 你 在 老 版 本 的 PostgreSQL 里 磁 到 的 毛病 很 有 可 能 已 经 修复 掉 了 。 我 们 只 能 
对 那些 使 用 老 版 本 的 PostgreSQL 节 点 提供 有 限 的 支持 ; 如 果 你 要 求 的 比 我 们 能 提供 的 更 
多 ， 那 么 考虑 一 下 商业 的 合同 支持 。 


。 平台 信息 。 这 包括 内 核 名 称 和 版 本 、C 库 、 人 处理 器 、 存 储 器 信息 。 大 多 数 情 况 下 只 需 
汇报 供应 商 和 版 本 ， 但 是 不 要 指望 每 个 人 都 很 清楚 "Debian" 包括 什么 东西 或 者 说 每 个 人 
都 运行 在 i386s 上 。 如 果 你 安装 有 问题 ， 那么 还 要 详细 汇报 你 机 器 上 的 工具 的 信息 (编译 
器 和 make 等 )。 


不 要 怕 你 的 臭虫 汇报 太 长 ， 这 就 是 生活 。 一 开始 就 汇报 所 有 的 事情 要 比 让 我 们 从 你 那里 挤 出 
事实 要 好 。 另外 ， 如 果 你 的 输入 文件 非常 巨大 ， 先 问 问 有 没有 人 有 兴趣 查看 它 也 是 合理 的 。 
这 里 有 一 篇 文章 ， 概述 了 一 些 汇报 臭虫 的 更 多 的 提示 。 


不 要 把 时 间 花 在 寻找 如 何 通过 修改 输入 来 消除 问题 的 方法 上 。 这 样 很 可 能 不 会 对 解决 问题 有 
任何 帮助 。 如 果 发 现 不 能 直接 修理 臭虫 ， 你 还 有 时 间 来 查找 和 共享 你 的 绕 过 方法 。 还 有 ， 我 
们 再 说 一 次 ， 不 要 在 猜测 臭虫 的 位 置 上 面 浪 费时 间 。 我 们 能 够 及 时 找到 错误 。 


在 你 书写 臭虫 汇报 时 ， 请 选用 不 易 混 淆 的 术语 。 软 件 包 本 身 被 称 为 "PostgreSQL"， 有 时 简称 
为 "Postgres"。 当 你 特 指 后 端 服务 器 进程 时 ， 请 明确 说 明 ， 而 不 要 仅仅 是 说 "PostgreSQL AA 
江 了 "。 一 个 独立 后 端 服 务 器 进程 的 月 溃 和 父 进 程 "postgres" 朋 溃 是 相当 不 同 的 ; 如 果 你 是 说 
独立 后 端 进程 朋 渍 了， 那么 请 不 要 说 "服务 器 骨 溃 了 "， 反之 亦 然 。 同 样 ， 客 户 端 程序 ， 上 比如 
交互 式 前 端 "psql" 是 和 后 端 完全 独立 的 。 请 试图 说 明 清 楚 问 题 是 出 现在 客户 端 还 是 服务 器 端 。 


到 哪里 汇报 臭虫 


通常 ， 把 汇报 发 到 臭虫 汇报 邮件 列 
表 &1t; [pgsql-bugs@postgresql.org](mailto:pgsql-bugs@postgresql.org)&gt; o 我 们 要 求 你 为 
电子 邮件 消息 选用 一 个 描述 性 的 题目 ， 也 许 就 用 错误 信息 的 一 部 分 。 


另外 一 个 方法 是 填充 web 表单 形式 的 臭虫 报告 ， 你 可 以 在 项 目的 web 站 点 找到 。 用 这 种 方 
法 输入 一 个 臭虫 报告 会 导致 它 被 发 送 
到 &1t; [pgsql-bugs@postgresql.org] (mailto: pgsql-bugs@postgresql.org)&gt; 邮件 列表 。 


如 果 你 的 臭虫 报告 隐 含 带 有 安全 问题 ， 而 你 不 想 它 立即 出 现在 公开 的 档案 库 里 ， 那么 就 不 要 
发 送 到 pgsql-bugs 。 安 全 问题 可 以 私下 里 报告 到 


&lt; [Security@postgresql.org](mailto:security@postgresql.org)&gt; o 


不 要 把 臭虫 汇报 发 送 到 任何 用 户 邮件 列表 里 ， 例 如 SQL 语言 邮件 列 

表 &1t; [pgsql-sql@postgresql.org](mailto:pgsql-sql@postgresql.org)&gt; 

或 &1t; [pgsql-general@postgresql.org](mailto:pgsql-general@postgresql.org)&gt; o 这 些 邮 件 
列表 用 于 回答 用 户 问题 ， 而 且 那 些 订阅 者 通常 不 希望 接收 臭虫 汇报 。 更 重要 的 是 ， 他 们 很 可 
能 不 会 修理 这 些 臭虫 。 


还 有 ， 请 不 要 向 开发 者 邮件 列 

表 &1t; [pgsql-hackers@postgresql.org](mailto:pgsql-hackers@postgresql.org)&gt; 发 送 臭 虫 江 
报 。 这 个 列表 用 于 讨论 PostgreSQL 的 开发 ， 因而 我 们 很 希望 能 和 臭虫 汇报 分 离开 。 如 果 修理 
某 个 毛病 需要 更 多 评论 ， 我 们 可 能 会 在 这 个 pgsql-hackers 列表 开 一 个 关于 你 的 臭虫 的 讨论 


A 
Bo 


如 果 你 觉得 文档 有 问题 ， 请 发 电子 邮件 到 文档 邮件 列 
表 &lt; [pgsql-docs@postgresql.org](mailto:pgsql-docs@postgresql.org)&gt; ， 在 你 的 问题 汇 
报 里 面 指明 你 认为 哪 部 分 有 错误 。 


如 果 你 的 臭虫 是 一 个 在 不 支持 平台 上 的 移植 性 问题 ， 向 移植 性 问题 邮件 列 
表 &1t; [pgsql-hackers@postgresql.org](mailto:pgsql-hackers@postgresql.org)&gt; 发 送 电子 邮 
件 ， 这 样 我 们 (还 有 你 ) 可 以 一 起 尝试 把 PostgreSQL 移 植 到 你 的 平台 


Note: 由 于 我 们 不 愿意 看 到 各 种 各 样 的 垃圾 邮件 ， 上 面 的 所 有 电子 邮件 地 址 都 是 封闭 的 
邮件 地 址 。 也 就 是 说 ， 你 需要 先 申 请 ， 然 后 才能 发 帖子 (用 web 表单 提交 臭虫 报告 用 不 
着 申请 )。 如 果 你 只 是 想 发 送 邮 件 而 不 想 接受 列表 的 往来 邮件 ， 你 可 以 提交 邮件 并 且 把 提 
交 选 项 设置 为 nomail 。 如 果 需 要 更 多 的 信息 ， 你 可 以 

向 &1t; [majordomo@postgresql.org](mailto:majordomo@postgresql.org)&gt; 发 送 一 封 邮 


件 ， 邮 件 的 正文 只 有 一 个 单词 help 就 可 以 了 。 


I. 教程 


欢迎 阅读 PostgreSQL 教程 。 下 面 几 个 章节 主要 是 给 那些 对 于 PostgreSQL 关 系数 据 库 概念 和 
SQL 语言 尚 不 熟悉 的 朋友 一 次 简单 介绍 。 我 们 只 是 假设 你 有 一 些 关 于 如 何 使 用 计算 机 的 基本 
知识 。 并 不 要 求 特殊 的 Unix 或 者 编程 经 验 。 这 部 分 的 主要 目的 是 给 你 一 些 手把手 的 经 验 ， 告 
诉 你 一 些 有 关 PostgreSQL 系统 的 重要 方面 。 我 们 无 意 把 这 部 分 写成 一 份 泗 盖 各 个 主题 的 完 
整 材料 。 


在 你 阅读 完 这 份 教程 之 后 你 可 能 想 继续 阅读 Part || 以 获取 有 关 SQL 语言 的 更 多 正规 知识 ， 
或 者 是 阅读 Part IV 获 取 有 关 为 PostgreSQL 开 发 应 用 的 信息 。 那些 安装 并 维护 自己 的 服务 器 
的 人 还 应 该 看 看 Part lll. 
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1.1. 安装 


自然 ， 在 你 想 开 始 使 用 PostgreSQL 之 前 ， 你 必须 安装 它 。 PostgreSQL 很 有 可 能 已 经 安装 到 
你 的 节点 上 了 ， 可 能 是 因为 它 包含 在 操作 系统 的 发 布 里 ， 或 者 是 因为 系 统管 理 员 已 经 安装 了 
它 。 如 果 是 这 样 的 话 ， 那 么 你 应 该 从 操作 系统 的 文档 或 者 系统 管理 员 那 里 获取 如 何 访问 
PostgreSQL 的 信息 。 


如 果 你 不 清楚 PostgreSQL 是 否 已 经 安装 ， 或 者 不 知 道 你 能 否 用 它 做 自己 的 实验 ， 那 么 你 可 以 
自己 安装 。 这 么 做 并 不 难 ， 并 且 是 一 次 很 好 的 练习 。PostgreSQL 可 以 由 任何 非特 权 用 户 安 
装 ， 并 不 需要 超级 用 户 (root) 的 权限 。 


如 果 你 准 各 自己 安装 PostgreSQL， 那 么 请 参考 Chapter 15 获 取 安 装 的 有 关 信 息 ， 安 装 之 后 再 
回 到 这 个 指导 手册 来 。 一 定 要 记 住 要 尽 可 能 遵循 有 关 设 置 合适 的 环境 变量 章节 里 的 信息 。 


如 果 节 点 管理 员 没 有 按照 缺 省 方式 设置 各 项 相关 参数 ， 那 你 还 有 点 额外 的 活 儿 要 干 。 比如 ， 
如 果 数 据 库 服务 器 机 器 是 一 个 远程 的 机 器 ， 那 你 就 需要 把 PhosT 环境 变量 设置 为 数据 库 服 务 
器 那 台 机 器 的 名 字 。 环 境 变量 PPoRT 也 可 能 需要 设置 。 最 后 一 招 : 如 果 当 你 试 着 启动 一 个 应 
用 而 该 应 用 报告 说 不 能 与 数据 库 建立 连 接 时 ， 你 应 该 马上 与 数据 库 管 理 员 联系 ， 如 果 你 就 是 
管理 员 ， 那 么 你 就 要 参考 文档 以 确 保 环 境 变量 被 正确 的 设置 了 。 如 果 你 不 理解 随后 的 几 段 ， 
那么 先 阅读 下 一 章 。 


1.2. 体系 基本 概念 


在 我 们 开始 讲解 之 前 ， 我 们 应 该 先 了 解 PostgreSQL 系统 的 基本 体系 。 理 解 PostgreSQL 的 组 
件 之 间 的 相 互 关系 将 会 使 本 节 显 得 更 清晰 一 些 。 


按照 数据 库 术 语 来 说 ，PostgreSQL 使 用 一 种 客户 端 /服务 器 的 模式 。 一 次 PostgreSQL 会 话 由 
下 列 相 关 的 进程 (程序 ) 组 成 : 


。 一 个 服务 器 进程 ， 它 管理 数据 库 文 件 ， 接 受 来 自 客户 端 应 用 与 数据 库 的 连接 ， 并 且 代 表 
客 户 端 在 数据 库 上 执行 操作 。 数 据 库 服务 器 程序 叫 postgres 。 


。 那些 需要 执行 数据 库 操 作 的 用 户 的 客户 端 (前 端 ) 应 用 。 客 户 端 应 用 可 能 本 身 就 是 多 种 多 
样 的 : 它们 可 以 是 一 个 字符 界面 的 工具 ， 也 可 以 是 一 个 图 形 界面 的 应 用 ， 或 者 是 一 个 通 
过 访问 数据 库 来 显示 网 页 的 web 服务 器 ， 或 者 是 一 个 特殊 的 数据 库 管理 工具 。 一 些 客户 
端 应 用 是 和 PostgreSQL 发 布 一 起 提供 的 ， 但 绝 大 部 分 是 用 户 开 发 的 。 


典型 的 客 户 端 /服务 器 应 用 (C/S 应 用 ) 一 样 ， 这 些 客 户 端 和 服务 器 可 以 在 不 同 的 主机 上 。 这 时 
它们 通过 TCP/IP 网 络 连接 通讯 。 你 应 该 记 住 的 是 ， 在 客户 机 上 可 以 访问 的 文件 未 必 能 够 在 
数据 库 服务 器 机 器 上 访问 (或 者 只 能 用 不 同 的 文件 名 进行 访问 )。 


PostgreSQL 服 务 器 可 以 义理 来 自 客 户 端的 多 个 并 发 连接 。 因此 ， 它 为 每 个 连接 启动 ("forks") 
一 个 新 的 进程 。 从 这 个 时 候 开 始 ， 客 户 端 和 新 服务 器 进程 就 不 再 经 过 最 初 的 postgres 进程 进 
行 通讯 。 因 此 ， 主 服务 器 总 是 在 运行 ， 等 待 客户 端 连接 ， 而 客户 端 及 其 相关 联 的 服务 器 进程 
则 是 起 起 停 停 。 (当然 ， 用 户 是 肯定 看 不 到 这 些 事情 的 。 我 们 在 这 儿 谈 这 些 主要 是 为 了 完 

o ) 


1.3. 创建 一 个 数据 库 


看 看 你 能 否 访 问 数据 库 服 务 器 的 第 一 个 例子 就 是 试 着 创建 一 个 数据 库 。 一 台 运 行 着 的 
PostgreSQL 服 务 器 可 以 管理 许多 数据 库 。 通 常 我 们 会 为 每 个 项 目 和 每 个 用 户 单独 使 用 一 个 数 
据 库 。 


节点 管理 员 可 能 已 经 为 你 创建 了 可 以 使 用 的 数据 库 。 他 应 该 已 经 告诉 你 这 个 数据 库 的 名 字 。 
如 果 这 样 你 就 可 以 省 略 这 一 步 ， 并 且 跳 到 下 一 节 。 


要 创建 一 个 新 的 数据 库 ， 在 我 们 这 个 例子 里 叫 mya ， 你 可 以 使 用 下 面 的 命令 : 


<samp class="literal">$</samp> <kbd class="literal">createdb mydb</kbd> 


如 果 不 报 错 那么 这 一 步 就 成 功 了 ， 你 就 可 以 忽略 本 节余 下 的 部 分 了 。 
如 果 你 看 到 类 似 下 面 这 样 的 信息 : 


createdb: command not found 


那么 就 是 PostgreSQL 没 有 安装 好 : 要 么 是 就 根本 没 装 上 、 要 么 是 搜索 路 径 没有 包含 它 。 尝试 
用 绝对 路 径 调 用 该 命 舍 试 试 : 


<samp class="literal">$</samp> <kbd class="literal">/usr/local/pgsql/bin/createdb mydb</k 





在 你 的 节点 上 这 个 路 径 可 能 不 一 样 。 请 和 管理 员 联 系 或 者 看 看 安装 指导 以 获取 正确 的 位 置 。 
另外 一 种 响应 可 能 是 这 样 : 


createdb: could not connect to database postgres: could not connect to server: No such fi 
Is the server running locally and accepting 
connections on Unix domain socket "/tmp/.s.PGSQL.5432"? 


sss: 


这 意味 着 服务 器 没有 启动 ， 或 者 没有 在 createdb 预期 的 地 方 馈 动 。 同 样 ， 你 也 要 检查 安装 指 
导 或 者 找 管理 员 。 





另外 一 个 响应 可 能 是 这 样 : 


createdb: could not connect to database postgres: FATAL: role "joe" does not exist 


在 这 里 提 到 了 你 自己 的 登陆 名 。 如 果 管 理 员 没有 为 你 创建 PostgreSQL 用 户 帐号 ， 就 会 发 生 这 
些 现 像 。PostgreSQL 用 户 帐号 和 操作 系统 用 户 帐 号 是 不 同 的 。 如 果 你 就 是 管理 员 ， 参 

iJ Chapter 20 以 获取 创建 用 户 帐 号 的 帮助 。 你 需要 变 成 安装 PostgreSQL 的 操作 系统 用 户 的 身 
份 (通常 Æ postgres ) 才 能 创建 第 一 个 用 户 帐 号 。 也 有 可 能 是 赋予 PostgreSQL 用 户 名 和 操作 
系统 用 户 名 不 同 ; 这 种 情况 下 ， 你 需要 使 用 -u 开关 或 者 使 用 PeusER 环境 变量 声明 
PostgreSQL 用 户 名 。 


如 果 你 有 个 数据 库 用 户 帐号 ， 但 是 没有 创建 数据 库 所 需要 的 权限 ， 那 么 你 会 看 到 下 面 的 示 
a: 


createdb: database creation failed: ERROR: permission denied to create database 


并 非 所 有 用 户 都 经 过 了 创建 新 数据 库 的 授权 。 如 果 PostgreSQL 拒绝 为 你 创建 数据 库 ， 那 么 你 
需要 让 节点 管理 员 赋予 你 创建 数据 库 的 权限 。 出 现 这 种 情况 时 请 咨询 你 的 节点 管理 员 。 如 果 
你 自己 安装 了 PostgreSQL， 那 么 你 应 该 以 你 启动 数据 库 服 务 器 的 用 户 身份 登陆 然后 参考 手册 
完成 权限 的 赋予 工作 。 [1] 


你 还 可 以 用 其 它 名 字 创 建 数 据 库 。PostgreSQL 人 允许 你 在 一 个 节点 上 创建 任意 数量 的 数据 库 。 
数据 库 名 必须 是 以 字母 开头 并 且 小 于 63 个 字 节 长 。 一 个 方便 的 做 法 是 创建 和 你 当前 用 户 名 
同名 的 数据 库 。 许 多 工具 假设 它 为 缺 省 的 数据 库 名 ， 所 以 这 样 可 以 节省 敲 键 。 要 创建 这 样 的 
数据 库 ， 只 需要 键入 : 


<Samp class="literal">$</samp> <kbd class="literal">createdb</kbd> 


如 果 你 再 也 不 想 使 用 你 的 数据 库 了 ， 那 么 你 可 以 删除 它 。 上 比如 ， 如 果 你 是 数据 库 mydb 的 属 
主 (创建 人 )， 那 么 你 就 可 以 用 下 面 的 命 命 删除 它 : 


<samp class="literal">$</samp> <kbd class="literal">dropdb mydb</kbd> 


对 于 这 条 命令 而 言 ， 数 据 库 名 不 是 缺 省 的 用 户 名 ， 你 必须 明确 声明 它 。 这 个 动作 物理 上 将 所 
有 和 与 该 数据 库 相 关 的 文件 都 副 除 并 且 不 可 恢复 ， 因 此 做 这 件 事 之 前 一 定 要 想 清楚 。 


更 多 关于 createdb 和 dropdb 的 信息 可 以 在 createdb 和 dropdb 小 节 找 到 。 


Notes 


[1] 为 什么 这 么 干 就 行 了 ? 解释 如 下 : PostgreSQL 用 户 名 是 和 操作 系统 用 户 账号 分 开 的 。 如 
果 你 与 一 个 数据 库 连 接 ， 你 可 以 指定 以 哪个 PostgreSQL 用 户 名 进行 连接 ; 如 果 你 不 指定 ， 那 
么 缺 省 就 是 你 当前 的 操作 系统 账号 。 如 果 这 样 ， 那 么 总 有 一 个 与 操作 系统 用 户 同 名 的 
PostgreSQL 用 户 账号 用 于 启动 服务 器 ， 并 且 通 常 这 个 用 户 都 有 创建 数据 库 的 权限 。 如 果 你 不 
想 以 该 用 户 身份 登陆 ， 那 么 你 也 可 以 在 任何 地 方 声明 一 个 -u 选项 来 选择 一 个 连接 时 使 用 的 
PostgreSQL 用 户 名 。 
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1.4. 访问 数据 库 


一 且 创 建 了 数据 库 ， 你 就 可 以 访问 它 : 
e 运行 PostgreSQL 交 互 的 终端 程序 psq/， 它 允 许 你 交互 地 输入 、 编 辑 、 执 行 SQL 命 今 。 


。 使 用 我 们 现 有 的 图 形 前 端 工 具 ， 比 如 pgAdmin 或 者 带 ODBC 或 JDBC 支 持 的 办 公 套 件 来 
创建 和 管理 数据 库 。 这 种 方法 在 这 份 教程 中 没有 介绍 。 


。 使 用 多 种 语言 绑 定 中 的 一 种 写 一 个 客户 上 应用。 这 些 可 能 性 在 Part IV 中 有 更 深入 的 讨论 。 


你 可 能 需要 启动 psql 来 试验 本 教程 中 的 例子 。 你 可 以 用 下 面 的 命令 为 mydb 数据 库 激活 它 : 
<samp class="literal">$</samp> <kbd class="literal">psql mydb</kbd> 

如 果 你 省 略 了 数据 库 名 字 ， 那 么 它 缺 省 就 是 你 的 用 户 账号 名 字 。 你 已 经 在 前 面 的 使 

用 createdb 小 节 里 了 解 这 一 点 了 。 


在 psql 里 ， 你 会 看 到 下 面 的 欢迎 信息 : 


psql (9.3.1) 
Type "help" for help. 


mydb=> 


最 后 一 行 也 可 能 是 
mydb=# 
这 个 提示 符 意 味 着 你 是 数据 库 超 级 用 户 ， 最 可 能 出 现在 你 自己 安装 了 PostgreSQL 的 情况 下 。 


作为 超级 用 户 意味 着 你 不 受 访问 控制 的 限制 。 对 于 本 教程 的 目的 而 言 ， 是 否 超级 用 户 并 不 重 
要 。 


如 果 你 启动 psal 时 碰 到 了 问题 ， 那 么 回 到 前 面 的 小 节 。 诊 断 createdb 的 方法 和 诊 
KT psal 的 方法 很 类 似 ， 如 果 前 者 能 运行 那么 后 者 也 应 该 能 运行 。 


psal 打印 出 的 最 后 一 行 是 提示 符 ， 它 表示 psa 正 听 着 你 说 话 ， 这 个 时 候 你 就 可 以 敲 入 SQL 
查询 到 一 个 psal 维护 的 工作 区 中 。 党 试 一 下 下 面 的 命令 : 


<samp class="literal">mydb=></samp> <kbd class="literal">SELECT version();</kbd> 
version 


PostgreSQL 9.3.1 on i586-pc-linux-gnu, compiled by GCC 2.96, 32-bit 
(1 row) 


<samp class="literal">mydb=></samp> <kbd class="literal">SELECT current_date;</kbd> 
date 


2002-08-31 
(1 row) 


<samp class="literal">mydb=></samp> <kbd class="literal">SELECT 2 + 2;</kbd> 
?column? 


psal 程序 有 一 些 不 属于 SQL 命令 的 内 部 命令 。 它 们 以 反 斜 枉 "\ "开头 。 比 如 ， 你 可 以 用 下 
面 的 命令 获取 各 种 PostgreSQL SQL 命令 的 帮助 语法 : 


<Samp class="literal">mydb=></samp> <kbd class="literal">\h</kbd> 


要 退出 psql ， 键 和 人 : 


<Samp class="literal">mydb=></samp> <kbd class="literal">\q</kbd> 


然后 psql 就 会 退出 并 且 返 回 到 命令 行 shell( 要 获取 更 多 有 关 内 部 命令 的 信息 ， 你 可 以 
在 psal 提示 符 上 键入 \? )。 psal 的 完整 功能 在 psql 文 档 中 。 在 这 份 文档 里 ， 我 们 将 不 会 明 
确 使 用 这 些 特性 ， 但 是 你 自己 可 以 在 它们 有 用 的 时 候 使 用 它们 。 
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2.1. 介绍 


本 章 提供 一 个 如 何 使 用 SQL 执行 简单 操作 的 概述 。 本 教程 的 目的 只 是 给 你 一 个 介绍 ， 并 非 完 
整 的 SQL 教程 。 有 许多 关于 SQL 的 书 ， 包 括 理解 新 的 SQL 和 SQL 标准 指南 。 而 且 你 还 要 知道 
有 些 PostgreSQL 语言 特性 是 对 标准 的 扩展 。 


在 随后 的 例子 里 ， 我 们 假设 你 已 经 创建 了 名 为 mydb 的 数据 库 ， 就 像 在 前 面 的 章 里 面 介 绍 的 
一 样 ， 并 且 已 经 启动 了 psql。 


本 手册 的 例子 也 可 以 在 PostgreSQL 源 代码 发 布 目 录 里 的 src/tutorial/ 中 找到 。 


(PostgreSQL 二 进 制 包 中 可 能 不 编译 这 些 文件 ) 要 使 用 这 些 文件 ， 先 进入 该 目录 然后 运行 
make : 
<samp class="literal">$</samp> <kbd class="literal">cd ~_...._°/src/tutorial</kbd> 


<samp class="literal">$</samp> <kbd class="literal" >make</kbd> 


AER OE T EAA Ret TOS PEA SACK. MF ARARE : 


<samp class="literal">$</samp> <kbd class="literal">cd ~_...._°/tutorial</kbd> 


<samp class="literal">$</samp> <kbd class="literal">psql -s mydb</kbd> 
<samp class="literal">...</samp> 


<samp class="literal">mydb=></samp> <kbd class="literal">\i basics.sql</kbd> 


Ai PUMBENMAP ZT. psql 的 -s 选项 把 你 置 于 单 步 模式 ， 它 在 向 服务 器 发 送 
每 个 语句 之 前 暂停 。 本 节 使 用 的 命令 都 在 pasics.sql 文件 中 。 


2.2. 概念 


PostgreSQL 是 一 种 关系 型 数据 库 管理 系统 (RDBMS)。 这 意味 着 它 是 一 种 用 于 管理 那些 以 关 
系 形式 存储 数据 的 系统 。 关 系 实际 上 是 表 的 数学 称呼 。 今 天 ， 把 数据 存储 在 表 里 的 概念 已 经 
快 成 固有 的 常识 了 ， 但 是 还 有 其 它 一 些 方法 用 于 组 织 数据 库 。 在 类 Unix 操作 系统 上 的 文件 和 
目录 就 形成 了 一 种 层次 数据 库 的 例子 。 更 现代 的 发 展 是 面 向 对 象 的 数据 库 。 


每 个 表 都 是 一 个 命名 的 行 的 集合 。 每 一 行 由 一 组 相同 的 命名 字段 组 成 。 而 且 每 个 字段 都 有 一 
个 特定 的 类 型 。 虽 然 每 个 字 段 在 每 一 行 里 的 位 置 是 固定 的 ， 但 一 定 要 记 住 SQL 并 未 对 行 在 表 
中 的 顺序 做 任何 保证 (但 你 可 以 对 它们 进行 明确 的 排序 显示 )。 


表 组 成 数据 库 ， 一 个 由 某 个 PostgreSQL 服 务 器 管理 的 数据 库 集合 组 成 一 个 数据 库 集群 。 


2.3. 创建 新 表 


你 可 以 通过 声明 表 的 名 字 和 所 有 字段 的 名 字 及 其 类 型 来 创建 表 : 


CREATE TABLE weather ( 


city varchar (80), 

temp_lo int, -- low temperature 
temp_hi int, -- high temperature 
prep real, -- precipitation 
date date 


你 可 以 在 psql 里 连 换行 符 一 起 键入 这 些 东 西 。 psa 可 以 识别 该 命令 直到 分 号 才 结 束 。 


你 可 以 在 SQL 命令 中 自由 使 用 空白 (空格 ，tab， 换 行 符 )。 这 意味 着 你 可 以 用 和 上 面 不 同 的 对 
章 方式 (甚至 在 同一 行 中 ) 键 人命 舍 。 双 划 线 (" -- ") 引入 注释 ， 任 何 跟 在 它 后 面 的 东西 直到 该 

行 的 结尾 都 被 忽略 。SQL 是 对 关键 字 和 标识 符 大 小 写 不 敏感 的 语言 ， 只 有 在 标识 符 用 双 引 号 
包围 时 才能 保留 它们 的 大 小 写 属 性 (上 面 没 有 这 么 干 )。 


varchar (80) 声明 一 个 可 以 存储 最 长 80 个 字符 的 任意 字符 串 的 数据 类 型 。 int 是 普通 的 整 

数 类 型 。 real 是 一 种 用 于 存储 单 精 度 浮 点 数 的 类 型 。 date 类 型 应 该 可 以 自 解释 。 we, Žž 
型 为 date WF 段 名 字 也 是 date 。 这 人 么 做 可 能 比较 方便 ， 也 可 能 容易 让 人 混淆 ， 你 自己 看 

啦 。 


PostgreSQL 支 持 标准 的 SQL 类 型 : int, smallint , real , double precision , 

char( ~_N_ ), varchar (> ~_N_ ), date , time , timestamp ,和 interval , 还 支持 其 它 的 通用 
类 型 和 丰富 的 几何 类 型 。PostgreSQL 人 允许 你 自 定义 任意 数量 的 数据 类 型 。 因 而 类 型 名 并 不 是 
语法 关键 字 ， 除 了 SQL 标准 要 求 支 持 的 特例 外 。 


第 二 个 例子 将 保存 城市 和 它们 相关 的 地 理 位 置 : 


CREATE TABLE cities ( 
name varchar (80), 
location point 


Ne 


point 类 型 就 是 一 个 PostgreSQL 特 有 的 数据 类 型 的 例子 。 


最 后 ， 我 们 还 要 提 到 如 果 你 不 再 需要 某 个 表 ， 或 者 你 想 创建 一 个 不 同 的 表 ， 那 么 你 可 以 用 下 
面 的 命令 删除 它 : 


DROP TABLE _tablename_; 


2.4. 回 表 中 添加 行 


INSERT 语句 用 于 向 表 中 添加 行 : 
INSERT INTO weather VALUES ('San Francisco', 46, 50, 0.25, '1994-11-27'); 
请 注意 所 有 数据 类 型 都 使 用 了 相当 明了 的 输入 格式 。 那 些 不 是 简单 数字 值 的 常量 必 需 用 单 引 


号 (' ) 包 围 ， 就 像 在 例子 里 一 样 。 date 类 型 实际 上 对 可 接收 的 格式 相当 灵活， 不 过 在 本 教 
程 里 ， 我 们 应 该 坚持 使 用 这 里 显示 的 格式 。 


point 类 型 要 求 一 个 坐标 对 作为 输入 ， 如 下 : 


INSERT INTO cities VALUES ('San Francisco', '(-194.0, 53.0)'); 


到 目前 为 止 使 用 的 语法 要 求 你 记 住 字段 的 顺序 。 一 个 可 选 的 语法 允许 你 明确 地 列 出 字段 : 


INSERT INTO weather (city, temp_lo, temp_hi, prcp, date) 
VALUES ('San Francisco', 43, 57, 0.0, '1994-11-29'); 


如 果 需 要 ， 你 可 以 用 另外 一 个 顺序 列 出 字段 或 者 是 忽略 某 些 字段 ， 比 如 说 ， 我 们 不 知道 降水 


Æ : 


INSERT INTO weather (date, city, temp_hi, temp_lo) 
VALUES ('1994-11-29', 'Hayward', 54, 37); 


许多 开发 人 员 认 为 明确 列 出 字段 要 比 依赖 隐 含 的 顺序 是 更 好 的 风格 。 
请 输入 上 面 显示 的 所 有 命令 ， 这 样 你 在 随后 的 各 节 中 才 有 可 用 的 数据 。 


你 还 可 以 使 用 coy 从 文本 文件 中 装载 大 量 数据 。 这 么 干 通常 更 快 ， 因为 copy 命令 就 是 为 这 
类 应 用 优化 的 ， 只 是 比 insert 少 一 些 灵 活性 。 比 如 : 


COPY weather FROM '/home/user/weather.txt'; 


这 里 源 文件 的 文件 名 必须 在 运行 后 端 进程 的 那 台 机 器 上 有 效 ， 而 不 是 在 客户 端 上 ， 因 为 后 端 
进程 直接 读 取 这 个 文件 。 你 可 以 在 COPY 中 读 到 更 多 有 关 copy MTN. 


2.5. 查询 一 个 表 


要 从 一 个 表 中 检索 数据 就 是 查询 这 个 表 。SQL 的 sELEcT 语句 就 是 做 这 个 用 途 的 。 该 语句 分 为 
选择 列表 ( 列 出 要 返回 的 字 段 )、 表 列表 ( 列 出 从 中 检索 数据 的 表 )、 以 及 可 选 的 条 件 (声明 任意 
限制 )。 比 如 ， 要 检索 表 weather 的 所 有 行 ， 键 和 : 


SELECT * FROM weather; 


这 里 的 * 是 "所 有 字段 "的 缩写 。 [1] 因此 同 祥 的 结果 可 以 用 下 面 的 语句 获 


SELECT city, temp_lo, temp_hi, prcp, date FROM weather; 


而 输出 应 该 是 
city | temp_lo temp_hi | prcp | date 
Pe aaa a eR ta OE kc pe peg NT fe ee ge ee ain Spee rey EE 
San Francisco i 46 | 50 | 0.25 | 1994-11-27 
San Francisco | 43 | 57 | © | 1994-11-29 
Hayward | 37 | 54 | | 1994-11-29 
(3 rows) 


你 可 以 在 选择 列表 中 写 任 意 表 达 式 ， 而 不 仅仅 是 字段 列表 。 比 如 ， 你 可 以 : 


SELECT city, (temp_hit+temp_lo)/2 AS temp_avg, date FROM weather; 


city l temp_avg l date 
San Francisco i 48 i 1994-11-27 
San Francisco | 50 | 1994-11-29 
Hayward | 45 | 1994-11-29 
(3 rows) 


注意 这 里 的 As 子 句 是 如 何 给 输出 字段 重新 命名 的 。 As 子 句 是 可 选 的 。 


一 个 查询 可 以 使 用 whERE 子 句 进 行 " 修 饰 "， 声 明 需 要 哪些 行 。 WHERE 子 句 包含 一 个 布尔 表达 
A ( 值 为 真 ) ， 只 有 那些 布尔 表达 式 为 真 的 行 才 会 被 返回 。 人 允许 你 在 条 件 中 使 用 常用 的 布尔 
操作 符 ( anD, OR, NoT )。 上 比如 ， 下 面 的 查询 检索 旧金山 的 下 雨天 的 天 气 : 


SELECT * FROM weather 
WHERE city = 'San Francisco' AND prcp > 0.0; 


结果 : 


city | temp_lo | temp_hi | prcp | date 
JAn annsna aoan e Se nee Meese SSeS 
San Francisco | 46 | 50 | 0.25 | 1994-11-27 
(1 row) 


你 可 以 要 求 返回 的 查询 是 排 好 序 的 : 


SELECT * FROM weather 
ORDER BY city; 


city | temp_lo | temp_hi | prcp | date 
3 a Set Serre soaoas 
Hayward | 37 | 54 | | 1994-11-29 
San Francisco | 43 | 57 | © | 1994-11-29 
San Francisco | 46 | 50 | 0.25 | 1994-11-27 


在 这 个 例子 里 ， 排 序 的 顺序 并 非 绝对 清晰 的 ， 因 此 你 可 能 看 到 San Francisco 47 随机 的 排 
序 。 但 是 如 果 你 使 用 下 面 的 语句 ， 那 么 就 总 是 会 得 到 上 面 的 结 


SELECT * FROM weather 
ORDER BY city, temp_lo; 


你 可 以 要 求 查 询 的 结果 消除 重复 行 的 输出 : 


SELECT DISTINCT city 
FROM weather; 


Hayward 
San Francisco 
(2 rows) 


再 次 声明 ， 结 果 行 的 顺序 可 能 是 随机 的 。 你 可 以 组 合 使 用 pistinct 和 oRDER By 来 获取 一 致 
的 结果 : [2] 


SELECT DISTINCT city 
FROM weather 
ORDER BY city; 


Notes 


[1] 虽然 sELEcT * 对 于 即兴 的 查询 是 有 用 的 ， 但 我 们 普通 认为 在 生产 代码 中 BERBERA 
格 ， 因 为 给 表 增 加 一 个 字段 就 改变 了 结果 。 


[2] 在 一 些 数据 库 系统 里 ， 包 括 老 版 本 的 PostgreSQL， piIsTINcT 自动 对 行进 行 排序 ， 
此 oRDER BY 是 多 余 的 。 但 是 这 一 点 并 不 是 SQL 标准 的 要 求 ， 并 且 目 前 的 PostgreSQL 并 不 
保证 DISTINCT 导致 数据 行 被 排序 。 


2.6. 在 表 间 连接 


到 目前 为 止 ， 我 们 的 查询 一 次 只 访问 了 一 个 表 。 查 询 可 以 一 次 访问 多 个 表 ， 或 者 用 某 种 方式 

访问 一 个 表 ， 而 同时 义理 该 表 的 多 个 行 。 一 个 同时 访问 同一 个 或 者 不 同 表 的 多 个 行 的 查询 叫 

连接 查询 。 举 例 来 说 ， 上 比如 你 想 列 出 所 有 天 气 记 录 以 及 这 些 记 录 相 关 的 城市 。 要 实现 这 个 目 

标 ， 我 们 需要 拿 weather 表 每 行 的 city 字段 和 cities 表 所 有 行 的 name 字段 进行 比较 ， 并 
选取 那些 这 些 数 值 相 匹配 的 行 。 


Note: 这 里 只 是 一 个 概念 上 的 模型 。 连 接 通常 以 比 实际 比较 每 个 可 能 的 配对 行 更 高 效 的 
方式 执行 ， 但 这 些 是 用 户 看 不 到 的 。 





这 个 任务 可 以 用 下 面 的 查询 来 实现 : 


SELECT * 
FROM weather, cities 
WHERE city = name; 


city l temp_lo l temp_hi l prcp date | name | location 
tarts ee are an ae pe eter en et een Sey ete een Sep heey os ghee E Be ee es ee eee A E E 
San Francisco i 46 | 50 i 0.25 i 1994-11-27 | San Francisco | (-194,53) 
San Francisco | 43 | S| © | 1994-11-29 | San Francisco | (-194,53) 
(2 rows) 
观察 结果 集 的 两 个 方面 : 


e 没有 城市 Hayward 的 结果 行 。 这 是 因为 在 cities 表 里 面 没有 与 Hayward 匹配 的 行 ， 所 
以 连接 忽略 了 weather 表 里 的 不 匹配 行 。 我 们 稍 后 将 看 到 如 何 修补 这 个 问题 。 


° 有 两 个 字段 包含 城市 名 。 这 是 正确 的 ， 因为 weather 和 cities 表 的 字段 是 接 在 一 起 的 。 
不 过 ， 实 际 上 我 们 不 想 要 这 些 ， 因此 你 将 可 能 希望 明确 列 出 输出 字段 而 不 是 使 用 * : 


SELECT city, temp_lo, temp_hi, prcp, date, location 
FROM weather, cities 
WHERE city = name; 


练习 : 看 看 省 略 were 子 句 的 含义 是 什么 。 


因为 这 些 字段 的 名 字 都 不 一 样 ， 所 以 分 析 器 自动 找 出 它们 属于 哪个 表 ， 但 是 如 果 两 个 表 中 有 
重复 的 字段 名 ， 你 就 必须 使 用 字段 全 称 限定 你 想 要 的 字段 : 


SELECT weather.city, weather.temp_lo, weather.temp_hi, 
weather.prcp, weather.date, cities.location 
FROM weather, cities 
WHERE cities.name = weather.city; 


一 般 认 为 在 连接 查询 里 使 用 字段 全 称 是 很 好 的 风格 ， 这 样 ， 即 使 在 将 来 向 其 中 一 个 表 里 添 加 
了 同名 字段 也 不 会 引起 混淆 。 


到 目前 为 止 ， 这 种 类 型 的 连接 查询 也 可 以 用 下 面 这 样 的 形式 写 出 来 : 


SELECT * 
FROM weather INNER JOIN cities ON (weather.city = cities.name); 


这 个 语法 并 非 像 上 面 那个 那么 常用 ， 我 们 在 这 里 写 出 来 是 为 了 让 你 更 容易 了 解 后 面 的 主题 。 


现在 我 们 将 看 看 如 何 能 把 Hayward 记录 找 回来 。 我 们 想 让 查询 干 的 事 是 扫描 weather 表 ， 并 
且 对 每 一 行 都 找 出 匹配 的 cities 表 里 面 的 行 。 如 果 没 有 找到 匹配 的 行 ， 那 么 需要 一 些 " 空 
MF cities 表 的 字段 。 这 种 类 型 的 查询 叫 外 连接 (我 们 在 此 之 前 看 到 的 连接 都 是 内 连 
接 )。 这 样 的 命令 看 起 来 像 这 样 


SELECT * 
FROM weather LEFT OUTER JOIN cities ON (weather.city = cities.name); 
city | temp_lo | temp_hi | prcp | date | name | location 
EE peee a E e 
Hayward | 37 | 54 | | 1994-11-29 | | 
San Francisco | 46 | 50 | 0.25 | 1994-11-27 | San Francisco | (-194,53) 
San Francisco | 43 | 57 | © | 1994-11-29 | San Francisco | (-194,53) 


(3 rows) 


这 个 查询 是 一 个 左 外 连接 ， 因 为 连接 操作 符 (LEFT OUTER JOIN) 左边 的 表 中 的 行 在 输出 中 至 
出现 一 次 ， 而 右边 的 表 只 输出 那些 与 左边 的 表 中 的 某 些 行 匹 配 的 行 。 如 果 输 出 的 左 表 中 的 
行 没有 右 表 中 的 行 与 其 对 应 ， 那 么 右 表 中 的 字段 将 填充 为 NULL., 


cS % 


练习 : 还 有 右 连 接 和 全 连接 。 试 着 找 出 来 它们 能 干什么 。 


我 们 也 可 以 把 一 个 表 和 它 自 己 连接 起 来 。 这 叫 自 连接 。 比如 ， 假 设 我 们 想 找 出 那些 在 其 它 天 
气 记录 的 温度 范围 之 外 的 天 气 记 录 。 这 样 我 们 就 需要 拿 weather 表 里 每 行 

的 temp_lo 和 temp_hi 字段 与 weather 表 里 其 它 行 的 temp_1lo 和 temp_hi 字段 进行 比较 。 我 
们 可 以 用 下 面 的 查询 实现 这 个 目标 : 


SELECT W1.city, W1.temp_lo AS low, W1.temp_hi AS high, 
W2.city, W2.temp_lo AS low, W2.temp_hi AS high 
FROM weather W1, weather W2 
WHERE W1.temp_lo < W2.temp_lo 
AND W1.temp_hi > W2.temp_hi; 


city | low | high | city | low l high 
ERE TEAS ae AA E TE S E E ae nee SEE E A 
San Francisco i 43 | 57 | San Francisco | 46 i 50 
Hayward IP ee 54 | San Francisco | 46 | 50 
(2 rows) 


在 这 里 我 们 把 weather 表 重 新 标记 为 wi 和 w 以 区 分 连接 的 左边 和 右边 。 你 还 可 以 用 这 样 
的 别名 在 其 它 查询 里 节约 一 些 敲 键 ， 比 如 : 


SELECT * 
FROM weather w, cities 
WHERE w.city = c.name; 


DUBS Biel x HES. 
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中 计算 出 一 个 结果 。 比 如 ， 我 们 有 在 一 个 行 集合 上 计算 count (A), sum (总 和 ), avg ( 均 
值 ), max (最 大 值 )，min (最 小 值 ) 的 函数 。 


比如 ， 我 们 可 以 用 下 面 的 语句 找 出 所 有 低温 中 的 最 高 温度 : 


SELECT max(temp_lo) FROM weather; 


如 果 我 们 想 知 道 该 读数 发 生 在 哪个 城市 ， 可 能 会 用 : 


SELECT city FROM weather WHERE temp_lo = max(temp_lo); _ 错 误 _ 


过 这 个 方法 不 能 运转 ， 因 为 聚集 加 数 max 不 能 用 于 whERE 子 句 中 。 存 在 这 个 限制 是 因 
为 WHERE 子 句 决定 哪些 行 可 以 进入 聚集 阶段 ; 因此 它 必 需 在 聚集 函数 之 前 计算 。 不 过 ， 我 们 
可 以 用 其 它 方 法 实现 这 个 目的 ; 这 里 我 们 使 用 子 查询 : 


SELECT city FROM weather 
WHERE temp_lo = (SELECT max(temp_lo) FROM weather); 


San Francisco 
(1 row) 


这 样 做 是 可 以 的 ， 因 为 子 查询 是 一 次 独立 的 计算 ， 它 独立 于 外 层 查 询 计算 自己 的 聚集 。 
聚集 同样 也 常用 于 crou BY 子 句 。 比 如 ， 我 们 可 以 获取 每 个 城市 低温 的 最 高 值 


SELECT city, max(temp_lo) 
FROM weather 
GROUP BY city; 


city | max 
CE Sen ee ad a ENAA E tof eee 
Hayward | <7 
San Francisco | 46 


(2 rows) 


这 样 每 个 城市 一 个 输出 。 每 个 聚集 结果 都 是 在 匹配 该 城市 的 行 上 面 计算 的 。 我 们 可 以 
用 HAvIN6 过 滤 这 些 分 组 : 


SELECT city, max(temp_lo) 
FROM weather 
GROUP BY city 
HAVING max(temp_lo) < 40; 


Hayward | 37 
(1 row) 


这 样 就 只 给 出 那些 temp_lo SZAF 40 度 的 城市 。 最 后 ， 如 果 我 们 只 关心 那些 名 字 
以 " s "开头 的 城市 ， 我 们 可 以 用 : 


SELECT city, max(temp_lo) 
FROM weather 
WHERE city LIKE 'S%'<a name="CO.TUTORIAL-AGG-LIKE">**(1)**</a> 
GROUP BY city 
HAVING max(temp_lo) < 40; 


(1) 
语句 中 的 LIKE 执行 模式 匹配 ， 在 Section 9.7 里 有 解释 。 


理解 聚集 和 SQL 的 whERE 和 waving 子 句 之 间 的 关系 非常 重要 。 wHERE 和 HAvING 的 基本 区 别 

如 下 : wHere 在 分 组 和 聚集 计算 之 前 选取 输入 行 ( 它 控 制 哪些 行进 入 聚集 计算 )， 

ayo 在 分 组 和 聚集 之 后 选取 输出 行 。 因 此 ， were FORRASREAR;: 因为 试图 
聚集 函数 判断 那些 行将 要 输入 给 聚集 运算 是 没有 意义 的 。 相反 ， Havin 子 句 总 是 包含 聚集 

当然 ， 你 可 以 写 不 使 用 聚集 的 waving 子 句 ， 但 这 样 做 没什么 好 处 ， 因 为 同样 的 条 件 用 

在 wHERE 阶段 会 更 有 效 。 


在 前 面 的 例子 里 ， 我 们 可 以 在 wHERE 里 应 用 城市 名 称 限制 ， 因 为 它 不 需要 聚集 。 这 样 比 
在 HAvING 里 增加 限制 更 加 高 效 ， 因 为 我 们 避免 了 为 那些 未 通过 wHERE 检查 的 行进 行 分 组 和 
聚集 计算 。 


2.8. 更 新 


你 可 以 用 uor 命令 更 新 现 有 的 行 。 假 设 你 发 现 所 有 11 月 28 日 的 温度 计数 都 低 了 两 度 ， 那 
么 你 就 可 以 用 下 面 的 方式 更 新 数据 : 


UPDATE weather 
SET temp_hi = temp_hi - 2, temp_lo = temp_lo - 2 
WHERE date > '1994-11-28'; 


看 看 数据 的 新 状态 : 


SELECT * FROM weather; 


city | temp_lo | temp_hi | prcp | date 
ee tt ema oa Sms 
San Francisco | 46 | 50 | 0.25 | 1994-11-27 
San Francisco | 41 | 55 | © | 1994-11-29 
Hayward | 35 | 52 | | 1994-11-29 


(3 rows) 


2.9. 删除 


数据 行 可 以 用 pELETE 命令 从 表 中 删除 。 假 设 你 对 Hayward 的 天 气 不 再 感 兴趣 ， 那么 你 可 以 
用 下 面 的 命令 把 那些 行 从 表 中 删除 : 


DELETE FROM weather WHERE city = 'Hayward'; 


所 有 属于 Hayward 的 天 气 记 录 都 将 被 删除 。 


SELECT * FROM weather; 


city | temp_lo | temp_hi | prcp | date 
3 Se Sooner oa o ease Soe aS 
San Francisco | 46 | 50 | 0.25 | 1994-11-27 
San Francisco | 41 | 55 | © | 1994-11-29 
(2 rows) 


使 用 下 面 形式 的 语句 时 一 定 要 小 心 : 


DELETE FROM _tablename_; 


如 果 没 有 指定 条 件 ， pELETE 将 从 指定 表 中 删除 所 有 行 。 做 这 些 之 前 系统 不 会 请 求 你 确认 ! 





Chapter 3. 高 级 特性 
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。 3.7. 结论 


在 前 面 几 章 里 ， 我 们 介绍 了 使 用 SQL 存储 和 访问 在 PostgreSQL 里 的 数据 的 基本 方法 。 我 们 现 
在 将 讨论 一 些 SQL 更 高 级 的 特性 ， 这 些 特性 可 以 简化 管理 和 避免 数据 的 丢失 或 损坏 。 最 后 ， 
我 们 将 看 看 一 些 PostgreSQL 的 扩展 。 


本 章 将 不 时 引用 Chapter 2 中 的 例子 ， 并 且 对 它们 进行 修改 和 提高 ， 因此 如 果 你 已 经 看 过 那 
章 会 更 好 。 本 章 的 一 些 例子 也 可 以 在 tutorial 目录 里 的 advanced.sql 文件 里 找到 。 这 个 文件 
还 包括 一 些 要 装载 的 例子 数据 ， 这 些 数据 没有 在 这 里 介绍 。 请 参考 Section 2.1 获 取 如 何 使 用 
该 文件 的 方法 。 


3.2. 视图 


回头 看 看 Section 2.6 里 的 查询 。 假 设 你 的 应 用 对 天 气 记录 和 城市 位 置 的 组 合 列表 特别 感 兴 
趣 ， 而 你 又 不 想 每 次 键入 这 些 查询 。 那 么 你 可 以 在 这 个 查询 上 创建 一 个 视图 ， 它 给 这 个 查询 
一 个 名 字 ， 你 可 以 像 普 通 表 那样 引用 它 。 
CREATE VIEW myview AS 
SELECT city, temp_lo, temp_hi, prcp, date, location 
FROM weather, cities 


WHERE city = name; 


SELECT * FROM myview; 
自由 地 运用 视图 是 好 的 SQL 数据 库 设计 的 一 个 关键 要 素 。 视 图 允许 我 们 把 表 结 构 的 细节 封装 
起 来 ， 这 些 表 可 能 随 你 的 应 用 进化 而 变化 ， 但 这 些 变化 却 可 以 隐藏 在 一 个 一 致 的 接口 后 面 。 
视图 几乎 可 以 在 一 个 真正 的 表 可 以 使 用 的 任何 地 方 使 用 。 在 其 它 视图 上 面 再 创建 视图 也 并 非 


罕见 。 


3.3. 外 键 


回忆 一 下 Chapter 2 里 的 weather 和 cities 表 。 考虑 下 面 的 问题 : 你 想 确 保 没有 人 可 以 

在 weather 表 里 插 入 一 条 在 cities 表 里 没 有 匹配 记录 的 数据 行 。 这 就 叫 维护 表 的 参照 完整 

性 。 在 简单 的 数据 库 系 统 里 ， 实现 (如 果 也 叫 实 现 ) 这 个 特性 的 方法 通常 是 先 看 看 cities 表 里 
是 否 有 匹配 的 记录 ， 然后 插入 或 者 拒绝 新 的 weather 记录 。 这 个 方法 有 许多 问题 ， 而 且 非 常 
不 便 ， 因 此 PostgreSQL 可 以 为 你 做 这 些 。 


新 的 表 声 明 看 起 来 会 像 下 面 这 样 : 


CREATE TABLE cities ( 
city varchar(80) primary key, 
location point 
); 
CREATE TABLE weather ( 
city varchar (80) references cities(city), 
temp_lo int, 
temp_hi int, 
prcp real, 
date date 


然后 我 们 试图 插入 一 条 非法 的 记录 : 


INSERT INTO weather VALUES ('Berkeley', 45, 53, 0.0, '1994-11-28'); 


ERROR: insert or update on table "weather" violates foreign key constraint "weather_city 
DETAIL: Key (city)=(Berkeley) is not present in table "cities". 


| 
外 键 的 行为 可 以 根据 你 的 应 用 仔细 调节 。 在 这 份 教程 里 我 们 就 不 再 多 说 了 ， 请 你 参考 Chapter 


5 以 获取 更 多 的 信息 。 正 确 使 用 外 键 无 疑 将 改进 你 的 数据 库 应 用 ， 所 以 我 们 强烈 建议 你 学 习 它 
们 。 





3.4. 事务 


事务 是 所 有 数据 库 系 统 的 一 个 基本 概念 。 一 次 事务 的 要 点 就 是 把 多 个 步骤 捆绑 成 一 个 单一 
的 、 不 成 功 则 成 仁 的 操作 。 其 它 并 发 的 事务 是 看 不 到 在 这 些 步骤 之 间 的 中 间 状 态 的 ， 并 且 如 
果 发 生 了 一 些 问题 ， 导致 该 事务 无 法 完成 ， 那 么 所 有 这 些 步骤 都 完全 不 会 影响 数据 库 。 


比如 ， 假 设 一 个 银行 的 数据 库 包含 各 种 客户 帐户 的 余额 ， 以 及 每 个 分 行 的 总 余额 。 假设 我 们 
要 记录 一 次 从 Alice 的 帐户 到 Bob 的 帐户 的 金额 为 $100.00 的 支付 动作 。 那么 ， 完 成 这 个 任 
务 的 简单 到 极点 的 SQL 命令 像 下 面 这 样 : 


UPDATE accounts SET balance = balance - 100.00 
WHERE name = 'Alice'; 
UPDATE branches SET balance = balance - 100.00 
WHERE name = (SELECT branch_name FROM accounts WHERE name = 'Alice'); 
UPDATE accounts SET balance = balance + 100.00 
WHERE name = 'Bob'; 
UPDATE branches SET balance = balance + 100.00 
WHERE name = (SELECT branch_name FROM accounts WHERE name = 'Bob'); 


这 些 命令 的 细节 在 这 儿 并 不 重要 ; 重要 的 是 这 里 牵涉 到 了 好 几 个 独立 的 更 新 来 完成 这 个 相当 
简单 的 操作 。 银行 官员 会 希望 要 么 所 有 这 些 更 新 全 部 生效 ， 要 么 全 部 不 起 作用 。 我 们 当然 不 
希望 一 次 系统 崩溃 就 导致 Bob KE 100 块 不 是 Alice 支付 的 钱 ， 也 不 希望 Alice 老 是 不 花 钱 
从 Bob 那里 拿 到 物品 。 我 们 需要 保证 : 如 果 在 操作 的 过 程 中 出 了 差错 ， 那 么 所 有 这 些 步骤 都 
会 发 生效 果 。 把 这 些 更 新 组 合成 一 个 事务 就 给 予 我 们 这 样 的 保证 。 事 务 被 认为 是 原子 的 : 
从 其 它 事务 的 角度 来 看 ， 它 要 么 是 全 部 发 生 ， 要 么 完全 不 发 生 。 


我 们 还 需要 保证 : 一 旦 一 个 事务 完成 并 且 得 到 数据 库 系 统 的 认可 ， 那 么 它 必须 被 真正 永久 地 
Fi, 并 且 不 会 在 随后 的 月 淡 中 消失 。 上 比如 ， 如 果 我 们 记录 到 了 一 个 Bob 撤 单 的 动作 ， AA 
我 们 不 希望 仅仅 在 他 走出 银行 大 门 之 后 的 一 次 崩溃 就 会 导致 对 他 的 帐户 的 扣 减 动作 消失 。 一 
个 事务 型 数据 库 保 证 一 个 事务 所 做 的 所 有 更 新 在 事务 发 出 完成 响应 之 前 都 记录 到 永久 的 存储 
中 (也 就 是 磁盘 )。 


事务 型 数据 库 的 另外 一 个 重要 的 性 质 和 原子 更 新 的 概念 关系 密切 : 当 多 个 事务 并 发 地 运行 的 
时 候 ， 每 个 事务 都 不 应 看 到 其 它 事务 所 做 的 未 完成 的 变化 。 比 如 ， 如 果 一 个 事务 正 忙 着 计算 
所 有 分 行 的 余额 总 和 ， 那么 它 不 应 该 包括 来 自 Alice 的 分 行 的 扣 帐 和 来 自 Bob 分 行 的 入 帐 ， 
反之 亦 然 。 所 以 事务 必须 是 黑白 分 明 的 ， 不 仅仅 体现 在 它们 在 数据 库 上 产生 的 永久 影响 上 ， 
而 且 体 现在 它们 运转 时 的 自身 的 可 视 性 上 。 一 个 打开 的 事务 所 做 的 更 新 在 它 完 成 之 前 是 无 法 
被 其 它 事务 看 到 的 ， 而 到 提交 的 时 候 所 有 更 新 同时 可 见 。 


在 PostgreSQL 里 ， 一 个 事务 是 通过 把 SQL 命令 用 BEGIN 和 coMMIT 命令 包围 实现 的 。 因 此 
我 们 的 银行 事务 实际 上 看 起 来 像 下 面 这 样 : 


BEGIN; 

UPDATE accounts SET balance = balance - 100.00 
WHERE name = '‘Alice'; 
= 


COMMIT; 


如 果 在 该 事务 的 过 程 中 ， 我 们 决定 不 做 提交 (可 能 是 我 们 刚 发 现 Alice 的 余额 是 负数 )， 那么 我 
们 可 以 发 出 RoLLBACK 而 不 是 comi 命令 ， 那 么 到 目前 为 止 我 们 的 所 有 更 新 都 会 被 取消 。 
PostgreSQL 实际 上 把 每 个 SQL 语句 当做 在 一 个 事务 中 执行 来 看 待 。 如 果 你 没有 发 


出 BEGIN 命令 ， 那 么 每 个 独立 的 语句 都 被 一 个 隐 含 的 BE6IN 和 (如 果 成 功 的 话 ) commit 包围 。 
一 组 包围 在 BEGIN 和 commit 之 间 的 语句 有 时 候 被 称 做 事务 块 。 











Note: 一 些 客户 端 库 自 动 发 出 BEGIN 和 commit, 因此 你 可 能 不 需要 特意 请 求 就 可 以 获 
得 事务 块 的 效果 。 坦 看 你 使 用 的 接口 的 文档 。 





我 们 可 以 通过 使 用 保存 点 的 方法 ， 在 一 个 事务 里 更 加 精细 地 控制 其 中 的 语句 。 保存 点 允许 你 
选择 性 地 抛 奔 事 务 中 的 某 些 部 分 ， 而 提交 剩 下 的 部 分 。 在 用 sAvEPoINT 定义 了 一 个 保存 点 
后 ， 如 果 需 要 ， 你 可 以 使 用 RoLLBACK To 回 滚 到 该 保存 点 。 则 该 事务 在 定义 保存 点 到 
ROLLBACK TO 之 间 的 所 有 数据 库 更 改 都 被 抛弃 ， 但 是 在 保存 点 之 前 的 修改 将 被 保留 。 


在 回 滚 到 一 个 保存 点 之 后 ， 这 个 保存 点 仍然 保存 着 其 定义 ， 所 以 你 可 以 回 滚 到 这 个 位 置 好 几 
Ro 当然 ， 如 果 你 确信 你 不 需要 再 次 回 滚 到 一 个 保存 点 ， 那 么 你 可 以 释放 它 ， 这 样 系统 可 以 
释放 一 些 资源 。 要 记 住 : 释放 或 者 回 滚 到 一 个 保存 点 都 会 自动 释放 在 其 后 定义 的 所 有 保存 
点 


IWNO 


所 有 这 些 都 发 生 在 一 个 事务 块 内 部 ， 所 以 所 有 这 些 都 不 可 能 被 其 它 事 务 会 话 看 到 。 SHARKS 
你 提交 了 这 个 事务 块 ， 这 些 提 交 了 的 动作 才能 以 一 个 单元 的 方式 被 其 它 会 话 看 到 ， 而 回 滚 的 
动作 完全 不 会 被 看 到 。 


记得 我 们 的 银行 数据 库 吗 ? 假设 我 们 从 Alice 的 帐户 上 消费 $100.00 ， 然 后 给 Bob 的 帐户 进 
行 加 款 ， 稍 后 我 们 发 现 我 们 应 该 给 Wally 的 账号 加 款 。 那 么 我 们 可 以 像 下 面 这 样 使 用 保存 


MN" 


BEGIN; 

UPDATE accounts SET balance = balance - 100.00 
WHERE name = 'Alice'; 

SAVEPOINT my_savepoint; 

UPDATE accounts SET balance = balance + 100.00 
WHERE name = 'Bob'; 

- 呀 ! 加 错 钱 了 ， 应 该 用 Wally 的 账号 

ROLLBACK TO my_savepoint; 

UPDATE accounts SET balance = balance + 100.00 
WHERE name = 'Wally'; 

COMMIT; 


这 个 例子 当然 是 实在 太 简 单 了 ， 但 是 通过 使 用 保存 点 ， 我 们 可 以 对 事务 块 有 大 量 的 控制 。 并 
H, ROLLBAcK To 是 除了 事务 全 部 回 滚 ， 重 新 来 过 之 外 ， 唯一 可 以 用 于 重新 控制 一 个 因 错 误 
而 被 系统 置 于 退出 状态 事务 的 方法 。 
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3.5. 窗口 函数 


窗口 函数 在 和 当前 行 相关 的 一 组 表 行 上 执行 计算 。 这 相当 于 一 个 可 以 由 聚合 画 数 完 成 的 计算 
类 型 。 但 不 同 于 常规 的 聚合 画 数 ， 使 用 的 窗口 函数 不 会 导致 行 被 分 组 到 一 个 单一 的 输出 行 ; 
行 保留 其 独立 的 身份 。 在 后 台 ， 窗 口 画 数 能 够 访问 的 不 止 查询 结果 的 当前 行 。 


这 里 是 一 个 例子 ， 说 明 如 何 比较 每 个 员工 的 工资 和 在 他 或 她 的 部 门 的 平均 工资 : 


SELECT depname, empno, salary, avg(salary) OVER (PARTITION BY depname) FROM empsalary; 


depname | empno | salary | avg 

pedeeescede Fonna onnan a 用 有 下 生生 让 让 下 下 天 二 下 下 于 
develop | 11 | 5200 | 5020.0000000000000000 
develop | 7 | 4200 | 5020.0000000000000000 
develop | 9 | 4500 | 5020.0000000000000000 
develop | 8 | 6000 | 5020.0000000000000000 
develop | 10 | 5200 | 5020.0000000000000000 
personnel | 5 | 3500 | 3700.0000000000000000 
personnel | 2 | 3900 | 3700.0000000000000000 
sales | 3 | 4800 | 4866.6666666666666667 
sales | 1 | 5000 | 4866.6666666666666667 
sales | 4 | 4800 | 4866.6666666666666667 
(10 rows) 


前 三 输出 列 直接 来 自 表 empsalary ， 并 有 一 个 针对 表 中 的 每 一 行 的 输出 行 。 第 四 列 将 代表 所 
有 含有 相同 的 depname 值 的 表 行 的 平均 值 作为 当前 值 。 《这 实际 上 和 与 标准 avg RARI 
能 相同 ， 但 是 over 子 名 使 其 被 视 为 一 个 窗口 本 数 并 在 一 组 合适 的 行 上 执行 计算 。 ) 


窗口 函数 的 调用 总 是 包含 一 个 ovER 子 句 ， 后 面 直 接 跟 着 窗口 函数 的 名 称 Wa 这 是 它 在 
语法 上 区 别 于 普通 函数 或 聚合 功能 的 地 方 。 ovER 子 句 决 定 如 何 将 查询 的 行进 行 拆 分 以 便 给 
AOKI, over 子 句 内 的 PARTITION BY 列表 指定 将 行 划 分 成 组 或 分 区 ， 组 或 分 区 共享 
相同 的 partition BY 表达 式 的 值 。 对 于 每 一 行 ， 窗 口 函 数 在 和 当前 行 落 在 同一 个 分 区 的 所 有 
行 上 进行 计算 。 


Rik BY OA AO Se over 内 的 oRDER BY 来 控制 行 的 顺序 。 ( oRDER BY 窗口 甚至 不 需 
与 行 的 输出 顺序 相 匹 配 。) 下 面 是 一 个 例子 


SELECT depname, empno, salary, rank() OVER (PARTITION BY depname ORDER BY salary DESC) FR 


ss 





depname | empno | salary | rank 
Secs seeance phe Se eR Sesame Ge is 
develop | 8 | 6000 | 1 
develop | 10 | 5200 | 2 
develop | Ir 5200 | 2 
develop | 9 | 4500 | 4 
develop | 1A || 4200 | 5 
personnel | 2 | 3900 | 1 
personnel | saj 3500 | 2 
sales | 1 | 5000 | 1 
sales | 4 | 4800 | 2 
sales | S| 4800 | 2 
(10 rows) 


正如 此 处 所 示 ， rank AGREE oRDER BY 子 句 定义 的 顺序 ， 在 当前 行 的 分 区 里 为 每 个 不 同 
的 oRDER BY 值 产生 了 一 个 数值 排名 。 rank 不 需要 明确 的 参数 ， 因 为 它 的 行为 完全 取决 
于 ovER 子 句 。 


窗口 函数 的 行 来 自 查询 的 FRoM 子 名 产生， 并且 如 果 有 的 话 ， 经 

过 WHERE , GROUP BY 和 HAVING 子 句 过 滤 的 "虚拟 表 "。 比如 ， 被 移 除 掉 的 行 ， 因 为 不 符 

合 were 条 件 ， 所 以 是 不 能 被 任何 窗口 函数 可 见 的 。 一 个 查询 可 以 包含 多 个 窗口 本 数 ， 通 过 
不 同 的 over 子 句 用 不 同 的 方式 分 割 数据 ， 但 是 他 们 都 作用 在 这 个 虚拟 表 定 义 的 同一 个 行 集 


A 
Oo 


我 们 已 经 看 到 了 ， 如 果 行 排序 并 不 重要 ， oRDER BY 可 以 省 略 。 在 只 有 一 个 包含 了 所 有 行 的 分 
区 情况 下 ， 也 可 以 省 略 PARTITION BY 。 


还 有 一 个 与 窗口 函数 相关 的 重要 的 概念 : 对 于 每 一 行 ， 有 在 其 分 区 范围 内 的 行 集 ， 又 称 为 它 
的 window frame。 许 多 【但 不 是 全 部 ) 窗口 画 数 ， 只 作用 于 window frame 中 的 行 上 ， 而 不 是 
整个 分 区 。 默 认 情 况 下 ， 如 果 使 用 ore BY ， 那么 这 个 frame 包 含 从 分 区 开始 到 当前 行 的 所 
有 行 ， 以 及 那些 当前 行 后 面 的， 根据 oRDER BY 子 句 等 于 当前 行 的 所 有 行 ， 如 果 省 

略 ORDER BY ， 那 么 ，frame 默 认 包含 分 区 中 的 所 有 行 。 [1] 下 面 是 一 个 使 用 sum 的 例子 : 


SELECT salary, sum(salary) OVER () FROM empsalary; 


salary sum 
5200 47100 
5000 47100 
3500 47100 
4800 47100 


5200 
(10 rows 


w 
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如 上 ， 因 为 在 ovER 子 句 中 没有 使 用 ore sy, Atk, window frame 与 分 区 (不 使 

用 partition BY 时 即 整 个 表 ) 相 同 ; 换 句 话说 ， 每 一 次 sum 求 和 都 是 使 用 表 中 所 有 的 salary， 
所 以 我 们 得 到 的 每 个 输出 行 的 结果 相同 。 但 是 ， 如 果 我 们 添加 oRDER BY 子 句 ， 我 们 会 得 到 不 
同 的 结 


SELECT salary, sum(salary) OVER (ORDER BY salary) FROM empsalary; 


salary | sum 

eye eon ee apiece a 
3500 | 3500 
3900 | 7400 
4200 | 11600 
4500 | 16100 
4800 | 25700 
4800 | 25700 
5000 | 30700 
5200 | 41100 
5200 | 41100 
6000 | 47100 

(10 rows) 


这 里 的 总 和 是 从 第 一 个 〈 最 低 ) 工资 到 当前 一 个 ， 包 括 任何 当前 重复 的 〈 注 意 重 复 薪 金 的 结 
果 ) 。 


窗口 函数 仅 允 许 在 查询 的 SELECT 列表 和 oRDER BY 子 句 中 使 用 。 在 其 他 地 方 禁止 使 用 ， 比 
如 GROUP BY , HAVING 和 WHERE 子 句 。 这 是 因为 它们 逻辑 上 在 处 理 这 些 子 句 之 后 执行 。 此 外 ， 
窗口 函数 在 标准 聚合 画 数 之 后 执行 。 这 意味 在 一 个 窗口 函数 的 参数 中 包含 一 个 标准 聚合 画 数 
的 调用 是 有 效 的 ， 但 反 过 来 不 行 。 


执行 窗口 计算 后 ， 如 果 有 必要 对 行进 行 过 滤 或 分 组 ， 你 可 以 使 用 子 查询 。 例 如 : 


SELECT depname, empno, salary, enroll_date 
FROM 
(SELECT depname, empno, salary, enroll_date, 
rank() OVER (PARTITION BY depname ORDER BY salary DESC, empno) AS pos 
FROM empsalary 
) AS ss 
WHERE pos < 3; 


上 面 的 查询 只 显示 内 部 查询 结果 中 rank 小 于 3 的 行 。 


当 查 询 涉 及 多 个 窗口 画 数 时 ， 可 以 写成 每 一 个 都 带 有 单独 的 over FH, 但 是 ， 如 果 期 待 为 
多 个 窗口 函数 采用 相同 的 窗口 行为 ， 这 样 做 就 会 产生 重复 ， 并 且 容 易 出 错 。 作为 代替 ， 每 个 
窗口 行为 可 以 在 wINDow 子 句 中 进行 命名 ， 然 后 再 被 over 引用 。 例如 : 

SELECT sum(salary) OVER w, avg(salary) OVER w 


FROM empsalary 
WINDOW w AS (PARTITION BY depname ORDER BY salary DESC); 


有 关 窗 口 函 数 的 更 多 详细 信息 请 查阅 Section 4.2.8, Section 9.21,Section 7.2.4, 和 SELECT 的 


Notes 


[1] 当然 ， 还 有 其 他 定义 window frame 的 方法 ， 但 本 教程 并 不 包括 它们 。 详 情 请 参阅 Section 
4.2.8。 


3.6. 继承 


继承 是 面向 对 象 的 数据 库 的 概念 。 它 开启 了 数据 库 设 计 的 有 趣 的 新 的 可 能 性 。 


让 我 们 创建 两 个 表 : 一 个 cities 表 和 一 个 capitals 表 。 自然 ， 首 府 (capital) 也 是 城市 
(cities)， 因 此 在 列 出 所 有 城市 时 你 想 要 某 种 方法 隐 含 地 显示 首府 。 如 果 你 已 经 很 高 明了 ， 那 
么 你 可 能 会 创造 类 似 下 面 这 样 的 模式 : 


CREATE TABLE capitals ( 


name text, 

population real, 

altitude int, -- (单位 是 英尺 ) 
State char(2) 


Ne 


CREATE TABLE non_capitals ( 


name text, 
population real, 
altitude int -- (单位 是 英尺 ) 


人 


CREATE VIEW cities AS 
SELECT name, population, altitude FROM capitals 
UNION 
SELECT name, population, altitude FROM non_capitals; 


如 果 只 是 查询 ， 那 么 这 个 方法 运转 得 很 好 ， 但 是 如 果 你 需要 更 新 某 几 行 ， 那 这 个 方法 就 很 难 
看 了 。 


一 种 更 好 的 方法 是 : 


CREATE TABLE cities ( 

name text, 

population real, 

altitude int -- (单位 是 英尺 ) 
); 


CREATE TABLE capitals ( 
state char (2) 
) INHERITS (cities); 


在 这 个 例子 里 ， capitals 继承 了 其 父 表 cities 的 所 有 字段 ( name , population 

和 altitude )。 字 段 name 的 类 型 text 是 PostgreSQL 用 于 变 长 字符 串 的 固有 类 型 。 州 首府 有 
一 个 额外 的 字段 state 显示 其 所 处 的 州 。 在 PostgreSQL 里 ， 一 个 表 可 以 从 需 个 或 者 更 多 其 
它 表 中 继承 过 来 。 


比如 ， 下 面 的 查询 找 出 所 有 海拔 超过 500 英尺 的 城市 的 名 字 ， 包 括 州 首府 : 


SELECT name, altitude 
FROM cities 
WHERE altitude > 500; 


它 返 回 : 


name | altitude 
过 pela eae 
Las Vegas | 2174 
Mariposa | 1953 
Madison | 845 
(3 rows) 


另 一 方面 ， 下 面 的 查询 找 出 所 有 不 是 州 首 府 并 且 位 于 海拔 大 于 或 等 于 500 英尺 的 城市 : 


SELECT name，altitude 
FROM ONLY cities 
WHERE altitude > 500; 


name | altitude 
see a ee Pe eee See 
Las Vegas | 2174 
Mariposa | 1953 
(2 rows) 


cities 前 面 的 oNLY 指示 系统 只 对 cities 表 运 行 查询 ， 而 不 包括 继承 级 别 中 低 于 cities 的 
Ro 许多 我 们 已 经 讨论 过 的 命令 一 SELECT, UPDATE 和 DELETE 一 都 支持 这 个 oNLY 表示 法 。 





Note: 尽管 继承 经 常 是 有 用 的 ， 但 是 它 还 没有 集成 唯一 约束 或 者 外 键 ， 因 此 制约 了 其 实 
用 性 。 参阅 Section 5.8 以 获取 更 多 细节 。 


3.7. 结论 


PostgreSQL 有 许多 这 份 教程 里 没有 谈 到 的 特性 ， 为 这 份 教程 主要 是 面向 新 SQL 用 PN, 
这 些 特性 在 本 书 剩 余部 分 类 有 更 详细 的 介绍 。 


如 果 你 觉得 自己 需要 更 多 介绍 材料 ， 请 访问 PostgreSQL 网 站 获取 更 多 资源 的 链接 。 


这 一 部 分 描述 PostgreSQL 2M SQL 语言 的 使 用 。 我 们 从 描述 SQL 的 一 般 语法 开始 ， 然 后 
解释 如 何 创建 保存 数据 的 结构 、 如 何 填充 数据 库 、 以 及 如 何 查 询 数据 库 。 中 间 部 分 列 出 了 用 
户 可 以 在 SQL PB HEA NAHE BA. 剩 下 的 部 分 讨论 那些 对 调节 数据 库 、 优 化 其 性 
能 很 重要 的 几 个 方面 。 


这 部 分 的 信息 是 这 样 安排 的 : 新 手 可 以 从 头 读 到 尾 ， 便 可 以 获取 相关 主题 的 完整 信息 ， 而 不 
需要 向 前 参考 太 多 次 。 里 面 的 章节 是 设计 成 内 容 完整 独立 的 ， 这 样 高 级 用 户 就 可 以 选择 独立 
的 章节 来 阅读 。 这 部 分 的 信息 是 按照 主题 单元 以 叙述 的 方式 组 织 的 。 如 果 你 需要 了 解 特 定 命 
倒 的 完整 描述 ， 那 么 应 该 看 看 Part Vi. 


本 书 的 读者 应 该 知道 如 何 连接 PostgreSQL 数据 库 并 执行 SQL 命令 。 我 们 建议 那些 不 熟悉 这 
些 方面 的 读者 首先 阅读 Part | 。 通 常 SQL 命令 是 通过 PostgreSQL 交互 终端 psql 输入 的 ， 但 
也 可 以 使 用 其 它 有 类 似 功 能 的 程序 。 
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本 章 描述 SQL 的 语法 。 这 些 内 容 是 理解 随后 各 章 的 基础 ， 那些 章 里 面 将 详细 介绍 SQL 命 兮 
如 何 用 于 定义 和 修改 数据 。 


我 们 也 建议 那些 已 经 很 熟悉 SQL 的 用 户 仔细 阅读 本 章 ， 因 为 有 一 些 规则 和 概念 在 SQL 数据 
库 之 间 并 不 一 致 ， 或 者 是 有 些 东 西 是 PostgreSQL 特 有 的 。 


4.1. 词法 结构 


SQL 输入 由 一 系列 命令 组 成 。 一 条 命令 由 一 系列 记号 构成 ， 用 一 个 分 号 (";") 结 尾 。 输 入 流 的 
终止 也 结束 一 条 命令 。 哪些 记号 是 合法 的 取决 于 特定 命令 的 语法 。 


记号 可 以 是 一 个 关键 字 、 标 识 符 、 引号 包围 的 标识 符 、 文 本 (或 常量 )、 特殊 的 字符 符号 。 记 
号 通常 由 空白 分 隔 (空格 /tab/ 换 行 符 )， 但 如 果 不 存 在 混淆 的 时 候 也 可 以 不 用 (通常 只 是 一 个 特 
殊 字符 与 一 些 其 它 记 号 类 型 相连 的 时 候 )。 


比如 ， 下 列 命令 是 (语法 上 ) 合 法 的 SQL 输入 : 


SELECT * FROM MY_TABLE; 
UPDATE MY_TABLE SET A = 5; 
INSERT INTO MY_TABLE VALUES (3, 'hi there'); 


这 里 是 三 条 命令 的 序列 ， 每 条 一 行 (尽管 并 不 要 求 这 人 么 做 ; 多 条 命令 可 以 在 一 行 里 ， 单条 命令 
也 可 以 合理 地 分 裂 成 多 行 )。 


另外 ， 在 SQL 输入 里 可 以 有 注释 。 它 们 不 是 记号 ， 它 们 实际 上 等 效 于 空白 。 


如 果 从 哪些 记号 标识 命令、 哪些 是 操作 数 或 参数 的 角度 考虑 ，SQL 语法 并 不 是 非常 一 致 。 通 
常 头 几 个 记号 是 命令 名 字 ， 因 此 上 面 的 例子 我 们 通常 可 以 说 是 一 个 "SELECT"、 一 

个 "UPDATE'"、 和 一 个 "INSERT" 命 令 。 不 过 ， UPDATE 命令 总 是 要 求 一 个 ser 在 某 个 位 置 出 
现 ， 并 且 这 个 特定 的 insert 还 要 求 有 一 个 vaus 才 完 整 。 每 条 命令 的 准确 语法 规则 都 

在 Part Vl 里 描述 。 


4.1.1. 标识 符 和 关键 字 


像 上 面 例子 里 的 sELECT ， UPDATE 或 vALUES 这 样 的 记号 都 是 关键 字 的 例子 ， 也 就 是 那些 在 
SQL 语言 里 有 固定 含义 的 单词 。 记 号 MY_TABLE 和 A 是 标识 符 的 例子 。 根 据 使 用 它们 的 命 兮 
的 不 同 ， 它们 标识 表 、 字 段 、 或 者 其 它 数据 库 对 象 的 名 字 。 因 此 ， 有 时 候 只 是 简单 地 叫 它 们 
"名 字 "。 关 键 字 和 标识 符 有 着 同样 的 词法 结构 ， 意思 是 我 们 在 没有 认识 这 种 语言 之 前 是 无 法 
区 分 一 个 记号 是 标识 符 还 是 名 字 。 你 可 以 在 Appendix C 里 找到 一 个 关键 字 的 完整 列表 。 


SQL 标识 符 和 关键 字 必 须 以 一 个 字母 ( a - z 以 及 带 变 音 符 的 字母 和 非 拉丁 字母 ) 或 下 划 线 

( _ ) 开 头 ， 随后 的 字符 可 以 是 字母 、 下 划 线 、 数 字 ( 0-9) 美元 符号 ( $ )。 需 要 注意 的 

是 ， 根 据 SQL 标准 ， 美 元 符号 不 允许 出 现在 标识 符 中 ， 因此 使 用 美元 符号 将 不 易 移植 。SQL 
标准 不 会 定义 包含 数字 或 者 以 下 划 线 开头 或 结尾 的 关键 字 ， 因此 按照 这 种 格式 定义 的 标识 符 
是 安全 的 ， 不 会 和 将 来 标准 的 扩展 特性 冲突 。 


系统 使 用 不 超过 NAMEDATALEN -1 个 字符 作为 标识 符 ; 你 可 以 在 命令 中 写 更 长 的 名 字 ， 但 它们 
会 被 截断 。 NAMEDATALEN 的 缺 省 值 是 64 ， 因此 标识 符 最 大 长 度 是 63 字 节 。 如 果 觉 得 这 个 限 
制 有 问 题 ， 那么 你 可 以 在 src/include/pg_config_manual.h 里 修改 NAMEDATALEN 来 改变 它 。 


关键 字 和 未 被 引号 包围 的 标识 符 都 是 大 小 写 无 关 的 。 因 此 : 


UPDATE MY_TABLE SET A = 5; 


也 可 以 等 效 地 写成 : 


UPDaTE my_TabLE SeT a = 5; 


一 种 好 习惯 是 把 关键 字 写 成 大 写 ， 而 名 字 等 用 小 写 : 


UPDATE my_table SET a = 5; 


还 有 第 二 种 标识 符 : 分 隔 标 识 符 或 引号 包围 的 标识 符 。 它 是 通过 在 双 引 号 ( " ) 中 包围 任意 字 
符 序 列 形成 的 。 分 隔 标识 符 总 是 一 个 标识 符 ， 而 不 是 关键 字 。 因 此 ， 你 可 以 用 "select" X 

示 一 个 字段 或 者 表 的 名 字 ， 而 一 个 没有 引号 的 select 将 被 当做 一 条 命令 的 一 部 分 ， 因 此 如 果 
把 它 当 做 一 个 表 名 或 者 字段 名 使 用 的 话 就 会 产生 一 个 分 析 错 误 。 上 面 的 例子 可 以 用 引号 包围 

的 标识 符 这 么 写 : 


UPDATE "my_table" SET "a" = 5; 
引号 包围 的 标识 符 可 以 包含 编码 不 等 于 震 的 任意 字符 (要 包含 一 个 双 引 号 ， 可 以 写 两 个 相连 的 


双 引 号 )。 这 样 我 们 就 可 以 构造 那些 原本 是 不 允许 的 表 名 或 者 字段 名 ， 上 比如 那些 包含 空白 或 与 
号 (&) 的 名 字 。 但 长 度 限制 依旧 。 


一 个 带 引 号 的 标识 符 的 变形 允许 带 有 代码 点 标记 的 逃逸 Unicode 字 符 。 该 变形 以 ug 开始 
(大 /小 写 U 后 跟 有 & 符 号 ) 紧 跟 着 打开 的 双 引 号 ， 之 间 没 有 空格 ， 例 如 u&"foo" 。 (需要 注 
意 的 是 ， 这 可 能 产生 和 操作 符 & 之 间 的 歧义 。 可 以 在 操作 符 周围 加 上 空格 来 避免 该 问题 。) 
在 引号 中 ， 通 过 写 一 个 后 面 跟 有 上 反 斜 枉 和 四 位 十 六 进 制 代码 点 或 跟 有 反 斜 枉 和 加 号 和 六 位 十 
六 进 制 代码 点 ， Unicode 字 符 可 以 写成 逃逸 格式 。 例如 ， "data" 可 以 写成 : 


U&"d\0061t\+000061" 


下 例 以 西里 尔 字母 写 俄 文 "slon"” (R) 。 


U&"\0441\043B\043E\043D" 


如 果 需 要 一 个 非 反 斜 杠 的 不 同 的 逃逸 ， 可 以 通过 在 字符 串 之 后 使 用 vesca 语句 来 进行 声 
明 ， 如 : 


U&"d!0061t!+000061" UESCAPE '!' 


逃逸 字符 可 以 是 一 个 十 六 进 制 数字 以 外 的 任何 单个 字符 ， 加 号 ， 一 个 单 引 号 ， 一 个 双 引 号 ， 
或 一 个 空白 字符 。 需 要 注意 的 是 ， 逃 逸 字符 是 写 在 单 引 号 中 ， 而 不 是 双 引 号 中 。 


为 了 将 逃逸 字符 写 到 标识 符 中 ， 可 以 将 它 写 两 次 。 


只 有 服务 器 字符 集 是 urFs 时 ， 才 会 完全 使 用 Unicode 逃 逸 语法 。 当 使 用 其 他 服务 器 字符 集 
时 ， 只 有 在 ASCII 内 的 (最 多 \ee7F ) 代码 点 可 以 被 声明 。 4 位 和 6 位 的 数字 形式 可 以 被 用 来 
将 UTF-16 代 理 对 声明 为 大 于 U+FFFF 的 带 有 代码 点 的 字符 ， 尽管 6 位 数字 形式 技术 的 可 用 性 
使 得 这 样 做 没有 必要 。 (代理 对 不 是 直接 存储 的 ， 首先 ， 它 们 结合 成 一 个 单一 的 代码 点 ， 然 
后 再 用 UTF-8 编 码 。) 


把 一 个 标识 符 用 引号 包围 起 来 同时 也 邻 它 大 小 写 相 关 ， 而 没有 引号 包围 起 来 的 名 字 总 是 转 成 
WE, 比如 ， 我 们 认为 标识 符 Foo, foo 和 "foo" 是 等 价 的 PostgreSQL 名 字 ， 

但 "Foo" 和 "Foo" 与 上 面 三 个 以 及 它们 之 间 都 是 不 同 的 。PostgreSQL 里 对 未 加 引号 的 名 子 
总 是 转换 成 小 写 ， 这 和 SQL 标准 是 不 兼容 的 ，SQL 标准 要 求 未 用 引号 包围 起 来 的 名 字 总 是 
转 成 大 写 。 因 此 根据 标准 ， foo EF "Foo" 但 不 等 于 "foo" 。 如 果 你 想 编写 可 移植 的 程 

序 ， 那 么 我 们 建议 你 要 么 就 总 是 用 引号 包围 某 个 名 字 ， 要 么 就 从 来 不 引 。 


4.1.2. 第 量 


在 PostgreSQL 里 有 三 种 隐 含 类 型 的 常量 : 字符 串 、 位 串 、 数 值 。 常 量 也 可 以 声明 为 明确 的 类 
型 ， 这 样 就 可 以 使 用 更 准确 的 表现 形式 以 及 可 以 被 系统 更 有 效 地 义理 。 这 些 将 在 后 面 的 小 节 
描述 。 


4.1.2.1. 字符 串 常 量 


SQL 里 的 一 个 文本 常量 是 用 单 引 号 ( ) 包 围 的 任意 字符 序列 ， 比如 'This is a string' o 
在 这 种 类 型 的 字符 串 常量 里 嵌入 单 引 号 的 标准 兼容 的 做 法 是 敲 入 两 个 连续 的 单 引 号 ， 比 
如 'Dianne''s horse' 。 注 意 : 两 个 连续 的 单 引 号 不 是 双 引 号 ( " )。 


两 个 只 是 通过 至 少 一 个 换行 符 的 空白 分 隔 的 字符 串 常 量 会 被 连接 在 一 起 ， 并 当做 它们 是 写成 
一 个 常量 处 理 。 上 比如 : 


SELECT 'foo' 
"bar'; 


等 效 于 : 


SELECT 'foobar'; 


但 : 


SELECT 'foo' "bar'; 
是 非法 的 语法 。 这 个 怪异 的 行为 是 SQL 声明 的 ，PostgreSQL 遵 循 标准 。 


4.1.2.2. C 风 格 的 逃逸 字符 串 彰 量 


PostgreSQL 还 允许 "逃逸 "字符 串 中 的 内 容 ， 这 是 一 个 PostgreSQL 对 SQL 标准 的 扩展 。 逃 逸 字 
符 串 语法 是 通过 在 字符 串 前 写字 母 E (大 写 或 者 小 写 ) 的 方法 声明 的 。 上 比如 E'foo' 。 ( 当 需 要 
续 行 包含 逃逸 字符 的 字符 串 时 ， 仅 需 要 在 第 一 行 的 开始 引号 前 写 上 E 就 可 以 了 。) 在 逃逸 字 
FER, 通过 一 个 反 斜 枉 (\ ) 开 始 C 风 格 的 反 斜 杠 逃 逸 序列 ， 在 该 逃逸 中 ， 反 斜 杠 与 其 之 后 
字符 的 组 合 代表 一 个 特殊 的 字 节 值 ， 可 参阅 Table 4-1。 


Table 4-1. 反 斜 杠 逃 逸 序列 





反 斜 杠 逃 逸 序列 解释 
退 格 
进 纸 
换行 
NI 回 车 
水 平 制 表 符 
Ya., y So0nt, aa ( too = 0-7) 八进制 字 节 值 
E Me (0-9. 人- ) 十 六 进 制 字 节 人 


NU OO ON UI XOXOXO OE ( <= 0- 9, A- F) 16 或 32 位 十 六 进 制 Unicode 字 符 值 


任何 其 它 跟 在 反 斜 枉 后 面 的 字符 都 当做 文本 看 待 。 因 此 ， 要 在 字符 串 常 量 里 包含 反 斜 枉 ， 则 
写 两 个 反 斜 枉 ( \\ )。 另外 ，PostgreSQL 人 允许 用 一 个 反 斜 杠 来 逃逸 单 引 号 、 ， Rat, BH 
版 本 的 PostgreSQL 将 不 允许 这 么 用 。 所 以 最 好 坚持 使 用 符合 标准 的 … 。 


你 有 必要 为 你 所 创建 的 字 节 序列 (特别 是 在 使 用 八进制 或 十 六 进 制 逃逸 时 ) 编写 有 效 的 服务 
器 字符 集 编码 字符 。 当 服 务 器 编码 是 UTF-8 时 ， 应 该 使 用 Unicode 逃 逸 或 另 一 种 Unicode 远 逸 
语法 (参阅 Section 4.1.2.3) o 〈 后 者 通过 写 出 字 节 来 处 理 UTF-8 字 符 集 ， 这 样 做 是 很 繁琐 
的 ) fe] 


只 有 服务 器 字符 集 是 urs 时 ， 才 会 完全 使 用 Unicode 逃 逸 语法 。 当 使 用 其 他 服务 器 字符 集 


时 ， 只 有 在 ASCII 内 的 (最 多 \uoo7F ) 代码 点 可 以 被 声明 。 4 位 和 8 位 的 数字 形式 可 以 被 用 来 
将 UTF-16 代 理 对 声明 为 大 于 U+FFFF 的 带 有 代码 点 的 字符 ， 尽管 8 位 数字 形式 技术 的 可 用 性 


使 得 这 样 做 没有 必要 。 ( 当 服 务 器 编码 是 ures 时 使 用 代理 对 ， 首先 ， 它 们 结合 成 一 个 单一 
的 代码 点 ， 然 后 再 用 UTF-8 编 码 ) 


Caution 


如 果 配 置 参数 standard_conforming strings 的 值 是 off , 那么 PostgreSQL 将 能 够 识别 常 
规 和 逃逸 字符 串 常 量 中 的 反 斜 杠 逃 逸 。 然而 ， 在 PostgreSQL9.1 中 ， 参 数值 默认 为 on, 
这 意味 着 反 斜 杠 逃 逸 只 能 在 逃逸 字符 串 常 量 中 识别 。 这 个 行为 更 为 标准 兼容 ， 但 是 可 能 
会 使 依赖 于 历史 行为 的 应 用 程序 崩溃 ， 因 为 历史 行为 中 反 斜 杠 逃 逸 总 是 能 被 识别 。 作为 
一 个 变通 方案 ， 你 可 以 设置 这 个 参数 为 off ， 但 是 最 好 是 不 使 用 反 斜 杠 逃 逸 。 如 果 你 需 
要 使 用 反 斜 杠 逃 逸 来 表示 特殊 的 字符 ， 那么 请 在 字符 串 常量 前 加 上 Eo 


除 standard_conforming_strings 之 外 ，escape_string_warning 和 backslash_quote 配 置 参 数 
也 影响 字符 串 常量 中 反 斜 杠 的 处 理 。 | 


编码 为 堆 的 字符 不 允许 出 现在 字符 串 常 量 中 。 


4.1.2.3. Unicode LEFRERE 


PostgreSQL 也 支持 其 他 类 型 的 字符 串 逃 逸 语 法 ， 允许 声明 任意 的 带 有 代码 点 标记 的 Unicode 
字符 。 一 个 逃逸 Unicode 字 符 常 量 以 ve 开始 (大 /小 写 U 后 紧 跟 有 & 符 号 ) 紧 跟 着 打开 的 单 引 
号 ， 之 间 没 有 空格 ， 例 如 u&'foo' 。 (这 可 能 产生 和 操作 符 & 之 间 的 歧义 。 可 以 在 操作 符 
周围 加 上 空格 来 避免 该 问题 。) 在 引号 中 ， 通过 写 一 个 后 面 跟 有 四 位 十 六 进 制 代码 点 或 跟 有 
加 号 和 六 位 十 六 进 制 代码 点 的 反 斜 枉 ， Unicode 字 符 可 以 写成 逃 锡 格式。 例如， 'data' 可 以 
写成 : 


U&'d\0061t\+000061' 


下 例 以 西里 尔 字母 写 俄 文 "slon"” (R) 。 


U&'\0441\043B\043E\043D' 


如 果 需 要 一 个 非 反 斜 杠 的 不 同 的 逃逸 ， 可 以 通过 在 字符 串 之 后 使 用 uEscApPE 语句 来 进行 声 
AA, a: 


U&'d!0061t!+000061' UESCAPE '!' 


逃逸 字符 可 以 是 一 个 十 六 进 制 数字 以 外 的 任何 单个 字符 ， 加 号 ， 一 个 单 引 号 ， 一 个 双 引 号 ， 
或 一 个 空白 字符 。 


只 有 服务 器 字符 集 是 utrF8 时 ， 才 会 完全 使 用 Unicode 逃 逸 语法 。 当 使 用 其 他 服务 器 字符 集 


时 ， 只 有 在 ASCII 内 的 (最 多 \oo7F ) 代码 点 可 以 被 声明 。 4 位 和 6 位 的 数字 形式 可 以 被 用 来 
将 UTF-16 代 理 对 声明 为 大 于 U+FFFF 的 带 有 代码 点 的 字符 ， 尽管 6 位 数字 形式 技术 的 可 用 性 


使 得 这 样 做 没有 必要 。 ( 当 服 务 器 编码 是 ure 时 使 用 代理 对 ， 首先 ， 它 们 结合 成 一 个 单一 
的 代码 点 ， 然 后 再 用 UTF-8 编 码 。) 


同样 ， 字 符 串 常量 的 Unicode 逃 逸 语法 只 有 当 配 置 参 数 standard_conforming_strings 启用 时 才 
能 生效 。 否 则 ， 该 语法 在 解析 SQL 语法 时 给 客户 端 造成 混淆 ， 导 致 SQL 注入 或 其 他 安全 问 
题 。 如 果 该 参数 设 为 OFF， 该 语法 会 带 着 一 条 错误 消息 一 起 被 拒绝 。 


为 了 将 逃逸 字符 写 到 字符 串 中 ， 可 以 将 它 写 两 次 。 


4.1.2.4. 美元 符 引 用 字符 串 弟 量 


尽管 声明 字符 串 常量 的 标准 方法 通常 都 很 方便 ， 但 是 如 果 字 符 串 中 包含 很 多 单 引 号 或 者 反 斜 
杠 ， 那么 理解 字符 串 的 内 容 可 能 就 会 变 得 很 苦涩 ， 因 为 每 个 单 引号 都 要 加 倍 。 为 了 让 这 种 场 
合 下 的 查询 更 具 可 读 性 ，PostgreSQL 人 允许 另外 一 种 称 作 "美元 符 引 用 "的 字符 串 常量 书写 办 
法 。 一 个 通过 美元 符 引 用 声明 的 字符 串 常量 由 一 个 美元 符号 ( $ )、 夫 个 或 多 个 字符 组 成 的 " 标 
签 "、 另 一 个 美元 符号 、 组 成 字符 串 常 量 的 任意 字符 序列 、 一 个 美元 符号 、 与 前 面相 同 的 标 
签 、 一 个 美元 符号 组 成 的 。 比如 ， 下 面 是 两 个 不 同 的 用 美元 符 引 用 的 方法 声明 "Dianne's 
horse" 的 例子 : 


$$Dianne's horse$$ 
$SomeTag$Dianne's horse$SomeTag$ 


请 注意 ， 在 美元 符 引 用 的 字符 串 里 ， 单 引号 不 允许 逃逸 。 实 际 上 ， 在 一 个 美元 符 引 用 的 字符 
PE, 不 允许 逃逸 任何 字符 : 字符 串 内 容 总 是 按照 字面 内 容 书 写 。 反 斜 杠 不 是 特殊 的 、 美元 
符 自己 也 不 是 特殊 的 (除非 它们 和 开标 签 的 一 部 分 匹配 )。 


我 们 可 以 通过 在 不 同 伐 套 级 别 使 用 不 同 的 "标签 "来 实现 伐 套 。 最 常见 的 是 写 函 数 定义 的 时 候 。 
比如 : 


$function$ 
BEGIN 

RETURN ($1 ~ $q$[\t\r\n\v\\]$q$); 
ND; 


$function$ 


这 里 ， 序 列 $qs$[\t\r\n\v\\]$q$ 表示 一 个 美元 符 引 用 的 字符 串 文 本 [\t\r\n\v\\] , 在 函数 体 
被 PostgreSQL 执 行 的 时 候 ， 它 将 被 识别 出 来 。 但 是 因为 这 个 序列 不 匹配 外 层 的 美元 符 引 用 分 
隔 符 $function$ ， 所 以 只 要 考虑 了 外 层 字 符 串 ， 它 就 只 是 常量 里 面 的 普通 字符 而 已 。 


一 个 美元 符 引 用 字符 串 的 标签 (如 果 有 标签 的 话 ), 遵 循 和 无 引号 包围 的 标识 符 相 同 的 规则 ， 只 
是 它 不 能 包含 美元 符 。 标签 是 大 小 写 敏 感 的 ， 因此 $tag$String content$tag$ 是 正确 的 ， 


而 $TAG$string content$tag$ 则 是 错误 的 。 


一 个 后 面 紧 跟着 关键 字 或 者 标识 符 的 美元 符 引 用 字符 串 必 须 用 空白 与 其 后 的 关键 字 或 者 标识 
符 隔 开 ; 否则 美元 符 引 用 分 隔 符 将 会 被 当 作 标 识 符 的 开头 部 分 。 


美元 符 引 用 不 是 SQL 标准 ， 但 是 在 写 复 条 的 字符 串 文 本 的 时 候 ， 它 通常 比 标准 的 单 引 号 语法 
更 方便 。 尤其 是 在 其 它 常量 里 表现 字符 串 常 量 的 时 候 更 有 用 ， 比 如 在 过 程 画 数 定义 里 。 如 果 
用 单 引 号 语法 ， 每 个 上 面 例子 里 的 每 个 反 斜 杠 都 必须 写 四 个 ， 它 们 在 作为 字符 串 文 本 分 析 的 
时 候 会 减少 为 两 个 ， 然后 在 画 数 执行 的 时 候 在 内 层 字符 串 常 量 里 会 再 次 被 解析 为 一 个 。 


4.1.2.5. 位 串 弟 量 


位 串 常量 看 起 来 很 像 在 开 引 号 前 面 有 一 个 s (大 写 或 小 写 ) 的 普通 字符 串 (它们 之 间 没 有 空 
白 )， 比 如 B'1991' 。 位 串 常 量 里 可 以 用 的 字符 只 有 o 和 1 。 


另外 ， 位 串 常量 可 以 用 十 六 进 制 表 示 法 声明 ， 方 法 是 使 用 前 组 x (ERDE), He 
如 x'iFF' ， 其 中 的 每 个 十 六 进 制 位 等 效 于 四 个 二 进 制 位 。 


两 种 形式 的 位 串 常量 都 可 以 像 普 通 字符 串 常量 那样 跨行 连续 。 位 串 常量 不 能 用 美元 符 引 用 。 


4.1.2.6. 数值 前 量 
数值 常量 接受 下 列 通用 的 形式 : 


_digits_ 
digits_.[°_digits_~][e[+-]°_digits_ 
[°_digits_~]._digits_[e[+-]°_digits_ 
digits_e[+-]_ digits 





可 
A 








或 者 其 它 字 符 。 请 注意 任何 前 导 正 号 或 负 号 实际 上 都 不 认为 是 常量 的 一 部 分 ; 它 是 施加 于 常 
量 的 一 个 操作 符 。 


这 里 是 一 些 合法 的 数值 常量 的 例子 : 
42 3.5 4. .001 5e2 1.925e-3 


如 果 一 个 数值 常量 既 不 包含 小 数 点 ， 也 不 包含 指数 ， 那么 如 果 它 的 数值 可 以 放 在 integer 类 
型 中 (32 位 )， 则 认为 它 是 integer 类 型 ; 如 果 它 的 数值 可 以 放 在 bigint 中 (64 位 )， 则 认为 它 
是 bigint, 否则 认为 它 是 numeric 类 型 。 包 含 小 数 点 和 /或 指数 的 常量 总 是 被 认为 是 
numeric 类 型 。 


给 一 个 数值 常量 赋予 初始 数据 类 型 只 是 类 型 解析 算法 的 开端 。 在 大 多 数 情况 下 该 常量 会 根据 
环境 被 自动 强制 转换 成 最 合适 的 类 型 。 必要 时 ， 你 可 以 通过 强制 类 型 转换 把 一 个 数值 解析 成 
特定 的 数据 类 型 。 比如 ， 你 可 以 强制 要 求 把 一 个 数值 当 作 real ( float4 ) 类 型 来 看 ， 方 法 是 
RAF: 


REAL '1.23' -- 字符 串 风格 
1.23::REAL -- PostgreSQL (历史 的 ) 风格 


这 些 实际 上 只 是 下 面 讨 论 的 通用 转换 的 特例 。 


任意 类 型 的 常量 都 可 以 用 下 列表 示 法 中 的 任何 一 种 来 输入 : 


type_ '_string_' 
"_string_'::_type 
CAST ( '_string_' AS _type_ ) 











其 中 字符 串 常 量 的 文本 将 会 被 代 人 到 类 型 _type_ 的 输入 转换 过 程 。 其 结果 是 一 个 该 类 型 的 常 
量 。 如 果 不 存 在 该 常量 所 属 类 型 的 歧义 ， 那 么 可 以 省 略 明 确 的 类 型 转换 (比如 ， 当 你 把 它 直 接 
赋予 一 个 表 字段 的 时 候 )， 这 种 情况 下 它 会 自动 转换 。 


其 中 的 字符 串 常 量 可 以 用 普通 SQL 表示 法 或 者 美元 符 引 用 来 书写 。 
我 们 还 可 以 用 男 数 风格 的 语法 来 声明 类 型 转换 : 


_typename_ ( '_string_' ) 


不 过 并 非 所 有 类 型 名 都 可 以 这 样 使 用 ; 参阅 Section 4.2.9 获 取 细 节 。 


:: ， CAST() 和 图 数 调 用 语法 也 可 以 用 于 声明 任意 表达 式 的 运行 时 类 型 转换 (如 Section 4.2.9 
中 讨论 的 那样 )。 为 了 避免 语法 歧义 ， _type_ ' _string “的 形式 只 能 用 于 声明 一 个 简单 的 字 
面 常 量 的 类 型 。 _type '_string_' 的 另外 一 个 限制 是 它 不 能 用 于 数组 类 型 (要 用 :: 或 
cast() 声明 一 个 数组 常量 的 类 型 )。 








cAsT( ) 语法 遵循 SQL 标准 。 _type ' _string_ ' 语 法 是 标准 的 一 个 推广 : SQL 只 是 给 少数 
几 种 数据 类 型 声明 了 这 个 语法 ， 但 PostgreSQL 人 允许 将 其 用 于 所 有 类 型 。 :: MHRA 
法 是 PostgreSQL 的 历史 用 法 。 


4.1.3. 操作 符 


一 个 操作 符 是 最 多 NAMEDATALEN -1 个 ( 缺 省 63 个 ) 下 列 字 符 的 序列 : 





sm/<>=~!l@#%^&| ? 
不 过 ， 有 几 个 限制 : 
。 -- 和 /* 不 能 出 现在 操作 符 中 的 任何 地 方 ， 因 为 它们 会 被 当做 注释 开始 对 待 。 
© 多 字符 操作 符 不 能 以 + 或 - 结束 ， 除 非 其 中 至 少 还 包含 下 列 操作 符 之 一 : 


~!@#%*&|°? 


比如 ， @- 是 允许 的 操作 符 ， 但 *- 不 是 。 这 个 限制 允许 PostgreSQL 在 不 要 求 记 号 之 间 
有 空白 的 情况 下 分 析 SQL 兼容 的 查询 。 


当 你 使 用 非 SQL 标准 的 操作 符 的 时 候 ， 你 通常 需要 用 空白 分 隔 相 邻 的 操作 符 以 避免 歧义 。 比 
如 ， 如 果 你 定义 了 一 个 叫 @ 的 左 单 目 操作 符 ， 那 么 你 就 不 能 写成 xao ; 而 是 要 写 
成 x @Y 以 确保 PostgreSQL 把 它 读 成 两 个 操作 符 ， 而 不 是 一 个 。 


4.1.4. 特殊 字符 


有 些 非 字 母 数 字 字 符 有 一 些 特殊 含义 ， 因 此 不 能 用 做 操作 符 。 它们 的 用 法 细节 可 以 在 相应 的 
描述 语法 元 素 的 地 方 找 到 。 本 节 只 是 描述 它们 的 存在 和 概括 一 下 这 些 字符 的 目的 。 


。 美元 符号 ( $ ) 后 面 跟着 数字 用 于 在 一 个 事 数 体 定义 或 者 预备 语句 中 表示 参数 的 位 置 。 在 
其 它 环境 里 美元 符号 可 能 是 一 个 标识 符 名 字 或 者 是 一 个 美元 符 引 用 的 字符 串 常 量 的 一 部 
分 。 


。 AHI O ) 用 于 分 组 和 强制 优先 级 的 时 候 含义 与 平常 一 样 。 有 些 场 合 里 圆 括 弧 是 作为 一 
个 特定 SQL 命令 的 固定 语法 的 一 部 分 要 求 的 。 


。 HAN [] ) 用 于 选取 数组 元 素 。 参 阅 Section 8.15 获 取 更 多 信息 。 
。 到 号 ( ，) 在 一 些 语法 构造 里 用 于 分 隔 一 个 列表 的 元 素 。 


。 分 号 ( ; ) 结 束 一 条 SQL 命令 。 它 不 能 出 现在 一 条 命令 里 的 任何 地 方 ， 除了 在 引号 包围 的 
字符 串 常 量 或 者 标识 符 中 。 


。 冒号 ( : ) 用 于 从 数组 中 选取 "片段 "( 参 阅 Section 8.15)。 在 一 些 SQLASH (LM RA 
SQL)， 冒 号 用 于 前 级 变量 名 。 


。 星 号 ( * ) 在 某 些 环境 里 表示 一 个 表 的 全 部 字段 或 者 一 个 复合 类 型 的 值 。 在 用 作 聚 集 事 数 
的 参数 时 还 表示 该 聚集 并 不 需要 明确 的 参数 。 


。 句点 ( . ) 用 在 数字 常量 里 ， 并 用 于 分 隔 模式 、 表 、 字 段 名 。 


4.1.5. 注释 
注释 是 任意 以 双 划 线 开头 并 延伸 到 行 尾 的 任意 字符 序列 ， 比 如 : 


- 这 是 标准 的 SQL 注释 


另外 ， 还 可 以 使 用 C 风 格 的 块 注释 : 


/* 多 行 注释 
* JURE: /* 被 柑 套 的 块 注释 */ 
2 


这 里 注释 以 /* 开头 并 扩展 到 对 应 的 */ 。 REIRME, WR SQL 标准 里 说 的 那样 
(但 和 C 不 一 样 )， 因此 我 们 可 以 注释 掉 一 大 块 已 经 包含 块 注释 的 代码 。 


注释 在 进一步 的 语法 分 析 之 前 被 从 输入 流 中 删除 并 用 空白 代替 。 


4.1.6. 操作 符 优 先 级 


Table 4-2 显 示 了 PostgreSQL 里 面 的 操作 符 的 优先 级 和 关联 性 。 大 多 数 操作 符 都 有 相同 的 优先 
级 并 且 都 是 左 关联 的 。 操作 符 的 优先 级 和 关联 性 是 硬 连接 到 解析 器 的 。 这 种 情况 可 能 会 有 不 
那么 直观 的 行为 ; 比如 ， 布 尔 操作 符 ait; 和 egt; 与 布尔 操作 符 &lt;= 和 &gt;= 之 间 有 着 
不 同 的 优先 级 。 同 样 ， 当 你 把 双 目 和 单 目 操 作 符 组 合 使 用 的 时 候 ， 有 时 候 也 需要 加 圆 括 弧 。 
比如 : 


SELECT 5 ! - 6; 


会 被 分 析 成 : 


SELECT 5 ! (- 6); 


因为 解析 器 不 知道 ! 被 定义 成 了 后 级 操作 符 ， 而 不 是 中 绥 操 作 符 (知道 的 时 候 只 能 是 太 晚 
了 )。 要 在 本 例 中 获得 你 需要 的 特性 ， 你 要 写成 : 


SELECT (5 !) - 6; 


这 是 我 们 为 扩展 性 付出 的 代价 。 


Table 4-2. 操作 符 优 先 级 (递减 ) 


操作 符 / 元 素 关联 性 描述 
左 表 / 字 段 名 分 隔 符 
到 PostgreSQL 特 有 的 类 型 转换 

操作 符 

加 到 Æ 数组 元 素 选 择 

2 A 单 目 正 号 ， 单 目 负 号 

A + g 

I % 左 乘 ， 除 ， 模 

+ 左 Mn, A 

= Sai ce a 

ee 测试 是 否 为 NULL 

ReneS 测试 是 否 不 为 NULL 

(任何 其 他 的 ) 元 人 

IN 集合 成 员 

BETWEEN 范围 包含 

DUEREARS 时 间 间 陋 重 得 

Sie 字符 串 模 式 匹 配 

&lt; &gt; SP ee 

z A 等 于 ， 赋 值 

右 逻辑 非 

Aw 左 2H 

OR 左 逻辑 或 


请 注意 操作 符 优先 级 也 适用 于 和 上 面 提 到 的 内 置 操作 符 同名 的 用 户 定义 操作 符 。 比如 ， 如 果 
你 为 一 些 客户 数据 类 型 定义 一 个 "+" 操 作 符 ， 那么 它 和 内 置 的 "+" 操 作 符 有 同样 的 优先 级 ， 不 管 
用 它 来 干什么 。 


如 果 在 operator 语法 里 使 用 了 模式 修饰 的 操作 符 名 ， 比 如 : 


SELECT 3 OPERATOR(pg_catalog.+) 4; 


那么 operator 构造 就 会 有 Table 4-2 里 面 为 "任何 其 它 的 " 操作 符 显示 的 缺 省 优先 级 。 不 管 什么 
特定 的 操作 符 出 现在 opERATOR() 里 都 是 这 样 。 


4.2. ARZA 


值 表 达 式 用 在 各 种 语法 环境 中 ， 上 比如 在 sect 命令 的 目标 列表 中 ， 在 INSERT 或 UPDATE 中 
用 作 新 的 列 值 ， 或 者 在 许多 命令 的 搜索 条 件 中 使 用 。 我 们 有 时 候 把 值 表 达 式 的 结果 叫做 标 

=, 以 便 与 一 个 表 表 达 式 的 结果 相 区 别 (是 一 个 表 )。 因 此 值 表达 式 也 叫做 标量 表达 式 ( 或 简称 
表达 式 )。 表达 式 语 法 允许 对 来 自 基本 部 分 的 数值 进行 算术 、 逮 辑 、 集 合 、 和 其 它 运算 。 


值 表 达 式 是 下 列 内 容 之 一 : 

。 一 个 常量 或 者 字面 值 

。 一 个 字段 引用 

。 一 个 位 置 参 数 引 用 (在 范 数 声明 体 中 或 预 编写 的 语句 中 ) 
。 一 个 下 标 表 达 式 

。 一 个 字段 选择 表达 式 

一 个 操作 符 调 用 

。 一 个 画 数 调用 

一 个 聚集 表达 式 


。 一 个 窗口 本 数 调用 

。 一 个 类 型 转换 

。 一 个 排序 规则 表达 式 

。 一 个 标量 子 查询 

。 一 个 数组 构造 器 

。 一 个 行 构造 器 

。 一 个 在 圆 括 弧 里 面 的 值 表达 式 (可 用 于 子 表 达 式 分 组 和 履 盖 优先 级 )。 


除了 这 个 列表 以 外 ， 还 有 许多 构造 可 以 兴 类 为 表达 式 ， 但 是 不 遵循 任何 通用 的 语法 规则 。 它 
们 通常 有 画 数 或 操作 符 的 语义 ， 并 且 在 Chapter 9 里 合适 的 位 置 描述 。 一 个 例子 是 Is NuLL 子 
句 。 


我 们 已 经 在 Section 4.1.2 里 讨论 过 常量 了 。 下 面 的 节 讨 论 剩 下 的 选项 。 


4.2.1. 字段 引用 


一 个 字段 可 以 用 下 面 的 形式 引用 : 


_correlation_._columnname_ 


_correlation. 是 一 个 表 的 名 字 ( 可 能 有 模式 修饰 )， 或 者 是 用 FRoM 子 句 这 样 的 方法 定义 的 表 
的 别名 。 如 果 在 当前 查询 所 使 用 的 所 有 表 中 ， 该 字段 名 字 是 唯一 的 ， 那么 这 个 相关 名 字 
(correlation) 和 分 隔 用 的 点 就 可 以 省 略 (参见 Chapter 7)。 


4.2.2. 位 置 参 数 


位 置 参 数 引用 用 于 标识 从 外 部 给 SQL 语句 的 参数 。 参 数 用 于 SQL 男 数 定义 语句 和 预 编写 的 
查询 。 有 些 客户 端 库 还 支持 在 SQL 命令 字符 串 外 边 声明 数据 值 ， 这 种 情况 下 参数 用 于 引用 
SQL 字符 串 行 外 的 数据 。 一 个 参数 的 形式 如 下 : 


$_number_ 


比如 下 面 这 个 dept RAVES : 


CREATE FUNCTION dept(text) RETURNS dept 
AS $$ SELECT * FROM dept WHERE name = $1 $$ 
LANGUAGE SQL; 


Fe PR AR a FAY at ek BAY $1 将 引用 第 一 个 参数 。 


4.2.3. 下 标 


如 果 一 个 表达 式 生 成 一 个 数组 类 型 的 数值 ， 那么 我 们 可 以 通过 下 面 这 样 的 表达 式 来 提取 数组 
中 的 元 素 


_expression_[_subscript_] 


或 者 如 果 是 多 个 相 邻 的 元 素 (" 数 组 片断 ") 可 以 用 下 面 的 方法 抽取 


_expression_[_lower_subscript_:_upper_subscript_] 


(这 里 的 方 括号 [ ] 按照 字面 文本 的 方式 出 现 。 ) 每 个 _subscript_ 自己 都 是 一 个 表达 式 ， 它 
必须 生成 一 个 整数 值 。 


通常 ， 数 组 _expression 必须 用 圆 括 红包 围 ， 但 如 果 只 是 一 个 字段 引用 或 者 一 个 位 置 参 数 ， 
那么 圆 括 弧 可 以 省 略 。 同 样 ， 如 果 源 数组 是 多 维 的 ， 那 么 多 个 下 标 可 以 连接 在 一 起 。 上 比如 : 


mytable.arraycolumn[4] 
mytable.two_d_column[17][34] 
$1[10:42] 
(arrayfunction(a,b))[42] 


最 后 一 个 例子 里 的 圆 括 弧 是 必须 的 。 参 阅 Section 8.15 获 取 有 关 数 组 的 更 多 信息 。 


4.2.4. 字段 选择 
如 果 一 个 表达 式 生成 一 个 复合 类 型 ( 行 类 型 )， 那 么 用 下 面 的 方法 可 以 抽取 一 个 指定 的 字段 


_expression_._fieldname_ 


通常 ， 行 _expression. 必须 用 圆 括 弧 包围 ， 但 是 如 果 要 选取 的 表达 式 只 是 一 个 表 引 用 或 者 位 
置 参 数 ， 可 以 省 略 圆 括 弧 。 上 比如 : 


mytable.mycolumn 
$1.somecolumn 
(rowfunction(a,b)).col3 


因此 ， 一 个 全 称 的 字段 引用 实际 上 只 是 一 个 字段 选择 语法 的 特例 。 一 个 重要 的 特殊 情形 是 提 
取 的 表 列 是 一 个 复合 型 的 字段 : 


(compositecol) .somefield 
(mytable.compositecol).somefield 


在 这 里 ， 括 号 是 必须 的 ， 用 来 指出 compositecol 是 列 名 而 不 是 表 名 ， mytable 是 表 名 而 不 是 
模式 名 。 


在 一 个 选择 列表 中 (查看 Section 7.3) ， 你 可 以 通过 使 用 .* 来 要 求 所 有 的 组 合 值 字段 。 


(compositecol).* 


4.2.5. 操作 符 调 用 
操作 符 调 用 有 三 种 语法 : 


_expression_ _operator_ _expression_ ( 双 目 中 级 操作 符 ) 
_operator_ _expression_ ( 单 目前 级 操作 符 ) 


_expression_ _operator_ (#% H 后 级 操作 符 ) 


这 里 的 _operator_ 记号 遵循 Section 4.1.3 的 语法 规则 ， 或 者 是 记号 AND, OR, NOT 之 一 。 
或 者 是 一 个 被 修饰 的 操作 符 名 : 


OPERATOR(_schema_._operatorname_) 


具体 存在 哪个 操作 符 以 及 它们 是 单 目 还 是 双 目 取决 于 系统 或 用 户 定 义 了 什么 操作 符 。 Chapter 
9 描述 了 内 置 的 操作 符 。 


4.2.6. KAGE A 
函数 调用 的 语法 是 合法 函数 名 (可 能 有 模式 名 修饰 )， 后 面 跟 着 包含 参数 列表 的 圆 括 弧 : 


_function_name_ ([°_expression_~ [, ~_expression_~ ... ]] ) 


比如 ， 下 面 的 代码 计算 2 的 平方 根 : 


sqrt(2) 


Am eae WREChapter 92, HERA hA Pw. 
选 的 可 附加 名 字 的 参数 ， 详 细 请 参阅 Section 4.3, 





Note: 一 个 接受 一 个 复合 类 型 参数 的 函数 ， 可 以 使 用 字段 选择 语法 调用 ， 相 反 的 ， 字段 
有 也 就 是 说 ， 符 号 col(table) 和 table.col 是 可 以 互 换 
的 。 这 个 行为 不 是 SQL 标准 ， 但 是 由 PostgreSQL 提 供 ， 因 为 它 允 许 函 数 使 用 仿真 "计算 
域 "。 获取 更 多 信息 ， 请 参阅 Section 35.4.3。 


4.2.7. 聚集 表达 式 


一 个 聚集 表达 式 代表 一 个 聚集 本 数 对 查询 选 出 的 行 的 外 理 。 一 个 聚集 本 数 把 多 个 输入 缩减 为 
一 个 输出 值 ， 比 如 给 Pees 一 个 聚集 表达 式 的 语法 是 下 列 之 一 : 


_aggregate_name_ (_expression_[, ... ] [ _order_by_clause_ ] ) 
_aggregate_name_ (ALL _expression_[, ... ] [ _order_by_clause_ ] ) 
_aggregate_name_ (DISTINCT _expression_ [, ... ] [ _order_by_clause_ ] ) 
_aggregate_name_ ( * ) 











这 里 的 _aggregate_name” 是 前 面 定义 的 聚集 (可 能 是 带 有 模式 的 全 称 )， 而 expression 是 一 
个 本 身 不 包含 聚集 表达 式 或 一 个 窗口 本 数 调用 的 任意 值 表达 式 。 
order_by_clause_ 是 ORDER BY 子 句 的 一 个 选项 ， 下 面 会 有 描述 。 





第 一 种 形式 的 聚集 表达 式 为 每 个 输入 行 调 用 聚集 。 第 二 种 形式 与 第 一 种 等 价 (因为 ALL 是 缺 省 
值 )。 第 三 种 形式 为 每 个 表达 式 中 不 同 的 值 调用 聚集 《或 者 为 多 个 表达 式 不 同 的 值 的 集合 ) 。 
最 后 一 种 形式 为 每 个 输入 行 调用 一 次 聚集 ， 因 为 没有 声明 特定 的 输入 值 ， 通常 它 只 用 

于 count(*) 2 BRE ER, 


KS AHR H eee NULL N 因此 在 一 个 或 多 个 表达 式 中 产生 NULL 的 行 会 被 丢弃 。 
对 所 有 的 内 置 聚 集 事 数 而 言 ， 这 样 做 是 可 以 的 ， 除 非 另 行 说 明 。 


比如 ， count(*) 生成 输入 行 的 总 数 ; count(f1) 生成 fa AA NULL 的 输入 行 数 ， 
为 count 忽略 NULL ; count(distinct f1) 生成 fa 唯一 且 非 NULL 的 行 数 。 


一 般 情况 下 ， 输 入 行 会 以 非特 定 顺 序 放 入 到 聚集 函数 中 。 在 许多 情况 下 ， 这 样 做 是 没有 影响 
的 ; 如 ， 无 论 以 什么 顺序 输入 ， min 输 出 相同 的 结果 。 然而 ， ERRAZ (如 array_agg 
和 string_agg ) 并 非 如 此 。 BARR Ra, ALARA _order_pby_clause 选项 指定 输 
入 的 顺序 。 除了 它 的 表达 式 仅 仅 只 是 表达 式 ， 并 且 不 能 输出 列 名 或 列 数 之 

外 ， order_by_clause ”与 ORDER BY 查询 子 句 有 相同 的 语法 结构 ， 在 Section 7.5 中 有 描述 ， 

如 : 








SELECT array_agg(a ORDER BY b DESC) FROM table; 


在 处 理 多 参数 聚集 画 数 时 需要 注意 ， oRDER BY FUSZEMANMREWMSAZEA, Mx 
写 : 


SELECT string_agg(a, ',' ORDER BY a) FROM table; 
而 不 是 : 
SELECT string_agg(a ORDER BY a, ',') FROM table; -- incorrect 


后 者 在 语法 上 是 有 效 的 ， 但 它 表 示 的 是 ， 有 两 个 oRDER BY 关键 字 的 单 参数 的 聚集 画 数 的 调用 
(第 二 个 是 无 用 的 ， 因为 它 是 一 个 常量 ) 。 


如 果 _order_by_clause_ 中 声明 了 pIsTINCT ， 那么 所 有 的 oRDER BY 表达 式 必 须 匹 配 规 则 的 聚 
集 参数 ， 也 就 是 说 ， 不 能 对 没有 包含 在 pistINcT 列表 中 的 表达 式 进行 排序 。 





Note: 同时 在 一 个 聚集 了 事 数 中 声明 DISTINCT 和 oRDER BY 是 PostgreSQL 的 一 个 扩展 。 
FE LARS WME Section 9.20 里 描述 。 其 它 聚 集 男 数 可 以 由 用 户 增 加 。 


一 个 聚集 表达 式 只 能 在 seLEcT 命令 的 结果 列表 或 者 HAVING 子 句 里 出 现 。 禁止 在 其 它 子 句 里 
出 现 (比如 wer 子 句 )， 因 为 这 些 子 句 逻辑 上 在 生成 聚集 结果 之 前 计算 。 


如 果 一 个 聚集 表达 式 出 现在 一 个 子 查询 里 (参阅 Section 4.2.11 Section 9.22)， 聚 集 通常 是 在 
ey 但 是 如 果 聚 集 的 参数 只 包含 外 层 查 询 的 变量 则 例外 : 这 个 聚集 会 属于 高 

他 最 近 的 外 层 查 询 ， 并 且 在 该 查询 上 进行 计算 。 该 聚集 表达 式 整 体 上 属于 它 出 现 的 子 查询 对 

外 层 查 询 的 引用 ， 其 作用 相当 于 子 查 询 每 一 次 计算 中 的 一 个 常量 。 前 述 限制 (聚集 表达 式 只 能 
出 现在 结果 列 或 者 HAvIN6 子 句 中 ) 只 适用 于 聚集 所 属 的 查询 层 。 


4.2.8. 窗口 调用 函数 


通过 查询 第 选 出 的 行 的 某 些 部 分 ， 窗 口 调用 函数 实现 了 类 似 于 聚集 男 数 的 功能 。 不 同 的 是 ， 
窗口 调用 函数 不 需要 将 查询 结果 打包 成 一 行 输出 一 在 查询 输出 中 ， 每 一 行 都 是 分 开 的 。 然 
而 ， 窗 口 调用 函数 可 以 打 描 所 有 的 行 ， 根 据 窗口 调用 函数 的 分 组 规范 ( PARTITION BY 列 )， 这 
些 行 可 能 会 是 当前 行 所 在 组 的 一 部 分 。 一 个 窗口 调用 画 数 的 语法 是 下 列 之 一 : 


_function_name 
_function_name 
_function_name 
_function_name 


_expression_~ [, ~_expression_~ ]]) OVER ( _window_definition_ ) 
_expression_~ [, ~_expression_~ ... ]]) OVER _window_name_ 

* ) OVER ( _window_definition_ ) 

* ) OVER _window_name_ 


ze 
l 
Z 
a 


这 里 的 _window definition 具有 如 下 语法 : 


[ _existing_window_name_ ] 

[ PARTITION BY _expression_ [, ...] ] 

[ ORDER BY _expression_ [ ASC | DESC | USING _operator_ ] [ NULLS { FIRST | LAST } ] [, . 
[ _frame_clause_ ] 


OSS a 








选项 _frame_clause_ 可 以 是 : 





[ RANGE | ROWS ] _frame_start_ 
[ RANGE | ROWS ] BETWEEN _frame_start_ AND _frame_end 





frame_start 和 frame_end 可 以 是 : 





UNBOUNDED PRECEDING 
_value_ PRECEDING 
CURRENT ROW 
_value_ FOLLOWING 
UNBOUNDED FOLLOWING 


在 这 里 ， _expression ”表示 的 是 任何 自己 不 含 窗口 调用 函数 的 值 表达 式 。 


_window_name” ”引用 的 是 查询 语句 中 wINDow 子 句 定义 的 命名 窗口 规范 。 命 名 窗口 规范 通常 只 
是 用 ovER _window_name ”来 引用 ， 但 它 也 可 以 在 括号 里 写 一 个 窗口 名 ， 并 且 可 以 有 选择 的 
使 用 排序 和 /或 框架 (frame) FA (如 果 应 用 这 些 子 句 的 话 ， 那 么 被 引用 的 窗口 必须 不 能 


些 子 句 ) 。 后 者 语法 遵循 相同 的 规则 (修改 wio 子 句 中 已 有 的 窗口 名 ) 。 BMSELECT 
查看 更 多 资料 。 


PARTITION BY 选项 将 查询 的 行 分 为 一 组 进入 partitions， 这 些 行 在 窗口 函数 中 单独 处 

理 。 PARTITION BY 和 查询 级 别 GROUP BY 子 句 做 相似 的 工作 ， 除 了 它 的 表达 式 只 能 作为 表达 

式 不 能 作为 输出 列 的 名 字 或 数 。 没有 partition BY ， 所 有 由 查询 产生 的 行 被 视 为 一 个 单独 的 
分 区 。 ORDER BY 选项 决定 分 区 中 的 行 被 窗口 本 数 外 理 的 顺序 。 它 和 查询 级 别 ORDER BY 子 句 

做 相似 的 工作 ， 但 是 同样 的 它 不 能 作为 输出 列 的 名 字 或 数 。 没 有 oRDER BY ， 行 以 一 个 不 被 预 
知 的 顺序 处 理 。 


对 这 些 窗口 函数 (在 这 个 框架 而 不 是 整个 分 区 上 的 ) 7 frame_clause 指定 构成 window 
frame 的 行 ， 他们 是 当前 分 区 的 一 个 子 集 。 框 架 可 以 用 Rance 或 Rows 模式 声明 ; 不 管 哪 种 
情况 ， 它 的 变化 范围 是 从 frame_start 到 frame_end_ o 如 果 省 略 了 _frame_end_ 默认 


WA CURRENT ROW o 








一 个 _frame_start_ 的 UNBOUNDED PRECEDING 意味 着 框架 从 分 区 中 的 第 一 行 开始 ， 相似 的 ， 一 
个 _frame_end_ 的 UNBOUNDED FOLLOWING 意味 着 框架 从 分 区 中 的 最 后 一 行 结 


在 RANGE 模式 中 ， _frame_start_ AY CURRENT Row 意味 着 框架 从 当前 行 的 第 一 个 pee/ 行 开始 
( oRDER BY 认为 等 于 当前 行 的 行 ) ， 而 _frame_end_ 的 cuRRENT Row 意味 着 框架 从 最 后 一 个 
同等 的 行 结束 。 在 Rows 模式 中 ， current Row 简单 的 意味 着 当前 行 。 


_value PRECEDING 和 _value ”FoLLowING 当前 只 人 允许 Rows 模式 。 这 也 就 意味 着 ， 框 架 从 
当前 行 之 前 或 之 后 指定 的 行 数 启动 或 结束 。 _value_ 必须 是 整 型 表达 式 ， 而 不 能 包含 变量 ， 
聚集 函数 ， 或 者 窗口 函数 。 该 值 不 能 为 空 或 负 ， 但 可 以 是 需 ， 表 示 只 选择 当前 行 本 身 。 


默认 的 框架 选项 是 RANGE UNBOUNDED PRECEDING ， 该 选项 与 

RANGE BETWEEN UNBOUNDED PRECEDING AND CURRENT ROW 相同 。 有 ORDER BY, 它 设置 框架 从 分 区 
的 开始 一 直到 与 当前 行 相同 的 最 后 一 行 。 没 有 oRDER BY ， 那么 就 是 当前 分 区 的 所 有 行 都 包含 
在 框架 中 ， 因 为 所 有 行 都 会 成 为 当前 行 的 相同 行 。 


限制 条 件 是 _frame_start_ 不 能 为 UNBOUNDED FOLLOWING, _frame_end 不 能 
为 UNBOUNDED PRECEDING ， 并 且 _frame_end ”选项 不 能 在 上 面 的 列表 中 出 现 的 
比 _frame_start 选项 早 一 例如 RANGE BETWEEN CURRENT ROW AND _value PRECEDING 是 不 


被 允许 的 。 


Ame OmMt lable 9-48 中 有 描述 。 其 他 窗口 西数 ， 用 户 可 以 自己 添加 。 同 桩 ， 任 意 内 置 
BY FAP BE LARSEN SN BY LA Ta) Be FE HW 


使 用 * HZKOIDARAATERWREWMA BOW, A 
count(*) OVER (PARTITION BY x ORDER BY y) 。 星 号 ( * )JBRRAFIERRHHAOWM, Sik 
HAREM, RREBOBMARAENASBAIH DISTINCT 或 ORDER BY o 


窗口 调用 函数 只 能 在 seLEcT 列 ， 或 者 查询 的 oRDER BY 子 句 中 使 用 。 


更 多 关于 窗口 函数 的 信息 可 以 参考 : Section 3.5, Section 9.21, Section 7.2.4. 


4.2.9. 类 型 转换 


一 个 类 型 转换 声明 一 个 从 一 种 数据 类 型 到 另外 一 种 数据 类 型 的 转换 。 PostgreSQL 接 受 两 种 等 
效 的 类 型 转换 语法 : 


CAST ( _expression_ AS _type_ ) 
_expression_::_type_ 


cast 语法 遵循 SQL 标准 ; :: 语法 是 PostgreSQL 万 史 用 法 。 


如 果 对 一 个 已 知 类 型 的 值 表达 式 应 用 转换 ， 它 代表 一 个 运行 时 类 型 转换 。 只 有 在 已 经 定义 了 
合适 的 类 型 转换 操作 的 情况 下 ， 该 转换 才能 成 功 。 请 注意 这 一 点 和 用 于 常量 的 转换 略 有 区 别 
(如 Section 4.1.2.7 所 示 )。 一 个 应 用 于 字符 串 文 本 的 转换 表示 给 该 字符 串 文 本 的 常数 值 赋 予 一 
个 初始 类 型 ， 因此 它 对 于 任何 类 型 都 会 成 功 (如 果 字 符 串 文本 的 内 容 符合 该 数据 类 型 的 输入 语 
法 )。 


如 果 一 个 值 表 达 式 的 值 对 某 类 型 而 言 不 存在 混淆 的 情况 ， 那 么 我 们 可 以 省 略 明确 的 类 型 转换 
(比如 ， 在 给 一 个 表 字 段 赋值 的 时 候 )， Oe ae 不 过 ， 自动 转换 只 适用 
于 那些 系统 表 中 标记 着 "OK to apply implicitly" 的 转换 函数 。 其 它 转换 函数 必须 用 明确 的 转换 
语法 调用 。 这 些 限 制 是 为 了 避免 一 些 怪异 的 转换 被 自动 的 应 用 。 


我 们 也 可 以 用 男 数 风 格 的 语法 声明 一 个 类 型 转换 : 


_typename_ ( _expression_ ) 


Fit, ADHARA FAE EZA HEAMBMAN SH. Leg, 

double precision TAB EAH, 但 是 等 效 的 floats 可 以 。 同 

样 ， interval ， time 和 timestamp 如 果 加 了 双 引 号 也 只 能 这 么 用 ， 因 为 存在 语法 冲突 。 
此 ， 画 数 风格 的 类 型 转换 会 导致 不 一 致 ， 所 以 应 该 避免 这 么 使 用 。 





Note: 辑 数 风格 语法 实际 上 就 是 一 个 画 数 调用 。 如 果 使 用 两 种 标准 转换 语法 做 运行 时 转 
换 ， 那么 它 将 在 内 部 调用 一 个 已 注册 的 函数 执行 转换 。 通 常 ， 这 种 转换 画 数 和 它们 的 输 
出 类 型 同名 ， 只 不 过 是 直接 调用 底层 转换 函数 。 但 是 可 以 移植 的 程 
序 不 能 依赖 这 一 点 。 详 情 请 参阅 CREATE CAST. 





4.2.10. 排序 规则 表达 式 
COLLATE 子 句 重 守 了 表达 式 的 排序 规则 。 它 附加 到 要 应 用 的 表达 式 上 : 


_expr_ COLLATE _collation_ 


这 里 的 collation, 是 一 个 可 能 的 模式 限定 标识 符 。 coLLATE 子 句 绑 定 得 比 操作 符 更 紧密 ; 
需要 时 可 以 用 括号 。 


如 果 没 有 明确 声明 排序 规则 ， 数 据 库 系统 要 么 从 表达 式 中 的 列 获 取 一 个 排序 规则 ， 要 么 如 果 
表达 式 中 没有 包含 列 ， 使 用 数据 库 的 默认 排序 规则 。 


COLLATE 子 句 的 两 个 常见 的 使 用 是 重 写 oRDER BY 子 句 里 的 排序 次 序 ， 例如 : 


SELECT a, b, c FROM tbl WHERE ... ORDER BY a COLLATE "C"; 


AS tT 2 RE RY Sh ie SBOE A, BAO : 


SELECT * FROM tbl WHERE a > 'foo' COLLATE "C"; 


请 注意 ， 在 后 面 一 种 情况 下 ， couar 子 句 附加 到 我 们 希望 作用 的 运算 符 的 输入 参数 。 
coate 子 句 附 加 到 运算 符 或 者 调用 男 数 的 哪个 参数 不 重要 ， 因为 运算 符 或 者 函数 的 排序 规 
则 是 考虑 所 有 参数 得 到 的 ， 并 且 一 个 明确 的 coLLATE 子 句 将 重 守 所 有 其 他 参数 的 排序 规则 。 
(附加 不 匹配 的 corae 子 句 到 多 个 参数 ， 是 一 个 错误 。 更 多 详细 信息 请 参阅 Section 
22.2。) 因此 ， 下 面 的 例子 给 出 前 一 个 例子 相同 的 结果 : 


SELECT * FROM tbl WHERE a COLLATE "C" > 'foo'; 


但 是 这 样 做 是 错误 的 : 


SELECT * FROM tbl WHERE (a > 'foo') COLLATE "C"; 


因为 它 党 试 应 用 一 个 排序 规则 到 sgt; 运算 符 的 结果 ， 而 这 个 结果 是 非 排序 规则 类 
型 boolean 。 


4.2.11. 标量 子 查询 


一 个 标量 子 查询 是 一 个 放 在 圆 括 弧 里 只 返回 一 行 一 列 的 普通 seLEcT 查询 (参阅 Chapter 7 获取 
有 关 书 写 查 询 的 信息 )。 该 SELECT 将 被 执行 ， 而 其 返回 值 将 在 周围 的 值 表达 式 中 使 用 。 把 一 
个 返回 超过 一 行 或 者 超过 一 列 的 查询 用 做 标量 查询 是 错误 的 。 (不 过 ， 在 一 个 特定 的 表达 式 
中 ， 子 查询 不 返回 行 则 不 算 错 误 ; 标量 结果 被 认为 是 NULL)。 子 查询 可 以 引用 外 围 查询 的 变 
量 ， 这 些 变 量 在 每 次 子 查询 中 当做 常量 使 用 。 参见 Section 9.22 以 获取 其 它 包 含 子 查询 的 表达 
式 。 


比如 ， 下 面 的 查询 找 出 每 个 州 中 的 最 大 人 口 数量 的 城市 : 


SELECT name, (SELECT max(pop) FROM cities WHERE cities.state = states.name) 
FROM states; 


4.2.12. 数组 构造 器 


一 个 数组 构造 器 是 一 个 表达 式 ， 它 从 自身 成 员 元 素 上 构造 一 个 数组 值 。 一 个 简单 的 数组 构造 
器 由 关键 字 ARRAY 、 一 个 左 方 括 弧 [ 、 一 个 或 多 个 表示 数组 元 素 值 的 表达 式 (用 逗号 分 隔 )、 
DAAH] 组 成 。 上 比如 : 


SELECT ARRAY[1,2,3+4]; 
array 


默认 的 ， 数 组 元 素 类 型 是 成 员 表 达 式 的 公共 类 型 ， 使 用 和 unton 或 case 构造 一 样 的 规则 决 
定 (参阅 Section 10.5)。 你 可 以 通过 明确 地 转换 数组 构造 器 为 想 要 的 类 型 来 重 写 这 个 规则 ， 例 
如 : 


SELECT ARRAY[1,2,22.7]::integer[]; 
array 


{1,2,23} 
(1 row) 


这 和 单独 构造 每 个 表达 式 为 数组 元 素 类 型 有 相同 的 效果 。 关 于 构造 的 更 多 信息 ， 请 参 
# Section 4.2.9。 


2 ye Mon (6 A Lt PREM Mise ARE, AB Ais PAY array 关键 字 可 以 省 
略 。 比 如 ， 下 面 的 两 句 生成 同样 的 结果 : 


SELECT ARRAY[ARRAY[1,2], ARRAY[3,4]]; 
array 


{{1, 2}, {3,4}} 
(1 row) 


SELECT ARRAY[[1,2],[3,4]]; 
array 


{{1, 2}, {3,4}} 


(1 row) 


因为 多 维 数组 必须 是 方形 ， 所 以 同 层 的 内 层 构 造 器 必须 生成 同 维 的 子 数组 。 任何 应 用 于 外 
层 ARRAY 构造 器 的 类 型 转换 自动 的 应 用 到 所 有 的 内 层 构 造 器 。 


多 维 数组 构造 器 元 素 可 以 是 任何 生成 合适 数组 的 东西 ， 而 不 仅仅 是 一 个 子 ARRAY 构造 。 比 
如 : 


CREATE TABLE arr(f1 int[], f2 int[]); 
INSERT INTO arr VALUES (ARRAY[[1,2],[3,4]], ARRAY[[5,6],[7,81]); 


SELECT ARRAY[fi, f2, '{{9,10},{11,12}}'::int[]] FROM arr; 
array 


{{{1, 2}, {3,43}, {{5, 6}, {7, 8}}, {{9, 10}, {11, 12} }} 


(1 row) 


因为 数组 必须 得 有 类 型 ， 因 此 在 构造 一 个 空 数组 时 ， 必 须 明 确 的 将 其 构造 成 需要 的 类 型 ， 
如 : 


SELECT ARRAY[]::integer[]; 
array 


我 们 也 可 以 从 一 个 子 查询 的 结果 中 构造 一 个 数组 。 此 时 ， 数组 构造 器 是 关键 字 ARRAY 后 跟着 
一 个 用 圆 括 弧 (不 是 方 括 弧 ) 包 围 的 子 查询 。 比 如 : 


SELECT ARRAY(SELECT oid FROM pg_proc WHERE proname LIKE 'bytea%'); 
array 


{2011, 1954, 1948, 1952, 1951, 1244, 1950, 2005, 1949, 1953, 2006, 31, 2412, 2413} 
(1 row) 


子 查询 必须 只 返回 一 个 单独 的 字段 。 生 成 的 一 维 数 组 将 为 子 查询 里 每 行 结果 生成 一 个 元 素 ， 
元 素 类 型 匹配 子 查询 的 输出 字段 。 


用 array 建立 的 数组 下 标 总 是 从 1 开始 。 有 关 数 组 的 更 多 信息 ， 参 阅 Section 8.15。 


4.2.13. 行 构造 器 


行 构造 器 是 一 个 从 提供 给 它 的 成 员 字 段 数值 中 构造 行 值 (也 叫 复 合 类 型 值 ) 的 表达 式 。 一 个 行 
构造 器 由 关键 字 Row 、 一 个 左 圆 括 弧 、 堆 个 或 多 个 作为 行 字 段 值 的 表达 式 ( 用 逗号 分 隔 )、 一 
个 右 圆 括 弧 组 成 。 上 比如 : 


SELECT ROW(1,2.5,'this is a test'); 


如 果 在 列表 里 有 多 个 表达 式 ， 那 么 关键 字 Row 是 可 选 的 。 


行 构 造 器 可 以 包含 _rowvalue_~>.* 语法 ， 它 将 被 扩展 为 行 值 元 素 的 列表 ， 就 像 闻 语法 用 
于 一 个 sELECT 列表 顶层 一 样 。 例 如 ， 如 果 表 t 有 f1 和 f2 两 个 字段 ， 那么 下 面 两 句 是 等 
价 的 : 


SELECT ROW(t.*, 42) FROM t; 
SELECT ROW(t.f1, t.f2, 42) FROM t; 





Note: PostgreSQL 8.2 之 前 ， .* 语法 是 不 会 被 扩展 的 ， 所 以 rowt.*, 42) 将 创建 一 
个 两 字段 的 行 ， 其 第 一 个 字段 是 另 一 行 的 值 。 新 的 行为 通常 更 有 用 。 如 果 你 需要 旧式 的 
伐 套 行 值 的 做 法 ， 请 将 内 部 的 行 值 写 成 不 包含 .* ， 比如 Row(t，42) o 


缺 省 时 ， Row 表达 式 创 建 的 值 是 一 个 匿名 的 记录 类 型 。 如 果 必 要 ， 你 可 以 把 它 转换 成 一 个 命 
名 的 复合 类 型 ( 既 可 以 是 一 个 表 的 行 类 型 ， 也 可 以 是 一 个 用 create TYP As 创建 的 复合 类 
型 )。 可 能 会 需要 一 个 明确 的 转换 以 避免 歧义 。 比 如 : 


CREATE TABLE mytable(f1 int, f2 float, f3 text); 
CREATE FUNCTION getfi(mytable) RETURNS int AS 'SELECT $1.f1' LANGUAGE SQL; 
-- 因为 只 有 一 个 getf1( ) 存 在 ， 所 以 不 需要 类 型 转换 


SELECT getf1(ROW(1,2.5,'this is a test')); 
getf1 


CREATE TYPE myrowtype AS (f1 int, f2 text, f3 numeric); 

CREATE FUNCTION getfi(myrowtype) RETURNS int AS 'SELECT $1.f1' LANGUAGE SQL; 
-- REE ie BK BH AA pT : 

SELECT getfi(ROW(1,2.5,'this is a test')); 

ERROR: function getfi(record) is not unique 

SELECT getfi(ROW(1,2.5,'this is a test')::mytable); 

getf1 


getf1 


行 构造 器 可 以 用 于 制作 存储 在 复合 类 型 字段 中 的 复合 类 型 值 ， 或 者 是 传递 给 一 个 接受 复合 类 
型 参数 的 函数 。 另 外 ， 我 们 也 可 以 用 它 比 较 两 个 行 值 或 者 用 Is NULL 或 Is NOT NULL 测试 一 
个 行 值 ， 比 如 : 


SELECT ROW(1,2.5,'this is a test') = ROW(1, 3, 'not the same'); 


SELECT ROW(table.*) IS NULL FROM table; -- detect all-null rows 


更 多 的 细节 ， 请 人 参阅 Section 9.23。 行 构造 器 还 可 以 用 于 连接 子 查询 ， 这 些 在 Section 9.222 
面 有 详细 讨论 。 


4.2.14. 表达 式 计 算 规 则 


子 表达 式 的 计算 顺序 是 未 定义 的 。 特 别 要 指出 的 是 ， 一 个 操作 符 或 者 函数 的 输入 并 不 一 
按照 从 左 向 右 的 顺序 或 者 以 某 种 特定 的 顺序 进行 计算 的 。 


判断 它 的 一 部 分 就 可 以 得 到 ， 那么 其 它 子 表达 式 就 


另外 ， 如 果 一 个 表达 式 的 结果 可 以 通过 只 
RAG: 


可 以 完全 不 计算 了 。 比 如 ， 如 果 我 们 


SELECT true OR somefunc(); 


那么 somefunc() 就 (可 能 ) 根 本 不 会 被 调用 。 即使 像 下 面 这 样 写 也 是 一 样 : 


SELECT somefunc() OR true; 


请 注意 这 和 某 些 编程 语言 里 从 左 向 右 " 短 路 "布尔 操作 符 是 不 一 样 的 。 


因此 ， 拿 有 副作用 的 函数 作为 复杂 表达 式 的 一 部 分 是 不 明智 的 。 在 wHERE 和 HAVING Pa 
依赖 副作用 或 者 是 计算 顺序 是 特别 危险 的 ， 因为 这 些 子 句 都 是 作为 生成 一 个 执行 规划 的 一 
分 进行 了 大 量 的 再 处 理 。 在 这 些 子 句 里 的 布尔 表达 式 ( AND / oR / NoT 的 组 合 ) 可 以 用 布尔 
数 运 算 律 允许 的 任何 方式 进行 识别 


如 果 需 要 强制 计算 顺序 ， 那 么 可 以 使 用 case 构造 (参阅 Section 9.17)。 比如 ， 下 面 是 一 种 企 
图 避免 在 whERE 子 句 里 被 需 除 的 不 可 靠 方 法 : 


SELECT ... WHERE x > © AND y/x > 1.5; 
但 是 下 面 这 个 是 安全 的 : 
SELECT ... WHERE CASE WHEN x > 9 THEN y/x > 1.5 ELSE false END; 


这 种 风格 的 case 构造 会 阻止 优化 ， 因 此 应 该 只 在 必要 的 时 候 才 使 用 。 在 这 个 特殊 的 例子 
里 ， 毫 无 疑问 写成 y &gt; 1.5*x 更 好 。 


4.3. 调用 函数 


PostgreSQL 人 允许 图 数 有 命名 参数 ， 可 以 被 位 置 或 名 称 表 示 法 调用 。 名 称 表 示 法 对 有 大 量 参数 
的 函数 特别 有 用 ， 因为 它 更 加 明确 和 可 靠 的 标记 了 形 参 和 实 参 之 间 的 联系 。 在 位 置 表示 法 
里 ， 一 个 画 数 调 用 的 参数 值 要 用 与 函数 声明 相同 的 顺序 来 写 出 。 在 名 称 表 示 法 里 ， 参 数 是 通 
过 名 称 来 与 函数 参数 相 匹 配 的 ， 可 以 以 任意 顺序 写 出 。 


不 管用 那 种 表示 法 ， 在 函数 声明 时 给 出 的 有 默认 值 的 参数 在 调用 时 不 必 写 出 。 但 是 这 在 名 称 
表示 法 中 是 特别 有 用 的 ， 因 为 参数 的 任意 组 合 都 是 可 以 省 略 的 。 而 在 位 置 表示 法 中 ， 参 数 只 
能 从 右 到 左 省 略 。 


PostgreSQL 也 支持 混合 表示 法 ， 混合 表示 法 结合 了 位 置 和 名 称 表 示 法 。 因 为 这 个 原因 ， 先 写 
位 置 参 数 然后 跟着 写 命 名 参数 。 


下 面 的 例子 将 说 明 三 种 表示 法 的 用 法 ， 使 用 下 面 的 范 数 定义 : 


CREATE FUNCTION concat_lower_or_upper(a text, b text, uppercase boolean DEFAULT false) 
RETURNS text 
AS 


$$ 

SELECT CASE 
WHEN $3 THEN UPPER($1 || ' ' || $2) 
ELSE LOWER($1 || ' ' || $2) 
END; 

$$ 


LANGUAGE SQL IMMUTABLE STRICT; 


函数 concat_lower_or_upper 有 两 个 强制 的 参数 ， a 和 b 。 此 外 第 三 个 参数 是 一 个 可 选 参 
数 uppercase, $A X false o a 和 b 输入 将 被 串联 ， 并 且 将 根据 uppercase 参数 强制 为 
大 写 或 者 小 宇 。 这 个 函数 定义 的 其 他 详细 资料 在 这 并 不 重要 (参阅 Chapter 35 获取 更 多 信 
A) o 


4.3.1. 使 用 位 置 表 示 法 
在 PostgreSQL 中 ， 位 置 表示 法 是 传递 参数 到 函数 的 传统 机 制 。 一 个 例子 是 


SELECT concat_lower_or_upper('Hello', 'World', true); 
concat_lower_or_upper 

HELLO WORLD 

(1 row) 


所 有 的 参数 都 按 顺序 指定 。 因 为 uppercase 被 指定 为 true, 所 以 结果 为 大 写 。 另 外 一 个 例子 


eS. 
FE: 


SELECT concat_lower_or_upper('Hello', 'World'); 
concat_lower_or_upper 


hello world 
(1 row) 


xB, SIT SR uppercase ， 所 以 接受 它 的 默认 值 false, 导致 小 写 的 输出 。 在 位 置 表示 
法 中 ， 参 数 只 要 有 默认 值 就 可 以 从 右 到 左 省 略 。 


4.3.2. 使 用 名 称 表示 法 


在 名 称 表示 法 中 ， 每 个 参数 名 字 是 使 用 := 声明 的 ， 用 来 将 它 从 参数 表达 式 中 独立 出 来 。 例 
如 : 


SELECT concat_lower_or_upper(a := 'Hello', b := 'World'); 
concat_lower_or_upper 


hello world 
(1 row) 


AM, BE uppercase 是 省 略 的 ， 所 以 它 被 隐 式 的 设置 为 false 。 使 用 名 称 表示 法 的 好 你 之 
一 是 参数 可 以 用 任意 顺序 声明 ， 例 如 


SELECT concat_lower_or_upper(a := 'Hello', b := 'World', uppercase := true); 
concat_lower_or_upper 


HELLO WORLD 
(1 row) 


SELECT concat_lower_or_upper(a := 'Hello', uppercase := true, b := 'World'); 
concat_lower_or_upper 


HELLO WORLD 
(1 row) 


4.3.3. 使 用 混合 表示 法 


混合 表示 法 结合 了 位 置 和 名 称 表 示 法 。 然 而 ， 就 像 之 前 提 到 的 ， 命 名 参数 不 可 以 在 位 置 参数 
前 面 。 例 如 : 


SELECT concat_lower_or_upper('Hello', 'World', uppercase := true); 
concat_lower_or_upper 


HELLO WORLD 
(1 row) 


在 上 面 的 查询 中 ， 参 数 a 和 uppercase 是 用 位 置 声明 的 ， 而 uppercase 是 用 名 称 声明 的 。 在 
这 个 例子 中 ， 添 加 了 文档 中 没有 的 一 点 。 在 一 个 有 多 个 参数 有 上 默认 值 的 更 复杂 的 函数 中 ， 名 
称 或 者 混合 表示 法 可 以 节省 很 多 敲 键 ， 并 且 可 以 减少 犯错 的 几率 。 
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本 章 介 绍 如 何 创建 一 个 保存 数据 的 数据 库 结构 。 在 关系 型 数据 库 里 ， 裸 数据 是 存储 在 表 中 
的 ， 因此 本 章 的 大 部 分 内 容 都 将 用 于 介绍 如 何 创 建 表 以 及 如 何 修改 他 们 ， 以 及 在 控制 表 中 存 
储 的 数据 上 有 什么 可 以 获得 的 特性 。 随 后 ， 我 们 讨论 表 是 如 何 组 织 成 模式 的 ， 以 及 如 何 给 表 
赋予 权限 。 最 后 ， 我 们 将 简单 查看 一 下 影响 数据 存储 的 其 它 因素 ， 比 如 继承 、 MAL, WR 
触发 器 。 


5.1. 表 的 基本 概念 


关系 型 数据 库 中 的 表 非 常 类 似 纸 面 上 的 一 张 表 : 它 由 行 和 列 组 成 。 字 段 的 数目 和 顺序 是 固定 

的 ， 每 个 字段 都 有 一 个 名 字 。 行 的 数目 是 变化 的 ( 它 反 映 了 给 定时 刻 存储 的 数据 量 )。 SQL 对 
表 中 行 的 顺序 没有 任何 承诺 。 当 读 取 一 个 表 时 ， 行 将 会 以 一 个 未 指定 的 顺序 出 现 ， 除非 你 明 

确 地 要 求 排序 。 这 些 内 容 在 Chapter 7 里 介绍 。 另外 ，SQL 并 不 给 行 赋予 唯一 的 标识 ， 因 此 我 
们 很 可 能 在 一 个 表 中 有 好 几 个 完全 相同 的 行 。 这 是 作为 SQL 基础 的 下 层 数 学 模型 的 必然 结 

果 ， 但 是 这 通常 是 我 们 不 愿意 看 到 的 。 本 章 各 后 的 部 分 将 讨论 如 何 处 理 这 个 问题 。 


每 个 字段 都 有 一 个 数据 类 型 。 数 据 关 型 控制 着 一 个 字段 所 有 可 能 值 的 集合 ， 并 且 控制 着 字段 
中 数据 的 语义 ， 这 样 它 就 可 以 用 于 计算 。 上 比如 ， 一 个 声明 为 数值 类 型 的 字段 不 会 接受 任意 文 
本 字符 串 ， 而 存储 在 这 种 字段 里 的 数据 可 以 用 于 数学 计算 。 相 比 之 下 ， 一 个 声明 为 字符 串 类 
型 的 字段 接受 几乎 任意 类 型 的 数据 ， 但 是 它们 不 能 进行 数学 计算 (不 过 可 以 进行 像 字符 串 连 接 
之 类 的 操作 )。 


PostgreSQL 包 含 一 套 可 剪裁 的 内 置 数据 类 型 ， 这 些 类 型 可 以 适用 于 许多 应 用 。 用 户 也 可 以 定 
义 它 们 自己 的 数据 类 型 。 大 多 数 内 置 的 数据 类 型 有 显而易见 的 名 字 和 语义 ， 因此 我 们 把 详细 
的 解释 放 在 了 Chapter 8。 常 用 的 数据 类 型 有 : 用 于 整数 的 integer 、 用 于 可 能 为 分 数 

的 numeric 、 用 于 字符 串 的 text 、 用 于 日 期 的 date 、 用 于 时 间 的 time, Aa ey 


的 timestamp o 


要 创建 一 个 表 ， 可 用 使 用 CREATE TABLE 命 令 。 在 这 个 命令 里 ， 你 至 少 要 为 新 表 声 明 一 个 名 
字 ， 还 有 各 字段 的 名 字 以 及 其 数据 类 型 。 比 如 : 


CREATE TABLE my_first_table ( 
first_column text, 
second_column integer 


Ny 


这 样 就 创建 了 一 个 有 两 个 字段 的 名 为 my_first_table 的 表 。 第 一 个 字段 的 名 字 

是 first_column ， 数 据 类 型 为 text ; 第 二 个 字段 的 名 字 是 second_column ， 数 据 类 型 

是 integer, 表 和 字段 的 名 字 遵 循 Section 4.1.1 里 面 解释 的 标识 符 语 法 。 类 型 名 通常 也 是 标 
识 符 ( 但 是 有 一 些 例外 )。 请 注意 字段 列表 是 有 逗号 分 隔 的 ， 并 且 用 圆 括 弧 包 围 。 


当然 ， 前 面 只 是 一 个 非常 虚构 的 例子 。 通 常 ， 你 会 给 表 和 字段 取 一 个 有 意义 的 名 字 ， 用 以 表 
达 他 们 存储 的 什么 类 型 的 数据 ， 所 以 还 是 让 我 们 给 一 个 比较 现实 的 例子 : 


CREATE TABLE products ( 
product_no integer, 
name text, 
price numeric 


); 


numeric 类 型 可 以 存储 分 数 部 分 ， 金额 很 可 能 有 这 样 的 分 数 部 分 。 





Tip: 如 果 你 创建 了 许多 相互 关联 的 表 ， 那 么 最 好 为 表 和 字段 选择 一 致 的 命名 模式 。 比 
如 ， 表 名 字 可 以 统一 选择 单数 或 者 复数 ， 两 种 选择 都 有 这 样 那样 的 理论 家 支持 。 





一 个 表 能 包含 的 字段 数目 是 有 限制 的 。 根 据 字段 类 型 的 不 同 ， 这 个 数目 可 能 在 250 到 1600 
之 间 。 不 过 ， 不 管 是 哪 一 端的 数字 ， 如 果 你 设计 的 表 包 含 那 么 多 的 字段 好 像 都 很 不 可 能 发 
， 否则 是 设计 上 有 问题 的 表现 。 


如 果 你 不 再 需要 一 个 表 ， 那 么 可 以 用 DROP TABLE 命 令 删 除 它 。 像 这 样 : 


DROP TABLE my_first_table; 
DROP TABLE products; 


试图 删除 一 个 不 存在 的 表 是 一 个 错误 。 不 过 ， 在 SQL 脚本 文件 里 ， 我 们 通常 在 创建 表 之 前 无 
条 件 删 除 它 并 忽略 错误 信息 ， 所 以 无 论 要 删除 的 表 存 不 存在 ， 这 个 脚本 都 成 功 。 当然 你 还 可 
以 使 用 prop TABLE IF EXISTS 来 避免 警告 信息 ， 不 过 这 并 不 符合 SQL 标准 。 


如 果 你 需要 修改 一 个 已 经 存在 的 表 ， 那 么 可 以 看 看 本 章 稍 后 的 Section 5.5。 


使 用 到 目前 为 止 讨 论 的 工具 我 们 可 以 创建 功能 完整 的 表 。 本 章 剩 下 的 部 分 是 有 关 向 表 定 义 中 
增加 特性 、 保 证 数据 完整 性 、 安 全 性 或 便利 性 的 内 容 。 如 果 你 急于 给 表 填 充 数据 ， 那 么 你 可 
以 忽略 余下 的 部 分 直接 到 Chapter 6, 然后 在 稍 后 的 时 候 再 回来 阅读 本 章 。 


5.2. 缺 省 值 


一 个 字段 可 以 赋予 缺 省 值 。 如 果 新 创建 了 一 个 数据 行 ， 而 有 些 字 段 的 数值 没有 声明 ， 那么 这 
些 字段 将 被 填充 为 它们 各 自 的 缺 省 值 。 一 条 数据 修改 命令 也 可 以 明确 地 要 求 把 一 个 字段 设置 
为 它 的 缺 省 值 ， 而 不 用 事先 知道 这 个 缺 省 值 是 什么 。 有 关 数 据 操作 的 命令 在 Chapter 6。 


如 果 没 有 明确 声明 缺 省 值 ， 那 么 缺 省 值 是 NULL 。 这 么 做 通常 是 合理 的 ， 因 为 NULL 表示 "未 
知 "。 


在 一 个 表 定 义 里 ， 缺 省 值 是 在 字段 数据 类 型 后 面 列 出 的 。 比 如 : 


CREATE TABLE products ( 

product_no integer, 

name text, 

price numeric **DEFAULT 9.99** 
); 


缺 省 值 可 以 是 一 个 表达 式 ， 它 会 在 插入 缺 省 值 的 时 候 计 算 (不 是 在 创建 表 的 时 候 )。 一 个 常见 
的 例子 是 一 个 timestamp 字段 可 能 有 人 缺 省 值 CURRENT_TIMESTAMP, 它 表示 插入 行 的 时 刻 。 另 外 
一 个 常见 的 例子 是 为 每 一 行 生 成 一 个 "序列 号 "。 在 PostgreSQL 里 ， 通 常 是 用 类 似 下 面 这 样 的 
方法 生成 的 : 


CREATE TABLE products ( 
product_no integer **DEFAULT nextval('products_product_no_seq')**, 


Ne 


这 里 的 nextval() 从 一 个 序列 对 象 (参阅 Section 9.16) 提供 后 继 的 数值 。 这 种 做 法 非常 普通 ， 
以 至 于 我 们 有 一 个 专门 的 缩写 用 于 此 目的 : 
CREATE TABLE products ( 
product_no **SERIAL**, 


); 


SERIAL 缩写 在 Section 8.1.4 里 有 进一步 描述 。 


5.3. 约束 


数据 类 型 是 限制 我 们 可 以 在 表 里 存 储 什么 数据 的 一 种 方法 。 不 过 ， 对 于 许多 应 用 来 说 ， 这 种 
限制 实在 是 太 粗 糙 了 。 比 如 ， 一 个 包含 产品 价格 的 字段 应 该 只 接受 正 数 。 但 是 没有 哪 种 标准 
数据 类 型 只 接受 正 数 。 另外 一 个 问题 是 你 可 能 需要 根据 其 它 字段 或 者 其 它 行 的 数据 来 约束 字 
段 数据 。 比 如 ， 在 一 个 包含 产品 信息 的 表 中 ， 每 个 产品 编号 都 应 该 只 有 一 行 。 


对 于 这 些 问题 ，SQL 允许 你 在 字段 和 表 上 定义 约束 。 约 束 人 允许 你 对 数据 施加 任意 控制 。 如 果 
用 户 企图 在 字段 里 存储 违反 约束 的 数据 ， 那 么 就 会 抛 出 一 个 错误 。 这 种 情况 同时 也 适用 于 数 
值 来 自 缺 省 值 的 情况 。 


5.3.1. 检查 约束 


检查 约束 是 最 常见 的 约束 类 型 。 它 允许 你 声明 在 某 个 字段 里 的 数值 必须 使 一 个 布尔 表达 式 为 
真 。 比如 ， 要 强制 一 个 正 数 的 产品 价格 ， 你 可 以 用 : 


CREATE TABLE products ( 
product_no integer, 
name text, 
price numeric **CHECK (price > 0)** 


如 你 所 见 ， 约 束 定义 在 数据 类 型 之 后 ， 就 好 像 缺 省 值 定义 一 样 。 缺 省 值 和 约束 可 以 按 任 意 顺 
序 排列 。 一 个 检查 约束 由 一 个 关键 字 cec 后 面 跟 一 个 放 在 圆 括 弧 里 的 表达 式 组 成 。 检查 约 
束 表 达 式 应 该 包含 受 约束 的 字段 ， 否 则 这 个 约束 就 没什么 意义 了 。 


你 还 可 以 给 这 个 约束 取 一 个 独立 的 名 字 。 这 样 就 可 以 令 错 误 信 息 更 清晰 ， 并 且 在 你 需要 修改 
它 的 时 候 引 用 这 个 名 字 。 语 法 是 : 


CREATE TABLE products ( 
product_no integer, 
name text, 
price numeric **CONSTRAINT positive_price** CHECK (price > 0) 


); 
因此 ， 要 声明 一 个 命名 约束 ， 使 用 关键 字 coNsTRAINT 后 面 跟 一 个 标识 符 ( 作 为 名 字 )， 然后 再 
跟 约束 定义 。 如 果 你 不 用 这 个 方法 声明 约束 ， 那 么 系统 会 自动 为 你 选择 一 个 名 字 。 


一 个 检查 约束 也 可 以 引用 多 个 字段 。 假 设 你 存储 一 个 正常 价格 和 一 个 折扣 价 ， 并 且 你 想 保 证 
折扣 价 比 正 常 价 低 : 


CREATE TABLE products ( 
product_no integer, 
name text, 
price numeric CHECK (price > 0), 
discounted_price numeric CHECK (discounted_price > 0), 
**CHECK (price > discounted_price)** 


Ne 


头 两 个 约束 看 上 去 很 面 熟 。 第 三 个 使 用 了 一 个 新 的 语法 。 它 没有 附着 在 某 个 字段 上 ， 而 是 在 
逗号 分 隔 的 字段 列表 中 以 一 个 独立 行 的 形式 出 现 。 字 段 定义 和 约束 定义 可 以 按照 任意 顺序 列 
出 。 


我 们 称 头 两 个 约束 是 "字段 约束 "， 而 第 三 个 约束 是 " 表 约 束 "( 和 字段 定义 分 开 写 )。 字段 约束 也 
可 以 写成 表 约 束 ， 而 反 过 来 很 可 能 不 行 ， 因 为 系统 假设 字段 约束 只 引用 它 所 从 属 的 字段 。 
PostgreSQL 并 不 强制 这 条 规则 ， 但 是 如 果 你 希望 自己 的 表 定 义 可 以 和 其 它 数 据 库 系统 兼容 ， 
那么 你 最 好 还 是 遵循 这 条 规则 。 上 面 的 例子 也 可 以 这 么 写 : 


CREATE TABLE products ( 
product_no integer, 
name text, 
price numeric, 
CHECK (price > 0), 
discounted_price numeric, 
CHECK (discounted_price > 0), 
CHECK (price > discounted_price) 


Ne 


CREATE TABLE products ( 
product_no integer, 
name text, 
price numeric CHECK (price > 0), 
discounted_price numeric, 
CHECK (discounted_price > © AND price > discounted_price) 


Ne 


这 只 是 风格 的 不 同 。 
和 字段 约束 一 样 ， 我 们 也 可 以 给 表 约 束 赋 予 名 称 ， 方 法 也 相同 : 


CREATE TABLE products ( 
product_no integer, 
name text, 
price numeric, 
CHECK (price > 0), 
discounted_price numeric, 
CHECK (discounted_price > 0), 
**CONSTRAINT valid_discount** CHECK (price > discounted_price) 


Ne 


我 们 还 要 注意 的 是 ， 当 约束 表达 式 计 算 结 果 为 真 或 NULL 的 时 候 ， 检 查 约 束 会 被 认为 是 满足 
REN, 因为 大 多 数 表 达 式 在 含有 NULL 操作 数 的 时 候 结 果 都 是 NULL ， 所 以 这 些 约束 不 能 
阻止 字段 值 为 NULL, 要 确保 一 个 字段 值 不 为 NULL ， 可 以 使 用 下 一 节 介 绍 的 非 空 约束 。 


5.3.2. JEZ AR 
非 空 约 束 只 是 简单 地 声明 一 个 字段 必须 不 能 是 NULL。 下 面 是 一 个 例子 : 


CREATE TABLE products ( 
product_no integer **NOT NULL**, 
name text **NOT NULL**, 
price numeric 


Ne 


一 个 非 空 约束 总 是 写成 一 个 字段 约束 。 非 空 约束 在 功能 上 等 效 于 创建 一 个 检查 约束 
CHECK (``_colum_name_ IS NOT NULL)， 但 在 PostgreSQL 里 ， 创 建 一 个 明确 的 非 空 约 束 效 
率 更 高 。 缺点 是 你 不 能 给 它 一 个 明确 的 名 字 。 


当然 ， 一 个 字段 可 以 有 多 个 约束 。 只 要 一 个 接着 一 个 写 就 可 以 了 : 


CREATE TABLE products ( 

product_no integer NOT NULL, 

name text NOT NULL, 

price numeric NOT NULL CHECK (price > 0) 
); 


它们 的 顺序 无 所 谓 。 顺 序 并 不 影响 约束 检查 的 顺序 。 


NOT NULL 约束 有 个 相反 的 约束 : NULL 约束 。 它 并 不 意味 着 该 字段 必须 是 空 ， 因 为 这 样 的 字 
段 也 没 用 。 它 只 是 定义 了 该 字段 可 以 为 空 的 这 个 缺 省 行为 。 在 SQL 标准 里 没有 定义 NuLL 的 
束 ， 因 此 不 应 该 在 可 移植 的 应 用 中 使 用 它 。 在 PostgreSQL 里 面 增加 这 个 约束 只 是 为 了 和 其 它 
数据 库 系 统 兼容 。 不 过 ， 有 些 用 户 喜 欢 它 ， 因 为 这 个 约束 可 以 让 他 们 很 容易 在 脚本 文件 里 切 
OR, 上 比如， 你 可 以 从 下 面 这 样 开始 : 


CREATE TABLE products ( 
product_no integer NULL, 
name text NULL, 
price numeric NULL 


Ne 


然后 在 需要 的 时 候 插 入 NoT 关键 字 。 





Tip: 在 大 多 数 数据 库 设 计 里 ， 主 要 的 字段 都 应 该 标记 为 非 空 。 


5.3.3. 唯一 约束 


唯一 约束 保证 在 一 个 字段 或 者 一 组 字段 里 的 数据 与 表 中 


法 是 : 


CREATE TABLE products ( 
product_no integer **UNIQUE**, 
name text, 
price numeric 


上 面 是 写成 字段 约束 ， 下 面 这 个 则 写成 表 约 束 : 


CREATE TABLE products ( 
product_no integer, 
name text, 
price numeric, 

**UNIQUE (product_no)** 

); 


如 果 一 个 唯一 约束 引用 一 组 字段 ， 那 么 这 些 字段 用 去 号 分 隔 列 出 : 


CREATE TABLE example ( 
a integer, 
b integer, 
c integer, 
**UNIQUE (a, c)** 
); 


这 样 就 声明 了 特定 字段 值 的 组 合 在 整个 表 范 围 内 是 唯一 的 。 


以 不 必 是 (并 且 通 常 也 确实 不 是 ) 唯 一 的 。 


它 行 的 数据 相 比 是 唯一 的 。 它 的 语 


但 是 这 


3x t6 


你 也 可 以 给 唯一 约束 赋予 一 个 自己 定义 的 名 字 ， 方 法 与 前 面相 同 : 


CREATE TABLE products ( 


product_no integer **CONSTRAINT must_be_different** UNIQUE, 


name text, 
price numeric 


Ne 


添加 一 个 唯一 约束 通常 会 自动 在 约束 中 使 用 的 列 或 一 组 列 上 创建 一 


字段 中 的 某 个 单独 值 可 


个 唯一 btree 索 引 。 


通常 ， 如 果 包 含 在 唯一 约束 中 的 那 几 个 字段 在 表 中 有 多 个 相同 的 行 ， 就 违反 了 唯一 约束 。 但 
是 在 这 种 比较 中 ，NULL 被 认为 是 不 相等 的 。 这 就 意味 着 ， 在 多 字段 唯一 约束 的 情况 下 ， 如 


果 在 至 少 一 个 字段 上 出 现 NULL ， 那 么 我 们 还 是 可 以 存储 同样 的 这 种 数据 行 。 


这 种 行为 遵循 


SQL 标准 ， 但 是 我 们 听 说 其 它 SQL 数据 库 可 能 不 遵循 这 个 标准 。 因此 如 果 你 要 开发 可 移植 


的 程序 ， 那 么 最 好 仔细 些 。 


5.3.4. 主键 


从 技术 上 讲 ， 主 键 约 束 只 是 唯一 约束 和 非 空 约束 的 组 合 。 所 以 ， 下 面 两 个 表 定 义 是 等 价 的 : 


CREATE TABLE products ( 
product_no integer UNIQUE NOT NULL, 
name text, 
price numeric 


i 


CREATE TABLE products ( 
product_no integer **PRIMARY KEY**, 
name text, 
price numeric 


NF 


主键 也 可 以 约束 多 于 一 个 字段 ; 其 语法 类 似 于 唯一 约束 : 


CREATE TABLE example ( 

a integer, 

b integer, 

c integer, 

**PRIMARY KEY (a, c)** 
); 


主键 表示 一 个 或 多 个 字段 的 组 合 可 以 用 于 唯一 标识 表 中 的 数据 行 。 这 是 定义 一 个 主键 的 直接 
结果 。 请 注意 : 一 个 唯一 约束 实际 上 并 不 能 提供 一 个 唯一 标识 ， 因为 它 不 排除 NULL 。 这 个 
功能 对 文档 目的 和 客户 应 用 都 很 有 用 。 上 比如 ， 一 个 可 以 修改 行 数值 的 GUI 应 用 可 能 需要 知道 
一 个 表 的 主键 才能 唯一 地 标识 每 一 行 。 


添加 一 个 主键 将 会 在 主键 使 用 的 列 或 一 组 列 中 自动 创建 一 个 唯一 btree 索 引 。 


一 个 表 最 多 可 以 有 一 个 主键 (但 是 它 可 以 有 多 个 唯一 和 非 空 约束 )。 关 系 型 数据 库 理论 告诉 我 
们 ， 每 个 表 都 必须 有 一 个 主键 。PostgreSQL 并 不 强制 这 个 规则 ， 但 我 们 最 好 还 是 遵循 它 。 


5.3.5. 外 键 


外 键 约束 声明 一 个 字段 (或 者 一 组 字段 ) 的 数值 必须 匹配 另外 一 个 表 中 出 现 的 数值 。 我 们 把 这 
个 行为 称 为 两 个 相关 表 之 间 的 参照 完整 性 。 


假设 你 有 个 产品 表 ， 我 们 可 能 使 用 了 好 几 次 : 


CREATE TABLE products ( 
product_no integer PRIMARY KEY, 
name text, 
price numeric 


Ne 


假设 你 有 一 个 存储 这 些 产 品 的 订单 的 表 。 我 们 想 保证 订单 表 只 包含 实际 存在 的 产品 。 因此 我 
们 在 订单 表 中 定义 一 个 外 键 约 束 引 用 产品 表 : 


CREATE TABLE orders ( 
order_id integer PRIMARY KEY, 
product_no integer **REFERENCES products (product_no)**, 
quantity integer 


i 


现在 ， 我 们 不 能 创建 任何 其 非 空 product_no 记录 没有 在 产品 表 中 出 现 的 订单 。 


在 这 种 情况 下 我 们 把 订单 表 叫 做 引用 表 ， 而 产品 表 叫 做 被 引用 表 。 同 样 ， 也 有 引用 字段 和 被 
引用 字段 。 


你 也 可 以 把 上 面 的 命令 简写 成 : 


CREATE TABLE orders ( 
order_id integer PRIMARY KEY, 
product_no integer **REFERENCES products**, 
quantity integer 


Ne 


因为 如 果 缺 少 字段 列表 的 话 ， 就 会 引用 被 引用 表 的 主键 。 


一 个 外 键 也 可 以 约束 和 引用 一 组 字段 。 同 样 ， 也 需要 写成 表 约 束 的 形式 。 下 面 是 一 个 捏造 出 
来 的 语法 例子 : 


CREATE TABLE t1 ( 

a integer PRIMARY KEY, 

b integer, 

c integer, 

**FOREIGN KEY (b, c) REFERENCES other_table (c1, c2)** 
); 


当然 ， 被 约束 的 字段 数目 和 类 型 需要 和 被 引用 字段 数目 和 类 型 一 致 。 
和 平常 一 样 ， 你 也 可 以 给 外 键 约束 赋予 自 定义 的 名 字 。 


一 个 表 可 以 包含 多 于 一 个 外 键 约束 。 这 个 特性 用 于 实现 表 之 间 的 多 对 多 关系 。 比如 你 有 关于 
产品 和 订单 的 表 ， 但 现在 你 想 允 许 一 个 订单 可 以 包含 多 种 产品 (上 面 那 个 结构 是 不 允许 这 么 做 
的 )， 你 可 以 使 用 这 样 的 结构 : 


CREATE TABLE products ( 
product_no integer PRIMARY KEY, 
name text, 
price numeric 


NF 


CREATE TABLE orders ( 
order_id integer PRIMARY KEY, 
shipping_address text, 


Ne 


CREATE TABLE order_items ( 
product_no integer REFERENCES products, 
order_id integer REFERENCES orders, 
quantity integer, 
PRIMARY KEY (product_no, order_id) 

); 


TARAIRE eM Meee eh. 


我 们 知道 外 键 不 允许 创建 和 任何 产品 都 无 关 的 订单 。 但 是 如 果 一 个 订单 创建 之 后 其 引用 的 产 
品 被 删除 了 怎么 办 ? SQL 也 允许 你 处 理 这 个 问题 。 简单 说 ， 我 们 有 几 种 选择 : 


© 不 人 允许 删除 一 个 被 引用 的 产品 
e 同时 也 删除 订单 
。 HEM? 


为 了 说 明 这 个 问题 ， 我 们 对 上 面 的 多 对 多 关系 制定 下 面 的 策略 : 如 果 有 人 想 删 除 一 种 仍然 被 
某 个 订单 引用 的 产品 (通过 order_items )， 那么 就 不 允许 这 么 做 。 如 果 有 人 删除 了 一 个 订单 ， 
那么 订单 项 也 被 删除 。 


CREATE TABLE products ( 
product_no integer PRIMARY KEY, 
name text, 
price numeric 


i 


CREATE TABLE orders ( 
order_id integer PRIMARY KEY, 
shipping_address text, 


Ne 


CREATE TABLE order_items ( 
product_no integer REFERENCES products **ON DELETE RESTRICT**, 
order_id integer REFERENCES orders **ON DELETE CASCADE**, 
quantity integer, 
PRIMARY KEY (product_no, order_id) 

); 


限制 和 级 联 删 除 是 两 种 最 常见 的 选项 。 RESTRICT 禁止 删除 被 引用 的 行 。 No action 的 意思 是 
如 果 在 检查 约束 的 时 候 还 存在 任何 引用 行 ， 则 抛 出 错误 ; 如 果 你 不 声明 任何 东西 ， 那 么 它 就 
是 缺 省 的 行为 。 这 两 个 选择 的 实际 区 别 是 : No ACTION 人 允许 约束 检查 推迟 到 事务 的 晚 些 时 

候 ， 而 RESTRICT 不 行 。 cAscADE 声明 在 删除 一 个 被 引用 的 行 的 时 候 ， 所 有 引用 它 的 行 也 会 被 


自动 删除 掉 。 在 外 键 字段 上 的 动作 还 有 两 个 选项 SET NULL 和 SET DEFAULT ， 它 们 导致 在 被 
引用 行 删 除 的 时 候 ， 将 引用 它们 的 字段 分 别 设置 为 NULL 和 缺 省 值 。 请 注意 这 些 选 项 并 不 能 
让 你 逃脱 被 观察 和 约束 的 境地 。 比如 ， 如 果 一 个 动作 声明 set pEFAULT ， 但 是 缺 省 值 并 不 能 
满足 外 键 约束 ， 那么 该 动作 就 会 失败 。 


与 ON DELETE 类 似 的 还 有 oN UPDATE 选项 ， 它 是 在 被 引用 字段 修改 (更 新 ) 的 时候 调用 的 ， 可 用 
的 动作 是 一 样 的 。 在 这 种 情况 下 ， cAscApE 意味 着 被 引用 字段 的 更 新 后 的 值 ， 应 该 被 拷贝 到 
引用 行 中 。 


通常 地 ， 如 果 一 个 引用 行 的 任意 引用 字段 为 null， 那么 这 个 引用 行 不 必 满 足 外 键 约束 。 如 果 外 
键 声 明 中 添加 了 match FULL ， 引 用 行 只 有 在 所 有 的 引用 字段 都 是 null 时 ， 才能 逃避 满足 约束 

(所 以 null 和 non-null 值 的 混合 肯定 不 能 满足 match FULL AR) o 如 果 你 不 想 引 用 行 能 够 避免 
满足 外 键 约束 ， 那 么 声明 引用 行为 NoT NULL o 


一 个 外 键 必 须要 么 引用 一 个 主键 ， 要 么 引用 一 个 唯一 约束 。 这 意味 着 被 引用 行 总 是 有 一 个 过 
引 (一 个 基本 的 主键 或 唯一 约束 ) ; 所 以 检查 一 个 引用 行 是 否 有 一 个 匹配 是 高 效 的 。 因此 从 
被 引用 表 中 pELETE 一 个 行 或 者 一 个 被 引用 字段 uppate 一 列 ， 都 需要 扫描 一 次 引用 表 以 便 从 
行 中 匹配 老 的 数值 ， 给 引用 字段 创建 索引 也 是 一 个 好 主意 。 因为 这 个 不 是 总 是 被 需要 ， 而 且 
怎么 去 建立 索引 还 有 许多 其 他 的 选择 ， 外 键 约束 的 声明 不 能 在 引用 字段 上 自动 生成 一 个 素 
Bl. 


有 关 更 新 和 删除 数据 的 更 多 信息 可 以 在 Chapter 6 里 找到 。 也 可 以 查看 关于 外 键 约束 语法 的 描 
述 ， 在 参考 文档 的 CREATE TABLE。 


5.3.6. 排除 约束 


排他 约束 保证 如 果 任 何 两 行 被 在 声明 的 字段 里 比较 或 者 用 声明 的 操作 表达 ， 至 少 有 一 个 操作 
比较 会 返回 错误 或 空 值 。 句 法 是 : 
CREATE TABLE circles ( 
c circle, 


EXCLUDE USING gist (c WITH &&) 
Ne 


更 多 细节 也 请 参考 CREATE TABLE ... CONSTRAINT ... EXCLUDE 。 


添加 一 个 排除 约束 会 在 约束 声明 里 自动 创建 一 个 声明 类 型 的 索引 。 


5.4. 系统 字段 


每 个 表 都 有 几 个 系统 字段 ， 这 些 字段 是 由 系统 隐 仿 定义 的 。 因 此 ， 这 些 名 字 不 能 用 于 用 户 定 
义 的 字段 名 。 请 注意 这 些 限 制 与 这 个 名 字 是 否 关 键 字 无 关 ， 把 名 字 用 引号 括 起 来 并 不 能 让 你 
逃离 这 些 限制 。 你 实际 上 不 需要 注意 这 些 字 段 ; 只 要 知道 它们 存在 就 可 以 了 。 

oid 

行 对 象 标 识 符 (对 象 ID)。 这 个 字段 只 有 在 创建 表 的 时 候 使 用 了 with ors 或 者 是 配置 参 

数 default_with_oids 的 值 为 真 时 出 现 。 这 个 字段 的 类 型 是 oid (和 字段 同名 ) ; 参阅 Section 
8.18 获 取 有 关 这 种 类 型 的 更 多 信息 。 

tableoid 

包含 本 行 的 表 的 OID。 这 个 字段 对 那些 从 继承 层次 中 选取 的 查询 特别 有 用 (参阅 Section 5.8), 
因为 如 果 没有 它 的 话 ， 我 们 就 很 难说 明 一 行 来 自 哪 个 独立 的 表 。 tableoid 可 以 

和 pg_class 的 oid 字段 连接 起 来 获取 表 名 字 。 

xmin 

插入 该 行 版 本 的 事务 标识 (事务 ID)。 注 意 : 在 这 个 环境 里 ， 一 个 行 版 本 是 一 行 的 一 个 状态 ; 
一 行 的 每 次 更 新 都 为 同一 个 逻辑 行 创建 一 个 新 的 行 版 本 。 


cmin 


在 插入 事务 内 部 的 命 合 标 识 ( 从 需 开 始 )。 

删除 事务 的 标识 (事务 ID)， 如 果 不 是 被 删除 的 行 版 本 ， 那 么 是 需 。 在 一 个 可 见 行 版 本 里 ， 这 
个 字段 有 可 能 是 非 雳 。 这 通常 意味 着 删除 事务 还 没有 提交 ， 或 者 是 一 个 删除 的 企图 被 回 滚 掉 
了 。 


cmax 


删除 事务 内 部 的 命令 标识 符 ， 或 者 是 雳 。 


ctid 


一 个 行 版 本 在 它 所 处 的 表 内 的 物理 位 置 。 请 注意 ， 尽 管 ctid 可 以 用 于 非常 快速 地 定位 行 版 
本 ， 但 每 次 vacuum FULL 之 后 ， 一 个 行 的 ctid 都 会 被 更 新 或 者 移动 。 因 此 ctid 是 不 能 作为 
长 期 的 行 标 识 符 的 。 应 该 使 用 OID ， 或 者 更 好 是 用 户 定义 的 序列 号 ， 来 标识 一 个 逻辑 行 。 


OID 是 32 位 的 量 ， 是 在 同一 个 集群 内 通用 的 计数 器 上 赋值 的 。 对 于 一 个 大 型 或 者 长 时 间 使 用 
的 数据 库 ， 这 个 计数 器 是 有 可 能 重合 的 。 因 此 ， 假定 OID 唯 一 是 非常 错误 的 ， 除 非 你 自己 采 
取 了 措施 来 保证 它们 是 唯一 的 。 如 果 你 需要 标识 表 中 的 行 ， 我 们 强烈 建议 使 用 序列 号 生成 
器 。 不 过 ， 也 可 以 使 用 OID， 只 要 采取 几 个 注意 事项 即 可 : 


。 在 使 用 OID 标 识 行 的 每 个 表 的 OID 字 段 创 建 一 个 唯一 约束 。 在 唯一 约束 (或 者 唯一 索引 ) 存 
在 的 时 候 ， 系统 会 注意 不 去 生成 一 个 和 现 有 行 相同 的 OID。 当 然 ， 只 有 在 表 中 的 数据 行 
少 于 2<sup class="calibre28">32</sup> (40 亿 ) 行 的 时 候 才 是 可 能 的 ， 而 实际 上 表 中 的 行 
最 好 远 比 这 个 小 ， 要 不 性 能 就 会 受 影响 了 。 


。 绝对 不 要 假设 OIDs 是 跨 表 唯一 的 ; 如 果 你 需要 全 数据 库 范 围 内 的 标识 ， 请 使 
用 tableoid 和 行 的 OID 的 组 合 。 


。 需要 OID 的 表 应 该 带 着 with orms 创建 。 从 PostgreSQL 8.1 开 始 ， without oros 是 缺 省 
的 。 


事务 标识 符 也 是 32 位 的 量 。 在 长 时 间 运 转 的 数据 库 里 ， 它 也 可 能 会 重 亚 。 只 要 我 们 采取 一 些 
合适 的 维护 步 又， 这 并 不 是 很 要 命 的 问题 ; 参阅 Chapter 23 获取 细节 。 不 过 ， 在 长 时 间 运 行 
的 环境 里 (超过 十 亿 次 事务 ) 依 赖 事务 ID 的 唯一 性 并 非 明智 的 做 法 。 


命令 标识 符 也 是 32 位 的 量 。 这 样 就 在 一 个 事务 里 有 2<sup class="calibre28">32</sup>( 四 十 

亿 ) 条 SQL 命令 的 硬 限制 。 在 现实 里 这 个 限制 应 该 不 是 什么 问题 ， 需 要 注意 的 是 这 个 限制 是 

SQL 命令 的 条 数 ， 而 不 是 义理 的 行 版 本 的 条 数 。 而 且 ， 自 PostgreSQL 8.3 起 ， 只 有 真正 修改 
数据 库 内 容 的 命令 才 会 消耗 一 个 命令 标识 符 。 


5.5. 修改 表 


如 果 你 创建 了 一 个 表 后 发 现 自己 犯 了 一 个 错误 ， 或 者 是 应 用 的 需求 发 生 了 变化 ， 那么 你 可 以 
删除 这 个 表 然 后 重新 创建 它 。 但 是 如 果 这 个 表 已 经 填充 了 许多 数据 ， 或 者 该 表 已 经 被 其 它 数 
据 库 对 象 引 用 (比如 一 个 外 键 约束 )， 那 这 可 不 是 一 个 方便 的 方法 。 因此 PostgreSQL 提 供 了 一 
族 命令 用 于 修改 现 有 表 。 请 注意 它 在 概念 上 和 修改 一 个 表 中 包含 的 数据 是 不 一 祥 的 : 这 里 我 
们 感 兴趣 的 是 修改 一 个 表 的 定义 ， 或 者 说 结构 。 


你 可 以 : 

。 增加 字段 

。 删除 字段 

。 增加 约束 

。 删除 约束 

。 修改 缺 省 值 

。 修改 字段 数据 类 型 
。 重 命名 字段 

。 EMAR 


所 有 这 些 动作 都 是 用 ALTER TABLE 命 令 执 行 的 ， 它 的 参考 页 面包 含 超出 这 里 给 出 的 详细 信 


VENO 


5.5.1. 增加 字段 
要 增加 一 个 字段 ， 使 用 下 面 这 样 的 命令 : 


ALTER TABLE products ADD COLUMN description text; 


新 增 的 字段 对 于 表 中 已 经 存在 的 行 而 言 最 初 将 先 填充 所 给 出 的 缺 省 值 (如 果 你 没有 声 
BA DEFAULT 子 句 ， 那 么 缺 省 是 NULL)。 


你 也 可 以 同时 在 该 字段 上 定义 约束 ， 使 用 通常 的 语法 : 


ALTER TABLE products ADD COLUMN description text CHECK (description <> ''); 


实际 上 ， 所 有 在 create TABLE 里 描述 的 可 以 应 用 于 字段 的 选项 都 可 以 在 这 里 使 用 。 不 过 ， 我 
们 要 注意 的 是 缺 省 值 必须 满足 给 出 的 约束 ， 否 则 App 将 会 失败 。 另 外 ， 你 可 以 在 正确 填充 了 
新 字段 的 数值 之 后 再 增加 约束 ( 见 下 文 )。 





Tip: 添加 一 个 字段 并 填充 缺 省 值 将 会 导致 更 新 表 中 的 所 有 行为 了 存储 新 字段 的 值 )， 但 
如 果 没 有 声明 缺 省 值 ，PostgreSQL 就 可 以 避免 物理 更 新 。 所 以 如 果 你 将 要 在 新 字段 中 填 
充 的 值 大 多 数 都 不 等 于 缺 省 值 ， 那么 最 好 添加 一 个 没有 缺 省 值 的 字段 ， 然 后 再 使 

用 uppate 更 新 数据 ， 最 后 使 用 下 面 的 方法 添加 缺 省 值 。 








5.5.2. 删除 字段 
EaR-TEH, WAFERS : 


ALTER TABLE products DROP COLUMN description; 


不 管 字 段 里 有 哈 数 据 ， 都 会 消失 ， 和 这 个 字段 相关 的 约束 也 会 被 删除 。 不 过 ， 如 果 这 个 字段 
被 另 一 个 表 的 外 键 约束 所 引用 ，PostgreSQL 则 不 会 隐 含 地 删除 该 约束 。 你 可 以 通过 使 
用 cascape 指明 删除 任何 依赖 该 字段 的 东西 : 


ALTER TABLE products DROP COLUMN description CASCADE; 


参阅 Section 5.12 获 取 有 关 这 些 操作 背后 的 机 制 的 信息 。 


5.5.3. 增加 约束 
要 增加 一 个 约束 ， 必 须 使 用 表 约 束 语法 。 上 比如 : 


ALTER TABLE products ADD CHECK (name <> ''); 
ALTER TABLE products ADD CONSTRAINT some_name UNIQUE (product_no); 
ALTER TABLE products ADD FOREIGN KEY (product_group_id) REFERENCES product_groups; 


要 增加 一 个 不 能 写成 表 约 束 的 非 空 约束 ， 使 用 下 面 的 语法 : 


ALTER TABLE products ALTER COLUMN product_no SET NOT NULL; 


这 个 约束 将 立即 进行 检查 ， 所 以 表 在 添加 约束 之 前 必须 符合 约束 条 件 。 


5.5.4. 删除 约束 


要 删除 一 个 约束 ， 你 需要 知道 它 的 名 字 。 如 果 你 鲁 经 给 了 它 取 了 名 字 ， 那么 事情 就 很 简单 。 
否则 你 就 需要 找 出 系统 自动 分 配 的 名 字 。 psql 的 命 兮 _tablename_ 可 以 帮 这 个 忙 ; BE 
接口 可 能 也 提供 了 检查 表 的 细节 的 方法 。 然 后 就 是 这 条 命 $e 


ALTER TABLE products DROP CONSTRAINT some_name; 


有 效 的 标识 符 。 


和 删除 字段 一 样 ， 如 果 你 想 删 除 被 依赖 的 约束 ， 你 需要 用 cAscApE 。 一 个 例子 是 某 个 外 键 约 
束 依 赖 被 引用 字段 上 的 唯一 约束 或 者 主键 约束 。 


除了 非 空 约束 外 ， 所 有 约束 类 型 都 这 么 用 。 要 删除 非 空 约束 ， 可 以 这 样 : 


ALTER TABLE products ALTER COLUMN product_no DROP NOT NULL; 


要 记得 非 空 约束 没有 名 字 。 


5.5.5. 改变 字段 的 缺 省 值 
要 给 一 个 字段 设置 缺 省 值 ， 可 以 使 用 一 个 像 下 面 这 样 的 命令 : 


ALTER TABLE products ALTER COLUMN price SET DEFAULT 7.77; 


请 注意 这 么 做 不 会 影响 任何 表 中 现 有 的 数据 行 ， 它 只 是 为 将 来 的 INSERT 命令 改变 缺 省 值 。 
要 删除 缺 省 值 ， 可 以 用 : 


ALTER TABLE products ALTER COLUMN price DROP DEFAULT; 


这 样 实 际 上 相当 于 把 缺 省 设置 为 空 。 结 果 是 ， 如 果 我 们 删除 一 个 还 没有 定义 的 缺 省 值 不 算 错 
误 ， 因 为 缺 省 隐 含 就 是 NULL。 


5.5.6. 修改 字段 的 数据 类 型 
把 一 个 字段 转换 成 另外 一 种 数据 类 型 ， 使 用 下 面 的 命令 


ALTER TABLE products ALTER COLUMN price TYPE numeric(10,2); 


只 有 在 字段 里 现 有 的 每 个 项 都 可 以 隐 含 的 转换 成 新 类 型 时 才 可 能 成 功 。 如 果 需 要 更 复杂 的 转 
换 ， 你 可 以 增加 一 个 usine 子 句 ， 它 声明 如 何 从 旧 值 里 计算 新 值 。 


PostgreSQL 将 试图 把 字段 的 缺 省 值 ( 如 果 存 在 ) 转 换 成 新 的 类 型 ， 还 有 涉及 该 字段 的 任何 约 
束 。 但 是 这 些 转换 可 能 失败 ， 或 者 可 能 生成 奇怪 的 结果 。 在 修改 某 字段 类 型 之 前 ， 你 最 好 删 
除 那 些 约 束 ， 然 后 再 把 合适 的 约束 添加 上 去 。 


5.5.7. 重 命 名 字段 
重 命 名 一 个 字段 : 


ALTER TABLE products RENAME COLUMN product_no TO product_number; 


5.5.8. 重 命 名 表 
重 命名 一 个 表 : 


ALTER TABLE products RENAME TO items; 


5.6. 权限 


当 创 建 一 个 数据 库 对 象 时 ， 它 就 被 赋予 了 所 有 者 。 这 个 所 有 者 通常 是 执行 创建 语句 的 角色 。 
对 大 多 数 类 型 的 对 象 ， 初 始 状 态 只 有 其 所 有 者 (或 者 超级 管理 员 ) 可 以 对 它 做 任何 事情 。 要 
允许 其 他 和 角色 使 用 它 ， 必 须要 经 过 权限 授予 。 


有 好 多 种 不 同 的 权限 : SELECT, INSERT , UPDATE , DELETE , TRUNCATE , REFERENCES , 
TRIGGER , CREATE , CONNECT , TEMPORARY , EXECUTE , 和 USAGE 。 适 用 于 特定 对 象 的 权限 因 
对 象 类 型 ( 表 / 男 数 等 ) 不 同 而 不 同 。 有 关 PostgreSQL 所 支持 的 不 同类 型 的 权限 的 完整 信息 ， 
请 参考 GRANT 的 手册 页 。 下 面 的 章节 将 为 你 展示 如 何 利 用 这 些 权 限 。 


修改 或 者 删除 一 个 对 象 的 权限 永远 是 所 有 者 独 有 的 权限 。 


一 个 对 象 可 以 用 ALTER 命令 以 适当 的 对 象 类 型 赋予 新 的 所 有 者 ， 例如 ALTER TABLE。 超 级 
用 户 总 是 可 以 这 么 做 ; 普通 用 户 只 有 在 他 同时 是 当前 对 象 的 所 有 者 (或 者 所 有 和 角色 的 一 个 成 
员 ) 和 新 所 有 者 角色 的 成 员 时 可 以 这 样 做 。 


使 用 GRANT 命令 赋予 权限 。 例 如 ， 如 果 joe 是 一 个 已 经 存在 的 用 户 ， 而 accounts 是 一 个 已 
经 存在 的 表 ， 更 新 表 的 权限 可 以 用 下 面 的 命令 赋予 : 


GRANT UPDATE ON accounts TO joe; 


在 权限 的 位 置 写 上 ALL 则 赋予 所 有 和 与 该 对 象 类 型 相关 的 权限 。 


名 为 PuL 的 特殊 "用 户 " 可 以 用 于 将 权限 赋予 系统 中 的 所 有 用 户 。 另外 ， 还 可 以 使 用 "组 " 角 
色 来 帮助 管理 一 群 用 户 的 权限 ， 细 节 可 参见 Chapter 20。 


可 以 使 用 revoke 命令 撤销 权限 : 


REVOKE ALL ON accounts FROM PUBLIC; 


对 象 所 有 者 的 特殊 权限 (也 就 是 DROP, GRANT, REVOKE 等 权限 ) 总 是 隐 合 地 属于 所 有 者 ， 并 且 
不 能 赋予 或 者 撤销 。 但 是 对 象 所 有 者 可 以 选择 撤销 自己 的 普通 权限 ， 上 比如 把 一 个 表 做 成 对 自 
己 和 别人 都 是 只 读 的 。 


最 初 ， 只 有 对 象 所 有 者 (或 者 超级 用 户 ) 可 以 赋予 或 者 撤销 对 象 的 权限 。 但 是 ， 我 们 可 以 赋予 
一 个 "with grant option" 权 限 ， 这 样 就 允许 接受 权限 的 人 将 该 权限 转 授 他 人 。 如 果 授 权 选 项 后 
来 被 撤销 ， 那 么 所 有 那些 从 这 个 接受 者 接受 了 权限 的 用 户 (直接 或 间 级 ) 都 将 失去 该 权限 。 细 
节 详 见 GRANT 和 REVOKE 手 册页 。 


5.7. 模式 


一 个 PostgreSQL 数 据 库 集群 包含 一 个 或 多 个 已 命名 数据 库 。 用 户 和 用 户 组 在 整个 集群 范围 内 
是 共享 的 ， 但 是 其 它 数据 并 不 共享 。 任何 与 服务 器 连接 的 客户 都 只 能 访问 那个 在 连接 请 求 里 
声明 的 数据 库 。 
Note: 集群 中 的 用 户 并 不 一 定 要 有 访问 集群 内 所 有 数据 库 的 权限 。 共 享用 户 名 的 意思 是 
不 能 有 重 名 用 户 。 假定 同一 个 集群 里 有 两 个 数据 库 和 一 个 joe 用 户 ， 系 统 可 以 配置 成 只 
允许 joe 访问 其 中 的 一 个 数据 库 。 








一 个 数据 库 包 含 一 个 或 多 个 已 命名 的 模式 ， 模 式 又 包含 表 。 模 式 还 可 以 包含 其 它 对 象 ， 包括 
数据 类 型 、 男 数 、 操 作 符 等 。 同 一 个 对 象 名 可 以 在 不 同 的 模式 里 使 用 而 不 会 导致 冲突 ; 比 
AN, schemal 和 myschema 都 可 以 包含 一 个 名 为 mytable 的 表 。 和 数据 库 不 同 ， 模 式 不 是 严格 
FEN: 只 要 有 权限 ， 一 个 用 户 可 以 访问 他 所 连接 的 数据 库 中 的 任意 模式 中 的 对 象 。 


我 们 需要 模式 的 原因 有 好 多 : 

。 人 允许 多 个 用 户 使 用 一 个 数据 库 而 不 会 干扰 其 它 用 户 。 

。 把 数据 库 对 象 组 织 成 逻辑 组 ， 让 它们 更 便于 管理 。 

。 第 三 方 的 应 用 可 以 放 在 不 同 的 模式 中 ， 这 样 它们 就 不 会 和 其 它 对 象 的 名 字 冲 突 。 
模式 类 似 于 操作 系统 层次 的 目录 ， 只 不 过 模式 不 能 启 套 。 


5.7.1. 创建 模式 
要 创建 一 个 模式 ， 使 用 CREATE SCHEMA 命 令 。 给 出 你 选择 的 模式 名 字 。 比 如 : 


CREATE SCHEMA myschema; 


要 创建 或 者 访问 在 模式 中 的 对 象 ， 写 出 一 个 受 修饰 的 名 字 ， 这 个 名 字 包 含 模式 名 以 及 表 名 ， 
它们 之 间 用 一 个 句点 分 开 : 


schema_._table 





这 个 方式 在 任何 需要 表 名 字 的 地 方 都 可 用 ， 包 括 后 面 章节 讨论 的 表 修 改 命令 和 数据 访问 命 
今 。 出 于 简化 ， 我 们 将 只 讨论 表 ， 这 个 概念 适用 于 所 有 其 它 已 命名 对 象 类 型 ， 比 如 数据 类 型 
AEE BX. 


实际 上 ， 更 一 般 的 语法 


_database_._schema_._table 





也 可 以 使 用 ， 但 目前 它 只 是 为 了 和 SQL 标准 形式 上 兼容 。 如 果 你 写 了 一 个 数据 库 名 ， 那么 它 
必须 和 你 当前 连接 的 数据 库 同名 。 


要 在 新 模式 里 创建 一 个 表 ， 用 


CREATE TABLE myschema.mytable ( 


J 
如 果 一 个 模式 是 空 的 (所 有 它 里 面 的 对 象 都 已 经 删除 )， 那 么 删除 一 个 模式 的 命 分 如 下 : 
DROP SCHEMA myschema; 


要 删除 一 个 模式 及 其 包含 的 所 有 对 象 ， 可 以 使 用 : 


DROP SCHEMA myschema CASCADE; 


参阅 Section 5.12 获 取 对 隐藏 在 这 些 动作 背后 的 东西 的 一 般 机 制 的 描述 。 


通常 你 想 创建 一 个 他 人 拥有 的 模式 (因为 这 是 一 种 限制 用 户 在 定义 良好 的 模式 中 的 活动 的 方 
法 )。 其 语法 如 下 : 


CREATE SCHEMA _schemaname_ AUTHORIZATION _username_; 


你 其 至 可 以 省 略 模 式 名 字 ， 这 时 模式 名 将 和 用 户 名 同名 。 人 参阅 Section 5.7.6 获 取 这 种 情况 的 适 
用 场合 。 


以 pg_ 开头 的 模式 名 是 保留 给 系统 使 用 的 ， 用 户 不 能 创建 这 样 的 名 字 。 
5.7.2. Public 模式 
在 前 面 的 小 节 里 ， 我 们 没有 声明 任何 模式 名 字 就 创建 了 表 。 缺 省 时 ， 这 样 的 表 ( 以 及 其 它 对 
象 ) 都 自动 放 到 一 个 叫做 "public" 的 模式 中 去 了 。 每 个 新 数据 库 都 包含 一 个 这 样 的 模式 。 因 此 ， 
下 面 的 命令 是 等 效 的 : 

CREATE TABLE products ( ... ); 
和 : 


CREATE TABLE public.products ( ... ); 


5.7.3. 模式 搜索 路 径 


全 称 的 名 字 写 起 来 非常 费劲 ， 并 且 我 们 最 好 不 要 在 点 用 里 直接 写 上 特定 的 模式 名 。 因 此 ， 表 
通常 都 是 用 未 修饰 的 名 字 引 用 的 ， 这 样 的 名 字 里 只 有 表 名 字 。 系统 通过 查找 一 个 搜索 路 径 来 
判断 一 个 表 究 竟 是 哪个 表 ， 这 个 路 径 是 一 个 需要 查找 的 模式 名 列表 。 在 搜索 路 径 里 找到 的 第 
一 个 表 将 被 使 用 。 如 果 在 搜索 路 径 中 没有 找到 表 ， 那 么 就 报告 一 个 错误 (即使 在 数据 库 里 的 其 
它 模 式 中 存在 此 表 也 如 此 )。 


在 搜索 路 径 中 的 第 一 个 模式 叫做 "当前 模式 "。 除 了 是 搜索 的 第 一 个 模式 之 外 ， CHE 
在 CREATE TABLE 没有 声明 模式 名 的 时 候 ， 新 建 表 的 默认 所 在 地 。 


要 显示 当前 搜索 路 径 ， 使 用 下 面 的 命令 : 


SHOW search_path; 


在 缺 省 的 设置 中 ， 返 回 下 面 的 东西 : 


Search_path 


"$user",public 
第 一 个 元 素 声明 搜索 和 当前 用 户 同名 的 模式 。 因 为 还 没有 这 样 的 模式 存在 ， 所 以 这 条 记录 被 
忽略 。 第 二 个 元 素 指向 我 们 已 经 看 过 的 公共 模式 。 


搜索 路 径 中 第 一 个 存在 的 模式 是 创建 新 对 象 的 缺 省 位 置 。 这 就 是 为 什么 缺 省 的 对 象 都 会 创建 
在 public 模式 里 的 原因 。 如 果 在 其 它 环境 中 引用 对 象 且 没 有 模式 修饰 ， 那 么 系统 会 通 历 搜索 
路 径 ， 直 到 找到 一 个 匹配 的 对 象 。 因此 ， 在 缺 省 的 配置 里 ， 任 何 未 修饰 的 访问 只 能 引用 
public 模式 。 


要 设置 模式 的 搜索 路 径 ， 可 以 用 (省 略 了 $user 是 因为 并 不 立即 需要 它 ) 
SET search_path TO myschema, public; 
然后 我 们 就 可 以 不 使 用 模式 修饰 来 访问 表 了 : 


DROP TABLE mytable; 


同样 ， 因 为 myschema 是 路 径 中 的 第 一 个 元 素 ， 新 对 象 缺 省 时 将 创建 在 这 里 。 
我 们 也 可 以 写成 : 


SET search_path TO myschema; 


然后 我 们 如 果 不 明 确 修 饰 的 话 ， 就 不 能 再 访问 public RAT. public 模式 没有 任何 特殊 之 
处 ， 只 不 过 它 缺 省 时 就 存在 。 我 们 也 可 以 删除 它 。 


又 见 Section 9.25 以 获取 其 它 操 作 模式 搜索 路 径 的 方法 。 


搜索 路 径 对 于 数据 类 型 名 、 画 数 名 、 操 作 符 名 的 运作 方式 和 表 名 完全 相同 。 数据 类 型 和 画 数 
名 可 以 像 表 名 一 样 加 以 修饰 。 如 果 你 需要 在 表达 式 里 写 一 个 有 模式 修饰 的 操作 符 ， 你 必须 这 


LB: 


OPERATOR(_schema_._operator_) 


这 样 是 为 了 避免 语法 歧义 。 下 面 是 一 个 例子 : 


SELECT 3 OPERATOR(pg_catalog.+) 4; 


Se Be P Ek (71388 FS OR RSE EF REA, RRMA SROARAN AAT. 


5.7.4. 模式 和 权限 


缺 省 时 ， 用 户 无 法 访问 模式 中 不 属于 他 们 所 有 的 对 象 。 为 了 让 他 们 能 够 访问 ， 模式 的 所 有 者 
需要 在 模式 上 赋予 他 们 usace 权限 。 为 了 让 用 户 使 用 模式 中 的 对 象 ， 我 们 可 能 需要 赋予 适合 
该 对 象 的 额外 权限 。 


用 户 也 可 以 在 别人 的 模式 里 创建 对 象 。 要 人 允许 这 么 做 ， 需 要 被 赋予 在 该 模式 上 的 CREATE 权 
限 。 请 注意 ， 缺 省 时 每 个 人 都 在 public 模式 上 有 create 和 usace 权限 。 这 样 就 允许 所 有 可 
以 连接 到 指定 数据 库 上 的 用 户 在 这 里 创建 对 象 。 如 果 你 不 打算 这 么 做 ， 可 以 撤销 这 个 权限 : 


REVOKE CREATE ON SCHEMA public FROM PUBLIC; 


第 一 个 "public" 是 模式 ， 第 二 个 "public" 意 思 是 "所 有 用 户 "。 第 一 句 里 它 是 个 标识 符 ， 而 第 二 和 句 
里 是 个 关键 字 ， 所 以 有 不 同 的 大 小 写 。 记 住 我 们 在 Section 4.1.1 里 面 说 过 的 原则 。 


5.7.5. 系统 表 模 式 


除了 public 和 用 户 创建 的 模式 之 外 ， 每 个 数据 库 都 包含 一 个 pg_catalog 模式 ， 它 包 含 系统 
RAMANA BAD, WA. REA. pg_catalog 总 是 搜索 路 径 中 的 一 部 分 。 如 果 它 没 
明确 出 现在 路 径 中 ， 那 么 它 隐 含 地 在 所 有 路 径 之 前 搜索 。 这 样 就 保证 了 内 置 名 字 总 是 可 以 被 
搜索 。 不 过 ， 你 可 以 明确 地 把 pg_catalog 放 在 搜索 路 径 之 后 ， 如 果 你 想 使 用 用 户 自 定义 的 名 
字 履 盖 内 置 的 名 字 的 话 。 


在 PostgreSQL 版 本 7.3 ZAI, Lh pg 开头 的 表 名 字 是 保留 的 。 这 个 规则 现在 不 正确 了 : 如 果 
必要 ， 你 可 以 创建 这 样 的 表 名 字 ， 只 要 是 在 非 系统 模式 里 。 不 过 ， 我 们 最 好 还 是 不 要 使 用 这 
样 的 名 字 ， 以 保证 自己 将 来 不 会 和 新 版 本 冲突 : 那些 版 本 也 许 会 定义 一 些 和 你 的 表 同 名 的 表 
(在 缺 省 搜索 路 径 中 ， 一 个 对 你 的 表 的 无 修饰 引用 将 解析 为 系统 表 )。 系统 表 将 继续 遵循 

以 pg_ 开头 的 传统 ， 因 此 ， 只 要 你 的 表 不 是 以 po FA, 就 不 会 和 无 修饰 的 用 户 表 名 字 冲 


突 。 


5.7.6. 使 用 方式 


模式 可 以 用 多 种 方式 组 织 数据 。 下 面 是 一 些 建议 使 用 的 模式 ， 它 们 也 很 容易 在 缺 省 配置 中 得 
到 支持 : 


。 如 果 没 有 创建 任何 模式 ， 那 么 所 有 用 户 隐 含 都 访问 public 模式 。 这 样 就 模拟 了 没有 模式 
的 时 候 的 情景 。 这 种 设置 建议 主要 用 在 只 有 一 个 用 户 或 者 数据 库 里 只 有 几 个 可 信用 户 的 
情形 。 这 样 的 设置 也 允许 我 们 平滑 地 从 无 模式 的 环境 过 渡 。 


。 你 可 以 为 每 个 用 户 创建 一 个 模式 ， 名 字 和 用 户 相 同 。 要 记得 缺 省 的 搜索 路 径 从 $user F 
i, 它 会 解析 为 用 户 名 。 因 此 ， 如 果 每 个 用 户 都 有 一 个 独立 的 模式 ， 那 么 他 们 缺 省 时 访 
问 他 们 自己 的 模式 。 


如 果 你 使 用 了 这 样 的 设置 ， 那 么 你 可 能 还 想 撤 销 对 public 模式 的 访问 (或 者 删除 它 )， 这 
样 ， 用 户 就 真 的 限制 于 他 们 自己 的 模式 了 。 


。 要 安装 共享 的 应 用 (被 所 有 人 使 用 的 表 、 第 三 方 提供 的 额外 函数 等 等 )， 我们 可 以 把 它们 
放 到 独立 的 模式 中 。 只 要 记得 给 需要 访问 它们 的 用 户 赋予 合适 的 权限 就 可 以 了 。 然后 用 
户 就 可 以 通过 用 一 个 模式 名 修饰 来 使 用 这 些 额外 的 对 象 ， 或 者 他 们 可 以 把 额外 的 模式 放 
到 他 们 的 搜索 路 径 中 。 


5.7.7. 移植 性 


在 SQL 标准 里 ， 在 同一 个 模式 里 的 对 象 被 不 同 的 用 户 所 有 的 概念 是 不 存在 的 。 而 且 ， 有 些 实 
现 不 允许 你 创建 和 它们 的 所 有 者 不 同名 的 模式 。 实 际 上 ， 模式 的 概念 和 用 户 在 那些 只 实现 了 
标准 中 规定 的 基本 模式 支持 的 数据 库 系 统 里 几乎 是 一 样 的 。 因此 ， 许 多 用 户 考虑 对 名 字 加 以 
修饰 ， 使 它们 真正 由 _username_. _tablename ”组 成 。 如 果 你 为 每 个 用 户 都 创建 了 一 个 模式 ， 
这 实际 上 就 是 PostgreSQL 的 行为 。 


同样 ， 在 SQL 标准 里 也 没有 public 模式 的 概念 。 为 了 最 大 限度 地 遵循 标准 ， 你 不 应 该 使 用 
(可 能 甚至 是 应 该 删除 ) public 模式 。 

当然 ， 有 些 数 据 库 系统 可 能 根本 没有 模式 ， 或 者 是 通过 人 允许 跨 数 据 库 访问 来 提供 模式 的 功 
能 。 如 果 你 需要 在 这 些 系 统 上 干 活 ， 那 么 为 了 最 大 限度 的 移植 性 ， 应 该 根本 不 使 用 模式 。 


5.8. 继承 


PostgreSQL 实 现 了 表 继 承 ， 这 个 特性 对 数据 库 设 计 人 员 来 说 是 一 个 很 有 效 的 工具 。SQL99 
及 以 后 的 标准 定义 了 类 型 继承 特性 ， 和 我 们 在 这 里 描述 的 很 多 特性 有 区 别 。 

让 我 们 从 一 个 例子 开始 : a Ai E 每 个 州都 有 许多 城市 ， 但 是 
只 有 一 个 首府 。 我 们 希望 能 够 迅速 检索 任何 州 的 首府 。 这 个 任务 可 以 通过 创建 两 个 表 来 实 

现 ， 一 个 是 州 府 表 ， 一 个 是 非 州 府 表 。 不 过 ， oe 什么 城市 都 想 查 该 怎么 办 ? 继承 
的 特性 可 以 帮助 我 们 解决 这 个 问题 。 我 们 定义 capitals R, 它 继承 自 cities 表 : 


CREATE TABLE cities ( 


name text, 
population float, 
altitude int -- 英尺 


); 

CREATE TABLE capitals ( 
state char (2) 

) INHERITS (cities); 


在 这 种 情况 下 ， capitals 表 继 承 它 的 父 表 cities 中 的 所 有 属性 。 州 首府 有 一 个 额外 

的 state 属性 显示 其 所 在 的 州 。 

在 PostgreSQL 里 ， 一 个 表 可 以 从 需 个 或 多 个 其 它 表 中 继承 属性 ， 而 且 一 个 查询 既 可 以 引用 一 
个 表 中 的 所 有 行 ， 也 可 以 引用 一 个 表 及 其 所 有 后 代表 的 行 (后 面 这 个 是 缺 省 行为 )。 上 比如 ， 下 
面 的 查询 查找 所 有 海拔 500 英尺 以 上 的 城市 名 ， 包 括 州 首府 : 


SELECT name, altitude 
FROM cities 
WHERE altitude > 500; 


使 用 PostgreSQL 教 程 里 面 的 数据 (参阅 Section 2.1)， 它 返回 : 


name | altitude 
a Sisk a eisai eer ete 
Las Vegas | 2174 
Mariposa | 1953 
Madison | 845 


另 一 方面 ， 如 果 要 找 出 不 包括 州 首 府 的 所 有 海拔 超过 500 英尺 的 城市 ， 查 询 应 该 是 这 样 的 : 


SELECT name, altitude 
FROM ONLY cities 
WHERE altitude > 500; 


name l altitude 


Las Vegas i 2174 
Mariposa | 1953 


cities 前 面 的 oNLY 表明 该 查询 应 该 只 针对 cities 而 不 包括 其 后 代 。 许 多 我 们 已 经 讨论 过 
的 命令 ( SELECT , UPDATE 和 DELETE ) 都 支持 ony 关键 字 。 


你 也 可 以 在 表 名 后 面 写 一 个 * 显示 指定 包括 所 有 后 代表 : 


SELECT name, altitude 
FROM cities* 
WHERE altitude > 500; 


因为 这 个 行为 是 默认 的 ， 所 以 写 * 并 不 是 必须 的 (除非 你 已 经 改变 了 sql_inheritance 里 面 的 
配置 选项 ) o Am, S* 可 以 用 于 强调 搜索 额外 的 表 。 


有 时 候 你 可 能 想 知道 某 个 行 版 本 来 自 哪 个 表 。 在 每 个 表 里 我 们 都 有 一 个 tableoid 系统 属性 可 
告诉 你 源 表 是 谁 : 


SELECT c.tableoid, c.name, c.altitude 
FROM cities c 
WHERE c.altitude > 500; 


结果 如 下 (你 可 能 会 得 到 不 同 的 OID) : 


tableoid | name | altitude 
ee ae A L ie Spe A E 
139793 | Las Vegas | 2174 
139793 | Mariposa | 1953 
139798 | Madison | 845 


通过 和 pg_class 做 一 个 连接 ， 就 可 以 看 到 实际 的 表 名 字 : 


SELECT p.relname, c.name, c.altitude 
FROM cities c, pg_class p 
WHERE c.altitude > 500 AND c.tableoid = p.oid; 


它 返 回 : 
relname | name | altitude 
See A SP pe ene ee ene Neen ere cee en re 
cities | Las Vegas | 2174 
cities | Mariposa | 1953 
capitals | Madison | 845 


对 于 INSERT 或 copy ， 继 承 并 不 自动 影响 其 后 代表 。 在 我 们 的 例子 里 ， 下 面 的 insert 语句 
将 会 失败 : 


INSERT INTO cities (name, population, altitude, state) 
VALUES ('New York', NULL, NULL, 'NY'); 


我 们 可 能 希望 数据 被 传递 到 capitals 表 里 面 去 ， 但 这 是 不 会 发 生 的 : insert 总 是 插入 明确 
声明 的 那个 表 。 在 某 些 情况 下 ， 我 们 可 以 使 用 规则 进行 重 定向 插入 (参阅 Chapter 38)。 不 过 
它 不 能 对 上 面 的 例子 有 什么 帮助 ， 因为 cities 表 并 不 包含 state 字段 ， 因此 命令 在 规则 施 
加 之 前 就 会 被 拒绝 掉 。 


所 有 父 表 的 检查 约束 和 非 空 约束 都 会 自动 被 所 有 子 表 继承 。 不 过 其 它 类 型 的 约束 (唯一 、 主 
键 、 外 键 约束 ) 不 会 被 继承 。 


一 个 子 表 可 以 从 多 个 父 表 继承 ， 这 种 情况 下 它 将 拥有 所 有 父 表 字段 的 总 和 ， 并 且 子 表 中 定义 
的 字段 也 会 加 入 其 中 。 如 果 同 一 个 字段 名 出 现在 多 个 父 表 中 ， 或 者 同时 出 现在 父 表 和 子 表 的 
定义 里 ， 那 么 这 些 字段 就 会 被 "融合 "， 这 样 在 子 表 里 就 只 有 一 个 这 样 的 字段 。 要 想 融 合 ， 字 
段 的 数据 类 型 必须 相同 ， 否则 就 会 抛 出 一 个 错误 。 融 合 的 字段 将 会 拥有 其 父 字 段 的 所 有 检查 
约束 ， 并 且 如 果 某 个 父 字段 存在 非 空 约束 ， 那 么 融合 后 的 字段 也 必须 是 非 空 的 。 


表 继 承 通常 使 用 带 INHERITS 子 句 的 CREATE TABLE 语 名 定义。 另外 ， 一 个 已 经 用 此 方法 定 

义 的 子 表 可 以 使 用 带 INHERIT 的 ALTER TABLE 命令 添加 一 个 新 父 表 。 注 意 : 该 子 表 必 须 已 经 
包含 新 父 表 的 所 有 字段 且 类 型 一 致 ， 此 外 新 父 表 的 每 个 约束 的 名 字 及 其 表达 式 都 必须 包含 在 

此 子 表 中 。 同 样 ， 一 个 继承 链 可 以 使 用 带 No INHERIT 的 ALTER TABLE 命令 从 子 表 上 删除 。 人 允 
许 动 态 添 加 和 删除 继承 链 对 基于 继承 关系 的 表 分 区 (参见 Section 5.9) 很 有 用 。 


创建 一 个 将 要 作为 子 表 的 新 表 的 便利 途径 是 使 用 带 LIKE 子 句 的 CREATE TABLE 命令 。 它 将 创 
建 一 个 与 源 表 字段 相同 的 新 表 。 如 果 源 表 中 存在 约束 ， 那 么 应 该 指 
定 LIKE 的 INCLUDING CONSTRAINTS 选项 ， 因 为 子 表 必 须 包 含 源 表 中 的 chEcK 约束 。 


任何 存在 子 表 的 父 表 都 不 能 被 删除 ， 同 样 ， 子 表 中 任何 从 父 表 继 承 的 字段 或 约束 也 不 能 被 删 
除 或 修改 。 如 果 你 想 删 除 一 个 表 及 其 所 有 后 代 ， 最 简单 的 办 法 是 使 用 cAscApE 选项 删除 父 
表 。 


ALTER TABLE 会 把 所 有 数据 定义 和 检查 约束 传播 到 后 代 里 面 去 。 另 外 ， 只 有 在 使 
用 cascade 选项 的 情况 下 ， 才 能 删除 依赖 于 其 他 表 的 字段 。 ALTER TABLE 在 重复 字段 融合 和 
拒绝 方面 和 cREATE TABLE 的 规则 相同 。 


请 注意 表 访 问 权 限 是 如 何 处 理 的 。 访 问 父 表 会 自动 访问 在 子 表 中 的 数据 ， 而 不 需要 更 多 的 沪 
问 权限 检查 。 这 保留 了 父 表 中 数据 的 表现 。 然 而 ， 直 接 访问 子 表 不 会 自动 允许 访问 父 表 ， 要 
访问 父 表 需 要 更 进一步 的 权限 被 授予 。 


5.8.1. 警告 


注意 ， 不 是 所 有 的 SQL 命令 可 以 在 所 有 的 继承 层次 上 正常 工作 。 数 据 查 询 ， 数 据 修 改 ， 模式 
修改 的 命令 (比如 SELECT, UPDATE, DELETE, ALTER TABLE 的 大 多 数 变 型 ， 但 不 
是 INSERT 和 ALTER TABLE ... RENAME ) 典型 的 默认 包括 子 表 和 支持 oy 符号 来 排除 它们 。 


ABE EPR ees (GRO REINDEX , vacuum) 通常 只 对 个 别 工作 ， 物 理 表 格 不 支持 
递归 超过 继承 层次 结构 。 单 独 命令 各 自 的 行为 记录 在 了 它们 的 参考 页 中 (Reference |, SQL Ap 
B)o 

继承 的 一 个 严重 局 限 性 是 索引 (包括 唯一 约束 ) 和 外 键 约束 只 能 用 于 单个 表 ， 而 不 能 包括 它们 
的 子 表 ( 不 管 对 外 键 约束 的 引用 表 还 是 被 引用 表 都 是 如 此 )， 因 此 ， 在 上 面 的 例子 里 : 


e 即使 我 们 声明 cities . name 为 UNIQUE 或 PRIMARY KEY, 也 不 会 阻止 capitals 表 拥 有 重 
复 名 字 的 cities 数据 行 。 并 且 这 些 重复 的 行 在 查询 cities 表 的 时 候 会 显示 出 来 。 实 际 
+, RAN capitals 将 完全 没有 了 唯一 约束 ， 因 此 可 能 包含 带 有 同名 的 多 个 行 。 你 应 该 
给 capitals 增加 唯一 约束 ， 但 即使 这 样 做 也 不 能 避免 与 cities 的 重复 。 

name 参照 ( REFERENCES ) 某 些 其 它 的 表 ， 这 个 约束 也 


。 类 似 的 ， 即 使 我 们 声明 cities . 
不 会 自动 传播 到 capitals 表 。 在 这 种 条 件 下 ， 你 可 以 通过 手工 给 capitals 表 增 加 同样 
的 REFERENCES 约束 来 做 到 这 点 。 


声明 一 个 其 它 表 的 字段 为 REFERENCES cities(name) 将 人 允许 其 它 表 包含 城市 名 ， 但 是 不 包 
含 首府 名 。 这 种 情况 下 没有 很 好 的 绕 开 办 法 。 
这 些 缺 点 很 可 能 在 将 来 的 版 本 中 修补 ， 但 同时 你 也 需要 考虑 一 下 ， 继 承 是 否 对 你 的 应 用 真正 


有 用 。 


5.9. 分 区 


PostgreSQL 支 持 基本 的 表 分 区 功能 。 本 节 描 述 为 什么 需要 表 分 区 以 及 如 何在 数据 库 设 计 中 使 
用 表 分 区 。 


5.9.1. 概述 


分 区 的 意思 是 把 逻辑 上 的 一 个 大 表 分 割 成 物理 上 的 几 块 。 分 区 可 以 提供 若干 好 处 : 


。 某 些 类 型 的 查询 性 能 可 以 得 到 极 大 提升 。 特别 是 表 中 访问 率 较 高 的 行 位 于 一 个 单独 分 区 
或 少数 几 个 分 区 上 的 情况 下 。 分 区 可 以 减少 索引 体积 从 而 可 以 将 高 使 用 率 部 分 的 索引 存 
放 在 内 存 中 。 如 果 索 引 不 能 全 部 放 在 内 存 中 ， 那 么 在 索引 上 的 读 和 写 都 会 产生 更 多 的 磁 
hit Po 


。 当 查询 或 更 新 一 个 分 区 的 大 部 分 记录 时 ， 连续 扫描 那个 分 区 而 不 是 使 用 索引 离散 的 访问 
整个 表 可 以 获得 巨大 的 性 能 提升 。 


。 如 果 需 要 大 量 加 载 或 者 删除 的 记录 位 于 单独 的 分 区 上 ， 那么 可 以 通过 直接 读 取 或 删除 那 
个 分 区 以 获得 巨大 的 性 能 提升 ， 因为 ALTER TABLE NO INHERIT 和 prop TABLE 比 操作 大 量 
的 数据 要 快 的 多 。 这 些 命令 同时 还 可 以 避免 由 于 大 量 DELETE 导致 的 vacuum 超载 。 


。 很 少 用 的 数据 可 以 移动 到 便宜 一 些 的 慢 速 存储 介质 上 。 


这 种 好 处 通常 只 有 在 表 可 能 会 变 得 非常 大 的 情况 下 才 有 价值 。 到 底 多 大 的 表 会 从 分 区 中 收益 
取决 于 具体 的 应 用 ， 不 过 有 个 基本 的 拇指 规则 就 是 表 的 大 小 超过 了 数据 库 服 务 器 的 物理 内 存 
大 小 。 


目前 ，PostgreSQL 支 持 通 过 表 继 承 进行 分 区 。 每 个 分 区 必须 做 为 单独 一 个 父 表 的 子 表 进 行 创 
建 。 父 表 自 身 通常 是 空 的 ， 它 的 存在 只 是 为 了 代表 整个 数据 集 。 你 在 试图 实现 分 区 之 前 ， 应 
该 先 熟悉 继承 (参阅 Section 5.8)。 


PostgreSQL 可 以 实现 下 面 形式 的 分 区 : 
范围 分 区 


表 被 一 个 或 者 多 个 关键 字段 分 区 成 "范围 "， 这 些 范 围 在 不 同 的 分 区 里 没有 重 党 。 比如 ， 我 们 
可 以 通过 时 间 范 围 分 区 ， 或 者 根据 特定 业务 对 象 的 标识 符 范围 分 区 。 


列表 分 区 


表 通 过 明确 地 列 出 每 个 分 区 里 应 该 出 现 哪些 关键 字 值 实现 。 


5.9.2. 实现 分 区 


要 设置 一 个 分 区 的 表 ， 做 下 面 的 步骤 : 
1. 创建 " 主 表 "， 所 有 分 区 都 从 它 继承 。 


这 个 表 中 没有 数据 ， 不 要 在 这 个 表 上 定义 任何 检查 约束 ， 除 非 你 希望 约束 同样 也 适用 于 
所 有 分 区 。 同样 ， 在 其 上 定义 任何 索引 或 者 唯一 约束 也 没有 意义 。 


2. 创建 几 个 " 子 表 "， 每 个 都 从 主 表 上 继承 。 通 常 ， 这 些 表 不 会 增加 任何 字段 。 
我 们 将 把 子 表 称 作 分 区 ， 尽 管 它们 就 是 普通 的 PostgreSQL 表 。 

3， 给 分 区 表 增 加 约束 ， 定 义 每 个 分 区 人 允许 的 健 值 。 
典型 的 例子 是 : 


CHECK (x=1) 
CHECK ( county IN ( 'Oxfordshire', 'Buckinghamshire', 'Warwickshire' )) 
CHECK ( outletID &gt;= 100 AND outletID &lt; 200 ) 


确保 这 些 约束 能 够 保证 在 不 同 的 分 区 里 不 会 有 重 党 的 键 值 。 一 个 常见 的 错误 是 设置 下 面 
这 样 的 范围 : 


CHECK ( outletID BETWEEN 100 AND 200 ) 
CHECK ( outletID BETWEEN 200 AND 300 ) 


这 样 做 是 错误 的 ， 因 为 它 没 说 清楚 健 值 200 属于 那个 范围 。 
请 注意 在 范围 和 列表 分 区 的 语法 方面 没有 什么 区 别 ; 这 些 术语 只 是 用 于 描述 的 。 
其 


4， 对 于 每 个 分 区 ， 在 关键 字 字 段 上 创建 一 个 索引 ， 以 及 其 它 你 想 创 建 的 索引。 关键 字 字 段 
索引 并 非 严 格 必需 的 ， 但 是 在 大 多 数 情 况 下 它 是 很 有 帮助 的 。 如 果 你 希望 关键 字 值 是 唯 
一 的 ， 那 么 你 应 该 总 是 给 每 个 分 区 创建 一 个 唯一 或 者 主键 约束 。 


5， 另 外 ， 定 义 一 个 规则 或 者 触发 器 ， 来 重 定向 数据 插入 主 表 到 适当 的 分 区 。 


6， 确 保 postgresql.conf 里 的 配置 参数 constraint exclusion 是 打开 的 。 没有 这 个 参数 ， 查 
询 不 会 按照 需要 进行 优化 。 


比如 ， 假 设 我 们 为 一 个 巨大 的 冰激凌 公司 构造 数据 库 。 该 公司 每 天 都 测量 最 高 温度 ， 以 及 每 
个 地 区 的 冰激凌 销售 。 概 念 上 ， 我 们 需要 一 个 这 样 的 表 : 


CREATE TABLE measurement ( 


city_id int not null, 
logdate date not null, 
peaktemp int, 


unitsales int 


我 们 知道 大 多 数 查询 都 只 会 访问 最 后 一 周 ， 最 后 一 个 月 或 者 最 后 一 个 季度 的 数据 ， 因为 这 个 
表 的 主要 用 途 是 为 管理 准备 在 线 报 告 。 为 了 减少 需要 存储 的 旧 数 据 ， 我 们 决定 值 保留 最 近 
年 的 有 用 数据 。 在 每 个 月 的 开头 ， 我 们 都 会 删除 最 旧 的 一 个 月 的 数据 。 


在 这 种 情况 下 ， ee 来 帮助 实现 所 有 对 表 的 不 同 需求 。 下 面 的 步骤 描述 了 上 面 
的 需求 ， 分 区 可 以 这 样 设 


ERE measurement R, MRHAR AE. 
然后 我 们 为 每 个 月 创建 一 个 分 区 


CREATE TABLE measurement_y2006m02 
CREATE TABLE measurement_y2006m03 


INHERITS (measurement); 
INHERITS (measurement); 


一 一 
Vw 


CREATE TABLE measurement_y2007m1i1 
CREATE TABLE measurement_y2007m12 
CREATE TABLE measurement_y2008m01 


INHERITS (measurement); 
INHERITS (measurement); 
INHERITS (measurement); 


一 一 一 
wer wv 


每 个 分 区 都 是 拥有 自己 内 容 的 完整 的 表 ， 只 是 它们 从 measurement 表 继 承 定义 。 


这 样 就 解决 了 我 们 的 一 个 问题 : 删除 旧 数 据 。 每 个 月 ， 我 们 需要 做 的 只 是 在 最 旧 的 子 表 
上 执行 一 个 prop TABLE ， 然后 为 新 月 份 创 建 一 个 新 的 子 表 。 


3. 我 们 必须 提供 非 重 县 的 表 约 束 。 而 不 是 只 像 上 面 那样 创建 分 区 表 ， 所 以 我 们 的 建 表 脚 本 


CREATE TABLE measurement_y2006m02 ( 

CHECK ( logdate &gt;= DATE '2006-02-01' AND logdate &lt; DATE '2006-03-01' ) 
) INHERITS (measurement); 
CREATE TABLE measurement_y2006m03 ( 

CHECK ( logdate &gt;= DATE '2006-03-01' AND logdate &lt; DATE '2006-04-01' ) 
) INHERITS (measurement); 


CREATE TABLE measurement_y2007m11 ( 

CHECK ( logdate &gt;= DATE '2007-11-01' AND logdate &lt; DATE '2007-12-01' ) 
) INHERITS (measurement); 
CREATE TABLE measurement_y2007m12 ( 

CHECK ( logdate &gt;= DATE '2007-12-01' AND logdate &lt; DATE '2008-01-01' ) 
) INHERITS (measurement); 
CREATE TABLE measurement_y2008m01 ( 

CHECK ( logdate &gt;= DATE '2008-01-01' AND logdate &lt; DATE '2008-02-01' ) 
) INHERITS (measurement); 


4. 我们 可 能 还 需要 在 关键 字 字 段 上 有 索引 : 


CREATE INDEX measurement_y2006m02_logdate ON measurement_y2006m02 (logdate); 
CREATE INDEX measurement_y2006m03_logdate ON measurement_y2006m03 (logdate); 


CREATE INDEX measurement_y2007m11_logdate ON measurement_y2007m11 (logdate); 


CREATE INDEX measurement_y2007m12_logdate ON measurement_y2007m12 (logdate); 
CREATE INDEX measurement_y2008m01_logdate ON measurement_y2008m01 (logdate); 


我 们 选择 先 不 建立 更 多 的 索引 。 


5. 我 们 想 让 我 们 的 应 用 可 以 说 Insert INTO measurement ..， 并 且 数 据 被 重 定向 到 相应 的 分 
区 表 。 我 们 可 以 安排 给 主 表 附 上 一 个 合适 的 触发 器 。 如 果 数 据 只 进入 最 新 的 分 区 ， 我 们 
可 以 使 用 一 个 非常 简单 的 触发 器 : 


CREATE OR REPLACE FUNCTION measurement_insert_trigger() 
RETURNS TRIGGER AS $$ 
BEGIN 
INSERT INTO measurement_y2008m01 VALUES (NEW.*); 
RETURN NULL; 
END; 


LANGUAGE plpgsql; 


NEHA, Rite] 2—7Ti8 Bag A aS RAR R aS : 


CREATE TRIGGER insert_measurement_trigger 
BEFORE INSERT ON measurement 
FOR EACH ROW EXECUTE PROCEDURE measurement_insert_trigger(); 


我 们 必须 每 月 重新 定义 触发 器 ， 以 便 它 总 是 指向 当前 分 区 。 然 而 ， 触 发 定义 不 需要 更 
新 。 


我 们 可 能 想 插 入 数据 并 且 想 让 服务 器 自动 定位 应 该 向 哪个 分 区 插入 数据 。 我 们 可 以 用 下 
面 这 个 复杂 的 触发 器 来 实现 这 个 目标 ， 上 比如 : 


CREATE OR REPLACE FUNCTION measurement_insert_trigger() 
RETURNS TRIGGER AS $$ 
BEGIN 
IF ( NEW.logdate &gt;= DATE '2006-02-01' AND 
NEW.logdate &lt; DATE '2006-03-01' ) THEN 
INSERT INTO measurement_y2006m02 VALUES (NEW.*); 
ELSIF ( NEW.logdate &gt;= DATE '2006-03-01' AND 
NEW.logdate &lt; DATE '2006-04-01' ) THEN 
INSERT INTO measurement_y2006m03 VALUES (NEW.*); 


ELSIF ( NEW.logdate &gt;= DATE '2008-01-01' AND 
NEW.logdate &lt; DATE '2008-02-01' ) THEN 
INSERT INTO measurement_y2008m01 VALUES (NEW.*); 
ELSE 
RAISE EXCEPTION 'Date out of range. Fix the measurement_insert_trigger() fur 
END IF; 
RETURN NULL; 
END; 
$$ 
LANGUAGE plpgsql; 


es 





每 一 个 触发 器 跟 以 前 一 样 。 注 意 ， 每 一 个 IF 测试 必须 匹配 其 分 区 的 cueck ARo 


当 这 个 函数 比 单 月 的 情况 更 复杂 时 ， 它 不 需要 经 常 的 更 新 ， 因 为 分 支 可 以 在 需要 之 前 被 
添加 。 


> Note: 在 实践 中 ， 如 果 大 部 分 插入 该 分 区 ， 它 可 能 最 好 首先 检查 最 新 分 区 。 为 简单 起 
见 ， 我 们 已 经 在 这 个 例子 中 的 其 他 部 分 表明 在 同一 顺序 下 的 触发 器 的 测试 。 


我 们 可 以 看 出 ， 一 个 复杂 的 分 区 方案 可 能 要 求 相当 多 的 DDL 。 在 上 面 的 例子 里 我 们 需要 每 个 
月 创建 一 次 新 分 区 ， 因此 写 一 个 脚本 自动 生成 需要 的 DDL 是 明智 的 。 


5.9.3. 管理 分 区 


通常 分 区 集 在 定义 表 的 时 候 就 已 经 确定 了 ， 但 我 们 常常 需要 周期 性 的 删除 旧 分 区 并 添加 新 分 
区 。 分 区 最 重要 的 好 你 是 它 能 恰到好处 的 适应 这 个 需求 : 以 极 快 的 速度 操作 分 区 的 结构 ， 而 
不 是 痛苦 的 物理 移动 大 量 数据 。 


删除 旧 数 据 最 简单 的 方法 是 而 除 不 再 需要 的 分 区 : 


DROP TABLE measurement_y2006m02; 


这 个 命令 可 以 迅速 删除 数 包含 数 百 万 条 记录 的 分 区 ， 因 为 它 不 需要 单独 删除 每 一 条 记录 。 
还 可 以 在 删除 分 区 的 同时 保留 其 作为 一 个 表 访问 的 能 力 : 


ALTER TABLE measurement_y2006m02 NO INHERIT measurement, 


这 将 允许 将 来 对 这 些 数据 执行 其 它 的 操作 (比如 使 用 copy ,pg_ dump 之 类 的 工具 进行 备份 )。 
并 且 此 时 也 是 执行 其 它 数据 操作 (数据 聚集 或 运行 报表 等 ) 的 有 利 时 机 。 


同样 ， 我 们 可 以 像 前 面 创建 最 初 的 分 区 一 样 ， 创 建 一 个 新 的 空 分 区 来 处理 新 数据 。 


CREATE TABLE measurement_y2008m02 ( 
CHECK ( logdate >= DATE '2008-02-01' AND logdate < DATE '2008-03-01' ) 
) INHERITS (measurement); 


有 时 在 分 区 结构 之 外 创建 新 表 并 在 一 段 时 间 之 后 将 其 变 为 分 区 更 为 方便 。 因为 这 将 允许 在 该 
表 变 为 分 区 之 前 对 其 中 的 数据 进行 加 载 、 检 查 、 转 换 之 类 的 操作 。 


CREATE TABLE measurement_y2008m02 
(LIKE measurement INCLUDING DEFAULTS INCLUDING CONSTRAINTS); 
ALTER TABLE measurement_y2008m02 ADD CONSTRAINT y2008m02 
CHECK ( logdate >= DATE '2008-02-01' AND logdate < DATE '2008-03-01' ); 
\copy measurement_y2008m02 from 'measurement_y2008m02' 
--H ea sere S LF 
ALTER TABLE measurement_y2008m02 INHERIT measurement; 


5.9.4. 分 区 和 约束 排除 
约束 排除 是 一 种 查询 优化 技巧 ， 它 改进 了 用 上 述 方法 定义 的 表 分 区 的 性 能 。 比 如 : 


SET constraint_exclusion = on; 
SELECT count(*) FROM measurement WHERE logdate >= DATE '2008-01-01'; 


如 果 没 有 约束 排除 ， 上 面 的 查询 会 打 描 measurement 表 中 的 每 一 个 分 区 。 打开 了 约束 排除 之 
后 ， 规 划 器 将 检查 每 个 分 区 的 约束 然后 试图 证 明 该 分 区 不 需要 被 扫描 (因为 它 不 能 包含 任何 符 
合 where 子 句 条 件 的 数据 行 )。 如 果 规 划 器 可 以 证 明 这 个 ， 它 就 把 该 分 区 从 查询 规划 里 排除 出 
去 。 


你 可 以 使 用 EXPLAIN 命令 显示 一 个 规划 在 constraint_exclusion 打开 和 关闭 情况 下 的 不 同 。 
一 个 为 这 种 类 型 的 表 设 置 的 典型 的 非 最 佳 的 规划 是 : 


SET constraint_exclusion = off; 
EXPLAIN SELECT count(*) FROM measurement WHERE logdate >= DATE '2008-01-01'; 


QUERY PLAN 
Aggregate (cost=158.66..158.68 rows=1 width=0) 
-> Append (cost=0.00..151.88 rows=2715 width=0) 
-> Seq Scan on measurement (cost=0.00..30.38 rows=543 width=0) 
Filter: (logdate >= '2008-01-01'::date) 
-> Seq Scan on measurement_y2006m02 measurement (cost=0.00..30.38 rows=543 wid 
Filter: (logdate >= '2008-01-01'::date) 
-> Seq Scan on measurement_y2006m03 measurement (cost=0.00..30.38 rows=543 wid 
Filter: (logdate >= '2008-01-01'::date) 


-> Seq Scan on measurement_y2007m12 measurement (cost=0.00..30.38 rows=543 wid 
Filter: (logdate >= '2008-01-01'::date) 


-> Seq Scan on measurement_y2008m01 measurement (cost=0.00..30.38 rows=543 wid 
Filter: (logdate >= '2008-01-01'::date) 


EJE) 
部 分 或 者 全 部 分 区 可 能 会 使 用 索引 扫描 而 不 是 全 表 扫 描 ， 不 过 这 里 要 表达 的 意思 是 没有 必要 


扫描 旧 分 区 就 可 以 回答 这 个 查询 。 在 打开 约束 排除 之 后 ， 我 们 可 以 得 到 生成 同样 回答 的 明显 
简化 的 规划 : 





SET constraint_exclusion = on; 
EXPLAIN SELECT count(*) FROM measurement WHERE logdate >= DATE '2008-01-01'; 
QUERY PLAN 


Aggregate (cost=63.47..63.48 rows=1 width=0) 
-> Append (cost=0.00..60.75 rows=1086 width=0) 
-> Seq Scan on measurement (cost=0.00..30.38 rows=543 width=0) 
Filter: (logdate >= '2008-01-01'::date) 
-> Seq Scan on measurement_y2008m01 measurement (cost=0.00..30.38 rows=543 wid 
Filter: (logdate >= '2008-01-01'::date) 


村 


请 注意 ， 约 束 排除 只 由 cHeck 约束 驱动 ， 而 不 会 由 索引 了 驱动 。 因此 ， 在 关键 字 字 段 上 定义 索 
引 是 没有 必要 的 。 在 给 出 的 分 区 上 是 否 需 要 建立 索引 取决 于 那些 扫描 该 分 区 的 查询 通常 是 扫 
描 该 分 区 的 一 大 部 分 还 是 只 是 一 小 部 分 。 对 于 后 者 ， 索 引 通 常 都 有 帮助 ， 对 于 前 者 则 没有 什 
么 好 处 。 





constraint_exclusion 缺 省 (和 建议 ) 设置 事实 上 不 是 on 也 不 是 off ， 但 是 中 间 设 置 调 
用 partition ， 导致 很 可 能 要 工作 在 分 区 表 上 的 技术 只 适用 于 查询 。 on 设置 导致 规划 器 在 
所 有 的 查询 里 检查 cHEck 限制 ， 即 使 是 不 可 能 受益 的 最 简单 的 限制 。 


5.9.5. BURA 


用 一 个 不 同 的 途径 去 重新 定向 插入 适当 的 分 区 表 是 在 主 表 中 建立 规则 ， 而 不 是 触发 器 ， 例 
如 : 


CREATE RULE measurement_insert_y2006m02 AS 
ON INSERT TO measurement WHERE 

( logdate >= DATE '2006-02-01' AND logdate < DATE '2006-03-01' ) 
DO INSTEAD 

INSERT INTO measurement_y2006m02 VALUES (NEW.*); 


CREATE RULE measurement_insert_y2008m01 AS 
ON INSERT TO measurement WHERE 

( logdate >= DATE '2008-01-01' AND logdate < DATE '2008-02-01' ) 
DO INSTEAD 

INSERT INTO measurement_y2008m01 VALUES (NEW.*); 


规则 比 触 发 器 有 显著 的 开销 ， 但 是 这 个 开销 是 每 检查 一 次 支付 一 次 而 不 是 每 行 支付 一 次 ， 所 
以 这 种 方法 可 能 在 批量 插入 的 情况 下 有 优势 。 然 而 在 更 多 的 情况 下 ， 触发 器 的 方法 更 好 。 


请 注意 copy 会 忽略 规则 。 如 果 您 想 用 coy 插入 数据 ， 您 将 需要 复制 分 区 表 而 不 是 主 
Ko copy 触发 触发 器 ， 如 果 您 用 触发 器 的 方法 就 可 以 正常 使 用 。 


另 一 个 规则 方法 缺点 是 如 果 规 则 设置 没有 覆盖 插入 数据 ， 那 么 没有 简单 的 路 径 强 制 错 误 ， 数 
据 将 会 悄 展 代替 主 表 中 的 数据 。 


安排 分 区 也 可 以 用 uno ALL 视图 ， 而 不 是 表 继 承 。 例 如 ， 


CREATE VIEW measurement AS 
SELECT * FROM measurement_y2006m02 
UNION ALL SELECT * FROM measurement_y2006m03 


UNION ALL SELECT * FROM measurement_y2007m11 


UNION ALL SELECT * FROM measurement_y2007m12 
UNION ALL SELECT * FROM measurement_y2008m01; 


然而 ， 增 加 和 删除 各 个 分 区 的 数据 集 ， 需 要 重新 创建 视图 ， 增 加 一 个 额外 的 步骤 。 在 实际 中 
这 个 方法 跟 使 用 继承 相 比 较 几 乎 没有 可 取 之 处 。 





5.9.6. 警告 


下 面 的 注意 事项 适合 于 已 分 区 的 表 : 


。 没有 办 法 自动 验证 所 有 的 cHEck 约束 是 互 斥 的 。 创建 代码 比 每 条 用 手 生 成 分 区 和 创建 和 / 
或 修改 关联 的 对 象 写 更 安全 。 


。 这 里 显示 的 模式 假设 分 区 内 一 行 的 主 字段 永远 不 变 ， 或 者 至 少 不 变 足够 要 求 它 移 到 另 一 
个 分 区 。 一 个 uppate 党 试 由 于 cHEck 的 约束 将 会 失败 。 如 果 您 需要 处 理 这 种 情况 ， 您 
可 以 在 分 区 表 内 放 入 合适 的 更 新 触发 器 ， 但 是 它 会 使 管理 结构 更 加 复杂 。 


。 如 果 您 正在 使 用 vacuum 手册 或 者 ANALYZE MD, 不 要 忘记 您 需要 在 每 个 分 区 上 分 别 运 行 
他 们 ， 就 像 这 样 的 命令 : 


ANALYZE measurement; 


将 只 会 处 理 主 表 。 
下 面 的 注意 事项 适合 于 约束 排除 : 


。 约束 排除 只 是 在 查询 的 wHERE 子 句 包含 常量 (或 者 外 部 提供 的 参数 ) 的 时 候 才 生效 。 例 
如 ， 一 个 非 不 可 变 的 函数 的 比较 ， 如 current Timestamp 不 能 被 优化 ， 因 为 在 运行 时 规划 
器 不 知道 该 参数 会 选择 哪个 分 区 。 


。 保持 分 区 约束 的 简单 性 ， 否 则 规划 器 可 能 不 能 证 明 分 区 不 需要 被 访问 。 为 列表 分 区 使 用 
简单 平等 的 约束 ， 或 为 范围 分 区 使 用 简单 的 范围 测试 ， 就 像 前 面 的 例子 说 明 。 一 个 好 的 
拇指 规则 是 分 区 约束 应 该 只 包含 分 区 字段 和 可 添加 B-tree 索 引 的 操作 符 使 用 的 常量 的 比 
较 。 

。 主 表 的 所 有 分 区 的 所 有 约束 在 约束 排除 中 被 审查 ， 所 以 大 量 的 分 区 将 大 大 增加 查询 规划 
时 间 。 分 区 使 用 这 些 技术 或 许可 以 将 分 区 提升 到 一 百 个 且 能 很 好 的 工作 ; 不 要 试图 使 用 
MAE BBE. 


5.10. 外 部 数据 


PostgreSQL 实 现 了 SQL/MED 规 范 的 一 部 分 ， 允许 使 用 规则 的 SQL 查 询 访 问 驻 留 在 
PostgreSQL 外 部 的 数据 。 这 样 的 数据 被 称 为 外 部 数据 。 (请 注意 这 种 使 用 不 能 同 外 键 混 
淆 ， 外 键 是 数据 库 的 一 种 约束 类 型 。) 


外 部 数据 是 通过 外 部 数据 封装 器 的 帮助 来 访问 的 。 一 个 外 部 数据 封装 器 是 一 个 可 以 与 外 部 数 
据 源 沟通 的 库 ， 人 隐藏 与 外 部 数据 源 连 接 的 细节 并 且 从 外 部 数据 源 获得 数据 。 这 里 有 几 个 作 

为 贡献 模板 的 可 用 外 部 数据 封装 器 ， 见 Appendix F。 其 他 类 型 的 外 部 数据 封装 器 可 能 会 在 第 
三 方 产品 中 见 到 。 如 果 现 存 的 外 部 数据 封装 器 没有 适合 你 的 需要 的 ， 你 可 以 自己 写 一 个 ; 见 
Chapter 52, 


要 访问 外 部 数据 ， 你 需要 创建 一 个 外 部 服务 器 对 象 ， 它 定 义 了 如 何 根据 支持 的 外 部 数据 封装 
器 设置 的 选项 ， 连 接 到 一 个 特定 的 外 部 数据 源 。 然后 你 需要 创建 一 个 或 多 个 外 部 表 ， 它 定义 
了 远程 数据 的 结构 。 一 个 外 部 表 可 以 像 普通 表 那 样 用 于 查询 ， 但 是 外 部 表 不 会 存储 在 
PostgreSQL 服 务 器 中 。 无 论 何 时 用 到 外 部 表 ，PostgreSQL 要 求 外 部 数据 封装 器 从 外 部 源 获 
取 数 据 ， 或 者 在 更 新 命 舍 时 传输 数据 到 外 部 源 。 


访问 远程 数据 可 能 需要 到 外 部 数据 源 的 验证 。 这 个 信息 可 以 通过 一 个 用 户 映射 来 提供 ， 用 户 
映射 可 以 根据 当前 的 PostgreSQL 角 色 提 供 额 外 的 数据 ， 如 用 户 名 和 密码 。 


要 获取 更 多 的 信息 ， 请 参阅 CREATE FOREIGN DATA WRAPPER, CREATE 
SERVER，CREATE USER MAPPING 和 CREATE FOREIGN TABLE。 


5.11. 其 它 数据 库 对 象 


在 关系 结构 里 ， 表 是 核心 的 对 象 ， 因 为 它们 保存 你 的 数据 。 但 是 它们 并 非 存在 于 数据 库 中 的 
唯一 对 象 。 我 们 可 以 创建 许多 其 它 类 型 的 对 象 来 让 我 们 对 数据 的 使 用 和 管理 变 得 更 方便 。 我 
们 没有 在 这 一 章 里 讨论 这 些 对 象 ， 但 是 我 们 在 这 里 会 给 你 一 个 列表 ， 这 样 你 就 知道 什么 是 可 
能 的 。 


。 视图 

。 BAER ETT 

。 数据 类 型 和 域 

。 触发 器 和 重 写 规则 


这 些 主题 的 详细 信息 在 Part V 里 面 。 





5.12. (Kei HE ERE 


如 果 你 创建 了 一 个 包含 许多 表 ， 并 且 带 有 外 键 约束 、 视 图 、 触 发 器 、 画 数 等 复杂 的 数据 库 结 
构 。 那么 你 就 会 在 对 象 之 间 隐 含 地 创建 了 一 个 依赖 性 的 网 络 。 比 如 ， 一 个 带 有 外 键 约束 的 表 
依赖 于 它 所 引用 的 表 。 


为 了 保证 整个 数据 库 结构 的 完整 性 ，PostgreSQL 保证 你 无 法 删除 那些 还 被 其 它 对 象 依 赖 的 对 
象 。 比 如 ， 试 图 删除 在 Section 5.3.5 里 被 订单 表 所 依赖 的 产品 表 是 不 能 成 功 的 ， 会 有 类 似 下 
面 的 错误 信息 出 现 : 


DROP TABLE products; 
NOTICE: constraint orders_product_no_fkey on table orders depends on table products 


ERROR: cannot drop table products because other objects depend on it 
HINT: Use DROP ... CASCADE to drop the dependent objects too. 


4 


这 个 错误 信息 包含 一 个 有 用 的 提示 : 如 果 你 不 想 麻 烦 的 分 别 删 除 所 有 依赖 对 象 ， 你 可 以 运 
行 


Ja 


DROP TABLE products CASCADE; 


然后 所 有 被 依赖 的 对 象 都 将 被 删除 (并 不 删除 订单 表 ， 只 是 删除 外 键 约 束 )。 如 果 你 想 检 


查 DROP ... CASCADE 会 干什么 ， 运 行 不 带 cAscApE 的 prop 然后 阅读 notice 信息 。 


PostgreSQL 里 的 所 有 删除 命令 都 支持 声明 cAscApE 。 当然 ， 具 体 的 依赖 性 实体 取决 于 对 象 的 
类 型 。 你 也 可 以 写 restrict 而 不 是 cAscApE 以 获取 缺 省 的 行为 (防止 删除 那些 其 它 对 象 所 依 
赖 的 对 象 )。 


Note: 根据 SQL 标准 ， 要 求 至 少 声明 restrict 或 cASCADE 中 的 一 个 。 实际 上 没有 哪 种 
数据 库 系 统 强制 这 一 点 ， 但 是 缺 省 的 行为 是 RESTRICT 还 是 CASCADE 则 因 系 统 而 异 。 


Note: 在 PostgreSQL 7.3 之 前 的 外 键 约束 依赖 性 和 序列 字段 依赖 性 在 升级 过 程 中 都 不 会 


得 到 维护 或 者 创建 。 所 有 其 它 的 依赖 性 类 型 在 从 7.3 版 本 以 前 的 数据 库 升 级 过 程 中 都 将 得 
到 恰当 的 创建 。 


Chapter 6. 数据 操作 
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前 面 的 章节 讨论 了 如 何 创建 存储 数据 的 表 和 其 它 结 构 。 现 在 来 讲 用 数据 填充 表 。 本 章 将 介绍 
如 何 插入 、 更 新 、 删 除数 据 。 在 下 一 章 将 最 终 解 释 如 何 把 你 去 失 已 久 的 数据 从 数据 库 中 抽取 
出 来 。 


6.1. 插入 数据 


在 创建 完 一 个 表 的 时 候 ， 它 里 面 没有 数据 。 在 数据 库 可 以 有 点 用 处 之 前 要 做 的 第 一 件 事 就 是 
向 里 面 插入 数据 。 数据 在 概念 上 是 每 次 插入 一 行 。 我 们 当然 可 以 每 次 插入 多 行 ， 但 是 确实 没 
有 办 法 插入 少 于 一 行 的 数据 。 即 使 你 只 知道 几 个 字段 的 数值 ， 那么 你 也 必须 创建 一 个 完整 的 
行 。 
使 用 INSERT 命 邻 创 建 一 个 新 行 。 这 条 命令 要 求 提供 表 名 字 以 及 字段 值 。 比 如 ， 考虑 来 自 
Chapter 5 的 产品 表 : 
CREATE TABLE products ( 
product_no integer, 
name text, 


price numeric 


Ne 


下 面 是 一 个 向 表 中 插入 一 行 的 例子 : 

INSERT INTO products VALUES (1, 'Cheese', 9.99); 
数据 值 是 按照 这 些 字段 在 表 中 出 现 的 顺序 列 出 的 ， 并 且 用 过 号 分 隔 。 通 常 ， 数据 值 是 文本 ( 常 
量 )， 但 也 人 允许 使 用 标量 表达 式 。 


上 述 语法 的 缺点 是 你 必须 知道 表 中 字段 的 顺序 。 你 也 可 以 明确 地 列 出 字段 以 避免 这 个 问题 。 
比如 ， 下 面 的 两 条 命令 都 和 上 面 的 那 条 命令 效果 相同 : 


INSERT INTO products (product_no, name, price) VALUES (1, 'Cheese', 9.99); 
INSERT INTO products (name, price, product_no) VALUES ('Cheese', 9.99, 1); 


许多 用 户 认为 明确 列 出 字段 名 是 个 好 习惯 。 


如 果 你 不 知道 所 有 字段 的 数值 ， 那 么 可 以 省 略 其 中 的 一 些 。 这 时 候 ， 这 些 未 知 字段 将 被 填充 
为 它们 的 缺 省 值 。 上 比如 : 


INSERT INTO products (product_no, name) VALUES (1, 'Cheese'); 
INSERT INTO products VALUES (1, 'Cheese'); 


第 二 种 形式 是 PostgreSQL 的 一 个 扩展 。 它 从 左 向 右 用 给 定 的 值 尽 可 能 多 的 填充 字段 ， 剩 余 的 
填充 缺 省 值 。 
为 了 保持 清晰 ， 你 也 可 以 对 独立 的 字段 或 者 整个 行 明确 使 用 缺 省 值 : 


INSERT INTO products (product_no, name, price) VALUES (1, 'Cheese', DEFAULT); 
INSERT INTO products DEFAULT VALUES; 


PostgreSQL 中 文 文档 9.3 


你 可 以 在 一 条 命令 中 插入 多 行 : 


INSERT INTO products (product_no, name, price) VALUES 
(1, 'Cheese', 9.99), 
(2, 'Bread', 1.99), 
(3, 'Milk', 2.99); 


Tip: 要 一 次 插 和 人 大量 数据 ， 可 以 看 看 COPY 命 令 。 它 不 像 INSERT 命 合 那 么 灵活 ， 但 是 
更 高 效 。 参考 Section 14.4 获 取 更 多 有 关 装 载 海量 数据 的 信息 。 


6.1. 插入 数据 161 


6.2. 更 新 数据 


修改 已 经 存储 在 数据 库 中 的 数据 的 行为 叫做 更 新 。 你 可 以 更 新 单独 的 一 行 ， 也 可 以 更 新 表 中 
所 有 的 行 ， 还 可 以 更 新 其 中 的 一 部 分 行 。 我 们 可 以 独立 地 更 新 每 个 字段 ， 而 其 它 的 字段 则 不 
受 影响 。 


B. 
wa + 


Dili 


要 更 新 现 有 的 行 ， 使 用 UPDATE 命 令 。 这 需要 三 种 人 
1， 表 的 名 字 和 要 更 新 的 字段 名 

2. 字段 的 新 值 

3， 要 更 新 哪些 行 

我 们 在 Chapter 5 里 说 过 ，SQL 通常 并 不 为 数据 行 提供 唯一 标识 。 因此 我 们 无 法 直接 声明 需要 
更 新 哪 一 行 。 但 是 ， 我 们 可 以 通过 声明 一 个 被 更 新 的 行 必 须 满足 的 条 件 。 只 有 在 表 里 存在 主 
键 的 时 候 (不 依赖 于 你 叫 它 什么 )， 我 们 才能 通过 选取 主键 可 靠 地 指定 一 个 独立 的 行 。 图 形 化 
的 数据 库 访问 工具 依赖 这 个 东西 来 让 我 们 可 以 独立 地 更 新 某 些 行 。 


比如 ， 这 条 命令 将 所 有 价格 为 5 的 产品 重 定价 为 10 : 


UPDATE products SET price = 10 WHERE price = 5; 


x MA BE | ST, TRS TERT. 如 果 我 们 试图 执行 一 个 不 匹配 任何 行 的 更 
新 ， 那 也 不 算 错 。 


让 我 们 仔细 看 看 这 个 命令 。 首 先是 关键 字 UPpATE 跟着 表 名 字 。 和 平常 一 样 ， 表 名 字 也 可 以 是 
用 模式 修饰 的 ， 否 则 就 会 从 模式 路 径 中 把 它 找 出 来 。 然后 是 关键 字 sET 跟着 字段 名 与 一 个 等 
号 以 及 新 的 字段 值 。 新 的 字段 值 可 以 是 任意 标量 表达 式 ， 而 不 仅仅 是 常量 。 比 如 ， 如 果 你 想 
把 所 有 产品 的 价格 提高 10% ， 可 以 用 : 


UPDATE products SET price = price * 1.10; 


如 你 所 见 ， 新 值 的 表达 式 也 可 以 引用 行 中 现 有 的 数值 。 我 们 还 忽略 了 whERE FO). MRK 
忽略 了 这 个 子 句 ， 那 么 表 中 所 有 的 行 都 要 被 更 新 。 如 果 出 现 了 were 子 句 ， 那 么 只 有 匹配 其 
条 件 的 行 才 会 被 更 新 。 请 注意 在 sET 子 句 中 的 等 号 是 一 个 赋值 ， 而 在 were 子 句 中 的 等 号 
是 比较 ， 不 过 这 样 并 不 会 导致 任何 歧义 。 当 然 were 条 件 不 一 定 非得 是 相等 测试 。 许 多 其 它 
操作 符 也 都 可 以 使 用 (参阅 Chapter 9)。 但 是 表达 式 必须 得 出 一 个 布尔 结果 。 


你 还 可 以 在 一 个 UPDATE 命令 中 更 新 更 多 的 字段 ， 方法 是 在 ser 子 句 中 列 出 更 多 赋值 。 比 
如 : 


UPDATE mytable SET a = 5, b = 3, c = 1 WHERE a > 0; 


6.3. 删除 数据 


到 目前 为 止 我 们 已 经 解释 了 如 何 向 表 中 增加 数据 以 及 如 何 改变 数据 。 剩 下 的 是 讨论 如 何 删除 
不 再 需要 的 数据 。 和 前 面 增加 数据 一 样 ， 删除 数据 也 必须 是 从 表 中 整 行 整 行 地 删除 。 在 上 一 
节 里 我 们 提 到 了 SQL 不 提供 直接 访问 独立 行 的 方法 。 因 此 ， 删除 行 只 能 是 通过 声明 被 删除 行 
必须 匹配 的 条 件 进行 。 如 果 你 在 表 上 有 一 个 主键 ， 那么 你 可 以 声明 准确 的 行 。 当 然 ， 你 也 可 
以 删除 匹配 条 件 的 一 组 行 ， 或 者 一 次 删除 表 中 的 所 有 行 。 


我 们 使 用 DELETE 命 令 删 除 行 。 它 的 语法 和 uppate 命令 非常 类 似 。 比 如 ， 要 从 产品 表 中 删除 
所 有 价格 为 10 的 产品 ， 用 : 


DELETE FROM products WHERE price = 10; 


如 果 你 只 是 写 : 


DELETE FROM products; 


那么 表 中 所 有 行 都 会 被 删除 ! 程序 员 一 定 要 注意 。 


Chapter 7. 查询 
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前 面 的 章节 解释 了 如 何 创建 表 ， 如 何 用 数据 填充 它们 ， 以 及 如 何 操作 那些 数据 。 现在 我 们 终 
于 可 以 讨论 如 何 从 数据 库 中 检索 数据 了 。 


7.1. 概述 


从 数据 库 中 检索 数据 的 过 程 或 命令 叫做 查询 。 在 SQL 里 SELECT 命令 用 于 声明 坦 
iJ. SELECT 命令 的 通用 语法 如 下 : 


[WITH ~_with_queries_~] SELECT _select_list_ FROM _table_expression_ [°_sort_specificatio 





«| = 











随后 的 几 节 将 描述 选择 列表 、 表 表达 式 、 排 序 声明 的 细节 。 wITH 查询 被 视 为 最 后 的 ， 因 为 
它们 是 一 种 先进 的 功能 。 


简单 的 查询 的 形式 如 下 : 

SELECT * FROM table1; 
假设 有 一 个 table1 表 ， 这 条 命令 将 从 table1 中 检索 所 有 行 和 所 有 用 户 定义 的 字段 。 检 索 的 
方法 取决 于 客户 端 应 用 程序 。 比如 ，psql 程 序 将 在 屏幕 上 显示 一 个 ASCII 艺术 构成 的 表格 ， 
客户 端 库 将 提供 检索 独立 行 和 字段 的 函数 。 选 择 列表 声明 为 “ 表示 表 表 达 式 提供 的 所 有 可 用 
字段 。 一 个 选择 列表 也 可 以 选择 可 用 字段 的 一 个 子 集 或 者 使 用 这 些 字段 进行 计算 ; 比如 ， 如 


R table1 有 名 为 a, bp ，c 的 字段 (可 能 还 有 其 它 )， 那 么 你 可 以 用 下 面 的 查询 (假设 b 和 c 都 
是 数字 数据 类 型 ) : 


SELECT a, b + c FROM table1; 


参阅 Section 7.33% NB Sa $., 


FROM table1 是 一 种 简单 的 表 表 达 式 : 它 只 读 取 了 一 个 表 。 通常 ， 表 表达 式 可 以 是 基本 表 、 
连接 、 子 查询 的 复杂 构造 。 但 你 也 可 以 省 略 表 表达 式 而 只 用 secr 命令 当做 一 个 计算 器 : 


SELECT 3 * 4; 


如 果 选 择 列表 里 的 表达 式 返 回 变化 的 结果 ， 那 么 这 个 东西 就 更 有 用 了 。 上 比如 ， 你 可 以 用 这 个 
方法 调用 函数 : 


SELECT random(); 


7.2. 表 表 达 式 


表 表 达 式 计算 一 个 表 ， 它 包含 一 个 ron FA, 该 子 句 可 以 根据 需要 选用 WHERE , 
GROUP BY ，HAVING 子 句 。 大 部 分 表 表 达 式 只 是 指向 磁盘 上 的 一 个 所 谓 的 基本 表 ， 但 是 我 们 可 
以 用 更 复杂 的 表达 式 以 各 种 方法 修改 或 组 合 基本 表 。 


表 表 达 式 里 的 WHERE , GROUP BY ，HAVING 子 句 声明 一 系列 对 源 自 From 子 句 的 表 的 转换 操 
VE, 所 有 这 些 转换 最 后 生成 一 个 虚拟 表 ， 传 递 给 选择 列表 计算 输出 行 。 


7.2.1. FROM 子 句 
FROM 子 句 从 一 个 有 逗号 分 隔 的 表 引 用 列表 中 生成 一 个 虚拟 表 。 


FROM _table_reference_ [, ~_table_reference_~ [, ...]] 


表 引 用 可 以 是 一 个 表 名 字 ( 可 能 有 模式 修饰 ) 或 者 是 一 个 生成 的 表 ， 比如 子 查询 、 表 连接 、 或 
这 些 东 西 的 复杂 组 合 。 如 果 在 FRoM 子 句 中 列 出 了 多 于 一 个 表 ， 那么 它们 交叉 连接 ( 见 下 文 ) 形 
成 一 个 派生 表 ， 该 表 可 以 进行 WHERE ， GROUP BY, HAVING 子 句 的 转换 处 理 ， 并 最 后 生成 表 表 
达 式 的 结果 。 


如 果 一 个 表 引 用 是 一 个 简单 的 父 表 的 名 字 ， 那 么 将 包括 其 所 有 后 代 子 表 的 行 ， 除非 你 在 该 表 
名 字 前 面 加 ony 关键 字 (这 样 任何 子 表 都 会 被 忽略 )。 


除了 在 表 名 字 前 面 加 oNLY ， 你 可 以 在 表 名 字 后 面 写 * 明确 指定 包括 后 代表 。 写 * 不 是 必须 
的 ， 因 为 这 个 行为 是 默认 的 (除非 你 已 经 改变 了 sql_inheritance 配 置 选 项 里 面 的 设置 ) 。 然 
mS * 可 能 对 于 强调 搜索 额外 的 表 是 有 用 的 。 


7.2.1.1. 连接 表 


一 个 连接 表 是 根据 特定 的 连接 规则 从 两 个 其 它 表 (真实 表 或 生成 表 ) 中 派生 的 表 。 我 们 支持 内 
连接 、 外 连接 、 交 叉 连 接 。 


连接 类 型 
交叉 连接 

_T1_ CROSS JOIN _T2_ 

对 每 个 来 自 n 和 _T2 ”的 行进 行 组 合 〈 也 就 是 ， 一 个 笛 卡尔 积 ) ， 连 接 成 的 表 将 包含 这 样 


We: 所 有 m 里 面 的 字段 后 面 跟着 所 有 12 里面 的 字段 。 如 果 两 表 分 别 有 N 和 M í, 
连接 成 的 表 将 有 N*M 行 。 


FROM _T1_ CROSS JOIN _T2 等 效 于 FRoM _T1_, T2 o 它 还 等 效 于 FROM _T1_ 
INNER JOIN _T2 ON TRUE( 见 下 文 )。 


条 件 连接 


_T1_ { [INNER] | { LEFT | RIGHT | FULL } [OUTER] } JOIN _T2_ ON _boolean_expression_ 
_T1_ { [INNER] | { LEFT | RIGHT | FULL } [OUTER] } JOIN _T2_ USING ( _join column list_ ) 
_T1_ NATURAL { [INNER] | { LEFT | RIGHT | FULL } [OUTER] } JOIN _T2_ 


q = | 


INNER 和 outer 对 所 有 连接 类 型 都 是 可 选 的 。 INNER 为 缺 省 。 LEFT ，RIGHT , 和 FULL KA 
外 连接 。 





连接 条 件 在 oN 或 usis 子 句 里 声明 ， 或 者 用 关键 字 NATURAL 隐 含 地 声明 。 连接 条 件 判断 来 
自 两 个 源 表 中 的 那些 行 是 "匹配 "的 ， 这 些 我 们 将 在 下 面 详细 解释 。 


ON 子 句 是 最 常见 的 连接 条 件 的 类 型 : 它 接收 一 个 和 where 子 句 相同 的 布尔 表达 式 。 如 果 两 
个 分 别 来 自 _T1 和 _T2 BITE on 表达 式 上 运算 的 结果 为 真 ， 那 么 它们 就 算是 匹配 的 行 。 


USING 是 一 个 连接 条 件 的 缩写 语法 : 它 接收 一 个 用 逗号 分 隔 的 字段 名 列表 ， 这 些 字段 必须 是 
连接 表 共 有 的 并 且 其 值 必须 相同 。 最 后 ， JoIN use 会 将 每 一 对 相等 的 输入 字段 输出 为 一 个 
字段 ， 其 后 跟着 所 有 其 它 字段 。 因此 ， usine (a, b, c) 等 效 

于 ON (ti.a = t2.a AND t1.b = t2.b AND tl,c = t2.c) 只 不 过 是 如 果 使 用 了 on ， 那 么 在 结果 
里 a ，b 和 ec 字段 都 会 有 两 个 ， 而 用 usine 的 时 候 就 只 会 有 一 个 〈 如 果 使 用 了 sELEcT * 的 
话 ， 他 们 会 优先 发 生 ) 。 


最 后 ， NATURAL 是 USING 的 缩写 形式 : 它 自动 形成 一 个 由 两 个 表 中 同名 的 字段 组 成 

的 usine 列表 (同名 字段 只 出 现 一 次 )。 如 果 没 有 同名 的 字段 ， NATURAL 的 行为 会 

像 CROSS JOIN 。 

条 件 连 接 可 能 的 类 型 是 : 

INNER JOIN 

内 连接 。 对 于 T1 中 的 每 一 行 R1 ， 如 果 能 在 T2 中 找到 一 个 或 多 个 满足 连接 条 件 的 行 ， 那么 
这 些 满足 条 件 的 每 一 行 都 在 连接 表 中 生成 一 行 。 


LEFT OUTER JOIN 


左 外 连接 。 首 先 执 行 一 次 内 连接 。 然 后 为 每 一 个 T1 中 无 法 在 T2 中 找到 匹配 的 行 生成 一 行 ， 
该 行 中 对 应 T2 的 列 用 NULL 补 齐 。 因 此 ， 生 成 的 连接 表 里 总 是 包含 来 自 T1 里 的 每 一 行 至 少 
一 个 副本 。 


RIGHT OUTER JOIN 


右 外 连接 。 首 先 执 行 一 次 内 连接 。 然 后 为 每 一 个 T2 中 无 法 在 T1 中 找到 匹配 的 行 生成 一 行 ， 
该 行 中 对 应 T1 的 列 用 NULL 补 齐 。 因 此 ， 生 成 的 连接 表 里 总 是 包含 来 自 T2 里 的 每 一 行 至 少 
一 个 副本 。 


FULL OUTER JOIN 


全 连接 。 首 先 执行 一 次 内 连接 。 然 后 为 每 一 个 T1 与 T2 中 找 不 到 匹配 的 行 生成 一 行 ， 该 行 中 
无 法 匹配 的 列 用 NULL 补 齐 。 因 此 ， 生 成 的 连接 表 里 无 条 件 地 包含 T1 和 T2 里 的 每 一 行 至 少 
一 个 副本 。 


MR _T1 和 T2 ”之 一 或 全 部 是 可 以 连接 的 表 ， 那 么 所 有 类 型 的 连接 都 可 以 串 连 或 藤 套 在 一 
E. 你 可 以 在 JoIN 子 句 周围 使 用 圆 括 弧 来 控制 连接 顺序 ， 如 果 没 有 圆 括 弧 ， 那么 goin F 
AMERMARE. 


为 了 解释 这 些 问题 ， 假 设 我 们 有 一 个 表 t1: 


num | name 


Al t2: 


1 | Xxx 
3 | yyy 
5 | zzz 


然后 我 们 用 不 同 的 连接 方式 可 以 获得 各 种 结果 : 


<samp class="literal">=></samp> <kbd class="literal">SELECT * FROM t1 CROSS JOIN t2;</kbd 


num | name | num | value 


OOPOOPOOP 
< 
< 
< 


<samp class="literal">=></samp> 
num | name | num | value 


三 Se ee 
1 | a | 1 | Xxx 
3 | < | 3 | yyy 
(2 rows) 


<samp class="literal">=></samp> 
num | name | value 


Sas | es See 
1 | a | Xxx 
3 | < | yyy 
(2 rows) 


<samp class="literal">=></samp> 
num | name | value 


ES Posse soto N 
1 | a | Xxx 
3 | < | yyy 
(2 rows) 


<samp class="literal">=></samp> 
num | name | num | value 


Besse (eas nonoo eonna 
1 |a | 1 | Xxx 
2 | b | | 
3 | < | 3 | yyy 
(3 rows) 


<samp class="literal">=></samp> 
num | name | value 


三世 ahs aia E See een 
1 | a | Xxx 
2 | b | 
3 | < | yyy 
(3 rows) 


<samp class="literal">=></samp> 
num | name | num | value 


Bases 二 下 下 下 于 
1 | a | 1 | Xxx 
3 | < | 3 | yyy 
| | 5f ZZZ 
(3 rows) 


<samp class="literal">=></samp> 
num | name | num | value 


Besar (ie Se SaaS Secs eee 
1 | a | 1 | Xxx 
2 | b | | 
3 | < | 3 | yyy 
| | 5 | zzz 


<kbd 


<kbd 


<kbd 


<kbd 


<kbd 


<kbd 


<kbd 


class="literal">SELECT 


class="literal">SELECT 


class="literal">SELECT 


class="literal">SELECT 


class="literal">SELECT 


class="literal">SELECT 


class="literal">SELECT 


FROM 


FROM 


FROM 


FROM 


FROM 


FROM 


FROM 


t1 


EL 


t1 


t1 


t1 


t1 


t1 


INNER JOIN t2 ON t1 


INNER JOIN t2 USING 


NATURAL INNER JOIN 


LEFT JOIN t2 ON t1. 


LEFT JOIN t2 USING 


RIGHT JOIN t2 ON t1 


FULL JOIN t2 ON t1. 








FA on 声明 的 连接 条 件 也 可 以 包含 与 连接 不 直接 相关 的 条 件 。 这 种 功能 可 能 对 某 些 查询 很 有 
用 ， 但 是 需要 我 们 仔细 想 清楚 。 上 比如 : 


<Samp class="literal">=></samp> <kbd class="literal">SELECT * FROM t1 LEFT JOIN t2 ON t1. 
num | name | num | value 


‘| | 
请 注意 ， 将 限制 放 在 在 wHERE 子 句 中 将 会 产生 不 同 的 结果 : 








<samp class="literal">=></samp> <kbd class="literal">SELECT * FROM t1 LEFT JOIN t2 ON t1. 
num | name | num | value 
— tT 


1|a | 1 | xxx 





这 是 因为 限制 放 在 on 子 句 中 时 是 先 于 连接 处 理 的 ， 而 限制 放 在 whERE 子 句 中 时 是 后 于 连接 
处 理 的 。 


7.2.1.2. 表 和 列 别名 
你 可 以 给 表 或 复杂 的 表 引 用 起 一 个 临时 的 表 别 名 ， 以 便 被 其 余 的 查询 引用 。 
要 创建 一 个 表 别 名 ， 可 以 这 样 : 


FROM _table_reference_ AS _alias_ 
或 : 
FROM _table_reference_ _alias_ 
AS 关键 字 没 哈 特 别 的 含义 。 _alias_ 可 以 是 任意 标识 符 。 


表 别 名 的 典型 应 用 是 给 长 表 名 赋予 比较 短 的 标识 ， 好 让 连接 子 句 更 易 读 一 些 。 比 如 : 


SELECT * FROM some_very_long_table_name s JOIN another_fairly_long_name a ON s.id = a.num 
| 
取 了 别名 之 后 就 不 允许 再 用 最 初 的 名 字 了 。 因 此 ， 这 是 不 合法 的 : 





SELECT * FROM my_table AS m WHERE my_table.a > 5; -- wrong 


表 别 名 主要 是 为 了 方便 标记 ， 但 对 于 自 连 接 却 是 必须 的 。 比 如 : 
SELECT * FROM people AS mother JOIN people AS child ON mother.id = child.mother_id; 


另外 ， 要 引用 子 查 询 的 结果 也 必须 使 用 别名 (参见 Section 7.2.1.3). 


圆 括 弧 用 于 解决 歧义 。 下 面 的 第 一 个 语句 把 别名 p 赋予 第 二 个 my_table R; 而 第 二 个 语句 
则 把 别名 b 赋予 了 连接 的 结果 。 


SELECT * FROM my_table AS a CROSS JOIN my_table AS b ... 
SELECT * FROM (my_table AS a CROSS JOIN my_table) AS b ... 


另外 一 种 形式 的 表 别 名 除了 给 表 赋 予 别 名 外 ， 还 给 该 表 的 字段 也 赋予 了 别名 : 


FROM _table_reference_ [AS] _alias_ ( _columni_ [, ~_column2_~ [, ...]] ) 





如 果 声 明 的 字段 别名 比 表 里 实际 的 字段 少 ， 那 么 后 面 的 字段 就 没有 别名 。 这 个 语法 对 于 自 连 
接 或 子 查询 特别 有 用 。 


如 果 用 这 些 形式 中 的 任何 一 种 给 一 个 JoIN 子 句 的 输出 结果 附加 了 一 个 别名 ， 那么 该 别名 就 
在 JoIN 里 隐藏 了 其 原始 的 名 字 。 上 比如 : 


SELECT a.* FROM my_table AS a JOIN your_table AS b ON ... 


是 合法 SQL, (He: 


SELECT a.* FROM (my_table AS a JOIN your_table AS b ON ...) AS c 
是 不 合法 的 : 别名 a 在 别名 c 的 外 面 是 看 不 到 的 。 


7.2.1.3. 子 查 询 


子 查询 的 结果 (派生 表 ) 必 须 包 围 在 圆 括 弧 里 并 且 必 须 赋予 一 个 别名 (参阅 Section 7.2.1.2). H 
如 : 


FROM (SELECT * FROM table1) AS alias_name 


这 个 例子 等 效 于 FROM table1 AS alias name, 更 有 趣 的 例子 是 在 子 查询 里 面 有 分 组 或 聚集 的 
时 候 ， 这 个 时 候 子 查询 不 能 凡 纳 成 一 个 简单 的 连接 。 


子 查 询 也 可 以 是 一 个 vALuEs 列表 : 


FROM (VALUES ('anne', 'smith'), ('bob', 'jones'), ('joe', 'blow')) 
AS names(first, last) 


这 种 情况 同样 也 必须 要 取 一 个 别名 。 还 可 以 为 vALuEs 列表 中 的 字段 取 别 名 ， 并 且 被 认为 是 一 
个 好 习惯 。 更 多 信息 参见 Section 7.7。 


7.2.1.4. RBM 


RNB SAREE XK-MIRGHNR, KPRADTU SHEAR KE (BH E) am, th 
可 以 是 由 复合 数据 类 型 ( 表 的 行 ) 组 成 。 他 们 的 用 法 类 似 一 个 表 、 视 图 、 或 FRoM 子 句 里 的 子 查 
询 。 表 本 数 返回 的 字段 可 以 像 一 个 表 、 视 图 、 或 者 子 查询 字段 那样 包含 在 


SELECT , JOIN , WHERE 子 句 里 。 


如 果 表 画 数 返 回 基本 数据 类 型 ， 那 么 单一 结果 字段 的 名 字 匹 配 本 数 名 。 如 果 表 函数 返回 复合 
数据 类 型 ， 那 么 多 个 结果 字段 的 名 字 和 该 类 型 的 每 个 属性 的 名 字 相 同 。 


可 以 在 FRoM 子 句 中 为 表 本 数 取 一 个 别名 ， 也 可 以 不 取 别 名 。 如 果 一 个 函数 在 FRoM 子 句 中 没 
有 别名 ， 那 么 将 使 用 函数 名 作为 结果 表 的 名 字 。 


一 些 例子 


CREATE TABLE foo (fooid int, foosubid int, fooname text); 


CREATE FUNCTION getfoo(int) RETURNS SETOF foo AS $$ 
SELECT * FROM foo WHERE fooid = $1; 
$$ LANGUAGE SQL; 


SELECT * FROM getfoo(1) AS t1; 


SELECT * FROM foo 
WHERE foosubid IN ( 
SELECT foosubid 
FROM getfoo(foo.fooid) z 
WHERE z.fooid = foo.fooid 


); 
CREATE VIEW vw_getfoo AS SELECT * FROM getfoo(1); 


SELECT * FROM vw_getfoo; 


Aiz, —-SRAELRIRET AN RAAAA LORE TANFRERAAN. 为 了 支持 
这 个 ’ RKA LAS 明 为 返回 伪 类 型 record o 如 果 在 查 询 里 使 用 这 FEA ERX, 那么 我 们 必须 
在 查询 中 声明 预期 的 行 结构 ， 这 样 系统 才 知 道 如 何 分 析 和 规划 该 查询 。 让 我 们 看 看 下 面 的 例 
fF: 


SELECT * 
FROM dblink('dbname=mydb', 'SELECT proname, prosrc FROM pg_proc') 
AS ti(proname name, prosrc text) 
WHERE proname LIKE 'bytea%'; 


dblinkBNat (dblink 模 块 的 一 部 分 ) 执行 一 个 远程 的 查询 。 它 声明 为 返回 record, AACA 
能 会 被 用 于 任何 类 型 的 查询 。 实际 的 字段 集 必 须 在 调用 它 的 查询 中 声明 ， 这 样 分 析 器 才 知 道 
类 似 * 这 样 的 东西 应 该 扩展 成 什么 样子 。 


7.2.1.5. LATERAL 子 查 询 


FROM 子 句 中 出 现 的 子 查询 可 以 放 在 关键 字 LATERAL 之 前 。 这 样 就 允许 它们 引用 通过 前 
E FRoM 条 目 提供 的 字段 。 (如 果 没 有 LATERAL ， 那么 每 个 子 查 询 都 被 认为 是 独立 的 并 且 不 
能 交叉 引用 任何 其 他 的 FRoM 条 目 。) 


FROM 中 出 现 的 表 画 数 也 可 以 出 现在 关键 字 LATERAL 之 前 ， 但 是 对 于 男 数 来 说 ， 这 个 关键 字 
是 可 选 的 ; 画 数 的 参数 在 任何 情况 下 都 可 以 包含 通过 前 置 FRoM 条 目 提 供 的 字段 。 


LATERAL 条 目 可 以 出 现在 FRoM 列表 的 顶级 ， 或 者 在 son MH, 在 后 者 的 情况 下 ， 它 
在 join 右 侧 时 也 可 以 参考 左 侧 的 条 目 。 


当 FROM 包含 LATERAL 交叉 引用 时 ， 评 估 收 益 如 下 : ”FroM 条 目的 每 行 或 多 个 FRoM 条 目的 行 
组 提供 交叉 引用 的 字段 ， LATERAL 条 目 被 评估 为 使 用 行 或 行 组 的 字段 值 。 结 果 行 像 平常 一 样 
加 入 他 们 的 计算 行 。 这 些 来 自 字段 原 表 中 的 行 或 行 组 就 这 样 重复 。 


一 个 LATERAL 常见 的 例子 是 : 


SELECT * FROM foo, LATERAL (SELECT * FROM bar WHERE bar.id = foo.bar_id) ss; 


这 并 不 是 特别 有 用 的 ， 因 为 它 的 结果 正好 和 更 传统 做 法 的 相同 。 


SELECT * FROM foo, bar WHERE bar.id = foo.bar_id; 


LATERAL 当 交 叉 引 用 字段 对 于 加 入 的 计算 行 是 重要 的 时 是 主要 有 用 的 。 一 个 常见 的 应用 是 为 
一 个 set-returning 画 数 提 供 一 个 参数 值 。 例 如 ， 假 设 vertices(polygon) 返回 一 个 多 边 形 的 顶 
点 坐标 ， 我 们 可 以 识别 出 多 边 形 的 顶点 距离 近 的 存储 在 一 个 表 中 : 


SELECT p1.id, p2.id, vi, v2 
FROM polygons p1, polygons p2, 
LATERAL vertices(p1.poly) v1, 
LATERAL vertices(p2.poly) v2 
WHERE (v1 <-> v2) < 10 AND pi1.id != p2.id; 


这 条 语句 也 可 以 写成 : 


SELECT p1.id, p2.id, vi, v2 

FROM polygons p1 CROSS JOIN LATERAL vertices(p1i.poly) v1, 
polygons p2 CROSS JOIN LATERAL vertices(p2.poly) v2 

WHERE (v1 <-> v2) < 10 AND pi1.id != p2.id; 


或 者 几 个 其 他 等 价 的 形式 。 (就 像 之 前 提 到 的 ， LATERAL 关键 字 在 这 个 例子 中 不 是 必须 的 ， 
但 是 我 们 为 了 明确 而 是 用 它 。) 


LEFT JOIN 对 于 LATERAL 子 查询 来 说 往往 是 特别 有 用 的 ， 所 以 即使 LATERAL 子 查 询 不 产生 
行 ， 源 行 也 将 出 现在 结果 中 。 例如 ， 如 果 get_product_names() 返回 一 个 制造 商 制造 的 产 品名 
字 ， 但 是 一 些 在 我 们 表 中 的 制造 商 当 前 没有 生产 任何 产品 ， 我 们 可 以 像 下 面 这 样 找 出 这 些 制 
造 商 : 


SELECT m.name 
FROM manufacturers m LEFT JOIN LATERAL get_product_names(m.id) pname ON true 
WHERE pname IS NULL; 


7.2.2. WHERE +4] 
WHERE 子 句子 句 的 语法 是 : 


WHERE _search_condition_ 


这 里 的 _search_condition_ 是 一 个 返回 类 型 为 boolean 的 值 表达 式 ( 参 阅 Section 4.2). 


在 完成 对 FRoM 子 句 的 处 理 之 后 ， 生 成 的 每 一 行 都 会 按照 搜索 条 件 进行 检查 。 如 果 结 果 是 
真 ， 那 么 该 行 保留 在 输出 表 中 ， 否 则 (也 就 是 结果 是 假 或 NULL) 就 把 它 抛 奔 。 搜索 条 件 通 常 至 
少 要 引用 一 列 在 Fon 子 句 里 生成 的 列 ， 这 不 是 必须 的 ， 但 如 果 不 这 样 的 话 ， WHERE FOR 
没什么 意义 了 。 


Note: 内 连接 的 连接 条 件 既 可 以 写 在 were 子 句 里 也 可 以 写 在 somn FOB. 比如 ， 下 
面 的 表 表 达 式 是 等 效 的 : 





FROM a, b WHERE a.id = b.id AND b.val &gt; 5 


和 : 
FROM a INNER JOIN b ON (a.id = b.id) WHERE b.val &gt; 5 
或 者 可 能 还 有 : 


FROM a NATURAL JOIN b WHERE b.val &gt; 5 


你 想 用 哪个 只 是 风格 问题 。 FRoM 子 句 里 的 JoIN 语法 可 能 不 那么 容易 移植 到 其 它 产品 
中 。 即 使 它 是 在 SQL 标准 。 对 于 外 连接 而 言 ， 我 们 没有 选择 : 连接 条 件 必须 在 FRoM F 
句 中 完成 。 外 连接 的 on 或 usine 子 句 不 等 于 wer 条 件 ， 因为 它 导 致 最 终结 果 中 行 的 
增 ( 那 些 不 匹配 的 输入 行 ) 和 删 。 


这 里 是 一 些 whERE 子 句 的 例子 : 


SELECT ... FROM fdt WHERE c1 > 5 
SELECT ... FROM fdt WHERE c1 IN (1, 2, 3) 
SELECT ... FROM fdt WHERE c1 IN (SELECT ci FROM t2) 
SELECT ... FROM fdt WHERE c1 IN (SELECT c3 FROM t2 WHERE c2 = fdt.ci + 10) 
SELECT ... FROM fdt WHERE c1 BETWEEN (SELECT c3 FROM t2 WHERE c2 = fdt.ci + 10) AND 100 
SELECT ... FROM fdt WHERE EXISTS (SELECT ci FROM t2 WHERE c2 > fdt.c1) 
‘| | 








在 上 面 的 例子 里 ， fdt 是 从 FRoM 子 句 中 派生 的 表 。 那些 不 符合 wer 子 句 的 搜索 条 件 的 行 
将 从 fat 中 删除 。 请 注意 我 们 把 标量 子 查询 当做 一 个 值 表达 式 来 用 。 就 像 其 它 查 询 一 样 ， 子 
查询 里 也 可 以 使 用 复杂 的 表 表 达 式 。 同 时 还 请 注意 子 查 询 是 如 何 引 用 fat 的 。 把 ci 修饰 

成 fdt.ct1 只 有 在 ci 是 该 子 查询 生成 的 列 名 字 时 才 是 必须 的 ， 但 修饰 列 名 字 可 以 增加 语句 
的 准确 性 (即使 有 时 不 是 必须 的 )。 这 个 例子 就 演示 了 字段 名 字 范 围 如 何 从 外 层 查询 扩展 到 它 
的 内 层 查询 。 


7.2.3. GROUP BY 和 HAVING 子 句 


在 通过 了 wHere 过 滤器 之 后 ， 生 成 的 输入 表 可 以 继续 用 croup BY 子 句 进 行 分 组 ， 然 后 
用 HAVING 子 句 选取 一 些 分 组 行 。 


SELECT _select_list_ 


FROM ... 
[WHERE ...] 
GROUP BY _grouping_column_reference_ [, ~_grouping_column_reference_~]... 


GROUP BY 子 句子 句 用 于 把 那些 所 有 列 出 的 grouping_column_reference 值 都 相同 的 行 聚集 
在 一 起 ， 缩 减 为 一 行 ， 这 样 就 可 以 删除 输出 里 的 重复 和 /或 计算 应 用 于 这 些 组 的 聚集 。 这 些 字 
段 的 列 出 顺序 无 关 紧 要 。 比如 : 


<samp class="literal">=></samp> <kbd class="literal">SELECT * FROM test1;</kbd> 


<samp class="literal">=></samp> <kbd class="literal">SELECT x FROM testi GROUP BY x;</kbd 
x 








在 第 二 个 查询 里 ， 我 们 不 能 写成 SELECT * FROM testi GROUP BY x, 因为 字段 y 里 没有 哪个 
值 可 以 和 每 个 组 关联 起 来 。 被 分 组 的 字段 可 以 在 选择 列表 中 引用 是 因为 它们 每 个 组 都 有 单一 
的 数值 。 


通常 ， 如 果 一 个 表 被 分 了 组 ， 不 在 croup BY 中 列 出 的 字段 只 能 在 总 表达 式 中 被 引用 。 一 个 带 
聚集 表达 式 的 例子 是 : 


<Samp class="literal">=></samp> <kbd class="literal">SELECT x, sum(y) FROM testi GROUP BY 
x | sum 





这 里 的 sum 2-TREWM, CHALHARM. AXDTANREWAN SSR 
在 Section 9.20 中 找到 。 





Tip: 没有 有 效 的 聚合 表达 式 分 组 可 以 计算 一 列 中 不 同 值 的 设置 。 这 个 可 以 通 
过 DISTINCT 子 句 来 实现 (参考 Section 7.3.3). 


这 里 是 另外 一 个 例子 : 它 计算 每 种 产品 的 总 销售 额 (而 不 是 所 有 产品 的 总 销售 额 )。 


SELECT product_id, p.name, (sum(s.units) * p.price) AS sales 
FROM products p LEFT JOIN sales s USING (product_id) 
GROUP BY product_id, p.name, p.price; 


在 这 个 例子 里 ， 字 段 product id ， p.name 和 p.price 必须 在 croup BY FHS, 因为 它们 
都 在 查询 选择 列表 里 被 引用 了 (但 见 下 文 ) 。 s.units 字段 不 必 在 croup BY 列表 里 ， 因 为 它 
只 是 在 一 个 聚集 表达 式 ( sum(...) ) 里 使 用 ， 它 代 表 一 组 产品 的 销售 总 额 。 对 于 每 种 产品 ， 这 
个 查询 都 返回 一 个 该 产品 的 总 销售 额 。 


ARP CRETE, REE, 那么 它 足够 在 上 面 的 例子 中 
对 product_id 分 组 ， 因为 名 字 和 价格 将 会 函数 依赖 于 产品 ID， 这 样 将 不 会 在 返 反 回 每 个 产品 
ID 组 时 有 名 字 和 价格 的 分 歧 。 


在 严格 的 SQL 里 ， 6GRouP BY be tn 但 PostgreSQL 把 这 个 扩展 为 也 允 
许 GROUP BY 对 选择 列表 中 的 字段 进行 分 组 。 也 人 允许 对 值 表达 式 进行 分 组 ， 而 不 仅仅 是 简单 的 
字段 。 


如 果 一 个 表 已 经 用 croup BY 分 了 组 ， 然后 你 又 只 对 其 中 的 某 些 组 感 兴 趣 ， 那 么 就 可 以 
用 HAvIN6 子 句 算 选 分 组 。 必须 像 wer 子 句 ， 从 结果 中 消除 组 ， 语 法 是 : 


SELECT _select_list_ FROM ... [WHERE ...] GROUP BY ... HAVING _boolean_expression_ 


在 HAVING 子 句 中 的 表达 式 可 以 引用 分 组 的 表达 式 和 未 分 组 的 表达 式 (后 者 必须 涉及 一 个 聚集 
图 数 )。 


例子 
<Samp class="literal">=></samp> <kbd class="literal">SELECT x, sum(y) FROM testi GROUP BY 
x | sum 
Pe ee 
a | 4 
b | 5 
(2 rows) 


<samp class="literal">=></samp> <kbd class="literal">SELECT x, sum(y) FROM testi GROUP BY 


x | sum 
See Seer 
a | 4 
b | 5 
(2 rows) 


= 一 
然后 是 一 个 更 现实 的 例子 





SELECT product_id, p.name, (sum(s.units) * (p.price - p.cost)) AS profit 
FROM products p LEFT JOIN sales s USING (product_id) 
WHERE s.date > CURRENT_DATE - INTERVAL '4 weeks' 
GROUP BY product_id, p.name, p.price, p.cost 
HAVING sum(p.price * s.units) > 5000; 


在 上 面 的 例子 里 ， wer 子 句 根据 未 分 组 的 字段 选择 数据 行 (表达 式 只 是 对 那些 最 近 四 周 发 生 
的 销售 为 真 )。 而 HAVING 子 句 在 分 组 之 后 选择 那些 销售 总 额 超过 5000 的 组 。 请 注意 聚集 表达 
式 不 需要 在 查询 中 的 所 有 地 方 都 一 样 。 


如 果 一 个 查询 调用 了 聚合 画 数 ， 但 没有 croup BY 子 句 ， 分 组 仍然 发 生 : 结果 是 单一 组 行 (或 
者 如 果 单 一 行 被 HAviN6 所 淘汰 ， 那 么 也 许 没有 行 ) 。 同样 ， 它 包含 一 个 nvm 子 句 ， 甚 至 
没有 任何 聚合 事 数 的 调用 或 croup BY 子 句 。 


7.2.4. 窗口 函数 义理 


如 果 查 询 包含 窗口 男 数 (参考 Section 3.5, Section 9.21 和 Section 4.2.8)， 这 些 画 数 在 执行 了 
分 组 、 聚 合 和 HAvIN6 过 滤 之 后 被 评估 。 也 就 是 说 ， 如 果 查 询 使 用 任何 的 聚 

合 、 GRoUP BY 或 HAvING ， ABA ARONA RAT SRA IMAM FRoM / whERE 得 到 的 
原始 表 行 。 


当 多 个 窗口 函数 被 使 用 的 时 候 ， 所 有 在 它们 的 窗口 定义 里 依照 语法 地 等 效 于 

PARTITION BY 和 ORDER BY 子 句 的 窗口 函数 保证 在 同一 个 过 去 的 数据 里 被 评估 。 因此 它们 将 

看 到 同样 的 排序 ， 即使 oror BY 不 唯一 确定 一 个 排序 。 ja bis ea pa pa 
能 有 不 同 的 PARTITION BY 或 ORDER BY 规范 。 (在 这 种 情 一 个 排序 步骤 通常 需要 在 窗 

口 函 数 评估 之 间 传 递 ， 并 且 不 保证 行 的 排序 看 似 跟 ORDER BY ane ) 


Bal, BONA YETEN RAE, MUA WWTP TBO 
PARTITION BY / ORDER BY 子 句 。 它 不 是 说 依赖 于 此 。 如 果 你 想 要 确保 结果 是 按 特定 的 方式 分 
类 那么 使 用 显 式 的 顶级 ORDER BY 子 句 。 


7.3. 选择 列表 


如 前 面 的 小 节 说 明 的 那样 ， 在 sELEcT 命令 中 的 表 表 达 式 通过 组 合 表 、 视图 、 删 除 行 、 分 组 等 
构造 了 一 个 中 介 性 的 虚拟 表 。 这 个 表 最 后 传递 给 选择 列表 处 理 。 选择 列表 判断 最 终 实际 输出 
虚拟 表 的 哪些 字段 。 


7.3.1. 选择 列表 项 


最 简单 的 选择 列表 是 * ， 它 输出 表 表 达 式 生成 的 所 有 字段 。 否则 ， 一 个 选择 列表 是 一 个 逗号 
分 隔 的 值 表达 式 的 列表 (和 在 Section 4.2 里 定义 的 一 样 )。 比 如 ， 它 可 能 是 一 个 字段 名 列表 : 


SELECT a, D, c FROM ... 


字段 名 a,b,c 要 么 是 在 FRoM 子 句 里 引用 的 表 中 字段 的 实际 名 字 ， 要 么 是 Section 7.2.1.2 
里 解释 的 别名 。 选 择 列 表 中 的 名 字 空 间 和 were 子 句 中 的 名 字 空 间 是 一 样 的 ， 除非 你 使 用 了 
分 组 ， 否 则 它 和 HAvING 子 句 中 的 名 字 空 间 也 一 样 。 


如 果 多 个 表 有 重复 的 字段 名 ， 那 么 你 还 必须 给 出 表 名 字 ， 例 如 : 


SELECT tbl1.a, tbl2.a, tbl1.b FROM ... 


当 使 用 多 个 表 时 ， 给 出 表 名 还 有 助 于 引用 该 表 的 所 有 字段 : 


SELECT tbli.*, tbhl2.a FROM ... 


X W Section 7.2.2. 


如 果 将 值 表 达 式 用 于 选择 列表 ， 那 么 它 在 概念 上 向 返回 的 表 中 增加 了 一 个 新 的 虚拟 字段 。 值 
表达 式 为 结果 中 的 每 一 行进 行 一 次 计算 ， 计 算 之 前 用 该 行 的 数值 替换 任何 表达 式 里 引用 的 字 
段 。 不 过 选择 列表 中 的 这 个 表达 式 并 非 一 定 要 引用 来 自 FRoM 子 句 中 表 表 达 式 里 面 的 字段 ， 
比如 ， 它 也 可 以 是 任意 常量 算术 表达 式 。 


7.3.2. 字段 标签 


选择 列表 中 的 列表 项 可 以 赋予 名 字 ， 以 便于 进一步 的 义理 。 例如 在 oRDER BY 子 句 中 的 使 用 或 
通过 客户 端 应 用 程序 显示 。 比 如 : 


SELECT a AS value, b + c AS sum FROM ... 


如 果 没 有 使 用 As 声明 字段 名 字 ， 那 么 系统 将 赋予 一 个 缺 省 值 。 对 于 简单 的 字段 引用 ， 它 是 
该 字段 的 名 字 。 对 于 画 数 调 用 ， 它 是 该 画 数 的 名 字 。 对 于 复杂 表达 式 ， 系 统 会 生成 一 个 通用 
的 名 字 。 


只 有 当 新 列 名 与 任何 PostgreSQL 关键 字 不 匹配 时 as 关键 字 是 可 选 的 〈 见 Appendix C), 您 
可 以 给 列 名 加 上 双 引 号 来 避免 意外 匹配 关键 字 。 例 如 ， vALuE 是 一 个 关键 字 ， 所 以 这 样 是 不 
起 作用 的 : 


SELECT a value, b + c AS sum FROM ... 


但 这 样 可 以 : 

SELECT a "value", b + c AS sum FROM ... 
为 了 防止 和 未 来 补充 的 关键 字 发 生 冲 突 ， 建 议 您 要 么 写 a, 要 么 为 输出 列 名 加 双 引 号 标 
iGo 


Note: 输出 字段 的 命名 和 在 FRoM 子 句 里 的 命名 是 不 一 样 的 (参阅 Section 7.2.1.2), 这 样 
就 允许 你 对 同一 个 字段 命名 两 次 ，FROM 子 句 里 的 名 字 将 被 选择 列表 使 用 ， 而 选择 列表 
中 新 取 的 名 字 将 被 最 终 输 出 。 


7.3.3. DISTINCT 


在 义理 完 选择 列表 之 后 ， 生 成 的 表 可 以 删除 重复 行 。 直 接 在 sELEcT 后 面 写 上 DISTINCT 关键 
字 即 可 : 


SELECT DISTINCT _select_list_... 


如 果 不 用 pistinct 你 可 以 用 aL 声明 保留 所 有 行 的 缺 省 行为 。 

显然 ， 如 果 两 行 里 至 少 有 一 个 字段 值 不 同 ， 那 么 我 们 认为 这 两 行 是 独立 的 。 NULL 在 这 里 被 
认为 是 相同 的 。 

另外 ， 我 们 还 可 以 用 表达 式 来 判断 什么 样 的 行 可 以 认为 是 独立 的 : 


SELECT DISTINCT ON (_expression_ [, ~_expression_~ ...]) _select_list_... 


这 里 的 expression. 是 一 个 值 表达 式 ， 它 为 每 一 行 计算 。 如 果 一 组 行 计 算出 的 该 表达 式 的 值 
都 相同 ， 那 么 就 认为 这 些 行 是 重复 的 ， 并 只 输出 第 一 行 。 请 注意 这 里 的 "第 一 行 "是 不 可 预料 
的 ， 除非 你 在 足够 多 的 字段 上 对 该 查询 进行 了 排序 ， 保 证 到 达 DIsTINCT 过 滤器 时 行 的 顺序 
是 唯一 的 ( pIsTINCT on 将 在 oRDER BY 排序 之 后 处 理 )。 


DISTINCT ON 子 句 不 是 SAL 标准 的 一 部 分 ， 有 时 候 被 认为 是 一 个 糟糕 的 风格 ， 因为 它 的 结果 
是 不 可 判定 的 。 如 果 用 有 可 选 的 croup BY 和 在 FRoM 中 的 子 查询 可 以 达到 目的 ， 那 么 我 们 可 
以 避免 使 用 这 个 构造 ， 但 是 通常 它 是 更 方便 的 方法 。 


7.4. 组 合 查询 


可 以 对 两 个 查询 的 结果 进行 集合 操作 (并 、 交 、 差 )。 语 法 是 : 


_queryi_ UNION [ALL] _query2_ 
_queryi_ INTERSECT [ALL] _query2_ 
_queryi_ EXCEPT [ALL] _query2_ 





query1_ 和 _query2 ”可 以 是 讨论 过 的 所 有 查询 。 集 合 操 作 也 可 以 藤 套 和 级 连 ， 上 比如 : 
_query1_ UNION _query2_ UNION _query3_ 
它 实 际 上 等 价 于 : 


(_query1_ UNION _query2_) UNION _query3_ 


UNION 把 _query2_ 的 结果 附加 到 _query1_，” 的 结果 上 (不 过 我 们 不 能 保证 这 就 是 这 些 行 实 际 的 
返回 顺序 )， 并 且 像 oistinct 那样 删除 结果 中 所 有 重复 的 行 (除非 声明 了 uNION ALL )。 


INTERSECT 返回 那些 同时 存在 于 _query1_ 和 _query2_ 结果 中 的 行 ， 除 非 声 明 
了 INTERSECT ALL, 否则 所 有 重复 行 都 被 删除 。 





EXCEPT 返回 所 有 在 _query1_ 结果 中 但 是 不 在 _query2 ”结果 中 的 行 (有 时 候 这 叫做 两 个 查询 
的 差 )。 除 非 声明 了 except aL, 否则 所 有 重复 行 都 被 删除 。 


为 了 能 够 计算 两 个 查询 的 并 、 交 、 差 ， 这 两 个 查询 必须 是 "并 集 兼 容 的 "， 也 就 是 它们 都 返回 
同样 数量 的 列 ， 并 且 对 应 的 列 有 兼容 的 数据 类 型 ， 就 像 Section 10.5 里 描述 的 那样 。 


7.5. 行 排序 


在 查询 生成 输出 表 之 后 ， 也 就 是 在 处 理 完 选择 列表 之 后 ， 你 还 可 以 对 输出 表 进 行 排序 。 如 果 
没有 排序 ， 那 么 行将 以 不 可 预测 的 顺序 返回 (实际 顺序 将 取决 于 扫描 和 连接 规划 类 型 和 在 磁 意 
上 的 顺序 ， 但 是 肯定 不 能 依赖 这 些 未 西 )。 确 定 的 顺序 只 能 在 明确 地 使 用 了 排序 步骤 之 后 才能 
保证 。 


ORDER BY 子 句 用 于 声明 排序 顺序 : 


SELECT _select_list_ 
FROM _table_expression_ 
ORDER BY _sort_expressioni1_ [ASC | DESC] [NULLS { FIRST | LAST }] 
[, ~_sort_expression2_~ [ASC | DESC] [NULLS { FIRST | LAST }] ...] 


sort_expression 是 任何 可 用 于 选择 列表 的 表达 式 ， 例 如 : 


SELECT a, b FROM table1 ORDER BY a + b, C; 


如 果 指 定 了 多 个 排序 表达 式 ， 那 么 久 在 前 面 的 表达 式 排序 相等 的 情况 下 才 使 用 后 面 的 表达 式 
做 进一步 排序 。 每 个 表达 式 都 可 以 跟 一 个 可 选 的 asc (AE, A) 或 ese (降序 ) 以 设置 排序 
方向 。 升序 先 输出 小 的 数值 ， 这 里 的 "小 "是 以 at; 操作 符 的 角度 定义 的 。 类 似 的 是 ， 降 序 
是 以 agt; 操作 符 来 判断 的 。 [1] 

NULLS FIRST 和 NULLS LAST 选项 可 以 决定 在 排序 操作 中 在 non-null 值 之 前 还 是 之 后 。 默 认 情 
况 下 ， 空 值 大 于 任何 非 空 值 ; 也 就 是 说 ， pEsc 排序 默认 是 NULLS FIRST, AN) 

为 NULLS LAST 。 

注意 ， 排 序 选 项 对 于 每 个 排序 列 是 相对 独立 的 。 例 如 oRDER BY x, y DESC 意思 是 

说 ORDER BY x ASC, y DESC ， 不 同 于 ORDER BY x DESC, y DESC o 


一 个 _sort_expression. 也 可 以 是 字段 名 或 字段 编号 ， 如 : 


SELECT a + b AS sum, c FROM table1 ORDER BY sum; 
SELECT a, max(b) FROM table1 GROUP BY a ORDER BY 1; 


都 按照 第 一 个 字段 进行 排序 。 需 要 注意 的 是 ， 输 出 字段 名 必须 是 独立 的 (不 允许 在 表达 式 中 使 
用 )。 比如 ， 下 面 的 语句 是 错误 的 : 


SELECT a + b AS sum, c FROM table1 ORDER BY sum + C; -- 错误 的 


这 样 的 限制 主要 是 为 了 避免 歧义 。 另 外， 如 果 某 个 排序 表达 式 能 够 同时 匹配 输出 字段 名 和 表 
表达 式 中 的 字段 名 ， 也 会 导致 歧义 (此 时 使 用 输出 字段 名 )。 当 然 ， 这 种 情况 仅 在 你 使 用 了 As 
重 命名 输出 字段 并 且 恰 好 与 其 它 表 的 字段 同名 的 时 候 才 会 发 生 。 

ORDER BY 可 以 应 用 于 UNION ，INTERSECT , EXCEPT 组 合 的 计算 结果 ， 不 过 在 这 种 情况 下 ， 只 
允许 按照 字段 的 名 字 或 编号 进行 排序 ， 而 不 允许 按照 表达 式 进 行 排序 。 


Notes 


[1] 事实 上 ，PostgreSQL 使 用 默认 的 B-tree 操 作 符 类 为 表达 式 的 数据 类 型 确定 asc 和 pesc HE 
序 顺序 。 一 般 来 说 ， 数 据 类 型 将 被 转换 为 适合 于 ait; 和 egt; 操作 符 进 行 排序 。 但 是 对 于 
用 户 自 定义 的 数据 类 型 可 以 不 必 如 此 。 


7.6. LIMIT 和 OFFSET 


LIMIT 和 oFFSET 子 句 允许 你 只 取出 查询 结果 中 的 一 部 分 数据 行 : 


SELECT _select_list_ 
FROM _table_expression_ 
[ ORDER BY ... ] 
[ LIMIT { ~_number_~ | ALL } ] [ OFFSET ~_number_~ ] 


如 果 给 出 了 一 个 LIMIT 计数 ， 那 么 将 返回 不 超过 该 数字 的 行 (也 可 能 更 少 些 ， 因为 可 能 查询 本 
身 生 成 的 总 行 数 就 比较 少 )。 LIMIT aL 和 省 略 LIMIT 子 句 是 一 样 的 。 


oFFSET 指明 在 开始 返回 行 之 前 忽略 多 少 行 。 oFFsET o 和 省 略 oFFsET 子 句 是 一 样 
的 ， LIMIT NULL 和 省 略 vomit 子 句 是 一 样 的 。 如 果 oFFSET 和 LIMIT 都 出 现 了 ， 那 么 在 计算 
返回 的 LIMIT 之 前 先 忽 略 oFFSET 指定 的 行 数 。 


使 用 Lmt 的 同时 使 用 oRDER BY 子 句 把 结果 行 约束 成 一 个 唯一 的 顺序 是 一 个 好 主意 。 否则 你 
就 会 得 到 一 个 不 可 预料 的 子 集 。 你 要 的 可 能 是 第 十 到 二 十 行 ， 但 以 什么 顺序 的 十 到 二 十 ? 除 
非 你 声明 了 orr BY ， 否 则 顺序 是 未 知 的 。 


查询 优化 器 在 生成 查询 规划 的 时 候 会 考虑 LIMIT ， 因此 如 果 你 给 LIMIT 和 oFFsET 的 值 不 

同 ， 那么 你 很 可 能 得 到 不 同 的 规划 (产生 不 同 的 行 顺序 )。 因 此 ， 使 用 不 同 

的 LIMIT / oFFSET 值 选择 不 同 的 子 集 将 生成 不 一 致 的 结果 ， 除非 你 用 oRDER BY 强制 一 个 可 预 
料 的 顺序 。 这 可 不 是 臭虫 ， 而 是 一 个 很 自然 的 结果 ， 因 为 SQL 没有 许诺 把 查询 的 结果 按照 任 
何 特定 的 顺序 发 出 ， 除非 用 了 oRDER BY 来 约束 顺序 。 


OFFSET 子 句 忽略 的 行 仍然 需要 在 服务 器 内 部 计算 ; 因此 ， 一 个 很 大 的 oFFSET 可 能 还 是 不 够 
有 效率 。 


7.7. VALUES 列表 


可 以 在 查询 中 使 用 由 values 生成 的 "常数 表 "， 而 无 需 在 磁盘 上 实际 创建 这 个 表 。 语 法 如 下 : 


VALUES ( expression. [, ...] ) [, ...] 


每 个 括号 中 的 表达 式 列表 生成 表 中 的 一 行 。 每 个 列表 中 的 项 数 (也 就 是 字段 数 ) 必 须 相 等 ， 并 
且 对 应 的 数据 类 型 必须 兼容 。 最 终 表 中 每 个 字段 的 数据 类 型 将 使 用 与 unton (参见 Section 
10.5) 相 同 的 规则 确定 。 


例如 : 


VALUES (1, 'one'), (2, 'two'), (3, 'three'); 


将 得 到 2 列 3 行 的 表 。 并 且 和 与 下 面 的 语句 等 价 : 


SELECT 1 AS columni, 'one' AS column2 
UNION ALL 

SELECT 2, 'two' 

UNION ALL 

SELECT 3, 'three'; 


PostgreSQL 默 认 将 vALuEs 所 得 到 的 表 中 各 字段 分 别 命名 为 column1 , column SS, SQL 
标准 并 未 规定 此 种 情况 下 的 字段 名 命名 规范 ， 不 同 的 数据 库 系 统 对 此 的 处 理 也 各 不 相同 ， 所 
以 最 好 明确 指定 字段 的 名 字 ， 像 下 面 这 样 : 


=> SELECT * FROM (VALUES (1, 'one'), (2, 'two'), (3, 'three')) AS t (num,letter); 
num | letter 


1 | one 

2 | two 

3 | three 
(3 rows) 


语法 上 ， 带 有 表达 式 列表 的 vALuEs 和 下 面 的 语句 等 价 : 


SELECT _select_list_ FROM _table_expression_ 





并 且 可 以 出 现在 任何 seLEcT 可 以 出 现 的 地 方 。 例 如 ， 你 可 以 把 它 用 于 unton 的 一 部 分 ， 或 
者 在 其 上 附加 一 个 _sort_specification_ ( ORDER BY , LIMIT , OFFSET )。 VALUES 通常 用 


VE INSERT 命令 的 数据 源 或 者 子 查询 。 


更 多 信息 参见 VALUES。 


7.8. WITH 查询 (通用 表 表 达 式 ) 


with 提供 了 一 种 在 更 大 的 查询 中 编写 辅助 语句 的 方式 。 这 个 通常 称 为 通用 表 表 达 式 或 CTEs 
的 辅助 语句 可 以 认为 是 定义 只 存在 于 一 个 查询 中 的 临时 表 。 每 个 WITH 子 句 中 的 辅助 语句 可 
以 是 一 个 SELECT , INSERT ，UPDATE 或 DELETE ; 并 且 with 子 句 本 身 附加 到 的 初级 语句 可 以 


是 一 个 SELECT , INSERT , UPDATE 或 DELETE 。 


7.8.1. WITH 中 的 SELECT 
WITH 中 SELECT 的 本 意 是 为 了 将 复杂 的 查询 分 解 为 更 简单 的 部 分 。 一 个 例子 是 


WITH regional_sales AS ( 
SELECT region, SUM(amount) AS total_sales 
FROM orders 
GROUP BY region 
), top_regions AS ( 
SELECT region 
FROM regional_sales 
WHERE total_sales > (SELECT SUM(total_sales)/10 FROM regional_sales) 
) 
SELECT region, 
product, 
SUM(quantity) AS product_units, 
SUM(amount) AS product_sales 
FROM orders 
WHERE region IN (SELECT region FROM top_regions) 
GROUP BY region, product; 


它 显示 了 每 个 产品 仅 在 销售 区 域 的 销售 总 额 。 WITH 子 句 定义 了 两 个 名 为 ”regional_sales 和 
top_regions 的 辅助 语句 ， regional_sales 的 输出 用 于 top_regions , 而 top_regions 的 输 
出 用 于 初级 的 SELECT 查询 。 这 个 例子 也 可 以 不 用 with 来 写 ， 但 是 需要 两 级 谋 套 的 

F SELECT 查询 。 用 这 种 方法 更 容易 理解 。 


可 选 的 RECURSIVE 修饰 符 将 with 从 一 个 单纯 的 语法 方便 改变 为 在 SQL 标准 中 不 可 能 实现 的 功 
能 。 使 用 REcuRSIVE ， 一 个 WITH 查询 可 以 引用 它 自己 的 输出 。 一 个 非常 简单 的 例子 是 查询 1 
到 100 的 和 : 
WITH RECURSIVE t(n) AS ( 
VALUES (1) 
UNION ALL 


SELECT n+1 FROM t WHERE n < 100 


) 
SELECT sum(n) FROM t; 


递归 with 查询 的 一 般 形式 总 是 一 个 non-recursive term, 然后 unton (或 
2 UNION ALL ) ， 然 后 一 个 recursive term, 其 中 只 有 递归 的 术语 可 以 包含 一 个 对 查询 自己 输 
出 的 引用 。 这 样 一 个 查询 像 下 面 那样 执行 


递归 查询 评估 

1. 评估 非 递归 的 术语 。 使 用 unton (而 不 是 uwo aL ) 去 除 重复 的 行 。 包括 在 递归 查询 
结果 中 所 有 剩余 的 行 ， 并 将 它们 放 入 临时 的 工作 表 。 

2， 只 要 工作 表 不 为 空 ， 那 么 将 重复 这 些 步骤 : 


i， 评 估 递 蚊 术 语 ， 为 递归 自我 参照 蔡 换 当前 工作 表 内 容 。 用 uno (并 不 
是 UNION ALL), 去 除 重复 的 行 和 和 与 以 前 结果 行 重 复 的 行 。 包 括 所 有 在 递归 查询 结果 
中 剩余 的 行 ， 并 将 它们 放 入 一 个 临时 的 中 间 表 。 


ii， 用 中 间 表 的 内 容 蔡 换 工 作 表 的 内 容 ， 然 后 清空 中 间 表 。 





Note: 严格 的 说 ， 该 过 程 是 迭代 而 不 是 递归 ， 但 是 Recursive 是 通过 SQL 标准 委员 会 选 
择 的 术语 。 
在 上 面 的 例子 中 ， 在 每 一 步 中 公有 一 个 工作 表 行 ， 并 且 在 后 续 的 步骤 中 它 的 值 将 从 1 升 至 
100。 在 第 100 步 ， 因 为 whERE 子 句 的 原因 没有 任何 输出 ， 因 此 查询 终止 。 





递归 查询 通常 用 于 处 理 分 层 或 树 状 结构 数据 。 一 个 有 用 的 示例 查询 是 查找 所 有 直接 或 间接 的 
产品 的 附带 部 分 ， 仅 提供 一 个 表 来 显示 即时 的 包含 : 


WITH RECURSIVE included_parts(sub_part, part, quantity) AS ( 
SELECT sub_part, part, quantity FROM parts WHERE part = 'our_product' 
UNION ALL 
SELECT p.sub_part, p.part, p.quantity 
FROM included_parts pr, parts p 
WHERE p.part = pr.sub_part 


SELECT sub_part, SUM(quantity) as total_quantity 
FROM included_parts 
GROUP BY sub_part 


当 使 用 递 轨 查询 的 时 候 ， 确 保 查 询 的 递归 部 分 最 终 不 会 返回 元 组 是 很 重要 的 ， 否则 查询 将 会 
无 限 的 循环 下 去 。 有 时 ， 通 过 使 用 unzon 替代 uo ALL 去 除 掉 与 前 面 输出 重复 的 行 可 以 实 
现 这 个 。 然 而 ， 通 常 一 个 周期 不 涉及 那些 完全 复制 的 输出 行 : 检查 一 个 或 几 个 字段 来 查看 是 
否 存在 事先 达成 的 相同 点 可 能 是 必要 的 。 人 处理 这 种 情况 的 标准 方式 是 计算 一 个 已 经 访问 过 的 
数值 的 数组 。 例如 ， 请 考虑 下 面 的 查询 ， 使 用 link 字段 搜索 一 个 表 graph : 


WITH RECURSIVE search_graph(id, link, data, depth) AS ( 
SELECT g.id, g.link, g.data, 1 
FROM graph g 
UNION ALL 
SELECT g.id, g.link, g.data, sg.depth + 1 
FROM graph g, search_graph sg 
WHERE g.id = sg.link 


) 
SELECT * FROM search_graph; 


如 果 link 关系 包含 循环 那么 这 个 查询 将 会 循环 。 因为 我 们 需要 一 个 "深度 "输出 ， 仅 改 
变 UNION ALL 为 UNION 将 不 会 相反 ， 我 们 需要 认识 到 当 我 们 按照 特定 的 链接 路 径 
时 是 否 再 次 得 到 了 相同 的 行 。 我 们 添加 两 列 path 和 cycle 到 倾向 循环 的 查询 : 


WITH RECURSIVE search_graph(id, link, data, depth, path, cycle) AS ( 

SELECT g.id, g.link, g.data, 1, 
ARRAY[g.id], 
false 

FROM graph g 

UNION ALL 

SELECT g.id, g.link, g.data, sg.depth + 1, 
path || g.id, 
g.id = ANY(path) 

FROM graph g, search_graph sg 

WHERE g.id = sg.link AND NOT cycle 


) 
SELECT * FROM search_graph; 


除了 防止 循环 ， 该 数组 值 通常 是 有 用 的 ， 在 它 的 右边 作为 代表 用 来 得 到 任何 特定 行 的 "路 径 " 
多 个 字 


在 一 般 情况 下 ， 需 要 检测 
对 比 字 段 ft 和 f2 


字段 来 识别 一 个 循环 时 使 用 一 个 行 数组 。 例 如 ， 如 果 我 们 需 


WITH RECURSIVE search_graph(id, link, data, depth, path, cycle) AS ( 

SELECT g.id, g.link, g.data, 1, 
ARRAY[ROW(g.f1, g.f2)], 
false 

FROM graph g 

UNION ALL 

SELECT g.id, g.link, g.data, sg.depth + 1, 
path || ROW(g.f1, g.f2), 
ROW(g.f1, g.f2) = ANY(path) 

FROM graph g, search_graph sg 

WHERE g.id = sg.link AND NOT cycle 


) 
SELECT * FROM search_graph; 





Tip: 在 常见 的 情况 下 ， 当 只 需要 检查 一 个 字段 来 识别 循环 的 时 候 忽 略 Row() 语法 。 这 人 允 
许 使 用 一 个 简单 的 数组 而 不 是 一 个 复杂 类 型 的 数组 ， 增 加 查询 的 效率 。 





ug 递归 查询 评估 算法 产生 以 广度 优先 搜索 顺序 的 输出 。 您 可 以 按照 深度 优先 查询 排序 
过 外 部 查询 oRDER BY 一 个 "path" 列 来 显示 结果 。 


当 您 不 能 确定 它们 是 否 会 循环 的 时 候 ， 在 一 个 父 查 询 中 放置 Limit 是 一 个 对 于 测试 查询 有 用 
的 技巧 。 例如 ， 这 个 查询 将 在 没有 LIMIT 的 情况 下 无 限 循环 : 


WITH RECURSIVE t(n) AS ( 
SELECT 1 
UNION ALL 
SELECT n+1 FROM t 


) 
SELECT n FROM t LIMIT 100; 


它 能 工作 是 因为 PostgreSQL 的 实现 评估 只 有 with 查询 的 行 实际 上 是 通过 父 查询 获取 的 。 在 
实际 的 生产 环境 下 不 推荐 使 用 该 技巧 ， 因 为 其 它 的 系统 可 能 以 不 同 的 方式 工作 。 同样 ， 如 果 
您 使 用 外 部 查询 将 递归 查询 结果 排序 或 将 它们 加 入 到 别 的 表 中 ， 那么 它 通 常 是 不 工作 的 ， 
为 在 这 种 情况 下 外 部 查询 将 获取 所 有 with 查询 的 输出 。 


一 个 有 用 的 with 查询 属性 是 每 个 父 查 询 执行 一 次 它们 只 做 一 次 评估 ， 即使 它们 不 止 一 次 地 
通过 父 查 询 或 with 查询 引用 。 所 以 ， 昂贵 的 需要 在 多 个 地 方 放 置 的 计算 可 以 通过 设 

E WITH 查询 来 避免 见 余 工作 。 另 一 个 可 能 的 应 用 是 防止 不 必要 的 副作用 函数 的 多 个 评估 。 
然而 ， 另 一 方面 ， 上 比 起 普通 的 子 查 询 ， 优化 器 不 能 够 避 开 父 查 询 拆 分 为 一 个 with 查询 的 限 
制 。 通 常 WITH 查询 将 如 上 评估 ， 没 有 行 限制 的 父 查 询 可 能 丢失 。 (但 是 ， 正 如 上 面 所 说 ， 
如 果 查 询 人 参考 只 需要 数量 有 限 的 行 ， 评 估 可 能 会 很 早 终止 。) 


上 面 的 例子 只 显示 了 wo 在 sELECT 中 的 使 用 ， 但 是 它 也 可 以 用 同样 的 方式 附加 到 INSERT , 
UPDATE 或 DELETE. 在 每 种 情况 下 它 都 有 效 的 提供 可 以 在 主要 的 命令 中 引用 的 临时 表 。 


7.8.2. WITH 中 的 数据 修改 语句 


你 可 以 在 with 中 使 用 数据 修改 语句 ( INSERT, UPDATE 或 DELETE )。 这 人 允许 你 在 相同 的 查询 
中 执行 几 个 不 同 的 操作 ， 一 个 例子 是 : 


WITH moved_rows AS ( 
DELETE FROM products 
WHERE 
"date" >= '2010-10-01' AND 
"date" < '2010-11-01' 
RETURNING * 


) 
INSERT INTO products_log 
SELECT * FROM moved_rows; 


这 个 查询 有 效 的 移动 products 中 的 行 到 products_log o WITH 中 的 DELETE 从 products 中 删 
除 指定 的 行 ， 并 且 通 过 RETURNING 子 句 返回 它们 的 内 容 ; 然后 初级 查询 读 取 那个 输出 并 且 插 


人 到 products_log 中 。 


上 面 例子 的 一 个 优点 是 with 子 句 是 附加 到 insert, 而 不 是 INSERT 中 的 子 SELECT 查询 。 
这 是 必须 的 ， 因 为 数据 修改 语句 只 人 允许 在 附加 到 顶级 语句 的 with 子 句 中 使 用 。 然而 ， 因 为 
正常 的 with 可 见 性 规则 的 应 用 ， 所 以 从 子 sELECT 查询 中 引用 with 语句 的 输出 是 可 能 的 。 


moa 


在 with 中 的 数据 修改 语句 通常 都 有 RETURNING 子 句 ， 就 像 上 面 的 例子 一 样 。 它 
是 RETURNING 子 句 的 输出 ， 不 是 数据 修改 语句 的 目标 表 ， 形成 的 临时 表 可 以 被 其 他 的 查询 引 
用 。 如 果 with 中 的 数据 修改 语句 缺少 了 RETURNING 子 句 ， 那 么 将 没有 临时 表 生 成 ， 也 就 不 能 
被 其 他 的 查询 引用 。 这 样 的 语句 将 仍然 被 执行 。 一 个 不 是 特别 有 用 的 例子 是 : 


WITH t AS ( 
DELETE FROM foo 


) 
DELETE FROM bar; 


这 个 例子 将 删除 表 foo 和 bar 中 的 所 有 行 。 报告 给 客户 端的 受 影响 行 的 数量 将 只 包含 
从 bar 中 删除 的 行 。 


数据 修改 语句 中 不 允许 递归 的 自 引 用 。 在 某 些 情况 下 通过 引用 递归 的 with 输出 ， 可 能 绕 开 
这 个 限制 ， 例 如 : 


WITH RECURSIVE included_parts(sub_part, part) AS ( 
SELECT sub_part, part FROM parts WHERE part = 'our_product' 
UNION ALL 
SELECT p.sub_part, p.part 
FROM included_parts pr, parts p 
WHERE p.part = pr.sub_part 


) 
DELETE FROM parts 
WHERE part IN (SELECT part FROM included_parts); 


这 个 查询 将 删除 一 个 产品 所 有 直接 或 非 直 接 的 subparts。 


WITH 中 的 数据 修改 语句 被 直接 执行 一 次 ， 并 且 总 是 完成 ， 独立 的 主 查询 读 取 所 有 (MAX 
际 上 是 任意 ) 它们 的 输出 。 注意 ， 这 和 在 with 中 sect 的 规则 不 同 : 就 像 前 一 节 规 定 的 那 
样 ， sELECT 的 执行 直到 首 级 查询 需要 它 的 输出 时 才 实 施 。 


with 中 的 子 语句 之 间 和 和 与 主 查询 之 间 兼 容 的 执行 。 因 此 ， 当 在 with 中 使 用 数据 修改 语句 
时 ， 其 他 的 指定 的 更 新 实际 上 是 不 可 预知 发 生 的 。 所 有 的 语句 都 在 相同 的 快照 中 执行 CL 
Chapter 13) ， 所 以 他 们 不 能 "看 见 "彼此 对 目标 表 的 影响 。 这 样 减轻 了 实际 行 更 新 的 不 可 预知 
的 影响 ， 并 且 意 味 着 RETURNING 数据 是 唯一 在 不 同 的 w 子 语 句 和 主 查询 间 交 流 变 化 的 方 
式 。 一 个 例子 是 : 


WITH t AS ( 
UPDATE products SET price = price * 1.05 
RETURNING * 


) 
SELECT * FROM products; 


外 层 的 secect 将 在 uppate 动作 之 前 返回 原价 ， 而 在 : 


WITH t AS ( 
UPDATE products SET price = price * 1.05 
RETURNING * 


) 
SELECT * FROM t; 


中 ， 外 层 sect 将 返回 更 新 了 的 数据 。 


不 支持 尝试 在 一 个 语句 中 更 新 相同 的 行 两 次 。 如 果 尝 试 了 ， 那 么 只 有 一 个 修改 会 发 生 ， 但 是 
不 容易 (或 者 有 时 不 可 能 ) 准确 预测 是 哪 一 个 。 这 个 同样 适用 于 删除 一 个 已 经 在 相同 语句 中 
更 新 了 的 行 : 只 有 更 新 被 执行 。 因 此 你 通常 应 该 避免 尝试 在 一 个 语句 中 修改 一 个 行 两 次 。 特 
BIN, 避免 写 可 能 影响 被 主语 名 或 同 级 子 语 名 改变 了 的 行 的 with 子 语句 。 这 样 一 个 语句 的 
影响 将 是 不 可 预测 的 。 


目前 ， 任 何 作为 在 wrTh 中 的 数据 修改 语句 目标 的 表 ， 不 必 有 扩展 到 多 个 语句 的 条 件 规则 、 


ALSO 规则 和 INSTEAD 规则 。 
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PostgreSQL 有 着 丰富 的 内 置 数据 类 型 可 用 。 用 户 还 可 以 使 用 CREATE TYPE 命 令 增 加 新 的 数 
据 类 型 。 


Table 8-1 显 示 了 所 有 内 时 


9 普通 数据 类 型 。 在 "别名 " 列 里 列 出 的 大 多 数 可 选 名 字 都 是 因 历 史 


原因 PostgreSQL 在 内 部 使 用 的 名 字 。 另 外 ， 还 有 一 些 内 部 使 用 的 或 者 废弃 的 类 型 也 可 以 使 


用 ， 但 没有 在 这 里 列 出 。 
Table 8-1. 数据 类 型 


名 字 
bigint 
bigserial 
Eee ee) | 


bit varying) [| (Gane )] 
boolean 

box 

bytea 

character varying [ (`` _n_ )] 
character [ ( mn. )] 

cadr 

cnrcele 


date 

double precision 
inet 

integer 


interval [ fields ][( p 





Jame 

lseg 

macaddr 

money 

numerici (C p., msa )] 


path 
point 


polygon 


别名 描述 
int8 有 符号 8 字 节 整数 
serials 自 增 8 字 节 整 数 
定 长 位 串 
varbit 变 长 位 串 
bool 逻辑 布尔 值 ( 真 / 假 ) 
平面 上 的 矩形 
二 进 制 数据 (" 字 节 数组 ") 
varchar [ (~*_n_ )] KFR 
char [ (C` n_)] 定 长 字符 串 
IPv4 或 IPv6 网 络 地 址 
HEN 
日 历 日 期 (年 , H, 日) 
eae 双 精 度 浮 点 数字 (8 
PP) 


IPv4 或 IPv6 主机 地 址 
anea, fame 
时 间 间 隔 
平面 上 的 无 限 长 直线 
平面 上 的 线段 


MAC (Media Access 
Control) 地 址 


货币 金额 
decimam (mp, Pasa )] 


平面 上 的 几何 路 径 
平面 上 的 点 
平面 上 的 封闭 几何 路 径 

单 精度 浮 点 数 (4 F 


smallint 
smallserial 
serial 


text 


time [ (C`_p_ )][ without time 
zone ] 


time [ (``_p_ )] with time zone 
timestamp [ (~°_p_ )][ without 
time zone ] 


timestamp [ (°*_p_ ) ] with time 
zone 


tsquery 
tsvector 
txid_snapshot 
uuid 

xml 


json 


兼容 性 : 下 列 类 型 (或 者 那样 拼写 的 ) 是 SQL 声明 的 : bigint , bit , 


boolean , char , 


integer , interval , numeric 


timestamp (有 时 区 和 无 时 区 )， xml o 


character varying 


decimal , real 


int2 有 符号 2 字 节 整数 
serial2 ie 2 字 节 整数 
serial4 Ble 4 字 节 整数 
LKEBH 


一 天 中 的 时 间 (无 时 区 ) 


一 天 里 的 时 间 ， 包 
括 时 区 


timetz 


日 期 和 时 间 ( 无 时 区 ) 


日 期 和 时 间 ， 包 括 
时 区 


timestamptz 
文本 检索 查询 

文本 检索 文档 

用 户 级 别 的 事务 ID 快照 
通用 唯一 标识 符 
XML 数据 

JSON 数据 


bit varying 


varchar , date , double precision , 


time (有 时 区 和 无 时 区 )， 


character 


smallint , 


每 种 数据 类 型 都 有 一 个 由 其 输入 和 输出 画 数 决定 的 外 部 表现 形式 。 许多 内 建 的 类 型 有 明显 的 
格式 。 不 过 ， 许 多 类 型 要 么 是 PostgreSQL 所 特有 的 ， 上 比如 几何 路 径 ， 要 么 是 有 几 种 不 同 的 格 
式 ， 上 比如 日 期 和 时 间 类 型 。 有 些 输入 和 输出 函数 是 不 可 道 的 。 也 就 是 说 ， 输出 函数 的 输出 结 
果 和 原始 的 输入 比较 的 时 候 可 能 丢失 精度 。 


8.1. 数值 类 型 


数值 类 型 由 2 、4 或 8 字 节 的 整数 以 及 4 或 8 字 
8-2 列 出 了 所 有 可 用 类 型 。 


Table 8-2. 数值 类 型 


名 字 


smallint 


integer 


bigint 


decimal 


numeric 


real 


double precision 


smallserial 


serial 


bigserial 


数值 类 型 常量 的 语法 在 Section 4.1.2 里 描述 。 








小 范围 整数 
常用 的 整数 


大 范围 整数 
用 户 声明 精 
度 ， 精 确 


用 户 声明 精 
度 ， 精 确 


变 精度 ， 不 精 
if 
变 精度 ， 不 精 
if 


小 范围 自 增 整 
数 


节 的 浮 点 数 和 可 选 精度 的 小 数组 成 。 Table 


范围 


-32768 到 +32767 


-2147483648 到 +2147483647 


-9223372036854775808 到 
+9223372036854775807 


小 数 点 前 131072 位 ; 小 数 点 后 16383 
位 


小 数 点 前 131072 位 ; 小 数 点 后 16383 
位 


6 位 十 进 制 数字 精度 


15 位 十 进 制 数字 精度 


1 到 32767 


1 到 2147483647 


1 到 9223372036854775807 


数值 类 型 对 应 有 一 套 完整 的 数学 操作 符 和 图 


数 。 相 关 信 息 请 参考 Chapter 9。 下 面 的 几 节 详细 描述 这 些 类 型 。 


8.1.1. 整数 类 型 


snallint ， integer 和 bigint 类 型 存储 各 种 范围 的 全 部 是 数字 的 数 ， 也 就 是 没有 小 数 部 分 
的 数字 。 试 图 存储 超 出 范围 以 外 的 数值 将 导致 一 个 错误 。 


常用 的 类 型 是 integer , 因为 它 提供 了 在 范围 、 存储 空间 、 性 能 之 间 的 最 佳 平衡 。 一 般 只 有 
在 磁盘 空间 紧张 的 时 候 才 使 用 smallint o 当 integer 的 范围 不 够 的 时 候 才 使 用 bigint o 


SQL 只 声明 了 整数 类 型 integer (或 int )， smallint 和 bigint 。 类 型 int2, inta 
和 ints 都 是 扩展 ， 并 且 也 在 许多 其 它 SQL 数 据 库 系统 中 使 用 。 


8.1.2. 任意 精度 数值 


numeric 类 型 可 以 存储 非常 大 的 数字 并 且 准 确 地 进 和 Tit Fo 我 们 特别 建议 将 它 用 于 赏 egies 
和 其 它 要 求 精确 计算 的 场合 。 不 过 ， numeric 类 型 上 的 算术 运算 比 整数 类 型 或 者 我 们 下 一 
描述 的 浮 点 数 类 型 要 慢 很 多 。 


在 随后 的 内 容 里 ， 我 们 使 用 下 述 术 语 : 一 个 numeric 类 型 的 标 度 (scale) 是 小 数 部 分 的 位 数 ， 
精度 (precision) 是 全 部 数据 位 的 数目 ， 也 就 是 小 数 点 两 边 的 位 数 总 和 。 因此 数字 23.5141 的 
精度 为 6 而 标 度 为 4。 你 可 以 认为 整数 的 标 度 为 需 。 


numeric 字段 的 最 大 精度 和 最 大 标 度 都 是 可 以 配置 的 。 要 声明 一 个 字段 的 类 型 为 numeric ， 
你 可 以 用 下 面 的 语法 : 


NUMERIC(_precision_, _scale_) 


精度 必须 为 正 数 ， 标 度 可 以 为 雳 或 者 正 数 。 AM: 


NUMERIC(_precision_) 


选择 了 标 度 为 0 。 不 带 任何 精度 与 标 度 的 声明 


NUMERIC 


则 创建 一 个 可 以 存储 一 个 直到 实现 精度 上 限 的 任意 精度 和 标 度 的 数值 ， 一 个 这 样 类 型 的 字段 
将 不 会 把 输入 数值 转化 成 任何 特定 的 标 度 ， 而 带 有 标 度 声明 的 numeric 字段 将 把 输入 值 转化 
为 该 标 度 。 SQL 标准 要 求 缺 省 的 标 度 是 0( 也 就 是 转化 成 整数 精度 )。 我 们 觉得 这 样 做 有 点 没 
用 。 如 果 你 关心 移植 性 ， 那 你 最 好 总 是 明确 声明 精度 和 标 度 。 


Note: 当 在 类 型 声明 中 显示 指定 精度 时 人 允许 的 最 大 值 为 1000 ; 没有 指定 精度 的 
NUMERIC 遵从 Table 8-2 里 的 描述 。 






































如 果 一 个 要 存储 的 数值 的 标 度 比 字段 声明 的 标 度 高 ， 那么 系统 将 尝试 圆 整 (四 舍 五 入 ) 访 数值 
到 指定 的 小 数位 。 然 后 ， 如 果 小 数 点 左边 的 数据 位 数 超过 了 声明 的 精度 减 去 声明 的 标 度 ， 那 
么 将 抛 出 一 个 错误 。 


numeric 类 型 的 数据 值 在 物理 上 是 不 带 任何 前 导 或 者 后 级 雳 的 形式 存储 的 。 因此 ， 字 段 上 声 
明 的 精度 和 标 度 都 是 最 大 值 ， 而 不 是 固定 分 配 的 。 在 这 个 方面 ， numeric 类 型 更 类 似 

于 varchar(`、_n_ ) 而 不 是 char(`…_n )。 实 际 存储 是 每 四 个 十 进 制 位 两 个 字 节 ， 然后 在 整个 
数据 上 加 上 三 到 八 个 字 节 的 额外 开销 。 


除了 普通 的 数字 值 之 外 ， numeric 类 型 允许 用 特殊 值 NaN 表示 "不 是 一 个 数字 "。 任 何 

在 nan 上 面 的 操作 都 生成 另外 一 个 nan. MRE SQL 命令 里 把 这 些 值 当 作 一 个 常量 写 ， 你 
必须 在 其 周围 放 上 单 引 号 ， 比 如 UPDATE table SET x = 'NaN' o 在 输入 时 ， 字 符 串 NaN 是 大 
小 写 无 关 的 。 


Note: 在 大 多 数 "not-a-number" 概 念 中 ， 不 认为 NaN 等 于 其 他 数值 类 型 (包括 nan ) o 
为 了 能 够 存储 numeric 类 型 的 值 ， 并 且 使 用 Tree 索引 ，PostgreSQL 认 为 nan 相等 ， 并 
且 大 于 所 有 非 nan to 


类 型 decimal 和 numeric 是 等 效 的 。 两 种 类 型 都 是 SQL 标准 。 


8.1.3. 浮 点 数 类 型 


数据 类 型 real 和 double precision 是 不 精确 的 、 变 精度 的 数字 类 型 。 实际 上 上， 这些 类 型 是 
IEEE 754 标 准 二 进 制 浮 点 数 算术 (分 别 对 应 单 和 双 精 度 ) 的 一 般 实现 ， 外 加 下 层 处 理 器 、 操 作 
系统 和 编译 器 对 它 的 支持 。 


不 精确 意味 着 一 些 数值 不 能 精确 地 转换 成 内 部 格式 并 且 是 以 近似 值 存 储 的 ， 因此 存储 后 再 把 
数据 打印 出 来 可 能 有 一 些 差 异 。 处 理 这 些 错 误 以 及 这 些 错误 是 如 何在 计算 中 传播 的 属于 数学 
和 计算 机 科学 的 一 个 完整 的 分 支 ， 我 们 不 会 在 这 里 进一步 讨论 它 ， 这 里 的 讨论 仅 限于 如 下 几 


NNN" 


。 如 果 你 要 求 精确 的 计算 (比如 计算 货币 金额 )， 应 使 用 numeric 类 型 。 


。 如 果 你 想 用 这 些 类 型 做 任何 重要 的 复杂 计算 ， 尤其 是 那些 你 对 范围 情况 (无 穷 /下 浴 ) 严 重 
依赖 的 事情 ， 那 你 应 该 仔细 评 诗 你 的 实现 。 


。 拿 两 个 浮 点 数值 进行 相等 性 比较 可 能 不 像 你 想像 那样 运转 。 


在 大 多 数 平台 上 ， real 类 型 的 范围 是 至 少 1E-37 到 1E+37， 精度 至 少 是 6 位 小 

数 。 double precision 的 范围 通常 是 1E-307 到 1E+308， 精度 是 至 少 15 位 数字 。 太 大 或 者 太 
小 的 数值 都 会 导致 错误 。 如 果 输 入 数据 的 精度 太 高 ， 那么 交会 发 生 圆 整 。 太 接近 雳 的 数字 ， 
如 果 无 法 与 需 值 的 表现 形式 相 区 分 就 会 产生 下 瀹 错误 。 


Note: 当 一 个 浮 点 数值 转化 为 文本 输出 时 ，extra_float digits 设置 控制 额外 有 效 数字 的 位 
BM, Bidz o, ，PostgreSQL 支持 的 平台 上 的 输出 是 一 样 的 。 增 加 这 个 值 产 生 的 输出 
将 更 精确 的 表示 存储 值 ， 但 是 可 能 不 利于 移植 。 


除了 普通 的 数字 值 之 外 ， 浮 点 类 型 还 有 几 个 特殊 值 : 























Infinity -Infinity NaN 


这 些 值 分 别 表示 IEEE 754 特殊 值 " 正 无 穷 大 "、" 负 无 穷 大 "、 "不 是 一 个 数字 "。 在 不 遵循 IEEE 
754 浮 点 算术 的 机 器 上 ， 这 些 值 的 含义 可 能 不 是 预期 的 。 如 果 在 SQL 命令 里 把 这 些 数 值 当 作 
Hes, 你 必须 在 它们 周围 放 上 单 引 号 ， 像 这 样 : UPDATE table SET x = 'Infinity' o 输入 
时 ， 这 些 值 是 以 大 小 写 无 关 的 方式 识别 的 。 


Note: IEEE754 声 明 nan 不 应 该 等 于 任何 其 他 浮 点 值 (包括 NaN ) 。 为 了 能 存储 浮 点 
值 ， 并 且 使 用 Tree 索引 ，PostgreSQL 认 为 nan 相等 ， 并 且 大 于 所 有 非 nan 值 。 


PostgreSQL 还 支持 SQL 标准 表示 法 float 和 float(、p ) 用 于 声明 非 精 确 的 数值 类 型 。 其 
中 的 p 声明 以 二 进 制 位 表示 的 最 低 可 接受 精度 。 在 选取 real 类 型 的 时 候 ，PostgreSQL 接 
受 float(1) 到 float(24) ， 在 选取 double precision 的 时 候 ， 接 

SE float(25) 到 float(53) o 在 允许 范围 之 外 的 p 值 将 导致 一 个 错误 。 没有 声明 精度 
的 float 将 被 当 作 double precision o 


Note: PostgreSQL 7.4 以 前 ， 在 float `p ) 里 面 的 精度 会 被 当 作 是 这 么 多 位 数 的 十 进 
制 位 。 到 7.4 已 经 被 修改 成 与 SQL 标准 匹配 ， 标准 声明 这 个 精度 是 以 二 进 制 位 度量 的 。 
假设 real 和 double precision 分 别 有 24 和 53 个 二 进 制 位 的 位 数 对 IEEE 标准 的 浮 点 
实现 来 说 是 正确 的 。 在 非 IEEE 平台 上 ， 这 个 数值 可 能 略 有 偏差 ， 但 是 为 了 简化 ， 我 们 
在 所 有 平台 上 都 用 了 同样 的 p_ 值 范围 。 





























8.1.4. 序列 号 类 型 


smallserial , serial 和 bigserial 类 型 不 是 真正 的 类 型 ， 只 是 为 在 表 中 创建 唯一 标识 做 的 概 
念 上 的 便利 。 类 似 其 它 一 些 数据 库 中 的 AuTo_INCREMENT 属性 。 在 目前 的 实现 中 ， 下 面 一 个 语 
句 : 


CREATE TABLE _tablename_ ( 
_colname_ SERIAL 


Die 


等 价 于 声明 下 面 几 个 语句 : 


CREATE SEQUENCE _tablename colname__seq; 
CREATE TABLE _tablename_ ( 
_colname_ integer NOT NULL DEFAULT nextval('_tablename colname__seq' ) 


) ; 
ALTER SEQUENCE _tablename colname__seq OWNED BY _tablename_._colname_; 


因此 ， 我 们 就 创建 了 一 个 整数 字段 并 且 把 它 的 缺 省 数值 安排 为 从 一 个 序列 发 生 器 读 取 。 应 用 
了 一 个 not NULL 约束 以 确保 NULL 不 会 被 插入 。 在 大 多 数 情况 下 你 可 能 还 希望 附加 一 

个 UNIQUE 或 PRIMARY KEY 约束 避免 意外 地 插入 重复 的 数值 ， 但 这 个 不 是 自动 的 。 最 后 ， 将 
序列 发 生 器 "从 属于 "那个 字段 ， 这 样 当 该 字段 或 表 被 删除 的 时 候 也 一 并 删除 它 。 


Note: 因为 smallserial , serial 和 bigserial 是 使 用 序列 实现 的 ， 所 以 显示 在 字段 里 
的 序列 值 可 能 有 "漏洞 "或 者 缺口 ， 即 使 没有 列 鲁 经 被 删除 。 一 个 从 序列 中 分 配 的 值 仍然 
会 “使 用 ”， 即 使 包含 这 个 值 的 行 没有 成 功 的 插入 到 表格 的 字段 中 。 这 种 情况 是 有 可 能 发 
生 的 ， 上 比如， 插入 事务 回 深 。 参 阅 Section 9.16 中 的 nextval() 获取 详细 信息 。 





Note: PostgreSQL 7.3 以 前 ， serial 隐 含 untque. 但 现在 不 再 如 此 。 如 果 你 希望 一 个 
序列 字段 有 一 个 唯一 约束 或 者 一 个 主键 ， 那么 你 现在 必须 声明 ， 就 像 其 它 数据 类 型 一 
样 。 


要 在 serial 字段 中 插入 序列 中 的 下 一 个 数值 ， 主 要 是 要 注意 serial 字段 应 该 赋予 缺 省 值 。 
我 们 可 以 通过 在 insert 语句 中 把 该 字段 排除 在 字段 列表 之 外 来 实现 ， 也 可 以 通过 使 
用 DEFAULT 关键 字 来 实现 。 


类 型 名 serial 和 serial4 是 等 效 的 : 两 者 都 创建 integer 字段 。 类 型 

名 bigserial 和 serials 也 一 样 ， 只 不 过 它 创建 一 个 bigint 字段 。 如 果 你 预计 在 表 的 生存 
期 中 使 用 的 标识 数目 可 能 超过 2<sup class="calibre28">31</sup> 个 ， 那么 你 应 该 使 

用 bigserial o 类 型 名 smallserial 和 serial2 也 一 样 ， 只 不 过 它 创建 一 个 smallint 字段 。 


一 个 serial 类 型 创建 的 序列 在 所 属 的 字段 被 删除 的 时 候 自动 删除 。 你 可 以 只 删除 序列 而 不 删 
除 字段 ， 不 过 这 将 删除 该 字段 的 缺 省 值 表达 式 。 


8.2. 货币 类 型 


money 类 型 存储 带 有 固定 小 数 精度 的 货币 金额 ， 可 查阅 Table 8-3。 小 数 精度 由 lc_monetary 
的 设置 来 决定 。 表 格 中 显示 的 范围 假设 有 两 位 小 数 。 可 以 以 任意 格式 输入 ， 包 括 整 型 ， 
型 ， 或 者 典型 的 货币 格式 ， 如 '$1,000.00' o 


浮 点 
根据 区 域 字符 集 ， 输 出 一 般 是 最 后 一 种 形式 。 
Table 8-3. 货币 类 型 


名 字 存储 容 


范围 


-92233720368547758.08 到 


+92233720368547758.07 
由 于 输出 的 数据 类 型 对 语言 环境 要 求 很 细 ， 因 此 ， 


lc_monetary 设置 的 不 同 可 能 会 造成 无 法 
将 money 数据 输入 到 数据 库 中 。 为 了 避免 这 种 问题 的 发 生 ， 在 向 一 个 新 数据 库 进 行 转 储 之 
前 ， 确 保 1c_monetary 与 原 数 据 库 相 同 ， 或 具有 等 价值 。 


numeric , int 和 bigint 数据 类 型 的 值 可 以 转化 为 money 类 型 。 


从 real 和 double precision 数据 类 型 的 转换 可 以 通过 先 转化 为 numeric 类 型 ， 例 如 : 


SELECT '12.34'::float8::numeric: :money; 


然而 ， 这 是 不 被 建议 的 。 滔 点数 不 应 该 用 来 处 理 货币 类 型 ， 因 为 潜在 的 圆 整 可 能 导致 错误 。 
过 两 步 来 完成 : 


money 值 可 以 被 转换 为 numeric 而 不 丢失 精度 。 


转换 为 其 他 类 型 可 能 丢失 精度 ， 并 且 必 须 通 


SELECT '52093.89'::money: :numeric::float8; 


当 一 个 money 值 被 另 一 个 money 值 除 时 ， 结果 是 double precision (也 就 是 ， 一 个 纯 数 字 ， 
而 不 是 money) ; 在 结果 中 货币 单位 相互 取消 。 


8.3. 字符 类 型 


Table 8-4. 字符 类 型 


BF 描述 
character varying(**_n_ ), varchar(**_n_ ) Ek, AKER 
character(**_n_ ), char(**_n_ ) 定 长 ， 不 足 补 空 白 
text 变 长 ， 无 长 度 限 制 


Table 8-4 显 示 了 在 PostgreSQL 里 可 用 于 一 般 用 途 的 字符 类 型 。 


SQL 定义 了 两 种 基本 的 字符 类 型 : character varying(``_n ) 和 character(``_n )， 这 里 

的 mn。 是 一 个 正 整 数 。 两 种 类 型 都 可 以 存储 最 多 n 个 字符 的 字符 串 〈 没 有 字 节 ) 。 试图 
存储 更 长 的 字符 串 到 这 些 类 型 的 字段 里 会 产生 一 个 错误 ， 除非 超出 长 度 的 字符 都 是 空白 ， 这 
种 情况 下 该 字符 串 将 被 截断 为 最 大 长 度 。 这 个 看 上 去 有 点 怪异 的 例外 是 SQL 标准 要 求 的 。 如 
果 要 存储 的 字符 串 比 声明 的 长 度 短 ， 类 型 为 character 的 数值 将 会 用 空白 填 满 ; 而 类 型 

为 character varying 的 数值 将 只 是 存储 短 些 的 字符 串 。 


如 果 我 们 明确 地 把 一 个 数值 转换 成 character varying(**_n_ ) 或 character(**_n_ )， 那 么 超 长 
的 数值 将 被 截断 成 nm” 个 字符 ， 且 不 会 抛 出 错误 。 这 也 是 SQL 标准 的 要 求 。 


varchar (``_n_ ) 和 char(*>_n_ ) 分别 是 character varying(``_n_ ) 和 character(>*_n_ ) 的 别 
Z, 没有 声明 长 度 的 character 等 于 character(1) ; 如 果 不 带 长 度 说 明 词 使 
用 character varying ， 那么 该 类 型 接受 任何 长 度 的 字符 串 。 后 者 是 PostgreSQL 的 扩展 。 


另外 ， PostgreSQL 提 供 text 类 型 ， 它 可 以 存储 任何 长 度 的 字符 串 。 尽管 类 型 text 不 是 
SQL 标准 ， 但 是 许多 其 它 SQL 数 据 库 系统 也 有 它 。 


character 类 型 的 数值 物理 上 都 用 空白 填充 到 指定 的 长 度 ane, 并 且 以 这 种 方式 存储 和 显 
示 。 不 过 ， 填 充 的 空白 是 无 语意 的 。 在 比较 两 个 character 值 的 时 候 ， 填 充 的 空白 都 不 会 被 
关注 ， 在 转换 成 其 它 字 符 串 类 型 的 时 候 ， characte 值 里 面 的 空白 会 被 删除 。 请 注意 ， 

在 character varying 和 text 数值 里 ， 结尾 的 空白 是 有 语意 的 。 并 且 当 使 用 模式 匹配 时 ， 

如 LIKE ， 使 用 正则 表达 式 。 


一 个 简短 的 字符 串 〈 最 多 126 个 字 节 ) 的 存储 要 求 是 1 个 字 节 加 上 实际 的 字符 串 ， 其 中 包括 空 
格 填充 的 character o 更 长 的 字符 串 有 4 个 字 节 的 开销 ， 而 不 是 1。 长 的 字符 串 将 会 自动 被 系 
统 压 缩 ， 因 此 在 磁 瘟 上 的 物理 需求 可 能 会 更 少 些 。 更 长 的 数值 也 会 存储 在 后 台 表 里 面 ， 这 样 
它们 就 不 会 干扰 对 短 字段 值 的 快速 访问 。 不 管 怎样 ， 人 允许 存储 的 最 长 字符 串 大 概 是 1GB 。 允 
许 在 数据 类 型 声明 中 出 现 的 n ”的 最 大 值 比 这 还 小 。 修 改 这 个 行为 没有 什么 意义 ， 因 为 在 多 
字 节 编码 下 字符 和 字 节 的 数目 可 能 差别 很 大 。 如 果 你 想 存 储 没有 特定 上 限 的 长 字符 串 ， 那 么 
使 用 text 或 没有 长 度 声明 的 character varying , 而 不 要 选择 一 个 任意 长 度 限 制 。 








Tip: 这 三 种 类 型 之 间 没 有 性 能 差别 ， 除 了 当 使 用 填充 空白 类 型 时 的 增加 存储 空间 ， AS 
存储 长 度 约束 的 列 时 一 些 检查 存 入 时 长 度 的 额外 的 CPU 周 期 。 虽然 在 某 些 其 它 的 数据 库 
RAE, character `n) 有 一 定 的 性 能 优势 ， 但 在 PostgreSQL 里 没有 。 事实 

+, character(`、_n_ ) 通 常 是 这 三 个 中 最 慢 的 ， 因为 额外 存储 成 本 。 在 大 多 数 情况 下 ， 
应 该 使 用 text 或 character varying 。 


请 参考 Section 4.1.2.1 获 取 关 于 字符 串 文 本 的 语法 的 信息 ， 以 及 Chapter 9 获取 关于 可 用 操作 
FARAR. 数据 库 的 字符 集 决 定 用 于 存储 文本 值 的 字符 集 ; 有 关 字 符 集 支持 的 更 多 信 
息 ， 请 参考 Section 22.3。 


Example 8-1. 使 用 字符 类 型 


CREATE TABLE test1 (a character(4)); 
INSERT INTO testi VALUES ('ok'); 


SELECT a, char_length(a) FROM testi; -- <a name="CO.DATATYPE-CHAR">**(1)**</a> 
<samp class="literal">a | char_length 

Secor tana aie eae ee 

ok | 2</samp> 


CREATE TABLE test2 (b varchar(5)); 

INSERT INTO test2 VALUES ('ok'); 

INSERT INTO test2 VALUES ('good Ae 

INSERT INTO test2 VALUES ('too long'); 

<samp class="literal">ERROR: value too long for type character varying(5)</samp> 
INSERT INTO test2 VALUES ('too long'::varchar(5)); -- 明确 截断 

SELECT b, char_length(b) FROM test2; 


<samp class="literal">b | char_length 
A S Sea e E N 

ok | 2 

good | 5 

too 1 | 5</samp> 


(1) 

char_length 图 数 在 Section 9.4 中 讨论 。 

在 PostgreSQL 里 另外 还 有 两 种 定 长 字符 类 型 。 在 Table 8-5 里 显示 。 name 类 型 只 用 于 在 内 部 
系统 表 中 存储 标识 符 并 且 不 是 给 一 般 用 户 使 用 的 。 该 类 型 长 度 当 前 定 为 64 字 节 (63 可 用 字符 
加 结束 符 ) 但 应 该 使 用 c 源码 中 的 常量 NAMEDATALEN 引用 。 这 个 长 度 是 在 编译 的 时 候 设 置 的 ， 
因而 可 以 为 特殊 用 途 调整 ， 缺 省 的 最 大 长 度 在 以 后 的 版 本 可 能 会 改变 。 KH "char" (注意 引 


号 ) 和 char(1) 是 不 一 样 的 ， 它 只 用 了 一 个 字 节 的 存储 空间 。 它 在 系统 内 部 用 于 系统 表 当 做 过 
分 简单 化 的 枚 举 类 型 用 。 


Table 8-5. 特殊 字符 类 型 
名 字 存储 空间 描述 
viag 1 字 节 单字 节 内 部 类 型 


name 64 字 节 用 于 对 象 名 的 内 部 类 型 


8.4. 二 进 制 数据 类 型 


bytea 数据 类 型 允许 存储 二 进 制 字 符 串 。 参 闵 Table 8-6。 
Table 8-6. 二 进 制 数据 类 型 


名 字 存储 空间 描述 
bytea 1 或 4 字 节 加 上 实际 的 二 进 制 字符 串 变 长 的 二 进 制 字符 串 


二 进 制 字符 串 是 一 个 字 节 序列 。 二 进 制 字符 串 和 普通 字符 字符 串 的 区 别 有 两 个 : 首先 ， 二 进 
制 字 符 串 完全 可 以 存储 字 节 需 值 以 及 其 它 "不 可 打印 的 " 字 节 (定义 在 32 到 126 范围 之 外 的 字 
节 )。 字 符 串 不 允许 字 节 需 值 ， 并 且 也 不 允许 那些 不 符合 选 定 的 字符 集 编 码 的 非法 字 节 值 或 者 
字 节 序列 。 第 二 ， 对 二 进 制 字 符 串 的 处 理 实际 上 就 是 处 理 字 节 ， 而 对 字符 串 的 处 理 则 取决 于 
区 域 设置 。 简单 说 ， 二 进 制 字 符 串 适用 于 存储 那些 程序 员 认 为 是 "原始 字 节 "的 数据 ， 而 字符 
串 适 合 存储 文本 。 


bytea 类 型 支持 两 种 输入 输出 的 外 部 格式 : "hex" 格式 和 PostgreSQL 的 历史 "escape" 格 式 。 
这 两 种 格式 通常 在 输入 中 使 用 ， 输 出 格式 由 bytea_output 配置 参数 决定 ， 默 认 是 hex。 (需要 
注意 的 是 hex 格 式 是 在 PostgreSQL 9.0 中 引入 的 ， 早 期 版 本 和 一 些 工 具 中 不 识别 。) 


SQL 标准 定义 了 一 个 不 同 的 二 进 制 字符 串 格式 ， 称 为 BLoB 或 BINARY LARGE OBJECT 。 输 入 格 
式 与 bytea 不 同 ， 但 提供 的 函数 和 操作 符 基本 一 致 。 


8.4.1. bytea 十 六 进 制 格式 


"hex" 格 式 将 二 进 制 数据 编码 为 每 字 节 2 位 十 六 进 制 数 字 ， 最 重要 的 四 位 ( 半 字 节 ) MEF 
始 。 整 条 字符 串 以 \x 开始 “和 与 逃逸 格式 相 区 别 ) 。 在 某 些 情况 下 ， 最 初 的 反 斜 杠 需要 再 写 
一 次 ， 以 逃逸 ， 同样 ， 在 逃逸 格式 中 ， 反 斜 杠 需要 写 两 个 ， 下 面 会 详细 介绍 。 十 六 进 制 数字 
可 以 大 写 也 可 以 小 写 ， 并 且 数 字 对 之 间 允 许 有 空格 (但 不 能 是 在 一 个 数 对 ， 也 不 能 是 

在 \x 起 始 序 列 ) 。 十 六 进 制 格式 能 够 与 许多 的 外 部 应 用 程序 和 协议 兼容 ， 并 且 转 换 往 往 比 
逃逸 快 ， 因此 更 倾向 于 这 种 用 法 。 


例子 : 


SELECT E'\\xDEADBEEF ' ; 


8.4.2. bytea 逃逸 格式 


对 于 bytea 格式 来 说 ，"escape" 格 式 是 一 种 传统 的 PostgreSQL 格 式 。 它 采用 以 ASCIl 字 符 序 
列 来 表示 二 进 制 串 的 方法 ， 同时 将 那些 无 法 表示 成 ASCII 字 符 的 二 进 制 串 转换 成 特殊 的 逃逸 序 
列 。 从 应 用 的 角度 看 ， 如 果 代 表 字 节 的 字符 有 意义 ， 那 么 这 种 表示 方法 会 很 方便 。 但 实际 
+, 这 样 做 会 模糊 二 进 制 字符 串 和 字符 字符 串 之 间 的 区 别 ， 从 而 造成 困扰 ， 同时 牌 选 出 的 逃 
逸 机 制 会 显得 很 腔 肿 。 因 此 对 一 些 新 应 用 应 该 恰当 的 避免 这 种 格式 。 


当 以 逃逸 格式 录入 bytea 值 时 ， 你 必须 逃逸 某 些 字 节 值 ， 同时 可 以 逃逸 所 有 字 节 值 。 通 常 ， 
要 逃逸 一 个 字 节 值 ， 将 它 转换 成 反 斜 杠 + 三 位 八进制 值 的 形式 《或 两 个 反 斜 枉 ， 如 果 用 逃逸 字 
符 串 语法 将 值 写 成 文本 形式 ) 。 AN, RETARD 〈( 字 节 值 92) 可 以 用 双 反 斜 杠 表示 。Table 
8-7 给 出 了 必须 逃逸 的 字符 串 ， 和 蔡 代 的 逃逸 序列 (如 适用 ) 。 


Table 8-7. bytea 文本 逃逸 八进制 


人 
十 进 制 数值 描述 输入 逃逸 形式 例子 输出 
形式 
0 八进制 的 需 E'\\000' SELECT E'\\000': :bytea; \000 
X = uau 或 i A a a 
39 单 引号 Ee SELECT E'\''::bytea; 
` E'\\\\' 或 sae 
92 反 斜 杠 Er SELECT E'\\\\'::bytea; \\ 
"不 可 打 
cle eh elle 3 SELECT E'\\001'::bytea; \001 


127 to 255 ee (八进制 值 ) 


逃逸 不 可 打印 字 节 的 要 求 因 区 域 设置 而 异 。 在 某 些 场合 下 ， 你 可 以 不 逃逸 它们 。 请 注意 Table 
8-7 里 的 每 个 例子 都 是 刚好 一 个 字 节 长 ， 虽 然 输出 形式 比 一 个 字符 要 长 。 


你 必须 写 这 么 多 反 斜 杠 的 原因 ， 如 Table 8-7 所 示 ， 是 因为 一 个 写成 字符 串 文 本 的 输入 字符 串 
必须 通过 PostgreSQL 服务 器 里 的 两 个 分 析 阶 段 。 每 一 对 反 斜 杠 中 的 第 一 个 会 被 字符 串 文 本 分 
析 器 理解 成 一 个 逃逸 字符 而 消耗 掉 ， 于 是 剩 下 的 第 二 个 反 斜 杠 被 bytea 输入 函数 当 作 一 个 三 
位 八进制 值 或 者 是 逃逸 另外 一 个 反 斜 杠 的 开始 。 比如 ， 一 个 传递 给 服务 器 的 字符 串 文 

本 E'\\o01' 在 通过 字符 串 分 析 器 之 后 会 当 作 \001 发 送 给 bytea 输入 函数 ， 在 这 里 它 被 转换 
成 一 个 十 进 制 值 为 1 的 单个 字 节 。 请 注意 ， 单 引号 字符 (") 不 会 被 bytea 特殊 对 待 ， 它 遵循 字 
符 串 文 本 的 普通 规则 。 又 见 Section 4.1.2.1。 


Bytea 字 节 也 在 输出 中 逃逸 。 通 常 ， 每 个 "不 可 打印 " 的 字 节 值 都 转化 成 对 应 的 前 导 反 斜 杠 的 
三 位 八进制 数值 。 大 多 数 "可 打印 的 " 字 节 值 是 以 客户 端 字符 集 的 标准 表现 形式 出 现 的 。 十 进 
制 值 为 92( 反 斜 杠 ) 的 字 节 在 输出 中 双 写 。 细节 在 Table 8-8 里 描述 。 


Table 8-8. bytea 输出 逃逸 序列 


字 节 的 十 进 | 逃逸 的 输出 形 输出 
制 值 描述 例子 站 
92 反 斜 杠 AN SELECT E'\\134': :bytea; SN 
0to 31and 人 人 SELECT E'\\001': :bytea; \oo1 
127 to 255 sw RISE 进 制 值 ) re 
32 to 126 oe a SELECT E'\\176' : :bytea; ~ 
x, 2 


根据 你 使 用 的 前 端 不 同 ， 在 是 否 逃 逸 bytea 字符 串 的 问题 上 你 可 能 有 一 些 额 外 的 工作 要 做 。 
比如 ， 如 果 你 的 接口 自动 转换 换行 和 回 车 ， 那 你 可 能 还 要 逃逸 它们 。 


8.5. 日 期 /时 间 类 型 


Table 8-9 显 示 了 PostgreSQL 支持 的 SQL 中 所 有 日 期 和 时 间 类 型 。 这 些 数据 类 型 上 可 以 进行 
的 操作 在 Section 9.9 中 描述 。 日 期 是 按照 公历 计算 的 ， 其 至 日 历 之 前 的 年 份 也 介绍 了 ( 参 
阅 Section B.4 获 取 更 多 信息 ) 。 


Table 8-9. 日 期 /时 间 类 型 


名 字 入 描述 最 低 值 最 高 值 } 


timestamp [ (~. p_- ) ] [ 


a 日 期 和 时 间 4713 BC 294276 AD 
without time zone ] 


(无 时 区 ) / 


timestamp [ (~ _p_ ) ] 


ane 日 期 和 时 4713 BC 294276 AD 
with time zone 


间 ， 有 时 区 / 


at ip 2 


5874897 


1 
date AD 天 


只 用 于 日 期 4713 BC 


ae 4 e 


time [ (`p )][ 


( 只 用 于 一 日 00.00:00 24:00:00 
without time zone ] 


内 时 间 / 


Ro 


= 
N 


只 用 于 一 日 PON Se 
atid, # ”00:00:00+1459 i. d 
时 区 


time [ (``_p_ )] with 
time zone 


at 4} 


interval [ _fields_ ] 


小 
时 间 间 隔 。 | -178000000 年 | 178000000 | 4 
K) 年 


4h 


Note: SQL 标准 要 求 仅仅 将 timestamp 类 型 等 于 timestamp without time zone 类 型 ， 
PostgreSQL 遵 守 这 个 行为 。 (7.3 之 前 的 版 本 将 其 看 做 timestamp with time zone o ) 
timestamptz 作为 timestamp with time zone 的 缩写 被 接受 ; 3X PostgreSQL 的 一 个 扩 
展 。 


time , timestamp 和 interval 接受 一 个 可 选 的 精度 值 _p_ 以 指明 秒 域 中 小 数 部 分 的 位 数 。 
没有 明确 的 缺 省 精度 ， _p_ 的 范围 对 timestamp 和 interval 类 型 是 从 0 到 6。 


Note: 如 果 timestamp 数值 是 以 8 字 节 整数 (目前 的 缺 省 ) 的 方式 存储 的 ， 那么 微 秒 的 精度 
就 可 以 在 数值 的 全 部 范围 内 都 可 以 获得 。 如 果 timestamp 数值 是 以 双 精 度 浮 点 数 (一 个 废 
弃 的 编译 时 的 选项 ) 的 方式 存储 的 ， 那么 有 效 精 度 会 小 于 6 。 timestamp 值 是 以 2000- 
01-01 午夜 之 前 或 之 后 的 秒 数 存 储 的 。 当 timestamp 值 用 浮 点 数 实现 时 ， 微 秒 的 精度 是 
为 那些 在 2000-01-01 前 后 几 年 的 日 期 实现 的 ， 对 于 那些 远 一 些 的 日 子 ， 精 度 会 下 降 。 
注意 ， 使 用 浮 点 时 间 人 允许 一 个 比 上 面 显示 的 更 大 的 timestamp 值 变 化 范围 : 从 4713BC 
到 5874897AD。 


同一 个 编译 时 选项 也 决定 time 和 interval 值 是 保存 成 浮 点 数 还 是 八字 节 整 数 。 在 以 浮 
点 数 存 储 的 时 候 ， 随 着 时 间 间 隔 的 增加 ， 大 的 interval 数值 的 精度 会 降低 。 


对 于 time 类 型 ， 如 果 使 用 了 八字 节 的 整数 存储 ， 那 么 _p ”允许 的 范围 是 从 0 到 6 ， 如 果 使 
用 的 是 浮 点 数 存 储 ， 那 么 这 个 范围 是 0 到 10 。 


interval 类 型 有 一 个 额外 的 选项 ， 通 过 下 下 面 词组 之 一 限制 存储 的 字段 值 : 


YEAR 

MONTH 

DAY 

HOUR 

MINUTE 

SECOND 

YEAR TO MONTH 
DAY TO HOUR 
DAY TO MINUTE 
DAY TO SECOND 
HOUR TO MINUTE 
HOUR TO SECOND 
MINUTE TO SECOND 





注意 如 果 同 时 指定 了 _fields 和 _p_, _fields 必须 包含 sEcoNp ， 因 为 精度 只 应 用 于 
秒 。 


time with time zone 类 型 是 SQL 标准 定义 的 ， 但 是 完整 定义 的 有 些 方面 会 导致 有 问题 的 用 
法 。 在 大 多 数 情况 下 ， date , time ，timestamp without time zone , 
和 timestamp with time zone 的 组 合 就 点 该 能 提供 一 切 应 用 需要 的 日 期 /时 间 的 完整 功能 。 


abstime 和 reltime 类 型 是 低 分 辩 率 类 型 ， 它 们 被 用 于 系统 内 部 。 我 们 反对 你 在 应 用 中 使 用 
这 些 类 型 ， 因 为 这 些 内 部 类 型 可 能 会 在 未 来 的 版 本 里 消失 。 


8.5.1. 日 期 /时 间 输 入 


日 期 和 时 间 的 输入 几乎 可 以 是 任何 合理 的 格式 ， 包 括 ISO-8601 格式 、SQL- 兼 容 格式 、 传统 
POSTGRES 格 式 、 其 它 的 形式 。 对 于 一 些 格式 ， 日 期 输入 里 的 日 、 月 、 年 可 能 会 让 人 迷惑 ， 
因此 系统 支持 自 定义 这 些 字段 的 顺序 。 把 DateStyle 参 数 设 置 为 MpY 就 按照 "月 -日 -年 "解析 ， 
设置 为 omy 就 按照 "日 -月 -年 "解析 ， 设 置 为 Ymp 就 按照 "年 -月 -日 "解析 。 


PostgreSQL 在 处 理 日 期 /时 间 输 入 上 上 比 SQL 标准 要 求 的 更 灵活 。 参 阅 Appendix B 获取 关于 日 
期 /时 间 输 入 的 准确 分 析 规 则 和 可 识别 文本 字段 ， 包 括 月 份 、 星 期 几 、 时 区 。 


请 记 住 任何 日 期 或 者 时 间 的 文本 输入 需要 由 单 引 号 包围 ， 就 像 一 个 文本 字符 串 一 样 。 参 
考 Section 4.1.2.7 获 取 更 多 信息 。 SQL 要 求 使 用 下 面 的 语法 : 


type_ [ (_p_) ] '_value_' 





可 选 的 精度 声明 中 的 p 是 一 个 整数 ， 表 示 在 秒 域 中 小 数 部 分 的 位 数 ， 我 们 可 以 

对 time , timestamp , interval 类 型 声明 精度 。 人 允许 的 精度 在 上 面 已 经 说 明 。 如 果 在 常量 声 
明 中 没有 声明 精度 ， 缺 省 是 文本 值 的 精度 。 

8.5.1.1. 日 期 

Table 8-10 显 示 了 date 类 型 可 能 的 输入 方式 。 


Table 8-10. Date Input 


例子 
1999-01-08 


January 8, 
1999 


1/8/1999 
1/18/1999 


01/02/03 


1999-Jan- 


99-Jan-08 
08-Jan-99 
Jan-08-99 
19990108 
990108 
1999.008 
J2451187 


January 8, 
99 BC 


描述 
ISO 8601 格 式 (建议 格式 )， 任 何方 式 下 都 是 1999 年 1 月 8 号 
在 任何 datestyle 输入 模式 下 都 无 歧义 


Alx, € wy 下 是 一 月 八 号 ; 在 ow 模式 下 是 八 月 一 日 
MDY 模式 下 是 一 月 十 八 日 ， 其 它 模 式 下 被 拒绝 


MDY 模式 下 的 2003 年 1 月 2 日 ; omy 模式 下 的 2003 年 2 月 1 日 ; 
YMD 模式 下 的 2001 年 2 月 3 日 


任何 模式 下 都 是 1 月 8 日 
任何 模式 下 都 是 1 月 8 日 


任何 模式 下 都 是 1 月 8 日 


wo 模式 下 是 1 月 8 日 ， 否 则 错误 

一 月 八 日 ， 除 了 在 w 模式 下 是 错误 的 之 外 
一 月 八 日 ， 除 了 在 w 模式 下 是 错误 的 之 外 
ISO 8601 ; 任何 模式 下 都 是 1999 年 1 月 8 日 
ISO 8601 ; 任何 模式 下 都 是 1999 年 1 月 8 日 
年 和 年 里 的 第 几 天 

(aes A 


公元 前 99 年 


8.5.1.2. 时 间 


当日 时 间 类 型 是 time [ (C`_p_ )] without time zone 和 time [ (``_p )]with time zone. 只 


写 time 等 效 于 time without time zone o 


这 些 类 型 的 有 效 输 入 由 当日 时 间 后 面 跟着 可 选 的 时 区 组 成 (参阅 Table 8-11 和 Table 8-12), 如 
果 在 time without time zone 类 型 的 输入 中 声明 了 时 区 ， 那 么 它 会 被 愉 悄 地 忽略 。 同样 指定 
的 日 期 也 会 被 忽略 ， 除 非 使 用 了 一 个 包括 夏令 时 规则 的 时 区 名 ， 比 如 America/New York ， 在 
这 种 情况 下 ， 必须 指定 日 期 以 确定 这 个 时 间 是 标准 时 间 还 是 夏令 时 。 时 区 偏 移 将 记录 在 


time with time zone 中 。 


Table 8-11. 时 间 输 入 


例子 描述 


04:05:06.789 ISO 8601 

04:05:06 ISO 8601 

04:05 ISO 8601 

040506 ISO 8601 

04:05 AM & 04:05 —## ; AM 不 影响 数值 
04:05 PM & 16:05 一 样 ; 输入 小 时 数 必须 <= 12 
04:05:06.789-8 ISO 8601 

04:05:06-08:00 ISO 8601 

04:05-08:00 ISO 8601 

040506 -08 ISO 8601 

04:05:06 PST 缩写 的 时 区 

2003-04-12 04:05:06 America/New_York 用 名 字 声 明 的 时 区 


Table 8-12. 时 区 输入 


例子 描述 
PST 太平 洋 标准 时 间 (Pacific Standard Time) 
America/New_York 完整 时 区 名 称 
PST8PDT POSIX 风格 的 时 区 
-8:00 ISO-8601 与 PST 的 偏 移 
-800 ISO-8601 与 PST 的 偏 移 
-8 ISO-8601 与 PST 的 偏 移 
zulu 军 方 对 UTC 的 缩写 (译注 : 可 能 是 美军 ) 
z zulu 的 缩写 


参考 Section 8.5.3 以 获取 如 何 指 定时 区 的 更 多 信息 。 


8.5.1.3. 14 H Æ% 


时 间 惟 类 型 的 有 效 输 入 由 一 个 日 期 和 时 间 的 连接 组 成 ， 后 面 跟着 一 个 可 选 的 时 区 ， 一 个 可 选 
的 Ap 或 Bc 。 另 外 ， Ap/Bc 可 以 出 现在 时 区 前 面 ， 但 这 个 顺序 并 非 最 佳 的 。 因 此 : 


1999-01-08 04:05:06 


和 : 


1999-01-08 04:05:06 -8:00 


都 是 有 效 的 数值 ， 它 是 兼容 ISO-8601 的 。 另外， 也 支持 下 面 这 种 使 用 广泛 的 格式 : 


January 8 04:05:06 1999 PST 


SQL 标准 通过 "+" 或 者 "-" 是 否 存在 和 时 间 后 的 失去 偏 移 来 区 分 


timestamp without time zone 和 timestamp with time zone MA, 因此 ， 根据 标准 ， 


TIMESTAMP '2004-10-19 10:23:54' 


是 一 个 


FE timestamp without time zone , 而 


TIMESTAMP '2004-10-19 10:23:54+02' 


是 一 个 timestamp with time zone o PostgreSQL 从 来 不 会 在 确定 文本 的 类 型 之 前 检查 文本 内 
容 ， 因此 会 把 上 面 两 个 都 看 做 是 timestamp without time zone o 因此 要 保证 把 上 面 的 第 二 个 
当 作 timestamp with time zone 看 待 ， 就 要 给 它 明确 的 类 型 : 


TIMESTAMP WITH TIME ZONE '2004-10-19 10:23:54+02' 


如 果 一 个 文本 已 被 确定 是 timestamp without time zone , PostgreSQL 将 悄悄 忽略 任何 文本 中 
指出 的 时 区 。 因 此 ， 生 成 的 日 期 /时 间 值 是 从 输入 值 的 日 期 /时 间 字 段 衍 生出 来 的 ， 并 且 没 有 就 
时 区 进行 调整 。 


对 于 timestamp with time zone ， 内 部 存储 的 数值 总 是 UTC( 全 球 统 一 时 间 ， 以 前 也 叫 格林 威 
治 时 间 GMT)。 如 果 一 个 输入 值 有 明确 的 时 区 声明 ， 那么 它 将 用 该 时 区 合适 的 偏 移 量 转换 成 

UTC 。 如 果 在 输入 字符 串 里 没有 时 区 声明 ， 那么 它 就 假设 是 在 系统 的 TimeZone 参 数 里 的 那 
个 时 区 ， 然后 使 用 这 个 timezone 时 区 转换 成 UTC o 


如 果 输 出 一 个 timestamp with time zone ， 那 么 它 总 是 从 UTC 转换 成 当前 的 timezone 时 
区 ， 并 且 显 示 为 该 时 区 的 本 地 时 间 。 要 看 其 它 时 区 的 该 时 间 ， 要 么 修改 timezone, BAG 
用 AT TIME zone 构造 (参阅 Section 9.9.3)。 


在 timestamp without time zone 和 timestamp with time zone 之 间 的 转换 通常 假 
设 timestamp without time zone 数值 应 该 以 timezone 本 地 时 间 的 形式 接受 或 者 写 出 。 其 它 的 
时 区 可 以 用 AT TIME zone 的 方式 为 转换 声明 。 


8.5.1.4. 特殊 值 


PostgreSQL 为 方便 起 见 支 持 在 Table 8-13 里 面 显示 的 几 个 特殊 输入 值 。 

值 infinity 和 -infinity 是 特别 在 系统 内 部 表示 的 ， 并 且 将 按照 同样 的 方式 显示 ; 但 是 其 它 
的 都 只 是 符号 缩写 ， 在 读 取 的 时 候 将 被 转换 成 普通 的 日 期 /时 间 值 。 特 别 是 now 和 相关 的 字 

符 串 在 读 取 的 时 候 就 被 转换 成 对 应 的 数值 。 所 有 这 些 值 在 SQL 命令 里 当 作 普通 常量 对 待 时， 

都 需要 包围 在 单 引号 里 面 。 


Table 8-13. 特殊 日 期 /时 间 输 入 


输入 字符 串 适用 类 型 描述 

epoch date , timestamp 1970-01-01 00:00:00+00 (Unix RAFF) 
infinity date , timestamp 比 任何 其 它 时 间 惟 都 晚 

-infinity date , timestamp 比 任何 其 它 时 间 戳 都 早 

now date ，time ，timestamp 当前 事务 的 开始 时 间 

today date ，timestamp 今日 午夜 

tomorrow date , timestamp 明日 午夜 

yesterday date ，timestamp 昨日 午夜 

allballs time 00:00:00.00 UTC 


下 列 SQL 兼 容 画 数 也 可 以 用 于 获取 对 应 数据 类 型 的 当前 时 间 值 : CURRENT_DATE , 
CURRENT_TIME , CURRENT TIMESTAMP , LOCALTIME , LOCALTIMESTAMP 。 后 四 个 接受 一 个 可 选 的 精 
度 声明 ( Section 9.9.4)。 不 过 ， 请 注意 这 些 SQL WARE 被 当 作 数据 输入 字符 串 识 别 的 。 


8.5.2. 日 期 /时 间 输 出 


日 期 /时 间 类 型 的 输出 格式 可 以 设 成 ISO 8601( 默 认 )、SQL(Ingres)、 传统 的 
POSTGRES(Unix date 格 式 ) 或 German 四 种 风格 之 一 。 SQL 标准 要 求 使 用 ISO 8601 格 
式 。"SQL "输出 格式 的 名 字 是 历史 偶然 。 Table 8-14 显 示 了 每 种 输出 风格 的 例子 。 

date 和 time 类 型 的 输出 当然 只 是 给 出 的 例子 里 面 的 日 期 和 时 间 部 分 。 


Table 8-14. 日 期 /时 间 输 出 风格 


风格 描述 例子 
ISO ISO 8601, SQL 标准 1997-12-17 07:37:16-08 
SQL 传统 风格 12/17/1997 07:37:16.00 PST 
Postgres 原始 风格 Wed Dec 17 07:37:16 1997 PST 


German 地 区 风格 17.12.1997 07:37:16.00 PST 


Note: ISO 8601389 E RAS TE T 分 隔日 期 和 时 间 。PostgreSQL 在 输入 上 接受 这 种 格 
式 ， 但 是 在 输出 上 使 用 一 个 空格 而 不 是 T ， 就 像 上 面 显 示 的 。 这 样 更 易 读 而 且 和 RFC 
3399 或 者 其 他 的 数据 库 系 统一 致 。 


如 果 声 明了 DMY 顺序 ， 那 么 在 SQL 和 POSTGRES 风格 里 ， 日 期 在 月 份 之 前 出 现 ， 否 则 月 
份 出 现在 日 期 之 前 (参阅 Section 8.5.1 看 看 这 个 设置 如 何 影响 对 输入 值 的 解释 )。Table 8-15 B 
示 了 一 个 例子 。 


Table 8-15. 日 期 顺序 习惯 








datestyle 设置 输入 顺序 输出 样 例 
SQL, DMY 日 / A / 年 ANZA NT SH Sif 16 OOM CE 
SQL, MDY A / 日 / 年 A271 719 Of, (Oi : 37: 16 700IPST 
Postgres, DMY 日 / 月 / 年 Wed 17 Dec 07:37:16 1997 PST 





用 户 可 以 用 set datestyle 命令 选取 日 期 /时 间 的 风格 ， 也 可 以 在 配置 文件 postgresql.conf 
中 的 DateStyle 参 数 中 设置 ， 或 者 在 服务 器 或 客户 端的 pepATESTYLE 环境 变量 中 设置 


我 们 也 可 以 用 格式 化 函数 tochar (参见 Section 9.8) 来 更 灵活 地 控制 时 间 / 日 期 地 输出 。 


8.5.3. 时 区 


时 区 和 时 区 习惯 不 仅仅 受 地 球 几何 形状 的 影响 ， 还 受到 政治 决定 的 影响 。 到 了 19 世纪 ， 全 
球 的 时 区 变 得 稍微 标准 化 了 些 ， 但 是 还 是 易于 遭受 随意 的 修改 ， 部 分 是 因为 夏 时 制 规 则 。 
PostgreSQL 使 用 广泛 使 用 的 zoneinfo (Olson) 时 区 信息 数据 库 有 关 历 史 时 区 的 规则 。 对 
于 未 来 的 时 间 ， 假 设 对 于 给 定时 区 最 近 的 规则 将 在 未 来 继续 无 期 限 的 遵守 。 


PostgreSQL 在 典型 应 用 中 尽 可 能 与 SQL 的 定义 相 兼 容 。 但 SQL 标准 在 日 期 /时 间 类 型 和 功能 
上 有 一 些 奇怪 的 混淆 。 两 个 显而易见 的 问题 是 : 


e date 类 型 与 时 区 没有 联系 ， 而 time 类 型 却 有 或 可 以 有 。 然而 ， 现 实 世界 的 时 区 只 
与 时 间 和 日 期 都 关联 时 地 有 意义 ， 因为 时 间 偏 移 量 ( 时 差 ) 可 能 因为 实行 类 似 夏 时 制 这 
的 制度 而 在 一 年 里 有 所 变化 。 


。 缺 省 的 时 区 用 一 个 数字 常量 表示 与 UTC 的 偏 移 (时 差 )。 因 此 ， 当 跨 DST( 夏 时 制 ) 界 限 做 日 
期 /时 间 算 术 时 ， 我 们 根本 不 可 能 把 夏 时 制 这 样 的 因素 计算 进去 。 


为 了 克服 这 些 困难 ， 我 们 建议 在 使 用 时 区 的 时 候 ， 使 用 那些 同时 包含 日 期 和 时 间 的 日 期 /时 间 
类 型 。 我 们 建议 不 要 使 用 time with time zone 类 型 (尽管 PostgreSQL 出 于 合理 应 用 以 及 为 了 
与 SQL 标准 兼容 的 考虑 支持 这 个 类 型 )。PostgreSQL 假设 你 用 于 任何 类 型 的 本 地 时 区 都 只 包 
含 日 期 或 时 间 ( 而 不 包含 时 区 )。 


在 系统 内 部 ， 所 有 日 期 和 时 间 都 用 全 球 统 一 时 间 UTC 格 式 存储 ， 时 间 在 发 给 客户 前 端 前 由 数 
据 库 服务 器 根据 TimeZone 配置 参数 声明 的 时 区 转换 成 本 地 时 间 。 


PostgreSQL 人 允许 你 用 三 种 方法 指定 时 区 : 


。 完整 的 时 区 名 。 例 如 America/New_York o 所 有 可 以 识别 的 时 区 名 在 pg_timezone_names 视 
图 中 列 出 (参见 Section 47.71)。PostgreSQL 使 用 广泛 使 用 的 zoneinfo 时 区 数据 ， 所 以 
这 些 时 区 名 在 其 它 软 件 里 也 能 被 轻松 的 识别 。 


。 时 区 缩写 。 例 如 PsT 。 这 种 缩写 名 通常 只 是 定义 了 相对 于 UTC 的 偏 移 量 ， 而 前 一 种 完 
整 的 时 区 名 可 能 还 隐 含 着 一 组 夏 时 制 转 换 规则 。 所 有 可 以 识别 的 时 区 缩写 
在 pg_timezone_abbrevs 视图 中 列 出 (参见 Section 47.70)。 你 不 能 设置 TimeZone 
或 log_timezone 配置 参数 为 时 区 缩写 ， 但 是 你 可 以 在 日 期 /时 间 输 入 值 中 结 
合 AT time zone 操作 符 使 用 时 区 缩写 。 


。 除 完 整 的 时 区 名 及 其 缩写 之 外 ，PostgreSQL 还 接受 POSIX 风格 的 

STD_>*_offset_ 或 _STD offset psT 格式 的 时 区 ， 其 中 的 _sto_ 是 时 区 缩 
写 、 _offset ”是 一 个 相对 于 UTC 的 小 时 偏 移 量 、 pst. 是 一 个 可 选 的 夏 时 制 时 区 缩写 
(假定 相对 于 给 定 的 偏 移 量 提前 一 小 时 )。 例 如 ， 如 果 esser 不 是 一 个 已 识别 的 时 区 名 ， 
那么 它 将 等 同 于 美国 东部 时 间 。 如 果 存 在 夏 时 制 时 区 名 是 当前 时 区 名 ， 根 据 zoneinfo 时 
区 数据 库 的 posixrules 条 目 中 相同 的 夏 时 制 事 务 规则 ， 可 以 考虑 使 用 这 个 特性 。 在 一 
个 PostgreSQL 标 准 安装 中 ， posixrules 与 Us/Eastern 相同 ， 因 此 POSIX 格 式 的 时 区 声 
明 遵 循 USA 夏 时 制 规则 。 如 果 需 要 ， 可 以 通过 替换 posixrules 文件 来 调整 该 习惯 。 





简 言 之 ， 这 就 是 完整 的 时 区 名 与 时 区 缩写 之 间 的 差异 : 时 区 缩写 总 是 代表 一 个 相对 于 UTC 的 
固定 偏 移 量 ， 然而 大 多 数 完整 的 时 区 名 隐 含 着 一 个 本 地 夏令 时 规则 ， 因 此 就 有 可 能 有 两 个 相 
对 于 UTC 的 不 同 偏 移 量 。 

需要 警惕 的 是 ， 由 于 没有 合理 的 时 区 缩写 检查 ，POSIX 格 式 的 时 区 特点 能 导致 静默 的 伪 输 
A. 例如 ， 使 用 set TIMEZONE To FooBAR6 时 ， 实 际 上 系统 使 用 的 是 一 个 很 特别 的 UTC 缩写 。 
另 一 个 需要 注意 的 是 ， 在 POSIX 时 区 名 中 ， 积 极 的 偏 移 用 于 west 格 林 尼 治 位 置 。 在 其 他 地 
方 ，PostgreSQL 遵 循 ISO-8601 规 定 ， 即 积极 的 时 区 偏 移 east 格 林 威 治 。 


444m, PostgreSQL 8.2 版 本 以 后 时 区 名 在 所 有 情况 下 都 是 大 小 写 无 关 的 。 而 之 前 的 版 本 

在 某 些 情况 下 是 大 小 写 敏 感 的 。 

无 论 是 完整 的 时 区 名 还 是 时 区 缩写 都 不 是 硬 连接 进 服务 器 的 ， 它 们 都 是 从 安装 目录 下 的 
.../share/timezone/ 和 .../share/timezonesets/ 配置 文件 中 获取 的 (参见 Section B.3)。 


可 以 在 postgresql.conf 文件 里 设置 TimeZone 配置 参数 ， 或 者 用 任何 其 它 在 Chapter 18 描 述 
的 标准 方法 。 除 此 之 外 ， 还 有 好 几 种 特殊 方法 可 以 设置 它 : 


e 使 用 SQL 命令 SET TIME ZoNE 为 会 话 设置 时 区 ， 这 是 SET TIMEZONE To 的 一 个 可 选 的 拼写 


方式 ， 更 加 兼容 标准 。 


。 如 果 在 客户 端 设 置 了 pP6Tz 环境 变量 ， 那 么 libpq 在 连接 时 将 使 用 这 个 环境 变量 给 后 端 发 


送 一 个 SET TIME ZONE 命令 。 


8.5.4. 间 隅 输入 
interval 类 型 值 可 以 用 下 面 的 详细 语法 写 : 


[@] _quantity_ _unit_ [°_quantity_~ ~_unit_*...] [°_direction_~] 


这 里 quantity, 是 一 个 数字 (可 能 已 标记 ) ; unit. ALA 

是 microsecond , millisecond , second , minute , hour, day, 

week , month, year , decade , century , millennium 或 这 些 单位 的 缩写 或 复 

数 。 _direction 可 以 是 ago 或 为 空 。 @ 标记 是 可 选 的 。 i 
当 的 计算 符号 。 ago SEMA. WRintervalStyle 设置 为 postgres_verbose ， 那 么 这 个 语法 
同样 用 于 间隔 输出 。 

可 以 在 没有 明确 单位 标记 的 情况 下 声明 天 ， 小 时 ， 分 钟 和 秒 。 例 如 ， '1 12:59:10' 等 同 
Tk day 12 hours 59 min 10 sec' o 同 祥 ， 可 以 用 一 个 破 折 号 来 声明 一 个 年 和 月 的 组 合 ， 例 
如 '200-10' 等 同 于 '200 years 10 months' 。 (事实 上 ，SQL 标 准 值 允许 短 的 格式 ， FE 
当 Intervalstyle 设置 为 sql_standard 时 ， 用 于 输出 ) o 


要 么 使 用 4.4.3.2 的 "format with designators"， 要 么 使 用 4.4.3.3 的 "alternative format"， 间 隔 值 
可 以 写 为 ISO 8601 的 时 间 间 隔 。 格 式 如 下 : 


P _quantity_ _unit_ [ ~_quantity_~ ~_unit_~ ...] [ T [ ~_quantity_~ ~_unit_> ...]] 
字符 串 必 须 以 P 开始 ， 并 且 可 以 含有 一 个 T 用 以 指明 一 天 中 时 间 的 格式 。 可 用 单位 的 缩写 


在 Table 8-16 有 说 明 。 可 以 忽略 单位 ， 也 可 以 以 任意 顺序 声明 ， 但 单位 小 于 一 天 时 必须 
在 T 之后。 尤其 M 的 含义 依赖 于 它 在 T 之 前 或 之 后 。 


Table 8-16. ISO 8601 间隔 单位 的 缩写 


缩写 含义 


mA 


(日 期 部 分 ) 


oH 


A 
小 时 
分 钟 〈 时 间 部 分 ) 


秒 


o|/zZz/=x|0|s/z| < 





P [ ~“_years_~-*~_months_~-*_days_~ ] [ T `_hours_`:`_minutes_`:`_seconds_` ] 


一 个 字符 串 必 须 以 P 开始 ， 然 后 以 T 隔 开 日 期 和 时 间 。 给 出 的 值 是 如 同 ISO 8601 日 期 的 数 
字 。 


当 用 fields 规范 写 一 个 时 间 间 隔 常 数 ， 或 将 一 个 字符 串 标 记 为 用 _fields_ 规范 定义 的 一 
个 间隔 列 时 ， 未 标记 单位 的 解释 由 _fields_ 解释。 如 INTERVAL '1' YEAR 读 作 1 年 ， 然 
而 INTERVAL '1' 代表 1 秒 。 同样 ， _fields 规范 中 "最 低 " 有 效 字 段 值 规 定 会 被 静默 的 忽略 。 


AN, INTERVAL '1 day 2:03:04' HOUR TO MINUTE 会 导致 删除 秒 字段 ， 而 不 是 天 字段 。 


根据 SQL 标准 ， 间 陋 值 的 所 有 字段 必须 有 相同 的 符号 ， 因 此 前 导 负 号 可 以 用 于 所 有 字段 ; 

如 '-1 2:03:04 中 负 号 同时 应 用 于 天 和 小 时 /分 钟 / 秒 。PostgreSQL 人 允许 字段 有 不 同 的 标记 ， 
并 且 传 统 上 ， 文 本 表述 中 的 每 个 字段 会 被 认为 是 独立 标记 的 ， 因此 在 这 个 例子 中 的 小 时 /分 钟 / 
秒 被 认为 是 正 值 。 如 果 IntervalStyle 被 设置 为 sql_standard ， 那么 前 导 标 记 被 认为 是 应 用 
于 所 有 字段 的 (当然 前 提 是 没有 再 出 现 其 他 标记 ) ， 人 否则 会 使 用 传统 的 PostgreSQL 解 释 。 
为 了 避免 这 种 歧义 ， 如 果 任 何 字段 是 负 的 ， 建 议 为 每 个 字段 附 上 一 个 明确 的 标记 。 


PostgreSQL 内 部 ， interval 值 被 存储 为 月 ， 日 ， 秒 的 格式 ， 这 是 因为 月 中 包含 天 数 不 同 ， 
并 且 如 果 进 行 了 夏 合 时 调整 ， 那 么 一 天 可 以 有 23 或 25 小 时 。 当 秒 字段 可 以 存储 分 数 时 ， 月 和 
天 字段 可 以 是 整数 型 。 由 于 时 间 间 隔 通 常 是 由 常量 字符 串 或 timestamp 减法 来 定义 的 ， 这 种 
存储 方法 在 大 多 数 情 况 下 很 有 效 。 justify_days 和 justify_hours 函数 可 用 于 调整 渝 出 正常 
范围 值 的 天 和 小 时 。 


在 详细 的 输入 格式 ， 以 及 更 紧凑 的 输入 格式 中 ， 字 段 值 可 以 有 小 数 部 分 ， 例 

如 '1.5 week' BK '01:02:03.45' 。 这 种 输入 被 转换 成 恰当 的 月 ， 天 和 秒 来 存储 。 由 于 这 样 会 
产生 小 数 的 月 或 天 ， 因 此 在 低 阶 字段 中 引入 了 分 数 ， 使 用 1 month = 30 days 和 1 day = 24 
hours 的 转换 。 例 如 ， '1.5 month' 即 1 个 月 15 天 。 输 出 中 ， 只 有 秒 可 以 写成 分 数 形式 。 


Table 8-17 中 有 一 些 有 效 的 interval 输入 的 例子 。 


Table 8-17. 间 隅 输 入 


示例 说 明 
1-2 SQL 标准 格式 : 一 年 两 个 月 
3 4:05:06 SQL 标准 格式 : 3 天 4 小 时 5 分 6 秒 
1 year 2 months 3 days 4 hours 5 minutes 6 传统 Postgres 格 式 : 1 年 2 个 月 3 天 4 小 时 5 
seconds 分 钟 6 秒 
P1Y2M3DT4H5M6S 8601 " 带 标识 符 格 式 ": 与 上 面相 同 含 


P0001-02-03T04:05:06 ISO 8601 "缩写 格式 ": 与 上 面相 同 含义 


8.5.5. 间 隅 输出 


间隔 类 型 的 输出 格式 可 以 用 命令 SET intervalstyle 设置 为 下 面 四 种 类 型 : 
sql_standard ， postgres , postgres_verbose 或 iso 8601 。 默 认 是 postgres 格式 ， Table 


8-18 中 有 每 种 格式 的 示例 。 


sql_standard 格式 产生 的 输出 结果 符合 SQL 的 间隔 字符 串 标准 ， 如 果 间 隔 值 满足 标准 的 限制 
(无 论 只 有 年 -月 ， 或 只 有 天 -时 间 ， 没 有 积极 和 消极 的 构成 的 混合 ) 。 否则 输出 类 似 一 个 标 
准 年 -月 文本 字符 串 后 跟 有 一 个 天 -时 间 文 本 字符 串 ， 带 有 添加 明确 标记 的 消除 歧义 混合 信号 
的 时 间 间 隔 。 


当 参 数 DateStyle 设 置 为 Iso 时 ， postgres 格式 的 输出 与 PostgreSQL 8.4 之 前 的 版 本 一 致 。 


当 参 数 patestyle 设置 为 非 - Iso, postgres_verbose 格式 的 输出 与 PostgreSQL 8.4 之 前 的 
版 本 一 致 。 


iso_8691 格式 的 输出 与 ISO 8601 标 准 4.4.3.2 节 中 的 "format with designators" 一 致 。 


Table 8-18. 间隔 输出 格式 示例 


格式 年 -月 间隔 天 -时 间 间 隔 混合 间隔 
sql_standard 1-2 3 4:05:06 -1-2 +3 -4:05:06 
12 NE. 人 ‘AE: 
postgres 月 3 天 04:05:06 -1 年 -2 个 月 +3 天 -04:05:06 
@1 年 2  @3 天 4 小 时 5 @1 年 2 个 月 -3 天 4 小 时 5 


postgres_verbose 


个 月 分 6 秒 分 6 秒 以 前 
iso_8601 P1Y2M P3DT4H5M6S P-1Y-2M3DT-4H-5M-6S 


ype 1 
8.6. 布尔 类 型 
PostgreSQL 支 持 SQL 标准 的 boolean 数据 类 型 。 参 阅 Table 8-19。 boolean 只 能 有 "true"( 真 ) 
或 "false"( 假 ) 两 个 状态 ， 或 第 三 种 "unknown"( 未 知 ) 状 态 ， 用 NULL 表示 。 
Table 8-19. 布尔 数据 类 型 


名 称 存储 格式 描述 


boolean 1 = 真 / 假 


dt 


" 真 " 值 的 有 效 文本 值 是 : 


TRUE 


"true' 


对 于 " 假 "， 你 可 以 使 用 下 面 这 些 : 


FALSE 


前 导 或 尾随 空白 将 被 忽略 ， 大 小 写 无 关 。 使 用 true 和 rase 这 样 的 字眼 比较 好 (也 是 SQL 和 兼 
容 的 用 法 )。 


Example 8-2 显 示 了 用 字母 t 和 f 输出 boolean 值 的 例子 。 


Example 8-2. 使 用 boolean 类 型 


CREATE TABLE testi (a boolean, b text); 
INSERT INTO test1 VALUES (TRUE, 'sic est'); 
INSERT INTO test1 VALUES (FALSE, 'non est'); 
SELECT * FROM test1; 


t | sic est 
f | non est 


SELECT * FROM testi WHERE a; 


t | sic est 


8.7. 枚 举 类 型 


枚 举 类 型 是 一 个 包含 静态 和 值 的 有 序 集合 的 数据 类 型 。 等 于 某 些 编程 语言 中 的 enum 类 型 。 
一 个 枚 举 类 型 可 以 是 一 周 中 的 天 ， 或 者 一 块 数据 的 状态 值 的 集合 。 


8.7.1. 枚 举 类 型 的 声明 
用 CREATE TYPE 创 建 枚 举 类 型 ， 如 : 


CREATE TYPE mood AS ENUM ('sad', 'ok', 'happy'); 


MRA k —H, Bele, MARHTUAFANBREL. 


CREATE TYPE mood AS ENUM ('sad', 'ok', 'happy'); 
CREATE TABLE person ( 

name text, 

current_mood mood 


INSERT INTO person VALUES ('Moe', 'happy'); 
SELECT * FROM person WHERE current_mood = 'happy'; 
name | current_mood 
ee ea ete, 
Moe | happy 
(1 row) 


8.7.2. 排序 


枚 举 类 型 中 ， 值 的 顺序 是 创建 枚 举 类 型 时 定义 的 顺序 。 所 有 的 比较 标准 运算 符 及 其 相关 的 聚 
集 函 数 都 可 支持 枚 举 类 型 ， 例 如 : 


INSERT INTO person VALUES ('Larry', 'sad'); 
INSERT INTO person VALUES ('Curly', 'ok'); 

SELECT * FROM person WHERE current_mood > 'sad'; 
name | current_mood 


SELECT * FROM person WHERE current_mood > 'sad' ORDER BY current_mood; 
name | current_mood 


SELECT name 

FROM person 

WHERE current_mood = (SELECT MIN(current_mood) FROM person); 
name 


8.7.3. 类 型 安全 
每 个 枚 举 类 型 都 是 独立 的 ， 不 能 与 其 他 枚 举 类 型 结合 ， 如 : 


CREATE TYPE happiness AS ENUM ('happy', 'very happy', 'ecstatic'); 
CREATE TABLE holidays ( 

num_weeks integer, 

happiness happiness 
) ; 
INSERT INTO holidays(num_weeks, happiness) VALUES (4, 'happy'); 
INSERT INTO holidays(num_weeks, happiness) VALUES (6, 'very happy'); 
INSERT INTO holidays(num_weeks, happiness) VALUES (8, 'ecstatic'); 
INSERT INTO holidays(num_weeks, happiness) VALUES (2, 'sad'); 
ERROR: invalid input value for enum happiness: "sad" 
SELECT person.name, holidays.num_weeks FROM person, holidays 

WHERE person.current_mood = holidays.happiness; 

ERROR: operator does not exist: mood = happiness 


如 果真 的 需要 那么 做 ， 可 以 要 么 自 定 义 运算 符 ， 要 么 为 查询 添加 显 式 转换 : 


SELECT person.name, holidays.num_weeks FROM person, holidays 
WHERE person.current_mood::text = holidays.happiness: : text; 
name | num_weeks 


8.7.4. 实施 细则 


一 个 枚 举 值 在 磁盘 上 占 4 字 节 。 一 个 枚 举 值 的 文本 标签 长 度 由 编译 到 PostgreSQL 中 
的 NAMEDATALEN 设置 ， 以 标准 方式 编译 意味 着 最 多 63 字 节 。 


榴 举 标签 对 大 小 写 是 敏感 的 ， 因 此 'happy' 不 等 于 'HAPPY' o 标签 中 的 空格 也 是 一 样 。 


从 内 部 枚 举 值 到 文本 标签 的 翻译 是 保存 在 系统 目录 pg_enum 中 。 可 以 直接 查询 这 个 目录 。 


8.8. 几何 类 型 


几何 数据 类 型 表示 二 维 的 平面 物体 。Table 8-20 显示 了 PostgreSQL 里 面 可 用 的 几何 类 型 。 最 
基本 的 类 型 : 点 ， 是 其 它 类 型 的 基础 。 


Table 8-20. 几何 类 型 


AF 存储 空间 说 明 表现 形式 
point 16 $F 平面 中 的 点 (x,y) 
line Bp) ees (无 穷 ) 直 线 (未 完全 实现 ) ((x1,y1),(x2,y2)) 
lseg 32 F4i (有 限 ) 线 段 ((x1,y1),(x2,y2)) 
box 32 $4 和 矩形 ((x1,y1),(x2,y2)) 
path 16+16n #4 闭合 路 径 ( 与 多 边 形 类 似 ) ((X1,y1),...) 
path 16+16n F $ 开放 路 径 [(x1,y1),...] 
polygon 40+16n #4 边 形 (与 闭合 路 径 相 似 ) ((x1,y1),..-) 
circle 24 PH <(x,y),t> ( 国 心 和 半径 ) 


我 们 有 一 系列 丰富 的 函数 和 操作 符 可 用 来 进行 各 种 几何 计算 ， 如 拉 伸 、 转 换 、 旋 转 、 计 算 相 
交 等 。 它们 在 Section 9.11 里 有 解释 。 


8.8.1. 点 


点 是 几何 类 型 的 基本 二 维 构造 单位 。 用 下 面 语法 描述 point 的 数值 : 


这 里 的 _x_ 和 _y 是 用 浮 点 数 表示 的 点 的 坐标 。 
点 输出 使 用 第 一 种 语法 。 


8.8.2. 线段 


线段 ( 1seg ) 是 用 一 对 点 来 代表 的 。 1seg 的 值 用 下 面 语法 声明 : 


[EX 
€ ( sek 7 SAL a ( Sep SE DD 
CA yd) (O V 25) 
=i Bye P X22 y2 


这 里 的 Coxi, yi) (`…x2 , _y2_  ) 是 线段 的 端点 。 


线段 输出 使 用 第 一 种 语法 。 


8.8.3. 矩形 


和 矩形 是 用 一 对 对 角 点 来 表示 的 。 box 的 值 用 下 面 语法 声明 : 


这 里 的 (xi ，y1 ) 和 (`…x2 , _y2_ ) 是 矩形 的 一 对 对 角 点 。 
和 矩形 的 输出 使 用 第 二 种 语法 。 


任何 两 个 对 角 都 可 以 出 现在 输入 中 ， 但 按照 那样 的 顺序 ， 右上 角 和 左下 角 的 值 会 被 重新 排序 
以 存储 。 


8.8.4. 路 径 


路 笃 由 一 系列 连接 的 点 组 成 。 路 笃 可 能 是 开放 的 ， 也 就 是 认为 列表 中 第 一 个 点 和 最 后 一 个 点 
没有 连接 ， 也 可 能 是 闭合 的 ， 这 时 认为 第 一 个 和 最 后 一 个 点 连接 起 来 。 


path 的 数值 用 下 面 语法 声明 : 


(nn 


(Gl _xn_ 
GP SV )) (xn , yn )) 
(Cel, SAL (yn 
(Ge Sas _ in, )) 
> _y1 Ne A 
BA Re RIR RIA . DAN [] ) 表 明 一 个 开放 的 路 径 ， AHN O ) 表 明 一 


个 闭合 的 路 径 。 当 最 外 层 的 括号 被 省 略 ， 如 在 第 三 至 第 五 语法 ， 会 假定 一 个 封闭 的 路 径 。 
路 径 的 输出 使 用 第 一 种 或 第 二 种 语法 输出 ， 在 适当 的 时 候 。 


8.8.5. 多 边 形 


多 边 形 由 一 系列 点 代表 (多 边 形 的 顶点 )。 多 边 形 可 以 认为 与 闭合 路 径 一 样 ， 但 是 存储 方式 不 一 
样 而 且 有 自己 的 一 套 支 持 范 数 。 


polygon 的 数值 用 下 列 语 法 声明 : 


CE ol 4 Sal) ¢ ( ins ayni) 
( Sel AE oso 7 Cs yn 
(eye oe arty Si yl) 
Exis 了 _y1_ f: 了 —Xn_ 了 Syne 
REN RSS Mihm 
多 边 形 输出 使 用 第 一 种 语法 。 


8.8.6. 


圆 由 一 个 圆心 和 半径 标识 。 circle 的 数值 用 下 面 语法 表示 : 





A 


一 一 一 








x x x XxX 
Sa ae 
ea ay eb 


~ ~ ~ SS 





这 里 的 (``x ，y ) 是 圆心 ， _r_ 是 半径 。 


的 输出 用 第 一 种 格式 。 


8.9. 网 络 地 址 类 型 


PostgreSQL 提 供用 于 存储 IPv4 、IPv6 、MAC 地 址 的 数据 类 型 ， 在 Table 8-21 里 显示 。 用 
这 些 数据 类 型 存储 网 络 地 址 比 用 纯 文本 类 型 好 ， 因为 这 些 类 型 提供 输入 错误 检查 和 特殊 的 操 
作 和 功能 ( 见 Section 9.12)。 


Table 8-21. 网 络 地 址 类 型 


名 字 存储 空间 描述 
cidr 7K 19-4 IPv4 或 IPv6 网 络 
inet 7 或 19 字 节 IPv4 或 IPv6 主机 和 网 络 
macaddr 6 字 节 MAC 地 址 


在 对 inet 或 cidr 数据 类 型 进行 排序 的 时 候 ，1Pv4 地 址 总 是 排 在 IPv6 地 址 前 面 ， 包 括 那 些 
封装 或 者 是 映射 在 IPv6 地 址 里 的 |Pv4 地 址 ， 比如 ::10.2.3.4 或 ::ffff:10.4.3.2。 


8.9.1. inet 


inet 在 一 个 数据 域 里 保存 主机 的 IPv4 或 IPv6 地 址 ， 以 及 一 个 可 选 的 等 效 子 网 。 子 网 的 等 
效 是 通过 计算 主机 地 址 中 有 多 少 位 表示 网 络 地 址 的 方法 来 表示 的 (" 子 网 掩 码 ")。 如 果子 网 掩 三 
是 32 并 且 地 址 是 IPv4 ， 那 么 不 表示 任何 子 网 ， 只 是 一 台 主 机 。 在 IPv6 里 ， 地 址 长 度 是 
128 位 ， 因 此 128 位 表明 一 个 唯一 的 主机 地 址 。 请 注意 如 果 你 想 只 接受 网 络 地 址 ， 你 应 该 使 
用 cidr 类 型 而 不 是 inet 类 型 。 


该 类 型 的 输入 格式 是 _address/y ， 这 里 的 _address” 是 IPv4 或 者 IPv6 地 址 ， y 是 子 
网 掩 码 的 二 进 制 位 数 。 如 果 yy 部 分 未 填 ， 则 子 网 掩 码 对 IPv4 Mae 32 ， 对 IPv6 而 言 是 
128, 所 以 该 值 表 示 只 有 一 台 主 机 。 显 示 时 ， 如 果 该 值 表示 只 有 一 台 主 机 ， _/y_ 将 不 会 显 
Mo 


8.9.2. cidr 


cidar 保存 一 个 IPv4 或 IPv6 网 络 地 址 。 其 输入 和 输出 遵循 无 类 别 的 互联 网 域 路 由 习惯 。 声 
明 一 个 网 络 的 格式 是 _address/y ， 这 里 的 _address 是 IPv4 或 者 IPv6 ttik, _y 是 子 网 
掩 码 的 二 进 制 位 数 。 如 果 省 略 y , 那么 掩 码 部 分 用 旧 的 有 类 别 的 网 络 编号 系统 进行 计算 ， 
但 要 求 输入 的 数据 已 经 包括 了 确定 掩 码 所 需 的 所 有 字 节 。 声明 一 个 指定 掩 码 的 网 络 地 址 是 错 
误 的 。 


Table 8-22 是 些 例子 。 


Table 8-22. cidr 类 型 输入 举例 


cidr 输入 cidr 输出 

192.168.100.128/25 192.168.100.128/25 192.168. 
192.168/24 192.168.0.0/24 192.168.' 
192.168/25 192.168.0.0/25 192.168.’ 
192.168.1 192.168.1.0/24 192.168. 
192.168 192.168.0.0/24 192.168.' 
128.1 128.1.0.0/16 128.1/16 
128 128.0.0.0/16 128.0/16 
128112 128.1.2.0/24 128.1.2/2 
10.1.2 10.1.2.0/24 10.1.2/24 
10.1 10.1.0.0/16 10.1/16 
10 10.0.0.0/8 10/8 
10.1.2.3/32 10.1.2.3/32 101218 
2001:4f8:3:ba::/64 2001:4f8:3:ba::/64 2001:4f8 
2001:4f8:3:ba:2e0:81ff:fe22:d1f1/128  2001:4f8:3:ba:2e0:81ff:fe22:d1f1/128  2001:4f8 
:ffff:1.2.3.0/120 :ffff:1.2.3.0/120 oF Vous 
SIM jee 320) 126 ffff: 1.2.3.0/128 Se ZS 


8.9.3. inet 对 比 cidr 


inet 和 ciar 类 型 之 间 的 基本 区 别 是 inet 接受 子 网 掩 码 ， 而 cidr 不 接受 。 
Tip: 如 果 你 不 喜欢 inet 或 cidr 值 的 输出 格式 ， 请 试 一 下 host , text 和 abbrev E 
数 。 


8.9.4. macaddr 


macaddr 类 型 存储 MAC 地 址 ， 也 就 是 以 太 网 卡 硬 件 地 址 (尽管 MAC 地 址 还 用 于 其 它 用 途 )。 
可 以 接受 下 列 格式 : 


"08 :00:2b:01:02:03' 
'08-00-2b-01-02-03' 
"08002b:010203' 
"08002b-010203' 
'0800.2b01.0203' 


'08002b010203' 
它们 声明 的 都 是 同一 个 地 址 。 对 于 数据 位 a 到 f ， 大 小 写 都 行 。 输 出 总 是 我 们 上 面 给 出 的 
第 一 种 形式 。 
IEEE 标 准 802-2001 指 定 第 二 种 形式 ( 带 连 字符 ) 为 MAC 地 址 的 标准 格式 ， 并 指定 的 第 一 种 
形式 (用 冒号 ) 为 位 反 转 符号 ， 因 此 08-00-2b-01-02-03=01:00:4D:08:04:0C。 这 个 条 约 现在 
已 很 少 使 用 ， 它 和 过 时 的 网 络 协议 (如 使 牌 环 ) AX. PostgreSQL 对 位 反 转 没有 规定 ， 并 且 
所 有 接受 的 格式 使 用 LSB 协 议 顺序 。 


其 余 四 个 输入 格式 不 是 任何 标准 的 一 部 分 。 


8.10. izes X ® 


位 串 就 是 一 串 1 和 0 的 字符 串 。 它 们 可 以 用 于 存储 和 直观 化 位 掩 码 。 我 们 有 两 种 SQL 位 类 
型 : pite ime ) 和 bit varying(~~_n_ )， 这 里 的 ana 是 一 个 正 整 数 。 


bit 类 型 的 数据 必须 准确 匹配 长 度 on, 试图 存储 短 些 或 者 长 一 些 的 数据 都 是 错误 
的 。 bit varying 类 型 数据 是 最 长 n 的 变 长 类 型 ; 更 长 的 串 会 被 拒绝。 写 一 个 没有 长 度 
的 bit SMF bit(1) ， 没有 长 度 的 pit varying 意思 是 没有 长 度 限制 。 

Note: 如 果 我 们 明确 地 把 一 个 位 串 值 转换 成 biton) 那么 它 的 右边 将 被 截断 或 者 在 


右边 补 齐 需 ， 直 到 刚好 n 位 ， 而 不 会 抛 出 任何 错误 。 类 似 地 ， 如 果 我 们 明确 地 把 一 个 
位 串 数值 转换 成 bit varying(``_n” )， 如 果 它 超过 了 _n_ 位， 那么 它 的 右边 将 被 截断 。 








请 参考 Section 4.1.2.5 获 取 有 关 位 串 常 量 的 语法 信息 。 还 有 一 些 位 逻辑 操作 符 和 位 处 理 函 数 
可 用 ; 参见 Section 9.6。 


Example 8-3. 使 用 位 串 类 型 


CREATE TABLE test (a BIT(3), b BIT VARYING(5)); 

INSERT INTO test VALUES (B'101', B'0O'); 

INSERT INTO test VALUES (B'10', B'101'); 

<samp class="literal">ERROR: bit string length 2 does not match type bit(3)</samp> 
INSERT INTO test VALUES (B'10'::bit(3), B'101'); 

SELECT * FROM test; 

<samp class="literal">a | b 

有 下 二 

101 | 00 

100 | 101</samp> 


位 字符 串 值 需要 1 字 节 ， 每 组 8 位 ， 增 加 5 或 8 字 节 的 开销 取决 于 字符 串 的 长 度 〈 但 是 长 值 会 被 
压缩 或 移动 到 另外 一 条 线 上 ， Section 8.3 中 有 相关 字符 串 的 解释 ) o 


8.11. 文本 搜索 类 型 


PostgreSQL 提 供 了 两 种 数据 类 型 用 于 支持 全 文 检索 ， 即 通过 自然 语言 documents 的 集合 来 找 
到 那些 匹配 一 个 query 的 检索 。 tsvector 类 型 产生 一 个 文档 (以 优化 了 全 文 检索 的 形式 ) ， 
tsquery 类 型 用 于 代表 查询 。Chapter 12 中 说 明了 这 两 个 类 型 ， 同 时 Section 9.13 总 结 了 相 
关 的 函数 和 操作 符 。 


8.11.1. tsvector 


tsvector 的 值 是 一 个 无 重复 值 的 /exemes 排 序列 表 ， 即 一 些 同 一 个 词 的 不 同 变种 的 标准 化 
(可 参阅 Chapter 12) 。 在 输入 的 同时 会 自动 排序 和 消除 重复 ， 如 : 


SELECT 'a fat cat sat on a mat and ate a fat rat'::tsvector; 
tsvector 


为 了 包含 空格 或 标点 符号 ， 可 以 用 引号 标记 : 


SELECT $$the lexeme ' ' contains spaces$$::tsvector; 
tsvector 


' 'contains' 'lexeme' 'spaces' 'the' 


《在 这 个 例子 中 ， 我 们 使 用 了 双 引 号 美元 字符 串 文 本 ， 下 一 个 例子 是 为 了 避免 文本 中 双 引 号 
的 混 浠 。) 枚 举 的 引号 和 反 斜 杠 必 须 双 倍 : 


SELECT $$the lexeme 'Joe''s' contains a quote$$::tsvector; 
tsvector 


"Joe''s' 'a' 'contains' 'lexeme' 'quote' 'the' 


可 选 的 ， 整 型 positions 也 可 以 放 到 词汇 中 : 


SELECT 'a:1 fat:2 cat:3 sat:4 on:5 a:6 mat:7 and:8 ate:9 a:10 fat:11 rat:12'::tsvector; 
tsvector 


“ta’:d,6,10 ‘and':8 ‘ate’:9 ‘eat':3 ‘fat':2,11 'mat’:7 ‘on':5 ‘rat':12 ‘sat':4 
AOOO ooo 
位 置 通常 表示 文档 中 的 源 字 的 位 置 。 位 置信 息 可 以 用 于 proximity ranking, 位 置 值 的 范围 是 1 
到 16383， 最 大 值 默 认 是 16383。 相 同 词 的 重复 位 会 被 忽略 掉 。 


拥有 位 置 的 词汇 其 至 可 以 用 一 个 权 来 标记 ， 这 个 权 可 以 是 A， B, co, 默认 的 
是 bp ， 因 此 输出 中 不 会 出 现 : 


SELECT 'a:1A fat:2B,4C cat:5D'::tsvector; 
tsvector 


tat TA 'cat':5 'fat':2B,4C 


权 可 以 用 来 反映 文档 结构 ， 如 : 标记 标题 以 与 主体 相 区 别 。 全 文 检索 排序 画 数 可 以 为 不 同 的 
权 标 记 来 分 配 不 同 的 优先 级 。 


充分 理解 tsvector 类 型 不 能 自己 标准 化 这 一 点 是 很 重要 的 ， 它 假设 传递 给 它 的 单词 对 应 用 程 
序 来 说 是 恰当 的 标准 化 了 的 ， 如 : 


select 'The Fat Rats'::tsvector; 
tsvector 


对 大 多 数 的 英文 全 文 检索 应 用 来 说 ， 上 面 的 单词 会 被 认为 非 规范 化 的 ， 但 tsvector 并 不 关心 
这 些 。 原 始 文件 中 的 文字 应 该 通过 to_tsvector 来 为 检索 恰当 的 规范 化 这 些 单词 


SELECT to_tsvector('english', 'The Fat Rats'); 
to_tsvector 


详细 信息 可 参阅 Chapter 12. 


8.11.2. tsquery 


tsquery 存储 用 于 检索 的 词汇 ， 并 且 使 用 布尔 操作 符 & (AND), | (OR) 和 ! (NOT) 来 组 合 
它们 。 括 号 用 来 强调 操作 符 的 分 组 : 


SELECT 'fat & rat'::tsquery; 
tsquery 


SELECT 'fat & (rat | cat)'::tsquery; 
tsquery 


SELECT 'fat & rat & ! cat'::tsquery; 
tsquery 


在 没有 括号 的 情况 下 ， ! (NOT) 结 合 的 最 紧密 ， 而 & (AND) 结 合 的 比 | (OR) 紧 密 。 


可 选 的 ， tsquery 中 的 词 汇 可 以 被 一 个 或 多 个 权 字母 来 标记 ， 这 些 权 字母 用 来 限制 它们 只 能 
与 带 有 匹配 权 的 tsvector 词汇 进行 匹配 。 


SELECT 'fat:ab & cat'::tsquery; 
tsquery 


同样 ， tsquery 中 的 词汇 可 以 用 * 进行 标记 来 指定 前 级 匹配 : 


SELECT 'super:*'::tsquery; 
tsquery 


"super':* 


这 个 查询 可 以 匹配 tsvector 中 以 "super" 开 始 的 任意 单词 。 请 注意 ， 前 级 首先 被 文本 搜索 配 
转 处 理 ， 这 也 就 意味 着 下 面 的 结果 为 真 : 


SELECT to_tsvector( 'postgraduate' ) @@ to_tsquery( 'postgres:*' ); 
?column? 


因为 postgres 去 掉 后 面 后 得 到 postgr : 


SELECT to_tsquery('postgres:*'); 


to_tsquery 
"postgr':* 
(1 row) 


这 样 就 匹配 postgraduate Fe 


词汇 的 引用 规则 与 之 前 tsvector 中 词汇 的 描述 一 样 ; 并 且 ， 与 tsvector 一 样 ， 任 何 单词 必 
须 在 转换 为 tsquery 类 型 前 规范 化 。 to_tsquery 画 数 可 以 方便 的 用 来 执行 规范 化 。 
SELECT to_tsquery('Fat:ab & Cats'); 


to_tsquery 


8.12. UUID 类 型 


uuid 数据 类 型 用 来 存储 RFC 4122, ISO/IEF 9834-8:2005 以 及 相关 标准 定义 的 通用 唯一 标识 

符 (UUID) 。 (一 些 系统 认为 这 个 数据 类 型 为 全 球 了 唯一 标识 符 ， 或 GUID。) 这 个 标识 符 是 
一 个 由 算法 产生 的 128 位 标识 符 ， 使 它 不 可 能 在 已 知 使 用 相同 算法 的 模块 中 和 其 他 方式 产生 的 
标识 符 相 同 。 因此 ， 对 分 布 式 系统 而 言 ， 这 种 标识 符 比 序列 能 更 好 的 提供 唯一 性 保证 ， 因 为 
序列 只 能 在 单一 数据 库 中 保证 唯一 。 


UUID 被 写成 一 个 小 写 十 六 进 制 数 字 的 序列 ， 由 分 字符 分 成 几 组 ， 特别 是 一 组 8 位 数字 +3 组 4 
位 数字 + 一 组 12 位 数字 ， 总 共 32 个 数字 代表 128 位 ， 一 个 这 种 标准 的 UUID 例 子 如 下 : 


ageebc99-9cgob-4ef8-bb6d-6bb9bd380al11 


PostgreSQL 同 样 支持 以 其 他 方式 输入 ASRS, 由 花 括号 包围 的 标准 格式 ， 省 略 部 分 或 所 
有 连 字 符 ， 在 任意 一 组 四 位 数字 之 后 加 一 个 连 字 符 。 如 : 


AOEEBC99-9COB-4EF8-BB6D-6BB9BD380A11 
{a0eebc99 - 9cOb- 4ef8 - bb6d-6bb9bd380a11} 
a0eebc999c0b4ef8bb6d6bb9bd380a11 
a0ee-bc99-9c0b-4ef8-bb6d-6bb9-bd38-0a11 
{a0eebc99-9c0b4ef8-bb6d6bb9-bd380a11} 


一 般 是 以 标准 格式 输出 。 


PostgreSQL 为 UUID 提 供 了 存储 和 上 比较 函数 ， 但 核心 数据 库 不 包括 能 生成 UUID 的 函数 ， 因 为 
没有 单一 的 算法 非常 适合 于 每 一 个 应用 程序 。 uuid-ossp 模 块 提 供 了 实施 几 个 标准 算法 的 函 
数 。 另 外 ， UUID 可 以 由 客户 端 应 用 或 通过 服务 器 端 罚 数 库 调用 而 生成 。 


8.13. XML 类 型 


xml 数据 类 型 可 以 用 于 存储 XML 数据 。 将 XML 数据 存 到 text 类 型 中 的 优势 在 于 它 能 够 为 结 
构 良 好 性 来 检查 输入 值 ， 并 且 还 支持 范 数 对 其 进行 类 型 安全 性 检查 ， 可 参阅 Section 9.14。 
要 使 用 这 个 数据 类 型 ， 编 译 时 必须 使 用 configure --with-libxml 。 


xml 可 以 存储 由 XML 标准 定义 的 格式 良好 的 "文档 "， 以 及 由 XML 标准 中 

的 XMLDecl? content 定义 的 "内 容 "片段 ， 大 致 上 ， 这 意味 着 内 容 片 段 可 以 有 多 个 顶级 元 素 或 
字符 节点 。 _xmlvalue ”|IS DOCUMENT 表达 式 可 以 用 来 判断 一 个 特定 的 xml 值 是 一 个 完整 
的 文件 还 是 内 容 片段 。 

8.13.1. 创建 XML 值 


{= FAN RES xmlparse : 来 从 字符 数据 产生 xml 类 型 的 值 F 


XMLPARSE ( { DOCUMENT | CONTENT } _value_) 


例子 


XMLPARSE (DOCUMENT '<?xml version="1.0"?><book><title>Manual</title><chapter>...</chapter 
XMLPARSE (CONTENT 'abc<foo>bar</foo><bar>foo</bar>' ) 





然而 根据 SQL 标准 ， 这 是 唯一 的 用 于 将 字符 串 转 换 成 XML 值 的 方式 ，PostgreSQL 特 有 的 语法 
也 可 以 使 用 : 


xml SHEE Sule 
'<foo>bar</foo>'::xml 


xml 类 型 对 一 个 文档 类 型 声明 (DTD) 不 会 验证 输入 值 ， 即使 输入 值 声明 了 一 个 DTD。 目 前 
没有 内 置 支持 用 于 对 其 他 XML 架 构 语言 (如 XML Schema) 验证 。 


使 用 部 数 xmlserialize : 来 从 xml 产生 一 个 字符 串 。 


XMLSERIALIZE ( { DOCUMENT | CONTENT } _value AS _type_ ) 





_type_ AY LA character » Character varying 或 text (或 其 中 某 个 的 变种 )。 同时 ， 根据 
SQL 标准 ， 这 是 xm 和 字符 类 型 之 间 的 唯一 的 转换 方式 ， 但 PostgreSQL 仍 支持 简单 的 值 转 
换 。 


当 一 个 字符 串 值 在 没有 通过 xMLPARSE 或 XMLSERIALIZE 的 情况 下 ， 与 xml 类 型 进行 转换 时 ， 
分 别 的 ， 选 择 Document 与 content 是 由 "XML option" 会 话 配置 参数 决定 ， 这 个 配置 参数 可 以 
由 标准 命令 来 设置 : 


SET XML OPTION { DOCUMENT | CONTENT }; 
或 更 多 类 似 的 PostgreSQL 语 法 : 
SET xmloption TO { DOCUMENT | CONTENT }; 


默认 是 CONTENT ， 因 此 所 有 的 XML 数据 格式 都 能 支持 。 


Note: 随 着 默认 XML 选项 的 设置 ， 如 果 字 符 串 中 包含 一 个 文档 类 型 声明 ， 那么 你 不 能 直 
接 将 其 转换 成 xml 类 型 ， 因 为 XML 内 容 片断 的 定义 不 支持 。 如 果 非 得 需要 这 么 做 ， 要 
使 用 xMLPARSE ， 要 么 更 改 XML 选 项 。 








六 








8.13.2. 编码 处 理 


在 对 客户 端 和 服务 器 端 进行 多 字符 编码 ， 以 及 在 通过 它们 传递 XML 数据 时 需要 格外 注意 。 当 
使 用 文本 模式 (正常 模式 ) 在 服务 器 端 和 客户 端 之 间 传 递 查询 和 查询 结果 时 ， PostgreSQL 在 
各 自 终 端 对 所 有 传递 的 字符 数据 和 字符 编码 进行 相互 转换 ， 参 阅 Section 22.3, 这 包括 XML 值 
的 字符 串 表 示 形 式 ， 如 上 面 的 例子 。 这 通常 意味 着 XML 数据 中 的 编码 声明 ， 在 客户 端 和 服务 
器 之 间 传 递 时 ， 可 以 成 为 无 效 字符 数据 转换 为 其 他 编码 。 这 是 因为 枚 举 编码 声明 没有 改变 。 

为 了 应 对 该 问题 ， 提交 输入 到 xm 类 型 的 字符 串 中 的 编码 声明 会 被 /gnoreq， AH, ARS 
被 认为 是 在 当前 服务 器 编码 中 。 所 以 ， 对 正确 的 义理 来 说 ， XML 数据 的 字符 串 必 须 从 在 当前 
客户 端 编码 中 的 客户 端 发 送 。 客 户 端 有 责任 ， 要 么 在 传递 到 服务 器 之 前 将 文档 转换 成 当前 客 
户 端 编码 ， 要 人 么 适当 的 调整 客户 端 编 码 。 输出 时 ， xml 类 型 的 值 不 会 有 编码 声明 ， 同时 客户 
端 会 认为 所 有 的 数据 都 是 在 当前 客 户 端 编码 之 中 的 。 


当 使 用 二 进 制 模式 在 服务 器 和 客户 端 之 间 传 递 查询 参数 和 查询 结果 ， 没 有 执行 字符 集 转 换 ， 

因此 解决 方法 是 不 同 的 。 在 这 种 情况 下 ， 将 会 遵守 XML 数据 中 的 编码 声明 ， 并 且 如 果 声 明 不 
存在 ， 数 据 会 被 假定 为 UTF-8 格 式 ( 如 同 XML 标 准 要 求 那样 ， 但 需要 注意 的 是 PostgreSQL 不 
支持 UTF-16)。 输 出 时 ， 会 对 数据 进行 编码 声明 以 指定 客户 端 编 码 ， 除非 客户 端 编码 格式 是 
UTF-8。 


不 用 说 ， 如 果 XML 数据 编码 格式 ， 客 户 端 编码 格式 ， 以 及 服务 器 编码 格式 都 一 样 ， 那么 用 
PostgreSQL 你 理 XML 数 据 将 会 减少 错误 ， 并 且 效 率 会 很 高 。 在 内 部 ， XML 数据 是 用 UTF-8 编 
码 格式 处 理 的 ， 因 此 ， 如 果 服 务 器 端 编码 也 是 UTF-8 时 ， 计 算 性 能 会 很 高 。 


Caution 


当 服 务 器 编码 非 UTF-8 格 式 时 ， 一 些 XML 相 关 的 函数 可 能 完全 不 支持 非 ASCII 数 据 ， 特别 
是 xpath() AR, 


8.13.3. 访问 关 ML 值 


xml 数据 类 型 有 些 特 殊 ， 因 为 它 不 提供 比较 运算 符 。 这 是 因为 对 XML 数据 ， 没有 很 好 的 定义 
和 通用 的 比较 运算 符 。 这 样 做 的 一 个 后 果 是 ， 不 能 通过 xml 与 检索 值 的 比较 来 检索 行 。 因 此 
XML 值 必 须 带 有 一 个 单独 的 关键 值 ， 如 一 个 ID。 另 一 个 解决 比较 XML 值 的 方法 是 ， 先 将 它们 
转换 成 字符 串 ， 但 需要 注意 的 是 字符 串 比 较 与 一 个 有 用 的 XML 比较 方法 无 关 。 

因为 没有 针对 xml 数据 类 型 的 比较 运算 符 ， 因 此 不 能 在 这 种 类 型 的 字段 上 直接 创建 索引 。 如 
果 需 要 对 XML 数据 进行 快速 搜索 ， 可 能 的 解决 方法 包括 将 表达 式 转 换 成 一 个 字符 串 类 型 ， 然 
后 对 它 进 行 素 引 ， 或 素 引 一 个 XPath 表达 式 。 当 然 ， 实 际 查询 是 不 得 不 进行 调整 ， 以 使 用 一 
个 索引 表达 式 进 行 检索 。 

PostgreSQL 中 的 文本 检索 功能 也 可 用 于 加 快 XML 数据 的 全 文 搜索 。 但 必要 的 预 处 理 支 持 在 
PostgreSQL 中 还 不 能 获得 。 


8.14. JSON 类 型 


json 数据 类 型 可 以 用 来 存储 JSON (JavaScript Object Notation) 数据 ， 就 像 RFC 4627 
指定 的 那样 。 这 样 的 数据 也 可 以 存储 为 text ， 但 是 json 数据 类 型 更 有 利于 检查 每 个 存储 
的 数值 是 可 用 的 JSON 值 。 这 里 也 有 相关 的 支持 函数 可 用 ; 参阅 Section 9.15。 


PostgreSQL 只 人 允许 每 个 数据 库 用 一 种 服务 器 编码 。 因 此 ， 使 JSON 严 格 符合 规范 是 不 可 能 
的 ， 除 非 服务 器 编码 是 UTF-8。 试图 直接 包含 不 能 在 服务 器 编码 中 表示 的 字符 将 会 失败 ; 相 
RAY, 能 在 服务 器 编码 中 表示 但 是 不 在 UTF-8 中 的 字符 是 被 允许 的 。 \uxxxx 逃逸 是 被 允许 
的 ， 无 视 服务 器 编码 ， 并 且 只 检查 语法 的 正确 性 。 


8.15. Arrays 


PostgreSQLitiF FFRELMEKNS HM, 数组 类 型 可 以 是 任何 基本 类 型 或 用 户 定义 类 
型 ， 枚 举 类 型 或 复合 类 型 。 不 支持 域 的 数组 。 


8.15.1. 数组 类 型 的 声明 
为 说 明 这 些 用 法 ， 我 们 先 创 建 一 个 由 基本 类 型 数组 构成 的 表 : 


CREATE TABLE sal_emp ( 
name text, 
pay_by_quarter integer[], 
schedule text[][] 


如 上 所 示 ， 一 个 数组 类 型 是 通过 在 数组 元 素 类 型 名 后 面 附加 方 括 弧 ( [] ) 来 命名 的 。 上 面 的 命 
合 料 创建 一 个 叫 sal_emp 的 表 ， ROE ABEL name 字段 是 一 个 text 类 型 字符 串 ， RTE 
员 季 度 薪 水 的 pay_by_quarter 字段 是 一 个 一 维 integer XWA, RTE A ARIEI schedule 
字段 是 一 个 两 维 text 数组 。 


CREATE TABLE 的 语法 允许 声明 数组 的 确切 大 小 ， 比 如 : 


CREATE TABLE tictactoe ( 
squares integer[3][3] 
); 


不 过 ， 目 前 的 实现 忽略 任何 提供 的 数组 尺寸 限制 (等 价 于 未 声明 长 度 的 数组 )。 


目前 的 实现 也 不 强制 数组 维 数 。 特 定 元 素 类 型 的 数组 都 被 认为 是 相同 的 类 型 ， 不 管 他 们 的 大 
小 或 者 维 数 。 因 此 ， 在 cREATE TABLE 里 定义 数字 或 者 维 数 都 不 影响 运行 时 的 行为 。 


另外 还 有 一 种 语法 ， 它 通过 使 用 关键 字 ARRAY 遵循 SQL 标准 ， 可 以 用 于 声明 一 维 数 
组 。 pay_by_quarter 可 以 定义 为 : 


pay_by_quarter integer ARRAY[4], 


或 者 不 声明 数组 的 大 小 : 


pay_by_quarter integer ARRAY, 


不 过 ， 如 前 所 述 ，PostgreSQL 并 不 强制 这 个 尺寸 限制 。 


8.15.2. 数组 值 输入 


将 数组 写成 文本 的 时 候 ， 用 花 括 弧 把 数组 元 素 括 起 来 并 且 用 逗号 将 它们 分 开 ( 如 果 你 懂 C， 那 
么 这 和 与 初始 化 一 个 结构 很 像 )。 你 可 以 在 数组 元 素 值 周围 放置 双 引 号 ， 但 如 果 这 个 值 包含 逗号 
或 者 花 括 弧 ， 那 么 就 必须 加 上 双 引 号 (下 面 有 更 多 细节 )。 因此 ， 一 个 数组 常量 的 常见 格式 如 

F: 





'{ _valt delim_ _val2 delim_ ... }' 





这 里 的 delim 是 该 类 型 的 分 隔 符 ， 就 是 在 该 类 型 的 pg type 记录 中 指定 的 那个 。 在 
PostgreSQL 发 布 提 供 的 标准 数据 类 型 里 ， 所 有 类 型 都 使 用 到 号 (，), 除 了 box 类 型 使 用 分 号 
(; ) 之 外 。 每 个 val 要 么 是 一 个 数组 元 素 类 型 的 常量 ， 要 么 是 一 个 子 数组 。 一 个 数组 常量 
的 例子 如 下 : 


'{{1, 2, 3}, {4,5,6}, {7,8,9}}' 


这 个 常量 是 一 个 3 乘 3 的 两 维 数组 ， 由 三 个 整数 子 数组 组 成 。 


要 将 一 个 数组 元 素 的 值 设 为 NULL, BERBE we 即 可 (大 小 写 无 关 )。 要 将 一 个 数组 元 素 的 
值 设 为 字符 串 "NULL"， 那 么 你 必须 加 上 双 引 号 。 


这 种 数组 常量 实际 上 只 是 我 们 在 Section 4.1.2.7 里 讨论 过 的 一 般 类 型 常量 的 一 种 特例 。 常 量 
最 初 是 当 作 字符 串 看 待 并 且 传 递 给 数组 输入 转换 器 的 ， 可 能 需要 使 用 明确 的 类 型 声明 。 


现在 我 们 可 以 展示 一 些 INSERT 语句 。 


INSERT INTO sal_emp 
VALUES ('Bill', 
'{10000, 10000, 10000, 10000}', 
"{{"meeting", "lunch"}, {"training", "presentation"}}'); 


INSERT INTO sal_emp 
VALUES ('Carol', 


"£20000, 25000, 25000, 25000}', 
"{{"breakfast", "consulting"}, {"meeting", "lunch"}}'); 


前 面 的 两 个 插入 的 结果 看 起 来 像 这 样 : 


SELECT * FROM sal_emp; 


name | pay_by_quarter | schedule 

Seen eres 有 
Bill | {10000,10000,10000,10000} | {{meeting, lunch}, {training, presentation}} 
Carol | {20000, 25000, 25000, 25000} | {{breakfast, consulting}, {meeting, lunch}} 
(2 rows) 


多 维 数组 必须 匹配 每 个 维 的 元 素数 。 如 果 不 匹 配 将 导致 错误 : 


INSERT INTO sal_emp 
VALUES ('Bill', 
'{10000, 10000, 10000, 10000}', 
'{{"meeting", "lunch"}, {"meeting"}}'); 
ERROR: multidimensional arrays must have array expressions with matching dimensions 


我 们 还 可 以 使 用 ARRAY 构造 器 语法 : 


INSERT INTO sal_emp 

VALUES ('Bill', 

ARRAY[10000, 10000, 10000, 10000], 

ARRAY[['meeting', 'lunch'], ['training', 'presentation']]); 
INSERT INTO sal_emp 

VALUES ('Carol', 

ARRAY[20000, 25000, 25000, 25000], 

ARRAY[['breakfast', 'consulting'], ['meeting', 'lunch']]); 


请 注意 数组 元 素 是 普通 的 SQL 常量 或 者 表达 式 ; 比如 ， 字 符 串 文本 是 用 单 引 号 包围 的 ， 而 不 
是 像 数 组 文本 那样 用 双 引 号 。 ARRAY 构造 器 语法 在 Section 4.2.12 里 有 更 详细 的 讨论 。 


8.15.3. 访问 数组 


现在 我 们 可 以 在 这 个 表 上 运行 一 些 查询 。 首 先 ， 我 们 演示 如 何 访问 数 组 的 一 个 元 素 。 这 个 查 
询 检索 在 第 二 季度 薪水 变化 的 履 员 名 : 


SELECT name FROM sal_emp WHERE pay_by_quarter[1] <> pay_by_quarter[2]; 


数组 的 下 标 数字 是 写 在 方 括 弧 内 的 。PostgreSQL 缺 省 使 用 以 1 为 基 的 数组 习惯 ， 也 就 是 说 ， 
一 外 n 元 素 的 数组 从 array[1] 开始 ， 到 array[``_n_ |] 结 o 


这 个 查询 检索 所 有 履 员 第 三 季度 的 薪水 : 


SELECT pay_by_quarter[3] FROM sal_emp; 
pay_by_quarter 


(2 rows) 


我 们 还 可 以 访问 一 个 数组 的 任意 矩形 片段 ， 或 称 子 数组 。 对 于 一 维 或 更 多 维 数组 ， 可 以 
用 Fas FS: _ 下 标 上 界 ”表示 一 个 数组 的 某 个 片段 。 上 比如 ， 下 面 查询 检索 BII 该 周 头 两 天 的 
第 一 件 计划 : 


SELECT schedule[1:2][1:1] FROM sal_emp WHERE name = 'Bill'; 
schedule 


{{meeting}, {training}} 
(1 row) 


如 果 任 意 维 数 被 写 为 一 个 片段 ， 也 就 是 ， 包 含 一 个 冒号 ， 那 么 所 有 维 数 都 被 当做 是 片段 。 任 
意 只 有 一 个 数字 (没有 冒号 ) 的 维 数 是 从 1 开始 到 声明 的 数字 为 止 的 。 例 如 ， [2] 被 认为 
是 [1:2] ， 就 想 下 面 例子 中 一 样 : 


SELECT Schedule[1:2][2] FROM sal_emp WHERE name = 'Bill'; 
schedule 


{{meeting, lunch}, {training, presentation}} 
(1 row) 


为 了 与 没有 片段 的 情况 相 区 分 ， 最 好 是 对 所 有 维 数 都 使 用 片段 语法 ， 例 如 ， [1:2][1:1] ， 而 


不 是 [2][1:1] 。 


如 果 数 组 本 身 或 任何 下 标 表达 式 是 NULL ， 那 么 该 数组 的 下 标 表 达 式 也 将 生成 NULL. 从 一 
个 数组 的 当前 范围 之 外 抓 取 数 据 将 生成 一 个 NULL ， 而 不 是 导致 错误 。 比如， 如 

schedule 目前 的 维 是 [1:3][1:2] ， 然后 我 们 抓 取 schedule[3][3] 会 生成 NULL. # (BY 
还 有 ， 一 个 下 标 错 误 的 数组 引用 也 生成 NULL ， 而 不 是 错误 。 


如 果 数 组 本 身 或 任何 下 标 表 达 式 是 NULL ， 那 么 该 数组 的 片段 表达 式 也 将 生成 NULL 。 但 在 
其 它 其 它 情况 下 ， 比 如 抓 取 一 个 完全 在 数组 的 当前 范围 之 外 的 数组 片断 ， 将 生成 一 个 空 数组 
( 雾 维 ) 而 不 是 NULL 。 (这 不 匹配 无 片段 数组 的 行为 并 且 是 为 历史 原因 这 样 做 的 。) 如 果 抓 
取 的 片断 部 分 覆盖 数组 的 范围 ， 那 么 它 会 自动 缩减 为 抓 取 覆盖 的 范围 而 不 是 返回 null。 


任何 数组 的 当前 维 数 都 可 以 用 array_dims BS : 


SELECT array_dims(schedule) FROM sal_emp WHERE name = 'Carol'; 
array_dims 
[1:2][1:2] 

(1 row) 


array_dims 生成 一 个 text 结果 ， 对 于 人 类 可 能 比较 容易 阅读 ， 但 是 对 于 程序 可 能 就 不 那么 
方便 了 。 我 们 也 可 以 用 array_upper 和 array_lower 画 数 分 别 返 回 数组 特定 维 的 上 界 和 下 界 : 


SELECT array_upper(schedule, 1) FROM sal_emp WHERE name = 'Carol'; 


array_upper 


(1 row) 


array_length 将 返回 特定 维 数 数组 的 长 度 : 


SELECT array_length(schedule, 1) FROM sal_emp WHERE name = 'Carol'; 


array_length 


8.15.4. 修改 数组 
一 个 数组 值 可 以 完全 被 代替 : 


UPDATE sal_emp SET pay_by_quarter = '{25000,25000,27000,27000}' 
WHERE name = 'Carol'; 


或 者 使 用 array 构造 器 语法 : 


UPDATE sal_emp SET pay_by_quarter = ARRAY[25000, 25000, 27000, 27000] 
WHERE name = 'Carol'; 


或 者 只 是 更 新 某 一 个 元 素 : 


UPDATE sal_emp SET pay_by_quarter[4] = 15000 
WHERE name = 'Bill'; 


或 者 更 新 某 个 片断 : 


UPDATE sal_emp SET pay_by_quarter[1:2] = '{27000,27000}' 
WHERE name = 'Carol'; 


可 以 通过 给 一 个 尚 不 存在 数组 元 素 赋值 的 办 法 扩大 数组 ， 所 有 位 于 原 数 组 最 后 一 个 元 素 和 这 
个 新 元 素 之 间 的 未 赋值 元 素 都 将 设 为 NULL. 例如 ， 如 果 myarray 数组 当前 有 4 个 元 素 ， 在 
对 myarray[6] 赋值 之 后 它 将 拥有 6 个 元 素 ， 其 中 myarray[5] WAKA NULL. Bal, Rt 
许 对 一 维 数组 使 用 这 种 方法 扩大 (对 多 维 数组 行 不 通 )。 


下 标 赋 值 允 许 创建 下 标 不 从 1 开始 的 数组 。 上 比如 ， 我 们 可 以 给 myarray[-2:7] 赋值 ， 创 建 一 
个 下 标 值 在 -2 到 7 之 间 的 数组 。 


新 的 数组 值 也 可 以 用 连接 操作 符 || 构造 : 


SELECT ARRAY[1,2] || ARRAY[3,4]; 
?column? 


eis has 
(1 row) 


SELECT ARRAY[5,6] || ARRAY[[1,2],[3,41]; 
?column? 


{{5, 6}, {1,2}, {3, 4}} 


(1 row) 


连接 操作 符 允 许 把 一 个 元 素 压 人 一 维 数组 的 开头 或 者 结尾 。 它 还 接受 两 个 no HRA, HK 
者 一 个 _N_ 维和 一 个 _N+1_ 维 的 数组 。 


当 向 一 维 数组 的 头 部 或 尾部 压 入 单独 一 个 元 素 后 ， 数 组 的 下 标 下 界 保持 不 变 。 上 比如 : 


SELECT array_dims(1 || '[0:1]={2,3}'::int[]); 
array_dims 


SELECT array_dims(ARRAY[1,2] || 3); 
array_dims 


如 果 将 两 个 相同 维 数 的 数组 连接 在 一 起 ， 结 果 数 组 将 保持 左 操 作 数 的 外 层 维 数 的 下 标 下 界 。 
结果 是 这 样 一 个 数组 : 包含 左 操作 数 的 每 个 元 素 ， 后 面 跟着 右 操 作 数 的 每 个 元 素 。 上 比如 : 


SELECT array_dims(ARRAY[1,2] || ARRAY[3,4,5]); 
array_dims 


SELECT array_dims(ARRAY[[1,2],[3,4]] || ARRAY[[5,6],[7,8],[9,9]]); 
array_dims 

[1:5][1:2] 

(1 row) 


如 果 将 一 个 _N_ 维 的 数组 压 到 一 个 _N+1_ 维 数组 的 开头 或 者 结尾 ， 结果 和 上 面 数组 元 素 的 情 
况 类 似 。 每 个 _N_ 维 的 子 数组 实际 上 都 是 _N+1， 维 数组 的 最 外 层 的 元 素 。 比 如 : 


SELECT array_dims(ARRAY[1,2] || ARRAY[[3,4],[5,61]); 
array_dims 

[1:3][1:2] 

(1 row) 


数组 也 可 以 用 array_prepend , array_append , array_cat 加 数 构造 。 前 两 个 只 支持 一 维 数组 ， 
而 array_cat 支持 多 维 数 组 。 请 注意 使 用 上 面 讨论 的 连接 操作 符 要 比 直接 使 用 这 些 函 数 好 。 
实际 上 ， 这 些 画 数 主要 用 于 实现 连接 操作 符 。 不 过 ， 在 用 户 定义 的 创建 画 数 里 直接 使 用 他 们 
可 能 有 必要 。 一 些 例子 : 


SELECT array_prepend(1, ARRAY[2,3]); 
array_prepend 


SELECT array_append(ARRAY[1,2], 3); 
array_append 


SELECT array_cat(ARRAY[1,2], ARRAY[3,4]); 
array_cat 


{1,2,3,4} 
(1 row) 


SELECT array_cat(ARRAY[[1,2],[3,4]], ARRAY[5,6]); 
array_cat 


{{1, 2}, {3,4}, {5, 6}} 


(1 row) 


SELECT array_cat(ARRAY[5,6], ARRAY[[1,2],[3,4]]); 
array_cat 


{{5, 6}, {1,2}, {3, 4}} 


8.15.5. 在 数组 中 检索 


要 搜索 一 个 数组 中 的 数值 ， 你 必须 检查 该 数组 的 每 一 个 值 。 你 可 以 手工 处 理 ( 如 果 你 知道 数组 
尺寸 )。 比 如 : 


SELECT * FROM sal_emp WHERE pay_by_quarter[1] = 10000 OR 
pay_by_quarter[2] = 10000 OR 
pay_by_quarter[3] = 10000 OR 
pay_by_quarter[4] = 10000; 


不 过 ， 对 于 大 数组 而 言 ， 这 个 方法 很 快 就 会 让 人 觉得 无 聊 ， 并 且 如 果 你 不 知道 数组 尺寸 ， 那 
就 没什么 用 了 。 另外 一 个 方法 在 Section 9.23 里 描述 。 上 面 的 查询 可 以 用 下 面 的 代替 : 


SELECT * FROM sal_emp WHERE 10000 = ANY (pay_by_quarter); 


另外 ， 你 可 以 用 下 面 的 语句 找 出 数组 中 所 有 元 素 值 都 等 于 10000 的 行 : 


SELECT * FROM sal emp WHERE 10000 = ALL (pay_by_quarter); 


或 者 ， 可 以 使 用 generate_subscripts AEX, 例如 : 


SELECT * FROM 
(SELECT pay_by_quarter, 
generate_subscripts(pay_by_quarter, 1) AS s 
FROM sal_emp) AS foo 
WHERE pay_by_quarter[s] = 10000; 


i SBME Table 9-50 里 面 描述 。 


你 可 以 使 用 e 操作 符 检索 一 个 数组 ， 它 可 以 检查 左 操 作 数 是 否 与 右 操作 数 重 登 。 例如 : 


SELECT * FROM sal_emp WHERE pay_by_quarter && ARRAY[10000]; 


这 个 操作 符 和 另外 一 个 数组 操作 符 在 Section 9.18 里 有 详细 的 描述 。 它 可 以 通过 一 个 恰当 的 束 
引 加 速 ， 在 Section 11.2 里 面 描述 。 


Tip: 数组 不 是 集合 ; 需要 像 前 面 那样 搜索 数组 中 的 特定 元 素 通常 表明 你 的 数据 库 设 计 有 
问题 。 数组 字段 通常 是 可 以 分 裂 成 独立 的 表 。 很 明显 表 要 容易 搜索 得 多 ， 并 且 在 元 素数 
目 非常 庞大 的 时 候 也 可 以 更 好 地 伸展 。 





8.15.6. 数组 输入 和 输出 语法 


一 个 数组 值 的 外 部 表现 形式 由 一 些 根据 该 数组 元 素 类 型 的 MO 转换 规则 分 析 的 项 组 成 ， 再 加 
上 一 些 标明 该 数组 结构 的 修饰 。 这 些 修饰 由 围绕 在 数组 值 周 围 的 花 括 弧 ( { 和 } ) 加 上 相 邻 项 
之 间 的 分 隔 字符 组 成 。 分 隔 字符 通常 是 一 个 有 逗号 ( ，) 但 也 可 以 是 其 它 的 东西 : 它 由 该 数组 元 
素 类 型 的 typdelim 设置 决定 。 在 PostgreSQL 提 供 的 标准 数据 类 型 里 ， 所 有 类 型 都 使 用 去 
5, 除了 box 类 型 使 用 分 号 ( ; ) 外 。 在 多 维 数组 里 ， 每 个 维 都 有 自己 级 别 的 花 括 弧 ， 并 且 在 
al A BAR ATE TEM HZ i RS a. 


如 果 数 组 元 素 值 是 空 字符 串 或 者 包含 花 括 弧 、 分 隔 符 、 双 引号 、 反 斜 柱 、 空 白 ， 或 者 匹配 关 
RF NULL ， 那 么 数组 输出 过 程 将 在 这 些 值 周围 包围 双 引 号 。 在 元 素 值 里 包含 的 双 引 号 和 反 
和 斜 杠 将 被 反 斜 杠 逃 选 。 对 于 数值 数据 类 型 ， 你 可 以 安全 地 假设 数值 没有 双 引 号 包围 ， 但 是 对 
于 文本 类 型 ， 我 们 就 需要 准备 好 面 对 有 双 引 号 包围 和 没有 双 引 号 包围 两 种 情况 了 。 


缺 省 时 ， 一 个 数组 的 某 维 的 下 标 索 引 是 设置 为 1 的 。 如 果 一 个 数组 的 某 维 的 下 标 不 等 于 1 ， 
那么 就 会 在 数组 结构 修饰 域 里 面 放置 一 个 实际 的 维 数 。 这 个 修饰 由 方 括 弧 ( [] ) 围 绕 在 每 个 数 
组 维 的 下 界 和 上 界 素 引 ， 中 间 有 一 个 冒号 ( ; ) 分 隔 的 字符 串 组 成 。 数组 维 数 修 饰 后 面 跟着 一 
个 等 号 操作 符 ( = )。 比 如 : 


SELECT f1[1][-2][3] AS e1, f1[1][-1][5] AS e2 
FROM (SELECT '[1:1][-2:-1][3:5]={{{1, 2,3}, {4,5,6}}}'::int[] AS f1) AS ss; 


仅 当 一 个 或 多 个 下 界 不 等 于 1 时 ， 数 组 输出 程序 才 在 结果 中 包含 明确 的 尺寸 


如 果 一 个 数组 元 素 的 值 写 成 NuLL (无 论 大 小 写 如 何 )， 那么 该 元 素 的 值 就 是 NULL 。 而 引号 和 
反 斜 杠 可 以 表示 输入 文本 字符 串 "NULL'" 值 。 另外 ， 为 了 兼容 8.2 之 前 的 版 本 ， 可 以 
将 array_nulls 配置 参数 设 为 off 以 禁止 将 NuLL 识别 为 NULL 。 


如 前 所 示 ， 当 书写 一 个 数组 值 的 时 候 ， 可 以 在 任何 元 素 值 周围 使 用 双 引 号 。 当 元 素 值 可 能 让 
数组 值 解析 器 产生 歧义 时 ， 你 必须 这 么 做 。 例如 : 元 素 值 包含 花 括 号 、 温 号 (或 者 数据 类 型 分 
割 符 )、 双 引号 、 反 斜 枉 、 在 开头 /结尾 处 有 空白 符 、 匹 配 NULL 的 字符 串 。 要 在 元 素 值 中 包 
含 双 引 号 或 反 斜 杠 ， 可 以 加 一 个 前 导 反 斜 本 。 当 然 ， 你 也 可 以 避免 引用 和 使 用 反 斜 杠 逃 逸 来 
保护 任何 可 能 引起 语法 混淆 的 字符 。 


你 可 以 在 左 花 括 弧 前 面 或 者 右 花 括 弧 后 面 写 空 白 。 你 还 可 以 在 任意 独立 的 项 字符 串 前 面 或 者 
后 面 写 空白 。 所 有 这 些 情况 下 ， 这 些 空白 都 会 被 忽略 。 不 过 ， 在 双 引 号 包围 的 元 素 里 面 的 空 
白 ， 或 者 是 元 素 里 被 两 边 非 空 白字 符 包 围 的 空白 ， 都 不 会 被 忽略 。 
Note: 请 记 住 你 在 SQL 命令 里 写 的 任何 东西 都 将 首先 解释 成 一 个 字符 串 文本 ， 然后 才 是 
一 个 数组 。 这 样 就 造成 你 所 需要 的 反 斜 杠 数量 翻 了 翻 。 比 如 ， 要 插入 一 个 包含 反 斜 杠 和 
双 引 号 的 text 数组 ， 你 需要 这 么 写 : 


INSERT ... VALUES (E'{"\\\\", "\\""}!); 
字符 串 文 本 义理 器 去 掉 第 一 层 反 斜 本 ， 然 后 剩 下 的 未 西 到 了 数组 数值 分 析 器 的 时 候 将 变 


成 ON 。 接 着 ， 该 字符 串 传 递 给 text 数据 类 型 的 输入 过 程 ， 分 别 变 

成 、 和 “" 。 如 果 我 们 使 用 的 数据 类 型 对 反 斜 杠 也 有 特殊 待遇 ， 比如 bytea, MARN 
可 能 需要 在 命令 里 放 多 达 八 个 反 斜 杠 才能 在 存储 态 的 数组 元 素 中 得 到 一 个 反 斜 枉 。 也 可 
以 用 美元 符 界定 (参阅 Section 4.1.2.4) 来 避免 双 份 的 反 斜 杠 。 


Tip: ARRAY 构造 器 语法 (参阅 Section 4.2.12) 通常 比 数组 文本 语法 好 用 些 ， 尤 其 是 在 SQL 
命令 里 写 数 组 值 的 时 候 。 在 array E, 独立 的 元 素 值 的 写法 和 数组 里 没有 元 素 时 的 写法 
一 样 。 


8.16. 复合 类 型 


合 类 型 表示 一 行 或 者 一 条 记录 的 结构 ; 它 实际 上 只 是 一 个 字段 名 和 它们 的 数据 类 型 的 列 
表 。PostgreSQL 人 允许 像 简 单数 据 类 型 那样 使 用 复合 类 型 。 上 比如， 一 个 表 的 某 个 字段 可 以 声明 
为 一 个 复合 类 型 。 


8.16.1. 声明 复合 类 型 
下 面 是 两 个 定义 复合 类 型 的 简单 例子 : 


CREATE TYPE complex AS ( 
r double precision, 
i double precision 


ye 


CREATE TYPE inventory_item AS ( 


name text, 
supplier_id integer, 
price numeric 


Ne 


语法 类 似 于 create TABLE ， 只 是 这 里 只 可 以 声明 字段 名 字 和 类 型 ; 目前 不 能 声明 约束 ( 比 
如 noT NULL )。 请 注意 As 关键 字 是 很 重要 的 ; 没有 它 ， 系 统 会 认为 这 是 一 个 不 同 
BY cREATE TYPE 命令 ， 因 此 你 会 看 到 奇怪 的 语法 错误 。 


定义 了 类 型 ， 我 们 就 可 以 用 它 创建 表 : 


CREATE TABLE on_hand ( 
item inventory_item, 
count integer 


Ne 


INSERT INTO on_hand VALUES (ROW('fuzzy dice', 42, 1.99), 1000); 


KAR : 


CREATE FUNCTION price_extension(inventory_item, integer) RETURNS numeric 
AS 'SELECT $1.price * $2' LANGUAGE SQL; 


SELECT price_extension(item, 10) FROM on_hand; 


在 你 创建 表 的 时 候 ， 也 会 自动 创建 一 个 复合 类 型 ， 名 字 与 表 名 字 相 同 ， 表示 该 表 的 行 类 型 。 
比如 ， 如 果 我 们 说 过 : 


CREATE TABLE inventory_item ( 


name text, 
supplier_id integer REFERENCES suppliers, 
price numeric CHECK (price > 0) 


Ny 


ABZ , 和 前 面相 同 的 inventory_item 复合 类 型 也 会 作为 副产品 创建 ， 并 且 可 以 和 上 面 一 样 使 
用 。 不 过 ， 需 要 注意 当前 实现 的 一 个 重要 限制 : 因为 现在 还 没有 对 复合 类 型 实现 约束 ， 所 以 
在 表 定 义 中 显示 的 约束 并 不 适用 于 表 之 外 的 复合 类 型 值 。 (一 个 部 分 绕 开 的 办 法 是 使 用 域 类 
型 作为 复合 类 型 的 成 员 。) 


8.16.2. 复合 类 型 值 输入 

要 以 文本 常量 书写 复合 类 型 值 ， 在 圆 括 弧 里 包围 字 段 值 并 且 用 逗号 分 隔 他 们 。 你 可 以 在 任何 
字段 值 周围 放 上 双 引 号 ， 如 果 值 本 身 包含 至 号 或 者 国 括 强 ， 你 必须 用 双 引 号 括 起 (更 多 细节 见 
下 面 )。 因 此 ， 复 合 类 型 常量 的 一 般 格 式 如 下 : 


YC eu » Wel pp aan)? 





一 个 例子 是 : 


'("fuzzy dice",42,1.99)' 


如 果 inventory_item 类 型 在 前 面 已 经 定义 了 ， 那 么 这 是 一 个 合法 的 数值 。 要 让 一 个 字段 值 是 
NULL ， 那 么 在 列表 里 它 的 位 置 上 不 要 写 任 何 字 符 。 上 比如， 下面 这 个 常量 在 第 三 个 字段 声明 
一 个 NULL : 


'("fuzzy dice", 42, )' 


如 果 你 想 要 一 个 空 字符 串 ， 而 不 是 NULL ， 写 一 对 双 引 号 : 


这 里 的 第 一 个 字段 是 一 个 非 NULL 的 空 字 符 串 ， 第 三 个 字段 是 NULL 


(这 些 常量 实际 上 只 是 我 们 在 Section 4.1.2.7 讨论 的 一 般 类 型 常量 的 一 个 特殊 例子 。 这 些 
一 开始 只 是 当 作 字 符 串 ， 然后 传递 给 复合 类 型 输入 转换 器 。 一 个 明确 的 类 型 声明 可 能 


我 们 也 可 以 用 Row 表达 式 语法 来 构造 复合 类 型 值 。 在 大 多 数 场合 下 ， 这 种 方法 都 比 用 字符 串 
文本 的 语法 更 简单 ， 因 为 你 不 用 操心 多 重 引 号 。 我 们 已 经 在 上 面 使 用 了 这 种 方法 了 : 


ROW('fuzzy dice', 42, 1.99) 
ROW('', 42, NULL) 


只 要 你 在 表达 式 里 有 超过 一 个 字段 ， 那 么 关键 字 ROW 就 实际 上 是 可 选 的 ， 所 以 可 以 简化 为 : 


('fuzzy dice', 42, 1.99) 
('', 42, NULL) 


Row 表达 式 语法 在 Section 4.2.13 里 有 更 详细 的 讨论 。 


8.16.3. 访问 复合 类 型 
要 访问 复合 类 型 字段 的 一 个 域 ， 我 们 写 出 一 个 点 以 及 域 的 名 字 ， 非常 关 似 从 一 个 表 名 字 里 先 


出 一 个 字段 。 实 际 上 ， 因 为 实在 太 像 从 表 名 字 中 选取 字段 ， 所 以 我 们 经 常 需要 用 圆 括 级 来 避 
免 分 析 器 混淆 。 上 比如 ， 你 可 能 需要 从 onhan 例子 表 中 选取 一 些 子 域 ， 像 下 面 这 样 : 


SELECT item.name FROM on_hand WHERE item.price > 9.99; 


这 样 将 不 能 工作 ， 因 为 根据 SQL 语法 ， item 是 从 一 个 表 名 字 选 取 的 ， 而 不 是 一 个 字段 名 
字 。 你 必须 像 下 面 这 样 写 : 


SELECT (item).name FROM on_hand WHERE (item).price > 9.99; 


或 者 如 果 你 也 需要 使 用 表 名 字 ( 比 如 ， 在 一 个 多 表 查 询 里 )， 那 么 这 么 写 : 


SELECT (on_hand.item).name FROM on_hand WHERE (on_hand.item).price > 9.99; 


现在 圆 括 弧 对 象 正 确 地 解析 为 一 个 指向 iten 字段 的 引用 ， 然 后 就 可 以 从 中 选取 子 域 。 


类 似 的 语法 问题 适用 于 在 任何 地 点 从 一 个 复合 类 型 值 中 查询 一 个 域 。 比 如 ， 要 从 一 个 返回 复 
合 类 型 值 的 函数 中 只 选取 一 个 字段 ， 你 需要 写 像 下 面 这 样 的 东西 : 


SELECT (my_func(...)).field FROM ... 


如 果 没 有 额外 的 圆 括 弧 ， 会 产生 一 个 语法 错误 。 


8.16.4. 修改 复合 类 型 


下 面 是 一 些 插入 和 更 新 复合 关 型 字段 的 正确 语法 。 首 先 ， 插 入 或 者 更 新 整个 字段 : 


INSERT INTO mytab (complex_col) VALUES((1.1,2.2)); 


UPDATE mytab SET complex_col = ROW(1.1,2.2) WHERE ...; 


第 一 个 例子 省 略 了 Row ， 第 二 个 使 用 它 ; 两 种 方法 都 行 。 
我 们 可 以 更 新 一 个 复合 字段 的 独立 子 域 : 


UPDATE mytab SET complex_col.r = (complex_col).r + 1 WHERE ...; 


请 注意 ， 这 里 我 们 不 需要 (实际 上 是 不 能 ) 在 sET 后 面 出现 的 字段 名 周围 放 上 圆 括 弧 ， 但 是 我 
们 在 等 号 右边 的 表达 式 里 引用 同一 个 字段 的 时 候 却 需要 圆 括 弧 。 


我 们 也 可 以 声明 子 域 是 insert 的 目标 : 


INSERT INTO mytab (complex_col.r, complex_col.i) VALUES(1.1, 2.2); 


如 果 我 们 没有 为 字段 的 所有 子 域 提供 数值 ， 那 么 剩 下 的 子 域 将 用 NULL 填充 。 


8.16.5. 复合 类 型 输入 和 输出 语法 


一 个 复合 类 型 的 文本 表现 形式 包含 那些 根据 独立 的 子 域 类 型 各 自 MO 转换 规则 解析 的 项 ， 加 
上 一 些 表明 这 是 复合 结构 的 修饰 。 这 些 修饰 由 整个 数值 周围 的 圆 括 弧 ( ( 和 ) ) 加 上 相 邻 域 之 
间 的 到 号 ( ，) 组 成 。 圆 括 弧 外 面 的 空白 被 忽略 ， 但 是 在 圆 括 弧 里 面 ， 它 被 当 作 子 域 数值 的 一 
部 分 ， 根 据 对 该 子 域 数据 类 型 的 输入 转换 规则 ， 这 些 空白 可 能 有 用 ， 也 可 能 没 用 。 上 比如 ， 

在 : 


a 42)' 


里 ， 如 果子 域 类 型 是 整数 ， 那 么 空白 将 被 忽略 ， 但 是 如 果 是 文本 ， 那 么 就 不 会 忽略 。 


如 前 面 显示 的 那样 ， 在 给 一 个 复合 类 型 写 数值 的 时 候 ， 你 可 以 在 独立 的 子 域 数值 周围 用 双 引 
号 包围 。 如 果子 域 数值 会 导致 复合 数值 分 析 器 产生 歧义 ， 那 么 你 必须 这 么 做 。 特别 是 子 域 包 
含 圆 括 弧 、 豆 号 、 双 引号 或 反 斜 杠 的 场合 。 要 想 在 双 引 号 括 起 来 的 复合 字段 值 里 面 放 双 引号 
或 反 斜 杠 ， 那么 你 需要 在 它 前 面 放 一 个 反 斜 本 。 (同样 ， 在 一 个 双 引 号 括 起 的 子 域 数值 里 面 
的 一 对 双 引 号 表示 一 个 双 引 号 字符 ， 就 像 SQL 字符 串 文 本 的 单 引 号 规则 一 样 。) AM, 你 
可 以 避免 引用 和 用 反 斜 杠 逃逸 的 方法 保护 所 有 可 能 会 当 作 复合 类 型 语法 的 数据 字符 。 


一 个 完全 空 的 子 域 数 值 (在 逗号 或 者 去 号 与 圆 括 弧 之 间 没 有 字符 ) 表 示 一 个 NULL 。 要 写 一 个 
空 字符 串 ， 而 不 是 一 个 NULL ， 写 "" 。 


PostgreSQL 中 文 文档 9.3 


假如 子 域 数 值 是 空 字符 串 或 者 包含 圆 括 弧 、 喜 号 、 双 引号 、 反 斜 本 、 空 白 ， 复合 类 型 输出 程 
序 会 在 子 域 数值 周围 放 上 双 引 号 。 (这 么 处 理 空白 不 是 必须 的 ， 但 是 可 以 增强 易 读 性 。) 在 
一 个 子 域 数值 里 面 嵌 入 的 双 引 号 和 反 斜 杠 将 会 写成 两 份 。 


Note: 请 注意 你 写 的 任何 SQL 命 合 都 首先 被 当 作 字 符 串 文本 解析 ， 然 后 才 当 作 复合 类 
型 。 这 就 加 倍 了 你 需要 的 反 斜 杠 数目 (假设 使 用 逃逸 字符 串 的 语法 )。 比 如 ， 要 插入 一 个 
包含 双 引 号 和 一 个 反 斜 杠 的 text 子 域 到 一 个 复合 类 型 数值 里 ， 你 需要 写 : 


TNSERT coo WANDUES. (ECA ON)" )) 2 


字符 串 文本 义理 器 先 去 掉 一 层 反 斜 枉 ， 这 样 到 达 复 合 类 型 分 析 器 的 东西 将 变 

成 ON\\") 。 接着 ， 该 字符 串 传 递 给 text 数据 类 型 的 输入 过 程 ， 变 成 "、。 (OR 
我 们 使 用 的 数据 类 型 对 反 斜 枉 也 有 特殊 待遇 ， 比 如 bytea, 那么 我 们 可 能 需要 在 命令 里 
放 多 达 八 个 反 斜 杠 以 获取 在 存储 的 复合 类 型 子 域 中 有 一 个 反 斜 枉 。) 美元 符 界定 ( 参 

阅 Section 4.1.2.4) 可 以 用 于 避免 双 份 反 斜 杠 的 问题 。 


Tip: 在 SQL 命令 里 写 复 合 类 型 值 的 时 候 ， Row 构造 器 语法 通常 比 复合 文本 语法 更 容易 
使 用 。 在 Row 里 ， 独 立 的 子 域 数值 的 写法 和 并 非 作为 复合 类 型 的 成 员 书 写 的 方法 一 样 。 


8.16. 复合 类 型 254 


8.17. 泄 围 类 型 


范围 数据 类 型 代表 着 某 一 元 素 类 型 在 一 定 范 围 内 的 值 。 (此 元 素 类 型 称 为 该 范围 的 子 类 型 )。 
例如 ， timestamp 范围 可 能 被 用 于 代表 一 间 会 议 室 被 预定 的 时 间 范 围 。 这 种 情况 下 数据 类 型 
为 tsrange ("timestamp range" 的 简写 )， 并 且 timestamp 是 子 类 型 。 子 类 型 必须 具备 完整 的 
排序 ， 这 样 清晰 定义 了 元 素 值 在 范围 之 内 ， 之 前 ， 或 者 之 后 。 


范围 类 型 是 有 用 的 。 因 为 他 们 代表 了 在 单一 范围 内 的 许多 元 素 值 ， 并 且 清 晰 表达 了 诸如 重 得 
范围 等 概念 。 出 于 计划 目的 的 时 间 和 日 期 范围 的 使 用 是 一 个 最 清晰 的 例子 ; 价格 范围 ， 仪 器 
测量 的 范围 等 也 有 用 。 


8.17.1. A ERSE H % Æ 


PostgreSQL fet FAIA BSG m BY : 


® aint4range — integer 的 范围 
e int8range — bigint 的 范围 
èe numrange — numeric 的 范围 

. . - ze 
èe tsrange — timestamp without time zone 的 范围 

. . . a 

e tstzrange — timestamp with time zone 的 范围 
e daterange — date 的 范围 


此 外 ， 你 可 以 定义 你 自己 的 范围 类 型 ; 更 多 信息 见 CREATE TYPE。 


8.17.2. sa fl 


CREATE TABLE reservation (room int, during tsrange); 
INSERT INTO reservation VALUES 
(1108, '[2010-01-01 14:30, 2010-01-01 15:30)'); 


-- 包含 
SELECT int4range(10, 20) @> 3; 


- BS 
SELECT numrange(11.1, 22.2) && numrange(20.0, 30.0); 


- 提取 上 边界 
SELECT upper(int8range(15, 25)); 


- 计算 交叉 
SELECT int4range(10, 20) * int4range(15, 25); 


= 范围 是 否 为 gay 


SELECT isempty(numrange(1, 5)); 


yA ERFARA R Table 9-44 及 Table 9-45, 


8.17.3. 包含 及 不 包含 边界 


每 个 非 空 范围 有 两 个 边界 ， 下 边界 和 上 边界 。 这 两 个 值 之 间 的 所 有 点 都 包含 在 范围 内 。 包含 
边界 意味 着 边界 点 本 身 包含 在 范围 内 ， 而 不 包含 边界 意味 着 边界 点 不 包含 在 范围 内 。 

在 一 个 文本 格式 的 范围 里 ， 包 含 下 边界 由 "[ "代表 ， 而 不 包含 下 边 AA" ( "人 代表。 同样， 一 
个 包含 上 边界 由 " ] "代表 ， 而 不 包含 上 边界 由 " ) "KR (更 多 细节 见 Section 8.17.5) 


PYZX lower_inc 和 upper_inc 分 别 检测 一 个 范围 值 的 上 下 边界 是 否 包含 。 


8.17.4. 无 限 (无 边界 ) sow 


一 个 范围 的 下 边界 可 以 被 省 略 ， 意 味 着 小 于 上 边界 的 所 有 点 都 包含 在 范围 内 。 同 样 ， 如 果 范 
围 的 上 边界 被 省 略 ， 那 么 所 有 大 于 下 边界 的 点 都 包含 在 范围 内 。 如 果 上 下 边界 都 被 省 略 ， 那 
么 所 有 元 素 类 型 的 值 都 被 认为 在 范围 内 。 


相当 于 分 别 认为 下 边界 是 " 负 无 穷 大 "， 或 者 上 边界 是 " 正 无 穷 大 "。 但 是 注意 这 些 无 穷 大 值 绝 不 
是 范围 元 素 类 型 的 值 ， 而 且 绝 不 是 范围 的 一 部 分 。 (所 以 没有 包含 无 穷 边 界 之 类 的 东西 一 如 
果 你 尝试 写 一 个 ， 它 会 被 自动 转换 成 一 个 不 包含 边界 。) 

某 些 元 素 类 型 还 有 一 个 "无 限 " 的 概念 ， 但 是 只 要 涉及 到 范围 类 型 机 制 它 就 只 是 另 一 个 值 。 例 
如 ， 在 timestamp 范 围 里 ， [today,] 意味 着 和 [today, ) 是 相同 的 东西 。 但 是 

[today, infinity] 意味 着 与 [today, infinity) 不 同 的 东西 一 后 者 不 包含 特殊 


的 timestamp 值 infinity 。 


ŽA lower_inf 和 upper_inf 分 别 检测 一 个 范围 的 无 限 下 边界 和 上 边界 。 


8.17.5. 汇 围 输 入 /输出 
范围 值 的 输入 必须 遵循 下 面 的 格式 : 


(_ 下 边界 _， 上 边界 _) 
(下 边界 ， 上 边界 _] 
[下 边界 _， 上 边界 _) 
[下 边界 , ERR] 














如 前 所 述 ， 圆 括号 或 者 方 括号 显示 下 边界 和 上 边界 是 不 包含 的 还 是 包含 的 。 注 意 最 后 的 格式 
是 空 ， 代 表 着 一 个 空 的 范围 〈 一 个 不 含有 值 的 范围 ) 。 


_ 下 边界 可 以 是 子 类 型 有 效 输入 的 一 个 字符 串 ， 或 者 是 空 以 显示 没有 下 边 界 。 同 
样 ， _ 上 边界 _ 可 以 是 子 类 型 有 效 输入 的 一 个 字符 串 ， 或 者 是 空 以 显 示 没 有 上 边界 。 


每 个 边界 值 可 以 用 " 〈 双 引号 ) 字符 引用 。 如 果 边 界 值 包含 圆 括号 ， 方 括号 ， 喜 号 ， 双 引 
号 ， 或 者 反 斜 杠 ， 这 就 很 有 必要 。 因 为 不 这 样 的 话 ， 这 些 字符 会 被 当成 范围 语法 的 一 部 分 。 
要 想 把 双 引 号 或 反 斜 杠 放 和 一 个 引用 的 边界 值 ， 就 在 它 前 面 加 一 个 反 斜 本 。 (另外 ， 加 了 双 
引号 的 边界 值 内 的 两 个 连续 的 双 引 号 用 来 表示 一 个 双 引 号 字符 ， 类 似 于 SQL 文字 串 内 的 单 引 
号 规则 。) 或 者 ， 你 可 以 避免 用 引号 ， 使 用 反 斜 杠 转 义 来 保护 所 有 数据 字符 不 被 认为 是 范围 
语法 。 而 且 ， 要 写 入 一 个 空 字 符 串 边界 值 ， 用 "" 。 这 是 因为 什么 也 不 写 入 意味 着 无 限 边 
Fo 


在 范围 值 前 后 可 以 有 空格 ， 但 是 在 圆 括号 和 方 括 号 之 间 的 任何 空格 都 被 认为 是 上 边界 或 下 边 
界 的 一 部 分 。 (重要 还 是 不 重要 取决 于 元 素 类 型 。) 





Note: 这 些 规 则 很 类 似 于 在 复合 类 型 常量 中 写 入 字段 值 。 更 多 注释 见 Section 8.16.5。 


例子 : 


-- 包括 3， 不 包括 7， 并 且 包 括 二 者 之 间 的 所 有 点 
SELECT '[3,7)'::int4range; 


-- 不 包括 3 和 7， 但 是 包括 二 者 之 间 所 有 点 
SELECT '(3,7)'::int4range; 


- 只 包括 单一 值 4 
SELECT '[4,4]'::int4range; 


-- 不 包括 点 (被 标准 化 为 “ 空 ) 
SELECT '[4,4)'::int4range; 


8.17.6. 构造 范围 


每 个 范围 有 一 个 与 范围 类 型 同名 的 构造 本 数 。 使 用 构造 画 数 往往 比 写 人 一 个 范围 文本 常量 
便利 ， 因 为 它 避 免 了 额外 引用 边界 值 的 需要 。 构 造 事 数 接受 两 到 三 个 参数 。 两 参数 方式 构造 
一 个 标准 格式 的 范围 ( 包含 下 边界 ， 不 包含 上 边界 ) ， 而 三 参数 方式 用 第 三 个 参数 指定 边界 


来 构造 范围 。 第 三 个 参数 必须 是 下 面 的 字符 串 之 一 " on" gah" Oe" []". 例 如 : 


- 完整 方式 为 : 下 边界 ， 上 边界 ， 和 指示 包含 还 是 不 包含 边界 的 文本 参数 
SELECT numrange(1.0, 14.0, '(]'); 


-- 如 果 第 三 个 参数 省 略 ， 使 用 “[ ) "。 
SELECT numrange(1.0, 14.0); 


-- 尽管 在 这 里 指定 了 “(] “， 然 而 该 值 会 被 转换 成 标准 格式 。 这 是 由 于 int8range 是 一 个 离散 范围 类 型 
(FH) o 
SELECT int8range(1, 14, '(]'); 





-- 使 用 NULL 作 任 一 边界 会 导致 范围 在 那 一 边 没有 边界 。 
SELECT numrange(NULL, 2.2); 


8.17.7. 离散 范围 类 型 


离散 范围 的 元 素 类 型 有 一 个 完善 定义 的 "阶梯 "， 例如 integer 或 者 date o 当 在 这 些 类 型 里 两 
个 元 素 中 间 没 有 有 效 值 时 ， 它 们 可 被 称 为 是 邻近 的 。 与 之 形成 对 比 的 是 连续 范围 ， 总 是 (或 
者 几乎 总 是 ) 可 能 在 两 个 给 定 值 之 间 找 到 其 它 元 素 。 例 如 ， numeric 类 型 的 范围 是 连续 的 ， 
和 timestamp 一 样 。 (即使 timestamp 精度 有 限 ， 理 论 上 可 以 被 当做 是 离散 的 ， 但 是 既然 不 
关心 阶梯 大 小 最 好 还 是 把 它 当 做 是 连续 的 。) 


考虑 一 个 离散 范围 的 另 一 种 方式 是 每 一 个 元 素 值 都 清晰 知道 它 的 "下 一 个 "或 者 "上 一 个 " 值 。 
知道 了 这 个 ， 通 过 选择 下 一 个 或 者 上 一 个 元 素 值 而 不 是 开始 给 定 的 值 ， 就 可 能 在 一 个 范围 边 
AWG 含 和 不 包含 表达 之 间 进 行 转换 。 例 如 ， 在 一 个 整数 范围 类 型 里 [4,8] 和 (3,9) 提供 相 
同 的 值 集合 ; 但 是 数值 范围 不 是 这 样 。 


离散 范围 应 当 有 一 个 标准 化 图 数 ， 该 落 数 知道 元 素 类 型 想 要 的 阶梯 大 小 。 这 个 标准 化 函数 负 
责 把 该 范围 类 型 的 等 效 值 转 换 成 同一 表达 方式 ， 尤 其 是 包含 或 不 包含 边界 。 如 果 不 指定 一 个 
APACE, 不 同 格式 的 范围 会 被 认为 是 不 相等 的 ， 即 使 它们 实际 上 可 能 代表 相同 的 值 集 


A 
Oo 


AREA XÆ int4range ， int8range ， 和 daterange 都 使 用 包括 下 边界 不 包含 上 边界 的 标 
准 格式 ; 即 ， [) 。 然 而 用 户 定义 的 范围 类 型 可 以 使 用 其 他 规则 。 


8.17.8. 定义 新 的 范围 类 型 


用 户 可 以 定义 他 们 自己 的 范围 类 型 。 这 么 做 通常 是 为 了 使 用 内 典范 围 类 型 所 不 提供 的 子 类 型 
范围 。 例如 ， 定 义 一 个 新 的 范围 子 类 型 float8 : 


CREATE TYPE floatrange AS RANGE ( 
subtype = float8, 
subtype_diff = float8mi 

); 


SELECT '[1.234, 5.678]'::floatrange; 


因为 floats 没有 有 意义 的 "阶梯 "， 我 们 在 此 例 中 不 定义 一 个 标准 化 函数 。 


如 果子 类 型 被 认为 含有 离散 的 而 不 是 连续 的 值 ， 命 合 CREATE TYPE 应 当 指 定 一 个 

canonical (标准 化 ) 函 数 。 标准 化 函数 使 用 一 个 输入 范围 值 ， 并 且 必须 返回 一 个 可 能 含有 不 同 
边界 和 格式 的 相应 的 范围 值 。 代 表 相 同 值 集合 的 两 个 范围 的 输出 必须 相同 ， 比 如 整数 范 

围 [1，7] 和 [1,8) 。 你 选择 哪个 表达 方式 作为 标准 没有 关系 ， 只 要 两 个 内 容 相当 但 格式 不 

同 的 值 总 是 映射 到 相同 格 式 的 相同 值 。 除 了 调整 包含 /不 包含 边界 格式 以 外 ， 一 旦 想 要 的 阶梯 
大 小 大 于 子 类 型 能 够 储存 的 范围 ， 标准 化 范 数 可 能 取 整 边界 值 。 例 如 ， timestamp 范围 类 型 

可 以 被 定义 为 以 一 个 小 时 作为 阶梯 值 。 这 种 情况 下 标准 化 函数 需要 把 不 是 一 小 时 的 整数 倍 的 
值 化 成 一 小 时 的 整数 倍 ， 或 者 可 能 抛 出 一 个 错误 。 


定义 你 自己 的 范围 类 型 也 允许 你 指定 使 用 一 个 不 同 的 子 类 型 B-tree 操 作 符 类 或 排序 规则 ， 以 便 
改变 排序 次 序 来 决定 哪些 值 落 入 一 个 给 定 的 范围 。 


此 外 ， 任 何 打算 要 使 用 GiST 或 SP-GiST 索 引 的 范围 类 型 应 当 定 义 一 个 子 类 型 差异 ， 或 者 
subtype_diff PR, GRA subtype_diff 索引 仍然 可 以 起 作用 ， 但 是 比 起 提 RE FB ay BY 
能 相当 低 效 。) FRBARPBARAFSEDAMAA MG, FREACNZARRA floats 值 
的 差异 (就 是 说 ， _x_ 减 去 _Y_ ) 。 在 我 们 上 面 的 例子 中 ， 可 以 使 用 常规 floats 减 操作 符 
调用 的 函数 ; 但 是 对 其 它 子 类 型 ， 类 型 转换 似乎 是 必要 的 。 关于 怎样 将 差异 表示 为 数字 的 某 
些 创新 想法 可 能 也 是 必要 的 。 subtype_diff 酌 数 应 当 尽 最 大 可 能 与 所 选 操作 符 类 和 排序 规则 
表明 的 排序 次 序 相 一致 ; 即 ， 每 当 根 据 排序 次 序 第 一 个 参数 大 于 第 二 个 参数 时 ， 结 果 应 当 是 
正 数 。 


更 多 创建 范围 类 型 的 信息 见 CREATE TYPE。 


8.17.9. 325| 


A LAstse Be ARI A/}ZGISTAISP-GiSTHS|. PIM, Belj#—TGISTHG : 


CREATE INDEX reservation_idx ON reservation USING gist (during); 


一 个 GiST 或 者 SP-GiST 索 引 可 以 加 速 包含 这 些 范围 操作 符 的 查询 : =, aa, a@lt;@, @agt; , 
@lt;alt; ，&gt;&gt; , -|- , @&lt; ,and sagt; (更 多 信息 见 Table 9-44) 。 


此 外 ， 对 范围 类 型 的 表 列 可 以 创建 B-tree 和 哈 希 索引 。 对 这 些 索 引 类 型 ， 基 本 上 唯一 可 用 的 范 
围 操作 是 等 于 。 用 相应 的 at; 和 egt; 操作 符 可 以 为 范围 索引 定义 一 个 B-tree 排 序 次 序 ， 但 
是 这 个 次 序 相 当 武 断 ， 在 现实 世界 中 通常 没有 用 。 范 围 类 型 的 B-tree 和 哈 希 支持 主要 是 用 于 查 
询 内 部 的 排 序 和 哈 希 操作 ， 而 不 是 用 于 实际 索引 的 创建 。 


8.17.10. 汇 围 上 的 约束 


当 UNIQUE 是 一 个 对 标量 值 的 自然 约束 时 ， 对 范围 类 型 通常 是 不 合适 的 。 反 而 不 包含 约束 往往 
合适 (JLCREATE TABLE ... CONSTRAINT ... EXCLUDE) 。 不 包含 约束 允许 对 一 个 范围 
类 型 指定 约束 ， 比 如 " 非 重 受 "。 例 如 : 


CREATE TABLE reservation ( 

during tsrange, 

EXCLUDE USING gist (during WITH &&) 
); 


IDA RERPEE eH aAy ee : 


INSERT INTO reservation VALUES 
(' [2010-01-01 11:30, 2010-01-01 15:00)'); 
INSERT © 1 


INSERT INTO reservation VALUES 
('[2010-01-01 14:45, 2010-01-01 15:45)'); 
ERROR: conflicting key value violates exclusion constraint "reservation_during_excl" 
DETAIL: Key (during)=(["2010-01-01 14:45:00","2010-01-01 15:45:00")) conflicts 
with existing key (during)=(["2010-01-01 11:30:00", "2010-01-01 15:00:00")). 


你 可 以 使 用 btree gist 扩展 对 简单 标量 数据 类 型 定义 不 包含 约束 。 简单 标 量 数据 类 型 可 以 和 
范围 不 包含 结合 来 获得 最 大 的 灵活 性 。 例 如 ， 在 btree_gist 安装 后 ， 下 列 的 约束 排除 重 符 的 
范围 ， 除 非 会 议 室 房间 号 相等 : 


CREATE EXTENSION btree gist; 
CREATE TABLE room_reservation ( 
room text, 
during tsrange, 
EXCLUDE USING gist (room WITH =, during WITH &&) 


); 


INSERT INTO room_reservation VALUES 
('123A', '[2010-01-01 14:00, 2010-01-01 15:00)'); 
INSERT © 1 


INSERT INTO room_reservation VALUES 

('123A', '[2010-01-01 14:30, 2010-01-01 15:30)'); 
ERROR: conflicting key value violates exclusion constraint "room_reservation_room_during 
DETAIL: Key (room, during)=(123A, ["2010-01-01 14:30:00","2010-01-01 15:30:00")) conflic 
with existing key (room, during)=(123A, ["2010-01-01 14:00:00","2010-01-01 15:00:00")). 


INSERT INTO room_reservation VALUES 
('123B', '[2010-01-01 14:30, 2010-01-01 15:30)'); 
INSERT © 1 


N ES 





8.18. 对 象 标识 符 类 型 


PostgreSQL 在 内 部 使 用 对 象 标识 符 (OID) 作 为 各 种 系统 表 的 主键 。 同时 ， 系 统 不 会 给 用 户 创 
建 的 表 增 加 一 个 OID 系统 字段 (除非 在 建 表 时 声明 了 with oms 或 者 配置 参 

数 default with_oids 设 置 为 开启 )。 oid 类 型 代表 一 个 对 象 标识 符 。 除 此 以 外 oid 还 有 几 个 别 
名 : regproc , regprocedure , regoper , regoperator , regclass , regtype ，regconfig , 


和 regdictionary 。 Table 8-23 显 示 了 概览 。 

目前 oid 类 型 用 一 个 四 字 节 的 无 符号 整数 实现 。 因 此 ， 它 不 够 提供 大 数据 库 范围 内 的 唯一 性 
保证 ， 甚 至 在 单个 的 大 表 中 也 不 行 。 因此 ， 我 们 不 鼓励 在 用 户 创建 的 表 中 使 用 OD 字段 做 主 
键 。OID 最 好 只 是 用 于 系统 表 。 

oid 类 型 本 身 除 了 上 比较 之 外 还 有 几 个 操作 。 不 过 ， 它 可 以 转换 为 整数 ， 然 后 用 标准 的 整数 操 
作 符 操作 。 如 果 你 这 么 干 ， 请 注意 可 能 的 有 符号 和 无 符号 之 间 的 混淆 。 

OID 别名 类 型 除了 输入 和 输出 过 程 之 外 没有 自己 的 操作 。 这 些 过 程 可 以 为 系统 对 象 接受 和 显 
示 符 号 名 ， 而 不 仅仅 是 类 型 oid 将 要 使 用 的 行 数值 。 别 名 类 型 允许 我 们 简化 为 对 象 查找 OID 
值 的 过 程 。 比 如 ， 检查 和 一 个 表 mytable 相关 的 pg_attribute 行 ， 我 们 可 以 这 样 写 : 


SELECT * FROM pg_attribute WHERE attrelid = 'mytable'::regclass; 


而 不 用 : 


SELECT * FROM pg_attribute 
WHERE attrelid = (SELECT oid FROM pg_class WHERE relname = 'mytable'); 


虽然 看 上 去 不 坏 ， 但 是 这 个 例子 还 是 简化 了 好 多 ， 如 果 在 不 同 的 模式 里 有 好 多 叫 mytable 的 
表 ， 那 么 我 们 需要 写 一 个 更 复杂 的 子 查询 。 regclass 的 输入 转换 器 义理 根据 模式 路 径 设 置 的 
表 检 索 工作 ， 所 以 它 自动 干 了 "正确 的 事情 "。 类 似 的 还 有 ， 把 一 个 表 的 OID 转换 

成 regclass 是 查找 一 个 OID 对 应 的 符号 名 称 的 最 简单 方法 。 


Table 8-23. 对 象 标识 符 类 型 


名 字 引用 描述 数值 例子 
x*b bn 
oid 任意 数字 化 的 对 象 564182 
标识 符 
regproc pg_proc KALE sum 
带 参数 类 型 的 
Wea R - 
regprocedure pg_proc op sum(int4) 
EJ 
regoper pg_operator 操作 符 名 十 
Bs 参 类 米 1 ‘ w. 1 i 口 " 
regoperator pg_operator 下 参数 类 型 的 (Gntegenmintegen) 或 
操作 符 -(NONE, integer) 
regclass pg_class 关系 名 pg_type 
regtype pg_type 数据 类 型 名 integer 
regconfig pg_ts_config 文本 搜索 配置 english 
regdictionary pg_ts_dict 文本 搜索 字典 simple 


所 有 OID 别名 类 型 都 接受 有 模式 修饰 的 名 字 ， 并 且 如 果 在 当前 搜索 路 径 中 不 增加 修饰 无 法 找 
到 该 对 象 的 话 ， 那么 在 输出 时 将 显示 有 模式 修饰 的 名 字 。 regproc 和 regoper 别名 类 型 将 只 
接受 唯一 的 输入 名 字 ( 不 能 重 载 )， 因 此 它们 的 用 途 有 限 。 对 于 大 多 数 应 

用 ， regprocedure 或 regoperator 更 合适 。 对 于 regoperator ， 单 目 操作 符 是 通过 在 那些 未 
用 的 操作 数 上 写 none 来 标识 的 。 


OID 别名 类 型 的 一 个 额外 的 属性 是 依赖 关系 的 创建 。 如 果 这 些 类 型 之 一 的 常量 出 现在 一 个 存 
储 的 表达 式 里 (比如 字段 缺 省 表达 式 或 者 视图 )， 它 在 被 引用 的 对 象 上 创建 一 个 依赖 性 。 比 
如 ， 如 果 一 个 字段 有 缺 省 的 nextval('my_seq'::regclass) 表达 式 ，PostgreSQL 理解 缺 省 表 
达 式 依赖 于 序列 my_seq ; 系统 将 不 允许 在 删除 缺 省 的 表达 式 之 前 删除 该 序列 。 


系统 使 用 的 另外 一 个 标识 符 类 型 是 事务 (缩写 <abbr>xact</abbr>) 标 识 符 xid 。 它 是 系统 字 
FR xmin 和 xmax 的 数据 类 型 。 事 务 标识 符 是 32 位 的 量 。 


系统 需要 的 第 三 种 标识 符 类 型 是 命令 标识 符 cid 。 它 是 系统 字段 cmin 和 cmax 的 数据 类 型 。 
命令 标识 符 也 是 32 位 的 量 。 


系统 使 用 的 最 后 一 个 标识 符 类 型 是 行 标识 符 tido 它 是 系统 表 字 段 ctid 的 数据 类 型 。 行 ID 
是 一 对 数值 ( 块 号 ， 块 内 的 行 索 引 )， 它 标识 该 行 在 其 所 在 表 内 的 物理 位 置 。 


系统 字段 在 Section 5.4 里 有 更 多 解释 。 


8.19. 伪 类 型 


PostgreSQL 类 型 系统 包含 一 系列 特殊 用 途 的 条 目 ， 它们 按照 类 别 来 说 叫做 伪 类 型 。 伪 类 型 不 
能 作为 字段 的 数据 类 型 ， 但 是 它 可 以 用 于 声明 一 个 函数 的 参数 或 者 结果 类 型 。 伪 类 型 在 一 个 
函数 不 只 是 简单 地 接受 并 返回 某 种 SQL 数据 类 型 的 情况 下 很 有 用 。Table 8-24 列 出 了 所 有 的 伪 
类 型 。 


Table 8-24. 伪 类 型 


名 字 描述 
any 表示 一 个 男 数 接受 任何 输入 数据 类 型 。 
anyelement 表示 一 个 函数 接受 任何 数据 类 型 (参阅 Section 35.2.5)。 
anyarray 表示 一 个 函数 接受 任意 数组 数据 类 型 (参阅 Section 35.2.5)。 
anynonarray 表示 一 个 范 数 接受 任意 非 数 组 数据 类 型 (Sh Section 35.2.5)。 


表示 一 个 函数 接受 任意 枚 举 数据 类 型 (参阅 Section 35.2.5 和 


a Section 8.7)。 

E 胡 示 一 个 函数 接受 任意 范围 数据 类 型 (参阅 Section 35.2.5 和 
Section 8.17)。 

cstring 表示 一 个 函数 接受 或 者 返回 一 个 空 结尾 的 CFR, 

internal 表示 一 个 函数 接受 或 者 返回 一 种 服务 器 内 部 的 数据 类 型 。 

language_handler 一 个 过 程 语 言 调用 义理 器 声明 为 返回 language_handler o 

fdw_handler 一 个 外 部 数据 封装 器 声明 为 返回 faw_handler o 

record 标识 一 个 图 数 返 回 一 个 未 声明 的 行 类 型 。 

trigger 一 个 触发 器 函数 声明 为 返回 trigger o 

void 表示 一 个 函数 不 返回 数值 。 

opaque 一 个 已 经 过 时 的 类 型 ， 以 前 用 于 所 有 上 面 这 些 用 途 。 


用 C 编写 的 函数 (不 管 是 内 置 的 还 是 动态 装载 的 ) 都 可 以 声明 为 接受 或 者 返回 这 样 的 伪 数 据 类 
型 。 在 把 伤 关 型 用 做 本 数 参数 类 型 的 时 候 保证 图 数 行为 正常 就 是 画 数 作者 的 任务 了 。 


用 过 程 语 言 编 写 的 函数 只 能 根据 它们 的 实现 语言 是 否 可 以 使 用 俯 类 型 而 使 用 它 。 目前 ， 过 程 
语言 都 不 允许 使 用 伪 类 型 作为 参数 类 型 ， 并 且 只 允许 使 用 void 和 record 作为 结果 类 型 (如 果 
函数 用 做 触发 器 ， 那 么 加 上 trigger) 一 些 多 态 的 函数 还 支持 使 


用 anyelement ， anyarray ， anynonarray  anyenum 和 anyrange 类 型 。 


伪 类 型 internal 用 于 声明 那 种 只 能 在 数据 库 系 统 内 部 调用 的 函数 ， 它们 不 能 直接 在 SQL 查询 
里 调用 。 如 果 画 数 至 少 有 一 个 internal 类 型 的 参数 ， 那 么 我 们 就 不 能 从 SQL 里 调用 它 。 为 
了 保留 这 个 限制 的 类 型 安全 ， 我 们 一 定 要 遵循 这 样 的 编码 规则 : 不 要 创建 任何 声明 为 返 

E] internal 的 函数 ， 除非 它 至 少 有 一 个 internal 参数 。 
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PostgreSQL 为 内 建 的 数据 类 型 提供 了 大 量 的 函数 和 操作 符 。 用 户 也 可 以 定义 它们 自己 的 函数 
和 操作 符 ， 像 Part V 里 描述 的 那样 。psql 命 令 \df 和 \do 可 以 分 别 用 于 列 出 所 有 实际 可 用 的 
函数 和 操作 符 。 


如 果 你 关心 移植 性 ， 那 么 请 注意 ， 我 们 在 本 章 描述 的 大 多 数 函 数 和 操作 符 ， annie 
ABM EE ERE RELA — EST RTA it, 都 没有 在 SQL 标准 里 声明 。 许 多 其 

SQL 实现 也 有 这 些 扩展 的 功能 ， 并 且 很 多 时 候 不 同 的 数据 库 产品 中 这 些 功 衣 ERETTE. 
本 章 也 并 没有 穷尽 一 切 信息 ; 一 些 附加 的 函数 在 本 手册 的 相关 章节 里 出 现 。 


9.1. 逻辑 操作 符 


常用 的 逻辑 操作 符 有 : 


AND 
OR 


NOT 


SQL 使 用 三 值 的 逻辑 体系 ， 真 ， 假 和 null, 这 时 null 代表 "未 知 "。 观 察 下 面 真 值 表 : 


_a_ _b_ _a_ AND _b_ a OR pb 
TRUE TRUE TRUE TRUE 
TRUE FALSE FALSE TRUE 
TRUE NULL NULL TRUE 
FALSE FALSE FALSE FALSE 
FALSE NULL FALSE NULL 
NULL NULL NULL NULL 

a NOT a_ 
TRUE FALSE 
FALSE TRUE 
NULL NULL 


操作 符 ano 和 on 都 是 可 交换 的 ， 也 就 是 说 ， 你 可 以 交换 左右 操作 数 而 不 影响 结果 。 但 是 请 
参阅 Section 4.2.14 获取 有 关子 表达 式 计 算 顺 序 的 更 多 信息 。 


9.2. 比较 操作 符 


可 用 的 比较 操作 符 在 Table 9-1 显 示 。 
Table 9-1. 比较 操作 符 


操作 符 描述 
alt; 小 于 
&gt; Ee 
alt j= 小 于 或 等 于 
&gt j= 大 于 或 等 于 
= 等 于 
alt;agt; 或 != 未 等 于 


Note: != 操作 符 在 分 析 器 阶段 被 转换 成 &lt;&gt; o != 和 alt;agt; 操作 符 是 完全 等 价 
的 。 


比较 操作 符 可 以 用 于 所 有 相关 的 数据 类 型 。 所 有 上 比较 操作 符 都 是 双 目 操作 符 ， 返 
E] boolean 类 型 数值 ; 像 1 alt; 2 alt; 3 这 样 的 表达 式 是 非法 的 (因为 布尔 值 和 3 之 间 不 能 
做 比较 )。 


除了 比较 操作 符 以 外 ， 我 们 还 可 以 使 用 BETwEEN 构造 。 


_a BETWEEN _x_ AND _y 


等 效 于 


a_ >= x_ AND a <= _y 





注意 BETWEEN 认为 端点 值 是 包含 在 范围 内 的 。 NoT BETWEEN 做 相反 的 比较 : 


_a NOT BETWEEN _x_ AND _y_ 


等 效 于 


a < _xX_ OR a > _y 





BETWEEN SYMMETRIC 和 BETWEEN 一 样 ， 只 是 没有 要 求 AND 左边 的 参数 小 于 或 等 于 右边 的 参 
数 。 如 果 左 面 的 参数 不 小 于 或 等 于 右面 的 参数 ， 那么 两 个 参数 是 自动 交换 的 ， 所 以 非 空 范围 


总 是 适用 。 


要 检查 一 个 值 是 否 为 NULL ， 使 用 下 面 的 构造 : 


_expression_ IS NULL 
_expression_ IS NOT NULL 


或 者 等 效 ， 但 并 不 标准 的 构造 : 


_expression_ ISNULL 
_expression_ NOTNULL 


AEE expression. = NULL 因为 NULL 是 不 "等 于 " nwu 的 。 NULL 代表 一 个 未 知 的 数值 ， 
因此 我 们 无 法 知道 两 个 未 知 的 数值 是 否 相 等 。 这 个 行为 遵循 SQL 标准 。 


Tip: 有 些 应 用 可 能 要 求 表达 式 _expression ”= NULL 在 _expression 为 NULL 时 候 返 回 
真 。 我 们 强烈 建议 这 样 的 应 用 修改 成 遵循 SQL 标准 。 但 是 ， 如 果 这 样 修改 是 不 可 能 的 ， 
那么 我 们 可 以 打开 transform_null_equals 配 置 参 数 ， 让 PostgreSQL 将 x = NULL 自动 转 
换 成 x IS NULL 。 


Note: 如 果 _expression 是 行 值 ， 那么 当 行 表达 式 本 身 为 NULL 或 该 行 的 所 有 字段 都 为 
NULL 时 ， rs NULL 将 为 真 ; 当 行 表达 式 本 身 不 为 NULL 并 且 该 行 的 所 有 字段 都 不 为 

NULL 时 ， Is not NULL 也 将 为 真 。 因 为 这 个 行为 ， Is nut 和 rs not NULL 并 不 总 是 
为 行 值 表达 式 返 回 相 反 的 值 ， 也 就 是 ， 一 个 同时 包含 NULL 和 mon-null 值 的 行 值 表 达 式 将 
在 两 种 情况 下 都 返回 false。 这 个 规定 符合 SQL 标准 ， 但 是 与 PostgreSQL 之 前 的 版 本 不 


如 果 有 任何 一 个 输入 是 NULL ， 那 么 普通 的 比较 操作 符 生成 NULL( 表 示 " 未 知 ")， 而 不 是 true 
或 false。 例 如 ， 7 = NULL 生成 null，7 alt;agt; NULL 也 生成 null。 当 这 种 行为 不 适用 时 ， 使 


用 Is [ NOT ] DISTINCT FROM 构造 : 


_expression_ IS DISTINCT FROM _expression_ 
_expression_ IS NOT DISTINCT FROM _expression_ 


对 于 非 NULL 的 输入 IS DISTINCT FROM 与 &lt;&gt; 操作 符 相 同 。 但 是 ， 如 果 两 个 输入 都 是 
NULL ， 那 么 它 将 返回 假 ; 如 果 只 有 一 个 输入 是 NULL ， 那么 它 将 返回 真 。 类 似 的 ， 对 于 非 
NULL 的 输入 Is not DISTINCT FROM 与 = 操作 符 相 同 。 但 是 ， 如 果 两 个 输入 都 是 NULL, AB 
么 它 将 返回 真 ; 如 果 只 有 一 个 输入 是 NULL ， 那 么 它 将 返回 假 。 这 样 就 很 有 效 地 把 NULL 当 
作 一 个 普通 数据 值 看 待 ， 而 不 是 "未 知 "。 


布尔 数值 可 以 用 下 面 的 构造 进行 测试 


_expression_ IS TRUE 
_expression_ IS NOT TRUE 
_expression_ IS FALSE 
_expression_ IS NOT FALSE 
_expression_ IS UNKNOWN 
_expression_ IS NOT UNKNOWN 


这 些 构造 将 总 是 返回 真 或 假 ， 从 来 不 返回 NULL ， 即 使 操作 数 是 NULL 也 如 此 。 NULL 输入 
被 当做 逻辑 数值 "未 知 "。 请 注意 实际 上 Is UNKNOwN 和 IS NOT UNKNOWN 分 别 
与 ts NULL 和 1s not NULL 相同 ， 只 是 输入 表达 式 必须 是 布尔 类 型 。 


AY LA e4 Tp AY LA Ea 
9.3. AFERKA RER 
PostgreSQL 为 许多 类 型 提供 了 数学 操作 符 。 对 于 那些 没有 标准 的 数学 传统 的 类 型 (比如 日 期 / 
时 间 类 型 )， 我 们 在 随后 的 章节 里 描述 实际 的 行为 。 
Table 9-2 显 示 了 可 用 的 数学 操作 符 。 


Table 9-2. 数学 操作 符 


操作 符 描述 例子 结果 
+ 加 2+3 5 
J 2-3 -1 
S 乘 2 6 
/ 除 (整数 除法 将 截断 结果 ) 4/2 2 
% 模 ( 求 余 ) 5 % 4 1 
n PERAR) 2.0 ^ 3.0 8 
&#124; / 平方 根 &#124;/ 25.0 5 
&#124; #124; / 立方 根 &#124; &#124;/ 27.0 3 
! 阶乘 5 1 120 
L! 阶乘 (前 级 操作 符 ) Is 120 
@ 绝对 值 CO 5 
& 二 进 制 AND 91 & 15 Ti 
&#124; 二 进 制 OR 32 &#124; 3 35 
# 二 进 制 XOR 17 # 5 a 
= 二 进 制 NOT = -2 
&lt;alt; 二 进 制 左 移 OCT A 16 
agt ;&gt; 二 进 制 右 移 8 &gt;agt; 2 2 


位 操作 符 只 能 用 于 整数 类 型 ， 而 其 它 的 操作 符 可 以 用 于 全 部 数值 类 型 。 位 操作 符 还 可 以 用 于 
位 串 类 型 bit 和 bit varying, 如 Table 9-10 所 示 。 


Table 9-38 7 7 JAWARA. TARA, dp 表示 double precision, RERA AA 
多 都 有 多 种 不 同 的 形式 ， 区 别 是 参数 不 同 。 除 非特 别 指明 ， 任何 特定 形式 的 函数 都 返回 和 它 
的 参数 相同 的 数据 类 型 。 义理 double precision 数据 的 函数 大 多 数 是 在 宿主 系统 的 C 库 的 基 
础 上 实现 的 ; 因此 ， 精度 和 数值 范围 方面 的 行为 是 根据 宿主 系统 而 变化 的 。 


Table 9-3. 数学 函数 


ERK 返回 类 型 
与 输入 
"EOC Xe ) 
ene do) dp 
ceil(、`dp 或 (与 输入 
numeric ) 相同 ) 
"ceiling(、`dp 或 (与 输入 
numeric ) 相同 ) 
`degrees(```dp ) dp 
PCy, Sy 
numeric , X numeric 
numeric ) 
SOE a oN 或 (与 输入 
numeric ) 相同 ) 
oon dp 或 (与 输入 
numeric ) 相同 ) 
“In( dp 或 (与 输入 
numeric ) 相同 ) 
log dp 或 (与 输入 
numeric ) 相同 ) 
Hog sib 
numeric , x numeric 
numeric ) 
(与 参数 
imod (Gey eX ) 类 型 相 
同 ) 
pi() dp 
“power(***a_ dp , dp 
b dp ) 
‘power( .a 
numeric , b numeric 
numeric ) 
‘radians( “dp ) dp 
random() dp 


(与 输入 


~round( ~~ dp 或 


绝对 值 


立方 根 


不 小 于 参数 的 
最 小 的 整数 


不 小 于 参数 的 
最 小 整数 


( ceil 的 别名 ) 


把 弧度 转 为 角 
度 


integer 


quotient of 
y/x 


自然 指数 


不 大 于 参数 的 


最 大 整数 
自然 对 数 


以 10 为 底 的 
对 数 
以 b 为 底数 的 
对 数 


yl x 的 余数 
( 模 ) 


a 的 RE 
把 角度 转 为 弧 
度 


0.0 到 1.0 之 
间 的 随机 数 


圆 整 为 最 接近 


abs(-17.4) 


cbrt(27.0) 


ceil(-42.8) 


ceiling(-95.3) 


degrees(0.5) 


div(9,4) 


exp(1.0) 


floor(-42.8) 


1n(2.0) 


1og(100.0) 


log(2.0, 64.0) 


mod(9, 4) 


pi() 


power(9.0, 3.0) 


power(9.0, 3.0) 


radians(45.0) 


random() 


例子 


numeric ) 相同 ) 的 整数 round(42.4) 


round y : 圆 整 为 s 位 
meaa. Ge GNC ) numeric 小 数 round(42.4382, 2) 
为 随后 
的 random() 调 
`setseed(```dp ) void 用 设置 种 子 ( setseed(0.54823) 
= Sq 2 
ïH, 38) 
`sign( 人 、`dp 或 (与 输入 参数 的 符号 (-1， TTET 
numeric ) 相同 ) 0, +1) eae 
“sqrt(. dp 或 (与 输入 Wi t(2.0 
numeric ) 相同 ) 平方 根 
trune. dp 或 (与 输入 截断 (向 需 靠 t 42.8 
numeric ) 相同 ) 近 ) 有 
TE E numeric 截断 为 Sf 小 trunc(42.4382, 2) 
numeric, s int ) 数 
返回 一 个 桶 ， 
这 个 桶 是 在 一 
个 个 
“width_bucket( op 有 cae | 
numeric ， b1 前 ， F 
numeric , b2 int A Be PF width_bucket(5.35, 0.024, 10.06, 
numeric , count A b2 的 等 深 
m) 柱 图 中 
operand 将 被 
赋予 的 那个 
桶 。 
返回 一 个 桶 ， 
这 个 桶 是 在 一 
个 有 count 个 
`width_bucket(```op 桶 ， Li 
od a aE es b2 int A a an width_bucket(5.35, 0.024, 10.06, 
dp , count int ) A b2 的 二 
柱 图 中 
operand 将 被 
赋予 的 那个 
桶 。 


最 后 ，Table 9-4 显 示 了 可 用 的 三 角 图 数 。 所 有 三 角 画 数 都 使 用 类 型 为 double precision 的 参 
数 和 返回 类 型 。 三 角 画 数 参 数 用 弧度 来 表达 。 反 画 数 的 返回 值 也 是 用 弧度 来 表达 的 。 SHE 
面 的 单元 转换 画 数 radians() 和 degrees() o 


Table 9-4. 三 角 男 数 


函数 
“EB Se 
Asin (an exe) 
Pecan e) 
EST 于》 省 时 二 > 天 
co 
Cot texas) 
Sain) ed) 
tan( © oxen) 


RRIA 
反正 弦 
反正 切 
_y_ / x 的 反正 切 
余弦 
余 切 
正弦 
正切 


9.4. FFT BN SABRE IT 


本 节 描 述 了 用 于 检查 和 操作 字符 串 数值 的 函数 和 操作 符 。 在 这 个 环境 中 的 字符 串 包 

括 character , character varying, text 类 型 的 值 。 除 非 另 外 说 明 ， 所 有 下 面 列 出 的 函数 都 
可 以 处 理 这 些 类 型 ， 不 过 要 小 心 的 是 ， 在 使 用 character 类 型 的 时 候 ， 需 要 注意 自动 填充 的 
潜在 影响 。 有 些 函 数 还 可 以 处 理 位 串 类 型 。 


SQL 定 义 了 一 些 字符 串 画 数 ， 用 特定 的 关键 字 而 不 是 到 号 来 分 隔 人 参数。 详情 请 见 Table 9-5。 
PostgreSQL 也 提供 了 使 用 正常 的 函数 调用 语法 实现 的 这 些 函 数 的 版 本 (参阅 Table 9-6)。 


Note: 在 PostgreSQL 8.3 之 前 ， 这 些 函 数 将 默默 接受 一 些 非 字 符 串 数据 类 型 的 值 ， 由 于 
存在 从 这 些 数 据 类 型 到 text 的 隐 式 强制 转换 ， 转 换 后 的 它们 经 常 发 生意 外 的 行为 ， 
此 删除 了 降 式 强制 转换 。 然而 ， 字 符 串 连接 操作 符 ( || ) 仍 接受 非 字 符 串 输入 ， 只 要 至 
少 有 一 个 输入 是 字符 串 类 型 ， 如 Table 9-5 所 示 。 对 于 其 它 情 况 下 ， 如 果 你 需要 重复 以 前 
的 行为 ， 插 入 一 个 明确 的 强制 转换 到 text 。 





Table 9-5. SQL 字符 串 函 数 和 操作 符 


Bae 
string &#124;&#124; string 
string &#124;&#124; non-string 或 non-string 
&#124;&#124; String 


— 


“bit length( string 


char_length(```string`) 或 character_length( ``string ) 


`lower(```string ) 


~octet_length( string ) 
`overlay(```string placing string from int [for int ]) 
`position(```substring in string ) 


`substring(```string [from int ] [for int ]) 


substring °° string from _pattern_ ) 


substring °° string from _pattern for escape ) 





~“trim( [leading &#124; trailing &#124; both] I characters | 
from string ) 


‘upper( string ) 


返回 
text 
text 
int 
int 


text 


int 
text 
int 


text 


text 


text 


text 


text 


描 ; 


Es 


字符 串 连接 


带 有 一 个 非 字 
符 串 输入 的 字 
符 串 连接 


字符 串 的 位 


字符 串 中 的 字 
符 个 数 


把 字符 串 转化 
为 小 写 


字符 串 中 的 字 
节 数 


蔡 换 子 字符 串 


指定 子 字符 串 
的 位 置 


截取 子 字符 串 


截取 匹配 
POSIX 正 则 表 
达 式 的 子 字符 
串 。 参 

阅 Section 9.7 
获取 更 多 关于 
AEREE 


截取 匹配 SQL 
正则 表达 式 的 
子 字符 串 。 参 
# Section 9.7 
获取 更 多 关于 
匹配 的 信 


从 字符 
Ea string 的 
开头 /结尾 /两 
边 删 除 只 包含 
characters 中 
字符 ( 缺 省 是 
空白 ) 的 最 长 的 
字符 串 


把 字符 串 转化 
JKE 


还 有 额外 的 字符 串 操 作画 数 可 以 用 ， 它 们 在 Table 9-6 列 出 。 它们 有 些 在 内 部 用 于 实现 Table 
9-5 列 出 的 SQL 标 准 字符 串 男 数 。 


Table 9-6. HE FERKA 


EEs 返回 类 型 描述 


参数 中 第 一 个 字符 的 
ASCII 编 码 值 。 对 于 
UTF8 返 回 字符 的 宽 字 节 
编码 值 。 对 于 其 它 的 多 
字 节 编码 ， 参 数 必 须 是 
一 个 ASCII 字 符 。 


从 string 开头 和 结尾 

删除 只 包含 
text characters 中 字符 ( 缺 btrim， 
characters text ]) 省 是 空白 ) 的 最 长 字符 


串 。 


给 定编 码 的 字符 。 对 于 
UTF8 这 个 参数 作为 宽 字 
节 代 码 义理 。 对 于 其 它 
的 多 字 节 编码 ， 这 个 参 
eh (ey) text 数 必须 指定 一 个 ASCII chr (6! 
字符 ， 因为 text 数 据 类 
型 无 法 存储 NULL 数 据 字 
节 ， 不 能 将 NULL(0) 作 


连接 所 有 参数 的 文本 表 


text 示 。 NULL 参数 被 忽 concal 
Many ales) BR. 


ascii string ) int ascii! 


berim( string text [, 


rconcal( Seany È Stii 


连接 所 有 参数 ， 但 是 第 
concatews( sepi ltexth, str TERE 一 个 参数 是 分 隅 符 ， 用 


| cre Pan |, ...] }) 于 将 所 有 参数 分 隔 。 
NULL 参数 被 忽略 。 


把 原来 编码 

为 src_encoding 的 字符 

串 转 换 为 

dest_encoding 编码 。 
Convert( string bytea , 在 这 种 编码 格式 
src_encoding name , bytea 中 string 必须 是 有 效 OMe 
dest_encoding name ) 的 。 

用 CREATE CONVERSION 定 

义 转换 。 这 也 有 些 预 定 

义 的 转换 。 参阅 Table 

9-7 显 示 可 用 的 转换 。 


把 原来 编码 
为 src_encoding 的 字符 
`convert_from(```string bytea , 串 转换 为 数据 库 编 码 格 


text convel 


concal 


src_encoding name ) 


convert to( string text 
dest_encoding name ) 


“decode( string text 
format text ) 


iencode( data bytea , format 


text ) 


format`( formatstr `text [, 
formatarg "any" [, ...] ]) 


~initcap( ~~ string ) 


ena este) (exe, mM ma) 


length ~ string ) 


length “string  bytea , 
encoding name ) 


pad string text slengéh 
int |, fill text l) 


bytea 


bytea 


text 


text 


text 


text 


int 


int 


text 


式 。 这 种 编码 格式 
中 ， string 必须 是 有 
效 的 。 


将 字符 串 转 化 
为 dest_encoding 编码 


格式 。 


把 用 string 表示 的 文 
本 里 面 的 二 进 制 数 据 解 
码 。 format 选项 


和 encode 相同 。 


把 二 进 制 数据 编码 为 文 

本 表示 。 支 持 的 格式 

有 : base64 , hex 
escape o escape 转换 

雳 字 节 和 高 位 设置 字 节 
为 八进制 序列 

(3 anne ) 和 双 反 和 斜 

杠 。 


根据 格式 字符 串 格 式 参 
数 。 这 个 男 数 类 似 C 函 
数 sprintf o 参 
J Section 9.4.1。 


把 每 个 单词 的 第 一 个 字 
母 转 为 大 写 ， 其 它 的 保 
ANS, 单词 是 一 系列 
字母 数字 组 成 的 字符 ， 
用 非 字母 数字 分 隔 。 


返回 字符 串 的 前 n 个 
字符 。 当 n 是 负数 
时 ， 返回 除 最 后 | n | 
个 字符 以 外 的 所 有 字 
符 。 


string 中 字符 的 数 A 


指定 encoding 编码 格式 
的 String 的 字符 数 。 

在 这 个 编码 格式 

中 ， string 必须 是 有 
效 的 。 


通过 填充 字符 fill (mR 
省 时 为 空白 )， 

把 String 填充 

为 length KE. 如 
果 string 已 经 

tk length 长 则 将 其 尾 
部 截断 。 


从 字符 串 string BY FF 


convel 


decode 


encode 


formal 


INTEG: 


left( 


lengtl 


lengtl 


lpad( 


EMO strange Gren |, 


characters text ]) 


`md5(```string ) 


pg_client_encoding() 


‘quotenrdenkC Se ing 


quote literal( string 


quote literal( value 
anyelement ) 


text ) 


text ) 


`quote_nullable(```string 


text ) 


`quote_nullable( ~ value 
anyelement ) 


text 


text 


name 


text 


text 


text 


text 


text 


头 删 除 只 包 
2 characters 中 字符 
( 缺 省 是 一 个 空白 ) 的 最 
长 的 字符 串 。 


计算 string 的 MD5 散 
列 ， 以 十 六 进 制 返回 结 
果 。 


当前 客户 端 编码 名 称 


返回 适用 于 SQL 语句 的 
标识 符 形式 (使 用 适当 的 
引号 进行 界定 )。 只 有 
在 必要 的 时 候 才 会 添加 
引号 (字符 串 包 含 非 标识 
符 字符 或 者 会 转换 大 小 
写 的 字符 )。 ARISI 
号 被 恰当 地 写 了 双 份 。 
又 见 Example 40-1。 


返回 适用 于 在 SQL 语句 
里 当 作 文本 使 用 的 形式 
(使 用 适当 的 引号 进行 界 
E) PRAM SIS AR 
斜 杠 被 恰当 地 写 了 双 
份 。 请 注意 ， 当 输入 是 
null 时 ， 

quote_literal 返回 
null ; 如 果 参 数 可 能 六 
null， 通 

常 quote_nullable 更 适 
用 。 又 见 Example 40- 
1. 


将 给 定 的 值 强制 转换 为 
text， 加 上 引号 作为 文 
A, RANSISARE 
杠 被 恰当 地 写 了 双 份 。 


返回 适用 于 在 SQL 语句 
里 当 作 字 符 串 使 用 的 形 
式 (使 用 适当 的 引号 进行 
界定 )。 或 者 ， 如 果 参 
数 为 空 ， 返 回 NULL o 
和 入 的 引号 和 反 斜 杠 被 
恰当 地 写 了 双 份 。 又 见 
Example 40-1。 


将 给 定 的 参数 值 转化 为 
text， 加 上 引号 作为 文 
A; 或 者 ， 如 果 参 数 为 
空 ， 返回 NuLL o PRA 
的 引号 和 反 斜 杠 被 恰当 
EE T NRD- 


enam) 


md5('% 


poEci: 


quote. 


quote. 


quote. 


quote. 


quote. 


返回 string 中 所 有 匹 


‘regexp_matches( string 配 POSIX 正 则 表达 式 的 
text , pattern text [, flags setof text[] 子 字符 串 。 E regex| 
text ]) i Section 9.7.3 获 得 更 

多 信息 。 
"regexp_replace(` string 替换 匹配 POSIX 正则 
text , pattern text , 表达 式 的 子 字符 串 。 参 

text : regex] 

replacement text [, flags W Section 9.7.3 以 获取 
text ]) 更 多 模式 匹配 的 信息 。 

用 POSIX 正 则 表达 式 作 
regexp split to array( ~~ string Hoa hae, 分 
text , pattern text [, flags text[] IA strings 参 regex| 
text ]) J Section 9.7.3 以 获取 

更 多 模式 匹配 的 信息 。 

用 POSIX 正 则 表达 式 作 
`regexp_split_to_table(```string 为 分 隔 符 ， 分 
text , pattern text [, flags setof text IA string 。 & regex| 
text ]) iJ Section 9.7.3 以 获取 

更 多 模式 匹配 的 信息 。 

world 
(2 rows) | | 


repeat(```stringò “text>, `number`ò `int`) | “text> | # string 28 number 次 | ~repeat('Pg' 
replace( string’ “text’, `from “text>, `to` `text`) | ‘text’ | #224 string BHaihmats 
str ) | text | 返回 颠倒 的 字符 串 | reverse(‘abcde') | edcba | | ~*right(***str text, n 

int )| text | 返回 字符 串 中 的 后 _n_ 个 字符 。 当 n 是 负 值 时 ， 返回 除 前 | _n_ | 个 字符 以 
外 的 所 有 字符 。 | rignt('abcde', 2) | de || 


rpad(```stringò “text>, “length’ `int`ò [, `fill` `text`]) | “text> | (BARR Fill: (Ar 








rtrim( string’ “text> [, `characters` `text`]) | “text> | 从 字符 串 `string ` 的 结尾 删除 只 包含 “char 
string “text , delimiter text , field int )| text | 根据 delimiter DIA string 返回 生 
成 的 第 field 个 子 字符 串 (1 为 基 )。 | split_part('abc~@~def~@~ghi', '~@~', 2) | def || 
strpos(```stringò, “substring’) | ‘int’ | 指定 的 子 字符 串 的 位 置 。 和 `position( substring in stri 
ng ) 一 样 ， 不 过 参数 顺序 相反 。 | strpos('high', 'ig') | 2 | | ``substr(* string , from [, count ]) 
| text | 抽取 子 字符 串 。 和 substring(**string from from for count )) 一 样 | 


substr('alphabet', 3, 2) | ph || 
to_ascii(```stringò “text> [, ~encoding> ~text>]) | “text> | 把 `string 从 其 它 编码 转换 为 ASCII 


to_hex( number* `int`ò or “bigint’) | “text> | 把 `number 转换 成 十 六 进 制 表现 形式 | `to_hex(214748 
string ‘text , from text, to text )| text | 把 在 string 中 包含 的 任何 匹配 from PH 
符 的 字符 转化 为 对 应 的 在 to 中 的 字符 。 如 果 from 比 to 长 ， 删 掉 在 fron 中 出 现 的 额外 的 


字符 。 | translate('12345', '143', 'ax') | a2x5 | 


concat , concat_ws 和 format 图 数 是 可 变 的 ， 所 以 用 vARIADIC 关键 字 标 记 传 递 的 数值 以 连 
接 或 者 格式 化 为 一 个 数组 是 可 能 的 。 见 Section 35.4.5。 数 组 的 元 素 对 函数 来 说 是 单独 的 普通 
BR, 如 果 可 变数 组 的 元 素 是 NULL， 那 么 concat 和 concat_ws 返回 NULL， 但 是 format 把 


NULL 作 为 雳 元 素数 组 对 待 。 


又 见 Section 9.20 里 面 的 聚集 函数 string agg o 


Table 9-7. 内 置 的 转换 


转换 名 [a] 


ascii_to_mic 
ascii_to_utf8 
big5_to_euc_tw 
big5_to_mic 
big5_to_utf8 
euc_cn_to_mic 
euc_cn_to_utf8 
euc_jp_to_mic 
euc_jp_to_sjis 
euc_jp_to_utf8 
euc_kr_to_mic 
euc_kr_to_utf8 
euc_tw_to_big5 
euc_tw_to_mic 
euc_tw_to_utf8 
gb18030_to_utf8 
gbk_to_utf8 
iso_8859 10 to_utf8 
iso_8859 13 _to_utf8 
iso_8859 14 to_utf8 
iso_8859 15 to_utf8 
iso_8859 16 _to_utf8 
iso_8859 1 to_mic 
iso_8859 1 to_utf8 
iso_8859 2 to_mic 


iso_8859_2 to_utf8 


iso 8859 2 to_windows_1250 


iso_8859 3 to _ mic 
iso_8859 3 to_utf8 
iso_8859_ 4 to_mic 
iso_8859 4 to_utf8 


iso_8859_5 to_koi8_r 





源 编 码 
SQL_ASCII 
SQL_ASCII 
BIG5 
BIGS 
BIGS 
EUC_CN 
EUC_CN 
EUC_JP 
EUC_JP 
EUC_JP 
EUC_KR 
EUC_KR 
EUC_TW 
EUC_TW 
EUC_TW 
GB18030 
GBK 
LATING 
LATIN7 
LATIN8 
LATIN9 
LATIN10 
LATIN1 
LATIN1 
LATIN2 
LATIN2 
LATIN2 
LATIN3 
LATIN3 
LATIN4 
LATIN4 


IS0_8859_5 


目的 编码 

MULE_INTERNAL 
UTF8 

EUC_TW 
MULE_INTERNAL 
UTF8 
MULE_INTERNAL 
UTF8 
MULE_INTERNAL 
SJIS 

UTF8 
MULE_INTERNAL 
UTF8 

BIGS 
MULE_INTERNAL 
UTF8 

UTF8 

UTF8 

UTF8 

UTF8 

UTF8 

UTF8 

UTF8 
MULE_INTERNAL 
UTF8 
MULE_INTERNAL 
UTF8 

WIN1250 
MULE_INTERNAL 
UTF8 
MULE_INTERNAL 
UTF8 


KOI8R 


iso_8859_5 to mic 


iso_8859_5 to_utf8 


iso_8859_5 to_windows_1251 


iso_8859_5 to_windows_866 


iso_8859 6 _to_utf8 
iso_8859_7_to_utf8 
iso_8859 8 to_utf8 
iso_8859 9 to_utf8 
johab_to_utf8 


koi8_r_to_iso_8859_5 





koi8_r_to_mic 
koi8_r_to_utf8 
koi8_r_to_windows_1251 
koi8_r_to_windows_866 
koi8_u_to_utf8 
mic_to_ascii 
mic_to_big5 
mic_to_euc_cn 
mic_to_euc_jp 
mic_to_euc_kr 
mic_to_euc_tw 
mic_to_iso_8859 1 
mic_to_iso_8859 2 
mic_to_iso_8859 3 
mic_to_iso_8859 4 
mic_to_iso_8859 5 
mic_to_koi8_r 
mic_to_sjis 
mic_to_windows_1250 
mic_to_windows_1251 
mic_to_windows_866 
$jis_to_euc_jp 
sjis_to_mic 
sjis_to_utf8 
tcvn_to_utf8 
uhc_to_utf8 


utf8_to_ascii 


ISO_8859_5 
ISO_8859_5 
ISO_8859_5 
ISO_8859_5 
ISO_8859_6 
ISO_8859_7 
ISO_8859_8 
LATINS 

JOHAB 

KOI8R 

KOI8R 

KOI8R 

KOI8R 

KOI8R 

KOI8U 
MULE_INTERNAL 
MULE_INTERNAL 
MULE_INTERNAL 
MULE_INTERNAL 
MULE_INTERNAL 
MULE_INTERNAL 
MULE_INTERNAL 
MULE_INTERNAL 
MULE_INTERNAL 
MULE_INTERNAL 
MULE_INTERNAL 
MULE_INTERNAL 
MULE_INTERNAL 
MULE_INTERNAL 
MULE_INTERNAL 
MULE_INTERNAL 
SJIS 

SJIS 

SJIS 

WIN1258 

UHC 


UTF8 


MULE_INTERNAL 
UTF8 
WIN1251 
WIN866 
UTF8 

UTF8 

UTF8 

UTF8 

UTF8 
ISO_8859_ 5 
MULE_INTERNAL 
UTF8 
WIN1251 
WIN866 
UTF8 
SQL_ASCII 
BIG5 
EUC_CN 
EUC_ JP 
EUC_KR 
EUC_TW 
LATIN1 
LATIN2 
LATIN3 
LATIN4 
ISO0_8859_5 
KOI8R 

SJIS 
WIN1250 
WIN1251 
WIN866 
EUC_JP 
MULE_INTERNAL 
UTF8 

UTF8 

UTF8 


SQL_ASCITI 


utf8_to_big5 
utf8_to_euc_cn 
utf8_to_euc_jip 
utf8_to_euc_kr 
utf8_to_euc_tw 
utf8_to_gb18030 
utf8_to_gbk 
utf8_to_iso_8859 1 
utf8_to_iso_8859 10 
utf8_to_iso_8859 13 
utf8_to_iso_8859 14 
utf8_to_iso_8859 15 
utf8_to_iso_8859 16 
utf8_to_iso_8859 2 
utf8_to_iso_8859 3 
utf8_to_iso_8859 4 
utf8_to_iso_8859_ 5 
utf8_to_iso_8859 6 
utf8_to_iso_8859_7 
utf8_to_iso_8859 8 
utf8_to_iso_8859_ 9 
utf8_to_johab 
utf8_to_koi8_r 
utf8_to_koi8_u 
utf8_to_sjis 
utf8_to_tcvn 
utf8_to_uhc 
utf8_to_windows_1250 
utf8_to_windows_1251 
utf8_to_windows_1252 
utf8_to_windows_1253 
utf8_to_windows_1254 
utf8_to_windows_1255 
utf8_to_windows_1256 
utf8_to_windows_1257 
utf8_to_windows_866 


utf8_to_windows_874 


UTF8 


UTF8 


UTF8 


UTF8 


UTF8 


UTF8 


UTF8 


UTF8 


UTF8 


UTF8 


UTF8 


UTF8 


UTF8 


UTF8 


UTF8 


UTF8 


UTF8 


UTF8 


UTF8 


UTF8 


UTF8 


UTF8 


UTF8 


UTF8 


UTF8 


UTF8 


UTF8 


UTF8 


UTF8 


UTF8 


UTF8 


UTF8 


UTF8 


UTF8 


UTF8 


UTF8 


UTF8 


BIGS 
EUC_CN 
EUC_JP 
EUC_KR 
EUC_TW 
GB18030 
GBK 

LATIN1 
LATING 
LATIN7 
LATIN8 
LATIN9 
LATIN10 
LATIN2 
LATIN3 
LATIN4 
ISO_8859_5 
ISO_8859_6 
ISO_8859_7 
ISO_8859_8 
LATINS 
JOHAB 
KOI8R 
KOI8U 

SJIS 
WIN1258 
UHC 
WIN1250 
WIN1251 
WIN1252 
WIN1253 
WIN1254 
WIN1255 
WIN1256 
WIN1257 
WIN866 


WIN874 


windows_1250_to_iso_8859_2 WIN1250 LATIN2 




















windows_1250_to_mic WIN1250 MULE_INTERNAL 
windows_1250_to_utf8 WIN1250 UTF8 
windows_1251_to_iso_8859_5 WIN1251 ISO_8859_ 5 
windows_1251_to_koi8_r WIN1251 KOI8R 
windows_1251_to_mic WIN1251 MULE_INTERNAL 
windows_1251_to_utf8 WIN1251 UTF8 
windows_1251_to_windows_866 WIN1251 WIN866 
windows_1252_to_utf8 WIN1252 UTF8 
windows_1256_to_utf8 WIN1256 UTF8 
windows_866_to_iso_8859_5 WIN866 ISO_8859_5 
windows_866_to_koi8_r WIN866 KOI8R 
windows_866_to_mic WIN866 MULE_INTERNAL 
windows_866_to_utf8 WIN866 UTF8 
windows_866_to_windows_1251 WIN866 WIN 
windows_874_to_utf8 WIN874 UTF8 
euc_jis_2004_to_utf8 EUC_JIS_2004 UTF8 
utf8_to_euc_jis_ 2004 UTF8 EUC_JIS_2004 
shift_jis_2004_to_utf8 SHIFT_JIS_2004 UTF8 
utf8_to_shift_jis_2004 UTF8 SHIFT_JIS_2004 
euc_jis_2004_to_shift_jis_2004 EUC_JIS_2004 SHIFT_JIS_2004 
shift_jis_2004_to_euc_jis_2004 SHIFT_JIS_2004 EUC_JIS_2004 





Notes: a. 转换 名 遵循 一 个 标准 的 命名 模式 : 将 源 
编码 中 的 所 有 非 字 母 数字 字符 用 下 划 线 替换 ， 后 
面 跟着 _to ， 然 后 后 面 再 跟着 经 过 相似 处 理 的 
目标 编码 的 名 字 。 因此 这 些 名 字 可 能 和 客户 的 编 
码 名 字 不 同 。 


9.4.1. 格式 化 
ERX format 生成 根据 格式 字符 串 格 式 化 了 的 输出 ， PURE EMAC EH RK sprintf o 


format(formatstr text [, formatarg "any" [, ...] ]) 


_formatstr_ 是 指定 结果 如 何 格式 化 的 格式 字符 串 。 格 式 字 符 串 中 的 文本 直接 拷贝 到 结果 中 ， 
除非 已 经 使 用 了 格式 说 明 符 。 格 式 说 明 符 在 字符 串 中 作为 占 位 符 使 用 ， 定义 后 续 函 数 参 数 应 
该 格式 化 并 且 插 入 到 结果 中 。 每 个 _formatarg ”参数 根据 这 种 数据 类 型 的 通常 输出 规则 转化 
为 文本 ， 然 后 根据 格式 说 明 符 格式 化 并 且 插入 到 结果 中 。 


格式 说 明 符 由 % 字符 引进 ， 格 式 为 


%[_position_][_flags_][_width_]_type 





组 件 的 字段 有 : 
_position (optional) 


n $ 格 式 的 字符 串 ， 这 里 的 n 是 要 打印 的 参数 的 索引 。 索 引 为 1 表示 在 _formatstr ”之 
后 的 第 一 个 参数 。 如 果 省 略 了 _formatstr ， 默认 使 用 序列 中 的 下 一 个 参数 。 


_flags_ (optional) 


附加 选项 ， 控 制 如 何 格式 化 格式 说 明 符 的 输出 。 当 前 只 支持 负 号 ( - )， 负 号 导致 格式 说 明 符 
的 输出 是 左 对 齐 的 。 这 是 没有 影响 的 ， 除 非 指定 了 width 字段。 


_width_ (optional) 


声明 字符 数 的 minimum 值 用 来 显示 格式 说 明 符 的 输出 。 需 要 补充 宽度 时 ， 空白 添加 到 输出 的 
左 侧 或 右 侧 (取决 于 - 标志 ) 。 一 个 比较 小 的 宽度 不 会 导致 输出 的 截断 ， 只 是 简单 的 忽略 
T. 宽度 可 以 用 下 列 方法 指定 : 一 个 正 整数 ; 一 个 星 号 ( * ) 表示 使 用 下 一 个 函数 参数 作为 宽 
E; 或 一 个 格式 为 **…、n $S 的 字符 串 表 示 使 用 第 n 个 函数 参数 作为 宽度 。 


如 果 宽 度 来 自 范 数 参 数 ， 那 么 这 个 参数 在 作为 格式 说 明 符 的 数值 之 前 消耗 掉 。 如 果 宽 度 参 数 
是 负 的 ， 那 么 结果 是 左 对 齐 的 (就 像 声 明了 - 标志 一 样 ) ， 并 且 字 段 长 度 
A abs ( _width_ )。 


_type_ (required) 
格式 转换 的 类 型 用 来 产生 格式 说 明 符 的 和 输出。 支持 下 列 的 类 型 : 
。 s 格式 参数 值 为 简单 的 字符 串 。 空 值 作为 空 字符 串 对 待 。 
。 1 将 参数 值 作 为 SQL 标识 符 对 待 ， 如 果 需 要 ， 双 写 它 。 值 为 空 是 错误 的 。 
。 L 引用 参数 值 作为 SQL 文 字 。 空 值 用 字符 串 we 显示 ， 没 有 引用 。 
除了 上 述 的 格式 说 明 符 ， 特 殊 的 序列 xx 可 以 用 作 输 出 % 字符 。 
这 里 有 一 些 基 本 的 格式 转换 的 例子 : 


SELECT format('Hello %s', 'World'); 
_Result:_ <samp class="literal">Hello World</samp> 


SELECT format('Testing %s, %s, %S, %%', 'one', 'two', 'three'); 
_Result:_ <samp class="literal">Testing one, two, three, %</samp> 


SELECT format('INSERT INTO %I VALUES(%L)', 'Foo bar', E'O\'Reilly'); 
_Result:_ <samp class="literal">INSERT INTO "Foo bar" VALUES('0''Reilly' )</samp> 


SELECT format('INSERT INTO %I VALUES(%L)', '‘locations', E'C:\\Program Files'); 
_Result:_ <samp class="literal">INSERT INTO locations VALUES(E'C:\\Program Files')</samp> 


‘ 一 一 


这 里 是 使 用 width, 字段 和 - 标志 的 例子 : 





SELECT format('|%10s|', 'foo'); 
_Result:_ <samp class="literal">| foo|</samp> 


SELECT format('|%-10s|', 'foo'); 
_Result:_ <samp class="literal">|foo |</samp> 


SELECT format('|%*s|', 10, 'foo'); 
_Result:_ <samp class="literal">| foo|</samp> 


SELECT format('|%*s|', -10, 'foo'); 
_Result:_ <samp class="literal">|foo |</samp> 


SELECT format('|%-*s|', 10, 'foo'); 
_Result:_ <samp class="literal">|foo | </samp> 


SELECT format('|%-*s|', -10, 'foo'); 
_Result:_ <samp class="literal">|foo | </samp> 


下 面 是 使 用 _position_ 字段 的 例子 


SELECT format('Testing %3$s, %2$s, %1$s', 'one', 'two', 'three'); 
_Result:_ <samp class="literal">Testing three, two, one</samp> 


SELECT format('|%*2$s|', 'foo', 10, 'bar'); 
_Result:_ <samp class="literal">| bar |</samp> 


SELECT format('|%1$*2$s|', 'foo', 10, 'bar'); 
_Result:_ <samp class="literal">| foo|</samp> 


FUCENX sprintf 不 同 ，PostgreSQL 的 format WAH PARMA HA _position 字段 的 格 
式 说 明 符 在 相同 的 格式 字符 串 中 混合 使 用 。 没有 position 字段 的 格式 说 明 符 总 是 使 用 最 后 
消耗 参数 的 下 一 个 参数 。 另外 ， format 画 数 不 要求 在 格式 字符 串 中 使 用 所 有 画 数 参 数 。 例 
如 : 


SELECT format('Testing %3$s, %2$s, %S', 'one', 'two', 'three'); 
_Result:_ <samp class="literal">Testing three, two, three</samp> 


%I 和 %L 格式 说 明 符 对 于 安全 构造 动态 SQL 语句 尤其 有 用 。 参阅 Example 40-1, 


9.5. — it ll FIF BSA ERE 


本 节 描 述 那些 检查 和 操作 类 型 为 bytea 数值 的 西数 和 操作 符 。 


SQL 定义 了 一 些 字 符 串 函 数 ， 在 这 些 函 数 里 使 用 关键 字 而 不 是 去 号 来 分 隅 参数 。 详情 请 见 
Table 9-8。 PostgreSQL 也 提供 了 使 用 常用 语法 进行 函数 调用 的 函数 的 版 本 (参阅 Table 9-9)。 


Note: 本 页 面 例子 的 结果 在 假设 服务 器 的 参数 pytea_output 设置 为 escape 的 基础 上 的 
(传统 的 PostgreSQL 格 式 ) 。 


Table 9-8. SQL 二 进 制 字 符 串 函数 和 操作 符 


a 返回 类 p 

string &#124;&#124; string bytea FPA E'\\\\Post'::bytea &#124 
mee 

“octet_length(***string ) int 串 中 的 字 octet_length(E'jo\\o00se 
数 

‘overlay( string placing bytea 替换 子 串 overlay(E'Th\\000omas': : 

string from int [for int ]) 

、 cre 、、、 。 H cho [一 一 

position( substring IN ant 特定 子 字符 position(E'\\o00om': :byt 


string ) 串 的 位 置 


`substring(```string [from 


bytea ANTS substring(E'Th\\@0Gomas' 
int ] [for int ]) 


从 string 的 
开头 和 结尾 
删除 只 包含 
bytes 中 字 
节 的 最 长 字 
符 串 


trim([both]. bytes from string’) bytea trim(E'\\000'::bytea fro 


RAHI BRISA RAL, Table 9-9 列 出 。 其 中 有 一 些 是 在 内 部 使 用 ， 用 
于 实现 Table 9-8 列 出 的 SQL 标 准 的 字符 串 函 数 。 


Table 9-9. 其 它 二 进 制 字 符 串 函数 


x 返回 类 ve 
ERK 型 描述 例子 
~btrim(*>>>string A a > 
1 
bytea , bytes bytea Alza = h] ae btrim(E'\\000trim\\000'::bytea 
bytea ) 号 bytes Pr P 
的 最 关 的 字符 串 
把 String 中 的 文 
~decode(** string 本 表示 解码 为 二 进 
text , format bytea 制 数据 。 format decode(E'123\\000456', 'escape 
text ) 的 选项 
和 encode 相同 。 
把 二 进 制 数据 编码 
为 文本 表现 形式 。 
支持 的 格 
“encode( data 式 
bytea , format text nes i encode(E'123\\000456': :bytea, 
TAE ) escape o escape 
转换 需 字 节 和 高 位 
设置 字 节 为 八进制 
序列 ( Sn ) 
AMS REAL. 
Mee bre ST int 从 字符 串 中 抽取 位 get_bit(E'Th\\00Gomas': :bytea, 
offset ) 
、 Ss z ra ra 
get_byte( Suan int 从 字符 串 中 抽取 字 get_byte(E'Th\\000omas': :bytea 
offset ) P 
ZAAR JK 
`length(```string ) int 二 进 制 字符 串 的 长 length(E'jo\\000se': :bytea) 
度 
计算 string 的 
it, | s 
Td siring ) text MD5 散 列 值 以 十 md5(E'Th\\000omas': : bytea) 
六 进 制 方式 返回 结 
果 。 
SE strane i bytea 设置 字符 串 中 的 位 set_bit(E'Th\\00Gomas': :bytea, 
offset , newvalue ) 
E SS yt 人 ro 
set_byte( Seran g bytea 设置 字符 串 中 的 字 set_byte(E'Th\\000omas'::bytea 
offset , newvalue ) P 


get_byte 和 set_byte 数 以 二 进 制 字符 串 的 第 一 个 字 节 为 0 字 节 。 get bit 和 set_bit 从 每 个 
字 节 的 右边 取 位 ; 例如 位 0 是 第 一 个 字 节 的 最 低位 ， 位 15 是 第 二 个 字 节 的 最 高 位 。 


又 见 Section 9.20 中 的 聚集 本 数 string_agg o 


9.6. {2B ESN RE FT 


本 节 描 述 用 于 检查 和 操作 位 串 的 函数 和 操作 符 ， 也 就 是 操作 类 型 为 bit 和 bit varying 值 的 
函数 和 操作 符 。 除 了 常用 的 比较 操作 符 之 外 ， 还 可 以 使 用 Table 9-10 里 显示 的 操作 符 。 & ， 
| ,# 的 位 串 操 作 数 必须 等 长 。 在 移 位 的 时 候 ， 保 留 原 始 的 位 串 长 度 ( 并 以 0 填充 )， 如 例子 
所 示 。 


Table 9-10. 位 串 操作 符 


操作 符 描述 例子 结果 
&#124;&#124; 连接 B'10001' &#124;&#124; B'011' 10001011 
& 位 与 B'10001' & B'01101' 00001 
&#124;} 位 或 B'10001' &#124; B'01101' 11101 
# TRE B'10001' # B'01101' 11100 
~ 位 非 ~ B'10001' 01110 
&lt;alt; 位 左 移 B'10001' &lt;&lt; 3 01000 
&gt;&gt; 位 右 移 B'10001' &gt;&gt; 2 00100 


FARSAL ERR ST OA FSR BH, tai: length, bit_length , 


octet_length , position , substring , overlay 。 


下 面 的 函数 用 于 位 串 和 二 进 制 字符 串 : get_bit, set_bit 。 当 用 于 位 串 时 ， wea 
从 字符 串 的 第 一 位 (GRAM) 作为 0 位 。 


另外 ， 我 们 可 以 在 整数 和 bit 之 间 来 回转 换 。 例 子 : 


44: :bit(10) _0000101100_ 
44: :bit(3) _100_ 

cast(-44 as bit(12)) _111111010100_ 
'1110'::bit(4)::integer ean 


请 注意 ， 只 是 转换 为 "bit" 的 意思 是 转换 成 bit(1) ， 因此 只 会 转换 成 整数 的 最 低位 。 


Note: 在 PostgreSQL 8.0 以 前 ， 把 一 个 整数 转换 成 bit(n) 将 拷贝 整数 的 最 左边 
的 n 位 ， 而 现在 是 拷贝 最 右边 的 n 位 。 还 有 ， 把 一 个 整数 转换 成 比 整数 本 身长 的 位 
串 ， 就 会 扩展 最 左边 的 位 ( 非 负 数 为 0 ， 负 数 为 1)。 


9.7. 模式 匹配 


PostgreSQL 提 供 了 三 种 实现 模式 匹配 的 方法 : 传统 SQL 的 LIKE 操作 符 、SQL99 新 增 的 
SIMILAR TO 操作 符 、POSIX 风 格 的 正则 表达 式 。 除了 基本 的 "这 个 字符 串 匹 配 这 个 模式 "操作 
符 之 外 ， 也 可 以 使 用 函数 抽取 或 蔡 换 匹配 的 子 字符 串 并 且 在 匹配 的 位 置 分 隔 字符 串 。 





Tip: 如 果 你 的 模式 匹配 要 求 比 这 些 还 多 ， 请 考虑 用 Perl 或 Tcl 写 一 个 用 户 定义 函数 。 


9.7.1. LIKE 


string_ LIKE _pattern_ [ESCAPE ~_escape-character_~] 
_string_ NOT LIKE _pattern_ [ESCAPE ~_escape-character_~] 





如 果 该 _string_ 匹配 提供 的 _pattern ， 那么 LIKE 表达 式 返 回 真 。 和 我 们 想像 的 一 样 ， 如 
R Like 返回 真 ， 那 么 not LIKE 表达 式 将 返回 假 ， 反 之 亦 然 。 一 个 等 效 的 表达 式 


是 NOT (``_string LIKE _pattern_ )。 
如 果 pattern. 不 包含 百 分 号 或 者 下 划 线 ， 那 么 该 模式 只 代表 它 本 身 ; 这 时 候 LIKE 的 行为 就 


像 等 号 操作 符 。 在 _pattern ”里 的 下 划 线 ( _ ) 匹 配 任何 单个 字符 ; 而 一 个 百 分 号 ( % ) LAS 
或 多 个 任何 序列 。 





一 些 例子 : 
'abc' LIKE 'abc' _true_ 
"abc' LIKE 'a%' _true_ 
"abc' LIKE '_b_' true 
"abc' LIKE 'c' _false_ 


LIKE 模式 匹配 总 是 覆盖 整个 字符 串 。 因 此 ， 如 果 想 要 匹配 在 字符 串 内 部 任何 位 置 的 序列 ， 
该 模式 必须 以 百 分 号 开头 和 结尾 。 


要 匹配 下 划 线 或 者 百 分 号 本 身 ， 在 _pattern ”里 相应 的 字符 必须 前 导 逃 逸 字符 。 缺 省 的 逃逸 
字符 是 反 斜 枉 ， 但 是 你 可 以 用 esae 子 句 指定 一 个 。 要 匹配 逃逸 字符 本 身 ， 写 两 个 逃逸 字 
符 。 


Note: 如 果 你 关闭 了 standard_conforming _strings 选 项 ， 那么 在 文本 字符 串 常量 里 的 任 
意 反 斜 杠 都 需要 双 写 。 参阅 Section 4.1.2.1 获 取 更 多 信息 








我 们 也 可 以 通过 写成 escape '' 的 方式 关闭 逃逸 机 制 ， 这 时 ， 我 们 就 不 能 关闭 下 划 线 和 百 分 
号 的 特殊 含义 。 


关键 字 mme 可 以 用 于 替换 LIKE ， 兮 该 匹配 就 当前 的 区 域 设置 是 大 小 写 无 关 的 。 这 个 特性 
不 是 SQL 标准 ， 是 PostgreSQL 扩 展 。 


操作 符 ~~ 等 效 于 LIkE ， 而 ~~* SRF ILIKE 。 还 有 !-- 和 !--* 操作 符 分 别 代 
表 NoT LIKE 和 NoT ILIKE 。 所 有 这 些 操作 符 都 是 PostgreSQL 特 有 的 。 


9.7.2. SIMILAR TO 正则 表达 式 


_string_ SIMILAR TO _pattern_ [ESCAPE ~_escape-character_~] 
_string_ NOT SIMILAR TO _pattern_ [ESCAPE ~_escape-character_~] 


SIMILAR TO 根据 自己 的 模式 是 否 匹 配给 定 字符 串 而 返回 真 或 者 假 。 它 和 LIKE 非常 类 似 ， 只 
不 过 它 使 用 SQL 标准 定义 的 正则 表达 式 理解 模式 。 SQL 标准 的 正则 表达 式 是 在 LIKE 表示 
法 和 普通 的 正则 表达 式 表 示 法 之 间 古 怪 的 交叉 。 


类 似 LIKE, SIMILAR TO 操作 符 只 有 在 它 的 模式 匹配 整个 字符 串 的 时 候 才 能 成 功 ;这 一 点 和 
普通 的 正则 表达 式 的 行为 不 同 ， 在 普通 的 正则 表达 式 里 ， 模式 匹配 字符 串 的 任意 部 分 。 

和 Like 类 似 的 地 方 还 有 smar To 使 用 _ 和 % 分 别 匹 配 单个 字符 和 任意 字符 串 ( 这 些 和 
POSIX 正则 表达 式 里 的 Al .* HA) 


除了 这 些 从 Like 借用 的 功能 之 外 ， sIMILAR To 支持 下 面 这 些 从 POSIX 正则 表达 式 借用 的 
模式 匹配 元 字符 : 


。 | 表示 选择 (两 个 候选 之 一 ) 
。 “* 表示 重复 前 面 的 项 需 次 或 更 多 次 
。 + 表示 重复 前 面 的 项 一 次 或 更 多 次 
e ? 表示 重复 前 面 的 项 需 次 或 一 次 
e iOm 表示 重复 前 面 的 项 正好 m 次 
e iOm 表示 重复 前 面 的 项 m 或 更 多 次 
e (mo, no} 表示 重复 前 面 的 项 至 少 m 次， 最 多 不 超过 n 次 
e Parentheses () 把 项 组 合成 一 个 逻辑 项 
。 [...] 声明 一 个 字符 类 ， 只 在 POSIX 正 则 表达 式 中 
请 注意 点 ( . ) 对 于 sIMILAR To 来 说 不 是 元 字符 。 


和 LIKE 一 样 ， 反 斜 杠 关 闭 所 有 这 些 元 字符 的 特殊 含义 ; 当然 我 们 也 可 以 用 EscaPE 声明 另外 
一 个 逃逸 字符 。 


一 些 例 子 : 


"abc' SIMILAR TO '‘abc' _true_ 
"abc' SIMILAR TO 'a' _false_ 
"abc' SIMILAR TO '%(b|d)%' _true_ 
"abc' SIMILAR TO '(b|c)%' _false_ 


带 三 个 参数 的 substring( string from pattern for escape-character ) 函数 提供 了 一 个 从 字 
符 串 中 抽取 一 个 匹配 SQL 正则 表达 式 模 式 的 子 字符 串 功能 。 和 sIMILAR To 一 样 ， 声 明 的 模 
式 必须 匹配 整个 字符 串 ， 否则 函数 失效 并 返回 NULL 。 为 了 标识 在 成 功 的 时 候 应 该 返回 的 模 
式 部 分 ， 模式 必须 出 现 后 跟 双 引号 ( " ) 的 两 个 逃逸 字符 。 匹配 这 两 个 标记 之 间 的 模式 的 字符 
串 将 被 返回 。 


一 些 例子 ， 以 #" 分 隔 返回 的 字符 串 : 


substring('foobar' from '%#"0_b#"%' for '#') _oob_ 
substring('foobar' from '#"o_b#"%' for '#') _NULL_ 


9.7.3. POSIX 正则 表达 式 


Table 9-11 列 出 了 所 有 用 于 POSIX 正则 表达 式 的 操作 符 。 
Table 9-11. 正则 表达 式 匹 配 操作 符 


操作 符 描述 例子 

Š 匹配 正则 表达 式 ， 大 小 写 相 关 'thomas' ~ '.*thomas.*' 
2 匹配 正则 表达 式 ， 大 小 写 无 关 'thomas' ~* '.*Thomas.*' 
S 不 匹配 正则 表达 式 ， 大 小 写 相 关 'thomas' !~ '.*Thomas.*! 
Ks 不 匹配 正则 表达 式 ， 大 小 写 无 关 'thomas' !~* '.*vadim.*! 


POSIX 正 则 表达 式 提供 了 比 Like 和 smar To 操作 符 更 强大 的 模式 匹配 的 方法 。 许 多 Unix 
工具 ， 比 如 egrep ，sed , awk 使 用 类 似 的 模式 匹配 语言 。 


正则 表达 式 是 一 个 字符 序列 ， 它 是 定义 一 个 字符 串 集合 (一 个 正则 集合 ) 的 缩写 。 如 果 一 个 字 
符 串 是 正则 表达 式 描述 的 正则 集合 中 的 一 员 时 ， 我 们 就 说 这 个 字符 串 匹 配 该 正则 表达 式 。 

和 Like 一 样 ， 模式 字符 准确 地 匹配 字符 串 字 符 ， 除 非 在 正则 表达 式 语 言 里 有 特殊 字符 (不 过 
正则 表达 式 用 的 特殊 字符 和 LIKE 用 的 不 同 )。 和 LIKE 不 一 样 的 是 ， 正 则 表达 式 可 以 匹配 字 
符 串 里 的 任何 位 置 ， 除非 该 正则 表达 式 明确 地 锚 定 在 字符 串 的 开头 或 者 结尾 。 


一 些 例子 : 


'abc' ~ ‘abc' _true_ 
'abc' ~ 'Aa' true 
‘abc' oo _true_ 
"abc' ~ 'A(bl|c)' _false_ 


POSIX 模 式 语 言 将 在 下 面 详细 描述 。 


带 两 个 参数 的 substring( string from pattern ) 函数 提供 了 从 字符 串 中 抽取 一 个 匹配 POSIX 
正则 表达 式 模式 的 子 字符 串 的 方法 。 如 果 没 有 匹配 它 返回 NULL ， 否 则 就 是 文本 中 匹配 模式 
的 那 部 分 。 但 是 如 果 该 模式 包含 任何 圆 括 弧 ， 那 么 将 返回 匹配 第 一 对 子 表 达 式 (对 应 第 一 个 左 
圆 括 弧 的 ) 的 文本 。 如 果 你 想 在 表达 式 里 使 用 圆 括 弧 而 又 不 想 导 致 这 个 例外 ， 那么 你 可 以 在 整 
个 表达 式 外 边 放 上 一 对 圆 括 弧 。 如 果 你 需要 在 想 抽 取 的 子 表 达 式 前 有 圆 括 弧 ， 参阅 描述 的 非 
捕获 性 圆 括 弧 。 


一 些 例子 : 
substring('foobar' from 'o.b') _oob_ 
substring('foobar' from 'o(.)b') 0 
regexp_replace ( _source_, _pattern_, _replacement_ [, _flags_ ]) 函 数 提供 了 将 匹配 


POSIX 正则 表达 式 模式 的 子 字符 串 蔡 换 为 新 文本 的 功能 。 如 果 没 有 匹配 pattern 的 子 字符 

串 ， 那么 返回 不 加 修改 的 source 字符 串 。 如 果 有 匹配 ， WIRE source 字符 串 里 面 的 
对 应 子 字 符 串 将 被 _replacement ”字符 串 蔡 换 掉 。 _replacement_ 字符 串 可 以 包含 \、_n_， 
这 里 的 n 是 1 到 9 ， 表 明 源 字 符 串 中 匹配 第 no ”个 圆 括 弧 子 表达 式 的 部 分 将 插入 在 该 位 
置 ， 并 且 它 可 以 包含 \& 表示 应 该 插 人 匹配 整个 模式 的 字符 串 。 如 果 你 需要 放 一 个 文本 反 斜 
杠 在 替换 文本 里 ， PAS \\. Wt flags SRASGSTPRETHE BAT ANS SS 
标记 。 i 表示 进行 大 小 写 无 关 的 匹配 ， 9 表示 蔡 换 每 一 个 匹配 的 子 字符 串 而 不 仅仅 是 第 一 
个 。 其 他 支持 的 标记 在 Table 9-19 中 描述 。 


一 些 例子 : 
regexp_replace('foobarbaz', 'b..', 'X') 
_fooxbaz_ 
regexp_replace('foobarbaz', 'b..', 'X', 'g') 
_F00XX_ 
regexp_replace('foobarbaz', 'b(..)', E'X\\1Y', 'g') 
_fooxarYxazyY_ 


regexp_matches (string ，_pattern [，_flags，]) 函 数 返回 一 个 从 匹配 POSIX 正 则 表达 式 

模式 中 获取 的 所 有 子 串 结果 的 text 数 组 。 这 个 男 数 可 以 返回 需 行 ， 一 行 ， 或 者 多 行 (SH FHA 
的 g 标记 ) 。 如 果 _pattern ”没有 匹配 ， 则 画 数 返 回 霉 行 。 如 果 模 式 包 含 没有 括号 的 子 表 达 
式 ， 则 每 行 返回 的 是 单元 素 的 文本 数组 ， 其 中 包含 的 子 串 相 匹 配 整 个 模式 。 如 果 模 式 包含 有 
括号 的 子 表达 式 ， 画 数 返 回 一 个 文本 数组 ， 它 的 第 n 个 元 素 是 子 串 匹配 模式 括号 子 表达 式 
内 的 第 n 个 元 素 。 (不 计 " 非 捕获 "的 括号 ; 详细 信息 参阅 下 面 ) 。 参 数 flags 是 一 个 可 
选 的 text 字 符 串 ， 含有 0 或 者 更 多 单字 母 标记 来 改变 郴 数 行为 。 标 记 g 导致 查找 字符 串 中 的 每 
个 匹配 ， 而 不 仅 是 第 一 个 ， 每 个 匹配 返回 一 行 ， 其 它 支 持 的 标记 在 Table 9-19 里 描述 。 


一 些 例子 : 


SELECT regexp_matches('foobarbequebaz', '(bar)(beque)'); 
regexp_matches 


{bar, beque} 
(1 row) 


SELECT regexp_matches('foobarbequebazilbarfbonk', '(b[4b]+)(b[4b]+)', 'g'); 
regexp_matches 


{bar, beque} 
{bazil, barf} 
(2 rows) 


SELECT regexp_matches('foobarbequebaz', 'barbeque'); 
regexp_matches 


{barbeque} 
(1 row) 


使 用 select 子 句 ， 可 能 强制 regexp_matches() 总 是 返回 一 行 ; 当 你 想 要 返回 seLEcT 目标 列表 
中 的 所 有 行 ， 甚 至 没有 匹配 的 情况 下 ， 是 有 特别 有 用 的 。 


SELECT coli, (SELECT regexp_matches(col2, '(bar)(beque)')) FROM tab; 


regexp_split_to_table ( _string_, _pattern_[, _flags_ ”]) 函 数 使 用 POSIX 正 则 表达 式 模 式 

作为 分 隔 符 ， 分 隔 字符 串 。 如 果 没 有 匹配 _pattern_ , BAUR Bl _string_ o 如 果 有 至 少 一 
个 匹配 ， 每 个 匹配 返回 从 最 后 一 个 匹配 结束 (或 者 字符 串 的 开头 ) 到 匹配 开始 的 文本 。 当 没 
有 更 多 的 匹配 ， 返回 最 后 一 个 匹配 的 结束 到 字符 串 的 结束 的 文本 。 _flags 参数 是 一 个 可 选 
text 字 符 串 ， 含有 0 或 者 更 多 单字 母 标记 来 改变 图 数 行为 。 regexp_split_to_table 支持 的 标 
记 在 Table 9-19 里 描述 。 


除了 regexp_split_to_array 返回 结果 为 text 数 组 ， regexp_split_to_array ÆT > 
与 regexp_split_to_table 相同 ， 使 用 语法 regexp_split_to_array ( _string_ , _pattern_ [, 
_flags_ ]) 参数 与 regexp_split_to_table 相同 。 


一 些 例 子 : 


SELECT foo FROM regexp_split_to_table('the quick brown fox jumps over the lazy dog', E'\\ 
foo 


(9 rows) 


SELECT regexp_split_to_array('the quick brown fox jumps over the lazy dog', E'\\s+'); 
regexp_split_to_array 


{the, quick, brown, fox, jumps, over, the, lazy, dog} 
(1 row) 


SELECT foo FROM regexp_split_to_table('the quick brown fox', E'\\s*') AS foo; 


aS 


作为 最 后 一 个 例子 表明 ， 发 生 在 字符 串 的 开始 或 结束 或 紧 接 前 一 个 的 匹配 ，regexp 分 隔 函 数 
Bak Ss KE PLAC, 这 样 实现 regexp_matches 严格 上 来 说 是 违背 了 的 正则 表达 式 匹 配 的 定义 ， 
但 在 实际 使 用 中 ， 通常 是 最 便利 的 的 行为 。 如 Penl 等 软件 系统 ， 使 用 了 类 似 的 定义 。 





9.7.3.1. 正则 表达 式 细 和 节 


PostgreSQL MJE nzi 21587 Henry Spencer 写 的 一 个 包 来 实现 。 下 面 的 大 部 分 描述 都 是 
从 他 的 手册 页 里 逐 字 拷贝 过 来 的 。 


正则 表达 式 (REs)， 在 POSIX 1003.2 中 定义 ， 它 有 两 种 形式 : 扩展 RE 或 ERE (基本 上 就 是 
在 egrep 里 的 那些 )， 基 本 _RE 或 BRE( 基 本 上 就 是 在 ea 里 的 那些 )。PostgreSQL 两 种 形式 都 
实现 了 ， 并 且 还 做 了 一 些 POSIX 里 面 没 有 的 ， 但 是 因为 在 类 似 Per RE Te 这 样 的 语言 中 
得 到 广泛 应 用 的 一 些 扩展 。 使 用 了 那些 非 POSIX 扩展 的 正则 表达 式 叫 高 级 _RE RARE, 
ARE 几乎 完全 是 ERE 的 超 集 ， 但 是 BRE 有 几 个 符号 上 的 不 兼容 (以 及 更 多 的 限制 )。 我 们 首 
先 描述 ARE 和 ERE 形式 ， 描 述 那 些 只 适用 于 ARE 的 特性 ， 然 后 描述 与 BRE 的 区 别 是 什 


dss 


Note: PostgreSQL 总 是 初始 化 一 个 遵循 ARE 规 则 的 正则 表达 式 。 然 而 ， 更 多 限制 的 ERE 
或 BRE 规 则 可 以 通过 在 RE 模式 前 放置 一 个 embeqddqded option 来 选择 ， 描述 在 Section 
9.7.3.4。 这 对 于 期 望 完全 兼容 POSIX 1003.2 规 则 的 应 用 程序 是 有 用 的 。 


一 个 正则 表达 式 定 义 为 一 个 或 多 个 分 支 ， 由 | 分 隔 。 它 匹配 其 中 任何 一 个 分 支 的 东西 。 


一 个 分 支 是 雳 个 或 多 个 有 修饰 的 原子 或 约束 连接 而 成 。 一 个 原子 匹配 第 一 个 ， 后 面 的 原子 匹 
配 第 二 个 ， 以 此 类 推 ; 一 个 空 分 支 匹配 空 字符 串 。 


一 个 有 修饰 的 原子 是 一 个 原子 ， 后 面 可 能 跟着 一 个 量词 。 没有 量词 的 时 候 ， 它 匹配 一 个 原 
子 ， 有 量词 的 时 候 ， 它 可 以 匹配 若干 个 原子 。 原子 可 以 是 在 Table 9-12 里 面 显示 的 任何 可 
能 。 可 能 的 量词 和 他 们 的 含义 在 Table 9-13 里 显示 。 


一 个 约束 匹配 一 个 空 字符 串 ， 但 只 是 在 满足 特定 条 件 下 才 匹 配 。 约束 可 以 在 能 够 使 用 原子 的 
地 方 使 用 ， 只 是 它 不 能 跟着 量词 。 最 简单 的 原子 在 Table 9-14 里 显示 ; 更 多 的 约束 稍 后 描 


Table 9-12. 正则 表达 式 原 子 


原子 


ake 
Vie 
{ 


RE 不 能 以 (、\ ) 结 尾 。 


描述 
(re ”是 任意 正则 表达 式 ) 匹 配 一 个 对 _re ”的 匹配 ， 有 可 报告 的 匹配 


信息 。 
同上 ， 但 是 匹配 不 会 被 报告 (一 个 " 非 捕 获 " 圆 括 弧 )， 只 在 ARE 中 有 。 
匹配 任意 单个 字符 


一 个 方 括 弧 表达 式 ， 匹 配 任意 的 “字符 (参阅 Section 9.7.3.2 获 取 更 多 
细节 ) 

(k 是 非 字 母 数 字 字 符 ) 匹 配 一 个 当 作 普 通 字符 看 待 的 特定 字符 ， 比 
如 \\ 匹配 一 个 反 斜 杠 。 

c 是 一 个 字母 数字 (可 能 跟着 其 它 字符 )， 它 是 一 个 逃逸 ， 参 
Section 9.7.3.3。 仅 存在 于 ARE 中 ; Œ ERE 和 BRE 中， EE 

Ad (© 

如 果 后 面 跟着 一 个 非 数 字 字 符 ， 那 么 就 匹配 左 花 括 弧 { ; 如 果 跟 着 一 
THRE, PACE _ 范 围 _ 的 开始 ( 见 下 面 ) 


这 里 的 x 是 一 个 没有 其 它 特征 的 单个 字符 ， 则 匹配 该 字符 


Note: 4052/4 T standard_conforming_strings, 任何 文本 字符 串 常 量 中 的 反 斜 杠 都 需 
要 双 写 。 参 阅 Section 4.1.2.1 获取 更 多 信息 。 


Table 9-13. 正则 表达 式 量 词 


量词 匹配 
一 个 匹配 0 或 者 更 多 个 原子 的 序列 


+ 一 个 匹配 1 或 者 更 多 个 原子 的 序列 
? 一 个 匹配 0 或 者 1 个 原子 的 序列 
ae 一 个 正好 匹配 m 个 原子 的 序列 
一 个 匹配 m 个 或 者 更 多 原子 的 序列 
oe Te 一 个 匹配 m 到 n 个 (包含 两 端 ) 原 子 的 序列 ; m 不 能 
上 ET 大 
g * 的 非 仿 楚 模 式 
+? + 的 非 贪 梦 模式 
2? 2 的 非 贪 梦 模式 
C Como TARR 
ie ne Como) 的 非 贪 梦 模 式 
nn {m,n} BOSE BBA SE 
Co. 的 形式 被 称 作 范 围 。 一 个 范围 内 的 数字 m 和 n 都 是 无 符号 十 进 制 整数 ， 人 允 


许 的 数值 从 0 到 255 ( 闭 区 间 )。 


JER AN iq (RE ARE 中 可 用 ) 匹 配对 应 的 正常 ( 贪 楚 ) 模 式 ， 区 别 是 它 寻 找 最 少 的 匹配 ， 而 
不 是 最 多 的 匹配 。 参 阅 Section 9.7.3.5 获取 细节 。 


Note: 一 个 量词 不 能 紧 跟 在 另外 一 个 量词 后 面 ， 例 如 ， ** 是 非法 的 。 量词 不 能 是 表达 
式 或 者 子 表达 式 的 开头 ， 也 不 能 跟 在 ^ 或 | 后 面 。 


Table 9-14. 正则 表达 式 约 束 


约束 描述 
A 匹配 字符 串 的 开头 
$ 匹配 字符 串 的 结尾 


(CT 正 前 瞻 匹 配 任何 匹配 _re 的 子 字符 串 起 始点 (只 在 ARE 中 有 ) 
(Co den) 负 前 瞻 匹 配 任何 不 匹配 _re ”的 子 字符 串 起 始点 (只 在 ARE 中 有 ) 


前 瞻 约 束 不 能 包含 后 引用 (参阅 Section 9.7.3.3) 并 且 在 其 中 的 所 有 圆 括 弧 都 被 认为 是 不 捕获 
的 。 


9.7.3.2. 方 括 弧 表 达 式 


方 括 弧 表达 式 是 一 个 包围 在 [] 里 的 字符 列表 。 它 通常 匹配 任意 单个 列表 中 的 字符 (又 见 下 

文 )。 如 果 列 表 以 ^ AL, 它 匹 配 任意 单个 (又 见 下 文 ) 不 在 该 列表 中 的 字符 。 如 果 该 列表 中 两 
个 字符 用 - 隔 开 ， 那 它 就 是 那 两 个 字符 (包括 在 内 ) 之 间 的 所 有 字符 范围 的 缩写 ， 比如 ， 在 

ASCll 里 [6-9] 包含 任何 十 进 制 数 字 。 两 个 范围 共享 一 个 终点 是 非法 的 ， 比 如 a-c-e 。 这 个 
范围 与 字符 集 关系 密切 ， 可 移植 的 程序 不 应 该 依靠 它们 。 


想 在 列表 中 包含 文本 ] ， 可 以 让 它 做 列表 的 首 字 符 ( 如 果 用 到 了 ， RE ^ 后 面 )。 想 在 列表 中 
包含 文本 - ， 可 以 让 它 做 列表 的 首 字 符 或 者 末 字 符 ， 或 者 一 个 范围 的 第 二 个 终点 。 想 在 列表 
中 把 文本 - 当做 范围 的 起 点 ， 把 它 用 [. 和 .] 包围 起 来 ， 这 样 它 就 成 为 一 个 集合 元 素 ( 见 下 
X) 除了 这 些 字符 本 身 ， 和 一 些 用 [ 的 组 合 ( 见 下 段 )， 以 及 逃逸 (只 在 ARE 中 有 效 ) 以 外 ， 
所 有 其 它 特 殊 字 符 在 方 括 弧 表达 式 里 都 失去 它们 的 特殊 含义 。 特别 是 ， 在 ERE 和 BRE 规则 
Toa 不 是 特殊 的 ， 但 在 ARE 里 ， 它 是 特殊 的 (还 是 引入 一 个 逃逸 )。 


在 一 个 方 括 弧 表 达 式 里 ， 一 个 集合 元 素 ( 一 个 字符 、 一 个 当做 一 个 字符 的 多 字符 序列 、 或 者 一 
个 表示 上 面 两 种 情况 的 集合 序列 ) 包 含 在 [. 和 .] 里 面 的 时 候 表示 该 集合 元 素 的 字符 序列 。 
该 序列 是 该 方 括 弧 列表 的 一 个 元 素 。 这 人 允许 一 个 包含 多 字符 集合 元 素 的 方 括 弧 表达 式 就 可 以 
匹配 多 于 一 个 字符 ， 上 比如 ， 如 果 集 合 序列 包含 一 个 ch 集合 元 素 ， 那 么 [[.ch.]]*c LZ 

配 chchcc 的 头 五 个 字符 。 译 注 : 其 实 把 [. 和 .] 括 起 来 的 整体 当 一 个 字符 看 就 行 了 。 





Note: PostgreSQL 目 前 不 支持 多 字符 集合 元 素 。 这 些 信息 描述 了 将 来 可 能 有 的 行为 。 


在 方 括 弧 表 达 式 里 ， 在 [= 和 =] 里 包围 的 集合 元 素 是 一 个 等 效 表 ， 代 表 等 于 这 里 所 有 集合 元 
素 的 字符 序列 ， 包括 它 本 身 (如 果 没 有 其 它 等 效 集合 元 素 ， 那 么 就 好 像 封装 元 素 是 L. 

和 .] )。 比 如 ， 如 果 o Ms 是 一 个 等 效 表 的 成 员 ， 那 么 [[=o=]] ，[[=^=]] ，[o^] 都 是 同 义 
的 。 一 个 等 效 表 不 能 是 一 个 范围 的 端点 。 








在 方 括 弧 表达 式 里 ， 在 [: 和 :] 里 面 封装 的 字符 表 名 字 代表 属于 该 表 的 所 有 字符 的 列表 。 标 
准 的 字符 表 名 字 是 : alnum ，alpha ，blank , cntrl , digit ，graph , lower , print , 
punct , space , upper , xdigit o 它们 代表 在 ctype 里 定义 的 字符 胡 。 本 地 化 设 及 置 可 能 会 提 
供 其 它 的 表 。 字 符 表 不 能 用 做 一 个 范围 的 端点 。 


在 方 括 弧 表 达 式 里 有 两 个 特例 : 方 括 弧 表达 式 [[:&1t;:]] 和 [[:&gt;:]] 是 约束 ， 分 别 匹配 
一 个 单词 开头 和 结束 的 空 串 。 单词 定义 为 一 个 单词 字符 序列 ， 前 面 和 后 面 都 没有 其 它 单 词 字 
Fo 单词 字符 是 一 个 alnm 字符 (和 ctype 里 定义 的 一 样 ) 或 者 一 个 下 划 线 。 这 是 一 个 扩展 ， 兼 
六 0 但 那里 面 并 没有 说 明 ， 而 且 在 准 各 移植 到 其 它 系统 里 去 的 软件 里 一 定 要 
小 心 使 用 。 通常 下 面 描述 的 约束 逃逸 更 好 些 ; 他 们 并 非 更 标准 ， 但 是 更 容易 输入 。 


9.7.3.3. 正则 表达 式 逃 逸 


逃逸 是 以 、 开头， 后 面 跟着 一 个 字母 数字 字符 的 特殊 序列 。 逃逸 有 好 几 种 变 体 : 字符 项 、 表 
缩 守 、 约 束 逃 逸 、 后 引用 。 在 ARE 里 ， 如 果 一 个 \ 后 面 跟着 一 个 字母 数字 ， 但 是 并 未 组 成 
一 个 合法 的 逃逸 ， 那 么 它 是 非法 的 。 在 ERE 里 则 没有 逃逸 : 在 方 括 弧 表 达 式 之 外 ， 一 个 跟着 


nae \ 只 是 表示 该 字符 是 一 个 普通 的 字符 ， 而 在 一 个 方 括 弧 表达 式 里 ，、 是 一 
普通 的 字符 (后 者 实际 上 是 ERE 和 ARE 之 间 的 不 兼容 )。 


字符 项 逃逸 用 于 方便 我 们 声明 正则 表达 式 里 那些 不 可 打印 的 字符 。 它们 在 Table 9-15 里 列 
出 。 


类 缩写 逃逸 用 来 提供 一 些 常用 的 字符 类 缩写 。 他 们 在 Table 9-16 里 列 出 。 


约束 逃逸 是 一 个 约束 ， 如 果 满 足 特定 的 条 件 ， 它 匹配 该 空 字符 串 ， 以 逃逸 形式 写 出 。 它们 
在 Table 9-17 里 列 出 。 


后 引用 (\、n_ ) 匹 配 数字 _n ”指定 的 前 面 的 圆 括 弧 子 表达 式 匹 配 的 同一 个 字符 串 (参阅 Table 
9-18)。 上 比如， ([bc])\1 匹配 bb 或 cc 但 是 不 匹配 bc 或 cbo 正则 表达 式 里 的 子 表达 式 必 
须 完 全 在 后 引用 前 面 。 子 表达 式 以 它 的 括号 的 顺序 排序 。 非 捕获 圆 括 弧 并 不 定义 子 表达 式 。 





Note: 请 注意 ， 如 果 把 模式 当 作 一 个 SQL 字符 串 常 量 输入 ， 那 么 逃逸 前 导 的 、\ 需要 双 倍 
thE : 








'123' ~ E'A\\d{3}' _true_ 


Table 9-15. 正则 表达 式 字符 项 逃逸 


逃逸 描述 


警笛 (铃声 ) 字 符 ， 和 C BH 
退 格 ， 和 C 里 一 样 
\B \ 的 同义词 ， 用 于 减少 反 斜 杠 加 倍 的 需要 


(这 里 x 是 任意 字符 ) 字 符 的 低 5 位 和 x 里 的 相同 ， 其 它 位 都 是 


NG DXN 0 

gs a esc 的 字符 ， 如 果 不 是 ， 则 是 八进制 值 为 033 的 字 
\f 进 纸 ， 和 C 里 一 样 

\n 新 行 ， 和 C 里 一 样 

\r 回 车 ， 和 C 里 一 样 

\t 水 平 制 表 符 ， 和 C 里 一 祥 

Nope oe Fa 是 恰好 四 位 十 六 进 制 位 ) 本 机 字 节 序 的 UTF-16 字符 
CSR Gx SEREA 是 恰好 八 位 十 六 进 制 位 ) 为 假想 中 的 Unicode 32 
\v 垂直 制 表 符 ， 和 C 里 一 样 


(这 里 的 nh 是 一 个 十 六 进 制 序列 ) 十 六 进 制 值 为 oxh 的 字符 


es (不 管用 了 几 个 十 六 进 制 位 ， 都 是 一 个 字符 ) 

\o 值 为 o 的 字符 (null = 7) 

a (这 里 的 oy 是 恰好 两 个 八进制 位 ， 并 且 不 是 一 个 后 引用 ) 八 进 制 值 
为 oxy, 的 字符 

ee (这 里 的 vz 是 恰好 三 位 八进制 位 ， 并 且 不 是 一 个 后 引用 ) 八 进 制 人 


为 o` xyz 的 字符 
十 六 进 制 位 是 6 -9，a -f，A- F 。 八 进 制 位 是 。- 7 。 


字符 项 逃逸 总 是 被 当 作 普通 字符 。 比 如 ， \135 Æ ASCII 中 的 ] ， 但 \135 并 不 终止 一 个 方 
括 弧 表达 式 。 


Table 9-16. 正则 表达 式 类 缩写 逃逸 


\d [[:digit:]] 
\s [[:space:]] 
\w [[:alnum:]_] (注意 ， 这 里 是 包含 下 划 线 的 ) 
\D [A[:digit:]] 
\S [4[: space: ]] 
\w [^[:alnum:]_] (注意 ， 这 里 是 包含 下 划 线 的 ) 


在 方 括 弧 表达 式 里 ， \d as, w 会 失去 他 们 的 外 层 方 插 弧 ， 而 \v, as, w 是 非法 的 。 
比如 [a-c\d] 等 效 于 [a-c[:digit:]] o 同样 [a-c\D] 原来 等 效 于 [a-c^[:digit:]] 的 ， 也 是 
非法 的 。 


Table 9-17. ENR AA ARKA 

\A 只 匹配 字符 串 开头 (参阅 Section 9.7.3.5 获取 它 和 ^ 区 别 的 信息 ) 

\m 只 匹配 一 个 词 的 开头 

\M 只 匹配 一 个 词 的 结尾 

\y 只 匹配 一 个 词 的 开头 或 者 结尾 

\Y 只 匹配 那些 既 不 是 词 的 开头 也 不 是 词 的 结尾 的 点 

\Z 只 匹配 一 个 字符 串 的 结尾 (参阅 Section 9.7.3.5 获取 它 和 $ 区 别 的 信息 ) 
一 个 词 的 定义 是 上 面 [[:&1t;:]] 和 [[:&gt; :]] 的 声明 。 在 方 括 弧 表达 式 里 ， 约 束 逃 逸 是 非 
法 的 。 


Table 9-18. 正则 表达 式 后 引用 


逃逸 描述 
\ -mn (这 里 的 m 是 一 个 非 震 十 进 制 位) 一 个 指向 第 _m_ 个 子 表达 式 的 后 引用 


(这 里 的 m 是 一 个 非 雳 十 进 制 位 ， _nn ”是 更 多 的 十 进 制 位 ， 并 且 十 进 制 
\ -mnn- ”数值 mnn 不 能 大 于 到 这 个 位 置 为 止 的 闭合 捕获 圆 括 弧 的 个 数 ) 一 个 指向 
Fomo 个 子 表达 式 的 后 引用 


Note: 在 八进制 字符 项 逃逸 和 后 引用 之 间 有 一 个 继承 的 歧义 存在 ， 这 个 歧义 是 通过 跟着 
的 启发 分 析 解 决 的 ， 像 上 面 描述 的 那样 。 前 导 需 总 是 表示 这 是 一 个 八进制 逃逸 。 而 单个 
非 需 数字 ， 如 果 没 有 跟着 任何 其 它 数 字 ， 那 么 总 是 认为 是 后 引用 。 一 个 多 数据 位 的 非 需 
开头 的 序列 也 认为 是 后 引用 (只 要 它 在 合适 的 子 表 达 式 后 面 ， 也 就 是 说 ， 数 值 在 后 引用 的 
合法 范围 内 )， 否 则 就 认为 是 一 个 八进制 。 


9.7.3.4. 正则 表达 式 元 语法 


除了 上 面 描述 的 主要 语法 之 外 ， 还 有 几 种 特殊 形式 和 杂项 语法 。 


正则 表达 式 可 以 以 两 个 特殊 的 指示 器 前 级 之 一 开始 : 如 果 一 个 正则 表达 式 以 ***: 开头 ， 那 

么 剩 下 的 正则 表达 式 都 被 当 作 ARE. (这 在 PostgreSQL 中 通常 没有 影响 ， 因 为 正则 表达 式 
被 假设 为 ARE ; 但 是 如 果 ERE 或 BRE 模 式 被 flags 参数 指定 为 正则 表达 式 男 数 时 是 有 影响 
的 。) 如 果 一 个 的 正则 表达 式 以 *“**= 开头 ， 那 么 剩 下 的 正则 表达 式 被 当 作 一 个 文本 串 ， 所 
有 的 字符 都 被 认为 是 一 个 普通 字符 。 

一 个 ARE 可 以 以 嵌入 选项 开头 : 一 个 (2 xyz) 序列 (这 里 的 _xyz_ 是 一 个 或 多 个 字母 字 
符 ) 声 明 影响 剩余 正则 表达 式 的 选项 。 这 些 选 项 覆盖 任何 前 面 判断 的 选项 一 它们 可 以 重 写 正 则 
表达 式 操 作 符 隐 含 的 大 小 写 敏感 性 ， KALEMNRADWAN flags 参数。 可 用 的 选项 字母 
在 Table 9-19 显 示 。 请 注意 ， IER RATA flags 参数 使 用 相同 的 选项 字母 。 


Table 9-19. ARE 嵌入 选项 字母 


选项 描述 

b 剩余 的 正则 表达 式 是 BRE 

c 大 小 宇 敏 感 匹 配 (覆盖 操作 符 类 型 ) 

e 剩余 的 正则 表达 式 是 ERE 

i 大 小 写 不 敏感 匹配 (参阅 Section 9.7.3.5) mR ER KB) 
m n 的 历史 同义词 

n 新 行 敏感 匹配 (参阅 Section 9.7.3.5) 

p 部 分 新 行 敏感 匹配 (参阅 Section 9.7.3.5) 

q 重 置 正则 表达 式 为 一 个 文本 ("引起 ") 字 符 串 ， 所 有 都 是 普通 字符 。 
s 非 新 行 敏感 匹配 ( 缺 省 ) 

č 紧 语 法 ( 缺 省 ， 见 下 文 ) 

w 反 转 部 分 新 行 敏感 ("怪异 ") 匹 配 (参阅 Section 9.7.3.5) 

X 扩展 的 语法 ( 见 下 文 ) 


找 入 的 选项 在 终止 其 序列 的 ) 发 生 作 用 。 他 们 只 在 ARE 的 开始 处 起 作用 (如 果 有 ， 则 在 任 
fa] ***: 指示 器 后 面 )。 

除了 通常 的 ( 紧 ) 正 则 表达 式 语法 (这 种 情况 下 所 有 字符 都 重要 )， 还 有 一 种 扩展 语法 ， 可 以 通过 
ARAHI x 选项 获得 。 在 扩展 语法 里 ， 正 则 表达 式 中 的 空白 字符 被 忽略 ， 就 像 那些 在 # 
和 新 行 之 间 的 字符 一 样 (或 正则 表达 式 的 结尾 ) 。 这 样 就 允许 我 们 给 一 个 复杂 的 正则 表达 式 
分 段 和 注释 。 不 过 这 个 基本 规则 上 有 三 种 例外 : 


。 前 置 了 、 的 空白 字符 或 者 # 保留 
。 方 括 弧 里 的 空白 或 者 # 保留 


。 在 多 字符 符号 里 面 不 能 出 现 空白 和 注释 ， 比 如 (2: 
在 这 里 ， 空 白 是 空格 、 水 平 制 表 符 、 新 行 、 和 任何 属于 space (空白 ) 字 符 表 的 字符 。 


最 后 ， 在 ARE 里 ， 方 括 弧 表达 式 外 面 ， 序 列 (?#*`_ttt `…) (这 里 的 ttre 是 任意 不 包 

含 ) 的 文本 ) 是 一 个 注释 ， 完 全 被 忽略 。 同样 ， 这 样 的 东西 是 不 允许 出 现在 多 字符 符号 的 字 
符 中 间 的 ， 比 如 (?: 。 这 样 的 注释 是 比 有 用 的 机 制 的 更 久远 的 历史 造成 的 ， 他 们 的 用 法 已 经 
RRT; 我 们 应 该 使 用 扩展 语法 代 著 他 。 

如 果 声 明了 一 个 初始 化 的 ***= 指示 器 ， 那 么 所 有 这 些 元 语法 扩展 都 不 能 使 用 ， 因 为 这 样 表 
示 把 用 户 输入 当 作 一 个 文本 字符 串 而 不 是 正则 表达 式 对 待 。 


9.7.3.5. 正则 表达 式 匹 配 规则 


在 正则 表达 式 可 以 匹配 给 出 的 字符 串 中 多 于 一 个 子 字符 串 的 情况 下 ， 正则 表达 式 匹 配 字符 串 
中 最 靠 前 的 那个 子 字符 串 。 如 果 正 则 表达 式 可 以 匹配 在 那个 位 置 开 始 的 多 个 子 字符 串 ， 要 么 
是 取 最 长 的 子 字 符 串 ， 要 么 是 最 短 的 ， 具 体 哪 种 ， 取 决 于 正则 表达 式 是 贪 梦 的 还 是 FRE 
的 。 


一 个 正则 表达 式 是 否 贪 禁 取 决 于 下 面 规则 : 
。 大 多 数 原 子 ， 以 及 所 有 约束 ， 都 没有 贪 禁 属 性 (因为 它们 毕竟 无 法 匹配 个 数 变化 的 文本 )。 
。 在 一 个 正则 表达 式 周围 加 上 圆 括 弧 并 不 会 改变 其 贪 林 性。 
。 一 个 带 一 个 固定 重复 次 数 的 量词 ( 人 _m 、} 或 Cm}? ) 量化 的 原子 和 原子 自身 有 着 


同样 的 贪 梦 性 (可 能 是 没有 )。 


。 一 个 带 其 它 普 通 的 量词 (包括 com, on} 中 _m SF _n 的 情况 ) 量 化 的 原子 是 
贪 攀 的 (首选 最 长 匹配 )。 

° 一 个 带 非 贪 楚 量词 (包括 ee Tee 等 于 _n_ 的 情况 ) 量 化 原子 是 非 贪 梦 
的 (首选 最 短 匹 配 )。 


一 个 分 支 ( 也 就 是 一 个 没有 顶级 | 操作 的 正则 表达 式 ) 和 它 里 面 的 第 一 个 有 贪 梦 属 性 的 量 
化 原子 有 着 同 祥 的 贪 楚 性 。 


。 一 个 由 | 操作 符 连接 起 来 的 两 个 或 者 更 多 分 支 组 成 的 正则 表达 式 总 是 贪 梦 的 。 


上 面 的 规则 所 描述 的 贪 梦 属性 不 仅仅 适用 于 独立 的 量化 原子 ， 而 且 也 适用 于 包含 量化 原子 的 
分 支 和 整个 正则 表达 式 。 这 里 的 意思 是 ， 匹配 是 按照 分 支 或 者 整个 正则 表达 式 作 为 一 个 整体 
匹配 最 长 或 者 最 短 的 子 字 符 串 的 可 能 。 一 旦 整个 匹配 的 长 度 确定 ， 那么 匹配 任意 子 表 达 式 的 
部 分 就 基于 该 子 表达 式 的 贪 梦 属性 进行 判断 ， 在 正则 表达 式 里 面 靠 前 的 子 表达 式 的 优先 级 高 
于 靠 后 的 子 表达 式 。 


一 个 表达 这 些 的 例子 : 


SELECT SUBSTRING('XY1234Z', 'Y*([0-9]{1,3})'); 
_Result:_ <samp class="literal">123</samp> 
SELECT SUBSTRING('XY1234Z', 'Y*?([0-9]{1,3})'); 
_Result:_ <samp class="literal">1</samp> 


在 第 一 个 例子 里 ， 正 则 表达 式 作为 整体 是 贪 禁 的 ， 因 为 Y* 是 贪 禁 的 。 它 可 以 匹配 从 Y 开始 
的 东西 ， 并 且 它 匹配 从 这 个 位 置 开始 的 最 长 的 字符 串 ， 也 就 是 Yi23 。 和 输出 是 这 里 的 圆 括 弧 
包围 的 部 分 ， 或 者 说 是 123 。 在 第 二 个 例子 里 ， 正 则 表达 式 总 体 上 是 一 个 非 贪 林 的 正则 表达 
A, AA Y*? 是 非 贪 梦 的 。 它 可 以 匹配 从 Y 开始 的 最 短 的 子 字 符 串 ， 也 就 是 说 Y1 。 FR 
达 式 [0-9]{1,3} 是 贪 楚 的 ， 但 是 它 不 能 修改 总 体 匹 配 长 度 的 决定 ; 因此 它 被 迫 只 匹配 1 。 


简单 说 ， 如 果 一 个 正则 表达 式 同时 包含 贫 禁 和 非 贫 楚 的 子 表达 式 ， 那么 总 匹配 长 度 要 么 是 最 
长 可 能 ， 要 么 是 最 短 可 能 ， 取 决 于 给 整个 正则 表达 式 赋予 的 贪 禁 属 性 。 给 子 表达 式 赋予 的 贪 
楚 属 性 只 影响 在 这 个 匹配 里 ， 各 个 子 表达 式 之 间 相 互 允 许 " 吃 进 " 的 多 少 。 


量词 (1,13 和 {1,1}? 可 以 分 别 用 于 在 一 个 子 表 达 式 或 者 整个 正则 表达 式 上 强制 贫 梦 或 者 非 


匹配 长 度 是 以 字符 衡量 的 ， 而 不 是 集合 的 元 素 。 一 个 空 字符 串 会 被 认为 比 什么 都 不 匹配 长 。 
比如 : pb* 匹配 abbbc 的 中 间 三 个 字符 ;”(week|wee)(night|knights) 匹配 weeknights 的 所 
有 十 个 字符 ; 而 (.*).* 匹配 abe 的 时 候 ， 圆 括 弧 包 围 的 子 表达 式 匹 配 所 有 三 个 字符 ; 而 如 
RA (a*)* 匹配 bc ， 那 么 正则 表达 式 和 圆 括 弧 子 表达 式 都 匹配 空 字符 串 。 


如 果 声 明了 大 小 写 无 关 的 匹配 ， 那 么 效果 就 好 像 把 所 有 字母 上 的 大 小 写 区 别 取 消 了 一 样 。 如 
果 一 个 存在 大 小 写 差 别 的 字母 以 一 个 普通 字符 的 形式 出 现在 方 括 弧 表达 式 外 面 ， 那么 它 实际 
上 被 转换 成 一 个 包含 大 小 写 的 方 括 弧 表达 式 ， 也 就 是 说 ， x AR xx] 。 如 果 它 出 现在 一 个 
方 括 弧 表达 式 里 面 ， 那么 它 的 所 有 大 小 写 的 同族 都 被 加 入 方 括 弧 表 达 式 中 ， 也 就 是 说 ， [x] 
变 成 [xx] 而 [^x] 变 成 [Axx] o 


如 果 声 明了 新 行 敏感 匹配 ， .和 使 用 ^ 的 方 括 弧 表达 式 将 永远 不 会 匹配 新 行 字符 (这 样 ， 匹 
配 就 绝对 不 会 跨 新 行 ， 除非 正则 表达 式 明 确 地 安排 了 这 样 的 情况 ) 并 且 ^ 和 $ 除了 分 别 匹配 
字符 串 开 头 和 结尾 之 外 ， 还 将 分 别 匹 配 新 行 后 面 和 前 面 的 空 字符 串 。 但 是 ARE xb 

逸 \A 和 \z 仍然 只 匹配 字符 串 的 开头 和 结尾 。 


如 果 声 明了 部 分 新 行 敏 感 匹 配 ， 那 么 它 影响 . 和 方 括 弧 表达 式 ， 这 个 时 候 和 新 行 敏感 匹配 一 
样 ， 但 是 不 影响 ^ 和 $ 。 


如 果 声 明了 反 转 部 分 新 行 敏感 匹配 ， 那 么 它 影响 ^ 和 $ ， 作用 和 新 行 敏感 匹配 里 一 样 ， 但 
是 不 影响 . MARMARA, 这 个 没什么 太 多 用 途 ， 只 是 为 了 对 称 提供 的 。 


9.7.3.6. 限制 和 兼容 性 


在 这 个 实现 里 ， 对 正则 表达 式 的 长 度 没有 特别 的 限制 ， 但 是 ， 那些 希望 能 够 有 很 好 移植 行 的 
程序 应 该 避免 写 超 过 256 字 节 的 正则 表达 式 ， 因为 POSIX 兼容 的 实现 可 以 拒绝 接受 这 样 的 
正则 表达 式 。 


ARE 实际 上 和 POSIX ERE 不 兼容 的 唯一 的 特性 是 在 方 括 弧 表达 式 里 \ 并 不 失去 它 特殊 的 含 
义 。 所 有 其 它 ARE 特性 都 使 用 在 POSIX ERE 里 面 是 非法 或 者 是 未 定义 、 未 声明 效果 的 语 
法 ; 指示 器 的 *** 就 是 在 POSIX 的 BRE 和 ERE 之 外 的 语法 。 


许多 ARE 扩展 都 是 从 Perl 那里 借 来 的 ， 但 是 有 些 我 做 了 修改 ， 清 理 了 一 下 ， 以 及 一 些 Perl 
里 没有 出 现 的 扩展 。 要 注意 的 不 兼容 包括 \b ，\B ， 对 结尾 的 新 行 缺 乏 特 别 的 处 理 ， 对 那些 
新 行 敏 感 匹配 的 附加 的 补 齐 方 括 弧 表达 式 ， 在 前 瞻 约 束 里 对 圆 括 弧 和 方 括 弧 引 用 的 限制 ， 以 
及 最 长 /最 短 匹 配 (而 不 是 第 一 匹配 ) 语 义 。 


PostgreSQL 7.4 之 前 的 版 本 里 的 ARE 和 ERE 存在 两 个 非常 显著 的 不 兼容 : 


。 在 ARE 里 ， 后 面 跟着 一 个 字母 数字 的 \ 要 么 是 一 个 逃逸 ， 要 么 是 错误 ， 但 是 在 以 前 的 
版 本 里 ， 它 只 是 写 那 个 字母 数字 的 另外 一 种 方法 。 这 个 应 该 不 是 什么 问题 ， 因为 在 以 前 
的 版 本 里 没有 什么 原因 让 我 们 写 这 样 的 序列 。 


。 在 ARE 里 ，、 在 [] 里 还 是 一 个 特殊 字符 ， 因此 在 方 括 弧 表达 式 里 的 一 个 文本 \ 必须 
BRM \\ 。 


9.7.3.7. 基本 正则 表达 式 


BRE 在 几 个 方面 和 ERE 不 太一 样 。 在 BRE 里 ， | ，+ , ? 都 是 普通 字符 ， 它 们 没有 等 效 的 

TRB ORNATE \{ 和 \} ， 因为 { 和 } 本 身 是 普通 字符 。 嵌 套 的 子 表达 式 的 圆 
file \( 和 \) ， 因 为 ( 和 ) 自身 是 普通 字符 。 除非 在 正则 表达 式 开头 或 者 是 圆 括 弧 封装 
的 子 表达 式 开 关 ，“^ 都 是 普通 字符 ， 除非 在 正则 表达 式 结尾 或 者 是 圆 括 弧 封装 的 子 表达 式 的 
结尾 ， $ 是 一 个 普通 字符 ， MUR * 出 现在 正则 表达 式 开 头 或 者 是 圆 括 弧 封 装 的 子 表 达 式 

开头 (前 面 可 能 有 ^ )， 那 么 它 是 个 普通 字符 。 最 后 ， 可 以 用 单数 字 的 后 引用 ， 以 

及 \alt; 和 \&gt; 分 别 是 [[:&lt;:]] 和 [[:&gt;:]] 的 同义词 ; 在 BRE 里 没有 其 它 的 逃逸 。 


9.8. 数据 类 型 格式 化 函数 


PostgreSQL 格 式 化 函数 提供 一 套 有 效 的 工具 用 于 把 各 种 数据 类 型 转换 成 格式 化 的 字符 串 以 及 
反 过 来 从 格式 化 的 字符 串 转 换 成 指定 的 数据 类 型 。 Table 9-20 列 出 了 这 些 画 数 。 这 些 画 数 都 
遵循 一 个 公共 的 调用 习惯 : 第 一 个 参数 是 待 格式 化 的 值 ， 


模板 。 


而 第 二 个 是 定义 输出 或 输入 格式 的 


单 参 数 to_timestamp 画 数 也 可 以 使 用 ; 它 接受 一 个 double precision 参数 ， 并 且 从 Unix 纪 元 


( 秒 自 1970-01-01 00:00:00+00) 转换 为 timestamp with time zone 类 型 。 
的 Unix 纪 元 隐 含 的 转换 为 double precision 类 型 。) 


Table 9-20. 格式 化 函数 


EEs 


`to_char(```timestamp , text ) 


to char( intervall , text ) 


ere ane, exe) 


to_char`( double precision , text>) 


*to_char(***numeric , text ) 


“to_date(*~*text , text ) 


text 


text 


text 


text 


text 


date 


Tk 


E 


描述 


把 时 
ja] 
转换 
成 字 
FE 
把 时 
间 间 
隅 转 
为 字 
FE 


把 整 
数 转 
换 成 
字符 


( Integer 类 型 


to_char(cur 


to_char (int 


to chan( T25 


to_char(125 


to_char(-12 


to_date('05 


`to_number(```text , text ) 


ito timestamp = text 


`to_timestamp(```double precision ) 


text ) 


成 日 
期 


把 字 
符 串 
转换 
成 数 
字 

把 字 
符 串 
转换 
成 时 
jal Æ 


把 

Unix 
纪元 
转换 
成 时 
ja] Bk 


numeric to_number(' 


timestamp with time zone to_timestan 


timestamp with time zone to_timestan 


在 to_char MUWRREPRE, ZHAI a ER ERR, 并 且 把 给 定 的 数值 正确 


地 格式 化 成 相应 的 数据 。 任 何不 属于 模板 模式 的 文本 都 简单 地 逐 字 拷贝 。 


同 祥 ， 在 一 个 输入 


模板 字符 串 里 (对 其 他 函数 )， 模 板 模 式 标 识 数值 由 输入 数据 字符 串 提 供 。 


Table 9-21 显 示 了 可 以 用 于 格式 化 日 期 和 时 间 值 的 模版 。 


Table 9-21. 用 于 日 期 /时 间 格式 化 的 模式 


模式 
HH 
HH12 


HH24 


一 天 的 小 时 数 (01-12) 

一 天 的 小 时 数 (01-12) 

一 天 的 小 时 数 (00-23) 

分 钟 (00-59) 

秒 (00-59) 

毫秒 (000-999) 

微 秒 (000000-999999) 
午夜 后 的 秒 (0-86399) 

正午 指示 器 (没有 周期 ) 
正午 指示 器 (有 周期 ) 


:号 


带 逗 号 的 年 (4 和 更 多 位 ) 
年 (4 和 更 多 位 ) 


IW 


CC 


年 的 后 三 位 

年 的 后 两 位 

年 的 最 后 一 位 

ISO 年 (4 位 或 更 多 位 ) 

ISO 年 的 最 后 三 位 

ISO 年 的 最 后 两 位 

ISO 年 的 最 后 一 位 

纪元 标识 (没有 周期 ) 

纪元 标识 (有 周期 ) 

全 长 大 宇 月 份 名 (空白 填充 为 9 字符 ) 

全 长 首 字 母 大 写 月 份 名 (空白 填充 为 9 字符 ) 

全 长 小 写 月 份 名 (空白 填充 为 9 字符 ) 

大 写 缩写 月 份 名 (英文 3 字符 ， 本 地 化 的 长 度 不 同 ) 
首 字 母 大 写 缩 写 月 份 名 (英文 3 字符 ， 本 地 化 的 长 度 不 同 ) 
小 写 缩 写 月 份 名 (英文 3 字符 ， 本 地 化 的 长 度 不 同 ) 
月 份 数 (01-12) 

全 长 大 写 日 期 名 (空白 填充 为 9 字符 ) 

全 长 首 字母 大 写 日 期 名 (空白 填充 为 9 字符 ) 

全 长 小 写 日 期 名 (空白 填充 为 9 字符 ) 

缩写 大 写 日 期 名 (英文 3 字符 ， 本 地 化 长 度 不 同 ) 
缩写 首 字 母 大 写 日 期 名 (英文 3 字符 ， 本 地 化 长 度 不 同 ) 
缩写 小 写 日 期 名 (英文 3 字符 ， 本 地 化 长 度 不 同 ) 
一 年 里 的 日 (001-366) 


ISO 一 年 里 的 日 (001-371 ; 年 的 第 一 天 是 第 一 个 ISO 周 的 
星期 一 ) 


一 个 月 里 的 日 (01-31) 

一 周 里 的 日 ， 星 期 日 ( 1 ) 到 星期 六 ( 7 ) 
ISO 一 周 里 的 日 ， 星 期 一 ( 1 ) 到 星期 日 (7 ) 

一 个 月 里 的 周 数 (1-5)( 第 一 周 从 该 月 第 一 天 开始 ) 

一 年 里 的 周 数 (1-53)( 第 一 周 从 该 年 的 第 一 天 开始 ) 
ISO 一 年 里 的 周 数 (01-53 ; 第 一 个 星期 四 在 第 一 周 里 ) 
世纪 (2 位 )(20 世纪 从 2001-01-01 开始 ) 


儒 略 日 ( 自 公元 前 4714 年 11 月 24 日 午夜 来 的 天 数 ) 
季度 ( to_date 和 to_timestamp 忽略 此 项 ) 

罗马 数字 的 月 份 (|-Xll ; |=January)( 大 写 ) 
罗马 数字 的 月 份 (i-xii ; i=January)( 小 写 ) 

时 区 名 (大 写 ) 

时 区 名 (小 写 ) 


有 一 些 修饰 词 可 以 应 用 于 模板 来 修改 它们 的 行为 。 比 如 ， FMMontn 就 是 带 着 FM 前 级 
的 month 模式 。 Table 9-22 显示 了 用 于 日 期 /时 间 格 式 化 的 修饰 词 模式 。 


Table 9-22. 日 期 /时 间 格 式 化 的 模板 模式 修饰 词 


修饰 词 描述 例子 

FM 前 缀 ”填充 模式 (抑制 填充 空白 和 尾随 雳 ) FMMontn 

TH 后 级 大 写 顺 序数 后 级 DDTH , 例如 ，12TH 
th 后 级 ”小 写 顺 序数 后 级 DDth , 例如 ，12th 
Fx 前 级 ， 固定 格式 全 局 选项 ( 见 用 法 须知 ) FX Month DD Day 
TM 前 级 ”翻译 模式 (基于 |Ic_time 显 示 本 地 化 的 日 期 和 月 份 名 ) TMMontn 

s 后 级 ”拼写 模式 (未 实现 ) DDSP 


日 期 /时 间 格 式 化 的 用 法 须知 : 


FM Suppresses leading zeroes and trailing blanks that would otherwise be added to 
make the output of a pattern be fixed-width. In PostgreSQL, Fm modifies only the next 
specification, while in Oracle Fm affects all subsequent specifications, and repeated 

FM modifiers toggle fill mode on and off. 


FM 抑制 前 导 的 雾 或 尾随 的 空白 ， 如 果 没 有 使 用 它 的 话 ， 会 在 输出 中 增加 这 些 填充 最 终 
把 输出 变 成 固定 宽度 的 模式 。 在 PostgreSQL 中 ， FM 只 修改 下 一 个 规范 ， 而 在 Oracle 
中 FM 影响 所 有 随后 的 规范 ， FEBS Fm 修饰 符 填 充 模 式 开关 打开 或 关闭 。 


TM 不 包含 结尾 空白 。 


如 果 没 有 使 用 Fx ， to_timestamp 和 to_date 在 转换 字符 串 的 时 候 忽 略 多 个 空白 。 比 
如 to_timestamp('2000 JUN', 'YYYY MON') 是 正确 的 ， 但 
是 to_timestamp('2000 JUN', 'FXYYYY MON') 会 返回 一 个 错误 ， 因 为 to_timestamp 只 预料 


会 有 一 个 空白 。 Fx 必须 做 为 模板 里 的 第 一 个 项 声明 。 


在 tochar 模板 里 可 以 有 普通 文本 ， 并 且 它 们 会 被 逐 字 输出 。 你 可 以 把 一 个 字符 串 放 到 
双 引 号 里 强迫 它 解 释 成 一 个 文本 ， 即 使 它 里 面包 含 模式 关键 字 也 如 此 。 上 比 
如 '"Hello Year "YYYY' 中 的 YYYY SARE DEER, 但 是 Year 里 单独 的 会 。 


在 to_date , to_number 和 to_timestamp 里 ， 加 双 引 号 的 字符 串 忽略 包含 在 字符 串 中 的 
输入 字符 的 数量 ， 例如 ， "xx" 忽略 两 个 输入 字符 。 


如 果 你 想 在 输出 里 有 双 引 号 ， 那 么 你 必须 在 它们 前 面 放 反 斜 枉 ， 比 


如 '\"yyyy Month\"' o 


如 果 年 份 的 格式 规范 少 于 四 个 字 节 ， 例 如 YYy ， 并 且 提 供 的 年 份 少 于 四 个 字 节 ， 那么 年 
份 籽 调整 为 接近 于 2020， 例 如 95 成 为 1995。 


如 果 你 使 用 的 年 份 长 于 4 位 字符 ， 那么 用 Yyyy 从 字符 串 向 timestamp 或 date 做 转换 时 
要 受到 限制 。 你 必须 在 vwy 后 面 使 用 一 些 非 数 字 字符 或 者 模板 ， 否 则 年 份 总 是 解释 为 4 
位 数字 。 比 如 对 于 20000 年 : to_date('200001131', 'YYYYMMDD') 将 会 被 解释 成 一 个 4 
位 数字 的 年 份 ， 最 好 在 年 后 面 使 用 一 个 非 数字 的 分 隔 符 ， 


{R to_date('20000-1131', 'YYYY-MMDD') 或 to_date('200Q0Nov31', 'YYYYMonDD') o 


在 从 字符 串 向 timestamp 或 date 转换 的 时 候 ， 如 果 有 vy, vvvy 或 YYYY SER, AB 
么 cc 字段 会 被 忽略 。 如 果 cc 与 YY Ry 一 起 使 用 ， 那么 年 份 用 指定 的 世纪 计算 。 如 
果 指 定 了 世纪 而 没有 指定 年 ， 那 么 假设 使 用 这 个 世纪 的 第 一 年 。 


ISO 周 时 间 (有 别 于 公历 日 期 可 以 用 下 面 的 两 种 方法 之 一 声明 为 


to_timestamp 和 to_date : 


o 年 ， 周 和 工作 日 : 例如 to_date('2006-42-4'，'IYYY-IW-ID') WEA BA 2006-10-19 o 
如 果 你 省 略 工 作 日 ， 那 么 它 假设 为 1 (星期 一 ) 。 


o 年 和 一 年 中 的 日 : 例如 to_date('2006-291', 'ryyY-IDDD') 返回 2006-10-19 o 


试图 用 ISO 周 和 公历 日 期 字段 混合 构造 日 期 是 没有 意义 的 ， 并 且 将 导致 一 个 错误 。 在 ISO 
年 的 范围 ，" 月 "和 "月 中 的 天 "的 概念 没有 意义 。 在 公历 年 的 范围 ，ISO 周 没有 意义 。 用 户 
应 该 避免 混合 公历 和 |SO 日 期 规范 。 


将 字符 串 转化 为 timestam 时 ， 上 毫秒 ( ms ) 和 微 秒 ( us ) 都 是 用 小 数 点 后 面 的 位 数 转换 
的 。 比如 to_timestamp('12:3', 'SS:MS') 不 是 3 ZH, 而 是 300 毫秒 ， 因为 转换 把 它 看 
做 12+0.3 秒 。 这 意味 着 对 于 格式 ss:ms MS, MAM 12:3 , 12:30 , 12:300 声明 了 相 
同 的 毫秒 数 。 对 于 3 毫秒 ， 你 必须 使 用 12:663 ， 那么 转换 会 把 它 看 做 12+0.003 = 
12.003 秒 。 


这 个 更 复杂 的 例子 to_timestamp('15:12:02.020.001230', 'HH:MI:SS.MS.US') 是 15 小 时 、 
12 分 钟 、2 秒 +20 毫 秒 +1230 微 秒 = 2.021230 秒 。 


to_char(...，'ID') 的 星期 编号 匹配 extract(isodow from...) PAR, 18 
是 to_char(...，'D') 的 星期 编号 不 匹配 extract(dow from...) 的 天 编号 。 


to_char(interval) 将 HH 和 HH12 格式 化 为 12 小 时 ， 也 就 是 需 时 和 36 时 输出 是 12 ， 
而 HH24 可 以 输出 完整 的 小 时 数 ， 时 间 间 隔 可 以 超过 23。 


Table 9-23 显 示 了 用 于 数值 格式 化 的 模板 模式 。 
Table 9-23. 数值 格式 化 的 模版 模式 


模式 描述 
9 带 有 指定 数值 位 数 的 值 
o 带 前 导 需 的 值 
， (句点 ) 小 数 点 
， (去 号 ) DAF) 分 隔 符 
PR 尖 括 号 内 负 值 
S 带 符号 的 数值 (使 用 区 域 设置 ) 
L 货币 符号 (使 用 区 域 设置 ) 
D 小 数 点 (使 用 区 域 设 置 ) 
G 分 组 分 隔 符 (使 用 区 域 设置 ) 
MI 在 指明 的 位 置 的 负 号 (如 果 数 字 < 0) 
PL 在 指明 的 位 置 的 正 号 (如 果 数 字 > 0) 
SG 在 指明 的 位 置 的 正 / 负 号 
RN 罗马 数字 (输入 在 1 和 3999 之 间 ) 
TH Or th 序数 后 级 
v 移动 指定 位 (小 数 )( 参 阅 注解 ) 
EEEE 引 数 为 科学 记 数 法 


数字 格式 化 的 用 法 须知 : 


。 使 用 sc, pL, mi 生成 的 符号 并 不 挂 在 数字 上 面 ; 比如 ， to_char(-12，'MI9999') Æ 
成 '- 12' ; 但 是 to_char(-12, 's9999') ' -12! 。Oracle 里 的 实现 不 允许 在 9 前 面 使 
用 MI ， 而 是 要 求 9 在 MI 前 面 。 


。 9 声明 和 9 的 个 数 相同 的 数字 位 数 的 数值 。 如 果 某 个 数值 位 没有 数字 ， 则 输出 一 个 空 
白 。 


TH 不 会 转换 小 于 需 的 数值 ， 也 不 会 转换 小 数 。 


e pL, sc, TH 是 PostgreSQL 扩 展 。 


v 方便 地 把 输入 值 乘 以 16^*`n ， 这 里 on BRE v 后 面 的 数字 。 to_char 不 支持 
把 v 与 一 个 小 数 点 组 合 在 一 起 使 用 (也 就 是 说 99.9ve99 是 不 允许 的 )。 


EEEE 《科学 记 数 法 ) 不 能 和 任何 其 他 格式 化 的 模式 或 修饰 符 以 外 的 数字 和 小 数 点 模式 混 
合 使 用 ， 并 且 必 须 在 格式 化 字符 串 的 后 面 ( 例 如， 9.99EEEE 是 合法 的 模式 ) o 


一 定 的 修饰 符 可 以 应 用 于 任何 模板 模式 来 改变 其 行为 。 例 如 ， 


饰 符 。 Table 9-24 显 示 了 数字 格式 的 修饰 符 模式 。 


Table 9-24. 数字 格式 的 模板 模式 修饰 符 


修饰 符 
FM 前 组 
TH 后 组 


th 后 组 


描述 
填充 模式 (抑制 填充 空白 和 尾随 雳 ) 
大 写 顺 序数 后 缀 
小 写 顺序 数 后 级 


Table 9-25 显 示 了 一 些 to_char KANAB. 


Table 9-25. to char 示例 


to_char(current_timestamp, 


to_char(current_timestamp, 


to_char(-0.1, 
to_char(-0.1, 
tochar (omi, 
toschan(d27 
toschan(d2y 
to_char (485, 
to_char(-485, 
to_char (485, 
to_char (1485, 


to_char (1485, 


表达 式 

'Day，DD HH12:MI:SS') 
'FMDay, FMDD HH12:MI:SS') 
'99.99') 

'FM9.99') 


'9.9') 


"9990999.9') 


"FM9990999.9') 


'999') 
'999') 
O O OT) 
'9,999') 


'9G999') 


to_char (148.5, 
to_char (148.5, 
to_char (148.5, 
to_char (148.5, 


to_char (3148.5, 


'999.999') 
'FM999.999') 
'FM999.990') 
'999D999') 


"9G999D999') 


to_char(-485, 
to_char(-485, 
to_char (485, 
to_char (485, 
to_char (485, 
to_char (485, 


to_char(-485, 


'999S') 
'999MI') 
'999MI') 
'FM999MI' ) 
'PL999') 
'SG999') 


'SG999') 


FM9999 是 9999 模式 和 Fm 修 


示例 
FM9999 
999TH 


999th 


结果 
"Tuesday , 06 05:39:18' 
"Tuesday, 6 05:39:18' 
D =,10' 
Hani 
Or 
" 0012.0 
"0012." 
" 485' 
"-485' 
ual Gy 3 
Eas! 
ual els)" 
~ 148.500! 
2141925% 
'148.500' 
" 148.500" 
' 3,148.500' 
'485-' 
'485-' 
VAS 5au 
"485 
"+485' 
"+ 485! 


" -485 


to_char(-485, '9SG99') "4-85! 


to_char(-485, '999PR') '&lt;485&gt; ' 
to_char(485, 'L999') "DM 485 
to_char(485, 'RN') ' CDLXXXV' 
to_char(485, 'FMRN') "CDLXXXV' 
to_char(5.2, 'FMRN') SAVY 

to_char(482, '999th') ' 482nd' 
to_char(485, '"Good number:"999' ) "Good number: 485' 
to_char(485.8, '"Pre:"999" Post:" .999') "Pre: 485 Post: .800' 
to_char(12, '99V999') ' 12000' 
to_char(12.4, '99V999') " 12400' 
to_char(12.45, '99V9') Te sso 


to_char(0.0004859, '9.99EEEE' ) ' 4,86e-04' 


9.9. 时 间 / 日 期 琅 数 和 操作 符 


Table 9-27 显 示 了 可 以 用 于 义理 日 期 /时 间 数 值 的 本 数 ， 随后 一 节 里 描述 了 细节 。Table 9-26 
演示 了 基本 算术 操作 符 的 行为 ( + ,* , 等 )。 而 与 格式 化 相关 的 函数 ， 可 以 参考 Section 9.8。 
你 应 该 很 熟悉 Section 8.5 的 日 期 /时 间 数 据 类 型 的 背景 知识 。 


所 有 下 述 函 数 和 操作 符 接收 的 time 或 timestamp 输入 实际 上 都 来 自 两 种 可 能 : 
另外 一 种 是 接 

收 time without time zone 或 timestamp without time zone o 出 于 简化 考虑 ， 这 些 变种 没有 
独立 显示 出 来 。 还 有 ， + 和 * 操作 符 都 是 以 可 交换 的 操作 符 对 (比如 ，date + integer 和 
integer + date) ; 我 们 只 显示 了 这 样 的 交换 操作 符 对 中 的 一 个 。 


一 种 是 接 


收 time with time zone 或 timestamp with time zone , 


Table 9-26. 日 期 /时 间 操 做 符 


SB 

作 例子 255 
符 

+ date '2001-09-28' + integer '7' date '2001-10-05' 
+ date '2001-09-28' + interval '1 hour' timestamp '2001-¢ 
+ date '2001-09-28' + time '03:00' timestamp '2001-¢ 
+ interval ‘i day' + interval '1 hour: interval '1 day € 
+ timestamp '2001-09-28 01:00' + interval '23 hours' timestamp '2001-¢ 
+ time '01:00' + interval '3 hours' time '04:00:00' 

- - interval '23 hours' interval '-23:00: 
= date '2001-10-01' - date '2001-09-28' integer '3' (day 
- date '2001-10-01' - integer '7' date '2001-09-24' 
- date '2001-09-28' - interval '1 hour' timestamp '2001-¢ 
- time '05:00' - time '03:00' interval '02:00:¢ 
- time '05:00' - interval '2 hours' time '03:00:00' 

- timestamp '2001-09-28 23:00' - interval '23 hours' timestamp '2001-¢ 
- interval '1 day' - interval '1 hour' interval '1 day - 
- timestamp '2001-09-29 03:00' - timestamp '2001-09-27 12:00' interval '1 day 1 
x 900 * interval '1 second! interval '00:15:¢ 
ag 21 * interval '1 day' interval '21 days 
double precision '3.5' * interval '1 hour' interval '03:30:¢ 
/ interval ‘1 hour! / double precision '1.5' interval '00:40:¢ 


Table 9-27. A HA/at ja] RX 


Oe 


Tee 





EEs 


`timestamp , timestamp ) 


“timestamp ) 


clock_timestamp() 


current_date 


current_time 


current_timestamp 


-date_part( 


“text , 


timestamp ) 


‘date part( 


date trunc( ~ 


“text , interval ) 


‘text 


timestamp ) 


extract ( field from timestamp’) 


extract ’( field from interval’) 


~isfinite(*~~date ) 
~isfinite( ~ timestamp ) 
“isfinite(***interval ) 


Justify days( 


`justify_hours(`` 


~justify_interval( ~~ 


“interval ) 


“interval ) 


“interval ) 


localtime 


localtimestamp 


now( ) 


statement_timestamp() 


timeofday( ) 


transaction_timestamp() 


返回 类 型 
interval 
interval 


timestamp with time zone 


date 


time with time zone 


timestamp with time zone 


double precision 


double precision 


timestamp 


double precision 
double precision 


boolean 


boolean 


boolean 
interval 


interval 


interval 


time 


timestamp 


timestamp with time zone 


timestamp with time zone 


text 


timestamp with time zone 


描述 
减 去 参数 后 的 "符号 化 " 


从 current_date RAS 
(在 午夜 ) 


实时 时 钟 的 当前 时 间 稚 
时 变化 ) ; 见 Section 9. 


当前 的 日 期 ; 
当日 时 间 ; 


当前 事务 开始 时 的 时 间 和 
Section 9.9.4 


获 取 子 域 (等 效 于 extrac 
Section 9.9.1 


获 取 子 域 (等 效 于 extrac 
Section 9.9.1 


截断 成 指定 的 精度 ; 又 
9.9.2 


获取 子 域 ; 又 见 Section 
获取 子 域 ; 
测试 是 否 为 有 穷 日 期 (不 
测试 是 否 为 有 穷 时 间 戳 ( 


AV 
测试 是 否 为 有 穷 时 间 间 l 
按照 每 月 30 天 调整 时 让 
按照 每 天 24 小 时 调整 
使 


用 justify_days 和 just 
整 时 间 间 隔 的 同时 进行 ] 
当日 时 间 ; 
当前 事务 开始 时 的 时 间 各 
Section 9.9.4 


当前 事务 开始 时 的 时 间 和 
Section 9.9.4 


实时 时 钟 的 当前 时 间 改 
9.9.4 


见 Section 


见 Section 9. 


又 见 Section 


见 Section 9 


与 clock_timestamp 18E 
— text FAB; WS 


当前 事务 开始 时 的 时 间 和 


transaction_timestamp() timestamp with time zone Section 9.9.4 


除了 这 些 画 数 以 外 ， 还 支持 SQL AY ovERLAPS 操作 符 : 


(_start1 , _end1_) OVERLAPS (_start2_, _end2_) 
(_start1_, _length1_) OVERLAPS (_start2_, _length2_) 








这 个 表达 式 在 两 个 时 间 域 (用 它们 的 终点 定义 ) 重 过 的 时 候 生 成 真 值 ， 在 不 重 过 是 生成 假 值 。 
终点 可 以 用 一 对 日 期 、 时 间 、 时 间 惟 来 声明 ; 或 者 是 一 个 后 面 跟 着 一 个 时 间 间 隔 的 日 期 、 时 
间 、 时 间 戳 。 当 提供 一 对 值 ， 不 管 先 写 开始 还 是 结束 ; ovERLAPS 自动 将 这 对 值 较 早 的 作为 开 
始 。 每 段 时 间 取 值 为 半 开 区 间 _ 开始。 &lt;= _ 时 间 alt; aR, RIE 开始 - 

和 _ 结 束 ” 相 等 ， 此 时 表示 单一 的 时 刻 。 这 意味 着 两 个 时 间 段 只 有 一 个 共同 的 端点 没有 重 受 。 


SELECT (DATE '2001-02-16', DATE '2001-12-21') OVERLAPS 
(DATE '2001-10-30', DATE '2002-10-30'); 

_Result:_ <samp class="literal">true</samp> 

SELECT (DATE '2001-02-16', INTERVAL '100 days') OVERLAPS 
(DATE '2001-10-30', DATE '2002-10-30'); 

_Result:_ <samp class="literal">false</samp> 

SELECT (DATE '2001-10-29', DATE '2001-10-30') OVERLAPS 
(DATE '2001-10-30', DATE '2001-10-31'); 

_Result:_ <samp class="literal">false</samp> 

SELECT (DATE '2001-10-30', DATE '2001-10-30') OVERLAPS 
(DATE '2001-10-30', DATE '2001-10-31'); 

_Result:_ <samp class="literal">true</samp> 


4446 interval 值 添加 到 timestamp with time zone 上 (或 从 中 减 去 ) 的 时 候 ， days 部 分 会 按照 
指定 的 天 数 增加 (或 减少 ) timestamp with time zone 的 日 期 。 对 于 横 跨 夏令 时 的 变化 (会 话 的 
时 区 设置 被 识别 为 夏 时 制 )， interval '1 day' 并 不 一 定 等 于 interval '24 hours' 。 例 如 ， 
当 会 话 的 时 区 设置 为 csT7coT 的 时 

候 timestamp with time zone '2005-04-02 12:00-07' + interval '1 day' 的 结 

是 timestamp with time zone '2005-04-03 12:00-06' , 而 将 interval '24 hours' 增加 到 相同 
的 timestamp with time zone 之 上 的 结果 则 

是 timestamp with time zone '2005-04-03 13:00-06' , 因为 csT7cDT 时 区 


在 2005-04-03 02:00 的 时 候 有 一 个 夏令 时 变更 。 


注意 age 返回 的 月 数 可 能 有 歧义 ， 因为 不 同 的 月 份 有 不 同 的 天 数 。PostgreSQL 的 方法 是 当 
计算 部 分 月 数 时 ， 采用 两 个 日 期 较 早 的 月 。 例 如 : age('2004-06-01', '2004-04-30') 使 用 4 月 
份 产生 1 mon 1 day , 当 用 5 月 分 时 产生 1 mon 2 days , 因为 5 月 有 31 天 ， 而 4 月 只 有 30 天 。 


9.9.1. EXTRACT ， date_part 


EXTRACT(_field_ FROM _source_) 





extract 图 数 从 日 期 /时 间 数 值 里 抽取 子 域 ， 上 比如 年 、 小 时 等 。 _source_ 必须 是 一 

个 timestamp ，time , interval 类 型 的 值 表达 式 ( 类 型 为 date 的 表达 式 转 换 为 timestamp , 
因此 也 可 以 用 )。 _field 是 一 个 标识 符 或 者 字符 串 ， 它 指定 从 源 数 据 中 抽取 的 域 。 extract 
EX ANI IG] XÆ % double precision 的 数值 。 下 列 数 值 是 有 效 数 据 域 的 名 字 : 


century 
世纪 


SELECT EXTRACT(CENTURY FROM TIMESTAMP '2000-12-16 12:21:13'); 
_Result:_ &lt;samp class="literal"&gt;20&1t;/samp&gt ; 
SELECT EXTRACT(CENTURY FROM TIMESTAMP '2001-02-16 20:38:40'); 
_Result:_ &lt;samp class="literal"&gt;21&1t;/samp&gt ; 


第 一 个 世纪 从 0001-01-01 00:00:00 AD 开始 ， 尽 管 那 时 候 人 们 还 不 知道 这 是 第 一 个 世纪 。 这 
个 定义 适用 于 所 有 使 用 阳历 的 国家 。 没 有 0 世纪 ， 我 们 直接 从 公元 前 1 世纪 到 公元 1 世纪 。 
如 果 你 认为 这 个 不 合理 ， 那 么 请 把 抱怨 发 给 : 梵蒂冈， 罗马 圣 彼 得 教堂 ， 教 皇 收 。 


PostgreSQL 8.0 以 前 版 本 里 并 不 遵循 世纪 的 习惯 编号 ， 只 是 把 年 份 除 以 100 。 


day 


对 于 timestamp 值 ，( 月 份 ) 里 的 日 期 (1-31) ; 对 于 interval ， 天 数 


SELECT EXTRACT(DAY FROM TIMESTAMP '2001-02-16 20:38:40'); 
_Result:_ &lt;samp class="literal"&gt;16&lt;/samp&gt ; 


SELECT EXTRACT(DAY FROM INTERVAL '40 days 1 minute'); 
_Result:_ &lt;samp class="literal"&gt;40&1t;/samp&gt ; 


decade 


年 份 除 以 10 


SELECT EXTRACT(DECADE FROM TIMESTAMP '2001-02-16 20:38:40'); 
_Result:_ &lt;samp class="literal"&gt; 200&1t; /samp&gt ; 


dow 
每 周 的 星期 号 ， 星 期 天 ( o ) 到 星期 六 ( 6 ) 


SELECT EXTRACT(DOW FROM TIMESTAMP '2001-02-16 20:38:40'); 
_Result:_ &lt;samp class="literal"&gt;5&1t;/samp&gt; 


请 注意 ， extract 的 星期 几 编 号 和 to_char(..., 'd') BAA, 


doy 


一 年 的 第 几 天 (1-365/366) 


SELECT EXTRACT(DOY FROM TIMESTAMP '2001-02-16 20:38:40'); 
_Result:_ &lt;samp class="literal"&gt;47&lt;/samp&gt ; 


epoch 


对 于 timestamp with time zone 值 而 言 ， 是 自 1970-01-01 00:00:00-00 UTC 以 来 的 秒 ) 数 ( 结 
可 能 是 负数 ) ; 对 于 date 和 timestamp AmE, ÆA 1970-01-01 00:00:00 当地 时 间 以 来 的 
PM; 对 于 interval 值 而 言 ， 它 是 时 间 间 隔 的 总 秒 数 。 


SELECT EXTRACT(EPOCH FROM TIMESTAMP WITH TIME ZONE '2001-02-16 20:38:40.12-08'); 
_Result:_ &lt;samp class="literal"&gt ;982384720.12&1t;/samp&gt; 


SELECT EXTRACT(EPOCH FROM INTERVAL '5 days 3 hours'); 
_Result:_ &lt;samp class="literal"&gt; 442800&1t ; /samp&gt; 


下 面 是 把 epoch 值 转换 回 时 间 戳 的 方法 : 


SELECT TIMESTAMP WITH TIME ZONE ‘epoch' + 982384720.12 * INTERVAL '1 second'; 


( to timestamp EX aR ET 志 上 面 的 转换 。 ) 


hour 
小 时 域 (0-23) 


SELECT EXTRACT(HOUR FROM TIMESTAMP '2001-02-16 20:38:40'); 
_Result:_ &lt;samp class="literal"&gt; 20&1t;/samp&gt ; 


isodow 
周 中 的 第 几 天 [1-7] 星期 一 : ( 1 ) 星 期 天 : (7 )。 


SELECT EXTRACT(ISODOW FROM TIMESTAMP '2001-02-18 20:38:40'); 
_Result:_ &lt;samp class="literal"&gt;7&lt;/samp&gt; 


除了 星期 天 外 ， 都 与 dow 相同 。 这 与 ISO 8601 标 准 周 中 的 第 几 天 编码 相 匹 配 。 


isoyear 


日 期 中 的 ISO 8601 标 准 年 〈 不 适用 于 间隔 ) 。 


SELECT EXTRACT(ISOYEAR FROM DATE '2006-01-01'); 
_Result:_ &lt;samp class="literal"&gt;2005&1t;/samp&gt ; 
SELECT EXTRACT(ISOYEAR FROM DATE '2006-01-02'); 
_Result:_ &lt;samp class="literal"&gt;2006&1t;/samp&gt ; 


每 个 带 有 星期 一 开始 的 周 中 包含 1 月 4 日 的 ISO 年 ， 所 以 在 年 初 的 1 月 或 12 月 下 旬 的 ISO 年 可 能 
会 不 同 于 阳历 的 年 。 见 week 获取 更 多 信息 。 


这 个 域 不 能 用 于 PostgreSQL 8.3 之 前 的 版 本 。 


microseconds 
秒 域 (包括 小 数 部 分 ) 乘 以 1,000,000 。 请 注意 它 包括 全 部 的 秒 。 


SELECT EXTRACT(MICROSECONDS FROM TIME '17:12:28.5'); 
_Result:_ &lt;samp class="literal"&gt;28500000&1t;/samp&gt; 


millennium 


FE 


SELECT EXTRACT(MILLENNIUM FROM TIMESTAMP '2001-02-16 20:38:40'); 
_Result:_ &lt;samp class="literal"&gt;3&lt;/samp&gt; 


20 世纪 (19xx 年 ) 里 面 的 年 份 在 第 二 个 千年 里 。 第 三 个 千年 从 2001 年 1 月 1 日 需 时 开始 。 
PostgreSQL 8.0 之 前 的 版 本 并 不 遵循 千年 编号 的 习惯 ， 只 是 返回 年 份 除 以 1000 。 


milliseconds 
秒 域 (包括 小 数 部 分 ) 乘 以 1000 。 请 注意 它 包 括 完 整 的 秒 。 


SELECT EXTRACT(MILLISECONDS FROM TIME '17:12:28.5'); 
_Result:_ &lt;samp class="literal"&gt;28500&1t; /samp&gt; 


minute 
分 钟 域 (0-59) 


SELECT EXTRACT(MINUTE FROM TIMESTAMP '2001-02-16 20:38:40'); 
_Result:_ &lt;samp class="literal"&gt;38&1t;/samp&gt ; 


month 


对 于 timestamp 值 ， 它 是 一 年 里 的 月 份 数 (1-12) ; 对 于 interval 值 ， 是 月 的 数目 ， 然 后 对 
12 取 模 (0-11) 

SELECT EXTRACT(MONTH FROM TIMESTAMP '2001-02-16 20:38:40'); 

_Result:_ &lt;samp class="literal"&gt;2&1t;/samp&gt; 


SELECT EXTRACT(MONTH FROM INTERVAL '2 years 3 months'); 
_Result:_ &lt;samp class="literal"&gt;3&lt;/samp&gt; 


SELECT EXTRACT(MONTH FROM INTERVAL '2 years 13 months'); 
_Result:_ &lt;samp class="literal"&gt;1&1t;/samp&gt; 


quarter 


该 天 所 在 的 该 年 的 季度 (1-4) 


SELECT EXTRACT(QUARTER FROM TIMESTAMP '2001-02-16 20:38:40'); 
_Result:_ &lt;samp class="literal"&gt;1&1t;/samp&gt; 


second 
秒 域 ， 包 括 小 数 部 分 (0-59) [1] 


SELECT EXTRACT(SECOND FROM TIMESTAMP '2001-02-16 20:38:40'); 
_Result:_ &lt;samp class="literal"&gt;40&1t;/samp&gt ; 


SELECT EXTRACT(SECOND FROM TIME '17:12:28.5'); 
_Result:_ &lt;samp class="literal"&gt;28.5&1t;/samp&gt ; 


timezone 


与 UTC 的 时 区 偏 移 量 ， 以 秒 记 。 正 数 对 上 应 UTC 东边 的 时 区 ， 负 数 对 应 UTC 西边 的 时 区 。 
(技术 角度 讲 ，PostgreSQL 使 用 UT1， 因 为 不 处 理 闽 秒 。) 


timezone_hour 

时 区 偏 移 量 的 小 时 部 分 。 
timezone_minute 

时 区 偏 移 量 的 分 钟 部 分 。 


week 


该 天 在 所 在 的 年 份 里 是 第 几 周 。1SO 8601 定义 一 年 的 第 一 周 包含 该 年 的 一 月 四 日 (ISO-8601 
的 周 从 星期 一 开始 )。 换 名 话说， 一 年 的 第 一 个 星期 四 在 第 一 周 。 


在 ISO 定义 里 ， 一 月 的 头 几 天 可 能 是 前 一 年 的 第 52 或 者 第 53 周 ， 十 二 月 的 后 几 天 可 能 是 下 
一 年 第 一 周 。 比 如 ， 2005-01-01 是 2004 年 的 第 53 周 ， 而 2006-01-01 是 2005 年 的 第 52 
fal, 2012-12-31 是 2013 年 的 第 一 周 。 建议 isoyear 字段 和 week 一 起 使 用 以 得 到 一 致 的 结 
果 。 


SELECT EXTRACT(WEEK FROM TIMESTAMP '2001-02-16 20:38:40'); 
_Result:_ &lt;samp class="literal"&gt; 7&lt;/samp&gt; 


year 
年 份 域 。 要 记 住 这 里 没有 oa, PAM Ap 年 里 抽取 Bc 年 应 该 小 心 些 。 


SELECT EXTRACT(YEAR FROM TIMESTAMP '2001-02-16 20:38:40'); 
_Result:_ &lt;samp class="literal"&gt;2001&1t;/samp&gt ; 


extract HME BMRSEB, 对 于 用 于 显示 的 日 期 /时 间 数 值 格式 化 ， 参 阅 Section 9.8. 


date_part 图 数 是 在 传统 的 Ingres EN AAV ah E rol VE BY (7X HS MF SQLs EH 
数 extract ) : 


date_part('_field_', _source_) 





请 注意 这 里 的 _field 参数 必须 是 一 个 字符 串 值 ， 而 不 是 一 个 名 字 。 ARH date_part 数 域 
名 和 extract 是 一 样 的 。 


SELECT date_part('day', TIMESTAMP '2001-02-16 20:38:40'); 
_Result:_ <samp class="literal">16</samp> 


SELECT date_part('hour', INTERVAL '4 hours 3 minutes'); 
_Result:_ <samp class="literal">4</samp> 


9.9.2. date _trunc 


date_trunc BAERS LA RFREY trunc PHAN # LL, 


date_trunc('_field_', _source_) 





_source_ 是 timestamp 或 interval 类 型 的 值 表达 式 ( date 和 time 类 型 的 值 都 分 别 自动 转换 
成 timestamp 或 interval )。 用 _field 选择 对 该 时 间 稚 值 用 什么 样 的 精度 进行 截断 。 返 回 

的 数值 是 timestamp 或 interval 类 型 ， 所 有 小 于 选 定 的 精度 的 域 都 设置 为 震 ( 日 期 和 月 份 域 

则 为 1)。 


_field 的 有 效 数值 是 : 


microseconds 
milliseconds 
second 
minute 

hour 

day 

week 

month 
quarter 

year 

decade 
century 


millennium 


例子 : 


SELECT date_trunc('hour', TIMESTAMP '2001-02-16 20:38:40'); 
_Result:_ <samp class="literal">2001-02-16 20:00:00</samp> 


SELECT date_trunc('year', TIMESTAMP '2001-02-16 20:38:40'); 
_Result:_ <samp class="literal">2001-01-01 00:00:00</samp> 


9.9.3. AT TIME ZONE 


AT TIME ZONE 构造 允许 把 时 间 惟 转换 成 不 同 的 时 区 。 Table 9-28 显 示 了 其 变 体 。 


Table 9-28. AT TIME zone %4% 


RAA 返回 类 型 描述 
timestamp without time zone i ee ae AO 
AT TIME ZONE BESTT imestamp wi ime zone 的 时 间 惟 转换 成 给 
定时 区 的 时 间 惟 
把 给 出 的 带 时 区 的 
timestamp with time zone AT timestamp without time zone 时 间 惟 转换 成 未 指 
TIME ZONE _zone_ 定时 区 的 时 间 惟 
| 把 给 出 的 带 时 区 的 
time with time zone AT TIME E STE 时 间 转 换 成 给 定时 
ZONE _zone_ 区 的 时 间 


在 这 些 表达 式 里 ， _zone_、 可 以 声明 为 文本 串 ( 比 如 ‘pst ) 或 者 一 个 时 间 间 隔 ( 比 
如 INTERVAL '-08:00' )。 在 文本 的 情况 下 ， 可 用 的 时 区 名 字 在 Section 8.5.3 有 详细 描述 


例子 (假设 本 地 时 区 是 PsT8PpT ) : 
SELECT TIMESTAMP '2001-02-16 20:38:40' AT TIME ZONE 'MST'; 
_Result:_ <samp class="literal">2001-02-16 19:38:40-08</samp> 


SELECT TIMESTAMP WITH TIME ZONE '2001-02-16 20:38:40-05' AT TIME ZONE 'MST'; 
_Result:_ <samp class="literal">2001-02-16 18:38:40</samp> 


第 一 个 例子 接受 一 个 无 时 区 的 时 间 惟 然后 把 它 解 释 成 MST(UTC-7) 时 间 生 成 UTC at i Be, 
然后 把 这 个 时 间 转 换 为 PST(UTC-8) 显示 。 第 二 个 例子 接受 一 个 声明 为 EST(UTC-5) 的 时 间 
W, 然后 把 它 转 换 成 MST(UTC-7) 的 当地 时 间 。 


timezone ( _zone , _timestamp_ ) 函数 等 效 于 SQL 兼容 的 构造 _timestamp ”AT TIME 
ZONE zone 。 


9.9.4. 当前 日 期 /时 间 


PostgreSQL 提 供 许 none ABAD aA, 这 些 符合 SQL EN WAS EBABY 
前 事务 的 开始 时 刻 返 回 


CURRENT_DATE 

CURRENT_TIME 
CURRENT_TIMESTAMP 
CURRENT_TIME(_precision_) 
CURRENT_TIMESTAMP(_precision_) 
LOCALTIME 

LOCALTIMESTAMP 
LOCALTIME(_precision_) 
LOCALTIMESTAMP(_precision_) 


CURRENT_TIME 和 CURRENT_TIMESTAMP 返回 带 有 时 区 的 值 ; LocALTIME 和 LocALTIMESTAMP 返回 


不 带 时 区 的 值 。 


CURRENT_TIME ，CURRENT_TIMESTAMP ， LOCALTIME ，LOCALTIMESTAMP 可 以 有 选择 地 获 个 精度 
参数 ， 该 精度 导致 结果 的 秒 数 域 园 整 到 指定 小 数位 。 如 果 没 有 精度 参数 ， 将 给 o: 得 到 的 
全 部 精度 。 


一 些 例子 : 


SELECT CURRENT_TIME; 
_Result:_ <samp class="literal">14:39:53.662522-05</samp> 


SELECT CURRENT_DATE; 
_Result:_ <samp class="literal">2001-12-23</samp> 


SELECT CURRENT_TIMESTAMP,; 
_Result:_ <samp class="literal">2001-12-23 14:39:53.662522-05</samp> 


SELECT CURRENT_TIMESTAMP(2); 
_Result:_ <samp class="literal">2001-12-23 14:39:53.66-05</samp> 


SELECT LOCALTIMESTAMP; 
_Result:_ <samp class="literal">2001-12-23 14:39:53.662522</samp> 


因为 这 些 函 数 全 部 都 按照 当前 事务 的 开始 时 刻 返 回 结果 ， 所 以 它们 的 值 在 事务 运行 的 整个 期 
间 内 都 不 改变 。 我 们 认为 这 是 一 个 特性 : 目的 是 为 了 多 许 一 个 事务 在 "当前 时 间 " 上 有 连贯 
概念 ， 这 样 在 同一 个 事务 里 的 多 个 修改 可 以 保持 同样 的 时 i) Bk 


Note: 它 数 据 库 系统 更 频繁 地 更 新 这 些 数 值 。 


posite coe E EET 了 返回 实时 时 间 值 的 函数 ， 它们 的 返回 值 会 在 事务 中 随时 间 的 前 进而 
变化 。 这 些 不 附 合 SQL 标准 的 画 数 列表 如 下 : 


transaction_timestamp() 
statement_timestamp() 
clock_timestamp() 
timeofday( ) 

now() 


transaction_timestamp() 等 效 于 cuRRENT_TIMESTAMP ， 不 过 其 命名 准确 的 表明 了 其 含 

义 。 statement_timestamp() 返回 当前 事务 开始 时 刻 的 时 间 惟 (更 准确 的 说 是 收 到 客 户 端 最 后 
一 条 命 全 的 时 间 )。 statement_timestamp() 和 transaction _timestamp() 企 aaa ie 

命 命 里 返回 值 相同 ， 但 是 在 随后 的 命 爷 中 却 不 一 定 相 同 。 C clock_timestamp() 返回 实时 时 钟 


的 当前 时 间 戳 ， 因此 它 的 值 甚至 在 同一 条 SQL 命令 中 都 会 变化 。 timeofday() 是 一 个 历史 的 
PostgreSQL, (AF clock_timestamp(), 它 也 返回 实时 时 钟 的 当前 时 间 戳 ， 不 过 它 返 
回 一 个 格式 化 了 的 text 字符 串 ， 而 不 是 timestamp with time zone 值 。 now() 是 传统 的 
PostgreSQL 和 transaction_timestamp() 等 效 的 函数 。 


所 有 日 期 /时 间 类 型 还 接受 特殊 的 文本 值 now ， 用 于 声明 当前 的 日 期 和 时 间 ( 重 申 : 当前 事务 
的 开始 时 刻 )。 因此 ， 下 面 三 个 都 返回 相同 的 结果 : 


SELECT CURRENT_TIMESTAMP ， 
SELECT now(); 


SELECT TIMESTAMP 'now'; - incorrect for use with DEFAULT 


Tip: 在 创建 表 的 时 候 你 不 应 该 用 第 三 种 形式 声明 一 个 DEFAULT 值 。 


系统 将 在 分 析 这 个 常 
量 的 时 候 把 now 转换 为 一 个 timestamp ， 


因此 这 个 缺 省 值 就 会 变 成 创建 表 的 时 间 ! 而 前 
两 种 形式 要 到 实际 使 用 缺 省 值 的 时 候 才 计算 ， 因为 它们 是 函数 调用 。 因 此 它们 可 以 给 出 
每 次 插入 行 的 时 刻 。 





9.9.5. 延 时 执行 


下 面 的 这 个 函数 可 以 用 于 让 服务 器 进程 延 时 执行 : 


pg_sleep(_seconds_) 


pg_sleep 让 当前 的 会 话 进程 休 眼 _seconds_ PLUG FRAT. _seconds_ 是 一 
个 double precision 类 型 的 值 ， 所 以 可 以 指定 带 小 数 的 秒 数 。 例 如 : 


SELECT pg_sleep(1.5); 





Note: 有 效 的 休眠 时 间 间 陋 精 度 是 平台 相关 的 ， 通 常 0.01 秒 是 通用 的 。 休眠 的 时 间 将 至 
少 等 于 指定 的 时 间 ， 也 有 可 能 由 于 服务 器 荷载 较 重 等 原因 而 比 指定 的 时 间 长 。 


Warning 


请 确保 调用 pg_sleep 的 会 话 没 有 持 有 不 必要 的 锁 。 否则 其 它 会 话 可 能 必须 等 待 这 个 休 眼 
9 会话 释放 所 持 有 的 锁 ， 从 而 减 慢 系统 速度 。 


Notes 


[1] 如 果 操 作 系 统 实现 了 润 秒 ， 那 么 上 限 是 60 。 


9.10. VM AW 


对 于 枚 举 类 型 (描述 在 Section 8.7), 


fio 这 些 列 在 Table 9-29。 像 下 面 的 创建 枚 举 类 型 的 例子 : 


CREATE TYPE rainbow AS ENUM ('red', 


Table 9-29. Sie ARM 


PERK 
enum_first(anyenum) 


enum_last(anyenum) 


enum_range(anyenum) 


enum_range(anyenum, anyenum) 


enum_range(NULL, 'green'::rainbow) 


enum_range('orange'::rainbow, NULL) 


描述 
返回 输入 枚 举 类 型 的 第 一 个 值 
返回 输入 枚 举 类 型 的 最 后 一 个 值 


以 一 个 有 序 的 数组 的 形式 返回 输入 
枚 举 类 型 的 所 有 值 


返回 在 给 定 两 个 枚 举 值 之 间 的 范 

围 ， 作 为 一 个 有 序数 组 。 该 值 必须 
是 相同 的 枚 举 类 型 。 如 果 第 一 个 参 
数 为 空 ， 其 结果 将 从 枚 举 类 型 的 第 
一 个 值 开始 。 如 果 第 二 参数 为 空 ， 
其 结果 将 以 枚 举 类 型 的 最 后 一 个 值 


结束 。 
{red, orange, yellow, green} 


{orange, yellow, green, blue, purple} 


请 注意 ， 除 了 两 个 参数 形式 的 enum_range H, ERAAN ERA HEA, 


心声 明 的 数据 类 型 。null 或 一 个 特定 类 型 的 值 可 以 通过 ， 得 到 相同 的 结果 。 
应 用 于 表 列 或 范 数 的 参数 而 不 是 一 个 硬性 的 类 型 名 称 ， 


就 像 例 子 中 建议 的 那样 。 


有 一 些 函 数 允 许 简 洁 的 编写 没有 硬 编码 特定 的 枚 举 类 型 


‘orange', ‘yellow', 'green', 'blue', 'purple'); 


enum_firs 


enum_last 


enum_ranc 


enum_ranc 


他 们 只 天 


更 常见 于 这 些 功 能 


9.11. 几何 函数 和 操作 符 


有 许多 内 置 函 数 和 操作 符 支 持 几何 类 型 point ，box , lseg, line, path, polygon ， 
circle ， 在 Table 9-30, Table 9-31, Table 9-32 中 展示 。 


Caution 


请 注意 "相同 "操作 符 -= 表示 point , box, polygon , circle 类 型 在 一 般 意义 上 相同 。 
些 类 型 有 些 还 有 一 个 = 操作 符 ， 不 过 它 只 是 比较 相同 的 面积 。 其 它 的 标量 比较 操作 符 
( &lt;= 等 ) 也 是 为 这 些 类 型 比较 面积 。 


Table 9-30. 几何 操作 符 


@-@ 


@@ 


HH 


&lt;-&gt; 


&& 


平移 
平移 


伸缩 / 
旋转 


伸缩 / 
旋转 


交点 或 
者 交 面 


路 径 或 
多 边 形 
顶点 数 
KER 
BAK 
中 心 

第 三 个 
操作 数 
相对 第 


二 个 操 


例子 
Bos (ONO (a point. oN 


box '((0,0),(41,1))' - point '(2.0,0)' 


S 


ox '((0,0),(1,1))' * point '(2.0,0)' 


box '((0,0);,(2,2))" 7 point *(2.0,0)" 


"(tl # (Ga) 


# ACEO) Onan (sal) 


@-@ path (ONO OD 


@@ circle '((0,0),10)' 


point '(0,0)' ## lseg '((2,0),(0,2))' 


cincles (OOD elt cot circle: 1 (Sro) 15)" 


box '((0,0),(1,1))' && box '((0,0),(2,2))' 


这 


&1t;&lt; 


&gt;&gt; 


&&lt; 


&&gt; 


&lt;&lt;&#124; 


&#124;&gt;&gt; 


&&Lt;&#124， 


&#124;&&gt， 


&lt;^ 


?2&#124; 


2&#124; 


2-&#124; 
2&#124;&#124; 


@&gt 


&1t;@ 


格 在 
左 ? 


是 否 严 
格 在 
A? 


=] NIN 
ER /又 


有 延伸 
到 右 
边 ? 


=] Nan 
EG /又 


有 延伸 
到 左 
边 ? 


严格 在 
下 ? 
严格 在 
E? 
没有 延 
伸 到 上 
面 ? 
没有 延 
伸 到 下 
面 ? 
低 于 
(允许 
接触 )? 
高 于 
(允许 
接触 )? 
相交 ? 
水 平 ? 


水 平 对 


Cancle (CCONO) El lt emele unra 


cnmnclen (Sol ots Ot Clarele (GORNOD) LE 


box '((0,0),(1,1))' &&lt; box '((0,0),(2,2))' 


box '((0,0),(3,3))' &&gt; box '((0,0),(2,2))' 


box '((0,0),(3,3))' &lt;&lt;&#124; box '((3,4),(5,5))' 


box '((3,4),(5,5))' &#124;&gt;&gt; box '((0,0),(3,3))' 


box '((@,0),(1,1))' &&1t;&#124; box '((0,0),(2,2))' 


box '((0,0),(3,3))' &#124;aagt; box '((0,0),(2,2))' 


Cincle VECO; 0) rd) p eshte Sicincle: (Om 


CAE ECO 5) ys) AERA acincler (ONO 


lseg CERO EO) Die ?# box ER 2) a (27723) 


?- lseg '((-1,0),(1,0))' 


pornta GUO) 2s ponte 20/0) 


?&#124; 1lseg '((-1,0),(1,0))' 


point '(0,1)' ?&#124; point '(0,0)' 


lseg '((0,0),(0,1))' ?-&#124; lseg '((0,0),(1,0))' 
seg "((-1,0),(1,0))? 2&#124;8#124> Lseg '((-1, 2), (1,2))' 


CTEClen C002) kg tap Onl tens (ll 


pornta (1G sy) clt OCC ern (ECO Op) 32) 


1E? 


与 … 相 
同 ? 


polygon '((0,0),(1,1))' -= polygon '((1,1),(0,9))' 


Note: 在 PostgreSQL 8.2 之 前 ， 包 含 操 作 符 egt; 和 &lt;@ 被 分 别称 为 ~ 和 @ 。 RN 
反对 使 用 这 两 个 日 名 字 ( 当 前 仍然 可 以 使 用 )， 它 们 将 来 会 被 废除 。 


Table 9-31. 几何 函数 


vanea( ~ Lobject ) 


“center( Lobyject_ ) 


“diameter(***circle ) 


`height(```box ) 


-Sclosed(@ n path ) 


`isopen(```path ) 


length object. ) 


`npoints(```path ) 


`npoints(```polygon ) 


pelose( path ) 


返回 类 型 


double precision 


point 


double precision 


double precision 


boolean 


boolean 


double precision 


int 


int 


path 


NS 
党 E Bt mt 


Poa 


~ 
pa 


Sem Ros 


a 


jet Dot [ot ky 


PX BS D) S 


油 Re ARH 


Si 
2 


Ir g 


‘i 
2 


te SS 


oF Se a AR BS 


闭 


例子 


area(box '((0,0),(1,1))') 


center(box '((0,0),(1,2))') 


diameter(circle '((0,0),2.0)') 


height(box '((0,0),(4,1))') 


asclosed (patches G(O7O) (Cl 0 


isopen(path '[(0,0),(1,1),(2,9)]") 


length(path '((-1,0),(1,0))') 


npoints(path '[(0,0),(1,1),(2,0)]' 


npoints(polygon '((1,1),(0,0))') 


pclose(path '[(0,0),(1,1),(2,0)]') 


`popen(```path ) path popen(path '((0,0),(1,1),(2,0))') 


adius cine les) double precision radtus (errele (e(COMO)) :20 aw) 


`width(```box ) double precision width(box '((0,0),(1,1))') 


ADH ERR REZ 


Table 9-32. 几何 类 型 转换 函数 


EE 


~box(***circle ) 


`box(``` point 


point ) 


`box(``` polygon ) 


errele 


Canele(ee 


‘box ) 


‘point , 


double precision ) 


circlen 


‘polygon ) 


seg 603) 


‘Jseg( point 


point ) 


‘path( ~~~ polygon ) 


point’ ( double 


precision , 


precision ) 
point 
`point(`` 


`point(`` 


aponta 


`polygon( ` 


~polygon( ~~ 


~polygon( ~~ 


circle ) 


`polygon( ` 


double 


``box ) 
‘circle ) 


“1seg ) 


~polygon ) 


S 


‘circle ) 


“noes § 


“path ) 


返回 类 型 


box 


box 


box 


circle 


circle 


circle 


lseg 


lseg 


path 


point 


point 
point 


point 


point 


polygon 


polygon 


polygon 


polygon 


描述 


将 圆 转换 成 
和 矩形 


将 点 转换 成 
和 矩形 


将 多 边 形 转 
换 成 矩形 


REFS A He BX 
A 


将 圆心 和 半 
径 转 换 成 


将 多 边 形 转 
换 成 


矩形 对 角 线 
转化 成 线段 


点 转换 成 线 


又 


多 边 形 转换 
成 路 径 


和 矩形 的 中 心 
心 
线段 的 中 心 


多 边 形 的 中 
ny 


矩形 转换 成 
4 点 多 边 形 


圆 转换 成 12 
点 多 边 形 


转换 


成 =npes= 点 


多 边 形 


路 径 转 换 成 
多 边 形 


例子 


box(circle "((0,0),2-.0)') 


box(point '(0,0)', point '(1,1)') 


box(polygon '((0,0),(1,1),(2,0))') 


circle(box '((0,0),(1,1))') 


circle(point nn (O00) 270) 


circle(polygon '((0,0), (1,1), (2,0); 


Iseg(box '((-1,0),(1,0))') 


lseg(point (lO point (GLO 


path(polygon '((0,0),(1,1),(2,®))') 


point(23.4, -44.5) 


point(box '((-1,0),(41,9))") 
point (ernelems ClO); ZO) 


point(lseg '((-1,0),(1,0))") 


point(polygon '((0,0),(1,1),(2,9))' 


polygon(box '((0,0),(1,1))") 


polygon(circle '((0,0),2.0)') 


polygon(12, circle '((0,0),2.0)") 


polygon(path '((0,0),(1,1),(2,0))') 


我 们 可 以 把 一 个 point 的 两 个 组 成 部 分 当 作 索引 分 别 为 0 和 1 的 数组 元 素 进行 访问 。 比如 ， 
如 果 t.p 是 一 个 point 字段 ， 那 么 SELECT pjo] FRoM t 检索 X 座 标 


而 UPDATE t SET p[1] = ... 改变 Y 座 标 。 同 样 ， box 或 1seg 的 值 可 以 当 作 两 个 point 的 数 
组 值 看 待 。 


area 图 数 可 以 用 于 box, circle, path 类 型 。 area 加 数 操作 path 数据 类 型 的 时 候 ， 只 
有 在 path 的 点 没有 交叉 的 情况 下 才 可 用 。 上 比如 ， path 

'((0,0), (0,1), (2,1), (2,2), (1,2), (1,9), (60,9))'::PATH 是 不 行 的 ， 而 下 面 的 视觉 等 效 path 
'((0,0), (0,1), (14,1), (1,2), (2,2), (2,1), (4,1), (1,0), (0,0))'::PATH 就 可 以 。 如 果 交 叉 和 不 交 
叉 的 path 概念 让 你 糊涂 ， 那 么 把 上 面 两 个 path 都 画 在 纸 上 ， 你 就 明白 了 。 


9.12. 网 络 地 址 函数 和 操作 符 


Table 9-33 显 示 了 可 以 用 于 cidr 和 inet 的 操作 符 。 操 作 符 &lt;&lt; , alt;alt;=, 
&gt;&gt; ，&gt;&gt;= 用 于 测试 子 网 包含 : 它们 只 考虑 两 个 地 址 的 网 络 部 分 ， 忽 略 任 何 主 机 
部 分 ， 然后 判断 其 中 一 个 网 络 是 等 于 另外 一 个 还 是 另外 一 个 的 子 网 。 


Table 9-33. cidr 和 inet 操作 符 


操作 符 描述 例子 
&lt; 小 于 inet '192.168.1.5' &lt; inet '192.168.1.6' 
ule 小 于 或 等 于 inet '192.168.1.5' glt- inet ‘192.4168).1.5" 
= 等 于 inet '192.168.1.5' = inet '192.168.1.5' 
&gt;= 大 于 或 等 于 inet '192.168.1.5' &gt;= inet '192.168.1.5' 
&gt; 大 于 inet '192.168.1.5' &gt; inet '192.168.1.4' 
&lt;agt; REF inet '192.168.1.5' &lt;&gt; inet '192.168.1.4' 
&lt;alt; 包含 于 inet '192.168.1.5' &1t;&lt; inet '192.168.1/24' 
&lt;&lt;= 包含 于 或 等 于 inet '192.168.1/24' &1t;&lt;= inet '192.168.1/24' 
&gt;&gt; 包含 Inet VA92 6824/24 Rot 20t; imet li92ST6S8ERTER 5 
&gt;&gt;= 包含 或 等 于 inet '192.168.1/24' &gt;&gt;= inet '192.168.1/24' 
~ 位 非 ~ inet '192.168.1.6' 
& 位 与 inet '192.168.1.6' & inet '@.0.0.255' 
&#124; 位 或 inet '192.168.1.6' &#124; inet '0.0.0.255' 
+ 加 inet '192.168.1.6' + 25 

- Be inet '192.168.1.43' - 36 

- Be inet '192.168.1.43' - inet '192.168.1.19' 


Table 9-34 显 示 了 所 有 可 以 用 于 cidar 和 inet ESE. PNRM abbrev, host, text 主要 是 为 
了 提供 可 选 的 显示 格式 用 的 。 


Table 9-34. cidr 和 inet ŽI 


任何 ciar 值 都 能 够 被 隐 含 或 明确 的 转换 为 inet 1A, 


EEs 


`abbrev(```inet ) 


`abbrev(```cidr ) 


`broadcast(```inet ) 


`family(```inet ) 


‘host(**>*inet ) 


`hostmask(```inet ) 


*masklen(** inet ) 


`netmask(```inet ) 


`network(```inet ) 


set masklen( ~ inet 
int ) 


~set_masklen( cidr 
int ) 


text inet) 


text 


inet 


text 


inet 


inet 


cidr 


inet 


cidr 


text 


缩 导 显示 


格式 文本 


缩 导 显 示 


格式 文本 


网 络 广播 
地 址 


抽取 地 址 
族 ; 4 为 
IPv4, 6 
为 IPv6 


将 主机 地 
址 类 型 抽 
出 为 文本 


为 网 络 构 
造 主机 掩 
码 


抽取 子 网 
掩 码 长 度 


为 网 络 构 
造 子 网 掩 
码 


抽取 地 址 
的 网 络 部 
分 


为 inet 数 
值 设置 子 
AEA K 
度 


为 cidr 数 
值 设 置 子 
网 掩 码 长 


度 


把 IP 地 址 
ROHS 25 K 
度 抽 取 为 
文本 


例子 


abbrev(inet '10.1.0.0/16') 


abbrev(cidr '10.1.0.0/16') 


broadcast('192.168.1.5/24') 


famiy) 


Nost 9925108 15/A240) 


hostmask('192.168.23.20/30' ) 


masklen('192.168.1.5/24' ) 


netmask('192.168.1.5/24' ) 


network('192.168.1.5/24') 


set_masklen('192.168.1.5/24', 16) 


set_masklen('192.168.1.0/24"'::cidr, 


beh Gne ty slo2 16S saleby.) 


因此 上 述 能 够 操作 inet 值 的 函数 也 同 


样 能 够 操作 cidr o 而 将 某 些 操作 inet 和 cidr 的 函数 单独 分 隔 开 是 因为 它们 的 行为 不 
此 时 子 网 掩 码 右 侧 的 所 有 位 都 将 无 声 的 转换 为 需 以 获 


同 。 


inet 值 也 可 以 转换 为 cidr (A, 


1€ 


得 一 个 有 效 的 cidar 值 。 另外 ， 你 还 可 以 使 用 常规 的 类 型 转换 语法 将 一 个 文本 字符 串 转换 
为 inet 或 cidr 值 。 例如 : inet(`、`_expression )5% _colname_ ::cidr. 


Table 9-35 显 示 了 可 以 用 于 macaddr 类 型 的 函数 。 PBX `trunc(``macaddr ) 返 回 一 个 MAC 地 
tt, 该 地 址 的 最 后 三 个 字 节 设置 为 需 。 这 样 可 以 把 剩 下 的 前 级 与 一 个 制造 商 相关 联 。 


Table 9-35. macaddr EX aX 


i SE t 
函数 返回 类 型 |， 站 例子 
PUN 
`trunc(```macaddr ) macaddr trunc(macaddr '12:34:56:78:90:ab') 12:34: 


aa m a HE D> | on cs 


macaddr 类 型 还 支持 标准 关系 操作 符 ( sgt; , alt;= 等 ) 用 于 词法 排序 ， 和 按 位 运算 符 ( ~ ， 
& 和 1 ) 非 ， 与 和 或 。 


9.13. 文本 检索 图 数 和 操作 符 


Table 9-36, Table 9-37 和 Table 9-38 概 述 了 提供 全 文 检索 函数 和 操作 符 。 详 见 Chapter 12 
PostgreSQL 文 本 检索 功能 的 说 明 。 


Table 9-36. 文本 检索 操作 符 


操作 符 描述 示例 

tsvector PL 

@@ 配 tsquery to_tsvector('fat cats ate rats') @@ to_tsquery('cat & 
? 
A N N 

@@@ A FAB @@ 的 to_tsvector('fat cats ate rats') @@@ to_tsquery('cat ¢ 
同义词 

&H#124; &#124; 连 "aid bi2"s:tsvector &#124°8#124- "c:4d d:2 b:3"::tsveci 
fz tsvector S 

&& tsquery 与 "fat &#124; rat'::tsquery && 'cat'::tsquery 

&#124 ; &#124; tsquery 或 "fat &#124; rat'::tsquery &#124;&#124; 'cat'::tsquery 

L! tsquery JE 1! 'cat'::tsquery 

@&gt; ory ie "cat'::tsquery @&gt; ‘cat & rat'::tsquery 
各 另 一 个 ! 

&1t;@ ew a "cat'::tsquery &1t;@ ‘cat & rat'::tsquery 
含 于 ? 


Note: tsquery 的 操作 符 只 考虑 两 个 查询 列 出 的 项 的 情况 ， 忽 略 组 合 的 操作 符 。 


除了 显示 在 表 中 的 操作 符 ， 还 为 类 型 tsvector 和 tsquery 定义 了 普通 的 B-tree 比 较 操 作 符 
(=, alt; 等 ) 。 它们 对 于 文本 检索 不 是 很 有 用 ， 但 是 允许 使 用 。 例 如 ， 建 在 这 些 类 型 列 上 
的 唯一 索引 。 


Table 9-37. 文本 检索 函数 


函数 返回 类 型 描述 

ak 人 

get_current_ts_config() regconfig 获取 文本 检索 get_current_ts_col 
的 默认 配置 

“Lengthn( tsvector®) integer eo 的 单 length('fat:2,4 ci 
词 数 
tsquery 中 的 

`numnode(```tsquery ) integer 单词 加 上 操作 numnode('(fat & ri 
符 的 数量 


产 





regconfig vl _query_ text ) 


‘querytree(” query tsquery ) 


~setweight( tsvector , "char" ) 


istrip ~ tsvector ) 


~*to_tsquery([ ~~ ~_config_ 
regconfig | —query_ text ) 


om kvectonm(n sconhigE 
regconfig ,] _document_ text ) 


Sneadine( confron 
regconfig 加 | _document_ text , 
_query_ tsquery i _options_ 
text ]) 


LSsErank( ~°~_weights_ 

float4[] ,| Vector "tsvector,, 
_query_ tsquery |, 
_normalization_ integer ]) 


~ts_rank_cd([ ~~ weights. 
float4[] || Vector  tsvector , 
_query_ tsquery [ 
_normalization_ integer ]) 


~ts_rewrite( ~ query 
tsquery , _target_ tsquery 
_substitute_ tsquery ) 


~ts_rewrite( query 
tsquery , _select_ text ) 


tsvector_update_trigger() 


tsvector_update_trigger_column( ) 


tsquery 


text 


tsvector 


tsvector 


tsquery 


tsvector 


text 


float4 


float4 


tsquery 


tsquery 


trigger 


trigger 


生 tsquery 忽 
BR Hi FA 

获 

取 tsquery 可 
索引 的 部 分 


给 tsvector 的 
每 个 元 素 赋 巴 
权 值 


m 
除 tsvector 中 
的 位 置 和 权 值 


标准 化 单词 并 
转换 
为 tsquery 


减少 文档 中 的 
文本 到 


tsvector 


显示 一 个 查询 


的 匹配 项 


文档 查询 排名 


排序 文件 查询 
使 用 覆盖 密度 


替换 带 有 查询 
的 替代 目标 


从 一 


= SELECT of 


THB Bits 
做 替换 


自动 更 
新 tsvector 列 
的 触发 器 函数 
自动 更 
新 tsvector 列 
的 触发 器 本 数 


plainto_tsquery('« 


querytree('foo & 


setweight('fat:2,-: 


Sermo fat A ca 


to_tsquery('engli 


to_tsvector('engL: 


ts_headline('x y: 


ts_rank(textsearc 


ts_rank_cd('{0.1, 


ts_rewrite('a & b 


SELECT ts_rewrite 


CREATE TRIGGER .. 


CREATE TRIGGER .. 


Note: MEMNMAKRRAM, HS—TiM regconfig 参数 。 当 这 个 参数 忽略 ， 使 用 
由 default_text_search_config 指 定 的 配置 。 





Table 9-38 单 独 列 出 的 函数 ， 因为 他 们 通 
试 新 文本 检索 配置 。 


Table 9-38. XF RARR 


H 返回 类 型 
ts debug i > __conifiirg_ 
regconfig ,] _document_ text , 


OUT _alias_ text , OUT 
_description_ text , OUT 


_token_ text , OUT setof record 


_dictionaries_ 
regdictionary[ ] , OUT 
_dictionary_ regdictionary , 
OUT _lexemes_ text[] ) 
“ES _eratracy( ~~ dcta 
eer text] 
regdictionary , _token_ text ) 
‘ts _ parse( ` _parser name 
text , _document_ text , OUT 


setof record 
_tokid_ integer , OUT 


_token_ text ) 


ts parse( ~_parser_oid_ 

oid , _document_ text , OUT 
_tokid integer , OUT 
_token_ text ) 


setof record 


‘ts token type( ”parser name® 
text , OUT _tokid_ integer , 
OUT _alias_ text , OUT 
text ) 


setof record 
_description_ 


‘ts token type(” ~_parser_oid_ 
oid , OUT _tokid_ integer , 
OUT _alias_ text , OUT 
text ) 


setof record 


_description_ 


“ts_stat(°>°_sqlquery_ text , [ 

_weights_ text ,] OUT 

_word_ text , OUT _ndoc_ setof record 
integer , OUT 


integer ) 


ainenEmya 


Hit 
学 


测试 一 个 配置 


测试 一 个 数据 
字典 


测 | 试 一 个 解析 


测 | 试 一 个 解析 


由 解析 器 获取 
分 词类 型 的 定 
义 


由 解析 器 获取 
分 词类 型 的 定 
SL 


获 
EX tsvector 列 
的 统计 数据 


常 不 用 于 每 天 的 文本 检索 操作 。 它 们 有 助 于 开发 调 


ts_debug('engli: 


ts_lexize( "engl: 


ts_parse('defau: 


ts_parse(3722, 


ts_token type( 


ts_token_type(3/ 


SEStat( SELECT 


9.14. XML 函数 


EA F FE A RRA ER EARS xm 类 型 的 值 。 查看 Section 8.13 获 取 关 
于 xm 类 型 的 信息 。 像 画 数 表达 式 的 xmlparse 和 xmlserialize 用 来 转换 为 和 从 类 型 xml 转 
换 ， 不 在 这 里 重复 。 使 用 这 些 辑 数 需要 安装 与 配置 了 configure --with-libxml o 


9.14.1. 生成 XML 内 容 


一 组 函数 和 像 函 数 的 表达 式 可 用 于 从 SQL 数据 生成 XML 内 容 。 所 以 它们 特别 适合 于 查询 结果 
格式 化 成 在 客户 端 应 用 程序 处 理 的 XML 文 件 。 


9.14.1.1. xmlcomment 


xmlcomment(_text_) 


xmlcomment A A A sa 文本 中 不 能 包含 " -- "或 
A" - "的 结束 ， 这 样 的 文本 是 有 效 的 XML 注释 。 如 果 参 数 是 空 ， 结 果 是 空 。 


例子 


SELECT xmlcomment('hello'); 


xmlcomment 


9.14.1.2. xmlconcat 


xmlconcat(_xml_[, ...]) 


me xmlconcat 连接 一 个 独立 的 XML 值 列 表 来 创建 一 个 包含 XML 内 容 片段 的 单 值 。 忽略 空 
; 只 有 当 参 数 都 为 空 时 结果 是 空 。 


例子 


SELECT xmlconcat('<abc/>', '<bar>foo</bar>'); 


xmlconcat 


<abc/><bar>foo</bar> 


XML 声明 ， 如 果 存 在 ， 结 合 如 下 。 如 果 所 有 参数 使 用 相同 的 XML 版 本 声明 ， 则 在 结果 中 使 用 
版 本 。 否则 不 用 版 本 。 如 果 所 有 的 参数 值 有 独立 的 声明 值 "yes"， 然后 这 个 值 在 结果 里 使 用 。 
如 果 所 有 的 参数 值 有 独立 的 声明 ， 并 且 至 少 有 一 个 是 "no"， 然后 这 个 值 在 结果 里 使 用 。 否 则 
结果 将 没有 独立 声明 。 如 果 结 果 决 定 需要 一 个 独立 的 声明 ， 但 没有 声明 版 本 ， 将 使 用 一 个 带 
有 版 本 1.0 的 版 本 声明 ， 因 为 XML 需要 一 个 XML 声明 包含 版 本 声明 。 忽略 并 且 在 所 有 情况 下 删 
除 编 码 声 明 。 


例子 : 


SELECT xmlconcat('<?xml version="1.1"?><foo/>', '<?xml version="1.1" standalone="no"?><ba 
xmlconcat 


<?xml version="1.1"?><foo/><bar/> 


BEEE 





9.14.1.3. xmlelement 


xmlelement(name _name_ [, xmlattributes(`_value_` [AS `_attname_`] [, ... ])] [O—, conten 
Je OE 
xmlelement 表达 式 生 成 一 个 带 有 给 定名 称 ， 属 性 和 内 容 的 XML 元 素 。 





例子 : 


SELECT xmlelement(name foo); 
xmlelement 
SELECT xmlelement(name foo, xmlattributes('xyz' as bar)); 
xmlelement 
“<foo bar="xyz"/>_ 
SELECT xmlelement(name foo, xmlattributes(current_date as bar), 'cont', '‘ent'); 
xmlelement 


<foo bar="2007-01-26">content</foo> 


不 是 有 效 的 XML 元 素 和 属性 名 的 名 称 由 序列 xo 替换 有 问题 的 字符 逃逸 ， 这 里 的 
` HHHH 是 字符 的 16 进 制 形 式 的 Unicode 代 码 点 。 例 如 : 


SELECT xmlelement(name "foo$bar", xmlattributes('xyz' as "a&b")); 


xmlelement 


<foo_x0024_ bar a_x0026_b="xyz"/> 





如 果 属 性 值 是 一 个 列 引用 则 不 用 指定 明确 的 属性 名 称 ， 在 这 种 情况 下 ， 列 的 名 称 将 默认 为 属 
性 名 。 在 其 它 情况 下 ， 属 性 必须 给 予 一 个 明确 的 名 称 。 因 此 ， 这 个 例子 是 有 效 的 : 


CREATE TABLE test (a xml, b xml); 
SELECT xmlelement(name test, xmlattributes(a, b)) FROM test; 


但 是 这 些 不 是 : 


SELECT xmlelement(name test, xmlattributes('constant'), a, b) FROM test; 
SELECT xmlelement(name test, xmlattributes(func(a, b))) FROM test; 


如 果 指 定 了 元 素 内 容 ， 将 根据 它 的 数据 类 型 格式 化 。 如 果 内 容 自身 是 xm 类 型 ， 可 以 构造 复 
条 的 xml 文 档 。 例 如 : 


SELECT xmlelement(name foo, xmlattributes('xyz' as bar), 
xmlelement(name abc), 
xmlcomment('test'), 
xmlelement(name xyz)); 

xmlelement 


<foo bar="xyz"><abc/><! --test--><xyz/></foo> 


将 其 它 类 型 的 内 容 格式 化 为 有 效 的 xml 字 符 串 数据 。 这 意味 着 特殊 的 字符 <, >, 和 & 将 转化 为 实 
体 。 二 进 制 数 据 ( bytea 数据 类 型 ) 将 用 base64 或 16 进 制 编码 表示 ， 取 决 于 配置 参 

数 xmlbinary 的 设置 。 单个 数据 类 型 的 特定 行为 预计 将 发 展 为 了 使 SQL 和 PostgreSQL 数 据 类 
型 和 XML 架构 规范 一 致 ， 到 时 将 出 现 更 准确 描述 。 


9.14.1.4. xmlforest 


xmlforest(_content_ [AS ~_name_~] [, ...]) 


xmlforest 表达 式 生 成 一 个 使 用 指定 的 名 称 和 内 容 的 XML 森林 (序列 ) 元 素 。 


示例 : 


SELECT xmlforest('abc' AS foo, 123 AS bar); 


xmlforest 


<foo>abc</foo><bar>123</bar> 


SELECT xmlforest(table_name, column_name) 
FROM information_schema.columns 
WHERE table_schema = 'pg_catalog'; 


xmlforest 


<table_name>pg_authid</table_name><column_name>rolname</column_name> 
<table_name>pg_authid</table_name><column_name>rolsuper</column_name> 


«| = 








在 第 二 个 例子 可 以 看 出 ， 如 果 内 容 值 为 列 引 用 ， 元 素 名 称 可 以 省 略 。 在 这 种 情况 下 ， 默认 使 
用 列 名 。 否 则 ， 必 须 指定 名 称 。 


非法 XML 名 的 元 素 名 称 ， 像 上 面 的 xmlelement 逃逸 义理。 类 似 的 ， 内 容 数 据 逃 逸 生 成 有 效 的 
XML 内 容 ， 除非 它 已 经 是 xm 类 型 的 。 


请 注意 ， 如 果 包 含 一 个 以 上 的 元 素 ， XML 的 森林 不 是 有 效 的 XML 文档 ， 所 以 在 xmlelement 里 
面 封装 xmlforest 表达 Th Al A bE 是 有 用 的 。 


9.14.1.5. xmlpi 


xmlpi(name _target_ [, ~_content_~]) 





xmlpi 表达 式 创建 一 条 XML 处 理 指 合 。 如 果 存 在 ， 内 容 必 须 不 能 包含 字符 序列 ?&gt; o 


Mp 


示例 : 
SELECT xmlpi(name php, ‘echo "hello world";'); 


<?php echo "hello world"; ?> 


9.14.1.6. xmlroot 


xmlroot(_xml_, version _text_ | no value [, standalone yes|no|no value] ) 


xmlroot 更 改 XML 值 的 根 节 点 属性 。 如 果 指 定 一 个 版 本 ， 它 蔡 换 根 节点 的 版 本 声明 值 ;如 果 指 
定 一 个 standalone 设 置 ， 它 替换 根 节点 的 standalone 声 明 值 。 


SELECT xmlroot(xmlparse(document '<?xml version="1.1"?><content>abc</content>'), 
version '1.0', standalone yes); 


xmlroot 


<?xml version="1.0" standalone="yes"?> 
<content>abc</content> 


9.14.1.7. xmlagg 


xmlagg(_xm1_) 


MARX EHNA CHR, WR xmlagg SE-TREBM, CARRERA AAA, R 
像 xmlconcat ， 除了 连接 发 生 在 多 行 而 不 是 发 生 在 多 个 单行 的 表达 式 。 请 参阅 Section 9.20 
获取 关于 聚集 函数 的 更 多 信息 。 


示例 : 


CREATE TABLE test (y int, x xml); 
INSERT INTO test VALUES (1, '<foo>abc</foo>'); 
INSERT INTO test VALUES (2, '<bar/>'); 
SELECT xmlagg(x) FROM test; 
xmlagg 


<foo>abc</foo><bar/> 


为 了 确定 连接 顺序 ， 要 添加 一 个 oRDER BY 子 句 到 聚合 调用 ， 描述 在 Section 4.2.7. RHI: 


SELECT xmlagg(x ORDER BY y DESC) FROM test; 
xmlagg 


<bar/><foo>abc</foo> 


建议 在 之 前 的 版 本 中 使 用 下 面 非 标准 的 方法 ， 在 特例 中 可 能 仍然 有 用 : 


SELECT xmlagg(x) FROM (SELECT * FROM test ORDER BY y DESC) AS tab; 
xmlagg 


<bar/><foo>abc</foo> 


9.14.2. XML Predicates 


这 节 描 述 的 表达 式 检查 xml 值 的 属性 。 


9.14.2.1. IS DOCUMENT 


_xml_ IS DOCUMENT 


如 果 参 数 XML 值 是 一 个 合法 的 XML 文档 ， 表 达 式 Is pocuMENT 返回 真 。 否则 返回 假 (例如 ， 
内 容 片 段 ) 或 如 果 参 数 为 空 则 返回 空 。 请 参阅 Section 8.13 4 寺 取 关于 文档 和 内 容 片段 之 间 的 不 
同 。 


9.14.2.2. XMLEXISTS 


XMLEXISTS(_text_ PASSING [BY REF] _xml_ [BY REF]) 


如 果 第 一 个 参数 中 的 XPath 表达 式 返回 任何 节点 ， 那 么 函数 xmlexists ROR, 否则 返回 
假 。 (如 果 其 他 参数 是 null， 结 果 是 null。) 


示例 : 


SELECT xmlexists('//town[text() = ''Toronto'']' PASSING BY REF '<towns><town>Toronto</tow 


xmlexists 





在 PostgreSQL 中 ， BY REF 子 句 没有 影响 ， 但 是 为 了 与 SQL 的 一 致 性 和 其 他 实现 的 兼容 性 是 
允许 的 。SQL 标 准 中 ， 第 一 个 BY REF 是 必须 的 ， 第 二 个 By REF 是 可 选 的 。 也 请 注意 ，SQL 
标准 声明 xmlexists 构造 接受 XQuery 表 达 式 作为 第 一 个 参数 ， 但 是 PostgreSQL 目 前 只 接受 
XQuery 的 一 个 子 集 XPath。 


9.14.2.3. xml is well formed 


xml_is_well_formed(_text_) 
xml_is_well_formed_document(_text_) 
xml_is_well_formed_content(_text_) 








这 些 画 数 检查 text 字符 串 是 不 是 格式 良好 的 XML， 返 回 布尔 结果 。 
xml_is_well_formed_document 检查 格式 良好 的 文档 ， xml_is_well_formed_content p 
好 的 内 容 。  xml_is_well_formed 如 果 xmloption 参 数 设 置 为 ”DocuMENT 则 检查 文档 ， 如 果 设 

为 CONTENT 则 检查 内 容 。 这 意味 着 xml_is_well_formed 有 助 于 看 到 一 个 简单 到 类 型 xml A 
换 是 否 会 成 功 ， 而 另外 两 个 函数 有 助 于 看 到 相应 的 xMLPARSE 变 体 是 否 会 成 功 。 








示例 : 


SET xmloption TO DOCUMENT; 
SELECT xml_is_well_formed('<>'); 
xml_is_well_formed 


SELECT xml_is_well_formed('<abc/>'); 
xml_is_well_formed 


SET xmloption TO CONTENT; 
SELECT xml_is_well_formed('abc'); 
xml_is_well_formed 


SELECT xml_is_well_formed_document('<pg:foo xmlns:pg="http://postgresql.org/stuff">bar</p 
xml_is_well_formed_document 








SELECT xml_is_well_formed_document('<pg:foo xmlns:pg="http://postgresql.org/stuff">bar</m 





xml_is_well_formed_document 








最 后 一 个 示例 显示 了 检查 包括 命名 空间 是 否 正 确 匹 配 。 


9.14.3. 外 于 XML 


PostgreSQL 提 供 了 xpath 和 xpath_exists PORES xm 数据 类 型 的 值 ， 计 算 XPath 1.0 表 达 
式 的 结果 。 


xpath(_xpath_, _xml_ [, ~_nsarray_~]) 





xpath PEA, xtXMLiA _xml1_ 计算 XPath 表 达 式 _xpath_ ( text 4) 的 结果 。 它 返回 一 个 
XML 值 的 数组 对 应 XPath 表达 式 所 产生 的 节点 集 。 如 果 XPath 表 达 式 返 回 一 个 标量 值 而 不 是 节 
点 集 ， 那 么 返回 一 个 单个 元 素 的 数组 。 


第 二 个 参数 必须 是 一 个 完整 的 XML 文档 。 特 别 是 ， 它 必须 有 一 个 根 节 点 元 素 。 


该 范 数 的 第 三 个 参数 是 一 个 命名 空间 的 数组 映射 。 这 个 数组 应 该 是 一 个 两 维 text 数组 ， 第 
二 个 维 的 长 度 等 于 2 ( 它 应 该 是 一 个 数组 的 数组 ， 其 中 每 个 正好 包含 2 个 元 素 ) 。 每 个 数组 项 
的 第 一 个 元 素 是 命名 空间 名 称 的 别名 ， 第 二 个 元 素 是 命名 空间 URI 这 个 数组 的 别名 不 是 必 
须 提供 的 ， 与 在 XML 文档 本 身 使 用 的 相同 。 〈 换 名 话说 ， 在 XML 文档 和 在 xpath 函数 的 上 下 
文中 ， 别 名 是 /ocal) 。 


示例 : 


SELECT xpath('/my:a/text()', '<my:a xmlns:my="http://example.com">test</my:a>', 
ARRAY[ARRAY['my', 'http://example.com']]); 


{test} 
(1 row) 


处 理 默认 的 命名 空间 ， 像 下 面 这 样 做 : 


SELECT xpath('//mydefns:b/text()', '<a xmlns="http://example.com"><b>test</b></a>', 
ARRAY[ARRAY[ 'mydefns', 'http://example.com']]); 


{test} 
(1 row) 


xpath_exists(_xpath_, _xml_ [, ~_nsarray_~]) 





xpath_exists HAE xpath 函数 的 一 种 特殊 化 形式 。 这 个 函数 返回 一 个 布尔 值 表明 是 否 满足 
这 个 查询 ， 而 不 是 返回 满足 XPath 的 单个 XML 值 。 这 个 画 数 相当 于 标准 的 xMLEXIsTS ， 除 了 
它 还 对 命名 空间 映射 参数 提供 支持 。 


示例 : 
SELECT xpath_exists('/my:a/text()', '<my:a xmlns:my="http://example.com">test</my:a>', 
ARRAY[ARRAY[ 'my', 'http://example.com']]); 


xpath_exists 


9.14.4. 到 XML 的 映射 表 
下 面 的 函数 映射 关系 表 的 内 容 到 XML 值 。 可 以 料 它们 认为 XML 导 出 功能 : 


table_to_xml(tbl regclass, nulls boolean, tableforest boolean, targetns text) 
query_to_xml(query text, nulls boolean, tableforest boolean, targetns text) 
cursor_to_xml(cursor refcursor, count int, nulls boolean, 

tableforest boolean, targetns text) 


每 个 函数 的 返回 类 型 是 xml o 


table_to_xml 映射 命名 表 的 内 容 ， 作 为 参数 tol 传递 。 regclass 类 型 接受 使 用 常用 符号 的 
字符 串 标识 表 ， 包 括 可 选 的 模式 资格 和 双 引 号 。 query_to_xml 执行 查询 ， 这 个 查询 的 文本 作 
为 query 参数 传递 ， 并 映射 结果 集 。 cursor_to_xml 从 参数 cursor 指定 的 游标 中 获取 指定 


数量 的 行 。 如 果 大 数据 表 需 要 映射 ， 建 议 使 用 这 个 变 体 ， 因为 结果 值 是 通过 每 个 函数 在 内 存 
中 构建 的 。 


如 果 tableforest 是 假 值 ， 则 结果 的 XML 文档 像 这 样 : 


<tablename> 
<row> 
<columnnamei>data</columnnamei1> 
<columnname2>data</columnname2> 
</row> 
<row> 
</row> 


</tablename> 


如 果 tableforest 是 真 值 ， 结 果 是 一 个 像 这 样 的 XML 内 容 片段 : 


<tablename> 
<columnnamei>data</columnname1> 
<columnname2>data</columnname2> 

</tablename> 

<tablename> 


</tablename> 


如 果 没 有 可 用 的 表 名 ， 也 就 是 当 映 射 一 个 查询 或 游标 时 ， 第 一 个 格式 用 字符 串 table, S 
个 格式 用 row o 


这 些 格式 是 给 用 户 选 择 使 用 的 。 第 一 种 格式 是 适当 的 XML 文档 ， 在 许多 应 用 程序 中 比较 重 
要 。 如 果 结 果 值 是 稍 后 重新 组 合成 一 个 文件 ， 则 第 二 种 格式 在 cursor_to_xml WHARF 
用 。 这 些 函 数 用 来 产生 上 述 讨 论 的 XML 内 容 ， 特 别 是 xmlelement ， 可 以 用 来 党 试 更 改 结果 。 


数据 值 以 上 面 描述 的 函数 xmlelement 相同 的 方式 映射 。 
参数 nulls 取决 于 在 输出 中 是 否 包含 空 值 。 如 果真 ， 列 中 的 空 值 表示 为 : 


<columnname xsi:nil="true"/> 
这 里 的 xsi 是 XML 架构 实例 的 XML 命名 空间 前 缀 。 将 为 结果 值 添 加 一 个 适当 的 命名 空间 声 
明 。 如 果 假 ， 包 含 空 值 的 列 会 从 输出 中 简单 的 省 略 。 


参数 的 targetns 指定 想 要 结果 的 XML 命名 空间 。 如 果 没 有 特别 想 要 的 命名 空间 ， 应 传递 一 个 
空 字 符 串 。 


下 面 的 画 数 返回 描述 由 上 述 相应 的 函数 执行 映射 的 XML 架构 文档 : 


table_to_xmlschema(tbl regclass, nulls boolean, tableforest boolean, targetns text) 
query_to_xmlschema(query text, nulls boolean, tableforest boolean, targetns text) 
cursor_to_xmlschema(cursor refcursor, nulls boolean, tableforest boolean, targetns text) 


4 一 一 了 | 
重要 的 是 要 传递 相同 的 参数 以 获取 匹配 的 XML 数 据 映射 和 XML 架 构 文档 。 





下 列 函 数 在 一 个 文档 (或 森林 ) 中 生成 XML 数据 映射 和 相应 的 XML 架构 ， 联系 在 一 起 。 它 们 
在 想 要 自我 包含 和 自我 描述 结果 的 时 候 可 能 很 有 用 : 


table_to_xml_and_xmlschema(tbl regclass, nulls boolean, tableforest boolean, targetns tex 
query_to_xml_and_xmlschema(query text, nulls boolean, tableforest boolean, targetns text) 


[| 
此 外 ， 下 列 函 数 还 可 用 于 生成 类 似 整 个 模式 或 整个 当前 数据 库 的 映射 : 





schema_to_xml(schema name, nulls boolean, tableforest boolean, targetns text) 
schema_to_xmlschema(schema name, nulls boolean, tableforest boolean, targetns text) 
schema_to_xml_and_xmlschema(schema name, nulls boolean, tableforest boolean, targetns tex 


database_to_xml(nulls boolean, tableforest boolean, targetns text) 
database_to_xmlschema(nulls boolean, tableforest boolean, targetns text) 
database_to_xml_and_xmlschema(nulls boolean, tableforest boolean, targetns text) 


a — 





请 注意 这 些 可 能 产生 大 量 的 数据 ， 是 需要 在 内 存 中 建立 的 。 当 请 求 大 数据 量 的 模式 或 数据 库 
的 内 容 映 射 时 ， 可 能 值得 考虑 映射 表 分 别 蔡 代 ， 可 能 甚至 通过 游标 。 


一 个 模式 内 容 映射 的 结果 像 这 样 : 


<Schemaname> 
table1-mapping 


table2-mapping 


</schemaname> 


其 中 一 个 表 映 射 的 格式 取决 于 上 面 所 述 的 tableforest 参数 。 
一 个 数据 库 内 容 映 射 的 结果 像 这 样 : 


<dbname> 
<schemainame> 
</schemainame> 
<schema2name> 


</schema2name> 


</dbname> 


模式 映射 如 上 所 述 。 


使 用 这 些 画 数 产 生 的 输出 作为 例子 ，Figure 9-1 显 示 一 个 XSLT 样 式 表 转换 
table_to_xml_and_xmlschema 的 输出 到 HTML 文 档 ， 该 文档 中 包含 了 一 个 表 数 据 的 表格 格式 副 
本 。 以 类 似 的 方式 ， 这 些 琅 数 的 结果 可 以 转换 成 其 它 基 于 XML 的 格式 。 


Figure 9-1. XSLT 样 式 表 -- 将 SQL/XML 输 出 转换 成 HTML 


<?xml version="1.0"?> 

<xsl:stylesheet version="1.0" 
xmlns:xsl="http://www.w3.org/1999/XSL/Transform" 
xmlns:xsd="http://www.w3.org/2001/XMLSchema" 
xmLlns="http://www.w3.org/1999/xhtm1" 


<xsl:output method="xm1l" 
doctype-system="http://www.w3.org/TR/xhtml11/DTD/xhtmli-strict.dtd" 
doctype-public="-//W3C/DTD XHTML 1.0 Strict//EN" 
indent="yes"/> 


<xsl:template match="/*"> 
<xsl:variable name="schema" select="//xsd:schema"/> 
<xsl:variable name="tabletypename" 
select="$schema/xsd: element [@name=name(current())]/@type"/> 
<xsl:variable name="rowtypename" 
select="$schema/xsd:complexType[@name=$tabletypename]/xsd:sequence/xsd: 


<html> 
<head> 
<title><xsl:value-of select="name(current())"/></title> 
</head> 
<body> 
<table> 
<tr> 
<xsl:for-each select="$schema/xsd:complexType[@name=$rowtypename ]/xsd:sequenc 
<th><xsl:value-of select="."/></th> 
</xsl:for-each> 
</tr> 


<xsl:for-each select="row"> 
<tr> 
<xsl:for-each select="*"> 
<td><xsl:value-of select="."/></td> 
</xsl1:for-each> 
</tr> 
</xsl1:for-each> 
</table> 
</body> 
</html> 
</xsl:template> 


</xsl:stylesheet> 


= 





9.15. JSON 函数 和 操作 符 


Table 9-39 显 示 了 可 以 用 于 JSON (参阅 Section 8.14) 数据 的 操作 符 。 


Table 9-39. JSON 操作 符 


操作 符 


-&gt; 


-&gt; 


-&gt;&gt; 


-&gt;&gt; 


#&gt; 


#&gt;&gt; 


Aik 

VE RL 

的 类 
型 


int 


text 


int 


text 


描述 


获取 
JSON 数 
组 元 素 


获取 
JSON xt 
REE 


获取 
JSON 数 
组 元 素 
为 文本 


获取 
JSON 对 
象 字段 
为 文本 


在 指定 
的 路 径 
获取 
JSON 对 
象 


在 指定 
的 路 径 
获取 
JSON 对 
象 为 文 
本 


示例 


le SON egt;2 


(a Gal, Mio SON Cot Di 


'[1,2,3]'::json-&gt;&gt;2 


EPE Uo} 


oe ll De [Asp ot ll rome SONze ot la 2a 


bts chara [lA SONze ot eo a 


Table 9-40 显 示 了 可 以 用 于 创建 和 操作 JSON (参阅 Section 8.14) 数据 的 函数 。 


Table 9-40. JSON 支持 函数 


array_to_json(anyarray [, pretty_bool]) 


row_to_json(record [, pretty bool) 


to_json(anyelement ) 


json_array_length(json) 


json_each(json) 


key | value ----- +------- a | "foo" b | "bar" 


json 


json 


json 


int 


SETOF key text, value json 


描述 


作为 JSON 返 
组 。 一 个 

PostgreSQL: 
数组 成 为 一 人 
JSON 数 组 的 
组 。 如 

pretty_boc 
true， 将 在 维 
的 元 素 之 间 活 
换行 符 。 


作为 JSON 返 
行 。 如 

a pretty_boc 
true， 将 在 第 
元 素 之 间 添 力 
行 符 。 


作为 JSON 返 
值 。 如 果 不 是 
建 的 数组 类 亚 
ABA SHE 
类 型 转换 

为 json 类 型 
$h He EN BUY A 
EmA DpH 
Gm, RTF 
F, ras 
值 ， 其 他 的 人 
值 业 用 文本 靶 
T, 并 且 使 F 
逸 和 双 引 号 上 
其 是 合法 的 J 
类 型 。 


RERE P 
JSON 数 组 元 
数量 。 
扩展 最 外 层 世 
JSON 对 象 为 
键 / 值 对 。 


| `json_each_text(from json json)” | ~SETOF key text, value text> | 扩展 最 外 层 的 JSON 对 象 为 一 ; 


a] — : 


key | value ----- +------- a | foo b | bar 





| ~json_extract_path(from_json json, VARIADIC path_elems text[]) | `json”| 返回 由 path_e 





| ~json_extract_path_text(from_json json, VARIADIC path_elems text[])” | “text> | 返回 由 `p 
| ~json_object_keys(json)~ | ~SETOF text> | 返回 JSON 对 象 中 的 一 组 键 。 只 显示 "外 部 "对 象 。 | “json_ 
Aoo B 
json_object_keys 
f1 f2 


| `json_populate_record(base anyelement, from_json json, [, use_json_as_text bool=false]` 


党 | 






| `json_populate_recordset(base anyelement, from json json, [, use_json_as_text bool=fals 
el _# 


a | b ---+---1|23]4 





| `json_array_elements(json)` | `SETOF json” | 扩展 一 个 JSON 数 组 到 一 组 JSON 元 素 的 集合 。 | “json 


a] a iB 





value 


1 true [2,false] ~~ | 


Note: json 男 数 和 操作 符 比 输入 函数 类 型 可 以 实施 更 加 严格 的 有 效 性 需求 。 特 别 的 ， 他 
们 的 检查 更 为 紧密 ， 任何 使 用 Unicode 代 理 对 到 Unicode 基 本 多 文 种 平面 以 外 的 指定 字符 
是 正确 的 。 


Note: 这 些 函 数 和 操作 符 中 的 许多 将 转换 JSON 文 本 中 的 Unicode 逃 逸 到 相应 的 UTF8 字 符 
( 当 数 据 库 编码 为 UTF8 时 ) 。 在 其 他 编码 模式 下 ， 转 义 序 列 必 须 是 ASCII 字 符 ， 任 何其 
他 在 Unicode 逃 逸 序列 中 的 代码 点 将 导致 一 个 错误 。 通常 ， 如 果 可 能 的 话 ， 最 好 避免 
JSON 中 Unicode 逃 逸 和 非 UTF8 数 据 库 编码 混合 。 


Note: hstore 扩 展 从 hstore 转换 到 json ， 所 以 转换 了 的 hstore 值 作 为 JSON 对 象 显 
示 ， 而 不 是 字符 串 值 。 


参阅 Section 9.20KMAKREWRM json_agg 的 信息 ， json_agg 有 效 的 聚合 记录 值 为 
JSON. 


9.16. Fr Fie VF EIR 


本 节 描 述 用 于 操作 序列 对 象 的 函数 ， 也 叫 序列 生成 器 或 者 就 叫 序 列 。 序 列 对 象 都 是 

用 CREATE SEQUENCE 创建 的 特殊 的 单行 表 。 一 个 序列 对 象 通常 用 于 为 一 个 表 的 行 生 成 唯 
一 的 标识 符 。 在 Table 9-41 中 列 出 的 序列 函数 为 我 们 从 序列 对 象 中 获取 后 续 的 序列 值 提供 了 
简单 的 、 多 用 户 安全 的 方法 。 


Table 9-41. 序列 函数 


函数 EE 描述 
型 
ha E SE a ak 人 bss 
“currval( ~ “regclass ) bigint a nextval 获取 的 指定 
aan 返回 最 近 一 次 用 nextval 获取 的 任意 
lastval bigint Dan 
panne IE 序列 的 数值 
`nextval(```regclass ) bigint 递增 序列 并 返回 新 值 
`setval(```regclass , bigint ) bigint 设置 序列 的 当前 数值 
Setval( regclass , bigint , EE 设置 序列 的 当前 数值 以 
igint 
boolean ) 及 is_called 标志 


被 序列 PR BER 作 的 序列 是 用 regclass 参数 声明 的 ， 它 只 是 序列 在 pg_class 系统 表 里 面 的 
OID 。 不 过 ， 你 不 需要 手工 查找 OID ， 因 为 regclass 数据 类 型 的 输入 转换 器 会 帮 你 做 这 件 
事 。 只 要 写 出 单 引 号 包围 的 序列 名 字 即 可 ， 因此 它 看 上 去 像 文本 常量 。 要 达到 和 处 理 普 通 
SQL 名 字 的 兼容 性 ， 这 个 字符 串 将 转换 成 小 写 ， 除 非 在 序列 名 字 周 围 包含 双 引号 ， 因 此 


nextval('foo') _ 操 作 序 列 号 “foo `_ 
nextval('FOO') _ 操 作 序列 号 "foo _ 
nextval('"Foo"') _ 操 作 序 列 号 “Foo `_ 


必要 时 序列 名 可 以 用 模式 修饰 : 


nextval('myschema. foo' ) _ 操作 > myschema. foo _ 
nextval('"myschema".foo')  _ 同 上 
nextval('foo') _ 在 搜索 路 径 中 查找 `foo `_ 


参阅 Section 8.18 获 取 有 关 regclass 的 更 多 信息 。 
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Note: 在 PostgreSQL 8.1 之 前 ， 序 列 函 数 的 参数 类 型 是 text 而 不 是 regclass ， 而 上 面 
描述 的 从 文本 字符 串 到 OID 值 的 转换 将 在 每 次 调用 的 时 候 发 生 。 为 了 向 下 兼容 ， 这 个 机 
制 仍然 存在 ， 但 是 在 内 部 实际 上 是 在 函数 调用 前 隐 含 地 将 text 转换 成 regclass 实现 
的 。 


如 果 你 把 一 个 序列 函数 的 参数 写成 一 个 无 修饰 的 文本 字符 串 ， 那 么 它 将 变 成 类 型 

为 regclass 的 常量 。 因 为 这 只 是 一 个 OID ， 它 将 跟踪 最 初 标 识 的 序列 ， 而 不 管 后 面 是 
否 改名 、 模 式 是 否 变化 等 等 。 这 种 "提前 绑 定 "的 行为 通常 是 字段 缺 省 和 视图 里 面 引用 序 
列 所 需要 的 。 但 是 有 时 候 你 可 能 想 要 "推迟 绑 定 "， 这 个 时 候 序列 的 引用 是 在 运行 时 解析 
的 。 要 获取 推迟 线 定 的 行为 ， 我 们 可 以 强制 存储 为 text 常量 ， 而 不 是 regclass 常量 : 


nextval('foo'::text) _ foo” 在 运行 时 查找 _ 


请 注意 ， 推 迟 绑 定 是 PostgreSQL 版 本 8.1 之 前 唯一 可 用 的 行为 ， 因此 你 可 能 需要 在 旧 的 
应 用 里 如 此 使 用 来 保留 旧 有 的 语意 。 


当然 ， 序 列 画 数 的 参数 也 可 以 是 表达 式 。 如 果 它 是 一 个 文本 表达 式 ， 那 么 隐 含 的 转换 将 
导致 运行 时 的 查找 。 


用 的 序列 函数 有 : 


nextval 


增 序 列 对 象 到 它 的 下 一 个 数值 并 且 返 回 该 值 。 这 个 动作 是 自动 完成 的 : 即使 多 个 会 话 并 发 
运行 nextval ， 每 个 进程 也 会 安全 地 收 到 一 个 唯一 的 序列 值 。 


如 果 一 个 序列 对 象 是 带 着 缺 省 参数 创建 的 ， 那 么 对 它 连续 调用 nextval 将 返回 从 1 开始 的 后 续 
的 数值 。 其 他 的 行为 可 以 通过 使 用 CREATE SEQUENCE 命令 里 的 特殊 参数 获取 ; 参考 其 命 
倒 参 考 页 获取 更 多 信息 。 


Important: 为 了 避免 从 同一 个 序列 获取 数值 的 当前 事务 被 阻塞 ， nextval 操作 决 不 会 回 
A; 也 就 是 说 ， 一 且 一 个 数值 已 经 被 抓 走 ， 那 么 就 认为 它 已 经 用 过 了 ， 即使 调 
用 nextval 的 事务 后 面 又 退出 了 也 一 样 。 这 就 意味 着 退出 的 事务 可 能 在 序列 赋予 的 数值 
中 留 下 未 使 用 的 "空洞 "。 

currval 

在 当前 会 话 中 返回 最 近 一 次 nextval 抓 到 的 该 序列 的 数值 。 如 果 在 本 会 话 中 从 未 在 该 序列 上 


调用 过 nextval ， 那 么 会 报告 一 个 错误 。 因为 此 范 数 返回 一 个 会 话 范围 的 数值 ， 它 也 能 给 出 
一 个 可 预计 的 结果 ， 可 以 判断 其 它 会 话 是 否 执行 过 nextval HA. 


lastval 
返回 当前 会 话 里 最 近 一 次 nextval 返回 的 数值 。 这 个 男 数 等 效 于 currval ， 只 是 它 不 用 序列 
名 作为 参数 ， 它 抓 取 当前 会 话 里 面 最 近 一 次 nextval 使 用 的 序列 的 值 。 如 果 当 前 会 话 还 没有 


调用 过 nextval , 那么 调用 lastval 是 会 报错 的 。 
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setval 


重 置 序列 对 象 的 计数 器 数值 。2 个 参数 的 形式 设置 序列 的 last_value 字段 为 声明 数值 并 且 将 
其 is_called 字段 设置 为 true ， 表示 下 一 次 nextval 将 在 返回 数值 之 前 递增 该 序 

列 。 currval 报告 的 值 也 设 定 为 指定 的 值 。 在 3 个 参数 形式 里 is_called 可 以 设置 为 true 
或 false 。 设 置 为 true 和 2 参数 的 形式 影响 相同 。 如 果 你 把 它 设置 为 false ， 和 那么 下 一 
次 nextval 将 返回 这 里 声明 的 数值 而 随后 nextval 才 开 始 递增 该 序列 。 因此 在 这 种 情况 

F currval 报告 的 值 没有 改变 (这 是 8.3 之 前 版 本 的 一 个 变化 ) 。 比 如 ， 


SELECT setval('foo', 42); _ 下 次 `nextval ` 将 返回 43_ 
SELECT setval('foo', 42, true); _ 和 上 面 一 样 _ 
SELECT setval('foo', 42, false); _ 下 次 `nextval ` 将 返回 42_ 


setval 返回 的 结果 就 是 它 的 第 二 个 参数 的 数值 。 


Important: 因为 序列 是 非 事务 性 的 ， 如 果 事 务 回 滚 了 ， 由 setval 所 做 的 改变 也 不 会 取 
消 。 


9.17. RFR ix Th 


本 节 描 述 在 PostgreSQL 里 可 用 的 SQL 兼容 的 条 件 表 达 式 。 


Tip: 如 果 你 的 需求 超过 这 些 条 件 表 达 式 的 能 力 ， 你 可 能 会 希望 用 一 种 更 富 表 现 力 的 编程 
语言 写 一 个 存储 过 程 。 


9.17.1. CASE 
CASE 表达 式 是 一 种 通用 的 条 件 表 达 式 ， 类 似 于 其 它 编程 语言 中 的 if/else 语句 。 


CASE WHEN _condition_ THEN _result 
[WHEN ...] 
[ELSE ~_result_~] 

END 





CASE 子 句 可 以 用 于 任何 表达 式 可 以 存在 的 地 方 。 _condition_ 是 一 个 返回 boolean 的 表达 
式 。 如 果 条 件 的 结果 为 真 ， 那 么 cAsE 表达 式 的 结果 就 是 符合 条 件 的 _result ， 并 且 不 再 处 
理 剩余 的 case 表达 式 。 如 果 条 件 的 结果 为 假 ， 那 么 以 相同 方式 搜寻 任何 随后 的 whEN F 
句 。 如 果 没 有 wen condition 为 真 ， 那么 表达 式 的 结果 就 是 在 ELSE 子 句 里 

BY _result_. 如 果 省 略 了 ELsE 子 句 且 没 有 匹配 的 条 件 ， 结 果 为 NULL, 


一 个 例子 : 


SELECT * FROM test; 


a 
al 
2 
3 
SELECT a, 
CASE WHEN a=1 THEN '‘'one' 
WHEN a=2 THEN 'two' 
ELSE 'other' 


END 
FROM test; 


所 有 _result_ 表达 式 的 数据 的 类 型 都 必须 可 以 转换 成 单一 的 输出 类 型 。 参阅 Section 10.53 
取 更 多 细节 。 


下 面 这 个 "简单 的 " cAsE 表达 式 是 上 面 的 通用 形式 的 一 个 特殊 的 变种 : 


CASE _expression_ 
WHEN _value_ THEN _result 
[WHEN ...] 
[ELSE ~_result_~] 

END 





先 计 算 _expression 的 值 ， 然 后 与 每 个 wHEN 子 句 里 声明 的 _value 表达 式 对 比 ， 直 到 找到 
一 个 相等 的 。 如 果 没 有 找到 匹配 的 ， 则 返回 在 ELSE 子 句 里 的 _result_ (或 者 NULL)。 这 个 
类 似 于 C 里 的 switch 语句 。 


上 面 的 例子 可 以 用 简单 case 语法 来 写 : 


SELECT a, 
CASE a WHEN 1 THEN 'one' 
WHEN 2 THEN 'two' 
ELSE "other 
END 
FROM test; 


CASE 表达 式 并 不 计算 任何 对 于 判断 结果 并 不 需要 的 子 表达 式 。 比 如 ， 下 面 是 一 个 可 以 避免 
被 雳 除 的 方法 : 


SELECT ... WHERE CASE WHEN x <> © THEN y/x > 1.5 ELSE false END; 


Note: 正如 在 Section 35.6 描 述 的 那样 ， 被 IMMUTABLE Fp ic AVERETT it MU A Qt 
评估 ， 而 不 是 在 执行 时 。 这 意味 着 没有 在 查询 执行 时 评估 的 子 表达 式 的 常量 部 分 可 能 仍 
会 在 查询 计划 时 评估 。 








9.17.2. COALESCE 


COALESCE(_value_ [, ...]) 


coALESCE 返回 它 的 第 一 个 非 NULL 的 参数 值 。 如 果 所 有 参数 都 是 null 那 么 返回 null。 CRA 
于 在 显示 数据 时 用 人 缺 省 值 蔡 换 NULL 。 比 如 : 


SELECT COALESCE(description, short_description, '(none)') ... 


如 果 description FEZ ARAIR EC, Ama short_description 非 空 则 返回 它 ， 否则 返 


回 (none) o 


和 case 表达 式 一 样 ， coALESCE 只 计算 需要 用 来 判断 结果 的 参数 ; 也 就 是 说 ， 在 第 一 个 非 空 
参数 右边 的 参数 不 会 被 计算 。 这 个 符合 SQL 标准 的 画 数 提供 了 与 某 些 其 它 数 据 库 系统 中 
的 nv 和 IFNULL 类 似 的 功能 。 


9.17.3. NULLIF 


NULLIF(_value1_, _value2_) 





4 A324 value. SF _value2 时， NULLIF 才 返 回 null. AA GE] _value1 。 这 些 可 
以 用 于 执行 上 面 给 出 的 coALEScE 例子 的 反例 : 





SELECT NULLIF(value, '(none)') ... 


在 这 个 例子 中 ， 如 果 value Æ (none) 那么 返回 null， 否 则 返回 value o 


9.17.4. GREATEST and LEAST 


GREATEST(_value_ [, ...]) 


LEAST(_value_ [, ...]) 


GREATEST 和 Least IAM —SERBFREAANIREANRAMB RIN. wee 
式 必须 都 可 以 转换 成 一 个 普通 的 数据 类 型 ， 它 将 会 是 结果 类 型 (参阅 Section 10.5 获取 细节 )。 
列表 中 的 NULL 值 将 被 忽略 。 只 有 所 有 表达 式 的 结果 都 是 NULL 的 时 候 ， 结 果 才 会 是 NULL 


o 


请 注意 GREATEST 和 Least 都 不 是 SQL 标准 ， 但 却 是 很 常见 的 扩展 。 某 些 其 他 的 数据 库 在 任 
意 一 个 参数 为 NULL 时 返回 NULL， 而 不 是 所 有 参数 都 是 NULL 时 。 


9.18. 2828 Fe aA ERE RT 


Table 9-42 显 示 了 可 以 用 于 array 类 型 的 操作 符 。 


Table 9-42. Array 操作 符 


t 
操作 符 述 例子 

= 等 ARRAY[1.1,2.1,3.1]::int[] = ARRAY[1, 2,3] 
于 
不 

&lt;agt; 等 ARRAY[1,2,3] &lt;&gt; ARRAY[1,2,4] 
于 
小 

alt; 于 ARRAY[1,2,3] &lt; ARRAY[1, 2,4] 

agt; a ARRAY[1,4,3] &gt; ARRAY[1, 2,4] 
小 
于 

es 或 ARRAY[1,2,3] &lt;= ARRAY[1, 2,3] 
于 
K 
于 

agt;= 或 ARRAY[1,4,3] &gt;= ARRAY[1, 4,3] 
于 

@agt ; a ARRAY[1,4,3] @&gt; ARRAY[3,1] 
=) 

&lt;@ a ARRAY[2,7] &lt;@ ARRAY[1,7,4, 2,6] 
=) 
于 
重 
三 

&& FE ARRAY[1,4,3] && ARRAY[2, 1] 
同 
元 


+ 
a 
~x 


Um ps $e 


&#124;&#124 数 ARRAY[1,2,3] &#124;&#124; ARRAY[4,5,6] fal Oo AG 

&#124;&#124; 数 ARRAY[1,2,3] &#124;&#124; ARRAY[[4,5,6],[7,8,9]] TERESIN 
JG 

&#124;&#124; 数 3 &#124;8#124; ARRAY[4,5,6] {3,4,5, 6} 
组 


&#124;&#124; 元 ARRAY[4,5,6] &#124;&#124; 7 {4,5,6,7} 


接 


数组 比较 是 使 用 默认 的 B-Tree 比较 函数 对 所 有 元 素 逐 一 进行 比较 的 。 多 维 数 组 的 元 素 按照 行 
顺序 进行 访问 (最 后 的 下 标 变 化 最 快 )。 如 果 两 个 数组 的 内 容 相 同 但 维 数 不 等 ， 那么 决定 排序 
顺序 的 首要 因素 将 是 维 数 (原文 : the first difference in the dimensionality information 
determines the sort order), ixPostgreSQL 8.2 之 前 的 版 本 不 同 : 老 版 本 认为 内 容 相同 的 
两 个 数组 相等 ， 即 使 它们 的 维 数 或 下 标 范 围 并 不 相同 。 


参阅 Section 8.15 获 取 有 关 数 组 操作 符 行为 的 更 多 细节 。 参阅 Section 11.2 获 取 哪 个 操作 符 支 
持 索 引 操 作 的 更 多 细节 。 


Table 9-43 显 示 了 可 以 用 于 数组 类 型 的 函数 。 参阅 Section 8.15 获 取 更 多 信息 以 及 使 用 这 些 函 
数 的 例子 。 


Table 9-43. Array 2X 


EEs 返回 类 型 描述 


向 数 
组 末 
array_append`( anyarray ，anyelement ) anyarray 尾 添 
加 元 
素 


连接 


array_cat’( anyarray , anyarray’) anyarray 
array_ndims*( anyarray ) int 
array_dims ( anyarray ) text 
array_fill’( anyelement , int[] , t, int[]’]) anyarray 
array_length’( anyarray , int’) int 
array_lower*( anyarray , int) int 
array_prepend’( anyelement , anyarray’) anyarray 
array_remove’( anyarray , anyelement’) anyarray 


返回 
数组 
维 数 
的 下 
RR 


向 数 
组 开 
加 元 
Fz 


从 数 
组 中 
删除 
所 有 
等 于 
给 定 
值 的 
元 素 

( 数 


array_replace’( anyarray , anyelement , anyelement’) 


array_to_string’( anyarray , text [, text’) 


array_upper’( anyarray , int’) 


string_to_array`( text , text [, text*]) 


unnest `( anyarray’ ) 


anyarray 


text 


int 


text [i] 


setof anyelement 


在 string_to_array 中 ， 如 果 分 隔 符 参数 是 NULL， 输入 字符 串 中 的 每 个 字符 将 在 结果 数组 中 
变 成 一 个 独立 的 元 素 。 如 果 分 隅 符 是 一 个 空白 字符 串 ， 那么 整个 输入 字符 串 将 变 为 一 元 素 的 
数组 。 否 则 输入 字符 串 将 在 每 个 分 隔 字符 串 多 分 裂 。 


在 string_to_array 中 ， 如 果 省 略 null 字 符 串 参 数 或 为 NULL， 将 没有 输入 字符 串 的 子 串 被 
NULL 人 代替 。 在 array_to_string F, 如 果 省 略 null 字 符 串 参数 或 为 NULL， 在 数组 中 的 任何 
null 元 素 将 简单 的 跳 过 ， 并 且 不 再 输出 字符 串 中 出 现 。 


Note: 在 PostgreSQL 版 本 9.1 之 前 ， string_to_array 有 两 个 行为 上 的 不 同 。 第 一 ， 当 输 
入 字符 串 长 度 为 需 时 ， 它 将 返回 一 个 空 (FTR) 数组 而 不 是 NULL。 第 二 ， 如 果 分 隔 
字符 串 是 NULL 时 ， 画 数 分 隔 输入 为 单独 的 字符 ， 而 不 是 和 以 前 一 样 返回 NULL。 


也 可 以 参阅 Section 9.20 获 取 关 于 array_agg 聚集 函数 使 用 数组 的 信息 。 


{% raw %} 


9.19. 5E A HAAR E IF 
参阅 Section 8.17 获 取 范 围 类 型 的 概述 。 
Table 9-44 显 示 了 范围 类 型 可 用 的 操作 符 。 


Table 9-44. 范围 操作 符 


[=] 描 — 

操作 符 述 示例 

= 等 int4range(1,5) = '[1,4]'::int4range 
于 
不 

&lt;&gt; 等 numrange(1.1,2.2) &lt;&gt; numrange(1.1,2.3) 
于 
小 

&lt; x int4range(1,10) &lt; int4range(2,3) 

&gt; 2 int4range(1,10) &gt; int4range(1,5) 
小 
= 

&lt;= 或 numrange(1.1,2.2) &lt;= numrange(1.1,2.2) 
于 
K 
== 

&gt;= 或 numrange(1.1,2.2) &gt;= numrange(1.1,2.0) 
=> 
a 
A 

@&gt; 范 int4range(2,4) @&gt; int4range(2,3) 
> 
H 
a 
A 

&gt; ae 2011-01-01, 2011-03-01)'::tsrange @&gt; '2011-01-10'::timestam 

@ =j 1 1 @ 1 1 1 p 
JL 

&1t;@ int4range(2,4) &lt;@ int4range(1, 7) 


HP (UT BS X 


dl 


&1t;@ 


&& 


&1t;&lt; 


&gt;&gt; 


&&lt， 


&&gt; 


-&#124; - 


THP H y 


a 


Si 
2 


At At ge 


BK 


ENEFA SHAR OK DA 


>+ 
mm 


Ay 
aA 


tat 


AE Pt A 


42 &1t;@ int4range(1, 7) 


int8range(3,7) && int8range(4, 12) 


int8range(1,10) &lt;&lt; int8range(100,110) 


int8range(50,60) &gt;&gt; int8range( 20, 30) 


int8range(1,20) &&lt; int8range(18, 20) 


int8range(7,20) &&gt; int8range(5,10) 


numrange(1.1,2.2) -&#124;- numrange(2.2,3.3) 


numrange(5,15) + numrange(10, 20) 


int8range(5,15) * int8range(10, 20) 


int8range(5,15) - int8range(10, 20) 


简单 的 比较 操作 符 alt; ， agt; , &lt;= 和 agt;= 先 比 较 下 界 ， 只 有 下 界 相 等 时 才 比 较 上 
界 。 这 种 比较 通常 对 范围 不 是 很 好 用 ， 但 是 为 了 在 范围 中 人 允许 构建 B-tree 索 引 才 提供 的 。 


左 于 / 右 于 /邻近 操作 符 当 包含 空 范围 时 也 会 返回 false ; 也 就 是 ， 不 认为 空 范 围 在 其 他 范围 之 


前 或 之 后 。 


并 集 和 差 集 操 作 符 在 结果 范围 需要 包含 两 个 不 相交 的 子 范围 时 失败 ， 因 此 不 能 表示 这 样 一 个 
范围 。 


Table 9-45 显 示 了 可 以 和 范围 一 起 使 用 的 函数 。 


Table 9-45. sh H HW 


aa 返回 类 型 M 示例 结果 
PUN 
En 
7B 
t+ a= 
、 范围 元 素 
lower`( anyrange’) ae AY lower (numrange(1.1,2.2)) al sal 
F 
界 
ws 
B 
Pa H 
; 范围 元 素 
upper ( anyrange ) an AY upper (numrange(1.1,2.2)) 2s 
iz 
F 
Kaa 
rE 
H 
isempty`( anyrange`) boolean = isempty(numrange(1.1,2.2)) false 
70 
x 
的 ? 
包 
lower_inc`( anyrange ) boolean lower_inc(numrange(1.1,2.2)) true 
界 ? 
a 
= 
upper_inc`( anyrange’) boolean E upper_inc(numrange(1.1,2.2)) false 
界 ? 
T 
lower_inf`( anyrange ) boolean = lower_inf('(,)'::daterange) true 
D 
穷 ? 
上 
upper_inf`( anyrange ) boolean 7 upper_inf('(,)'::daterange) true 
D 
穷 ? 


如 果 范 围 是 空 或 者 需要 的 界限 是 无 穷 的 ， lower 和 upper 图 数 返 回 null。 lower_inc , 
upper_inc , lower_inf 和 upper_inf 豆 数 均 对 空 范围 返回 false。 


9.20. eH 


聚集 函数 从 一 组 输入 值 里 计算 一 个 结果 
SAA IRIS AE Section 4.2.7 里 解释 。 


Table 9-46. 通用 聚集 函数 
PEESI 


array_agg( expression ) 


avg( expression ) 


bit_and( expression ) 


bit_or( expression ) 


bool_and( expression ) 


bool_or( expression ) 


count (*) 


count( expression ) 


every ( expression ) 


Table 9-464 Table 9-47 显示 了 内 建 的 聚集 函数 。 聚 
TAZ + BZ Section 2: T3 甘 取 额外 的 介 绍 性 信息 INO 


参数 类 型 返回 类 型 
任意 参数 类 型 的 数组 


对 于 任何 整数 关 型 办 
A, 结果 都 
是 numeric 类 型 。 对 


于 任何 ; 浮 点 输入 ? 结 


double precision , 都 


smallint , int , 
bigint , real 


numeric , OF 
interval 


i= A 5 Se 
z= double precision 类 


J, 否则 和 输入 数据 
类 型 相同 。 


smallint , int , 
bigint , OF bit 


和 参数 数据 关 型 相同 


smaliiint ent 
bigint. Of bat 


和 参数 数据 类型 相同 


bool bool 
bool bool 
bigint 输入 行 数 
任意 bigint 
bool bool 


record json 


ZK 
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任意 数组 、 数 值 、 
max( expression ) 字符 串 、 日 期 /时 间 ”和 参数 数据 类 型 相同 
任意 数组 、 数 值 、 
min( expression ) 字符 串 、 日 期 /时 间 ”和 参数 数据 类 型 相同 


( text ，text ) or 
( bytea , bytea ) 


和 参数 数据 类 型 相同 


string_agg( expression , delimiter ) 


对 
于 smallint 或 int 输 
入 ， 输 出 类 型 


smallint , int , A bigint o 对 

bigint , real, 于 bigint 输入 ， 输 出 
sum( expression ) double precision , 类 型 为 numeric , WF 

numeric , Or 浮 点 数 输入 ， 输出 类 

interval 型 


为 double precision 。 
否则 和 输入 数据 类 型 相 
同 。 


xmlagg( expression ) xml xml 


请 注意 ， 除 了 cout UA, ZERRE RAHAA HIRE] NULL, 尤其 要 指出 的 是 sum WR 
在 没有 输入 行 时 返回 NULL, MARES. array_agg 本 数 在 没有 输入 行 时 返回 null 而 不 是 空 数 
组 。 必要 时 可 以 用 coalesce 把 NULL 蔡 换 成 雳 或 空 数组 。 


Note: bool and 和 bool_or 布尔 聚集 对 应 标准 的 SQL 聚集 every 和 any 或 some. 对 
于 any 和 some ， 标 准 语法 里 面 似乎 有 些 内 置 的 歧义 : 


SELECT bl = ANY((SELECT b2 FROM t2 ...)) FROM t1 ...; 
这 里 的 any 既 可 以 被 认为 是 引出 一 个 子 查询 ， 也 可 以 被 认为 是 一 个 聚集 (如 果子 查询 返 
回 布尔 值 的 1 行 的 话 )。 因 此 标准 的 名 字 无 法 用 于 这 些 聚 集 。 


Note: 习惯 了 其 它 SQL 数据 库 管 理 系 统 的 用 户 可 能 被 用 于 全 表 计 算 的 count 的 性 能 (之 
慢 ) 惊 住 了 。 一 个 类 似 下 面 这 样 的 查询 : 


SELECT count(*) FROM sometable; 


将 需要 努力 与 表 的 大 小 成 正比 : PostgreSQL 将 需要 扫 面 整个 表 或 包含 表 中 所 有 行 的 完整 
的 索引 。 


BRS E RESE array_agg , json_agg , 


根据 输入 值 的 顺序 产生 意义 不 同 的 结果 值 。 


string_agg 和 xmlagg ， 以 及 类 似 用 户 定义 的 聚集 范 数 ， 


数 调 用 时 ， 写 一 个 oRDER BY 子 句 来 控制 ， 


一 个 已 排序 的 子 查询 中 提供 输入 值 。 例 如 : 


这 个 顺序 默认 没有 指定 ， 但 是 可 以 通 
就 像 Section 4.2.7 描 述 的 那样 。 BA, 


SELECT xmlagg(x) FROM (SELECT x FROM test ORDER BY y DESC) AS tab; 


但 此 语法 在 SQL 标准 里 不 允许 ， 不 能 移植 到 


Table 9-47 展 示 了 用 于 统计 分 析 的 聚集 本 数 。 单独 列 出 这 


它 数据 库 系 统 。 


使 用 的 聚集 酌 数 混在 一 起 而 已 。 "描述 " 列 中 的 N 表示 所 有 栓 入 行 中 使 得 


NULL 的 行 数 。 总 的 来 说 ， 如 果 计 算 本 身 变 得 没有 意义 ， 那么 


当 _N_ A BSAA ee, 
Table 9-47. 统计 聚集 西数 


EJZ 
Conn Y XE 
covar_pop( Y, X) 


covar_samp( Y, X ) 


regr_avgx( Y , X ) 


regr_avgy( Y, X) 


regr_count( Y , X ) 


regr_intercept( Y, X) 


reg r2 Y, X) 


regr_slope( Y, X) 


regr_sxx( Y, X ) 


参数 类 型 


double 


double 


double 


double 


double 


double 


double 


double 


double 


double 


precision 
precision 


precision 


precision 


precision 


precision 


precision 


precision 


precision 


precision 


it FRE 

通常 可 以 从 

WA Rie vy SGA ABLE 

输入 表达 ra 

ei 例如 
返回 类 型 f 
double precision 相关 系数 
double precision 总 体 协 方 
double precision 样本 协 方 
double precision 自 变 量 的 
(sm 
double precision nEs t 
( sum(、 
ne 两 个 表达 
bigint NULL 的 : 
根据 所 有 
(g 
double precision n 
后 返回 该 

轴 截 距 

double precision 相关 系数 
根据 所 有 
E3 £ 
double precision 2 
后 返回 该 

率 。 
sum(``_X 
double precision sum( D 


( 自 变量 的 


regr_sxy( Y, X ) 


regr_syy( Y, X ) 


stddev( expression ) 


stddev_pop( expression ) 


stddev_samp( expression ) 


variance ( _expression_ ) 


var_pop ( _expression_ ) 


var_samp ( _expression_ ) 


double precision 


double precision 


Smalilinite, Vanities, 
bigint , real , 

double precision 
或 numeric 


smalkintt nt 
bigint , real , 

double precision 
或 numeric 


smallint , int , 
bigint, real, 

double precision 
或 numeric 


smaltime Int., 
bigint , real , 

double precision 
或 numeric 


smallint , int , 
bigint ， real ， 

double precision 
或 numeric 


Smadihiinite. ene, 
bigint , real , 

double precision 
或 numeric 


double precision 


double precision 


对 于 浮 点 类 型 的 输入 返 
回 double precision , 


其 他 输入 返回 numeric 


对 于 浮 点 类 型 的 输入 返 
回 double precision , 


其 他 输入 返回 numeric 


对 于 浮 点 类 型 的 输入 返 
回 double precision , 


其 他 输入 返回 numeric 


对 于 浮 点 类 型 的 输入 返 
回 double precision ， 


其 他 输入 返回 numeric 


对 于 浮 点 类 型 的 输入 返 
回 double precision , 


其 他 输入 返回 numeric 


对 于 浮 点 类 型 的 输入 返 
回 double precision , 


其 他 输入 返回 numeric 


sum(``_X 
sum( _x_ 
Sum( _Y_ 
( 自 变量 和 和 
AY" Fe 75 4 


sume ~_Y 
sum( Y 


(Al £ ÆR 


stddev_s 


名 (历史 所 


总 体 标 准 


样本 标准 


var_samp 


(历史 原 医 


总 体 方差 
差 的 平方 


样本 方差 
差 的 平方 


9.21. 窗口 函数 


窗口 范 数 提供 跨行 相关 的 当前 查询 行 集 执 行 计 算 的 能 力 。 参阅 Section 3.5 获 取 这 个 特性 的 介 


绍 


o 


Table 9-4871 H 7 ANAONA FRAP RO BRIG a ER; 一 
个 ovER 子 句 是 必需 的 。 


除了 这 些 本 数 外 ， 任 何 内 建 的 或 用 户 定义 的 聚集 画 数 都 可 以 作为 窗口 西数 ( 见 Section 9.20 关 
FABRA NAAR) 。 仅 当 调 用 跟着 over 子 句 的 聚集 画 数 ， 作 为 窗口 画 数 ; 否则 它们 
作为 常规 的 聚合 。 


Table 9-48. AROMA 


EEs 返回 类 型 描述 


在 其 分 区 中 的 当前 行 号 ， 从 1 
计 

有 间隔 的 当前 行 排名 ; SE 
rank() bigint 的 第 一 个 相同 行 

的 row_number 相同 


没有 间隔 的 当前 行 排名 ; 这 
SHE it Blt 28. 


当前 行 的 相对 排名 : ( rank - 
1) / (总 行 数 - 1) 


当前 行 的 相对 排名 : (前 面 的 
cume_dist() double precision 行 数 或 与 当前 行 相 同 的 行 
数 )/( 总 行 数 ) 


m ; 从 1 到 参数 值 的 整数 范围 ， 尽 
ntile( num_buckets ‘integer ) integer 可 能 相等 的 划分 分 区 。 


row_number() bigint 


dense_rank() bigint 


percent_rank() double precision 


计算 分 区 当前 行 的 

前 _offset_ 47, i& 

E] value > MRIRAKH 

的 行 ， 返回 _default_ 蔡 

lag( value ‘any [, _offset_ n 代 于 后 

integer [, _default_ any ]]) . 一 ns 都 是 当前 行 计算 的 结果 如 
RART, N) _offset_ 默认 
是 1， _default 默认 是 
null, 


计算 分 区 当前 行 的 
后 _offset_ 行 ， 返 
回 _value_ o 如 果 没 有 这 样 
的 行 ， 返回 _default_ 蔡 
lead( value ‘any [, _offset__ * FU *_value_ 代 ee a 
integer [, _default_ any ]]) 都 是 当前 行 计算 的 站 果 A 
RØKT, N) _offset 默认 
是 1， _default 默认 是 
null, 


返回 窗口 第 一 行 的 计 


first_value( value `any Y 类 型 同 ``_value_ 
算 _value 值 。 


last_value( value ‘any Y 类 型 同 ``_value_ AA 

、 返回 窗口 第 oth 行 的 计算 

a value ~any , _nth_ xap value A ( 行 从 1 计数 ) . 
4 没有 这 样 的 行 则 返回 null 

在 Table 9-48 列 出 的 所 有 男 数 ， 依赖 于 与 窗口 定义 有 关 的 oRDER BY 子 句 指定 的 排序 。 同行 是 

说 在 oRDER BY 排序 时 不 唯一 的 行 。 定义 的 这 四 个 排名 函数 ， 对 于 任何 两 个 同行 的 答案 相同 。 


注意 first_value, last_value, # nth value 只 考虑 "window frame" 内 的 行 ， 其 默认 情 ; 

下 ， 包 含 从 分 区 的 开始 行 直到 当前 行 的 最 后 同行 。 像 last_value 和 nth_value 有 时 会 给 出 没 
有 用 的 结果 。 您 可 以 通过 向 over 子 名 添加 合适 的 框架 规范 ( RANGE 或 者 Rows ) 来 重新 定 
义 该 框架 。 参 阅 Section 4.2.8 获 取 框 架 定义 的 信息 。 


当 一 个 聚集 酌 数 作为 窗口 本 数 使 用 时 ， 将 聚合 超过 当前 行 的 窗 框 内 的 行 。 一 个 使 

用 oRDER BY 和 默认 窗 框 定义 处 理 " 运 行 时 求 和 "类 型 的 行为 的 聚集 函数 ， 可 能 不 是 想 要 的 结 
果 。 为 了 获取 超过 整个 分 区 聚合 ， 忽 略 oRDER BY 或 者 使 

用 Rows BETWEEN UNBOUNDED PRECEDING AND UNBOUNDED FOLLOWING 。 其 它 窗 框 规格 可 以 用 来 获取 


其 它 的 效果 。 


Note: SQL 标准 为 lead ，1lag ，first_value , last_value ,和 nth_value 定义 了 一 

个 RESPECT NULLS 或 IGNORE NULLS 选项 。 这 个 在 PostgreSQL 没 有 实现 : 行为 总 是 与 标准 
默认 相同 ， 即 respect NULLS o 同样 用 于 nth_value idle FROM FIRST 或 FROM LAST 选 
项 也 没有 实现 : 只 支持 默认 FRM FIRST 行为 。 (您 可 以 通过 orr BY 排序 取 反 获取 


到 FROM cast 的 结果 。) 


9.22. 子 查询 表达 式 


本 节 描 述 PostgreSQL 里 面 与 SQL 兼容 的 子 查询 表达 式 。 所 有 本 节 中 的 表达 式 都 返回 布尔 值 
(BR) 2 Ro 


9.22.1. EXISTS 


EXISTS (_subquery_) 


Exists 的 参数 是 一 个 任意 的 sELECT 语句 ， 或 者 说 子 查询 。 有 系统 对 子 查询 进行 运算 以 判断 它 
是 否 返 回 行 。 如 果 它 至 少 返 回 一 行 ， 那 么 exists 的 结果 就 为 " 真 " ; 如 果子 查询 没有 返回 任何 
行 ， 那 么 ExIsTs 的 结果 是 " 假 "。 


子 查询 可 以 引用 包围 它 的 查询 的 变量 ， 这 些 变 量 在 该 子 查询 的 每 一 次 计算 中 都 起 常量 的 作 


这 个 子 查询 通常 只 是 运行 到 能 判断 它 是 否 可 以 生成 至 少 一 行为 止 ， A i 在 
这 里 写 有 副作用 的 子 查询 是 不 明智 的 (比如 调用 序列 函数 ) ; 这 些 副作用 是 否 发 生 是 很 难 判 断 
的 。 


因为 结果 只 取决 于 是 否 会 返回 行 ， 而 不 取决 于 这 些 行 的 内 容 ， 所 以 这 个 子 查 询 的 输出 列表 通 
常 是 无 关 紧 要 的 。 一 个 常用 的 编码 习惯 是 用 下 面 的 形式 写 exists 测 

jX : EXISTS(SELECT 1 WHERE ...) o 不 过 这 条 规则 也 有 例外 ， 比 如 那些 使 用 intersect WA 
询 。 


下 面 这 个 简单 的 例子 类 似 在 col2 上 的 一 次 内 连接 ， 但 是 它 为 每 个 tabl 的 行 生 成 最 多 一 个 输 
出 ， 即使 存在 多 个 匹配 tab2 的 行 也 如 此 : 


SELECT coli 
FROM tabi 
WHERE EXISTS (SELECT 1 FROM tab2 WHERE col2 = tab1.col2); 


9.22.2. IN 


_expression_ IN (_subquery_) 


右边 是 一 个 圆 括 弧 括 起 来 的 子 查询 ， 它 必须 只 返回 一 个 字段 。 左边 表达 式 对 子 查询 结果 的 每 
一 行进 行 一 次 计算 和 上 比较。 如 果 找 到 任何 相等 的 子 查询 行 ， 则 IN 结果 为 " 真 "。 如 果 没 有 找到 
任何 相等 行 ， 则 结果 为 " 假 " (包括 子 查询 没有 返回 任何 行 的 情况 )。 


请 注意 ， 如 果 左 边 表达 式 的 值 为 NULL ， 或 者 没有 相等 的 右边 值 并 且 至 少 有 一 个 右边 行 生 成 
NULL, 那么 IN 的 结果 将 是 NULL ， 而 不 是 假 。 这 个 行为 遵照 SQL 处 理 布尔 值 和 NULL 组 
合 时 的 规则 。 


和 exists 一 样 ， 假 设 子 查询 将 被 完全 运行 是 不 明智 的 。 


_row_constructor_ IN (_subquery_) 


左边 是 一 个 行 构造 器 (如 Section 4.2.13 所 述 )， 右 边 是 一 个 圆 括 弧 括 起 来 的 子 查询 ， 它 必 须 返 
回 和 左边 行 构造 器 一 样 多 的 字段 。 左 边 表达 式 对 子 查询 结果 的 每 一 行进 行 一 次 计算 和 上 比较 。 
如 果 找 到 相等 的 子 查询 行 ， 则 IN 结果 为 " 真 "。 如 果 没 有 找到 任何 相等 行 ， 则 结果 为 " 假 "(包括 
子 查 询 没 有 返回 任何 行 的 情况 )。 


表达 式 或 子 查询 行 里 的 NULL 遵照 SQL 处 理 布尔 值 和 NULL 组 合 时 的 规则 。 如 果 两 个 行 对 
应 的 字段 都 相等 且 非 空 ， 那 么 这 两 行 相等 ; 如 果 任 意 对 应 字段 不 等 且 非 空 ， 那 么 这 两 行 不 
等 ; 否则 结果 是 未 知 (NULL)。 如 果 每 一 行 的 结果 都 是 不 等 或 NULL ， 并 且 至 少 有 一 个 NULL 
, ABZ IN 的 结果 是 NULL 。 


9.22.3. NOT IN 


_expression_ NOT IN (_subquery_) 


右边 是 一 个 圆 括 弧 括 起 来 的 子 查询 ， 它 必须 只 返回 一 个 字段 。 左边 表达 式 对 子 查询 结果 的 每 
一 行进 行 一 次 计算 和 比较 。 如 果 只 找到 不 相等 的 子 查 询 行 (包括 子 查询 没有 返回 任何 行 的 情 
况 )， 则 NOT IN 结果 为 " 真 "。 如 果 找 到 任何 相等 行 ， 则 结果 为 " 假 "。 


请 注意 ， 如 果 左 边 表 达 式 的 值 为 NULL ， 或 者 没有 相等 的 右边 值 并 且 至 少 有 一 个 右边 行 生 成 
NULL, 那么 not IN 的 结果 将 是 NULL ， 而 不 是 真 。 这 个 行为 遵照 SQL 义理 布尔 值 和 
NULL 组 合 时 的 规则 。 


和 exists 一 样 ， 假 设 子 查询 将 被 完全 运行 是 不 明智 的 。 


_row_constructor_ NOT IN (_subquery_) 


左边 是 一 个 行 构造 器 (如 Section 4.2.13 所 述 )， 右边 是 一 个 圆 括 弧 括 起 来 的 子 查询 ， 它 必须 返 
回 和 左边 行 构造 器 一 样 多 的 字段 。 左边 表达 式 对 子 查询 结果 的 每 一 行进 行 一 次 计算 和 比较 。 
如 果 只 出 现 不 相等 的 子 查询 行 ， 则 NoT IN 结果 为 " 真 "。( 包 括 子 查询 没有 返回 任何 行 的 情 
况 )。 如 果 找 到 相等 的 子 查 询 行 ， 则 结果 为 " 假 "。 


表达 式 或 子 查询 行 里 的 NULL 遵照 SQL 义理 布尔 值 和 NULL 组 合 时 的 规则 。 如 果 两 个 行 对 
应 的 字段 都 相等 且 非 空 ， 那 么 这 两 行 相 等 ; 如 果 任 意 对 应 字段 不 等 且 非 空 ， 那么 这 两 行 不 
; 否则 结果 是 未 知 (NULL)。 如 果 每 一 行 的 结果 都 是 不 等 或 NULL ， 并 且 至 少 有 一 个 NULL 


, ABZ not IN 的 结果 是 NULL, 


9.22.4. ANY / SOME 


_expression_ _operator_ ANY (_subquery_) 
_expression_ _operator_ SOME (_subquery_) 


右边 是 一 个 圆 括 弧 括 起 来 的 子 查询 ， 它 必须 只 返回 一 个 字段 。 左边 表达 式 使 用 _operator_ 对 
子 查询 结果 的 每 一 行进 行 一 次 计算 和 上 比较 ， 其 结果 必须 是 布尔 值 。 如 果 至 少 获 得 一 个 真 值 ， 
则 ay 结果 为 " 真 "。 如 果 全 部 获得 假 值 ， 则 结果 是 " 假 "(包括 子 查询 没有 返回 任何 行 的 情况 )。 


some 是 any 的 同意 词 。 IN 等 效 于 = any. 


请 注意 ， 如 果 没有 获得 任何 真 值 并 且 至 少 有 一 个 右边 行 在 该 操作 符 上 生成 NULL， 那 
么 any 的 结果 将 是 NULL ， 而 不 是 假 。 这 个 行为 遵照 SQL 义理 布尔 值 和 NULL 组 合 时 的 规 


则 。 


和 exists 一 样 ， 假 设 子 查询 将 被 完全 运行 是 不 明智 的 。 


_row_constructor_ _operator_ ANY (_subquery_) 
_row_constructor_ _operator_ SOME (_subquery_) 


左边 是 一 个 行 构造 器 (如 Section 4.2.13 所 述 )， 右边 是 一 个 圆 括 弧 括 起 来 的 子 查询 ， 它 必须 返 
回 和 左边 行 构 造 器 一 样 多 的 字段 。 左边 表达 式 使 用 _operator_ 对 子 查询 结果 的 每 一 行进 行 一 
次 计算 和 比较 。 如 果 至 少 获得 一 个 真 值 ， 则 ANY 结果 为 " 真 "。 如 果 全 部 获得 假 值 ， 则 结果 
是 " 假 "( 包 括 子 查询 没有 返回 任何 行 的 情况 )。 如 果 没 有 获得 任何 真 值 并 且 至 少 有 一 个 行 返回 
NULL ， 那 么 结果 将 是 NULL. 


查看 Section 9.23.5 获 取 关 于 逐 行 比较 的 细节 。 


9.22.5. ALL 


_expression_ _operator_ ALL (_subquery_) 


右边 是 一 | 圆 括 弧 括 起 来 的 子 查询 ， 它 必须 只 返回 一 个 字段 。 左边 表达 式 使 用 _operator_ 对 
子 查询 结果 的 每 一 行进 行 一 次 计算 和 比较 ， 其 结果 必须 是 布尔 值 。 如 果 全 部 获得 真 

值 ， ALL 结果 为 " 真 " (包括 子 查询 没有 返回 任何 行 的 情况 )。 如 果 至 少 获 得 一 个 假 值 ， 则 结 
是 " 假 "。 如 果 上 比较 不 会 返回 任何 假 值 ， 并 且 至 少 一 个 行 返回 NULL， 则 结果 为 NULL。 


NOT IN 等 效 于 alt;agt; ALL o 


和 exists 一 样 ， 假 设 子 查询 将 被 完全 运行 是 不 明智 的 。 


_row_constructor_ _operator_ ALL (_subquery_) 


左边 是 一 个 行 构造 器 (如 Section 4.2.13 所 述 )， 右边 是 一 个 圆 括 弧 括 起 来 的 子 查询 ， 它 必须 返 
回 和 左边 行 构 造 器 一 样 多 的 字段 。 左边 表达 式 使 用 _operator_ 对 子 查询 结果 的 每 一 行进 行 
一 次 计算 和 上 比较 。 如 果 全 部 获得 真 值 ， ALL 结果 为 " 真 " (包括 子 查询 没有 返回 任何 行 的 情 
况 )。 如 果 至少 获 得 一 个 假 值 ， 则 结果 是 " 假 "。 如 果 上 比较 不 会 返回 任何 假 值 ， 并 且 至 少 一 个 行 
返回 NULL， 则 结果 为 NULL, 


查看 Section 9.23.5 以 获取 关于 逐 行 比 较 的 细节 。 


9.22.6. 逐 行 比较 


_row_constructor_ _operator_ (_subquery_) 


左边 是 一 个 行 构造 器 (如 Section 4.2.13 所 述 )， 右边 是 一 个 圆 括 弧 括 起 来 的 子 查询 ， 它 必须 返 
回 和 左边 行 构 造 器 一 样 多 的 字段 。 而 且 ， 该 子 查询 不 能 返回 超过 1 行 结果 (返回 需 行 相当 于 
NULL), 左边 表达 式 对 子 查询 的 唯一 结果 行进 行 计 算 和 比较 。 


查看 Section 9.23.5 以 获取 天 于 逐 行 比较 的 细节 。 


9.23. 行 和 数组 比较 
本 节 描述 几 个 特殊 的 构造 ， 用 于 在 多 组 值 之 间 进 行 多 重 比 较 。 这 些 形式 语法 上 和 上 一 节 的 子 


查询 形式 相关 ， 但 是 不 涉及 子 查询 。 这 种 形式 涉及 的 数组 子 表达 式 是 PostgreSQL 的 扩展 ; 
其 它 的 是 SQL 兼容 的 。 所 有 本 节 记 录 的 表达 式 形 式 都 返回 布尔 值 ( 真 / 假 )。 


9.23.1. IN 


_expression_ IN (_value_ [, ...]) 


右边 是 一 个 圆 括 弧 包 围 的 标量 列表 。 如 果 左 边 的 表达 式 结果 等 于 任何 右边 表达 式 中 的 一 个 ， 
结果 为 " 真 "。 它 是 下 面 这 种 方式 的 缩写 


_expression_ = _value1_ 
OR 
_expression_ = _value2_ 
OR 


请 注意 ， 如 果 左 边 表 达 式 的 值 为 NULL ， 或 者 没有 相等 的 右边 值 并 且 至 少 有 一 个 右边 表达 式 
的 值 为 NULL ， 那么 IN 的 结果 将 是 NULL ， 而 不 是 假 。 这 个 行为 遵照 SQL 处 理 布尔 值 和 
NULL 组 合 时 的 规则 。 


9.23.2. NOT IN 


_expression_ NOT IN (_value_ [, ...]) 


右边 是 一 个 圆 括 弧 包 围 的 标量 列表 。 如 果 左 边 的 表达 式 结果 不 等 于 任何 右边 表达 式 ， 结 果 
为 " 真 "。 它 是 下 面 这 种 方式 的 缩写 

_expression_ <> _value1_ 

AND 


_expression_ <> _value2_ 
AND 


请 注意 ， 如 果 左 边 表 达 式 的 值 为 NULL ， 或 者 没有 相等 的 右边 值 并 且 至 少 有 一 个 右边 表达 式 
的 值 为 NULL ， 那么 not IN 的 结果 将 是 NULL ， 而 不 是 真 。 这 个 行为 遵照 SQL 义理 布尔 值 
和 NULL 组 合 时 的 规则 。 




















Tip: x noT IN y 在 所 有 场合 都 等 价 于 not (x IN y) 。 但 是 ， 在 处 理 NULL 的 时 候 ， 
用 not IN 比 用 IN 更 容易 迷惑 新 手 。 最 好 用 正 逮 辑 来 表达 你 的 条 件 。 


9.23.3. ANY / SOME (array) 


_expression_ _operator_ ANY (_array expression_) 
_expression_ _operator_ SOME (_array expression_) 


右边 是 一 个 圆 括 弧 包围 的 表达 式 ， 它 必须 生成 一 个 数组 值 。 左 边 表 达 式 使 用 operator, 对 数 
组 的 每 一 个 元 素 进 行 一 次 计算 和 上 比较 ， 其 结果 必须 是 布尔 值 。 如 果 至 少 获得 一 个 真 值 ， 
则 any 结果 为 " 真 "。 如 果 全 部 获得 假 值 ， 则 结果 是 " 假 " (包括 数组 不 含 任何 元 素 的 情况 )。 


如 果 数 组 表达 式 的 值 为 NULL, MA any 的 结果 也 为 NULL, 如 果 左 边 表 达 式 的 值 为 NULL 
， 那 么 any 的 结果 通常 也 为 NULL ( 某 些 不 严格 的 比较 操作 符 可 能 得 到 不 同 的 结果 )。 BH, 
如 果 右 边 的 数组 表达 式 中 包含 NULL 元 素 并 且 没有 为 真 的 比较 结果 ， 那么 any 的 结果 将 是 
NULL( 某 些 不 严格 的 比较 操作 符 可 能 得 到 不 同 的 结果 )， 而 不 是 假 。 这 个 行为 遵照 SQL 处 理 
布尔 值 和 NULL 组 合 时 的 规则 。 


soME 是 ANY 的 同意 词 。 


9.23.4. ALL (array) 


_expression_ _operator_ ALL (_array expression_) 


右边 是 一 个 圆 括 弧 包 围 的 表达 式 ， 它 必须 生成 一 个 数组 值 。 左 边 表 达 式 使 用 operator, 对 数 
组 的 每 一 个 元 素 进 行 一 次 计算 和 比较 ， 其 结果 必须 是 布尔 值 。 如 果 全 部 获得 真 值 ， ALL 结果 
为 " 真 "(包括 数组 不 合 任 何 元 素 的 情况 )。 如 果 至 少 获 得 一 个 假 值 ， 则 结果 是 " 假 "。 


如 果 数 组 表达 式 的 值 为 NULL ， 那 么 a 的 结果 也 为 NULL, 如 果 左 边 表 达 式 的 值 为 NULL 
， 那 么 ALL 的 结果 通常 也 为 NULL ( 某 些 不 严格 的 比较 操作 符 可 能 得 到 不 同 的 结果 )。 另外 ， 
如 果 右 边 的 数组 表达 式 中 包含 NULL 元 素 并 且 没有 为 假 的 比较 结果 ， 那 么 ar 的 结果 将 是 
NULL( 某 些 不 严格 的 比较 操作 符 可 能 得 到 不 同 的 结果 )， 而 不 是 真 。 这 个 行为 遵照 SQL RE 
布尔 值 和 NULL 组 合 时 的 规则 。 


9.23.5. 逐 行 比较 


_row_constructor_ _operator_ _row_constructor_ 


两 边 都 是 一 个 Section 4.2.13 所 述 的 行 构造 器 ; 两 个 行 的 字段 数 必须 相同 。 两 边 都 被 计算 并 且 
逐 行 比较 。 目 前 ， 用 于 比较 的 _operator_ 操作 符 仅 允许 为 =，&lt;&gt; ，&lt; , alt;=, 
&gt; ，&gt;= 或 与 其 具有 相似 的 语意 。 特别 地 ， 如 果 一 个 操作 符 属于 B-tree 操作 符 类 ， 那 
么 该 操作 符 可 以 是 一 个 行 比较 操作 符 或 除 = 之 外 的 B-tree 操作 符 类 。 


= 和 &1t;&gt; 与 其 它 操作 符 稍 有 区 别 。 如 果 两 行 对 应 的 元 素 全 都 非 空 上 且 相 等 ， 那么 这 两 行 
就 被 认为 是 相等 的 ; 如 果 两 行 对 应 的 元 素 中 有 任意 一 对 非 空 且 不 等 ， 那么 这 两 行 就 被 认为 是 
不 等 的 ; 否则 这 两 行 的 比较 结果 是 未 知 (NULL)。 


对 于 alt; , alt;=, agt; ，&gt;= 操作 符 ， 行 中 的 元 素 将 按照 从 左 到 右 的 顺序 依次 进行 比 
较 ， 直 到 遇见 一 对 不 相等 的 元 素 或 者 一 对 NULL 值 。 如 果 这 对 元 素 中 存在 至 少 一 个 NULL 

值 ， 那 么 比较 的 结果 是 NULL ; 否则 这 对 元 素 的 比较 结果 就 是 最 终 的 比较 结果 。 例 

AM, Row(1,2,NULL) @lt; ROw(1,3,0) 的 结果 是 真 而 不 是 NULL ， 因 为 比较 到 第 二 对 元 素 的 时 
候 就 已 经 得 到 了 最 终结 果 ， 不 需要 对 第 三 对 元 素 进 行 比较 了 。 


Note: 在 PostgreSQL 8.2 之 前 ， &lt; , alt;=, ，&gt; ，&gt;= 并 不 遵守 SQL 标准 。 比 
如 ， Row(a,b) &lt; ROW(c,d) 将 等 价 于 a alt; c AND b &lt; d ， 而 正确 的 做 法 应 当 是 等 


价 于 a &lt; c OR (a =c AND b &lt; d) o 





_row_constructor_ IS DISTINCT FROM _row_constructor_ 


这 个 构造 类 似 于 &1t;g&gt; 行 比较 ， 但 是 它 对 NULL 输入 不 生成 NULL ， 而 是 认为 任何 NULL 
都 不 等 于 任何 非 NULL ， 并 且 NULL 之 间 是 相等 的 。 因 此 ， 结果 要 么 是 真 要 么 是 假 ， 而 绝 不 
会 是 未 知 (NULL)。 


_row_constructor_ IS NOT DISTINCT FROM _row_constructor_ 


这 个 构造 类 似 于 = 行 比较 ， 但 是 它 对 NULL 输入 不 生成 NULL ， 而 是 认为 任何 NULL 都 不 等 
于 任何 非 NULL ， 并 且 NULL 之 间 是 相等 的 。 因此 ， 结 果 要 么 是 真 要 么 是 假 ， 而 绝 不 会 是 未 
知 (NULL)。 


Note: 如 果 结 果 依 赖 于 比较 两 个 NULL 值 或 一 个 NULL 值 和 一 个 非 NULL 值 ，SQL 规范 要 求 
逐 行 比较 返回 NULL, PostgreSQL 仅 当 比 较 两 个 行 构造 的 结果 或 一 个 行 构造 器 和 子 查询 
的 输出 时 这 样 做 (就 像 Section 9.22 描 述 的 那样 )。 在 其 它 情况 下 ， 两 个 复合 类 型 的 值 进行 
比较 ， 认为 两 个 NULL 字 段 值 是 相等 的 ， 并 且 NULL 大 于 非 NULL。 这 是 必要 的 ， 如 此 才 
能 有 一 致 的 排序 和 复合 类 型 的 索引 行为 。 


9.24. 返回 集合 的 函数 


本 节 描 述 那 些 可 能 返回 多 于 一 行 的 函数 。 在 这 个 类 中 最 广泛 使 用 的 函数 是 序列 号 生成 函数 ， 
如 Table 9-49 和 Table 9-50 所 述 。 另外 ， 更 专业 的 集合 返回 函数 在 这 个 手册 的 其 他 地 方 描述 。 


Table 9-49. 序列 号 生成 函数 


‘generate series( start , setof int 或 setof bigint 


stop ) ae (与 参数 类 型 相同 ) 


setof int 或 setof bigint 


(与 参数 类 型 相同 ) 


`generate_series(``` start 、 
9 a ( ; int BK bigint 
Stop, step ) 


: : apse 7 、 setof timestamp 或 

generate_series( Start ， ada Em z setof timestamp with time z 
; imestamp wi ime zone a = 

stop, step interval ) (与 参数 类 型 相同 ) 


如 果 step 是 正 数 且 start 大 于 stop, MAROS., R, WR step 是 负数 且 start 小 
于 stop ， 那 么 也 返回 需 行 。 如 果 输 入 是 w, BŽ AEST step 为 需 则 是 一 个 错误 。 
下 面 是 一 些 例子 : 


SELECT * FROM generate_series(2,4); 
generate_series 


(3 rows) 


SELECT * FROM generate_series(5,1, -2); 
generate_series 


(3 rows) 


SELECT * FROM generate_series(4,3); 
generate_series 


-- this example relies on the date-plus-integer operator 
SELECT current_date + s.a AS dates FROM generate_series(0,14,7) AS s(a); 
dates 


2004-02-05 
2004-02-12 
2004-02-19 
(3 rows) 


SELECT * FROM generate_series('2008-03-01 00:00'::timestamp, 
"2008-03-04 12:00', '10 hours'); 
generate_series 


2008-03-01 00:00:00 
2008-03-01 10:00:00 
2008-03-01 20:00:00 
2008-03-02 06:00:00 
2008-03-02 16:00:00 
2008-03-03 02:00:00 
2008-03-03 12:00:00 
2008-03-03 22:00:00 
2008-03-04 08:00:00 
(9 rows) 


Table 9-50. 下 标 生 成 函数 


SKE 返回 类 型 描述 
“generate_subscripts( array anyarray , TEA Soe 生成 一 系列 包括 给 定数 组 的 
dim int ) 下 标 。 


生成 一 系列 包括 给 定数 组 的 
‘generate_subscripts( array anyarray , : 下 标 。 当 reverse AB, 
setof int $ % 
dim int , reverse boolean ) 该 系列 则 以 相反 的 顺序 返 
回 。 


generate_subscripts 是 一 个 为 给 定数 组 中 的 指定 维度 生成 有 效 下 标 集 的 便利 函数 。 如 果 数 组 
中 没有 所 请 求 的 维度 或 者 NULL 数 组 ， 返 回 0 行 (但 是 会 给 数组 元 素 为 空 的 返回 有 效 下 标 ) o 
下 面 一 些 例子 : 


-- basic usage 
SELECT generate_subscripts('{NULL,1,NULL,2}'::int[], 1) AS s; 
S 


1 
2 
3 
4 
(4 


-- presenting an array, the subscript and the subscripted 
-- Value requires a subquery 
SELECT * FROM arrays; 


rows ) 


{-1, -2} 
{100, 200, 300} 
(2 rows) 


SELECT a AS array, s AS subscript, a[s] AS value 
FROM (SELECT generate_subscripts(a, 1) AS s, a FROM arrays) foo; 


array | subscript | value 
sae a ee ee pS ON ele ey eee gee ed et Re 
{-1, -2} | 1 | -1 
{-1, -2} | 2 | -2 
{100, 200, 300} | 1| 100 
{100, 200, 300} | 2 | 200 
{100,200,300} | 3 | 300 
(5 rows) 


-- unnest a 2D array 
CREATE OR REPLACE FUNCTION unnest2(anyarray) 
RETURNS SETOF anyelement AS $$ 
select $1[i][j] 
from generate_subscripts($1,1) g1(i), 
generate_subscripts($1,2) g2(j); 
$$ LANGUAGE sql IMMUTABLE; 
CREATE FUNCTION 
postgres=# SELECT * FROM unnest2(ARRAY[[1,2],[3,4]]); 
unnest2 


9.25. RAR 


AMER TAMAR, A—LER 
获取 更 多 信息 。 


Table 9-51. & (SBR 


Name 


current_catalog 


current_database() 


current_query() 


~current_schema [()] 


*current_schemas(** boolean ) 


current_user 


inet_client_addr() 
inet_client_port() 
inet_server_addr() 


inet_server_port() 
pg_backend_pid() 
pg_conf_load_time() 


~pg_is_other_temp_schema( ~~ “oid ) 





pg_listening_channels() 


pg_my_temp_schema() 


pg_postmaster_start_time() 


Table 9-51 显 示 了 几 个 抽取 会 话 及 系统 信息 的 函数 。 
WMBRKARTRR, 也 提供 有 系统 信息 。 


Return Type 


name 


name 


text 


name 


name[ ] 


name 
inet 
int 
inet 
int 
int 
timestamp with time zone 


boolean 


setof text 


oid 


timestamp with time zone 


B ğ Section 27.2.2 


Description 


当前 数据 库 名 (在 
SQL 标准 里 
叫 "catalog") 


当前 数据 库 名 
当前 执行 的 查询 文 
本 ， 由 客户 端 提交 
(可 能 包含 多 于 1 
句 ) 

当前 模式 名 


搜索 路 径 中 的 模式 
名 字 ， 包 括 可 选 的 
隐 式 模式 


当前 执行 环境 下 的 
用 户 名 


连接 的 远 端 地 址 
连接 的 远 
连接 的 本 地 地 址 
连接 的 本 地 端口 


连接 到 当前 会 话 的 
服务 器 进程 ID 


LEIRE H 


否 为 另 一 个 会 话 
人 


正在 侦 听 的 当前 会 
话 的 信道 名 称 


会 话 的 临时 模式 的 
OID， 不 存在 则 为 0 


服务 器 启动 时 间 


元 端 端 口 


PostgreSQL 触发 器 
的 当前 柑 套 级 别 
pg_trigger_depth() int 《如果 没有 直接 或 
间接 的 从 一 个 触发 
器 内 部 调用 ， 那 么 


是 0) 
session_user name 会 话 用 户 名 


(个 
user name 等 价 于 


current_user 


PostgreSQL 版 本 信 
息 


version() text 


Note: current_catalog , current_schema , current_user , session_user ,和 user 在 
SQL 里 有 特殊 的 语法 : 调用 他 们 时 结尾 不 能 跟 圆 括号 。 (在 
PostgreSQL, current_schema 可 选 的 可 以 有 括号 ， 但 是 其 它 的 不 能 。 ) 


session_user 通常 是 连接 当前 数据 库 的 初始 用 户 ， 不 过 超级 用 户 可 以 用 SET SESSION 
AUTHORIZATION 修 改 这 个 设置 。 current_user 是 用 于 权限 检查 的 用 户 标识 。 通 常 ， 它 总 是 
等 于 会 话 用 户 ， 但 是 可 以 通过 SET ROLE 改变 它 。 在 函数 执行 的 过 程 中 随 着 属 

性 SECURITY DEFINER 的 改变 ， 其 值 也 会 改变 。 用 Unix 术语 来 说 ， 会 话 用 户 是 "真实 用 户 "， 而 
当前 用 户 是 "有 效用 户 "。 


current_schema 返回 在 搜索 路 径 前 端的 模式 名 字 ( 如 果 搜 索 路 径 为 空 则 返回 NULL), 如 果 创 
建 表 或 者 其 它 命名 对 象 时 没有 声明 目标 模式 ， 那 么 它 将 是 用 于 这 些 对 象 的 模式 。 
current_schemas(boolean ) 返回 一 个 搜索 路 径 中 所 有 模式 名 字 的 数组 。 布尔 选项 决定 
IR pg_catalog 这 样 隐 含 包含 的 系统 模式 是 否 包 含 在 返回 的 搜索 路 径 中 。 

Note: 搜索 路 径 可 以 通过 运行 时 设置 更 改 。 命 令 是 : 


SET search_path TO _schema_ [, ~_schema_, ...] 





pg_listening channels 返回 当前 会 话 正 在 监听 的 一 组 信道 名 称 。 见 LISTEN 获 取 更 多 信息 。 


inet_client_addr 返回 当前 客户 端的 I|P 地 址 ， 而 inet_client_port 则 返回 当前 客户 端的 端口 
So inet_server_addr 返回 服务 器 接收 当前 连接 用 的 IP 地 址 ， 而 inet_server_port 返回 接 
收 当前 连接 的 端口 号 。 如 果 是 通过 Unix-domain socket 连接 的 ， 那 么 所 有 这 些 函 数 都 返回 
NULL 。 


pg_my_temp_schema 返回 当前 会 话 的 临时 模式 OID, 如 果 不 存 在 的 话 则 返回 0( 因 为 没有 创建 
任何 临时 表 )。 pg_is_other_temp_schema 返回 给 定 的 OID 是 否 为 其 它 会 话 的 临时 模式 OID, 
这 个 画 数 是 有 实用 价值 的 ， 比如 ， 在 显示 一 个 目录 的 时 候 排除 掉 其 它 会 话 的 临时 表 。 





pg_postmaster_start_time 返回 服务 器 启 动 时 的 timestamp with time zone o 


pg_conf_load_time 返回 最 后 加 载 服 务 器 配置 文件 的 时 间 惟 。 (如 果 当 前 会 话 在 那 时 还 活动 ， 
将 是 当前 会 话 本 身 重 新 读 取 配 置 文件 的 时 间 ， 所 以 读 取 的 时 间 会 在 不 同 的 会 话 中 稍微 有 所 不 
fl, GR], 它 是 postmaster 进 程 重新 读 取 配 置 文件 的 时 间 。 ) 


version 返回 一 个 描述 PostgreSQL 服 务 器 版 本 信息 的 字符 串 。 


Table 9-52 列 出 那些 允许 用 户 在 程序 里 查询 对 象 访问 权限 的 函数 。 参阅 Section 5.6 获 取 更 多 
有 关 权 限 的 信息 。 


Table 9-52. 访问 权限 查询 男 数 


名 字 返回 类 型 描述 
指定 用 户 


是 否 有 访 
问 表 任 何 
列 的 权限 


当前 用 户 
是 否 有 访 
问 表 任 何 
列 的 权限 


指定 用 户 
是 否 有 访 
问 列 的 权 
限 


当前 用 户 
是 否 有 访 
问 列 的 权 
限 


指定 用 户 
是 否 有 访 
问 数据 库 
的 权限 


当前 用 户 
是 否 有 访 
问 数 据 库 
的 权限 


指定 用 户 
是 否 有 访 
has_foreign_data_wrapper_privilege`( user , fdw , privilege’) boolean 问 外 部 数 
据 封装 器 
的 权限 


当前 用 户 
是 否 有 访 
has_foreign_data_wrapper_privilege’( fdw , privilege’) boolean 问 外 部 数 
据 封装 器 
的 权限 


has_any_column_privilege’( user , table , privilege’) boolean 


has_any_column_privilege’( table , privilege’) boolean 


has_column_privilege’( user , table , column , privilege’) boolean 


has_column_privilege’( table , column , privilege’) boolean 


has_database_privilege’( user , database , privilege’) boolean 


has_database_privilege’( database , privilege ) boolean 


has_function_privilege’( user , function , privilege’) 


has_function_privilege’( function , privilege’) 


has_language_privilege’ ( user, language i privilege’ ) 


has_language_privilege’( language , privilege’) 


has_schema_privilege’( user , schema , privilege’ ) 


has_schema_privilege’( schema , privilege’) 


has_sequence_privilege ( User , SEQUENCE , privilege’) 


has_sequence_privilege’ ( sequence , privilege’) 


has_server_privilege’( user , server , privilege ) 


has_server_privilege’( server , privilege’) 


has_table_privilege’( user , table , privilege’) 


boolean 


boolean 


boolean 


boolean 


boolean 


boolean 


boolean 


boolean 


boolean 


boolean 


boolean 


指定 用 户 
是 否 有 访 
7] HAY 
权限 


当前 用 户 
是 否 有 访 
H HAY 
权限 


指定 用 户 
是 否 有 访 
问 语言 的 
权限 


当前 用 户 
是 否 有 访 
问 语言 的 
权限 


指定 用 户 
是 否 有 访 
问 模 式 的 
权限 


当前 用 户 
是 否 有 访 
问 模 式 的 
权限 


指定 用 户 
是 否 有 访 
问 序列 的 
权限 


当前 用 户 
是 否 有 访 
问 序列 的 
权限 


指定 用 户 
是 否 有 访 
问 外 部 服 
务 的 权限 


当前 用 户 
是 否 有 访 
问 外 部 服 
务 的 权限 
指定 用 户 
是 否 有 访 
问 表 的 权 
限 


当前 用 户 


has_table_privilege’( table , privilege’) boolean 是 否 有 访 
问 表 的 权 
限 
指定 用 户 


是 否 有 访 
has_tablespace_privilege’( user , tablespace , privilege’) boolean À E 
问 表 空间 


的 权限 
当前 用 户 
=i aS 
has_tablespace_privilege’( tablespace , privilege’) boolean 是 否 有 访 
问 表 空间 
的 权限 
指定 用 户 
pg_has_role`( user , role , privilege’) boolean 是 否 有 角 


色 的 权限 
当前 用 户 


pg_has_role’( role , privilege’) boolean 是 否 有 角 


色 的 权限 


has_table_privilege 检查 用 户 是 否 可 以 用 特定 的 方式 访问 表 。 用 户 可 以 通过 名 字 或 

OID (pg_authid.oid) 来 指定 ， public 表明 PUBLIC 伪 角色 ， 或 如 果 缺 省 该 参数 ， 则 使 

用 current_user 。 该 表 可 以 通过 名 字 或 者 OID 声明 。 因此 ， 实 际 上 有 六 

种 has_table_privilege 变 体 ， 我 们 可 以 通过 它们 的 参数 数目 和 类 型 来 区 分 它们 。 如 果 用 名 字 
声明 ， 那 么 在 必要 时 可 以 用 模式 进行 修饰 。 所 希望 的 权限 类 型 是 用 一 个 文本 字符 串 来 声明 
的 ， 必 须 是 SELECT ， INSERT ， UPDATE ， DELETE , TRUNCATE , REFERENCES 或 TRIGGER 之 一 。 
可 选 ， 可 以 添加 WITH GRANT option 到 权限 类 型 ， 以 测试 权限 是 否 拥有 授权 选项 。 也 可 以 用 去 
号 分 隔 多 个 列 出 的 权限 类 型 ， 如 果 拥 有 任何 所 列 出 的 权限 ， 则 结果 便 为 true. (权限 字符 
串 不 区 分 大 小 宇 ， 权限 名 之 间 人 允许 有 额外 空白 但 不 属于 权限 名 的 部 分 。) 一 些 例子 : 


SELECT has_table_privilege('myschema.mytable', 'select'); 
SELECT has_table_privilege('joe', 'mytable', 'INSERT, SELECT WITH GRANT OPTION'); 


has_sequence privilege 检查 用 户 是 否 可 以 用 特定 的 方式 访问 序列 。 参数 可 能 
与 has_table_privilege 类 似 。 想 要 的 访问 权限 必须 为 USAGE ， SELECT 或 UPDATE 之 一 。 


has_any_column_privilege 检查 用 户 是 否 可 以 用 特定 的 方式 访 问 表 的 任何 列 。 其 参数 可 能 
与 has_table_privilege 类 似 ， 除 了 想 要 的 权限 类 型 必须 是 SELECT, INSERT, UPDATE, 
或 REFERENCES 的 一 些 组 合 。 请 注意 ， 在 表 级 别 拥有 任何 这 些 权 限 隐 含 授予 它 为 每 个 表 列 ， 
此 如 果 和 与 has_table_privilege 参数 相同 ， has_any_column_privilege 总 是 返回 true o 但 是 


如 果 有 至 少 一 列 的 列 级 权限 授予 也 成 功 。 


has_column_privilege 检查 用 户 是 否 可 以 用 特定 的 方式 访问 一 列 。 其 可 能 的 参数 类 似 
于 has_table_privilege ， 可 以 通过 列 名 或 属性 数 添 加 列 。 想 要 的 访问 权限 类 型 必须 
是 SELECT, INSERT, UPDATE ， 或 REFERENCES 的 一 些 组 合 。 请 注意 ， 在 表 级 别 拥有 任何 这 


些 权限 隐 含 授予 它 为 每 个 表 列 。 


has_database_privilege 检查 一 个 用 户 是 否 能 以 特定 方式 访 问 一 个 数据 库 。 它 可 能 的 参数 类 
似 has_table_privilege 。 权 限 类 型 必须 是 CREATE ， CONNECT ， TEMPORARY ， TEMP (等 价 
于 TEMPORARY ) 的 一 些 组 合 。 


has_function_privilege 检查 一 个 用 户 是 否 能 以 特定 方式 访问 一 个 图 数 。 它 可 能 的 参数 类 
似 has_table_privilege 。 我 们 声明 一 个 函数 用 的 是 文本 字符 串 而 不 是 OID ， 人 允许 的 输入 
和 regprocedure 数据 类 型 一 样 (参阅 Section 8.18)。 权 限 类 型 必须 是 execute. 一 个 例子 如 
F: 


SELECT has_function_privilege('joeuser', 'myfunc(int, text)', 'execute'); 


has_foreign_data_wrapper_privilege 检查 一 个 用 户 是 否 能 以 特定 的 方式 访问 外 部 数据 封装 
器 。 它 的 可 能 的 参数 类 似 has_table_privilege 。 权 限 类 型 必须 是 USAGE o 


has_language_privilege 检查 一 个 用 户 是 否 能 以 特定 方式 访 问 一 个 过 程 语言 。 它 可 能 的 参数 


类 似 has_table_privilege 。 权 限 类 型 必须 是 USAGE o 


has_schema_privilege 检查 一 个 用 户 是 否 能 以 特定 方式 访问 一 个 模式 。 它 可 能 的 参数 类 
似 has_table_privilege 。 权 限 类 型 必须 是 cREATE 或 USAGE 的 一 些 组 合 。 


has_server_privilege 检查 一 个 用 户 是 否 能 以 特定 方式 访 问 一 个 外 部 服务 器 。 它 可 能 的 参数 
类 似 has_table_privilege 。 权 限 类 型 必须 是 USAGE o 


has_tablespace_privilege 检查 一 个 用 户 是 否 能 以 特定 方式 访 问 一 个 表 空 间 。 它 可 能 的 参数 
类 似 has_table_privilege 。 权 限 类 型 必须 是 CREATE o 


pg_has_role 检查 一 个 用 户 是 否 能 以 特定 方式 访 问 一 个 角 色 。 它 可 能 的 参数 类 

{LL has_table_privilege ， 除 了 public 不 能 用 做 用 户 名 。 权 限 类 型 必须 

是 MEMBER 或 USAGE 的 一 些 组 合 。 MEMBER 表示 的 是 角色 中 的 直接 或 间接 成 员 关 系 (也 就 
是 SET ROLE 的 权限 )， 而 usace 表示 角色 的 权限 是 否 无 需 SET ROLE 即 可 立即 生效 。 


Table 9-53 显示 了 那些 判断 一 个 对 象 是 否 在 当前 模式 搜索 路 径 中 可 见 的 画 数 。 比如 ， 如 果 一 
个 表 所 在 的 模式 在 搜索 路 径 中 ， 并 且 没 有 同名 的 表 出 现在 搜索 路 径 的 更 靠 前 的 地 方 ， 那么 就 
说 这 个 表 是 可 见 的 。 它 等 效 于 表 可 以 不 带 明 确 模式 修饰 进行 引用 。 比 如 ， 要 列 出 所 有 可 见 表 
的 名 字 : 


SELECT relname FROM pg_class WHERE pg_table_ is visible(oid); 


Table 9-53. 模式 可 见 性 查询 辑 数 


名 字 返回 类 型 描述 


该 排序 是 否 在 搜索 路 径 中 
可 见 


该 转换 是 否 在 搜索 路 径 中 
可 见 


该 画 数 是 否 在 搜索 路 径 中 
可 见 


该 操作 符 类 是 否 在 搜索 路 
径 中 可 见 


该 操作 符 是 否 在 搜索 路 径 
中 可 见 


该 操作 符 族 是 否 在 搜索 路 


~pg_collation_is_visible( ~~ ~collation_oid ) boolean 
~pg_conversion_is_visible( ~~ conversion_oid ) boolean 
~pg_function_is_visible( ~~~ function_oid ) boolean 
~pg_opclass_is_visible(~~ opclass_oid ) boolean 
~pg_operator_is_visible( ~~ operator_oid ) boolean 
~pg_opfamily_is_visible(~~ opclass_oid ) boolean 


该 表 是 否 在 搜索 路 径 中 可 


`pg_table_is_visible(```table_oid ) boolean 


该 文本 检索 配置 是 否 在 搜 


`pg_ts_config_is_visible(```config_oid ) boolean 过 路 4 





该 文本 检索 词典 是 否 在 搜 
索 路 径 中 可 见 


该 文本 搜索 解析 是 否 在 搜 


`pg_ts_parser_is_visible(```parser_oid boolean p 
jni wes 来 路 径 中 可 见 


ET boolean 





该 文本 检索 模板 是 否 在 搜 


~pg_ts_template_is_visible(* ~~ template_oid boolean j 
P -i ) 素 路 径 中 可 见 


ZH (hin) BS 
‘pg_type_is visible(*. type _ oid ) boolean te 是 否 在 搜 
每 个 函数 执行 一 种 数据 库 对 象 类 型 的 可 见 性 检查 。 请 注意 pg_table_is visible 还 可 用 于 视 
图 、 索 引 、 序 列 。 pg_type_is_visible 还 可 用 于 域 。 对 于 男 数 和 操作 符 ， 如 果 在 搜索 路 径 中 
没有 名 字 相同 并 且 参 数 的 数据 类 型 也 相同 的 对 象 出 现在 路 径 中 更 靠 前 的 位 置 ， 那 么 该 对 象 就 
是 可 见 的 。 对 于 操作 符 类 ， 则 要 同时 考虑 名 字 和 相关 的 索引 访问 方法 。 


所 有 这 些 函 数 都 需要 使 用 OID 来 标识 要 被 检查 的 对 象 。 如 果 你 想 通 过 名 字 测 试 对 象 ， 那么 使 
用 OID 别名 类 型 ( regclass , regtype , regprocedure , regoperator , 
regconfig 或 regdictionary ) 将 会 很 方便 。 例 如 : 


SELECT pg_type_is_visible( 'myschema.widget'::regtype); 


请 注意 用 这 种 方法 测试 一 个 未 经 修饰 的 名 字 没 什么 意义 ， 因 为 如 果 一 个 名 字 可 以 被 识别 ， 那 
它 首先 必须 是 可 见 的 。 


Table 9-54 列 出 了 从 系统 表 中 抽取 信息 的 西数 。 


Table 9-54. RARE RW 


名 字 
`format_type( type _oid , typemod ) 


ipg describe object( catalog id", object_id 
object_sub_id ) 


pg identify object( catalog id oid 


object_id oid , object_sub_id integer ) 


ipg get constraintdef( constraint ord ) 


ipg get constraintdef( constraint ord 
pretty_bool ) 


‘pgEgetzexprG@ ) “pg=nodestrees, snelataonzord ) 


pg get _expr( pg node tree, relation_oid 
pretty_bool ) 


~pg_get_functiondef (~~ ~func_oid ) 


~pg_get_function_arguments( ~~ func oid ) 
~pg_get_function_identity_arguments( ~~~ func_oid ) 


~*pg_get_function_result( ~~~ func_oid ) 


~pg_get_indexdef( ~~ “index oid ) 


~pg_get_indexdef( ~~ ~index_oid , column_no 
pretty_bool ) 


pg_get_keywords() 


pg get _ruledef(  rule_oiïd ) 


pg get rùuledef( rule oid , pretty bool ) 


`pg_get_serial seqúence( ` table _ name 
column_name ) 


pg_get_triggerdef ( trigger_oid ) 


pg_get_triggerdef ( trigger_oid , pretty_bool ) 


~pg_get_userbyid( ~~ role oid ) 


返回 类 型 
text 
text 
types Etexes. 
schema 


text , name 
text , 
identity 
text 

text 


text 


text 


text 


text 


text 


text 


text 


text 


text 


setof record 
text 


text 


text 


text 


text 


name 


获取 一 个 数据 类 型 


获取 一 个 数据 库 对 


获取 一 个 数据 库 对 


获取 一 个 约束 的 定 
获取 一 个 约束 的 定 
反 编 译 一 个 表达 式 
的 任何 Var 都 引用 


反 编译 一 个 表达 式 
的 任何 Var 都 引用 


获取 一 个 函数 的 定 
获取 男 数 定义 的 参 


获取 参数 列表 来 确 
值 ) 


获取 回 数 的 RETURN 
获取 索引 的 CREATE 


获取 索引 的 CREATE 
果 column_no 不 为 : 
字段 的 定义 。 


获取 SQL 关键 字 和 
为 规则 获取 CREATE 


为 规则 获取 CREATE 


获取 一 

个 serial , smal] 
段 使 用 的 序列 名 
为 触发 器 获 

取 CREATE [ CONSTF 
为 触发 器 获 


取 CREATE [ CONSTF 


获取 给 定 OID HF 














`pg_get_viewdef(```view_name ) text 为 视 图 或 物化 视 图 
(CRF) 
为 视图 或 物化 视图 
`pg_get_viewdef(```view_name , pretty_bool text 
pg_g ( pretty ) DERF) 
: y EENET : 为 视图 或 物化 视图 
pg_get_viewdef ( view_oid ) text a 
3 : IEA ; 为 视图 或 物化 视图 
pg_get_viewdef(**°view_oid , pretty_bool ) text 兮 
为 视图 或 物化 视图 
`pg_get_viewdef(```view_oid , wrap_column_int ) text D; 行 字 段 被 换 到 
含 的 
`pg_options_to_table(```reloptions ) Setof record 获取 存储 选项 名 称 
3h is oh hy =e op 
`pg_tablespace_databases(```tablespace_oid ) setof oid ee 
A 
`pg_tablespace_location(```tablespace_oid ) text 获取 表 空 间 所 在 的 
`pg_typeof( any ) regtype 获取 任何 值 的 数据 
“collation for anv) text 获取 参数 的 排序 


format_type 通过 某 个 数据 类 型 的 类 型 OID 以 及 可 和 6 的 类 型 修饰 词 7] 12 返回 其 SQL 名 称 。 如 果 
不 知道 具体 的 修饰 词 ， 那 么 在 类 型 修饰 词 的 位 置 传 人 NULL. 


pg_get_keywords 返回 一 组 记录 描述 服务 器 识别 的 SQL 关键 字 。 word 列 包含 关键 
F. catcode 列 包 含 一 个 分 类 代码 : u 通用 的 ，c 列 名 ， 1 类 型 或 函数 名 ， 或 R 保留 。 
catdesc 列 包 含 了 一 个 可 能 本 地 化 描述 分 类 的 字符 串 。 


pg_get_constraintdef , pg_get_indexdef , pg_get_ruledef , 和 pg_get_triggerdef 分 别 从 
一 个 约束 、 索 引 、 规 则 或 触发 器 上 重新 构造 创建 它们 的 命令 ( 反 编 译 的 重新 构造 ， 而 不 是 该 命 
DRX) pg_get_expr 反 编 译 一 个 独立 表达 式 的 内 部 形式 ， 比如 一 个 字段 的 缺 省 值 。 在 检 
查 系统 表 的 内 容 的 时 候 很 有 用 。 如 果 表 达 式 可 能 包含 Var， 那么 指定 他 们 参考 的 关联 的 DID 为 
第 二 个 参数 ; 如 果 没 有 Var，0 就 足够 了 。 pg_get_viewdef 重新 构造 出 定义 视图 的 SELECT 查 
询 。 这 些 函 数 大 多 数 都 有 两 个 变种 ， 其 中 一 个 是 "适合 打印 "的 结果 。 这 种 格式 更 容易 读 ， 但 
o o eae BARS SK AYPostgreSQLikA A EA ARA; 如 果 是 用 于 转 储 ， 那 么 

可 能 避免 使 用 适合 打印 的 格式 。 给 pretty-print 参 数 传递 false 生成 的 结果 和 没有 这 个 参数 


pg_get_functiondef 为 函数 返回 一 个 完整 的 CREATE OR REPLACE FUNCTION 语句 。 
pg_get_function_arguments 返回 一 个 函数 的 参数 列表 ， 这 种 格式 需要 在 CREATE FUNCTION 中 
使 用 。 pg_get_function_result 为 范 数 简单 的 返回 适当 的 RETURNS 子 

句 。 pg_get_function_identity_arguments 返回 需要 的 参数 列表 以 标识 画 数 ， 这 种 格式 需要 
在 ALTER FUNCTION 中 使 用 。 这 种 形式 省 略 了 默认 值 。 


pg_get_serial_sequence 返回 与 一 个 字段 相关 的 序列 名 字 ; 如 果 没 有 任何 序列 与 给 定 的 字段 
相关 则 返回 NULL 。 第 一 个 输入 参数 是 可 选 模式 的 表 名 ， 第 二 个 参数 是 列 名 。 因 为 第 一 个 参 
数 可 能 是 一 个 模式 和 表 ， 它 不 是 视 为 一 个 双 引 号 的 标识 符 ， 意味 着 默认 情况 下 小 写 ， 而 第 二 
个 参数 只 是 列 名 称 ， 被 视 为 双 引 号 括 起 来 的 ， 并 保留 其 大 小 写 。 这 个 名 字 经 过 了 合适 的 格式 
化 ， 可 以 传递 给 序列 函数 (参阅 Section 9.16)。 这 种 相关 性 可 以 通 

过 ALTER SEQUENCE OWNED BY 修改 或 删除 。 (其 实 将 这 个 男 数 命名 为 pg_get_owned_sequence 或 
许 更 为 妥当 ， 因为 它 的 当前 名 字 反 映 了 它 通 常用 于 serial 或 bigserial 字段 的 事实 。 ) 


pg_get_userbyid 通过 角色 的 OID 抽取 对 应 的 用 户 名 。 


pg_options_to_table 当 通 过 pg_class . reloptions 或 pg_attribute . attoptions 时 返回 存储 
选项 名 字 / 值 对 ( option_name / option_value ) 的 集合 。 


pg_tablespace_databases 允许 检查 一 个 表 空 间 的 状况 ， 它 返 回 在 该 表 空 间 中 保存 了 对 象 的 数 
据 库 OID 集合 。 如 果 这 个 画 数 返 回 数据 行 ， 那么 该 表 空 间 就 是 非 空 的 ， 因 此 不 能 删除 。 要 显 
示 该 表 空 间 中 的 特定 对 象 ， 你 需要 把 pg_tablespace_databases 返回 的 数据 库 标 识 与 
pg_class 表 连 接 进 行 查询 。 


pg_describe_object 返回 由 目录 OID， 对 象 OID 和 一 个 或许 0 个 ) 子 对 象 ID 指 定 的 数据 库 对 
象 的 描述 。 这 个 描述 趋向 于 人 类 易 读 ， 并 且 可 能 是 经 过 翻译 的 ， 取 决 于 服务 器 的 配置 。 这 有 
助 于 确定 一 个 对 象 的 标识 存储 在 pg_depend 目录 中 。 


pg_identify_object 返回 一 个 包含 足够 信息 来 唯一 的 标识 由 系统 OID， 对 象 OID 和 一 个 (或许 
0 个 ) 子 对 象 ID 指定 的 数据 库 对 象 的 行 。 这 个 信息 趋向 于 机 器 易 读 ， 并 且 从 不 翻译 。 type 标 
识 数据 库 对 象 的 类 型 ; schema 是 对 象 属于 的 模式 名 ， 或 nur. 表明 对 象 类 型 不 属于 模 

式 ; name 是 对 象 的 名 字 ， 如 果 需 要 就 加 上 双 引 号 ， 只 有 在 它 可 以 用 作对 象 的 唯一 标识 符 时 
使 用 (如果 相关 ， 跟 随 模式 名 ) , AMA nul ; identity 是 完整 的 对 象 身份 ， 根 据 对 象 类 
型 有 精确 的 格式 ， 并 且 格 式 内 的 每 个 部 分 都 是 模式 限定 的 ， 必要 时 加 双 引 号 。 


pg_typeof 返回 传递 给 它 的 值 的 数据 类 型 OID。 这 可 能 有 利于 故障 排除 或 动态 构造 SQL 坦 
询 。 画 数 声明 返回 OID 别 名 类 型 的 regtype (参阅 Section 8.18) ; 这 意味 着 它 和 比较 目的 的 
OID 相 同 但 显示 类 型 名 称 。 例 如 : 


SELECT pg_typeof(33); 


pg_typeof 


Integer 
(1 row) 


SELECT typlen FROM pg_type WHERE oid = pg_typeof(33); 
typlen 


表达 式 collation for 返回 传递 给 它 的 值 的 排序 。 例如 


SELECT collation for (description) FROM pg_description LIMIT 1; 
pg_collation_for 


"default" 
(1 row) 


SELECT collation for ('foo' COLLATE "de_DE"); 
pg_collation_for 


"de DE" 
(1 row) 


值 可 能 是 引号 括 起 来 的 并 且 模 式 限制 的 。 Gee 式 排序 ， 那 么 返回 一 个 null 值 。 
如 果 参 数 不 是 排序 的 类 型 ， 那 么 抛 出 一 个 错误 。 


Table 9-55 显 示 的 函数 将 原来 用 COMMENT 命令 存储 的 评注 抽取 出 来 。 如 果 没 有 找到 ， 则 返 
回 NULL 。 


Table 9-55. 注释 信息 函数 


名 字 REl% 描述 
型 
col description( table oid, PEA JS 
seta bial i text ”获取 一 个 表 字 段 的 评注 


column_number ) 


~obj_description(*~°object_oid , Pox 获取 一 个 数据 库 对 象 的 评注 
catalog_name ) 
获取 一 个 数据 库 对 象 的 评注 (已 
RA) 

,wt ”获取 一 个 共享 数据 库 对 象 的 评 


catalog_name ) 注 


`obj_description(```object_oid ) text 


~shobj_description( ~~ object_oid , 


col_description 返回 一 个 表 中 字段 的 评注 ， 它 是 通过 表 OD 和 字段 号 来 声明 的 。 
obj_description 不 能 用 于 表 字 段 ， 因 为 字段 没有 自己 的 OID 。 


带 有 两 个 参数 的 obj_description 返回 一 个 数据 库 对 象 的 评注 ， 该 对 象 是 通过 其 OID 和 其 所 
属 的 系统 表 名 字 声 明 的 。 比 如 ， obj_description(123456, 'pg_class') 将 返回 OID 为 12345 
的 表 的 评注 。 只 带 一 个 参数 的 opj_description 只 要 求 对 象 OID ， 现 在 已 经 废弃 了 ， 因 为 我 
们 不 再 保证 OID 在 不 同 的 系统 表 之 间 是 唯一 的 ， 因此 可 能 会 返回 错误 的 评注 。 


shobj_description 和 obj_description 差不多 ， 不 同 之 处 仅 在 于 前 者 用 于 共 tS xt RK, 些 系 
统 表 是 通用 于 集群 中 所 有 数据 库 的 全 局 表 ， 因此 这 些 表 的 评注 也 是 全 局 存储 的 。 


Table 9-56 显 示 的 画 数 在 一 个 输出 形式 中 提供 服务 器 事务 信息 。 这 些 函 数 的 主要 用 途 
确定 在 两 个 快照 之 间 有 哪个 事务 提交 。 


Table 9-56. 事务 ID 和 快照 


名 字 返回 类 型 描述 


txid_current() bigint 获取 当前 事务 ID 
txid_current_snapshot() txid_snapshot 获取 当前 快照 

xh 小 Ha 讲 行 人 
`txid_snapshot_xip(```txid_snapshot ) Setof bigint 快照 中 进行 中 的 事 
`txid_snapshot_xmax(```txid_snapshot ) bigint 获取 快照 的 xmax 
‘txid_snapshot_ xmin( ~ ~txid_snapshot ) bigint 获取 快照 的 xmin 
txid visible in snapshot( bigint, boolean 在 快照 中 事务 ID 是 否 A 
txid_snapshot ) 见 ? (不 使 用 子 事务 ID) 


内 部 事务 ID 类 型 ( xid ) 是 32 位 ， 每 40 亿 事务 循环 。 然 而 这 些 函 数 导 出 一 个 64 位 格式 ， 是 使 
用 一 个 "epoch" 计 数 器 扩展 ， 所 以 在 安装 过 程 中 不 会 循环 。 这 些 画 数 使 用 的 数据 类 
型 txid_snapshot ， 存 储 在 某 时 刻 事物 ID 可 见 性 的 信息 。 其 组 件 描述 在 Table 9-57。 


Table 9-57. 快照 组 件 


a 描述 
ge 最 早 的 事务 ID (txid) 仍然 活动 。 所 有 较 早 事务 将 是 可 见 提交 了 ， 或 者 要 人 么 
死 掉 回 滚 了 。 


首先 作为 尚未 分 配 的 txid。 所 有 大 于 或 等 于 此 的 txids 作 为 这 时 的 快照 都 是 尚 


xmax 

未 开始 的 ， 因 此 不 可 见 。 

在 当前 快照 活动 的 txids。 这 个 列表 只 包含 在 xmin 和 xmax 之 间 的 活动 
xip list txids ; 有 可 能 活动 的 txids 高 于 xmax o 一 个 xmin &lt;= txid @lt; xmax , 


并 且 不 在 这 个 列表 中 的 txid， 是 在 快照 的 这 个 时 间 已 经 完成 的 ， 因 此 要 么 可 
见 或 死 掉 对 应 它 的 提交 状态 。 这 个 列表 不 包含 子 事务 的 txids。 


txid_snapshot 的 文本 表示 为 > _xmin_ : _xmax_ : _xip_list_ o 例如 10:20:10,14,15 意思 





为 : xmin=10, xmax=20, xip_list=10, 5 o 
为 10 20 p_list=10, 14, 15 


9.26. RAS HWE 


这 节 描 述 的 函数 用 来 控制 和 监视 PostgreSQL 安 


9.26.1. 配置 设置 贸 数 


Table 9-58 显 示 了 用 于 查询 和 修改 运行 时 配置 参数 的 函数 。 


Table 9-58. 配置 设置 函数 


米 
名 字 lel 描述 
型 
`current_setting(```setting_name ) text 获取 当前 的 设置 值 
“set config( setting Name , new value , ee 设置 参数 并 返回 新 
is_local ) 值 


current_setting 用 于 以 查 询 形式 获 取 setting_name 设置 的 当前 值 。 它 和 SQL 命 兮 SHOW 是 等 
效 的 。 比 如 : 


SELECT current_setting('datestyle'); 
current_setting 


ISO, MDY 
(1 row) 


set_config 将 参数 setting_name 设置 为 new_value > WSR is_local 为 true, AAAS 
只 应 用 于 当前 事务 。 如 果 你 希望 新 值 应 用 于 当前 会 话 ， 那 么 应 该 使 用 false, 它 等 效 于 
SQL AA SET 。 比 如 : 


SELECT set_config('log_statement_stats', 'off', false); 


set_config 


Table 9-59 里 的 函数 向 其 他 服务 器 进程 发 送 控制 信号 。 通常 这 些 画 数 的 使 用 限制 为 超级 用 
户 ， 除 了 提 到 的 例外 。 


Table 9-59. 服务 器 信号 范 数 


名 字 返回 类 型 描述 
取消 一 个 后 端的 当前 查询 。 您 可 以 对 另 一 


_pg-cancel_backend( ”pid eee 个 后 端 执 行 这 个 函数 ， 这 个 后 端 有 和 调 
int ) 用 这 个 函数 的 用 户 相同 的 角色 。 在 所 有 其 


他 情况 下 ， 您 必须 是 超级 用 户 。 
导致 所 有 服务 器 进程 重新 装载 它们 的 配置 


pg_reload_conf() boolean 


文件 
pg_rotate_logfile() boolean 滚动 服务 器 的 日 志文 件 

终止 一 个 后 端 。 您 可 以 对 另 一 个 后 端 执 行 
-pg_terminate_backend( pid en ”这 个 函数 ， 这 个 后 端 有 和 调用 这 个 函数 
int ) 的 用 户 相 同 的 角色 。 在 所 有 其 他 情况 下 ， 


您 必须 是 超级 用 户 。 
如 果 成 功 ， 这 些 范 数 返 回 true, ANRE] false o 


pg_cancel_backend 和 pg_terminate_backend 向 由 pid 标识 的 后 端 进程 发 送 一 个 信号 (分 别 是 
SIGINT 或 SIGTERM) 。 一 个 活动 的 后 端 进 程 的 PID 可 以 从 pg_stat_activity 视图 的 

pid 字段 找到 ， 或 者 在 服务 器 上 列 出 postgres 进程 (在 Unix 上 使 用 ps 或 在 Windows 上 使 用 
Task Manager) 。 一 个 活动 的 后 端 角 色 可 以 从 pg_stat_activity 视图 的 usename 字段 找 
到 。 


pg_reload_conf 给 服务 器 发 送 一 个 SIGHUP 信 号 ， 导致 所 有 服务 器 进程 重新 装载 配置 文件 。 


pg_rotate_logfile 给 日 志文 件 管理 器 发 送信 号 ， A 告诉 它 立 即 切换 至 = 个 新 的 输出 文件 。 这 个 
男 数 只 有 在 内 建 的 日 志 收 集 器 运行 的 时 候 寺 有 用 ， 人 否则 根本 不 存在 日 志文 件 管理 器 子 进 程 。 


9.26.3. 各 份 控制 函数 


Table 9-60 里 的 函数 帮助 我 们 进行 在 线 备 份 。 这 些 函 数 不 能 在 恢复 时 执行 ( 除 


了 pg_is_in_backup , pg_backup_start_time 和 pg_xlog_location_diff ) 





Table 9-60. 44742 tll BX 


名 


~pg_create_restore_point( ~~ name 


text ) 


pg_current_xlog_insert_location() 


pg_current_xlog_location() 


~pg_start_backup( ~~ label 


fast boolean ]) 


pg_stop_backup() 


pg_is_in_backup() 


pg_backup_start_time() 





pg_switch_xlog() 


~pg_xlogfile_name( ~~~ location 


text ) 


~pg_xlogfile_name_offset( ~~ location 


text ) 


~pg_xlog_location_diff( ~~~ location 


text , location 


返回 类 型 


text 


text 


text 


text 


text 


bool 


timestamp with time zone 


text 


text 


text , integer 


numeric 


描述 


为 执行 恢复 创建 
一 个 命名 点 ( 限 
制 为 超级 用 户 ) 


获取 当前 事务 日 
志 的 插入 位 置 


获取 当前 事务 日 
志 的 写 人 位 置 


准备 执行 在 线 备 
份 (限制 为 超级 
用 户 或 复制 的 角 
色 ) 


完成 执行 在 线 各 
份 (限制 为 超级 
用 户 或 复制 的 角 
色 ) 


如 果 在 线 专属 各 
份 仍 在 进行 中 则 
为 真 。 


获取 进行 中 的 在 
线 专属 各 份 的 开 
台 时 间 。 


强制 转向 一 个 新 
的 事务 日 志文 件 
(限制 为 超级 用 
户 ) 


将 事务 日 志 的 位 
置 字 符 串 转换 为 
文件 名 


将 事务 日 志 的 位 
置 字符 串 转 换 为 
文件 名 并 返回 在 
文件 中 的 字 节 偏 


移 量 


计算 两 个 事务 日 
志 位 置 之 间 的 区 
别 


pg_start_backup 接受 一 个 用 户 定义 的 备份 标签 (通常 这 是 备份 转 储 文件 存放 地 点 的 名 字 )。 这 
个 函数 向 数据 库 集群 的 数据 目录 写 入 一 个 备份 标签 文件 ( backup_label )， 执 行 一 次 检查 点 ， 
然后 以 文本 方式 返回 各 份 的 事务 日 志 起 始 位 置 。 用 户 可 以 忽略 这 个 返回 值 ， 提 供 它 只 是 为 了 


万 一 需要 的 场合 。 


postgres=# select pg_start_backup('label_goes_here'); 
pg_start_backup 


0/D4445B8 
(1 row) 


SHA BHP OA KH boolean 的 参数 。 如 果 为 true, 那么 指定 尽 可 能 快 的 执 
行 pg_start_backup 。 这 强制 一 个 立即 的 检查 点 ， 将 导致 WO 操 作 有 一 个 尖峰 ， 减 缓 任何 当前 
执行 的 查询 。 


pg_stop_backup 删除 pg_start_backup 创建 的 标签 文件 ， 并 且 在 事务 日 志 为 档 区 里 创建 一 人 
备份 历史 文件 。 这 人 TSC ELS 予 pg_start_backup 的 标签 、 各 份 的 事务 日 志 起 始 与 终止 
位 置 、 各 份 的 起 始 和 终止 时 间 。 SIE a ASPET Ai oa AH tT A), 计算 
出 终止 位 置 后 ， 当前 事务 日 志 的 插入 点 将 自动 前 进 到 下 一 个 事务 日 志文 件 ， 这 样 ， 结束 的 事 
务 日 志文 件 可 以 被 立即 妇 档 从 而 完成 各 份 。 


pg_switch_xlog 移动 到 下 一 个 事务 日 志文 件 ， 以 允许 将 当前 日 志文 件 妇 档 (假定 你 使 用 连续 
档 )。 返 回 值 是 刚刚 完成 的 事务 日 志文 件 的 事务 日 志 结束 位 置 + 1。 如 果 自 从 最 后 一 en 
志 切 换 以 来 没有 活动 的 事务 日 志 ， 那么 pg_switch_xlog 什么 事 也 不 做 ， 直接 返回 当前 使 用 的 
事务 日 志文 件 的 开始 位 置 。 


pg_create_restore point 创建 一 个 可 以 用 作 恢 复 目 标的 命名 的 事务 日 志 记 录 ， 并 返回 相应 的 
事务 日 志 位 置 。 给 定 的 名 字 可 以 被 recovery target name 使 用 以 指定 恢复 将 进行 到 的 点 。 避 
免 使 用 相同 的 名 字 创 建 多 个 恢复 点 ， 因为 恢复 将 在 第 一 个 名 字 匹 配 恢 复 目 标的 位 置 停止 。 


pg_current_xlog_location 使 用 与 前 面 那些 范 数 相同 的 格式 显示 当 前 事务 日 志 的 写 入 位 置 。 

类 似 的 ， pg_current_xlog_insert_location 显示 当 前 事务 日 志 的 插入 位 置 。 插入 点 是 事务 日 
志 在 某 个 瞬间 的 "逻辑 终点 "， 而 实际 的 写 入 位置 则 是 从 服务 器 内 部 缓冲 区 写 出 时 的 终点 。 写 
和 位置 是 可 以 从 服务 器 外 部 检测 到 的 终点 ， 如 果 想 为 档 部 分 完成 的 事务 日 志文 件 ， 那 么 这 个 
通常 就 是 你 想 要 的 结果 。 插 入 点 主要 用 于 服务 器 调试 目的 。 上 述 两 个 函数 既是 只 读 操 作 也 不 
需要 超级 用 户 权限 。 


可 以 使 用 pg xlogfile_name_offset 从 前 述 本 数 的 返回 结果 中 抽取 相应 的 事务 日 志文 件 名 称 和 
字 节 偏 移 量 。 例 如 : 


postgres=# SELECT * FROM pg_xlogfile_name_offset(pg_stop_backup()); 
file_name | file_offset 
a a a ee ab lave ee EOE E A 
00000001000000000000000D | 4039624 
(1 row) 


类 似 的 ， pg_xlogfile_name 仅仅 抽取 事务 日 志文 件 名 称 。 如 果 给 定 的 事务 日 志 位 置 恰好 位 于 
ee 这 两 个 函数 都 返回 前 一 个 事务 日 志文 件 的 名 字 。 这 对 于 管理 事务 日 
志 为 档 来 说 通常 是 期 望 的 行为 ， 因 为 前 一 个 文件 是 当前 最 后 一 个 需要 为 档 的 文件 。 


pg_xlog_location_diff 计算 两 个 事务 日 志 位 置 之 间 在 字 节 上 的 不 同 。 它 可 以 
和 pg_stat_replication 或 Table 9-60 里 面 的 一 些 画 数 一 起 使 用 以 获取 复制 滞后 。 


有 关 正 确 使 用 这 些 函 数 的 细节 ， 参 阅 Section 24.3。 


9.26.4. 恢复 控制 函数 


Table 9-61 里 显示 的 函数 提供 了 当前 备 机 状态 的 信息 。 这 些 函 数 可 能 在 恢复 期 间或 正常 运行 


中 执行 。 


Table 9-61. 恢复 信息 函数 


名 字 返回 类 型 





pg_is_in_recovery() bool 
pg_last_xlog_receive_location() text 
pg_last_xlog_replay_location() text 
pg_last_xact_replay_timestamp() timestamp with time zone 





描述 


如 果 恢 复 仍 然 在 进行 
中 则 返回 true。 


获取 最 后 一 个 事务 日 
志 接 收 并 通过 流 媒 体 
复制 同步 到 磁盘 的 位 
置 。 如 果 流 复制 仍 
在 进行 ， 这 将 单调 增 
加 。 如 果 恢 复 已 完 

成 ， 那么 这 个 值 将 
保持 静止 在 恢复 期 间 
最 后 接收 和 同步 到 磁 
盘 的 WAL 记 录 值 。 

如 果 不 能 用 流 复制 ， 
或 还 没有 开始 ， 这 个 
函数 返回 NULL。 


获取 最 后 一 个 事物 日 
志 在 恢复 时 重 放 的 位 
置 。 如 果 恢 复 仍 在 进 
行 ， 这 将 单调 增加 。 
如 果 恢 复 已 经 完成 ， 
那么 这 个 值 将 保持 静 
止 在 恢复 期 间 最 后 应 
用 的 WAL 记 录 值 。 

当 服 务 已 经 没有 恢复 
的 正常 启动 时 ， 这 个 
E23 I] NULL. 


获取 最 后 一 个 事物 在 
恢复 时 重 放 的 时 间 
Bo REJETE 
上 生成 的 事务 提交 或 
终止 WAL 记 录 的 时 
间 。 如 果 没 有 事务 
在 恢复 时 重 放 ， 那 么 
这 个 函数 返回 
NULL。 否 则 ， 如 果 
恢复 仍 在 进行 ， 那 
么 这 将 单调 增加 。 如 
果 恢 复 已 经 完成 ， 那 
么 这 个 值 将 保持 静止 
在 恢复 时 最 后 事务 应 
用 的 值 。 当 服 务 已 
经 没有 恢复 的 正常 E 
动 时 ， 这 个 函数 返回 
NULL. 


Table 9-62 里 的 函数 控制 恢复 的 进程 。 这 些 函 数 可 能 只 在 恢复 时 被 执行 。 


Table 9-62. 恢复 控制 函数 


名 字 返回 类 型 描述 





pg_is_xlog_replay_paused( ) bool 如 果 恢 复 暂 停 则 返回 true。 
pg_xlog_replay_pause() void 立即 暂停 恢复 。 
pg_xlog_replay_resume() void 如 果 恢复 暂停 了 那么 重新 启动 。 


当 恢 复 暂 停 时 ， 没 有 进一步 的 数据 库 更 改 。 如 果 是 在 热 各 里 ， 所 有 新 的 查询 将 看 到 相同 一 致 
的 数据 库 快照 ， 并 且 不 会 有 进一步 的 查询 冲突 产生 ， 直 到 恢复 继续 。 


如 果 不 能 使 用 流 复制 ， 那 么 暂停 状态 将 没有 问题 的 无 限 的 延续 。 当 流 复制 正在 进行 时 ， 将 连 
续 接收 WAL 记 录 ， 这 将 最 终 填 满 可 用 磁盘 空间 ， 取 决 于 暂停 的 持续 时 间 ， WAL 生 成 的 速度 和 
可 用 的 磁盘 空间 。 


9.26.5. 快照 同步 函数 


PostgreSQL 人 允许 数据 库 会 话 同 步 他 们 的 快照 。snapshot 决定 哪个 数据 对 于 使 用 这 个 快照 的 事 
务 是 可 见 的 。 当 两 个 或 更 多 会 话 需 要 查看 数据 库 中 相同 的 内 容 时 ， 快照 同步 是 必须 的 。 如 果 
两 个 会 话 只 是 单独 的 启动 它们 的 事务 ， 仍 然 可 能 有 某 些 事务 在 这 两 个 START TRANSACTION MA 
执行 之 间 提 交 ， 所 以 一 个 会 话 看 到 了 那个 事务 的 影响 而 另外 一 个 没有 看 到 。 


要 解决 这 些 问 题 ，PostgreSQL 人 允许 一 个 事务 export 它 正在 使 用 的 快照 。 只 要 导出 事务 保持 打 
开 ， 其 他 事务 可 以 import 它 的 快照 ， 因 此 来 保证 他 们 看 到 的 是 与 第 一 个 事务 看 到 的 完全 相同 
的 数据 库 视 图 。 但 是 要 注意 的 是 ， 由 任 一 这 些 事务 做 出 的 任何 数据 库 更 改 对 其 他 事务 保持 不 
可 见 ， 对 由 未 提交 的 事务 做 出 的 更 改 同样 适用 。 所 以 事务 是 与 已 经 存在 的 数据 同步 的 ， 但 是 
对 它们 自己 做 的 更 改正 常 动作 。 


快照 是 由 pg_export_snapshot 本 数 输出 的 ， 在 Table 9-63 里 面 显示 ， 并 且 是 由 SET 
TRANSACTION 命 令 输 入 的 。 


Table 9-63. (RFR [Al EI% 


名 字 返回 类 型 描述 
pg_export_snapshot() text 保存 当前 的 快照 并 返回 它 的 标识 符 
EŻ pg_export_snapshot 保存 当前 的 快照 并 返回 一 个 text 字符 串 标 识 这 个 快照 。 这 个 字符 
串 必 须 传 递 〈 在 数据 库 外 面 ) 给 想 要 导 和 人 快照 的 客 户 端 。 这 个 快照 只 在 事务 结束 输出 它 之 前 
是 可 以 导入 的 。 如 果 需 要 的 话 ， 一 个 事务 可 以 输出 多 个 快照 。 请 注意 ， 这 桩 做 只 
在 READ COMMITTED 事务 中 有 用 ， 因为 在 REPEATABLE REA 和 更 高 的 隔离 级 别 ， 事 务 在 他 们 的 
生存 周期 中 使 用 相同 的 快照 。 一 旦 一 个 事务 已 经 输出 了 任何 的 快照 ， 它 就 不 能 


用 PREPARE TRANSACTION 做 好 准备 了 。 


参阅 SET TRANSACTION 获 取 如 何 使 用 一 个 输出 的 快照 的 信息 。 


9.26.6. Sia Et R EEA 


Table 9-64 里 显示 的 函数 计算 数据 库 对 象 使 用 的 磁 冯 空间 。 
Table 9-64. 数据 库 对 象 尺 寸 函 数 


名 字 描述 
— 存储 一 个 指定 的 数值 需要 的 字 节 数 
pg_column_size(** any ) int (可 能 压缩 过 ) 
‘pg_database_size(>>*oid ) bigint pe OID 代 胡 的 数据 库 使 用 的 磁 瘟 
`pg_database_size(```name ) bigint 指定 名 称 的 数据 库 使 用 的 磁盘 空间 
ee saeene e piers Soe eases 


指定 表 或 索引 的 指定 分 又 树 
bigint ( 'main' , 'fsm' 或 'vm' ) 使 用 的 


磁盘 空间 


pg relation size( relation 
regclass , fork text ) 


`pg_relation_size( `` relation 


人 bigint pg_relation_ size(...，'main') 的 简写 
ER ,axt ”把 用 64 位 整数 表示 的 字 节 计 算 的 尺 二 
转换 成 一 个 人 类 易 读 的 尺寸 
`pg_size_pretty(```numeric ) text 把 用 数值 表示 的 字 节 计 算 的 尺寸 转换 
成 一 个 人 类 易 读 的 尺寸 
指定 的 表 使 用 的 磁盘 空间 ， 不 计 索 引 
`pg_table_size(```regclass ) bigint (但 是 包含 TOAST， 自 由 空间 映射 
和 可 见 性 映射 ) 
ae: nine E OD REOR H EAR 
`pg_tablespace_size(```name ) bigint HAE BFN RZ | (A A e i 


`pg_total_relation_size(```regclass ) bigint E ee 间 ， 包 括 所 


pg_column_size 显示 用 于 存储 某 个 独立 数据 值 的 空间 。 


pg_total_relation_size 接受 一 个 表 或 压缩 表 的 OID 或 名 字 ， 并 且 返 回 那 个 表 使 用 的 总 的 在 磁 
意 上 的 空间 ， 包括 所 有 相关 的 索引 。 这 个 函数 相当 于 pg_table_size + pg_indexes_size 


pg_table_size 接受 一 个 表 的 OID 或 名 字 ， 并 且 返 回 那个 表 需 要 的 磁盘 空间 ， 不 包括 索引 。 
(包含 TOAST 空 间 ， 自 由 空间 映射 和 可 见 性 映射 ) 


pg_indexes_size 接受 一 个 表 的 OID 或 名 字 ， 并 且 返 回 所 有 附加 到 这 个 表 上 的 索引 使 用 的 总 的 
WEN 


pg_database_size 和 pg_tablespace_size 接受 一 个 数据 库 或 表 空 间 的 OID 或 名 字 ， 并 且 返 回 

该 对 象 使 用 的 总 的 磁 角 空 间 。 

pg_relation_size 接受 一 个 表 、 索 引 、 不 缩 表 的 OID 或 者 名 字 ， 然后 返回 它们 以 字 节 计 的 磁 
AKA, EE 'main' 或 省 略 第 二 个 参数 返回 这 个 关系 的 主 数 据 支 路 的 大 小 。 指 定 fsm 返 
回 和 这 个 关系 有 关 的 自由 空间 映射 (参阅 Section 58.3) 的 大 小 。 指定 'vm' 返回 和 这 个 关系 
有 关 的 可 见 性 映射 、( 参 阅 Section 58.4) 的 大 小 。 请 注意 ， 这 个 画 数 只 显示 一 个 支 路 的 大 小 ; 
更 多 的 是 想 更 方便 的 使 用 高 级 酌 数 pg_total_relation_size 或 pg_table_size o 


pg_size_pretty 用 于 把 其 它 函 数 的 结果 格式 化 成 一 种 人 类 易 读 的 格式 ， 可 以 根据 情况 使 用 KB 
. MB, GB, TB. 

以 上 操作 在 表 或 索引 上 的 函数 接受 一 个 regclass 参数 ， 这 个 参数 简单 的 是 表 的 OID 

或 pg_class 系统 目录 中 的 索引 。 你 不 需要 手动 的 去 查看 OID， 因为 regclass 数据 类 型 的 输 

入 转换 将 为 你 做 这 件 事 。 只 需要 写 下 包含 在 单 引 号 中 的 表 名 ， 这 样 看 起 来 像 是 一 个 字符 串 常 
量 。 为 了 与 普通 的 SQL 名 字 的 义理 兼容 ， 这 个 字符 串 将 被 转换 成 小 宇 ， 除 非 表 名 用 双 引 号 括 
起 。 


如 果 一 个 不 代表 活动 对 象 的 OID 传 递 给 以 上 一 个 函数 的 参数 ， 那 么 返回 NULL。 
Table 9-65 里 显示 的 本 数 帮助 标识 指定 的 与 数据 库 对 象 有 关 的 磁盘 文件 。 


Table 9-65. 数据 库 对 象 位 置 函 数 


名 字 返回 类 型 描述 
~*pg_relation_filenode(~**relation regclass ) oid 指定 关系 的 文件 节 点 数 
`pg_relation_filepath(```relation regclass ) text 指定 关系 的 文件 路 径 名 


pg_relation_filenode 接受 一 个 表 、 索 引 、 序 列 或 压缩 表 的 OID 或 者 名 字 ， 并 且 返 回 当 前 分 配 
给 它 的 "filenode" 数 。 文 件 节点 是 关系 使 用 的 文件 名 字 的 基本 组 件 (参阅 Section 58.1 获 取 更 
多 信息 ) 。 对 大 多 数 表 来 说 ， 结果 和 pg_class . relfilenode 相同 ， 但 对 确定 的 系统 目录 来 
说 ， relfilenode 为 0 而 且 这 个 函数 必须 用 来 获取 正确 的 值 。 如 果 传递 一 个 没有 存储 的 关 
系 ， 上 比如 一 个 视图 ， 那 么 这 个 函数 返回 NULL。 


pg_relation_filepath 类 似 于 pg_relation_filenode , 但 是 它 返 回 关系 的 整个 文件 路 径 名 
(相对 于 数据 库 集群 的 数据 目录 PGDATA ) o 


9.26.7. AM HiFi KR 


Table 9-66 里 的 函数 提供 了 对 数据 库 服 务 器 所 在 机 器 上 的 文件 的 本 地 访问 接口 。 只 有 那些 在 
数据 库 集 群 目录 和 log directory 目录 里 面 的 文件 可 以 访问 。 使 用 相对 路 径 访问 集群 目录 里 
面 的 文件 ， 以 及 匹配 10g directory 配置 设置 的 路 径 访 问 日 志文 件 。 只 有 超级 用 户 才能 使 用 


Table 9-66. i HXi} iF] EX 
名 字 返回 类 型 描述 
| 录 
EEC text ) setof text a 
` 一 个 
ee enang text [, offset bigint , Hone eh 
length bigint ]) = 
合 
` pg read binary file( filename text [, offset bytea 返回 一 个 文 
bigint , length bigint ]) 件 的 内 容 
S AN 
“pg Stat file( filename text ) record FARI 
pois dir 返回 指定 目录 里 面 的 除了 特殊 项 ”." 和 " .. "之 外 的 所 有 名 字 。 


pg_read_file 1% 返回 一 个 文本 文件 的 一 部 分 ， 从 offset 开始 ， 返回 最 多 length 字 节 (如 果 先 
达到 文件 结尾 ， 则 小 于 这 个 数值 )。 如 果 offset 是 负数 ， 那 么 它 就 是 相对 于 文件 结尾 回 退 的 

KE. 如 果 省 略 了 offset 和 length ， 则 返回 整个 文件 。 从 文件 读 取 到 的 字 节 在 服务 器 编码 

里 被 解释 为 一 个 字符 串 ; 如 果 它 们 在 那 种 编码 下 是 不 可 用 的 则 抛 出 一 个 


va 
错 IRo 


pg_read_binary_file (UF pg_read file , 除了 结果 是 bytea 值 ; 因此 ， 不 执行 编码 检 
查 。 与 convert_from 图 数 结合 ， 这 个 图 数 可 以 用 来 读 取 用 指定 编码 的 一 个 文件 。 


SELECT convert_from(pg_read_binary_file('file_in_utf8.txt'), 'UTF8'); 


pg_stat_file 返回 一 个 记录 ， 这 个 记录 包含 文件 大 小 ， 最 后 访问 的 时 间 惟 ， 最 后 修改 的 时 间 


惟 ， 最 后 文件 状态 改变 的 时 间 戳 〈 只 在 Unix 平 台 上 ) ， 文件 创建 的 时 间 戳 (RE 
Windows) ， 和 一 个 boolean 表明 是 否 为 一 个 路 径 。 典型 的 用 法 包括 : 


SELECT * FROM pg_stat_file('filename'); 
SELECT (pg_stat_file('filename' )).modification; 


9.26.8. Sigs ne 


Table 9-67 中 的 画 数 用 于 管理 咨 
阅 Section 13.3.4。 


询 锁 (Advisory Lock), AX EME H E 


Table 9-67. 咨询 锁 画 数 
名 字 返回 类 型 描述 
~pg_advisory_lock(***key bigint ) void 获取 排他 会 话 级 别人 咨询 锁 
‘pg_advisory lock( key1 int , key2 


int ) 
`pg_advisory_lock_shared(```key bigint ) 
`pg_advisory_lock_shared( `° key1 int 
key2 int ) 


`pg_advisory_unlock(```key bigint ) 


~pg_advisory_unlock(*~*keyi int , key2 
int ) 


pg_advisory_unlock_all() 


`pg_advisory_unlock_shared(```key bigint ) 


`pg_advisory_unlock_shared(```key1 int 
key2 int ) 


`pg_advisory_xact_lock(```key bigint ) 


`pg_advisory_xact_lock(```key1 int , key2 
int ) 


`pg_advisory_xact_lock_shared(```key 
bigint ) 


`pg_advisory_xact_lock_shared(```key1 
int , key2 int ) 


~pg_try_advisory_lock(*~*~key bigint ) 


~pg_try_advisory_lock(*~~*key1 int , key2 
int ) 

~pg_try_advisory_lock_shared( ~~ key 
bigint ) 
`pg_try_advisory_lock_shared(```key1 int 


key2 int ) 


pg try advisory xact lock key bigint ) 


ipg try advisory xact rock “key int 
key2 int ) 


‘pg_try_advisory_xact_lock_shared( ~~~ key 
bigint ) 


`pg try _ advisory _xact_lock_shared(  key1 
int , key2 int ) 


void 


void 


boolean 


boolean 


void 


boolean 


boolean 


void 


void 


void 


void 


boolean 


boolean 


boolean 


boolean 


boolean 


boolean 


boolean 


boolean 


获取 共享 会 话 级 别 咨询 锁 
获取 共享 会 话 级 别 咨询 锁 
释放 一 个 排他 会 话 级 别 咨 
询 锁 


释放 一 个 排他 会 话 级 别 咨 
询 锁 


释放 所 有 当前 会 话 持 有 的 
会 话 级 别 咨询 锁 


释放 一 个 共享 会 话 级 别 咨 
询 锁 


释放 一 个 共享 会 话 级 别 咨 
询 锁 


获取 排他 事务 级 别 咨 询 锁 
获取 排他 事务 级 别 咨询 锁 


获取 共享 事务 级 别 咨询 锁 


获取 共享 事务 级 别 咨 询 锁 


尝试 获取 排他 会 
询 锁 


尝试 获取 排他 会 话 级 别 咨 
询 锁 


尝试 获取 共享 会 话 级 别 咨 
询 锁 


尝试 获取 共享 会 话 级 别 咨 
询 锁 


尝试 获取 排他 事务 级 别 次 
询 锁 


尝试 获取 排他 事务 级 别 次 
询 锁 


尝试 获取 共享 事务 级 别 咨 
询 锁 


尝试 获取 共享 事务 级 别 咨 
询 锁 


话 级 别 咨 


pg_advisory_lock 锁定 一 个 应 用 程序 定义 的 资源 ， 该 资源 可 以 用 一 个 64 ALEX SAR BY 
32 位 键 值 标 识 。 如 果 已 经 有 另外 的 会 话 锁定 了 该 资源 ， 那么 该 函数 将 会 阻塞 到 该 资源 可 用 为 
止 。 这 个 锁 是 排 它 的 。 多 个 锁定 请 求 将 会 被 讨 入 栈 中 ， 因 此 ， 如 果 同 一 个 资源 被 锁定 了 三 
次 ， 那 么 它 必须 被 解锁 三 次 以 将 资源 释放 给 其 它 会 话 使 用 。 


pg_advisory_lock_shared 类 似 于 pg_advisory_lock, 不 同 之 处 仅 在 于 共享 锁 可 以 和 其 它 请 求 
共享 锁 的 会 话 共 享 ， 但 排他 锁 除 外 。 


pg_try_advisory_lock 类 似 于 pg_advisory_lock , ARAN 2 IEF GR 村 数 不 会 阻塞 以 等 待 资源 
的 释放 。 它 要 么 立即 获得 锁 并 返回 true ， 要 么 返回 false 表示 目前 不 能 锁定 。 


pg_try_advisory_lock_shared 类 似 于 pg_try_advisory_lock , 不 同 之 处 在 于 该 函数 党 试 获 得 
一 个 共享 锁 而 不 是 一 个 排 它 锁 。 


pg_advisory_unlock 释放 先前 取得 的 排他 会 话 级 别 咨 询 锁 。 如 果 释 放 成 功 则 返回 true. A 
果 指 定 的 锁 并 未 持 有 ， 那么 它 将 返回 false 并 且 服 务 器 会 报告 一 条 SQL SHEA. 


pg_advisory_unlock_shared 类 似 于 pg_advisory_unlock ， 不 同 之 处 在 于 该 函数 释放 的 是 共享 
会 话 级 别 咨询 锁 。 

pg_advisory_unlock_all 将 会 释放 当前 会 话 持 有 的 所 有 会 话 级 别 咨询 锁 ， 该 范 数 在 会 话 结束 
的 时 候 被 隐 仿 调用， 即使 客户 端 异常 地 断 开 连 接 也 是 一 样 。 

pg_advisory_xact_lock 类 似 于 pg_advisory_lock, 不 同 之 处 在 于 锁 是 自动 在 当前 事务 的 结束 
释放 的 ， 而 且 不 能 被 显 式 的 释放 。 

pg_advisory_xact_lock_shared 类 似 于 pg_advisory_lock_shared , 不 同 之 处 在 于 锁 是 自动 在 
当前 事务 的 结束 释放 的 ， 而 且 不 能 被 显 式 的 释放 。 


pg_try_advisory_xact_lock 类 似 于 pg_try_advisory_lock ， 不 同 之 处 在 于 锁 ， 如 果 得 到 ， 是 
自动 在 当前 事务 的 结束 释放 的 ， 而 且 不 能 被 显 式 的 释放 。 


pg_try_advisory_xact_lock_shared 类 似 于 pg_try_advisory_lock_shared , 不 同 之 处 在 于 锁 ， 
如 果 得 到 ， 是 自动 在 当前 事务 的 结束 释放 的 ， 而 且 不 能 被 显 式 的 释放 。 


9.27. fh & Ar NX 


4 Ai PostgreSQL CDA EHAE & 25H 2X,  suppress_redundant_updates_trigger , 其 将 阻 
止 任何 不 会 实际 更 改行 中 的 数据 发 生 ， 相 反 不 管 数据 是 否 已 经 改变 始终 执行 的 更 新 这 种 不 正 

常 的 行为 。 (这 是 正常 的 行为 ， 使 得 更 新 运行 速度 更 快 ， 因 为 不 需要 检查 ， 并 在 某 些 情况 下 
也 是 有 用 的 。) 


理想 的 情况 下 ， 你 通常 应 该 避免 运行 实际 上 并 没有 改变 记录 中 的 数据 的 更 新 。 宛 余 更 新 会 花 
费 大 量 不 必要 的 时 间 ， 尤 其 是 如 果 有 大 量 素 引 要 改变 ， 并 且 最 终 将 不 得 不 清空 死 行 中 的 空 
间 。 然 而 ， 在 客户 端 代码 检测 这 种 情况 并 不 总 是 容易 的 或 甚至 可 能 的 ， 而 写 表 达 式 以 检测 到 
它们 容易 产生 错误 。 另 一 种 方法 是 使 用 suppress_redundant_updates_trigger ， 它 可 以 跳 过 不 
改变 数据 的 更 新 。 不 过 你 应 该 小 心 使 用 这 个 命 舍 。 触 发 器 为 每 条 记录 花费 小 但 有 意义 的 时 
间 ， 所 以 如 果 更 新 实际 改变 会 影响 大 多 数 记 录 ， 那 么 此 触发 器 的 使 用 将 实际 上 使 更 新 运行 得 
更 慢 。 


suppress_redundant_updates_trigger KATARE LAR ž 


CREATE TRIGGER z_min_update 
BEFORE UPDATE ON tablename 
FOR EACH ROW EXECUTE PROCEDURE suppress_redundant_updates_trigger(); 


在 大 多 数 情况 下 ， 你 可 能 想 要 在 每 行 的 后 面 触 发 这 个 触发 器 。 记 住 触发 器 是 以 名 字 的 顺序 触 
发 的 ， 你 应 该 在 表 中 你 有 的 任何 其 他 触发 器 后 面 选 择 一 个 触发 器 名 字 。 


更 多 有 关 创 建 触发 器 的 信息 请 参阅 CREATE TRIGGER, 


9.28. SAR R BL 


+4 A] PostgreSQL -DNA HS Ak & AS BEEN = pg_event_trigger_dropped_objects o 


pg_event_trigger_dropped_objects 


返回 一 个 在 sql_drop 事件 中 调用 的 命令 删除 的 所 有 对 象 


的 列表 。 如 果 在 任何 其 他 上 下 文中 调用 ， pg_event_trigger_dropped_objects 将 抛 出 一 个 错 
误 。 pg_event_trigger_dropped_objects 返回 下 列 的 字段 z 


aF 类 型 
classid Oid 
objid Oid 
objsubid int32 
object_type text 
schema_name text 
object_name text 
object_identity text 


pg_event_trigger_dropped_objects 


描述 
对 象 所 在 的 目录 的 OID 
目录 中 对 象 的 OID 
对 象 的 sub-id( 例 如 ， 字 段 的 属性 个 数 ) 
对 象 的 类 型 
如 果 有 ， 为 对 象 所 在 模式 的 名 字 ; 否则 为 NULL 。 不 用 双 


引号 。 


如 果 模 式 和 名 字 的 组 合 可 以 用 来 唯一 的 标识 对 象 ， 那 么 
就 是 对 象 的 名 字 ; 否则 为 NULL 。 不 用 双 引 号 ， 并 且 名 
字 是 从 不 模式 限定 的 。 


对 象 身份 的 文本 表现 ， 模 式 限定 的 。 每 个 标识 符 在 身份 
中 出 现时 要 在 必要 时 引用 。 


函数 可 以 在 一 个 事务 触发 器 中 使 用 : 


CREATE FUNCTION test_event_trigger_for_drops() 
RETURNS event_trigger LANGUAGE plpgsql AS $$ 


FOR obj IN SELECT * FROM pg_event_trigger_dropped_objects() 


object: % %.% %', 


DECLARE 
obj record; 
BEGIN 
LOOP 
RAISE NOTICE '% dropped 
tg_tag, 
obj .object_type, 
obj .schema_name, 
obj .object_name, 
obj .object_identity; 
END LOOP; 
END 
$$; 


ON sql_drop 


CREATE EVENT TRIGGER test_event_trigger_for_drops 


EXECUTE PROCEDURE test_event_trigger_for_drops(); 


关于 事务 触发 器 的 更 多 信息 请 参阅 Chapter 37, 


Chapter 10. 类 型 转换 
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SQL 语句 可 能 (有 意 无 意 地 ) 要 求 在 同一 表达 式 里 混合 不 同 的 数据 类 型 。 PostgreSQL 在 计算 混 
合 类 型 表达 式 方面 有 许多 扩展 性 很 强 的 功能 。 

在 大 多 数 情 况 下 ， 用 户 不 需要 明白 类 型 转换 机 制 的 细节 。 但 是 ， 由 PostgreSQL 所 进行 的 隆 含 
类 型 转换 会 对 查询 的 结果 产生 影响 ， 必要 时 这 些 影响 又 可 以 用 明确 类 型 转换 进行 剪裁 利用 。 


本 章 介 绍 PostgreSQL 类 型 转换 的 传统 和 机 制 。 关于 特定 的 类 型 和 男 数 及 操作 符 的 进一步 信 
息 ， 请 参考 Chapter 8 和 Chapter 9 里 的 相关 章节 。 


10.1. 概述 


SQL 是 强 类 型 语言 。 也 就 是 说 ， 每 个 数据 都 与 一 个 决定 其 行为 和 用 法 的 数据 类 型 相关 联 。 
PostgreSQL 有 一 个 可 扩展 的 数据 类 型 系统 ， 该 系统 比 其 它 SQL 实 现 更 具 通 用 性 和 灵活 性 。 
而 ， PostgreSQL 中 大 多 数 类 型 转换 是 由 通用 规则 来 管理 的 ， 而 不 是 由 专门 的 试探 法 分 析 
的 ， 这 种 做 法 允许 使 用 混合 类 型 的 表达 式 ， 即便 是 其 中 包含 用 户 定义 的 类 型 也 如 此 。 


PostgreSQL 扫 描 /分 析 器 只 将 词法 元 素 分 解 成 五 个 基本 种 类 : 整数 、 浮 点 数 、 字 符 串 、 标 识 
符 、 关 键 字 。 大 多 数 非 数 字 类 型 首先 表征 为 字符 串 ， SQL 语 言 的 定义 人 允许 将 类 型 名 声明 为 字 
FR, 这 个 机 制 被 PostgreSQL 用 于 保证 分 析 器 治 着 正确 的 方向 运行 。 例如 ， 下 面 查询 : 


SELECT text 'Origin' AS "label", point '(0,0)' AS "value"; 
label | value 

O pene eer ees pe ee eg a 

Origin | (0,0) 

(1 row) 


有 两 个 文本 常量 ， 类 型 分 别 为 text 和 point. 如 果 没 有 为 字符 串 文 本 声明 类 型 ， 该 文本 先 
被 初始 化 成 一 个 拥有 存储 空间 的 unknown 类 型 ， 该 类 型 将 在 后 面 描述 的 晚期 阶段 分 析 。 

在 PostgreSQL 分 析 器 里 ， 有 四 种 基本 的 SQL 元 素 需 要 独立 的 类 型 转换 规则 : 

PRLS FA 


多 数 PostgreSQL 类 型 系统 是 建筑 在 一 套 丰 富 的 函数 上 的 。 琅 数 调用 可 以 有 一 个 或 多 个 参数 。 
为 PostgreSQL 人 多 许 函 数 重 载 ， 所 以 了 画 数 名 自身 并 不 唯一 地 标识 将 要 调用 的 函数 ， 分 析 器 
必须 根据 范 数 提供 的 参数 类 型 选择 正确 的 玉 数 。 


操作 符 


PostgreSQL 人 允许 在 表达 式 上 使 用 前 级 或 后 级 ( 单 目 ) 操 作 符 ， 也 允许 表达 式 内 部 使 用 双 目 操作 
符 (两 个 参数 )。 像 函数 一 样 ， 操 作 符 也 可 以 被 重 载 ， 因此 操作 符 的 选择 也 和 男 数 一 样 取决 于 
参数 类 型 。 


值 存储 


INSERT 和 UPDATE 语句 将 表达 式 结果 放 入 表 中 。 语句 中 的 表达 式 类 型 必须 和 目标 字段 的 类 型 
一 致 或 者 可 以 转换 为 一 致 。 


UNION , CASE 和 相关 构造 


因为 联合 sELEcT 语句 中 的 所 有 查询 结果 必须 在 一 列 里 显示 出 来 ， 所 以 每 个 SELECT 子 句 中 的 
元 素 类 型 必须 相互 匹配 并 转换 成 一 套 统一 类 型 。 类 似 地 ， 一 个 case 构造 的 结果 表达 式 必须 
转换 成 统一 的 类 型 ， 这 样 case 表达 式 自 身 作 为 整体 有 一 种 已 知 输出 类 型 。 同样 的 要 求 也 存 
在 于 array 构造 以 及 GREATEST 和 Least ELH, 


系统 表 casts 存 储 有 关 哪 种 数据 类 型 之 间 存 在 哪 种 转换 以 及 如 何 执行 这 些 转换 的 信息 。 额外 的 
转换 可 以 由 用 户 通过 CREATE CAST 命 邻 增 加 。 这 个 通常 和 定义 一 种 新 的 数据 类 型 一 起 完 
成 。 内 置 的 类 型 转换 集 已 经 经 过 仔细 的 雕琢 了 ， 因此 最 好 不 要 去 更 改 它们 。 


分 析 器 中 还 提供 了 一 个 额外 的 搜索 器 ， 人 允许 提高 对 有 隐 合 转换 的 类 型 组 之 间 的 适当 的 转换 行 
为 的 决断 。 数据 类 型 分 成 了 几 个 基本 类 型 分 类 ， 包括 : boolean , numeric , string , 
bitstring , datetime , timespan , geometric , network , user-defined( FA  7E SL). (参阅 
列表 Table 47-52 ; 但 是 要 注意 的 是 创建 自 定义 的 类 型 分 类 也 是 可 能 的 。) 每 种 类 型 都 有 一 种 
或 多 种 首选 类 型 用 于 解决 类 型 选择 的 问题 。 小 心 的 选择 首选 类 型 和 可 用 的 隐 含 转换 ， 就 有 可 
能 保证 有 歧义 的 表达 式 (那些 有 多 个 候选 解析 方案 的 ) 可 以 用 有 效 的 方式 解决 。 


所 有 类 型 转换 规则 都 是 建立 在 下 面 几 个 基本 原则 上 的 : 
。 人 隐 含 转换 决 不 能 有 奇怪 的 或 不 可 预见 的 输出 。 


。 如 果 一 个 查询 不 需要 隐 含 的 类 型 转换 ， 分 析 器 或 执行 器 不 应 该 进行 更 多 的 额外 操作 。 这 
就 是 说 ， 任 何 一 个 类 型 匹配 、 格 式 清晰 的 查询 不 应 该 在 分 析 器 里 耗费 更 多 的 时 间 ， 也 不 
应 该 向 查询 中 引入 任何 不 必要 的 隐 含 类 型 转换 调用 。 


另外 ， 如 果 一 个 查询 通常 使 用 某 个 画 数 进 行 隐 含 类 型 转换 ， 而 用 户 定义 了 一 个 有 正确 参 
数 的 函数 ， 解释 器 应 该 使 用 新 阔 数 取代 原先 旧 范 数 的 隐 含 操作 。 


10.2. 操作 符 


下 面 讲 解 的 过 程 解释 了 操作 符 表 达 式 如 何 确定 引用 哪个 操作 符 。 请 注意 这 个 过 程 受 被 调用 操 
作 符 的 优先 级 影响 ， 因 为 这 将 决定 哪个 子 表达 式 被 用 来 作为 操作 符 的 输入 。 参阅 Section 
4.1.6 获 取 更 多 信息 。 


操作 符 类 型 解析 


1， 从 系统 表 pg_operator 中 选 出 要 考虑 的 操作 符 。 如 果 使 用 了 一 个 不 带 模式 修饰 的 操作 符 
名 (常见 的 状况 )， 那么 认为 该 操作 符 是 那些 在 当前 搜索 路 径 中 名 字 和 参数 个 数 都 匹配 的 
操作 符 (参阅 Section 5.7.3)。 如 果 给 出 一 个 带 修 饰 的 操作 符 名 ， 那么 只 考虑 指定 模式 中 
的 操作 符 。 


L 如果 搜 索 路 径 中 找到 了 多 个 相同 参数 类 型 的 操作 符 ， 那 么 只 考虑 最 早出 现在 路 笃 中 
的 那 一 个 。 但 是 不 同人 参数 类 型 的 操作 符 将 被 平等 看 待 ， 而 不 管 它们 在 路 径 中 的 位 置 
如 何 。 
2. 查找 精确 接受 输入 参数 类 型 的 操作 符 。 如 果 找 到 一 个 (在 一 组 被 考虑 的 操作 符 中 ， 可 能 只 
存在 一 个 精确 匹配 的 )， 则 用 之 。 


i， 如 果 一 个 双 目 操作 符 调 用 中 的 一 个 参数 是 unknown XE, 则 在 本 次 检查 中 假设 其 与 
另 一 个 参数 类 型 相同 。 包 括 两 个 unknown 输入 的 调用 或 一 个 一 元 带 有 unknown 输入 
的 操作 符 ， 将 绝 不 会 在 此 处 找到 匹配 。 
3 寻找 最 优 匹配 。 


i， 抛 奔 那 些 输 入 类 型 不 匹配 并 且 也 不 能 隐 式 转换 成 匹配 的 候选 操作 符 。 unknown 文本 
在 这 种 情况 下 可 以 转换 成 任何 东西 。 如 果 只 剩 下 一 个 候选 项 ， 则 用 之 ， 否 则 继续 下 
一 步 。 


i 通 历 所 有 候选 操作 符 ， 保 留 那些 输入 类 型 匹配 最 准确 的 。 此 时 ， 域 被 看 作 和 他 们 的 
基本 类 型 相同 。 如 果 没 有 一 个 操作 符 能 被 保留 ， 则 保留 所 有 候选 。 如 果 只 剩 下 一 个 
候选 项 ， 则 用 之 ， 否 则 继续 下 一 步 。 


ii， 通 历 所 有 候选 操作 符 ， 保 留 那些 需要 类 型 转换 时 接受 (属于 输入 数据 类 型 的 类 型 范畴 
的 ) 首 选 类 型 位 置 最 多 的 操作 符 。 如 果 没 有 接受 首选 类 型 的 操作 符 ， 则 保留 所 有 候 
选 。 如 果 只 剩 下 一 个 候选 项 ， 则 用 之 ， 否 则 继续 下 一 步 。 


iv. 如 果 有 任何 输入 参数 是 unknown 类 型 ， 检 查 剩 余 的 候选 操作 符 对 应 参数 位 置 的 类 型 
范畴 。 在 每 一 个 能 够 接受 字符 串 类 型 范畴 的 位 置 使 用 string 类 型 (这 种 对 字符 串 的 
偏爱 是 合适 的 ， 因为 unknown 文本 确实 像 字符 串 )。 另外， 如 果 所 有 剩 下 的 候选 操 
作 符 都 接受 相同 的 类 型 范畴 ， 则 选择 该 类 型 范畴 ， 否 则 抛 出 一 个 错误 (因为 在 没有 更 
多 线索 的 条 件 下 无 法 作出 正确 的 选择 )。 现在 抛 奔 不 接受 选 定 的 类 型 范畴 的 候选 操作 


符 ， 然 后 ， 如 果 任 意 候选 操作 符 在 某 个 给 定 的 参数 位 置 接受 一 个 首选 类 型 ， 则 抛弃 
那些 在 该 参数 位 置 接受 非 首选 类 型 的 候选 操作 符 。 如 果 没 有 一 个 操作 符 能 被 保留 ， 
则 保留 所 有 候选 。 如 果 只 剩 下 一 个 候选 项 ， 则 用 之 ， 否 则 继续 下 一 步 。 
v. 如 果 同 时 有 unknown 和 已 知 类 型 的 参数 ， 并 且 所 有 已 知 类 型 的 参数 都 是 相同 的 类 

型 ， 那么 假设 unknown 参数 也 是 那 种 类 型 ， 并 检查 哪个 候选 操作 符 在 unknown 参数 
位 置 接受 那个 类 型 。 如 果 只 有 一 个 操作 符 符合 ， 那 么 使 用 它 。 否 则 ， 产 生 一 个 错 
误 。 

下 面 是 一 些 例子 。 

Example 10-1. 阶乘 操作 符 类 型 解析 


在 系统 表 中 里 只 有 一 个 阶乘 操作 符 (后 级 ! ) ， 它 以 bigint 作为 参数 。 扫描 器 给 下 面 查询 
表达 式 的 参数 赋予 integer 的 初始 类 型 : 


SELECT 40 ! AS "40 factorial"; 
40 factorial 


815915283247897 734345611269596115894272000000000 
(1 row) 


分 析 器 对 参数 做 类 型 转换 ， 查 询 等 效 于 : 


SELECT CAST(40 AS bigint) ! AS "40 factorial"; 


Example 10-2. 字符 串 连接 操作 符 类 型 分 析 

一 种 字符 串 风 格 的 语法 既 可 以 用 于 字符 串 也 可 以 用 于 复 杀 的 扩展 类 型 。 未 声明 类 型 的 字符 串 
将 被 所 有 可 能 的 候选 操作 符 匹 配 。 

有 一 个 未 声明 的 参数 的 例子 : 


SELECT text 'abc' || 'def' AS "text and unknown"; 
text and unknown 


abcdef 
(1 row) 


本 例 中 分 析 器 寻找 两 个 参数 都 是 text 的 操作 符 。 确 实 这 样 的 操作 符 ， 因此 另 一 个 参数 就 被 
认为 是 text 类 型 。 


下 面 是 连接 两 个 未 声明 类 型 的 值 : 


SELECT 'abc' || 'def' AS "unspecified"; 
unspecified 


abcdef 
(1 row) 


因为 查询 中 没有 声明 任何 类 型 ， 所 以 本 例 中 对 类 型 没有 任何 初始 提示 。 因 此 ， 分 析 器 查找 所 
有 候选 操作 符 ， 发 现 既 存在 接受 字符 串 类 型 范畴 的 操作 符 也 存在 接受 位 串 类 型 范畴 的 操作 
F. 因为 字符 串 类 型 范畴 是 首选 ， 所 以 选择 字符 串 类 型 范畴 的 首选 类 型 text 作为 解析 未 知 
类 型 文本 的 声明 类 型 。 
Example 10-3. 绝对 值 和 取 反 操作 符 类 型 分 析 
PostgreSQL 操 作 符 表 里 面 有 几 条 记录 对 应 于 前 级 操作 符 @ ， 它们 都 用 于 为 各 种 数值 类 型 实 
现 绝对 值 操 作 。 其 中 之 一 用 于 floats 类 型 ， 它 是 数值 类 型 范畴 中 的 首选 类 型 。 因 此 ， 在 面 
对 unknown 输入 的 时 候 ， PostgreSQL 会 使 用 该 类 型 : 

SELECT @ '-4.5' AS "abs"; 


abs 


Weed, RATTA FA EVER VE ZB AA unknown 类 型 的 文字 为 floats 类 型 。 我 们 可 
以 验证 它 是 floats 而 不 是 其 它 类 型 : 


SELECT @ '-4.5e500' AS "abs"; 


ERROR: "-4.5e500" is out of range for type double precision 


另 一 方面 ， 前 级 操作 符 ~ ( 按 位 取 反 ) 只 为 整数 数据 类 型 定义 ， 而 不 为 floats EX. Alt, A0 
果 我 们 用 - 做 类 似 的 实验 将 得 到 : 


SELECT ~ '20' AS "negation"; 
ERROR: operator is not unique: ~ "unknown" 


HINT: Could not choose a best candidate operator. You might need to add 
explicit type casts. 


这 是 因为 系统 无 法 决定 几 个 可 能 的 - 操作 符 中 究竟 应 该 使 用 哪 一 个 。 我 们 可 以 用 明确 地 类 型 
转换 来 帮 它 : 


SELECT ~ CAST('20' AS int8) AS "negation"; 


negation 


(1 row) 


Example 10-4. 数组 包含 操作 符 类 型 分 析 
这 里 是 解决 一 个 操作 符 带 有 一 个 已 知 和 一 个 未 知 类 型 输入 的 例子 : 


SELECT array[1,2] <@ '{1,2,3}' as "is subset"; 


is subset 


PostgreSQL 操 作 符 表 有 几 条 记录 对 应 于 中 级 操作 符 &lt;@ ， 但 是 只 有 两 个 可 以 在 左 侧 接受 一 
个 整数 数组 的 操作 符 是 数组 包含 ( anyarray &lt;@ anyarray ) 和 范围 包含 ( anyelement 

&lt;@ anyrange ) 的 。 因为 没有 多 态 的 伪 类 型 (参阅 Section 8.19) 是 首选 的 ， 所 以 解析 器 不 能 
解决 这 个 基础 上 的 歧义 。 然而 ， 最 后 一 个 解析 规则 告诉 我 们 ， 假 设 未 知 类 型 的 文字 是 和 另外 
一 个 输入 相同 的 类 型 ， 也 就 是 ， 整 数 数组 。 现在 只 有 两 个 操作 符 中 的 一 个 可 以 匹配 ， 所 以 选 
择 数组 包含 。 (如 果 我 们 选择 了 范围 包含 ， 我 们 将 得 到 一 个 错误 ， 因 为 字符 串 没 有 正确 的 格 
式 成 为 范围 的 文字 。 ) 


10.3. RR 


下 面 讲解 的 过 程 解释 了 如 何在 一 次 函数 调用 中 确定 所 使 用 的 究竟 是 哪个 函数 。 
男 数 类 型 解析 


1， 从 系统 表 pg_proc 中 选择 要 考虑 的 范 数 。 如 果 使 用 了 一 个 不 带 模式 修饰 的 函数 名 字 ， 那 
么 认为 该 图 数 是 那些 在 当前 搜索 路 径 中 名 字 和 参数 个 数 都 匹配 的 画 数 (参阅 Section 
5.7.3)。 如 果 给 出 一 个 带 修饰 的 画 数 名 ， 那 么 只 考虑 指定 模式 中 的 琅 数 。 


ij， 如 果 搜 索 路 径 中 找到 了 多 个 相同 参数 类 型 的 函数 ， 那 么 只 考虑 最 早出 现在 路 径 中 的 
那 一 个 。 但 是 不 同 参 数 类 型 的 画 数 将 被 平等 看 待 ， 而 不 管 它们 在 路 径 中 的 位 置 如 
何 。 


iii， 如 果 使 用 一 个 vARIADIC 数组 参数 声明 一 个 函数 ， 并 且 调 用 时 不 使 用 关键 
字 vARIADIC ， 那么 该 图 被 认为 数组 参数 被 一 个 或 更 多 它 的 元 素 类 型 的 实体 代替 ， 并 
且 需 要 去 匹配 调用 。 经 过 这 样 的 扩展 ， 这 个 男 数 可 能 有 和 非 可 变 函 数 相同 的 有 效 参 
数 类 型 。 在 这 种 情况 下 ， 使 用 在 搜索 路 径 中 出 现 比 较 早 的 函数 ， 或 者 如 果 两 个 函数 
在 相同 的 模式 中 ， 那 么 首选 非 可 变 的 一 个 。 


ii 考虑 使 用 有 默认 参数 值 的 函数 来 匹配 任何 省 略 了 雾 或 者 多 个 默认 表 参 数位 置 的 调 
用 。 如 果 多 个 这 样 的 函数 匹配 一 个 调用 ， 那 么 使 用 最 早出 现在 搜索 路 径 中 的 那个 。 
如 果 在 非 默认 位 置 有 两 个 或 者 更 多 带 有 相同 模式 相同 参数 类 型 这 样 的 函数 〈 他 们 的 
默认 参数 设置 可 能 有 不 同 ) ， 系 统 将 不 能 确定 去 选择 哪个 ， 并 且 如 果 不 能 找到 更 好 
的 函数 匹配 调用 ， 那 么 将 会 产生 一 个 "ambiguous function call" 错 误 。 


2， 查 找 精确 接受 输入 参数 类 型 的 辑 数 。 如 果 找 到 一 个 (在 一 组 被 考虑 的 函数 中 ， 可 能 只 存在 
一 个 精确 匹配 的 )， 则 用 之 。 包 含 unknow 类 型 的 函数 调用 绝 不 会 在 此 义 找 到 匹配 。 


3， 如 果 没 有 找到 精确 的 匹配 ， 则 看 看 函数 调用 是 否 需要 一 个 特殊 的 类 型 转换 。 RNB 
用 只 有 一 个 参数 并 且 画 数 名 与 某 些 数 据 类 型 的 内 部 名 称 相同 ， 那 么 就 会 出 现 这 种 情况 。 
另外 ， 该 范 数 的 参数 必须 是 一 个 未 知 类 型 的 文本 ， 或 者 与 某 个 已 命名 数据 类 型 二 进 制 兼 
容 ， 或 者 是 一 个 可 以 通过 请 求 那 种 类 型 的 I/O 辑 数 转换 为 已 命名 数据 类 型 。 (也 就 是 ， 要 
么 可 以 转换 成 标准 字符 串 类 型 ， 要 么 可 以 从 标准 字符 串 类 型 转换 而 来 。) 如 果 符 合 这 些 
条 件 ， 那么 该 函数 调用 被 认为 是 一 种 cast 声明 。 [1] 


4. 寻找 最 优 匹配 。 


i， 抛 奔 那 些 输 入 类 型 不 匹配 并 且 也 不 能 隐 式 转换 成 匹配 的 候选 丁 数 。 unknown 文本 在 
这 种 情况 下 可 以 转换 成 任何 东西 。 如 果 只 剩 下 一 个 候选 项 ， 则 用 之 ， 否 则 继续 下 一 
步 。 


ii， 通 历 所 有 候选 画 数 ， 保 留 那些 输入 类 型 匹配 最 准确 的 。 此 时 ， 域 被 看 作 和 他 们 的 基 
本 类 型 相同 。 如 果 没 有 一 个 范 数 能 准确 匹配 ， 则 保留 所 有 候选 。 如 果 只 剩 下 一 个 候 
选项 ， 则 用 之 ， 否 则 继续 下 一 步 。 


ii， 表 万 所 有 候选 函数 ， 保 留 那些 需要 类 型 转换 时 接受 (属于 输入 数据 类 型 的 类 型 范 辆 的 ) 
首选 类 型 位 置 最 多 的 函数 。 如 果 没 有 接受 首选 类 型 的 画 数 ， 则 保留 所 有 候选 。 如 果 
只 剩 下 一 个 候选 项 ， 则 用 之 ， 否 则 继续 下 一 步 。 

iv. 如果 有 任何 输入 参数 是 unknown 类 型 ， 检 查 剩余 的 候选 画 数 对 应 参数 位 置 的 类 型 范 
E 在 每 一 个 能 够 接受 字符 串 类 型 范畴 的 位 置 使 用 string 类 型 (这 种 对 字符 串 的 偏 
爱 是 合适 的 ， 因为 unknown 文本 确实 像 字符 串 )。 另 外 ， 如 果 所 有 剩 下 的 候选 酚 数 
都 接受 相同 的 类 型 范畴 ， 则 选择 该 类 型 范畴 ， 否 则 抛 出 一 个 错误 (因为 在 没有 更 多 线 
索 的 条 件 下 无 法 作出 正确 的 选择 )。 现在 抛弃 不 接受 选 定 的 类 型 范畴 的 候选 男 数 ， 然 
后 ， 如 果 任 意 候 选 画 数 在 那个 范畴 接受 一 个 首选 类 型 ， 则 抛弃 那些 在 该 参数 位 置 接 
受 非 首选 类 型 的 候选 画 数 。 如 果 没 有 一 个 候选 符合 这 些 测试 则 保留 所 有 候选 。 如 果 
只 有 一 个 候选 画 数 符合 ， 则 使 用 它 ; 否则 ， 继 续 下 一 步 。 

v. 如 果 同 时 有 unknown 和 已 知 类 型 的 参数 ， 并 且 所 有 已 知 类 型 的 参数 有 相同 的 类 型 ， 
假设 unknown 参数 也 是 这 种 类 型 ， 检 查 哪个 候选 画 数 可 以 在 unknown 参数 位 置 接受 
这 种 类 型 。 如 果 正 好 一 个 候选 符合 ， 那 么 使 用 它 。 否 则 ， 产 生 一 个 错误 。 


请 注意 ，" 最 佳 匹 配 "规则 对 操作 符 和 对 函数 的 类 型 分 析 都 是 一 样 的 。 下 面 是 一 些 例子 。 
Example 10-5. 圆 整 男 数 参数 类 型 解析 


只 有 一 个 round WAA ADERE — DNE numeric, 第 二 个 是 integer )。 所 以 下 面 的 查询 
自动 把 第 一 个 类 型 为 integer 的 参数 转换 成 numeric 类 型 : 


SELECT round(4, 4); 


实际 上 它 被 分 析 器 转换 成 : 


SELECT round(CAST (4 AS numeric), 4); 


因为 带 小 数 点 的 数值 常量 初始 时 被 赋予 numeric 类 型 ， 因此 下 面 的 查询 将 不 需要 类 型 转换 ， 
并 且 可 能 会 略微 高 效 一 些 : 


SELECT round(4.0, 4); 


Example 10-6. 子 字 符 串 函数 类 型 解析 


有 好 几 个 substr RX, 其 中 一 个 接受 text 和 integer 类 型 。 如 果 用 一 个 未 声明 类 型 的 字符 
串 常量 调用 它 ， 系统 将 选择 接受 string 类 型 范畴 的 首选 类 型 (也 就 是 text KH) NeW 


SELECT substr('1234', 3); 


substr 


如 果 该 字符 串 声明 为 varchar 类 型 ， 就 像 从 表 中 取出 来 的 数据 一 样 ， 分 析 器 将 试 着 将 其 转换 
成 text 类 型 


SELECT substr(varchar '1234', 3); 


substr 


被 分 析 器 转换 后 实际 上 变 成 : 


SELECT substr(CAST (varchar '1234' AS text), 3); 


Note: 分 析 器 从 pg cast 表 中 了 解 到 text 和 varchar 是 二 进 制 兼 容 的 ， 意 思 是 说 一 个 
可 以 传递 给 接受 另 一 个 的 函数 而 不 需要 做 任何 物理 转换 。 因此 ， 在 这 种 情况 下 ， 实 际 上 
没有 做 任何 类 型 转换 。 


而 且 ， 如 果 以 integer 为 参数 调用 画 数 ， 分 析 器 将 试图 将 其 转换 成 text 类 型 : 


SELECT substr(1234, 3); 

ERROR: function substr(integer, integer) does not exist 

HINT: No function matches the given name and argument types. You might need 
to add explicit type casts. 


这 样 是 不 行 的 ， 因 为 integer 不 能 隐 式 的 转换 为 texto 需要 一 个 明确 的 转换 才 行 : 


SELECT substr(CAST (1234 AS text), 3); 


substr 


[1] R-P RRA AT LARRUA RAHA, ERA RI. 如 果 有 
DRRR, CHRRRAUCHHHAE RAN, amna TDR 参 
li] CREATE CAST 获 取 人 额外 的 说 明 。 


10.4. 值 存储 


要 插入 表 中 的 数值 也 根据 下 面 的 步骤 转换 成 目标 列 的 数据 类 型 。 
值 存储 数据 类 型 解析 
1， 查 找 与 目标 字段 准确 的 匹配 。 


2， 试 着 将 表达 式 直接 转换 成 目标 类 型 。 如 果 已 知 这 两 种 类 型 之 间 存 在 一 个 已 注册 的 转换 画 
数 ， 那么 直接 调用 该 转换 画 数 即 可 。 如 果 表 达 式 是 一 个 未 知 类 型 文本 ， 该 文本 字符 串 的 
内 容 将 交 给 目标 类 型 的 输入 转换 过 程 。 


3. 检查 一 下 看 看 目标 类 型 是 否 有 长 度 转换 。 长 度 转换 是 一 个 从 某 类 型 到 自身 的 转换 。 如 果 
在 pg_cast 表 里 面 找到 一 个 ， 那 么 在 存储 到 目标 字段 之 前 先 在 表达 式 上 应 用 。 这 样 的 转 
换 图 数 总 是 接受 一 个 额外 的 类 型 为 integer 的 参数 ， 它 接收 目标 字段 的 atttypmod 值 ( 实 
际 上 是 其 声明 长 度 ， atttypmod 的 解释 随 不 同 的 数据 类 型 而 不 同 )， 并 且 它 可 能 接受 一 
个 boolean 类 型 的 第 三 个 参数 ， 表示 转换 是 显 式 的 还 是 隐 式 的 。 转换 贺 数 负 责 施 加 那些 
长 度 相关 的 语义 ， 上 比如 长 度 检查 或 者 截断 。 


Example 10-7. character 存储 类 型 转换 


对 一 个 目标 列 定 义 为 character(20) 的 语句 ， 下 面 的 语句 显示 存储 值 的 长 度 正 确 : 


CREATE TABLE vv (v character(20)); 
INSERT INTO vv SELECT ‘abc' || 'def'; 
SELECT v, octet_length(v) FROM wv; 


V | octet_length 
pa Sepa ta ae, Ge E ar Pn I OE SES PPS oe eee geet cae ee 


abcdef | 20 
(1 row) 


这 里 真正 发 生 的 事情 是 两 个 unknown 文本 缺 省 解析 成 text , 这 样 就 允许 || 操作 符 解 析 

成 text 连接 。 然后 操作 符 的 text 结果 转换 成 bpchar ("空白 填充 的 字符 型 "， character 类 
型 内 部 名 称 ) 以 匹配 目标 字段 类 型 。 不 过 ， 从 text 到 bpchar 的 转换 是 二 进 制 兼 容 的 ， 这 样 的 
转换 是 隐 含 的 并 且 实 际 上 不 做 任何 范 数 调用 。 最 后 ， 在 系统 表 里 找 到 长 度 转 换 男 

数 bpchar(bpchar, integer, boolean) 并 且 应 用 于 该 操作 符 的 结果 和 存储 的 字段 长 。 这 个 类 型 
相关 的 函数 执行 所 需 的 长 度 检 查 和 额外 的 空白 填充 。 


10.5. UNION , CASE 和 相关 构造 


SQL unton 构造 必须 把 那些 可 能 不 太 相 似 的 类 型 匹配 起 来 成 为 一 个 结果 集 。 解析 算法 分 别 
应 用 于 联合 查询 的 每 个 输出 字段 。 INTERSECT 和 EXcEPT 构造 对 不 相同 的 类 型 使 用 和 

UNION 相同 的 算法 进行 解析 。 CASE ，ARRAY , VALUES , GREATEST ,和 Least 构造 也 使 用 同样 
的 算法 匹配 它 的 部 件 表达 式 并 且 选 择 一 个 结果 数据 类 型 。 


UNION , CASE 和 相关 构造 的 类 型 解析 


1. 如 果 所 有 输入 都 是 相同 的 类 型 ， 并 且 不 是 unknown 类 型 ， 那 么 解析 成 这 种 类 型 。 否则 ， 
用 它们 潜在 的 基本 类 型 替换 列表 中 的 域 类 型 。 


2. 如果 所 有 输入 都 是 unknown 类 型 则 解析 成 text 类 型 (字符 串 类 型 范畴 的 首选 类 型 )。 否 


则 ， 忽 略 unknown 输入 。 
3. 如果 非 unknown 输入 不 属于 同一 个 类 型 范畴 ， 失 败 。 
4. 如 果 有 ， 则 选取 第 一 个 属于 该 范畴 中 首选 类 型 的 非 unknown 输入 类 型 。 


5. 否则， 选择 最 后 一 个 允许 所 有 前 面 的 非 unknown 输 入 隐 式 转换 为 它 的 非 unknown 输 入 类 
型 。 (总 是 有 这 人 么 一 种 类 型 ， 因 为 至 少 列表 上 的 第 一 种 类 型 必须 适合 这 种 情况 。 ) 


6. 把 所 有 输入 转换 为 所 选 的 类 型 。 如 果 从 给 定 的 输入 到 所 选 的 类 型 没有 一 个 转换 则 失败 。 
下 面 是 一 些 例 子 。 
Example 10-8. Union 中 的 待定 类 型 解析 

SELECT text 'a' AS "text" UNION SELECT 'b'; 


(2 rows) 


xx, unknown 类 型 文本 'b' 将 被 解析 成 text 类 型 。 
Example 10-9. 简单 Union 中 的 类 型 解析 


SELECT 1.2 AS "numeric" UNION SELECT 1; 


numeric 


ale 
(2 rows) 


MA 1.2 的 类 型 为 numeric, MH integer 类 型 的 1 可 以 隐 仿 地 转换 为 numeric ， 因 此 使 
用 这 个 类 型 。 


Example 10-10. 转 置 Union 中 的 类 型 解析 
SELECT 1 AS "real" UNION SELECT CAST('2.2' AS REAL); 


(2 rows) 


这 里 ， 因 为 类 型 real 不 能 被 隐 含 转换 成 integer ， 但 是 integer 可 以 隐 含 转换 成 real ， 那 
么 联合 的 结果 类 型 将 是 real o 
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ee 索引 可 以 今 数据 库 服务 器 以 比 没有 索引 快 得 多 的 速度 查 
找 和 检索 特定 的 行 。 不 过 索引 也 在 总 体 上 增加 了 数据 库 系统 的 负荷 ， 因 此 我 们 应 该 恰当 地 使 
用 它们 。 


11.1. 介绍 


假设 有 像 下 面 这 样 一 个 表 : 


CREATE TABLE testi ( 
id integer, 
content varchar 


Ni 


发 出 大 量 下 面 这 样 的 语句 进行 查询 : 


SELECT content FROM testi WHERE id = _constant_; 


通常 ， 数 据 库 系 统 不 得 不 一 行 一 行 地 扫描 整个 test1 表 以 寻找 所 有 匹配 的 记录 。 如 果 

在 testı 里 面 有 许多 行 ， 但 是 只 返回 少数 几 行 (可 能 是 雳 行 或 一 行 )， 那 么 上 面 这 个 方法 可 就 
RAAT. 如 果 我 们 让 数据 库 系 统 在 id 列 上 维护 一 个 索引 用 于 定位 匹配 的 行 。 这 样 ， 数 据 
库 系统 只 需要 在 搜索 树 中 走 少数 的 几 层 就 可 以 找到 匹配 行 。 


在 大 多 数 非 小 说 的 书籍 里 面 都 使 用 了 类 似 这 样 的 方法 : 在 书 的 背后 收集 着 读者 会 经 常 查找 的 
术语 和 概念 的 索引 ， 并 按照 字母 顺序 排列 。 有 兴趣 的 读者 可 以 快速 地 扫描 该 索引 并 且 切 换 到 
合适 的 页 ， 因此 不 用 阅读 整 本 书 就 能 查找 到 感 兴趣 的 位 置 。 作 者 的 任务 之 一 就 是 预计 哪些 项 
读者 最 需要 查找 的 东西 ， 与 之 类 似 ， 预 计 哪些 索引 可 以 带 来 便利 也 是 数据 库 程 序 员 的 任 


o 


Se fl O 


下 面 的 命令 可 以 用 于 在 id 列 上 创建 前 面 讨论 过 的 索引 : 


CREATE INDEX test1 id_ index ON testi (id); 


索引 名 字 test1_id_index 可 以 自由 选择 ， 但 是 应 该 选 那些 稍 后 可 以 让 你 回忆 起 索引 含义 的 名 
字 。 


要 删除 一 个 索引 ， 使 用 prop INDEX 命令 。 你 可 以 在 任何 时 候 向 表 里 增 加 索引 或 者 从 表 中 删除 
索引 。 


一 旦 你 创建 了 索引 ， 那 么 就 不 需要 更 多 干涉 了 : 当 表 有 修改 时 系统 会 更 新 索引 ， 并 且 当 系统 
认为 用 索引 比 顺 序 的 表 扫 描 快 的 时 候 它 就 会 使 用 素 引 。 不 过 你 可 能 必须 经 常 性 地 运 

{T ANALYZE 命令 以 更 新 统计 信息 ， 好 让 查询 规划 器 能 够 做 出 训练 有 素 的 判断 。 参 见 Chapter 

14 获取 关于 如 何 获知 是 否 使 用 了 索引 的 信息 ， 以 及 在 什么 时 候 、 什 么 原因 下 规划 器 会 决定 不 
使 用 索引 。 


索引 对 带 搜索 条 件 的 uppATE 和 DELETE 命 倒 也 有 好 处 。 索引 更 可 以 用 于 表 连 接 查 询 。 因 此 ， 
如 果 你 定义 了 索引 的 列 是 连接 条 件 的 一 部 分 ， 那么 它 也 可 以 显著 提高 连接 的 查询 速度 。 


在 一 个 巨大 的 表 上 创建 索引 可 能 会 消耗 大 量 的 时 间 。 缺 省 时 ，PostgreSQL 人 允许 在 创建 索引 的 
同时 读 取 表 ( sELECT 语句 )， 但 是 罕 入 表 ( INSERT, UPDATE , DELETE ) 的 动作 将 被 阻塞 到 索引 创 
建 完毕 。 在 生产 环境 下 这 种 阻塞 通常 是 不 可 接受 的 ， 因 此 也 人 允许 在 创建 索引 的 同时 写 入 表 ， 
但 是 有 一 些 和 警告 需要 注意 ， 更 多 信息 参见 并 发 建立 索引 。 


S A m 
创建 索引 之 后 ， 它 必须 和 表 保 持 同步 。 这 些 操作 增加 了 数据 操作 的 负荷 。 因此 我 们 应 该 把 那 
些 非 关 键 或 者 根本 用 不 上 的 索引 删除 掉 。 


11.2. 索引 类 型 


PostgreSQL 提 供 了 好 几 种 索引 类 型 : B-tree, Hash, GiST, SP-GiST 和 GIN 。 每 种 索引 类 型 都 
比较 适合 某 些 特定 的 查询 类 型 ， 因 为 它们 用 了 不 同 的 算法 。 缺 省 时 ， CREATE INDEX 命令 将 创 
建 B-tree 索引 ， 它 适合 大 多 数 情况 。 


B-tree 适合 处 理 那 些 能 够 按 顺序 存储 的 数据 之 上 的 等 于 和 范围 查询 。 特别 是 在 一 个 建立 了 索 
引 的 字段 涉及 到 使 用 


&gt; 


操作 符 之 一 进行 比较 的 时 候 ，PostgreSQL 的 查询 规划 器 都 会 考虑 使 用 B-tree R5 SMF 
这 些 操作 符 组 合 的 构造 ， 比如 Between 和 IN ， 也 可 以 用 搜索 B-tree 索引 实现 。 同样 ， 索 引 
列 中 的 rs NULL 或 Is not NULL 条 件 可 以 和 B-tree 素 引 一 起 使 用 。 


仅 当 模式 是 一 个 常量 ， 并 且 锚 定 在 字符 串 开 头 的 时 候 ， 优化 器 才 会 把 B-tree 索引 用 于 模式 匹 
配 操作 符 Like 和 ~ ， 比 如 : col LIKE 'foo%' 或 col ~ '^foo' ， 但 是 col LIKE '%bar' 就 
不 行 。 同 时 ， 如 果 你 的 数据 库 未 使 用 C 区 域 设置 ， 那么 你 需要 用 一 个 特殊 的 操作 符 类 创建 索 
引 来 支持 模式 匹配 查询 上 的 索引 。 参阅 Section 11.9。 还 有 可 能 将 B-tree 索引 用 于 ILIKE 

和 -* ， 但 是 仅 当 模式 以 非 字 母 字符 (不 受 大 小 写 影 响 的 字符 ) 开 头 才 可 以 。 


B-tree 索 引 也 可 以 用 来 按照 排序 顺序 检索 数据 。 这 并 不 总 是 比 一 个 简单 的 扫描 和 排序 快 ， 但 
通常 是 有 帮助 的 。 


Hash 索引 只 能 义理 简单 的 等 于 比较 。 当 一 个 索引 了 的 列 涉 及 到 使 用 = 操作 符 进 行 比 较 的 时 
候 ， 查 询 规划 器 会 考虑 使 用 Hash 索引 。 下 面 的 命令 用 于 创建 Hash 索引 : 


CREATE INDEX _name_ ON _table_ USING hash (_column_); 





Caution 


Hash 索引 操作 目前 没有 记录 WAL 日 志 ， 因 此 如 果 数 据 库 崩 溃 有 未 写 入 的 改变 ， 我 们 可 
能 需要 用 REINDEX 重建 Hash 索引 。 另外 ， 对 hash 索 引 的 改变 在 初始 的 基础 各 份 后 不 是 
基于 流 复 制 或 者 基于 文件 复制 的 ， 所 以 对 于 随后 使 用 它们 的 查询 会 给 出 错误 的 回复 。 
为 这 些 原因 ， 我 们 并 不 鼓励 使 用 Hash 索引 。 


GIST 索引 不 是 单独 一 种 索引 类 型 ， 而 是 一 种 架构 ， 可 以 在 这 种 架构 上 实现 很 多 不 同 的 索引 策 
略 。 因此 ， 可 以 使 用 GIST 索引 的 特定 操作 符 类 型 高 度 依赖 于 索引 策略 (操作 符 类 )。 作为 示 
例 ，PostgreSQL 的 标准 发 布 中 包含 用 于 二 维 几 何 数 据 类 型 的 GiST 操作 符 类 ， 它 支持 


| @lt;alt; || &&lt; || sagt; || agt;agt; || alt;alt;a#124; || ealt;a#124; | | 


&#124;aagt; || a@#124;agt;agt; || @agt; || &ıt;@ || -= || sa | 


操作 符 的 索引 查询 。 这 些 操作 符 的 含义 参见 Section 9.11。 许多 其 它 GIST 操作 符 类 可 用 
于 contrib 中 ， 或 者 是 单独 的 项 目 ， 更 多 信息 参见 Chapter 55。 


GiST 索 引 也 可 最 优化 "nearest-neighbor" 检 索 ， 例 如 


SELECT * FROM places ORDER BY location <-> point '(101,456)' LIMIT 10; 


找 出 距离 给 出 目标 点 最 近 的 十 个 地 点 。 能 这 样 做 也 是 依赖 于 使 用 特定 的 操作 符 类 。 


SP-GiST 索 引 类 似 于 GiST 索 引 ， 提 供 一 个 支持 不 同类 型 检索 的 架构 。 SP-GiST 人 允许 广泛 不 同 
的 非 平衡 基于 磁盘 的 数据 结构 的 实施 ， 例 如 四 叉 树 ，Kk-d 树 和 根 树 (尝试 )。 作为 示例 ， 
PostgreSQL 的 标准 发 布 中 包含 用 于 二 维 点 的 SP-GiST 操 作 符 类 ， 它 支 持 


| @lt;alt; || a@gt;agt; || -= || &ıt;@ || &lt;^ |] &gt;^ | 
操作 符 的 索引 查询 。 (这 些 操作 符 的 含义 参见 Section 9.11。) 更 多 信息 参见 Chapter 56, 


GIN 索引 是 反 转 索引 ， 它 可 以 处 理 包 含 多 个 键 的 值 (比如 数组 )。 与 GiST 和 SP-GiST 类 似 ， 
GIN 支持 用 户 定 义 的 索引 策略 ， 可 以 使 用 GIN 索引 的 特定 操作 符 类 型 根据 索引 策略 的 不 同 而 
不 同 。 作为 示例 ，PostgreSQL 的 标准 发 布 中 包含 用 于 一 维 数组 的 GIN 操作 符 类 ， 它 支持 


| ait;@ || @agt; || = || & | 


操作 符 的 索引 查询 。 这 些 操作 符 的 含义 参见 Section 9.18. 许多 其 它 GIN 操作 符 类 可 用 
于 contrib 集合 或 作为 单独 的 项 目 。 更 多 信息 参见 Chapter 57。 


11.3. 多 字段 索引 


一 个 索引 可 以 定义 在 表 中 多 个 字段 上 。 比 如 下 面 这 样 的 表 ( 把 /dev 目录 保存 在 一 个 数据 库 
里 ) : 


CREATE TABLE test2 ( 
major int, 

minor int, 

name varchar 


) 


并 且 你 经 常 发 出 下 面 这 样 的 查询 : 


SELECT name FROM test2 WHERE major = _constant_ AND minor = _constant_; 


那么 在 字段 major 和 minor 上 联合 定义 一 个 索引 是 比较 合适 的 做 法 ， 也 就 是 : 


CREATE INDEX test2_mm_idx ON test2 (major, minor); 


目前 ， 只 有 B-tree , GiST# GIN 支持 多 字段 索引 。 缺 省 最 多 可 以 声明 32 个 字段 (这 个 限制 可 
以 在 编译 PostgreSQL 时 改变 ， 见 pg_config_manual.h 文件 )。 


一 个 多 字段 的 B-tree 索引 可 以 用 在 包含 索引 字段 子 集 的 查询 条 件 里 ， 不 过 ， 如 果 在 前 导 字 段 
(最 左边 ) 上 有 约束 条 件 ， 那 么 效率 最 高 。 准 确 的 规则 是 前 导 字 段 上 的 等 于 约束 ， 加 上 第 一 个 

没有 等 于 约束 的 非 等 于 约束 字段 ， 将 用 于 限制 所 扫描 的 索引 范围 。 将 检查 这 两 个 字段 右边 字 
段 上 的 索引 以 减少 对 表 的 访问 ， 但 是 并 不 减少 需要 打 描 的 索引 。 上 比如 ， 假如 我 们 有 一 个 

在 (a, b, c) 上 的 索引 ， 查 询 条 件 是 WHERE a = 5 AND b &gt;= 42 AND c &lt; 77, 那么 索引 

就 需要 先 打 描 所 有 a = 5 且 b = 42， 直 到 所 有 a =5 的 记录 打 描 完 华 。 那 些 c_ >= 770R 

引 条 目 将 被 忽略 ， 但 是 他 们 仍然 会 被 扫描 。 这 个 索引 原则 上 仍然 会 被 用 于 那些 在 b 和 / 

或 < 上 有 约束 ， 但 是 在 a 上 没有 约束 的 查询 ， 但 是 就 必须 扫描 整个 素 引 了 。 因 此 ， 在 大 多 

数 这 种 情况 下 ， 优化 器 会 选择 顺序 打 描 表 ， 而 不 使 用 索引 。 


一 个 多 字段 的 GIST 索引 可 以 用 于 那些 查询 条 件 包 含 索 引 字段 子 集 的 查询 中 。 附加 字段 上 的 
条 件 会 限制 素 引 返回 的 条 目 ， 但 是 第 一 个 字段 上 的 条 件 是 决定 需要 扫描 多 少 索 引 内 容 的 最 重 
要 的 字段 。 如 果 在 第 一 个 字段 上 只 有 很 少 的 一 些 唯一 的 数值 ， 那 么 GiST 就 相对 来 说 不 那么 
高 效 了 ， 即使 在 附加 字段 上 有 许多 独立 的 数值 也 如 此 。 


一 个 多 字段 的 GIN 索引 可 以 用 于 那些 查询 条 件 包含 索引 字段 子 集 的 查询 中 。 不 像 B-tree 或 
GiST， 除 了 查询 条 件 使 用 的 索引 字段 外 ， 索 引 的 搜索 效率 是 相同 的 。 

当然 ， 每 个 字段 都 必须 和 适合 该 索引 类 型 的 操作 符 一 起 使 用 ; 包含 其 它 操作 符 的 子 句 将 不 会 
被 考虑 。 


使 用 多 字段 索引 应 该 着 愤 。 在 大 多 数 情 况 下 ， 在 单字 段 上 的 索引 就 足够 了 ， 并 且 还 节约 时 间 
和 空间 。 除非 表 的 使 用 模式 非常 固定 ， 否 则 超过 三 个 字段 的 索引 几乎 没什么 用 处 。 又 见 
Section 11.5 获 取 有 关 不 同 索 引 设 置 的 优 缺 点 的 讨论 。 


11.4. 索引 和 ORDER BY 


除了 只 是 返回 查询 到 的 行 ， 索 引 可 以 以 一 个 特定 的 顺序 传送 它们 。 这 样 就 允许 查询 
BY oRDER BY 说 明 可 以 不 用 一 个 单独 的 排序 步 又。 当前 PostgreSQL 支 持 的 索引 类 型 ， 只 有 B- 
tree 可 以 产生 排序 的 输出 一 其 他 的 索引 类 型 返回 的 行 是 非 指 定 的 、 依 赖 于 实现 的 顺序 。 


规划 器 将 考虑 满足 oRDER BY 声明 ， 通 过 扫描 匹配 声明 的 可 用 的 索引 ， 或 者 通过 扫描 物理 顺序 
的 表 和 做 一 个 明确 的 排序 。 对 于 一 个 需要 扫描 表 的 一 大 部 分 的 查询 ， 明确 的 排序 可 能 要 比 使 
用 索引 快 的 多 ， 因 为 它 使 用 顺序 存 取 模 式 所 以 需要 较 少 的 磁盘 MO。 当 只 需要 获取 几 行 时 ， 索 
引 是 更 有 效 的 。 一 个 重要 的 特殊 情况 是 oRDER BY 和 Limit _n_ 一 起 使 用 :一 个 明确 的 排序 将 
处 理 所 有 的 数据 以 识别 前 n 行 ， 但 是 如 果 有 一 个 索引 匹配 oRDER BY ， 那 么 前 n 行 可 以 
直接 找 出 ， 而 不 用 扫描 剩 下 的 部 分 。 


默认 的 ，B-tree 索 引 以 递增 、 空 值 最 后 的 顺序 存储 记录 。 这 意味 着 在 字段 x 上 向 前 扫描 索引 
产生 的 输出 满足 ORDER BY x (或 者 ORDER BY x ASC NULLS LAST) 。 索引 打 描 也 可 以 向 后 打 
描 ， 产 生 的 输出 满足 ORDER BY x DESC (或 者 ORDER BY x DESC NULLS FIRST , 


A NULLS FIRST 默认 是 ORDER BY DESC ) o 


创建 索引 时 ， 可 以 通过 包含 选项 asc , DESC, NULLS FIRST , 和 /或 NULLS Last 调整 B-tree 索 
引 的 顺序 ; 例如 : 


CREATE INDEX test2_info_nulls_low ON test2 (info NULLS FIRST); 
CREATE INDEX test3_desc_index ON test3 (id DESC NULLS LAST); 


以 递增 顺序 、 空 值 在 前 的 顺序 存储 的 索引 可 以 满足 ORDER BY x ASC NULLS FIRST 或 
ORDER BY x DESC NULLS LAST ， 取 决 于 扫描 的 方向 。 


你 可 能 想 知道 为 什么 麻烦 的 提供 所 有 的 四 个 选项 ， 当 向 后 扫描 时 两 个 选项 可 以 包含 ORDER BY 
的 所 有 变 体 。 在 单字 段 素 引 中 ， 这 些 选项 确实 了 见 余 ， 但 是 在 多 字段 素 引 中 ， 它 们 就 是 有 用 的 
了 。 考虑 一 个 在 (x, y) 上 的 两 字段 索引 : 当 我 们 向 前 扫描 时 ， 可 以 满足 ORDER BY x, y, 或 
者 当 我 们 向 后 扫描 时 ， 可 以 满足 ORDER BY x DESC, y DESC 。 但 是 可 能 应 用 经 常 的 需要 使 用 
ORDER BY x ASC, y DESC 。 在 普通 的 索引 上 无 法 得 到 这 种 顺序 ， 但 是 如 果 索 引 定 义 为 

(x ASC, y DESC) 或 (x DESC, y ASC) 就 是 可 能 的 了 。 


明显 的 ， 没 有 默认 排序 顺序 的 索引 是 比较 专业 的 特征 ， 但 是 有 时 它们 对 特定 的 查询 可 以 产生 
极 大 的 加 速 。 是 否 值 得 维持 这 样 的 索引 取决 于 你 使 用 需要 特殊 排序 顺序 的 查询 的 频率 。 


11.5. 组 合 多 个 索引 


一 个 单独 的 索引 打 描 只 能 用 于 这 样 的 条 件 子 句 : 使 用 被 索引 字段 和 索引 操作 符 类 中 操作 符 ， 
并 这 些 条 件 以 ann 连接 。 假 设 在 (a, b) 上 有 一 个 索引 ， 那么 类 似 WHERE a = 5 AND b = 6 的 
条 件 可 以 使 用 索引 ， 但 是 像 wHERE a = 5 oR b = 6 的 条 件 就 不 能 直接 使 用 索引 。 


幸运 的 ，PostgreSQL 能 够 组 合 多 个 索引 (包括 同一 索引 的 多 次 使 用 ) 来 处 理 单 个 素 引 扫描 不 能 
实现 的 情况 。 系 统 可 以 在 多 个 索引 扫描 之 间 组 成 AND 和 oR 和 条件。 比如， 一 个 类 

{tk WHERE x = 42 OR x = 47 OR x = 53 OR x = 99 这 样 的 查询 可 以 分 解 成 四 个 在 x 上 的 独立 扫 
描 ， 每 个 扫描 使 用 一 个 条 件 ， 最 后 将 这 些 扫描 的 结果 OR 在 一 起 ， 生 成 最 终结 果 。 另外 一 个 
例子 是 ， 如 果 我 们 在 x My 上 有 独立 的 索引 ， 一 个 类 似 WHERE x = 5 AND y = 6 这 样 的 查询 
可 以 分 解 为 几 个 使 用 独立 索引 的 子 句 ， 然 后 把 这 几 个 结果 AND 在 一 起 ， 生 成 最 终结 果 。 


为 了 组 合 多 个 索引 ， 系 统 扫 描 每 个 需要 的 索引 ， 然 后 在 内 存 里 组 织 一 个 位 图 ， 它 给 出 索引 打 
描 报 告 中 符合 索引 条 件 的 表 数 据 行 位 置 。 然 后 ， 根 据 查询 的 需要 ， 把 这 个 位 图 使 用 AND 和 
OR 合并 在 一 起 。 最 后 ， 访 问 实际 的 表 检 索 并 返回 数据 行 。 表 的 数据 行 是 按照 物理 顺序 进行 
访问 的 ， 因 为 那 就 是 位 图 的 布局 ; 这 就 意味 着 任何 原来 的 索引 排序 都 将 消失 ， 而 如 果 查 询 有 
一 个 oRDER BY 子 句 ， 那么 还 会 有 一 个 额外 的 排序 步骤 。 因 为 这 个 原因 ， 以 及 每 个 额外 的 索引 
扫描 都 增加 了 额外 的 时 间 ， 规划 器 有 时 候 会 选择 使 用 简单 的 索引 扫描 ， 即 使 有 多 个 索引 可 用 
也 如 此 。 


在 大 多 数 最 简单 的 应 用 里 ， 可 能 有 多 种 索引 组 合 都 是 有 用 的 ， 数 据 库 开 发 人 员 必 须 在 使 用 哪 
个 索引 之 间作 出 平衡 。 有 时 候 多 字段 素 引 是 最 好 的 ， 有 时 候 创 建 一 个 独立 索引 并 依靠 索引 组 
合 是 最 好 的 。 上 比如 ， 假如 你 的 查询 有 时 候 只 涉及 字段 x ， 有 时 候 只 涉及 字段 y ， 有 时 候 两 
个 字段 都 涉及 ， 那么 你 可 能 会 选择 在 x 和 y 上 创建 两 个 独立 的 素 引 ， 然后 依靠 素 引 组 合 来 
处 理 同时 使 用 两 个 字段 的 查询 。 你 也 可 以 在 (x, y) 上 创建 一 个 多 字段 索引 ， 它 在 同时 使 用 两 
个 字段 的 查询 通常 比 素 引 组合 更 高 效 ， 但 是 ， 正 如 我 们 在 Section 11.3 里 面 讨 论 的 ， 它 对 那些 
只 包含 y 的 查询 几乎 没有 用 ， 因 此 它 不 能 是 唯一 一 个 索引 。 一 个 多 字段 索引 和 y 上 的 独立 
索引 可 能 会 更 好 。 因 为 对 那些 只 涉及 x 的 查询 ， 可 以 使 用 多 字段 素 引 ， 但 是 它 会 更 大 ， 因 此 
EHRE x 上 的 索引 更 慢 。 最 后 一 个 选择 是 创建 三 个 索引 ， 但 是 这 种 方法 只 有 在 表 的 更 新 远 
比 查询 少 得 多 ， 并 且 所 有 三 种 查询 都 很 普通 的 情况 下 示 是 合理 的 。 如 果 其 中 一 种 查询 比 其 它 
的 少 很 多 ， 那 么 你 可 能 更 愿意 仅仅 创建 两 种 匹配 更 常见 查询 的 索引 。 


11.6. 唯一 索引 


索引 还 可 以 用 于 强迫 字段 数值 的 唯一 性 ， 或 者 是 多 个 字段 组 合 值 的 唯一 性 。 


CREATE UNIQUE INDEX _name_ ON _table_ (_column_ [, ...]); 





目前 ， 只 有 B-tree 索引 可 以 声明 为 唯一 。 


如 果 索 引 声明 为 唯一 的 ， 那 么 就 不 允许 出 现 多 个 索引 值 相同 的 行 。NULL 值 被 认为 互 不 相等 。 
一 个 多 字段 唯一 索引 只 在 多 行 数据 里 所 有 被 索引 字段 都 相同 时 才 拒 绝 。 


如 果 一 个 表 声 明了 唯一 约束 或 者 主键 ， 那 么 PostgreSQL 自动 在 组 成 主键 或 唯一 约束 的 字段 上 
创建 唯一 索引 (可 能 是 多 字段 索引)， 以 强迫 这 些 约 束 。 
Note: 给 表 增 加 唯一 约束 比较 好 的 办 法 是 ALTER TABLE ... ADD CONSTRAINT 。 用 索引 强制 
唯一 约束 应 该 认为 是 一 个 实现 细节 ， 而 不 应 该 直接 访问 。 不 过 ， 我 们 应 该 知道 没有 必要 
在 唯一 字段 上 建立 索引， 那样 做 只 会 重复 建立 自动 创建 的 索引 。 




















11.7. 表达 式 上 的 索引 

来 引 并 非 一 定 要 是 一 个 底层 表 的 字段 ， 还 可 以 是 一 个 函数 或 者 从 一 个 或 多 个 字段 计算 出 来 的 
标量 表达 式 。 这 个 特性 对 于 快速 访问 那些 基于 计算 结果 的 表 非 常 有 用 。 

比如 ， 做 大 小 写 无 关上 比较 的 常用 方法 是 使 用 lower WR: 


SELECT * FROM test1 WHERE lower(coli) = 'value'; 


如 果 我 们 在 lower(col1) AAA REE RS 


CREATE INDEX test1_ Jower_col1_ idx ON testi (lower(col1)); 


那么 上 述 查 询 就 可 以 使 用 该 索引 。 如 果 我 们 把 这 个 索引 声明 为 untque, 那么 它 会 禁止 创建 那 
种 cola 数值 只 是 大 小 写 有 别 或 完全 相同 的 数据 行 。 因此 ， 在 表达 式 上 的 索引 可 以 用 于 强制 那 
些 无 法 定义 为 简单 唯一 约束 的 约束 。 


另外 一 个 例子 是 ， 如 果 我 们 经 常 使 用 下 面 这 样 的 查询 : 


SELECT * FROM people WHERE (first_name || ' ' || last_name) = 'John Smith'; 


那么 我 们 就 值得 创建 下 面 这 样 的 索引 : 


CREATE INDEX people_names ON people ((first_name || ' ' || last_name)); 


CREATE INDEX 命 合 的 语法 通常 要 求 在 素 引 表达 式 周 围 书写 圆 括 弧 ， 就 像 我 们 在 第 二 个 例子 里 
显示 的 那样 。 如 果 表 达 式 只 是 一 个 函数 调用 ， 那么 可 以 省 略 ， 就 像 我 们 在 第 一 个 例子 里 显示 
的 那样 。 


从 维护 角度 来 看 ， 索 引 表达 式 相 对 费劲 一 些 ， 因 为 在 插入 数据 行 或 者 更 新 数据 行 的 时 候 ， 都 
必须 为 每 一 行 计算 生成 的 表达 式 。 不 过 ， 索 引 表 达 式 不 是 在 索引 查找 的 时 候 进 行 计算 的 ， 因 
为 它们 已 经 存储 在 索引 里 了 。 在 上 面 的 两 个 例子 里 ， 系 统 都 把 查询 看 做 只 是 
WHERE indexedcolumn = 'constant' , 所 以 搜索 的 速度 等 效 于 任何 其 它 简 单 的 索引 查询 。 
此 ， 表 达 式 上 的 索引 在 检索 速度 比 插入 和 更 新 速度 更 重要 的 场合 下 是 有 用 的 。 


11.8. 部 分 索引 


部 分 索引 是 建立 在 一 个 表 的 子 集 上 的 索引 ; 该 子 集 是 由 一 个 条 件 表 达 式 定义 的 (叫做 部 分 索引 
的 谓词 )。 该 索引 只 包含 表 中 那些 满足 这 个 谓词 的 行 。 部 分 素 引 是 一 个 特殊 的 特性 ， 但 是 在 某 
些 场合 很 有 用 。 


部 分 素 引 的 主要 动机 是 为 了 避免 对 普通 数值 (大 量 重复 的 数值 ) 建 立 素 引 。 因为 在 普通 数值 上 
的 查询 就 算 使 用 索引 也 没什么 好 处， 那么 还 不 如 从 索引 中 剔除 这 些 大 量 重复 的 行 。 这 样 可 以 
减 小 索引 尺寸 ， 提 高 那些 真正 使 用 索引 的 查询 的 速度 。 同 时 它 也 能 提高 更 新 操作 的 速度 ， 
为 不 是 所 有 情况 都 需要 更 新 索引 。Example 11-1 显示 了 一 个 潜在 的 这 方面 应 用 的 例子 。 


Example 11-1. 设置 一 个 部 分 素 引 以 排除 普通 数值 


假设 你 在 数据 库 中 存储 web 服务 器 的 访问 日 志 。 大 多 数 访问 是 从 你 的 组 织 内 部 的 IP 地 址 范围 
发 起 的 ， 但 也 有 一 小 部 分 来 自 其它 地 方 (比如 那些 通过 拨号 进行 连接 的 屋 员 )。 如 果 你 主要 搜 
索 来 自 外 部 访问 的 IP ， 那么 你 就 不 需要 对 组 织 子 网 的 IP 范围 进行 索引 。 


假设 表 像 下 面 这 样 : 


CREATE TABLE access_log ( 
url varchar, 
client_ip inet, 


要 创建 符合 例子 的 索引 ， 使 用 像 下 面 这 样 的 命 合 : 


CREATE INDEX access_log_client_ip_ix ON access_log (client_ip) 
WHERE NOT (client_ip > inet '192.168.100.0' AND 
client_ip < inet '192.168.100.255'); 





一 个 可 以 使 用 这 个 索引 的 典型 的 查询 像 这 样 : 


SELECT * 
FROM access_log 
WHERE url = '/index.html' AND client_ip = inet '212.78.10.32'; 


一 个 不 能 使 用 这 个 索引 的 查询 是 : 


SELECT * 
FROM access_log 
WHERE client_ip = inet '192.168.100.23'; 


我 们 通过 观察 可 以 看 出 ， 这 种 类 型 的 部 分 索引 要 求 普通 数值 是 可 以 预计 的 。 PLR 
引 最 好 用 于 没有 改变 的 数据 分 布 。 索 引 可 以 不 定期 的 重建 来 适应 新 数据 的 分 布 ， 但 是 这 增加 
TEFIE, 


另外 一 个 用 途 在 Example 11-2 里 显示 ， 它 把 不 感 兴趣 的 数值 排除 在 索引 之 外 。 这 个 结果 有 和 与 
上 面 列 出 的 同样 的 优点 ， 但 是 它 完全 拒绝 了 通过 索引 访问 "不 感 兴趣 "的 数值 ， 即使 索引 扫描 
可 能 对 那些 数据 也 有 利 。 显 然 ， 为 这 种 情况 设置 部 分 素 引 需要 非常 仔细 并 且 需 要 大 量 试验 。 


Example 11-2. 设置 一 个 部 分 素 引 以 排除 不 感 兴 趣 的 数值 


如 果 你 有 一 个 表 ， 包 含 已 付款 和 未 付款 的 定单 ， 而 未 付款 的 定单 只 占 总 表 的 一 小 部 分 并 且 是 
经 常 使 用 的 部 分 ， 那么 你 可 以 通过 只 在 未 付款 定单 上 创建 一 个 索引 来 改善 性 能 。 创 建 素 引 的 
命令 看 起 来 会 像 这 样 : 


CREATE INDEX orders_unbilled_index ON orders (order_nr) 
WHERE billed is not true; 


可 能 用 到 这 个 索引 的 查询 看 起 来 像 : 


SELECT * FROM orders WHERE billed is not true AND order_nr < 10000; 


不 过 ， 该 索引 也 可 以 用 于 那些 完全 不 涉及 order_nr 查询 ， 比 如 : 


SELECT * FROM orders WHERE billed is not true AND amount > 5000.00; 


这 个 查询 不 像 在 amut 字段 上 的 部 分 素 引 那么 有 效 ， 因为 系统 必须 扫描 整个 素 引 。 但 是 ， 如 
果 未 付款 的 定单 相对 较 少 ， 那么 用 这 个 部 分 素 引 找 出 未 付款 的 定单 将 会 更 快 些 。 


请 注意 下 面 这 个 查询 无 法 使 用 这 个 索引 : 


SELECT * FROM orders WHERE order_nr = 3501; 


定单 3501 可 能 是 已 付款 也 可 能 是 未 付款 。 


Example 11-2 还 说 明了 建 了 索引 的 字段 和 谓词 中 的 字段 不 必 相 配 。 PostgreSQL 支 持 带 任意 谓 
词 的 部 分 素 引 ， 只 要 只 涉及 被 索引 表 的 字段 就 行 。 不 过 ， 我 们 要 记 住 的 是 谓词 必须 和 那些 希 
望 从 该 索引 中 获 益 的 查询 条 件 相 匹配 。 准 确 说 ， 只 有 在 系统 能 够 识别 出 该 查询 的 were 条 件 
在 数学 上 范 酒 了 该 索引 的 谓词 时 ， 这 个 部 分 素 引 才能 用 于 该 查询 。 PostgreSQL 还 没有 智能 

到 可 以 完全 识别 那些 形式 不 同 但 数学 上 相等 的 谓词 。 做 到 这 样 不 仅 非 常 困难 ， 而 且 在 实际 使 
用 中 也 可 能 非常 慢 。 系 统 可 以 识别 简单 的 不 相等 菇 泗 ， 比如 "x < 1" 落 泗 "x < 2" ; 否则 ， 谓 词 

条 件 必须 准确 匹配 查询 的 were 条 件 ， 不 然 系统 将 无 法 识别 该 索引 是 可 用 的 。 匹 配 发 生 在 查 


询 规划 期 间 ， 而 不 是 运行 期 间 。 因 此 ， 参 数 化 的 查询 子 句 必定 不 会 使 用 部 分 素 引 。 例 如 ， 一 
个 预先 写 好 的 、 带 有 参数 的 查询 可 能 指定 了 "x < ?"， 它 不 可 能 对 所 有 可 能 的 参数 值 都 蔓 泗 "x < 
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部 分 素 引 的 第 三 种 用 途 是 茶 止 在 查询 中 使 用 索引 。 如 Example 11-3 所 示 ， 这 里 的 概念 是 在 表 
的 子 集 里 创建 唯一 索引 。 这 样 就 强制 在 满足 谓词 的 行 中 保持 唯一 性 ， 而 并 不 约束 那些 不 需要 
唯一 的 行 。 


Example 11-3. 设置 一 个 部 分 唯一 索引 


假设 我 们 有 一 个 记录 测试 输出 的 表 。 我 们 希望 确保 在 每 个 目标 和 课题 的 组 合 中 只 有 一 个 "成 
功 "记录 ， 但 是 可 以 有 任意 数量 的 "不 成 功 "记录 。 下 面 是 实现 方法 : 


CREATE TABLE tests ( 
subject text, 
target text, 
success boolean, 


Ne 


CREATE UNIQUE INDEX tests_success_constraint ON tests (subject, target) 
WHERE success; 


如 果 只 有 少数 成 功 测试 而 有 很 多 不 成 功 测试 ， 那 么 这 是 一 种 非常 有 效 的 实现 方法 。 


最 后 ， 部 分 素 引 也 可 以 用 于 取代 系统 选择 的 查询 规划 。 同 桩 ， 如 果 数 据 集 的 分 布 是 比较 特定 
的 形状 ， 那么 会 导致 系统 在 不 该 使 用 索引 的 时 候 使 用 它 。 在 这 种 情况 下 ， 我 们 可 以 把 索引 设 
置 为 在 违反 规律 的 查询 中 不 可 用 。 通 常 PostgreSQL 对 索引 的 使 用 会 做 出 合理 的 选择 (比如 ， 

它 在 检索 普通 数值 的 时 候 避 免 使 用 它 ， 因此 前 面 的 例子 实际 上 只 是 节约 了 索引 的 尺寸 ， 它 并 
不 要 求 避 免 素 引 的 使 用 )， 但 是 如 果 出 现 了 错误 的 规划 选择 那么 请 提交 一 个 臭虫 报告 。 


请 记 住 一 件 事 : 设置 一 个 部 分 索引 表示 你 至 少 和 查询 规划 器 知道 的 一 样 多 ， 特别 是 你 知道 什 
么 场合 下 索引 是 有 效 的 。 要 形成 这 些 知 识 要求 你 经 验 丰 富 并 且 理 解 PostgreSQL 的 索引 是 如 何 
运作 的 。 在 大 多 数 情况 下 ， 部 分 索引 对 普通 索引 的 优势 并 不 太 明 显 。 


更 多 有 关 部 分 素 引 的 信息 可 以 在 部 分 素 引 实例 , POSTGRES 中 部 分 素 引 :研究 计划 , 和 
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11.9. 操作 符 类 和 操作 符 族 


定义 索引 的 同时 可 以 为 索引 的 每 个 字段 声明 一 个 操作 符 类 。 


CREATE INDEX _name_ ON _table_ (_column opclass_ [°_sort options_~] [, ...]); 





这 个 操作 符 类 指明 该 索引 用 于 该 字段 时 要 使 用 的 操作 符 。 例 如 ， 一 个 在 inta 上 的 B-tree ® 
引 将 使 用 int4_ops 类 ; 这 个 操作 符 类 包括 用 于 inta 的 比较 玉 数 。 实 际 上 ， 字 段 类 型 的 缺 省 
操作 符 通常 就 足够 了 。 拥 有 操作 符 类 的 主要 原因 是 : 对 于 某 些 数据 类 型 ， 可 能 存在 多 个 有 意 
义 的 索引 行为 。 例 如 ， 我 们 可 能 想 排 序 两 个 复数 ， 既 可 能 通过 绝对 值 ， 也 可 能 通过 实 部 。 我 
们 可 以 通过 为 该 数据 类 型 定义 两 个 操作 符 类 ， 然后 在 建立 索引 时 选择 合适 的 那个 。 操 作 符 类 
决定 了 基本 的 排序 方式 (这 个 方式 可 以 通过 添加 排序 选项 来 修改 : ”coLLATE ，Asc / pesce 和 / 


或 NULLS FIRST / NULLS LAST ) 。 
除了 缺 省 的 以 外 ， 还 有 一 些 有 内 置 的 操作 符 类 : 


e text_pattern_ops , varchar_pattern_ops 和 bpchar_pattern_ops 操作 符 类 分 别 支持 
在 text , varchar 和 char 类 型 上 的 B-tree 索引 。 他 们 和 与 初始 的 操作 符 类 的 区 别 是 数值 
是 严格 地 逐个 字 节 比较 的 ， 而 不 是 根据 区 域 相 关 的 集合 规则 进行 比较 。 这 样 ， 如 果 数 据 
库 不 使 用 标准 的 "C" 区 域 设 置 ， 那 么 这 些 操作 符 类 适用 于 那些 涉及 模式 匹配 表达 式 
( LIKE 或 者 POSIX 正则 表达 式 ) 的 查询 。 举 一 个 例子 ， 你 可 以 像 下 面 这 样 对 一 
个 varchar 字段 进行 索引 : 


CREATE INDEX test_index ON test_table (col varchar_pattern_ops); 


请 注意 ， 如 果 你 希望 包含 普通 &lt; , &lt;=, &gt; ,或 &gt;= 比较 的 查询 使 用 索引 ， 那 

么 你 还 应 该 创建 一 个 使 用 缺 省 操作 符 类 的 索引 。 这 样 的 查询 不 能 使 用 _xxx_ pattern_ops 
操作 符 类 。 〈 不 过 普通 相等 比较 可 以 使 用 这 个 操作 符 类 。) 在 同一 个 字段 上 创建 多 个 使 
用 不 同 操作 符 类 的 索引 是 可 能 的 。 如 果 你 确实 使 用 了 标准 的 "C" 区 域 设 置 ， 那 么 你 就 不 需 
要 ”xxx_pattern_ops 操作 符 类 ， 因 为 使 用 缺 省 操作 符 类 的 索引 可 以 用 于 C 区 域 里 面 的 

模式 匹配 查询 。 


下 面 的 查询 显示 所 有 已 定义 的 操作 符 类 : 


SELECT am.amname AS index_method, 
opc.opcname AS opclass_name 
FROM pg_am am, pg_opclass opc 
WHERE opc.opcmethod = am.oid 
ORDER BY index_method, opclass_name; 


一 个 操作 符 类 实际 上 只 是 一 个 名 为 操作 符 族 的 大 构造 的 子 集 。 在 这 种 情况 下 ， 一 些 数据 类 型 
有 相同 的 行为 ， 这 对 于 定义 跨 数据 类 型 的 操作 符 通常 是 有 用 的 ， 并 且 人 允许 与 索引 一 起 使 用 。 

为 了 这 样 做 ， 每 种 类 型 的 操作 符 类 必须 分 人 相同 的 操作 符 族 内 。 跨 类 型 的 操作 符 是 这 个 族 的 
MA, 但 是 与 族 内 的 任何 一 个 类 都 没有 关系 。 


这 个 查询 显示 所 有 定义 的 操作 符 族 和 每 个 族 内 的 所 有 操作 符 : 


SELECT am.amname AS index_method, 
opf.opfname AS opfamily_name, 
amop.amopopr::regoperator AS opfamily_operator 
FROM pg_am am, pg_opfamily opf, pg_amop amop 
WHERE opf.opfmethod = am.oid AND 
amop.amopfamily = opf.oid 
ORDER BY index_method, opfamily_name, opfamily_operator; 


11.10. 索引 和 排序 


一 个 索引 只 能 支持 一 个 索引 字段 的 排序 。 如 果 多 个 排序 参与 ， 就 需要 多 个 索引 。 
考虑 这 些 语 句 : 


CREATE TABLE testic ( 
id integer, 
content varchar COLLATE "x" 


); 
CREATE INDEX testic_content_index ON testic (content); 


索引 自动 使 用 底层 字段 的 排序 。 所 以 一 个 下 列 格式 的 查询 


SELECT * FROM testic WHERE content > _constant_; 


可 以 使 用 这 个 索引 ， 因 为 这 个 比较 会 默认 使 用 这 个 字段 的 排序 。 然 而 ， 这 个 索引 不 能 使 涉及 
到 一 些 其 他 排序 的 查询 加 速 。 所 以 如 果 查 询 是 下 列 格式 ， 那 么 ， 


SELECT * FROM testic WHERE content > _constant_ COLLATE "y"; 


一 个 额外 的 索引 将 会 建立 ， 以 支持 ty" 排序 ， 像 这 样 : 


CREATE INDEX testic_content_y_index ON testic (content COLLATE "y"); 


11.11. 检查 索引 的 使 用 


尽管 在 PostgreSQL 里 的 索引 并 不 需要 维护 或 调节 ， 但 是 检查 一 下 哪些 索引 在 实际 查询 中 被 使 
用 了 仍然 非常 重要 。 检查 索引 的 使 用 是 通过 EXPLAIN 命 令 进 行 的 ; 为 此 目的 做 的 应 用 

在 Section 14.1 里 演示 。 我 们 也 可 以 在 一 个 运行 的 服务 器 上 收集 有 关 索 引 使 用 的 统计 信息 ， 
就 像 Section 27.2 里 描述 的 那样 。 


归纳 一 个 判断 需要 设置 哪些 索引 的 通用 过 程 是 很 难 的 。 在 前 面 的 章节 中 已 经 列 出 了 许多 典型 

的 例子 。 在 大 多 数 情况 下 我 们 都 需要 许多 试验 。 本 节 的 剩余 部 分 就 是 给 出 一 些 这 方面 的 穷 

La 

。 总 是 先 运 行 ANALYZE 命 邻 收集 关于 表 中 数值 分 布 的 统计 信息 。 估计 一 个 查询 返回 的 行 数 
需要 这 个 信息 ， 而 规划 器 需要 这 个 行 数 以 便 给 每 个 可 能 的 查询 规划 赋予 真实 开销 值 。 如 
果 缺 乏 任何 真实 的 统计 信息 ， 那 么 就 会 假设 一 些 缺 省 数值 ， 那 肯定 是 不 准确 的 。 因 此 ， 
如 果 还 没有 运行 ayz 就 检查 一 个 应 用 的 索引 使 用 状况 ， 那 实际 上 就 是 一 次 失败 的 检 

查 。 参阅 Section 23.1.3 和 Section 23.1.6 获 取 详 细 信 息 。 


。 使 用 真实 的 数据 做 实验 。 用 测试 数据 设置 索引 将 告诉 你 在 测试 数据 中 需要 什么 素 引 ， 而 
不 是 在 真实 数据 中 。 


最 要 命 的 是 用 很 小 的 数据 集 。 如 果 从 100000 行 中 选 1000 行 是 使 用 索引 的 好 时 机 ， AR 
4M 100 行 中 选 1 行 很 难说 也 需要 素 引 ， 因 为 100 行 很 可 能 是 装 在 一 个 磁盘 页 里 面 的 ， 
因此 没有 任何 查询 规划 能 比 通过 顺序 访问 抓 取 一 个 磁 吉 页 面 更 有 效 。 


做 测试 数据 的 时 候 也 要 小 心 ， 如 果 应 用 还 不 能 在 生产 环境 中 使 用 ， 那 么 这 也 是 不 可 避免 
BY, 那些 非常 相似 的 数据 、 完 全 随机 的 数据 、 或 者 按照 排序 顺序 插入 的 数据 会 令 统 计 信 
息 偏离 实际 数据 的 特征 。 


。 如 果 索 引 没有 得 到 使 用 ， 那 么 在 测试 中 强制 它 的 使 用 也 许 有 些 价值 。 有 一 些 运行 时 参数 
可 以 关闭 各 种 各 样 的 查询 规划 (在 Section 18.7.1 中 描述 )。 比如， 关闭 顺序 扫描 
( enable_seqscan ) 和 族 套 循环 连接 ( enable_nestloop ) 将 强迫 系统 使 用 不 同 的 规划 。 如 果 
系统 仍然 选择 顺序 扫描 或 者 柑 套 循环 连接 ， 那 么 在 为 何 索 引 没 有 得 到 使 用 的 问题 中 可 能 
有 更 基本 的 问题 ， 比 如 ， 查询 条 件 和 索引 不 匹配 等 (前 面 的 章节 中 介绍 了 什么 样 的 查询 可 
以 使 用 什么 样 的 索引 )。 


如 果 强 制 素 引 用 法 确实 使 用 了 索引 ， 那 么 就 有 两 种 可 能 : 要 么 是 系统 选择 是 正确 的 : 使 
用 索引 实际 上 并 不 合适 ， 要 么 是 查询 计划 的 开销 计算 并 不 反映 现实 情况 。 这 样 你 就 应 该 
对 使 用 和 不 使 用 索引 的 查询 进行 计时 。 这 个 时 候 EXPLAIN ANALYZE 命令 就 很 有 用 了 。 


如 果实 际 情况 说 明 开 销 计算 是 错误 的 ， 那 么 仍然 有 两 种 可 能 。 总 开销 是 从 每 行 的 每 个 规 
划 节 点 的 开销 乘 以 每 个 规划 节点 的 选择 性 估计 计算 出 来 的 。 规划 节点 的 开销 估计 可 以 用 
一 些 运行 时 参数 进行 调节 (在 Section 18.7.2 中 描述 )。 不 准确 的 选择 性 估计 是 因为 统计 信 


分 。 我 们 可 以 通过 调节 统计 收集 参数 (参阅 ALTER TABLE) 提 高 选择 性 估计 的 精 


息 不 够 充 
度 。 


如 果 你 没 能 通过 将 开销 调整 得 更 准确 而 实现 索引 的 使 用 ， 那 么 你 可 能 不 得 不 求助 于 明确 
地 强制 索引 使 用 。 并 且 与 PostgreSQL 开 发 人 员 联 系 并 讨论 你 的 情况 。 
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12.1. 介绍 


ELER (或 只 是 文本 搜索 ) 提供 满足 查询 的 识别 自然 语言 文档 的 能 力 ， 并 且 任 意 地 通过 相 
关 性 查询 进行 排序 。 搜 索 最 常见 的 类 型 是 找到 所 有 包含 给 定 的 查询 术语 的 记录 ， 并 且 以 相似 
性 的 查 询 顺 序 返 回 它 们 。 query 和 similarity 的 念 是 非常 灵活 的 ， 取 决 于 特定 的 应 用 。 


i=] Z5 
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单 的 搜索 认为 query 是 一 组 词 ， 并 且 similarity 为 文档 中 的 查询 词 出 现 的 频率 。 


文本 搜索 操作 符 已 经 在 数据 库 中 存在 多 年 。PostgreSQL 为 文本 数据 类 型 提供 ~ ，-* ， 
LIKE 和 ILIKE 操作 符 ， 但 它们 缺乏 许多 通过 现代 信息 系统 要 求 的 必要 属性 : 


全 文 


eo 
FRR 


没有 语言 的 支持 ， 即 使 是 英语 。 正 则 表达 式 是 不 充分 的 ， 因 为 他 们 不 能 很 容易 地 处 理 派 
生词 ， 比如 ， satisfies 和 satisfy 。 你 可 能 会 丢失 包含 satisfies 的 文档 ， 虽然 你 
可 能 会 发 现 他 们 在 寻找 satisfy 。 使 用 oR 搜索 多 个 派生 形式 是 可 能 的 ， 但 这 很 繁琐 ， 
而 且 容 易 出 错 《有些 词 可 能 会 有 上 千 的 派生 词 ) 。 


他 们 没有 提供 搜索 结果 的 分 类 (排序) ， 当 成 千 的 匹配 文档 被 发 现时 ， 这 使 得 它们 无 
效 。 


他 们 往往 比较 缓慢 ， 因 为 没有 索引 的 支持 ， 因 此 他 们 必须 为 每 一 个 搜索 处 理 所 有 文档 。 
索引 允许 文档 被 预 处 理 ， 并 且 为 后 边 的 快速 搜索 保存 一 个 索引 。 预 处 理 包括 : 


解析 文档 _ 标记。 标识 不 同类 别 的 记号 是 非常 有 用 的 ， 例如 ， 数 字 ， 词 ， 复 合 词 ， 电 子 
邮件 地 址 ， 这 样 他 们 可 以 用 不 同 的 方法 来 处 理 。 原 则 上 兮 牌 类 依赖 于 具体 的 应 用 ， 但 出 
于 大 多 数 的 目的 ， 可 以 使 用 一 组 预定 义 的 类 。PostgreSQL 使 用 解析 器 来 执行 这 一 步 。 提 
供 了 一 种 标准 的 解析 器 ， 以 及 为 特定 的 需求 创造 的 自 定 义 分 析 器 。 


转换 标记 为 ” 词 。 词 是 一 个 字符 串 ， 就 像 一 个 标记 ， 但 它 已 经 标准 化 ， 这 样 同一 个 词 的 
不 同形 式 是 一 样 的。 例如 ， 标 准 化 几乎 总 是 包括 可 折 和 县 的 大 写字 母 到 小 写字 母 ， 往 往 涉 
及 删除 后 级 (如 英语 中 的 s 或 者 es ) 。 这 人 允许 搜索 找到 同一 个 词 的 不 同形 式 ， 没 有 
繁琐 的 输入 所 有 可 能 的 变种 。 同 时 ， 这 一 步 通常 删除 屏蔽 词 ， 这 是 很 常见 的 ， 他 们 对 于 
搜索 无 用 。 (总 之 ， 标 记 是 文档 文本 的 原 片段 ， 而 词汇 被 认 为 是 有 用 的 索引 和 搜索 的 
词 。) PostgreSQL 使 用 词典 执行 这 一 步 。 提 供 各 种 标准 词典 ， 以 及 为 特定 的 需求 创造 的 
自 定义 词典 。 


为 优化 搜索 存储 预 处 理 文档 。 上 比如 ， 每 个 文档 可 以 表示 为 标准 化 词汇 排序 数组 。 伴随 着 
词汇 往往 为 邻近 排序 存储 位 置信 息 ， 这 是 理想 的 。 因 此 包含 查询 词 的 "密集 "区 域 的 文档 
比分 散 查 询 词 分 配 到 一 个 更 高 的 顺序 。 


许 细 粒度 控制 如 何 使 用 合适 的 字典 规范 化 标记 。 你 可 以 : 
定义 不 被 索引 的 屏蔽 词 。 
使 用 lspell 映 射 同义词 到 一 个 词 。 


。 使 用 同义词 词典 将 短语 映射 到 一 个 词 。 
。 使 用 Ispell 词 典 将 词 的 不 同形 式 映 射 到 一 种 范式 。 
。 使 用 Snowball 词 根 规则 将 一 个 词 的 不 同形 式 映 射 到 一 种 范式 。 


一 种 数据 类 型 tsvector 用 于 存储 预 处 理 文档 ， 以 及 类 型 tsquery 表示 义理 的 查询 (Section 
8.11) 。 为 这 些 数据 类 型 提供 很 多 的 函数 和 操作 符 (Section 9.13) ， 其 中 最 重要 的 是 匹配 运 
算 符 ee ， 将 在 Section 12.1.2 中 介绍 。 全 文 搜索 可 以 使 用 索引 进行 加 速 (Section 12.9) 。 


12.1.1. 文档 是 什么 ? 


一 个 文档 是 全 文 搜索 系统 的 搜索 单元 ; 例如 ， 条 志 上 的 一 篇 文章 或 电子 邮件 消息 。 文本 搜索 
引擎 必须 能 够 解析 文档 ， 而 且 可 以 存储 它们 父 文档 词 (关键 词 ) 的 联系 性 。 之 后 ， 这 些 联系 
用 来 搜索 包含 查询 词 的 文档 。 


在 PostgreSQL 中 搜索 ， 文 档 通 常 是 一 个 数据 库 表 中 一 行 的 文本 字段 ， 或 者 这 些 字段 的 可 能 组 
合 (级 联 ) ， 可 能 存储 在 多 个 表 中 或 者 动态 地 获得 。 换 句 话 说 ， 一 个 文档 可 以 由 索引 的 不 同 
部 分 构成 ， 它 不 可 能 随时 随地 作 为 一 个 整体 存储 。 比 如 : 


SELECT title || ' ' || author || ' ' || abstract || ' ' || body AS document 

FROM messages 

WHERE mid = 12; 

SELECT m.title || ' ' || m.author || ' ' [| m.abstract || ' ' || d.body AS document 


FROM messages m, docs d 
WHERE mid = did AND mid = 12; 











Note: 注意 :实际 上 ， 在 这 些 示例 查询 中 ， coalesce 使 用 时 应 防止 一 个 独立 的 NuLL 属性 
导致 整个 文档 的 NuLL 结果 。 


另外 一 个 可 能 性 是 在 文档 系统 中 作为 简单 的 文本 文档 存储 。 在 这 种 情况 下 ， 数 据 库 可 以 用 于 
存储 全 文 索引 并 且 执 行 搜索 ， 同 时 使 用 一 些 唯一 标识 从 文件 系统 中 检索 文档 。 然 而 ， 从 外 部 
检索 文件 ， 数 据 库 需要 拥有 超级 用 户 权限 或 者 特殊 函数 支持 ， 因 此 比 把 所 有 数据 保存 在 
PostgreSQL 中 相 比 较 ， 这 往往 不 太 方 便 。 同 时 ， 保 持 所 有 的 数据 在 数据 库 里 面 允 许 轻 松 访问 
文档 的 元 数据 以 帮助 索引 和 显示 。 








为 了 文本 搜索 目的 ， 每 个 文档 必须 减少 到 预 处 理 tsvector 格式 。 在 文档 的 tsvector 表示 形 
式 上 完整 的 执行 搜索 和 排序 一 当 为 了 显示 给 用 户 来 选择 文档 时 ， 只 需要 检索 原文 本 。 因 此 我 
们 常 说 的 tsvector 作为 文档 ， 当 然 它 仅仅 是 完整 文档 的 一 种 紧凑 表示 。 


12.1.2. 基本 文本 匹配 


PostgreSQL 中 的 全 文 搜索 基于 匹配 算 子 ee ， 如 果 一 个 tsvector (document) 匹 配 一 
个 tsquery (query), 则 返回 true 。 不 管 哪个 数据 类 型 先 被 重 写 : 


SELECT 'a fat cat sat on a mat and ate a fat rat'::tsvector @@ 'cat & rat'::tsquery; 
?column? 


SELECT 'fat & cow'::tsquery @@ 'a fat cat sat on a mat and ate a fat rat'::tsvector; 
?column? 


正如 上 面 例子 表明 ， 一 个 tsquery 不 仅仅 是 原文 本 ， 更 多 的 是 一 个 tsvector 。 
条 件 的 tsquery ， 必须 是 已 经 标准 化 的 词 ， 并 且 可 能 使 用 AND, OR, 和 NOT 操 作 符 连 接 多 
术语 (详情 请 见 Section 8.11) o EAR to_tsquery 和 plainto_tsquery oe 
成 一 个 合适 的 tsquery 是 非常 有 帮助 的 。 比如 通过 标准 化 文本 中 的 词 。 类 似 

的 ， to_tsvector 用 于 解析 和 标准 化 文档 字符 串 。 因 此 在 实践 中 文本 搜索 匹配 可 能 看 起 来 更 
像 这 样 : 


SELECT to_tsvector('fat cats ate fat rats') @@ to_tsquery('fat & rat'); 
?column? 


观察 这 个 匹配 可 能 不 会 成 功 ， 如 果 写 成 这 


SELECT 'fat cats ate fat rats'::tsvector @@ to_tsquery('fat & rat'); 
?column? 


由 于 这 儿 没 有 发 生词 rats 的 标准 化 。 一 个 tsvector 的 元 素 是 词 ， 假 设 已 经 被 标准 化 ， 所 
以 rats 不 匹配 rat 。 


co 操作 符 也 支持 text 输入 ， 人 允许 一 个 文本 字符 串 的 显示 转换 为 tsvector 或 者 在 简单 情况 
下 忽略 tsquery 。 可 用 形式 是 : 


tsvector @@ tsquery 
tsquery @@ tsvector 
text @@ tsquery 
text @@ text 


我 们 已 经 看 到 了 前 面 两 种 ， 形 式 text @@ tsquery 等 价 于 to_tsvector(x) @@ yo text 
@@ text 等 价 于 to_tsvector(x) @@ plainto_tsquery(y) o 


12.1.3. Acie 


上 面 是 所 有 简单 文本 搜索 例子 。 如 前 所 述 ， 全 文 搜索 功能 还 有 能 力 做 更 多 事情 : 忽略 索引 某 
个 词 (RRA) ， 过 程 同 义 词 和 使 用 复 末 解析 ， 比 如 : 不 仅仅 基于 空白 格 的 解析 。 这 些 功 能 
通过 文本 搜索 配置 控制 。 PostgreSQL 来 自 多 语言 的 预先 定义 的 配置 ， 并 且 你 也 可 以 很 容易 的 
创建 你 自己 的 配置 (psql 的 \dF 命令 显示 了 所 有 可 用 配置 ) 。 


在 安装 期 间 选 择 一 个 合适 的 配置 ， 并 且 在 postgresql.conf 中 相应 的 设 
iadefault_text_search_config, 如 果 为 了 整个 集群 使 用 同一 个 文本 搜索 配置 你 可 以 使 

用 postgresql.conf 中 的 值 。 为 了 在 集群 中 使 用 不 同 配置 ， 但 是 在 任何 其 他 一 个 数据 库 的 同一 
配置 中 使 用 ALTER DATABASE ... SET 。 和 否则 ， 你 可 以 在 每 个 会 话 中 设 


G default_text_search_config o 


BMF EEN MABRREMA-—TAN regconfig 参数 ， 因 此 可 以 明确 声明 使 用 的 配 
E, 信 当 忽略 这 些 参数 的 时 候 ， 才 使 用 default_text_search_config o 


为 了 更 方便 的 建立 自 定义 文本 搜索 配置 ， 从 简单 的 数据 库 对 象 中 建立 了 配置 。 PostgreSQL 文 
本 搜索 功能 提供 了 四 种 类 型 的 配置 相关 的 数据 库 对 象 : 


。 文本 搜索 解析 器 打破 文档 标记 ， 并 且 分 类 每 个 标记 (比如 ， 词 和 数字 ) 。 
© 文本 搜索 词典 把 标记 转换 成 规范 格式 并 且 拒 绝 屏蔽 词 。 


。 文本 搜索 模板 提供 潜在 的 词典 功能 (一 个 词典 简单 的 指定 一 个 模板 ， 并 且 为 模板 设置 参 
数 ) 。 


。 文本 搜索 配置 选择 一 个 解析 器 ， 并 且 使 用 一 系列 词典 规范 化 语法 分 析 器 产生 的 标记 。 


文本 搜索 解析 器 和 模板 是 从 低层 次 的 C 画 数 建立 的 ; 因此 它 需 要 C 程 序 能 力 开发 新 产品 ， 并 且 
需要 超级 用 户 权 限 安装 到 数据 库 中 (在 PostgreSQL 发 布 的 contrib/ 范围 内 有 附加 解析 器 和 模 
板 的 实例 ) 。 因为 词典 和 配置 仅仅 参数 化 并 且 连 接 到 一 些 潜在 的 解析 器 和 模板 上 ， 创 建 一 个 

新 的 词典 或 者 配置 不 需要 特定 的 权限 。 创建 自 定义 词典 和 配置 实例 出 现在 本 章节 的 后 面 。 


12.2. 表 和 索引 


上 一 节 中 的 例子 说 明 使 用 简单 常量 字符 串 的 全 文 匹 配 。 本 节 显 示 如 何 搜索 表 中 的 数据 ， 选 择 
使 用 索引 。 


12.2.1. 搜索 表 


在 不 使 用 索引 的 情况 下 也 是 可 以 进行 全 文 检索 的 ,一 个 简单 查询 ,显示 出 title 从 所 有 body 字 
段 中 包含 friend 的 每 一 行 : 


SELECT title 
FROM pgweb 
WHERE to_tsvector('english', body) @@ to_tsquery('english', 'friend'); 


这 也 将 找到 相关 的 词 ， 比 如 friends 和 friendly ， 因 为 所 有 的 这 些 都 降低 到 相同 规范 化 的 


1 o 
以 上 查询 指定 english 配置 是 用 来 解析 和 规范 化 字符 串 。 或 者 我 们 可 以 省 略 配置 参数 : 


SELECT title 
FROM pgweb 
WHERE to_tsvector(body) @@ to_tsquery('friend'); 


这 个 查询 将 通过 default text_search_config 使 用 配置 设置 。 


复 条 一 点 的 例子 :检索 出 最 近 的 10 个 文档 ,在 title 或 者 body 字段 中 包含 create 和 


table 的 


SELECT title 

FROM pgweb 

WHERE to_tsvector(title || ' ' || body) @@ to_tsquery('create & table') 
ORDER BY last_mod_date DESC 

LIMIT 10; 


了 清楚 ,我 们 忽略 coalesce KARA %BERAEARATSFRZ—-HEAS nue 的 行 。 


虽然 这 些 查询 在 没有 索引 的 情况 下 工作 ， 大 多 数 应 用 程序 会 发 现 这 个 方法 太 慢 了 ， 除 了 偶尔 
的 特定 搜索 。 文本 搜索 的 实际 使 用 通常 需要 创建 索引。 


12.2.2. 创建 索引 


为 了 加 速 文本 搜索 ， 我 们 可 以 创建 GIN 索 引 (Section 12.9) : 


CREATE INDEX pgweb_idx ON pgweb USING gin(to_tsvector('english', body)); 


注意 ， 使 用 to_tsvector 的 2- 参 数 版 本 。 唯 一 的 文本 搜索 功能 指定 可 用 于 表达 式 索 引 的 配置 名 
称 〈 节 Section 11.7) 。 这 是 因为 索引 的 内 容 必 须 不 受 default text _search_config 的 影响 。 如 
果 他 们 受到 影响 ， 索 引 内 容 可 能 不 一 致 ， 因为 不 同 的 条 目 可 能 包含 不 同 的 文本 搜索 配置 创建 
的 tsvector ， 并 且 没 有 办 法 猜 出 是 哪个 。 正 确 的 转 储 和 恢复 这 样 的 一 个 索引 是 不 可 能 


因为 在 上 述 索 引 中 使 用 to_tsvector 的 2- 参 数 版 本 ， 只 有 一 个 使 用 带 有 相同 配置 名 称 

的 to_tsvector 的 2- 参 数 版 本 的 查询 人 参考， 它 将 使 用 该 索引 。 也 就 是 

说 ， WHERE to_tsvector('english', body) @@ 'a & b' Ay be AR, 

但 WHERE to_tsvector(body) @@ 'a & b' 不 能 。 这 确保 将 使 用 一 个 索引 仅仅 伴随 着 用 于 创建 索 
引 的 相同 配置 。 


建立 更 复 条 的 表达 式 索 引 是 可 能 的 ， 配 置 名 称 由 另 一 列 指定 ， 例 如 


CREATE INDEX pgweb_idx ON pgweb USING gin(to_tsvector(config_name, body)); 


在 pgweb 表 中 config_name 是 一 列 。 这 人 允许 在 同一 索引 中 混合 配置 ， 当 记录 的 配置 被 用 于 每 
个 索引 条 目 。 这 将 是 有 用 的 ， 例 如 ， 如 果 文 档 集合 中 包含 不 同 的 语言 文件 。 再 次 ， 意 味 着 使 
用 索引 的 查询 必须 措辞 匹配 ， 例如 ， WHERE to_tsvector(config_name, body) @@ 'a & b' o 


索引 甚至 可 以 连接 列 : 


CREATE INDEX pgweb_idx ON pgweb USING gin(to_tsvector('english', title || ' ' || body)); 
有 EN 可 


另 一 个 方法 是 创建 一 个 单独 的 tsvector 列 控 制 to_tsvector 的 和 输出。 这 个 例子 
是 title 和 body 的 一 个 级 联 ， 当 其 他 是 NuLL 的 时 候 ， 使 用 coalesce 确保 一 个 字段 仍然 会 
被 索引 : 


ALTER TABLE pgweb ADD COLUMN textsearchable_index_col tsvector; 
UPDATE pgweb SET textsearchable_index_col = 
to_tsvector('english', coalesce(title,'') || ' ' || coalesce(body,'')); 


然后 我 们 为 加 速 搜索 创建 一 个 GIN 索 引 : 


CREATE INDEX textsearch_idx ON pgweb USING gin(textsearchable_index_col); 


现在 我 们 准备 执行 一 个 快速 全 文 搜索 : 


SELECT title 

FROM pgweb 

WHERE textsearchable_index_col @@ to_tsquery('create & table') 
ORDER BY last_mod_date DESC 

LIMIT 10; 


当 使 用 一 个 单独 的 列 存 储 tsvector 形式 时 ， 有 必要 创建 一 个 触发 器 以 保持 tsvector 列 当前 
任何 时 候 title 或 者 body 的 变化 。 节 Section 12.4.3 解 释 了 如 何 做 。 


单独 列 方法 比 一 个 表达 式 素 引 的 优势 是 它 没 有 必要 明确 地 声明 为 充分 利用 索引 查询 中 的 文本 
搜索 配置 ， 正如 上 面 例子 所 示 ， 查询 依赖 于 default_text_search_config o 另 一 个 优势 是 搜索 
比较 快速 ， 因为 它 没 有 必要 重新 进行 to_tsvector 调用 来 验证 索引 匹配 〈 当 使 用 GIST 索 引 而 
不 是 GIN 索 引 的 时 候 ， 这 是 非常 重要 的 ， 参 见 节 Section 12.9) 。 表 达 式 索引 方法 更 容易 建 
立 ， 然 而 ， 它 需要 较 少 的 磁盘 空间 ， 因为 tsvector 形式 没有 明确 存储 。 


12.3. 控制 文本 搜索 
为 了 执行 全 文 搜 索 ， 这 必须 有 个 函数 创建 来 自 文 档 的 tsvector 和 来 自用 户 查 询 的 tsquery o 


同时 ， 我 们 需要 以 有 效 的 顺序 返回 结果 ， 因 此 我 们 需要 一 个 函数 比较 关于 查询 相关 性 的 文 
档 。 可 以 很 好 的 显示 结果 也 是 很 重要 的 。PostgreSQL 为 所 有 这 些 函 数 提供 支持 。 


12.3.1. 解析 文档 


PostgreSQL 中 提供 了 to_tsvector 画 数 把 文档 义理 成 tsvector 数据 类 型 。 


to_tsvector([ ~_config_~ ‘regconfig’, ] _document_ text) returns tsvector 
to_tsvector 解析 文本 文档 为 记号 ， 减 少 标记 到 词 条 ， 并 返回 一 个 tsvector, HF 


并 连同 它们 文档 中 的 位 置 。 该 文档 是 根据 指定 的 或 默认 的 文本 搜索 配置 处理 的 。 这 里 有 一 
简单 的 例子 : 


SELECT to_tsvector('english', 'a fat cat sat on a mat - it ate a fat rats'); 
to_tsvector 


在 上 面 的 例子 中 我 们 看 到 结果 tsvecto 不 包含 词 a, on 或 者 it. rats ¥M rat ,并 且 
忽略 标点 符号 -。 


该 to_tsvector 图 数 内 部 调用 一 个 分 析 器 ， 将 文档 文本 分 解 成 记号 并 指定 每 个 标记 的 类 型 。 

为 每 个 标记 ， 参 阅 词典 列表 ( 节 Section 12.6) ， 列 表 因 不 同 的 标记 类 型 而 不 同 。 第 一 本 词典 
别 标 记 发 出 一 个 或 多 个 标准 词汇 表示 标记 。 例 如 ， rats FM rat 因为 字典 认为 

词 rats 是 rat 的 复数 形式 。 有 些 词 被 作为 屏 殴 词 (F Section 12.6.1) ， 这 样 它们 就 会 被 忽 

略 ， 因 为 它们 出 现 得 太 过 频繁 以 致 于 搜索 中 没有 用 人 处。 在 我 们 的 例子 中 ， 它 们 是 a ， 

on 和 it o 如 果 列 表 中 没有 词典 识别 标记 ， 那 么 它 也 被 忽略 。 在 这 个 例子 中 ， 发 生 在 标点 符 

号 处 - 因为 事实 上 没有 词典 分 配给 它 的 标记 类 型 ( 空间 符号 ) ， 意味 着 空间 记号 永远 不 会 被 

索引 。 语 法 分 析 器 的 选择 ， 词 典 和 索引 类 型 的 标记 是 由 选 定 的 文本 搜索 配置 决定 〈 节 Section 

12.7) 。 可 以 在 同一 个 数据 库 中 有 多 种 不 同 的 配置 ， 与 提供 各 种 语言 的 预定 义 的 配置 。 在 我 

们 的 例子 中 ， 我 们 使 用 缺 省 配置 english 为 英语 。 


KMŽ setweight 可 以 用 于 标识 一 个 给 定 权重 的 tsvector 的 词 条 ， 权 重 是 字母 A，B ，fc 或 
者 5 之 一 。 通 常 标记 来 自 文 档 不 同 部 分 的 词 条 ， 比 如 标题 正文 。 之 后 ， 这 些 信 息 可 以 用 于 搜 
索 结 果 的 排序 。 


因为 to_tsvector ( NULL ) 将 要 返回 空 ， 当 字段 可 能 是 空 的 时 候 ， 建 议 使 用 coalesce 。 这 是 
体系 文档 中 创建 tsvector 推荐 的 方法 : 


UPDATE tt SET ti = 


setweight(to_tsvector(coalesce(title,'')), 'A') I | 
setweight(to_tsvector(coalesce(keyword,'')), 'B') || 
setweight(to_tsvector(coalesce(abstract,'')), 'C') || 
setweight(to_tsvector(coalesce(body,'')), 'D'); 


我 们 使 用 setweight 标记 已 完成 的 tsvector 中 的 每 个 词 的 来 源 ， 并 且 使 用 tsvector 连接 操作 
符 || 合并 标签 化 tsvector 的 值 。 ( 节 Section 12.4.1 详 细 介 绍 了 这 些 操作 ) 。 


12.3.2. 解析 查询 


PostgreSQL 提 供 了 辑 数 to_tsquery 和 plainto_tsquery 将 查询 转换 为 tsquery 数据 类 型 。 
to_tsquery 提供 比 plainto_tsquery 更 多 的 功能 ， 但 对 其 输入 不 宽容 。 


to_tsquery([ ~_config_~ ~regconfig*, ] _querytext_ text) returns tsquery 


to_tsquery 从 _querytext_ 中 创建 一 个 tsquery ， 它 必须 由 布尔 运算 符 & (AND), | (OR) 
和 ! (NOT) 分 离 的 单个 标记 组 成 。 这 些 运算 符 可 以 用 圆 括 弧 分 组 。 换 句 话说， to_tsquery 输 
入 必须 遵循 tsquery 输入 的 一 般 规律 ， 如 节 Section 8.11 所 描述 的 。 不 同 的 是 当 基 

本 tsquery 输入 以 标记 表面 值 的 时 候 ， to_tsquery 使 用 指定 或 默认 配置 规范 每 个 标记 到 一 个 
i, 并 丢弃 所 有 标记 依据 配置 的 屏 项 词 。 比 如 : 


SELECT to_tsquery('english', 'The & Fat & Rats'); 
to_tsquery 


'fat' & 'rat' 


作为 基本 tsquery MA, RH (s) 可 以 附属 于 每 个 词 来 限制 它 只 匹配 那些 权重 (s) 
的 tsvector 词 。 比 如 : 


SELECT to_tsquery('english', 'Fat | Rats:AB'); 
to_tsquery 


'fat' | 'rat':AB 


* 也 可 以 附属 于 一 个 词 来 指定 前 级 匹配 : 


SELECT to_tsquery('supern:*A & star:A*B'); 
to_tsquery 


"supern':*A & 'star':*AB 


PAY ie) PHC LAS EF BA AKBY tsvector 中 的 任何 词 。 


to_tsquery 也 可 以 接受 单 引 用 的 短语 。 当 配置 包括 一 个 可 能 触发 这 类 短语 的 同义词 词典 库 的 
时 候 是 很 有 用 的 。 在 下 面 的 例子 中 ， 一 个 词 库 包含 规则 supernovae stars : sn : 


SELECT to_tsquery('''supernovae stars'' & !crab'); 
to_tsquery 


"sn' & !'crab' 
没有 引号 ， to_tsquery 会 生成 标记 语法 错误 ， 这 个 标记 不 是 通过 AND 或 者 OR 操 作 符 分 离 
的 。 

plainto_tsquery([ ~_config_~ ~regconfig’, ] _querytext_ text) returns tsquery 
plainto_tsquery 变换 未 格式 化 的 文本 _querytext_ 到 tsquery o 分 析 文 本 并 且 为 一 化 


为 to_tsvector ， 然 后 在 存在 的 词 之 间 插 入 & (AND) 布 尔 算 子 。 
比如 : 


SELECT plainto_tsquery('english', 'The Fat Rats'); 
plainto_tsquery 


fat' & 'rat 
请 注意 ， plainto_tsquery 无 法 识别 布尔 运算 符 ， 权 重 标签 ， 或 在 其 输入 中 的 前 级 匹配 标签 : 


SELECT plainto_tsquery('english', 'The Fat & Rats:C'); 
plainto_tsquery 


在 这 里 ， 所 有 的 输入 标点 符号 作为 空格 符号 丢弃 。 


12.3.3. 查询 结果 关注 度 


相关 度 试图 衡量 哪 一 个 文档 是 检索 中 最 关注 的 ， 所 以 当 有 很 多 匹配 时 ， 最 相关 的 一 个 则 最 先 
显示 。 PostgreSQL 提 供 了 两 个 预定 义 的 相关 画 数 ， 其 中 考虑 了 词法 ， 距 离 ， 和 结构 信息 ; 也 
就 是 ， 他 们 考虑 查询 词 在 文档 中 出 现 的 频率 ， 术 语 在 文档 中 的 紧密 程度 ， 以 及 它们 在 文档 中 
的 部 分 的 重要 性 。 然而 ， 相 关 性 的 概念 是 模糊 的 ， 并 且 是 特定 应 用 程序 。 不 同 的 应 用 程序 可 
能 需要 额外 的 相关 信息 ， 例如， 文档 的 修改 时 间 。 内 置 的 相关 函数 是 唯一 的 例子 。 为 了 以 满 
足 您 的 特定 需求 ， 你 可 以 写 你 自己 的 相关 画 数 和 /或 与 其 他 因素 相 结合 的 结果 。 


当前 可 用 的 两 个 相关 画 数 : 


ts_rank([ ``_weights_ float4[] , ] _vector_ tsvector , _query_ tsquery [, 


_normalization_ integer ]) returns float4 


基于 匹配 词汇 频率 的 列 向 量 。 


ts_rank_cd([ ~°_weights_ float4[] , ] _vector_ tsvector , _query_ tsquery [, 


_normalization_ integer ])returns float4 


这 个 函数 计算 给 定 文档 向 量 和 查询 的 履 盖 密度 相关 性 ， 正 如 1999 年 在 杂志 “信息 处 理 与 管 
理 " 中 Clarke，Cormack 和 Tudhope 的 “一 至 三 项 查询 相关 性 排序 "描述 的 一 样 。 


这 些 酌 数 需要 位 置信 息 的 输入 。 因 此 它 不 能 在 "剥离 " tsvector 值 的 情况 下 运行 一 它 将 总 是 返 
os. 


对 于 这 些 范 数 ， 可 选 的 weights. 参数 提供 权衡 词 的 情况 能 力 或 多 或 少 地 取决 于 它们 是 如 何 
被 标记 的 。 权重 阵列 指定 顺序 权重 每 类 词 的 频率 。 


{D-weight, C-weight, B-weight, A-weight} 


如 果 没 有 提供 weights. ， 则 利用 这 些 缺 省 值 : 

{0.1, 0.2, 0.4, 1.0} 
通常 的 权重 是 用 来 标记 文档 特殊 区 域 的 词 ， 如 标题 或 最 初 的 摘要 ， 所 以 他 们 有 着 比 文档 主体 
中 的 词 或 多 或 少 的 重要 性 。 


由 于 较 长 的 文档 有 包含 查询 词 的 机 会 ， 它 合理 的 考虑 文档 的 大 小 ， 例 如 ， 带 有 搜索 词 的 五 个 
实例 的 百 宇文 档 可 能 比 千 字 文 档 有 更 多 的 相关 性 。 相关 接受 一 个 整数 _normalization 选项 ， 
指定 文档 长 度 是 否 以 及 如 何 影响 它 的 排序 。 整数 选项 控制 一 些 行为 ， 所 以 它 是 一 位 掩 码 : 您 
可 以 使 用 | (例如 ， 214) 指定 一 个 或 多 个 行为 。 


。 0 (RA) 表示 跟 长 度 大 小 没有 关系 
。 1 表示 关注 度 (rank) 除 以 文档 长 度 的 对 数 +1 
。 2 表示 关注 度 除 以 文档 的 长 度 
。 4 表示 关注 度 除 以 范围 内 的 平均 谐 波 距离 ， 只 能 使 用 ts_rank_cd 实现 。 
。 8 表示 关注 度 除 以 文档 中 唯一 分 词 的 数量 
。 16 表 示 关 注 度 除 以 唯一 分 词 数量 的 对 数 +1 
。 32 表 示 关 注 度 除 以 本 身 +1 
如 果 指 定 超过 一 个 的 标志 位 ， 则 在 列 出 顺序 中 应 用 转换 。 


需要 特别 注意 的 是 ， 相 关 画 数 不 使 用 任何 全 局 信息 ， 所 以 不 可 能 产生 一 个 所 需要 的 1% 或 
100% 的 公平 为 一 化 。 规范 化 选项 32 ( rank/(rank+1) ) 可 用 于 所 有 规模 排序 到 范围 规 到 一 之 
间 ， 当 然 ， 这 只 是 一 个 表面 变化 ; 它 不 会 影响 搜索 结果 的 排序 。 


下 面 是 一 个 例子 ， 仅 仅 选 择 排名 前 十 的 匹配 : 


SELECT title, ts_rank_cd(textsearch, query) AS rank 
FROM apod, to_tsquery('neutrino|(dark & matter)') query 
WHERE query @@ textsearch 

ORDER BY rank DESC 


LIMIT 10; 
title | rank 

Ee ee ENS ae AEEA A er Ne yey See a Se yn ees eee Serer 
Neutrinos in the Sun Goal 
The Sudbury Neutrino Detector 2.4 
A MACHO View of Galactic Dark Matter 2.01317 
Hot Gas and Dark Matter 1.91171 
The Virgo Cluster: Hot Plasma and Dark Matter 1.90953 


| 
| 
| 
| 
| 
Rafting for Solar Neutrinos | 1.9 
| 
| 
| 
| 


NGC 4650A: Strange Galaxy and Dark Matter 1.85774 
Hot Gas and Dark Matter 1.6123 
Ice Fishing for Cosmic Neutrinos 1.6 
Weak Lensing Distorts the Universe 0.818218 


这 是 使 用 为 一 化 排序 的 相同 例子 


SELECT title, ts_rank_cd(textsearch, query, 32 /* rank/(rank+1) */ ) AS rank 
FROM apod, to_tsquery('neutrino|(dark & matter)') query 

WHERE query @@ textsearch 

ORDER BY rank DESC 


LIMIT 10; 
title | rank 

EE E O E E A E N EEE E E E E T, bis Sos Sie spree N E E 
Neutrinos in the Sun | ©.756097569485493 
The Sudbury Neutrino Detector | ©.705882361190954 
A MACHO View of Galactic Dark Matter | ©.668123210574724 
Hot Gas and Dark Matter | 0.65655958650282 
The Virgo Cluster: Hot Plasma and Dark Matter | 0.656301290640973 
Rafting for Solar Neutrinos | ©.655172410958162 
NGC 4650A: Strange Galaxy and Dark Matter | ©.650072921219637 
Hot Gas and Dark Matter | 0©.617195790024749 
Ice Fishing for Cosmic Neutrinos | ©.615384618911517 
Weak Lensing Distorts the Universe | ©.450010798361481 


排序 花费 比较 多 ， 因为 它 需要 查找 每 个 匹配 文档 的 tsvector ， 这 与 IO 绑 定 ， 因此 慢 。 不 幸 
的 是 ， 它 几乎 是 不 可 能 避免 因 实际 的 查询 往往 导致 的 大 量 匹配 。 


12.3.4. 强调 结果 


为 显示 搜索 结果 ， 合 理 显 示 每 个 文档 的 一 部 分 以 及 查询 相关 性 。 通 常 ， 搜 索引 警 显 示 标 记 搜 
索 条 件 的 文档 片段 。 PostgreSQL 提 供 了 一 个 男 数 ts_headline 实现 此 功能 。 


ts_headline([ ~_config_~ ‘regconfig’, ] _document_ text, _query_ tsquery [, ~_options_~ 
a] 


ts_headline 接受 查询 文档 ， 并 从 突显 的 查询 条 件 的 文档 中 返回 一 个 摘录 。 配 置 用 来 解 
析 _config 指定 的 文档 ; MRAM _config ， 则 使 用 default_text_search_config 配置 





如 果 指 定 一 个 options. 字符 串 ， 它 必须 由 一 个 逗号 分 隔 的 一 个 或 多 
个 _option 、 =、_value 对 组 成 。 可 用 选项 是 : 





e StartSel , StopSel :该 字符 串 分 隔 文档 中 出 现 的 查询 词 ， 以 区 别 于 其 他 摘录 词 。 如 果 它 
们 含有 空格 或 逗号 ， 你 必须 用 双 引 号 字符 串 。 


e MaxWords , Minwords :这 些 数字 决定 最 长 和 最 短 的 标题 输出 。 


© Shortword : 长 度 或 更 短 的 词 在 标题 的 开始 和 结束 被 丢弃 。 三 个 默认 值 消 除了 常见 英 
语文 章 。 


e Highlightall :布尔 标志 ; WRA 真 ， 整 个 文档 将 作为 标题 ， 忽 略 了 前 面 的 三 个 参数 。 


e MaxFragments :要 显示 的 文本 摘录 或 片段 的 最 大 数量 。 默 认 值 需 选 择 非 片段 标题 的 生成 方 
法 。 一 个 大 于 需 的 值 选择 基于 片段 的 标题 生成 。 此 方法 查找 文本 片段 与 尽 可 能 多 的 查询 
词 并 在 查询 词 周围 延伸 这 些 片段 。 作为 查询 词 的 结果 接近 每 一 片段 中 间 ， 每 边 都 有 词 。 
每 个 片段 至 多 是 Maxwords ， 并 且 长 度 为 shortword 或 更 短 的 词 在 每 一 个 片段 开始 和 结 
REF. 如 果 不 是 所 有 的 查询 词 在 文档 中 找到 ， 则 文档 中 开头 的 Minwords 单 片 段 将 被 显 


o 
e FragmentDelimiter : 当 一 个 以 上 的 片段 显示 时 ， 通 过 字符 串 分 隔 这 些 片 段 。 


任何 未 声明 的 选项 接受 这 些 缺 省 : 


StartSel=<b>, StopSel=</b>, 
MaxWords=35, MinWords=15, ShortWord=3, paella Cis IS FALSE, 
MaxFragments=0, FragmentDelimiter=" 


比如 : 


SELECT ts_headline('english', 

"The most common type of search 
is to find all documents containing given query terms 
and return them in order of their similarity to the 
query.', 

to_tsquery('query & similarity')); 

ts_headline 

containing given <b>query</b> terms 
and return them in order of their <b>similarity</b> to the 
<b>query</b>. 


SELECT ts_headline('english', 

"The most common type of search 
is to find all documents containing given query terms 
and return them in order of their similarity to the 
query.', 

to_tsquery('query & similarity'), 

"StartSel = <, StopSel = >'); 

ts_headline 

containing given <query> terms 
and return them in order of their <similarity> to the 
<query>. 


ts_headline 使 用 原始 文档 ， 而 不 是 一 个 tsvector 摘要 ， 因 此 它 很 慢 ， 应 小 心 使 用 。 一 个 典 


$B 


型 的 错误 是 ， 当 只 显示 10 个 文档 时 ， 为 每 个 匹配 文档 调用 ts_headline 。SQL 子 查询 可 以 帮 
it, 这 是 一 个 例子 : 


SELECT id, ts_headline(body, q), rank 
FROM (SELECT id, body, q, ts_rank_cd(ti, q) AS rank 
FROM apod, to_tsquery('stars') q 
WHERE ti @@ q 
ORDER BY rank DESC 
LIMIT 10) AS foo; 


12.4. 附加 功能 


本 节 描 述 了 连接 文本 搜索 中 有 用 的 附加 功能 和 操作 符 。 


12.4.1. 操作 文档 


节 Section 12.3.1 显 示 了 原始 文本 文档 如 何 转换 成 tsvector fi. PostgreSQL 也 提供 用 于 操作 
已 经 在 tsvector 形式 中 的 文档 的 函数 和 操作 符 。 

tsvector || tsvector 

tsvector 连接 操作 符 返 回 一 个 连接 词 的 向 量 ， 以 及 作为 参数 给 定 的 2 个 向 量 的 位 置信 息 。 在 
连接 期 间 重新 获得 位 置 和 权重 标签 。 出 现在 右边 向 量 位 置 通 过 左边 向 量 提 到 的 最 大 位 置 相抵 
消 ， 因此 这 个 结果 几乎 等 同 于 2 个 原始 文档 字符 串 连 接 中 执行 to_tsvector 的 结果 。 (这 个 等 
价 是 不 准确 的 ， 因为 任何 从 左边 参数 中 删除 的 屏蔽 词 不 会 影响 结果 ， 然 而 ， 如 果 使 用 文本 连 
接 ， 它 们 影响 右边 参数 词 的 位 置 ) 。 

使 用 级 联 中 的 向 量 形式 而 不 是 在 应 用 to_tsvector 之 前 连接 文本 的 一 个 优势 是 ， 你 可 以 使 用 
不 同 的 配置 解析 文档 的 不 同 部 分 。 同 时 ， 由 于 setweight 酌 数 标记 所 有 相同 方式 给 定向 量 的 
词汇 ， 解析 文本 是 必要 的 ， 并 且 如 果 你 想 用 不 同 的 权重 标记 文档 不 同 部 分 ， 连 接 前 


做 setweight o 
setweight(``_vector_ tsvector , _weight_ "char" ) returns tsvector 


setweight 返回 一 个 输入 向 量 的 拷贝， 其 中 每 一 个 位 置 用 给 定 的 _weight_, A, B, C 或 者 
D 之 一 进行 标记 。 〈 5 是 缺 省 新 向 量 ， 因 此 不 显示 在 输出 上 。) 当 向 量 连接 时 ， 保 留 这 些 标 
Z, 允许 一 个 文档 的 不 同 部 分 的 词 通过 不 同 相关 本 数 加 权 。 

注意 权重 标签 适用 于 位 置 ， 不 是 词汇 。 如 果 输 入 向 量 已 经 被 剥夺 了 位 置 ， 则 setweight 不 做 
任何 事情 。 

length(**~_vector_ tsvector ) returns integer 


返回 存储 在 向 量 中 的 词 的 数量 。 


strip(°°_vector_ tsvector ) returns tsvector 


返回 一 个 向 量 ， 其 中 列 出 了 给 定向 量 的 同一 词 ， 但 它 缺 乏 任何 位 置 和 权重 信息 。 虽然 为 相关 
性 排序 返回 的 向 量 比 一 个 未 拆 分 向 量 用 处 少 ， 它 通常 会 小 得 多 。 


12.4.2. 义理 查询 


4 Section 12.3.2 显 示 了 原始 文本 查询 如 何 转换 成 tsquery i. PostgreSQL HEH T HAA 
操作 符 用 于 义理 已 存在 tsquery 形式 中 的 查询 


tsquery && tsquery 

返回 两 个 给 定 查询 的 与 组 合 。 

tsquery || tsquery 

返回 两 个 给 定 查询 的 或 组 合 。 

!! tsquery 

返回 给 定 查询 的 反面 GF) 。 
numnode(*~*_query_ tsquery ) returns Integer 


返回 在 一 个 tsquery 中 节点 的 数目 〈 词 加 操作 符 ) 。 决 定 query ”是否 有 意义 (返回 > 0) ， 
或 只 包含 屏蔽 词 OREO) ， 这 个 画 数 是 很 有 用 的 。 例 子 : 


SELECT numnode(plainto_tsquery('the any')); 
NOTICE: query contains only stopword(s) or doesn't contain lexeme(s), ignored 


numnode 


SELECT numnode('foo & bar'::tsquery); 
numnode 


querytree(``_query_  tsquery ) returns text 
些 只 包 


返回 可 用 于 搜索 索引 的 tsquery 部 分 。 此 函数 对 检测 未 索引 查询 是 有 帮助 的 ， 例 如 那些 只 
Shai KBE AI. HEAD: 


SELECT querytree(to_tsquery('!defined')); 
querytree 


12.4.2.1. 查询 重生 


PAGE ts_rewrite 搜索 一 个 特定 的 目标 查询 事件 tsquery ， 和 蔡 换 每 个 替代 子 查询 。 实际 上 
这 个 操作 是 一 个 子 字 符 串 替换 的 tsquery -特定 版 本 。 目 标 和 替换 组 合 可 以 被 认为 是 一 个 查询 
重 写 规则 。 一 组 这 样 的 重 写 规 则 可 以 是 一 个 强大 的 搜索 帮助 。 例 如 ， 你 可 以 使 用 同义词 扩大 
搜索 (例如 ， new york, big apple, nyc, gotham ) 或 缩小 搜索 一 些 热点 问题 的 直接 用 户 。 
在 这 些 特 性 和 同义词 词典 之 间 功 能 上 有 一 些 重合 〈 节 Section 12.6.4) 。 然 而 ， 你 可 以 在 不 重 
建 索 引 情 况 下 即时 修改 重 写 规 则 ， 而 更 新 词 库 需要 重建 索引 才能 有 效 。 


ts_rewrite (°°_query_ tsquery , _target_ tsquery , _substitute_ tsquery ) returns 
tsquery 


ts_rewrite 的 这 种 形式 只 适用 于 一 个 单一 的 重 写 规 则 : 无 论 出 现在 _query_ 的 什么 地 
方 ， target 通过 substitute_ 替换 。 比如 : 





SELECT ts_rewrite('a & b'::tsquery, 'a'::tsquery, 'c'::tsquery); 
ts_rewrite 


ts_rewrite (°°_query_ tsquery , _select_ text ) returns tsquery 


ts_rewrite 的 这 种 形式 接受 起 始 _ 专 询 FISQL select. 命令 ， 这 是 作为 一 个 文本 字符 串 。 
_select_ 必须 产生 两 列 tsquery 类 型 。 _select_ 结果 的 每 一 行 ， 出 现 的 第 一 个 字段 的 值 
(目标 ) 都 被 当前 的 query 值 中 的 第 二 个 字段 值 (BK). boo: 


注意 ， 当 多 个 重 宇 规 则 适用 于 这 种 方式 时 ， 应 用 的 顺序 非常 重要 ; 因此 在 实践 中 你 将 需要 源 
查询 为 ORDER BY 一 些 排序 关键 字 。 


让 我 们 考虑 下 现实 生活 中 天 文 的 例子 。 我 们 将 使 用 表 驱 动 的 重 写 规 则 扩大 查询 supernovae 


CREATE TABLE aliases (t tsquery primary key, s tsquery); 
INSERT INTO aliases VALUES(to_tsquery('supernovae'), to_tsquery('supernovae|sn')); 


SELECT ts_rewrite(to_tsquery('supernovae & crab'), 'SELECT * FROM aliases'); 
ts_rewrite 


‘crab' & ( 'supernova' | 'sn' ) 


我 们 可 以 通过 更 新 表 改 变 重 写 规 则 : 


UPDATE aliases 
SET s = to_tsquery('supernovae|sn & !nebulae' ) 
WHERE t = to_tsquery('supernovae'); 


SELECT ts_rewrite(to_tsquery('supernovae & crab'), 'SELECT * FROM aliases'); 
ts_rewrite 


‘crab' & ( 'supernova' | 'sn' & !'nebula' ) 


当 有 许多 的 重 写 规则 的 时 候 ， 重 写 比 较 缓 慢 ， 因 为 它 检查 可 能 匹配 的 每 一 个 规则 。 为 过 滤 掉 
明显 非 候选 规则 ， 我 们 可 以 使 用 tsquery 类 型 的 包含 操作 符 。 在 下 面 的 例子 中 ， 我 们 只 选择 
那些 可 能 与 原始 查询 匹配 的 规则 : 


SELECT ts_rewrite('a & b'::tsquery, 
"SELECT t,s FROM aliases WHERE ''a & b''::tsquery @> t'); 
ts_rewrite 


12.4.3. 目 动 更 新 的 触发 器 


当 使 用 单独 的 列 存 储 文档 的 tsvector 形式 ， 当 文档 内 容 列 变化 时 ， 有 必要 建立 一 个 触发 器 更 
新 tsvector 列 。 两 个 内 置 的 触发 器 功能 可 用 于 此 ， 或 者 你 可 以 自 定义 触发 器 。 





tsvector_update_trigger(_tsvector_column_name_, _config_name_, _text_column_name_ [, ... 
tsvector_update_trigger_column(_tsvector_column_name_, _config_column_name_, _text_colum 


‘| _ 











这 些 触发 器 吏 数 自动 计算 来 自 一 个 或 多 个 文本 字段 的 tsvector JI, {E CREATE TRIGGER OTS 
定 的 参数 控制 下 。 使 用 的 例子 是 : 


CREATE TABLE messages ( 


title text, 
body text, 
tsv tsvector 


); 

CREATE TRIGGER tsvectorupdate BEFORE INSERT OR UPDATE 

ON messages FOR EACH ROW EXECUTE PROCEDURE 
tsvector_update_trigger(tsv, 'pg_catalog.english', title, body); 
INSERT INTO messages VALUES('title here', 'the body text is here'); 


SELECT * FROM messages; 
title | body | tsv 


title here | the body text is here | 'bodi':4 'text':5 'titl':1 
SELECT title, body FROM messages WHERE tsv @@ to_tsquery('title & body'); 
title | body 


a Ren E P pO Sy ge E 
title here | the body text is here 


创建 触发 器 ， 在 title KA body 中 的 任何 改变 都 会 自动 反映 到 tsv 中 ， 而 不 必 担 心 它 的 应 
用 。 


第 一 个 触发 器 参数 必须 是 被 更 新 的 tsvector 字段 名 。 第 二 个 参数 指定 要 进行 转换 的 文本 搜索 
配置 。 为 tsvector_update_trigger ， 配 置 的 名 称 仅 仅 是 作为 第 二 个 触发 器 参数 。 它 必须 是 如 
上 所 示 的 模式 匹配 ， 因此 触发 器 的 行为 在 search_path 中 不 会 改变 。 

为 tsvector_update_trigger_column , 第 二 个 触发 器 参数 是 另 一 个 表 列 的 名 称 ， 它 的 类 型 必须 
是 regconfig 。 这 人 允许 每 行 选择 进行 配置 。 剩余 的 参数 (s) 是 文本 列 的 名 称 (键入 text, 

varchar 或 者 char ) 。 这 些 将 在 给 定 的 顺序 中 提供 文档 。 空 值 将 被 忽略 (但 其 他 列 仍 将 被 
索引 ) 。 

这 些 内 置 触发 器 的 限制 是 它们 一 致 对 待 所 有 输入 列 。 为 了 人 处理 不 同 列 一 比如 ， 为 权重 不 同 主 
体 的 标题 一 它 有 必要 编写 一 个 自 定义 触发 器 。 这 是 使 用 PL/pgSQL 作为 触发 器 语言 的 一 个 例 
Fi 


CREATE FUNCTION messages_trigger() RETURNS trigger AS $$ 
begin 
new.tsv := 
setweight(to_tsvector('pg_catalog.english', coalesce(new.title,'')), 'A') || 
setweight(to_tsvector('pg_catalog.english', coalesce(new.body,'')), 'D'); 
return new; 
end 
$$ LANGUAGE plpgsql; 


CREATE TRIGGER tsvectorupdate BEFORE INSERT OR UPDATE 
ON messages FOR EACH ROW EXECUTE PROCEDURE messages_trigger(); 


记 住 当 在 触发 器 内 部 创造 tsvector 值 时 ， 明 确 指 定 配置 的 名 称 是 很 重要 的 ， 所 以 ， 该 列 的 内 
容 将 通过 改变 default_text_search_config 而 不 会 oi nee 样 做 可 能 会 导致 诸如 重 
载 转 储 之 后 搜索 结果 改变 的 问题 。 


12.4.4. 收集 文献 统计 


PAR ts_stat 可 用 于 检查 你 的 配置 和 查找 屏 般 候选 词 。 


ts_stat(_sqlquery_ text, [ ~_weights_~ ‘text’, ] 
OUT _word_ text, OUT _ndoc_ integer, 
OUT _nentry_ integer) returns setof record 


_sqlquery_ 是 一 个 包含 返回 单独 tsvector 列 的 SQL 查 A is ts_stat 执行 查询 并 返 
回 包含 tsvector 数据 的 各 个 不 同 的 语义 GA) 的 统计 。 返 回 的 列 : 


e word. text 一 一 个 词 的 值 
e _ndoc integer 一 这 个 词 出 现 的 文档 编号 〈 tsvector s) 
e _nentry integer 一 这 个 词 出 现 的 总 数 

如 果 提 供 _weights”， 仅 仅 计算 这 些 权 重 之 一 。 

例如 ， 在 一 个 文档 集合 中 查找 十 个 最 常用 的 单词 


SELECT * FROM ts_stat('SELECT vector FROM apod') 
ORDER BY nentry DESC, ndoc DESC, word 
LIMIT 10; 


同样 的 ， 但 是 只 计算 权重 weight A 或 者 B 的 单词 


SELECT * FROM ts_stat('SELECT vector FROM apod', 'ab') 
ORDER BY nentry DESC, ndoc DESC, word 
LIMIT 10; 


12.5. 解析 器 


文本 搜索 分 析 器 负责 分 离 原 文档 文本 为 标记 并 且 标 识 每 个 记号 的 类 型 ， 这 里 可 能 的 类 型 集 由 
解析 器 本 身 定 义 。 注意 一 个 解析 器 并 不 修改 文本 一 它 只 是 确定 合理 的 单词 边界 。 因 为 这 个 限 
制 范围 ， 为 特定 应 用 定制 的 分 析 器 比 自 定义 字典 需要 的 更 少 。 目 前 PostgreSQL 提 供 了 只 有 一 
个 内 置 的 解析 器 ， 这 已 被 用 于 一 个 广泛 的 应用 中 。 

内 置 分 析 器 命名 pg_catalog.default 。 它 识别 23 种 标记 类 型 ， 显 示 在 Table 12-1 中 。 


Table 12-1. 缺 省 分 析 器 的 标记 类 型 


Alias Description Example 


asciiword Word, all ASCII letters elephant 
word Word, all letters mafiana 
numword Word, letters and digits betal 
asciihword Hyphenated word, all up-to-date 
ASCII 
hword Hyphenated word, all lógico-matemática 
letters 
numhword Hyphenated word, letters postgresql-beta1 
and digits 
hword_asciipart Hyphenated word part, postgresql in the context 
= all ASCII postgresql-beta1 
Hyphenated word part, lógico Or matemática in the context 
hword_part 
m all letters lógico-matemática 
T Hyphenated word part, beta1 in the context 
7 letters and digits postgresql-betai 
email Email address foo@example.com 
protocol Protocol head http:// 
url URL example.com/stuff/index. html 
host Host example.com 
UAR URL path /stuff/index.html , in the context of 
a URL 
À f /usr/local/foo.txt , if not within a 
file File or path name 
URL 
sfloat Scientific notation -1.234e56 
float Decimal notation -1.234 
int Signed integer -1234 
uint Unsigned integer 1234 
version Version number 8.3.0 
tag XML tag &lt;a href="dictionaries.html"&gt; 
entity XML entity & 
TN Space symbols (any whitespace or punctuation not 


otherwise recognized) 


Note: 注意 : 一 个 "字母 "的 语法 分 析 器 的 概念 是 由 数据 库 的 区 域 设 置 决定 的 ， 特 别 
是 lc_ctype 。 只 包含 基本 ASCII 字 母 的 词 作为 一 个 单独 的 标记 类 型 被 报告 ， 因 为 区 分 他 
们 有 时 候 是 有 用 的 。 大 多 数 欧洲 语言 ， 标 记 类 型 word 和 asciiword 应 该 一 视 同仁 。 
email 不 支持 由 RFC 5322 定 义 的 所 有 有 效 的 电子 邮件 字符 。 上 有 具体 来 说 ， 唯一 的 非 字 母 
数字 字符 支持 电子 邮件 用 户 名 有 句号 ， 破 折 号 和 下 划 线 。 
对 于 分 析 器 从 文本 的 同一 块 产生 重 受 的 标记 是 可 能 的 。 作 为 一 个 例子 ， 一 个 连 字符 的 单词 将 
作为 整个 单词 和 每 个 组 件 被 报道 : 


SELECT alias, description, token FROM ts_debug('foo-bar-beta1'); 


alias | description | token 
Sepa eee one arate a ar 有 
numhword | Hyphenated word, letters and digits | foo-bar-betat 
hword_asciipart | Hyphenated word part, all ASCII | foo 
blank | Space symbols | - 
hword_asciipart | Hyphenated word part, all ASCII | bar 
blank | Space symbols | - 
hword_numpart | Hyphenated word part, letters and digits | betal 


这 种 行为 是 可 取 的 ， 因 为 它 允 许 为 整 个 复合 词 和 组 件 进 行 搜索 。 这 里 是 另 一 个 很 好 的 例子 : 


SELECT alias, description, token FROM ts_debug('http://example.com/stuff/index.html'); 


/stuff/index. html 


alias | description | token 
ee A OA ay eee re pat a cba E E pe ey ee ne a po ee ey ey ee 
protocol | Protocol head | http:// 
url | URL | example.com/stuff/index. html 
host | Host | example.com 
| 


url_path | URL path 


12.6. 词典 


词典 用 于 删除 那些 不 在 搜索 范围 内 的 词 〈 屏 蔽 词 ) ， 并 且 为 了 规范 化 ， 将 匹配 同一 个 词 的 不 
同形 式 。 一 个 成 功 的 规范 化 的 词 叫 词 位 。 除 了 提高 检索 质量 外 ， 屏 蔽 词 的 规范 化 和 删除 可 以 
减少 文档 tsvector 形式 的 大 小 ， 从 而 提高 性 能 。 规 范 化 并 不 总 是 有 语言 学 意义 ， 通 常 取决 于 
应 用 程序 的 环境 。 


一 些 规范 化 的 例子 : 
。 语言 的 -lspell 词 典 尽量 减少 输入 字 的 正规 形式 ; 词 干 词典 去 掉 词 尾 
e URL 位 置 可 以 使 等 效 URL 匹 配 被 规范 化 : 
o http:/www.pgsql.ru/db/mw/index.html 
o http:/www.pgsql.ru/db/mw/ 
o http:/www.pgsql.ru/db/../db/mw/index.html 


。 颜色 名 称 可 以 由 他 们 的 十 六 进 制 值 蔡 换 ， 上 比 


如 : red, green, blue, magenta -&gt; FF0000, OOFFOO, OOOOFF, FFOOFF 


。 如 果 索 引 数字 ， 我 们 可 以 删除 一 些小 数位 数 ， 减 少 可 能 数字 的 范围 ， 例 如 如 果 保 留 小 数 
点 后 两 位 小 数 ， 则 3.14_159265359，3.14_15926 将 恰 一 化 为 一 样 的 _3.14 


字典 是 一 个 程序 ， 它 接受 标记 作为 输入 和 返回 : 

。 词 条 数组 如 果 输 入 标记 是 已 知 的 词典 (注意 ， 一 个 标记 可 以 产生 一 个 以 上 的 词 ) 

e 用 TSL_FILTER 标志 设置 的 单词 ， 与 被 传递 到 随后 的 词典 的 新 的 标记 代 蔡 原来 的 〈 称 这 是 
过 滤 词 典 ) 

。 如 果 词典 认为 标记 是 空 数 组 ， 但 它 是 一 个 屏蔽 词 。 

。 如 果 词 典 不 能 识别 输入 标记 ， 则 为 ® 

PostgreSQL 提 供 了 多 种 语言 的 预定 义 字典 。 也 有 几 个 预定 义 的 模板 ， 可 用 于 创建 自 定 义 参 数 


的 新 词典 。 每 个 预定 义 的 字典 模板 描述 如 下 。 如 果 没 有 现成 的 模板 是 合适 的 ， 它 可 以 创建 一 
个 新 的 ; 参见 PostgreSQL 发 布 的 contribs 部 分 例子 


文本 搜索 配置 将 解析 器 和 处 理解 析 器 输出 标记 绑 定 在 一 起 。 为 了 每 个 标记 类 型 ， 返回 解析 
器 ， 单 独 的 词典 列表 通过 配置 指定 。 当 标记 类 型 是 由 解析 器 发 现时 ， 列表 中 的 每 个 字典 依次 
查阅 ， 直 到 一 些 词典 作为 一 个 已 知 的 单词 识别 它 。 如 果 它 被 确定 为 一 个 屏蔽 词 ， 或 者 如 果 没 
有 词典 识别 标记 ， 它 将 被 丢弃 ， 并 且 没 有 索引 或 搜索 。 通 常 ， 返 回 一 个 非 - 空 输出 的 第 一 个 
词典 将 决定 结果 ， 并 且 不 查阅 任何 剩余 的 词典 ; 但 过 滤 词 典 可 以 替换 带 有 修饰 词 的 给 定 词 ， 
然后 被 传递 给 后 继 词 典 。 


配置 一 个 字典 列表 的 一 般 规则 是 放 在 第 一 个 最 窄 的， 最 具体 的 词典 中 ， 然 后 是 更 一 般 的 词 
典 ， 整理 一 个 非常 普通 的 词典 ， 像 Snowball 词 干 或 simple 可 以 识别 一 切 。 例 如 ， 一 个 天 文 
学 的 特定 搜索 (astroen ME) 可 以 将 标记 类 型 asciiword (ASCII 字 ) 绑 定 到 天 文 术语 的 
同义词 词典 ， 一 般 英 语词 典 和 Snowball 英文 词 干 分 析 器 : 


ALTER TEXT SEARCH CONFIGURATION astro_en 
ADD MAPPING FOR asciiword WITH astrosyn, english_ispell, english_stem; 


过 滤 词 典 可 以 放置 在 列表 中 的 任何 地 方 ， 除 了 在 结束 的 地 方 会 是 无 用 的 。 过 滤 词 典 部 分 规范 
化 词 以 简化 后 继 词 典 的 任务 是 非常 有 用 的 。 例如 ， 过 滤 词 典 可 以 用 来 从 重音 字母 中 删除 重 
音 ， 按 照 unaccent 模 块 执行 。 


12.6.1. 屏蔽 词 


屏蔽 词 是 很 常见 的 词 ， 出 现在 几乎 每 一 个 文档 中 ， 并 且 没 有 区 分 值 。 因 此 ， 他 们 可 以 在 全 文 
搜索 的 环境 中 被 忽视 的 。 例如 ， 每 个 英文 文本 包含 像 a 和 the 的 单词 ， 因 此 它们 在 索引 中 
FREA. FAT, BRAGA RATE tsvector 中 的 位 置 ， 这 反 过 来 也 影响 相关 度 : 


SELECT to_tsvector('english','in the list of stop words'); 
to_tsvector 


‘list':3 'stop':5 'word':6 


丢失 位 置 1,2,4 是 因为 屏蔽 词 。 带 有 和 没有 屏蔽 词 的 文档 排序 计算 是 完全 不 同 的 : 


SELECT ts_rank_cd (to_tsvector('english','in the list of stop words'), to_tsquery('list & 
ts_rank_cd 


SELECT ts_rank_cd (to_tsvector('english','list stop words'), to_tsquery('list & stop')); 
ts_rank_cd 





ANA QE aA, CEREA ARER. GM, ispell 词典 首先 规范 词 ， 然 后 查看 屏蔽 词 
列表 ， 而 snowball 词 干 首先 检查 屏蔽 词 列 表 。 这 个 不 同 操作 的 原因 是 为 了 减少 噪音 。 


12.6.2. Simple 词典 


simple 字典 模板 通过 转换 输入 标记 为 小 写字 母 进行 ， 并 且 屏 敬 词 文件 前 检查 它 。 如 果 在 文档 
中 找到 并 返回 空 数 组 ， 则 丢弃 这 个 标记 。 如 果 没 有 ， 单 词 的 小 写字 母 形式 作为 轨 一 化 的 词 返 
E. 另外 ， 词 典 可 以 为 报告 未 识别 的 非 屏 菩 词 进行 配置 ， 人 允许 将 它们 传递 到 列表 中 的 后 继 词 
典 中 。 


这 有 使 用 simple 模板 的 词典 定义 的 例子 : 


CREATE TEXT SEARCH DICTIONARY public.simple_dict ( 
TEMPLATE = pg_catalog.simple, 
STOPWORDS = english 


NF 


在 这 里 ， english EMA MEEA MENSA 

为 $SHAREDIR/tsearch_data/english.stop , 这 里 的 $sHAREDIR 是 PostgreSQL 安 装 的 共享 数据 
目录 ， 经 常 使 用 /usr/local/share/postgresql (如 果 你 不 确定 ， 则 使 

用 pg_config --sharedir 来 决定 ) o 文档 格式 是 一 个 简 单 的 单词 列表 ， 每 行 一 个 。 忽略 空白 行 
和 空格 ， 并 且 大 写字 母 转 换 成 小 写字 母 ， 但 对 文档 内 容 没 有 其 他 的 处 理 方式 。 


现在 我 们 可 以 测试 我 们 的 词典 : 


SELECT ts_lexize('public.simple_dict', 'YeS'); 
ts_lexize 


SELECT ts_lexize('public.simple_dict', 'The'); 
ts_lexize 


如 果 没 在 屏蔽 词 文件 中 找到 ， 我 们 也 可 以 选择 返回 NuLL ， 而 不 是 小 写字 母 单 词 。 这 种 行为 
是 通过 设置 字典 的 Accept 参数 为 false 选择 的 。 继 续 例 子 : 


ALTER TEXT SEARCH DICTIONARY public.simple_dict ( Accept = false ); 


SELECT ts_lexize('public.simple_dict', 'YeS'); 
ts_lexize 


SELECT ts_lexize('public.simple_dict', 'The'); 
ts_lexize 


随 着 缺 省 设置 Accept = true, CHE simple 词典 放 在 词典 列表 末尾 的 时 候 是 很 有 用 的 ， 
递 


为 它 不 会 传递 任何 标记 给 后 继 词 典 。 相 反 ， 当 至 少 有 一 个 后 继 词典 时 ， accept = false 是 唯 
一 有 用 的 。 
Caution 


词典 大 部 分 类 型 依赖 于 配置 文档 ， 如 屏蔽 词 文件 。 这 些 文件 必须 存储 在 UTF-8 编 码 中 。 当 
他 们 读 到 服务 器 中 ， 如 果 是 不 同 的 ， 他 们 将 被 转化 为 实际 的 数据 库 编码 。 


Caution 


通常 情况 下 ， 当 它 在 会 话 中 第 一 次 使 用 时 ， 数 据 库 会 话 将 只 读 一 次 词典 的 配置 文档 ， 如 
果 你 修改 一 个 配置 文档 ， 想 强制 现 有 会 话 获取 新 的 内 容 ， 则 在 词典 中 使 用 命 

43 ALTER TEXT SEARCH DICTIONARY 。 这 是 一 个 "虚拟 "的 更 新 ， 实 际 上 并 没有 改变 任何 参数 
值 。 


12.6.3. 同义词 词典 


这 个 字典 模板 用 于 创建 替代 词 和 同义词 的 词典 。 不 支持 短语 〈 使 用 同义词 库 模 板 (Section 
12.6.4) 。 一 个 同义词 词典 可 以 用 来 克服 语言 上 的 问题 ， 例 如 ， 防 止 英语 词 干 词典 使 单 

词 "Paris" 变 成 "pari"。 这 足以 在 同义词 词典 中 有 paris paris 行 并 且 放 在 english_stem 词典 之 
前 。 上 比如 : 


SELECT * FROM ts_debug('english', 'Paris'); 

alias | description | token | dictionaries | dictionary | lexemes 
dioene danan 0 
asciiword | Word, all ASCII | Paris | {english stem} | english_stem | {pari} 


CREATE TEXT SEARCH DICTIONARY my_synonym ( 
TEMPLATE = synonym, 
SYNONYMS = my_synonyms 

); 


ALTER TEXT SEARCH CONFIGURATION english 
ALTER MAPPING FOR asciiword 
WITH my_synonym, english_stem; 


SELECT * FROM ts_debug('english', 'Paris'); 
alias | description | token | dictionaries | dictionary | lexemes 


etaeseseces 和 
asciiword | Word, all ASCII | Paris | {my_synonym,english_stem} | my_synonym | {paris} 


SS SSS SSS Se 
synonym 模版 要 求 的 唯一 的 参数 是 syNoNYMs ， 这 是 它 的 配置 文件 的 基础 名 称 一 上 面 例 子 


中 my_synonyms o 文件 的 全 名 为 $SHAREDIR/tsearch_data/my_synonyms.syn ( $SHAREDIR 是 
PostgreSQL 安 装 的 共享 数据 目录 ) 。 文件 格式 是 每 一 行 的 每 个 字 被 取代 ， 带 有 这 个 词 的 同 义 
词 ， 用 空格 分 隔 。 忽 略 空白 行 和 空格 。 


synonym 模版 也 有 一 个 可 选 的 参数 CaseSensitive , 缺 省 是 false o 
当 casesensitive 是 false 时 ， 同义词 文件 中 的 词 转换 成 小 写字 母 ， 正 如 输入 标记 。 比较 而 
Z, GÆ true 时 ， 词 语 和 标记 不 转换 成 小 写字 母 


BS (+) 可 以 被 放置 在 配置 文件 中 的 同义词 结尾 。 这 表明 ， 同 义 词 是 一 个 前 级 。 当 

在 to_tsvector() 中 使 用 记录 时 ， 忽略 星 号 。 但 当 它 被 用 在 to_tsquery() 中 时 ， 结 将 是 带 
前 级 匹配 标记 的 查询 记录 (参见 节 Section 12.3.2) 。 例 如 ， 假 设 我 们 

在 $SHAREDIR/tsearch_data/synonym_sample.syn 中 有 这 些 记 录 。 


postgres pgsql 
postgresql pgsql 
postgre pgsql 
gogle googl 
indices index* 


然后 我 们 将 得 到 这 些 结果 : 


mydb=# CREATE TEXT SEARCH DICTIONARY syn (template=synonym, synonyms='synonym_sample' ' ) ， 
mydb=# SELECT ts_lexize('syn','indices'); 

ts_lexize 

{index} 

(1 row) 


mydb=# CREATE TEXT SEARCH CONFIGURATION tst (copy=simple) ; 
mydb=# ALTER TEXT SEARCH CONFIGURATION tst ALTER MAPPING FOR asciiword WITH syn; 
mydb=# SELECT to_tsvector('tst','indices'); 

to_tsvector 


'index':1 
(1 row) 
mydb=# SELECT to_tsquery('tst','indices'); 
to_tsquery 
"index':* 
(1 row) 


mydb=# SELECT 'indexes are very useful'::tsvector; 
tsvector 


‘are' ‘indexes! 'useful' 'very' 
(1 row) 


mydb=# SELECT 'indexes are very useful'::tsvector @@ to_tsquery('tst','indices'); 
?column? 


12.6.4. 同义词 词典 库 


同义词 词 库 (有 时 简称 TZ) 是 一 个 单词 的 组 合 ， 包 括 单词 和 短语 的 关系 信息 ， 上 比如， 更 广泛 
术语 (BT), BÆRE (NT) ， 首 选 术语 ， 非 优先 术语 ， 相 关 术 语 等 。 


基本 上 同义词 词 库 通过 一 个 首选 的 术语 替换 所 有 非 优先 术语 ， 另 外 ， 也 保留 素 引 的 原 术 语 。 
同义词 词典 PostgreSQL 的 当前 实现 是 带 有 附加 短语 支持 的 同义词 词典 的 扩展 。 同 义 词 词典 需 
要 下 列 格式 的 配置 文件 : 


# this is a comment 
sample word(s) : indexed word(s) 
more sample word(s) : more indexed word(s) 


冒号 (:) 符号 作为 短语 和 其 蔡 代 物 之 间 的 分 隔 符 。 


同义词 词典 检查 短语 匹配 之 前 使 用 一 个 子 词典 (这 是 在 字典 的 配置 中 指定 ) 规范 输入 文本 。 
它 选 择 一 个 子 词典 是 可 能 的 。 如 果子 词典 无 法 识别 单词 ， 报 告 一 个 错误 。 在 这 种 情况 下 ， 你 
应 该 删除 这 个 词 或 训练 子 词典 。 你 可 以 在 一 个 索引 字 跳 过 应 用 子 词典 的 开头 放 一 个 星 号 

(* ) ， 但 是 所 有 简单 的 词 必须 是 子 词典 已 知 的 。 

如 果 有 多 个 短语 匹配 输入 ， 同 义 词 词典 选择 最 长 的 匹配 。 并 且 使 用 最 后 一 个 定义 分 离 关 系 。 
通过 子 词 典 识 别 的 具体 屏 敬 词 不 能 被 指定 ; 而 使 用 ? 标记 任何 屏 敬 词 出 现 的 位 置 。 例如 ， 假 
设 a 和 the 是 依据 子 词典 的 屏蔽 词 : 


? one ? two : Swsw 


匹配 a one the two 和 the one a two ; 两 者 都 会 被 swsw BK. 


由 于 同义词 词典 有 能 力 识别 短语 ， 它 必须 记 住 其 状态 并 且 和 与 分 析 器 交互 。 同 义 词 词典 使 用 这 
些 任务 检查 它 是 否 应 该 处 理 下 一 个 词 ， 或 停止 积累 。 同 义 词 词典 必须 小 心 配 置 。 例 如 ， 如 果 
字典 词 库 分 配 只 义理 asciiword 标记 ， 那 么 像 one 7 的 同义词 词典 定义 将 不 工作 ， 因为 标记 
类 型 uint 不 分 配给 同义词 词典 。 

Caution 


索引 中 使 用 词典 ， 同 义 词 词典 的 任何 参数 变化 都 需要 重新 索引 。 对 于 大 多 数 其 他 词典 类 
型 ， 小 的 变化 ， 比 如 添加 或 去 除 屏 般 词 不 强迫 重新 索引 。 

12.6.4.1. 同义词 词典 配置 

使 用 thesaurus 模板 定义 一 个 新 的 同义词 词 库 。 比 如 : 


CREATE TEXT SEARCH DICTIONARY thesaurus_simple ( 
TEMPLATE = thesaurus, 
DictFile = mythesaurus, 
Dictionary = pg_catalog.english_stem 

); 

这 里 : 
e thesaurus_simple 是 新 词典 的 名 称 。 
e mythesaurus 是 同义词 配置 文件 的 基础 名 称 。 (全 名 


为 $SHAREDIR/tsearch_data/mythesaurus.ths ， 这 里 $SHAREDIR 是 安装 的 共享 数据 目录 ) 


e pg_catalog.english_stem 是 用 于 词 规范 化 的 子 词典 (这 的 Snowball 英 文 词 干 ) 。 JER, 
子 词典 将 有 自己 的 配置 (例如 ， 屏 敬 词 ) ， 不 显示 在 这 里 。 


现在 它 在 配置 中 可 能 将 同义词 词典 thesaurus_simple 绑 定 到 所 需 的 标记 类 型 中 ， 例 如 : 


ALTER TEXT SEARCH CONFIGURATION russian 
ALTER MAPPING FOR asciiword, asciihword, hword_asciipart 
WITH thesaurus_simple; 


12.6.4.2. 同义词 词典 例子 
考虑 一 个 简单 的 天 文 词典 thesaurus_astro ， 其 中 包含 了 一 些 天 文 组 合 词 : 


Supernovae Stars : Sn 
crab nebulae : crab 


下 面 我 们 创建 一 个 词典 并 且 绑 定 标记 类 型 的 一 些 天 文 词 库 和 英文 词 干 分 析 器 : 


CREATE TEXT SEARCH DICTIONARY thesaurus_astro ( 
TEMPLATE = thesaurus, 
DictFile = thesaurus_astro, 
Dictionary = english_stem 


ye 


ALTER TEXT SEARCH CONFIGURATION russian 
ALTER MAPPING FOR asciiword, asciihword, hword_asciipart 
WITH thesaurus_astro, english_stem; 


现在 我 们 可 以 看 到 它 是 如 何 工作 的 。 ts_lexize 对 测试 一 个 词 库 没 有 很 大 帮助 ， 因 为 它 把 输 
入 作为 一 个 标记 。 相反 ， 我 们 可 以 使 用 plainto_tsquery 和 to_tsvector ， 将 它们 的 输入 字符 
串 分 离 成 多 个 标记 : 


SELECT plainto_tsquery('supernova star'); 
plainto_tsquery 


SELECT to_tsvector('supernova star'); 
to_tsvector 


原则 上 ， 如 果 你 引用 参数 ， 可 以 使 用 to_tsquery : 


SELECT to_tsquery('''supernova star'''); 
to_tsquery 


注意 supernova star 与 supernovae stars 在 thesaurus_astro 中 匹配 ， 因 为 我 们 在 词典 的 定义 
中 指定 了 english_stem 词 干 分 析 器 。 词 干 分 析 器 删除 。 Ms. 


为 了 索引 原 句 以 及 蔡 代词 ， 只 是 将 它 包 括 在 定义 的 右边 部 分 : 


supernovae stars : sn supernovae stars 


SELECT plainto_tsquery('supernova star'); 
plainto_tsquery 


'sn' & 'supernova' & 'star' 


12.6.5. lspell 词 典 


lspell 词 典 模版 支持 形态 学 的 词典 ， 它 可 以 将 一 个 单词 的 许多 不 同 的 语言 形式 标准 化 为 一 个 
词 。 例如 ， 英 语 lspell 词 典 可 以 匹配 所 有 词尾 变化 和 搜索 词 bank 的 组 合 ， 例如 ， banking , 
banked ，banks ，banks' 和 bank's 。 


标准 的 PostgreSQL 发 布 不 包括 任何 lspell 配 置 文件 。 大 量 的 语言 字典 可 以 从 lspell 获 得 。 A 
时 ， 一 MySpell(OO < 2.0.1) 和 Hunspell(OO >= 2.0.2) 支 持 一 些 更 现代 的 词典 文件 格式 。 大 
的 词典 列表 在 OpenOffice Wiki 中 可 用 。 


使 用 内 置 的 ispell 模板 创建 lspell 词典 ， 并 指定 几 个 参数 : 


CREATE TEXT SEARCH DICTIONARY english_ispell ( 
TEMPLATE = ispell, 
DictFile = english, 
AffFile = english, 
StopWords = english 
); 


这 里 ， pictFile ，AffFile 和 stopwords 指定 词典 基础 的 名 字 ， 词 弘 ， 和 屏蔽 词 文 件 。 屏蔽 
词 文件 具有 和 上 面 解释 的 simple 词典 类 型 相同 的 格式 。 其 它 文件 的 格式 不 在 这 里 指定 ， 但 可 
以 从 上 面 提 到 的 网 站 获取 。 


Ispell 词 典 通常 识别 有 限 的 一 组 词 ， 所 以 他 们 应 该 遵循 另 一 个 更 广泛 的 词典 ; 例如 ， 一 个 
Snowball 词 典 ， 它 可 以 识别 一 切 。 


lspell 词 典 支持 分 裂 复合 词 ; 一 个 有 用 的 功能 。 请 注意 ， 词缀 文件 应 使 
FA compound words controlled 语句 指定 一 个 特殊 标记 ， 标记 可 以 参与 复合 信息 的 词典 单词 : 


compoundwords controlled z 


这 有 一 些 Norwegian 语 言 的 例子 : 


SELECT ts_lexize('norwegian_ispell', 'overbuljongterningpakkmesterassistent'); 
{over, buljong, terning, pakk,mester, assistent} 

SELECT ts_lexize('norwegian_ispell', 'sjokoladefabrikk'); 
{sjokoladefabrikk, sjokolade, fabrikk} 


Note: 注意 : MySpell 不 支持 复合 词 。Hunspell 对 复合 词 有 复 末 支持 。 目前 ， 
PostgreSQL 只 实现 了 Hunspell 的 基本 复合 词 操作 。 





12.6.6. Snowball; #4 


Snowball 词 典 模板 是 基于 Martin Porter 的 项 目 ， 他 是 英语 语言 的 著名 的 Porter 的 词 干 提取 算法 
的 发 明 者 。 现在 Snowball 提 供 了 许多 语言 的 词 干 提取 算法 (更 多 信息 请 见 Snowball site) 。 
每 个 算法 都 知道 如 何 改 变 词 到 基础 ， 或 词根 ， 或 其 语言 拼写 的 常见 变异 形式 。 一 个 Snowball 
词典 需要 language 参数 标识 要 使 用 的 词 干 ， 并 且 可 以 指定 一 个 删除 词 的 列表 的 stopword 文 
件 名 。 (PostgreSQL 的 标准 的 屏蔽 词 列 表 也 由 Snowball 项 目 提供 ) 例如 ， 有 一 个 等 价 的 内 置 
定义 。 
CREATE TEXT SEARCH DICTIONARY english_stem ( 
TEMPLATE = snowball, 
Language = english, 


StopWords = english 
); 


FAOINEAS o 


一 个 Snowball 词 典 可 以 识别 一 切 ， 是 否 能 够 简化 字 ， 所 以 它 应 该 放 在 词典 列表 的 末尾 。 它 放 
在 任何 其 他 的 词典 之 前 都 是 无 用 的 ， 因 为 一 个 标记 将 不 会 经 过 它 到 下 一 个 词典 。 


12.7. 配置 实例 


文本 搜索 配置 指定 所 有 选项 将 文档 转换 成 一 个 tsvector : 使 用 解析 器 将 文本 分 解 为 标记 ， 并 
且 使 用 词典 将 每 个 标记 转换 为 词 。 to_tsvector 或 者 to_tsquery 的 每 一 次 调用 需要 一 个 文本 
搜索 配置 来 执行 处 理 。 如 果 一 个 明确 的 配置 参数 被 省 略 ， 则 配置 参 

数 default_text_search_config 指 定 默认 配置 的 名 称 ， 它 是 通过 一 个 文本 搜索 函数 使 用 的 。 它 
可 以 在 postgresql.conf 中 设置 ， 或 使 用 ser 命令 设置 一 个 独立 会 话 。 


有 几 个 预定 义 的 文本 搜索 配置 是 可 用 的 ， 并 且 您 可 以 很 容易 的 创建 自 定 义 的 配置 。 为 了 方便 
文本 搜索 对 象 的 管理 ， 一 组 SQL 命令 是 可 用 的 ， 有 几 个 psql 命 令 可 以 显示 有 关 文 本 搜索 对 象 
的 信息 ( 节 Section 12.10) o 


作为 一 个 例子 ， 我 们 将 创建 一 个 配置 pg ， 通 过 复制 内 置 english 配置 启动 : 


CREATE TEXT SEARCH CONFIGURATION public.pg ( COPY = pg_catalog.english ); 


我 们 将 使 用 PostgreSQL 特 定 的 同义词 列表 并 将 其 存储 
在 $SHAREDIR/tsearch_data/pg_dict.syn 中 。 文件 内 容 看 起 来 像 : 


postgres pg 
pgsql pg 
postgresql pg 


我 们 定义 这 样 的 同义词 词典 


CREATE TEXT SEARCH DICTIONARY pg_dict ( 
TEMPLATE = synonym, 
SYNONYMS = pg_dict 

); 


接 下 来 我 们 注册 lspell 词 典 english_ispell ， 它 有 自己 的 配置 文件 : 


CREATE TEXT SEARCH DICTIONARY english_ispell ( 
TEMPLATE = ispell, 
DictFile = english, 
AffFile = english, 
StopWords = english 


现在 我 们 可 以 在 配置 pg 中 建立 词汇 映射 : 


ALTER TEXT SEARCH CONFIGURATION pg 
ALTER MAPPING FOR asciiword, asciihword, hword_asciipart, 
word, hword, hword_part 
WITH pg_dict, english_ispell, english_stem; 


我 们 没有 选择 索引 或 搜索 一 些 内 置 配 置 处 理 的 标记 类 型 : 


ALTER TEXT SEARCH CONFIGURATION pg 
DROP MAPPING FOR email, url, url_path, sfloat, float; 


现在 我 们 测试 我 们 的 配置 : 


SELECT * FROM ts_debug('public.pg', ' 

PostgreSQL, the highly scalable, SQL compliant, open source object-relational 
database management system, is now undergoing beta testing of the next 
version of our software. 


ya 


下 一 步 是 使 用 新 的 配置 设置 会 话 ， 这 是 在 public 模式 中 建立 的 : 


=> \dF 
List of text search configurations 
Schema | Name | Description 


public | pg | 


SET default_text_search_config = 'public.pg'; 
SET 


SHOW default_text_search_config; 
default_text_search_config 


public.pg 


12.8. 测试 和 调试 文本 搜索 

一 个 自 定 义 文 本 搜索 配置 的 行为 很 容易 变 得 混乱 。 在 本 节 中 描述 的 函数 对 测试 文本 搜索 对 象 
是 有 用 的 。 你 可 以 测试 一 个 完整 的 配置 ， 或 分 别 测试 分 析 器 和 词典 。 

12.8.1. 配备 测试 

PAX ts_debug 人 允许 简单 测试 文本 搜索 配置 。 


ts_debug([ ~_config_~ ~regconfig*, ] _document_ text, 
OUT _alias_ text, 
OUT _description_ text, 


OUT _token_ text, 
OUT _dictionaries_ regdictionary[], 
OUT _dictionary_ regdictionary, 


OUT _lexemes_ text[]) 
returns setof record 


ts_debug 显示 关于 通过 解析 器 产生 的 和 通过 配置 词典 处 理 的 document. 的 每 个 标记 的 信息 。 
如 果 和 忽略 参数 ， 它 使 用 通过 _config_ 或 者 default_text_search_config 指定 的 配置 。 
ts_debug 返回 通过 文本 解析 器 标识 的 每 个 标记 的 每 一 行 ， 返 回 的 列 是 : 

e alias text 一 标记 类 型 的 别名 

e description. text 一 标记 类 型 描述 

e token. text 一 标记 文本 

e dictionaries. regdictionary[] 一 通过 配置 为 这 个 标记 类 型 选 定 的 词典 

e _dictionary regdictionary 一 词典 公认 的 标记 ， 如 果 不 这 样 ， 则 为 空 。 


e _lexemes_ text[] 一 公认 标记 的 词典 产生 的 词 (s) ， 或 者 如 果 不 做 则 为 NULL ; 空 数 
a (0) 意味 着 它 是 公认 的 屏蔽 词 。 


一 个 简单 例子 : 


SELECT * FROM ts_debug('english','a fat 


alias 
asciiword 
blank 
asciiword 
blank 
asciiword 
blank 
asciiword 
blank 
asciiword 
blank 
asciiword 
blank 
asciiword 
blank 
blank 
asciiword 
blank 
asciiword 
blank 
asciiword 
blank 
asciiword 
blank 
asciiword 


一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 十 


description 


all ASCII 
symbols 
all ASCII 
symbols 
all ASCII 
symbols 
all ASCII 
symbols 
all ASCII 
symbols 
all ASCII 
symbols 


Word, all ASCII 


symbols 
symbols 
all ASCII 
symbols 
all ASCII 
symbols 
all ASCII 
symbols 
all ASCII 
symbols 


Word, all ASCII 


token | 


cat sat ona 
dictionaries 


E, 
E 
E 
E 


} 
{english_stem} 


{} 
{english_stem} 


{} 


f{english_stem} 


{} 
{english_stem} 


{} 
{english_stem} 


{} 
{english_stem} 


{} 
{english_stem} 


mat - it ate a 


| 
+ 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 


dictionary 


english_stem 
english_stem 
english_stem 
english_stem 
english_stem 
english_stem 


english_stem 


english_stem 
english_stem 
english_stem 
english_stem 


english_stem 


fat rats'); 
lexemes 


{mat} 


{} 
{ate} 
{} 
{fat} 


{rat} 


一 个 更 广泛 的 例子 ， 我 们 首先 用 英语 创建 一 个 public.english 配置 和 lspell 词 典 : 


CREATE TEXT SEARCH CONFIGURATION public.english ( COPY = pg_catalog.english ); 


CREATE TEXT SEARCH DICTIONARY english_ispell ( 
TEMPLATE 
DictFile 


AffFile 


StopWords 


Ne 


ispell, 
english, 


english, 


english 


ALTER TEXT SEARCH CONFIGURATION public.english 
ALTER MAPPING FOR asciiword WITH english_ispell, english_stem; 


SELECT * FROM ts_debug('public.english', 'The 
token 


alias 
asciiword 
blank 
asciiword 
blank 
asciiword 





在 这 个 例子 中 


个 词典 ， 


a 


description 


symbols 
all ASCII 
symbols 


Word, all ASCII 


all ASCII | The 


Brightest 


幸运 的 是 ， 是 公认 的 (事实 上 ， 


{} 
{english_ispell, english_stem} 


{} 
{english_ispell, english_stem} 


就 是 为 什么 它 被 放置 在 词典 列表 末尾 的 原因 ) 。 


Brightest supernovaes'); 
dictionaries 


| 
十 
| {english_ispell, english_stem} 
| 
| 
| 
| 


Brightest 是 由 解析 器 作为 AscII 词 来 标识 (别名 asciiword ) o 
识 类 型 ， 词 典 列 表 是 english ispell 和 english_stem 。 这 个 词 通过 english_ispell 标识 ， 

轨 纳 它 为 名 词 bright 。 词 supernovaes 于 english_ispell 词典 是 未 知 的 ， 所 以 它 传递 给 下 一 
english_stem 是 一 个 识别 一 切 的 Snowball 词 典 ; 这 


一 一 一 一 一 二 一 


dictionary 
english_ispe 
english_ispe 


english_stem 


为 这 个 标 


34] The 是 由 english_ispell i] BARA A RRA 〈 节 Section 12.6.1) ， 不 会 被 索引 。 空间 
也 被 丢弃 ， 因 为 该 配置 根本 没有 为 它们 提供 词典 。 


你 可 以 通过 明确 指定 你 想 要 查看 的 列 减少 输出 的 宽度 : 


SELECT alias, token, dictionary, lexemes 
FROM ts_debug('public.english', 'The Brightest supernovaes'); 


alias | token | dictionary | lexemes 
eedeeseases 站 
asciiword | The | english_ispell | {} 
blank | 
asciiword | Brightest | english_ispell | {bright} 
blank | | | 
asciiword | supernovaes | english_stem | {Supernova} 


12.8.2. 解析 器 测试 
下 列 函 数 人 允许 直接 测试 文本 搜索 解析 器 。 


ts_parse(_parser_name_ text, _document_ text, 

OUT _tokid_ integer, OUT _token_ text) returns setof record 
ts_parse(_parser_oid_ oid, _document_ text, 

OUT _tokid_ integer, OUT _token_ text) returns setof record 








ts_parse 解析 给 定 的 _document” 并 返回 一 系列 的 记录 ， 每 一 个 标记 通过 解析 而 产生 。 每 个 
记录 包括 tokid 显示 已 分 配 的 标记 类 型 ， 并 且 token 是 标记 的 文本 。 比 如 : 


SELECT * FROM ts_parse('default', '123 - a number'); 
tokid | token 
过 basses se 

22 | 123 

12 | 

1 || = 

wka 

12 | 

1 | number 


ts_token_type(_parser_name_ text, OUT _tokid_ integer, 

OUT _alias_ text, OUT _description_ text) returns setof record 
ts_token_type(_parser_oid_ oid, OUT _tokid_ integer, 

OUT _alias_ text, OUT _description_ text) returns setof record 








ts_token_type 返回 一 个 表 ， 这 个 表 描 述 了 每 种 可 以 识别 的 指定 分 析 器 标记 类 型 。 每 个 标记 
类 型 ， 该 表 给 出 了 整数 tokid ， 解 析 器 用 于 标记 那个 类 型 标记 ， alias 命名 配置 命 舍 的 标记 
类 型 ， 并 且 简 称 description o 比如 : 


SELECT * FROM ts_token_type('default'); 


tokid | alias | description 
ape nee ee Be ee =f Mi a ce ean aes ear aa CR A ee a To a ead ag a a Ro oe Fe ay ge et mE eee 
1 | asciiword | Word, all ASCII 
2 | word | Word, all letters 
3 | numword | Word, letters and digits 
4 | email | Email address 
5 | url | URL 
6 | host | Host 
7 | sfloat | Scientific notation 
8 | version | Version number 
9 | hword_numpart | Hyphenated word part, letters and digits 
10 | hword_part | Hyphenated word part, all letters 
11 | hword_asciipart | Hyphenated word part, all ASCII 
12 | blank | Space symbols 
13 | tag | XML tag 
14 | protocol | Protocol head 
15 | numhword | Hyphenated word, letters and digits 
16 | asciihword | Hyphenated word, all ASCII 
17 | hword | Hyphenated word, all letters 
18 | url_path | URL path 
19 | file | File or path name 
20 | float | Decimal notation 
21 | int | Signed integer 
22 | uint | Unsigned integer 
23 | entity | XML entity 


12.8.3. 词典 测试 
ts_lexize 加 数 有 易于 进行 词典 测试 。 


ts_lexize(_dict_ regdictionary, _token_ text) returns text[] 


如 果 输 入 token, 为 词典 已 知 的 ， 那 么 ts_lexize 返回 词 的 数组 ， 如 果 这 个 token 对 词典 是 已 
知 的 ， 但 它 是 一 个 屏蔽 词 ， 则 返回 空 数组 。 如 果 它 是 一 个 未 知 的 词 则 返回 NULL o 


比如 : 


SELECT ts_lexize('english_stem', 'stars'); 
ts_lexize 


SELECT ts_lexize('english_stem', 'a'); 
ts_lexize 


PostgreSQL 中 文 文档 9.3 


Note: ts_lexiz 辑 数 需要 单一 标记 ， 没 有 文本 。 这 是 一 种 引起 混淆 的 情况 : 


SEBECGTMtSS Leze( thesaursaastro supernovae stars”), Somnus 
?column? 


同义词 词典 thesaurus astro 确实 知道 短语 supernovae stars ， 但 ts_lexize 失败 了 ， 
因为 它 不 解析 输入 文本 ， 而 是 把 它 作 为 一 个 单一 标记 。 使 用 plainto_tsquery 或 
者 to_tsvector 测试 同义词 词典 ， 例 如 : 


SELECT plainto_tsquery('supernovae stars"); 
plainto_tsquery 


12.8. 测试 和 调试 文本 搜索 481 


12.9. GiST 和 GIN 索 引 类 型 


有 两 种 类 型 的 索引 可 以 用 于 加 快 全 文 搜索 。 注 意 全 文 检索 不 一 定 非 要 使 用 索引 。 但 是 在 规则 
基础 上 搜索 列 的 情况 下 ， 索 引 往 往 是 可 取 的 。 


CREATE INDEX _name ON _table USING gist( _column_ ); 





创建 以 GiST (通用 搜索 树 ) 为 基础 的 索引 ， _column 可 以 是 tsvector or tsquery 类 型 。 


CREATE INDEX _name ON _table_ USING gin( _column_ ); 





创建 以 GIN 〈 基 因 倒 排 素 引 ) 为 基础 的 索引 ， _column_ 必须 是 tsvector 类 型 。 
在 两 个 索引 类 型 之 间 有 着 巨大 的 性 能 差异 ， 因 此 了 解 它们 的 特性 是 很 重要 的 。 


GiST 索 引 是 有 损耗 的 ， 这 意味 着 该 索引 可 能 会 产生 错误 的 匹配 ， 并 且 有 必要 检查 实际 的 表 行 
消除 这 种 错误 匹配 (PostgreSQL 需 要 时 自动 执行 ) 。 GiST 索 引 是 有 损耗 的 ， 因 为 每 个 文档 

在 索引 中 通过 一 个 固定 长 度 的 标签 进行 表示 。 它 是 通过 散 列 每 个 单词 到 一 个 n 位 的 字符 串 的 单 
一 的 点 产生 ， 所 有 这 些 位 OR-ed 一 起 产生 一 个 n 位 的 文件 标签 。 当 两 个 单词 散 列 到 相同 点 的 位 
置 ， 将 有 一 个 错误 匹配 。 如 果 查 询 中 的 所 有 单词 匹配 (真实 的 或 错误 的 ) ， 则 必须 检索 表 行 
查看 匹配 是 否 是 正确 的 。 


数据 丢失 导致 了 性 能 下 降 ， 由 于 表 记 录 的 不 必要 的 获取 ， 产 生 了 错误 的 匹配 。 由 于 随机 访问 
表 记 录 是 缓慢 的 ， 这 限制 了 GiST 索 引 的 效能 。 错 误 匹 配 的 可 能 性 取决 于 几 个 因素 ， 特别 是 独 
特 词 的 数量 ， 所 以 推荐 使 用 词典 来 降低 这 些 数量 。 


GIN 索 引 并 没有 损耗 标准 查询 ， 但 它们 的 性 能 取决 于 对 数 独特 的 单词 数 。 然而 ，GIN 索 引 只 
存储 tsvector 值 的 字 ( 词 ) ， 而 不 是 它们 的 权重 标签 。 因 此 ， 当 使 用 涉及 权重 的 查询 时 ， 需 
要 复查 一 个 表 行 。) 


在 选择 要 使 用 的 索引 类 型 时 ，GiST 或 者 GIN 考 虑 这 些 性 能 上 的 差异 : 
。 GIN 索 引 坦 找 比 GiST 快 约 三 倍 
。 GIN 索 引 建 立 比 GIST 需 要 大 约 三 倍 的 时 间 。 


e GIN 索 引 更 新 比 GiST 索 引 速 度 慢 ， 但 如 果 快 速 更 新 支持 无 效 ， 则 慢 了 大 约 10 倍 (详情 请 
见 节 Section 57.3.1) 


e GIN 索 引 比 GiST 索 引 大 两 到 三 倍 


一 般 来 说 ，GIN 索 引 对 静态 数据 是 最 好 的 ， 因 为 查找 速度 很 快 。 对 于 动态 数据 ， GiST 索 引 更 
新 比较 快 。 具 体 而 言 ，GiST 索 引 非 常 适合 动态 数据 ， 并 且 如 果 独 特 的 字 Ga) 在 100,000 以 
F, 则 比较 快 ， 而 GIN 索 引 闻 处 理 100,000+ 词 汇 ， 但 是 更 新 比较 慢 。 


请 注意 ，GIN 索 引 编 译 时 间 通 常 可 以 通过 增加 maintenance_work_mem 改 进 ， 而 GiST 索 引 编 
译 时 间 对 参数 不 敏感 。 
大 集合 的 分 区 以 及 GiST 和 GIN 索 引 的 合理 使 用 人 允许 非常 快速 的 搜索 与 在 线 升级 的 实现 。 分 区 


可 以 在 数据 库 级 别 使 用 表 继 承 ， 或 者 在 服务 器 发 布 文档 并 且 使 用 dblink 模 块 采集 搜索 结果 。 后 
者 是 可 能 的 ， 因 为 相关 画 数 只 使 用 本 地 信息 。 


12.10. psql 支 持 


文本 搜索 配置 对 象 的 信息 可 以 使 用 一 组 命令 从 psql 中 获得 : 


\dF{d,p,t}[+] [PATTERN] 


一 个 可 选 的 + 产生 更 多 细节 。 


可 选 的 参数 PATTERN 可 以 是 一 个 文本 搜索 对 象 的 名 称 ， 随 意 的 模式 匹配 。 如 果 PATTERN 被 忽 
略 ， 则 显示 所 有 可 见 对 象 的 信息 。 PATTERN 可 以 是 一 个 正则 表达 式 ， 并 且 可 以 提供 模式 的 独 
立 形式 和 对 象 名 称 。 下 面 的 例子 说 明了 这 些 : 


=> \dF *fulltext* 
List of text search configurations 
Schema | Name | Description 
a eet aa ae pe re etn aa ane OR ee eer ret 
public | fulltext_cfg | 


=> \dF *.fulltext* 
List of text search configurations 


Schema | Name | Description 
PE ee ey 人 
fulltext | fulltext_cfg | 
public | fulltext_cfg | 

可 用 命令 是 : 


\dF[+] [PATTERN] 


罗列 文本 搜索 配置 (增加 + 获取 更 多 细节 ) 


=&gt; \dF russian 
List of text search configurations 
Schema | Name | Description 
See ea ee eee a en er NR Pe Nt ey gO ieee RS 
pg_catalog | russian | configuration for russian language 
=&gt; \dF+ russian 


Text search 


configuration "pg_catalog.russian" 


Parser: "pg_catalog.default" 
Token | Dictionaries 

SHE Se el talon nn REN res ad 

asciihword english_stem 

asciiword english_stem 

email simple 

file simple 

float simple 

host simple 

hword russian_stem 


hword_asciipart 


english_stem 


hword_numpart simple 
hword_part 

int simple 
numhword simple 
numword simple 
sfloat simple 
uint simple 
url simple 
url_path simple 
version simple 
word russian_stem 


| 
| 
| 
| 
| 
| 
| 
| 
| 
| russian_stem 
| 
| 
| 
| 
| 
| 
| 
| 
| 


\dFd[+] [PATTERN] 


罗列 文本 搜索 词典 


(增加 + 获取 更 多 细节 ) 。 


=&gt; \dFd 
List of text 
Schema | Name | 
pg_catalog | danish_stem | snowball stemmer 
pg_catalog | dutch_stem | snowball stemmer 
pg_catalog | english_stem | snowball stemmer 
pg_catalog | finnish_stem | snowball stemmer 
pg_catalog | french_stem | snowball stemmer 
pg_catalog | german_stem | snowball stemmer 
pg_catalog | hungarian_stem | snowball stemmer 
pg_catalog | italian_stem | snowball stemmer 
pg_catalog | norwegian_stem | snowball stemmer 
pg_catalog | portuguese_stem | snowball stemmer 
pg_catalog | romanian_stem | snowball stemmer 
pg_catalog | russian_stem | snowball stemmer 
pg_catalog | simple | 
pg_catalog | spanish_stem | 
pg_catalog | swedish_stem | 
pg_catalog | turkish_stem | 


search dictionaries 


Description 


danish language 
dutch language 
english language 
finnish language 
french language 
german language 
hungarian language 
italian language 
norwegian language 
portuguese language 
romanian language 
russian language 


simple dictionary: just lower case and check for stopword 
snowball stemmer for spanish language 
snowball stemmer for swedish language 
snowball stemmer for turkish language 


i "| 


\dFp[+] [PATTERN] 


罗列 文本 搜索 分 析 器 (增加 + 获取 更 多 的 细节 ) 。 


=&gt; \dFp 
List of text search parsers 
Schema | Name | Description 


pg_catalog | default | default word parser 
=&gt; \dFp+ 
Text search parser "pg_catalog.default" 
Method | Function | Description 


Start parse | prsd_start | 
Get next token | prsd_nexttoken | 
End parse | prsd_end | 
Get headline | prsd_headline | 
Get token types | prsd_lextype | 


Token types for parser "pg_catalog.default" 


Token name | Description 
ree et eS ee Pa tyre ety yey yay ae are ee oe eet 
asciihword Hyphenated word, all ASCII 
asciiword Word, all ASCII 
blank Space symbols 
email Email address 
entity XML entity 
file File or path name 
float Decimal notation 
host Host 
hword Hyphenated word, all letters 


| 

| 

| 

| 

| 

| 

| 

| 

| 

hword_asciipart | Hyphenated word part, all ASCII 

hword_numpart | Hyphenated word part, letters and digits 

hword_part | Hyphenated word part, all letters 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 


int Signed integer 

numhword Hyphenated word, letters and digits 
numword Word, letters and digits 
protocol Protocol head 

sfloat Scientific notation 

tag XML tag 

uint Unsigned integer 

url URL 

url_path URL path 

version Version number 

word word, all letters 

(23 rows) 


\dFt[+] [PATTERN] 


罗列 文本 搜索 模板 (增加 + 获取 更 多 的 细节 ) 。 


=&gt; \dFt 
List of text search templates 
Schema | Name | Description 
Speer aera ef est este ye yest tate ee ye ree pe ees ten yee Pe et nay ea ey et gd ey ee ey yt 
pg_catalog ispell ispell dictionary 
pg_catalog simple Simple dictionary: just lower case and check for stopword 


pg_catalog synonym synonym dictionary: replace word by its synonym 


| | 
| | 
pg_catalog | snowball | snowball stemmer 
| | 
pg_catalog | thesaurus | thesaurus dictionary: phrase by phrase substitution 


12.11. 限制 


PostgreSQL 的 文本 搜索 功能 当前 限制 是 : 
。 每 个 词 的 长 度 必须 小 于 2K 字 节 
e tsvector 〈 词 + 位 置 ) 的 长 度 必须 小 于 1 兆 字 节 
。 词 的 数量 必须 小 于 2<sup class="calibre28">64</sup> 
e tsvector 的 位 置 值 必须 大 于 0， 不 能 超过 16,383 
。 每 词 不 超过 256 位 置 
e 在 tsquery 中 节点 的 数目 〈 词 + 运算 符 ) 必须 小 于 32768 


相 比 之 下 ，PostgreSQL 8.1 文 档 包 含 10441 个 唯一 的 字 ， 共 335420 个 字 ， 并 且 最 频繁 的 
词 "postgresql" 在 655 个 文档 被 提 到 6127 次 。 


另 一 个 例子 一 PostgreSQL 邮 件 列表 档案 包含 910989 个 唯一 的 字 与 461，020 消 息 中 的 
57491343 个 词 。 


12.12. 来 自 8.3 之 前 文本 搜索 的 迁移 


为 文本 搜索 使 用 tsearch2 模 块 的 应 用 将 需要 内 置 功能 的 一 些 调整 。 


。 一 些 辑 数 已 被 重 命名 或 在 其 参数 列表 有 小 的 调整 ， 并 且 他 们 现在 都 在 pg_catalog 模式 
A, 而 在 以 前 的 安装 中 都 是 在 public KH __ 种 非 系统 模式 中 ， 有 一 个 新 的 tsearch2 版 
A, 它 提供 了 兼容 层 来 解决 这 方面 的 问题 。 


当 从 8.3 之 前 数据 库 加 载 pbgdump 输 出 时 ， 必 须 _ 抑 制 旧 的 tsearch2 画 数 和 其 他 对 象 。 而 他 
们 中 的 许多 不 会 加 载 ， 一 些 会 导致 问题 。 一 个 简单 处 理 方法 就 是 恢复 转 储 前 加 载 新 的 
tsearch2 模 块 ; 然后 阻塞 被 加 载 的 旧 对 象 。 


文本 搜索 配置 设置 现在 完全 不 同 。 不 是 手动 插入 行 到 配置 表 ， 搜 索 是 通过 本 章节 前 面 显 
示 的 专门 的 SQL 命令 配置 。 没有 自动 支持 8.3 转 换 现 有 的 自 定义 配置 ; 你 可 以 在 这 里 自己 
定义 。 


大 多 数 类 型 的 词典 依靠 一 些 外 部 的 数据 库 配 置 文件 。 这 些 与 8.3 之 前 用 法 兼容 ， 但 注意 以 
下 的 差异 : 


o 配置 文件 现在 必须 放 在 一 个 单一 指定 的 目录 ( $SHAREDIR/tsearch_data ) 中 ， 必须 
有 一 个 特定 的 扩展 取决 于 文件 的 类 型 ， 如 先前 在 各 种 词典 类 型 的 描述 中 指出 的 。 这 
个 限制 被 添加 到 安全 问题 中 。 


无 论 使 用 什么 数据 库 编码 ， 配 置 文件 必须 以 UTF-8 编 码 。 
o 在 词 库 的 配置 文件 中 ， 屏 殴 词 必须 用 ? 标记 。 


Chapter 13. 并 发 控制 
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本 章 描述 PostgreSQL 数 据 库 系 统 在 多 个 会 话 试图 同时 访问 同一 数据 时 的 表现 。 并 发 控制 的 目 
标 是 为 所 有 会 话 提 供 高 效 的 访问 ， 同 时 还 要 维护 严格 的 数据 完整 性 。 每 个 数据 库 应 用 开发 人 
员 都 应 该 熟悉 本 章 讨论 的 话题 


13.1. 介绍 


PostgreSQL 为 开发 者 提供 了 丰富 的 对 数据 并 发 访问 进行 管理 的 工具 。 FAB, PostgreSQL 
利用 多 版 本 并 发 控制 (MVCC) 来 维护 数据 的 一 致 性 。 这 就 意味 着 当 检索 数据 时 ， 每 个 事务 看 到 
的 都 只 是 一 小 段 时 间 之 前 的 数据 快照 (一 个 数据 库 版 本 )， 而 不 是 数据 的 当前 状态 。 这 样 ， 如 
果 对 每 个 数据 库 会 话 进行 事务 隔离 ， 就 可 以 避免 一 个 事务 看 到 其 它 并 发 事务 的 更 新 而 导致 不 
一 致 的 数据 。MVCC 通 过 避 开 传统 数据 库 系 统 锁定 的 方法 ， 最 大 限度 地 减少 锁 竞争 以 允许 合 
理 的 多 用 户 环境 中 的 性 能 。 

使 用 多 版 本 并 发 控制 比 锁定 模型 的 主要 优点 是 在 MVCC 里 ， 对 检索 ( 读 ) 数 据 的 锁 请 求 与 写 数 据 
的 锁 请 求 不 冲突 ， 所 以 读 不 会 阻塞 写 ， 而 写 也 从 不 阻塞 读 。 甚 至 当 通 过 创新 的 序列 化 快照 隅 
离 (SSN) 级 别提 供 事务 隔离 的 严格 等 级 时 ， PostgreSQL 维 持 这 样 的 保证 。 

在 PostgreSQL 里 也 有 表 和 行 级 别 的 锁定 机 制 ， 用 于 给 那些 无 法 轻松 接受 MVCC 行 为 的 应 用 。 
不 过 ， 恰 当地 使 用 MVCC 总 会 提供 比 锁 更 好 的 性 能 。 另外 ， 由 应 用 定义 的 咨询 锁 提 供 了 一 个 
获得 不 依赖 于 单独 事务 的 锁 的 机 制 。 


13.2. 事务 隔离 


SQL 标准 定义 了 四 个 级 别 的 事务 隔离 。 最 严格 的 是 串 行 化 ， 它 是 通过 标准 来 定义 的 ， 也 就 是 
说 ， 保证 一 组 可 序列 化 事务 的 并 发 执行 以 产生 同样 顺序 依次 运行 它们 的 同一 效果 。 其 他 三 个 
层次 是 通过 现象 术语 被 定义 ， 导 致 并 发 事务 之 间 的 相互 作用 ， 这 不 应 该 发 生 在 每 个 级 别 中 。 

标准 定义 为 因 于 序列 化 的 定义 ， 这 些 现象 不 可 能 在 这 一 水 平 上 (这 毫 不 奇怪 -- 如 果 事 务 的 影响 
必须 与 已 运行 的 一 个 保持 一 致 ， 你 怎么 能 看 到 通过 相互 作用 引起 的 现象 呢 ? 


各 个 级 别 不 希望 发 生 的 现象 是 : 

脏 读 

一 个 事务 读 取 了 另 一 个 未 提交 事务 写 入 的 数据 。 

不 可 重复 读 

一 个 事务 重新 读 取 前 面 读 取 过 的 数据 ， 发 现 该 数据 已 经 被 另 一 个 已 提交 事务 修改 。 
幻 读 


一 个 事务 重新 执行 一 个 查询 ， 返 回 一 套 符 合 查询 条 件 的 行 ， 发 现 这 些 行 因为 其 它 最 近 提 交 的 
事务 而 发 生 了 改变 。 


这 四 种 隔离 级 别 和 对 应 的 行为 在 表 Table 13-1 里 描述 。 


Table 13-1. 标准 SQL 事务 隔离 级 别 


隔离 级 别 脏 读 不 可 重复 读 幻 读 
读 未 提交 可 能 可 能 可 能 
读 已 提交 不 可 能 可 能 可 能 
可 重复 读 不 可 能 不 可 能 可 能 
可 串 行 化 不 可 能 不 可 能 不 可 能 


在 PostgreSQL 里 ， 你 可 以 请 求 四 种 可 能 的 事务 隔离 级 别 中 的 任意 一 种 。 但 是 在 内 部 ， 实际 上 
只 有 三 种 独立 的 隔离 级 别 ， 分 别 对 应 读 已 提交 ， 可 重复 读 和 可 串 行 化 。 如 果 你 选择 了 读 未 提 
交 的 级 别 ， 实际 上 你 用 的 是 读 已 提交 ， 在 重复 读 的 PostgreSQL 执 行 时 ， 幻 读 是 不 可 能 的 ， 
所 以 实际 的 隔离 级 别 可 能 比 你 选择 的 更 严格 。 这 是 SQL 标准 允许 的 : 四 种 隔离 级 别 只 定义 了 
哪 种 现 像 不 能 发 生 ， 但 是 没有 定义 那 种 现 像 一 定 发 生 。PostgreSQL 只 提供 两 种 隔离 级 别 的 原 
Ale, 这 是 把 标准 的 隔离 级 别 与 多 版 本 并 发 控制 架构 映射 相关 的 唯一 合理 方法 。 可 用 的 隔离 
级 别 的 行为 在 下 面 小 节 里 描述 。 


要 设置 一 个 事务 的 隔离 级 别 ， 使 用 SET TRANSACTION 命 今 。 


Important: —#PostgresQLÄ E & WAMKA FEST AEREN. 尤其 是 ， 序 
列 变化 〈 因 此 列 数 通过 serial 声明 ) 对 于 所 有 其 他 的 事务 是 立即 可 见 的 ， 如 果 事务 改 
变 终 止 ， 则 不 进行 回 退 。 参 见 Section 9.16 和 Section 8.1.4。 








13.2.1. 读 已 提交 陋 离 级 别 


读 已 提交 是 PostgreSQL 里 的 缺 省 隔离 级 别 。 当 一 个 事务 运行 在 这 个 隔离 级 别 时 ， SELECT 查 
询 ( 没 有 FOR UPDATE/SHARE 子 句 ) 只 能 看 到 查询 开始 之 前 已 提交 的 数据 而 无 法 看 到 未 提交 的 数据 
或 者 在 查询 执行 期 间 其 它 事 务 已 提交 的 数据 。 实 际 上 ， SELECT 查询 看 到 一 个 在 查询 开始 运 

行 的 瞬间 该 数据 库 的 一 个 快照 。 不 过 ， sect 看 得 见 其 自身 所 在 事务 中 前 面 更 新 执行 结果 。 

即使 它们 尚未 提交 。 请 注意 ， 在 同一 个 事务 里 两 个 相 邻 的 sELEcT 命令 可 能 看 到 不 同 的 快照 ， 

因为 其 它 事 务 会 在 第 一 个 sect 执行 期 间 提交 。 


UPDATE , DELETE , SELECT FOR UPDATE 和 SELECT FOR SHARE 命令 在 搜索 目标 行 时 的 行为 

和 sELECT 一 样 : 它们 只 能 找到 在 命 分 开始 的 时 候 已 经 提交 的 行 。 不 过 ， 这 样 的 目标 行 在 被 
找到 的 时 候 可 能 已 经 被 其 它 并 发 事务 更 新 、 删 除 、 锁 住 。 在 这 种 情况 下 ， 即将 进行 的 更 新 将 
等 待 第 一 个 事务 提交 或 者 回 滚 (如 果 它 还 在 处 理 )。 如 果 第 一 个 事务 回 滚 ， 那么 它 的 作用 将 被 
忽略 ， 而 第 二 个 事务 将 继续 更 新 最 初 发 现 的 行 。 如 果 第 一 个 事务 提交 ， 那么 如 果 第 一 个 事务 
删除 了 该 行 ， 则 第 二 个 事务 将 忽略 该 行 ， 否则 它 将 试图 在 该 行 的 已 更 新 的 版 本 上 施加 它 的 操 
作 。 系 统 将 重新 计算 命令 搜索 条 件 ( whERE FA) 看 看 该 行 已 更 新 的 版 本 是 否 仍然 符合 搜索 
条 件 。 如 果 符 合 ， 则 第 二 个 事务 从 该 行 的 已 更 新 版 本 开始 继续 其 操作 。 如 果 

是 SELECT FOR UPDATE 和 SELECT FOR SHARE 则 意味 着 把 已 更 新 的 行 版 本 锁 住 并 返回 给 客户 端 。 


因为 上 面 的 规则 ， 正 在 更 新 的 命令 可 能 会 看 到 不 一 致 的 快照 : 它们 可 以 看 到 影响 它们 更 新 的 
并 发 命令 的 效果 ， 但 是 却 看 不 到 那些 命令 对 数据 库 里 其 它 行 的 作用 。 这 样 的 行为 邻 读 已 提交 
模式 不 适合 用 于 哪 种 涉及 复 末 搜索 条 件 的 命令 。 不 过 ， 它 对 于 简单 的 情况 而 言 是 正确 的 。 比 
如 ， 假 设 我 们 用 类 似 下 面 这 样 的 命令 更 新 银行 余额 : 


BEGIN; 
UPDATE accounts SET balance 
UPDATE accounts SET balance 
COMMIT; 


balance + 100.00 WHERE acctnum 
balance - 100.00 WHERE acctnum 


12345; 
7534; 


如 果 两 个 并 发 事务 试图 同时 修改 帐号 12345 的 余额 ， 那 我 们 很 明显 希望 第 二 个 事务 是 从 已 更 新 
过 的 行 版 本 上 进行 更 新 。 因为 每 个 命令 只 是 影响 一 个 已 经 决定 了 的 行 ， 因 此 让 它 看 到 更 新 后 
的 版 本 不 会 导致 任何 不 一 致 的 问题 。 


更 复杂 的 用 法 可 以 在 读 已 提交 模式 下 产生 不 需要 的 结果 。 上 比如 ， 考 虑 DELETE 命令 数据 操作 通 
过 另外 一 个 命令 的 限制 标准 中 被 添加 或 者 删除 等 ， 假 设 website 是 website.hits 等 同 
Fo 和 10 的 两 行 表 格 。 


BEGIN; 
UPDATE website SET hits = hits + 1; 

- run from another session: DELETE FROM website WHERE hits = 10; 
COMMIT; 


DELETE 不 会 产生 影响 ， 即 使 在 upPpATE 之 前 和 之 后 有 website.hits = 10, 这 发 生 是 因为 先 
前 更 新 的 行 值 9 被 忽略 ， 并 且 当 uor 完成 而 且 DELETE 获得 锁 时 ， 新 的 行 值 不 再 是 10 而 
是 11 ， 它 不 再 符合 标准 。 


因为 在 读 已 提交 模式 里 ， 每 个 新 的 命令 都 是 从 一 个 新 的 快照 开始 的 ， 而 这 个 快照 包含 所 有 到 
该 时 刻 为 止 已 提交 的 事务 ， 因此 同一 事务 中 后 面 的 命令 将 看 到 任何 已 提交 的 其 它 事务 的 效 
Ro 这 里 关心 的 问题 是 在 单个 命令 里 是 否 看 到 数据 库 里 绝对 一 致 的 视图 。 


读 已 提交 模式 提供 的 部 分 事务 隔离 对 于 许多 应 用 而 言 是 足够 的 ， 并 且 这 个 模式 速度 快 ， 使 用 
简单 。 不 过 ， 对 于 做 复 末 查询 和 更 新 的 应 用 ， 可 能 需要 保证 数据 库 有 上 比 读 已 提交 模式 更 加 严 
格 的 一 致 性 视图 。 


13.2.2. 可 重复 读 隔 离 级 别 


可 重复 读 隔离 级 别 仅 仅 看 到 事务 开始 之 前 提交 的 数据 ， 它 不 能 看 到 在 并 发 事务 执行 期 间 未 提 
交 的 数据 和 已 提交 的 改变 。 然而， 查询 看 到 在 自身 事务 中 执行 的 先前 更 新 的 效果 ， 即 使 它 
们 没有 被 提交 ) 。 比 为 这 一 隔离 级 别 的 SQL 标准 需求 来 说 ， 这 是 一 个 更 强烈 的 保证 。 避免 所 
有 在 Table 13-1 描 述 的 现象 。 正 如 上 述 所 提 及 的 ， 这 是 通过 标准 允许 的 ， 这 仅仅 描述 必须 提 
供 的 每 个 隔离 级 别 的 最 低 限度 保护。 


这 个 级 别 和 读 已 提交 级 别 是 不 一 样 的 。 重 复读 事务 中 的 查询 看 到 的 是 事务 开始 时 的 快照 ， 而 
不 是 该 事务 内 部 当前 查询 开始 时 的 快照 ， 这 样 ， 同一 个 事务 内 部 后 面 的 seLEcT 命令 总 是 看 到 
同样 的 数据 等 ， 它 们 没有 看 到 通过 自身 事务 开始 之 后 提 及 的 其 他 事务 做 出 的 改变 。 


使 用 这 个 级 别 的 应 用 必须 准备 好 重 斌 事务， 因为 串 行 化 失败 。 


UPDATE , DELETE , SELECT FOR UPDATE 和 SELECT FOR SHARE 在 搜索 目标 行 时 的 行为 

和 sELECT 一 样 : 它们 将 只 寻找 在 事务 开始 的 时 候 已 经 提交 的 目标 行 。 但 是 ， 这 样 的 目标 行 
在 被 发 现 的 时 候 可 能 已 经 被 另外 一 个 并 发 的 事务 更 新 、 删 除 、 锁 住 。 在 这 种 情况 下 ， 可 串 行 
化 的 事务 将 等 待 第 一 个 正在 更 新 的 事务 提交 或 者 回 滚 ( 如 果 它 仍然 在 处 理 中 )。 如 果 第 一 个 事务 
BA, 那么 它 的 影响 将 被 忽略 ， 而 这 个 可 串 行 化 的 就 可 以 继续 更 新 它 最 初 发 现 的 行 。 但 是 如 
果 第 一 个 事务 被 提交 了 (并 且 实际 上 更 新 或 者 删除 了 该 行 ， 而 不 只 是 锁 住 它 ) 那 么 可 串 行 化 事务 
HEA, 并 返回 下 面 信息 : 


ERROR: could not serialize access due to concurrent update 


因为 一 个 可 串 行 化 的 事务 在 开始 之 后 不 能 更 改 或 者 锁 住 被 其 它 事务 更 改过 的 行 。 


当 应 用 收 到 这 样 的 错误 信息 时 ， 它 应 该 退出 当前 的 事务 然后 从 新 开始 进行 整个 事务 。 第 二 次 
运行 时 ， 该 事务 看 到 的 快照 将 包含 前 一 次 已 提交 的 修改 ， 所 以 不 会 有 逻辑 冲突 。 


请 注意 只 有 更 新 事务 才 需 要 重 试 ， 只 读 事务 从 来 没有 串 行 化 冲突 。 


可 重复 读 事务 级 别提 供 了 严格 的 保证 : 每 个 事务 都 看 到 一 个 完全 一 致 的 数据 库 视 图 。 然 而 ， 
这 种 观点 也 不 一 定 总 是 与 (一 次 一 个 ) 同一 级 别 的 并 发 事务 连续 执行 一 致 。 例如 ， 即 使 在 这 
个 级 别 上 的 一 个 只 读 事务 可 以 看 到 控制 记录 更 新 显示 一 批 已 经 完成 ， 但 不 能 看 到 一 批 逮 辑 音 
分 的 详细 记录 ， 因为 它 读 取 较 早 版 本 的 控制 记录 。 如 果 不 仔细 使 用 显 式 锁 来 阻止 冲突 事务 ， 
通过 运行 在 这 个 隔离 级 别 上 的 事务 尝试 执行 业务 规则 是 不 能 正常 工作 的 。 








Note: PostgreSQL9.1 版 本 之 前 ， 为 序列 化 事务 隔离 级 别 的 请 求 提 供 完全 相同 的 描述 。 为 
保留 传统 的 串 行 化 行为 ， 现 在 要 求 可 重复 读 。 





13.2.3. 可 串 行 化 隔离 级 别 


可 串 行 化 级 别提 供 最 严格 的 事务 隔离 。 这 个 级 别 为 所 有 已 提交 事务 模拟 串 行 的 事务 执行 ， 就 
好 像 事务 将 被 一 个 接着 一 个 那样 串 行 (而 不 是 并 行 ) 的 执行 。 不 过 ， 正 如 可 重复 读 隔离 级 别 一 
样 ， 使 用 这 个 级 别 的 应 用 必须 准备 在 串 行 化 失败 的 时 候 重新 启动 事务 。 事实 上 ， 该 隔离 级 别 
和 可 重复 读 希 望 的 完全 一 样 ， 它 只 是 监视 这 些 条 件 ， 以 所 有 事务 的 可 能 的 序列 不 一 致 的 (一 
次 一 个 ) 的 方式 执行 并 行 的 可 序列 化 事务 执行 的 行为 。 这 种 监测 不 引入 任何 阻止 可 重复 读 出 
现 的 行为 ， 但 有 一 些 开 销 的 监测 ， 检 测 条 件 这 可 能 会 导致 序列 化 异常 将 触发 序列 化 失败 。 


举例 来 说 ， 假 设 一 个 表 mytab ， 最 初 包含 : 


class | value 


假设 可 串 行 化 事务 A 计算 : 


SELECT SUM(value) FROM mytab WHERE class = 1; 


然后 把 结果 (30) 作 为 value 字段 值 插入 到 表 中 ， 并 兮 新 行 的 class = 2 。 同 时 ， 另 一 个 并 发 
的 可 串 行 化 的 事务 B 进 行 下 面 计算 


SELECT SUM(value) FROM mytab WHERE class = 2; 


然后 把 结果 (300) 作 为 class = 1 字段 值 插入 到 表 中 。 然后 两 个 事务 都 提交 。 如 果 事 务 都 在 
可 重复 读 隔离 级 别 上 运行 ， 两 者 都 不 允许 提交 ; 但 是 因为 没有 执行 一 致 性 结果 的 序列 顺序 ， 
使 用 可 串 行 化 事务 将 允许 一 个 事务 被 提交 ， 并 且 回 滚 到 该 消息 的 其 他 块 中 。 


ERROR: could not serialize access due to read/write dependencies among transactions 


这 是 因为 如 果 AHB 之 前 执行 ，B 应 该 计算 出 总 和 330 ， 而 不 是 300， 如 果 B 在 A 之 前 执行 ， 
那么 A 计算 出 的 总 和 也 会 不 同 。 


当 依赖 于 可 串 行 化 事务 阻止 异常 时 ， 来 自 永 久 用 户 表 读 取 的 任何 数据 不 被 认为 是 有 效 的 ， 直 
到 事务 读 取 的 成 功 提交 为 止 。 这 对 于 只 读 事务 是 真 的 ， 除 了 在 可 延期 的 只 读 事 务 中 的 数据 读 
是 有 效 的 。 因为 这 样 一 个 事务 等 待 直到 它 可 以 在 开始 读 取 任何 数据 之 前 获得 一 个 快照 保证 这 
些 问题 是 自由 的 。 在 所 有 其 他 情况 下 ， 应 用 不 依赖 于 结果 读 ， 期 间 事 务 之 后 被 停止 ; 相反 ， 
他 们 应 该 重启 事务 直到 成 功 为 止 。 


为 了 保证 PostgreSQL 真 正 可 串 行 化 使 用 谓词 锁定 。 这 意味 着 当 写 对 于 并 发 事务 的 先前 读 结果 
有 重大 影响 时 ， 它 使 锁 决 定 首先 运行 。 在 PostgreSQL 这 些 锁 不 造成 任何 阻塞 ， 因 此 可 以 不 导 
致 僵局 。 它们 被 用 来 识别 和 标记 并 发 序列 化 事务 中 的 依赖 关系 ， 其 中 一 定 的 组 合 可 导致 序列 
化 异常 。 相反 ， 读 已 提交 或 者 可 重复 读 取 的 事务 要 确保 数据 的 一 致 性 可 能 需要 获取 整个 表 
锁 ， 它 可 以 阻止 其 他 尝试 使 用 该 表 的 用 户 ， 也 可 以 使 用 SELECT FoR UPDATE 或 

者 SELECT FOR SHARE ， 这 不 仅 可 以 阻止 其 他 事务 而 且 可 能 导致 磁盘 访问 。 


PostgreSQL 中 的 谓词 锁 ， 像 其 他 大 多 数 数 据 库 系 统一 样 ， 基于 通过 事务 实际 访问 的 数据 ， 这 
些 显示 在 pg_locks 系统 视图 中 ， 并 带 有 srtReadLock 的 模式 。 查询 执行 期 间 特定 的 锁 的 获得 
将 取决 于 使 用 的 查询 计划 。 以 及 事务 进程 防止 用 于 跟踪 锁定 的 内 存 耗 尽 期 间 的 多 个 细 粒 度 锁 
〈 例 如， 元 组 锁 ) 可 以 组 合成 较 少 的 粗 粒度 的 锁 〈 例 如 ， 页 锁 ) 。 Re 事务 可 以 在 完成 之 前 
释放 SIRead 锁 ， 如 果 它 检测 到 没有 冲突 仍然 发 生 ， 这 可 能 会 导致 一 系列 的 异常 。 事 实 上 ， 
Re 事务 会 经 常 建立 启动 事实 ， 并 且 避 免 采 取 任 何谓 词 锁 。 如 果 你 明确 要 

求 SERIALIZABLE READ ONLY DEFERRABLE 事务 ， 这 将 阻塞 直到 它 可 以 建立 这 一 事实 。 (这 是 唯 
一 情况 ， 可 序列 化 事务 块 可 以 但 可 重复 读 事务 不 行 。) 另 一 方面 ，SIRead 锁 经 常 需要 保持 过 
去 的 事务 提交 ， 直 到 重 亚 读 写 事 务 完 成 。 


可 序列 化 事务 一 致 性 的 使 用 可 以 简化 开发 。 如 果 他 们 每 次 运行 一 个 ， 保 证 任何 一 组 并 发 序列 

化 事务 会 具有 相同 的 效果 。 这 意味 着 如 果 你 能 证 明 单 一 事务 ， 作 为 书面 的 ， 当 自己 运行 时 将 
做 正确 事情 ， 你 可 以 有 信心 它 会 在 任何 组 合 可 序列 化 事务 中 做 正确 的 事 ， 即 使 没有 任何 有 关 
那些 其 他 事务 的 消息 。 使 用 这 种 技术 的 环境 中 有 一 个 处 理 序列 化 失败 的 方法 是 很 重要 的 〈 它 
总 是 返回 40001' 的 SQLSTATE 值 ) ， 因为 它 很 难 准确 预测 ， 事 务 可 能 有 助 于 读 / 写 依赖 并 且 需 
要 回 滚 防止 序列 化 异常 。 读 / 写 依 赖 的 监控 是 有 成 本 的 ， 正 如 序列 化 失败 而 终止 之 后 进行 事务 
重新 启动 ， 但 权衡 成 本 和 使 用 显 式 锁 以 及 SELECT FOR UPDATE 或 者 SELECT FOR SHARE 涉及 到 的 
阻 断 ， 可 序列 化 事务 在 这 种 环境 下 是 性 能 最 好 的 选择 。 


为 了 最 佳 性 能 ， 当 为 并 发 控制 依赖 于 可 串 行 化 事务 时 ， 应 该 考虑 这 些 问题 : 
e 可 能 时 作为 Riz 声明 事务 。 


。 如 果 需 要 ， 可 以 使 用 连接 池 ， 控 制 活动 连接 数 。 这 是 一 个 重要 性 能 的 考虑 ， 但 是 在 使 用 
可 串 行 化 事务 的 繁忙 系统 中 尤其 重要 。 


。 比 起 需要 完整 性 目的 来 说 不 要 将 更 多 的 东西 放 到 单一 事务 中 。 
。 不 要 让 连接 在 "闲置 的 事务 "中 停留 超过 需要 的 时 间 。 


e 消除 显示 锁 ， SELECT FoR UPDATE 和 SELECT FOR SHARE 不 再 需要 ， 因 为 通过 可 串 行 化 事务 
自动 提供 保护 。 


。 当 系 统 强 制 连接 多 个 页 级 别 谓词 锁 到 单一 关系 级 别 谓词 锁 ， 因 为 谓词 锁 表 是 短期 存储 ， 
可 能 产生 可 串 行 化 失败 率 的 增加 。 你 可 以 通过 增加 max_pred_locks_per_transaction 来 
避免 。 


。 顺序 扫描 总 是 需要 一 个 关系 级 别 谓词 锁 。 这 可 能 会 导致 序列 化 失败 率 增加 。 这 可 能 有 助 
于 鼓励 减少 random_page_cost 和 /或 增加 cpu_tuple_cost 的 索引 扫描 使 用 。 一 定 要 权衡 
任何 事务 回 滚 的 减少 ， 并 且 重 新 启动 查询 执行 时 间 内 的 任何 整体 变化 。 


Warning 


序列 化 事务 隔离 级 别 尚未 被 添加 到 热 备 复制 目标 中 (正如 在 Section 25.5 中 描述 的 ) 。 严 
格 的 隔离 级 别 目前 热 备 方式 上 支持 可 重复 读 。 当 在 主 库 上 执行 所 有 永久 数据 库 写 入 可 序 
列 化 事务 中 将 确保 所 有 的 措施 将 最 终 达 成 一 致 ， 运行 在 各 库 上 的 可 重复 读 事务 会 看 到 一 
个 过 渡 状 态 ， 与 主 库 上 的 任何 串 行 执行 的 可 序列 化 事务 不 一 致 。 


13.3. 明确 锁定 


PostgreSQL 提 供 了 多 种 锁 模式 用 于 控制 对 表 中 数据 的 并 发 访问 。 这 些 模式 可 以 用 于 在 MVCC 
无 法 给 出 期 望 行为 的 场合 。 同 样 ， 大 多 数 PostgreSQL 命 令 自 动 施加 恰当 的 锁 以 保证 被 引用 的 
表 在 命令 的 执行 过 程 中 不 会 以 一 种 不 兼容 的 方式 被 删除 或 者 修改 。 比如 ， 在 存在 其 它 并 发 操 
作 的 时 候 ， TRUNCATE 是 不 能 在 同一 个 表 上 面 执行 的 


要 检查 数据 库 服务 器 里 所 有 当前 正在 被 持 有 的 锁 ， 可 以 使 用 pg_locks RAMA. 有 关 监 控 
锁 管 理 器 子 系统 状态 的 更 多 信息 ， 请 参考 章 Chapter 27。 


13.3.1. 表 级 锁 


下 面 的 列表 显示 了 可 用 的 锁 模 式 和 它们 被 PostgreSQL 自 动 使 用 的 场合 。 你 也 可 以 用 LOCK 命 
今明 确 获 取 这 些 锁 。 请 注意 所 有 这 些 锁 模 式 都 是 表 级 锁 ， 即使 它们 的 名 字 包 含 "row" 单 词 (这 些 
名 称 是 历史 遗产 )。 从 某 种 角度 而 言 ， 这 些 名 字 反 应 了 每 种 锁 模 式 的 典型 用 法 一 但 是 语意 却 都 
是 一 样 的。 两 种 锁 模 式 之 间 真 正 的 区 别 是 它们 有 着 不 同 的 冲突 锁 集合 (参见 Table 13-2), 两 个 
事务 在 同一 时 刻 不 能 在 同一 个 表 上 持 有 相互 冲突 的 锁 。 不 过 ， 一 个 事务 决 不 会 和 自身 冲突 。 
比如 ， 它 可 以 在 一 个 表 上 请 求 access ExcLusIVE 然后 接着 请 求 AccEss SHARE o 非 冲 突 锁 模式 
可 以 被 许多 事务 同时 持 有 。 请 特别 注意 有 些 锁 模式 是 自 冲突 的 (比如 ， 在 任意 时 

刻 access EXCLUSIVE 模式 就 不 能 够 被 多 个 事务 拥有 )， 但 其 它 锁 模式 都 不 是 自 冲 突 的 ( 比 

如 ， access SHARE 可 以 被 多 个 事务 持 有 )。 


表 级 锁 模 式 
ACCESS SHARE 


R- access EXCLUSIVE 冲突 。 


SELECT 命令 在 被 引用 的 表 上 请 求 一 个 这 种 锁 。 通 常 ， 任何 只 读 取 表 而 不 修改 它 的 命令 都 请 求 
这 种 锁 模 式 。 
ROW SHARE 


与 EXCLUSIVE 和 ACCESS EXCLUSIVE 锁 模 式 冲 突 。 


SELECT FOR UPDATE 和 SELECT FOR SHARE 命令 在 目标 表 上 需要 一 个 这 样 模式 的 锁 (加 上 在 所 有 
被 引用 但 没有 access sHaRe 的 表 上 的 FoR UPDATE/FOR SHARE 锁 )。 


ROW EXCLUSIVE 
与 SHARE , SHARE ROW EXCLUSIVE , EXCLUSIVE 和 ACCESS EXCLUSIVE 锁 模 式 冲 突 。 


UPDATE , DELETE 和 INSERT 命令 自动 请 求 这 个 锁 模 式 (加 上 所 有 其 它 被 引用 的 表 上 
的 ACCESS SHARE 锁 )。 通常 ， 这 种 锁 将 被 任何 修改 表 中 数据 的 查询 请 求 。 


SHARE UPDATE EXCLUSIVE 


与 SHARE UPDATE EXCLUSIVE , SHARE , SHARE ROW EXCLUSIVE , EXCLUSIVE 和 
ACCESS EXCLUSIVE 锁 模 式 冲 突 。 这 个 模式 保护 一 个 表 不 被 并 发 模式 改变 和 vacuum o 


VACUUM (不 带 FULL 选项 )，ANALYZE , CREATE INDEX CONCURRENTLY 和 ALTER TABLE 请 求 这 样 的 
锁 。 
SHARE 


与 Row EXCLUSIVE , SHARE UPDATE EXCLUSIVE , SHARE ROW EXCLUSIVE , EXCLUSIVE 和 
ACCESS EXCLUSIVE 锁 模式 冲突 。 这 个 模式 避免 表 的 并 发 数据 修改 。 
CREATE INDEX (不 带 CONCURRENTLY 选项 ) 语 名 要求 这 样 的 锁 模 式 。 


SHARE ROW EXCLUSIVE 


与 ROW EXCLUSIVE , SHARE UPDATE EXCLUSIVE , SHARE , SHARE ROW EXCLUSIVE , EXCLUSIVE 和 
ACCESS EXCLUSIVE 锁 模 式 冲 突 。 这 个 模式 避免 表 的 并 发 数据 修改 。 并 且 是 自我 排斥 的 ， 因 此 
每 次 只 有 一 个 会 话 可 以 拥有 它 。 

任何 PostgreSQL 命 倒 都 不 会 自动 请 求 这 个 锁 模 式 。 

EXCLUSIVE 

与 ROW SHARE , ROW EXCLUSIVE , SHARE UPDATE EXCLUSIVE , SHARE , SHARE ROW EXCLUSIVE , 
EXCLUSIVE 和 ACCESS EXCLUSIVE 锁 模式 冲突 。 这 个 模式 只 人 允许 并 发 Access SHARE 锁 ， 也 就 是 
说 ， 只 有 对 表 的 读 动作 可 以 和 持 有 这 个 锁 模 式 的 事务 并 发 执行 。 

任何 PostgreSQL 命 合 都 不 会 在 用 户 表 上 自动 请 求 这 个 锁 模 式 。 

ACCESS EXCLUSIVE 

与 所 有 模式 冲突 ( ACCESS SHARE , ROW SHARE , ROW EXCLUSIVE , SHARE UPDATE EXCLUSIVE , 


SHARE , SHARE ROW EXCLUSIVE , EXCLUSIVE 和 ACCESS EXCLUSIVE )。 这 个 模式 保证 其 所 有 者 ( 事 


务 ) 是 可 以 访问 该 表 的 唯一 事务 。 


ALTER TABLE , DROP TABLE , TRUNCATE , REINDEX , CLUSTER 和 vacuum FULL 命令 要 求 这 样 的 
锁 。 在 LOCK TABLE 命令 没有 明确 声明 需要 的 锁 模 式 时 ， 它 是 缺 省 锁 模 式 。 





Tip: 只 有 access EXcLUSIVE 阻塞 SELECT (不 包含 FOR UPDATE/SHARE 语句 )。 
一 旦 请 求 已 获得 某 种 锁 ， 那 么 该 锁 模 式 将 持续 到 事务 结束 。 但 是 如 果 在 建立 保存 点 之 后 才 获 
得 锁 ， 那么 在 回 滚 到 这 个 保存 点 的 时 候 将 立即 释放 所 有 该 保存 点 之 后 获得 的 锁 。 这 
与 RoLLBACK 取消 所 有 保存 点 之 后 对 表 的 影响 的 原则 一 致 。 同样 的 原则 也 适用 于 PL/pgSQL 异 
常 块 中 获得 的 锁 : 一 个 跳出 块 的 错误 将 释放 在 块 中 获得 的 锁 。 


Table 13-2. 冲突 锁 模 式 


Current 


Requested 
Lock 
Lock Mode Mode 
ACCESS ROW ROW SHARE SHARE 
SHARE SHARE | ExcLUsive | UPDATE SHARE ROW E 
EXCLUSIVE EXCLUSIVE 
ACCESS 7 
SHARE 
ROW 
SHARE X X 
ROW 
EXCLUSIVE * X X X 
SHARE 
UPDATE X X x 7 
EXCLUSIVE 
SHARE X x x 
SHARE 
ROW X X X X x ) 
EXCLUSIVE 
EXCLUSIVE X x x ; 
ACCESS 
EXCLUSIVE * X X X x 


13.3.2. 行 级 锁 


除了 表 级 锁 以 外 ， 还 有 行 级 锁 ， 他 们 可 以 是 排他 的 或 者 是 共享 的 。 特 定 行 上 的 排他 行 级 锁 是 
在 行 被 更 新 的 时 候 自动 请 求 的 。 该 锁 一 直 保 持 到 事务 提交 或 者 回 滚 。 行 级 锁 不 影响 对 数据 的 
查询 ， 它 们 只 阻塞 对 同一 行 的 宇和 人。 


要 在 不 修改 某 行 的 前 提 下 请 求 该 行 上 的 一 个 排他 行 级 锁 ， 用 SELECT For UPDATE 选取 该 行 。 请 
注意 一 旦 我 们 请 求 了 特定 的 行 级 锁 ， 那 么 该 事务 就 可 以 多 次 对 该 行进 行 更 新 而 不 用 担心 冲 

突 。 

要 在 某 行 上 请 求 一 个 共享 的 行 级 锁 ， 用 SELECT FOR SHARE 选取 该 行 。 一 个 共享 锁 并 不 阻止 其 
它 事务 请 求 同 一 个 共享 的 锁 。 不 过 ， 其 它 事 务 不 允许 更 新 、 删 除 、 或 者 排他 锁 住 持 有 共享 锁 
的 行 。 任 何 这 人 么 做 的 企图 都 将 被 阻塞 并 等 待 共享 锁 的 释放 。 

PostgreSQL 不 会 在 内 存 里 保存 任何 关于 已 修改 行 的 信息 ， 因 此 对 一 次 锁定 的 行 数 没有 限制 。 
不 过 ， 锁 住 一 行 会 导致 一 次 磁盘 写 ; 因为 SELECT For UPDATE 将 修改 选中 的 行 以 标记 它们 被 锁 
ET, 所 以 会 导致 磁盘 写 。 


除了 表 级 别 和 行 级 别 的 锁 以 外 ， 页 面 级 别 的 共享 /排他 锁 也 用 于 控制 共享 缓冲 池 中 表 页 面 的 读 / 
写 。 这 些 锁 在 抓 取 或 者 更 新 一 行 后 马上 被 释放 。 应 用 程序 员 通 常 不 需要 关心 页 级 锁 ， 我 们 在 
这 里 提 到 它们 只 是 为 了 完整 。 


13.3.3. Fb Fi 


明确 锁定 的 使 用 可 能 会 增加 死 锁 的 可 能 性 ， 死 锁 是 指 两 个 (或 多 个 ) 事 务 相 互 持 有 对 方 期 待 的 
锁 。 比如 ， 如 果 事 务 1 在 表 A 上 持 有 一 个 排他 锁 ， 同 时 试图 请 求 一 个 在 表 B 上 的 排他 锁 ， 

而 事务 2 已 经 持 有 表 B 的 排他 锁 ， 而 却 正 在 请 求 在 表 A 上 的 一 个 排他 锁 ， 那么 两 个 事务 就 都 
不 能 执行 。 PostgreSQL 能 够 自动 侦 测 死 锁 条 件 并 且 会 通过 退出 其 中 一 个 事务 从 而 允许 其 它 事 
务 完 成 来 解决 这 个 问题 。 具体 哪个 事务 会 被 退出 是 很 难 预计 的 ， 而 且 也 不 应 该 依靠 这 样 的 预 
计 。 


要 注意 的 是 死 锁 也 可 能 会 因为 行 级 锁 而 发 生 ( 即 使 是 没有 使 用 明确 的 锁定 )。 考虑 如 下 情况 ， 
两 个 并 发 事务 在 修改 一 个 表 。 第 一 个 事务 执行 了 : 


UPDATE accounts SET balance = balance + 100.00 WHERE acctnum = 11111; 
这 样 就 在 指定 帐号 的 行 上 请 求 了 一 个 行 级 锁 。 然 后 ， 第 二 个 事务 执行 : 


balance + 100.00 WHERE acctnum 
balance - 100.00 WHERE acctnum 


UPDATE accounts SET balance 
UPDATE accounts SET balance 


22222; 
11111; 


第 一 个 uPDATE 语句 成 功 地 在 指定 行 上 请 求 到 了 一 个 行 级 锁 ， 因 此 它 成 功 更 新 了 该 行 。 但 是 第 
二 个 UPDATE 语句 发 现 它 试图 更 新 的 行 已 经 被 锁 住 了 ， 因 此 它 等 待 持 有 该 锁 的 事务 结束 。 事务 
二 现在 就 在 等 待 事务 一 结束 ， 然 后 再 继续 执行 。 现 在 ， 事 务 一 执行 : 


UPDATE accounts SET balance = balance - 100.00 WHERE acctnum = 22222; 


事务 一 企图 在 指定 行 上 请 求 一 个 行 级 锁 ， 但 是 它 得 不 到 : 事务 二 已 经 持 有 这 样 的 锁 了 。 所 以 
它 等 待 事务 二 完成 。 因 此 ， 事 务 一 被 事务 二 阻塞 住 了 ， 而 事务 二 也 被 事务 一 阻塞 住 了 : 这 就 
是 一 个 死 锁 条 件 。PostgreSQL 将 侦 测 这 样 的 条 件 并 退出 其 中 一 个 事务 。 


防止 死 锁 的 最 好 方法 通常 是 保证 所 有 使 用 一 个 数据 库 的 应 用 都 以 一 致 的 顺序 在 多 个 对 象 上 请 
求 锁定 。 在 上 面 的 例子 里 ， 如 果 两 个 事务 以 同样 的 顺序 更 新 那些 行 ， 那 么 就 不 会 发 生死 锁 。 
我 们 也 要 保证 在 一 个 对 象 上 请 求 的 第 一 个 锁 是 该 对 象 需要 的 最 高 的 锁 模 式 。 如 果 我 们 无 法 提 
前 核实 这 些 问 题 ， 那 么 我 们 可 以 通过 在 现场 重新 尝试 因 死 锁 而 退出 的 事务 的 方法 来 处 理 。 


只 要 没有 检测 到 死 锁 条 件 ， 事 务 将 一 直 等 待 表 级 锁 或 行 级 锁 的 释放 。 这 意味 着 一 个 事务 持续 
的 时 间 太 长 不 是 什么 好 事 ( 比 如 等 待 用 户 输入 )。 


13.3.4. 咨询 锁 


PostgreSQL 人 允许 创建 由 应 用 定义 其 含义 的 锁 。 这 种 锁 被 称 为 咨询 锁 ， 因为 系统 并 不 强迫 其 使 
用 一 而 是 由 应 用 来 保证 其 被 恰当 的 使 用 。 咨询 锁 可 用 于 MVCC 难以 实现 的 锁定 策略 。 比 

如 ， 咨 询 锁 一 般 用 于 模拟 常见 于 "平面 文件 "数据 管理 系统 的 悲观 锁 策略 。 虽然 可 以 用 存储 在 
表 中 的 一 个 特定 标志 达到 同样 的 目的 ， 但 是 使 用 咨询 锁 更 快 ， 还 可 以 避免 表 膝 肿 ， 更 可 以 在 
会 话 结束 的 时 候 由 系统 自动 执行 清理 工作 。 


PostgreSQL 中 有 两 种 方式 可 以 获得 咨询 锁 : 会 话 级 别 或 者 事务 级 别 。 咨询 锁 一 旦 被 持 有 就 将 
持续 到 被 明确 释放 或 会 话 结束 。 不 同 于 各 种 标准 的 锁 ， 咨 询 锁 并 不 考虑 事务 的 语意 : 在 一 个 
被 回 滚 的 事务 中 获得 的 咨询 锁 并 不 会 被 自动 释放 ， 同 样 的 ， 在 一 个 失败 的 事务 中 释放 的 咨询 
锁 仍 将 保持 释放 。 同 一 个 咨询 锁 可 以 被 它 自己 的 进程 多 次 获得 : 对 于 每 一 个 锁定 请 求 必 须 有 
一 个 相应 的 释放 请 求 ， 这 样 才 能 最 终 真 正 释放 该 锁 。 另 一 方面 ， 事 务 级 别 的 锁 请 求 ， 表 现 得 
更 像 普 通 锁 请 求 : 他 们 结束 事务 时 自动 释放 ， 并 且 没有 明确 的 解锁 操作 。 这 种 行为 通常 比 次 
询 锁 的 短期 使 用 会 话 级 别 行为 更 方便 。 会 话 级 别 和 事务 级 别 锁 请 求 为 相同 的 咨询 锁 标 识 符 将 
以 预期 方式 互相 阻止 。 如 果 某 个 会 话 已 经 持 有 一 个 咨询 锁 ， 那 么 对 该 锁 的 多 次 锁定 请 求 将 总 
会 成 功 ， 即 使 其 它 会 话 正在 等 候 该 锁 的 释放 也 是 如 此 。 不 管 是 否 持 有 已 存在 锁 ， 并 且 新 的 要 
求 是 会 话 级 别 或 者 事务 级 别 ， 这 个 语句 是 真 的 。 


与 PostgreSQL 中 其 它 锁 一 样 ， 可 以 在 pg locks 系统 视图 中 查看 当前 被 会 话 持 有 的 所 有 咨询 
锁 。 


咨询 锁 和 规则 锁 存 储 在 共享 内 存 池 中 ， 其 中 大 小 由 max_ locks_per transaction 和 
max_connections 配 置 参数 决定 。 千 万 不 要 耗 尽 这 些 内 存 ， 否 则 服务 器 将 不 能 再 获取 任何 新 
锁 。 因此 服务 器 可 以 获得 的 咨询 锁 数 量 是 有 限 的 ， 根 据 服务 器 的 配置 不 同 ， 这 个 限制 可 能 是 
几 万 到 几 十 万 个 。 


在 某 些 使 用 咨询 锁 方法 的 特定 情况 下 ， 特 别 是 查询 包括 明 确 的 排序 或 LTMIT 子 句 的 时 候 ， 由 
于 SQL 表达 式 求 值 顺序 的 影响 ， 必 须 注意 控制 咨询 锁 的 获取 。 例 如 : 

SELECT pg_advisory_lock(id) FROM foo WHERE id = 12345; -- ok 

SELECT pg_advisory_lock(id) FROM foo WHERE id > 12345 LIMIT 100; -- danger! 


SELECT pg_advisory_lock(q.id) FROM 


SELECT id FROM foo WHERE id > 12345 LIMIT 100 
) q; -- ok 


在 上 述 查 询 中 ， 第 二 种 形式 是 危险 的 ， 因 为 LIMIT 并 不 一 定 在 锁定 函数 执行 之 前 被 应 用 。 这 
可 能 导致 获得 某 些 应 用 不 期 望 的 锁 ， 并 因此 在 会 话 结束 之 前 无 法 释放 。 从 应 用 的 角度 来 看 ， 
这 样 的 锁 将 被 挂 起 ， 虽 然 它 们 仍然 在 pg_locks 中 可 见 。 


用 于 操作 咨询 锁 的 函数 在 Section 9.26.8 中 描述 。 


13.4. 应 用 层 数 据 完整 性 检查 


关于 使 用 读 已 提交 事务 的 数据 完整 性 强制 执行 业务 规则 是 很 难 的 ， 由 于 数据 视图 从 每 个 语句 
偏 移 ， 如 果 发 生 写 入 冲突 ， 则 单一 语句 可 以 不 限制 自身 到 语句 快照 。 


当 可 重复 读 事 务 在 执行 期 间 有 稳定 的 数据 表 视 图 ， 使 用 MVCC 数 据 一 致 性 检查 的 快照 有 一 个 
微妙 的 问题 ， 涉 及 一 些 被 称 为 读 / 于 冲突 的 东西 。 如 果 一 个 事务 写 入 数据 ， 并 且 并 发 事务 尝试 
读 取 同一 数据 (无 论 写 之 前 还 是 之 后 ) ， 它 不 能 看 到 其 他 事务 的 工作 。 读 者 似乎 首先 被 执 

行 ， 无 论 哪个 先 被 启动 或 先 被 提交 。 如 果 是 这 样 ， 这 是 没有 问题 的 ， 但 如 果 读 者 也 写 由 并 发 
事务 读 取 的 数据 ， 则 现在 有 一 个 前 面 已 提 到 的 事务 似乎 运行 着 的 事务 。 如 果 已 经 被 执行 的 事 
务 最 后 首先 被 提交 ， 出 现在 事务 执行 顺序 图 中 ， 这 样 一 个 循环 是 很 容易 的 。 当 这 样 一 个 循环 
出 现时 ， 完 整 性 检查 将 不 能 正常 工作 ， 而 没有 一 定 的 帮助 。 

正如 Section 13.2.3 提 及 到 的 ， 可 串 行 化 事务 是 可 重复 读 事务 ， 其 中 添加 了 读 / 写 冲突 危险 模 


式 的 非 阻 塞 监测 。 当 这 个 模式 被 监测 时 ， 有 可 能 导致 明显 的 执行 顺序 周期 ， 其 中 所 涉及 到 的 
事务 回 滚 以 打破 这 个 周期 。 


13.4.1. 可 串 行 化 事务 执行 一 致 性 


如 果 序 列 化 事务 隔离 级 别 是 用 于 所 有 宇和 所 有 读 ， 这 需要 数据 一 致 视 图 ， 没 有 其 他 努力 来 确 
保 一 致 性 。 来 自 其 他 环境 的 软件 书面 使 用 序列 化 事务 确保 一 致 性 应 该 在 PostgreSQL 这 方 
面 "只 是 工作 "。 

当 使 用 这 种 技术 时 ， 如 果 应 用 软件 完成 框架 ， 其 中 回 滚 到 可 串 行 化 失败 的 地 方 进行 自动 重启 
事务 ， 它 可 以 避免 为 应 用 参数 产生 不 必要 的 负担 。 设 

i default_transaction_isolation 到 可 串 行 化 是 一 个 很 好 的 主意 。 明智 的 采取 一 些 措施 确保 
没有 其 他 可 用 的 事务 隔离 级 别 ， 或 者 是 无 意 的 或 者 破坏 完整 性 检查 ， 通过 触发 器 中 的 事务 隔 
离 级 别 检查 。 


参见 Section 13.2.3 获 取 性 能 建议 。 


Warning 


这 一 级 别 的 完整 性 保护 使 用 序列 化 事务 还 没有 延伸 到 热 各 模式 (Section 25.5) 。 因此 ， 
那些 采用 热 备 方式 可 能 要 使 用 可 重复 读 ， 并 且 主 库 上 明确 锁 。 


13.4.2. 明确 阻塞 锁 的 执行 一 致 性 


当 可 能 进行 非 串 行 化 写 入 时 ， 要 保证 一 行当 前 实际 存在 和 避免 其 被 同时 更 新 ， 我 们 必须 使 
用 SELECT FOR UPDATE , SELECT FOR SHARE 或 者 合适 的 Lock TABLE 语 
句 。 SELECT FOR UPDATE 和 SELECT For SHARE 只 是 对 其 它 的 并 发 更 新 锁 住 返回 的 行 ， 


而 Lock TABLE 保护 整个 表 。 当 从 其 它 环境 向 PostgreSQL 里 用 可 串 行 化 模式 移植 应 用 时 一 定 要 
把 这 些 问题 考虑 进去 。 


还 要 注意 来 自 其 他 环境 的 这 些 转变 事实 : SELECT FOR UPDATE 不 能 保证 并 发 事务 不 更 新 或 删除 
已 选择 的 行 。 为 了 这 样 做 ，PostgreSQL 中 你 必须 更 新 行 ， 即 使 没有 值 需要 被 改变 。 来 自 获 

取 同 一 个 锁 或 者 执行 UPDATE 或 者 DELETE 的 SELECT For UPDATE 暂时 阻塞 其 他 事务 可 能 影响 

锁定 行 ， 但 是 一 旦 事务 持 有 这 个 锁 提 交 或 者 回 滚 ， 被 阻塞 事务 将 继续 做 冲突 操作 ， 除 非 当 锁 

被 持 有 的 时 候 ， 执 行 实际 UPDATE ÍT. 


在 MVCC 非 串 行 化 下 ， 全 局 有 效 性 检查 需要 一 些 额 外 的 考虑 。 比如 ， 一 个 银行 应 用 可 能 会 希 

望 检 查 一 个 表 中 的 所 有 扣 款 总 和 等 于 另外 一 个 表 中 的 加 款 总 和 ， 同时 两 个 表 还 会 被 活跃 地 更 
新 。 在 读 已 提交 模式 下 比较 两 个 连续 的 SELECT sum(...) 命令 的 结果 是 不 可 靠 的 ， 因为 第 二 个 
查询 很 可 能 会 包含 第 一 个 没 计算 的 事务 提交 的 结果 。 在 一 个 可 串 行 化 的 事务 里 进行 两 个 求 和 

则 给 出 在 可 串 行 化 事务 开始 之 前 提交 的 所 有 事务 产生 的 精确 的 结果 一 但 我 们 还 是 会 合理 地 置 
疑 在 结果 提交 的 时 候 ， 它 们 是 否 还 相关 。 如 果 可 串 行 化 事务 本 身 在 试图 做 一 致 性 检查 之 前 进 
行 了 某 些 变更 ， 那 么 检查 的 有 用 性 就 更 加 值得 讨论 了 ， 因为 现在 它 包含 了 一 些 (但 不 是 全 部 ) 

事务 开始 后 的 变化 。 在 这 种 情况 下 ， 一 个 仔细 的 人 会 希望 锁 住 所 有 需要 检查 的 表 ， 这 样 才 能 
获得 一 个 无 可 置疑 的 当前 现状 的 图 像 。 一 个 SHARE 模式 (或 者 更 高 级 ) 的 锁 保 证 在 被 锁定 表 中 

除了 当前 事务 之 外 ， 没 有 未 提交 的 更 新 。 


还 要 注意 如 果 我 们 依赖 明确 锁定 来 避免 并 发 更 新 ， 那 么 我 们 应 该 使 用 读 已 提交 模式 ， 或 者 是 
在 可 串 行 化 模式 里 在 执行 命 舍 之 前 小 心地 获取 锁 。 在 可 串 行 化 事务 里 获取 的 锁 保 证 了 不 会 有 
其 它 正 在 运行 的 修改 该 表 的 事务 存在 ， 但 是 如 果 事 务 看 到 的 快照 提前 获取 了 锁 ， 那 么 它 可 能 
提前 把 一 些 现 在 已 经 提交 的 改变 放 到 表 中 。 一 个 可 串 行 化 事务 的 快照 实际 上 是 在 它 的 第 一 个 
查询 或 者 数据 修改 命令 ( SELECT, INSERT, UPDATE , Or DELETE ) 开 始 的 时 候 冻 结 的 ， 因此 我 
们 可 以 在 快照 闲 结 之 前 明确 获取 锁 。 


13.5. 锁 和 索引 


尽管 PostgreSQL 提 供 对 表 数 据 访 问 的 非 阻 塞 的 读 / 写 ， 但 并 非 所 有 PostgreSQL 里 实现 的 索引 
访问 模式 都 能 够 进行 非 阻塞 读 / 写 。 不 同 的 索引 类 型 按照 下 面 方法 操作 : 


B-tree, GiST and SP-GiST indexes 


短期 的 页 面 级 共享 /排他 锁 用 于 读 / 宇 访 问 。 锁 在 索引 行 被 插入 / 抓 取 后 立即 释放 。 这 种 索引 类 
型 提供 了 无 死 锁 条 件 的 最 高 级 的 并 发 性 。 


Hash indexes 
Hash 桶 级 别 的 共享 /排他 锁 用 于 读 / 写 访问 。 锁 在 整个 Hash 桶 处 理 完成 后 释放 。 Hash 桶 级 


锁 比 索引 级 的 锁 提 供 了 更 好 的 并 发 性 但 是 可 能 产生 死 锁 ， 因为 锁 持 有 的 时 间 比 一 次 索引 操作 
时 间 长 。 

GIN indexes 

短期 的 页 面 级 共享 /排他 锁 用 于 读 / 写 访问 。 锁 在 索引 行 被 插入 / 抓 取 后 立即 释放 。 但 要 注意 的 


是 一 个 GIN 索 引 值 的 插入 通常 导致 几 个 每 行 几 个 索引 键 的 插入 ， 因此 GIN 可 能 为 了 插入 一 个 值 
而 做 大 量 的 工作 。 


目前 ，B-tree 索引 为 并 发 应 用 提供 了 最 好 的 性 能 。 因 为 它 还 有 上 比 Hash 索引 更 多 的 特性 ， 在 那 
些 需要 对 标量 数据 进行 素 引 的 并 发 应 用 中 ， 我 们 建议 使 用 B-tree 索引 类 型 。 在 处 理 非 标 量 类 
型 数据 的 时 候 ，B-tree 就 没什么 用 了 ， 应 该 使 用 GIST 或 GIN 索引 。 
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查询 的 性 能 可 能 受 多 种 因素 影响 。 其 中 一 些 因 素 可 以 由 用 户 操纵 ， 而 其 它 的 则 属于 下 层 系统 
设计 的 基本 问题 了 。 本 章 我 们 提供 一 些 有 关 理 解 和 调节 PostgreSQL 性 能 的 线索 。 


14.1. 使 用 EXPLAIN 


PostgreSQL 对 每 个 查询 产生 一 个 查询 规划 。 为 匹配 查询 结构 和 数据 属性 选择 正确 的 规划 对 性 
能 绝对 有 关键 性 的 影响 。 因此 系统 包含 了 一 个 复杂 的 规划 器 用 于 寻找 最 优 的 规划 。 你 可 以 使 
用 EXPLAIN 命 令 察 看 规划 器 为 每 个 查询 生成 的 查询 规划 是 什么 。 阅读 查询 规划 是 一 门 值得 专 
门 宇 一 厚 本 教程 的 学 问 ， 但 是 这 部 分 试图 掩盖 这 些 基本 信息 。 

本 节 的 例子 是 从 数据 库 执 行 vacuum ANALYZE 之 后 的 回 为 测试 中 提取 的 ， 使 用 9.3 开 发 源 。 如 果 


你 尝试 自己 的 例子 ， 你 应 该 可 以 得 到 类 似 结果 ， 但 你 的 估计 成 本 及 行 数 可 能 会 略 有 不 同 ， 
为 ANALYzE 的 统计 数据 是 随机 样本 ， 而 不 是 确切 的 ， 并 且 因 为 成 本 本 身 有 点 依赖 于 平台 。 


该 示例 使 用 ExPLAIN 的 缺 省 "文本 "输出 格式 ， 它 结构 紧凑 ， 便 于 人 们 阅读 。 如 果 你 想 为 进 一 
步 分 析 提 供 ExPLAIN 输出 给 程序 ， 你 应 该 使 用 它 的 机 器 可 读 的 输出 格式 之 一 (XML, JSON, or 
YAML) 来 代替 。 


14.1.1. EXPLAIN 基础 


查询 规划 的 结构 是 一 个 规划 节点 的 树 。 最 底层 的 节点 是 表 扫 描 节 点 : 它们 从 表 中 返回 原始 数 
据 行 。 不 同 的 表 访 问 模式 有 不 同 的 扫描 节点 类 型 : 顺序 扫描 、 索 引 扫 描 、 位 图 索引 扫描 。 也 
有 非 表 行 来 源 ， 如 vALuEs 子 句 和 FRoM 中 的 设置 返回 画 数 ， 其 中 有 他 们 自己 的 扫描 节点 类 

型 。 如 果 查 询 需 要 连接 、 聚 集 、 排 序 、 或 者 对 原始 行 的 其 它 操作 ， 那么 就 会 在 扫描 节点 之 上 
有 其 它 额外 的 节点 。 并 且 ， 做 这 些 操 作 通 常 都 有 多 种 方法 ， 因此 在 这 些 位 置 也 有 可 能 出 现 不 
同 的 节点 类 型 。 EXPLAIN 给 规划 树 中 每 个 节点 都 输出 一 行 ， 显示 基本 的 节点 类 型 和 规划 器 为 
执行 这 个 规划 节点 预计 的 开销 值 。 其 他 行 可 能 会 出 现 ， 从 节点 的 汇总 行 缩 进 ， 以 显示 节点 的 


附加 属性 。 第 一 行 (最 上 层 的 汇总 行 节点 ) 是 对 该 规划 的 总 执行 开销 的 预计 ; 这 个 数值 就 是 规 
划 器 试图 最 小 化 的 数值 


这 里 是 一 个 简单 的 例子 ， 只 是 用 来 显示 输出 会 有 
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EXPLAIN SELECT * FROM tenk1; 
QUERY PLAN 


Seq Scan on tenk1 (cost=0.00..458.00 rows=10000 width=244) 


由 于 此 查询 没有 were 子 句 ， 它 必须 扫描 所 有 表 的 行 ， 所 以 规划 器 已 经 选择 使 用 一 个 简单 的 
顺序 扫描 计划 。 括号 中 引用 的 数值 是 〈 从 左 到 右 ) : 
e 预计 的 启动 开销 。 在 输出 扫描 开始 之 前 消耗 的 时 间 ， 也 就 是 在 一 个 排序 节点 里 执行 排序 
的 时 间 。 


。 预计 总 开销 。 这 是 假设 所 规定 的 ， 计 划 节 点 运行 完成 ， 即 所 有 可 用 行 被 检索 。 在 实践 中 
一 个 节点 的 父 节 点 可 能 会 很 快 停止 读 取 所 有 可 用 的 行 (参见 LIMIT 下 面 的 例子 ) 。 


。 预计 这 个 规划 节点 输出 的 行 数 。 同 样 ， 只 执行 到 完成 为 止 。 
。 预计 这 个 规划 节点 的 行 平 均 宽 度 (以 字 节 计算 )。 


开销 是 用 规划 器 根据 成 本 参数 (参见 节 Section 18.7.2) 捏 造 的 单位 来 衡量 的 ， 习惯 上 以 磁盘 页 
o 也 就 是 seq_page_cost 将 被 按照 习惯 设 为 1.0 (一 次 顺序 的 磁盘 页 面 抓 取 )， 
它 开 销 参 数 将 参照 它 来 设置 。 本 节 的 例子 都 假定 这 些 参数 使 用 默认 值 。 


有 一 点 很 重要 : 一 个 上 层 节 点 的 开销 包括 它 的 所 有 子 节点 的 开销 。 还 有 一 点 也 很 重要 : 这 个 
开销 只 反映 规划 器 关心 的 东西 ， 尤 其 是 没有 把 结果 行 传递 给 客户 端的 时 间 考 虑 进去 ， 这 个 时 
间 可 能 在 实际 的 总 时 间 里 占据 相当 重要 的 分 量 ， 但 是 被 规划 器 忽略 了 ， 因为 它 无 法 通过 修改 
规划 来 改变 : 我 们 相信 ， 每 个 正确 的 规划 都 将 输出 同样 的 记录 集 。 


行 值 有 一 些小 技巧 ， 因 为 它 不 是 规划 节点 处 理 /扫描 过 的 行 数 ， 而 是 节点 发 射 数 目 。 通 常会 


少 于 扫描 数 ， 正 如 应 用 于 此 节点 上 的 任意 wer 子 句 条 件 的 过 滤 结 果 。 通 常 而 言 ， MEWS 
预计 会 接近 于 查询 实际 返回 、 更 新 、 删 除 的 行 数 。 


回 到 我 们 的 例子 


EXPLAIN SELECT * FROM tenk1; 
QUERY PLAN 


Seq Scan on tenk1 (cost=0.00..458.00 rows=10000 width=244) 


这 些 数字 的 获得 非常 直截了当 。 如 果 你 这 样 做 : 


SELECT relpages, reltuples FROM pg_class WHERE relname = 'tenki1'; 


你 会 发 现 tenk 有 358 磁盘 页 面 和 10000 行 。 估计 成 本 作为 (磁盘 页 面 读 取 
seq_page_cost) + ( 行 扫 描 cpu_tuple_cost) 被 计算 。 上 默认 情况 下 ， seq_page_cost 是 
1.0, cpu_tuple_cost 是 0.01, 因此 估计 成 本 为 (358 1.0) + (10000 0.01) = 458。 


现在 让 我 们 修改 查询 并 增加 一 个 wer RE : 


EXPLAIN SELECT * FROM tenk1 WHERE unique1 < 7000; 


QUERY PLAN 


Seq Scan on tenk1 (cost=0.00..483.00 rows=7001 width=244) 
Filter: (unique1 < 7000) 


请 注意 explain 输出 显示 were 子 句 当 作 一 个 "filter 条 件 附 属于 顺序 扫描 计划 节点 。 这 意味 
着 规划 节点 为 它 打 描 的 每 一 行 检 查 该 条 件 ， 并 且 只 输出 符合 条 件 的 行 。 预计 的 输出 行 数 降低 
了 ， 因 为 有 were 子 句 。 不 过 ， 打 描 仍 将 必须 访问 所 有 10000 行 ， 因此 开销 没有 降低 ; 实际 


上 它 还 增加 了 一 些 (确切 的 说 ， 通 过 10000 * cpu operator cost) 以 反映 检查 whERE 条 件 的 
额外 CPU 时 间 。 


这 条 查询 实际 选择 的 行 数 是 7000 ， 但 是 预计 的 行 数 只 是 个 大 概 。 如 果 你 试图 重复 这 个 试验 ， 
那么 你 很 可 能 得 到 不 同 的 预计 。 还 有 ， 这 个 预计 会 在 每 次 ANALYZzE 命令 之 后 改变 ， 
为 ANALYZE 生成 的 统计 是 从 该 表 中 随机 抽取 的 样本 计算 的 。 


把 查询 限制 条 件 改 得 更 严格 一 些 : 


EXPLAIN SELECT * FROM tenk1 WHERE unique1 < 100; 


QUERY PLAN 


Bitmap Heap Scan on tenk1 (cost=5.07..229.20 rows=101 width=244) 
Recheck Cond: (unique1 < 100) 
-> Bitmap Index Scan on tenki_unique1 (cost=0.00..5.04 rows=101 width=0) 
Index Cond: (unique1 < 100) 


这 里 ， 规 划 器 决定 使 用 两 步 的 规划 : 最 底层 的 规划 节点 访问 一 个 索引 ， 找 出 匹配 索引 条 件 的 
行 的 位 置 ， 然后 上 层 规划 节点 真实 地 从 表 中 抓 取 出 那些 行 。 独 立地 抓 取 数据 行 比 顺序 地 读 取 
它们 的 开销 高 很 多 ， 但 是 因为 并 非 所 有 表 的 页 面 都 被 访问 了 ， 这 么 做 实际 上 仍然 比 一 次 顺序 
扫描 开销 要 少 。 使 用 两 层 规划 的 原因 是 因为 上 层 规划 节点 把 索引 标识 出 来 的 行 位 置 在 读 取 它 
们 之 前 按照 物理 位 置 排 序 ， 这 样 可 以 最 小 化 独立 抓 取 的 开销 。 节 点 名 称 里 面 提 到 

的 "bitmap" 是 进行 排序 的 机 制 。 


现在 让 我 们 添加 另外 一 个 条 件 到 whERE FA : 


EXPLAIN SELECT * FROM tenk1 WHERE unique1 < 100 AND stringu1 = 'xxx'; 


QUERY PLAN 


Bitmap Heap Scan on tenk1 (cost=5.04..229.43 rows=1 width=244) 
Recheck Cond: (unique1 < 100) 
Filter: (stringu1 = 'xxx'::name) 
-> Bitmap Index Scan on tenki_unique1 (cost=0.00..5.04 rows=101 width=0) 
Index Cond: (unique1 < 100) 


新 增 的 条 件 stringu1 = 'xxx' 减少 了 预计 的 输出 行 ， 但 是 没有 减少 开销 ， 因为 我 们 仍然 需要 
访问 相同 的 行 。 请 注意 ， stringul 子 句 不 能 当做 一 个 索引 条 件 使 用 (因为 这 个 索引 只 是 

在 unique 列 上 有 )。 它 被 当做 一 个 从 素 引 中 检索 出 的 行 的 过 滤器 来 使 用 。 因此 开销 实际 上 略 
微 增加 了 一 些 以 反映 这 个 额外 的 检查 。 


在 某 些 情况 下 规划 区 更 加 喜欢 "simple" 索 引 扫 描 规划 : 


EXPLAIN SELECT * FROM tenk1 WHERE unique1 = 42; 


QUERY PLAN 


Index Scan using tenki_unique1 on tenki (cost=0.29..8.30 rows=1 width=244) 
Index Cond: (unique1 = 42) 


在 这 种 规划 类 型 中 ， 表 的 数据 行 是 以 索引 顺序 抓 取 的 ， 这 样 就 令 读 取 它 们 的 开销 更 大 ， 但 是 
这 里 的 行 少 得 可 恰 ， 因 此 对 行 位 置 的 额外 排序 并 不 值得 。 最 常见 的 就 是 看 到 这 种 规划 类 型 只 
抓 取 一 行 ， 以 及 那些 要 求 oRDER BY 条 件 匹 配 索 引 顺 序 的 查询 。 因 为 那 时 候 没 有 多 余 的 排序 步 
又 是 必要 的 以 满足 ORDER BY o 


如 果 在 where 里 面 使 用 的 好 几 个 字段 上 都 有 索引 ， 那 么 规划 器 可 能 会 使 用 索引 的 AND 或 OR 的 


组 合 : 


EXPLAIN SELECT * FROM tenk1 WHERE unique1 < 100 AND unique2 > 9000; 


QUERY PLAN 


Bitmap Heap Scan on tenk1 (cost=25.08..60.21 rows=10 width=244) 
Recheck Cond: ((unique1 < 100) AND (unique2 > 9000) ) 
-> BitmapAnd (cost=25.08..25.08 rows=10 width=0) 
-> Bitmap Index Scan on tenki_unique1 (cost=0.00..5.04 rows=101 width=0) 
Index Cond: (uniquel1 < 100) 
-> Bitmap Index Scan on tenki_unique2 (cost=0.00..19.78 rows=999 width=0) 
Index Cond: (unique2 > 9000) 


但 是 这 么 做 要 求 访问 两 个 索引 ， 因 此 与 只 使 用 一 个 索引 ， 而 把 另外 一 个 条 件 只 当 作 过 滤器 相 
fh, 这 个 方法 未 必 是 更 优 。 如 果 你 改变 涉及 的 范围 ， 你 会 看 到 规划 器 相应 地 发 生变 化 。 


下 面 是 一 个 例子 ， 显 示 LIMIT 的 影响 : 


EXPLAIN SELECT * FROM tenk1 WHERE unique1 < 100 AND unique2 > 9000 LIMIT 2; 


QUERY PLAN 


Limit (cost=0.29..14.48 rows=2 width=244) 
-> Index Scan using tenki_unique2 on tenki (cost=0.29..71.27 rows=10 width=244) 
Index Cond: (unique2 > 9000) 
Filter: (unique1 < 100) 


这 是 上 面相 同 的 查询 ， 但 我 们 增加 了 LIMIT ， 以 致 于 不 是 所 有 的 行 需要 被 检索 ， 并 且 规划 关 
于 该 怎么 做 改变 了 主意 ， 请 注意 ， 索 引 扫描 节点 的 总 成 本 和 行 数 被 显示 ， 好 像 它 是 运行 完毕 
的 。 然 而 ， 限 制 节点 预计 在 提取 这 些 行 的 仅仅 五 分 之 一 后 停止 ， 所 以 其 总 成 本 只 有 五 分 之 一 
之 多 ， 这 就 是 实际 的 预算 费用 查询 。 该 计划 优 于 增加 一 个 限制 节点 到 先前 的 计划 ， 因 为 该 限 
制 无 法 避免 支付 位 图 扫描 的 启动 成 本 ， 所 以 总 成 本 将 超过 使 用 这 种 方法 的 25 个 单位 的 东西 。 


让 我 们 试 着 使 用 我 们 上 面 讨 论 的 字段 连接 两 个 表 : 


EXPLAIN SELECT * 
FROM tenk1 t1, tenk2 t2 
WHERE t1.unique1 < 10 AND t1.unique2 = t2.unique2; 


QUERY PLAN 


Nested Loop (cost=4.65..118.62 rows=10 width=488) 
-> Bitmap Heap Scan on tenk1 t1 (cost=4.36..39.47 rows=10 width=244) 
Recheck Cond: (unique1 < 10) 
-> Bitmap Index Scan on tenki_unique1 (cost=0.00..4.36 rows=10 width=0) 
Index Cond: (unique1 < 10) 
-> Index Scan using tenk2_unique2 on tenk2 t2 (cost=0.29..7.91 rows=1 width=244) 
Index Cond: (unique2 = t1.unique2) 


EX PAW, Ria aS AMAR TT RARE ER A a 节点 摘要 行 
的 缩 进 反映 规划 树 结构 。 连接 的 第 一 个 ， 或 者 "outer"， 子 节点 就 是 类 似 于 我 们 之 前 看 到 的 位 
图 扫描 。 其 成 本 和 行 数 是 一 样 的 ， 正 如 我 们 从 SELECT ... WHERE unique1 alt; 10 获得 。 因为 
我 们 只 能 在 那个 节点 上 应 用 wHERE clause uniquei &lt; 10 o t1.unique2 = t2.unique2 子 句 
还 没有 任何 关系 。 因 此 它 不 影响 外 层 扫描 的 行 计数 。 艇 套 循环 连接 节点 将 运行 它 的 第 二 部 
分 ， 或 者 "inner" 子 节点 一 次 从 外 部 子 节点 获得 每 一 行 。 从 目前 的 外 层 行 获得 的 值 可 以 被 插入 
到 内 扫描 。 这 儿 ， 从 外 层 行 中 获得 的 t1.unique2 是 可 用 的 。 这 样 我 们 就 得 到 一 个 计划 和 成 
本 ， 并 且 类 似 于 我 们 上 面 看 到 的 简单 的 SELECT ... WHERE t2.unique2 = _constant_ 的 情况 。 
(估计 费用 实际 上 上 比 上 面 看 到 的 低 一 点 ， 在 t2 上 可 重复 的 索引 扫描 期 间 ， 作 为 期 望 发 生 的 高 
速 缓存 结果 ) 。 以 外 层 打 描 的 开销 为 基础 设置 循环 节点 的 开销 ， 加 上 每 个 外 层 行 的 一 个 重复 
(这 里 是 10 * 7.87)， 然后 再 加 上 连接 义理 需要 的 一 点 点 CPU 时 间 。 


在 这 个 例子 里 ， 连 接 的 输出 行 数 与 两 个 扫描 的 行 数 的 乘积 相同 ， 但 通常 并 不 是 这 样 的 ， 因为 
HR MAAR ATR wer 子 句 ， 因 此 它 只 能 应 用 于 连接 (join) 点 ， 而 不 能 影响 两 个 关系 
的 输入 扫描 。 这 里 有 一 个 例子 : 


EXPLAIN SELECT * 
FROM tenk1 t1, tenk2 t2 
WHERE t1.unique1 < 10 AND t2.unique2 < 10 AND ti.hundred < t2.hundred; 


QUERY PLAN 
Nested Loop (cost=4.65..49.46 rows=33 width=488) 
Join Filter: (t1.hundred < t2.hundred) 
-> Bitmap Heap Scan on tenki t1 (cost=4.36..39.47 rows=10 width=244) 
Recheck Cond: (uniquei1 < 10) 
-> Bitmap Index Scan on tenki_unique1 (cost=0.00..4.36 rows=10 width=0) 
Index Cond: (unique1 < 10) 
-> Materialize (cost=0.29..8.51 rows=10 width=244) 
-> Index Scan using tenk2_unique2 on tenk2 t2 (cost=0.29..8.46 rows=10 width=2 
Index Cond: (unique2 < 10) 


BE e 


条 件 t1.hundred &lt; t2.hundred 不 能 在 tenk2_unique2 索引 中 被 测试 ， 因 此 它 被 应 用 在 连接 
节点 。 这 减少 了 连接 节点 的 预计 输出 行 数 ， 但 不 改变 任何 一 个 输入 扫描 。 





注意 ， 这 里 的 规划 器 已 经 选择 "具体 化 "连接 内 部 关系 ， 通过 放 在 规划 节点 上 面 。 这 也 就 是 
i, t2 索引 扫描 将 执行 一 次 ， 尽 管 谋 套 循环 连接 节点 需要 读 取 数据 十 次 ， 来 自 外 部 关系 的 
每 一 行 。 实现 节点 将 数据 保存 在 存储 器 中 ， 因 为 它 被 读 取 ， 然 后 从 存储 器 每 个 后 续 过 程 中 返 


回 每 一 个 数据 。 


当 与 外 部 联接 时 ， 你 可 能 会 看 到 带 有 附属 "Join Filter" 以 及 纯 "Filter" 条 件 的 连接 计划 节点 。 连 
接 过 滤 条 件 来 自 于 外 部 连接 的 on 子 句 ， 因 此 这 样 的 行 失 败 了 ， 连 接 过 滤 条 件 仍 然 可 以 作为 
非 扩 展 行 发 出 。 但 一 个 纯 过 滤 条 件 可 以 在 外 连接 规则 之 后 被 应 用 因此 这 个 行为 无 条 件 地 删除 
行 。 在 内 连接 中 这 些 过 滤器 类 型 之 间 没 有 语义 差异 。 


如 果 我 们 改变 查询 的 选择 性 ， 我 们 可 能 会 得 到 一 个 非常 不 同 的 连接 计划 : 


EXPLAIN SELECT * 
FROM tenk1 t1, tenk2 t2 
WHERE t1.unique1 < 100 AND t1.unique2 = t2.unique2; 


QUERY PLAN 


Hash Join (cost=230.47..713.98 rows=101 width=488) 
Hash Cond: (t2.unique2 = t1.unique2) 


-> Seq Scan on tenk2 t2 (cost=0.00..445.00 rows=10000 width=244) 
-> Hash (cost=229.20..229.20 rows=101 width=244) 


-> Bitmap Heap Scan on tenki t1 (cost=5.07..229.20 rows=101 width=244) 
Recheck Cond: (unique1 < 100) 


-> Bitmap Index Scan on tenki_uniquei (cost=0.00..5.04 rows=101 width=0) 
Index Cond: (unique1 < 100) 


二 | 


在 这 里 ， 规 划 器 选择 使 用 一 个 哈 希 联 接 ， 表 中 的 行 被 输入 到 内 存 中 的 哈 希 表 中 ， 在 此 之 后 ， 
其 他 表 被 打 描 并 且 哈 希 表 进行 探测 以 匹配 每 一 行 。 再 次 注意 如 何 缩 进来 反映 规划 结构 : 

在 tenki 上 的 位 图 扫描 是 输入 到 哈 希 节点 ， 它 构造 哈 希 表 。 这 之 后 返回 哈 希 连接 节点 ， 其 内 
容 是 从 它 的 外 部 子 计划 中 读 取 每 一 行 并 且 搜 索 每 一 个 哈 希 表 。 


另 一 种 可 能 的 连接 类 型 是 合并 连接 ， 在 这 里 说 明 : 


EXPLAIN SELECT * 
FROM tenk1 t1, onek t2 
WHERE t1.unique1 < 100 AND t1.unique2 = t2.unique2; 


QUERY PLAN 


Merge Join (cost=198.11..268.19 rows=10 width=488) 
Merge Cond: (t1.unique2 = t2.unique2) 


-> Index Scan using tenki_unique2 on tenki t1 (cost=0.29..656.28 rows=101 width=244) 
Filter: (unique1 < 100) 


-> Sort (cost=197.83..200.33 rows=1000 width=244) 
Sort Key: t2.unique2 


-> Seq Scan on onek t2 (cost=0.00..148.00 rows=1000 width=244) 


4 -= LA 


合并 连接 要 求 其 输入 的 数据 在 连接 键 上 进行 排序 。 在 这 种 规划 中 tenki 数据 是 通过 使 用 索引 
扫描 访问 正确 顺序 的 行 来 进行 排序 。 但 顺序 扫描 和 排序 是 onek 的 首选 ， 因 为 有 该 表 上 被 访 
问 的 更 多 行 。 (顺序 扫描 和 排序 为 排序 行 数 而 频繁 进行 索引 扫描 ， 因 为 通过 索引 扫描 需要 不 
连续 的 磁盘 访问 ) 


找 另 外 一 个 规划 的 方法 是 通过 设置 每 种 规划 类 型 的 允许 /禁止 开关 (在 Section 18.7.1 里 描述 )， 
强制 规划 器 抛弃 它 认 为 优秀 的 (扫描 ) 策 略 。 这 个 工具 目前 比较 原始 ， 但 很 有 用 。 又 见 Section 
14.3。 例如 ， 如 果 我 们 不 相信 顺序 扫描 和 排序 对 于 前 面 例子 中 人 处理 表 onek 是 最 好 的 方式 ， 我 
们 可 以 尝试 


SET enable_sort = off; 


EXPLAIN SELECT * 
FROM tenk1 t1, onek t2 
WHERE t1.unique1 < 100 AND t1.unique2 = t2.unique2; 


QUERY PLAN 


Merge Join (cost=0.56..292.65 rows=10 width=488) 
Merge Cond: (t1.unique2 = t2.unique2) 


-> Index Scan using tenki_unique2 on tenki t1 (cost=0.29..656.28 rows=101 width=244) 
Filter: (unique1 < 100) 


-> Index Scan using onek_unique2 on onek t2 (cost=0.28..224.79 rows=1000 width=244) 


S| 





这 表明 规划 期 认为 通过 索引 扫描 排序 onek 比 顺 序 扫描 和 排序 更 昂贵 约 12%。 当然 ， 接 下 来 
的 问题 是 它 是 否 是 对 的 。 我 们 可 以 使 用 ExpLAIN ANALYZE 调查 ， 正 如 下 面 所 讨论 的 : 


14.1.2. EXPLAIN ANALYZE 


我 们 可 以 用 ExPLAIN 的 ANALYZE 检查 规划 器 的 估计 值 的 准确 性 。 这 个 命令 实际 上 执行 该 查询 
然后 显示 每 个 规划 节点 内 实际 运行 时 间 的 和 以 及 单纯 EXPLAIN 显示 的 估计 开销 。 比如 ， 我 们 
可 以 像 下 面 这 样 获取 一 个 结 


EXPLAIN ANALYZE SELECT * 
FROM tenk1 t1, tenk2 t2 
WHERE t1.unique1 < 10 AND t1.unique2 = t2.unique2; 


QUERY PLAN 
Nested Loop (cost=4.65..118.62 rows=10 width=488) (actual time=0.128..0.377 rows=10 loo 
-> Bitmap Heap Scan on tenki t1 (cost=4.36..39.47 rows=10 width=244) (actual time=0. 
Recheck Cond: (unique1 < 10) 
-> Bitmap Index Scan on tenki_unique1 (cost=0.00..4.36 rows=10 width=0) (actua 
Index Cond: (unique1 < 10) 
-> Index Scan using tenk2_unique2 on tenk2 t2 (cost=0.29..7.91 rows=1 width=244) (ac 
Index Cond: (unique2 = t1.unique2) 
Total runtime: 0.501 ms 


EE 
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请 注意 "actual time" 数 值 是 以 真实 时 间 的 毫秒 计 的 ， 而 cost 估计 和 值 是 以 任意 磁盘 抓 取 的 单元 
计 的 ; 因此 它们 很 可 能 不 一 致 。 我 们 要 关心 的 事 是 两 组 比值 是 否 一 致 。 通常 最 重要 的 事情 是 
看 是 否 估 计 行 数 相当 接近 于 现实 。 在 这 个 例子 中 ， 估计 都 是 完全 正确 的 ， 但 是 这 是 相当 不 寻 
常 的 做 法 。 


f—-ES QUE, AFAR] p ARRETA AR. lho, ELMER Ae, 

内 层 的 索引 打 描 对 每 个 外 层 行 执行 一 次 。 在 这 种 情况 下 ， loops 报告 该 节点 执行 的 总 数目 ， 

而 显示 的 实际 时 间 和 行 数目 是 每 次 执行 的 平均 值 。 这 么 做 的 原因 是 合 这 些 数字 与 开销 预计 显 
示 的 数字 具有 可 比 性 。 要 乘 以 loops 值 才 能 获得 在 该 节点 花费 的 总 时 间 。 在 上 面 的 例子 中 ， 
我 们 共 需 要 0.220 毫 秒 来 执行 tenk2 的 索引 扫描 。 


在 某 些 情况 下 EXPLAIN ANALYZE 显示 超出 规划 节点 执行 时 间 和 行 数 的 额外 执行 统计 数据 。 例 
如 ， 排 序 和 哈 希 节点 提供 额外 的 信息 : 


EXPLAIN ANALYZE SELECT * 


FROM tenk1 t1, tenk2 t2 
WHERE t1.unique1 < 100 AND t1.unique2 = t2.unique2 ORDER BY t1.fivethous; 


QUERY PLAN 
Sort (cost=717.34..717.59 rows=101 width=488) (actual time=7.761..7.774 rows=100 loops= 


Sort Key: t1.fivethous 
Sort Method: quicksort Memory: 77kB 
-> Hash Join (cost=230.47..713.98 rows=101 width=488) (actual time=0.711..7.427 rows 


Hash Cond: (t2.unique2 = t1.unique2) 
-> Seq Scan on tenk2 t2 (cost=0.00..445.00 rows=10000 width=244) (actual time= 


-> Hash (cost=229.20..229.20 rows=101 width=244) (actual time=0.659..0.659 row 


Buckets: 1024 Batches: 1 Memory Usage: 28kB 
-> Bitmap Heap Scan on tenki t1 (cost=5.07..229.20 rows=101 width=244) ( 


Recheck Cond: (unique1 < 100) 
-> Bitmap Index Scan on tenki_unique1 (cost=0.00..5.04 rows=101 wi 


Index Cond: (unique1 < 100) 
Total runtime: 8.008 ms 


i BR 
排序 节点 显示 使 用 的 排序 方法 〈 特 别 是， 排序 是 否 在 内 存 或 磁盘 上 ) URMBHA Rahm A 
空间 量 。 哈 希 节点 显示 哈 希 桶 数量 以 及 批 人 处 理 用 于 哈 希 表 的 内 存 峰值 数 。 (如 果 批 处 理 数 大 
于 1， 也 将 有 参与 磁盘 空间 使 用 情况 ， 但 不 在 这 显示 。 





另 一 种 类 型 的 附加 信息 是 通过 过 滤 条 件 删 除 行 数 : 


EXPLAIN ANALYZE SELECT * FROM tenk1 WHERE ten < 7; 


QUERY PLAN 


Seq Scan on tenk1 (cost=0.00..483.00 rows=7000 width=244) (actual time=0.016..5.107 row 


Filter: (ten < 7) 
Rows Removed by Filter: 3000 
Total runtime: 5.905 ms 


a 
这 些 计数 对 于 应 用 在 连接 节点 的 过 滤 条 件 特别 有 价值 。 "删除 行 " 只 出 现在 扫描 行 ， 或 者 连接 
节点 的 情况 下 的 潜在 连接 对 ， 通过 过 滤 条 件 被 拒绝 。 





类 似 的 情况 ， 过 滤 条 件 产生 "Ilossy" 的 索引 扫描 。 例如 ， 考 虑 多 边 形 这 个 搜索 包含 的 具体 点 : 


EXPLAIN ANALYZE SELECT * FROM polygon_tbl WHERE f1 @> polygon '(0.5,2.0)'; 


QUERY PLAN 
Seq Scan on polygon_tbl (cost=0.00..1.05 rows=1 width=32) (actual time=0.044..0.044 row 
Filter: (f1 @> '((0.5,2))'::polygon) 
Rows Removed by Filter: 4 
Total runtime: 0.083 ms 


‘| a: 








规划 器 认为 (很 正确 ) 这 种 表 太 小 而 干扰 索引 扫描 ， 所 以 我 们 有 一 个 纯 顺 序 扫描 ， 其 中 所 有 
行 通过 过 滤 条 件 被 拒绝 。 但 是 ， 如 果 我 们 强制 使 用 素 引 扫描 ， 我 们 看 到 : 


SET enable_seqscan TO off; 
EXPLAIN ANALYZE SELECT * FROM polygon_tbl WHERE f1 @> polygon '(0.5,2.0)'; 


QUERY PLAN 


Index Scan using gpolygonind on polygon_tbl (cost=0.13..8.15 rows=1 width=32) (actual t 
Index Cond: (f1 @> '((0.5,2))'::polygon) 
Rows Removed by Index Recheck: 1 

Total runtime: 0.144 ms 


[EE | 
在 这 里 ， 我 们 可 以 看 到 ， 索 引 


因为 GiST 索 引 对 于 多 边 形 封闭 测试 是 "lossy" : CEE 
我 们 在 那些 行 上 进行 确切 的 封闭 测试 。 








返回 一 个 候选 行 ， 这 是 通过 索引 条 件 的 重新 检查 被 拒绝 。 这 是 
际 上 返回 带 有 重生 目标 多 边 形 的 行 ， 然 后 


EXPLAIN 有 BUFFERS 选项 ， ANALYZE 以 获得 更 多 的 运行 时 间 统 计 : 


EXPLAIN (ANALYZE, BUFFERS) SELECT * FROM tenk1 WHERE uniquei < 100 AND unique2 > 9000; 


QUERY PLAN 
Bitmap Heap Scan on tenk1 (cost=25.08..60.21 rows=10 width=244) (actual time=0.323..0.3 
Recheck Cond: ((unique1 < 100) AND (unique2 > 9000)) 
Buffers: shared hit=15 
-> BitmapAnd (cost=25.08..25.08 rows=10 width=0) (actual time=0.309..0.309 rows=0 lo 
Buffers: shared hit=7 
-> Bitmap Index Scan on tenki1 unique1 (cost=0.00..5.04 rows=101 width=0) (actu 
Index Cond: (unique1 < 100) 
Buffers: shared hit=2 
-> Bitmap Index Scan on tenki_unique2 (cost=0.00..19.78 rows=999 width=0) (act 
Index Cond: (unique2 > 9000) 
Buffers: shared hit=5 
Total runtime: 0.423 ms 


Me 


通过 BuFFERS 提供 的 数字 帮助 辨识 查询 的 哪些 部 分 大 多 是 |/O 密 集 型 。 





请 记 住 ， 因 为 EXPLAIN ANALYZE 实际 运行 查询 ， 任何 副作用 还 是 一 样 会 发 生 ， 即 使 无 论 什么 结 
果 查 询 可 能 的 输出 都 将 被 丢弃 而 赞成 输出 ExPLAIN 的 数据 。 如 果 要 分 析 一 个 数据 修改 的 查 
询 ， 而 无 需 改变 你 的 表 ， 你 可 以 回 滚 命令 到 后 面 ， 例 如 : 


BEGIN; 
EXPLAIN ANALYZE UPDATE tenk1 SET hundred = hundred + 1 WHERE uniquei < 100; 


QUERY PLAN 
Update on tenk1 (cost=5.07..229.46 rows=101 width=250) (actual time=14.628..14.628 rows 
-> Bitmap Heap Scan on tenk1 (cost=5.07..229.46 rows=101 width=250) (actual time=0.1 
Recheck Cond: (unique1 < 100) 
-> Bitmap Index Scan on tenki1 unique1 (cost=0.00..5.04 rows=101 width=0) (actu 
Index Cond: (unique1 < 100) 
Total runtime: 14.727 ms 


ROLLBACK; 








如 该 示例 中 ， 当 查询 是 INSERT , uPDATE 或 者 DELETE 命令 时 ， 申请 表 变 化 的 实际 工作 是 由 项 
层 插 入 、 更 新 、 或 删除 规划 节点 完成 的 。 这 个 节点 下 的 规划 节点 进行 定位 旧 的 行 和 /或 计算 新 
数据 。 所 以 上 面 ， 我 们 看 到 了 已 经 看 到 的 相同 排序 的 位 表 打 描 ， 并 且 其 输出 被 传递 给 存储 更 
新 行 的 更 新 节点 。 值得 一 提 的 是 ， 虽 然 修 改 数据 的 节点 可 以 采取 大 量 的 运行 时 间 (在 这 里 ， 

它 消耗 了 大 部 分 的 共享 的 时 间 ) ， 规划 器 目前 不 添加 任何 东西 的 成 本 来 估计 说 明 这 项 工作 。 

这 是 因为 要 做 的 工作 是 同样 为 了 每 一 个 正确 的 查询 规划 ， 因此 它 不 影响 规划 决定 。 


EXPLAIN ANALYZE 显示 的 Total runtime 包括 执行 器 启动 和 关闭 的 时 间 ， 以 及 被 激发 的 任何 触 
发 器 运行 时 间 。 但 它 不 包括 分 析 、 重 写 、 规 划 的 时 间 。 执行 BEFORE 触发 器 花费 的 时 间 ， 如 果 
有 的 话 ， 包 括 在 为 相关 插入 ， 更 新 或 删除 节点 的 时 间 内 ， 但 执行 AFTER 触发 器 的 时 间 花 费 并 
不 计算 在 内 ， 因为 整个 规划 完成 之 后 ， 才 触发 AFTER 触发 器 。 单独 显示 每 个 触发 器 花费 的 总 
时 间 ( BEFORE 或 者 AFTER ) o 需要 注意 的 是 延迟 约束 触发 器 直到 事务 结束 将 不 会 执行 ， 


而 不 会 通过 EXPLAIN ANALYZE 显示 。 


14.1.3. 警告 


有 两 个 显著 方式 测量 运行 时 间 ， 通 过 EXPLAIN ANALYZE 偏离 相同 查询 的 正常 执行 。 首先 ， 由 
于 没有 输出 行 被 传递 到 客户 端 ， 不 包含 网 络 传输 成 本 和 1/O 转 换 费 用 。 其 次 ， 通 

过 EXPLAIN ANALYZE 增加 的 测量 开销 是 巨大 的 ， 特别 是 在 慢 的 gettimeofday() 操作 系统 调用 
机 器 上 。 您 可 以 使 用 pg test timing 工 具 来 测量 您 系统 上 的 定时 开销 。 


EXPLAIN 的 结果 除了 在 你 实际 测试 的 情况 之 外 不 能 推导 出 其 它 的 情况 ; 比如 ， 在 一 个 小 得 像 
玩具 的 表 上 的 结果 不 能 适用 于 大 表 。 规 划 器 的 开销 计算 不 是 线性 的 ， 因此 它 很 可 能 对 大 些 或 
者 小 些 的 表 选 择 不 同 的 规划 。 一 个 极端 的 例子 是 一 个 只 占据 一 个 磁 瘟 页 面 的 表 ， 在 这 样 的 表 
上 ， 不 管 它 有 没有 索引 可 以 使 用 ， 你 几乎 都 总 是 得 到 顺序 打 描 规划 。 规划 器 知道 不 管 在 任何 
情况 下 它 都 要 进行 一 个 磁盘 页 面 的 读 取 ， 所 以 再 扩大 几 个 磁盘 页 面 读 取 以 查找 索引 是 没有 意 
义 的 。 (我 们 可 以 从 polygon_tbl 上 面 的 例子 中 看 到 ) 


在 某 些 情 况 中 ， 实 际 与 估计 值 不 能 很 好 的 匹配 ， 但 没有 什么 是 真 的 错 了 。 出 现 这 样 的 一 个 情 
况 ， 当 规划 节点 执行 是 由 LIMIT 或 类 似 效果 而 短暂 停止 。 例 如 ， 我 们 以 前 使 用 LIMIT 查询 。 


EXPLAIN ANALYZE SELECT * FROM tenki WHERE unique1 < 100 AND unique2 > 9000 LIMIT 2; 


QUERY PLAN 


Limit (cost=0.29..14.71 rows=2 width=244) (actual time=0.177..0.249 rows=2 loops=1) 
-> Index Scan using tenki_unique2 on tenki (cost=0.29..72.42 rows=10 width=244) (act 
Index Cond: (unique2 > 9000) 
Filter: (unique1 < 100) 
Rows Removed by Filter: 287 
Total runtime: 0.336 ms 


‘ = 
为 索引 扫描 节点 的 估计 成 本 和 行 数 都 被 显示 。 即 使 它 是 运行 完毕 的 。 但 现实 是 请 求 行 运行 两 
个 之 后 限制 节点 停止 ， 所 以 实际 的 行 数 只 有 2 和 ， 并 且 运 行 时 间 低 于 成 本 估算 。 这 不 是 估计 代 
误 ， 由 于 只 有 一 个 差异 估计 和 真实 值 显示 。 








合并 连接 也 有 可 混淆 粗心 的 测量 产品 。 合并 连接 将 停止 读 取 一 个 输入 ， 如 果 它 用 尽 了 其 他 输 
入 ， 并 且 输 入 端的 下 一 个 关键 值 大 于 其 他 输入 的 最 后 一 个 关键 值 ; 在 这 种 情况 下 ， 就 不 可 能 
有 更 多 的 匹配 ， 所 以 不 需要 打 描 第 一 个 输入 的 其 余部 分 。 这 会 导致 无 法 读 取 所 有 子 节点 ， 有 
些 像 那些 提 到 的 vomit 结果 。 此 外 ， 如 果 外 部 (第 一 ) 子 节点 包含 重复 键 值 的 行 ， 内 部 (第 
IT) 子 节 点 被 各 份 并 重新 打 描 行 匹 配 键 值 的 部 分 。 EXPLAIN ANALYZE 计算 同一 内 部 行 的 重复 
部 分 ， 好 像 他 们 是 真正 的 附加 行 。 当 有 许多 外 部 重复 部 分 ， 为 了 内 部 子规 划 节 点 比 真实 内 部 
关系 行 数 足够 大 ， 则 报告 的 实际 行 数 。 


BitmapAnd 和 BitmapOr 节 点 总 是 报告 自己 的 实际 行 数 为 需 ， 由 于 实施 限制 。 


14.2. 规划 器 使 用 的 统计 信息 


就 像 我 们 在 上 一 节 里 展示 的 那样 ， 查 询 规划 器 需要 估计 一 个 查询 检索 的 行 数 ， 这 样 才能 选择 
正确 的 查询 规划 。 本 节 就 系统 用 于 这 些 估计 的 统计 进行 一 些 描述 。 


统计 的 一 个 部 分 就 是 每 个 表 和 索引 中 的 记录 总 数 ， 以 及 每 个 表 和 索引 占据 的 磁盘 块 数 。 这 个 
信息 保存 在 pg_class 表 的 reltuples 和 relpages 字段 中 。 我 们 可 以 用 类 似 下 面 的 查询 检索 


这 些 信 息 : 


SELECT relname, relkind, reltuples, relpages 
FROM pg_class 
WHERE relname LIKE 'tenk1%'; 


relname | relkind | reltuples | relpages 
二 Ed 生生 司 辣 二 呈 汪 呈 记 全 中 人 刁 本 和 
tenk1 | i | 10000 | 358 
tenk1i_hundred | at | 10000 | 30 
tenki_thous_tenthous | i | 10000 | 30 
tenk1_unique1 | i | 10000 | 30 
tenk1i_unique2 | | 10000 | 30 


(5 rows) 


我 们 在 这 里 可 以 看 到 tenk1 有 10000 行 ， 它 的 索引 也 有 这 么 多 行 ， 但 是 索引 远 比 表 小 得 多 (很 
正常 )。 


出 于 效率 考虑 ， reltuples 和 relpages 不 是 实时 更 新 的 ， 因此 它们 通常 包含 可 能 有 些 过 时 
的 数值 。 它 们 被 vacuum, ANALYZE 和 几 个 DDL 命 令 (比如 create INDEX ) 更 新 。 VACUUM 或 

者 analyze 操作 不 扫描 整个 表 (这 是 常见 的 情况 ) ， 将 逐步 基于 扫描 表 的 部 分 更 

新 reltuples 数 ， 从 而 产 生 一 个 近似 值 。 在 任何 情况 下 ， 规划 器 将 把 pg_class 表 里 面 的 数值 
调整 为 和 当前 的 物理 表 尺 寸 匹 配 ， 以 此 获取 一 个 更 接近 的 近似 值 。 


大 多 数 查询 只 是 检索 表 中 行 的 一 部 分 ， 因 为 它们 有 限制 待 查 行 的 whERE 子 句 。 因此 规划 器 需 
要 对 wHERE 子 句 的 选择 性 进行 评估 ， 选择 性 也 就 是 符合 were 子 句 中 每 个 条 件 的 部 分 。 用 于 
这 个 目的 的 信息 存储 在 pg statistic 系统 表 中 。 在 pg_statistic 中 的 记录 是 

由 ANALYZE 和 vacuum ANALYZE 命令 更 新 的 ， 并 且 总 是 近似 值 ， 即 使 刚刚 更 新 完 也 不 例外 。 


除了 直接 查看 pg_statistic 之 外 ， 我 们 手工 检查 统计 的 时 候 最 好 查看 po stats 的 视图 。 
pg_stats 被 设计 成 更 容易 可 读 的 。 而 且 ， pg_stats 是 所 有 人 都 可 以 读 取 的 ， 

而 pg_statistic 只 能 由 超级 用 户 读 取 。 这 样 就 可 以 避免 非特 权 用 户 从 统计 信息 中 获取 一 些 和 
其 他 人 的 表 内 容 相关 的 信息 。 pg_stats 视图 是 受 约束 的 ， 只 显示 当前 用 户 可 读 的 表 。 比 如 ， 
我 们 可 以 : 


SELECT attname, inherited, n_distinct, 
array_to_string(most_common_vals, E'\n') as most_common_vals 

FROM pg_stats 

WHERE tablename = 'road'; 


attname | inherited | n_distinct most_common_vals 


3 RR eae 
name | Ff | -0.363388 | I- 580 Ramp+ 
| | | I- 880 Ramp+ 
| | | Sp Railroad + 
| | | I- 580 + 
| | | I- 680 Ramp 
name [| 42 | -0.284859 | I- 880 Ramp+ 
| | | I- 580 Ramp+ 
| | | I- 680 Ramp+ 
| | | I- 580 + 
| | | State Hwy 13 Ramp 
(2 rows) 


需要 注意 的 是 两 行 显示 为 同一 列 ， 1 对 应 在 road 表 ( inherited = t ) 开 头 的 完整 继承 层次 结 
构 。 而 另 一 个 只 包含 road 表 本 身 ( inherited = f )。 


在 pg_statistic 中 通过 ANALYzE 存储 的 信息 的 数量 ， 特别 是 给 每 个 字段 用 

的 most_common_vals 和 histogram_bounds 数组 上 的 最 大 记录 数目 可 以 

用 ALTER TABLE SET STATISTICS 命令 设置 ， 或 者 是 用 运行 时 参数 default_statistics_target 进 行 
全 局 设置 。 目前 缺 省 的 限制 是 100 个 记录 。 提升 该 限制 应 该 可 以 做 出 更 准确 的 规划 器 估计 ， 
特别 是 对 那些 有 不 规则 数据 分 布 的 字段 而 言 ， 代价 是 在 pg_statistic 里 使 用 了 更 多 空间 ， 并 
且 需 要 略微 多 一 些 的 时 间 计算 估计 数值 。 相 比 之 下 ， 比较 低 的 限制 可 能 更 适合 那些 数据 分 布 
比较 简单 的 字段 。 


有 关 规 划 器 使 用 统计 信息 的 进一步 详情 可 参阅 Chapter 60。 


14.3. 用 明确 的 JOIN 控制 规划 器 


我 们 可 以 在 一 定 程 度 上 用 明确 的 somn 语法 控制 查询 规划 器 。 要 明白 为 什么 有 这 差事 ， 我们 


首先 需要 一 些 背 景 知识 。 


在 简单 的 连接 查询 里 ， 比 如 : 


SELECT * FROM a, b, c WHERE a.id = b.id AND b.ref = c.id; 


规划 器 可 以 按照 任何 顺序 自由 地 连接 给 出 的 表 。 比 如 ， 它 可 以 生成 一 个 查询 规划 先 

用 where 条 件 a.id = b.id 把 A 连 接 到 B ， 然 后 用 另外 一 个 wer 条 件 把 C 连接 到 这 个 表 上 
来 ， 或 者 也 可 以 先 连接 B 和 C 然后 再 连接 和 人， 同样 得 到 这 个 结果 。 或 者 也 可 以 连接 人 到 C 
然后 把 结果 与 B 连接 一 不 过 这 么 做 效率 比较 差 。， 因为 必须 生成 完整 的 入 和 C 的 迪 卡 尔 积 ， 

而 在 查询 里 没有 可 用 的 wer 子 句 可 以 优化 该 连接 (PostgreSQL 执 行 器 里 的 所 有 连接 都 发 生 在 
两 个 输入 表 之 间 ， 所 以 在 这 种 情况 下 它 必须 先 得 出 一 个 结果 )。 重 要 的 一 点 是 这 些 连 接 方 式 给 
出 语义 上 相同 的 结果 ， 但 在 执行 开销 上 却 可 能 有 巨大 的 差别 。 因 此 ， 规 划 器 会 对 它们 进行 检 
查 并 找 出 最 高 效 的 查询 规划 。 


如 果 查 询 只 涉及 两 或 三 个 表 ， 那 么 在 查询 里 不 会 有 太 多 需要 考虑 的 连接 。 但 是 潜在 的 连接 顺 
序 的 数目 随 着 表 数 目的 增加 程 指数 增加 的 趋势 。 当 超 过 十 个 左右 的 表 以 后 ， 实 际 上 根本 不 可 
能 对 所 有 可 能 做 一 次 穷 举 搜索 ， 甚至 对 六 七 个 表 都 需要 相当 长 的 时 间 进 行规 划 。 如 果 有 太 多 
输入 的 表 ， PostgreSQL 规 划 器 将 从 穷 举 搜索 切换 为 基因 概率 搜索 ， 以 减少 可 能 性 数目 ( 祥 本 
空间 )。 切换 的 阔 值 是 用 运行 时 参数 geqo_threshold 设 置 的 。 基 因 搜 索 花 的 时 间 少 ， 但 是 并 不 
一 定 能 找到 最 好 的 规划 。 


当 查 询 涉及 外 部 连接 时 ， 规 划 器 就 不 像 对 付 普通 (内 部 ) 连 接 那么 自由 了 。 比 如 ， 看 看 下 面 这 个 
查询 : 


SELECT * FROM a LEFT JOIN (b JOIN c ON (b.ref = c.id)) ON (a.id = b.id); 


尽管 这 个 查询 的 约束 和 前 面 一 个 非常 相似 ， 但 它们 的 语义 却 不 同 ， 因为 如 果 A 里 有 任何 一 行 
不 能 匹配 B 和 C 的 连接 里 的 行 ， 那 么 该 行 都 必须 输出 。 因 此 这 里 规划 器 对 连接 顺序 没有 什么 选 
择 : 它 必须 先 连接 B 到 C ， 然 后 把 A 连接 到 该 结果 上 。 因 此 ， 这 个 查询 比 前 面 一 个 花 在 规 
划 上 的 时 间 少 。 在 其 它 情况 下 ， 规 划 器 就 有 可 能 确定 多 种 连接 顺序 都 是 安全 的 。 上 比如 ， 对 于 : 


SELECT * FROM a LEFT JOIN b ON (a.bid = b.id) LEFT JOIN c ON (a.cid = c.id); 


将 A 首先 连接 到 B 或 C 都 是 有 效 的 。 当 前 ， 只 有 FULL son 完全 强制 连接 顺序 。 KS 
ŽU LEFT JOIN 或 者 RIGHT JOIN 都 可 以 在 某 种 程度 上 重新 排列 。 


明确 的 连接 语法 ( INNER JOIN , CROSS JOIN 或 无 修饰 的 sorn iS LEA FRoM 中 列 出 输入 关系 
是 一 样 的 ， 因此 我 们 没有 必要 约束 连接 顺序 。 


即使 大 多 数 JorN 并 不 完全 强迫 连接 顺序 ， 但 仍然 可 以 明确 的 告诉 PostgreSQL 查询 规划 
器 JOIN 子 句 的 连接 顺序 。 比如 ， 下 面 三 个 查询 逻辑 上 是 等 效 的 : 


SELECT * FROM a, b, c WHERE a.id = b.id AND b.ref = c.id; 
SELECT * FROM a CROSS JOIN b CROSS JOIN c WHERE a.id = b.id AND b.ref = c.id; 
SELECT * FROM a JOIN (b JOIN c ON (b.ref = c.id)) ON (a.id = b.id); 


但 如 果 我 们 告诉 规划 器 遵循 JoIN 的 顺序 ， 那 么 第 二 个 和 第 三 个 还 是 要 比 第 一 个 花 在 规划 上 的 
时 间 少 。 这 个 作用 对 于 只 有 三 个 表 的 连接 而 言 是 微不足道 的 ， 但 对 于 数目 众多 的 表 ， 可 能 就 
是 救命 稻草 了 。 


要 强制 规划 器 遵循 准确 的 JorN 连接 顺序 ， 我 们 可 以 把 运行 时 参数 join_collapse_ limit 设置 为 
1( 其 它 可 能 的 数值 在 下 面 讨 论 )。 


你 完全 不 必 为 了 缩短 搜索 时 间 来 约束 连接 顺序 ， 因 为 在 一 个 简单 的 FRoM 列表 里 使 用 Jon 操 
作 符 就 很 好 了 。 比如 考虑 : 


SELECT * FROM a CROSS JOIN b, c, d, e WHERE ...; 


如 果 设 置 join_collapse_limit = 1， 那 么 这 句 话 就 相当 于 强迫 规划 器 先 把 A 连接 到 B ， 然后 
再 连接 到 其 它 的 表 上 ， 但 并 不 约束 其 它 的 选择 。 在 本 例 中 ， 可 能 的 连接 顺序 的 数目 减少 了 5 


倍 。 


按照 上 面 的 想法 考虑 规划 器 的 搜索 问题 是 一 个 很 有 用 的 技巧 ， 不 管 是 对 减少 规划 时 间 还 是 对 
引导 规划 器 生成 好 的 规划 都 很 有 帮助 。 如 果 人 缺 省 时 规划 器 选择 了 一 个 糟糕 的 连接 顺序 ， 你 可 
以 用 Jorm 语法 强迫 它 选择 一 个 更 好 的 一 (假设 知道 一 个 更 好 的 顺序 )。 所 以 我 们 建议 多 试验 。 


一 个 非常 相近 的 影响 规划 时 间 的 问题 是 把 子 查询 压缩 到 它们 的 父 查 询 里 面 。 比 如 ， 考 虑 下 面 
的 查询 : 


SELECT * 
FROM x, y, 

(SELECT * FROM a, b, c WHERE something) AS ss 
WHERE somethingelse; 


这 个 情况 可 能 在 那 种 包含 连接 的 视图 中 出 现 ; 该 视图 的 SELECT 规则 将 被 插入 到 引用 视图 的 场 
A, 生成 非常 类 似 上 面 的 查询 。 通 常 ， 规 划 器 会 试图 把 子 查询 压缩 到 父 查 询 里 ， 生 成 : 


SELECT * FROM x, y, a, b, c WHERE something AND somethingelse; 


这 样 通常 会 生成 一 个 比 独 立 的 子 查询 更 好 些 的 规划 。 比 如 ， 外 层 的 where 条 件 可 能 先 把 X 连 
接 到 A 上 ， 这 样 就 消除 了 A 中 的 许多 行 ， 因此 避免 了 形成 全 部 子 查询 逻辑 输出 的 需要 。 但 是 
同时 ， 我 们 增加 了 规划 的 时 间 ; 在 这 里 ， 我 们 有 一 个 用 五 路 连接 代 蔡 两 个 独立 的 三 路 连接 的 
问题 ， 这 样 的 差距 是 巨大 的 ， 因为 可 能 的 规划 数 的 是 按照 指数 增长 的 。 规 划 器 将 在 父 查询 可 
能 超过 from_collapse_limit 个 FROM 项 的 时 候 ， 不 再 压缩 子 查 询 ， 以 此 来 避免 巨大 的 连接 搜 
RA, 你 可 以 通过 调整 这 个 运行 时 参数 来 在 规划 时 间 和 规划 质量 之 间作 出 平衡 。 


from_collapse_limit 和 join_collapse_limit 名 字 类 似 是 因 为 他 们 做 的 事情 几乎 相同 : 一 个 控制 规 
划 器 何 时 把 子 查询 "平面 化 "， 另外 一 个 控制 何 时 把 明确 的 连接 平面 化 。 通 常 ， 你 要 么 

把 join_collapse_limit 设置 成 和 from_collapse_limit 一 样 (明确 连接 和 子 查询 的 行为 类 似 )， 
要 么 把 join_collapse_limit 设置 为 1( 如 果 你 想 用 明确 连接 控制 连接 顺序 )。 但 是 你 可 以 把 它 
们 设置 成 不 同 的 值 ， 这 样 你 就 可 以 在 规划 时 间 和 运行 时 间 之 间 进 行 仔细 的 调节 。 


14.4. 向 数据 库 中 添加 记录 


第 一 次 填充 数据 库 时 可 能 需要 做 大 量 的 表 插 入 。 下 面 是 一 些 建议 ， 可 以 尽 可 能 高 效 地 处 理 这 
些 事 情 。 


14.4.1. 天 闭 目 动 提交 


当 使 用 多 条 INSERT 时 ， 关 闭 自动 提交 ， 并 且 只 在 每 次 (数据 拷贝 ) 结 束 的 时 候 做 一 次 提交 。 在 
纯 SQL 里 ， 这 就 意味 着 在 开始 的 时 候 发 出 BE6IN 并 且 在 结束 的 时 候 执 行 commIT 。 有 些 客户 

端的 库 可 能 背 着 你 干 这 些 事情 ， 这 种 情况 下 你 必须 确信 只 有 在 你 确实 要 那些 库 干 这 些 事情 的 
时 候 它 才 做 。 如 果 你 允许 每 个 插入 都 独立 地 提交 ， 那 么 PostgreSQL 会 为 所 增加 的 每 行 记录 做 
大 量 的 处 理 。 在 一 个 事务 里 完成 所 有 插入 的 动作 的 最 大 的 好 你 就 是 ， 如 果 有 一 条 记录 插入 失 
m, 那么 ， 到 该 点 为 止 的 所 有 已 插入 记录 都 将 被 回 滚 ， 这 样 你 就 不 会 很 难受 地 面 对 一 个 只 装 
载 了 一 部 分 数据 的 表 。 


14.4.2. 使 用 coPY 


使 用 COPY 在 一 条 命令 里 装载 所 有 记录 ， 而 不 是 一 连 串 的 insert HD. copy 命令 是 为 装载 
数量 巨大 的 数据 行 优化 过 的 ; 它 没 insert 那么 灵活 ， 但 是 在 大 量 装 载 数据 的 情况 下 ， 导 致 的 
荷载 也 少 很 多 。 因为 coy 是 单条 命令 ， 因 此 填充 表 的 时 候 就 没有 必要 关闭 自动 提交 了 。 


如 果 你 不 能 使 用 copy ， 那 么 使 用 PREPARE 来 创建 一 个 预备 insert, 然后 使 用 execute 多 
次 效率 更 高 。 这 样 就 避免 了 重复 分 析 和 规划 INsERT 的 开销 。 不 同 的 接口 提供 便利 的 方式 不 
Al; 查看 接口 文档 的 "已 准备 语句 "。 


请 注意 ， 在 装载 大 量 数据 行 的 时 候 ， copy 几乎 总 是 比 insert 快 ， 即使 使 用 了 prepare 并 且 
把 多 个 INSERT 命 合 绑 在 一 个 事务 中 也 是 这 样 。 


当 在 相同 事务 中 作为 较 早 的 CREATE TABLE 或 者 TRUNCATE 命令 使 用 的 时 候 ， copy 是 最 快 的 。 
在 这 种 情况 下 ， 没 有 WAL 需要 写 入 ， 因 为 在 错误 情况 下 ， 这 些 文件 包含 新 加 载 的 数据 将 被 删 
除 。 然而 ， 这 种 考虑 只 适用 于 当 所 有 命令 必须 写 WAL 时 ，Wwal level 是 最 小 的 o 


14.4.3. 删除 索引 


如 果 你 正在 装载 一 个 新 创建 的 表 ， 最 快 的 方法 是 创建 表 ， 用 cov 批量 装载 ， 然 后 创建 表 需 
要 的 任何 索引 。 在 已 存在 数据 的 表 上 创建 索引 要 比 递增 地 更 新 所 装载 的 每 一 行 记录 要 快 。 


如 果 你 对 现 有 表 增 加 大 量 的 数据 ， 可 能 先 删除 索引 ， 装 载 表 ， 然后 重新 创建 索引 更 快 些 。 当 
然 ， 在 缺少 素 引 的 期 间 ， 其 它 数 据 库 用 户 的 数据 库 性 能 将 有 负面 的 影响 。 并 且 我 们 在 删除 唯 
一 索引 之 前 还 需要 仔细 考虑 清楚 ， 因 为 唯一 约束 提供 的 错误 检查 在 缺少 索引 的 时 候 会 消失 。 


14.4.4. 删除 外 键 约束 


和 索引 一 样 ，" 批 量 地 "检查 外 键 约 束 比 一 行 行 检 查 更 高 效 。 因 此 ， 也 许 我 们 先 删除 外 键 约束 ， 
装载 数据 ， 然 后 重建 约束 会 更 高 效 。 同 样 ， 装 载 数据 和 缺少 约束 而 失去 错误 检查 之 间 也 有 一 
个 平衡 。 


更 重要 的 是 ， 当 你 将 数据 加 载 到 已 有 外 键 约束 的 表 中 的 时 候 ， 每 个 新 行 需 要 等 待 触发 事件 的 
服务 器 列表 中 的 项 (因为 它 是 触发 器 的 触发 ， 检 查 行 的 外 键 约束 ) 。 装载 数 以 百 万 计 的 行 可 
以 引起 触发 事件 队列 洽 出 可 用 内 存 ， 导 致 无 法 忍受 的 交换 ， 甚至 命令 的 彻底 失败 。 因 此 它 可 
能 是 必要 的 ， 不 只 是 理想 的 ， 当 加 载 大 量 数 据 的 时 候 ， 删除 并 且 重 新 申请 外 键 约束 。 如 果 暂 
时 删除 约束 是 不 能 接受 的 ， 唯一 的 其 他 资源 可 能 会 将 负载 操作 分 裂 为 更 小 的 事务 。 


14.4.5. 增 大 maintenance work mem 


在 装载 大 量 的 数据 的 时 候 ， 临 时 增 大 maintenance_work_mem 配 置 变量 可 以 改进 性 能 。 这 个 
参数 也 可 以 帮助 加 速 CREATE INDEX 和 ALTER TABLE ADD FOREIGN KEY 命令 。 它 不 会 对 copy 本 


身 有 多 大 作用 ， 所 以 这 个 建议 只 有 在 你 使 用 上 面 的 两 个 技巧 时 才 有 效 。 


14.4.6. 增 大 checkpoint_segments 


临时 增 大 checkpoint_segments 配 置 变量 也 可 以 让 大 量 数据 装载 得 更 快 。 这 是 因为 向 
PostgreSQL 里 面 装 寺 载 大 量 的 数据 可 以 导致 检查 点 操作 (由 配置 变量 checkpoint_timeout 声明 ) 
比 平常 更 加 频繁 发 生 。 在 发 生 一 个 检查 点 的 时 候 ， 所 有 脏 数 据 都 必须 刷新 到 磁盘 上 。 通过 在 
大 量 数据 装 蔷 载 的 时 候 临 时 增加 checkpoint_segments , 所 要 求 的 检查 点 的 数目 可 以 减少 。 


14.4.7. 禁用 WAL 当 档 和 流 复 制 


当 加 载 大 量 数据 到 使 用 WAL 为 档 或 流 复制 的 安装 过 程 时 ， 加 载 完 成 之 后 采取 新 的 基础 各 份 比 
处 理 大 量 增 量 WAL 数 据 可 能 会 更 快 。 当 加 载 时 为 防止 增 量 WAL 日 志 ， 关 闭 为 档 和 流 复制 ， 通 
过 设置 wal_level 到 最 小 ，archive_mode 到 off , max_wal_senders 为 需 。 但 是 请 注意 ， 更 


改 这 些 设置 需要 重新 启动 服务 器 。 


除了 为 轨 档 或 者 WAL 发 送 处 理 WAL 数 据 来 避免 时 间 ， 这 样 做 实际 上 将 使 某 些 命令 更 快 ， 因 为 
如 果 wal level 是 最 小 的 ， 他 们 设计 不 写 WAL (他 们 可 以 保证 碰撞 安全 性 最 后 通过 fsync Lb 
写 WAL 更 便宜 ) 。 这 适用 于 以 下 命令 : 


e CREATE TABLE AS SELECT 
e CREATE INDEX (正如 ALTER TABLE ADD PRIMARY KEY ) 
® ALTER TABLE SET TABLESPACE 


@ CLUSTER 


e copy FROM ， 当 目标 表 在 同一 事务 之 前 已 经 被 创建 或 截断 。 


14.4.8. 事后 运行 ANALYZE 


不 管 什 么 时 候 ， 如 果 你 在 更 新 了 表 中 的 大 量 数据 之 后 ， 运 行 ANALYZE 都 是 个 好 习惯 。 这 包含 
大 量 加 载 数据 到 表 。 运 行 ANALYZE (或 者 vacuum ANALYZE ) 可 以 保证 规划 器 有 表 数 据 的 最 新 统 
it. 如 果 没 有 统计 数据 或 者 统计 数据 太 陈 旧 ， 那 么 规划 器 可 能 选择 很 差劲 的 查询 规划 ， 导致 
表 的 错误 或 者 不 存在 数据 的 性 能 恶化 。 请 注意 如 果 和 启动 autovacuum 守 护 进程 ， 可 能 自动 运 
行 ANALYZE ; 获取 详情 请 参阅 Section 23.1.3 和 Section 23.1.6。 


14.4.9. pg_dump 的 一 些 注 意 事项 


pgdump 生 成 的 转 储 脚本 自动 使 用 上 面 的 若干 个 技巧 ， 但 不 是 全 部 。 要 尽 可 能 快 地 装载 
p9_dump 转 储 ， 我 们 需要 手工 做 几 个 事情 。 请 注意 ， 这 些 要 点 适用 于 恢复 一 个 转 储 ， 而 不 是 
创建 一 个 转 储 的 时 候 。 同样 的 要 点 也 适用 于 使 用 psql 或 者 pg_restore 从 pg_dump 为 档 文 件 装 
载 文本 复制 的 时 候 。 


缺 省 的 时 候 ，pg_dump 使 用 coPy ， 在 它 生 成 一 个 完整 的 模式 和 数据 的 转 储 的 时 候 ， 它 会 很 
小 心地 先 装载 数据 ， 然 后 创建 索引 和 外 键 。 因 此 ， 在 这 个 情况 下 ， 头 几 条 技巧 是 自动 处 理 
的 。 剩余 的 是 你 要 做 的 : 


. 设置 比 正常 状况 大 的 maintenance_work_mem 和 checkpoint_segments 值 。 


。 如 果 使 用 WAL 愉 档 或 流 复制 ， 可 以 考虑 在 恢复 过 程 中 禁用 他 们 。 要 做 到 这 一 点 ， 设 
i@ archive_mode 4 off, wal level 为 最 小 的 ， 并 且 设 置 max_wal_senders 在 装载 前 为 
需 。 随 后 ， 设 置 它们 返回 正确 的 值 ， 并 采取 新 的 基础 备份 。 


e 使 用 pg_dump 和 和 pg_restore 并 行 转 储 和 恢复 两 种 模式 的 实验 ， 并 找到 并 行 作业 使 用 的 最 
佳 数 目 。 平 行 转 储 和 恢复 通过 -j 选项 应 提供 给 你 串 行 模式 中 的 更 高 的 性 能 。 


。 考虑 整个 转 鱼 是 否 应 作为 单个 事务 进行 恢复 。 要 做 到 这 一 点 ， 通 过 -1 或 者 
-single-transaction 命令 行 选项 的 psql 或 者 pg_restore。 当 使 用 此 模式 时 ， 即 使 是 最 小 
的 误差 将 回 滚 整 个 恢复 ， 可 能 丢弃 很 多 时 间 的 处 理 。 取决 于 如 何 相互 关联 数据 ， 这 可 能 
最 好 是 手动 清理 或 者 没有 。 如 果 你 使 用 单一 事务 并 且 WAL 为 档 关 闭 ， 则 copy 命令 将 运行 
速度 最 快 。 


e。 如 果 在 数据 库 服务 器 中 有 多 个 CPU， 可 以 考虑 使 用 pg_restore 的 -jobs 选项 。 这 人 允许 并 
发 数据 加 载 和 索引 的 创建 。 


e 之 后 运行 ANALYZE o 
只 保存 数据 的 转 储 仍然 会 使 用 coPy ， 但 是 它 不 会 删除 或 者 重建 索引 ， 并 且 它 不 会 自动 修改 
外 键 。 [1] 因此 当 装 载 只 有 数据 的 转 储 时 候 ， 如 果 你 想 使 用 这 些 技术 ， 删 除 以 及 重建 索引 和 外 
键 完全 取决 于 你 。 当 加 载 数据 时 ， 增 大 checkpoint_segments 仍然 是 有 用 的 ， 但 是 替 


大 maintenance_work_mem 就 没什么 必要 了 ; 相反 ， 你 只 是 应 该 在 事后 手工 创建 素 引 和 外 键 ， 
最 后 结束 时 不 要 忘记 ANALYZE HPT. 2H Section 23.1.3 和 Section 23.1.6 获 取 更 多 详情 。 


Notes 


[1] 你 可 以 通过 使 用 -disable-triggers 选项 的 方法 获取 关闭 外 键 的 效果 。 不 过 要 意识 到 这 么 
做 是 消除 ， 而 不 只 是 推迟 违反 外 键 约束 ， 因此 如 果 你 使 用 这 个 选项 ， 将 有 可 能 插入 坏 数 据 。 


14.5. 非 持久 性 设置 


持久 性 是 数据 库 的 功能 ， 即 使 服务 器 崩溃 或 电源 断 电 保证 已 提交 事务 的 记录 。 然而 ， 持 久 性 
显著 增加 了 数据 库 的 开销 ， 所 以 如 果 你 的 网 站 并 不 需要 这 样 的 保证 ， PostgreSQL 可 以 被 配 
置 保证 运行 更 加 快速 。 以 下 是 配置 变化 ， 可 以 在 这 种 情况 下 提高 性 能 。 除 下 文 所 述 外 ， 持 久 
性 仍然 可 以 在 数据 库 软 件 的 骨 溃 的 情况 下 得 到 保证 ， 只 是 突然 操作 系统 停止 造成 数据 丢失 的 
风险 或 当 使 用 这 些 设置 时 的 崩溃 。 


将 数据 库 集 群 的 数据 目录 放 在 内 存 支 持 的 文件 系统 中 〈 即 RAM 磁 盘 ) 。 这 消除 了 所 有 数 
据 库 磁盘 MO， 但 限制 可 用 内 存 (也 许 交 换 ) 的 数据 存储 量 。 


关闭 fsync ; RAVE PRS Ate & AH. 


关闭 full_page_writes ; 避免 部 分 页 面 守 入 没有 必要 。 增加 checkpoint _ segments 和 
checkpoint timeout ; 这 减少 了 检查 点 频率 ， 但 是 增加 了 /pg_xlog 的 存储 需求 。 


关闭 synchronous_commit ; 这 可 能 没有 必要 在 每 次 提交 时 将 WAL 写 入 和 磁盘。 这 个 设置 确 
实在 只 有 database 崩 淡 的 情况 下 增加 了 事务 丢失 的 风险 (尽管 没 


数据 崩溃 ) o 


II. 服务 器 管理 


这 部 分 履 盖 的 内 容 是 那些 PostgreSQL 数据 库 管理 员 感 兴趣 的 东西 。 包括 安装 软件 、 设 置 和 
配置 服务 器 、 管 理 用 户 和 数据 库 、 日 常 维护 任务 。 任何 运行 PostgreSQL 服务 器 的 人 ， 尤 其 
是 生产 环境 中 的 使 用 者 ， 都 应 该 熟悉 这 部 分 中 讨论 的 内 容 。 


本 部 分 的 信息 大 致 上 是 按照 一 个 新 用 户 的 阅读 顺序 进行 安排 的 。 但 是 每 个 章节 都 是 自 包含 
的 ， 可 以 独立 阅读 。 本 部 分 信息 是 以 主题 单元 按照 陈述 风格 排列 的 。 如 果 读 者 需要 查看 特定 
命 今 的 完整 描述 ， 那 么 应 该 看 看 Part Vi. 


头 几 章 编写 的 风格 是 让 那些 没 ee ge 懂 ， 这 样 那些 需要 架设 自己 的 服务 器 
的 新 读者 就 可 以 直接 开始 浏览 这 部 分 了 它 部 分 是 有 关 调 节 和 管理 的 ， 这 部 分 的 材料 是 假 
设 读者 是 那些 经 常 使 用 PostgreSQL aan 的 读者 应 该 熟悉 的 东西 。 我 们 鼓励 读者 阅读 
Part | 和 Part Il 获取 额外 的 信息 。 
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本 章 讲 述 了 如 何 从 源 代码 安装 PostgreSQL。 如 果 你 安装 的 是 预 打包 的 版 本 ， 比 如 RPM 或 者 
Debian 包 ， 那么 略 过 这 一 章 并 阅读 打包 的 开发 人 员 的 指导 。 


15.1. fa hk 


./configure 

gmake 

su 

gmake install 

adduser postgres 

mkdir /usr/local/pgsql/data 

chown postgres /usr/local/pgsql/data 

su - postgres 

/usr/local/pgsql/bin/initdb -D /usr/local/pgsql/data 
/usr/local/pgsql/bin/postgres -D /usr/local/pgsql/data >logfile 2>&1 & 
/usr/local/pgsql/bin/createdb test 
/usr/local/pgsql/bin/psql test 


全 版 是 本 章 剩 余 的 部 分 。 


15.2. 要 求 


一 般 说 来 ， 一 个 现代 的 与 Unix 兼容 的 平台 应 该 就 能 运行 PostgreSQL。 Section 15.6 列 出 了 到 
发 布 为 止 已 经 明确 测试 过 的 平台 。 在 发 布 的 doc 子 目录 里 面 有 许多 平台 相关 的 FAQ， 如 果 你 
磋 到 问题 你 可 能 会 需要 参考 它们 。 


编译 PostgreSQL 需 要 下 面 几 样 东西 : 


。 需要 GNU make 的 3.80 版 本 或 者 更 新 版 本 ; 不 能 使 用 其 它 make 程序 或 者 老 版 本 的 
GNUmake。 GNU make 常 被 安装 为 gmake 的 名 字 。 本 文档 将 一 直 使 用 这 个 名 字 称 呼 它 
(在 一 些 系统 上 GNUmake 是 名 字 叫 make 的 缺 省 工具 )。 要 想 测 试 GNUmake， 敲 入 : 


&lt;kbd class="literal"&gt;gmake --version&lt;/kbd&gt; 


e 一 个 ISO/ANSI C 编 译 器 (至 少 C89- 标 准 ) 。 我 们 推荐 使 用 最 近 版 本 的 GCC。 不 过 ， 众 
所 周知 的 是 PostgreSQL 可 以 利用 许多 不 同 厂商 的 不 同 编译 器 进行 编译 。 


。 除了 gzip 或 者 bzip2 之 外 ， 还 需要 tar 来 解 开 发 布 。 


。 缺 省 时 将 自动 使 用 GNU Readline 库 它 人 允许 psql (PostgreSQL 命 命 行 SQL 解 释 器 ) 记 住 
每 个 键入 的 命令 ， 并 人 允许 你 使 用 箭头 键 来 调用 和 编辑 以 前 的 命令 。 这 是 非常 有 帮助 的 ， 
强烈 推荐 。 如 果 你 不 想 用 它 ， 那么 你 必需 给 configure 声明 --without-readline 选项 。 
作为 替代 ， 你 可 以 经 常 使 用 BSD 许 可 libedit 的 库 ， 最 初 在 NetBSD 上 开发 的 。 如 果 没 
有 发 现 libreadline ， 或 者 如 果 为 configure 指定 --with-libedit-preferred , 可 以 使 用 
与 GNU Readline 兼 容 的 libedit 库 。 如 果 你 使 用 的 是 一 个 基于 包 的 Linux 发 布 ， 那 么 要 
注意 你 需要 readline 和 readline-devel 两 个 包 ， 特别 是 如 果 这 两 个 包 在 你 的 版 本 里 是 
分 开 的 时 候 。 


。 缺 省 的 时 候 和 将 使 用 zlib 压 缩 库 。 如 果 你 不 想 使 用 它 ， 那么 你 必须 给 configure = 
AA --without-zlib 选项 。 使 用 这 个 选项 关闭 了 在 pg_dump 和 pg_restore 里 面 压 缩 恰 档 的 


支持 。 


下 列 包 是 可 选 的 。 在 缺 省 配置 的 时 候 并 不 要 求 它们 ， 但 是 如 果 打 开 了 一 些 编译 选项 之 后 就 需 
要 它们 了 ， 如 下 面 解 释 的 : 


。 要 编译 PL/Penl 服 务 器 端 编程 语言 ， 你 需要 一 个 完整 的 Perl 安 装 ， 包括 libperl 库 和 头 文 
件 。 因 为 PL/Perl 是 一 个 共享 库 ， 1ibperl 库 在 大 多 数 平台 上 也 必须 是 一 个 共享 库 。 最 新 
版 本 的 Perl 好 像 已 经 是 缺 省 这 么 做 了 ， 但 是 早先 的 版 本 可 不 是 这 样 的 ， 而 且 在 任何 安装 
了 Perl 的 地 方 总 是 可 选 的 。 如 果 你 打算 比 偶尔 使 用 PL/Perl 编 译 更 多 ， 你 应 确保 编译 带 
有 usemultiplicity 启用 选项 的 Per 安装 ( perl -v 将 显示 是 否 是 这 种 情况 ) 。 


eRe A k 享 库 ， 但 却 需要 它 ， 那 么 在 PostgreSQL 编 译 过 程 中 将 看 到 下 面 的 信息 ， 指 出 


这 个 问题 : 


*** Cannot build PL/Perl because libperl is not a shared library. 
*** You might have to rebuild your Perl installation. Refer to 
*** the documentation for details. 


如 果 你 不 按照 屏幕 输出 的 指示 去 做 ， 那 么 你 只 会 注意 到 PL/Perl 库 对 象 plperl.so 或 者 类 
似 的 什么 东西 ， 不 会 安装 到 系统 里 。 如 果 你 看 到 这 些 东 西 ， Ws di 
并 安装 Perl， 这 样 才 能 编译 PL/Perl。 在 配置 Perl 的 过 程 中 ， 要 求 一 个 共享 库 。 


要 编译 PL/Python 服 务 器 端 编程 语言 ， 你 需要 一 个 Python 的 安装 ， 包括 头 文件 和 distutils 
模块 。 最 小 所 需 版 本 是 Python2.3。 如 果 版 本 是 3.1 或 者 更 高 版 本 ， 则 支持 Python 3 ; 但 
是 当 使 用 Python 3 的 时 候 ， 则 参阅 Section 43.1。 


因为 PL/Python 将 以 共享 库 的 方式 编译 ， libpython 库 在 大 多 数 平台 上 也 必须 是 一 个 共享 
库 。 在 缺 省 的 Python 安 装 时 不 是 这 样 的 。 如 果 在 编译 和 安装 PostgreSQL 之 后 ， 你 有 一 
个 叫做 plpython.so 的 文件 (可 能 扩展 名 会 有 所 不 同 )， 那 么 一 切 都 好 说 ， 否则 你 应 该 会 看 
到 类 似 下 面 的 信息 飘 过 : 


*** Cannot build PL/Python because libpython is not a shared library. 
*** You might have to rebuild your Python installation. Refer to 
*** the documentation for details. 


这 意味 着 你 必须 重新 编译 (一 部 分 )Python 安 装 ， 以 创建 这 个 共享 库 。 


如 果 有 问题 ， -enable-shared 标志 运行 Python 2.3 或 更 高 版 本 的 configure 脚本 。 在 
有 些 操 pos 你 不 必 非 要 编译 一 个 共享 库 ， 不 过 你 需要 让 PostgreSQL 的 编译 系统 知 
道 这 些 。 参考 src/pl/plpython 目录 中 的 makefile 获取 细节 。 


如 果 想 编译 PL/Tcl 过 程 语言 ， 那 么 当然 需要 安装 Tc1 了 。 如 果 你 使 用 Tcl 先 前 的 8.4 版 本 ， 应 
该 确保 它 不 需要 多 线程 支持 。 


要 打开 本 地 语言 支持 (NLS)， 也 就 是 说 ， cna eas 显示 程序 的 信息 ， 你 需要 一 个 
Gettext API 的 实现 。 有 些 操作 系统 内 置 了 这 些 ( 比 如 Linux, NetBSD, Solaris), 对 于 其 它 
系统 ， 你 可 以 从 ee ee pn 如 果 你 在 GNU 
C 库 里 面 使 用 Gettext 实 现 ， 那么 你 就 额外 需要 GNU Gettext 包 ， 因为 我 们 需要 里 面 的 几 
个 工具 程序 。 对 于 任何 其 它 的 实现 ， 你 应 该 不 需要 它 。 


你 需要 Kerberos, OpenSSL, OpenLDAP, 和 /或 者 PAM， 如 果 你 想 支 持 使 用 这 些 服务 的 认 
证 或 者 加 密 ， 那 你 需要 这 些 包 。 


为 了 编译 PostgreSQL 文 档 ， 有 一 套 独立 要 求 ; 参阅 Section J.2. 


如 果 你 从 Git 树 中 编译 ， 而 不 是 使 用 发 布 的 源 代码 包 ， 或 者 你 想 做 一 些 服 务 开 发 ， 那么 你 还 需 
要 下 面 的 包 : 


。 如 果 你 需要 从 Git 校 验 中 编译 ， 或 者 你 修改 了 扫描 器 和 分 析 器 的 定义 文件 ， 那么 你 需要 
Flex 和 Bison。 如 果 你 需要 它们 ， 那么 确保 自己 拿 到 的 是 Flex 2.5.31 或 更 新 的 版 本 ， 以 及 
Bison 1.875 或 者 更 新 的 版 本 。 其 它 的 lex 和 yacc 程 序 肯定 是 不 行 的 。 


。 如 果 需 要 从 Git 校 验 中 编译 或 者 如 果 需 要 改变 使 用 Perl 脚 本 的 任何 编译 步骤 的 输入 文件 ， 
那么 需要 Perl 5.8 或 者 更 新 版 本 。 如 果 在 Windows 上 编译 ， 那 么 你 在 任何 情况 下 将 需要 
Perl. 


如 果 你 需要 获取 GNU 包 ， 你 可 以 在 GNU 镜 像 站 点 http://www.gnu.org/order/ftp.html 或 
者 ftp://ftp.gnu.org/gnu/ 找到 它们 。 


请 检查 一 下 ， 看 看 你 是 否 有 足够 的 磁盘 空间 。 你 将 大 概 需 要 近 100MB 用 于 存放 安装 过 程 中 的 
源码 树 和 大 约 20MB 用 于 安装 目录 。 一 个 空 数据 库 大 概 需 要 35MB。 然后 在 使 用 过 程 中 大 概 需 
要 在 一 个 平面 文本 文件 里 存放 同等 数据 量 五 倍 的 空间 存储 数据 。 如 果 你 要 运行 回 为 测试 ， 还 
临时 需要 额外 的 150MB 。 请 用 df 命令 检查 剩余 磁盘 空间 。 


15.3. 获取 源码 


PostgreSQL 9.3.1， 源 码 可 以 从 我 们 的 网 站 : http://www.postgresql.org/download/ 进行 下 载 。 
你 可 以 获得 文件 命名 postgresql-9.3.1.tar.gz 或 者 postgresql-9.3.1.tar.bz2 o 在 你 获取 文 
件 之 后 ， 解 压缩 : 


<kbd class="literal">gunzip postgresql-9.3.1.tar.gz</kbd> 
<kbd class="literal">tar xf postgresql-9.3.1.tar</kbd> 


如 果 你 有 .bz2 文件 ， 可 以 使 用 bunzip2 KF gunzip o 这 样 将 在 当前 目 录 创 建 一 个 目 
录 postgresql-9.3.1 ， 里 面 是 PostgreSQL 源 代码 。 进入 这 个 目 录 完 成 安装 过 程 的 其 它 步 又。 


你 也 可 以 直接 从 版 本 控制 库 中 获取 源码 ， 参 阅 Appendix |, 


1. 


安装 过 程 的 第 一 步 就 是 配置 源 代 码 树 并 选择 你 喜欢 的 选项 。 这 个 工作 是 通过 运 
{T configure 脚本 实现 的 ， 对 于 缺 省 安装 ， 你 只 需要 简单 地 敲 入 : 


&1t;kbd class="literal"&gt; ./configure&lt; /kbd&gt ; 


该 脚本 将 运行 一 些 测 试 来 决定 一 些 系统 相关 的 变量 ， 并 检测 操作 系统 的 设置 ， 最 后 将 在 
编译 树 中 创建 一 些 文件 以 记录 它 找到 了 什么 。 如 果 你 想 保 持 编译 目录 的 独立 ， 那么 你 也 
可 以 在 源 代 码 树 之 外 的 其 它 目 录 里 运行 configure 。 这 个 过 程 也 被 称 为 VPATH 编译 。 这 
里 是 方法 : 

&lt;kbd class="literal"&gt;mkdir build_dir&1lt;/kbd&gt; 

&1t;kbd class="literal"&gt;cd build_dir&lt;/kbd&gt; 


&lt;kbd class="literal"&gt;/path/to/source/tree/configure [options go here]&lt; /kbd& 
&1t;kbd class="literal"&gt; gmake&lt;/kbd&gt; 


‘ Be 


缺 省 设置 将 编译 服务 器 和 应 用 程序 ， 还 有 所 有 只 需要 C 编 译 器 的 客 户 端 程序 和 接口 。 mR 
省 时 所 有 文件 都 将 安装 到 /usr/1local/pgsql 目录 。 





你 可 以 通过 给 出 下 面 的 一 个 或 多 个 configure 命令 行 选项 来 自 定义 编译 和 安装 过 程 : 
--prefix=``_PREFIX_ 


把 所 有 文件 装 在 _PREFIX_ 目录 下 而 不 是 /usr/local/pgsql 里 。 实际 的 文件 会 安装 到 不 同 
的 子 目录 里 ; 甚至 没有 一 个 文件 会 直接 安装 到 PREF 目录 里 。 


如 果 你 有 特殊 需要 ， 你 还 可 以 用 下 面 的 选项 自 定义 不 同 子 目录 的 位 置 。 不 过 ， 即 使 你 保 
持 缺 省 设置 ， 安 装 时 浮动 的 ， 意味 着 可 以 在 安装 之 后 移动 目录 ( man 和 doc 位 置 不 受 影 

响 )。 

为 了 浮动 安装 ， 你 可 能 需要 使 用 configure 的 --disable-rpath 选项 。 还 有 ， 你 需要 告诉 
操作 系统 如 何 找到 共享 库 。 

--exec-prefix= ~_EXEC-PREFIX_ 

把 体系 相关 的 文件 安装 到 _ExEc-PREFIX , 而 不 是 _PREFIX_ 设置 的 地 方 。 这 样 做 可 以 比 
较 方便 地 在 不 同 主机 之 间 共 享 体系 相关 的 文件 。 如 果 你 省 略 它 ， 那么 _EXEC-PREFIX_ 就 


会 被 设置 为 等 于 _PREFIX_ 并且 体 系 相关 和 体系 无 关 的 文件 都 会 安装 到 同一 目录 树 下 ， 这 
也 可 能 是 你 想 要 的 。 


--bindir= ~_DIRECTORY_ 


声明 可 执行 程序 的 目录 ， 缺 省 是 _ExEc-PREFIX_ /bin， 通常 也 就 
是 /usr/local/pgsql/bin o 


--sysconfdir=``_DIRECTORY_ 


置 各 种 配置 文件 的 目录 。 缺 省 是 PREFIX /etc。 


--libdir=* ~_DIRECTORY_ 


和 起 库 文件 和 动态 装载 模块 的 目录 。 缺 省 是 _EXEC-PREFIX_ /lib, 


--ijncludedir= ~_DIRECTORY_ 


委 置 C 和 C++ 头 文件 的 目录 。 缺 省 是 PREFIX /include。 
--datarootdir=° ~_DIRECTORY_ 
填 各 种 类 型 只 读数 据 文件 的 根 目 录 。 这 只 设置 了 一 些 下 面 的 缺 省 选项 。 缺 省 是 
_PREFIX_ /share。 
--datadir=>~_DIRECTORY_ 
5 1S (ARR it BGAN, BRB _DATAROOTDIR_ o 请 注意 这 与 你 的 数 
据 库 文 件 放 在 哪里 无 关 。 


--localedir=* ~_DIRECTORY_ 


设置 安装 现场 数据 的 目录 ， 特 别 是 消息 转变 目录 文件 。 缺 省 是 _pataroororr_ /locale, 


--mandiIr= DIRECTORY 


随 着 PostgreSQL 一 起 的 手册 页 将 安装 到 这 个 目录 的 man x 子 目录 里 。 RA 


三 | 


是 _DATAROOTDIR_ /man。 


--docdir= ~_DIRECTORY_ 


设置 除 "man" 以 外 的 文档 文件 的 根 目录 。 这 只 设置 下 面 选项 的 缺 省 ， 这 个 选项 的 缺 省 值 


=] 


定 _DATAROOTDIR_ /doc/postgresal. 


--htmldir=**_DIRECTORY_ 
PostgreSQL 的 HTML- 格 式 文档 将 安装 在 这 个 目录 。 GRAZ _DATAROOTDIR_ o 


> Note: 为 了 让 PostgreSQL 能 够 安装 在 一 些 共 享 的 安装 位 置 (比如 /usr/local/include ), 
同时 又 不 至 于 和 系统 其 它 部 分 产生 名 字 空 间 干 扰 ， 我 们 采取 了 一 些 步骤。 首先 ， 安 装 脚 
本 会 自动 给 datadir ，sysconfdir 和 docdir 后 面 附加 上 " /postgresql "字符 串 ， 除非 展 
开 的 完 整 路 和 RBG 经 包含 字符 串 " postgres "或 者 " pgsql we 比如 ， 如 果 你 选 

择 /usr/local 作为 前 级 ， 那么 文档 将 安装 在 /usr/1local/doc/postgresql , 但 如 果 前 级 
是 /opt/postgres , 那么 它 将 被 放 到 /opt/postgres/doc o 客户 接口 的 公共 C 头 文件 安装 
到 了 includedir ， 并 且 是 名 字 空 间 无 关 的 。 内 部 的 头 文 件 和 服务 器 头 文件 都 安装 


到 includedir 下 的 私有 目录 中 去 了 。 参考 每 种 接口 的 文档 获取 关于 如 何 访问 头 文件 的 信 
a. RA, WREE, 那么 也 会 在 libdir 下 创建 一 个 私有 的 子 目 录 ， 用 于 动态 装载 模 
块 。 


--with-includes=* ~_DIRECTORIES_ 

_DIRECTORIES, 是 一 系列 冒号 分 隔 的 目录 ， 这 些 目录 将 被 加 入 编译 器 的 头 文件 搜索 列表 
中 。 如 果 你 有 一 些 可 选 的 包 (比如 GNU Readline) 安 装 在 非 标 准 位 置 ， 你 就 必须 使 用 这 个 
vom, 以 及 可 能 还 有 相应 的 --with-libraries 选项 。 

例子 z: --with-includes=/opt/gnu/include:/usr/sup/include o 
--with-libraries=``_DIRECTORIES_ 

_DIRECTORIES_ 是 一 系列 冒号 分 隔 的 目录 ， 这 些 目录 是 用 于 查找 库 文 件 的 。 如 果 你 有 一 


些 包 安装 在 非 标准 位 置 ， 你 可 能 就 需要 使 用 这 个 选项 (以 及 对 应 的 --with-includes 选 
项 )。 


例子 : --with-libraries=/opt/gnu/lib:/usr/sup/lib o 
--enable-nls[=``_LANGUAGES_ ] 


打开 本 地 语言 支持 (INLS)， 也 就 是 以 非 英 文 显示 程序 信息 的 能 力 。 _LANGUAGES_ 是 一 个 可 
选 的 空格 分 隔 的 语言 代码 列表 ， 标 识 你 想 支 持 的 语言 。 比如 --enable-nls='de fr' 。 你 
提供 的 列表 和 实际 支持 的 列表 之 间 的 交集 会 自动 计算 出 来 。 如 果 你 没有 声明 一 个 列表 ， 
那么 就 安装 所 有 可 用 的 翻译 。 

要 使 用 这 个 选项 ， 你 需要 一 个 Gettext 的 实现 。 见 上 文 。 

--with-pgport= ~_NUMBER_ 

NUMBER. 为 服务 器 和 客户 端的 缺 省 端口 ( 缺 省 是 5432)。 这 个 端口 可 以 在 以 后 设置 ， 不 过 
如 果 你 在 这 里 声明 ， 那 么 服务 器 和 客户 端 籽 有 相同 的 编译 好 了 的 缺 省 值 。 这 样 会 方便 
些 。 通常 选取 一 个 非 缺 省 值 的 好 理由 是 你 企图 在 同一 台 机 器 上 运行 多 个 PostgreSQL 服 务 
器 。 

--with-perl 

编译 PL/Perl 服 务 器 端 编程 语言 。 

--with-python 

编译 PL/Python 服 务 器 端 编程 语言 。 

--with-tcl 

编译 PL/Tcl 服 务 器 端 编程 语言 。 


--wWith-tclconfig= ~_DIRECTORY_ 


Tcl 安 装 的 tclconfig.sh 文件 所 在 目录 ， 它 里 面包 含 编 译 Tcl 模块 的 配置 信息 。 这 个 文件 
通常 会 自动 在 约定 俗 成 的 位 置 找到 这 些 文件 ， 但 是 如 果 你 需要 一 个 不 同 版 本 的 Tcl， 你 也 
可 以 声明 能 找到 它 的 目录 。 


--with-gssapi 

编译 支持 GSSAPI 认 证 的 东西 。 在 许多 系统 上 ，GSSAPI (通常 Kerberos 安 装 部 分 ) 系统 
没有 安装 在 缺 省 的 搜索 目录 下 (比如 /usr/include , /usr/lib )， 所 以 你 必须 使 用 附加 
的 --with-includes 和 --with-libraries 选项 。 configure 在 继续 配置 之 前 将 检查 所 需 
要 的 头 文 件 和 库 ， 以 确保 GSSAPI 是 充分 可 用 的 。 

--with-krb5 

编译 支持 Kerberos 5 认证 的 东西 。 在 许多 系统 上 ， Kerberos 系统 没有 安装 在 缺 省 的 搜 
索 目 录 下 (比如 /usr/include , /usr/lib )， 所 以 你 必须 使 用 附加 

的 --with-includes 和 --with-libraries 选项 。 configure 在 继续 配置 之 前 将 检查 所 需 
要 的 头 文件 和 库 ， 以 确保 Kerberos 是 充分 可 用 的 。 


--wWith-krb-srvnam= ~_NAME_ 

缺 省 的 Kerberos 服 务 主 的 名 称 (通过 GSSAPI 使 用 ) . RBZ postgres, 通常 没有 理由 
改变 这 个 值 。 除 非 你 在 Windows 环 境 下 ， 在 这 种 情况 下 必须 设置 大 写 PosTGRES o 
--with-openssl 

编译 支持 SSL( 加 密 的 ) 连 接 。 这 个 选项 需要 安装 OpenSSL 包 。 configure 将 在 安装 之 前 
检查 所 需要 的 头 文件 和 库 文件 以 确信 OpenSSL 安 装 是 充分 可 用 的 。 

--with-pam 

编译 PAM( 可 插 拔 认 证 模块 ) 支 持 。 

--with-ldap 

编译 LDAP 支 持 。 用 于 认证 和 查找 连接 参数 (参见 Section 31.17 和 Section 19.3.8 以 获取 更 


多 信息 )。 在 Unix 上 ， 这 需要 OpenLDAP 包 的 支持 。 在 Windows 上 ， 缺 省 使 用 WinLDAP 
库 。 configure 将 会 检查 所 需 的 头 文件 和 库 以 确保 OpenLDAP 的 安装 是 充分 可 用 的 。 


--without-readline 

避免 使 用 Readline 与 libedit 库 。 这 样 就 关闭 了 psql 里 的 命令 行 编辑 和 历史 ， 因 此 我 们 不 建 
议 这 么 做 。 

--with-libedit-preferred 


优先 使 用 BSD- 认 证 的 libedit 库 而 不 是 GPL 认证 的 Readline 库 。 该 选项 仅 在 同时 安装 了 这 
两 个 库 的 情况 下 才 有 意义 。 缺 省 使 用 Readline 库 。 


--with-bonjour 


编译 Bonjour 支 持 。 这 要 求 操 作 系 统 支持 Bonjour。 在 Mac OS X 上 建议 使 用 。 


--with-ossp-uuid 


使 用 OSSP UUID library 编 译 组 件 。 特别 是 ， 编 译 uuid-o0ssp 模 块 ， 它 提供 函数 产生 
UUIDs.. 


--with-libxml 
编译 libxml (开启 SQL/XML 支 持 )。 需 要 Libxml 2.6.23 或 者 更 高 版 本 支持 这 一 特性 。 


Libxml 安 装 程序 xm12-config 可 用 于 检测 所 需 的 编译 器 和 链接 器 选项 。 如 果 发 现 ， 
PostgreSQL 将 自动 使 用 它 。 在 一 个 不 寻常 的 位 置 来 指定 libxml 安 装 ， 您 可 以 要 么 设置 环 
境 变 量 xML2_coNFIG6 以 指向 xm12-config 附属 于 安装 的 程序 或 者 使 用 选 


项 --with-includes 和 --with-libraries 。 


--with-libxslt 


当 编 译 xml2 模 块 时 ， 使 用 libxslt。 xml2 依 赖 于 这 个 库 执行 XSL 转 变 成 XML。 


--disable-integer-datetimes 


禁用 64 位 的 时 间 惟 整数 存储 和 时 间 间 隔 支 持 。 并 且 作为 浮 点 数 存储 时 间 值 。 在 
PostgreSQL 发 布 之 前 的 8.4 版 本 中 缺 省 浮 点 日 期 时 间 存 储 。 但 它 现在 已 经 过 时 ， 因 为 它 
没有 支持 timestamp 值 的 全 范围 的 微 秒 精度 。 然而 ， 基 于 整数 的 日 期 时 间 存 储 需要 一 个 
64 位 的 整数 类 型 。 因此 ， 当 没有 这 样 的 类 型 可 用 时 ， 可 以 使 用 此 选项 时 ， 或 与 
PostgreSQL 先 前 版 本 编写 的 应 用 程序 兼容 。 BM Section 8.5 获 取 更 多 的 信息 。 


--disable-float4-byval 


禁用 " 按 值 传递 "float4 值 ， 使 它们 "通过 引用 "传递 。 此 选项 消耗 性 能 ， 但 可 能 需要 与 用 C 语 
言 编 写 的 旧 的 用 户 定义 的 函数 兼容 ， 并 且 使 用 "版 本 0" 调 用 约定 。 一 个 更 好 的 长 期 的 解决 
办 法 是 使 用 "版 本 们 调用 约定 更 新 任何 此 类 本 数 。 


--disable-float8-byval 


蔡 用 " 按 值 传递 "传递 foat8 值 ， 使 它们 "通过 引用 "传递 。 此 选项 消耗 性 能 ， 但 可 能 需要 与 
用 C 语 言 编写 的 旧 的 用 户 定义 的 函数 兼容 ， 并 且 使 用 "版 本 0" 调 用 约定 。 一 个 更 好 的 长 期 
的 解决 办 法 是 使 用 "版 本 人 "调用 约定 更 新 任何 此 类 画 数 请 注意 ， 此 选项 不 仅 影响 float8， 

而 且 也 影响 int8 以 及 一 些 相 关 类 型 (如 时 间 戳 ) 。 在 32 位 平台 上 ， 缺 省 


是 --disable-float8-byval o 并 且 它 不 允许 选择 --enable-float8-byval o 


--with-segsize=``_SEGSIZE_ 


设置 段 大 小 ， 以 GB 为 单位 。 大 表 被 分 成 多 个 操作 系统 文件 ， 每 个 文件 的 大 小 等 同 于 段 
大 小 。 这 避免 了 存在 许多 平台 上 的 文件 大 小 限制 。 黑 认 段 大 小 ，1 千 兆 字 节 ， 在 所 有 支 
持 的 平台 上 是 安全 的 。 如 果 你 的 操作 系统 支持 "largefile" (现在 大 多 数 支持 ) ， 你 可 以 使 
用 较 大 的 段 大 小 。 这 可 以 帮助 减少 当 大 表 工 作 时 消耗 掉 的 文件 描述 符 数量 。 但 要 小 心 ， 
不 要 选择 一 个 大 于 通过 您 的 平台 和 您 打算 使 用 的 文件 系统 支持 的 值 ， 你 可 能 希望 使 用 其 
他 工具 ， 比 如 tar， 也 可 以 设置 可 用 文件 大 小 的 限制 。 因此 建议 ， 虽 然 不 是 绝对 必要 的 ， 
但 该 值 是 2 的 暴 。 请 注意 ， 改 变 这 个 值 需 要 初始 化 数据 库 。 


--with-blocksize=* ~_BLOCKSIZE_ 


设置 块 大 小 ， 以 KB 为 单位 。 这 是 表 中 存储 和 I/O 单 元 。 默认 情况 下 ，8 干 字 节 ， 适 用 于 大 
多 数 情况 ; 但 是 其 它 的 值 可 能 在 特殊 情况 下 是 有 用 的 。 该 值 必 须 是 1 和 32 之 间 (FF 
节 ) 205. 请 注意 ， 改 变 这 个 值 需 要 初始 化 数据 库 。 


--with-wal-segsize=``_SEGSIZE_ 


设置 WAL 段 大 小 ， 以 MB 为 单位 。 这 是 WAL 日 志 中 每 个 单独 的 文件 的 大 小 。 它 可 能 有 助 
于 调整 这 个 大 小 来 控制 WAL 日 志 传 送 的 粒度 。 缺 省 大 小 为 16 兆 字 节 。 该 值 必须 是 1 和 64 
Zi) KFR) 20%. 请 注意 ， 改 变 这 个 值 需要 初始 化 数据 库 。 


--with-wal-blocksize=* ~_BLOCKSIZE_ 


设置 WAL 块 大 小 ， 以 KB 为 单位 。 这 是 WAL 日 志 中 存储 和 |/O 单 元 。 默认 情况 下 ，8 千 字 
节 ， 适 用 于 大 多 数 情况 ; 但 是 其 它 的 值 可 能 在 特殊 情况 下 是 有 用 的 。 该 值 必 须 是 1 和 64 
之 间 (FFA) 208, 请 注意 ， 改 变 这 个 值 需要 初始 化 数据 库 。 


--disable-spinlocks 


允许 在 PostgreSQL 没 有 该 平台 的 CPU 自 旋 锁 支持 的 情况 下 编译 成 功 。 缺乏 自 旋 锁 的 支持 
将 导致 性 能 恶化 ; 因此 ， 只 有 在 编译 过 程 退出 ， 并 且 告 诉 你 说 该 平台 缺乏 自 旋 锁 支 持 的 
时 候 才 使 用 这 个 选项 。 如 果 在 你 的 平台 上 需要 这 个 选项 才能 编译 PostgreSQL， 请 向 
PostgreSQL 开 发 者 报告 这 个 问题 。 


--disable-thread-safety 


禁用 客户 端 库 是 线程 安全 的 。 这 样 就 允许 在 libpq 和 ECPG 程 序 里 的 并 发 线程 安全 地 控制 
他 们 私有 的 连接 句柄 。 


--with-system-tzdata=° ~_DIRECTORY_ 


PostgreSQL 包 括 它 自己 的 时 区 数据 库 ， 它 要 求 对 日 期 和 时 间 操 作 。 此 时 区 数据 库 实 际 上 
是 与 许多 操作 系统 比如 FreeBSD,Linux, and Solaris 提 供 的 "zoneinfo" 时 区 数据 库 兼 容 。 
所 以 重新 安装 将 是 多 余 的 。 当 这 个 选项 被 使 用 时 ， _pIREcCTORY_ 中 系统 提供 的 时 区 数据 库 
是 用 来 代替 包含 在 PostgreSQL 源 代码 发 布 中 的 其 中 之 一 。 _pIRECTORY_ 必须 作为 绝对 路 
径 被 指定 。 /usr/share/zoneinfo 是 某 些 操作 系统 上 的 可 能 目录 。 请 注意 ， 这 个 安装 程 
序 将 不 检测 不 匹配 的 或 者 错误 的 时 间 区 域 数据 。 如 果 您 使 用 此 选项 ， 建 议 您 运行 回归 测 
试 ， 以 验证 该 时 区 的 数据 ， 你 已 经 指出 正确 使 用 PostgreSQL。 


该 选项 主要 是 针对 二 进 制 软件 包 分 发 者 ， 他 知道 目标 操作 系统 运行 良好 。 使 用 此 选项 的 
主要 优势 是 ， 当 许多 当地 白昼 节约 时 间 规则 变化 的 任何 时 候 ，PostgreSQL 包 不 需要 升 
Bo 另 一 个 优点 是 ， 如 果 时 区 数据 库 文 件 在 安装 期 间 不 需要 被 编译 ，PostgreSQL 可 以 进 
行 交 叉 编 译 更 直截了当 。 


--without-zlib 


避免 使 用 Zlib 库 。 这 样 就 关闭 了 pg_dump 和 pg _restore 里 面 的 压缩 支持 。 这 个 选项 只 适 
用 于 那些 没有 这 个 库 的 罕见 的 系统 。 


--enable-debug 


把 所 有 程序 和 库 以 带 有 调试 符号 的 方式 编译 。 这 意味 着 你 可 以 通过 一 个 调试 器 运行 程序 
来 分 析 问 题 。 这 样 做 显著 增 大 了 最 后 安装 的 可 执行 文件 的 大 小 ， 并 且 在 非 GCC 的 编译 器 
+, 这 么 做 通常 还 要 关闭 编译 器 优化 ， 导 致 速度 的 下 降 。 但 是 ， 如 果 有 这 些 符号 表 的 
话 ， 就 可 以 非常 有 效 地 帮助 定位 可 能 发 生 问题 的 位 置 。 目 前 ， 我 们 只 是 在 你 使 用 GCC 的 
情况 下 才 建 议 在 生产 安装 中 使 用 这 个 选项 。 但 是 如 果 你 正在 进行 开发 工作 ， 或 者 正在 使 
用 beta 版 本 ， 那么 你 就 总 应 该 打开 它 。 


--enable-coverage 
如 果 使 用 GCC， 所 有 的 程序 和 库 连 同 代码 覆盖 测试 仪器 一 起 被 编译 。 在 运行 时 ， 它 们 与 


代码 覆盖 率 度量 在 编译 目录 下 生成 文件 。 参阅 Section 30.4 获取 更 多 信息 当做 开发 工作 
时 ， 该 选项 仅 用 于 GCC。 


--enable-profiling 


如 果 使 用 GCC， 则 编译 所 有 程序 和 库 ， 使 他 们 可 以 描绘 轮廓 。 在 后 端 出 口 ， 创 建 子 目 
录 ， 包含 分 析 使 用 的 gmon.out 文件 。 当做 开发 工作 时 ， 该 选项 仅 用 于 GCC。 


--enable-cassert 


打开 服务 器 中 的 assertion 检 查 ， 它 会 检查 许多 "不 可 能 发 生 " 的 条 件 。 它 对 于 代码 开发 的 
用 途 而 言 是 无 价 之 宝 ， 不 过 这 些 测 试 可 以 显著 减缓 服务 器 。 并 且 ， 打 开 这 个 测试 不 会 提 
高 系统 的 稳定 性 ! 这 些 断 言 检 查 并 不 是 按照 错误 的 严重 性 分 类 的 ， 因此 一 些 相对 无 害 的 
小 虫子 也 可 能 导致 服务 器 重启 (只 要 它 触 发 了 一 次 断言 失败 )。 目 前 ， 我 们 不 推荐 在 生产 
环境 中 使 用 这 个 选项 ， 但 是 如 果 你 在 做 开发 或 者 在 使 用 beta 版 本 的 时 候 应 该 打开 它 。 
--enable-depend 

打开 自动 倚赖 性 跟踪 。 如 果 打 开 这 个 选项 ， 那 么 makefile 文件 将 设置 为 在 任何 头 文件 被 
修改 的 时 候 都 将 重新 编译 所 有 受 影响 的 目标 文件 。 如 果 你 在 做 开发 的 工作 ， 那 么 这 个 选 
项 很 有 用 ， 但 是 如 果 你 只 是 想 编 译 一 次 并 且 安 装 ， 那么 这 就 是 浪费 时 间 。 目 前 ， 这 个 选 
项 只 有 在 你 使 用 GCC 的 时 候 才 管用 。 


--enable-dtrace 
编译 PostgreSQL 支 持 动态 跟踪 工具 DTrace。 参阅 Section 27.4 获 取 更 多 信息 。 


指向 dtrace 程序 ， 设 置 环境 变量 pTRACE 。 这 往往 是 必须 的 ， 因 为 dtrace 通常 安装 
在 /usr/sbin 中 且 该 目录 一 般 不 在 搜索 路 经 中 。 


在 环境 变量 DTRACEFLAGS 中 为 dtrace 程序 指定 额外 命令 行 选项 。 在 Solaris 上 ， 要 包含 
64 位 二 进 制 的 DTrace 支 持 ， 需 要 指定 DTRACEFLAGS="-64" ， 比 如 ， 在 使 用 GCC 编译 的 时 
候 : 


./configure CC='gcc -m64' --enable-dtrace DTRACEFLAGS='-64' ... 


在 使 用 Sun 编 译 器 的 时 候 : 


./configure CC='/opt/SUNWspro/bin/cc -xtarget=native64' --enable-dtrace DTRACEFLAGS= 


‘| 








如 果 你 喜欢 使 用 不 同 于 configure 找 出 来 的 C 编译 器 ， 可 以 将 环境 变量 cc 设置 为 你 选 
择 的 程序 。 缺 省 时 ， configure 将 选择 gce (只 要 可 用 )， 或 者 是 该 平台 的 缺 省 (通常 
是 cc ) 类 似 地 ， 你 可 以 用 crass 履 盖 缺 省 编译 器 标志 。 


你 可 以 在 configure 命令 行 上 声明 环境 变量 ， 比 如 : 


&lt;kbd class="literal"agt;./configure CC=/opt/bin/gcc CFLAGS='-02 -pipe'&lt;/kbdagt ; 
EEE | 
下 面 是 可 用 的 环境 变量 列表 : 

BISON 

Bison 程 序 

cc 

CHREAN 

CFLAGS 

传递 给 C 编 译 器 的 选项 

CPP 

C 预 处 理 器 

CPPFLAGS 

传递 给 C 预 处 理 器 的 选项 

DTRACE 

dtrace 程序 位 置 

DTRACEFLAGS 

传递 给 dtrace 程序 的 选项 

FLEX 

Flex 程 序 

LDFLAGS 

当 连 接 可 执行 或 可 共享 库 时 使 用 的 选项 


LDFLAGS_EX 


只 连接 可 执行 时 的 额外 选项 


LDFLAGS_SL 


只 连接 共享 库 时 的 额外 选项 


MSGFMT 


本 地 语言 支持 的 msgfmt 程序 


PERL 


Perl 解 释 器 的 完整 路 径 。 用 于 确定 编译 PL/Perl 的 依赖 关系 


PYTHON 


Python 解释 器 的 完整 路 径 。 用 于 确定 编译 PL/Python 的 依赖 关系 。 另外 ，Python 2 或 3 是 
否 在 这 声明 (或 另 有 隐 式 选择 ) 决定 了 PL/Python 的 哪 种 语言 是 可 用 的 。 参阅 Section 
43.1 获取 更 多 详情 。 


TCLSH 


Tcl 解 释 器 的 完整 路 径 。 用 于 确定 编译 PL/TcI 的 依赖 关系 。 并 且 它 将 替代 Tcl 脚 本 。 


XML2_CONFIG 
xml2-config 程序 用 于 定位 libxml 安 装 。 


> Note: 当 开 发 服务 器 内 部 代码 时 ， 建 议 使 用 配置 选项 --enable-cassert (HH 打开 许 
多 运行 时 错误 检查 ) 和 --enable-debug (可 以 改进 调试 工具 的 有 效 性 ) 。 > > 如 果 使 用 
GCC， 最 好 是 进行 至 少 -01 的 优化 级 别 的 编译 。 因为 不 使 用 优化 ( -00 ) 禁 止 一 些 重要 的 
编译 器 警告 〈 例 如 ， 使 用 未 初始 化 变量 ) 。 然而 ， 非 需 优 化 级 别 可 以 进行 复杂 调试 ， 
为 通过 编译 代码 步 进 调试 往往 不 会 匹配 一 对 之 一 源 代 码 行 。 如 果 你 感到 困惑 ， 而 试图 调 
试 优化 的 代码 ， 重 新 编译 -00 的 指定 文件 。 一 个 简单 方法 来 做 到 这 一 点 是 通过 传递 选项 


到 make: gmake PROFILE=-00 file.o 。 


. Fait 


开始 编译 ， 键 人 : 


&lt;kbd class="literal"&gt; gmake&lt;/kbd&gt; 


( 记 住 使 用 GNU make) 。 依 硬件 不 同 ， 编 译 过 程 可 能 需要 一 些 时 间 。 显 示 的 最 后 一 行 
应 该 是 : 


All of PostgreSQL is successfully made. Ready to install. 


如 果 你 想 要 编译 一 切 可 以 编译 的 东西 ， 包 含 文档 (HTML 和 帮助 手册 ) ， 以 及 额外 模块 
(contrib) 键入 : 


&1t;kbd class="literal"&gt;gmake world&lt;/kbd&gt; 


显示 的 最 后 一 行 应 该 是 


PostgreSQL, contrib and HTML documentation successfully made. Ready to install. 


， 回 兴 测 试 

如 果 你 想 在 安装 文件 前 测试 新 编译 的 服务 器 ， 那么 你 可 以 在 这 个 时 候 运 行 回 为 测试 。 回 
轨 测 试 是 一 个 用 于 验证 PostgreSQL 在 系统 上 是 否 按照 开发 人 员 设 想 的 那样 运行 的 测试 套 
件 。 mA: 


&1t;kbd class="literal"&gt;gmake check&lt;/kbd&gt; 


这 条 命令 在 root 里 无 法 使 用 ; 请 在 非特 权 用 户 下 运行 该 命令 。 Chapter 30 包含 关于 如 何 
解释 测试 结果 的 详细 信息 。 你 可 以 在 以 后 的 任何 时 间 通 过 执行 这 条 命令 来 运行 这 个 测 
To 


.安装 文件 
> Note: 如 果 你 正在 升级 一 套现 有 的 系统 必定 读 Section 17.6。 它 有 关于 升级 集群 的 说 
明 。 


安装 PostgreSQL， 键 和 : 


&lt;kbd class="literal"&gt;gmake install&lt;/kbd&gt; 


A 


这 条 命令 将 把 文件 安装 到 在 step 1 声明 的 目录 里 面 去 。 确保 你 对 那个 目录 有 足够 的 权 
限 。 通 常 你 需要 用 root 权限 做 这 一 步 。 或 者 你 也 可 以 事先 创建 目标 目录 并 且 分 派 合适 的 
权限 。 


安装 文档 (HTML 和 手册 页 ) ， 键 入 : 


&1t;kbd class="literal"&gt;gmake install-docs&lt;/kbd&gt; 


如 果 上 面 编译 了 world ,而 不 是 键入 : 


&lt;kbd class="literal"&gt;gmake install-world&lt;/kbd&gt; 


这 也 安装 文档 。 


你 可 以 使 用 gmake install-strip KE gmake install 在 安装 可 执行 文件 和 库 文件 时 把 它 
们 的 调试 信息 抽取 掉 。 这 样 将 节约 一 些 空间 。 如 果 你 编译 时 带 着 调试 支持 ， 那 么 抽取 将 
有 效 地 删除 调试 支持 ， 因此 我 们 应 该 只 是 在 不 再 需要 调试 的 时 候 做 这 些 事情 。 
install-strip 力图 做 一 些 合理 的 事情 来 节约 空间 ， 但 是 它 并 不 知道 如 何 从 可 执行 文件 
中 抽取 每 个 不 需要 的 字 节 ， 因此 ， 如 果 你 希望 节约 所 有 可 能 节约 的 磁盘 空间 ， 那 么 你 可 
能 需要 手工 做 些 义理 。 


标准 的 安装 只 提供 所 有 开发 客户 端 应 用 的 头 文件 和 服务 器 端的 程序 开发 ， 比如 用 C Se 
户 图 数 或 者 数据 类 型 的 头 文件 。 〈 先 于 PostgreSQL 8.0， 后 者 需要 单独 


的 gmake install-all-headers 命令 ， 但 是 标准 安装 中 已 经 包含 这 一 步 ) 。 
只 装 客户 端 : 如 果 你 只 想 装 客户 应 用 和 接口 ， 那 么 你 可 以 用 下 面 的 命令 : 


&lt;kbd class="literal"&gt;gmake -C src/bin install&lt;/kbd&gt; 
&1t;kbd class="literal"&gt;gmake -C src/include install&lt;/kbd&gt; 
&1t;kbd class="literal"&gt;gmake -C src/interfaces install&lt;/kbd&gt; 
&1t;kbd class="literal"&gt;gmake -C doc install&lt;/kbd&gt; 


src/bin 中 有 一 些 仅 供 服务 器 使 用 的 二 进 制 文件 ， 但 是 它们 都 很 小 。 
EIR: 可 以 使 用 gmake uninstall 命令 卸载 。 不 过 这 样 不 会 删除 任何 创建 出 来 的 目录 。 


清理 : 在 安装 完成 以 后 ， 你 可 以 通过 在 源码 树 里 面 用 命令 gmake clean 删除 编译 过 程 文件 释放 
BE Zi, 这 样 会 保留 configure 程序 生成 的 文件 ， 这 样 以 后 你 就 可 以 用 gmake 命令 重新 编 
译 所 有 东西 。 要 把 源码 树 恢复 为 发 布 时 的 状态 ， 用 gmake distclean 命令 。 如 果 你 想 从 同一 
棵 源码 树 上 为 多 个 不 同 平台 编译 ， 你 就 一 定 要 运行 这 条 命令 并 且 为 每 个 平台 重新 配置 。 另 
外 ， 在 每 种 系统 上 使 用 一 套 独立 的 编译 树 ， 这 样 源 代码 树 就 可 以 保留 不 被 更 改 。 

如 果 你 执行 了 一 次 编译 ， 然 后 发 现 你 的 配置 选项 是 错误 的 ， 或 者 你 修改 了 任何 配置 所 探测 


的 东西 (比如 升级 了 软件 )， 那么 在 重新 配置 和 编译 之 前 运行 一 下 gmake distclean 是 个 好 习 
惯 。 如 果 不 做 这 个 事情 ， 你 修改 的 配置 选项 可 能 无 法 传播 到 所 有 需要 变化 的 地 方 。 


15.5. RAKE 


15.5.1. 共享 库 


在 一 些 有 共享 库 的 系统 里 ， 你 需要 告诉 系统 如 何 找到 新 安装 的 共享 库 。 那些 并 不 是 必须 做 这 
个 工作 的 系统 包括 FreeBSD, HP-UX, IRIX, Linux, NetBSD, OpenBSD, Tru64 UNIX (以 前 的 
Digital UNIX) 和 Solaris。 


设置 共享 库 的 搜索 路 径 的 方法 因 平 台 而 异 ， 但 是 最 广泛 使 用 的 方法 是 设置 LD_LIBRARY_PATH 环 
境 变量 ， 比如 在 Bourne shell( sh, ksh, bash, zsh ) 中 : 


LD_LIBRARY_PATH=/usr/local/pgsql/1lib 
export LD_LIBRARY_PATH 


在 csh 或 者 tcsh 中 : 


setenv LD_LIBRARY_PATH /usr/local/pgsql/lib 


把 /usr/local/pgsql/lib 换 成 你 在 step 1 设置 的 --libdir o 你 应 该 把 这 些 命令 放 到 启动 文 
件 ， 如 /etc/profile 或 者 ~/.bash _profile 里 面 。 和 这 个 方法 相关 的 一 些 注 意 事项 和 很 好 的 
aA LA ¢Ehttp://xahlee.org/UnixResourcedir/|dpath.html#& 2. 


在 有 些 系统 上 ， 更 好 的 方法 可 能 是 在 编译 之 前 设置 LD_RUN_PATH 环境 变量 。 
在 Cygwin 里 ， 把 库 目 录放 在 PATH 或 者 把 .d11 文件 移动 到 bin 目录 。 
如 果 有 疑问 ， 请 参考 系统 的 手册 页 (可 能 是 ld.so 或 ld)。 如 果 稍 后 你 收 到 下 面 这 样 的 信息 : 


psql: error in loading shared libraries 
libpq.so.2.1: cannot open shared object file: No such file or directory 


那么 这 一 步 就 是 必须 的 了 。 只 需 关 注 一 下 就 是 了 。 
如 果 你 的 系统 是 Linux 并 且 你 还 有 root 权 限 ， 那么 你 可 以 运行 : 


/sbin/ldconfig /usr/local/pgsql/lib 


(或 者 相应 的 目录 ) 以 便 让 运行 时 链接 器 更 快 地 找到 共享 库 。 请 参考 ldconfig 的 手册 页 获取 更 
多 信息 。 在 FreeBSD, NetBSD 和 OpenBSD 上 ， 命 全 是 : 


/sbin/ldconfig -m /usr/local/pgsql/lib 


我 们 不 知道 其 它 系统 有 什么 等 效 命令 。 


15.5.2. 环境 变量 


如 果 你 安装 到 /usr/local/pgsql 或 者 其 它 什 么 缺 省 时 不 搜索 程序 的 地 方 ， 那 你 应 该 增加 一 
个 /usr/local/pgsql/bin (或 者 是 你 在 step 1 中 给 你 的 PATH 设置 --bindir 的 值 )。 严格 说 ， 
这 些 都 不 是 必须 的 ， 但 这 么 做 可 以 让 你 使 用 PostgreSQL 更 方便 。 


要 做 这 些 事情 ， 把 下 面 几 行 加 到 shell 启 动 文件 ， 如 ~/.bash_profile 或 者 /etc/profile (如 果 
你 想 影响 所 有 用 户 ) : 


PATH=/usr/local/pgsql/bin: $PATH 
export PATH 


如 果 你 用 的 是 csh 或 者 tcsh ， 那 么 用 这 条 命令 : 


set path = ( /usr/local/pgsql/bin $path ) 


为 了 让 系统 找 得 到 man 文 档 ， 你 需要 加 类 似 下 面 的 一 行 到 一 个 shell 启 动 文件 里 (除非 你 安装 到 
了 缺 省 时 搜索 的 位 置 ) : 


MANPATH=/usr/local/pgsql/man: $MANPATH 
export MANPATH 


环境 变量 pcuost 和 PGPORT 为 客户 端点 用 声明 了 数据 库 服务 器 的 主机 和 端口 ， 覆盖 了 那些 编 
译 时 的 缺 省 项 。 如 果 你 想 从 远 端 运行 客户 端 应 用 ， 那么 每 个 准备 使 用 该 数据 库 的 用 户 都 设 
E peost 将 会 非常 方便 。 但 这 不 是 必须 的 ， 而 且 大 部 分 客 户 端 程序 也 可 以 通过 命令 行 选项 蔡 
换 这 些 设置 。 


15.6. 支持 平台 


平台 〈 即 CPU 架构 和 操作 系统 组 合 ) 被 认为 是 由 PostgreSQL 开 发 社区 支持 的 。 如 果 代码 包含 
在 工作 平台 上 的 为 定 ， 并 且 它 最 近 被 证 实 编译 ， 在 该 平台 上 传递 其 回归 测试 。 BA, CAR 
容 性 的 大 多 数 测试 通过 PostgreSQL Build Farm 上 的 试验 机 自动 完成 。 如 果 您 有 兴趣 在 一 个 未 
出 现 bulid farm 平 台 上 使 用 PostgreSQL， 但 对 其 中 代码 工作 位 置 或 者 可 以 进行 工作 ， 我 们 强 
烈 建议 你 建立 一 个 bulid farm 成 员 机 器 ， 这 样 可 以 保证 持续 兼容 性 。 


在 一 般 情 况 下 ，PostgreSQL 可 以 预期 工作 在 这 些 CPU 架 构 上 : x86, x86_64, IA64, PowerPC, 
PowerPC 64, S/390, S/390x, Sparc, Sparc 64, Alpha, ARM, MIPS, MIPSEL, M68K, 和 PA- 
RISC。 存 在 M32R, NS32K 和 VAX 代 码 的 支持 ， 但 这 些 体 系 结构 并 不 知道 最 近 已 经 测试 过 。 
它 往 往 通过 配置 - -disable-spinlocks 编译 不 支持 的 CPU 类 型 。 但 性 能 会 很 差 。 


PostgreSQL 预 期 工作 在 这 些 操作 操作 系统 上 : Linux (所 有 近期 发 行 的 ) ， 

Windows (Win2000 SP4 和 更 高 版 本 ) , FreeBSD, OpenBSD, NetBSD, Mac OS X, AIX, 
HP/UX, IRIX, Solaris, Tru64 Unix, 和 UnixWare。 其 它 Unix 系 统 也 可 以 工作 ， 但 目前 尚未 被 测 
Ro 在 大 多 数 情况 下 ， 所 有 支持 给 定 操 作 系 统 的 CPU 架构 将 工作 。 查看 Section 15.7， 看 是 
否 有 声明 您 的 操作 系统 的 信息 ， 特 别 是 如 果 使 用 的 是 旧 系 统 。 


如 果 你 有 根据 最 近 编 译 结果 支持 的 平台 安装 问题 ， 请 报告 

给 &lt;[pgsql-bugs@postgresql.org](mailto:pgsql-bugs@postgresql.org)&gt; o 如 果 你 有 兴 HX 
移植 PostgreSQL 到 一 个 新 的 平台 ， 

&1t; [pgsql-hackers@postgresql.org](mailto:pgsql-hackers@postgresql.org)&gt; 是 讨论 这 类 问 


题 的 合适 地 方 。 


mai Zs g 
15.7. 特定 平台 注意 事项 
这 部 分 提供 额外 的 关于 PostgreSQL 的 安装 和 设置 的 特定 平台 的 问题 。 一 定 要 阅读 安装 说 明 ， 
尤其 是 Section 15.2, 另外 ， 检 查 Chapter 30 有 关 回 为 测试 结果 的 说 明 。 


此 处 未 覆盖 的 平台 没有 已 知 的 特定 平台 安装 问题 。 


15.7.1. AIX 


PostgreSQL 工 作 在 AIX 上 ， 但 正确 安装 它 具 有 挑战 性 。 支持 AIX 4.3.3 到 6.1 版 本 。 您 可 以 使 
用 GCC 或 本 机 IBM 编 译 器 xlc 。 一 般 情 况 下 ， 采 用 近期 的 AIX 版 本 和 PostgreSQL 有 所 帮助 。 
检查 bulid farm 获 得 最 新 的 信息 ， 其 中 AIX 版 本 是 众所周知 的 。 


推荐 的 最 小 修复 水 平 支 持 的 AIX 版 本 是 : 
AIX 4.3.3 

Maintenance Level 11 + post ML11 bundle 
AIX 5.1 

Maintenance Level 9 + post ML9 bundle 
AIX 5.2 

Technology Level 10 Service Pack 3 
AIX 5.3 

Technology Level 7 

AIX 6.1 

Base Level 


查看 当前 补丁 级 别 ， 使 用 AlIX 4.3.3 到 AlIX 5.2 ML7 中 的 oslevel -r ， 或 者 更 高 版 本 的 


oslevel -S o 


除 你 自己 之 外 请 使 用 以 下 的 configure 标志 ， 如 果 你 在 /usr/local : 
--with-includes=/usr/local/include --with-libraries=/usr/local/1lib 中 已 经 安装 了 Readline 


或 者 libz : 


15.7.1.1. GCC 问题 


在 AIX 5.3 上 ，PostgreSQL 的 编译 以 及 使 用 GCC 运行 有 一 些 问题 。 


您 将 要 使 用 GCC 随后 到 3.3.2 的 版 本 ， 特 别 是 如 果 你 使 用 一 个 预先 包装 的 版 本 。 我 们 在 4.0.1 
时 有 很 大 成 功 。 比 起 GCC 的 实际 问题 来 说 ， 早 期 版 本 问题 似乎 与 |IBM 包 装 GCC 有 更 大 关系 ， 
因此 ， 如 果 你 自己 编译 GCC， 关 于 GCC 早期 版 本 你 很 可 能 成 功 。 


15.7.1.2. Unix- 域 套 接 字 中 断 


AIX 5.3 有 问题 ， 其 中 sockaddr_storage 没有 被 定义 为 足够 大 。 在 5.3 版 本 中 ，IBM 夫 

加 sockaddr_un 的 大 小 ， Unix 域 套 接 字 地 址 结构 ， 但 并 没有 相应 地 增加 sockaddr_storage 的 
大 小 。 这 一 结果 是 尝试 使 用 Unix 域 套 接 字 与 PostgreSQL 导 致 libpq 洽 出 的 数据 结构 。 TCP/IP 
连接 工作 正常 ， 但 不 是 Unix 域 套 接 字 ， 以 防止 工作 着 的 回 为 测试 。 


这 个 问题 报道 给 IBM， 并 且 作 为 bug 报 告 PMR29657 进 行 记录 。 如 果 您 升级 到 维护 级 别 5300- 
03 或 更 高 版 本 ， 这 将 包括 此 修复 程序 。 一 个 快速 解决 方法 是 改 

变 /usr/include/sys/socket.h 中 的 _SS_MAXSIZE 到 1025。 在 这 两 种 情况 下 ， 一 旦 你 有 修正 的 
头 文 件 ， 则 要 重新 编译 PostgreSQL。 


15.7.1.3. 网 络 地 址 问题 


PostgreSQL tk ši FRARI getaddrinfo 豆 数 解析 listen_addresses , pg_hba.conf 中 的 IP 地 
tt, 较 旧 版 本 的 AIX 已 经 划分 出 这 个 函数 中 的 bug。 如 果 您 有 关于 这 些 设置 的 问题 ， 更 新 到 
上 面 显 示 的 相应 的 AIX 补 丁 级 别 应 特别 注意 。 


一 个 用 户 报 告 : 


当 在 AIX 5.3 上 实现 PostgreSQL 版 本 8.1 的 时 候 ， 我 们 周期 性 地 遇 到 了 问题 ， 其 中 统计 收集 器 
可 能 "诡秘 的 "不 会 成 功 。 这 似乎 是 IPv6 实 行 中 意外 行为 的 结果 。 它 看 起 来 像 PostgreSQL 和 
IPV6ZEAIX 5.3 中 不 能 很 好 地 结合 。 


任何 下 面 操作 "修复 "这 个 问题 。 
。 删除 本 地 主机 的 IPv6 地 址 : 


(as root) 
# ifconfig loO inet6 ::1/0 delete 


e 从 网 络 服务 中 删除 IPv6。 在 AlIX 上 的 文件 /etc/netsvc.conf AEX 等 同 于 Solaris/Linux 上 
的 /etc/nsswitch.conf 。 默认 情况 下 ，AIX 上 是 这 样 的 : 


hosts=local, bind 


蔡 换 为 : 


hosts=local4, bind4 


解除 搜索 IPv6 地 址 。 


Warning 


这 的 确 是 有 关 IPv6 支 持 不 成 熟 问题 的 解决 方法 ， 这 在 AIX 5.3 版 本 发 布 期 间 有 明显 改善 。 
它 在 AIX 5.3 版 本 进行 工作 ， 但 并 不 代表 优雅 的 解决 问题 的 办 法 。 报道 称 这 种 解决 方法 不 
仅 是 不 必要 的 ， 而 且 会 在 AlX 6.1 上 导致 问题 ， 其 中 IPv6 的 支持 也 日 渐 成 熟 。 


15.7.1.4. 内 存 管 理 


AlIX 关 于 内 存 管理 方式 上 有 些 特别 。 你 可 以 有 很 多 倍 的 千 兆 字 节 RAM 免 费 的 服务 器 ， 但 是 当 
运行 应 用 程序 时 ， 仍 然 有 内 存 或 地 址 空间 不 足 的 错误 。 createlang 导致 不 寻常 错误 的 例子 。 
比如 ， 作 为 PostgreSQL 安 装 的 所 有 者 运行 : 


-bash-3.00$ createlang plperl template1 
createlang: language installation failed: ERROR: could not load library "/opt/dbs/pgsql7 


DES 


作为 PostgreSQL 安 装 的 非 拥有 者 进行 运行 : 





-bash-3.00$ createlang plperl template1 
createlang: language installation failed: ERROR: could not load library "/opt/dbs/pgsql7 


另 一 个 例子 是 在 PostgreSQL 服 务 器 日 志 中 内 存 不 足 的 错误 ， 与 每 个 内 存 分 配 接近 或 者 大 于 
256 MB。 





所 有 这 些 问 题 的 总 体 原因 是 默认 bittedness 并 且 使 用 服务 器 进程 的 内 存 模 型 。 默认 情况 下 ， 所 
有 的 在 AIX 上 编译 的 二 进 制 文件 是 32 位 。 这 不 依赖 于 使 用 的 硬件 类 型 或 内 核 。 这 些 32 位 进程 
是 使 用 一 些 模型 之 一 将 4 GB 内 存 限制 为 256 MB 的 段 大 小 。 默认 人 允许 堆 内 小 于 256 MB, 因为 
它 共 享 单独 的 段 与 堆栈 。 


在 支持 createlang 的 情况 下 ， 上 面 检查 你 的 PostgreSQL 安 装 中 的 umask 和 二 进 制 文件 的 权 
限 。 参与 该 示例 中 的 二 进 制 文件 分 别 为 32 位 和 安装 模式 是 750 而 不 是 755。 因为 权限 被 以 这 
种 方式 设置 ， 只 有 进程 组 中 的 所 有 者 或 成 员 才 可 以 加 载 库 。 因为 它 不 是 被 所 有 人 可 读 的 ， 加 
载 器 将 对 象 置信 过 程 堆 而 不 是 共享 库 段 ， 它 放置 在 那里 。 

此 问题 的 "理想 "解决 方案 是 使 用 64 位 PostgreSQL 编 译 ， 但 事实 并 非 总 是 可 行 的 ， 因 为 32 位 处 
理 器 系统 可 以 进行 ， 但 不 能 运行 64 位 二 进 制 文件 。 


如 果 需 要 32 位 二 进 制 ， 设置 LDR_CNTRL 到 MAXDATA=0x``_n 0000000, HH1 <=n<=8, É 
动 PostgreSQL 服 务 器 之 前 ， 党 试 不 同 的 值 并 且 设置 postgresql.conf 以 找到 合理 运行 的 配 
i. LprR_cNTRL 的 使 用 告诉 AIX 你 想 要 服务 器 有 MAxpATA 字 节 空闲 给 堆 ， 分 配 256 MB 的 段 。 


当 你 找到 一 个 可 行 的 配置 ， ldedit 可 以 用 来 修改 二 进 制 文件 ， 他 们 默认 使 用 所 需 的 堆 大 小 。 
PostgreSQL 可 以 也 被 重新 编译 ， 通过 配 
G configure LDFLAGS="-W1, -bmaxdata:0x``_n_ 0000000" 达 到 同样 的 效果 。 


对 于 64 位 版 本 ， 设 置 oeJEcT_MopE 为 64 并 且 传 

递 CC="gcc -maix64" 和 LDFLAGS="-W1, -bbigtoc" 到 configure o ( xlc 选项 可 能 有 所 不 
fal, ) 如 果 省 略 oBJEcT_MopE 的 输出 ， 您 可 能 产生 链接 器 错误 。 当 设置 oBsect_mope 的 时 
Iž, 它 告诉 AIX 编 译 工具 如 ar, as 和 1d 默认 义理 对 象 的 类 型 。 


默认 情况 下 ， 可 能 发 生 分 页 空间 过 量 使 用 。 虽然 我 们 没 见 过 这 种 情况 发 生 ， 当 它 用 完 内 存 并 
且 产 生 过 量 访问 时 ，AIX 将 杀 有 死 进程 ， 最 接近 这 一 点 的 是 我 们 所 看 到 的 是 交叉 失败 ， 因 为 系统 
决定 没有 足够 的 内 存 用 于 另 一 个 进程 。 像 许多 其 他 的 AIX 部 分 ， 如 果 这 产生 问题 ， 那 么 分 页 
空间 分 配方 法 及 内 存 不 足 杀 进程 在 系统 或 进程 范围 基础 上 是 可 配置 。 


参考 文献 和 资源 


"Large Program Support", AIX Documentation: General Programming Concepts: Writing and 
Debugging Programs. 


"Program Address Space Overview", AIX Documentation: General Programming Concepts: 
Writing and Debugging Programs. 


"Performance Overview of the Virtual Memory Manager (VMM)", AIX Documentation: 
Performance Management Guide. 


"Page Space Allocation", AIX Documentation: Performance Management Guide. 
"Paging-space thresholds tuning", AIX Documentation: Performance Management Guide. 


Developing and Porting C and C++ Applications on AIX, IBM Redbook. 


15.7.2. Cygwin 
PostgreSQL 可 以 使 用 Cygwin，Windows 的 类 Linux 环 境 进 行 编 译 ， 但 该 方法 不 如 本 地 
Windows 编 译 (参阅 Chapter 16), 并 且 不 再 推荐 在 Cygwin 下 运行 服务 器 。 


当 从 源码 进行 编译 时 ， 按 照 正常 的 安装 程序 进行 (也 就 是 ./configure;make ) ， 注意 下 面 的 
Cygwin 特 殊 差 有 异 : 


。 在 Windows 功 能 之 前 使 用 Cygwin bin 目 录 设 置 你 的 路 径 。 这 有 助 于 避免 编译 问题 。 
e GNU make 命 令 称 为 make 而 不 是 gmake o 


e 不 支持 adduser 命令 ; 在 Windows NT,2000 或 者 XP 上 使 用 适当 的 用 户 管理 点 用 。 否 则 ， 
忽略 这 一 步 。 


。 不 支持 su 命令 ; Windows NT,2000 或 者 XP 上 使 用 ssh 模 拟 Su。 否 则 ， 忽 略 这 一 步 。 
e 不 支持 OpenSSL。 


e 为 了 共享 内 存 支 持 开 启 cygserver 。 要 做 到 这 一 点 ， 输 入 命令 /usr/sbin/cygserver& o 
这 个 程序 需要 运行 于 任何 时 候 ， 你 启动 PostgreSQL 服 务 器 或 初始 化 一 个 数据 库 集群 
( initdb ) 。 可 能 需要 改变 默认 cygserver 配置 (例如 ， 增 加 semmns ) 以 避免 由 于 缺 
乏 系 统 资源 而 导致 的 PostgreSQL 失 败 。 


。 在 某 些 系统 上 编译 可 能 会 失败 ， 它 使 用 的 语言 环境 不 是 C。 为 了 解决 这 个 问题 ， 在 编译 
之 前 通过 执行 export LANG=c.utf8 设置 区 域 到 C， 并 且 ， 你 已 经 安装 完 PostgreSQL 之 
后 ， 设 置 它 返回 到 以 前 的 设置 。 


平行 回 为 测试 ( make check ) 可 以 产生 伪 回 轨 测 试 失 败 ， 由 于 listen() 积压 队列 浴 
出 ， 这 会 导致 连接 拒绝 错误 或 挂 起 。 你 可 以 使 用 make 变 量 max_connections 限制 连接 
数 ， 因 此 : 


make MAX_CONNECTIONS=5 check 


在 某 些 系统 上 你 最 多 可 以 有 10 个 并 发 连接 。 


可 能 安装 cygserver 和 作为 Windows NT 服务 的 PostgreSQL 服 务 器 。 关于 如 何 做 的 信息 ， 请 
参阅 包含 Cygwin 上 的 PostgreSQL 二 进 制 包 的 README 文档 。 它 被 安装 在 目 
录 /usr/share/doc/Cygwin 中 。 


15.7.3. HP-UX 


PostgreSQL 7.3+ 应 该 在 运行 HP-UX 10.X 或 者 11.X 的 系列 700/800 PA-RISC 机 器 上 工作 ， 给 
予 相 应 的 系统 补丁 级 别 和 编译 工具 。 至 少 有 一 个 开发 者 经 常 在 HP-UX 10.20 上 测试 。 并 且 ， 
我 们 在 HP-UX 11.00 和 11.11 上 有 成 功 安装 的 报道 。 


除了 PostgreSQL 源 代码 发 布 外 ， 您 将 需要 GNU make (HP make 不 能 执行 ) ， 以 及 GCC 或 
HP 的 完整 ANSI C 编译 器 。 如 果 你 打算 从 Git 源 代 码 而 不 是 发 布 包 编 译 ， 你 还 需要 Flex (GNU 
lex) 和 Bison (GNU yacc)。 我 们 建议 确保 你 是 最 新 的 HP 补丁 。 至 少 ， 如 果 你 正在 HP-UX 
11.11 上 编译 64 位 二 进 制 文件 ， 您 可 能 需要 PHSS_30966 (11.11) 或 者 后 继 补丁 ， 否 

则 initdb 可 能 会 挂 起 : 


PHSS 30966 s700_800 Id(1) and linker tools cumulative patch 


一 般 原则 ， 你 应 该 使 用 当前 的 libc 和 Id/dld 补 丁 程序 ， 以 及 编译 器 补丁 ， 如 果 你 正在 使 用 HP C 
编译 器 。 请 参阅 HP 支持 网 站 ， 上 比如 http://itrc.hp.com 和 ftp://us-ffs.external.hp.com/ 免 费 的 最 
新 补丁 副本 。 


如 果 你 正在 PA-RISC 2.0 的 机 器 上 编译 ， 并 希望 使 用 GCC 的 64 位 二 进 制 文件 ， 你 必须 使 用 
GCC 的 64 位 版 本 。HP-UX PA-RISC 的 GCC 二 进 制 和 Itanium 可 以 从 hitp://www.hp.com/go/gcc 
获得 。 不 不 要 忘 了 在 同一 时 间 安装 binutils。 


如 果 你 想 在 PA-RISC 2.0 机 器 上 编译 ， 并 且 在 PA-RISC 1.1 机 器 上 编译 二 进 制 ， 你 需要 声 
BA cFLAGs 中 的 +DAportable o 


如 果 你 在 HP-UX Itanium 机 器 上 进行 编译 ， 你 将 需要 带 有 依赖 包 或 者 继承 补丁 的 最 新 HP ANSI 
C 编 译 器 。 

PHSS 30848 s700_800 HP C Compiler (A.05.57) PHSS 30849 s700 800 
u2comp/be/plugin library Patch 


如 果 你 有 HP 的 C 编 译 器 和 GCC， 那 么 当 你 运行 configure 时 ， 可 能 想 要 明确 选择 使 用 的 编译 
器 。 


./configure CC=cc 


对 于 HP 的 C 编 译 器 ， 或 者 


./configure CC=gcc 


GCC。 如 果 你 忽略 这 些 设置 ， 那 么 如 果 它 有 选择 的 话 ，configure 将 选择 gce o 


缺 省 安装 目标 位 置 是 /usr/local/pgsql ， 你 可 能 想 要 在 /opt 下 改变 一 些 内 容 。 如 果 这 样 ， 
使 用 --prefix 切换 configure 。 

在 回 为 测试 中 ， 可 能 有 一 些 几 何 测试 中 的 低 阶 位 数 差异 ， 这 取决 于 您 使 用 的 编译 器 和 数学 库 
版 本 的 不 同 而 不 同 。 任何 其 他 错误 都 是 合 人 怀疑 的 。 


15.7.4. IRIX 


PostgreSQL 已 在 MIPS r8000, r10000 (ip25 和 ip27) 以 及 r12000(ip35) 处 理 器 成 功 运 行 ， 运行 
在 IRIX 6.5.5m, 6.5.12, 6.5.13 和 6.5.26 与 MIPSPro 编 译 器 版 本 7.30, 7.3.1.2m, 7.3 和 7.4.4m。 


您 将 需要 MIPSPro 完 整 ANSI C 编 译 器 。 尝 试 与 GCC 编 译 存在 问题 。 这 是 关于 使 用 函数 返回 某 
种 结构 的 众所周知 的 GCC bug (不 固定 为 3.0 版 本 ) 。 此 错误 会 影响 功能 ， 如 inet_ntoa , 
inet_lnaof , inet_netof , inet_makeaddr , #0 semctl 。 它 被 认为 是 固定 的 ， 迫使 代码 链接 使 
用 libgcc 的 那些 函数 ， 但 是 这 并 没有 被 测试 过 。 


MIPSPro 编 译 器 的 7.4.1m 版 本 产生 错误 代码 是 已 知 的 。 当 党 试 启动 数据 库 时 ， 现 象 是 "无 效 主 
节点 记录 "。 版 本 7.4.4m 可 行 ; 中 间 版 本 的 状态 是 不 确定 的 。 


有 可 能 是 编译 问题 ， 如 下 : 


cc-1020 cc: ERROR File = pqcomm.c, Line = 427 
The identifier "TCP_NODELAY" is undefined. 


if (setsockopt(port->sock, IPPROTO_TCP, TCP_NODELAY, 


一 些 版 本 包括 在 sys/xti.h 中 的 TCP 定 义 ， 因此 在 src/backend/libpq/pqcomm.c 和 
src/interfaces/libpq/fe-connect.c 中 添加 #include &lt;sys/xti.h&gt; 是 必要 的 。 A RTS 
到 这 类 问题 ， 请 让 我 们 知道 ， 以 便于 我 们 可 以 制定 合适 的 修复 。 


a 可 能 有 一 些 几 何 测 试 中 的 低 阶 位 数 的 差异 ， 依 赖 于 你 使 用 的 FPU。 任何 其 他 
错误 都 值得 怀疑 。 


15.7.5. MinGW/Native Windows 


Windows 下 的 PostgreSQL 可 以 使 用 MinGW， 微 软 操作 系统 的 类 Unix 编 译 环境 ， 或 者 使 用 微 
软 的 Visual C++ 编译 器 套件 编译 。 MinGW 的 编译 版 本 采用 本 章 中 描述 的 正常 编译 系统 ; Visual 
C++ 编 译 工作 完全 不 同 ， 并 且 在 Chapter 16 中 描述 。 它 完全 是 一 种 本 地 编译 ， 并 且 没 有 使 用 
像 MinGW 的 额外 软件 。 现成 的 安装 程序 可 以 从 PostgreSQL 的 网 站 上 获得 。 


本 地 Windows 端 口 需要 Windows 2000 或 更 高 的 32 或 64 位 版 本 。 早 期 操作 系统 没有 足够 的 基 
础 设施 (但 Cygwin 可 以 使 用 这 些 信 息 ) 。 MinGW， 类 Unix 编 译 工具 ， 以 及 MSYS，Unix 工 具 

合 需要 运行 类 似 于 configure 的 shell 脚 本 ， 可 以 从 http://www.mingw.org/ 下 载 。 两 者 都 不 
需要 运行 生成 的 二 进 制 文件 ; 他 们 只 需要 创建 二 进 制 文件 。 


要 使 用 MinGW 编 译 64 位 二 进 制 文件 ， 安 装 来 自 http://mingw-w64.sourceforge.net/ 的 64 位 工具 
Se, 将 其 bin 目 录放 在 PATH 中 ， 并 运行 --host=x86_64-w64-mingw 选项 的 configure 命令。 


您 已 经 安装 了 一 切 之 后 ， 建 议 您 在 cmp.EXE 下 运行 psql， 作为 MSYS 控 制 台 有 缓冲 问题 。 


15.7.5.1. Windows 上 搜索 崩溃 转 储 


如 果 PostgreSQL 在 Windows 月 湾 ， 有 可 能 产生 minidumps 可 用 于 跟踪 崩 汪 的 原因 ， 类 似 于 在 
Unix 上 的 核心 转 储 。 这 些 转 储 可 以 使 用 Windows 调 试 器 工具 或 者 Visual Studio 读 取 。 ASA 
动 Windows 上 的 转 储 ， 创建 名 为 集群 数据 目录 里 的 crashdumps 的 子 目录 。 转 储 将 被 写 入 到 
该 目录 ， 连 同 基于 月 演进 程 识别 符 和 崩溃 当前 时 间 的 唯一 名 称 。 


15.7.6. SCO OpenServer 和 SCO UnixWare 


PostgreSQL 可 以 在 SCO UnixWare 7 和 SCO OpenServer 5 上 编译 。 在 OpenServer 上 ， 你 可 
de Development Kit 或 者 Universal Development Kit, 然而 ， 可 能 需要 一 些 
周 整 ， 正如 下 面 描述 的 。 


15.7.6.1. Skunkware 


你 应 该 找到 你 的 SCO Skunkware CD 的 副本 。 Skunkware CD 附带 UnixWare 7 和 OpenServer 

5 当前 版 本 。 Skunkware 包 括 可 从 互联 网 获得 的 许多 流行 程序 的 准备 安装 版 本 。 例如 ，gzip， 

gunzip, GNU Make, Flex 和 Bison。 对 于 UnixWare 7.1， 这 个 光盘 现在 标 有 "开放 式 许 可 软件 
补充 "， 如 果 你 没有 这 个 光盘， 可 以 从 http://www.sco.com/skunkware/ 获 得 。 


Skunkware 有 UnixWare 和 OpenServer 的 不 同 版 本 。 请 确保 您 安装 了 您 的 操作 系统 的 正确 版 
本 ， 除 非 另 有 说 明 如 下 。 


在 UnixWare 7.1.3 及 以 上 ， 包 含 在 UDK CD 上 的 GCC 编译 器 作为 GNU Make, 


15.7.6.2. GNU Make 


您 需要 使 用 GNU make 程 序 ， 位 于 Skunkware CD。 默 认 情 况 下 ， 它 作 
为 /usr/local/bin/make 安装 。 为 了 避免 混淆 SCO make 程序 ， 你 可 能 需要 重 命 名 
GNU make 为 gmake 。 


由 于 UnixWare 7.1.3 及 以 上 ，GNU Make 程 序 是 UDK CD 的 OSTK 部 分 ， 并 且 位 
于 /usr/gnu/bin/gmake 。 


15.7.6.3. Readline 


Readline 库 在 Skunkware CD 上 。 但 它 不 包括 在 UnixWare 7.1 Skunkware CD 上 。 如 果 你 有 
UnixWare 7.0.0 或 者 7.0.1 Skunkware CD， 您 可 以 从 那里 安装 。 否则 ， 党 试 
http://www.sco.com/skunkware/, 


缺 省 情况 下 ，Readline 安 装 在 /usr/local/lib 和 /usr/local/include > 然而 ， 没 有 帮助 的 情 
况 下 PostgreSQL configure 程序 不 能 找到 ， 如 果 你 安装 Readline, 那 么 使 用 configure 的 下 
列 选 项 


./configure --with-libraries=/usr/local/lib --with-includes=/usr/local/include 


15.7.6.4. 在 OpenServer 使 用 UDK 
如 果 你 正在 OpenServer 上 使 用 新 的 通用 开发 Kit (UDK) 编 译 器 ， 你 需要 声明 UDK 库 的 位 置 


./configure --with-libraries=/udk/usr/lib --with-includes=/udk/usr/include 


将 上 面 这 些 与 Readline 选 项 放 在 一 起 : 


./configure --with-libraries="/udk/usr/lib /usr/local/lib" --with-includes="/udk/usr/incl 


‘ = _ B 








15.7.6.5. 阅读 PostgreSQL 手 册页 


缺 省 情况 下 ，PostgreSQL 手 册页 安装 在 /usr/local/pgsql/man > 缺 省 UnixWare 不 能 查阅 手 
册页 ， 为 了 可 用 查看 你 需要 修改 /etc/default/man 中 的 MANPATH 变量 ， 比如 : 


MANPATH=/usr/lib/scohelp/%L/man: /usr/dt/man: /usr/man: /usr/share/man: scohelp:/usr/local/ma 








在 OpenServer 上 ， 需 要 投入 一 些 额 外 研究 形成 可 用 手册 页 ， 因 为 它 不 同 于 其 他 的 平台 。 目 
前 ，PostgreSQL 根 本 不 安装 。 


15.7.6.6. 7.1.1b 功 能 补充 的 C99 问 题 


对 于 先 于 发 布 OpenUnix 8.0.0 (UnixWare 7.1.2) 的 编译 器 ， 包 括 7.1.1b 功 能 补充 ， 你 可 能 需 
要 在 crcs 或 者 cc 环境 变量 中 指定 -xb 。 这 个 指示 是 编译 tuplesort.c 中 引用 内 联 功能 此 
一 个 错误 。 显然 ， 有 7.1.2 (8.0.0) 编译 器 及 以 上 的 变化 。 


15.7.6.7. UnixWare 上 的 线程 


对 于 线程 ， 你 必须 在 所 有 使 用 libpq 的 程序 上 使 用 -Kpthread o libpq 使 用 pthread_* 调用 ， 其 
中 只 有 -kpthread / -Kthread 标志 可 用 。 


15.7.7. Solaris 


PostgreSQL 在 Solaris 上 有 很 好 的 支持 。 更 新 操作 系统 越 多 ， 您 将 遇 到 越 少 的 问题 ; 详细 信息 
请 参见 下 面 。 


15.7.7.1. 所 需 工 具 


您 可 以 使 用 GCC 或 Sun 的 编译 器 套件 进行 编译 。 为 更 好 的 代码 优化 ， 在 SPARC 架 构 上 强烈 推 
荐 Sun 的 编译 器 。 当 推荐 使 用 GCC 2.95.1; GCC 2.95.3 或 更 高 版 本 的 时 候 ， 我 们 已 经 听 到 问题 
报告 。 如 果 您 正在 使 用 Sun 的 编译 器 ， 请 注意 不 要 选择 /usr/ucb/cc ;而 使 用 
/opt/SUNWspro/bin/cc o 


#8 BY LA Mhttp://www.oracle.com/technetwork/server-storage/solarisstudio/downloads/ F #& 

Sun Studio, 许多 GNU 工 具 都 集成 到 Solaris 10 上 ， 或 者 它们 目前 在 Solaris companion CD 
上 。 如 果 你 喜欢 Solaris 旧 版 本 的 包 ， 你 可 以 从 http://www.sunfreeware.com 中 找到 这 些 工具 。 
如 果 你 喜欢 源码 ， 可 以 参阅 http://www.gnu.org/order/ftp.html。 


15.7.7.2. OpenSSL) & 


当 您 使 用 OpenSSL 编 译 PostgreSQL 的 时 候 ， 你 可 能 会 得 到 以 下 文件 中 的 编译 错误 : 
e =src/backend/libpq/crypt.c 
e src/backend/libpgq/password.c 
e src/interfaces/libpq/fe-auth.c 


e src/interfaces/libpq/fe-connect.c 


这 是 因为 在 标准 的 /usr/include/crypt.h 头 部 以 及 OpenSSL 所 提供 的 头 文 件 之 间 有 命名 空间 


冲突 。 


升级 您 的 OpenSSL 安 装 到 版 本 0.9.6a 修 复 了 这 个 问题 。Solaris 9 和 上 面 有 OpenSSL 的 较 新 版 
本 。 


15.7.7.3. configure 抱 怨 失 败 测 试 程序 

如 果 configure 抱怨 失败 的 测试 程序 ， 这 可 能 是 运行 时 链接 程序 无 法 找到 一 些 库 的 情况 ， 可 
能 libz, libreadline 或 一 些 其 他 非 标准 库 如 libssl。 为 了 指向 正确 的 位 置 ， 在 configure MATT 
上 设置 LpFLA6s 环境 变量 。 比如 : 


configure ... LDFLAGS="-R /usr/sfw/1lib:/opt/sfw/1lib: /usr/local/1lib" 
参阅 ld 手册 页 获取 更 多 详情 。 


15.7.7.4. 64 位 编译 有 时 月 渍 


在 Solaris 7 以 及 更 高 版 本 ，64 位 版 本 的 libc 中 有 一 个 vsnprintf 程序 ， 从 而 导致 PostgreSQL 
中 不 稳定 的 核心 转 储 。 最 简单 的 已 知 的 解决 方法 是 强制 PostgreSQL 使 用 vsnprintf 自己 的 版 
本 ， 而 不 是 库 副 本 。 要 做 到 这 一 点 ， 运 行 configure 之 后 编辑 configure 产生 的 文件 : 
src/Makefile.global 中 ， 更 改行 


LIBOBJS = 


读 取 


LIBOBJS = snprintf.o 
(可 能 还 有 其 他 在 这 个 变量 中 已 经 列 出 的 文件 。 顺 序 无 关 紧 要 。) 然后 编译 照常 。 


15.7.7.5. 编译 以 获得 最 佳 性 能 


SPARC 架 构 上 ， 强 烈 推荐 Sun Studio 编 译 。 尝 试 使 用 -xo5 优化 标志 产生 显著 快速 的 二 进 制 
文件 。 不 要 使 用 任何 的 标志 修改 浮 点 运算 的 行为 以 及 errno 处 理 (例如 ， -fast ) 。 这 些 标 
志 可 以 提高 一 些 日 期 /时 间 计 算 中 的 PostgreSQL 不 规范 行为 。 


如 果 您 没有 理由 在 SPARC 上 使 用 64 位 二 进 制 文件 ， 更 喜欢 32 位 版 本 。64 位 运算 速度 较 慢 ， 
并 且 64 位 二 进 制 比 32 位 更 慢 。 另 一 方面 ， 在 AMD64 CPU 族 中 的 32 位 代码 不 是 本 地 的 ， 这 就 
是 为 什么 32 位 代码 在 这 个 CPU 族 中 显著 慢 的 原因 。 


15.7.7.6. 使 用 DTrace 追 踪 PostgreSQL 


是 的 ， 有 可 能 使 用 DTrace。 参 阅 Section 27.4 获 取 更 多 信息 。 你 也 可 以 通过 文章 
https://blogs.oracle.com/robertlor/entry/user_level_dtrace_probes in 查找 更 多 的 信息 。 





如 果 您 看 到 postgres 执行 中 断 与 错误 信息 的 连接 ， 如 : 


Undefined first referenced 
symbol in file 

AbortTransaction utils/probes.o 

CommitTransaction utils/probes.o 


ld: fatal: Symbol referencing errors. No output written to postgres 
collect2: ld returned 1 exit status 
gmake: *** [postgres] Error 1 
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Chapter 16. Windows 下 用 源 代码 安装 
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o 16.1.5. 运行 回 为 测试 
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e 16.2. 用 Visual C++ 或 Borland C++ 编译 libpq 


对 于 需要 在 windows 下 安装 PostgreSQL 的 大 多 数 普 通用 户 来 说 ， 推荐 从 官网 下 载 图 形 化 界面 
的 二 进 制 安装 包 。 源 代码 安装 主要 面向 PostgreSQL 开 发 人 员 及 相关 扩展 插件 的 开发 人 员 。 


在 Windows 中 ,有 多 种 方法 编译 安装 PostgreSQL。 对 于 微软 工具 的 话 ， 最 简单 的 方法 是 安装 
一 个 Visual Studio Express 2012 for Windows Desktop， 并 使 用 它 自 带 的 编译 器 进行 编译 。 
也 可 以 使 用 Microsoft Visual C++ 2005, 2008 or 2010 来 编译 安装 。 在 一 些 情况 下 ， 除 了 编译 
器 还 需要 安装 Windows SDK。 


此 外 ， 可 以 使 用 MinGW 提 供 的 GNU 编 译 工具 来 编译 PostgreSQL。 如 果 Windows 系 统 版 本 比 
较 旧 ， 可 以 使 用 Cygwin 进 行 编译 安装 。 


最 后 ， 为 了 兼容 静态 链接 (libpq) 的 应 用 ， 可 以 用 Visual C++ 7.1 或 Borland C++ 来 编译 libpq。 


使 用 MinGW 或 者 Cygwin 的 普通 编译 系统 的 话 ， 可 以 参看 Chapter 15 及 Section 15.7.5 和 
Section 15.7.2。 要 在 这 些 环境 中 生成 原生 的 64 位 可 执行 程序 ， 可 以 使 用 MinGW-w64 工 具 。 

这 些 工具 也 可 以 在 其 它 的 平台 下 执行 交叉 编译 ， 生 成 32 位 或 64 位 的 Windows 可 执行 程序 ， 例 
如 Linux 和 Darwin 系 统 。 在 生产 环境 中 不 推荐 使 用 Cygwin， 它 仅 适合 用 于 Windows 98 等 比 
较 旧 的 Windows 版 本 上 的 编译 器 编译 不 了 时 使 用 。 官方 的 的 二 进 制 可 执行 文件 是 由 Visual 
Studio 编 译 的 。 


原生 的 psql 可 执行 程序 不 支持 命令 行 编辑 。 而 Cygwin 编 译 的 可 执行 文件 支持 命令 行 编 辑 ， 
此 需要 在 Windows 下 交互 式 使 用 psql 的 话 ， 应 该 使 用 这 种 方式 编译 。 


16.1. 用 Visual C++ 或 Microsoft Windows SDK 编 
译 


PostgreSQL 可 以 使 用 微软 的 Visual C++ 编译 器 套件 来 编译 。 这 些 编译 器 可 以 是 Visual Studio, 
Visual Studio Express 或 者 某 些 版 本 的 Microsoft Windows SDK, 如 果 没 有 安装 Visual Studio 
的 环境 ， 最 简单 的 方法 是 使 用 Windows SDK 7.1 或 者 Visual Studio Express 2012 for 
Windows Desktop 中 的 编译 器 , 它们 都 可 以 从 微软 官网 免费 下 载 。 


PostgreSQL 支 持 从 Visual Studio 2005 到 Visual Studio 2012( 包 括 精简 版 ) 的 编译 器 , 以 及 6.0 到 
7.1 版 本 的 独立 的 Windows SDK 编 译 器 。 64 位 的 PostgreSQL 只 支持 6.0a 到 7.1 版 本 的 
Microsoft Windows SDK 和 Visual Studio 2008 及 其 以 上 版 本 。 


用 Visual C++ 或 Platform SDK 编 译 的 工具 在 src/tools/msvc 目录 下 。 编译 时 ， 确 保 系 统 路 径 
下 没有 包含 MinGW 或 Cygwin 的 工具 ， 同 时 所 需要 的 Visual C++ 工具 在 系统 路 径 下 是 可 用 的 。 
在 Visual Studio, 4 %Visual Studio Command Prompt. 如 果 需 要 编译 64 位 的 版 本 ， 使 用 
64 位 版 本 的 命 舍 ， 反 之 亦 然 。 在 Microsoft Windows SDK 中 ， 从 开始 菜单 中 SDK 下 的 列表 局 
动 CMD shell。 在 最 新 版 的 SDK 中 ， 你 可 以 使 用 setenv 等 命令 来 更 改 目 标的 CPU 架构 ， 编 译 
类 型 和 操作 系统 类 型 。 指令 setenv /x86 /release /xp 用 来 编译 Windows XP 或 更 新 的 32 位 版 
A, 使 用 /? 命令 可 以 查看 setenv 的 其 它 用 法 。 所 有 命令 都 应 该 在 src\tools\msvc 目录 下 
运行 。 

在 编译 前 ， 根 据 需 要 修改 config.pl 中 相应 选项 和 使 用 到 的 第 三 方 库 的 路 径 。 完整 的 配置 由 
首先 读 取 和 解析 的 config_default.pl 决定 ， 然 后 从 config.pl 获取 变更 。 例如 ， 为 了 指定 
Python 的 安装 路 径 ， 在 config.pl 文件 中 添加 以 下 语句 : 


$config->{python} = 'c:\python26'; 


只 需要 指定 和 config_default.pl 文件 中 有 差别 的 参数 。 


如 果 需 要 指定 其 它 的 环境 变量 ， 创 建 一 个 buildenv.pl 文件 并 写 入 所 需要 的 命令 。 例如 ， 为 
了 在 PATH 中 添加 一 个 还 不 存在 的 bison 变 量 ， 创 建 一 个 文件 包含 以 下 内 容 : 


$ENV{PATH}=$ENV{PATH} . ';c:\some\where\bison\bin'; 


16.1.1. 要 求 


编译 PostgreSQL 还 需要 以 下 几 个 工具 。 使 用 config.pl 文件 来 指定 这 些 库 的 路 径 。 


Microsoft Windows SDK 


如 果 编 译 环境 不 兼容 所 支持 的 Microsoft Windows SDK 版 本 ， 建议 把 SDK 的 版 本 升级 到 最 新 
的 版 本 (目前 为 7.1 版 本 ), 下 载 地 址 为 http://www.microsoft.com/downloads/。 


在 SDK 中 ， 必 须要 保证 包含 Windows Headers and Libraries 这 部 分 内 容 。 如 果 安 装 的 
Windows SDK 中 已 经 包含 了 Visual C++ Compilers, 就 不 再 需要 使 用 Visual Studio 进 行 编译 
了 。 注意 Windows SDK 8.0a 之 后 的 版 本 不 再 附 有 完整 的 命令 行 编译 环境 。 


ActiveState Perl 


ActiveState Perl 用 于 编译 生成 脚本 ， 而 MinGW 或 Cygwin 的 Perl 则 不 起 作用 。 同样 ， 它 的 路 径 
也 要 添加 到 系统 路 径 中 。 二 进 制 文件 下 载 地 址 为 http://www.activestate.com (注意 : 必须 使 用 
5.8 或 者 更 新 的 版 本 ， 免费 的 标准 版 既 可 ) 。 


下 面 的 工具 在 开始 时 是 不 需要 的 ， 但 是 对 于 完整 的 包 的 编译 是 必须 的 。 使 用 config.pl 文件 
来 指定 这 些 库 的 路 径 。 

ActiveState TCL 

用 于 编译 PL/ITCL( 注 意 : 要 求 8.4 版 本 ， 免费 的 标准 版 既 可 ) 。 

Bison and Flex 


Bison and Flex 用 来 从 GIT 进 行 编译 ， 对 于 发 行 版 文件 的 编译 是 不 需要 的 。 Bison 需 要 1.875 或 
2.2 及 更 新 版 本 。Flex 需 要 使 用 2.5.31 或 更 新 版 本 。 


Bison and Flex 包 含 在 msys 工 具 套 件 内 。 作为 MinGW 编 译 器 套件 的 一 部 分 ，msys 可 以 从 
http://www.mingw.org/wiki/MSYS 下 载 。 同时 作为 msysGit 的 一 部 分 ，msys 也 可 以 从 http://git- 
scm.com/ 下 载 。 


在 buildenv.pl 中 ， 需要 把 包含 flex.exe 和 bison.exe 的 目录 添加 到 系统 路 径 中 ， 除非 它们 
已 经 存在 于 系统 路 径 中 。 对 于 MinGW, 要 把 MinGW 安 装 目录 的 子 目 录 路 径 \msys\1.0\bin 添加 
到 系统 路 径 中 。 对 于 msysGit, 要 把 Git 安 装 目录 下 的 bin 目录 添加 到 系统 路 径 中 。 不 要 添加 
MinGW 编 译 工 具 本 身 的 目录 到 系统 路 径 中 。 


Note: GnuWin32 中 的 Bison 存 在 一 个 bug， 当 文件 安装 的 路 径 中 含有 空格 的 时 候 ， 会 导致 
Bison 出 现 故 障 。 例如 ， 用 英文 安装 时 的 默认 路 径 c:\program Files\Gnuwin32 时 会 出 现 
上 述 问题 ， 解 决 办 法 是 安装 在 类 似 c:\cnuwins2 这 样 的 目录 ， 或 者 在 GnuWin32 的 环境 
变量 PATH 中 使 用 NTFS 短 名 称 路 径 ( 例 如 c:\PROGRA~1\GnuWin32 )。 


Note: 在 PostgreSQL FTP 上 的 winflex 是 旧 的 二 进 制版 本 ， 在 64 位 Windows 主 机 上 执行 
at, 会 报 "flex: fatal internal error, exec failed" 的 错误 。 可 以 使 用 msys 中 的 flex 来 替代 以 
避免 这 个 问题 。 


Diff 


Diff FA #47 [El ya 3X, BT LAMhttp://gnuwin32.sourceforge.net F Ro 


Gettext 


Gettext 用 于 编译 NLS 支 持 ， 可 以 从 http://gnuwin32.sourceforge.net 下 载 。 需要 注意 的 是 二 进 
制 ， 依 赖 项 和 开发 文件 都 需要 。 


MIT Kerberos 


MIT Kerberos 用 于 提供 Kerberos 认 证 支持 ， 可 以 从 
http://web.mit.edu/Kerberos/dist/index.html F #&. 


libxml2 and libxslt 


libxml2 和 libxslt 用 于 提供 XML 支 持 。 可 以 从 hitp://zlatkovic.com/pub/libxml 下 载 二 进 制 文件 ， 
也 可 以 从 http://xmlsoft.org 下 载 源 代码 。 需 要 注意 ，libxml2 需 要 iconv， 也 在 上 面 的 地 址 下 载 。 


openssl 


openss| 用 于 提供 SSL 支 持 。 可 以 从 http://www.slproweb.com/products/Win32OpenSSL.html 
下 载 二 进 制 文件 ， 或 者 在 http://www.openssl.org 下 载 源 代码 。 


ossp-uuid 

ossp-uuid 用 于 提供 UUID-OSSP 支 持 ( 仅 用 于 contrib)。 可 以 从 http://www.ossp.org/pkgllib/uuid/ 
下 载 。 

Python 

Python 用 于 编译 PL/Python。 可 以 从 http://www.python.org 下 载 。 

zlib 


zlib 用 于 为 pg_dump 和 pg_restore 提 供 压缩 支持 。 可 以 从 http:/www.zlib.net 下 载 二 进 制 文件 。 


16.1.2. 针对 64 位 Windows 的 注意 事项 


PostgreSQL 的 X64 架构 只 能 在 64 位 Windows 系 统 上 编译 ， 不 支持 安 腾 处 理 器 。 


同一 个 编译 树 上 不 支持 32 位 和 64 位 的 混 编 。 编 译 系 统 能 自动 检测 平台 环境 是 32 位 或 64 位 ， 并 
编译 出 对 应 版 本 。 因 此 ， 在 编译 前 启动 正确 的 命令 行 很 重要 。 


在 服务 器 端 使 用 python 或 openssl 这 样 的 第 三 方 库 ， 必 须 是 64 位 的 。64 位 服务 器 上 不 支持 对 32 
位 库 的 加 载 。 一 些 第 三 方 库 只 支持 32 位 的 PostgrSQL， 这 种 情形 下 ， 它 们 不 能 用 在 64 位 的 
PostgreSQL, 


16.1.3. 编译 


使 用 发 行 版 配置 (默认 ) 来 编译 完整 的 PostgreSQL， 运 行 命 令 : 


<kbd class="literal">build</kbd> 


使 用 调试 配置 来 编译 完整 的 PostgreSQL， 运 行 命令 : 


<kbd class="literal">build DEBUG</kbd> 


只 编译 单个 项 目 ， 例 如 psql， 运 行 命令 : 


<kbd class="literal">build psql</kbd> 
<kbd class="literal">build DEBUG psql</kbd> 


要 将 默认 的 编译 配置 改 为 调试 配置 ， 需 要 在 buildenv.pl 文件 中 加 入 下 面 的 内 容 : 


$ENV{CONFIG}="Debug"; 


也 可 以 Visual Studio 的 图 形 化 界面 来 编译 ， 这 时 需要 在 命令 行 中 运行 : 


<kbd class="literal">perl mkvcbuild.pl</kbd> 


然后 在 Visual Studio 中 打开 pgsql.sin 文件 (从 资源 树 的 根 目录 )。 


16.1.4. 清除 和 安装 


大 多 数 时 候 ，Visual Studio 会 自动 追踪 所 依赖 的 文件 的 改动 。 但 是 当 有 大 量 改动 的 的 时 候 ， 可 
能 需要 清除 安装 。 要 做 到 这 一 点 ， 只 需 简单 的 运行 clean.bat ， 它 将 自动 的 清除 生成 的 相关 
文件 。 也 可 以 在 运行 时 添加 dist 参数 ， 它 的 行为 和 <kbd class="literal">make 
distclean</kbd> 命 邻 比较 相似 ， 同 时 会 清除 flex/bison 的 输出 文件 。 


默认 情况 下 ， 所 有 的 文件 都 会 写 在 debug 或 release 目录 的 一 个 子 目 录 下 面 。 要 使 用 标准 设 
置 安装 这 些 文件 ， 初始 化 这 些 生成 的 文件 并 使 用 数据 库 ， 运 行 命令 : 


<kbd class="literal">install c:\destination\directory</kbd> 


16.1.5. 运行 回 轨 测试 


要 运行 回 为 测 试 ， 首 先 确保 已 经 完成 所 需 的 编译 。 同 时 ， 确 保 用 来 加 载 系 统 所 有 部 分 (例如 程 
序 语言 Per| 和 Python 的 DLLs) 的 DLLs 已 经 在 系统 路 径 中 存在 。 如 果 没 有 ， 通 
过 buildenv.pl 文件 来 设置 。 要 运行 测试 ， 运 行 src\tools\msve 目录 中 的 一 个 命令 : 


<kbd class="literal">vcregress check</kbd> 

<kbd class="literal">vcregress installcheck</kbd> 
<kbd class="literal">vcregress plcheck</kbd> 
<kbd class="literal">vcregress contribcheck</kbd> 


要 改变 调度 方式 ( 黑 认 是 并 行 ), 将 它 加 在 命令 行 后 : 


<kbd class="literal">vcregress check serial</kbd> 


关于 回归 测试 的 更 多 内 容 ， 见 Chapter 30. 


16.1.6. 编译 文档 


把 PostgreSQL 文 档 编 译 成 HTML 格 式 的 需要 一 些 工具 和 文件 。 为 所 有 这 些 文件 创建 一 个 根 目 
录 ， 将 它们 存储 在 下 列 的 子 目录 中 。 


OpenJade 1.3.1-2 


从 http://sourceforge.net/projects/openjade/files/openjade/1.3.1/openjade-1_3_1-2- 
bin.zip/download 下 载 并 解压 到 子 目录 openjade-1.3.1 o 


DocBook DTD 4.2 


从 http:/www.oasis-open.org/docbook/sgml/4.2/docbook-4.2.zip 下 载 并 解压 到 子 目 
录 docbook 中 。 


DocBook DSSSL 1.79 


Mhttp://sourceforge.net/projects/docbook/files/docbook-dsssl/1.79/docbook-dsssl- 
1.79.zip/download 下 载 并 解压 到 子 目录 docbook-dsssl-1.79 中 。 


ISO character entities 
从 http://www.oasis-open.org/cover/ISOEnts.zip 下 载 并 解压 到 子 目录 docbook 中 。 


编辑 buildenv.pl 文件 ， 为 根 目 录 的 地 址 增加 一 个 变量 ， 如 : 


$ENV{DOCROOT}='c:\docbook'; 


要 编译 文档 ， 运 行 builddoc.bat 文件 。 注 意 为 了 生成 索引 ， 实际 上 编译 运行 来 两 次 。 生 成 的 
HTML 文 件 存在 于 doc\src\sgml Po 


16.2. 用 Visual C++ 或 Borland C++ 编译 libpq 


只 有 在 需要 一 个 含有 不 同 的 调试 和 发 行 版 标记 的 版 本 ， 或 者 需要 一 个 静态 库 来 链接 应 用 程序 
at, 才 推 荐 使 用 Visual C++ 7.1-9.0 或 Borland C++ 来 编译 libpq。 一 般 情况 下 ， 推 荐 使 用 
MinGW 或 Visual Studio 或 Windows SDK 的 方法 。 


采用 Visual Studio 7.1 or later 编 译 libpq 的 客户 端 库 ， 使 用 下 面 的 命令 修改 src 的 路 径 : 


<kbd class="literal">nmake /f win32.mak</kbd> 


采用 Visual Studio 8.0 or later 编 译 64 位 的 libpq 客 户 端 库 ， 使 用 下 面 的 命令 修改 src 的 路 径 : 


<kbd class="literal">nmake /f win32.mak CPU=AMD64</kbd> 


关于 支持 的 变量 的 更 多 细节 参考 win32.mak 文件 。 
采用 Borland C++ 编译 libpq 的 客户 端 库 ， 使 用 下 面 的 命令 修改 src 的 路 径 : 


<kbd class="literal">make -N -DCFG=Release /f bcc32.mak</kbd> 


16.2.1. 生成 文件 


下 面 的 文件 会 被 编译 : 
interfaces\libpq\Release\libpq.d11l 

可 连接 的 前 端 动态 库 
interfaces\libpq\Release\libpqd11.1lib 

导入 库 来 连接 程序 和 libpq.dll 
interfaces\libpq\Release\libpq.1lib 
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通常 不 需要 安装 任何 的 客户 端 文件 。 应 该 将 libpq.dll 文件 放 在 和 可 执行 的 应 用 程序 文件 放 
在 同一 个 目 录 下 。 除非 必 ? 否则 不 要 把 libpq.d1l BMA Windows , System 或 System32 的 目 
录 下 。 如 果 一 个 文件 是 使 用 安装 程序 安装 的 ， 那 么 需要 使 用 vERSIONINFO 进行 版 本 审查 ， 以 
免 被 新 版 本 的 库 覆盖 掉 。 


如 果 需 要 在 本 机 器 上 使 用 libpq 进 行 开 发 ， 要 将 src\include 和 src\interfaces\libpq 的 子 目录 
加 入 到 编译 器 配置 的 资源 树 中 。 


要 使 用 一 个 库 ， 必 须 将 1ibpqd11.1ib 添加 到 项 目 中 。( 在 Visual C++, 只 需 在 项 目 上 右键 单 击 并 
选择 添加 。 ) 


Chapter 17. 服务 器 设置 和 操作 
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本 章 讨论 如 何 设置 和 运行 数据 库 服 务 器 以 及 它 如 何 与 操作 系统 交互 。 


17.1. PostgreSQL P mk È 


与 任何 可 以 从 外 界 访 问 的 服务 器 守护 进程 一 样 ， 我 们 也 建议 用 一 个 独立 的 用 户 帐 户 运 行 
PostgreSQL。 这 个 用 户 帐 户 应 该 拥有 由 这 个 服务 器 管理 的 数据 ， 而 且 不 应 该 与 其 它 守 护 进 程 
共享 这 些 数据 。 比 如 ， 用 nobody 用 户 是 个 烂 主意 。 我 们 不 建议 把 可 执行 文件 安装 为 由 此 用 户 
所 有 ， 因 为 这 样 一 来 被 攻破 的 系统 就 可 以 修改 它们 自己 拥有 的 二 进 制 文件 。 


要 向 系统 里 增加 用 户 帐户 ， 参 考 useradd 或 adduser MS. 我 们 经 常 使 用 postgres 的 用 户 
名 ， 并 且 在 本 书 中 都 假设 这 个 名 字 ， 但 你 不 必 这 么 做 。 


17.2. 创建 数据 库 集群 


在 做 任何 事情 之 前 ， 必 须 先 初始 化 磁盘 上 的 数据 存储 区 ， 叫 作 数据 库 集 群 (标准 SQL 术语 称 
为 "目录 集群 ")。 一 个 数据 库 集 群 是 一 系列 数据 库 的 集合 ， 这 些 数据 库 可 以 通过 单个 数据 库 服 
务 器 的 实例 管理 。 在 初始 化 后 ， 一 个 数据 库 集 群 将 包含 一 个 叫 postgres 的 数据 库 ， 这 个 库 是 
给 工具 、 用 户 和 第 三 方程 序 使 用 的 缺 省 数据 库 。 数 据 库 服务 器 本 身 并 不 要 求 postgres 数据 库 
的 存在 ， 但 是 很 多 外 部 工具 假设 它 存在 。 另 外 一 个 在 每 个 集群 初始 化 过 程 中 创建 的 数据 库 

叫 templatel 。 正如 其 名 一 样 ， 这 个 数据 库 将 作为 随后 创建 的 数据 库 的 模版 ; 在 实际 工作 中 
不 应 该 使 用 这 个 库 (参阅 Chapter 21 获 取 有 关 创 建 数据 库 的 信息 )。 


用 文件 系统 的 术语 来 说 ， 一 个 数据 库 集 群 是 一 个 目录 ， 所 有 数据 都 将 存放 在 这 个 目录 中 。 我 
们 把 它 称 做 数据 目录 或 数据 区 。 在 哪里 存放 数据 完全 取决 于 你 的 选择 ， 我 们 没有 缺 省 值 ， 尽 
管 /usr/local/pgsql/data 或 /var/lib/pgsql/data 这 样 的 目录 很 常用 。 要 初始 化 一 个 数据 库 

集群 ， 可 以 使 用 initdb, 命 令 ， 这 个 命令 与 PostgreSQL 一 起 安装 。 你 可 以 用 -p 选项 指定 数据 
目录 的 位 置 ， 例 如 : 


<Samp class="literal">$</samp> <kbd class="literal">initdb -D /usr/local/pgsql/data</kbd> 
| 
你 必须 以 PostgreSQL 用 户 的 身份 来 执行 这 条 命 爷 ， 这 一 点 我 们 在 前 面 一 节 描 述 过 。 


Tip: 作为 -p 选项 的 替代 品 ， 你 还 可 以 使 用 PGpATA 环境 变量 。 





可 选 的 ， 你 可 以 通过 pg_cil 程 序 运 行 initdb ， 像 这 样 : 
<samp class="literal">$</samp> <kbd class="literal">pg_ctl -D /usr/local/pgsql/data initd 
了 3 


如 果 你 使 用 pg cti 启动 或 停止 服务 器 (参阅 Section 17.3) 可 能 会 更 直观 ， 所 以 pg cti 将 
会 是 你 管理 数据 库 服 务 器 实例 唯一 使 用 的 命令 。 





如 果 你 声明 的 路 径 还 不 存在 ， initdb 将 试图 创建 它 。 如 果 你 按照 我 们 的 建议 创建 了 一 个 非特 
权 帐 户 的 话 ， 你 很 有 可 能 缺少 做 这 些 事情 的 权限 。 这 时 ， 你 可 以 自己 创建 该 目录 (以 root & 
份 ) 然 后 把 该 目录 的 所 有 权 交 给 PostgreSQL 用 户 。 下 面 是 可 能 有 效 的 方法 : 

root# <kbd class="literal">mkdir /usr/local/pgsql/data</kbd> 

root# <kbd class="literal">chown postgres /usr/local/pgsql/data</kbd> 


root# <kbd class="literal">su postgres</kbd> 
postgres$ <kbd class="literal">initdb -D /usr/local/pgsql/data</kbd> 


如 果 数 据 目 录 看 起 来 像 已 经 初始 化 过 了 ， 那 么 initdb 会 拒绝 运行 。 


因为 数据 目录 包含 所 有 存储 在 数据 库 里 的 数据 ， 所 以 出 于 安全 考虑 ， 这 个 目录 不 能 给 任何 非 
授权 用 户 访问 。 因此 ， initdb 禁止 除 PostgreSQL 用 户 帐 户 以 外 的 任何 用 户 访问 这 个 目录 。 


不 过 ， 因 为 目录 的 内 容 是 安全 的 ， 所 以 缺 省 的 客户 端 认 证 设置 允许 任意 本 地 用 户 连接 到 数据 
库 其 至 成 为 超级 用 户 。 如 果 你 不 信任 本 地 用 户 ， 我 们 建议 你 使 用 initdb 的 -w ， 

--pwprompt 或 --pwfile 选项 给 超级 用 户 赋予 一 个 口令。 还 有 ， 声 

明 -A md5 或 -A password , 这 样 就 不 会 使 用 缺 省 的 trust 身份 认证 。 或 者 在 执行 initdb 之 
后 ， 第 一 次 和 启动 服务 器 之 前 修改 pg_hba.conf 文件 。 另 外 一 些 合理 的 方法 包括 peer 认证 或 
者 用 文件 系统 权限 禁止 连接 。 参 阅 Chapter 19 获 取 更 多 细节 。 


initdb 同时 也 为 数据 库 集 群 初始 化 缺 省 区 域 。 通 常 ， 它 将 只 是 使 用 环境 中 的 区 域 设 置 并 且 把 
它们 应 用 于 初始 化 的 数据 库 。 我 们 可 以 为 数据 库 声明 不 同 的 区 域 ; 有 关 这 些 的 更 多 信息 可 以 
在 Section 22.1 中 找到 。 在 特定 数据 库 集 群 里 的 缺 省 排序 顺序 是 由 initdb 设置 的 ， 而 且 当 你 
能 用 不 同 的 排序 顺序 创建 新 的 数据 库 时 ， initdb 创 建 的 模板 数据 库 中 使 用 的 排序 不 能 改变 ， 除 
非 删 除 并 重新 创建 它们 。 使 用 非 c 或 posis 的 区 域 还 会 有 性 能 影响 。 因 此 ， 第 一 次 就 选择 正 
确 很 重要 。 


initdb 还 为 数据 库 集群 设置 缺 省 的 字符 集 编 码 。 通 常 这 个 应 该 选择 与 区 域 匹配 。 详 见 
Section 22.3。 


17.2.1. 网 络 文件 系统 


许多 安装 在 网 络 文件 系统 创建 数据 库 集 群 。 有 时 直接 通过 NFS 或 通过 使 用 网 络 附加 存储 (NAS) 
设计 内 部 使 用 NFS。PostgreSQL 并 不 为 NFS 文 件 系 统 做 什么 特别 的 ， 意味 着 他 假设 NFS 和 本 
地 连接 驱动 器 (DAS, 直 接 附加 存储 ) 的 行为 一 样 。 如 果 客户 端 和 服务 器 NFS 实现 有 非 标准 的 语 
义 ， 会 引起 可 靠 性 问题 (参阅 http://www.time- 
travellers.org/shane/papers/NFS_considered_harmful.html) 。 特别 的 ， 延 迟 的 〈 异 步 的 ) 
写 入 NFS 服 务 器 可 能 会 引起 可 靠 性 问题 ; 如 果 可 能 ， 同步 的 (没有 缓存 ) 安装 NFS 文 件 系统 
以 避免 这 个 问题 。 同 样 ， 不 建议 软 安 装 NFS。 (存储 区 域 网 络 (SAN) 使 用 一 个 低级 的 通信 协 
议 而 不 是 NFS。) 


17.3. 启动 数据 库 服务 器 


在 任何 人 可 以 访问 数据 库 前 ， 你 必须 启动 数据 库 服务 器 。 数 据 库 服 务 器 程序 名 叫 postgres , 
它 必须 知道 在 哪里 能 找到 它 要 用 的 数据 。 这 是 利用 -p 选项 实现 的 。 因 此 ， 启 动 服务 器 最 简 
单 的 方法 是 像 下 面 这 样 : 


$ <kbd class="literal">postgres -D /usr/local/pgsql/data</kbd> 


这 样 将 把 服务 器 放 在 前 台 运 行 。 这 个 步骤 同样 必须 以 PostgreSQL 用 户 帐 户 登录 来 做 。 没 
有 -Dp 选项， 服务 器 将 使 用 环境 变量 petr 命名 的 目录 ; 如 果 这 个 环境 变量 也 没有 ， 将 导致 
失败 。 


通常 ， 最 好 在 后 台 启 动 postgres ， 使 用 下 面 的 Unix shell 语法 : 


$ <kbd class="literal">postgres -D /usr/local/pgsql/data >logfile 2>&1 &</kbd> 


把 服务 器 的 stdout 和 stderr 放 到 某 个 地 方 是 非常 重要 的 ， 就 像 在 上 面 建议 的 这 样 。 这 样 做 既 可 
以 帮助 审计 又 可 以 帮助 诊断 问题 。 参阅 Section 23.3 获 取 有 关 日 志文 件 处 理 的 更 完整 讨论 。 


postgres 还 接受 一 些 其 它 的 一 些 命令 行 选 项 。 更 多 的 信息 请 参考 postgres 手 册页 和 下 面 的 
Chapter 18。 


这 些 shell 语法 很 容易 让 人 觉得 无 聊 。 因 此 我 们 提供 了 封装 程序 pg_ctl 以 简化 一 些 任务 。 比 
如 : 


pg_ctl start -l logfile 


将 在 后 台 启 动 服务 器 并 且 把 输出 放 到 指定 的 日 志文 件 中 。 -0 选项 和 你 直接 运行 postgres 时 
的 意思 是 一 样 的 。 pg_ct1 还 可 以 用 于 关闭 服务 器 。 


通常 ， 你 会 希望 在 计算 机 和 启动 的 时 候 启 动 数据 库 服 务 器 。 自动 息 动 脚本 是 与 操作 系统 相关 
的 。PostgreSQL 自 己 带 了 几 个 ， 放 在 contrib/start-scripts 目录 里 。 需 要 root 权限 安装 它 
们 。 

不 同 的 系统 在 引导 时 有 不 同 的 启动 守护 进程 的 方法 ， 所 以 我 们 建议 你 先 熟 悉 它 。 许多 系统 有 
名 字 称 为 /etc/rc.local 或 /etc/rc.d/rc.local 这 样 的 文件 ， 其 它 的 还 有 rc.d 目录 。 不 管 你 
怎么 做 ， 都 要 记 住 服务 器 必须 以 PostgreSQLA PRP, MAR root 或 者 任何 其 它 用 户 身份 
运行 。 因 此 ， 你 可 能 总 是 要 用 su postgres -c '...' 这 样 的 命令 。 比 如 : 


su postgres -c 'pg_ctl start -D /usr/local/pgsql/data - serverlog' 


下 面 是 一 些 比较 详细 的 与 操作 系统 相关 的 建议 。 请 注意 把 每 个 例子 里 的 具体 数值 蔡 换 成 合适 
的 安装 路 径 和 用 户 名 。 


e 对 于 FreeBSD， 看 看 PostgreSQL 源 代 码 版 本 里 的 contrib/start-scripts/freebsd 文件 。 


° 在 OpenBSD 上 ， 把 下 面 几 行 加 到 vetc/rc.local 文件 里 : 


if [ -x /usr/local/pgsql/bin/pg_ctl -a -x /usr/local/pgsql/bin/postgres ]; then 
su -l postgres -c '/usr/local/pgsql/bin/pg_ctl start -s -l /var/postgresql/log -I 
echo -n ' postgresql' 

fi 





‘| 





e 在 Linux 和 有 系统 里 ， 要 么 往 /etc/rc.d/rc.local 或 /etc/rc.local 文件 里 加 上 下 面 几 行 : 
/usr/local/pgsql/bin/pg_ctl start -l logfile -D /usr/local/pgsql/data 
要 么 看 看 PostgreSQL 源 代码 树 里 的 contrib/start-scripts/linux 文件 。 


e 在 NetBSD 上 ， 你 可 以 根据 爱好 选择 FreeBSD 或 Linux 的 启动 脚本 之 一 。 


° 在 Solaris 上 ， 创建 一 个 叫 /etc/init .d/postgresql 的 文件 ， 包含 下 面 行 : 


su - postgres -c "/usr/local/pgsql/bin/pg_ctl start -1 logfile -D /usr/local/pgsql/dé 





然后 在 /etc/rc3.d 里 创建 一 个 指向 它 的 符号 链接 ， gF S99postgresql o 


运行 的 时 候 ， 它 的 PID 是 保存 在 数据 目录 下 的 postmaster.pid 文件 里 的 。 这 样 做 是 为 了 避免 
多 个 服务 器 在 同一 个 数据 目录 内 运行 ， 此 文件 同样 可 以 用 于 关闭 服务 器 。 


17.3.1. 服务 器 启动 失败 


有 几 个 非常 常见 的 原因 会 导致 服务 器 启动 失败 。 通 过 检查 服务 器 日 志 或 者 使 用 手工 启动 的 方 
法 (不 做 stdout 和 stderr 的 重 定向 )， 就 可 以 看 到 错误 信息 。 下 面 我 们 更 详细 地 解释 了 其 中 一 
些 错 误 信 息 。 


LOG: could not bind IPv4 socket: Address already in use 
HINT: Is another postmaster already running on port 5432? If not, wait a few seconds and 
FATAL: could not create TCP/IP listen socket 


就 像 它 提示 的 那样 : 你 试图 在 已 经 有 一 个 服务 器 运行 着 的 端口 上 再 运行 了 一 个 服务 器 。 不 

过 ， 如 果 内 核 的 错误 信息 不 是 <samp class="literal">Address already in use</samp> 或 者 是 
其 它 的 变种 ， 那 就 有 可 能 是 别 的 毛病 。 上 比如 ， 试 图 在 一 个 保留 的 端口 上 运行 服务 器 会 收 到 下 
面 这 样 的 信息 : 





$ <kbd class="literal">postgres -p 666</kbd> 

LOG: could not bind IPv4 socket: Permission denied 

HINT: Is another postmaster already running on port 666? If not, wait a few seconds and 
FATAL: could not create TCP/IP listen socket 
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像 这 样 的 信息 : 


FATAL: could not create shared memory segment: Invalid argument 
DETAIL: Failed system call was shmget(key=5440001, size=4011376640, 03600). 


可 能 意味 着 内 核对 共享 内 存 区 的 限制 小 于 PostgreSQL 试 图 分 配 的 缓冲 区 大 小 (本 例 中 是 
4011376640 字 节 )。 或 者 可 能 意味 着 你 根本 就 没有 配置 System-V 风格 的 共享 内 存 支 持 。 作 
为 一 个 临时 的 解决 办 法 ， 你 可 以 试 着 以 小 于 正常 数量 的 缓冲 区 数 (shared_buffers) 启动 服务 
器 。 你 最 终 还 是 会 希望 重新 配置 内 核 ， 以 增加 共享 内 存 的 尺寸 。 ae 一 台 机 器 上 
启动 多 个 服务 器 ， 而 且 它们 所 需 的 总 空间 超过 了 内 核 的 限制 ， 也 会 报 这 


像 下 面 这 样 的 错 ; te: 


FATAL: could not create semaphores: No space left on device 
DETAIL: Failed system call was semget(5440126, 17, 03600). 


并 不 意味 着 着 你 已 经 用 光 磁 意 空间 了 。 它 的 意思 是 内 核 的 System V 信 号 灯 的 限制 小 于 
PostgreSQL 想 创建 的 数量 。 和 上 面 一 样 ， 你 可 以 通过 减少 允许 的 连接 数 (max connections) 
KAA, 但 最 终 你 还 是 会 希望 修改 内 核 的 限制 。 


如 果 你 收 到 一 个 "illegal system call" 错 误 ， 那 么 很 有 可 能 是 内 核 根本 不 支持 共享 内 存 或 者 信号 
灯 。 如 果 是 这 样 的 话 ， 你 唯一 的 选择 就 是 重新 配置 内 核 并 且 把 这 些 特性 打开 。 


关于 配置 系统 System V IPC 资 源 的 细节 见 Section 17.4.1。 


17.3.2. 客户 端 连 接 问 题 


能 在 客户 端 出 现 的 错误 条 件 范围 宽广 ， 而 且 还 和 应 用 相关 ， 但 的 确 有 几 种 错误 与 服务 
ail 启动 方式 直接 相关 。 除了 下 面 提 到 的 几 种 错误 以 外 的 问题 都 应 该 在 相应 的 客户 端 应 用 的 
文档 中 。 


psql: could not connect to server: Connection refused 
Is the server running on host "server.joe.com" and accepting 
TCP/IP connections on port 5432? 


这 是 纯粹 的 "我 找 不 到 可 以 交谈 的 服务 器 "错误 。 当 试图 进行 TCP/IP 通讯 时 它 看 起 来 像 上 面 的 
样子 。 常见 的 错误 是 忘记 把 服务 器 配置 成 允许 TCP/IP 连接 。 


另外 ， 当 试图 通过 一 个 Unix 套 接 字 与 本 机 服务 器 通讯 时 ， 你 会 看 到 这 个 


psql: could not connect to server: No such file or directory 
Is the server running locally and accepting 
connections on Unix domain socket "/tmp/.s.PGSQL.5432"? 


最 后 一 行 可 以 有 效 地 验证 客户 端 进行 连接 尝试 时 是 否 连 对 了 位 置 。 如 果实 际 上 没有 服务 器 在 
那里 运行 ， 典型 的 内 核 错误 是 像 上 面 显示 的 那样 或 者 是 <samp class="literal">Connection 
refused</samp> 或 <samp class="literal">No such file or directory</samp>。 尤 其 要 注意 的 是 
这 种 环境 下 <samp class="literal">Connection refused</samp> 的 信息 显示 并 不 意味 着 服务 
器 收 到 连接 然后 拒绝 了 连接 。 那 样 的 话 会 产生 一 个 不 同 的 信息 ( 像 Section 19.4 里 面 显 示 的 那 
样 )。 其 它 像 <samp class="literal">Connection timed out</samp> 这 样 的 信息 表示 更 基本 的 问 
题 ， 比 如 缺少 网 络 连接 等 。 


17.4. 管理 内 核资 源 


PostgreSQL 有 时 可 能 耗 尽 各 种 操作 系统 的 资源 上 限 ， 尤 其 是 多 个 服务 器 副本 在 同一 个 系统 上 
运行 时 ， 或 者 在 一 个 非常 大 的 安装 时 。 这 种 情况 说 明了 PostgreSQL 使 用 的 内 核资 源 和 解决 
问题 可 以 采取 的 步骤 都 和 内 核资 源 消耗 有 关 。 


17.4.1. 共享 内 存 和 信号 灯 


共享 内 存 和 信号 灯 的 正确 叫 法 是 "System V IPC" (还 有 消息 队列 ， 不 过 与 PostgreSQL 无 
关 )。， PostgreSQL 只 在 Windows 上 自己 提供 这 套 机 制 的 替换 实现 ， 要 运行 PostgreSQL 这 些 
机 制 是 必需 的 。 


完全 缺少 这 些 机 制 的 表现 通常 是 在 服务 器 启动 时 的 llegal system call 错 误 。 这 时 除了 重新 配 
置 内 核 外 别 无 选择 。PostgreSQL 没 它们 干 不 了 活 。 这 种 情况 很 少见 ， 但 是 ， 在 现代 操作 系统 
上 会 出 现 。 


如 果 PostgreSQL 超 出 了 这 些 IPC 资 源 的 硬 限 制 之 一 的 时 候 就 会 拒绝 启动 ， 并 且 留 下 一 条 相当 
有 启发 性 的 错误 信息 ， 描 述 问 题 以 及 需要 为 它 做 些 什么 (又 见 Section 17.3.1)。 相 关 的 内 核 参 
数 在 不 同系 统 之 间 有 着 相对 固定 的 术语 ; Table 17-1 是 一 个 概况 。 不 过 ， 设 置 它们 的 方法 却 
多 种 多 样 。 下 面 给 出 一 些 平台 的 建议 。 














Note: PostgreSQL 9.3 之 前 ，System V 共 享 内 存 的 数量 需要 和 启动 的 服务 器 大 得 多 。 如 果 
你 运行 更 老 的 服务 器 版 本 ， 请 参考 你 的 服务 器 版 本 的 文档 。 





Table 17-1. System V IPC 参 数 


合理 取 值 
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ED 1kB (如 果 运 行 多 个 服务 器 副本 需要 更 多 ) 
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SHMALL 


SHMSEG 


SHMMNI 


SEMMNI 


SEMMNS 


SEMMSL 


SEMMAP 


SEMVMX 


H, ceil(SHMMAX/PAGE_SIZE) 


只 需要 1 个 段 ， 不 过 缺 省 比 这 高 得 多 。 


类 似 sumsec 加 上 用 于 其 它 应 用 的 空间 


至 少 ceil((max_connections + autovacuum_max_workers + 4) / 16) 


ceil((max_connections + autovacuum_max_workers + 4) / 16) * 17 加 


上 用 于 其 它 应 用 的 空间 


B17 
参阅 本 文 


至 少 1000 ， 缺 省 通常 是 32767 ， 除 非 被 迫 ， 否 则 不 要 修改 


PostgreSQL 的 每 个 服务 器 的 副本 需要 System V 共 享 内 存 的 少许 字 节 (在 64 为 平台 上 典型 为 
48 字 节 ) 。 在 大 多 数 现在 的 操作 系统 上 ， 可 以 很 容易 的 分 配 数量 。 然 而 ， 如 果 你 运行 了 服务 
器 的 多 个 副本 ， 或 者 其 他 应 用 也 使 用 System V 共 享 内 存 ， 那 么 增 大 simmax 可 能 是 必要 的 ， 
共享 内 存 段 或 shMALL 的 最 大 字 节 大 小 ， 为 系统 范围 System V 共 享 内 存 的 总 数量 。 注 

意 sHMALL 在 许多 系统 上 是 用 页 面 数 而 不 是 字 节 数 来 计算 的 。 


不 太 可 能 出 问题 的 是 共享 内 存 段 的 最 小 尺寸 ( sHMMIN )， 对 PostgreSQL 来 说 大 约 是 32 字 节 左 
右 ( 通 常 只 是 1)， 而 系统 范围 ( sim ) 或 每 进程 ( shMsE6 ) 最 大 共享 内 存 段 数量 不 应 该 会 产生 
问题 ， 除 非 你 的 系统 把 它们 设 成 需 。 


PostgreSQL 每 个 允许 的 连接 使 用 一 个 信号 灯 (max_connections)， 并 且 人 允许 autovacuum 工 作 
进程 (autovacuum_max_workers)， 以 16 个 为 一 套 。 每 套 信号 灯 还 包含 第 17 个 信号 灯 ， 它 
里 面 存储 一 个 "magic number", 以 检测 和 其 它 应 用 使 用 的 信号 灯 集 冲突 。 系 统 里 的 最 大 信号 
灯 数 目 是 由 sems 设置 的 ， 因此 这 个 值 应 该 至 少 和 max_connections 加 

上 autovacuum_max_workers 设置 一 样 大 ， 并 且 每 16 个 连接 和 工作 还 要 另外 加 一 个 (参阅 Table 
17-1 里 面 的 公式 )。 参数 sEMMNI 决定 系统 里 一 次 可 以 存在 的 信号 灯 集 的 数目 。 因此 这 个 参数 
至 少 应 该 为 ceil((max_connections + autovacuum_max_workers + 4) / 16) 。 降低 允许 的 连接 数 
目 是 一 个 临时 的 绕 开 失败 的 方法 ， 这 个 启动 失败 通常 被 来 自 本 数 semget 的 错误 响应 "No 
space left on device" 搞 得 很 让 人 迷惑 。 


有 时 候 还 可 能 有 必要 增 大 semap ， 使 之 至 少 按照 sems 配置 。 这 个 参数 定义 信号 灯 资 源 映 
射 的 尺寸 ， 可 用 的 每 个 连续 的 信号 灯 块 在 这 个 映射 中 存放 一 条 记录 。 每 当 一 套 信 号 灯 被 释 
放 ， 那 么 它 要 么 会 加 入 到 该 映射 中 一 条 相连 的 已 释放 块 的 入 口中， 要 么 注册 成 一 条 新 的 入 
口 。 如 果 映 射 填 满 了 碎片 ， 那 么 被 释放 的 信号 灯 就 去 失 了 (除非 重启 )。 因此 信号 灯 空 间 的 碎 
片 时 间 长 了 会 导致 可 用 的 信号 灯 比 应 该 有 的 信号 灯 少 。 


SEMMSL 参数 决定 一 套 信 号 灯 里 可 以 有 多 少 信号 灯 ， 对 于 PostgreSQL 而 言 应 该 至 少 是 17 。 


许多 设置 与 "semaphore undo'"( 信 号 灯 恢 复 ) 有 关 ， 比 如 sEMMNu 和 semume ， 这 些 与 
PostgreSQL 无 关 。 


AIX 


至 少 对 于 版 本 5.1 而 言 ， 我 们 没有 必要 为 类 似 simmax 这 样 的 参数 做 特殊 的 配置 ， 因为 这 个 参 
数 可 以 配置 为 所 有 内 容 都 当 作 共享 内 存 使 用 。 这 就 是 类 似 DB/2 这 样 的 数据 库 常 用 的 配置 。 


不 过 ， 我 们 可 能 有 必要 在 /etc/security/limits 里 面 修改 全 局 ulimit 信息 ， 因为 文件 大 小 的 
缺 省 硬 限制 ( fsize ) 以 及 文件 数 ( nofiles ) 可 能 太 低 了 。 


FreeBSD 


缺 省 设置 可 以 用 sysctl 或 loader 接口 来 修改 。 下 面 的 参数 可 以 用 sysctl 设置 : 


&lt;samp class="literal"&gt;#&lt;/samp&gt; &lt;kbd class="literal"&gt;sysctl kern.ipc.shm 
&lt;samp class="literal"&gt;#&lt;/samp&gt; &lt;kbd class="literal"&gt;sysctl kern.ipc.shm 
&lt;samp class="literal"&gt;#&lt;/samp&gt; &lt;kbd class="literal"&gt;sysctl kern.ipc.sem 


ai — 








要 想 让 这 些 设 置 重启 后 有 效 ， 修 改 /etc/sysctl.conf 文件 。 
如 果 用 sysctl ， 那 么 剩 下 的 信号 灯 设 置 是 只 读 的 ， 但 是 可 以 在 /boot/loader.conf 里 设置 


kern.ipc.semmni=256 
kern.ipc.semmns=512 
kern.ipc.semmnu=256 


修改 完 这 些 值 以 后 需要 重启 以 使 新 的 设置 生效 。 


你 可 能 还 想 配置 内 核 ， 把 共享 内 存 锁 到 RAM 里 ， 避 免 他 们 被 交换 到 交换 分 区 中 。 这 些 可 以 
通过 使 用 sysctl 设置 kern.ipc.shm_use_phys 来 完成 。 


如 果 通 过 启用 sysctl 的 security.jail.sysvipc_allowed 运行 在 FreeBSD jail 中 ， 那么 必须 闻 

postmaster 以 不 同 的 用 户 身 份 运行 在 不 同 的 jail 中 。 这 样 有 助 于 增强 安全 性 ， 因为 它 防止 了 非 

root 用 户 干扰 不 同 jail 中 的 共享 内 存 或 信号 灯 ， 并 且 人 允许 PostgreSQL IPC 清理 代码 功能 。 

在 FreeBSD 6.0 及 之 后 的 版 本 中 ，|PC 清理 代码 并 不 能 正确 侦 测 在 其 它 jail 中 的 进程 ， 因此 
无 法 防止 其 它 jail 中 的 postmaster 进程 占用 相同 的 端口 。 


FreeBSD 4.0 之 前 的 版 本 类 似 OpenBSD( 见 下 文 )。 
NetBSD 
NetBSD 5.0 及 以 后 ，IPC 参 数 可 以 用 sysctl 调整 ， 例 如 

&lt;samp class="literal"&gt;$&lt;/samp&gt; &lt;kbd class="literal"&gt;sysctl -w kern.ipc. 
| 
要 想 让 这 些 设 置 重启 后 有 效 ， 修 改 /etc/sysct1.conf 文件 。 


你 可 能 还 想 配置 内 核 ， 把 共享 内 存 锁 到 RAM 里 ， 避 免 他 们 被 交换 到 交换 分 区 中 。 这 些 可 以 
通过 使 用 sysctl 设置 kern.ipc.shm_use_phys 来 完成 。 





NetBSD 4.0 之 前 的 版 本 类 似 OpenBSD( 见 下 文 )， 除了 参数 应 该 用 关键 字 options 而 不 


是 option 来 设置 。 
OpenBSD 


编译 内 核 时 需要 把 选项 sysvsHM 和 sysvsem 打开 ( 缺 省 是 打开 的 )。 共享 内 存 的 最 大 尺寸 是 由 
选项 SHMMAXPGS (以 页 计 ) 决 定 的 。 下 面 显示 了 一 个 如 何 设置 这 些 参数 的 例子 


option SYSVSHM 


option SHMMAXPGS=4096 
option SHMSEG=256 
option SYSVSEM 

option SEMMNI=256 
option SEMMNS=512 
option SEMMNU=256 
option SEMMAP=256 


你 可 能 还 想 配置 内 核 ， 把 共享 内 存 锁 在 RAM 中 以 避免 它们 被 交换 出 去 ， 我 们 可 以 通过 使 


用 sysctl a kern.ipc.shm_use_phys 来 完成 。 
HP-UX 


缺 省 设置 看 来 对 普通 安装 是 足够 的 了 。 对 于 HP-UX 10, sEMMNS 的 出 厂 缺 省 是 128 ， 可 能 对 
大 的 数据 库 节 点 来 说 太 小 To 


IPC 可 以 在 System Administration Manager(SAM) 下 面 的 Kernel Configuration->Configurable 
Parameters 配 置 。 配置 完了 以 后 选择 Create A New Kernel 选 项 


Linux 


缺 省 最 大 段 大 小 为 32MB， 缺 省 的 最 大 总 字 节 为 2097152 页 。 一 页 通常 是 4096 字 节 ， BRT 
有 "huge pages" 的 不 寻常 的 内 核 配置 (使 用 getconf PAGE_SIZE 来 校 验 ) 。 


共享 内 存 大 小 设置 可 以 通过 sysctl 接口 改变 。 例 如 ， 要 人 允许 16 GB: 


&lt;samp class="literal"&gt;$&lt;/samp&gt; &lt;kbd class="literal"&gt;sysctl -w kernel.sh 
&lt;samp class="literal"&gt;$&lt;/samp&gt; &lt;kbd class="literal"&gt;sysctl -w kernel.sh 


a] Ba E 


为 了 这 文 些 设 BH FARRAR, 将 这 文 些 设 EE I| /etc/sysctl.conf 里 。 这 样 做 是 高 度 推荐 
的 。 





老 版 本 里 可 能 没有 sysctl 程序 ， 但 是 同样 的 改变 可 以 通过 操作 /proc 文件 系统 来 做 : 


&lt;samp class="literal"&gt;$&lt;/samp&gt; &lt;kbd class="literal"&gt;echo 17179869184 &g 
&lt;samp class="literal"&gt;$&lt;/samp&gt; &lt;kbd class="literal"&gt;echo 4194304 &gt;/p 


~ 
剩 下 的 缺 省 是 相当 宽松 的 大 小 ， 通 常 不 需要 改变 。 





Mac OS X 


在 OS X 中 配置 共享 内 存 推荐 的 方法 是 创建 一 个 名 为 /etc/sysctl.conf 的 文件 ， 包含 变量 赋 
例如 


kern.sysv.shmmax=4194304 
kern.sysv.shmmin=1 
kern.sysv.shmmni=32 
kern.sysv.shmseg=8 
kern.sysv.shmall1=1024 


注意 在 某 些 OS X 版 本 里 ， 所 有 五 个 共享 内 存 参数 必须 都 在 /etc/sysctl.cont 中 设置 ， 否 则 将 
会 被 忽略 。 

还 要 注意 最 近 版 本 的 OS X 将 拒绝 把 simmax 的 数值 设置 为 非 4096 的 倍数 。 
在 这 个 平台 上 ， sma 是 用 4KB 页 来 度量 的 。 


在 老 的 OS X 版 本 里 ， 你 将 需要 重启 以 使 共享 内 存 配 置 的 改变 生效 。 自 OS X 10.5 起 ， 在 运行 
中 修改 除了 sHMMNI ee 使 用 sysctl。 但 是 通过 /etc/sysct1l.conf 来 设置 你 
喜欢 的 数值 仍然 是 最 好 的 ， 因 为 这 样 这些 数 值 在 重启 以 后 仍然 保留 


文件 /etc/sysctl.conf 只 在 OS X 10.3.9 及 以 后 的 版 本 中 遵守 。 如 果 你 正在 运行 一 个 10.3.x 之 
前 的 版 本 ， 你 必须 编辑 文件 /etc/rc 并 在 下 列 的 命令 中 改变 数值 。 


sysctl -w kern.sysv.shmmax 
sysctl -w kern.sysv.shmmin 
sysctl -w kern.sysv.shmmni 
sysctl -w kern.sysv.shmseg 
sysctl -w kern.sysv.shmall 


注意 /etc/rc 通常 通过 OS X 系 统 更 新 重 写 ， 所 以 你 应 该 预料 到 在 每 次 更 新 后 必须 重 做 这 些 编 
辑 。 

在 OS X 2 以 及 更 早 的 版 本 里 ， 在 /System/Library/StartupItems/SystemTuning/SystemTuning 
EP oe se ax Hea, 


SCO OpenServer 


缺 省 配置 时 ， 只 人 允许 每 段 512KB 共享 内 存 。 要 增 大 设置 ， 首 先进 入 /etc/conf/cf.d 目录 。 
要 显示 当前 以 字 节 记 的 sHMMAX , 47: 


./configure -y SHMMAX 


设置 simmax 的 新 值 : 


./configure SHMMAX=_value_ 


这 里 value 是 你 想 设 置 的 以 字 节 记 的 新 值 。 设 置 完 shMvAx 以 后 重新 编译 内 核 : 


./link_unix 


然后 重启 。 
Solaris 2.6 到 2.9 (Solaris 6 到 Solaris 9) 


相关 的 设置 可 以 在 /etc/system 里 面 修改 ， 例 如 : 


set shmsys:shminfo_shmmax=0x2000000 
set shmsys:shminfo_shmmin=1 

set shmsys:shminfo_shmmni=256 

set shmsys:shminfo_shmseg=256 


set semsys:seminfo_semmap=256 
set semsys:seminfo_semmni=512 
set semsys:seminfo_semmns=512 
set semsys:seminfo_semmsl1=32 


你 需要 重启 以 使 这 些 修改 生效 。 又 见 http://sunsite.uakom.sk/sunworldonline/swol-09- 
1997/swol-09-insidesolaris.html 获取 关于 老 版 本 的 Solaris 共 享 内 存 的 信息 。 


Solaris 2.10 (Solaris 10) 及 以 后 OpenSolaris 


Solaris 10 及 以 后 的 版 本 ， 以 及 OpenSolaris， 缺 省 的 共享 内 存 和 信号 灯 的 设置 对 大 多 数 
PostgreSQL 应 用 来 说 是 足够 的 。Solaris 现 在 对 sumax 的 缺 省 是 系统 RAM 的 四 分 之 一 。 Bi 
一 步调 整 这 些 设置 ， 使 用 一 个 和 postgres 用 户 相关 的 项 目 设 置 。 例 如 ， 作 为 root 运行 下 列 


AA. 
fp : 


projadd -c "PostgreSQL DB User" -K "project.max-shm-memory=(privileged, 8GB,deny)" -U post 


[IE 





这 些 命令 增加 user.postgres 项 目 并 且 设 置 postgres 用 户 的 最 大 共享 内 存 为 8GB， 在 下 次 用 
户 登 录 时 生效 ， 或 当 你 重启 PostgreSQL (不 是 重新 加 载 ) 生效 。 上 面 的 是 假设 PostgreSQL 
由 在 postgres 组 里 面 的 postgres 用 户 运行 。 不 需要 服务 器 重启 。 


其 他 推荐 的 数据 库 服 务 器 的 内 核 设置 修改 将 有 大 量 的 连接 : 


project.max-shm-ids=(priv, 32768, deny) 
project.max-sem-ids=(priv, 4096, deny) 
project.max-msg-ids=(priv, 4096, deny) 


此 外 ， 如 果 你 在 一 个 区 域 里 面 运行 PostgreSQL， 你 可 能 也 需要 提高 区 域 资 源 使 用 的 限制 。 参 
i] System Administrator's Guiae 里 面 的 "Chapter2: Projects and Tasks" 获取 更 多 关 
于 projects 和 prctl 的 信息 。 


UnixWare 


在 UnixWare 7 上 ， 缺 省 配置 里 的 最 大 共享 内 存 段 是 512kB 。 要 显示 sHMMAX 的 当前 值 ， 运 
行 : 


/etc/conf/bin/idtune -g SHMMAX 


就 会 显示 以 字 节 记 的 当前 的 缺 省 的 最 小 和 最 大 值 。 要 给 simax 设置 一 个 新 值 ， 运 行 : 


/etc/conf/bin/idtune SHMMAX _value_ 


_value_ 是 你 想 设 置 的 以 字 节 记 的 新 值 。 设 置 完 sHMMAX A, BEAK: 


/etc/conf/bin/idbuild -B 


然后 重启 。 


17.4.2. 资源 限制 


Unix 类 系统 强制 了 许多 资源 限制 ， 这 些 限 制 可 能 干扰 PostgreSQL 服 务 器 的 运行 。 这 里 尤其 重 
要 是 对 每 个 用 户 的 进程 数目 的 限制 、 每 个 进程 打开 文件 数目 、 以 及 每 个 进程 可 用 的 内 存 。 这 
些 限 制 中 每 个 都 有 一 个 " 硬 "限制 和 一 个 " 软 "限制 。 实 际 使 用 的 是 软 限制 ， 但 用 户 可 以 自己 修改 
成 最 大 为 硬 限 制 的 数目 。 而 硬 限制 是 只 能 由 root 用 户 修改 的 限制 。 系统 调用 setrlimit 负责 
设置 这 些 参数 。shell HAART ulimit (Bourne shells) 或 limit (csh) 就 是 用 于 在 命令 行 上 
控制 资源 限制 的 。 在 BSD 衍生 的 系统 上 ， /etc/login. conf 文件 控制 在 登录 时 对 各 种 资源 设 
置 什 么 样 的 限制 数值 。 参阅 操作 系统 文档 获取 细节 。 相 关 的 参数 是 maxproc , openfiles , 
datasize 。 比 如 : 


default:\ 
:datasize-cur=256M:\ 


:maxproc-cur=256:\ 
:openfiles-cur=256:\ 


-cur 是 软 限制 ， 后 面 附 加 -max 就 可 以 设置 硬 限制 。 

内 核 通常 也 有 一 些 系 统 范围 的 资源 限制 。 

e 在 Linux 上 ， /proc/sys/fs/file-max 决定 内 核 可 以 支持 的 最 大 文件 数 。 你 可 以 通过 往 该 
文件 写 入 一 个 不 同 的 数值 修改 此 值 ， 或 者 在 /etc/sysct1l.conf 里 增加 一 个 赋值 。 每 个 进 
程 的 最 大 打开 文件 限制 是 在 编译 内 核 的 时 候 固定 的 ; 参 
阅 /usr/src/linux/Documentation/proc.txt 获取 更 多 信息 。 

poses R EE ae ia 所 以 你 应 该 至 少 允许 和 连接 数 相同 的 进程 数 ， 

再 加 上 系统 其 它 部 分 所 需要 的 数目 。 通常 这 个 并 不 是 什么 问题 ， 但 如 果 你 在 一 台 机 器 上 运行 

多 个 服务 器 ， 那 你 就 要 把 事情 理 清 楚 。 


打开 文件 数目 的 出 厂 缺 省 设置 通常 设置 为 "社会 友好 "数值 ， 就 是 说 允许 许多 用 户 共存 一 台 机 
器 ， 而 不 会 导致 系统 资源 使 用 的 不 当 上 比例。 如 果 你 在 一 台 机 器 上 运行 许多 服务 器 ， 这 也 许 就 
是 你 想 要 的 ， 但 是 在 特殊 的 服务 器 上 ， 你 可 能 需要 提高 这 个 限制 。 


问题 的 另外 一 边 ， 一 些 系统 允许 独立 的 进程 打开 非常 多 的 文件 ; 如 果 有 几 个 进程 这 么 干 ， 那 
系统 范围 的 上 限 就 很 容易 达到 。 如 果 你 发 现 这 样 的 现 像 ， 并 且 不 想 修 改 系统 范围 的 限制 ， 你 
就 可 以 设置 PostgreSQL 的 max files_per_process 配置 参数 来 限制 打开 文件 数 的 消耗 。 


17.4.3. Linux 内 存 过 提交 


在 Linux 2.4 以 及 之 后 的 版 本 里 ， 缺 省 的 虚拟 内 存 的 行为 不 是 对 PostgreSQL 最 优 的 。 原因 在 
于 内 核实 现 内 存 过 提交 的 方法 ， 如 果 其 它 进程 的 内 存 请 求 导 致 系统 用 光 虚 拟 内 存 ， 那么 内 核 
可 能 会 终止 PostgreSQL 主 服务 器 进程 。 


如 果 发 生 了 这 样 的 事情 ， 你 会 看 到 像 下 面 这 样 的 内 核 信 息 (参考 你 的 系统 文档 和 配置 ， 看 看 在 
哪里 能 看 到 这 样 的 信息 ) : 


Out of Memory: Killed process 12345 (postgres). 


这 表明 postgres 因为 内 存 太 力 而 终止 了 。 尽 管 现 有 的 数据 连接 闻 继 续 正 常 运 转 ， 但 是 新 的 连 
接 将 无 法 接受 。 要 想 恢复 ， 你 应 该 重启 PostgreSQL。 


一 个 避免 这 个 问题 的 方法 是 在 一 台 你 确信 不 会 因为 其 它 进 程 而 耗 尽 内 存 的 机 器 上 运行 
PostgreSQL。 


如 果 PostgreSQL 本 身 是 系统 耗 尽 内 存 的 原因 ， 你 可 以 通过 改变 你 的 配置 来 避免 这 个 问题 。 在 
某 些 情况 下 ， 这 样 可 能 帮助 降低 内 存 相关 的 配置 参数 ， 尤其 是 shared_buffers 

和 work mem 。 其 他 情况 下 ， 这 个 问题 可 能 是 由 于 允许 太 多 的 连接 到 数据 库 服务 器 本 身 引 起 

的 。 在 许多 情况 下 ， 减少 max_connections 而 不 是 利用 外 部 连接 池 的 软件 会 更 好 。 

在 Linux 2.6 以 及 以 后 的 版 本 里 ， 可 以 修改 内 存 的 行为 ， 这 样 它 就 不 会 再 "过 提交 "内 存 。 尽管 
这 个 设置 将 不 会 完全 阻止 OOM killer 被 引用 ， 然 是 它 将 显著 地 减少 并 且 将 因此 导致 更 稳健 的 

系统 行为 。 这 是 通过 用 sysctl 选取 一 个 严格 的 过 提交 模式 实现 的 : 


sysctl -w vm.overcommit_memory=2 


或 者 在 /etc/sysctl.conf 里 放 一 个 等 效 的 条 目 。 你 可 能 还 希望 修改 相关 的 
vm.overcommit_ratio 设置 。 详 细 信 息 请 参阅 内 核 文 档 的 


Documentation/vm/overcommit-accounting 文件 。 


另外 一 种 方法 ， 改 变 或 不 改变 vm.overcommit_memory 都 可 以 使 用 ， 设置 与 进程 相关 
的 oom_score_adj 值 为 主 进程 -1000, 从 而 保证 它 不 会 成 为 OOM killer 的 目标 。 最 简单 的 方 
法 是 在 调用 postmaster 之 前 在 postmaster 的 和 启动 脚本 执行 : 


echo -1000 > /proc/self/oom_score_adj 


请 注意 ， 这 个 操作 必须 由 root 来 做 ， 否 则 将 不 会 有 任何 作用 ; 所 以 一 个 root 所 有 的 启动 脚本 是 
做 这 个 最 简单 的 地 方 。 如 果 你 这 样 做 ， 你 可 能 也 希望 用 -pLinux_oom_score_adJ=0 添加 

到 cPPFLAGS 来 建立 PostgreSQL。 这 将 导致 主子 进程 以 标准 oom_score_adj 值 0 来 运行 ， 所 以 
OOM killer 仍 然 可 以 在 需要 时 以 它们 为 目标 。 


老 版 本 的 Linux 内 核 不 提供 /proc/self/oom_score_adj ， 但 是 可 能 有 相同 功能 的 名 为 
/proc/self/oom_adj 的 以 前 的 版 本 。 除了 禁用 值 为 -17 而 不 是 -1000 外 ， 它们 做 相同 的 工 
作 。 相 应 的 PostgreSQL 的 建立 标识 为 -DLINUX_00M_ADJ=0 o 


Note: 有 些 供应 商 的 Linux 2.4 内 核 有 着 早期 2.6 过 提交 的 sysctl. Bit, 在 没有 相关 
代码 的 2.4 内 核 里 设置 vm.overcommit_memory 为 2 只 会 让 事情 更 糟 ， 而 不 是 更 好 。 我 们 建 
议 你 检查 一 下 实际 的 内 核 源 代码 (参阅 文件 mm/mmap.c 里 面 的 vm_enough_memory IŽ), 
核实 一 下 这 个 是 在 你 的 内 核 里 存在 的 ， 然后 再 在 2.4 内 核 里 使 用 这 个 特性 。 文 档 文 

44 overcommit-accounting 的 存在 不 能 当 作 是 这 个 特性 存在 的 证 明 。 如 果 有 问题 ， 请 询问 
你 的 内 核 供应 商 的 专家 。 





17.5. KARA 4s 


有 好 几 种 关闭 数据 库 服务 器 的 方法 。 通 过 给 postgres 进程 发 送 不 同 的 信号 ， 你 就 可 以 控制 关 
闭 服务 器 的 不 同方 法 。 
SIGTERM 


是 智能 关闭 模式 。 接 收 到 SIGTERM 以 后 ， 服务 器 不 再 允许 新 的 连接 ， 但 是 允许 所 有 活路 的 
会 放 正 党 完成 他 们 的 工作 ， 只 有 在 所 有 会 话 都 结束 任务 后 才 关 闭 。 如 果 服 务 器 处 在 在 线 各 份 
模式 ， 它 另外 等 待 在 线 备份 模式 不 再 活跃 。 当 备 份 模式 活跃 时 ， 将 仍 人 允许 新 的 连接 ， 但 是 只 
针对 超级 用 户 〈 这 个 例外 允许 超级 用 户 连 接 以 终止 在 线 备 份 模 式 ) 。 如 果 当 请 求 智 能 关闭 时 
服务 器 正在 恢复 ， 那 么 恢复 和 流 复 制 将 在 所 有 普通 会 话 终 止 后 停止。 


SIGINT 


这 是 快速 关闭 模式 。 不 再 允许 新 的 连接 ， 向 所 有 活路 服务 器 发 送 SIGTERM (让 它们 立刻 退 
出 )， 然 后 等 待 所 有 子 进程 退出 并 关闭 数据 库 。 如 果 服 务 器 处 在 在 线 各 份 模式 ， 备份 模式 将 终 
止 ， 使 得 备份 无 效 。 


SIGQUIT 


这 是 立即 关闭 模式 。 主 postgres MEGAMAN A Sit RIK SIGQUIT 并 且 立 即 退出 (所 有 子 进 
程 也 会 立即 退出 )， 而 不 会 妥善 地 关闭 数据 库 系 统 。 这 样 做 会 导致 下 次 启动 时 的 恢复 (通过 重 
放 WAL 日 志 )。 我 们 推荐 只 在 紧急 的 时 候 使 用 这 个 方法 。 


pg_ctl 程 序 提供 了 一 个 发 送 这 些 信 号 关闭 服务 器 的 便利 接口 。 另外 ， 你 在 非 Windows 系 统 上 
可 以 用 kill 直接 发 送 这 些 信号 。 可 以 用 ps 命令 或 者 从 数据 目 录 里 的 postmaster.pid 文件 
中 找 出 postgres 的 PID。 所 以 ， 举 例 来 说 ， 要 做 一 次 快速 关闭 : 


$ <kbd class="literal">kill -INT “head -1 /usr/local/pgsql/data/postmaster.pid </kbd> 





Important: 最 好 不 要 用 SIGKILL 来 关闭 服务 器 。 这 样 做 将 阻止 服务 器 释放 共享 内 存 和 信 
号 灯 ， 那样 的 话 你 只 能 在 新 服务 器 启动 前 自己 手动 做 这 件 事 。 另 外 ，SIGKILL 直 接 杀 
JE postgres 进程 而 不 等 它 传递 信号 给 子 进程 ， 所 以 我 们 也 将 必须 手动 的 杀 死 独立 的 子 进 
程 。 


当 人 允许 其 他 会 话 继续 时 终止 一 个 独立 的 会 话 ， 使 用 pg_terminate_backend() (参见 Table 9-59) 
或 发 送 一 个 SIGTERM 信号 到 和 与 这 个 会 话 有 关 的 子 进程 。 


17.6. 升级 一 个 PostgreSQL 集群 


本 节 讨 论 怎 样 从 一 个 PostgreSQL 发 布 到 一 个 新 的 发 布 升级 你 的 数据 库 数 气 。 


PostgreSQL 主 要 版 本 由 前 两 个 数字 的 版 本 号 代表 ， 例 如 8.4。 PostgreSQL 主 要 版 本 由 前 三 个 
数字 的 版 本 号 代表 ， 例 如 8.4.2 是 第 二 个 8.4 的 维护 性 发 布 。 维护 性 发 布 从 不 改变 内 部 存储 器 格 
式 并 且 总 是 与 之 前 的 和 之 后 的 相同 维护 性 版 本 号 的 维护 性 版 本 兼容 ， 例如 8.4.2 兼 容 8.4,8.4.1 
和 8.4.6。 要 在 兼容 的 版 本 之 间 更 新 ， 在 服务 器 关闭 时 简单 的 蔡 换 可 执行 文件 并 且 重 咎 服务 器 
就 可 以 。 数据 目录 保留 不 改变 一 维护 性 升级 就 这 人 么 简单 。 


对 PostgreSQL 的 主要 发 布 ， 内 部 数据 存储 格式 是 改变 的 主题 ， 因此 并 发 升级 。 移 动 数据 到 一 
个 新 的 主要 版 本 的 传统 的 方法 是 转 储 并 重新 加 载 数据 库 。 就 像 下 面 描述 的 那样 ， 其 他 方法 也 
适用 。 


新 的 主要 版 本 还 通常 介绍 一 些 用 户 可 见 的 不 兼容 性 ， 所 以 可 能 需要 改变 应 用 程序 。 所 有 用 户 
可 见 的 改变 都 在 版 本 注释 里 面 列 出 (Appendix E) ; 尤其 注意 章节 标签 "Migration"。 如 果 你 
正在 几 个 主要 版 本 间 升 级 ， 一 定 要 阅读 每 个 中 间 版 本 的 版 本 注释 。 


庶 慎 的 用 户 可 能 想 在 全 面 切换 前 在 新 的 版 本 上 测试 他 们 的 客户 端点 用 ; 因此 ， 设置 并 发 新 旧 
版 本 的 安装 是 一 个 好 的 主意 。 当 测试 一 个 PostgreSQL 的 主要 升级 时 ， 考虑 下 列 类 别 的 可 能 变 
化 : 


Administration 

在 每 个 主要 版 本 中 ， 管 理 员 对 服务 器 可 用 的 监视 和 控制 功能 通常 会 改变 和 增加 。 
SQL 

通常 包含 新 的 SQL 命令 功能 而 不 是 行为 上 的 改变 ， 除 非 在 版 本 注释 里 面 特 别提 到 。 
Library API 

Rlibpq ik 7 HAA E RADIAT AE, ERIE ERR eS SFU El. 
System Catalogs 

系统 目录 变更 通常 只 影响 数据 库 管 理工 具 。 

Server C-language API 


这 涉及 到 后 端 事 数 API 的 变化 ， 它 是 用 C 编 程 语言 写 的 。 这 样 的 改变 影响 引用 深层 服务 器 后 端 
函数 的 编码 。 


17.6.1. 通过 pg_dump 升 级 数据 


= MPostgreSQLiJ—Th= BhkA 4s HEF AE BPA, Kn AApg dump; 文件 系 
统 级 各 份 方法 将 不 能 使 用 。 (有 检查 防止 你 用 不 兼容 的 PostgreSQL 版 本 使 用 数据 目录 ， 所 以 
在 一 个 数据 目录 上 尝试 启动 错误 的 服务 器 版 本 也 不 会 造成 大 的 伤害 。) 


建议 使 用 新 版 本 的 PostgreSQL pg_dump 和 pg_dumpall 程 序 ， 利用 这 些 程序 可 能 的 增强 功 
能 。 当 前 转 储 程序 版 本 可 以 从 一 直到 7.0 的 任何 服务 器 版 本 中 读 取 数据 。 


这 些 说 明 假 设 现 有 的 安装 在 /usr/local/pgsql 目录 下 ， 数 据 区 域 在 /usr/1ocal/pgsql/data H 
录 下 。 适 当 的 替代 你 的 路 径 。 


1. 如 果 做 一 个 备份， 确保 数据 库 没有 被 更 新 。 这 不 影响 各 份 的 完整 性 ， 但 是 将 不 会 包括 改 
变 了 的 数据 。 如 果 必 须要 这 样 做 ， 那 么 编辑 文件 /usr/local/pgsql/data/pg_hba.conf (或 
相等 的 ) 里 的 权限 ， 设置 除了 你 之 外 的 人 都 不 可 以 访问 。 参 阅 Chapter 19 获 取 关 于 访问 控 
制 的 更 多 信息 。 


各 份 你 的 数据 库 安 装 ， 输 入 : 


&lt;kbd class="literal"&gt;pg_dumpall &gt; ~_outputfile_~&lt;/kbd&gt; 


如 果 您 需要 保存 OID 〈 例 如 当 使 用 它们 作为 外 键 时 ) ， 那 么 在 运行 pg_dumpall 时 使 
用 -o 选项 。 


要 做 备份 ， 可 以 使 用 当前 运行 版 本 的 pg_dumpall 命 令 。 然 而 ， 要 获取 最 佳 结果 尝试 使 用 
PostgreSQL 9.3.1 的 pg_dumpall 命 售 ， 因 为 这 个 版 本 包含 bug 修 复 和 对 老 版 本 的 改进 。 

虽然 在 你 还 没有 安装 新 版 本 时 这 个 建议 看 起 来 很 特别 ， 但 是 如 果 你 打算 同时 安装 新 版 本 
和 老 版 本 ， 那么 这 个 建议 是 可 行 的 。 在 这 种 情况 下 你 可 以 正常 完成 安装 然后 传送 数据 。 

这 也 将 减少 停机 时 间 。 


2. 天 闭 旧 的 服务 器 : 


&1t;kbd class="literal"&gt;pg_ctl stop&lt;/kbd&gt; 


系统 上 的 PostgreSQL 在 开机 时 启动 ， 可 能 有 一 个 和 启动 文件 将 完成 同样 的 事情 。 例如 ， 在 
Red Hat Linux 系 统 上 ， 可 能 发 现 这 个 在 工作 : 


&lt;kbd class="literal"&gt;/etc/rc.d/init.d/postgresql stop&lt;/kbd&gt; 


参阅 Chapter 17 获 取 关 于 启动 和 停止 服务 器 的 详细 信息 。 


3， 如 果 从 备份 中 恢复 ， 重 命名 或 者 删除 旧 的 安装 目录 。 重 命名 目录 是 个 好 主意 ， 而 不 是 删 
掉 它 ， 以 防 你 有 困难 并 且 需 要 恢复 它 。 记 住 ， 目 录 可 能 会 占用 大 量 磁 盘 空 间 。 要 重 命名 
目录 ， 使 用 像 下 面 这 样 的 命令 : 


&lt;kbd class="literal"&gt;mv /usr/local/pgsql /usr/local/pgsql.old&lt;/kbd&gt; 


(一 定 要 把 目录 作为 一 个 单元 ， 所 以 相对 路 径 保持 不 变 。) 
4. (Section 15.4. 中 概述 的 那样 安装 PostgreSQL 新 版 本 。 


5， 如 果 需 要 创建 一 个 新 的 数据 库 集 群 。 请 记 住 ， 当 登陆 到 特定 的 数据 库 用 户 账户 (如 果 已 
经 升级 ， 那 么 已 经 有 这 个 账户 了 ) 时 必须 执行 下 面 的 命令 。 


&lt;kbd class="literal"&gt;/usr/local/pgsql/bin/initdb -D /usr/local/pgsql/data&lt; /|I 


‘| 








6. 恢复 以 前 的 pg_hba.conf FICE postgresql.conf 修改 。 


7 启动 数据 库 服务 器 ， 再 次 使 用 特定 的 数据 库 用 户 账户 : 


&lt;kbd class="literal"&gt;/usr/local/pgsql/bin/postgres -D /usr/local/pgsql/data&lt ; 
Ki — 
8. 最终 ， 从 各 份 中 恢复 数据 : 





&lt;kbd class="literal"&gt;/usr/local/pgsql/bin/psql -d postgres -f `_outputfile_`&li 
使 用 新 的 psql 





最 少 的 停机 时 间 可 以 通过 在 一 个 不 同 的 目录 下 安装 新 的 服务 器 ， 并 且 并 行 在 不 同 的 端口 运行 
旧 的 和 新 的 服务 器 来 达到 。 然后 就 可 以 使 用 类 似 : 


pg_dumpall -p 5432 | psql -d postgres -p 5433 


来 传送 数据 。 


17.6.2. Non-Dump 升级 方法 


pg_upgrade 模 块 允许 安装 从 一 个 主 PostgreSQL 版 本 到 下 一 个 的 迁移 。 升级 可 以 在 几 分 钟 内 
完成 。 


还 可 以 使 用 特定 的 复制 方法 ， 比 如 Slony， 创 建 一 个 更 新 的 PostgreSQL 版 本 各 用 服务 器 。 这 
是 可 能 的 ， 因 为 Slony 支 持 不 同 PostgreSQL 主 版 本 间 的 复制 。 各 机 可 以 在 相同 的 计算 机 上 ， 
也 可 以 在 不 同 的 计算 机 上 。 一 旦 它 和 与 主 服 务 器 (在 老 PostgreSQL 版 本 上 和 运行) 同步 ， 就 可 以 
切换 主机 使 各 机 成 为 主机 ， 并 立即 关闭 旧 的 数据 库 。 这 样 的 切换 使 升级 只 有 几 秒 钟 的 关机 时 
间 。 


17.7. 防止 服务 器 欺骗 


当 服 务 器 正在 运行 时 ， 悉 意 用 户 代替 正常 的 数据 库 服务 器 是 不 可 能 的 。 然 而 ， 当 服务 器 关闭 

at, 本 地 用 户 通过 和 启动 他 们 自己 的 服务 器 欺骗 正常 的 服务 器 是 可 能 的 。 行 骗 服 务 器 可 以 读 取 
客户 端 发 来 的 查询 和 密码 ， 但 不 能 返回 任何 数据 ， 因 为 Peor 目录 因为 目录 存 取 权 限 仍然 是 
安全 的 。 因为 任何 用 户 都 可 以 和 启动 一 个 数据 库 服务 器 ， 所 以 欺骗 是 可 能 的 ; 客户 端 不 能 识别 
无 效 的 服务 器 ， 除非 它 是 专门 配置 的 。 


为 local 连接 防止 欺骗 的 最 简单 的 方法 是 使 用 Unix 域 套 接 字 目 录 (unix_socket_directories), 
这 个 目录 只 为 受信 任 的 本 地 用 户 写 入 了 权限 。 如 果 你 担心 一 些 应 用 可 能 仍然 参考 /tmp 为 套 

接 字 文 件 ， 并 且 因 此 很 容易 受 欺 骗 ， 那么 在 操作 系统 启动 时 创建 一 个 符号 链 

接 /tmp/.s.PGsQL.5432 指向 重 定位 的 套 接 字 文件 。 您 还 可 能 需要 修改 /tmp 清理 脚本 以 防止 

删除 符号 链接 。 


要 在 TCP 连 接 上 防止 欺骗 ， 最 好 的 解决 方法 是 使 用 SSL 认 证 ， 并 确保 客户 检查 服务 器 的 证 书 。 
要 做 到 这 一 点 ， 服 务 器 必须 配置 为 只 接受 hostssl 连接 (Section 19.1), 并且 有 SSL 秘 钥 和 证 
书 文件 (Section 17.9)。TCP 客 户 必须 使 用 sslmode=verify-ca 或 verify-full 连接 ， 并 且 有 适 
当 的 根 证 书 文件 安装 (Section 31.18.1)。 


17.8. 加 密 选 项 


PostgreSQL 提 供 了 几 个 不 同 级 别 的 加 密 ， 并 且 在 保护 数据 库 服 务 器 不 受 数 据 窃贼 、 不 道德 管 
理 员 、 不 安全 网 络 等 因素 泄漏 的 方面 提供 很 高 的 灵活 性 。 加 密 可 能 也 是 保护 一 些 诸如 医疗 记 
录 和 财务 交易 等 敏感 数据 的 要 求 。 


口 命 存储 加 密 


缺 省 的 时 候 ， 数 据 库 用 户 的 口令 以 MDS 散 列 的 方式 存储 ， 所 以 管理 员 无 法 判断 赋予 用 户 的 实 
际 口令 。 WR MD5 加 密 用 于 客户 端 认 证 ， 那 么 未 加 密 的 口令 甚至 都 不 可 能 临时 出 现在 服务 
atl, 因为 客户 端 在 透 过 网 络 发 送 之 前 ， 就 先 用 MD5 加 密 了 。 


为 指定 的 字段 加 密 


pgcrypto 模 块 允 许 对 某 些 字段 进行 加 密 存 储 。 这 个 功能 在 某 些 数据 是 敏感 的 情况 下 有 用 。 客 
户 端 提 供 解密 的 密 钥 ， 然 后 数据 在 服务 器 端 解密 ， 然 后 发 送 给 客户 端 。 


在 数据 解密 和 数据 在 服务 器 与 客户 端 之 间 传 递 时 ， 解 密 数 据 和 解密 密 钥 将 会 在 服务 器 端 存在 
短暂 的 一 段 时 间 。 这 就 给 那些 可 以 完全 访问 数据 库 服务 器 的 人 提供 了 一 个 短暂 的 截获 密 钥 和 
数据 的 时 间 ， 这 样 的 人 一 般 是 数据 库 管 理 员 。 


数据 库 分 区 加 密 


在 Linux 上 ， 加 密 可 以 在 使 用 "回环 设 各 "(loopback device) 挂 载 的 文件 系统 上 面 进 行 。 这 样 就 
可 以 把 磁 瘟 上 整个 文件 分 区 都 加 密 ， 然 后 由 操作 系统 解密 。 在 FreeBSD 上 ， 等 效 的 设施 叫 
GEOM 基本 磁盘 加 密 (gbde)， 并 且 许 多 其 他 操作 系统 支持 这 个 功能 ， 包 括 Windows。 


这 个 机 制 避免 了 在 整个 计算 机 或 者 磁 意 驱动 器 被 窃 的 情况 下 ， 未 加 密 的 数据 被 从 驱动 器 中 读 
Ro 它 无 法 防止 在 文件 系统 被 挂 载 的 时 候 的 攻击 ， 因 为 在 挂 载 之 后 ， 操 作 系统 提供 数据 的 解 
密 视图 。 不 过 ， 要 想 挂 载 文件 系统 ， 你 需要 有 一 些 方法 把 解密 密 钥 传递 给 操作 系统 ， 有 时 候 
这 个 密 钥 就 存储 在 挂 载 该 磁盘 的 主机 的 某 个 地 方 。 


跨 网 络 加 密 口 兮 


MDS 认证 方法 在 客户 端 将 口 命 发 给 服务 器 之 前 双重 加 密 之 。 第 一 次 MDS 加 密 是 基于 用 户 名 

的 ， 然后 在 连接 数据 库 的 时 候 ， 用 服务 器 发 送 的 随机 盐 粒 再 次 加 密 。 这 个 双重 加 密 的 数值 就 
是 从 网 络 传递 给 服务 器 的 数值 。 双 重 加密 不 仅 可 以 避免 口令 泄漏 ， 还 可 以 避免 稍 后 其 它 的 连 
接 使 用 同样 的 加 密 口 邻 连接 数据 库 ( 回 放 攻 击 )。 


透 过 网 络 加 密 数 据 


SSL 连接 加 密 所 有 透 过 网 络 发 送 的 数据 : 口令 、 查 询 、 返 回 的 数据 。 pg_hba.conf 文件 允许 
管理 员 声 明 哪些 主机 可 以 使 用 不 加 密 的 连接 ( host )， 以 及 哪些 主机 需要 使 用 SSL 加 密 的 连 
接 ( hostssl )。 客 户 也 可 以 指定 只 通过 SSL 连 接 到 服务 器 。 我 们 也 可 以 使 用 Stunnel 或 SSH 加 


密 数 据 传输 。 
SSL 主机 认证 


客户 端 和 主机 都 可 以 提供 SSL 证 书 给 对 方 。 这 么 做 需要 在 两 边 都 进行 一 些 额 外 的 配置 工作 ， 
但 是 这 种 方式 提供 了 比 简单 使 用 用 户 名 和 口令 更 强 的 身份 认证 的 手段 。 它 避 免 一 个 计算 机 装 
作 是 服务 器 ， 然 后 读 取 客 户 端口 售 ， 只 要 时 间 长 得 足够 读 取 客 户 端 发 送 的 口令 就 行 了 。 它 还 
避免 了 "中 间 人 " 攻击 (在 客户 端 和 服务 器 之 间 有 人 台 计算 机 ， 伪 装 成 为 服务 器 并 且 读 取 然 后 将 所 
有 数据 在 客户 端 和 服务 器 之 间 传 递 )。 


客户 端 加 密 


如 果 服 务 器 机 器 的 系统 管理 员 是 不 可 信 的 ， 那 么 客户 端 加 密 数 据 也 是 必要 的 ; 这 种 情况 下 ， 
未 加 密 的 数据 从 来 不 会 在 数据 库 服 务 器 上 出 现 。 数 据 在 发 送 给 服务 器 之 前 加 密 ， 而 数据 库 结 
果 必 须 在 客户 端 使 用 之 前 解密 。 


17.9. 用 SSL 进行 安全 的 TCP/IP 连接 


PostgreSQL 有 一 个 内 建 的 通过 SSL 进 行 加 密 的 客户 端 /服务 器 端的 通讯 ， 这 样 可 以 增加 安全 
性 。 这 个 特性 要 求 在 客户 端 和 服务 器 端 都 安装 OpenSSL 并 且 在 编译 PostgreSQL 的 时 候 打开 
(参阅 Chapter 15)。 


当 编 译 了 SSL 进 去 以 后 ， 可 以 通过 将 postgresql.conf 中 的 ss| 设置 为 on 打开 PostgreSQL 服 
务 器 的 SSL 支 持 。 服务 器 将 在 同一 个 TCP 端口 上 同时 监听 标准 的 和 SSL 的 连接 ， 并 且 将 与 
任何 正在 连接 的 客户 端 进行 协商 ， 协 商 是 否 使 用 SSL 。 缺 省 时 ， 这 是 根据 客户 端的 选项 而 定 
的 。 参 阅 Section 19.1 获取 如 何 强制 服务 器 端 只 使 用 SSL 进 行 某 些 或 者 全 部 连接 的 信息 。 


PostgreSQL 读 取 系 统 范围 的 OpenSSL 配置 文件 。 缺 省 的 ， 这 个 文件 名 为 openssl.cnf ， 位 
于 openssl version -d 报告 的 目录 中 。 这 个 缺 省 可 以 通过 设 入 置 环境 变量 OPENSSL_CONF 为 所 需 
配置 文件 的 名 称 重 写 。 


OpenSSL 支 持 多 种 不 同 强度 的 密码 和 认证 算法 。 当 一 列 密码 可 以 在 OpenSSL 配 置 文件 中 指定 
ay, 可 以 通过 修改 postgresql.conf 中 的 ss| ciphers, 指定 数据 库 服务 器 专用 的 密码 。 


Note: 使 用 NuLL-sHA 或 NULL-MD5 可 能 有 身份 验证 开销 而 没有 加 密 开销 。 不 过 ， 中 间 人 
能 够 读 取 和 通过 客户 端 和 服务 器 的 通信 。 此 外 ， 加 密 开 销 相 比 身份 认证 的 开销 是 极 小 
的 。 有 这 些 原因 建议 不 使 用 NULL 加 密 。 














要 在 SSL 模 式 中 启动 服务 器 ， 必 须 包 含 包含 服务 器 证 书 和 私 钥 的 文件 。 缺 省 的 ， 这 些 文件 分 
别 命名 为 server.crt 和 server.key ， 人 存在 于 服务 器 的 数据 目录 里 ， 但 是 其 他 名 字 和 位 置 可 
以 用 配置 参数 ss|_cert file 和 ss|_key_file 指定。 在 Unix 系 统 ， server ,key 的 权限 禁止 任何 
world 或 group 访 问 ; 通过 命令 chmod 6666 server.key 来 做 。 如 果 私 钥 受 密码 保护 ， 服 务 器 将 
会 提示 输入 密码 ， 将 会 等 到 输入 后 启动 。 


在 有 些 情况 下 ， 服 务 器 证 书 可 能 由 一 个 "中 间 " 认 证 授权 签名 ， 而 不 是 直接 由 受信 任 的 客户 端 。 
若 要 使 用 这 样 的 证 书 ， 请 追加 授权 签名 证 书 到 server.crt 文件 ， 然 后 其 父 和 颁发 机 构 的 证 书 ， 
然后 直到 一 个 客户 端 信 任 的 " 根 "授权 。 server.crt 包含 多 个 证 书 ， 在 任何 情况 下 都 应 包括 根 
证 书 。 


17.9.1. FHE > imit 3 


如 果 需 要 客户 端 提 供 受 信任 的 证 书 ， 把 认证 中 心 (CAs) 的 证 书 放 在 你 信任 的 在 数据 目录 下 的 
root .crt 文件 里 ， 并 且 设 置 postgresql.conf 里 的 参数 ss| ca file% root.crt ， 设 

G IB pg_hba.conf 里 适当 的 hostssl 行 参 数 clientcert 为 1。 然后 将 在 SSL 连 接 启 动 时 从 客户 
端 请 求 该 证 书 。 (Section 31.18 描 述 了 如 何在 客户 端 安 装 证 书 。) 服务 器 将 验证 客户 端的 证 书 


是 由 受信 任 的 认证 中 心 之 一 签发 的 。 如 果 参 数 ss|_crl file 也 设置 了 ， 那 么 证 书 撤销 列表 (CRL) 
项 也 要 检查 。 (参阅 http://h71000.www7.hp.com/DOC/83final/BA554 90007/ch04s02.html 
标 显 示 SSL 证 书 的 使 用 。) 


在 pg_hba.conf 文件 中 clientcert 选项 对 于 所 有 的 认证 方法 都 可 用 ， 但 仅 适用 hostssl 指定 
的 行 。 当 clientcert 没有 指定 或 设置 为 0， 服务 器 将 仍然 对 其 CA 列表 验证 提供 的 客户 端 证 
书 ， 如 果 配 置 了 ， 它 将 不 会 坚持 提交 客户 端 证 书 。 


请 注意 root ,crt 列 出 顶级 的 CA， 这 些 CA 被 认为 是 受 签约 客户 端 证 书信 任 的 。 原则 上 不 需要 
列 出 标记 服务 器 证 书 的 CA， 尽 管 在 大 多 数 情况 下 ， 客 户 端 证 书 也 将 信任 的 该 CA。 


如 果 你 设置 客户 端 证 书 ， 你 可 能 希望 用 cert 认证 方法 ， 因 此 使 证 书 控制 用 户 身份 验证 ， 以 
及 提供 连接 安全 。 参 阅 Section 19.3.10 获 取 详 细 信 息 。 


17.9.2. SSL 服 务 器 文件 的 使 用 


Table 17-2 概 述 了 与 在 服务 器 上 设置 SSL 相 关 的 文件 。 (显示 的 文件 名 字 是 默认 的 或 典型 的 名 
Fo 本 地 配置 的 名 字 可 能 会 不 同 。 ) 


Table 17-2. SSL 服 务 器 文件 的 使 用 


文件 内 容 作用 
ss|_cert file 服务 器 证 书 发 送 到 客 户 端 标 识 服务 器 的 身份 


( $PGDATA/server.crt ) 


证 明 服务 器 证 书 是 由 所 有 者 发 送 ， 并 不 表示 


SS|_key file a 
RERBA os SAH 


( $PGDATA/server .key ) 


ssl_ca file 受信 任 的 认证 a ee sp den ia ee 
(SEGRE) 中 心 检查 该 客户 端 证 书 由 受信 任 的 认证 中 心 签 署 
ssl_crl file 由 认证 中 心 吊 Po a certs 

( $PGDATA/root.crl ) 销 的 证 书 客户 端 证 书 不 能 在 此 列表 中 


文件 server.key ， server.crt ， root.crt 和 root.crl 《或 他 们 配置 的 供 选 择 的 名 字 ) 仅 
在 服务 器 启动 时 检查 ; 如 果 你 修改 了 它们 ， 那 么 必须 重启 服务 器 才能 生效 。 


17.9.3. 创建 自 签名 的 证 书 
要 为 服务 器 创建 一 个 快速 自 认 证 的 证 书 ， 使 用 下 面 的 OpenSSL 命 令 : 


openssl req -new -text -out server.req 


填充 那些 openss| 向 你 询问 的 信息 。 确 保 把 本 地 主机 名 当做 "Common Name" 输 入 。 EKRIR 
码 可 以 留 空 。 该 程序 将 生成 一 把 用 口令 保护 的 密 钥 。 小 于 四 字符 的 口令 保护 是 不 被 接受 的 。 
要 移 去 密 钥 (如 果 你 想 自 动乱 动 服务 器 就 得 这 样 )， 运 行 下 面 的 命令 : 


openssl rsa -in privkey.pem -out server.key 
rm privkey.pem 


输入 旧 口 令 把 现 有 密 钥 解锁 。 然 后 : 


openssl req -x509 -in server.req -text -key server.key -out server.crt 


将 证 书 变 成 自 签名 的 证 书 ， 并 且 复 制 密 钥 和 证 书 到 服务 器 能 找到 的 地 方 。 最 后 执行 操作 : 


chmod og-rwx server.key 


因为 如 果 其 权限 比 这 更 高 ， 服 务 器 将 拒绝 该 文件 。 更 多 关于 怎样 创建 服务 器 私 铀 和 证 书 的 细 
节 ， 请 参考 OpenSSL 文 档 。 


你 可 以 用 一 个 自 认 证 的 证 书 进 行 测试 ， 但 是 在 生产 环境 中 应 该 使 用 一 个 由 认证 中 心 (CA， 全 
球 的 CA 或 者 区 域 的 CA 都 可 以 ) 签 发 的 证 书 ， 这 样 客户 端 才能 够 识别 服务 器 的 身份 。 如 果 所 有 
客户 都 是 本 地 组 织 的 ， 建 议 使 用 本 地 CA。 


Ma Se a Zo eha z 
17.10. ASSH Š 472E TCP/IP 连接 
使 用 SSH 对 PostgreSQL 服务 器 和 客户 端 之 间 的 网 络 连 接 进 行 加密 是 可 能 的 。 经 过 适当 处 理 
E, 这 样 做 可 以 获得 一 个 足够 安全 的 网 络 连接 。 即 使 是 没有 SSL 的 客户 端 上 也 如 此 。 
首先 确认 SSH 正 在 和 PostgreSQL 服务 器 的 同一 台 机 器 上 正确 地 运行 ， 而 且 你 可 以 通过 某 个 用 
户 用 ssh 登录 。 然后 你 可 以 用 下 面 这 样 的 命令 从 客户 端的 机 器 上 建立 一 个 安全 通道 : 


ssh -L 63333:localhost:5432 joe@foo.com 


-L 参数 的 第 一 个 数字 (63333) 是 你 这 端 通道 的 端口 号 ， 可 以 是 任何 未 使 用 的 端口 。 (IANA 提 
供 端口 49152 到 65535 位 私人 使 用 。) 第 二 个 数字 (5432) 是 通道 的 远 端 ， 也 就 是 服务 器 使 用 的 
端口 号 。 在 两 个 端口 号 之 间 的 名 称 或 者 IP 地 址 是 你 准备 连接 的 数据 库 服务 器 ， 在 例子 中 

是 foo.com 。 为 了 使 用 这 个 通道 与 数据 库 服务 器 连接 ， 你 在 本 机 于 端口 63333 连 接 


psql -h localhost -p 63333 postgres 


对 于 数据 库 服务 器 而 言 ， 在 这 种 情况 下 ， 它 会 把 你 当做 主机 foo.com 连接 到 localhost 的 真 
正 的 用 户 joe ， 并 且 使 用 为 这 个 用 户 和 主机 设置 的 认证 手段 进行 认证 。 请 注意 ， 服 务 器 不 会 
认为 连接 是 SSL 加 密 的 ， 因为 实际 上 在 SSH 服 务 器 和 PostgreSQL 服务 器 之 间 是 没有 加 密 
的 。 只 要 它们 在 同一 台 机 器 上 ， 这 么 做 并 不 会 导致 任何 安全 漏洞 。 


为 了 保证 能 够 成 功 地 建立 通道 ， 你 必须 被 允许 作为 joe@foo.com 通过 ssh 建立 连接 ， 就 像 你 
使 用 ssh 创建 终端 会 话 一 样 。 


你 也 可 以 设置 端口 转发 


ssh -L 63333:fo00.com:5432 joe@foo.com 


但 是 随后 数据 库 服 务 器 将 看 到 连接 从 foo.com 界面 进来 ， 这 是 不 被 缺 省 设 
置 listen_addresses = 'localhost' 开放 的 。 这 通常 不 是 你 想 要 的 。 


如 果 你 必须 通过 某 些 登 陆 主 机 "跳跃 "到 数据 库 服务 器 ， 一 个 可 能 的 设置 看 起 来 像 这 样 : 


ssh -L 63333:db.foo.com:5432 joe@shell.foo.com 


请 注意 ， 这 个 方式 从 shell.foo.com 到 db .foo .com 的 连接 将 不 会 通过 SSH 通 道 加 密 。 当 网 络 
以 各 种 方式 被 限制 时 ，SSH 提 供 了 相当 多 的 配置 可 能 性 。 请 参阅 SSH 文 档 获取 详情 。 











Tip: 还 有 几 种 不 同 的 产品 可 以 提供 安全 的 通道 ， 所 使 用 的 过 程 类 似 我 们 刚刚 描述 的 过 
程 。 














17.11. 在 Windows 上 注册 事件 日 志 


要 注册 操作 系统 的 Windows 事 件 日 志 库 ， 发 出 这 个 命令 : 


<kbd class="literal">regsvr32 `_pgsql_library_directory_`/pgevent .dl1l</kbd> 


这 将 使 用 事件 查看 器 创建 注册 表 条 目 ， 在 默认 的 名 为 PostgresQL 的 事件 源 下 。 
要 指定 一 个 不 同 的 事件 源 名 字 (参阅 event_ source) ， 使 用 /n 和 /i 选项 : 


<kbd class="literal">regsvr32 /n /i:`_event_source_name_` `_pgsql_library_directory_`/pge 
OESS O O ae eee ëO 
要 从 操作 系统 中 注销 event log 库 ， 发 出 这 个 命令 : 








<kbd class="literal">regsvr32 /u [/i:`_event_source_name_`] ~_pgsql_library_directory_~/p 


a 一 一 


Note: 要 在 数据 库 服务 器 中 启用 事件 日 志 记 录 ， 在 postgresql.conf His 
改 log_destination 包 含 eventlog o 
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有 一 堆 配 置 参 数 可 以 影响 数据 库 系统 的 行为 。 本 章 第 一 节 我 们 将 描述 一 下 如 何 设置 它们 。 A 
后 随后 的 小 节 我 们 将 逐个 讨论 它们 。 


18.1. 设置 参数 


18.1.1. 参数 名 和 值 


所 有 参数 名 都 是 大 小 写 不 敏感 的 。 每 个 参数 都 可 以 接受 四 种 类 型 之 一 : 布尔 、 整 数 、 浮 点 
数 、 字符 串 。 布尔 值 可 以 是 (都 是 大 小 写 无 关 ) on, off , true, false, yes, no, 1, 0 
或 这 些 东 西 的 任意 清晰 无 歧义 的 前 级 。 


一 些 设置 指定 内 存 或 时 间 值 ， 其 隐 含 的 单位 可 能 是 : kB( 千 字 节 )、 块 (通常 是 8KB)、 毫 秒 、 
秒 、 分 钟 等 等 。 隐 含 单位 可 以 通过 引用 ces . unit 获取 。 为 了 避免 混淆 ， 可 以 在 指 
定数 值 的 同时 指定 单位 。 可 用 内 存单 位 : ke (F$) m ( 兆 字 节 )，6B ( 吉 字 节 ) ; 可 用 时 间 
单位 : ms (ÆW), s ( 秒 )，min (分 钟 )， acne d (天 )。 EE in a T, 而 


TROD, 


作为 字符 串 参 数 的 同样 方式 指定 " 枚 举 " 类 型 参数 ， 但 被 限制 在 值 的 有 限 集合 中 。 可 以 
从 pg_settings . enumvals 找到 人 允许 的 值 。 枚 举 参 数值 是 不 区 分 大 小 宇 的 。 


18.1.2. 通 置 文件 设置 参数 


设置 这 些 参数 的 一 个 方法 是 编辑 postgresql.conf 文件 ， 它 通常 在 数据 目 录 里 ( 当 数 据 库 集群 
目录 初始 化 的 时 候 ， 会 在 那里 安装 一 个 缺 省 拷贝 )。 比 如 ， 下 面 是 一 个 该 文件 的 例子 : 


# This is a comment 
log_connections = yes 
log_destination = 'syslog' 
search_path = '"$user", public' 
shared_buffers = 128MB 


参数 是 每 条 一 行 。 选 项 名 和 值 之 间 的 等 号 是 可 选 的 。 空白 和 空 行 被 忽略 。 井 号 ( # ) 引 入 注 
释 。 非 简单 标识 符 或 者 数字 必须 用 单 引 号 包围 。 如 果 需 要 在 参数 值 里 褒 入 单 引 号 ， 要 么 写 两 
个 单 引号 (推荐 方法 )， 要 么 用 反 斜 打包 围 。 


主 服务 器 进程 每 次 收 到 SIGHUP 信 号 后 都 会 重新 读 取 这 个 配置 文件 ， 最 简单 的 发 送 方法 就 是 
使 用 来 自命 令 行 的 pg_ctl reload 或 者 调用 SQL 辑 数 pg_reload_conf() o 同时 主 服务 器 进程 
也 将 这 个 信号 广播 给 所 有 正在 运行 的 服务 器 进程 ， dn 另外 ， 你 可 
以 只 向 一 个 服务 器 进程 直接 发 送信 号 。 有 些 参 数 只 能 在 服务 器 咎 动 的 时 候 设 置 ; 对 这 些 条 目 
的 修改 将 被 忽略 ， 直到 下 次 服务 器 重启 。 配 置 文件 中 的 无 效 参 数 ee aa ams 
忽略 〈 但 已 登录 ) 。 


18.1.3. 设置 参数 其 他 的 方法 


第 二 种 设置 这 些 配置 参数 的 方法 是 把 它们 作为 命 合 行 参数 传递 给 postgres ， 上 比如 : 


postgres -c log_connections=yes -c log _destination='syslog' 


命令 行 选项 覆盖 postgresql.conf 中 的 矛盾 设置 。 请 注意 ， 这 意味 着 你 不 能 通过 编 
辑 postgresql.conf 在 运行 时 改变 其 数值 ， 因 此 ， 虽然 命令 行 方 法 很 方便 ， 但 会 付出 灵活 性 的 
代价 。 


有 时 候 ， 给 某 一 个 特定 会 话 一 个 命令 行 参 数 也 是 很 有 用 的 。 可 以 在 客户 端 使 用 环境 变 


= pcoptioss 来 实现 这 个 目的 : 

env PGOPTIONS='-c geqo=off' psql 
(可 以 用 于 任何 基于 libpq 的 客户 端 应 用 ， 不 光 是 psql) : 请 注意 ， 这 个 变量 对 那些 需要 在 服务 
TE 动 后 固定 的 选项 或 者 必须 在 postgresql.conf 里 声明 的 选项 是 无 效 的 。 


并 且 ， 我 们 可 以 给 一 个 用 户 或 者 一 个 数据 库 赋 予 一 套 选项 设置 。 在 一 个 会 话 开 始 的 时 候 ， 装 
载 所 涉及 到 的 用 户 和 数据 库 的 缺 省 设置 。 命令 ALTER ROLE 和 ALTER DATABASE 分 别 用 于 
配置 这 些 设置 。 针对 每 个 数据 库 的 设置 将 覆盖 任何 从 postgres 命令 行 或 者 配置 文件 收 到 的 设 
E, 然后 接着 又 被 针对 每 个 用 户 的 设置 覆盖 ; 最 后 又 会 都 被 针对 每 个 会 话 的 设置 覆盖 。 


一 些 选 项 可 以 在 独立 的 SQL 会 话 中 修改 ， 方 法 是 使 用 SET 命令 ， 比 如 : 
SET ENABLE_SEQSCAN TO OFF; 
如 果 人 允许 用 set 设置 ， 这 种 针对 每 个 数据 库 的 设置 将 覆盖 任何 来 自 其 它 方面 的 设置 。 有 些 参 


数 不 能 通过 set 改变 : 比如 ， 如 果 这 些 选项 不 重启 动 PostgreSQL 就 无 法 合理 控制 其 行为 。 
同样 ， 有 些 参 数 只 能 由 超级 用 户 通过 set 或 acter 修改 ， 而 普通 用 户 不 能 修改 。 


18.1.4. 检查 参数 设置 


SHOW 命令 检查 所 有 参数 的 当前 值 。 


我 们 也 可 以 用 虚 表 pg_settings 来 显示 和 更 新 当前 会 话 的 运行 时 参数 。 当 它们 改变 时 ， 参 见 
Section 47.66 获 取 详 细 信 息 ， 以 及 不 同 变 量 类 型 的 描述 。 pg_settings 等 效 于 snow 

和 SET ， 但 是 用 起 来 更 方便 ， 因 为 它 可 以 和 其 它 表 连接 起 来 使 用 ， 或 者 用 任意 用 户 需 要 的 选 
择 条 件 来 查询 。 它 还 包含 了 来 自 show 的 每 个 参数 的 更 多 详细 信息 。 


18.1.5. 配置 文件 包含 


除了 参数 设置 外 ， postgresql.conf 文件 还 包含 include 指 合 ， 它 声明 了 另外 一 个 文件 的 读 取 
和 人 处理， 正如 在 这 一 点 上 插入 到 配置 文件 。 这 个 特性 允许 配置 文件 被 分 成 物理 上 独立 部 分 。 
Include 指 今 看 起 来 像 : 


include 'filename' 


如 果 文 件 名 不 是 绝对 路 径 ， 那 么 它 被 看 成 包含 引用 配置 文件 目录 的 相对 路 径 。 ALTER 
套 。 


此 外 ， 还 有 一 个 include_if_exists 指令 ， 它 的 作用 和 include 指令 是 相同 的 ， 除 了 被 引用 的 
文件 不 存在 或 无 法 读 取 时 的 行为 。 规则 的 include 会 认为 这 是 一 个 错误 条 件 ， 
但 include_if_exists 只 是 记录 一 条 消息 ， 并 继续 义理 引用 的 配置 文件 。 


postgresql.conf 文件 也 包含 include_dir HED, 声明 了 配置 文件 的 整个 目 录 ， 它 的 类 似 用 
法 : 


include_dir 'directory' 


非 绝对 路 径 遵 循 和 单个 文件 包括 指令 相同 的 规则 ， 它们 是 相对 于 包含 引用 的 配置 文件 目录 。 
在 该 目录 中 ， 唯 一 一 个 非 目 录 的 文件 ， 其 名 以 后 级 conf 的 将 被 包括 在 内 。 文件 名 以 . F 
符 开头 的 被 排除 在 外 ， 为 防止 出 错 ， 它 们 都 隐藏 在 一 些 平台 上 。 在 include 目 录 中 的 多 个 文件 
按照 文件 名 的 顺序 进行 处 理 。 文件 名 按照 C 语 言 环境 的 规则 排序 。 字 母 前 的 数字 和 小 写字 母 
前 大 写字 母 。 


包含 文件 或 目 录 可 用 于 数据 库 配置 逻辑 上 独立 的 部 分 ， 而 不 是 单一 的 postgresql.conf 文件 。 
考虑 有 两 个 数据 库 服 务 器 公司 ， 每 一 个 有 不 同 的 内 存量 。 有 可 能 有 配置 都 共享 的 元 素 ， 比 如 
日 志 。 但 是 服务 器 内 存 相关 参数 两 者 之 间 不 同 。 也 有 可 能 是 服务 器 特定 的 自 定 义 。 管理 这 种 
情况 的 方法 是 打破 了 自 定义 配置 更 改 为 你 的 网 站 的 三 个 文件 。 你 可 以 添加 这 些 到 你 

的 postgresql.conf 文件 末尾 ， 包 括 : 


include 'shared.conf' 
include 'memory.conf' 
include 'server.conf' 


所 有 系统 可 能 有 同样 的 shared.conf 文件 。 具 有 特定 内 存量 的 每 个 服务 器 可 以 共享 相同 
的 memory .conf ; 可 能 有 8GB 内 存 的 服务 器 ， 另 一 个 是 16GB。 最 后 server .Conf 可 能 真正 有 
服务 器 特定 配置 文件 信息 。 


另外 一 个 可 能 是 创建 配置 文件 目录 ， 并 且 将 这 些 信 息 放 和 人 文件 中 。 比如， conf.d 目录 可 能 
在 postgresql.conf 末尾 被 引用 : 


include_dir 'conf.d' 


那么 你 可 以 像 这 样 在 conf.d 目录 中 命名 文件 : 


00shared .conf 
91memory .conf 
02server .Conf 


这 显示 了 文件 和 锌 加 载 的 明确 顺序 。 这 是 非常 重要 的 ， 因 为 当 服务 器 正在 读 取 它 使 用 的 配置 
时 ， 只 读 取 最 后 的 设置 。 这 个 例子 中 的 conf.d/62server.conf 的 一 些 设置 会 覆盖 
conf .d/01memory.conf 中 设置 的 值 。 


你 可 能 会 使 用 这 种 配置 目录 的 方法 ， 当 命名 这 些 文件 更 加 详细 时 : 


00shared .conf 
O1memory-8GB.conf 
02server-foo.conf 


这 样 的 安排 使 每 个 配置 文件 的 变化 具有 了 唯一 名 称 。 当 一 些 服务 器 的 配置 都 存储 在 一 个 地 方 的 
时 候 ， 这 可 以 帮助 消除 歧义 。 比 如 版 本 控制 存储 (版 本 控制 下 存储 数据 库 配置 文件 是 另 一 种 
很 好 的 做 法 ) 。 


18.2. 文件 位 置 


除了 已 经 提 到 过 的 postgresql.conf 文件 之 外 ，PostgreSQL 还 使 用 另外 两 个 手工 编辑 的 配置 
文件 ， 它们 控制 客户 端 认 证 (在 Chapter 19 里 讨论 )。 缺 省 时 ， 所 有 三 个 配置 文件 都 存放 在 数据 
库 集群 的 数据 目录 里 。 本 节 描 述 的 选项 允许 配置 文件 放 在 别 的 地 方 。 这 么 做 可 以 简化 管理 ， 
特别 是 如 果 配 置 文件 独立 放置 ， 通 常 可 以 很 容易 保证 它 得 到 恰当 的 各 份 。 


data directory ( string ) 

声明 为 数据 存储 使 用 的 目录 。 这 个 选项 只 能 在 服务 器 启动 的 时 候 设置 。 

config_file ( string ) 

声明 主 服务 器 配置 文件 (通常 叫 postgresql.conf )。 这 个 选项 只 能 在 postgres 命令 行 上 设置 。 
hba_file ( string ) 


声明 基于 主机 的 认证 (HBA) 配 置 文件 (通常 叫 pg_hba.conf )。 这 个 选项 只 能 在 服务 器 启动 的 时 
候 设 置 。 


ident_file ( string ) 


声明 用 于 Section 19.2 用 户 名 匹配 的 配置 文件 (通常 叫 pg_ident.conf )。 这 个 选项 只 能 在 服务 
器 启动 的 时 候 设 置 。 


external pid file ( string ) 
声明 可 被 服务 器 管理 程序 使 用 的 额外 PID 文 件 。 这 个 选项 只 能 在 服务 器 启动 的 时 候 设置 。 


缺 省 安装 不 会 明确 设置 这 些 参 数 。 而 是 用 命令 行 参数 -5" 或 者 环境 变量 peata 声明 数据 目 
录 ， 并 将 上 述 配 置 文件 都 放 在 数据 目录 里 。 


如 果 你 想 把 配置 文件 放 在 别 的 地 方 ， 那 么 postgres 的 命令 行 参数 - 或 者 环境 变量 

PGDATA 必须 指向 包含 配置 文件 的 目录 ， 而 postgresql.conf 里 (或 者 命令 行 上 ) 

的 data_directory 选项 必须 设置 为 数据 目 录 实 际 存放 的 地 方 。 请 注意 ， data_directory Re 
盖 -D 和 povata 指定 的 数据 目录 ， 但 是 不 覆盖 配置 文件 的 目录 。 


如 果 你 愿意 ， 可 以 使 用 选项 config file, hba file 和 /或 者 ident file 分 别 声明 配置 文件 
的 路 径 。 config_file 只 能 在 postgres 命令 行 上 设置 ， 但 是 其 它 的 可 以 在 主 配置 文件 里 设 
置 。 如 果 明 确 设置 了 所 有 三 个 选项 和 data_directory ， 和 那么 就 没 必要 声明 -D 或 者 PGDATA o 


在 设置 任何 这 些 选项 的 时 候 ， 相 对 路 径 将 被 解释 为 相对 于 postgres 启动 时 候 的 路 径 。 


18.3. 连接 和 认证 


18.3.1. 连接 设置 


listen_addresses ( string ) 


声明 服务 器 监听 客户 端 连接 的 TCP/IP 地 址 。 值 是 一 个 逗号 分 隔 的 主机 名 和 /或 数字 IP 地 址 。 特 
殊 项 * 对 应 所 有 可 用 IP 接 口 。 6.6.6.9 人 允许 监听 所 有 IPV4 地 址 ， 并 且 :: 允许 监听 所 有 IPV6 
地 址 。 如 果 这 个 列表 是 空 的 ， 那 么 服务 器 不 会 监听 任何 IP 接 口 ， 这 种 情况 下 ， 只 有 Unix 域 套 
接 字 可 以 用 于 连接 数据 库 。 缺 省 值 localhost 只 允许 进行 本 地 "回环 "连接 。 客户 端 认证 
(Chapter 19) 人 允许 细 粒 度 控制 谁 能 访问 服务 器 ， listen_addresses 控制 党 试 连接 哪个 接口 。 
这 个 参数 只 能 在 服务 器 启动 的 时 候 设置 。 


port ( integer ) 


服务 器 监听 的 TCP 端 口 ; 缺 省 是 5432。 请 注意 同一 个 端口 号 用 于 服务 器 监听 的 所 有 IP 地 址 。 
这 个 参数 只 能 在 服务 器 启动 的 时 候 设 置 。 


max_connections ( integer ) 


允许 和 数据 库 连 接 的 最 大 并 发 连接 数 。 缺 省 通常 是 100， 但 是 如 果 内 核 设置 不 支持 这 么 大 (在 
initdb 的 时 候 判 断 )， 可 能 会 比 这 个 数 少 。 这 个 参数 只 能 在 服务 器 启动 的 时 候 设置 。 


当 运 行 一 个 备用 服务 器 ， 你 必须 将 此 参数 设置 为 比 主 服务 器 上 相同 的 或 更 高 的 值 。 否 则 ， 不 
允许 在 备用 服务 器 上 进行 查询 。 


superuser_reserved_connections ( integer ) 


决定 为 PostgreSQL 超 级 用 户 连接 而 保留 的 连接 " 模 位 "。 一 次 最 多 可 以 同时 激 

活 max_connections 个 连接 。 在 活路 的 并 发 连 数 接 到 了 max_connections 减 

去 superuser_reserved_connections 的 时 候 ， 新 的 连接 就 只 能 由 超级 用 户 发 起 了 ， 并 且 不 接收 
新 的 复制 连接 。 


缺 省 值 是 3。 这 个 值 必须 小 于 max_connections 的 值 。 这 个 参数 只 能 在 服务 器 启动 的 时 候 设 
io 


unix_socket_directories ( string ) 


指定 Unix 域 套 接 字 (S) 的 目录 ， 并 且 服 务 器 监听 来 自 客户 端 应 用 程序 的 连接 。 多 个 套 接 字 
可 以 通过 列 出 多 个 用 过 号 分 隔 的 目录 创建 。 忽略 条 目 之 间 的 空白 ; 如 果 你 需要 包含 空格 或 逗号 
的 名 字 ， 增 加 带 有 双 引 号 的 目录 名 。 空 值 指定 不 监听 任何 Unix 域 的 套 接 字 ， 在 这 种 情况 下 ， 
只 有 TCP/IP 套 接 字 可 以 用 于 连接 到 服务 器 。 默认 值 通常 是 /tmp ， 但 可 以 在 编译 的 时 候 改 
变 。 这 个 参数 只 能 在 服务 器 启动 的 。 


除 套 接 字 文件 本 身 外 ， 它 被 命名 为 .S.PGSQL.~~_nnnn_ , 其 中 _nnnn_ 是 服务 器 的 端口 号 ， pes 
通 文件 命名 的 .s.P6sQL.、_nnnn_ .lock 将 在 每 个 unix_socket_directories 目录 中 创建 。 永远 
都 不 应 该 手动 删除 这 两 个 文件 。 


这 个 参数 在 Windows 上 是 无 关 紧 要 的 ， 它 不 具有 Unix 域 套 接 字 。 
unix_socket_group ( string ) 


置 Unix 域 套 接 字 的 所 属 组 ( 套 接 字 的 所 属 用 户 总 是 启动 服务 器 的 用 户 )。 可 以 与 选 
项 unix_socket_permissions 一 起 用 于 对 套 接 字 进 行 访问 控制 。 缺 省 是 一 个 空 字符 串 ， 表示 当 
前 服务 器 用 户 的 缺 省 组 。 这 个 选项 只 能 在 服务 器 启动 的 时 候 设 置 。 


这 个 参数 在 Windows 上 是 无 天 紧要 的 ， 它 不 具有 Unix 域 套 接 字 。 
unix_socket_permissions ( integer ) 


置 Unix 域 套 接 字 的 访问 权限 。Unix 域 套 接 字 使 用 普通 的 Unix 文 件 系统 权限 集 。 这 个 参数 值 
应 eeu 也 就 是 系统 调用 chmod 和 umask 接受 的 形式 。 如 果 使 用 自 定义 的 八进制 
格式 ， 数 字 必 须 以 o Fko 


缺 省 的 权限 是 09777 ， 意 思 是 任何 人 都 可 以 连接 。 合 理 的 候选 是 go776 (只 有 用 户 和 同 组 的 人 
可 以 访问 ， 又 见 unix_socket_group ) 和 0700 (只 有 用 户 自 己 可 以 访问 )。 请 注意 ， 对 于 Unix 域 
套 接 字 ， 只 有 写 权 限 有 意义 ， 因此 在 设置 和 撤销 读 和 执行 权限 中 没有 任何 意义 。 


这 个 访问 控制 机 制 与 Chapter 19 里 描述 的 用 户 认 证 毫 无 关系 。 
这 个 参数 只 能 在 服务 器 启动 的 时 候 设 置 。 


bs 


这 个 参数 在 Windows 上 是 无 关 紧 要 的 ， 它 不 具有 Unix 域 套 接 字 。 

bonjour ( boolean ) 

通过 Bonjour 启 动 广播 服务 器 的 存在 。 缺 省 是 关闭 的 。 这 个 值 只 能 在 服务 器 启动 的 时 候 设 置 。 
bonjour_name ( string ) 


声明 Bonjour 服 务 器 名 称 。 BERR | Ca eo 
Bonjour 支 持 那 么 将 忽略 这 个 参数 。 这 个 值 只 能 在 服务 器 和 启动 的 时 候 设 


tcp_keepalives_idle ( integer ) 


声明 发 送 保持 活跃 信号 的 间隔 秒 数 ， 不 发 送 保持 活跃 信号 ， 连 接 就 会 多 于 闲置 状态 。 SER 
系统 默认 值 。 该 参数 仅 在 支持 TcP_KEEPIDLE 或 者 TcP_KEEPALIVE 符号 以 及 Windows 的 系统 上 
出 现 ;在 其 它 系 统 中 ， 它 必须 是 需 。 在 通过 Unix 域 套 接 字 连接 的 会 话 中 ， 这 个 参数 被 忽略 ， 并 
且 总 是 读 为 需 。 





Note: 在 Windows 中 ，0 值 将 这 个 参数 设置 为 2 小 时 ， 因为 Windows 不 提供 读 取 系统 默认 
值 的 方法 。 


tcp_keepalives_interval ( integer ) 


声明 发 送 保持 活路 信号 的 间隔 秒 数 ， 不 发 送 保持 活路 信号， 连接 就 会 多 于 闲置 状态 。 BER 
系统 默认 值 。 在 那些 支持 TcP_KEEPINTVL 符号 以 及 Windows 的 系统 上 支持 这 些 参数 。 在 其 他 
系统 上 ， 这 个 参数 必须 为 需 。 在 通过 Unix 域 套 接 字 连 接 的 会 话 中 ， 这 个 参数 被 忽略 ， 并 且 总 





Note: 在 Windows 中 ，0 值 将 这 个 参数 设置 为 1 秒 ， 因 为 Windows 不 提供 读 取 和 有 系统 默认 值 
的 方法 。 


tcp_keepalives_count ( integer ) 


声明 发 送 保持 活路 信号 的 数量 ， 不 发 送 保持 活跃 信 号， 连接 就 会 多 于 闲置 状态 。 BRARK 
默认 值 。 在 那些 支持 Tcp_kEEPCNT 的 系统 上 支持 这 些 参数 。 在 其 他 系统 上 ， 这 个 参数 必须 为 
3, 在 通过 Unix 域 套 接 字 连接 的 会 话 中 ， 这 个 选项 被 忽略 ， 并 且 总 是 读 为 需 。 


Note: 在 Windows 上 不 支持 这 个 参数 ， 并 且 总 是 为 需 。 


18.3.2. 安全 和 认证 


authentication_timeout ( integer ) 


完成 客户 端 认 证 的 最 长 时 间 ， 以 秒 计 。 如 果 一 个 客户 端 没 有 在 这 段 时 间 里 完成 认证 协议 ， 服 
务 器 将 中 断 连 接 。 这 样 就 避免 了 出 问题 的 客户 端 无 限制 地 占据 连接 资源 。 缺 省 是 60 秒 ( lm )。 
这 个 选项 只 能 在 命令 行 上 或 者 在 postgresql.conf 里 设置 。 


ssl ( boolean ) 


启用 SSL 连 接 。 请 在 使 用 这 个 选项 之 前 阅读 Section 17.9. RAE offo 这 个 选项 只 能 在 服 
务 器 启动 的 时 候 设置 。SSL 通 讯 与 TCP/IP 连接 是 唯一 可 能 的 。 


ssl ca file ( string ) 


指定 包含 SSL 服 务 器 证 书 颁 发 机 构 (CA) 的 文件 名 称 。 默认 值 为 空 ， 意 味 着 没有 CA 文件 被 
加 载 ， 并 且 不 进行 客户 端 证 书 验证 。 (在 以 前 的 PostgreSQL 版 本 中 ， 此 文件 的 名 称 是 作 
为 root ,crt 的 硬 编 码 。) 相对 路 径 是 相对 于 数据 目录 。 这 个 参数 只 能 在 服务 器 启动 进行 设 
置 。 


ssl_cert_file ( string ) 


指定 包含 SSL 服 务 器 证 书 的 文件 名 称 。 默认 值 是 server.crt 。 相 对 路 径 是 相对 于 数据 目录 。 
这 个 参数 只 能 在 服务 器 启动 时 进行 设置 。 


ssl crl file ( string ) 


指定 包含 SSL 服 务 器 证 书 撤销 列表 (CRL) 的 文件 名 称 。 默认 值 为 空 ， 意 味 着 没有 CRL 文 件 被 加 
载 。 (在 PostgreSQL 的 早期 版 本 中 ， 该 文件 的 名 称 为 root .crl 的 硬 编码 。) 相对 路 径 是 相 


对 于 数据 目录 。 这 个 参数 只 能 在 服务 器 启动 时 候 进 行 设置 。 
ssl key file ( string ) 


指定 包含 SSL 服 务 器 私 钥 的 文件 名 称 。 
这 个 参数 只 能 在 服务 器 启动 时 设置 。 


默认 值 是 server.key 。 相 对 路 径 是 相对 于 数据 目录 。 


ssl_renegotiation_limit ( integer ) 

在 会 话 密 钥 发 生 重 新 商议 之 前 ， 指 定 多 少数 据 可 以 进行 SSL- 加 密 。 当 大 量 流量 被 检查 的 时 
候 ， 但 它 也 会 产生 大 量 性 能 损失 ， 重 新 谈判 降低 攻击 者 密码 分 析 的 机 会 。 总 的 发 送 和 接收 的 
流量 用 于 检查 极限 。 如 果 该 参数 被 设置 为 0， 禁用 重新 谈判 。 默 认 值 是 512MB o 


Note: 当 使 用 SSL 时 再 商议 时 候 ，2009 年 11 月 之 前 的 SSL 库 是 不 安全 的 ， 由 于 SSL 协 议 的 
一 个 漏洞 。 作为 这 个 漏洞 修复 ， 一 些 厂 商 出 货 的 SSL 库 不 能 重新 谈判 。 如 果 在 客户 端 或 


Pes 


服务 器 上 使 用 任何 库 ， 应 茶 用 SSL 重 新 协商 。 








ssl_ciphers ( string ) 


指定 SSL 密 码 列表 ， 在 安全 连接 上 人 允许 使 用 。 参阅 openssl 手 册页 支持 的 密码 列表 。 


password_encryption ( boolean ) 


在 CREATE USER 或 者 ALTER ROLE 里 声明 了 一 个 口令 ， 而 又 没有 写 ENCRYPTED 或 


者 UNENCRYPTED 的 时 候 ， 这 个 选项 决定 口令 是 否 要 加 密 。 缺 省 是 on (MBO). 


krb_server_keyfile ( string ) 
设置 Kerberos 服 务 器 键 字 文件 的 位 置 。 参 阅 Section 19.3.5 或 者 Section 19.3.3 获 取 细 节 。 这 
个 参数 只 能 在 postgresql.conf 文件 或 者 服务 器 命令 行 中 设置 。 


krb_srvname ( string ) 


设置 Kerberos 服 务 名 。 参 阅 Section 19.3.5 获 取 细 节 。 这 个 参数 只 能 在 postgresql.conf 文件 


或 者 服务 器 命令 行 中 设置 。 
krb_caseins_users ( boolean ) 

设置 Kerberos 和 GSSAPI 用 户 名 是 否 大 小 写 无 关 。 缺 省 是 off (大 小 写 相 关 )。 这 个 
在 postgresql.conf 文件 或 者 服务 器 命令 行 中 设置 。 

db_user_namespace ( boolean ) 

这 个 参数 启动 每 个 数据 库 的 用 户 名 。 缺 省 是 关闭 的 。 这 个 参数 只 能 在 命令 行 上 或 者 
在 postgresql.conf 里 设置 。 


如 果 打 开 这 个 选项 ， 你 应 该 像 username@dbname 这 样 创建 用 rs 在 给 一 个 正在 连接 的 客 户 端 传 
递 username 的 时 候 ， 必 须 给 用 户 名 附加 @ 和 数据 库 名 字 ， 然后 服务 器 查找 该 数据 库 相 关 的 
用 户 名 字 。 请 注意 ， 如 果 你 在 SQL 环境 里 创建 包含 @ 的 名 字 时 ， 你 需要 用 引号 包围 用 户 名 。 


打开 这 个 选项 之 后 ， 你 还 是 能 够 创建 普通 的 全 局 用 户 。 只 要 在 客户 端 声明 用 户 的 时 候 附 加 一 
个 @ 即 可 。 上 比如 joe@ 。 在 服务 器 查找 这 个 用 户 名 之 前 ， 这 个 @ 会 被 剥 除 。 


db_user_namespace 导致 客户 端 和 服务 器 端的 用 户 名 表示 不 同 。 验证 检查 总 是 与 该 服务 器 的 用 
户 名 一 起 进行 ， 所 以 验证 方法 必须 配置 为 服务 器 的 用 户 名 ， 而 不 是 客户 端的 。 因 为 ms 在 客 
户 端 和 服务 器 上 使 用 用 户 名 ， md5 不 能 与 db_user_namespace 一 起 使 用 。 





Note: 这 个 特性 只 是 临时 措施 ， 直 到 找到 一 个 完全 的 解决 方案 。 那 个 时 候 ， 这 个 选项 将 
被 删除 。 





18.4. 资源 消耗 


18.4.1. 内 存 


shared_buffers ( integer ) 


设置 数据 库 服务 器 将 使 用 的 共享 内 存 缓冲 区 数量 。 缺 省 通常 是 128 兆 字 节 ( 128MB )， 但 是 如 果 
你 的 内 核 设置 不 支持 这 么 大 ， 那 么 可 以 少 些 (在 initdb 的 时 候 决定 )。 每 个 缓冲 区 大 小 的 典型 值 
是 128 千 字 节 ， ( BLcKSz 的 非 缺 省 值 改 变 最 小 值 ) 不 过 ， 这 个 数值 比 最 小 值 大 一 些 通常 需 
更 好 的 性 能 。 这 个 选项 只 能 在 服务 器 启动 的 时 候 设置 。 


如 果 你 有 1GB 或 更 多 内 存 的 专用 数据 库 服务 器 ， 对 于 shared_buffers 合理 的 初始 值 是 您 的 系 
统 内 存 的 25%。 有 一 些 工作 负载 ， 基 至 在 那里 对 于 shared_buffers 大 设置 是 有 效 的 ， 但 因为 
PostgreSQL 也 依赖 于 操作 系统 缓存 ， 它 是 不 可 能 的 ，RAM 到 shared_buffers 的 多 于 40% 的 

分 配 比 更 少数 量 的 工作 的 更 好 。 对 于 shared_buffers 的 大 量 设置 通常 要 求 相 应 增 

加 checkpoint_segments , 为 了 延长 写 大 量 新 的 或 者 需 较 长 时 间 修 改 的 数据 的 进程 。 


对 于 少 于 1GB RAM 系 统 ， 较 小 百分比 内 存 是 相应 的 ， 以 便 为 操作 系统 留 有 足够 的 空间 。 此 
外 ， 在 Windows 上 ， shared_buffers 大 点 的 值 不 是 很 有 效 。 您 可 能 会 发 现 更 好 的 结果 保持 设 
置 相 对 较 低 ， 并 且 使 用 操作 系统 的 缓存 代替 。 在 Windows 系 统 上 shared_buffers 的 有 用 范围 
一 般 是 从 64MB 到 512MB。 


temp_buffers ( integer ) 


设置 每 个 数据 库 会 话 使 用 的 临时 缓冲 区 的 最 大 数目 。 这 些 都 是 会 话 的 本 地 缓冲 区 ， 只 用 于 访 
问 临 时 表 。 缺 省 是 8 兆 字 节 ( gmB )。 这 个 设置 可 以 在 独立 的 会 话 内 部 设置 ， 但 是 只 有 在 会 话 第 
一 次 使 用 临时 表 的 时 候 示 能 增长 ; 企图 在 该 会 话 里 随后 改变 该 数值 是 无 效 的 。 


一 个 会 话 将 按照 temp_buffers 给 出 的 限制 ， 根 据 需 要 分 配 临 时 缓冲 区 。 如 果 在 一 个 并 不 需要 
大 量 临 时 缓冲 区 的 会 话 里 设置 一 个 大 的 数值 ， 其 开销 只 是 一 个 缓冲 区 描述 符 ， 或 者 说 每 

个 temp_buffers 增加 大 概 64 字 节 。 不 过 ， 如 果 一 个 缓冲 区 实际 上 被 使 用 ， 那么 就 会 额外 消耗 
8192 字 节 ( 或 者 说 是 BLSZ 字 节 )。 


max_prepared_transactions ( integer ) 


设置 可 以 同时 处 于 "预备 "状态 的 事务 的 最 大 数目 (参阅 PREPARE TRANSACTION), 把 这 个 参 
HREJE (RERE) 则 关闭 预备 事务 的 特性 。 这 个 值 只 能 在 服务 器 启动 的 时 候 设置 。 


如 果 你 不 打算 使 用 预 各 事务 ， 这 个 参数 也 可 以 设置 为 需 。 避免 预备 事务 的 偶然 建立 。 如 果 你 
使 用 它们 ， 你 可 能 会 需要 把 max_prepared_transactions 设置 成 至 少 和 max connections 一 样 


大 ， 以 避免 每 个 会 话 可 以 有 预备 事务 挂 起 。 


当 运 行 备 库 服务 器 时 ， 你 必须 设置 相同 参数 或 者 比 主 服务 器 上 更 高 参数 值 。 否则 ， 在 各 库 服 
务 器 上 不 人 允许 查询 。 


work_mem ( integer ) 


声明 内 部 排序 操作 和 Hash 表 在 开始 使 用 临时 磁盘 文件 之 前 使 用 的 内 存 数目 。 缺 省 数值 是 1 兆 
字 节 ( 1MB )。 请 注意 对 于 复杂 的 查询 ， 可 能 会 同时 并 发 运行 好 几 个 排序 或 者 散 列 操作 ; 每 个 
都 会 被 批准 使 用 这 个 参数 声明 的 这 么 多 内 存 ， 然后 才 会 开始 求助 于 临时 文件 。 同 样 ， 好 几 个 
正在 运行 的 会 话 可 能 会 同时 进行 排序 操作 。 因此 使 用 的 总 内 存 可 能 是 work_mem 的 好 几 倍 。 
当选 择 这 个 值 的 时 候 ， 必 须 记 住 这 个 事实 。 ORDER BY, DISTINCT 和 融合 连接 都 要 用 到 排序 操 
YE, Hash 表 在 散 列 连接 、 散 列 为 基础 的 聚集 、 散 列 为 基础 的 IN 子 查询 处 理 中 都 要 用 到 。 


maintenance_work_mem ( integer ) 


声明 在 维护 性 操作 (比如 vacuum , CREATE INDEX 和 ALTER TABLE ADD FOREIGN KEY ) 中 使 用 的 最 
大 的 内 存 数 。 缺 省 是 16 兆 字 节 ( 16MB )。 因 为 在 一 个 数据 库 会 话 里 ， 任意 时 刻 只 有 一 个 这 样 
的 操作 可 以 执行 ， 并 且 一 个 数据 库 安 装 通常 不 会 有 太 多 这 样 的 工作 并 发 执行 ， 把 这 个 数值 设 
置 得 比 work_mem 更 大 是 安全 的 。 更 大 的 设置 可 以 改进 清理 和 恢复 数据 库 转 储 的 速度 。 


请 注意 ， 当 运行 自动 清理 ， 直至 autovacuum max workers 次 分 配 这 个 内 存 ， 所 以 要 小 心 ， 
不 要 设置 默认 值 太 高 。 


max_stack_depth ( integer ) 


声明 服务 器 的 执行 堆栈 的 最 大 安全 深度 。 为 此 设置 一 个 参数 的 原因 是 内 核 强制 的 实际 堆栈 尺 

寸 (就 是 ulimit -s 或 者 局 部 等 效 物 的 设置 ) 小 于 安全 的 一 兆 字 节 左右 的 范围 。 需 要 这 个 安全 界 
限 是 因为 在 服务 器 里 ， 并 非 所 有 过 程 都 检查 了 堆栈 深度 ， 只 是 在 可 能 递 规 的 过 程 ， 比 如 表达 

式 计 算 这 样 的 过 程 里 面 才 进行 检查 。 缺 省 设置 是 2 兆 字 节 ome, 这 个 值 相 对 比较 小 ， 不 容易 

导致 拥 溃 。 但 是 ， 这 个 值 可 能 太 小 了 ， 以 至 于 无 法 执行 复杂 的 函数 。 

把 max_stack_depth 参数 设置 得 大 于 实际 的 内 核 限制 意味 着 一 个 正在 运行 的 递归 图 数 可 能 会 
致 一 个 独立 的 服务 器 进程 的 衣 渍 。 在 PostgreSQL 能 够 检测 内 核 限 制 的 平台 上 ， 服务 器 将 不 

允许 你 将 其 设置 为 一 个 不 安全 的 值 。 因为 并 非 所 有 平台 都 能 够 检测 ， 所 以 还 是 建议 你 在 此 设 
置 一 个 明确 的 值 。 


18.4.2. 人 磁盘 


temp_file limit ( integer ) 


指定 会 话 可 以 使 用 临时 文件 的 最 大 磁盘 空间 ， 如 排序 和 哈 希 临 时 文件 ， 或 持 有 游标 的 存储 文 
件 。 一 个 事务 试图 超过 这 个 限制 将 被 取消 。 该 值 是 指定 的 千 字 节 ， 并 且 -1 (RE) 意味 着 
没有 限制 。 只 有 超级 用 户 可 以 更 改 此 设置 。 


此 设置 限制 任何 时 刻 通过 临时 文件 使 用 给 定 PostgreSQL 会 话 使 用 的 总 空间 。 应 当 指 出 的 是 ， 
使 用 显 式 临时 表 的 磁 友 空间， 而 不 是 使 用 查询 执行 的 幕后 临时 文件 ， 并 强调 不 影响 这 个 限 
制 。 


18.4.3. 内 核资 源 使 用 


max_files_per_process ( integer ) 


设置 每 个 服务 器 进程 允许 同时 打开 的 最 大 文件 数目 。 缺 省 是 1000。 如 果 内 核 强制 一 个 合理 的 
每 进程 限制 ， 那 么 你 不 用 操心 这 个 设置 。 但 是 在 一 些 平台 上 (特别 是 大 多 数 BSD 系 统 )， AK 
允许 独立 进程 打开 比 个 系统 真正 可 以 支持 的 数目 大 得 多 得 文件 数 。 如 果 你 发 现 有 "Too many 
open files" 这 样 的 失败 现 像 ， 那 么 就 尝试 缩小 这 个 设置 。 这 个 值 只 能 在 服务 器 启动 的 时 候 设 
E., 


shared_preload_libraries ( string ) 


这 个 变量 声明 一 个 或 者 多 个 在 服务 器 启动 的 时 候 预 先 装 载 的 共享 库 。 比如 '$libdir/mylib' 会 
在 加 载 标准 库 目 录 中 的 库 文件 之 前 预先 加 载 ' mylip.so (在 某 些 平台 上 可 能 是 mylib.sl ) 库 文 

件 。 所 有 库 名 转换 成 小 写 ， 除 非 双 引号 引用 。 如 果 有 多 个 库 被 加 载 ， 将 他 们 的 名 字 用 逗号 分 

隔 。 这 个 值 只 能 在 服务 器 启动 的 时 候 设 置 。 


可 以 用 这 个 方法 预先 装载 PostgreSQL 的 过 程 语言 库 ， 通常 是 使 用 '$libdir/plxxx' 语法 ， 这 
里 的 xxx 是 pgsql ， perl , tcl 或 者 python ies 


通过 预先 装载 一 个 共享 库 (以 及 在 需要 的 时 候 初 始 化 它 )， 我们 就 可 以 避免 第 一 次 使 用 这 个 库 
的 加 载 时 间 。 不 过 ， 启动 每 个 服务 器 进程 的 时 间 可 能 会 增加 ， 即使 进程 从 来 没有 使 用 过 这 些 
库 也 这 样 。 因此 我 们 只 是 建议 对 那些 将 被 大 多 数 会 话 使 用 的 库 才 使 用 这 个 选项 。 


Note: 在 Windows 主 机 上 ， 在 服务 器 启动 时 预 加 载 库 并 不 会 减少 所 需 的 时 间 来 启动 每 个 
新 的 服务 器 进程 ; 每 个 服务 器 进程 将 重新 加 载 所 有 的 预 置 库 。 然 

而 ， shared preload_libraries 仍然 是 在 Windows 主 机 上 有 用 的 ， 因为 某 些 共享 库 可 能 
需要 执行 只 发 生 在 启动 时 的 某 些 操作 〈 例 如， 一 个 共享 库 可 能 需要 预定 轻 量 级 锁 或 共享 
内 存 ， 和 启动 开始 之 后 你 不 能 这 样 做 ) 








如 果 没有 找到 声明 的 库 ， 那 么 服务 器 启动 将 失败 。 


每 一 个 支持 PostgreSQL 的 库 都 有 一 个 "magic block" 用 于 保证 兼容 性 。 因此 ， 不 支持 
PostgreSQL 的 库 不 能 用 这 种 办 法 加 载 。 


18.4.4. 基于 开销 的 清理 延迟 


在 VACUUM 和 ANALYZE 命 令 执 行 过 程 中 ， 系统 维护 一 个 内 部 的 记 数 器 ， 跟 踪 所 执行 的 各 种 

IO 操作 的 近似 开销 。 如 果 积 累 的 开销 达到 了 vacuum_cost_limit 声明 的 限制 ， 那么 执行 这 个 
操作 的 进程 将 睡眠 vacuum_cost_delay 指定 的 时 间 。 然后 它 会 重 置 记 数 器 然后 继续 执行 。 

这 个 特性 的 目的 是 允许 管理 员 减 少 这 些 命令 在 并 发 活动 的 数据 库 上 的 MO 影响 。 比如 ， 

像 vacuum 和 ANALYZE 这 样 的 维护 命令 并 不 需要 迅速 完成 ， 并 且 不 希望 它们 严重 干扰 系统 执行 
其 它 的 数据 库 操作 。 基于 开销 的 清理 延迟 为 管理 员 提 供 了 一 个 实现 这 个 目的 的 手段 。 

这 个 特性 缺 省 手动 发 出 vacuum 命令 是 关闭 的 。 要 想 打 开 它 ， 把 vacuum_cost_delay 变量 设置 
为 一 个 非 需 值 。 


vacuum_cost_delay ( integer ) 


以 毫秒 计 的 时 间 长 度 ， 如 果 超过 了 开销 限制 ， 那 么 进程 将 睡眠 一 会 儿 。 缺 省 值 0 关 闭 基于 开销 
9 清理 延迟 特性 。 正 数值 打开 基于 开销 的 清理 。 不 过 ， 要 注意 在 许多 系统 上 ， 睡 眠 的 有 效 分 
辩 率 是 10 富 秒 ; 把 vacuum_cost_delay 设置 为 一 个 不 是 10 的 整数 倍 的 数值 与 将 它 设置 为 下 一 
个 10 的 整数 倍 作用 相同 。 


当 使 用 基于 成 本 的 清理 ， vacuum_cost_delay 的 适当 值 通常 是 相当 小 的 ， 也 许 10 或 20 窜 秒 。 
调节 清理 的 资源 消耗 最 好 是 通过 改变 其 它 清理 开销 参数 完成 的 。 
vacuum_cost_page_hit ( integer ) 


清理 一 个 在 共享 缓存 里 找到 的 缓冲 区 的 预计 开销 。 它 代表 锁 住 缓冲 池 、 查 找 共享 的 Hash 表 、 
扫描 页 面 内 容 的 开销 。 缺 省 值 是 1。 


vacuum_cost_page_miss ( integer ) 


清理 一 个 要 从 磁盘 上 读 取 的 缓冲 区 的 预计 开销 。 它 代表 锁 住 缓冲 池 、 查 找 共享 Hash 表 、 从 磁 
盘 读 取 需 要 的 数据 块 、 扫描 它 的 内 容 的 开销 。 缺 省 值 是 10。 


vacuum_cost_page_dirty ( integer ) 


清理 修改 一 个 原先 是 干净 的 块 的 预计 开销 。 CRITE SAR MATE ie A FAH 
外 开销 。 缺 省 值 是 20。 


vacuum cost_limit ( integer ) 
导致 清理 进程 休眠 的 积累 开销 。 人 缺 省 是 200。 


Note: 有 些 操作 会 持 有 关键 的 锁 ， 并 且 应 该 尽快 结束 。 在 这 样 的 操作 过 程 中 ， 基 于 开销 
的 清理 延迟 不 会 发 生 作 用 。 因此 开销 积累 远 远 高 于 指定 的 限制 是 可 能 的 。 为 了 避免 在 这 
种 情况 下 的 长 延 时 ， 实际 的 延迟 是 vacuum_cost_delay accumulated_balance / 
vacuum_cost_limit 与 vacuum_cost_delay 4 两 者 之 间 的 最 大 值 。 




















18.4.5. vin S st te 


从 PostgreSQL 8.0 开始 ， 就 有 一 个 独立 的 服务 器 进程 ， 叫 做 后 端 写 进程 ， 它 唯一 的 功能 就 是 
发 出 写 " 脏 "共享 缓冲 区 的 命令 。 这 人 么 做 的 目的 是 让 持 有 用 户 查 询 的 服务 器 进程 应 该 很 少 或 者 

几乎 不 等 待 写 动作 的 发 生 ， 因为 后 端 写 进程 会 做 这 件 事情 。 这 样 的 安排 同样 也 减少 了 检查 点 
造成 的 性 能 下 降 。 后 端 写 进 程 将 持续 的 把 脏 页 面 刷新 到 磁盘 上 ， 所 以 在 检查 点 到 来 的 时 候 ， 

只 有 几 个 页 面 需 要 刷新 到 磁盘 上 。 但 是 这 样 还 是 增加 了 1/O 的 总 净 负 荷 ， 因 为 以 前 的 检查 点 
间隔 里 ， 一 个 重复 弄 脏 的 页 面 可 能 只 会 冲刷 一 次 ， 而 同一 个 间隔 里 ， 后 端 写 进程 可 能 会 写 好 
几 次 。 在 大 多 数 情 况 下 ， 连 续 的 低 负 荷 要 上 比 周期 性 的 尖峰 负荷 好 ， 但 是 在 本 节 讨 论 的 参数 可 
以 用 于 按 实际 需要 调节 其 行为 。 


bgwriter_delay ( integer ) 


声明 后 端 写 进 程 活路 轮回 之 间 的 延迟 。 在 每 个 轮回 里 ， 写 进 程 都 会 为 一 些 脏 的 缓冲 区 发 出 写 
操作 (可 以 用 下 面 的 参数 控制 )。 然后 它 就 休 眼 bgwriter_delay aR), 然后 重复 动作 。 当 在 组 
冲 池 中 没有 脏 缓 冲 区 时 ， 但 是 ， 它 会 无 论 bgwriter_delay 的 值 ， 进 入 一 个 较 长 的 睡眠 。 RA 
值 是 200( 200ms )。 请 注意 在 许多 系统 上 ， 休 眠 延 时 的 有 效 分 辩 率 是 10 室 秒 ; 因此 ， 

把 bgwriter_delay 设置 为 一 个 不 是 10 的 倍数 的 数值 与 设置 为 下 一 个 10 的 倍数 是 一 样 的 效果 。 
这 个 选项 只 能 在 服务 器 启动 的 时 候 或 者 在 postgresql.conf 文件 里 设置 。 


bgwriter_lru_maxpages ( integer ) 


在 每 个 轮回 里 ， 不 超过 这 人 么 多 个 缓冲 区 将 通过 后 端 写 进程 写 信 磁盘。 设置 为 需 和 启动 后 端 写 进 
程 。 (请 注意 检查 点 ， 通 过 单独 的 ， 专 用 辅助 进程 来 管理 ， 不 受 影响 。) 缺 省 值 是 100。 这 
个 选项 只 能 在 服务 器 命令 行 或 者 在 postgresql.conf 文件 里 设置 。 


bgwriter_lru_multiplier ( floating point ) 


写 在 每 一 轮 的 脏 缓冲 区 数目 是 根据 通过 最 近 几 轮 服务 器 处 理 所 需 的 新 的 缓冲 区 数 。 最 近 平均 
需求 乘 以 bgwriter_lru multiplier 到 达 将 在 下 一 轮 中 需要 的 缓冲 区 的 数目 的 估计 。 脏 缓 冲 区 
写 入 直到 有 许多 干净 的 ， 可 重复 使 用 的 缓冲 区 可 用 。 《但 是 ， 每 回 写 和 不 超 

过 bgwriter_lru_maxpages 的 缓冲 区 。) 因此 ，1.0 的 设置 表示 写 入 确切 预测 需要 的 缓冲 区 数 
量 的 "合适 "策略 。 较 大 的 值 提供 针对 需求 高 峰 一 定 的 缓冲 作用 ， 而 较 小 的 值 故 意 留 下 服务 器 
进程 完成 宇 入 。 默认 值 是 2.0。 这 个 参数 只 能 在 postgresql.conf 文件 或 者 服务 器 命令 行 中 设 
E. 


小 的 bgwriter_lru_maxpages 和 bgwriter_lru_multiplier 减少 后 端 写 进程 导致 的 额外 JO 负 
fa, 但 是 会 有 可 能 使 服务 器 进程 不 得 不 自己 发 出 写 动 作 ， 降 低 查 询 的 交互 性 。 


18.4.6. Asynchronous Behavior 


effective_io_concurrency ( integer ) 


设置 PostgreSQL 预 计 可 以 同时 执行 的 并 发 磁盘 的 Il/O 操 作 数 。 增 大 该 数值 将 增加 任何 单独 的 
PostgreSQL 会 话 尝 试 并 行 启 动 的 |/O 操 作 数 。 人 允许 的 范围 是 1 到 1000， 或 者 需 禁 用 发 出 异步 
I/O 请 求 。 目 前 ， 此 设置 只 影响 堆 位 图 扫描 。 


这 个 设置 很 好 的 起 点 是 包括 一 个 RAID 0 或 用 于 数据 库 的 RAID 1 镜像 的 单独 驱动 器 数 。 (对 于 
RAID 5 奇偶 校 验 驱 动 器 不 应 该 计算 在 内 。) 然而 ， 如 果 数 据 库 经 常 忙于 在 并 发 会 话 中 发 出 多 
个 查询 ， 更 低 的 数值 可 能 是 足够 的 ， 以 保持 磁盘 阵列 繁忙 。 上 比 需 要 保持 磁盘 繁忙 更 大 的 值 将 
只 会 造成 额外 的 CPU 开销 。 

对 于 更 奇特 的 系统 ， 如 基于 内 存 的 存储 或 由 总 线 带 宽 限 制 的 RAID 阵 列 ， 正 确 的 值 可 能 是 可 用 
I/O 路 径 数 。 一 些 试验 可 能 需要 找到 最 好 的 值 。 


异步 |/O 依 赖 于 有 效 的 posix_fadvise 功能 ， 其 中 一 些 是 操作 系统 所 缺乏 的 。 如 果 函 数 不 存 
在 ， 那 么 这 个 参数 设置 为 任何 东西 ， 但 是 需 将 导致 错误 。 在 某 些 操作 系统 上 “(例如 
Solaris) ， 画 数 存在 ， 但 实际 上 并 没有 做 任何 事情 。 


18.5. 预 写 式 日 志 


参阅 Section 29.4 获 取 调 整 这 些 设置 的 额外 信息 。 


alll 


18.5.1. 3% E 


wal_level ( enum ) 


wal_level 决定 有 多 少 信 息 被 宇和 人 到 WAL 中 。 默认 值 是 最 小 的 ， 其 中 写 人 唯一 从 骨 溃 或 立即 
关机 中 恢复 的 所 需 信 息 。 archive 补充 WAL 愉 档 需要 的 日 志 记 录 ， 以 及 hot_standby 进一步 
增加 在 各 用 服务 器 上 运行 只 读 查 询 所 需 的 信息 。 这 个 参数 只 能 在 服务 器 启动 时 设置 。 


在 最 小 级 别 中 ， 安 全 地 忽略 一 些 批量 操作 的 WAL- 日 志 ， 这 可 以 使 那些 操作 快 很 多 〈 参 
阅 Section 14.4.7) 。 这 种 优化 可 以 应 用 到 : 


CREATE TABLE AS 
CREATE INDEX 


CLUSTER 


copy into tables that were created or truncated in the same transaction 


但 是 最 小 的 WAL 不 包含 从 基本 的 各 份 和 WAL 日 志 中 重建 数据 的 足够 信息 ， 所 以 archive 或 
者 hot_standby 级 别 必须 用 来 启动 WAL 愉 档 (archive _ mode) 和 流 复 制 。 


在 hot_standby 级 别 ， 相 同 的 信息 被 记录 为 archive, 加 上 需要 重建 从 WAL 和 运行 的 事务 状态 
信息 。 为 了 在 备用 服务 器 上 启用 只 读 查 询 ， 主 库 上 wal_level ! 必须 设置 为 hot_standby , Ws 
2B 3h Ehot_standby. 使 用 hot_standby 和 archive 级 别 之 间 的 性 能 几乎 没有 可 测量 
的 差异 ， 如 果 任 何 生产 的 影响 是 明显 的 ， 则 是 值得 欢迎 的 。 


fsync ( boolean ) 


如 果 打 开 这 个 选项 ， 那 么 PostgreSQL 服 务 器 将 在 好 几 个 地 方 使 用 fsync() 系统 调用 (或 等 价 
调用 ， 参 见 wal _sync_method) 来 确保 更 新 已 经 物理 上 罕 到 磁盘 中 。 这 样 就 保证 了 数据 库 集群 
将 在 操作 系统 或 者 硬件 崩溃 的 情况 下 恢复 到 一 个 一 致 的 状态 。 


HKA fsync 时 通常 是 性 能 利益 ， 这 可 能 会 导致 发 生 断 电 或 系统 崩溃 时 不 可 恢复 数据 丢失 。 
如 果 你 可 以 很 容易 的 从 外 部 数据 中 创建 您 的 整个 数据 库 ， 因此 关闭 fsync 是 明智 的 。 


关闭 fsync 安全 情况 的 例子 包括 备份 文件 中 新 的 数据 库 集群 的 初始 加 载 ， 数据 库 被 丢弃 和 重 
新 创建 之 后 ， 使 用 数据 库 集群 批 处 理 数 据 ， 或 者 为 只 读数 据 库 克 隆 被 频繁 重建 并 且 不 用 于 故 
障 转 移 。 为 了 关闭 fsync 高 质量 硬件 本 身 是 不 充分 的 。 


当 改 变 fsync 从 关闭 到 打开 时 ， 对 于 可 靠 的 恢复 ， 必须 强制 内 核 中 所 有 被 修改 的 缓冲 区 到 持 
AE. 当 集 群 宕 机 或 当 fsync 通 过 运行 initdb--sync-only ， sync, BRMARK, KE 
新 启动 服务 器 的 时 候 ， 再 完成 这 项 工作 。 


在 许多 情况 下 ， 关 闭 synchronous_commit 为 非 关 键 的 事务 可 以 提供 关闭 fsync 的 潜力 性 能 优 
势 ， 没有 数据 损坏 随 之 而 来 的 风险 。 


fsync 只 能 在 postgresql.conf 文 件 里 或 者 服务 器 命令 行 里 设置 。 如 果 这 个 参数 被 关闭 ， 那 么 
请 考虑 把 full_page_writes 也 关闭 了 。 


synchronous_commit ( enum ) 


命令 返回 "成 功 "指示 给 客户 端 之 前 ， 指 定 是 否 事务 提交 将 等 待 WAL 记 录 被 写 人 到 磁盘 。 AM 
值 是 on , remote_write , local 和 off. 默认 情况 下 ， 安 全 设置 是 on 。 当 off 时 ， 当 成 功 
报告 给 客户 端 ， 并 当 该 事务 真正 保证 是 安全 的 ， 不 会 在 服务 器 骨 溃 的 时 候 ， 可 以 有 一 定 的 延 
at (最 大 延迟 wal writer_ delay 的 3 倍 ) 。 不 同 于 fsync， 将 此 参数 设置 为 off 不 会 产生 任何 
数据 库 不 一 致 的 风险 : 操作 系统 或 数据 库 崩 省 可 能 导致 去 失 一 些 最 近 提交 的 事务 ， 但 数据 库 
状态 将 是 一 样 的， 正如 该 事务 已 经 彻底 终止 。 因此 ， 当 性 能 比 准 确 事务 耐久 性 更 重要 时 ， 关 


闭 synchronous_commit 是 有 效 选择 。 获取 更 多 讨论 请 参阅 Section 29.3。 


如 果 设 置 synchronous standby names, 该 参数 控制 是 否 事务 提交 将 等 待 它 的 WAL 记 录 被 复 
制 到 各 用 服务 器 。 当 设 置 on 的 时 候 ， 提交 将 等 待 直到 回复 当前 同步 各 库 表 明 它 已 收 到 事务 
提交 记录 ， 并 刷新 到 磁盘 。 这 确保 事务 不 会 去 失 ， 除 非 主 库 和 各 库 遭 受 他 们 的 数据 库存 储 崩 
Ho 当 设置 为 remote_write ， 事 务 将 等 待 直到 当前 同步 各 库 的 答复 表明 它 已 经 收 到 事务 的 提 
交 记 录 ， 并 且 写 入 到 各 用 操作 系统 ， 但 是 数据 并 不 一 定 在 各 库 中 达到 稳定 存储 。 即使 
PostgreSQL 备 库 实例 崩溃 ， 但 并 非 各 库 遭 受 操作 系统 级 的 崩溃 ， 此 设置 足以 确保 数据 的 保 
存 。 


当 同 步 复 制 使 用 时 ， 通常 是 明智 的 ， 要 么 等 待 本 地 刷新 到 磁盘 和 WAL 记 录 的 复制 ， 要 人 么 允许 
异步 提交 事务 。 然 而 ， 该 设置 local 可 用 于 希望 等 待 本 地 刷新 到 磁盘 上 的 事务 ， 而 不 是 同步 
复制 。 如 果 不 设 置 Synchronous_standby_names ， 设置 on ， remote_write 和 local 提供 相同 
的 同步 级 别 : 事务 提交 只 能 等 待 本 地 刷新 到 磁 瘟 。 

该 参数 可 以 在 任何 时 候 被 改变 ;对 于 任何 事务 的 行为 是 由 该 设置 提交 生效 时 确定 的 。 因此 ， 它 
是 可 能 的 ， 并 且 有 用 的 ， 有 一 些 事务 同步 提交 ， 其 他 的 异步 提交 。 例如 ， 为 了 使 单一 多 语句 
事务 异步 提交 ， 缺 省 是 相反 的 ， 在 事务 中 发 出 SET LOCAL Synchronous_commit TO OFF To 


wal_sync_method ( enum ) 


用 来 向 磁盘 强制 更 新 WAL 数 据 的 方法 。 如 果 fsync 是 关闭 的 ， 那么 这 个 设置 就 没有 意义 ， 
为 所 有 WAL 文 件 更 新 都 不 会 强制 输出 。 可 能 的 值 是 : 


e open_datasync (用 带 o_psyNC 选项 的 open() 打开 WAL 文 件 ) 


e fdatasync (每 次 提交 的 时 候 都 调用 fdatasync() ) 


。 fsync (每 次 提交 的 时 候 都 调用 fsync() ) 
e fsync writethrough (每 次 提交 的 时 候 调 用 fsync() 强制 写 出 任何 磁盘 写 缓 冲 区 ) 
e open_sync (Hà? o_sync 选项 的 open() 写 WAL 文 件 ) 


如 果 可 用 的 话 ， 该 open_“* 选 项 也 使 用 o_pirect. 并 非 所 有 这 些 选择 在 所 有 平台 上 都 可 用 。 
默认 值 是 平台 支持 的 上 面 列 表 中 的 第 一 个 方法 ， 除了 fdatasync 在 Linux 上 是 缺 省 的 。 缺 省 的 
也 不 一 定理 想 ; 为 了 创建 安全 配置 或 达到 最 佳 性 能 ， 可 能 要 改变 这 个 设置 或 你 的 系统 配置 的 其 
他 方面 ， 将 在 Section 29.1 中 讨论 。 这 个 参数 只 能 在 postgresql.conf 文件 或 服务 器 命令 行 上 
设置 。 


full_page_ writes ( boolean ) 


打开 这 个 选项 的 时 候 ，PostgreSQL 服 务 器 在 检查 点 之 后 对 页 面 的 第 一 次 写 入 时 将 整个 页 面 写 
到 WAL 里 面 。 这 人 么 做 是 因为 在 操作 系统 崩溃 过 程 中 可 能 只 有 部 分 页 面 写 入 磁 瘟 ， 从 而 导致 
在 同一 个 页 面 中 包含 新 旧 数 据 的 混合 。 在 崩溃 后 的 恢复 期 间 ， 由 于 在 WAL 里 面 存储 的 行 变 化 
信息 不 够 完整 ， 因 此 无 法 完全 恢复 该 页 。 把 完整 的 页 面 影像 保存 下 来 就 可 以 保证 正确 存储 页 
面 ， 代价 是 增加 了 写 入 WAL 的 数据 量 。 因 为 WAL 重 放 总 是 从 一 个 检查 点 开始 的 ， 所 以 在 检查 
点 后 每 个 页 面 第 一 次 改变 的 时 候 做 WAL 各 份 就 足够 了 。 因此 ， 一 个 减 小 全 页 面 写 开销 的 方法 
是 增加 检查 点 的 间隔 参数 值 。 


把 这 个 选项 关闭 会 加 快 正常 操作 的 速度 ， 但 是 可 能 导致 系统 骨 溃 后 不 可 恢复 的 数据 损坏 或 者 
无 记载 数据 损坏 ， 它 的 危害 类 似 于 fsync ， 只 是 比较 小 而 已 。 并 且 在 建议 参数 相同 的 情况 下 
关闭 这 个 选项 。 

关闭 这 个 选项 并 不 影响 即时 恢复 (PITR) 的 WAL 使 用 (参阅 Section 24.3) 

这 个 选项 只 能 在 postgresql.conf 文件 里 或 者 服务 器 命 合 行 设置 。 缺 省 是 on. 

wal_buffers ( integer ) 

使 用 已 经 写 和 人 磁盘 的 WAL 数 据 共享 内 存 的 数量 。-1 的 默认 设置 选择 大 小 等 于 shared_buffers 
的 1/132nd( 大 约 3%)， 但 不 小 于 64ke 也 不 超过 一 个 WAL 段 大 小 ， 通常 16MB 。 如 果 自 动 选择 
过 大 或 过 小 ， 则 可 以 手动 设置 这 个 值 。 但 任何 小 于 32ke WEHIY 当 作 32k 义理 。 这 个 参 
数 只 能 在 服务 器 启动 时 设置 。 

WAL 缓 冲 区 的 内 容 每 次 事务 提交 时 写 和 人 到 磁盘 ， 这 样 非常 大 的 值 不 可 能 提供 显著 的 好 处 。 但 
是 ， 当 有 许多 客户 端 都 同时 提交 时 ， 设 置 该 值 至 少 为 几 兆 可 以 提高 繁忙 服务 器 的 写 人 性 能 ， 
在 多 数 情况 下 ， 由 -1 的 缺 省 设置 选择 自动 调整 应 给 予 合 理 的 结果 。 


wal_writer_delay ( integer ) 


声明 WAL 写 入 进程 的 活动 轮回 的 延迟 。 在 每 一 轮回 中 写 入 进程 将 刷新 WAL 到 磁 意 。 AA, C 
会 休眠 wal_writer_delay 毫秒 ， 并 重复 。 默认 值 是 200 毫 秒 ( 200ms )。 注 意 ， 在 许多 系统 
上 ， 睡眠 延迟 的 有 效 分 状 率 为 10 上 毫秒 ; 把 wal_writer_delay 的 值 设置 为 一 个 不 是 10 的 倍数 的 


数值 与 设置 为 下 一 个 10 的 倍数 是 一 样 的 效果 。 这 个 参数 只 能 在 postgresql.conf 文件 或 服务 

器 命令 行 上 设置 。 

commit_delay ( integer ) 

commit_delay 增加 了 时 间 延 迟 ， 在 WAL 刷 新 启动 之 前 ， 以 微 秒 测量 。 这 可 以 提高 通过 单一 

WAL 刷 新 提交 大 量 事务 的 组 提交 吞吐 量 。 如 果 系 统 负载 足够 高 ， 人 额外 事务 在 给 定时 间 间 隔 内 
成 为 提交 。 然而 ， 它 也 增加 了 每 个 WAL 刷 新 的 最 多 commit_delay 微 秒 的 延迟 时 间 。 但 是 如 

果 没 有 其 它 事务 准 各 提交 ， 那么 这 个 间隔 就 是 在 浪费 时 间 。 如 果 至 少 commit_siblings 个 其 它 
事务 是 活路 的， 当 刷 新 初始 化 的 情况 下 。 则 仅仅 只 执行 一 个 延迟 。 如 果 禁 用 fsync ， 则 不 执 
行 任何 延迟 。 缺 省 commit_delay ES 〈 无 延迟 ) 。 只 有 超级 用 户 可 以 更 改 此 设置 。 


在 PostgreSQL 先 于 9.3 发 布 的 版 本 中 ， ”commit_delay 表现 不 同 ， 更 别 说 效能 : 它 仅 影响 提 
交 ， 而 不 是 所 有 的 WAL 刷 新 ， 即使 WAL 刷 新 尽早 完成 了 ， 也 要 等 待 整个 配置 延迟 。 在 
PostgreSQL9.3 开 始 ， 第 一 个 过 程 准 各 刷新 等 待 配置 延迟 ， 而 随后 的 过 程 仅 仅 等 待 直 到 完成 
刷新 操作 。 


commit_siblings ( integer ) 


在 执行 commit_delay 延迟 的 时 候 ， 要 求 最 少 同时 打开 的 并 发 事务 数目 。 大 一 些 的 数值 会 导致 
在 延迟 期 间 另 外 一 个 事务 准备 好 提交 的 可 能 性 增 大 。 MAES 


18.5.2. 检查 点 


checkpoint_segments ( integer ) 


在 自动 的 WAL 检 查 点 之 间 的 日 志文 件 段 的 最 大 数量 (通常 每 个 段 16 兆 字 节 )。 缺 省 是 3。 增 加 这 
个 参数 可 以 增加 骨 溃 恢复 所 需要 的 时 间 量 。 这 个 选项 只 能 在 postgresql.conf 文件 里 或 者 服务 
器 命令 行 中 设置 。 

checkpoint_timeout ( integer ) 


在 自动 WAL 检 查 点 之 间 的 最 长 时 间 ， 以 秒 计 。 缺 省 是 5 分 钟 ( smin )。 增加 这 个 参数 可 以 增加 
崩溃 恢复 所 需要 的 时 间 量 。 这 个 选项 只 能 在 postgresql.conf 文件 或 者 服务 器 命令 行 中 设置 。 


checkpoint_completion_target ( floating point ) 


声明 检查 点 完成 的 目标 ， 作 为 检查 点 之 间 总 时 间 的 分 数 。 缺 省 是 0.5。 这 个 参数 只 能 
在 postgresql.conf 文件 中 或 者 服务 器 命令 行 中 设置 。 


checkpoint_warning ( integer ) 


如 果 由 于 填充 检查 点 段 文 件 导 致 的 检查 点 发 生 时 间 间 陋 接近 这 个 参数 表示 的 秒 数 ， 那么 就 向 
服务 器 日 志 发 送 一 个 建议 增加 checkpoint_segments 值 的 消息 。 缺 省 是 30 秒 ( ses )。 需 则 关闭 


警告 。 如 果 checkpoint_timeout 小 于 checkpoint_warning ， 则 不 产生 警告 。 这 个 选项 只 能 


在 postgresql.conf 文件 里 或 者 服务 器 命令 行 中 设置 。 


18.5.3. 归档 


archive_mode ( boolean ) 


= H archive mode 的 时 候 ， 已 完成 的 WAL 段 通过 设置 archive_command 发 送 到 为 档 存 
žo archive_mode 和 archive_command 是 独立 变量 ， 以 致 于 archive_command 不 留 当 档 模式 
而 被 改变 。 这 个 参数 只 能 在 服务 器 启动 时 设置 。 当 wal_level 设置 为 minimal 时 ， 则 不 启 


用 archive_mode o 


archive_command ( string ) 


将 一 个 完整 的 WAL 文 件 序列 为 档 的 shell 命 售 。 字符 串 中 任何 %p 都 被 要 为 档 的 文件 的 绝对 路 
ENS, 而 任何 xf 都 只 被 该 文件 名 代 蔡 ( 非 绝 对 路 径 都 相对 于 集群 的 数据 目录 )。 如 果 你 需 
要 在 命令 里 嵌入 % 字符 就 必须 双 写 %% 。 有 一 点 很 重要 : 这 个 命 命 必须 是 当 且 仅 当 成 功 的 时 
(RF REIS. 参阅 Section 24.3.1 获 取 更 多 的 信息 。 


这 个 参数 只 能 在 postgresql.conf 文件 或 服务 器 命令 行 上 。 除非 在 服务 器 启动 时 开 

É archive_mode ， 否 则 忽略 它 。 如 果 archive_command 是 一 个 空 字符 串 (RA) 而 
archive_mode 已 启用 ， a5 at AWAL t, 但 是 服务 器 仍 继续 堆积 WAL 段 文件 期 望 迅速 提供 
一 个 命令 。 设置 archive_command 命令 什么 也 不 做 但 返回 true /bin/true (Windows 上 

的 rem )， 有 效 地 茶 用 兴 档 ， 但 也 为 了 兴 档 恢复 打破 了 所 需 WAL 文 件 链 ， 所 以 应 该 只 在 特殊 
情况 下 使 用 。 


archive_timeout ( integer ) 


archive_command 仅 在 已 完成 的 WAL 段 上 调用 。 因此 ， 如 果 服 务 器 只 产生 很 少 的 WAL 流 量 

(或 产生 流量 的 周期 很 长 )， 那么 在 完成 事务 以 及 安全 为 档 存 储 之 间 料 有 一 个 很 长 的 延 时 。 为 
了 限制 未 为 档 数 据 的 逗留 时 间 ， 你 可 以 强制 服务 器 以 archive_timeout 指定 的 秒 数 为 周期 切换 
到 新 的 WAL 段 文件 。 当 这 个 参数 大 于 需 时 ， 服 务 器 将 切换 到 新 的 段 文件 ， 无 论 从 剩余 段 文件 
切换 过 去 多 少 秒 ， 并 且 有 任何 的 数据 库 活动 ， 包 含 一 个 单独 的 检查 点 ( 增 

加 checkpoint_timeout 将 减少 空闲 系统 上 不 必要 的 检查 ) 。 注意 ， 由 于 强制 切换 而 提早 关闭 
的 为 档 文件 仍然 与 完整 的 轨 档 文件 长 度 相 同 。 因此 ， 将 archive_timeout 一 设 为 很 小 的 值 是 
不 明智 的 ， 它 将 导致 占用 巨大 的 汶 档 存储 空间 。 将 archive_timeout 设置 为 60 秒 左右 是 比较 

合理 的 。 如 果 你 想 要 拷贝 主 服 务 器 数据 更 加 快速 ， 你 应 该 考虑 使 用 流 复制 ， 而 不 是 为 档 。 这 
个 选项 只 能 在 postgresql.conf 文件 或 者 服务 器 命令 行 里 设置 。 


18.6. 复制 


这 些 设 置 控制 流 复 制 特 性 (参见 Section 25.2.5), 服务 器 将 是 任何 一 个 主 或 各 用 服务 器 。 主 服 
务 器 可 以 发 送 数据 ， 而 备用 (s) 总 是 拷贝 数据 的 接收 器 。 当 使 用 级 联 复制 时 (参见 Section 
25.2.6), 备用 服务 器 (s) 也 可 以 是 发 送 者 ， 也 可 以 是 接收 器 。 参数 主要 用 于 发 送 和 备用 服务 
器 ， 虽 然 有 些 参数 仅 在 主 服务 器 上 。 如 果 是 必需 的 ， 那 么 通过 集群 设置 可 能 会 有 所 不 同 。 


6.1. 发 送 服务 器 


这 些 参数 可 以 在 发 送 复制 的 数据 给 一 个 或 多 个 备用 服务 器 的 任何 服务 器 上 进行 设置 。 主 服务 
器 总 是 发 送 服务 器 ， 所 以 这 些 参数 必须 总 是 在 主 服务 器 上 设置 。 备用 成 为 主 之 后 这 些 参数 的 
作用 和 意义 不 会 改变 。 


max_wal_senders ( integer ) 


指定 来 自 各 用 服务 器 或 流 基 础 各 份 客户 端的 并 发 连接 的 最 大 数目 〈 即 同时 运行 WAL 发 送 者 进 
程 的 最 大 数目 ) 。 默认 值 是 需 ， 这 意味 着 禁用 复制 。 WAL 发 送 者 进程 计算 连接 总 数 ， 因此 
参数 不 能 高 于 max_connections。 这 个 参数 只 能 在 服务 器 启动 时 设置 。 wal_level 必须 设置 
为 archive 或 者 hot_standby 人 允许 来 自 各 用 服务 器 的 连接 。 


wal_keep_segments ( integer ) 


指定 在 pg_xlog 目录 下 的 以 往日 志文 件 段 的 最 小 数量 ， 如 果 各 用 服务 器 为 了 流 复制 需要 获取 
它们 。 那么 每 个 段 通常 是 16 兆 字 节 。 如 果 备 用 服务 器 连接 到 发 送 服务 器 落后 

于 wal_keep_segments EX, 那么 发 送 服务 器 可 能 会 删除 WAL 段 仍 需要 待机 状态 ， 在 这 种 情况 
T, 复制 连接 将 被 终止 。 下 游 连接 也 将 最 终 失 败 ， 因 为 其 结果 。 (但 是 ， 备 用 服务 器 可 以 从 
为 档 文件 污 取 的 段 进 行 恢复 ， 如 果 WAL 为 档 在 使 用 中 。) 

设置 保留 在 pg_xlog 中 的 段 最 小 数量 ; 该 系统 可 能 需要 为 WAL 为 档 或 从 检查 点 恢复 保留 更 多 
段 。 如 果 wal_keep_segments 为 0 (默认 ) , 系统 不 保留 备用 目的 的 任何 额外 段 ， 所 以 提供 给 
备用 服务 器 的 旧 WAL 段 数 是 以 前 检查 点 定位 范 数 和 WAL 为 档 状 态 信息 。 这 个 参数 只 能 

在 postgresql.conf 文件 或 服务 器 命令 行 上 设置 。 


wal_sender_timeout ( integer ) 


终止 比 指定 毫秒 数 闲置 更 长 时 间 的 复制 连接 。 这 对 于 发 送 服务 器 检测 待机 死机 或 网 络 中 断 是 
很 有 帮助 的 。 雳 值 将 禁用 超时 机 制 。 此 参数 只 能 在 postgresql.conf 文件 或 服务 器 命令 行 上 
设置 。 默认 值 是 60 秒 。 


18.6.2. 主 服务 器 


这 些 参 数 可 以 在 主 / 首 要 的 服务 器 上 设置 ， 它 将 复制 的 数据 发 送 给 一 个 或 多 个 备用 服务 器 。 需 
要 注意 的 是 ， 除 了 这 些 参数 ，wal_level 必 须 在 主 服务 器 上 适当 地 设 定 ， 并 且 启 用 任 选 的 WAL 
归档 (参见 Section 18.5.3) 。 各 用 服务 器 上 这 些 参数 值 是 不 相关 的 ， 虽 然 你 可 能 希望 设置 它 
们 ， 为 了 各 用 的 成 为 主 服务 器 可 能 性 做 准备 。 


synchronous_standby_names ( string ) 


指定 用 至 号 分 隔 的 备用 名 称 列表 ， 可 以 支持 同步 复制 ， 如 Section 25.2.7 描 述 的 。 任何 一 个 
时 间 将 至 多 有 一 个 活跃 同步 各 用 ; 这 个 各 用 服务 器 确认 收 到 他 们 的 数据 后 ， 等 待 提交 事务 将 被 
允许 进行 。 同步 待机 是 此 列表 中 第 一 个 各 用 。 列 表 是 当前 连接 和 实时 数据 流 〈 如 通过 
pg_stat_replication 视图 中 的 streaming 状态 显示 ) 。 之 后 出 现在 此 列表 中 的 其 它 各 用 服务 
器 带 来 潜在 的 同步 各 用 。 如 果 无 论 出 于 何 种 原因 当前 同步 待机 断 开 ， 那 么 它 会 立即 被 下 一 个 
最 高 优先 级 的 替换 。 指定 多 个 各 用 名 可 以 有 非常 高 的 可 用 性 。 


备用 服务 器 用 于 此 目的 的 名 称 是 各 用 application name 的 设 定 ， 正如 各 用 walreceiver 

中 primary_conninfo 的 设置 。 没有 任何 机 制 来 保证 唯一 性 。 重 复 匹 配备 用 记录 中 的 一 个 的 情 
况 下 将 被 选 作 同 步 待 机 ， 虽然 哪 一 个 是 不 确定 的 。 特殊 项 * 匹配 任何 的 

application_name , 包括 walreceiver 的 默认 应 用 程序 名 称 。 


如 果 没 有 在 这 里 指定 同步 备用 名 ， 那 么 不 启用 同步 复制 并 且 事 务 提交 将 不 会 等 待 复制 。 这 是 
默认 配置 。 即使 当 已 经 启用 同步 复制 ， 个 别 事务 可 以 配置 而 不 等 待 复制 ， 它 通过 设置 
synchronous_commit 参 数 到 local 或 者 off 。 


这 个 参数 只 能 在 postgresql.conf 文件 或 者 服务 器 命令 行 设 置 。 
vacuum_defer_cleanup_age ( integer ) 


指定 由 vacuum 和 HOT 更 新 的 事务 数 将 延迟 死 行 版 本 的 清理 。 该 默认 值 是 雳 事务 ， 这 意味 着 
死 行 版 本 可 以 尽快 出 除 ， 也 就 是 说 ， 只 要 他 们 不 再 可 见于 任何 打开 的 事务 。 你 不 妨 将 它 设置 
为 一 个 支持 双 机 热 各 的 主 服务 器 上 的 非 需 值 ， 正如 Section 25.5 所 描述 的 。 这 需要 更 多 的 时 
间 完 成 待机 状态 的 查询 ， 由 于 行 早期 清除 而 不 会 产生 冲突 。 然而 ， 因 为 该 值 是 依据 发 生 在 主 
服务 器 上 的 写 入 事务 数量 进行 计算 ， 它 是 很 难 预 测 到 底 有 多 少 额 外 的 宽 限时 间 将 提供 给 各 用 
查询 。 这 个 参数 只 能 在 postgresql.conf 文件 或 服务 器 命令 行 上 设置 。 

你 也 应 该 考虑 在 各 用 服务 器 (s) 设 置 hot_standby_feedback , 作为 使 用 该 参数 的 另外 一 种 选 


择 。 


18.6.3. 备用 服务 大 


这 些 设 置 控制 各 用 服务 器 的 行为 以 接收 复制 数据 。 在 主 服务 器 上 的 值 是 不 相关 的 。 
hot_standby ( boolean ) 


指定 恢复 期 间 是 否 可 以 连接 并 运行 查询 ， 如 在 Section 25.5 中 所 描述 的 。 默认 值 是 off 。 这 
个 参数 只 能 在 服务 器 启动 时 设置 。 它 在 存档 恢复 或 多 于 待机 模式 时 见效 。 


max_standby_archive_delay ( integer ) 


当 热 备 是 活路 时， 这 个 参数 决定 取消 与 应 用 的 WAL 项 冲突 的 各 用 查询 之 前 ， 各 用 服务 器 应 等 
待 多 久 。 如 Section 25.5.2 所 描述 的 。 max_standby_archive_delay 适用 于 WAL 数 据 从 WAL Ja 
档 读 取 (因此 不 是 现在 ) 。 默认 值 是 30 秒 。 如 果 不 指 定 ， 则 单位 是 毫秒 。 值 为 -1 允许 待机 永 
远 等 待 完 成 查询 冲突 。 这 个 参数 只 能 在 postgresql.conf 文件 或 服务 器 命令 行 上 设置 。 


注意 ， max_standby_archive_delay 和 运行 查询 取消 之 前 的 时 间 最 大 长 度 不 一 样 ; 而 是 可 以 申 
请 任何 一 个 WAL 段 数据 的 最 大 总 时 间 。 因此 ， 如 果 一 个 查询 导致 WAL 段 中 早期 显著 延迟 ， 随 
后 的 冲突 查询 将 有 少 得 多 的 时 间 。 


max_standby_streaming_delay ( integer ) 


当 热 各 是 活跃 时， 这 个 参数 决定 取消 与 应 用 的 WAL 项 冲突 的 各 用 查询 之 前 ， 各 用 服务 器 应 等 
待 多 久 。 如 Section 25.5.2 所 描述 的 。 max_standby_streaming_delay 适用 于 WAL 数 据 从 流 
制 接收 到 。 默认 值 是 30 秒 。 如 果 不 指定 ， 则 单位 是 毫秒 。 值 为 -1 人 允许 待机 永远 等 待 完 成 查询 
冲突 。 这 个 参数 只 能 在 postgresql.conf 文件 或 服务 器 命令 行 上 设置 。 


注意 ， max_standby_streaming_delay 和 运行 查询 取消 之 前 的 时 间 最 大 长 度 不 一 样 ; 一 旦 已 经 从 
主 服务 器 接收 ， 则 是 可 以 申请 任何 一 个 WAL 段 数据 的 最 大 总 时 间 。 因此 ， 如 果 一 个 查询 导致 
PAER, 随后 的 冲突 查询 将 有 少 得 多 的 时 间 直 到 备用 服务 器 再 次 追赶 上 。 


wal_receiver_status_interval ( integer ) 


指定 WAL 接 收 的 最 小 频率 ， 处 理 各 库 上 发 送 有 关 复制 进程 信息 到 主 或 上 游 待机 状态 ， 在 那里 
可 以 使 用 可 见 的 pg_stat_replication 视图 。 待机 会 报告 它 已 写 信 的 最 后 一 个 事务 日 志 的 位 
E, 最 后 一 个 位 置 已 经 刷新 到 磁盘 中 ， 并 已 申请 最 后 位 置 。 此 参数 值 的 最 大 时 间 间 隔 ， 以 秒 
为 单位 。 更 新 每 次 写 或 刷新 的 位 置 变 化 ， 或 者 至 少 往往 由 这 个 参数 所 指定 。 因 此， 应 用 位 置 
可 能 稍微 落后 于 真实 的 位 置 。 此 参数 设置 为 雳 完全 茶 用 状态 更 新 。 这 个 参数 只 能 在 
postgresql.conf 文件 或 服务 器 命令 行 上 设置 。 默 认 值 是 10 秒 。 

hot_standby_feedback ( boolean ) 

指定 热 各 是 否 将 发 送 反馈 到 主 或 有 关 查 询 当前 正在 各 机 上 执行 的 上 游 各 机 。 此 参数 可 以 AF 
消除 查询 取消 引起 清除 的 记录 ， 但 可 能 会 导致 主机 某 些 工作 负载 的 数据 库 膨胀 。 反馈 信息 将 
不 会 被 更 频繁 地 发 送 超过 一 次 wal_receiver_status_interval o MAHE 关闭 的 。 这 个 参数 只 
能 在 设置 postgresql.conf 文件 或 服务 器 命令 行 上 。 


如 果 级 联 复 制 是 使 用 中 的 反馈 通过 上 游 直 到 它 最 终 到 达 主 机 。 备 用 不 作 任 何其 他 用 途 反馈 他 
们 收 到 以 外 的 其 他 上 游 传递 。 


wal_receiver_timeout ( integer ) 


终止 比 指定 毫秒 数 闲置 更 长 时 间 的 复制 连接 。 这 对 于 发 送 服务 器 检测 待机 死机 或 网 络 中 断 是 
很 有 帮助 的 。 雳 值 将 禁用 超时 机 制 。 此 参数 只 能 在 postgresql.conf 文件 或 服务 器 命令 行 上 
设置 。 默认 值 是 60 秒 。 
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18.6. 复制 625 


18.7. 查询 规划 


18.7.1. 规划 器 方法 配置 


这 些 配置 参数 提供 了 影响 查询 优化 器 选择 查询 规划 的 原始 方法 。 如 果 优 化 器 为 特定 的 查询 选 
择 的 缺 省 规划 并 不 是 最 优 ， 那么 我 们 就 可 以 通过 使 用 这 些 配置 参数 强制 优化 器 选择 一 个 不 同 
的 规划 来 临时 解决 这 个 问题 。 更 好 的 改善 优化 器 选择 规划 的 方法 包括 调节 规划 器 开销 常量 、 
手动 运行 ANALYZE、 增 大 配置 参数 default _statistics_target 的 值 、 使 

用 ALTER TABLE SET STATISTICS 为 某 个 字段 增加 收集 的 统计 信息 。 


enable_bitmapscan ( boolean ) 

打开 或 者 关闭 规划 器 对 位 图 扫描 规划 类 型 的 使 用 。 缺 省 是 on 。 
enable_hashagg ( boolean ) 

打开 或 者 关闭 规划 器 对 Hash 聚 集 规划 类 型 的 使 用 。 缺 省 是 on 。 
enable_hashjoin ( boolean ) 

打开 或 者 关闭 规划 器 对 Hash 连 接 规划 类 型 的 使 用 。 缺 省 是 on 。 
enable_indexscan ( boolean ) 
打开 或 者 关闭 规划 器 对 索引 扫描 规划 类 型 的 使 用 。 缺 省 是 on 。 
enable_indexonlyscan ( boolean ) 
打开 或 关闭 规划 器 对 唯一 索引 扫描 规划 类 型 的 使 用 。 缺 省 是 on 。 
enable_material ( boolean ) 


打开 或 关闭 查询 规划 器 使 用 物化 。 不 可 能 完全 抑制 物化 ， 但 是 关闭 这 个 变量 会 阻止 规划 器 插 
和 物化 节点 ， 除 非 它 是 必需 正确 的 情况 。 默认 值 是 on o 


enable_mergejoin ( boolean ) 
打开 或 者 关闭 规划 器 对 融合 连接 规划 类 型 的 使 用 。 缺 省 是 on 。 
enable_nestloop ( boolean ) 


FTF MAK A] HLS a et RE HE A, 我 们 不 可 能 完全 消除 谋 套 循环 连接 ， 
但 是 把 这 个 变量 关闭 就 会 让 规划 器 在 存在 其 它 方法 的 时 候 优先 选择 其 它 方法 。 缺 省 是 on 。 


enable_seqscan ( boolean ) 


打开 或 者 关闭 规划 器 对 顺序 扫描 规划 类 型 的 使 用 。 我 们 不 可 能 完全 消除 顺序 扫描 ， 但 是 把 这 
个 变量 关闭 会 让 规划 器 在 存在 其 它 方法 的 时 候 优 先 选择 其 它 方法 。 缺 省 是 on 。 


enable_sort ( boolean ) 


打开 或 者 关闭 规划 器 使 用 明确 的 排序 步 又。 我 们 不 可 能 完全 消除 明确 的 排序 ， 但 是 把 这 个 变 
量 关 闭 可 以 让 规划 器 在 存在 其 它 方法 的 时 候 优先 选择 其 它 方法 。 缺 省 是 on 。 


enable_tidscan ( boolean ) 


打开 或 者 关闭 规划 器 对 TID 扫 描 规划 类 型 的 使 用 。 缺 省 是 on o 


18.7.2. 规划 器 开销 常量 


本 节 中 描述 的 开销 可 以 按照 任意 标准 度量 。 我 们 只 关心 其 相对 值 ， 因此 以 相同 的 系数 缩放 它 
们 将 不 会 对 规划 器 产生 任何 影响 。 传 统 上 ， 它们 以 抓 取 顺序 页 的 开销 作为 基准 单位 。 也 就 是 
说 将 seq_page_cost 设 为 1.0 ， 同时 其 它 开销 参数 对 照 它 来 设置 。 当 然 你 也 可 以 使 用 其 它 基 
准 ， 比如 以 毫秒 计 的 实际 执行 时 间 。 























Note: 糟糕 的 是 ， 现 在 还 没有 定义 得 很 合理 的 方法 来 判断 下 面 出 现 的 "开销 "变量 族 的 理想 
数值 。 它们 最 好 按照 某 个 特定 安装 的 平均 查询 开销 来 衡量 。 这 意味 着 仅仅 根据 很 少量 的 
试验 结果 来 修改 它们 是 很 危险 的 。 








seq_page_cost ( floating point ) 


Het 


设置 规划 器 计算 一 次 顺序 磁盘 页 面 抓 取 的 开销 。 默 认 值 是 1.0。 这 个 值 可 以 通过 设置 同名 表 
间 参 数 表 的 特定 表 和 索引 覆盖 。 (参阅 ALTER TABLESPACE) 


random_page_cost ( floating point ) 


设置 规划 器 计算 一 次 非 顺序 磁盘 页 面 抓 取 的 开销 。 默 认 值 是 4.0。 这 个 值 可 以 通过 设置 同名 表 
空间 参数 表 的 特定 表 和 索引 履 盖 。 (参阅 ALTER TABLESPACE) 。 


(相对 于 seq_page_cost ) 减 少 这 个 值 业 导致 更 倾向 于 使 用 索引 扫描 ， 而 增加 这 个 值 将 导致 更 倾 
向 于 使 用 顺序 打 描 。 可 以 通过 同时 增加 或 减少 这 两 个 值 来 调整 磁盘 MO 相对 于 CPU 的 开销 (在 
下 面 的 参数 中 描述 )。 


机 械 磁 盘存 储 的 随机 访问 比 4 次 顺序 访问 往往 更 加 昂贵 。 然 而 ， 下 面 使 用 缺 省 (4.0), 因为 
大 多 数 随机 访问 磁盘 ， 比 如 索引 读 取 是 在 缓存 中 。 默认 值 可 以 作为 模拟 随机 存 取 比 顺序 存 取 
慢 40 倍 ， 而 预计 90% 随 机 读 取 到 缓存 中 。 


如 果 您 认为 90% 的 缓存 率 是 你 的 工作 量 的 错误 假设 ， 你 可 以 增加 random_page _cost 更 好 地 

反映 随机 存储 读 取 的 真实 成 本 。 相 应 地 ， 如 果 你 的 数据 很 可 能 完全 在 高 速 缓存 中 ， 如 当 数据 
库 比 总 的 服务 器 内 存 较 小 的 时 候 ， 可 以 适当 减少 random_page_cost。 存 储 具 有 相对 顺序 的 低 
随机 读 取 成 本 ， 例如 固态 硬盘 ， 可 能 还 可 以 更 好 地 与 random_page_cost 的 低 值 建 模 。 





Tip: 虽然 允许 你 将 random_page_cost 设置 的 比 seq_page_cost 小 ， 但 是 物理 上 的 实际 情 
况 并 不 受 此 影响 。 然 而 当 所 有 数据 库 都 位 于 内 存 中 时 ， 两 者 设置 为 相等 是 非常 合理 的 ， 
因为 在 此 情况 下 ， 乱 序 抓 取 并 不 比 顺 序 抓 取 开 销 更 大 。 同 样 ， 在 缓冲 率 很 高 的 数据 库 

上 ， 你 应 当 相 对 于 CPU 开销 同时 降低 这 两 个 值 ， 因为 获取 内 存 中 的 页 比 通 常情 况 下 的 开 
销 小 许多 。 

















cpu_tuple_cost ( floating point ) 

设置 规划 器 计算 在 一 次 查询 中 处 理 一 个 数据 行 的 开销 。 缺 省 是 0.01。 
cpu_index_tuple_cost ( floating point ) 

设置 规划 器 计算 在 一 次 索引 扫描 中 人 处理 每 条 索引 行 的 开销 。 缺 省 是 0.005。 
cpu_operator_cost ( floating point ) 

设置 规划 器 计算 在 一 次 查询 中 执行 一 个 操作 符 或 范 数 的 开销 。 缺 省 是 0.0025。 
effective_cache_size ( integer ) 


为 规划 器 设置 在 一 次 索引 扫描 中 可 用 的 磁 总 缓冲 区 的 有 效 大 小 。 这 个 参数 会 在 计算 一 个 索引 
的 预计 开销 值 的 时 候 加 以 考虑 。 更 高 的 数值 会 导致 更 可 能 使 用 索引 扫描 ， 更 低 的 数值 会 导致 
更 有 可 能 选择 顺序 扫描 。 在 设置 这 个 参数 的 时 候 ， 你 还 应 该 考虑 PostgreSQL 的 数据 文件 会 使 
用 的 共享 缓冲 区 和 内 核 的 磁盘 缓冲 区 。 另 外 ， 还 要 考虑 预计 会 使 用 不 同 索引 的 并 发 查询 数 
目 ， 因 为 它们 必须 共享 可 用 的 内 存 空 间 。 这 个 参数 对 PostgreSQL 分 配 的 共享 内 存 大 小 没有 影 
响 ， 它 也 不 会 使 用 内 核磁 盘 缓 冲 ， 它 只 用 于 估算 。 该 系统 还 并 未 假设 数据 仍 保留 在 查询 之 间 
AYR ARTE, RRM AE 128IKF $ ( 128MB )。 


18.7.3. BAA ig bas 


基因 查询 优化 (GEQO) 是 一 种 算法 ， 采 用 和 启发 式 搜索 查询 规划 。 这 样 可 以 为 复杂 查询 ( 链 
接着 很 多 关系 ) 减少 规划 时 间 ， 生产 规划 成 本 有 时 低 于 由 正常 穷 举 搜索 算法 发 现 的 那些 。 获 
取 更 多 信息 ， 请 参阅 Chapter 53。 


geqo ( boolean ) 


允许 或 禁止 基因 查询 优化 ， 这 是 缺 省 值 。 在 生产 中 最 好 不 要 关闭 它 。 geqo_threshold 变量 提 
供 了 GEQO 的 更 精细 方法 。 


geqo_threshold ( integer ) 

只 有 当 涉 及 的 FRoM 关系 数量 至 少 有 这 么 多 个 的 时 候 ， 才 使 用 基因 查询 优化 。 (请 注意 一 

个 FULL OUTER JOIN 构造 只 算 一 个 FRoM 项 ) 。 缺 省 是 12。 对 于 数量 小 于 此 值 的 查询 ， 也 许 使 
用 判定 性 的 穷 举 搜索 更 有 效 。 但 是 对 于 有 许多 表 的 查询 ， 规 划 器 做 判断 要 花 很 多 时 间 。 人 往往 
比 执行 一 个 次 优 规划 时 间 更 长 。 因此 ， 查 询 大 小 阀 值 是 管理 使 用 GEQO 的 简单 方法 。 


geqo_effort ( integer ) 


控制 GEQO 里 规划 时 间 和 查询 规划 的 有 效 性 之 间 的 平衡 。 这 个 变量 必须 是 一 个 范围 从 1 到 10 的 
整数 。 缺 省 值 是 5。 大 的 数值 增加 花 在 进行 查询 规划 上 面 的 时 间 ， 但 是 也 很 可 能 会 提高 选中 
更 有 效 的 查询 规划 的 几率 。 


geqo_effort 实际 上 并 没有 直接 干什么 事情 ; 只 是 用 于 计算 其 它 那些 影响 GEQO 行 为 变量 的 
缺 省 值 (在 下 面 描述 )。 如 果 你 愿意 ， 你 可 以 手工 设置 其 它 参 数 。 


geqo_pool_size ( integer ) 


控制 GEQO 使 用 的 池 大 小 。 池 大 小 是 基因 全 体 中 的 个 体 数量 。 它 必须 至 少 是 2， 并 且 有 用 的 数 
值 通常 在 100 和 1000 之 间 。 如 果 把 它 设置 为 需 ( 缺 省 )， 那么 就 会 基于 geqo_effort 和 查询 中 表 
的 数量 选取 一 个 合适 的 值 。 


geqo_generations ( integer ) 


控制 GEQO 使 用 的 子 代数 目 。 子 代 的 意思 是 算法 的 迭代 次 数 。 它 必须 至 少 是 1， 有 用 的 值 范围 
和 池 大 小 相同 。 如 果 设 置 为 需 ( 缺 省 )， 那 么 将 基于 geqo_pool_size 选取 合适 的 值 。 


geqo_selection_bias ( floating point ) 


控制 GEQO 使 用 的 选择 性 偏好 。 选 择 性 偏好 是 在 一 个 种 群 中 的 选择 性 压力 。 数 值 可 以 是 1.5 到 
2.0 之 间 ; 缺 省 是 2.0。 


geqo_seed ( floating point ) 


控制 随机 数 发 生 器 的 初始 值 ， 它 使 用 由 GEQO 通 过 连接 顺序 搜索 空间 来 选择 随机 路 径 。 该 值 
的 范围 可 以 从 雪 (默认 值 ) 到 一 。 各 种 不 同 的 值 改变 探索 连接 路 径 的 设置 ， 并 可 能 导致 发 现 
或 好 或 坏 的 最 佳 路 径 。 


18.7.4. 其 它 规划 器 选项 
default_statistics_target ( integer ) 


为 没有 用 ALTER TABLE SET STATISTICS 设置 字段 相关 目标 的 表 中 其 它 字 段 设 置 缺 省 统计 目标 。 
更 大 的 数值 增加 了 _ ANALYzE 所 需要 的 时 间 ， 但 是 可 能 会 改善 规划 器 的 估计 质量 。 缺 省 值 是 
100。 有 关 PostgreSQL 的 查询 规划 器 使 用 的 统计 的 更 多 信息 ， 请 参考 Section 14.2。 


constraint_exclusion ( enum ) 


控制 查询 规划 器 使 用 的 表 约 束 优 化 查询 。 constraint_exclusion 人 允许 的 值 是 on (检查 所 有 
RIAR), off (永远 不 检查 约束 ) ， 以 及 partition (检查 仅 用 于 继承 子 表 
和 UNION ALL 子 查询 的 约束 ) o partition 是 默认 设置 。 它 往往 使 用 继承 和 分 区 表 来 提高 性 


Ab 
BB o 


当 这 个 参数 为 特定 表 人 允许 时 ， 那 么 规划 器 用 查询 条 件 和 cec 约束 进行 比较 ， 并 且 在 查询 条 
件 和 约束 冲突 的 情况 下 ， 忽 略 对 表 的 扫描 。 比 如 : 

CREATE TABLE parent(key integer, ...); 

CREATE TABLE child1000(check (key between 1000 and 1999)) INHERITS(parent); 


CREATE TABLE child2000(check (key between 2000 and 2999)) INHERITS(parent); 


SELECT * FROM parent WHERE key = 2400; 


在 打开 约束 排除 的 时 候 ， 这 个 sELEcT 将 完全 不 会 扫描 childiooo 。 这 样 可 以 提高 性 能 。 


目前 ，constraint exclusion 默 认 启 用 ， 仅 适用 于 那些 通常 用 来 实现 表 分 区 情况 。 在 简单 查询 
中 为 所 有 表 强 加 额外 开销 计划 而 打开 它 是 很 明显 的 ， 并 且 经 常会 产生 不 受益 于 简单 查询 。 如 
果 你 没有 分 区 表 ， 您 可 能 更 愿意 将 其 完全 关闭 。 


参考 Section 5.9.4 获 取 有 关 使 用 约束 排除 和 分 区 的 更 多 信息 。 

cursor_tuple_fraction ( floating point ) 

设置 被 检索 的 游标 行 分 数 的 规划 器 估计 。 默认 值 是 0.1。 这 个 设置 较 小 的 值 偏好 规划 器 使 
用 "fast start" 规 划 游 标 ， 当 可 能 花费 很 长 时 间 读 取 所 有 行 时 ， 这 将 很 快 检索 出 前 几 行 RK 


的 值 把 更 多 的 重点 放 在 总 的 估计 时 间 上 。 1.0 的 最 大 设置 ， 规 划 游 标 类 似 于 定期 查询 ， RF 
虑 总 估计 时 间 ， 而 不 是 多 长 时 间 传递 第 一 行 。 


from_collapse_limit ( integer ) 
如 果 生 成 的 FRoM 列表 不 超过 这 个 限制 的 项 数 ， 规 划 器 将 把 子 查询 融合 到 上 层 查询 。 小 的 数 


值 降低 规划 的 时 间 ， 但 是 可 能 会 生成 差 些 的 查询 计划 。 缺 省 是 8。 更 多 信息 请 查看 Section 
14.3。 


设置 这 个 值 到 gedqo _ threshold 或 者 GEQO 规 划 器 触发 ， 导致 非 最 优 规划 。 参 阅 Section 
18.7.3, 


join_collapse_limit ( integer ) 


如 果 得 出 的 列表 不 超过 这 个 数目 的 项 ， 那么 规划 器 将 把 除 FULL Join 之 外 的 JoIN 构造 抹 平 
到 FRoM 列表 项 中 。 小 的 数值 降低 规划 的 时 间 ， 但 是 可 能 会 生成 差 些 的 查询 计划 。 


Aw, 这 个 值 和 from_collapse_ limit 相同 ， 这 样 适合 大 多 数 场合 。 把 它 设置 为 1 则 避免 任 
何 sorn 的 融合 ， 这 样 就 将 明确 使 用 语句 中 的 连接 顺序 。 查询 优化 器 并 不 是 总 能 选取 最 优 的 
连接 顺序 ; 高 级 用 户 可 以 选择 暂时 把 这 个 变量 设置 为 1， 然后 明确 地 声明 他 们 需要 的 连接 顺 
序 。 更 多 信息 参见 Section 14.3。 


设置 这 个 值 到 gedqo_ threshold 或 者 GEQO 规 划 器 触发 ， 导致 非 最 优 规划 。 参 阅 Section 
18:7 36 


18. 8. 错误 报告 和 日 志 IÒ 


18.8.1. 在 哪里 记录 日 志 


1og_destination ( string ) 


IE 包括 stderr csvlog 和 syslog。 在 Windows 里 ， 
元 和 oventlods 把 这 个 选项 设置 为 一 个 吾 号 分 隔 的 日 志 目 标的 列表 。 缺 省 是 只 记录 到 
stderr。 这 个 选项 只 能 在 postgresql.conf 文件 或 者 服务 器 命令 行 设置 。 


e a log_destination 中 ， 日 志 项 是 用 "至 号 分 隔 "(CSV) 格 式 的 输出 ， 这 便于 加 
载 日 志 到 程序 。 参 见 Section 18.8.4 获 取 更 多 详情 。 logging_collector 必 须 能 够 产生 CSV 格 式 
的 日 志 输 出 s 


Note: 在 大 多 数 Unix 系 统 上 ， 你 将 需要 改变 您 的 系统 syslog 守 护 进程 的 配置 ， 以 便 充 

利用 log_destination 的 syslog 选 项 。 PostgreSQL 可 以 通过 LocAL7 (参见 ines 
记录 Syslog 设 施 Locaco, 但 缺 省 大 多 数 平台 上 syslog 配 置 将 忽略 所 有 这 样 的 消息 。 你 
将 需要 添加 类 似 于 下 面 的 信息 : 


local0.* /var/log/postgresql 


到 syslog 守 护 程序 的 配置 文件 中 ， 使 其 工作 。 


在 Windows 上 ， 当 您 使 用 log_destination 的 eventlog 选项 ， 你 应 该 注册 一 个 事件 源 及 
其 操作 系统 作业 库 ， 使 Windows 事 件 查看 器 可 以 有 规则 的 显示 事件 日 志 信 息 。 参见 
Section 17.11 获 取 更 多 详细 信息 。 


logging_collector ( boolean ) 


这 个 参数 启动 日 志 收 集 ， 这 是 一 个 后 台 进 程 ， 抓 取 发 送 到 stderr 的 日 志 消息 ， 并 会 将 他 们 重 定 
向 到 日 志文 件 。 这 个 方法 通常 比 记 录 到 syslog 更 有 用 ， 因为 有 些 消息 类 型 可 能 不 会 出 现在 
syslog 输 出 中 (一 个 常见 的 例子 是 动态 连接 失败 的 消息 ; AE at 

如 archive_command 产生 的 错误 消息 。) 这 个 值 只 能 在 服务 器 启动 的 时 候 设 


Note: 不 使 用 日 志 收 集 器 可 以 登录 到 stderr; 无 论 服 务 器 的 stderr 被 定向 到 哪 ， 则 日 志 消 息 
就 定位 到 那里 。 然 而 ， 该 方法 是 只 适用 于 低 日 志 叙 ， 因 为 它 没有 提供 方便 的 方式 来 旋转 

Abas 另外 ， We 因 
为 多 个 进程 同时 写 入 同一 个 日 志文 件 可 能 覆盖 彼此 的 输出 。 











Note: 日 志 收 集 器 设计 永远 不 会 丢失 消息 。 这 意味 着 在 非常 高 的 负载 情况 下 ， 当 收 集 器 

已 经 落后 而 试图 发 送 额 外 的 日 志 消 息 的 时 人 息 ， 封 锁 服 务 器 进程 。 与 此 相反 ，syslog 更 喜 
欢 忽 略 消息 ， 如 果 它 无 法 写 信 ， 这 意味 着 它 可 能 无 法 记录 这 些 消息 ， 这 种 情况 下 ， 但 它 
不 会 阻止 该 系统 的 其 余部 分 。 


log_directory ( string ) 


在 打开 了 logging_collector 的 时 候 ， E E 录 里 创建 。 它 可 以 声明 
成 绝对 路 径 ， 或 者 是 与 集群 的 数据 目录 相对 的 路 径 。 这 个 选项 只 能 在 postgresql.conf 文件 里 
或 者 服务 器 命令 行 设 置 。 


log_filename ( string ) 


在 打开 了 logging_collector 的 时 候 ， 这 个 选项 设置 所 创建 的 日 志文 件 的 文件 名 。 这 个 数值 将 

被 当 作 strftime 模式 看 待 。 因 此 可 以 用 % 间 而 变 的 文件 名 。 CEs, MURA 

任何 时 区 相关 % 逃逸 ， 由 log timezone 声 明 的 时 区 进行 计算 。) 支持 的 % 逃逸 类 似 于 Open 

Group 上 的 strftime 规 范 列表 中 的 。 注意 ， 不 直接 使 用 这 个 系统 的 strftime， 所 以 特定 平台 
GEIE) 扩展 不 起 作用 。 


如 果 您 没有 逃逸 指定 文件 名 ， 你 应 该 计划 使 用 日 志 旋 转 程序 以 避免 最 终 填充 整个 磁盘 。 在 8.4 
之 前 的 版 本 中 ， 如 果 没 有 % 的 转 义 符 出 现 ， PostgreSQL 将 追加 新 日 志文 件 创建 时 间 的 时 间 
RB, 但 是 不 再 是 这 种 情况 了 。 


如 果 和 启用 log_destination 中 的 CSV 格 式 输出 ， .csv 将 追加 时 间 惟 日 志文 件 名 来 创建 CSV 格 
式 输出 的 文件 名 。 AR log filename 以 .1og WHER, BAKES). 在 上 面 的 例子 情况 
下 ， CSV 文 件 名 是 server_log.1093827753.csv o 


这 个 参数 只 能 在 postgresql.conf 文件 里 或 者 服务 器 命令 行 上 设置 。 
log_file_mode ( integer ) 


在 Unix 系 统 上 ， 当 logging collector 已 启用 时 (在 Microsoft Windows 上 将 忽略 此 参数 ) , 
此 参数 用 于 设置 日 志文 件 的 权限 。 该 参数 值 预期 为 通过 chmod 和 umask 系统 调用 接受 的 格式 
指定 的 数字 模式 。 (为 了 使 用 习惯 八进制 格式 的 数字 必须 以 o (zero) 开 始 ) 。 


默认 的 权限 ocoo ， 只 意味 着 ee 其 他 较 普通 有 用 的 设 
置 是 646 ， 让 拥有 者 组 成 员 来 读 取 文 件 。 但 是 请 注意 ， 为 了 充分 使 用 这 种 设置 ， 你 需要 改 
变 log_directory 到 集群 数据 目录 之 外 的 Pict mee, 仓 如 何 ， 使 日 志文 件 全 局 可 读 
是 不 明智 的 ， 因 为 它们 可 能 包含 敏感 数据 。 


这 个 参数 可 以 在 postgresql.conf 文件 或 者 服务 器 命令 行 上 设置 。 


log_rotation_age ( integer ) 


在 打开 了 logging_collector 的 时 候 ， 这 个 选项 设置 一 个 独立 日 志文 件 的 最 大 生存 期 。 在 数值 
指定 的 分 钟 过 去 之 后 ， 将 创建 一 个 新 的 日 志文 件 。 设 置 为 需 可 以 关闭 以 时 间 为 基础 的 新 日 志 
文件 的 创建 。 这 个 选项 只 能 在 postgresql.conf 文件 里 或 者 服务 器 命令 行 设置 。 


log_rotation_size ( integer ) 


在 打开 了 logging collector 的 时 候 ， 这 个 选项 设置 一 个 独立 的 日 志文 件 的 最 大 尺寸 。 在 数值 
指定 的 千 字 节 写 入 日 志文 件 之 后 ， 将 会 创建 一 个 新 的 日 志文 件 。 设置 为 需 可 以 关闭 以 尺寸 为 
基础 的 新 日 志文 件 的 创建 。 这 个 选项 项 只 月 能 在 postgresql.conf 文件 里 或 者 服务 器 命令 行 上 设 

置 。 


log_truncate_on_rotation ( boolean ) 


在 打开 了 logging_collector 的 时 候 ， 这 个 选项 将 导致 PostgreSQL 覆盖 而 不 是 附加 到 任何 同 

名 的 现 有 日 志文 件 上 。 不 过 ， 履 盖 只 是 发 生 在 基于 时 间 滚 动 而 创建 的 新 文件 上 ， 而 不 是 在 服 

务 器 启动 的 时 候 或 者 以 尺寸 为 基础 的 滚动 上 。 如 果 为 of ， 将 始终 向 已 存在 的 文件 结尾 追加 。 

比如 ， 使 用 这 个 选项 和 类 似 postgresql-%H.1log 这 样 的 log_filename 设置 将 导致 生成 24 个 按 

小 时 生成 的 日 志文 件 然后 在 这 些 文件 上 循环 。 这 个 选项 只 能 在 postgresql.conf 文件 里 或 者 在 
服务 器 启动 的 时 候 设 置 。 


例子 : : 保留 7 天 的 日 志 ， 每 天 一 个 日 志文 件 ， 叫做 server_log.Mon , server_log.Tue 等 等 ， 
并 且 上 周 的 日 志 会 自动 被 这 周 的 日 志和 覆盖 。 把 log_filename 设置 为 server_log.%a , 


把 log_truncate_on_rotation 设置 为 on ， 并 且 把 1log_rotation_age 设置 为 1440 o 
g g 


例子 : 保留 24 小 时 的 日 志 ， 每 小 时 一 个 日 志 ， 但 是 如 果 日 志文 件 尺 寸 大 于 1GB 也 旋转 日 


志 。 把 log_filename 设置 为 server_log.%H%M , log_truncate_on_rotation 设置 为 on ， 
log_rotation_age 设置 为 60 并 且 把 log_rotation_size 设置 为 1000000 o 

在 log_filename 里 包含 %M 人 允许 任何 尺寸 驱动 的 旋转 选取 一 个 和 开始 的 文件 名 同 小 时 数 但 是 
名 字 不 同 的 文件 。 


syslog_facility ( enum ) 


如 果 向 syslog 进 行 记录 ， 那 么 这 个 选项 判断 要 使 用 的 syslog" 设 施 "。 你 可 以 从 Localo , 
LOCAL1 , LOCAL2 , LOCAL3 , LOCAL4 , LOCALS , LOCAL6 , LOCAL7 中 选择 。 缺 省 是 LOCALO o 

又 见 你 的 系统 的 syslog 守 护 进程 文档 。 这 个 选项 只 能 在 postgresql.conf 文件 里 或 者 服务 器 局 
动 的 时 候 设 置 


syslog_ident ( string ) 


如 果 向 syslog 进 行 记 录 ， 这 个 选项 决定 用 于 在 syslog 日 志 中 标识 Gop dae ie 缺 省 
是 postgres 。 这 个 选项 只 能 在 postgresql.conf 文件 里 或 者 服务 器 启动 的 时 候 设 


event_source ( string ) 


4 g Aizxeventlogy, kee 确定 用 于 识别 PostgreSQL 消 息 日 志 的 程序 名 称 。 RA 
是 PostgreSQL 。 该 参数 只 能 在 postgresql.conf 文件 或 者 服务 器 命令 行 上 设置 


18.8.2. 什么 时 候 记 录 日 志 
client_min_messages ( enum ) 


这 个 选项 控制 哪些 信息 发 送 到 客户 端 。 有 效 的 数值 是 DEBUGS , DEBUG4 , DEBUG3 , DEBUG2 , 
DEBUG1 , LOG , NOTICE , WARNING , ERROR, FATAL ,和 PANIC, 每 个 级 别 包含 所 有 它 后 面 的 
级 别 ， 级 别 越 靠 后 ， 发 送 的 信息 越 少 。 缺 省 是 novice, 需要 注意 的 是 这 里 

的 Loc 和 log_min_messages 里 的 级 别 不 同 。 


log_min_messages ( enum ) 


控制 写 到 服务 器 日 志 里 的 信息 的 详细 程度 。 有 效 值 是 DEBUG5 , DEBUG4 , DEBUG3 , DEBUGZ , 
DEBUG1 ，INFO ，NOTICE , WARNING , ERROR, LOG, FATAL 和 PANIC. 每 个 级 别 都 包含 它 后 
面 的 级 别 。 越 靠 后 的 数值 发 往 服务 器 日 志 的 信息 越 少 。 缺 省 是 wARNING 。 需要 注意 的 是 这 里 
的 Loc 和 client_min_messages 里 的 级 别 不 同 。 只 有 超级 用 户 可 以 修改 这 个 设置 


log_min_error_statement ( enum ) 


控制 在 服务 器 日 志 里 输出 哪 一 条 导致 错误 条 件 的 SQL 语句 。 所 有 导致 一 个 特定 级 别 (或 者 更 高 
级 别 ) 错 误 的 SQL 语句 都 要 被 记录 。 有 效 的 值 有 DEBUG5 , DEBUG4 , DEBUG3 , DEBUG2 , 

DEBUG1 ， INFO ， NOTICE ，WARNING , ERROR, LOG, FATAL 和 PANIC. 缺 省 是 ERROR, 表示 
所 有 导致 错误 、 日 志 信息 ， 致 命 错 误 、 了 恐慌 的 SQL 语句 都 将 被 记录 。 设置 为 panic 表示 把 这 
个 特性 关闭 。 只 有 超级 用 户 可 以 改变 这 个 设置 


log_min_duration_statement ( integer ) 


如 果 某 个 语句 的 持续 时 间 大 于 或 者 等 于 这 个 毫秒 数 ， 那 么 在 日 志 行 上 记录 该 语句 及 其 持续 时 
间 。 设置 为 需 将 打印 所 有 查询 和 他 们 的 持续 时 间 。 设 置 为 -1( 缺 省 值 ) 关 闭 这 个 功能 。 上 比如 ， 

如 果 你 把 它 设 置 为 25oms ， 那 么 所 有 运行 时 间 等 于 或 者 超过 250ms 的 SQL 语句 都 会 被 记 

录 。 打开 这 个 选项 可 以 很 方便 地 跟踪 需要 优化 的 查询 。 只 有 超级 用 户 可 以 改变 这 个 设置 


对 于 使 用 扩展 查询 协议 的 客户 端 ， 语 法 分 析 、 邦 定 、 执 行 每 一 步 所 花 时 间 都 分 别 记 录 。 


Note: 当 此 选项 与 log_statement 同 时 使 用 时 ， 已 经 被 log statement 记录 的 语句 文本 不 
会 被 重复 记录 。 如 果 没 有 使 用 syslog 的 话 ， 推 荐 使 用 log_line_prefix 记 录 PID 或 会 话 ID， 
这 样 就 可 以 使 用 它们 将 语句 消息 连接 耗 时 消息 。 


























Table 18-1 解 释 了 PostgreSQL 使 用 的 信息 严重 程度 。 如 果 日 志 输 出 发 送 到 syslog 或 者 
Windows 的 eventlog， 则 严重 程度 如 下 表 所 示 。 


Table 18-1. 信息 严重 级 别 


严重 级 别 用 法 syslog eventlog 
DEBUG1. .DEBUG5 提供 开发 人 员 使 用 的 连续 更 多 详细 信息 DEBUG INFORMATION 


提供 用 户 隐 含 要 求 的 信息 ， 上 比如 


INFO a INFO INFORMATION 
在 vacuum VERBOSE 过 程 输出 的 信息 。 
But BT At gt FA 户 有 帮助 的 信 自 
NOTICE Ae l 筷 ， 比 如， NOTICE INFORMATION 
TNA b 
E/H 人 能 河 时 的 警 生 75 
WARNING 提供 可 能 问 mans As 比如 在 事务 块 范 NOTICE WARNING 


围 之 外 的 coMMIT 
ERROR 报告 导致 当前 命令 退出 的 错 误 。 WARNING ERROR 


报告 一 些 管理 员 感 兴趣 的 信息 ， 比 如 ， 


LOG R INFO INFORMATION 
检查 点 活跃 性 。 

FATAL 报告 导致 当前 会 话 终止 的 错误 。 ERR ERROR 

PANIC 告 导 致 所 有 数据 库 会 话 退出 的 错误 。 CRIT ERROR 


18.8.3. 记录 什么 


application_name ( string ) 


该 application_name 可 以 是 小 于 NAMEDATALEN 字符 (标准 构建 64 个 字符 ) 的 任何 字符 串 。 它 
通常 是 由 应 用 程序 连接 到 服务 器 设 该 名 称 将 显示 在 pg_stat_activity 视图 中 并 包含 在 
CSV 格 式 的 日 志 项 中 。 DR aa 过 |og_line_prefix 参 数 的 常规 日 志 项 中 。 只 有 可 
打印 的 ASCII 字 符 可 能 用 在 application_name 值 中 。 其 它 字 符 会 用 问号 ( ? RË., 


debug_print_parse ( boolean ) debug_print_rewritten ( boolean ) debug_print_plan 


( boolean ) 
这 些 选项 打开 各 种 调试 输出 。 当 设置 ， 它 们 打印 生成 的 解析 树 ， 查 询 重 写 输 出 ， 或 每 个 执行 
查询 的 执行 计划 。 这 些 消息 在 Lo6 消息 级 别 on 所 以 默认 情况 下 它们 会 出 现在 服务 器 日 


志 中 ， 但 不 会 被 发 送 到 客户 端 。 您 可 以 通过 调整 client_min_messages 和 /或 
log_min_messages 改 变 。 3 ie 闭 的 。 


debug_pretty_print ( boolean ) 


当 设 置 时 ， debug_pretty_print 44 进 debug_print_parse , debug_print_rewritten 或 
者 debug_print_plan 产生 的 消息 ， 这 样 更 加 可 读 ， 但 是 ， 当 关 闭 它 时 ， 比 "紧凑 型 "格式 更 长 
的 输出 ， 缺 省 是 打开 的 。 


log_checkpoints ( boolean ) 


导致 检查 点 和 重启 点 被 记录 在 服务 器 日 志 一 些 统计 都 包含 在 日 志 信息 中 ， 包 括 缓冲 区 写 
人 数量 和 编写 它们 的 花费 的 时 间 。 这 些 参数 只 能 在 postgresql.conf 文件 或 者 服务 器 命令 行 上 
设置 ， 缺 省 是 off 


log_connections ( boolean ) 


导致 记录 到 服务 器 的 每 个 党 试 连 接 ， 以 及 成 功 完成 客户 端 认 证 。 该 参数 在 会 话 开 始 之 后 不 能 
改变 ， 缺 省 是 off。 


Note: 某 些 客户 端 程序 ， 如 psql 当 确定 是 否 需要 密码 的 时 候 ， 企图 连接 两 次 。 所 以 复 
制 "连接 收 到 "的 消息 不 一 定 表示 有 问题 。 





log_disconnections ( boolean ) 


这 个 选项 类 似 log connections ， 但 是 在 会 话 结束 的 时 候 在 服务 器 日 志 里 输出 一 行 。 并 且 包 含 
会 话 持续 时 间 。 缺 省 是 关闭 的 。 这 个 参数 在 会 话 开始 之 后 不 能 被 改变 。 


log_duration ( boolean ) 
WKBTORME ANA Bo AEE off. RARA P TAAR RTE. 
对 于 使 用 扩展 查询 协议 的 客户 端 ， 语 法 分 析 、 邦 定 、 执 行 每 一 步 所 花 时 间 都 分 别 记录 。 


Note: 设置 为 0 时 该 选项 和 与 log_min_duration_statement 的 不 同 之 处 在 

于 log min_duration_statement 强制 记录 查询 文本 。 但 是 这 个 选项 不 可 以 。 因 此 ， 如 
果 log_duration A on 并 且 log_min_duration_statement AFB iz Maw 间 ， 
(eR ict Pee WANA, 这 可 以 用 于 在 高 负载 情况 下 搜集 统计 信息 。 














log_error_verbosity ( enum ) 


控制 记录 的 每 条 信息 写 到 服务 器 日 志 里 的 详细 程度 。 有 效 的 值 

是 TERSE , DEFAULT 和 VERBOSE ， 逐个 向 显示 的 信息 里 增加 更 多 的 字段 。 TERSE 包含 

DETAIL 的 记录 ，HINT , QUERY 和 coNTEXT 错误 信息 。 vERBOSE 输出 包含 sQLSTATE 错误 代码 
(参见 Appendix A) 以 及 源 代码 文件 名 称 ， 画 数 名 称 ， 以 及 产生 错误 的 行 数 。 只 有 超级 用 户 可 
以 改变 这 个 设置 。 

log_hostname ( boolean ) 

缺 省 时 ， 连 接 日 志 只 记录 所 连接 主机 的 IP 地 址 。 打 开 这 个 选项 导致 同时 记录 主机 名 。 请 注 
意 ， 这 样 有 可 能 带 来 一 些 不 可 忽略 的 性 能 损失 (取决 于 你 的 名 字 解 析 的 设置 )。 这 个 选项 只 能 
在 postgresql.conf 文件 里 或 者 服务 器 命令 行 设置 。 

log_line_prefix ( string ) 

这 是 一 个 printf 风格 的 字符 串 ， 在 日 志 的 每 行 开 头 输出 。 % 字符 开始 " 转 义 序列 "被 如 下 所 述 
状态 信息 替换 。 无 法 识别 的 转 义 被 忽略 。 其 它 字 符 都 直接 拷贝 到 日 志 行 中 。 有 些 逃 逸 只 被 会 


话 进 程 识别 ， 被 后 端 进程 忽略 ， 比 如 主 服务 器 进程 。 这 个 选项 只 能 在 postgresql.conf 文件 里 
或 者 服务 器 命令 行 设 置 。 缺 省 是 空 字符 串 。 


仅 用 


效果 会 
话 
%a Application name yes 
%u User name yes 
%d Database name yes 
%r Remote host name or IP address, and remote port yes 
%h Remote host name or IP address yes 
%p Process ID no 
%t Time stamp without milliseconds no 
%m Time stamp with milliseconds no 
%i Command tag: type of session's current command yes 
%e SQLSTATE error code no 
%C Session ID: see below no 
%1 Number of the log line for each session or process, starting at 1 no 
%S Process start time stamp no 
%v Virtual transaction ID (backendID/localXID) no 
%X Transaction ID (0 if none is assigned) no 
%a Produces no output, but tells non-session processes to stop at this ae 
point in the string; ignored by session processes 
%% Literal % no 


%c 逃逸 打印 唯一 会 话 标识 符 ， 由 两 个 点 号 分 隔 的 4 字 节 的 十 六 进 制 数字 (没有 前 导 需 ) 组 
Ko 数字 是 该 过 程 的 开始 时 间 和 进程 ID， 所 以 %c 也 可 以 用 做 一 种 打印 这 些 项 目的 节约 空间 
的 方法 。 例如 ， 为 了 从 pg_stat_activity 中 生成 会 话 标 识 符 ， 使 用 这 个 查询 : 


SELECT to_hex(EXTRACT(EPOCH FROM backend_start)::integer) || '.' |] 
to_hex(pid) 
FROM pg_stat_activity; 


Tip: 如 果 你 设置 log line prefix 的 非 空 值 ， 你 应 该 经 常 使 其 最 后 一 个 字符 是 一 个 空格 ， 
提供 来 自 日 志 行 的 其 余部 分 的 视觉 分 离 。 一 个 标点 符号 也 可 以 使 用 。 





Tip: Syslog 产 生 自 身 时 间 惟 和 进程 ID 信息 ， 如 果 你 记录 到 syslog， 所 以 你 可 能 不 想 包括 
那些 逃脱 。 


log_lock_waits ( boolean ) 


当 会 话 等 待 比 deadlock timeout 获 得 锁 更 长 的 时 间 时 ， 控 制 是 否 产生 一 个 日 志 消 息 。 决定 如 
果 锁 等 待 造成 很 差 的 性 能 ， 这 是 很 有 用 处 的 。 默 认 是 offo 


log_statement ( enum ) 


控制 记录 哪些 SQL 语句 。 有 效 的 值 是 none (Off), ddl, mod 和 all (所 有 语句 )。 ddl 记录 
所 有 数据 定义 命令 ， 比 如 CREATE, ALTER 和 prop 语句 。 mod 记录 所 有 ddl 语句 ， MER 
据 修改 语句 INSERT , UPDATE , DELETE , TRUNCATE , 和 copy FROM 。 如 果 所 包含 的 命令 类 型 吻 
合 ， 那 么 PREPARE , EXECUTE 和 EXPLAIN ANALYZE 语句 也 同样 被 记录 。 对 于 使 用 扩展 查询 协议 
的 客户 端 ， 记 录 发 生 在 接受 到 扩展 信息 并 包含 邦 定 参数 (内 置 单 引号 要 双 写 ) 的 时 候 。 


RAE none 。 只 有 超级 用 户 可 以 改变 这 个 设置 。 
Note: 即使 设置 了 1log_statement = all ， 包 含 简单 语法 错误 的 语句 也 不 会 被 记录 。 A 
为 仅 在 完成 基本 的 语法 分 析 并 确定 了 语句 类 型 之 后 才 记 录 日 志 。 在 使 用 扩展 查询 协议 的 
情况 下 ， 在 执行 阶段 之 前 (语法 分 析 或 规划 阶段 ) 同 样 不 会 记录 。 
将 log_min_error_statement 设 为 ERROR 或 更 低 才 能 记录 这 些 语句 。 











log_temp_files ( integer ) 


控件 的 临时 文件 名 称 和 大 小 。 临 时 文件 可 以 创建 的 分 类 ， 哈 希 ， 和 临时 的 查询 结果 。 HOR 
删除 时 ， 一 个 日 志 项 有 利于 每 个 临时 文件 。 需 值 记录 所 有 临时 文件 的 信息 ， 同时 正 值 记 录 文 
件 大 小 大 于 或 等 于 千 字 节 指定 数量 。 默认 设置 是 -1， 禁 用 这 样 的 日 志 。 只 有 超级 用 户 可 以 更 
改 此 设置 。 


1og_timezone ( string ) 


设置 用 于 写 入 服务 器 日 志 的 时 间 戳 的 时 区 。 不 像 TimeZone， 这 个 值 是 得 范围 ， 因此 ， 所 有 会 
SSSR A. Bia Mr ， 但 这 通常 被 postgresql.conf fem ; initdb 将 安装 与 其 系 
统 环境 一 致 的 设置 。 参 见 Section 8.5.3 获 取 更 多 信息 。 这 个 参数 只 能 在 postgresql.conf 文件 
或 者 服务 器 命令 行 上 进行 。 


18.8.4. 使 用 CSV- 格 式 日 志 输 


在 log_destination 列表 中 包含 csvlog 提供 了 一 种 便捷 的 方式 导入 日 志文 件 到 一 个 数据 库 
Ro 此 选项 在 逗号 分 隔 值 (CSV) 中 发 出 日 志 行 ， 这 些 列 为 : time stamp with milliseconds, 
user name, database name, process ID, client host:port number, session ID, per-session line 
number, command tag, session start time, virtual transaction ID, regular transaction ID, error 
severity, SQLSTATE code, error message, error message detail, hint, 导致 错误 的 内 部 查询 
OIRE) ， 字 符 计 算 错 误 位 置 ， 包含 错误 文本 ， 导 致 错误 的 用 户 查询 (如 果 有 并 且 通 
过 log_min_error_statement 启动 ) ， 字符 计算 错误 位 置 。 其 中 有 PostgreSQL 源 代码 错误 的 
位 置 (AR log_error_verbosity 设置 为 verbose ) ， 以 及 应 用 程序 的 名 称 。 这 是 一 个 用 于 存 
储 CSV 格 式 的 日 志 输 出 样本 表 定 义 : 


CREATE TABLE postgres_log 


( 


log_time timestamp(3) with time zone, 
user_name text, 

database_name text, 

process_id integer, 

connection_from text, 

session_id text, 

session_line_num bigint, 

command_tag text, 

session_start_time timestamp with time zone, 
virtual_transaction_id text, 
transaction_id bigint, 

error_severity text, 

sql_state_code text, 

message text, 

detail text, 

hint text, 

internal_query text, 
internal_query_pos integer, 

context text, 

query text, 

query_pos integer, 

location text, 

application_name text, 

PRIMARY KEY (session_id, session_line_num) 


使 用 copy FRoM 命令 ， 将 日 志文 件 导 和 人 到 这 个 表 中 : 


COPY postgres_log FROM '/full/path/to/logfile.csv' WITH csv; 


你 需要 做 几 件 事情 简化 导入 CSV 日 志文 件 : 


1. 


设置 log_filename 和 log_rotation_age 为 你 的 日 志文 件 提供 一 个 一 致 的 ， 可 预见 的 命名 
方式 。 这 让 你 预测 哪些 文件 的 名 称 以 及 独立 日 志文 件 是 完整 的 ， 因 此 可 以 准备 导 和 人 。 


设置 log_rotation_size 为 0 以 禁用 基于 大 小 的 日 志 旋 转 ， 因为 它 很 难 预 测 日 志文 件 名 。 
设置 log_truncate_on_rotation 到 on, MAF 旧 的 日 志 数 据 不 与 同一 文件 的 新 数据 混 


Oo 


a 


上 面 表 定义 包括 主 密 钥 规范 。 这 是 为 了 防止 意外 导 和 人 相同 的 有 用 信息 两 次 。 copY MP 
要 求 所 有 的 数据 一 次 导 和 人， 所 以 任何 错误 都 将 导致 整个 导 和 人 过 程 失败 。 如 果 你 导入 部 分 
日 志文 件 ， 当 它 完成 时 ， 然 后 再 导入 该 文件 ， 主 键 冲突 会 导致 导入 过 程 失败 。 等 待 直到 
日 志 是 完整 的 ， 并 且 导 入 之 前 关闭 。 该 程序 也 将 防止 意外 导入 尚未 完全 写 入 的 局 部 行 ， 
这 也 将 导致 coPY 失败 。 


18.9. 运行 时 统计 


18.9.1. 查询 和 索引 统计 收集 器 


下 面 的 参数 控制 服务 器 范围 的 统计 搜集 特性 。 如 果 启 用 了 统计 搜集 ， 那么 生成 的 数据 可 以 通 
过 pg_stat 和 pg_statio 系统 视图 家 族 访问 。 参见 Chapter 27 获 取 更 多 信息 。 


track_activities ( boolean ) 


统计 每 个 会 话 执行 的 命令 及 其 开始 执行 的 时 间 。 这 个 选项 缺 省 是 开启 的 。 请 注意 即使 把 它 打 
开 ， 这 个 信息 也 不 是 所 有 用 户 都 可 见 的 ， 只 有 超级 用 户 和 会 话 的 所 有 者 才能 看 到 ; 因此 它 不 
应 该 是 个 安全 漏洞 。 只 有 超级 用 户 可 以 改变 这 个 设置 。 


track_activity_query_size ( integer ) 


指定 跟踪 当前 执行 命令 的 预 留 字 节 数 ， 为 了 每 个 活动 会 话 ， 以 及 pg stat activity . query F 
段 。 默认 值 是 1024。 这 个 参数 只 能 在 服务 器 启动 时 设置 


track_counts ( boolean ) 


打开 数据 库 活动 的 统计 收集 。 此 参数 缺 省 是 开启 的 ， 因 为 自动 清理 守护 进程 需要 收集 信息 。 
只 有 超级 用 户 可 以 更 改 此 设置 。 


track_io_timing ( boolean ) 


启动 数据 库 定时 MO 调用 。 此 参数 缺 省 是 关闭 的 ， 因 为 它 会 反复 查询 操作 系统 当前 的 时 间 ， 这 
可 能 会 导致 某 些 平台 的 显著 开销 。 您 可 以 使 用 pg test timing 工 具 测 量 系 统 上 的 定时 开销 。 
在 EXPLAIN 的 输出 中 通过 ， pg_stat_statements(# FH BuFFERS 选项 时 。 IO 时 序 信息 显示 
在 pg_stat database 上 ， 只 有 超级 用 户 才能 更 改 此 设置 。 


track_functions ( enum ) 


用 函数 调用 计数 和 时 间 跟 踪 。 指 定 pl 仅 跟踪 过 程 语言 玉 数 ， all (RIRSQLAIC4 EH 
数 。 默认 是 none ， 禁 用 函数 统计 跟踪 。 只 有 超级 用 户 可 以 更 改 此 设置 。 


Note: 足够 简单 的 以 便 " 内 联 "到 调用 查询 的 SQL 语言 范 数 将 不 被 跟踪 ， 而 不 管 这 些 设 
E. 





update_process_title ( boolean ) 


服务 器 每 收 到 一 个 新 的 SQL 命令 就 更 新 进程 标题 。 进程 标题 可 以 通过 ps 命令 或 Windows 下 
的 进程 管理 器 查看 。 只 有 超级 用 户 可 以 改变 这 个 设置 


stats_temp_directory ( string ) 


设置 存储 临时 统计 数据 的 目录 。 这 可 以 是 相对 于 数据 目录 的 相对 路 径 或 绝对 路 径 。 RA 
是 pg_stat_tmp 。 指向 基于 RAM 文 件 系统 将 减少 物理 MO 要 求 ， 并 可 能 导致 性 能 提升 。 此 参 
数 只 能 在 postgresql.conf 文件 或 者 服务 器 命令 行 上 设置 


18.9.2. 统计 监控 


log_statement_stats ( boolean ) log_parser_stats ( boolean ) log planner_stats 


( boolean ) log _executor_stats ( boolean ) 


对 每 条 查询 ， 向 服务 器 日 志 里 输出 相应 模块 的 性 能 统计 。 这 是 原始 的 剖析 工具 。 类 似 于 Unix 
getrusage() 操作 系统 工具 。 log_statement_stats 报告 总 的 语言 统计 ， 而 其 它 的 报告 针对 每 
个 模块 的 统计 。 log_statement_stats 不 能 和 其 它 任 何 针对 每 个 模块 统计 的 选项 一 起 打开 。 所 
有 这 些 选 项 都 是 缺 省 关闭 的 。 只 有 超级 用 户 才 能 修改 这 些 设 置 。 


18.10. 目 动 清理 


这 些 设 置 控制 自动 清理 的 缺 省 行为 。 请 参阅 Section 23.1.6 获 取 更 多 信息 。 
autovacuum ( boolean ) 


控制 服务 器 是 否 应 该 启动 autovacuum 守 护 进 程 。 缺 省 是 关闭 的 。 然 而 ， track_counts 还 必须 
启用 自动 清理 工作 。 这 个 选项 只 能 在 postgresql.conf 文件 里 或 者 是 服务 器 命令 行 中 设置 。 


请 注意 ， 即 使 禁用 该 参数 ， 如 果 有 必要 避免 事务 ID 重生 ， 系 统 仍 将 启动 自动 清理 进程 。 请 参 
阅 Section 23.1.5 获 取 更 多 详细 信息 。 


log_autovacuum_min_duration ( integer ) 


如 果 它 运行 至 少 毫秒 指定 数 ， 导 致 记录 自动 清理 所 执行 的 每 个 动作 。 此 设置 为 需 记 录 所 有 自 
动 清理 操作 。 减 一 (默认 ) 禁用 日 志 记录 自动 清理 动作 。 例 如 ， 如 果 您 将 其 设置 为 25oms , 

那么 将 记录 运行 250ms 或 更 长 时 间 的 所 有 自动 清理 和 分 析 。 此 外 ， 当 这 个 参数 设置 为 

除 -1 外 的 其 他 任何 值 ， 如 果 由 于 冲突 锁 的 存在 而 忽略 自动 清理 操作 ， 则 记录 这 条 消息 。 É 
用 此 参数 可 以 有 益 于 跟踪 自动 清理 活动 。 这 个 设置 只 能 在 postgresql.conf 文件 或 者 服务 器 命 
STERE. 


autovacuum_max_workers ( integer ) 


指定 自动 清理 进程 的 最 大 数 (除了 自动 清理 发 射 器 ) ， 它 可 以 在 任 一 时 刻 运行 。 默认 是 三 。 
这 个 参数 只 能 在 服务 器 启动 时 设置 。 


autovacuum_naptime ( integer ) 


声明 运行 在 任何 给 定数 据 库 上 的 autovacuum 之 间 的 最 小 延迟 。 在 每 次 运行 的 周期 里 ， 守护 进 
程 都 会 检查 一 个 数据 库 ， 并 根据 需要 为 该 数据 库 的 表 发 出 vacuum 和 analyze 命令 。 这 个 延 
迟 是 以 秒 计 的 ， 缺 省 为 1 分 钟 ( 1min )。 这 个 选项 只 能 在 postgresql.conf 文件 里 或 者 服务 器 命 
倒 行 中 设置 。 

autovacuum_vacuum_threshold ( integer ) 

声明 在 任何 表 里 触 发 vacuum 所 需 最 小 的 行 更 新 或 删除 数量 。 缺 省 是 500。 这 个 选项 只 能 


在 postgresql.conf 文件 里 或 者 服务 器 命令 行 中 设置 。 此 处 的 设置 可 以 被 改变 存储 参数 的 独立 
的 表 履 盖 。 


autovacuum_analyze_threshold ( integer ) 


声明 在 任何 表 里 触发 ANALYzE 所 需 最 小 的 行 插入 、 更 新 、 删 除数 量 。 和 缺 省 是 50。 这 个 选项 只 
能 在 postgresql.conf 文件 里 或 者 服务 器 命令 行 中 设置 。 此 处 的 设置 可 以 被 改变 存储 人 参数 的 独 
WRB. 





autovacuum_vacuum_scale_ factor ( floating point ) 


声明 在 判断 是 否 触发 一 个 VACUUM 时 增加 到 autovacuum_vacuum_threshold 参数 里 面 的 表 尺 寸 的 
分 数 。 缺 省 是 0.2( 表 大 小 的 20%)。 这 个 选项 只 能 在 postgresql.,conf 文件 里 或 者 服务 器 命令 
行 中 设置 。 此 处 的 设置 可 以 被 改变 存储 参数 的 独立 表 和 覆盖 。 


autovacuum_analyze_scale_factor ( floating point ) 


声明 在 判断 是 否 触发 一 个 ANALYZE 时 增加 到 autovacuum_analyze_threshold 参数 里 面 的 表 尺 寸 
的 分 数 。 缺 省 是 0.1( 表 大 小 的 10%)。 这 个 选项 只 能 在 postgresql.conf 文件 里 或 者 服务 器 启 
动 的 时 候 设 置 。 此 处 的 设置 可 以 被 改变 存储 参数 的 独立 表 和 覆盖 。 


autovacuum_freeze_max_age ( integer ) 


指定 表 的 pg_class 在 事务 中 的 最 大 寿命 。 relfrozenxid 字段 能 够 在 强制 vacuum 操作 以 防止 
事务 ID 在 表 内 循环 重复 之 前 完成 。 需 要 注意 的 是 ， 即 使 autovacuum 被 禁止 系统 也 会 调用 
autovacuum 进程 来 防止 循环 重复 。 


自动 清理 允许 删除 来 自 pg_clog 子 目录 的 旧 文 件 ， 默认 值 是 相对 低 于 200 百 万 事务 。 该 参数 
只 能 在 服务 器 启动 时 设置 ， 但 是 此 处 的 设置 可 以 通过 改变 存储 人 参数 独立 表 减 少 。 更 多 信息 请 
参见 Section 23.1.5。 


autovacuum_vacuum_cost_delay ( integer ) 


声明 将 在 自动 vacuum 操作 里 使 用 的 开销 延迟 数值 。 声明 -1 将 使 用 普通 的 vacuum_cost_delay 
数值 。 缺 省 值 是 20 富 秒 。 这 个 选项 只 能 在 postgresql.conf 文件 里 或 者 在 服务 器 启动 的 时 候 
设置 。 此 处 的 设置 可 以 被 改变 存储 参数 的 独立 表 覆 盖 。 


autovacuum_vacuum_cost_limit ( integer ) 


声明 将 在 自动 vacuum 操作 里 使 用 的 开销 限制 数值 。 -1( 缺 省 值 ) 将 使 用 普通 的 
vacuum_cost limit 数 值 。 要 注意 的 是 值 将 按 比例 分 配给 运行 autovacuum 工 作者 ， 如 果 有 一 
个 以 上 上， 这样 每 个 工作 者 限制 总 和 不 会 超过 此 变量 的 极限 。 这 个 选项 只 能 

在 postgresql.conf 文件 里 或 者 在 服务 器 启动 的 时 候 设 置 。 此 处 的 设 ia Fy baat 改变 存储 参数 
独立 表 和 覆盖 。 


18.11. 客户 端 连 接 缺 省 


18.11.1. 语句 行为 


search_path ( string ) 


这 个 变量 声明 模式 的 搜索 顺序 ， 在 一 个 被 引用 对 象 ( 表 、 数 据 类 型 、 画 数 等 ) 只 是 一 个 简单 名 

F, 没有 声明 模式 时 需要 这 样 的 搜索 。 如 果 在 另外 一 个 模式 里 有 一 个 相同 的 对 象 名 ， 那么 使 
用 在 这 个 搜索 路 径 中 找到 的 第 一 个 。 一 个 不 在 搜索 路 径 中 任何 一 个 模式 里 出 现 的 对 象 只 能 通 
过 其 所 在 模式 的 全 称 (打点 的 ) 名 字 来 声明 。 


search_path 的 值 必需 是 一 个 逗号 分 隔 的 模式 名 列表 。 它 不 是 一 个 现 有 的 模式 名 ， 或 者 用 户 
不 具有 usace 权限 的 模式 ， 都 将 被 自动 忽略 。 


如 果 列 表 项 之 一 是 特殊 名 称 $user, 那么 通过 sEssIoN_usER 返回 的 名 称 模式 被 取代 ， 如 果 
有 这 样 一 个 模式 并 且 用 户 已 经 有 usAGE 权限 。 (如 果 不 是 ， 那 么 忽略 $user ) 


RARI pg_catalog 总 是 被 搜索 ， 不 管 是 否 在 搜索 路 径 。 如 果 在 路 径 中 ， 那么 按照 路 径 指 
定 的 顺序 搜索 ， 如 果 pg_catalog 不 在 路 径 中 ， 那 么 将 在 任何 路 径 之 前 搜索 。 


同样 ， 如 果 它 存在 ， 那 么 当前 会 话 的 临时 表 模 式 ， pg_temp nnn 总 是 被 搜索 。 它 可 以 通 
过 使 用 别名 pg_temp 被 明确 地 列 在 该 路 径 中 。 如 果 没 有 列 在 路 径 中 ， 那 么 它 首先 被 搜索 (其 
Æ pg_catalog 之 前 ) 。 但 是 ， 临 时 模式 只 搜索 关系 〈 表 ， 视 图 ， 序 列 等 ) 以 及 数据 类 型 名 
称 。 它 从 来 没有 搜索 函数 或 运算 符 名 称 。 


如 果 创 建 对 象 时 没有 声明 特定 的 目标 模式 ， 那 么 它 将 被 放 进 search_path 中 的 第 一 个 模式 。 
如 果 搜 索 路 笃 是 空 的 ， 那 么 会 报告 一 个 错误 。 


这 个 参数 的 缺 省 值 是 "$user", public 。 这 样 就 支持 共享 使 用 一 个 数据 库 ( 没 有 用 户 拥 有 私有 
模式 ， 所 有 人 都 共享 使 用 public) 私有 的 针对 每 个 用 户 的 模式 、 以 及 两 者 的 组 合 。 Her 
果 可 以 通过 全 局 或 者 针对 每 个 用 户 修改 搜索 路 径 设 置 获取 。 

搜索 路 径 当 前 值 可 以 用 SQL 辑 数 current_schemas (参阅 Section 9.25) 检查 。 它 和 检 

查 search_path 的 值 不 太一 样 ， 因 为 current_schemas 显示 的 是 在 search_path 里 出 现 的 项 如 
何 被 处 理 。 


有 关 模 式 处 理 的 更 多 信息 ， 参 阅 Section 5.7。 
default_tablespace ( string ) 


这 个 变量 声明 当 create 命令 没有 明确 声明 表 空 间 时 ， 所 创建 对 象 ( 表 和 索引 等 ) 的 缺 省 表 空 
间 。 


值 要 么 是 一 个 表 空 间 的 名 字 ， 要 么 是 一 个 表明 使 用 当前 数据 库 缺 省 表 空 间 的 空 字符 串 。 MR 
这 个 数值 和 任意 现存 表 空 间 的 名 字 都 不 匹配 ， 那么 PostgreSQL 将 自动 使 用 当前 数据 库 的 缺 省 
表 空 间 。 如 果 声 明 非 缺 省 表 空 间 ， 用 户 必 须 有 cREATE 权限 ， 或 者 创建 党 斌 将 失败 。 

这 个 变量 不 用 于 临时 表 ; 对 他 们 来 说 ，temp_tablespaces 提 供 座 询 。 

这 个 变量 在 创建 数据 库 时 也 没有 使 用 。 默 认 情 况 下 ， 新 的 数据 库 继承 了 从 模板 数据 库 复制 的 
表 空 间 设 置 。 

关于 表 空 间 的 更 多 信息 ， 请 参阅 Section 21.6。 


temp_tablespaces ( string ) 


当 cREATE 命令 不 明确 指定 一 个 表 空 间 时 ， 这 个 变量 指定 要 在 其 中 创建 临时 对 象 的 表 空 间 ( 临 
RAI RASS) 。 出 于 此 目的 的 临时 文件 ， 比 如 排序 大 型 数据 集 ， 也 在 这 些 表 空间 中 
创建 。 


该 值 是 表 空 间 名 称 的 列表 。 当 列表 中 有 一 个 以 上 名 称 时 ， PostgreSQL 每 次 临时 对 象 被 创建 时 
选择 一 个 列表 中 的 随机 数 ; 除了 在 一 个 事务 中 之 外 ， 先 后 创建 临时 对 象 放 置 在 列表 连续 的 表 
空间 中 。 如 果 列 表 中 选 定 的 元 素 是 一 个 空 字符 串 ， PostgreSQL 会 自动 使 用 当前 数据 库 的 缺 
省 表 空 间 。 


当 temp_tablespaces 交互 设置 时 ， 指定 不 存在 的 表 空 间 是 二 个 Bik, A 不 具有 CREATE 权限 
的 用 户 声 明 一 个 表 空 间 。 但 是 ， 当 使 用 事先 设 定 的 值 时 ， 则 忽略 不 存在 的 表 空 间 ， 因为 对 于 
缺少 create 权限 的 用 户 是 一 个 表 空 间 。 特别 是 ， 该 规则 适用 于 使 用 postgresql.conf 设置 的 
值 时 。 


默认 值 是 一 个 空 字 符 串 ， 这 会 导致 所 有 临时 对 象 在 当前 数据 库 缺 省 表 空 间 被 创建 。 
参阅 default_tablespace。 
check_function_bodies ( boolean ) 


这 个 参数 通常 是 on。 设 置 为 off 表示 在 CREATE FUNCTION 之 间 关 闭 画 数 体 字符 串 的 合法 性 
检查 。 关闭 合法 性 检查 有 时 候 会 有 用 ， 比 如 避免 从 转 储 中 恢复 函数 定义 时 向 前 引用 的 问题 。 


default_transaction_isolation ( enum ) 


每 个 SQL 事务 都 有 一 个 隔离 级 别 ， 可 以 是 " 读 未 提交 "，" 读 已 提交 "， "可 重复 读 "或 者 是 "可 串 性 
化 "。 这 个 参数 控制 每 个 新 事务 的 缺 省 隔离 级 别 。 缺 省 是 " 读 已 提交 "。 


参考 Chapter 13 和 SET TRANSACTION 获 取 更 多 信息 。 
default_transaction_read_only ( boolean ) 


只 读 的 SQL 事务 不 能 修改 非 临 时 表 。 这 个 参数 控制 每 个 新 事务 的 只 读 状 态 。 缺 省 是 off ( 读 / 
=), 


参考 SET TRANSACTION 获 取 更 多 信息 。 
default_transaction_deferrable ( boolean ) 


4S 可 串 行 化 隔离 级 别 下 运行 时 ， 延迟 的 只 读 SQL 事 务 允 许 继 续 进行 之 前 可 能 会 延迟 。 A 
而 ， 一 旦 开始 执行 不 会 产生 任何 开销 要 求 ， 以 确保 串 行 化 ; 所 以 串 行 化 代码 没有 理由 人 迫使 它 终 
止 ， 因 为 并 发 更 新 ， 这 使 这 些 选 项 适合 长 时 间 运 行 只 读 事务 。 

此 参数 控制 每 个 新 事务 缺 省 延迟 状态 。 它 目前 对 读 写 事务 或 那些 比 可 串 行 化 低 的 隔离 级 别 下 
的 操作 没 影响 。 缺 省 是 of fF o 

参阅 SET TRANSACTION 获 取 更 多 详细 信息 。 


session_replication_role ( enum ) 


控制 当前 会 话 复制 相关 的 触发 器 和 规则 。 设 置 此 变量 需要 超级 用 户 权限 ， 并 导致 去 奔 任 何以 
前 缓存 查询 规划 。 可 能 的 值 是 origin (HRB), replica 和 local, 参阅 ALTER TABLE} HX 
更 多 信息 。 


statement_timeout ( integer ) 


退出 任何 使 用 了 超过 此 参数 指定 时 间 ( 室 秒 ) 的 语句 ， 从 服务 器 收 到 命令 时 开始 计时 。 如 

果 log_min_error_statement 设置 为 ERROR 或 者 更 低 ， 那么 也 会 在 日 志 中 记录 超时 。 Aik 
省 ) 关 闭 这 个 计时 器 。 

不 推荐 设置 postgresql.conf 中 的 statement_timeout, 因为 它 影响 所 有 的 会 话 。 
lock_timeout ( integer ) 

当 试图 获取 表 、 索 引 、 行 或 其 他 数据 库 对 象 的 锁 时 ， 终 止 等 待 时 间 超过 指定 毫秒 数 的 任何 语 
句 。 时 间 限 制 分 别 适 用 于 每 个 锁 获 取 党 试 。 该 限制 适用 于 明确 锁定 请 求 〈 如 Lock TABLE 或 
者 没有 NowAIT 的 SELECT FOR UPDATE ) 以 及 隐 式 获取 的 锁 。 如 果 1log_min_error_statement 设 
1% ERROR 或 更 低 ， 则 记录 超时 的 语句 。 老 值 MEE) 关闭 它 。 

AMR statement_timeout ， 此 超时 只 能 发 生 在 等 待 锁 的 时 候 。 请 注意 ， 如 

果 statement_timeout IES, 设置 lock_timeout 相同 或 更 大 的 值 是 相当 没有 意义 的 ， 因为 
该 语句 超时 总 是 会 首先 触发 。 

不 推荐 设置 postgresql.conf 中 的 lock_timeout , 因为 它 影响 所 有 的 会 话 。 


vacuum_freeze_table_age ( integer ) 





如 果 该 表 pg_class . relfrozenxid 字段 已 达到 此 设置 中 指定 的 时 间 ， vacuum 执行 全 表 扫 描 。 
默认 值 是 1.5 亿 个 事务 。 虽然 用 户 可 以 从 需 到 十 亿 设 置 此 值 。 vacuum 会 默默 的 限 

制 autovacuum_freeze_max_age 的 95% 的 有 效 值 ， 从 而 使 定期 手动 的 vacuum 在 自动 清理 该 
表 之 前 有 运行 机 会 。 详细 信息 请 见 Section 23.1.5。 





vacuum_freeze_min_age ( integer ) 


指定 vacuum 在 扫描 一 个 表 时 用 于 判断 是 否 用 FrozenxIDp 蔡 换 事务 ID 的 中 断 寿命 (在 同一 个 事 
务 中 )。 缺 省 值 为 50 百 万 。 虽 然 用 户 可 以 指定 一 个 0-1000000000 之 间 的 值 ， 但 是 vacuum 将 
会 展 无 声息 的 将 有 效 值 限制 在 autovacuum_freeze_max_age 的 一 半 之 内 。 更 多 信息 参见 
Section 23.1.5。 





bytea_output ( enum ) 


设置 bytea 类 型 值 的 输出 格式 。 有 效 值 为 hex (HRB) Al escape (传统 PostgreSQL 格式 )。 
参见 Section 8.4 获 取 更 多 信息 。 不 管 这 些 设置 ， 其 中 bytea 类 型 总 是 接受 这 两 种 格式 的 输 


o 


> 


xmlbinary ( enum ) 


设置 二 进 制 值 是 如 何在 XML 中 进行 编码 的 。 这 适用 于 当 bytea 值 通过 xmlelement 或 
者 xmlforest AR ik AXML. 可 能 的 值 是 base64 和 hex, 这 在 XML 模式 标准 中 定义 。 
默认 值 是 base64 。 关于 XML 相 关 的 函数 的 进一步 信息 ， 请 参阅 Section 9.14。 


这 里 的 实际 选择 主要 是 口味 问题 ， 只 有 在 客户 端 应 用 程序 中 可 能 存在 某 些 限制 约束 。 这 两 种 
方法 都 支持 所 有 可 能 的 值 ， 虽然 十 六 进 制 编码 将 会 比 base64 编 码 大 一 些 。 


xmloption ( enum ) 


当 XML 和 字符 串 值 之 间 进 行 转换 时 ， 设 置 bocuMENT 或 content 是 否 是 隐 含 的 。 参见 Section 
8.13 获 取 更 多 详细 信息 。 有 效 值 DocuMENT 和 content o HRA CONTENT o 


按照 SQL 标准 ， 设 置 这 个 选项 的 命令 是 : 


SET XML OPTION { DOCUMENT | CONTENT }; 


这 种 语法 在 PostgreSQL 中 是 可 用 的 。 


18.11.2. 区 域 和 格式 化 


Datestyle ( string ) 


设置 日 期 和 时 间 值 的 显示 格式 ， 以 及 有 歧义 的 输入 值 的 解析 规则 。 由 于 历史 原因 ， 这 个 变量 
包含 两 个 独立 的 部 分 : 输出 格式 声明 ( ISO ， Postgres ， SQL 或 者 German )、 输入 输出 的 年 / 
月 /日 顺序 ( omy ，MDY 或 者 ww )。 这 两 个 可 以 独立 设置 或 者 一 起 设置 。 关键 

字 Euro 和 European 等 价 于 DMY ; 关键 字 US , NonEuro 和 NonEuropean 等 价 于 MDY o 参 
阅 Section 8.5 获 取 更 多 信息 。 内 和 置 缺 省 是 Iso, my, 但 是 initdb 将 在 初始 化 配置 文件 时 根 
据 lc time 选择 一 个 合适 的 默认 设置 。 


IntervalStyle ( enum ) 


设置 区 间 值 的 显示 格式 。 sql_standard 将 产生 输出 匹配 SQL 标 准时 间 间 隔 。 postgres 的 值 
(默认 值 ) 会 产生 输出 匹配 PostgreSQL8.4 之 前 的 版 本 。 当 DateStyle 参 数 设 置 为 Iso 时 。 
postgres_verbose 将 产 生 输 出 匹配 PostgreSQL8.4 之 前 的 版 本 。 当 DateStyle 参数 被 设置 成 

JF- Iso 输出 时 。 iso_8601 将 产生 输出 匹配 4.4.3.2 节 中 ISO 8601 定 义 的 时 间 间 隔 格 式 。 


Intervalstyle 参数 也 会 影响 不 明确 的 间隔 输入 的 说 明 。 参阅 Section 8.5.4 获 取 更 多 详细 信 
息 。 


TimeZone ( string ) 


KEATON AN K, ABR ont, 但 是 ， 这 通常 被 postgresql.conf A 
& ; initdb 将 安装 设置 对 应 它 的 系统 环境 。 意味 着 使 用 系统 环境 声明 的 时 区 。 参阅 Section 
8.5.3 获 取 更 多 信息 。 


timezone_abbreviations ( string ) 


设置 服务 器 接受 日 期 时 间 输入 中 使 用 的 时 区 缩写 集合 。 缺 省 值 'pefault' ， 在 全 世界 大 多 数 
地 方 都 能 工作 的 很 好 。 另外 的 可 用 值 还 有 'Australia' 和 'India' 等 其 它 值 。 参见 Appendix 
B 以 获取 更 多 信息 。 

extra_float_digits ( integer ) 

这 个 参数 为 浮 点 数值 调整 显示 的 数据 位 数 ， 浮 点 类 型 包括 floats , floats 以 及 几何 数据 类 
型 。 参数 值 加 在 标准 的 数据 位 数 上 ( FLT_pi6 或 者 wor 中 合适 的 )。 数值 可 以 设置 为 最 高 
3, 以 包括 部 分 关键 的 数据 位 ; 这 个 功能 对 转 储 那些 需要 精确 恢复 的 浮 点 数据 特别 有 用 。 或 
者 你 也 可 以 把 它 设置 位 负数 以 消除 不 需要 的 数据 位 。 参阅 Section 8.1.3。 


client_encoding ( string ) 


设置 客户 端 编码 (字符 集 )。 缺 省 使 用 数据 库 编 码 。 字符 集 通过 Section 22.3.1 里 描述 的 
PostgreSQL 服 务 器 支持 。 


lc_messages ( string ) 


设置 信息 显示 的 语言 。 可 接受 的 值 是 系统 相关 的 ; 参阅 Section 22.1 获 取 更 多 信息 。 如 果 这 个 
变量 设置 为 空 字符 串 ( 缺 省 值 )， 那么 其 值 将 以 一 种 系统 相关 的 方式 从 服务 器 的 执行 环境 中 继 
承 。 


在 一 些 系统 上 ， 这 个 区 域 范畴 并 不 存在 ， 不 过 仍然 允许 设置 这 个 变量 ， 只 是 不 会 有 任何 效 
果 。 同 样 ， 也 有 可 能 是 所 期 望 的 语言 的 翻译 信息 不 存在 。 在 这 种 情况 下 ， 你 仍然 能 看 到 英文 
信息 。 

只 有 超级 用 户 可 以 改变 这 个 设置 。 因 为 它 同时 影响 发 送 到 服务 器 日 志和 客户 端的 信息 。 并 且 
不 正确 的 值 可 能 会 掩盖 服务 器 日 志 的 可 读 性 。 


lc_monetary ( string ) 


为 格式 化 金额 数量 设置 区 域 。 比 如 用 于 to cha MAK. DHESMAEBRAMKM: 参 
阅 Section 22.1 获 取 更 多 信息 。 如 果 这 个 变量 设置 为 空 字符 串 ( 缺 省 值 )， 那么 其 值 将 以 一 种 系 
统 相关 的 方式 从 服务 器 的 执行 环境 中 继承 。 


lc_numeric ( string ) 


设置 用 于 格式 化 数字 的 区 域 ， 比 如 用 于 tochar 画 数 族 。 可 接受 的 值 是 系统 相关 的 ; 参 
阅 Section 22.1 获 取 更 多 信息 。 如 果 这 个 变量 设置 为 空 字符 串 ( 缺 省 值 )， 那么 其 值 将 以 一 种 系 
统 相关 的 方式 从 服务 器 的 执行 环境 中 继承 。 


lc_time ( string ) 


设置 用 于 格式 化 日 期 和 时 间 值 的 区 域 。 比 如 to char WAR, 可 接受 的 值 是 系统 相关 的 ; 参 
阅 Section 22.1 获 取 更 多 信息 。 如 果 这 个 变量 设置 为 空 字符 串 ( 缺 省 值 )， 那么 其 值 将 以 一 种 系 
统 相关 的 方式 从 服务 器 的 执行 环境 中 继承 。 


default_text_search_config ( string ) 


IEMA RHA ANA F ELARRE SA AMENA. B Chapter 
12 获 取 进 一 步 信息 。 内 置 缺 省 值 是 pg_catalog.simple , 如 果 配 置 匹 配 可 以 被 识别 的 区 域 ， 
则 initdb 将 初始 化 该 设置 的 配置 文件 ， 它 对 应 于 已 选择 的 lc_ctype 区 域 。 


18.11.3. 其 他 缺 省 


dynamic_library_path ( string ) 


如 果 需 要 打开 一 个 可 以 动态 装载 的 模块 并 且 在 CREATE FUNCTION 或 者 Lon 命令 里 面 声明 的 名 
字 没 有 目录 部 分 (也 就 是 说 名 字 里 不 包含 斜 枉 )， 那么 系统 将 搜索 这 个 目录 以 查找 声明 的 文 
件 。 


用 于 dynamic_library_path 的 数值 必须 是 一 个 冒号 分 隔 (或 者 是 在 Windows 上 分 号 分 隔 ) 的 绝对 
路 径 列 表 。 如 果 一 个 路 径 名 字 以 特殊 变量 $libdir (PostgreSQL 编 译 好 的 库 目录 ) 开 头 ， 那 

么 就 替换 为 PostgreSQL 发 布 提供 的 模块 安装 路 径 。 (使 用 pg_config --pkglibdir 打印 这 个 目 
录 名 )。 比 如 : 


dynamic_library_path = '/usr/local/lib/postgresql:/home/my_project/lib:$libdir' 


或 者 是 在 Windows 环 境 里 : 


dynamic_library_path = 'C:\tools\postgresql;H:\my_project\lib;$libdir' 


这 个 参数 的 缺 省 值 是 '$libdir' 。 如 果 把 这 个 值 设 置 为 一 个 空 字符 串 ， 则 关闭 自动 路 径 搜 
R, 


个 参数 可 以 在 运行 时 由 超级 用 户 修改 ， 但 是 这 么 修改 的 设置 只 能 保持 到 这 个 客户 端 连接 的 
R, 因此 这 个 方法 应 该 保留 给 开发 用 途 使 用 。 我 们 建议 在 postgresql.conf 配置 文件 里 设 


o 


m a be 


gin_fuzzy_search_limit ( integer ) 





GIN 索 引 扫描 返回 的 集合 尺寸 软 上 限 。 更 多 信息 参见 Section 57.4. 
local_preload_libraries ( string ) 


fa RAM AMR—-TRETHSE, STEZHABSA. 所 有 的 库 名 被 转换 
为 小 写字 母 ， 除 非 双 引号 引用 。 该 参数 不 能 在 会 话 开始 之 后 更 改 。 


因为 并 非 只 有 超级 用 户 才能 更 改 此 选项 ， 因此 只 能 加 载 安装 的 标准 库 目录 下 plugins FBR 
中 的 库 文件 ， 数据 库 管理 员 有 责任 确保 该 目录 中 的 库 都 是 "安全 的 "。 

local_preload_libraries 中 指定 的 项 可 以 明确 含有 该 目录 ， 例如 $libdir/plugins/mylib ; 也 
可 以 仅 指 定 库 的 名 字 一 例如 mylib (等 价 于 $libdir/plugins/mylib )。 


与 shared_preload _ libraries 不 同 的 是 ， 在 会 话 开 始 时 加 载 库 比 第 一 次 使 用 时 相 比 并 不 具有 性 
能 优势 。 相反 ， 这 个 特性 的 目的 是 为 了 调试 或 者 测量 在 特定 会 话 中 不 明确 使 用 LoAp 加 载 库 
时 的 性 能 。 例如 针对 某 个 用 户 将 该 参数 设 为 ALTER ROLE SET 来 进行 调试 。 

如 果 指 定 的 库 示 找到， 那么 连接 将 失败 。 

每 一 个 支持 PostgreSQL 的 库 都 有 一 个 "magic block" 用 于 确保 兼容 性 。 因此 不 支持 
PostgreSQL 的 库 不 能 通过 这 个 方法 加 载 。 


18.12. 锁 管 理 


deadlock_timeout ( integer ) 


以 毫秒 计 的 时 间 ， 用 于 设置 在 检查 是 否 存 在 死 锁 条 件 之 前 等 待 的 时 间 。 检查 是 否 存在 死 锁 条 
件 是 一 个 昂贵 的 过 程 ， 因 此 服务 器 不 会 在 每 次 等 待 锁 的 时 候 都 运行 这 个 过 程 。 我 们 乐观 地 假 
设 在 生产 应 用 中 的 死 锁 是 不 常 出 现 的 ， 因此 我 们 在 开始 询问 是 否 可 以 解锁 之 前 只 等 待 一 个 相 
对 较 短 的 时 间 。 增加 这 个 值 就 减少 了 浪费 在 无 用 的 死 锁 检 查 上 的 时 间 ， 但 是 减 慢 了 报告 真正 
死 锁 错误 的 速度 。 缺 省 是 1 秒 ( 1s )， 这 可 能 是 你 能 够 耐心 等 待 的 最 短 时 间 。 在 一 个 重负 载 的 
服务 器 上 ， 你 可 能 需要 增 大 它 。 这 个 值 的 典型 设置 应 该 超过 你 的 事务 持续 时 间 ， 这 样 就 可 以 
减少 在 锁 释 放 之 前 就 开始 死 锁 检查 的 问题 。 只 有 超级 用 户 可 以 改变 这 个 设置 。 


当 |log_lock_waits 被 设置 时 ， 此 参数 也 决定 在 发 出 有 关 锁 等 待 的 日 志 信息 之 前 的 等 待 时 间 长 
度 。 如 果 您 正在 党 试 调查 锁定 延迟 ， 你 可 能 想 设 置 一 个 小 于 正常 deadlock_timeout 的 值 。 


max_locks_per_transaction ( integer ) 


共享 的 锁 表 的 大 小 是 以 假设 任意 时 刻 最 多 只 有 max_locks_per_transaction * 
(max_connections + max_prepared_transactions) 个 独立 的 对 象 需要 被 锁 住 为 基础 进行 计算 
的 。 这 个 参数 控制 分 配给 每 个 事务 的 锁定 对 象 平 均 数 。 单独 事务 只 要 所 有 事务 锁 适 合 在 锁 表 
中 都 可 以 锁定 多 个 对 象 。 这 不 是 锁定 行 的 数目 ， 该 值 是 无 限 的 。 缺 省 值 64， 已 经 经 历史 证 明 
是 足够 的 了 ， 不 过 如 果 你 有 在 一 个 事务 里 接触 很 多 不 同 的 表 的 查询 ， 那 么 你 就 可 能 需要 提高 
这 个 数值 。 比如 带 有 很 多 孩子 的 父 表 查询 。 这 个 值 只 能 在 服务 器 启动 的 时 候 设 置 。 


当 运 行 备用 服务 器 时 ， 你 必须 将 此 参数 设置 为 比 主 服务 器 上 相同 或 更 高 的 值 。 否 则 ， 不 人 允许 
在 备用 服务 器 进行 查询 。 


max_pred_locks_per_transaction ( integer ) 





共享 谓词 锁 表 跟踪 锁定 在 max_pred_locks_per_transaction * (max connections + 
max_prepared_transactions) 对 象 上 例如， 表 ) ; 因此 ， 只 是 许多 不 同 的 对 象 更 可 以 在 任何 
一 个 时 间 锁 定 。 此 参数 控制 对 象 锁定 分 配给 每 个 事务 的 平均 数 ; 个 别 事务 可 以 锁定 多 个 对 象 ， 
只 要 所 有 事务 的 锁 适 合 在 锁 表 中 。 这 不 是 可 以 锁定 的 行 数 ;该 值 是 无 限 的 。 在 默认 情况 下 ， 
64 对 测试 已 经 足够 了 ， 如 果 在 可 串 行 化 事务 中 你 有 接触 许多 不 同 表 的 客户 ， 那 么 您 可 能 需 
增 大 这 个 值 。 此 参数 只 能 在 服务 器 启动 时 设置 。 





18.13. 版 本 和 平台 兼容 性 


18.13.1. 以 前 的 PostgreSQL 版 本 


array_nulls ( boolean ) 


控制 数组 输入 解析 器 是 否 将 未 用 引号 界定 的 NuLL 作为 数组 的 一 个 NULL 元 素 。 默认 为 on 表 
示人 允许 向 数组 中 输入 NULL 值 。 但 8.2 之 前 的 PostgreSQL 版 本 不 支持 这 么 做 ， 因此 将 
把 NuLL 当 作 字符 串 "NULL"。 如 果 希 望 向 后 兼容 这 种 旧式 行为 ， 那么 可 以 设 为 offo 


即使 该 值 被 设 为 off 也 仍然 能 够 创建 包含 NULL 值 的 数组 。 

backslash_quote ( enum ) 

控制 字符 串 文本 中 的 单 引号 是 否 能 够 用 \' 来 表示 。 首选 的 符合 SQL 标准 的 方法 是 将 其 双 写 
(© )， 但 是 PostgreSQL 在 历史 上 也 可 以 用 、\' 来 表示 。 不 过 使 用 \' 容易 导致 安全 漏洞 ， 
因为 在 某 些 多 字 节 字符 集中 存在 最 后 一 个 字 节 等 于 、\ 的 ASCII 值 的 字符 。 如 果 客 户 端 代 码 没 
有 做 到 正确 逃逸 ， 那 么 将 会 导致 SQL 注入 攻击 。 如 果 服 务 器 拒绝 使 用 反 斜 杠 逃逸 来 表示 单 引 
号 的 查询 ， 那 么 就 可 以 避免 这 种 风险 。 backslash_quote 的 可 用 值 是 on (XE V), 

off (总 是 拒绝 )，safe_encoding ( 仅 在 客户 端 字符 集 编码 不 会 在 多 字 节 字符 末尾 包含 、 的 
ASCII 值 时 允许 )。 safe_encoding 是 缺 省 设置 。 

需要 注意 的 是 ， 在 字符 串 文本 符合 SQL 标准 的 情况 下 ，、 没有 任何 其 它 含义 。 这 个 参数 影响 
的 只 是 如 何 处 理 不 符合 标准 的 字符 串 文 本 ， 包括 明确 的 字符 串 逃 逸 语法 ( E'...' )。 


default_with_oids ( boolean ) 


这 个 选项 控制 CREATE TABLE 和 CREATE TABLE as 在 既 没有 声明 with orms 也 没有 声 
BA wiTHouT oros 的 情况 下 ， 是 否 在 新 创建 的 表 中 包含 OID 字 段 。 它 还 决定 SELECT INTO 创建 
的 表 里 面 是 否 包含 OID。 参数 缺 省 是 off ; 在 PostgreSQL 8.0 之 前 缺 省 为 on。 


我 们 反对 在 用 户 表 中 使 用 OID ， 因 此 大 多 数 安 装 应 该 关闭 这 个 变量 。 需要 OID 的 表 应 该 在 创 
建 表 的 时 候 声明 with orms >o 启用 这 个 变量 可 以 与 不 遵循 这 一 行为 的 旧 的 应 用 程序 兼容 。 


escape_string warning ( boolean ) 


打开 的 时 候 ， 如 果 在 普通 的 字符 串 文本 里 ('..…' 语法 ) 出 现 了 一 个 反 斜 打 (、) 并 且 


standard_conforming_strings 被 关闭 ， 那么 就 会 发 出 一 个 警告 。 iki 是 on o 


想 要 使 用 反 斜 杠 作 为 逃逸 的 应 用 程序 应 该 使 用 逃逸 字符 串 语法 ( E'...， ) 进 行 修改 ， 因为 通 的 
字符 串 缺 省 行为 作为 普通 字符 的 反 斜 红 对 待 。 启动 这 个 变量 帮助 找到 需要 修改 的 代码 。 


lo_compat_privileges ( boolean ) 


在 PostgreSQL9.0 之 前 ， 大 对 象 没有 访问 权限 ， 因 此 ， 总 是 被 所 有 用 户 可 读 可 写 。 设置 这 个 
变量 到 on 禁用 新 权限 检查 ， 为 了 兼容 先前 版 本 。 RBS off 。 只 要 超级 用 户 可 以 改变 此 设 
置 。 


设置 这 些 变量 不 会 禁用 所 有 与 大 对 象 相 关 的 安全 检查 一 仅仅 是 在 PostgreSQL 9.0 已 经 改变 了 
的 缺 省 操作 。 比 如 ， 1o_import() 和 lo_export() 不 管 这 些 设 置 都 需要 超级 用 户 权 限 。 


quote_all_identifiers ( boolean ) 


当 数 据 库 生成 SQL， 强 制 引用 所 有 标示 符 ， 即 使 它们 (当前 ) 不 是 关键 字 。 这 也 将 影响 
EXPLAIN 的 输出 以 及 像 pg_get_viewdef 回 数 的 结果 。 参见 pg_dump 和 pg_dumpall 
的 --quote-all-identifiers 选项 。 


sql_inheritance ( boolean ) 


RPE BHA MRS ASHASRANTR. RAZ on ， 这 意味 着 包含 子 表 (A 

te, RARE * BR). MRR off, 则 不 包含 子 表 (因此 ， 假 定 ony 前 级 ) 。SQL 标 
准 需要 包含 子 表 。 因此 off 设置 不 符合 规范 ， 但 是 它 提供 了 PostgreSQL 7.1 版 本 之 前 的 兼容 
性 。 参见 Section 5.8 获 取 更 多 详细 信息 。 


不 赞成 关闭 sql_inheritance ， 因 为 发 现 操 作 有 错误 而 且 违 反 SQL 标 准 。 关于 继承 操作 的 讨论 
在 手册 中 通常 假定 它 是 on 。 


standard_conforming_strings ( boolean ) 


控制 普通 字符 串 文 本 ( '.……' Fe AHRIRSOL ts ERRE EAA. PostgreSQL 9.17 
始 ， 缺 省 是 on 之 前 缺 省 是 off) 。 应 用 可 以 检查 这 个 参数 来 判断 字符 串 文本 如 何 被 处 
E, 这 个 参数 的 出 现 也 建议 明确 使 用 逃逸 字符 串 语法 ( E'...， ) 来 逃逸 字符 。 如 果 应 用 希望 反 
斜 杠 作为 逃逸 字符 对 待 ， 则 使 用 逃逸 字符 串 语 法 (Section 4.1.2.2)。 

synchronize_seqscans ( boolean ) 

这 允许 大 表 进 行 顺序 扫描 以 同步 其 他 的 ， 所 以 并 发 扫描 读 取 同 一 时 间 的 同一 批 ， 从 而 共享 1O 
Ah. 启用 此 功能 后 ， 扫 描 可 能 会 在 表 中 间 开 始 ， 然后 "包装 开始 环绕 "以 覆盖 所 有 的 行 ， 从 
而 同步 已 在 进行 的 扫描 活动 。 这 可 能 导致 没有 oRDER BY 子 句 的 查询 返回 排序 行 的 不 可 预测 变 
bo 设置 这 个 参数 为 off 确保 预 8.3 行 为 ， 其 中 一 个 顺序 打 描 总 是 从 表 的 开头 开始 。 缺 省 


i=} 
FE ON o 


=~ 


18.13.2. 平台 和 客户 端 兼 容 


transform_null_equals ( boolean ) 


如 果 打 开 ， 那 么 表达 式 expr =NULL 或 者 NULL = _expr_ 将 被 当做 _expr_ IS NULL 
理 ， 也 就 是 说 ， 如 果 _expr_ 得 出 NULL 值 则 返回 真 ， 否 则 返回 假 。 正确 的 SQL 标准 兼容 
的 _expr_ = NULL 行 为 总 是 返回 NULL( 未 知 )。 因此 这 个 选项 缺 省 是 off o 


Ait, Microsoft Access 里 的 过 滤 表 单 生成 的 查询 好 像 使 用 的 是 _expr。 = NULL 测 试 NULL 
， 因 此 ， 如 果 你 使 用 这 个 界面 访问 数据 库 ， 你 可 能 想 把 这 个 选项 打开 。 因为 形 如 expr = 
NULL 的 表达 式 总 是 返回 NULL 《使 用 SQL 标准 说 明 ) ， 它们 不 是 很 有 用 而 且 在 应 用 中 也 不 常 
L, 因此 这 个 选项 实际 上 没有 什么 害处 。 但 是 新 用 户 常常 在 涉及 NULL 的 表达 式 语 义 上 感到 糊 
涂 ， 因此 缺 省 时 不 打开 这 个 选项 


请 注意 这 个 选项 只 影响 = NULL gan 不 包括 其 它 FOS fiate 与 一 些 涉及 等 号 操作 符 
的 表达 式 计 算 ( 比 如 IN )。 因此 ， 选项 不 是 垃圾 程序 的 普通 修复 。 


请 参考 Section 9.2 获 取 相 关 信 息 。 


18.14. Error Handling 


exit_on_error ( boolean ) 

如 果 为 真 ， 那 么 任何 错误 都 将 终止 当前 事务 。 缺 省 时 ， 设 置 为 假 ， 所 以 只 有 致命 错误 将 终止 
会 话 。 

restart_after_crash ( boolean ) 

当 缺 省 设置 为 真 时 ，PostgreSQL 将 在 后 端 崩 溃 后 自动 重新 初始 化 。 设置 这 些 值 为 真 往往 是 优 


化 数据 库 的 最 佳 方式 。 然 而 ， 在 某 些 情况 下 ， 比 如 当 PostgreSQL 正 由 集群 调用 时 ， 它 可 能 禁 
用 和 启动 非常 有 益 ， 使 得 集群 可 以 得 到 控制 并 采取 其 认为 适当 的 任何 行动 。 


18.15. MEHN 


下 面 的 "参数 "是 只 读 的 ， 它 们 是 在 编译 或 安装 PostgreSQL 的 时 候 决定 的 。 因此 ， 他 们 被 排除 
在 了 postgresql.conf 文件 之 外 。 这 些 选项 报告 各 种 PostgreSQL 某 些 应 用 可 能 感 兴趣 的 行 
为 ， 特别 是 管理 性 的 前 端 。 


block_size ( integer ) 


报告 磁盘 块 的 大 小 。 它 是 由 编译 服务 器 时 BLcksz 的 值 确定 的 。 缺 省 值 是 8192 4, 有 些 配 
冒 变 量 的 含义 (比如 shared_buffers) 会 被 block_size 影响 。 参阅 Section 18.4 获 取信 息 。 


integer_datetimes ( boolean ) 


报告 PostgreSQL 是 否 在 编译 时 打开 了 64 位 整数 日 期 和 时 间 。 这 是 当 编译 PostgreSQL 时 ， 
通过 配置 选项 --disable-integer-datetimes 禁用 的 。 缺 省 值 是 On o 


lc_collate ( string ) 


报告 文本 数据 排序 使 用 的 区 域 。 参 阅 Section 22.1 获 取 更 多 信息 。 该 值 是 在 初始 化 数据 库 集 群 
的 时 候 确定 的 。 


lc_ctype ( string ) 


报告 决定 字符 分 类 的 区 域 。 参 闵 Section 22.1 获 取 更 多 信息 。 该 值 是 在 数据 库 集 群 初始 化 的 时 
候 决定 的 。 通常 它 和 lc_collate 一 样 ， 但 是 可 以 为 特殊 应 用 设置 成 不 同 的 值 。 


max_function_args ( integer ) 
RENMSMNRATH Ce wiFAR A at FuNc_MAx_ARGS 值 决定 的 。 缺 省 是 100。 
max_identifier_length ( integer ) 


报告 最 大 标识 符 长 度 。 它 是 由 编译 服务 器 时 的 NAMEDATALEN 值 减 一 决定 的 。 NAMEDATALEN 的 
缺 省 值 是 64 ; 因此 max_identifier_length 的 缺 省 是 63。 当 使 用 多 字 节 编码 时 小 于 63 字 符 。 


max_index_keys ( integer ) 
报告 最 大 索引 键 字 的 个 数 。 它 是 由 编译 服务 器 时 的 INDEX_MAX_KEYS 值 决定 的 。 缺 省 值 是 32。 


segment_size ( integer ) 


报告 可 以 存储 在 一 个 文件 段 中 的 块 (页) 数 。 当 构建 服务 器 时 ， 它 是 由 ReLsec_size 的 值 决 
定 的 。 字 节 中 段 文 件 的 最 大 大 小 等 于 segment_size FEL block_size ; 默认 情况 下 为 1GB。 


server_encoding ( string ) 


报告 数据 库 编码 (字符 集 )。 这 是 在 创建 数据 库 的 时 候 决 定 的 。 通常 ， 客 户 端 只 需要 天 心 
client_encoding 的 值 。 


server_version ( string ) 

报告 服务 器 版 本 号 。 它 是 由 编译 服务 器 时 的 PG6_vVERSION 值 决定 的 。 
server_version num ( integer ) 

报告 服务 器 版 本 号 的 整数 值 。 它 是 由 编译 服务 器 时 的 P6_vERSION_NUM 值 决定 的 。 
wal_block_size ( integer ) 


报告 WAL 磁 龟 块 大 小 。 当 构建 服务 时 ， 它 是 通过 xLo6_BLcksz 的 值 决定 的 。 MAAN 8192F 
节 。 
wal_segment_size ( integer ) 


报告 在 WAL 段 文件 中 块 (页 ) 数 。 字 节 中 WAL 段 文件 总 的 大 小 等 于 wal_segment_size 乘 
以 wal_block_size ; 缺 省 是 16MB。 参 见 Section 29.4 获取 更 多 详细 信息 。 


18.16. 目 定 义 选 项 


这 个 特性 用 来 允许 那些 由 附加 模块 添加 (比如 过 程 语言 ) 的 选项 ， 通常 PostgreSQL 并 不 知道 它 
们 。 这 样 ， 扩 展 的 模块 就 可 以 用 标准 的 方式 配置 。 

自 定 义 选 项 有 两 部 分 名 称 : 一 个 扩展 名 ， 一 个 点 ， 参数 名 称 合适 ， 类 似 于 SQL 中 限定 名 称 。 
例子 是 plpgsql.variable_conflict o 

因为 自 定义 选项 可 能 需要 在 没有 加 载 相 关 扩 展 模块 的 过 程 中 进行 设置 ， PostgreSQL 将 接受 
任何 两 部 分 参数 名 称 的 设置 。 这 样 的 变量 被 视 为 占 位 符 ， 并 没有 功能 ， 直 到 模块 定义 它们 被 
加 载 。 当 加 载 一 个 扩展 模块 时 ， 这 将 增加 它 的 变量 定义 ， 根 据 这 些 定义 转换 任何 占 位 符 值 ， 
以 及 任何 以 扩展 名 开头 的 未 确认 的 占 位 符 发 出 的 警告 。 


18.17. 开发 人 员 选 项 


下 面 的 选项 目的 是 在 PostgreSQL 代 码 上 使 用 ， 并 且 在 某 些 情况 下 可 以 帮助 恢复 严重 损坏 了 的 
数据 库 。 在 生产 环境 里 没有 理由 使 用 这 些 设置 。 因 此 ， 我 们 把 他 们 从 样 例 postgresql.conf X 
件 中 排除 了 出 去 。 请 注意 许多 这 些 选项 要 求 特殊 的 源 代码 编译 标志 才能 运转 。 


allow_system_table_mods ( boolean ) 





允许 修改 系统 表 的 结构 。 它 可 以 被 initdb 使 用 。 这 个 值 只 能 在 服务 器 启动 的 时 候 设置 。 
debug_assertions ( boolean ) 


打开 各 种 断言 检查 。 这 是 调试 助手 。 如 果 你 经 万 了 奇怪 的 问题 或 者 骨 溃 ， 那么 你 可 能 会 想 把 
这 个 打开 ， 因 为 它 可 能 暴露 编程 的 错误 。 要 使 用 这 个 选项 ， 我 们 必须 在 编译 PostgreSQL 的 时 
候 定义 宏 USE_ASSERT_CHECKING (通过 configure 选项 --enable-cassert 完成 )。 请 注意 ， 如 果 
启用 断言 选项 编译 PostgreSQL， 那 么 debug_assertions 缺 省 就 是 on 


ignore_system_indexes ( boolean ) 


读 取 系统 表 时 忽略 系统 素 引 (但 是 修改 系统 表 时 依然 同时 修改 素 引 )。 这 个 在 从 系统 索引 被 破 
坏 的 表 中 恢复 数据 的 时 候 很 有 用 。 该 参数 不 能 在 会 话 启 动 之 后 修改 。 


post_auth_delay ( integer ) 


如 果 为 非 需 ， 那 么 在 一 个 新 的 服务 器 进程 启动 并 完成 认证 过 程 之 后 ， 就 会 延迟 这 人 么 多 秒 。 这 
样 就 给 开发 人 员 一 个 机 会 用 调试 器 附着 在 一 个 服务 器 进程 上 。 该 参数 不 能 在 会 话 启 动 之 后 修 
改 。 

pre_auth_delay ( integer ) 

如 果 为 非 需 ， 那 么 在 一 个 新 的 服务 器 进程 派生 出 来 之 后 ， 就 会 延迟 这 么 多 秒 ， 然 后 才 会 继续 
认证 过 程 。 这 样 就 给 开发 人 员 一 个 机 会 用 调试 器 附着 在 一 个 服务 器 进程 上 跟踪 认证 里 面 的 异 
常 行为 。 这 个 选项 只 能 在 服务 器 启动 的 时 候 或 者 在 postgresql.conf 文件 里 设置 。 


trace_notify ( boolean ) 


A LISTEN 和 NoTIFY 命令 生成 大 量 调试 输出 。 client_min_messages 或 者 log_min_messages 


必须 是 DEBU61 o 或 者 更 低 才 能 把 这 些 输出 分 别 发 送 到 客户 端 或 者 服务 器 日 志 。 
trace_recovery_messages ( enum ) 


启用 恢复 相关 的 调试 输出 的 日 志 记 录 ， 否 则 不 会 被 记录 。 该 参数 允许 用 户 覆 盖 
log_min_messages 的 正常 设置 ， 但 仅 限于 特定 消息 。 打 算 调 试 双 机 热 备 时 使 用 。 有 效 


值 DEBUG5 , DEBUG4 , DEBUG3 , DEBUG2 , DEBUG1 和 Loc. 默认 情况 下 ， Lo6 不 影响 记录 决 


定 。 其 他 值 会 导致 恢复 相关 的 记录 优先 级 或 更 高 的 调试 消息 ， 虽 然 他 们 有 Los 的 优先 级 ;对 
于 log_min_messages 常用 的 设置 eg elias 这 些 到 服务 器 日 志 。 这 个 参数 只 能 
在 postgresql.conf 文件 或 者 服务 器 命令 行 中 设 


trace_sort ( boolean ) 


如 果 打 开 ， 发 出 在 排序 操作 中 的 资源 使 用 的 有 关 信 息 。 这 个 选项 只 有 在 编译 PostgreSQL 的 时 
候 定义 了 TRACE_SORT 宏 的 时 候 才 可 用 (不 过 ， 目 前 TRACE_soRT 缺 省 就 是 定义 了 的 )。 


trace_locks ( boolean ) 


如 果 打 开 ， 发 出 关于 锁 用 法 信息 。 信 息 转 储 包 括 锁定 操作 的 类 型 ， 锁 定 类 型 和 被 锁定 或 解锁 
的 对 象 的 唯一 标识 符 。 还 包括 已 授权 在 该 对 象 上 的 锁 类 型 以 及 等 待 此 对 象 上 的 锁 类 型 的 位 掩 
码 。 对 于 每 个 锁 类 型 的 授予 锁 和 等 待 锁 的 数量 计数 以 及 总 数 都 被 转 侍 。 该 日 志文 件 输出 的 例 
子 在 这 显示 
LOG: LockAcquire: new: lock(@xb7acd844) id(24688, 24696,0,0,0,1) 
grantMask(0) req(0,0,0,0,0,0,0)=0 grant(0,0,0,0,0,0,0)=0 
wait(0) type(AccessShareLock) 
LOG: GrantLock: lock(®xb7acd844) id(24688, 24696,0,0,0,1) 
grantMask(2) req(1,0,0,0,0,0,0)=1 grant(1,0,0,0,0,0,0)=1 
wait(0) type(AccessShareLock) 
LOG: UnGrantLock: updated: lock(0xb7acd844) id(24688, 24696,0,0,0,1) 
grantMask(0) req(0,0,0,0,0,0,0)=0 grant(0,0,0,0,0,0,0)=0 
wait(0) type(AccessShareLock) 
LOG: CleanUpLock: deleting: lock(0xb7acd844) id(24688,24696,0,0,0,1) 
grantMask(0) req(0,0,0,0,0,0,0)=0 grant(0,0,0,0,0,0,0)=0 
wait(0) type( INVALID) 


结构 详情 可 以 从 src/include/storage/lock.h 里 找到 。 

当 编译 PostgreSQL 时 ， 如 果 定 义 了 Lock_pEBUG 宏 指令 ， 则 只 能 使 用 这 个 参数 。 
trace_lwlocks ( boolean ) 

如 果 打 开 ， 则 发 出 轻 量 级 锁 用 法 信息 。 轻 量 级 锁 主 要 提供 访问 互 斥 以 共享 内 存 数 据 结构 。 
当 编 译 PostgreSQL 时 ， 如 果 定 义 了 Lock_pEBu6 宏 指令 ， 则 只 能 使 用 这 个 参数 。 
trace_userlocks ( boolean ) 

如 果 打 开 ， 则 发 出 关于 用 户 锁 用 法 的 信息 。 输 出 类 似 于 trace_locks ， 仅仅 为 了 咨询 锁 。 
当 编 译 PostgreSQL 时 ， 如 果 定 义 了 Lock_pEBu6 宏 指令 ， 则 只 能 使 用 这 个 参数 。 
trace_lock_oidmin ( integer ) 

如 果 设 置 ， 不 跟踪 低 于 这 个 OID 的 表 锁 。 (为 了 避免 系统 表 输 出 ) 

当 编 译 PostgreSQL 时 ， 如 果 定 义 了 Lock_pEBUG 宏 指令 ， 则 只 能 使 用 这 个 参数 。 


trace_lock_table ( integer ) 


无 条 件 跟踪 表 (OID) 上 的 锁 。 

当 编 译 PostgreSQL 时 ， 如 果 定 义 了 Lock_pEBUG 宏 指令 ， 则 只 能 使 用 这 个 参数 。 
debug_deadlocks ( boolean ) 

当 死 锁 发 生 超时 ， 如 果 设 置 ， 那 么 各 份 所 有 当前 锁 的 信息 。 

当 编 译 PostgreSQL 时 ， 如 果 定 义 了 Lock_pEBu6 宏 指 令 ， 则 只 能 使 用 这 个 参数 。 
log_btree_build_stats ( boolean ) 

如 果 设 置 ， 日 志 系统 资源 用 法 在 各 种 B-tree 操 作 上 统计 (内 存 和 CPU)。 

当 编 译 PostgreSQL 时 ， 如 果 定 义 了 BTREE_BUILD_STATS 宏 指 令 ， 则 只 能 使 用 这 个 参数 。 
wal_debug ( boolean ) 


打开 WAL 相关 的 调试 输出 。 只 有 在 编译 PostgreSQL 的 时 候 打 开 了 _wAL_pEBu6 宏 定义 的 情况 
下 ， 这 个 选项 才 可 用 。 


ignore_checksum_failure ( boolean ) 
WSR É adata checksums， 已 经 受到 影响 。 


在 读 期 间 校 验 失败 检测 导致 PostgreSQL 报 告 错 误 ， 终止 当前 事务 。 设 

置 ignore_checksum_failure 的 原因 系统 忽略 失败 (但 仍然 报告 一 个 警告 7 并 且 继续 处 理 。 
这 种 行为 可 能 造成 死机 ， 传 播 或 隐藏 的 崩溃 ， 或 其 他 严重 的 问题 。 然而 ， 如 果 块 头 仍然 是 清 
醒 的 ， 它 可 能 允许 你 获取 错误 并 且 检 索 仍然 完好 无 损 出 现在 表 中 未 处 理 元 组 。 如 果 头 部 崩 
溃 ， 即 使 启用 这 个 选项 也 将 报告 一 个 错误 。 默认 设置 为 off ， 它 只 能 由 超级 用 户 改变 。 


zero_damaged_pages ( boolean ) 


如 果 侦 测 到 一 个 损坏 了 的 页 面 头 通常 会 导致 PostgreSQL 报 告 一 个 错误 ， 并 且 退 出 当前 事务 。 
把 zero_damaged_pages 设置 为 on 则 例 系 统 报告 一 个 警告 ， 把 内 存 中 损坏 的 页 面 填充 需 ， 然 后 
继续 处 理 。 这 种 行为 会 破坏 数据 ， 也 就 是 所 有 在 已 经 损坏 页 面 上 的 行 。 但 是 它 人 允许 你 绕 开 坏 
页 面 然 后 从 表 中 尚 存 的 未 损坏 页 面 上 继续 检索 数据 行 。 因此 它 在 因为 硬件 或 者 软件 错误 导致 
的 骨 溃 中 进行 恢复 是 很 有 用 的 。 通常 你 不 应 该 把 它 设 置 为 on ， 除非 你 已 经 彻底 放弃 从 崩溃 
的 页 面 中 恢复 数据 。 需 填 充 页面 不 强制 到 磁盘 ， 所 以 建议 重新 创建 表 或 再 次 关闭 此 参数 之 前 
的 索引 。 缺 省 的 设置 是 off ， 并 且 只 有 超级 用 户 可 以 改变 它 。 


18.18. 短 选 项 


为 了 方便 起 见 ， 这 里 还 为 一 些 参数 提供 了 好 多 单字 母 命令 行 选 项 开关 。 
其 中 一 些 选 项 仅仅 是 因为 历史 原因 而 存在 的 ， 尽 管 它 们 是 单字 母 选 项 ， 


18-2 里 描述 。 
不 表示 它们 很 常用 。 


Table 18-2. 短 选 项 键 字 





短 选 项 
-A X debug_assertions = _x_ 
B x shared_buffers = _x_ 
"i ga log_min_messages = DEBUG 
-e datestyle = euro 
Slo) Ae own § enable_bitmapscan = off 
=f, =m, enable_indexscan = off 
She, Eo, enable_nestloop = off 
hs, =n enable_seqscan = off 
-F fsync = off 
Si CxS listen_addresses = _x_ 
-i listen_addresses = '*' 
ale xe unix_socket_directories 
zil ssl = on 
SNE DES max_connections = _x_ 
-0 allow_system_table_mods 
=e mxa port = _x_ 
-P ignore_system_indexes = 
-S log_statement_stats = on 
SS ke work_mem = _X_ 
-tpa , -tpl, log_parser_stats = on 
-te log_executor_stats = on 
ap 5 post_auth_delay = _x_ 


enable_indexonlyscan 
enable_tidscan 


log_planner_stats 


enable_mergejoin 


它们 在 下 面 的 Table 
但 是 并 


enable_hashjoin 


omm, 


off 


on 


on , 
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© 19.4. 用 户 认证 


当 客 户 端 与 数据 库 服 务 器 连接 时 ， 它 将 声明 以 哪个 PostgreSQL 数据 库 用 户 身份 进行 连接 ， 就 
像 我 们 登录 一 台 Unix 计算 机 一 样 。 在 SQL 环境 里 ， 活动 的 数据 库 用 户 名 决定 数据 库 对 象 的 
各 种 访问 权限 (参阅 Chapter 20)。 因此 ， 实 际 上 我 们 要 限制 的 是 用 户 可 以 连接 的 数据 库 。 


Note: 如 Chapter 20 里 解释 的 那样 ，PostgreSQL 实际 上 用 "角色 "的 概念 管理 权限 。 在 本 
章 里 ， 我 们 用 数据 库 用 户 表 示 " 带 有 LoGIN 权限 的 角色 "。 


认证 是 数据 库 服务 器 识别 客户 端的 过 程 。 它 通过 一 些 手段 判断 是 否 人 允许 此 客户 端 (或 者 运行 这 
个 客户 端的 用 户 ) 与 它 所 声明 的 数据 库 用 户 名 进行 绑 定 。 


PostgreSQL 提 供 多 种 不 同 的 客户 端 认 证 方式 。 这 些 方式 用 来 认证 特定 的 客户 端 连接 ， 可 以 基 
于 (客户 端 ) 的 主机 地 址 、 数 据 库 、 用 户 选 择 认证 方法 。 


PostgreSQL 数 据 库 用 户 名 在 逻辑 上 是 和 服务 器 运行 的 操作 系统 用 户 名 相互 独立 的 。 如 果 某 个 

服务 器 的 所 有 用 户 在 那 台 服务 器 机 器 上 也 有 帐号 ， 那 么 给 数据 库 用 户 赋 与 操作 系统 用 户 名 是 
意义 的 。 不 过 ， 一 个 接收 远程 访问 的 服务 器 很 有 可 能 有 许多 没有 本 地 操作 系统 帐号 的 用 

户 ， 因而 在 这 种 情况 下 数据 库 用 户 和 操作 系统 用 户 名 之 间 不 必 有 任何 联系 。 


19.1. pg _hba.conf 文件 


客户 端 认证 是 由 一 个 配置 文件 (通常 名 为 pg_hba.conf ) 控 制 的 ， 它 存放 在 数据 库 集 群 的 数据 目 
录 里 。HBA 的 意思 是 "host-based authentication"， 也 就 是 基于 主机 的 认证 。 在 initdb 初始 
化 数据 目录 的 时 候 ， 它 会 安装 一 个 缺 省 的 pg_hba.conf 文件 。 不 过 我 们 也 可 以 把 认证 配置 文 
件 放 在 其 它 地 方 ; 参阅 hba_file 配 置 参 数 。 


pg_hba.conf 文件 的 常用 格式 是 一 组 记录 ， 每 行 一 条 。 空 白 行将 被 忽略 ， 井 号 # 开头 的 注释 
也 被 忽略 。 记 录 不 能 跨行 存在 。 一 条 记录 是 由 若干 用 空格 和 /或 制 表 符 分隔 的 字段 组 成 。 如 果 
字段 用 引号 包围 ， 那 么 它 可 以 包含 空白 。 在 数据 库 、 用 户 或 地 址 文件 中 引用 一 个 关键 词 
(如 ， all 或 replication ) 使 这 个 词 失去 它 的 特殊 角色 ， 只 是 用 这 个 名 字 匹 配 一 个 数据 
库 、 用 户 或 主机 。 

每 条 记录 声明 一 种 连接 类 型 、 一 个 客户 端 IP 地 址 范围 (如 果 和 连接 类 型 相关 的 话 )、 一 个 数据 
库 名 、 一 个 用 户 名 字 、 对 匹配 这 些 参数 的 连接 使 用 的 认证 方法 。 第 一 条 匹配 连接 类 型 、 客户 
端 地 址 、 连 接 请 求 的 数据 库 名 和 用 户 名 的 记录 将 用 于 执行 认证 。 这 个 义理 过 程 没有 "跨越 "或 
者 "回头 "的 说 法 : 如 果 选 择 了 一 条 记录 而 且 认 证 失败 ， 那么 将 不 再 考虑 后 面 的 记录 。 如 果 没 
有 匹配 的 记录 ， 那 么 访问 将 被 拒绝 。 


每 条 记录 可 以 是 下 面 七 种 格式 之 一 : 


local database user auth-method_ [°_auth-options_~] 


host _database_ _user_ _address_ _auth-method_ [°_auth-options_~] 
hostssl _database_ _user_ _address_ _auth-method_ [°_auth-options_~] 
hostnossl _database_ _user_ _address_ _auth-method_ [°_auth-options_~] 
host _database_ _user_ _IP-address_ _IP-mask_ _auth-method_ [°_auth-options_~] 
hostssl _database_ _user_ _IP-address_ _IP-mask_ _auth-method_ [°_auth-options_~] 
hostnossl _database_ _user_ _IP-address_ _IP-mask_ _auth-method_ [°_auth-options_~] 


Aoo; 
各 个 字段 的 含义 如 下 : 
local 


这 条 记录 匹配 企图 通过 Unix 域 套 接 字 进 行 的 连接 。 没 有 这 种 类 型 的 记录 ， 就 不 允许 Unix 域 
套 接 字 的 连接 。 


host 
这 条 记录 匹配 企图 通过 TCP/IP 进行 的 连接 。 host 记录 匹配 SSL 和 非 SSL 的 连接 请 求 。 


Note: 除非 服务 器 带 着 合适 的 listen_addresses 配 置 参 数值 启动 ， 否则 将 不 可 能 进行 远程 
AY TCP/IP 连接 ， 因 为 缺 省 的 行为 是 只 监听 本 地 自 环 地 址 localhost 的 连接 。 








hostssl 


这 条 记录 匹配 企图 使 用 TCP/IP 的 SSL 连接 。 但 必须 是 使 用 SSL 加 密 的 连接 。 


要 使 用 这 个 选项 ， 编 译 服务 器 的 时 候 必 须 打 开 SSL 支 持 。 而 且 在 服务 器 启动 的 时 候 必须 打 
开 ss| 配 置 选项 (参阅 Section 17.9) 


hostnossl 


这 条 记录 与 hostssl 行为 相反 : 它 只 匹配 那些 在 TCP/IP 上 不 使 用 SSL 的 连接 请 求 。 


_database_ 


声明 记录 所 匹配 的 数据 库 名 称 。 值 all 表明 该 记录 匹配 所 有 数据 库 ， 14 sameuser 表示 如 果 
被 请 求 的 数据 库 和 请 求 的 用 户 同名 ， 则 匹配 。 值 samerole 表示 请 求 的 用 户 必 须 是 一 个 与 数据 
库 同名 的 角色 中 的 成 员 。 ( samegroup 是 一 个 已 经 废 奔 了 ， 但 目前 仍然 被 接受 的 samerole 同 

义 词 。) 对 samerole 来 说 ， 不 认为 超级 用 户 是 角色 的 一 个 成 员 ， 除 非 他 们 明确 的 是 角色 的 成 

A, 直接 的 或 间接 的 ， 并 且 不 只 是 由 于 超级 用 户 。 值 replication 表示 如 果 请 求 一 个 复制 链 

接 ， NILA 〈 注 意 复制 链接 不 表示 任何 特定 的 数据 库 ) 。 在 其 它 情 况 里 ， 这 就 是 一 个 特定 的 
PostgreSQL 数 据 库 名 字 。 可 以 通过 用 逗号 分 隔 的 方法 声明 多 个 数据 库 ， 也 可 以 通过 前 

级 @ 来 声明 一 个 包含 数据 库 名 的 文件 。 


_user_ 


为 这 条 记录 声明 所 匹配 的 数据 库 用 户 。 值 all 表明 它 匹配 于 所 有 用 户 。 否 则 ， 它 就 是 特定 数 
据 库 用 户 的 名 字 或 者 是 一 个 前 级 + 的 组 名 称 。 请 注意 ， 在 PostgreSQL 里 ， 用 户 和 组 没有 真 
正 的 区 别 ， + 实际 上 只 是 意味 着 "匹配 任何 直接 或 者 间接 属于 这 个 角色 的 成 员 "， 而 没有 + 记 
号 的 名 字 只 匹配 指定 的 角色 。 为 此 ， 超 级 用 户 如 果 明 确 是 角色 的 成 员 ， 也 只 算是 一 个 角色 的 
成 员 ， 直 接 的 或 间接 的 ， 而 不 只 是 由 于 超级 用 户 。 多 个 用 户 名 可 以 通过 用 逗号 分 隔 的 方法 声 
明 。 一 个 包含 用 户 名 的 文件 可 以 通过 在 文件 名 前 面前 级 @ 来 声明 。 


_address_ 


声明 这 条 记录 匹配 的 客户 端 机 器 地 址 。 这 个 文件 可 以 包含 主机 名 、IP 地 址 范围 或 下 面 提 到 的 
特殊 关键 字 之 一 。 


IP 地 址 用 标准 的 带 有 CIDR 掩 码 长 度 的 点 分 十 进 制 声 明 。 捧 码 长 度 表 示 客 户 端 IP 地 址 必须 匹 
配 的 高 位 二 进 制 位 数 。 在 给 出 的 IP 地 址 里 ， 这 个 长 度 的 右边 的 二 进 制 位 应 该 为 需 。 在 IP 地 
址 、/ 、 CIDR 扼 码 长 度 之 间 不 能 有 空白 。 


典型 的 这 种 方式 指定 的 IP 地 址 范围 举例 : 172.26.143.89/32 表示 一 个 主机 ， 

172.20.143.0/24 表示 一 个 小 子 网 ， 16.6.96.9/16 表示 一 个 大 子 网 。 .6.9.9/e 代表 所 有 IPv4 
地 址 ， ::/@ 代表 所 有 IPv6 地 址 。 要 声明 单个 主机 ， 给 IPv4 地 址 声明 CIDR 掩 码 32 ， 给 
IPv6 地 址 声明 128 。 不 要 在 地 址 中 省 略 结尾 的 0 。 


以 IPv4 格式 给 出 的 IP 地 址 会 匹配 那些 拥有 对 应 地 址 的 IPv6 连接 ， 比 如 127.0.0.1 将 匹配 
IPv6 地 址 : :ffff:127.0.0.1 。 一 个 以 IPv6 格式 给 出 的 记录 将 只 匹配 IPv6 连接 ， 即使 对 应 的 
地 址 在 IPv4-in-IPv6 范围 内 。 请 注意 如 果 系 统 的 C 库 不 支持 IPv6 地 址 ， 那么 IPv6 的 格式 将 
被 拒绝 。 


你 也 可 以 写 all 来 匹配 所 有 IP 地 址 ， Samehost 来 匹配 任意 服务 器 IP 地 址 ， 或 Samenet 来 匹 
配 任何 服务 器 直接 连接 到 的 子 网 的 任意 地 址 。 


如 果 指 定 了 主机 名 (不 是 IP 地 址 或 作为 潜在 主机 名 处 理 的 特殊 关键 字 ) ， 那么 该 名 称 与 客户 
端 IP 地 址 进行 反 向 名 称 解 析 的 结果 进行 比较 (例如 ， 如 果 使 用 了 DNS， 那么 是 反 向 DNS 坦 
E) 。 主 机 名 的 比较 是 大 小 写 无 关 的 。 如 果 有 一 个 匹配 ， 那 么 正 向 名 称 解 析 (例如 ， 正 向 
DNS 查 找 ) 在 主机 名 上 执行 ， 以 检查 是 否 有 解析 的 地 址 等 于 客户 端 IP 地 址 。 如 果 双 向 都 匹 
配 ， 那 么 这 个 条 目 被 认为 是 匹配 的 。 (在 pg_hba.conf 中 使 用 的 主机 名 应 该 是 客户 端 |P 地 址 
返回 的 地 址 到 名 称 (address-to-name) 解析 的 那个 ， 否则 这 行将 不 被 匹配 。 某 些 主机 名 数据 
库 人 允许 一 个 IP 地 址 关联 多 个 主机 名 ， 但 是 当 要 求解 析 一 个 IP 地 址 时 ， 操 作 系 统 将 只 返回 一 个 
主机 名 。) 


主机 名 规范 以 一 个 点 ( ，) 开 关 ， 匹 配 一 个 实际 主机 名 后 级 。 所 以 .example.com 将 匹 


配 foo.example.com (但 不 只 是 example.com ) o 


当主 机 名 在 pg_hba.conf 中 指定 时 ， 你 应 该 确保 那个 名 字 解 析 是 相当 快 的 。 它 将 比 建立 一 个 
本 地 名 字 解 析 缓 存 (如 nscd ) 有 优势 。 同 样 ， 你 可 能 希望 启用 配置 参数 log_hostname KH 
看 客户 端 主机 名 ， 而 不 是 日 志 中 的 IP 地 址 。 


有 时 ， 用 户 想 知道 为 什么 主机 名 用 这 个 带 有 两 个 名 字 解 析 和 要 求 反 向 查找 IP 地 址 的 看 起 来 复 
条 的 方式 处理 ， 这 有 时 没有 设置 或 者 指向 一 些 不 受 欢迎 的 主机 名 。 效 率 是 首要 的 : 一 个 连接 
请 求 需要 两 个 解析 器 查找 当前 客户 端 地 址 。 如 果 那 个 地 址 有 解析 器 问题 ， 那 么 就 只 是 客户 端 
问题 。 一 个 假想 的 可 供 选 择 的 只 做 正 向 查找 的 实现 ， 将 在 每 个 连接 请 求 时 必须 解 

析 pg_hba.conf 中 提 到 的 每 个 主机 名 。 这 样本 身 就 是 缓慢 的 。 并 且 如 果 有 一 个 主机 名 有 解析 
问题 ， 那 么 所 有 主机 名 都 会 有 问题 。 


另外 ， 要 实现 后 级 匹配 功能 必须 要 一 个 反 向 查找 ， 因 为 实际 客户 端 主机 名 需要 是 已 知 的 ， 为 
了 它 对 模式 匹配 。 

请 注意 ， 这 个 行为 与 其 他 受 欢迎 的 主机 基于 名 称 访问 控制 的 实现 是 一 致 的 ， 比 如 Apache 
HTTP Server 和 TCP Wrappers. 

这 些 字 段 只 适用 于 host , hostssl , hostnossl 记录 。 

_IP-address_~ ~_IP-mask_ 

这 些 方法 可 以 用 于 作为 _CIDR-address_ 表示 法 的 替补 。 它 不 是 声明 掩 码 的 长 度 ， 而 是 在 另外 


一 个 字段 里 声明 实际 的 捧 码 。 比 如 ， 255.0.0.0 表示 IPv4 CIDR HAKE 8, 
而 255.255.255.255 表示 CIDR Wa KE 32 。 


这 些 字段 只 适用 于 host , hostssl , hostnossl 记录 。 
_auth-method_ 


声明 连接 匹配 这 条 记录 的 时 候 使 用 的 认证 方法 。 可 能 的 选择 在 下 面 简 介 ， 详细 情况 在 Section 
19.3 中 介绍 。 


trust 


无 条 件 地 允许 连接 。 这 个 方法 允许 任何 可 以 与 PostgreSQL 数据 库 服务 器 连接 的 用 户 以 他 们 期 
望 的 任意 PostgreSQL 数据 库 用 户 身 份 进行 连接 ， 而 不 需要 口令 或 任何 其 他 认证 。 参 
阅 Section 19.3.1 获 取 细 节 。 


reject 


无 条 件 地 拒绝 连接 。 常 用 于 从 一 个 组 中 "过 滤 " 某 些 主机 ， 例 如 ， 一 个 拒绝 行 能 够 从 连接 中 锁 
定 一 个 指定 的 主机 ， 而 稍 后 的 行 允 许 指定 网 络 中 的 剩余 的 主机 连接 。 


md5 

要 求 客 户 端 提 供 一 个 MD5 加 密 的 口令 进行 认证 。 参 阅 Section 19.3.2 获 取 细 节 。 

password 

要 求 客户 端 提 供 一 个 未 加 密 的 口令 进行 认证 。 因 为 口令 是 以 明文 形式 在 网 络 上 传递 的 ， 所 以 
我 们 不 应 该 在 不 安全 的 网 络 上 使 用 这 个 方式 。 参 阅 Section 19.3.2 获 取 细 节 。 

gss 

使 用 GSSAPI 认 证 用 户 。 这 只 能 用 于 TCP/IP 连 接 。 参 阅 Section 19.3.3 获 取 细 节 。 

sspi 

使 用 SSPI 认 证 用 户 。 这 只 能 在 Windows 上 使 用 。 参 阅 Section 19.3.4 获 取 细 节 。 

krb5 

FA Kerberos V5 认证 用 户 。 只 有 在 进行 TCP/IP 连接 的 时 候 才 能 用 。 参阅 Section 19.3.5 获 取 
细节 。 

ident 

获取 客户 的 操作 系统 名 然后 检查 该 用 户 是 否 匹 配 要 求 的 数据 库 用 户 名 ， 方法 是 用 户 的 身份 通 
过 与 运行 在 客户 端 上 的 ident 服务 器 连接 进行 判断 的 。 Ident 认 证 只 在 进行 TCP/IP 连 接 的 时 候 
才能 用 。 当 指定 本 地 连接 时 ， 将 使 用 peer 认 证 。 参阅 Section 19.3.6 获 取 细 节 。 


peer 


为 操作 系统 获取 客户 端 操 作 系 统 用 户 名 ， 并 检查 该 用 户 是 否 匹配 要 求 的 数据 库 用 户 名 。 该 方 
法 只 适用 于 本 地 连接 。 参 阅 Section 19.3.7 获 取 细 节 。 


ldap 
使 用 LDAP 服 务 器 进行 认证 。 参 阅 Section 19.3.8 获 取 细 节 。 
radius 
使 用 RADIUS 服 务 器 进行 认证 ， 参 阅 Section 19.3.9 获 取 细 节 。 


cert 


使 用 SSL 客 户 端 证 书 进行 认证 。 参 阅 Section 19.3.103 Ra 4. 
pam 


使 用 操作 系统 提供 的 可 插入 认证 模块 服务 (PAM) 来 认证 。 参 阅 Section 19.3.11 获 取 细 节 


_auth-options_ 


在 _auth-method, 字段 之 后 ， 字 段 格 式 可 以 是 name 、=、value , 指定 认证 方法 的 选项 。 
关于 哪个 选项 可 用 于 哪个 认证 方法 的 详情 在 下 面 描述 。 





用 @ 构造 包含 的 文件 是 当 作 一 列 名 字 读 取 的 ， 这 些 名 字 可 以 用 空白 或 者 逗号 分 隔 。 注释 
用 # 引入 ， 就 像 在 pg_hba.conf BAH, HRE @ 构造 。 除 非 跟 在 @ 后 面 的 文件 名 是 一 
个 绝对 路 径 ， 否则 被 当 作 与 该 文件 所 在 目录 相对 的 路 径 。 


因为 认证 时 系统 是 为 每 个 连接 请 求 顺序 检查 pg_hba.conf 里 的 记录 的 ， 所 以 这 些 记 录 的 顺序 

是 非常 关键 的 。 通 常 ， 靠 前 的 记录 有 上 比较 严 的 连接 匹配 参数 和 比较 弱 的 认证 方法 ， 而 靠 后 的 

记录 有 比较 松 的 匹配 参数 和 比较 严 的 认证 方法 。 比 如 ， 我 们 一 般 都 希望 对 本 地 TCP/IP 连接 使 
用 trust 认证 ， 而 对 远 端 的 TCP/IP 连接 要 求 口 令 。 在 这 种 情况 下 我 们 将 trust 认证 方法 用 
于 来 自 127.0.0.1 的 连接 ， 这 条 记录 将 出 现在 允许 更 广泛 的 客户 端 IP 地 址 的 使 用 口令 认证 的 

记录 前 面 。 


在 启动 和 主 服务 器 进程 收 到 SIGHUP 信号 的 时 候 ， 系 统 都 会 重新 装载 pg_hba.conf 文件 。 如 
果 你 在 活跃 的 系统 上 编辑 了 该 文件 ， 就 必须 通知 主 服 务 器 (使 用 pg_ctl reload 或 kill -HuP ) 
重新 加 载 该 文件 。 


Tip: 一 个 用 户 要 想 成 功 连接 到 特定 的 数据 库 ， 不 仅 需要 通过 pg_hba.conf WHA, 还 必 
须要 有 该 数据 库 上 的 connect 权限 。 如 果 希 望 限制 哪些 用 户 能 够 连接 到 哪些 数据 库 ， 赋 
予 /撤销 connect 权限 通常 比 在 pg_hba.conf 中 设置 规则 简单 。 














Example 19-1 里 是 pg_hba.conf 记录 的 一 些 例子 。 阅读 下 文理 解 不 同 认证 方法 的 细节 。 


Example 19-1. pg_hba.conf 记录 的 例子 


# 人 允许 在 本 机 上 的 任何 用 户 使 用 Unix 域 套 接 字 ( 本 地 连接 的 缺 省 ) 
# 以 任何 数据 库 用 户 身份 连接 任何 数据 库 


# 
# TYPE DATABASE USER ADDRESS METHOD 
local all all trust 


# 和 上 面相 同 ， 但 是 使 用 的 是 回环 的 (loopback)TCP/IP 连接 
# 


# TYPE DATABASE USER ADDRESS METHOD 
host all all 127.0.0.1/32 trust 


# 和 上 面 一 行 相 同 ， 但 是 用 的 是 独立 的 子 网 掩 码 字 段 
# 


# TYPE DATABASE USER IP-ADDRESS IP-MASK METHOD 
host all all 127.0.0.1 255.255.255.255 trust 


# 在 IPv6 上 相同 。 
# 


# TYPE DATABASE USER ADDRESS METHOD 
host all all 111/128 trust 


# 和 上 面相 同 ， 但 是 使 用 一 个 主机 名 (通常 包括 IPv4 和 IPv6) 。 
# 


# TYPE DATABASE USER ADDRESS METHOD 
host all all localhost trust 


# 人 允许 IP 地 址 为 192.168.93.x 的 任何 主机 与 "postgres" 数据 库 相 连 ， 
# 用 与 他 们 在 自己 的 主机 上 相同 ident 的 用 户 名 标识 他 自己 (通常 是 他 的 操作 系统 用 户 名 ) 
# 


# TYPE DATABASE USER ADDRESS METHOD 
host postgres all 192.168.93.0/24 ident 


# 人 允许 来 自主 机 192.168.12.10 的 用 户 提供 了 正确 的 口令 之 后 与 "postgres" 数据 库 连接 。 
# 

# TYPE DATABASE USER ADDRESS METHOD 
host postgres all 192.168.12.10/32 md5 


# 人 允许 来 自在 example ,com 域 里 的 主机 的 用 户 在 提供 了 正确 的 口令 之 后 与 任意 数据 库 连 接 。 

# 

# TYPE DATABASE USER ADDRESS METHOD 
host all all .example.com md5 


+ 如 果 前 面 没有 其 它 "host" 行 ， 那 么 下 面 两 行将 拒绝 所 有 来 自 192.168.54.1 的 连接 请 求 (因为 前 面 的 记录 先 匹 配 ， 
# 但 是 允许 来 自 互联 网 上 其 它 任何 地 方 的 有 效 的 Kerberos 5 认证 的 连接 。 
# 需 掩 码 引起 不 考虑 主机 IP 的 任何 位 。 因 此 它 匹配 任何 主机 。 


# 

# TYPE DATABASE USER ADDRESS METHOD 
host all all 192.168.54.1/32 reject 
host all all 0.0.0.0/0 krb5 


# 人 允许 来 自 192.168.x.x 的 任何 用 户 与 任意 数据 库 连 接 ， 只 要 他 们 通过 ident 检查 。 
# 但 如 果 ident 说 该 用 户 是 “bryanh" 且 他 要 求 以 PostgreSQL AP "guesti" 连接 ， 
# 那么 只 有 在 pg_ident.conf 里 有 "omicron" 的 映射 说 “bryanh" 允许 以 "guest1" 进行 连接 时 才 真 正 可 以 六 


+o 


TYPE DATABASE USER ADDRESS METHOD 
host all all 192.168.0.0/16 ident map=omicron 


# 如 果 下 面 是 用 于 本 地 连接 的 仅 有 的 三 行 ， 那 么 它们 将 允许 本 地 用 户 只 和 同名 数据 库 连 接 。 
# 只 有 管理 员 和 "support" 角色 里 的 成 员 例 外 ， 他 们 可 以 连接 到 任何 数据 库 。 

# $PGDATA/admins 文件 列 出 了 那些 允许 与 所 有 数据 库 连 接 的 用 户 名 。 
# 
# 


在 所 有 情况 下 都 需要 口令 。 
# TYPE DATABASE USER ADDRESS METHOD 
local sameuser all md5 
local all @admins md5 
local all +support md5 


# 上 面 最 后 两 行 可 以 合 起 来 写成 一 行 
local all @admins,+support md5 


# 数据 库 字 段 也 可 以 使 用 列表 和 文件 名 : 
local db1, db2,@demodbs all md5 





19.2. 用 户 名 映射 


当 使 用 像 ldent 或 GSSAPI 这 样 的 外 部 认证 系统 时 ， 发 起 连接 的 操作 系统 用 户 名 可 能 与 他 需要 
连接 的 数据 库 用 户 是 不 同 的 。 在 这 种 情况 下 ， 用 户 名 映射 可 用 于 映射 操作 系统 用 户 名 到 数据 
库 用 户 。 要 使 用 用 户 名 映射 ， 在 pg_hba.conf 中 的 选项 中 指定 map = _map-name 。 这 个 选项 
支持 所 有 接受 外 部 用 户 名 的 认证 方法 。 因为 不 同 的 映射 可 能 需要 不 同 的 连接 ， 使 用 的 映射 名 
在 pg_hba.conf 中 的 _map-name ”参数 中 指定 ， 表 示 为 每 个 独立 的 连接 使 用 哪个 映射 。 


用 户 名 映射 在 身份 映射 文件 中 定义 ， 缺 省 名 为 pg_ident .conf 并 且 缺 省 存储 在 集群 的 数据 目 
录 中 。 (不 过 ， 我 们 也 可 以 把 映射 文件 放 在 其 它 地 方 ; 参阅 jdent file 配置 参 数 。) 身份 映射 
文件 包含 的 下 面 通用 的 格式 : 


_map-name_ _system-username_ _database-username_ 


注释 和 空白 与 pg_hba.conf 文件 里 的 一 样 人 处理 。 _map-name ”是 将 要 用 于 在 pg_hba.conf 中 引 
用 这 个 映射 的 任意 名 称 。 另外 两 个 字段 声明 操作 系统 用 户 名 和 匹配 的 数据 库 用 户 名 。 同 一 
个 _map-name_ 可 以 在 一 个 映射 中 多 次 使 用 来 声明 多 个 用 户 映射 。 对 一 个 操作 系统 用 户 可 以 


映射 为 多 少 个 数据 库 用 户 没 有 限制 ， 反 之 亦 然 。 
对 一 个 给 定 的 操作 系统 用 户 可 以 映射 为 多 少 个 数据 库 用 户 没有 限制 ， 反 之 亦 然 。 因此 ， 了 映射 


中 的 记录 应 该 被 认为 是 意 为 "这 个 操作 系统 用 户 被 允许 作为 这 个 数据 库 用 户 连 接 "， 而 不 是 意 
味 着 他 们 是 相等 的 。 如 果 有 那 对 用 户 名 的 任意 映射 记录 从 带 有 那个 用 户 请 求 连接 的 数据 库 用 
户 名 的 外 部 认证 系统 获得 ， 那么 这 个 连接 将 被 允许 。 


如 果 _system-username_ 字段 以 一 个 反 斜 杠 ( / ) 开 始 ， 那么 该 字段 的 剩余 部 分 被 作为 一 个 规则 
表达 式 对 待 。 (参阅 Section 9.7.3.1 获取 关于 PostgreSQL 规 则 表达 式 语 法 的 细节 。) MMR 
达 式 可 以 包含 一 个 捕获 ， 或 括号 的 子 表 达 式 ， 然 后 可 以 在 _database-username_ 字段 中 作 

为 \1 (backslash-one) 引 用 。 这 人 允许 多 用 户 名 的 陕 射 在 一 行 中 ， 这 对 于 简单 的 语法 蔡 换 特别 
有 用 。 例 如 ， 这 些 记 录 : 


mymap /\(.*)@mydomain\.com$ Nl 
mymap /\(.*)@otherdomain\.com$ guest 


将 为 带 有 系统 用 户 名 的 以 @mydomain.com 结尾 的 用 户 删 除 域 部 分 ， 并 且 人 允许 系统 名 
以 @otherdomain.com 结尾 的 任意 用 户 作为 guest 登录 。 





Tip: 记 住 ， 缺 省 的 ， 一 个 规则 表达 式 只 可 以 匹配 字符 串 的 一 部 分 。 使 用 ^ 和 $ 通常 是 明 
智 的 ， 就 像 上 面 例子 所 示 ， 来 迫使 匹配 成 为 整个 系统 用 户 名 。 

















在 系统 启动 和 主 服务 器 收 到 一 个 SIGHUP 信号 的 时 候 会 读 取 pg_ident.cont 文件 。 如 果 你 在 一 
台 活 路 的 系统 上 编辑 该 文件 ， 那么 你 需要 给 主 服务 器 发 信号 (使 
用 pg_ctl reload 或 kill -Hup ) 倒 其 重新 污 取 该 文件 。 


Example 19-2 里 是 一 个 可 以 和 在 Example 19-1 里 面 演 示 的 pg_hba.conf 文件 配合 使 用 

的 pg_ident.conf 文件 。 在 这 个 例子 的 设置 里 ， 任 何 登 录 到 192.168 网 络 里 的 机 器 的 用 户 ， 
如 果 用 户 名 不 是 bryanh ，ann ，robert 就 不 能 获准 访问 。Unix 用 户 robert 只 有 在 试图 以 
PostgreSQL 用 户 bob 身份 连接 时 才 人 允许 访问 ， 而 不 能 是 robert 或 其 它 什 么 身份 。 ann 将 只 
允许 以 ann 的 身份 连接 。 用 户 bryan 人 允许 以 他 自己 的 bryan 身份 或 者 作为 guest1 进行 连 
接 。 


Example 19-2. 一 个 pg_ident.conf 文件 例子 


# MAPNAME SYSTEM-USERNAME PG-USERNAME 
omicron bryanh bryanh 
omicron ann ann 

# bob 在 这 台 机 器 上 的 用 户 名 是 robert 

omicron robert bob 


# bryanh 也 可 以 以 guest1 身份 连接 
omicron bryanh guest1 


19.3. 认证 方法 


下 面 的 小 节 更 详细 地 描述 认证 方法 。 


19.3.1. 信任 认证 


如 果 声 明了 trust 认证 模式 ，PostgreSQL 就 假设 任何 可 以 连接 到 服务 器 的 人 都 可 以 以 任何 他 
声明 的 数据 库 用 户 名 (甚至 超级 用 户 名 ) 连 接 。 当然 ， 在 database 和 user 字段 里 面 的 限制 仍 
然 适 用 。 这 个 方法 应 该 用 于 那些 在 连接 到 服务 器 已 经 有 足够 操作 系统 层次 保护 的 环境 里 。 


trust 认证 对 于 单 用户 工 作 站 的 本 地 连接 是 非常 合适 和 方便 的 。 通常 它 本 身 并 不 适用 于 多 用 
户 环境 的 机 器 。 不 过 ， 即 使 在 多 用 户 的 机 器 上 ， 你 也 可 以 使 用 trust ， 只 要 你 利用 文件 系统 
权限 限制 了 对 服务 器 的 Unix 域 套 接 字 文 件 的 访问 。 要 做 这 些 限制 ， 你 可 以 设 

置 unix_socket_permissions 参数 (以 及 可 能 还 有 unix_socket_group )， 就 像 Section 18.3 里 描 
述 的 那样 。 或 者 你 可 以 设置 unix_socket_directories ， 把 Unix 域 套 接 字 文件 放 在 一 个 经 过 
恰当 限制 的 目录 里 。 


设置 文件 系统 权限 只 能 帮助 Unix 套 接 字 连 接 ， 它 不 会 限制 本 地 TCP/IP 连接 。 因 此 ， 如 果 你 
想 利 用 文件 系统 权限 来 控制 本 地 安全 ， 那 么 删除 pg_nba,conf 文件 中 的 
host ... 127.0.0.1 ... 行 ， 或 者 把 它 改 为 一 个 非 trust 的 认证 方法 。 


trust 认证 模式 只 适合 TCP/IP 连接 ， 只 有 在 你 信任 那些 trust 行 上 所 有 机 器 中 的 所 有 用 户 
的 时 候 才 是 合适 的 。 很 少 有 理由 使 用 trust 作为 任何 除 来 自 localhost (127.0.0.1) 以 外 的 
TCP/IP 连接 的 认证 方式 。 


19.3.2. OPNE 


以 口令 为 基础 的 认证 方法 包括 mas , password 。 这 些 方法 操作 上 非常 类 似 ， 只 不 过 口令 通过 
连接 传送 的 方法 不 同 : 分 别 是 MD5 散 列 、 明 文 。 


如 果 你 担心 口令 被 "窃听 "， 那 么 ms 比较 合适 。 应 该 尽 可 能 避免 使 用 password o A 

m, mas 不 能 和 db_user_namespace 功 能 一 起 使 用 。 如 果 连 接 通过 SSL 加 密 保护 ， 那 

么 password 可 以 安全 的 使 用 (尽管 如 果 一 个 用 户 依赖 于 使 用 SSL， SSL 证 书 认 证 可 能 是 一 个 
更 好 的 选择 。) 


PostgreSQL 数 据 库 口 令 与 任何 操作 系统 用 户口 邻 无 关 。 各 个 数据 库 用 户 的 口令 是 存储 

在 pg_authid 系统 表 里 面 。 口令 可 以 用 SQL 语言 命 分 CREATE USER 和 ALTER ROLE 等 管 
理 (比如 <kbd class="literal">CREATE USER foo WITH PASSWORD 'secret'</kbd>。 如 果 没 
有 明确 设置 口 售 ， 那 么 存储 的 口令 是 空 并 且 该 用 户 的 口令 认证 总 会 失败 。 


19.3.3. GSSAPI 认证 


GSSAPI 是 为 了 在 RFC 2743 中 定义 的 安全 认证 的 一 个 工业 标准 协议 。 PostgreSQL 根 据 RFC 
1964 支 持 GSSAPI 和 Kerberos 认 证 一 起 使 用 。GSSAPI 为 支持 它 的 系统 提供 自动 身份 验证 

( 单 点 登录 ) 。 身 份 验证 本 身 是 安全 的 ， 但 是 数据 在 数据 连接 时 的 传送 将 会 是 未 加 密 的 ， 除 
非 使 用 了 SSL。 


当 GSSAPI 使 用 Kerberos 时 ， 它 使 用 一 个 标准 ， 主要 
以 _servicename_ / _hostname_ @ _realm_ 的 格式 。 关于 主要 部 分 的 信息 和 如 何 配置 所 需 的 秘 
钥 ， 请 参阅 Section 19.3.5。 


GSSAPI 支 持 在 PostgreSQL 编 译 时 必须 打开 ; 参阅 Chapter 15 获 取 更 多 信息 。 


GSSAPI 支 持 下 列 的 配置 选项 : 


include_realm 


如 果 设 置 为 1， 通 过 身份 验证 的 用 户主 的 域名 包含 在 通过 用 户 名 映射 的 系统 用 户 名 中 (Section 
19.2)。 这 对 义理 来 自 多 个 领域 的 用 户 是 有 帮助 的 。 


map 
允许 在 系统 和 数据 库 用 户 名 之 间 了 映射 。 参 阅 Section 19.2 获 取 细 节 。 对 于 一 个 Kerberos 主 要 
的 username/hostbased@EXAMPLE.COM , 如 果 include_realm 未 BR, 那么 用 来 映射 的 用 户 名 


是 username/hostbased ， 如 果 include_realm BRAT, 那么 就 


是 username/hostbased@EXAMPLE.COM 。 
krb_realm 


设置 域 以 匹配 用 户主 名 称 。 如 果 设 置 了 这 个 参数 ， 那 么 只 接受 那个 域 中 的 用 户 。 如 果 没 有 设 
置 ， 那么 任何 域 中 的 用 户 都 可 以 连接 ， 使 无 论 什 么 用 户 名 映射 都 完成 。 


19.3.4. SSPI 认证 


SSPI 是 单 点 登录 安全 身份 验证 的 一 个 Windows 技 术 。 PostgreSQL 将 在 negotiate 模式 下 使 
FASSPI, 当 可 能 时 将 使 用 Kerberos 并 且 在 其 他 情况 下 会 自动 回 滚 至 NTLM。 SSPI 认 证 只 当 服 
务 器 和 客户 端 都 运行 Windows 时 工作 ， 否则 ， 在 非 Windows 平 台 上 ，GSSAPI 是 可 用 的 。 


当 使 用 Kerberos 认 证 时 ，SSPI 以 和 GSSAPI 一 样 的 方式 工作 ; 参阅 Section 19.3.3 获 取 详 细 信 
SSPI 支 持 下 列 的 配置 选项 : 


include_realm 


如 果 设 置 为 1， 通 过 身份 验证 的 用 户主 的 域名 包含 在 通过 用 户 名 映射 的 系统 用 户 名 中 (Section 
19.2), 这 对 义理 来 自 多 个 领域 的 用 户 是 有 帮助 的 。 


map 


允许 在 系统 和 数据 库 用 户 名 之 间 上 映射。 参阅 Section 19.2% Wea Fi. 


krb_realm 


设置 域 以 匹配 用 户主 名 称 。 如 果 设 置 了 这 个 参数 ， 那 么 只 接受 那个 域 中 的 用 户 。 如 果 没 有 设 
置 ， 那么 任何 域 中 的 用 户 都 可 以 连接 ， 使 无 论 什 么 用 户 名 映射 都 完成 。 


19.3.5. Kerberos 认证 

















Note: 本 地 Kerberos 认 证 已 经 废弃 了 而 且 应 该 只 在 为 了 向 后 兼容 的 时 候 使 用 。 建议 新 的 
和 升级 安装 使 用 工业 标准 GSSAPI 认 证 方法 (参阅 Section 19.3.3) 。 


Kerberos 是 一 种 适用 于 在 公共 网 络 上 进行 分 布 计 算 的 工业 标准 的 安全 认证 系统 。 对 Kerberos 
系统 的 叙述 超出 了 本 文档 的 范围 ; 总 的 说 来 它 是 相当 复杂 (同样 也 相当 强大 ) 的 系统 。 
Kerberos FAQ 或 MIT Kerberos page 是 个 开始 学 习 的 好 地 方 。 现 存在 好 几 种 Kerberos 发 布 的 
源 代码 。Kerberos 只 提供 安全 认证 ， 但 并 不 加 密 在 网 络 上 传输 的 查询 和 数据 ，SSL 可 以 用 于 
这 个 目的 。 


PostgreSQL 支 持 Kerberos 5, Kerberos 支持 必须 在 编译 的 时 候 打 开 。 参阅 Chapter 15 获 取 
更 多 信息 。 


PostgreSQL 运 行 时 像 一 个 普通 的 Kerberos 服务 。 服 务 主 的 名 字 是 


_servicename_ / _hostname_ @ realm o 


_servicename_ 可 以 用 krb_srvname 配 置 参 数 在 服务 器 端 设 置 ， 或 者 在 客 户 端 使 

用 krbsrvname 连接 参数 设置 (又 见 Section 31.1.2)。 编译 的 时 候 ， 可 以 把 安装 时 的 缺 

省 postgres 修改 掉 ， 方法 是 使 用 ./configure --with-krb-srvnam="~_whatever_ o 在 大 多 数 情 
况 下 ， 我 们 不 需要 修改 这 个 参数 。 但 是 ， 如 果 需 要 在 同一 台 主 机 上 同时 安装 多 套 
PostgreSQL, 那么 这 个 就 是 必须 的 了 。 有 些 Kerberos 实现 还 可 能 要 求 其 它 的 服务 名 ， 比如 
Microsoft Active Directory 就 要 求 服务 名 必须 是 大 写 的 ( PosTGRES )。 


_hostname ”是 服务 器 的 全 限定 主机 名 。 服 务 主 的 领域 就 是 主机 的 首选 领域 。 


客户 主 自己 必须 用 它们 自己 的 PostgreSQL 用 户 名 作为 第 一 个 部 件 ， 比如 pgusername@realm o 
或 者 ， 你 可 以 使 用 一 个 用 户 名 映射 来 从 主 名 的 第 一 个 部 件 到 数据 库 用 户 名 映射 。 缺 省 的 ， 
PostgreSQL 没 有 检查 客户 的 域 ; 因此 如 果 你 打开 了 跨 域 的 认证 ， 并 且 需 要 验证 这 个 域 ， 那么 
使 用 krb_realm 参数 或 者 打开 include_realm 并 使 用 用 户 名 映射 来 检查 这 个 域 。 


确认 服务 器 的 密 钥 表 文 件 是 可 以 被 PostgreSQL 服 务 器 帐户 读 取 (最 好 就 是 只 读 的 )。( 又 见 
Section 17.1。) 密 钥 文件 (keytab) 的 位 置 是 用 配置 参数 krp_server_keyfile 声 明 的 。 缺 省 
是 /usr/local/pgsql/etc/krb5.keytab (或 者 任何 在 编译 的 时 候 声明 为 sysconfdir 的 目录 )。 


密 钥 表 文 件 (keytab) 是 在 Kerberos 软件 里 生成 的 ， 参 阅 Kerberos 文档 获取 细节 。 下 面 的 例 
子 是 可 以 用 于 MIT 兼容 的 Kerberos 5 实现 : 


<samp class="literal">kadmin%</samp> <kbd class="literal">ank -randkey postgres/server.my 
<samp class="literal">kadmin%</samp> <kbd class="literal">ktadd -k krb5.keytab postgres/s 
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在 和 数据 库 连 接 的 时 候 ， 请 确保 自己 对 每 个 主 都 拥有 一 张 匹 配 所 请 求 的 数据 库 用 户 名 的 门 
票 。 比如 ， 对 于 数据 库 用 户 fred ， 主 fred@EXAMPLE.coM 将 能 够 连接 。 为 了 也 人 允许 
主 fred/users.example.com@EXAMPLE.coM ， 使 用 一 个 用 户 名 映射 ， 在 Section 19.2 中 描述 。 


如 果 你 在 Apache 服 务 器 上 使 用 了 mod_auth kerb 和 mod_perl 模 块 ， 你 可 以 用 一 个 mod_perl 
脚本 进行 AuthType KerberosV5SaveCredentials o 这 样 就 有 了 一 个 通过 Web 的 安全 数据 库 访 
问 ， 不 需要 额外 的 口令 。 
Kerberos 支 持 下 列 的 配置 选项 : 

map 
允许 系统 和 数据 库 用 户 名 之 间 的 映射 。 参 阅 Section 19.2 获 取 详 细 信 息 。 

include_realm 

如 果 设 置 为 {1， 通 过 身份 验证 的 用 户主 的 域名 包含 在 通过 用 户 名 映射 的 系统 用 户 名 中 (Section 
19.2)。 这 对 义理 来 自 多 个 领域 的 用 户 是 有 帮助 的 。 

krb_realm 

设置 域 以 匹配 用 户主 名 称 。 如 果 设 置 了 这 个 参数 ， 那 么 只 接受 那个 域 中 的 用 户 。 如 果 没 有 设 
置 ， 那么 任何 域 中 的 用 户 都 可 以 连接 ， 使 无 论 什 么 用 户 名 映射 都 完成 。 


krb_server_hostname 


设置 服务 主 的 主机 名 部 分 。 与 krb_srvname 组 合 ， 用 来 产 生 全 部 的 服务 主 ， 也 就 是 
krb_srvname ~/~ ~“krb_server_hostname’ ~@ 域 。 如 果 没 有 设置 ， 缺 省 为 服务 器 主机 名 。 


19.3.6. Ident 认证 
ident 认证 方法 是 通过 从 一 个 ident 服 务 器 获取 客户 端的 操作 系统 用 户 名 ， 并 使 用 它 作为 允许 的 
数据 库 用 户 名 〈 带 有 一 个 可 选 的 用 户 名 映射 ) 。 只 在 TCP/IP 连 接 上 支持 。 


Note: 当 ident 指 定 为 本 地 连接 (JETCPIIP) 时 ， 将 使 用 peer 的 认证 (参阅 Section 
19.3.7) 。 


ident 支 持 下 列 的 配置 选项 : 


map 


允许 在 系统 和 数据 库 用 户 名 之 间 映 射 。 参 阅 Section 19.2 获 取 详 细 信 息 。 


"Identification Protocol"( 标 识 协议 ) 在 RFC 1413 里 面 描述 。 实际 上 每 个 类 Unix 的 操作 系统 都 
带 着 一 个 缺 省 时 侦 听 113 端口 的 身份 服务 器 。 身份 服务 器 的 基本 功能 是 回答 类 似 这 样 的 问 
题 : "是 什么 用 户 从 你 的 端口 x 初始 化 出 来 连接 到 我 的 端口 vy ERT?" 因为 在 建立 起 
物理 连接 后 ，PostgreSQL 既 知道 x 也 知道 Y ， 因此 它 可 以 询问 运行 尝试 连接 的 客户 端 
的 主机 ， 并 且 理 论 上 可 以 判断 发 起 连接 的 操作 系统 用 户 。 


这 样 做 的 缺点 是 它 取 决 于 客户 端的 完整 性 : 如 果 客 户 端 不 可 信 或 者 被 盗用 ， 那么 攻击 者 可 以 
在 113 端口 上 运行 任何 程序 并 且 返 回 他 们 选择 的 任何 用 户 。 这 个 认证 方法 只 适用 于 封闭 的 网 
络 ， 这 样 的 网 络 里 的 每 台 客 户 机 都 处 于 严密 的 控制 下 并 且 数 据 库 和 操作 系统 管理 员 可 以 比较 
方便 地 联系 上 。 换 句 话说， 你 必须 信任 运行 身份 (ident) 服 务 的 机 器 。 下 面 是 警告 : 

身份 标识 协议 并 不 适用 于 认证 或 者 访问 控制 协议 。 

--RFC 1413 

有 些 身 份 服务 器 有 一 个 非 标准 的 选项 ， 导 致 返回 的 用 户 名 是 加 密 的 ， 使 用 的 是 只 有 原 机 器 的 
管理 员 知 道 的 一 个 密 钥 。 在 与 PostgreSQL 配 合 使 用 身份 认证 的 时 候 ， 你 一 定 不 能 使 用 这 个 选 
项 ， 因 为 PostgreSQL 没有 任何 方法 对 返回 的 字符 串 进 行 解 密 以 获取 实际 的 用 户 名 。 


19.3.7. Peer 认证 
peer 认 证 方法 通过 从 内 核 获 得 客户 端的 操作 系统 用 户 名 和 使 用 它 作 为 允许 的 数据 库 用 户 名 
(使 用 可 选 的 用 户 名 映射 ) 工作 。 这 个 方法 只 支持 本 地 连接 。 
peer 支 持 下 列 的 配置 选项 : 
map 
允许 在 系统 和 数据 库 用 户 名 之 间 上 映射。 参阅 Section 19.2 获 取 详 细 信息 。 


Peer 认证 只 能 在 提供 getpeereid() Æ, so_PEERCRED 套 接 字 参数 或 类 似 的 机 制 的 操作 系统 
上 适用 ， 目 前 包括 Linux、 大 多 数 包 含 Mac OS X 的 BSD 和 Solaris。 


19.3.8. LDAP 认证 


这 个 认证 方法 操作 起 来 类 似 password ， 只 不 过 它 使 用 LDAP 作为 密码 验证 机 制 。 LDAP 只 用 
于 验证 用 户 名 /口令 对 。 因 此 ， 在 使 用 LDAP 进行 认证 之 前 ， 用 户 必须 已 经 存在 于 数据 库 里 。 


LDAP 认 证 可 以 在 两 种 模式 操作 。 在 第 一 种 模式 ， 我 们 将 调用 简单 的 绑 定 模式 ， 服务 器 将 绑 定 
到 以 _prefix  _username  _suffix 构造 的 识 别名 (Distinguished Name) 上 。 通 

= _prefix ”参数 用 于 在 活动 目录 环境 中 指定 cn 或 _DpoMAIN、` 八 。 _suffix 用 来 在 非 活动 
目录 环境 中 指定 DN 的 剩余 部 分 。 
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户 名 和 密码 ， 用 _idapbinddn_ 和 _ldapbindpasswd_ 指定 ， 并 且 为 试图 登陆 到 数据 库 的 用 户 执 
行 一 次 搜索 。 如 果 没 有 配置 用 户 名 和 密码 ， 将 试图 对 这 个 目录 进行 匿名 绑 定 。 将 对 

在 _ldapbasedn_ 的 子 树 执行 搜索 ， 并 且 将 试图 对 _ldapsearchattribute_ 指定 的 属性 做 一 个 准 
确 匹 配 。 一 且 在 这 个 目录 中 发 现 了 用 户 ， 服 务 器 断 开 并 且 重 新 作为 这 个 用 户 绑 定 到 目录 ， 使 

用 客户 端 指定 的 密码 ， 以 验证 登陆 是 正确 的 。 这 个 模式 和 在 其 他 软件 使 用 的 LDAP 认 证 模式 相 
同 ， 例 如 Apache mod_authnz_Idap 和 pam_ldap。 这 种 方法 允许 在 目录 中 的 用 户 对 象 有 很 大 
的 灵活 性 ， 但 是 将 导致 两 个 独立 的 连接 到 LDAP 服 务 器 。 

下 列 的 配置 选项 在 两 种 模式 下 都 使 用 : 

ldapserver 

连接 到 的 LDAP 服 务 器 的 名 字 或 IP 地 址 。 可 能 指定 多 个 服务 器 ， 用 空格 分 开 。 

ldapport 

连接 到 的 LDAP 服 务 器 的 端口 号 。 如 果 没 有 指定 端口 ， 将 使 用 LDAP 库 缺 省 端口 。 

ldaptls 

设置 为 1 以 使 PostgreSQL 和 LDAP 服 务 器 之 间 的 连接 使 用 TLS 加 密 。 注 意 这 只 加 密 去 往 LDAP 

服务 器 的 流量 ， 也 就 是 连接 到 客户 端 将 仍然 是 未 加 密 的 ， 除 非 使 用 了 SSL。 

下 列 的 选项 只 在 简单 绑 定 模式 中 使 用 : 

ldapprefix 

当做 简单 的 绑 定 认证 ， 绑 定 到 DN 时 ， 前 级 到 用 户 名 的 字符 串 。 

ldapsuf fix 

当做 简单 的 绑 定 认证 ， 绑 定 到 DN 时 ， 附 加 到 用 户 名 的 字符 串 。 

下 列 的 选项 只 在 搜索 + 绑 定 模式 中 使 用 : 

ldapbasedn 

当做 搜索 + 绑 定 认证 时 ， 为 用 户 开始 搜索 的 根 DN。 

ldapbinddn 

当做 搜索 + 绑 定 认证 时 ， 绑 定 到 目录 并 执行 搜索 的 用 户 的 DN。 

ldapbindpasswd 

当做 搜索 + 绑 定 认证 时 ， 绑 定 到 目录 并 执行 搜索 的 用 户 的 密码 。 

ldapsearchattribute 

当做 搜索 + 绑 定 认证 时 ， 在 搜索 中 匹配 用 户 名 的 属性 。 如 果 没 有 指定 属性 ， 将 使 用 uid 属性 。 


ldapurl 


一 个 RFC 4516 LDAP URL。 这 是 一 个 在 更 紧凑 和 标准 的 形式 中 写 入 一 些 其 他 LDAP 选 项 的 可 
选择 的 方式 。 格式 是 





ldap://_host_[:_port_]/_basedn_[?[_attribute_][?[_scope_]]] 
_scope_ 必须 是 base, one, sub 之 一 ， 通 常 是 最 后 一 个 。 只 使 用 一 个 属性 ， 一 些 其 他 的 标 
准 LDAP URL 的 组 成 部 分 比如 filters 和 extensions 是 不 支持 的 。 
对 于 非 匿 名 的 绑 定 ， 1dapbinddn 和 ldapbindpasswd 必须 作为 独立 的 选项 声明 。 


要 使 用 加 密 的 LDAP 连 接 ， 除了 ldapurl ， 必 须 使 用 ldaptls 选项 。 不 支持 1daps URL 模 式 
(直接 SSL 连 接 ) 。 


LDAP URL 当 前 只 支持 OpenLDAP， 不 是 在 Windows 上 。 
混合 简单 绑 定 和 搜索 + 绑 定 的 配置 选项 是 错误 的 。 
里 是 简单 绑 定 LDAP 配 置 的 一 个 例子 : 
host ... ldap ldapserver=ldap.example.net ldapprefix="cn=" ldapsuffix=", dc=example, dc=n 
EJE 


当 要 求 一 个 到 数据 库 服务 器 的 连接 作为 数据 库 用 户 someuser 时 ， PostgreSQL 将 试图 使 用 DN 
cn=someuser，dc=example，dc=net 绑 定 到 LDAP 服 务 器 ， 并 且 密 码 由 客户 端 提 供 。 如 果 那 个 连 
接 成 功 了 ， 那 么 就 同意 数据 库 访 问 。 





这 里 是 搜索 + 绑 定 配置 的 一 个 例子 : 


host ... ldap ldapserver=ldap.example.net ldapbasedn="dc=example, dc=net" ldapsearchattri 





当 要 求 一 个 到 数据 库 服 务 器 的 连接 作为 数据 库 用 户 someuser 时 ， PostgreSQL it A EZ 
(因为 没有 指定 ldapbinddn ) 绑 定 到 LDAP 服 务 器 ， 为 (uid=someuser) 在 指定 的 基础 DN 下 执 
行 一 个 搜索 。 如 果 发 现 一 条 记录 ， 它 将 试图 使 用 发 现 的 信息 和 客户 端 提供 的 密码 绑 定 。 如 果 
第 二 个 链接 成 功 ， 那 么 就 同意 数据 库 访问 。 


这 是 相同 的 搜索 + 绑 定 配置 ， 写 作 一 个 URL : 
host ... ldap lapurl="ldap://ldap.example.net/dc=example, dc=net?uid?sub" 


一 些 其 他 支持 LDAP 认 证 的 软件 使 用 相同 的 URL 格 式 ， 所 以 它 将 更 容易 共享 配置 。 


Tip: 因为 LDAP 经 常 使 用 on tA 所 以 当 配 置 LDAP 选 项 时 ， 
通常 需要 使 用 双 引 号 参数 值 ， 就 像 例 子 中 所 示 的 一 








19.3.9. RADIUS 认证 


这 个 认证 方法 操作 起 来 类 似 password ， 只 不 过 它 使 用 RADIUS 作为 密码 验证 方法 。 RADIUS 

只 用 于 验证 用 户 名 /口令 对 。 因 此 ， 在 使 用 RADIUS 进行 认证 之 前 ， 用 户 必 须 已 经 存在 于 数据 

库 里 。 

当 使 用 RADIUS 认证 时 ， 一 个 访问 请 求 信息 将 发 送 到 已 配置 好 的 RADIUS 服务 器 。 这 个 请 求 将 
会 是 类 型 Authenticate Only ， 并 且 包 含 参 数 user name ， password (加 密 的 ) 和 

NAS Identifier. 这 个 请 求 将 使 用 一 个 和 服务 器 秘密 共享 的 加 密 。RADIUS 服 务 器 将 

以 access Accept 或 Access Reject 响应 这 个 服务 器 。 不 支持 RADIUS 账户 。 


RADIUS 支持 下 列 的 配置 选项 : 
radiusserver 
连接 到 的 RADIUS 服务 器 的 名 字 或 |P 地 址 。 这 个 参数 是 必需 的 。 


radiussecret 


当 安 全 的 和 RADIUS 服务 器 对 话 时 使 用 的 共享 秘 钥 。 在 PostgreSQL 和 RADIUS 服务 器 上 必须 
有 完全 相同 的 值 。 建议 至 少 为 16 个 字符 的 字符 串 。 这 个 参数 是 必需 的 。 
Note: 如 果 PostgreSQL 编 译 支 持 OpenSSL， 那 么 加 密 向 量 将 只 被 强大 的 加 密使 用 。 在 
其 他 情况 下 ， 到 RADIUS 服 务 器 的 传输 应 该 只 被 认为 是 混淆 的 ， 不 是 安全 的 ， 并 且 必 要 
应 该 采用 外 部 安全 措施 。 





yn 


X 


a 











janj 


t 

















radiusport 


连接 到 的 RADIUS 服务 器 的 端口 号 。 如 果 没 有 指定 端口 ， 将 使 用 缺 省 的 端口 1812 。 
radiusidentifier 
在 RADIUS 请 求 中 作为 NAS Identifier 使 用 的 字符 串 。 这 个 参数 可 以 用 作 第 二 个 参数 标识 ， 


比如 用 户 试图 作为 哪个 数据 库 用 户 验 证 ， 哪 个 可 以 用 来 在 RADIUS 服务 器 上 政策 匹配 。 如 果 
没有 指定 标识 符 ， 将 使 用 缺 省 的 postgresql o 


19.3.10. 证 书 认 证 


这 个 认证 方法 使 用 SSL 证 书 来 执行 认证 。 因 此 只 适用 于 SSL 连 接 。 当 使 用 这 个 认证 方法 时 ， 
服务 器 将 请 求 客户 端 提 供 一 个 有 效 的 证 书 。 没 有 密码 提示 发 送 给 客户 端 。 证 书 的 cn 
(Common Name) 属性 将 和 与 请 求 的 数据 库 用 户 名 比较， 如 果 它 们 匹配 ， 登 陆 将 被 允许 。 用 户 
名 映射 可 以 用 来 允许 cn 不 同 于 数据 库 用 户 名 。 

SSL 证 书 认 证 支持 下 列 的 配置 选项 : 


map 


允许 在 系统 和 数据 库 用 户 名 之 间 映 射 。 参 阅 Section 19.2 获 取 详 细 信息 。 


19.3.11. PAM 认证 


这 个 认证 方法 操作 起 来 类 似 password ， 只 不 过 它 使 用 PAM (Pluggable Authentication 
Modules) 作 为 认证 机 制 。 缺 省 的 PAM 服务 名 是 postgresql o PAM 只 用 于 验证 用 户 名 /口令 
对 。 因 此 ， 在 使 用 PAM 进行 认证 之 前 ， 用 户 必 须 已 经 存在 于 数据 库 里 。 有 关 PAM 的 更 多 信 
息 ， 请 阅读 Linux-PAM 页 面 。 

PAM 支 持 下 列 的 配置 选项 : 


pamservice 
PAM 服 务 名 。 


Note: 如 果 PAM 设 置 为 读 取 /etc/shadow ， 那 么 将 验证 失败 ， 因 为 PostgreSQL 服 务 器 是 
通过 非 root 用 户 启动 的 。 然而 ， 当 PAM 设 置 为 使 用 LDAP 或 其 他 认证 方法 时 将 不 是 一 个 问 


ee 


& 


o 


19.4. 用 户 认 证 


认证 失败 以 及 相关 的 问题 通常 由 类 似 下 面 的 错误 信息 表白 。 


FATAL: no pg_hba.conf entry for host "123.123.123.123", user "andym", database "testdb" 


‘ | 





这 条 信息 出 现 的 最 大 可 能 是 你 已 经 连接 了 服务 器 ， 但 它 不 愿意 和 你 说 话 。 就 像 信 息 自 己 表 示 
的 那样 ， 服 务 器 拒绝 了 连接 请 求 ， 因 为 它 没 有 在 它 的 pg_hba.conf 配置 文件 里 找到 匹配 的 记 
录 。 


FATAL: password authentication failed for user "andym" 


这 样 的 信息 表示 你 连接 了 服务 器 ， 并 且 它 也 愿意 和 你 交谈 ， 但 是 你 必须 通过 pg_hba.conf X 
件 里 声明 的 认证 方法 。 检 查 你 提交 的 口令 ， 或 者 如 果 错 误 信 息 提 到 这 些 Kerberos 或 IDENT 
认证 类 型 时 检查 这 些 软 件 。 


FATAL: user "andym" does not exist 


这 是 表示 数据 库 用 户 不 存在 的 。 


FATAL: database "testdb" does not exist 


你 试图 连接 的 数据 库 不 存在 。 请 注意 如 果 你 没有 声明 数据 库 名 ， 缺 省 是 数据 库 用 户 名 ， 这 可 
能 正确 也 可 能 不 正确 。 
Tip: 请 注意 服务 器 日 志 可 能 包含 比 报告 给 客户 端的 更 多 的 有 关 认 证 失败 的 信息 。 如 果 你 
被 失败 的 原因 搞 糊涂 了 ， 那 么 请 检查 服务 器 日 志 。 


Chapter 20. 数据 库 角色 


Table of Contents 
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© 20.4. 函数 和 触发 器 安全 


PostgreSQL 使 用 角色 的 概念 管理 数据 库 访问 权限 。 根据 角色 自身 的 设置 不 同 ， 一 个 角色 可 以 
看 做 是 一 个 数据 库 用 户 ， 或 者 一 组 数据 库 用 户 。 角色 可 以 拥有 数据 库 对 象 (比如 表 ) 以 及 可 以 
把 这 些 对 象 上 的 权限 赋予 其 它 角 色 ， 以 控制 谁 拥有 访问 哪些 对 象 的 权限 。 另外， 我 们 也 可 以 
把 一 个 角色 的 成 员 权限 赋予 其 它 角色 ， 这 样 就 允许 成 员 角色 使 用 分 配给 另 一 个 角色 的 权限 。 


角色 的 概念 替换 了 "用 户 " 和 "组 "。 在 PostgreSQL 版 本 8.1 之 前 ， 用 户 和 组 是 独立 类 型 的 记 
录 ， 但 现在 它们 只 是 角色 。 任何 角色 都 可 以 是 一 个 用 户 、 一 个 组 、 或 者 两 者 。 


本 章 描述 如 何 创 建 和 管理 角色 。 更 多 各 种 数据 库 对 象 角色 权限 效果 的 信息 可 以 在 Section 5.6 
找到 。 


20.1. 数据 库 角 色 


数据 库 角 色 从 概念 上 与 操作 系统 用 户 是 完全 无 关 的 。 在 实际 使 用 中 把 它们 对 应 起 来 可 能 比较 
Ae, 但 这 不 是 必须 的 。 数 据 库 角 色 在 整个 数据 库 集群 中 是 全 局 的 (而 不 是 每 个 库 不 同 )。 要 
创建 一 个 角色 ， 使 用 SQL 命令 CREATE ROLE 执行 : 


CREATE ROLE _name_; 


_name_ 遵循 SQL 标识 的 规则 : 要 么 完全 没有 特殊 字符 ， 要 么 用 双 引 号 包围 (实际 上 你 通常 会 
给 命令 增加 额外 的 选项 ， 比 如 Lo6IN 。 下 面 显示 更 多 细节 )。 要 删除 一 个 现 有 和 角色， 使 用 类 似 
的 DROP ROLE 命令 : 


DROP ROLE _name_; 


为 了 方便 ， 程 序 createuser 和 dropuser 提供 了 对 了 这 些 SQL 命令 的 封装 。 我 们 可 以 在 shell 
命令 上 直接 调用 它们 : 


createuser _name_ 
dropuser _name_ 


要 检查 现 有 角色 的 集合 ， 可 以 检查 pg roles RAR, LOM: 


SELECT rolname FROM pg_roles; 


psqd| 的 元 命令 \du 也 可 以 用 于 列 出 现 有 角色 。 


为 了 能 创建 初始 数据 库 系 统 ， 新 建立 的 数据 库 总 是 包含 一 个 预定 义 的 "超级 用 户 " 角 色 ， 并 且 
缺 省 时 (除非 在 运行 initdb 时 更 改过 ) 他 将 和 初始 化 该 数据 库 集 群 的 用 户 有 相同 的 名 称 。 通 
常 ， 这 个 角色 名 叫 postgres o 为 了 创建 更 多 角色 ， 你 必须 首先 以 这 个 初始 用 户 角色 连接 。 


每 一 个 和 数据 库 的 连接 都 必须 用 一 个 角色 身份 进行 ， 这 个 角色 决定 在 该 连接 上 的 初始 权限 。 
特定 数据 库 连 接 的 角色 名 是 在 初始 化 连接 请 求 的 时 候 声明 的 。 比 如 ， psa 程序 使 用 -u 命 全 
行 选项 声明 它 代表 的 角色 。 许多 应 用 以 当前 操作 系统 的 用 户 名 为 缺 省 角色 名 (这 样 的 应 用 包 
括 createuser 和 psal )。 所 以 ， 在 系统 用 户 和 数据 库 角色 之 间 有 某 种 命名 关系 会 让 我 们 工作 
方便 很 多 。 


一 个 客户 端 连接 可 以 使 用 的 角色 集合 是 由 客户 认证 设置 决定 的 ， 在 Chapter 19 里 面 有 解释 。 
因此 ， 一 个 客户 端 并 不 局 限于 以 它 的 操作 系统 用 户 匹 配 的 角色 进行 连接 ， 就 像 你 登录 系统 的 
名 称 不 一 定 要 是 你 的 真实 姓名 一 样 。 因 为 角色 的 身份 决定 了 一 个 连接 的 权限 ， 所 以 在 多 用 户 
环境 里 仔细 配置 这 些 内 容 是 非常 重要 的 。 


20.2. 角色 属性 


一 个 数据 库 角色 可 以 有 一 系列 属性 ， 这 些 属 性 定义 他 的 权限 ， 以 及 与 客户 认证 系统 的 交互 。 
登陆 权限 


只 有 具有 won 属性 的 角色 才 可 以 用 作 数 据 库 连接 的 初始 角色 名 。 一 个 带 有 Losi 属性 的 角 
色 可 以 认为 是 和 "数据 库 用 户 "相同 的 事物 。 要 创建 一 个 具有 登录 权限 的 角色 ， 用 下 列 之 一 : 


CREATE ROLE _name_ LOGIN; 
CREATE USER _name_; 


除了 CREATE USER 默认 赋予 LOGIN 之 外 ， CREATE USER 等 价 于 CREATE ROLE (默认 不 赋 
予 cREATE ROLE )。 


超级 用 户 状 态 


数据 库 超级 用 户 超越 所 有 权限 检查 。 这 是 一 个 危险 的 权限 ， 应 该 小 心 使 用 ; 最 好 使 用 非 超级 
用 户 完成 你 的 大 多 数 工 作 。 要 创建 数据 库 超级 用 户 ， 用 CREATE ROLE _name SUPERUSER 
命令 。 你 必须 用 已 经 是 超级 用 户 的 角色 执行 这 条 命 合 。 


创建 数据 库 


角色 要 想 创 建 数据 库 ， 必 须 明确 给 出 权限 (对 于 超级 用 户 是 例外 ， 因 为 他 们 超越 所 有 权限 检 
查 )。 要 创建 这 样 的 角色 ， 用 create ROLE _name ”CREATEDB 命 兮 。 


创建 角色 


角色 要 想 创建 和 角色， 必须 明确 给 出 权限 (对 于 超级 用 户 是 例外 ， 因 为 他 们 超越 所 有 权限 检查 )。 
要 创建 这 样 的 角色 ， 用 CREATE ROLE _name CREATEROLE 命令。 一 个 带 有 cREATEROLE 权 
限 的 角色 也 可 以 更 改 和 而 除 其 它 角 色 ， 以 及 给 其 它 角 色 赋 予 或 者 撤销 成 员 关 系 。 不 过 ， 要 创 
建 、 和 更改、 删除 一 个 超级 用 户 角色 的 成 员 关 系 ， 需要 具有 超级 用 户 属性 ; 只 有 cREATEROLE 还 
不 够 。 


启动 复制 


角色 要 想 馈 动 流 复制 ， 必 须 明确 给 出 权限 (对 于 超级 用 户 是 例外 ， 因 为 他 们 超越 所 有 权限 检 
查 )。 用 于 流 复制 的 角色 必须 总 是 拥有 Lo6IN 权限 。 要 创建 这 样 的 角色 ， 使 用 CREATE ROLE 
_name_ REPLICATION LOGIN 命 兮 。 


Oa 


只 有 在 客户 认证 方法 要 求 与 数据 库 建 立 连接 必须 使 用 口令 的 时 候 ， 口 令 才 比较 重要 。 
password 和 mas 认证 方法 使 用 口令。 数据 库 口 邻 与 操作 系统 口令 是 无 关 的 。 在 创建 角色 的 
时 候 可 以 这 样 声 明 一 个 口令 : CREATE ROLE _name PASSWORD ' string '。 


一 个 角色 的 属性 可 以 在 创建 后 用 acter rote 160, BBCREATE ROLE 和 ALTER ROLE 的 
手册 获取 细节 。 


Tip: 创建 一 个 具有 cREATEDB 和 cREATEROLE 权限 ， 但 是 并 非 超 级 用 户 的 角色 是 一 个 很 好 
的 习惯 ， 你 可 以 使 用 这 个 角色 进行 所 有 日 常 的 数据 库 和 角色 管理 。 这 个 方法 避免 了 以 超 
级 用 户 操作 时 ， 发 生 误 操作 导致 的 严重 后 果 。 


一 个 角色 也 可 以 为 许多 运行 时 配置 设置 针对 其 个 人 的 缺 省 ， 那 些 配置 在 Chapter 18 里 描述 。 
比如 ， 如 果 出 于 某 种 原因 你 想 在 所 有 你 做 的 连接 中 关闭 索引 扫描 (不 是 个 好 主意 )， 你 可 以 用 : 


ALTER ROLE myname SET enable_indexscan TO off; 


这 样 就 会 保存 该 设置 (但 是 不 是 立即 设置 )。 然 后 ， 在 这 个 角色 随后 的 连接 中 就 好 像 在 会 话 开 始 
之 后 都 立即 set enable_indexscan To off 了 一 样 。 你 也 可 以 在 会 话 中 修改 这 个 设置 ; CRE 
缺 省 。 要 撤销 任何 这 样 的 设置 ， 使 用 ALTER ROLE _rolename_ RESET _varname_. 请 注 
意 ， 对 那些 没有 coon 属性 的 角色 ， 这 些 角色 相关 的 缺 省 值 几乎 没什么 用 ， 因为 它们 从 来 不 
会 被 调用 。 


20.3. 角色 成 员 


把 用 户 组 合 起 来 简化 权限 管理 是 个 常用 的 便利 方法 : 用 这 样 的 方法 ， 权 限 可 以 赋予 整个 组 ， 
也 可 以 对 整个 组 撤消 。 在 PostgreSQL 里 ， 这 些 事情 是 通过 创建 代表 一 个 组 的 角色 ， 然 后 赋予 
组 角色 的 成 员 权限 给 独立 的 用 户 角 色 的 方法 实现 的 。 


要 设置 一 个 组 角色 ， 首 先 创 建 角色 : 
CREATE ROLE _name_; 
一 般 作为 组 使 用 的 角色 不 应 当 具 有 Loc 属性 ， 虽 然 你 可 以 设置 它 。 
一 旦 组 角色 已 经 存在 了 ， 那 么 你 就 可 以 用 GRANT 和 REVOKE 命 令 添 加 和 撤消 权限 : 


GRANT _group_role_ TO _rolei_, . 
REVOKE _group_role_ FROM _role1i_, 








你 还 可 以 赋予 成 员 权 限 给 其 它 组 角色 (因为 在 组 角色 和 非 组 角色 之 间 没 有 实质 的 区 别 )。 唯一 
的 制约 是 你 不 能 建立 循环 的 成 员 关 系 。 另外， 不 允许 给 PuBLIC 角色 赋予 成 员 权 限 。 


一 个 组 角色 的 成 员 可 以 用 两 种 方法 使 用 角色 的 权限 。 首 先 ， 一 个 组 的 每 个 成 员 都 可 以 明确 

用 SET ROLE 临时 " 变 成 "该 组 的 成 员 。 在 这 个 状态 下 ， 数 据 库 会 话 具 有 该 组 角色 的 权限 ， 而 不 
是 原始 的 登录 角色 权限 ， 这 个 时 候 创建 的 数据 库 对 象 被 认为 是 由 组 角色 拥有 ， 而 不 是 登录 角 
色 。 第 二 ， 拥有 INHERIT 属性 的 角色 成 员 自 动 具有 它们 所 属 组 角色 的 权限 ， 包括 任何 通过 那 
些 角色 继承 的 权限 。 例 如 ， 假 如 我 们 做 了 下 面 的 事情 : 


CREATE ROLE joe LOGIN INHERIT; 
CREATE ROLE admin NOINHERIT; 
CREATE ROLE wheel NOINHERIT; 
GRANT admin TO joe; 

GRANT wheel TO admin; 


那么 在 以 角色 joe 连接 之 后 ， 该 数据 库 会 话 将 立即 拥有 直接 赋予 joe 的 权限 加 上 任何 赋 
予 admin 的 权限 ， 因 为 joe "继承 " 了 admin 的 权限 。 不 过 ， 赋 予 wheel 的 权限 不 可 用 ， 
为 即使 joe 是 wheel 的 一 个 间接 成 员 ， 但 该 成 员 关 系 是 通过 admin 过 来 的 ， 而 该 组 

有 NoINHERIT 属性 。 在 : 


SET ROLE admin; 


之 后 ， 该 会 话 将 只 拥有 那些 已 赋予 admin 的 权限 ， 而 不 包括 那些 已 赋予 joe 的 权限 。 在 


SET ROLE wheel; 


之 后 ， 该 会 话 将 只 能 使 用 已 赋予 wheel 的 权限 ， 而 不 包括 已 赋予 joe 或 admin 的 权限 。 原 来 
的 权限 可 以 用 下 列 之 一 恢复 : 


SET ROLE joe; 
SET ROLE NONE; 
RESET ROLE; 


Note: sET ROLE 命令 总 是 允许 选取 任意 登录 角色 直接 或 者 间接 所 在 的 组 角色 。 Alt, Æ 
上 面 的 例子 里 ， 我 们 没 必要 在 变 成 wheel 之 前 先 变 成 admin o 


Note: 在 SQL 标准 里 ， 在 用 户 和 和 角色 之 间 有 明确 的 区 别 ， 并 且 用 户 并 不 会 自动 继承 权 

限 ， 而 角色 可 以 。 这 个 行为 在 PostgreSQL 里 面 可 以 通过 给 予 那些 当 作 SQL 角色 使 用 的 
角色 以 INHERIT 属性 ， 而 给 予 当 作 SQL 用 户 使 用 的 角色 以 NoINHERIT 属性 来 实现 。 不 
过 ，PostgreSQL 缺 省 是 给 予 所 有 和 角色 INHERIT BY, 目的 是 和 8.1 之 前 的 版 本 向 下 兼 

容 ， 那 些 版 本 里 ， 用 户 总 是 能 使 用 他 们 所 在 组 被 赋予 的 权限 。 

角色 属性 LOGIN ，SUPERUSER , CREATEDB ，CREATEROLE 可 以 被 认为 是 特殊 的 权限 ， 但 是 它们 从 
来 不 会 像 数据 库 对 象 上 的 普通 权限 那样 继承 。 你 必须 明确 地 ser rove 到 一 个 特殊 的 角色 ， 这 
个 角色 应 该 是 拥有 这 些 属 性 的 角色 ， 然后 才能 利用 这 些 属 性 。 继 续 上 面 的 例子 ， 我 们 也 可 以 
选择 给 admin 角色 赋予 CREATEDB 和 CREATEROLE 权限 。 然 后 ， 以 joe 连接 的 会 话 不 会 立即 有 
这 些 权限 ， 只 有 在 SET ROLE admin 之 后 地 有 。 


要 删除 一 个 组 角色 ， 用 DROP ROLE 命令 : 
DROP ROLE _name_; 
任何 在 组 角色 里 面 的 成 员 关 系 都 会 自动 撤消 (但 是 成 员 角 色 自 己 则 不 受 影响 )。 不 过 ， 请 注意 


任何 组 角色 拥有 的 对 象 都 必须 首先 删除 或 者 赋予 其 它 所 有 者 ; 并 且 任 何 给 该 组 角色 赋予 的 权 
限 都 必须 撤消 。 


20.4. 函数 和 触发 器 安全 


画 数 和 触发 器 允许 用 户 向 后 端 服务 器 插 和 代码， 这样 其 它 用 户 可 以 在 无 意识 的 情况 下 执行 这 
些 代码 。 因此 ， 两 种 机 制 都 可 以 让 用 户 相当 隐 殴 地 给 别人 设置 "木马 "， 唯一 的 有 效 防护 就 是 
严格 控制 谁 可 以 定义 豆 数 。 


后 端 服 务 器 里 面 运行 的 函数 都 是 以 数据 库 服务 器 守护 进程 的 操作 系统 权限 运行 的 。 如 果 所 使 
用 的 编程 语言 允许 无 检查 的 内 存 访问 ， 那 么 修改 服务 器 的 内 部 数据 结构 也 是 可 能 的 。 因此 ， 
除了 其 它 问题 外 ， 这 样 的 函数 可 以 绕 过 任何 系统 访问 控制 。 允许 这 样 访问 的 函数 语言 都 被 认 
为 是 "不 可 信 的 "，PostgreSQL 只 爷 许 超级 用 户 使 用 这 样 的 语言 书写 函数 。 
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每 个 正在 运行 的 PostgreSQL 服 务 器 实例 都 管理 着 一 个 或 多 个 数据 库 。 因此 ， 在 组 织 SQL 对 象 
("数据 库 对 象 ") 的 层次 中 ， 数 据 库 位 于 最 顶层 。 本 章 描 述 数 据 库 的 属性 ， 以 及 如 何 创建 、 管 
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21.1. 概述 


数据 库 是 一 些 SQL 对 象 (" 数 据 库 对 象 ") 的 集合 ; 通常 每 个 数据 库 对 象 ( 表 、 画 数 等 ) 属 于 并 且 只 
属于 一 个 数据 库 。 不 过 有 几 个 系统 表 (比如 pg_database ) 属 于 整个 集群 并 且 可 以 在 集群 之 内 的 
每 个 数据 库 里 访问 。 更 准确 地 说 ， 一 个 数据 库 是 一 个 模式 的 集合 ， 而 模式 包含 表 、 画 数 等 
等 。 因此 完整 的 层次 是 这 样 的 : 服务 器 一 数据 库 一 模式 一 表 ( 或 者 其 它 类 型 对 象 ， 比 如 函 
数 )。 


在 与 数据 库 服 务 器 连接 的 时 候 ， 应 用 应 该 在 它 的 连接 请 求 里 指明 它 想 连 接 的 数据 库 名 称 。 不 
允许 在 一 次 连接 里 访问 多 个 数据 库 ( 不 过 没有 限制 一 个 应 用 可 以 建立 的 连接 数量 )。 数据 库 是 
物理 上 相互 隔离 的 ， 对 它们 的 访问 控制 是 在 连接 层次 进行 的 。 如 果 一 个 PostgreSQL 服 务 器 实 
例 用 于 承载 那些 应 该 分 隔 并 且 相 互 之 间 并 不 知晓 的 用 户 和 项 目 ， 那么 我 们 建议 把 它们 放 在 不 
同 的 数据 库 里 。 如 果 项 目 或 者 用 户 是 相互 关联 的 ， 并 且 可 以 相互 使 用 对 方 的 资源 ， 那 么 应 该 
把 它们 放 在 同一 个 数据 库 里 ， 但 可 能 在 不 同 的 模式 中 。 模式 只 是 一 个 纯粹 的 逻辑 结构 ， 谁 能 
访问 某 个 模式 由 权限 系统 控制 。 有 关 管 理 模式 的 更 多 信息 在 Section 5.7 里 。 


数据 库 是 使 用 CREATE DATABASE 命令 创建 的 (参阅 Section 21.2), 用 prop DATABASE 命令 删除 
(参阅 Section 21.5)。 要 查看 现 有 数据 库 的 集合 ， 可 以 检查 系统 表 pg_database ， 比 如 


SELECT datname FROM pg_database; 


psql 程 序 的 \1 元 命令 和 -1 命令 行 选 项 也 可 以 用 来 列 出 现存 的 数据 库 。 


Note: SQL 标 准 把 数据 库 称 作 " 目 录 "(catalog)， 不 过 这 两 个 东西 实际 上 没有 什么 区 别 。 


21.2. 创建 一 个 数据 库 


为 了 创建 数据 库 ， 必 须 先 运行 PostgreSQL 服 务 器 (参阅 Section 17.3)。 


数据 库 是 用 SQL 命令 CREATE DATABASE 创 建 的 : 


CREATE DATABASE _name_; 


这 里 的 name 遵循 SQL 标识 符 的 一 般 规 则 。 当前 角色 自动 成 为 此 新 数据 库 的 所 有 者 。 同 时 ， 
以 后 删除 这 个 数据 库 也 是 这 个 用 户 的 特权 (同时 还 会 删除 其 中 的 所 有 对 象 ， 即 使 那些 对 象 有 不 
同 的 所 有 者 也 这 样 )。 


创建 数据 库 是 一 个 有 限制 的 操作 。 参 阅 Section 20.2 获 取 如 何 赋予 权限 的 信息 。 


因为 你 需要 与 数据 库 服务 器 连接 才能 执行 CREATE DATABASE MS, 那么 还 有 一 个 问题 是 第 一 个 
数据 库 是 怎样 创建 的 ? 第 一 个 数据 库 总 是 由 initdb 命令 在 初始 化 数据 存储 区 的 时 候 创 建 的 
(参阅 Section 17.2)。 这 个 数据 库 叫 postgres 。 因 此 要 创建 第 一 个 "真正 " 的 数据 库 时 你 可 以 
与 postgres 连接 。 


在 数据 库 集群 初始 化 时 会 创建 另 一 个 名 为 templatea 的 数据 库 。 在 创建 一 个 新 的 数据 库 时 ， 
实际 上 就 是 克隆 (复制 ) 了 template1 数据 库 。 这 就 意味 着 你 对 template1 所 做 的 任何 修改 都 会 
传播 到 所 有 随后 创建 的 数据 库 中 。 因此 ， 避 免 在 template: 中 创建 对 象 ， 除 非 你 想 要 这 些 对 
象 传播 到 每 个 新 建 的 数据 库 中 。 更 多 细节 见 Section 21.3。 


另外 ， 为 了 方便 ， 你 还 可 以 在 shell 中 用 createdb 程序 来 创建 新 数据 库 : 


createdb _dbname_ 


createdb 没 变 什 么 魔术 ， 它 和 postgres 连接 并 执行 CREATE DATABASE 命令 ， 就 像 上 面 描述 的 
那样 。createdb 的 手册 页 包含 使 用 它 的 细节 。 注意 不 带 任何 参数 调用 createdb 将 创建 与 当前 
用 户 名 同名 的 数据 库 。 


Note: Chapter 19 包 含有 关 如 何 限制 哪些 用 户 可 以 连接 某 个 特定 数据 库 的 信息 。 


有 时 候 你 想 为 其 它 人 创建 一 个 数据 库 ， 并 且 使 他 应 该 成 为 新 数据 库 的 所 有 者 ， 这 样 他 就 可 以 
自己 配置 和 管理 这 个 数据 库 。 要 实现 这 个 目标 ， 使 用 下 列 命令 中 的 一 条 : 


CREATE DATABASE _dbname_ OWNER _rolename_; 


用 于 SQL 环境 ， 或 : 


createdb -0 _rolename_ _dbname_ 


用 于 命令 行 。 只 有 数据 库 的 超级 用 户 才能 为 其 它 用 户 创 建 数据 库 。 


21.3. 模板 数据 库 


CREATE DATABASE 实际 上 是 通过 拷贝 一 个 现 有 的 数据 库 进行 工作 的 。 缺 省 时 ， BENA 

为 templates 的 标准 系统 数据 库 。 所 以 该 数据 库 是 创建 新 数据 库 的 "模板 "。 如 果 你 

给 templatel 增加 对 象 ， 这 些 对 象 将 被 拷贝 到 随后 创建 的 用 户 数 据 库 中 。 这 样 的 行为 允许 节 
点 对 数据 库 中 的 标准 套件 进行 修改 。 比如 ， 如 果 你 把 过 程 语 言 PL/Perl 安 装 到 templates Æ, 
那么 你 在 创建 用 户 数 据 库 的 时 候 它 们 就 会 自动 可 得 ， 而 不 需要 额外 的 动作 。 


系统 里 还 有 名 为 templateo 的 第 二 个 标准 系统 数据 库 ， 这 个 数据 库 包 含 和 templates 初始 时 
一 样 的 数据 内 容 ， 也 就 是 说 ， 只 包含 标准 的 PostgreSQL 对 象 。 在 数据 库 集群 初始 化 之 后 ， 
我 们 不 应 该 对 templateo 做 任何 修改 。 通 过 告诉 CREATE DATABASE 使 用 templateo 而 不 

是 template1 进行 拷贝 ， 你 可 以 创建 一 个 "纯净 " 的 用 户 数据 库 ， 它 不 会 包含 任何 templatel 里 
所 特有 的 东西 。 这 一 点 在 恢复 pg_dump 转 储 的 时 候 是 非常 方便 的 : 转 储 脚本 应 该 在 一 个 纯净 
的 数据 库 中 恢复 以 确保 我 们 正确 创建 了 被 转 储 出 的 数据 库 内 容 ， 而 不 会 随后 和 可 能 已 经 添加 
到 templates 中 的 对 象 相 冲突 。 


拷贝 templated 而 不 是 template1 的 另 一 个 常见 原因 是 在 拷贝 templated 时 ， 可 以 指定 新 的 
编码 和 本 地 设置 ， 而 拷贝 templater 时 必须 使 用 和 templatel 相同 的 设置 。 这 是 因 
为 templates 可 能 包含 编码 指定 或 本 地 指定 的 数据 ， 而 templateo 不 这 样 。 


要 通过 拷贝 templated 的 方法 创建 一 个 数据 库 ， 可 使 用 : 


CREATE DATABASE _dbname_ TEMPLATE templated; 


用 于 SQL 环境 ， 或 : 


createdb -T templateO _dbname_ 


用 于 shell 环境 。 


我 们 可 以 创建 额外 的 模板 数据 库 ， 而 且 实际 上 我 们 可 以 在 一 个 集群 中 通过 将 

CREATE DATABASE 的 模板 声明 为 相应 的 数据 库 名 拷贝 任何 数据 库 。 不 过 ， 我 们 必需 明白 ， 这 个 
功能 并 非 一 般 性 的 " copy DATABASE "工具 。 实际 上 ， 在 拷贝 操作 的 过 程 中 ， 源 数据 库 必需 是 空 
闲 状 态 (没有 正在 处 理 的 数据 修改 事务 )。 如 果 在 create DATABASE 开始 的 时 候 存 在 其 它 连接 ， 
那么 操作 将 会 失败 ， 在 拷贝 期 间 ， 到 源 数据 库 的 新 连接 都 被 阻止 。 


在 pg_database 里 有 两 个 有 用 的 标志 可 以 用 于 每 个 数据 库 : 

datistemplate 和 datallowconn 字段 。 datistemplate 表示 该 数据 库 是 准备 用 

VE CREATE DATABASE 模板 的 。 如 果 设 置 了 这 个 标志 ， 那么 该 数据 库 可 以 由 任何 有 cREATEDB 权 
限 的 用 户 克 隆 ; 如 果 没 有 设置 ， 那么 只 有 超级 用 户 和 该 数据 库 的 所 有 者 可 以 克隆 它 。 如 
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果 datallowconn 为 假 ， 那么 将 不 允许 与 该 数据 库 发 生 任何 新 的 连接 (不 过 现 有 的 会 话 不 会 因为 
把 该 标志 设置 为 假 而 终止 )。 templateg 数据 库 通常 被 标记 为 datallowconn = false 以 避免 对 
它 的 修改 。 templateg 和 templatel 都 应 该 总 是 标记 为 datistemplate = true o 


Note: template1 和 templateo 没有 任何 特殊 的 状态 ， 除 

了 templatel 是 CREATE DATABASE 的 缺 省 源 数据 库 名 之 外 。 比 如 ， 我 们 可 以 删 

KR template1 然后 从 templateo 中 创建 它 而 不 会 有 任何 不 良 效果 。 如 果 我 们 不 小 心 
在 templates 里 加 了 一 堆 垃 圾 ， 那 么 我 们 就 会 建议 做 这 样 的 操作 。 (w 

除 templatel1 ， 必须 使 pg_database.datistemplate = false 。 ) 


在 初始 化 数据 库 集 群 的 时 候 ， 也 会 创建 postgres 数据 库 。 这 个 数据 库 用 于 做 为 用 户 和 应 
用 连接 的 缺 省 数据 库 。 它 只 是 templatel 的 一 个 简单 拷贝 ， 需要 的 时 候 可 以 删除 或 者 重 
建 。 
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21.4. 数据 库 配 置 


回顾 一 下 Chapter 18 我 们 知道 PostgreSQL 服务 器 提供 了 大 量 的 运行 时 配置 变量 。 你 可 以 为 许 
多 这 样 的 变量 设置 特定 于 数据 库 的 缺 省 数值 。 


比如 ， 如 果 由 于 某 种 原因 ， 你 想 关 闭 某 个 数据 库 上 的 GEQO 优 化 器 ， 你 就 不 得 不 要 么 在 一 开 
始 就 在 所 有 数据 库 中 关闭 它 ， 要 么 是 保证 每 个 连接 过 来 的 客户 端 都 很 小 心地 发 出 
了 SET geqo To off 命令 。 要 今 这 个 设置 在 特定 数据 库 里 成 为 缺 省 ， 你 可 以 执行 下 面 的 命令 : 


ALTER DATABASE mydb SET geqo TO off; 
这 样 将 保存 该 设置 (但 不 是 立即 设置 它 )。 在 随后 的 连接 中 它 将 表现 的 像 在 会 话 开始 后 马上 调用 


SET geqo TO off; 一 样 。 请 注意 用 户 仍 然 可 以 在 该 会 话 中 更 改 这 个 设置 ( 它 只 是 缺 省 )。 BB 
消 这 样 的 设置 ， 使 用 ALTER DATABASE _dbname_ RESET _varname_ o 


21.5. 删除 数据 库 


数据 库 是 用 DROP DATABASE 命 令 删 除 的 : 

DROP DATABASE _name_; 
只 有 数据 库 的 所 有 者 或 者 超级 用 户 才 可 以 删除 数据 库 。 删除 数据 库 会 删除 数据 库 中 包括 的 所 
有 对 象 。 数 据 库 的 删除 是 不 可 恢复 的 。 


你 不 能 在 与 目标 库 连 接 的 时 候 执 行 DROP DATABASE 命令 。 不 过 ， 你 可 以 和 其 它 数据 库 连 接 ， 
包括 template1 数据 库 。 template1 也 是 你 删除 集群 中 最 后 一 个 库 的 唯一 方法 。 


为 了 方便 ， 有 一 个 在 shell 上 运行 的 删除 数据 库 的 dropdb 程 序 : 


dropdb _dbname_ 


它 和 createdb 不 一 样 ， 没有 缺 省 删除 的 数据 库 名 称 。 


21.6. RZ iq 


PostgreSQL 里 的 表 空 间 允 许 数 据 库 管理 员 在 文件 系统 里 定义 那些 代表 数据 库 对 象 的 文件 存放 
位 置 。 一 旦 创建 了 表 空 间 ， 那 么 就 可 以 在 创建 数据 库 对 象 的 时 候 引 用 它 。 

通过 使 用 表 空 间 ， 管 理 员 可 以 控制 一 个 PostgreSQL 安 装 的 磁盘 布局 。 这 么 做 至 少 有 两 个 用 
处 。 首 先 ， 如 果 初 始 化 集群 所 在 的 分 区 或 者 耸 用 光 了 空间 ， 而 又 不 能 扩展 ， 那 么 表 空 间 可 以 
在 一 个 不 同 的 分 区 上 创建 和 使 用 ， 直到 系统 可 以 重新 配置 。 


第 二 ， 表 空间 允许 管理 员 根 据 数据 库 对 象 的 使 用 模式 安排 数据 位 置 ， 从 而 优化 性 能 。 比 如 ， 

一 个 很 频繁 使 用 的 索引 可 以 放 在 非常 快 并 且 非 常 可 靠 的 磁盘 上 ， 比 如 一 种 非常 贵 的 固态 设 

备 。 而 同时 ， 一 个 存储 兴 档 的 数据 ， 很 少 使 用 的 或 者 对 性 能 要 求 不 高 的 表 可 以 存储 在 一 个 便 
宜 但 比较 慢 的 磁盘 系统 上 。 


要 定义 一 个 表 空 间 ， 使 用 CREATE TABLESPACE 命 令 ， 比 如 : 


CREATE TABLESPACE fastspace LOCATION '/mnt/sdai/postgresql/data'; 


这 个 位 置 必须 是 一 个 现 有 的 空 目 录 ， 并 且 属 于 PostgreSQL 系 统 用 户 。 所 有 随后 在 该 表 空 间 创 
建 的 对 象 都 将 被 存放 在 这 个 目录 下 的 文件 里 。 





Note: 通常 在 一 个 逻辑 文件 系统 上 建立 多 个 表 空 间 没 有 什么 意义 ， 因为 无 法 控制 一 个 罗 
辑 文 件 系统 里 不 同文 件 的 位 置 。 不 过 ，PostgreSQL 并 不 做 这 方面 的 任何 强制 ， 并 且 它 实 
际 上 并 不 知道 文件 系统 边界 。 它 只 知道 在 指定 的 目录 里 存储 文件 。 






































创建 表 空 间 本 身 必须 用 数据 库 超级 用 户 身 份 进行 ， 但 之 后 你 就 可 以 允许 普通 数据 库 用 户 利用 
ET. 要 做 这 件 事 情 ， 在 表 空 间 上 给 这 些 用 户 授 予 cREATE 权限 。 


表 、 索 引 和 整个 数据 库 都 可 以 放 在 特定 的 表 空 间 里 。 想 要 这 么 做 的 话 ， 在 给 定 表 空间 上 
有 cREATE 权限 的 用 户 必须 把 表 空 间 的 名 字 以 一 个 参数 的 形式 传递 给 相关 的 命令 。 比如 ， 下 面 
的 命令 在 表 空 间 spacer 上 创建 一 个 表 : 


CREATE TABLE foo(i int) TABLESPACE spacei; 


另外 ， 还 可 以 使 用 default tablespace 参 数 : 


SET default_tablespace = space1; 
CREATE TABLE foo(i int); 


只 要 default_tablespace 被 设置 为 非 空 字符 串 ， 那么 它 就 为 没有 明确 使 用 TABLESPACE 子 句 


的 CREATE TABLE 和 CREATE INDEX 命令 提供 一 个 隐 含 的 子 句 。 


也 有 一 个 temp_tablespaces 参 数 ， 决 定 临时 表 和 索引 的 放置 ， 就 和 用 于 像 存 储 大 数据 集 这 样 
的 目的 临时 文件 一 样 。 这 可 能 是 一 个 表 空 间 名 字 的 列表 ， 而 不 是 只 有 一 个 名 字 ， 所 以 与 临时 
对 象 相关 联 的 负载 可 以 散布 到 多 个 表 空 间 中 。 每 次 创建 临时 对 象 时 选择 一 个 随机 的 成 员 列 
Ro 

与 一 个 数据 库 相关 联 的 表 空间 用 于 存储 该 数据 库 的 系统 表 。 另 外 ， 如 果 没 有 给 

出 TABLESPACE F 4, 并 且 没 有 通过 default_tablespace 或 temp_tablespaces ( 视 情况 而 定 ) 
指定 其 他 选项 ， 那 么 在 数据 库 中 创建 表 ， 索引 和 临时 文件 时 使 用 的 是 缺 省 表 空间 。 如 果 创 建 
数据 库 时 没有 给 它 声明 一 个 表 空 间 ， 那么 它 使 用 与 它 拷贝 的 模版 数据 库 相 同 的 表 空 间 。 


当 数 据 库 集 群 初始 化 时 ， 自 动 创建 两 个 表 空 间 。 pg_global 表 空 间 用 于 共享 的 系统 表 。 
pg_default 是 template1 和 templated 数据 库 的 缺 省 表 空 间 (因此 ， 这 个 表 空 间 也 将 是 任何 其 
它 数 据 库 的 缺 省 表 空间 ， 除 非 在 cREATE DATABASE 中 通过 TABLESPACE 子 句 重 写 )。 


创建 了 表 空 间 之 后 ， 它 就 可 以 用 于 任何 数据 库 ， 只 要 请 求 的 用 户 有 足够 权限 。 这 意味 着 除非 
我 们 把 使 用 这 个 表 空 间 的 所 有 数据 库 里 的 所 有 对 象 都 删除 掉 ， 否 则 我 们 不 能 删除 该 表 空 间 。 


要 删除 一 个 空 的 表 空 间 ， 使 用 DROP TABLESPACER S., 


检查 pg tablespace 有 系统 表 就 可 以 获取 现 有 的 表 空 间 ， 比 如 


SELECT spcname FROM pg_tablespace; 


psql 程 序 的 \db 元 命令 也 可 以 用 于 列 出 现 有 表 空 间 。 


为 了 简化 表 空 间 的 实现 ，PostgreSQL 使 用 了 符号 连接 。 这 就 意味 着 表 空 间 只 能 在 支持 符号 连 
接 的 系统 上 使 用 。 


目录 speoArA/pg_tblspe 包含 指向 集群 里 定义 的 每 个 非 内 置 表 空 间 的 符号 连接 。 尽管 我 们 不 寻 
议 ， 但 是 我 们 还 是 可 能 通过 手工 重 定义 这 些 连 接 来 调整 表 空 间 的 布局 。 在 服务 器 运行 的 时 候 
不 要 这 么 干 。 注 意 在 PostgreSQL 9.1 及 以 前 ， 你 仍 需 要 用 新 的 位 置 更 新 pg_tablespace Ro 
如 果 你 不 这 么 做 ， pg_dump 将 继续 显示 旧 的 表 空 间 位 置 。 
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本 章 从 管理 员 的 角度 描述 可 用 的 区 域 特性 。PostgreSQL 支持 2 种 区 域 设置 : 


。 利用 操作 系统 的 区 域 (locale) 特 性 ， 提 供 区 域 特定 的 排序 顺序 、 数 值 格 式 、 本 地 消息 和 其 
它 方面 的 支持 。 这 些 都 位 于 Section 22.1 和 Section 22.2 中 。 


。 提供 多 种 不 同 的 字符 集 以 支持 存储 各 种 语言 的 文本 、 并 且 提 供 客 户 端 和 服务 器 端 之 间 的 
字符 集 转 换 。 这 些 位 于 Section 22.3 中 。 


22.1. 区 域 支持 


区 域 支持 指 的 是 应 用 中 考虑 字母 、 排 序 、 数 值 格式 化 等 与 文化 相关 的 问题 。 PostgreSQL 使 用 
服务 器 操作 系统 提供 的 标准 ISO C 和 POSIX 区 域 机 制 。 更 多 的 信息 请 参考 你 的 系统 文档 。 


22.1.1. 概述 


区 域 支持 是 在 使 用 initdb 创建 一 个 数据 库 集 群 的 时 候 自 动 初始 化 的 。 缺 省 时 ， initdb 将 会 
按照 它 的 执行 环境 的 区 域 设 置 初始 化 数据 库 集 群 ;因此 如 果 你 的 系统 已 经 设置 为 你 的 数据 库 
集群 想 要 的 区 域 ， 那 么 你 就 没有 什么 可 干 的 了 。 如 果 你 想 使 用 其 它 的 区 域 (或 者 你 还 不 知道 你 
的 系统 设置 的 区 域 是 什么 )， 那么 你 可 以 用 --locale 命令 行 选项 告诉 inito 你 需要 的 区 域 究 
竟 是 哪个 。 比如 : 


initdb --locale=sv_SE 


Unix 系 统 下 的 这 个 例子 就 把 区 域 设 置 为 说 瑞典 语 ( sv )， 并 且 在 瑞典 地 区 ( se). 其 它 的 可 能 
性 是 onus (美国 英语 ) 和 fr_cA (加 拿 大 法 语 ) 等 等 。 如 果 有 多 于 一 种 的 字符 集 可 以 用 于 同一 个 
区 域 ， 那 么 声明 看 起 来 会 像 _language_territory.codeset 。 上 比如 ， fr_BE.UTF-8 表示 为 在 比 
利 时 (BE) 地 区 使 用 的 法 语 (fr)， 并 且 使 用 UTF-8 字 符 集 编码 。 


你 的 系统 里 有 哪些 可 用 的 区 域 设置 ， 它 们 的 名 字 是 什么 ， 这 些 信 息 都 取决 于 你 的 操作 系统 提 
供 商 提供 了 什么 以 及 你 安装 了 什么 东西 。 在 大 多 数 系 统 上 ， 命 令 locale -a 将 提供 所 有 可 用 
区 域 的 一 个 列表 。 Windows 使 用 更 详细 的 区 域名 称 ， 比如 German_Germany 或 


者 swedish_sweden.1252 ， 但 是 原则 是 一 样 的 。 


有 时 候 ， 把 几 种 区 域 规则 混合 起 来 也 很 有 用 ， 上 比如 ， 使 用 英语 排序 规则 而 用 西班牙 语 消息 。 
为 了 支持 这 些 ， 我 们 有 一 套 区 域 子 范畴 用 于 控制 区 域 规则 的 某 一 方面 : 


LC_COLLATE 字符 串 排 序 顺序 

LC_CTYPE 字符 分 类 (什么 是 字母 ?是 否 区 分 大 小 写 ?) 
LC_MESSAGES 消息 的 语言 

LC_MONETARY 货币 金额 的 格式 

LC_NUMERIC 数值 格式 

LC_TIME 日 期 和 时 间 格 式 


这 些 范 畴 名 转换 成 initdb 选项 的 名 字 以 覆盖 某 个 特定 范畴 的 区 域 选择 。 比如 ， 要 把 区 域 设 置 
为 加 拿 大 法 语 ， 但 使 用 美国 的 货币 格式 化 规则 ， 可 以 使 


用 initdb --locale=fr_ca --lc-monetary=en_US o 


如 果 你 想 要 你 的 系统 表现 得 像 没 有 区 域 支持 一 样 ， 那 么 使 用 特殊 的 区 域 c 或 PosIx o 


一 些 区 域 范畴 的 值 必 须 在 创建 数据 库 时 固定 下 来 。 您 可 以 对 不 同 的 数据 库 使 用 不 同 的 设置 ， 

但 一 旦 创建 一 个 数据 库 ， 你 就 再 也 不 能 更 改 它们 了 。 Lc_corLATE 和 Lc_cTYPE 就 是 这 样 的 范 
E 它们 影响 索引 的 排序 顺序 ， 因 此 它们 必需 保持 固定 ， 否 则 在 文本 字段 上 的 素 引 将 会 崩 

žo (但 是 你 可 以 使 用 排序 规则 (collation) 缓 解 这 种 限制 ， 正 如 Section 22.2 中 讨论 的 ) 。 当 
运行 initdb 时 确定 这 些 范畴 的 缺 省 值 ， 这 些 值 被 用 于 创建 新 的 数据 库 ， 除 非 


在 CREATE DATABASE 命令 中 明确 指定 。 


其 它 区 域 范 畴 可 以 在 服务 器 启动 的 时 候 根据 需要 设置 服务 器 配置 参数 来 改变 (参阅 Section 
18.11.2 获 取 细 节 )。 initdb 选择 的 值 实 际 上 只 是 作为 服务 器 筷 动 时 的 缺 省 值 写 人 
postgresql.conf 配置 文件 。 如 果 你 在 postgresql.conf 里 面 删 除了 这 些 设 置 ， 那么 服务 器 将 
会 继承 来 自 运行 环境 的 设置 。 


请 注意 服务 器 的 区 域 行为 是 由 它 看 到 的 环境 变量 决定 的 ， 而 不 受 客户 端的 环境 影响 。 因此 ， 
我 们 要 在 启动 服务 器 之 前 认真 地 设置 好 这 些 变量 。 这 样 带 来 的 一 种 情况 是 如 果 客 户 端 和 服务 
器 设置 成 不 同 的 区 域 ， 那么 消息 可 能 以 不 同 的 语言 呈现 ， 这 取决 于 消息 的 来 源 。 


Note: 在 我 们 谈 到 从 执行 环境 继承 区 域 的 时 候 ， 我 们 的 意思 是 在 大 多 数 操作 系统 上 的 下 
列 动作 : 对 于 一 个 给 定 的 区 域 范 畴 ， 比如 排序 规则 ， 按 照 下 面 的 顺序 评估 这 些 环境 变 
量 ， 直到 找到 一 个 已 设置 的 : Lc ALL ，Lc_coLLATE (或 者 对 应 于 相应 范畴 的 其 他 变量 )， 
LANG 。 如 果 这 些 环境 变量 一 个 都 没有 设置 ， 那 么 区 域 缺 省 为 c 。 











一 些 消息 本 地 化 库 也 使 用 环境 变量 LANGuAGE ， 它 履 盖 所 有 其 它 用 于 设置 语言 信息 的 区 域 
设置 。 如 果 有 问题 ， 请 参考 你 的 操作 系统 文档 ， 特别 是 gettext 的 文档 以 获取 更 多 信息 


要 能 够 将 消息 翻译 成 用 户 选择 的 语言 ， 编译 时 必需 选择 NLS 选 项 ( configure --enable-nls )。 
其 它 区 域 支持 是 自动 包含 的 。 


22.1.2. 行为 


区 域 设置 特别 影响 下 面 的 SQL 特性 : 
。 查询 中 使 用 oRDER BY 或 者 对 文本 数据 的 标准 比较 操作 符 进行 排序 
e upper, lower 和 initcap KX 


。 模式 匹配 运算 符 ( LIKE, SIMILAR To , 以 及 POSIX- 风 格 的 正则 表达 式 ) ; 区 域 影响 大 小 写 
不 敏感 的 匹配 和 通过 字符 分 类 正则 表达 式 的 字符 分 类 。 


@ to char KAR 


e 使 用 LIkE 子 句 的 索引 能 


PostgreSQL #2 $ FAZE c 或 者 posis 区 域 的 缺点 是 性 能 影响 。 它 降低 了 字符 义理 的 速度 并 阻 
止 了 在 LIkE 类 查询 里 面 普通 索引 的 使 用 。 因此 ， 应 该 只 有 在 你 实际 上 需要 的 时 候 才 使 用 


它 。 


为 了 允许 PostgreSQL 在 非 C 区 域 下 的 LIKE 子 句 中 使 用 索引 ， 有 好 几 个 自 定义 的 操作 符 类 可 
以 用 。 这 些 操作 符 类 允许 创建 一 个 严格 地 比较 每 个 字符 的 素 引 ， 而 忽略 区 域 比 较 规则 。 请 参 
考 Section 11.9 获 取 更 多 信息 。 另外 一 个 方法 是 使 用 c collation 创 建 索 引 ， 正 如 Section 22.2 
中 讨论 的 。 


22.1.3. 问题 


如 果 经 过 上 面 解 释 后 区 域 支持 仍然 不 能 运转 ， 那 你 就 要 检查 一 下 操作 系统 的 区 域 支持 是 否 正 
确 配 置 。 要 检查 某 个 区 域 是 否 安装 并 且 正 常 运 转 ， 你 可 以 使 用 locale -a 命令 (如 果 你 的 系统 


提供 了 该 命令 )。 


请 检查 核实 PostgreSQL 确 实 使 用 了 你 认为 它 该 用 的 区 域 设置 。 Lc_coLLATE 和 Lc_cTYPE 的 设 
置 都 是 在 数据 库 创建 时 决定 的 ， 不 能 被 改变 除非 创建 新 的 数据 库 。 其 它 的 区 域 设 置 包括 
LC_MESSAGES 和 Lc_MONETARY 都 是 由 服务 器 的 启动 环境 决定 的 ， 但 是 可 以 在 运行 时 修改 。 你 
可 以 用 show 命令 检查 数据 库 正在 使 用 的 区 域 设置 。 


源码 发 布 中 的 src/test/locale 目录 包含 PostgreSQL 的 区 域 支 持 测 试 套件 。 


那些 通过 解析 错误 消息 文本 义理 服务 器 端 错误 的 客户 端 应 用 很 明显 会 有 问题 ， 因为 服务 器 信 
息 可 能 会 以 不 同 的 语言 表示 。 我 们 建议 这 类 应 用 的 开发 人 员 改 用 错误 代码 机 制 。 

维护 消息 翻译 表 需 要 许多 志愿 者 的 坚持 不 懈 的 努力 ， 他 们 就 是 希望 PostgreSQL 以 他 们 的 语言 
说 话 的 人 。 如 果 你 的 语言 消息 目前 还 不 可 用 或 者 没有 完全 翻译 完成 ， 那么 我 们 很 欢迎 你 的 协 
助 。 如 果 你 想 帮 忙 ， 那么 请 参考 Chapter 50 或 者 向 开发 者 邮递 列表 发 邮件 。 


2. 排序 规则 支持 


BEES 规则 特性 允许 为 每 一 列 数据 指定 排序 顺序 和 字符 分 类 行为 ， 或 者 甚至 为 每 个 操作 指定 。 
缓解 了 Lc_coLLATE 和 Lc_cTYPE 在 数据 库 被 创建 后 不 能 被 修改 的 限制 。 


bi 


22.2.1. 概念 


从 概念 上 讲 ，collatable 数 据 类 型 的 每 个 表达 式 都 有 一 个 排序 规则 。 《内 置 collatable 数 据 类 型 
有 text, varchar 以 及 char. 用 户 定义 的 基本 类 型 ， 也 可 以 标记 为 collatable， 当然 一 个 
collatable 数 据 类 型 的 域 也 是 collatable 的 ) 。 如 果 表 达 式 是 一 个 列 引 用 ， 该 表达 式 的 排序 规则 
是 就 这 个 列 的 排序 规则 。 如 果 表 达 式 是 一 个 常数 ， 排 序 规则 是 常数 数据 类 型 的 缺 省 排序 规 
则 。 一 个 更 复杂 表达 式 的 排序 规则 从 它 的 输入 端 排 序 规则 推导 ， 如 下 所 述 。 


一 个 表达 式 的 排序 规则 可 以 是 " 缺 省 "排序 规则 ， 这 意味 着 为 数据 库 的 区 域 设置 。 它 也 可 以 用 
于 表达 式 的 排序 规则 是 不 确定 的 。 在 这 种 情况 下 ， 排 序 操作 符 以 及 其 他 需要 知道 排序 规则 的 
操作 符 会 在 执行 时 失败 。 


当 数 据 库 系统 必须 执行 排序 或 字符 分 类 时 ， 它 使 用 输入 表达 式 的 排序 规则 。 这 种 情况 发 生 ， 

例如 ， 使 用 oRDER BY FA 以 及 函数 或 运算 符 调用 比如 ait; o 应 用 到 oRDER BY 子 句 中 的 排 
序 规 则 直接 就 是 排序 关键 字 的 排序 规则 。 上 应 用 到 函数 或 操作 符 调用 的 排序 规则 要 从 参数 上 派 
Æ, 如 下 文 所 述 。 除 了 上 比较 操作 符 外 ， ADS HARA, HO lower, upper 和 

initcap ; 模式 匹配 运算 符号 ; 以 及 to_char 及 其 相关 函数 都 需要 考虑 排序 规则 。 


对 于 一 个 函数 或 运算 符 调 用 ， 通过 检查 用 来 在 运行 时 执行 指定 操作 的 参数 排序 规则 派生 出 该 
Bead dees ee we a ee ee 
外 围 表达 式 ， 排序 规则 也 可 用 于 在 解析 时 作为 函数 或 运算 符 表 达 式 的 定义 的 排序 规则 。 


表达 式 的 排序 规则 推导 可 以 是 隐 式 或 显 式 的 。 当 多 个 不 同 的 排序 规则 出 现在 表达 式 中 ， 这 种 
区 别 会 影响 排序 规则 如 何 组 合 ， 当 使 用 coa 子 句 的 时 候 ， 产 生 显 式 排序 规则 推导 ;所 有 其 
他 排序 规则 推导 是 余 式 的 。 当 多 个 排序 规则 必须 结合 时 ， 例 如 在 一 个 画 数 调 用 中 ， 使 用 下 面 
的 规则 : 


1， 如 果 任 何 输入 表达 式 有 显 式 的 排序 规则 推导 ， 那 么 输入 表达 式 中 所 有 显 式 派生 的 排序 规 
则 必须 是 一 样 的 ， 否则 将 引发 错误 。 如 果 有 任何 显 式 派 生 的 排序 规则 ， 这 即 是 排序 规则 
组 合 的 结果 。 


2. 否则 ， 所 有 输入 表达 式 必 须 具 有 相同 的 隐 式 排序 规则 推导 或 者 缺 省 排序 规则 。 如 果 出 现 
任何 非 缺 省 的 排序 规则 ， 则 是 这 就 是 排序 组 合 的 结果 。 和 否则， 结果 是 缺 省 排序 规则 。 


3. 如 果 在 输入 的 表达 式 之 间 非 缺 省 的 隐 式 排序 规则 有 冲突 ， 那么 该 组 合 视 为 不 明确 的 排序 
规则 。 这 不 是 一 个 错误 情况 ， 除 非 被 调用 的 那个 函数 需要 知道 排序 规则 。 如 果 是 这 样 ， 
在 运行 时 将 引发 一 个 错误 。 


比如 ， 考 虑 这 个 表 定 义 : 


CREATE TABLE test1 ( 
a text COLLATE "de_DE", 
b text COLLATE "es_ES", 


然后 


SELECT a < 'foo' FROM testi; 


按照 ue_pE 规则 ， 执 行 elt; 比较 ， 因 为 表达 式 组 合 隐 式 推导 排序 规则 与 缺 省 排序 规则 ， 但 


=| 
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SELECT a < ('foo' COLLATE "fr_FR") FROM testi; 


使 用 fr_FR 规则 执行 比较 ， 因 为 显 式 排 序 规则 覆盖 了 人 隐 式 的 。 此 外 ， 


SELECT a < b FROM testi; 


解析 器 无 法 确定 应 该 应 用 哪个 排序 规则 ， 因 为 a 列 和 b 列 拥有 冲突 的 隐 式 排序 规则 。 
为 alt; 操作 符 确实 需要 知道 所 使 用 的 排序 规则 ， 这 将 导致 一 个 错误 。 错误 可 以 通过 附加 一 
个 明确 的 排序 规则 说 明 符 给 输入 表达 式 得 以 解决 ， 如 下 : 


SELECT a < b COLLATE "de_DE" FROM testi; 


或 者 等 效 的 ， 
SELECT a COLLATE "de_DE" < b FROM test1; 


另 一 方面 ， 结 构 上 类 似 的 情况 


SELECT a || b FROM testi; 


会 产生 错误 ， 因 为 1) 操作 符 并 不 关心 排序 规则 : 不 论 什么 排序 规则 结果 都 是 一 样 的 。 


MRNA KS HR le ieee an an ah Ay 那么 分 配给 函数 或 者 操作 符 的 组 合 的 输入 
表达 式 的 排序 规则 用 到 函数 或 者 操作 符 结果 上 。 因此 ， 


SELECT * FROM testi ORDER BY a || 'foo'; 


按照 ue_pE 规则 执行 该 排序 。 但 是 这 个 查询 : 


SELECT * FROM testi ORDER BY a || b; 


导致 一 个 错误 ， 因 为 即使 || 操作 符 不 需要 知道 排序 规则 ， 而 oRDER BY 子 句 确实 需要 。 和 前 
面 一 样 ， 可 以 使 用 显 式 的 排序 规则 说 明 符 解决 这 个 冲突 。 


SELECT * FROM testi ORDER BY a || b COLLATE "fr_FR"; 


22.2.2. 管理 排序 规则 


排序 规则 是 把 SQL 名 称 映 射 到 操作 系统 区 域 的 SQL 模式 对 象 。 特别 是 ， 它 映射 

到 Lc_coLLATE 和 Lc_cTYPE 的 组 合 。 (顾名思义 ， 排 序 规则 的 主要 目的 是 设置 Lc_coLLATE ， 
它 控制 排序 顺序 。 但 在 实际 中 很 少 需要 一 个 和 Lc_coLLATE 不 同 的 Lc_cTYPE 设置 ， 所 以 将 它 
们 合 在 一 起 ， 而 不 是 为 每 个 表达 式 另 外 创造 一 个 设置 Lc_cTYPE 的 基础 设施 ， 更 为 方便 ) 。 
另外 ， 排 序 规则 和 字符 集 编码 (参见 Section 22.3) 紧密 关联 。 对 不 同 的 编码 可 能 存在 同名 的 
排序 规则 。 


在 所 有 平台 上 ， 名 称 为 default, c 和 posix 排序 规则 都 是 可 用 的 。 其 他 可 用 的 排序 规则 BY 
决 于 操作 系统 支持 。 default 排序 规则 选择 在 创建 数据 库 时 指定 的 Lc_coLLATE 

和 Lc_cTYPE 值 。 c 和 posix 的 排序 规则 都 表现 为 "传统 C" 的 行为 ， 即 只 有 ASCII 字 

母 " A "到 " z " 被 视 为 字母 ， 并 且 严 格 按照 字符 的 编码 字 节 值 进行 排序 。 


如 果 操 作 系统 提供 了 在 一 个 程序 中 使 用 多 语言 环境 的 支持 ( newlocale 以 及 相关 画 数 )， 那 么 当 
一 个 数据 库 集 群 初 始 化 的 时 候 ， initdb 使 用 基于 当时 在 操作 系统 上 发 现 的 所 有 语言 环境 的 排 
序 规 则 来 填充 系统 表 pg_collation o 例如 ， 操 作 系 统 可 能 提供 名 为 de_pe.utts 的 区 域 。 那 
么 ， initdb 就 可 能 为 编码 utes 创建 命名 为 ”de_pE.utf8 的 排序 规则 ， 它 的 Lc_coLLATE 和 
LC_CTYPE 都 被 设置 为 de_pE.utf8 o 它 还 将 创建 名 称 中 被 剥离 了 .utf8 标签 的 排序 规则 。 所 
以 ， 你 也 可 以 使 用 deo 名 称 的 排序 规则 ， 这 方便 于 编写 并 且 使 得 名 称 较 少 依赖 于 编码 。 然 
而 ， 需 要 注意 的 是 ， 排序 规则 名 称 的 初始 设置 是 平台 相关 的 。 


在 需要 有 不 同 的 Lc_coLLATE 和 Lc_cTYPE 值 的 排序 规则 的 情况 下 ， 可 以 使 用 CREATE 
COLLATION 命令 创建 新 的 排序 规则 。 该 命令 也 可 以 从 现 有 排序 规则 中 创建 一 个 新 的 ， 这 可 
能 是 有 用 的 ， 以 便 能 够 在 应 用 中 使 用 操作 系统 无 关 的 排序 规则 名 称 。 


在 任何 特定 的 数据 库 中 ， 只 关心 使 用 该 数据 库 编码 的 排序 规则 。 pg_collation 中 的 其 他 项 目 
会 被 忽略 。 因 此 ， 剥 离 了 编码 名 的 排序 规则 名 称 ， 如 de_pE ， 在 一 个 给 定 的 数据 库 中 也 算是 
独一无二 的 ， 即 使 它 不 是 全 局 唯一 的 。 建议 使 用 剥离 过 的 排序 规则 名 称 ， 因 为 如 果 你 以 后 决 


定 改变 到 另 一 个 数据 库 编码 ， 可 以 少 改变 一 样 东 西 。 但 是 请 注意 ， 无 论 是 什么 数据 库 编码 ， 
都 可 以 使 用 default , c 和 posix 排序 规则 。 


PostgreSQL 认 为 不 同 排序 规则 对 象 是 不 兼容 的 ， 即 使 他 们 有 相同 的 属性 。 例如 : 


SELECT a COLLATE "C" < b COLLATE "POSIX" FROM testi; 


将 引起 一 个 错误 ， 即 使 c 和 posix 排序 规则 具有 完全 相同 的 行为 。 因 此 不 推荐 混合 剥离 的 和 
非 剥 离 的 排序 规则 名 。 


22.3. 字符 集 支 持 


PostgreSQL 中 的 字符 集 支 持 可 以 让 你 以 各 种 字符 集 存 储 文本 〈 也 称 为 编码 ) ， 包含 单字 节 字 
符 集 ， 比 如 ISO-8859 系 列 和 多 字 节 字符 集 比 如 EUC( 扩 展 Unix 编 码 )、 UTF-8、Mule 国 际 编 
m. 所 有 字符 集 都 可 以 被 客 户 端 透明 地 使 用 。 但 是 有 一 些 不 支持 在 服务 器 上 使 用 〈 即 作为 服 
务 器 端 编码 ) 。 缺 省 的 字符 集 是 在 使 用 inita 初始 化 数据 库 集群 的 时 候选 择 的 。 在 你 创建 
数据 库 的 时 候 是 可 以 覆盖 这 个 缺 省 值 的 。 因 此 ， 你 可 以 有 多 个 数据 库 ， 每 个 都 有 不 同 的 字符 
集 。 


但 是 ， 有 一 个 重要 的 限制 ， 每 个 数据 库 的 字符 集 必须 和 与 该 数据 库 的 Lc_cTYPE (字符 类 别 ) 以 
及 Lc_coLLATE (字符 串 排序 顺序 ) 区 域 设 置 相 兼容 。 对 于 c 或 者 posix 区 域 ， 人 允许 任何 字 
符 集 ， 但 对 于 其 他 区 域 只 有 一 个 字符 集 设置 能 正常 工作 。 (不 过 在 Windows 上 ，UTF-8 编 码 
可 用 于 任何 区 域 ) 。 


22.3.1. 文 持 的 字符 集 


Table 22-1 显 示 了 可 以 在 PostgreSQL 中 使 用 的 字符 集 。 


Table 22-1. PostgreSQL 字 符 集 


字 
服 节 
名 字 描述 语言 务 数 / 别名 
im? + 
符 
pros AR MARX No 12 MMS 
EUC_CN i 简体 中 文 Yes | 1-3 
EUC_JP 扩展 UNIX 代 日 文 Yes 1-3 
a" 码 -JP 
扩展 UNIX 代 
EUC_JIS_2004 码 -JP, JIS X AX Yes | 1-3 
0213 
EUC_KR 扩展 UNIX 代 韩文 Yes 1-3 
~ 码 -KR 
扩展 UNIX 代 繁体 中 文 f 
EUC_TW 码 -TW 台湾 Yes 1-3 
GB18030 国标 码 中 文 No 1-2 
GBK 扩展 国标 码 ” ”简体 中 文 Mo 1-25 || Rites 


GBK 


ISO_8859_5 


ISO_8859_6 


ISO_8859_7 


ISO_8859_8 


JOHAB 


KOI8R 


KOI8U 


LATIN1 


LATIN2 


LATINS 


LATIN4 


LATINS 


LATING 


LATIN7 


LATIN8 


LATIN9 


LATIN10 


MULE_INTERNAL 


SJIS 


扩展 国标 码 
ISO 8859-5, 
ECMA 113 


ISO 8859-6, 
ECMA 114 


ISO 8859-7, 
ECMA 118 


ISO 8859-8, 
ECMA 121 


JOHAB 


KOI8-R 


KOI8-U 


ISO 8859-1, 
ECMA 94 


ISO 8859-2, 
ECMA 94 


ISO 8859-3, 
ECMA 94 


ISO 8859-4, 
ECMA 94 


ISO 8859-9, 
ECMA 128 


ISO 8859-10, 


ECMA 144 
ISO 8859-13 
ISO 8859-14 


ISO 8859-15 


ISO 8859-16, 


ASRO SR 
14111 


Mule internal 
code 


Shift JIS 


简体 中 文 


拉丁 /西里 尔 


语 


拉丁 /阿拉 伯 


语 
拉丁 /希腊 语 


拉丁 / 希 伯 莱 


语 
韩语 


西里 尔 语 ( 俄 
国 ) 


西里 尔 语 ( 乌 


西欧 语 


ER i 


南欧 语 


北欧 语 


日 耳 曼 语 
波罗的海 语 
ZR ARS 
带 有 了 欧洲 语 


系 和 语调 的 
LATIN1 


罗马 尼 亚 语 


多 语种 
Emacs 


日 语 


Yes 


Yes 


Yes 


No 


Yes 


Yes 


Yes 


Yes 


Yes 


Yes 


Yes 


Yes 


Yes 


Yes 


Yes 


Yes 


Yes 


No 


1-2 


1-2 


Windows936 


KOI8 


IS088591 


IS088592 


IS088593 


IS088594 


IS088599 


IS0885910 


IS0885913 


IS0885914 


IS0885915 


IS0885916 


Mskanji , 
ShiftJIS , 
WIN932 , 


Shift JIS, JIS 


SHIFT_JIS_2004 X 0213 日 语 No 1-2 

SQL_ASCII ees d 任意 Yes 1 

: a 
UTF8 oe 8- 全 部 Yes 1-4 Unicode 
WIN866 eas 西里 尔 语 Yes 1 ALT 

WIN874 oe 泰国 语 Yes 1 

WIN1250 eee 中 欧 语 Yes 1 

WIN1251 ee 西里 尔 语 Yes 1 WIN 
WIN1252 Be 西欧 语 Yes 1 

WIN1253 a 希腊 语 Yes 1 

WIN1254 人 土耳其 语 Yes 1 

WIN1255 ee 希 伯 来 语 Yes 1 

WIN1256 ue BAA Yes 1 

WIN1257 Aun 波 罗 的 语 Yes 1 

wo me 


并 非 所 有 API 都 支持 上 面 列 出 的 编码 。 比 如 ， PostgreSQL JDBC 了 驱动 就 不 支 


持 MULE_INTERNAL , LATING ，LATIN8 和 LATINIO o 


SQL_ASCII 设置 与 其 它 设 置 表 现 得 相当 不 同 。 如 果 服 务 器 字符 集 是 sQL_AscII ， 服务 器 根据 
ASCII 标 准 解析 0-127 的 字 节 值 ， 而 字 节 值 为 128-255 的 则 当 作 未 解析 的 字符 。 如 果 设 置 

为 SQL_AscII 就 不 会 有 编码 转换 。 因 此 ， 这 个 设置 基本 不 用 来 声明 所 使 用 的 编码 ， 因为 这 个 
声明 会 忽略 编码 。 在 大 多 数 情况 下 ， 如 果 你 使 用 了 任何 非 ASCIl 数 据 ， 那么 使 用 sQL_AsciI 设 
置 都 是 不 明智 的 ， 因 为 PostgreSQL 会 无 法 帮助 你 转换 或 者 校 验 非 ASCII 字 符 。 


22.3.2. 设置 字符 集 
initdb 为 一 个 PostgreSQL 集群 定义 缺 省 的 字符 集 (编码 ) ， 比 如 : 


initdb -E EUC_JP 


把 缺 省 字符 集 设置 为 cuca (用 于 日 文 的 扩展 Unix 编 码 )。 如 果 你 喜欢 用 长 选项 声明 的 话 ， 可 
以 用 --encoding 代替 -E 选项 。 如 果 没 有 给 出 -E 或 者 --encoding HM, initdb 将 基于 指 
定 的 或 者 缺 省 的 区 域 试 图 判断 合适 的 编码 。 


你 可 以 在 数据 库 创 建 时 指定 非 缺 省 编码 ， 但 是 指定 的 编码 必须 与 所 选 的 区 域 相 兼容 : 


createdb -E EUC_KR -T templateO --1lc-collate=ko_KR.euckr --1lc-ctype=ko_KR.euckr korean 


将 创建 一 个 使 用 Euc_kR 字符 集 以 及 ko_kR 区 域 的 名 字 叫 korean 的 数据 库 。 另外 一 种 实现 方 
法 是 使 用 SQL 命令 : 


CREATE DATABASE korean WITH ENCODING 'EUC_KR' LC_COLLATE='ko_KR.euckr' LC_CTYPE='ko_KR.eu 


E = : 





注意 上 述 命令 声明 拷贝 templateo 数据 库 。 当 拷贝 任何 其 他 数据 库 时 ， 来 自 源 数据 库 的 编码 
和 区 域 设 置 不 能 被 改变 ， 因 为 可 能 导致 数据 损坏 。 参 阅 Section 21.3 获取 更 多 信息 。 


数据 库 的 编码 是 存储 在 pg_database 系统 表 中 的 。 你 可 以 用 psal 的 -1 选项 或 \1 命令 列 出 
这 些 编码 。 


$ <kbd class="literal">psql -1</kbd> 
List of databases 


Name | Owner | Encoding | Collation | Ctype | Access Privilege 
二 Re 
clocaledb | hlinnaka | SQL_ASCII | C | e | 
englishdb | hlinnaka | UTF8 | en_GB.UTF8 | en_GB.UTF8 | 
japanese | hlinnaka | UTF8 | ja_JP.UTF8 | ja_JP.UTF8 | 
korean | hlinnaka | EUC_KR | ko_KR.euckr | ko_KR.euckr | 
postgres | hlinnaka | UTF8 | fi_FI.UTF8 | fi_FI.UTF8 | 
templateO | hlinnaka | UTF8 | fi_FI.UTF8 | fi_FI.UTF8 | {=c/hlinnaka, hlinnaka=CTc 
template1 | hlinnaka | UTF8 | fi_FI.UTF8 | fi_FI.UTF8 | {=c/hlinnaka, hlinnaka=CTc 
(7 rows) 


a — —g 





Important: 在 大 多 数 现代 操作 系统 中 ，PostgreSQL 可 以 通过 Lc ctype 的 设置 决定 使 用 
哪 种 字符 集 ， 并 且 强 制 只 使 用 匹配 的 数据 库 编码 。 在 旧 的 操作 系统 上 你 有 责任 确保 使 用 
所 选区 域 所 期 望 的 编码 。 如 果 这 上 面 犯错 误 很 可 能 导致 与 区 域 相关 的 操作 表现 出 古怪 的 
行为 ， 上 比如 排序 。 

即使 当 Lc_ctype 不 是 c 或 者 posix 时 ， PostgreSQL 也 允许 超级 用 户 创建 使 

用 sQL_AscII 编码 的 数据 库 。 正 如 以 上 所 述 ， sQL_AsciI 不 强制 存储 在 数据 库 中 的 数据 
具有 任何 特定 的 编码 ， 所 以 这 个 选择 带 来 区 域 相关 的 不 当 行 为 的 风险 。 使 用 这 样 的 设置 
组 合 是 不 推荐 的 ， 也 许 有 一 天 会 被 完全 禁止 。 


22.3.3. 服务 器 和 客户 端 之 间 的 上 自动 字符 集 转 换 


PostgreSQL 支 持 在 服务 器 和 前 端 之 间 的 自动 编码 转换 。 转换 信息 在 系统 表 pg_conversion 中 
存储 。 PostgreSQL 带 着 一 些 预 定义 的 转换 。 它们 在 Table 22-2 中 列 出 。 你 可 以 使 用 SQL 命 
43 CREATE CONVERSION 创建 一 个 新 的 转换 。 


Table 22-2. 客户 /服务 器 字符 集 转 换 


服务 器 字符 集 可 用 客户 端 字符 集 

BIG5 不 支持 做 服务 器 端 编码 

EUC_CN EUC_CN, MULE_INTERNAL , UTF8 

EUC_JP EUC_JP, MULE_INTERNAL , SJIS , UTF8 

EUC_KR EUC_KR, MULE_INTERNAL , UTF8 

EUC_TW EUC_TW, BIG5 , MULE_INTERNAL , UTF8 

GB18030 不 支持 做 服务 器 端 编码 

GBK 不 支持 做 服务 器 端 编码 

IS0_8859_5 ISO_8859_5, KOI8R , MULE_INTERNAL , UTF8 , WIN866 ， WIN1251 
IS0_8859_6 ISO_8859_6, uTF8 

IS0_8859_7 ISO_8859_7, UTF8 

IS0_8859_8 ISO_8859_8, uTF8 

JOHAB JOHAB, uTF8 

KOI8R KOI8R, Iso 8859 5 , MULE_INTERNAL , UTF8 , WIN866 , WIN1251 
KOI8U KOI8U, uTF8 

LATINA LATIN1, MULE_INTERNAL , UTF8 

LATIN2 LATIN2, MULE_INTERNAL , UTF8 , WIN1250 

LATIN3 LATIN3, MULE_INTERNAL , UTF8 


LATIN4 


LATINS 


LATING 


LATIN? 


LATIN8 


LATIN9 


LATIN10 


MULE_INTERNAL 


SJIS 


SQL_ASCII 


UHC 


UTF8 


WIN866 


WIN874 


WIN1250 


WIN1251 


WIN1252 


WIN1253 


WIN1254 


WIN1255 


WIN1256 


WIN1257 


WIN1258 


LATIN4, MULE_INTERNAL , UTF8 

LATINS, urtF8 

LATING, uTE8 

LATIN7, utF8 

LATIN8, uTE8 

LATINY, uTE8 

LATIN10, utF8 

MULE_INTERNAL, BIG5 , EUC_CN , EUC_JP , EUC_KR , EUC_TW ， 
ISO_8859 5 , KOI8R , LATIN1 tO LATIN4 , SJIS , WIN866 , WIN1250 , 
WIN1251 

不 支持 做 服务 器 端 编码 

任意 (不 会 发 生 编码 转换 ) 

不 支持 做 服务 器 端 编码 

所 有 支持 的 编码 

WIN866, IS0_8859_5 ， KOI8R ，MULE_INTERNAL , UTF8 ， WIN1251 
WIN874, uTF8 

WIN1250, LATIN2 , MULE_INTERNAL , UTF8 

WIN1251, Iso 8859 5 , KOI8R , MULE_INTERNAL , UTF8 , WIN866 
WIN1252, UTF8 

WIN1253, UTF8 

WIN1254, UTF8 

WIN1255, UTF8 

WIN1256, UTF8 

WIN1257, UTF8 

WIN1258, UTF8 


要 想 打 开 自 动 字符 集 转 换 功 能 ， 你 必须 告诉 PostgreSQL 你 想 在 客户 端 使 用 的 字符 集 ( 编 码 )。 
你 可 以 用 好 几 种 方法 实现 这 个 目的 。 


e 用 psql 里 的 \encoding 命令 。 \encoding 允许 你 动态 修改 客户 端 编 码 。 比如 ， 把 编码 改 
RA sus, BA: 


\encoding SJIS 


e 使 用 libpq (Section 31.10) 函 数控 制 客户 端 编码 。 


e 使 用 SET client_encoding TO o 使 用 下 面 的 SQL 命令 设置 客户 端 编 码 : 


SET CLIENT_ENCODING TO '_value_'; 


你 也 可 以 使 用 标准 的 SQL 语法 set names 达到 这 个 目的 : 


SET NAMES '_value_'; 


查询 当前 客户 端 编码 : 


SHOW client_encoding; 


返回 缺 省 编码 : 


RESET client_encoding; 


e 使 用 PGCLIENTENCODING 。 如 果 在 客户 端的 环境 里 定义 了 PGCLIENTENCODING 环境 变量 ， 那 
么 在 与 服务 器 进行 连接 时 将 自动 选择 这 个 客户 端 编 码 。 这 个 编码 随后 可 以 用 上 面谈 到 的 
任何 其 它 方法 覆盖 。 


e 使 用 client encoding 配置 变量 。 如 果 在 client_encoding 里 设置 了 该 变量 ， 那么 在 与 服 
务 器 建立 了 连接 之 后 ， 将 自动 选 定 这 个 客户 端 编码 。 这 个 设置 随后 可 以 被 上 面 提 到 的 其 
它 方法 覆盖 。 


假如 无 法 进行 特定 的 字符 转换 一 比如 ， 你 选 的 服务 器 编码 是 Euc_JP 而 客户 端 是 LATING , 
那么 有 些 返 回 的 日 文字 符 不 能 转换 成 LATINA 一 这 时 将 报告 错误 。 


如 果 客 户 端 字符 集 定 义 成 了 sQL_AscIirz ， 那么 编码 转换 会 被 关闭 ， 不 管 服务 器 的 字符 集 是 什 
么 都 一 样 。 和 服务 器 一 样 ， 除 非 你 的 工作 环境 全 部 是 ASCII 数 据 ， 否 则 使 用 sQL_Ascii 是 不 明 


智 的 。 


22.3.4. 进一步 阅读 


下 面 是 学 习 各 种 类 型 的 编码 系统 的 好 地 方 。 

CJKV Information Processing: Chinese, Japanese, Korean & Vietnamese Computing 
包含 Euc_JP ，EUC_CN ，EUC_KR ，Euc_Tw 的 详细 说 明 。 

http://www.unicode.org/ 

Unicode 主 页 。 


RFC 3629 


UTF-8 (8-bit UCS/Unicode 转 换 格式 ) 的 定义 。 
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像 许 多 其 它 数据 库 一 样 ，PostgreSQL 也 需要 周期 性 的 运行 某 些 任务 以 实现 性 能 优化 。 这 里 讨 
论 的 任务 是 必须 经 常 重复 的 事情 ， 可 以 很 容易 的 使 用 标准 的 工具 (比如 cron 脚 本 ) 或 Windows 
的 任务 计划 来 完成 。 不 过 ， 设置 合适 的 脚本 以 及 检查 它们 是 否 成 功 执行 则 是 数据 库 管 理 员 的 
责任 。 


一 件 很 明显 的 维护 工作 就 是 经 常 性 地 创建 数据 的 各 份 拷贝 。 如 果 没 有 最 近 的 各 份 ， 那么 你 就 
没有 从 灾难 中 恢复 的 机 会 (磁盘 坏 、 失 火 、 误 删 表 )。 可 以 在 PostgreSQL 里 面 使 用 的 各 份 和 恢 
复 机 制 在 Chapter 24 里 面 有 比较 详细 的 讨论 。 


其 它 主 要 的 维护 工作 包括 周期 性 的 "vacuuming"( 清 理 ) 数 据 库 。 这 个 工作 我 们 在 Section 23.1 
里 讨论 。 与 此 紧密 相关 的 是 更 新 规划 器 使 用 的 统计 信息 ， 这 个 在 Section 23.1.3 里 讨论 。 


其 它 需 要 周期 性 注意 的 东西 是 日 志文 件 的 管理 。 我 们 在 Section 23.3 里 讨论 了 这 个 问题 。 


check_postgres 可 用 于 监测 数据 库 健 康 并 且 报 告 不 寻常 的 条 件 。check_postgres 结 合 Nagios 
和 MRTG， 但 也 可 以 独立 运行 。 


PostgreSQL 和 其 它 数据 库 产 品 比 较 起 来 是 低 维护 量 的 。 但 是 ， 适 当 在 这 些 任务 上 放 一 些 注 意 
将 更 加 能 够 确保 我 们 的 愉快 工作 和 获取 对 这 个 系统 富有 成 效 的 经 验 。 


23.1. Aimee 


PostgreSQL 数 据 库 需 要 定期 /维护 被 称 为 vacuurmming。 很 多 安装 足以 通过 autovacuum 守 扩 进 
程 执行 清理 ， 正 如 Section 23.1.6 所 描述 的 。 你 可 能 需要 调整 清理 参数 为 你 的 情况 得 到 最 好 的 
结果 。 一 些 数 据 库 管理 员 会 想 补充 或 取代 手动 管理 vAcuuM 命令 的 进程 活动 ， 这 通常 根据 
cron 或 者 任务 调度 程序 脚本 执行 的 。 设置 手动 管理 适当 清理 ， 理 解 下 面 几 个 子 部 分 讨论 的 问 
题 是 必要 的 。 依 赖 于 autovacuuming 的 管理 员 可 能 仍然 希望 浏览 此 材料 来 帮助 他 们 理解 和 调 
整 autovacuuming。 


23.1.1. 清理 基础 


PostgreSQL 的 VACUUM 命令 由 于 以 下 几 个 原因 ， 必 须 周 期 性 处 理 每 个 表 : 

1. 恢复 那些 由 已 更 新 或 已 删除 的 行 占据 的 磁 胡 空 间 

2， 更 新 PostgreSQL 查 询 规 划 器 使 用 的 数据 统计 信息 。 

3. 更 新 可 见 性 映射 ， 这 加 速 了 唯一 索引 扫描 

4, 避免 因 为 事务 /D 重 县 造成 的 老 数据 丢失 。 

对 上 面 每 个 原因 进行 vacuum 操作 的 频率 和 范围 不 同 。 正 如 下 面 每 个 部 分 所 述 。 


有 vacuum 的 两 个 变形 : 标准 vacuum 和 vacuum FULL o VACUUM FULL 可 以 回收 更 多 Ks E 
间 ， 但 运行 速度 要 慢 得 多 。 另 外 ， vacuum 的 标准 形式 可 以 与 生产 数据 库 操 作 并 行 运行 。 
(命令 SELECT , INSERT , UPDATE 和 DELETE 将 继续 正常 工作 ， 当 被 清理 的 时 候 ， 但 你 使 用 诸 
如 命令 ALTER TABLE 将 不 能 够 修改 表 的 定义 ) 。 vacuum FULL 需要 正 运 行 的 表 上 的 排他 锁 ， 
并 且 不 能 与 其 它 表 使 用 并 行 完成 。 一 般 地 ， 因 此 ， 管理 员 应 该 尽量 使 用 标准 的 vacuum jet 


免 VACUUM FULL o 


AMX, vacuum 需要 大 量 的 MO 操作 ， 可 能 导致 其 它 活动 中 的 会 话 性 能 严重 降低 。 调整 配置 参 
数 以 降低 后 端 清理 的 性 能 影响 一 参阅 Section 18.4.4 获取 更 多 信息 。 


23.1.2. VRE he & Z ja] 


在 正常 的 PostgreSQL 操 作 里 ， 对 一 行 的 uppATE 或 者 bpELETE 并 未 立即 删除 旧版 本 的 数据 
行 。 这 个 方法 对 于 获取 多 版 本 并 发 控制 的 好 处 是 必要 的 (MVCC Chapter 13): 如 果 一 个 
行 的 版 本 仍 有 可 能 被 其 它 事务 看 到 ， 那 么 你 就 不 能 删除 它 。 但 到 了 最 后 ， 不 会 有 任何 事务 对 
过 期 的 或 者 已 经 删除 的 行 感 兴趣 。 而 它 占据 的 空间 必须 为 那些 新 行 的 使 用 而 回收 ， 以 避免 对 
矿 盘 空间 需求 无 限 的 增长 。 这 件 事 是 通过 运行 vacuum 实现 的 。 


vacuum 的 标准 形式 删除 表 中 的 死 行 以 及 索引 ， 并 且 标 记 未 来 可 重新 使 用 的 可 用 空间 。 然而 ， 
它 不 会 返回 空间 到 操作 系统 ， 除了 在 特殊 情况 下 ， 其 中 表 结 尾 的 一 个 或 多 个 页 面 完全 自由 ， 

并 且 可 轻易 获得 排 它 表 锁 。 相 比 之 下 ， vacuum FULL 通过 写 入 没有 死 表 空间 的 表 文 件 完整 的 
新 版 本 来 压缩 表 ， 这 最 大 限度 地 减少 了 表 的 大 小 ， 但 也 需要 相当 长 的 时 间 。 这 还 需要 表 的 新 
副本 额外 的 磁盘 空间 ， 直 到 操作 完成 。 


定期 清理 通常 目标 是 执行 标准 vacuum 通常 足以 避免 需要 vacuum FULL 。 该 自动 清理 后 台 程 序 
试图 以 这 种 方式 工作 ， 而 事实 上 从 未 提出 vacuum FULL 。 在 这 种 方法 中 ， 想 法 是 不 能 保持 表 
的 最 小 尺寸 但 要 保持 磁盘 空间 用 法 稳定 状态 : 每 个 表 占 用 的 空间 相当 于 其 最 小 尺寸 加 上 清理 
期 间 被 用 完 的 许多 空间 。 虽然 vacuum FULL 可 用 于 收缩 表 到 其 最 小 尺寸 ， 并 返回 该 磁盘 空间 
给 操作 系统 ， 如 果 该 表 将 来 只 是 再 次 增长 ， 那 么 毫 无 意义 。 因此 ， 比 起 为 了 维护 更 新 频繁 的 
表 而 很 少 运行 vacuum FULL 来 说 ， 运行 适度 频繁 标准 vacuum 是 一 个 好 的 方法 。 


某 些 管理 员 倾 向 于 定期 清理 自己 ， 例 如 当 负 载 较 低 的 时 候 夜 间 做 所 有 的 工作 。 按照 固定 的 时 
间 执 行 清理 的 困难 是 ， 如 果 一 个 表 在 更 新 活动 中 有 意 想不到 的 秒杀 ， 它 可 能 膨胀 ， 所 

以 vacuum FuLL 的 确 有 必要 回收 空间 。 使 用 自动 清理 后 台 程 序 解决 了 这 个 问题 ， 因为 守 扩 进 
程 时 间 表 清理 动态 响应 更 新 活动 。 完全 禁用 守护 进程 是 不 明智 的 ， 除 非 你 有 一 个 可 预测 的 工 
作 量 。 一 个 可 能 的 妥协 是 设置 守护 进程 的 参数 ， 这 样 只 会 反应 异常 沉重 的 更 新 活动 ， 从 而 使 
事情 变 得 不 可 收拾 ， 当 负 载 是 典型 的 ， 而 预定 的 vAcuu 希望 做 更 多 的 工作 。 


对 于 那些 不 使 用 自动 清理 的 ， 典 型 的 做 法 是 一 旦 在 低 使 用 率 期 间 的 一 天 安排 数据 库 范 围 

BY vacuum, 通过 更 新 频繁 的 表 更 加 频繁 的 清理 作为 必要 补充 。 (有 些 具有 极 高 更 新 速率 的 
安装 每 隔 几 分 钟 清理 他 们 最 繁忙 的 表 ) 。 如 果 你 在 集群 中 有 多 个 数据 库 ， 则 不 要 忘 

了 vacuum ; 该 程序 vacuumdb 可 能 会 有 所 帮助 。 


Tip: 普通 vacuum 可 能 不 尽 如 人 意 ， 当 一 个 表 中 包含 大 量 的 死 行 版 本 作为 大 规模 更 新 或 
删除 活动 的 结果 。 如 果 你 有 这 样 一 个 表 ， 并 且 你 需要 回收 占用 的 多 余 磁 瘟 空 间 ， 则 需要 
使 用 vacuum FULL ， 或 者 CLUSTER 或 者 ALTER TABLE 的 表 重 写 变 形 之 一 。 REMTE 
写 表 的 全 新 副本 ， 并 建立 新 的 索引 。 所 有 这 些 选项 都 需要 排 它 锁 。 需 要 注意 的 是 他 们 也 
暂时 使 用 额外 的 磁盘 空间 大 致 等 于 表 的 大 小 ， 因为 表 的 旧 副 本 以 及 索引 不 能 释放 ， 直 到 
新 的 完成 。 





Tip: 如 果 你 有 一 个 表 ， 它 的 内 容 经 常 被 完全 删除 ， 那么 可 以 考虑 用 TRUNCATE 而 不 是 后 
面 跟着 vacuum ‘AY DELETE o TRUNCATE 立即 删除 整个 表 的 内 容 ， 而 不 要 求 随后 

BY vacuum RÆ vacuum FuLL 来 恢复 现在 未 使 用 的 磁 意 空间 。 缺点 是 违反 了 严格 的 
MVCC 语 义 。 


23.1.3. 更 新 规划 器 统计 


PostgreSQL 的 查询 规划 器 依赖 一 些 有 关 表 内 容 的 统计 信息 用 以 为 查询 生成 好 的 规划 。 这 些 统 
计 是 通过 ANALYZE 命 令 获 得 的 ， 你 可 以 直接 调用 这 条 命令 ， 也 可 以 把 它 当 做 vacuum 里 的 一 
个 可 选 步骤 来 调用 。 拥 有 合理 准确 的 统计 是 非常 重要 的 ， 否 则 ， 选择 了 恶劣 的 规划 很 可 能 降 


低 数据 库 的 性 能 。 


如 果 所 用 自动 清理 后 台 程 序 ， 将 自动 发 出 ANALYZE 命 伟 ， 当 表 的 内 容 已 经 充分 改变 。 AM, 
管理 员 可 能 更 愿意 依靠 手动 安排 的 ANALYzE 操作 ， 尤 其 是 如 果 它 是 已 知 的 表 上 的 更 新 活动 ， 

会 影响 " 感 兴趣 " 列 的 统计 。 守 护 进 程 时 间 表 ayze 严格 作为 插入 或 更 新 行 数 的 函数 ; 它 不 
知道 是 否 这 将 导致 有 意义 的 统计 变化 。 


和 为 了 回收 空间 做 清理 一 样 ， 经 常 更 新 统计 信息 也 是 对 更 新 频繁 的 表 更 有 用 。 不 过 ， 即 使 是 
更 新 非常 频繁 的 表 ， 如 果 它 的 数据 的 统计 分 布 并 不 经 常 改变 ， 那么 也 不 需要 更 新 统计 信息 。 
一 条 简单 的 拇指 定律 就 是 想 想 表 中 字段 的 最 大 跟 最 小 值 改 变 的 幅度 。 上 比如， 一 个 包含 行 更 新 
时 间 的 timestamp 字段 将 随 着 行 的 追加 和 更 新 稳定 增长 最 大 值 ; 这 样 的 字段 可 能 需要 比 那些 
包含 访问 网 站 的 URL 的 字段 更 频繁 一 些 更 新 统计 信息 。 那些 URL 字 段 可 能 改变 得 一 样 频繁 ， 
但 是 其 数值 的 统计 分 布 的 改变 相对 要 缓慢 得 多 。 


我 们 可 以 在 特定 的 表 ， 甚 至 是 表 中 特定 的 字段 上 运行 ANALYzE ， 所 以 如 果 你 的 应 用 有 需求 的 
话 ， 可 以 对 某 些 信息 更 新 得 比 其 它 信 息 更 频繁 。 不 过 ， 在 实际 中 ， 通 常 最 好 只 是 分 析 整 个 灶 
据 库 ， 因 为 它 是 一 个 快速 操作 。 ANALYzE 使 用 了 统计 学 上 的 随机 采样 的 方法 进行 行 采样 ， 而 
不 是 把 每 一 行 都 读 取 进来 。 





Tip: 尽管 用 ANALYzE 针对 每 个 字段 进行 挖掘 的 方式 可 能 不 是 很 实用 ， 但 你 可 能 还 是 会 发 
现 值得 针对 每 个 字段 对 ANALYZE 收集 的 统计 信息 的 详细 级 别 进行 调整 。 那些 经 常 

在 wer 子 句 里 使 用 的 字段 如 果 有 非常 不 规则 的 数据 分 布 ， 那么 就 可 能 需要 比 其 它 字段 
更 细致 的 数据 图 表 。 参阅 ALTER TABLE SET STATISTICS 。 或 者 使 

用 default_statistics_target 配置 参数 改变 缺 省 数据 库 。 


另外 ， 默 认 情 况 下 有 选择 性 函数 的 有 限 信息 可 用 。 但 是 ， 如 果 您 使 用 函数 调用 创建 一 个 
表达 式 索 引 ， 有 用 的 统计 数据 将 收集 有 关 郴 数 的 信息 ， 这 样 可 以 使 用 表达 式 索 引 大 大 提 
高 查询 规划 。 


Tip: 该 自动 清理 后 台 程 序 不 会 为 外 表 发 出 ANALYZE 命令 ， 因 为 它 没 有 办 法 决定 多 长 时 间 
可 能 是 有 用 的 。 如 果 您 的 查询 需要 外 表 的 统计 信息 进行 适当 的 规划 ， 在 表 上 合适 的 时 间 


运行 手动 管理 analyze 命令 是 一 个 好 主意 。 


23.1.4. 更 新 可 见 视图 


清理 保持 可 见 视图 为 了 每 个 表 跟 踪 只 包含 元 组 的 页 面 ， 对 所 有 活动 事务 可 见 (以 及 所 有 未 来 
的 事务 ， 直 至 页 面 再 次 修改 ) 。 这 有 两 个 目的 。 首 先 ， 在 下 次 运行 时 清理 本 身 可 以 跳 过 这 些 
页 面 ， 因 为 没有 什么 可 清理 的 。 


其 次 ， 它 允许 PostgreSQL 回 答 一 些 只 使 用 索引， 没有 参考 基础 表 的 查询 。 由 于 PostgreSQL 
索引 不 包含 能 见 度 信 息 元 组 ， 普 通 素 引 扫描 为 每 个 匹配 索引 项 抓 取 堆 元 组 ， 检查 它 是 否 由 当 
前 事务 可 见 。 另 外 一 方面 ， 索 引 扫描 首先 检查 能 见 度 视图 。 如 果 它 知道 ， 页 面 上 的 所 有 元 组 


是 可 见 的 ， 可 用 忽略 堆 抓 取 。 在 大 型 数据 集 上 这 是 最 显著 的 。 其 中 可 见 视图 可 以 防止 磁盘 访 
间 。 可 见 视图 远 远 比 堆 小 ， 所 以 即使 堆 非 常 大 ， 它 可 以 很 容易 地 缓存 。 


23.1.5. 避免 事务 ID 重 受 造 成 的 问题 


PostgreSQL 的 MVCC 事 务 语意 依赖 于 比较 事务 ID(XID) 的 数值 : 一 条 带 有 大 于 当前 事务 XID 

的 插入 XID 的 行 版 本 是 "属于 未 来 的 "， 并 且 不 应 为 当前 事务 可 见 。 但 是 因为 事务 ID 的 大 小 有 限 

(在 我 们 写 这 些 的 时 候 是 32 位 )， 如 果 集 群 一 次 运行 的 时 间 很 长 (大 于 40 亿 次 事务 )， 那 么 它 就 要 

受到 事务 /D 重 县 的 折磨 : XID 计 数 器 回 到 雾 位 ， 然 后 突然 间 所 有 以 前 的 事务 就 变 成 看 上 去 是 

在 将 来 的 一 这 意味 着 它们 的 输出 将 变 得 可 见 。 简 而 言 之 ， 可 怕 的 数据 丢失 。 实 际 上 数据 仍然 

在 那里 ， 但 是 如 果 你 无 法 获取 数据 ， 这 么 说 也 只 是 自我 安慰 曙 了 。 为 了 避免 这 种 情况 ， 有 必 
清理 至 少 每 二 十 亿 事 务 的 每 个 数据 库 中 的 每 个 表 。 


周期 性 的 运行 VACUUM 可 以 解决 这 个 问题 的 原因 在 于 PostgreSQL 可 以 储存 特殊 的 

XID( FrozenxID )。 这 个 XID 不 遵循 普通 XID 比 较 规则 ， 总 是 被 认为 比 任何 普通 的 XID 旧 。 普通 
的 XID 使 用 模 -2<sup class="calibre28">31</sup> 算 法 进行 比较 。 这 就 意味 着 对 于 每 个 普通 的 
XID, 总 是 有 二 十 亿 个 XID 是 "更 旧 " 以 及 二 十 亿 个 XID" 更 新 " ; 表达 这 个 意思 的 另外 一 个 方法 

是 普通 的 XID 空间 是 没有 终点 的 环 。 因 此 ， 一 且 某 行 带 着 特定 的 普通 XID 创 建 出 来 ， 那么 该 行 
将 在 以 后 的 二 十 亿 次 事务 中 表现 得 是 "在 过 去 "， 而 不 管 我 们 说 的 是 哪个 普通 XID。 如 果 该 行 在 
超过 二 十 亿 次 事务 之 后 仍然 存在 ， 那 么 它 就 会 突然 变 成 在 将 来 的 行 。 为 了 避免 数据 丢失 ， 老 
的 行 必须 在 到 达 二 十 亿 次 事务 的 年 龄 之 前 的 某 个 时 候 赋 予 FrozenxID o 一 旦 它 被 赋予 了 这 个 

特殊 的 XID ， 那 么 它们 在 所 有 普通 事务 面前 表现 为 "在 过 去 "， 而 不 管事 务 1D 是 否 重生 ， 因 此 这 
样 的 行 不 管 保存 多 长 时 间 ， 直 到 删除 之 前 都 会 完好 。 这 个 XID 的 重新 赋值 是 vacuum 控制 的 。 


vacuum. freeze_min_age 控制 着 在 它 之 前 更 旧 的 XID 将 被 替换 为 FrozenxIp o 较 大 的 设置 值 
防止 了 事务 信息 变 长 ， 较 小 的 值 增加 了 在 表 必 须 被 清理 之 前 可 以 清理 事务 的 数量 。 


VACUUM 通常 会 忽略 没有 任何 死 行 版 本 页 面 ， 但 这 些 页 面 可 能 仍然 有 | 上 昌 XID 值 的 行 版 本 。 为 了 
确保 所 有 旧 的 XID 已 被 FrozenxID i, 需要 全 表 扫 描 。vacuum_freeze _table_age 控 制 
VACUUM 的 执行 : AT vacuum_freeze_table_age 减 去 vacuum_freeze_min_age 事务 ， 如 果 没 有 
完全 扫描 整个 表 ， 则 将 其 设置 为 0， 强 制 vacum 总 是 扫描 所 有 页 面 ， 有 效 地 忽略 可 见 视图 。 








表 在 清理 之 前 允许 执行 的 最 大 事务 次 数 是 20 亿 事务 减 去 vAcuum 上 次 扫描 整个 表 时 

的 vacuum_freeze_min_age 值 。 如 果 超 过 这 个 限制 就 很 可 能 造成 数据 丢失 。 为 了 保证 数据 安 
全 ， 必须 在 任何 可 能 包含 旧 于 autovacuum freeze_max_age 指 定 的 XID 的 表 上 调用 
autovacuum。 甚 至 在 autovacuum 被 禁用 的 情况 下 也 可 以 调用 。 





这 就 意味 着 ， 一 个 未 被 清理 的 表 将 会 在 大 约 autovacuum_freeze_max_age 减 

去 vacuum_freeze_min_age 次 事务 后 被 自动 清理 。 对 于 那些 周期 性 清理 以 回收 空间 的 表 来 说 ， 
这 个 并 不 重要 。 对 于 静态 表 ( 包 括 只 插入 不 更 新 /删除 的 表 )， 因 为 不 需要 回收 空间 的 清理 ， 所 
以 可 以 尝试 最 大 化 强制 清理 的 时 间 间 隔 ， 也 就 是 增加 autovacuum_freeze_max_age 的 值 或 减 


少 vacuum_freeze_min_age 的 值 。 





vacuum_freeze_table_age 有 效 最 大 值 是 0.95* autovacuum_freeze_max_age ; 高 于 它 的 设置 将 履 
盖 最 大 值 。 高 于 autovacuum_freeze_max_age 的 值 是 没有 意义 的 ， 因为 自动 清理 将 在 这 一 点 被 
触发 ， 在 这 发 生 之 前 ，0.95 乘 数 留 下 一 些 空间 来 执行 手动 vacuum 。 作 为 一 个 经 验 法 

则 ， vacuum_freeze_table age 应 设置 为 稍微 低 于 autovacuum_freeze_max_age 的 一 个 值 。 留 
足够 的 空隙 ， 以 便 定 期 安排 vacuum 或 通过 运行 在 该 窗口 中 的 正常 删除 和 更 新 活动 触发 自动 清 
理 。 将 其 设置 得 接近 可 能 导致 抗 回 绕 自动 清理 ， 即使 表 最 近 被 清理 以 回收 空间 ， 而 较 低 的 值 
会 导致 更 多 频繁 的 全 表 扫 描 。 








增加 autovacuum_freeze_max_age 以 及 vacuum_freeze_table age 的 唯一 不 利之 处 在 于 数据 库 集 
群 的 pg clog 子 目录 将 会 占用 更 多 空间 ， 因为 它 必 须 为 所 有 autovacuum_freeze_max_age 之 后 
的 事务 存储 提交 状态 。 每 个 事务 提交 状态 使 用 2 字 节 ， 因 此 如 果 autovacuum_freeze_max_age 
设置 为 最 大 人 允许 值 为 20 亿 ， pg_clog 将 会 增加 到 大 约 500M。 如 果 这 个 尺寸 比 起 你 的 数据 库 来 
只 是 小 菜 一 碟 ， 我 们 推荐 你 将 ”autovacuum_freeze_max_age 设 为 允许 的 最 大 值 。 否 则 ， 如 何 设 
置 将 取决 于 你 愿意 给 pg_clog 多 大 的 空间 。 默 认 值 是 2 亿 ， 大 约 需 要 50MB 的 pg_clog 存储 空 
间 。 


减 小 vacuum_freeze_min_age 的 不 利之 处 是 可 能 导致 VACUUM 做 无 用 功 : 如 果 行 在 不 久之 后 就 
被 修改 ， 那 么 将 XID 修 改 为 FrozenxIp 就 是 在 浪费 时 间 ， 因为 它 很 快 就 将 获得 一 个 新 的 XID。 
因此 这 个 设置 应 当 足 够 大 以 使 得 行 不 被 过 早 的 冻结 。 减 小 vacuum_freeze_min_age 的 另 一 个 不 
利之 处 是 事务 插入 或 修改 行 的 准确 细节 将 会 很 快 丢失 。 这 个 信息 有 时 迟早 会 派 上 用 场 ， 特别 
是 数据 库 失 败 之 后 分 析 究 竟 发 生 了 什么 错误 的 时 候 。 因为 这 两 个 原因 ， 在 完全 静态 的 表 上 减 
小 这 个 值 是 不 明智 的 。 


为 了 跟踪 数据 库 中 最 老 的 XID 寿 命 ， vAcuuM 在 系统 表 pg_class 和 pg_database 里 存储 了 XID 
统计 。 尤其 是 一 个 数据 库 的 pg_class 行 中 的 relfrozenxid 字段 包含 了 最 后 一 个 整 

Ze vacuum 命令 使 用 的 冻结 终止 XID。 系统 保证 在 该 表 中 所 有 比 这 个 终止 XID 老 的 普通 XID 都 
被 Frozenxip RÆ. 同样 ， 一 个 数据 库 的 pg_database 行 中 的 datfrozenxid 字段 是 普通 XID 
的 下 界 一 它 只 是 数据 库 中 每 个 表 relfrozenxid 的 最 小 值 。 检查 这 个 信息 的 一 个 便利 方法 是 执 
行 下 面 的 查询 : 


SELECT c.oid::regclass as table_name, 
greatest (age(c.relfrozenxid),age(t.relfrozenxid)) as age 
FROM pg_class c 
LEFT JOIN pg_class t ON c.reltoastrelid = t.oid 
WHERE c.relkind IN ('r', 'm'); 


SELECT datname, age(datfrozenxid) FROM pg_database; 


age 字段 用 于 测量 从 中 止 XID 到 当前 事务 XID 的 数目 。 


VACUUM 常常 只 扫描 自 上 次 清理 已 被 修改 的 页 ， 但 relfrozenxid 仅仅 提前 扫描 整个 表 。 
当 relfrozenxid 大 于 vacuum_ freeze table age 事务 时 ， 当 使 用 VACUUM 的 FREEZE 选项 时 ， 


或 者 当 所 有 页 需要 清理 删除 死 行 版 本 ， 进 行 全 表 扫 描 。 当 vacuum 扫描 全 表 时 ， 





age(relfrozenxid) 应 当 立 即使 用 稍微 大 于 vacuum_freeze_min_age 的 值 ( 比 VACUUM 启动 之 后 
开始 的 事务 数目 稍 大 )。 如 果 在 表 上 提出 非 全 表 扫 描 vacuum 直到 超 
过 autovacuum_freeze_max_age ， 则 将 会 很 快 在 表 上 强制 进行 自动 清理 。 


如 果 从 表 中 清理 旧 XID 失 败 ， 那 么 当 数据 库 的 旧 XID 到 达 1000 万 以 后 ， 系统 将 发 出 类 似 下 面 这 
样 的 警告 信息 : 


WARNING: database "mydb" must be vacuumed within 177009986 transactions 
HINT: To avoid a database shutdown, execute a database-wide VACUUM in "mydb". 


手动 vacuum 应 该 修复 这 个 问题 ， 正 如 提示 建议 ; 但 是 注意 vacuum 必须 通过 超级 用 户 执行 ， 
否则 无 法 处 理 系 统 目 录 ， 并 且 不 能 是 高 数据 库 的 datfrozenxid o 如 果 和 忽略 了 上 面 的 警告 信 
息 ， 那 么 系统 将 在 距离 重合 小 于 100 万 次 的 时 候 关 闭 ， 并 且 拒绝 开始 任何 新 的 事务 : 


ERROR: database is not accepting commands to avoid wraparound data loss in database "myd 
HINT: Stop the postmaster and use a standalone backend to VACUUM in "mydb". 


aaa 


这 个 100 万 的 事务 安全 边界 留 下 来 用 于 让 管理 员 在 不 丢失 数据 的 情况 下 进行 恢复 ， 方 法 是 手 
工 执行 所 需要 的 vacuum 命令 。 不 过 ， 因 为 一 旦 进入 了 安全 关闭 模式 ， 系统 就 不 能 再 执行 命 
邻 ， 做 这 件 事 情 的 唯一 的 方法 是 停止 主 服 务 器 ， 使 用 一 个 单独 运行 的 后 端 来 执行 vAcuum o X 
闭 模式 不 会 强制 于 独立 运行 的 后 端 。 参阅 postgres 手 册 获 取 有 关 使 用 独立 运行 后 端的 细节 。 





23.1.6. Autovacuum 守 护 进程 


PostgreSQL 带 有 一 个 可 选 高 度 推 荐 的 特性 叫做 autovacuum 守 护 进程 ， 它 的 目的 是 自动 执 
{T vacuum 和 ANALYZE 命令 。 在 打开 这 个 选项 之 后 ，autovacuum 守 护 进 程 特 检查 那些 有 大 量 
插入 、 更 新 、 删 除 行 操 作 的 表 。 这 些 检查 使 用 行 级 别 的 统计 收集 设施 ; 因此 ， 除 非 把 
track_counts 设 置 为 true ， 否则 无 法 使 用 autovacuum 守 护 进程 。 在 缺 省 配置 下 ， 4A 
autovacuum 守 折 进 程 并 且 合 理 设置 相关 配置 参数 。 


该 "自动 清理 后 台 程序 "实际 上 是 由 多 个 进程 组 成 的 。 有 一 个 持久 守 扩 进程 ， 称 为 autovacuum 
launcher 它 是 负责 为 所 有 数据 库 启 动 autovacuum worker 进 行 。 该 发 射 器 将 分 发 工作 跨越 时 
H, 每 个 数据 库 内 每 autovacuum_naptime 秒 内 党 试 启动 1 个 工作 。 (Alt, MRR 

有 _N_ 个 数据 库 ， 每 autovacuum naptime /_N_ 秒 将 开始 一 个 新 的 。) 最 

多 autovacuum_max_workers 工 作 进 程 在 同一 时 间 人 允许 运行 。 如 果 正 在 处 理 多 

于 autovacuum max_workers 的 数据 库 ， 一 且 第 一 个 义理 完成 将 义理 p= 个 数据 库 。 每 个 工作 
进程 将 检查 它 的 数据 库 中 的 每 个 表 ， 并 且 执行 vacuum 和 /或 者 按 需 要 执行 ANALYZE 。 使 

用 log_autovacuum_min_duration 可 以 监控 自动 清理 活动 。 


如 果 在 很 短 的 时 间 中 需要 清理 若干 个 大 表 ， 则 所 有 自动 清理 的 工人 可 能 需要 很 长 一 段 时 间 清 
a 这 将 导致 其 它 表 和 数据 库 不 能 被 清理 ， 直 到 工人 可 用 。 在 单一 的 数据 库 中 有 多 少 
可 能 没有 限制 ， 但 尽量 避免 已 经 被 其 他 人 完成 的 重复 工作 。 需 要 注意 的 是 运行 数 Fit 


入 max_connections 或 者 superuser_reserved_connectionsBR ill, 


那些 relfrozenxid 大 于 autovacuum W max_age 的 表 将 总 是 被 清理 (这 也 适用 于 通过 
存储 参数 修改 的 冻结 最 大 时 间 的 那些 表 ; 参见 下 文 ) 。 否则 ， 如 果 上 次 vacuum 之 后 的 过 期 行 
的 数量 超过 了 "清理 冰 值 "， ae. ase BATE LH: 





vacuum threshold = vacuum base threshold + vacuum scale factor * number of tuples 


这 里 的 清理 基本 阔 值 是 autovacuum vacuum threshold, 清理 缩放 系数 
是 autovacuum _ vacuum _scale factor, 行 数 是 pg_class . reltuples ， 过 期 行 的 数量 是 从 统 
计 收 集 器 里 面 获 取 的 ， 这 是 一 个 半 精 确 的 计数 ， 由 每 次 uppATE 和 DELETE 操作 更 新 。 半 精 确 
的 原因 是 在 重负 载 时 有 些 信息 可 能 会 去 失 。 如 果 表 的 relfrozenxid 值 大 
于 vacuum_freeze_table age , 打 描 整个 表 Ae 吉 旧 元 组 ， 并 且 提 升 relfrozenxid , 人 否则 仅仅 打 


描 上 次 清理 后 修改 的 页 。 





为 了 分 析 ， 使 用 了 一 个 类 似 的 条 件 : DAMA, ELA: 


analyze threshold = analyze base threshold + analyze scale factor * number of tuples 


TAMER ANALYzE 插入 、 更 新 、 删 除 的 总 行 数 进行 比较 。 
临时 表 不 能 被 自动 清理 进行 访问 。 因 此 ， 适 当 的 清理 和 分 析 操 作 应 通过 会 话 SQL 命 令 执 行 。 


缺 省 的 阅 值 和 伸缩 系数 是 从 postgresql.conf 里 面 取得 的 ， 不 过 ， 它 可 能 基于 表 而 履 盖 。 参 阅 
存储 参数 获取 更 多 细节 。 如 果 通 过 存储 参数 已 经 改变 设置 ， 那 么 则 使 用 该 值 ; 否则 使 用 全 局 
设置 。 参阅 Section 18.10 获 取 有 关 全 局 设置 的 更 多 细节 。 


除了 基本 阐 值 和 缩放 系数 之 外 ， 还 有 6 个 autovacuum 参数 可 以 通过 存储 参数 为 每 个 表 进行 设 
Bo 第 一 个 参数 ， autovacuum_enabled 可 以 设置 为 false 让 autovacuum 守护 进程 完全 忽略 
某 个 表 。 这 种 情况 下 ，autovacuum 只 有 在 为 了 避免 事务 ID 重 一 必须 清理 整个 数据 库 的 时 候 才 
会 动 那个 表 。 接 下 来 两 个 参数 ， 

autovacuum_vacuum_cost_delay 和 autovacuum_vacuum_cost_limit 用 于 针对 特定 的 表 为 基于 开 
销 的 清理 延迟 特性 设置 数值 。 参 阅 Section 18.4.4。 autovacuum_freeze_min_age , 
autovacuum_freeze_max_age 和 autovacuum_freeze_table_age 分 别 为 Vacuum _freeze_min_age， 





autovacuum_freeze_max_age 和 vacuum freeze table_ age 设置 数值 。 








当 多 个 工作 者 正在 运行 ， 成 本 限制 在 所 有 正在 运行 的 人 中 是 "balanced"， 从 而 使 系统 上 的 总 
影响 是 相同 的 ， 而 不 管 实际 运行 人 数 。 


23.2. 2 E ERDI 


有 时 候 我 们 值得 用 REINDEX 命 邻 周 期 性 重建 索引 。 


已 经 完全 空 的 B 树 索引 页 会 回收 重新 使 用 。 然 而 ， 这 可 能 是 空间 使 用 低 效 : 如 果 所 有 ， 但 页 
面 上 的 几 个 索引 键 已 经 被 删除 而 页 面 仍 分 配 。 因 此 ， 使 用 模式 其 中 大 多 数 ， 但 不 是 全 部 ， 最 
终 被 删除 的 每 个 范围 内 的 键 将 看 到 空间 低 效 使 用 。 对 于 这 样 的 使 用 模式 ， 推 荐 周期 性 重建 索 
Bl. 


对 于 非 B-tree 索 引 的 膨胀 潜能 可 能 还 没有 很 好 地 分 析 。 在 使 用 非 B-tree 索 引 的 时 候 保持 对 索引 
的 物理 尺寸 的 周期 性 监控 是 个 很 好 的 主意 。 


还 有 ， 对 于 B-tree 素 引 ， 一 个 新 建立 的 索引 从 某 种 意义 上 比 更 新 了 多 次 的 访问 起 来 稍微 要 快 ， 
因为 在 新 建立 的 索引 上 ， 逮 辑 上 连接 的 页 面 通常 物理 上 也 连接 在 一 起 (这 样 的 考虑 目前 并 不 适 
用 于 非 B-tree 索 引 )。 仅 仅 从 提高 访问 速度 角度 出 发 ， 可 能 我 们 也 值得 周期 性 的 重建 索引 。 


23.3. 日 志文 件 维 扩 


把 数据 库 服务 器 的 日 志 输 出 保存 在 一 个 地 方 而 不 是 仅仅 把 它们 放 到 /dev/null 里 是 个 好 主 

意 。 在 碰 到 危险 的 时 候 ， 日 志 输 出 是 非常 宝贵 的 。 不 过 ， 日 志 输 出 可 和 有 EGBA (rea 是 在 比较 
高 的 调试 级 别 上 )， 而 且 你 不 会 无 休止 地 保存 它们 。 你 需要 滚动 日 志文 件 ， 这 样 生成 新 的 日 志 
文件 并 且 经 常 抛弃 老 的 。 


如 果 你 简单 地 把 postgres 的 stderr 重 定向 到 一 个 文件 中 ， 你 会 有 日 志 输 出 ， 但 是 截断 日 志 
件 的 唯一 的 方法 是 停止 并 重启 主 服务 器 。 这 样 做 对 于 PostgreSQL 开 发 环境 中 是 可 以 的 ， 但 
是 你 肯定 不 想 在 生产 环境 中 也 这 么 干 。 


一 个 更 好 的 办 法 是 把 主 服务 器 的 stderr 输 出 发 送 到 某 种 日 志 滚 动 程序 里 。 我 们 有 一 个 内 置 的 日 
志 滚 动 程序 ， peels postgresql.conf 里 设 及 置 配置 参数 logging_collector 为 true 的 
办 法 打开 它 。 这 个 程序 的 控制 参数 在 Section 18.8.1 里 描述 。 你 也 可 以 使 用 这 个 方法 捕获 机 
A a 日 志 数 据 。 


另外 ， 如 果 你 准 各 使 用 其 他 服务 器 软件 ， 你 可 能 更 喜欢 使 用 一 个 外 部 日 志 滚动 程序 (比如 
PostgreSQL 中 Apache 附 带 的 rotatelogs 工 具 )， 为 了 做 到 这 一 点 ， 你 可 以 将 stderr 的 输出 重 定 
向 到 所 需 程序 。 如 果 你 用 pocti 启动 服务 器 ， 那么 stderr 已 经 重 定向 到 stdout， 因 此 你 只 需 
要 一 个 管道 命令 ， 比 如 : 


pg_ctl start | rotatelogs /var/log/pgsql_log 86400 


另外 一 种 生产 级 的 管理 日 志 输 出 的 方法 就 是 把 它们 发 送 给 syslog 并 且 让 syslog 义理 滚动 。 要 
利用 这 个 工具 ， 我 们 需要 设置 postgresql.conf 里 的 log destination 为 syslog (记录 syslog 
日 志 )。 然后 在 你 想 强迫 syslog 守 扩 进 程 开始 写 入 一 个 新 日 志文 件 的 时 候 ， 就 可 以 发 送 一 
个 srecu 信号 给 它 。 如 果 你 想 自动 滚动 日 志文 件 ， 那 么 我 们 可 以 配置 logrotate 程 序 处 理 
syslog 的 日 志文 件 。 


不 过 ， 在 很 多 系统 上 ，syslog 不 是 非常 可 靠 ， 特 别 是 在 大 型 日 志 信息 的 情况 下 ; 它 可 能 在 你 
最 需要 那些 信息 的 时 候 截 断 或 者 丢弃 它们 。 还 有 ， 在 Linux 上 ， syslog 会 把 每 个 se 
盘 上 ， 导 致 很 低下 的 性 能 。 你 可 以 在 syslog 配 置 文件 里 面 的 文件 名 开头 使 用 " - "来 关闭 这 
行为 。 

请 注意 上 面 描述 的 所 有 人 解决 方案 关注 的 是 在 可 配置 的 间隔 上 开始 一 个 新 的 日 志文 件 ， 它们 并 
pane ai 你 可 能 还 需要 设置 一 个 批 处 理 ， 周期 地 删除 旧 日 志文 件 。 
另外 一 个 可 能 的 解法 是 配置 日 志 滚 动 程序 ， 让 它 周 期 地 覆盖 旧 的 日 志文 件 。 


pgBadger 是 一 个 外 部 项 目 ， 做 复杂 的 日 志文 件 分析 。 当 重 要 信息 出 现在 日 志文 件 中 
时 ，check_postgres 提供 了 Nagios 和 警告 ， 以 及 许多 其 他 特殊 条 件 的 检测 。 


Chapter 24. 备份 与 恢复 
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和 任何 包含 珍贵 数据 的 东西 一 样 ，PostgreSQL 数 据 库 也 应 该 经 常备 份 。 尽管 这 个 过 程 相 当 简 
单 ， 但 是 我 们 还 是 应 该 理解 做 这 件 事 所 用 的 一 些 技巧 和 假设 。 


。 SQL 转 储 
。 文件 系统 级 别 备份 
© 在 线 备份 
每 种 备份 都 有 自己 的 优点 和 缺点 。 在 下 面 的 章节 中 依次 进行 讨论 。 


24.1. SQL 转 储 


SQL 转 储 的 方法 是 创建 一 个 文本 文件 ， 里 面 都 是 SQL 命令 ， 当 把 这 个 文件 回馈 给 服务 器 时 ， 
将 重建 与 转 储 时 状态 一 样 的 数据 库 。 PostgreSQL 为 这 个 用 途 提 供 了 pg_dump 工 具 。 这 条 命 
兮 的 基本 用 法 是 : 


pg_dump _dbname_ > _outfile_ 





正如 你 所 见 ，pg_dump 把 结果 输出 到 标准 输出 。 我 们 下 面 就 可 以 看 到 这 样 做 有 什么 好 处 。 


pg_dump 是 一 个 普通 的 PostgreSQL 客户 端 应 用 (尽管 是 个 相当 聪明 的 东西 )。 这 就 意味 着 你 可 
以 从 任何 可 以 访问 该 数据 库 的 远 端 主机 上 面 进行 各 份 工作 。 但 是 请 记 住 pg_dump 不 会 以 任何 
特殊 权限 运行 。 具 体 说 来 ， 就 是 它 必须 要 有 你 想 备 份 的 表 的 读 权 限 ， 因 此 ， 实际 上 你 几乎 总 
是 要 成 为 数据 库 超级 用 户 。 


要 声明 pgdump 应 该 以 哪个 用 户 身份 进行 连接 ， 使 用 命 合 行 选项 -hhost 和 -p `_port_。 
缺 省 主机 是 本 地 主机 或 环境 变量 PGPoRT 声明 的 值 。 类 似 的 ， 缺 省 端口 是 环境 变量 PGPoRT 或 
(如 果 它 不 存在 的 话 ) 编 译 好 了 的 缺 省 值 。 服 务 器 通常 都 有 相同 的 缺 省 ， 所 以 还 算 方 便 。 


IEH E PostgreSQL Pihu FA— i, pg dumpt A 与 当前 操作 系统 用 户 名 同名 的 数 
据 库 用 户 名 进行 连接 。 要 覆盖 这 个 名 字 ， 要 么 声明 -u 选项 ， 要 么 设置 环境 变量 PGUSER o 
请 注意 pg_dump 的 连接 也 和 普通 客户 应 用 一 样 要 通过 客户 认证 机 制 (在 Chapter 19 里 描述 )。 


pg_dump 超 过 后 边 描 述 的 其 它 备 份 方 法 的 一 个 重要 优点 是 pg_dump 的 输出 通常 可 以 SARA 
PostgreSQL 新 版 本 ， 然而 文件 级 别 各 份 和 连续 归档 都 因 服务 器 版 本 而 异 。pg_dump 是 Hts 
输 数 据 库 到 另 一 台 机 器 体系 结构 工作 时 唯一 的 方法 ， 如 从 32 位 变 到 64 位 服务 器 。 


由 pg_dump 创 建 的 各 份 在 内 部 是 一 致 的 ， 也 就 是 说 ， 在 pg_dump 运 行 的 时 候 转 储 的 是 数据 库 
的 快照 。 pg_dump 工 作 的 时 候 并 不 阻塞 其 它 的 对 数据 库 的 操作 (但 是 会 阻塞 那些 需要 排 它 锁 
的 操作 ， 比 如 ALTER TABLE )。 





Important: 如 果 你 的 数据 库 结构 依赖 于 OID( 比 如 说 用 做 外 键 )， 那么 你 必须 告诉 
pg_dump 把 OID 也 导出 来 。 要 导出 OID， 可 以 使 用 -o 命令 行 选项 。 





24.1.1. 从 转 储 中 恢复 


psql _dbname_ < _infile 





这 里 的 _infile ”就 是 通过 pgaqurmp 命 令 的 文件 输出 。 这 条 命令 不 会 创建 
` dbname 数据 库 ， 你 必须 在 执行 psql 前 自己 从 template0 创建 (也 就 是 用 createdb -T 
templateO `_dbname_ 命令)。 psql 支 持 类 似 pg_dump 的 选项 用 以 控制 数据 库 服务 器 位 置 和 用 


户 名 。 参阅 psql 的 手册 获取 更 多 信息 。 


在 开始 运行 恢复 之 前 ， 目 标 库 和 所 有 在 转 储 出 来 的 库 中 拥有 对 象 的 用 户 ， 以 及 鲁 经 在 某 些 对 
象 上 被 赋予 权限 的 用 户 都 必须 已 经 存在 。 如 果 这 些 不 存在 ， 那么 恢复 将 失败 ， 因 为 恢复 过 程 
无 法 把 这 些 对 象 恢复 成 原 有 的 所 有 权 和 /或 权限 。 有 时 候 你 希望 恢复 权限 ， 不 过 通常 你 不 需要 
这 么 做 。 


缺 省 时 ，psql 脚 本 将 在 遇 到 错误 的 时 候 仍然 继续 执行 。 你 可 能 希望 运行 带 有 oN_ERROR_STOP X 
量 设置 的 psql 以 改变 操作 ， 并 且 如 果 发 生 SQL 错 误 则 带 有 退出 状态 码 3 的 psql 退 出 。 


psql --set ON_ERROR_STOP=on dbname < infile 


不 管 上 述 哪 种 方法 都 只 能 得 到 部 分 恢复 了 的 数据 库 。 另 外 ， 你 可 以 将 整个 恢复 过 程 当成 一 个 

单独 的 事务 ， 这 样 就 能 够 保证 要 么 全 部 恢复 成 功 ， 要 么 全 部 回 滚 。 可 以 通过 向 psql 传 递 -1 或 
者 --single-transaction 命令 行 参数 达到 此 目的 。 使 用 这 个 模式 的 时 候 即 使 一 个 很 微小 的 错 

误 也 将 导致 已 经 运行 了 好 几 个 小 时 的 恢复 过 程 回 滚 。 尽 管 如 此 ， 这 种 模式 也 比 手 动 清除 哪些 

不 完整 的 恢复 数据 强 。 


pg_dump 和 psql 可 以 通过 管道 读 写 ， 这 样 我 们 就 可 能 从 一 台 主 机 上 将 数据 库 目录 转 储 到 另 一 
台 主 机 上 ， 比 如 : 


pg_dump -h _host1 dbname_ | psql -h _host2 dbname 








Important: pg_dump 生 成 的 转 储 输出 是 相对 于 templateo 的 。 这 就 意味 着 任何 加 入 
到 templates 的 语言 、 过 程 等 都 会 经 由 pg_dump 转 储 。 这 样 在 恢复 的 时 候 ， 如 果 你 使 用 
的 是 自 定义 的 template1 ， 那么 你 必须 从 templateo 中 创建 空 的 数据 库 ， 就 像 我 们 上 面 


的 例子 那样 。 





一 旦 完成 恢复 ， 在 每 个 数据 库 上 运行 ANALYZE 是 明智 的 举动 ， 这 样 优化 器 就 有 可 用 的 统计 数 
据 了 。 Section 23.1.3 和 Section 23.1.6 获 取 更 多 信息 。 关于 如 何 有 效 加 载 海量 数据 到 
PostgreSQL 的 更 多 信息 ， 参考 Section 14.4。 


24.1.2. 使 用 pg_dumpall 


pg_dump 在 一 个 时 间 只 转 储 一 个 单独 的 数据 库 ， 它 不 转 储 有 关 和 角色 或 表 空间 信息 (因为 这 些 
是 集群 范围 ， 而 不 是 每 个 数据 库 ) 。 为 了 支持 方便 转 储 整个 数据 库 集群 的 全 部 内 容 。 因此 我 
们 提供 了 pg_dumpall 程 序 。 pg_dumpall 各 份 一 个 给 出 的 集群 中 的 每 个 数据 库 ， 同 时 还 确保 保 
留 像 角色 和 表 空 间 这 样 的 全 局 数据 状态 。 这 个 命令 的 基本 用 法 是 : 


pg_dumpall > _outfile_ 


生成 的 转 储 可 以 用 psql 恢 复 : 


psql -f _infile_ postgres 


实际 上 ， 你 可 以 声明 任意 现 有 的 数据 库 进 行 连接 ， 但 是 如 果 你 是 向 一 个 空 的 数据 库 集群 装 
载 ， 那么 postgres 应 该 是 比较 好 的 选择 。 恢复 pg_dumpall 的 转 储 的 时 候 通 常 需要 数据 库 超 
级 用 户 权 限 ， 因为 我 们 需要 它 来 恢复 角色 和 表 空 间 信息 。 如 果 使 用 了 表 空 间 ， 需要 注意 转 储 
中 的 表 空 间 路 径 必 须 适 合 新 的 安装 。 


pg_dumpall 的 工作 原理 是 发 射 命令 来 重新 创建 角色 ， 表 空间 和 空 数据 库 ， 然 后 为 每 个 数据 库 
调用 pg_dump。 这 意味 着 ， 虽 然 每 个 数据 库 内 部 一 致 ， 但 不 同 的 数据 库 快 照 可 能 不 是 恰好 同 
步 。 


24.1.3. 处 理 大 数据 库 


当 创建 大 的 pg_dump 输 出 文件 时 ， 限制 产生 问题 的 一 些 操作 系统 允许 最 大 文件 大 小 。 因为 
pg_dump 输 出 到 标准 输出 ， 你 可 以 用 标准 的 Unix 工 具 绕 开 这 个 问题 : 有 一 些 可 能 的 方法 : 


使 用 压缩 转 储 . 使 用 你 熟悉 的 三 缩 程序 (比如 gzip) : 





pg_dump _dbname_ | gzip > _filename_.gz 


使 用 下 面 命令 恢复 : 
gunzip -c _filename_.gz | psql _dbname_ 


或 者 : 


cat _filename_.gz | gunzip | psql _dbname_ 


使 用 split . split 人 允许 用 下 面 的 方法 把 输出 分 解 成 操作 系统 可 以 接受 的 大 小 。 比如 ， 让 每 
个 块 大 小 为 1MB : 


pg_dump _dbname_ | split -b 1m - _filename_ 





用 下 面 命令 恢复 : 


cat _filename_* | psql _dbname_ 


使 用 pg_dump 自 定义 转 储 格式 . 如 果 PostgreSQL 是 在 一 个 安装 了 zlib 压缩 库 的 系统 上 制作 
的 ， 那么 自 定义 转 储 格式 将 在 写 和 输出 文件 的 时 候 压 缩 数 据 。 它 会 生成 和 使 用 gzip 类 似 大 
小 的 转 储 文件 ， 但 是 还 附加 了 一 个 优点 : 你 可 以 有 选择 地 恢复 库 中 的 表 。 下 面 的 命令 用 自 定 
义 转 储 格式 转 储 一 个 数据 库 : 


pg_dump -Fc _dbname_ > _filename_ 


自 定义 格式 的 转 储 不 是 脚本 ， 不 能 用 于 psql， 而 是 需要 使 用 pg_restore 转 储 。 比如 : 


pg_restore -d _dbname_ _filename_ 


请 参阅 pg _dump 和 pg _restore 手 册 获 取 细 节 。 
对 于 非常 大 的 数据 库 ， 你 可 能 需要 结合 split 以 及 其 他 两 种 方法 之 一 。 


使 用 pg_dump 的 并 行 转 储 功能 . 为 了 加 快 大 数据 库 的 转 储 ， 你 可 以 使 用 pg_dump 并 行 模 式 。 
这 将 同时 转 储 多 个 表 。 你 可 以 使 用 -j 参数 控制 并 行 性 程度 。 并 行 转 储 只 支持 "目录 "为 档 模 
式 。 


pg_dump -j _num_ -F d -f _out.dir_ _dbname_ 


你 可 以 使 用 pg_restore -j 并 行 恢复 转 储 。 这 将 为 任何 " 自 定义 "或 者 "目录 "为 档 模 式 工作 ， 是 
否 它 已 经 使 用 pg_dump -j 创建 。 


24.2. 文件 系统 级 别 各 份 


另 一 个 各 份 的 策略 是 直接 拷贝 PostgreSQL 用 于 存放 数据 库 数 据 的 文件 。 我 们 在 Section 17.2 
里 解释 了 这 些 文件 的 位 置 ， 你 可 以 用 自己 喜欢 的 任何 常用 文件 系统 备份 的 方法 ， 例如 : 


tar -cf backup.tar /usr/local/pgsql/data 


不 过 ， 你 要 受到 两 个 限制 ， 倒 这 个 方法 不 那么 实用 ， 或 者 至 少 比 pg_dump 的 方法 进 色 一 些 : 


1 为 了 进行 有 效 的 备份 ， 数 据 库 服务 器 必须 被 关闭 。 像 拒 绝 所 有 连接 这 样 的 折衷 的 方法 是 
MIN, (部 分 因为 tar 和 类 似 的 工具 在 做 各 份 的 时 候 并 不 对 文件 系统 的 状态 做 原子 快 
照 。 但 也 因为 服务 器 内 部 缓冲 数据 ) 。 有 关 关 闭 服务 器 的 信息 可 以 在 Section 17.5 里 面 
找到 。 不 用 说 ， 你 在 恢复 数据 之 前 ， 同样 必须 关闭 服务 器 。 


2. 如果 你 鲁 经 深入 了 解 了 数据 库 在 文件 系统 布局 的 细节 ， 你 可 能 试图 从 对 应 的 文件 或 目录 
里 各 份 几 个 表 或 者 数据 库 。 这 样 做 是 没 用 的 ， 因 为 包含 在 这 些 文件 里 的 信息 只 是 部 分 信 
息 。 还 有 一 半 信 息 在 提交 日 志文 件 pg_clog/* 里 面 ， 它 包含 所 有 事务 的 提交 状态 。 只 有 
拥有 这 些 信息 ， 表 文件 的 信息 才 是 可 用 的 。 当 然 ， 试 图 只 恢复 表 和 相关 的 pg_clog 数据 
也 是 徒劳 的 ， 因为 这 样 会 把 数据 库 集 群 里 的 所 有 其 它 没有 用 的 表 的 信息 都 拿 出 来 。 所 以 
文件 系统 的 各 份 只 适用 于 一 个 数据 库 集群 的 完整 恢复 。 


另外 一 个 文件 系统 备份 的 方法 是 给 数据 目录 做 一 个 "一 致 的 快照 "， 条 件 是 文件 系统 支持 这 个 
功能 (并 且 你 愿意 相信 它 是 实现 正确 的 )。 典型 的 过 程 是 制作 一 个 包含 数据 库 的 肉 的 "冻结 快 
照 "， 然后 把 整个 数据 库 目 录 ( 不 仅仅 是 部 分 ， 见 上 文 ) 从 快照 拷贝 到 备份 设备 ， 然后 释放 冻结 
快照 。 这 样 甚至 在 数据 库 服 务 器 在 运行 的 时 候 都 可 以 运转 。 不 过 ， 这 样 创建 的 各 份 会 把 数据 
库 文 件 保存 在 一 个 没有 恰当 关闭 数据 库 服 务 器 的 状态 下 ; 因此 ， 如 果 你 在 这 个 备份 目录 下 启 
动 数 据 库 服务 器 ， 它 就 会 认为 数据 库 服务 器 经 历 过 崩溃 并 且 重 放 WAL 日 志 。 这 不 是 个 问题 ， 
只 要 意识 到 它 即 可 (并 且 确 信 在 自己 的 备份 中 包含 WAL 文 件 )。 在 采用 快照 减少 恢复 时 间 之 
前 ， 你 可 以 执行 CHECKPOINT 。 


如 果 你 的 数据 库 分 布 在 多 个 文件 系统 上 ， 那么 可 能 就 没有 任何 方法 获取 所 有 卷 上 准确 的 同步 
冻结 快照 。 比 如 ， 你 的 数据 文件 和 WAL 日 志 在 不 同 的 磁盘 上 ， 或 者 表 空 间 在 不 同 的 文件 系统 
+, 这 种 情况 下 就 不 可 能 使 用 快照 ， 因 为 快照 必须 是 同时 的 。 在 你 信任 这 样 的 情况 下 的 一 致 
性 快照 的 技术 之 前 ， 仔 细 阅 读 你 的 文件 系统 文档 。 


如 果 同 步 快 照 是 不 可 能 的 ， 该 选项 关闭 数据 库 服务 器 足够 长 的 时 间 来 建立 所 有 冰冻 的 快照 。 
另 一 种 选择 是 执行 一 个 连续 为 档 基础 备份 (Section 24.3.2) 因为 这 样 的 备份 在 备份 过 程 中 免 于 
文件 系统 变化 。 这 需要 在 各 份 过 程 中 启动 连续 愉 档 。 恢复 是 通过 使 用 连续 存档 恢复 (Section 
24.3.4) 完 成 的 。 


另外 一 个 选择 是 使 用 rsync 执 行 一 次 文件 系统 备份 。 这 是 通过 在 数据 库 服务 器 正在 运行 的 时 候 
运行 第 一 次 rsync， 然后 关闭 数据 库 服 务 器 一 段 足够 的 时 间 长 度 ， 用 于 运行 第 二 次 rsync。 第 


二 次 rsync 会 比 第 一 次 快 很 多 ， 因 为 它 要 传输 的 数据 相对 较 少 ， 并 且 最 后 的 结果 是 
因为 服务 器 已 经 停止 运行 了 。 这 个 方法 允许 用 很 少 的 时 间 执 行 一 次 文件 系统 备份 。 


需要 注意 的 是 文件 系统 备份 往往 比 SQL 转 储 大 。 比如 pg_dump 不 用 导出 索引 ， 只 
的 命令 。 然而， 文件 系统 各 份 可 能 会 更 快 。 


一 致 的 ， 


是 创建 它们 


24.3. 在 线 各 份 以 及 即时 恢复 (PITR) 


在 任何 时 候 ，PostgreSQL 都 在 集群 的 数据 目录 的 pg_xlog/ 子 目录 里 维护 着 一 套 预 写 日 志 
(WAL) 这 些 日 志 记录 着 每 一 次 对 数据 库 的 修改 细节 。 这 些 日 志 存 在 是 为 了 防止 崩溃 : 如 果 
系统 骨 溃 ， 数 据 库 可 以 通过 " 重 放 "上 次 检查 点 以 来 的 日 志 记 录 以 恢复 数据 库 的 完整 性 。 但 
是 ， 日 志 的 存在 让 它 还 可 以 用 于 第 三 种 备份 数据 库 的 策略 : 我 们 可 以 组 合 文件 系统 备份 与 
WAL 文 件 的 备份 。 如 果 需 要 恢复 ， 我 们 就 恢复 各 份 ， 然后 重 放 各 份 了 的 WAL 文 件 ， 把 各 份 恢 
复 到 当前 的 时 间 。 这 个 方法 对 管理 员 来 说 ， 明显 比 以 前 的 方法 更 复杂 ， 但 是 有 非常 明显 的 优 


qh: 


。 在 开始 的 时 候 我 们 不 需要 一 个 非常 完美 的 一 致 的 各 份 。 任何 备份 内 部 的 不 一 致 都 会 被 日 
志 重 放 动 作 修改 正确 (这 个 和 崩溃 恢复 时 发 生 的 事情 没什么 区 别 )。 因 此 我 们 不 需要 文件 
系统 快照 的 功能 ， 只 需要 tar 或 者 类 似 的 为 档 工 具 。 


。 因为 我 们 可 以 把 无 限 长 的 WAL 文 件 序 列 连接 起 来 ， 所 以 连续 的 备份 简化 为 连续 地 对 WAL 
文件 轨 档 来 实现 。 这 个 功能 对 大 数据 库 特别 有 用 ， 因 为 大 数据 库 的 全 各 份 可 能 并 不 方 
便 。 

我 们 可 没 说 重 放 WAL 记 录 的 时 候 我 们 必须 重 放 到 结尾 。 我 们 可 以 在 任意 点 停止 重 放 ， 这 
样 就 有 一 个 在 任意 时 间 的 数据 库 一 致 的 快照 。 因此 ， 这 个 技术 支持 即时 恢复 : 我 们 可 以 
把 数据 库 恢 复 到 你 开始 各 份 以 来 的 任意 时 刻 的 状态 。 


如 果 我 们 持续 把 WAL 文 件 序列 填充 给 其 它 装载 了 同样 的 基础 备份 文件 的 机 器 ， 我 们 就 有 
了 一 套 热 备份 系统 : 在 任何 点 我 们 都 可 以 启动 第 二 台 机 器 ， 而 它 拥 有 近乎 当前 的 数据 库 
No 


Note: pgdump 和 pg_dumpal/ 没 有 产生 文件 系统 级 别 各 份 ， 并 且 不 能 作为 连续 为 档 解决 
方案 的 一 部 分 。 上 比如 各 份 是 符合 逻辑 的 _ 并 且 不 包含 WAL 重 放 使 用 的 足够 信息 。 
和 简单 的 文件 系统 备份 技术 一 样 ， 这 个 方法 只 能 支持 整个 数据 库 集 群 的 恢复 ， 而 不 是 一 个 子 
集 。 同 样 ， 它 还 要 求 大 量 的 为 档 存 储 : 基础 各 份量 可 能 很 大 ， 而 且 忙 确 的 系统 将 生成 许多 兆 
需要 各 份 的 的 WAL 流 量 。 但 是 ， 它 仍然 时 在 需要 高 可 靠 性 的 场合 下 的 最 好 的 备份 技术 。 








要 想 从 连续 归档 中 成 功 恢复 (也 被 许多 数据 库 供 应 商 称 为 "在 线 各 份 ") ， 你 需要 一 套 连 续 的 
WAL BMH, 它们 最 远 回 翔 到 你 开始 备份 的 时 刻 。 因 此 ， 要 想 开始 备份 ， 你 应 该 在 开始 第 
一 次 基础 各 份 之 前 根据 我 们 讨论 过 的 轨 档 WAL 文 件 机 制 设置 并 测试 你 的 步骤 。 


24.3.1. EIB WAL at 


抽象 来 看 ， 一 个 运行 着 的 PostgreSQL 系 统 生成 一 个 无 限 长 的 WAL 日 志 序列 。 系统 物理 上 把 这 
个 序列 分 隔 成 WAL 段 文件 ， 通 常 每 段 16M( 在 编译 PostgreSQL 的 时 候 可 以 改变 其 大 小 )。 这 些 
段 文 件 的 名 字 是 数值 命名 的 ， 这 些 数值 反映 他 们 在 抽取 出 来 的 WAL 序列 中 的 位 置 。 在 不 适用 
WAL 当 档 的 时 候 ， 系 统 通常 只 是 创建 几 个 段 文件 然 后 "循环 "使 用 它们 ， 方 法 是 把 不 再 使 用 的 
段 文 件 的 名 字 重 命名 为 更 高 的 段 编号 。 系统 假设 那些 内 容 比 前 一 次 检查 点 更 老 的 段 文 件 已 经 
没 用 了 ， 然 后 就 可 以 循环 利用 。 


在 归档 WAL 数 据 的 时 候 ， 我 们 希望 在 每 个 段 文件 填充 满 之 后 捕获 之 ， 并 且 把 这 些 数据 在 段 文 
件 被 循环 利用 之 前 保存 在 某 处 。 根据 应 用 以 及 可 用 的 硬件 的 不 同 ， 我 们 可 以 有 许多 不 同 的 方 
法 "把 数据 保存 在 某 处 " : 我 们 可 以 把 段 文件 拷贝 到 一 个 NFS 挂 载 的 目录 ， 把 它们 放 到 另外 一 
台 机 器 上 ， 或 者 把 它们 写 入 磁带 机 里 (需要 保证 你 有 办 法 把 文件 恢复 为 原名 )， 或 者 把 它们 打 
成 包 ， 烧 录 到 CD 里 ， 或 者 是 其 它 的 什么 方法 。 为 了 给 数据 库 管 理 员 提供 最 大 可 能 性 的 灵活 
性 ， PostgreSQL 试 图 不 对 如 何 轨 档 做 任何 假设 。 取 而 代 之 的 是 ， PostgreSQL 让 管理 员 声 明 
一 个 shell 命 令 执 行 来 拷贝 一 个 完整 的 段 文件 到 它 需 要 去 的 地 方 。 该 命令 可 以 简单 得 就 是 一 
个 cp ， 或 者 它 可 以 调用 一 个 复杂 的 shell 脚 本 一 这 些 都 由 管理 员 决 定 。 


为 了 启动 WAL 为 档 ， 设 置 wal_leve| 配置 参数 到 archive (或 者 hot_standby ), archive_mode 
为 on ， 并 且 所 使 用 的 shell 命 令 由 配置 参数 archive_ command 声 明 ， 它 实际 上 总 是 放 

在 postgresql.conf 文件 里 的 。 在 archive_command 中 ， 任何 %p 都 被 要 为 档 文 件 的 绝对 路 径 
RS, ME %f 只 是 被 文件 名 代替 。 如 果 你 需要 在 命令 里 嵌入 一 个 真正 的 % 字符 ， 那 么 必 
须 双 写 ( %% )。 最 简单 的 有 用 命令 类 似 下 面 这 样 : 


"test ! -f /mnt/server/archivedir/%f && cp %p /mnt/server/archivedir/%F 
‘copy "%p" "C:\\server\\archivedir\\%f"' # Windows 


archive_command 
archive_command 


4 ee 


它 将 把 WAL 段 拷贝 到 /mnt/server/archivedir 目录 。 这 个 只 是 一 个 例子 ， 并 非 我 们 建议 的 方 
法 ， wp 和 xr 参数 被 取代 之 后 ， 实 际 执行 的 命令 看 起 来 这 样 : 





test ! -f /mnt/server/archivedir/00000001000000A900000065 && cp pg_xlog/00000001000000A90 
ME 
为 每 一 个 为 档 的 新 文件 产生 类 似 的 命 命 。 





为 档 命 合 将 在 运行 PostgreSQL 服 务 器 的 同一 个 用 户 的 权限 下 执行 。 因此 被 为 档 的 WAL 文 件 实 
际 上 包含 你 的 数据 库 里 的 所 有 东西 ， 所 以 你 应 该 确保 自己 的 为 档 数 据 不 会 被 别人 窥探 ; 比 
如 ， 为 档 到 一 个 没有 组 或 者 全 局 读 权 限 的 目录 里 。 


有 一 点 很 重要 : 当 且 仅 当 为 档 命 合成 功 时 ， 它 才 返 回 需 。 在 得 到 一 个 需 值 结果 之 后 ， 
PostgreSQL 将 假设 该 WAL 段 文件 已 经 成 功 轨 档 ， 因此 它 稍 后 将 被 删除 或 者 被 新 的 数据 履 盖 。 
但 是 ， 一 个 非 需 值 告诉 PostgreSQL 该 文件 没有 被 为 档 ; 因此 它 会 周期 性 的 重 试 直 到 成 功 。 


为 档 命 合 通 常 应 该 设计 成 拒绝 覆盖 已 经 存在 的 为 档 文件 。 这 是 一 个 非常 重要 的 安全 特性 ， 可 
以 在 管理 员 操作 失误 (比如 把 两 个 不 同 的 服务 器 的 输出 发 送 到 同一 个 轨 档 目录 ) 的 时 候 保 持 你 
的 为 档 的 完整 性 


我 们 建议 你 首先 要 测试 你 准备 使 用 的 注 档 命令 ， 以 保证 它 实际 上 不 会 覆盖 现 有 的 文件 ， 并 且 
在 这 种 情况 下 它 返 回 非 需 状 态 。 上 边 Unix 例 子 中 的 命令 包含 单独 的 测试 步骤 。 在 一 些 Unix 平 
台 上 ， cp 有 可 以 使 用 的 开关 比如 -i 可 以 做 同样 的 简单 的 事情 。 但 是 你 不 应 该 依靠 这 些 而 
不 验证 返回 的 正确 退出 状态 。 (尤其 是 ， 当 使 用 -i 并 且 已 经 存在 目标 文件 时 ，GNU cp 将 
返回 状态 需 ， 这 不 是 期 望 的 操作 。 ) 


在 设计 你 的 归档 环境 的 时 人 息 ， 请 考虑 一 下 如 果 为 档 命 合 不 停 失 败 会 发 生 什么 情况 ， 因为 有 些 
方面 要 求 操 作者 的 干涉 ， 或 者 是 六 档 空间 不 够 了 。 上 比如 ， 如 果 你 往 磁带 机 上 写 ， 但 是 没有 自 
动 换 带 机 ， 那 么 就 有 可 能 发 生 这 种 情况 ; 如 果 磁 带 满 了 ， 那 就 除非 换 磁带 ， 否 则 哈 事 也 做 不 
To 你 应 该 确保 任何 错误 条 件 或 者 要 求 操作 员 干 涉 的 错误 都 会 正确 报告 ， 这 样 才 能 迅速 解决 
这 些 问 题 。 否 则 pg_xlog/ 目录 会 不 停 地 填充 WAL 段 文件 ， 直到 问题 解决 。 〈 如 果 文 件 系统 
由 pg_xlog/ 填充 ，PostgreSQL 将 执行 PANIC 关 机 。 没 有 提交 的 事务 将 丢失 ， 但 是 数据 库 将 
保持 未 连接 直到 你 释放 一 些 空间 ) 。 


当 档 命令 的 速度 并 不 要 紧 ， 只 要 它 能 跟 上 你 的 服务 器 生成 WAL 数 据 的 平均 速度 即 可 。 即使 为 
档 进程 落 在 了 后 面 一 点 ， 正 常 的 操作 也 会 继续 进行 。 如 果 为 档 进 程 慢 很 多 ， 就 会 增加 灾难 发 
生 时 的 数据 丢失 量 。 同 时 也 意味 着 pg_xlog/ 目录 包含 大 量 示 为 档 的 日 志 段 文件 ， 并 且 可 能 最 
后 超出 了 磁 冀 空间 。 我 们 建议 你 监控 为 档 进程 ， 确 保 它 是 按照 你 的 意识 运转 的 。 


在 写 自 己 的 兴 档 命令 的 时 候 ， 你 应 该 假设 被 太 档 的 文件 最 多 64 个 字符 关 并 且 可 以 包含 ASCII 
字母 、 数 字 、 点 的 任意 组 合 。 我 们 不 必要 记 住 原始 的 全 路 径 ( wp )， 但 是 有 必要 记 住 文件 名 


( %f o 


请 注意 尽管 WAL 愉 档 允 许 你 恢复 任何 对 PostgreSQL 数 据 库 的 修改 ， 在 最 初 的 基础 备份 之 后 ， 
它 还 是 不 会 恢复 对 配置 文件 的 修改 ( postgresql.conf ，pg_hba.conf 和 pg_ident.conf ), 

为 这 些 文件 都 是 手工 编辑 的 ， 而 不 是 通过 SQL 操作 来 编辑 的 。 所 以 你 可 能 会 需要 把 你 的 配置 

文件 放 在 一 个 日 常 文件 系统 备份 过 程 即 可 处 理 到 的 地 方 。 参阅 Section 18.2 获 取 如 何 重 定位 配 
置 文件 的 知识 。 


因为 为 档 命 合 仅 在 已 经 完成 的 WAL 段 上 调用 ， 因 此 ， 如 果 你 的 服务 器 只 产生 很 小 的 WAL 流 量 
或 段 之 间 的 间隔 很 状 ， 那么 在 事务 完成 之 后 与 其 被 安全 汶 档 之 间 就 会 存在 很 长 的 延 时 。 为 了 
限制 未 愉 档 数据 的 最 长 期 限 ， 可 以 设置 archive timeout 强 制服 务 器 在 切换 WAL 段 之 间 的 时 间 
间 隅 。 需 要 注意 的 是 ， 由 于 强制 切换 而 提早 结束 的 已 为 档 文 件 的 大 小 与 完整 的 归档 文件 相 
fal, 因此 将 archive_timeout 设 为 一 个 很 小 的 值 是 不 明智 的 一 它 将 很 快 耗 尽 为 档 空 间 。 

将 archive_timeout 设置 为 60 秒 左右 通常 是 比较 合理 的 。 


同样 ， 如 果 你 想 确 保 刚 刚 完成 的 事务 被 立即 为 档 ， 那么 也 可 以 通过 pg_switch_xlog 手动 强制 
切换 段 文 件 。 其 它 与 WAL 管 理 相 关 的 工具 函数 在 Table 9-60 中 列 出 。 


当 wal_level 是 minimal 的 时 候 ， 一 些 SQL 命 令 进 行 优化 以 避免 WAL 日 志 ， 正如 Section 
14.4.7 所 描述 的 。 如 果 在 这 些 语句 之 一 执行 过 程 中 打开 为 档 或 者 流 复制 ，WAL 不 包含 为 档 恢 
复 的 足够 信息 。 (BARETZEA), 出 于 这 些 原因 ， 在 服务 器 开始 改变 wal_level o 然 
而 ， 重 新 加 载 配置 文件 时 改变 archive_command o 如 果 你 希望 暂时 停止 归档 ， 这 样 做 的 一 个 方 
法 是 设置 archive_command 为 空 字符 串 ( '…' )。 这 将 导致 WAL 文 件 在 pg_xlog/ PERE 

到 archive_command 重新 建立 。 


24.3.2. 进行 一 次 基础 各 份 


执行 基础 备份 最 简单 方式 是 使 用 pg_basebackup 工 具 ， 它 使 用 普通 文件 或 者 tar 兴 档 创 建 基础 
各 份 。 如 果 比 pg_basebackup 提 供 更 多 的 有 灵活 性 ， 你 也 可 以 使 用 低 水 平 API (参阅 Section 
24.3.3) 创建 基础 各 份 。 


不 必 担 心 基础 备份 需要 大 量 时 间 。 然而 ， 如 果 你 正常 运行 禁用 了 full_page_writes 的 服务 
as, 当 运 行 备份 时 ， 你 可 能 注意 到 性 能 方面 ， 因为 full_page_writes 有 效 强加 在 备份 方 式 
中 。 


要 使 用 这 个 各 份 ， 你 需要 保存 所 有 各 份 开 始 以 及 之 后 的 WAL 段 文件 。 为 了 帮助 你 实现 这 个 任 
务 ， 基 础 各 份 过 程 创建 一 个 各 份 历史 文件 ， 它 马 上 存储 到 WAL 为 档 区 域 。 这 个 文件 的 名 字 是 
以 你 在 使 用 文件 系统 备份 的 时 候 需 要 的 第 一 个 WAL 段 文件 的 名 字 命 名 的 。 比 如 ， 如 果 开 始 
WAL 文件 是 0000000100001234000055cD ， 那么 各 份 历 camp 类 

似 0000000100001234000055CD .007C9330.backup 这 样 的 东西 。 个 文件 名 的 第 二 部 分 表示 在 该 
WAL 文 件 里 面 的 准确 位 置 ， 通 常 可 以 被 忽略 。 =- BTH, 那么 
你 就 可 以 删除 所 有 那些 数值 名 字 在 这 个 文件 前 面 的 当 档 的 WAL 段 。 文件 系统 各 份 不 再 需要 它 
们 了 。 当 然 ， 你 应 当 保留 几 套 各 份 以 绝对 确保 可 以 恢复 先前 的 数据 。 


备份 历史 文件 只 是 一 个 小 的 文本 文件 。 它 包含 你 给 予 pg_basebackup 的 标签 字符 串 ， 以 及 备 
份 的 起 始 时 间 和 终止 时 间 。 如 果 你 使 用 这 个 标签 来 表示 转 储 文件 放 在 哪里 ， 则 在 需要 的 时 
候 ， 为 档 的 历史 文件 就 足够 告诉 你 转 储 文件 存放 在 哪里 了 。 


因为 你 必须 保留 直到 最 后 一 次 基础 备份 的 所 有 为 档 的 WAL 文 件 ， 那么 两 次 基础 备份 之 间 的 间 

蚁 通常 是 根据 你 想 在 为 档 WAL 文件 上 花 多 少 存储 空间 来 定 的 。 你 还 应 该 考虑 你 准备 在 恢复 上 
多 少时 间 。 如 果 需 要 恢复 的 话 一 系统 将 需要 重 放 所 有 那些 段 ， 而 如 果 最 后 一 次 基础 备份 以 
时 间 已 经 很 长 了 ， 那么 那些 动作 可 能 会 花 掉 好 些 时 间 。 
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24.3.3. 使 用 低级 别 API 进 行 基 础 备份 


使 用 包含 多 个 步骤 的 低 水 平 API 而 不 是 pg_basebackup 方 法 ， 但 是 相对 简单 。 在 序列 中 执行 
这 些 步骤 非常 重要 ， 并 且 在 进行 下 一 步 之 前 需要 验证 当前 步 成 功 。 


1. 确保 WAL 为 档 打 开 并 且 可 以 运转 。 


2. LAGE EA P See SIS, RAPT: 


SELECT pg_start_backup('label'); 


这 里 的 label 是 任意 你 想 使 用 的 这 次 备份 操作 的 唯一 标识 (一 个 好 习惯 是 使 用 备份 转 储 文 
件 的 放置 地 全 路 径 )。 pg_start_backup 用 备份 言 息 在 集群 目 录 里 创 建 一 个 备份 标签 文 
件 backup_label 。 包含 起 始 时 间 和 标签 字符 串 。 该 文件 对 于 备份 完整 性 是 非常 重要 的 ， 
你 需要 从 中 恢复 。 


至 于 你 连接 到 集群 中 的 那个 数据 库 没 什么 关系 。 你 可 以 忽略 函数 返回 的 结果 ; 但 是 如 果 
它 报 告 错 误 ， 那么 在 继续 之 前 先 义理 它 。 


默认 情况 下 ， pg_start_backup 可 能 需要 很 长 的 时 间 才 能 完成 。 这 是 因为 它 会 执行 一 个 检 


查 点 ， 并 且 I/O 所 需 的 检查 点 会 被 分 散在 一 个 显著 的 时 间 段 ， 默 认 情 况 下 ， 使 用 一 半 你 的 
相互 检查 点 间隔 (参见 配置 参数 checkpoint completion target) o 这 是 你 想 要 的 ， 因 为 


它 最 大 限度 地 减少 对 查询 处 理 的 影响 。 如 果 你 想 尽 快 开 始 备份 ， 使 用 : 


SELECT pg_start_backup('label', true); 


这 强制 检查 点 尽快 完成 。 


3. 执行 备份， 使 用 任何 方便 的 文件 系统 工具 ， 比 如 tar 或 者 cpio (而 不 是 pg_dump 或 者 
pg_dumpall) 。 这 些 操作 过 程 中 既 不 需要 关闭 数据 库 ， 也 不 需要 关闭 数据 库 的 操作 。 


4， 再 次 以 数据 库 超级 用 户 身份 连接 数据 库 ， 然 后 发 出 命令 : 


SELECT pg_stop_backup(); 


这 将 中 止 各 份 模式 并 自动 切换 到 下 一 个 WAL 段 。 自动 切换 是 为 了 在 备份 间隔 中 写 和 的 最 
后 一 个 WAL 段 文件 可 以 立即 为 下 次 各 份 作 好 准 各 。 


5. 只 要 在 各 份 过 程 中 使 用 的 WAL 段 文件 各 份 完 毕 ， 你 的 各 份 工 作 就 完成 了 。 通 
过 pg_stop_backup 的 结果 标识 的 文件 是 需要 形成 一 套 完整 各 份 文件 的 最 后 一 段 。 如 
果 archive_mode 已 启用 ， pg_stop_backup PRE, BER mR. 这 些 文件 的 为 
档 是 自动 发 生 的 ， 因 为 已 配置 archive_command 。 在 大 多 数 情 况 下 ， 这 将 迅速 发 生 ， 但 建 
议 您 监控 您 的 存档 系统 以 确保 没有 延迟 。 如 果 六 档 进 程 已 经 落后 ， 因 为 存档 命令 失败 ， 
它 会 继续 重 试 直到 存档 成 功 ， 各 份 完 成 。 如 果 您 希望 在 执行 pg_stop_backup 时 有 时 间 限 


制 ， 则 设 定 适 当 的 statement_timeout 值 。 


一 些 文件 系统 备份 工具 发 出 警告 或 错误 ， 如 果 这 些 文件 他 们 正 试图 复制 副本 处 理 的 变化 。 当 
执行 活动 数据 库 的 基础 备份 ， 这 种 情况 是 正常 的 并 且 不 发 生 错误 。 但 是 ， 你 需要 确保 你 能 辨 
别 这 种 从 实际 错误 中 的 投诉 。 例 如 ，rsync 某 些 版 本 返回 一 个 "消失 源 文件 "单独 的 退出 代码 ， 
你 可 以 写 一 个 驱动 程序 脚本 接受 这 个 退出 代码 作为 一 个 非 错 误 情况 。 此 外 ， 当 tar 复 制 它 ， 如 


果 一 个 文件 被 截断 时 ， GNU tar 某 些 版 本 返回 一 个 错误 代码 区 分 致命 的 错误 ， 幸运 的 是 ， 如 
果 文 件 在 备份 过 程 中 改变 ，GNU tar 版 本 1.16 和 后 期 版 本 退出 1， 其 他 错误 则 返回 2。 对 于 
GNU tar 版 本 1.23 版 和 后 期 版 本 ， 您 可 以 使 用 警告 选项 


的 --warning=no-file-changed --warning=no-file-removed 隐藏 相关 的 警告 信息 。 


要 保证 你 的 备份 转 储 包括 所 有 数据 库 集 群 目 录 里 的 文件 (比如 /usr/local/pgsql/data )。 如 果 
你 在 使 用 并 未 放置 在 这 个 目录 里 的 表 空 间 ， 也 要 小 心地 包含 它们 ， 并 且 要 确保 你 的 备份 转 储 
归档 符号 连接 是 符号 连接 ， 否则 ， 恢 复 会 把 你 的 表 空 间 搞 乱 。 


不 过 ， 你 可 以 在 备份 转 储 文件 里 省 略 集群 目录 下 的 pg_xlog/ FAR. 这 个 略微 复杂 些 的 动作 
是 值得 的 ， 因 为 它 减 少 了 恢复 时 候 的 错误 。 MR pg_xlog/ 是 一 个 指向 集群 目录 之 外 的 符号 连 
接 ， 那么 这 件 事情 很 容易 处 理 ， 出 于 性 能 考虑 的 时 候 经 常 这 人 么 做 。 你 可 能 还 想 排 

KR postmaster.pid 和 postmaster.opts, 记录 有 关 运 行 postmaster 的 信息 ， 而 不 谈 
postmaster, 它 最 终 将 使 用 这 个 各 份 。 (这 些 文件 可 以 混淆 pg_ctl) 。 


还 有 一 件 事 值得 一 提 ， 那 就 是 pg_start_backup 豆 数 在 数据 库 集群 目录 里 创建 了 一 个 

叫 backup_label 的 文件 ， 它 被 pg_stop_backup 删除 。 这 个 文件 当然 也 会 作为 各 份 转 储 文件 的 
一 部 分 为 档 。 这 个 备份 标签 文件 包含 你 给 予 pg_start_backup 的 标签 字符 串 ， 以 

及 pg_start_backup 运行 的 时 刻 ， 以 及 起 始 WAL 文 件 的 名 字 。 如 果 有 混淆 ， 那 么 我 们 可 以 看 
看 各 份 转 储 文件 里 面 然后 判断 转 储 文件 来 自 那 个 各 份 会 话 。 然而 ， 这 些 文件 不 仅仅 是 你 的 信 
息 ， 它 的 存在 和 内 容 对 系统 的 恢复 过 程 的 正确 操作 是 关键 的 。 


我 们 还 可 以 在 服务 器 停止 的 时 候 制 作 一 个 各 份 转 储 。 在 这 种 条 件 下 ， 很 明显 你 不 能 使 
用 pg_start_backup 或 者 pg_stop_backup ， 并 且 因 此 你 必须 靠 自己 的 手段 来 跟踪 各 份 转 储 文 
件 都 是 那些 ， 以 及 相关 的 WAL 文 件 最 远 走 到 哪里 。 通常 使 用 上 面 的 在 线 备 份 步 又 更 好 些 。 


24.3.4. 从 在 线 各 份 中 恢复 


好 ， 最 糟糕 的 事情 发 生 了 ， 现 在 你 需要 从 备份 中 恢复 。 下 面 是 步骤 : 
1. 停止 服务 器 ， 如 果 它 还 在 运行 的 话 。 


2， 如 果 你 还 有 足够 的 空间 ， 把 整个 集群 数据 目录 和 所 有 表 空 间 拷 贝 到 一 个 临时 位 置 ， 以 防 
万 一 你 之 后 还 需要 它们 。 请 注意 这 个 预防 措施 要 求 你 在 系统 里 有 足够 的 剩余 空间 来 现 有 
库 的 保持 两 份 拷贝 。 如 果 你 没有 足够 的 空间 ， 那么 你 至 少 需 要 把 集群 数据 目录 
的 pg_xlog 子 目录 的 内 容 拷贝 到 安全 的 地 方 ， 因为 它们 可 能 包含 系统 宕 掉 的 时 候 还 没有 
月 档 的 日 志 。 

3. 然后 清理 掉 所 有 在 该 集群 数据 目录 里 的 现存 文件 ， 以 及 所 有 你 使 用 的 表 空 间 里 根 目录 下 
的 现存 文件 。 


4.， 从 你 的 各 份 转 储 中 恢复 数据 库 文件 。 要 小 心 用 正确 的 所 有 者 (数据 库 系 统 用 户 ， 而 不 
是 root !) 和 权限 恢复 它们 。 如 果 你 使 用 了 表 空 间 ， 你 可 能 需要 核实 在 pg_tblspc/ 里 的 
符号 连接 都 得 到 正确 恢复 。 


5， 删 除 任何 目前 还 在 pg_xlog/ 里 的 文件 ; 这 些 文件 来 自 备份 转 钳 ， 因此 它们 可 能 比 目 前 的 
老 。 如 果 你 就 根本 没有 汶 档 pg_xlog/ ， 那 么 重建 之 ， 它 具 有 合适 的 权限 ， 如 果 你 已 经 像 
从 前 那样 建立 了 ， 小 心 确保 你 重新 建立 它 作为 符号 链接 ， 


6. 如 果 你 有 在 步骤 2 里 面 保 存 的 WAL 段 文件 ， 那 么 把 它们 拷贝 到 pg_xlog/ 。 最 好 是 拷贝 
它们 ， 而 不 是 把 它们 移动 回来 ， 这 样 即使 发 生 了 糟糕 的 事情 ， 你 需要 重启 的 时 候 ， 你 也 
依然 拥有 未 修改 的 文件 。 


7， 在 集群 数据 目录 里 创建 一 个 恢复 命令 文件 recovery.conf (参阅 Chapter 26), 你 可 能 还 需 
要 临时 修改 pg_hba.conf 以 避免 普通 用 户 连接 ， 直到 你 确信 恢复 已 经 正常 了 为 止 。 


8. 启动 服务 器 。 服 务 器 将 进入 恢复 模式 并 且 续 续 读 取 它 需要 的 WAL 轨 档 文件 。 在 遇见 外 部 
错误 的 应 当中 止 恢复 过 程 ， 然 后 重新 启动 服务 器 ， 这 样 它 会 自动 继续 进行 恢复 工作 。 在 
恢复 过 程 完成 后 ， 服务 器 将 把 recovery.conf 改名 为 recovery.done 以 避免 不 小 心 因 后 
面 的 贿 汪 再 次 进入 恢复 模式 ， 然后 开始 正常 的 数据 库 操作 。 


9. 检查 数据 库 的 内 容 以 确保 你 已 经 恢复 到 你 期 望 的 位 置 。 如 果 还 没有 ， 回 到 步骤 1。 如 果 
全 部 正常 ， 则 恢复 pg_hba.conf 成 正常 状态 以 允许 普通 用 户 登录 。 


所 有 这 些 操作 的 关键 是 设置 一 个 恢复 命令 文件 ， 这 个 文件 描述 你 希望 如 何 恢复 以 及 恢复 应 该 
走 到 哪里 。 你 可 以 使 用 recovery.conf.sample (通常 安装 在 安装 目 录 的 share/ 子 目 录 里 ) 作 为 
原型 。 你 必须 在 recovery.conf 里 面 声 明 的 一 个 东西 是 restore command, 它 告诉 系统 如 何 拿 
回 为 档 的 WAL 文 件 段 。 类 似 archive_command ， 这 个 是 一 个 脚本 命令 字符 串 。 它 可 以 包 

含 xf ， 这 个 变量 会 被 需要 的 日 志文 件 名 替换 ， 以 及 wp ， 它 会 被 要 持 贝 去 的 日 志文 件 的 绝对 
BES. 如 果 需 要 在 命令 里 蔡 换 真正 的 % FF, MARRE w) 最 简单 的 有 用 命令 是 
类 似 下 面 的 东西 : 


restore_command = 'cp /mnt/server/archivedir/%f %p' 


这 个 命令 将 把 以 前 兴 档 的 WAL 段 从 ymnt/server/archivedir 目录 拷贝 过 来 。 你 当然 可 以 使 用 
某 些 更 复杂 的 东西 ， 甚 至 是 一 个 要 求 操作 者 挂 载 合适 的 磁带 的 shell 脚 本 。 


重要 的 一 点 是 : 该 命令 在 失败 的 时 候 返 回 非 雳 值 。 如 果 日 志文 件 没 有 出 现在 规 档 中 ， 那么 该 
系统 将 要 询问 该 命令 ; 在 问 到 的 时 候 ， 它 必须 返回 非 需 。 这 个 不 是 错误 条 件 。 并 不 是 所 有 需 

要 的 文件 都 是 WAL 分 段 文件 ; 你 应 该 希望 请 求 .backup 或 者 .history 的 后 级 文件 。 还 要 注 

意 wp 路 径 的 基础 名 将 和 %f 不 一 样 ; 不 要 认为 它们 是 可 以 互 换 的 。 

在 娄 档 中 没有 的 WAL 分 段 业 在 pg_xlog/ 中 ; 这 样 就 允许 使 用 最 近 没 有 六 档 的 段 。 但 是 在 兴 档 
中 的 段 将 比 pg_xlog/ 中 的 优先 。 

通常 ， 恢 复 将 义理 所 有 可 用 的 WAL 段 ， 因此 将 把 数据 库 恢 复 到 当前 时 间 ( 或 者 是 在 所 给 出 的 

可 用 WAL 段 数 的 情况 下 ， 我 们 能 走 到 的 最 近 的 地 方 )。 因此 ， 一 个 正常 恢复 以 "文件 没 找 

到 "信息 结束 ， 错误 信息 的 确切 文本 依赖 于 restore_command 你 的 选择 。 你 也 可 能 在 类 似 


于 o0000001.history 文件 恢复 开头 看 到 错误 信息 。 这 也 是 正常 的 ， 并 不 表明 简单 恢复 情况 下 
的 问题 。 参 阅 Section 24.3.5 获取 更 多 信息 。 


但 是 如 果 你 想 恢 复 到 某 些 以 前 的 时 刻 点 (比如 ， 在 菜 乌 DBA 删除 你 的 主要 事务 表 之 前 )， 那么 
只 需要 在 recovery.conf 里 声明 要 求 的 停止 点 。 你 可 以 通过 日 期 /时 间 来 声明 ， 也 可 以 通过 特 
定 事务 ID 的 结束 来 声明 这 个 停止 点 ， 我 们 叫做 "恢复 目标 "。 目 前 ， 只 有 日 期 /时 间 和 称 为 恢复 
点 选项 比较 有 用 ， 因为 我 们 没有 工具 来 帮助 你 精确 地 标识 应 该 使 用 哪个 事务 ID。 


Note: 请 注意 停止 点 必须 在 备份 的 终止 时 间 之 后 (也 就 是 pg_stop_backup 的 时 间 )。 你 无 
法 使 用 一 个 基础 备份 恢复 到 各 份 正在 进行 中 的 某 个 时 刻 。 要 想 恢复 到 该 时 刻 ， 你 必须 回 
到 你 以 前 的 基础 各 份 ， 然 后 从 那个 位 置 向 前 滚动 。 











如 果 在 恢复 过 程 中 发 现在 WAL 数据 中 存在 错误 ， 那 么 恢复 将 在 错误 的 地 方 停止 ， 并 且 不 会 启 
动 服务 器 。 在 这 种 情况 下 ， 可 以 指定 一 个 位 于 错误 点 之 前 的 "恢复 目标 "， 然后 从 起 始点 开始 
重新 运行 恢复 进程 ， 这 样 恢 复 就 可 以 正常 完成 。 如 果 由 于 外 部 原因 (系统 崩溃 、 无 法 读 取 
WAL 归档 ) 导 致 恢 复 失 败 ， 那么 可 以 简单 的 重新 启动 恢复 过 程 即 可 ， 它 将 从 上 次 失败 的 地 方 
继续 。 重新 启动 恢复 过 程 与 检查 点 的 操作 非常 类 似 : 服务 器 周期 性 的 强制 将 其 状态 记录 到 磁 
盘 上 并 更 新 pg_control 文件 以 标识 已 经 义理 的 WAL 数据 不 需要 被 再 次 扫描 。 


24.3.5. 时 间 线 


能 够 把 数据 库 恢 复 到 以 前 的 某 个 时 间 点 的 能 力 导 致 了 一 些 类 似 科 幻 小 说 里 的 时 间 跟 踪 和 并 行 
宇宙 这 样 的 复杂 情况 。 在 数据 库 最 初 的 历史 里 ， 可 能 你 在 周二 下 午 5:15 删 除 掉 了 一 个 非常 关 
键 的 表 。 但 是 没有 意识 到 你 自己 的 错误 直到 周三 中 午 。 有 条 不 率 地 拿 出 各 份 ， 恢 复 到 周二 晚 
上 5:14 的 即时 备份 。 在 这 个 数据 库 宇 宙 的 历史 里 ， 你 从 来 没有 删除 过 那个 表 。 但 是 假如 你 后 
来 认识 到 这 么 干 是 错误 的 ， 并 且 想 回 到 最 初 的 历史 中 的 稍 后 的 点 。 你 没 法 这 么 干 ， 因 为 在 数 
据 库 运行 的 时 候 ， 它 覆 盖 了 一 些 WAL 段 文件 的 序列 ， 这 些 序列 就 在 你 希望 回去 的 区 间 里 。 
此 你 的 确 需 要 区 分 在 你 从 那些 原始 数据 库 历史 生成 的 WAL 中 完成 即时 恢复 之 后 生成 的 WAL 序 
列 。 


为 了 义理 这 些 问题 ，PostgreSQL 有 个 叫 时 间 线 的 概念 。 当 完 成 一 个 具 档 恢复 时 ， 那 么 就 创建 
一 个 新 的 时 间 线 ， 以 表示 在 该 次 恢复 之 后 生成 的 WAL 记录 序列 。 时 间 线 ID 号 是 WAL 段 文件 
名 的 一 部 分 ， 因此 新 的 时 间 线 并 不 会 覆盖 以 前 的 时 间 线 生成 的 WAL 数据 。 实际 上 我 们 可 以 
归档 许多 不 同 的 时 间 线 。 虽 然 这 些 看 起 来 像 没 用 的 特性 ， 但 它 却 可 能 常常 是 救命 稻草 。 考 虑 
一 下 你 并 不 很 确信 应 该 恢复 到 那个 时 刻 的 情况 ， 这 个 时 候 你 不 得 不 做 好 几 次 试验 性 即时 恢复 
然后 从 中 找到 旧历 史 中 最 好 的 分 支 。 如 果 没 有 时 间 线 ， 那 么 这 个 过 程 可 能 很 快 就 会 导致 无 法 
管理 的 混乱 。 有 了 时 间 线 ， 你 可 以 恢复 到 任意 以 前 的 状态 ， 包括 恢复 到 你 后 来 放弃 的 时 间 线 
分 支 的 状态 。 

每 当 创建 一 个 新 的 时 间 线 的 时 候 ，PostgreSQL 都 创建 一 个 "时 间 线 历史 "文件 ， 它 显 示 自 己 从 
哪个 时 间 线 分 出 来 ， 以 及 何 时 分 出 来 的 。 这 些 历史 文件 是 在 从 包含 多 个 时 间 线 的 轨 档 中 进行 
恢复 时 ， 人 允许 系统 选取 正确 WAL 段 文件 的 必要 文件 。 因 此 ， 它们 像 WAL 段 文件 一 样 为 档 到 


WAL 为 档 里 。 历史 文件 只 是 很 小 的 文本 文件 (不 像 段 文件 很 大 )， 所 以 独立 地 保存 他 们 代价 很 
小 ， 也 值得 做 。 如 果 你 喜欢 ， 你 可 以 在 历史 文件 里 加 入 注释 ， 记 录 自 己 为 什么 设置 这 个 时 间 
线 以 及 如 何 设置 的 等 信息 。 这 样 的 注释 会 在 你 有 厚 厚 一 堆 不 同 的 时 间 线 需要 选择 和 分 析 的 时 
候 特别 有 价值 。 


恢复 的 缺 省 的 行为 是 治 着 与 基础 备份 的 同一 个 时 间 线 恢复 。 如 果 你 想 恢复 到 某 些 子 时 间 线 ， 
也 就 是 ， 你 想 回 到 某 些 本 身 就 是 在 开始 恢复 之 后 发 生 的 状态 。 你 需要 在 recovery.conf EA 
明 目 标 时 间 线 ID。 你 无 法 恢复 到 上 比 基 础 备份 更 早 的 时 间 线 分 支 。 


24.3.6. 技巧 和 例子 


给 出 了 配置 连续 为 档 的 一 些 技巧 。 


24.3.6.1. 单机 热 各 


可 以 使 用 PostgreSQL 各 份 工 具 产 生 单 机 热 备 。 这 些 都 是 不 能 使 用 时 间 点 恢复 的 备份 ， 往往 各 
份 和 恢复 比 pg_dump 转 储 速度 更 快 。 (他 们 也 比 pg_dump 转 储 更 大 ， 因 此 在 某 些 情况 下 速度 
优势 可 能 是 否定 的 ) 。 

作为 基础 备份 ， 最 简单 的 方式 是 使 用 pg_basebackup 工 具 产 生 单机 热 各 份 。 当 调 用 它 时 ， 如 
RRE -x 参数 ， 那 么 所 有 需要 使 用 各 份 的 事务 日 志 将 包含 在 自动 各 份 中 ， 并 且 不 需要 特殊 
操作 恢复 备份 。 

如 果 在 复制 各 份 文件 中 需要 更 大 的 灵活 性 ， 较 低 的 水 平 过 程 可 更 好 用 于 单机 热 备份 。 为 了 准 


各 低 水 平 单机 热 备份 ， 设 置 wal_level 到 archive (或 者 hot_standby )，archive_mode 为 
on ， 并 且 只 有 当 开 关 文 件 存在 时 ， 建立 archive_command 执行 存档 。 例 如 : 


archive_command = 'test ! -f /var/lib/pgsql/backup_in_progress || (test ! -f /var/lib/pgs 
EE 


当 /var/lib/pgsql/backup_in_progress 存在 时 ， 这 个 命令 将 执行 注 档 。 ENR SRH 
状态 (人 允许 PostgreSQL 回 收 不 需要 的 WAL 文 件 ) 。 





有 了 这 个 准备 ， 备 份 可 以 使 用 如 下 脚本 : 


touch /var/1lib/pgsql/backup_in_progress 

psql -c "select pg_start_backup('hot_backup');" 

tar -cf /var/lib/pgsql/backup.tar /var/lib/pgsql/data/ 
psql -c "select pg_stop_backup();" 

rm /var/lib/pgsql/backup_in_progress 

tar -rf /var/lib/pgsql/backup.tar /var/lib/pgsql/archive/ 


开关 文件 /var/lib/pgsql/backup_in_progress 是 第 一 次 创建 ， 使 已 完成 的 WAL 文 件 的 愉 档 发 
生 。 在 备份 后 删除 开关 文件 。 愉 档 的 WAL 文 件 然后 添加 至 备份， 使 两 个 基础 各 份 和 所 有 必需 
的 WAL 文 件 是 相同 的 tar 文 件 的 一 部 分 。 请 记 住 ， 错 误 义理 添 加 到 您 的 各 份 脚本 中 。 


24. 3. 6. 2. 三 JE BG 轨 档 =i /CN 
如 果 六 档 存储 大 小 是 一 个 问题 ， 你 可 以 使 用 gzip 压缩 注 档 文件 : 


archive_command = 'gzip < %p > /var/lib/pgsql/archive/%f ' 


在 恢复 过 程 中 你 需要 使 用 gunzip : 


restore_command = 'gunzip < /mnt/server/archivedir/%f > %p' 


24.3.6.3. archive_command 脚本 


许多 人 选择 使 用 脚本 定义 他 们 的 archive_command , 因此 postgresql.conf 记录 看 起 来 很 简 
BM: 


archive_command = 'local_backup_script.sh "%p" "%f"' 


任何 你 想 在 注 档 过 程 中 使 用 不 只 是 独立 命令 时 。 使 用 一 个 单独 的 脚本 文件 是 可 取 的 ， 这 人 允许 
所 有 的 复杂 性 在 脚本 中 管理 ， 这 可 以 使 用 流行 的 脚本 语言 书写， 如 bash 或 者 perl。 


可 能 在 脚本 中 解决 的 所 需 例子 包含 : 
。 拷贝 数据 到 安全 异地 数据 存储 
© 计量 WAL 文 件 以 致 于 他 们 每 三 个 小 时 改变 ， 而 不 是 一 个 时 间 。 
。 其 他 备份 和 恢复 软件 接口 
。 监控 软件 报告 错误 接口 


Tip: 当 使 用 archive_command 脚本 时 ， 期 望 启动 logging_collector。 来 自 脚本 写 入 stderr 
中 的 任何 消息 将 出 现在 数据 库 服务 器 日 志 中 ， 如 果 失 败 ， 则 允许 简单 地 诊断 复杂 配置 。 





24.3.7. #4 


目前 ， 在 线 备份 技术 还 有 几 个 局 限 。 它 们 可 能 在 将 来 的 版 本 中 修补 : 


。 在 Hash 素 引 上 的 操作 目前 没有 使 用 WAL 记 录 日 志 ， 所 以 重 放 就 不 会 更 新 这 些 素 引 类 型 。 
这 将 意味 着 任何 新 的 插入 被 索引 忽略 ， 已 更 新 行 显然 会 消失 ， 并 且 已 删除 行将 仍然 保留 
指针 。 换 名 话说， 如 果 你 修改 了 带 有 hash 索 引 的 表 ， 那 么 你 将 获得 各 用 服务 器 上 不 正确 
的 查询 结果 。 当 完 成 恢复 时 ， 建 议 是 在 完成 恢复 操作 之 后 手工 REINDEX 每 个 这 样 的 索 
Bl. 


。 如 果 在 进行 数据 库 各 份 的 时 候 发 出 一 个 CREATE DATABASER S, 9 然后 在 这 个 过 程 
中 CREATE DATABASE 命令 拷贝 的 模板 数据 库 被 修改 了 ， 那么 用 这 个 备份 进行 恢复 的 数据 库 
很 有 可 能 导致 这 些 修 改 也 传播 到 新 创建 的 数据 库 中 去 。 这 个 行为 当然 是 不 愿意 看 到 的 。 
为 了 避免 这 个 风险 ， 最 好 在 进行 数据 库 各 份 的 时 候 不 要 修改 任何 模板 数据 库 。 


e CREATE TABLESPACE 命 令 是 用 文本 的 绝对 路 径 记 录 WAL 日 志 的 ， 因此 会 以 相同 的 绝 
对 路 径 重 新 创建 。 如 果 日 志 是 在 另外 一 台 机 器 上 重 放 ， 那么 这 个 行为 可 能 不 是 我 们 想 要 
的 。 即 使 在 同一 台 机 器 ， 但 是 在 一 个 新 的 数据 目录 里 重 放 日 志 ， 都 很 可 能 是 危险 的 : 重 
放 仍 将 会 覆盖 原来 的 表 空 间 的 内 容 。 为 了 避免 这 类 的 潜在 问题 ， 最 好 的 方法 是 在 创建 或 
者 删除 表 空 间 之 后 进行 一 次 新 的 基础 各 份 。 


还 要 注意 ， 缺 省 的 WAL 格 式 体积 相当 大 ， 因 为 它 包 含 许多 磁盘 页 快照 。 这 些 磁盘 页 快照 是 设 
计 来 支持 骨 溃 恢复 的 ， 因为 我 们 可 能 需要 修补 部 分 写 入 的 磁盘 页 。 根 据 你 的 系统 硬件 和 软件 
的 不 同 ， 这 种 部 分 宇 入 的 危险 可 能 是 微乎其微 的 。 这 种 情况 下 ， 你 可 以 通过 使 

用 full_page_writes 关 闭 磁盘 页 面 快照 ， 从 而 大 大 减少 当 档 日 志 的 总 尺寸 (在 你 这 人 么 做 之 前 ， 阅 
读 Chapter 29 里 面 的 注意 和 和 警告 )。 关闭 页 面 快 照 并 不 阻止 日 志 使 用 PITR 操 作 。 一 个 将 来 需 
要 开发 的 功能 是 在 full page writes 打开 的 时 候 ， 通过 删除 不 需要 的 磁盘 页 拷贝 来 压缩 兴 档 
的 WAL 数据 。 同 时 ， 管理 员 可 以 通过 尽量 合理 地 增加 检查 点 的 时 间 间 隔 来 减少 包含 在 WAL 
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多 个 数据 库 服 务 器 可 以 协同 工作 ， 比如 在 主 服 务 器 失效 的 时 候 备份 服务 器 立即 取代 它 的 位 置 
(SAA), 或 者 几 台 机 器 同时 服务 于 同一 个 数据 库 ( 负 载 均 衡 )。 理想 状态 多 台 服 务 器 之 间 可 
以 无 缝 协作 。 为 静态 页 面 提供 服 务 的 Web 服 务 器 可 以 轻松 的 通过 将 web 请 求 分 捧 到 多 人 台 机 器 
从 而 实现 负载 均衡 。 事实 上 ， 只 读数 据 库 也 能 轻松 的 以 相同 的 方法 实现 负载 均衡 。 不 幸 的 

是 ， 大 多 数 数 据 库 服务 器 都 需要 同时 义理 混合 的 读 / 写 请 求 ， 将 这 些 数 据 库 联 合 起 来 工作 是 件 
很 麻烦 的 事 。 虽然 只 读数 据 只 需要 在 每 台 服 务 器 上 复制 一 份 即 可 ， 但 是 在 任何 一 台 服 务 器 上 
的 写 动作 都 必须 传播 到 其 它 所 有 服务 器 上 ， 这 样 才能 保证 将 来 对 这 些 已 修改 数据 的 读 取 返 回 
一 致 的 结果 。 


这 个 写 同 步 问题 就 是 导致 多 台 服 务 器 协同 工作 麻烦 重重 的 最 基本 原因 。 有 多 种 解决 此 问题 的 
方法 ， 其 思路 也 各 不 相同 ， 但 都 不 是 既 简 单 又 高 效 的 方案 。 


有 一 种 解决 方案 是 公允 许 单独 的 一 台 " 主 "服务 器 修改 数据 ， 可 以 修改 数据 的 服务 器 称 为 只 读 / 
写 ，maste1 或 者 primary 服 务 器 。 跟踪 “ 主 ” 服 务 器 数据 变化 的 叫 各 或 者 从 服务 器 。 各 用 服务 器 
不 能 连接 到 主 服务 器 ， 直 到 它 晋 升 为 热 各 服务 器 。 可 以 接受 连接 而 且 只 读 服 务 器 称 为 热 各 服 
务 器 。 


一 些 方 案 是 "同步 的 "， 意思 是 直到 所 有 服务 器 都 完成 了 某 个 修改 数据 的 事务 之 后 ， 该 事务 才 
被 认为 是 已 经 完成 的 。 这 将 确保 失效 切换 不 会 丢失 任何 数据 并 且 所 有 服务 器 都 将 返回 一 致 的 
结果 。 另 一 些 方案 是 "异步 的 "， 这 种 方案 人 允许 在 事务 提交 之 后 与 传播 到 所 有 其 它 服务 器 之 间 
有 一 小 段 延 时 ， 但 是 在 切换 到 各 份 服务 器 的 时 候 某 些 事务 可 能 会 去 失 ， 并 且 不 同 的 服务 器 可 
能 返回 不 一 致 的 结果 。 当 同 步 可 能 会 很 慢 的 时 候 可 以 使 用 异步 通信 。 


还 可 以 按照 粒度 对 解决 方案 进行 分 类 。 某 些 方案 只 能 将 整个 数据 库 集 群 作为 一 个 整体 ， TH 
些 方 案 可 以 针对 每 个 数据 库 或 每 张 表 分 别 做 不 同 的 处 理 。 

在 选择 任何 失效 切换 或 负载 均衡 方案 的 时 候 都 必须 考虑 性 能 因素 。 功能 和 性 能 不 可 兼 得 ， 比 
如 ， 一 个 完全 同步 的 解决 方案 在 慢 速 网 络 上 可 能 削减 性 能 一 半 以 上 ， 而 完全 异步 的 方案 可 能 
仅 对 性 能 有 极其 微小 的 影响 。 


下 面 的 部 分 大 致 描述 了 各 种 常见 的 失效 切换 、 复 制 、 负 载 均 衡 方案 。 glossary 也 是 可 用 的 。 


25.1. 不 同 解决 方案 的 比较 


共享 磁盘 失效 切换 


共享 磁 胡 失效 切换 通过 仅 保存 一 份 数据 库 副 本 来 避免 花 在 同步 上 的 开销 。 这 个 方案 让 多 台 服 
务 器 共享 使 用 一 个 单独 的 磁盘 阵列 。 如 果 主 服务 器 失效 ， 备 份 服务 器 将 立即 挂 载 该 数据 库 ， 
就 像 是 从 一 次 崩溃 中 恢复 一 样 。 这 个 方案 允许 快速 的 失效 切换 并 且 不 会 去 失 数据 。 


共享 硬件 的 功能 通常 由 网 络 存储 设备 提供 ， 也 可 以 使 用 完全 符合 POSIX 行 为 的 网 络 文件 系统 
(参阅 Section 17.2.1)。 这 种 方案 的 局 限 性 在 于 如 果 共 享 的 磁盘 阵列 损坏 了 ， 那么 整个 系统 将 
BRR 另 一 个 局 限 是 备份 服务 器 在 主 服务 器 正常 运行 的 时 候 不 能 访问 共享 的 存储 器 。 
文件 系统 复制 〈 块 设备 ) 

一 种 改进 的 方案 是 文件 系统 复制 : 对 文件 系统 的 任何 更 改 都 将 镜像 到 各 份 服务 器 上 。 这 个 方 


案 的 唯一 局 限 是 必须 确保 各 份 服务 器 的 镜像 与 主 服务 器 完全 一 致 一 特别 是 写 入 顺序 必须 完全 
相同 。DRBD 是 Linux 上 的 一 种 流行 的 文件 系统 复制 方案 。 


事务 日 志 传 送 

热 备份 服务 器 可 以 通过 读 取 WAL 记 录 流 来 保持 数据 库 的 当前 状态 。 如 果 主 服务 器 失效 ， 那 么 
热 备份 服务 器 将 包含 几乎 所 有 主 服务 器 的 数据 ， 并 可 以 迅速 的 将 自己 切换 为 主 服务 器 。 这 是 
一 个 异步 方案 ， 并 且 只 能 在 整个 数据 库 服务 器 上 实施 。 

使 用 基于 文件 的 日 志 传 送 或 流 复制 ， 或 两 者 相 结 合 。 前 者 参阅 Section 25.2, 后 者 参阅 Section 
25.2.5。 请 参阅 Section 25.5 获 取 关 于 热 各 的 信息 。 

基于 触发 器 的 主 各 复制 


这 个 方案 将 所 有 修改 数据 的 请 求 发 送 到 主 服务 器 。 主 服务 器 异步 向 从 服务 器 发 送 数 据 的 更 改 
信息 。 从 服务 器 在 主 服务 器 运行 的 情况 下 只 应 答 读 请 求 。 对 于 数据 仓库 的 请 求 来 说 ， 从 服务 
器 非常 理想 的 。 


Slony-| 是 这 个 方案 的 一 个 例子 ， 它 支持 针对 每 个 表 的 粒度 并 支持 多 个 从 服务 器 。 因为 它 异 
步 、 批 量 的 更 新 从 服务 器 ， 在 失效 切换 的 时 候 可 能 会 有 数据 丢失 。 
基于 语句 的 复制 中 间 件 


可 以 使 用 一 个 基于 语句 的 复制 中 间 件 程序 截取 每 一 个 SQL 查询 ， 并 将 其 发 送 到 某 一 个 或 者 全 
部 服务 器 。 每 一 个 服务 器 都 独立 运行 。 污 - 写 请 求 发 送 给 所 有 服务 器 ， 所 以 每 个 服务 器 接收 到 
任何 变化 。 但 是 只 读 请 求 则 信 发 送 给 某 一 个 服务 器 ， 从 而 实现 读 取 的 负载 均衡 。 


如 果 只 是 简单 的 广播 修改 数据 的 SQL 语句 ， 那么 类 似 random() , CURRENT_TIMESTAMP DARE 
列 函 数 在 不 同 的 服务 器 上 将 生成 不 同 的 结果 。 这 是 因为 每 个 服务 器 都 独立 运行 并 且 广 播 的 是 
SQL 语句 而 不 是 如 何 对 行进 行 修 改 。 如 果 这 种 结果 是 不 可 接受 的 ， 那 么 中 间 件 或 者 应 用 程序 


必须 保证 始终 从 同 一 个 服务 器 读 取 这 些 值 并 将 其 应 用 到 写 入 请 求 中 。 另外 还 必须 保证 每 一 个 
事务 必须 在 所 有 服务 器 上 全 部 提交 成 功 或 者 全 部 回 滚 ， 或 者 使 用 两 阶段 提交 (PREPARE 
TRANSACTION 和 COMMIT PREPARED), Pgpool-ll 和 Continuent Tungsten 是 这 种 方案 的 
实例 。 

异步 多 主 服务 器 复制 

对 于 那些 不 规则 连接 的 服务 器 (比如 笔记 本 电脑 或 远程 服务 器 )， 要 在 它们 之 间 保 持 数 据 一 致 
是 很 麻烦 的 。 在 这 个 方案 中 ， 每 台 服 务 器 都 独立 工作 并 周期 性 的 与 其 他 服务 器 通信 以 识别 相 
互 冲突 的 事务 。 可 以 通过 用 户 或 者 冲突 判决 规则 义理 出 现 的 冲突 。 

同步 多 主 服务 器 复制 

在 这 种 方案 中 ， 每 个 服务 器 都 可 以 接受 写 和 人 请求 ， 修改 的 数据 将 在 事务 被 提交 之 前 必须 从 原 
始 服务 器 广播 到 所 有 其 它 服务 器 。 过 多 的 写 入 动作 将 导致 过 多 的 锁定 ， 从 而 导致 性 能 低下 。 
事实 上 ， 在 多 台 服 务 器 上 同时 写 的 性 能 总 是 比 在 单独 一 台 服 务 器 上 写 的 性 能 低 。 读 请 求 将 被 
均衡 的 分 散 到 每 台 单 独 的 服务 器 。 某 些 实现 使 用 共享 磁盘 来 减少 通信 开销 。 同步 多 主 服务 器 
复制 方案 最 适合 于 读 取 远 多 于 写 入 的 场合 。 它 的 优势 是 每 台 服 务 器 都 能 接受 写 请 求 一 因此 不 
需要 在 主 从 服务 器 之 间 划 分 工作 负荷 。 因为 在 服务 器 之 间 发 送 的 是 数据 的 变化 ， 所 以 不 会 对 
非 确 定性 函数 (比如 random() ) 造 成 不 良 影响 。 


PostgreSQL 不 提供 这 种 类 型 的 复制 。 但 是 PostgreSQL 的 两 阶段 提交 (PREPARE 
TRANSACTION 和 COMMIT PREPARED) 可 以 用 于 在 应 用 层 或 中 间 件 代码 中 实现 这 个 功能 。 


商业 解决 方案 


因为 PostgreSQL 是 开放 源 代码 并 且 很 容易 被 扩展 ， 许多 公司 在 PostgreSQL 的 基础 上 创建 了 
商业 的 闭 源 解决 方案 ， 提供 独特 的 失效 切换 、 复 制 、 负 载 均 衡 功 能 。 


Table 25-1 总 结 了 以 上 所 列 的 各 种 解决 方案 的 能 力 。 


Table 25-1. High Availability, Load Balancing, and Replication Feature Matrix 


Feature 


Most Common 
Implementation 


Communication 
Method 


No special 
hardware 
required 


Allows multiple 
master servers 


No master 
server 
overhead 


No waiting for 
multiple servers 


Master failure 
will never lose 
data 


Standby accept 
read-only 
queries 


Per-table 
granularity 


No conflict 
resolution 
necessary 


Shared 
Disk 
Failover 


NAS 


shared 
disk 


with hot 


File 
System 
Replication 


DRBD 


disk blocks 


with sync 
off 


有 几 个 解决 方案 不 适合 上 边 这 些 分 类 : 


数据 分 区 


数据 分 区 将 表 拆 分 为 数据 集 。 每 个 数据 集 只 有 一 台 服 务 器 可 以 修改 。 


处 进行 分 区 ， 例 如 ， 伦敦 和 巴黎 ， 每 个 办 公 室 用 一 个 服务 器 。 如 果 查 询 需 要 伦敦 和 巴黎 相 结 


Transaction 
Log 
Shipping 


Streaming 
Repl. 


WAL 


with sync on 


Trigger- 
Based 
Master- 
Standby 
Replication 


Slony 


table rows 


Statemel 

Based 
Replicati 
Middlewz 


pgpool-ll 


SQL 


例如 ， 数 据 可 以 按 办 事 


合 的 数据 ， 应 用 程序 可 以 查询 两 台 服 务 器 ， 或 主 / 各 用 复制 可 以 用 来 保持 每 个 服务 器 上 有 其 他 
办 公 室 的 只 读数 据 副本 。 


多 服务 器 并 行 查询 执行 


许多 上 述 解 决 方案 允许 多 个 服务 器 来 处 理 多 个 查询 ， 但 不 是 允许 单个 查询 使 用 多 个 服务 器 来 
更 快 完成 。 此 解决 方案 允许 多 个 服务 器 上 单个 查询 同时 运行 。 它 通 常 被 通过 服务 器 之 间 的 数 
据 分 开 而 执行 其 查询 的 一 部 分 ， 并 将 结果 返回 到 中 央 服 务 器 ， 由 它 来 联合 结果 并 返回 给 用 
户 。 Pgpool-llI 有 这 种 能 力 。 也 可 以 使 用 PL/Proxy 工 具 集 实现 。 


25.2. 日 志 传 送 各 份 服务 器 


连续 为 档 可 以 配合 随时 准备 取 代 失 效 主 服务 器 的 一 个 或 多 个 各 份 服务 器 ， 用 于 创建 一 个 高 可 
用 性 (HA) 集 群 。 这 个 能 力 通常 被 称 为 热 备份 或 日 志 传送 。 


虽然 主 服务 器 和 各 份 服务 器 只 是 松散 的 耦合 在 一 起 ， 但 它们 必须 同时 运行 。 主 服务 器 以 连续 
为 档 模 式 运 行 ， 备份 服务 器 以 连续 恢复 模式 运行 并 从 主 服务 器 不 停 的 读 取 WAL 文 件 。 因为 数 
据 库 的 表 无 需 为 此 进行 任何 改变 ， 所 以 与 其 它 复制 方法 相 比 ， 额外 的 管理 开销 很 小 。 并 且 这 
种 方法 对 主 服务 器 的 性 能 影响 也 很 小 。 


直接 从 一 个 数据 库 服务 器 移动 WAL 到 另 一 个 服务 器 通常 被 称 为 日 志 传送 (LogShipping)。 
PostgreSQL 实 现 了 基于 文件 的 日 志 传送 ， 意思 是 WAL 记 录 每 次 移动 一 个 完整 的 文件 (WAL 
段 )。 WAL 文 件 (16MB) 可 以 被 轻易 的 在 任意 两 个 地 点 之 间 传 送 ， 不 管 是 与 邻近 的 系统 还 是 
地 球 另 一 面 的 系统 。 所 需 带 宽 取 决 于 主 服 务 器 的 事务 发 生 速度 。 基于 记录 的 日 志 传 送 更 加 细 
粒度 ， 并 且 WAL 流 在 网 络 连接 中 增 量 改变 。 


日 志 传 送 是 异步 的 ， 也 就 是 WAL 记 录 在 事务 提交 之 后 才 被 传送 。 也 就 是 说 主 服务 器 遭遇 致命 
故障 后 尚未 传送 的 事务 数据 将 会 丢失 。 数据 丢失 的 长 度 可 以 使 用 archive_timeout 加 以 限制 ， 
比如 限制 为 几 秒 钟 。 当然 这 么 小 的 设置 也 导致 了 传送 带宽 的 大 幅 增 长 。 流 复制 (参阅 Section 
25.2.5) 允许 数据 丢失 的 更 小 窗口 。 


恢复 性 能 足够 好 ， 各 份 服务 器 一 旦 被 激活 通常 只 有 很 短 的 时 间 不 能 使 用 。 因此 ， 我 们 认为 这 
个 方案 可 以 作为 热 各 份 来 提供 高 可 用 性 。 将 服务 器 从 一 个 已 归档 的 基础 各 份 中 恢复 将 可 能 耗 
费 大 量 时 间 ， 所 以 这 个 方案 只 能 用 于 灾难 恢复 而 不 能 用 于 提供 高 可 用 性 。 各 用 服务 器 还 可 以 
用 于 只 读 查 询 ， 在 这 种 情况 下 它 被 称 为 热 备份 服务 器 。 参见 Section 25.5 获 取 更 多 信息 。 


25.2.1. 规划 


至 少 从 数据 库 服务 器 的 角度 看 ， 创建 主 服务 器 和 各 份 服务 器 并 使 两 者 尽 可 能 完全 相同 是 非常 
明智 的 。 特别 是 表 空 间 的 路 径 名 必须 保持 完全 一 致 ， 这样 主 服务 器 和 各 份 服务 器 就 必须 拥有 
同样 的 表 空 间 挂 载 路 径 ( 如 果 使 用 了 表 空 间 的 话 )。 需要 记 住 的 是 如 果 在 主 服 务 器 上 执行 了 
CREATE TABLESPACE 命 令 ， 那 么 该 命令 需要 的 任何 新 挂 载 点 必须 在 执行 该 命令 之 前 同时 
在 主 服务 器 和 各 份 服务 器 上 创建 。 硬件 不 必 完 全 相同 ， 但 是 经 验 显示 维 扩 两 个 完全 相同 的 系 
统 比 维护 两 个 不 同 的 系统 要 少许 多 麻烦 。 无 论 如 何 ， 应 尽量 保持 体系 结构 相同 一 比如 一 个 是 
32-bit 系 统 另 一 个 是 64-bit 系 统 将 不 能 正常 工作 。 


通常 ， 在 主 PostgreSQL 版 本 不 同 的 服务 器 之 间 传 送 日 志 是 不 可 能 的 ， 它 是 PostgreSQL 全 球 
开发 组 在 次 要 版 本 升级 中 不 能 改变 磁盘 格式 的 一 种 策略 。 在 主 服 务 器 和 各 份 服务 器 上 运行 不 
同 的 次 要 版 本 可 能 成 功 。 但 是 ， 没 有 正式 支持 ， 建 议 你 尽 可 能 的 保持 主 服 务 器 和 备用 服务 器 


在 同一 个 级 别 上 。 在 进行 版 本 升级 的 时 候 ， 正 确 的 做 法 是 首先 升级 各 份 服务 器 一 因为 新 版 本 
的 服务 器 通常 可 以 读 取 老 版 本 的 WAL 文 件 ， 但 反之 则 不 然 。 


25.2.2. 各 用 服务 器 操作 


在 各 用 模式 ， 该 服务 器 连续 应 用 从 主 服务 器 收取 的 WAL。 各 服务 器 可 以 从 一 个 WAL 为 档 ( 参 
阅 restore_command) 或 直接 通过 一 个 TCP 连 接 ( 流 复制 ) 从 主 服务 器 上 读 取 WAL。 各 服务 
器 也 可 以 在 各 用 集群 pg_xlog 尝试 查找 恢复 任何 WAL。 这 通常 发 生 在 服务 器 重启 后 ， 当 各 服 
SaaS, ESSE Sa, 从 主 服务 器 流 复制 的 WAL， 但 是 你 也 可 以 手工 复制 文件 

到 pg_xlog ， 在 任何 时 候 可 以 重播 它们 。 


在 启动 ， 备 服务 器 恢复 可 用 在 所 有 的 WAL 开 始 存 档 位 置 ,调用 restore_command, 一 旦 它 到 达 
可 用 WAL 的 结束 ， restore_command 失败 ， 将 尝试 恢复 pg_ xlog 目录 下 任何 可 用 的 WAL。 如 
果 那 也 失败 了 ， 并 且 已 经 配置 了 流 复制 ， 则 尝试 连接 到 主 服 务 器 ， 从 在 为 档 或 pg_xlog 找到 
最 后 一 条 有 效 的 记录 开始 WAL 流 。 如 果 那 也 失败 了 ， 或 没有 配置 流 复制 ， 或 连接 断 开 ， 各 服 
务 器 再 次 回 到 步骤 1， 循 环 党 试 从 汶 档 里 恢复 文件 。 从 轨 档 ， pg_xlog ， 通 过 连续 流 复制 直到 
服务 器 停止 或 有 触发 器 文件 触发 的 失效 切换 时 。 


当 运 行 pg_ctl promote 时 ， 或 者 找到 一 个 触发 文件 ( trigger_file ) 时 ， 退出 各 用 模式 并 且 
服务 器 切换 到 正常 运行 。 在 失效 切换 前 ， 将 立即 恢复 兴 档 或 pg_xlog 任何 可 用 的 WAL， 但 不 
做 党 试 连接 主 服务 器 。 


25.2.3. 为 各 用 服务 器 准备 主 服务 器 


在 主 服务 器 上 设置 连续 兴 档 到 一 个 备 服务 器 可 访问 的 存档 目录 ， 正如 Section 24.3 所 描述 的 。 
即使 主 服务 器 关 掉 ， 从 备 服务 器 应 该 可 以 访问 这 个 归档 位 置 。 即 它 应 该 驻 留 在 被 服务 器 自身 
或 其 它 可 信赖 的 服务 器 ， 而 不 是 主 服 务 器 。 


如 果 你 想 使 用 流 复制 ， 在 主 服务 器 上 设置 认证 ， 人 允许 从 备用 服务 器 复制 连接 ; 
在 pg_hba.conf 提供 一 个 或 多 个 合适 项 使 用 数据 库 字 段 设置 replication o 还 要 在 主 服务 器 
的 配置 文件 确保 设置 max_wal_senders 足够 大 。 


启动 备用 服务 器 做 一 个 基准 备份 ， 参 见 Section 24.3.2。 


25.2.4. 建立 各 用 服务 器 


要 建立 各 用 服务 器 ， 从 主 服务 器 恢复 基准 备份 (参阅 Section 24.3.4) 。 在 各 用 服务 器 的 集群 
数据 目录 ， 创 建 一 个 恢复 命令 文件 recovery.conf , 开启 standby mode 。 设 

Í restore_command 为 一 条 从 WAL 当 档 复制 文件 的 简单 命令。 如 果 为 了 高 可 用 性 目的 计划 有 
多 个 备用 服务 器 ， 设置 recovery_target_timeline 为 latest , 使 得 各 用 服务 器 按照 发 生 故 障 
转移 到 另 一 个 各 用 服务 器 的 时 间 变 化 。 





Note: 不 要 使 用 内 置 在 这 里 描述 的 各 用 模式 pg_standby 或 类 似 的 工具 。 如 果 该 文件 不 存 
TE, restore_command 应 该 立即 返回 。 如 果 必 要 服务 器 将 再 次 党 试 这 个 命令 。 关于 使 用 
工具 像 pg_standby 的 详情 参阅 Section 25.4, 








如 果 你 想 使 用 流 复 制 ， 在 primary_conninfo 填写 一 个 libpq 连 接 串 ， 其 包括 主机 名 (IPH 
tit) 和 连接 到 主 服务 器 需要 的 其 它 详 细 信息 。 如 果 主 服务 器 需要 个 密码 验证 ， 也 要 
在 primary_conninfo 指定 所 需要 的 密码 。 


如 果 你 要 建立 高 可 用 目的 备 服 务 器 ， 设 置 WAL 六 档 ， 像 主 服务 器 的 连接 和 身份 验证 ， 因 为 在 
失效 切换 后 ， 各 服务 器 要 作为 主 服务 器 运行 。 


如 果 你 使 用 WAL 为 档 ， 其 大 小 可 以 使 用 archive_cleanup_command 这 个 参数 设置 最 小 ， 用 来 
删除 那些 各 服务 器 不 再 需要 的 文件 。 专门 设计 的 pg_archivecleanup 这 个 实用 程序 就 是 在 通常 
的 单 各 配置 里 ， 使 用 archive_cleanup_command 的 。 参阅 bg_archivecleanup。 请 注意 ， 如 果 
你 使 用 各 份 目的 为 档 ， 你 仍 要 保留 需要 恢复 的 至 少 最 新 的 基准 备份 文件 ， 即使 各 服务 器 不 再 


recovery .conf 的 一 个 简 单 例子 : 


standby_mode = 'on' 

primary_conninfo = 'host=192.168.1.50 port=5432 user=foo password=foopass' 
restore_command = 'cp /path/to/archive/%f %p' 

archive_cleanup_command = 'pg_archivecleanup /path/to/archive %r' 


你 可 能 有 任何 数目 的 备 服务器， 但 是 如 果 你 用 流 复制 ， 确保 你 在 主 服务 器 上 设置 
的 max_wal_senders 足够 大 人 允许 它们 同时 连接 。 


25.2.5. 流 复制 


与 基于 文件 日 志 传 送 相 比 ， 流 复制 允许 保持 备 服务 器 更 新 。 备 服务 器 连接 主 服务 器 ， 其 产生 
的 流 WAL 记 录 到 各 服务 器 ， 而 不 需要 等 待 填写 WAL 文 件 。 


流 复制 是 异步 的 ， 参 阅 Section 25.2.7, 在 主 服 务 器 上 提交 事务 和 各 用 服务 器 上 变化 可 见 之 间 
有 一 个 小 的 延迟 。 这 个 延迟 远 小 于 基于 文件 日 志 传 送 ， 通 常 1 秒 内 足够 与 负载 保持 。 使 用 流 
复制 ， 为 减少 数据 丢失 窗口 archive_timeout 不 是 必要 的 。 


如 果 使 用 流 复制 而 不 是 基于 文件 连续 为 档 ， 你 要 在 主 服务 器 设置 wal_keep_segments 为 一 个 足 
够 大 的 值 以 使 不 太 早 的 回收 旧 WAL 段 ， 当 各 服务 器 可 能 仍 需 要 它们 赶 上 。 如 果 各 服务 器 落后 
太 多 ， 需要 用 一 个 新 基准 各 份 重新 初始 化 。 如 果 你 设置 一 个 各 服务 器 可 访问 的 WAL 凡 档 ， 
wal_keep_segments 是 不 必要 的 ， 作为 备 服务 器 总 是 使 用 为 档 来 赶 上 。 


要 使 用 流 复制 ， 建 立 一 个 基于 文件 的 日 志 传 送 各 服务 器 描述 在 Section 25.2。 该 步 将 一 个 基于 
文件 的 日 志 传送 各 服务 器 转 为 流 复制 各 服务 器 ， 在 recovery.conf 文件 中 设 
i@ primary_conninfo 指向 主 服务 器 。 在 主 服务 器 上 设置 listen addresses 和 身份 验证 选项 


(参阅 pg_hba.conf ) ， 因此 备用 服务 器 可 以 连接 到 在 主 服务 器 的 replication ty HEE 
(参阅 Section 25.2.5.1) 。 


系统 上 支持 保持 活动 的 套 接 字 选项 ， 设置 tcp_keepalives_idle, tcp_keepalives_interval 和 
tcp_keepalives_count 帮助 主机 及 时 发 现 断 开 的 连接 。 


设置 各 用 服务 器 的 最 大 并 发 连接 数 。 (参阅 max_wal senders 获 取 更 多 详细 信息 ) 。 
B 


当 启 动 了 各 服务 器 并 且 正 确 设 置 了 primary_conninfo ,该 各 服务 器 在 回放 所 有 可 用 的 WAL 文 件 
后 ， 将 连接 到 主 服务 器 。 如 果 成 功 建立 了 该 连接 ， 你 将 在 各 服务 器 中 看 到 WAL 接 收 进程 ， 并 
且 在 主 服 务 器 相应 的 一 个 WAL 发 送 进程 。 


25.2.5.1. 身份 验证 


复制 的 访问 权限 设置 是 很 重要 的 ， 所 以 只 有 受信 任 的 用 户 可 以 读 取 WAL 流 ， 因为 很 容易 从 中 
提取 权限 信息 。 各 服务 器 必须 验证 作为 主 服务 器 的 超级 用 户 或 者 有 REPLICATION 权限 的 用 
Po 建议 为 复制 创建 一 个 带 有 REPLICATION 和 LoGIN 权限 的 专 有 用 户 账号 。 

当 REPLICATION 权限 有 很 高 权限 时 ， 不 允许 用 户 修改 主 服 务 器 上 的 任何 数据 ， 其 


中 suPERUSER 就 是 这 样 的 。 


由 一 条 pg_hba.conf 记录 指定 replication 在 _database_ 字段， 控制 客户 端的 复制 验证 。 例 
如 ， 如 果 各 服务 器 是 运行 在 主机 |P 192.168.1.100 和 复制 时 超级 用 户 名 为 foo, 管理 员 可 以 
在 主 服务 器 pg_hba.conf 文件 里 添加 下 面 行 : 


# Allow the user "foo" from host 192.168.1.100 to connect to the primary 
# as a replication standby if the user's password is correctly supplied. 
# 

# TYPE DATABASE USER ADDRESS METHOD 
host replication foo 192.168.1.100/32 md5 


主 服 务 器 的 主机 名 和 端口 号 ， 连 接 用 户 名 ， 和 在 recovery.conf 文件 指定 的 密码 。 该 密码 也 
可 以 在 各 服务 器 的 ~/ .pgpass 文件 里 设置 。 (在 _database 字段 指定 replication ) 。 例 
如 ， 如 果 主 服务 器 是 运行 的 主机 IP 192.168.1.50 ,端口 号 5432 , 复制 时 用 户 名 为 foo, MA 
码 为 foopass , 管理 员 可 以 在 各 服务 的 recovery.conf 文件 里 添加 下 面 行 : 


# The standby connects to the primary that is running on host 192.168.1.50 
# and port 5432 as the user "foo" whose password is "foopass". 
primary_conninfo = 'host=192.168.1.50 port=5432 user=foo password=foopass' 


25.2.5.2. 监控 


流 复制 的 一 个 重要 的 健康 指标 是 在 主 服务 器 生成 的 WAL 记 录 数 ， 而 不 是 在 各 服务 器 应 用 的 数 
量 。 通 过 比较 在 主 服务 器 当前 WAL 写 的 位 置 和 各 服务 器 收 到 的 最 后 一 个 WAL 位 置 ， 就 可 以 计 
算出 这 种 滞 后 。 在 主 服 务 器 上 使 用 pg_current_xlog_location 和 在 备 服 务 器 上 使 用 


pg_last_xlog_receive_location 可 以 分 别 检索 到 它们 (参阅 Table 9-6040 Table 9-61 关 于 详细 
aM) 。 在 备 服务 器 收 到 最 后 的 WAL 位 置 也 会 进程 状态 的 WAL 接 收 进程 显示 ， 使 用 ps 命令 
显示 (参阅 Section 27.1 关 于 详细 信息 ) 。 


你 可 以 通过 pg stat_replication 视图 回收 WAL 发 送 程序 列表 。 

在 pg_current_xlog_location 和 sent_location 字段 之 间 的 不 同 可 能 表明 主 服务 器 在 大 负 载 
F, 而 各 库 上 sent_location 和 pg_last_xlog_receive_location 的 不 同 可 能 表明 网 络 延 迟 ， 
或 者 备 库 也 处 于 重大 负载 之 下 。 


25.2.6. Cascading Replication 
级 联 复制 功能 允许 各 用 服务 器 接受 复制 连接 和 到 其 他 备 库 的 流 WAL 记 录 ， 充 当 延 迟 。 这 可 以 
用 来 降低 直接 连接 主 库 的 数量 ， 同 时 也 尽量 减少 站 点 间 的 带宽 开销 。 


同时 充当 接收 器 和 发 送 器 的 待机 称 为 级 联 待机 状态 。 更 直接 地 连接 到 主 库 的 备 库 作为 上 游 服 
务 器 已 知 ， 而 备用 服务 器 较 远 的 下 游 服 务 器 。 级 联 复制 不 放 在 数量 限制 或 下 游 服 务 器 的 安 
排 ， 虽 然 每 个 备 库 连 接 到 一 个 上 流 服务 器 ， 而 最 终 链 接 到 一 个 单一 的 主 / 主 服务 器 。 


级 联 备 库 不 仅仅 发 送 来 自主 库 的 WAL 记 录 ， 而 且 来 自 汉 档 的 记录 。 因此 即使 一 些 上 流连 接 的 
复制 连接 终止 ， 连接 复制 继续 往 下 只 要 有 新 的 WAL 记 录 可 用 。 


级 联 复制 当前 是 异步 的 ， 同 步 复制 (参阅 Section 25.2.7) 设置 当前 不 影响 级 联 复制 。 
热 各 用 反馈 传播 到 上 游 ， 无 论 级 联 配 置 。 
如 果 上 游 各 用 服务 器 上 升 成 为 新 主 库 ， 下 游 服 务 器 将 继续 流向 新 主 库 ， 如 


果 recovery_target_timeline 设置 为 "latest' o 


使 用 级 联 复制 ， 建 立 连锁 各 库 从 而 接受 复制 连接 〈 即 设置 max_wal _senders 和 hot_ standby， 
以 及 配置 host-based authentication) 。 在 下 游 备 库 指向 级 联 各 库 中 你 还 需要 设 


mo a š 
XE primary_conninfo o 


25.2.7. 同步 复制 


PostgreSQL 流 复制 缺 省 是 异步 的 。 如 果 主 服务 器 骨 溃 ， 然 后 一 些 事务 承诺 不 得 不 复制 到 各 用 
服务 器 ， 造 成 数据 丢失 。 数 据 丢失 量 是 与 故障 转移 时 的 复制 延迟 是 成 比例 的 。 

同步 复制 提供 确认 所 有 变化 已 经 由 事务 转移 到 一 个 同步 备用 服务 器 的 能 力 。 这 延伸 一 个 事务 
提交 的 耐久 性 标准 。 这 种 级 别 的 保护 是 指 2- 安 全 复制 的 计算 机 科学 理论 。 


当 请 求 同 步 复制 ， 每 次 提交 的 写 事 务 将 等 待 直到 确认 收 到 提交 已 被 写 人 到 主 库 和 各 用 服务 器 
磁盘 上 的 事务 日 志 。 这 些 数据 去 失 的 可 能 性 是 如 果 主 库 和 各 库 同一 时 间 遭 受 崩溃 。 这 可 以 提 
供 一 个 更 高 层次 的 耐久 性 ， 但 如 果 系统 管理 员 对 两 个 服务 器 的 安置 和 管理 非常 说 愤 。 等 待 确 


认 增 加 用 户 的 信心 ， 在 服务 器 崩溃 的 情况 下 更 改 将 不 会 丢失 ， 而 是 增加 请 求 事务 的 响应 时 
Ho 最 小 等 待 时 间 是 主 库 到 备 库 的 往返 时 间 。 


只 读 事 务 和 事务 回 滚 不 需要 等 待 从 备用 服务 器 的 回复 。 子 事务 提交 不 等 待 从 备用 服务 器 的 响 
应 ， 只 有 项 级 提交 。 长 时 间 运 行动 作 如 加 载 数据 或 索引 建立 不 等 待 直到 最 后 提交 信息 。 所 有 
的 两 阶段 提交 的 行动 需要 提交 等 待 ， 包 括 准 备 和 提交 。 


25.2.7.1. 基础 配置 


一 旦 流 复制 已 配置 ， 配 置 同步 复制 仅 需要 一 个 额外 的 配置 步骤 : 
synchronous_standby_names 必 须 设置 为 一 个 非 空 值 。 synchronous_commit 也 必须 设置 

为 on ， 但 因为 这 是 默认 值 ， 通 常 是 没有 改变 的 。 (参见 Section 18.5.1 和 Section 
18.6.2) 。 这 种 配置 将 导致 每 次 提交 会 等 待 确认 备 库 书 面 提交 记录 到 持久 存储 。 
synchronous_commit 可 以 由 个 人 用 户 设置 ， 所 以 它 可 以 被 配置 在 配置 文件 中 ， 特 别 是 用 户 或 
数据 库 中 ， 或 动态 的 应 用 程序 中 ， 以 保证 每 个 事务 的 基础 上 控制 耐久 性 。 


一 个 提交 记录 已 被 写 入 到 主 库 磁 瘟 上 ，WAL 记 录 随 后 被 发 送 到 待机 状态 。 每 次 一 批 新 的 WAL 
数据 被 于 入 磁盘 时 待机 发 送 答复 消息 ， 除非 wal_receiver_status_interval 在 待机 状态 设置 为 
Z, 如 果 待 机 是 第 一 个 匹配 的 待机 ， 在 主 库 上 指定 synchronous_standby_names ， 从 待机 状 

态 得 到 的 答复 信息 将 被 用 于 唤醒 用 户 的 提交 记录 已 被 接收 的 等 待 确认 。 这 些 参数 允许 管理 员 

指定 哪些 各 用 服务 器 应 同步 各 用 。 注意 ， 同 步 的 配置 复制 主要 针对 主 服务 器 。 命名 的 备用 服 
务 器 必须 直接 连接 到 主 库 上 ; 主 库 并 不 了 解 下 游 待 机 使 用 级 联 复 制 的 服务 器 。 


设置 synchronous_commit 到 remote_write 将 导致 每 个 提交 等 待 确认 各 库 已 经 收 到 提交 记录 并 
且 写 入 到 自己 的 操作 系统 ， 但 不 是 为 了 该 数据 被 刷新 到 磁盘 上 的 备份 。 这 个 设置 提供 了 耐用 
性 较 弱 保证 对 比 on : 在 待机 状态 下 可 能 会 失去 操作 系统 崩溃 时 的 数据 ， 虽然 不 是 
PostgreSQL 骨 溃 。 然而 ， 这 是 在 实践 中 有 用 的 设置 ， 因 为 它 可 以 减少 事务 响应 时 间 。 如 果 
主 库 和 备 库 崩 溃 ， 并 且 主 库 的 数据 库 同 时 被 破坏 了 ， 只 能 发 生 数 据 丢失 。 


如 果 要 求 快速 关机 ， 用 户 将 停止 等 待 。 然 而 ， 作 为 使 用 异步 复制 的 时 候 ， 服 务 器 将 不 完全 RK 
闭 直 到 所 有 WAL 记 录 转 移 到 目前 连接 的 各 用 服务 器 。 
25.2.7.2. 规划 性 能 


同步 复制 通常 需要 仔细 规划 并 且 放 置 备 用 服务 器 ， 确 保 应 用 程序 执行 性 能 。 等 待 没有 充分 利 
用 系统 资源 ， 但 事务 锁 继 续 直 到 确认 转移 。 作 为 一 个 结果 ， 不 小 心 的 使 用 同步 复制 会 降低 数 
据 库 应 用 性 能 ， 由 于 响应 时 间 的 增加 和 更 高 的 竞争 。 


PostgreSQL 人 允许 应 用 程序 开发 人 员 通 过 复制 来 指定 所 需 的 耐久 性 水 平 。 这 可 以 对 系统 的 总 体 
说 明 ， 虽 然 它 也 可 以 被 指定 为 特定 用 户 或 连接 ， 甚 至 个 别 交 易 。 

例如 ， 一 个 应 用 程序 的 任务 可 能 包括 : 10% 的 变化 是 重要 的 客户 资料 ， 而 90% 的 变化 是 不 太 
重要 的 数据 ， 如 果 它 丢失 ， 企 业 还 可 以 更 好 生存 ， 上 比如 用 户 之 间 的 聊天 信息 。 


在 应 用 水 平 (ER) 指定 同步 复制 选项 ， 我 们 可 以 为 大 多 数 重要 的 变化 提供 同步 复制 RA 
放 缓 总 工作 量 体 积 。 对 于 允许 同步 复制 的 高 性 能 应 用 的 效益 来 说 ， 应 用 程序 级 别 的 选项 是 一 
个 重要 而 实用 的 工具 。 


你 应 该 考虑 到 网 络 带 宽 必 须 大 于 WAL 数 据 生成 率 。 


25.2.7.3. 高 可 用 性 规划 


当 synchronous_commit 设置 为 on 或 者 remote write 将 等 待 直 到 同步 各 用 响应 ， 则 进行 提 
Zo 如 果 最 后 ， 或 只 发 生 待机 骨 溃 ， 则 响应 不 会 发 生 。 


为 避免 数据 丢失 最 好 的 办 法 是 确保 你 不 会 失去 你 最 后 的 同步 备份 。 这 可 以 通过 使 
用 synchronous_standby_names 命名 多 个 潜在 的 同步 各 用 实现 。 第 一 个 命名 的 各 库 将 作为 同步 
备 库 使 用 。 如 果 第 一 个 失败 ， 则 各 用 列表 将 接管 同步 各 用 角色 。 


当 一 个 备 库 首先 依附 在 主 库 时 ， 不 能 正确 地 同步 。 这 是 catchup 方式 所 描述 的 。 一 旦 备 库 和 
主 库 之 间 的 滞后 达到 需 ， 第 一 次 我 们 将 实时 状态 流 。 备 库 被 创建 后 ， 持 续 追 赶 时 间 可 能 长 。 
如 果 备 库 关 闭 ， 然后 追赶 时 期 将 随 着 待机 时 间 长 度 而 增加 。 一 且 已 经 达到 流 状态 ， 备 库 是 
唯一 能 够 成 为 同步 备用 。 


如 果 主 库 馈 动 而 提交 等 竺 确认， 这 些 等 待 事务 将 被 标记 为 完全 提交 ， 一 旦 主 数 据 库 恢 复 。 没 
有 办 法 确保 在 主 库 崩 溃 的 时 候 所 有 备 库 收 到 所 有 优秀 的 WAL 数 据 。 一 些 事务 可 能 不 会 在 待机 
时 显示 提交 ， 即 使 他 们 表现 为 主 库 已 提交 。 我 们 提供 的 保障 是 应 用 程序 将 不 会 接收 事务 成 功 
提交 的 明确 承认 ， 直到 被 各 库 安 全 接收 WAL 数 据 是 已 知 的 。 


如 果 你 真 的 失去 了 你 最 后 的 各 用 服务 器 ， 你 应 该 禁用 synchronous_standby_names 并 且 在 主 服 
务 器 重新 加 载 配置 文件 。 


如 果 主 库 是 从 剩余 各 用 服务 器 分 离 的 ， 你 应 该 故障 转移 到 那些 其 他 剩余 各 用 服务 器 的 最 佳人 
选 


如 果 你 需要 重新 创建 各 用 服务 器 ， 当 等 待 事务 时 ， 确 保 pg_start_backup() 和 
pg_stop_backup() 在 带 有 synchronous_commit = off 的 回话 中 运行 ， 否则 这 些 请 求 将 永远 等 
待 备 库 出 现 。 


25.3. 失效 切换 


如 果 主 服务 器 失败 ， 则 备 服务 器 应 该 开始 失效 切换 处 理 。 


如 果 备 服务 器 失败 ， 则 没有 失效 切换 需要 考虑 。 如 果 可 以 重启 备用 服务 器 ， 其 至 一 段 时 间 
后 ， 也 可 以 立即 重启 恢复 进程 ， 发 挥 重 启 恢复 的 优势 。 如 果 不 能 重启 备 服务 器 ， 则 应 该 创建 
一 个 全 新 的 备 服务 器 实例 。 


如 果 主 服务 器 失败 ， 并 且 各 服务 器 成 为 新 主 服务 器 ， 然 后 旧 主 服务 器 重启 ， 你 必须 有 一 个 通 
知 旧 主 服务 器 ， 其 不 再 是 主 服务 器 的 机 制 。 这 有 时 被 称 为 STONITH (在 头 去 掉 其 它 节 点 ) ， 
这 是 必要 的 ， 以 避免 系统 都 认为 它们 是 主 服务 器 的 情况 下 ， 这 将 导致 混乱 和 最 终 数据 丢失 。 


许多 失效 切换 系统 只 使 用 两 个 系统 ， 主 各 服务 器 ， 通 过 某 种 心跳 机 制 ， 不 断 验证 两 者 连接 和 
主 服务 器 的 活力 。 也 可 以 使 用 一 个 第 三 方 的 系统 ( 称 为 “证 人 服务 器 ”) ， 以 防止 某 些 情况 下 
不 适当 的 失效 切换 ， 但 额外 的 复杂 性 可 能 是 不 值得 的 ， 除 非 设 置 它 为 充分 仔细 和 严格 的 测 
试 。 


PostgreSQL 不 提供 所 需 的 用 来 确定 主 服务 器 失败 ， 并 通知 各 用 数据 库 服务 器 的 系统 软件 。 
存在 许多 这 样 的 工具 和 成 功 失效 切换 所 需 的 集成 操作 条 统 的 工具 ， 如 IP 地 址 迁移 。 


一 旦 发 生 失 效 切换 到 备 服务 器 ， 仅 有 一 台 服 务 器 运行 。 这 就 是 所 谓 的 退化 状态 。 前 者 备 服 务 
器 现在 是 主 服 务 器 ， 但 前 者 主 服务 器 是 可 能 会 停留 下 来 。 要 返回 正常 运行 ， 必 须 重 建 一 个 备 
服务 器 ， 无 论 是 在 以 前 的 服务 器 ， 或 在 第 三 ， 可 能 是 新 的 系统 。 一 旦 完成 主 各 服务 器 ， 可 以 
考虑 转换 角色 。 有 些 人 选择 使 用 第 三 方 服 务 器 ， 提 供 新 主 服 务 器 的 备份 直到 新 备 服 务 器 重 
建 ， 尽管 清楚 这 个 复杂 的 系统 配置 和 操作 流程 。 


所 以 从 主 到 备 服 务 器 可 以 快速 切换 ， 但 需要 一 些 时 间 重 新 准备 失败 切换 集群 。 定期 主 各 服务 
器 切换 是 有 用 的 ,因为 它 允 许 定期 停机 进行 每 个 系统 的 维修 。 这 也 是 作为 一 个 测试 ， 以 确保 故 
失效 切换 机 制 ， 当 你 需要 时 会 真 的 工作 。 建议 写 管 理 操作 流程 。 


要 触发 日 志 传 送 各 服务 器 的 失效 切换 ， 运 行 pg_ctl promote 或 者 创建 一 个 触发 文件 , 这 个 文件 
是 通过 在 recovery.conf 文件 中 trigger_file 设置 指定 的 文件 名 和 路 径 。 如 果 你 计划 使 

用 pg_ctl promote 进行 失效 切换 ， 则 不 需要 trigger_file 。 如 果 你 设置 报告 服务 器 仅仅 用 于 
卸载 主 服务 器 的 只 读 查 询 ， 而 不 是 针对 高 可 用 性 的 目的 ， 那 么 你 不 需要 推动 它 。 


25.4. 日 志 传 送 的 蔡 代 方法 


一 种 替代 在 前 节 描 述 的 内 建 各 用 模式 的 方法 是 使 用 restore_command 轮 询 轨 档 位 置 。 这 是 只 能 
在 8.4 及 以 下 版 本 选择 使 用 。 在 此 设置 standby_mode KM, 因为 你 要 实现 各 服务 器 运行 你 自 
己 所 需 的 轮 询 。 请 参考 pg_standby 模 块 关 于 这 类 的 实现 。 


请 注意 在 这 种 模式 ， 服 务 器 将 一 次 应 用 一 个 WAL 文 件 ， 所 以 如 果 你 使 用 各 服务 器 对 于 查询 

( 见 热 备 ) ， 在 主 服务 器 中 的 动作 和 当 这 个 动作 在 备 服务 器 中 可 见 之 间 有 个 延迟 ， 相应 的 时 
间 用 在 填写 WAL 文 件 。 archive_timeout 可 以 使 延迟 较 短 。 还 要 注意 你 不 能 用 这 种 方法 结合 
流 复制 。 


主 备用 服务 器 上 发 生 的 操作 是 正常 的 连续 为 档 和 恢复 任务 。 两 个 数据 库 服务 器 相 联 系 的 一 点 
是 两 者 共享 的 WAL 为 档 文件 : 主 写 入 为 档 ， 备 从 为 档 污 取 。 必 须 小 心 ， 以 确保 从 单独 的 主 服 
务 器 ， 不 会 混在 一 起 或 混淆 WAL 为 档 。 如 果 只 是 备 服务 器 操作 要 求 ， 为 档 需 要 并 不 大 。 


使 松散 耦合 的 两 个 服务 器 一 起 工作 简 直 是 奇迹 ， 在 各 服务 器 上 简 单 使 用 restore_command ， 当 
询问 下 一 个 WAL 文 件 ， Se ii 在 备 服务 器 的 recovery.conf 文件 指 

定 restore_command o 常 恢复 进程 怪 从 一 个 WAL 轨 档 中 请 求 文件 ， 如 果 该 文件 不 可 用 ， 则 

报告 失败 。 aor peo 个 WAL 文 件 不 可 用 是 正常 的 ， 因 此 各 服务 器 进程 需要 等 
待 它 出 现 。 对 于 在 .backup 或 者 .history 文件 结束 不 需要 等 待 ， 并 且 返 回 一 个 非 需 值 。 等 

待 restore_command 可 以 写 为 一 个 自 定 义 脚 本 ， 即 循环 轮 询 下 一 个 WAL 文 件 的 存在 。 还 必须 

有 一 些 方法 来 触发 失效 切换 ， 应 该 中 断 的 restore command ， 跳 出 循环 ， 并 返回 各 用 服务 器 

一 个 文件 未 找到 错误 。 这 两 端的 恢复 和 各 用 服务 器 ， 然后 将 作为 一 个 正常 的 服务 器 。 


一 个 合适 restore_command 的 伪 码 是 : 


triggered = false; 
while (!NextWALFileReady() && ! triggered) 


sleep(100000L); /* wait for ~0.1 sec */ 
if (CheckForExternalTrigger()) 
triggered = true; 


} 
if (!triggered) 
CopyWALFileForRecovery(); 


在 pg_standby 模 块 中 提供 一 个 等 待 restore_command 的 实际 例子 。 应 该 用 来 作为 参考 如 何 正 
确 地 贯彻 执行 上 述 逮 辑 。 它 也 可 以 扩展 需要 ， 以 支持 特定 的 配置 和 环境 。 


触发 失效 切换 的 方法 是 规划 和 设计 的 一 个 重要 组 成 部 分 。 一 个 潜在 的 选项 

是 restore_command 命令 。 每 个 WAL 文 件 执行 一 次 ， 但 是 运行 restore_command 的 进程 对 于 每 
个 文件 创建 和 消亡 的 ， 所 以 没有 守护 进程 或 服务 器 进程 和 信号 或 不 能 使 用 的 信号 处 理 。 
此 ， restore_command 不 适合 触发 失效 切换 。 使 用 简单 超时 机 制 可 能 的 ， 尤其 如 果 和 与 已 知 


的 archive_timeout 在 主 服务 器 上 配合 设置 使 用 。 尽管 ， 这 比较 容易 出 错 ， 因为 网 络 问题 或 繁 
忙 的 主 服务 器 可 能 有 足够 的 启动 失效 切换 。 如 果 可 以 安排 ， 通 报 机 制 如 显 式 创建 一 个 触发 器 
文件 是 理想 的 。 


25.4.1. 实施 


配置 备用 服务 器 ， 使 用 这 种 替代 方法 简短 步骤 如 下 。 对 于 每 一 步 的 细节 ， 请 参阅 前 面 的 章 
节 。 


1. 建立 主 各 系统 尽 可 能 接近 相同 ， 包 括 两 个 PostgreSQL 副 本 在 相同 版 本 级 别 。 


2. 设置 从 主 服务 器 上 连续 当 档 到 各 服务 器 WAL 兴 档 目 录 。 确保 在 主 服务 器 上 相应 的 设 


置 archive_mode, archive_commandfflarchive_timeout, (参阅 Section 24.3.1)。 
3. 做 一 个 主 服务 器 的 基准 备份 (参阅 Section 24.3.2), 在 各 服务 器 上 加 载 这 个 数据 。 


4. 在 各 服务 器 上 从 一 个 本 地 的 WAL 为 档 开 始 恢复 ， 如 前 所 述 等 待 使 用 recovery.conf 所 指 
定 的 restore_command. (请 参阅 Section 24.3.4) o 


恢复 对 WAL 为 档 做 只 读 处 理 ， 所 以 一 旦 在 WAL 的 文件 已 被 复制 到 备用 系统 ， 就 可 以 在 同一 时 
间 复 制 到 磁带 ， 因 为 正 通过 各 用 数据 库 服务 器 读 取 。 因此 ， 运 行 高 可 用 性 的 备用 服务 器 可 以 
同时 作为 文件 存储 长 远 的 灾难 恢复 目的 做 处 理 。 


出 于 测试 目的 ， 它 是 可 以 在 同一 系统 上 运行 的 主 各 服务 器 。 没 提供 任何 值得 改进 服务 器 的 健 
壮 性 ， 也 不 会 描述 为 HA。 


25.4.2. 基于 记录 的 日 志 传 送 


使 用 这 种 替代 方法 也 有 可 能 实现 基于 记录 的 日 志 传送 ， 尽管 这 需要 定制 开发 ， 一 个 完整 的 
WAL 文 件 传送 之 后 变化 只 为 热 备查 询 可 见 。 


一 个 外 部 程序 可 以 调用 pg_xlogfile_name_offset() (参阅 Section 9.26) 这 个 函数 用 来 找 出 

文件 名 和 当前 WAL 结 尾 的 准 确 字 节 偏 移 。 然 后 ， 可 以 直接 访问 WAL 文 件 ， 并 从 WAL 的 上 次 

已 知 的 结尾 到 当前 结束 数据 复制 数据 到 备用 服务 器 。 用 这 种 方法 ， 数据 丢失 窗口 是 复制 程序 
的 轮 询 周期 时 间 ， 其 可 以 非常 小 ， 并 没有 迫使 部 分 使 用 的 段 文件 要 为 档 的 带宽 浪费 。 请 注意 
各 服务 器 上 的 restore_command 脚本 只 能 处 理 完整 的 WAL 文 件 ， 所 以 通常 的 增 量 各 份 数 据 到 

各 服务 器 不 可 用 。 只 有 在 主 服务 器 死 掉 一 在 允许 它 到 来 前 ， 最 后 一 部 分 WAL 文 件 送 到 各 服务 
器 。 在 这 个 进程 中 的 正确 实现 ， 需要 restore_command 脚本 与 数据 复制 程序 协作 。 


PostgreSQL9.0 版 本 开始 ， 你 可 以 使 用 流 复制 达到 事半功倍 的 效果 (请 人 参阅 Section 
25.2.5) 。 


25.5. 热 各 


热 备 术 语 是 用 来 形容 连接 到 服务 器 ， 并 运行 只 读 查 询 的 能 力 ， 而 服务 器 在 轨 档 恢复 或 备 模 
式 。 对 复制 目的 和 非常 精确 的 各 份 恢复 到 所 需 的 状态 ， 这 是 非常 有 用 的 。 长 期 的 热 备 ， 也 指 
从 恢复 到 正常 运行 的 服务 器 的 能 力 ， 而 用 户 继续 运行 的 查询 和 /或 保持 连接 开放 。 


在 热 备用 模式 运行 查询 与 正常 的 查询 操作 类 似 ， 哩 然 有 几 个 使 用 和 管理 的 差异 解释 如 下 。 


25.5.1. 用 户 概述 
当 各 用 服务 器 上 hot _ standby 参 数 的 设置 为 真 时 ， 将 开始 接受 连接 ， 一 旦 恢复 带 来 的 系统 到 一 
致 的 状态 。 所 有 这 些 连接 都 严格 只 读 的 ， 其 至 可 能 没有 可 写 的 临时 表 。 


数据 从 主 服务 器 到 各 服务 器 上 需要 一 些 时 间 ， 所 以 会 有 一 个 主 各 数据 库 间 的 可 测量 的 延迟 。 
因此 ， 在 主 各 服务 器 上 几乎 同时 运行 同样 的 查询 返回 不 同 的 结果 。 我 们 说 在 各 服务 器 上 的 数 
据 最 终 与 主 服务 器 上 的 一 致 。 一 旦 事务 提交 记录 在 各 服务 器 是 上 回放 ， 由 事务 产生 的 变化 对 
于 在 各 服务 器 上 的 任何 新 快照 来 说 是 可 见 的。 快照 可 能 是 在 每 个 查询 或 事务 的 开始 ， 取 决 于 
当前 事务 的 隔离 级 别 。 请 参阅 Section 13.2 获 取 更 多 的 信息 。 


热 备 期 间 开 始 的 事务 可 能 会 发 出 下 面 的 命令 : 
e 查询 访问 - SELECT, COPY TO 
o JEER- DECLARE , FETCH, CLOSE 
e 参数 - SHOW, SET, RESET 
。 事务 管理 命 兮 
© BEGIN, END, ABORT, START TRANSACTION 
© SAVEPOINT , RELEASE , ROLLBACK TO SAVEPOINT 
o EXCEPTION 阻塞 其 它 内 部 的 子 事物 。 
e Lock TABLE 仅 当 明确 这 些 模式 之 一 : ACCESS SHARE ， ROW SHARE 或 者 ROW EXCLUSIVE o 
e 规划 和 资源 - PREPARE , EXECUTE , DEALLOCATE , DISCARD 
e 插件 和 扩展 - Loan 


在 热 各 期 间 开 始 的 事务 ， 将 从 不 会 分 配 事务 ID， 并 且 不 能 写 入 到 系统 预 写 日 志 。 因此 ， 以 下 
操作 将 产生 错误 信息 : 


数据 操纵 语言 (DIML) - INSERT, UPDATE , DELETE , COPY FROM, TRUNCATE o 请 注意 ， 不 
允许 操作 在 恢复 期 间 正 执行 触发 器 的 结果 。 此 限制 也 适用 于 临时 表 ， 因 为 不 分 配 一 个 事 
务 ID， 不 能 读 取 或 字 入 表 行 ， 在 一 个 热 各 环境 这 种 情况 是 不 可 能 的 。 


o 数据 定义 语 


(DDL) - CREATE , DROP ，ALTER ，COMMENT > 其 至 临时 表 也 适用 这 个 限制 ， 
因为 执行 这 些 操 


人 作 将 需要 更 新 系统 空间 表 。 
e SELECT ... FOR SHARE | UPDATE 因为 行 锁 ， 不 能 不 采取 更 新 底层 数据 文件 。 


在 secect 语句 上 的 规则 产生 DML 命 兮 。 


Lock 明确 要 求 一 个 高 于 Row EXCLUSIVE MODE 的 模式 。 


Lock 简短 的 缺 省 形式 ， 因 为 它 请 求 ACCESS EXCLUSIVE MODE . 
。 事务 管理 命令 明确 设置 非 只 读 状 态 : 
© BEGIN READ WRITE ， START TRANSACTION READ WRITE 


O SET TRANSACTION READ WRITE 
SET SESSION CHARACTERISTICS AS TRANSACTION READ WRITE 


Oo SET transaction_read_only = off 


© 两 阶段 提交 命令 - PREPARE TRANSACTION , COMMIT PREPARED , ROLLBACK PREPARED 因为 即使 


只 读 事务 需要 在 准备 阶段 写 WAL。 《两 种 阶段 提交 的 第 一 个 阶段 ) 。 
° 序列 更 新 - nextval() , setval() 
@ LISTEN , UNLISTEN , NOTIFY 


在 正常 的 操作 ， 人 允许 "只 读 " 事 务 更 新 序列 ， 使 用 cisten ，UNLISTEN 和 NoTIFY ， 所 以 热 各 会 
话 下 操作 会 比 通常 的 只 读 会 话 限制 稍微 更 严格 。 在 将 来 的 版 本 中 这 些 限制 中 的 一 些 可 能 会 放 
宽 。 


热 备 间 ， transaction_read_only 这 个 参数 总 为 真 ， 可 能 不 会 变 。 但 只 要 没有 试图 修改 数据 
库 ， 在 热 各 的 连接 ， 将 行动 就 像 任 何其 它 的 数据 库 连 接 。 如 果 发 生 失 效 切 换 或 倒 换 ,数据 库 将 
切换 到 正常 的 处 理 模 式 。 当 服 务 器 改变 模式 ， 会 话 将 保持 连接 。 一 旦 热 备 完成 ， 有 可 能 初始 
化 读 写 事务 (即使 从 热 备 间 的 会 话 ) 。 


通过 发 出 的 show transaction_read_only 将 告诉 用 户 他 们 的 会 话 是 否 只 读 的 。 另外 ， 一 组 函数 
允许 用 户 访问 关于 备 服务 器 的 信息 (请 参阅 Table 9-61) 这 些 允 许 你 写 程序 获知 数据 库 的 当 
前 状态 。 这 些 可 以 用 来 监视 恢复 进程 ， 或 允许 你 写 复 条 的 程序 来 恢复 数据 库 到 特定 状态 。 


25.5.2. 处 理 查 询 冲突 


主 各 服务 器 是 许多 方式 松散 连接 的 。 在 主 服务 器 上 的 活动 将 在 备 服务 器 上 生效 。 作为 一 个 结 
果 ， 它 们 之 间 有 潜在 的 负面 交互 或 冲突 .最 容易 理解 的 冲突 是 性 能 : 如 果 在 主 服务 器 上 发 生 大 
数据 量 加 载 ， 然 后 将 在 各 服务 器 上 产生 类 似 的 WAL 记 录 流 ， 所 以 各 服务 器 查询 可 能 竞争 系统 
XR, (RIO. 


在 热 各 也 可 能 发 生 额 外 的 类 型 冲突 。 在 该 场景 下 ， 这 些 冲 突 是 硬 冲 突 。 可 能 需要 取消 查询 ， 
在 某 些 情 况 下 ， 为 了 解决 它们 ， 断 开 连 接 。 给 用 户 提供 几 种 解决 这 些 冲 突 的 方法 。 冲 突 情况 
包括 : 


。 在 主 服 务 器 上 采取 访问 排斥 锁 ， 包 括 明确 的 Lock 命令 和 多 种 DDL 操 作 ， 在 备 服务 器 查询 
访问 表 冲 突 。 


。 在 主 服务 器 上 删除 表 空 间 与 备 服务 器 查询 使 用 该 空间 的 临时 工作 文件 冲突 。 
。 在 主 服 务 器 上 删除 一 个 数据 库 与 在 各 服务 器 上 连接 到 那个 数据 库 的 会 话 冲突 。 


。 一 个 从 WAL 清 空 记录 的 应 用 程序 vacuum 与 在 各 服务 器 上 事务 ， 其 快照 仍然 可 以 "看 到 "已 
删除 的 行 。 


e 一 个 从 WAL 清 空 记录 的 应 用 程序 vacuum 与 在 各 服务 器 上 查询 访问 该 目标 页 ， 不 管 要 删除 
的 数据 是 否 可 见 。 


在 主 服 务 器 上 ， 这 些 情况 简单 等 待 结 果 ， 用 户 可 能 选择 取消 任何 冲突 的 操作 。 尽管 ， 在 备 服 
务 器 上 没有 选择 : 在 主 服务 器 上 已 经 发 生 的 WAL 日 志 ， 所 以 备 服务 器 应 用 它 一 定 不 会 失败 。 
此 外 ， 人 允许 WAL 应 用 无 限期 等 待 可 能 是 很 不 明智 的 。 因为 备 服务 器 的 状态 将 变 为 增 量 远 落 后 
主 服 务 器 的 。 因 此 ， 提 供 一 个 机 制 ， 强行 取消 备 服务 器 上 与 将 要 应 用 WAL 记 录 冲 突 的 查询 。 


一 个 该 问题 情况 的 例子 是 管理 员 在 主 服 务 器 上 运行 DROP TABLE 一 张 表 ， 而 各 服务 器 当前 正 查 
询 这 张 表 。 如 果 在 各 服务 器 上 执行 了 prop TABLE ， 明 确 的 各 服务 器 查询 不 能 继续 。 如 果 这 
个 问题 情况 发 生 在 主 服务 器 。 则 pro TABLE 将 等 到 其 它 查 询 完 成 。 但 是 当 DROP TABLE 运行 
在 主 服务 器 时 ， 主 服务 器 不 会 有 关于 各 服务 器 查询 的 信息 ， 因此 ， 将 不 等 待 任何 各 服务 器 查 
询 。 当 各 服务 器 查询 在 运行 时 ，WAL 改 变 的 记录 来 到 备 服 务 器 ， 导致 一 个 冲突 。 各 服务 器 要 
么 延迟 应 用 WAL 记 录 (任何 事情 也 都 要 在 它们 之 后 ) ， 不 然 取消 冲突 的 查询 ， 由 此 可 以 应 


用 DROP TABLE 。 


当 一 个 冲突 查询 短 的 ， 通 常 想 要 人 允许 它 完 成 而 延迟 WAL 应 用 程序 一 点 点 。 但 是 长 时 间 的 延迟 
WAL 应 用 程序 通常 不 是 想 要 的 。 所 以 取消 机 制 有 参数 max_standby_archive_delay 和 
max_standby_streaming_delay， 这 定义 在 WAL 应 用 程序 中 允许 延迟 最 大 值 。 一 旦 查询 冲突 
比 应 用 任何 新 收取 的 WAL 数 据 设 定 有 关 延 迟 长 ， 则 取消 查询 冲突 。 有 两 个 参数 ， 因 此 有 两 个 
不 同 延迟 ， 为 从 如 档 读 取 WAL 数 据 〈 即 从 一 个 基准 备份 初始 化 恢复 或 " 赶 上 "已 经 远 落 后 的 备 
服务 器 ) 和 通过 流 复制 读 取 WAL 数 据 的 指定 延迟 。 


在 备 服务 器 存在 高 可 用 性 的 主 服务 器 ， 最 好 设置 延迟 参数 相对 短 ， 因此 不 会 由 备 服务 器 查询 
所 导致 延迟 使 远 落 后 主 服务 器 。 不 过 ， 如 果 备 服务 器 意思 为 执行 长 时 间 的 查询 ， 那 么 一 个 高 
的 或 无 期 限 的 延迟 值 是 可 取 的 。 请 记 着 如 果 延 迟 WAL 记 录 应 用 程序 ， 则 长 时 间 查 询 将 导致 备 


服务 器 上 的 其 它 会 话 不 能 看 到 最 新 的 变化 。 


一 旦 超过 了 由 max_standby_archive_delay 或 者 max_standby_streaming_delay 指定 的 延迟 ， 将 
取消 查询 冲突 。 这 通常 结果 是 一 个 取消 错误 ， 虽 然 在 回放 prop DATABASE 整个 数据 库 的 情况 
T, 将 终 止 冲突 会 话 。 此 外 ， 如 果 冲 突 由 空 六 事务 保持 ， 终 止 冲 突 会 话 。 (这 个 行为 可 能 在 
将 来 版 本 改变 ) 。 


可 能 立即 重 试 已 取消 的 查询 (在 开始 一 个 新 事务 之 后 ， 当 然 ) 。 自 查 询 取 消 依赖 于 WAL 记 录 
重播 的 本 质 ， 如 果 再 次 执行 ， 已 经 取消 的 查询 可 能 很 成 功 。 


请 记 住 这 些 参数 与 从 各 服务 器 接收 WAL 数 据 开始 所 经 过 的 时 间 比 较 。 人 允许 备 服务 器 上 任何 查 
询 的 宽 期 限 ， 从 不 超过 该 延迟 参数 ， 并 且 如 果 各 服务 器 存在 落后 主 服务 器 ， 那 么 期 限 的 可 能 
相当 小 。 如 等 待 之 前 查询 执行 完成 的 结果 ， 或 不 能 跟 上 有 大 量 的 更 新 负载 的 结果 。 


各 用 的 查询 和 WAL 重 放 之 间 的 冲突 最 常见 的 原因 是 "过 早 清除 "。 通常 ，PostgreSQL 人 允许 清理 
老 行 版 本 ， 当 没有 事务 需要 根据 MVCC 的 规则 看 到 他 们 保证 数据 的 正确 性 。 然而 ， 这 条 规则 
只 适用 于 在 主 库 上 事务 执行 情况 。 所 以 在 主 库 上 清理 删除 主 库 上 事务 仍然 可 见 的 行 版 本 ， 这 
是 可 能 的 。 


有 经 验 的 用 户 应 注意 行 版 本 的 清理 和 行 版 本 冷冻 将 与 各 用 查询 冲突 。 手 动 运行 
VACUUM FREEZE 可 能 引起 甚至 没有 更 新 或 删除 行 的 表 上 的 冲突 。 


用 户 应 该 清楚 那些 表 ， 在 主 服务 器 上 定期 和 大 量 更 新 表 将 会 很 快 导 致 取 消 备 服务 器 上 长 时 间 
运行 的 查询 。 在 这 类 情况 下 ， 对 max_standby_archive delay 或 者 
max_standby_streaming_delay 设置 一 个 有 限 值 , 类 似 于 设置 statement_timeout 。 


如 果 发 现 不 能 接受 某 些 取消 各 服务 器 查询 ， 补 救 存 在 的 可 能 性 。 第 一 个 选项 是 设置 参 

数 hot_standby feedback ， 阻止 vacuum 删除 最 近 的 死 行 ， 所 以 清理 冲突 不 会 发 生 。 如 果 你 

这 样 做 ， 你 应 该 知道 这 将 延迟 主 服务 器 清理 死 行 ， 其 可 能 不 想 要 的 表 膨 胀 结果 。 不 过 这 种 情 
况 清理 不 逊 于 如 果 各 服务 器 查询 直接 运行 在 主 服务 器 上 ， HAMAS R EM RATE SIRS 
器 上 的 好 处 。 在 这 种 情况 下 max_standby_archive_delay 必须 是 保持 大 的 ， 因为 延迟 WAL 文 件 
可 能 已 经 包含 了 备 服务 器 查询 想 要 的 记录 项 。 

另 一 个 选项 是 在 主 服 务 器 上 增加 vacuum_defer_cleanup_age， 从 而 将 不 会 像 通常 很 快 的 清理 
掉 死 行 。 这 将 允许 在 备 服务 器 上 取消 它们 前 ， 更 多 时 间 给 执行 查询 ， 无 需 设置 一 个 高 

的 max_standby_streaming_delay 。 虽然 用 这 种 方法 保证 窗口 的 执行 时 间 是 有 困难 的 ， 

为 vacuum_defer_cleanup_age 在 主 服 务 器 执行 的 事务 中 是 可 测 的 。 


查询 数 取消 ， 原因 可 以 看 作 在 各 用 服务 器 上 使 用 pg_stat_database_conflicts 系统 视图 。 
pg_stat_database 系统 视图 也 包含 摘要 信息 。 


25.5.3. 管理 员 概 述 


如 果 在 postgresql.conf 中 后 用 了 hot_standby , 并 且 目 前 有 个 recovery.conf 文件 ， 该 服 
务 器 将 运行 在 热 各 模式 。 不 过 可 能 花 些 时 间 为 允许 的 热 各 连接 ， 因为 该 服务 器 不 接受 连接 直 
到 完成 足够 的 恢复 能 提供 一 致 的 状态 ， 其 查询 能 运行 。 在 这 个 期 间 ， 将 带 有 一 个 错误 信息 拒 
绝 窜 户 端 尝试 连接 。 为 确认 该 服务 器 起 来 了 ， 要 么 循环 尝试 从 应 用 程序 连接 ， 或 者 在 服务 器 
日 志 里 查看 这 些 错 误 信 息 : 


LOG: entering standby mode 
. then some time later ... 


LOG: consistent recovery state reached 
LOG: database system is ready to accept read only connections 


在 主 服务 器 上 每 个 检查 点 一 致 的 信息 记录 一 次 。 在 主 服务 器 上 没有 将 wal_level 设置 
为 hot_standby 时 ， 当 污 取 正在 写 的 WAL 时 ， 启用 热 备 是 不 可 能 的 。 存 在 这 些 条 件 的 两 者 也 
可 能 延迟 达到 一 致 性 状态 : 


。 一 个 写 事 务 有 多 于 64 个 子 事务 

° 很 长 时 间 活 动 的 写 事 务 
如 果 你 正 运 行 基于 文件 日 志 传送 CHS") ， 你 可 能 需要 等 到 下 一 个 WAL 文 件 到 来 ， 其 尽 可 
能 长 如 在 主 服务 器 设置 archive_timeout o 


有 些 参数 的 设置 在 备 服 务 器 将 需要 重新 配置 ， 如 果 在 主 服务 器 改变 了 它们 。 对 于 这 些 参数 ， 
备 服务 器 上 的 值 要 大 于 或 等 于 主 服务 器 上 的 。 如 果 这 些 参数 没有 设置 足够 高 ， 那 么 备 服 务 器 
将 拒绝 启动 。 提供 了 更 高 的 值 ， 重 启 该 服务 器 再 开始 恢复 。 这 些 参数 是 : 


@ max_connections 
@ max_prepared_transactions 
@ max_locks_per_transaction 


管理 员 选 择 合适 的 设置 为 max_standby_archive_delay 和 max_standby_streaming_delay 是 很 
重要 的 。 根据 业务 的 优先 级 ， 最 好 的 选择 有 所 不 同 。 例 如 : 如 果 服 务 器 是 主要 任务 ， 作为 高 
可 用 性 的 服务 器 ， 那 么 你 想 低 延迟 设置 ， 也 许 设 置 为 0， 尽 管 这 也 是 很 积极 的 设置 。 如 果 各 服 
务 器 的 任务 作为 决策 支持 的 额外 服务 器 ， 那 么 可 能 接受 设置 最 大 延迟 为 几 个 小 时 ， 或 甚至 -1 
意味 着 永远 等 待 查询 完成 。 


在 主 服 务 器 上 写 的 事务 状态 "提示 位 "没有 记录 WAL 日 志 ， 所 以 在 各 服务 器 上 将 或 许 再 次 重 写 该 
fem. 因此 ， 备 服务 器 将 仍然 进行 写 磁 盘 即使 所 有 用 户 是 只 读 的 ， 数 据 值 自 身 没有 发 生 改 
变 。 用 户 将 仍然 写 大量 排 序 的 临时 文件 和 重新 生成 缓存 的 信息 文件 ， 所 以 在 热 备 模式 数据 库 
没有 部 分 是 真 只 读 的 。 还 要 注意 写 到 远程 数据 库 使 用 dblink 模 块 ， 外 部 数据 的 操作 使 用 PL 图 
数 仍然 是 可 能 的 ， 尽 管事 务 是 本 地 只 读 的 。 


在 恢复 模式 里 ， 不 接受 下 面 类 型 的 管理 命令 : 


e 数据 定义 语言 (DDL) - e.g. CREATE INDEX 
e 权限 和 所 有 权 - GRANT , REVOKE , REASSIGN 


e 维护 命令 - ANALYZE , VACUUM , CLUSTER , REINDEX 
再次 ， 请 注意 在 主 服 务 器 的 “只 读 " 模 式 事务 中 ， 人 允许 这 里 的 某 些 命 合 。 


作为 一 个 总 结 ， 你 不 能 创建 额外 的 索引 ， 统 计 也 不 能 仅 在 各 服务 器 ， 如 果 需 要 这 些 管理 命 
合 ， 应 该 在 主 服 务 器 执行 ， 并 且 最 终 这 些 变化 将 传播 到 各 服务 器 。 


pg_cancel_backend() 和 pg_terminate_backend() 将 在 用 户 后 台 工 作 ， 但 是 不 启动 进程 ， 其 执 
行 恢复 。 pg_stat_activity 将 不 显示 为 一 个 启动 进程 项 ， 也 不 显示 做 恢复 事务 的 活动 。 作为 
一 个 总 结 ， pg_prepared_xacts 在 恢复 中 总 是 空 。 如 果 你 愿 解 决 有 疑问 准备 的 事务 ， 在 主 服 
务 器 上 查看 pg_prepared_xacts 和 发 出 命令 来 解决 这 里 的 事务 。 


pg_locks 将 显示 由 后 台 持 有 的 锁 。 pg_locks 也 显示 由 启动 进程 所 管理 的 虚拟 事务 ， 其 拥有 
由 恢复 正 回放 的 事务 所 持 有 的 AccessExclusiveLocks o 请 注意 该 启动 进程 不 需要 锁定 数据 库 
变化 ， 并 且 非 AccessExclusiveLocks $, 不 会 显示 在 启动 进程 的 pg_locks 里 。 它 们 只 是 推测 
存在 。 


Nagios 插 件 check_pgsql 将 工作 ， 因 为 用 它 检测 存在 的 简单 信息 。 check_postgres 监 控 脚 本 
也 将 工作 ， 尽管 有 些 报 告 值 能 给 不 同 或 迷惑 的 结果 。 例如 : 上 次 清理 时 间 将 不 会 保持 ， 因为 
在 各 服务 器 没有 清理 发 生 。 运行 在 主 服 务 器 的 清理 ， 将 仍然 发 送 它 们 的 改变 到 各 服务 器 。 


在 恢复 期 闻 WAL 文 件 控制 命令 将 不 工作 ， 比如 pg_start_backup ， pg_switch_xlog 等 。 
动态 加 载 模块 工作 ， 包 括 pg_stat_statements o 


在 恢复 中 咨询 锁 将 工作 正常 ， 包 括 死 锁 保 护 。 请 注意 咨询 锁 从 不 写 WAL 日 志 ， 所 以 对 于 一 个 
咨询 锁 在 主 服务 器 上 或 回放 WAL 在 各 服务 器 上 冲突 不 可 能 的 。 在 主 服务 器 上 需要 一 个 咨询 
锁 ， 在 备 服务 器 上 已 经 初始 化 了 一 个 类 似 咨 询 锁 也 是 不 可 能 的 。 咨询 锁 只 是 与 需要 它们 的 服 
务 器 相关 。 

基于 触发 器 的 复制 系统 像 Slony, Londiste 和 Bucardo 将 不 在 各 服务 器 运行 ， 尽管 在 主 服务 器 运 


行 的 很 好 ， 但 变化 不 会 发 送 到 各 服务 器 应 用 。WAL 回 放 不 是 基于 触发 器 的 ， 所 以 你 不 能 从 各 
服务 器 中 传送 到 任何 系统 ， 其 需要 额外 的 写 或 依赖 使 用 触发 器 。 


不 能 分 配 新 OID， 尽 管 某 些 UUID 生 成 器 可 能 仍然 工作 ， 只 要 不 依靠 它们 写 新 状态 到 数据 库 。 


当前 ， 在 只 读 事 务 中 不 允许 创建 临时 表 ， 所 以 在 某 些 情况 下 存在 的 脚本 将 运行 不 正确 。 这 个 
限制 可 能 在 以 后 的 版 本 中 放宽 。 这 是 一 个 SQL 标 准 的 兼容 性 和 技术 问题 。 


如 果 表 空间 是 空 ， DROP TABLESPACE 只 能 成 功 。 有 些 各 服务 器 用 户 可 积极 的 通 
过 temp_tablespaces 参数 使 用 该 表 空 间 。 如 果 在 表 空 间 有 临时 文件 ， 取 消 所 有 活动 的 查询 来 
确保 删除 临时 文件 ， 所 以 可 以 删除 表 空 间 ， 可 以 继续 WAL 回 放 。 


在 主 服 务 器 上 运行 DROP DATABASE 或 者 ALTER DATABASE ... SET TABLESPACE 将 产生 一 个 WAL 
项 ， 其 将 导致 已 连接 到 在 各 服务 器 上 的 那个 数据 库 的 所 有 用 户 ， 强 制 断 开 连接 。 这 个 动作 立 
即 发 生 ， RE max_standby_streaming_delay 的 设置 。 请 注意 ALTER DATABASE ... RENAME 不 会 
断 开 连接 的 用 户 ， 在 多 数 情 况 下 忽视 ， 不 过 如 果 某 些 方式 依赖 数据 库 名 ， 可 能 在 某 些 情况 下 
导致 一 个 程序 混乱 。 


在 正常 (JERS) 模式 ， 如 果 你 发 出 DRoP user 或 者 o ROLE 对 于 一 个 有 登录 权限 的 角色 ， 
当 那 个 用 户 仍 然 已 经 连接 ， 那 么 不 会 发 生 什 么 对 于 已 连接 的 用 户 - 他 们 保持 连接 。 不 过 该 用 户 
不 能 再 连接 。 这 个 行为 在 恢复 中 也 适用 ， 所 以 在 主 服务 器 上 DRoP user 不 能 断 开 各 服务 器 上 
该 用 户 连 接 。 

在 恢复 中 统计 采集 器 是 活动 的 。 所 有 扫描 ， 读 取 ， 块 ， 索 引 使 用 等 ， 将 在 各 服务 器 中 记录 。 
回放 活动 将 不 复制 在 主 服务 器 上 的 影响 ， 因 此 回放 插入 将 不 增加 插入 pg_stat_user_tables 
列 。 恢复 开始 删除 该 统计 文件 ， 所 以 主 备 服务 器 的 统计 将 不 同 ， 认 为 这 是 个 特性 ， 而 不 是 一 
个 臭虫 。 

在 恢复 中 自动 清理 是 不 活路 的 。 在 恢复 结束 将 正常 启动 。 


在 恢复 中 后 台 记 录 器 是 活动 的 ， 将 执行 重启 点 (类 似 于 主 服务 器 上 的 检查 点 ) 和 正常 块 清理 
活动 。 这 可 能 包含 存储 在 备 服 务 器 上 的 提示 信息 更 新 。 在 恢复 中 接受 cHEckPoINT 命令 ， 尽 
管 执 行 一 个 重启 点 而 不 是 一 个 新 检查 点 。 


25.5.4. 热 备 人 参数 参考 


各 种 参数 已 经 在 Section 25.5.2 和 Section 25.5.3 上 面 提 到 。 


在 主 服务 器 上 ， 可 以 使 用 参数 wal _ level 和 vacuum _defer_cleanup_age。 如 果 在 主 服务 器 上 
3&1, max_standby_archive_delay#] max_standby_streaming_delay 没 有 影响 。 


在 各 服务 器 ,可 以 使 用 参数 hot _standby, max_standby_archive_delay 和 
max_standby_streaming_delay。 只 要 服务 器 保留 在 各 模式 ，vacuum_defer_cleanup_age 没 
影响 ， 尽管 变 为 相关 的 ， 如 果 备 服务 器 成 为 主 服 务 器 。 


25.5.5. Caveats 


有 几 个 热 备 限制 。 这 些 可 能 在 将 来 的 版 本 中 解决 : 
。 在 哈 希 索引 的 操作 ， 不 会 记录 在 目前 的 WAL 日 志 ， 索 引 回放 将 不 更 新 这 些 索 引 。 


。 在 做 快照 之 前 充分 认识 运行 的 事务 是 必需 的 。 事务 使 用 大 量 的 子 事务 (当前 大 于 64) 将 
延迟 只 读 连接 的 开始 直到 运行 最 长 写 事务 完成 。 如 果 这 种 情况 发 生 ， 说 明 信 息 将 发 送 到 
服务 器 的 日 志 。 


。 对 于 备 服 务 器 查询 的 有 效 开 始点 是 产生 在 主 服 务 器 上 的 每 个 检查 点 。 如 果 各 服务 器 关 
机 ， 当 主 服务 器 在 关机 状态 ， 不 可 能 重 进 热 各 直到 启动 主 服 务 器 ， 所 以 在 WAL 日 志 里 产 
生 进 一 步 的 开始 点 。 在 最 常见 的 情况 下 这 种 情况 不 是 一 个 问题 ， 它 可 能 发 生 。 一 般 地 ， 
如 果 主 服务 器 关机 ， 不 再 可 用 ， 那 可 能 由 于 一 个 严重 的 失败 ， 需要 将 备 服务 器 转化 为 新 
主 服 务 器 运行 。 并 且 有 特意 取 下 主 服务 器 的 情况 ， 协调 确保 备 服 务 器 成 为 平滑 的 主 服务 
器 ， 也 是 标准 的 处 理 。 


。 在 恢复 结束 ， 由 准 各 的 事务 持 有 的 AccessExclusiveLocks 需要 锁 表 正常 数量 的 条 目的 两 
Bo 如 果 你 计划 运行 大 量 并 发 的 准 各 事务 ， 正 常 地 用 AccessExclusiveLocks 或 你 计划 一 
个 大 事务 用 多 个 AccessExclusiveLocks ， 建议 你 选择 一 个 大 
的 max_locks_per_transaction 值 , 可 能 为 在 主 服 务 器 上 两 倍 这 个 参数 值 。 如 果 你 设 
ia max_prepared_transactions 为 0， 根本 不 需要 考虑 这 个 。 


。 串 行 化 事务 隔离 级 别 在 热 各 份 中 仍然 不 可 用 (参阅 Section 13.2.3 and Section 13.4.1 获 
取 更 多 信息 ) 。 在 热 各 份 模式 中 党 试 设置 事务 为 串 行 化 隔离 级 别 将 产生 一 个 错误 。 


Chapter 26. 恢复 配置 
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绍 recovery.conf 中 可 用 设置 。 它 们 仅 用 于 恢复 的 时 间 。 它们 必须 为 后 续 希 望 的 恢 
复 进 行 重 置 ， 一 旦 开始 恢复 ， 那 么 不 能 进行 修改 。 


recovery.conf 中 的 设置 采用 的 是 name = 'value' 的 形式 。 每 一 行 声明 一 个 参数 。( # ) 用 于 
注释 。 使 用 2 个 引号 ( '' )， 在 参数 值 中 内 入 一 个 单 引 号 。 


安装 目录 的 shares 路 径 下 有 一 个 简单 的 例子 ， share/recovery.conf.sample o 


26.1. 妇 档 恢复 设置 


restore command ( string ) 


检索 WAL 文 件 中 已 为 档 段 的 SHELL 命 合 。 对 为 档 恢 复 来 说 这 个 参数 是 必须 的 ， 但 对 流 复制 来 
说 是 可 选 的 。 字符 串 中 的 任何 一 个 %f 是 用 为 档 检 索 中 的 文件 名 替换 ， HE ”xp 是 用 服务 器 
上 的 复制 目的 地 的 路 径 上 复制 目的 地 的 路 径 名 蔡 换 。 (路径 名 是 相对 当前 工作 路 径 的 ， 如 客 
户 端的 data 路 径 ) 任意 一 个 wr 是 用 包含 最 新 可 用 重启 点 的 文件 名 蔡 换 。 这 是 最 早 的 文件 ， 
必须 保留 以 转 储 ， 从 而 实现 一 致 性 ， 因此 这 个 信息 可 以 用 于 截断 为 档 至 实现 从 当前 转 储 中 重 
启 的 最 低 要 求 。 sr 典型 的 只 用 于 热 备 配置 (参阅 Section 25.2)。 %% 可 以 嵌入 一 个 实际 

的 % 字符 。 


对 命 爸 来 说 ， 只 有 当成 功 时 返回 一 个 需 退 出 状态 是 很 重要 的 。 命令 将 被 要 求 注 档 命令 中 没有 
出 现 的 文件 名 ; 当 为 要 求 是 ， 必 须 返 回 非 需 。 如 : 


restore_command 
restore_command 


‘cp /mnt/server/archivedir/%f "%p"' 
"copy "C:\\server\\archivedir\\%Ff" "%p"' # Windows 


archive_cleanup_command ( string ) 


这 个 选项 参数 声明 一 个 在 每 次 重启 时 执行 的 Shell 命 令 。 archive _cleanup_command 为 清理 备 库 
不 需要 的 为 档 WAL 文 件 提供 一 个 机 制 。 任何 一 个 or 由 包含 最 新 可 用 重 馈 点 的 文件 名 代 蔡 。 
这 是 最 早 的 文件 ， 因此 必须 保留 以 允许 转 储 能 够 重新 启动 ， 因 此 所 有 早 于 or 的 文件 可 以 安 
全 的 移 除 。 这 个 信息 可 以 用 于 删除 为 档 至 能 满足 从 当前 转 储 重启 的 最 低 要 求 。 对 典型 单 各 配 
置 中 的 archive_cleanup_command MA, 经 常 使 用 pg_archivecleanup 模 块 ， 比 如 : 


archive_cleanup_command = 'pg_archivecleanup /mnt/server/archivedir %r' 


然而 需要 注意 的 是 ， 如 果 多 个 备 服务 器 从 相同 的 兴 档 路 径 转 储 ， 需要 确保 在 任何 一 个 各 服务 
器 不 在 需要 之 前 ， 不 能 删除 WAL 文 件 。 在 热 各 配置 中 ， 会 明显 的 用 

到 archive_cleanup_command (参阅 Section 25.2), 通过 %% ， 在 命令 中 余人 一 个 实际 的 % 字 
符 。 


如 果 命 令 返 回 一 个 非 0 的 退出 状态 ， 那 么 将 写 一 个 警告 日 志 信息 。 
recovery_end_command ( string ) 


这 个 参数 是 可 选 的 ， 用 于 声明 一 个 只 在 恢复 完成 时 执行 的 SHELL 命 今 。 
recovery_end_command 人 清理 动作 提供 一 个 机 制 。 wr AG 
含 最 新 可 用 重启 点 的 文件 名 代替 ， 如 在 archive_cleanup_command 中 的 那样 。 


如 果 命令 返回 一 个 非 0 的 退出 状态 ， 那 么 将 写 一 个 警告 日 志 信 息 ， 并 且 数 据 库 将 会 继续 启动。 
如 果 命 邻 被 一 个 信号 终止 ， 数 据 库 不 会 继续 启动 。 


26.2. 恢复 目标 设置 


recovery_target_name ( string ) 


此 参数 声明 命名 的 还 原点 ， 创建 pg_create_restore_point() 继续 恢复 。 可 以 指 
定 recovery_target_name ,recovery target _ time 或 者 recovery_target_xid 最 多 之 一 。 默认 是 
恢复 到 WAL 日 志 的 结尾 。 


recovery_target_time ( timestamp ) 


这 个 参数 设置 一 个 时 间 戳 ， 达 到 这 个 时 间 惟 时 会 继续 进行 恢复 。 在 大 多 数 
的 recovery_target_time , recovery target_name 或 者 recovery target xid 都 可 以 声明 这 个 参 
数 。 缺 省 是 恢复 到 WAL 日 志 的 结尾 。 精 确 的 停止 点 也 受到 recovery _target inclusive 的 影响 。 


recovery_target_xid ( string ) 


这 个 参数 声明 一 个 事务 ID， 达 到 这 个 ID 号 继续 进行 恢复 。 需要 注意 的 是 ， 当 在 事务 开始 时 ， 
顺序 分 配 事务 ID， 事 务 会 以 不 同 数字 顺序 结束 。 将 被 恢复 的 事务 是 那些 在 一 个 指定 事务 前 
(或 包含 该 事务 ) 提交 事务 。 在 大 多 数 recovery_target_xid ,recovery target_name 或 者 
recovery_target_ time 都 可 以 声明 参数 。 缺 省 是 恢复 到 WAL 日 志 尾 。 精 确 的 停止 时 间 也 受 

recovery _target inclusive 的 影响 。 


recovery_target_inclusive ( boolean ) 


声明 是 否 在 指定 恢复 目标 ( true ) 之 后 停止 ， 或 在 这 ( false ) 之 前 停止 。 应 用 于 
recovery_target_time 和 recovery target xid， 无 论 哪 个 ， 都 是 为 这 个 恢复 声明 的 。 这 表示 事 
务 是 否 具有 明确 的 目标 提交 时 间或 ID， 会 分 别 被 包含 在 恢复 中 。 缺 省 是 true o 


recovery_target_timeline ( string ) 


声明 在 一 个 指定 时 间 线 进行 恢复 。 缺 省 是 当前 正在 进行 基础 各 份 的 时 间 线 。 设置 它 

为 latest 恢复 归档 中 发 现 的 最 新 时 间 线 ， 这 在 各 用 服务 器 中 是 有 用 的 。 只 需要 在 复杂 的 重新 
恢复 的 情况 下 声明 这 个 参数 ， 在 这 种 情况 下 ， 需要 返回 一 个 在 PITR 之 后 需要 达到 的 状态 。 参 
阅 Section 24.3.5 获 取 更 多 详细 信息 。 


pause_at_recovery_target ( boolean ) 


当 达 到 恢复 目标 时 ， 指 定 是 否 恢复 应 该 暂停 。 黑 认 是 真 。 如 果 恢 复 目 标 是 恢复 最 理想 的 点 ， 
这 是 为 了 人 允许 查询 被 执行 反对 检查 数据 库 。 暂 停 状 态 可 以 使 用 pg_xlog_replay_resume() (& 
见 Table 9-62) 恢复 ， 然 后 使 恢复 结束 。 如 果 恢 复 目标 不 是 所 需 的 停止 点 ， 那 么 关闭 服务 
器 ， 更 改 恢复 目标 设置 为 以 后 的 目标 并 重新 启动 继续 恢复 。 


如 果 不 启 用 hot_standby， 或 者 没有 设置 恢复 目标 ， 那 么 这 个 设置 不 起 作用 。 


26.3. 4 FARA as ik E 


standby_mode ( boolean ) 


声明 是 否 需要 启动 PostgreSQL 服 务 器 为 一 个 standby。 如 果 这 个 参数 为 on ， 在 达到 六 档 
WAL 尾 时 ， 服 务 器 不 会 停止 恢复 ， 但 会 通过 使 用 restore_command 抓 取 新 的 WAL 段 (和 /或 通 
过 连接 到 主 服务 器 ， 如 primary_conninfo 设置 声明 的 那样 ) 来 尝试 继续 恢复 。 


primary_conninfo ( string ) 


为 连接 到 主 服务 器 的 各 服务 器 声明 一 个 连接 字符 串 。 这 个 字符 串 的 格式 在 Section 31.1.1 中 描 
述 ， 如 果 字符 串 中 没有 声明 选项 ， 那么 会 检查 相关 的 环境 变量 (参阅 Section 31.14) 。 如 
果 环 境 变量 也 没有 设置 ， 那 么 使 用 缺 省 的 。 

连接 字符 串 应 该 声明 主 库 的 主机 名 (或 地 址 ) ， 以 及 端口 号 〈 如 果 和 与 各 库 的 缺 省 端口 不 

同 ) 。 同样 的 ， 声 明 一 个 用 户 名 对 应 主 库 上 具有 合适 权限 的 角色 (参阅 Section 25.2.5.1) 。 
如 果 主 库 要 求 密码 验证 ， 那 么 还 需要 提供 一 个 密码 。 可 以 在 primary_conninfo 字符 串 中 提 
供 ， 或 者 在 各 库 上 一 个 单独 的 ~/.pgpass 文件 中 (以 replication 作为 数据 库 名 ) 。 不 用 
在 primary_conninfo 字符 串 中 声明 数据 库 名 。 


如 果 standby_mode 设置 为 off 时 ， 则 这 个 设置 不 起 作用 。 
trigger_file ( string ) 


指定 一 个 触发 器 文件 ， 用 于 在 备 库 中 结束 恢复 。 即使 不 设置 此 值 ， 你 还 可 以 使 
用 pg_ctl promote 促进 备份 。 如 果 standby_mode 为 off ， 则 这 个 设置 不 起 作用 。 
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o 27.4.3. 使 用 跟踪 点 
o 27.4.4. 定义 新 的 跟踪 点 


一 个 数据 库 管 理 员 常常 想 知 道 "现在 系统 正在 干什么 呢 ?"。 本 章 讨论 如 何 回答 这 个 问题 。 


有 一 些 工具 可 以 用 来 监控 数据 库 活动 以 及 分 析 性 能 。 本 章 大 部 分 内 容 是 用 于 描述 PostgreSQL 
的 统计 收集 器 ， 但 我 们 也 不 能 忽视 普通 的 Unix 监 控 程 序 ， 上 比 

如 ps ， top, iostat 和 vmstat. 同样 ， 一 且 发 现 了 某 个 性 能 悉 劣 的 查询 ， 可 能 还 要 用 

PostgreSQL 的 EXPLAIN 命令 进行 进一步 分 析 。 Section 14.1 里 讨论 了 ExPLAIN 和 其 它 用 于 
理解 独立 查询 行为 的 方法 。 


27.1. 标准 Unix 工 具 


PostgreSQL 在 大 多 数 平 台 上 修改 ps 输出 的 命 分 标题 ， 这 样 我 们 就 很 容易 找 出 某 个 服务 器 进 
程 。 一 个 简单 的 显示 如 下 : 


$ ps auxww | grep ^postgres 


postgres 15551 0.0 0. 57536 7132 pts/0 S 18:02 0:00 postgres -i 

postgres 15554 0.0 0. 57536 1184 ? Ss 18:02 0:00 postgres: writer proces 
postgres 15555 0.0 0.0 57536 916 ? Ss 18:02 0:00 postgres: checkpointer 

postgres 15556 0.0 0.0 57536 916 ? Ss 18:02 0:00 postgres: wal writer pr 
postgres 15557 0.0 0.0 58504 2244 ? Ss 18:02 0:00 postgres: autovacuum la 
postgres 15558 0.0 0.0 17512 1068 ? Ss 18:02 0:00 postgres: stats collect 
postgres 15582 0.0 0.0 58772 3080 ? Ss 18:04 0:00 postgres: joe runbug 12 
postgres 15606 0.0 0.0 58772 3052 ? Ss 18:07 0:00 postgres: tgl regressio 
postgres 15610 0.0 0.0 58772 3056 ? Ss 18:07 0:00 postgres: tgl regressio 


EIE) 


调用 ps 的 方法 因 平 台 的 不 同 而 略 有 不 同 ， 显 示 出 来 的 细节 也 有 一 些 区 别 。 这 个 例子 来 自 一 

个 最 近 的 Linux 系 统 。 这 里 显示 出 来 的 第 一 个 进程 是 主 服务 器 进程 。 显示 的 命令 参数 和 启动 它 
的 命令 行 参数 相同 。 下 面 是 由 主 服务 器 进程 自动 调用 的 五 个 统计 收集 器 后 台 进 程 ， 如 果 你 设 
置 了 系统 不 启动 统计 收集 器 ， 那 么 它们 不 会 出 现 。 同样 的 可 用 禁用 "autovacuum 发 射 器 "。 Fl 
下 的 都 是 一 个 个 处 理 客 户 连接 的 服务 器 进程 ， 每 个 这 样 的 进程 都 用 下 面 的 形式 显示 : 





postgres: _user_ _database_ _host_ _activity_ 


在 该 客户 端 连 接 的 生命 期 中 ， 用 户 ， 数 据 库 和 (客户 端 ) 主 机 都 保持 不 变 ， 但 是 活路 性 指示 符 

会 变化 。 活 路 性 可 以 是 20 (SHE 户 端的 命令 )、 事务 空间 (在 一 个 BEGIN 块 里 等 待 用 户 )、 

或 者 一 个 命令 类 型 名 ， 比 如 sELEcT 。 同样 ， 如 果 当 前 正在 等 待 一 个 其 它 服务 器 进程 持 有 的 锁 
的 时 候 ， 会 在 信息 后 面 附加 waiting 。 在 上 面 的 例子 中 ， 我 们 可 以 推出 : 进程 15606 正 在 等 
待 15610 完 成 其 事务 ， 这 样 才能 释放 一 些 锁 。 进 程 15610 阻 塞 ， 因为 没有 其 他 活动 会 话 。 在 更 
复 条 的 情况 下 ， 有 必要 查看 pg_locks 系统 视图 来 决定 谁 正在 阻止 他 们 。 


如 果 关 闭 eae process title 那 么 活跃 性 指示 符 将 不 会 变化 ， 并 且 进 程 标题 仅 在 新 进程 被 
启动 的 时 候 设置 一 次 。 在 某 些 平台 上 这 样 做 可 以 节省 每 个 命令 的 开销 ， 但 在 其 它 平台 上 却 没 
有 这 种 差异 。 





Tip: Solaris 需 要 特别 的 处 理 。 你 必需 使 用 /usrvucbyps 而 不 是 /bin/ps 。 你 还 必需 使 用 
两 个 w 标志 ， 而 不 是 一 个 。 另外 ， 你 最 初 调 用 postgres 时 用 到 的 命令 行 在 ps KAR 
示 中 必须 比 每 个 服务 器 进程 显示 的 短 。 如 果 没 满足 这 三 个 条 件 ， 那么 ps 为 每 个 服务 器 
进程 输出 的 将 是 最 初 的 postgres 的 命 合 行 。 


27.2. 统计 收集 器 


PostgreSQL 的 统计 收集 器 是 一 个 支持 收集 和 汇报 服务 器 活跃 性 信息 的 子 系统 。 目前 ， 这 个 收 
集 器 可 以 给 出 对 表 和 索引 的 访问 计数 ， 包括 磁 总 块 的 数量 和 独立 行 的 项 。 它 还 跟踪 每 个 表 中 
的 行 的 总 数 ， 每 个 表 的 过 去 的 清理 和 分 析 时 间 。 它 也 可 以 计算 用 户 定义 的 画 数 的 调用 ， 以 及 
每 个 人 的 总 花费 的 时 间 。 


PostgreSQL 还 可 以 判断 当前 其 它 服 务 器 进程 正在 执行 的 命令 是 什么 。 这 是 一 个 收集 过 程 中 的 
独立 设施 。 


27.2.1. 统计 收集 器 配置 


因为 统计 收集 给 查询 处 理 增加 了 一 些 开 销 ， 所 以 该 系统 可 以 配置 为 启用 或 禁用 统计 收集 。 这 
是 由 配置 参数 控制 的 ， 通 常 在 postgresql.conf 里 设置 (参阅 Chapter 18 获 取 有 关 设 置 配 置 参 
数 的 细节 )。 


参数 track_activities 和 启动 监测 任何 服务 器 进程 执行 的 当前 命令 。 
参数 track_counts 控 制 关 于 表 和 索引 是 否 被 统计 。 

参数 track_functions 实 现 了 对 用 户 定义 的 画 数 用 法 的 追踪 。 
参数 track_io timing 启动 监控 块 读 写 次 数 。 


通常 这 些 参数 在 postgresql.conf 中 设置 ， 因 此 它们 作用 于 所 有 服务 器 进程 ， 但 是 我 们 也 可 以 
在 独立 的 会 话 里 用 SET 命令 把 它们 打开 或 者 关闭 。 为 避免 普通 用 户 把 它们 的 活路 性 隐藏 不 给 
管理 员 看 ， 只 有 超级 用 户 允 许 用 ser 命令 修改 这 些 参数 。 


统计 收集 器 通过 临时 文件 将 采集 到 的 信息 传递 给 其 他 的 PostgreSQL 进 程 。 这 些 文件 存放 
在 stats_temp_directory 参 数 命名 的 目录 中 。 缺 省 是 pg_stat_tmp 。 为 了 提高 性 

能 ， stats_temp_directory 参数 可 以 指向 一 个 基于 RAM 的 文件 系统 ， 降低 物理 |/O 需 求 。 当 服 
务 器 关闭 时 ， 统计 数据 的 永久 复 本 存储 在 global 子 目录 中 ， 所 以 统计 数据 可 以 在 服务 器 重 
新 启动 时 保留 。 


27.2.2. 查看 收集 到 的 统计 信息 


有 一 些 预 定义 的 视图 可 以 用 于 显示 统计 收集 的 结果 ， 在 Table 27-1 里 列 出 。 另外 ， 我 们 可 以 
使 用 底层 的 统计 画 数 制作 自 定 义 的 视图 。 正如 Section 27.2.3 中 讨论 的 。 


在 使 用 统计 观察 当前 活路 性 的 时 候 ， 你 必须 意识 到 这 些 信息 并 不 是 实时 更 新 的 。 每 个 独立 的 
服务 器 进程 只 是 在 准备 进入 空闲 状态 的 时 候 才 向 收集 器 传送 新 的 块 和 行 访问 计数 ; 因此 正在 
处 理 的 查询 或 者 事务 并 不 影响 显示 出 来 的 总 数 。 同 样 ， 收集 器 本 身 也 最 多 

每 PGSTAT_STAT_INTERVAL M) ( 缺 省 500， 除 非 在 编译 服务 器 的 时 候 修 改过 ) 发 送 一 次 新 的 报 
告 。 因 此 显示 总 是 落后 于 实际 活动 。 但 是 由 track_activities 收集 的 当前 查询 信息 总 是 实时 
更 新 的 。 


另外 一 个 需要 着 重 指出 的 是 ， 在 请 求 服务 器 进程 显示 任何 这 些 统计 信息 的 时 候 ， 它 首 先 抓 取 
收集 器 进程 发 出 的 最 新 报告 ， 然 后 就 拿 这 些 数据 作为 所 有 统计 视图 和 辑 数 的 快照 ， 直到 它 当 
前 的 事务 结束 。 因 此 统计 信息 在 当前 事务 的 持续 期 间 内 显示 静态 信息 。 FUN, 每 个 进程 的 
当前 查询 信息 在 该 查询 首次 出 现在 事务 中 的 时 候 就 被 收集 了 ， 并 且 在 整个 事务 过 程 中 都 显示 
相同 的 信息 。 这 是 一 个 特性 ， 而 不 是 一 个 臭虫 ， 因为 这 样 就 允许 你 在 统计 上 执行 几 个 查询 并 
且 对 结果 进行 相关 性 检查 而 又 不 用 担心 这 些 数字 会 懈 展 的 变化 。 但 是 如 果 你 想 看 每 个 查询 的 
最 新 结果 ， 那 么 就 要 记 住 在 事务 块 外 面 处 理 这 些 查询 。 另外 ， 你 可 以 调 

用 pg_stat_clear_snapshot ()， 这 将 丢弃 目前 事务 的 统计 数据 快照 (如 有 ) 。 下 次 使 用 统计 
信息 将 导致 获取 一 个 新 的 快照 。 











在 视图 pg_stat_xact_all_tables ， pg_stat_xact_sys_tables , pg_stat_xact_user_tables 和 
pg_stat_xact_user_functions 上 事务 也 可 以 看 到 自己 的 统计 (未 传送 到 收集 器 ) 。 这 些 数字 
不 能 作为 上 面 所 说 的 ; 相反 他 们 在 整个 事务 中 不 断 更 新 。 





Table 27-1. 标准 统计 视图 


视图 名 称 描述 
每 个 服务 器 进程 一 行 ， 显 示 进 程 当前 活动 相关 的 信息 ， 
pg_stat_activity 比如 状态 和 当前 查询 。 参阅 pg_stat_activity 获 取 更 多 详 
情 。 


只 有 一 行 ， 显 示 关 于 后 端 写 进程 活动 的 统计 信息 。 参 
阅 bpg_stat_bgwriter 获取 更 多 详细 信息 。 


每 个 数据 库 一 行 ， 显 示 数 据 库 广泛 的 统计 。 参 
阅 bg_stat_database 获 取 更 多 详情 。 


当前 数据 库 每 个 表 一 行 ， 显 示 关 于 访问 特定 表 的 统计 。 
参阅 pg_stat_all_tables 获取 更 多 详细 信息 。 


pg_stat_bgwriter 


pg_stat_database 


pg_stat_all_tables 


pg_stat_sys_tables 和 pg_stat_all_tables 一 样 ， 除 了 只 显示 系统 表 之 外 。 
pg_stat_user_tables 和 pg_stat_all_tables 一 样 ， 除 了 只 显示 用 户 表 。 


类 似 pg_stat_all_tables , 但 是 到 目前 为 止 当前 事务 中 
计算 采取 的 行动 (这 不 包含 在 pg_stat_all_tables 中 以 
及 相关 视图 中 。) 活 的 列 数 以 及 死 行 和 清理 以 及 分 析 操 
作 不 在 此 视图 中 出 现 。 


pg_stat_xact_sys_tables 和 pg_stat_xact_all_tables 相同 ， 除 了 只 显示 系统 表 。 


pg_stat_xact_all_tables 











pg_stat_xact_user_tables 和 pg_stat_xact_all_ tables 相同 ， 除 了 只 显示 用 户 表 。 








pg_stat_all_indexes 当前 数据 库 中 的 每 个 索引 的 每 一 行 ， 显示 关于 访问 特定 
索引 的 统计 。 参见 pg_stat_all_ indexes 获 取 更 多 详情 。 


和 pg_stat_all_indexes 一 样 ， 但 只 显示 系统 表 上 的 索 


pg_stat_sys_indexes 


Blo 
E E 和 pg_stat_all_indexes —#, (BERENA PRENK 
=> 引 。 


sj > 4 r IN. — > g 一 mo A y 
pg_statio_all_tables 当前 数据 库 每 表 Ti; 显示 特定 表 关 于 I/O 的 统计 ， 
参阅 pg_statio_all_tables 获取 更 多 细节 。 
pg_statio_sys_tables 和 pg_statio_all_tables 一 样 ， 但 只 显示 系统 表 
pg_statio_user_tables 和 pg_statio_all_tables 一 样 ， 但 只 显示 用 户 表 。 


当前 数据 库 每 个 索引 一 行 ， 显 示 特 定 索引 关于 IJ/O 的 统 


pg_statio_all_indexes 3 3 vai 
i+. 参阅 pg_statio all_indexes 获 取 更 多 细节 。 


pg_statio_sys_indexes 和 pg_statio_all_indexes 一 样 的 ， 但 是 只 显示 系统 表 上 


的 索引 。 
a 和 pg_statio_all_indexes 一 样 ， 但 只 显示 用 户 表 上 的 索 
z ihe 引 。 


当前 数据 库 每 个 序列 一 行 ， 显 示 特 定 序列 关于 I/O 的 统 


pg_statio_all_sequences 7 : i T 
i+. BW pg_statio all_sequences 获 取 更 多 细节 。 


和 pg_statio_all_sequences Ses 但 只 显示 系统 序 


pg_statio_sys_sequences 列 。 因 为 目前 没有 定义 系统 序列 ， 所 以 这 个 视图 总 是 空 
的 。 
pg_statio_user_sequences 和 pg_statio_all_sequences 一 样 ， 但 只 显示 用 户 序列 。 


每 一 个 跟踪 函数 一 行 ， 显 示 关 于 执行 这 个 本 数 的 统计 。 
参阅 pg_stat user _ functions 获取 更 多 详情 。 


类 似 于 pg_stat_user_functions , 但 是 在 当前 事务 中 只 
调用 计数 (这 不 包含 在 pg_stat_user_functions 中 ) 。 


每 WAL 发 送 进程 一 行 ， 显 示 关 于 复制 到 发 送 端的 链接 各 


pg_stat_user_functions 


pg_stat_xact_user_functions 





pg_stat_replication 用 服务 器 的 统计 信息 。 参阅 pg_stat_replication 获 取 更 
多 细节 。 
每 个 数据 库 一 行 ， 显 示 关 于 备用 服务 器 恢复 冲突 取消 查 
pg_stat_database_conflicts 询 的 统计 信息 。 参阅 pg_stat_database_conflicts 获 取 更 
多 信息 
多 信 130 


针对 每 个 索引 的 统计 有 利于 判断 哪个 索引 得 到 使 用 以 及 它们 的 效果 。 


pg_statio 视图 有 利于 决定 缓冲 区 高 速 缓存 的 有 效 性 。 当 实 际 的 磁盘 数 读 取 比 缓冲 区 的 数目 
小 得 多 的 时 候 ， 然后 缓存 满足 大 多 数 读 请 求 而 没有 调用 内 核 调 用 。 然而 ， 这 些 统 计数 据 不 提 
共 整 个 过 程 : 由 于 PostgreSQL 处理 磁 稻 1/O 的 方式 ， 不 在 PostgreSQL 缓 冲 区 缓存 中 的 数据 可 
能 仍然 位 于 内 核 /O 缓 存 中 ， 因 此 可 能 仍然 被 取出 而 不 需要 物理 读 。 对 获得 更 多 PostgreSQL 
的 |/O 行 为 的 详细 信息 感 兴趣 的 用 户 建议 使 用 与 操作 系统 工具 结合 的 PostgreSQL 统 计 收 集 ， 
允许 洞察 WO 的 内 核 处 理 。 


Table 27-2. pg_stat_activity 视图 


列 


datid 
datname 
pid 
usesysid 
usename 


application_name 


client_addr 


client_hostname 


client_port 


backend_start 


xact_start 


query_start 


state_change 


waiting 


state 


oid 
name 
integer 
oid 
name 


text 


inet 


text 


integer 


timestamp with time 


timestamp with time 


timestamp with time 


timestamp with time 


boolean 


text 


zone 


zone 


zone 


zone 


描述 
连接 后 端的 数据 库 OID 
连接 后 端的 数据 库 名 称 
后 端 进 程 ID 
登陆 后 端的 用 户 OID 
登陆 到 该 后 端的 用 户 名 
连接 到 后 端的 应 用 名 


连接 到 后 端的 客户 端的 I|P 地 址 。 如 
果 此 字段 是 null， 它 表 明 通 过 服务 器 
机 器 上 UNIX 套 接 字 连接 客户 im A 


这 是 内 部 进程 如 autovacuum 


连接 客户 端的 主机 名 ， 

过 client_addr 人 
Bo 这 个 字段 料 只 是 非 空 的 IP 连 
接 ， 并 且 仅 仅 当 启动 log_hostname 
的 时 候 。 


客户 端 用 于 与 后 端 通讯 的 TCP 端 口 
号 ， 或 者 如 果 使 用 Unix 套 接 字 ， 则 
ABR. 


该 过 程 开 始 的 时 间 ， 比 如 当 客 户 端 连 
接 服 务 器 时 。 


启动 当前 事务 的 时 间 ， 如 果 没 有 事务 
是 活 的 ， 则 为 null。 如 果 当 前 查询 是 
首 个 事务 ， 则 这 列 等 同 


于 query_start 列 。 


开始 当前 活跃 查询 的 时 间 ， 或 者 如 
果 state 是 非 活路 的 ， 当 开 始 最 后 
查询 时 。 


上 次 状态 改变 的 时 间 
如 果 后 端 当前 正 等 待 锁 则 为 真 


该 后 端 当前 总 体 状 态 。 可 能 值 是 : 
活路 的 :后 端正 在 执行 一 个 查询 。 
空闲 的 :后 端正 在 等 待 一 个 新 的 客户 
imi. LARS : 后 端 在 事务 
中 ， 但 是 目前 无 法 执行 查询 。 
空间 事务 (被 终止 ): 这 个 情况 类 似 

于 空闲 事务 ， 除 了 事务 导致 错误 的 一 
个 语句 之 一 。 ”快速 路 径 函 数 调用 :后 端 
正在 执行 一 个 快速 路 径 函 数 。 禁用 : 
如 果 后 端 禁用 track_activities， 则 报 


Ot 


这 个 状态 。 


该 后 省 的 最 新 查询 文本 。 如 
R 状态 是 活路 的 ， 此 字段 显示 当前 
FERTH i, 在 所 有 其 他 情况 
中 ， 这 表明 执行 过 去 的 查询 。 


query text 


pg_stat_activity 每 个 服务 器 进程 有 一 行 ， 显 示 进 程 当前 活动 的 相关 信息 。 


Note: waiting 和 state 列 是 独立 的 。 如 果 一 个 后 端 处 于 ox 状态 ， 它 可 能 会 或 可 能 不 
R waiting 。 如 果 这 种 情况 是 活路 的 并 且 waiting 是 真 ， 它 意 味 着 正在 执行 一 个 查询 ， 
但 在 该 系统 中 的 某 个 地 方 被 锁 阻 塞 。 








Table 27-3. pg_stat_bgwriter 视图 


列 类 型 描述 
checkpoints_timed bigint 执行 的 定期 检查 点 数 
checkpoints_req bigint 执行 的 需求 检查 点 数 

花费 在 检查 点 处 理 部 分 的 时 间 
checkpoint_write_time double precision 总 量 ， 其 中 文件 被 守 入 到 磁 


Å, 以 毫秒 为 单位 。 
花费 在 检查 点 处 理 部 分 的 时 间 


checkpoint_sync_time double precision 总 量 ， 其 中 文件 被 同步 到 磁 
i, NÆB A Žž. 

buffers_checkpoint bigint 检查 点 写 缓 冲 区 数量 

buffers_clean bigint 后 端 写 进程 写 缓 冲 区 数量 
后 端 写 进程 停止 清理 扫描 时 间 


maxwritten_clean bigint 


>H 


数 ， 因 为 它 写 了 太 多 缓冲 区 
buffers_backend bigint 通过 后 端 直 接 写 缓冲 区 数 


后 端 不 得 不 执行 自己 
的 fsync 调用 的 时 间 数 (通常 


buffers_backend_fsync bigint paige g x 
后 端 写 进程 处 理 这 些 即使 后 端 
确实 自己 写 ) 

buffers_alloc bigint 分 配 的 缓冲 区 数量 

stats_reset timestamp with time zone 这 些 统 计 被 重 置 的 时 间 


pg_stat_bgwriter 视图 总 是 有 独立 行 ， 包 含 集群 的 全 局 数据 。 


Table 27-4. pg_stat_database 视图 


列 
datid 


datname 


numbackends 


xact_commit 
xact_rollback 


blks_read 


blks_hit 


tup_returned 
tup_fetched 
tup_inserted 
tup_updated 


tup_deleted 


conflicts 


temp_files 


temp_bytes 


deadlocks 


blk_read_time 


blk_write_time 


stats_reset 


name 


integer 


bigint 


bigint 


bigint 


bigint 


bigint 


bigint 


bigint 


bigint 


bigint 


bigint 


bigint 


bigint 


bigint 


double precision 


double precision 


timestamp with time zone 


描述 
数据 库 的 OID 
这 个 数据 库 的 名 字 
当前 连接 到 该 数据 库 的 后 端 数 。 这 是 
在 返回 一 个 反映 目前 状态 值 的 视图 中 


唯一 的 列 ; 自 上 次 重 置 所 有 其 他 列 返 
ERII. 


此 数据 库 中 已 经 提交 的 事务 数 
此 数据 库 中 已 经 回 滚 的 事务 数 
在 这 个 数据 库 中 读 取 的 磁盘 块 的 数量 


高 速 缓存 中 已 经 发 现 的 磁 瘟 块 的 次 
WH, 这 样 读 取 是 不 必要 的 〈 这 只 包括 
PostgreSQL 缓 冲 区 高 速 缓存 ， 没 有 操 
作 系 统 的 文件 系统 缓存 。 


通过 数据 库 查询 返回 的 行 数 

通过 数据 库 查询 抓 取 的 行 数 

通过 数据 库 查询 插入 的 行 数 

通过 数据 库 查询 更 新 的 行 数 

通过 数据 库 查询 删除 的 行 数 

由 于 数据 库 恢复 冲突 取消 的 查询 数 
量 。 (只 在 各 用 服务 器 发 生 的 冲 
突 ) ; 参阅 
pg_stat_database_conflicts 获 取 更 多 
信息 。 


通过 数据 库 查询 创建 的 临时 文件 数 
量 。 计 算 所 有 临时 文件 ， 不 论 为 什么 
创建 临时 文件 (上 比如 排序 或 者 哈 
希 ) ， 而 且 不 管 log_temp _files 设 置 。 


通过 数据 库 查 询 宇 入 临时 文件 的 数据 
总 量 。 计 算 所 有 临时 文件 ， 不 论 为 什 
么 创建 临时 文件 ， 而 且 不 管 

log_ temp _ files 设 置 


在 该 数据 库 中 检索 的 死 锁 数 


通过 数据 库 后 端 读 取 数 据 文 件 块 花费 
的 时 间 ， 以 毫秒 计算 。 


通过 数据 库 后 端 写 入 数据 文件 块 花费 
的 时 间 ， 以 毫秒 计算 。 


这 些 统计 最 后 被 重 置 的 时 间 


pg_stat_database 视图 将 包含 集群 中 每 个 数据 库 的 每 一 行 ， 显示 数据 库 统 计 。 


Table 27-5. pg_stat_all_tables 视图 


列 类 型 描述 
relid oid 表 的 OID 
schemaname name 此 表 的 模式 名 
relname name 表 名 
seq_scan bigint 此 表 发 起 的 顺序 扫描 数 
seq_tup_read bigint 顺序 扫描 抓 取 的 活路 行 数 
idx_scan bigint 此 表 发 起 的 索引 扫 摘 数 
idx_tup_fetch bigint 索引 扫描 抓 取 的 活路 行 数 
n_tup_ins bigint 插入 行 数 
n_tup_upd bigint 更 新 行 数 
n_tup_del bigint 删除 行 数 
EEEN ENE e (比如 没有 更 新 所 需 
n_live_tup bigint 估计 活跃 行 数 
n_dead_tup bigint 估计 死 行 数 
last_vacuum timestamp with time zone ea FE 
last_autovacuum timestamp with time zone A le 
last_analyze timestamp with time zone 上 次 手动 分 析 这 个 表 
last_autoanalyze timestamp with time zone en 
vacuum_count bigint eh Sadia B Rit 
autovacuum_count bigint 这 个 表 被 autovacuum 清 理 的 次 数 
analyze_count bigint 这 个 表 被 手动 分 析 的 次 数 
a SERIE pe eal 


pg_stat_all tables 视图 将 包含 当前 数据 库 中 每 个 表 的 一 行 (包括 TOAST 表 ) ， 显 示 访 问 特 
定 表 的 统计 信息 。 pg_stat_user_tables 和 pg_stat_sys_tables 视图 包含 相同 的 信息 ， 但 是 
过 滤 只 分 别 显 示 用 户 和 系统 表 。 


Table 27-6. pg_stat_all_indexes 视图 


列 类 型 描述 
relid oid 这 个 索引 的 表 的 OID 
indexrelid oid 索引 的 OID 
schemaname name 索引 中 模式 名 
relname name 索引 的 表 名 
indexrelname name 索引 名 
idx_scan bigint 索引 上 开始 的 索引 扫描 数 
idx_tup_read bigint 通过 索引 上 扫描 返回 的 索引 项 数 
idx_tup_fetch bigint 通过 使 用 索引 的 简单 索引 扫描 抓 取 的 活 表 行 数 


pg_stat_all_indexes 视图 将 包含 当前 数据 库 中 的 每 个 索引 行 ， 显示 访 问 特定 索引 的 统计 。 
pg_stat_user_indexes 和 pg_stat_sys_indexes 视图 包含 相同 的 信息 ， 但 是 过 滤 只 是 分 别 显 示 


用 户 和 系统 索引 。 


索引 可 以 通过 简单 的 素 引 扫描 或 "位 图 "索引 扫 摘 进行 使用。 位 图 扫描 中 几 个 索引 的 输出 可 以 
通过 AND 或 者 OR 规 则 进行 组 合 ， 因此 当 使 用 位 图 扫描 的 时 候 ， 很 难 将 独立 堆 行 抓 取 与 特定 束 
引进 行 组 合 ， 因此 ， 一 个 位 图 扫描 增加 pg_stat_all_indexes . idx_tup_read 使 用 索引 计数 ， 
并 且 增 加 pg_stat_all_tables . idx_tup_fetch 表 计 数 ， 但 不 影 


响 pg_stat_all_indexes . idx_tup_fetch 。 


Note: idx_tup_read 和 idx_tup_fetch 计算 不 同 甚 至 没有 任何 可 使 用 的 位 图 扫描 。 
A idx_tup_read 计算 从 索引 检索 的 索引 项 而 idx_tup_fetch 计算 从 表 抓 取 的 活 的 行 。 如 
果 任 何 死 的 或 尚未 提交 的 行使 用 索引 进行 抓 取 ， 或 通过 唯一 索引 扫描 避免 任何 堆 抓 取 ， 
则 后 者 较 小 。 


Table 27-7. pg_statio_all_tables 视图 


列 类 型 
relid oid 
schemaname name 
relname name 
heap_blks_read bigint 
heap_blks_hit bigint 
idx_blks_read bigint 
idx_blks_hit bigint 
toast_blks_read bigint 
toast_blks_hit bigint 
tidx_blks_read bigint 
tidx_blks_hit bigint 


表 OID 

该 表 模 式 名 

表 名 

从 该 表 中 读 取 的 磁盘 块 数 

此 表 缓 存 命 中 数 

从 表 中 所 有 索引 读 取 的 磁盘 块 数 

表 中 所 有 索引 命中 缓存 数 

此 表 的 TOAST 表 读 取 的 磁盘 块 数 〈 如 果 存 在 ) 
此 表 的 TOAST 表 命中 缓冲 区 数 〈 如 果 存 在 ) 

此 表 的 TOAST 表 索引 读 取 的 磁 瘟 块 数 ( 如 果 存 在 ) 
此 表 的 TOAST 表 索引 命中 缓冲 区 数 (如 果 存 在 ) 


pg_statio_all_tables 视图 将 包含 当前 数据 库 中 每 个 表 的 一 行 (包括 TOAST 表 ) , 显示 出 特 
定 表 |/O 的 统计 。 pg_statio_user_tables 和 pg_statio_sys_tables 视图 包含 相同 的 信息 ， 但 


是 过 滤 分 别 只 显示 用 户 和 系统 表 。 


Table 27-8. pg_statio_all_indexes 视图 


列 


relid 
indexrelid 
schemaname 
relname 
indexrelname 
idx_blks_read 


idx_blks_hit 


类 型 描述 
oid 索引 的 表 的 OID 
oid 该 索引 的 OID 
name 该 索引 的 模式 名 
name 该 索引 的 表 名 
name 索引 名 称 
bigint 从 索引 中 读 取 的 磁盘 块 数 
bigint 索引 命中 缓存 数 


pg_statio_all_indexes 视 将 包含 当前 数据 库 中 的 每 个 索引 | 行 ， 显示 特定 索引 | 的 |/O 的 统 


计 。 pg_statio_user_indexes 和 


只 显示 用 户 和 系统 索引 。 


pg_statio_sys_indexes 视图 包含 相同 的 信息 ， 但 是 过 滤 分 别 


Table 27-9. pg_statio_all_sequences 视图 


列 
relid 
schemaname 
relname 
blks_read 


blks_hit 


oid 
name 
name 
bigint 


bigint 


序列 OID 

序列 中 模式 名 

序列 名 

从 序列 中 读 取 的 磁盘 块 数 
序列 中 缓存 命中 数 


pg_statio_all_sequences 视图 包含 当前 数据 库 中 每 个 序列 的 每 一 行 ， 显示 特定 序列 关于 I/O 的 


统计 。 


Table 27-10. pg_stat_user_functions 视 


列 
funcid 
schemaname 
funcname 


calls 


total time 


self_time 


类 型 
oid 
name 
name 
bigint 


double precision 


double precision 


描述 
函数 OID 
IEAM st Z 
BAZ 


KIA AN ACR 
SRB a HR tN eat i, MED 
为 单位 。 


在 这 个 豆 数 本 身上 用 的 总 时 间 ， 不 包含 调用 其 他 男 
数 的 ， 以 毫秒 为 单位 


pg_stat_user_functions 视图 包含 每 个 跟踪 图 数 的 行 ， 显 示 关 于 玉 数 执行 的 统计 。 
track_functions 参 数控 制 真正 跟踪 的 函数 。 


Table 27-11. pg_stat_replication 视图 


列 


描述 


pid integer WAL 发 送 进程 的 ID 
usesysid oid 登陆 到 这 个 WAL 发 送 进程 的 用 户 OID 
Usename name 登陆 到 WAL 发送 进程 的 用 户 名 
application_name text 连接 到 这 个 WAL 发 送 端的 应 用 名 
客户 端 连接 到 这 个 WAL 发 送 端的 IP 
地 址 ， 如 果 这 个 字段 为 null， 它 表明 
Ji t_add iE R a . mo. 、 
a 通过 服务 器 上 Unix 套 接 字 连接 客户 
端 。 
连接 客户 端的 主机 名 ， 通 
过 client_addr 的 反 向 DNS 查找 报 
client_hostname text 2i E eee ae 
这 个 字段 对 于 IP 连 接 是 非 空 的 。 
客户 端正 在 使 用 与 WAL 发 送 端 连 接 
client_port integer 的 TCP 端 口号 ， 或 者 如 果 使 用 Unix 套 


backend_start 


timestamp with time zone 


接 字 则 为 -1 。 


这 个 进程 开始 时 的 时 间 ， 上 比如 当 客 户 
端 连接 到 这 个 WAL 发 送 端 时 。 


atare text 当前 WAL 发 送 端 状态 
sent_location text 在 这 次 连接 上 发 送 的 上 次 事务 日 志 位 
E 
write_location text 通过 备用 服务 器 写 入 到 磁盘 的 上 次 事 
务 日 志 位 置 。 
US ocation ex 通过 各 用 服务 器 刷新 到 磁盘 的 上 次 事 
flush_1l t text 务 日 志 位 置 ， 

8 上 重播 到 | 交 AYE} 
replay_location text pear 重播 到 数据 库 JERE 
sync priority integer 这 个 备用 服务 器 被 选 为 同步 各 用 的 优 

J 先 级 。 
8 Hen 该 各 用 服务 器 的 同步 状态 


pg_stat_replication 视图 包含 每 个 WAL 发 送 进程 的 每 一 行 ， 显示 发 送 端 连 接 各 用 服务 器 有 关 
复制 的 统计 。 列 出 只 直接 连接 的 各 用 ; 没有 可 用 的 下 游 各 用 服务 器 的 信息 。 


Table 27-12. pg_stat_database_conflicts 视图 


列 类 型 描述 


datid oid 数据 库 的 OID 

datname name 数据 库 名 称 

confl_tablespace bigint 由 于 删除 的 表 空 间 ， 已 经 取消 的 数据 库 中 的 查询 数量 
conf1_lock bigint 由 于 锁 超时 ， 已 经 取消 的 数据 库 中 的 查询 数 
conf1_snapshot bigint 由 于 旧 快 照 ， 已 经 取消 的 数据 库 查 询 数 
confl_bufferpin bigint 由 于 保留 区 而 取消 的 数据 库 查询 数 

confl_deadlock bigint 由 于 死 锁 已 经 被 取消 的 数据 库 中 的 查询 数 


pg_stat_database_conflicts 视图 将 包含 每 个 数据 库 的 一 行 ， 显 示 由 于 各 用 服务 器 恢复 发 生 的 
冲突 而 取消 查询 的 数据 库 范 围 统计 信息 。 这 种 视图 将 只 包含 备用 服务 器 的 信息 ， 因 为 在 主 服 
务 器 上 不 会 发 生 冲突 。 


27.2.3. Kit HR 


查看 统计 的 其 他 方式 可 以 通过 写 查 询 设置 ， 它 使 用 相同 的 底层 统计 访问 功能 用 于 上 面 显 示 的 
标准 视图 。 图 数 名 称 的 详细 信息 ， 请 参考 标准 的 视图 定义 。 (例如 ， 在 psql 中 你 可 以 发 

出 \d+ pg_stat_activity o ) 每 个 数据 库 统计 的 访 问 男 数 以 数据 库 OID 作 为 参数 识 别 报告 给 数 
EE. 每 个 表 和 索引 函数 看 成 表 或 素 引 的 OID。 每 个 函数 统计 采取 一 个 男 数 OID。 请 注意 ， 
只 有 当前 数据 库 中 的 表 ， 索 引 ， 和 画 数 可 以 看 出 这 些 功 能 。 


统计 收集 相关 的 附加 函数 列 在 Table 27-13 中 。 


Table 27-13. 附加 统计 男 数 


pg_backend_pid() 


pg_stat_get_activity’( integer’) 


pg_stat_clear_snapshot() 


pg_stat_reset() 


‘pg_stat_reset_shared (text) 





‘pg_stat_reset_single table counters (oid) 


~pg_stat_reset_single function_counters (oid) 





返回 类 型 


integer 


setof record 


void 


void 


void 


void 


void 


描述 
服务 器 进程 义理 当前 对 


如 果 声 明 为 NULL ， 则 
mantr, MERZ 
的 记录 。 返回 的 字段 


是 pg_stat_activity # 
丢弃 当前 数据 库 快照 


所 有 当前 数据 库 统计 计 
(需要 超级 用 户 权 限 ) 


重 置 一 些 集群 范围 统 讨 
于 参数 (需要 超级 用 
示 在 pg_stat_bgwriter 
调 

用 pg_stat_reset_shar 


2s, 


为 当前 数据 库 中 单一 靶 
HAS (需要 超级 用 记 


当前 数据 库 中 单一 功 前 
(需要 超级 用 户 权 限 ) 


> 


pg_stat_get_activity , pg _stat_activity 视图 的 基本 功能 返回 包含 每 个 后 端 进 程 的 下 有 可 
用 信息 的 记录 集 。 有 时 获取 这 些 信息 的 子 集 更 方便 。 在 这 种 情况 下 ， 可 以 使 用 每 个 后 端 统计 
访问 图 数 的 旧 设 置 。 这 些 都 显示 在 Table 27-14 中 。 这 些 访问 函数 使 用 后 端 D 号 ， 其 范围 从 一 
到 当前 活动 后 端 数 。 EAR pg_stat_get_backend_idset 提供 便利 方式 产生 调用 这 些 函 数 的 每 个 
活动 后 端的 每 一 行 。 比如 ， 显 示 PID 以 及 所 有 后 端的 当前 查询 : 


SELECT pg_stat_get_backend_pid(s.backendid) AS pid, 


pg_stat_get_backend_activity(s.backendid) AS query 


FROM (SELECT pg_stat_get_backend_idset() AS backendid) AS s; 


Table 27-14. 每 个 后 端 统计 函数 


pg_stat_get_backend_idset() 


pg_stat_get_backend_activity(integer) 


pg_stat_get_backend_activity_start(integer) 


pg_stat_get_backend_client_addr (integer) 


pg_stat_get_backend_client_port(integer ) 


pg_stat_get_backend_dbid(integer ) 


pg_stat_get_backend_pid(integer ) 


pg_stat_get_backend_start(integer ) 


pg_stat_get_backend_userid(integer ) 


pg_stat_get_backend_waiting(integer ) 


pg_stat_get_backend_xact_start(integer ) 


返回 类 型 


setof integer 


text 


timestamp with time zone 


inet 


integer 


oid 


integer 


timestamp with time zone 


oid 


boolean 


timestamp with time zone 


描述 


设置 当 
前 活动 
的 后 端 
IDS 
(从 1 到 
活动 后 
端 数 ) 


后 端 最 


询 开 始 
时 间 


连接 后 
端的 客 
户 端 IP 
地 址 


客户 端 
用 于 通 
讯 的 
TCP 端 
口号 


连接 后 
端的 数 
据 库 OID 
后 端 进 
程 ID 
进程 开 
始 时 间 


登陆 到 
后 端的 
用 户 OID 


如 果 后 
端正 等 
待 锁 则 
AR 
当前 事 
务 的 开 
台 时 间 


27.3. 查看 锁 
监控 数据 库 活动 的 另外 一 个 有 用 的 工具 是 plock RAR 这 样 就 允许 数据 库 管理 员 专 看 在 
锁 管 理 器 里 面 锁 的 信息 。 比如 ， 这 个 功能 可 以 用 于 : 


。 查看 当前 所 有 锁 ， 所 有 在 某 一 特定 数据 库 里 的 关系 上 的 锁 ， 所 有 在 特定 关系 上 的 锁 ， 或 
者 某 一 PostgreSQL 会 话 持 有 的 所 有 锁 。 


。 判断 当前 数据 库 里 带 有 最 多 未 批准 锁 的 关系 ( 它 很 可 能 是 数据 库 客 户 端的 竞争 源 )。 


。 判断 锁 竞争 给 数据 库 性 能 带 来 的 影响 ， 以 及 锁 竞争 随 着 整个 数据 库 流量 的 变化 所 产生 的 
变化 。 


pg_locks 视图 的 细节 在 节 Section 47.59 里 。 有 关 更 多 PostgreSQL 的 锁 和 管理 并 发 性 的 信 
息 ， 请 参考 Chapter 13。 


= mo 
27.4. a AEREN 
PostgreSQL 人 允许 对 数据 库 服务 器 进行 动态 跟踪 。 这 样 就 允许 在 代码 内 特定 的 点 上 调用 外 部 工 
具 来 跟踪 执行 过 程 。 


许多 跟踪 点 (也 被 称 为 "探头 ") 已 经 插入 在 源 代 码 中 了 ， 这 些 探 针 的 目的 是 被 用 于 数据 库 开 发 者 
和 管理 员 ， 默 认 情 况 下 ， 探头 不 编译 成 PostgreSQL ; 用 户 必 须 运 行 配置 脚本 时 明确 启用 它 
们 。 


目前 ， 只 有 DTrace 支 持 实用 工具 ， 在 写 这 的 时 候 ， 它 可 在 Solaris, Mac OS X, FreeBSD, 
NetBSD 和 Oracle Linux 上 使 用 。 SystemTap 项 目 为 Linux 还 提供 了 一 个 DTrace 的 等 效 并 且 也 
是 可 用 的 。 通过 改变 src/include/utils/probes.h 中 的 宏 命令 定义 为 支持 其 他 的 动态 跟 踩 工 
具 在 理论 上 是 可 能 的 。 


27.4.1. 编译 动态 跟踪 支持 


跟踪 点 是 默认 禁止 的 ， 你 必须 明确 告诉 配置 脚本 以 使 得 PostgreSQL 中 的 探 关 可用。 使 
用 --enable-dtrace 选项 来 启用 DTrace 支 持 。 参见 Section 15.4 获 取 更 多 信息 。 


27.4.2. 内 畦 跟踪 点 


Table 27-15 显 示 的 是 在 源 代码 中 提供 的 标准 跟踪 点 ，Table 27-16 显 示 探 测 中 使 用 的 类 型 。 
更 多 探测 可 以 被 添加 以 提高 PostgreSQL 的 观测 性 。 


Table 27-15. 内 和 置 DTrace 跟 踪 
名 字 参数 描述 


al (LocalTransactionld) ”开始 新 的 事务 触发 探测 器 。arg0 是 事务 ID。 


transaction- ee 当 事 务 成 功 完成 时 触发 探测 器 ，arg0 是 事务 
commit ID. 

transaction- iocaltrangactionid) 当 事 务 未 成 功 完成 时 触发 探测 器 ，arg0 是 事务 
abort ID. 

query-start (const char *) 开始 查询 处 理 时 触发 探测 器 ，arg0 是 查询 字符 
query-done (const char *) oo eee arg0 是 查询 字 


query-parse- | (const char *) 当 开 始 查询 解析 时 触发 探测 器 ，arg0 是 查询 字 
符 


Start 


o 


query-parse- 
done 


query- 
rewrite-start 


query- 
rewrite-done 


query-plan- 
start 


query-plan- 
done 


query- 
execute-start 


query- 
execute- 
done 


statement- 
status 


checkpoint- 
start 


checkpoint- 
done 


clog- 
checkpoint- 
start 


clog- 
checkpoint- 
done 


subtrans- 
checkpoint- 
start 


subtrans- 
checkpoint- 
done 


multixact- 
checkpoint- 
start 


multixact- 
checkpoint- 


(const char *) 


(const char *) 


(const char *) 


(const char *) 


(int) 


(int, int, int, int, int) 


(bool) 


(bool) 


(bool) 


(bool) 


(bool) 


(bool) 


查询 解析 完成 时 触发 探测 器 ，arg0 是 查询 字符 


o 


启动 查询 重 写 时 触发 探测 器 。arg0 是 查询 字符 


o 


当 查 询 重 写 完成 时 触发 探测 器 ，arg0 是 查询 字 
符 串 。 


查询 规划 开始 时 触发 探测 器 。 


查询 规划 完成 时 触发 探测 器 。 





执行 规划 开始 时 将 触发 的 探测 器 


执行 规划 完成 时 将 触发 的 探测 器 


服务 进程 随时 更 
新 pg_stat_activity . status 时 触发 的 探测 


器 。 arg0 是 一 个 新 的 状态 字符 串 


检查 点 开始 时 触发 的 探测 器 。arg0 可 以 逐 位 标 
记 以 区 分 不 同 的 检查 点 类 型 ， 如; shutdown, 
immediate， 或 force。 


检查 点 完成 时 触发 的 探测 器 (触发 探测 器 列 出 
检查 点 处 理 过 程序 列 中 的 下 一 个 探测 器 ) 。 
arg0 表 示 要 写 入 的 缓冲 区 的 数目 。arg1 表 示 总 
的 缓冲 区 的 数目 。 arg2，arg3 和 arg4 包 含 了 增 
加 ， 删 除 和 循环 回收 的 xlog 文 件 的 数目 。 


一 个 检查 点 的 CLOG 部 分 开始 时 触发 的 探测 器 。 
arg0 对 正常 检查 点 是 真 ， 对 关闭 检查 点 是 假 。 


当 一 个 检查 点 的 CLOG 部 分 完成 时 触发 的 探测 
器 。 arg0 的 含义 与 CLOG-checkpoint-start 一 
样 。 


当 一 个 检查 点 的 SUBTRANS 部 分 开始 时 触发 的 
探测 器 。 arg0 对 正常 检查 点 是 真 ， 对 关闭 检查 
点 是 假 。 


当 一 个 检查 点 的 SUBTRANS 部 分 完成 时 触发 的 
探测 器 。 arg0 的 含义 与 SUBTRANS- 
checkpoint-start 一 样 。 


当 一 个 检查 点 的 MultiXact 部 分 开始 时 触发 探测 
器 。 arg0 对 正常 检查 点 表示 真 ， 对 关闭 检查 点 
表示 假 。 


当 一 个 检查 点 的 MultiXact 部 分 完成 时 触发 的 探 
测 器 ， arg0 的 含义 与 multixact-checkpoint-start 


done 


buffer- 
checkpoint- 
start 


buffer-sync- 
start 


buffer-sync- 
written 


buffer-sync- 
done 


buffer- 
checkpoint- 
sync-start 


buffer- 
checkpoint- 
done 


twophase- 
checkpoint- 
start 


twophase- 
checkpoint- 
done 


buffer-read- 
start 


buffer-read- 
done 


(int) 


(int, int) 


(int) 


(int, int, int) 


(ForkNumber, 
BlockNumber, Oid, 
Oid, Oid, int, bool) 


(ForkNumber, 
BlockNumber, Oid, 
Oid, Oid, int, bool, 
bool) 


(ForkNumber, 


一 样 。 


开始 一 个 检查 点 的 缓冲 区 写 部 分 时 触发 的 探测 
器 。 arg0 持 有 逐 位 标识 以 区 分 不 同 的 检查 点 类 
型 ， 如 shutdown，immediate 或 force。 


检查 点 期 间 ， 开 始 写 脏 缓冲 区 时 触发 的 探测 器 
(在 识别 出 那个 缓冲 区 必须 写 之 后 ) 。 arg0 表 
示 总 缓冲 区 数 ，arg1 表 示 当 前 脏 的 ， 需 要 写 的 
缓冲 区 数 。 


在 检查 点 期 间 ， 每 个 缓冲 区 都 被 守 了 之 后 触发 
的 探测 器 ，arg0 表 示 缓 冲 区 的 ID 号 。 


当 所 有 脏 缓 冲 被 写 之 后 触发 的 探测 器 。 arg0 表 
示 总 缓冲 区 的 数目 。 arg1 表 示 检 查 点 进程 实际 
写 的 缓冲 区 数 。 arg2 表 示 期 望 写 的 数目 (arg1 的 
buffer-sync-start) ; 任何 的 不 同 会 导致 另 一 个 进 
程 在 检查 点 发 生 时 刷新 缓冲 区 。 


当 完 成 将 脏 缓 冲 区 写 入 到 内 核 ， 并 且 还 没有 发 
出 fsync 请 求 之 前 触发 的 探测 器 。 


当 同 步 缓冲 区 到 磁 妆 完成 时 触发 的 探测 器 


当 一 个 检查 点 的 两 相 阶 段 状 态 部 分 开始 时 触发 
的 探测 器 。 


当 一 个 检查 点 的 两 相 阶 段 状 态 部 分 完成 时 触发 
的 探测 器 。 


当 开 始 一 次 缓冲 区 读 时 触发 的 探测 器 。 arg0 和 
arg1 包 含 page 块 的 锁 和 派生 的 子 进程 数 (如 果 
是 一 个 关系 扩展 请 求 ，arg1 会 是 -1) 。 arg2， 
arg3 和 arg4 包 含 表 空间 ， 数 据 库 和 关系 OID， 以 
识别 关系 。 arg5 是 为 局 部 缓冲 创建 临时 关系 时 
后 端 ID， 或 者 共享 缓冲 区 InvalidBackendld 
arg6 对 关系 扩展 请 求 表 示 真 ， 对 正常 读 表 
示 假 。 


当 完 成 一 次 缓冲 区 读 时 触发 的 探测 器 。 arg0 和 
arg1 包 含 page 块 的 锁 和 派生 的 子 进程 数 (GOR 
是 一 个 关系 扩展 请 求 ，arg1 会 表示 新 增 锁 的 数 
目 ) 。 arg2，arg3 和 arg4 包 含 表 空间 ， 数 据 库 
和 关系 OID， 以 识别 关系 。 arg5 是 为 局 部 缓冲 
创建 临时 关系 时 后 端 ID， 或 者 共享 缓冲 区 
InvalidBackendld (-1)。 arg6 对 关系 扩展 请 求 表 
示 真 ， 对 正常 读 表示 假 。 如 果 池 中 有 缓冲 区 ， 
则 arg7 表 示 真 ， 反 之 表示 假 。 


在 发 出 共享 缓冲 区 的 任意 写 入 请 求 时 触发 的 探 


buffer-flush- 
start 


buffer-flush- 
done 


buffer-write- 
dirty-start 


buffer-write- 
dirty-done 


wal-buffer- 
write-dirty- 
start 


wal-buffer- 
write-dirty- 
done 

xlog-insert 


xlog-switch 
smgr-md- 


read-start 


smgr-md- 
read-done 


smgr-md- 
write-start 


(ForkNumber, 
BlockNumber, Oid, 
Oid, Oid) 


(ForkNumber, 
BlockNumber, Oid, 
Oid, Oid) 


(ForkNumber, 
BlockNumber, Oid, 
Oid, Oid) 


(ForkNumber, 
BlockNumber, Oid, 
Oid, Oid) 


() 


() 


(unsigned char, 
unsigned char) 


() 


(ForkNumber, 
BlockNumber, Oid, 
Oid, Oid, int) 


(ForkNumber, 
BlockNumber, Oid, 
Oid, Oid, int, int, int) 


(ForkNumber, 
BlockNumber, Oid, 
Oid, Oid, int) 


测 器 。 arg0 和 arg1 包 含 分 又 和 页 中 块 数 。 
arg2，arg3 和 arg4 包 含 表 空间 ， 数 据 库 和 关系 
OID， 以 识别 关系 。 


当 完 成 一 条 写 要 求 时 触发 的 探测 器 。 需要 注意 
Ne, 它 只 影响 将 数据 传递 到 内 核 参数 的 时 
H; 实际 上 ， 它 不 会 写 到 磁盘 上 。 这 个 参数 与 
buffer-flush-start 一 致 。 


当 服 务 器 进程 开始 写 脏 缓冲 区 时 触发 的 探测 
器 。 如 果 经 常 发 生 ， 表 示 shared_buffers 太 
小 ， 或 需要 调整 bgwriter 控 制 参数 。 arg0 和 
arg1 包 含 分 又 和 页 中 的 块 数 。 arg2，arg3 和 
arg4 包 含 表 空间 ， 数据 库 和 关系 OID， 以 识别 


当 完 成 脏 缓 冲 区 写 时 触发 的 控 测 器 。 参 数 与 
buffer-write-dirty-start 一 样 。 


当 服 务 器 进程 开始 写 脏 WAL 缓 冲 时 触发 的 探测 
器 (此 时 WAL 缓 冲 区 已 满 ) 。 如 果 经 常 发 生 ， 
应 该 是 Wal_buffers 设 置 的 太 小 了 。 


当 完 成 一 次 脏 WAL 写 时 触发 的 探测 器 。 


当 插 入 一 条 WAL 记 录 时 触发 的 探测 器 。 arg0 表 
示 记 录 的 rm id。 arg1 包 含 信息 标志 。 


当 要 求 进行 WAL 切 换 时 触发 的 探测 器 。 


开始 从 一 个 关系 中 读 取 锁 时 触发 的 探测 器 。 
arg0 和 arg1 包 含 page 块 的 锁 和 派生 的 子 进程 
数 。 arg2，arg3 和 arg4 包 含 表 空间 ， 数 据 库 和 
关系 OID， 以 识别 关系 。arg5 是 为 局 部 缓冲 创 
建 临 时 关系 时 的 后 端 ID， 或 者 共享 缓冲 
InvalidBackendld (-1) 


当 一 个 锁 读 取 完成 时 触发 的 探测 器 。 arg0 和 
arg1 包 含 page 块 的 锁 和 派生 的 子 进程 数 。 

arg2，arg3 和 arg4 包 含 表 空间 ， 数据 库 和 关系 
OID， 以 识别 关系 。 arg5 是 为 局 部 缓冲 创建 临 
时 关系 时 的 后 端 ID， 或 者 共享 缓冲 
InvalidBackendld (-1)， 而 arg6 表 示 实 际 读 取 的 
而 arg7 是 要 求 数 (如 果 不 一 样 会 报 

错 


当 向 一 个 关系 中 写 入 锁 时 触发 的 探测 器 。 arg0 
和 arg1 包 含 page 块 的 锁 和 派生 的 子 进 程 数 。 
arg2，arg3 和 arg4 包 含 表 空间 ， 数 据 库 和 关系 
OID， 以 识别 关系 。 arg5 是 为 局 部 缓冲 创建 虱 
时 关系 时 的 后 端 ID， 或 者 共享 缓冲 
InvalidBackendld (-1). 





smgr-md- 
write-done 


sort-start 


sort-done 


lwlock- 
acquire 


Iwlock- 
release 


lwlock-wait- 
start 


Iwlock-wait- 
done 


lwlock- 
condacquire 


lwlock- 
condacquire- 
fail 


lock-wait- 
start 


(ForkNumber, 
BlockNumber, Oid, 
Oid, Oid, int, int, int) 


(int, bool, int, int, 
bool) 


(bool, long) 


(LWLockld, 
LWLockMode) 


(LWLockld) 


(LWLockld, 
LWLockMode) 


(LWLockld, 
LWLockMode) 


(LWLockld, 
LWLockMode) 


(LWLockld, 
LWLockMode) 


(unsigned int, 
unsigned int, 
unsigned int, 
unsigned int, 
unsigned int, 
LOCKMODE) 


(unsigned int, 
unsigned int, 


当 一 个 锁 写 进程 完成 时 触发 的 探测 器 。 arg0 和 
arg1 表 示 page 块 的 锁 和 派生 的 子 进程 数 。 

arg2，arg3 和 arg4 包 含 表 空间 ， 数 据 库 和 关系 
OID， 以 识别 关系 。 arg5 表 示 为 局 部 缓冲 创建 
临时 关系 时 的 后 端 ID， 或 者 共享 缓冲 
InvalidBackendld (-1)， 而 arg6 表 示 实 际 读 取 的 
而 arg7 是 要 求 数 《如 果 不 一 样 会 报 

a a 


排序 操作 开始 时 触发 的 探测 器 。 arg0 表 示 堆 ， 
索引 或 者 基准 点 。 arg1 对 强制 唯一 值 表 示 真 。 
arg2 表 示 键 列 的 数目 。 arg3 表 示人 允许 使 用 的 内 
FREA 〈 以 千 字 节 为 单位 ) 。 如 果 要 求 随机 访 
问 排序 结果 ， 那 么 arg4 表 示 真 。 


排序 操作 结束 时 触发 的 探测 器 。 arg0 对 外 部 排 
序 表 示 真 ， 内 部 排序 表示 假 。 arg1 表 示 用 于 一 
个 外 部 排序 的 磁盘 锁 的 数目 ， 或 用 于 一 个 内 部 
排序 的 ， 以 千 字 节 为 单位 的 内 存 数目 。 


当成 功 获得 一 个 LWLock 时 触发 的 探测 器 。 arg0 
是 LWLock 的 ID 号 ，arg1 表 明 请 求 的 锁 模 式 ， 要 
么 独占 要 么 共享 


LWLock 释 放 时 触发 的 探测 器 (但 是 请 注意 任何 
发 布 的 等 待 者 还 未 觉醒 )。 arg0 表 示 LWLock 的 


IDS 


当 不 能 立即 获得 LWLock 锁 ， 同 时 服务 进程 进入 
等 待 时 触发 的 探测 器 。 arg0 是 LWLock 的 ID 号 ， 
arg1 表 明 请 求 的 锁 模 式 ， 要 么 独占 要 么 共享 。 


当 从 一 个 LWLock 锁 中 释放 服务 进程 时 触发 的 探 
测 器 〈 实 际 上 没有 进行 锁 ) o arg0 是 LWLock 的 
ID 号 ，arg1 表 明 请 求 的 锁 模 式 ， 要 么 独占 要 么 
共享 。 

当成 功 获得 一 个 LWLock 时 触发 的 探测 器 (已 声 
明 调 用 无 需 等 待 ) 。 arg0 是 LWLock 的 ID 号 ， 
arg1 表 明 请 求 的 锁 的 模式 ， 要 么 独占 要 么 共 


Fo 


当 没 有 成 功 获得 一 个 LWLock 时 触发 的 探测 器 
(已 声明 调用 无 需 等 待 ) 。 arg0 是 LWLock 的 ID 
号 ，arg1 和 表明 请 求 的 锁 的 模式 ， 要 人 么 独占 要 么 


共享 。 


当 一 个 重量 级 锁 (Imgr 锁 ) 的 请 求 开 始 等 待 
(因为 无 法 获得 锁 ) 时 触发 的 探测 器 。 arg0 到 
arg3 是 辨别 被 锁定 对 象 的 标签 字段 。arg4 指 出 
被 锁 对 象 的 类 型 。 arg5 表 示 请 求 的 锁 类 型 。 


lock-wait- unsigned int, 当 一 个 重量 级 锁 (Imgr 锁 ) 的 请 求 结束 等 待 时 


done unsigned int, 触发 的 探测 器 ， 参数 与 lock-wait-start 一 样 。 
unsigned int, 
LOCKMODE) 
deadlock- NT HIEN 器 发 现 4 fit 、 HHEN 器 
pe () 当 死 锁 探测 器 发 现 死 锁 时 触发 的 探测 


Table 27-16. 定义 用 于 探测 器 参数 的 类 型 


E 
LocalTransactionld 
LWLockld 
LWLockMode 
LOCKMODE 


BlockNumber 
Oid 
ForkNumber 


bool 


27.4.3. 使 用 跟 踩 点 


下 面 的 例子 显示 了 一 个 分 析 事 务 次 数 的 DTrace 脚 本 ， 


的 pg_stat_database 快照 Ro 


#!/usr/sbin/dtrace -qs 
postgresql$1:::transaction-start 


@start["Start"] = count(); 
self->ts = timestamp; 


} 


postgresql$1:::transaction-abort 


@abort["Abort"] = count(); 


postgresql$1: ::transaction-commit 

/self->ts/ 

{ 
@commit["Commit"] = count(); 
@time["Total time (ns)"] = sum(timestamp 
self ->ts=0; 


例如 示范 D 脚 本 执行 时 ， 如 输出 : 


unsigned int 
int 
int 
int 
unsigned int 
unsigned int 
int 


char 


可 以 用 来 代替 性 能 测试 之 前 和 之 后 


- self->ts); 


# ./txn_count.d ‘pgrep -n postgres” or ./txn_count.d <PID> 


AC 

Start 71 
Commit 70 
Total time (ns) 2312105013 


Note: SystemTap 为 跟踪 脚本 使 用 一 个 不 同 的 标记 而 不 是 Dtrace， 即使 底层 的 跟踪 点 是 
兼容 的 。 有 一 点 需要 注意 ， 在 这 样 写 的 时 候 ，SystemTap 脚 本 必须 使 用 双 下 划 线 代替 连 
字符 来 指向 探测 器 名 。 希望 在 未 来 SystemTap 的 版 本 中 修复 。 





你 应 该 记 住 DTrace 脚 本 需要 仔细 的 编 守 和 充分 的 调试 ， 否则 收集 到 的 跟踪 信息 可 能 毫 无 意 
Lo 大 多 数 情况 下 问题 是 手段 是 错误 的 而 不 是 底层 系统 。 在 讨论 使 用 动态 跟踪 发 现 的 信息 
时 ， 应 确保 包含 允许 检查 和 讨论 使 用 的 脚本 。 


更 多 的 示例 脚本 可 以 在 PgFoundry dtrace project 中 找到 。 


27.4.4. 定义 新 的 跟踪 点 


开发 者 可 以 在 代码 中 任意 位 置 定义 新 的 跟踪 点 ， 当然 这 要 重新 编译 之 后 才能 生效 。 下 面 是 用 
于 新 探测 器 插入 步 又 : 


1. 通过 探头 决定 探头 名 字 和 可 利用 数据 。 
2 新 增 探头 定义 为 src/backend/utils/probes.d 


3. 包括 pg_trace.h ， 如 果 已 经 不 在 模块 中 包含 探测 点 ， 并 且 在 所 需 源 代码 中 期 望 的 位 置 插 


入 TRACE_POSTGRESQL 探测 宏 。 
4. 重新 编译 和 验证 新 探头 是 可 用 的 。 
例子 : 下 面 是 一 个 例子 ， 你 将 如 何 添加 一 个 探头 通过 事务 ID 追 踪 所 有 新 的 事务 。 
1. 决定 探测 器 将 被 命名 为 transaction-start 并 且 需 要 LocalTransactionld 类 型 参数 。 


2. 新 增 探头 定义 为 src/backend/utils/probes.d : 


probe transaction__start(LocalTransactionId); 


注意 探测 器 名 字 中 的 双 下 划 线 的 使 用 。 在 使 用 探测 器 的 DTrace 脚 本 中 ， 需要 用 一 个 连 字 
符 来 替换 双 下 划 线 ， 因此 ， 对 用 户 而 言 ， transaction-start 是 文档 名 。 


3. 在 编译 时 ， transaction start 被 转换 成 一 个 宏 调用 
TRACE_POSTGRESQL_TRANSACTION_START (注意 这 里 是 单 下 划 线 ) ， 可 以 从 pg_trace.h 中 获 
得 。 将 宏 调 用 放 在 源 代码 中 的 合适 位 置 。 在 这 种 情况 下 ， 类 似 于 下 面 : 


TRACE_POSTGRESQL_TRANSACTION_START(vxid.localTransactionId); 


4. 在 重新 编译 和 运行 新 的 二 进 制 文件 之 后 ， 通过 运行 下 面 的 DTrace 命 令 来 检查 新 增 的 探测 
REO VA. 应 该 得 到 类 似 下 面 的 结 


# dtrace -ln transaction-start 


ID PROVIDER MODULE FUNCTION NAME 
18705 postgresql49878 postgres StartTransactionCommand transaction-start 
18755 postgresql49877 postgres StartTransactionCommand transaction-start 
18805 postgresql49876 postgres StartTransactionCommand transaction-start 
18855 postgresql49875 postgres StartTransactionCommand transaction-start 
18986 postgresql49873 postgres StartTransactionCommand transaction-start 


向 C 代 码 中 添加 跟踪 宏 时 ， 有 一 些 注 意 事 项 ， 见 下 文 : 
。 需要 注意 的 是 ， 为 探测 器 参数 声明 的 数据 类 型 要 匹配 宏 中 可 用 的 数据 类 型 ， 否则 会 发 生 
编译 错误 。 
。 在 大 多 数 平台 上 ， 如 果 编 译 PostgreSQL 时 带 有 --enable-dtrace 选项 ， 无 论 何 时 通过 宏 
来 控制 时 ， 都 会 估算 该 跟踪 宏 的 参数 ， 即使 没有 进行 跟踪 。 通 常 不 需要 担心 是 否 你 只 是 
UN 


报告 一 些 局 部 变量 的 值 。 CELE MES, WREE 
考虑 通过 检查 是 否 真 的 开启 跟踪 来 保护 宏 : 


if (TRACE_POSTGRESQL_TRANSACTION_START_ENABLED( ) ) 
TRACE_POSTGRESQL_TRANSACTION_START(some_function(...)); 


每 个 跟踪 宏 都 有 一 个 相应 的 ENABLED 宏 。 


Chapter 28. 监控 磁 瘟 使 用 情 ， 


Table of Contents 


e 28.1. 判断 磁 瘟 的 使 用 量 
© 28.2. 人 磁 衣 满 导 致 的 失效 


本 章 讨 论 如 何 观察 PostgreSQL 数 据 库 系统 的 磁 瘟 使 用 情况 。 


28.1. 判断 磁盘 的 使 用 量 


每 个 表 都 有 一 个 主 堆 (primary heap) 磁 瘟 文 件 ， 大 多 数 数据 都 存储 在 这 里 。 如 果 一 个 表 存 在 值 

可 能 会 很 长 的 字段 ， 则 另外 还 有 一 个 用 于 存储 因为 数值 太 长 而 不 适合 存储 在 主 表 中 的 数据 的 
TOAST 文 件 (参阅 Section 58.2)。 如 果 存 在 这 个 扩展 表 ， 那 么 将 会 同时 存在 一 个 TOAST 索 
引 。 当然 ， 同 时 还 可 能 有 索引 和 基 表 关联 。 每 个 表 和 索引 都 存放 在 单独 的 磁盘 文件 里 (超过 
1GB 可 能 会 被 分 割 成 多 个 )。 这 些 文 件 的 命名 原则 在 Section 58.1 里 描述 。 


可 以 使 用 三 种 方法 监视 磁盘 空间 : 使 用 Table 9-64 中 列 出 的 SQL KA 使 用 oid2name 模 块 、 
或 使 用 手动 检查 系统 表 。SQL 画 数 是 最 简单 的 方法 并 且 一 般 推 荐 使 用 它 。 本 节 其 余部 分 显示 
了 如 何 通过 检查 系统 表 来 监视 磁盘 空间 。 


在 最 近 刚 刚 清理 (或 者 分 析 过 ) 的 数据 库 上 使 用 psql 的 话 ， 可 以 使 用 查询 来 查看 任意 表 的 磁 角 使 
用 : 


SELECT pg_relation_filepath(oid), relpages FROM pg_class WHERE relname = 'customer'; 


pg_relation_filepath ! relpages 
base/16384/16806 i 60 
(1 row) 


每 个 页 通常 都 是 8K $4. SER, relpages 只 被 vacuum, ANALYZE 和 几 个 DDL 命 合 ( 例 
如 cREATE INDEX ) 更 新 。 如 果 你 想 直 接 检 查 表 的 磁盘 文件 ， 那么 可 以 使 用 文件 路 径 名 。 


要 显示 TOAST 表 使 用 的 空间 ， 我 们 可 以 使 用 一 个 类 似 下 面 这 祥 的 查询 : 


SELECT relname, relpages 
FROM pg_class, 
(SELECT reltoastrelid 
FROM pg_class 
WHERE relname = 'customer') AS ss 
WHERE oid ss.reltoastrelid OR 
oid (SELECT reltoastidxid 
FROM pg_class 
WHERE oid = ss.reltoastrelid) 
ORDER BY relname; 


relname l relpages 
pg_toast_16806 i 0 
pg_toast_16806_index | 1 


也 可 以 很 容易 地 显示 索引 的 尺寸 : 


SELECT c2.relname, c2.relpages 
FROM pg_class c, pg_class c2, pg_index i 
WHERE c.relname = 'customer' AND 
c.oid = i.indrelid AND 
c2.oid = i.indexrelid 
ORDER BY c2.relname; 


relname | relpages 


customer_id_indexdex | 26 


很 容易 用 下 面 的 信息 找 出 最 大 的 表 和 索引 : 


SELECT relname, relpages 
FROM pg_class 
ORDER BY relpages DESC; 


relname | relpages 


bigtable | 3290 
customer | 3144 


28.2. fi & FMAM 


一 个 数据 库 管 理 员 最 重要 的 磁盘 监控 任务 就 是 确保 磁盘 不 会 写 满 。 磁盘 写 满 可 能 不 会 导致 数 
据 的 丢失 ， 但 它 肯 定 会 导致 系统 进一步 使 用 的 问题 。 如 果 WAL 文件 也 在 同一 个 磁盘 上 ( 缺 省 
配置 就 是 这 样 )， 则 会 发 生 数 据 库 服务 器 恐慌 ， 并 且 停止 运行 。 


如 果 你 不 能 通过 删除 其 它 东 西 来 释放 磁盘 空间 ， 那么 你 可 以 通过 使 用 表 空 间 把 一 些 数据 库 文 
件 移动 到 其 它 文件 系统 上 去 。 参阅 Section 21.6 获 取 更 多 信息 。 


Tip: 有 些 文件 系统 在 快要 写 满 的 时 候 性 能 会 急剧 恶化 ， 因 此 不 要 等 到 磁盘 完全 写 满 时 才 
采取 行动 。 





如 果 你 的 系统 支持 针对 每 个 用 户 的 磁 旬 限额， 那么 数据 库 自然 也 将 受制 于 此 ， 超过 限额 的 影 
响 和 完全 用 光 磁 总 空间 是 完全 一 样 的 。 


Chapter 29. 可 靠 性 和 预 写 式 日 志 


Table of Contents 
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可 靠 性 

预 写 式 日 志 (WAL) 
异步 提交 

WAL 配置 

WAL 内 部 


本 章 解 释 预 写 式 日 志 如 何 用 于 获得 有 效 性 和 可 靠 性 操作 。 


29.1. 可 靠 性 


可 靠 性 是 任何 严肃 的 数据 库 系 统 的 重要 属性 ，PostgreSQL 尽 一 切 可 能 来 保证 可 靠 的 操作 。 可 
靠 性 操作 的 一 个 方面 是 所 有 已 提交 的 数据 都 应 该 存储 在 一 个 非 易 失 的 区 域 ， 这 样 就 不 会 因为 
电力 失效 、 操作 系统 崩溃 、 硬 件 失效 (除了 非 易 失 区 域 自身 失效 之 外 ) 等 原因 导致 数据 丢失 。 
向 计算 机 的 永久 存储 ( 磁 瘟 驱动 器 或 者 等 效 的 东西 ) 成 功 写 入 数据 通常 可 以 满足 这 个 要 求 。 实 
际 上 ， 即 使 计算 机 完全 失效 ， 只 要 磁盘 驱动 器 生存 下 来 ， 那 么 它们 就 可 以 移动 到 另外 一 台 类 
似 硬件 的 计算 机 上 ， 而 所 有 已 经 提交 的 事务 将 保持 原状 。 


周期 性 地 强制 数据 写 人 磁盘 盘 片 看 上 去 像 一 件 简单 的 操作 ， 但 实际 上 不 是 。 因为 磁盘 驱动 器 
比 内 存 和 CPU 要 慢 许 多 ， 在 计算 机 的 主 存 和 磁盘 瘟 片 之 间 存 在 多 层 缓冲 。 首先 ， 有 操作 系 
统 的 缓冲 区 内 存 ， 它 缓冲 常用 的 磁盘 块 并 且 组 合 对 磁盘 写 入 的 请 求 。 幸 运 的 是 ， 所 有 操作 系 
统 都 给 予 应 用 一 个 强制 从 缓冲 区 写 入 磁 瘟 的 方法 ，PostgreSQL 使 用 了 该 特性 ( 参 

阅 Wal_sync_method 参 数 )。 


然后 ， 在 磁盘 驱动 器 的 控制 器 上 可 能 还 有 一 个 缓冲 ; 特别 是 在 RAID 控 制 卡 上 更 为 常见 。 这 些 
缓冲 区 中 ， 有 些 是 透 过 式 写 和信， 意思 是 守信 动作 在 到 达 的 同时 写 人 到 磁盘 上 。 其 它 则 是 回 写 
式 写 人 ， 意 思 是 数据 将 在 稍 后 写 人 人 驱动器。 这样 的 缓冲 区 是 可 靠 性 的 危害 ， 因为 磁盘 控制 器 
上 的 内 存 是 易 失 的 ， 在 发 生 电 力 失效 的 情况 下 会 丢失 其 中 的 内 容 。 好 一 些 的 控制 器 卡 备 有 电 
池 备 份 单元 (BBUs)， 可 以 在 系统 电力 失效 的 情况 下 提供 电力 。 在 电力 恢复 之 后 ， 这 些 数据 将 
会 被 写 人 磁盘 驱动 器 。 


最 后 ， 大 多 数 磁盘 驱动 器 自身 也 有 缓冲 区 。 有 些 是 透 过 式 的 ， 有 些 是 回 写 式 的 。 和 磁盘 控制 
器 一 样 ， 回 写 式 的 磁盘 缓冲 区 也 存在 数据 丢失 的 问题 。 消费 级 别 的 IDE 和 SATA 驱动 器 特别 
容易 包含 回 写 式 缓冲 ， 在 掉 电 的 情况 下 很 容易 丢失 数据 。 很 多 固态 磁盘 (SSD) 也 有 易 失 的 回 
写 式 缓冲 。 


这 些 缓存 通常 可 以 禁用 ; 然而 ， 这 样 做 的 方法 会 因 操 作 系 统 和 了 驱动 类 型 而 不 同 。 


e 在 Linux 上 ，IDE 和 SATA 了 驱动 器 可 以 使 用 hdparm -1 查询 ; 如 果 在 write cache 后 面 有 一 
个 * 则 写 缓存 是 开启 的 。 hdparm -w © 可 以 用 来 关闭 写 缓 存 。SCSI 了 驱动器 可 以 使 
用 sdparm 查询 。 使 用 sdparm --get=wcE 来 检查 写 缓存 是 否 打 开 ， 使 
用 sdparm --clear=wcE 来 关闭 写 缓 存 。 


e 在 FreeBSD 上 ，|IDE 了 驱动 器 可 以 使 用 atacontrol 查询 ， BTE /boot/loader.conf 里 
用 hw.ata.wc=9 来 关闭 ; SCSI 驱 动 器 可 以 使 用 camcontrol identify 查询 ， 写 缓存 也 同时 
查询 ， 并 且 当 可 用 时 使 用 sdparm 改变 状态 。 


e 在 Solaris 上 ， 和 磁盘 写 缓存 通过 format -e 来 控制 。 (Solaris ZFS 文 件 系 统 对 于 打开 磁盘 
写 缓 存 是 安全 的 ， 因 为 它 发 行 自己 的 磁盘 缓存 刷新 命令 。 ) 


e 在 Windows 上 ， 如 果 wal_sync_method 为 open_datasync (默认 值 ) , 写 缓 存 可 以 通过 取 
Axe 
FH My Computer\open\**_disk drive_ \Properties\Hardware\Properties\Policies\Enable 
write caching on the disk 来 禁用 。 或 者 ， 设 
i@ wal_sync_method 为 fsync 或 fsync_writethrough 来 阻止 写 缓 存 。 


e 在 Mac OS X 上 ， 写 缓存 可 以 通过 设置 wal_sync_method 为 fsync_writethrough 来 阻止 。 


最 近 的 SATA 了 驱动 器 (跟随 ATAPI-6 或 以 后 的 ) 提供 一 个 驱动 器 缓存 刷新 命令 

( FLUSH CACHE EXT )， 而 SCSI 驱 动 器 长 期 以 来 支持 一 个 类 似 的 命令 SYNCHRONIZE CACHE o 这 些 
命 邻 不 能 直接 访问 PostgreSQL， 但 是 某 些 文件 系统 〈 例 如 ，ZFS，ext4) 可 以 使 用 它们 来 刷 
新 数据 到 启用 了 回 写 的 驱动 器 上 的 盘 片 上 。 不 幸 的 是 ， 这 样 的 文件 系统 只 有 在 组 合 电池 各 份 
单元 (BBU) 磁 总 驱动 器 时 行为 有 效 。 在 这 样 的 设置 中 ， 同步 命令 强制 所 有 数据 从 驱动 器 缓存 
到 磁盘 ， 消 除 BBU 的 好 处 。 你 可 以 运行 bg_test fsync 程序 来 查看 你 是 否 受 影响 。 如 果 你 受到 
影响 ，BBU 的 性 能 优势 可 以 通过 在 文件 系统 中 关 掉 写 屏 障 或 重新 配置 磁盘 控制 器 重新 获得 ， 
如 果 这 是 一 个 选项 。 如 果 关 闭 了 写 屏 障 ， 确 保 电 池 仍 然 运 行 ; 失效 的 电池 可 能 导致 数据 丢 
失 。 希望 文件 系统 和 磁盘 控制 器 设计 将 最 终 解 决 这 个 次 优 的 行为 。 


在 操作 系统 向 存储 硬件 发 出 一 个 写 请 求 的 时 候 ， 它 没有 什么 好 办 法 来 保证 数据 真正 到 达 非 易 
失 的 存储 区 域 。 实际 上 ， 确 保 所 有 存储 部 件 都 保证 数据 和 文件 系统 元 数据 的 完整 性 是 管理 员 
的 责任 。 应 该 避免 使 用 没有 电池 供电 的 回 写 缓冲 磁盘 控制 器 。 在 驱动 级 别 ， 如 果 驱 动 器 不 能 
保证 在 关闭 ( 掉 电 ) 之 前 写 信 数据， 那么 应 该 关闭 回 写 缓冲 。 如 果 你 使 用 SSD， 要 知道 这 些 默 
认 不 尊重 缓存 刷新 命令 。 你 可 以 使 用 diskchecker.pl 测试 可 靠 的 IJO 子 系统 的 行为 。 


另外 一 个 数据 丢失 的 风险 来 自 磁 盘 龟 片 写 操 作 自 身 。 磁 名 名片 会 被 分 割 为 段 ， 通 常 每 段 512 
字 节 。 每 次 物理 读 写 都 对 整个 段 进 行 操作 。 当 一 个 写 操 作 到 达 磁 盘 的 时 候 ， 它 可 能 是 512 字 
节 的 某 些 整数 倍 (PostgreSQL 通 常 一 次 宇和 信 8192 字 节 ， 或 者 16 段 ) ， 而 写 入 操作 可 能 因为 
电力 失效 而 随时 失败 ， 意味 着 某 些 512 字 节 的 段 写 入 了 ， 而 另 一 些 则 没有 。 为 了 避免 这 个 问 
题 ，PostgreSQL 在 修改 磁盘 上 的 实际 页 面 之 前 周期 性 地 把 整个 页 面 的 影像 写 入 永久 WAL 存 
储 。 这 样 ， 在 崩溃 恢复 的 时 候 ，PostgreSQL 就 可 以 从 WAL 中 恢复 部 分 写 入 的 页 面 。 如 果 你 
有 文件 系统 (比如 ZFS) 自 身 能 够 避免 部 分 页 面 写 入 ， 你 可 以 通过 关闭 full_page_writes 参数 来 
关闭 页 面 影像 功能 。 电 池 各 份 单 元 (BBU) 磁 盘 控 制 器 不 能 阻止 部 分 页 面 写 入 ， 除非 他 们 保证 
数据 以 完整 页 面 (8kB) ABBU, 


PostgreSQL 也 能 阻止 某 些 因为 硬件 错误 或 介质 失效 可 能 发 生 在 存储 驱动 器 上 的 数据 损坏 ， 比 
如 读 / 守 垃圾 数据 。 


。 在 WAL 文 件 中 的 每 个 单独 的 记录 受 CRC-32 (32-bit) 校 验 保护 ， 这 样 人 允许 我 们 判断 记录 内 
容 是 否 正确 。 当 我 们 在 崩溃 恢复 时 写 入 每 个 WAL 记 录 和 和 检查、 为 档 记 录 和 复制 时 设置 
CRC 值 。 


。 数据 页 不 是 当前 校 验 和 的 ， 尽 管 在 WAL 记 录 中 的 整个 页 面 图 像 记录 将 受到 保护 。 为 未 来 
使 用 数据 页 校 验 和 特性 ， 数 据 页 有 一 个 16 位 字段 可 用 。 


° 内 部 数据 结构 例如 pg_clog , pg_subtrans , pg_multixact , pg_serial , pg_notify , 
pg_stat , pg_snapshots 不 是 直接 校 验 和 的 ， 也 不 是 通过 全 页 面 写 入 受到 保护 的 页 面 。 
然而 ， 这 样 的 数据 结构 具有 持久 性 ， WAL 记 录 书 面 允 许 最 近 的 改变 在 崩溃 恢复 时 精确 重 
建 并 且 这 些 WAL 记 录 正 如 上 述 讨论 的 那样 受到 保护 。 


© 在 pg_twophase 中 的 个 人 状态 文件 受到 CRC-32 保 护 。 


。 临时 数据 文件 用 于 较 大 的 SQL 查询 ， 具 体 化 和 中 间 结 果 不 是 当前 校 验 和 的 ， 也 不 会 WAL 
记录 被 守 入 修改 这 些 文件 。 


PostgreSQL 不 预防 矫正 内 存 错误 ， 假 设 您 将 使 用 具有 工业 标准 纠 错 编码 (ECC) 的 内 存 操作 或 
更 好 的 保护 。 


29.2. 预 写 式 日 志 (WAL) 


预 写 式 日 志 (WAL) 是 一 种 确保 数据 完整 性 的 标准 方法 。 有 关 它 的 详细 描述 可 以 在 大 多 数 (如 果 
不 是 全 部 的 话 ) 有 关 事务 义理 的 书 中 找到 。 简 而 言 之 ， WAL 的 中 心思 想 是 对 数据 文件 的 修改 
(它们 是 表 和 索引 的 载体 ) 必须 是 只 能 发 生 在 这 些 修 改 已 经 记录 到 日 志 之 后 ， 也 就 是 说 ， 在 描 
述 这 些 变化 的 日 志 记 录 刷 新 到 永久 存储 器 之 后 。 如 果 我 们 遵循 这 个 过 程 ， 那么 就 不 需要 在 每 
次 事务 提交 的 时 候 都 把 数据 页 刷新 到 磁盘 ， 因为 在 出 现 崩溃 的 情况 下 可 以 用 日 志 来 恢复 数据 
库 : 任何 尚未 附加 到 数据 页 的 记录 都 将 先 从 日 志 记 录 中 重 做 (这 叫 向 前 滚动 恢复 ， 也 叫 
REDO)。 


Tip: 因为 WAL 在 骨 溃 之 后 恢复 数据 文件 内 容 ， 所 以 日 志文 件 系统 对 于 数据 文件 或 WAL 文 
件 的 可 靠 存 储 是 完全 没有 必要 的 。 实 际 上 ， 日 志 记录 开销 会 降低 性 能 ， 尤 其 是 日 志 记 录 
导致 文件 系统 data 刷新 到 磁盘 。 幸 运 地 ， 在 记录 日 期 期 间 的 数据 刷新 可 以 经 常用 一 个 广 
件 系统 挂 载 选 项 禁用 ， 例如 ， 在 Linux ext3 文 件 系统 上 的 data=writeback o FEARS GHA 
志文 件 系 统 确实 提高 了 启动 速度 。 








使 用 WAL 显 著 地 减少 了 磁盘 写 的 次 数 ， 因 为 只 有 日 志文 件 需要 刷新 到 磁盘 以 保证 事务 提交 
J, 而 不 是 事务 修改 的 所 有 数据 文件 。 日 志文 件 是 顺序 写 的 ， 所 以 同步 日 志 的 开销 要 远 比 同 
步 数 据 页 的 开销 小 。 对 于 许多 小 事务 修改 数据 存储 的 许多 不 同位 置 更 是 如 此 。 另 外 ， 当 服务 
器 正在 处 理 许多 小 的 并 发 事务 时 ， 日 志文 件 的 一 个 fsync 足以 提交 许多 事务 。 


WAL 还 提供 了 数据 库 在 线 备份 和 时 间 点 恢复 的 可 能 ， 就 像 Section 24.3 里 描述 的 那样 。 通 过 
JÉ WAL 文件 ， 可 以 将 数据 库 恢复 到 WAL 文件 包含 的 任意 时 刻 : 只 需要 简单 地 安装 以 前 
的 数据 库 物理 各 份 ， 然 后 重 放 WAL 到 希望 的 时 间 点 。 另外 ， 物理 各 份 还 不 必 是 数据 库 状 态 的 
一 个 即时 快照 (如 果 其 制作 花 了 较 长 时 间 的 话 )， 因 为 WAL 日 志 的 重 放 将 修复 任何 内 部 的 不 一 
致 。 


29.3. 异步 提交 


异步 提交 是 一 个 允许 事务 更 快 完 成 的 选项 ， 如 果 数 据 库 崩溃 时 ， 最 新 的 事务 可 能 会 去 失 。 在 
大 多 数 应 用 中 这 个 是 可 以 接受 的 交易 。 


如 在 前 一 节 中 所 述 ， 事 务 提 交通 常 是 同步 的 : 服务 器 等 待 事务 的 WAL 记录 刷新 到 永久 存储 

区 ， 然 后 返回 一 个 成 功 提示 到 客户 端 。 客 户 端 因 此 保证 报告 提交 的 事务 将 被 保存 ， 即使 服务 
器 立即 崩溃 。 然 而 ， 对 于 简短 的 事务 ， 延 迟 是 总 事务 时 间 的 主要 部 分 。 选 择 异 步 提 交 模 式 意 
味 着 ， 在 它 产生 的 WAL 记 录 实 际 转移 到 磁 瘟 之 前 ， 一 且 事 务 巡 辑 上 完成 之 后 服务 器 就 返回 成 
功 。 这 样 在 小 事务 的 吞吐 量 上 可 以 提供 一 个 显著 的 推动 作用 。 


异步 提交 引进 了 数据 丢失 的 风险 。 在 向 客户 端 报告 事务 完成 和 事务 实际 完成 的 时 间 点 之 间 有 
一 个 很 小 的 时 间 窗 口 (也 就 是 ， 保 证 如 果 服 务 器 崩溃 时 不 会 丢失 ) 。 因 此 如 果 客 户 端 采取 外 
部 动作 (前 提 是 假设 事务 会 被 记 下 ) ， 此 时 不 应 使 用 异步 提交 。 例 如 ， 一 个 银行 肯定 不 会 为 
一 个 ATM 分 配 现金 的 事务 使 用 异步 提交 。 但 在 多 数 情况 下 ， 如 事件 日 志 记 录 ， 不 需要 这 种 强 
力 保证 。 


使 用 异步 提交 的 风险 在 于 数据 丢失 ， 而 不 是 数据 损坏 。 如 果 数 据 库 崩 江 ， 那 么 它 会 根据 刷 入 
的 最 新 的 WAL 记 录 来 进行 恢复 。 因 此 数据 库 会 被 转 储 到 一 个 一 致 的 状态 ， 但 任何 没有 写 入 到 
磁盘 的 事务 不 能 反映 在 这 个 状态 。 因 此 最 后 的 结果 是 丢失 最 新 的 几 个 事务 。 因为 事务 是 以 提 
交 的 顺序 进行 重 放 ， 不 会 引入 非 一 致 状态 ; 例如 ， 如 果 事 务 B 所 做 的 更 改 依赖 于 前 一 个 事务 

A, 那么 丢失 A 的 效果 ， 而 B 的 效果 被 保留 是 不 可 能 的 。 


用 户 可 以 为 每 个 事务 选择 提交 模式 ， 因 此 可 以 同时 使 用 同步 和 异步 提交 事务 。 这 样 就 允许 在 
性 能 和 事务 持久 性 之 间 做 一 个 灵活 的 权衡 。 提 交 模 式 是 由 用 户 可 设 定 的 参数 
synchronous_commit 控 制 的 ， 可 以 用 任意 配置 参数 可 以 设置 的 方式 改变 。 用 于 任意 一 个 事务 
的 模式 依赖 于 事务 提交 开始 时 synchronous_commit 的 值 。 


“at 


些 实用 命令 ， 如 prop TABLE ， 会 强制 使 用 同步 提交 ， 无 论 synchronous_commit 参数 是 怎么 
设置 的 。 这 是 为 了 保证 服务 器 文件 系统 和 数据 库 逻 辑 状 态 之 间 的 一 臻 性。 支持 两 阶段 提交 的 


设 
命令 ， 如 PREPARE TRANSACTION ， 也 是 使 用 同步 提交 。 


如 果 在 一 个 异步 提交 和 写 事 务 的 WAL 记 录 中 间 时 发 生 数 据 库 骨 溃 ， 在 事务 期 间 的 修改 将 会 丢 
失 。 风 险 的 持续 时 间 会 被 限制 ， 因 为 "WAL writer" 后 台 进 程 会 每 隔 wal_writer_delay 毫 秒 就 向 
磁盘 刷 和 人 未 写 入 的 WAL 记 录 。 风险 的 实际 最 大 持续 时 间 是 三 倍 的 wal_writer_delay ， 因为 
WAL 写 进程 被 设计 为 支持 在 繁忙 时 一 次 宇和 人 所 有 块 。 


Caution 


IMMEDIATE 模 式 的 关闭 等 同 于 服务 器 月 溃 ， 因 此 会 造成 哪些 未 刷 入 的 异步 提交 的 数据 丢 


o 


异步 提交 不 同 于 设置 fsync = off. fsync 是 一 个 用 于 更 改 折 有 事物 行为 的 服务 器 端 设置 。 它 
会 禁用 所 有 PostgreSQL 中 尝试 向 数据 库 不同 部 分 同步 写 入 的 逻辑 ， 因 此 ， 一 次 系统 月 溃 〈 硬 
EIR ERR, 而 不 是 PostgreSQL 本 身 出 问题 ) 会 导致 数据 库 状 态 不 可 预知 的 骨 溃 。 
在 多 数 情况 下 ， 通 过 关闭 fsync ， 异 步 提 交会 提高 性 能 ， 但 是 不 会 有 数据 崩溃 的 风险 。 


看 起 来 ，commit_delay 和 与 异步 提交 很 相似 ， 但 实际 上 它 是 一 种 同步 提交 方法 (SLE, RY 
提交 时 会 忽略 commit_delay ) 。 在 一 次 异步 提交 党 试 向 磁盘 刷 入 WALZ 

前 ， commit_delay 会 造成 延迟 ， 希望 在 一 个 这 样 的 事务 中 执行 一 个 单独 的 刷 和 人 可 以 用 于 同一 
时 间 的 其 他 事务 提交 。 这 个 设置 可 以 看 做 一 种 在 可 以 加 入 一 个 关于 参与 单 次 刷 人 的 组 中 的 事 
务 中 提高 时 间 窗 口 的 方式 ， 来 分 捧 多 个 事务 刷新 的 开销 。 


29.4. WAL i E 


有 几 个 与 WAL 相 关 的 参数 会 影响 数据 库 性 能 。 本 节 讨 论 它 们 的 使 用 。 参阅 Chapter 18 获 取 有 
关 服 务 器 配置 参数 的 一 般 信息 。 


检查 点 是 事务 序列 中 的 点 ， 在 该 点 之 前 的 所 有 信息 都 确保 已 经 写 到 数据 文件 中 去 了 。 在 检查 
an 所 有 脏 数 据 页 都 刷新 到 磁盘 并 且 向 日 志文 件 中 写 入 一 条 特殊 的 检查 点 记录 。 (变更 记 
已 经 预先 刷新 到 WAL 文 件 了 。) 在 发 生 骨 溃 的 时 候 ， 骨 溃 恢复 过 程 查 找 最 后 的 检查 点 记 
判断 应 该 从 日 志 中 的 哪个 点 ( 称 为 redo 记录 ) 开 始 REDO 操作 ， 在 该 记录 之 前 对 数据 文 
bed 经 宇 在 磁盘 上 了 。 因 此 ， 在 检查 点 之 后 ， 任何 在 包含 redo 记录 点 之 前 
日 志 段 都 不 再 需要 ， 因 此 可 以 循环 使 用 或 者 删除 。 当 然 ， 在 进行 WAL 为 档 的 时 候 ， 这 些 日 
en einen eee 


刷新 所 有 脏 数 据 页 面 到 磁盘 的 检查 点 需求 会 导致 显著 的 MO 负载 ， 因 此 ， 检 查 点 进行 了 限制 ， 
在 下 一 个 检查 点 开始 之 前 ，1/O 在 检查 点 开始 和 结束 时 开启 ; 这 会 在 检查 点 进行 时 降低 性 能 损 
耗 。 


服务 器 的 检查 点 进程 每 checkpoint_segments 个 日 志 段 或 每 checkpoint timeout 秒 就 创建 一 1 
检查 点 ， 以 先 到 为 准 。 缺 省 设置 分 别 是 3 SRA 300 秒 (5 分 钟 ) 。 如 果 自 从 前 一 个 检查 点 
以 来 没有 WAL 写 入 ， 那么 将 跳 过 新 的 检查 点 ， 即 使 已 经 超过 了 checkpoint_timeout o (AUR 
使 用 了 WAL 凡 档 并 且 你 希望 放置 一 个 低 一 些 的 限制 在 多 久 文件 为 档 一 次 上 ， 以 限制 潜在 的 数 
HER, 你 应 该 调整 archive_timeout 参 数 而 不 是 检查 点 参数 。) 我 们 也 可 以 用 SQL 命 

43 CHECKPOINT 强制 创建 一 个 检查 点 。 


减少 checkpoint_segments 和 /或 checkpoint_timeout 会 更 频繁 的 创建 检查 点 Fro 这 样 就 允许 更 
快 的 崩溃 后 恢复 (因为 需要 重 做 的 工作 更 少 )。 不 过 ， 我 们 必须 在 更 快 的 恢复 与 更 频繁 的 刷新 
脏 数据 页 所 带 来 的 额外 开销 之 间 进 行 平衡 。 并 且 ， WRR ET full page writes( 缺 省 开启)， 
那么 还 有 其 它 的 因素 需要 考虑 。 为 了 保证 数据 页 的 一 致 性 ， 在 每 个 检查 点 之 后 的 第 一 次 数据 

页 变化 会 导致 对 整个 页 面 内 容 的 日 志 记 录 。 因此 ， 减 小 检查 点 时 间 间 隔 会 导致 输出 到 WAL 日 
志 中 的 数据 量 增加 ， 从 而 抵 销 一 部 分 使 用 间隔 的 目标 ， 并 且 无 论 如 何 都 会 产生 更 多 的 磁 瘟 MO 
操作 。 


BERT AE 首先 是 因为 它 需 要 写 出 所 有 当前 脏 缓 冲 区 ， 其 次 是 因为 导致 前 面 讨论 
过 的 额外 后 继 WAL 流量 。 因此 把 检查 点 参数 设置 得 足够 高 ， 让 检查 点 发 生 的 频率 降低 是 明智 

的 。 可 以 通过 设置 checkpoint warning 对 检查 点 参数 进行 一 个 简单 自 检 。 如 果 检 查 点 发 生 的 

间隔 接近 checkpoint_warning 秒 ， 那 么 将 向 服务 器 日 志 输 出 一 条 消息 ， 建 议 你 增 

加 checkpoint_segments 的 数值 。 偶 尔 出 现 这 样 的 警告 并 不 会 导致 警报 ， 但 是 如 果 出 现 得 太 频 

繁 ， 那 么 就 应 该 增加 检查 点 控制 参数 。 如 果 你 没有 把 checkpoint_segments 设置 得 足够 大 ， 那 

么 批量 操作 的 时 候 (比如 大 批 的 copy 传输 ) 会 导致 出 现 大 量 此 类 警告 消息 。 


为 了 避免 大 量 的 块 写 操作 塞 满 WO 系 统 ， 在 一 段 时 间 内 ， 在 检查 点 期 间 写 脏 缓 冲 。 这 个 时 间 是 
由 checkpoint_completion_target 控 制 的， 作为 检查 点 时 间 间 隔 的 一 小 部 分 。 调整 |/O 速 率 以 
便当 从 检查 点 开始 时 给 出 的 checkpoint_segments 段 的 分 数 已 使 用 完 ， 或 已 经 过 了 给 定 

的 checkpoint_timeout 秒 数 时 完成 检查 点 ， 不 管 时 间 哪 个 更 早 。 缺 省 值 是 0.5， PostgreSQL 
可 以 在 下 次 检查 点 开始 之 前 用 大 约 一 半 的 时 间 完 成 检查 点 。 在 一 个 正常 操作 时 就 很 接近 最 大 
IO 吞吐 量 的 操作 系统 上 ， 可 以 增加 checkpoint_completion_target 以 降低 检查 点 时 的 I/O 负 
载 。 这 样 做 的 弊端 在 于 会 延长 检查 点 ， 从 而 影响 恢复 时 间 ， 因为 会 保留 更 多 的 在 恢复 中 可 能 
用 到 的 WAL 段 。 尽 管 checkpoint_completion_target 最 大 可 以 设置 为 1.0， 最 好 不 要 设置 那么 
大 ， 最 大 0.9， 因 为 检查 点 期 间 的 操作 不 仅仅 包括 写 脏 缓冲 区 。 设置 为 1.0 极 有 可 能 会 导致 不 
会 按时 完成 检查 点 ， 从 而 由 于 所 需 的 WAL 段 的 数目 的 意外 变化 造成 性 能 丢失 。 


至 少 会 有 一 个 WAL 段 文件 ， 而 且 通 常 不 会 超过 (2 + checkpoint_completion_target ) 
checkpoint_segments + 1 或 checkpoint_segments + wal_keep_segments + 1 个 文件 。 每 个 
段 文件 通常 为 16MB( 你 可 以 在 编译 服务 器 的 时 候 修改 它 )。 你 可 以 用 这 些 信息 来 估计 JWAL 需 要 
的 空间 。 通常 ， 如 果 一 个 旧 日 志 段 文件 不 再 需要 了 ， 那 么 它 将 得 到 回收 ( 重 命名 为 顺序 的 新 的 
可 用 上段 )。 如 果 由 于 短期 的 日 志 输 出 高 峰 导 致 了 超过 3 checkpoint_segments + 1 个 段 文件 ， Ab 
么 当 系 统 再 次 回 到 这 个 限制 之 内 的 时 候 ， 不 需要 的 段 文件 将 被 删除 ， 而 不 是 回收 利用 。 


在 为 档 恢 复 或 待机 模式 时 ， 服 务 器 在 正常 操作 中 会 定期 执行 类 似 于 检查 点 的 restartpoints : 服 
务 器 会 强制 将 他 的 状态 写 入 磁盘 ， 更 新 pg_control 文件 来 表明 已 经 处 理 了 的 WAL 数 据 不 需要 
再 次 扫描 ， 然 后 便 会 回收 在 pg_xlog 目录 下 所 有 旧 日 志 段 文件 。 重启 点 不 能 比 检查 点 运行 的 
更 频繁 ， 因 为 重启 点 只 能 在 检查 点 记录 上 执行 。 当 到 达 检 查 点 记录 时 ， 如 果 从 最 后 一 个 重启 
点 至 少 已 经 过 去 checkpoint_timeout 秒 ， 那 么 触发 重启 点 。 在 待机 模式 下 ， 如 果 自 从 最 后 一 
个 重启 点 已 经 至 少 checkpoint_segments 个 日 志 段 重 放 ， 也 会 触发 重启 点 。 


AANE AA WALEZI XLogInsert 和 XLogFlush o XLogInsert 用 于 向 共享 内 存 中 的 
WAL 缓 冲 区 里 添加 一 条 新 记录 。 如 果 没 有 空间 存放 新 记录 ， 那 么 xLogInsert 就 不 得 不 写 出 
(向 内 核 缓存 里 写 ) 一 些 填 满 了 的 WAL 缓 冲 。 我 们 可 不 想 这 样 ， 因 为 xLogInsert 用 于 每 次 数据 
库 低 层 修改 (比如 插入 记录 ) 时 都 要 在 受 影响 的 数据 页 上 持 有 一 个 排 它 锁 ， 所 以 该 操作 需要 越 
快 越 好 ; 更 糟糕 的 是 ， 写 WAL 缓 冲 可 能 还 会 强制 创建 新 的 日 志 段 ， 它 花 的 时 间 甚 至 更 多 。 通 
常 ，WAL 缓 冲 区 应 该 由 一 个 xLogFlush 请 求 来 写 和 刷新 ， 在 大 部 分 时 候 它 都 是 发 生 在 事务 提 
交 的 时 候 以 确保 事务 记录 被 刷新 到 永久 存储 器 上 去 了 。 在 那些 日 志 输 入 量 比较 大 的 系统 

上 ， xLogFlush 请 求 可 能 不 够 频繁 ， 这 样 就 不 能 避免 xLogInsert 进行 写 操 作 。 在 这 样 的 系统 
+, 我 们 应 该 修改 wal_buffers 参 数 的 值 来 增加 WAL 缓 冲 区 的 数量 。 如 果 设 置 了 
full_page_writes 并 且 系 统 相 当 繁 忙 ， 把 wal_buffers 设置 得 高 一 些 将 有 助 于 在 紧 随 每 个 检查 
点 之 后 的 时 间 里 平滑 响应 时 间 。 


commit delay 定 义 了 在 xLogFlush 内 请 求 一 个 锁 后 一 组 提交 领导 者 进程 怪 要 休眠 的 毫秒 数 ， 

组 提交 后 面 跟着 排队 的 领导 者 。 这 样 的 延迟 可 以 允许 其 它 的 服务 器 进程 把 它们 提交 的 记录 追 
加 到 WAL 缓 存 中 ， 这 样 就 可 以 通过 领导 者 的 最 终 sync 操 作 把 所 有 记录 刷新 。 如 果 没 有 打 

开 fsync 或 者 当前 少 于 commit_siblings 个 处 于 活路 事务 状态 的 其 它 会 话 时 则 不 会 发 生 休 眼 ; 


这 样 就 避免 了 在 其 它 事务 不 会 很 快 提交 的 情况 下 睡眠 。 请 注意 ， 在 一 些 平 台 上 ， 休眠 要 求 的 
分 辩 率 是 10 毫秒 ， 所 以 任何 介 于 1 和 10000 微 秒 之 间 的 非 需 commit_delay 设置 的 作用 都 是 
一 样 的 。 也 要 注意 ， 在 一 些 平 台 上 ， 睡 眠 操作 可 能 比 参数 要 求 的 时 间 稍 长 一 些 。 


因为 commit_delay 的 目的 是 允许 每 个 刷新 操作 的 开销 分 挫 给 并 发 的 提交 事务 (可 能 是 事务 潜 
在 开销 ) ， 在 设置 可 以 明智 的 选择 钱 量化 开销 是 必须 的 。 开 销 越 高 ， commit_delay 在 一 定 程 
度 上 提高 事务 吞吐 量 越 有 效 。pg_test_fsync 程 序 可 以 用 来 测量 单 次 WAL 刷 新 操作 使 用 的 平均 
毫秒 数 。 这 个 程序 报告 的 平均 时 间 的 一 半 用 来 在 单个 8kB 写 操作 之 后 刷新 ， 这 个 时 间 通 常 

是 commit_delay 最 有 效 的 设置 ， 所 以 当 优 化 特定 负载 时 ， 建 议 使 用 这 个 值 作为 起 始点 。 当 
WAL 日志 存 储 在 高 时 延 旋转 磁盘 上 时 ， 调整 commit_delay 是 尤其 有 用 的 ， 即 使 存储 媒体 有 非 
常 快 的 sync 时 间 也 是 有 显著 效益 的 ， 比如 有 电池 备用 写 缓 存 的 固态 硬盘 或 RAID 阵 列 ; 但 是 这 
应 该 明确 对 代表 工作 负载 测试 。 commit_siblings 的 更 高 值 应 该 在 诸如 此 类 的 情况 下 使 用 ， 而 
更 小 值 通常 对 高 时 延 媒体 有 帮助 。 注 意 ， 总 事务 吞吐 量 太 大 时 ， commit_delay 的 设置 太 高 会 
增加 事务 时 延 是 极 有 可 能 的 。 


当 commit_ delay 设置 为 0 时 (HRA) ， 仍 然 可 能 发 生 组 提交 ， 但 是 每 组 将 只 由 到 达 点 的 会 话 
组 成 ， 在 这 个 点 他 们 需要 刷新 在 前 一 个 刷新 操作 GORA) 发 生 时 他 们 的 提交 记录 。 更 高 的 
客户 端 计 数 " 航 梯 效应 "往往 会 发 生 ， 所 以 组 提交 的 影响 会 是 显著 的 ， 即 使 commit_delay 为 0， 
并 且 因 此 明确 的 设置 commit_delay 往往 没什么 用 处 。 设 置 commit_delay 只 能 帮助 以 下 情况 : 
(1) 有 一 些 并 发 提交 事务 ， 〈2) 吞吐 量 通过 提交 率 限 制 到 某 种 程度 ; 但 是 对 于 高 旋转 延 
迟 ， 只 有 两 个 客户 端 时 ， 这 个 设置 对 增加 事务 吞 人 量 是 有 效 的 〈 也 就 是 ， 单 次 提交 客户 端 有 
一 个 兄弟 事务 ) 。 


wal_sync_method 参 数 决定 PostgreSQL 如 何 请 求 操作 系统 内 核 强 制 将 WAL 更 新 输出 到 磁盘 。 
只 要 满足 可 靠 性 ， 那么 所 有 选项 应 该 都 是 一 样 的 ， 除 fsync_writethrough ， 可 以 有 时 强制 刷 
Aik & SRE, 即使 其 他 选项 时 不 这 样 做 。 但 是 哪个 最 快 则 可 能 和 平台 密切 相关 。 你 可 以 
使 用 pg_test_fsync 测 试 不 同 选 项 的 速度 。 请 注意 如 果 你 关闭 了 fsync 的 话 这 个 参数 就 无 关 紧 
要 了 。 


打开 wal_debug 配 置 参 数 (前 提 是 编译 PostgreSQL 的 时 候 打 开 了 这 个 支持 ) 将 导致 每 
YR xLogInsert 和 xLogFlush WAL 调用 都 被 记录 到 服务 器 日 志 。 这 个 选项 以 后 可 能 会 被 更 通 
用 的 机 制 取 代 。 


29.5. WAL 内 部 


WAL 是 自动 打开 的 。 a 间 存 放 WAL 日 志 以 及 一 些 必要 的 调节 以 外 ( 参 
阅 Section 29.4)， 对 管理 员 没 有 什么 其 它 要求 。 


WAL 日 志 存 放 在 数据 目录 的 pg_xlog FARE, 它 是 作为 一 个 文件 段 的 集合 存储 的 ， 通 常 每 
段 16MB (但 是 大 小 可 以 通过 建立 服务 器 时 改变 --with-wal-segsize 配置 选项 改变 ) o 每 个 
段 又 分 割 成 多 个 页 ， 通 常 每 页 8KB ee -with-wal-blocksize 配置 选项 改 
变 ) 。 日 志 记 录 头 在 access/xlog.h 里 描述 ; 日 志 内 容 取决 于 它 记 录 的 事件 类 型 。 段 文件 的 
名 字 是 递增 自然 数 ， 从 oooooooioooooooooooooooo 开始 。 这 些 数字 不 能 循环 使 用 ， 不 过 要 把 
所 有 可 用 的 数字 都 用 光 也 需要 非常 长 的 时 间 。 


日 志 位 于 和 主 数据 库 文 件 位 于 不 同 的 磁盘 上 会 比较 好 。 你 可 以 通过 把 pg_xlog 目录 移动 到 另 
外 一 个 位 置 (此 时 必须 关闭 服务 器 )， 然 后 在 原来 的 位 置 创建 一 个 指向 新 位 置 的 符号 链接 。 


WAL 的 目的 是 确保 在 数据 库 记 录 被 修改 之 前 先 宇 日 志 ， 但 是 这 个 目的 有 可 能 被 那些 向 内 核 谎 
报 成 功 写 人 的 磁盘 驱动 器 破坏 ， 这 时 候 ， 它们 实际 上 只 是 缓冲 了 数据 而 并 未 把 数据 存储 到 磁 
AE, 这 种 情况 下 的 电源 失效 仍然 可 能 导致 不 可 恢复 的 数据 崩溃 ; 管理 员 应 该 确保 保存 
PostgreSQL 的 WAL 日 志文 件 的 磁盘 不 会 做 这 种 虚假 汇报 。 (参阅 Section 29.1.) 


在 完成 一 个 检查 点 并 且 刷 新 了 日 志文 件 之 后 ， 检 查 点 的 位 置 就 保存 在 了 pg_control 文件 里 。 
因此 在 恢复 开始 的 时 候 ， 后 端 首先 读 取 pg_control 和 检查 点 记录 ; 然后 通过 从 检查 点 记录 里 
标识 的 日 志 位 置 开始 向 前 扫描 执行 REDO 操作 。 因为 数据 页 的 所 有 内 容 都 保存 在 检查 点 之 后 
的 第 一 个 页 面 修改 的 日 志 里 (假设 full page_writes 没 有 禁用 ) ， 所 以 自 检 查 点 以 来 的 所 有 变 
化 都 将 被 恢复 到 一 个 一 致 的 状态 。 


但 是 为 了 处 理 pg_control 可 能 的 损坏 ， 我 们 应 该 支持 对 现存 日 志 段 的 反 向 顺序 扫描 (从 最 新 
到 最 老 )， 这 样 才 能 找到 最 后 的 检查 点 。 这 些 还 没有 实现 。 pg_control 很 小 ( 比 一 个 磁盘 页 
小 )， 因此 它 出 现 只 写 了 一 部 分 的 问题 的 概率 几乎 为 雳 ， 到 目前 为 止 ， 我 们 还 没有 看 到 不 能 读 
取 pg_control 自身 的 错 错误 。 因此 ， 尽管 这 在 理 ; 仓 上 是 一 个 薄弱 环节 ， 但 是 实践 

中 pg_control 似乎 并 不 会 出 现 问题 。 
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回 注 测试 是 一 套 复 杀 完整 的 测试 ， 用 来 测试 戏 入 在 PostgreSQL 里 的 SQL 实现 。 它 同时 测试 
标准 SQL 操作 和 PostgreSQL 的 扩展 SQL 。 


30.1. 运行 测试 


回 为 测试 可 以 对 一 套 已 经 安装 好 并 且 在 运行 中 的 服务 器 进行 测试 ， 也 可 以 对 编译 树 里 面 即将 
安装 的 服务 器 进行 测试 。 详 细 些 说 ， 有 "并 行 " 和 " 串 行 "运行 测试 之 分 。 串 行 模式 顺序 运行 每 个 
测试 ， 而 并 行 模式 启动 多 个 服务 器 进程 ， 并 发 地 运行 一 组 测试 。 并 发 测试 使 我 们 对 进程 内 部 
通讯 和 锁 的 正确 工作 有 足够 的 信心 。 


30.1.1. 对 临时 安 委 运行 测试 


编译 之 后 和 安装 之 前 运行 回归 测试 ， 你 可 以 在 顶级 目录 运行 (或 者 进入 src/test/regress 子 目 
录 然 后 在 那里 运行 ) : 


gmake check 


这 样 将 先 编译 几 个 辅助 文件 ， 上 比如 一 些 用 户 定义 的 触发 器 图 数 ， 然 后 再 运行 测试 驱动 脚本 。 
最 后 你 会 看 到 类 似 下 面 的 东西 : 


或 者 是 一 些 关 于 某 项 测试 失败 的 信息 。 先 看 看 Section 30.2 然后 再 想 想 一 个 "失败 "是 否 代表 严 
重 的 错 错 Iko 


因为 这 个 测试 方法 运行 临时 的 服务 器 ， 所 以 如 果 你 是 root AP, 那 这 个 方法 不 能 运行 (服务 器 
不 能 以 root 身份 启动 )。 如 果 你 已 经 以 root 身份 编译 了 ， 你 就 什么 也 干 不 了 。 这 时 候 你 应 该 
把 测试 目录 的 权限 变 成 某 个 用 户 可 写 ， 然后 以 那个 用 户 身份 登陆 ， 再 开始 测试 。 比 如 : 


<samp class="literal">root#</samp> <kbd class="literal">chmod -R a+w src/test/regress</kb 
<samp class="literal">root#</samp> <kbd class="literal">su - joeuser</kbd> 

<samp class="literal">joeuser$</samp> <kbd class="literal">cd ~_top-level build directory 
<samp class="literal">joeuser$</samp> <kbd class="literal">gmake check</kbd> 


Ki — 


这 里 唯一 可 能 的 "安全 隐患 "就 是 那个 用 户 可 能 会 背 着 你 修改 回 为 测试 的 结果 。 用 你 的 常识 管 
理 用 户 权 限 。 





如 果 不 是 上 面 那样 ， 安 装 后 就 可 以 运行 测试 。 


如 果 你 配置 PostgreSQL 安 装 到 一 个 原来 安装 有 老 版 本 PostgreSQL 的 目录 里 ， 然 后 在 安装 新 
版 本 之 前 执行 gmake check, 那么 你 可 能 发 现 测试 失败 ， 因 为 新 程序 试图 使 用 已 经 存在 的 共 
享 库 ， 典 型 的 症状 是 抱怨 未 定义 的 符号 。 如 果 你 想 在 覆盖 老 版 本 之 前 运行 测试 ， 那 么 你 需要 


使 用 configure --disable-rpath 进行 编译 。 不 过 ， 我 们 不 建议 你 使 用 这 个 选项 编译 作为 最 终 
安装 的 数据 库 。 


并 发 的 回 为 测试 会 在 你 的 用 户 ID 下 启动 相当 多 的 进程 。 目 前 ， 最 大 的 并 发 数 是 20 个 并 发 测 
试 脚本 ， 这 意味 着 40 个 进程 : 一 个 服务 器 进程 、 每 个 脚本 一 个 psql 进 程 。 因 此 ， 如 果 你 的 
系统 有 针对 每 个 用 户 的 进程 数 限制 ， 那 么 请 确保 这 个 限制 至 少 是 50 ， 否则 你 就 可 能 在 并 发 
测试 时 看 到 随机 出 现 的 失败 。 如 果 你 没有 办 法 提升 该 限制 ， 那么 可 以 通过 设 

i MAX_CONNECTIONS 参数 降低 并 发 测试 程度 。 比 如 : 


gmake MAX_CONNECTIONS=10 check 


将 运行 最 多 不 超过 10 个 并 发 进程 。 


30.1.2. 对 现 有 安装 运行 测试 


安装 后 (参见 (see Chapter 15)) 运 行 测试 ， 像 as explained in Chapter 17, 描述 的 那样 初始 化 
一 个 数据 区 并 启动 服务 器 ， 然 后 键入 : 


gmake installcheck 


4 


者 是 运行 一 个 并 发 测试 : 


gmake installcheck-parallel 


该 测试 将 与 在 本 地 主机 和 和 缺 省 端口 号 上 运行 的 服务 器 进行 连接 ， 除 非 你 用 pcuost 
和 PGPORT 环境 变量 设置 为 其 它 值 。 


源 代 码 发 布 还 包含 给 可 选 的 过 程 语言 和 contrib 模块 使 用 的 回 兴 测试 。 目 前 ， 这 些 测 试 只 能 
用 于 已 经 安装 的 服务 器 。 要 给 所 有 编译 并 安装 的 过 程 语言 运行 测试 ， 我 们 可 以 进入 源 代 码 树 
的 src/pl 目录 然后 运行 : 


gmake installcheck 


你 还 可 以 在 src/pl 的 任何 子 目 录 里 只 针对 一 种 过 程 语言 进行 测试 。 要 为 所 有 contrib 模块 运 
行 测试 ， 必 须 首 先 编译 并 安装 contrib 模块 ， 然后 进入 contrib 目录 运行 : 


gmake installcheck 


你 也 可 以 在 contrib 的 子 目 录 里 只 针对 一 个 模块 运行 测试 。 


30. 1. 3. 测 |] 试 热 各 份 


源 代码 发 布 还 包含 热 备份 静态 行为 的 回 为 测试 。 测 斌 要求 一 个 运行 的 主 服务 器 和 一 个 运行 的 
备用 服务 器 ， 接受 使 用 基于 文件 日 志 传 送 或 流 复 制 的 从 主 服 务 器 改变 的 新 WAL。 这 些 服务 器 
不 是 自动 为 你 创建 的 ， 设 置 文件 也 不 是 。 请 查阅 所 需 命令 和 相关 问题 的 文档 的 细节 。 


首先 ， 在 主 服 务 器 上 创建 一 个 命名 为 "regression" 的 数据 库 。 


psql -h primary -c "CREATE DATABASE regression" 


然后 ， 在 主 服 务 器 上 的 回 为 数据 库 运 行 一 个 准 各 脚本 : 
src/test/regress/sql/hs_primary_setup.sql , 允许 更 改 传送 到 各 用 ， 例如 : 


psql -h primary -f src/test/regress/sql/hs_primary_setup.sql regression 


现在 确认 测试 的 默认 连接 是 接受 测试 的 备用 服务 器 ， 然 后 从 回 轨 目录 运行 standbycheck : 


cd src/test/regress 
gmake standbycheck 


一 些 极端 行为 也 可 能 在 主 服务 器 产生 ， 使 用 脚本 : 


src/test/regress/sql/hs_primary_extremes.sql 人 允许 测试 各 用 服务 器 的 行为 。 


额外 的 自动 化 测试 可 能 在 以 后 的 版 本 中 可 用 。 


30.1.4. 区 域 和 编码 


ee bi ed ee 
码 。 通 过 设置 适当 的 环境 变量 来 测试 不 同 的 区 域 是 有 用 的 ， 例 如 : 


gmake check LANG=C 
gmake check LC_COLLATE=en_US.utf8 LC_CTYPE=fr_CA.utf8 


由 于 实现 原因 ， 设 置 caL 并 不 能 为 此 工作 ; 所 有 其 他 区 域 相关 的 环境 变量 可 以 。 
当 对 现 有 安装 测试 时 ， 区 域 是 由 现 有 数据 库 集 群 决定 的 ， 并 且 不 能 单独 为 测试 运行 设置 。 
你 也 可 以 通过 设置 变量 ENcopIN6 明确 的 选择 数据 库 编码 ， 例 如 : 


gmake check LANG=C ENCODING=EUC_JP 


用 这 种 方式 设置 数据 库 编码 通常 只 在 区 域 是 C 的 情况 下 有 用 ; 否则 编码 自动 从 区 域 中 选择 ， 
并 且 指 定 不 匹配 区 域 的 编码 将 会 导致 错误 。 


编码 可 以 为 临时 或 现 有 安装 测试 设置 。 


30.1.5. 额外 的 测试 
回 为 测试 包含 的 一 些 测试 文件 默认 是 不 运行 的 ， 因 为 它们 可 能 是 依赖 于 平台 的 或 运行 需要 很 
长 的 时 间 。 你 可 以 通过 设置 变量 ExTRA_TESTS 运行 它们 或 其 他 额外 测试 文件 。 例如 ， 运 
ÍT numeric_big 测试 : 
gmake check EXTRA_TESTS=numeric_big 
运行 排序 测试 : 


gmake check EXTRA_TESTS=collate.linux.utf8 LANG=en_US.utf8 


collate.linux.utf8 M] 试 只 在 Linux/glibc 平 台 工 作 ， 并 且 只 在 数据 库 使 用 UTF-8 编 码 时 运行 。 


30.2. 测试 评估 


有 一 些 正确 安装 并 且 具 有 完整 功能 的 PostgreSQL 可 能 会 在 一 些 回 为 测试 中 "失效 "， 这 主要 是 
因为 浮 点 数 的 形式 和 时 区 支持 的 问题 。 目前 的 测试 只 是 简单 的 用 diff 与 参考 系统 的 输出 进 
行 比较 ， 因而 对 一 些 细小 的 系统 区 别 很 敏感 。 当 一 项 测试 报告 "失败 "时 ， 只 要 检查 一 下 预期 
和 实际 的 结果 ， 你 就 会 发 现 区 别 并 不 大 。 当 然 ， 我 们 仍然 在 努力 维护 所 有 我 们 支持 的 平台 的 
准确 参考 文件 ， 这 样 我 们 就 可 以 假定 所 有 测试 都 通过 。 


回 为 测 试 的 实际 输出 在 src/test/regress/results 目录 里 的 文件 里 。 测试 脚本 使 用 aiff 比较 
每 个 输出 文件 和 存放 在 src/test/regress/expected 目录 里 的 参考 输出 。 任何 区 别 都 存放 

在 src/test/regress/regression.diffs 里 面 供 你 检查 。 如 果 你 不 喜欢 默认 的 diff 选项 ， 设置 
环境 变量 PG_REGRESS DIFF_OPTS 为 PG_REGRESS DIFF_opTS='-u' 。 你 也 可 以 自己 运行 diff o 


如 果 获 得 一 个 "失败 "的 测试 结果 ， 但 实际 上 输出 结果 是 正确 的 ， 你 可 以 通过 添加 新 的 比较 文 
件 来 抑制 错误 报告 。 参 见 Section 30.3 获 取 更 多 细节 。 


30.2.1. 错误 信息 差别 


有 一 些 回归 测试 涉及 到 有 意 的 非法 输入 值 。 错 误 信 息 可 能 会 来 自 PostgreSQL 代码 或 来 自主 机 
平台 系统 过 程 。 对 于 后 者 ， 信 息 可 能 在 平台 之 间 区 别 比较 大 ， 但 应 该 反映 相似 的 信息 。 这 些 
信息 上 的 差别 将 会 导致 一 个 "失败 "的 回 为 测试 ， 我 们 可 以 通过 检查 文件 发 现 这 一 点 。 


30.2.2. 区 域 差别 


如 果 你 在 一 台 服 务 器 上 运行 测试 ， 而 该 服务 器 是 用 一 种 非 C 区 域 设 置 初始 化 的 ， 那么 可 能 因 
为 有 排序 顺序 和 其 它 类 似 的 差别 导致 的 失败 。 回 为 测试 套件 处 理 这 种 问题 的 方法 是 提供 可 选 
的 结果 文件 ， 这 些 文件 一 起 处 理 一 大 堆 的 区 域 。 


当 使 用 临时 安装 在 一 个 不 同 的 区 域 中 运行 测试 时 ， 在 make 命令 行 传递 适当 的 区 域 相关 的 环 
境 变量 ， 例 如 : 


gmake check LANG=de_DE.utf8 


回 为 测试 驱动 附件 Lc_ALL ， 所 以 它 不 使 用 那个 变量 选择 区 域 。 要 不 使 用 区 域 ， 取 消 所 有 区 域 
相关 的 环境 变量 (或 设置 它们 为 c) 或 使 用 下 列 的 特殊 调用 : 


gmake check NO_LOCALE=1 


当 对 一 个 现 有 安装 运行 测试 时 ， 区 域 设 置 取决 于 现 有 安装 。 要 改变 它 ， 通过 传递 适当 的 选项 
到 initdb ， 用 一 个 不 同 的 区 域 初始 化 数据 库 集群 。 


通常 ， 作 为 生产 用 的 区 域 设置 上 运行 回 为 测试 是 明智 的 ， 因 为 这 将 练习 区 域 和 编码 相关 的 代 
码 部 分 ， 并 将 实际 在 生产 中 使 用 。 取 决 于 操作 系统 环境 ， 你 可 能 会 得 到 错误 ， 但 是 然后 你 将 
至 少 知道 在 运行 实际 应 用 时 ， 预 期 什么 区 域 特定 的 行为 。 


30.2.3. 日 期 和 时 间 磊 别 


大 多 数 日 期 和 时 间 测 试 结果 依赖 于 时 区 设置 。 参 考 文件 是 为 PsT8PDT 时 区 (伯克利 ， 加 州 ) 准 
各 的 ， 因 而 如 果 测 试 没有 设置 为 那个 时 区 是 显然 会 失败 的 。 回归 测试 的 驱动 器 把 Petz 环境 
变量 设置 为 psT8PDT ， 基本 可 以 保证 正确 的 测试 。 


30.2.4. 浮 点 数 差 别 


有 些 测 试 涉及 到 对 表 中 的 数据 列 进行 64 位 浮 点 数 ( double precision ) 计 算 的 问题 。 我 们 观察 
了 涉及 到 计算 double precision 字段 的 数学 函数 的 结果 差别 。 floats 和 geometry 测试 尤其 
容易 在 不 同 平台 ， 或 者 甚至 是 不 同 的 编译 器 最 优化 设置 之 间 产 生 小 差别 。 这 时 需要 肉眼 对 这 
些 差别 进行 比较 ， 以 判断 这 些 差别 究竟 有 多 大 ， 我 们 发 现 是 在 小 数 点 右边 10 位 左右 。 


有 些 系 统 把 负 需 显示 为 -0 ， 而 其 它 的 只 是 显示 0 。 


有 些 系统 在 pow() 和 exp() 出 错时 产生 的 信号 与 目前 PostgreSQL 代 码 里 期 望 的 机 制 不 一 
样 。 


30.2.5. 行 顺序 差别 


你 可 能 会 看 见 同样 的 行 以 与 预期 文件 的 不 同 的 顺序 输出 。 在 大 多 数 情况 下 ， 严 格 说 来 这 不 算 
臭虫 。 大 多 数 回 为 测试 脚本 都 不 会 迁 腐 到 在 每 个 secr 中 都 使 用 oRDER BY 的 地 步 ， 因此 根 
据 SQL 规范 ， 它 们 的 结果 行 顺序 并 非 定义 得 非常 好 的 。 实 际 上 ， 因为 我 们 是 在 同样 的 数据 上 
用 同样 的 软件 运行 同样 的 查询 ， 所 以 在 所 有 平台 上 通常 都 获得 同样 的 结果 ， 因此 即使 缺 

少 oRDER BY 也 不 算 什么 大 问题 。 不 过 有 些 查询 的 确 存在 跨 平台 的 排序 问题 。 在 测试 一 台 已 安 
装 的 服务 器 的 时 候 ， 排 序 的 差别 也 可 能 因为 非 C 区 域 设 置 ， 或 者 非 缺 省 的 参数 设置 ， 比如 客 
户 自己 设置 的 work_mem 或 者 规划 器 开销 参数 设置 受 影响 。 


因此 ， 如 果 你 看 到 一 个 排序 差异 ， 应 该 不 是 什么 要 担心 的 问题 (除非 明确 使 用 了 oRDER BY )。 
不 过 ， 如 果 有 这 样 的 现 像 ， 请 告诉 我 们 ， 这 样 我 们 就 可 以 在 那 条 查询 上 加 一 个 oRDER BY 从 而 
在 以 后 的 版 本 里 消除 这 种 伪 " 失 败 "。 


你 可 能 会 问 ， 为 什么 我 们 不 对 所 有 回 为 测试 的 SELECT 进行 排序 以 一 次 性 消灭 所 有 这 类 问 
题 。 原因 是 这 样 做 只 能 让 回 为 测试 用 处 更 少 ， 而 不 是 更 多 ， 因为 它们 会 试图 使 用 那些 生成 顺 
序 结果 的 查询 规划 ， 而 不 再 使 用 那些 不 排序 的 查询 规划 。 


30.2.6. 堆栈 深度 不 够 
如 果 errors 测试 导致 在 select infinite_recurse() 命令 的 时 候 服 务 器 骨 溃 ， 这 就 意味 着 平 
台 对 进程 堆栈 的 限制 小 于 max_stack_depth 参数 值 。 我 们 可 以 通过 在 更 高 的 堆栈 限制 的 数值 


上 运行 服务 器 绕 开 这 个 问题 ( 缺 省 max_stack_depth 建议 值 是 4MB)。 如 果 你 无 法 这 么 做 ， AR 
么 另外 一 个 方法 是 减少 max_stack_depth 的 值 。 


30.2.7. "随机 测试 


random 测试 脚本 的 目的 是 生成 随机 结果 。 在 很 军 见 的 情况 下 ， 这 会 导致 回 为 测试 中 的 随机 测 
AM. HA: 


diff results/random.out expected/random.out 


会 产生 仅仅 一 行 或 几 行 差别 。 你 不 必 担 心 这 些 ， 除 非 随机 测试 在 重复 测试 中 总 是 失败 。 


30.3. 平台 相关 的 比较 文件 


因为 一 些 测试 天 生 会 产生 平台 相关 的 结果 ， 我 们 提供 了 明确 指定 与 该 平台 相关 的 比较 文件 的 
方法 。 每 个 回 为 测试 都 可 以 有 和 针对 不 同 平台 的 多 个 比较 文件 。 有 两 个 独立 的 机 制 可 以 用 于 确 
定 究竟 应 该 使 用 哪个 比较 文件 。 


第 一 个 机 制 是 根据 特定 的 平台 选择 比较 文件 。 通 过 一 个 映射 文件 src/test/regress/resultmap 
定义 每 个 平台 使 用 的 比较 文件 。 要 消除 某 特定 平台 的 虚假 的 测试 "失败 "， 可 以 先 选择 或 创建 
一 个 结果 文件 的 变种 ， 然 后 在 resultmap 文件 中 添加 一 行 指定 映射 关系 即 可 。 


映射 文件 里 的 每 行 都 是 如 下 形式 


testname:output:platformpattern=comparisonfilename 


测试 名 称 只 是 特定 回 为 测试 模块 的 名 称 。 输 出 值 表明 要 检查 哪个 输出 文件 。 对 于 标准 回 为 测 
试 ， 这 里 总 是 out 。 这 个 值 对 应 输出 文件 的 文件 扩展 名 。 平台 名 称 模 式 是 Unix 工具 expr 风 
格 的 模式 (一 个 开头 带 有 隐 含 ^ 锚 符 号 的 正则 表达 式 )。 tS config.guess 打印 出 来 的 平台 
匹配 。 比较 文件 名 是 替换 结果 比较 文件 的 基本 名 。 


比如 : 一 些 系 统 把 很 小 的 浮 点 数 解析 成 为 需 ， 而 不 是 报告 一 个 下 浴 的 错误 。 这 会 导致 

在 floats 回 为 测试 中 的 一 些 差别 。 因 此 ， 我 们 提供 了 一 个 比较 文件 的 变种 
float8-small-is-zero.out ， 它 包含 在 这 些 平台 上 的 预期 结果 。 要 在 OpenBSD 平 台 上 消除 这 
些 虚 假 的 "错误 "信息 ， 可 以 在 resultmap 中 包含 : 


float8:out:i.86-.*-openbsd=float8-small-is-zero.out 


它 将 在 那些 config.guess 的 输出 匹配 i.86-.*-openbsd 的 任何 机 器 上 触发 。 Œ Sena 里 
的 其 它 行 同样 为 其 它 合适 的 平台 选取 相应 的 比较 文件 变种 。 


第 二 个 选择 比较 文件 的 机 制 更 加 自动 化 : 它 简单 的 在 多 个 比较 文件 中 使 用 "最 佳 匹 配 "。 回 为 
测试 的 驱动 脚本 同时 考虑 标准 比较 文件 、 _testname .out、 以 及 名 

为 _testname “digit .out( digit 是 0 - 9 的 任意 一 个 ) 的 变种 文件 。 如 果 其 中 之 一 完全 符合 就 认为 测试 通过 ， 
resultmap 包含 某 个 特定 测试 的 项 ， 那么 基准 testname 就 是 resultmap` 中 给 出 的 蔡 换 名 。 


例如 ， 对 于 char 测试 ， 比 较 文 件 char.out 包含 使 用 c 和 posix 区 域 设置 的 结果 ， 
而 char 1.out 文件 则 包含 使 用 其 它 区 域 设 置 的 结果 。 


最 佳 匹 配 机 制 主 要 目的 是 用 于 匹配 区 域 相 关 的 测试 结果 ， 但 也 可 以 用 于 仅 赁 平台 名 称 难 以 预 
计 测 试 结果 的 场合 。 这 个 机 制 的 一 个 缺点 是 测试 脚本 无 法 确定 当前 环境 下 究竟 哪个 变种 是 " 确 
切 "的 ， 它 只 能 选择 最 贴近 的 变种 。 因 此 最 好 将 这 个 机 制 仅 仅 用 于 多 个 变种 在 所 有 上 下 文 环境 
中 都 可 以 被 认为 是 等 价 的 场合 。 


30.4. 测试 履 盖 率 检查 
PostgreSQL 源 代码 可 以 编译 有 覆盖 测试 设备 ， 所 以 检查 回归 测试 包含 哪 部 分 代码 或 任何 其 他 
测试 组 件 运 行 代码 是 可 能 的 。 使 用 GCC 编 译 并 且 需 要 gcov 和 lcov 程序 是 目前 支持 的 。 


一 个 典型 的 工作 流 应 该 像 这 样 : 


./configure --enable-coverage ... OTHER OPTIONS ... 
gmake 

gmake check # or other test suite 

gmake coverage-html 


然后 你 的 HTML 浏 览 器 跳 转 到 coverage/index.html . gmake 命令 在 子 目 录 中 也 能 工作 。 
要 重 置 测试 运行 之 间 的 执行 计数 ， 运 行 : 


gmake coverage-clean 


IV. & 户 端 接 口 


这 部 分 描述 和 PostgreSQL 一 起 发 布 的 客 户 端 编程 接口 。 这 里 的 每 一 章 都 可 以 独立 阅读 。 请 
注意 还 有 许多 用 于 客户 端 程序 的 编程 接口 是 独立 发 布 的 ， 它们 包含 自己 的 文档 (Appendix H 
列 出 了 一 些 比较 流行 的 ) 。 这 部 分 的 读者 应 该 熟悉 使 用 SQL 命令 操作 和 查询 数据 库 (参阅 
Partl) , 并 且 当 然 也 得 熟悉 接口 使 用 的 编程 语言 。 
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libpq 是 PostgreSQL 的 C 应 用 程序 接口 。libpq 是 一 套 允 许 客 户 程序 向 PostgreSQL 服务 器 服务 
进程 发 送 查 询 并 且 获 得 查询 返回 的 库 辑 数 。 


libpq 同 时 也 是 其 他 几 个 PostgreSQL 应 用 接口 下 面 的 引擎 ， 包 括 C++, Perl, Python, Tel 和 
ECPG。 所 以 如 果 你 使 用 这 些 软 件 包 ，libpq 某 些 方面 的 特性 会 对 你 非常 重要 。 特 别 是 Section 
31.14, Section 31.15 和 Section 31.18 描述 了 任何 使 用 libpq 的 应 用 的 用 户 可 见 的 行为 。 


本 章 末尾 有 三 个 小 程序 显示 如 何 利用 libpq 书 写 程 序 。 (Section 31.21) 在 源 代码 发 布 
的 src/test/examples 目录 里 面 有 几 个 完整 的 libpq 应 用 的 例子 。 


使 用 libpq 的 前 端 程序 必须 包括 头 文件 libpq-fe.h 并 且 必 须 与 libpq 库 链接 。 


31.1. SHEE E FRE rl BSN 


下 面 的 函数 义理 与 PostgreSQL 服 务 器 联接 的 事情 。 一 个 应 用 程序 一 次 可 以 与 多 个 服务 器 建立 

联接 。 (这 么 做 的 原因 之 一 是 访问 多 于 一 个 数据 库 。) 每 个 连接 都 是 用 一 个 从 函数 

PQconnectdb 、 PQconnectdbParams 或 PQsetdbLogin 获得 的 peconn 对 象 表 示 。 FER, BAH 

n erR 个 非 空 的 对 象 指针 ， 除 非 存 储 器 少 得 连 个 Peconn 对 象 都 分 配 不 出 来 。 在 把 查询 
送 给 连接 对 象 之 前 ， 可 以 调用 PQstatus 本 数 来 检查 一 下 返回 值 看 看 连接 是 否 成 功 。 


Warning 


在 Unix 上 ， 用 打开 的 libpq 连 接 分 支 化 一 个 过 程 会 导致 不 可 预知 的 结果 ， 因为 父 进程 和 子 
进程 共享 同一 个 套 接 字 和 操作 系统 资源 。 因 为 这 个 原因 ， 不 建议 这 样 的 使 用 ， 尽 管 从 子 
进程 中 执行 exec 加 载 一 个 新 的 可 执行 文件 是 安全 的 。 


Note: 在 Windows 上 ， 如 果 一 个 数据 库 连 接 重 复 的 启动 和 关闭 ， 有 一 个 方式 提高 性 能 。 
内 部 的 ，libpq 为 连接 启动 和 关闭 分 别 调用 wsAstartup() 和 wSACleanup() o 

wSAStartup() 增加 一 个 内 部 Windows 库 引用 计数 ， 而 WSACleanup() 减少 一 个 八 。 当 引用 
计数 是 一 时 ， 调 用 wsAcleanup() 释放 所 有 资源 和 所 有 DLL 是 空 载 的 。 这 是 一 个 昂贵 的 操 
作 。 为 了 避免 它 ， 一 个 应 用 可 以 手动 调用 wsAcleanup() ， 这 样 在 最 后 一 个 数据 库 连 接 关 
闭 时 ， 资 源 将 不 会 被 释放 。 


PQconnectdbParams 


与 数据 库 服务 器 建立 一 个 新 的 连接 。 


PGconn *PQconnectdbParams(const char * const *keywords 
const char * const *values, 
int expand_dbname) ; 


这 个 函数 用 从 两 个 NULL 结束 的 数组 中 来 的 参数 打开 一 个 新 的 数据 库 连 接 。 第 一 

个 ， keywords ， 定 义 为 一 个 字符 串 的 数组 ， 每 个 都 成 为 一 个 关键 字 。 第 二 个 ， values ， 给 
每 个 关键 字 一 个 值 。 与 下 面 的 pasetdbLogin 不 同 的 是 ， 我 们 可 以 不 必 更 换 画 数 签名 (名字 ) 
就 可 以 扩展 参数 集 ， 所 以 我 们 建议 应 用 程序 中 使 用 这 个 函数 (或 者 它 的 类 似 的 非 阻塞 变种 


PQconnectStartParams 和 PQconnectPoll ) o 


目前 公认 的 参数 关键 字 在 Section 31.1.2 中 列 出 。 


当 expand_dbname FES A, TiS dbname 的 关键 字 值 看 做 一 个 连接 字符 串 。 可 能 的 格式 
的 更 详细 信息 在 Section 31.1.1 中 显示 。 


传人 的 参数 可 以 为 空 ， 表 明 使 用 所 有 人 缺 省 的 参数 ， 或 者 可 以 包含 一 个 或 更 多 个 参数 设置 。 


ro 
6 
们 的 长 度 应 该 匹配 。 处 理 将 会 在 keywords 数组 的 最 后 一 个 非 NuLL 元 素 停止。 


如 果 没 有 指定 任何 参数 ， 则 使 用 对 应 的 环境 变量 (参阅 Section 31.14) o 如 果 环 境 变量 也 没 
有 设置 ， 则 使 用 表示 的 内 建 缺 省 。 


通常 ， 关 键 字 是 从 这 些 数组 的 开始 以 素 引 的 顺序 处 理 的 。 这 样 的 影响 是 ， 当 关键 字 重 复 时 ， 
获得 最 后 处 理 的 值 。 因 此 ， 通过 小 心 的 放置 dbname 关键 字 ， 有 可 能 决定 哪个 被 conninfo 字 
符 串 覆盖 ， 哪 个 不 被 覆盖 。 


PQconnectdb 


与 数据 库 服务 器 建立 一 个 新 的 连接 。 


PGconn *PQconnectdb(const char *conninfo); 


这 个 函数 用 从 一 个 字符 串 conninfo 来 的 参数 与 数据 库 打开 一 个 新 的 联接 。 


传人 的 参数 可 以 为 空 ， 表 明 使 用 所 有 缺 省 的 参数 ， 或 者 可 以 包含 一 个 或 更 多 个 用 空白 间隔 的 
参数 设置 ， 或 者 它 可 以 包含 一 个 URI。 参 阅 Section 31.1.1 获 取 细 节 。 


PQsetdbLogin 


与 数据 库 服务 器 建立 一 个 新 的 连接 。 


PGconn *PQsetdbLogin(const char *pghost, 
const char *pgport, 
const char *pgoptions, 
const char *pgtty, 
const char *dbName, 
const char *login, 
const char *pwd); 


1X“ BE Paconnectdd 前 身 ， 它 有 固定 个 数 的 参数 。 它 有 相同 的 功能 ， 只 是 在 调用 中 那些 
它 缺 少 的 参数 总 是 用 缺 省 值 。 如 果 要 给 任意 的 固定 参数 设置 缺 省 值 ， 那么 写 一 个 NULL 或 者 
一 个 空 字 串 给 它们 。 


如 果 dbName 包含 一 个 = 符 或 者 有 一 个 有 效 的 连接 URI 前 级 ， 它 被 看 做 一 个 conninfo 字符 
串 ， 就 和 它 已 经 被 传递 到 Poconnectdb 中 完全 一 样 ， 然后 剩余 的 参数 就 像 
为 PQconnectdbParams 指定 的 那样 应 用 。 


PQsetdb 
与 数据 库 服务 器 建立 一 个 新 的 连接 。 


PGconn *PQsetdb(char *pghost, 
char *pgport, 
char *pgoptions, 
char *pgtty, 
char *dbName) ; 


这 是 一 个 调用 PQsetdbLogin 的 宏 ， 只 是 login 和 pwd 参数 是 空 指 针 。 提供 这 个 函数 是 为 了 
与 非常 老 版 本 的 程序 兼容 。 


PQconnectStartParams ~PQconnectStart PQconnectPoll 
与 数据 库 服务 器 建立 一 次 非 阻塞 的 联接 。 


PGconn *PQconnectStartParams(const char * const *keywords, 
const char * const *values, 
int expand_dbname) ; 

PGconn *PQconnectStart(const char *conninfo); 


PostgresPollingStatusType PQconnectPoll(PGconn *conn); 


这 三 个 画 数 用 于 打开 一 个 与 数据 库 服务 器 之 间 的 非 阻 塞 的 联接 : 你 的 应 用 的 执行 线程 在 执行 

它 的 时 候 不 会 因 远 端的 I/O 而 阻塞 。 这 个 方法 的 要 点 是 等 待 VO 结束 可 以 发 生 在 应 用 的 主 循 

环 里 ， 而 不 是 在 PQconnectdbParams 或 PQconnectdb 里 ， 这 样 应 用 可 以 把 这 件 事 与 其 它 操 作 并 
发 起 来 一 起 执行 。 


对 于 paconnectStartParams ， 数 据 库 联接 是 用 从 keywords 和 values 数组 中 取得 的 参数 进行 
的 ， 并 且 是 使 用 expand_dbname 控制 的 ， 就 像 上 面 PQconnectdbParams 里 描述 的 一 样 。 


对 于 PQconnectstart ， 数 据 库 联接 是 用 从 conninfo 字符 串 里 取得 的 参数 进 ， 这 个 字符 
串 的 格式 与 上 面 PQconnectdb 里 描述 的 一 样 。 


PQconnectStartParams ~ PQconnectStart 和 PQconnectPoll 都 不 会 阻塞 (进程 ) ’ 不 过 有 一 
些 条 件 : 


e 必须 正确 提供 hostaddr 和 host 参数 以 确保 不 会 发 生 正 向 或 者 反 向 的 名 字 查 找 。 参 
阅 Section 31.1.2 里 的 这 些 参数 的 文档 获取 细节 。 


e 如 果 你 调用 了 PQtrace ， 确 保 你 跟踪 进入 的 流 对 象 不 会 阻塞 。 
° 你 必须 在 调用 PQconnectPoll 之 前 确保 socket 处 于 正确 的 状态 ， 像 下 面 描述 的 那样 。 
注意 : PQconnectStartParams 的 使 用 类 似 于 下 面 显 示 的 PQconnectStart o 


要 开始 一 次 非 阻 塞 连 接 请 求 ， 调 用 conn = PQconnectStart("**_connection_info_string_"), 如 
R conn 是 空 ， 表 明 |libpq 无 法 分 配 一 个 新 的 Pecon 结构 。 否则 ， 返 回 一 个 有 效 的 Pecon 指 
H (尽管 还 不 一 定 代表 一 个 与 数据 库 有 效 联 接 ) 。 PQconnectstart 一 返回 ， 调 


用 status = PQstatus(conn) o 如 果 status 等 于 CONNECTION_BAD , PQconnectStart 失败 。 


如 果 Paconnectstart 成 功 了 ， 下 一 个 阶段 是 轮 询 libpq， 这 样 它 就 可 以 继续 连接 序列 动作 。 使 
用 pasocket (conn) 获取 数据 库 链 接 P A Ee SAR Ro 像 这 样 循环 : 如 

果 paconnectPoll(conn) 的 最 后 一 个 返回 是 PGRES_POLLING_READING ， 那 么 就 等 到 套 接 字 准 各 
好 被 读 取 了 的 时 候 (就 像 系 统 函 数 select() ， polo ， 或 者 类 似 的 系统 调用 声明 的 那 

样 ) o 然后 再 次 调用 PQconnectPoll(conn) o Rit, 如 果 PQconnectPoll(conn) 最 后 返 

[E] PGRES_POLLING_ WRITING ， 那 么 就 等 到 套 接 字 准 备 好 可 以 写 了 ， 然后 再 次 调 

FA PQconnectPoll(conn) 。 如 果 你 还 没 调用 PaconnectPoll ， 比如 ， 刚 刚 调用 


SE PQconnectStart ， 那 么 按照 它 刚 返回 pcRES_POLLING_WRITING 的 原则 行动 。 继 续 这 个 循环 直 
到 paconnectPoll(conn) 返回 PGRES_POLLING_FAILED , 表明 连接 过 程 失败 ， 或 
者 PGRES_POLLING_OK ， 表 明 连 接 成 功 建立 。 


在 连接 的 任意 时 刻 ， 我 们 都 可 以 通过 调用 Pastatus 来 检查 联接 的 状态 。 如 果 这 

是 coNNECTION_BAD ， 那 么 联接 过 程 失 败 ; 如 果 是 coNNECTION_ok ， 那么 联接 已 经 做 好 。 这 两 
种 状态 同样 也 可 以 从 上 面 的 poconnectPoll 的 返回 值 里 检测 到 。 其 他 状态 可 能 (也 只 能 ) 在 
一 次 异步 联接 过 程 中 发 生 。 这 些 标识 连接 过 程 的 当前 状态 ， 因而 可 能 对 给 用 户 提 供 反 馈 有 帮 
助 。 这 些 状态 可 能 包括 : 


CONNECTION_STARTED 
等 待 进行 连接 。 
CONNECTION_MADE 
连接 成 功 ; 等 待 发 送 。 
CONNECTION_AWAITING_RESPONSE 
等 待 来 自 服务 器 的 响应 。 
CONNECTION_AUTH_OK 
已 收 到 认证 ; 等 待 后 端 启 动 结 
CONNECTION_SSL_STARTUP 

协商 SSL 加 密 。 
CONNECTION_SETENV 

协商 环境 驱动 的 参数 设置 。 


注意 ， 尽 管 这 些 常量 将 保持 下 去 (为 了 维持 兼容 性 ) ， 应 用 决 不 应 该 依赖 于 这 些 常 量 以 某 种 
特定 顺序 出 现 ， 或 者 是 根本 不 应 依赖 于 这 些 常量 ， 或 者 是 不 应 该 依赖 于 这 些 状态 总 是 某 个 文 
档 声 明 的 值 。 一 个 应 用 可 能 像 下 面 这 样 


switch(PQstatus(conn)) 
case CONNECTION_STARTED: 
feedback = "Connecting..."; 
break; 


case CONNECTION_MADE: 


feedback = "Connected to server..."; 
break; 

default: 
feedback = "Connecting..."; 


在 使 用 poconnectPoll 的 时 候 ， 连 接 参 数 connect_timeout 将 被 忽略 ; 判断 是 否 超 时 是 应 用 的 
责任 。 否 则 ， 后 面 跟着 一 个 PQconnectPoll 循环 的 pQconnectstart 等 效 于 PQconnectdb 。 


要 注意 如 果 pQconnectstart 返回 一 个 非 空 的 指针 ， 你 必须 在 使 用 完 它 (指针 ) 之 后 调 
用 pofinish ， 以 处 理 那 些 结构 和 所 有 相关 的 存储 块 。 蕉 至 是 在 连接 尝试 失败 或 放弃 时 也 要 这 
样 处 理 。 


PQconndefaults 
返回 缺 省 的 联接 选项 。 


PQconninfoOption *PQconndefaults(void); 
typedef struct 


char *keyword; /* 选项 的 键 字 */ 


char ‘*envvar; /* 退守 的 环境 变量 名 */ 
char ‘compiled; /* 退守 的 编译 时 缺 省 值 */ 
char *val; /* 选项 的 当前 值 ， 或 者 NULL */ 
char *label; /* 连接 对 话 里 字段 的 标识 */ 
char ‘*dispchar; /* 在 连接 对 话 里 为 此 字段 显示 的 字符 。 
数值 有 : 
原样 现实 输入 的 数值 
man OSFR 一 隐藏 数值 
WDN 调试 选项 一 缺 省 的 时 候 不 显示 */ 
int dispsize; /* 对 话 中 字段 的 以 字符 计 的 大 小 */ 


} PQconninfoOption; 


一 个 连接 选项 数组 。 可 以 用 于 获取 所 有 可 能 的 Paconnectdb 选项 和 它们 的 当前 缺 省 值 。 
e PQconninfooption 结构 的 数组 ， 该 数组 以 一 个 有 NULL keyword 指针 的 条 目 
结束 。 如 果 无 法 分 配 内 存 ， 则 返回 空 指针 。 注 意 当 前 缺 省 值 〈 val 域 ) 将 依赖 于 环境 变量 和 

其 他 环境 。 调 用 者 必须 把 连接 选项 当 作 只 读 对 待 。 


在 处 理 完 选项 数组 后 ， 把 数组 交 给 PQconninfoFree 释放 。 如 果 没 有 这 么 做 ， 每 次 调 
用 Paconndefaults 都 会 有 一 小 部 分 内 存 泄漏 。 


PQconninfo 
回 活 的 连接 使 用 的 连接 选项 。 


PQconninfoOption *PQconninfo(PGconn *conn); 


一 个 连接 选项 数组 。 可 以 用 于 获取 所 有 可 和 有 BBY PQconnectdb 选项 和 用 于 连接 至 到 服务 器 的 
$ 返回 值 指向 一 个 Paconninfooption 结构 的 数组 ， 该 数组 以 一 个 有 NULL keyword 指针 的 
条 目 结束 。 以 上 所 有 poconndefaults 的 注意 事项 也 应 用 到 Paconninfo 的 结果 。 


PQconninfoParse 


从 提供 的 连接 字符 串 中 返回 解析 的 连接 选项 。 


PQconninfoOption *PQconninfoParse(const char *conninfo, char **errmsg); 


解析 连接 字符 串 并 作为 数组 返回 结果 选项 ; 或 者 如 果 连 接 字 符 串 有 问题 返回 nu 。 RMN 
数 可 以 用 来 在 提供 的 连接 字符 串 中 提取 PQconnectdb 选项 。 返回 值 指向 一 
个 Paconninfooption 结构 的 数组 ， 该 数组 以 一 个 有 NULL keyword 指针 的 条 目 结 束 。 


所 有 合法 选项 将 在 结果 数组 中 显示 ， 但 是 PQconninfooption 的 任何 没有 在 连接 字符 串 中 出 现 
的 选项 将 把 val 设置 为 NULL ; REATHA. 


如 果 errmsg 是 非 NuLL 的 ， 那 么 *errmsg 在 成 功 时 设置 为 NULL, 否则 是 malloc 的 解释 问题 
的 错误 字符 串 。 ( *errmsg 设置 为 NULL 并 且 函 数 返 回 NuLL 是 可 能 的 ; 这 表示 一 个 内 存 渝 出 
条 件 。) 

AR TT o 


在 处 理 完 选 项 数组 后 ， 把 数组 交 给 PQconninfoFree 释放 。 如 果 没 有 这 人 么 做 ， 每 次 调 
用 Paconndefaults 都 会 有 一 小 部 分 内 存 泄漏 。 相反 的 ， 如 果 错 误 发 生 了 并 
H errmsg JE NULL ， 确保 使 用 Pofreemem 释放 错误 字符 串 。 


PQfinish 
关闭 与 服务 器 的 连接 。 同 时 释放 被 Pecon 对 象 使 用 的 存储 器 。 


void PQfinish(PGconn *conn); 


注意 ， 即 使 与 服务 器 的 连接 尝试 失败 (可 由 postatus 判断 ) , 应 用 也 要 调用 pafinish 释放 
被 PGconn 对 象 使 用 的 存储 器 。 不 应 该 在 调用 Pafinish 后 再 使 用 Pecon 指针 。 


PQreset 
重 置 与 服务 器 的 通讯 端口 。 


void PQreset(PGconn *conn); 


此 函数 将 关闭 与 服务 器 的 连接 并 且 试 图 与 同一 个 服务 器 重建 新 的 连接 ， 使 用 所 有 前 面 使 用 过 
的 参数 。 这 在 失去 工作 连接 后 进行 故障 恢复 时 很 有 用 。 


PQresetStart PQresetPoll 


以 非 阻塞 模式 重 置 与 服务 器 的 通讯 端口 。 


int PQresetStart(PGconn *conn); 


PostgresPollingStatusType PQresetPoll(PGconn *conn); 


此 函数 将 关闭 与 服务 器 的 连接 并 且 试 图 与 同一 个 服务 器 重建 新 的 连接 ， 使 用 所 有 前 面 使 用 过 
的 参数 。 这 在 失去 工作 连接 后 进行 故障 恢复 时 很 有 用 。 它 们 和 上 面 的 Pareset 的 区 别 是 它们 
工作 在 非 阻 塞 模式 。 RENAN PARAS Lm PQconnectStartParams 、 

PQconnectStart 和 PQconnectPoll 一 样 的 限制 。 


要 发 起 一 次 连接 重 置 ， 调 用 Paresetstart 。 如 果 它 返回 0， 那么 重 置 失败 。 如 果 返 回 1， 用 
与 使 用 PQresetPoll 建立 连接 的 同样 的 方法 使 用 PQresetPoll 重 置 连接 。 


PQpingParams 


PQpingParams 报告 服务 器 的 状态 。 它 接受 和 PoconnectdbParams 一 样 的 连接 参数 ， 在 下 面 描 
述 。 不 需要 应 用 正确 的 用 户 名 、 密 码 或 数据 库 名 的 值 获取 服务 器 状态 ; 不 过 ， 如 果 提 供 了 不 
正确 的 值 ， 服 务 器 将 记录 一 次 失败 的 连接 尝试 。 


PGPing PQpingParams(const char * const *keywords, 
const char * const *values, 
int expand_dbname); 


该 函数 返回 下 列 的 值 之 一 : 

PQPING_OK 
服务 器 正在 运行 并 且 似 乎 接受 了 连接 。 

PQPING_REJECT 

服务 器 正在 运行 ， 但 是 在 一 个 不 允许 连接 的 状态 (启动 、 关 闭 或 月 演 恢 复 ) 。 
PQPING_NO_RESPONSE 


联系 不 上 服务 器 。 这 可 能 表明 服务 器 没有 运行 ， 或 者 给 出 的 连接 参数 有 什么 错误 (PIM, 
误 的 端口 号 ) ， 或 者 网 络 连 接 有 问题 〈 例 如 ， 防 火 墙 阻塞 连接 请 求 ) 。 


PQPING_NO_ATTEMPT 


没有 尝试 连 接 到 服务 器 ， 因 为 提供 的 参数 明显 的 不 正确 或 者 有 一 些 客户 端 侧 的 问题 (例如 ， 
AFA) 。 
PQping 


PQping 报告 服务 器 的 状态 。 它 接 受 和 PQconnectdb 一 样 的 连接 参数 ， 在 下 面 描述 。 不 需要 应 
用 正确 的 用 户 名 、 密 码 或 数据 库 名 的 值 获取 服务 器 状态 ; 不 过 ， 如 果 提 供 了 不 正确 的 值 ， 服 
务 器 将 记录 一 次 失败 的 连接 尝试 。 


PGPing PQping(const char *conninfo); 
返回 值 和 PQpingParams 的 相同 。 


31.1.1. 连接 字符 串 


几 个 libpq 画 数 分 析 用 户 指定 的 字符 串 以 获取 连接 参数 。 这 些 字符 串 有 两 个 可 接受 的 格式 : 
纯 keyword = value 字符 串 和 RFC 3986 URIs. 


31.1.1.1. 关键 字 / 值 连接 字符 串 


在 第 一 中 格式 中 ， ee deat 
一 个 空 值 或 者 一 空白 的 值 ， 你 可 以 用 一 对 单 引 号 包围 它们 ， 例 

如 ， keyword = 'a value' 。 数 值 内 部 的 单 引 号 和 反 斜 杠 必 须 用 一 个 反 斜 杠 逃 逸 ， 比 

1, NSA. 


示例 : 


host=localhost port=5432 dbname=mydb connect_timeout=10 
可 识别 的 参数 关键 字 在 Section 31.1.2 中 列 出 。 


31.1.1.2. 连接 URI 
连接 URI 的 通用 格式 是 : 


postgresql://[user[:password]@][netloc][:port][/dbname] [?parami=valuei&...] 


URI 模 式 标识 符 可 以 是 postgresql:// 或 postgres:// 。URI 的 每 个 部 分 都 是 可 选 的 。 下 列 示 
例 举 例 说 明了 有 效 的 URI 语 法 使 用 : 


postgresql:// 

postgresql://localhost 

postgresql://localhost :5433 

postgresql://localhost/mydb 

postgresql://user@localhost 

postgresql://user:secret@localhost 

postgresql: //other@localhost/otherdb?connect_timeout=10&application_name=myapp 


URI 的 层次 部 分 的 组 件 也 可 以 作为 参数 给 出 。 例 如 


postgresql:///mydb?host=localhost&port=5433 


百 分 号 可 以 用 在 URI 的 任何 部 分 来 包含 特殊 合 义 的 符号 。 
忽略 任何 不 对 应 于 在 Section 31.1.2 列 出 的 关键 字 的 连接 参数 ， 并 将 关于 它们 的 警告 消息 发 送 


到 stderr o 
为 了 提高 JDBC 连 接 URI 的 兼容 性 ， 参 数 ssl=true 的 实例 被 翻译 成 sslmode=require o 
主机 部 分 是 主机 名 或 者 IP 地 址 。 要 指定 一 个 IPv6 主 机 地 址 ， 将 它 包 含 在 方 括号 中 : 


postgresql://[2001:db8: :1234]/database 


主机 部 分 解释 为 参数 host 的 描述 。 特 别 的 ， 如 果 主 机 部 分 为 空 或 者 以 斜 线 开 头 ， 那 么 选择 一 
个 Unix 域 套 接 字 连接 ， 否 则 初始 化 一 个 TCP/HIP 连 接 。 不 过 要 注意 ， 斜 线 是 URI 分 层 部 分 的 一 
个 保留 字符 。 所 以 ， 要 指定 一 个 非 标准 Unix 域 套 接 字 路 径 ， 要 么 在 URI 中 省 略 主机 声明 并 指 
定 主机 为 一 个 参数 ， 要 么 在 URI 的 主机 部 分 添加 百 分 号 : 


postgresql:///dbname?host=/var/lib/postgresql 
postgresql: //%2Fvar%2Flib%2Fpostgresql/dbname 


31.1.2. 参数 关键 字 


目前 可 识别 的 参数 键 字 是 : 

host 

要 联接 的 主机 名 。 如 果 主 机 名 以 斜 枉 开头 ， 则 它 声 明 使 用 Unix 域 套 接 字 通 讯 而 不 是 TCP/IP 
通讯 ; 该 值 就 是 套 接 字 文 件 所 存储 的 目录 。 如 果 没 有 声明 host ， 那 么 缺 省 时 是 与 位 

于 /tmp 目录 或 者 制作 PostgreSQL 的 时 候 声明 的 套 接 字 目录 ) 里 面 的 Unix- 域 套 接 字 连 
接 。 在 没有 Unix 域 套 接 字 的 机 器 上 ， 缺 省 是 与 localhost 连接 。 


hostaddr 


与 之 连接 的 主机 的 IP 地 址 。 这 个 应 该 是 标准 的 IPv4 地 址 格式 ， 比 如 ， 172.28.40.9 o 如 果 你 
的 机 器 支持 IPv6， 那 么 你 也 可 以 使 用 IPv6 的 地 址 。 如 果 声 明了 一 个 非 空 的 字符 串 ， 那么 使 
FA TCP/IP 通讯 机 制 。 


使 用 hostaddr 取代 host 可 以 让 应 用 避免 一 次 主机 名 查找 ， 这 一 点 对 于 那些 有 时 间 约束 的 应 
用 来 说 可 能 是 非常 重要 的 。 不 过 ，Kerberos、GSSAPI 或 SSPI 认 证 方法 和 verify-full SSL 
证 书 验 证 要 求 主 机 (host) 名 。 因此 ， 应 用 下 面 的 规则 : 


e 如 果 声 明了 不 带 hostaddr 的 host 那么 就 强制 进行 主机 名 查找 。 


e。 如 果 声 明 中 没有 host ， hostaddr 的 值 给 出 服务 器 网 络 地 址 ; 如 果 认 证 方法 要 求 主机 
名 ， 那 么 连接 尝试 将 失败 。 

e 如 果 同 时 声明 了 host 和 hostaddr ， 那 么 hostaddr 的 值 作为 服务 器 网 络 地 址 。 host 的 
值 将 被 忽略 ， 除 非 认 证 方法 需要 它 ， 在 这 种 情况 下 它 将 被 用 作 主 机 名 。 


要 注意 如 果 host 不 是 网 络 地 址 hostaddr 处 的 服务 器 名 ， 那么 认证 很 有 可 能 失败 。 同 样 ， 
在 ~/.pgpass (Æ ğ Section 31.15) 中 是 使 用 host 而 不 是 hostaddr 来 标识 连接 。 


如 果 主 机 名 (host) 和 主机 地 址 都 没有 ， 那 么 libpq 将 使 用 一 个 本 地 的 Unix 域 套 接 字 进 行 连 
接 ; 或 者 是 在 没有 Unix 域 套 接 字 的 机 器 上 ， 它 将 党 试 与 localhost 连接 。 


port 


主机 服务 器 的 端口 号 ， 或 者 在 Unix 域 套 接 字 联接 时 的 套 接 字 扩 展 文 件 名 。 


dbname 

数据 库 名 。 缺 省 和 用 户 名 相同 。 在 某 些 情况 下 ， 为 扩展 的 格式 检查 值 ; 参阅 Section 31.1.1 获 
取 更 多 信息 。 

user 

要 连接 的 PostgreSQL 用 户 名 。 缺 省 是 与 运行 该 应 用 的 用 户 操作 系统 名 同名 的 用 户 。 

password 

如 果 服 务 器 要 求 口令 认证 ， 所 用 的 口令 。 

connect_timeout 

连接 的 最 大 等 待 时 间 ， 以 秒 计 〈 用 十 进 制 整数 字 串 书写 ) 。 需 或 者 不 声明 表示 无 穷 。 我 们 不 
建议 把 连接 超时 的 值 设置 得 小 于 2 秒 。 

client_encoding 

为 这 个 连接 设置 client_encoding 配置 参数 。 除了 对 应 的 服务 器 选项 接受 的 值 ， 你 可 以 使 

用 auto 从 客户 端 中 的 当前 环境 中 确定 正确 的 编码 (Unix 系 统 上 是 Lc_cTYPE 环境 变量 ) 。 
options 

添加 命令 行 选项 以 在 运行 时 发 送 到 服务 器 。 例 如 ， 设 置 为 -c geqo=off 设置 geg 参数 的 会 话 
的 值 为 off 。 关 于 可 用 选项 的 详细 讨论 ， 请 查阅 Chapter 18。 


application_name 


为 application_name 配 置 参 数 指定 一 个 值 。 
fallback_application_name 
为 application_name 配 置 参 数 指定 一 个 回 退 值 。 如 果 没 有 通过 连接 参数 或 P6APPNAME 环境 变 


量 给 定 application_name 值 ， 那 么 将 使 用 这 个 值 。 在 想 要 设置 缺 省 应 用 名 但 是 允许 用 户 重 写 
的 通用 实用 程序 中 指定 一 个 回 退 名 是 有 用 的 。 

keepalives 

控制 客户 端 侧 的 TCP 保 持 激活 是 否 使 用 。 缺 省 值 是 1， 意 思 为 打开 ， 但 是 如 果 不 想 要 保持 激 
活 ， 你 可 以 更 改 为 0， 意 思 为 关闭 。 通 过 Unix 域 套 接 字 做 的 连接 忽略 这 个 参数 。 
keepalives_idle 

在 TCP 应 该 发 送 一 个 保持 激活 的 信息 给 服务 器 之 后 ， 控 制 不 活动 的 秒 数 。 0 值 表 示 使 用 系统 缺 
省 。 通 过 Unix 域 套 接 字 做 的 连接 或 者 如 果 禁 用 了 保持 激活 则 忽略 这 个 参数 。 只 有 

在 TcP_KEEPIDLE 和 TcP_KEEPALIVE 套 接 字 选 项 可 用 的 系统 上 支持 这 个 参数 ， 在 Windows 上 还 
是 在 其 他 系统 上 是 没什么 影响 的 。 


keepalives_interval 


在 TCP 保 持 激活 信息 没有 被 应 该 传播 的 服务 器 承认 之 后 ， 控 制 秒 数 。0 值 表示 使 用 系统 缺 省 。 
通过 Unix 域 套 接 字 做 的 连接 或 者 如 果 禁 用 了 保持 激活 则 忽略 这 个 参数 。 只 有 
在 TcP_KEEPINTVL 套 接 字 选项 可 用 的 系统 上 支持 这 个 参数 ， 在 Windows 上 还 是 在 其 他 系统 上 


=D By 
FES 十 么 影响 的 。 
keepalives_count 


在 认为 客户 端 到 服务 器 的 连接 死亡 之 前 ， 控 制 可 以 丢失 的 TCP 保 持 激 活 的 数量 。0 值 表示 使 用 
系统 缺 省 。 通过 Unix 域 套 接 字 做 的 连接 或 者 如 果 禁 用 了 保持 激活 则 忽略 这 个 参数 。 只 有 
在 TcP_KEEPINTVL 套 接 字 选项 可 用 的 系统 上 支持 这 个 参数 ， 在 Windows 上 还 是 在 其 他 系统 上 


是 没什么 影响 的 。 
tty 
忽略 〈 以 前 ， 这 个 选项 声明 服务 器 日 志 的 输出 方向 ) 。 


sslmode 


这 个 选项 决定 是 否 需要 和 服务 器 协商 一 个 SSL TCP/IP 连 接 ， 以 及 以 什么 样 的 安全 优先 级 与 服 
务 器 进行 SSL TCP/IP 连 接 。 这 里 有 六 个 模式 : 


disable 

只 进行 一 个 非 SSL 连 接 

allow 

首先 尝试 一 个 非 SSL 连 接 ; 如 果 失 败 ， 党 试 一 个 SSL 连 接 

prefer (default) 

首先 尝试 SSL 连 接 ; 如 果 失 败 ， 党 试 一 个 非 SSL 连 接 

require 

尝试 一 个 SSL 连 接 。 如 果 有 根 CA 文 件 ， 则 按照 指定 了 verify-ca 的 相同 方式 验证 该 证 书 
verify-ca 

只 尝试 一 个 SSL 连 接 ， 并 核实 服务 器 证 书 是 由 一 个 受信 任 的 认证 中 心 (CA) 发 布 的 
verify-full 

只 尝试 一 个 SSL 连 接 ， 核 实 服务 器 证 书 是 由 受信 任 的 CA 发 布 的 ， 并 且 该 服务 器 主机 名 匹配 证 
书 中 的 服务 器 主机 名 。 

参阅 Section 31.18 获 取 这 些 选项 工作 的 详细 描述 。 

Unix 域 套 接 字 通信 忽略 sslmode 。 如 果 PostgreSQL 编译 时 没有 打开 SSL 支持 ， 那 么 使 用 选 


项 require 、 verify-ca 或 verify-full 将 导致 一 个 错误 ， 而 选项 allow 和 prefer 将 被 接 
受 ， 但 是 libpq 实 际 上 不 会 企图 进行 SSL 连 接 。 


requiressl 


这 个 选项 因为 有 了 sslmode 设置 之 后 已 经 废弃 了 。 


如 果 设 为 1， 则 要 求 与 服务 器 进行 SSL 联 接 (SRF sslmode require) 。 如 果 服 务 器 不 支持 
SSL， 那 么 libpq 将 马上 拒绝 联接 。 设 置 为 0 ( 缺 省 ) ， 和 与 服务 器 进行 协商 连接 类 型 (等 效 
于 sslmode prefer ) 。 这 个 选项 只 有 在 编译 PostgreSQL 时 打开 了 SSL 支持 才 有 效 。 


sslcompression 


如 果 设 置 为 1 〈 缺 省 ) ， 通 过 SSL 连 接 进行 的 数据 发 送 将 被 压缩 (这 要 求 OpenSSL 版 本 0.9.8 
或 更 高 ) 。 如 果 设置 为 0， 将 禁用 压缩 (这 需要 OpenSSL 1.0.0 或 更 高 ) 。 如 果 连 接 没有 通过 
SSL 进 行 ， 或 者 如 果 使 用 的 OpenSSL 版 本 不 支持 它 ， 则 忽略 该 参数 。 


压缩 使 用 CPU 时 间 ， 但 是 如 果 网 络 是 瓶颈 ， 那 么 可 以 提高 吞吐 量 。 如 果 CPU 性 能 是 限制 因 
素 ， 那 么 禁用 压缩 可 以 提高 响应 时 间 和 吞吐 量 。 


sslcert 


这 个 参数 指定 客户 端 SSL 认 证 的 文件 名 ， 蔡 换 缺 省 的 ~/.postgresql/postgresql.crt 。 如 果 没 
有 做 SSL 连 接 ， 则 忽略 这 个 参数 。 


sslkey 


这 个 参数 指定 客户 端 使 用 的 秘 钥 的 位 置 。 也 可 以 指定 一 个 用 来 替换 缺 省 
~/.postgresql/postgresql. key 的 文件 名 ， 或 者 指定 一 个 从 外 部 "引擎 "获取 的 键 (引擎 是 
OpenSSL 可 加 载 模块 ) 。 一 个 外 部 引擎 声明 应 该 包括 一 个 由 冒号 分 隅 的 引擎 名 字 和 特定 于 引 
擎 的 键 标识 符 。 如 果 没 有 做 SSL 连 接 则 忽略 这 个 参数 。 


sslrootcert 


这 个 参数 声明 一 个 包含 SSL 认 证 授权 (CA) 证 书 的 文件 名 。 如 果 该 文件 存在 ， 那 么 将 要 验证 的 
服务 器 的 证 书 将 由 这 些 授权 之 一 签署 。 缺 省 是 ~/ .postgresql/root.crt o 


sslcrl 


这 个 参数 声明 SSL 证 书 撤销 列表 (CRL) 的 文件 名 。 在 这 个 文件 中 列 出 的 证 书 ， 如 果 该 文件 存 
在 ， 将 在 党 斌 认证 服务 器 的 证 书 时 被 拒绝 。 缺 省 是 ~/.postgresql/root.crl o 


requirepeer 


这 个 参数 声明 服务 器 的 操作 系统 用 户 名 ， 例 如 requirepeer=postgres . 当 制 作 一 个 Unix 域 套 
接 字 连接 时 ， 如 果 设 置 了 该 参数 ， 那 么 在 连接 的 开始 ， 客户 端 检查 服务 器 进程 是 否 运行 在 指 
定 的 用 户 名 之 下 ; 如 果 不 是 ， 则 连接 带 有 错误 退出 。 这 个 参数 可 以 用 来 提供 服务 器 认证 ， 类 
似 于 在 TCP/IP 连 接 上 可 用 SSL 证 书 。 (请 注意 ， 如 果 Unix 域 套 接 字 在 /tmp 中 或 另 一 个 公开 
可 写 位 置 ， 那么 任意 用 户 都 可 以 在 这 里 启动 一 个 服务 器 监听 。 使 用 这 个 参数 确保 你 连接 到 一 
个 受信 任 的 用 户 运行 的 服务 器 。) 这 个 选项 只 有 在 实现 了 peer 认证 方法 的 平台 上 支持 ; 参 
阅 Section 19.3.7. 


krbsrvname 


使 用 Kerberos 5 或 GSSAPI 认 证 时 使 用 的 Kerberos 服 务 名 。 这 个 名 字 必 须 和 服务 器 给 
Kerberos 认 证 配置 的 服务 名 相同 ， 才 能 认证 成 功 。 (又 见 Section 19.3.5 和 Section 
19.3.3。) 


gsslib 

为 GSSAPI 认 证 使 用 的 GSS 库 。 只 在 Windows 上 使 用 。 设 置 为 gssapi 强迫 libpq 为 认证 使 用 
GSSAPI 库 而 不 是 缺 省 的 SSPI。 

service 

用 于 额外 参数 的 服务 名 。 它 在 pg_service.conf 里 面 声 明 一 个 服务 名 ， 这 个 配置 文件 保存 额外 


的 连接 参数 。 这 样 就 允许 应 用 只 声明 一 个 服务 名 ， 而 连接 参数 就 可 以 在 一 个 地 方 维护 了 。 参 
# Section 31.16。 


31.2. FRAAW 


IŽ 


R ERR MAA Fa i] FRE E ERRITAR So 


Tip: libpq 应 用 程序 员 应 该 仔细 维护 Peconn 





结构 。 


使 用 下 面 的 访问 函数 来 获取 Poconn 的 


内 容 。 不 建议 使 用 libpg-int.h 引用 PGconn 内 部 的 字段 ， 因 为 这 些 字段 在 今后 可 能 被 改 


ar 
Xo 


FEY BARGE NSM a, x 


PQdb 
返回 连接 的 数据 库 名 。 
char *PQdb(const PGconn 
PQuser 
返回 连接 的 用 户 名 。 
char *PQuser(const PGconn 


PQpass 
返回 连接 的 口令 。 


char *PQpass(const PGconn 


PQhost 
返回 连接 的 服务 器 主机 名 。 


char *PQhost(const PGconn 


PQport 
返回 连接 的 端口 号 。 
char *PQport(const PGconn 


Patty 


返回 连接 的 调试 控制 台 TTY。 
的 存在 是 为 了 向 下 兼容 。) 


*conn); 


*conn); 


*conn); 


*conn); 


*conn); 


(这 个 


参数 在 peconn 对 象 的 生命 期 期 间 是 固定 的 。 


已 经 过 时 了 ， 


因为 服务 器 不 再 注意 TTY 设 置 ， 这 个 函数 


char *PQtty(const PGconn *conn); 


PQoptions 
返回 连接 请 求 中 传递 的 命令 行 选项 。 


char *PQoptions(const PGconn *conn); 


FESSOR GABE xt Pecon 对 象 进 行 操 作 的 过 程 中 可 能 变化 的 状态 数据 。 


PQstatus 
返回 连接 的 状态 。 


ConnStatusType PQstatus(const PGconn *conn); 


这 个 状态 可 以 是 一 系列 值 之 一 。 不 过 ， 我 们 在 一 个 异步 连接 过 程 外 面 只 能 看 到 其 中 的 两 个 : 
CONNECTION_OK 和 CONNECTION_BAD 。 成 功 连 接 到 数据 库 返 回 状态 coNNECTION_ok 。 失败 的 连 
接 党 试用 状态 CONNECTION_BAD 标识 。 通 常 ， 一 个 OK 状态 将 保持 到 pQfinisn ， 但 是 一 个 通讯 
失败 可 能 会 导致 状态 过 早 的 改变 为 ”coNNECTION_BAD 。 这 时 应 用 可 以 试 着 调用 poreset 来 恢 
复 。 


参阅 PQconnectStartParams 、 PQconnectstart 和 PQconnectPoll 条 目 看 看 可 能 出 现 的 其 他 状 
态 码 。 


PQtransactionStatus 
返回 服务 器 的 当前 事务 内 状态 。 


PGTransactionStatusType PQtransactionStatus(const PGconn *conn); 


状态 可 以 是 PaTRANS_IDLE (当前 空 阁 ) , PQTRANS_ACTIVE (正在 义理 一 个 命 

43) ， PQTRANS_INTRANS 《空闲 ， 在 一 个 合法 的 事务 块 内 ) ， 或 者 PQTRANS_INERROR (ÆN, 
在 一 个 失败 的 事务 块 内 ) 。 如 果 连 接 有 问题 ， 则 返回 PQTRANS_UNKNOWN 。 只 有 在 一 个 查询 发 送 
给 了 服务 器 并 且 还 没有 完成 的 时 候 才 返回 PQTRANS_ACTIVE o 


Caution 
当 使 用 参数 autocommit 设置 为 关闭 的 PostgreSQL 7.3 服 务 器 时 ， PQtransactionstatus 将 


给 出 不 正确 的 结果 。 服 务 器 端 自动 提交 特性 已 经 废弃 了 ， 并 且 在 后 来 的 服务 器 版 本 中 不 
再 存在 。 


PQparameterStatus 


查找 服务 器 的 一 个 当前 参数 设置 。 


const char *PQparameterStatus(const PGconn *conn, const char *paramName); 


有 些 参 数值 在 建立 连接 或 者 它们 的 值 改 变 的 时 候 会 由 服务 器 自动 报告 。 PQparameterstatus 可 
以 用 查询 这 些 设置 。 如 果 参 数 已 知 ， 那么 它 返 回 当前 值 ， 否 则 返回 NULL o 


当前 版 本 报告 的 参数 有 server_version , server_encoding , 

client_encoding ， application_name , is_superuser , 

session_authorization ， DateStyle , IntervalStyle , 

TimeZone , integer_datetimes 和 standard_conforming_strings o (8.0 之 前 的 版 本 不 报 
server_encoding , TimeZone 和 integer_datetimes ; 8.1 之 前 的 版 本 不 报 
standard_conforming_strings ; 8.4 之 前 的 版 本 不 报告 Intervalstyle ; 9.0 之 前 的 版 本 不 报 
application_name o ) 请 注意 server_version ， server_encoding 和 integer_datetimes 


不 能 再 启动 后 修改 。 


OF OF OF 


协议 版 本 3.0 之 前 的 服务 器 不 会 报告 参数 设置 ， 但 是 libpq 里 包含 一 些 逻 辑 用 于 获 

HX server_version 和 client_encoding 的 数值 。 我 们 鼓励 应 用 里 面 使 用 Paparameterstatus , 
而 不 是 使 用 ad hoc 代码 来 检测 这 些 值 。 (不 过 要 注意 ， 在 3.0 之 前 的 连接 协议 里 ， 扰 动 后 通 
过 SET 改变 了 client_encoding 将 不 会 被 PQparameterstatus 反映 出 来 。) 对 

F server_version , 又 见 PQserverVersion , 它 返 回 数值 形式 ， 更 容易 进行 比较 。 


如 果 没 有 为 standard_conforming_strings 报告 数值 ， 应 用 可 以 假设 它 是 off ， 也 就 是 说 ， 在 
字符 串 文 本 里 ， 把 反 斜 杠 当 做 逃逸 。 同 样 ， 如 果 出 现 了 这 个 参数 ， 就 可 以 当 作 一 个 指示 ， 表 
示 接 受 逃 逸 字符 串 (E..… ) 的 语法 。 


尽管 返回 的 指针 声明 为 const ， 它 实际 上 指向 一 个 和 Pecon 结构 关联 的 可 变 存 储 区 。 因 此 
假设 这 个 指针 跨 查 询 保 持 有 效 是 不 明智 的 。 


PQprotocolVersion 
查询 使 用 的 前 /后 端 协议 。 


int PQprotocolVersion(const PGconn *conn); 


应 用 可 能 希望 使 用 这 个 函数 来 判断 某 些 特性 是 否 被 支持 。 目 前 ， 可 能 的 数值 是 2 (2.0% 

X) ，3 (3.0 协 议 ) KO (连接 错误 ) 。 在 连接 和 启动 完成 之 后 ， 这 个 数值 将 不 会 改变 ， 但 是 在 
连接 重 置 的 过 程 中 ， 理 论 上 是 可 能 改变 的 。 在 与 PostgreSQL 7.4 或 更 高 版 本 沟通 时 ， 通 常 使 
用 3.0 协 议 ; 7.4 以 前 的 服务 器 只 支持 协议 2.0。 【协议 1.0 过 时 了 ， 不 被 libpq 支 持 。) 


PQserverVersion 
返回 一 个 整数 ， 代 表 后 端 版 本 。 


int PQserverVersion(const PGconn *conn); 


fo FAY A Fk SHUT SR SH EAR A ee AAA, MSIE. 次 及 版 本 号 
转换 成 两 位 十 进 制 数 并 且 把 它们 连接 在 一 起 组 成 的 。 例 如 ， 版 本 8.1.5 将 被 返回 80105， 版 本 
8.2 将 被 返回 80200 〈 前 导 需 没有 显示 ) 。 如 果 连 接 失 败 ， 则 返回 震 。 


PQerrorMessage 
返回 连接 中 操作 产生 的 最 近 的 错误 信息 。 


char *PQerrorMessage(const PGconn *conn); 


JL-F ATH libpqks te A mk at ZB AH Poerrormessage 设置 一 个 信息 。 注 意 ，libpq 的 传统 是 ， 一 
个 非 空 的 poerrormessage 结果 会 由 多 行 组 成 ， 并 且 将 包含 一 个 结尾 的 新 行 。 调用 者 不 应 该 直 
接 释 放 结 果 。 结 果 的 释放 是 在 将 pecon 句柄 传递 给 PQfinish 的 时 候 自 动 进行 的 。 我 们 不 能 
假设 在 不 同 的 Pecon 结构 操作 中 ， 结 果 字 串 都 是 一 样 的 。 


PQsocket 


获取 与 服务 器 连接 的 套 接 字 的 文件 描述 符 编 号 。 一 个 有 效 的 描述 符 应 该 是 大 于 或 等 于 0 ; 结果 
为 -1 表示 当前 没有 和 与 服务 器 的 连接 打开 。 (在 正常 的 操作 中 ， 这 个 结果 不 会 改变 ， 但 是 可 能 
在 连接 启动 或 者 重 置 的 过 程 中 变化 。) 


int PQsocket(const PGconn *conn); 


PQbackendPID 


返回 后 端 进 程 处 理 此 连接 的 进程 号 ID (PID) 
int PQbackendPID(const PGconn *conn); 


这 个 后 端 PID 在 调试 和 对 比 NoTIFY 信息 《包括 发 出 通知 的 后 端 进程 的 PID) 时 很 有 用 。 注意 
该 PID 属 于 运行 数据 库 服 务 器 主机 的 进程 ， 而 不 是 本 地 主机 ! 


PQconnectionNeedsPassword 


如 果 连 接 的 认证 方法 需要 一 个 密码 则 返回 true (1)， 但 是 没有 可 用 的 。 如 果 没 有 则 返回 false 
(0). 


int PQconnectionNeedsPassword(const PGconn *conn); 


此 功能 可 用 于 连接 尝试 失败 后 决定 是 否 提示 用 户 输 入 密码 。 


PQconnectionUsedPassword 
如 果 连 接 的 认证 方法 使 用 密码 则 返回 true (1)。 否 则 返回 false (0). 


int PQconnectionUsedPassword(const PGconn *conn); 


此 功能 可 应 用 于 失败 或 成 功 连接 后 尝试 检测 服务 器 是 否 要 求 密码 。 


PQgetssl 
返回 连接 中 使 用 的 SSL 结 构 ， 或 者 没有 使 用 SSL 则 返回 null。 


void *PQgetssl(const PGconn *conn); 


这 个 结构 可 以 用 于 核实 加 密级 别 ， 检 查 服务 器 认证 等 信息 。 参 考 OpenSSL 文档 获取 关于 这 个 
结构 的 更 多 信息 。 

实际 返回 值 的 类 型 是 ssL * ， 而 ssL 的 类 型 是 由 OpenSSL 库 定义 的 ， 但 是 没有 用 这 种 方式 
声明 ， 以 避免 请 求 OpenSSL 头 文件 。 要 使 用 这 个 画 数 ， 可 以 使 用 下 面 的 代码 行 : 


#include &lt;libpq-fe.h&gt; 
#include &lt;openssl/ssl.h&gt; 


SSL *ssl; 

dbconn = PQconnectdb(...); 
ssl = PQgetssl(dbconn); 

if (ssl) 

{ 


/* use OpenSSL functions to access ssl */ 


} 


31.3. 命令 执行 酌 数 


一 旦 与 数据 库 服务 器 的 连接 成 功 建立 ， 便 可 以 使 用 这 里 描述 的 函数 执行 SQL 查 询 和 命 爸 。 


31.3.1. ERB 


PQexec 
给 服务 器 提交 一 条 命令 并 且 等 待 结果 。 


PGresult *PQexec(PGconn *conn, const char *command); 


返回 一 个 pcresult 指针 或 者 也 可 能 是 一 个 空 指 针 。 通常 返回 一 个 非 空 指针 ， 除 非 耗 尽 内 存 或 
发 生 了 像 不 能 把 命令 发 送 到 服务 器 这 样 的 严重 错误 。 应 该 调用 poresultstatus WAKA 
何 错误 的 返回 值 (包括 空 指针 的 值 ， 在 这 种 情况 下 它 将 返回 PGRES_FATAL_ERROR ) 。 使 

用 PQerrorMessage 3 获取 有 关 错误 的 更 多 信息 。 


命令 字符 串 可 以 包括 多 个 SQL 命 舍 〈 用 分 号 分 隔 ) 。 在 一 个 Paexec 调用 中 发 送 的 多 个 查询 是 
在 一 个 事务 里 处 理 的 ， 除 非 在 查询 字符 串 里 有 了 明确 的 Besin / commit 命令 把 整个 字符 串 分 隔 
成 多 个 事务 。 请 注意 ， 返 回 的 Peresult 结构 只 描述 字符 串 里 执行 的 最 后 一 条 命令 的 结果 。 
如 果 有 一 个 命令 失败 ， 那 么 字符 串 义 理 的 过 程 就 会 停止 ， 并 且 返 回 的 Peresult 会 描述 错误 条 
件 。 


PQexecParams 


向 服务 器 提交 一 条 命令 并 且 等 待 结果 ， 还 有 独立 于 SQL 命令 文本 传递 参数 的 能 力 。 


PGresult *PQexecParams(PGconn *conn, 
const char *command, 
int nParams, 
const Oid *paramTypes, 
const char * const *paramValues, 
const int *paramLengths, 
const int *paramFormats, 
int resultFormat); 


PgexecParams 类 似 Paexec ， 但 是 提供 了 额外 的 功能 : 参数 值 可 以 独立 于 命令 字符 串 进 行 声 
明 ， 并 且 可 以 要 求 查询 结果 的 格式 是 文本 或 二 进 制 的 。 PpQexecParams 只 是 在 协议 3.0 及 以 后 
的 版 本 中 支持 ; 在 使 用 协议 2.0 的 时 候 会 失败 。 


阔 数 的 参数 是 : 
conn 


连接 对 象 通过 它 发 送 命令 。 


command 


要 执行 的 SQL 命令 字符 串 。 如 果 使 用 参数 ， 它 们 在 命令 字符 串 中 被 叫做 s1. s2 等 等 。 
nParams 
提供 的 参数 数目 ; 它 是 paramTypes[] ~ paramValues[] 、 


paramLengths[] 和 paramFormats[] 数组 的 长 度 。 (34 nparams 是 0 时 ， 数 组 指针 可 以 


是 NULL ) 

paramTypes[ ] 

通过 OID， 将 声明 数据 类 型 指定 到 参数 标记 。 如 果 paramtypes 是 NULL ， 或 数组 中 任何 的 特 
定 参数 是 0， 服 务 器 为 参数 标记 推断 数据 类 型 ， 采用 的 方式 与 一 个 未 定义 类 型 的 文本 字符 串 相 
同 。 

paramValues[] 

声明 参数 的 实际 值 。 在 这 个 数组 中 的 一 个 空 指针 表示 相应 的 参数 是 空 ;否则 指针 指向 一 个 以 
需 结 尾 的 文本 字符 串 (文本 格式 ) 或 者 服务 器 希望 的 格式 的 二 进 制 数据 《二进制 格式 ) 。 
paramLengths[ ] 

为 二 进 制 格式 的 参数 声明 实际 数据 长 度 。 该 设置 忽略 空 参数 或 文本 格式 的 参数 。 如 果 没 有 二 
进 制 参数 ， 那 么 数组 指针 可 以 为 空 。 

paramFormats[ ] 


声明 参数 为 文本 (为 相应 参数 在 数组 条 目 中 放置 一 个 0) 还 是 二 进 制 格式 (为 相应 参数 在 数组 
条 目 中 放置 一 个 1) 。 如 果 数 组 指针 是 空 ， 那 么 所 有 参数 被 看 做 是 文本 字符 串 。 


以 二 进 制 格式 传递 的 值 需 要 能 够 被 后 台 识别 的 内 部 表示 。 例 如 ， 整 数 必须 以 网 络 字 节 顺序 来 
传递 。 传递 numeric 值 需要 服务 器 存储 格式 的 识别 ， 如 在 
src/backend/utils/adt/numeric.c::numeric_send() 和 


src/backend/utils/adt/numeric.c: :numeric_recv() 中 那样 。 

resultFormat 

声明 0 用 于 以 文本 格式 获得 结果 ， 或 1 用 于 以 二 进 制 格式 获得 结果 。 (目前 没有 规定 以 不 同 的 
格式 来 获取 不 同 的 结果 列 ， 即 使 底层 协议 中 可 能 实现 。) 

PQexecParams 相 比 Paexec 的 主要 优势 是 参数 值 可 以 从 命令 字符 串 中 分 离 出 来 ， 因此 避免 了 
繁琐 和 容易 出 错 的 引用 和 逃逸 的 需要 。 


和 PQexec 不 同 的 是 ， PQexecParams 在 一 个 给 出 的 字符 串 里 最 多 允许 一 个 SQL 命令 。 (里 面 
可 以 有 分 号 ， 但 是 不 得 超过 一 个 非 空 的 命令 。) 这 是 下 层 协 议 的 一 个 限制 ， 但 是 也 有 些 好 
处 ， 比 如 作为 对 SQL 注入 攻击 的 额外 防御 。 


Tip: 通过 OID 声 明 参 数 类 型 是 非常 繁琐 的 ， 尤 其 是 你 不 希望 在 你 的 程序 里 写 死 特定 的 OID 
值 的 时 候 。 不 过 ， 你 可 以 避免 这 么 做 ， 即 使 在 服务 器 自己 无 法 判断 参数 类 型 ， 或 者 是 选 
择 了 一 种 与 你 预期 不 同 的 参数 类 型 的 时 候 也 一 样 。 在 SQL 命令 文本 里 ， 给 参数 符号 附加 
一 个 明确 的 类 型 转换 ， 显 示 你 准 各 发 送 的 数据 类 型 。 比 如 : 


SELECT * FROM mytable WHERE x = $1::bigint; 


这 样 强制 参数 $1 当 作 bigint 看 待 ， 即 使 缺 省 情况 下 它 会 被 赋予 和 x 一 样 的 类 型 。 在 
以 二 进 制 格式 发 送 参 数值 的 时 候 ， 我 们 强烈 建议 通过 这 种 方法 或 者 是 声明 数字 类 型 OID 
的 方法 强制 类 型 判断 ， 因为 二 进 制 格式 比 文本 格式 少 一 些 宛 余 ， 因 此 服务 器 就 会 少 一 些 
机 会 捕捉 类 型 的 错误 匹配 。 


PQprepare 
用 给 定 的 参数 提交 请 求 ， 创 建 一 个 预备 语句 ， 然 后 等 待 结束 。 


PGresult *PQprepare(PGconn *conn, 
const char *stmtName, 
const char *query, 
int nParams, 
const Oid *paramTypes); 


PQprepare 创建 一 个 为 后 面 PaexecpPrepared 执行 用 的 预备 语句 。 这 个 特性 允许 那些 重复 使 用 
的 语句 只 分 析 和 规划 一 次 ， 而 不 是 每 次 执行 都 分 析 规 划 。 只 是 在 协议 3.0 和 以 后 的 连接 里 支 
持 Poprepare ; 在 使 用 2.0 协 议 的 时 候 ， 它 会 失败 。 


这 个 图 数 从 query 字 串 里 创建 一 个 叫 stmtName 的 预备 语句 ， query 必须 只 包含 一 个 SQL 命 
Do stmtName 可 以 是 "" ， 这 样 就 创建 一 个 无 名 的 语句 ， 这 种 情况 下 ， 任 何 前 面 存 在 的 无 名 
语句 都 会 自动 被 代替 ; 否则 ， 如 果 语 句 名 已 经 在 当前 会 话 里 定义 ， 那 就 是 一 个 错误 。 如 果 使 
用 了 参数 ， 那么 在 查询 里 它们 引用 成 $1 ， $2 等 等 。 nparams 是 参数 的 个 数 ， 参 数 的 类 型 
在 数组 paramTypes[] 里 事先 声明 好 了 。 (AOR nparams 是 雳 ， 那 么 这 个 数组 指针 可 以 

是 NULL o ) paramTypes[] 用 OID 的 方式 声明 与 参数 符号 关联 的 数据 类 型 。 如 

果 paramTypes 为 NULL ， 或 者 数组 中 某 个 特定 元 素 是 需 ， 那么 服务 器 将 用 义理 无 类 型 文本 同 
样 的 方法 给 这 个 参数 符号 赋予 数据 类 型 。 还 有 ， 查询 可 以 使 用 比 nParams 数值 更 大 的 参数 符 
号 编号 ; 也 为 这 些 符号 推断 数据 类 型 。 (参阅 Padescribeprepared 作为 一 个 找 出 推断 的 什么 
类 型 的 手段 。) 


和 PQexec 相似 ， 结 果 通 常 是 一 个 Presult WR, 其 内 容 表 明 服 务 器 端 是 成 功 还 是 失败 。 空 
的 结果 表示 内 存 耗 尽 或 者 完全 不 能 发 送 命 令 。 使 用 PaerrorMessage 获取 有 关 这 类 错误 的 更 多 
信息 。 

用 于 poexecPrepared 的 预备 语句 也 可 以 通过 执行 SQL PREPARE 语 句 来 创建 。 还 有 ， 尽 管 没 
有 libpq 画 数 可 以 删除 一 个 预备 语句 ， SQL DEALLOCATE 语 句 却 可 以 删除 。 


PQexecPrepared 


发 送 一 个 请 求 ， 执 行 一 个 带 有 给 出 参数 的 预备 语句 ， 并 且 等 待 结 果 。 


PGresult *PQexecPrepared(PGconn *conn, 
const char *stmtName, 
int nParams, 
const char * const *paramValues, 
const int *paramLengths, 
const int *paramFormats, 
int resultFormat); 


PQexecPrepared 和 PQexecParams 类 似 ， 但 是 要 执行 的 命令 是 通过 命名 一 个 前 面 准 备 好 的 语句 
声明 的 ， 而 不 是 给 出 一 个 查询 字 串 。 这 个 特性 允许 那些 要 重复 使 用 的 命令 只 进行 一 次 分 析 和 
规划 ， 而 不 是 每 次 执行 都 来 一 通 。 这 个 语句 必须 在 当前 会 话 的 前 面 已 经 准备 

Afo PQexecPrepared 只 在 协议 3.0 和 以 后 的 版 本 里 支持 ; 在 使 用 2.0 版 本 的 协议 的 时 候 ， 它 
们 会 失败 。 


参数 和 PQexecParams 一 样 ， 只 是 给 出 的 是 一 个 预备 语句 的 名 字 ， 而 不 是 一 个 查询 字 串 ， FHA 
没有 paramTypes[ ] 参数 ( 没 必 要 ， 因为 预备 语句 的 参数 类 型 是 在 创建 的 时 候 确 定 的 ) o 


PQdescribePrepared 
提交 请 求 以 获取 有 关 指 定 的 预备 语句 的 信息 ， 并 等 待 完成 。 


PGresult *PQdescribePrepared(PGconn *conn, const char *stmtName); 


PQdescribePrepared 允许 应 用 程序 获取 有 关 先 前 准备 的 语句 的 信息 。 PQdescribePrepared 只 
在 协议 3.0 和 以 后 的 版 本 里 支持 ; 在 使 用 2.0 版 本 的 协议 的 时 候 ， 它 们 会 失败 。 


stmtName 可 以 是 "" 或 NULL 以 指向 未 命名 声明 ， 要 么 必须 与 现 有 的 预备 语句 同名 。 成 功 
时 ， 会 返回 一 个 带 有 PGRES_coMMAND_oK 的 PGresult 。 可 以 在 这 个 Peresult 中 使 用 
PQnparams 和 PQparamtype 图 数 以 获得 预备 语句 的 参数 信息 ， 同 时 ponfields ， 

PQfname ， PQftype 等 函数 提供 声明 的 结果 列 (如 果 有 ) 的 信息 。 


PQdescribePortal 
提交 请 求 以 获取 有 关 指 定 的 端口 的 信息 ， 并 等 待 完成 。 


PGresult *PQdescribePortal(PGconn *conn, const char *portalName); 


PQdescribePortal 允许 应 用 程序 获得 关于 之 前 创建 的 端口 的 信息 。 (libpq 不 提供 与 端口 的 直 
接连 接 ， 但 可 以 使 用 这 个 辑 数 来 检查 ”DECLARE CURSOR 命令 创建 的 游标 的 属 
性 ) o PQdescribePortal 只 支持 3.0 及 其 之 后 的 连接 协议 ; 当 使 用 协议 2.0 时 会 失败 。 


portalName 可 以 是 "" 或 NULL 以 指向 未 命名 声明 ， 要 么 必须 与 现 有 的 预备 语句 同名 。 成 功 
时 ， 会 返回 一 个 带 有 pPGRES_coMMAND_oK 的 peresult 。 可 以 在 Peresult 中 使 用 
PQnfields , PQfname , PQftype 等 函数 获取 端口 的 结果 列 AIRA) 的 信息 。 


PGresult 结构 封装 了 服务 器 返回 的 结果 。libpq 应 该 小 心 维护 P6result 的 抽象 。 使 用 下 面 的 
ER P6result 的 内 容 。 避 免 直接 引用 Peresult 里 面 的 字段 ， 因为 它们 在 未 来 版 本 
可 能 会 被 修改 。 


PQresultStatus 


回 命 邻 的 结果 状态 。 


ExecStatusType PQresultStatus(const PGresult *res); 


PQresultStatus 可 以 返回 下 面 数 值 之 一 : 
PGRES_EMPTY_QUERY 
送 给 服务 器 的 字 串 是 空 的 。 
PGRES_COMMAND_OK 
成 功 完 成 一 个 不 返回 数据 的 命令 。 
PGRES_TUPLES_OK 


成 功 执行 一 个 返回 数据 的 查询 (比如 SELEcT 或 者 sow ) o 


PGRES_COPY_OUT 


(从 服务 器 ) Copy Out (拷贝 出 ) 数据 传输 开始 。 


PGRES_COPY_IN 


Copy In (4 RA) (到 服务 器 ) 数据 传输 开始 。 
PGRES_BAD_RESPONSE 

服务 器 的 响应 无 法 理解 。 
PGRES_NONFATAL_ERROR 


发 生 了 一 个 非 致 命 错误 (通知 或 者 警告 ) 。 


PGRES_FATAL_ERROR 


发 生 了 一 个 致命 错误 。 


PGRES_COPY_BOTH 


拷贝 入 /出 (到 和 从 服务 器 ) 数据 传输 开始 。 这 个 特性 当前 只 用 于 流 复 制 ， 所 以 这 个 状态 不 会 
在 普通 应 用 中 发 生 。 
PGRES_SINGLE_TUPLE 


PGresult 包含 一 个 来 自 当前 命令 的 结果 元 组 。 这 个 状态 只 在 查询 选择 了 单行 模式 时 发 生 (SE 
iJ Section 31.5) 。 


如 果 结 果 状 态 是 PGRES_TuPLES_oK 或 PGRES_SINGLE_TUPLE , 那么 可 以 用 下 面 的 函数 从 查询 的 返 
回 中 抽取 元 组 信息 。 注 意 一 个 碰巧 检索 了 震 条 元 组 的 SELECT 仍然 显示 PGRES_TUPLES_OK o 
PGRES_COMMAND_Ok 用 于 不 返回 元 组 的 命令 〈 没 有 RETURNING 子 名 的 INSERT, UPDATE 等 ) 。 
返回 PGRES_EMPTY_QUERY 的 响应 通常 意味 着 暴露 了 客户 端 软 件 里 面 的 臭虫 。 


状态 为 PGRES_NONFATAL_ERROR 的 结果 永远 不 会 直接 由 Paexec 或 者 其 它 查询 执行 图 数 返 回 ; 这 
类 的 结果 会 被 传递 给 通知 处 理 器 (参阅 Section 31.12) 。 


PQresStatus 


把 poresultstatus 返回 的 枚 举 类 型 转换 成 一 个 描述 状态 码 的 字符 串 常 量 。 调用 者 不 应 该 释放 
结果 。 


char *PQresStatus(ExecStatusType status); 


PQresultErrorMessage 
返回 与 查询 关联 的 错误 信息 ， 或 在 没有 错误 时 返回 一 个 空 字符 串 。 


char *PQresultErrorMessage(const PGresult *res); 


如 果 有 错误 ， 那 么 返回 的 字 串 将 包括 一 个 结尾 的 新 行 。 调 用 者 不 应 该 直接 释放 结果 。 在 相关 
的 Presult 句柄 传递 给 Paclear 之 后 ， 它 会 自动 释放 。 


紧 跟 在 一 个 PQexec 或 PQgetResult 调用 后 面 ， PQerrorMessage (对 连接 ) 将 返回 

与 PQresultErrorMessage (对 结 ) 一 样 的 字符 串 。 不 过 ， 一 小 PGresult 将 保有 其 苦 误 信息 直 
到 被 删除 ， 而 连接 的 错误 信息 将 在 后 续 的 操作 完成 时 被 改变 。 当 你 想 知 道 与 某 个 PGresult 
相关 联 的 状态 时 用 ParesultErrorMessage ; 当 你 想 知道 与 连接 的 最 近 一 个 操作 相关 联 的 状态 


时 用 PQerrorMessage o 


PQresultErrorField 
返回 一 个 独立 的 错误 报告 字段 。 
char *PQresultErrorField(const PGresult *res, int fieldcode); 
fieldcode 是 一 个 错误 字段 标识 符 ; 参阅 下 面 列 出 的 符号 。 如 果 peresult 不 是 错误 或 者 警告 


结果 或 者 不 包括 指定 的 字段 ， 那么 返回 nu 。 字 段 值 通常 将 不 包括 结尾 的 新 行 。 调 用 者 不 
应 该 直接 释放 结果 。 在 相关 联 的 Presult 句柄 传递 给 Paclear 之 后 ， 它 将 被 自动 释放 。 


下 列 代 码 是 可 用 的 : 


PG_DIAG_SEVERITY 


严重 程度 ， 这 个 字段 的 内 容 是 ERROR ， FATAL 或 者 panic (在 错误 信息 里 ) ,或 
者 WARNING , NOTICE, DEBUG, INF0 或 Loe (在 注意 信息 里 ) ， 或 者 是 这 些 东 西 的 一 个 
本 地 化 翻译 。 总 是 出 现 。 


PG_DIAG_SQLSTATE 


个 错误 的 SQLSTATE 人 代码。SQLSTATE 代 码 表示 所 发 生 的 错误 的 类 型 ; 可 以 由 前 端 应 用 用 
ae 错误 执行 特定 的 操作 (比如 错误 处 理 ) 。 可 能 的 SQLSTATE 代 码 的 列表 ， 
请 查看 Appendix A 这 个 字段 是 不 能 区 域 化 的 ， eg， 


PG_DIAG_MESSAGE_PRIMARY 

主要 的 人 类 可 读 错 误 的 信息 〈 通 常 一 行 ) 。 总 是 出 现 。 

PG_DIAG_MESSAGE_DETAIL 

细节 : 一 个 可 选 的 从 属 错误 信息 ， 里 面 有 更 多 有 关 该 问题 的 细节 。 可 能 有 多 行 。 
PG_DIAG_MESSAGE_HINT 

提示 : 一 个 可 选 的 有 关 如 何 义理 该 问题 的 建议 。 它 和 细节 的 区 别 是 它 提 供 了 建议 (可 能 不 太 
合适 ) 而 不 光 是 事实 。 可 能 有 好 几 行 。 

PG_DIAG_STATEMENT_POSITION 

一 个 包含 十 进 制 整数 的 字 串 ， 表 明 错 误 游 标的 位 置 ， 作 为 一 个 索引 指向 最 初 的 语句 字符 串 。 
第 一 个 字符 的 索引 是 1， 并 且 这 个 位 置 是 用 字符 计 ， 而 不 是 用 字 节 计 。 


PG_DIAG_INTERNAL_POSITION 


个 和 Pp6_DIAG_STATEMENT_POSITION 字段 定义 是 一 样 的 ， 区 别 是 它 在 游标 位 置 指向 内 部 生成 的 
Oa a 而 不 是 客户 端 提交 的 命令 。 如 果 出 现 了 这 个 字段 ， 那 


Z PG_DIAG_INTERNAL_QUERY 字段 也 总 是 出 现 。 


PG_DIAG_INTERNAL_QUERY 


一 个 失败 的 内 部 生成 的 命令 的 文本 。 比 如 ， 这 个 可 能 是 一 个 PL/pgSQL WK RK WEY SQL & 
询 。 


PG_DIAG_CONTEXT 


一 个 指示 器 ， 表 明 错 误 发 生 的 环境 。 目 前 这 个 包括 活跃 的 过 程 语言 琅 数 和 内 部 生成 的 查询 的 
调用 堆栈 跟踪 。 跟踪 是 每 行 一 条 ， 最 近 的 在 上 面 。 


PG_DIAG_SCHEMA_NAME 

如 果 错 误 与 特定 的 数据 库 对 象 相关 ， 那 么 是 包含 该 对 象 的 模式 名 GRA) 。 
PG_DIAG_TABLE_NAME 

如 果 错 误 与 特定 的 表 相 关 ， 那 么 是 该 表 的 名 字 。 (参考 模式 名 字段 获取 表 的 模式 的 名 字 。) 


PG_DIAG_COLUMN_NAME 


如 果 错 误 与 特定 的 表 字 段 相关 ， 那 么 是 该 字段 的 名 字 。 (参考 模式 和 表 名 字段 识别 该 表 。) 


PG_DIAG_DATATYPE_NAME 


如 果 错 误 与 特定 的 数据 类 型 相关 ， 那 么 是 该 数据 类 型 的 名 字 。 (参考 模式 名 字段 获取 数据 类 
型 的 模式 的 名 字 。) 


PG_DIAG_CONSTRAINT_NAME 


如 果 错 误 与 特定 的 约束 相关 ， 那 么 是 该 约束 的 名 字 。 参 考 上 面 列 出 的 字段 获取 相关 的 表 或 
域 。 (为 了 这 个 目的 ， 索 引 被 看 做 是 约束 ， 即 使 它们 是 用 约束 语法 创建 的 。) 


PG_DIAG_SOURCE_FILE 
报告 错误 的 源 代码 所 在 的 文件 名 。 
PG_DIAG_SOURCE_LINE 


报告 错误 的 源 代码 所 在 的 行 号 。 


PG_DIAG_SOURCE_FUNCTION 
PRAIA swans + 


Note: 只 为 有 限 的 错误 类 型 提供 模式 名 、 表 名 、 字 段 名 、 数 据 类 型 名 和 约束 名 字段 ; 参 
阅 Appendix A。 不 要 假设 这 些 字段 的 出 现 会 保证 其 他 字段 的 出 现 。 核心 错误 来 源 观察 以 
上 提 到 的 相互 关系 ， 但 是 用 户 定义 的 函数 可 以 以 其 他 方式 使 用 这 些 字 段 。 同样 的 ， 不 要 
假设 这 些 字段 表示 当前 数据 库 中 的 同时 期 对 象 。 
按照 自身 的 要 求 格 式 化 显示 信息 是 客户 端的 责任 ; 特别 是 根据 需要 对 长 行进 行 折 行 。 在 错误 
信息 字段 里 出 现 的 新 行 字符 应 该 当 作 分 段 符号 ， 而 不 是 换行 。 


libpq 生 成 的 错误 将 会 有 严重 性 和 主 信息 ， 但 是 通常 


没 它 字段 。 3.0 协议 之 前 返回 的 错误 
将 包含 严重 性 和 主 信 息 ， 有 时 候 还 有 详细 信息 ， 但 是 没有 其 它 


请 青 注意 ; 这 些 错 误 字 段 只 能 从 pcresult 对 象 里 获得 ， 而 不 是 Pecon 对 象 ; 没 
有 PQerrorField kX WAX, 


PQclear 


释放 与 Presult 相关 联 的 存储 空间 。 任何 不 再 需要 的 查询 结果 都 应 该 用 Paclear 释放 掉 。 


void PQclear(PGresult *res); 


只 要 你 需要 ， 你 可 以 保留 Peresult 对 象 任意 长 的 时 间 ; 当 你 提交 新 的 查询 时 它 并 不 消失 ， 其 
至 你 断 开 连接 后 也 是 这 样 。 要 删除 它 ， 你 必须 调用 PQclear 。 不 这 人 么 做 将 导致 你 应 用 中 的 内 
存 泄漏 。 


31.3.2. 检索 查询 结果 信息 


RERRMAFM—-TARBRD AiR (也 就 是 说 ， 状 态 为 P6RES_TUPLES_ok 或 
PGRES_SINGLE_TUPLE 的 查询 ) 的 pcresult 对 象 中 抽取 信息 。 它们 也 可 以 用 于 从 一 个 成 功 描述 
操作 中 抽取 信息 : 一 个 描述 的 结果 和 实际 查询 的 执行 将 要 提供 的 结果 有 所 有 相同 的 字段 信 
息 ， 但 是 它 有 需 行 。 对 于 其 它 状态 值 的 对 象 ， 他 们 的 行为 会 好 像 他 们 有 需 行 和 雳 列 一 样 。 


PQntuples 


返回 查询 结果 里 的 行 〈 元 组 ) 个 数 。 因 为 它 返 回 一 个 整数 的 结果 ， 在 32 位 操作 系统 上 大 型 结 
果 集 可 能 浴 出 返回 值 。 


int PQntuples(const PGresult *res); 
PQnfields 
返回 查询 结果 里 数据 行 的 列 (字段 ) 的 个 数 。 
int PQnfields(const PGresult *res); 


PQfname 


返回 与 给 出 的 字段 编号 相关 联 的 字段 名 。 字 段 编号 从 0 开始 。 调 用 者 不 应 该 直接 释放 结果 。 
在 相关 联 的 Peresult 句柄 传递 给 PQclear 之 后 ， 结 果 会 被 自动 释放 。 


char *PQfname(const PGresult *res, 
int column_number ); 


如 果 字 段 编 号 超出 范围 ， 那 么 返回 nu o 


PQfnumber 
返回 与 给 出 的 字段 名 相关 的 字段 编号 。 


int PQfnumber(const PGresult *res, 
const char *column_name); 


如 果 给 出 的 名 字 不 匹配 任何 字段 ， 返 回 -1。 


给 出 的 名 字 是 当 作 SQL 命令 里 的 一 个 标识 符 看 待 的 ， 也 就 是 说 ， 如 果 没 有 加 双 引 号 ， 那么 会 
转换 为 小 写 。 上 比如 ， 如 果 我 们 有 一 个 从 SQL 命令 里 生成 的 查询 结果 : 


SELECT 1 AS FOO, 2 AS "BAR"; 


那么 我 们 会 有 下 面 的 结果 : 


PQfname(res, 0) foo 


PQfname(res, 1) _BAR_ 

PQfnumber(res, "FOO") COS 

PQfnumber(res, "foo") 2o02 

PQfnumber(res, "BAR") _-1_ 

PQfnumber(res, "\"BAR\"") pols 
PQftable 


返回 我 们 抓 取 的 字段 所 在 的 表 的 OID。 字 段 编号 从 0 开始 。 


Oid PQftable(const PGresult *res, 
int column_number); 


如 果 字 段 编号 超出 了 范围 ， 或 者 声明 的 字段 不 是 一 个 指向 某 个 表 的 字段 的 简单 引用 ， 或 者 使 
用 了 3.0 版 本 之 前 的 协议 ， 那 么 就 会 返回 Invalidoid o 你 可 以 查询 系统 表 pg_class 来 判断 
究竟 引用 了 哪个 表 。 


在 你 包含 libpq 头 文件 的 时 候 ， 就 会 定义 类 型 oid 和 常量 Invalidoid 。 他 们 都 是 相同 的 整数 
类 型 。 
PQftablecol 


返回 组 成 声明 的 查询 结果 字段 的 字段 号 (在 它 的 表 内 部 ) 。 查 询 结果 字段 编号 从 0 开始 ， 但 
是 表 字 段 编号 不 会 是 0。 


int PQftablecol(const PGresult *res, 
int column_number ); 


如 果 字 段 编号 超出 范围 ， 或 者 声明 的 字段 并 不 是 一 个 表 字 段 的 简单 引用 ， 或 者 使 用 的 是 3.0 
之 前 的 协议 ， 那 么 返回 需 。 


PQfformat 
返回 说 明 给 出 字段 的 格式 的 格式 代码 。 字 段 编号 从 0 开始 。 


int PQfformat(const PGresult *res, 
int column_number ) ; 


格式 码 为 0 表示 文本 数据 ， 而 格式 码 是 一 表示 二 进 制 数 据 。 《其它 编码 保留 给 将 来 定义 。) 
PQFtype 

返回 与 给 定 字段 编号 关联 的 数据 类 型 。 返 回 的 整数 是 一 个 该 关 型 的 内 部 OID 号 。 字 段 编号 从 0 
开始 。 


Oid PQftype(const PGresult *res, 
int column_number); 


你 可 以 查询 系统 表 pg_type 以 获取 各 种 数据 类 型 的 名 称 和 属性 。 内 建 的 数据 类 型 的 OID 在 源 
码 树 的 src/include/catalog/pg_type.h 文件 里 定义 。 


PQfmod 
返回 与 给 定 字段 编号 相关 联 的 字段 的 类 型 修饰 符 。 字 段 编号 从 0 开始 。 


int PQfmod(const PGresult *res, 
int column_number); 


类 型 修饰 符 的 值 是 类 型 相关 的 ; 他 们 通常 包括 精度 或 者 尺寸 限制 。 数值 -1 用 于 表示 "没有 可 
用 信息 "。 大 多 数 数据 类 型 不 用 修饰 词 ， 这 种 情况 下 该 值 总 是 -1。 


PQfsize 


返回 与 给 定 字段 编号 关联 的 字段 以 字 节 计 的 大 小 。 字 段 编号 从 0 开始 。 


int PQfsize(const PGresult *res, 
int column_number); 


pafsize 返回 在 数据 库 行 里 面 给 该 数据 字段 分 配 的 空间 ， 换 句 话说 就 是 该 数据 关 型 在 服务 器 
的 内 部 表现 形式 的 大 小 (尺寸 ) 。 (因此 ， 这 个 对 客户 端 没有 什么 用 。) ” 负 值 表示 该 数据 类 
型 是 可 变 长 度 。 


PQbinaryTuples 


如 果 Pcresult 包含 二 进 制 数据 时 返回 1， 如 果 包 含 文本 数据 返回 0。 


int PQbinaryTuples(const PGresult *res); 


RTPBRACARFET (除了 还 用 于 和 与 COPY 连接 之 外 ) 7 因为 我 们 可 能 在 一 个 PGresult 的 某 
些 字 段 里 包含 文本 数据 ， 而 另外 一 些 字段 包含 二 进 制 数 据 。 更 好 的 是 使 用 Pafformat o 
PQbinaryTuples 只 有 在 结果 中 的 所 有 字段 都 是 二 进 制 (格式 1) 的 时 候 才 返回 1。 


PQgetvalue 


返回 一 个 Peresult 里 面 一 行 的 单独 的 一 个 字段 的 值 。 行 和 字段 编号 从 0 开始 。 调 用 者 不 应 该 
直接 释放 结果 。 在 把 Presult 句柄 传递 给 Paclear 之 后 ， 结 果 会 被 自动 释放 。 


char *PQgetvalue(const PGresult *res, 
int row_number, 
int column_number); 


对 于 文本 格式 的 数据 ， pogetvalue 返回 的 值 是 一 个 表示 字段 值 的 空 (NULL) 结尾 的 字符 
串 。 对 于 二 进 制 格式 ， 返 回 的 值 就 是 由 该 数据 类 型 的 typsend 和 typreceive 决定 的 二 进 制 表 
现形 式 。 〈 在 这 种 情况 下 ， 数值 实际 上 也 跟着 一 个 字 节 需 ， 但 是 通常 这 个 字 节 没什么 用 处， 
因为 数值 本 身 很 可 能 包含 内 嵌 的 空 。) 


如 果 字 段 值 是 空 ， 则 返回 一 


PQgetvalue 返回 的 指针 指向 一 个 本 身 是 PGresult 
它 ， 并 且 如 果 我 们 要 在 PGresult 
拷贝 到 其 他 存储 器 中 。 


PQgetisnull 


测试 一 个 字段 是 否 为 空 (NULL) 。 行 


int PQgetisnull(const PGresult *res, 


int row_number 
int column_number ); 


如 果 该 域 包 含 NULL 


， 图 数 返 回 1 
NULL 字段 ， 


PQgetvalue 将 返回 


个 空 字符 串 ， 不 是 一 
PQgetlength 


返回 以 字 节 计 的 字段 的 长 度 。 行 和 字段 编号 从 0 开始 。 
int PQgetlength(const PGresult *res, 


int row_number 
int column_number); 


这 是 


特定 数值 的 实际 数据 长 度 ， 也 就 是 说 ， 
Ra TA strlen() 相同 。 对 于 二 进 制 格式 ， 


这 是 基本 信息 。 
取 实 际 数据 长 度 。 

PQNparams 

返回 一 个 预备 语句 中 的 参数 的 数目 。 

int PQnparams(const PGresult *res); 

有 在 检查 PQdescribePrepared P Ra, RANA AMAK. 
=, 
PQparamtype 

返回 指示 语句 中 的 参数 的 数据 类 型 。 参 数 编号 从 0 开始 。 


Oid PQparamtype(const PGresult *res, int param_number); 


有 在 检查 PQdescribePrepared 的 结果 时 ， 这 个 回 交 
Bo 


数 是 有 用 的 。 


PQprint 


结构 的 一 
结构 的 生存 期 后 还 要 使 用 它 的 话 ， 我 们 必须 明确 地 把 该 数值 


， 如 果 包 含 非 空 (non-null ) 值 
个 空 指针 。 ) 


PQgetvalue 指向 的 对 象 的 大 小 。 


个 空 字 串 。 参 阅 PQgetisnull 来 区 别 空 值 和 空 字 串 值 。 


部 分 的 存储 区 域 。 我 们 不 能 更 改 


行 和 字段 编号 从 0 开始 。 


， 返 回 0。 (注意 ， 对 一 个 


对 于 文本 数据 格 
请 注意 我 们 不 应 该 依靠 Paofsize 


对 于 其 他 类 型 的 查询 将 返回 


对 于 其 他 类 型 的 查询 将 返回 


向 指定 的 输出 流 打印 所 有 的 行 和 (可 选 的 ) 字段 名 称 。 


void PQprint(FILE *fout, /* 输出 流 */ 
const PGresult *res, 
const PQprintOpt *po); 
typedef struct 


pqbool header; /* 打印 输出 字段 头 和 行 计 数 */ 
pqbool align; /* 填充 对 齐 字段 */ 

pqbool standard; /* 旧 的 格式 */ 

pqbool html3; /* 输出 HTML 表 */ 

pqbool expanded; /* JRR */ 

pqbool pager; /* 必要 时 在 输出 中 使 用 分 页 器 */ 


char *fieldSep; ”/* 字段 分 隔 符 */ 

char *tableOpt; /* HTML 表 格 元 素 的 属性 */ 

char *caption; /* HTML 表 标题 */ 

char **fieldName; /* 替换 字段 名 组 成 的 空 结尾 的 数组 */ 
} PQprintOpt; 


DRAMA psd AFERA Wee, HEREGBZFARTOAT. 请 注意 它 假设 所 有 
的 数据 都 是 文本 格式 。 


31.3.3. 检索 其 它 命 分 的 结果 信息 


这 些 酌 数 用 于 从 Peresult 对 象 里 检索 其 他 信息 。 


PQcmdStatus 
返回 产生 peresult 的 SQL 命 使 的 命 合 状 态 标签 。 


char *PQcmdStatus(PGresult *res); 


通常 这 只 是 命令 的 名 字 ， 但 是 它 可 能 包括 额外 的 数据 ， 比 如 义理 过 的 行 数 。 调 用 者 不 应 该 直 
接 释放 结果 。 结果 会 在 把 Presult 句柄 传递 给 Paclear 的 时 候 释放 。 


PQcmdTuples 
返回 被 SQL 命令 影响 的 行 的 数量 。 


char *PQcmdTuples(PGresult *res); 


x SHAGREI-TS4HH8, GS Peresult 产生 的 SQL 语句 影响 的 行 数 。 这 个 函数 只 能 用 于 下 
列 的 执行 : SELECT , CREATE TABLE AS, INSERT, UPDATE, DELETE, MOVE, FETCH , 
或 者 copy 语句 ， 或 者 是 一 个 包含 INSERT, UPDATE 或 DELETE 语句 的 预备 查询 

的 execute 。 如 果 生 成 这 个 Presult 的 命令 是 其 他 的 东西 ， 那么 PacmdTuples 返回 一 个 空 字 
串 。 调 用 者 不 应 该 直接 释放 返回 的 数值 。 在 相关 联 的 Presult 被 传递 给 Paclear 之 后 ， 它 会 
被 自动 释放 。 


PQoidValue 


返回 插入 的 行 的 OID， 如 果 SQL 命 令 是 INsERT ， 插 入 了 正好 一 行 到 有 OID 的 表格 ， 或 者 是 一 
个 包含 合适 insert 语句 的 预备 查询 execute 的 时 候 。 否则 ， 男 数 返 回 Invalidoid o WÈ 
受 INSERT 影响 的 表 不 包含 OID， 也 返回 Invalidoid o 


Oid PQoidValue(const PGresult *res); 


PQoidStatus 


为 了 支持 Pooidvalue , RNHRMEBRAT, HETEREN. 它 返 回 插入 行 的 带 有 
OID 的 字符 串 ， 而 PQoidvalue 返回 OID 值 。 


char *PQoidStatus(const PGresult *res); 


31.3.4. LeASESQLA TPF 


PQescapeLiteral 


char *PQescapeLiteral(PGconn *conn, const char *str, size_t length); 


PQescapeLiteral 为 在 SQL 命令 中 使 用 字 串 而 对 之 进 HITER, 在 我 们 向 SQL 命令 里 把 
数据 值 当 作 文本 常量 插 和 人 的 时 候 很 有 用 。 有 些 字 符 〈 比 如 单 引 号 和 反 斜 枉 ) 必须 被 逃逸 ， 以 
避免 他 们 被 SQL 分 析 器 作为 特殊 字符 解析 。 PaescapeLiteral 执行 这 个 操作 。 


PQescapeLiteral 返回 一 个 内 存 中 分 配 有 malloc() 的 str gle 当 结 果 不 再 需要 
时 ， 需 要 通过 PQfreemem() Dd i 不 需要 一 结束 ， 并 且 不 应 以 length 
数 。 (如 果 在 处 理 length 字 节 之 前 出 现 0 字 Pi PQescapeLiteral 在 此 处 结束 ; 这 
行为 有 点 像 strncpy ) 。 返 回 的 字符 串 中 所 有 特殊 字符 都 替换 掉 了 ， 因此 可 以 很 好 的 被 
PostgreSQL 字 符 串 文本 解析 器 处 理 ， 同 样 ， 人 允许 增加 一 个 0 字 节 结尾 。 必 须 在 PostgreSQL 
字符 串 文 本 两 边 的 单 引 号 包含 在 结果 字符 串 中 。 


一 旦 错误 ， PQescapeLiteral 返回 NULL 并 在 conn 对 象 中 存储 合适 的 信息 。 





Tip: 处 理 从 不 可 信 来 源 收 到 的 字符 串 时 必须 进行 合适 的 逃逸 ， 否 则 存在 一 定 的 安全 风 
fe: 容易 受到 "SQL 注入 "攻击 ， 数 据 库 中 会 被 宇 入 未 知 的 SQL 命 合 。 





需要 注意 的 是 ， 当 一 个 数据 以 PQexecParams 或 它 的 兄弟 格式 ， 作为 一 个 单独 的 参数 传递 时 ， 
做 逃逸 是 不 必要 ， 也 是 不 正确 的 。 


PQescapeIdentifier 


char *PQescapeIdentifier(PGconn *conn, const char *str, size_t length); 


PQescapeldentifier 逃逸 一 个 字符 串 作 为 一 个 SQL 标识 符 使 用 ， 如 一 个 表 ， 列 ， ARESE 
当 一 个 用 户 自 定义 标识 符 需 要 包含 特殊 的 字符 ， 否则 将 不 能 被 SQL 解析 器 解析 为 标识 符 的 一 
部 分 时 ， 或 者 当 标 识 符 需 要 包含 大 写字 母 ， 且 这 种 情况 必须 保留 时 ， 这 样 做 是 很 有 用 的 。 


PQescapeIdentifier 返回 str 参数 逃逸 为 一 个 内 存 中 分 配 有 malloc() 的 SQL 标识 符 的 版 
本 。 当 结果 不 再 需要 时 ， 这 块 内 存 必须 使 用 Pafreemem() 来 释放 。 不 需要 一 个 0 字 节 结束 ， 并 
且 不 应 以 length 计数 。 (如 果 在 处 理 length 字 节 之 前 出 现 0 字 节 的 结 

R, PQescapeldentifier 在 此 处 结束 ; 这 个 行为 比较 像 strncpy ) o 返回 的 字符 串 中 所 有 特 
殊 字符 都 替换 掉 了 ， 因此 可 以 很 好 的 作为 SQL 标识 符 被 处 理 。 也 可 以 添加 一 个 结尾 的 0 字 节 。 
返回 字符 串 也 是 被 双 引 号 环绕 。 


出 错时 ， PQescapeIdentifier 返回 NULL ， 并 且 在 conn 对 象 中 存 贮 合适 的 信息 。 


Tip: 由 于 带 有 字符 串 弟 量 ， 为 阻止 SQL 注入 攻击 ， 当 从 一 个 不 可 信任 资源 获得 时 ，SQL 








标识 符 必 须 逃 逸 。 


PQescapeStringConn 


size_t PQescapeStringConn(PGconn *conn, 
char *to, const char *from, size_t length, 
int *error); 


PQescapeStringConn 逃逸 字符 串 常 量 ， 比较 像 PQescapeLiteral 。 不 同 于 PQescapeLiteral , 
请 求 应 该 提供 一 个 适当 大 小 的 缓冲 区 。 更 重要 的 是 ， PQescapestringconn 不 会 生成 一 个 必须 
在 PostgreSQL 字符 串 常 量 两 端的 单 引号 ; SQL 命令 中 应 该 提供 ， 这 样 结果 中 会 被 插 

A. fron 参数 指向 字符 串 的 第 一 个 字符 (AARE) ， length 参数 指出 了 在 这 个 字符 串 中 
的 字 节 数 。 不 需要 一 个 0 字 节 结束 ， 并 且 不 应 以 length 计数 。 (如 果 在 义理 length FIZ 
前 出 现 0 字 节 的 结束 ， PQescapestringconn 在 此 处 结束 ; 这 个 行为 比较 像 strncpy ) o to 应 
该 指向 一 个 包含 至 少 多 于 两 倍 length 大 小 的 缓冲 区 ， 要 么 就 不 会 定义 该 行为 。 如 

果 to 和 frm 字符 串 交 壹 ， 那 么 也 不 会 定义 该 行为 。 


error 参数 非 NULL ， 那 么 在 成 功 的 时 候 *error SREBAS, 失败 的 时 候 设 置 为 非 0。 目 
前 唯一 可 能 的 错误 条 件 涉 及 在 源 字 符 串 中 无 效 的 多 字 节 编码 。 输出 字符 串 同样 产生 错误 ， 但 
服务 器 可 以 视 其 为 异常 以 拒绝 。 一 日 发 生 错 误 ， 一 条 合适 的 信息 会 存储 在 conn 对 象 中 ， 无 
论 error 是 否 为 NULL 。 

PQescapeStringConn 返回 写 到 to 的 字 节 数 ， 不 包含 0 字 节 终止 。 


PQescapeString 


PQescapeString 是 一 个 老 的 ， 已 经 被 Paescapestringconn 弃 用 了 的 版 本 。 


size_t PQescapeString (char *to, const char *from, size_t length); 


与 PQescapeStringConn 唯一 的 不 同 是 ， PQescapeString 不 使 用 PGconn 或 error 参数 。 
此 ， 不 能 够 根据 连接 属性 (如 字符 编码 ) 来 调整 其 行为 ， 因 此 可 能 会 给 出 错误 的 结果 ， 同 
样 ， 不 会 报告 错误 条 件 。 


PQescapeString 可 以 在 客户 端 编程 〈 一 次 只 有 一 个 PostgreSQL 连 接 ) 中 安全 的 使 用 。 在 这 种 
情况 下 ， 它 可 以 找到 "在 屏幕 背后 " 想 要 知道 的 。 在 其 他 情况 下 ， 这 是 一 个 安全 隐患 ， 使 
用 PQescapeStringconn 时 应 该 避免 。 


PQescapeByteaConn 


逃逸 那些 在 SQL 命令 中 使 用 的 用 bytea 表示 的 二 进 制 数据 。 和 poescapestringconn 一 样 ， 这 
个 函数 只 有 在 直接 向 SQL 字 串 插入 数据 的 时 候 使 用 。 


unsigned char *PQescapeByteaConn(PGconn *conn, 
const unsigned char *from, 
size_t from_length, 
size_t *to_length); 


在 SQL 语句 中 用 做 bytea 字 串 文本 的 一 部 分 的 时 候 ， 有 些 字 节 值 必 需 逃 


i. PQescapeByteaConn 逃逸 字 节 使 用 十 六 进 制 编码 或 反 斜 杠 逃 逸 。 参阅 Section 8.4 获 取 更 多 
息 。 


—_> 
Dili 


fron 参数 指向 需要 逃逸 的 字 串 的 第 一 个 字 节 ， from_length 参数 反映 在 这 个 二 进 制 字 串 (4 
尾 的 字 节 需 既 不 必要 也 不 计算 在 内 ) 里 字 节 的 个 数 。 to_length 参数 指向 一 个 变量 ， 它 保存 
逃逸 后 字符 串 长 度 的 结果 。 结果 字 串 长 度 包括 结果 结尾 的 需 字 节 。 


PQescapeByteaConn 在 内 存 中 返回 一 个 from 参数 的 二 进 制 字 串 的 逃逸 后 的 版 本 ， 这 片 内 存 是 
用 malloc() 分 配 的 在 不 再 需要 结果 的 时 候 ， 必 须 用 Pafreemem() 释放 内 存 。 返回 的 字 串 已 经 
把 所 有 特殊 的 字符 替换 掉 了 ， 这 样 他 们 就 可 以 由 PostgreSQL 的 字 串 文本 分 析 器 以 及 bytea 的 
输入 图 数 正确 地 人 处理 。 同 时 还 追加 了 一 个 结尾 的 字 节 需 。 那些 必需 包围 在 PostgreSQL 字 串 文 
本 周围 的 单 引 号 并 非 结 果 字 串 的 一 部 分 。 


当 出 错时 ， 返 回 一 个 空 指针 ， 一 个 合适 的 错误 信息 会 被 储存 在 conn 对 象 中 ， 当前 唯一 可 能 
的 错误 是 结果 字符 串 的 内 存 不 足 。 


PQescapeBytea 
PQescapeBytea 是 PQescapeByteaConn 的 一 个 旧 的 ， 过 时 的 版 本 。 


unsigned char *PQescapeBytea(const unsigned char *from, 
size_t from_length, 
size_t *to_length); 


& pgescapeByteaconn 唯一 的 不 同 之 处 在 于 ， PQescapeByteaconn 不 使 用 peconn 参数 ， 
itt, PQescapeBytea 可 以 在 客 户 端 编 程 (一 次 只 有 一 个 PostgreSQL 连 接 ) 中 安全 的 使 用 。 在 
这 种 情况 下 ， 它 可 以 找到 "在 屏幕 背后 " 想 要 知道 的 。 如 果 在 编程 中 使 用 多 个 数据 库 连接 (在 
这 种 情况 下 使 用 poescapeByteaconn ) ， 那 么 可 能 会 给 出 错误 结果 。 


PQunescapeBytea 


把 一 个 二 进 制 数据 的 字符 串 表 现形 式 转换 成 二 进 制 数据 一 poescapesytea 的 反作用 。 在 以 文 
本 格式 抽取 bytea 数据 的 时 候 是 必须 的 ， 但 是 在 以 二 进 制 格式 抽取 的 时 候 是 不 必要 的 。 


unsigned char *PQunescapeBytea(const unsigned char *from, size_t *to_length); 


fron 参数 指向 一 个 字符 串 ， 上 比如 应 用 到 bytea 字段 时 ， Pagetvalue 返回 

的 。 PQunescapeBytea 把 它 的 字 串 表现 形式 转换 成 二 进 制 形式 ， 它 返 回 一 个 用 malloc() 分 配 
的 指向 该 缓冲 区 的 指针 ， 或 者 是 出 错时 返回 NULL ， 缓 冲 区 的 尺寸 放 在 to_length 里 。 在 不 再 
需要 这 个 结果 之 后 ， 这 片 内 存 必须 用 Pafreemem 释放 。 


这 个 转换 不 正好 是 PaescapeBytea Wiki, AA, HM PQgetvalue 接收 时 ， 字 符 串 不 希望 
被 "逃逸 "。 尤 其 是 ， 这 意味 着 ， 不 需要 考虑 字符 串 引 用 ， 并 且 不 需要 Pecon 参数 。 


31.4. 异步 命令 义理 


PQexec 图 数 对 普通 的 同步 应 用 里 提交 命 命 已 经 是 足够 用 的 了 。 但 是 它 却 有 几 个 缺陷 ， 而 这 些 
缺陷 可 能 对 某 些 用 户 很 重要 : 


。 ”PQexec 等 待命 令 结 束 。 而 应 用 可 能 还 有 其 它 的 工作 要 做 〈 比 如 维护 用 户 界面 等 ) ， 
时 候 它 可 不 想 阻 塞 在 这 里 等 待 响应 。 


。 因为 客户 端 应 用 在 等 待 结 果 的 时 候 是 处 于 挂 起 状态 的 ， 所 以 应 用 很 难 判 断 它 是 否 该 尝试 
SERIE HTN. (这 个 事情 可 以 在 一 个 信号 处 理 器 中 做 ， 但 是 没 别 的 方法 。) 


© PQexec 只 能 返回 一 个 Presult 结构 。 如 果 提 交 的 命令 字符 串 包 含 多 个 SQL 命令 ， 除 了 
最 后 一 个 PGresult 以 外 都 会 被 Paexec HF. 


e。 Paexec 总 是 收集 命令 的 整个 结果 ， 将 其 缓存 在 一 个 Presult 中 。 虽然 这 为 应 用 简化 了 
错误 处 理 逻 辑 ， 但 是 对 于 包含 多 行 的 结果 是 不 切实 际 的 。 


不 想 受 到 这 些 限制 的 应 用 可 以 改 用 下 面 的 范 数 ， 这 些 琅 数 也 是 构造 Pqexec KIE 

数 : PQsendQuery 和 PQgetResult 。 也 有 PQsendQueryParams , PQsendPrepare ， 
PQsendQueryPrepared , PQsendDescribePrepared 和 PQsendDescribePortal , 他 们 可 以 
和 pagetResult 一 起 使 用 ， 分 别 用 于 复制 PaQexecParams , PQprepare , 


PQexecPrepared , PQdescribePrepared 和 PQdescribePortal 的 功能 。 


PQsendQuery 


向 服务 器 提交 一 个 命令 而 不 等 竺 结果。 如 果 查 询 成 功 发 送 则 返回 1， 否 则 返回 0。 (此 时 ， 
可 以 用 paerrorMessage 获取 关于 失败 的 信息 ) 。 


int PQsendQuery(PGconn *conn, const char *command); 


在 成 功 调用 PQsendQuery 后 ， 调 用 PagetResult 一 次 或 者 多 次 获取 结果 。 在 PQgetResult 返回 
NULL 指针 ， 表明 命令 完成 之 前 ， 我 们 不 能 再 调用 Pasendauery a 


PQsendQueryParams 


Aiyaree — “Nop 3 DAS SN, TNE E 


int PQsendQueryParams(PGconn *conn, 
const char *command, 
int nParams, 
const Oid *paramTypes, 
const char * const *paramValues, 
const int *paramLengths, 
const int *paramFormats, 
int resultFormat); 


这 个 等 效 于 PasendQuery ， 只 是 查询 参数 可 以 和 查询 字 串 分 开 声明 。 回 数 的 参数 处 理 
N PQexecParams 一 样 。 和 PQexecParams 类 似 ， 它 不 能 在 2.0 版 本 的 协议 连接 上 工作 ， 并 且 
只 多 许 在 查询 字 串 里 出 现 一 条 命令 。 


PQsendPrepare 
发 送 一 个 请 求 ， 创 建 一 个 给 定 参数 的 预备 语句 ， 而 不 等 待 结 


int PQsendPrepare(PGconn *conn, 
const char *stmtName, 
const char *query, 
int nParams, 
const Oid *paramTypes); 


这 是 Paprepare 的 异步 版 本 : 如 果 它 能 发 送 这 个 请 求 ， 则 返 ， 如 果 不 能 ， 则 返回 0。 在 成 
功 调用 之 后 ， 调 用 PagetResult eal aaa 25), IARRAS 
理 和 PQprepare 一 样 。 类 似 PQprepare ， 能 在 2.0 版 本 协议 的 连接 上 运 云 转 。 
PQsendQueryPrepared 


发 送 一 个 请 求 执行 带 有 给 出 参数 的 预备 语句 ， 不 等 待 结 


int PQsendQueryPrepared(PGconn *conn, 
const char *stmtName, 
int nParams, 
const char * const *paramValues, 
const int *paramLengths, 
const int *paramFormats, 
int resultFormat); 


3X PENAL LL pasendqueryParams , 但 是 要 执行 的 命令 是 通过 给 一 个 前 面 准备 好 的 语句 命名 来 
声明 的 ， 而 不 是 给 出 一 个 查询 字 串 。 KARAR EAN PQexecPrepared 一 样 。 类 
似 PQexecPrepared ， 它 也 不 能 在 2.0 版 本 的 协议 连接 上 工作 。 


PQsendDescribePrepared 


提交 一 个 请 求 ， 获 取 关 于 指定 的 预备 语句 的 信息 ， 不 等 待 结 


int PQsendDescribePrepared(PGconn *conn, const char *stmtName); 


这 是 PQdescribePrepared 的 一 个 异步 版 本 : 如 果 它 能 发 送 这 -1 o 则 返回 1, 如 果 不 能 
则 返回 0。 在 成 功 调用 之 后 ， 调 用 PagetResult 获取 “ae 这 个 画 数 的 参数 的 处 理 

和 PQdescribePrepared 一 样 。 类 似 padescribePrepared ， 它 sare 2.0 版 本 协议 的 连接 上 运 
转 。 


PQsendDescribePortal 


发 出 请 求 ， 以 获得 关于 指定 端口 的 信息 ， 不 需要 等 待 完成 。 


int PQsendDescribePortal(PGconn *conn, const char *portalName); 


这 是 一 个 PadescribePortal 的 异步 版 本 : 如 果 它 能 发 送 这 个 请 求 ， 那 么 返回 1， 否则 返回 0。 
成 功 调 用 之 后 ， 通 过 pogetResult 获得 结果 。 画 数 参数 义理 与 pgqdescribePortal 相同 。 类 似 
于 pQdescribePortal ， 不 能 在 2.0 的 协议 连接 上 工作 。 


PQgetResult 


等 待 从 前 面 PQsendQuery , PQsendQueryParams ， PQsendPrepare , PQsendQueryPrepared ， 
PQsendDescribePrepared 或 者 PQsendDescribePortal 调用 返回 的 下 一 个 结果 ， 然 后 返回 之 。 
当 命令 结束 并 且 没 有 更 多 结果 后 返回 NULL. 


PGresult *PQgetResult(PGconn *conn); 


必须 重复 的 调用 PaQgetResult ， 直 到 它 返 回 空 指针 ， 表 明 该 命令 结束 。 (如 果 在 没有 活跃 的 
命令 时 调用 ， PQgetResult 将 只 是 立即 返回 一 个 空 指 针 。 ) 每 个 PQgetResult 返回 的 非 NULL 
结果 都 应 该 用 前 面 描述 的 peresult 访问 函数 进行 分 析 。 不 要 忘 了 在 结束 分 析 后 用 PQclear 
释放 每 个 结果 对 象 。 注 意 ， PQgetResult 只 是 在 有 一 个 命令 是 活路 的 而 且 必 须 返 回 数 的 据 还 
没有 被 PQconsumeInput 读 取 时 阻塞 。 





Note: 即使 在 poresultstatus 表明 一 个 致命 的 错误 时 ， 也 应 该 调用 pagetResult 直到 它 
返回 一 个 空 指针 ， 以 允许 libpq 完 全 的 处 理 错误 信息 。 

















使 用 posendquery 和 pagetResult 解决 了 PQexec 的 一 个 问题 : 如 果 一 个 命令 字符 串 包 含 多 个 
SQL 命令 ， 这 些 命令 的 结果 可 以 独立 的 获得 。 (这 样 就 允许 一 种 简单 的 重 登 处理 模式 ， 顺便 
说 一 句 : 客户 端 可 以 处 理 一 个 命令 的 结果 而 服务 器 可 以 仍然 在 义理 同一 命令 字符 串 后 面 的 查 
询 。) 


另 一 个 可 以 用 Pasendauery 和 PQgetResult 获得 的 经 常 需要 的 特性 是 一 次 检索 大 型 连续 查询 
结果 。 这 在 Section 31.5 中 讨论 。 


单独 的 ， 调 用 PagetResult 将 仍然 导致 客户 端 阻塞 ， 直到 服务 器 完成 下 一 个 SQL 命 合 。 可 以 
通过 适当 的 使 用 两 个 本 数 避免 : 


PQconsumeInput 


如 果 存 在 服务 器 来 的 输入 可 用 ， 则 使 用 之 。 


int PQconsumeInput(PGconn *conn); 


PQconsumeInput 通常 返回 1 表明 "没有 错误 "， 而 返回 0 表明 有 某 种 错误 发 生 ， (这 个 时 候 可 
以 用 PaerrorMessage ) 。 注意 这 个 结果 并 不 表明 实际 上 是 否 收集 了 输入 数据 。 在 调 

用 PQconsumeInput 之 后 ， 应 用 可 以 检查 PQisBusy 和 /或 PQnotifies 看 一 眼 它们 的 状态 是 否 改 
x. 


PQconsumeInput 可 以 在 应 用 还 没有 做 好 人 处理 结果 或 通知 的 情况 下 被 调用 。 SIE 
用 的 数据 并 且 在 一 个 缓冲 区 里 保存 它 ， 这 样 导 致 一 个 select() we 这 样 
用 就 可 以 使 用 pQconsumeInput 立即 清 掉 select() 条 件 ， 然 后 在 空闲 的 时 候 检 查 结 果 。 


PQisBusy 


在 查询 忙 的 时 候 返 回 1 ， 也 就 是 说 ， PagetResult 将 阻塞 住 等 待 输入 。 一 个 0 的 返回 表明 这 
时 调用 PagetResult 保证 不 阻塞 。 


int PQisBusy(PGconn *conn); 


PQisBusy 本 身 将 不 会 试图 从 服务 器 读 取 数据 ; 所 以 必须 先 调用 poconsumetnput ， 否 则 将 永 
不 会 消除 忙 状 态 。 


一 个 使 用 这 些 画 nnn 用 将 有 一 个 主 循环 使 用 select() 或 poll() 等 待 所 有 它 必须 处 
理 的 条 件 。 其 中 一 个 条 件 将 会 是 服务 器 来 的 数据 已 准备 好 ， 从 select) 的 角度 来 看 就 

是 PQsocket et 笃 有 可 读 取 的 数据 。 HEMM 测 到 输入 准备 好 ， 它 将 
调用 PQconsumeInput 读 取 输 入 。 然 后 可 以 调用 PQisBusy ， 返回 false (0) 后 面 可 以 跟 

着 PagetResult 。 同 样 它 (用 户 应 用 ) 可 以 调用 Panotifies 检测 NOTIFY 信息 (参阅 Section 
31.8) 。 


一 个 使 用 PQsendQuery / PQgetResult 的 客户 端 同样 也 可 以 试图 取消 一 个 正在 被 服务 器 义理 的 
MD. Ağ Section 31.6。 但 是 ， 不 管 pacancel 返回 的 值 是 多 少 ， 应 用 都 必须 使 用 
PQgetResult 进行 正常 的 读 取 结 果 的 动作 序列 。 一 次 成 功 的 取消 只 会 导致 命令 比 正 常情 况 下 
快 些 结束 。 


通过 使 用 上 面 描述 的 画 数 ， 我 们 可 以 避免 在 等 待 来 自 数据 库 服 务 器 的 输入 时 的 阻塞 。 不 过 ， 
应 用 还 是 有 可 能 阻塞 在 给 服务 器 发 送 输出 上 。 这 种 情况 比较 少见 ， 但 是 也 可 能 发 生 ， 尤其 是 
我 们 要 发 送 非常 长 的 SQL 命令 或 者 数据 值 的 时 候 。 (不 过 ， 最 有 可 和 能 的 是 在 应 用 通 

过 copy IN 发 送 数据 的 时 候 。) 为 了 避免 这 个 可 能 性 ， 实现 完全 的 非 阻塞 数据 库 操作 ， 我 们 
可 以 使 用 下 列 额外 的 画 数 。 


PQsetnonblocking 


把 连接 的 状态 设置 为 非 阻 塞 。 
int PQsetnonblocking(PGconn *conn, int arg); 
arg 为 1， 把 连接 状态 设置 为 非 阻塞 ， 如 果 arg 为 0， 把 连接 状态 设置 为 阻塞 。 如 果 
返回 0， 如 果 错误 返回 -1。 


在 非 阻 塞 状 态 ， 调 用 posendquery ， PQputline ， PQputnbytes ， 和 PQendcopy 的 时 候 不 被 阻 
塞 ， 而 是 在 如 果 需 要 再 次 调用 它们 时 将 返回 一 个 错误 。 


请 注意 Paexec 不 会 在 意 任何 非 阻 塞 模式 ; 如 果 调 用 了 PQexec ， 那 么 它 的 行为 总 是 阻塞 的 。 


PQisnonblocking 
返回 数据 库 连 接 的 阻塞 状态 。 


int PQisnonblocking(const PGconn *conn); 


如 果 连 接 设置 为 非 阻塞 状态 ， 返 回 1， 如 果 是 阻塞 状态 返回 0。 
PQflush 
试图 把 任何 正在 排队 的 数据 冲刷 到 服务 器 ， 如 果 成 功 〈 或 者 发 送 队列 为 空 ) 返回 0， MRA 


某 种 原因 失败 返回 -1， 或 者 是 在 无 法 把 发 送 队 列 中 的 所 有 数据 都 发 送出 去 ， 返 回 1。 《这 种 
情况 只 有 在 连接 为 不 阻塞 模式 的 时 候 才 会 出 现 ) 。 


int PQflush(PGconn *conn); 


在 一 个 非 阻 塞 的 连接 上 发 送 任何 命令 或 者 数据 之 后 ， 调 用 Paflush o MARE 1, MSE 
接 字 写 准备 好 然后 再 次 调用 ; 重复 这 个 操作 直到 它 返 回 0。 —H PQflush 返回 0， 则 等 待 套 
接 字 为 读 准 备 好 ， 准 备 好 之 后 就 像 上 面 那样 读 取 响应 。 


31.5. 逐 行 检索 查询 结果 


通常 ，libpq 收 集 SQL 命 邻 的 全 部 结果 并 作为 单个 Peresult 返回 到 应 用 中 。 这 对 于 返回 大 量 行 
的 命令 是 不 可 能 实现 的 。 对 于 这 种 情况 ， 应 用 可 以 在 单行 模式 中 使 

用 PQsendQuery 和 PQgetResult o 在 这 个 模式 中 ， 结果 行 一 次 返回 一 行 到 应 用 中 ， 就 像 从 服 
务 器 中 接收 到 它们 一 样 。 


要 进入 单行 模式 ， 在 成 功 调用 posendquery (或 者 一 个 兄弟 范 数 ) 之 后 立即 调 

用 PQsetSingleRowMode 。 这 种 模式 选择 只 对 当前 执 4 村 的 查询 有 效 。 然后 重复 的 调 

用 PagetResult ， 直 到 它 返 回 空 a 31.4 中 记录 。 如 果 查 询 返 回 任意 行 ， 它 们 作为 独 
IPY Peresult 对 象 返回 ， 就 像 普 通 的 查询 结果 ， 除 了 状态 码 是 PGRES_SINGLE_TUPLE 而 不 是 
PGRES_TUPLES_oK 。 在 最 后 一 行 之 后 ， 或 者 一 旦 查询 返回 雳 行 ， 返回 一 个 带 有 状 

AS PGRES_TUPLES_ok 的 需 行 对 象 ;这 是 没有 更 多 行 的 一 个 信号 。 (但 是 ， 请 注意 ， 仍 然 需要 继 
续 调用 PagetResult 直到 它 返 回 空 。) 所 有 这 些 presult 对 象 将 包含 相同 的 描述 数据 (字段 
名 、 类 型 等 ) ， 就 像 该 查询 的 一 个 普通 Peresult 对 象 拥有 的 那样 。 像 往常 一 样 ， 每 个 对 象 都 
应 该 使 用 Paclear 释放 。 


PQsetSingleRowMode 
为 当前 执行 的 查询 选择 单行 模式 。 


int PQsetSingleRowMode(PGconn *conn); 


iX PENAL BEE Posendquery KEM RAWAL, 在 任何 连接 上 的 其 他 操 
作 ， 比 如 PQconsumeInput 或 PQgetResult 之 前 。 如 果 在 正确 的 时 间 调 用 了 ， 该 函数 为 当前 查 
询 激活 单行 模式 并 返回 1。 否 则 模式 保持 不 变 并 返回 0。 在 任何 情况 下 ， 该 模式 在 当前 查询 完 
成 之 后 恢复 到 正常 。 


Caution 
处 理 一 个 查询 时 ， See pare 些 行 然 后 遇 到 一 个 错误 ， 导 致 查询 退出 。 通 常 ， 
libpq 丢 弃 任 何 这 样 的 行 并 且 只 错误 。 但 是 在 单行 模式 中 ， 这 些 行将 早已 返回 到 应 用 


中 。 因 此 ， 应 用 将 看 到 一 些 pores SINGLE TUPLE PGresult 对 象 跟随 
在 PGRES_FATAL_ERROR 对 象 后 面 。 对 于 适当 的 事务 行为 ， 如 果 查 询 最 终 失 败 了 ， 那 么 应 用 
必须 设计 为 抛弃 或 撤销 先前 处 理 的 行 。 


31.6. 取消 正在 义理 的 查询 


一 个 客户 端 应 用 可 以 使 用 本 节 描 述 的 函数 ， 要 求 取消 一 个 仍 在 被 服务 器 处 理 的 命 合 。 


PQgetCancel 


创建 一 个 数据 结构 ， 这 个 数据 结构 包含 通过 特定 数据 库 连 接 取消 一 个 命令 所 需要 的 信息 。 


PGcancel *PQgetCancel(PGconn *conn); 


给 出 一 个 Pecon 连接 对 象 ， Pagetcancel 创建 一 个 PGcancel 对 象 。 如 果 给 出 的 conn 
是 NULL 或 者 是 一 个 无 效 的 连接 ， 那么 它 将 返回 NULL o PGcancel 对 象 是 一 个 不 透明 的 结 
构 ， 不 应 该 为 应 用 所 直接 访 问 5 我 们 只 能 把 它 传递 给 PQcancel 或 者 PQfreeCancel o 


PQFfreeCancel 


释放 PQgetcancel 创建 的 数据 结构 。 


void PQfreeCancel(PGcancel *cancel); 


PQfreeCancel 释放 一 个 由 前 面 的 Pagetcancel 创建 的 数据 对 象 。 


PQcancel 
要 求 服 务 器 放 奔 义理 当前 命令 


int PQcancel(PGcancel *cancel, char *errbuf, int errbufsize); 


如 果 取 消 请 求 成 功 发 送 ， 则 返回 值 为 1， 否 则 为 MRAM, N) errbuf 里 面 会 填充 解释 
的 错误 信息 。 errbuf 必须 是 一 个 大 小 为 errbufsize 的 char 数组 (建议 大 小 为 256 字 

节 ) 。 

不 过 ， 成 功 发 送 取消 请 求 并 不 保证 请 求 会 有 任何 效果 。 如 果 取 消 生 效 ， 那么 当前 的 命令 将 提 
前 结束 并 且 返 回 一 个 错误 的 结果 。 如 果 取 消失 败 (也 就 是 说 ， 因为 服务 器 已 经 完成 命 全 的 处 
E) ， 那 么 就 根本 不 会 有 可 见 的 结果 。 


如 果 errbuf 是 信号 句柄 里 的 一 个 局 部 变量 ， 那么 PQcancel 可 以 在 一 个 信号 句柄 里 安全 地 调 
用 。 在 PQcancel 涉及 的 范围 里 ， PGcancel 对 象 都 是 只 读 的 ， 因此 我 们 也 可 以 从 一 个 与 处 
理 PGconn 对 象 的 线程 分 离 的 线程 里 处 理 它 Ko 


PQrequestCancel 


PQrequestCancel 是 PQcancel 的 一 个 废弃 的 变种 。 


int PQrequestCancel(PGconn *conn); 


要 求 服 务 器 放 奔 对 当前 命令 的 义理 。 它 直接 在 Pecon 对 象 上 进行 操作 ， HAMRAK, MS 
在 Pecon 对 象 里 存储 错误 信息 (因此 可 以 用 PQerrorMessage 检索 出 来 。) 尽管 功能 一 样 ， 
但 是 这 个 方法 在 多 线程 程序 里 和 信号 句柄 里 会 有 危险 ， 因 为 它 可 能 履 盖 Pecon 的 错误 信息 ， 
因此 将 可 能 把 当前 连接 正在 处 理 的 操作 打 乱 。 


31.7. 捷径 接口 


PostgreSQL 提 供 一 个 向 服务 器 发 送 简单 的 图 数 调用 的 捷径 接口 。 





Tip: 这 个 接口 在 某 种 程度 上 已 经 废弃 了 ， 因 为 我 们 可 以 通过 设置 一 个 预备 语句 来 定义 加 
数 调用 ， 从 而 达到 类 似 的 性 能 和 更 强大 的 功能 。 然 后 ， 用 二 进 制 参数 和 结果 传输 执行 该 
语句 ， 蔡 换 一 次 捷径 函数 调用 。 








EARL Pafn 请 求 允 许 通过 捷径 接口 执行 服务 器 辑 数 。 


PGresult *PQfn(PGconn *conn, 
int fnid, 
int *result_buf, 
int *result_len, 
int result_is_int, 
const PQArgBlock *args, 
int nargs); 

typedef struct 

{ 


int len; 
int isint; 
union 


int *ptr; 
int integer; 


} u; 
} PQArgBlock; 


fnid 参数 是 待 执行 的 函数 的 对 象 标 识 (OID) 。 args 和 nargs E3 T 4k A NA 
数 ; 它们 必须 匹配 已 经 声明 了 的 函数 参数 列表 。 如 果 某 个 参数 结构 的 isint 字段 是 真 ， 那 
4 u.integer 值 以 指定 长 度 (必须 是 1，2， 或 者 4 字 节 ) 的 整数 发 送 给 服务 器 ; 这 时 候 会 进 
行 恰当 的 字 节 序 交 换 (byte-swapping) 。 如 果 isint 为 假 ， 那么 在 *u.ptr 里 面 的 指定 字 节 
数 的 数据 将 不 做 任何 处 理发 送出 去 ; 这 些 数据 必须 是 服务 器 预期 的 该 本 数 参数 类 型 的 二 进 制 
传输 格式 。 result_buf 是 放置 返回 值 的 缓冲 区 。 调 用 者 必须 为 返回 值 分 配 足够 的 空间 (这 里 
没有 检查 1 ) 。 实际 的 返回 值 长 度 将 被 放 在 result_len 指向 的 整数 里 返回 。 如 果 预 期 返回 
值 是 1，2 或 4 字 节 整数 ， 把 result_is_int 设 为 1; 否则 设 为 0。 把 result_is_int 设 为 1 
告诉 libpq 必 要 时 交换 数值 字 节 序 ， 这 样 就 可 以 正确 地 传输 成 客户 机 上 的 int 值 。 

当 result_is int Œ 0 时 ， 服务 器 发 送 回 来 的 字 节 串 不 做 修改 直接 返回 。 


Pafn 总 是 返回 一 个 有 效 的 Peresult 指针 。 在 使 用 结果 之 前 应 该 检查 结果 状态 。 当 结果 不 再 
使 用 后 ， 调 用 者 有 义务 使 用 paclear 释放 pGresult o 


请 注意 我 们 没 办 法 处 理 空 值 的 参数 ， 空 的 结果 ， 也 没 办 法 在 使 用 这 个 接口 的 时 候 设 置 有 值 的 
结果 。 


31.8. 异步 通知 


PostgreSQL 通 过 Listen 和 NoTIFY 命令 提供 对 异步 通知 的 支持 。 一 个 客户 端 会 话 

FA Listen 命令 注册 一 个 它 感 兴趣 的 通知 条 件 (也 可 以 用 uNLISTEN 命令 停止 监听 ) 。 所 有 正 
在 监听 某 一 通知 条 件 的 会 话 在 该 条 件 名 的 NoTIFY (通知 ) 被 任何 会 话 执行 后 都 将 被 异步 地 通 
知 。 一 个 "payload" 可 以 向 听众 传达 额外 的 数据 。 


libpq 应 用 把 Listen ， UNLISTEN 和 NoTIFY 命令 作为 普通 的 SQL 命令 提交 。 随 后 通过 调用 


PQnotifies 可 以 侦 测 到 NoTIFY 消息 的 到 达 。 


PAR Panotifies 从 一 个 来 自 服务 器 的 未 处 理 的 通知 信息 列表 中 返回 下 一 条 通知 。 如 果 没 有 未 
处 理 的 信息 则 返回 NULL 指针 。 一 旦 ponotifies 返回 一 条 通知 ， 该 通知 会 被 认为 已 处 理 并 且 
将 被 从 通知 列表 中 删除 。 


PGnotify *PQnotifies(PGconn *conn); 


typedef struct pgNotify 
{ 


char *relname; /* 通知 的 通道 名 字 */ 
int be_pid; /* 通知 服务 器 进程 的 进程 ID */ 
char *extra; /* 通知 负载 字符 串 */ 

} PGnotify; 


在 义理 完 PQnotifies 返回 的 PGnotify 对 象 后 ， 别 忘 了 用 PQfreemem 把 它 释放 。 释 
放 PGnotify 指针 就 足够 了 ; relname 和 extra 字段 并 未 代表 独立 分 配 的 内 存 。 (这 些 领 域 
的 名 称 是 历史 性 的 ， 尤 其 是 频道 名 称 与 名 称 没 有 什么 关系 。) 


Example 31-2 给 出 了 一 个 简单 的 程序 ， 举 例 说明 异 步 通 知 的 使 用 。 


PQnotifies 实际 上 并 不 读 取 服务 器 数据 ; 它 只 是 返回 被 前 面 的 另 一 个 libpq 范 数 吸 收 的 信息 。 

在 以 前 的 libpq 版 本 里 ， 周 期 性 的 收 到 NoTIFY 信息 的 唯一 方法 是 持续 的 提交 命令 ， 即使 是 空 
查询 也 可 以 ， 并 且 在 每 次 Paexec 后 检查 PQnotifies 。 现在 这 个 方法 也 还 能 工作 ， 不 过 我 们 
认为 它 太 浪费 义理 器 时 间 而 废 奔 了 它 。 


在 你 没有 可 用 的 命令 提交 时 检查 NoTIFY 消息 的 更 好 的 方法 是 调用 PQconsumeInput ， 然 后 检 
查 ponotifies 。 你 可 以 使 用 select() 来 等 待 服务 器 数据 的 到 达 ， 这 样 在 没有 数据 可 义理 时 
可 以 不 浪费 CPU 时 间 。 (参阅 PQsocket 获取 用 于 select() 的 文件 描述 符 。) 注意 这 种 方法 
不 管 你 使 用 pasendquery / PQgetResult 还 是 简单 的 Paexec 来 执行 命令 都 能 工作 。 不 过 ， 你 应 
该 记 住 在 每 次 pagetResult 或 Paexec 后 检查 PQnotifies ， 看 看 在 义理 命令 的 过 程 中 是 否 
通知 到 达 。 


31.9.5 copy 合 合 相关 的 函数 


PostgreSQL 里 的 copy 命令 里 有 用 于 libpq 从 网 络 连接 读 出 或 者 写 入 的 选项 。 本 节 描 述 的 函数 
允许 应 用 通过 提供 或 者 消耗 拷贝 数据 ， 充 分 利用 这 个 功能 。 


整个 过 程 是 应 用 首先 通过 Paexec 或 者 一 个 等 效 的 函数 发 出 copy 命令 。 对 这 个 命令 的 响应 
(如 果 命 命 无 误 ) 将 是 一 个 带 着 状态 码 PGRES_copPY_0UT 或 者 PGRES_coPY_IN 

的 peresult (县 体 根据 声明 的 拷贝 方向 ) 。 应 用 然后 就 应 该 使 用 本 节 的 函数 接受 或 者 发 送 数 

据 行 。 在 数据 传输 结束 之 后 ， 返回 另外 一 个 Peresult 对 象 以 表明 传输 的 成 功 或 者 失败 。 它 的 

状态 将 是 PGRES_COMMAND_OK 表示 成 功 或 者 如 果 发 生 了 一 些 问题 ， 是 PGRES FATAL ERROR o 这 

个 时 候 开 始 我 们 可 以 通过 Paexec 发 出 更 多 SQL 命令 。 ( copy 操作 在 处 理 的 过 程 中 ， 我 们 

不 可 能 用 同一 个 连接 执行 其 它 SQL MT. 


如 果 一 个 copy 是 通过 Paexec 在 一 个 可 以 包含 额外 命令 的 字 串 里 发 出 的 ， 那 么 应 用 在 完 
成 copy 序列 之 后 必须 继续 用 pagetResult 抓 取 结果 。 只 有 在 PagetResult 返回 NuLL 的 时 
候 ， 我 们 才能 确信 Paexec 的 命令 字 串 已 经 处理 完毕 ， 并 且 已 经 可 以 安全 地 发 出 更 多 命令 。 
本 节 的 这 些 函 数 应 该 只 在 从 Paexec 或 PagetResult 获得 
了 PGRES_COPY_OUT 或 PGRES_copy_In 结果 状态 的 情况 下 执行 。 
一 个 承载 了 这 些 状态 值 之 一 地 PGresult 对 象 运载 了 某 些 有 关 正 在 开始 的 COPY 操作 的 额外 信 
息 。 这 些 额 外 的 数据 可 以 用 那些 同时 也 义理 查询 结果 的 函数 获取 。 
PQnfields 
返回 要 拷贝 的 字段 (数据 域 ) 个 数 
PQbinaryTuples 
0 表示 全 部 拷贝 格式 都 是 文本 的 〈 行 之 间 用 换行 分 隔 ， 字 段 用 分 隔 符 分 隔 ， 等 等 ) 。 1 表示 
全 部 拷贝 格式 都 是 二 进 制 。 参 阅 COPY 获 取 更 多 信息 。 
PQfformat 
返回 和 拷贝 操作 的 每 个 字段 相关 的 格式 代码 (0 是 文本 ，1 是 二 进 制 ) 。 如 果 全 部 拷贝 格式 
是 文本 ， 那 么 每 字段 的 格式 码 将 总 是 需 ， 但 是 (整体) 二进制 格式 可 以 支持 文本 和 二 进 制 字 
段 并 存 。 (不 过 ， 就 目前 的 copy 实现 ， 在 二 进 制 拷贝 里 只 出 现 二 进 制 字段 ; 所 以 目前 每 字 
段 的 格式 总 是 匹配 整体 格式 。) 
Note: 这 些 额 外 的 数据 值 只 能 在 使 用 3.0 版 本 的 协议 的 时 候 获 得 。 在 使 用 2.0 版 本 的 协议 
时 ， 所 有 这 些 函 数 都 返回 0。 





31.9.1. 用 于 发 送 copy 数据 的 函数 


ix ERA FIE copy FROM STDIN 过 程 中 发 送 数据 。 如 果 在 连接 不 是 处 于 coryn 状态 下 ， 
它们 会 失败 。 


PQputCopyData 
在 coPYy_IN 状态 里 向 服务 器 发 送 数据 。 


int PQputCopyData(PGconn *conn, 
const char *buffer, 
int nbytes); 


传输 指定 的 buffer BAY, KE A nbytes BY copy 数据 到 服务 器 。 如 果 数 据 发 送 成 功 ， 结 果 
是 1， 如 果 因为 发 送 企图 会 阻塞 〈 这 种 情况 只 有 在 连接 是 非 阻 塞 模式 时 寺 有 可 能 ) 而 没有 成 
TN, PAGS, 或 者 是 在 发 生 错误 的 时 候 是 -1。 〈 如 果 返 回 -1， 那 么 使 用 poerrormessage 
检索 细节 。 如 果 值 是 需 ， 那 么 等 待 写 准备 好 然后 重 试 。) 


应 用 可 以 把 copy 数据 流 分 隔 成 任意 合适 的 大 小 放 到 缓冲 区 里 。 在 发 送 的 时 候 ， 缓冲 区 的 边 
界 没有 什么 特殊 的 语意 。 数 据 流 的 内 容 必 须 匹 配 copy 命令 预期 的 数据 格式 ; 参阅 COPY 获 取 
细节 。 


PQputCopyEnd 


在 coPY_IN 状态 里 向 服务 器 发 送 数 据 完毕 的 指示 。 


int PQputCopyEnd(PGconn *conn, 
const char *errormsg); 


如 果 errormsg 是 NULL ， 则 成 功 结束 copy_in 操作 。 如 果 errormsg A NULL 则 copy 操作 
被 强制 失败 ， errormsg 指向 的 字 串 是 错误 信息 。 (我 们 不 能 认为 同样 的 信息 可 能 会 从 服务 器 
传 回 ， 因为 服务 器 可 能 已 经 因为 自己 的 原因 让 coy 失败 。 还 要 注意 的 是 在 使 用 3.0 版 本 之 
前 的 协议 连接 时 ， 强 制 失 败 的 选项 是 不 能 用 的 。) 


如 果 终 止 数据 发 送 ， 则 结果 为 1， 如 果 发 送 企图 会 阻塞 〈 只 有 在 连接 是 在 非 阻 塞 模式 的 情况 下 
才 可 能 出 现 这 个 情况 ) ， 则 为 需 ， 如 果 发 生 错 误 则 返回 -1。 (如 果 返 回 值 是 -1， 
用 PaerrorMessage 检索 细节 。 如 果 值 是 需 ， 那 么 等 待 写 准 备 好 然后 重新 尝试 。) 


在 成 功 调 用 poputcopyend 之 后 ， 调 用 PagetResult 获取 copy 命令 的 最 终结 果 状 态 。 我 们 可 
以 用 平常 的 方法 来 等 待 这 个 结果 可 用 。 然 后 返回 到 正常 的 操作 。 


31.9.2. 用 于 接收 copy 数据 的 函数 


这 些 画 数 用 于 在 copy To stoouT 的 过 程 中 检索 数据 。 如 果 连 接 不 在 coPy_ouT 状态 ， 那 么 他 
们 将 会 失败 。 


PQgetCopyData 


在 copY_ouT 状态 下 从 服务 器 接收 数据 。 


int PQgetCopyData(PGconn *conn, 
char **buffer, 
int async); 


在 一 个 copy 的 过 程 中 试图 从 服务 器 获取 另外 一 行 数据 。 数 据 总 是 每 次 返回 一 个 数据 行 ; 如 
果 只 有 一 部 分 行 可 用 ， 那 么 它 不 会 被 返回 。 成 功 返回 一 个 数据 行 包 括 分 配 一 个 内 存 块 来 保存 
这 些 数 据 。 buffer 参数 必须 是 非 NULL. *buffer 设置 为 指向 分 配 出 来 的 内 存 的 指针 ， 或 者 
是 如 果 没 有 返回 缓冲 区 ， 那 么 为 NuLL 。 一 个 非 NuLL 的 结果 缓冲 区 在 不 再 需要 的 时 候 必 须 
用 pofreemem 释放 。 


在 成 功 返 回 一 行 之 后 ， 那 么 返回 的 值 就 是 该 数据 行 里 数据 的 字 节 数 ( 这 个 将 总 是 大 于 需 ) 。 

返回 的 字 串 总 是 空 结 尾 的 ， 虽 然 可 能 只 是 对 文本 的 cor 有 用 。 一 个 需 的 结果 表示 该 copy 仍 
然 在 处 理 中 ， 但 是 还 没有 可 以 用 的 行 (这 个 只 有 在 async 为 真 的 时 候 示 可 能 ) 。 一 个 结果 为 
-1 BART copy 已 经 结束 。 结 果 为 -2 表示 发 生 了 错误 (参考 pgerrorMessage 获取 原因 ) 。 


在 async 为 真 的 时 候 ( 非 需 ) ， Pagetcopypata 将 不 会 阻塞 住 等 待 输 入 ; 如 果 该 copy HER 
理 过 程 中 并 且 没 有 可 用 的 完整 行 ， 那 么 它 将 返回 需 。 在 这 种 情况 下 它 等 待 读 准 各 好 ， 然 后 
在 再 次 调用 PagetcopypData 之 前 ， 调用 PQconsumeInput o ) 在 async ÆR (5) 的 时 候 ， 
PQgetCopyData 将 阻塞 住 ， 直到 数据 可 用 或 者 操作 完成 。 


在 PQgetCopyData 返回 -1 之 后 ， 调 用 PagetResult 获取 copy 命令 的 最 后 结果 状态 。 我 们 可 
以 用 通常 的 方法 等 待 这 个 结果 可 用 。 然 后 返回 到 正常 操作 。 


31.9.3. 用 于 copy 的 废弃 的 函数 


下 面 的 这 些 琅 数 代 表 了 以 前 的 处 理 cory 的 方法 。 尽 管 他 们 还 能 用 ， 但 是 现在 已 经 废弃 了 ， 
因为 他 们 的 错误 处 理 实在 是 太 糟 焙 了 ， 并 且 检 测 数据 结束 的 方法 也 很 不 方便 ， 并 且 缺 少 对 二 
进 制 和 非 阻塞 传输 的 支持 。 


PQgetline 


读 取 一 个 以 新 行 符 结尾 的 字符 行 (由 服务 器 传输 ) 到 一 个 长 度 为 length 的 字符 串 缓冲 区 。 


int PQgetline(PGconn *conn, 
char *buffer, 
int length); 


3X PRA DRS length IS SRS HRS, ABA ILM Tae TS TS, 
PQgetline 在 输入 结束 时 返回 cor ， 如 果 整 行 都 被 读 取 了 返回 0， 如 果 缓 冲 区 填 满 了 而 还 没 
有 遇 到 结束 的 新 行 符 则 返回 1。 


注意 ， 应 用 程序 必须 检查 新 行 是 否 包 含 两 个 字符 \. ， 这 表明 服务 器 已 经 完成 了 copy 命令 的 
结果 的 发 送 。 如 果 应 用 可 能 收 到 超过 length -1 字符 长 的 字符 ， 我 们 就 应 该 确保 正确 识别 
\. 行 ( 例 如， 不 要 把 一 个 长 的 数据 行 的 结束 当 作 一 个 终止 行 ) 。 


PQgetlineAsync 
不 阻塞 地 读 取 一 行 copy 数据 (由 服务 器 传输 ) 到 一 个 缓冲 区 中 。 


int PQgetlineAsync(PGconn *conn, 
char *buffer, 
int bufsize); 


这 个 范 数 类 似 于 Pagetline ， 但 是 可 以 用 于 那些 必须 异步 读 取 copy 数据 的 应 用 ， 也 就 是 不 阻 
塞 的 占用。 在 使 用 了 copy 命令 和 获取 了 PGRES_coPY_ouT 响应 之 后 ， 应 用 应 该 调 
用 paconsumeinput 和 PagetlineAsync 直到 收 到 数据 结束 的 信号 。 


AMR pagetline ， 这 个 辑 数 负责 检测 数据 结束 。 


在 每 次 调用 时 ， 如 果 libpq 的 输入 缓冲 区 内 有 可 用 的 一 个 完整 的 数据 行 ， PQgetlineAsync 都 将 
返回 数据 。 否 则 ， 在 其 他 数据 到 达 之 前 不 会 返回 数据 。 如 果 见 到 了 拷贝 数据 结束 的 标志 ， 此 
画 数 返 回 -1， 如 果 没 有 可 用 数据 ， 或 者 是 给 出 一 个 正 数 表明 返回 的 数据 的 字 节 数 ， 返 回 0。 

如 果 返 回 -1， 调 用 者 下 一 步 必须 调用 PQendcopy ， 然 后 回 到 正常 处 理 。 


返回 的 数据 将 不 超过 一 行 的 范围 。 如 果 可 能 ， 每 次 将 返回 一 个 完整 行 。 但 如 果 调 用 者 提供 的 
BAKA), 无 法 容 下 服务 器 发 出 的 整 行 ， 那 么 将 返回 部 分 行 。 对 于 文本 数据 ， 这 个 可 以 通 
过 测试 返回 的 最 后 一 个 字 节 是 否 是 \n 来 确认 。 (在 二 进 制 copy 中 ， 我 们 需要 对 copy 数据 
格式 进行 实际 的 分 析 ， 以 便 做 相同 的 判断 。) 返回 的 字符 串 不 是 空 结尾 的 。 (如 果 你 想得到 
一 个 空 结尾 的 字 串 ， 确保 你 传递 了 一 个 比 实际 可 用 空间 少 一 字 节 的 bufsize 。) 


PQputline 


向 服务 器 发 送 一 个 空 结尾 的 字符 串 。 成 功 时 返回 0， 如 果 不 能 发 送 字符 串 返 回 EF o 


int PQputline(PGconn *conn, 
const char *string); 


一 系列 poputline 调用 发 送 的 copy 数据 流 和 PogetlineAsync 返回 的 数据 有 着 一 样 的 格式 ， 
只 是 应 用 不 需要 明确 地 在 每 次 _Paputline 调用 中 发 送 一 个 数据 行 ; 每 次 调用 发 送 多 行 或 者 部 
分 行 都 是 可 以 的 。 














Note: 在 PostgreSQL 协 议 3.0 之 前 ， 应 用 必须 明确 的 发 送 两 个 字符 、， 作 为 行 结束 ， 向 服 
务 器 表明 它 已 经 完成 了 发 送 copy 数据 。 虽 然 这 个 仍然 工作 ， (HECPARFT, # 

且 、. 的 特殊 含义 在 将 来 的 版 本 中 有 望 删 除 。 在 发 送 实际 数据 之 后 调用 Paendcopy ME 
够 了 。 











PQputnbytes 


向 服务 器 发 送 一 个 非 空 结尾 的 字符 串 。 成 功 时 返回 0， 如 果 不 能 发 送 字符 串 返 回 cor 。 


int PQputnbytes(PGconn *conn, 
const char *buffer, 
int nbytes); 


此 函数 类 似 Poputline ， 除 了 数据 缓冲 区 不 需要 是 空 结尾 的 之 外 ， 因为 要 发 送 的 字 节 数 是 直 
接 声明 的 。 在 发 送 二 进 制 数据 的 时 候 使 用 这 个 过 程 。 


PQendcopy 
与 服务 器 同步 。 


int PQendcopy(PGconn *conn); 


这 个 事 数 将 等 待 直 到 服务 器 完成 拷贝 。 你 可 以 在 用 Paputline 向 服务 器 发 送 完 最 后 一 个 字符 
串 后 或 者 用 PGgetline 从 服务 器 获取 最 后 一 行 字符 串 后 调用 它 。 我 们 必须 调用 这 个 函数 ， 否 
则 服务 器 可 能 会 和 前 端 "不 同步 "。 在 这 个 函数 返回 后 ， 服 务 器 就 已 经 准备 好 接收 下 一 个 SQL 
命令 了 。 成 功 时 返回 0， 否则 返回 非 需 值 。 (如 果 返 回 值 为 非 0， 用 PQerrorMessage 检索 细 
节 。) 


在 使 用 pogetResult 时 ， 应 用 应 该 对 pcres_copy_our 的 结果 做 出 反应 : 重复 调 

用 Pagetline ， 并 且 在 收 到 结束 行 时 调用 PQendcopy 。 然 后 应 该 返回 到 pagetResult 循环 直 
到 pagetResult 返回 空 指针 。 类 似 地 ， PGRES_coPY_IN 结果 是 用 一 系列 poputline 调用 最 后 跟 
着 PQendcopy ， 然后 返回 到 PQgetResult 循环 。 这 样 的 排列 将 保证 窝 入 到 一 系列 SQL 命 兮 

BY copy 命令 将 被 正确 执行 。 


旧 的 应 用 大 多 通过 Paexec 提交 一 个 copy 命令 并 且 假 设 在 Poendcopy 后 事务 完成 。 这 样 只 有 
在 copy 是 命令 字 串 里 的 唯一 的 SQL 命令 时 才能 正确 工作 。 


31.10. fe rll EX 


这 些 辑 数控 制 许多 libpq 其 他 行为 的 细节 。 


PQclientEncoding 
返回 客户 端 编码 。 


int PQclientEncoding(const PGconn *_conn_); 


请 注意 ， 它 返回 编码 ID， 而 不 是 一 个 符号 串 如 Euc_JP o 转换 编码 的 ID 为 一 个 编码 名 称 ， 你 可 
以 使 用 : 


char *pg_encoding_to_char(int _encoding_id_); 


PQsetClientEncoding 
设置 客户 端 编码 。 


int PQsetClientEncoding(PGconn *_conn_, const char *_encoding_); 


con. 是 一 个 到 服务 器 的 连接 ， _encoding。” 是 你 想 要 的 编码 使 用 。 如 果 函 数 成 功 设置 编 
码 ， 则 返回 0， 否 则 返回 -1。 这 个 链接 的 当前 编码 可 以 通过 pQclientEncoding 确定 。 


PQsetErrorVerbosity 


RE PQerrorMessage 和 PQresultErrorMessage 返回 的 信息 的 宛 余 程度 。 


typedef enum 


PQERRORS_TERSE, 

PQERRORS_DEFAULT, 

PQERRORS_VERBOSE 
} PGVerbosity; 


PGVerbosity PQsetErrorVerbosity(PGconn *conn, PGVerbosity verbosity); 


PQsetErrorVerbosity 设置 元 余 模 式 ， 返 回 连接 的 前 一 个 设置 。 在 TEARSE 模 式 下 ， 返回 的 消 
息 只 包括 严重 性 ， 主 信息 ， 以 及 位 置信 息 ; 这 些 东 西 通常 只 有 一 行 。 缺 省 模式 生成 的 消息 包 
括 上 面 的 信息 加 上 任何 细节 ， 提 示 ， 或 者 环境 字段 (这些 可 能 跨越 几 行 ) 。 VERBOSE 模 式 
包括 所 有 可 以 获得 的 字段 。 修 改元 余 模式 不 会 影响 我 们 从 已 经 存在 Peresult 对 象 中 获取 的 信 
息 ， 只 有 随后 创建 的 Peresult 对 象 才 受 到 影响 。 


PQtrace 


打开 对 前 端 /服务 器 通讯 的 跟踪 ， 把 调试 信息 输出 到 一 个 文件 流 里 。 
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void PQtrace(PGconn *conn, FILE *stream); 


Note: 在 Windows 上 ， 如 果 libpq 库 和 应 用 使 用 了 不 同 的 标志 编译 ， 那么 这 个 函数 调用 会 
导致 应 用 崩溃 ， 因 为 FILE 指针 的 内 部 表现 形式 是 不 一 样 的 。 特别 是 多 线程 /单线 程 ， 发 
布 /调试 ， 以 及 静态 /动态 标志 应 该 是 库 和 所 有 使 用 库 的 应 用 都 一 致 。 


PQuntrace 
关闭 potrace 打开 的 跟踪 。 


void PQuntrace(PGconn *conn); 


31.10. 控制 函数 878 


31.11. 各 种 函数 


一 如 往常 ， 也 有 一 些 函 数 ， 只 是 不 是 在 任何 地 方 都 适合 。 


PQfreemem 


释放 libpq 分 配 的 内 存 。 


void PQfreemem(void *ptr); 


释放 |ibpq 分 配 的 内 存 ， 尤 其 是 pgescapeByteaconn , 

PQescapeBytea , PQunescapeBytea 和 PQnotifies o 尤其 重要 的 是 ， 在 Windows 系 统 上 使 用 
这 个 函数 ， 而 不 是 free() 。 这 是 因为 只 有 DLL 和 应 用 程序 的 多 线程 /单线 程 ， 发 布 /调试 ， 静 
态 /动态 标志 是 相同 的 时 ， 才 在 一 个 DLL 中 分 配 内 存 ， 并 在 应 用 程序 工作 时 释放 内 存 。 在 非 

Windows 平 台 上 ， SHS tre REP free() 相同 。 


PQconninfoFree 


释放 PQconndefaults 或 PQconninfoParse 分 配 的 数据 结构 。 


void PQconninfoFree(PQconninfoOption *connOptions); 


一 个 简单 的 Pafreemem 不 会 这 样 做 ， 因 为 数组 包含 对 子 字 符 串 的 引用 。 
PQencryptPassword 


准备 一 个 PostgreSQL 密 码 的 加 密 形 式 : 


char * PQencryptPassword(const char *passwd, const char *user); 


SAS EA FABLE & IK LF ALTER USER joe PASSWORD 'pwd' 命 兮 的 客户 端 应 用 程序 。 
这 是 一 个 很 好 的 方法 ， 这 种 命令 不 发 送 原始 的 明文 密码 ， 因 为 它 可 能 被 暴露 在 命令 日 志 ， 活 
动 显示 中 等 等 。 相反 ， 在 发 送 前 ， 使 用 这 个 画 数 可 以 将 密码 转换 为 加 密 的 形式 。 参 数 是 明文 
密码 和 用 户 的 SQL 名 字 。 返回 值 是 malloc 分 配 的 一 个 字符 串 ， 或 超出 内 存 时 为 NULL 。 调用 
可 以 认为 字符 串 中 不 包含 需要 逃逸 的 特殊 字符 。 当 使 用 结束 之 后 ， 用 PQfreemem 进行 释放 。 


PQmakeEmptyPGresult 
用 给 定 的 状态 构造 一 个 空 Peresult 对 象 。 


PGresult *PQmakeEmptyPGresult(PGconn *conn, ExecStatusType status); 


这 是 libpq 的 内 部 责 数 ， 用 于 分 配 和 初始 化 一 个 空 peresult 对 象 。 如 果 不 能 分 配 内 存 ， 那 么 这 
de NULL 。 这 是 输出 ， 因为 一 些 应 用 程序 发 现 它 可 以 有 效 的 生成 结果 对 象 本 身 (45 
tA 错误 状态 的 对 象 ) 。 如 果 conn 非 空 ， 并 且 status 用 于 表示 一 个 错误 ， 那么 指定 连 
前 错误 信息 被 复制 到 peresult 中 。 同时 ， 如 果 conn 非 空 ， 那 么 连接 中 的 任何 事件 过 
程 会 被 复制 到 pGresult 中 。 (它们 不 会 获得 PGEVT_RESULTCREATE PR, 但 会 看 
到 pofireResultCreateEvents ) o 需要 注意 的 是 随 着 libpq KARE pcresult 时 ， 对象 最 
该 请 求 PQclear 。 


PQfireResultCreateEvents 


为 PGresult 对 象 中 的 每 个 事件 过 程 触发 一 个 PGEvT_RESULTCREATE 事件 (参阅 Section 
31.13) 。 成 功 时 返回 非 0， 如 果 任 何事 件 过 程 失败 返回 0。 


int PQfireResultCreateEvents(PGconn *conn, PGresult *res); 


conn 被 传送 给 事件 过 程 ， 但 不 会 被 直接 使 用 。 如 果 事 件 过 程 不 使 用 它 ， 则 会 返回 nu o 
已 经 接收 到 这 个 对 象 的 PGEVT_RESULTCREATE 或 PGEVT_RESULTCOPY 事件 的 事件 过 程 不 会 被 再 次 
触发 。 

XS HAS PamakeEmptyPGResult 分 开 的 主要 原因 是 它 经 常 创建 一 个 Peresult ， 并 且 在 调用 
事件 过 程 之 前 就 用 数据 对 其 进行 填充 。 

PQcopyResult 


完成 一 个 Peresult 对 象 的 拷贝 。 这 个 拷贝 不 会 以 任何 方式 来 连接 到 资源 结果 ， 并 且 当 该 拷贝 
不 再 需要 时 ， 需 要 调用 paclear 进行 清理 。 如 果 男 数 失败 ， 返 回 ne. 


PGresult *PQcopyResult(const PGresult *src, int flags); 


不 会 制作 一 个 明确 的 拷贝 。 返 回 的 结果 通常 会 是 PRES_TuPLES_oK 状态 ， 并 且 不 会 拷贝 资源 中 
的 错误 信息 ， 然 而 会 拷贝 命令 状态 字符 串 。 flag 决定 其 他 需要 拷贝 的 。 通 常 是 几 

个 PG_COPYRES_ATTRS 的 按 位 或 。 pP6G_coPYRES_ATTRS 声明 复制 源 结 果 的 属性 (FUEL) 。 
PG_COPYRES_ TUPLES 声明 复制 源 结果 的 元 组 〈 这 意味 着 也 复制 属性 ) 。 

PG_COPYRES_NOTICEHOOKS 声明 复制 源 结果 的 通知 陷阱 。 PG_COPYRES_EVENTS 声明 负 值 源 结 果 的 


事件 。 (但 任何 与 源 关联 的 实例 数据 不 会 被 复制 。) 


PQsetResultAttrs 


设置 peresult 对 象 的 属性 。 


int PQsetResultAttrs(PGresult *res, int numAttributes, PGresAttDesc *attDescs); 


提供 的 attdescs 被 复制 到 结果 中 。 如 果 attpescs 指针 为 NULL , BX numAttributes 小 于 1， 
aes edges FAMBARD, WR res CHAT, MANASAK, MRAMK 
败 ， 返回 0。 如 果 画 数 成 功 ， 会 返回 非 0。 


PQsetvalue 
设置 PGresult 对 象 的 元 组 字段 值 。 


int PQsetvalue(PGresult *res, int tup_num, int field_num, char *value, int len); 


RTEASE aiana A 置 元 组 。 然 而 ， tup_num 参数 必须 小 于 等 于 pontuples , 
意味 着 这 个 函数 一 次 只 能 增加 一 个 元 组 。 但 已 存在 的 任意 的 元 组 中 的 任意 字段 可 以 以 任意 顺 
序 进 行 调整 。 如 果 field num 中 的 一 个 值 已 经 存在 ， 会 被 覆盖 重 写 。 如 果 len 是 -1， 

或 value 是 NULL , 字段 值 会 被 设置 为 一 个 SQL 空 值 。 value 被 复制 到 结果 的 私有 存储 中 ， 
因此 画 数 返 回 结果 后 就 不 再 需要 了 。 如 果 画 数 失 败 ， 会 返回 0。 MRKU, AREO, 


PQresultAlloc 


为 PGresult 对 象 分 配子 存储 。 


void *PQresultAlloc(PGresult *res, size_t nBytes); 


当 res MAH, ARAON EER. MRAR, 返回 NuLL 。 结 果 是 保 
证 任何 类 型 的 数据 能 够 充分 对 齐 ， 如 同 对 malloc 一 样 。 


PQlibVersion 
返回 正在 使 用 的 libpq 的 版 本 。 


int PQlibVersion(void); 


QO SR AS ENTREE libpg 4 AUDA BARA PAA, ARORA REBTN IAHR. ANB 
可 以 使 用 ， 比 如 ， 用 来 确定 可 用 于 Poconecta 的 连接 选项 ， 或 者 是 否 支持 PostgreSQL 9.0 
中 添加 的 hex bytea 输出 。 


数字 是 通过 把 主 、 次 及 版 本 号 转换 成 两 位 十 进 制 数 并 且 把 它们 连接 在 一 起 组 成 的 。 例 如 ， 版 
本 9.1 将 被 返回 901000， 版 本 9.1.2 将 被 返回 90102 〈 前 导 需 没有 显示 ) 。 


Note: 这 个 函数 是 在 PostgreSQL 版 本 9.1 中 出 现 的 ， 所 以 它 不 能 用 来 在 较 早 的 版 本 中 检测 
需 功 能 ， 因此 连接 它 将 在 版 本 9.1 上 创建 一 个 连接 依赖 。 








31.12. 注意 信息 义理 


服务 器 生成 的 注意 信息 和 警告 信息 都 不 会 由 查询 执行 本 数 返回 ， 因 为 他 们 并 不 蕴涵 着 查询 的 
失败 。 它们 会 被 传递 给 一 个 注意 信息 处 理 范 数 ， 然 后 在 该 处 理 返 回 之 后 继续 正常 执行 。 缺 省 
的 注意 信息 处 理 画 数 在 stderr 上 打印 该 信息 ， 但 是 应 用 可 以 通过 提供 自己 的 处 理 范 数 来 覆盖 
这 个 行为 。 

由 于 历史 原因 ， 系 统 里 存在 两 个 级 别 的 注意 信息 处 理 ， 分 别 叫 做 注意 信息 接收 器 和 注意 信息 
处 理 器 。 缺 省 的 行为 是 注意 信息 接收 器 格式 化 注意 信息 然后 传递 给 注意 信息 处 理 器 一 个 宇 串 
进行 打印 。 不 过 ， 对 于 自行 处 理 这 些 事情 的 应 用 而 言 ， 通 常 是 忽略 注意 信息 处 理 器 层 ， 而 只 
是 在 注意 信息 接收 器 里 完成 所 有 动作 。 


aX PQsetNoticeReceiver 为 一 个 连接 对 象 设 置 或 者 检查 当前 的 注意 信息 接收 器 。 类 似 的 
是 PQsetNoticeProcessor 设置 或 者 检查 当前 的 注意 信息 义理 器 。 


typedef void (*PQnoticeReceiver) (void *arg, const PGresult *res); 


PQnoticeReceiver 

PQsetNoticeReceiver(PGconn *conn, 
PQnoticeReceiver proc, 
void *arg); 


typedef void (*PQnoticeProcessor) (void *arg, const char *message); 


PQnoticeProcessor 

PQsetNoticeProcessor(PGconn *conn, 
PQnoticeProcessor proc, 
void *arg); 


这 些 副 数 都 返回 前 一 个 注意 信息 接收 器 或 者 处 理 器 画 数 指针 ， 然 后 设置 新 的 数值 。 如 果 你 提 
供 一 个 空 阔 数 指针 ， 那 么 就 不 会 执行 任何 动作 ， 但 是 返回 当前 指针 。 


当 我 们 从 服务 器 获取 一 个 注意 或 者 警告 信息 的 时 候 ， 或 者 是 收 到 libpq 内 部 生成 的 类 似 信息 
时 ， 注 意 信息 接收 器 画 数 将 被 调用 。 消 息 会 以 一 个 PGRES_NONFATAL_ERROR 的 Presult 的 形式 
传递 。 (这 就 允许 接收 器 用 PQresultErrorField 抽取 独立 的 字段 ， 或 者 

用 poresultErrormessage 完成 预先 格式 化 好 的 信息 。) 传递 给 PasetNoticeReceiver 的 同一 个 
void 指针 也 同样 传递 给 该 图 数 。 (必要 时 ， 这 个 指针 可 以 用 来 访问 应 用 相关 的 状态 。 


缺 省 的 注意 信息 接收 器 只 是 简单 的 抽取 信息 (使 用 PQresultErrorMessage ) 然后 传递 给 注意 
信息 义理 器 。 


注意 信息 义理 器 负责 处 理 一 个 以 文本 形式 给 出 的 注意 或 者 警告 信息 。 系 统 传递 给 他 消息 的 字 
BMA (包括 结尾 的 新 行 符 ) ， 加 上 一 个 和 传递 给 PQsetNoticeProcessor 一 样 的 void (无 类 
型 ) 指针 。 (必要 时 ， 这 个 指针 可 以 用 来 访问 应 用 相关 的 状态 。 


缺 省 的 注意 信息 处 理 器 就 是 : 


static void 
defaultNoticeProcessor(void *arg, const char *message) 


fprintf(stderr, "%s", message); 


一 旦 你 设置 了 注意 消息 接收 器 或 者 处 理 器 ， 那 么 你 就 应 该 准 各 好 在 Pecon 对 象 或 
者 PGresult 对 象 开始 存在 的 时 候 起 就 有 人 调用 它们 。 在 创建 Presult 的 时 候 ， PG6conn 的 当 
前 注意 信息 义理 指针 被 拷贝 到 Peresult ， 以 便 被 类 似 Pogetvalue 这 样 的 函数 使 用 。 


31.13. 事件 系统 


libpq 事 件 系统 用 于 通知 对 libpq 事件 感 兴趣 的 注册 事件 处 理 过 程 ， 如 创建 或 删除 Pecon 和 
PGresult 对 象 。 一 个 主要 的 使 用 原因 是 ， 它 允许 应 用 程序 通过 一 个 pcconn 或 P6result 关联 
它们 自己 的 数据 ， 并 且 确 保 数 据 在 适当 的 时 候 释 放 。 


每 个 注册 的 事件 处 理 程序 和 与 两 片 数 据 相关 联 ， 已 知 的 libpq 只 作为 不 透明 的 void * 指针 。 当 
事件 处 理 程序 注册 带 有 Pecon it, 应 用 程序 会 提供 一 个 passthrough 指 针 。 传 递 指针 在 由 它 
产生 的 PGconn 和 所 有 的 PGresult 的 生命 周期 中 永远 不 会 改变 ， 它 指 向 生命 周期 长 的 数据 。 
除 此 之 外 ， 还 有 一 个 jinstance da 要 指针 ， 它 从 每 个 PGconn 和 pcresult 中 的 NuLL 开始 。 这 


个 指针 可 以 与 PQinstanceData , PQsetInstanceData , PQresultInstanceData 和 
PQsetResultInstanceData 酌 数 一 起 使 用 。 需 要 注意 的 是 不 同 于 传递 指针 ， 一 个 Pecon 的 实 


例 数 据 不 会 被 由 它 产生 的 peresult 自动 继承 。 libpq 不 知道 传递 和 实例 数据 指针 指向 的 是 什 
么 ， 并 且 不 会 尝试 去 释放 它们 ; 这 对 事件 处 理 程序 是 一 种 保证 。 


31.13.1. 事件 类 型 


枚 举 PGEventId 命名 事件 系统 处 理 的 事件 的 类 型 。 所 有 的 命名 值 都 是 从 Pp6EvT 开始 。 对 每 个 
事件 类 型 来 说 ， 有 一 个 相应 的 事件 信息 结构 ， 用 于 传送 传递 给 事件 处 理 程序 的 参数 。 事 件 类 
型 如 下 : 


PGEVT_REGISTER 


当 调 用 PQregisterEventProc 时 ， 会 发 生 注 册 的 事件 。 这 是 一 个 理想 化 的 时 间 ， 用 于 初始 化 任 
意 instanceData , 可 能 需 一 个 事件 过 程 。 每 次 连接 中 的 每 个 事件 义理 程序 只 会 触发 一 个 注 
册 了 的 事件 。 如 果 事 件 过 程 失 败 ， 会 终止 注册 。 


typedef struct 
{ 


PGconn *conn; 
} PGEventRegister; 


当 接 收 到 PGEVT_REGISTER 时 ， evtInfo 指针 应 该 被 转换 为 一 个 PGEventRegister * o 这 个 结 
构 包 含 了 一 个 coNNECTION_oK 状态 的 Peconn ; 用 以 保证 在 获得 一 个 好 的 peconn 之 后 立即 请 
求 调用 PQregisterEventProc 。 当 返回 一 个 错误 代码 时 ， 必 须 执 行 所 有 的 清理 ， AAR 

有 PGEVT_CONNDESTROY 会 被 发 送 。 


PGEVT_CONNRESET 
PQreset 或 PQresetPoll 图 数 完成 时 ， 触 发 连接 复位 事件 。 在 这 两 种 情况 下 ， 只 有 重 置 成 功 
时 才 会 触发 事件 。 如 果 事 件 过 程 失败 ， 整 个 连接 复位 都 会 失败 ; Pecon KE 


为 CONNECTION BAD 状态 并 且 poresetPoll 将 返回 PGRES_POLLING_FAILED o 


typedef struct 


PGconn *conn; 
} PGEventConnReset; 


当 接 收 到 一 个 pcevt_connreset 事件 时 ， evtInfo 指针 应 该 被 转换 为 一 

个 PGEventConnReset * o 尽管 包含 的 PGconn 被 重 置 了 ， 但 所 有 事件 数据 不 会 改变 。 这 个 事 
件 应 该 用 于 reset/reload/requery 任 何 关联 的 instancedata, 需要 注意 的 是 即使 事件 过 程 在 处 
FE pGEVT_connreseT 时 失败 了 ， 当 连接 关闭 时 ， 仍 会 接收 一 个 pcevt_connvestroy 事件 。 


PGEVT_CONNDESTROY 


在 响应 PQfinish 时 会 触发 连接 破坏 事件 。 这 是 事件 过 程 的 职责 : 合适 的 清理 它 的 事件 数据 ， 
因为 libpq 没 有 能 力 管理 这 部 分 内 存 。 失 败 的 清理 会 导致 内 存 浴 出 。 


typedef struct 
{ 


PGconn *conn; 
} PGEventConnDestroy; 


当 接 收 到 一 个 PGEVT_coNNDESTROY 事件 时 ， evtInfo 指针 应 该 被 转换 为 一 

个 PGEventConnDestroy * o 在 PQfinish 执行 清 青 理 之 前 会 触发 该 事件 。 事件 过 程 的 返 反 回 值 会 被 
忽略 ， 因为 没有 很 好 的 方式 从 pofinish PHAM, AH, 一 个 事件 过 程 失败 不 应 该 中 止 清 
理 不 需要 的 内 存 的 过 程 。 


PGEVT_RESULTCREATE 


回应 任意 产生 一 个 结果 (包括 PagetResult ) 的 查询 执行 图 数 时 ， 会 触发 结果 创建 事件 。 这 
个 事件 只 有 在 成 功 创建 结果 时 才 会 被 触发 。 


typedef struct 
{ 
PGconn *conn; 


PGresult *result; 
} PGEventResultCreate; 


当 接 收 到 一 个 pcevt_resuttcreate 事件 时 ， evtInfo 指针 应 该 被 转换 为 一 

个 PGEventResultcreate * o conn 是 用 于 产生 结果 的 连接 。 这 是 理想 的 位 置 ， 用 于 初始 化 任 
与 结果 相关 联 的 instancepata o 如 果 事 件 过 程 失败 ， 结 果 会 被 清理 并 且 传 播 该 失败 。 

事件 过 程 不 应 该 尝试 自己 Paclear 结果 对 象 。 当 返 回 一 个 错误 代码 时 ， 必 须 执行 所 有 的 清 

理 ， 因 为 没有 PGEVT_RESULTDESTROY 会 被 发 送 。 


PGEVT_RESULTCOPY 
在 响应 PQcopyResult 时 会 触发 结果 拷贝 事件 。 只 有 在 拷贝 完成 时 ， 才 会 触发 该 事件 。 只 有 那 
些 为 源 结 果 成 功 处 理 pGEVT_RESULTCREATE 或 PGEVT_RESULTCOPY 事件 的 事件 过 程 才 会 收 


到 pGEVT_RESULTCOPY 事件 。 


typedef struct 
const PGresult *src; 


PGresult *dest; 
} PGEventResultCopy; 


当 接 收 到 一 个 pcevt_resuttcopy 事件 时 ， evtinfo 指针 应 该 被 转换 为 一 

个 PGEventResultCopy * o src 结果 是 当 dest 为 拷贝 目标 时 要 进行 拷贝 的 。 这 个 事件 用 于 提 
供 一 个 instancepata 的 深度 拷贝 ， 因 为 PacopyResult 做 不 到 。 如 果 事 件 过 程 失败 ， 整 个 拷 
贝 过 程 都 将 失败 ， 并 且 dest 结果 也 会 被 清理 。 当 返 回 一 个 错误 代码 时 ， 必 须 执行 所 有 的 清 
理 ， 因 为 没有 PGEVT_RESULTDESTROY 事件 会 被 发 送 。 


PGEVT_RESULTDESTROY 


在 回应 PQclear 时 会 触发 结果 破坏 事件 。 这 是 事件 过 程 的 责任 ; 合理 清理 它 的 事件 数据 ， 因 
为 libpgq 没 有 能 力 管理 这 块 内 存 。 清 理 失败 会 导致 内 存 浴 出 。 


typedef struct 
{ 


PGresult *result; 
} PGEventResultDestroy; 


当 接收 到 一 个 PGEVT_RESULTDESTROY 事件 时 ， evtInfo 指针 应 该 被 转换 为 一 

个 PGEventResultDestroy * o 这 个 事件 会 在 PQclear 执行 清理 之 前 被 触发 。 事件 过 程 的 返回 
结果 会 被 忽略 ， 因为 没有 一 个 方式 能 够 从 Paclear 指出 失败 。 同 样 ， 一 个 事件 过 程 失败 不 应 
该 中 止 对 不 需要 内 存 的 清理 。 


31.13.2. 事件 回调 过 程 


PGEventProc 


PGEventProc 是 一 个 事件 过 程 中 指针 的 typedef， 也 就 是 ， 从 libpq 接 收 事件 的 用 户 回调 函数 。 
事件 过 程 的 用 法 必须 如 下 : 


int eventproc(PGEventId evtId, void *evtInfo, void *passThrough) 


evtid 参数 指出 要 发 生 哪个 pcevt 事件 。 evtinfo 指针 必须 被 转换 为 合适 的 结构 类 型 以 获取 
有 关 该 事件 的 进一步 信息 。 passThrough 是 当 事 件 过 程 被 注册 时 ， 提 供给 
PQregisterEventProc 的 指针 。 这 个 函数 应 该 返回 一 个 非 0 的 值 ， 如 果 成 功 的 话 ， 反 之 ， 返 回 
0。 


在 任意 Pecon 中 ， 一 个 特殊 的 事件 过 程 只 能 注册 一 次 。 这 是 因为 过 程 地 址 被 用 于 作为 查询 关 
键 字 ， 以 识别 相关 的 实例 数据 。 


Caution 


在 Windows 上 ， 画 数 可 以 有 两 个 不 同 的 地 址 : 一 个 是 内 部 DLL 可 见 的 ， 另 一 个 是 外 部 DLL 
ALN, 需要 注意 的 是 ， libpq 事 件 过 程 钞 数 只 会 使 用 其 中 一 个 地 址 ， 否 则 会 造成 混乱 。 
有 效 的 编写 代码 的 简单 规则 是 为 了 保证 事件 过 程 声明 为 static o 如 果 过 程 地 址 在 它 的 源 
文件 之 外 是 可 用 的 ， 公 开 一 个 单独 的 函数 以 返回 地 址 。 


31.13.3. BASHA 


PQregisterEventProc 
用 libpq 注 册 一 个 事件 回调 过 程 。 


int PQregisterEventProc(PGconn *conn, PGEventProc proc, 
const char *name, void *passThrough); 


在 每 个 Pecon 中 必须 注册 一 次 事件 过 程 ， ee 除了 内 存 之 外 ， 对 于 一 次 
连接 注册 的 事件 过 程 个 数 没有 限制 。 如 果 成 功 ， 则 返回 一 个 非 0 的 值 ， 否 则 返回 0。 


当 一 个 libpq 事 件 被 触发 时 ， 会 调用 一 个 proc 参数 。 Si tl 

找 instanceData o name ae 误 信 息 中 的 事件 过 程 。 这 个 值 不 能 为 NuLL 或 一 人 1 
度 为 0 的 字符 串 。 名 字 字 符 串 被 拷贝 到 pecon 中 ， 因 此 被 传递 hee 
期 。 passThrough 指针 被 传递 到 proc, 不 管 何 时 触发 事件 。 这 个 参数 可 以 是 NLL o 


PQsetInstanceData 


A proc 到 data 的 过 程 设 置 连接 conn 的 instancepata 。 成 功 则 返回 一 个 非 0 值 ， 否 则 返回 
0。 只 有 proc 没有 成 功 在 conn 注册 时 才 会 发 生 失 败 。 


int PQsetInstanceData(PGconn *conn, PGEventProc proc, void *data); 


PQinstanceData 


返回 与 proc 过 程 ， 或 NULL (如 果 存 在 空 ) 相关 的 conn 的 instanceData o 


void *PQinstanceData(const PGconn *conn, PGEventProc proc); 


PQresultSetInstanceData 


A proc 到 data 的 过 程 设置 结果 的 instancedata. 成 功 则 返回 一 个 非 0 值 ， 否 则 返回 0。 只 
有 proc 没有 成 功 在 结果 注册 时 才 会 发 生 失 败 。 


int PQresultSetInstanceData(PGresult *res, PGEventProc proc, void *data); 


PQresultInstanceData 


返回 与 proc wth, BK NULL 《如 果 存 在 空 ) 相关 的 结果 的 instancepata o 


void *PQresultInstanceData(const PGresult *res, PGEventProc proc); 


31.13.4. 事件 例子 
一 个 管理 与 libpq 连 接 和 结果 相关 的 私有 数据 的 例子 : 


/* <!-- required header for libpq events (note: includes libpq-fe.h) --> 需 要 ]ibpq 事 件 的 头 文 : 
#include <libpq-events.h> 


/* The instanceData */ 
typedef struct 


to 
int n; 
char *str; 
} mydata; 


/* PGEventProc */ 
static int myEventProc(PGEventId evtId, void *evtInfo, void *passThrough); 


int 
main(void) 
{ 
mydata *data; 
PGresult *res; 
PGconn *conn = PQconnectdb("dbname = postgres"); 


if (PQstatus(conn) != CONNECTION_OK) 


fprintf(stderr, "Connection to database failed: %s", 
PQerrorMessage(conn)); 

PQfinish(conn); 

return 1; 


} 


elise 
/* called once on any connection that should receive events. 
* Sends a PGEVT_REGISTER to myEventProc. 
A 
> 
/* 在 任何 应 该 接收 事件 的 连接 上 调用 一 次 。 
* 发 送 一 个 PGEVT_REGISTER 到 myEventProc。 
yf 


if (!PQregisterEventProc(conn, myEventProc, "mydata_proc", NULL) ) 


fprintf(stderr, "Cannot register PGEventProc\n"); 
PQfinish(conn) ; 
return 1; 


} 


<!-- /* conn instanceData is available */ --> 
/* conn instanceData 是 可 用 的 */ 
data = PQinstanceData(conn, myEventProc); 


<!-- /* Sends a PGEVT_RESULTCREATE to myEventProc */ --> 
/* 发 送 一 个 PGEVT_RESULTCREATE 到 myEventProc */ 
res = PQexec(conn, "SELECT 1 + 1"); 


<!-- /* result instanceData is available */ --> 
* 结果 instanceData 是 可 用 的 */ 
data = PQresultInstanceData(res, myEventProc); 


<!-- /* If PG_COPYRES_EVENTS is used, sends a PGEVT_RESULTCOPY to myEventProc */ --> 


/* 如 果 使 用 了 PG_COPYRES_EVENTS， 发 送 一 个 PGEVT_RESULTCOPY#] myEventProc */ 
res_copy = PQcopyResult(res, PG_COPYRES_TUPLES | PG_COPYRES_EVENTS); 


Klos 

/* result instanceData is available if PG_COPYRES_EVENTS was 
* used during the PQcopyResult call. 
2 

T> 

/* 结果 instanceData 是 可 用 的 ， 如 果 PG_COPYRES_EVENTS 
* 在 PQcopyResult 调 用 期 间 使 用 了 的 话 。 
A 


data = PQresultInstanceData(res_copy, myEventProc); 


<!-- /* Both clears send a PGEVT_RESULTDESTROY to myEventProc */ --> 
/* 两 个 clears 都 发 送 PGEVT_RESULTDESTROY 到 myEventProc */ 

PQclear(res); 

PQclear(res_copy); 


<!-- /* Sends a PGEVT_CONNDESTROY to myEventProc */ --> 
/* 发 送 一 个 PGEVT_CONNDESTROY 到 myEventProc */ 
PQfinish(conn); 


return 0; 


} 


static int 
myEventProc(PGEventId evtId, void *evtInfo, void *passThrough) 


{ 
switch (evtId) 


{ 
case PGEVT_REGISTER: 


{ 
PGEventRegister *e = (PGEventRegister *)evtiInfo; 


mydata *data = get_mydata(e->conn); 


<!-- /* associate app specific data with connection */ --> 
/* 将 应 用 程序 特定 的 数据 与 连接 相关 联 */ 


PQsetInstanceData(e->conn, myEventProc, data); 


break; 
} 
case PGEVT_CONNRESET: 
PGEventConnReset *e = (PGEventConnReset *)evtInfo; 
mydata *data = PQinstanceData(e->conn, myEventProc); 
if (data) 
memset(data, 0, sizeof(mydata)); 
break; 
} 
case PGEVT_CONNDESTROY: 
{ 
PGEventConnDestroy *e = (PGEventConnDestroy *)evtIinfo; 
mydata *data = PQinstanceData(e->conn, myEventProc); 
<!-- /* free instance data because the conn is being destroyed */ --> 
/* 释放 实例 数据 ， 因 为 conn 被 破坏 了 */ 
if (data) 
free_mydata(data); 
break; 
} 
case PGEVT_RESULTCREATE: 
{ 


PGEventResultCreate *e = (PGEventResultCreate *)evtInfo; 
mydata *conn_data = PQinstanceData(e->conn, myEventProc); 
mydata *res_data = dup_mydata(conn_data); 


<!-- /* associate app specific data with result (copy it from conn) */ --> 
/* 将 应 用 程序 特定 的 数据 与 结果 相关 联 (从 conn 中 拷贝 ) */ 


PQsetResultInstanceData(e->result, myEventProc, res_data); 


break; 


} 


case PGEVT_RESULTCOPY: 


PGEventResultCopy *e = (PGEventResultCopy *)evtInfo; 
mydata *src_data = PQresultInstanceData(e->src, myEventProc); 
mydata *dest_data = dup_mydata(src_data); 


<!-- /* associate app specific data with result (copy it from a result) */ -- 
/将 应 用 程序 特定 的 数据 与 结果 相关 联 (从 结果 中 拷贝 )*/ 

PQsetResultInstanceData(e->dest, myEventProc, dest_data); 

break; 


} 


case PGEVT_RESULTDESTROY: 


PGEventResultDestroy *e = (PGEventResultDestroy *)evtinfo; 
mydata *data = PQresultInstanceData(e->result, myEventProc); 


<!-- /* free instance data because the result is being destroyed */ --> 
/* 释放 实例 数据 ， 因 为 结果 被 破坏 了 */ 
if (data) 
free_mydata(data); 
break; 
} 
<!-- /* unknown event ID, just return TRUE. */ --> 
/* 未 知事 件 ID， 只 是 返回 TRUE。*/ 
default: 
break; 


} 


return TRUE; /* <!-- event processing succeeded --> 事 件 处 理 成 功 */ 


剧 





31.14. 环境 变量 


下 面 的 环境 变量 可 以 用 于 选择 缺 省 的 连接 参数 值 ， 这 些 值 将 被 PQconnectdb 
， PQsetdbLogin 和 PQsetdb 使 用 ， 如 果 调 用 代码 没有 直接 声明 相应 值 的 话 。 比如 ， 这 些 〈 环 
境 变量 ) 可 以 避免 把 硬 编码 数据 库 连 接 信 息 写 人 简单 的 客户 端 应 用 中 。 


e pcHost 与 host 连 接 参 数 表 现行 为 相同 。 


e ”PGHOSTADDR 与 hostaddr 连 接 参 数 表现 行为 相同 。 这 样 可 以 代替 或 除去 PGHOST 以 避免 
DNS 查 找 的 开销 。 


e ”PGPORT 与 port 连 接 参数 表现 行为 相同 。 
e PGDATABASE 与 dbname 连 接 参 数 表 现行 为 相同 。 
e ”PGUSER 与 user 连 接 参数 表现 行为 相同 。 


e pcpasswordD 与 password 连 接 参 数 表 现行 为 相同 。 出 于 安全 原因 是 不 推荐 使 用 这 个 环境 
变量 的 ， 因 为 某 些 操作 系统 允许 非 root 用 户 通过 ps 看 到 进程 的 环境 变量 ， 而 是 考虑 使 
用 ~/.pgpass 的 文件 (详情 请 看 Section 31.15) o 


© PGPASSFILE 指定 密码 文件 的 名 称 用 于 查找 。 如 果 没 有 设置 ， 默认 为 ~/.pgpass ( 见 
Section 31.15) 。 


© pGSERVICE 与 service 连 接 参数 表现 行为 相同 。 
© PGSERVICEFILE 指定 连接 服务 的 文件 中 每 个 用 户 的 名 字 ， 如 果 没 有 设置 默 


认 ~/.pg_service.conf ( 见 Section 31.16). 


PGREALM 设置 与 PostgreSQL 一 起 使 用 的 Kerberos 域 ， 如 果 该 域 与 本 地 域 不 同 的 话 。 如 
果 设 置 了 PGREALM ，libpq 应 用 将 试图 用 这 个 域 (realm) 与 服务 器 进行 认证 并 且 使 用 独立 
的 门票 文件 (ticket files) 以 避免 与 本 地 的 门票 文件 冲突 。 只 有 在 服务 器 选择 了 
Kerberos 认证 时 才 使 用 这 个 环境 变量 。 


e pcoptions 与 options 连 接 参 数 表 现行 为 相同 。 

e PGAPPNAME 与 application_name 连 接 参 数 表 现行 为 相同 。 

e ”PGSSLMODE 与 ssImode 连 接 参 数 表 现行 为 相同 。 

e pGREQUIRESSL 与 requiress| 连 接 参 数 表现 行为 相同 。 

© PGSSLCOMPRESSION 与 sslcompression 连 接 参 数 表 现行 为 相同 。 
e PGSSLCERT 与 sslcert 连 接 参 数 表 现行 为 相同 。 

e PGSSLKEY 与 ss|lkey 连 接 参 数 表现 行为 相同 。 


© PGSSLROOTCERT 与 sslrootcert 连 接 参 数 表 现行 为 相同 。 

e pessicr. 与 sslcrl 连 接 参 数 表现 行为 相同 。 

© PGREQUIREPEER 与 redquirepeer 连 接 参 数 表现 行为 相同 。 

e PGKRBSRVNAME 与 krbsrvname 连 接 参 数 表 现行 为 相同 。 

e ”PGGSSLIB 与 gsslib 连 接 参 数 表 现行 为 相同 。 

© PGCONNECT_TIMEOUT 与 connect timeout 连 接 参 数 表现 行为 相同 。 
e PGCLIENTENCODING 与 client encoding 连接 参数 表现 行为 相同 。 


下 面 的 环境 变量 可 以 用 于 为 每 个 PostgreSQL 会 话 声 明 缺 省 特性 。 (又 见 ALTER ROLE 和 
ALTER DATABASE@ S, 在 每 用 户 或 每 数据 库 的 基础 上 设置 缺 省 行为 。) 


© PGDATESTYLE 设置 缺 省 的 日 期 /时 间 表 现形 式 。 (等 效 于 SET datestyle TO... o ) 
e porz 设置 缺 省 的 时 区 。 (等 效 于 set timezone To... o ) 
e PGGEQ0 为 基因 优化 器 设置 缺 省 模式 。 (等 效 于 set geqo TO ... o ) 

请 参考 SQL 命令 SET 获取 这 些 环 境 变 量 的 正确 数值 。 

下 面 的 环境 变量 决定 libpq 的 内 部 行为 ; 它们 覆盖 编译 的 缺 省 。 


© PGSYSCONFDIR 设置 包含 pg_service.conf 文件 和 未 来 版 本 中 可 能 的 其 他 系统 范围 的 配置 
文件 的 目录 。 


© PGLOCALEDIR 设置 包含 信息 国际 化 的 locale 文件 目录 。 


31.15. 口 全 文件 


用 户 家 目录 中 的 .pgpass 或 者 PePASsFILE 引用 的 文件 是 一 个 可 以 包含 口令 的 文件 。 如 果 连 接 
要 求 口 令 〈 并 且 没 有 用 其 它 方 法 声明 口令 ) ， 那么 可 以 用 它 。 在 Microsoft Windows E, X 
件 名 字 是 %APPDATA%\postgresql\pgpass.conf ( %APPDATA% 指 用 户 配 置 里 的 Application Data 

子 目录 ) 。 


这 个 文件 应 该 有 下 面 这 样 的 格式 行 : 


_hostname_:_port_:_database_:_username_:_password_ 


你 可 以 通过 复制 上 面 的 行 并 且 在 前 面 添 加 # 用 于 添加 提醒 注释 到 文件 ， 头 四 个 字段 每 个 都 可 
以 是 一 个 文本 值 ， 或 者 * ， 它 匹配 所 有 的 东西 。 第 一 个 匹配 当前 连接 参数 的 口令 行 的 口令 域 
将 得 以 使 用 。 (因此 ， 如 果 你 使 用 了 通配符 ， 那么 应 该 把 最 具体 的 记录 放 在 前 面 。) 如 果 记 
录 包 含 : 或 者 、， 应 该 用 、 Wee, — localhost 的 主机 名 匹配 来 自 本 机 的 TCP (主机 
名 localhost ) 和 Unix 域 套 接 字 ( pghost 为 空 或 缺 省 的 套 接 字 目 录 ) 连接 。 在 各 用 服务 器 
中 ， 一 个 名 字 为 replication 的 数据 库 被 匹配 到 主 服务 器 的 流 复制 连接 。 database 字段 用 处 
有 限 ， 因 为 对 同一 集群 中 所 有 数据 库 用 户 有 相同 密码 。 


在 linux 系 统 中 ， .pgpass 的 权限 必须 不 允许 任何 全 局 或 者 同 组 的 用 户 访问 ; 我 们 可 以 用 命 
43 chmod 0600 ~/.pgpass 实现 这 个 目的 。 如 果 权 限 比 这 个 松 ， 这 个 文件 将 被 忽略 。 在 
Microsoft Windows 上 ， 假 定 该 文件 存储 在 一 个 安全 的 目录 中 ， 所 以 没有 做 特殊 的 权限 检查 。 


31.16. 连接 服务 的 文件 


连接 服务 文件 允许 libpq 连 接 参 数 可 以 与 一 个 单一 的 服务 名 称 相关 联 。 服务 名 之 后 可 以 被 一 个 
libpq 连 接 声明 ， 并 且 会 使 用 相关 设置 。 人 允许 连接 参数 无 需要 求 一 个 重新 编译 的 libpq 应 用 进行 
修改 。 服务 名 同样 可 以 用 pesERVICE 环境 变量 进行 声明 。 


连接 服务 文件 可 以 是 在 ~/.pg_service.conf ， 或 者 PGSERVICEFILE 环境 变量 声明 位 置 中 的 一 
个 按 用 户 的 服务 文件 ， 也 可 以 是 一 个 位 于 etc/pg_service.conf ， 或 者 PGSYSCONFDIR 环境 变 
量 声明 位 置 中 的 一 个 全 系统 文件 。 如 果 定 义 的 服务 名 与 在 用 户 和 系统 文件 中 的 名 字 相 同 ， 那 
么 用 户 文件 优先 。 


该 文件 使 用 "INI file" 格 式 (章节 名 是 服务 名 ， 并 且 参 数 是 连接 参数 ) ; By Section 31.1.2 获 
取 一 个 列表 ， 例 如 : 


# comment 
[mydb ] 
host=somehost 
port=5433 
user=admin 


在 share/pg_service.conf.sample 中 提供 了 一 个 示例 文件 。 


31.17. LDAP 坦 找 连 接 参 数 


如 果 libpq 已 经 通过 LDAP 支 持 〈 configure 的 --with-ldap ) 进行 了 编译 ， 可 以 从 一 个 中 央 服 
务 器 ， 通过 LDAP 检 索 连 接 选 项 ， 如 host 或 dbname, 这 样 做 的 好 处 是 ， 如 果 一 个 数据 库 连 
接 参 数 发 生 了 改变 ， 在 所 有 客户 端的 连接 信息 不 必 进 行 改变 。 


LDAP 连 接 参 数 查 找 使 用 连接 服务 文件 pg_service.conf (参阅 Section 31.16)。 

在 pg_service.conf 中 的 以 1dap:// 开始 的 一 行 被 看 做 是 一 个 LDAP URL, 并 且 会 执行 一 个 
LDAP 查 询 。 返 回 结 果 会 是 一 个 keyword = value 的 列表 ， 用 于 设置 连接 选项 。URL 必 须 符合 
RFC 1959， 并 且 是 如 下 形式 : 


ldap://[_hostname_[:_port_]]/_search_base ? attribute ?_search scope ?_ filter 








这 里 hostname. WRA localhost 和 _port_ A 4389. 


pg_service.conf 的 义理 在 LDAP 成 功 查找 之 后 就 会 被 终止 ， 但 如 果 不 能 成 功 连接 LDAP 服 
务 ， 那 么 会 继续 。 这 是 为 了 进一步 指向 不 同 的 LDAP 服 务 器 的 LDAP URL 线 而 提供 的 一 个 回 
vA, 标准 的 keyword = value 对 格式 ， 或 缺 省 的 连接 参数 。 如 果 想 在 这 种 情况 下 获得 一 个 错 
误 信息 ， 可 以 在 LDAP URL 后 添加 一 个 语法 不 正确 的 行 。 


LDIF 文 件 创建 的 一 个 样本 LDAP 条 目 : 


version:1 

dn:cn=mydatabase, dc=mycompany, dc=com 
changetype:add 

objectclass:top 
objectclass:groupOfUniqueNames 
cn:mydatabase 

uniqueMember :host=dbserver .mycompany.com 
uniqueMember : por t=5439 
uniqueMember : dbname=mydb 
uniqueMember : user=mydb_user 
uniqueMember :sslmode=require 


可 能 被 下 列 的 LDAP URL# 34 : 


ldap://ldap.mycompany.com/dc=mycompany, dc=com?unidueMember?one?(cn=mydatabase) 


也 可 以 通过 LDAP 查 找 来 混合 日 常服 务 文件 。 一 个 pg_service.conf 中 完整 的 一 节 的 例子 如 
F: 


# only host and port are stored in LDAP, specify dbname and user explicitly 
[customerdb] 

dbname=customer 

user=appuser 
ldap://ldap.acme.com/cn=dbserver,cn=hosts?pgconnectinfo?base?(objectclass=*) 
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31.18. SSL 支持 


PostgreSQL 本 机 支持 使 用 SSL 连 接 对 客户 端 /服务 器 通讯 进行 加 密 ， 以 增强 安全 性 。 参 
阅 Section 17.9 获 取 服 务 器 端 SSL 功 能 的 细节 。 


libpq 读 取 全 系统 OpenSSL 配 置 文件 ， 默认 情况 下 ， 文 件 命 名 为 openssl.cnf 并 且 存 放 
在 openssl version -d 报告 的 目录 中 。 此 默认 可 以 通过 设置 环境 变量 oPENssL_coNF 为 所 需 配 
置 文件 的 名 称 来 重 写 。 


31.18.1. 服务 器 证 书 的 客户 端 验证 


缺 省 ，PostgreSQL 不 会 执行 任何 服务 器 证 书 验证 。 这 就 意味 着 可 以 在 客户 端 没有 察觉 的 情况 
下 骗 过 服务 认证 〈 如 ， 通 过 修改 一 个 DNS 记录 或 接管 服务 IP 地 址 ) 。 为 了 避免 这 种 情况 ， 必 
须 使 用 SSL 证 书 认 证 。 


如 果 sslmode 参数 设置 为 verify-ca ， libpq 和 将 通过 检查 受信 任 的 证 书 颁发 机 构 的 证 书 链 (CA) 
来 验证 服务 是 可 信任 的 。 如 果 sslmode 设置 为 verify-full ， libpq 也 会 通过 验证 服务 主机 名 
匹配 认证 来 认为 服务 是 可 信任 的 。 如 果 服 务 验 证 不 能 被 通过 ， 那 么 SSL 连 接 会 失败 。 在 大 多 
数 对 安全 要 求 较 高 的 环境 中 ， 建议 使 用 verify-full 。 

在 verify-full 模式 下 ， 认 证 的 cn (Common Name) 属 性 与 主机 名 进行 匹配 。 如 

R cn 以 * 开始， 会 被 看 做 是 一 个 通配符 ， 并 且 会 匹配 除了 A.) 之 外 的 所 有 字符 。 这 就 
意味 着 认证 不 会 匹配 子 域名 。 如 果 是 使 用 IP 而 不 是 主机 名 进行 连接 ， 会 进行 |P 匹 配 检查 (不 
会 做 DNS 检查 ) 。 

为 了 人 允许 服务 器 认证 通过 ， 一 个 或 多 个 信任 的 CA 认证 必须 放 在 用 户 的 Nome 目 录 下 的 
~/.postgresql/root.crt 文件 中 。 Windows 下 的 文件 名 是 %APPDATA%\postgresql\root.crt o 


如 果 存 在 ~/.postgresql/root.cr1 文件 (Windows FÆ %APPDATA%\postgresql\root.crl X 
44) ， 同 样 也 会 检查 证 书 吊销 列表 (CRL) 。 


root 认 证 文件 和 CRL 的 位 置 可 以 通过 设置 sslrootcert 和 sslcrl 连接 参数 ， 
或 PGSSLROOTCERT 和 PGSsSLCRL 环境 变量 进行 修改 。 

















Note: 为 了 与 早期 PostgreSQL 版 本 兼容 ， 如 果 存 在 一 个 根 CA 文 件 ， sslmode = require 
B47 AHA verify-ca 表现 的 相同 ， 意 味 着 服务 器 证 书 是 经 过 CA 验证 的 。 不 建议 依赖 于 
这 个 行为 ， 需 要 证 书 验 证 的 应 用 应 该 总 是 使 用 verify-ca 或 verify-full 。 














31.18.2. & > imit + 


如 果 服 务 器 要 求 一 个 信任 的 客户 端 认 证 ，libpq 和 将 发 送 存储 在 用 户 home 目 录 中 
~/.postgresql/postgresql.crt 文件 中 的 证 书 。 该 证 书 必 须 由 服务 器 信任 的 证 书 认证 (CA) 
之 一 签名 。 同 时 也 必须 出 示 一 个 匹配 的 私 钥 文件 ~/.postgresql/postgresql.key 。 私 钥 文件 不 
E E 问 5 通过 chmod 0600 ~/.postgresql/postgresql.key 命令 可 以 实现 。 
在 Windows 上 ， 这 个 文件 是 %APPDATA%\postgresql\postgresql.crt 

和 %APPDATA%\postgresql\postgresql.key ， 同时 没有 特定 的 权限 检查 ， 因为 目录 被 认为 是 安全 
的 。 证 书 和 key 文 件 的 位 置 可 以 通过 sslcert 和 sslkey 连接 参数 ， 

或 pessLcERT 和 pessLkEY 环境 变量 进行 覆盖 重 写 。 


在 一 些 情况 下 ， 客 户 端 认 证 可 能 会 被 一 个 "intermediate" 的 证 书 认 证 来 签名 ， 而 不 是 一 个 能 直 
接 被 服务 信任 的 。 为 了 使 用 一 个 这 种 认证 ， 向 postgresql.crt 文件 追加 证 书签 字 权 ， 并 且 直 
到 "root" 都 可 以 被 服务 器 信任 。 root 认 证 应 该 被 包含 在 任何 一 种 情况 〈 postgresql.crt 包含 多 
个 认证 ) 下 。 


需要 注意 的 是 ， root.crt 列 出 了 最 高 级 别 的 CA， 认为 对 签名 服务 证 书 来 说 是 可 信任 的 。 原 


则 上 ， 不 需要 列 出 签名 客户 端 认证 的 CA， 尽管 在 大 多 数 情况 下 ，CA 仍 会 被 认为 对 服务 器 认 
证 是 可 信任 的 。 


31.18.3. 在 不 同 的 模式 提供 保护 


sslmode 参数 的 不 同 值 提供 了 不 同 的 保护 级 别 。SSL 可 以 为 三 种 攻击 提供 保护 : 
Eavesdropping (窃听 ) 


如 果 一 个 第 三 方 可 以 在 客户 端 与 服务 器 端 之 间 检 查 网 络 通信 ， 那 么 它 就 能 读 取 两 边 的 连接 信 
息 (包括 用 户 名 和 密码 ) 以 及 传递 的 数据 。 对 此 ，SSL 通 过 加 密 进 行 防护 。 


裁判 (MITM) 


如 果 客 户 端 和 服务 器 端 进行 传递 数据 的 时 候 ， 第 三 方 可 以 对 其 进行 修改 ， 那 么 他 就 能 伪装 成 
服务 器 ， 然后 查看 或 修改 数据 (即使 是 加 密 的 ) 。 第 三 方 接着 可 以 向 原始 服务 器 发 出 连接 信 
息 和 数据 ， 最 终 造 成 无 法 防护 这 种 攻击 。 这 种 攻击 常用 的 载体 有 DNS 中 毒 或 |P 绑 架 ， 即 客户 
端 被 定向 到 预期 之 外 的 不 同 的 服务 器 。 同 样 还 有 几 种 其 他 的 方法 也 能 做 到 这 种 攻击 。 SSL 通 
过 服务 器 到 客户 端的 证 书 验证 来 阻止 这 种 攻击 。 


Impersonation (模拟 ) 

如 果 第 三 方 可 以 伪装 成 一 个 认证 了 的 客户 端 ， 那 么 它 就 能 轻松 访问 到 它 本 来 不 能 访问 的 数 
据 。 典型 的 ， 如 不 安全 的 密 钥 管理 ， 就 会 造成 这 种 情况 。SSL 通过 客户 端 认 证 来 阻止 这 种 情 
况 ， 即 确保 只 有 知道 有 效 认 证 的 人 员 才 能 访问 连接 服务 器 。 

对 于 一 个 被 称 为 安全 的 连接 来 说 ， 进 行 连接 之 前 ， 必 须 在 客户 端 和 服务 器 端 都 进行 SSL 配 置 。 


如 果 只 在 服务 器 端 进行 配置 ， 在 它 知道 服务 器 端 需要 高 级 认证 之 前 不 会 发 送 敏感 信息 (ME 
码 等 ) 。 在 libpgq 中 ， 可 以 通过 将 sslmode 参数 设置 为 verify-full 或 verify-ca 来 确保 安全 


连接 ， 并 且 为 系统 提供 一 个 root 认 证 以 进行 安全 认证 。 类 似 于 使 用 https 和 URL 进 行 加 密 网 


页 浏览 。 


一 且 服 务 器 已 经 认证 ， 客 户 端 就 可 以 发 送 敏感 信息 。 这 就 意味 着 直到 这 一 刻 ， 客 户 端 都 不 需 
要 知道 ， 是 否认 证 需要 证 书 ， 只 在 服务 器 配置 ， 对 其 安全 地 指定 。 


所 有 以 加 密 和 密 钥 交换 方式 得 SSL 选 项 都 会 产生 开销 ， 因 此 在 性 能 和 安全 之 间 需 要 进行 一 个 权 
衡 。 Table 31-1 说 明 不 同 sslmode 值 的 安全 风险 ， 以 及 关于 安全 和 开销 所 做 出 的 声明 : 


Table 31-1. SSL 模式 说 明 


g 
sslmode 听 声 
lmod 保 MITM{R 47 声明 
ip 
disable a 5 我 不 关心 安全 ， 我 不 想来 支付 加 密 的 开销 。 
ee my |S 我 不 关心 安全 性 ， 但 我 会 支付 的 加 密 开 销 ， 如 果 服 
ne | S 务 器 的 坚持 的 话 。 
E 可 | 下 我 不 关心 加 密 ， 但 我 想 支 付 加 密 开 销 ， 如 果 服 务 器 
能 一 支持 它 。 
eerie a ee 我 希望 我 的 数据 加 密 ， 我 接受 开销 。 我 相信 该 网 络 
ana eis 将 确保 我 始终 连接 到 我 想 要 的 服务 器 。 
ga = 取决 于 CA 的 ”， 我 希望 我 的 数据 加 密 ， 我 接受 开销 。 我 想 要 确保 我 
= RKE 连接 到 了 一 个 我 信任 的 服务 器 。 
我 希望 我 的 数据 加 密 ， 我 接受 开销 。 我 想 要 确保 我 
verify-full 是 是 连接 到 了 一 个 我 信任 的 服务 器 ， 并 且 是 我 指定 的 
那个 服务 器 。 


verify-ca 和 verify-full 之 间 的 不 同 是 根据 root CA 的 政策 。 如 果 使 用 的 是 一 个 公用 

CA, verify-ca 允许 那些 带 有 CA 注册 的 客户 端 对 服务 器 进 和 J 连接 访问 。 EMILE, č% 
该 使 用 verin full. 如 果 使 用 的 是 一 个 本 地 CA， 甚 至 是 一 个 自 签 名 证 书 ， 使 

用 verify-ca 会 提供 充 分 的 保护 。 


sslmode RBE prefer 。 如 在 表 中 说 明 的 那样 ， 从 安全 角度 来 看 这 样 做 是 没有 意义 的 ， 并 
且 如 果 可 能 的 话 ， 它 只 承诺 性 能 的 开销 。 它 仅 提供 了 缺 省 向 后 兼容 性 ， 在 安全 部 署 中 不 建议 
使 用 。 


31.18.4. SSL 客户 端 文 件 的 使 用 


Table 31-2 总 结 了 与 客户 端 SSL 设 置 相 关 的 文件 。 


Table 31-2. libpq/ 客 户 端 SSL 文 件 的 使 用 


文件 内 容 影响 
~/.postgresql/postgresql.crt 客户 端 证 书 服务 器 要 求 的 
客户 端的 私 ”证 明 由 所 有 者 发 送 的 客户 端 证 书 ， 并 不 
sA 表示 证 书 拥有 者 是 值得 信赖 的 
受信 任 的 证 。 检查 服务 器 证 书 是 由 受信 任 的 证 书 机 关 
书 颁发 机 构 ”签署 。 
证 书 颁 发 机 
构 吊 销 证 书 


~/.postgresql/postgresql.key 
~/.postgresql/root.crt 


~/.postgresql/root.crl 


服务 器 证 书 必须 不 在 这 个 名 单 


31.18.5. SSL 库 初 始 化 


如 果 应 用 程序 初始 化 libssl 和 /或 libssl 库 以 及 libpq 编译 为 支持 SSL， 应 该 调 

用 PainitopenssL 来 告诉 libpq 说 libssl 和 /或 libcrypto 库 已 经 被 应 用 程序 初始 化 了 ， 因此 
libpq 将 不 会 再 初始 化 这 些 库 。 参 阅 

http://h71000.www7.hp.com/doc/83final/BA554 90007/ch04.html 获取 关于 SSL API 的 详细 信 
息 。 


PQinitOpenSSL 
允许 应 用 程序 选择 安全 库 初始 化 。 


void PQinitOpenSSL(int do_ssl, int do_crypto); 


4 do_ssl 为 非 0 时 ， 在 第 一 次 打开 一 个 数据 库 连 接 之 前 ，libpq 将 初始 化 OpenSSL 库 。 
当 do_crypto 为 非 0 时 ， libcrypto 库 将 被 初始 化 。 缺 省 (如 果 PainitopenssL 没有 被 调用 )， 
两 个 库 都 会 被 初始 化 。 如 果 没 有 编译 SSL 支 持 ， 会 提供 该 范 数 ， 但 不 会 做 任何 事情 。 


如 果 应 用 程序 使 用 并 初始 化 OpenSSL， 或 其 底层 libcrypto 库 ， 那么 在 第 一 次 打开 一 个 数据 
BZA, VARTA 〈 带 有 适当 0 值 的 参数 ) 。 同样 要 确保 在 打开 一 个 数据 库 连 接 
之 前 做 过 初始 化 。 


PQinitSSL 
允许 应 用 程序 选择 初始 化 哪个 安全 库 。 
void PQinitSSL(int do_ssl); 
此 功能 相当 于 PQinitOpenSSL(do_ssl, do_ssl) o 它 的 应 用 是 足够 的 同时 初始 化 或 都 不 初始 化 
OpenSSL 和 libcrypto o 


PQinitssL 在 PostgreSQL 8.0 就 已 经 出 现 了 ， 而 PQinitopenssL 是 在 PostgreSQL 8.4 添 加 进 
来 的 。 所 以 对 老 版 本 的 libpq 的 使 用 ， PainitssL 是 对 应 用 程序 的 不 错 的 选择 。 


31.19. 在 多 线程 程序 里 的 行为 


libpq 是 可 重 入 的 并 且 是 线程 安全 的 。 另 外 ， 在 你 编译 自己 的 上 应 用 代码 时 ， 可 能 需要 使 用 额外 
的 编译 器 命令 行 选项 。 参考 你 的 系统 的 文档 获取 关于 如 果 建 立 线程 可 用 的 应 用 的 信息 ， 或 

在 src/Makefile.global 中 查看 PTHREAD_CFLAGS 和 PTHREAD_LIBS 。 此 功能 允许 查询 libpq 的 线 
程 安全 状态 : 

PQisthreadsafe 


返回 libpq 库 的 线程 安全 状态 。 


int PQisthreadsafe(); 


libpq 是 线程 安全 的 时 ， 返 回 1 ; 如 果 不 是 返回 0。 


一 个 线程 限制 是 ， 两 个 线程 不 能 试图 同时 操作 同一 个 Pecon 对 象 。 特 别 是 ， 你 不 能 从 不 同 的 
线程 里 通过 同一 个 连接 对 象 发 出 并 发 的 命 分 。 〈 如 果 你 需要 运行 并 行 命 售 ， 请 使 用 多 个 连 
接 。) 


PGresult 对 象 在 创建 后 是 只 读 的 ， 因 此 可 以 自由 地 在 线程 之 间 传 递 。 然 而 ， 如 果 你 使 用 
在 Section 31.11 和 Section 31.13 中 描述 的 任何 Peresult (EWR, AA CHEAT (Ka Let 
免 同 一 PGresult 上 的 并 发 操作 。 


过 时 了 的 函数 PQrequestCancel 和 PQoidStatus 都 是 线程 不 安全 的 ， 因此 不 应 该 在 一 个 多 线程 
的 程序 里 面 使 用 。 PQrequestCancel 可 以 由 PQcancel Ke. PQoidStatus 可 以 由 
PQoidValue RË. 


如 果 在 你 的 应 用 内 部 使 用 了 Kerberos (而 不 仅仅 是 libpq 里 面 ) , 你 就 需要 在 Kerberos 调用 
周围 锁 住 ， 因 为 Kerberos KATERENN. 参阅 libpq 源 代码 里 面 
的 ParegisterThreadLock 获取 一 个 在 libpq 和 你 的 应 用 之 间 进 行 恰当 锁定 的 方法 。 


如 果 你 的 线程 应 用 有 问题 ， 那 么 运行 一 个 在 src/tools/thread 里 的 程序 ， 看 看 你 的 平台 是 否 
有 线程 不 安全 的 函数 。 这 个 程序 由 configure 运行 ， 但 如 果 是 二 进 制 版 本 ， 你 的 库 可 能 就 不 
能 和 制作 二 进 制 的 那个 库 匹 配 了 。 


31.20. 制作 libpq 程 序 


要 制作 (也 就 是 说 编译 和 链接 ) 你 的 libpq 程 序 ， 你 需要 做 下 面 的 一 些 事情 : 
e 包含 libpq-fe.h 头 文件 : 


#include &lt;libpq-fe.h&gt; 


如 果 你 没 干 这 件 事 ， 那 么 你 通常 会 看 到 类 似 下 面 这 样 的 来 自 编译 器 的 错误 信息 : 


foo.c: In function ‘main': 

foo.c:34: ~PGconn' undeclared (first use in this function) 

foo.c:35: ~PGresult' undeclared (first use in this function) 

foo.c:54: ~“CONNECTION_BAD' undeclared (first use in this function) 

foo.c:68: ~PGRES_COMMAND_OK' undeclared (first use in this function) 
C 


foo.c:95: ‘PGRES_TUPLES OK' undeclared (first use in this function) 


e 告诉 你 的 编译 器 PostgreSQL 头 文件 的 安装 位 置 ， 方 法 是 给 你 的 编译 器 提供 
-I``_directory 选项。( 有 些 时 候 编 译 器 会 查找 缺 省 的 目录 ， 因此 你 可 以 忽略 这 些 选 
项 。) 比如 ， 你 的 编译 命令 行 看 起 来 像 : 


cc -c -I/usr/local/pgsql/include testprog.c 


如 果 你 在 使 用 制作 文件 (makefile)， 那 么 向 cPPFLAGs 变量 中 增加 下 面 的 选项 : 


CPPFLAGS += -I/usr/local/pgsql/include 


如 果 你 的 程序 可 能 会 被 别人 编译 ， 那 么 你 应 该 避免 像 上 面 那样 把 目录 路 径 写成 硬 编码 。 
取而代之 的 是 你 可 以 运行 pg_config 工具 找 出 头 文件 在 系统 的 什么 地 方 : 


&lt;samp class="literal"&gt;$&lt;/samp&gt; pg_config --includedir 
&lt;samp class="literal"&gt;/usr/local/include&lt ;/samp&gt; 


如 果 你 安装 了 pkg-config, (ALBA: 


&lt;samp class="literal"&gt;$&lt;/samp&gt; pkg-config --cflags libpq 
&lt;samp class="literal"&gt; -I/usr/local/include&lt;/samp&gt; 


注意 路 径 的 前 面 早已 包括 -IT 。 
如 果 没 能 给 编译 器 提供 正确 的 选项 将 产生 类 似 下 面 这 样 的 错误 信息 : 


testlibpq.c:8:22: libpq-fe.h: No such file or directory 


。 在 链接 最 后 的 程序 的 时 候 ， 声 明 选 项 -1pq ， 这 样 就 可 以 把 libpq 库 链接 进来 ， 还 要 声明 
-L``_directory_ 以 告诉 编译 器 libpq 所 处 的 目录 。( 同 样 ， 编 译 器 也 会 搜索 一 些 缺 省 的 目 
录 。) 为 了 尽 可 能 提高 可 移植 性 ， 你 应 该 把 -L 选项 放 在 -1pq 选项 前 面 。 比 如 : 


cc -o testprog testprogi.o testprog2.0 -L/usr/local/pgsql/lib -lpq 


你 也 可 以 用 pg_config 找 出 库 目 录 : 


&1lt;samp class="literal"&gt;$&lt;/samp&gt; pg_config --libdir 
&lt;samp class="literal"&gt;/usr/local/pgsql/lib&lt;/samp&gt; 


或 再 次 使 用 pkg-config 


&lt;samp class="literal"&gt;$&lt;/samp&gt; pkg-config --libs libpq 
&lt;samp class="literal"&gt;-L/usr/local/pgsql/lib -lpq&lt;/samp&gt ; 


请 注意 ， 这 会 输出 全 部 选项 ， 而 不 只 是 路 径 。 
指向 这 类 问题 的 错误 信息 会 是 类 似 下 面 这 个 样子 。 


testlibpq.o: In function main ' : 

testlibpq.o(.text+0x60): undefined reference to ~PQsetdbLogin' 
testlibpq.o(.text+0x71): undefined reference to ~PQstatus' 
testlibpq.o(.text+0xa4): undefined reference to ~PQerrorMessage' 


这 意味 着 你 忘记 了 -1pq o 


/usr/bin/ld: cannot find -lpq 


这 意味 着 你 忘记 -L 了 或 没有 指定 正确 的 目录 。 


31.21. 例子 程序 


这 些 例子 和 其 他 的 可 以 在 字典 src/test/examples 的 源 代码 分 布 中 找到 。 


Example 31-1. libpq 例子 程序 1 


ffx 
* testlibpq.c 
sy 
#include <stdio.h> 
#include <stdlib.h> 
#include <libpq-fe.h> 


<!-- Test the C version of libpg, the PostgreSQL frontend library. --> 测 试 libpq 的 C 


static void 
exit_nicely(PGconn *conn) 


PQfinish(conn) ; 


exit(1); 
} 
int 
main(int argc, char **argv) 
{ 
const char *conninfo; 
PGconn *conn; 
PGresult *res; 
int nFields; 
int i, 
j; 
Te 
二 | 医学 


* If the user supplies a parameter on the command line, use it as the 
* conninfo string; otherwise default to setting dbname=postgres and using 
* environment variables or defaults for all other connection parameters. 
--> 
* 如 果 用 户 在 命令 行 上 提供 了 一 个 参数 ， 则 拿 它 当 作 conninfo 字 串 使 用 ; 
* 否则 缺 省 为 dbname=postgres 并 且 使 用 环境 变量 或 者 所 有 其 它 连接 参数 
* 都 使 用 缺 省 值 。 
a7, 
if (argc > 1) 
conninfo = argv[1]; 
else 
conninfo = "dbname = postgres"; 


/* <!-- Make a connection to the database - -> 连接 数据 库 */ 
conn = PQconnectdb(conninfo); 


/* <!-- Check to see that the backend connection was successfully made --> 检 查 后 端 连接 月 
if (PQstatus(conn) != CONNECTION_OK) 


fprintf(stderr, "Connection to database failed: %s", 
PQerrorMessage(conn) ); 
exit_nicely(conn); 


} 


UE 
<!-- 
* Our test case here involves using a cursor, for which we must be inside 
* a transaction block. We could do the whole thing with a single 
* PQexec() of "Select * from pg_database", but that's too trivial to make 
* a good example. 
==> 


* 我 们 的 测试 实例 涉及 游标 的 使 用 ， 这 个 时 候 我 们 必须 使 用 事务 块 。 
* 我 们 可 以 把 全 部 事情 放 在 一 个 "select * from pg_database" 
* PQexec() 里 ， 不 过 那样 太 简单 了 ， 不 是 个 好 例子 。 
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/* <!-- Start a transaction block --> 开 始 一 个 事务 块 */ 
res = PQexec(conn, "BEGIN"); 
if (PQresultStatus(res) != PGRES_COMMAND_OK) 


{ 
fprintf(stderr, "BEGIN command failed: %s", PQerrorMessage(conn) ); 
PQclear(res); 
exit_nicely(conn); 
} 
Vis 
<a 
* Should PQclear PGresult whenever it is no longer needed to avoid memory 
* leaks 
=> 
* 应 该 在 结果 不 需要 的 时 候 PQclear PGresult， 以 避免 内 存 泄漏 
EA 
PQclear (res); 
ips 
<!-- Fetch rows from pg_database, the system catalog of databases --> 


* MARAR pg_database (数据 库 的 系统 目录 ) 里 抓 取 数据 
yh 


res = PQexec(conn, "DECLARE myportal CURSOR FOR select * from pg_database"); 
if (PQresultStatus(res) != PGRES_COMMAND_OK) 
{ 
fprintf(stderr, "DECLARE CURSOR failed: %s", PQerrorMessage(conn)); 
PQclear(res); 
exit_nicely(conn); 


PQclear(res); 


res = PQexec(conn, "FETCH ALL in myportal"); 
if (PQresultStatus(res) != PGRES_TUPLES_OK) 


{ 
fprintf(stderr, "FETCH ALL failed: %s", PQerrorMessage(conn)); 
PQclear(res); 
exit_nicely(conn); 

} 


/* <!-- first, print out the attribute names --> 首 先 ， 打 印 属性 名 称 */ 
nFields = PQnfields(res); 
for (i = 0; i < nFields; I++) 
printf("%-15s", PQfname(res, i)); 
printf("\n\n"); 


/* <!-- next, print out the rows --> 然 后 打印 行 */ 
for (i = 0; i < PQntuples(res); i++) 


{ 
for (j = 0; j < nFields; j++) 
printf("%-15s", PQgetvalue(res, i, j)); 
printf("\n"); 
} 


PQclear(res); 


/* <!-- close the portal ... we don't bother to check for errors ... --> 关 闭 入 口 
res = PQexec(conn, "CLOSE myportal"); 
PQclear(res); 


/* <!-- end the transaction --> 结 束 事务 */ 
res = PQexec(conn, "END"); 
PQclear(res); 


/* <!-- close the connection to the database and cleanup - -> 关闭 数据 库 连接 并 清理 */ 
PQfinish(conn); 


return 0; 


} 
“| = 
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testlibpq2.c 
<!-- Test of the asynchronous notification interface --> 测 试 异步 通知 接口 


<!-- Start this program, then from psql in another window do --> 运 行 此 程序 ， 然 后 从 另外 一 个 ' 
NOTIFY TBL2; 
<!-- Repeat four times to get this program to exit. --> 重 复 四 次 ， 直 到 程序 退出 


se Pe Se Pee ee, Ae ee 


ee 
Or, if you want to get fancy, try this: 
* populate a database with the following commands 
(provided in src/test/examples/testlibpq2.sql): 
=> 
或 者 ， 如 果 你 想 好 玩 一 点 ， 用 下 面 命令 填充 数据 库 : 
(在 src/test/examples/testlibpq2.sql 里 提供 ) 


* A 


* 


CREATE TABLE TBL1 (i int4); 
CREATE TABLE TBL2 (i int4); 


CREATE RULE ri AS ON INSERT TO TBL1 DO 
(INSERT INTO TBL2 VALUES (new.i); NOTIFY TBL2); 


<!-- and do this four times: --> 然 后 做 四 次 : 


INSERT INTO TBL1 VALUES (10); 


* FF FF FF F F F KF F EHI 


/ 

#include <stdio.h> 
#include <stdlib.h> 
#include <string.h> 
#include <errno.h> 
#include <sys/time.h> 
#include <libpq-fe.h> 


static void 
exit_nicely(PGconn *conn) 


PQfinish(conn); 
exit(1); 
} 


int 
main(int argc, char **argv) 
{ 
const char *conninfo; 
PGconn *conn; 
PGresult *res; 
PGnotify *notify; 
int nnotifies; 


JES 
<e 
* If the user supplies a parameter on the command line, use it as the 
* conninfo string; otherwise default to setting dbname=postgres and using 
* environment variables or defaults for all other connection parameters. 
==> 
* 如 果 用 户 在 命令 行 上 提供 了 参数 ， 
* 那么 拿 它 当 作 conninfo 字 串 ; 否则 缺 省 设置 是 dbname=postgres 
* 并 且 对 其 它 连 接 使 用 环境 变量 或 者 缺 省 值 。 
of 
if (argc > 1) 
conninfo = argv[i]; 
else 
conninfo = "dbname = postgres"; 


/* <!-- Make a connection to the database --> 和 数据 库 建立 连接 */ 
conn = PQconnectdb(conninfo); 


/* <!-- Check to see that the backend connection was successfully made -->#4&— FSik4 


if (PQstatus(conn) != CONNECTION_OK) 


fprintf(stderr, "Connection to database failed: %s", 
PQerrorMessage(conn) ); 
exit_nicely(conn); 


} 


ips 

<!l-- 
* Issue LISTEN command to enable notifications from the rule's NOTIFY. 
Sas 
* 发 出 LISTEN 命令 打开 来 自 规则 NOTIFY 的 通知 

of 
res = PQexec(conn, "LISTEN TBL2"); 
if (PQresultStatus(res) != PGRES_COMMAND_OK) 


fprintf(stderr, "LISTEN command failed: %s", PQerrorMessage(conn) ); 
PQclear(res); 
exit_nicely(conn); 


} 
Vee 
<!-- 
* should PQclear PGresult whenever it is no longer needed to avoid memory 
* leaks 
--> 
* 如 果 不 再 需要 了 ， 我 们 应 该 PQclear PGresult ， 以 避免 内 存 泄 漏 
A 


PQclear(res); 


/* <!-- Quit after four notifies are received. --> 收 到 四 次 通知 之 后 退出 。 */ 
nnotifies = 0; 
while (nnotifies < 4) 
{ 
ae 
gien 
* Sleep until something happens on the connection. We use select(2) 
* to wait for input, but you could also use poll() or similar 
* facilities. 
m> 
* 睡眠 ， 直 到 某 些 事件 发 生 。 我 们 使 用 select(2) 等 待 输入 ， 
* 但 是 也 可 以 用 poll() 或 者 类 似 的 设施 。 


uy 
int sock; 
fd_set input_mask; 


sock = PQsocket(conn); 


if (sock < 0) 
break; /* <!-- shouldn't happen --> 不 应 该 发 生 */ 


FD_ZERO(&input_mask); 
FD_SET(sock, &input_mask); 


if (select(sock + 1, &input_mask, NULL, NULL, NULL) < 0) 


fprintf(stderr, "select() failed: %s\n", strerror(errno)); 
exit_nicely(conn); 


} 


/* <!-- Now check for input --> 现 在 检查 输入 */ 
PQconsumeInput(conn ) ; 
while ((notify = PQnotifies(conn)) != NULL) 


fprintf(stderr, 
"ASYNC NOTIFY of '%s' received from backend PID %d\n", 
notify->relname, notify->be_pid); 


PQFreemem(notify); 
nnotifies++; 


} 
fprintf(stderr, "Done.\n"); 


/* <!-- close the connection to the database and cleanup --> 关 闭 数据 连接 并 清理 */ 
PQfinish(conn); 


return 0; 


} 


«| = 
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a 
testlibpq3.c 
<!-- Test out-of-line parameters and binary I/0. --> 测 试 外 联 参数 和 二 进 制 I/0。 


<i 
* Before running this, populate a database with the following commands 
* (provided in src/test/examples/testlibpq3.sql): 
T> 


* 在 运行 这 个 例子 之 前 ， 用 下 面 的 命令 填充 一 个 数据 库 


* (在 src/test/examples/testlibpg3.sql 里 提供 ) 

* CREATE TABLE testi (i int4, t text, b bytea); 

* INSERT INTO testi values (1, 'joe''s place', '\\O000\\001\\002\\003\\004'); 
* INSERT INTO testi values (2, 'ho there', '\\004\\003\\002\\001\\000'); 
* <!-- The expected output is: --> 期 望 的 输出 是 : 

* tuple 0: got 

* i= (4 bytes) 1 

* t = (11 bytes) 'joe's place' 

* b= (5 bytes) \000\001\002\003\004 

* tuple 0: got 

* i= (4 bytes) 2 

* t= (8 bytes) 'ho there' 

* b= (5 bytes) \004\003\002\001\000 

0 


#include <stdio.h> 
#include <stdlib.h> 
#include <string.h> 
#include <sys/types.h> 
#include <libpq-fe.h> 


/* for ntohl/htonl */ 
#include <netinet/in.h> 
#include <arpa/inet.h> 


static void 
exit_nicely(PGconn *conn) 


PQfinish(conn); 
exit(1); 
} 


ye 
<l-- 
* This function prints a query result that is a binary-format fetch from 
* a table defined as in the comment above. We split it out because the 
* main() function uses it twice. 
--> 
* 这 个 图 数 打印 查询 结果 ， 这 些 结 果 是 二 进 制 格 式 ， 从 上 面 的 
* 注释 里 面 创建 的 表 中 抓 取出 来 的 。 我 们 把 这 个 画 数 单独 拆 出 来 


* 是 因为 main() BRAS EAR, 

Uf 
static void 
show_binary_results(PGresult *res) 


i | 
int aly 
j; 
int i_fnum, 
t_fnum, 
b_fnum; 
/* <!-- Use PQfnumber to avoid assumptions about field order in result --> 使 用 PQfnumk 
i_fnum = PQfnumber (res, "i"); 
t_fnum = PQfnumber (res, "t"); 
b_fnum = PQfnumber(res, "b"); 


for (i = 0; i < PQntuples(res); i++) 


{ 
char *iptr; 
char *tptr; 
char *bptr; 
int blen; 
int ival; 


/* <!-- Get the field values (we ignore possibility they are null!) --># MFR ( 


iptr = PQgetvalue(res, i, i_fnum); 
tptr = PQgetvalue(res, i, t_fnum); 
bptr = PQgetvalue(res, i, b_fnum); 
xe 

<!-- 


* The binary representation of INT4 is in network byte order, which 
* we'd better coerce to the local byte order. 

=> 

* INT4 的 二 进 制 表现 形式 是 网 络 字 节 序 ， 
* 我 们 最 好 转换 成 本 地 字 节 序 。 
SA 


ival = ntohl(*((uint32_t *) iptr)); 


Jx 
gien 
* The binary representation of TEXT is, well, text, and since libpq 
* was nice enough to append a zero byte to it, it'll work just fine 
as a C string. 


* The binary representation of BYTEA is a bunch of bytes, which could 
* include embedded nulls so we have to pay attention to field length. 
==> 
* TEXT 的 二 进 制 表 现形 式 是 ， 吧 ， 文 本 ， 因 此 1ibpq 足够 给 它 附加 一 个 字 节 盐 ， 

* 因此 把 它 看 做 C 字 串 就 挺 好 。 


* BYTEA 的 二 进 制 表 现形 式 是 一 堆 字 节 ， 里 面 可 能 包含 谋 入 的 空 值 ， 
* 因此 我 们 必须 注意 字段 长 度 。 

*/ 

blen = PQgetlength(res, i, b_fnum); 


printf("tuple %d: got\n", i); 

printf(" i = (%d bytes) %d\n", 
PQgetlength(res, i, i_fnum), ival); 

printf(" t = (%d bytes) '%s'\n", 
PQgetlength(res, i, t_fnum), tptr); 

printf(" b = (%d bytes) ", blen); 

for (j = 0; j < blen; j++) 

printf("\\%030", bptr[j]); 
printf("\n\n"); 


} 


int 
main(int argc, char **argv) 
{ 


const char *conninfo; 


neal 


PGconn *conn; 

PGresult *res; 

const char *paramValues[1]; 
int paramLengths[1]; 
int paramFormats[1]; 
uint32_t binaryIntVal; 


Ve 

<= 
f the user supplies a parameter on the command line, use it as the 

* conninfo string; otherwise default to setting dbname=postgres and using 
* environment variables or defaults for all other connection parameters. 


ma 


*q 


0 果 用 户 在 命令 行 上 提供 了 参数 ， 
* 那么 拿 它 当 作 conninfo FÈ ; 否则 缺 省 设置 是 dbname=postgres 
* 并 且 对 其 它 连 接 参 数 使 用 环境 变量 或 者 缺 省 值 。 
BA 
if (argc > 1) 
conninfo = argv[1]; 
else 
conninfo = "dbname = postgres"; 


/* <!-- Make a connection to the database - -> 和 数据 库 建 立 连接 */ 
conn = PQconnectdb(conninfo); 


/* <!-- Check to see that the backend connection was successfully made --> 检 查 一 下 与 服 和 
if (PQstatus(conn) != CONNECTION_OK) 


fprintf(stderr, "Connection to database failed: %s", 
PQerrorMessage(conn) ); 
exit_nicely(conn); 


} 


Vee 
ee 


* The point of this program is to illustrate use of PQexecParams() with 


ses 


* 


out-of-line parameters, as well as binary transmission of data. 


This first example transmits the parameters as text, but receives the 
results in binary format. By using out-of-line parameters we can 
avoid a lot of tedious mucking about with quoting and escaping, even 
though the data is text. Notice how we don't have to do anything 
special with the quote mark in the parameter value. 


OES ES SS eH E 


* 这 个 程序 是 用 来 演示 使 用 外 联 参数 的 PQexecParams(), 


* 以 及 数据 的 二 进 制 传输 。 第 一 个 例子 使 用 文本 传输 参数 ， 

* 但 是 用 二 进 制 格式 接收 结果 。 通 过 使 用 外 联 参 数 ， 我 们 可 以 避免 大 量 

* 枯燥 的 字 串 的 引用 和 逃逸 ， 即 使 数据 是 文本 。 请 注意 我 们 这 里 不 需要 对 参数 值 里 的 引号 
* 做 任何 特殊 的 处 理 。 


Eh 
/* <!-- Here is our out-of-line parameter value --> 这 里 是 我 们 的 外 联 参 数值 */ 
paramValues[0] = "joe's place"; 


res = PQexecParams(conn, 
"SELECT * FROM testi WHERE t = $1", 


at, /* <!-- one param --> 一 个 参数 */ 

NULL, /* <!-- let the backend deduce param type - -> 让 后 端 推出 参数 
paramValues, 

NULL, /* <!-- don't need param lengths since text - -> 因为 是 文本 ， 
NULL, /* <!-- default to all text params - -> 缺 省 是 全 部 文本 参数 */ 
17 /* <!-- ask for binary results - -> 要 求 二 进 制 结果 */ 


if (PQresultStatus(res) != PGRES_TUPLES_OK) 


fprintf(stderr, "SELECT failed: %s", PQerrorMessage(conn) ); 
PQclear(res); 
exit_nicely(conn); 


} 


show_binary_results(res); 


PQclear(res); 


Hes 
allies 
* In this second example we transmit an integer parameter in binary 
* form, and again retrieve the results in binary form. 
* Although we tell PQexecParams we are letting the backend deduce 
* parameter type, we really force the decision by casting the parameter 
* symbol in the query text. This is a good safety measure when sending 
* binary parameters. 
==> 
* 在 这 个 第 二 个 例子 里 ， 我 们 以 二 进 制 格式 传输 一 个 整数 参数 ， 
* 然后 还 是 以 二 进 制 格式 检索 结果 。 
* 尽管 我 们 告诉 PQexecParams， 我 们 让 后 端 推导 参数 类 型 ， 
* 实际 上 我 们 通过 在 查询 字 串 里 转换 参数 符号 的 方法 强制 了 决定 的 做 出 。 
* 在 发 送 二 进 制 参数 的 时 候 ， 这 是 一 个 很 好 的 安全 检查 。 
7 


/* <!-- Convert integer value "2" to network byte order --> 把 整数 值 "2" 转换 成 网 络 字 节 序 
binaryIntVal = htonl((uint32_t) 2); 


/* <!-- Set up parameter arrays for PQexecParams -->% PQexecParams 设置 参数 数组 */ 
paramValues[0] = (char *) &binaryIntVal; 
paramLengths[0] = sizeof(binaryIntVal); 
paramFormats[0] = 1; /* <!-- binary --> 二 进 制 */ 
res = PQexecParams(conn, 
"SELECT * FROM testi WHERE i = $1::int4", 


i /* <!-- one param --> 一 个 参数 */ 

NULL, /* <!-- let the backend deduce param type - -> 让 后 端 推导 参数 
paramValues, 

paramLengths, 

paramFormats, 

1); /* <!-- ask for binary results - -> 要 求 二 进 制 结果 */ 


if (PQresultStatus(res) != PGRES_TUPLES_OK) 
fprintf(stderr, "SELECT failed: %s", PQerrorMessage(conn) ); 
PQclear(res); 
exit_nicely(conn); 


} 


show_binary_results(res); 
PQclear(res); 


/* <!-- close the connection to the database and cleanup - -> 关闭 与 数据 库 的 连接 并 清理 */ 
PQfinish(conn); 


return 0; 


} 
ee 
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PostgreSQL 有 一 个 /arge object( 大 对 象 ) 设 施 ， 它 为 存储 在 特殊 的 大 对 象 结构 里 的 用 户 数 据 提 
供 流 状 的 访问 方式 。 流 访问 对 那些 数据 值 太 大 ， 不 能 一 次 性 操作 的 数据 是 很 有 用 的 。 


本 章 描述 PostgreSQL 大 对 象 数据 的 实现 以 及 编程 和 查询 语言 接口 。 我 们 在 本 章 中 使 用 libpq 
的 C 库 作为 例子 ， 但 是 大 多 数 PostgreSQL 内 置 的 接口 都 支持 等 效 的 功能 。 其 它 接口 可 以 在 内 
部 使 用 大 对 象 接口 以 提供 对 大 对 象 值 的 一 般 性 支持 。 那些 内 容 没有 在 这 里 描述 。 


32.1. 介绍 


所 有 的 大 对 象 存储 在 单独 系统 表 pg_largeobject 中 。 每 个 大 对 象 在 系统 
X pg_largeobject_metadata 中 也 有 记录 。 可 以 使 用 类 似 于 文件 标准 操作 的 读 / 守 API 创 建 ， 修 
改 ， 删 除 大 对 象 。 


PostgreSQL 也 支持 "TOAST" 存 储 机 制 ， 自动 存储 大 于 单独 数据 页 的 值 到 每 个 表 的 二 级 存储 
Ko 这 样 就 全 大 对 象 接口 在 一 定 程度 上 过 时 了 。 大 对 象 接口 剩余 的 一 个 优点 是 它 人 允许 数据 最 
大 有 4T， 而 TOAST 字 上 段 只 能 处 理 1G。 并 且 ， 大 对 象 读 取 和 更 新 部 分 可 以 有 效 进行 ， 而 
TOAST 字 段 的 大 部 分 操作 将 作为 一 个 单元 读 取 或 者 写 整个 值 。 


32.2. 实现 特点 


大 对 象 实 现 把 大 对 象 分 解 成 "chunks"， 然 后 把 块 存放 在 数据 库 记 录 里 面 。 在 随机 读 宇 时 使 用 
一 个 B-tree 索 引 保 证 对 正确 的 块 (chunk) 号 的 检索 。 


一 个 大 对 象 的 块 存储 不 必 相 邻 。 例如 ， 如 果 应 用 程序 打开 一 个 新 的 大 对 象 ， 寻 找 抵 消 
1000000， 并 且 写 入 几 个 字 节 ， 这 不 会 导致 配置 1000000 个 字 节 的 存储 ; 只 有 块 履 盖 真 实 写 
数据 字 节 的 范围 。 一 个 读 操 作 将 ， 然 而 ， 读 出 先 于 最 后 出 现 块 的 任何 未 分 配 的 位 置 为 需 。 这 
相当 于 在 Unix 文 件 系统 文件 中 "不 充分 分 配 "文件 的 普通 操作 。 


PostgreSQL 9.0 中 ， 大 对 象 有 一 个 所 有 者 和 一 组 访问 权限 ， 使 用 GRANT 和 REVOKE 管 理 。 
SELECT 的 权限 需要 读 大 对 象 ， UPDATE 的 权限 需要 写 和 或 彻底 删除 。 只 有 大 对 象 的 所 有 者 
(或 数据 库 超级 用 户 ) 可 以 删除 ， 评 论 或 改变 一 个 大 对 象 的 所 有 者 。 为 了 调整 以 前 版 本 的 兼 
容 操 作 ， 参 阅 lo_compat_privileges 运 行 时 参数 。 


32.3. & P imt O 
本 节 描 述 PostgreSQL 的 libpq 客 户 端 接口 库 提 供 来 访问 大 对 象 的 设施 。 PostgreSQL 大 对 象 接 
口 是 对 Unix 文 件 系 统 的 模仿 ， 有 仿真 的 open, read, write, lseek 等 。 


使 用 这 些 画 数 的 所 有 大 对 象 操作 必须 在 一 个 SQL 事 务 块 中 发 生 ， 由 于 大 对 象 的 文件 描述 符 对 
事务 的 整 段 时 间 内 是 唯一 有 效 的 。 


如 果 在 执行 这 些 函 数 的 任何 一 个 发 生 错误 的 时 候 ， 该 男 数 将 返回 一 个 不 可 能 的 值 ， 通 常 为 0 或 
1。 一 个 描述 该 错误 的 消息 存储 在 连接 对 象 中 ， 并 且 可 以 用 PaerrorMessage 检索 。 


客户 端 应 用 程序 使 用 包含 libpq/libpq-fs.h AMAA ABA, KA 可 以 与 libpq 库 连接 。 


32.3.1. 创建 大 对 象 
Exp 


Oid lo_creat(PGconn *conn, int mode); 


创建 一 个 新 的 大 对 象 。 返 回 值 是 赋予 新 大 对 象 的 OID， 或 者 是 失败 的 时 候 
是 Invalidoid (#) 。 在 PostgreSQL 8.1 里 ， 没有 再 使 用 _mode ， 并 且 它 被 忽略 ; 不 过 ， 
为 了 和 早期 的 版 本 向 下 兼容 ， 我 们 最 好 将 其 设置 为 INV_READ ，INV_WRITE , 或 者 INV_READ | 


oh, & 


INV_WRITE > (这 些 符号 常量 在 头 文件 libpq/libpq-fs.h 里 定义 。) 


例如 : 


inv_oid = lo_creat(conn, INV_READ|INV_WRITE); 


EE 


Oid lo_create(PGconn *conn, Oid lobjId); 


也 创建 一 个 新 的 大 对 象 。 要 赋予 数值 的 OID 可 以 用 _lobjid_ 声明 ; 如 果 这 人 么 做 ， 那 么 在 该 
OID 已 经 被 其 他 大 对 象 使 用 的 情况 下 就 会 生成 错误 。 如 果 _lobjId_ 为 Invalidoid ($), 
那么 lo_create 赋予 一 个 未 用 的 OID， 这 个 和 1lo_creat 的 行为 一 致 。) 返回 值 是 赋予 新 的 大 
对 象 的 OID， 或 者 是 失败 情况 下 的 Invalidoid (#) 。 


lo_create 画 数 是 PostgreSQL 8.1 里 面 新 增加 的 ; 如 果 在 老 的 服务 器 上 运行 这 个 画 数 ， 它 会 
失败 并 返回 Invalidoid o 


例子 


inv_oid = lo_create(conn, desired_oid); 


32.3.2. 输入 大 对 象 
要 把 一 个 操作 系统 文件 输入 成 为 大 对 象 ， 调 用 


Oid lo_import(PGconn *conn, const char *filename); 


_filename, 参数 指明 要 被 输入 成 为 大 对 象 的 操作 系统 文件 路 径 名 。 返回 值 是 赋予 新 大 对 象 的 
OID, 如 果 失 败 则 返回 Invalidoid (F) 。 请 注意 这 个 文件 是 由 客户 端 接口 库 读 取 的 ， 而 不 
是 服务 器 端 ; 因此 它 必须 存在 于 客 户 端 文件 系统 上 并 且 可 以 被 客户 应 用 读 取 。 


EEs 


Oid lo_import_with_oid(PGconn *conn, const char *filename, Oid lobjId); 


也 能 引入 一 个 新 的 大 对 象 。 要 赋予 数值 的 OID 可 以 用 _lobjrd_ 声明 ; 如 果 这 么 做 ， 那 么 在 该 
OID 已 经 被 其 他 大 对 象 使 用 的 情况 下 就 会 生成 错误 。 如 果 _lobjId_ 为 Invalidoid (#) ， 
那么 lo_import_with_oid 赋予 一 个 未 用 的 OID， 这 个 和 lo_import 的 行为 一 致 。) 返回 值 是 
赋予 新 的 大 对 象 的 OID， 或 者 是 失败 情况 下 的 Invalidoid ( 需 ) 。 


lo_import_with_oid 是 PostgreSQL 8.4 里 面 新 增加 的 ， 并 且 内 部 调用 lo_create (8.14718 
BY), 如 果 此 功能 在 8.0 或 之 前 运行 这 个 画 数 ， 它 会 失败 并 返回 Invalidoid o 


32.3.3. 输出 大 对 象 
要 把 一 个 大 对 象 输出 为 操作 系统 文件 ， 调 用 


int lo_export(PGconn *conn, Oid lobjId, const char *filename); 


lobjid 参数 指明 要 输出 的 大 对 象 OID， filename 参数 指明 操作 系统 文件 的 路 径 名 。 请 注意 
这 个 文件 是 由 客户 端 接口 库 写 入 的 ， 而 不 是 服务 器 端 。 成 功 时 返回 1， 失 败 时 返回 -1。 


32.3.4. 打开 一 个 现 有 的 大 对 象 
要 打开 一 个 现存 的 大 对 象 读 写 ， 调 用 


int lo_open(PGconn *conn, Oid lobjId, int mode); 


参数 lobjid 指明 要 打开 的 大 对 象 的 OID (对 象 标识 ) 。 mode 位 控制 该 对 象 是 用 于 只 读 
( INV_READ ) ， RẸ ( INV_WRITE ) CES, (这 些 符号 常量 在 头 文 

44 libpq/libpq-fs.h .里 定义 。) lo open 返回 非 负 大 对 象 标识 用 于 以 后 的 lo_read , 
lo write ， lo_lseek , lo_lseek64 , lo_tell, lo tell64 , lo_truncate , 


lo_truncate64 和 lo_close, 这 个 描述 符 只 是 在 当前 事务 中 有 效 。 失败 的 时 候 ， 返 回 -1。 


服务 器 目前 并 不 区 分 INv_wRITE 和 INV_READ | INV WRITE 模式 : 可 以 从 这 些 任 一 模式 中 读 
取 描 述 符 。 但 与 INv_READ 有 明显 的 不 同 : 对 于 INV_READ ， 你 不 能 写 入 描述 符 ， 并 且 从 其 中 
读 取 的 数据 将 反映 执行 1o_open 的 时 候 事 务 快照 对 应 的 大 对 象 的 数据 ， 而 不 会 考虑 本 次 事务 
后 面 写 入 的 或 者 其 他 事务 写 入 的 数据 。 从 一 个 用 INv_wRITE 打开 的 描述 符 里 面 读 取 的 数据 反 
映 所 有 其 他 已 经 提交 的 事务 和 当前 事务 的 写 操作 写 入 的 大 对 象 的 数据 。 这 个 行为 类 似 普通 
SQL 语句 SELECT 在 事务 模式 中 REPEATABLE READ 对 比 READ COMMITTED 的 行为 。 


例子 : 


inv_fd = lo_open(conn, inv_oid, INV_READ|INV_WRITE); 


32.3.5. 向 大 对 象 中 写 数 据 
函数 
int lo_write(PGconn *conn, int fd, const char *buf, size_t len); 
从 buf 中 (这 个 大 小 必须 是 len) 向 大 对 象 描述 符 fd SA len 字 节 。 fd 参数 必须 是 前 面 


的 一 个 lo open 调用 的 返回 。 返回 实际 写 入 的 字 节 数 (当前 实现 过 程 中 ， 它 总 是 等 于 len, 
除非 有 错误 ) 。 出 错时 ， 返 回 值 是 -1。 


尽管 len 参数 被 声明 为 size_t ， 这 个 男 数 将 拒绝 长 度 值 大 于 INT_MAx o XERA, RAAR 
字 节 传输 块 中 数据 。 


32.3.6. 从 大 对 象 中 读 取 数据 
EJI 


int lo_read(PGconn *conn, int fd, char *buf, size_t len); 


从 大 对 象 描述 符 fd 中 读 取 len 字 节 数据 到 puf 中 (大 小 必须 是 len )。 fd 参数 必须 是 前 面 
的 一 个 lo_open 调用 的 返回 。 返回 实际 读 取 的 字 节 数 。 如 果 大 对 象 的 结尾 达到 第 一 ， 则 小 
于 len 。 出 错时 ， 返 回 值 是 -1。 


E len 参数 被 声明 为 size_t , RCRA KE AF INT_MAx 。 实 践 中 ， 最 好 以 兆 
节 


尽 
字 节 传输 块 中 数据 。 


32.3.7. 大 对 象 中 查找 
要 改变 与 一 个 大 对 象 描述 符 相 关 的 读 写 位 置 ， 调 用 


int lo_lseek(PGconn *conn, int fd, int offset, int whence); 


这 个 过 程 把 当前 fd 代表 的 大 对 象 描 述 符 位 置 指针 移动 到 offset 指明 的 新 的 位 置 。 参 
数 whence 的 合法 的 取 值 是 SEEK_sET (从 对 象 开头 开始 找 ) ， SEEK_cuR 《从 当前 位 置 开始 
H) ， 和 sEEK_END (从 对 象 结尾 开始 找 ) 。 返回 值 是 新 位 置 指针 ， 如 果 出 错 为 -1。 


当 处 理 可 能 超过 2GB 的 大 对 象 时 ， 而 是 使 用 : 


pg_int64 lo_lseek64(PGconn *conn, int fd, pg_int64 offset, int whence); 


3X7] SERA lo_lseek 同样 的 操 作 ， 但 是 它 可 以 接受 offset 大 于 2GB 和 /或 者 传递 大 于 2GB 的 
一 个 结果 。 注 意 如 果 新 的 位 置 指 针 大 于 2GB， 那 么 lo_lseek HAM, 


lo_lseek64 是 PostgreSQL 9.3 中 新 的 。 如 果 这 个 琅 数 运行 在 一 个 旧 的 服务 器 版 本 上 ， 则 将 失 
败 并 且 返 回 -1。 


32.3.8. 获取 一 个 大 对 象 的 当前 索引 位 置 
要 获取 一 个 大 对 象 描述 符 的 当前 读 或 写 位 置 ， 调 用 


int lo_tell(PGconn *conn, int fd); 


如 果 有 错 ; 误 ， 返回 值 是 -1。 
当 义 理 可 能 超过 2GB 的 大 对 象 时 ， 而 是 使 用 
pg_int64 lo_tell64(PGconn *conn, int fd); 
这 个 画 数 有 lo_tell 的 相同 操作 。 但 是 它 传递 大 于 2GB 的 结果 。 注意 如 果 当 前 读 / 写 位 置 大 于 
2GB， 则 lo_tell Kiko 


lo_tell64 PostgreSQL 9.3 中 新 的 。 如 果 这 个 函数 在 一 个 旧 服 务 器 版 本 上 运行 ， 它 将 失败 
并 且 返 回 -1。 


32.3.9. 截断 一 个 大 对 象 
截断 一 个 给 定 长 度 的 大 对 象 ， 调 用 
int lo_truncate(PGcon *conn, int fd, size_t len); 
截断 大 对 象 描述 符 fd BIKE len 的 大 对 象 ， fd 参数 必须 通过 先前 的 lo_open 返回 。 如 


R len 大 于 当前 大 对 象 的 长 度 ， 大 对 象 延 长 到 空 字 节 (\0'")。 一 旦 成 功 ， 10_truncate 返回 
Ā, 错误 时 ， 返回 值 是 -1。 


与 描述 符 fd 相 联系 的 读 / 写 位 置 没 有 被 改变 。 
RE len 参数 被 声明 为 size_t ， 则 lo_truncate 将 拒绝 长 度 值 大 于 INT_MAx o 


当 义 理 可 能 超过 2GB 大 小 的 大 对 象 时 ， 而 是 使 用 


int lo_truncate64(PGcon *conn, int fd, pg_int64 len); 


xP RA lo_truncate 有 同样 操作 ， 但 是 它 可 以 接受 超过 2GB 的 len 值 。 


lo_truncate 是 PostgreSQL 8.3 中 新 的 ; 如 果 这 个 函数 在 一 个 旧 的 服务 器 版 本 上 运行 ， 它 将 
失败 并 且 返 回 -1。 


lo_truncate64 是 PostgreSQL 9.3 中 新 的 ; 如 果 这 个 画 数 在 一 个 旧 的 服务 器 版 本 上 运行 ， 它 
将 失败 并 且 返 回 -1。 


32.3.10. 关闭 一 个 大 对 象 描述 符 
一 个 大 对 象 描述 符 关 闭 可 以 通过 调用 


int lo_close(PGconn *conn, int fd); 


fd 是 通过 lo open 返回 的 大 对 象 描述 符 。 成 功 时 ， lo close ROS, Anat, RA 


是 -1。 


任何 在 事务 结尾 时 仍然 打开 的 大 对 象 描述 符 将 自动 关闭 。 


32.3.11. 删除 一 个 大 对 象 
从 数据 库 中 删除 一 个 大 对 象 ， 调 用 


int lo_unlink(PGconn *conn, Oid lobjId); 


lobjid 参数 声明 要 删除 的 大 对 象 的 OID。 成 功 时 返回 1， 失 败 时 返回 -1。 


32.4. He 4 ae tin BS BX 


RA—-E2xt ARER Pies ARs sole, 可 以 在 SQL 命令 里 使 用 ; 实际 上 ， 大 多 
AE 户 端 画 数 都 只 是 服务 器 端 函 数 的 等 效 接口 。 这 些 服务 器 端 丁 数 中 ， 通过 SQL 命令 调用 的 
实际 有 用 的 是 lo_creat , lo_create , lo_unlink , lo_import 和 lo_export o 下 面 是 一 些 


例子 : 


CREATE TABLE image ( 


name text, 
raster oid 
); 
SELECT lo_creat(-1); -- returns OID of new, empty large object 
SELECT lo_create(43213); -- attempts to create large object with OID 43213 
SELECT lo_unlink(173454); -- deletes large object with OID 173454 


INSERT INTO image (name, raster) 
VALUES ('beautiful image', lo_import('/etc/motd')); 


INSERT INTO image (name, raster) -- same as above, but specify OID to use 
VALUES ('beautiful image', lo_import('/etc/motd', 68583)); 


SELECT lo_export(image.raster, '/tmp/motd') FROM image 
WHERE name = 'beautiful image'; 


服务 器 端的 lo_import 和 lo_export 函数 和 客户 端的 那 几 个 有 着 显著 的 不 同 。 这 两 个 图 数 在 
服务 器 的 文件 系统 里 读 写 文件 ， 使 用 数据 库 所 有 者 的 权限 进行 。 因此 ， 只 有 超级 用 户 才能 
用 他 们 。 相 比 之 下 ， 客 户 端的 输入 和 输出 函数 在 客户 端的 文件 系统 里 读 写 文件 ， 使 用 客户 端 
程序 的 权限 。 客 户 端 画 数 不 需 要 超级 用 户 权限 。 


lo_read 和 lo write 的 功能 通过 服务 器 端 调用 可 用 ， 但 是 服务 器 端 酚 数 名 不 同 于 客户 端 接 
口 ， 因 为 他 们 不 包含 下 划 线 。 你 必须 作为 loread 和 lowrite MARLENA, 


32.5. 例子 程序 


Example 32-1 是 一 个 例子 程序 ， 显 示 如 何 使 用 libpq 里 面 的 大 对 象 接口 。 程序 的 一 部 分 是 注释 
掉 的 ， 但 仍然 保留 在 源码 里 面 供 读 者 参考 。 这 个 程序 可 以 在 源码 发 布 
的 src/test/examples/testlo.c 里 找到 。 


Example 32-1. libpq 的 大 对 象 例子 程序 


testlo.c-- 
test using large objects with libpq 


Copyright (c) 1994, Regents of the University of California 


#include <stdio.h> 
#include "libpq-fe.h" 
#include "libpq/libpq-fs.h" 


#define BUFSIZE 1024 
ie 
* importFile 
a import file "in_filename" into database as large object "lobjOid" 
ah 
Oid 
importFile(PGconn *conn, char *filename) 
{ 
Oid lobjId; 
int lobj_fd; 
char buf [BUFSIZE]; 
int nbytes, 
tmp; 
int fd; 
ifs 
* open the file to be read in 
A 
fd = open(filename, O_RDONLY, 0666); 
if (fd < 0) 


Zero/ 
fprintf(stderr, "cannot open unix file %s\n", filename); 


} 


ph 
* create the large object 
A 
lobjId = lo_creat(conn, INV_READ | INV_WRITE); 
if (lobjId == 0) 
fprintf(stderr, "cannot create large object\n"); 


lobj_fd = lo_open(conn, lobjId, INV_WRITE); 


f= 
y 
while ((nbytes = read(fd, buf, BUFSIZE)) > 0) 


read in from the Unix file and write to the inversion file 


tmp = lo_write(conn, lobj_fd, buf, nbytes); 
if (tmp < nbytes) 


fprintf(stderr, "error while reading large object\n"); 


} 


(void) close(fd); 
(void) lo_close(conn, lobj_fd); 


return lobjId; 
} 


void 
pickout(PGconn *conn, Oid lobjId, int start, int len) 
{ 

int lobj_fd; 

char *buf; 

int nbytes; 

int nread; 


lobj_fd = lo_open(conn, lobjId, INV_READ); 
if (lobj_fd < 0) 


fprintf(stderr, "cannot open large object %d\n", 
lobjId); 
} 


lo_lseek(conn, lobj_fd, start, SEEK_SET); 
buf = malloc(len + 1); 


nread = 0; 
while (len - nread > 0) 
{ 
nbytes = lo_read(conn, lobj_fd, buf, len - nread); 
buf[nbytes] = ' '; 
fprintf(stderr, ">>> %s", buf); 
nread += nbytes; 


} 

free(buf); 

fprintf(stderr, "\n"); 

lo_close(conn, lobj_fd); 
} 


void 
overwrite(PGconn *conn, Oid lobjId, int start, int len) 


{ 


int lobj_fd; 
char *buf; 

int nbytes; 
int nwritten; 
int ake 


lobj_fd = lo_open(conn, lobjId, INV_WRITE); 
if (lobj_fd < 0) 


fprintf(stderr, "cannot open large object %d\n", 
lobjId); 
} 


lo_lseek(conn, lobj_fd, start, SEEK_SET); 
buf = malloc(len + 1); 


for (i = 0; i < len; i++) 
buf[i] = 'X'; 
buf[i] = ' '; 


nwritten = 0; 

while (len - nwritten > 0) 

{ 
nbytes = lo_write(conn, lobj_fd, buf + nwritten, len - nwritten); 
nwritten += nbytes; 


} 

free(buf); 
fprintf(stderr, "\n"); 
lo_close(conn, lobj_fd); 


} 


TR 
* exportFile 
z export large object "lobjOid" to file "out_filename" 
s/s 

void 


exportFile(PGconn *conn, Oid lobjId, char *filename) 


{ 


int lobj_fd; 
char buf [BUFSIZE]; 
int nbytes, 
tmp; 
int fd; 
Ve 
* open the large object 
y 


lobj_fd = lo_open(conn, lobjId, INV_READ); 
if (lobj_fd < 0) 


fprintf(stderr, "cannot open large object %d\n", 


lobjId); 
} 
Yi 
* open the file to be written to 
A 
fd = open(filename, O_ CREAT | O_WRONLY, 0666); 
if (fd < 0) 
/* error */ 
fprintf(stderr, "cannot open unix file %s\n", 
filename); 
} 
Vas 
* read in from the inversion file and write to the Unix file 
A 


while ((nbytes = lo_read(conn, lobj_fd, buf, BUFSIZE)) > 0) 


tmp = write(fd, buf, nbytes); 
if (tmp < nbytes) 


fprintf(stderr, "error while writing %s\n", 
filename) ; 


} 


(void) lo_close(conn, lobj_fd); 
(void) close(fd); 


return; 


} 


void 
exit_nicely(PGconn *conn) 


PQfinish(conn); 


exit(1); 

} 

int 

main(int argc, char **argv) 

{ 
char *in_filename, 

*out_filename; 

char *database; 
Oid lobj0Oid; 
PGconn *conn; 


PGresult *res; 


ae 


fer 


aA 


ips 


if (argc != 4) 


fprintf(stderr, "Usage: %s database_name in_filename out_filename\n", 
argv[®]); 
exit(1); 
} 


database = argv[1]; 
in_filename = argv[2]; 
out_filename = argv[3]; 


iP 
* set up the connection 
a 
conn = PQsetdb(NULL, NULL, NULL, NULL, database); 


/* check to see that the backend connection was successfully made */ 
if (PQstatus(conn) == CONNECTION_BAD) 


fprintf(stderr, "Connection to database '%s' failed.\n", database); 
fprintf(stderr, "%s", PQerrorMessage(conn) ); 
exit_nicely(conn); 


} 


res = PQexec(conn, "begin"); 
PQclear(res); 


printf("importing file %s\n", in_filename); 
lobjOid = importFile(conn, in_filename); */ 
lobjOid lo_import(conn, in_filename) ; 


printf("as large object %d.\n", lobjOid); 


printf("picking out bytes 1000-2000 of the large object\n"); 
pickout(conn, lobjOid, 1000, 1000); 


printf("overwriting bytes 1000-2000 of the large object with X's\n"); 
overwrite(conn, lobjOid, 1000, 1000); 


printf("exporting large object to file %s\n", out_filename) ; 
exportFile(conn, lobjOid, out_filename); */ 
lo_export(conn, lobjOid, out_filename); 


res = PQexec(conn, "end"); 
PQclear(res); 
PQfinish(conn); 

exit(0); 
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这 章 描写 一 种 用 于 PostgreSQL 的 宜 入 SQL 包 。 它 是 由 Linus 

Tolke( &lt; [linus@epact.se](mailto:linus@epact.se)&gt; ) 和 Michael 

Meskes( &lt; [meskes@postgresql.org](mailto:meskes@postgresql.org)&gt; ) 写 的 。 最 初 它 是 为 
了 在 C 里 面 使 用 书写 的 。 它 也 可 以 用 于 C++， 但 是 它 还 不 能 识别 所 有 C++ 构造 。 


这 份 文 档 相 当 不 完整 。 但 是 因为 这 个 接口 是 标准 ， 所 以 我 们 可 以 在 有 关 SQL 的 资源 里 找到 许 
多 额外 的 信息 。 


33.1. 概念 


嵌入 SQL 程 序 主要 由 一 种 普通 的 编程 语言 代码 组 成 ， 在 我 们 这 个 场合 中 是 C， 并 且 在 其 中 与 
一 些 特殊 标记 的 段 混合 。 要 制作 这 样 的 程序 ， 源 代码 ( *.pgc ) 首先 经 过 做 入 的 SQL 预 处 理 器 
处 理 ， 它 把 源 代码 转换 成 普通 的 C 程 序 ( *.c )， 然后 这 个 程序 可 以 用 C 编 译 器 进行 处 理 。 K 
于 编译 和 链接 的 细节 参阅 Section 33.10。 转变 的 ECPG 应 用 在 libpq 库 中 通过 同 入 的 SQL 库 
(ecpglib) #7 FAW. 并 且 使 用 正常 的 前 后 端 协议 与 PostgreSQL 服 务 器 通信 。 


艇 入 的 SQL 相 比 于 其 它 的 从 C 代 码 中 人 处理 SQL 命 命 的 优点 有 几 条 。 首先 ， 它 照看 那些 从 你 的 
C 程序 中 的 变量 中 传 来 传 去 数值 的 事情 。 第 二 ， 在 编译 时 检查 程序 中 SQL 代 码 句 法 正确 性 。 
第 三 ， 在 C 代 码 里 嵌入 SQL 是 定义 在 SQL 标准 里 的 ， 并 且 被 许多 其 它 的 SQL 数据 库 支 持 。 
PostgreSQL 的 实现 被 设计 成 尽 可 能 匹配 这 个 标准 ， 并 且 通 常 可 以 把 为 其 它 SQL 数 据 库 书写 的 
SQL 移 植 到 PostgreSQL 中 来 ， 反 之 亦 然 。 


如 上 所 述 ， 为 刻 入 SQL 接口 写 的 程序 通常 是 带 着 插入 进来 的 特殊 代码 的 C 程 序 ， 这 些 特殊 代 
码 用 于 执行 与 数据 库 相 关 的 动作 。 这 些 特殊 代码 通常 的 形式 是 下 面 这 祥 : 


EXEC SQL ...; 
这 些 语 名 语法 上 占据 C 语 名 的 位 置 。 a AEE AIST, 它们 可 以 出 现在 全 局 环境 中 或 者 


出 现在 一 个 画 数 里 。 嵌入 的 SQL 语句 遵循 普通 SQL 代码 的 大 小 写 敏 感 规则 ， 而 不 是 遵循 C 代 
码 的 。 


下 面 的 小 节 都 是 用 来 解释 所 有 的 佬 入 SQL 语句 的 。 


33.2. 管理 数据 库 连 接 


本 节 描 述 了 如 何 打 开 ， 关 闭 ， 以 及 切换 数据 库 连 接 。 


33.2.1. 与 数据 库 服务 器 连接 
用 下 面 的 语句 与 一 个 数据 库 连接 : 


EXEC SQL CONNECT TO _target_ [AS ~_connection-name_*~] [USER ~_user-name_~]; 





_target_ 可 以 通过 下 面 的 方法 声明 : 
e _dbname_ [@ _hostname_ ][: _port_ | 


e tcp:postgresql://**_hostname_ [: _port_ ][/ _dbname_ ][? _options_ ] 





e unix:postgresql://°*_hostname_ [: _port_ ][/ _dbname_ ][? _options_ ] 





。 一 个 包含 上 面 形式 的 SQL 字 串 文本 
。 一 个 对 包含 上 面 的 形式 之 一 的 字符 串 变 量 的 引用 
e DEFAULT 


如 果 你 用 文本 声明 连接 目标 〈 也 就 是 说 ， 不 是 通过 一 个 变量 引用 ) ， 而 且 你 也 不 引用 这 个 数 
值 ， 那 么 使 用 普通 SQL 的 大 小 写 无 关 的 规则 。 这 种 情况 下 ， 你 也 可 以 根据 需要 独立 地 对 参数 
使 用 双 引 号 包围 。 实际 上 ， 可 能 用 一 个 〈 单 引号 包围 ) 的 字 串 文本 或 者 变量 引用 作为 连接 目 
标 可 能 更 结实 一 些 。 连接 目标 DEFAULT 发 起 一 个 用 缺 省 用 户 名 对 人 缺 省 数据 库 地 连接 。 这 个 时 
候 不 应 该 声明 用 户 名 或 连接 名 。 


声明 用 户 名 的 方法 也 有 几 种 不 同方 式 : 
© _username_ 
e _username_ / _password_ 
e _username_ IDENTIFIED BY _password_ 


e username. USING _password_ 


正如 上 面 的 一 样 ， 参 数 用 户 名 和 密码 可 以 是 一 个 SQL 标识 ， 一 个 字符 变量 ， 或 者 一 个 字符 
$o 


_ 连 接 名 ”用 于 义理 一 个 程序 里 的 多 个 连接 。 如 果 一 个 程序 只 使 用 一 个 连接 ， 则 可 以 省 略 它 。 
最 近 打 开 的 连接 成 为 当前 连接 ， 在 准备 执行 SQL 语句 的 时 候 ， 缺 省 时 会 使 用 这 个 连接 (参阅 
本 章 稍 后 部 分 ) 。 


这 里 是 一 些 connect 语句 的 例子 : 


EXEC SQL CONNECT TO mydb@sql.mydomain.com; 
EXEC SQL CONNECT TO unix:postgresql://sql.mydomain.com/mydb AS myconnection USER john; 


EXEC SQL BEGIN DECLARE SECTION; 


const char *target = "mydb@sql.mydomain.com"; 
const char *user = "john"; 
const char *passwd = "Secret"; 


EXEC SQL END DECLARE SECTION; 


EXEC SQL CONNECT TO :target USER :user USING :passwd; 
/* or EXEC SQL CONNECT TO : target USER :user/:passwd; */ 


最 后 的 一 个 形式 使 用 了 上 面 说 过 的 变量 引用 的 方法 。 在 后 面 的 小 节 里 你 会 看 到 在 SQL 语句 里 
如 何 使 用 前 级 了 冒号 的 C 变 量 。 


请 注意 连接 目标 的 格式 没有 在 SQL 标准 里 说 明 。 所 以 ， 如 果 你 想 开发 可 以 移植 的 应 用 ， 你 可 
能 会 想 使 用 类 似 上 面 的 最 后 一 个 例子 这 桩 的 方法 来 把 连接 目标 字 串 封装 在 某 处 。 


33.2.2. 选择 一 个 连接 


在 当前 连接 中 缺 省 执行 嵌入 SQL 程序 的 SQL 语句 ， 也 就 是 说 ， 最 近 打 开 的 。 如 果 应 用 需要 管 
理 多 个 连接 ， 那 么 有 两 种 处 理 方法 。 


第 一 个 选项 是 为 每 个 SQL 语句 明确 选择 一 个 连接 ， 比 如 : 


EXEC SQL AT _connection-name_ SELECT ...; 


如 果 在 混合 顺序 中 应 用 程序 需要 使 用 若干 个 连接 时 ， 这 个 选项 特别 适合 。 


如 果 你 的 应 用 程序 使 用 多 个 执行 线程 ， 他 们 不 能 同时 共享 连接 。 你 要 么 明确 控制 访问 连接 
(使 用 互 斥 锁 ) 或 者 为 每 个 线程 使 用 一 个 连接 。 如 果 每 个 线程 使 用 自己 的 连接 ， 你 将 需要 使 
用 AT 子 句 指定 线程 将 使 用 哪个 连接 。 


第 二 个 选项 是 执行 语句 切换 当前 连接 。 语 句 是 : 
EXEC SQL SET CONNECTION _connection-name_; 


如 果 在 同一 个 连接 上 执行 许多 语句 ， 那 么 这 种 选择 很 方便 。 它 不 是 线程 感知 的 。 
这 里 有 一 个 管理 多 个 数据 库 连 接 的 例子 程序 : 


#include <stdio.h> 

EXEC SQL BEGIN DECLARE SECTION; 
char dbname[1024]; 

EXEC SQL END DECLARE SECTION; 


int 
main() 
EXEC SQL CONNECT TO testdb1 AS coni USER testuser; 
EXEC SQL CONNECT TO testdb2 AS con2 USER testuser; 
EXEC SQL CONNECT TO testdb3 AS con3 USER testuser; 
/* 在 最 后 打开 的 数据 库 "testdb3" 中 执行 该 查询 */ 
EXEC SQL SELECT current_database() INTO :dbname; 
printf("current=%s (should be testdb3)\n", dbname); 
/在 "testdb2" 中 使 用 "AT" 运行 查询 */ 


EXEC SQL AT con2 SELECT current_database() INTO :dbname; 
printf("current=%s (should be testdb2)\n", dbname); 


/* 切 换 当 前 连接 到 "testdb1" */ 
EXEC SQL SET CONNECTION con1; 


EXEC SQL SELECT current_database() INTO :dbname; 
printf("current=%s (should be testdb1)\n", dbname); 


EXEC SQL DISCONNECT ALL; 
return 0; 


这 个 例子 可 能 产生 这 样 的 输出 : 


current=testdb3 (should be testdb3) 
current=testdb2 (should be testdb2) 
current=testdb1 (should be testdb1) 


33.2.3. 关闭 一 个 连接 
使 用 下 面 的 语句 关闭 连接 : 


EXEC SQL DISCONNECT [~_connection_*~]; 


通过 下 面 的 方法 声明 se : 


e kB 
e RE 
e ”当前 
e 所 有 


如 果 没 有 声明 连接 名 ， 那 么 关闭 当前 连接 。 


应 用 保持 明确 关闭 每 次 打开 的 连接 是 一 个 很 好 的 习惯 。 


33.3. 2 {TSQLAAT 


在 嵌入 的 SQL 应 用 中 可 以 运行 任何 SQL 命令 。 下 面 是 一 些 如 何 使 用 它们 的 例子 。 


33.3.1. 执行 SQL 语句 
创建 一 个 表 : 


EXEC SQL CREATE TABLE foo (number integer, ascii char(16)); 
EXEC SQL CREATE UNIQUE INDEX num1 ON foo(number); 
EXEC SQL COMMIT; 


插入 一 行 : 


EXEC SQL INSERT INTO foo (number, ascii) VALUES (9999, 'doodad'); 
EXEC SQL COMMIT; 


EXEC SQL DELETE FROM foo WHERE number = 9999; 
EXEC SQL COMMIT; 


更 新 : 


EXEC SQL UPDATE foo 
SET ascii = 'foobar' 
WHERE number = 9999; 
EXEC SQL COMMIT; 


可 以 通过 exec so. 直接 执行 返回 一 个 结果 行 的 SELECT 语句 。 为 了 义理 多 行 结果 集 ， 应 用 程 
序 必 须 使 用 游标 ; 参阅 Section 33.3.2。 (特殊 情况 下 ， 应 用 程序 可 以 一 次 读 取 多 行 到 数组 宿 
主 变量 中 ; 参阅 Section 33.4.4.3.1。 ) 


单行 select: 


EXEC SQL SELECT foo INTO :FooBar FROM tablei WHERE ascii = 'doodad'; 


同时 ， 可 以 使 用 show 命令 检索 配置 参数 : 


EXEC SQL SHOW search_path INTO :var; 


形 如 :`、something ”这 样 的 记号 是 宿主 变量 ， 也 就 是 说 ， 他 们 指向 C 程 序 中 的 变量 。 
在 Section 33.4 中 有 解释 。 


33.3.2. 使 用 游标 


为 了 检索 出 多 行 的 结果 集 ， 应 用 程序 必须 声明 一 个 游标 并 且 从 游标 中 抓 取 每 一 行 。 使 用 游标 
的 步骤 如 下 : 声明 一 个 游标 ， 打 开 它 ， 从 游标 中 抓 取 一 行 ， 重 复 ， 最 后 关闭 它 。 


使 用 游标 选择 : 


EXEC SQL DECLARE foo_bar CURSOR FOR 
SELECT number, ascii FROM foo 
ORDER BY ascii; 
EXEC SQL OPEN foo_bar; 
EXEC SQL FETCH foo_bar INTO :FooBar, DooDad; 


EXEC SQL CLOSE foo_bar; 
EXEC SQL COMMIT; 
关于 游标 声明 的 更 多 细节 ， 请 参阅 DECLARE， 关 于 rerh 命令 的 细节 请 参阅 FETCH。 


Note: ECPG pEcLARE 命 命 实际 上 不 会 造成 语句 被 发 送 到 PostgreSQL 后 端 。 当 执 
行 open 命令 时 ， 在 后 端 (使 用 后 端的 DEcLARE 命令 ) 打 开 游 标 。 


33.3.3. 管理 事务 


在 缺 省 模式 下 ， 语 名 只 有 在 exec sa coMMIT 发 出 的 时 候 才 提交 ， 嵌入 的 SQL 接口 也 支持 事 
务 的 自动 提交 (类 似 libpq 的 行为 )， 方法 是 通过 给 ecpg (Mecpg) 增加 命令 行 选 项 -t ， 
或 者 是 通过 EXEC SQL SET AUTOCOMMIT TO ON 语句 。 在 自动 提交 模式 里 ， 每 条 命令 都 是 自动 提 
交 的 ， 除非 它们 包围 在 一 个 明确 的 事务 块 里 。 这 个 模式 可 以 

用 EXEC SQL SET AUTOCOMMIT To OFF 明确 地 关闭 。 

有 以 下 事务 管理 命令 可 用 : 

EXEC SQL COMMIT 

是 交 正 在 进行 的 事务 。 

EXEC SQL ROLLBACK 

回 滚 正在 进行 的 事务 。 

EXEC SQL SET AUTOCOMMIT TO ON 

启动 自动 提交 模式 。 

SET AUTOCOMMIT TO OFF 


禁用 自动 提交 模式 。 这 是 缺 省 的 。 


33.3.4. 预 各 语句 


当 编 译 时 间 不 知道 该 值 已 被 传递 给 SQL 语句 ， 或 者 同一 语句 将 使 用 多 次 ， 那么 预备 语句 是 有 
帮助 的 。 


使 用 命令 prepare 准备 语句 。 对 于 不 知道 的 值 ， 使 用 占 位 符 " ? ": 
EXEC SQL PREPARE stmt1 FROM "SELECT oid, datname FROM pg_database WHERE oid = ?"; 
如 果 一 个 语句 返回 单行 ， 应 用 程序 可 以 在 PREPARE 执行 语句 之 后 调用 execute, 使 
用 using 子 句 为 占 位 符 提供 实际 值 : 
EXEC SQL EXECUTE stmt1 INTO :dboid, :dbname USING 1; 
如 果 一 个 语句 返回 多 行 ， 应 用 程序 可 以 使 用 基于 预备 语句 声明 的 游标 。 为 了 结合 输入 参数 ， 
必须 使 用 usine 子 句 打开 游标 : 


EXEC SQL PREPARE stmt1 FROM "SELECT oid,datname FROM pg_database WHERE oid > ?"; 
EXEC SQL DECLARE foo_bar CURSOR FOR stmt1; 

/* 当 结 果 集 达到 最 后 时 ， 打 破 while 循 环 */ 

EXEC SQL WHENEVER NOT FOUND DO BREAK; 

EXEC SQL OPEN foo_bar USING 100; 

while (1) 

{ 


EXEC SQL FETCH NEXT FROM foo_bar INTO :dboid, :dbname; 


} 
EXEC SQL CLOSE foo_bar; 


当 你 不 再 需要 预备 语句 的 时 候 ， 你 应 该 重新 分 配 它 : 


EXEC SQL DEALLOCATE PREPARE _name_, 


为 获得 关于 prepare 的 更 多 详情 ， 请 参阅 PREPARE。 同 时 参阅 Section 33.5 获得 关于 占 位 符 
和 输入 参数 的 更 多 详情 。 


33.4. THEE 


在 Section 33.3 里 你 看 到 了 如 何 从 嵌入 的 SQL 程序 里 执行 SQL 语句 。 那些 语句 有 些 只 使 用 了 
固定 的 数值 ， 并 没有 提供 一 个 插入 用 户 提供 的 数值 到 语句 中 的 方法 ， 也 没有 提供 让 程序 访问 
查询 返回 的 数值 的 方法 。 这 种 类 型 的 语句 在 实际 应 用 中 并 不 是 很 有 用 。 本 节 详 细 解 释 如 何在 
你 的 C 程 序 和 腐 入 的 SQL 语 句 之 间 使 用 一 种 被 称 作 宿 主 变量 的 机 制 传递 数据 。 在 做 入 SQL 程 
PH, 我 们 将 SQL 语句 认为 是 宿主 语言 _C 程 序 编码 的 客人 。 因此 C 程 序 变 量 称 为 宿主 变量 


o 


f£PostgreSQL aim ECPG Ae Zhe as a AREAL, 参见 
Section 33.7 中 的 描述 。 


33.4.1. 概述 


在 C 程 序 和 SQL 语句 之 间 传 递 数 据 在 嵌入 的 SQL 里 是 特别 简单 的 。 我 们 不 用 把 数据 粘贴 到 语 
句 中 ， 这 样 必然 会 有 各 种 复杂 事情 需要 处理 ， 比如 正确 地 给 数值 加 引号 等 等 ， 我 们 只 需要 在 
SQL 语句 里 写 上 C 变 量 的 名 字 ， 前 级 一 个 冒号 即 可 。 上 比如 : 


EXEC SQL INSERT INTO sometable VALUES (:v1, 'foo', :v2); 


这 个 语句 引用 了 两 个 变量 ,一 个 叫 vi ， 另 一 个 叫 v2 ， 并 且 也 使 用 一 个 普通 的 SQL 字 串 文 
本 ， 这 样 表明 你 并 不 局 限于 只 使 用 某 一 种 数据 或 者 其 他 。 


这 种 在 SQL 语句 里 插 和 人 C 变 量 的 方式 在 SQL 语句 里 任何 需要 表达 式 的 地 方 都 可 用 。 


33.4.2. 声明 段 
要 从 程序 向 数据 库 传 递 数据 ， 比 如 ， 坦 询 中 的 参数 ， 或 者 从 数据 库 里 向 程序 传 回 的 数据 ， 想 


包含 这 类 数据 的 C 变 量 必须 在 一 个 特殊 的 标记 段 里 面 声 明 ， 这 样 冤 入 的 SQL 预 处 理 器 就 会 明 
白 要 做 什么 。 


这 个 段 以 下 面 的 代码 开头 : 
EXEC SQL BEGIN DECLARE SECTION; 
以 下 面 的 代码 结束 : 


EXEC SQL END DECLARE SECTION; 


在 这 些 行 之 间 ， 有 普通 的 C 变 量 声明 ， 上 比如 : 


int XA 
char foo[16], bar[16]; 


正如 你 所 看 到 的 ， 你 可 以 随意 指定 一 个 初始 值 给 变量 。 变量 的 范围 是 在 程序 中 通过 其 声明 部 
分 的 位 置 确定 。 你 也 可 以 用 下 面 的 语法 ， 隐 式 地 创建 一 个 声明 段 声 明 变 量 : 


EXEC SQL int i = 4; 


在 程序 里 你 可 以 有 任意 多 个 声明 段 。 


这 些 声明 也 同时 以 普通 C 变 量 的 形式 回 显 到 输出 文件 中 ， 因此 ， 我 们 不 必 再 声明 他 们 。 那些 
不 准备 在 SQL 命令 里 使 用 的 变量 通常 可 以 在 这 些 特殊 的 段 外 面 声 明 。 


结构 或 者 联合 的 定义 也 必须 在 pecar 段 中 列 出 。 否则 ， 预 处 理 器 就 无 法 义理 这 些 类 型 ， 
为 它 不 知道 定义 。 


加 | 


33.4.3. 检索 查询 结果 


现在 你 应 该 能 把 你 的 程序 生成 的 数据 传递 到 SQL 命令 里 面 去 了 。 但 是 你 如 何 检索 一 个 查询 的 
结果 呢 ?为 了 这 个 目的 ， 嵌入 的 SQL 提供 了 常用 命令 SELECT 和 ”FETCH 的 特殊 变 体 。 这 些 命 
邻 有 了 特殊 的 Into FA, 声明 检索 出 来 的 数值 存储 在 哪个 宿主 变量 里 。 SELECT 用 于 返回 单 
行 的 查询 ， 同 时 Ferch 用 于 使 用 游标 返回 多 行 的 查询 。 


下 面 是 一 个 例子 : 


AR 
* 假设 表 是 这 个 : 
* CREATE TABLE testi (a int, b varchar(50)); 
A 


EXEC SQL BEGIN DECLARE SECTION; 
int v1; 

VARCHAR v2; 

EXEC SQL END DECLARE SECTION; 


EXEC SQL SELECT a, b INTO :v1, :v2 FROM test; 


所 以 into 子 句 出 现在 选择 列表 和 FRoM 子 句 之 间 。 选择 列表 和 Into 后 面 的 列表 的 元 素 (也 
叫 目 标 列 表 ) 个 数 必须 相同 。 


下 面 是 使 用 FETcH 命令 的 例子 


EXEC SQL BEGIN DECLARE SECTION; 
int v1; 

VARCHAR v2; 

EXEC SQL END DECLARE SECTION; 


EXEC SQL DECLARE foo CURSOR FOR SELECT a, b FROM test; 


EXEC SQL FETCH NEXT FROM foo INTO :v1, :v2; 


} while Canais 


这 里 的 INTo 子 句 出 现在 所 有 正常 的 子 句 后 面 。 


33.4.4. 类 型 映射 


当 ECPG 应 用 程序 改变 PostgreSQL 服 务 器 和 C 应 用 程序 之 间 的 值 的 时 候 ， 比如 检索 来 自 服务 
器 的 查询 结果 或 者 执行 带 有 输入 参数 的 SQL 语句 ， 在 PostgreSQL 数 据 类 型 和 宿主 语言 变量 类 
型 (具体 地 C 语 言 数据 类 型 ) 之 间 需 要 改变 值 。ECPG 的 一 个 主要 点 之 一 是 在 大 多 数 情况 下 
自动 的 关注 这 个 。 


在 这 方面 ， 有 两 种 数据 类 型 : 一 些 简单 的 PostgreSQL 数 据 类 型 ， 如 integer 和 text , 可 以 
直接 通过 应 用 程序 读 取 和 写 入 。 其 他 PostgreSQL 数 据 类 型 ， 如 timestamp 和 numeric 只 能 
通过 特殊 库 画 数 进行 访问 ; 参阅 Section 33.4.4.2。 


Table 33-1 显 示 了 哪个 PostgreSQL 数据 类 型 对 应 哪个 C 数 据 类 型 。 当 你 希望 发 送 或 接收 一 个 
给 定 PostgreSQL 数 据 类 型 的 值 时 ， 你 应 该 在 声明 部 分 声明 一 个 对 应 C 数 据 类 型 的 C 变 量 。 


Table 33-1. PostgreSQL 数 据 类 型 和 C 变 量 类 型 之 间 的 映射 


PostgreSQL 数 据 类 型 宿主 变量 类 型 
smallint short 
integer int 
bigint long long int 
decimal decimal [a] 
numeric numeric [a] 
real float 
double precision double 
smallserial short 
serial int 
bigserial long long int 
oid unsigned int 


character(~*_n_ ), varchar m ), text 


chari mati; 


VARCHAR[ `` _n_ +1][b] 


name char [NAMEDATALEN] 
timestamp timestamp [a] 
interval interval [a] 

date date [a] 

boolean bool [c] 


Notes: a. 这 种 类 型 可 以 通过 特殊 库 函 数 访问 ; 参阅 Section 
33.4.4.2。 b. 在 ecpglib.h 中 声明 c. 如 果 不 是 本 地 的 ， 
在 ecpglib.h 中 声明 


33.4.4.1. 义理 字符 串 
为 了 义理 SQL 字符 串 数据 类 型 ， 比 如 varchar 和 text, 有 两 种 可 能 方式 声明 宿主 变量 。 
一 种 方式 是 使 用 char[] ， char 数组 是 在 C 中 人 处理 字 符 数 据 最 常见 方式 。 


EXEC SQL BEGIN DECLARE SECTION; 
char str[50]; 
EXEC SQL END DECLARE SECTION; 


请 注意 ， 你 必须 关注 自身 长 度 。 如 果 你 使 用 这 个 宿主 变量 作为 查询 返回 一 个 具有 多 于 49 个 字 
符 的 字符 串 的 目标 变量 ， 那么 发 生 缓冲 区 浴 出 。 


另 一 种 方法 是 使 用 vARcHAR 类 型 ， 这 是 一 个 由 ECPG 提 供 的 特殊 类 型 。 vARCHAR 类 型 的 数组 
定义 被 转换 为 每 个 变量 的 命名 结构 。 声 明 如 : 


VARCHAR var[180]; 


转换 成 : 


struct varchar_var { int len; char arr[180]; } var; 


arr 有 一 个 终止 需 字 节 的 字符 串 。 Alt, ATE vARCHAR 宿主 变量 中 存储 字符 串 ， 宿主 变量 
必须 声明 为 包含 需 字 节 终 结 符 的 长 度 。 len 持 有 存储 在 arr 中 而 没有 终止 雳 字 节 的 字符 串 
长 度 。 当 一 个 宿主 变量 作为 一 个 查询 输入 时 ， 如 果 strlen(arr) 和 len 是 不 同 的 ， 那 么 使 用 
稍 短 的 。 


两 个 或 以 上 vARcHAR 宿主 变量 不 能 在 单行 语句 中 被 声明 。 下 面 的 代码 将 混淆 ecpg 预 处 理 程 
序 : 


VARCHAR v1[128], v2[128]; /* WRONG */ 


两 个 变量 应 该 像 下 面 这 样 在 独立 语句 中 进行 定义 : 


VARCHAR v1[128]; 
VARCHAR v2[128]; 


VARCHAR 可 以 使 用 大 写 或 小 写 ， 但 是 在 不 混淆 的 情况 下 。 


char 和 vARCHAR 宿主 变量 可 以 持 有 其 它 SQL 类 型 的 值 ， 这 将 被 存储 在 它们 的 字符 串 形 式 
中 。 


33.4.4.2. 访问 特定 数据 类 型 


ECPG 含 有 一 些 特定 类 型 帮助 你 与 来 自 PostgreSQL 服 务 器 的 一 些 特 殊 数 据 类 型 进行 轻松 互 

动 。 特别 是 ， 它 已 经 实现 支持 numeric, decimal, date, timestamp 和 interval 类 型 。 这 
些 数据 类 型 不 能 有 效 地 映射 到 原始 主机 变量 类 型 (例如 int , long long int 或 

者 char[] ) ， 因为 他 们 有 一 个 复 末 的 内 部 结构 。 应 用 程序 通过 声明 特殊 类 型 的 主机 变量 处 
理 这 些 类 型 ， 并 且 在 pgtypes 库 中 使 用 画 数 访问 他 们 。 该 pgtypes 库 包含 处 理 这 些 类 型 的 基本 
MEI 详细 描述 参阅 Section 33.6, 这 样 你 就 不 需要 发 送 一 个 查询 到 SQL 服务 器 ， 仅 仅 为 了 
添加 间隔 时 间 戳 例子 。 


以 下 小 节 描 述 了 这 些 特殊 数据 类 型 。 为 了 获得 关于 pgtypes 库 图 数 的 更 多 细节 ， 参阅 Section 
33.6. 


33.4.4.2.1. timestamp, date 


这 是 在 ECPG 宿 主 应 用 程序 中 处理 timestamp 变量 的 模式 。 


首先 ， 程 序 必须 包含 timestamp 类 型 的 头 文件 : 


#include <pgtypes_timestamp.h> 


接 下 来 ， 在 声明 部 分 声明 作为 类 型 timestamp 的 宿主 变量 : 


EXEC SQL BEGIN DECLARE SECTION; 
timestamp ts; 
EXEC SQL END DECLARE SECTION; 


并 且 污 取 值 到 宿主 变量 之 后 ， PApotypcs#RALEHC. ERHVGIFH, 使 
用 PGTYPEStimestamp_to_asc() 图 数 该 timestamp 值 转换 成 文本 (ASCII) 形式 : 


EXEC SQL SELECT now()::timestamp INTO :ts; 


printf("ts = %s\n", PGTYPEStimestamp_to_asc(ts)); 


这 个 例子 将 显示 如 下 一 些 结 


ts = 2010-06-27 18:03:56.949343 


此 外 ， 日 期 类 型 可 以 用 同样 的 方式 人 处理。 程序 必须 包括 pgtypes_date.h, 作为 日 期 类 型 声明 
mid 宿主 变量 并 且 使 用 PGTYPESdate_to_asc() 函数 转换 日 期 值 为 文本 形式 。 KF pgtypes # K 
数 的 更 多 详情 ， 请 参阅 Section 33.6, 


33.4.4.2.2. interval 


interval 类 型 的 处 理 也 与 timestamp 和 date 类 型 类 似 。 然而 ， 为 了 interval 类 型 值 显 式 
分 配 内 存 是 必需 的 。 换 名 话说 ， 该 变量 的 存储 空间 在 堆 内 存 中 被 分 配 ， 而 不 是 在 堆栈 存储 器 
中 。 


下 面 是 一 个 示例 程序 : 


#include <stdio.h> 
#include <stdlib.h> 
#include <pgtypes_interval.h> 


int 

main(void) 

{ 

EXEC SQL BEGIN DECLARE SECTION; 


interval *in; 
EXEC SQL END DECLARE SECTION; 


EXEC SQL CONNECT TO testdb; 

in = PGTYPESinterval_new(); 

EXEC SQL SELECT '1 min'::interval INTO :in; 
printf("interval = %s\n", PGTYPESinterval_to_asc(in)); 
PGTYPESinterval_free(in); 

EXEC SQL COMMIT; 


EXEC SQL DISCONNECT ALL; 
return 0; 


33.4.4.2.3. numeric, decimal 


numeric 和 decimal 类 型 的 处 理 类 似 于 interval 类 型 : 它 需 要 定义 一 个 指针 ， 在 堆 上 分 配 
一 些 内 存 空间 ， 并 且 使 用 pgtypes 库 豆 数 访问 变量 。 关 于 pgtypes 库 函数 的 更 多 细节 ， 参 
阅 Section 33.6。 


对 于 decimal 类 型 没有 提供 专门 的 函数 。 应 用 程序 使 用 pgtypes 库 函数 做 进一步 的 义理 将 其 
转换 成 numeric 变量 。 


这 里 有 一 个 义理 numeric 和 decimal 类 型 变量 的 示例 程序 。 


#include <stdio.h> 
#include <stdlib.h> 
#include <pgtypes_numeric.h> 


EXEC SQL WHENEVER SQLERROR STOP; 


int 
main(void) 


EXEC SQL BEGIN DECLARE SECTION; 
numeric *num; 
numeric *num2; 
decimal *dec; 

EXEC SQL END DECLARE SECTION; 


EXEC SQL CONNECT TO testdb; 


num 
dec 


PGTYPESnumeric_new(); 
PGTYPESdecimal_new(); 


EXEC SQL SELECT 12.345::numeric(4,2), 23.456::decimal(4,2) INTO :num, :dec; 


printf("numeric = %s\n", PGTYPESnumeric_to_asc(num, 0)); 
printf("numeric = %s\n", PGTYPESnumeric_to_asc(num, 1)); 
printf("numeric = %s\n", PGTYPESnumeric_to_asc(num, 2)); 


/* 转 换 十 进 制 到 数值 型 以 显示 十 进 制 值 */ 
num2 = PGTYPESnumeric_new(); 
PGTYPESnumeric_from_decimal(dec, num2); 


printf("decimal = %s\n", PGTYPESnumeric_to_asc(num2, 0)); 
printf("decimal = %s\n", PGTYPESnumeric_to_asc(num2, 1)); 
printf("decimal = %s\n", PGTYPESnumeric_to_asc(num2, 2)); 


PGTYPESnumeric_free(num2); 
PGTYPESdecimal_free(dec); 
PGTYPESnumeric_free(num); 
EXEC SQL COMMIT; 


EXEC SQL DISCONNECT ALL; 
return 0; 


33.4.4.3. 使 用 非 初级 类 型 的 箱 主 变量 
作为 一 个 宿主 变量 你 也 可 以 使 用 数组 ，typedefs， 结 构 和 指针 。 


33.4.4.3.1. Arrays 


有 两 个 作为 宿主 变量 的 数组 用 例 。 最 先 的 一 种 方式 是 在 char[] 或 者 vARcHAR[] 中 存储 一 些 
文本 字符 串 ， 正如 Section 33.4.4.1 解 释 的 。 第 二 个 用 例 是 不 使 用 游标 从 查询 结果 检索 多 行 。 
没有 一 个 数组 处 理 包 括 多 行 的 一 个 查询 结果 ， 它 需 要 使 用 一 个 游标 和 FETcH 命令 。 但 使 用 数 
组 宿主 变量 ， 一 次 可 以 检索 多 行 。 数组 长 度 被 定义 为 能 够 容纳 所 有 行 ， 否 则 可 能 会 发 生 缓 ; 

KAH. 


TATI pg_database 系统 表 并 且 显 示 所 有 OID 和 可 用 数据 库 的 名 字 : 


int 

main(void) 

EXEC SQL BEGIN DECLARE SECTION; 
int dbid[8]; 
char dbname[8][16]; 
int i; 

EXEC SQL END DECLARE SECTION; 


memset(dbname, 0, sizeof(char)* 16 * 8); 
memset(dbid, ©, sizeof(int) * 8); 


EXEC SQL CONNECT TO testdb; 


/* 同 时 检索 多 行 到 数组 中 */ 
EXEC SQL SELECT oid,datname INTO :dbid, :dbname FROM pg_database; 


for (i = 0; i < 8; itt) 
printf("oid=%d, dbname=%s\n", dbid[i], dbname[i]); 


EXEC SQL COMMIT; 
EXEC SQL DISCONNECT ALL; 
return 0; 


这 个 例子 显示 了 如 下 结果 。 (精确 值 取决 于 区 域 环境 ) 


oid=1, dbname=template1 
o0id=11510, dbname=templateo 
oid=11511, dbname=postgres 
0id=313780, dbname=testdb 
oid=0, dbname= 

oid=0, dbname= 

oid=0, dbname= 


33.4.4.3.2. 结构 


一 个 成 员 名 称 匹 配 查询 结果 列 名 称 的 结构 ， 可 用 于 一 次 检索 多 个 列 。 该 结构 可 以 在 单一 的 宿 
主 变 量 中 处 理 多 个 列 的 值 。 


下 面 的 示例 检索 OID， 名 称 ， 和 来 自 pg_database 系统 表 可 用 数据 库 的 大 小 ， 并 且 使 用 
pg_database_size() 加 数 。 在 这 个 例子 中 ， 一 个 结构 变量 dbinfo t 和 名 称 匹 配 SELECT 结 
的 每 一 列 的 成 员 是 用 来 检索 一 个 结果 行 ， 而 没有 把 多 个 宿主 变量 放 在 FETcH 声明 中 。 


EXEC SQL BEGIN DECLARE SECTION; 
typedef struct 


int oid; 

char datname[65]; 

long long int size; 
} dbinfo_t; 


dbinfo_t dbval; 
EXEC SQL END DECLARE SECTION; 


memset(&dbval, 0, sizeof(dbinfo_t)); 


EXEC SQL DECLARE cur1 CURSOR FOR SELECT oid, datname, pg_database_size(oid) AS size F 
EXEC SQL OPEN cur1,; 


/* 当 结果 集 到 达 末 尾 时 ， 打 破 while 循 环 */ 
EXEC SQL WHENEVER NOT FOUND DO BREAK; 


while (1) 
{ 


/* 抓 取 多 列 到 一 个 结构 中 */ 
EXEC SQL FETCH FROM cur1 INTO :dbval; 


/* 打 印 结构 成 员 */ 
printf("oid=%d, datname=%s, size=%lld\n", dbval.oid, dbval.datname, dbval.size); 
} 


EXEC SQL CLOSE curd; 
SSS SS SS S| 
这 个 例子 显示 了 下 面 结 果 。 (精确 值 取 决 于 区 域 环境 ) 





oid=1, datname=template1, size=4324580 
oid=11510, datname=templateO0, size=4243460 
oid=11511, datname=postgres, size=4324580 
0id=313780, datname=testdb, size=8183012 


构 宿主 变量 "合并 "和 结构 一 样 的 许多 列 作为 结构 域 。 附 加 的 列 可 以 被 分 配 给 其 他 宿主 变 
。 例 如 ， 上 述 程序 可 能 也 会 像 这 样 被 重组 ， 使 用 外 部 结构 size 变量 。 


tig SE 


EXEC SQL BEGIN DECLARE SECTION; 
typedef struct 


int oid; 
char datname[65]; 
} dbinfo_t; 
dbinfo_t dbval; 
long long int size; 
EXEC SQL END DECLARE SECTION; 
memset(&dbval, 0, sizeof(dbinfo_t)); 


EXEC SQL DECLARE cur1 CURSOR FOR SELECT oid, datname, pg_database_size(oid) AS size F 
EXEC SQL OPEN cur1,; 


/* 当 结果 集 到 达 末 尾 时 ， 打 破 while 循 环 */ 
EXEC SQL WHENEVER NOT FOUND DO BREAK; 


while (1) 
{ 


/* 抓 取 多 列 到 一 个 结构 中 */ 
EXEC SQL FETCH FROM cur1 INTO :dbval, :size; 


/* 打 印 结构 成 员 */ 
printf("oid=%d, datname=%s, size=%lld\n", dbval.oid, dbval.datname, size); 
} 


EXEC SQL CLOSE cur1; 


È EESO O O OO 





33.4.4.3.3. Typedefs 
使 用 typedef 关键 字 映 射 新 类 型 到 已 有 类 型 。 


EXEC SQL BEGIN DECLARE SECTION; 
typedef char mychartype[40]; 
typedef long serial_t; 

EXEC SQL END DECLARE SECTION; 


注意 ， 你 也 可 以 使 用 : 


EXEC SQL TYPE serial_t IS long; 


这 种 声明 并 不 需要 声明 部 分 。 
33.4.4.3.4. 指针 


你 可 以 声明 最 常见 类 型 的 指针 。 然而 注意 你 不 能 作为 没有 自动 分 配 的 查询 目标 变量 而 使 用 指 
针 。 参 阅 Section 33.7 获 取 更 多 自动 配置 的 信息 。 


EXEC SQL BEGIN DECLARE SECTION; 
int *intp; 
char **charp; 

EXEC SQL END DECLARE SECTION; 


33.4.5. 义理 非 初 级 的 SQL 数据 类 型 


本 节 包含 了 如 何 义理 nonscalar 和 ECPG 应 用 程序 中 用 户 自 定义 的 SQL 级 别 数据 类 型 的 相关 信 
息 。 请 注意 这 不 同 于 非 初 级 类 型 宿主 变量 的 处 理 ， 在 前 面 的 章节 中 有 描述 。 


33.4.5.1. 数组 


在 ECPG 中 不 直接 支持 SQL 级 别 数组 。 不 可 能 简单 的 映射 SQL 数组 到 C 数 组 宿主 变量 。 这 将 产 
生 未 定义 操作 。 然 而 ， 存 在 一 些 解决 方法 。 


如 果 查 询 分 别 访问 数组 元 素 ， 那 么 这 可 以 避免 在 ECPG 中 使 用 数组 。 然后 ， 应 该 使 用 可 以 映 
射 到 元 素 类 型 的 宿主 变量 。 比 如 ， 如 果 列 类 型 是 integer 数组 ， 那 么 使 用 int 类 型 宿主 变 
量 。 如 果 元 素 类 型 是 varchar 或 者 text , 则 可 以 使 用 chari] 或 者 vARcHAR[] 类 型 宿主 变 
量 。 


下 面 是 一 个 例子 。 假 设 下 列表 : 


CREATE TABLE t3 ( 
ii integer[] 


Ne 


testdb=> SELECT * FROM t3; 
ii 


{1,2,3,4,5} 
(1 row) 


下 面 示 例 程序 检索 了 数组 的 第 四 个 元 素 ， 并 且 将 它 存 储 在 int 类 型 的 宿主 变量 中 : 


EXEC SQL BEGIN DECLARE SECTION; 
int ii; 
EXEC SQL END DECLARE SECTION; 


EXEC SQL DECLARE cur1 CURSOR FOR SELECT ii[4] FROM t3; 
EXEC SQL OPEN cur1; 


EXEC SQL WHENEVER NOT FOUND DO BREAK; 
while (1) 


EXEC SQL FETCH FROM curi INTO :ii ; 
printf("ii=%d\n", ii); 


EXEC SQL CLOSE curi, 


该 例子 显示 了 下 面 结 


ii=4 


为 了 映射 多 个 数组 元 素 到 数组 列 的 数组 类 型 宿主 变量 每 个 元 素 的 多 个 元 组 ， 并 且 宿主 变量 数 
组 的 每 个 元 素 必 须 分 别 被 管理 ， 比 如 : 

EXEC SQL BEGIN DECLARE SECTION; 

int ii_a[8]; 

EXEC SQL END DECLARE SECTION; 


EXEC SQL DECLARE curi CURSOR FOR SELECT ii[1], ii[2], ii[3], ii[4] FROM t3; 
EXEC SQL OPEN cur1; 


EXEC SQL WHENEVER NOT FOUND DO BREAK; 
while (1) 
{ 


EXEC SQL FETCH FROM curi INTO :ii a[0], :ii_a[1], :ii a[2], :ii_a[3]; 


请 再 次 注意 


EXEC SQL BEGIN DECLARE SECTION; 
int ii_a[8]; 
EXEC SQL END DECLARE SECTION; 


EXEC SQL DECLARE curi CURSOR FOR SELECT ii FROM t3; 
EXEC SQL OPEN cur1, 


EXEC SQL WHENEVER NOT FOUND DO BREAK; 
while (1) 
{ 


/* WRONG */ 
EXEC SQL FETCH FROM cur1 INTO :ii_a; 


不 会 在 这 种 情况 下 正确 工作 ， 因 为 你 不 能 映射 一 个 数组 类 型 列 直 接 到 数组 宿主 变量 。 


另外 一 种 方法 是 在 char[] 或 者 vARcHAR[] 类 型 宿主 变量 的 外 部 字符 串 形式 中 存储 数组 。 更 
多 关于 该 形式 的 详细 信息 ， 请 参阅 Section 8.15.2。 注意 这 意味 着 在 主 程序 (没有 对 分 析 文 本 
表示 的 进一步 处 理 ) 中 数组 自然 不 能 作为 数组 被 访问 。 


33.4.5.2. 复合 类 型 


在 ECPG 中 不 直接 支持 复合 类 型 ， 但 是 简单 解决 方法 是 可 能 的 。 可 用 的 方法 与 上 面 数组 描述 
的 那个 是 类 似 的 : 要 么 分 别 访问 每 个 属性 ， 要 么 使 用 外 部 字符 串 表 示 形 式 。 
下 面 列 子 中 ， 假 设 下 面 类 型 和 表 : 


CREATE TYPE comp_t AS (intval integer, textval varchar(32)); 
CREATE TABLE t4 (compval comp_t); 
INSERT INTO t4 VALUES ( (256, 'PostgreSQL') ); 


最 明显 的 解决 方法 是 分 别 访问 每 个 属性 。 下 面 程序 通过 分 别 选择 类 型 comp_t 的 每 个 属性 的 示 
例 表 中 检索 数据 : 


EXEC SQL BEGIN DECLARE SECTION; 
int intval; 

varchar textval[33]; 

EXEC SQL END DECLARE SECTION; 


/* 将 复合 类 型 列 的 每 个 元 素 放 在 SELECT 列 表 中 */ 


EXEC SQL DECLARE cur1 CURSOR FOR SELECT (compval).intval, (compval).textval FROM t4; 
EXEC SQL OPEN curi1,; 


EXEC SQL WHENEVER NOT FOUND DO BREAK; 


while (1) 
{ 


/* 抓 取 复合 类 型 列 的 每 个 元 素 给 宿主 变量 */ 
EXEC SQL FETCH FROM cur1 INTO :intval, :textval; 


printf("intval=%d, textval=%s\n", intval, textval.arr); 


} 


EXEC SQL CLOSE cur1; 


为 了 加 强 这 个 例子 ， 在 FETcH 命令 中 存储 值 的 宿主 变量 可 以 聚集 在 一 个 结构 中 。 关于 结构 形 
式 中 宿主 变量 的 更 多 细节 ， 参 阅 Section 33.4.4.3.2。 为 了 切换 到 结构 ， 例 子 可 以 做 如 下 修 
改 。 两 个 宿主 变量 intval 和 textval , 是 comp_t 结构 成 员 ， 并 且 在 FETCH 命令 上 指定 结 
构 。 


EXEC SQL BEGIN DECLARE SECTION; 
typedef struct 


{ 

int intval; 

varchar textval[33]; 
} comp_t; 


comp_t compval; 
EXEC SQL END DECLARE SECTION; 


/* 将 复合 类 型 列 的 每 个 元 素 放 在 SELECT 列表 中 */ 


EXEC SQL DECLARE cur1 CURSOR FOR SELECT (compval).intval, (compval).textval FROM t4; 
EXEC SQL OPEN curi1,; 


EXEC SQL WHENEVER NOT FOUND DO BREAK; 


while (1) 
{ 


/* 将 SELECT 列 表 中 所 有 值 放 到 结构 中 */ 
EXEC SQL FETCH FROM curi INTO :compval; 


printf("intval=%d, textval=%s\n", compval.intval, compval.textval.arr); 


} 


EXEC SQL CLOSE cur1, 


虽然 结构 用 于 FETcH OD, RFS SELECT 子 句 中 的 属性 名 ， 这 可 以 通过 使 用 * 请 求 复合 
类 型 值 的 所 有 属性 获得 提高 。 


EXEC SQL DECLARE cur1 CURSOR FOR SELECT (compval).* FROM t4; 
EXEC SQL OPEN cur1, 


EXEC SQL WHENEVER NOT FOUND DO BREAK; 
while (1) 
/将 SELECT 列表 中 的 所 有 值 放 到 结构 中 */ 
EXEC SQL FETCH FROM curi INTO :compval; 


printf("intval=%d, textval=%s\n", compval.intval, compval.textval.arr); 


这 种 方式 ， 可 以 无 缝 的 将 复合 类 型 映射 到 结构 中 ， 尽 管 ECPG 并 不 了 解 该 复合 类 型 。 


最 后 ， 在 类 型 char[] 或 者 vARcHAR[] 宿主 变量 中 的 外 部 字符 串 表 示 形 式 中 存储 复合 类 型 是 可 
能 的 。 但 是 那 种 方式 ， 不 容易 从 主 程序 中 访问 值 的 字段 。 


33.4.5.3. 用 户 自 定义 基本 类 型 


ECPG 不 直接 支持 新 用 户 自 定义 基础 类 型 。 你 可 以 使 用 外 部 字符 串 表 示 形 式 和 类 型 chari] 或 
者 vARCHAR[] 的 宿主 变量 ， 并 且 该 方法 对 于 许多 类 型 的 确 是 合适 的 并 且 充 分 的 。 


这 是 一 个 使 用 Section 35.11 中 复合 数据 类 型 的 例子 。 该 类 型 的 外 部 字符 串 表 示 形 式 
是 (%1F,%1F) ， 定义 在 Section 35.11 中 的 complex_in() 和 complex_out() WAX. 下 面 例子 
将 复合 类 型 值 (1,1) 和 (3,3) 插入 到 列 a 和 b 中 ， 并且 之 后 从 表 中 选择 它们 。 
EXEC SQL BEGIN DECLARE SECTION; 
varchar a[64]; 
varchar b[64]; 
EXEC SQL END DECLARE SECTION; 
EXEC SQL INSERT INTO test_complex VALUES ('(1,1)', '(3,3)'); 


EXEC SQL DECLARE cur1 CURSOR FOR SELECT a, b FROM test_complex; 
EXEC SQL OPEN cur1; 


EXEC SQL WHENEVER NOT FOUND DO BREAK; 
while (1) 
EXEC SQL FETCH FROM curi INTO :a, :b; 


printf("a=%s, b=%s\n", a.arr, b.arr); 


EXEC SQL CLOSE cur1; 


这 个 例子 显示 了 如 下 结 


a=(1,1), b=(3,3) 


另 一 种 方法 是 避免 ECPG 中 用 户 自 定义 类 型 的 直接 使 用 ， 并 且 创 建 一 个 函数 或 者 计算 在 AP 
自 定义 类 型 和 ECPG 人 处理 的 原始 类 型 之 间 的 转换 。 注意 ， 然 而 那个 类 型 计算 ， 特 别 是 隐 式 的 
那个 ， 应 该 小 心 引 入 类 型 系统 中 。 


比如 ， 


CREATE FUNCTION create_complex(r double, i double) RETURNS complex 
LANGUAGE SQL 

IMMUTABLE 

AS $$ SELECT $1 * complex '(1,0')' + $2 * complex '(0,1)' $$; 


这 个 定义 之 后 ， 下 面 


EXEC SQL BEGIN DECLARE SECTION; 
double a, b, c, d; 
EXEC SQL END DECLARE SECTION; 


了 
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= 时 ?= 
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EXEC SQL INSERT INTO test_complex VALUES (create_complex(:a, :b), create_complex(:c, :d)) 
pi a a a 
具有 相同 效果 正如 





EXEC SQL INSERT INTO test_complex VALUES ('(1,2)', '(3,4)'); 


33.4.6. 指示 器 


上 面 的 例子 不 能 处 理 空 值 。 实 际 上 ， 如 果 从 数据 库 中 抓 到 一 条 空 值 ， 那么 上 面 的 检索 例子 会 
抛 出 一 个 错误 。 要 能 够 向 数据 库 中 传递 空 值 ， 或 者 从 数据 库 中 检索 空 值 ， 你 需要 给 每 个 包含 
数据 的 宿主 变量 后 面 附加 一 个 额外 的 宿主 变量 。 这 第 二 个 宿主 变量 叫 指 示 器 ， 里 面包 含 一 个 
标志 ， 告诉 我 们 数据 是 否 为 空 ， 如 果 为 空 ， 那 么 真正 的 宿主 变量 的 数值 就 可 以 忽略 。 下 面 是 
一 个 能 正确 检索 空 值 的 例子 : 


EXEC SQL BEGIN DECLARE SECTION; 
VARCHAR val; 

int val_ind; 

EXEC SQL END DECLARE SECTION: 


EXEC SQL SELECT b INTO :val :val_ind FROM test1; 


如 果 数 值 不 是 空 ， 那 么 指示 器 变量 valin tes, 如 果 值 是 空 ， 那 么 它 将 是 负数 。 


指示 器 还 有 另外 的 一 个 用 途 ， 如 果 指 示 器 值 是 正 数 ， 则 意味 着 值 不 空 ， 但 是 在 数值 存储 到 宿 
主 变量 里 的 时 候 被 截断 了 。 


如 果 参 数 -r no_indicator 被 传递 给 预 处 理 器 ecpg ， 那么 它 在 "no-indicator" 模 式 下 工作 。 在 
非 指 示 器 模式 下 ， 如 果 没 有 声明 可 用 指示 器 ， 那 么 为 了 将 字符 串 类 型 作为 空 字符 串 以 及 整数 
类 型 作为 类 型 的 最 小 可 能 值 (比如 ， int 最 小 为 INT_MIN ) ， 则 使 用 空 值 (在 输入 和 输出 
上 ) 。 


33.5. 动态 SQL 


在 许多 情况 下 ， 应 用 要 执行 的 具体 的 SQL 语句 在 书写 应 用 的 时 候 就 已 经 知道 了 。 不 过 ， 在 某 
些 情况 下 ，SQL 语 名 是 在 运行 时 或 者 由 外 部 的 数据 提供 的 。 在 这 种 情况 下 ， 我 们 不 能 直接 在 
CH SRASQLIED, 但 是 有 个 机 制 可 以 允许 你 调用 放 在 一 个 字 串 变量 里 的 任何 SQL 语句 。 


33.5.1. 执行 没有 结果 集 的 语句 
执行 任意 SQL 语句 最 简单 的 方法 是 使 用 ExEcUTE IMMEDIATE 命令 。 比如 : 


EXEC SQL BEGIN DECLARE SECTION; 
const char *stmt = "CREATE TABLE testi (...);"; 
EXEC SQL END DECLARE SECTION; 


EXEC SQL EXECUTE IMMEDIATE ‘stmt; 


EXECUTE IMMEDIATE 可 以 用 于 不 返回 结果 集 (tbe, DDL, INSERT, UPDATE , DELETE ) BY 
SQL 语句 。 你 不 能 用 这 种 方式 执行 检索 数据 (比如 SELECT ) 的 语句 。 下 一 节 将 描述 该 如 何 
做 。 


33.5.2. 执行 具有 输入 参数 的 语句 


执行 任意 SQL 语句 的 更 强大 的 方法 是 准备 这 些 语句 一 次 ， 并 且 执 行 这 些 准 各 好 的 语句 任意 多 
次 。 我 们 也 可 以 准 各 一 个 普通 的 语句 版 本 ， 然 后 通过 蔡 换 一 些 参数 ， 执行 一 个 特定 的 版 本 。 
在 准备 语句 的 时 候 ， 在 你 稍 后 需要 替换 参数 的 地 方 书写 一 个 问号 。 比 如 : 

EXEC SQL BEGIN DECLARE SECTION; 

const char *stmt = "INSERT INTO testi VALUES(?, ?);"; 

EXEC SQL END DECLARE SECTION; 


EXEC SQL PREPARE mystmt FROM :stmt, 


EXEC SQL EXECUTE mystmt USING 42, 'foobar'; 


当 你 不 再 需要 预备 语句 时 ， 你 应 该 释放 它 : 


EXEC SQL DEALLOCATE PREPARE _name_, 


33.5.3. 执行 带 有 结果 集 的 语句 


为 了 执行 具有 单独 结果 集 的 SQL 语句 ， 可 以 使 用 execute. 为 了 保存 结果 ， 增 加 INTo 子 
句 。 


EXEC SQL BEGIN DECLARE SECTION; 

const char *stmt = "SELECT a, b, c FROM testi WHERE a > ?"; 
int vi, v2; 

VARCHAR v3[50]; 

EXEC SQL END DECLARE SECTION; 


EXEC SQL PREPARE mystmt FROM :stmt, 


EXEC SQL EXECUTE mystmt INTO :vi, :v2, :V3 USING 37; 


一 个 execute 命令 可 以 有 一 个 mr FA), 一 个 usm 子 句 ， 也 可 以 两 个 都 有 或 者 两 个 都 没 
有 。 


如 果 查 询 希 望 返回 多 个 结果 行 ， 那 么 使 用 游标 ， 正 如 下 面 例子 。 参阅 Section 33.3.2 获 取 更 多 
关于 游标 的 信息 。 


EXEC SQL BEGIN DECLARE SECTION; 

char dbaname[128]; 

char datname[128]; 

char *stmt = "SELECT u.usename as dbaname, d.datname " 
" FROM pg_database d, pg_user u " 
" WHERE d.datdba = u.usesysid"; 

EXEC SQL END DECLARE SECTION; 


EXEC SQL CONNECT TO testdb AS con1 USER testuser; 
EXEC SQL PREPARE stmti FROM :stmt; 


EXEC SQL DECLARE cursori CURSOR FOR stmt1; 
EXEC SQL OPEN cursor1; 


EXEC SQL WHENEVER NOT FOUND DO BREAK; 
while (1) 


EXEC SQL FETCH cursori INTO :dbaname, :datname; 
printf("dbaname=%s, datname=%s\n", dbaname, datname); 


} 


EXEC SQL CLOSE cursor1; 


EXEC SQL COMMIT; 
EXEC SQL DISCONNECT ALL; 


33.6. pgtypes È 


Pgtypes 库 映射 PostgreSQL 数 据 库 类 型 到 C 等 值 ， 它 可 用 于 C 程 序 。 没 有 PostgreSQL 服 务 器 
的 帮助 下 ， 它 也 提供 一 些 函 数 在 C 中 用 这 些 类 型 做 基本 的 运算 。 请 看 下 面 的 例子 : 
EXEC SQL BEGIN DECLARE SECTION; 
date date1; 
timestamp tsi, tsout; 
interval iv1; 
char *out; 
EXEC SQL END DECLARE SECTION; 
PGTYPESdate_today(&date1) ; 
EXEC SQL SELECT started, duration INTO :tsi, :ivi FROM datetbl WHERE d=:date1; 
PGTYPEStimestamp_add_interval(&ts1, &ivi, &tsout); 
out = PGTYPEStimestamp_to_asc(&tsout); 


printf("Started + duration: %s\n", out); 
free(out); 


33.6.1. 数值 类 型 


数值 类 型 提供 任意 精度 的 计算 。 参见 Section 8.1 获取 PostgreSQL 服 务 器 等 价 类 型 。 由 于 任 
意 精度 这 一 变量 需要 能 够 扩展 和 动态 收缩 。 那 就 是 你 只 能 在 堆 上 创建 数值 变量 的 原因 ， 通 
过 PGTYPESnumeric_new 和 PGTYPESnumeric_free KÆ, 和 十 进 制 类 型 类 似 但 精确 度 有 限 ， 可 以 
在 栈 中 创建 也 可 以 在 堆 上 创建 。 


下 列 画 数 用 于 处 理 数 值 类 型 : 


PGTYPESnumeric_new 
请 求 一 个 新 分 配 的 数值 变量 的 指针 。 


numeric *PGTYPESnumeric_new(void) ; 


PGTYPESnumeric_free 


任意 数值 类 型 释放 所 有 内 存 。 


void PGTYPESnumeric_free(numeric *var); 


PGTYPESnumeric_from_asc 
从 字符 串 标号 解析 数值 类 型 。 


numeric *PGTYPESnumeric_from_asc(char *str, char **endptr); 


有 效 格式 比如 : -2, .794, +3.44, 592.49E07 或 者 -32.84e-4 。 如 果 值 解析 不 成 功 ， 返 回 
一 个 有 效 指针 ， 否 则 空 指针 。 此 刻 ECPG 总 是 解析 完整 的 字符 串 ， 所 以 目前 不 支持 存储 
在 *endptr 第 一 无 效 字符 的 地 址 。 你 可 以 安全 地 设置 endptr 为 空 。 


PGTYPESnumeric_to_asc 


一 个 指向 字符 串 的 指针 ， 该 字符 串 是 通过 malloc 包 含 数值 类 型 num 的 字符 串 表 示 形 式 
分 配 的 。 


char *PGTYPESnumeric_to_asc(numeric *num, int dscale); 


ADEN, BASRA ATA dscale 小 数位 数 舍 人 。 


PGTYPESnumeric_add 


添加 两 个 数值 变量 到 三 分 之 一 。 


int PGTYPESnumeric_add(numeric *vari, numeric *var2, numeric *result); 


AAO FS vari 和 var2 到 结果 变量 result Po 图 数 成 功 时 返回 9， 错误 情况 下 返 
回 -1。 


PGTYPESnumeric_sub 


减 去 两 个 数值 变量 并 且 返 回 三 分 之 一 结果 。 


int PGTYPESnumeric_sub(numeric *vari, numeric *var2, numeric *result); 


BAM SS vari 中 减 去 变量 var2 o 操作 的 结果 被 存储 在 变量 result Po 图 数 成 功 时 返回 
0， 并 且 错 误 的 情况 下 返回 -1。 


PGTYPESnumeric_mul 


两 个 数值 变量 相 乘 ， 并 且 返 回 三 分 之 一 结果 。 


int PGTYPESnumeric_mul(numeric *vari, numeric *var2, numeric *result); 


BUS & S varı 和 var2 相 乘 。 操 作 的 结果 被 存储 在 变量 result 中 。 MBAR 
并 且 错 误 的 情况 下 返回 -1。 


PGTYPESnumeric_div 


两 个 数值 变量 相 除 并 且 返 回 三 分 之 一 结果 。 


int PGTYPESnumeric_div(numeric *vari, numeric *var2, numeric *result); 


KHAUF Æ varı 除 以 变量 var2 o 操作 的 结果 被 存储 在 变量 result Ho KAMAN IRI 
并 且 错 误 的 情况 下 返回 -1。 


PGTYPESnumeric_cmp 


比较 两 个 数值 变量 。 


int PGTYPESnumeric_cmp(numeric *vari1, numeric *var2) 


这 个 画 数 比较 两 个 数值 变量 。 在 错误 的 情况 下 ， 返 回 INT_MAx 。 RI, KOREO ZANATA 
果 之 一 : 


e 如 果 varı 大 于 var2 , 则 15 


返回 
e 如 果 vara 小 于 var2 , 则 返回 -1。 
返 


e 如 果 varı SF var2 , 则 返回 0。 


PGTYPESnumeric_from_int 
转换 一 个 int 变 量 到 数值 变量 。 
int PGTYPESnumeric_from_int(signed int int_val, numeric *var); 


这 个 图 数 接受 有 符号 整 型 变量 并 将 其 存储 在 数值 变量 var H, 成 功 时 ， 则 返回 0。 在 失败 的 
情况 下 ， 返 回 -1。 


PGTYPESnumeric_from_long 
转换 长 整 型 变量 到 数值 变量 。 
int PGTYPESnumeric_from_long(signed long int long_val, numeric *var); 


ADRASAN KBE RBH GREUZE var 中 ， 成 功 时 ， 则 返回 0。 在 失败 
的 情况 下 ， 返 回 -1。 


PGTYPESnumeric_copy 
拷贝 一 个 数值 变量 为 另 一 个 变量 。 
int PGTYPESnumeric_copy(numeric *src, numeric *dst); 


PBA RSNA, REPRE src 指向 dst 指向 的 变量 ， 成 功 时 返回 0， 错 误 的 情况 
下 返回 -1。 


PGTYPESnumeric_from_double 


将 double 类 型 的 变量 转换 成 数值 类 型 的 。 


int PGTYPESnumeric_from_double(double d, numeric *dst); 


这 个 函数 接受 double 变 量 并 将 其 结果 存储 在 dst 指向 的 变量 中 ， 成 功 时 ， 则 返回 0。 在 失败 
的 情况 下 ， 返 回 -1。 


PGTYPESnumeric_to_double 
将 数值 类 型 变量 转换 成 double 类 型 的 。 


int PGTYPESnumeric_to_double(numeric *nv, double *dp) 


这 个 男 数 从 变量 中 转换 数值 类 型 的 值 ， 这 个 变量 是 nv 指向 的 dp 指向 的 double 变 量 ， 成 功 
时 返回 9， 错误 的 情况 下 返回 -1， 包 括 浴 出 。 渝 出 的 时 候 ， 全 局 变量 errno 将 额外 设 


ia PGTYPES_NUM_OVERFLOW o 


PGTYPESnumeric_to_int 
将 数值 类 型 变量 转化 成 整 型 。 


int PGTYPESnumeric_to_int(numeric *nv, int *ip); 


这 个 函数 从 变量 中 转换 数值 类 型 的 值 ， 这 个 变量 是 nv 指向 的 ip 指向 的 整 型 变量 ， 成 功 时 返 
回 0， 错 误 的 情况 下 返回 -1， 包 括 浴 出 。 浴 出 的 时 候 ， 全 局 变量 errno 将 额外 设 


ia PGTYPES_NUM_OVERFLOW o 


PGTYPESnumeric_to_long 
将 数值 类 型 的 变量 转换 成 long 类 型 。 


int PGTYPESnumeric_to_long(numeric *nv, long *lp); 


这 个 函数 从 变量 中 转换 数值 类 型 的 值 ， 这 个 变量 是 nv 指向 的 1p 指向 的 长 整 型 变量 ， 成 功 时 
返回 0， 错 误 的 情况 下 返回 -1， 包 插 浴 出 。 洽 出 的 时 候 ， 全 局 变量 errno 将 额外 设 


ia PGTYPES_NUM_OVERFLOW o 


PGTYPESnumeric_to_decimal 
将 数值 类 型 的 变量 转换 成 十 进 制 类 型 。 


int PGTYPESnumeric_to_decimal(numeric *src, decimal *dst); 


这 个 函数 从 变量 中 转换 数值 类 型 的 值 ， 这 个 变量 是 src 指向 的 dst 指向 的 十 进 制 变量 ， 成 
功 时 返回 0， 错 误 的 情况 下 返回 -1， 包 括 浴 出 。 浴 出 的 时 候 ， 全 局 变量 errno 将 额外 设 


ia PGTYPES_NUM_OVERFLOW o 


PGTYPESnumeric_from_decimal 


将 十 进 制 类 型 的 变量 转换 成 数值 类 型 。 
int PGTYPESnumeric_from_decimal(decimal *src, numeric *dst); 
这 个 函数 从 变量 中 转换 十 进 制 值 ， 这 个 变量 是 src 指向 的 dst 指向 的 数值 变量 ， 成 功 时 返回 


0， 错 误 的 情况 下 返回 -1， 包 括 浴 出 。 由 于 十 进 制 类 型 作为 数值 类 型 的 有 限 版 本 实现 的 ， 不 会 
KE AR RS He es 


33.6.2. 日 期 类 型 
C 中 的 日 期 类 型 允许 你 的 程序 处 理 SQL 类 型 的 数据 。 参 见 Section 8.5 获得 PostgreSQL 服 务 器 
的 等 价 类 型 。 
下 面 的 范 数 可 以 适用 于 日 期 类 型 : 
PGTYPESdate_from timestamp 


从 一 个 时 间 戳 中 提取 日 期 部 分 。 


date PGTYPESdate_from_timestamp(timestamp dt); 


XP WARS — Pay A BE hy REM SR HAM ad ig Bik lee AB. 


PGTYPESdate_from_asc 
从 文本 表示 解析 日 期 。 


date PGTYPESdate_from_asc(char *str, char **endptr); 


函数 接收 C char 字 符 串 str 和 指向 C char 字 符 串 endptr 的 指针 。 此 刻 ECPG 总 是 解析 完整 的 
字符 串 ， 所 以 目前 不 支持 存储 在 *endptr 中 的 第 一 无 效 字符 的 地 址 。 你 可 以 安全 地 设 
置 endptr 无 效 。 


注意 ， 阔 数 始 终 假定 MDY 格 式 化 日 期 目前 在 ECPG 还 没有 改变 。 
Table 33-2 显 示 了 人 允许 输入 格式 。 


Table 33-2. pctypesdate from asc 有 效 输入 格式 


EN 
> 
Ww 
or 
站 


January 8, 1999 January 8, 1999 
1999-01-08 January 8, 1999 

1/8/1999 January 8, 1999 

1/18/1999 January 18, 1999 

01/02/03 February 1, 2003 
1999-Jan-08 January 8, 1999 
Jan-08-1999 January 8, 1999 
08-Jan-1999 January 8, 1999 

99-Jan-08 January 8, 1999 

08-Jan-99 January 8, 1999 

08-Jan-06 January 8, 2006 

Jan-08-99 January 8, 1999 

19990108 ISO 8601; January 8, 1999 
990108 ISO 8601; January 8, 1999 
1999.008 year and day of year 
J2451187 Julian day 

January 8, 99 BC year 99 before the Common Era 


PGTYPESdate_to_asc 
一 个 数据 变量 的 文本 表示 。 


char *PGTYPESdate_to_asc(date dDate); 


PAE IAA HB dpate 作为 它 唯一 参数 。 输出 数据 的 形式 1999-01-18 , Bi vvvy-mm-pp 格式 。 


PGTYPESdate_julmdy 
从 一 个 日 期 型 的 变量 中 提取 一 天 、 本 月 和 一 年 的 值 。 
void PGTYPESdate_julmdy(date d, int *mdy); 


PAU ABR d 和 一 个 指向 3 个 整 型 值 my 数组 的 指针 。 变量 名 称 显 示 顺 序 : mdy[6] 设置 
为 包含 的 几 个 月 份 ， mdy[1] 设置 为 一 天 的 值 ， mdy[2] 包含 一 年 的 值 。 


PGTYPESdate_mdyjul 


从 指定 日 期 的 年 、 月 、 日 的 3 个 整 型 值 数 组 中 创建 一 个 日 期 值 。 


void PGTYPESdate_mdyjul(int *mdy, date *jdate); 


PAREN SS BEY ( may ) 的 数组 作为 第 一 个 参数 ， 第 二 个 参数 是 指向 保留 运算 结果 的 日 期 型 变 
量 的 指针 。 


PGTYPESdate_dayofweek 
返回 表示 日 期 值 的 一 个 星期 数 。 


int PGTYPESdate_dayofweek(date d); 


KARMA Sd 作为 其 唯一 的 参数 ， 并 返回 一 个 整数 ， 表 示 这 个 日 期 的 本 周 的 一 天 。 
。 0 - 星期 日 


。 1 - 星期 一 
。 2 - 星期 二 
。 3 -星期 三 
。 4 - 星期 四 
。 5 一 星期 五 
。 6 一 星期 六 


PGTYPESdate_today 
得 到 当前 日 期 。 


void PGTYPESdate_today(date *d); 


PI FSA) RG ( d ) 的 一 个 指针 ， 它 设置 当前 的 日 期 。 


PGTYPESdate_fmt_asc 
将 日 期 类 型 变量 转换 成 使 用 格式 掩 码 的 文本 表示 形式 。 

int PGTYPESdate_fmt_asc(date dDate, char *fmtstring, char *outbuf); 
函数 接收 一 个 转换 ( dpate ) 日 期 ， 格 式 掩 码 ( tmtstring ) 以 及 保持 日 期 ( outbuf ) 文 本 表示 形 
AFT A. 
成 功 的 时 候 返 回 0， 如 果 产 生 错 误 则 返回 负数 。 
下 列 是 你 可 以 使 用 的 字段 分 类 符 : 

e dd - 某 月 的 天 数 。 

。 mm - 某 年 的 月 数 。 


。 yy -2 位 数 的 年 数 。 
。 yyyy -4 位 数 的 年 数 。 
。 ddd - 某 天 的 名 字 (4988) 。 
。 mm - 某 月 份 名 字 (RE) 。 
所 有 其 它 的 字符 按 1:1 复 制 到 输出 字符 串 中 。 


Table 33-3 表 示 一 些 可 能 的 格式 。 这 将 让 你 知道 如 何 使 用 这 些 功能 。 所 有 输出 行 基于 相同 的 
日 期 : 1959 年 11 月 23 号 。 


Table 33-3. pctypESdate_fmt_asc 有 效 输入 格式 


格式 结果 
mmddyy 112359 
ddmmyy 231159 
yymmdd 591123 
yy/mm/dd 59/11/23 
yy mm dd SORA 23 
yy.mm.dd 59011723 
.mm. yyyy . dd. 2111959729: 
mmm. dd, yyyy Nov. 23, 1959 
mmm dd yyyy Nov 23 1959 
yyyy dd mm 1959 23 11 
ddd, mmm. dd, yyyy Mon, Nov. 23, 1959 
(ddd) mmm. dd, yyyy (Mon) Nov. 23, 1959 


PGTYPESdate_defmt_asc 


488 FA 48 SUH iC char* 到 日 期 类 型 的 值 。 


int PGTYPESdate_defmt_asc(date *d, char *fmt, char *str); 


函数 接收 一 个 指向 保持 操作 ( d ) 结 果 的 日 期 值 的 指针 ， 解析 日 期 ( fmt ) 的 格式 掩 码 以 及 包含 
日 期 ( str ) 文 本 表示 的 C char FRR, 希望 文本 表示 匹配 格式 掩 码 。 但 是 你 不 需要 字符 串 1:1 
映射 到 格式 掩 码 。 这 个 函数 仅 分 析 相 继 顺 序 ， HEER yy 或 者 yyyy 显示 年 的 位 置 ， 

mm 显示 月 的 位 置 ， dd 显示 一 天 的 位 置 。 


Table 33-4 表 明 一 些 可 能 的 格式 。 BORE IRAE Re SRK, 


Table 33-4. rdefmtdate 有 效 输 入 格式 


格式 字符 串 结果 


ddmmyy 21-2-54 1954-02-21 
ddmmyy 2-12-54 1954-12-02 
ddmmyy 20111954 1954-11-20 
ddmmyy 130464 1964-04-13 
mmm.dd.yyyy MAR-12-1967 1967-03-12 
yy/mm/dd 1954, February 3rd 1954-02-03 
mmm.dd.yyyy 041269 1969-04-12 
yy/mm/dd 在 2525 年 ，7 月 28 号 人 类 仍 存活 。 2525-07-28 
dd-mm-yy 2525 年 7 月 28 号 2525-07-28 
mmm.dd.yyyy 9/14/58 1958-09-14 
yy/mm/dd 47/03/29 1947-03-29 
mmm.dd.yyyy oct 28 1975 1975-10-28 
mmddyy Nov 14th, 1985 1985-11-14 


33.6.3. By ja] 2k X Be 
CH at ja Be HK E HAS A SQL 类 型 时 间 戳 数据 。 参见 Section 8.5 获取 关于 
PostgreSQL 服 务 器 的 等 价 类 型 。 
TAKRATNA F ia Be HK 
PGTYPEStimestamp_from_asc 


将 文本 表示 的 时 间 惟 解析 成 一 个 时 间 惟 变量。 


timestamp PGTYPEStimestamp_from_asc(char *str, char **endptr); 


函数 接收 一 个 解析 ( str ) 字 符 串 和 指向 C char( endptr ) 指 针 。 此 刻 ECPG 总 是 解析 完整 字符 
$, 因此 它 目前 不 支持 存储 "endptr 中 第 一 无 效 字符 地 址 。 你 可 以 安全 地 设置 endptr 为 空 。 


成 功 时 函数 返回 解析 的 时 间 稚 ， 产 生 错 误 时 返回 PGTYPESInvalidTimestamp ， 并 且 设 
置 errno 为 PGTYPES_TS_BAD_TIMESTAMP o 参见 PGTYPESInvalidTimestamp 获取 这 个 值 的 重要 注 


释 。 


一 般 情 况 下 ， 输 入 的 字符 串 可 以 包含 一 个 所 允许 日 期 规范 、 一 个 空格 字符 和 人 允许 的 时 间 规 范 
的 任意 组 合 。 请 注意 ，ECPG 不 支持 时 区 。 它 可 以 解析 它们 ， 但 不 适用 于 任何 计算 比如 
PostgreSQL 服 务 器 。 时 区 说 明 符 默认 是 省 略 的 。 


Table 33-5 包 含 输入 字符 串 的 一 些 例子 。 


Table 33-5. PGTYPEStimestamp_from asc 有 效 输入 格式 


输入 结果 


1999-01-08 04:05:06 1999-01-08 04:05:06 
January 8 04:05:06 1999 PST 1999-01-08 04:05:06 

1999-Jan-08 04:05:06.789-8 1999-01-08 04:05:06.789 (忽略 时 区 说 明 符 ) 
J2451187 04:05-08:00 1999-01-08 04:05:00 (忽略 时 区 说 明 符 ) 


PGTYPEStimestamp_to_asc 
将 日 期 转换 成 C char 字 符 串 。 


char *PGTYPEStimestamp_to_asc(timestamp tstamp); 


PEM ay fe] AV tstamp 作为 其 唯一 的 参数 并 返回 一 个 包含 时 间 戳 的 文本 表示 的 分 配 的 字符 
Fo 


PGTYPEStimestamp_current 
RAAB fa Bh. 


void PGTYPEStimestamp_current(timestamp *ts); 


AKARA A, HERCA ts 指向 的 时 间 惟 变量 中 。 


PGTYPEStimestamp_fmt_asc 
使 用 格式 掩 码 将 时 间 戳 变量 转换 为 C char”。 


int PGTYPEStimestamp_fmt_asc(timestamp *ts, char *output, int str_len, char *fmtstr); 


这 个 函数 接受 一 个 指向 时 间 戳 转换 为 它 的 第 一 个 参数 ( ts ) 的 指针 ， 一 个 指向 缓冲 输出 
(output )， 最 大 长 度 已 为 输出 缓冲 区 ( str_len ) 分 配 ， 并 且 为 转换 ( fmtstr A ERAAN 
指针 。 


一 旦 成 功 ， 该 图 数 返回 9， 如 果 产 生 错 误 ， 则 返回 负 值 。 


你 可 以 为 格式 掩 码 使 用 以 下 的 格式 分 类 符 。 格式 分 类 符 是 和 libc 的 strftime 画 数 中 使 用 的 相 
同 的 。 任何 非 格式 分 类 符 将 被 复制 到 输出 缓冲 区 。 


。 %A -是 由 工作 日 全 称 的 国家 表示 形式 蔡 换 。 

。 va -是 由 工作 日 名 称 缩写 的 国家 表示 形式 蔡 换 。 

。 %B -是 由 月 份 名 的 全 称 的 国家 表示 形式 蔡 换 。 

。 x%b -是 由 月 份 名 称 缩写 的 国家 表示 形式 替换 。 

e xc -通过 【年 /100) 作为 十 进 制 数 蔡 换 ; 单位 数 前 边 加 需 。 


%c - 由 时 间 和 日 期 的 国家 表示 形式 替换 。 
%D -等同 于 %m/%d/%y o 
%d - 作为 十 进 制 数 (01-31) 按 当月 的 一 天 蔡 换 。 


%E* %o* - POSIX 区 域 扩展 。 序列 %Ec %EC %Ex %EX %Ey %EY %0d %oe %OH 
%OI %om %OM %os %ou %ou “OV %ow %ow %oy 应 该 提供 替代 表示 形式 。 


此 外 ， 实 现 的 woB 代表 可 选 月 份 名 字 GREA, RARR) 。 
we -作为 十 进 制 数 (1-31) 按 当月 的 一 天 替换 ; 单位 数 前 面 有 空格 。 
%F - 等 同 于 %Y-%m-%d o 


xe - 以 每 年 作为 一 个 世纪 的 十 进 制 数 普 换 。 今年 是 包含 一 周 的 大 部 分 中 的 一 个 (星期 
一 作为 一 周 的 第 一 天 ) 。 


%g -由 xc 中 的 同一 年 替换 ， 但 作为 一 个 没有 世纪 (00-99) 的 十 进 制 数 。 
%H - 作为 十 进 制 数 〈00-23) 按 小 时 (24 小 时 ) 进行 替换 。 

%h -等 同 于 xb 。 

%I - 作为 十 进 制 数 (01-12) 按 小 时 (12 小时) 进行 替换 。 

%j - 作为 十 进 制 数 (001-366) 按 一 年 的 一 天 来 蔡 换 。 

wk - 作为 十 进 制 数 〈0-23) 按 小 时 (24 小 时 ) Bike; 单位 数 前 面 有 空格 。 
xl - 作为 十 进 制 数 〈1-12) 按 小 时 (12 小 时 ) Be; 单位 数 前 面 有 空格 。 
%M - 作为 十 进 制 数 (00-59) 按 分 钟 来 蔡 换 。 

am - 作为 十 进 制 数 (01-12) 按 月 替换 。 

- 通过 换行 符 蔡 换 。 


XL 
Ss 


%0* - 等 同 于 %E* 。 

%p - 由 合适 的 "午前 "或 "午后 "的 国家 表示 形式 进行 替换 。 
%R - 等 同 于 %H:%M 。 

%r -等同 于 %I:%M:%s%p 

xs - 作为 十 进 制 数 〈00-60) 按 秒 进行 蔡 换 。 

%s -通过 Epoch, UTC 以 来 的 秒 数 蔡 换 。 


%T -等同 于 %H:%M:%S o 


wt -通过 制 表 符 替 换 。 
-按照 十 进 制 数 (00-53) 一 年 中 的 周 数 取代 (星期 日 作为 一 周 的 第 一 天 ) 。 


e 
aL 


e 
X 
€ 


- 按照 十 进 制 数 〈1-7) 工 作 日 取代 〈 星 期 一 作为 一 周 的 第 一 天 ) 。 

- 通过 十 进 制 数 (01-53) 一 年 中 的 周 数 取代 (星期 一 作为 一 周 的 第 一 天 ) 。 MRE 
新 的 一 年 中 包含 一 月 一 日 的 工作 日 有 四 天 以 上 ， 那么 它 是 第 1 周 ; 否则 它 是 去 年 的 最 后 一 
周 ， 并 且 下 一 周 是 第 1 周 。 


e 
XL 
c 


e 
> 


© %v - 等同 于 %e-%b-%Y o 
e w -通过 十 进 制 数 (00-53) 一 年 的 周 数 取 代 〈 星 期 一 作为 一 周 的 第 一 天 ) 。 


e o -通过 十 进 制 数 (0-6) 工作 日 取代 〈 星 期 日 作为 一 周 的 第 一 天 ) 。 
e xx -通过 时 间 的 国家 表示 形式 取代 。 

。 xx -通过 日 期 的 国家 表示 形式 取代 。 

e wy -通过 十 进 制 数 世纪 年 来 取代 。 


e xy -通过 十 进 制 数 (00-99) 没有 世纪 的 年 来 取代 。 
e %Z -由 时 区 名 称 蔡 换 。 


。 x%z -通过 UTC 时 区 偏 移 量 取代 ; 前 导 加 号 为 UTC 东部 ， 减 号 为 UTC 西部 ， 小 时 和 分 钟 
各 跟随 着 两 位 数 ， 它 们 之 间 没 有 分 隔 符 (常见 的 形式 为 RFC 822 日 期 标题 ) 。 


e %+ -通过 日 期 和 时 间 的 国家 表示 形式 蔡 换 。 

e %-* -GNU libc 扩 展 。 当 执行 数值 输出 时 不 要 做 任何 填充 。 
e $_*- GNU libc 扩 展 。 明 确 声 明 空 格 填充 。 

e %0* - GNU libc 扩 展 。 明 确 声 明 需 填充 。 


e %% -通过 % 替换 。 


PGTYPEStimestamp_sub 
从 另外 一 个 中 减 去 一 个 时 间 戳 ， 并 且 将 结果 保存 在 interval 类 型 的 变量 中 。 
int PGTYPEStimestamp_sub(timestamp *ts1, timestamp *ts2, interval *iv); 
ARAA AMES, RAEE tsz 指向 的 tsı 指向 的 时 间 戳 的 变量 ， 并 将 结果 存 
储 在 iv 指向 的 时 间 惟 变量 中 。 
成 功 时 ， 函 数 返 回 0。 如 果 发 生 错 误 则 返回 一 个 负 值 。 


PGTYPEStimestamp_defmt_asc 


从 使 用 格式 掩 码 的 文本 表示 中 分 析 一 个 时 间 戳 值 。 

int PGTYPEStimestamp_defmt_asc(char *str, char *fmt, timestamp *d); 
RSNA ES str 时 间 戳 的 文本 表示 以 及 格式 掩 码 中 使 用 的 变量 fmt 。 结果 将 存储 
在 d 指向 的 变量 中 。 
如 果 格式 掩 码 fmt 是 空 ， 该 酌 数 将 回落 到 缺 省 格式 撼 码 %Y-%m-%d%H:%M:%s o 
这 是 PGTYPEStimestamp_fmt_asc 的 反 向 函数 。 参见 文档 找 出 可 能 的 格式 掩 码 项 。 


PGTYPEStimestamp_add_interval 


增加 interval 变 量 到 timestamp 变 量 。 

int PGTYPEStimestamp_add_interval(timestamp *tin, interval *span, timestamp *tout); 
SHAE — Tie ltimestamps Æ tin 的 指针 ， 一 个 指向 interval 变 量 span 的 指针 。 它 
增加 interval 到 timestamp， 并 且 将 结果 timestamp 保 存在 tout 指向 的 变量 中 。 


成 功 时 ， 这 个 函数 返回 9， 如 果 产 生 错 误 ， 则 返回 一 个 负数 。 


PGTYPEStimestamp_sub_interval 
从 一 个 timestamp 变 量 中 减 去 interval 变 量 。 

int PGTYPEStimestamp_sub_interval(timestamp *tin, interval *span, timestamp *tout); 
«xp wR interval y S, 2AE span 指向 的 tin 指向 的 timestamp 变 量 ， HA 
果 存 储 在 tout 指向 的 变量 中 。 
成 功 时 ， 这 个 男 数 返 回 0。 当 产生 错误 的 时 候 ， 返 回 负 数 。 


33.6.4. 区 间 类 型 

C 中 区 间 类 型 允许 你 的 程序 处 理 SQL 类 型 区 间 的 数据 。 参见 Section 8.5 获 取 PostgreSQL 服 务 
器 的 等 价 类 型 。 

下 面 的 函数 可 以 用 于 区 间 类 型 : 


PGTYPESinterval_new 
返回 一 个 已 分 配 的 区 间 变 量 的 指针 。 


interval *PGTYPESinterval_new(void); 


PGTYPESinterval_free 
释放 已 经 分 配 区 间 变 量 的 内 存 。 


void PGTYPESinterval_new(interval *intvl); 


PGTYPESinterval_from_asc 
解析 文本 表示 的 区 间 。 


interval *PGTYPESinterval_from_asc(char *str, char **endptr); 


该 函数 解析 输入 的 字符 串 str 并 返回 分 配 区 间 变 量 的 指针 。 此 刻 ECPG 总 是 解析 完整 的 字符 
串 ， 所 以 目 前 不 支持 存储 在 *endptr 中 的 第 一 无 效 字 符 的 地 址 。 你 可 以 安全 地 设 


E endptr 为 空 。 


PGTYPESinterval_to_asc 
将 类 型 区 间 的 变量 转换 成 它 的 文本 表示 。 


char *PGTYPESinterval_to_asc(interval *span); 


该 函数 将 转换 span 指向 C char* 的 区 间 变 量 ， 输出 看 起 来 像 这 样 的 例 


子 : 61 day 12 hours 59 mins 10 secs o 


PGTYPESinterval_copy 
复制 区 间 类 型 的 变量 。 


int PGTYPESinterval_copy(interval *intvlsrc, interval *intvldest); 


WMS Hl intvisrc 指向 intvidest 指向 的 区 间 变量 ， 注意 ， 你 需要 在 目标 变量 前 分 配 内 
存 。 


33.6.5. 十 进 制 类 型 


decimal 类 型 和 numeric 类 型 是 类 似 的 。 然 而 ， 它 仅 仅 是 一 个 30 位 数 的 最 大 精度 。 相 反 ， 
numeric 类 型 只 能 在 堆 上 创建 ，decimal 类 型 可 以 在 栈 或 堆 上 创建 GE 

数 peTYPESdecimal new 和 PGTYPESdecimal_free ) o Section 33.15 中 描述 的 Informix 兼 容 模 式 
还 有 很 多 你 理 decimal 类 型 的 其 他 函数 。 

下 面 的 函数 可 以 用 于 decimal 类 型 ， 不 仅 包 含 在 libcompat 库 中 。 


PGTYPESdecimal_new 


请 求 一 个 新 分 配 的 decimal 变 量 的 指针 。 


decimal *PGTYPESdecimal_new(void) ; 


PGTYPESdecimal_free 


任意 decimal 类 型 ， 释 放 所 有 内 存 。 


void PGTYPESdecimal_free(decimal *var); 


33.6.6. pgtypeslib 的 errno 值 


PGTYPES_NUM_BAD_NUMERIC 


参数 应 该 包含 一 个 数值 变量 (或 者 指向 一 个 数值 变量 ) 但 事实 上 内 存 中 表示 是 无 效 的 。 


PGTYPES_NUM_OVERFLOW 


发 生 浴 出 。 因 为 numeric 类 型 可 以 义理 几乎 任意 精度 ， 将 一 个 numeric 变 量 转换 为 其 它 类 型 可 
能 导致 浴 出 。 

PGTYPES_NUM_UNDERFLOW 

发 生 下 浴 。 因 为 numeric 类 型 可 以 义理 几乎 任意 精度 ， 将 一 个 numeric 变 量 转 换 为 其 它 类 型 可 
能 导致 下 浴 。 

PGTYPES_NUM_DIVIDE_ZERO 

Z RRAS, 

PGTYPES_DATE_BAD_DATE 

无 效 的 日 期 字符 串 被 传递 给 PGTYPESdate_from_asc WX, 


PGTYPES_DATE_ERR_EARGS 


无 效 参数 被 传递 给 PGTYPESdate_defmt_asc KIR 
PGTYPES_DATE_ERR_ENOSHORTDATE 
通过 PGTYPESdate_defmt_asc 加 数 发 现 输入 字符 串 中 的 无 效 标记 。 


PGTYPES_INTVL_BAD_INTERVAL 


无 效 区 间 字符 串 被 传递 给 PGTYPESinterval_from_asc aX, 或 者 无 效 区 间 值 被 传递 


给 PGTYPESinterval_to_asc 图 数 。 


PGTYPES_DATE_ERR_ENOTDMY 


在 pPGTYPESdate_defmt_asc 图 数 中 日 /月 /年 分 配 不 匹配 。 


PGTYPES_DATE_BAD_DAY 


通过 PGTYPESdate_defmt_asc 酌 数 发 现 某 月 值 的 无 效 天 数 。 


PGTYPES_DATE_BAD_MONTH 


通过 pGTYPESdate_defmt_asc 酌 数 发 现 无 效 月 数值 。 

PGTYPES_TS_BAD_TIMESTAMP 

无 效 的 timestamp 字 符 串 被 传递 给 PGTYPEStimestamp_from_asc 图 数 ， 或 者 无 效 timestamp 值 被 
传递 给 PGTYPEStimestamp_to_asc EX. 


PGTYPES_TS_ERR_EINFTIME 


在 环境 中 遇 到 的 无 限 timestamp 值 不 能 义理 它 。 


33.6.7. pgtypeslib 的 特殊 常量 


PGTYPESInvalidTimestamp 


代表 一 个 无 效 的 时 间 惟 的 timestamp 类 型 的 值 。 Bian WRX PGTYPEStimestamp_from_asc R 
回 解析 错误 。 请 注意 ， 由 于 该 timestamp 数据 类 型 的 内 部 表示 ， A 

时 PGTYPESInvalidTimestam 也 是 一 个 有 效 的 timestamp。 它 设置 1899-12-31 23:59:59 。 为 了 
仿 测 错误 ， 确保 你 的 应 用 每 次 调用 pctyrestimestamp_from_asc 后 不 仅 测 


试 PGTYPESInvalidTimestamp 也 能 检测 errno != 0 © 


33.7. 使 用 描述 符 范 围 


一 个 SQL 描 述 符 范围 是 处 理 sELEcT ，FETCH 或 者 DESCRIBE 语句 结果 的 更 复杂 的 方法 。 一 个 
SQL 描 述 符 范 围 把 一 行 数据 里 的 数据 和 元 数据 项 组 合 到 一 个 数据 结构 中 。 元 数据 在 执行 动态 
SQL 语 句 时 特别 有 用 ， 那 里 的 结果 列 的 属性 可 能 不 能 提前 知道 。 PostgreSQL 提 供 了 两 种 使 用 
描述 符 范 围 的 方法 : 命名 的 SQL 描述 符 范 围 和 C 结 构 SQLDAs。 


33.7.1. 命名 SQL 描述 符 范 围 


一 个 命名 SQL 描述 符 范围 由 一 个 头 组 成 ， 包含 有 关 整 个 描述 符 的 信息 ， 一 个 或 多 个 项 描述 符 
范围 ， 基本 上 每 个 描述 结果 行 中 的 一 个 字段 。 


在 你 使 用 SQL 描 述 符 范 围 之 前 ， 你 需要 分 配 一 个 : 


EXEC SQL ALLOCATE DESCRIPTOR _identifier_; 


标示 符 用 作 描 述 符 范 围 的 "变量 名 "。 当 你 不 再 需要 这 个 描述 符 ， 你 应 该 释放 它 : 


EXEC SQL DEALLOCATE DESCRIPTOR _identifier_; 


要 使 用 一 个 描述 符 范 围 ， 在 一 个 INTo 子 句 的 存储 目标 里 声明 它 ， 而 不 是 列 出 宿主 变量 : 


EXEC SQL FETCH NEXT FROM mycursor INTO SQL DESCRIPTOR mydesc; 


如 果 结 果 集 是 空 ， 描 述 符 范围 将 包含 来 自 查 询 的 元 数据 ， 即 字段 名 称 。 
为 了 尚未 执行 的 预备 查询 ， DESCRIBE 语句 可 用 于 获得 结果 集 的 元 数据 : 


EXEC SQL BEGIN DECLARE SECTION; 
char *sql_stmt = "SELECT * FROM table1"; 
EXEC SQL END DECLARE SECTION; 


EXEC SQL PREPARE stmt1 FROM :sql_stmt; 
EXEC SQL DESCRIBE stmt1 INTO SQL DESCRIPTOR mydesc; 


PostgreSQL 9.0 之 前 ， so 关键 字 是 可 选 的 ， 所 以 使 用 DEscRIPTOR 和 SQL DESCRIPTOR 产生 
命名 SQL 描述 符 范 围 。 现在 ， 它 是 强制 性 的 ， 省 略 so 关键 词 产生 SQLDA 描 述 符 范围 ， FS 
# Section 33.7.2。 


在 DESCRIBE 和 FETCH 语句 中 ， INTO 和 usine 关键 字 使 用 类 似 : 它们 产生 结果 集合 和 描述 
符 范 围 的 元 数据 。 


现在 ， 我 们 应 该 如 何 从 描述 符 范围 里 获取 数据 ? 你 可 以 把 描述 符 范 围 看 作 是 一 个 有 着 命名 字 
段 的 结构 。 要 从 头 检索 字段 数值 并 且 把 它 存 储 到 一 个 宿主 变量 里 ， 使 用 下 面 的 命令 : 


EXEC SQL GET DESCRIPTOR _name_ :_hostvar_ = _field_; 


诉 我 们 有 几 个 项 描述 符 范 围 存在 〈 也 就 是 


目前 只 定义 了 一 个 头 字段 : cout, 这 个 字段 告 
需要 是 一 个 整数 类 型 。 要 从 项 描述 符 范 围 里 获取 


i 
说 ， 在 结果 里 包含 多 少 个 字段 ) 。 宿主 变量 
一 个 字段 ， 使 用 下 面 的 命令 : 


EXEC SQL GET DESCRIPTOR _name_ VALUE _num_ :_hostvar_ = _field_; 


_num_ 可 以 是 一 个 字符 整数 或 者 一 个 包含 整数 的 宿主 变量 。 可 能 的 字段 有 : 
CARDINALITY (integer) 

结果 集中 的 行 数 

DATA 

实际 数据 项 〈 因 此 ， 这 个 字段 的 数据 类 型 依赖 于 这 个 查询 ) 
DATETIME_INTERVAL_CODE (integer) 


i=] 


“4 type 是 9 AYA, ABZ. DATETIME _INTERVAL_copE 将 有 pate AY 1 值 ， TIME AY 2 值 ， 


TIMESTAMP BY 3 44, TIME WITH TIME ZONE 的 4 值 或 者 TIMESTAMP WITH TIME ZONE BY 5 值 。 
DATETIME_INTERVAL_PRECISION (integer) 
未 实现 。 

INDICATOR (integer) 

描述 符 (标识 一 个 空 值 或 者 一 个 截断 的 值 ) 
KEY_MEMBER (integer) 

未 实现 

LENGTH (integer) 

字符 中 数据 长 度 

NAME (String) 

字段 名 称 

NULLABLE (integer) 


未 实现 


OCTET_LENGTH (integer) 

字 节 数据 的 字符 表示 的 长 度 
PRECISION (integer) 

精度 (类 型 numeric ) 
RETURNED_LENGTH (integer) 
字符 中 数据 长 度 
RETURNED_OCTET_LENGTH (integer) 
字 节 数据 的 字符 表示 的 长 度 
SCALE (integer) 

比例 (类 型 numeric ) 

TYPE (integer) 

字段 数据 类 型 的 数值 代码 


在 EXECUTE , DECLARE 和 open 语句 中 ， INTO 和 usine 关键 字 的 作用 是 不 同 的 。 描述 符 范围 
可 以 手动 的 编译 ， 为 一 个 查询 或 者 游标 提供 输入 参数 ， 并 且 USING SQL DESCRIPTOR 

_name_ 是 传递 输入 参数 给 一 个 参数 化 查询 的 一 种 方式 。 编译 命名 SQL 描述 符 范 围 的 语句 如 
F: 


EXEC SQL SET DESCRIPTOR _name_ VALUE _num field = :_hostvar_; 





PostgreSQL 支 持 检 索 更 多 的 在 一 个 FETcH 语句 中 的 记录 和 存储 在 宿主 变量 中 的 数据 ， 在 这 种 
情况 下 假设 变量 是 一 个 数组 。 例 如 : 

EXEC SQL BEGIN DECLARE SECTION; 

int id[5]; 

EXEC SQL END DECLARE SECTION; 


EXEC SQL FETCH 5 FROM mycursor INTO SQL DESCRIPTOR mydesc; 


EXEC SQL GET DESCRIPTOR mydesc VALUE 1 :id = DATA; 


33.7.2. SQLDA 描 述 符 范围 


SQLDA 描 述 符 范 围 是 一 个 C 语 言 结构 ， 它 过 去 常常 获取 结果 集 和 查询 的 元 数据 。 一 个 结构 存 
储 来 自 结果 集中 的 一 条 记录 。 


EXEC SQL include sqlda.h; 
sqlda_t *mysqlda; 


EXEC SQL FETCH 3 FROM mycursor INTO DESCRIPTOR mysqlda; 


注意 省 略 so 关键 字 。 Section 33.7.1 中 的 INTo 和 usine 关键 字 的 使 用 情况 的 段落 有 个 例 
外 ， 也 能 适用 于 这 里 。 在 DESCRIBE 语句 中 ， 如 果 使 用 了 into 关键 字 ， 则 DESCRIPTOR 关键 
字 完 全 省 略 。 


EXEC SQL DESCRIBE prepared_statement INTO mysqlda; 


使 用 SQLDA 程 序 流 是 : 

1. 准 各 一 个 查询 ， 并 且 为 它 声明 一 个 游标 。 

2. 为 结果 行 声明 SQLDA。 

3. 为 输入 参数 声明 SQLDA， 并 且 初 始 化 它们 (内 存 分 配 ， 参 数 设置 )。 
4. 打开 具有 输入 SQLDA 的 游标 

5， 从 游标 中 抓 取 行 ， 并 且 将 它们 存储 到 输出 SQLDA 中 。 

6 从 输出 SQLDA 中 读 取 值 到 宿主 变量 中 (如 果 有 必要 使 用 转换 )。 

7. 关闭 游标 。 

8 自由 内 存 区 域 分 配给 输入 SQLDA。 


33.7.2.1. SQLDA 数 据 结构 

SQLDA 使 用 三 个 数据 结构 类 型 : sqldat ， sqlvar_t ,和 struct sqlname o 
Tip: PostgreSQL 的 SQLDA 与 IBM DB2 通 用 数据 库 中 的 一 个 有 类 似 的 数据 结构 。 所 以 
DB2 的 SQLDA 上 的 一 些 技术 信息 可 以 更 好 的 帮助 理解 PostgreSQL 的 。 

33.7.2.1.1. sqlda_t 结构 


结构 类 型 sqlda_t 是 实际 SQLDA 的 类 型 。 它 拥有 一 条 记录 。 并 且 在 链表 中 使 用 desc next F 
段 指针 可 以 连接 两 个 或 更 多 个 sqldat 结构 ， 因此 代表 行 的 有 序 集合 。 因 此 ， 当 抓 取 两 个 或 
更 多 行 时 ， 应 用 程序 通过 每 个 sqldat 节点 随后 desc_next 指针 可 以 读 取 它 们 。 


sqlda t 的 定义 是 : 


struct sqlda_struct 


{ 
char sqldaid[8]; 
long sqldabc; 
short sqln; 
short sqld; 
struct sqlda_struct *desc_next; 
struct sqlvar_struct sqlvar[1]; 
J; 


typedef struct sqlda_struct sqlda_t; 


该 字段 的 意思 是 : 

sqldaid 

它 包 含 文本 字符 串 "sQLDA " o 
sqldabc 

它 包 含 字 节 中 分 配 空 间 的 大 小 。 
sqin 


它 包含 一 个 参数 化 查询 的 情况 下 的 输入 参数 数 ， 使 用 usins 关键 字 被 传递 给 oPEN , 
DECLARE 或 者 EXECUTE 语句 。 在 这 种 情况 下 它 被 作为 SELECT, EXECUTE 或 者 FETCH 语句 的 
输出 使 用 。 它 的 值 和 sald 语句 是 一 样 的 。 


sqld 
它 包含 结果 集中 的 字段 数量 。 
desc_next 


如 果 查 询 返 回 多 条 记录 ， 那 么 返回 多 个 链接 SQLDA 结 构 ， 并 且 desc_next 持 有 指向 列表 中 下 
一 项 的 指针 。 


sqlvar 


这 是 结构 集中 列 数组 。 


33.7.2.1.2. sqlvar_t 结 构 
结构 类 型 sqlvar_t 持 有 列 值 和 元 数据 比如 类 型 和 长 度 。 该 类 型 的 定义 是 : 


struct sqlvar_struct 


{ 
short sqltype; 
short sqllen; 
char *sqldata; 
short *sqlind; 
struct sqlname sqliname; 
J; 


typedef struct sqlvar_struct sqlvar_t; 


该 字段 的 含义 是 : 

sqltype 

包含 该 字段 的 类 型 标识 符 。 对 于 该 值 ， 参 阅 ecpgtype.h 中 的 enum EcPGttype o 
sqllen 

包含 该 字段 的 二 进 制 长 度 。 比 如 4 字 节 的 Ecp6t_int o 


sqldata 


指向 该 数据 。 关 于 数据 的 格式 在 Section 33.4.4 中 描述 。 


sqlind 
指向 空 指示 器 。 0 表示 非 空 ， -1 表示 空 。 


sqiname 


该 字段 名 称 。 


33.7.2.1.3. struct sqlname 结 构 
struct sqlname 结构 持 有 列 名 。 CFA sqlvar t 结构 成 员 被 使 用 。 该 结构 定义 是 : 


#define NAMEDATALEN 64 


struct sqlname 


{ 
short length; 
char data[NAMEDATALEN ] ; 
J}; 
该 字段 含义 是 
length 
包含 该 字段 名 长 度 。 
data 
包含 实际 字段 名 。 


33.7.2.2. 使 用 SQLDA 检 索 结 果 集 
通过 SQLDA 检 索 查询 结果 集 的 一 般 步 又 是 : 

1. 声明 sqlda_t 结构 用 来 接收 结果 集 。 

2. 执行 FETCH / EXECUTE / DESCRIBE 命令 用 来 处 理 指定 已 声明 SQLDA 的 查询 。 


3. 通过 查看 sqan 检查 结果 集中 的 记录 数 ， sqlda_t 结构 成 员 。 


4. 从 sqlvar[o] , sqlvar[1] 等 中 获得 每 列 的 值 ， sqlda_t 结构 成 员 

5. 通过 desc_next 指针 转 到 下 一 行 ( sqlda_t 结构 )， sqldat 结构 成 员 。 
6. 你 需要 重复 以 上 步骤 

这 是 一 个 通过 SQLDA 检 索 结 果 集 的 例子 。 


首先 ， 声 明 一 个 sqlda_t 结构 以 接收 结果 集 。 


sqlda_t *sqlda1; 


接 下 来 ， 在 命令 中 声明 SQLDA。 这 是 FETcH 命令 实例 。 


EXEC SQL FETCH NEXT FROM cur1 INTO DESCRIPTOR sqldai; 


在 链接 表 后 运行 循环 以 检索 行 。 
sqlda_t *cur_sqlda; 
for (cur_sqlida = sqldai; 


cur_sqlda != NULL; 
cur_sqlda = cur_sqlda->desc_next) 


在 循环 中 ， 运 行 另外 一 个 循环 以 检索 行 中 的 每 列 数据 〈 sqlvar_t 结构 ) 。 


for (i = 0; i < cur_sqlda->sqld; i++) 


{ 
sqlvar_t v = cur_sqlda->sqlvar[i]; 
char *sqldata = v.sqldata; 
short sqllen = v.sqllen; 

} 


为 了 得 到 列 值 ， 检 查 sqltype Mi, salvar_t 结构 成 员 。 然 后 ， 切换 适当 方式 ， 依 赖 于 列 类 


型 ， 从 宿主 变量 sqlvar 字段 拷贝 数据 。 


char var_buf[1024]; 


switch (v.sqltype) 
{ 
case ECPGt_char: 
memset(&var_buf, 0, sizeof(var_buf)); 
memcpy(&var_buf, sqldata, (sizeof(var_buf) <= sqllen ? sizeof(var_buf) - 1 : sqll 
break; 


case ECPGt_int: /* integer */ 
memcpy(&intval, sqldata, sqllen); 
snprintf(var_buf, sizeof(var_buf), "%d", intval); 
break; 





33.7.2.3. 使 用 SQLDA 传 递 查 询 参 数 


使 用 SQLDA 传 递 输入 参数 给 预备 查询 的 一 般 步 骤 是 : 
1. 创建 预备 查询 (预备 语句 ) 

2， 作 为 输入 SQLDA 声 明 sqlda_t 结 构 。 

3. 为 了 输入 SQLDA 分 配 内 存 区 域 (作为 sqlda_t 结 构 )。 
4. 在 已 分 配 内 存 中 设置 (拷贝 ) 输入 值 。 

5， 打 开具 有 声明 输入 SQLDA 的 游标 。 

这 有 个 例子 。 

首先 ， 创 建 一 个 预备 语句 。 


EXEC SQL BEGIN DECLARE SECTION; 
char query[1024] = "SELECT d.oid, * FROM pg_database d, pg_stat_database s WHERE d.oid = 
EXEC SQL END DECLARE SECTION; 


EXEC SQL PREPARE Stmt1 FROM :query; 
EE 


下 一 步 ， 为 SQLDA 分 配 内 存 ， 并 且 在 sqln 中 设置 输入 参数 数 ， sqlda_t 结构 成 员 变 量 。 当 
预备 查询 需要 两 个 或 更 多 个 输入 参数 的 时 候 ， 应 用 程序 必须 分 配额 外 内 存 空间 ， 它 是 通过 (nr. 
of params - 1) * sizeof(sqlvar ti) 计算 的 。 这 里 显示 的 是 为 两 个 输入 参数 分 配 内 存 空间 的 例 

子 。 





sqlda_t *sqlda2; 


sqlda2 = (sqlda_t *) malloc(sizeof(sqlda_t) + sizeof(sqlvar_t)); 
memset(sqlda2, ©, sizeof(sqlda_t) + sizeof(sqlvar_t)); 


sqlda2->sqln = 2; /* number of input variables */ 


内 存 分 配 后 ， 存 储 参 数值 到 sqlvar[] 数组 。 ( 当 该 SQLDA 正 在 接收 结果 集 时 ， 这 是 用 于 检 
索 列 值 的 相同 数组 。 ) 在 这 个 例子 中 ， 输入 参数 是 有 字符 串 类 型 的 "postgres" , 以 及 有 整 
数 类 型 的 1 。 


sqlda2->sqlvar[0].sqltype = ECPGt_char; 
sqlda2->sqlvar[0].sqldata = "postgres"; 
sqlda2->sqlvar[0].sqllen = 8; 

int intval = 1; 
sqlda2->sqlvar[1].sqltype ECPGt_int; 


sqlda2->sqlvar[1].sqldata = (char *) &intval; 
sqlda2->sqlvar[1].sqllen = sizeof(intval); 


打开 游标 并 且 声明 事先 准 各 的 SQLDA， 将 输入 参数 传递 给 预备 语句 。 


EXEC SQL OPEN cur1 USING DESCRIPTOR sqlda2; 


最 后 ， 使 用 输入 SQLDA 之 后 ， 必 须 显 式 释放 已 分 配 内 存 空 间 ， 不 像 用 于 接收 查询 结果 的 
SQLDA。 


free(sqlda2); 


33.7.2.4. 使 用 SQLDA 示 例 应 用 程序 
这 是 一 个 示例 程序 ， 描 述 了 如 何 获取 数据 库 访问 统计 ， 通 过 输入 参数 声明 ， 来 自 系统 表 。 


这 个 应 用 程序 连接 两 个 系统 表 ， 数 据 库 OID 上 的 pg_database 和 pg _stat_database, # Hit 
取 、 显 示 由 两 个 输入 参数 ( postgres 和 OID 1) 检索 的 数据 库 统计 。 


首先 ， 为 输入 声明 SQLDA， 以 及 为 输出 声明 SQLDA。 


EXEC SQL include sqlda.h; 


* 


sqlda_t *sqldai; /* 输 出 描述 符 */ 
sqlda_t *sqlda2; /* 输 入 描述 符 */ 


> y D ` + 和 ` = ` = 
下 一 步 ， 连 接 数 据 库 ， 准 备 语句 ， 并 且 为 预备 语句 声明 游标 。 

Int 

main(void) 
EXEC SQL BEGIN DECLARE SECTION; 
char query[1024] = "SELECT d.oid,* FROM pg_database d, pg_stat_database s WHERE d.oid 
EXEC SQL END DECLARE SECTION; 
EXEC SQL CONNECT TO testdb AS con1 USER testuser; 


EXEC SQL PREPARE Stmt1 FROM :query; 
EXEC SQL DECLARE Cur1 CURSOR FOR stmt1; 








接 下 来 ， 为 输入 参数 将 一 些 值 放 在 输入 SQLDA 中 。 为 输入 SQLDA 分 配 内 存 ， 并 且 设 置 输入 
参数 数 到 sqln 。 存 储 类 型 ， 值 以 及 值 长 度 到 sqltype ， sqldata 中 ， FHA sqllen 放 
在 sqlvar 结构 中 。 


/* 为 输入 参数 创建 SQLDA 结 构 */ 
sqlda2 = (sqlda_t *) malloc(sizeof(sqlda_t) + sizeof(sqlvar_t)); 
memset(sqlda2, 0, sizeof(sqlda_t) + sizeof(sqlvar_t)); 
sqlda2->sqin = 2; /* 输 入 变量 数 */ 
sqlda2->sqlvar[0].sqltype = ECPGt_char; 
sqlda2->sqlvar[0].sqldata = "postgres"; 
sqlda2->sqlvar[0].sqllen = 8; 
intval = 1; 
sqlda2->sqlvar[1].sqltype = ECPGt_int; 


sqlda2->sqlvar[1].sqldata = (char *)&intval; 
sqlda2->sqlvar[1].sqllen = sizeof(intval); 


在 建立 输入 SQLDA 后 ， 打 开具 有 输入 SQLDA 的 一 个 游标 。 


/* 打 开具 有 输入 参数 的 游标 。*/ 


EXEC SQL OPEN curi USING DESCRIPTOR sqlda2; 


从 已 打开 的 游标 中 读 取 行 到 输出 SQLDA。 (一 般 来 说 ， 你 必须 在 循环 中 反复 调用 FETCH 
了 读 取 结 果 集 中 的 所 有 行 。) 


` 
‘ 
> 


while (1) 
sqlda_t *cur_sqlda; 
/分 配 描述 符 给 游标 */ 


EXEC SQL FETCH NEXT FROM curi INTO DESCRIPTOR sqldai; 


接 下 来 ， 从 SQLDA 中 检索 已 读 取 记录 ， 通 过 下 面 sqlda_t 结构 中 的 连接 表 。 


for (cur_sqlda = Sqldal ; 
cur_sqlda != NULL ; 
cur_sqlda = cur_sqlda->desc_next) 


读 取 第 一 条 记录 中 的 每 一 列 。 列 数 被 存储 在 sqld 中 ， 第 一 列 的 实际 数据 被 存储 
在 sqlvar[0] ， sqlda_t 结构 的 两 个 成 员 中 。 


/* 输出 行 中 每 一 列 */ 


f 
{ 


or (i = 0; i < sqldai->sqld; i++) 


sqlvar_t v = sqldai->sqlvar[i]; 
char *sqldata = v.sqldata; 
short sqllen = v.sqllen; 


strncpy(name_buf, v.sqlname.data, v.sqlname.length); 
name_buf[v.sqlname.length] = '\0'; 


目前 ， 该 列 数 据 被 存储 在 变量 v 中 。 持 贝 每 个 数据 到 宿主 变量 ， 为 了 列 类 型 查 
看 v.sqltype o 


E nan rh 


switch (v.sqltype) { 
int intval; 
double doubleval; 
unsigned long long int longlongval; 


case ECPGt_char: 
memset (&var_buf, ©, sizeof(var_buf)); 
memcpy(&var_buf, sqldata, (sizeof(var_buf) <= sqllen ? sizeof(var_buf 
break; 


case ECPGt_int: /* integer */ 
memcpy(&intval, sqldata, sqllen); 


snprintf(var_buf, sizeof(var_buf), "%d", intval); 
break; 


default: 


} 


printf("%s = %s (type: %d)\n", name_buf, var_buf, v.sqltype); 





在 处 理 完 所 有 记录 之 后 关闭 游标 ， 并 且 断 开 数 据 库 连 接 。 


EXEC SQL CLOSE curi,; 
EXEC SQL COMMIT; 


EXEC SQL DISCONNECT ALL; 


在 Example 33-1 中 显示 了 整个 程序 。 


Example 33-1. SQLDA 程 序 示例 


#include 
#include 
#include 
#include 
#include 


<stdlib.h> 
<string.h> 
<stdlib.h> 
<stdio.h> 

<unistd.h> 


EXEC SQL include sqlda.h; 


sqlda_t *sqldai; /* 输 出 描述 符 */ 
sqlda_t *sqlda2; /* 输 入 描述 符 */ 


* 


EXEC SQL WHENEVER NOT FOUND DO BREAK; 
EXEC SQL WHENEVER SQLERROR STOP; 


int 
main(void) 
{ 
EXEC SQL BEGIN DECLARE SECTION; 
char query[1024] = "SELECT d.oid,* FROM pg_database d, pg_stat_database s WHERE d.oid 


int intval; 

unsigned long long int longlongval; 

EXEC SQL END DECLARE SECTION; 

EXEC SQL CONNECT TO uptimedb AS coni USER uptime; 


EXEC SQL PREPARE Stmt1 FROM :query; 
EXEC SQL DECLARE cur1 CURSOR FOR stmti; 


/* 为 输入 参数 创建 SQLDA 结 构 */ 
sqlda2 = (sqlda_t *)malloc(sizeof(sqlda t) + sizeof(sqlvar_t)); 
memset(sqlda2, 0, sizeof(sqlda_t) + sizeof(sqlvar_t)); 


sqlda2->sqln = 2; /* a number of input variables */ 


sqlda2->sqlvar[0].sqltype ECPGt_char; 


sqlda2->sqlvar[0].sqldata = "postgres"; 
sqlda2->sqlvar[0].sqllen = 8; 

intval = 1; 

sqlda2->sqlvar[1].sqltype ECPGt_int; 


sqlda2->sqlvar[1].sqldata = (char *) &intval; 
sqlda2->sqlvar[1].sqllen = sizeof(intval); 


/* 打 开具 有 输入 参数 的 游标 */ 
EXEC SQL OPEN curi USING DESCRIPTOR sqlda2; 


while (1) 


{ 
sqlda_t *cur_sqlda; 


/* 分 配 描述 符 给 游标 */ 
EXEC SQL FETCH NEXT FROM curi INTO DESCRIPTOR sqlda1; 


for (cur_sqlda = 
cur_sqlda != NULL ; 
cur_sqlda = 


int i; 
char name_buf[1024]; 
char var_buf[1024]; 


/* 输 出 行 中 每 一 列 */ 
for (i=0 ; i<cur_sqlda->sqld ; i++) 
sqlvar_t v = cur_sqlda->sqlvar[i]; 
char *sqldata = v.sqldata; 
short sqllen = v.sqllen; 


strncpy(name_buf, v.sqiname.data, v.sqiname.length); 
name_buf[v.sqiname.length] = '\0'; 


switch (v.sqltype) 
{ 
case ECPGt_char: 
memset(&var_buf, 0, sizeof(var_buf)); 
memcpy(&var_buf, sqldata, (sizeof(var_buf)<=sqllen ? sizeof(var_b 
break; 


case ECPGt_int: /* integer */ 
memcpy(&intval, sqldata, sqllen); 


snprintf(var_buf, sizeof(var_buf), "%d", intval); 
break; 


case ECPGt_long_long: /* bigint */ 
memcpy(&longlongval, sqldata, sqllen); 
snprintf(var_buf, sizeof(var_buf), "%lld", longlongval); 
break; 


default: 
U ami 
int i; 
memset(var_buf, ©, sizeof(var_buf)); 
for (i = 0; i < sqllen; i++) 
{ 
char tmpbuf[16]; 
snprintf(tmpbuf, sizeof(tmpbuf), "%02x ", (unsigned char) sql 
strncat(var_buf, tmpbuf, sizeof(var_buf)); 


} 


break; 


} 


printf("%s = %s (type: %d)\n", name_buf, var_buf, v.sqltype); 
} 


printf("\n"); 


} 


EXEC SQL CLOSE curi,; 
EXEC SQL COMMIT; 


EXEC SQL DISCONNECT ALL; 


return 0; 


} 
-| na: 
该 例子 输出 应 该 看 起 来 像 下 面 这 样 (一 些 数字 有 所 不 同 ) 。 





oid = 1 (type: 1) 

datname = templatei1 (type: 1) 
datdba = 10 (type: 1) 

encoding = 0 (type: 5) 
datistemplate = t (type: 1) 
datallowconn t (type: 1) 
datconnlimit -1 (type: 5) 
datlastsysoid = 11510 (type: 1) 
datfrozenxid = 379 (type: 1) 
dattablespace = 1663 (type: 1) 
datconfig = (type: 1) 

datacl = {=c/uptime, uptime=CTc/uptime} (type: 1) 
datid = 1 (type: 1) 

datname = template1 (type: 1) 
numbackends = © (type: 5) 
xact_commit = 113606 (type: 9) 
xact_rollback = 0 (type: 9) 
blks_read = 130 (type: 9) 
blks_hit = 7341714 (type: 9) 
tup_returned = 38262679 (type: 9) 
tup_fetched = 1836281 (type: 9) 
tup_inserted = 0 (type: 9) 
tup_updated © (type: 9) 
tup_deleted 9 (type: 9) 


oid = 11511 (type: 1) 

datname = postgres (type: 1) 
datdba = 10 (type: 1) 

encoding = 0 (type: 5) 
datistemplate = f (type: 1) 
datallowconn t (type: 1) 
datconnlimit -1 (type: 5) 
datlastsysoid = 11510 (type: 1) 
datfrozenxid = 379 (type: 1) 
dattablespace = 1663 (type: 1) 
datconfig = (type: 1) 

datacl = (type: 1) 

datid = 11511 (type: 1) 

datname = postgres (type: 1) 
numbackends = © (type: 5) 
xact_commit = 221069 (type: 9) 
xact_rollback = 18 (type: 9) 
blks_read = 1176 (type: 9) 
blks_hit = 13943750 (type: 9) 
tup_returned = 77410091 (type: 9) 
tup_fetched = 3253694 (type: 9) 
tup_inserted = 0 (type: 9) 
tup_updated © (type: 9) 
tup_deleted © (type: 9) 


33.8. 错误 处 理 

本 节 描 述 了 如 何 义理 异 常情 况 以 及 嵌入 SQL 程序 的 警告 。 有 两 个 非 排他 性 功能 可 以 解决 。 
。 配置 回调 用 来 处 理 警 告 以 及 使 用 whENEVER 命令 处 理 错 误 条 件 。 
° 关于 错误 或 者 警告 的 详细 信息 可 以 从 sqlca 变量 中 获得 。 

33.8.1. 设置 回调 


当 产 生 特 定 条 件 时 ， 捕 获 错 误 和 警告 的 一 个 简单 方法 是 设置 一 个 要 执行 的 具体 操作 。 通 


dk 


EXEC SQL WHENEVER _condition_ _action_; 


_condition 可 以 是 下 列 之 一 : 

SQLERROR 

当 在 SQL 语句 执行 期 间 发 生 错 误 时 ， 调 用 指定 操作 。 
SQLWARNING 

当 在 SQL 语句 执行 期 间 发 生 和 警告 时 ， 调 用 指定 操作 。 


NOT FOUND 


当 SQL 语 句 检 索 或 者 影响 需 行 ， 则 调用 指定 操作 。 (这 个 条 件 不 是 错误 ， 但 是 你 可 能 对 特意 
处 理 它 感 兴趣 。) 


_action 可 以 是 下 列 之 一 : 

CONTINUE 

这 实际 上 意味 着 该 条 件 被 忽略 。 这 是 缺 省 的 。 

GOTO _label_~°GO TO  _ label 

跳 转 到 指定 标签 〈 使 用 C goto 语句 ) o 

SQLPRINT 

输出 标准 错误 信息 。 这 对 于 简单 程度 或 者 原型 期 间 非 常 有 用 。 不 能 配置 该 信息 的 详细 信息 。 
STOP 


调用 exit(1) ， 这 将 终止 程序 。 


DO BREAK 


执行 C 语 句 break 。 这 只 有 在 循环 中 或 者 switch 语句 中 使 用 。 


CALL name ( args ) DO name ( args ) 








调用 具有 指定 参数 的 指定 C 函 数 。 
SQL 标准 仅仅 提供 continue 和 coro (和 co To ) 操作 。 


下 面 是 一 个 你 可 能 想 在 简单 程序 中 使 用 的 例子 。 当 发 生 警 告 以 及 发 生 错误 终止 程序 时 ， CH 
出 一 个 简单 消息 : 


EXEC SQL WHENEVER SQLWARNING SQLPRINT,; 
EXEC SQL WHENEVER SQLERROR STOP; 


语句 EXEC SQL WHENEVER 是 SQL 预 处 理 器 的 指 合 。 而 不 是 C 语 句 。 错误 或 者 警告 操作 设置 义理 
器 出 现 的 地 方 中 适 用 的 所 有 嵌入 SQL 语句 。 除非 在 第 一 个 EXEC SQL whENEVER 和 产生 条 件 的 
SQL 语句 之 间 为 同一 条 件 设 置 不 同 的 操作 ， 不 管 C 程 序 中 的 控制 流 。 所 以 下 面 两 个 C 程 序 片 
段 都 不 会 产生 期 望 效果 : 


if 
* WRONG 
hh 
int main(int argc, char *argv[]) 
{ 
if (verbose) { 
EXEC SQL WHENEVER SQLWARNING SQLPRINT; 
} 
EXEC SQL SELECT ...; 
} 
ffx 
* WRONG 
Wh 
int main(int argc, char *argv[]) 
{ 
set_error_handler(); 
EXEC SQL SELECT ...; 
} 


static void set_error_handler (void) 


EXEC SQL WHENEVER SQLERROR STOP; 


33.8.2. sqica 


为 了 更 强大 的 错误 处 理 ， RASLO T RA FIA sqlca 〈SQL 通 信 区 ) 的 
全 局 变量 。 


struct 


{ 
char sqlcaid[8]; 
long sqlabc; 
long sqlicode; 
struct 


{ 
int sqlerrml; 
char sqlerrmc[SQLERRMC_LEN]; 
} sqlerrm; 
char sqlerrp[8]; 
long sqlerrd[6]; 
char sqlwarn[8]; 
char sqlstate[5]; 
} sqlca; 


(在 一 个 多 线程 程序 中 ， 每 一 个 线程 自动 获取 sqlca 的 拷贝 。 该 工作 类 似 于 标准 C 全 局 变 
量 errno 的 处 理 。) 


sqlca 涵盖 警告 和 错误 。 如 果 在 语句 执行 期 间 发 生 多 个 警告 和 错误 ， 那 么 sqlca 将 只 包含 最 
后 一 个 信息 。 


如 果 在 最 后 SQL 语句 没有 发 生 错 误 ， 则 sqlca.sqlcode HO, sqlca.sqlstate 是 "00000" 。 
如 果 发 生 了 警告 或 者 错误 ， 那么 sqlca.sqlcode 是 负数 并 且 sqica.sqlstate 不 同 于 
"00000" o IER sqica.sqlicode 表示 无 害 条 件 ， 比如 最 后 查询 返回 才 行 。 

sqlcode 和 sqlstate 是 两 个 不 同 的 错误 编码 方案 ; 详情 如 下 。 


如 果 最 后 一 个 SQL 语句 成 功 了 ， 那 么 sqlca.sqlerrd[1] 包含 处 理 行 的 OID， 如 果 适 用 ， 
W] sqlca.sqlerrd[2] 包含 处 理 或 返回 行 的 行 数 ， 如 果 适 用 该 命令 。 


在 错误 或 警告 的 情况 下 ， sqlca.sqlerrm.sqlerrmc 将 包含 描述 错误 的 字符 串 。 字 

FR sqica.sqlerrm.sqlerrml 包含 存储 在 sqica.sqlerrm.sqlerrmc ( strlen() 的 结果 ， C 程 序 
员 不 感 兴 趣 ) 中 的 错误 信息 。 注意 一 些 消息 太 长 而 不 适合 固定 大 小 的 sqlerrmc 数组 ; 它们 
将 被 截断 。 


在 一 个 警告 的 情况 下 ， sqlca.sqlwarn[2] 设置 为 wo (在 所 有 其 他 情况 下 ， 它 被 设置 为 不 同 
Fw 的 东西 。) WR sqlca.sqlwarn[1] 被 设置 为 w ， 那 么 一 个 值 被 存储 在 宿主 变量 的 时 
候 ， 截 断 它 。 如 果 任 何其 他 元 素 设置 为 显示 一 个 警告 ， 则 sqlca.sqlwarn[o] 设置 为 w。 


字段 Sqlcaid , sqlcabc ， sqlerrp ， 以 及 Sqlerrd 和 sqlwarn 的 剩余 元 素 目前 没有 任何 有 
用 信息 。 

在 SQL 标准 中 没有 定义 结构 sqlca ， 但 是 在 其 他 几 个 SQL 数 据 库 系统 中 实现 了 。 定 义 核心 是 
相似 的 ， 但 是 如 果 你 想 要 编写 可 移植 应 用 程序 ， 那 么 你 应 该 仔细 调查 不 同 的 实现 。 


这 是 一 个 结合 WHENEVER 和 sqlca 的 使 用 的 例子 ， 当 发 生 错 误 时 ， 输 出 sqlca 的 内 容 。 在 安 
oe 


J 


装 更 多 "user-friendly" 错 误 处 理 程序 之 前 ， 这 可 能 用 于 调试 或 者 原型 应 用 。 


EXEC SQL WHENEVER SQLERROR CALL print_sqlca(); 


void 
print_sqlca() 
{ 


fprintf(stderr, "==== sqlca ====\n"); 

fprintf(stderr, "sqlcode: %ld\n", sqlca.sqlcode); 

fprintf(stderr, "sqlerrm.sqlerrml: %d\n", sqlca.sqlerrm.sqlerrml); 

fprintf(stderr, "sqlerrm.sqlerrmc: %s\n", sqlca.sqlerrm.sqlerrmc) ; 

fprintf(stderr, "sqlerrd: %ld %ld %ld %ld %ld %ld\n", sqlica.sqlerrd[0],sqlca.sqlerrd[ 
sqica.sqlerrd[3],sqlca.sqlerrd[ 

fprintf(stderr, "sqlwarn: %d %d %d %d %d %d %d %d\n", sqlca.sqlwarn[0], sqlca.sqlwarn 
sqica.sqlwarn[3], sqlca.sqlwarn 
sqica.sqlwarn[6], sqlca.sqlwarn 

fprintf(stderr, "sqlstate: %5s\n", sqlca.sqlstate); 

fprintf(stderr, il) 





结果 可 能 如 下 所 示 (这 里 错误 为 因 于 表 名 字 拼 写 错误 


会 三 三 三 sqlca ===> 

sqlcode: -400 

sqlerrm.sqlerrml: 49 

sqlerrm.sqlerrmc: relation "pg_databasep" does not exist on line 38 
sqlerrd: 000000 

sqlwarn: 00000000 

sqlstate: 42P01 


33.8.3. SQLSTATE VS. SQLCODE 


字段 sqlca.sqistate 和 sqlca.sqlcode 是 提供 错误 码 的 两 个 不 同 模式 。 两 者 来 自 SQL 标 准 ， 
但 是 saLcopE 在 标准 SQL-92 版 本 中 已 经 过 时 ， 并 且 在 后 期 版 本 中 已 经 记 除 。 因 此 ， 强烈 建 
议 新 应 用 使 用 sQLsTATE o 


SQLSTATE 是 五 字符 数组 。 五 字符 包含 数字 或 者 表示 不 同 错误 和 警告 条 件 代 码 的 大 写字 母 。 
SQLSTATE 有 一 个 分 层 模式 : 前 两 个 字符 表示 条 件 的 一 般 类 ， 最 后 三 个 字符 表示 一 般 条 件 的 子 
类 。 通过 代码 o0o000 表示 成 功 状态 。 sarstate 代码 是 SQL 标准 中 定义 最 多 部 分 。 
PostgreSQL 服 务 器 本 地 支持 sQLsTATE 错误 代码 ; 因此 通过 在 所 有 应 用 程序 中 使 用 该 错误 代 
码 方案 实现 高 度 一 致 性 。 更 多 信息 参阅 Appendix A. 


SQLCODE ， 已 废弃 的 错误 编码 方案 ， 是 一 个 简单 的 integer。 0 值 表 示 成 功 ， 正 值 表 示人 额外 信息 
成 功 ， 负 值 表 示 错 误 。 SQL 标准 仅仅 定义 正 值 +100， 这 表示 返回 最 后 命令 或 者 影响 需 行 ， 并 
且 没有 明确 负 值 。 因 此 ， 该 方案 实现 差 的 移植 性 ， 而 且 没有 分 层 编 码 安 排 。 从 历史 角度 ， 
PostgreSQL 刻 入 的 SQL 预 义理 器 为 它 的 使 用 分 配 了 一 些 指定 soLcopE 。 使 用 数值 和 符号 名 
称 将 它 列 在 下 面 。 记 住 这 些 是 不 能 移植 到 其 他 SQL 实现 的 。 为 了 简化 应 用 程序 移植 

到 sostare 方案 ， 相 应 的 sQLsTATE 也 被 列 出 来 。 然 而 ， 在 两 个 方案 (实际 上 是 多 对 多 ) 之 
间 没 有 一 对 一 或 者 一 对 多 映射 ， 因此 在 每 种 情况 下 你 应 该 咨询 列 在 Appendix A 中 的 全 


EK SQLSTATE o 


这 些 是 已 分 配 的 sQLcopE 值 : 

O ( ECPG_NO_ERROR ) 

表明 没有 错误 。(SQLSTATE 00000) 

100 ( ECPG_NOT_FOUND ) 

这 是 无 害 条 件 表明 检索 最 后 一 条 命 命 或 者 处 理 需 行 ， 或 者 你 在 游标 结尾 。(SQLSTATE 02000) 
当 在 循环 中 处 理 游标 时 ， 你 可 以 使 用 该 代码 作为 检测 什么 时 候 终 止 循环 的 方式 ， 像 这 样 : 


while (1) 


EXEC SQL FETCH ... ; 
if (sqlca.sqlcode == ECPG_NOT_FOUND) 
break; 


但 是 WHENEVER NOT FOUND DO BREAK 有 效 的 内 部 执行 这 个 ， 因 此 在 明确 写 这 个 时 通常 没有 优 


Fo 
-12 ( ECPG_OUT_OF_MEMORY ) 
表明 耗 尽 了 你 的 虚拟 内 存 。 作 为 -ENoMEM 定义 该 数值 。 (SQLSTATE YEOO1) 
-200 ( ECPG_UNSUPPORTED ) 


表明 预 处 理 器 产生 了 该 库 不 知道 的 一 些 未 西 。 可 能 你 正在 该 预 处 理 器 和 该 库 不 兼容 版 本 上 运 
行 。(SQLSTATE YE002) 


-201 ( ECPG_TOO_MANY_ARGUMENTS ) 

这 意味 着 指定 命令 比 期 望 命令 宿主 变量 更 多 。(SQLSTATE 07001 或 者 07002) 
-202 ( ECPG_TOO_FEW_ARGUMENTS ) 

这 意味 着 指定 命令 比 期 望 命令 宿主 变量 更 少 。(SQLSTATE 07001 或 者 07002) 
-203 ( ECPG_TOO_MANY_MATCHES ) 


这 意味 着 查询 返还 多 行 但 是 语句 只 准备 存储 一 个 结果 行 〈 比 如 ， 因为 指定 变量 不 是 数组 ) 。 
(SQLSTATE 21000) 


-204 ( ECPG_INT_FORMAT ) 


宿主 变量 是 类 型 int ， 并 且 数 据 库 中 数据 是 不 同类 型 ， 而 且 包含 不 能 解释 为 int 类 型 的 值 。 
为 这 种 转换 该 库 使 用 strtol() 。(SQLSTATE 42804) 


-205 ( ECPG_UINT_FORMAT ) 


宿主 变量 是 类 型 无 符号 int ， 并 且 数 据 库 中 数据 是 不 同类 型 ， 而 且 包含 不 能 解释 
为 无 符号 int 类 型 的 值 。 为 这 种 转换 该 库 使 用 strtoul() o (SQLSTATE 42804) 


-206 ( ECPG_FLOAT_FORMAT ) 


宿主 变量 是 类 型 float ， 并 且 数 据 库 中 数据 是 另 一 种 类 型 ， 而 且 包含 不 能 解释 为 float 类 型 
的 值 。 为 这 种 转换 该 库 使 用 strtod() 。(SQLSTATE 42804) 


-207 ( ECPG_NUMERIC_FORMAT ) 


宿主 变量 是 类 型 numeric ， 并 且 数 据 库 中 数据 是 另 一 种 类 型 ， 而 且 包含 不 能 解释 
A numeric 类 型 的 值 。(SQLSTATE 42804) 


-208 ( ECPG_INTERVAL_FORMAT ) 


宿主 变量 是 类 型 interval ， 并 且 数 据 库 中 数据 是 另 一 种 类 型 ， 而 且 包含 不 能 解释 
为 interval 类 型 的 值 。(SQLSTATE 42804) 


-209 ( ECPG_DATE_FORMAT ) 


宿主 变量 是 类 型 date ， 并 且 数 据 库 中 数据 是 另 一 种 类 型 ， 而 且 包含 不 能 解释 为 date 类 型 的 
值 。(SQLSTATE 42804) 


-210 ( ECPG_TIMESTAMP_FORMAT ) 


宿主 变量 是 类 型 timestamp ， 并 且 数 据 库 中 数据 是 另 一 种 类 型 ， 而 且 包含 不 能 解释 
为 timestamp 类 型 的 值 。(SQLSTATE 42804) 


-211 ( ECPG_CONVERT_BOOL ) 


这 意味 着 宿主 变量 是 类 型 bool ， 并 且 数 据 库 中 数据 既 不 是 't' 也 不 是 'f' o (SQLSTATE 
42804) 


-212 ( ECPG_EMPTY ) 


发 送 到 PostgreSQL 服 务 器 的 语句 是 空 的 。 (KHPRAREARASOLERH, ALC TRE 
指向 一 个 内 部 错误 。) (SQLSTATE YE002) 


-213 ( ECPG_MISSING_INDICATOR ) 

返回 一 个 空 值 ， 而 且 没有 提供 空 指 示 符 变量 。(SQLSTATE 22002) 
-214 ( ECPG_NO_ARRAY ) 

一 个 普通 变量 被 用 于 需要 数组 的 地 方 。(SQLSTATE 42804) 
-215 ( ECPG_DATA_NOT_ARRAY ) 


数据 库 返 回 需要 数组 值 位 置 的 普通 变量 。(SQLSTATE 42804) 


-220 ( ECPG_NO_CONN ) 

该 程序 试图 访问 一 个 不 存在 的 连接 。(SQLSTATE 08003) 

-221 ( ECPG_NOT_CONN ) 

该 程序 试图 访问 一 个 存在 但 无 法 打开 的 连接 。 (这 是 一 个 内 部 错误 。) (SQLSTATE YEOO2) 
-230 ( ECPG_INVALID_STMT ) 

你 正 尝试 使 用 的 语句 未 准备 好 。(SQLSTATE 26000) 

-239 ( ECPG_INFORMIX_DUPLICATE_KEY ) 

重复 键 错误 ， 违 反 唯 一 约束 (Informix RAR) o (SQLSTATE 23505) 
-240 ( ECPG_UNKNOWN_DESCRIPTOR ) 

未 找到 指定 描述 符 。 你 尝试 使 用 的 语句 未 准备 好 。(SQLSTATE 33000) 
-241 ( ECPG_INVALID_DESCRIPTOR_INDEX ) 
HERRI 7 SE]. (SQLSTATE 07009) 

-242 ( ECPG_UNKNOWN_DESCRIPTOR_ITEM ) 

请 求 无 效 描述 符 项 。 (这 是 个 内 部 错误 。) (SQLSTATE YE002) 
-243 ( ECPG_VAR_NOT_NUMERIC ) 


在 动态 语句 执行 的 过 程 中 ， 数 据 库 返 回 一 个 数值 ， 但 宿主 变量 不 是 数字 的 。 (SQLSTATE 
07006) 


-244 ( ECPG_VAR_NOT_CHAR ) 


在 动态 语句 执行 的 过 程 中 ， 数 据 库 返回 一 个 非 数值 ， 但 宿主 变量 是 数字 的 。 (SQLSTATE 
07006) 


-284 ( ECPG_INFORMIX_SUBSELECT_NOT_ONE ) 

子 查询 结果 不 是 单行 〈Informix 兼 容 模式 ) o (SQLSTATE 21000) 

-400 ( ECPG_PGSQL ) 

PostgreSQL 服 务 器 产生 一 些 错误 。 包含 的 错误 消息 来 自 PostgreSQL 服 务 器 。 
-401 ( ECPG_TRANS ) 

PostgreSQL 发 出 信号 我 们 不 能 和 启动， 提交 ， 或 者 回 滚 事务 。 (SQLSTATE 08007) 


-402 ( ECPG_CONNECT ) 


尝试 与 数据 库 的 连接 没有 成 功 。(SQLSTATE 08001) 
-403 ( ECPG_DUPLICATE_KEY ) 

重复 键 错误 ， 违 反 唯 一 约束 。(SQLSTATE 23505) 
-404 ( ECPG_SUBSELECT_NOT_ONE ) 

子 查询 结果 不 是 单行 。(SQLSTATE 21000) 

-602 ( ECPG_WARNING_UNKNOWN_PORTAL ) 

指定 一 个 无 效 游标 名 。(SQLSTATE 34000) 

-603 ( ECPG_WARNING_IN_TRANSACTION ) 

事务 正在 进行 中 。(SQLSTATE 25001) 

-604 ( ECPG_WARNING_NO_TRANSACTION ) 

这 是 一 个 非 活跃 (进行 中 ) BF. (SQLSTATE 25P01) 
-605 ( ECPG_WARNING_PORTAL_EXISTS ) 


指定 一 个 已 经 存在 游标 名 。(SQLSTATE 42P03) 


33.9. RIRA TD 


可 用 的 几 种 预 处 理 器 指令， CHEK ecpg 预 处 理 器 分 析 方 式 以 及 义理 文件 方式 。 


33.9.1. BEM 
为 了 包含 一 个 外 部 文件 到 你 的 嵌入 SQL 程序 中 ， 使 用 : 


EXEC SQL INCLUDE _filename_; 
EXEC SQL INCLUDE <_filename_>; 
EXEC SQL INCLUDE "_filename_"; 


RASLA SHEA A filename HAH, 处 理 它 ， 并 且 将 它 包 含 在 产生 的 C 输 
出 中 。 因 此 ， 正 确 处 理 包含 文件 中 的 嵌入 SQL 语 句 。 
ecpg 预 处 理 器 将 按照 下 面 顺序 在 几 个 目录 中 搜索 文件 : 
。 当前 目录 
e /usr/local/include 
e PostgreSQL 包 含 目录 ， 人 在 编译 时 定义 (比如 /usr/local/pgsql/include ) 
e /usr/include 
但 是 当 使 用 EXEC SQL INCLUDE "**_filename_ "时 ， 仅 仅 搜 索 当 前 目录 。 


在 每 个 目录 中 ， 预 处 理 器 将 首先 寻找 给 定 的 文件 名 ， 如 果 没 有 找到 将 追加 .n 到 文件 名 然后 
再 次 尝试 (除非 指定 文件 名 已 经 有 这 种 后 级 ) 。 


注意 EXEC SQL INCLUDE 是 不 一 样 的 : 

#include <_filename_.h> 
因为 这 个 文件 不 受 SQL 命 令 预 处 理 的 影响 。 当 然 ， 你 可 以 继续 使 用 包含 其 他 头 文件 的 C 
#include ESD. 


Note: 包含 文件 名 大 小 写 敏 感 ， 即 使 其 余 的 exec soL INCLUDE 命令 遵循 正常 的 SQL 大 小 
写 敏 感 规则 。 


= 

















33.9.2. define#lundefis > 


类 似 于 C 中 #define HER, BARSQLA—TS FW : 


EXEC SQL DEFINE _name_; 
EXEC SQL DEFINE _name value_; 





所 以 你 可 以 定义 一 个 名 字 : 


EXEC SQL DEFINE HAVE_FEATURE; 


你 也 可 以 定义 常数 : 


EXEC SQL DEFINE MYNUMBER 12; 
EXEC SQL DEFINE MYSTRING '‘abc'; 


使 用 undef 删除 以 前 的 定义 : 


EXEC SQL UNDEF MYNUMBER ， 


24 SAAR BY LL ok 23 TERE BRA SQL HIE FACHRAR #define 和 #undef 。 不 同 的 是 你 定义 值 的 
评估 不 同 。 如 果 你 使 用 exec soL DEFINE , 那么 ecpg 预 处 理 器 评估 定义 且 蔡 换 该 值 。 比 如 如 
RRE : 


EXEC SQL DEFINE MYNUMBER 12; 


EXEC SQL UPDATE Tbl SET col = MYNUMBER; 


那么 ecpg 将 执行 蔡 换 ， 而 且 你 的 C 编 译 器 不 会 看 到 任何 名 字 或 者 标示 符 MYNUMBER o 注意 你 
不 能 为 打算 用 在 戏 入 SQL 查询 中 的 常数 使 用 #define ， 因为 在 这 种 情况 下 代入 的 SQL 预 编 译 
器 不 能 看 到 这 个 声明 。 


33.9.3. ifdef，ifndef，else，elif 和 endif 指 兮 


你 可 以 使 用 下 面 指令 有 条 件 地 编译 代码 段 : 

EXEC SQL ifdef _name_; 

如 果 _name_ 已 经 和 exec SQL define _name_ 被 创建 ， 那 么 检查 _name 并 义理 随后 行 。 
EXEC SQL ifndef _name_ ; 


如 果 _name_ 和 EXEC SQL define _name ”没有 被 创建 ， 那么 检查 _name 并 处 理 随后 行 。 


EXEC SQL else; 
开始 处 理 另 一 部 分 到 EXEC SQL ifdef _name_ 或 者 EXEC SQL ifndef _name_ 介绍 的 部 分 。 


EXEC SQL elif -_name_ ; 


如 果 _name_ 和 EXEC SQL define _name_ 已 经 被 创建 ， 那么 检查 name 并 且 开 始 另 一 部 


分 。 


EXEC SQL endif; 


结束 另 一 部 分 。 


例子 : 


EXEC 
EXEC 
EXEC 
EXEC 
EXEC 
EXEC 
EXEC 


SQL 
SQL 
SQL 
SQL 
SQL 
SQL 
SQL 


ifndef TZVAR; 

SET TIMEZONE TO 'GMT'; 
elif TZNAME; 

SET TIMEZONE TO TZNAME; 
else; 

SET TIMEZONE TO TZVAR; 
endif; 


33.10. 处 理 欺 入 的 SQL 程 序 


现在 你 已 知道 如 何 形成 刻 入 SQL C 程 序 ， 你 可 能 想 要 知道 如 何 编译 它们 。 编译 之 前 你 通过 该 
入 的 SQL C 预 处 理 器 运行 文件 ， 这 将 转换 你 用 于 特定 孙 数 调用 的 SQL 语句 。 编 译 完 之 后 ， 你 
必须 连接 包含 所 需 本 数 的 特殊 库 。 这 些 范 数 从 参数 中 抓 取信 息 ， 使 用 libpq 接 口 执行 SQL 命 
今 ， 将 结果 放 在 输出 指定 的 参数 中 。 


预 处 理 程序 被 称 为 ecpg ， 包 含 在 正常 PostgreSQL 安 装 中 。 财 入 的 SQL 程序 通常 以 扩展 
名 .pgc 命名 。 如 果 你 有 progi.pgc 程序 文件 ， 你 可 以 通过 简单 调用 义理 它 。 


ecpg prog1.pgc 
这 将 创建 名 为 prog1.c 的 文件 。 如 果 你 的 输入 文件 不 遵循 建议 的 命名 模式 ， 你 可 以 使 
用 -o 选项 明确 的 指定 输出 文件 。 


预 处 理 文件 可 以 正常 编译 ， 比 如 : 


cc -c progi.c 


生成 的 C 源 文件 包含 来 自 PostgreSQL 安 装 的 头 文件 ， 因 此 如 果 你 在 缺 省 不 被 搜索 的 地 方 安装 


PostgreSQL, AA 你 必须 添加 选项 比如 -1/usr/local/pgsql/include 到 编译 命令 行 。 


为 了 连接 人 散 入 式 SQL 程 序 ， 你 需要 包含 libecpg 库 ， 像 这 样 : 


cc -o myprog prog1.0 prog2.0 ... -lecpg 


再 次 ， 你 可 能 需要 添加 像 -L/usr/local/pgsql/1lib 到 该 命令 行 的 选项 。 
你 可 以 使 用 pg_config 或 者 pkg-config ARBE libecpg 以 获得 安装 目录 。 
如 果 你 使 用 make 管 理 大 对 象 编译 过 程 ， 它 可 能 方便 地 包含 下 面 你 的 makefiles 中 的 隐 式 规 


则 : 


ECPG = ecpg 


%.C: %.pgc 
$(ECPG) $< 


ecpg 命令 完整 语法 在 ecpg 中 有 详细 描述 。 


ecpg 库 缺 省 是 线程 安全 的 。 然 而 ， 你 可 能 需要 使 用 一 些 线程 命令 行 选 项 来 编译 你 的 客户 端 代 
码 。 


33.11. FRR 


libecpg 库 主要 包含 "隐藏 的 " 男 数 ， 它 用 于 实现 伐 入 SQL 命令 表达 的 功能 。 但 是 有 一 些 可 以 
直接 调 用 的 函数 。 注意 这 使 得 您 的 代码 可 移植 。 


e。 如 果 调 用 第 一 个 非 需 参 数 ， Ecpedebug(int on, FILE * stream ) 打开 调试 日 志 。 调试 
日 志 在 _stream_ 上 执行 。 日 志 包 含 带 有 插入 的 所 有 输 和 人 变量 的 SQL 语句 ， 以 及 来 自 
PostgreSQL 服 务 器 的 结果 。 当 搜索 SQL 语句 中 的 错误 时 ， 这 是 非常 有 用 的 。 


> Note: 在 Windows 上 ， 如 果 ecpg 库 和 应 用 程序 是 以 不 同 标识 被 编译 ， 那 么 Zw 
Aa, AA FILE 指针 内 部 表示 形式 不 同 。 特别 是 ， 多 线程 /单线 程 ， 释 放 / 调 试 ， 以 及 
静态 /动态 信号 对 于 该 库 以 及 使 用 该 库 的 所 有 应 用 程序 是 一 样 的 。 


e ECPGget_PGconn(const char * Connection_name ) 返回 由 给 定名 称 标识 的 数据 库 连 接 句 
柄 。 如 果 _connection_name_ 设置 为 NULL ， 则 返回 当前 连接 句柄 。 如 果 没 有 连接 句柄 可 
以 被 识别 ， 则 该 图 数 返回 NuLL 。 如 果 必 要 的 话 ， 返 回 的 连接 句柄 可 以 用 于 从 libpq 调 用 
RESE 


> Note: 操作 随 着 libpq 例 程 由 ecpg 直 接 组 成 的 数据 库 连 接 句柄 是 主意 。 


e EcpGtransactionstatus(const char * connection_name ) 返回 通 
过 _connection_name_ 标识 的 给 定 连接 的 当前 事务 状态 。 参阅 Section 31.2 和 libpq 
的 PQtransactionStatus() 4% 获取 关于 返 中 回 状态 码 的 详细 信息 


。 如 果 你 连接 到 一 个 数据 库 ， 
M] EcPGstatus(int /ineno , const char* connection_name ) 返回 真 ， 否 则 返回 假 。 如 
果 正 在 使 用 一 个 连接 ， W) _connection_name_ 是 NULL o 


33.12. 大 对 象 


ECPG 不 直接 支持 大 对 象 ， 但 是 ECPG 问 用 可 以 通过 libpq 大 对 象 画 数 操作 大 对 象 ， 通过 调 
用 ecpGget_PGconn() KAUA EAI Pecon 对 象 。 (然而 ， 应 该 小 心 使 

用 EcpPGget_PGconn() EX 以 及 直接 接触 pecon 对 象 ， 理 想 情 况 下 不 与 其 他 ECPG 数 据 库 访 问 
调用 混合 ) 。 

参阅 Section 33.11 获 取 关 于 eEcpcget_pcconn() 的 更 多 信息 。 关于 大 对 象 本 数 接口 的 更 多 信 
息 ， 参 阅 Chapter 32。 


在 事务 块 中 必须 调用 大 对 象 画 数 ， 因 此 当 关 闭 自动 提交 时 ， 那 么 必须 明确 发 出 BEGIN 命令 。 
Example 33-2 显 示 了 在 ECPG 应 用 中 如 何 创建 ， 写 ， 读 取 大 对 象 的 示例 程序 。 


Example 33-2. ECPG 程 序 访 问 大 对 象 


#include <stdio.h> 

#include <stdlib.h> 
#include <libpq-fe.h> 
#include <libpq/libpq-fs.h> 


EXEC SQL WHENEVER SQLERROR STOP; 


int 
main(void) 
PGconn *conn; 
Oid loid; 
int fd; 
char buf [256]; 
int buflen = 256; 
char buf2[256]; 
int rc; 


memset(buf, 1, buflen); 
EXEC SQL CONNECT TO testdb AS con1; 


conn = ECPGget_PGconn("coni"); 
printf("conn = %p\n", conn); 


人 create 
loid = lo_create(conn, 0); 
if (loid < 0) 
printf("lo_create() failed: %s", PQerrorMessage(conn) ); 


printf("loid = %d\n", loid); 
/* write test */ 
fd = lo_open(conn, loid, INV_READ|INV_WRITE); 
if (fd < 0) 
printf("lo_open() failed: %s", PQerrorMessage(conn) ); 
printf("fd = %d\n", fd); 
rc = lo_write(conn, fd, buf, buflen); 
if (rc < 0) 
printf("lo_write() failed\n"); 


rc = lo_close(conn, fd); 


if (rc < 0) 
printf("lo_close() failed: %s", PQerrorMessage(conn)); 


/* read test */ 
fd = lo_open(conn, loid, INV_READ); 
if (fd < 0) 
printf("lo_open() failed: %s", PQerrorMessage(conn)); 


printf("fd = %d\n", fd); 


rc = lo_read(conn, fd, buf2, buflen); 
if (rc < 0) 
printf("lo_read() failed\n"); 


rc = lo_close(conn, fd); 
if (rc < 0) 
printf("lo_close() failed: %s", PQerrorMessage(conn)); 


Aa Checke 
rc = memcmp(buf, buf2, buflen); 
printf("memcmp() = %d\n", rc); 


/* cleanup */ 
re = lo_unlink(conn, loid); 
if (rc < 0) 
printf("lo_unlink() failed: %s", PQerrorMessage(conn) ); 


EXEC SQL COMMIT; 
EXEC SQL DISCONNECT ALL; 
return 0; 


33.13. C++ 应 用 程序 


ECPG 对 C++ 应 用 程序 有 一 些 有 限 的 支持 。 本 节 介 绍 一 些 注意 事项 。 


ecpg 预 处 理 程序 采取 写 入 C (或 者 类 似 C) 的 输入 文件 ， 并 且 做 入 SQL 命令 ， 将 族 入 SQL 命 
倒转 换 为 C 语 言 块 ， 最 后 生成 .c 文件 。 当 在 C++ 中 使 用 时 ， 通过 ecpg 产生 的 C 语 言 块 使 用 
的 库 豆 数 的 头 文件 声明 被 包 襄 在 extern "ce" { ... } 块 中 。 因此 他 们 应 该 在 C++ 中 无 缝 工 
作 。 


一 般 情况 下 ， 然 而 ， ecpg 预 处 理 器 仅仅 了 解 C ; 它 不 义理 特殊 语法 并 且 保 留 C++ 语 言 关键 
字 。 因 此 ， 写 入 使 用 复 末 特定 C++ 功能 的 C++ 应 用 程序 代码 的 一 些 伐 入 SQL 代码 可 能 不 能 正 
确 地 被 预 处 理 或 者 可 能 不 会 按 预期 的 工作 。 


在 C++ 应 用 程序 中 使 用 伐 入 SQL 代码 的 安全 方式 是 在 C 模 块 中 隐藏 ECPG 调 用 ， 其 中 C++ 应 用 
程序 代码 调用 访问 数据 库 ， 并 且 连 同 C++ 代码 其 余部 分 一 起 连接 。 参阅 Section 33.13.2 获 取 
关于 它 的 更 多 信息 。 





33.13.1. BE SCH 


ecpg 预 处 理 器 理解 C 中 变量 范围 。 在 C 语 言 中 ， 这 是 简单 地 因为 变量 范围 基于 他 们 的 代码 
块 。 在 C++ 中 ， 然而 ， 类 成 员 变量 参考 来 自 声 明 位置 的 不 同 代码 块 。 因此 ecpg 预 处 理 程 序 
不 理解 类 成 员 变 量 的 范围 。 


比如 ， 在 下 面 情况 下 ， ecpg 预 处 理 器 无 法 找到 test 方法 中 变量 dbname 的 任何 声明 ， 因此 
产生 错误 。 


class TestCpp 


{ 
EXEC SQL BEGIN DECLARE SECTION, 


char dbname[1024]; 

EXEC SQL END DECLARE SECTION; 
public: 

TestCpp(); 


void test(); 
~TestCpp(); 


J; 
TestCpp::TestCpp() 
{ 


EXEC SQL CONNECT TO testdb1; 
} 


void Test::test() 


EXEC SQL SELECT current_database() INTO :dbname; 
printf("current_database = %s\n", dbname); 


TestCpp: :~TestCpp() 
{ 


EXEC SQL DISCONNECT ALL; 


这 个 代码 将 产生 类 似 这 样 的 错误 。 


<kbd class="literal">ecpg test_cpp.pgc</kbd> 
test_cpp.pgc:28: ERROR: variable "dbname" is not declared 


为 了 避免 这 个 范围 问题 ， test 方法 可 以 改 为 使 用 局 部 变量 作为 中 间 存 储 器 。 人 1 
仅仅 是 一 个 低劣 的 解决 办 法 ， 因 为 它 卫 化 代码 并 且 降 低 性 能 。 


fnn] 
并 


这 个 方法 


void TestCpp::test() 


{ 
EXEC SQL BEGIN DECLARE SECTION, 


char tmp[1024]; 
EXEC SQL END DECLARE SECTION; 


EXEC SQL SELECT current_database() INTO :tmp; 
strlcpy(dbname, tmp, sizeof(tmp)); 


printf("current_database = %s\n", dbname); 


33.13.2. C++ 应 用 程序 开发 与 外 部 C 模 块 


如 果 你 理解 C++ 中 ecpg 预 处 理 器 的 这 些 技术 局 限 性 ， 你 可 能 得 到 这 样 的 结论 在 链接 阶段 链接 
中 C 对 象 与 C++ 对 象 使 得 C++ 应 用 程序 使 用 ECPG 功 能 可 能 好 于 在 C++ 代码 中 直接 写 一 些 嵌 人 
SALA To 

已 经 创建 三 种 文件 : 一 个 C 文 件 ( *.pgc ) 头 文件 和 C++ 文件 : 


test_mod.pgc 


执行 SQL 命令 的 子 程序 模块 秘 入 C 中 。 它 将 通过 预 处 理 器 被 转换 为 test_mod.c o 


#include "test_mod.h" 
#include &lt;stdio.h&gt; 


void 
db_connect() 


EXEC SQL CONNECT TO testdb1; 
} 


void 
db_test() 


EXEC SQL BEGIN DECLARE SECTION; 
char dbname[1024]; 
EXEC SQL END DECLARE SECTION; 


EXEC SQL SELECT current_database() INTO :dbname; 
printf("current_database = %s\n", dbname); 


} 


void 
db_disconnect() 


EXEC SQL DISCONNECT ALL; 


test_mod.h 


C 模 块 中 ( test_mod.pgc ) 使 用 函数 声明 的 头 文件 通过 test_cpp.cpp 被 包含 。 这 个 文件 在 声明 
周围 有 一 个 extern "c" 块 ， 因 为 它 特 从 C++ 模块 链接 。 


#ifdef _ cplusplus 
extern "C" { 
#endif 


void db_connect(); 
void db_test(); 

void db_disconnect(); 
#ifdef _ cplusplus 


} 
#endif 


test_cpp.cpp 


该 应 用 程序 主要 代码 ， 包 含 main 程序 和 例子 中 C++ 类 。 


#include "test_mod.h" 
class TestCpp 


public: 
TestCpp(); 
void test(); 
~TestCpp(); 


TestCpp: :TestCpp() 


db_connect(); 


} 


void 
TestCpp::test() 


db_test(); 
} 


TestCpp: :~TestCpp() 


db_disconnect(); 


} 


int 
main(void) 


TestCpp *t = new TestCpp(); 


t-&gt;test(); 
return 0; 


为 了 编译 应 用 程序 ， 如 下 进行 。 通过 运行 ecpg ， 转换 test_mod.pge 到 test_mod.c , 使 用 C 
编译 器 通过 编译 test_mod.c 产生 test_mod.o 。 


ecpg -o test mod.c test_mod.pgc 
cc -c test_mod.c -o test_mod.o 


NI 


下 一 步 ， 使 用 C++ 编译 器 通过 编译 test_cpp.cpp 、 生成 test_cpp.o o 


c++ -c test_cpp.cpp -o test_cpp.o 


最 后 ， 链 接 这 些 对 象 文 件 ， test_cpp.o 和 test_mod.o 到 一 个 可 执行 文件 中 ， 使 用 C++ 编译 
器 驱动 : 


c++ test_cpp.o test_mod.o -lecpg -o test_cpp 


33.14. ERA PISALA D 


Table of Contents 


e ALLOCATE DESCRIPTOR -- 分 配 一 个 SQL 描述 区 
CONNECT -- 建立 数据 库 连 接 

e DEALLOCATE DESCRIPTOR -- 重新 分 配 SQL 描 述 符 区 域 
e DECLARE -- 定义 游标 

e DESCRIBE -- 获得 关于 预 各 语句 或 者 结果 集 的 信息 

e DISCONNECT -- 终止 数据 库 连 接 

e EXECUTE IMMEDIATE -- 动态 准备 和 执行 语句 

。 GET DESCRIPTOR -- 从 SQL 标 识 符 区 域 获得 信息 

e OPEN -- 打开 一 个 动态 游标 

e PREPARE -- 准备 一 个 执行 语句 

。 SET AUTOCOMMIT -- 设置 当前 会 话 自 动 提交 操作 

e SET CONNECTION -- 选择 一 个 数据 库 连 接 

e SET DESCRIPTOR -- 设置 SQL 描述 符 区 域 信 息 

e TYPE -- 定义 新 的 数据 类 型 

e VAR -- 定义 一 个 变量 

e WHENEVER -- 当 SQL 语 句 导 致 一 个 要 发 生 的 特定 类 条 件 时 ， 则 指定 要 采取 的 行动 


本 节 描 述 的 所 有 SQL 命令 仅 限 于 财 入 的 SQL。 参 阅 列 在 Reference |, SQL 命令 中 的 SQL 命 
D, 这 也 可 以 用 于 嵌入 的 SQL， 除 非 另 有 说 明 。 


ALLOCATE DESCRIPTOR 


Name 
ALLOCATE DESCRIPTOR -- 分 配 一 个 SQL 描述 区 
Synopsis 

ALLOCATE DESCRIPTOR _name_ 


ALLOCATE DESCRIPTOR 分 配 一 个 新 命名 SQL 描 述 符 区 域 ， 可 以 用 于 改变 PostgreSQL 服 务 器 和 
主机 程序 之 间 的 数据 。 


使 用 DEALLOCATE DESCRIPTOR 命令 之 后 应 该 释放 描述 符 区 域 。 


参数 


_name_ 


SQL 描述 符 名 字 区 分 大 小 写 。 这 可 以 是 SQL 标识 符 或 者 宿主 变量 。 


例子 


EXEC SQL ALLOCATE DESCRIPTOR mydesc; 


FANE 


在 SQL 标准 中 声明 ALLOCATE DESCRIPTOR 。 


参见 


J 


DEALLOCATE DESCRIPTOR, GET DESCRIPTOR, SET DESCRIPTOR 


CONNECT 


Name 


CONNECT -- 建立 数据 库 连 接 


Synopsis 


CONNECT TO _connection_target_ [ AS _connection_name_ ] [ USER _connection_user_name_ ] 
CONNECT TO DEFAULT 

CONNECT _connection_user_name_ 

DATABASE _connection_target_ 


| 





CONNECT 命令 在 客户 端 和 PostgreSQL 服 务 器 之 间 创建 了 连接 。 


参数 


_connection_target_ 


_connection_target ”在 几 种 形式 之 一 上 指定 了 连接 的 目标 服务 器 。 


[ _database_name_ ][ @``_host_ ][ :port ] 
TCP/IP 连 接 
unix:postgresql://°*_host_ [ :port ] / [ _database_name_ ][ 


?>>_connection_option_ ] 
连接 Unix- 域 套 接 字 


tcp:postgresql://``_host_ [ :port ] / [ _database_name_ ][ ?°°_connection_option_ 


] 

TCP/IP 连 接 

SQL 字符 串 常量 

在 上 述 形式 之 一 中 包含 一 个 值 


宿主 变量 


I 
= 
学 
¥ 
H} 
i 
& 
P 


类 型 char[] 或 者 vARcHAR[] 的 宿主 变量 包 
_connection_object_ 


用 于 连接 可 选 标识 符 ， 这 样 就 可 以 指向 其 他 命 舍 。 这 可 以 是 一 个 SQL 标识 符 或 者 宿主 变量 。 


_connection_user_ 


用 于 数据 库 连 接 的 用 户 名 。 


该 参数 可 以 指定 用 户 名 和 密码 ， 使 用 下 面 形式 之 一 _user_name_/ _password_, _user_name 
IDENTIFIED BY _password_ 或 者 user name USING _password_. 








用 户 名 和 密码 可 以 是 SQL 标识 符 ， 字 符 串 常量 ， 或 者 宿主 变量 。 


DEFAULT 


使 用 所 有 和 缺 省 连接 参数 ， 正 如 通过 libpq 定 义 的 。 


例子 
指定 连接 参数 的 几 种 变形 : 


EXEC SQL CONNECT TO "connectdb" AS main; 

EXEC SQL CONNECT TO "connectdb" AS second; 

EXEC SQL CONNECT TO "unix:postgresql://200.46.204.71/connectdb" AS main USER connectuser; 
EXEC SQL CONNECT TO "unix:postgresql://localhost/connectdb" AS main USER connectuser; 
EXEC SQL CONNECT TO 'connectdb' AS main; 

EXEC SQL CONNECT TO 'unix:postgresql://localhost/connectdb' AS main USER :user; 

EXEC SQL CONNECT TO :db AS :id; 

EXEC SQL CONNECT TO :db USER connectuser USING :pw; 

EXEC SQL CONNECT TO @localhost AS main USER connectdb; 

EXEC SQL CONNECT TO REGRESSDB1 as main; 

EXEC SQL CONNECT TO AS main USER connectdb; 

EXEC SQL CONNECT TO connectdb AS :id; 

EXEC SQL CONNECT TO connectdb AS main USER connectuser/connectdb; 

EXEC SQL CONNECT TO connectdb AS main; 

EXEC SQL CONNECT TO connectdb@localhost AS main; 

EXEC SQL CONNECT TO tcp:postgresql://localhost/ USER connectdb; 

EXEC SQL CONNECT TO tcp:postgresql://localhost/connectdb USER connectuser IDENTIFIED BY c 
EXEC SQL CONNECT TO tcp:postgresql://localhost:20/connectdb USER connectuser IDENTIFIED B 
EXEC SQL CONNECT TO unix:postgresql://localhost/ AS main USER connectdb; 

EXEC SQL CONNECT TO unix:postgresql://localhost/connectdb AS main USER connectuser,; 

EXEC SQL CONNECT TO unix:postgresql://localhost/connectdb USER connectuser IDENTIFIED BY 
EXEC SQL CONNECT TO unix:postgresql://localhost/connectdb USER connectuser USING "connect 
EXEC SQL CONNECT TO unix:postgresql://localhost/connectdb?connect_timeout=14 USER connect 





REB—-MIFEF BMT HABE RSBELESS : 


int 
main(void) 


EXEC SQL BEGIN DECLARE SECTION; 


char *dbname = "testdb"; /* 数 据 库 名 称 */ 


char *user 
char *connection 


char ver[256]; 
EXEC SQL END DECLARE 


= "testuser"; /* 连 接 用 户 名 */ 
= "tcp:postgresql://localhost :5432/testdb"; 
/* 连接 字符 串 */ 
/* 存 储 版 本 字符 串 的 缓冲 区 */ 
SECTION; 


ECPGdebug(1, stderr); 


EXEC SQL CONNECT 


TO :dbname USER :user; 


EXEC SQL SELECT version() INTO :ver; 
EXEC SQL DISCONNECT, 


printf("version: 


%S\n", ver); 


EXEC SQL CONNECT TO :connection USER :user; 
EXEC SQL SELECT version() INTO :ver; 
EXEC SQL DISCONNECT; 


printf("version: 


return 0; 


RANE 


%S\n", ver); 


在 SQL 标准 中 声明 connect , (Be 连接 参数 的 格式 是 具体 实施 的 。 


参见 


一 


DISCONNECT, SET CONNECTION 


DEALLOCATE DESCRIPTOR 


Name 


DEALLOCATE DESCRIPTOR -- 重新 分 配 SQL 描 述 符 区 域 


Synopsis 


DEALLOCATE DESCRIPTOR _name_ 


摘 述 
DEALLOCATE DESCRIPTOR 重新 分 配 命名 的 SQL 描述 符 区 域 。 
参数 


_name_ 


描述 符 名 字 将 重新 被 分 配 。 它 对 大 小 写 敏 感 。 这 可 以 是 一 个 SQL 标识 符 或 者 宿主 变量 。 


例子 


EXEC SQL DEALLOCATE DESCRIPTOR mydesc 


RANE 


在 SQL 标准 中 声明 DEALLOCATE DESCRIPTOR o 


参见 


ZZ 


ALLOCATE DESCRIPTOR, GET DESCRIPTOR, SET DESCRIPTOR 


DECLARE 


Name 


DECLARE -- 定义 游标 


Synopsis 


DECLARE _cursor_name_ [ BINARY ] [ INSENSITIVE ] [ [ NO ] SCROLL ] CURSOR [ { WITH | WITH 
DECLARE _cursor_name_ [ BINARY ] [ INSENSITIVE ] [ [ NO ] SCROLL ] CURSOR [ { WITH | WITH 





DECLARE 为 了 和 迭代 预备 语句 结果 集 声明 了 游标 。 该 命令 与 直接 SQL 命令 DEcLARE 上 略微 有 些 不 
同 语法 : 后 者 执行 查询 并 且 为 检索 准备 结果 集 ， 这 个 藤 入 SQL 命 合 只 为 迭代 查询 结果 集 声明 
作为 "循环 变量 "的 名 字 ; 当 使 用 open 命令 打开 游标 时 ， 发 生 实 际 执行 情况 。 


参数 


_cursor_name_ 

游标 名 大 小 写 敏感 。 这 可 以 是 一 个 SQL 标 识 符 或 者 宿主 变量 。 
_prepared_name_ 

一 个 准备 好 查询 的 名 字 ， 要 么 作为 SQL 标识 符 或 者 宿主 变量 。 
_query_ 

SELECT 或 者 VALUES 命 令 将 提供 通过 游标 返回 的 行 。 


关于 游标 选项 的 含义 ， 参 阅 DECLARE。 


例子 
为 查询 声明 游标 的 例子 : 


EXEC SQL DECLARE C CURSOR FOR SELECT * FROM My_Table; 
EXEC SQL DECLARE C CURSOR FOR SELECT Itemi FROM T; 
EXEC SQL DECLARE cur1 CURSOR FOR SELECT version(); 


为 预备 语句 声明 游标 的 例子 : 


EXEC SQL PREPARE stmt1 AS SELECT version(); 
EXEC SQL DECLARE curi1 CURSOR FOR stmt1,; 


RAIE 


在 SQL 标准 中 声明 DECLARE o 


参见 


一 


OPEN, CLOSE, DECLARE 


DESCRIBE 


Name 


DESCRIBE -- 获得 关于 预备 语句 或 者 结果 集 的 信息 


Synopsis 


DESCRIBE [ OUTPUT ] _prepared_name_ USING [ SQL ] DESCRIPTOR _descriptor_name_ 
DESCRIBE [ OUTPUT ] _prepared_name_ INTO [ SQL ] DESCRIPTOR _descriptor_name_ 


DESCRIBE [ OUTPUT ] _prepared_name_ INTO _sqlda_name 





摘 述 


DESCRIBE 将 检索 关于 在 预备 语句 中 包含 的 结果 列 的 元 数据 信息 ， 


参数 


_prepared_name_ 

预备 语句 名 字 可 以 是 一 个 SQL 标识 符 或 者 宿主 变量 。 
_descriptor_name_ 

描述 符 名 字 大 小 写 敏 感 。 可 以 是 SQL 标识 符 或 者 宿主 变量 。 


_sqlda_name_ 


SQLDAZ 247. 


BF 


EXEC SQL ALLOCATE DESCRIPTOR mydesc; 

EXEC SQL PREPARE stmt1 FROM :sql_stmt; 

EXEC SQL DESCRIBE stmt1 INTO SQL DESCRIPTOR mydesc; 
EXEC SQL GET DESCRIPTOR mydesc VALUE 1 :charvar = NAME; 
EXEC SQL DEALLOCATE DESCRIPTOR mydesc; 


兼容 性 


实际 上 没有 读 取 行 。 


PostgreSQL 中 文 文档 9.3 
在 SQL 标准 中 声明 DESCRIBE 。 


参见 


EA 


ALLOCATE DESCRIPTOR, GET DESCRIPTOR 


33.14. 散 入 的 SQL 命 兮 1014 


DISCONNECT 


Name 


DISCONNECT -- 终止 数据 库 连 接 


Synopsis 


DISCONNECT _connection_name_ 
DISCONNECT [ CURRENT ] 
DISCONNECT DEFAULT 
DISCONNECT ALL 


fia ah 


DISCONNECT 关闭 与 数据 库 的 连接 (或 者 所 有 连接 ) 。 


参数 


_connection_name_ 
通过 coNNEcT 命令 建立 数据 库 连 接 名 字 。 
CURRENT 


关闭 "当前 "连接 ， 它 要 么 是 最 近 打 开 的 连接 ， 或 者 是 通过 set connection 命 邻 设置 的 连接 。 
如 果 没 有 给 出 参数 到 prscoNNECT 命令 中 ， 那 么 这 也 是 缺 省 的 。 


DEFAULT 


关闭 缺 省 连接 。 


ALL 


关闭 所 有 打开 连接 。 


例子 


int 


main(void) 


EXEC 
EXEC 
EXEC 
EXEC 


EXEC 
EXEC 
EXEC 


return 0; 


FANE 


SQL 
SQL 
SQL 
SQL 


SQL 
SQL 
SQL 


CONNECT TO 
CONNECT TO 
CONNECT TO 
CONNECT TO 


DISCONNECT 
DISCONNECT 
DISCONNECT 


testdb AS 
testdb AS 
testdb AS 
testdb AS 


CURRENT; 
DEFAULT; 
ALL; 


在 SQL 标准 中 声明 DISCONNECT o 


参见 


i 


CONNECT, SET CONNECTION 


DEFAULT USER testuser; 
coni USER testuser; 
con2 USER testuser,; 
con3 USER testuser; 


/* close con3 Wi 
/* close DEFAULT yA 
/* close con2 and con1 */ 


EXECUTE IMMEDIATE 


Name 


EXECUTE IMMEDIATE -- 动态 准 各 和 执行 语句 


Synopsis 


EXECUTE IMMEDIATE _string_ 


fia ah 


EXECUTE IMMEDIATE 立即 准备 并 且 执 行动 态 声明 的 SQL 语句 ， 而 没有 检索 结果 行 。 


参数 


_string_ 


包含 要 执行 的 SQL 语句 文本 C 字 符 串 或 者 宿主 变量 。 


例子 
这 是 一 个 使 用 EXECUTE IMMEDIATE 和 命名 command 宿主 变量 执行 insert 语句 的 例子 : 


sprintf(command, "INSERT INTO test (name, amount, letter) VALUES ('db: ''ri''', 1, 'f')") 
EXEC SQL EXECUTE IMMEDIATE :command; 


| 


FANE 


在 SQL 标准 中 声明 EXECUTE IMMEDIATE 。 


GET DESCRIPTOR 


Name 


GET DESCRIPTOR -- 从 SQL 标识 符 区 域 获得 信息 


Synopsis 








GET DESCRIPTOR _descriptor_name_ _:cvariable_ = _descriptor_header_item_ [, ... ] 
GET DESCRIPTOR _descriptor_name_ VALUE _column_number :cvariable_ = _descriptor_ item [ 
图 — z] PEE 
vb 
描述 
GET DESCRIPTOR et td 吉 果 集 的 信息 ， ee 
中 。 在 使 用 该 命令 将 信息 传递 给 宿主 语言 变量 之 前 通常 使 用 FETcH 或 者 SELECT 填充 标识 符 


该 命 信 有 两 种 形式 : 第 一 个 形式 检索 描述 符 " 头 部 "项 ， 适用 于 作为 整体 的 结果 集 。 第 二 个 形 
式 需 要 作为 额外 参数 的 列 数 检索 关于 特定 列 的 信息 。 例子 是 列 名 和 实际 列 值 。 


参数 


_descriptor_name_ 


HL 


N 


描述 符 名 字 。 


_descriptor_header_item_ 


一 个 标记 识别 检索 的 头 部 信息 项 。 目 前 久 公 支持 count 可 以 获取 结果 集中 的 列 数 。 


column_number 


关于 被 检索 的 列 数 信 息 。 计 数 从 1 开始 。 


_descriptor_item_ 





一 个 标记 识别 检索 列 的 信息 项 。 参 阅 Section 33.7.1 获取 可 支持 项 的 列 数 。 


_cvariable_ 


宿主 变量 将 接收 从 描述 符 区 域 检索 的 数据 。 


例子 
检索 结果 集中 列 数 的 例子 : 


EXEC SQL GET DESCRIPTOR d :d_count = COUNT; 


在 第 一 列 中 检索 数据 长 度 的 例子 : 


EXEC SQL GET DESCRIPTOR d VALUE 1 :d_returned_octet_length = RETURNED_OCTET_LENGTH; 


检索 作为 字符 串 第 二 列 的 数据 主体 的 例子 : 


EXEC SQL GET DESCRIPTOR d VALUE 2 :d_data = DATA; 


这 是 一 个 执行 SELECT current_database(); 的 整个 程序 的 例子 ， HABA TST WR, 列 数据 长 度 
和 列 数据 : 


int 

main(void) 

EXEC SQL BEGIN DECLARE SECTION; 
int d_count; 
char d_data[1024]; 


int d_returned_octet_length; 
EXEC SQL END DECLARE SECTION; 


EXEC SQL CONNECT TO testdb AS con1 USER testuser; 
EXEC SQL ALLOCATE DESCRIPTOR d; 


/声明 ， 打 开 游 标 ， 并 且 分 配 描述 符 给 游标 */ 
EXEC SQL DECLARE cur CURSOR FOR SELECT current_database(); 
EXEC SQL OPEN cur; 
EXEC SQL FETCH NEXT FROM cur INTO SQL DESCRIPTOR d; 

/* 得 到 总 列 数 */ 


EXEC SQL GET DESCRIPTOR d :d_count = COUNT; 
printf ("d_count = %d\n", d_count); 


/* 得 到 返回 列 的 长 度 */ 


EXEC SQL GET DESCRIPTOR d VALUE 1 :d_returned_octet_length = RETURNED_OCTET_LENGTH; 
printf("d_returned_octet_length = %d\n", d_returned_octet_length); 


/* 读 取 返 回 列 作 为 字符 串 */ 


EXEC SQL GET DESCRIPTOR d VALUE 1 :d_data = DATA; 
printf("d_data %s\n", d_data); 


RA 


EXEC SQL CLOSE cur; 
EXEC SQL COMMIT; 


EXEC SQL DEALLOCATE DESCRIPTOR d; 
EXEC SQL DISCONNECT ALL; 


return 0; 


} 
了 Eee 


当 执 行 该 例子 的 时 候 ， 结 果 看 起 来 像 这 样 : 


d_count = 工 
d_returned_octet_length = 6 
d_data = testdb 


FANE 


在 SQL 标准 中 指定 GET DESCRIPTOR © 


参见 


D 


ALLOCATE DESCRIPTOR, SET DESCRIPTOR 


OPEN 


Name 


OPEN -- 打开 一 个 动态 游标 


Synopsis 


OPEN _cursor_name_ 
OPEN _cursor_name_ USING _value_ [, ... ] 
OPEN _cursor_name_ USING SQL DESCRIPTOR _descriptor_name_ 


fia ah 


open 打开 游标 并 且 任 意 地 绑 定 实际 值 到 游标 声明 中 的 占 位 符 。 游 标 必 须 预 先 使 
用 pEcLARE 命令 被 声明 。 open 的 执行 导致 查询 在 服务 器 上 开始 执行 。 


参数 


_Cursor_name_ 


要 打开 的 游标 名 字 。 可 以 是 SQL 标识 符 或 者 宿主 变量 。 


_value_ 


一 个 绑 定 到 游标 中 占 位 符 的 值 。 可 以 是 SQL 常 数 ， 宿主 变量 或 者 使 用 指示 器 的 宿 


_descriptor_name_ 


描述 符 名 字 包 含 绑 定 到 游标 中 占 位 符 的 值 。 可 以 是 SQL 标识 符 或 者 宿主 变量 。 


例子 


EXEC SQL OPEN a; 

EXEC SQL OPEN d USING 1, 'test'; 

EXEC SQL OPEN c1 USING SQL DESCRIPTOR mydesc; 
EXEC SQL OPEN :curname1; 


兼容 性 


PostgreSQL 中 文 文档 9.3 
在 SQL 标准 中 指定 oPEN 。 


参见 


D 


DECLARE, CLOSE 


33.14. 做 入 的 SQL 命 兮 1022 


PREPARE 


Name 


PREPARE -- 准备 一 个 执行 语句 


Synopsis 


PREPARE _name_ FROM _string 





JANR 


PREPARE 动态 准 各 指定 作为 字符 串 执 行 的 语句 。 这 不 同 于 直接 SQL 语句 PREPARE， 也 可 以 
EARLIER., EXECUTE 命 令 用 来 执行 两 种 预备 语句 。 


参数 


_prepared_name_ 


预备 查询 标识 符 。 


_string_ 


包含 一 个 预 各 语句，SELECT，INSERT，UPDATE 或 者 DELETE 之 一 的 文本 C 字 符 串 或 者 宿 
ERS, 


例子 


char *stmt = "SELECT * FROM testi WHERE a = ? AND b = ?"; 


EXEC SQL ALLOCATE DESCRIPTOR outdesc; 
EXEC SQL PREPARE foo FROM :stmt; 


EXEC SQL EXECUTE foo USING SQL DESCRIPTOR indesc INTO SQL DESCRIPTOR outdesc; 


FANE 


在 SQL 标准 中 指定 PREPARE © 


PostgreSQL 中 文 文档 9.3 


— 


参见 


EXECUTE 


33.14. BRA BISQL aa S 1024 


SET AUTOCOMMIT 


Name 


SET AUTOCOMMIT -- 设置 当前 会 话 自动 提交 操作 
Synopsis 
SET AUTOCOMMIT { = | TO } { ON | OFF } 


fia ah 


SET AUTOCOMMIT 设置 当前 数据 库 会 话 自动 提交 操作 。 缺 省 ， 嵌 入 SQL 程 序 不 在 自动 提交 模 
式 ， 因 此 当 需 要 的 时 候 ， 需 要 明确 发 布 comm. 该 命令 可 以 改变 会 话 自动 提交 模式 ， 则 隐 
式 提交 每 个 单独 语句 。 


兼容 性 


SET AUTOCOMMIT 是 PostgreSQL ECPG 的 一 个 扩展 。 


SET CONNECTION 


Name 


SET CONNECTION -- 选择 一 个 数据 库 连 接 


Synopsis 


SET CONNECTION [ TO | = ] _connection_name_ 


fi aah 


SET CONNECTION 设置 "当前 "数据 库 连 接 ， 这 是 所 有 命令 使 用 的 一 个 ， 除 非 重 写 。 


参数 


_connection_name_ 


通过 connect 命令 创建 数据 库 连 接 名 字 。 


DEFAULT 


设置 连接 为 缺 省 连接 。 


例子 


EXEC SQL SET CONNECTION TO con2 
EXEC SQL SET CONNECTION = coni, 


RANE 


在 SQL 标准 中 指定 SET CONNECTION © 


参见 


ZZ 


CONNECT, DISCONNECT 


SET DESCRIPTOR 


Name 


SET DESCRIPTOR -- 设置 SQL 描 述 符 区 域 信息 


Synopsis 








SET DESCRIPTOR _descriptor_name_ _descriptor_header_item_ = _value_ [, ... ] 
SET DESCRIPTOR _descriptor_name_ VALUE _number_ _descriptor_item_ = _value_ [, ...] 
bh 
描述 


SET DESCRIPTOR 使 用 值 填 充 SQL 描 述 符 区 域 。 描述 符 区 域 通常 用 于 绑 定 预备 查询 执行 中 的 参 
数 。 


该 参数 有 两 种 形式 : 第 一 种 形式 适用 于 描述 符 " 头 部 "， 它 不 受 特定 数据 影响 。 第 二 中 形式 将 
值 分 配给 特定 数据 ， 通 过 数字 标识 。 


参数 


_descriptor_name_ 


描述 符 名 字 。 


_descriptor_header_item_ 


标记 识别 设置 的 头 部 信息 项 。 目 前 仅仅 支持 cout 设置 描述 符 项 数 。 


_number_ 


设置 的 描述 符 项 数 。 计 数 从 1 开始 。 


_descriptor_item_ 


标记 识别 在 描述 符 中 的 项 信息 。 参 阅 Section 33.7.1 获取 可 支持 项 的 列表 。 


_value_ 


存储 到 描述 符 项 中 的 值 。 可 以 是 SQI 常 量 或 者 宿主 变量 。 


例子 


EXEC SQL SET DESCRIPTOR indesc COUNT = 1; 

EXEC SQL SET DESCRIPTOR indesc VALUE 1 DATA = 2; 

EXEC SQL SET DESCRIPTOR indesc VALUE 1 DATA = :vali; 

EXEC SQL SET DESCRIPTOR indesc VALUE 2 INDICATOR = :vali, DATA = 'some string'; 
EXEC SQL SET DESCRIPTOR indesc VALUE 2 INDICATOR = :val2null, DATA = :val2; 


RANE 


在 SQL 标准 中 指定 SET DESCRIPTOR 。 


参见 


一 


ALLOCATE DESCRIPTOR, GET DESCRIPTOR 


TYPE 


Name 


TYPE -- 定义 新 的 数据 类 型 


Synopsis 


TYPE _type_name_ IS _ctype 





TYPE 命令 定义 一 个 新 的 C 类 型 。 它 相当 于 将 typedef 放 到 声明 段 中 。 


当 运 行 带 有 -c 选项 的 ecpg 的 时 候 ， 和信 仅 标 识 该 命令 。 


_type_name_ 
新 类 型 名 字 。 它 必须 是 一 个 有 效 的 C 类 型 名 字 。 
_ctype_ 


C 类 型 说 明 。 


例子 


EXEC SQL TYPE customer IS 
struct 
{ 
varchar name[50]; 
int phone; 


ten 


EXEC SQL TYPE cust_ind IS 
struct ind 


short name_ind; 
short phone_ind; 


}; 


EXEC SQL TYPE c IS char reference; 

EXEC SQL TYPE ind IS union { int integer; short smallint; }; 
EXEC SQL TYPE intarray IS int[AMOUNT]; 

EXEC SQL TYPE str IS varchar[BUFFERSIZ]; 

EXEC SQL TYPE string IS char[11]; 


这 里 是 使 用 exec so type 的 例子 程序 : 


EXEC SQL WHENEVER SQLERROR SQLPRINT ， 


EXEC SQL TYPE tt IS 
struct 
{ 
varchar v[256]; 
int SUF 


}; 


EXEC SQL TYPE tt_ind IS 
struct ind { 
short v_ind; 
short i_ind; 


J; 

int 

main(void) 

{ 

EXEC SQL BEGIN DECLARE SECTION; 
tt t3 


tt_ind t_ind; 
EXEC SQL END DECLARE SECTION; 


EXEC SQL CONNECT TO testdb AS con1; 
EXEC SQL SELECT current_database(), 256 INTO :t:t_ind LIMIT 1; 


printf("t.v 
printf("t.i 


%s\n", t.V.arr); 
%d\n", t.i); 


printf("t_ind.v_ind 
printf("t_ind.i_ind 


%d\n", t_ind.v_ind); 
%d\n", t_ind.i_ind); 


EXEC SQL DISCONNECT con1; 


return 0; 


该 程序 的 输出 看 起 来 像 这 祥 : 


v = testdb 

1 = 256 
ind.v_ind = 0 
ind.i_ind = 0 


AA 
Ap T 


三 | 
Ze 


PostgreSQL 的 扩展 。 


VAR 


Name 


VAR -- 定义 一 个 变量 


Synopsis 


VAR _varname_ IS _ctype_ 


fia oh 
var 命令 料 新 的 C 数 据 关 型 分 配给 宿主 交 量 。 宿主 变量 


_varname_ 
C 变 量 名 字 。 
_ctype_ 


C 类 型 说 明 。 


例子 


Exec sql begin declare section; 
short a; 

exec sql end declare section; 
EXEC SQL VAR a IS int; 


兼容 性 


VAR 命令 是 PostgreSQL 扩 展 。 


必须 预先 在 声明 段 声 明 。 


WHENEVER 


Name 


WHENEVER -- 当 SQL 语 句 导致 一 个 要 发 生 的 特定 类 条 件 时 ， 则 指定 要 采取 的 行动 


Synopsis 


WHENEVER { NOT FOUND | SQLERROR | SQLWARNING } _action_ 


fia aah 


定义 在 SQL 执行 结果 中 特殊 情况 下 〈 没 有 发 现行 ，SQL 和 警告 或 者 错误 ) 调用 的 操作 。 


参数 


参阅 Section 33.8.1 获 取 该 参数 的 描述 。 


例子 


EXEC SQL WHENEVER NOT FOUND CONTINUE; 

EXEC SQL WHENEVER NOT FOUND DO BREAK; 

EXEC SQL WHENEVER SQLWARNING SQLPRINT; 

EXEC SQL WHENEVER SQLWARNING DO warn(); 

EXEC SQL WHENEVER SQLERROR sqlprint; 

EXEC SQL WHENEVER SQLERROR CALL print2(); 

EXEC SQL WHENEVER SQLERROR DO handle_error("select"); 
EXEC SQL WHENEVER SQLERROR DO sqlnotice(NULL, NONO); 
EXEC SQL WHENEVER SQLERROR DO sqlprint(); 

EXEC SQL WHENEVER SQLERROR GOTO error_label; 

EXEC SQL WHENEVER SQLERROR STOP; 


一 个 典型 点 用 是 通过 结果 集 处 理 循 环 的 WHENEVER NOT FOUND BREAK 的 使 用 : 


int 
main(void) 


EXEC SQL CONNECT TO testdb AS con1; 
EXEC SQL ALLOCATE DESCRIPTOR d; 
EXEC SQL DECLARE cur CURSOR FOR SELECT current_database(), 'hoge', 256; 
EXEC SQL OPEN cur; 
/* 当 到 达 结 果 集 终端 时 ， 打 破 while 循 环 */ 
EXEC SQL WHENEVER NOT FOUND DO BREAK; 
while (1) 
EXEC SQL FETCH NEXT FROM cur INTO SQL DESCRIPTOR d; 
} 


EXEC SQL CLOSE cur; 
EXEC SQL COMMIT; 


EXEC SQL DEALLOCATE DESCRIPTOR d; 
EXEC SQL DISCONNECT ALL; 


return 0; 


兼容 性 


在 SQL 标准 中 指定 wHENEVER ， 但 是 大 多 数 操作 是 PostgreSQL 扩 展 。 


33.15. Informix 兼 容 模 式 


ecpg 可 以 在 所 谓 的 Informix 兼 容 模式 下 运行 。 如 果 这 种 模式 是 活路 的 ， 它 试图 表现 得 好 像 
Informix E/SQL 的 Informix 预 编译 器 。 通常 所 说 的 这 将 允许 你 使 用 美元 符号 ， 而 不 
是 EXEC SQL 原始 的 引入 罕 入 式 的 SQL 命 命 。 


$int j = 3; 

$CONNECT TO :dbname; 

$CREATE TABLE test(i INT PRIMARY KEY, j INT); 
$INSERT INTO test(i, j) VALUES (7, :j); 
$COMMIT; 














Note: 4 $ 之 间 不 能 有 任何 空格 和 下 面 的 预 处 理 指 
ifdef 等 等 。 否 则 ， 预 处 理 器 将 解析 兮 牌 作 为 宿主 变量 。 





a, Bo include , define , 
a 





有 两 种 兼容 模式 : INFORMIX , INFORMIX SE o 
当 使 用 这 些 兼 容 模式 连接 程序 时 ， 记 得 要 链接 libcompat 前 内 置 于 ECPG 中 。 


除了 前 面 所 说 的 语法 块 ， Informix 兼 容 模 式 为 输入 输出 和 数据 转换 功能 ， 以 及 从 E/SQL 到 
ECPG 角 入 式 SQL 语 句 提供 一 些 函 数 。 


Informix 兼 容 模式 紧密 联系 ECPG 的 pgtypeslib 库 。 pgtypeslib 在 C 主 机 程序 映射 SQL 数据 类 型 
到 数据 类 型 ， 并 且 Informix 兼容 模式 的 大 部 分 附加 画 数 允许 你 在 那些 C 主 机 程序 类 型 上 进行 操 
作 。 但 值得 注意 的 是 ， 兼 容 性 的 程度 是 有 限 的 。 它 并 不 试图 复制 Informix 的 操作 ; 它 人 允许 你 做 
或 多 或 少 相同 的 操作 ， 使 你 具有 相同 的 名 称 和 相同 的 基本 行为 功能 ， 但 如 果 你 现在 使 用 
Informix， 它 没有 下 拉 式 功能 表 位 置 。 此 外 ， 一 些 数据 类 型 是 不 同 的 。 比 如，PostgreSQL 的 
datetime 和 区 间 类 型 不 知道 范围 比如 YEAR To minute ， 因此 你 在 ECPG 的 这 两 种 类 型 中 不 会 
找到 支持 。 


33.15.1. 附加 类 型 


在 不 使 用 typedef 的 Informix 模 式 中 现在 支持 为 存储 正确 修剪 字符 串 数据 Informix 特 殊 " 字 符 
串 " 伪 类 型 。 实际 上 ， 在 Informix 模 式 中 ，ECPG 拒 绝 包含 typedef sometype string; 的 过 程 源 
文件 。 


EXEC SQL BEGIN DECLARE SECTION; 
string userid; /* 这 个 变量 将 包含 修剪 的 数据 */ 
EXEC SQL END DECLARE SECTION; 


EXEC SQL FETCH MYCUR INTO :userid; 


33.15.2. 附加 的 /失足 的 散人 的 SQL 语句 


CLOSE DATABASE 
这 个 语句 关闭 当前 连接 。 事 实 上 ， 这 是 ECPG 的 DISCONNECT current 的 同义词 : 


$CLOSE DATABASE; /* 关闭 当前 连接 */ 
EXEC SQL CLOSE DATABASE; 


FREE cursor_name 


由 于 ECPG 与 Informix 的 ESQL/C 如 何 运 行 的 不 同 〈 即 这 个 步骤 是 纯粹 的 语法 转换 并 且 依赖 于 
底层 运行 时 的 库 ) 在 ECPG 中 没有 FREE cursor_name 声明 。 这 是 因为 在 ECPG 

FA, DECLARE cursor 不 转化 为 使 用 游标 名 称 调 用 运行 时 库 的 一 个 函数 。 这 意味 着 ， 在 ECPG 
中 运行 时 库 中 SQL 游标 没有 运行 时 的 记录 ， 只 有 在 PostgreSQL 服 务 器 上 。 


FREE Statement_name 


FREE statement_name 是 DEALLOCATE PREPARE statement_name AY [Al SL 78 o 


33.15.3. Informix 兼 容 SQLDA 摘 述 符 区 域 


Informix 兼 容 模式 支持 一 个 比 Section 33.7.2 描 述 中 的 不 同 的 结构 。 见 下 文 : 


struct sqlvar_compat 


{ 
short sqltype; 
int sqllen; 
char *sqidata; 
short *sqlind; 
char *sqiname; 
char *sqlformat; 
short sqlitype; 
short sqlilen; 
char *sqlidata; 
int sqlxid; 
char *sqltypename; 
short sqltypelen; 
short sqlownerlen; 
short sqlsourcetype; 
char *sqlownername; 
int sqlsourceid; 
char *sqlilongdata; 
int sqlflags; 
void *sqlreserved; 
}; 
struct sqlda_compat 
{ 
short sqld; 
struct sqlvar_compat *sqlvar; 
char desc_name[19]; 
short desc_occ; 
struct sqlda_compat *desc_next; 
void *reserved; 
}; 
typedef struct sqlvar_compat sqlvar_t; 
typedef struct sqlda_compat sqlda_t; 


全 局 属性 是 : 

sqld 

在 sQLpA 描述 符 中 的 字段 的 数目 。 
sqlvar 

每 个 字段 属性 的 指针 。 

desc_name 

未 使 用 的 ， 填 充 需 字 节 。 

desc_occ 

分 配 的 结构 大 小 。 


desc_next 


如 果 结 果 集 中 包含 1 个 以 上 的 记录 ， 指 向 下 一 个 SQLDA 结 构 的 指针 。 


reserved 


未 使 用 指针 ， 包 含 空 。 保 持 Informix 兼 容 。 


下 面 每 个 字段 属性 ， 它 们 被 存储 在 sqlvar 数组 中 : 
sqltype 

字段 类 型 。 常量 在 sqltypes.h 中 。 

sqllen 

字段 数据 的 长 度 。 


sqldata 
指向 字段 数据 的 指针 。 指 针 是 char * 类 型 ， 通 过 它 指出 的 数据 是 二 进 制 格式 。 例 子 : 


int intval; 
switch (sqldata-&gt;sqlvar[i].sqltype) 
{ 

case SQLINTEGER: 


intval = *(int *)sqldata-&gt;sqlvar[i].sqldata; 
break; 


sqlind 


指向 空 指 针 。 如 果 通 过 DESCRIBE 或 取 回 后 ， 那 么 它 总 是 一 个 有 效 的 指针 。 MRE 
用 EXECUTE ... USING sqlda; 作为 输入 ， 然后 空 指针 值 意味 着 该 字段 的 信 为 非 空 人 否则， 一 
个 有 效 的 指针 和 sqlitype | AREA ie. IF: 


if (*(int2 *)sqldata-&gt;sqlvar[i].sqlind != 0) 
printf("value is NULL\n"); 


sqiname 


字段 名 称 。0 终 止 字 符 串 。 
sqlformat 
保留 在 Informix 中 ， pofformat() 的 值 为 字段 的 值 。 


sqlitype 


空 指针 的 数据 类 型 。 当 从 服务 器 返回 数据 时 ， 它 总 是 SQLSMINT。 4 soa 用 于 参数 化 查询 
at, 数据 是 根据 设 定 的 类 型 来 义理 的 。 


sqlilen 


空 指针 数据 的 长 度 。 


sqlxid 


字段 的 扩展 类 型 ， 结 果 portype() o 


sqltypename’ ~sqltypelen sqlownerlen sqlsourcetype sqlownername sqlsourceid 


sqlflags sqlreserved 


未 使 用 。 


sqlilongdata 


如 果 sqllen 大 于 32KB。 它 等 于 sqldata 。 


例子 : 


EXEC SQL INCLUDE sqlda.h; 
sqlda_t *sqlda; /* 这 个 不 需要 在 嵌入 DECLARE SECTION 的 下 面 */ 
EXEC SQL BEGIN DECLARE SECTION; 
char *prep_stmt = "select * from table1"; 
int i; 
EXEC SQL END DECLARE SECTION; 


EXEC SQL PREPARE mystmt FROM :prep_stmt,; 
EXEC SQL DESCRIBE mystmt INTO sqlda; 
printf("# of fields: %d\n", sqlda->sqld); 
for (i = 0; i < sqlda->sqld; i++) 
printf("field %d: \"%s\"\n", sqlda->sqlvar[i]->sqlname) ; 
EXEC SQL DECLARE mycursor CURSOR FOR mystmt; 
EXEC SQL OPEN mycursor; 
EXEC SQL WHENEVER NOT FOUND GOTO out; 
while (1) 


EXEC SQL FETCH mycursor USING sqlda; 
} 


EXEC SQL CLOSE mycursor,; 


free(sqlda); /* 主 结构 被 free()， sqlda 和 sqlda->sqlvar 在 分 配 区 域 中 */ 


获取 更 多 信息 ， 参见 sqlda.h 头 文 件 和 src/interfaces/ecpg/test/compat_informix/sqlda.pgc 
回 为 测试 。 


33.15.4. 附加 函数 


decadd 


增加 2 个 decimal 类 型 值 。 


int decadd(decimal *argi, decimal *arg2, decimal *sum); 


SWAG S — MBI y decimal, argi ) 的 第 一 个 操作 数 的 指针 ， 类 型 decimal ( arg2 ) 的 

第 二 个 操作 数 的 指针 和 包含 sum ( sum ) 类 型 decimal 值 的 指针 。 成 功 时 ， 画 数 返 回 0。 Lita 
出 返回 ECPG_INFORMIX_NUM_OVERFLOW 和 在 下 浴 的 情况 下 返回 ECPG_INFORMIX_NUM_UNDERFLOW o 其 
他 错误 返回 -1， errno 设置 为 pgtypeslib 的 各 自 的 errno 数 。 


deccmp 
比较 decimal 类 型 的 2 个 变量 。 


int deccmp(decimal *argi, decimal *arg2); 


这 个 加 数 接受 一 个 指向 第 一 个 decimal 值 ( argi ) 的 指针 ， 一 个 指向 第 二 个 decimal 值 ( arg2 ) 的 
指针 并 返回 一 个 表示 这 是 更 大 值 的 整数 值 。 


e 如 果 argi 指向 比 var2 指向 的 值 更 大 ， 则 为 1。 
e 如 果 argi 指向 比 arg2 指向 的 值 更 小 ， 则 为 -1。 
。 如 果 arga 指向 和 arg2 指向 的 值 相等 ， 则 为 0。 
deccopy 


复制 一 个 decimal 值 。 


void deccopy(decimal *src, decimal *target); 


这 个 函数 接受 一 个 指向 复制 为 第 一 个 参数 ( src ) 的 decimal 值 的 指针 和 一 个 指向 
decimal( target ) 的 目标 结构 作为 第 二 个 参数 的 指针 。 


deccvasc 
将 一 个 值 从 ASCII 表 示 转 换 为 decimal 类 型 。 


int deccvasc(char *cp, int len, decimal *np); 


这 个 事 数 接受 一 个 指向 字符 串 的 指针 ， 这 个 字符 串 包 含 转换 成 和 其 长 度 一 样 为 len 的 ( cp ) 
数字 的 字符 串 表 示 形 式 。 np 是 一 个 指向 decimal 值 的 指针 ， 节 省 了 运算 的 结果 。 


有 效 格式 比如 : -2 ，.794 ，+3.44 , 592.49E07 或 者 -32.84e-4 o 
范 数 成 功 时 返回 0。 如 果 发 生 浴 出 或 下 浴 ， 返回 ECPG_INFORMIX_NUM_OVERFLOW 或 者 
ECPG_INFORMIX_NUM_UNDERFLOW 。 如 果 ASCII 表 示 不 能 被 解析 ， 返 


回 ECPG_INFORMIX_BAD_NUMERIC ， 如 果 解 析 指 数 发 生 此 问题 时 返 
[E] ECPG_INFORMIX_BAD_EXPONENT o 


deccvdbl 


转换 double 类 型 的 值 到 一 个 decimal 类 型 的 值 。 


int deccvdbl(double dbl, decimal *np); 
HRADE TSB dbl ) 转 换 的 double 类 型 的 变量 。 作为 第 二 个 参数 ( np), BW 
数 接收 一 个 指向 保持 操作 结果 的 decimal 变 量 的 指针 。 
成 功 时 阔 数 返回 09， 如 果 转 换 失败 则 返回 一 个 负数 。 


deccvint 
转换 一 个 int 类 型 的 值 到 一 个 decimal 类 型 的 值 。 
int deccvint(int in, decimal *np); 
函数 接收 应 作为 第 一 个 参数 ( in ) 转 换 的 int 类 型 的 变量 。 作 为 第 二 个 参数 ( np )， 男 数 接收 一 
个 指向 保持 操作 结果 的 decimal 变 量 的 指针 。 
成 功 时 函数 返回 9， 如 果 和 转换 失败 则 返回 一 个 负数 。 


deccvlong 
转换 一 个 long 类 型 的 值 到 一 个 decimal 类 型 的 值 。 


int deccvlong(long lng, decimal *np); 


函数 接收 应 作为 第 一 个 参数 ( ing ) 转 换 的 long 类 型 的 变量 。 作为 第 二 个 参数 ( np ), PWR 
一 个 指向 保持 操作 结果 的 decimal 变 量 的 指针 。 


成 功 时 函数 返回 9， 如 果 和 转换 失 败 则 返回 一 个 负数 。 


decdiv 
decimal 类 型 的 两 个 变量 相 除 。 


int decdiv(decimal *n1，decimal *n2, decimal *result); 


Rae TEA AB—T n ) 和 第 二 个 ( n2 ) 操 作 数 变量 的 指针 并 且 计 算 ni / no 
result 是 指向 保持 操作 结果 的 变量 的 指针 。 


成 功 则 返回 0， 如 果 除 法 运算 失败 则 返回 一 个 负数 。 如 果 产 生 渝 出 或 者 下 渝 ， 画 数 各 自 返 
[E] ECPG_INFORMIX_NUM_OVERFLOW 或 者 ECPG_INFORMIX_NUM_UNDERFLOW o 如 果 观 察 到 尝试 除 以 0， 


EY 23 [G] ECPG_INFORMIX_DIVIDE_ZERO o 


decmul 


两 个 decimal 值 相 乘 。 


int decmul(decimal *n1，decimal *n2, decimal *result); 


PRI FSAI SB —“N( nz ) 和 第 二 个 ( n2 ) 操 作 数 变量 的 指针 并 且 计 算 n1 * n2 。 result 是 指 
向 保持 操作 结果 的 变量 的 指针 。 


成 功 则 返回 0， 如 果 乘 法 运算 失败 则 返回 一 个 负数 。 如 果 发 生 浴 出 或 者 下 浴 ， 画 数 各 自 返 回 


ECPG_INFORMIX_NUM_OVERFLOW 或 者 ECPG_INFORMIX_NUM_UNDERFLOW o 


decsub 


一 个 decimal 值 与 另 一 个 值 相 减 。 


int decsub(decimal *n1, decimal *n2, decimal *result); 


函数 接收 指向 第 一 个 ( na ) 和 第 二 个 ( n2 ) 操 作 数 变量 的 指针 并 且 计 算 na - n2 。 result 是 指 
向 保持 操作 结果 的 变量 的 指针 。 


成 功 则 返回 9， 如 果 减 法 运算 失败 则 返回 一 个 负数 。 如 果 发 生 洽 出 或 者 下 洽 ， 辑 数 各 自 返 


[E] EcPG_INFORMIX_NUM_OVERFLOW 或 者 ECPG_INFORMIX_NUM_UNDERFLOW o 


dectoasc 


转换 一 个 decimal 类 型 变量 到 C char* 字 符 串 中 ASCII 表 示 。 


int dectoasc(decimal *np, char *cp, int len, int right) 


函数 接收 一 个 指向 decimal( np ) 类 型 文本 表示 的 变量 的 指针 。 cp 是 保存 操作 结果 的 缓冲 
X. SA right 指明 小 数 点 右边 有 多 少 位 数字 应 该 包含 在 输出 中 。 结 果 将 四 舍 五 入 小 数 数字 
位 数 。 设 置 rigt 到 -1 表明 所 有 可 用 的 小 数位 数 应 包含 在 输出 中 。 如 果 由 len 指明 的 输出 组 
冲 区 的 长 度 不 足以 保持 包含 尾随 NUL 字 符 的 文本 表示 ， 仅 仅 在 结果 中 存储 一 个 单一 的 * 字符 
并 且 返 回 -1。 


如 果 缓 冲 区 cp 太 小 ， 画 数 则 返回 -1， 如 果 内 存 耗 尽 ， 则 返 


回 ECPG_INFORMIX_OUT_OF_MEMORY o 


dectodbl 
转换 一 个 decimal 类 型 的 变量 到 一 个 double 类 型 。 


int dectodbl(decimal *np, double *dblp); 


函数 接受 一 个 指向 decimal 值 转换 ( np ) 和 一 个 指向 应 保持 操作 结果 ( dblp ) 的 double 变 量 的 
指针 。 


成 功 则 返回 9，， 如 果 转 换 失败 则 返回 一 个 负数 。 


dectoint 


转化 一 个 decimal 类 型 到 一 个 integer 类 型 的 变量 。 


int dectoint(decimal *np, int *ip); 


函数 接受 一 个 指向 decimal 值 转换 ( np ) 和 指向 应 保持 操作 结果 ( ip ) 的 integer 变 量 的 指 
针 。 


成 功 则 返回 0， 如 果 转 换 失 败 则 返回 一 个 负数 。 如 果 发 生 浴 出 ， 则 返 


回 ECPG_INFORMIX_NUM_OVERFLOW o 


注意 ECPG 应 用 不 同 于 Informix 应 用 。 当 ECPG 应 用 中 的 限制 取决 于 ( -INT_MAx .. INT_MAX )BY 
结构 ，Informix 限制 integer 的 范围 从 -32767 到 32767。 


dectolong 
转换 一 个 decimal 类 型 的 变量 到 一 个 long integer 类 型 。 


int dectolong(decimal *np, long *l1ngp); 


函数 接受 一 个 decimal 值 转换 ( np ) 和 一 个 应 保持 操作 结果 ( Ingp ) 的 long 变 量 的 指针 。 
成 功 则 返回 0， 如 果 转 换 失 败 则 返回 一 个 负数 。 如 果 发 生 浴 出 ， 则 返 


回 ECPG_INFORMIX_NUM_OVERFLOW o 


注意 ECPG 应 用 不 同 于 Informix 应 用 。 当 ECPG 点 用 中 的 限制 取决 于 ( -Lonc_max . .LoNG_MAX ) 的 
结构 ，Informix 限 制 long integer 的 范围 从 -2,147,483,647 到 2,147,483,647。 


rdatestr 
转换 一 个 date 类 型 到 C char 字 符 串 。 

int rdatestr(date d, char *str); 
这 个 函数 接收 2 个 参数 ， 第 一 个 是 日 期 转换 〈 d 和 第 二 个 参数 是 一 个 指向 目标 字符 串 的 指针 。 
输出 格式 总 是 yyyy-mm-dd ， 因 此 你 需要 为 字符 串 至 少 分 配 作 个 字 节 (包含 0 字 节 终止 符 ) 。 
成 功 函 数 则 返回 9， 出 错时 则 返回 一 个 负数 。 


注意 ECPG 点 用 不 同 于 Informix 应 用 。 Informix 中 格式 受到 环境 变量 设置 的 影响 。 然而 在 
ECPG 中 ， 你 不 能 改变 输出 格式 。 


rstrdate 
解析 日 期 的 文本 表示 。 


int rstrdate(char *str, date *d); 


这 个 函数 接受 日 期 转换 ( str ) 的 文本 表示 形式 和 指向 类 型 date( a ) 的 变量 的 指针 。 这 个 画 数 不 
允许 你 指明 格式 掩 码 。 它 使 用 Informix 缺 省 格式 掩 码 mm/dd/yyyy 。 实 质 上 ， 它 通 

过 rdefmtdate 实现 的 。 因 此 ， rstrdate 不 是 很 快 ， 如 果 你 有 选择 了 ， 你 应 该 选 

择 rdefmtdate ， 它 人 允许 你 明确 指定 掩 码 格式 。 


KAUA El AN rdefmtdate 一 样 的 值 。 


rtoday 
获取 当前 日 期 。 


void rtoday(date *d) 


Wate S—T is 4a BRA BAe a ) 的 指针 。 
Se Ex NESBA PeTYPESdate today FAB. 


rjulmdy 

从 date 类 型 的 变量 中 提取 一 天 ， 一 个 月 ， 一 年 中 的 值 。 

int rjulmdy(date d, short mdy[3]); 

这 个 画 数 接受 日 期 a 和 一 个 指向 3 个 短 整 型 数值 my 数组 的 指针 ， 变 量 名 表明 了 相继 顺 
Fe: mdy[e] 的 设置 包含 了 月 数 ， mdy[1] 的 设置 是 一 天 的 值 ， mdy[2] 包含 年 的 值 。 
函数 此 时 总 是 返回 0。 


实质 频数 使 用 pctyeesdate julmdy RX. 


rdefmtdate 


使 用 格式 掩 码 转换 字符 串 到 一 个 date 类 型 的 值 。 


int rdefmtdate(date *d, char *fmt, char *str); 


函数 接受 一 个 保持 操作 ( d ) 结 果 日 期 值 的 指针 。 格式 掩 码 用 于 解析 日 期 ( fmt ) 和 包含 

date( str ) 文 本 表示 形式 的 C char 字 符 串 。 文 本 表示 形式 期 望 匹 配 格式 掩 码 。 然 而 你 不 需要 
有 一 个 1:1 字 符 串 映射 格式 掩 码 。 它 仅 分 析 相 继 顺序 并 且 查 找 yy 或 者 yyyy 表明 年 的 位 

E, mm 表示 月 份 和 dd 表示 一 天 的 位 置 。 


图 数 返 回 下 列 值 : 
。 0 - 图 数 成 功 终止 。 


e ECPG_INFORMIX_ENOSHORTDATE - 在 日 ， 月 和 年 之 间 日 期 不 包含 定 界 符 。 在 这 种 情况 下 输入 
字符 串 必须 确切 地 6 或 8 个 字 节 但 是 不 是 这 样 的 。 


e ECPG_INFORMIX_ENOTDMY - 格式 字符 串 不 能 正确 显示 年 ， 月 ， 日 的 相继 顺序 。 

e ECPG_INFORMIX_BAD_DAY - 输入 字符 串 不 包含 一 个 有 效 的 天 数 。 

e ECPG_INFORMIX_BAD_MONTH - 输入 字符 串 不 包含 一 个 有 效 的 月 份 。 

e ECPG_INFORMIX_BAD_YEAR - 输入 字符 串 不 包含 一 个 有 效 的 年 份 。 
实质 上 这 个 辑 数 使 用 ectyeesdate defmt asc WARREN. 请 参阅 这 儿 的 实例 输入 的 表 。 


rfmtdate 
转换 一 个 date 类 型 变量 到 它 的 一 个 格式 掩 码 的 文本 表示 。 

int rfmtdate(date d, char *fmt, char *str); 
这 个 画 数 接收 一 个 日 期 转换 ( d )， 格式 掩 码 ( fmt ) 和 将 保持 日 期 ( str ) 的 文本 表示 形式 的 字 
符 串 。 
成 功 返 回 0， 如 果 产 生 错 误 则 返回 一 个 负 值 。 


实质 上 这 个 贺 数 使 用 perypPEsoate_fmt_asc HR. GBM ILWGIF 


rmdyjul 


从 指明 日 期 中 的 年 ， 月 ， 日 的 3 维 短 整 型 数组 中 创建 一 个 日 期 值 。 


int rmdyjul(short mdy[3], date *d); 


这 个 图 数 接收 一 个 3 维 短 整 型 ( mdy ) 数 组 和 一 个 指向 应 保持 操作 结果 的 日 期 类 型 变量 的 指针 。 
Sax SHWRS SIRE. 


实质 上 这 个 函数 使 用 pctypesdate_mdyjul 来 实现 。 


rdayofweek 
一 个 数字 表示 的 一 个 日 期 值 中 某 一 周 的 某 一 天 。 
int rdayofweek(date d); 


KARMA RS Sd 作为 其 唯一 的 参数 并 返回 一 个 整数 ， 表示 这 一 天 是 星期 几 。 
。 0 - 星期 日 


。 1 -星期 一 
。 2 -星期 二 


。 3 -星期 三 


。 4 -星期 四 
。 5 -星期 五 
。6 -星期 六 
实质 上 这 个 事 数 使 用 peryPESqate_dayofweek 来 实现 。 


dtcurrent 
检索 当前 的 timestamp。 


void dtcurrent(timestamp *ts); 


这 个 函数 检索 当前 timestamp 并 且 保 存 它 到 ts 指向 的 timestamp 变 量 中 。 


dtcvasc 


解析 一 个 文本 表示 的 timestamp 到 一 个 timestamp 变 量 。 


int dtcvasc(char *str, timestamp *ts); 


这 个 事 数 接收 解析 字符 串 (str) 和 一 个 指向 应 保持 操作 结果 (ts ) 的 timestamp 变 量 的 指 
针 。 


成 功 时 函数 返回 0， 发 生 错 误 的 时 候 返 回 负 数 。 


实质 上 这 个 辑 数 使 用 po6TyPEStimestamp_from_asc WR. 请 参见 这 儿 的 实例 输入 的 表 。 


Ñ 


dtcvfmtasc 
48 FA AR SU 25 FAT CARA Mtimestamp #timestamp = Æ- 


dtcvfmtasc(char *inbuf, char *fmtstr, timestamp *dtvalue) 


AARRE inbuf FFE, 使 用 ( fmtstr ERRA, 以 及 一 个 指向 保持 操作 
( dtvalue ) 结 果 的 timestamp 变 量 的 指针 。 


x SRL 通过 PGTYPEStimestamp_defmt_asc REL WM. 参见 文档 中 使 用 的 格式 说 明 符 列 
Ro 


Ñ 


AH RORE, R ERR AHR RE — A h R 


dtsub 


一 个 timestamp 与 另 一 个 相 减 ， 并 且 返 回 一 个 区 间 类 型 变量 。 


int dtsub(timestamp *tsi, timestamp *ts2, interval *iv); 


ABMS AA A, 其 中 ts2 指向 tsi 指向 的 时 间 惟 变量 ， 并 将 结果 存储 在 iv 指向 
的 区 间 变 量 中 。 


成 功 时 画 数 返回 0， 如 果 发 生 错 误 则 返回 一 个 负数 。 


dttoasc 


转换 一 个 timestamp 变 量 到 C char =F. 


int dttoasc(timestamp *ts, char *output); 


PHA MoE timestamp = S4472( ts ) 的 指针 和 保持 操作 output 结果 的 字符 串 。 
根据 SQL 标准 ， 转 换 ts 到 它 的 一 个 文本 表示 形式 ， 即 YYYY-MM-DD HH:MM:SS o 


成 功 酌 数 返 回 0， 如 果 产 生 错 误 则 返回 负数 。 


dttofmtasc 


使 用 格式 掩 码 将 timestamp 变 量 转 换 成 C char”。 


int dttofmtasc(timestamp *ts, char *output, int str_len, char *fmtstr); 


这 个 函数 接收 一 个 指向 作为 第 一 个 参数 ( ts ) 转 换 的 timestamp 的 指针 ， 以 及 指向 输出 缓存 
( output ) 的 指针 ， 已 经 分 配给 输出 缓存 ( str_len ) 的 最 大 长 度 和 用 于 转换 ( fmtstr ) 的 
格式 掩 码 。 


成 功 时 图 数 返 回 09， 如 果 产 生 错 误 则 返回 一 个 负数 。 


KE, se ENR 使 用 pctyeestimestamp_fmt_asc BB. 请 参阅 有 关 格 式 掩 码 说 明 的 使 用 获 
取 更 多 信息 。 


intoasc 
将 区 间 变 量 转换 成 C char 字 符 串 。 
int intoasc(interval *i, char *str); 
这 个 男 数 接收 一 个 指向 区 闻 变量 转换 ( i ) 的 指针 和 保持 操作 ( str ) 结 果 的 字符 串 。 它 依照 
SQL 标准 将 i 转换 成 文本 表示 形式 ， BM YYYY-MM-DD HH:MM:SS o 
MDa BORGO, WSR = +R MRE AB, 


rfmtlong 
将 长 整 型 数值 转换 成 使 用 格式 掩 码 的 文本 表示 形式 。 


int rfmtlong(long lng_val, char *fmt, char *outbuf); 


XPERIA lng_val ， WARA fm 和 指向 输出 缓存 outbuf 的 指针 。 
码 将 长 值 转 换 成 文本 表示 形式 。 


格式 掩 码 由 下 面 格式 指定 字符 组 成 。 
© * ( 星 号 ) - 如 果 这 个 位 置 是 空白 的 ， 否 则 ， 用 星 号 填充 。 
e & (& 符 号 ) -如 果 这 个 位 置 是 空白 的 ， 否 则 ， 用 规 填 充 。 

e # -将 前 导 需 转换 成 空格 。 

e alt; -字符 串 中 左 对 齐 数字 。 

。 ，( 喜 号 )- 将 四 个 或 更 多 数字 分 成 由 去 号 分 隔 的 三 个 数字 一 组 。 
©. (DS) - 这 个 字符 将 从 小 数 部 分 分 离 出 数 的 整数 部 分 。 

e - ( 减 号 ) - 如 果 数 是 负 值 ， 则 出 现 负 号 。 

。 + (加 号 ) -如 果 数 是 正 值 ， 则 出 现 加 号 。 

。 ( -这 将 替代 负数 前 面 的 减 号 。 减 号 将 不 会 出 现 。 

© ) -这 个 字符 替代 减 号 ， 并 且 在 负数 后 面 输出 。 


e $s - 货币 符号 。 


rupshift 
将 字符 串 转 换 为 大 写 。 
void rupshift(char *str); 


这 个 画 数 接收 一 个 指向 字符 串 的 指针 ， 并 且 将 每 个 小 写字 符 转 换 成 大 写字 符 。 


byleng 
返回 没有 计算 空格 的 字符 串 中 字符 的 数量 。 


int byleng(char *str, int len); 


它 依照 格式 掩 


这 个 函数 期 望 固定 长 度 字符 串 作 为 它 第 一 个 参数 ( str), 并 且 其 长 度 作为 第 二 个 参数 


(len) 它 返 回 重要 字符 数 ， 它 是 没有 空格 的 字符 串 的 长 度 。 


ldchar 
复制 一 个 固定 长 度 字 符 串 到 空 终 止 符 字 符 串 中 。 


void ldchar(char *src, int len, char *dest); 


KAREE KEFR] (src), HKE (ien) 和 一 个 指向 目标 内 存 〈 dest ) 
的 指针 。 注意 ， 你 需要 为 dest 指向 的 字符 串 至 少 储备 len+1 FP. KARERE len $F 
到 新 的 位 置 (至 少 如 果 源 字符 串 有 尾随 空格 ) 和 添加 空 终止 符 。 


rgetmsg 

int rgetmsg(int msgnum, char *s, int maxsize); 
XP EB ILIA BE R HL. 
rtypalign 

int rtypalign(int offset, int type); 


XP BILAN BE R No 


rtypmsize 


int rtypmsize(int type, int len); 


XP EB ILIA BE R HL. 


rtypwidth 


int rtypwidth(int sqltype, int sqllen); 


XP EB ILIA RE R HL. 


rsetnull 
设置 一 个 变量 为 空 。 


int rsetnull(int t, char *ptr); 


这 个 图 数 接收 一 个 表明 变量 类 型 的 整数 和 一 个 指向 映射 到 C char* 指 针 的 变量 自身 的 指针 。 
存在 下 面 类 型 : 

© CCHARTYPE -为 了 类 型 char 或 者 char* 的 变量 

e CSHORTTYPE -为 了 类 型 short int 的 变量 

e CINTTYPE -为 了 类 型 为 int 的 变量 

e CBOOLTYPE -为 了 类 型 boolean 的 变量 


© cFLOATTYPE -为 了 类 型 float 的 变量 


e CLONGTYPE -为 了 类 型 long 的 变量 

e cpouBLeTYPE -为 了 类 型 double 的 变量 

e CDECIMALTYPE -为 了 类 型 decimal 的 变量 
e CDATETYPE -为 了 类 型 date 的 变量 

e CDTIMETYPE -为 了 类 型 timestamp 的 变量 


下 面 是 调用 这 个 范 数 的 一 个 例子 


$char c[] = "abc me 

$short s = 17; 

$int i = -74874; 
rsetnull(CCHARTYPE, (char *) c); 


rsetnull(CSHORTTYPE, (char *) &s); 
rsetnull(CINTTYPE, (char *) &i); 


risnull 
如 果 变 量 是 空 ， 测 试 : 


int risnull(int t, char *ptr); 


SRA AX (t) 变量 的 类 型 以 及 一 个 指向 这 个 变量 (ptr) 的 指针 。 注意 后 者 需 
要 映射 到 一 个 char*。 BRB rsetnull 获取 可 能 变量 类 型 的 列表 。 


这 儿 是 如 何 使 用 这 个 男 数 的 一 个 例子 


$char c[] = "abc Ma 
$short s = 17; 
$int i = -74874; 


risnull(CCHARTYPE, (char *) c); 


risnull(CSHORTTYPE, (char *) &s); 
risnull(CINTTYPE, (char *) &i); 


33.15.5. 附加 常量 


注意 ， 这 里 所 有 的 常量 描述 错误 ， 他 们 都 被 定义 为 代表 负数 。 不 同 常量 的 描述 中 ， 你 还 可 以 
发 现 ， 目 前 的 应 用 中 表示 常量 的 值 。 然而 你 不 应 该 依赖 于 数量 。 但 是 你 可 以 依靠 它们 被 定义 
为 表示 负数 的 事实 。 


ECPG_INFORMIX_NUM_OVERFLOW 


如 果 在 计算 中 发 生 洽 出 ， 辑 数 返 回 这 个 值 。 实质 上 它 被 定义 为 -1200 (Informix) 。 


ECPG_INFORMIX_NUM_UNDERFLOW 


MRETRHRE Bia, BACKER. 实质 上 它 被 定义 为 -1201(Informix 定 义 )。 
ECPG_INFORMIX_DIVIDE_ZERO 

MRSS RRAS, BARKER. LAECRELYH -1202 (Informix 定 义 ) 。 
ECPG_INFORMIX_BAD_YEAR 

PR 4A SAR, RENTER, BARES. AECE 

为 -1204(Informix 定 义 )。 

ECPG_INFORMIX_BAD_MONTH 

PR 4S ARH, RMRAN—THR A, BARES. AECE 

为 -1205(Informix 定 义 )。 

ECPG_INFORMIX_BAD_DAY 

ORAS ARAM ate, RMRANB RE, HRORERT A, LARECREL 

为 -1206(Informix 定 义 )。 

ECPG_INFORMIX_ENOSHORTDATE 

如 果 解 析 程序 需要 一 个 短 日 期 表示 形式 而 没有 获得 正确 长 度 的 日 期 字符 串 ， 画 数 则 返回 这 个 
数值 。 实质 上 它 被 定义 为 -1209(Informix 定 义 )。 

ECPG_INFORMIX_DATE_CONVERT 

如 果 在 日 期 格式 之 间 发 生 错误 ， 那 么 函数 返回 该 值 。 实质 上 它 被 定义 为 -1210(Informix 定 
义 )。 

ECPG_INFORMIX_OUT_OF_MEMORY 

如 果 在 操作 期 间 内 存 耗 尽 ， 那 么 函数 返回 该 值 。 实 质 上 它 被 定义 为 -1211 (Informix 定 义 ) 。 
ECPG_INFORMIX_ENOTDMY 

如 果 解 析 程 序 应 该 得 到 一 个 掩 码 格式 (如 mmddyy ) 但 不 是 所 有 的 字段 都 被 正确 地 列 出 来 ， 邢 
数 返回 该 值 。 实质 上 它 被 定义 为 -1212(Informix 定 义 )。 

ECPG_INFORMIX_BAD_NUMERIC 

如 果 一 个 解析 程序 无 法 解析 为 数字 值 的 文本 表示 ， 因为 它 包含 错误 ， 或 者 如 果 程 序 不 能 完 


oe 因为 至 少 这 些 数值 变量 之 一 是 无 效 的 。 那 么 该 图 数 返 回 这 个 值 。 实质 
它 被 定义 为 -1213(Informix 定 义 )。 


ECPG_INFORMIX_BAD_EXPONENT 
如 果 解 析 程 序 无 法 解析 指数 ， 那 么 该 落 数 返回 此 值 。 实质 地 被 定义 为 -1216 (Informix 
aes 


ECPG_INFORMIX_BAD_DATE 


如 果 解 析 程 序 不 能 解析 日 期 ， 那 么 该 图 数 返 回 此 值 。 实质 上 它 被 定义 为 -1218 (Informix 
SORA 
ECPG_INFORMIX_EXTRA_CHARS 


如 果 不 能 解析 的 多 余 字 符 被 传递 给 解析 程序 ， 那 么 该 事 数 返回 这 个 值 。 实质 上 它 被 定义 
为 -1264 (Informix 定 义 ) 。 


33.16. 内 部 


这 一 节 解 释 ECPG 在 内 部 是 如 何 运转 的 。 这 些 信 息 有 时 候 可 以 帮助 用 户 理解 如 何 使 用 
ECPG。 

ecpg 写 到 输出 里 的 头 四 行 是 固定 的 行 。 两 行 是 注释 ， 另外 两 行 是 与 库 接口 的 必要 行 。 然后 
预 处 理 器 读 取 文件 并 且 写 输出 流 。 通常 它 只 是 把 所 有 东西 都 回 显 到 输出 中 去 。 


如 果 它 看 到 一 个 exec so 语句 ， 它 就 变换 并 且 修 改 它 。 命 令 以 exec sa Fk, A; 结尾 。 
所 有 在 中 间 的 东西 都 被 当 作 一 个 SQL 语句 并 且 进 行 变 量 代 换 的 解析 。 


如 果 一 个 符号 以 一 个 冒号 ( : ) 开头 ， 则 发 生变 量 代 换 。 在 EXEC SQL DECLARE 段 里 预先 声明 
的 变量 中 找 出 该 名 字 的 变量 。 


库 里 面 最 重要 的 孙 数 是 Ecpedo ， 它 负责 执行 大 多 数 命 舍 。 它 接受 变量 的 参数 个 数 。 这 些 参 
数 的 个 数 可 能 很 容易 达到 50 个 或 者 更 多 ， 我 们 希望 在 任何 平台 上 这 都 不 是 问题 。 


这 是 要 发 出 的 SQL 命令 。 它 被 输入 变量 修改 ， 也 就 是 说 ， 在 编译 时 未 知 的 ， 但 是 需要 输入 到 
命令 中 的 变量 。 此 处 变量 应 该 包含 字符 串 ? 。 


输入 变量 
每 个 输入 变量 都 导致 十 个 参数 的 生成 。 ( 见 下 文 ) 
ECPGt_EOIT 


一 个 enum 告诉 没有 更 多 输入 变量 了 。 


输出 变量 
每 个 输出 变量 导致 十 个 参数 的 创建 。 〈 见 下 文 ) 这 些 变量 被 这 些 酌 数 填充 。 
ECPGt_EORT 


一 个 指出 没有 更 多 变量 的 enum 。 

对 于 每 个 属于 SQL 命令 一 部 分 的 变量 ， 本 数 可 以 得 到 十 个 参数 : 
1， 作 为 特殊 符号 的 类 型 。 

2. 一 个 指向 其 数值 的 指针 ， 或 者 一 个 指向 指针 的 指针 。 


9. 


10. 


如 果 变 量 大 小 是 char 或 者 varchar o 

数组 中 元 素 的 个 数 (用 于 抓 取 数 组 ) 。 

指向 数组 中 下 一 个 元 素 的 偏 移 量 (用 于 抓 取 数 组 ) 。 

作为 一 种 特殊 符号 的 指示 器 变量 的 类 型 。 

一 个 指向 指示 器 变量 的 指针 。 

0 

指示 器 数组 中 的 元 素 个 数 (用 于 抓 取 数 组 ) 。 

指向 指示 器 数组 的 下 一 个 元 素 的 偏 移 量 (用 于 抓 取 数 组 ) 。 


请 注意 ， 不 是 所 有 SQL 命令 都 这 么 被 对 待 。 比如 ， 一 个 像 下 面 这 样 的 打开 游标 的 语句 。 


EXEC SQL OPEN _cursor_; 


不 会 被 拷贝 到 输出 中 。 而 是 在 open 命令 的 位 置 使 用 游标 的 DEcLARE 命令 ， 因为 它 同样 也 打 


开 游 标 。 
下 面 是 一 个 完整 的 例子 ， 描 述 了 文件 foo.pge 的 预 处 理 后 的 输出 (细节 可 能 随 着 每 个 不 同 的 
预 处 理 器 版 本 而 变化 ) 


EXEC SQL BEGIN DECLARE SECTION; 
int index; 

int result; 

EXEC SQL END DECLARE SECTION; 


EXEC SQL SELECT res INTO :result FROM mytable WHERE index = :index; 


被 翻译 成 : 


/* 通过 ecpg (2.6.0) 人 处 理 ， 通 过 预 处 理 器 添加 2 个 jnclude 文 件 */ 


#include <ecpgtype.h>; 
#include <ecpglib.h>; 


/* exec sql 开 始 声 明 段 */ 


#line 1 "foo.pgc" 


int index; 
int result; 


/* exec sq1 结 束 声 明 段 */ 


ECPGdo(__LINE__, NULL, "SELECT res FROM mytable WHERE index = ? ER 
ECPGt_int,&(index),1L,1L,sizeof(int), 
ECPGt_NO_INDICATOR, NULL , OL, OL, OL, ECPGt_EOIT, 
ECPGt_int,&(result),1L,1L,sizeof(int), 
ECPGt_NO_INDICATOR, NULL , OL, OL, OL, ECPGt_EORT); 


#line 147 "foo.pgc" 


(这 里 的 上 四 进 是 为 了 增强 可 读 性 加 的 ， 可 不 是 预 义理 器 能 干 的 事情 。 ) 
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信息 模式 由 一 组 视图 组 成 ， 它 们 包含 有 关 当 前 数据 库 里 定义 的 对 象 的 信息 。 信息 模式 是 SQL 
标准 里 定义 的 ， 因 此 可 以 认为 是 可 以 移植 的 ， 并 且 是 相对 稳定 的 一 和 系统 表 不 一 样 ， 系 统 表 
是 PostgreSQL 特 有 的 ， 是 在 实现 的 基础 上 进行 建 模 的 。 但 信息 模式 视图 不 包含 有 关 
PostgreSQL 特有 的 特性 的 信息 ; 你 可 以 查询 系统 表 或 者 其 它 PostgreSQL 特定 的 视图 查询 


它 。 
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Note: 当 查 询 数 据 库 约束 信息 时 ， 一 个 标准 兼容 的 查询 有 可 能 返回 一 到 多 行 。 这 是 因为 
在 一 个 模式 中 SQL 标 准 查询 约束 名 是 唯一 的 ， 但 是 PostgreSQL 并 不 强制 这 个 约束 。 
PostgreSQL 自动 产生 约束 名 避免 在 同一 个 模式 中 重复 ， 但 是 用 户 可 以 指定 重复 的 名 字 。 


当 查 询 信息 模式 视图 (如 check_constraint_routine_usage , check_constraints , 
domain_constraints ,和 referential_constraints ) 时 会 出 现 这 样 的 问 题 。 一 些 其 他 视 
图 有 相似 的 问题 ， 但 是 包含 表明 以 帮助 辨别 重复 的 行 ， 例如 constraint_column_usage , 


constraint_table_usage , table constraints o 
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34.1. 天 于 这 个 模式 


信息 模式 本 身 是 一 个 叫 information_schema 的 模式 。 这 个 模式 自动 存在 于 所 有 数据 库 中 。 这 
个 模式 的 所 有 者 是 数据 库 集群 中 的 最 初 的 数据 库 用 户 ， 并 且 这 个 用 户 天 然 就 拥有 这 个 模式 上 
的 所 有 权限 ， 包 括 删 除 它 的 权限 (不 过 这 么 干 省 下 来 的 空间 小 的 可 恰 ) 。 

缺 省 的 时 候 ， 信 息 模式 不 在 模式 搜索 路 径 中 ， 因 此 ， 你 需要 用 全 称 来 访问 里 面 的 所 有 对 象 。 


因为 信息 模式 里 的 一 些 对 象 的 名 字 是 可 能 在 用 户 应 用 中 出 现 的 普通 名 字 ， 所 以 ， 如 果 你 想 把 
信息 模式 放 在 路 径 中 的 话 ， 那 你 一 定 要 小 心 。 


34.2. 数据 类 型 


信息 模式 视图 的 字段 使 用 的 是 特殊 的 数据 类 型 ， 它 们 是 在 信息 模式 里 定义 的 。 这 些 都 是 在 内 
置 类 型 上 定义 的 简单 的 域 。 你 不 应 当 在 信息 模式 之 外 的 地 方 使 用 这 些 类 型 工作 ， 但 是 如 果 你 
的 应 用 从 信息 模式 中 选取 了 数据 ， 那 么 它 必须 面 对 它 们 。 

这 些 类 型 是 : 

cardinal_number 

非 负 整数 。 

character_data 

一 个 字符 串 (没有 声明 最 大 长 度 ) 。 

sql_identifier 

一 个 字符 串 。 这 个 类 型 用 于 SQL 标识 符 ， 类 型 character_data 用 于 任何 其 它 类 型 的 文本 数 
HE. 


time_stamp 
一 个 在 类 型 timestamp with time zone 上 的 域 。 
yes_or_no 


一 个 字符 串 域 要 么 包含 YEs 要 么 包含 No 。 这 在 信息 模式 中 用 来 表示 Boolean (true/false) 
据 。 (在 boolean 类 型 被 添加 到 SQL 标准 之 前 信息 模式 被 发 明 出 来 ， 为 保持 信息 模式 向 前 兼 
容 这 个 约定 是 必须 的 。) 


信息 模式 里 的 每 个 字段 都 有 这 五 种 类 型 之 一 。 


34.3. information_schema_catalog_name 
information_schema_catalog_name 是 一 个 总 是 包含 一 行 一 列 的 表 ， 里 面包 含 当 前 数据 库 的 名 
字 〈 用 SQL 术语 来 说 ， 是 当前 目录 ) 。 
Table 34-1. information_schema_catalog_name 字段 

名 字 数据 类 型 描述 


catalog_name sql_identifier 包含 这 个 信息 模式 的 数据 库 名 字 


34.4. administrable role authorizations 


视图 administrable_role_authorizations 标识 当前 用 户 有 管理 员 选 项 的 所 有 角色 。 
Table 34-2. administrable_role_authorizations 字段 
名 字 数据 类 型 描述 
,1 jgentifie。 赋予 角色 成 员 的 角色 名 称 (可 以 是 当前 用 户 ， 或 者 
= —MERBEARK ARKRKMPREMWTA A) 
sql_identifier 角色 名 称 


yes_or_no 


grantee 


role_name 


is_grantable 总 是 YES 


34.5. applicable_roles 


视图 applicable roles 标识 当前 用 户 所属 的 所 有 组 。 这 意味 着 有 一 些 角色 束缚 限制 由 当前 用 
户 授予 问题 中 的 角色 。 当 前 用 户 本 身 也 是 一 个 可 用 的 角色 。 这 个 适合 的 可 用 角色 组 通常 被 用 


做 许可 检查 。 


Table 34-3. applicable_roles 字段 


名 字 数据 类 型 
grantee sql_identifier 
role_name sql_identifier 


is_grantable yes_or_no 


描述 


赋予 角色 成 员 的 角色 名 称 〈 可 以 是 当前 用 户 ， 或 者 
一 个 在 角色 成 员 关 系 谋 套 中 的 不 同 的 角色 成 员 ) 


角色 名 
如 果 授 权 者 有 管理 员 权 限 的 话 为 yes , 否则 为 no 


34.6. attributes 


视图 attributes 包含 有 关 在 数据 库 中 定义 的 复合 数据 类 型 的 属性 信息 。 《注意 ， 视 图 不 会 提 


供 表 字段 的 信息 ， 在 PostgreSQL 环 境 中 有 时 被 叫做 属性 。) 


只 有 当前 用 户 有 权限 时 才 显 示 这 


些 属 性 〈 通 过 成 为 它 的 所 有 者 或 者 在 这 个 类 型 上 有 某 些 权限 ) 。 


Table 34-4. attributes 字段 
名 字 
udt_catalog 


udt_schema 
udt_name 


attribute_name 
ordinal_position 
attribute_default 


is_nullable 


data_type 


character_maximum_length 


character_octet_length 


character_set_catalog 


数据 类 型 
sql_identifier 


sql_identifier 
sql_identifier 


sql_identifier 
cardinal_number 
character_data 


yes_or_no 


character_data 


cardinal_number 


cardinal_number 


sql_identifier 


描述 


包含 数据 类 型 的 数据 库 名 称 
(总 是 在 当前 数据 库 中 ) 


包含 数据 类 型 的 模式 名 称 
数据 类 型 名 称 
属性 名 


数据 类 型 中 的 属性 的 顺序 位 置 
(从 1 开始 计数 ) 


属性 的 默认 表达 式 


如 果 属 性 可 能 为 空 则 为 ves , 
如 果 不 为 空 则 为 No 。 


如 果 它 是 内 建 类 型 ， 那 么 是 属 
性 的 数据 类 型 ， 或 者 如 果 它 是 
一 些 数 组 ， 那么 是 ARRAY (在 
这 种 情况 下 ， 查 看 视 
element_types ) ， 其 它 情 
况 是 USER-DEFINED (在 这 种 情 
Zl 

在 attribute_udt_name 和 相关 
字段 中 定义 类 型 ) 。 


如 果 data_type 标识 一 个 字符 
或 比特 流 类 型 ， 那 么 是 声明 的 
RAKE; 对 于 所 有 其 它 的 数 
据 类 型 或 如 果 没 有 声明 最 大 长 
度 都 用 null。 


如 果 data_type 识别 一 个 字符 
类 型 ， 那么 最 大 可 能 长 度 在 一 
个 数据 的 字 节 (bytes) 中 ;对 
于 所 有 其 它 的 数据 类 型 为 null。 
最 大 的 字 节 长 度 取决 于 声明 的 
字符 最 大 长 度 (参考 上 文 ) 和 
服务 器 的 编码 。 


在 PostgreSQL 中 的 不 适用 特性 


character_set_schema 


character_set_name 


collation_catalog 


collation_schema 


collation_name 


numeric_precision 


numeric_precision_radix 


numeric_scale 


datetime_precision 


sql_identifier 


sql_identifier 


sql_identifier 


sql_identifier 


sql_identifier 


cardinal_number 


cardinal_number 


cardinal_number 


cardinal_number 


在 PostgreSQL 中 的 不 适用 特性 
在 PostgreSQL 中 的 不 适用 特性 


包含 属性 排序 规则 的 数据 库 名 
称 (总 是 当前 数据 库 ) ， RB 
或 属性 的 数据 类 型 不 可 排序 时 
为 null。 


包含 属性 排序 规则 的 模式 名 ， 
缺 省 或 属性 的 数据 类 型 不 可 排 
序 时 为 null。 


属性 的 排序 规则 的 名 称 ， 缺 省 
或 属性 的 数据 类 型 不 可 排序 时 
为 null。 


如 果 data_type 标识 一 个 数字 
类 型 ， 那 么 该 字段 (Az 
者 公开 地 ) 包含 属性 类 型 的 精 
度 。 该 精度 表明 了 有 效 数 字 的 
位 数 。 它 可 以 用 在 十 进 制 
(base 10) 或 者 二 进 制 (base 
2) 中 ， 按 照 说 明 在 字段 
numeric_precision_radix 中 。 
对 于 所 有 其 它 的 数据 类 型 ， 该 
字段 为 null。 


如 果 data_type 标识 一 个 数字 
类 型 ， 该 字段 表明 基于 字段 
numeric_precision 和 字 

段 numeric_scale 中 的 值 。 值 
要 么 是 2 要 么 是 10. 对 于 所 有 其 
它 的 数据 类 型 ， 字 段 是 null。 


如 果 data_type 标识 一 个 精确 
的 数字 类 型 ， 那 么 该 字段 〈 公 
开 地 或 隐 含 地 ) 包含 属性 类 型 
的 数值 范围 。 该 数值 范围 表明 
了 小 数 点 右边 有 效 数字 位 数 。 
它 可 以 用 在 十 进 制 (base 10) 或 
者 二 进 制 (base 2) 中 ， 详 细 说 明 
在 字段 
numeric_precision_radix 中 。 
对 于 所 有 其 它 的 数据 类 型 ， 该 
字段 为 null。 


如 果 data_type 标识 一 个 日 

HA, tial, tag, Ai ba 
类 型 ， 该 字段 (公开 地 或 隐 合 
th) 包含 属性 类 型 的 精确 到 小 
数 部 分 的 秒 ， 就 是 说 ， 秒 的 值 
小 数位 数 保持 到 小 数 点 后 面 。 

对 于 所 有 其 它 的 数据 类 型 ， 该 


字段 是 null。 


interval_type 


interval_precision 


attribute_udt_catalog 


attribute_udt_schema 


attribute_udt_name 
scope_catalog 
scope_schema 


scope_name 


maximum_cardinality 


dtd_identifier 


is_derived_reference_attribute 


character_data 


cardinal_number 


sql_identifier 


sql_identifier 


sql_identifier 
sql_identifier 
sql_identifier 


sql_identifier 


cardinal_number 


sql_identifier 


yes_or_no 


如 果 data type 标识 一 个 间隔 
类 型 ， 该 字段 包含 为 这 个 属性 
包含 的 字段 的 时 间 间 隔 说 明 ， 
例如 ， YEAR TO MONTH , 

DAY TO SECOND 等 等 。 如 果 没 
有 声明 字段 限制 (也 就 是 ， 间 
隔 接受 所 有 字段 }) ， 和 对 所 有 
其 他 数据 类 型 ， 该 字段 都 是 


null. 

在 PostgreSQL 中 的 不 适用 特性 
(参阅 datetime_precision 获 

取 间 隔 类 型 属性 的 小 数秒 精 

属性 数据 类 型 被 指定 的 数据 库 

名 (总 是 在 当前 数据 库 中 ) 

属性 数据 类 型 被 指定 的 模式 名 


称 

属性 数据 类 型 名 称 

在 PostgreSQL 中 的 不 适用 特性 
在 PostgreSQL 中 的 不 适用 特性 
在 PostgreSQL 中 的 不 适用 特性 
总 是 null， 因 为 在 PostgreSQL 
中 数组 的 最 大 基数 总 是 不 受 限 


字段 的 数据 类 型 描述 符 的 一 个 
标示 符 ， 在 表格 的 数据 类 型 描 
述 符 中 是 唯一 的 。 这 个 对 于 加 
入 其 它 的 这 样 的 标示 符 的 实例 
是 主要 有 用 的 。 (标示 符 的 特 
定格 式 没 有 指定 且 也 不 保证 在 
以 后 的 版 本 中 不 会 改变 ) 


在 PostgreSQL 中 的 不 适用 特性 


也 可 以 在 Section 34.16 中 查阅 ， 一 个 类 似 的 结构 视图 ， 一 些 字段 的 进一步 详细 信息 。 


34.7. character_sets 

视图 character_sets 标识 在 当前 数据 库 中 可 用 的 字符 集 。 因为 PostgreSQL 不 支持 在 一 个 数据 
库 中 有 多 个 字符 集 ， 所 以 这 个 视图 只 能 显示 一 个 ， 也 就 是 数据 库 编码 。 

请 注意 下 列 条 目 在 SQL 标 准 中 是 怎样 使 用 的 : 

字符 指令 系统 


一 个 概要 的 字符 集合 ， 例 如 uNIcopE , ucs ,或 LATIN1 。 不 是 作为 一 个 SQL 对 象 公开 的 ， 但 
是 在 这 个 视图 中 可 见 。 


字符 编码 形式 


一 些 字 符 指 令 系 统 的 编码 。 大 多 数 老 旧 的 字符 指令 系统 只 使 用 一 种 编码 形式 ， 并 且 因此 他 们 
没有 单独 的 名 字 (例如 LATIN1 是 一 种 适用 于 LATIN1 指令 系统 的 编码 形式 ) 。 但 是 例如 
Unicode 有 编码 形式 uTF8 ，UTF16 等 等 。 (不 是 所 有 都 被 PostgreSQL 支 持 ) 。 编 码 形式 不 是 
作为 SQL 对 象 公开 的 ， 但 是 在 这 个 视图 中 可 见 。 


字符 集 


一 个 标志 字符 指令 系统 的 命名 的 SQL 对 象 ， 一 种 字符 编码 ， 和 一 个 缺 省 的 排序 规则 。 一 个 预 
定义 的 字符 集 通 常 和 编码 形式 有 相同 的 名 称 ， 但 是 用 户 可 以 定义 其 他 名 称 。 例如 ， 字 符 
集 utrs 通常 识别 字符 指令 系统 ucs, 编码 形式 utres 和 一 些 缺 省 的 排序 规则 。 


你 可 以 认为 PostgreSQL 中 的 一 个 "encoding" 是 一 个 字符 集 或 一 种 字符 编码 形式 。 他 们 将 有 相 
同 的 名 称 ， 并 且 在 一 个 数据 库 中 只 能 有 一 个 。 


Table 34-5. character_sets 字段 


名 字 


character_set_catalog 


character_set_schema 


character_set_name 


character_repertoire 
form_of_use 
default_collate_catalog 


default_collate_schema 


default_collate_name 


数据 类 型 


sql_identifier 


sql_identifier 


sql_identifier 


sql_identifier 
sql_identifier 
sql_identifier 


sql_identifier 


sql_identifier 


描述 
字符 集 当 前 还 没有 作为 模式 对 象 实现 ， 
所 以 这 个 字段 是 null。 
字符 集 当 前 还 没有 作为 模式 对 象 实现 ， 
所 以 这 个 字段 是 null。 
字符 集 的 名 称 ， 目 前 是 作为 数据 库 编 码 
的 显示 名 称 实现 的 。 
字符 系统 指令 ， 如 果 编 码 是 uTF8 则 显 
示 ucs ， 否 则 只 显示 编码 名 称 
字符 编码 形式 ， 和 数据 库 编 码 相同 


包含 缺 省 排序 规则 的 数据 库 名 (总 是 当 
前 数据 库 ， 如 果 指 定 了 任意 排序 规则 ) 


包含 缺 省 排序 规则 的 模式 名 


缺 省 排序 规则 名 。 人 缺 省 排序 规则 指定 为 
匹配 coLLATE 和 cTYPE 当前 数据 库 设 
置 的 规则 。 如 果 没 有 这 种 规则 ， 那 么 这 
个 字段 和 相关 的 模式 和 目录 字段 为 
null, 


34.8. check_constraint_routine_usage 


视图 check_constraint_routine_usage 标识 被 一 个 检查 约束 条 件 使 用 的 日 常 活动 (HAA 
序 ) 。 只 有 那些 属于 当前 启用 角色 的 日 常 活动 被 显示 。 


Table 34-6. check_constraint_routine_usage 字段 


名 字 数据 类 型 描述 

constraint_catalog sql_identifier 包含 该 约束 的 数据 库 名 字 (总 是 当前 数据 
库 ) 

constraint_schema sql_identifier 包含 该 约束 的 模式 名 字 

constraint_name sql_identifier 约束 的 名 字 

specific_catalog sql_identifier 包含 函数 的 数据 库 名 称 (总 是 当前 数据 库 ) 

specific_schema sql_identifier 包含 函数 的 模式 名 称 


函数 的 "专用 名 "。 参 闵 Section 34.40 获 取 详 


specific_name sql identifier = 自 
细 信 NO 


34.9. check_constraints 


视图 check_constraints 包含 所 有 当前 用 户 拥有 的 检查 约束 ， 可 能 是 定义 在 表 上 的 ， 也 可 能 是 
定义 在 域 上 的 。 ( 表 或 者 域 的 所 有 者 就 是 约束 的 所 有 者 。) 


Table 34-7. check_constraints 字段 


名 字 数据 类 型 描述 
a 米 co (y Bug 
constraint_catalog sql_identifier 包含 此 约束 的 数据 库 的 名 字 (总 是 当前 数据 
库 ) 
constraint_schema sql_identifier 包含 此 约束 的 模式 的 名 字 
constraint_name sql_identifier 约束 的 名 字 


check_clause character_data 检查 约束 的 检查 表达 式 


34.10. collations 


视图 collations 包含 当前 数据 库 可 用 的 排序 规则 。 


Table 34-8. collations 字段 


名 字 数据 类 型 
collation_catalog sql_identifier 
collation_schema sql_identifier 
collation_name sql_identifier 
pad_attribute character_data 


描述 


包含 该 排序 规则 的 数据 库 的 名 字 (总 是 当前 数 
据 库 ) 


包含 该 排序 规则 的 模式 的 名 字 
缺 省 排序 规则 的 名 字 
总 是 no PAD5 (PostgreSQL 不 支持 可 替代 


的 PAD SPACE o ) 


34.11. 


collation_character_set_applicability 


视图 collation_character_set_applicability 指定 可 用 的 排序 规则 适用 于 哪个 字符 集 。 在 
PostgreSQL 中 ， 每 个 数据 库 只 有 一 个 字符 集 (参阅 Section 34.7 里 面 的 说 明 ) ， 所 以 该 视图 


并 不 提供 多 少 有 用 的 信息 。 


Table 34-9. collation_character_set_applicability 字段 


名 字 
collation_catalog 


collation_schema 


collation_name 


character_set_catalog 


character_set_schema 


character_set_name 


数据 类 型 
sql_identifier 


sql identifier 


sql identifier 


sql_identifier 


sql_identifier 


sql_identifier 


描述 


包含 该 排序 规则 的 数据 库 的 名 字 (总 是 当 
前 数据 库 ) 


包含 该 排序 规则 的 模式 的 名 字 
缺 省 排序 规则 的 名 字 


字符 集 当 前 没有 作为 模式 对 象 实现 ， 所 以 
这 个 字段 是 null。 
字符 集 当 前 没有 作为 模式 对 象 实现 ， 所 以 
这 个 字段 是 null。 


字符 集 的 名 字 


34.12. column_domain_usage 


视图 column_domain_usage 标识 所 有 使 用 了 一 些 域 的 字段 ( 表 或 者 视图 的 ) ， 这 些 域 是 在 当前 
数据 库 中 定义 的 并 且 是 当前 用 户 拥 有 的 。 


Table 34-10. column_domain_usage 字段 


名 字 数据 类 型 描述 
domain_catalog sql_identifier 包含 该 域 的 数据 库 的 名 字 (总 是 当前 数据 库 ) 
domain_schema sql_identifier 包含 该 域 的 模式 的 名 字 
domain_name sql_identifier 该 域 的 名 字 
table_catalog sql_identifier ”包含 该 表 的 数据 库 的 名 字 (总 是 当前 数据 库 ) 
table_schema sql_identifier 包含 此 表 的 模式 名 字 
table_name sql_identifier 表 的 名 字 


column_name sql_identifier 字段 的 名 字 


34.13. column_options 


视图 column_options 包含 所 有 在 当前 数据 库 中 为 外 表 字 段 定 义 的 选项 。 当前 用 户 登 录 后 只 
示 这 些 外 表 字 段 〈 通 过 成 为 所 有 者 或 拥有 某 些 权限 ) 。 


Table 34-11. column_options 字段 


RF 
table_catalog 
table_schema 
table_name 
column_name 
option_name 


option_value 


数据 类 型 
sql_identifier 
sql_identifier 
sql_identifier 
sql_identifier 
sql_identifier 


character_data 


描述 
包含 该 外 表 的 数据 库 的 名 字 (总 是 当前 数据 库 ) 
包含 该 外 表 的 模式 的 名 字 
外 表 的 名 字 
字段 的 名 字 
选项 的 名 字 


显 


34.14. column_privileges 
视图 column_privileges 标 出 所 有 在 当前 用 户 的 字段 上 赋予 的 权限 或 者 当前 用 户 赋予 的 字段 的 
权限 。 每 个 字段 、 授 权 人 和 被 赋予 权利 的 用 户 组 成 一 行 。 


如 果 权 限 被 赋予 整个 表 ， 它 将 在 这 个 视图 中 显示 为 每 一 个 字段 赋 权 ， 但 是 它 只 为 字段 粒度 有 
意义 的 权限 类 型 : SELECT , INSERT , UPDATE , REFERENCES o 


Table 34-12. column_privileges 字段 


AF 数据 类 型 描述 
grantor sql_identifier 赋予 权限 的 用 户 的 名 字 
grantee sql_identifier 被 赋予 权限 的 用 户 的 名 字 


table_catalog 


据 库 ) 
table_schema sql_identifier 包含 该 字段 的 表 所 在 的 模式 的 名 字 
table_name sql_identifier 包含 该 字段 的 表 的 名 字 
column_name sql_identifier 该 字段 的 名 字 


privilege_type 


is_grantable 


sql_identifier 


character_data 


yes_or_no 


包含 该 字段 的 表 所 在 的 数据 库 名 字 (总 是 当前 数 


权限 类 型 : SELECT ，INSERT , UPDATE , 或 者 


REFERENCES 


如 果 权 限 可 以 赋予 ， 为 ves , BMA no 


34.15. column_udt_usage 


视图 column_udt_usage 标 出 所 有 使 用 属于 当前 用 户 的 数据 类 型 的 字段 。 请 注意 ， 在 
PostgreSQL 里 ， 内 和 置 的 数据 类 型 的 行为 和 用 户 定义 的 类 型 相似 ， 因此 它们 也 在 这 里 包括 进来 
了 。 人 参阅 Section 34.16 获 取 细 节 。 


Table 34-13. column_udt_usage 字段 


名 字 


udt_catalog 


udt_schema 


udt_name 


table_catalog 
table_schema 
table_name 


column_name 


数据 类 型 


sql identifier 


sql_identifier 


sql identifier 


sql_identifier 
sql identifier 
sql identifier 


sql identifier 


描述 
这 个 字段 数据 类 型 (如 果 适 用 ， 就 是 域 的 基础 类 
型 ) 定义 所 在 的 数据 库 名 字 (总 是 当前 数据 
库 ) 。 


字段 数据 类 型 (如果 适用 ， 就 是 域 的 基础 类 型 ) 
定义 所 在 的 模式 名 字 。 


字段 数据 类 型 的 名 称 (如 果 适 用 ， 就 是 域 的 基础 
类 型 ) 


包含 该 表 的 数据 库 名 (总 是 当前 数据 库 ) 
包含 该 表 的 模式 的 名 称 
表 的 名 字 


字段 的 名 字 


34.16. columns 


视图 columns 包含 有 关 数 据 库 中 所 有 表 字段 (或 者 视图 字段 ) 的 信息 。 不 包括 系统 字段 (H 
如 oid 等 ) 。 只 有 那些 当前 用 户 有 权 访 问 的 字段 才 会 显示 出 来 (要 么 是 所 有 者 ， 要 么 是 有 些 
权限 ) 。 


Table 34-14. columns 字段 


名 字 数据 类 型 描述 
table_catalog sql_identifier 包含 表 的 数据 库 的 名 字 (总 是 当前 数 
据 库 ) 
table_schema sql_identifier 包含 表 的 模式 的 名 字 
table_name sql_identifier 表 的 名 字 
column_name sql_identifier 字段 的 名 字 
ordinal_position cardinal_number 字段 在 表 中 的 位 置 序号 (M1 开始 ) 
column_default character_data 字段 的 缺 省 表达 式 


如 果 字 段 可 能 为 空 ， 则 为 ves, MR 
知道 它 不 能 为 空 ， 则 为 No 。 非 空 约 
束 是 我 们 得 知 字段 不 能 为 空 的 一 个 手 
段 ， 但 是 还 可 能 有 其 它 的 。 


如 果 它 是 一 个 内 置 类 型 ， 那 么 为 字段 
的 数据 类 型 ， 如 果 它 是 某 种 数组 ， 则 
为 array (EMRE, SMR 
element_types ) , 否则 就 

data_type character_data 是 USER-DEFINED (这 时 ， 类 型 定义 
在 udt_name 和 相关 的 字段 上 ) 。 如 
果 字 段 基 于 域 ， 这 个 字段 引用 底层 域 
类 型 (而 域 是 在 domain_name 和 相关 
字段 里 定义 的 ) 。 


如 果 data_type 标识 一 个 字符 或 者 位 
串 类 型 ， 那 么 就 是 声明 的 最 大 长 度 ; 
如 果 是 其 它 类 型 或 者 没有 定义 最 大 长 
度 ， 就 是 空 。 


如 果 data_type 标识 一 个 字符 类 型 ， 
就 是 以 字 节 记 的 最 大 可 能 长 度 ; 所 有 

character_octet_length cardinal_number 其 它 类 型 都 是 空 。 最 大 字 节 长 度 取决 
于 声明 的 字 节 最 大 长 度 〈 见 上 文 ) 和 
服务 器 编码 。 


如 果 data_type 标识 一 个 数值 类 型 ， 
这 个 字段 包含 (声明 的 或 隐 含 的 ) 这 
个 字段 的 数据 类 型 的 精度 。 精 度 表示 


is_nullable yes_or_no 


character_maximum_length cardinal_number 


numeric_precision 


numeric_precision_radix 


numeric_scale 


datetime_precision 


interval_type 


interval_precision 


character_set_catalog 


character_set_schema 


character_set_name 


collation_catalog 


cardinal_number 


cardinal_number 


cardinal_number 


cardinal_number 


character_data 


cardinal_number 


sql_identifier 


sql_identifier 


sql_identifier 


sql_identifier 


有 效 小 数位 的 长 度 。 它 可 以 用 十 进 制 
或 者 二 进 制 来 表示 ， 这 一 点 

在 numeric_precision_radix 字段 里 
声明 。 对 于 其 它 数据 类 型 ， 这 个 字段 


i=} 
是 空 。 


如 果 data_type 标识 一 个 数值 类 型 ， 
这 个 字段 标识 字段 
numeric_precision 和 numeric_scale 
里 的 数据 是 多 少 进 制 的 。 值 要 人 么 是 2 
要 么 是 10。 对 于 所 有 其 它 数据 类 型 ， 


这 个 字段 是 空 。 


如 果 data_type 标识 一 个 精确 的 数值 
类 型 ， 那么 这 个 字段 包含 〈 声 明 的 或 
ARA) 这 个 字段 上 这 个 类 型 的 数 
值 范围 。 数值 范围 表明 小 数 点 右边 的 
有 效 小 数位 的 数目 。 它 可 以 用 十 进 制 
(10 为 基 ) 或 者 二 进 制 (二 为 基 ) 来 
表示 ， 正 如 字 

段 numeric_precision_radix 声明 的 


那样 。 对 于 所 有 其 它 数据 类 型 ， 这 个 
字段 是 空 。 


如 果 data_type 标识 一 个 日 期 ， 时 
il, taZ, RA Maka, 该 字段 
(公开 地 或 隐 合 地 ) 包含 该 字段 类 型 
的 小 数秒 精度 ， 就 是 说 ， 小 数位 数 保 
持 到 小 数 点 后 面 。 对 于 所 有 其 它 的 数 
据 类 型 ， 该 字段 是 null。 


如 果 data_type 标识 一 个 间隔 类 型 ， 
这 个 字段 包含 这 个 字段 时 间 间 隔 声 
BA, 例如 ， YEAR TO MONTH , 

DAY To SECOND 等 等 。 如 果 没 有 指定 
字段 限制 (也 就 是 ， 间 隔 接 受 所 有 字 
段 )， 或 对 于 所 有 其 他 数据 类 型 ， 这 


个 字段 是 null。 


用 于 一 个 PostgreSQL 不 可 用 的 特性 
(参阅 datetime_precision 获取 间隔 


类 型 字段 的 小 数秒 精度 ) 
用 于 PostgreSQL 里 一 个 不 可 用 的 特 
性 


用 于 PostgreSQL 里 一 个 不 可 用 的 特 
性 


用 于 PostgreSQL 里 一 个 不 可 用 的 特 
性 


包 
F (总 是 当前 数据 库 ) , RAKES 


合 该 字段 的 排序 规则 的 数据 库 的 名 
总 
段 的 数据 类 型 不 可 排序 时 为 null。 


collation_schema 


collation_name 


domain_catalog 


domain_schema 


domain_name 


udt_catalog 


udt_schema 


udt_name 


scope_catalog 


scope_schema 


scope_name 


maximum_cardinality 


dtd_identifier 


is_self_referencing 


is_identity 


identity_generation 


identity_start 


sql_identifier 


sql_identifier 


sql_identifier 


sql_identifier 


sql_identifier 


sql_identifier 


sql_identifier 


sql_identifier 


sql_identifier 


sql_identifier 


sql_identifier 


cardinal_number 


sql_identifier 


yes_or_no 


yes_or_no 


character_data 


character_data 


包含 该 字段 的 排序 规则 的 模式 的 名 
字 ， 缺 省 或 者 字段 的 数据 类 型 不 可 排 
序 时 为 null。 


字段 的 排序 规则 的 名 字 ， 缺 省 或 者 字 
段 的 数据 类 型 不 可 排序 时 为 null。 

如 果 字 上 段 是 域 类 型 ， 就 是 该 域 定义 所 
在 的 数据 库 的 名 字 (总 是 当前 数据 

库 ) ， 否 则 为 null。 

如 果 字 上 段 是 域 类 型 ， 就 是 域 定义 所 在 
的 模式 的 名 字 ， 否 则 为 null。 

如 果 字 上 段 是 域 类 型 ， 就 是 该 域 的 名 

字 ， 否 则 为 null。 

这 个 字段 数据 类 型 (如 果 适 用 ， 就 是 
底层 域 类 型 ) 定义 所 在 的 数据 库 的 名 
F (总 是 当前 数据 库 ) 。 

这 个 字段 数据 类 型 (如 果 适 用 ， 就 是 
底层 域 类 型 ) 定义 所 在 的 模式 名 字 。 
这 个 字段 数据 类 型 OREH, Me 
底层 域 类 型 ) 的 名 字 。 

用 于 PostgreSQL 里 一 个 不 可 用 的 特 
性 


用 于 PostgreSQL 里 一 个 不 可 用 的 特 
性 
用 于 PostgreSQL 里 一 个 不 可 用 的 特 
性 


总 是 空 ， 因 为 在 PostgreSQL 里 数组 
总 是 有 无 限 的 最 大 维 数 

一 个 该 字段 的 数据 类 型 描述 符 的 标识 
符 ， 在 属于 这 个 表 中 的 所 有 的 数据 类 
型 描述 符 中 唯一 。 这 个 字段 主要 用 于 
和 其 它 这 样 的 标识 符 实 例 连 接 。 (这 
个 标识 符 的 确切 格式 没有 定义 并 且 不 
保证 在 将 来 的 版 本 中 保持 一 样 。) 


用 于 PostgreSQL 里 一 个 不 可 用 的 特 
性 
用 于 PostgreSQL 里 一 个 不 可 用 的 特 


用 于 PostgreSQL 里 一 个 不 可 用 的 特 
性 


用 于 PostgreSQL 里 一 个 不 可 用 的 特 
性 


identity_increment character_data 用 于 PostgreSQL 里 一 个 不 可 用 的 特 


性 
identity_maximum character_data oer toa 
identity_minimum character_data A ieee ahaa 
TETEE ET A a 
is_generated character_data ea eae aes 
generation_expression character_data 人 

如 果 字 段 为 可 更 新 则 为 yes, BM 
is_updatable yes_or_no 为 no ( 基 表 中 的 字段 总 是 可 以 更 新 


的 ， 而 试图 中 的 字段 则 不 一 定 ) 


因为 数据 类 型 在 SQL 里 可 以 用 多 种 方法 定义 ， 并 且 PostgreSQL 包 含 额 外 的 定义 数据 类 型 的 方 
法 ， 因此 他 们 在 信息 模式 里 的 表现 形式 可 能 不 太一 样 。 字 段 datatype 会 被 用 于 标识 该 字段 
底层 的 内 置 数 据 类 型 。 在 PostgreSQL 里 ， 这 意味 着 类 型 将 定义 在 系统 表 模 

式 pg_catalog 里 。 如 果 应 用 可 以 很 好 地 处 理 那 些 重 要 的 内 置 类 型 (比如 ， 对 数值 类 型 格式 化 
成 不 同 的 东西 ， 或 者 使 用 在 精度 字段 里 的 数据 ) ， 那 么 这 个 字段 是 有 用 的 。 字段 udt_name , 
udt_schema ， 和 udt_catalog 总 是 标识 该 字段 的 底层 数据 类 型 ， 即使 字段 是 基于 域 的 也 一 
样 。 (因为 PostgreSQL 把 内 置 类 型 看 作 和 用 户 定义 类 型 一 样 ， 所 以 ， 内 置 类 型 也 在 这 里 出 
现 。 这 是 对 SQL 标准 的 一 个 扩展 。) 如 果 一 个 应 用 想 根据 数据 类 型 的 不 同 而 区 别处 理 数据 ， 
那么 应 该 使 用 这 些 字段 ， 因为 在 这 种 情况 下 它 不 会 在 意 这 个 字段 是 否 真正 基于 域 的 。 如 果 这 
个 字段 基于 一 个 域 ， 那么 该 域 的 标识 保存 在 字段 domain_name , domain_schema , 

和 domain_catalog 里 。 如 果 你 想 把 字段 和 他 们 相关 的 数据 类 型 凑 成 对 儿 ， 并 且 把 域 当 作 不 同 
的 类 型 义理 ， 你 可 以 这 么 写 coalesce(domain_name, udt_name) 等 等 。 


34.17. constraint_column_usage 


视图 constraint_column_usage 标识 在 当前 数据 库 中 使 用 了 某 种 约束 的 所 有 字段 。 只 有 那些 属 
于 当前 用 户 的 表 中 的 字段 才 会 被 显示 出 来 。 对 于 检查 约束 ， 这 个 视图 标识 用 在 检查 表达 式 里 
的 字段 。 对 于 外 键 约 束 ， 这 个 视图 标识 外 键 引 用 的 字段 。 对 于 唯一 或 主键 约束 ， 这 个 视图 标 
识 被 约束 的 字段 。 


Table 34-15. constraint_column_usage Columns 
名 字 数据 类 型 描述 
RED (E) 约束 使 用 的 字段 所 在 的 表 所 在 


table_catalog sql_identifier 的 数据 库 名 (总 是 当前 数据 库 ) 
table_schema sql_identifier be 约束 使 用 的 字段 所 在 的 表 所 在 
teloe meni sql ident inier RED (22) 约束 使 用 的 字段 所 在 的 表 名 
column_name sql_identifier RED (£) 约束 使 用 的 字段 名 
constraint_catalog sql_identifier  ， 包 含 该 约束 的 数据 库 名 〈 总 是 当前 数据 库 ) 
constraint_schema sql_identifier 包含 该 约束 的 模式 名 


constraint_name sql_identifier 约束 名 


34.18. constraint_table_usage 


视图 constraint_table_usage 标识 当前 数据 库 中 被 某 些 约束 使 用 并 且 被 当前 用 户 拥有 的 所 有 
Ro ( 它 和 视图 table_constraints 不 同 ， 这 个 视图 标识 所 有 约束 以 及 他 们 定义 所 在 的 表 。 ) 
对 于 一 个 外 键 约束 ， 这 个 事务 标识 外 键 引用 的 表 。 对 于 唯一 或 者 主键 约束 ， 这 个 视图 只 是 简 
单 标识 这 个 约束 所 属 的 表 。 检查 约束 和 非 空 约束 没有 包含 在 这 个 视图 中 。 


Table 34-16. constraint_table_usage FX 


名 字 数据 类 型 描述 
table_catalog sql_identifier ee (总 是 
table_schema sqlidentifier 包含 被 某 些 约束 使 用 的 表 的 模式 的 字 
table_name sql_identifier 被 某 些 约束 使 用 的 表 名 
constraint_catalog sql_identifier 包含 该 约束 的 数据 库 名 (总 是 当前 数据 库 ) 
constraint_schema sql_identifier 包含 约束 的 模式 名 


constraint_name sql_identifier 约束 名 


34.19. data_type_privileges 


视图 data_type_privileges 标识 当前 用 户 可 访问 的 所 有 数据 类 型 描述 符 ， 只 要 他 是 被 描述 对 
象 的 所 有 者 或 者 有 某 些 权限 。 一 个 数据 类 型 描述 符 是 在 一 种 数据 类 型 用 在 表 字 段 ， 域 ， 或 者 
WA (参数 或 者 返回 类 型 ) 定义 的 时 候 生 成 的 ， 它 包含 一 些 有 关 这 个 数据 类 型 在 该 实例 中 如 
何 使 用 的 信息 〈 比 如， 声明 的 最 大 长 度 一 如果 有 的 话 ) 。 每 种 数据 类 型 描述 符 都 赋予 了 一 
个 任意 的 标识 符 ， 这 个 标识 符 在 赋予 某 个 对 象 (R, BH, BA) 的 所 有 数据 类 型 描述 符 标识 
符 中 唯一 。 这 个 视图 可 能 对 应 用 没什么 用 ， 但 是 用 于 在 信息 模式 中 定义 一 些 其 它 的 视图 。 


Table 34-17. data_type_privileges 字段 


AF 数据 类 型 描述 
object_catalog sql_identifier ERRER (总 是 当前 数据 
object_schema sql_identifier 包含 被 描述 对 象 的 模式 名 
object_name sql_identifier 被 描述 对 象 的 名 字 


被 描述 对 象 的 类 型 : TABLE (数据 类 型 描述 符 属 
于 该 表 的 一 个 字段 ) ， poMAIN 数据 类 型 描述 符 


object type ROS EEA 属于 该 域 ) ， routine (数据 类 型 描述 符 属于 该 
函数 的 一 个 参数 或 者 返回 的 数据 类 型 ) 之 一 。 
EE SENET 这 个 数据 类 型 描述 符 的 标识 符 ， 在 用 于 同一 个 对 


象 上 的 所 有 数据 类 型 描述 符 中 是 唯一 的 。 


34.20. domain constraints 


视图 domain_constraints 包含 属于 所 有 在 当前 数据 库 中 定义 的 域 的 约束 。 只 有 当前 用 户 有 权 
访问 的 域 地 显示 (通过 成 为 其 所 有 者 或 有 某 些 权 限 ) 。 


Table 34-18. domain constraints 字段 


ae 
constraint_catalog 
constraint_schema 
constraint_name 
domain_catalog 
domain_schema 


domain_name 


is_deferrable 


initially_deferred 


数据 类 型 
sql_identifier 
sql_identifier 
sql_identifier 
sql_identifier 
sql_identifier 


sql_identifier 


yes_or_no 


yes_or_no 


描述 
包含 此 约束 的 数据 库 名 (总 是 当前 数据 库 ) 
包含 此 约束 的 模式 名 
约束 名 
包含 该 域 的 数据 库 名 (总 是 当前 数据 库 ) 
包含 该 域 的 模式 名 
域名 


如 果 约 束 可 以 推迟 ， 则 为 YEs ， 如 果 不 行 ， 
则 为 NO 


如 果 约 束 可 以 推迟 ， 且 为 初始 推迟 ， 则 


为 YES, BRIA no. 


34.21. domain_udt_usage 


视图 domain_udt_usage 标识 所 有 使 用 当前 用 户 拥有 的 数据 类 型 的 域 。 请 注意 ， 在 PostgreSQL 
里 ， 内 置 数 据 类 型 的 行为 和 用 户 定义 的 类 型 一 样 ， 因此 它们 也 在 这 里 包含 。 


Table 34-19. domain_udt_usage 字段 


名 字 数据 类 型 描述 

pe TEIST ri 类 型 定义 所 在 的 数据 库 名 (总 是 当前 数 
udt_schema sql_identifier 这 个 域 数据 类 型 定义 所 在 的 模式 名 

udt_name sql_identifier 域 数据 类 型 名 

domain_catalog sqlidentifier 包含 该 域 的 数据 库 名 (总 是 当前 数据 库 ) 
domain_schema sql_identifier 包含 该 域 的 模式 名 


domain_name sql_identifier 域名 


34.22. domains 


视图 domains 包含 定义 在 当前 数据 库 中 的 所 有 域 。 


成 为 其 所 有 者 或 有 某 些 权限 ) 。 


Table 34-20. domains 字段 
名 字 
domain_catalog 


domain_schema 


domain_name 


data_type 


character_maximum_length 


character_octet_length 


character_set_catalog 
character_set_schema 


character_set_name 


collation_catalog 


collation_schema 


collation_name 


数据 类 型 
sql identifier 


sql_identifier 


sql_identifier 


character_data 


cardinal_number 


cardinal_number 


sql_identifier 
sql_identifier 


sql_identifier 


sql_identifier 


sql_identifier 


sql identifier 


只 有 当前 用 户 有 权 访 问 的 域 寺 显示 (通过 


描述 


包含 这 个 域 的 数据 库 名 (总 是 当前 数 
据 库 ) 


包含 这 个 域 的 模式 名 
域 的 名 字 


如 果 这 是 一 个 内 置 类 型 ， 就 是 域 的 数 
据 类 型 ， 如 果 他 是 某 种 数组 (这 时 ， 
参阅 视图 element_types ) ， 就 

是 ARRAY, 否则 

是 USER-DEFINED (这 个 时 候 ， 类 型 
在 udt_name 和 相关 的 字段 里 面 标 


Ro 


如 果 域 是 一 个 字符 或 者 位 串 类 型 ， 这 
是 定义 的 最 大 长 度 ， 其 它 数据 类 型 或 
者 没有 声明 最 大 长 度 ， 则 为 空 。 


如 果 域 有 一 个 字符 类 型 ， 这 是 最 大 可 
能 的 字 节 长 度 ; 其 它 所 有 的 数据 类 型 
则 为 null。 最 大 字 节 长 度 取决 于 所 声 
明 的 字符 最 大 长 度 〈 见 上 文 ) 和 服务 
器 的 编码 。 


用 于 PostgreSQL 里 一 个 不 可 用 的 特性 


用 于 PostgreSQL 里 一 个 不 可 用 的 特性 


包含 域 的 排序 规则 的 数据 库 的 名 字 
(总 是 当前 数据 库 ) ， 如 果 缺 省 或 域 
的 数据 类 型 不 可 排序 则 为 null。 


包含 域 的 排序 规则 的 模式 的 名 字 ， 如 
果 缺 省 或 域 的 数据 类 型 不 可 排序 则 为 


null, 

KNEES, MRRERA 
域 的 数据 类 型 不 可 排序 则 为 null。 

如 果 这 个 域 有 一 个 数值 类 型 ， 那 么 这 
个 字段 包含 (声明 的 或 隐 含 的 ) 用 于 
这 个 字段 的 类 型 精度 。 精度 表示 有 效 


numeric_precision 


numeric_precision_radix 


numeric_scale 


datetime_precision 


interval_type 


interval_precision 


domain_default 


udt_catalog 


udt_schema 
udt_name 
scope_catalog 
scope_schema 


scope_name 


cardinal_number 


cardinal_number 


cardinal_number 


cardinal_number 


character_data 


cardinal_number 


character_data 


sql_identifier 


sql_identifier 
sql_identifier 
sql_identifier 
sql_identifier 


sql_identifier 


数据 位 的 个 数 。 可 以 用 十 进 制 表示 ， 
也 可 以 用 二 进 制 表示 ， 就 像 
在 numeric_precision_radix 字段 里 


声明 的 那样 。 对 于 所 有 其 它 类 型 ， 这 


如 果 这 个 域 有 一 个 数值 类 型 ， 那 么 这 
个 字段 标识 numeric_precision 和 
numeric_scale 字段 的 数值 的 基数 是 
多 少 。 数 值 要 么 是 2 要 么 是 10。 对 
于 所 有 其 它 数据 类 型 ， 这 个 字段 是 


b ae 


如 果 这 个 域 有 一 个 准确 的 数值 类 型 ， 
那么 这 个 字段 包含 (声明 或 者 隐 合 
的 ) 本 字段 该 类 型 的 数值 范围 。 数值 
范围 标志 着 小 数 点 右边 的 有 效 位 数 。 
它 可 以 是 用 十 进 制 表示 ， 也 可 以 用 二 
进 制 表示 ， 就 像 

在 numeric_precision_radix 字段 里 声 
明 的 那样 。 对 于 所 有 其 它 数 据 类 型 ， 
这 个 字段 是 空 。 

如 果 data_type 标识 一 个 日 期 ， 时 
间 ， 时 间 惟 ， 或 者 间距 类 型 ， 该 字段 
(明确 的 或 隐 含 地 ) 包含 部 分 的 域 类 
型 秒 精度 ， 就 是 说 ， 小 数位 数 保持 到 
小 数 点 后 面 。 对 于 所 有 其 它 的 数据 类 
型 ， 该 字段 是 null。 

如 果 data_type 标识 间隔 类 型 ， 这 个 
字段 包含 这 个 领域 包括 的 字段 的 时 间 
间隔 的 声明 ， 例 

如 YEAR TO MONTH ， DAY TO SECOND 等 
等 。 如 果 没 有 声明 字段 限制 〈 也 就 
是 ， 间 隔 接受 所 有 字段 ) ， 或 是 对 于 
所 有 其 他 类 型 ， 这 个 字段 为 null。 


适用 于 PostgreSQL 里 不 可 用 的 一 个 特 
性 (参阅 datetime_precision 获取 间 
隔 类 型 域 的 小 数秒 精度 ) 


这 个 域 的 缺 省 表达 式 


域 数据 类 型 定义 所 在 的 数据 库 名 (总 
是 当前 数据 库 ) 


域 数据 类 型 定义 所 在 的 模式 名 

域 数据 类 型 名 

用 于 PostgreSQL 里 一 个 不 可 用 的 特性 
用 于 PostgreSQL 里 一 个 不 可 用 的 特性 
用 于 PostgreSQL 里 一 个 不 可 用 的 特性 


maximum_cardinality cardinal_number 总 是 为 空 ， 为 PostgreSQL 的 数组 ie 


是 有 无 限 的 维 数 。 


一 个 该 域 的 数据 类 型 描述 符 的 标识 
符 ， 在 属于 该 域 的 所 有 数据 类 型 描述 
符 中 是 唯一 的 〈 这 个 是 琐事 ， 因 为 一 
个 域 只 包含 一 种 数据 类 型 ) 。 这 个 主 
要 用 于 和 其 它 这 样 的 标识 符 实例 连 
接 。 (这 个 标识 符 的 具体 格式 没有 定 
re nee 
Be 


dtd_identifier sql_identifier 


34.23. element_types 


视图 element_types 包含 数组 元 素 的 数据 类 型 的 描述 符 。 在 一 个 表 字 有 段 ， 复 合 类 型 属性 ， 域 ， 
郴 数 参数 ， 或 者 范 数 返回 值 定 义 为 一 个 数组 类 型 的 时 候 ， 对 应 的 信息 模式 视图 在 字 

段 data tye 里 只 包含 ARRAY 。 要 获取 数组 元 素 类 型 的 信息 ， 你 可 以 将 对 应 的 视图 和 这 个 视 
图 连接 。 比如 ， 要 用 数据 类 型 和 数组 元 素 类 型 显示 表 的 字段 ， 〈 如 果 可 能 ) ， 你 可 以 用 : 


SELECT c.column_name, c.data_type, e.data_type AS element_type 
FROM information_schema.columns c LEFT JOIN information_schema.element_types e 
ON ((c.table_catalog, c.table_schema, c.table_name, 'TABLE', c.dtd_identifier) 
= (e.object_catalog, e.object_schema, e.object_name, e.object_type, e.collection_t 
WHERE c.table_schema = '...' AND c.table_name = '...' 
ORDER BY c.ordinal_position; 


4 -B 
这 个 视图 只 包含 当前 用 户 有 具有 权限 访问 的 对 象 ， 通 过 成 为 其 所 有 者 或 者 有 些 权 限 。 





Table 34-21. element_types 字段 


名 字 数据 类 型 描述 


使 用 了 被 描述 的 数组 的 对 象 所 在 的 
数据 库 名 (总 是 当前 数据 库 ) 


使 用 了 被 描述 的 数组 的 对 象 所 在 的 
模式 名 


object_name sqlidentitier 。” ”使 用 了 被 描述 的 数组 的 对 象 的 名 字 


使 用 了 被 描述 的 数组 的 对 象 的 类 

型 : TABLE (数组 被 该 表 的 一 个 字 

段 使 用 ) , 

USER-DEFINED TYPE (数组 被 这 个 
object_type character_data 复合 类 型 的 属性 使 用 ) ， 

DOMAIN (数组 被 这 个 域 使 

FA) ， routine (数组 被 该 落 数 的 

一 个 参数 或 者 返回 数据 类 型 使 用 ) 

之 


被 描述 的 数组 的 数据 类 型 描述 符 的 
collection_type_identifier sql_identifier 标识 符 。 使 用 它 与 其 他 信息 模式 视 
图 的 dtd_identifier 字段 连接 。 


如 果 这 是 一 个 内 置 的 类 型 ， 数 据 元 
素 的 数据 类 型 ， 否 则 就 

data_type character_data 是 USER-DEFINED (这 种 情况 下 ， 
oe udt_name 和 相关 的 字段 中 标 
出 De 


object_catalog sql identifier 


object_schema sql_identifier 


总 是 空 ， 因为 这 个 让 息 并 不 适用 于 
character_maximum_length cardinal_number PostgreSQL 里 的 数组 元 素数 据 类 


character_octet_length 


character_set_catalog 


character_set_schema 


character_set_name 


collation_catalog 


collation_schema 


collation_name 


numeric_precision 


numeric_precision_radix 


numeric_scale 


datetime_precision 


interval_type 


interval_precision 


domain_default 


udt_catalog 


udt_schema 


udt_name 


scope_catalog 


scope_schema 


cardinal_number 


sql_identifier 


sql_identifier 


sql_identifier 


sql_identifier 


sql_identifier 


sql_identifier 


cardinal_number 


cardinal_number 


cardinal_number 


cardinal_number 


character_data 


cardinal_number 


character_data 


sql_identifier 


sql_identifier 


sql_identifier 


sql_identifier 


sql_identifier 


型 。 


总 是 空 ， 因 为 这 个 信息 并 不 适用 于 
PostgreSQL 里 的 数组 元 素数 据 类 
型 。 


用 于 PostgreSQL 里 一 个 不 可 用 的 特 
性 

用 于 PostgreSQL 里 一 个 不 可 用 的 特 
性 

用 于 PostgreSQL 里 一 个 不 可 用 的 特 
性 

包含 元 素 类 型 的 排序 规则 的 数据 库 
的 名 字 (总 是 当前 数据 库 ) ， 如 果 
缺 省 或 元 素 的 数据 类 型 不 可 排序 则 
为 null。 

包含 元 素 类 型 的 排序 规则 的 模式 的 
名 字 ， 如 果 缺 省 或 元 素 的 数据 类 型 
不 可 排序 则 为 null。 

元 素 类 型 的 排序 规则 的 名 字 ， 如 果 
缺 省 或 元 素 的 数据 类 型 不 可 排序 则 
为 null。 

总 是 空 ， 因 为 这 个 信息 并 不 适用 于 
PostgreSQL 里 的 数组 元 素数 据 类 型 
总 是 空 ， 因 为 这 个 信息 并 不 适用 于 
PostgreSQL 里 的 数组 元 素数 据 类 型 
总 是 空 ， 因 为 这 个 信息 并 不 适用 于 
PostgreSQL 里 的 数组 元 素数 据 类 型 
总 是 空 ， 因 为 这 个 信息 并 不 适用 于 
PostgreSQL 里 的 数组 元 素数 据 类 型 
总 是 空 ， 因 为 这 个 信息 并 不 适用 于 
PostgreSQL 里 的 数组 元 素数 据 类 型 
总 是 空 ， 因 为 这 个 信息 并 不 适用 于 
PostgreSQL 里 的 数组 元 素数 据 类 型 


未 实现 


元 素 的 数据 类 型 定义 所 在 的 数据 库 
名 (总 是 当前 数据 库 ) 


元 素 的 数据 类 型 定义 所 在 的 模式 名 
元 素 的 数据 类 型 名 


用 于 PostgreSQL 里 一 个 不 可 用 的 特 
性 


用 于 PostgreSQL 里 一 个 不 可 用 的 特 





scope_schema 


scope_name 


maximum_cardinality 


dtd_identifier 


sql_identifier 


sql_identifier 


cardinal_number 


sql_identifier 


性 

用 于 PostgreSQL 里 一 个 不 可 用 的 特 
性 

总 是 空 ， 因 为 这 个 信息 并 不 适用 于 
PostgreSQL 里 的 数组 元 素数 据 类 型 


元 素 的 数据 类 型 描述 符 的 标识 符 。 
目前 没什么 用 处 。 


34.24. enabled_roles 


视图 enablec_roles 标识 当前 "已 授权 角色 "。 授权 的 角色 递归 地 被 定义 为 当前 用 户 和 所 有 通 
过 自动 继承 授权 的 角色 。 换 句 话说 ， 当前 用 户 直接 地 或 间接 地 ， 自 动 地 继承 成 员 权限 。 


对 于 权限 的 检查 ，" 可 用 角色 "的 设置 是 比较 实用 的 ， 可 以 比 和 启用 角色 组 更 广泛 。 所 以 通常 ， 
使 用 视图 applicable_roles 会 更 好 一 些 。 


Table 34-22. enabled roles 字段 


名 字 数据 类 型 描述 


role_name sql_identifier 角色 名 


34.25. foreign_data_wrapper_options 


视图 foreign_data_wrapper_options 包含 了 当 前 数据 库 中 为 外 部 数据 封装 器 定义 的 所 有 选项 。 
仅 有 那些 当前 用 户 有 权 访 问 的 外 部 数据 封装 器 才 显 示 〈 通 过 成 为 所 有 者 或 者 拥有 一 些 权限 
来 ) 。 


Table 34-23. foreign_data_wrapper_options 字段 


名 字 数据 类 型 描述 
foreign_data_wrapper_catalog sql_identifier 定义 外 部 数据 封装 器 的 数据 库 名 称 
(总 是 在 当前 数据 库 ) 
foreign_data_wrapper_name sql_identifier 外 部 数据 封装 器 的 名 称 
option_name sql_identifier 选项 名 称 
option_value character_data 选项 值 


34.26. foreign_data_wrappers 


视图 foreign_data_wrappers 包含 所 有 定义 在 当前 数据 库 中 的 外 部 数据 封装 器 。 仅 有 那些 当前 
用 户 有 权 访 问 外 部 数据 封装 器 才 显 示 (通过 成 为 所 有 者 或 者 拥有 一 些 权 限 ) 。 


Table 34-24. foreign_data_wrappers FX 


名 字 
foreign_data_wrapper_catalog 


foreign_data_wrapper_name 
authorization_identifier 


library_name 


foreign_data_wrapper_language 


数据 类 型 
sql_identifier 


sql_identifier 
sql_identifier 


character_data 


character_data 


描述 


含有 外 部 数据 封装 器 的 数据 库 名 
称 (总 是 当前 数据 库 ) 


外 部 数据 封装 器 名 称 
外 部 服务 器 所 有 者 名 称 

执行 外 部 数据 封装 器 的 库 文件 名 
执行 外 部 数据 封装 器 所 使 用 的 语 


34.27. foreign_server_options 


视图 foreign_server_options 包含 了 当前 数据 库 中 为 外 部 服务 器 定义 的 所 有 选项 。 仅 有 那些 
当前 用 户 有 权 访 问 的 外 部 服务 器 才 显 示 (通过 成 为 所 有 者 或 者 拥有 一 些 权 限 ) 。 


Table 34-25. foreign_server_options 字段 


名 字 数据 类 型 
foreign_server_catalog sql_identifier 
foreign_server_name sql_identifier 
option_name sql_identifier 
option_value character_data 


描述 


定义 外 部 服务 器 的 数据 库 名 称 ( 总 是 当前 
数据 库 ) 


外 部 服务 器 名 称 
选项 名 称 
选项 值 


34.28. foreign_servers 


视图 foreign_servers 包含 了 当前 数据 库 中 定义 的 所 有 外 部 服务 器 。 仅 有 那些 当前 用 户 有 权 访 
问 的 外 部 服务 器 二 显示 (通过 成 为 所 有 者 或 者 拥有 一 些 权 限 ) 。 


Table 34-26. foreign servers 字段 


名 字 数据 类 型 
foreign_server_catalog sql_identifier 
foreign_server_name sql_identifier 
foreign_data_wrapper_catalog sql_identifier 
foreign_data_wrapper_name sql_identifier 
foreign_server_type character_data 
foreign_server_version character_data 
authorization_identifier sql_identifier 


描述 


定义 外 部 服务 器 的 数据 库 名 称 (总 
是 当前 数据 库 ) 


外 部 服务 器 名 称 

含有 被 外 部 服务 器 所 使 用 的 外 部 数 
据 封 装 器 的 数据 库 的 名 称 〈 总 是 当 
前 数据 库 ) 


被 外 部 服务 器 所 使 用 的 外 部 数据 封 
装 器 名 称 


外 部 服务 器 类 型 信息 ， 如 果 在 创建 
时 指定 


外 部 服务 器 版 本 信息 ， 如 果 在 创建 


外 部 服务 器 所 有 者 名 称 


34.29. foreign_table_options 


视图 foreign_table_options 包含 所 有 在 当前 数据 库 中 为 外 表 定 义 的 选项 。 只 有 那些 当前 用 P 
有 权 访 问 的 外 表 才 显示 (通过 成 为 所 有 者 或 有 一 些 权限 ) 。 


Table 34-27. foreign_table_options 字段 


名 字 
foreign_table_catalog 


foreign_table_schema 


foreign_table_name 
foreign_server_catalog 


foreign_server_name 
option_name 


option_value 


数据 关 型 
sql_identifier 


sql_identifier 


sql_identifier 
sql_identifier 


sql_identifier 
sql_identifier 


character_data 


描述 


包含 该 外 表 的 数据 库 的 名 字 (总 是 当前 
数据 库 ) 


包含 该 外 表 的 模式 的 名 字 
外 表 的 名 字 


定义 外 部 服务 器 的 数据 库 的 名 字 (总 是 
当前 数据 库 ) 


外 部 服务 器 的 名 字 


34.30. foreign_tables 


视图 foreign_tables 包含 所 有 在 当前 数据 库 中 定义 的 外 表 。 只 有 那些 当前 用 户 有 权 访 问 的 外 
表 才 显示 〈 通 过 成 为 所 有 者 或 有 一 些 权 限 ) 。 


Table 34-28. foreign_tables 字段 


名 字 数据 类 型 描述 
mo . ye a z — deg 
foreign_table_catalog sql_identifier 定义 外 胡 的 数据 库 的 名 字 (总 是 当前 数 
据 库 ) 
foreign_table_schema sql_identifier 包含 外 表 的 模式 的 名 字 
foreign_table_name sql_identifier 外 表 的 名 字 
ch 、 立 o pH% HZ5 (yB 
foreign_server_catalog sql_identifier 定义 外 部 服务 器 的 数据 库 的 名 字 (总 是 
当前 数据 库 ) 


foreign_server_name sql_identifier 外 部 服务 器 的 名 字 


34.31. key_column_usage 


视图 key_column_usage 标 出 当前 数据 库 中 所 有 被 某 些 唯一 约束 、 主键 约束 或 者 外 键 约束 限制 
的 字段 。 在 这 个 视图 里 没有 包含 检查 约束 。 只 有 当前 用 户 可 以 访问 的 那些 字段 才 显 示 ， 通 过 
成 为 所 有 者 或 有 一 些 权限 。 


Table 34-29. key_column_usage 字段 


名 字 数据 类 型 描述 
constraint_catalog sql_identifier ea Rn i 
Rp KE 

constraint_schema sql_identifier 包含 这 个 约束 的 模式 的 名 称 
constraint_name sql_identifier 约束 的 名 称 

包含 被 这 个 约束 限制 着 某 个 字段 
table_catalog sql_identifier 的 表 所 在 的 数据 库 的 名 称 (总 是 

当前 数据 库 ) 
table_schema sql identifier P E 
table_name sql_identifier ea co ae ee 
column_name sql_identifier 被 这 个 约束 限制 的 字段 的 名 称 
ordinal_position cardinal_number 人 

口 

对 于 一 个 外 键 约 束 ， 唯 一 约束 中 

position_in_unique_constraint cardinal_number 引用 行 的 顺序 位 置 (从 1 开始 ) ; 


否则 为 null 


34.32. parameters 


视图 parameters DARK MAME E EMA KRASA SB. 


BMP SERS ERR (用户 要 么 是 所 有 者 ， 要 么 有 些 权 限 ) 。 


Table 34-30. parameters Columns 


名 字 
specific_catalog 


specific_schema 


specific_name 


ordinal_position 


parameter_mode 


is_result 


as_locator 


parameter_name 


data_type 


character_maximum_length 


character_octet_length 


character_set_catalog 


character_set_schema 


数据 类 型 
sql_identifier 


sql_identifier 


sql_identifier 


cardinal_number 


character_data 


yes_or_no 


yes_or_no 


sql identifier 


character_data 


cardinal_number 


cardinal_number 


sql identifier 


sql identifier 


描述 


包含 此 函数 的 数据 库 的 名 称 (总 是 当 
前 数据 库 ) 


包含 此 函数 的 模式 的 名 字 


郴 数 的 "specific name" (具体 名 
称 ) 。 参阅 Section 34.40 获 取 更 多 信 


= 
INO 


参数 在 函数 的 参数 列表 里 的 位 置 序号 
(从 1 开始 ) 


IN 用 于 输入 的 参数 ， ouT 用 于 输出 
的 参数 ， 和 INouT 用 于 输入 输出 的 参 
数 。 
应 用 于 一 个 PostgreSQL 里 没有 的 特 
性 


应 用 于 一 个 PostgreSQL 里 没有 的 特 
性 


参数 名 称 ， 如 果 参 数 没 有 名 称 则 为 空 


如 果 是 内 置 类 型 ， 那 么 是 参数 的 数据 
类 型 ， 如 果 它 是 某 种 数组 就 是 ARRAY 
(这 种 情况 下 ， 参 阅 视 
element_types ) ， 否 则 就 

是 USER-DEFINED (这 种 情况 下 ， 该 
类 型 在 udt_name 和 相关 的 字段 中 标 
出 ) 。 


总 是 空 值 ， 因 为 这 个 信息 不 适用 于 
PostgreSQL 里 的 参数 数据 类 型 


总 是 空 值 ， 因 为 这 个 信息 不 适用 于 
PostgreSQL 里 的 参数 数据 类 型 


应 用 于 一 个 PostgreSQL 里 没有 的 特 
性 


应 用 于 一 个 PostgreSQL 里 没有 的 特 
性 


应 用 于 一 个 PostgreSQL 里 没有 的 特 


只 有 当前 用 户 有 访问 权限 的 


collation_catalog 


collation_schema 


collation_name 


numeric_precision 


numeric_precision_radix 


numeric_scale 


datetime_precision 


interval_type 


interval_precision 


udt_catalog 


udt_schema 


udt_name 


scope_catalog 


scope_schema 


scope_name 


maximum_cardinality 


dtd_identifier 


sql_identifier 


sql_identifier 


sql_identifier 


cardinal_number 


cardinal_number 


cardinal_number 


cardinal_number 


character_data 


cardinal_number 


sql identifier 


sql identifier 


sql identifier 


sql_identifier 


sql identifier 


sql identifier 


cardinal_number 


sql identifier 


性 


总 是 空 值 ， 因 为 这 个 信息 不 适用 于 
PostgreSQL 里 的 参数 数据 类 型 


总 是 空 值 ， 因 为 这 个 信息 不 适用 于 
PostgreSQL 里 的 参数 数据 类 型 


总 是 空 值 ， 因 为 这 个 信息 不 适用 于 
PostgreSQL 里 的 参数 数据 类 型 


总 是 空 值 ， 因 为 这 个 信息 不 适用 于 
PostgreSQL 里 的 参数 数据 类 型 


总 是 空 值 ， 因 为 这 个 信息 不 适用 于 
PostgreSQL 里 的 参数 数据 类 型 


总 是 空 值 ， 因 为 这 个 信息 不 适用 于 
PostgreSQL 里 的 参数 数据 类 型 


总 是 空 值 ， 因 为 这 个 信息 不 适用 于 
PostgreSQL 里 的 参数 数据 类 型 


总 是 空 值 ， 因 为 这 个 信息 不 适用 于 
PostgreSQL 里 的 参数 数据 类 型 


总 是 空 值 ， 因 为 这 个 信息 不 适用 于 
PostgreSQL 里 的 参数 数据 类 型 


该 参数 数据 类 型 定义 所 在 的 数据 库 名 
称 (总 是 当前 数据 库 ) 


该 参数 数据 类 型 定义 所 在 的 模式 名 称 
参数 的 数据 类 型 名 称 


应 用 于 一 个 PostgreSQL 里 没有 的 特 
性 


应 用 于 一 个 PostgreSQL 里 没有 的 特 
性 


应 用 于 一 个 PostgreSQL 里 没有 的 特 
性 


总 是 空 值 ， 因 为 这 个 信息 不 适用 于 
PostgreSQL 里 的 参数 数据 类 型 


参数 的 数据 类 型 描述 符 的 标识 符 ， 在 
属于 该 函数 的 所 有 数据 类 型 描述 符 中 
唯一 。 这 个 字段 主要 用 于 可 以 和 这 样 
的 其 它 标 识 符 实例 进行 连接 。 (这 个 
标识 符 的 具体 格式 没有 在 标准 中 定 
义 ， 并 且 并 不 保证 在 将 来 的 版 本 中 保 
持 一 致 。) 


34.33. referential constraints 


视图 referential_constraints 包含 当前 数据 库 里 的 所 有 参考 (外 键 ) 约束 。 只 有 当前 用 户 有 
权 访 问 的 引用 表 里 的 约束 才 显 示 〈 通 过 成 为 所 有 者 或 有 某 些 权限 ， 而 不 是 SELECT ) o 


Table 34-31. referential constraints 字段 


eo 
名 字 
constraint_catalog 


constraint_schema 


constraint_name 


unique_constraint_catalog 


unique_constraint_schema 


unique_constraint_name 


match_option 


update_rule 


delete_rule 


数据 类 型 
sql identifier 


sql identifier 


sql identifier 


sql identifier 


sql_identifier 


sql_identifier 


character_data 


character_data 


character_data 


描述 
包含 这 个 约束 的 数据 库 名 字 (总 是 当 
前 数据 库 ) 
包含 这 个 约束 的 模式 名 字 
这 个 约束 的 名 字 
包含 该 外 键 约束 引用 的 唯一 或 者 主键 


约束 的 数据 库 名 称 (总 是 当前 数据 
库 ) 


该 外 键 约束 引用 的 唯一 或 者 主键 约束 
的 模式 的 名 称 

该 外 键 约束 引用 的 唯一 或 者 主键 约束 
的 名 称 

该 外 键 约束 的 匹配 选 

项 : FULL , PARTIAL ,或 者 NONE 。 

这 个 外 键 约束 的 更 新 规则 : CASCADE , 


SET NULL , SET DEFAULT 
RESTRICT 或 者 NO ACTION 。 


这 个 外 键 约束 的 删除 规则 CASCADE , 
SET NULL , SET DEFAULT 
RESTRICT 或 者 NO ACTION o 


34.34. role_column_grants 


视图 role_column_grants 标识 那些 在 字段 上 赋予 或 被 赋予 为 当前 角色 的 所 有 权限 。 更 多 信息 
可 以 在 column_privileges 中 找到 。 这 个 视图 和 column_privileges 唯一 有 效 的 不 同 就 是 这 个 
视图 忽略 了 某 些 字 段 ， 这 些 字段 是 通过 授予 puBLIc 使 得 当前 用 户 可 以 访问 的 字段 。 


Table 34-32. role_column_grants 字段 


名 字 数据 类 型 描述 
grantor sql_identifier 被 赋予 这 个 权限 的 用 户 名 称 
grantee sql_identifier 被 赋予 这 个 权限 的 角色 名 称 
table_catalog sql_identifier A (总 是 当前 
table_schema sql_identifier 包含 该 字段 的 表 所 在 模式 的 名 称 
table_name sql_identifier 包含 该 字段 的 表 名 称 
column_name sql_identifier 该 字段 的 名 称 


权限 的 类 型 : SELECT , INSERT ，UPDATE 或 
者 REFERENCES 


如 果 权 限 是 可 以 赋予 的 ， 则 为 ves, BM, 
为 NO 


privilege_type character_data 


is_grantable yes_or_no 


34.35. role_routine_grants 


视图 role_routine_grants 标 出 所 有 在 函数 上 赋予 或 被 赋予 当前 角色 的 权限 。 更 多 的 信息 可 以 
在 routine _privileges 里 找 至 到 。 在 该 视图 与 routine_privileges 之 间 实 际 仅 有 的 差异 是 该 视 
图 忽略 那些 通过 赋 权 给 PuBLIC 使 当前 用 户 可 以 访问 的 豆 数 。 


Table 34-33. role routine grants 字段 


名 字 数据 类 型 描述 
grantor sql_identifier 被 赋予 该 权限 的 角色 名 称 
grantee sql_identifier 被 赋予 此 权限 的 角色 的 名 称 


specific_catalog sql_identifier 包含 此 函数 的 数据 库 名 称 (总 是 当前 数据 库 ) 
specific_schema sql_identifier 包含 此 函数 的 模式 名 称 


函数 的 "specific name" (具体 的 名 称 ) 。 参 
J Section 34.40 获 取 更 多 信息 。 


routine_catalog sql_identifier 包含 此 函数 的 数据 库 名 称 (总 是 当前 数据 库 ) 


specific_name sql_identifier 


routine_schema sql_identifier 包含 此 函数 的 模式 名 称 
routine_name sql_identifier WANS (RBS, AHABR) 
privilege_type character_data 总 是 execute (BYAANIE— AY ty BB RB) 


is_grantable yes_or_no 如 果 权 限 可 以 赋予 ， 那 么 是 Yes, AMA NO 


34.36. role_table_grants 


视图 role_table_grants 标识 在 表 或 者 视图 上 赋予 或 被 赋予 当前 角色 的 全 部 权限 。 更 多 信息 可 
以 在 table_privileges 找到 。 在 该 视图 与 table_privileges 之 间 实 际 仅 有 的 差异 是 该 视图 忽 
略 那 些 通过 赋 权 给 PuBLIC 使 当前 用 户 可 以 访问 的 表 。 


Table 34-34. role table grants 字段 


名 字 
grantor 
grantee 
table_catalog 
table_schema 


table_name 
privilege_type 


is_grantable 


with_hierarchy 


数据 类 型 
sql_identifier 
sql_identifier 
sql_identifier 
sql_identifier 


sql_identifier 
character_data 


yes_or_no 


yes=Or No 


赋予 权限 的 角色 名 

被 赋予 权限 的 角色 名 
包含 此 表 的 数据 库 名 (总 是 当前 数据 库 ) 
包含 此 表 的 模式 名 

表 名 


Ac BR HY: SELECT , INSERT , UPDATE , DELETE , 
TRUNCATE , REFERENCES , 5% TRIGGER 


如 果 权 限 可 以 赋予 则 为 YES , 


在 SQL 标准 里 ， wITH HIERARCHY OPTION 是 一 个 
DREI (F) 权限 ， 人 允许 在 表 继 承 层 次 结构 上 进 
行 创 建 操作 。 在 PostgreSQL 中 ， 这 包含 在 

了 SELECT 权限 中 ， 所 以 如 果 这 个 权限 


为 SELECT 则 这 个 字段 显示 ves, 否则 为 no. 


否则 为 NO 


34.37. 


role_udt_grants 


视图 role_udt_grants 用 于 标 出 赋予 或 被 赋予 当前 角色 的 用 户 定义 类 型 上 的 usas 权限 。 更 
多 的 信息 可 以 在 udt_privileges 里 找到 。 在 该 视图 与 udt_privileges 之 间 实 际 仅 有 的 差异 是 
该 视图 忽略 那些 通过 赋 权 给 PUBLIC 使 当前 用 户 可 以 访问 的 对 象 。 因为 数据 类 型 在 


PostgreSQL 中 并 没有 真实 的 权力 ， 但 是 只 有 一 个 隐 式 的 赋 权 给 PUBLIC , 


的 。 


Table 34-35. role_udt_grants 字段 


ae 
grantor 
grantee 
udt_catalog 
udt_schema 
udt_name 


privilege_type 


is_grantable 


数据 类 型 
sql_identifier 
sql_identifier 
sql_identifier 
sql_identifier 
sql_identifier 


character_data 


yes_or_no 


所 以 这 个 视图 是 空 


描述 
赋予 该 权限 的 角色 的 名 字 
被 赋予 该 权限 的 角色 的 名 字 
包含 该 类 型 的 数据 库 的 名 字 (总 是 当前 数据 库 ) 
包含 该 类 型 的 模式 的 名 字 
类 型 名 
总 是 TYPE USAGE 


如 果 权 限 是 可 赋予 的 ， 那 么 就 是 YEs ， 否 则 
为 NO 


34.38. role_usage_grants 


视图 role_usage_ grants 用 于 标 出 当前 角色 赋予 或 被 赋予 的 各 种 对 象 的 usa6E 权限 。 更 多 的 
信息 可 以 在 usage_privileges 里 找到 。 在 该 视图 与 usage_privileges 之 间 实 际 仅 有 的 差异 是 
该 视图 忽略 那些 通过 赋 权 给 puec 使 当前 用 户 可 以 访问 的 对 象 。 


Table 34-36. role usage grants 字段 


ceo 

名 字 
grantor 
grantee 


object_catalog 


object_schema 


object_name 


object_type 


privilege _type 


is_grantable 


数据 类 型 
sql_identifier 
sql_identifier 


sql_identifier 
sql_identifier 
sql_identifier 
character_data 


character_data 


yes_or_no 


描述 
赋予 该 权限 的 角色 名 称 
被 赋予 该 权限 的 角色 的 名 称 
包含 该 对 象 的 数据 库 的 名 字 (总 是 当前 数据 库 ) 


如 果 适 用 ， 是 包含 该 对 象 的 模式 的 名 字 ， 否 则 是 
一 个 空 字符 串 

对 象 的 名 字 

COLLATION 或 DOMAIN 或 

FOREIGN DATA WRAPPER 或 FOREIGN SERVER 或 
SEQUENCE 


Always USAGE 


如 果 权 限 可 以 赋予 ， 则 为 ves, BMA no 


34.39. routine_privileges 


视图 routine_privileges 标识 在 图 数 上 所 有 赋予 当前 用 户 或 者 由 当前 用 户 赋予 的 权限 。 每 个 
函数 ， 授 权 人 ， 和 权限 接受 人 的 组 合 都 有 一 行 。 


Table 34-37. routine_privileges 字段 


pF 数据 类 型 描述 

grantor sql_identifier 赋予 权限 的 角色 名 

grantee sql_identifier 被 授予 权限 的 角色 名 

specific_catalog sqlidentifier  ， 包 含 该 函数 的 数据 库 名 称 (总 是 当前 数据 库 ) 
specific_schema sql_identifier 包含 该 函数 的 模式 名 


函数 的 "specific name" (具体 的 名 字 ) 。 参 
阅 Section 34.40 获 取 更 多 信息 。 


routine_catalog sql_identifier 包含 该 函数 的 数据 库 名 称 (总 是 当前 数据 库 ) 


Specific_name sql_identifier 


routine_schema sql_identifier BSznaAheaAAM 
routine_name sql_identifier WAZ 〈 可 能 会 因 重 载 而 重复 ) 
privilege_type character_data 总 是 execute (用 于 函数 的 唯一 的 权限 类 型 ) 


is_grantable yes_or_no 如 果 权 限 是 可 赋予 的 ， 则 为 yes, BMA no 


34.40. routines 


视图 routines 包含 当前 数据 库 中 的 所 有 事 数 。 只 有 当前 用 户 有 访问 权限 (可 能 是 所 有 者 或 者 
有 特定 权限 ) 的 画 数 才 显 示 出 来 。 


Table 34-38. routines 字段 


名 字 
specific_catalog 


specific_schema 


specific_name 


routine_catalog 
routine_schema 


routine_name 


routine_type 


module_catalog 


module_schema 


module_name 


udt_catalog 


udt_schema 


udt_name 


数据 类 型 
sql_identifier 


sql identifier 


sql_identifier 


sql_identifier 
sql_identifier 


sql_identifier 


character_data 


sql_identifier 


sql_identifier 


sql_identifier 


sql_identifier 


sql_identifier 


sql_identifier 


描述 


含 该 图 数 的 数据 库 名 称 
总 是 当前 数据 库 ) 


包 

( 
包含 该 图 数 的 模式 名 称 
Bq 


数 的 "specific 
name" (具体 名 字 ) 。 这 
是 一 个 在 模式 里 唯一 标识 
该 孙 数 的 名 字 ， BERR 
-a 是 名 字 是 重 载 的 也 如 

5。 具体 名 字 的 格式 没有 
我 们 应 该 只 是 用 它 
和 其 它 具体 过 tA & AI 

进行 比较 。 


包含 该 图 数 的 数据 库 名 称 
(总 是 当前 数据 库 ) 


包含 该 图 数 的 模式 名 称 
函数 的 名 称 (在 重 载 的 时 


总 是 Function (未 来 可 能 
会 有 其 它 过 程 的 类 型 。) 


应 用 于 一 个 PostgreSQL 里 
没有 的 特性 


应 用 于 一 个 PostgreSQL 里 
没有 的 特性 


应 用 于 一 个 PostgreSQL 里 
没有 的 特性 


应 用 于 一 个 PostgreSQL 里 
没有 的 特性 


应 用 于 一 个 PostgreSQL 里 
没有 的 特性 


应 用 于 一 个 PostgreSQL 里 
没有 的 特性 


如 果 这 是 一 个 内 置 类 型 ， 


data_type 


character_maximum_length 


character_octet_length 


character_set_catalog 


character_set_schema 


character_set_name 


collation_catalog 


collation_schema 


collation_name 


numeric_precision 


numeric_precision_radix 


numeric_scale 


datetime_precision 


interval_type 


character_data 


cardinal_number 


cardinal_number 


sql_identifier 


sql_identifier 


sql_identifier 


sql_identifier 


sql_identifier 


sql_identifier 


cardinal_number 


cardinal_number 


cardinal_number 


cardinal_number 


character_data 


则 为 函数 的 返回 数据 类 
型 ， 或 者 如 果 是 某 种 数 
组 ， 则 为 array (这 个 时 
fe, Bh a 
element_types) , 否 
则 就 是 USER-DEFINED (这 
种 情况 下 ， 类 型 

在 type_udt_name 和 相关 
字段 中 标识 ) 。 


总 是 为 空 ， 因 为 这 个 信息 


并 不 应 用 于 PostgreSQL 里 
的 返回 数据 类 型 

总 是 为 空 ， 因 为 这 个 信息 
并 不 应 用 于 PostgreSQL 里 
的 返回 数据 类 型 


应 用 于 一 个 PostgreSQL 里 
没有 的 特性 


应 用 于 一 个 PostgreSQL 里 
没有 的 特性 


应 用 于 一 个 PostgreSQL 里 
没有 的 特性 


总 是 为 空 ， 因 为 这 个 信息 
并 不 应 用 于 PostgreSQL 里 
的 返回 数据 类 型 


总 是 为 空 ， 因 为 这 个 信息 
并 不 应 用 于 PostgreSQL 里 
的 返回 数据 类 型 


总 是 为 空 ， 因 为 这 个 信息 
并 不 应 用 于 PostgreSQL 里 
的 返回 数据 类 型 


总 是 为 空 ， 因 为 这 个 信息 
并 不 应 用 于 PostgreSQL 里 
的 返回 数据 类 型 


总 是 为 空 ， 因 为 这 个 信息 
并 不 应 用 于 PostgreSQL 里 
的 返回 数据 类 型 


总 是 为 空 ， 因 为 这 个 信息 
并 不 应 用 于 PostgreSQL 里 
的 返回 数据 类 型 
总 是 为 空 ， 因 为 这 个 信息 
并 不 应 用 于 PostgreSQL 里 
的 返回 数据 类 型 


总 是 为 空 ， 因 为 这 个 信息 
并 不 应 用 于 PostgreSQL 里 


interval_precision 


type_udt_catalog 


type_udt_schema 


type_udt_name 


scope_catalog 


scope_schema 


scope_name 


maximum_cardinality 


dtd_identifier 


routine_body 


routine_definition 


cardinal_number 


sql_identifier 


sql_identifier 


sql_identifier 


sql_identifier 


sql_identifier 


sql_identifier 


cardinal_number 


sql_identifier 


character_data 


character_data 


的 返回 数据 类 型 


总 是 为 空 ， 因 为 这 个 信息 
并 不 应 用 于 PostgreSQL 里 
的 返回 数据 类 型 


函数 的 返回 数据 类 型 定义 
所 在 的 数据 库 名 称 (总 是 
当前 数据 库 ) 


函数 的 返回 数据 类 型 定义 
所 在 的 模式 名 称 


该 图 数 的 返回 数据 类 型 的 
名 称 


应 用 于 一 个 PostgreSQL 里 
没有 的 特性 


应 用 于 一 个 PostgreSQL 里 
没有 的 特性 


应 用 于 一 个 PostgreSQL 里 
没有 的 特性 


总 是 为 空 ， 因 为 数组 在 
PostgreSQL 中 总 是 有 无 限 
的 最 大 维 数 


一 个 这 个 函数 返回 的 数据 
类 型 的 数据 类 型 描述 符 的 
标识 符 ， 在 所 有 属于 这 个 
函数 的 数据 类 型 描述 符 中 
唯一 。 这 个 描述 符 主 要 用 
于 和 其 它 这 样 的 标识 符 实 
例 进行 连接 。 GRR 
体 的 格式 没有 定义 ， 并 且 
不 保证 在 将 来 的 版 本 中 保 
持 相 同 。) 


WORM SQL WEY, AB 
A so, EN 
FE EXTERNAL o 


PRRLAVIR AL AXE (如 果 
当前 用 户 不 是 函数 所 有 
者 ， 则 为 空 ) 。 (根据 
SQL 标准 ， 这 个 字段 只 又 
在 routine_body 是 SQL 的 
时 候 才 使 用 ， 但 是 在 
PostgreSQL 里 ， 这 个 字段 
将 包含 创建 画 数 的 时 候 所 
声明 的 任何 源 文本 。) 


如 果 这 个 函数 是 一 个 C H 
数 ， 那 么 是 函数 的 外 部 名 
字 (链接 符号 ) ; 否则 为 


external_language 


parameter_style 


is_deterministic 


sql_data_access 


is_null_call 


sql_path 


schema_level_routine 


max_dynamic_result_sets 


is_user_defined_cast 


is_implicitly_invocable 


security_type 


to_sql_specific_catalog 


to_sql_specific_schema 


character_data 


character_data 


yes_or_no 


character_data 


yes_or_no 


character_data 


yes_or_no 


cardinal_number 


yes_or_no 


yes_or_no 


character_data 


sql_identifier 


sql_identifier 


空 。 (这 个 字段 的 数值 
和 routine_definition 里 


显示 的 数值 相同 。) 
书写 这 个 函数 使 用 的 语言 


总 是 GENERAL (SQL 标准 
定义 了 其 它 参数 类 型 ， 那 
些 类 型 不 适用 于 
PostgreSQL., ) 


HO FR 3X “SE ENS BA Hy BE 
的 (immutable) (在 SQL 
标准 里 叫 确 定 的 
(deterministic)) ， 那么 
是 YES, AMZ No 。 
(在 PostgreSQL 里 你 无 法 
通过 信息 模式 查询 其 它 
用 的 易 失 性 级 别 。) 


总 是 MODIFIES ， 意 思 是 这 
个 函数 可 能 修改 SQL 数 
据 。 这 个 信息 对 
PostgreSQL 没 哈 作 用 。 


如 果 当 男 数 任意 输入 参数 
为 空 时 图 数 自动 返回 空 


则 为 ves, BMA No 。 


应 用 于 一 个 PostgreSQL 里 
没有 的 特性 


总 是 yes (相反 的 是 一 个 
用 户 定 义 类 型 的 方法 ， 这 
是 一 个 PostgreSQL 里 没有 
的 特性 。) 


应 用 于 一 个 PostgreSQL 里 
没有 的 特性 


应 用 于 一 个 PostgreSQL 里 
没有 的 特性 


应 用 于 一 个 PostgreSQL 里 
没有 的 特性 


如 果 这 个 函数 以 当前 用 户 
的 权限 运行 ， 则 

为 INVOKER ， HORNA 
定义 它 的 用 户 的 权限 运 


行 ， 则 为 DEFINER o 


应 用 于 一 个 PostgreSQL 里 
没有 的 特性 


应 用 于 一 个 PostgreSQL 里 
没有 的 特性 


to_sql_specific_name 


as_locator 


created 


last_altered 


new_savepoint_level 


is_udt_dependent 


result_cast_from_data_type 





result_cast_as_locator 


result_cast_char_max_length 





result_cast_char_octet_length 





result_cast_char_set_catalog 





result_cast_char_set_schema 





result_cast_char_set_name 





result_cast_collation_catalog 


result_cast_collation_schema 


result_cast_collation_name 


result_cast_numeric_precision 


result_cast_numeric_precision_radix 


result_cast_numeric_scale 


sql_identifier 


VE SRO Rezo) 


time_stamp 


time_stamp 


yes_or_no 


yes_or_no 


character_data 


yes_or_no 


cardinal_number 


character_data 


sql_identifier 


sql_identifier 


sql_identifier 


sql_identifier 


sql_identifier 


sql_identifier 


cardinal_number 


cardinal_number 


cardinal_number 


没有 的 特性 
应 用 于 一 个 PostgreSQL 里 
没有 的 特性 
应 用 于 一 个 PostgreSQL 里 
没有 的 特性 
应 用 于 一 个 PostgreSQL 里 
没有 的 特性 
应 用 于 一 个 PostgreSQL 里 
没有 的 特性 
应 用 于 一 个 PostgreSQL 里 
没有 的 特性 


当前 总 是 No 。 YES 适用 
于 PostgreSQL 里 没有 的 
一 个 特性 。 


应 用 于 一 个 PostgreSQL 里 
没有 的 特性 
应 用 于 一 个 PostgreSQL 里 
没有 的 特性 
应 用 于 一 个 PostgreSQL 里 
没有 的 特性 
应 用 于 一 个 PostgreSQL 里 
没有 的 特性 
应 用 于 一 个 PostgreSQL 里 
没有 的 特性 
应 用 于 一 个 PostgreSQL 里 
没有 的 特性 
应 用 于 一 个 PostgreSQL 里 
没有 的 特性 
应 用 于 一 个 PostgreSQL 里 
没有 的 特性 
应 用 于 一 个 PostgreSQL 里 
没有 的 特性 
应 用 于 一 个 PostgreSQL 里 
没有 的 特性 
应 用 于 一 个 PostgreSQL 里 
没有 的 特性 
应 用 于 一 个 PostgreSQL 里 
没有 的 特性 


应 用 于 一 个 PostgreSQL 里 
没有 的 特性 


result_cast_datetime_precision 


result_cast_interval_type 


result_cast_interval_precision 


result_cast_type_udt_catalog 





result_cast_type_udt_schema 








result_cast_type_udt_name 


result_cast_scope_catalog 


result_cast_scope_schema 


result_cast_scope_name 


result_cast_maximum_cardinality 


result_cast_dtd_identifier 


character_data 


character_data 


cardinal_number 


sql_identifier 


sql_identifier 


sql_identifier 


sql_identifier 


sql_identifier 


sql_identifier 


cardinal_number 


sql_identifier 


应 用 于 一 个 PostgreSQL 里 
没有 的 特性 


应 用 于 一 个 PostgreSQL 里 
没有 的 特性 
应 用 于 一 个 PostgreSQL 里 
没有 的 特性 
应 用 于 一 个 PostgreSQL 里 
没有 的 特性 
应 用 于 一 个 PostgreSQL 里 
没有 的 特性 
应 用 于 一 个 PostgreSQL 里 
没有 的 特性 
应 用 于 一 个 PostgreSQL 里 
没有 的 特性 
应 用 于 一 个 PostgreSQL 里 
没有 的 特性 
应 用 于 一 个 PostgreSQL 里 
没有 的 特性 
应 用 于 一 个 PostgreSQL 里 
没有 的 特性 


应 用 于 一 个 PostgreSQL 里 
没有 的 特性 


34.41. schemata 


视图 schemata 包含 当前 数据 库 里 由 当前 用 户 拥 有 的 所 有 模式 。 


Table 34-39. schemata 字段 
名 字 
catalog_name 


schema_name 


schema_owner 


default_character_set_catalog 


default_character_set_schema 


default_character_set_name 


sql_path 


数据 类 型 
sql_identifier 


sql_identifier 


sql_identifier 


sql_identifier 


sql_identifier 


sql_identifier 


character_data 


描述 


此 模式 所 在 的 数据 库 名 称 (总 是 
当前 数据 库 ) 


模式 的 名 字 
模式 的 所 有 者 名 称 


应 用 于 一 个 PostgreSQL 里 没有 的 
特性 


应 用 于 一 个 PostgreSQL 里 没有 的 
特性 


应 用 于 一 个 PostgreSQL 里 没有 的 
特性 


应 用 于 一 个 PostgreSQL 里 没有 的 
特性 


34.42. sequences 


视图 sequences 包含 了 所 有 定义 在 当前 数据 库 中 的 序列 。 只 有 那些 当前 用 户 可 以 访问 的 序列 
才 显 示 (通过 成 为 所 有 者 或 拥有 一 些 权限 ) 。 


Table 34-40. sequences 字段 


名 字 数据 类 型 描述 
4; x 4 Boe 
sequence_catalog sql_identifier a = 该 序列 的 数据 库 名 称 (总 是 当 Bl 
数据 库 ) 
sequence_schema sql_identifier 包含 序列 的 模式 名 称 
sequence_name sql_identifier 序列 名 称 


序列 的 数据 类 型 。 在 PostgreSQL 中 ， 


当前 总 是 bigint o 


该 字段 (公开 的 或 隐 含 的 ) 包含 序列 
数据 类 型 的 精度 〈 见 上 述 ) 。 该 精度 

numeric_precision cardinal_number 表明 了 有 效 数 字 的 位 数 。 它 可 以 用 在 
十 进 制 或 者 二 进 制 中 ， 在 字 


FR numeric_precision_radix 中 说 明 。 


该 字段 表明 该 值 在 字 


段 numeric_precision 和 


data_type character_data 


numeric_precision_radix cardinal_number E E 中 被 表示 。 值 为 要 么 是 
2 要 么 是 10。 
该 字段 (公开 地 或 隐 含 地 ) 包含 序列 
数据 类 型 的 数值 范围 (LEM). 数 
; : 值 范围 表明 了 小 数 点 右边 有 效 数 字 的 
numeric_scale cardinal_number ae N 、 Se 
位 数 。 它 可 以 用 在 十 进 制 或 二 进 制 
中 ， 在 字 
段 numeric_precision_radix 中 说 明 。 
start_value character_data 序列 的 起 始 值 
minimum_value character_data 序列 的 最 小 值 
maximum_value character_data 序列 的 最 大 值 
increment character_data 序列 的 增 量 
FA | 万 人 Vw 里 aS 
ET R guem 如 果 序 列 是 周期 的 ， 那么 是 yes , f 
则 定 NO 


请 注意 ， 为 了 与 SQL 标准 一 致 ， 起 始 值 、 最 小 值 、 最 大 值 和 堆 量 值 都 作为 字符 串 返回 。 


34.43. sql features 


K sql_features BSAA XPostgreSQl 支持 的 在 SQL 标准 里 定义 的 正式 特性 的 信息 。 这 些 信 
息 和 在 Appendix D 出 现 的 信息 相同 。 你 也 可 以 在 那里 找到 一 些 额 外 的 背景 信息 。 


Table 34-41. sql features 字段 


名 字 数据 类 型 描述 
feature_id character_data 这 个 特性 的 标识 字 串 
feature_name character_data 这 个 特性 的 描述 性 名 字 


子 特 性 的 标识 符 字 串 ， 如 果 不 是 子 特 性 ， 那 么 


sub_feature_id character_data 就 是 一 个 需 关 的 字 串 

sub_feature_name character_data TEE 如 果 不 是 子 特性 ， 那么 

EAT A 如 果 当 前 版 本 的 PostgreSQL 完 全 支持 该 特性 ， 
那么 是 YEs ， 否则 为 no 

is_verified_by character_data Pe tee ean a 

comments character_data 可 能 是 一 个 有 关 特 性 支持 状态 的 注释 


34.44. sql _implementation_info 


表 sql_implementation_info 包含 有 关 SQL 标准 里 各 种 留 给 具体 实现 定义 的 特性 的 信息 。 这 
些 信息 主要 用 在 ODBC 接口 的 环境 里 ; 其 它 接 口 的 用 户 可 能 会 觉得 这 些 信 息 没有 什么 用 人 处。 
出 于 这 个 原因 ， 独 立 的 实现 信息 条 目 没有 在 这 个 描述 ; 你 会 在 ODBC 接口 的 描述 里 找到 它 


们 。 


Table 34-42. sql_implementation_info 字段 


AF 数据 类 型 描述 
implementation_info_id character_data 实现 {Z| 息 条 目的 标识 字 串 
implementation_info_name character_data 实现 信息 条 目的 描述 术 性 名 称 

实现 信息 条 目的 数值 ， 或 如 果 数 值 
integer_value cardinal_number 在 character_value 字段 里 包含 了 ， 

则 为 空 。 

实现 信息 条 目的 数值 ， 或 如 果 该 值 已 
character_value character_data 经 在 字段 integer_value Bas, 则 | 


comments character_data 


可 能 是 一 个 描述 此 实现 信息 条 目的 注 
释 


34.45. sql languages 
表 sql_languages X PostgreSQL 里 支持 的 每 个 SQL 语言 绑 定 都 包含 一 行 。PostgreSQL 支持 
直接 的 SQL 和 在 C BMRA SOL; 这 就 是 你 从 这 个 表 里 能 看 到 的 所 有 东西 。 


这 个 表 在 SQL:2008 中 已 经 从 SQL 标准 中 移 除了 ， 所 有 SQL:2003 以 后 的 标准 都 没有 可 以 参考 
的 条 目 了 。 


Table 34-43. sql_languages 字段 


名 字 数据 类 型 描述 
语言 定义 源 的 名 称 ; 总 
sql_language_source character_data 是 Iso 9075 ， 也 就 是 SQL 标 
准 
sql_language_source 里 引用 
sql_language_year character_data Perit R 
的 标准 通过 的 年 代 。 
这 种 语言 绑 定 的 标准 遵循 级 
sql_language_conformance character_data 别 。 对 于 ISO 9075:2003, 
这 里 总 是 coRE 。 
总 是 空 (RM 期 区 
sql_language_integrity character_data Bee 这 | 数值 与 早期 的 
SQL 标准 相关 。 ) 
sql_language_implementation character_data 总 是 为 空 
BERE, ZA 
sql_language_binding_style character_data 是 DIRECT ， 要 么 
是 EMBEDDED 。 
如 果 绑 定 风格 是 EMBEDDED , 
4, Boy Og = ZS py) 2 
sql_language_programming_language character_data 那么 是 编程 语 S, ANNÆ 


Æ, PostgreSQLR XH C 语 


o 


Il 


34.46. sql packages 


K sql_packages 包含 有 关 定 义 在 SQL 标准 里 的 那个 特性 包 是 PostgreSQL 支持 的 信息 。 请 参 
考 Appendix D 获 取 有 关 特 性 包 的 背景 信息 。 


Table 34-44. sql_packages 字段 


AF 数据 类 型 描述 
feature_id character_data 包 的 标 识字 串 
feature_name character_data 包 的 描述 性 名 字 
~ s 2 eo 
EEE E 如 果 该 包 被 当前 版 本 的 PostgreSQL 完 全 支持 ， 


WA yes, GRA no 


总 是 空 ， 因 为 PostgreSQL 开 发 组 没有 进行 任何 
特性 兼容 性 的 正式 测试 


comments character_data 可 能 是 一 个 有 关 该 包 支 持 状 态 的 评注 


is_verified_by character_data 


34.47. sql_parts 


表 sql_parts 包含 关于 PostgreSQL 支 持 的 SQL 标准 的 几 部 分 信息 。 


Table 34-45.，sql_parts 字段 


AF 
feature_id 


feature_name 


is_supported 


is_verified_by 


comments 


数据 类 型 
character_data 


character_data 


yes_or_no 


character_data 


character_data 


es 


描 
一 个 包含 部 分 数量 的 标识 字符 串 
部 分 描述 名 称 
如 果 当 前 PostgreSQL 版 本 完全 支持 该 部 分 


为 YES ， 人 否则 为 no 


总 为 空 ， 因 为 PostgreSQL 开 发 组 不 执行 正规 的 
特性 一 致 性 测试 


可 能 的 一 个 关于 支持 部 分 状态 的 意见 


34.48. sql sizing 


R sql_sizing 包含 有 关 PostgreSQL 里 面 各 种 大 小 限制 和 最 大 值 的 信息 。 这 个 信息 特别 用 于 
在 ODBC 接口 的 环境 下 ; 其 它 接口 的 用 户 很 可 能 发 现 这 个 信息 没什么 用 。 钦 于 这 个 原因 ， 在 
这 里 没有 描述 独立 的 大 小 条 目 ; 你 将 在 ODBC 接口 的 描述 里 找到 它们 。 


Table 34-46. sql_sizing 字段 


名 字 数据 类 型 描述 
sizing_id cardinal_number 尺寸 项 的 标 识 符 
sizing_name character_data 尺寸 项 的 描述 名 称 


尺寸 项 的 数值 ， 如 果 尺 寸 无 限制 或 者 无 法 确 
supported_value cardinal_number 定 ， 则 为 0， 如 果 不 支 持 适 用 的 尺寸 项 的 特 
性 ， 则 为 空 。 


comments character_data 可 能 是 一 个 有 关 此 尺寸 项 的 评注 


34.49. sql_sizing_profiles 


表 sql_sizing_profiles 包含 有 关 SQL 标准 要 求 的 各 种 配置 文件 的 sql_sizing 信息 。 
PostgreSQL 并 不 跟踪 任何 SQL 配置 文件 ， 所 以 这 个 表 是 空 的 。 


Table 34-47. sql_sizing profiles 字段 


名 字 数据 类 型 描述 
sizing_id cardinal_number 尺寸 项 的 标识 符 
sizing_name character_data 尺寸 项 的 描述 性 名 称 
profile_id character_data 一 个 配置 文件 的 标识 字 串 


SQL 配置 文件 对 尺寸 项 要 求 的 数值 ， 如 果 配 置 
文件 对 尺寸 项 没有 限制 ， 则 为 0， 如 果 配 置 文件 


| cardinal number | 对 尺寸 项 所 适用 的 特性 没有 任何 要 求 ， 那 么 就 
aimee character_data ”可 能 是 一 个 有 关 该 配置 文件 里 面 的 尺寸 项 的 注 


释 


34.50. table constraints 


视图 table_constraints 包含 所 有 属于 当前 用 户 的 表 里 面 的 约束 ， 或 有 除了 SELECT 之 外 的 某 
些 权限 。 


Table 34-48. table_constraints 字段 


名 字 数据 类 型 描述 

constraint_catalog sql_identifier 包含 该 约束 地 数据 库 的 名 称 (总 是 当前 数据 
库 ) 

constraint_schema sql_identifier 包含 这 个 约束 的 模式 名 称 
constraint_name sql_identifier 约束 名 称 
table_catalog sql_identifier 包含 该 表 的 数据 库 名 称 (总 是 当前 数据 库 ) 
table_schema sql_identifier 包含 此 表 的 模式 名 
table_name sql_identifier RZ 


约束 的 类 型 : CHECK, FOREIGN KEY , 
PRIMARY KEY , 或 者 UNIQUE 


is_deferrable yes_or_no 如 果 约 束 可 以 推迟 ， 为 yes , GMA No 。 
如 果 约 束 是 可 以 推迟 的 并 且 是 首先 推迟 的 ， 


为 YES, BRIA no. 


constraint_type character_data 


initially_deferred yes_or_no 


34.51. table_privileges 


视图 table_privileges 标识 所 有 赋 与 当前 用 户 或 者 由 当前 用 户 赋予 的 ， 在 表 或 者 视图 上 的 权 
限 。 每 个 表 、 赋 权 人 、 受 权 人 的 组 合 都 有 一 行 。 


Table 34-49. table_privileges 字段 


名 字 数据 类 型 描述 
grantor sql_identifier 授予 该 权限 的 角色 名 
grantee sqlidentifier  ， 被 授予 该 权限 的 角色 名 
table_catalog sqlidentifier  ， 包 含 该 表 的 数据 库 名 〈 总 是 当前 数据 库 ) 
table_schema sql_identifier 包含 该 表 的 模式 名 
table_name sql_identifier KZ, 


权限 的 类 型 : SELECT , INSERT , UPDATE , 


privilege _type character_data X 
DELETE , TRUNCATE , REFERENCES ,或 TRIGGER 


is_grantable yes_or_no 如 果 权 限 是 可 赋予 的 ， 则 为 yes, BRA no 


在 SQL 标准 中 ， WITH HIERARCHY OPTION 是 一 个 单 

独 的 〈 子 ) 特权 ， 人 允许 在 表 继 承 层次 结构 上 执行 
with_hierarchy yes_or_no 创建 。 在 PostgreSQL 中 ， 这 包含 在 sELEcT 特权 

中 ， 所 以 如 果 特 权 是 sELEcT 这 个 字段 就 显 

示 YES, GMA NO 。 


34.52. tables 


视图 tables 包含 所 有 在 当前 数据 库 里 定义 的 表 和 视图 。 只 有 那些 当前 用 户 有 权限 访问 (Bo 
是 所 有 者 ， 要 么 是 有 某 些 权限 ) 的 表 和 视图 二 显示 出 来 。 


Table 34-50. tables 字段 


名 字 数据 类 型 描述 
S, H% y Bowery 
table_catalog sql_identifier aa 该 表 的 数据 库 名 (总 是 当 前 数 
据 库 ) 
table_schema sql_identifier 包含 该 表 的 模式 名 
table_name sql_identifier RZ 


表 的 类 型 : 永久 基本 表 

是 BASE TABLE (普通 的 表 类 
table_type character_data 型 ) ， 视图 是 view, HK 

是 FOREIGN TABLE, 或 者 


是 LOCAL TEMPORARY 表示 临时 表 。 


应 用 于 一 个 PostgreSQL 里 没有 的 


self_referencing_column_name sql_identifier 

特性 

: EN Nan + 
reference_generation character_data 应 用 于 | PostgreSQL 里 没有 的 

特性 

如 果 该 表 是 一 个 指定 类 型 的 表 ， 那 

J BEHA bx 米 FU 
user_defined_type_catalog sql_identifier 公 束 是 包含 基 本 的 数据 类 型 的 数据 

库 名 称 (总 是 当前 数据 库 ) , A 

则 为 空 。 

如 果 该 表 是 一 个 指定 类 型 的 表 ， 那 
user_defined_type_schema sql_identifier 么 就 是 包含 基本 的 数据 类 型 的 模式 

名 称 ， 否 则 为 空 。 

如 果 该 表 是 一 个 指定 类 型 的 表 ， 那 
user_defined_type_name sql_identifier 么 为 基础 数据 类 型 的 名 称 ， 否 则 为 

空 。 

如 果 该 表 可 插入 则 为 ves, BM 
is_insertable_into yes_or_no 为 NO (基础 表 总 是 可 插入 的 ， 视 

图 不 是 必须 的 。 ) 

FE -一 个 指定 类 型 巩 

RAS PA 如 果 该 表 是 一 个 指定 类 型 的 表 则 


为 YES, ANJA NO 


commit_action character_data 目前 未 实现 


34.53. triggered_update_columns 


对 于 当前 数据 库 中 的 触发 器 来 说 指定 一 个 字段 列表 ( 像 UPDATE OF columni, column2 ) , 视 
triggered_update_columns 识别 这 些 字段 。 触 发 器 不 指定 一 个 不 包含 在 这 个 视图 中 的 字段 列 
ko 只 有 那些 当前 用 户 拥 有 或 有 除了 sELEcT 之 外 的 某 些 权限 的 字段 才 显 示 。 


Table 34-51. triggered_update_columns 字段 


名 字 数据 类 型 描述 

trigger_catalog sql identifier 包含 该 触发 器 的 数据 库 名 称 (总 是 当前 数 
据 库 ) 

trigger_schema sql_identifier 包含 该 触发 器 的 模式 名 称 
trigger_name sql_identifier 触发 器 的 名 称 
event_object_catalog sql_identifier aie a (总 
event_object_schema sql_identifier 包含 定义 了 触发 器 的 表 的 模式 名 称 
event_object_table sql_identifier 定义 了 触发 器 的 表 名 


event_object_column sql_identifier 定义 了 触发 器 的 字段 的 名 称 


34.54. triggers 


视图 triggers 包含 了 所 有 在 当前 数据 库 中 的 表 和 视图 上 定义 的 ， 并 且 当 前 用 户 是 其 所 有 者 或 
有 除了 sELEcT 之 外 的 某 些 权限 的 触发 器 。 


Table 34-52. triggers 字段 


名 字 
trigger_catalog 


trigger_schema 


trigger_name 


event_manipulation 


event_object_catalog 


event_object_schema 
event_object_table 


action_order 


action_condition 


action_statement 


action_orientation 


action_timing 


action_reference_old_table 


action_reference_new_table 


action_reference_old_row 


action_reference_new_row 


created 


数据 类 型 
sql_identifier 


sql_identifier 


sql_identifier 


character_data 


sql_identifier 


sql_identifier 
sql_identifier 


cardinal_number 


character_data 


character_data 


character_data 


character_data 


sql_identifier 


sql_identifier 


sql_identifier 


sql_identifier 


time_stamp 


描述 

包含 该 触发 器 的 数据 库 名 称 (总 是 
当前 数据 库 ) 

包含 该 触发 器 的 模式 名 称 
触发 器 名 称 
激发 触发 器 的 事件 

( INSERT , UPDATE 或 者 DELETE ) 
包含 触发 器 定义 所 在 表 的 数据 库 名 
称 ( 总 是 当前 数据 库 ) 

包含 触发 器 定义 所 在 表 的 模式 名 
触发 器 定义 所 在 的 表 名 

尚未 实现 

WHEN 触发 器 条 件 ， 如 果 没 有 则 为 


空 (如 果 当 前 角色 不 是 该 表 的 所 有 
者 也 为 空 ) 


触发 器 执行 的 语句 (目前 总 
是 EXECUTE PROCEDURE 


_function_ (> 
标识 触发 器 是 对 处 理 的 每 一 行 激发 
还 是 对 每 个 语句 激发 ( Row 或 
者 STATEMENT ) 
触发 器 触发 的 时 间 

( BEFORE , AFTER BX 
者 INSTEAD oF ) 


应 用 于 一 个 PostgreSQL 里 没有 的 特 
性 
应 用 于 一 个 PostgreSQL 里 没有 的 特 
性 
应 用 于 一 个 PostgreSQL 里 没有 的 特 
性 
应 用 于 一 个 PostgreSQL 里 没有 的 特 
性 


应 用 于 一 个 PostgreSQL 里 没有 的 特 
性 


PostgreSQL 里 面 的 触发 器 在 影响 到 信息 模式 的 表现 形式 方面 ， 与 SQL 标准 有 两 处 不 同 。 首 
先 ， 在 PostgreSQL 里 ， 触 发 器 名 字 是 表示 本 地 的 对 象 ， 而 不 是 独立 的 模式 对 象 。 因 此 ， 我 们 
可 以 在 一 个 模式 里 定义 重复 的 触发 器 名 字 ， 只 要 他 们 属于 不 同 的 表 。 

( trigger_catalog 和 trigger_schema 实际 上 是 属于 触发 器 定义 所 在 表 的 值 。) 第 二 ， 


PostgreSQL 里 的 触发 器 可 以 定义 为 在 多 个 事件 上 触发 (比如 on INSERT OR UPDATE ) , mi 
SQL 标准 只 人 允许 一 个 。 如 果 一 个 触发 器 定义 为 在 多 个 事件 上 触发 ， 那 么 在 信息 模式 里 它 会 
现 为 多 行 ， 事 件 的 每 个 类 型 一 行 。 因 为 这 两 个 原因 ， 视图 triggers 的 主键 实际 上 

是 (trigger_catalog, trigger_schema, event_object_table, trigger_name, event_manipulation) 
, MA (trigger_catalog, trigger_schema, trigger_name), 后 者 是 SQL 标准 声明 的 。 当 
然 ， 如 果 你 定义 一 个 遵循 SQL 标准 的 触发 器 (触发 器 名 字 在 模式 中 唯一 ， 并 且 每 个 触发 器 只 
有 一 个 事件 类 型 ) ， 这 些 事情 不 会 烦 着 你 。 


Note: 在 PostgreSQL 9.1 之 前 ， 这 个 视图 的 字段 action timing , 
action_reference_old_table , action_reference_new_table , action_reference_old_row , 
和 action_reference_new_row 分 别 叫做 condition_timing , 
condition_reference_old_table , condition_reference_new_table , 
condition_reference_old_row , 和 condition_reference new row. 这 是 它们 在 SQL:1999 
标准 中 的 名 字 。 新 的 名 字符 合 SQL:2003 和 之 后 的 标准 。 


34.55. udt_privileges 


视图 udt_privileges 标识 授予 当前 用 户 或 由 当前 用 户 授予 用 户 定义 类 型 的 usas 权限 。 对 于 
每 个 字段 、 授 权 者 和 受权 者 的 组 合 都 有 一 行 。 这 个 视图 只 显示 复合 类 型 (参阅 Section 34.57 
获得 原因 ) ; 参阅 Section 34.56 获 取 域 的 权限 。 


Table 34-53. udt_privileges 字段 


名 字 
grantor 
grantee 
udt_catalog 
udt_schema 
udt_name 
privilege _type 


is_grantable 


数据 类 型 
sql_identifier 
sql_identifier 
sql_identifier 
sql_identifier 
sql_identifier 
character_data 


yes_or_no 


描述 
授予 特权 的 角色 名 称 
被 授予 特权 的 角色 名 称 
包含 该 类 型 的 数据 库 名称 (总 是 当前 数据 库 ) 
包含 该 类 型 的 模式 名 称 
类 型 名 
总 是 TYPE USAGE 


如 果 权 限 可 授予 ， 则 为 ves, BMA no 


34.56. usage_privileges 


视图 usage_privileges 用 于 标识 在 各 种 类 型 的 对 象 上 赋 与 当前 用 户 或 者 当前 用 PRS 
usace 权限 。 在 PostgreSQL 中 ， 当前 适用 于 排序 规则 、 域 、 外 部 数据 封装 、 外 部 服务 器 和 
序列 。 每 个 对 象 、 授 权 者 和 受权 者 的 组 合 都 有 一 行 。 


因为 在 PostgreSQL 里 ， 排 序 规则 并 没有 真正 的 权限 ， 所 以 这 个 视图 显示 了 隐 含 的 
由 purc 的 所 有 者 授予 所 有 排序 规则 的 非 可 授予 的 usace 权限 。 其 他 的 对 象 类 型 显示 了 真 
正 的 权限 。 


在 PostgreSQL 中 ， 序 列 也 支持 SELECT 和 uppate 权限 ， PRY usace 权限 。 这 不 是 标准 并 且 
因此 在 信息 模式 中 不 可 见 。 


Table 34-54. usage_privileges 字段 


名 字 数据 类 型 描述 
grantor sql_identifier 授权 的 角色 名 
grantee sql_identifier 被 授权 的 角色 名 


object_catalog sql_identifier 包含 该 对 象 的 数据 库 名 (总 是 当前 数据 库 ) 


如 果 适用 ， 是 包含 该 对 象 的 模式 名 ， 否 则 是 空 字 
PR 


object_name sql_identifier 对 象 名 


object_schema sql_identifier 


COLLATION 或 DOMAIN 或 
object_type character_data FOREIGN DATA WRAPPER 或 FOREIGN SERVER 
或 SEQUENCE 


privilege_type character_data 总 是 USAGE 


is_grantable yes_or_no 如 果 权 限 可 授予 则 为 YES, G4 No 


34.57. user_defined_types 


视图 user_defined_types 当前 包含 所 有 在 当前 数据 库 中 定义 的 复合 类 型 。 只 有 当前 用 户 可 以 
访问 的 类 型 地 显示 出 来 〈 通 过 成 为 其 所 有 者 或 有 某 些 权限 ) o 


SQL 知道 两 种 用 户 定义 的 类 型 : 结构 化 类 型 〈 在 PostgreSQL 中 也 成 为 复合 类 型 ) 和 不 同类 型 

(在 PostgreSQL 中 没有 实现 ) 。 为 了 永 不 过 时 ， 使 用 字段 user_defined_type_category 来 区 
分 它们 。 其 他 用 户 定义 类 型 ， 例如 基础 类 型 和 枚 举 类 型 ， 是 PostgreSQL 的 扩展 ， 不 在 这 里 展 
示 。 AF, Bi Section 34.22, 


Table 34-55. user_defined_types 字段 


名 字 数据 类 型 描述 
Soy FU HŽ yaw 

user_defined_type_catalog sql_identifier 包含 该 类 型 的 数据 库 名 称 (总 是 当 

前 数据 库 ) 
user_defined_type_schema sql_identifier 包含 该 类 型 的 模式 名 称 
user_defined_type_name sql_identifier 类 型 名 
user_defined_type_category character_data 当前 总 是 STRUCTURED 

: =A Nal A 
is_instantiable yes_or_no 运用 于 | PostgreSQL 中 没有 的 特 

性 

: ZA Nal 人 
eee ER 适用 于 一 个 PostgreSQL 中 没有 的 特 

性 

: = Is Nar 人 
ordering_form character_data 适用 于 | PostgreSQL 中 没有 的 特 

性 

: — I~ Nal 人 
ordering_category character_data rie | PostgreSQL 中 没有 的 特 

: — I. Nar 人 
ordering_routine_catalog sql_identifier ~ | PostgreSQL 中 没有 的 特 

: ZA Nal 人 
ordering_routine_schema sql_identifier oe | PostgreSQL 中 没有 的 特 

: 三 四 Nal 人 
ordering_routine_name sql_identifier iad | PostgreSQL 中 没有 的 特 

: TA Pah 人 
reference_type character_data ie | PostgreSQL 中 没有 的 特 

: 一 从 Nan + 
data_type character_data 适用 于 | PostgreSQL 中 没有 的 特 

性 

: ESN Sah A 
character_maximum_length cardinal_number 适用 于 | PostgreSQL 中 没有 的 特 


性 


character_octet_length 


character_set_catalog 


character_set_schema 


character_set_name 


collation_catalog 


collation_schema 


collation_name 


numeric_precision 


numeric_precision_radix 


numeric_scale 


datetime_precision 


interval_type 


interval_precision 


source_dtd_identifier 


ref_dtd_identifier 


cardinal_number 


sql_identifier 


sql_identifier 


sql_identifier 


sql_identifier 


sql_identifier 


sql_identifier 


cardinal_number 


cardinal_number 


cardinal_number 


cardinal_number 


character_data 


cardinal_number 


sql_identifier 


sql_identifier 


一 个 PostgreSQL 中 没有 的 特 


一 个 PostgreSQL 中 没有 的 特 


一 个 PostgreSQL 中 没有 的 特 


一 个 PostgreSQL 中 没有 的 特 


一 个 PostgreSQL 中 没有 的 特 


一 个 PostgreSQL 中 没有 的 特 


一 个 PostgreSQL 中 没有 的 特 


一 个 PostgreSQL 中 没有 的 特 


一 个 PostgreSQL 中 没有 的 特 


一 个 PostgreSQL 中 没有 的 特 


一 个 PostgreSQL 中 没有 的 特 


一 个 PostgreSQL 中 没有 的 特 


一 个 PostgreSQL 中 没有 的 特 


一 个 PostgreSQL 中 没有 的 特 


一 个 PostgreSQL 中 没有 的 特 


34.58. user_mapping_options 


视图 user_mapping_ options 包含 在 当前 数据 库 中 为 用 户 映射 定义 的 所 有 项 。 只 有 那些 当前 用 
户 可 以 访问 相应 外 部 服务 器 的 用 户 映射 地 显示 〈 通 过 成 为 其 所 有 者 或 有 某 些 权限 ) 。 


Table 34-56. user_mapping_options 字段 


名 字 数据 类 型 
authorization_identifier sql_identifier 
foreign_server_catalog sql_identifier 
foreign_server_name sql_identifier 
option_name sql_identifier 
option_value character_data 


描述 


被 映射 的 用 户 名 称 ， 或 如 果 映 射 是 公 
HÉJA PUBLIC 


该 映射 使 用 的 外 部 服务 器 定义 所 在 的 
数据 库 名 称 (总 是 当前 数据 库 ) 


该 映射 使 用 的 外 部 服务 器 的 名 称 
选项 名 


选项 值 。 这 个 字段 将 显示 null 除 非 当前 
用 户 是 被 映射 的 用 户 ， 或 映射 

是 puBLIc 并 且 当 前 用 户 是 服务 器 拥有 
者 ， 或 当前 用 户 是 超级 用 户 。 这 样 的 
目的 是 为 了 保护 密码 信息 作为 用 户 映 
射 选 项 存储 。 


34.59. user_mappings 


视图 user_mappings 包含 所 有 定义 在 当前 数据 库 中 的 用 户 映射 。 只 有 那些 当前 用 户 可 以 访问 
相应 的 外 部 服务 器 的 用 户 映射 才 显 示 (通过 成 为 所 有 者 或 拥有 一 些 特权 ) o 


Table 34-57. user_mappings 字段 


名 字 数据 类 型 
authorization_identifier sql_identifier 
foreign_server_catalog sql_identifier 
foreign_server_name sql_identifier 


描述 


被 映射 的 用 户 名 称 ， 或 如 果 映 射 是 公 
共 的 为 PUBLIC 


被 该 映射 使 用 的 外 部 服务 器 定义 所 在 
的 数据 库 名 称 (总 是 当前 数据 库 ) 


被 该 映射 使 用 的 外 部 服务 器 的 名 称 


34.60. view_column_usage 
视图 view_column_usage 标识 所 有 在 一 个 视图 的 查询 表达 式 (定义 视图 的 SELECT 语句) 中 使 
用 的 字段 。 只 有 在 当前 用 户 是 包含 该 字段 的 表 的 所 有 者 的 时 候 才 会 列 出 这 个 字段 。 

Note: 系统 表 的 字段 没有 列 出 。 以 后 应 该 修补 这 个 问题 。 


Table 34-58. view_column_usage 字段 


名 字 数据 类 型 描述 

view_catalog sql_identifier 包含 这 个 视图 的 数据 库 名 称 (总 是 当前 数据 库 ) 

view_schema sql_identifier 包含 这 个 视图 的 模式 名 称 

view_name sql_identifier 视图 名 称 

table_catalog sql_identifier AM Pa A EA BY ER BY Ze A EB SHR BS 
字 (总 是 当前 数据 库 ) 

table_schema sql_identifier SABIE Pa A EA BY ER BY Ze A EB HR BS 
字 (总 是 当前 数据 库 ) 

table_name sql_identifier 包含 被 这 个 视图 使 用 的 字段 的 表 名 


column_name sql_identifier 视图 使 用 的 字段 名 


34.61. view_routine_usage 


视图 view_routine_usage 识别 所 有 被 应 用 在 视图 的 查询 表达 式 (定义 该 视图 的 SELECT 语句 ) 


中 的 日 常 活动 《函数 和 程序 ) 。 


Table 34-59. view_routine_usage 字段 


名 字 
table_catalog 


table_schema 


table_name 
specific_catalog 
specific_schema 


specific_name 


数据 类 型 
sql identifier 


sql_identifier 


sql_identifier 
sql_identifier 
sql_identifier 


sql_identifier 


只 有 当前 用 户 是 这 个 活动 的 所 有 者 的 时 候 才 包含 这 个 活动 。 


描述 


包含 该 视图 的 数据 库 的 名 称 (总 是 当前 数据 
库 ) 


包含 该 视图 的 模式 的 名 称 
视图 名 


包含 该 函数 的 数据 库 的 名 称 (总 是 当前 数据 
库 ) 


包含 该 图 数 的 模式 的 名 称 


函数 的 "专用 名 "。 参 阅 Section 34.40 获 取 更 多 
fa. 


34.62. view_table_usage 
视图 view_table_usage 标识 所 有 在 一 个 视图 的 查询 表达 式 中 (定义 视图 的 sELECT 语句 ) 使 
用 的 表 的 名 字 。 只 有 在 当前 用 户 是 这 个 表 的 所 有 者 的 时 候 才 会 包含 这 个 表 。 

Note: 没有 包括 系统 表 。 这 个 在 将 来 应 该 修补 。 


Table 34-60. view_table_usage 字段 


名 字 数据 类 型 描述 
view_catalog sql_identifier 包含 该 视图 的 数据 库 的 名 称 (总 是 当前 数据 库 ) 
view_schema sql_identifier 包含 该 视图 的 模式 的 名 称 
view_name sql_identifier 视图 洛 
A > ae vy Swot 
table_catalog sql_identifier ri ee (总 是 at 


table_schema sql_identifier 包含 被 视图 使 用 的 表 的 模式 名 称 
table_name sql_identifier 视图 使 用 的 表 的 名 称 


34.63. views 


视图 views 包含 所 有 定义 在 当前 数据 库 中 的 视图 。 
者 要 么 是 拥有 某 些 权 限 ) 的 视图 才 显 示 出 来 。 


Table 34-61. views 字段 
名 字 
table_catalog 


table_schema 


table_name 


view_definition 


check_option 


is_updatable 


is_insertable_into 


is_trigger_updatable 


is_trigger_deletable 


is_trigger_insertable_into 


数据 类 型 
sql_identifier 


sql_identifier 


sql_identifier 


character_data 


character_data 


yes_or_no 


WAS) 10) SINK) 


VESzZzO el 


yes_or_no 
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只 有 那些 当前 用 户 有 权 访 问 (要 么 是 所 有 


描述 


包含 这 个 视图 的 数据 库 名 称 (总 是 当 
前 数据 库 ) 


包含 这 个 视图 的 模式 名 称 
视图 名 称 


定义 视图 的 查询 表达 式 (如 果 当 前 用 
户 不 是 视图 所 有 者 ， 则 为 空 ) 


应 用 于 一 个 PostgreSQL 里 没有 的 特 
性 


如 果 视 图 是 可 更 新 的 则 为 ves (fè 
许 UPDATE 和 DELETE )) ， 否则 


为 NO 
如 果 视 图 是 可 插入 的 则 为 ves (多 


许 INSERT) ， 否则 为 no 


如 果 在 视图 上 定义 了 一 
个 INSTEAD OF UPDATE 触发 器 则 
为 Yes, ARIA no 


如 果 在 视图 上 定义 了 一 
个 INSTEAD OF DELETE 触发 器 则 
为 ves, GRA NO 


如 果 在 视图 上 定义 了 一 
个 INSTEAD OF INSERT 触发 器 则 
为 YES, ARIA NO 
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piace 这 些 是 高 级 主题 ， td 卖 完 并 理解 所 有 其 它 PostgreSQL 手册 
之 后 才能 阅读 。 这 部 分 后 面 的 章节 还 描述 了 在 PostgreSQL 里 的 服务 器 端 编程 语言 。 我 们 至 少 
要 读 过 Chapter 35 的 头 几 节 才 能 深入 阅读 有 关 服 务 器 端 编程 语言 的 材料 。 
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35.1. 扩展 性 是 如 何 实现 的 


PostgreSQL 可 扩展 的 原因 是 它 的 操作 是 由 表 驱 动 的 。 如 果 你 熟悉 标准 的 关系 数据 库 系 统 ， 
你 就 知道 它们 把 数据 库 、 表 、 字 段 等 信息 存储 在 一 个 被 称 为 系统 表 (有 些 系 统称 为 数据 字典 ) 
的 地 方 。 这 些 表 与 其 它 表 没什么 不 同 ， 只 不 过 DBMS 把 它 自己 内 部 的 信息 存放 于 此 里 了 。 
PostgreSQL 与 其 它 系 统 的 不 同 之 处 在 于 它 在 系统 表 里 存 储 了 更 多 的 信息 : 除了 关于 表 和 列 / 
字段 的 信息 之 外 ， 还 有 关于 它们 的 类 型 、 画 数 、 访 问 方式 之 类 的 信息 。 这 些 表 可 以 被 用 户 修 
改 ， 而且 由 于 PostgreSQL 的 内 部 操作 是 以 这 些 表 为 基础 的 ， 这 就 意味 着 PostgreSQL 可 以 被 
用 户 进行 扩展 。 相 比 之 下 ， 传统 的 数据 库 系 统 只 能 通过 修改 源 代 码 或 加 载 由 DBMS 供 应 商 提 
供 的 特殊 模块 来 扩展 。 


PostgreSQL 还 可 以 通过 动态 加 载 的 方法 与 用 户 书写 的 代码 结合 在 一 起 。 也 就 是 说 ， 用 户 可 以 
把 一 个 目标 代码 文件 (通常 是 共享 库 ) 声明 为 一 个 新 类 型 或 范 数 的 实现 ， 这 时 PostgreSQL 将 根 
据 需要 加 载 它们 。 用 SQL 书写 的 代码 甚至 更 容易 加 入 到 服务 器 中 去 。 这 种 可 以 "在 线 "更 改 操 
作 的 能 力 使 PostgreSQL 特 别 适 合 于 新 应 用 和 新 存储 结构 的 快速 定型 。 


35.2. PostgreSQL 类 型 系统 


PostgreSQL 数 据 类 型 可 以 分 为 基本 类 型 、 复 合 类 型 、 域 、 伪 类 型 。 


35.2.1. 基本 类 型 


基本 类 型 是 那些 在 SQL 语言 层次 更 低级 别 (通常 是 C 语 言 ) 上 实现 的 类 型 (比如 ints 类 型 )， 它 
们 通常 与 抽 像 数据 类 型 对 应 。PostgreSQL 对 这 些 数据 类 型 只 能 通过 用 户 提供 的 函数 来 操作 ， 
并 且 对 这 些 数 据 类 型 行为 的 理解 只 限于 用 户 所 描述 的 范围 。 基 本 类 型 进一步 分 成 标量 和 数组 
类 型 。 对 于 每 种 标量 类 型 ， 系 统 都 会 自动 创建 一 个 对 应 的 数组 类 型 ， 可 以 保存 该 标量 类 型 的 
变 长 数组 。 


35.2.2. 复合 类 型 


复合 类 型 (或 者 说 行 类 型 ) 是 用 户 创建 表 时 创建 的 。 也 可 以 用 CREATE TYPE 创 建 一 个 "独立 
的 "、 没 有 关联 表 的 复合 类 型 。 复合 类 型 只 是 一 个 带 着 相关 字段 名 称 的 基本 类 型 的 列表 。 复合 
类 型 的 数值 是 一 行 字段 值 或 者 一 条 字段 值 组 成 的 记录 。 用 户 可 以 从 SQL 查 询 里 访问 其 字段 。 
参考 Section 8.16 获 取 更 多 复合 类 型 的 相关 信息 。 


35.2.3. 域 

域 基于 一 种 特定 的 基本 类 型 ， 从 很 多 角度 来 看 ， 它 们 也 可 以 和 其 对 应 的 基本 类 型 交换 。 但 
是 ， 域 可 以 有 约束 ， 把 它 的 有 效 值 限制 在 其 对 应 的 基本 类 型 的 有 效 值 范 围 的 一 个 子 集中 。 
域 可 以 使 用 SQL 命令 CREATE DOMAIN 创 建 。 它们 的 创建 和 使 用 不 在 本 章 讨 论 。 


35.2.4. 伪 - 类 型 


有 一 些 用 于 特殊 目的 " 伪 类 型 "。 伪 类 型 不 能 作为 表 的 字段 类 型 ， 也 不 能 作为 复合 类 型 的 属 
性 ， 但 是 它们 可 以 用 于 声明 本 数 的 参数 和 结果 类 型 。 这 样 就 在 关 型 系统 里 提供 了 一 个 标识 特 
殊 类 型 函数 的 机 制 。 Table 8-24 列 出 了 现 有 的 伪 类 型 。 


anyelement ，anyarray , anynonarray , anyenum ， 和 anyrange 是 五 种 特别 有 趣 的 伪 类 型 ， 它 
们 被 称 作 多 态 类 型 。 任何 用 这 些 类 型 定义 的 函数 就 叫做 多 态 画 数 。 一 种 多 态 画 数 可 以 在 许多 
不 同 的 数据 类 型 上 操作 ， 它们 根据 调用 中 实际 传递 进来 的 数据 类 型 判断 具体 的 类 型 。 


多 态 参 数 和 结果 是 相互 绑 定 的 ， 并 且 在 分 析 查 询 调用 的 画 数 时 解析 成 特定 的 数据 类 型 。 每 个 
声明 成 anyelement 的 位 置 (参数 或 者 返回 类 型 ) 都 允许 拥有 一 个 特定 的 实际 数据 类 型 ， 但 是 在 
任何 给 定 的 调用 过 程 中 ， 它 们 都 必须 是 同样 的 类 型 。 每 个 声明 为 anyarray 的 位 置 都 可 以 是 任 
何 数组 数据 类 型 ， 类 似 的 ， 声 明 为 anyrange 的 位 置 也 必 许 都 是 同样 的 类 型 。 而 且 ， 如 果 有 些 
位 置 声明 为 anyarray 而 其 它 位 置 声明 为 anyelement , 那么 在 anyarray 位 置 上 的 类 型 必须 是 
元 素 类 型 与 那些 出 现在 anyelement 位 置 上 的 类 型 相同 的 数组 。 类 似 的 ， 如 果 有 声明 

为 anyrange 的 位 置 而 且 其 他 的 声明 为 anyelement , ABZ 在 anyrange 位 置 上 的 类 型 必须 是 子 
类 型 与 那些 出 现在 anyelement 位 置 上 类 型 相同 的 范围 。 anynonarray 实际 上 被 看 

做 anyelement ， 但 却 多 一 个 约束 : 实际 类 型 必须 不 能 是 一 个 数组 类 型 。 anyenum 实际 上 被 
看 做 anyelement , 但 却 多 一 个 约束 : 实际 类 型 必须 是 一 个 枚 举 类 型 。 


因此 ， 如 果 多 个 参数 位 置 声 明 为 多 态 类 型 ， 其 实际 效果 是 只 人 允许 某 些 实际 参数 类 型 的 组 合 出 
现 。 上 比如， 一 个 函数 声明 为 equal(anyelement，anyelement) 将 接受 任何 两 个 输入 值 ， 只 要 它 
们 的 数据 类 型 相同 。 


如 果 一 个 画 数 的 返回 值 声明 为 多 态 类 型 ， 那 么 至 少 有 一 个 参数 位 置 也 是 多 态 的 ， 并 且 提 供给 
参数 的 类 型 决定 本 次 调用 实际 返回 的 类 型 。 比 如 ， 如 果 没 有 数组 下 标 机制 ， 那么 我 们 可 以 定 
义 一 个 实现 下 标的 辑 数 subscript(anyarray，integer) returns anyelement 。 这 个 声明 约束 第 
一 个 实际 参数 是 一 个 数组 类 型 ， 并 且 人 允许 分 析 器 从 第 一 个 参数 的 实际 类 型 推导 出 正确 的 返回 
类 型 。 声明 为 一 个 f(anyarray) returns anyenum 的 函数 的 另 一 个 例子 只 接受 枚 举 类 型 的 数 
组 。 


需要 注意 的 是 ， anynonarray 和 anyenum 不 代表 不 同 的 类 型 变量 ; 它们 是 与 anyelement 相同 
的 类 型 ， 只 有 一 个 额外 的 约束 。 例如 ， 声 明 一 个 函数 为 f(anyelement，anyenum) 等 同 于 声明 
它 为 f(anyenum，anyenum) : 两 个 实际 参数 必须 是 相同 的 枚 举 类 型 。 


一 个 可 变 参 数 画 数 (其 使 用 一 个 可 变数 目的 参数 ， 如 Section 35.4.5 中 描述 ) 可 以 是 多 态 的 : 
可 以 通过 声明 它 的 最 后 一 个 参数 为 VARIADIC  anyarray 来 实现 。 为 了 实现 参数 匹配 并 决定 实 
际 结 果 类 型 ， 这 样 一 个 范 数 的 行为 等 同 于 将 anynonarray 参数 写 一 个 合适 的 数目 。 


35.3. BPEL RR 


PostgreSQLiett T DAE : 

。 SARANA (MASSAL) (Section 35.4) 

。 程序 语言 函数 (函数 缩写 ,比如 ，PL/pgSQL 或 者 PL/Tcl) (Section 35.7) 
e 内 部 郴 数 (Section 35.8) 

。 C-i45 WM R(Section 35.9) 


— th SE 复合 类 型 ， 或 者 两 者 的 组 合作 为 参数 。 AM, FIRER A 
返回 基本 类 型 或 者 复合 函数 也 可 以 定义 为 返回 基本 或 者 复合 值 的 集合 


许多 种 函数 可 以 接受 或 者 返回 某 些 伪 类 型 (比如 多 态 类 型 ) ， 但 是 可 用 设施 不 同 。 查阅 各 种 
EX RAY Fah LL HF 活 取 更 多 详细 信息 。 


RAAT SOLAR, Albis, 大 多 数 用 于 SQL 画 数 的 概念 和 煌 和 其 它 类 型 
的 范 数 一 致 。 


在 本 章 中 ， 参 考 CREATE FUNCTION 命 令 手 册页 对 于 更 好 的 理解 例子 是 很 有 帮助 的 。 ABN 
例子 还 不 可 以 在 PostgreSQL 源 码 发 布 的 src/tutorial 目录 的 funcs.sql 和 funcs.c 中 找到 。 


35.4. & i413 E (SQL) WX 


SQLEBUATSOLIZANERWR, ROIR ARa AER 在 简单 情况 下 GER 
合 ) ， 将 返回 最 后 查询 结果 的 第 一 行 。 ( 记 住 多 行 结果 的 "第 一 行 " 是 不 明确 的 除非 你 使 
用 oRDER BY 。) 如 果 最 后 查询 没有 返回 任何 行 ， 则 返回 空 值 。 


另外 ， 一 个 SQL 画 数 可 以 声明 为 返回 一 个 集合 ( 即 多 行 ) 。 方法 是 把 该 琅 数 的 返回 类 型 声明 
为 SETOF _sometype 。 或 者 等 价 声明 它 为 RETURNS TABLE(`…_columns”)。 这 种 情况 下 ， 最 后 
一 条 查询 结果 的 所 有 行 都 会 被 返回 。 更 多 细节 在 下 面 讲解 。 


SQL 辑 数 的 函数 体 应 该 是 一 个 用 分 号 分 隅 的 SQL 语 句 列 表 。 最 后 一 个 语句 后 面 的 分 号 是 可 选 
的 。 除 非 函 数 声 明 为 返回 void, 否则 最 后 一 条 语句 必须 是 SELECT 或 者 INSERT, 
UPDATE 或 者 有 RETURNING 子 句 的 DELETE o 


任何 SQL 命 合集 合 都 可 以 打包 在 一 起 ， 定 义 成 新 的 画 数 。 除了 sELECT 查询 之 外 ， 命 邻 可 以 包 
AEE ( INSERT , UPDATE 和 DELETE ) 以 及 其 它 SQL 命令 。 (你 不 能 使 用 事务 控制 
ae, EERO commit ，SAVEPOINT 和 一 些 实用 命令 ， 比 如 vacuum, SQL). 不 过 ， 最 后 一 条 
a 须 是 一 个 sELECT 语句 ， 或 者 有 RETURN FARO WAAR eH, BA, 如 果 你 
pai 义 一 连 串 动作 而 无 需 返回 任何 数值 ， 可 以 定义 返回 void o 比如 ， 下 面 这 个 函数 

emp 表 删 除 负 数 的 薪水 : 


= 加 


CREATE FUNCTION clean_emp() RETURNS void AS ' 
DELETE FROM emp 
WHERE salary < 0; 
' LANGUAGE SQL; 
SELECT clean_emp(); 


clean_emp 


(1 row) 


CREATE FUNCTION 命令 的 语法 要 求 函 数 体 写 成 一 个 字符 串 文 本 。 一 般 来 说 ， 字 符 串 常量 使 用 美 
元 符 界定 更 方便 些 (参阅 Section 4.1.2.4)。 如 果 你 决定 使 用 通常 的 字符 串 常 量 语法 ， 你 必须 加 
单 引号 标记 ( ' ) 和 和 反 斜 本 (\ )， NRA 〈 假 定 使 用 逃逸 字符 串 语 法 ) (参见 Section 
4421) a 


35.4.1. Arguments for SQL Functions 


EAA DRAB F ASALAIA. RAMA RFE FA. 


A-TAF, PHAAMHNRSA, ABEWMAPSLERTAF, MREMAM ES 
RISALA TAY] — WRAPS ENA, SACS BIA, J 限定 参数 名 
与 函数 名 本 身 ， 也 就 是 说 _function_name_ . _argument_name_ o (如 果 有 一 合格 的 列 名 称 冲 
突 ， 再 次 列 名 称 获胜 。 你 可 以 通过 选择 一 个 SQL 命令 表 不 同 的 别 pee ai 


在 旧 的 数值 方法 中 ， 使 用 语法 son s1 引用 第 一 个 输入 参数 ， s2 到 第 二 个 ， 等 等 。 是 
否 声明 带 有 名 字 的 特定 参数 将 要 工作 。 


如 果 一 个 参数 是 复合 类 型 ， 然 后 圆 点 标记 法 ， 比 如 ， argname.fieldname 或 者 
$1.fieldname 可 以 用 于 访问 参数 属性 。 再 次 ， 你 可 能 需要 限定 函数 名 的 参数 名 来 形成 模糊 参 
数 名 形式 。 


SQL 本 数 参数 只 能 作为 数据 值 使 用 ， 而 不 能 作为 标示 符 。 因 此 比如 这 是 合理 的 : 


INSERT INTO mytable VALUES ($1); 


but this will not work: 


INSERT INTO $1 VALUES (42); 





Note: FHES ASALA% DW RER AMNEPostgreSQL 9.24, 在 旧 的 服务 器 中 
使 用 的 函数 必须 使 用 $` n 标记 法 。 


35.4.2. BA ž Æ EAISQALE ŽA 
最 简单 的 SQL 枉 数 可 能 没有 参数 并 且 返 回 一 个 基本 类 型 ， 比如 一 个 返回 integer AYR : 


CREATE FUNCTION one() RETURNS integer AS $$ 
SELECT 1 AS result; 

$$ LANGUAGE SQL; 
- -另外 一 种 字符 串 文 本 的 语法 : 

CREATE FUNCTION one() RETURNS integer AS ' 
SELECT 1 AS result; 

" LANGUAGE SQL; 


SELECT one(); 


WEBRNENMABHER S—TSFRGA( result AFAA R, 但 是 这 个 字段 别名 在 
KAADETA A. Alt, 结果 是 以 one 而 不 是 result 为 标签 的 。 


定义 一 个 接受 基本 类 型 做 参数 的 SQL 男 数 几乎 一 样 简单 。 


CREATE FUNCTION add_em(x integer, y integer) RETURNS integer AS $$ 
SELECT x + y; 
$$ LANGUAGE SQL; 


SELECT add_em(1, 2) AS answer; 


answer 


HH, RNTARASRA, HARMS : 


CREATE FUNCTION add_em(integer, integer) RETURNS integer AS $$ 
SELECT $1 + $2; 
$$ LANGUAGE SQL; 


SELECT add_em(1, 2) AS answer; 


answer 


下 面 是 一 个 更 有 用 的 画 数 ， 我 们 可 以 用 它 对 一 个 银行 帐号 做 扣 款 动作 : 


CREATE FUNCTION tf1 (accountno integer, debit numeric) RETURNS integer AS $$ 
UPDATE bank 
SET balance = balance - debit 
WHERE accountno = tf1.accountno; 
SELECT 1; 
$$ LANGUAGE SQL; 


可 以 像 下 面 这 样 用 这 个 函数 给 帐户 17 扣 款 $100.00 : 


SELECT tf1(17, 100.0); 


在 这 个 例子 中 ， 我 们 选择 名 称 accountno 作为 第 一 个 参数 ， 但 是 这 和 bank 表 中 的 列 名 是 一 样 
的 。 在 uPDATE 命令 中 ， accountno 引用 列 bank.accountno ， 因此 ， 必 须 使 
用 tfl.accountno 来 引用 参数 。 当 然 我 们 可 以 通过 使 用 参数 的 不 同名 称 来 避免 这 种 情况 。 


实际 上 我 们 可 能 希望 男 数 有 一 个 比 常量 1 更 有 用 一 些 的 结果 。 所 以 实用 的 定义 可 能 是 


CREATE FUNCTION tf1 (accountno integer, debit numeric) RETURNS integer AS $$ 
UPDATE bank 
SET balance = balance - debit 
WHERE accountno = tf1.accountno; 
SELECT balance FROM bank WHERE accountno = tfi1.accountno; 
$$ LANGUAGE SQL; 


它 修改 余额 并 返回 新 的 余额 。 可 以 在 命令 中 使 用 RETURNING 做 同样 的 事情 : 


CREATE FUNCTION tf1 (accountno integer, debit numeric) RETURNS integer AS $$ 
UPDATE bank 
SET balance = balance - debit 
WHERE accountno = tf1.accountno 
RETURNING balance; 
$$ LANGUAGE SQL; 


35.4.3. 2A ž Æ ENSQLWH 


当 书 写 使 用 用 复合 类 型 做 参数 的 函数 时 ， 不 仅 要 声明 需要 哪个 人 参数， 而 且 要 声明 参数 的 字段 
(数据 域 )。 比 如 ， 假 设 emp 是 一 个 包含 屋 员 信息 的 表 ， 并 且 因 此 也 是 该 表 每 行 的 复合 类 型 的 
名 字 。 一 个 计算 某 人 薪水 翻番 之 后 数值 的 double_salary HR : 


CREATE TABLE emp ( 


name text, 
salary numeric, 
age integer, 
cubicle point 


); 

INSERT INTO emp VALUES ('Bill', 4200, 45, '(2,1)'); 

CREATE FUNCTION double_salary(emp) RETURNS numeric AS $$ 
SELECT $1.salary * 2 AS salary; 

$$ LANGUAGE SQL; 

SELECT name, double_salary(emp.*) AS dream 
FROM emp 
WHERE emp.cubicle ~= point '(2,1)'; 

name | dream 


ETET pe ol Fay 


Bill | 8400 


请 注意 这 里 使 用 $1.salary 语法 选择 参数 行 数值 的 一 个 字段 。 还 要 注意 secect 命令 使 
用 * 表示 该 表 的 整个 当前 行 作为 复合 数值 。 表 里 面 的 行 也 可 以 用 表 名 字 引 用 ， 像 下 面 这 样 


SELECT name, double_salary(emp) AS dream 
FROM emp 
WHERE emp.cubicle ~= point '(2,1)'; 


不 过 这 个 用 法 已 经 废弃 了 ， 因 为 很 容易 导致 混淆 。 


有 时 候 用 Row 构造 器 动态 地 构造 一 个 复合 参数 值 也 很 有 用 。 比如 ， 我 们 可 以 调节 传递 给 范 数 
的 数据 : 


SELECT name, double_salary(ROW(name, salary*1.1, age, cubicle)) AS dream 
FROM emp; 


也 可 以 写 一 个 返回 复合 类 型 的 范 数 。 下 面 是 一 个 只 返回 一 行 的 emp 图 数 : 


CREATE FUNCTION new_emp() RETURNS emp AS $$ 
SELECT text 'None' AS name, 
1000.0 AS salary, 
25 AS age, 
point '(2,2)' AS cubicle; 
$$ LANGUAGE SQL; 


在 这 个 例子 中 我 们 给 每 个 字段 都 赋予 了 一 个 常量 ， 当然 也 可 以 用 任何 表达 式 来 代替 这 些 常 
量 。 
注意 定义 事 数 的 两 个 重要 问题 : 


e 选择 列表 的 顺序 必须 和 和 与 该 复合 类 型 相关 的 表 中 字段 的 顺序 完全 一 样 。 像 上 面 那样 给 字 
段 命 名 是 和 系统 毫 无 关系 的 。 


。 你 必须 对 表达 式 进 行 类 型 转换 以 匹配 复合 类 型 的 定义 。 否则 你 将 看 到 下 面 的 错误 信息 : 
&lt;samp class="literal"&gt;ERROR: function declared to return emp returns varchar : 
[SS 
另外 一 个 定义 同样 阔 数 的 方法 是 : 





CREATE FUNCTION new emp() RETURNS emp AS $$ 
SELECT ROW('None', 1000.0, 25, '(2,2)')::emp; 
$$ LANGUAGE SQL; 


这 里 的 sELECT 只 返回 对 应 复合 类 型 的 一 个 单独 字段 。 在 这 种 情况 下 ， 这 么 做 并 没有 任何 好 
处 ， 但 是 它 在 某 些 场合 是 一 个 很 好 用 的 东西 一 比如 ， 需 要 通过 调用 另外 一 个 返回 所 需 复 合 类 
型 数值 的 函数 来 计算 结果 


我 们 可 以 用 任何 两 种 方式 直接 调用 这 个 酌 数 : 


SELECT new_emp(); 
new_emp 
(None, 1000.0, 25,"(2,2)"). 
SELECT * FROM new_emp(); 
name | salary | age | cubicle 


Seo 二 = 
None | 1000.0 | 25 | (2,2) 


第 二 种 方法 在 Section 35.4.7 里 有 更 完整 的 描述 
在 使 用 一 个 返回 复合 类 型 的 辑 数 时 ， 你 可 以 用 下 面 的 语法 从 结果 中 只 抽取 一 个 字段 : 


SELECT (new_emp()).name; 


必须 用 一 对 额外 的 圆 括 弧 防 止 分 析 器 误解 。 如 果 省 略 这 对 括 弧 就 会 看 见 类 似 下 面 这 样 的 东 
西 : 


SELECT new_emp().name; 
ERROR: syntax error at or near "." 
LINE 1: SELECT new_emp().name; 

A 


另外 一 个 选择 是 使 用 范 数 表示 法 抽取 字段 。 解释 这 些 问题 的 简单 方法 是 交互 使 


用 attribute(table) 和 table.attribute 表示 法 。 


SELECT name(new_emp()); 


- -上 述 语句 与 下 面 的 这 个 相同 : 
-- SELECT emp.name AS youngster FROM emp WHERE emp.age < 30; 


SELECT name(emp) AS youngster FROM emp WHERE age(emp) < 30; 


youngster 


Tip: BRAD ANF RBERDEZ HEAR RLR I EAS Ge FR 


模拟 "计算 得 出 的 字段 "。 比如 ， 使 用 前 面 的 double_salary(emp) 定义 ， 我 们 可 以 写 


SELECT emp.name, emp.double_salary FROM emp; 


应 用 可 以 直接 这 么 使 用 而 无 需 明 确 知道 double salary 并 不 是 表 中 一 个 真实 的 字段 。 
样 也 可 以 模拟 视图 上 计算 出 的 字段 。 


这 种 操作 ， 给 男 数 采取 单一 类 型 参数 与 复合 类 型 的 任何 字段 名 相同 是 不 明智 


还 有 一 个 使 用 范 数 返回 复合 类 型 的 情况 是 把 结果 传递 给 另外 一 个 输入 该 行 类 型 的 辑 数 : 


CREATE FUNCTION getname(emp) RETURNS text AS $$ 
SELECT $1.name; 
$$ LANGUAGE SQL; 


SELECT getname(new_emp()); 
getname 


还 可 以 把 返回 复合 类 型 的 范 数 当 作 一 个 表 画 数 使 用 ， 如 Section 35.4.7 所 述 


35.4.4. 带 输 出 参数 的 SQL 辑 数 
描述 硬 数 的 结果 的 另外 一 种 方法 是 把 它 定义 成 带 有 输出 参数 的 丽 数 ， 比 如 : 


CREATE FUNCTION add_em (IN x int, IN y int, OUT sum int) 
AS 'SELECT x + y' 
LANGUAGE SQL; 


SELECT add_em(3,7); 
add_em 


这 个 版 本 和 Section 35.4.2 里 面 的 那个 add_em 版 本 没有 什么 本 质 的 区 别 。 输出 参数 的 真正 价 
值 在 于 它 提 供 了 定义 返回 多 个 字段 的 范 数 的 便利 方法 。 上 比如 ， 


CREATE FUNCTION sum_n_product (x int, y int, OUT sum int, OUT product int) 
AS 'SELECT x + y, x * y' 
LANGUAGE SQL; 


SELECT * FROM sum_n_product(11, 42); 
sum | product 


RESRRENS HER I ANMHAROES-TEANSZARH, 上 面 的 例子 和 下 面 的 
例子 有 同样 的 最 终结 


CREATE TYPE sum_prod AS (sum int, product int); 


CREATE FUNCTION sum_n_product (int, int) RETURNS sum_prod 
AS 'SELECT $1 + $2, $1 * $2' 
LANGUAGE SQL; 


不 过 ， 不 用 操心 独立 的 复合 类 型 定义 通常 都 会 很 方便 。 请 注意 附属 于 输出 参数 的 名 称 不 仅仅 
是 修饰 ， 但 也 决定 了 匿名 复合 类 型 的 列 名 。 (如 果 你 为 输出 参数 而 忽略 了 名 称 ， 则 系统 将 选 
择 一 个 自己 的 名 字 ) 。 


HR, MSaLE RARER, MHERHRASERASRIIRE, 这 是 因为 
PostgreSQL 认 为 只 有 输入 参数 定义 函数 的 调用 签名 。 RHERRBELOMRBAR ENA 
里 ， 只 有 输入 参数 管用 。 我 们 可 以 用 下 列 命令 之 一 删除 上 述 本 数 


DROP FUNCTION sum_n_product (x int, y int, OUT sum int, OUT product int); 
DROP FUNCTION sum_n_product (int, int); 


参数 可 以 被 标记 为 IN (GRA), out, Inout 或 者 vARIADIC 。 INOUT 参数 同时 作为 输入 参数 
(调用 参数 列表 的 一 部 分 ) 和 输出 参数 (结果 记录 类 型 的 一 部 分 )。 varai 参数 是 输入 参数 ， 
但 是 作为 描述 文本 特殊 对 待 。 


35.4.5. 带 有 参数 可 变数 量 的 SQL 


SQL 男 数 声 明 接 受 参 数 可 变数 量 ， 只 要 所 有 "optional" 参数 有 相同 数据 类 型 。 可 选 参数 将 被 作 
为 数组 传递 给 图 数 。 图 数 通过 把 最 后 参数 作为 varar 声明 ; 这 个 参数 必须 声明 为 数组 类 
型 。 比 如 : 


CREATE FUNCTION mleast(VARIADIC arr numeric[]) RETURNS numeric AS $$ 
SELECT min($1[i]) FROM generate_subscripts($1, 1) g(i); 
$$ LANGUAGE SQL; 


SELECT mleast(10, -1, 5, 4.4); 
mleast 


实际 上 ， 达 到 或 者 超过 vac 位 置 的 所 有 实际 参数 都 被 聚集 为 一 维 阵 列 ， 正 如 你 写 的 
SELECT mleast(ARRAY[10, -1, 5, 4.4]);  -- doesn't work 
你 可 以 不 写 ， 至 少 它 不 匹配 这 个 函数 定义 。 标 记 VARIADIC 的 参数 匹配 一 个 或 多 个 元 素 类 型 的 
发 生 ， 而 不 是 固有 类 型 
有 时 候 可 以 将 已 构建 数组 传递 给 可 变 参 数 函 数 ; 
SELECT mleast(VARIADIC ARRAY[10, -1, 5, 4.4]); 
这 防止 本 数 的 可 变 参 数 扩展 到 它 的 元 素 类 型 ， 从 而 使 数组 参数 值 正常 匹配 。 vARIADIC 只 可 以 


附属 于 函数 调用 的 最 后 一 个 实 参 


数组 元 素 的 参数 产生 一 个 可 变 的 参数 作为 没有 自己 的 名 字 看 待 。 这 意味 着 它 是 不 可 以 使 用 命 
名 参数 (Section 4.3) 调 用 一 个 可 变 参 数 范 数 ， 除非 你 指定 vARIApIc 。 例 如 ， 这 项 工作 : 


SELECT mleast(VARIADIC arr := ARRAY[10, -1, 5, 4.4]); 


SELECT mleast(arr 
SELECT mleast(arr 


10); 
ARRAY[10, -1, 5, 4.4]); 


35.4.6. RASRARS gHSQLWR 


KATA TRIREMA SAMEA SRMRARTONAS SOSA 
数 的 时 候 ， 插 入 缺 省 值 。 因 为 参数 只 能 从 实际 的 参数 列表 的 末尾 省 略 ， 所 有 具有 默认 值 的 参 
数 都 有 默认 值 。 (虽然 使 用 命名 参数 符号 可 以 让 这 个 限制 宽松 ， 它 仍然 是 强制 的 ， 位 置 参数 
符号 合理 运行 。) 


比如 : 


CREATE FUNCTION foo(a int, b int DEFAULT 2, c int DEFAULT 3) 
RETURNS int 
LANGUAGE SQL 
AS $$ 
SELECT $1 + $2 + $3; 
$$; 


SELECT foo(10, 20, 30); 
foo 


foo 


SELECT foo(); -- fails since there is no default for the first argument 
ERROR: function foo() does not exist 


= 符号 也 可 以 用 在 关键 字 DEFAULT 的 位 置 。 


35.4.7. 作为 表 数 据 源 的 SQL 函 数 


所 有 SQL 图 数 都 可 以 在 查询 的 FRoM 子 句 里 使 用 。 但 是 它 对 于 返回 复合 类 型 的 函数 特别 有 
用 。 如 果 该 图 数 定义 为 返回 一 个 基本 类 型 ， 那么 表 画 数 生成 一 个 单字 段 表 。 如 果 该 画 数 定义 
为 返回 一 个 复合 类 型 ， 那么 该 表 函 数 生成 一 个 该 复合 类 型 里 每 个 属性 组 成 的 行 。 


这 里 是 一 个 例子 


CREATE TABLE foo (fooid int, foosubid int, fooname text); 
INSERT INTO foo VALUES (1, 1, 'Joe'); 

INSERT INTO foo VALUES (1, 2, 'Ed'); 

INSERT INTO foo VALUES (2, 1, 'Mary'); 


CREATE FUNCTION getfoo(int) RETURNS foo AS $$ 
SELECT * FROM foo WHERE fooid = $1; 

$$ LANGUAGE SQL; 

SELECT *, upper(fooname) FROM getfoo(1) AS t1; 


fooid | foosubid | fooname | upper 


RPO BARBVAB HE, ATL te — PS BRE ER FR 


a 
3 


请 注意 我 们 只 从 该 函数 中 获取 了 一 行 。 这 是 因为 没有 使 用 sEToF 。' 这 个 问题 在 下 一 节 讲 述 。 


35.4.8. 返回 集合 的 SQL 函 数 
如 果 一 个 SQL 画 数 声 明 为 返回 sEToF _sometype_, 那么 该 函数 最 后 的 查询 一 行 到 结 
R, 并 且 它 输出 的 每 一 行 都 被 当 作 该 结果 集中 的 一 个 元 素 返 回 。 


这 个 特性 通常 用 于 把 男 数 放 在 FRoM 子 句 里 调用 。 此 时 该 函数 返回 的 每 一 行 都 成 为 查询 可 见 
的 该 表 的 一 行 。 比如 ， 假 设 表 foo 的 内 容 和 上 面相 同 ， 那 么 : 


CREATE FUNCTION getfoo(int) RETURNS SETOF foo AS $$ 
SELECT * FROM foo WHERE fooid = $1; 
$$ LANGUAGE SQL; 


SELECT * FROM getfoo(1) AS t1; 


将 得 到 : 


fooid | foosubid | fooname 


| 1 | Joe 
i, | 2 | Ed 
(2 rows) 


它 也 有 可 能 返回 输出 参数 定义 的 列 的 多 行 ， 像 这 祥 : 


CREATE TABLE tab (y int, z int); 
INSERT INTO tab VALUES (1, 2), (3, 4), (5, 6), (7, 8); 


CREATE FUNCTION sum_n_product_with_tab (x int, OUT sum int, OUT product int) 
RETURNS SETOF record 
AS $$ 
SELECT $1 + tab.y, $1 * tab.y FROM tab; 
$$ LANGUAGE SQL; 


SELECT * FROM sum_n_product_with_tab(10); 
sum | product 


tal, [| 10 

13 | 30 

15 | 50 

I7 j 70 
(4 rows) 


是 一 行 。 如 果 只 有 


m) 
=| 
> 
i 

| 
| 


这 里 关键 的 一 点 是 你 必须 守 RETURNS SETOF record 表明 函数 返回 多 行 
一 个 输出 参数 ， 写 参 数 类 型 而 不 是 record o 


它 通 过 调用 多 次 设置 返回 范 数 构建 一 个 查询 结果 经 常 是 有 用 的 ， 为 了 每 个 参数 调用 一 个 表 或 
查询 连续 的 行 。 这 样 做 的 最 佳 方 法 是 使 用 LATERAL 关键 字 ， 在 Section 7.2.1.5 中 描述 的 。 这 
里 是 一 个 例子 ， 使 用 设置 返回 本 数 来 枚 举 树 结构 元 素 : 


SELECT * FROM nodes; 


name | parent 
Seis are ene ea a ee 
Top | 
Child1 | Top 
Child2 | Top 
Child3 | Top 


SubChild1 | Child1 
SubChild2 | Child1 
(6 rows) 


CREATE FUNCTION listchildren(text) RETURNS SETOF text AS $$ 
SELECT name FROM nodes WHERE parent = $1 
$$ LANGUAGE SQL STABLE; 


SELECT * FROM listchildren('Top'); 
listchildren 

Child1 

Child2 

Child3 

(3 rows) 


SELECT name, child FROM nodes, LATERAL listchildren(name) AS child; 


name | child 
Sees, E EE A ere 
Top | Child1 
Top | Child2 
Top | Child3 


Child1 | SubChild1 
Child1 | SubChild2 
(5 rows) 


这 个 例子 不 做 任何 事情 ， 我 们 不 能 做 一 个 简单 的 连接 ， 但 在 更 复 条 的 计算 中 ， 选 择 把 一 些 工 
作 放 入 一 个 函数 中 是 很 方便 的 。 


目前 ， 返 回 集合 的 函数 也 可 以 在 一 个 查询 的 选择 列表 里 调用 。 对 于 该 查询 自己 生成 的 每 一 
行 ， 都 会 调用 这 个 返回 集合 的 函数 ， 并 且 对 于 该 函数 的 结果 集中 的 每 个 元 素 都 会 生成 一 个 输 
出 行 。 不 过 ， 这 个 功能 已 经 废弃 了 ， 在 将 来 的 版 本 中 可 能 会 被 删除 。 下 面 就 是 一 个 在 选择 列 
表 中 使 用 返回 集合 的 图 数 的 例子 : 


SELECT listchildren('Top'); 
listchildren 
Child1 
Child2 
Child3 
(3 rows) 


SELECT name, listchildren(name) FROM nodes; 


name | listchildren 
Se er a se Ge a 
Top | Child1 
Top | Child2 
To | Child3 


p 
Child1 | SubChild1 
Child1 | SubChild2 


意 ， 在 最 后 的 SELECT 里 没有 出 现 child2, childs 等 行 。 这 是 因为 listchildren 为 这 些 
参数 返回 一 个 空 集合 ， 因此 不 生成 任何 结果 行 。 当 使 用 LATERAL 语法 时 ， 这 同 从 内 部 链接 到 
PERT HE HEN, 


Note: 如 果 男 数 的 最 后 命 合 是 INSERT, UPDATE , 或 者 带 有 RETURNING AY DELETE, NIMS 
将 总 是 执行 完成 ， 即 使 函数 不 被 声明 为 SETOF 或 者 调用 查询 不 抓 取 所 有 结果 行 。 任何 通 
过 RETURNING 子 句 产生 的 额外 行 静 静 地 被 删除 ， 但 是 仍然 产生 命令 表 修 改 (都 是 从 函数 
返回 前 完成 ) 。 





Note: 在 选择 列表 中 使 用 设置 返回 函数 而 不 是 FRoM 子 句 的 关键 问题 是 将 一 个 以 上 的 设置 

回 函 数 放 在 同一 个 选择 列表 中 是 不 明智 的 。 如 果 你 将 输出 行 数 等 同 于 通过 每 个 设置 返 
SERED EA E 你 实际 得 到 了 什么 。 ABASTREREWAHAE 
往 蔡 代 使 用 的 时 候 ， LATERAL 语法 很 少 产生 合 人 惊讶 的 结果 。 


35.4.9. 返回 TABLE 的 SQL 西数 


还 有 另 一 种 方式 来 声明 返回 集合 的 函数 ， 它 是 利用 语法 RETURNS TABLE(``_columns_ ), 这 相 
当 于 使 用 一 个 或 多 个 ouT 标记 图 数 作为 返回 setor record (或 者 setor 一 个 输出 
参数 的 类 型 ， 视 情况 而 定 ) 。 这 个 符号 是 在 最 近 的 SQL 标准 版 本 中 规定 的 ， 因 此 可 能 比 使 

用 sEToF 更 便捷 。 


比如 ， 前 面 的 和 与 乘积 的 例子 可 以 这 样 做 : 


CREATE FUNCTION sum_n_product_with_tab (x int) 
RETURNS TABLE(sum int, product int) AS $$ 

SELECT $1 + tab.y, $1 * tab.y FROM tab; 
$$ LANGUAGE SQL; 


不 允许 使 用 明确 的 带 有 RETURNS TABLE 标记 的 ouT 或 者 INouT 参数 一 你 必须 将 所 有 输出 参数 
放 在 TABLE 列表 中 。 


35.4.10. 多 态 SQL 酚 数 


SQL 男 数 可 以 声明 为 接受 并 返回 多 态 类 型 anyelement ，anyarray , anynonarray , 
anyenum 和 anyrange 。 参阅 Section 35.2.5 获 取 有 关 多 态 范 数 的 更 多 细节 。 下 面 是 一 个 多 态 
的 函数 make_array, 它 从 两 个 任意 数据 类 型 元 素 中 建立 一 个 数组 : 


CREATE FUNCTION make_array(anyelement, anyelement) RETURNS anyarray AS $$ 
SELECT ARRAY[$1, $2]; 
$$ LANGUAGE SQL; 


SELECT make_array(1, 2) AS intarray, make_array('a'::text, 'b') AS textarray; 


intarray | textarray 
Sige ee ee, es ee ees 


{1,2} | {a,b} 
(1 row) 


请 注意 使 用 了 类 型 转换 'a'::text 声明 参数 是 text 类 型 。 如 果 参 数 只 是 一 个 字符 串 文本 ， 这 
是 必须 的 ， 否则 它 就 会 被 当 作 unknown 类 型 。 因为 unknown 不 是 一 种 有 效 的 类 型 ， 所 以 如 果 
没有 类 型 转换 ， 就 会 看 到 类 似 下 面 这 样 的 错误 信息 : 


<samp class="literal">ERROR: could not determine polymorphic type because input has type 
二 =- 
允许 含有 多 态 参数 的 函数 返回 一 个 固定 类 型 ， 但 是 反 过 来 不 行 。 上 比如 : 





CREATE FUNCTION is_greater(anyelement, anyelement) RETURNS boolean AS $$ 
SELECT $1 > $2; 
$$ LANGUAGE SQL; 


SELECT is_greater(1, 2); 
is_greater 


CREATE FUNCTION invalid_func() RETURNS anyelement AS $$ 
SELECT 1; 
$$ LANGUAGE SQL; 
ERROR: cannot determine result data type 
DETAIL: A function returning a polymorphic type must have at least one polymorphic argum 








多 态 性 也 可 以 用 于 那些 含有 输出 参数 的 画 数 。 上 比如 : 


CREATE FUNCTION dup (f1 anyelement, OUT f2 anyelement, OUT f3 anyarray) 
AS ‘select $1, array[$1,$1]' LANGUAGE SQL; 


SELECT * FROM dup(22); 
f2 | f3 
人 

22 | {22,22} 

(1 row) 


多 态 性 也 可 以 使 用 可 变 参 数 画 数 。 上 比如 : 


CREATE FUNCTION anyleast (VARIADIC anyarray) RETURNS anyelement AS $$ 
SELECT min($1[i]) FROM generate_subscripts($1, 1) g(i); 
$$ LANGUAGE SQL; 


SELECT anyleast(10, -1, 5, 4); 
anyleast 


(1 row) 


SELECT anyleast('abc'::text, 'def'); 
anyleast 


CREATE FUNCTION concat_values(text, VARIADIC anyarray) RETURNS text AS $$ 
SELECT array_to_string($2, $1); 
$$ LANGUAGE SQL; 


SELECT concat_values('|', 1, 4, 2); 
concat_values 


35.4.11. 带 有 排序 规则 的 SQL 函 数 


当 一 个 SQL 画 数 具 有 一 个 或 多 个 collatable 数 据 类 型 的 参数 ， 排序 规则 认同 每 个 函数 调用 依赖 
于 分 配给 实际 参数 的 排序 规则 ， 正 如 Section 22.2 描 述 的 。 如 果 一 个 排序 规则 成 功 地 被 识别 
( 即 不 存在 参数 之 间 的 隐 式 排序 规则 的 冲突 ) 然后 所 有 的 collatable 参 数 作为 含蓄 的 排序 规则 
对 待 。 这 会 影响 酌 数 内 排序 规则 区 分 操 作 行 为 。 例 如 ， 使 用 上 文 描 述 的 anyleast , 结果 为 


SELECT anyleast('abc'::text, 'ABC'); 


将 依赖 于 数据 库 的 缺 省 排序 规则 。 在 c 中 结果 将 是 Agc ， 但 是 在 许多 其 他 区 域 中 它 将 
是 abc 。 使 用 的 排序 规则 通过 添加 coLLATE 子 句 强制 给 任何 参数 ， 比 如 


SELECT anyleast('abc'::text, 'ABC' COLLATE "C"); 


另外 ， 如 果 你 希望 画 数 操作 特定 的 排序 规则 不 管 称 为 什么 ， 作为 需要 插入 coua FARR 
数 定义 中 ， anyleast 的 版 本 可 能 总 是 使 用 enus 区 域 来 比较 字符 串 : 


CREATE FUNCTION anyleast (VARIADIC anyarray) RETURNS anyelement AS $$ 
SELECT min($1[i] COLLATE "en_US") FROM generate_subscripts($1, 1) g(i); 
$$ LANGUAGE SQL; 


但 是 请 注意 如 果 适 用 于 非 -collatable 数 据 类 型 ， 则 将 抛 出 一 个 错误 。 


如 果 在 实际 参数 之 间 没 有 识别 通用 排序 规则 ， 那么 一 个 SQL 画 数 将 其 参数 作为 数据 类 型 的 默 
认 排 序 规则 〈 通 常 是 数据 库 的 黑 认 排序 规则 ， 但 不 同 于 域 类 型 参数 ) 。 


collatable 参 数 操作 可 以 被 认为 是 多 态 的 有 限 形 式 ， 只 适用 于 文本 数据 类 型 。 


35.5. KAER 


多 个 函数 可 以 定义 成 同样 的 SQL 名 字 ， 只 要 它们 接受 的 参数 不 同 。 RAs, BABIN 
载 。 在 执行 一 个 查询 的 时 候 ， 服务 器 会 从 提供 的 参数 类 型 和 个 数 上 判断 应 该 调用 哪个 函数 。 
重 载 也 可 以 用 于 模拟 数目 不 定 (有 上 限 ) 的 参数 。 


在 创建 一 族 重 载 图 数 的 时 人 息 ， 我 们 应 该 小 心 避免 歧义 。 上 比如 ， 对 于 下 面 的 画 数 : 


CREATE FUNCTION test(int, real) RETURNS ... 
CREATE FUNCTION test(smallint, double precision) RETURNS ... 


如 果 给 出 一 些 简单 的 输入 ， 比 如 testa, 1.5), 系统 要 想 判 断 应 该 调用 哪个 函数 可 不 是 一 件 
很 容易 的 事情 。 目前 实现 的 解析 规则 在 Chapter 10 里 描述 ， 但 是 设计 一 个 隐 含 依赖 这 些 行为 
的 系统 是 不 明智 的 。 


一 个 接受 单个 复合 类 型 参数 的 函数 通常 不 应 该 和 该 类 型 或 该 类 型 的 任何 属性 (字段 ) 同 名 。 
attribute(table) 被 认为 等 效 于 table.attribute o 在 这 种 情况 下 ， 一 个 复合 类 型 上 的 函数 
会 和 一 个 复合 类 型 的 属性 有 歧义 (总 是 使 用 属性 )。 我 们 可 以 通过 使 用 模式 来 修饰 图 数 名 (也 就 
是 schema. func(table) ) 以 绕 开 这 个 限制 ， 但 最 好 还 是 通过 使 用 无 冲突 的 名 字 来 避免 这 个 问 


是 。 


另 一 个 可 能 的 冲突 是 可 变 的 和 非 可 变 参 数 之 间 的 函数 关系 。 例如 ， 它 可 以 创 

建 foo(numeric) 和 foo(VARIADIC numeric[]) 。 在 这 种 情况 下 ， 目 前 还 不 清楚 哪 一 个 应 匹配 
提供 一 个 数字 参数 的 调用 ， 如 foo(10.1) 。 规 则 是 函数 早期 出 现在 使 用 的 搜索 路 径 中 ， 或 者 
如 果 两 个 函数 都 在 同样 的 模式 下 ， 非 -可 变 参 数 优 先 。 


在 重 载 C 语 言 函 数 的 时 候 ， 还 有 一 个 额外 的 限制 : 重 载 族 的 每 个 范 数 的 C 名 字 必 须 和 所 有 其 它 
WANCZESTE, 其 它 画 数 包括 内 部 的 和 动态 加 载 的 。 如 果 违 反 这 条 规则 ， 那么 行为 是 不 
可 移植 的 。 你 可 能 会 得 到 一 个 运行 时 的 链接 错误 ， 或 者 是 其 中 一 个 函数 被 调用 (通常 是 内 部 的 
那个 )。 CREATE FUNCTION 命令 可 选 的 as FA 把 SQL 轴 数 名 和 C 源 代码 中 的 函数 名 分 离开 。 
比如 : 


CREATE FUNCTION test(int) RETURNS int 


AS '_filename_', 'test_iarg' 
LANGUAGE C; 
CREATE FUNCTION test(int, int) RETURNS int 
AS '_filename_', 'test_2arg' 
LANGUAGE C; 


Xx BUCHMARRHS TRE RZ. 


35.6. HAD KIEL 


每 个 函数 都 有 一 个 易 失 性 级 别 VOLATILE , STABLE 或 者 IMMUTABLE 。 如 果 CREATE 
FUNCTION 命 令 没 有 明确 声明 范畴 的 话 ， voLATILE 就 是 缺 省 。 易 失 性 范畴 是 给 优化 器 的 一 个 
KF WA ANKE : 


e VOLATILE 可 以 做 任何 事情 ， 包 括 修改 数据 库 。 它 可 以 在 使 用 同样 参数 调用 时 返回 不 同 的 
结果 。 优 化 器 对 这 样 的 函数 不 做 任何 假设 。 一 个 使 用 易 失 函 数 的 查询 在 需要 数据 值 的 时 
候 每 次 都 重新 计算 函数 的 值 。 


。 STABLE 画 数 不 会 修改 数据 库 ， 并 且 保 证 在 同一 个 查询 的 环境 里 给 出 相同 参数 的 情况 下 ， 
会 给 出 相同 的 结果 。 这 个 范畴 允许 优化 器 在 一 个 查询 里 把 多 个 函数 调用 优化 成 一 个 。 特 
别 是 在 索引 扫描 的 条 件 表 达 式 里 面包 含 这 样 的 函数 是 安全 的 。 因为 索引 扫描 只 计算 一 次 
比较 值 ， 而 不 是 每 行 一 次 。 在 索引 扫描 条 件 里 使 用 一 个 voLATILE 辑 数 是 非法 的 。 


e IMMUTABLE 加 数 不 会 修改 数据 库 ， 并 且 保 证 在 任何 情况 下 同样 的 参数 永远 返回 同样 的 结 
果 。 这 个 范畴 人 允许 优化 器 在 查询 调用 男 数 的 时 候 预 先 把 函数 计算 成 一 个 常量 参数 。 比 
如 ， 类似 sELECT ... WHERE x = 2 + 2 的 查询 可 以 简化 成 sELECT ... WHERE x = 4 ， 因 为 
在 加 法 操作 符 下 层 的 函数 是 标记 为 ”IMMUTABLE 的 。 


为 了 最 佳 的 优化 结果 ， 应 该 尽 可 能 使 用 最 严格 的 易 失 性 范畴 标记 你 的 函数 。 


任何 有 副作用 的 函数 都 必须 标记 为 VOLATILE, 这 样 对 它 的 调用 就 不 会 被 优化 。 即 使 一 个 函数 
没有 副作用 ， 但 它 的 数值 可 能 在 一 个 查询 里 改变 ， 那 么 也 必须 标记 为 voLATILE ; 例 
如 random() ， currval() ， timeofday() WAX, 


另 一 个 重要 例子 是 current_timestamp KAURAA sTABLE ， 因为 他 们 的 值 在 一 个 事务 中 没 
有 改变 。 


在 那些 简单 的 规划 后 马上 执行 的 交互 查询 上 ， sTABLE 和 IMMUTABLE 没有 什么 区 别 : MAE 
在 规划 开始 时 执行 还 是 在 查询 开始 时 执行 的 差别 并 不 大 。 但 是 如 果 规划 被 保存 并 且 后 来 被 重 
用 ， 那 差别 可 就 大 了 。 如 果 把 一 个 函数 标记 为 IMMUTABLE 而 它 实际 上 又 不 是 ， 那么 就 会 导致 
在 随后 使 用 其 规划 的 时 候 用 上 一 个 不 完整 的 数值 。 如 果 在 使 用 预先 准 各 好 语句 或 者 使 用 一 种 
缓冲 规划 的 函数 语言 (比如 PL/pgSQL)， 那么 后 果 可 能 很 严重 。 


为 了 编写 SQL 或 在 任何 标准 的 程序 语言 的 函数 ， 还 有 一 个 通过 波动 性 范畴 决定 的 重要 属性 ， 
即 由 SQL 命令 决定 的 任何 数据 变化 能 见 度 正在 调用 函数 。 一 个 voLATILE WSS ENX ENE 
db, STABLE 或 者 IMMUTABLE 酌 数 不 这 样 。 这 种 行为 使 用 MVCC 快 照 行为 实现 (参阅 Chapter 
13) : STABLE 和 IMMUTABLE 图 数 使 用 快照 确立 为 调用 查询 的 开始 ， 而 voLATILE 图 数 每 个 
查询 执行 开始 时 获得 一 个 新 的 快照 。 























Note: 用 C 守 的 本 数 管理 快照 然而 是 他 们 想 要 的 ， 但 是 使 C 国 数 这 样 进行 工作 往往 是 一 个 
好 主意 。 


因为 快照 行为 ， 一 个 只 包含 sELEcT 命令 的 函数 可 以 安全 地 标记 为 STABLE ， 即使 它 所 选择 的 
表 可 能 会 被 其 它 并 发 查询 修改 也 一 样 。 PostgreSQL 将 会 在 执行 STABLE 函数 时 为 调用 它 的 查 
询 建 立 快照 ， 因此 它 在 该 查询 的 生存 期 内 都 会 看 到 一 致 的 数据 库 视 图 。 


同样 的 快照 行为 也 用 于 ImmuTABLE EQS AY secr Pe. 通常 ， 在 一 个 IMMUTABLE WARE 
选择 一 个 数据 库 的 表 是 不 明智 的 ， 因为 如 果 表 的 内 容 改 变 ， 那 么 这 种 不 变性 就 将 改变 。 不 
it, PostgreSQL 并 不 禁止 你 这 样 做 。 


一 个 常见 的 错误 是 把 一 个 回 数 标记 为 IMMUTABLE ， 而 实际 上 这 个 男 数 的 结果 依赖 某 个 配置 参 
数 。 比 如 ， 一 个 操作 时 间 惟 的 函数 可 能 有 依赖 于 TimeZone 设 置 的 结果 。 为 了 安全 考虑 ， 这 
样 的 事 数 应 该 标记 为 STABLE o 


Note: 在 PostgreSQL 之 前 ， 要 求 sTABLE 和 IMMUTABLE 图 数 不 能 修改 数据 库 这 个 约束 并 
未 由 系统 强制 。 版 本 8.0 通过 要 求 这 类 男 数 不 能 包含 sELECT 之 外 的 SQL 命令 来 强制 这 个 
约束 。 不 过 ， 这 么 做 并 不 是 完全 防弹 的 升级 ， 因为 这 样 的 函数 仍然 可 以 调用 那些 可 能 修 
改 数 据 库 的 voLATILE WR, 如 果 你 这 么 做 的 话 将 会 发 现 STABLE 或 者 IMMUTABLE 并 不 
会 觉察 到 被 它 调 用 的 函数 对 数据 库 所 做 的 修改 。 


35.7. oH SHR 


PostgreSQL 人 允许 用 SQL 和 C 之 外 的 语言 书写 用 户 自 定 义 的 函数 。 这 样 的 语言 通常 被 称 为 过 
程 语言 (PLs)。 过 程 语言 函数 不 是 内 建 于 PostgreSQL 里 的 。 它们 是 通过 可 加 载 模块 提供 的 。 
参阅 Chapter 39 和 随后 的 章节 获取 更 多 信息 。 


35.8. ABBA 


内 部 函数 都 是 用 C 窟 的 函数 ， 它 们 已 经 通过 静态 链接 的 方式 财 入 PostgreSQL 服 务 器 进程 中 
To WAEL" RBU" E T RAICA Bam, 它 不 必 与 给 SQL 使 用 的 名 称 相同 。 出 于 
向 下 兼容 考虑 ， 一 个 空 的 范 数 体 也 可 以 被 接受 ， 这 意味 着 C 函数 名 与 SQL KAHHAR. 


通常 ， 所 有 在 服务 器 里 出 现 的 内 部 函数 都 在 数据 库 初 始 化 时 定义 (参阅 Section 17.2), 但 是 用 
户 可 以 用 create Function 为 内 部 图 数 创建 额外 的 别名 。 内 部 函数 在 CREATE FUNCTION 命令 里 
是 带 着 internal 语言 名 声明 的 。 比如 ， 要 给 sqrt MARAT: 


CREATE FUNCTION square_root(double precision) RETURNS double precision 
AS 'dsqrt' 
LANGUAGE internal 
STRICT; 


(大 多 数 内 部 函数 都 应 该 声明 为 "strict) 。 


Note: 并 非 所 有 "预定 义 "的 函数 都 像 上 面 那样 是 "内 部 的 "。 有 些 预 定义 的 函数 是 用 SQL 
EBAY. 


35.9. C-i2 5 WX 


用 户 定义 的 函数 可 以 用 C 写 ( 或 者 是 与 C 兼 容 的 语言 ， 比 如 C++)。 这 样 的 函数 被 编译 进 动态 加 
载 对 象 (共享 库 ) 并 且 由 服务 器 根据 需要 加 载 。 动态 加 载 的 特性 是 , 'C ZENA AAR WR 
间 的 区 别 一 不 过 ， 实际 的 编码 习惯 在 两 者 之 间 实 际 上 是 一 样 的 。 因 此 ， 标准 的 内 部 图 数 库 为 
写 用 户 定义 C 本 数 提供 了 大 量 最 好 的 样 例 。 

目前 对 C 函数 有 两 种 调用 约定 。 新 的 "版 本 -1" 的 调用 约定 是 通过 为 该 图 数 书写 一 
PG_FUNCTION_INFO_V1() 宏 来 标识 的 ， 像 下 面 演示 的 那样 。 缺 少 这 个 宏 表示 一 个 "版 


本 -0") 函 数 。 两 种 风格 里 在 CREATE FUNCTION 二 明 的 都 是 co 现在 老 风 格 的 函数 已 经 废弃 
了 ， 主 要 是 因为 移植 性 原因 和 缺乏 功能 ， 过 出 于 兼容 性 原因 ， 系 统 仍然 支持 它 。 


35.9.1. 动态 加 载 


当 用 户 定义 的 函数 第 一 次 被 服务 器 会 话 调用 时 ， 动态 加 载 器 才 把 可 加 载 对 象 文件 里 的 函数 目 
标 码 加 载 进 内 存 。 因此 ， 用 于 用 户 定义 C BBY cREATE FUNCTION 必须 为 本 数 声明 两 个 信 
A: 可 加 载 对 象 文 件 名 、 在 目标 文件 里 调用 的 C 函数 名 (连接 符号 )。 如 果 没 有 明确 声明 C WH 
数 名 ， 那 么 就 假设 它 与 SAL 函数 名 相同 。 


基于 在 CREATE FUNCTION 命令 中 给 出 的 名 字 ， 下 面 的 算法 用 于 定位 共享 对 象 文件 : 
1， 如 果 名 字 是 一 个 绝对 路 径 ， 则 加 载 给 出 的 文件 。 


2， 如 果 名 字 以 字符 串 $libdir FA, 那么 该 部 分 将 被 PostgreSQL 库 目录 名 代替 ， 该 目录 
是 在 编译 时 确定 的 。 


3. 如 果 名 字 不 包含 目录 部 分 ， 那么 在 配置 参数 dynamic library path. 声明 的 路 径 里 查找 。 
4 如果 没 有 在 路 径 里 找到 该 文件 ， 或 者 它 包 含 一 个 非 绝 对 目录 部 分 ， 那么 动态 加 载 器 就 会 


试图 直接 拿 这 个 名 字 来 加 载 ， 这 样 几乎 可 以 上 表 定 是 要 失败 的 (依靠 当前 工作 目录 是 不 可 靠 
的 )。 
如 果 这 个 顺序 不 管用 ， 那 么 就 给 这 个 名 字 加 上 平台 相关 的 共享 库 文件 扩展 名 ( 通 .so ); 
然后 再 重新 按照 上 面 的 过 程 找 一 通 。 如 果 还 是 失败 ， 那 么 加 载 失 败 。 


建议 使 用 相对 于 $libdir 的 目录 或 者 通过 动态 库 路 笃定 位 共享 库 。 这 样 ， 如 果 新 版 本 安装 在 
一 个 不 同 的 位 置 ， 那 么 就 可 以 简化 版 本 升级 。 slibdir 的 实际 目录 位 置 可 以 
用 pg_config --pkglibdir 命令 找到 。 


运行 PostgreSQL 服 务 器 的 用 户 ID 必须 可 以 通 历 路 径 到 达 想 加 载 的 文件 。 一 个 常见 的 错误 就 
是 把 该 文件 或 者 一 个 高 层 目 录 的 权限 设置 为 postgres 用 户 不 可 读 和 /或 不 能 执行 。 


在 任何 情况 下 ， 在 cREATE FUNCTION 命令 里 给 出 的 文件 名 是 在 系统 表 里 按 照 文本 记录 的 ， 
此 ， 如 果 需 要 再 次 加 载 ， 那 么 会 再 次 运行 这 个 过 程 。 


Note: PostgreSQL 不 会 自动 编译 C PAR ; 在 使 用 CREATE FUNCTION 命令 之 前 你 必须 编译 
它 。 参阅 Section 35.9.6 获 取 更 多 信息 。 





为 了 确保 不 会 错误 加 载 共享 库 文 件 ， 从 PostgreSQL 开始 将 检查 那个 文件 的 "magic block", ix 
允许 服务 器 以 检查 明显 的 不 兼容 性 。 比如 不 同 版 本 PostgreSQL 的 编译 代码 。 magic block 需 
要 被 作为 PostgreSQL 8.2。 为 了 包含 "magic block", 请 在 包含 了 fmgr.h 头 文件 之 后 ， 将 下 
面 的 内 容 写 进 一 个 (也 只 能 是 一 个 ) 模 块 的 源 代码 文件 中 : 

#ifdef PG_MODULE_MAGIC 


PG_MODULE_MAGIC; 
#endif 


如 果 不 打 算 兼 容 8.2 PostgreSQL 之 前 的 版 本 ，  #ifdef 测试 也 可 以 省 略 。 


动态 加 载 对 象 文件 在 首次 使 用 之 后 将 一 直 滞留 在 内 存 中 。 在 同一 个 会 话 中 的 下 一 次 调用 将 只 
需 查 找 符号 表 的 很 小 开销 。 如 果 你 想 强制 重新 加 载 (比如 重新 编译 之 后 )， 可 以 重新 开始 一 个 
新 的 会 话 。 


动态 加 载 文 件 也 可 以 包含 初始 化 画 数 和 结束 画 数 。 如 果 包 含 一 个 名 为 _P6_init RM, BA 
该 图 数 将 在 该 文件 被 加 载 后 立即 执行 ， 该 东 数 不能 接受 任何 参数 并 且 必 须 返 回 void. 如 果 
包含 一 个 名 为 _PG_fini AWM, AA RABE AMBRE AAT, = 同样 ， 该 图 数 不 
能 接受 任何 参数 并 且 必 须 返 回 void 。 需要 注意 的 是 _PG_fini 仅 在 该 文件 即将 被 卸载 前 执行 
而 不 是 在 会 话 结束 的 时 候 执行 。 目前 ， 和 扼 载 被 禁止 并 且 将 不 会 发 生 ， 但 是 这 可 能 在 将 来 改 


35.9.2. ÆA X EAIC E KHA 


要 知道 如 何 写 C 语 言 画 数 ， 就 必须 知道 PostgreSQL 在 内 部 如 何 表 现 基本 数据 类 型 以 及 如 何 传 
入 及 传 出 函数 。 PostgreSQL 内 部 把 基本 类 型 当 作 " 一 块 内 存 " 看 待 。 定义 在 某 种 类 型 上 的 用 户 
定义 函数 实际 上 定义 了 PostgreSQL 对 该 数据 类 型 可 能 的 操作 。 也 就 是 说 ， PostgreSQL 只 是 
从 磁盘 读 取 和 存储 该 数据 类 型 并 使 用 你 定义 的 函数 来 输入 、 处 理 、 输 出 数据 。 


基本 类 型 可 以 有 下 面 三 种 内 部 形态 (格式 ) 之 一 : 
。 传递 数值 ， 定 长 
。 传递 引用 ， 定 长 
。 传递 引用 ， 变 长 


传递 数值 的 类 型 长 度 只 能 是 1, 2, 4 字 节 。 如果 sizeof(patum) 在 你 的 机 器 上 是 8 的 话 ， 那 么 还 
有 8 字 节 。 你 要 仔细 定义 你 的 类 型 ， 确保 它们 在 任何 体系 平台 上 都 是 相同 尺寸 ( 字 节 )。 例 
如 ， long 是 一 个 危险 的 类 型 ， 因为 在 一 些 机 器 上 它 是 4 字 节 而 在 另外 一 些 机 器 上 是 8 字 节 ， 
而 int 在 大 多 数 Unix 机 器 上 都 是 4 字 节 的 。 在 一 个 Unix 机 器 上 的 int4 合理 实现 可 能 是 : 


/* 4-byte integer, passed by value */ 
typedef int int4; 


实际 PostgreSQL C 代 码 调用 此 int32 类 型 ， 因为 它 是 C 中 的 惯例 ， int*`xx 意味 着 X 
bits, 注意 因此 C 类 型 ints 的 大 小 是 1 字 节 。SQL 类 型 ints WEACH int64 。 参 见 Table 
35-1。 


另外 ， 任 何 尺寸 的 定 长 类 型 都 可 以 是 传递 引用 型 。 例 如 ， 下 面 是 一 个 PostgreSQL 类 型 的 实 
现 : 

/* 16-byte structure, passed by reference */ 

typedef struct 


double x, y; 
} Point; 


Rae (se FA $e a E 2 RHE 4+ EPostgreSQLWM E eA EHR. 要 返回 这 样 类 型 的 值 ， 

FA palloc 分 配 正确 数量 的 内 存 ， 填 充 这 些 内 存 ， 然后 返回 一 个 指向 它 的 指针 。 如 果 只 是 想 返 
回 和 输入 参数 类 型 与 数值 都 相同 的 数值 ， 可 以 忽略 额外 的 palloc ， 只 要 返回 指向 输入 数值 的 
指针 就 行 。 

最 后 ， 所 有 变 长 类 型 同样 也 只 能 通过 引用 来 传递 。 所 有 变 长 类 型 必须 以 一 个 4 字 节 的 长 度 域 开 
始 ， 通 过 sev_varsize 设置 ， 没有 直接 设置 这 个 字段 ! 所 有 存储 在 该 类 型 中 的 数据 必须 放 在 
紧 接 着 长 度 域 的 存储 空间 里 。 长 度 域 是 结构 的 全 长 ， 也 就 是 说 ， 包 插 长 度 域 本 身 的 长 度 。 


另外 一 个 重要 的 点 是 避免 数据 类 型 值 中 留 下 未 初始 化 的 位 ; 比如 ， 请 注意 任何 对 齐 填充 字 节 
洽 出 的 雳 可 能 出 现在 结构 体 中 。 没 有 这 些 ， 你 的 数据 类 型 的 逮 辑 上 等 价 常量 可 能 被 规划 器 看 
做 是 不 平等 的 ， 导 致 低 效 (虽然 是 不 正确 的 ) 规划 。 


Warning 


绝对 不 要 修改 一 个 引用 传递 的 输入 值 ， 否 则 很 可 能 破坏 磁盘 上 的 数据 。 因为 指针 很 可 能 
直接 指向 一 个 磁盘 缓冲 区 。 这 条 规则 的 唯一 例外 在 Section 35.10 里 。 


比如 ， 我 们 可 以 用 下 面 的 方法 定义 一 个 text 类 型 : 


typedef struct { 
int32 length; 
char data[1]; 
} text; 


显然 ， 上 面 声明 的 数据 域 长 度 不 足以 存储 任何 可 能 的 字符 串 。 因为 在 C 中 不 可 能 声明 变 长 结 
构 ， 所 以 我 们 倚赖 这 样 的 知识 : C 编 译 器 不 会 对 数组 下 标 进 行 范围 检查 。 只 需要 分 配 足 够 的 
空间 ， 然后 把 数组 当做 已 经 声明 为 合适 长 度 的 变量 访问 。 这 是 一 个 常用 的 技巧 ， 你 可 以 在 许 
多 C 教 科 书 中 读 到 。 


当 义 理 变 长 类 型 时 ， 必 须 仔 细 分 配 正确 的 内 存 数量 并 正确 设置 长 度 域 。 例如 ， 如 果 想 在 一 
个 text 结构 里 存储 40 字 节 ， 我 们 可 能 会 使 用 像 下 面 的 代码 片段 : 


#include "postgres.h" 
char buffer[40]; /* our source data */ 
text *destination = (text *) palloc(VARHDRSZ + 40); 


SET_VARSIZE(destination, VARHDRSZ + 40); 
memcpy(destination->data, buffer, 40); 


VARHDRSZ 等 价 于 sizeof(int32) , 但 是 我 们 认为 用 宏 VARHDRSZ ap e 
型 的 更 好 风格 。 同时 ， 该 长 度 字段 必须 使 用 set_varsize 宏 设置 ， 不 是 简单 的 赋值 。 


Table 35-1 列 出 了 书写 使 用 PostgreSQL 内 置 类 型 的 C 函数 里 需要 知道 的 SQL 类 型 与 C 类 型 
的 对 应 关系 。" 定 义 在 " 列 给 出 了 需要 包含 以 获取 该 类 型 定义 的 头 文件 。 实际 定义 可 能 在 列表 
文件 中 包含 的 不 同文 件 中 。 我 们 建议 用 户 坚 持 定义 的 接口 。 注意 ， 你 应 该 总 是 首先 包 

括 postgres.h ， 因为 它 声 明了 许多 你 需要 的 东西 。 


Table 35-1. 与 内 建 SQL 类 型 等 效 的 C 类 型 


SQL Type C Type Defined In 
abstime AbsoluteTime utils/nabstime.h 
boolean bool postgres.h (可 能 编译 器 内 置 ) 
box BOX* utils/geo_decls.h 
bytea bytea* postgres.h 
"char" char (编译 器 内 置 ) 
character BpChar* postgres.h 
cid CommandId postgres.h 
date DateADT utils/date.h 
smallint ( int2 ) int16 postgres.h 
int2vector int2vector* postgres.h 
integer ( int4 ) int32 postgres.h 
real ( float4 ) float4* postgres.h 
double precision ( floats ) floats* postgres.h 
interval Interval* datatype/timestamp.h 
lseg LSEG* utils/geo_decls.h 
name Name postgres.h 
oid Oid postgres.h 
oidvector oidvector* postgres.h 
path PATH* utils/geo_decls.h 
point POINT* utils/geo_decls.h 
regproc regproc postgres.h 
reltime RelativeTime utils/nabstime.h 
text text* postgres.h 
tid ItemPointer storage/itemptr.h 
time TimeADT utils/date.h 
time with time zone TimeTZADT utils/date.h 
timestamp Timestamp* datatype/timestamp.h 
tinterval TimeInterval utils/nabstime.h 
varchar VarChar* postgres.h 
xid TransactionId postgres.h 


既然 我 们 已 经 讨论 了 基本 类 型 所 有 可 能 的 结构 ， 我 们 便 可 以 用 实际 的 函数 举 一 些 例子 。 


35.9.3. 版 本 -0 调用 约定 


先 提供 现在 已 经 不 提倡 了 的 " 老 风格 "一 因为 比较 容易 返 出 第 一 步 。 在 版 本 -0 方法 中 ， 此 风格 C 
RAIS SN Ae SRA C 风格 声明 ， 但 是 要 小 心 使 用 上 面 显示 的 SQL 数据 类 型 的 C 表现 
形式 。 


下 面 是 一 些 例子 : 


#include "postgres.h" 
#include <string.h> 
#include "utils/geo_decls.h" 


#ifdef PG_MODULE_MAGIC 
PG_MODULE_MAGIC; 
#endif 


/* 传递 数值 */ 


int 
add_one(int arg) 
{ 
return arg + 1; 
} 


/* 传递 引用 ， 定 长 */ 


floats * 
add_one_float8(float8 *arg) 


floats *result = (float8 *) palloc(sizeof(floats) ); 
*result = *arg + 1.0; 


return result; 


} 
Point * 
makepoint(Point *pointx, Point *pointy) 
{ 
Point *new_point = (Point *) palloc(sizeof(Point)); 
new_point->x = pointx->x; 
new_point->y = pointy->y; 
return new_point; 
} 


/* 传递 引用 ， 变 长 */ 


text * 
copytext(text *t) 


Ve 
* VARSIZE 是 结构 以 字 节 计 的 总 长 度 。 
yf 
text *new_t = (text *) palloc(VARSIZE(t)); 
SET_VARSIZE(new_t, VARSIZE(t)); 


ips 
* VARDATA 是 结构 中 一 个 指向 数据 区 的 指针 。 
*/ 


memcpy((void *) VARDATA(new_t), /* destination */ 
(void *) VARDATA(t), /* source */ 
VARSIZE(t) - VARHDRSZ); /* how many bytes */ 
return new_t; 


} 


text * 
concat_text(text *argi, text *arg2) 


{ 


int32 new_text_size = VARSIZE(arg1) + VARSIZE(arg2) - VARHDRSZ; 
text *new_text = (text *) palloc(new_text_size); 


SET_VARSIZE(new_text, new_text_size); 

memcpy (VARDATA(new_text), VARDATA(arg1), VARSIZE(arg1) - VARHDRSZ); 

memcpy (VARDATA(new_text) + (VARSIZE(arg1) - VARHDRSZ), 
VARDATA(arg2), VARSIZE(arg2) - VARHDRSZ); 

return new_text; 


假设 上 面 的 代码 放 在 funcs.c 文件 中 并 且 编 译 成 了 共享 目标 ， 我 们 可 以 用 下 面 的 命令 为 
PostgreSQL X 3x ER: 


CREATE FUNCTION add_one(integer) RETURNS integer 
AS '_DIRECTORY_/funcs', '‘add_one' 
LANGUAGE C STRICT; 

- -注意 : 重 载 了 名 字 为 "add_one" 的 SQL WR 


CREATE FUNCTION add_one(double precision) RETURNS double precision 
AS '_DIRECTORY_/funcs', '‘add_one_floats8' 
LANGUAGE C STRICT; 


CREATE FUNCTION makepoint(point, point) RETURNS point 
AS '_DIRECTORY_/funcs', 'makepoint' 
LANGUAGE C STRICT, 


CREATE FUNCTION copytext(text) RETURNS text 
AS '_DIRECTORY_/funcs', 'copytext' 
LANGUAGE C STRICT; 


CREATE FUNCTION concat_text(text, text) RETURNS text 


AS '_DIRECTORY_/funcs', 'concat_text' 
LANGUAGE C STRICT; 


这 里 的 _pIRECTORY_ 代表 共享 库 文 件 的 目录 ， 比如 包含 本 节 示 例 代 码 的 PostgreSQL 教 程 目 
录 。 更 好 的 风格 应 该 是 将 _DIRECToRY_ 加 到 搜索 路 径 之 后 ， 在 As 子 句 里 只 使 用 'funcs' ， 
不 管 怎样 ， 我 们 都 可 以 省 略 和 系统 相关 的 共享 库 扩 展 ， 通常 是 .so 或 者 .sl 。 


请 注意 我 们 把 函数 声明 为 "strict"( 严 格 )， 意 思 是 说 如 果 任 何 输入 值 为 NULL， 那么 系统 应 该 自 
动 假设 一 个 NULL 的 结果 。 这 样 义理 可 以 让 我 们 避免 在 函数 代码 里 面 检 查 NULL 输 入 。 如 果 不 
这 样 义理， 我 们 就 得 明确 检查 NULL， 比如 为 每 个 传递 引用 的 参数 检查 空 指针 。 对 于 传 值 类 型 
的 参数 ， 我 们 甚至 没有 办 法 检查 ! 


尽管 这 种 老 调用 风格 用 起 来 简单 ， 但 它 却 不 太 容 易 移 植 ; 在 一 些 系统 上 ， 用 这 种 方法 传递 
比 int 小 的 数据 类 型 就 会 磁 到 困难 。 而 且 ， 我 们 没有 很 好 的 返回 NULL 结 果 的 办 法 ， 也 没有 
除了 把 函数 严格 化 以 外 的 处 理 NULL 参 数 的 方法 。 版 本 -1 约定 ， 下 面 要 讲 的 新 方法 则 解决 了 这 


些 问题 。 


35.9.4. 版 本 1 调用 约定 


版 本 -1 调用 约定 使 用 宏 消除 大 多 数 传递 参数 和 结果 的 复杂 性 。 版 本 -1 风格 画 数 的 C 
面 这 样 : 


rill 
K 
ÈK 
并 


Datum funcname(PG_FUNCTION_ARGS ) 


另外 ， 宏 调用 : 


PG_FUNCTION_INFO_V1(funcname) ; 


也 必须 出 现在 同一 个 源 文件 里 (通常 就 可 以 写 在 函数 自身 前 面 )。 对 那些 internal 语言 图 数 而 
言 ， 不 需要 调用 这 个 宏 ， 因为 PostgreSQL 目 前 假设 内 部 孙 数 都 是 版 本 -1。 不 过 ， 对 于 动态 加 
RAHM, 它 是 必须 的 。 


在 版 本 -1 男 数 里 ， 每 个 实际 参数 都 是 用 一 个 对 应 该 参数 的 数据 类 型 的 PG_GETARG_ XXX () 宏 
抓 取 的 ， 用 返回 类 型 的 pc_return_ xxx O 宏 返 回 结果 。 PG6_6ETARG6 XXX () 接受 要 抓 取 的 函 
数 参数 的 编号 (从 0 开始 ) 作 为 其 参数 。 PG_RETURN_ XXX () 接受 实际 要 返回 的 数值 为 自身 的 
参数 。 


下 面 是 和 上 面 一 样 的 玉 数 ， 但 是 使 用 版 本 -1 风格 编写 的 : 


#include "postgres.h" 
#include <string.h> 
#include "fmgr.h" 

#include "utils/geo_decls.h" 


#ifdef PG_MODULE_MAGIC 
PG_MODULE_MAGIC; 

#endif 

/* 传 递 数值 */ 
PG_FUNCTION_INFO_V1(add_one); 


Datum 
add_one(PG_FUNCTION_ARGS) 


{ 
int32 arg = PG_GETARG_INT32(0); 


PG_RETURN_INT32(arg + 1); 
} 


/* 传 递 引用 ， 定 长 */ 


PG_FUNCTION_INFO_V1(add_one_floats) ; 





Datum 
add_one_float8(PG_FUNCTION_ARGS ) 


{ 
/* 用 于 FLOAT8 的 宏 ， 隐 藏 其 传递 引用 的 本 质 。*/ 
float8 arg = PG_GETARG_FLOAT8(0); 


PG_RETURN_FLOAT8(arg + 1.0); 
} 


PG_FUNCTION_INFO_V1(makepoint); 


Datum 
makepoint (PG_FUNCTION_ARGS) 


/* 这 里 ， 我 们 没有 隐藏 Point 的 传递 引用 的 本 质 */ 
Point *pointx = PG_GETARG_POINT_P(0); 
Point *pointy = PG_GETARG_POINT_P(1); 
Point *new_point = (Point *) palloc(sizeof(Point)); 








new_point ->x 
new_point ->y 


pointx->x; 
pointy->y; 


PG_RETURN_POINT_P(new_point); 





} 
/* 传 递 引 用 ， 变 长 */ 
PG_FUNCTION_INFO_V1(copytext); 


Datum 
copytext (PG_FUNCTION_ARGS) 
{ 
text *t = PG_GETARG_TEXT_P(0); 
x 
* VARSIZE 是 结构 以 字 节 计 的 总 长 度 。 
ty 
text *new_t = 
SET_VARSIZE(new_t, 


(text *) palloc(VARSIZE(t)); 
VARSIZE(t)); 


J 


* VARDATA 是 结构 中 指向 数据 区 的 一 个 指针 。 
*/ 


memcpy((void *) VARDATA(new_t), /* 
(void *) VARDATA(t), 
VARSIZE(t) - VARHDRSZ); 





目的 */ 


XR r 
/* 多 少 字 节 */ 


PG_RETURN_TEXT_P(new_t); 





} 
PG_FUNCTION_INFO_V1(concat_text); 


Datum 
concat_text(PG_FUNCTION_ARGS) 
{ 
text *argi = PG_GETARG_TEXT_P(0); 
text *arg2 = PG_GETARG_TEXT_P(1); 
int32 new_text_size = VARSIZE(arg1) + VARSIZE(arg2) - VARHDRSZ; 
text *new_text = (text *) palloc(new_text_size); 


SET_VARSIZE(new_text, new_text_size); 

memcpy (VARDATA(new_text), VARDATA(arg1), VARSIZE(arg1) - VARHDRSZ); 

memcpy (VARDATA(new_text) + (VARSIZE(arg1) - VARHDRSZ), 
VARDATA(arg2), VARSIZE(arg2) - VARHDRSZ); 

PG_RETURN_TEXT_P(new_text); 





用 到 的 cREATE FUNCTION 命令 和 版 本 -0 等 效 命 令 一 样 。 


猛 一 


看 ， 版 本 -1 的 编码 好 像 只 是 无 目的 地 蒙 人 。 fe oe 因为 宏 可 以 隐 
藏 许多 不 必要 的 细节 。 一 个 例子 在 add_one_float8 的 编码 里 ， 这 里 我 们 不 再 需要 不 停 叮 嘱 自 
己 floats 是 传递 引用 类 型 。 另外 一 个 例子 是 用 于 变 长 类 型 的 宏 cetar 隐藏 了 抓 取 "非常 规 " 
(压缩 的 或 者 超 长 的 ) 值 需要 做 的 义理 。 


版 本 -1 的 函数 另 一 个 巨大 的 改进 是 对 NULL 输 入 和 结果 的 处 理 。 宏 PG_ARGISNULL( N ) 允许 一 
个 函数 测试 每 个 输入 是 否 为 NULL， 当然 ， 这 只 是 对 那些 没有 声明 为 "strict" 的 酚 数 有 必要 。 
AURA pc_ceTaRG_ XXX () B, 输入 参数 是 从 需 开 始 计 算 的 。 请 注意 我 们 不 应 该 执 

除非 有 人 声明 了 参数 不 是 NULL。 要 返回 一 个 NULL 结 果 ， 可 以 执行 
这 样 对 严格 的 和 不 严格 的 画 数 都 有 效 。 


{J PG_GETARG_ XXX () ， 


一 个 PG_RETURN_NULL() , 


在 新 风格 的 接口 中 提供 的 其 它 选项 是 PG_GETARG_ XXX () 宏 的 两 个 变种 。 第 一 个 变 

体 PG_GETARG_ XXX _coPY() 保证 返回 一 个 指定 参数 的 副本 ， 该 副本 是 可 以 安全 地 写 入 的 。 普 
通 的 宏 有 时 候 会 返回 一 个 指向 物理 存储 在 表 中 的 某 值 的 指针 ， 因此 我 们 不 能 写 入 该 指针 。 
用 PG_GETARG_ XXX _copY() 宏 保证 获取 一 个 可 写 的 结果 。 第 二 个 变 体 

由 PG_GETARG_ XXX _SLICE() 宏 组 成 ， 它 接受 三 个 参数 。 第 一 个 是 参数 的 个 数 (与 上 同 )。 第 二 
个 和 第 三 个 是 要 返回 的 偏 移 量 和 数据 段 的 长 度 。 偏 移 是 从 老 开 始 计算 的 ， 一 个 负数 的 长 度 则 
要 求 返回 该 值 的 剩余 长 度 的 数据 。 这 些 过 程 提供 了 访问 大 数据 值 的 中 一 部 分 的 更 有 效 方 法 ， 
特别 是 数据 的 存储 类 型 是 "external" 的 时 候 。 一 个 字段 的 存储 类 型 可 以 用 ALTER TABLE 
_tablename ”ALTER COLUMN _colname ”SET STORAGE _storagetype 指定 。 


_storagetype_ 是 plain, external , extended , 或 者 main 之 一 。 











版 本 -1 的 函数 调用 风格 也 倒 我 们 可 能 返回 一 " 套 " 结 果 (Section 35.9.9) 并 且 实现 触发 器 函数 
(Chapter 36) 和 过 程 语言 调用 处 理 器 (Chapter 51)。 版 本 -1 的 代码 也 更 容易 移植 ， 因 为 它 没 
违反 C 标 准 对 函数 调用 协议 的 限制 。 更 多 的 细节 请 参阅 源 程序 中 

的 src/backend/utils/fmgr/README 文件 。 


35.9.5. 书写 代码 


在 转 到 更 深 的 话题 之 前 ， 先 要 讨论 一 些 PostgreSQL C4 SWABS), 虽然 可 以 用 C 以 
外 的 其 它 语 言 书写 用 于 PostgreSQL 的 共享 画 数 ， 但 通常 都 很 麻烦 〈 当 它 可 能 的 时 候 ) ， 
为 其 他 语言 ， 比如 C++, FORTRAN 或 者 Pascal 并 不 遵循 C 的 调用 习惯 。 也 就 是 说 ， 其 它 语 言 
在 函数 之 间 的 传递 参数 和 返回 值 的 方式 不 一 样 。 因此 假设 你 的 C- 编 程 语言 函数 是 用 C 写 的 。 


书写 和 编译 C 图 数 的 基本 规则 如 下 : 


d 使 用 pg_config --includedir-server 找 出 PostgreSQL 服 务 器 的 头 文件 安装 在 你 的 系统 上 
的 (或 者 你 的 用 户 正 在 运行 ) 的 位 置 。 


。 把 你 的 代码 编译 成 可 以 动态 装 入 PostgreSQL 的 库 文件 总 是 需要 一 些 特殊 的 标记 。 参 
阅 Section 35.9.6 获 取 如 何在 你 的 平台 上 做 这 件 事 的 详细 说 明 。 


。 按照 Section 35.9.1 的 指示 为 你 的 共享 库 定义 一 个 "magic block". 


。 当 分 配 内 存 时 ， 用 PostgreSQL 的 palloc 和 pfree WARRE BIC E RJA 
malloc 和 free. 用 palloc 分 配 的 内 存在 每 个 事务 结束 时 会 自动 释放 ， 避 免 了 内 存 泄 
露 。 


e 使 用 memset (或 者 在 第 一 个 位 置 分 配 palloco ) 的 你 的 结构 字 节 总 是 需 。 即使 你 给 结构 
分 配 每 个 字段 ， 可 能 有 对 章 填充 (结构 中 含有 孔 ) 包含 垃圾 值 。 如 果 没 有 这 一 点 ， 很 难 
支持 散 列 索引 和 哈 希 连接 ， 你 必须 只 挑 出 你 的 数据 结构 中 重要 的 位 来 计算 一 个 散 列 。 规 
划 器 有 时 也 依赖 于 通过 位 平等 比较 常数 ， 所 以 如 果 逮 辑 等 效 值 不 是 按 位 平等 ， 则 你 可 能 
得 到 不 良 的 规划 结果 。 


。 大 多 数 的 PostgreSQL 内 部 类 型 定义 在 postgres.h P, 而 函数 管理 器 接口 
( PG_FUNCTION_ARGS 等 等 ) 都 在 fmgr.h 所 以 你 至 少 应 该 包括 这 两 个 文件 。 出 于 移植 性 
RA, 最 好 先 包括 postgres.h 再 包含 其 它 系统 或 者 用 户头 文件 。 包含 postgres.h $A 


动 包含 elog.h 和 palloc.h o 


。 在 目标 文件 里 定义 的 符号 一 定 不 能 相互 冲突 ， 也 不 能 和 定义 在 PostgreSQL 服 务 器 可 执行 
代码 中 的 符号 名 字 冲 突 。 如 果 你 看 到 了 与 此 相关 的 错误 信息 ， 那 么 必须 重 命名 你 的 函数 
或 者 变量 。 


35.9.6. 编译 和 链接 动态 加 载 的 函 效 
能 够 使 用 由 C 写 的 PostgreSQL 扩 展 画 数 之 前 ， 必须 用 一 种 特殊 的 方法 编译 和 链接 它们 ， 
E 准确 地 说 是 需要 创建 一 个 共享 库 。 


如 果 需 要 更 多 信息 ， 那 么 你 应 该 阅读 操作 系统 的 文档 ， 特 别 是 C 编译 器 ( cc ) 和 连接 器 ( 1d ) 
的 文档 。 另 外 ，PostgreSQL 源 代 码 里 包含 几 个 可 以 运行 的 例子 ， 它 们 在 contrib 目录 里 。 不 
at, 如 果 你 依赖 这 些 例子 ， 那 么 你 的 模块 将 依赖 于 PostgreSQL 源 代码 的 可 用 性 。 


创建 共享 库 和 链接 可 执行 文件 类 似 : 首先 把 源 代码 编译 成 目标 文件 ， 然 后 把 目标 文件 链接 起 
来 。 目标 文件 需要 创建 成 位 置 无 关 码 (PIC)， 也 就 是 在 可 执行 程序 加 载 它 们 的 时 候 ， 它们 可 
以 被 放 在 可 执行 程序 内 存 里 的 任何 地 方 (用 于 可 执行 文件 的 目标 文件 通常 不 是 用 这 个 方式 编译 
的 )， 链接 动态 库 的 命令 包含 特殊 标志 ， 和 与 链接 可 执行 文件 的 命令 是 有 区 别 的 (至 少 理论 上 如 
此 ， 不 过 现实 未 必 )。 


在 下 面 的 例子 里 ， 假 设 你 的 源 程序 代码 在 foo.c 文件 里 ， 并 且 我 们 要 创建 foo.so 的 共享 
库 。 中 介 ee foo.o (除非 另外 注 明 )。 虽 然 一 个 共享 库 可 以 包含 多 个 对 象 文 
件 ， 但 是 在 这 里 只 用 


FreeBSD 


创建 PIC 的 编译 器 标志 是 -fpic 。 创 建 共 享 库 的 链接 器 标志 是 -shared 。 


gcc -fpic -c foo.c 
gcc -shared -o foo.so foo.o 


上 面 方法 适用 于 3.0 版 本 的 FreeBSD。 
HP-UX 


创建 PIC 的 编译 器 标志 是 +z 。 如 果 使 用 GCC 则 是 -fpic 。 创 建 共 享 库 的 链接 器 标志 
是 -bp 。 因 此 : 


cc +z -c foo.c 


> 
或 . 
一 . 


gcc -fpic -c foo.c 


然后 : 


ld -b -o foo.sl foo.o 


HP-UX 使 用 .sl 作为 共享 库 扩 展 名 ， 和 其 它 大 部 分 系统 不 同 。 
IRIX 


PIC 是 缺 省 ， 不 需要 使 用 特殊 的 编译 器 选项 。 创 建 共享 库 的 链接 器 标志 是 -shared o 


cc -c foo.c 
ld -shared -o foo.so foo.o 


Linux 


创建 PIC 的 编译 器 标志 是 -fpic 。 在 某 些 平台 上 如 果 -fpic 不 工作 则 必须 使 用 -fpIc 。 BS 
GCC 手册 获取 更 多 信息 。 创 建 共 享 库 的 编译 器 标志 是 -shared 。 一 个 完整 的 例子 看 起 来 像 : 


cc -fpic -c foo.c 
cc -shared -o foo.so foo.o 


Mac OS X 


这 里 是 一 个 例子 。 假 设 开 发 工具 已 经 安装 好 了 。 


cc -c foo.c 
cc -bundle -flat_namespace -undefined suppress -0 foo.so foo.o 


NetBSD 


创建 PIC 的 编译 器 标志 是 -fpic 。 对 于 ELF 系 统 ， 带 -shared 标志 的 编译 命令 用 于 链接 共享 
库 。 在 老 的 非 ELF 系统 里 ， 则 使 用 1d -Bshareable o 


gcc -fpic -c foo.c 
gcc -shared -o foo.so foo.o 


OpenBSD 
创建 PIC 的 编译 器 标志 是 -fpic 。 而 1d -Bshareable 用 于 链接 共享 库 。 


gcc -fpic -c foo.c 
ld -Bshareable -o foo.so foo.o 


Solaris 


用 Sun 编译 器 时 创建 PIC 的 编译 器 标志 是 -KPIc ; 用 GCC 编译 器 时 创建 PIC 的 编译 器 标志 
是 -fpic 。 链接 共享 库 时 两 个 编译 器 都 可 以 用 -6 ， 此 外 GCC 还 可 以 用 -shared 。 


cc -KPIC -c foo.c 
cc -G -o foo.so foo.o 


> 
口 


gcc -fpic -c foo.c 
gcc -G -o foo.so foo.o 


Tru64 UNIX 


PIC 是 缺 省 ， 不 需要 使 用 特殊 的 编译 器 选项 。 带 特殊 选项 的 1d 用 于 链接 : 


cc -c foo.c 
ld -shared -expect_unresolved '*' -o foo.so foo.o 


用 GCC 代 蔡 系统 编译 器 时 的 过 程 是 一 样 的 ; 不 需要 特殊 的 选项 。 
UnixWare 


用 SCO 编译 器 时 创建 PIC 的 编译 器 标志 是 -K PIC ; 用 GCC 编译 器 时 创建 PIC 的 编译 器 标志 
是 -fpic o 链接 共享 库 时 SCO 编译 器 用 -G 而 GCC 使 用 -shared o 


cc -K PIC -c foo.c 
cc -G -o foo.so foo.o 


> 
口 


gcc -fpic -c foo.c 
gcc -shared -0 foo.so foo.o 


Tip: 如 果 你 觉得 这 些 步骤 实在 太 复杂 ， 那 么 你 应 该 考虑 使 用 GNU Libtool， 它 把 平台 的 差 
名 藏 在 了 一 个 统一 的 接口 里 。 


生成 的 共享 库 文件 然后 就 可 以 加 载 到 PostgreSQL 里 面 去 了 。 在 给 CREATE FUNCTION 命令 声明 
文件 名 的 时 候 ， 必须 声明 共享 库 文 件 的 名 字 而 不 是 中 间 目 标 文件 的 名 字 。 请 注意 你 可 以 
在 CREATE FUNCTION 命令 上 忽略 系统 标准 的 共享 库 扩 展 名 (通常 是 .so 或 .sl )， 并 且 出 于 最 
佳 的 兼容 性 考虑 也 应 该 忽略 。 


回头 看 看 Section 35.9.1 获 取 有 关 服 务 器 预期 在 哪里 找到 共享 库 的 信息 。 


35.9.7. 复合 类 型 参数 


合 类 型 不 像 C 结构 那样 有 固定 的 布局 。 复 合 类 型 的 实例 可 能 包含 空 (NULL) 字 段 。 另外 ， 
个 属于 继承 层次 一 部 分 的 复合 类 型 可 色 Aa 它 成 员 有 不 同 的 域 /字段 。 因此 ， 
PostgreSQL 提 供 一 个 过 程 接口 用 于 从 C 中 访问 复合 


假设 为 下 面 查询 写 一 个 加 数 : 


SELECT name, c_overpaid(emp, 1500) AS overpaid 
FROM emp 
WHERE name = 'Bill' OR name = 'Sam'; 


使 用 调用 约定 版 本 0， 可 以 这 样 定义 c_overpaid 


#include "postgres.h" 
#include "executor/executor.h" /* for GetAttributeByName() */ 


#ifdef PG_MODULE_MAGIC 
PG_MODULE_MAGIC; 
#endif 


bool 
c_overpaid(HeapTupleHeader t, /* the current row of emp */ 
int32 limit) 
{ 
bool isnull; 


int32 salary; 


salary = DatumGetInt32(GetAttributeByName(t, "salary", &isnull)); 
if (isnull) 

return false; 
return salary > limit; 


如 果 用 版 本 -1 则 会 写成 下 面 这 样 : 


#include "postgres.h" 
#include "executor/executor.h" /* for GetAttributeByName() */ 


#ifdef PG_MODULE_MAGIC 
PG_MODULE_MAGIC; 
#endif 


PG_FUNCTION_INFO_V1(c_overpaid); 


Datum 
c_overpaid(PG_FUNCTION_ARGS) 


HeapTupleHeader t = PG_GETARG_HEAPTUPLEHEADER(@); 
int32 limit = PG_GETARG_INT32(1); 

bool isnull; 

Datum salary; 


salary = GetAttributeByName(t, "Salary", &isnull); 
if (isnull) 


PG_RETURN_BOOL(false); 
aioe 


/* Alternatively, we might prefer to do PG_RETURN_NULL() for null salary. */ 
=> 


/* 另 外， 可 能 更 希望 将 PG_RETURN_NULL( ) 用 在 nu11 薪 水 上 */ 


PG_RETURN_BOOL(DatumGetInt32(salary) > limit); 


GetAttributeByName 是 PostgreSQL 系 统 函 数 ， 用 来 返回 当前 记录 的 字段 。 它 有 三 个 参数 : 类 

型 为 HeapTupleHeader 的 传人 画 数 的 参数 、 你 想 要 的 字段 名 称 、 一 个 确定 字段 是 否 为 NULL 
的 返回 参数 。 GetAttributeByName 豆 数 返回 一 个 patum 值 ， 你 可 以 用 对 应 

的 DatumGet XXX () 宏 把 它 转换 成 合适 的 数据 类 型 。 请 注意 ， 如 果 设 置 了 NULL 标 志 ， 那 么 

返回 值 是 无 意义 的 ， 在 准备 对 结果 做 任何 处 理 之 前 ， 总 是 要 先 检查 NULL 标 志 。 


还 有 一 个 GetAttributeByNum 用 字段 编号 而 不 是 字段 名 选取 目标 字段 。 


下 面 的 命令 在 SQL 里 声明 c overpaid HM : 


CREATE FUNCTION c_overpaid(emp, integer) RETURNS boolean 
AS '_DIRECTORY_/funcs', 'c_overpaid' 
LANGUAGE C STRICT; 


请 注意 使 用 sTRIcT 后 就 不 需要 检查 输入 参数 是 否 有 NULL。 


35.9.8. 返回 行 (复合 类 型 ) 


要 从 一 个 C 语 言 琅 数 里 返回 一 个 行 或 复合 类 型 的 数值 ， 可 以 使 用 一 个 特殊 的 API， 它 提供 了 许 
多 宏和 男 数 来 消除 大 多 数 制作 复合 数据 类 型 的 复杂 性 。 要 使 用 该 APl， 源 代码 必须 包含 : 


#include "funcapi.h" 


制作 一 个 复合 类 型 数据 值 (也 就 是 一 个 " 行 ") 有 两 种 方法 : 你 可 以 从 一 个 Datum 值 数组 里 制 
作 ， 也 可 以 从 一 个 可 以 传递 给 该 行 的 字段 类 型 的 输入 转换 玫 数 的 C 字符 串 数组 里 制作 。 不 管 
是 哪 种 方式 ， 你 首先 都 需要 为 行 结 构 获 取 或 者 制作 一 个 Tuplepesc 描述 符 。 在 使 用 Datums 
的 时 候 ， 你 给 BlessTupleDesc 传递 这 个 Tuplepesc 然后 为 每 行 调用 heap_form_tuple 。 在 使 
用 C 字 符 串 的 时 候 ， 你 给 TupleDescGetAttInMetadata 传递 TupleDesc ， 然 后 为 每 行 调 

用 BuildTupleFromCStrings o 如 果 是 返回 一 个 行 集合 的 场合 ， 所 有 设置 步骤 都 可 以 在 第 一 次 
调用 该 西数 的 时 候 一 次 性 完成 。 


有 几 个 便利 丽 数 可 以 用 于 设置 所 需要 的 Tuplepesc 。 在 大 多 数 返回 复合 类 型 给 调用 者 的 函数 
里 建议 的 做 法 是 这 样 的 : 


TypeFuncClass get_call_result_type(FunctionCallinfo fcinfo, 
Oid *resultTypeld, 
TupleDesc *resultTupleDesc) 


ee RARAWAA CH fcinfo 传递 给 它 (要 求 使 用 版 本 -1 的 调用 习惯 )。 resultTypeId 可 
以 声明 为 NULL 或 者 接收 画 数 的 结果 类 型 OID 的 局 部 变量 地 址 (指针 )。 resultTupleDesc 应 该 
是 一 个 局 部 的 Tuplepesc 变量 地 址 (指针 )。 检查 结果 是 否 TYPEFUNC_COMPOSITE ; 如 是 ， 
resultTupleDesc 就 已 经 填充 好 需要 的 TupleDesc Tg 如 果 不 是 ， 你 可 以 报告 一 个 类 似 "返回 
记录 的 函数 在 一 个 不 接受 记录 的 环境 中 被 调用 "的 错误 。 


Tip: get_call_result_type 可 以 把 一 个 多 态 的 函数 结果 解析 为 实际 类 型 ; 因此 它 在 返回 
多 态 的 标量 结果 的 函数 里 也 很 有 用 ， 而 不 仅仅 是 返回 复合 类 型 的 函数 里 。 
resultTypeld 输出 主要 用 于 那些 返回 多 态 的 标量 类 型 的 函数 。 








Note: get_call_result_type 有 一 个 同胞 弟兄 get_expr_result_type 可 以 用 于 给 一 个 用 
表达 式 树 表示 的 函数 调用 解析 输出 ， 它 可 以 用 于 视图 从 回 数 本 身 外 边 判 断 结果 类 型 的 场 
Go 还 有 一 个 get_func_result_type 可 以 用 在 只 能 拿 到 函数 OID 的 场合 。 Tit, RER 
数 不 能 处 理 那些 声明 为 返回 record AY EBX, 并 且 get_func_result_type 不 能 解析 多 态 的 
类 型 ， 因此 你 最 好 还 是 使 用 get_call_result_type o 








旧 的 ， 现 在 已 经 废弃 的 获取 Tuplepesc 的 函数 是 : 


TupleDesc RelationNameGetTupleDesc(const char *relname) 


它 可 以 从 一 个 命名 的 关系 里 为 行 类 型 获取 一 个 Tuplepesc ， 还 有 : 


TupleDesc TypeGetTupleDesc(0id typeoid, List *colaliases) 


可 以 基于 类 型 OID 获取 一 个 Tuplepesc 。 它 可 以 用 于 给 一 个 基本 类 型 或 者 一 个 复合 类 型 获 
HX Tuplepesc 。 不 过 它 不 能 义理 返回 record 的 函数 ， 并 且 不 能 解析 多 太 的 类 型 。 


一 旦 你 有 了 一 个 tupledesc ， 那 么 调用 : 


TupleDesc BlessTupleDesc(TupleDesc tupdesc) 


如 果 你 想 使 用 Datum， 或 者 : 


AttInMetadata *TupleDescGetAttInMetadata(TupleDesc tupdesc) 


PRS EAC FHS, MRMRES—MRERANMA, AAA LE HAs Re 
存在 Funccallcontext 结构 里 aes tuple_desc 或 者 attinmeta 字段 )。 


在 使 用 Datum 的 时 候 ， 使 用 : 


HeapTuple heap_form_tuple(TupleDesc tupdesc, Datum *values, bool *isnull) 


制作 一 个 Heaptuple ， 它 把 数据 以 Datum 的 形式 交 给 用 户 。 
当 使 用 C 字 符 串 时 ， 使 用 : 


HeapTuple BuildTupleFromCStrings(AttInMetadata *attinmeta, char **values) 


制作 一 个 HeapTuple , 以 C 字 符 串 的 形式 给 出 用 户 数据 。 values 是 一 个 C 字符 串 的 数组 ， 返 
回 行 的 每 个 字段 对 应 其 中 一 个 。 每 个 C 字符 串 都 应 该 是 字段 数据 类 型 的 输入 范 数 预期 的 形 
式 。 为 了 从 其 中 一 个 字段 中 返回 一 个 NULL， values 数组 中 对 应 的 指针 应 该 设置 为 NULL o 
这 个 事 数 将 会 需要 为 你 返回 的 每 个 行 调用 一 次 。 


一 县 你 制作 了 一 个 从 你 的 范 数 中 返回 的 行 ， 那 么 该 行 必须 转换 成 一 个 datum 。 使 用 : 


HeapTupleGetDatum(HeapTuple tuple) 


把 一 个 HeapTuple 转换 为 一 个 有 效 的 Datum o 如 果 你 想 只 返回 一 行 ， 那 么 这 个 Datum 可 以 用 
于 直接 返回 ， 或 者 是 它 可 以 用 作 在 一 个 返回 集合 的 函数 里 的 当前 返回 值 。 


例子 在 下 面 给 出 。 


35.9.9. 返回 集合 


还 有 一 个 特殊 的 API 用 于 提供 从 C 语 言 画 数 中 返回 集合 (多 行 )。 一 个 返回 集合 的 函数 必须 遵循 
版 本 -1 的 调用 方式 。 同 祥 ， 源 代码 必须 包含 funcapi.h , 就 像 上 面 说 的 那样 。 


回 集合 的 函数 (SRF) 通 常 为 它 返回 的 每 个 项 都 调用 一 次 。 因此 SRF 必 须 保 存 足 够 的 状 
态 用 于 记 住 它 正在 做 的 事情 以 及 在 每 次 调用 的 时 候 返回 下 一 个 项 。 REZ API 提供 
了 FuncCallcontext 结构 用 于 帮助 控制 这 个 过 程 。 fcinfo-&gt;flinfo-&gt;fn_extra 用 于 保存 
一 个 跨越 多 次 调用 的 指向 Funccallcontext 的 指针 。 


typedef struct 


ip 

* 前 面 已 经 被 调用 的 次 数 

* 初始 的 时 候 ，call_cntr 被 SRF_FIRSTCALL_INIT() E% O, 
* 并 且 每 次 你 调用 SRF_RETURN_NEXT() 的 时 候 都 递增 

e 

uint32 call_cntr; 


fe 
* 可 选 的 最 大 调用 数量 
* 这 里 的 max_calls 只 是 为 了 方便 ， 设 置 它 也 是 可 选 的 。 
* 如 果 没 有 设置 ， 你 必须 提供 可 选 的 方法 来 知道 画 数 何 时 结 
A 
uint32 max_calls; 
T* 
* 指向 结果 模 位 的 可 选 指针 
* 这 个 数据 类 型 已 经 过 时 ， 只 用 于 向 下 兼容 。 也 就 是 那些 使 用 已 废弃 的 TupleDescGetSlot( ) 的 用 户 定义 SRF 
7 
TupleTableSlot *slot; 
r 
* 可 选 的 指向 用 户 提供 的 杂项 环境 信息 的 指针 
* user_fctx 用 做 一 个 指向 你 自己 的 结构 的 指针 ， 包 含 任意 提供 给 你 的 函数 的 调用 间 的 环境 信息 
7 
void *user_fctx; 
1 
* 可 选 的 指向 包含 属性 类 型 输入 元 信息 的 结构 数组 的 指针 
* attinmeta 用 于 在 返回 行 的 时 候 (也 就 是 说 返回 复合 数据 类 型 ) 
* 在 只 返回 基本 (也 就 是 标量 ) 数 据 类 型 的 时 候 并 不 需要 。 
* 只 有 在 你 准 各 用 BuildTupleFromcStrings() 创建 返回 行 的 时 候 才 需要 它 。 
7 
AttInMetadata *attinmeta; 
P 
* 用 于 必须 在 多 次 调用 间 存 活 的 结构 的 内 存 环境 
* multi_call_memory_ctx 是 由 SRF_FIRSTCALL_INIT() 为 你 设置 的 ， 并 且 由 SRF_RETURN_DONE() 上 
* 它 是 用 于 存放 任何 需要 跨越 多 次 调用 SRF 之 间 重 复 使 用 的 内 存 。 
Hy) 
MemoryContext multi_call_memory_ctx; 
Ves 


* 可 选 的 指针 ， 指 向 包含 行 描述 的 结构 

* tuple_desc 用 于 返回 行 (也 就 是 说 复合 数据 类 型 ) 并 且 只 是 在 你 想 使 用 heap_form_tuple() 而 不 是 Buil 
* 请 注意 这 里 存储 的 TupleDesc 指针 通常 应 该 先 用 BlessTupleDesc() #8. 

人 

TupleDesc tuple_desc; 


} FuncCallContext; 





一 个 SRF 使 用 自动 操作 Funccalicontext 结构 (可 以 通过 fn_extra 找到 ) 的 若干 个 画 数 和 宏 。 
使 用 : 


SRF_IS_FIRSTCALL() 


来 判断 你 的 画 数 是 第 一 次 调用 还 是 后 继 的 调用 。 只 有 在 第 一 次 调用 的 时 候 ， 使 用 : 


SRF_FIRSTCALL_INIT() 


初始 化 FuncCallContext o TERE ga FA at (GB 次 )， 使 用 : 


SRF_PERCALL_SETUP( ) 


为 使 用 FuncCallcontext 做 恰当 的 ; 受 置 以 及 清理 任何 前 面 的 轮回 里 面 剩 下 的 已 返回 的 数据 。 
如 果 你 的 函数 有 数据 要 返回 ， 使 用 : 


SRF_RETURN_NEXT(funcctx, result) 


返回 给 调用 者 ( result 必须 是 个 Datum ， 要 么 是 单个 值 ， 要 么 是 像 前 面 介 绍 的 那样 准 各 的 
JT) 最 后 ， 如 果 你 的 函数 结束 了 数据 返回 ， 使 用 : 


4 


SRF_RETURN_DONE( funcctx) 


清理 并 结束 SRF。 


A S NG 时 环境 ， 在 调用 之 间 将 会 被 清理 掉 。 这 意味 着 你 不 需 
要 pfree 所 有 你 palloc 的 东西 ; 它 会 自动 消失 的 。 不 过 ， 如 果 你 想 分 配 任何 跨越 调用 存在 
的 数据 结构 ， 那 你 就 需要 把 co era 什么 地 方 。 被 multi_call_memory_ctx 引用 的 环境 适 
合用 于 保存 那些 需要 直到 SRF 结 束 前 都 存活 的 数据 。 在 大 多 数 情况 下 ， 这 意味 着 你 在 第 一 次 
调用 设置 的 时 候 应 该 切换 到 multi_call memory_ctx o 


一 个 完整 的 伪 代 码 例子 看 起 来 像 下 面 这 样 : 


Datum 
my_set_returning_function(PG_FUNCTION_ARGS) 


FuncCallContext *funcctx; 
Datum result; 


if (SRF_IS_FIRSTCALL()) 
{ 


MemoryContext oldcontext; 


funcctx = SRF_FIRSTCALL_INIT(); 

oldcontext = MemoryContextSwitchTo(funcctx->multi_call_memory_ctx); 
/* 这 里 放出 现 一 次 的 设置 代码 : */ 

HARS 

if 返回 复合 _ 

_ 制作 TupleDesc 以 及 可 能 还 有 AttInMetadata_ 

_endif 返回 复合 _ 

_ 用 户 定义 代码 _ 

MemoryContextSwitchTo(oldcontext) ; 


} 

/* 每 次 都 执行 的 设置 代码 在 这 里 出 现 : */ 
_ 用 户 定义 代码 _ 
funcctx = SRF_PERCALL_SETUP(); 
_ 用 户 定义 代码 _ 


/* 这 里 只 是 用 来 测试 是 否 完成 的 一 个 方法 : */ 


if (funcctx->call_cntr < funcctx->max_calls) 





{ 
/* 这 里 想 返回 另外 一 个 条 目 : */ 
FP RB 
获取 结 来 = 
SRF_RETURN_NEXT(funcctx, result); 
} 
else 
{ 
/* 这 里 完成 返回 条 目的 工作 了 ， 只 需要 清理 就 OK 了 : */ 
_ 用 户 代码 _ 
SRF_RETURN_DONE(funcctx ) ; 


一 个 返回 复合 类 型 的 完整 SRF 例 子 看 起 来 像 这 样 : 


PG_FUNCTION_INFO_V1(retcomposite) ; 


Datum 

retcomposite(PG_FUNCTION_ARGS) 

{ 
FuncCallContext *funcctx; 
int call_cntr; 
int max_calls; 
TupleDesc tupdesc; 
AttInMetadata *attinmeta; 


/* ARES RiAABAM RFS */ 
if (SRF_IS_FIRSTCALL()) 
{ 


MemoryContext oldcontext; 


/* 创 建 一 个 图 数 环境 ， 用 于 在 调用 间 保 持 住 */ 


funcctx = SRF_FIRSTCALL_INIT(); 


/* 切换 到 适合 多 次 函数 调用 的 内 存 环境 */ 
oldcontext = MemoryContextSwitchTo(funcctx->multi call memory_ctx); 


/* 要 返回 的 行 总 数 */ 
funcctx->max_calls = PG_GETARG_UINT32(0); 


/* 为 了 结果 类 型 制作 一 个 行 描述 */ 
if (get_call_result_type(fcinfo, NULL, &tupdesc) != TYPEFUNC_COMPOSITE) 
ereport(ERROR, 
(errcode(ERRCODE_FEATURE_NOT_SUPPORTED), 
errmsg("function returning record called in context " 
"that cannot accept type record"))); 


U3 
* 生成 稍 后 从 裸 C 字符 串 生成 行 的 属性 元 数据 
*/ 
attinmeta = TupleDescGetAttInMetadata(tupdesc) ; 
funcctx->attinmeta = attinmeta; 


MemoryContextSwitchTo(oldcontext) ; 


} 

/* SRER ARRAS */ 
funcctx = SRF_PERCALL_SETUP(); 
call_cntr = funcctx->call_cntr; 
max_calls = funcctx->max_calls; 
attinmeta = funcctx->attinmeta; 


if (call cntr < max_calls) /* 在 还 有 需要 发 送 的 东西 时 继续 处 理 */ 


{ 


char **values; 
HeapTuple tuple; 
Datum result; 


ips 
* 准备 一 个 数值 数组 用 于 版 本 的 返回 行 
* 它 应 该 是 一 个 C 字 符 串 数 组 ， 稍 后 可 以 被 合适 的 类 型 输入 画 数 久 理 。 
uff 


values = (char **) palloc(3 * sizeof(char *)) 


values[0] = (char *) palloc(16 * sizeof(char)); 
values[1] = (char *) palloc(16 * sizeof(char)); 
values[2] = (char *) palloc(16 * sizeof(char)); 


snprintf(values[0], 16, "%d", 1 * PG_GETARG_INT32(1)); 
snprintf(values[1], 16, "%d", 2 * PG_GETARG_INT32(1)); 
snprintf(values[2], 16, "%d", 3 * PG_GETARG_INT32(1)); 


/* 制作 一 个 行 */ 
tuple = BuildTupleFromcStrings(attinmeta, values); 


/* 把 行 做 成 datum */ 
result = HeapTupleGetDatum(tuple); 


/* 清理 (这 些 实际 上 并 非 必要 ) */ 
pfree(values[0]); 
pfree(values[1]); 
pfree(values[2]); 
pfree(values); 


SRF_RETURN_NEXT(funcctx, result); 


else /* 在 没有 数据 残留 的 时 候 干 的 事情 */ 


SRF_RETURN_DONE(funcctx ) ; 


在 SQL BRA SAAT DIKE : 


CREATE TYPE __retcomposite AS (f1 integer, f2 integer, f3 integer); 


CREATE OR REPLACE FUNCTION retcomposite(integer, integer) 
RETURNS SETOF __retcomposite 
AS '_filename_', 'retcomposite' 
LANGUAGE C IMMUTABLE STRICT; 


另外 一 个 方法 是 使 用 OUT 参数 : 


CREATE OR REPLACE FUNCTION retcomposite(IN integer, IN integer, 
OUT f1 integer, OUT f2 integer, OUT f3 integer) 
RETURNS SETOF record 
AS '_filename_', 'retcomposite' 
LANGUAGE C IMMUTABLE STRICT; 


请 注意 在 这 个 方法 里 ， 画 数 的 输出 类 型 实际 上 是 匿名 的 record 类 型 。 
参阅 源码 发 布 包 里 的 contrib/tablefunc 获取 更 多 有 关 返 回 集合 的 函数 的 例子 


35.9.10. 多 态 参 数 和 返回 类 型 


C 语言 函数 可 以 声明 为 接受 和 返回 多 态 的 类 型 anyelement ， anyarray ， anynonarray , 

anyenum 和 anyrange 。 参阅 Section 35.2.5 获 取 有 关 多 态 范 数 的 更 详细 解释 。 如 果 画 数 参数 

MERE RPELASSRE, 那么 函数 的 作者 就 无 法 预先 知道 他 将 收 到 的 参数 ， 以 及 需 
返回 的 数据 。 在 fmgr.h 里 有 两 个 过 程 ， 可 以 让 版 本 -1 的 C 函数 知道 它 的 参数 的 确切 数据 类 

型 以 及 它 需 要 返回 的 数据 类 型 。 这 两 个 过 程 叫 get_fn_expr_rettype(FmgrInfo *flinfo) 和 

get_fn_expr_argtype(FmgrInfo *flinfo, int argnum) 。 它们 返回 结果 或 者 参数 的 类 型 OID, 

如 果 这 些 信息 不 可 获取 ， 则 返回 InvalidOid 。 结构 flinfo 通常 是 以 fcinfo-&gt;flinfo 进行 

访问 的 。 参数 argnum 是 以 0 为 基 的 。 get_call_result_type 也 可 以 蔡 

代 get_fn_expr_rettype o 还 有 get_fn_expr_variadic 用 于 找 出 是 否 调用 包含 明确 

的 vARIADIC 关键 字 。 对 于 VARIADIC "any" 汞 数 是 最 有 用 的 ， 正 如 下 面 所 述 。 


比如 ， 假 设想 写 一 个 范 数 接受 任意 类 型 的 一 个 元 素 ， 并 且 返 回 该 类 型 的 一 个 一 维 数组 : 


PG_FUNCTION_INFO_V1(make_array); 
Datum 
make_array(PG_FUNCTION_ARGS) 


ArrayType ‘*result; 


Oid element_type = get_fn_expr_argtype(fcinfo->flinfo, 0); 
Datum element; 

bool isnull; 

int16 typlen; 

bool typbyval; 

char typalign; 

int ndims; 

int dims [MAXDIM]; 

int lbs[MAXDIM]; 


if (!OidIsValid(element_type)) 
elog(ERROR, "could not determine data type of input"); 


/* 获取 提供 的 元 素 ( 要 小 心 其 为 NULL 的 情况 ) */ 
isnull = PG_ARGISNULL(0); 
if (isnull) 
element = (Datum) 0; 


else 
element = PG_GETARG_DATUM(@); 


/* 维 数 是 1 */ 


ndims = 1; 
/* Bids */ 


dims[0] = 1; 
/* 数组 下 界 是 1 */ 


lbs[0] = 1; 
/* 获取 有 关 元 素 类 型 需要 的 信息 */ 

get_typlenbyvalalign(element_type, &typlen, &typbyval, &typalign); 
/* 然后 制作 数组 */ 


result = construct_md_array(&element, &isnull, ndims, dims, lbs, 
element_type, typlen, typbyval, typalign); 


PG_RETURN_ARRAYTYPE_P(result) ; 


下 面 的 命令 用 SQL 声明 make_array AR : 


CREATE FUNCTION make_array(anyelement) RETURNS anyarray 
AS '_DIRECTORY_/funcs', 'make_array' 
LANGUAGE C IMMUTABLE; 


A-TSEMSZAMY, SIGAFCHEEMR : 他 们 可 以 声明 采取 类 型 "any" 的 参数 。 (注意 : 
这 个 类 型 名 称 必 须 是 双 引 号 ， 因为 它 同 时 也 是 一 个 SQL 的 保留 字 ) 。 类 似 于 anyelement 除了 
它 并 不 限制 不 同 "any" 参数 是 相同 类 型 ， 也 没有 帮助 确定 该 函数 的 结果 类 型 。 一 个 C 语 言 的 
画 数 也 可 以 声明 最 后 的 参数 为 varc "any", 这 将 匹配 一 个 或 多 个 任意 类 型 的 实 参 (不 一 
定 是 相同 的 类 型 ) 。 这 些 参 数 不 被 收集 到 一 个 数组 中 如 发 生 正常 的 可 变 参 数 函 数 ; 他 们 会 分 
BARE EIA, pc_narcs() 宏和 上 面 描述 的 方法 必须 被 用 来 确定 实际 参数 数目 以 及 使 


AHDE BY BY, Plat, 2X SSAA P Em SEAR A AEA vARIADIC 关键 字 ， LA 
期 望 画 数 把 数组 元 素 看 作 单 独 的 参数 。 画 数 本 身 必须 实现 想 要 的 操作 ， 使 
用 get_fn_expr_variadic 之 后 检测 实际 参数 被 标记 为 VARIADIC o 


5.9.11. 44 Z 


— ERRIA FAB LA a kl FF JAIR EER 685 化 。 比 如 ， int4mul(n, 1) 可 简化 
An. 为 了 定义 图 数 -特定 优化 ， 写 transform function 并 将 其 OID 放 入 BBWAA pg_proc 项 
的 protransform 字段 中 ， 转换 画 数 必须 有 SQL 签 

名 protransform(internal) RETURNS internal o 参数 ， 其 实 FuncExpr * 是 代表 调用 基 范 LAY 
一 个 虚拟 节点 。 MRR Ah g RELA EBA LM ARA MAB A 可 能 的 具 
体 调 用 其 表示 建立 并 且 返 回 简单 的 表达 式 。 否则 ， 返 回 NuLL 指针 (_ 不 是 _SQL null). 


我 们 不 做 任何 保证 ， PostgreSQL 不 会 调用 这 种 情况 下 的 主要 画 数 以 简化 转换 范 数 。 确保 在 
简化 的 表达 式 以 及 实际 调用 主要 函数 之 间 的 严格 等 价 性 。 

当前 ， 这 个 设施 在 SQL 水 平 上 不 暴露 给 用 户 ， 出 于 安全 考虑 。 因 此 只 有 实践 中 用 于 优化 内 置 
WX, 


35.9.12. 共享 内 存 和 LWLocks 


插件 可 能 保留 LWLocks 并 在 服务 器 启动 时 分 配 共享 内 存 。 插件 的 共享 库 必 须 通 过 指定 
shared_preload libraries 的 方法 预先 加 载 。 


void RequestAddinShmemSpace(int size) 
共享 内 存 可 以 通过 在 _p6_init HAHA. 
LWLocks 通 过 调用 进行 预 留 

void RequestAddinLWLocks(int n) 


来 自 _PG_init o 


为 了 避免 可 能 的 竞争 条 件 ， 当 连接 并 且 初 始 化 共享 内 存 分 配 时 ， 每 个 后 端 应 该 使 用 LWLock 
AddinShmemInitLock , 如 下 所 示 : 


static mystruct *ptr = NULL; 


if (!ptr) 
{ 


bool found; 


LWLockAcquire(AddinShmemInitLock, LW_EXCLUSIVE) ; 
ptr = ShmemInitStruct("my struct name", size, &found); 
if (!found) 
{ 
initialize contents of shmem area; 
acquire any requested LWLocks using: 
ptr->mylockid = LWLockAssign(); 


} 
LWLockRelease(AddinShmemInitLock) ; 


35.9.13. 使 用 C++ 的 可 扩展 性 


尽管 


PostgreSQL 后 端 以 C 写 入 ， 如 果 伴随 这 些 准 则 ， 在 C++ 中 写 入 扩展 是 可 能 的 : 


所 有 被 后 端 访 问 的 函数 必须 提供 到 后 端的 C 接 口 ; 这 些 C 函 数 然 后 调用 C++ 画 数 。 上 比 
如 ， extern c 联系 


使 用 合适 的 存储 单元 分 配方 法 释放 内 存 。 比 如 ， 使 用 palloc() 分 配 大 部 分 后 端 内 存 ， 
此 使 用 pfree() 释放 它 它 。 在 这 种 情况 下 使 用 C++ delete HAM, 


防止 异常 传播 到 C 代 码 ( 使 用 捕获 所 有 extern c 男 数 的 最 高 水 平 上 的 块 ) 。 即使 是 
C++ 代码 没有 明确 地 抛 出 异常 ， 这 是 必要 的 ， 由 于 事件 比如 内 存 不 足 仍然 可 以 抛 出 异 
任何 异常 必须 被 捕获 ， 并 且 将 适当 的 错误 传递 给 C 接 口 。 如 果 可 能 的 话 ， 编 译 C++ 
-fno-exceptions 以 完全 消除 异常 ; 在 这 样 的 案例 中 ， 你 必须 检查 你 的 C++ 代码 的 错误 ， 
比如 检查 通过 new() 返回 的 NULL。 


如 果 从 C++ 代 码 中 调用 后 端 画 数 ， 确 保 C++ 调 用 堆栈 中 只 包含 纯 旧 的 数据 结构 (POD)。 这 
是 必要 的 因为 后 端 错 误 产 生 一 个 遥远 的 longjmp() ， 不 适当 的 展开 与 非 -POD 对 象 的 C++ 
调用 堆栈 。 


总 之 ， 把 C++ 代码 放 在 与 后 端 接口 的 extern c 本 数 之 后 是 最 好 的 ， 并 且 避 免 异常 ， 内 存 以 及 
调用 堆栈 泄露 。 


35.10. 用 户 定 义 聚 集 


在 PostgreSQL 里 的 聚集 是 用 状态 值 和 状态 转换 画 数 表 达 的 。 也 就 是 说 ， 聚 集 操作 使 用 一 个 
随 着 每 个 输入 行 被 处 理 而 变化 的 状态 值 。 要 定义 一 个 新 的 聚集 本 数 ， 就 要 选择 表示 状态 值 的 
数据 类 型 、 状 态 初始 值 、 状 态 转换 画 数 。 该 状态 转换 图 数 只 是 一 个 普通 函数， 也 可 以 用 于 聚 
集 的 环境 之 外 。 还 可 以 声明 一 个 最 终 处 理事 数 ， 用 于 对 付 期 望 的 聚集 结果 不 同 于 需要 保留 在 
状态 值 中 数据 的 情况 。 


因此 ， 除 了 被 聚集 用 户 看 到 的 参数 和 结果 数据 类 型 外 ， 还 有 一 种 内 部 状态 值 数据 类 型 ， 这 种 
类 型 可 能 与 参数 和 结果 类 型 都 不 一 样 。 


如 果 定 义 了 一 个 不 使 用 最 终 义理 范 数 的 聚集 ， 那 么 聚集 就 是 对 每 条 记录 的 字段 值 进行 画 数 计 
算 。 sm ( 求 和 ) 是 这 类 聚集 的 例子 。 它 从 需 开 始 ， 依次 向 "总 和 "状态 值 追加 当前 的 记录 值 。 

比如 ， 如 果 要 把 sun 聚集 用 于 复数 ， 只 需要 该 数据 类 型 的 加 法 函数 就 行 了 。 该 聚集 可 以 这 样 
定义 : 


CREATE AGGREGATE sum (complex) 
sfunc = complex_add, 
stype = complex, 
initcond = '(0,0)' 


Ni 


SELECT sum(a) FROM test_complex; 


(34,53.9) 


ER, LatkKMFBRBR: 有 多 个 名 为 sun AREK, (B8HZPostgreSQLaess Ek 
出 作用 于 complex 列 类 型 的 那个 。 


如 果 不 存在 非 NULL 输入 值 ， 上 面 的 sum 定义 将 返回 需 值 (初始 状态 条 件 )。 要 按照 SQL 标准 
的 要 求 返回 NULL 只 需 忽 略 initcond 段 就 可 以 实现 (这 样 初始 状态 条 件 将 变 为 NULL)。 通常 
这 也 意味 着 sfunc 需要 检查 NULL 状态 条 件 输 入 ， 不 过 对 于 sum, max, min 这 类 的 简单 

聚集 来 说 ， 把 第 一 个 非 空 输入 插入 到 状态 值 里 面 ， 然后 从 第 二 个 非 空 输入 状态 值 开始 使 用 转 
换 画 数 就 足够 了 。 如 果 初 始 条 件 是 NULL 并 且 转 换 画 数 被 标记 为 "strict"( 不 能 对 NULL 输入 调 
FA), PostgreSQL 就 会 自动 处 理 这 些 内 容 。 


AK strict" KBAR He : 当 碰 到 一 个 NULL 输入 的 时 候 ， 前 面 一 个 状态 值 会 
被 保留 下 来 不 做 改动 。 这 样 ， 就 忽略 了 NULL. 如 果 你 希望 对 NULL 输入 进行 其 它 处 理 ， 只 
需要 别 把 你 的 转换 画 数 定义 为 "strict"， 并 在 编写 代码 的 时 候 测试 NULL 并 做 相应 处 理 即 可 。 


avg (平均 ) 是 聚集 更 复杂 一 点 的 例子 。 它 需要 两 个 运行 时 状态 : 输入 的 总 和 以 及 输入 的 数 
量 。 最 终结 果 是 通过 把 两 者 相 除 得 到 的 。 平均 的 典型 实现 是 用 一 个 数组 做 状态 值 。 比 如， 内 
建 的 avg(floats) 实现 是 这 样 的 : 


CREATE AGGREGATE avg (floats) 
( 


sfunc = float8_accum, 
stype = float8[], 
finalfunc = float8_avg, 
initcond = '{0,0,0}' 

); 


( floats_accum 要 求 一 个 三 元 素数 组 ， 而 不 是 两 元 素 ， 因为 它 累积 平方 和 和 输入 的 总 和 和 计 
数 。 这 样 它 就 可 以 在 一 些 除了 avg 之 外 的 聚集 中 使 用 了 。 ) 


聚集 落 数 可 以 使 用 多 态 转 换 男 数 或 者 最 终 处 理 男 数 ， 这 样 ， 同 一 个 事 数 就 可 以 用 于 实现 多 个 
聚集 。 参阅 Section 35.2.5 获 取 多 态 函 数 的 解释 。 再 进一步 ， 聚集 事 数 本 身 可 以 用 多 态 的 基 
本 类 型 和 状态 类 型 来 声明 ， 这 样 就 允许 一 个 聚集 定义 用 于 多 种 输入 数据 类 型 。 下 面 是 一 个 多 
态 聚 集 的 例子 : 


CREATE AGGREGATE array_accum (anyelement) 
( 


sfunc = array_append, 
stype = anyarray, 
initcond = '{}' 


Ne 


这 里 ， 任 意 聚 集 调用 的 实际 状态 类 型 是 和 元 素 输入 类 型 相同 的 数组 类 型 。 聚集 的 特征 是 连接 
所 有 的 输入 到 那个 类 型 的 数组 里 。 CER: 内 建 的 聚集 array_agg 支持 相同 的 功能 ， 并 且 有 
比 这 个 定义 更 好 的 性 能 。) 


下 面 的 例子 使 用 两 个 不 同 实际 数据 类 型 作为 参数 输出 : 


SELECT attrelid::regclass, array_accum(attname) 
FROM pg_attribute 
WHERE attnum > © AND attrelid = 'pg_tablespace'::regclass 
GROUP BY attrelid; 


attrelid | array_accum 
ee ene See epee 区 
pg_tablespace | {spcname, spcowner, spcacl, spcoptions} 
(1 row) 


SELECT attrelid::regclass, array_accum(atttypid: :regtype) 
FROM pg_attribute 
WHERE attnum > 9 AND attrelid = 'pg_tablespace'::regclass 
GROUP BY attrelid; 


attrelid | array_accum 
Se eee i ere core 
pg_tablespace | {name,oid,aclitem[], text[]} 
(1 row) 


一 个 用 C 写 的 函数 可 以 判断 它 是 被 当 作 一 个 聚集 转换 函数 调用 还 是 通过 调 
用 Aggcheckcallcontext 作为 最 终 的 函数 ， 例 如 : 


if (AggCheckCallContext(fcinfo, NULL)) 


检查 这 个 的 一 个 原因 是 ， 在 它 对 于 一 个 转换 图 数 为 真 的 时 人 息 ， 左 边 的 输入 必须 是 一 个 临时 的 
转换 值 ， 因此 可 以 安全 地 现场 修改 ， 而 不 用 分 配 新 的 拷贝 。 参 阅 int8inc() 的 例子 。 (这 是 
辑 数 里 唯一 可 以 修改 输入 的 传递 引用 的 地 方 。 特 别 的 ， 聚集 最 终 的 范 数 不 应 该 在 任何 情况 下 
修改 他 们 的 输入 ， 因为 在 某 些 情况 下 它们 将 在 相同 的 最 终 转 换 值 下 重复 执行 。) 


更 详细 的 信息 请 参考 CREATE AGGREGATER S. 


35.11. 用 户 定 义 类 型 


正如 Section 35.2 所 说 ，PostgreSQL 可 以 扩展 为 支持 新 的 数据 类 型 。 本 节 描 述 如 何 定义 新 的 
基本 类 型 ， So 义 在 SQL 语言 之 下 的 数据 类 型 。 创建 一 个 新 的 基本 类 型 要 求实 
现 函 数 在 低层 语言 (通常 是 C) 的 类 型 上 操作 。 


本 节 的 例 子 可 以 在 源码 发 布 中 src/tutorial 目录 的 complex.sql 和 complex.c 里 找到 。 参见 
同 目 录 下 的 README 文件 获取 关于 如 何 运行 例子 的 指示 。 


一 个 用 户 定义 的 类 型 总 是 有 输入 和 输出 画 数 。 这 些 函 数 决定 该 类 型 如 何在 字符 串 里 出 现 (让 用 
户 输 入 和 输出 给 用 户 ) 以 及 类 型 如 何在 内 存 里 组 织 。 输入 函数 以 一 个 以 空 (nul) 结 尾 的 字符 串 为 
参数 并 且 返 回 该 类 型 的 内 部 (内 存 里 ) 的 表现 形式 。 输出 类 型 以 该 类 型 的 内 部 表现 形式 为 参数 
并 且 返 回 一 个 以 空 (null) 结 尾 的 字符 串 。 eee 我 们 必 
须 提供 额外 的 函数 来 实现 我 们 想 要 对 这 个 类 型 的 操作 。 


假设 要 定义 一 个 complex 类 型 来 表示 复数 。 通 常 ， 选用 下 面 的 C 结构 来 在 内 存 里 表现 复数 : 


typedef struct Complex { 


double X; 
double y; 
} Complex; 


我 们 需要 将 它 变 成 引用 传递 类 型 ， 因 为 它 太 大 ， 不 能 放 在 一 个 单独 的 datum 值 中 。 
对 于 该 类 型 的 外 部 表现 形式 ， 选 择 形 如 (x,y) 的 字符 串 。 


输入 输出 画 数 通常 并 不 难 写 ， 男 数 。 但 是 ， 在 定义 你 的 外 部 (字符 串 ) 表 现形 式 时 ， 
要 注意 你 最 后 必须 为 该 表现 形式 写 一 个 完整 而 且 健壮 的 分 析 器 作为 输入 画 数 。 比 如 : 


PG_FUNCTION_INFO_V1(complex_in); 


Datum 
complex_in(PG_FUNCTION_ARGS) 


char *str = PG_GETARG_CSTRING(@); 
double xe 


y; 
Complex *result; 


if (sscanf(str, " ( %1f , %1f )", &x, &y) != 2) 
ereport (ERROR, 
(errcode(ERRCODE_INVALID_TEXT_REPRESENTATION), 
errmsg("invalid input syntax for complex: \"%s\"" 


str))); 


result = (Complex *) palloc(sizeof(Complex) ); 
result->x = x; 

result->y = y; 

PG_RETURN _ POINTER( result); 


ERRA A fe BAS AK : 


PG_FUNCTION_INFO_V1(complex_out); 


Datum 
complex_out(PG_FUNCTION_ARGS) 


Complex *complex = (Complex *) PG_GETARG_POINTER(0); 
char *result; 


result = (char *) palloc(100); 
snprintf (result, 100, "(%g,%g)", complex->x, complex->y); 
PG_RETURN_CSTRING(result); 


IRA RIBAK Hy A A A HS BE, 如 果 不 这 样 做 就 可 能 在 需要 把 数据 输出 来 再 加 
载 回 去 时 碰 到 很 严重 的 问题 ， 当 涉 及 浮 点 数 时 ， 这 是 非常 普 表 的 问题 。 


另外 ， 一 个 用 户 定 义 类 型 可 以 提供 二 进 制 输入 和 输出 过 程 。 二 进 制 MO 通常 更 快 ， 但 是 没有 
文本 VO 移植 性 好 。 因 为 对 于 文本 1/0 而 言 ， 完 全 由 你 来 定义 外 部 的 二 进 制 形式 。 大 多 数 内 
置 的 数据 类 型 都 尽 可 能 提供 一 个 与 机 器 无 关 的 二 进 制 形式 。 对 于 complex, 将 把 二 进 制 MO 
建立 在 floats 的 基础 上 : 


PG_FUNCTION_INFO_V1(complex_recv); 


Datum 
complex_recv(PG_FUNCTION_ARGS) 


StringInfo buf = (StringInfo) PG_GETARG_POINTER(0); 
Complex *result; 


result = (Complex *) palloc(sizeof(Complex) ); 
result->x = pq_getmsgfloat8(buf); 
result->y = pq_getmsgfloat8(buf); 
PG_RETURN_POINTER(result); 

} 


PG_FUNCTION_INFO_V1(complex_send) ; 


Datum 
complex_send(PG_FUNCTION_ARGS) 


Complex *complex = (Complex *) PG_GETARG_POINTER(0); 
StringInfoData buf; 


pq_begintypsend(&buf ) ; 
pq_sendfloat8(&buf, complex->x); 
pq_sendfloat8(&buf, complex->y); 
PG_RETURN_BYTEA_P(pq_endtypsend(&buf) ); 





BRS VO 函数 并 将 其 编译 为 共享 库 ， 就 可 以 定义 SQL 中 的 complex 类 型 。 我 们 首先 
声明 其 为 shell 类 型 : 


CREATE TYPE complex; 


这 将 作为 一 个 占 位 符 以 允许 在 定义 其 |/O 函数 时 引用 该 类 型 。 现 在 我 们 定义 其 VO WR: 


CREATE FUNCTION complex_in(cstring) 
RETURNS complex 
AS '_filename_' 
LANGUAGE C IMMUTABLE STRICT; 


CREATE FUNCTION complex_out (complex) 
RETURNS cstring 
AS '_filename_' 
LANGUAGE C IMMUTABLE STRICT; 


CREATE FUNCTION complex_recv(internal) 
RETURNS complex 
AS '_filename_' 
LANGUAGE C IMMUTABLE STRICT; 


CREATE FUNCTION complex_send(complex) 
RETURNS bytea 
AS '_filename_' 
LANGUAGE C IMMUTABLE STRICT; 


最 后 ， 可 以 完整 定义 该 数据 类 型 : 


CREATE TYPE complex ( 
internallength = 16, 
input = complex_in, 
output = complex_out, 
receive = complex_recv, 
send = complex_send, 
alignment = double 


当 你 定义 一 种 新 的 基本 类 型 时 ，PostgreSQL 自动 提供 对 该 类 型 的 数组 支持 。 因 为 历史 原因 ， 
数组 类 型 的 类 型 名 是 与 该 类 型 同名 的 字符 串 前 面 加 个 下 划 线 字符 ( _ )。 


一 旦 数据 类 型 存在 ， 就 可 以 声明 额外 的 函数 以 提供 在 该 数据 类 型 上 的 操作 ， 然后 就 可 以 在 这 
Heme FE LER. URES, 还 可 以 创建 操作 符 类 支持 该 数据 类 型 的 索引 。 这 些 将 在 后 
面 的 章节 介绍 。 


如 果 你 的 数据 类 型 的 大 小 是 变化 的 (内 部 形式 )， 那 么 你 应 该 把 它们 标记 为 可 TOAST 的 ( 参 
阅 Section 58.2)。 即使 数据 总 是 太 小 以 至 于 被 压缩 或 存储 在 外 部 你 也 应 该 这 样 做 ， 因 为 
TOAST 可 以 通过 减少 头 开销 在 小 数据 上 节约 空间 。 


要 做 到 这 一 点 ， 该 类 型 的 内 部 形式 必需 遵循 变 长 数据 内 部 形式 的 标准 布局 : 头 四 个 字 节 必需 
是 一 个 从 来 没有 直接 访问 的 char[4] 字段 GHA v1_1len ) 。 你 必须 使 用 SET_vARSIZE() 

来 存储 这 个 字段 里 的 数据 的 长 度 ， 使 用 vARsIzE() 来 取 回 这 个 长 度 。 在 该 类 型 上 操作 的 CH 
数 必须 通过 使 用 pc_petoast_patum 小 心地 解 开 它 们 处理 的 任何 " 烘 烤 " 过 的 数值 (这 些 细节 通常 
都 可 以 通过 定义 类 型 相关 的 ”GETARG_DATATYPE_P 宏 掩盖 )。 最 后 ， 在 使 用 create TYPE 命令 的 
时 候 ， 声 明 内 部 长 度 为 variable 并 且 选 择 恰当 的 存储 选项 。 


如 果 对 齐 是 不 重要 的 (不管 是 只 是 对 于 一 个 特定 的 函数 还 是 因为 数据 类 型 指定 字 节 对 齐 ) FB 
人 么 避免 P6_pEToAST_DATUM 的 一 些 开 销 是 可 能 的 。 你 可 以 使 用 pe_pETOAST_DATUM_PACKED 代替 


(通常 通过 定义 一 个 GETARG_DATATYPE_PP HIB) ， 并 且 使 用 宏 指令 vARSIZE_ANY_EXHDR 
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和 vARDATA_ANY 来 使 用 一 个 潜在 封装 的 数据 。 另外 ， 由 这 些 宏 指 合 返 回 的 数据 是 不 对 齐 的 ， 
即使 数据 类 型 定义 声明 了 一 个 对 齐 。 如 果 对 齐 是 重要 的 ， 那 么 你 必须 通过 正规 


的 PG_DETOAST_pATUM 接口 。 


Note: 旧 代 码 经 常 声明 vilen 为 一 个 int32 字段 而 不 是 char[4] 。 只 要 结构 体 的 定义 
中 其 他 字段 至 少 有 int32 个 队列 的 话 这 么 做 是 可 以 的 。 但 是 当 使 用 一 个 潜在 的 对 齐 数据 
时 ， 使 用 这 样 一 个 结构 体 定义 是 危险 的 ; 编译 器 可 能 把 它 当做 一 个 许可 来 假设 数据 实际 
上 已 经 对 齐 ， 导 致 在 架构 上 的 核心 转 储 严格 对 齐 。 


更 多 细节 请 参阅 CREATE TYPER S. 


35.11. 用 户 定 义 类 型 
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35.12. 用 户 定 义 操作 符 


每 个 操作 符 都 是 对 真正 干 活 的 对 应 函数 的 "语义 修饰 " ; 所 以 你 在 创建 操作 符 之 前 必须 先 创建 
对 应 的 函数 。 不 过 ， 一 个 操作 符 也 并 不 仅仅 是 语义 修饰 ， 因 为 它 还 带 着 可 以 帮助 查询 规划 器 
优化 碍 询 使 用 沪 操 作 符 的 附加 信息 。 下 一 节 将 用 于 解释 这 些 附 加 信息 。 


PostgreSQL 支 持 左 目 、 右 目 、 双 目 操作 符 。 操 作 符 可 以 重 载 ; 也 就 是 说 ， 同 一 个 操作 符 名 可 
以 用 于 不 同 数目 和 类 型 的 操作 数 的 操作 符 。 在 执行 一 个 查询 的 时 候 ， 系统 从 提供 的 操作 数 的 
数量 和 类 型 上 判断 需要 调用 哪个 操作 符 。 


下 面 是 一 个 创建 用 于 两 个 复数 相 加 的 操作 符 的 例子 。 假 设 已 经 创建 了 complex ( 见 节 Section 
35.11) 类 型 的 定义 。 首 先 需要 做 相 加 工作 的 函数 ; 然后 就 可 以 定义 操作 符 : 


CREATE FUNCTION complex_add(complex, complex) 
RETURNS complex 
AS '_filename_', 'complex_add' 
LANGUAGE C IMMUTABLE STRICT; 


CREATE OPERATOR + ( 
leftarg = complex, 
rightarg = complex, 
procedure = complex_add, 
commutator = + 


现在 可 以 执行 像 下 面 这 样 的 查询 : 
SELECT (a + b) AS c FROM test_complex; 


(5.2,6.05) 
(133.42,144.95) 


在 这 里 已 经 演示 了 如 何 创建 双 目 操作 符 。 要 创建 单 目 操作 符 ， 只 需要 省 略 leftarg 或 

者 rightarg 只 有 procedure 子 句 和 参数 (argument) 子 句 是 CREATE OPERATOR 里 需要 的 
条 目 。 例 子 里 演示 的 commutator 子 句 是 一 个 给 查询 优化 器 的 可 选 暗 示 。 关 于 commutator 和 
其 它 优化 器 提示 的 详细 信息 在 下 节 给 出 。 


35.13. 操作 符 优 化 信息 


PostgreSQL 的 操作 符 定 义 可 以 包括 几 个 可 选 的 子 句 ， 这 些 子 句 告诉 系统 一 些 关 于 该 操作 符 特 
性 的 有 用 信息 。 在 可 能 的 情况 下 ， 都 应 该 提供 这 些 子 句 ， 因为 它们 可 能 为 使 用 这 个 操作 符 的 
查询 带 来 可 观 的 速度 提升 。 不 过 要 注意 如 果 你 声明 了 这 些 子 句 ， 就 必须 确保 它们 是 正确 的 ! 
对 优化 子 句 的 错误 使 用 将 导致 减 慢 查询 速度 、 微 小 的 输出 错误 、 或 者 其 它 糟糕 事情 。 如 果 你 
对 这 些 事情 不 确定 的 话 ， 可 以 总 是 忽略 优化 子 句 ; 唯一 的 后 果 就 是 查询 可 能 运行 的 慢 一 些 。 


附加 的 优化 子 句 可 能 在 今后 的 PostgreSQL 版 本 里 增加 。 这 里 描述 的 都 是 9.3.1 版 本 可 以 理解 
的 。 


35.13.1. COMMUTATOR 


如 果 提 供 了 commutator 子 句 ， 则 命名 一 个 操作 符 是 被 定义 的 操作 符 的 交换 符 。 如 果 有 两 个 操 
作 符 A, B ， 对 于 任何 可 能 的 输入 数值 x, y 都 有 (x A y) 等 于 (y Bx), 那么 就 说 人 是 B 的 交换 
符 ， 同 样 B 也 是 A 的 交换 符 。 例 如 ， 操 作 符 ait; 和 egt; 对 于 所 使 用 的 一 定 的 数据 类 型 通 
常 都 是 对 方 的 交换 符 ， 而 操作 符 + 通常 是 它 自身 的 交换 符 。 但 是 操作 符 - 通常 没有 交换 
符 。 


交换 操作 符 的 左 操作 数 与 右 操作 数 类 型 必须 相同 。 所 以 PostgreSQL 所 需要 的 只 是 一 个 交换 符 
操作 符 的 名 称 用 以 查找 该 交换 符 ， 那 也 是 commuTATOR 子 句 里 所 需要 的 了 唯一 的 东西 。 


给 那些 会 在 索引 和 连接 子 句 里 面 使 用 的 操作 符 提供 交换 符 是 非常 关键 的 ， 因为 这 样 就 允许 查 
询 优化 器 "移动 "这 样 的 子 句 ， 形 成 所 需要 的 不 同 的 规划 类 型 的 形式 。 上 比如， 考虑 一 个 有 类 

似 tab1.x = tab2.y BY WHERE 子 句 的 查询 ， 这 里 tabi.x 和 tab2.y 是 用 户 定义 类 型 ， 并 且 
假设 tab2.y 上 面 有 索引 。 除非 优化 器 知道 如 何在 tab2.y = tab1.x 周围 四 义 移动 该 子 句 ， 否 
则 它 不 能 生成 索引 扫描 ， 因为 索引 扫描 机 制 期 望 看 到 索引 字段 在 给 出 的 操作 符 左 边 。 
PostgreSQL 不 会 简单 地 假设 这 是 一 个 合法 的 转换 ， = 的 创建 者 必须 声明 这 是 有 效 的 ， 方法 
是 给 这 个 操作 符 标记 交换 器 信息 。 


当 你 定义 一 个 自 交 换 的 操作 符 时 ， 你 简单 的 定义 它 就 可 以 了 。 当 你 定义 一 对 交换 符 操 作 符 
at, RAMA- MF : 怎样 定义 一 个 操作 符 的 交换 符 指向 另 一 个 你 还 没有 定义 的 操作 符 呢 ? 
对 这 个 问题 有 两 个 解决 方法 : 


。 一 个 方法 是 省 略 你 定义 的 第 一 个 操作 符 的 commutator 子 句 ， 然 后 在 第 二 个 操作 符 的 定义 
里 提供 一 个 。 因为 PostgreSQL 知 道 交 换 操 作 符 是 成 对 出 现 的 ， 所 以 当 它 看 到 第 二 个 定 
义 时 它 会 自动 折 回 并 填充 第 一 个 定义 里 空缺 的 coMMuTATOR 子 句 。 


。 另 一 个 更 直接 的 方法 是 在 两 个 定义 里 面 都 包含 comMUTATOR 子 句 。 当 PostgreSQL 义理 第 
一 个 定义 并 意识 到 commutator 指向 一 个 不 存在 的 操作 符 时 会 在 系统 表 里 为 该 操作 符 记 录 
一 个 虚拟 记录 。 这 个 虚拟 的 记录 只 有 操作 符 名 ， 左 和 右 操作 数 类 型 以 及 结果 类 型 是 有 效 


的 ， 因 为 这 些 是 到 目前 为 止 PostgreSQL 可 以 推导 出 来 的 东西 。 第 一 个 操作 符 类 记录 将 和 
这 个 虚拟 记录 连接 。 稍 后 ， 当 你 定义 第 二 个 操作 符 时 ， 系 统 将 用 来 自 第 二 个 操作 符 的 信 
息 更 新 该 虚拟 记录 。 如 果 你 试图 在 虚拟 操作 符 被 填充 之 前 使 用 它 ， 你 将 只 能 收 到 一 条 错 


误 信 息 o 


35.13.2. NEGATOR 


如 果 提 供 了 necator 子 句 ， 则 命名 一 个 操作 符 是 被 定义 的 操作 符 的 否定 符 。 如 果 有 两 个 都 返 
回 布尔 变量 的 操作 符 A 和 B ， 对 任何 可 能 的 输入 x 和 Yy， 都 有 (x Ay) 等 于 NOT(xBy)， 那 
么 说 人 是 B 的 否定 符 。 当 然 B 也 是 A 的 否定 符 。 例 如 ， ait; 和 &gt;= 对 大 多 数 数据 类 型 是 
一 对 否定 符 。 一 个 操作 符 不 可 能 是 它 自身 的 否定 符 。 


不 像 交 换 符 ， 一 对 单 目 操作 符 可 以 互 为 否定 符 ; 那 就 意味 着 对 于 所 有 的 x 都 有 (Ax) 等 于 
NOT(B x), 或 者 类 似 的 右 目 操作 符 的 这 种 情况 。 


一 个 操作 符 的 否定 符 必 须 有 与 正定 义 的 操作 符 本 身 一 样 的 左 和 /或 右 操作 数 类 型 ， 所 以 就 

像 commutator 一 样 ， 只 有 操作 符 名 需要 在 NEGATOR 子 句 里 面 给 出 。 

提供 否定 符 对 查询 优化 器 是 非常 有 帮助 的 ， 因 为 这 样 就 允许 像 NoT (x = y) 这 样 的 表达 式 简 
化 成 x alt;agt; y 。 这 样 的 情况 比 你 想像 的 要 频繁 的 多 ， 因为 nor 操作 可 能 因为 其 它 的 重 排 
列 而 被 引入 。 


否定 符 对 可 以 用 上 面 交 换 符 对 中 解释 的 相同 的 方法 来 定义 。 


35.13.3. RESTRICT 


如 果 提 供 了 restrict $A, mi AREA MA—Thit tt Ral R RA O BST 
名 ， 而 不 是 一 个 操作 符 名 )。 RESTRICT 子 句 只 是 对 返回 boolean 变量 的 双 目 操作 符 有 意义 。 
选择 性 限制 计算 符 的 概念 是 猜测 一 个 表 中 所 有 行 的 哪 一 部 分 对 于 目前 的 操作 符 和 特定 的 常量 
将 满足 一 个 像 下 面 这 样 形式 的 whERE 条 件 子 句 。 


column OP constant 
它 可 以 给 出 这 种 类 型 的 whERE 子 句 可 以 删除 多 少 行 的 一 个 概念 ， 这 将 帮助 优化 器 进行 优化 。 
你 可 能 会 说 ， 如 果 该 常量 (constant) 在 左边 怎么 办 ? 哦 ， 那 是 commutator FAH... 


书写 新 的 选择 性 限制 计算 函数 远 远 超 出 了 本 章 的 范围 ， 不 过 很 幸运 的 是 ， 通常 你 对 自己 的 操 
作 符 只 需要 使 用 系统 标准 的 计算 器 之 一 就 行 了 。 下 面 是 一 些 标准 限制 计算 器 : 


eqsel 用 于 = 
neqsel 用 于 &1t;&gt; 
scalarltsel 用 于 Call 或 Ct 


scalargtsel 用 于 &gt; 或 &gt;= 


这 些 都 是 分 类 ， 看 起 来 有 点 奇怪 ， 不 过 如 果 你 仔细 想 想 ， 就 会 觉得 有 道理 。 = 大 多 将 只 接受 
表 中 的 一 小 部 分 行 ; <> 大 多 将 拒绝 一 小 部 分 行 。 < 接受 的 行 取决 于 给 出 的 常量 落 在 表 的 该 
列 数 据 值 的 哪 一 个 范围 里 (该 值 碰巧 是 ANALYzE 收集 并 且 提 供给 选择 性 计算 器 的 信息 )。 <= 在 
同样 的 常量 时 会 接受 比 < 略微 大 一 些 的 行 ， 不 过 它们 也 非常 接近 ， 几乎 不 值得 区 别 开 来 ， 尤 
其 是 无 论 如 何 也 比 做 言 猜 好 得 多 。 类 似 的 情况 也 适用 于 > 和 >= 。 


你 可 能 常 习 惯 于 把 eqsel 或 neqsel 用 于 那些 非常 高 或 者 非常 低 选择 性 的 操作 符 ， 即使 它们 
并 非 真 正 相 等 或 者 不 相等 。 例 如 ， 基 于 只 会 匹配 整个 表 中 一 小 部 分 记录 的 假设 ， 几 何 操作 符 
约 等 于 就 使 用 eqsel 。 


你 可 以 把 scalarltsel 和 scalargtsel 用 于 上 比较 那些 为 进行 范围 比较 被 转化 为 数字 尺度 后 有 
明显 意义 的 数据 类 型 。 如 果 可 能 ， 把 该 数据 类 型 增加 到 可 以 

被 src/backend/utils/adt/selfuncs.c 文件 里 的 convert_to_scalar() PANES RAY EB 最 
终 ， 这 个 过 程 将 被 放 到 由 pg_type 表 里 的 一 个 列 标识 的 每 种 类 型 一 个 的 落 数 代替 ， 不 过 目前 
还 没有 这 么 做 。 如 果 你 没有 做 这 些 ， 系 统 仍 然 能 工作 ， 不 过 优化 器 的 估计 不 会 像 想 像 的 那么 
好 。 


在 src/backend/utils/adt/geo_selfuncs.c 里 还 有 为 几何 操作 符 设计 的 额外 选择 性 评估 辑 数 : 
areasel , positionsel , contsel 。 目 前 ， 它们 都 只 是 存根 ， 但 是 你 还 是 可 以 使 用 (最 后 是 改 
良 ) 它 们 。 


35.13.4. JOIN 


如 果 提 供 了 JoIN 子 句 ， 则 为 操作 符 命名 一 个 连接 选择 性 计算 器 男 数 (是 画 数 名 ， 不 是 操作 符 
Z) Jom 子 句 只 是 对 返回 boolean 的 双 目 操作 符 有 意义 。 一 个 连接 选择 性 计算 器 后 面 的 概 
念 是 猜测 一 对 表 上 的 哪 部 分 行 对 目前 的 操作 符 将 满足 下 面 形 式 的 whERE 子 句 的 条 件 : 


table1.columni OP table2.column2 
和 Restrict 子 名 一样， 这 些 很 有 可 能 帮助 优化 器 用 最 少 的 义理 勾画 出 要 采取 可 能 的 连接 顺序 
中 的 哪 一 个 。 


和 前 面 一 样 ， 本 节 不 会 试图 解释 如 何 书写 一 个 连接 选择 性 计算 器 图 数 ， 但 是 会 建议 你 尽 可 能 
使 用 一 个 标准 的 计算 器 : 


| eqjoinsel 用 于 = | | neqjoinsel 用 于 &1t;&gt; | | scalarltjoinsel 用 于 &lt; 或 
&lt;= || scalargtjoinsel 用 于 &gt; 或 agt;= || areajoinsel 用 于 基于 面积 的 二 维 比较 
|| positionjoinsel 用 于 基于 位 置 的 二 维 比较 || contjoinsel 用 于 基于 包含 的 二 维 比 较 | 


35.13.5. HASHES 


如 果 出 现 了 HASHES 子 句 ， 则 告诉 系统 对 于 一 个 基于 此 操作 符 的 连接 可 以 使 用 Hash 连接 。 
HASHES 只 对 返回 boolean 的 双 目 操作 符 有 意义 ， 并 且 实 际 上 该 操作 符 最 好 是 对 某 种 数据 类 型 
的 相等 操作 符 。 


Hash 连接 的 假设 是 : 对 于 一 对 散 列 到 同样 的 Hash 代码 的 左 和 右 操作 数值 ， 该 连接 操作 符 只 
能 返回 真 。 如 果 两 个 值 被 放 到 不 同 的 Hash 桶 里 ， 连 接 将 根本 不 比较 它们 ， 隐 含 地 意味 着 连 
接 操作 符 的 结果 一 定 是 假 。 所 以 对 于 不 代表 相等 的 操作 符 ， 声 明 HAsHEs 是 没有 意义 的 。 在 
大 多 数 情况 下 ， 支 持 两 端 接受 同样 数据 类 型 的 操作 符 是 唯一 可 行 的 。 然 而 ， 有 时 为 两 个 或 更 
多 的 数据 类 型 设计 兼容 的 hash 函 数 也 是 可 能 的 ; 也 就 是 ， 函 数 将 为 "相等 的 " 值 产 生 相同 的 
hash 代 码 ， 即 使 值 有 不 同 的 代表 。 例 如 ， 当 哈 希 整数 有 不 容 的 宽度 时 ， 排 列 这 个 属性 是 非常 
简单 。 

要 标记 为 HASHES ， 连 接 操作 符 必须 出 现在 一 个 Hash 索引 操作 符 类 中 。 在 创建 操作 符 时 并 不 
强制 这 样 ， 因 为 引用 操作 符 类 不 可 能 还 存在 。 但 是 企图 在 Hash 连接 中 使 用 尚 不 存在 的 操作 
符 类 将 在 运行 时 导致 失败 。 系统 需要 操作 符 类 根据 操作 符 的 输入 数据 类 型 确定 特定 于 该 数据 
类 型 的 Hash 画 数 。 当 然 ， 你 必须 在 创建 操作 符 类 之 前 首先 提供 合适 的 Hash AX. 


在 编写 Hash 豆 数 时 必须 小 心 ， 因 为 有 一 些 硬件 相关 的 因素 会 导致 错误 。 上 比如 ， 如 果 你 的 数 
据 类 型 是 一 个 存在 间隙 的 结构 体 ， 你 就 不 能 简单 的 将 其 传递 给 某 个 hash_any PSK. BRIEM 
其 它 操作 符 能 够 确保 这 些 间隙 总 是 雳 (这 是 建议 的 策略 )。 另 一 个 例子 是 在 符合 IEEE 浮 点 标准 
的 机 器 上 ， 负 需 和 正 雳 是 不 同 的 值 (不 同 的 位 模式 )， 但 是 它们 被 定义 为 比较 相等 。 如 果 一 个 
浮 点 值 可 能 包含 负 需 ， 那么 必须 使 用 领 外 的 步骤 来 确保 产生 和 正 需 相同 的 Hash 值 。 


一 个 可 Hash 连接 的 操作 符 必须 有 一 个 在 相同 操作 符 类 中 的 交换 符 (如 果 两 个 操作 符 数据 类 型 
相同 则 是 它 本 身 ， 如 果 不 同 则 是 一 个 相关 的 相等 操作 符 ) 。 如 果 不 是 这 样 ， 当 使 用 操作 符 时 
会 发 生 规划 器 错误 。 同 样 ， 一 个 hash 操 作 符 类 支持 多 种 数据 类 型 以 为 数据 类 型 的 每 种 结合 提 
供 相等 操作 符 是 一 个 好 主意 (但 不 是 严格 要 求 ) ; 这 人 允许 更 好 的 优化 。 


Note: 在 一 个 可 Hash 连接 的 操作 符 下 层 的 函数 必须 标明 immutable 或 stable, MUR 
是 volatile ， 那么 系统 将 从 不 在 Hash 连接 中 使 用 这 些 操作 符 。 


Note: 如 果 一 个 可 Hash 连接 的 操作 符 有 一 个 下 层 画 数 标记 为 严格 的 (strict)， 那 么 该 函数 
必须 完整 : 也 就 是 说 ， 对 于 任何 非 NULL 输入 ， 它 应 该 返回 TRUE 或 FALSE ， 但 绝 不 
能 是 NULL. 如 果 不 遵循 这 个 规则 ， IN 操作 的 Hash 优化 可 能 会 生成 错误 的 结果 。 特 
别 是 根据 规范 正确 答案 是 NULL 的 时 候 ， IN 可 能 会 返回 FALSE ; 或 者 它 可 能 生成 一 个 
错误 ， 抱 怨 说 它 对 NULL 结果 没有 思想 准备 。 

















35.13.6. MERGES 


如 果 出 现 了 meres 子 句 ， 则 告诉 系统 对 基于 目前 操作 符 的 连接 可 以 使 用 融合 连接 方法 。 
MERGES 只 是 对 返回 boolean 的 双 目 操作 符 有 意义 ， 实际 上 这 个 操作 符 对 于 某 些 数据 类 型 或 者 
某 对 数据 类 型 必须 表示 相等 。 


融合 连接 是 以 这 样 的 概念 为 基础 的 : 对 左边 和 右边 的 表 进 行 排序 ， 然 后 并 发 地 扫描 它们 。 所 
以 ， 两 种 数据 类 型 都 必须 是 能 够 完全 排序 的 ， 并 且 连 接 操作 符 必 须 只 对 那些 落 在 排序 顺序 中 
的 " 某 个 位 置 "的 数值 对 成 功 。 实 际 上 这 意味 着 连接 操作 符 必须 表现 得 像 等 于 。 但 是 可 以 对 两 
种 不 同 数据 类 型 进行 融合 连接 (只 要 他 们 逻辑 相等 即 可 )。 例如 ， smallint 对 integer 的 相等 
操作 符 是 可 以 用 融合 连接 的 。 只 需要 可 以 把 两 种 数据 类 型 排列 成 逻辑 可 比 序列 的 排序 操作 符 
即 可 。 


要 标记 为 MERGES ， 连 接 操作 符 必须 作为 btree 索引 操作 符 类 的 一 个 相等 的 成 员 出 现 。 在 创 

建 操作 符 时 并 不 强制 这 么 做 ， 因 为 引用 操作 符 类 不 可 能 还 存在 。 但 是 操作 符 不 会 被 实际 用 于 
融合 连接 ， 除 非 可 以 找到 一 个 匹配 操作 符 类 。 MERGES 标志 因此 作为 一 个 对 规划 器 的 提示 ， 查 
找 一 个 匹配 的 操作 符 类 是 值得 的 。 


可 融合 连接 的 相等 操作 符 必 须 有 一 个 在 同一 个 操作 符 类 中 的 交换 符 (如 果 两 个 操作 数 数据 类 
型 相同 则 是 它 自身 ， 如 果 不 同 则 是 一 个 相关 的 相等 操作 符 ) 。 如 果 不 是 这 样 ， 当 使 用 操作 符 
时 会 发 生 规划 器 错误 。 同 样 ， 一 个 btree 操作 符 类 支持 多 种 数据 类 型 以 为 数据 类 型 的 每 种 结 
合 提供 相等 操作 符 是 一 个 好 主意 (但 不 是 严格 要 求 ) ; 这 人 允许 更 好 的 优化 。 


Note: 在 一 个 可 融合 连接 操作 符 下 层 的 范 数 必须 标记 为 永久 (immutable) 或 者 稳定 
(stable), 如 果 它 是 易 失 的 (volatile)， 那 么 系统 将 从 不 在 融合 连接 中 使 用 这 些 操作 符 。 


35.14. 扩展 索引 接口 


到 目前 为 止 描 述 的 过 程 可 以 让 你 定义 一 个 新 类 型 、 新 琅 数 、 新 操作 符 。 但 是 ， 还 不 能 在 一 个 
新 数据 类 型 的 字段 上 面 定义 一 个 索引 。 为 了 达到 这 个 目的 ， 必须 为 新 数据 类 型 定义 一 个 操作 
符 类 。 下 面料 使 用 一 个 真实 的 例子 来 描述 操作 符 类 : 一 个 用 于 B-tree 访问 方法 的 新 操作 符 
类 ， 它 保存 复数 并 按照 绝对 值 递增 的 顺序 排序 。 


操作 符 类 可 以 分 类 到 操作 符 族 ， 用 以 显示 语义 兼容 的 类 之 间 的 关系 。 当 只 包含 一 个 数据 类 型 
时 ， 一 个 操作 符 类 就 足够 了 ， 所 以 我 们 首先 关注 这 种 情况 ， 然后 再 转 到 操作 符 族 。 


35.14.1. 索引 方法 和 操作 符 类 


pg_am 表 为 每 个 索引 方法 (内 部 称 作 访 问 方法 ) 都 包含 一 条 记录 。 对 表 的 普通 访问 方法 支持 内 
建 于 PostgreSQL ， 但 所 有 索引 方法 在 pg_am 里 都 有 描述 。 可 以 通过 定义 要 求 的 接口 过 程 并 
在 pg_am 里 创建 一 个 新 行 的 办 法 增加 一 个 索引 访问 方法 ， 不 过 这 些 些 远 远 超出 了 本 章 的 内 容 
(参阅 Chapter 54)。 


一 个 素 引 方法 的 过 程 并 不 直接 知道 任何 该 索引 方法 将 要 操作 的 数据 类 型 的 信息 。 而 是 操作 符 
类 表明 索引 方法 在 操作 特定 数据 类 型 的 时 候 需 要 使 用 的 操作 集合 。 操作 符 类 的 名 称 的 由 来 是 
因为 它们 声明 是 一 种 索引 可 以 使 用 的 wer 子 句 的 操作 符 集 ( 也 就 是 可 以 转化 成 一 个 索引 扫描 
条 件 )。 一 个 操作 符 类 也 可 以 声明 一 些 索引 方法 需要 的 内 部 操作 的 支持 过 程 ， 但 是 它们 并 不 直 
接 和 可 以 与 素 引 一 起 使 用 的 wer 子 句 操作 符 相 关 。 


可 以 为 同一 个 数据 类 型 和 索引 方法 定义 多 个 操作 符 类 。 这 么 做 的 结果 是 ， 可 以 为 一 种 数据 类 
型 定义 多 套 索 引 语 义 。 比 如 ， 一 个 B-tree 索引 要 求 为 它 操 作 的 每 种 数据 类 型 定义 一 个 排序 顺 
序 。 对 于 一 个 复数 数据 类 型 而 让， 有 一 个 通过 复数 绝对 值 对 数据 排序 的 B-tree 操作 符 类 可 能 
会 有 用 ， 还 有 一 个 是 用 实 部 排序 ， 等 等 。 通 常 其 中 一 个 操作 符 类 会 被 认为 最 常用 的 ， 并 且 被 
标记 为 该 数据 类 型 和 索引 方法 的 缺 省 操作 符 类 。 


同样 的 操作 符 类 名 字 可 以 用 于 多 种 不 同 的 素 引 方法 (比如 B-tree 和 Hash 访问 方法 都 有 叫 
int4_ops 的 操作 符 类 )， 但 是 每 个 这 样 的 表 都 是 一 个 独立 的 实体 ， 必 须 分 别 定义 。。 


35.14.2. 索引 方法 策略 


和 一 种 操作 符 类 相关 联 的 操作 符 是 通过 "策略 号 "标识 的 ， 策略 号 用 于 标识 每 种 操作 符 在 它 的 
操作 符 类 环境 里 的 语义 。 比 如 ，B-tree 对 键 字 有 严格 的 排序 要 求 ， 小 于 到 大 于 ， 因 此 ， 像 "小 
于 "和 "大 于 或 等 于 "这 样 的 操作 符 都 是 B-tree 所 感 兴趣 的 。 因为 PostgreSQL 人 允许 用 户 定义 操 


VER}, PostgreSQL 无 法 仅 通过 查看 操作 符 的 名 字 ( 比 如 ait; 或 agt;= ) 就 明白 它 进 行 的 比较 
是 什么 。 实际 上 ， 索 引 方 法 定义 了 一 套 " 策 略 "， 它 可 以 看 作 一 般 性 的 操作 符 。 每 种 操作 符 类 
显示 对 于 特定 数据 类 型 而 言 ， 是 哪 种 实际 操作 符 对 应 每 种 策略 以 及 解释 索引 的 语义 。 


B-tree 索引 定义 了 五 种 策略 。 在 Table 35-2 中 显示 。 


Table 35-2. B-tree 策略 


操作 策略 号 
小 于 1 
小 于 或 等 于 2 
等 于 3 
大 于 或 等 于 4 
大 于 5 


Hash 索引 只 支持 平等 的 比较 ， 因 此 它们 只 定义 了 一 个 策略 ， 在 Table 35-3 里 显示 。 


Table 35-3. Hash 策略 


操作 策略 
等 于 1 


dl 


GIST 索引 其 至 更 加 灵活 : 它们 根本 就 没有 固定 的 策略 集 。 实 际 上 ， 是 每 个 特定 GIST 操作 符 
类 的 "一 致 性 "支持 过 程 解释 策略 号 是 什么 样子 。 作 为 示例 ， 有 几 个 内 置 的 GIST 索引 操作 符 类 
索引 二 维 几何 对 象 ， 提 供 Table 35-4 中 所 示 的 "R-tree" 策 略 。 其 中 的 四 个 是 两 维 测试 ( 重 有 个 、 相 
同 、 包 含 、 包 含 于 ) ; 四 个 只 考虑 x 坐标 、 四 个 对 y 坐标 进行 同样 测试 。 


Table 35-4. GiST 两 维 "R-tree" 策 略 


操作 策略 号 
严格 地 在 ... 左 边 
不 扩展 到 ... 右 边 
Eg 
不 延伸 到 ... 左 边 
严格 地 在 ... 右 边 
相同 
包含 
包含 于 
不 扩展 到 .… 上面 
严格 地 在 … 下 面 10 
严格 地 在 ... 上 面 11 
不 扩展 到 ... 下 面 12 


一 人 


o o N 9 A W N 


SP-GiST 索 引 在 灵活 性 方面 与 GiST 索引 类 似 : 它们 都 没有 一 个 国定 的 策略 集 ， 而 是 由 每 个 
操作 符 类 的 支持 过 程 根据 操作 符 类 的 定义 来 解释 策略 号 。 作 为 示例 ， Table 35-587 TAE 
的 点 操作 符 类 使 用 的 策略 号 。 


Table 35-5. SP-GiST 点 策略 


操作 策略 号 
严格 在 左边 1 
严格 在 右边 5 
相同 6 
包含 8 
严格 在 下 面 10 
严格 在 上 面 11 


GIN 索引 与 GiST 索引 和 SP-GiST RBI XW : 它们 都 没有 一 个 国定 的 策略 集 ， 而 是 由 每 个 操 
作 符 类 的 支持 过 程 根据 操作 符 类 的 定义 来 解释 策略 号 。 作 为 示例 ， Table 35-687 TAAN 
数组 操作 符 类 使 用 的 策略 号 。 


Table 35-6. GIN 数组 策略 


操作 策略 号 


Bs 1 
包含 2 
包含 于 3 
相等 4 


请 注意 ， 所 有 上 述 操作 符 都 返回 布尔 值 。 实 际 上 ， 所 有 定义 为 索引 方法 搜索 操作 符 的 操作 符 
都 必须 返回 boolean 类 型 ， 因 为 它们 必须 出 现在 一 个 were 子 句 的 顶层 ， 这 样 才能 被 一 个 索 
引 使 用 。 ( 某 些 索 引 访 问 方法 也 支持 顺序 操作 符 ， 它们 通常 不 反悔 Boolean 值 ; 这 个 特征 
在 Section 35.14.7 里 讨论 。) 


35.14.3. 索引 方法 支持 过 程 


有 时 候 ， 策 略 的 信息 还 不 足以 让 系统 决定 如 何 使 用 某 个 索引 。 在 实际 中 ， 索引 方法 需要 附加 
的 一 些 过 程 来 保证 正常 工作 。 例 如 ， B-tree 索引 方法 必须 能 够 比较 两 个 键 字 以 决定 其 中 一 个 
是 大 于 、 等 于 、 还 是 小 于 另外 一 个 。 类 似 的 还 有 Hash 索引 方法 必须 能 够 在 键 值 上 计算 散 列 
值 。 这 些 操作 和 SQL 命令 条 件 里 使 用 的 操作 符 并 不 对 应 ; 它们 是 在 内 部 被 索引 方法 使 用 的 管 
理 过 程 。 


就 像 策略 一 样 ， 操 作 符 类 声明 在 一 定 的 数据 类 型 和 语义 解释 的 条 件 下 ， 哪个 特定 范 数 对 应 这 
些 角 色 中 的 哪 一 个 。 索 引 方 法 声明 它 需 要 的 田 数 集 ， 而 操作 符 类 通过 给 它们 赋予 通过 索引 方 
法 指定 的 "支持 琅 数 编号 "来 标识 要 正确 使 用 的 男 数 。 

B-tree 需要 一 个 支持 琅 数 ， 并 且 人 允许 在 操作 符 类 作者 的 选项 中 提供 第 二 个 ， 就 像 Table 35-7 
里 显示 的 那样 。 


Table 35-7. B-tree Z#F# HA 


- xi 
FW 

比较 两 个 键 字 并 且 返 回 一 个 小 于 、 等 于 、 大 于 需 的 整数 ， 标 识 第 一 个 键 字 小 于 、 1 

等 于 、 大 于 第 二 个 键 字 。 

返回 C-callable 排 序 支持 函数 的 地 址 ， 记 录 在 utils/sortsupport.h (可 选 ) 2 


Hash 索引 也 需要 一 个 支持 函数 ， 在 Table 35-8 里 显示 。 
Table 35-8. Hash 支持 函数 


BREN 支持 号 
为 一 个 键 字 计 算 散 列 值 1 


GIST RIIBACHRABM, MDR, Table 35-9 里 显示 。 (更 多 
# Chapter 55. ) 


ai 
cit 
S 
y 


Table 35-9. GIST 支持 函数 


函数 描述 支持 
"J 
consistent 全 测 键 是 否 满足 查询 限定 符 1 
union 计算 一 套 键 的 联合 2 
compress 计算 已 索引 键 或 值 的 压缩 结果 3 
decompress “， 计算 已 压缩 键 的 解压 结果 


计算 使 用 给 定 的 子 树 的 键 向 子 树 中 插入 新 键 的 性 能 恶化 


PESAR (penalty) a 
picksplit 全 测 页 面 中 的 哪个 项 将 被 移动 到 新 页 面 并 为 结果 页 计算 联合 6 
equal 比较 两 个 键 并 在 相等 时 返回 真 7 
distance 确定 键 到 查询 值 的 距离 (可 选 ) 8 


SP-GiST 索 引 需 要 五 种 支持 函数 ， 显 示 在 Table 35-10 中 。 (更 多 信息 请 参阅 Chapter 56。) 


Table 35-10. SP-GiST 支持 函数 


函数 描述 支持 号 
config 提供 操作 符 类 的 基本 信息 1 
choose 确定 如 何 将 一 个 新 值 插入 一 个 内 在 的 元 组 2 
picksplit 确定 如 何 分 区 一 组 值 3 
inner_consistent 确定 哪个 子 分 区 需要 为 一 个 查询 搜索 4 
leaf_consistent 确定 哪个 键 满足 查询 条 件 5 


GIN 索引 需要 四 种 支持 本 数 ， 和 一 个 可 选 的 本 数 ， 在 Table 35-11 里 显示 。 (更 多 信息 请 参 
阅 Chapter 57。) 


Table 35-11. GIN 支持 函数 


支 

函数 描述 持 

号 
meiner 比较 两 个 键 并 返回 一 个 小 于 、 等 于 、 大 于 需 的 整数 ， 标 识 第 一 1 

个 键 小 于 、 等 于 、 大 于 第 二 个 键 。 

extractValue 从 将 被 索引 的 值 中 抽取 键 2 
extractQuery 从 查询 条 件 中 抽取 键 3 
consistent 令 测 值 是 否 匹 配 查 询 条 件 4 


比较 部 分 来 自 查 询 的 键 和 来 自 素 引 的 键 ， 并 返回 一 个 小 于 、 等 
comparePartial F, AFIZZA, 标识 是 否 GIN 应 该 忽略 这 个 索引 项 ， 将 这 5 
个 项 视 为 一 个 匹配 ， 或 停止 索引 扫描 (可 选 ) 。 


和 搜索 操作 符 不 同 ， 支 持 汞 数 返 回 特定 索引 方法 预期 的 数据 类 型 ， 比 如 在 B-tree 的 情况 下 ， 

返回 一 个 有 符号 整数 。 每 个 支持 函数 的 参数 的 数字 和 类 型 也 取决 于 素 引 方法 。 对 于 B-tree 和 
hash 的 比较 ， 散 列 支 持 男 数 接受 相同 的 输入 数据 类 型 ， 同 桩 操作 符 也 包含 在 操作 符 类 里 ， 但 
是 大 多 数 GiST SP-GiST 和 GIN ZEKAT ER 


35.14.4. 例子 


既然 已 经 了 解 了 这 些 概念 ， 那 么 现在 就 来 看 一 个 创建 新 操作 符 类 的 例子 。 你 可 以 在 源 代码 的 
src/tutorial/complex.c 和 src/tutorial/complex.sql 中 找到 这 里 讲述 的 例子 。 操作 符 类 封装 
了 那些 以 绝对 值 顺 序 对 复数 排序 的 操作 符 ， 这 样 就 可 以 选择 complex_abs_ops 这 个 名 字 。 首 
先 ， 需 要 一 个 操作 符 集合 。 用 于 定义 操作 符 的 过 程 已 经 在 Section 35.12 讨 论 过 了 。 对 这 个 用 
于 B-tree 的 操作 符 类 ， 需要 的 操作 符 是 : 


。 绝对 值 小 于 (策略 1) 
。 绝对 值 小 于 等 于 (策略 2) 
。 绝对 值 等 于 (策略 3) 
。 绝对 值 大 于 等 于 (策略 4) 
。 绝对 值 大 于 (策略 5) 


定义 一 组 相关 的 比较 操作 符 最 不 容易 出 错 的 方法 是 首先 写 出 B-tree LRA, 然后 再 写 
出 其 它 封 装 了 支持 函数 的 单行 琅 数 。 这 就 减少 了 某 些 情况 下 导致 不 一 致 结果 的 机 会 。 根据 这 
个 指引 ， 首 先 写 出 : 


#define Mag(c) ((c)->x*(c)->x + (c)->y*(c)->y) 


static int 
complex_abs_cmp_internal(Complex *a, Complex *b) 


double amag 
bmag 


= Mag(a), 
= Mag(b); 
if (amag < bmag) 

return -1; 
if (amag > bmag) 

return 1; 
return 0; 


nE, /)\FRRAR RRR 


PG_FUNCTION_INFO_V1(complex_abs_1t); 


Datum 
complex_abs_1t(PG_FUNCTION_ARGS ) 
{ 
Complex *a (Complex *) PG_GETARG_POINTER(0); 


Complex *b (Complex *) PG_GETARG_POINTER(1); 


PG_RETURN_BOOL(complex_abs_cmp_internal(a, b) < 0); 


其 它 四 个 画 数 的 不 同 之 处 仅 在 它们 如 何 将 内 部 函数 的 结果 与 老 比 较 。 
下 一 步 ， 基 于 SQL 画 数 声明 函数 和 操作 符 : 


CREATE FUNCTION complex_abs_1t(complex, complex) RETURNS bool 
AS '_filename_', 'complex_abs_1t' 
LANGUAGE C IMMUTABLE STRICT; 


CREATE OPERATOR < ( 
leftarg = complex, rightarg = complex, procedure = complex_abs_lt, 
commutator = > , negator = >=, 
restrict = scalarltsel, join = scalarltjoinsel 


ye 


指定 正确 的 交换 器 和 " 非 " 操 作 符 以 及 适当 的 限制 和 连接 选择 性 画 数 都 是 非常 重要 的 ， 否则 优 
化 器 将 无 法 有 效 地 利用 索引 。 请 注意 ， 小 于 、 等 于 、 大 于 三 种 情况 下 应 该 使 用 不 同 的 选择 性 
图 数 。 


其 它 几 个 值得 注意 的 问题 : 


e 只 可 以 有 一 个 已 命名 操作 符 = 把 complex 类 型 做 为 其 两 个 操作 数 。 这 种 情况 下 没有 其 
它 用 于 complex 的 = 操作 符 ， 但 是 如 果 要 制作 一 个 实用 的 数据 类 型 ， 可 能 需 = 做 为 
复数 的 普通 等 于 操作 。 这 种 情况 下 ， 可 能 需要 使 用 一 些 其 它 操作 符 名 称 来 命 


名 complex_abs_eq o 


。 尽管 P i SQL 名 字 相 同 的 函数 ， 只 要 它们 的 输入 数据 类 型 不 同 ， 而 C 

只 能 处 理 一 个 具有 给 定名 称 的 全 局 过 程 。 因此 不 能 把 C 函数 命名 为 像 abs_eq 这 样 简单 

Nes 通常 在 CHMEEHASRELUAME—MIAM, RHRDANATHE 
数据 类 型 的 画 数 冲突 。 


。 可 以 制作 名 为 abs_eq 的 SQL 函数 ， 依 靠 PostgreSQL 通过 输入 数据 类 型 的 不 同 来 区 分 任 
何其 它 同名 SQL 函数 。 为 了 命 例子 简单 ， 做 的 函数 在 C 层次 和 SQL 层次 都 有 相同 的 名 
称 。 


下 一 步 是 注册 B-tree 需要 的 "支持 过 程 "。 实 现 这 个 例子 的 C 代码 在 包含 操作 符 函 数 的 同一 
文件 中 ， 下面 是 定义 图 数 的 方法 : 


CREATE FUNCTION complex_abs_cmp(complex, complex) 
RETURNS integer 
AS '_filename_' 
LANGUAGE C IMMUTABLE STRICT; 


既然 已 经 有 了 需要 的 操作 符 和 支持 过 程 ， 就 可 以 最 后 创建 这 个 操作 符 类 了 : 


CREATE OPERATOR CLASS complex_abs_ops 
DEFAULT FOR TYPE complex oS btree AS 
OPERATOR 


1 / 
OPERATOR 2 << 
OPERATOR 3 = 
OPERATOR 4 >= , 
OPERATOR 5 = A 
FUNCTION 1 complex_abs_cmp(complex, complex); 


这 样 就 完成 了 ! 现在 可 以 在 一 个 complex 列 上 创建 和 使 用 B-tree 索引 了 。 
可 以 把 操作 符 记 录 写 得 更 见 余 一 些 ， 像 : 


OPERATOR 1 < (complex, complex) , 


但 是 如 果 该 操作 符 接受 的 数据 类 型 是 定义 的 操作 符 类 处 理 的 东西 ， 那 就 没 必 要 这 么 做 。 


上 面 的 例子 假设 你 想 把 这 个 新 操作 符 类 作为 complex 数据 类 型 的 缺 省 B-tree 操作 符 类 。 如 果 
你 不 想 这 么 做 ， 只 要 去 掉 关键 字 DpEFAULT 即 可 。 


35.14.5. 操作 符 类 和 操作 符 族 


到 目前 为 止 我 们 都 隐 含 的 假定 一 个 操作 符 类 只 能 处 理 一 种 数据 类 型 。 虽然 每 个 索引 字段 都 只 
能 是 单独 一 种 数据 类 型 ， E aa 
常 很 有 用 处 。 如 果 有 用 于 与 一 个 操作 符 类 连接 的 交叉 数据 类 型 操作 符 ， 通 常 是 其 他 数据 类 型 


有 他 自己 的 相关 的 操作 符 类 。 这 对 于 在 相关 的 类 之 间 明 确 的 建立 连接 是 有 帮助 的 ， 因 为 这 可 
以 帮助 规划 器 优化 SQL 查询 (尤其 对 于 B-tree 操 作 符 类 ， 因 为 规划 器 包含 大 量 的 关于 如 果 钦 
理 这 些 问题 的 信息 ) 。 


为 了 义理 这 种 需求 ，PostgreSQL 使 用 操作 符 族 的 概念 。 一 个 操作 符 族 包含 一 个 或 多 个 操作 符 
类 ， 也 可 以 包含 可 索引 的 操作 符 和 对 应 的 支持 范 数 ， 作 为 一 个 整体 属于 这 个 族 ， 但 不 是 这 个 
族 中 的 任何 一 个 类 。 我 们 说 这 样 的 操作 符 和 函数 是 "松散 "在 族 里 的 ， 而 不 是 被 绑 定 到 一 个 特 
定 的 类 。 通常 每 个 操作 符 类 包含 一 个 数据 类 型 操作 符 ， 而 交叉 数据 类 型 操作 符 是 散落 在 族 里 

的 。 


所 有 在 一 个 操作 符 族 里 的 操作 符 和 郴 数 必须 有 兼容 的 语法 ， 兼 容 性 需求 是 通过 索引 方法 设置 
的 。 你 可 能 想 知道 为 什么 费心 的 挑选 出 特别 的 族 的 子 集 作为 操作 符 类 ; 并 且 甚 至 为 了 多 种 目 
的 类 的 区 分 是 不 相关 的 ， 族 只 对 分 组 感 兴趣 。 定义 操作 符 类 的 原因 是 指定 多 少 族 需要 支持 任 
何 特定 的 索引 。 如 果 有 一 个 索引 使 用 一 个 操作 符 类 ， 然后 操作 符 类 不 能 在 不 删除 素 引 的 情况 
下 被 删除 ， 但 是 操作 符 族 的 其 他 部 分 ， 即 其 他 操作 符 类 和 松散 的 操作 符 可 以 被 删除 。 因 此 ， 
一 个 操作 符 类 应 该 被 指定 包含 最 少 的 操作 符 和 画 数 ， 应 该 是 在 一 个 特定 数据 类 型 上 索引 工作 
所 需要 的 适当 的 操作 符 和 阔 数 ， 然后 相关 的 但 非 重 要 的 操作 符 可 以 作为 松散 的 操作 符 族 成 员 
添加 。 


作为 一 个 例子 ， PostgreSQL 有 一 个 内 和 置 的 B-tree 操 作 符 族 integer_ops ， 它 包 含 操 作 符 

类 int8_ops ， int4_ops 和 int2_ops ， 分 别 对 bigint ( ints ), integer ( int4 ), 和 
smallint ( int2 ) 字段 索引 。 也 包含 交叉 数据 类 型 比较 操 作 符 ， 允许 其 中 的 任意 两 种 类 型 进 
行 比较 ， 所 以 任意 其 中 一 种 类 型 上 的 索引 可 以 使 用 其 他 类 型 的 比较 值 被 搜索 到 。 族 可 以 通过 
下 面 的 定义 复制 : 


CREATE OPERATOR FAMILY integer_ops USING btree; 


CREATE OPERATOR CLASS int8_ops 
DEFAULT FOR TYPE int8 USING btree FAMILY integer_ops AS 
<a 
- standard int8 comparisons 
> 
- 标准 ae 比较 
OPERATOR 
OPERATOR 
OPERATOR 
OPERATOR 
OPERATOR 
FUNCTION 
FUNCTION 


B 


Pa 


2 
3=, 
4>=, 
5>, 
1 btint8cmp(int8, int8) , 
2 btint8sortsupport(internal) ; 
CREATE OPERATOR CLASS int4_ops 
DEFAULT FOR TYPE int4 USING btree FAMILY integer_ops AS 
<!-- 
5 PORON int4 comparisons 


oa are 比较 
OPERATOR 1 
OPERATOR 
OPERATOR 


2 <=, 
3 

OPERATOR 4 >= , 
5 
1 
2 


OPERATOR > 
FUNCTION btint4cmp(int4, int4) , 
FUNCTION btint4sortsupport(internal) ; 


CREATE OPERATOR CLASS int2_ops 
DEFAULT FOR TYPE int2 USING btree FAMILY integer_ops AS 
<!-- 
-- standard int2 comparisons 
> 
- -标准 int2 比较 
OPERATOR 1 < , 
OPERATOR 2 <= , 
OPERATOR 3 = , 
OPERATOR 4 >= , 
OPERATOR 5 > , 
FUNCTION 1 btint2cmp(int2, int2) , 
FUNCTION 2 btint2sortsupport(internal) ; 


ALTER OPERATOR FAMILY integer_ops USING btree ADD 
<= 
-- cross-type comparisons int8 vs int2 
> 
-- 交叉 类 型 比较 ints 对 int2 
OPERATOR 1 < (int8, int2) , 
OPERATOR 2 <= (int8, int2) , 
OPERATOR 3 = (int8, int2) , 
OPERATOR 4 >= (int8, int2) , 
OPERATOR 5 > (int8, int2) , 
FUNCTION 1 btint82cmp(int8, int2) , 


<!-- 

-- cross-type comparisons int8 vs int4 
m> 

-- 交叉 类 型 比较 ints 对 int4 

OPERATOR 1 < (int8, int4) , 

OPERATOR 2 <= (int8, int4) , 

OPERATOR 3 = (int8, int4) , 

OPERATOR 4 >= (int8, int4) , 

OPERATOR 5 > (int8, int4) , 

FUNCTION 1 btint84cmp(int8, int4) , 


<li 

-- cross-type comparisons int4 vs int2 
> 

-- 交叉 类 型 比较 int4 对 int2 

OPERATOR 1 < (int4, int2) , 

OPERATOR 2 <= (int4, int2) , 

OPERATOR 3 = (int4, int2) , 

OPERATOR 4 >= (int4, int2) , 

OPERATOR 5 > (int4, int2) , 

FUNCTION 1 btint42cmp(int4, int2) , 


<!-- 

-- cross-type comparisons int4 vs int8 
<> 

-- 交叉 类 型 比较 int4 对 ints 

OPERATOR 1 < (int4，int8) , 

OPERATOR 2 <= (int4, int8) , 

OPERATOR 3 = (int4, int8) , 

OPERATOR 4 >= (int4, int8) , 

OPERATOR 5 > (int4, ints) , 

FUNCTION 1 btint48cmp(int4, ints) , 


<!-- 

-- cross-type comparisons int2 vs int8 
=> 

-- 交叉 类 型 比较 int2 对 ints 

OPERATOR 1 < (int2，int8) , 

OPERATOR 2 <= (int2, int8) , 

OPERATOR 3 = (int2, int8) , 

OPERATOR 4 >= (int2, int8) , 

OPERATOR 5 > (int2, ints) , 

FUNCTION 1 btint28cmp(int2, ints) , 


<!-- 
-- cross-type comparisons int2 vs int4 


= 
- 交叉 类 型 比较 int2 对 int4 
OPERATOR 1 < (int2, int4) , 
OPERATOR 2 <= (int2, int4) , 
OPERATOR 3 = (int2, int4) , 
OPERATOR 4 >= (int2, int4) , 
OPERATOR 5 > (int2, int4) , 
FUNCTION 1 btint24cmp(int2, int4) ; 


需要 注意 的 是 ， 这 里 的 定义 " 重 载 " 了 操作 符 策略 和 支持 函数 号 : 每 个 号 在 族 内 多 次 发 生 。 只 
要 每 个 数字 的 实例 都 有 不 同 输入 数据 类 型 就 都 是 允许 的 。 输 入 类 型 都 等 于 操作 符 类 的 输入 类 
型 的 实例 是 主 操作 符 ， 并 且 支 持 该 操作 符 类 的 范 数 ， 在 大 多 数 情况 下 应 该 被 声明 为 操作 符 类 
的 一 部 分 ， 而 不 是 该 族 内 的 松散 成 员 。 


在 一 个 B-tree 操 作 符 族 内 ， 所 有 的 操作 符 都 必须 适当 的 排序 ， 意 味 着 传递 法 保存 所 有 该 族 支持 
的 数据 类 型 : "ifA=BandB=C,then 人 A=C", 和 "fA<BandB<C,thenA<C"。 此 外 ， 代 
表 操 作 符 族 的 类 型 间 的 隐 式 的 或 二 进 制 强制 转换 必须 不 能 改变 相关 的 排序 次 序 。 族 内 的 每 个 
操作 符 必 须 有 一 个 支持 的 函数 ， 这 个 函数 有 和 操作 符 相 同 的 两 个 输入 数据 类 型 。 建议 一 个 族 
是 完整 的 ， 也 就 是 ， 对 于 每 个 数据 类 型 的 组 合 ， 所 有 的 操作 符 都 包括 了 。 每 个 操作 符 类 应 该 
只 包含 非 交 叉 类 型 操作 符 和 它 的 数据 类 型 的 支持 函数 。 


要 建立 一 个 多 数据 类 型 散 列 操作 符 族 ， 必 须 为 每 个 该 族 支持 的 数据 类 型 创建 兼容 的 散 列 支 持 
沙 数 。 这 里 的 兼容 意味 着 函数 保证 对 两 个 通过 族 的 相等 运算 符 认 为 相等 的 两 个 值 返 回 相 同 的 
散 列 码 ， 其 至 两 个 值 属 于 不 容 的 类 型 时 也 是 。 当 类 型 有 不 同 的 物理 表示 时 这 通常 是 很 难 完成 
的 ， 但 是 在 某 些 情况 下 是 可 以 做 到 的 。 更 多 的 ， 通 过 隐 式 的 或 二 进 制 强制 转换 ， 转换 一 个 操 
作 符 族 中 的 数据 类 型 的 值 到 另 一 个 同样 在 操作 符 族 中 的 数据 类 型 ， 必须 不 能 改变 计算 散 列 
值 。 注 意 每 个 数据 类 型 只 有 一 个 支持 函数 ， 而 不 是 每 个 相等 操作 符 。 建议 一 个 族 是 完整 的 ， 
也 就 是 ， 对 于 每 个 数据 类 型 的 组 合 都 提供 一 个 相等 操作 符 。 每 个 操作 符 类 应 该 只 包含 非 交叉 
类 型 相等 操作 符 和 它 的 数据 类 型 的 支持 函数 。 


GiST, SP-GiST 和 GIN 索 引 对 于 交叉 数据 类 型 操作 符 没 有 任何 明确 的 概念 。 支持 的 操作 符 集 
对 于 可 以 处 理 的 给 定 的 操作 符 类 只 是 主要 的 支持 范 数 。 


Note: 在 PostgreSQL 8.3 之 前 ， 没 有 操作 符 族 的 概念 ， 因此 任何 试图 和 索引 一 起 使 用 的 
交叉 数据 类 型 操作 符 必 须 直 接 绑 定 到 索引 的 操作 符 类 里 面 。 虽然 这 种 方法 仍然 有 效 ， 但 
是 已 经 人 痉 用 了 ， 因 为 它 使 得 索引 的 依赖 太 过 广泛 ， 并 且 因 为 当 数 据 类 型 都 有 操作 符 在 相 
同 的 操作 符 族 内 时 ， 规 划 器 可 以 更 有 效 的 处 理 交 叉 数 据 类 型 比较 。 




















35.14.6. 操作 符 类 的 系统 相关 性 


除了 是 否 可 以 用 于 索引 外 ，PostgreSQL 还 有 多 种 途径 使 用 操作 符 类 来 推断 操作 符 性 质 。 因 
此 ， 即 使 并 不 打算 为 你 自 定义 的 数据 类 型 在 任何 字段 上 建立 素 引 ， 你 可 能 还 是 希望 创建 操作 
符 类 。 


特别 是 诸如 oRDER BY 和 DISTINCT 之 类 需要 对 值 进 行 比较 和 排序 的 SQL 特性 。 要 在 自 定义 的 
数据 类 型 上 实现 这 些 特 性 ，PostgreSQL 将 会 为 该 类 型 查找 默认 的 B-tree 操作 符 类 。 该 操作 
符 类 中 的 "equals" 成 员 为 croup BY 和 pistinct 定义 了 相等 的 概念 ， 同时 操作 符 类 的 排序 顺 
序 定义 了 默认 的 oRDER BY 排序 。 


用 户 自 定义 类 型 数组 的 比较 同样 也 依赖 于 默认 B-tree 操作 符 类 定义 的 语意 。 


如 果 对 于 某 个 数据 类 型 不 存在 默认 B-tree 操作 符 类 ， 那 么 系统 将 会 自动 寻找 默认 的 Hash 操 
作 符 类 。 但 因为 Hash 操作 符 类 仅仅 提供 相等 比较 ， 所 以 在 实践 中 它 仅 能 用 于 数组 的 相等 性 


测试 。 


如 果 某 个 数据 类 型 不 存在 任何 缺 省 操作 符 类 ， 你 就 会 在 使 用 该 SQL 特性 时 得 到 一 个 类 似 


"could not identify an ordering operator" 的 错误 。 


Note: PostgreSQL 7.4 以 前 ， 排 序 和 分 组 操作 隐 含 使 用 名 为 = alt; , agt; 的 操作 符 。 
新 的 依赖 默认 操作 符 类 的 行为 避免 了 对 任何 特定 操作 符 名 的 行为 的 假定 。 


另 一 点 重要 的 是 一 个 在 hash 操 作 符 族 中 的 操作 符 是 hash 连 接 ，hash 聚 合 和 相关 优化 的 候选 。 
hash 操 作 符 族 在 这 里 是 重要 的 ， 因 为 它 标志 要 使 用 的 hash 画 数 。 


35.14.7. 排序 操作 符 


一 些 素 引 访问 方法 (当前 只 有 GIST) 支持 排序 操作 符 的 概念 。 我 们 当前 已 经 讨论 过 的 是 搜索 
操作 符 。 搜 索 操 作 符 是 可 以 搜索 索引 找到 所 有 满足 WHERE _indexed column _operator_ 
_constant_ 的 行 。 注意 ， 不 保证 将 要 返回 的 匹配 行 的 顺序 。 相 反 的 ， 排 序 操作 符 不 限制 要 返 
回 的 行 集 ， 但 是 决定 它们 的 顺序 。 排 序 操作 符 是 可 以 打 描 索引 以 ORDER BY 

_indexed_column_ _operator_ _constant_ 的 顺序 返回 行 。 这 种 方式 定义 排序 操作 符 的 原因 
是 支持 最 近 搜 索 ， 如 果 操 作 符 是 测量 距离 。 例 如 ， 像 这 样 的 查询 


SELECT * FROM places ORDER BY location <-> point '(101,456)' LIMIT 10; 


找到 一 个 距离 给 定 目标 点 最 近 的 点 。 在 location 字 段 上 的 GIST 索 引 可 以 有 效 地 做 到 这 点 ， 
为 &lt;-&gt; 是 一 个 排序 操作 符 。 


当 搜 索 操 作 符 必须 返回 布尔 结果 时 ， 排 序 操作 符 通常 返回 一 些 其 他 类 型 ， 如 float 或 numeric。 
这 种 类 型 通常 不 同 于 被 索引 的 类 型 。 为 了 避免 关于 不 同 数据 类 型 行为 的 硬 链 接 的 假设 ， 排序 
操作 符 的 定义 需要 命名 一 个 B-tree 操 作 符 族 ， 声 明 结 果 数 据 类 型 的 排序 次 序 。 就 像 前 一 节 中 
阅 明 的 ，B-tree 操 作 符 族 定义 PostgreSQL 的 排序 概念 ， 所 以 这 是 一 个 自然 的 表示 。 因 为 point 
alt;-egt; 操作 符 返 回 floats, 可 以 在 一 个 操作 符 类 的 创建 命 合 中 指定 ， 像 这 样 : 


OPERATOR 15 <-> (point, point) FOR ORDER BY float_ops 


这 里 的 float_ops HAS floats 操作 的 内 建 操作 符 族 。 这 个 说 明 声 明了 索引 可 以 
以 &1t;-&gt; 操作 符 的 增值 的 顺序 返回 行 。 


35.14.8. 操作 符 类 的 特殊 特性 
还 有 两 种 操作 符 类 的 特殊 特性 没有 讨论 ， 主 要 是 因为 它们 对 于 大 多 数 常用 的 索引 方法 并 不 非 
常 有 用 。 


通常 ， 把 一 个 操作 符 声明 为 一 个 操作 符 类 (或 族 ) 的 成 员 意 味 着 索引 方法 可 以 使 用 该 操作 符 
检索 满足 wHERE 条 件 的 行 集合 。 上 比如 : 





SELECT * FROM table WHERE integer_column < 4; 


可 以 由 一 个 建立 在 整数 字段 上 的 B-tree 索引 精确 地 满足 。 但 是 有 时 候 会 有 这 样 的 现 像 : 索引 
是 用 作 匹 配 数据 行 的 并 不 精确 的 指向 。 比 如 ， 如 果 一 个 GIST 索引 只 为 几何 对 象 存 储 周 界 的 方 
块 ， 那么 它 就 无 法 精确 地 满足 两 个 非 方形 对 象 (比如 多 边 形 ) 之 间 是 否 履 盖 的 whERE 条 件 测 
试 。 但 是 可 以 使 用 这 个 索引 找 出 那些 周 界 方块 和 目标 对 象 的 周 界 方块 重合 的 对 象 ， 然后 只 在 
索引 找到 的 对 象 上 做 精确 的 重合 测试 。 如 果 这 种 情形 可 以 通过 ， 那 就 说 索引 对 操作 符 是 "松散 
的 "， 松散 索引 搜索 通过 当 一 个 行 可 能 或 可 能 不 真正 满足 查询 条 件 时 使 素 引 方法 返回 一 
recheck 标识 来 实施 。 核 心 系统 将 然后 在 检索 的 行 上 测试 原始 的 查询 条 件 ， 以 查看 是 否 应 该 
作为 一 个 合法 的 匹配 返回 。 如 果 索 引 保 证 返回 所 有 要 求 的 行 加 上 一 些 附加 的 行 ， 那 么 这 种 方 
法 就 可 行 ， 这 些 额外 的 行 就 可 以 通过 执行 最 初 的 操作 符 调用 消除 。 支 持 松 散 搜 索 的 素 引 方法 
(当前 是 GiST, SP-GiST 和 GIN) 人 允许 个 别 的 操作 符 类 的 支持 函数 设置 recheck 标 识 ， 所 以 这 
是 本 质 上 的 一 个 操作 符 类 特征 。 


再 考 虑 只 在 索引 中 存储 复杂 对 象 ( 比 如 多 边 形 ) 的 周 界 方块 的 情形 。 这 种 情况 下 在 索引 条 目 里 
存储 整个 多 边 形 没有 太 多 的 数值 (也 可 以 只 存储 更 简单 的 box 类 型 对 象 )。 这 种 情形 
FH CREATE OPERATOR CLASS 里 的 STORAGE 选项 存储 。 可 以 写 类 似 这 样 的 东西 : 


CREATE OPERATOR CLASS polygon_ops 
DEFAULT FOR TYPE polygon USING gist AS 


STORAGE box; 


目前 ， 只 有 GIST 和 GIN 索引 方法 支持 与 字段 数据 类 型 不 同 的 STORAGE 类 型 。 GiST 
compress 和 decompress 支持 过 程 在 使 用 storace 的 时 候 必 须 处 理 数据 类 型 转换 。 对 于 
GIN 来 说 ， STORAGE 类 型 标识 了 " 键 " 值 的 类 型 ， 它 通常 与 素 引 字段 的 类 型 不 同 。 比 如 ， 一 个 
用 于 整数 数组 字段 的 操作 符 类 可 能 正好 有 整数 类 型 的 键 。 GIN extractValue 

All extractQuery 支持 过 程 负 责 从 已 索引 的 值 抽 取 键 字 。 


35.15. 包装 相关 对 象 到 一 个 扩展 


PostgreSQL 的 一 个 有 用 扩展 通常 包括 多 个 SQL 对 象 ; 例如 ， 一 个 新 的 数据 类 型 将 需要 新 的 函 
数 ， 新 的 操作 符 ， 以 及 可 能 的 新 的 索引 操作 类 。 为 了 简化 数据 库 管 理 有 助 于 收集 所 有 这 些 对 
象 到 一 个 单一 的 包 。 PostgreSQL 调 用 这 样 的 包 如 extension。 为 了 定义 一 个 扩展 ， 你 至 少 需 
要 一 个 脚本 文件 包含 SQL 命令 以 创建 扩展 的 对 象 ， 并 且 控制 文件 指定 扩展 本 身 的 几 个 基本 性 
质 。 如 果 扩 展 包括 C 代 码 ， 通常 也 是 一 个 共享 库 文 件 的 已 经 编译 的 C 代 码 。 一 旦 你 有 了 这 些 

文件 ， 一 个 简单 的 CREATE EXTENSION 命 邻 加 载 对 象 到 你 的 数据 库 。 


使 用 一 个 扩展 的 主要 优点 ， 不 是 运行 SQL 脚本 加 载 一 组 "loose" 对 象 到 你 的 数据 库 ， 而 是 
PostgreSQL 将 一 起 了 解 扩 展 的 对 象 。 你 可 以 删除 使 用 单独 DROP EXTENSION 命 邻 的 所 有 的 
对 象 (不 需要 维护 一 个 单独 的 "卸载 "脚本 ) 。 更 有 用 的 ，pg_dump 知 道 它 不 应 该 转 储 扩展 的 
单个 成 员 对 象 一 ; 它 会 只 包括 CREATE EXTENSION 命令 创建 扩展 。 这 大 大 简化 了 迁移 到 一 个 新 
的 扩展 版 本 ， 可 能 含有 比 旧版 本 更 多 的 或 不 同 的 对 象 。 但 是 请 注意 ， 当 装载 转 储 到 一 个 新 的 
数据 库 的 时 候 ， 你 必须 有 扩展 的 控制 ， 脚 本 ， 以 及 其 他 可 用 的 文件 。 


PostgreSQL 不 会 让 你 删除 包含 在 扩展 中 的 单独 的 对 象 ， 除 了 减少 整个 扩展 。 同时 ， 虽 然 你 
可 以 改变 扩展 成 员 对 象 的 定义 (例如 ， 通 过 CREATE OR REPLACE FUNCTION HM) ， 记 住 修改 后 
的 定义 将 不 会 通过 pg_dump 被 转 储 。 这 种 变化 通常 是 唯一 明智 的 ， 如 果 你 同时 在 扩展 的 脚本 
文件 中 有 相同 的 变化 。 (但 对 包含 配置 数据 的 表 有 特殊 规定 ; 见 下 文 。) 


扩展 机 制 也 为 包装 修改 脚本 制定 规定 ， 它 调整 包含 扩展 的 SQL 对 象 的 定义 。 例如 ， 如 果 扩 展 
的 版 本 1.1 增 加 了 一 个 功能 并 且 改变 相 比 较 于 1.0 的 另 一 个 函数 的 主体 ， 扩 展 可 以 提供 一 个 更 
新 脚本 ， 只 是 那 两 个 改变 。 ALTER EXTENSION UPDATE 命令 可 以 用 于 应 用 这 些 变化 ， 并 且 跟踪 
扩展 的 版 本 ， 实 际 上 是 安装 在 一 个 给 定 的 数据 库 中 。 


一 些 SQL 对 象 是 显示 在 ALTER EXTENSION 的 描述 中 的 扩展 对 象 。 值得 注意 的 是 ， 对 象 是 数 
据 库 集群 范围 ， 如 数据 库 ， 角 色 ， 和 表 空 间 ， 无 法 扩展 成 员 ， 因 为 扩展 在 一 个 数据 库 中 是 唯 
一 已 知 的 。 (虽然 并 不 禁止 扩展 脚本 创建 这 样 的 对 象 ， 如 果 它 这 样 做 ， 他 们 将 不 会 作为 跟踪 
扩展 。) 也 注意 到 ， 当 一 个 表 可 以 是 扩展 成 员 时 ， 其 子 对 象 如 索引 不 直接 考虑 扩展 成 员 。 F 
外 重要 的 一 点 是 ， 模 式 可 以 属于 扩展 ， 但 非 反之 亦 然 : 扩展 这 样 有 一 个 不 合格 的 名 称 并 且 不 
存在 任何 模式 "内 部 "。 扩展 的 成 员 对 象 ， 然 而 ， 将 属于 模式 ， 只 要 适合 他 们 的 对 象 类 型 。 它 
可 能 或 可 能 不 适合 拥有 模式 成 员 对 象 的 一 个 扩展 。 


35.15.1. 扩展 文件 


CREATE EXTENSION 命 命 依赖 于 每 个 扩展 的 控制 文件 ， 它 必须 被 命名 为 和 带 有 .control 后 
级 的 扩展 相同 。 并 且 被 放置 在 安装 的 sHAREDIR/extension 目录 中 。 必 须 至 少 有 一 个 SQL 脚本 
文件 ， 遵循 命名 模式 _extension_ -- _version_ Sql (比如 ， 扩展 foo 的 版 


本 1.0 是 foo--1.0.sql ) 。 缺 省 ， 脚 本 文件 也 被 放置 在 shAREDIR/extension 目录 中 ; 但 是 
控制 文件 可 以 为 脚本 文件 声明 不 同 的 目录 。 


扩展 控制 文件 的 文件 格式 与 postgresql.conf 文件 相同 ， _parameter_name = value 任 
务 列表 ， 每 行 一 个 。 通 过 人 允许 # 引进 空 行 和 注释 。 确保 引用 任何 值 ， 不 是 单词 或 者 数字 。 


控制 文件 可 以 设置 以 下 参数 : 





directory ( string ) 


该 目录 包含 扩展 的 SQL 脚本 文件 。 除非 给 定 绝对 路 径 名 ， 名 字 是 相对 于 安装 的 shaer E 
录 。 默认 操作 相当 于 指定 directory = 'extension' o 


default_version ( string ) 


扩展 的 默认 版 本 (如果 在 cREATE EXTENSION 中 没有 声明 版 本 ， 则 一 个 将 被 安装 ) 。 虽然 这 可 
以 被 省 略 ， 如 果 没 有 version 选项 ， 这 将 导致 CREATE EXTENSION 失败 ， 所 以 你 通常 不 想 这 样 
做 。 


comment ( string ) 


Bo 
encoding ( string ) 


通过 脚本 文件 使 用 字符 集 编 码 。 如 果 脚 本 文件 包含 任何 非 -ASClIl 字 符 ， 则 被 声明 。 否则 这 些 
文件 被 认为 数据 库 编码 。 


module_pathname ( string ) 


RPSAN ES 为 了 每 个 发 生 在 脚本 文件 中 的 MopuLE_PATHNAME 被 替换 。 如 果 它 不 被 设置 ， 
则 没有 蔡 代 。 通 常情 况 下 ， 这 是 设置 为 $libdir/、_shared_library_name_ 并且 
MODULE_PATHNAME 在 CREATE FUNCTION 命令 中 为 C 语 言 范 数 被 使 用 ， 因此 脚本 文件 不 需要 硬 线 
共享 库 的 名 字 。 


requires ( string ) 


这 个 扩展 取决 于 扩展 名 列表 ， 比 如 requires = 'foo, bar' o 这 些 扩展 必须 在 可 以 被 安装 前 被 
安装 。 


superuser ( boolean ) 


如 果 这 个 参数 是 true 〈 缺 省 ) ， 只 有 超级 用 户 可 以 创建 扩展 或 者 更 新 它 到 一 个 新 版 本 。 如 
果 它 被 设置 为 false ， 仅 仅 需 要 安装 过 程 中 执行 命令 所 需 的 权限 或 者 更 新 脚本 。 


relocatable ( boolean ) 


如 果 扩 展 初 始 化 创建 之 后 可 能 移动 所 包含 的 对 象 到 不 同 的 模式 中 ， 则 扩展 是 浮动 的 。 缺 省 
是 false 等 ; 这 个 扩展 是 不 浮动 的 。 参见 下 文 获取 更 多 信息 。 


schema ( string ) 


这 个 参数 只 能 设置 为 非 -浮动 的 扩展 。 它 强制 扩展 被 加 载 到 精确 的 命名 模式 中 ， 并 且 没有 任何 
其 他 的 。 参 见 下 文 获取 更 多 信息 。 


除了 初步 控制 文件 _extension .control， 扩展 有 在 形式 _extension_ -- _version_ .control 中 
命名 的 二 级 控制 文件 。 如 果 被 提供 ， 这 些 必须 位 于 脚本 文件 目录 中 。 二 级 控制 文件 遵循 同 祥 
格式 作为 初步 控制 文件 。 当 安装 或 者 更 新 扩展 版 本 的 时 候 ， 在 二 级 控制 文件 中 设置 的 任何 参 
数 履 盖 初 步 控制 文件 ， 然而 ， 不 能 在 二 级 控制 文件 中 设置 参数 directory 和 


default_version o 


扩展 的 SQL 脚本 文件 可 以 包含 任何 SQL 命令 ， 除 了 事务 控制 命令 ( BEGIN, commit 等 ) 以 及 不 
能 在 一 个 事务 块 中 执行 的 命令 (比如 vacuum ) 。 这 是 因为 脚本 文件 在 事务 块 中 是 隐 式 执行 
的 。 


扩展 的 SQL 脚本 文件 也 可 以 包含 以 \echo 开头 的 行 ， 这 被 扩展 机 制 忽略 (作为 注释 ) 。 如 果 
脚本 文件 给 psdl 而 不 是 通过 CREATE EXTENSION (参见 下 文 例子 脚本 ) 被 加 载 ， 则 这 个 规定 往 
往 抛 出 错误 。 没有 那些 ， 用 户 可 能 无 意 中 加 载 扩 展 内 容 作为 "loose" 对 象 而 不 是 作为 扩展 ， 从 
中 恢复 的 事态 有 点 繁琐 。 


当 脚 本 文件 可 以 包含 指定 编码 允许 的 任何 字符 时 ， 则 控制 文件 应 该 包含 纯 ASCIl， 因为 
PostgreSQL 不 知道 控制 文件 中 的 编码 方式 。 实践 中 如 果 你 想 在 扩展 注释 中 使 用 非 -ASCI 字 
符 ， 这 个 是 一 个 问题 。 在 这 种 情况 下 推荐 做 法 是 不 使 用 控制 文件 comment 参数 ， 但 是 代替 使 


用 脚本 文件 中 的 coMMENT ON EXTENSION 设置 comment。 


35.15.2. 扩展 浮动 


用 户 通常 希望 加 载 包含 在 扩展 中 的 对 象 到 一 个 扩展 者 考虑 到 的 不 同 的 模式 中 。 有 浮动 的 三 种 
支持 级 别 。 


。 一 个 完全 可 浮动 扩展 可 移动 到 任何 时 间 下 的 另 一 个 模式 ， 即使 它 被 加 载 到 数据 库 之 后 。 
这 是 执行 了 ALTER EXTENSION SET SCHEMA PP, 它 可 以 自动 重 命名 所 有 成 员 对 象 到 新 模式 
H, 通常 情况 下 ， 这 是 唯一 可 能 的 扩展 ， 如 果 扩 展 包含 关于 任何 对 象 在 什么 模式 中 的 非 
内 部 假设 。 同时 ， 扩 展 的 对 象 都 必须 在 一 个 模式 中 (忽略 不 属于 任何 模式 的 对 象 ， 如 程 
序 语 言 ) 。 通过 设置 控制 文件 中 relocatable = true 标记 完全 的 浮动 扩展 。 


。 一 个 扩展 可 能 会 在 安装 过 程 中 被 重 定位 ， 但 不 是 之 后 。 这 是 通常 的 情况 ， 如 果 扩 展 的 脚 
本 文件 需要 参考 明确 的 目标 模式 ， 例 如 在 为 SQL 男 数 设 置 search_patn 属性 时 。 对 于 这 
种 扩展 ， 在 控制 文件 中 设置 relocatable = false, 并 且 使 用 eextschema@ 指向 脚本 文件 
中 的 目标 模式 。 在 执行 脚本 前 该 字符 串 的 所 有 出 现 将 被 实际 的 目标 模式 的 名 字 取代 。 用 
户 可 以 使 用 cREATE EXTENSION 的 scHEMA 选项 设置 目标 模式 。 


。 如 果 扩 展 不 支持 重 定位 ， 则 在 控制 文件 中 设置 relocatable = false, FHKE 
schema 到 目标 模式 名 。 这 将 防止 使 用 cREATE EXTENSION 的 schema 选项 ， 除非 指定 了 控 
制 文件 命名 的 相同 模式 。 如 果 扩 展 包含 关于 模式 名 不 能 被 eextschema@ 蔡 代 的 内 部 假 
设 ， 这 种 选择 通常 是 必要 的 。 在 这 种 情况 下 @extschema@ 蔡 代 机 制 可 用 ， 尽 管 它 是 有 限 
的 使 用 ， 因 为 模式 名 称 是 由 控制 文件 确定 的 。 


在 所 有 情况 下 ， 脚 本 文件 与 search_path 初 始 设置 指向 目标 模式 一 起 被 执行 ; 也 就 是 


说 ， CREATE EXTENSION 相当 于 : 


SET LOCAL search_path TO @extschema@; 


这 允许 通过 脚本 文件 创建 的 对 象 到 目标 模式 。 如 果 它 希望 ， 则 脚本 文件 可 以 改 

变 search_path 。 但 是 这 通常 是 不 可 取 的 ， Search_path 被 存储 到 CREATE EXTENSION 的 先前 
设置 完成 。 

如 果 它 被 给 定 ， 目 标 模式 是 由 控制 文件 中 的 schema 参数 决定 的 。 否则 

由 CREATE EXTENSION 的 SCHEMA 选项 决定 。 否则 当前 的 默认 对 象 创建 模式 (调用 

者 search_path 的 第 一 个 ) 。 当 使 用 控制 文件 schema , 如 果 它 不 存在 ， 则 创建 目标 模式 ， 
但 是 在 其 他 两 种 情况 下 ， 它 必须 已 经 存在 。 


如 果 任 何 先决 条 件 扩 展 列 在 控制 文件 的 requires 中 ， 目 标 模式 附加 到 search_path 的 初始 设 
转 中 。 这 人 允许 对 象 对 于 新 的 扩展 脚本 文件 时 可 见 的 。 

尽管 非 可 重 定位 扩展 可 以 通过 多 个 模式 包含 对 象 ， 为 了 外 部 使 用 把 所 有 的 对 象 放 到 一 个 单独 
模式 中 是 可 取 的 ， 这 被 认为 是 扩展 的 目标 模式 。 在 相关 扩展 创建 过 程 中 ， 这 样 的 安排 方 

便 search_path 的 缺 省 设置 。 


35.15.3. 扩展 配置 表 


一 些 扩 展 包含 配置 表 ， 其 中 包含 的 数据 可 能 安装 扩展 之 后 被 用 户 添加 或 更 改 。 通常 ， 如 果 一 
个 表 是 扩展 部 分 ， 既 不 是 表 的 定义 ， 也 不 是 被 pg_dump 备 份 的 内 容 ， 但 这 样 的 行为 对 配置 表 
是 不 需要 的 ; 用 户 修改 的 任何 数据 需要 包含 到 各 份 中 ， 或 各 份 和 重 载 之 后 扩展 会 有 不 同 的 表 
现 。 

为 了 解决 这 个 问题 ， 扩 展 的 脚本 文件 可 以 标记 表 ， 它 已 经 作为 配置 表 被 创建 ， 其 中 将 导致 
pg_dump 包 含 转 储 中 表 的 内 容 (不 是 定义 ) 。 要 做 到 这 一 点 ， 在 创建 表 之 后 调 


用 pg_extension_config_dump(regclass, text) , 比如 : 


CREATE TABLE my_config (key text, value text); 


SELECT pg_catalog.pg_extension_config_dump('my_config', ''); 


这 种 方式 可 以 标记 任何 数量 表 。 


x pg_extension_config_dump 的 第 二 个 参数 是 空 字符 串 时 ， 该 表 的 所 有 内 容 都 被 pg_dump 各 
份 。 如 果 表 最 初 扩 展 脚本 创建 为 空 ， 通 常 是 唯一 正确 的 。 如 果 有 一 个 初始 数据 和 用 户 表 中 提 
供 的 数据 的 混合 ， 则 pg_extension_config_dump 的 第 二 个 参数 提供 了 wer 条 件 选择 被 备份 
的 数据 。 比 如 ， 你 可 能 做 


CREATE TABLE my_config (key text, value text, standard_entry boolean); 


SELECT pg_catalog.pg_extension_config_dump('my_config', 'WHERE NOT standard_entry'); 


并 且 确 保 通 过 扩展 脚本 创建 的 行 standard_entry 为 真 。 


更 加 复杂 的 情况 ， 上 比如 初始 化 提供 的 行 可 能 通过 用 户 被 修改 ， 通 过 在 配置 表 上 创建 触发 器 被 
处 理 以 确保 正确 标记 修改 的 行 。 


你 可 以 通过 再 次 调用 pg_extension_config_dump 修改 与 配置 表 相 关 的 过 小 条 件 。 这 在 扩展 更 
新 脚本 中 通常 是 有 用 的 。 标记 表 不 再 为 配置 表 的 唯一 方法 是 从 带 
有 ALTER EXTENSION ... DROP TABLE 的 扩展 中 分 离 出 来 。 


35.15.4. 扩展 更 新 


扩展 机 制 的 一 个 优点 是 ， 它 提供 了 方便 管理 更 新 定义 一 个 扩展 对 象 的 SQL 命令 的 方式 。 这 是 
通过 将 版 本 的 名 称 或 号 链接 扩展 的 安装 脚本 的 每 个 发 布 版 本 做 到 的 。 此 外 ， 如 果 您 希望 用 户 
可 以 动态 的 从 一 个 版 本 到 下 一 个 更 新 他 们 的 数据 库 ， 你 应 该 提供 update scripts 执 行 一 个 版 本 
到 下 一 个 做 出 必要 的 改变 。 以 下 模式 _extension_ -- _oldversion_ -- _newversion_ Sql 更 新 脚 
本 的 名 字 。 (比如 ， foo--1.0--1.1.sql 使 用 命令 修改 扩展 foo 的 版 本 1.0 到 版 本 1.1) 。 


给 定 一 个 可 用 的 合适 更 新 脚本 ， 命令 ALTER EXTENSION UPDATE 将 更 新 已 安装 扩展 到 指定 的 新 
版 本 。 运行 在 相同 环境 中 的 更 新 脚本 ， CREATE EXTENSION 提供 了 安装 环境 脚本 : 特别 

是 ， search_path 以 相同 方式 进行 设置 ， 并 通过 脚本 创建 任何 新 的 对 象 被 自动 添加 到 扩展 
中 。 


如 果 扩 展 有 二 次 控制 文件 ， 控 制 参 数 用 于 与 脚本 目标 (新 ) 版 本 联系 的 更 新 脚本 。 


更 新 机 制 可 以 用 来 解决 一 个 重要 的 特殊 情况 : 将 转变 "松散 "对 象 的 集合 到 一 个 扩展 。 在 扩展 
机 制 被 添加 到 PostgreSQL(9.1 中 ) 之 前 ， 许多 人 写 的 扩展 模块 简化 了 已 创建 的 各 式 各 样 的 未 包 
装 的 对 象 。 给 定 包含 这 样 对 象 的 现 有 数据 库 ， 我 们 怎么 能 转换 对 象 到 适当 成 套 扩展 ? 删除 它 
们 然后 执行 纯 CREATE EXTENSION 是 一 种 方式 ， 但 它 不 是 可 取 的 ， 如 果 对 象 有 依赖 关系 ( 例 
如 ， 如 果 有 扩展 创建 的 数据 类 型 的 表 列 ) 。 修复 这 种 情况 的 方式 是 创建 一 个 空 的 扩展 ， 然 后 
使 用 ALTER EXTENSION ADD 把 每 个 预先 存在 的 对 象 附属 在 扩展 中 ， 最 后 在 当前 扩展 版 本 中 创 
建 任何 新 的 对 象 ， 但 不 在 未 包装 发 布 中 。 CREATE EXTENSION 支持 带 有 FROM 

_old_version 选项 的 情况 。 这 导致 它 不 运行 目标 版 本 的 正常 安装 脚本 ， 而 是 更 新 脚本 命名 


_extension_ -- _old_version_ -- _target_version_ .Sql。 虚拟 版 本 名 称 选 择 使 
用 _old_version. 胜任 扩展 发 起 者 ， 尽管 未 包装 是 一 种 常见 的 公约 。 如 果 你 有 多 个 以 前 的 版 
本 ， 你 需要 能 够 更 新 扩展 风格 ， 使 用 多 个 虚拟 版 本 名 称 来 识别 它们 。 


ALTER EXTENSION 能 够 执行 更 新 脚本 文件 序列 以 实现 请 求 更 新 。 例 如 ， 如 果 只 有 
foo--1.0--1.1.sql 和 foo--1.1--2.0.sql 可 用 ， 当 目 前 安装 的 是 1.0 时 ， 如 果 需 要 更 新 到 版 
本 2.0, ALTER EXTENSION 将 在 序列 中 应 用 它们 。 


PostgreSQL 不 假定 任何 有 关 版 本 名 称 的 属性 : 例如 ， 它 不 知道 1.1 遵循 1.00 它 只 匹配 可 
用 的 版 本 名 称 并 且 遵循 路 径 要 求 应 用 最 新 的 更 新 脚本 。 《一 个 版 本 的 名 称 可 以 是 不 包含 
-- 或 前 导 或 尾随 - 的 任意 字符 串 。 ) 


有 时 提供 "downgrade" 脚 本 是 非常 有 用 的 ， 例如 foo--1.4--1.0.sql 人 允许 恢复 与 版 本 1.1 相关 
的 变化 。 如 果 你 这 样 做 了 ， 小 心 downgrade 脚 本 可 能 会 意外 地 因 它 产生 一 个 较 短 的 路 径 而 得 
以 应 用 的 可 能 性 。 风险 情况 下 有 一 个 "快速 路 径 " 更 新 脚本 ， 向 前 跳 几 个 版 本 以 及 降级 脚本 到 
快速 路 径 的 起 点 。 这 可 能 需要 较 少 的 步骤 应 用 降级 ， 然 后 快速 路 径 向 前 一 次 移动 一 个 版 本 。 
如 果 降 级 脚本 删除 任何 不 可 替代 的 对 象 ， 这 将 产生 不 良 的 结果 。 


为 了 检查 意外 的 更 新 路 径 ， 使 用 这 个 命令 : 


SELECT * FROM pg_extension_update_paths('_extension_name_'); 


这 显示 了 已 指定 扩展 的 每 对 不 同 已 知 的 版 本 名 称 ， 以 及 更 新 路 径 序列 将 采取 从 源 版 本 到 目标 
版 本 ， 或 者 如 果 没 有 可 用 的 更 新 路 径 ， 则 为 NULL 。 BRA -- 分 隅 符 的 文本 形式 显 
Fo 如 果 你 喜欢 数组 形式 ， 则 可 以 使 用 regexp_split_to_array(path, '--') o 


35.15.5. 扩展 实例 


这 是 一 个 SQL 扩展 的 完整 实例 ， 二 元 复合 类 型 可 以 存储 插 槽 中 的 任何 类 型 的 值 ， 被 命名 
为 "K" 和 "V"。 非 -文本 值 自动 强制 转换 为 文本 存储 。 


脚本 文件 pair--1.0.sql 看 起 来 像 : 


-- complain if script is sourced in psql, rather than via CREATE EXTENSION 
\echo Use "CREATE EXTENSION pair" to load this file. \quit 


CREATE TYPE pair AS ( k text, v text ); 


CREATE OR REPLACE FUNCTION pair(anyelement, text) 
RETURNS pair LANGUAGE SQL AS 'SELECT ROW($1, $2)::pair'; 


CREATE OR REPLACE FUNCTION pair(text, anyelement) 
RETURNS pair LANGUAGE SQL AS 'SELECT ROW($1, $2)::pair'; 


CREATE OR REPLACE FUNCTION pair(anyelement, anyelement) 
RETURNS pair LANGUAGE SQL AS 'SELECT ROW($1, $2)::pair'; 


CREATE OR REPLACE FUNCTION pair(text, text) 
RETURNS pair LANGUAGE SQL AS 'SELECT ROW($1, $2)::pair;'; 


CREATE OPERATOR ~> (LEFTARG 
CREATE OPERATOR ~> (LEFTARG 
CREATE OPERATOR ~> (LEFTARG 
CREATE OPERATOR ~> (LEFTARG 


text, RIGHTARG = anyelement, PROCEDURE = pair); 
anyelement, RIGHTARG = text, PROCEDURE = pair); 
anyelement, RIGHTARG = anyelement, PROCEDURE = pair); 
text, RIGHTARG = text, PROCEDURE = pair); 


控制 文件 pair.control 看 起 来 像 : 


# pair extension 

comment = 'A key/value pair data type' 
default_version = '1.0' 

relocatable = true 


当 你 几乎 不 需要 makefile 安 装 这 两 个 文件 到 正确 目录 时 ， 你 可 以 使 用 包含 下 面 内 容 
的 Makefile 

EXTENSION = pair 

DATA = pair--1.0.sql 

PG_CONFIG = pg_config 


PGXS := $(shell $(PG_CONFIG) --pgxs) 
include $(PGXS) 


这 个 makefile 依 赖 于 PGXS， 在 Section 35.16 中 描述 。 命令 make install 将 安装 控制 和 脚本 
文件 到 正确 目录 ， 通 过 pg_config 报告 。 


一 旦 安装 了 这 些 文件 ， 使 用 CREATE EXTENSION 命 令 加 载 对 象 到 任何 特定 数据 库 。 


35.16. 扩展 基础 设施 建设 


如 果 你 正在 考虑 分 配 你 的 PostgreSQL 的 扩展 模块 ， 为 它们 设置 便携 式 编译 系统 相当 困难 。 
因此 PostgreSQL 安 装 提供 了 一 个 构建 基础 设施 的 扩展 ， 称 为 PGXS， 所 以 这 个 简单 的 扩展 模 
块 可 以 在 已 安装 的 服务 器 上 简单 编译 。 PGXS 的 主要 目的 是 为 了 包含 C 代 码 的 扩展 ， 虽然 它 
也 可 以 用 于 纯 SQL 扩 展 。 注意 : PGXS 不 打算 作为 一 个 通用 编译 系统 框架 ， 可 用 于 构建 任何 
软件 接口 到 PostgreSQL ; 它 只 是 为 了 简单 的 服务 器 扩展 模块 自动 化 公共 建立 规则 。 对 于 更 
复杂 的 软件 包 ， 您 可 能 需要 写 入 自己 的 构建 系统 。 

为 了 您 的 扩展 使 用 PGXS 设 施 ， 你 必须 写 一 个 简单 的 makefile。 在 makefile 中 ， 你 需要 设置 一 
些 变量 并 且 最 后 包括 全 局 PGXS makefile, 下 面 是 一 个 例子 ， 建 立 一 个 isbn_issn 命名 的 扩 
展 模块 ， 由 包含 一 些 C 人 代码， 扩展 的 控制 文件 ，SQL 脚 本 ， 和 文本 文件 的 共享 库 组 成 : 


MODULES = isbn_issn 
EXTENSION = isbn_issn 
DATA = isbn_issn--1.0.sql 
DOCS = README.isbn_issn 


PG_CONFIG = pg_config 
PGXS := $(shell $(PG_CONFIG) --pgxs) 
include $(PGXS) 
最 后 三 行 总 是 相同 的 。 早 在 文件 中 ， 你 可 以 指定 变量 或 者 添加 自 定义 make 规则 。 
设置 这 三 个 变量 之 一 指定 建立 什么 : 
MODULES 
从 源 文件 同一 地 方 编译 共享 库 对 象 列表 (不 包括 列表 中 的 库 后 级 ) 
MODULE_big 
从 多 个 源 文件 构建 共享 库 (在 oss 中 列 出 对 象 文件 ) 
PROGRAM 
建立 可 执行 程序 (在 oss 中 列 出 对 象 文件 ) 
下 面 的 变量 也 可 以 设置 : 
EXTENSION 


扩展 名 : 对 于 每 一 个 名 字 你 必须 提供 一 个 _extension_ .control 文件 ， 它 将 被 安装 
到 _prefix_ /share/extension 中 。 
MODULEDIR 


DATA 和 DOCS 文 件 应 该 被 安装 到 _prefix_ /share 子 目 录 中 (如果 没 有 设置 ， 如 果 设 


i& EXTENSION, WAE extension 。 如 果 没 有 则 为 contrib) o 


DATA 


随机 文件 安装 到 _prefix_ /share/$MODULEDIR. 

DATA_built 

随机 文件 安装 到 _prefix_ /share/$MODULEDIR, 这 首先 需要 编译 。 
DATA_TSEARCH 

随机 文件 安装 到 _prefix_ /share/tsearch_data#. 


DOCS 


随机 文件 安装 到 _prefix_ /doc/$MODULEDIR 


SCRIPTS 


脚本 文件 ( 非 二 进 制 数 ) 安装 到 _prefix_ /bin 中 

SCRIPTS_built 

脚本 文件 〈 非 二 进 制 数 ) 安装 到 _prefix_ /bin， 这 需要 首先 编译 。 
REGRESS 

回归 测试 用 例 列 表 (没有 后 级 ) ， 参 见 下 文 。 

REGRESS_OPTS 

另外 切换 到 pg_regress 

EXTRA_CLEAN 


make clean 中 删除 额外 文件 


PG_CPPFLAGS 


被 添加 到 cppFLAGS 
PG_LIBS 

被 添加 到 PRoGRAM 连接 线 
SHLIB_LINK 


被 添加 到 MopuLE_big 连接 线 


PG_CONFIG 


为 了 PostgreSQL 安 装 编译 其 路 径 指向 pg_config 应 用 程序 (通常 pg_config 使 用 你 的 PATH 中 
的 第 一 个 ) 。 


把 这 个 makefile 作 为 Makefile 放 在 持 有 你 的 扩展 的 目录 中 。 然后 你 可 以 执行 make 编译 ， 然 
后 make install 安装 模块 。 默 认 情况 下 ， 为 PostgreSQL 对 应 于 你 的 PATH 中 找到 的 第 一 
个 pg_config 程序 扩展 被 编译 安装 。 你 可 以 通过 设置 P6_coNFi6 指向 pg_config 程序 来 使 用 


一 个 不 同 的 安装 ， 或 者 在 makefile 中 或 在 make MPTE. 


Caution 


当 编译 PostgreSQL 8.3 或 更 高 版 本 时 ， 改变 P6_coNFIG6 。 老 版 本 不 工作 设置 它 除 
了 pg_config ; 你 必须 改变 你 的 PATH 来 选择 编译 安装 。 


在 REGRESS 变量 中 列 出 的 脚本 用 于 你 的 模块 的 回 为 测试 ， 这 可 以 在 执行 make install 之 后 通 
过 make installcheck 调用 。 为 了 可 以 运行 你 必须 有 一 个 运行 的 PostgreSQL 服 务 器 。 
在 REGRESS 中 的 脚本 文件 必须 出 现在 您 的 扩展 目录 中 的 sql/ 命名 的 子 目录 中 。 这 些 文件 必 
须 有 扩展 .sql ， 这 没有 包含 在 makefile 列 出 的 recress 中 。 每 个 测试 还 应 在 expected/ 命 
名 的 子 目录 中 包含 一 个 预期 的 输出 文件 ， 以 及 相同 的 词 干 和 扩展 .out 。 
make installcheck 执行 每 个 psql 的 测试 脚本 ， 并 且 上 比较 结果 输出 到 匹配 期 望 的 文件 。 任何 差 
FREA diff -c 格式 的 文件 regression.diffs 中 。 请 注意 ， 试 图 运行 一 个 测试 ， 缺 少 预期 
的 文件 将 被 作为 "问题 "报告 ， 所 以 确保 你 有 所 有 预期 的 文件 。 
Tip: 创造 期 望 文件 的 最 简单 的 方法 是 创建 空 文件 ， 然后 做 一 个 测试 运行 (这 当然 会 报告 
异 ) 。 检 查 在 results/ 目录 中 发 现 的 实际 结果 文件 ， 如 果 匹 配 从 这 个 试验 中 你 期 望 
的 ， 那么 将 它们 复制 到 expected/ 。 


Chapter 36. 触发 器 


Table of Contents 


。 36.1. 触发 器 行为 概述 
36.2. 数据 改变 的 可 视 性 

e 36.3. 用 C 写 触发 器 

。 36.4. 一 个 完整 的 触发 器 例子 


本 章 提供 有 关 书 写 触 发 器 函数 的 一 般 信 息 。 触发 器 男 数 可 以 用 大 多 数 过 程 语言 书 宇 ， 包括 
PL/pgSQL (Chapter 40), PL/Tcl (Chapter 41), PL/Perl (Chapter 42) 和 PL/Python (Chapter 
43)。 a 你 应 该 参考 你 喜欢 的 过 程 语言 的 章节 ， 找 出 使 用 这 些 语言 书写 触发 
器 的 一 些 语言 相关 的 细节 。 


也 可 以 用 C 来 写 触 发 器 ， 不 过 大 多 数 人 都 会 觉得 使 用 某 种 过 程 语 言 书写 更 简单 。 目前 还 不 能 
用 简 单 的 SQL BMS A + BARR ae 


36.1. 触发 器 行为 概述 


一 个 触发 器 是 一 种 声明 ， 告 诉 数据 库 应 该 在 执行 特定 的 操作 的 时 候 执行 特定 的 画 数 。 触发 器 
可 以 附加 到 表 和 视图 上 。 


触发 器 可 以 定义 在 一 个 INSERT, UPDATE , OF DELETE 命令 之 前 或 者 之 后 执行 ， 要 么 是 对 每 行 
执行 一 次 ， 要 么 是 对 每 条 SQL 语句 执行 一 次 。 如 果 某 列 在 upPpATE 语句 的 ser 子 句 中 被 提 
及 ， 则 UPDATE 触发 器 再 次 被 触发 。 触发 器 可 以 为 truncate 语句 触发 。 如 果 发 生 触 发 器 事 
件 ， 那 么 将 在 合适 的 时 刻 调用 触发 器 函数 以 义理 该 事件 。 


在 视图 上 ， 触 发 器 可 以 被 定义 执行 而 不 是 INSERT ，UPDATE 或 者 DELETE 操作 。 为 了 需要 在 视 
图 中 修改 的 每 一 行 触发 INSTEAD oF 触发 器 。 这 是 触发 器 汞 数 在 基 表 下 执行 必要 修改 的 责任 ， 
并 且 在 适当 情况 下 ， 返 回 在 视图 中 出 现 的 修改 的 行 。 在 执行 每 个 SQL 语句 ， INSERT ， 
UPDATE 或 者 DELETE 操作 之 前 或 之 后 也 可 以 定义 视图 上 的 触发 器 。 


触发 器 函数 必须 在 创建 触发 器 之 前 ， 作 为 一 个 没有 参数 并 且 返 回 trigger KPA WME. 
触发 器 函数 通过 特殊 的 Triggerpata 结构 接收 其 输入 ， 而 不 是 用 普通 的 画 数 参数 方式 。 


一 且 创 建 了 一 个 合适 的 触发 器 函数 ， 就 可 以 用 CREATE TRIGGER 创 建 触 发 器 。 同一 个 触发 
器 画 数 可 以 用 于 多 个 触发 器 。 


PostgreSQL 提 供 按 行 与 按 语句 触发 的 触发 器 。 按 行 触发 的 触发 器 图 数 为 触发 语句 影响 的 每 一 
行 执行 一 次 ; 相 比 之 下 ， 按 语句 触发 的 触发 器 画 数 为 每 条 触发 语句 执行 一 次 ， 而 不 管 影响 的 
行 数 。 特别 是 ， 一 个 影响 需 行 的 语句 将 仍然 导致 按 语句 触发 的 触发 器 执行 。 这 两 种 类 型 的 触 
发 器 有 时 候 分 别 叫做 行 级 触发 器 和 语句 级 触发 器 。 在 TRUNCATE 上 的 触发 器 可 能 只 能 在 语句 级 
别 定 义 。 触发 之 前 或 之 后 的 视图 ， 触 发 器 只 能 在 语句 级 别 定义 ， 然而 非 INSERT, UPDATE 或 
者 DELETE 触发 的 触发 器 在 行 级 别 定 义 。 


触发 器 通常 按照 触发 的 before 和 after， 或 者 instead of 操作 进行 分 类 。 这 些 分 别 被 称 
为 BEFORE 触发 器 ， AFTER 触发 器 ， INSTEAD OF 触发 器 。 语句 级 别 的 BEFORE 触发 器 通常 在 
语句 开始 做 任何 事情 之 前 触发 ， 而 语句 级 别 的 AFTER 触发 器 在 语句 结束 时 触发 。 触发 器 的 这 
些 类 型 可 以 在 表 或 者 视图 上 定义 。 行 级 别 的 BEFoRE 触发 器 在 对 特定 行进 行 操 作 之 前 触发 ， 
而 行 级 别 的 AFTER 触发 器 在 语句 结束 的 时 候 触 发 (但 是 在 任何 语句 级 别 的 AFTER 触发 器 之 
前 )。 触发 器 的 这 些 类 型 可 能 只 在 表 上 定义 。 行 级 别 INSTEAD OF 触发 器 可 能 只 在 视图 上 定 
L, 并 且 立 刻 触发 作为 视图 上 的 每 一 行 被 标识 为 需要 的 操作 。 
按 语句 触发 的 触发 器 应 该 总 是 返回 NuLL 。 如 果 必 要 ， 按 行 触 发 的 触发 器 画 数 可 以 给 调用 它 
的 执行 者 返回 一 行 数据 (一 个 类 型 为 HeapTuple 的 数值 )， 那些 在 操作 之 前 触发 的 触发 器 有 以 
下 选择 : 

e 它 可 以 返回 NuLL 以 忽略 对 当前 行 的 操作 。 这 就 指示 执行 器 不 要 执行 调用 该 触发 器 的 行 

级 别 操作 (对 特定 行 的 插入 或 者 更 改 )。 


e 只 用 于 insert 和 UPDATE 行 触发 器 : 返回 的 行将 成 为 被 插入 的 行 或 者 是 成 为 将 要 更 新 的 
行 。 这 样 就 允许 触发 器 画 数 修改 将 要 被 插入 或 者 更 新 的 行 。 


一 个 无 意 导致 任何 这 类 行为 的 在 操作 之 前 触发 的 行 级 触发 器 必须 仔细 返回 那个 被 当 作 新 行 传 
进来 的 行 。 也 就 是 说 ， 对 于 insert 和 UPDATE 触发 器 而 言 ， 是 NEw 行 ， 对 于 DELETE 触发 器 


Āā, Æ oD 行 。 


=) 


行 级 别 INSTEAD OF 触发 器 应 该 返回 NuLL 表示 它 不 修改 来 自视 图 的 基础 表 的 任何 数据 ， Cw 
该 返回 传递 到 ( INSERT 和 UPDATE 的 new 行 ， 或 者 DELETE 操作 的 olo 行 ) 的 视图 行 。 非 空 
返回 值 用 于 发 信号 ， 使 触发 器 执行 视图 中 必要 的 数据 修改 。 这 将 导致 计算 通过 这 个 命 全 递增 
的 受 影响 的 行 数 。 对 于 insert 和 UPDATE 操作 ， 触 发 器 可 能 在 返回 它 之 前 修改 new 行 。 这 

将 改变 通过 INSERT RETURNING 或 者 UPDATE RETURNING 返回 的 数据 。 并 且 当 视图 不 能 完全 显示 
所 提供 的 同一 数据 时 是 有 用 的 。 


对 于 在 操作 之 后 触发 的 行 级 触发 器 ， 其 返回 值 会 被 忽略 ， 因 此 可 以 返回 wut o 


如 果 多 于 一 个 触发 器 为 同样 的 事件 定义 在 同样 的 关系 上 ， 触发 器 将 按照 名 字 的 字母 顺序 触 
Ro TE BEFORE 和 INSTEAD oF 触发 器 的 情况 下 ， 每 个 触发 器 返回 的 可 能 已 经 被 修改 过 的 行 成 
为 下 一 个 触发 器 的 输入 。 如 果 BEFoRE 或 者 INSTEAD oF 触发 器 返回 nul, 那么 对 该 行 的 操 
作 将 被 丢弃 并 且 随 后 的 触发 器 也 不 会 被 触发 。 


一 个 触发 器 定义 也 可 以 声明 一 个 布尔 型 的 whEN 条 件 ， 用 于 检查 触发 器 是 否 应 该 被 触发 。 在 
行 级 别 触发 器 上 ， wen 条 件 可 以 检查 旧 和 /或 新 的 列 值 。 语 句 级 的 触发 器 也 可 以 有 wHEN 条 
t, 尽管 对 其 没有 用 。 在 一 个 BEFoRE 触发 器 中 ， wHEN 条 件 只 在 函数 正在 或 将 被 执行 之 前 被 
触发 执行 ， 因此 使 用 wen 条 件 实际 上 和 与 在 触发 器 开始 时 执行 相同 条 件 的 结果 是 一 样 的 。 然 
m, 在 一 个 AFTER 触发 器 中 ， wen 条 件 只 有 在 发 生 更 新 行 时 才 会 执行 ， 并 且 决 定 在 语句 结 
束 之 后 ， 一 个 事件 是 否 需要 等 待 触发 触发 器 。 因 此 当 一 个 AFTER 触发 器 的 whEN 条 件 没 有 返 
OA, 队列 中 的 时 间 不 需要 在 语句 结束 后 重新 读 取 行 。 如 果 触 发 器 只 会 被 一 些 行 触发 时 ， 
INSTEAD OF 触发 器 不 支持 wen 条 件 。 


通常 ， 行 的 BEFORE 触发 器 用 于 检查 或 修改 将 要 插入 或 者 更 新 的 数据 。 比如， 一 个 BEFORE AA 
发 器 可 以 用 于 把 当前 时 间 插 入 一 个 timestamp 字段 ， 或 者 跟踪 该 行 的 两 个 元 素 是 一 致 的 。 行 
的 AFTER 触发 器 多 数 用 于 填充 或 者 更 新 其 它 表 ， 或 者 对 其 它 表 进行 一 致 性 检查 。 这 么 区 分 工 
作 的 原因 是 AFTER 触发 器 肯定 可 以 看 到 该 行 的 最 后 数值 ， 而 BEFORE 触发 器 不 能 ; 还 可 能 

其 它 的 BEFORE 触发 器 在 其 后 触发 。 如 果 你 没有 具体 的 原因 定义 触发 器 是 BEFORE 或 者 

AFTER ， 那么 BEFORE 触发 器 的 效率 高 些 ， 因为 操作 相关 的 信息 不 必 保 存 到 语句 的 结尾 。 


如 果 一 个 触发 器 本 数 执行 SQL 命 舍 ， 而 这 些 命令 再 次 触发 触发 器 ， 这 就 是 所 谓 的 级 联 触发 
器 。 对 级 联 触发 器 的 级 联 深度 没有 明确 的 限制 。 有 可 能 出 现 级 联 触发 器 导致 同一 个 触发 器 递 
为 调用 的 情况 ; 比如 ， 一 个 insert 鲁 发 器 可 能 执行 一 个 命令， 把 一 个 额外 的 行 插 入 同一 个 
FA, 导致 Insert 触发 器 再 次 触发 。 避免 这 样 无 穷 递 及 的 问题 是 触发 器 程序 员 的 责任 。 


在 定义 一 个 触发 器 的 时 候 ， 可 以 声明 一 些 参数 。 在 触发 器 定义 中 包含 参数 的 目的 是 允许 类 似 
需求 的 不 同 触发 器 调用 同一 个 函数 。 比如 ， 可 能 有 一 个 通用 的 触发 器 画 数 ， 接 受 两 个 字段 名 
字 ， 把 当前 用 户 放 在 第 一 个 ， 而 当前 时 间 惟 在 第 二 个 。 只 要 写 得 恰当 ， 那么 这 个 触发 器 函数 
就 可 以 和 触发 它 的 特定 表 无 关 。 这 样 同 一 个 画 数 就 可 以 用 于 有 着 合适 字段 的 任何 表 

的 INSERT 事件 ， 实现 自动 跟踪 交易 表 中 的 记录 创建 之 类 的 问题 。 如 果 定 义 成 一 个 uPDATE AR 
发 器 ， 还 可 以 用 它 跟踪 最 后 更 新 的 事件 。 


每 种 支持 触发 器 的 编程 语言 都 有 自己 的 方法 让 触发 器 画 数 得 到 输入 数据 。 这 些 输 入 数据 包括 
触发 器 事件 的 类 型 (比如 Insert 或 者 UPDATE ) 以 及 所 有 在 cREATE TRIGGER 里 面 列 出 的 参数 。 
对 于 低层 次 的 触发 器 ， 输入 数据 也 包括 insert 和 uppate 触发 器 的 new 和 / 

或 UPDATE 和 DELETE 触发 器 的 oLD 行 。 语句 级 别 的 触发 器 目前 没有 任何 方法 检查 该 语句 修改 
的 独立 行 。 


36.2. 数据 改变 的 可 视 性 


如 果 在 触发 器 函数 里 执行 SQL 命令 ， 并 且 这 些 命令 访问 触发 器 所 在 的 表 ， 那么 你 必须 知道 触 
发 器 的 可 视 性 规则 ， 因为 这 些 规则 决定 这 些 SQL 命 令 是 否 能 看 到 触发 触发 器 的 数据 改变 。 简 
单 说 : 
e 语句 级 别 的 触发 器 遵循 简单 的 可 视 性 原则 : 在 语句 之 前 (before) 触 发 的 触发 器 看 不 到 语句 
所 做 的 修改 ， 而 所 有 修改 都 可 以 被 AFTER 语句 级 别 触发 的 触发 器 看 到 。 


。 导致 触发 器 触发 的 数据 改变 (插入 、 更 新 、 删 除 ) 通 常 是 不 能 被 一 个 BEFoRE 触发 器 里 面 执 
行 的 SQL 命令 看 到 的 ， 因 为 它 还 没有 发 生 。 


e 不 过 ， 在 BEFORE 触发 器 里 执行 的 SQL 命令 将 能 够 看 到 在 同一 个 外 层 命 邻 前 面 多 理 的 行 的 
改变 。 这 一 点 需要 仔细 ， 因 为 这 些 改变 的 顺序 通常 是 不 可 预期 的 ; 一 个 影响 多 行 的 SQL 
命令 可 能 以 任意 顺序 访问 这 些 行 。 

e 同样 的 ， 行 级 别 INSTEAD oF 触发 器 将 看 到 通过 先前 同一 外 部 命令 触发 的 INSTEAD oF ik 
发 器 形成 的 数据 变化 的 影响 。 

© 在 一 个 行 级 AFTER 触发 器 被 触发 的 时 候 ， 所 有 外 层 命令 产生 的 数据 改变 都 已 经 完成 ， 对 
于 触发 的 触发 器 画 数 是 可 见 的 。 


如 果 是 用 任何 一 种 标准 过 程 语言 写 的 触发 器 玉 数 ， 那么 只 有 当 辑 数 声明 了 voLATILE FS 
上 面 的 语句 。 声明 了 sTABLE 或 者 IMMuTABLE 的 函数 在 任何 情况 em 
改变 。 


有 关 数 据 可 视 性 规则 的 更 多 信息 可 以 在 Section 44.4 找 到 。 Section 36.4 里 的 例子 包含 这 些 规 
则 的 演示 。 


36.3. AACS AR & as 


本 章 描述 触发 器 函数 的 低层 细节 。 只 有 当 你 用 C 书 写 触 发 器 函数 的 时 候 才 需要 这 些 信 息 。 如 
果 你 用 某 种 高 级 语言 写 触 发 器 ， ee 在 大 多 数 情况 下 ， 你 在 书 
写 自 己 的 C 触 发 器 之 前 应 该 考虑 使 用 过 程 语言 。 每 种 过 程 语言 的 文档 里 面 都 有 关于 如 何 用 该 
语言 书写 触发 器 的 解释 。 


触发 器 函数 必须 使 用 "version 1 人" 的 函数 管理 器 接口 。 


一 个 函数 被 触发 器 管理 器 调用 时 ， 它 不 会 收 到 任何 普通 参数 ， 而 是 收 到 一 个 指 
向 TriggerData 结构 的 "context" 指 针 。 CHALA] Lia 过 执行 下 面 的 宏 来 检查 它们 是 否 是 从 触发 
器 管理 器 调用 的 


CALLED_AS_TRIGGER(fcinfo) 


扩展 到 : 


((fcinfo)->context != NULL && IsA((fcinfo)->context, TriggerData)) 


如 果 此 宏 返 回 真 (TRUE)， 则 可 以 安全 地 把 fcinfo-&gt;context 转换 成 Triggerpata* 类 型 ， 
然后 使 用 这 个 指向 Triggerpata 的 结构 。 男 数 本 身 绝 不 能 更 改 Triggerpata 结构 或 者 它 指 向 
的 任何 数据 。 


struct TriggerData 是 在 commands/trigger.h 中 被 定义 的 : 


typedef struct TriggerData 


NodeTag type; 
TriggerEvent tg_event; 
Relation tg_relation; 
HeapTuple tg_trigtuple; 
HeapTuple tg_newtuple; 
Trigger *tg_trigger; 
Buffer tg_trigtuplebuf ; 
Buffer tg_newtuplebuf ; 


} TriggerData; 


这 些 成 员 的 定义 如 下 : 
type 
总 是 T_TriggerData o 


tg_event 


描述 调用 函数 的 事件 。 你 可 以 用 下 面 的 宏 检查 tg_event : 


TRIGGER_FIRED_BEFORE(tg_event ) 


如 果 触 发 器 是 在 操作 前 触发 ， 返 回 真 。 
TRIGGER_FIRED_AFTER(tg_event) 
如 果 触 发 器 是 在 操作 后 触发 ， 返 回 真 。 


TRIGGER_FIRED_INSTEAD(tg_event ) 


如 果 触 发 器 触发 了 相反 的 操作 ， 返 回 真 。 


TRIGGER_FIRED_FOR_ROW(tg_event) 





如 果 触 发 器 是 行 级 别 事件 触发 ， 返 回 真 。 
TRIGGER_FIRED_FOR_STATEMENT(tg_event ) 
如 果 触 发 器 是 语句 级 别 事件 触发 ， 返 回 真 。 


TRIGGER_FIRED_BY_INSERT(tg_event ) 


如 果 触 发 器 是 由 Insert 触发 ， 返 回 真 。 


TRIGGER_FIRED_BY_UPDATE(tg_event ) 


如 果 触 发 器 是 由 uppATE 触发 ， 返 回 真 。 


TRIGGER_FIRED_BY_DELETE(tg_event ) 


如 果 触 发 器 是 由 DELETE 触发 ， 返 回 真 。 


TRIGGER_FIRED_BY_TRUNCATE(tg_event ) 


如 果 触 发 器 是 由 TRUNCATE 命令 触发 ， 返 回 真 。 


tg_relation 


是 一 个 指向 描述 被 触发 的 关系 的 结构 的 指针 。 请 参考 utils/rel.h 获取 关于 此 结构 的 详细 信 
息 。 最 让 人 感 兴趣 的 事情 是 tg_relation-&gt;rd_att (关系 行 的 描述 ) 

和 tg_relation-&gt;rd_rel-&gt;relname (关系 名 。 这 个 变量 的 类 型 不 是 char* 而 

是 Namepata 。 如 果 你 需要 一 份 名 字 的 拷贝 ， 用 spr_getrelname(tg_relation) 获取 char* )。 


tg_trigtuple 
是 一 个 指向 触发 触发 器 的 行 的 指针 。 RE -MIECEREBA(INSERT), IBR(DELETE), E 


新 (UPDATE) 的 行 。 如 果 是 INSERT 或 者 DELETE ， 如 果 你 不 想 用 另 一 条 行 履 盖 此 行 
(就 INSERT 来 说 ) 或 忽略 操作 ， 那么 这 就 是 你 将 从 函数 返回 的 东西 。 


tg_newtuple 
如 果 是 uppATE ， 这 是 一 个 指向 新 版 本 的 行 的 指针 ， 如 果 是 INSERT 或 者 DELETE, N) 


是 NULL 。 如 果 事 件 是 oar 并 且 你 不 想 用 另 一 条 行 蔡 换 这 条 行 或 忽略 操作 的 话 ， 这 就 是 你 
将 从 画 数 返回 的 东西 。 


tg_trigger 


是 一 个 指向 结构 Trigger 的 指针 ， 该 结构 在 utils/reltrigger.h 里 定义 : 


typedef struct Trigger 


Oid tgoid; 
char *tgname; 
Oid tgfoid; 
int16 tgtype; 
char tgenabled; 
bool tgisinternal; 
Oid tgconstrrelid; 
Oid tgconstrindid; 
Oid tgconstraint; 
bool tgdeferrable; 
bool tginitdeferred; 
int16 tgnargs; 
int16 tgnattr; 
int16 *tgattr; 
char **tgargs; 
char *tgqual; 

} Trigger; 


tgname 是 触发 器 的 名 称 ， tgnargs 是 在 tgargs 里 参数 的 数量 ， tgargs 是 一 个 指针 数组 ， 
数组 里 每 个 指针 指向 在 create TRIGGER 语句 里 声明 的 参数 。 其 它 成 员 只 在 内 部 使 用 。 


tg_trigtuplebuf 

如 果 没 有 这 样 的 元 组 或 者 没有 存储 在 磁盘 缓冲 区 里 ， 则 是 包含 tg_trigtuple 或 
者 InvalidBuffer 的 缓冲 区 。 

tg_newtuplebuf 


如 果 没 有 这 样 的 元 组 或 者 它 并 未 存储 在 磁盘 缓冲 区 里 ， 那么 就 是 包含 tg_newtuple 或 
者 InvalidBuffer 的 缓冲 区 。 


一 个 触发 器 范 数 必须 返回 一 个 HeapTuple 指针 或 者 一 个 NULL 指针 (_ 不 是 SQL 的 NULL 值 ， 也 
就 是 说 不 要 设置 isull HB), 请 注意 如 果 你 不 想 修 改正 在 被 操作 的 行 ， 那 么 要 根据 情况 返 
回 tg_trigtuple 或 者 tg_newtuple 。 


36.4. 一 个 完整 的 触发 器 例子 
这 里 是 一 个 用 C 写 的 非常 简单 的 触发 器 例子 。 (用 程序 语言 写 的 触发 器 例子 可 以 在 程序 语言 文 
档 中 找到 ) 。 


PRM trigf 报告 ttest 表 的 行 数量 ， 并 且 如 果 命令 试图 把 NULL 插 和 人 到 字段 x 里 (也 就 是 它 
做 为 一 个 非 空 约束 但 不 退出 事务 ) 时 略 过 操作 。 


首先 ， 表 定义 : 


CREATE TABLE ttest ( 
x integer 


i 


这 里 是 触发 器 图 数 的 源 代码 : 


#include "postgres.h" 


#include "executor/spi.h" /* 你 用 SPI 的 时 候 要 用 的 头 文件 */ 
#include "commands/trigger.h" /* ... 触发 器 ... */ 
#include "utils/rel.h" BP non alesis “Y/ 


#ifdef PG_MODULE_MAGIC 
PG_MODULE_MAGIC; 
#endif 


extern Datum trigf(PG_FUNCTION_ARGS); 
PG_FUNCTION_INFO_V1(trigf); 


Datum 

trigf(PG_FUNCTION_ARGS) 

{ 
TriggerData *trigdata = (TriggerData *) fcinfo->context; 
TupleDesc tupdesc; 
HeapTuple rettuple; 


char *when; 

bool checknull = false; 
bool isnull; 

int ret, i; 


/* 确信 自己 是 作为 触发 器 调用 的 */ 
if (!CALLED_AS_TRIGGER(fcinfo) ) 
elog(ERROR, "trigf: not called by trigger manager"); 


/* 返回 给 执行 者 的 行 */ 

if (TRIGGER_FIRED_BY_UPDATE(trigdata->tg_event) ) 
rettuple = trigdata->tg_newtuple; 

else 
rettuple = trigdata->tg_trigtuple; 


/* 检查 NULL 值 */ 

if (!TRIGGER_FIRED_BY_DELETE(trigdata->tg_event) 
&& TRIGGER_FIRED_BEFORE(trigdata->tg_event) ) 
checknull = true; 


if (TRIGGER_FIRED_BEFORE(trigdata->tg_event)) 
when = "before"; 

else 
when = "after "; 


tupdesc = trigdata->tg_relation->rd_att; 


/* 与 SPI 管理 器 连接 */ 
if ((ret = SPI_connect()) < 0) 
elog(ERROR, "trigf (fired %s): SPI_connect returned %d", when, ret); 


* 获取 表 中 的 行 数量 */ 
ret = SPI_exec("SELECT count(*) FROM ttest", 0); 


if (ret < 0) 
elog(ERROR, "trigf (fired %s): SPI_exec returned %d", when, ret); 


/* count(*) 返回 ints ， 所 以 要 小 心 转换 */ 

i = DatumGetInt64(SPI_getbinval(SPI_tuptable->vals[0], 
SPI_tuptable->tupdesc, 
1, 
&isnull)); 


elog (INFO, "trigf (fired %s): there are %d rows in ttest", when, i); 
SPI_finish(); 
if (checknull) 

SPI_getbinval(rettuple, tupdesc, 1, &isnull); 

if (isnull) 


rettuple = NULL; 
} 


return PointerGetDatum(rettuple) ; 


编译 完 源 代码 后 (参见 Section 35.9.6)， 声 明 画 数 并 创建 触发 器 : 


CREATE FUNCTION trigf() RETURNS trigger 
AS '_filename_' 
LANGUAGE C; 


CREATE TRIGGER tbefore BEFORE INSERT OR UPDATE OR DELETE ON ttest 
FOR EACH ROW EXECUTE PROCEDURE trigf(); 


CREATE TRIGGER tafter AFTER INSERT OR UPDATE OR DELETE ON ttest 
FOR EACH ROW EXECUTE PROCEDURE trigf(); 


现在 你 可 以 测试 触发 器 的 操作 : 


=> INSERT INTO ttest VALUES (NULL); 
INFO: trigf (fired before): there are 0 rows in ttest 
INSERT 0 0 


-- 插入 被 忽略 ，AFTER 触发 器 没有 触发 


=> SELECT * FROM ttest; 
X 


(9 rows) 


=> INSERT INTO ttest VALUES (1); 
INFO: trigf (fired before): there are © rows in ttest 
INFO: trigf (fired after ): there are 1 rows in ttest 
AAAAANAN 
还 记得 讲 过 的 关于 可 视 性 的 原则 吗 ? 
INSERT 167793 1 
vac=> SELECT * FROM ttest; 


(1 row) 


=> INSERT INTO ttest SELECT x * 2 FROM ttest; 
INFO: trigf (fired before): there are 1 rows in ttest 
INFO: trigf (fired after ): there are 2 rows in ttest 
AAANAN 
还 记得 讲 过 的 关于 可 视 性 的 原则 吗 ? 
INSERT 167794 1 
=> SELECT * FROM ttest; 


(2 rows) 


=> UPDATE ttest SET x = NULL WHERE x = 2; 

INFO: trigf (fired before): there are 2 rows in ttest 
UPDATE 0 

=> UPDATE ttest SET x = 4 WHERE x = 2; 

INFO: trigf (fired before): there are 2 rows in ttest 
INFO: trigf (fired after ): there are 2 rows in ttest 
UPDATE 1 

vac=> SELECT * FROM ttest; 


(2 rows) 


=> DELETE FROM ttest,; 
INFO: trigf (fired before): there are 2 rows in ttest 
INFO: trigf (fired before): there are 1 rows in ttest 
INFO: trigf (fired after ): there are 0 rows in ttest 
INFO: trigf (fired after ): there are 0 rows in ttest 
AAANNAN 

还 记得 讲 过 的 关于 可 视 性 的 原则 吗 ? 
DELETE 2 
=> SELECT * FROM ttest; 
X 


(9 rows) 


在 src/test/regress/regress.c 和 spi 里 还 有 更 复杂 的 例子 。 
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为 了 补充 在 Chapter 36 讨 论 过 的 触发 器 机 制 ，PostgreSQL 也 提供 了 事件 触发 器 。 不 同 于 规则 
触发 器 附加 到 一 个 表 上 并 且 只 捕获 DML 事 件 ， 事件 触发 器 对 一 个 特定 的 数据 库 是 全 局 的 ， 并 
且 可 以 捕获 DDL 事 件 。 


像 规 则 触发 器 一 样 ， 事 件 触 发 器 可 以 用 任何 包括 事件 触发 器 支持 的 过 程 语言 来 写 ， 或 者 用 
C， 但 是 不 能 用 简单 的 SQL。 


37.1. 事件 触发 器 行为 的 概述 


当 事 件 以 它 定义 的 方式 在 数据 库 中 相关 的 出 现时 ， 事 件 触发 器 触发 。 当 前 支持 的 事件 是 
ddl_command_start , dd1l_command_end 和 sql_drop 。 额外 事件 的 支持 将 在 将 来 的 版 本 中 添 
加 。 


ddl_command_start 事件 只 在 CREATE , ALTER , 或 DROP 命令 执行 之 前 发 生 。 在 事件 触发 器 触 
发 之 前 并 不 检查 受 影响 的 对 象 是 否 存在 。 然 而 ， 作 为 一 个 例外 ， DDL 命 令 针 对 共享 对 象 时 这 
个 事件 并 不 触发 一 数据库 ， 和 角色 和 表 空 间 一 或 命令 针 对 事件 触发 器 它们 自己 时 也 不 触发 。 
事件 触发 器 机 制 不 支持 这 些 对 象 类 型 。 ddl_command_start 也 在 sELECT INTO 命 全 执行 之 前 触 
发 ， 因 为 这 相当 于 CREATE TABLE AS o 


ddl_command_end 事件 只 在 相同 的 命令 集 的 执行 之 后 触发 。 


sql_drop 事件 只 在 删除 数据 库 对 象 的 任意 操作 触发 ddl_command_end 事件 之 前 发 生 。 要 列 出 
被 删除 的 对 象 ， 使 用 sql_drop 事件 触发 器 代码 的 设置 返回 函数 
pg_event_trigger_dropped_objects() (Æ Section 9.28) 。 请 注意 ， 触 发 器 在 对 象 已 经 从 
系统 目录 中 删除 以 后 执行 ， 所 以 不 可 能 在 看 到 他 们 了 。 


事件 触发 器 (类似 其 他 画 数 ) 不 能 在 一 个 中 止 的 事务 中 执行 。 因此， 如果 一 个 DDL 命 合 错 误 
失败 ， 相 关 的 ddl_command_end 触发 器 将 不 会 执行 。 相反 的 ， 如 果 一 个 ddl_command_start ih 
发 器 错误 失败 了 ， 将 不 会 有 更 多 的 触发 器 触发 ， 也 不 会 党 试 执行 命令 本 身 。 相 似 的 ， 如 果 一 
个 ddl_command_end 触发 器 错误 失败 了 ， DDL 语 句 的 影响 将 会 回 滚 ， 就 像 他 们 在 任何 其 他 包含 
事务 中 止 的 情况 下 一 样 。 


事件 触发 器 机 制 支持 的 命令 的 完整 列表 ， 请 参阅 Section 37.2。 


使 用 命令 CREATE EVENT TRIGGER 创 建 事件 触发 器 。 为 了 创建 事件 触发 器 ， 必须 首先 创建 
一 个 特殊 返回 类 型 为 event_trigger MN, 这 个 函数 不 需要 (或 不 可 能 ) 返回 一 个 值 ; 返 
回 类 型 只 是 作为 一 个 该 范 数 被 作为 一 个 事件 触发 器 调用 的 信号 服务 的 。 


如 果 为 一 个 特别 事件 定义 了 多 个 事件 触发 器 ， 他 们 将 按照 触发 器 名 字 的 字母 顺序 触发 。 


触发 器 定义 也 可 以 声明 一 个 wen 条 件 ， 例 如， 一 个 ddl_command_start 触发 器 可 以 只 为 用 户 
想 要 拦截 的 特别 的 命令 触发 。 这 样 的 触发 器 共同 使 用 的 是 限制 用 户 可 能 执行 的 DDL 操 作 的 范 
围 。 


37.2. FHF ARR ATAR R AE E 


Table 37-1 列 出 了 所 有 支持 事件 触发 器 的 命令 。 


Table 37-1. 命令 标记 支持 的 事件 触发 器 


ALTER 


ALTER 


ALTER 


ALTER 


ALTER 


ALTER 


ALTER 


ALTER 


ALTER 


ALTER 


ALTER 


ALTER 


ALTER 


ALTER 


ALTER 


ALTER 


ALTER 


ALTER 


ALTER 


ALTER 


ALTER 


ALTER 


ALTER 


ALTER 


命令 标记 
AGGREGATE 
COLLATION 
CONVERSION 
DOMAIN 
EXTENSION 
FOREIGN DATA WRAPPER 
FOREIGN TABLE 
FUNCTION 
LANGUAGE 
OPERATOR 
OPERATOR CLASS 
OPERATOR FAMILY 
SCHEMA 
SEQUENCE 
SERVER 
TABLE 
TEXT SEARCH CONFIGURATION 
TEXT SEARCH DICTIONARY 
TEXT SEARCH PARSER 
TEXT SEARCH TEMPLATE 
TRIGGER 
TYPE 
USER MAPPING 


VIEW 


CREATE AGGREGATE 


CREATE CAST 


CREATE COLLATION 


CREATE CONVERSION 


CREATE DOMAIN 


CREATE EXTENSION 


ddl command_ start 


dd1_command_end 


sql_drc 


CREATE FOREIGN DATA WRAPPER 
CREATE FOREIGN TABLE 

CREATE FUNCTION 

CREATE INDEX 

CREATE LANGUAGE 

CREATE OPERATOR 

CREATE OPERATOR CLASS 
CREATE OPERATOR FAMILY 
CREATE RULE 

CREATE SCHEMA 

CREATE SEQUENCE 

CREATE SERVER 

CREATE TABLE 

CREATE TABLE AS 

CREATE TEXT SEARCH CONFIGURATION 
CREATE TEXT SEARCH DICTIONARY 
CREATE TEXT SEARCH PARSER 
CREATE TEXT SEARCH TEMPLATE 
CREATE TRIGGER 

CREATE TYPE 

CREATE USER MAPPING 

CREATE VIEW 

DROP AGGREGATE 

DROP CAST 

DROP COLLATION 

DROP CONVERSION 

DROP DOMAIN 

DROP EXTENSION 

DROP FOREIGN DATA WRAPPER 
DROP FOREIGN TABLE 

DROP FUNCTION 

DROP INDEX 

DROP LANGUAGE 

DROP OPERATOR 

DROP OPERATOR CLASS 

DROP OPERATOR FAMILY 


DROP OWNED 


DROP 


DROP 


DROP 


DROP 


DROP 


DROP 


DROP 


DROP 


DROP 


DROP 


DROP 


DROP 


DROP 


RULE 

SCHEMA 

SEQUENCE 

SERVER 

TABLE 

TEXT SEARCH CONFIGURATION 
TEXT SEARCH DICTIONARY 
TEXT SEARCH PARSER 
TEXT SEARCH TEMPLATE 
TRIGGER 

TYPE 

USER MAPPING 


VIEW 


SELECT INTO 


37.3. 用 C 编 写 事件 触发 器 图 数 


本 节 描 述 事件 鲁 发 器 画 数 接口 的 底层 细节 。 只 有 在 用 C 编 写 事件 触发 器 画 数 的 时 候 才 会 需要 这 

些 信息 。 如 果 你 使 用 一 种 高 级 语言 ， Ba = 已 经 为 你 处 理 了 。 在 大 多 数 情况 下 ， 应 该 

在 用 C 编 写 事件 触发 器 之 前 考虑 用 过 程 语言 。 每 一 个 过 程 语言 的 文档 解释 了 如 何 用 那 种 语言 编 
写 一 个 事件 触发 器 。 


事件 触发 器 函数 必须 使 用 "version "RAEO, 


当 通 过 事件 触发 器 管理 调用 一 个 函数 的 时 候 ， 并 不 传递 任何 正规 参数 ， 而 是 传递 一 
"context" 指 针 指 向 EventTriggerpata 结构 。 C 辑 数 可 以 检查 它们 是 从 事件 触发 器 管理 调用 还 
通过 执行 宏 : 


CALLED_AS_EVENT_TRIGGER(fcinfo) 


扩展 到 : 


((fcinfo)->context != NULL && IsA((fcinfo)->context, EventTriggerData)) 


如 果 返 回 真 ， 那么 传递 fcinfo-&gt;context 到 类 型 EventTriggerData * 是 安全 的 ， 并 且 利 用 
指向 的 EventTriggerData 结构 。 KMŽ NAX EventTriggerData 结构 或 它 指 向 的 任何 数 
据 。 


struct EventTriggerData 是 在 commands/event_trigger.h 里 定义 的 : 


typedef struct EventTriggerData 


NodeTag type; 

const char *event; /* event name */ 
Node *parsetree; /* parse tree */ 
const char *tag; /* command tag */ 


} EventTriggerData; 


成 员 定义 如 下 : 
type 
总 是 T_EventTriggerData o 


event 


描述 了 函数 调用 的 事件 ， 是 "ddl_command_start" ， "ddl_command_end" , "sql_drop" dear 参 
iJ Section 37.1 获 得 这 些 事件 的 含义 。 


parsetree 


命令 的 分 析 树 的 一 个 指针 。 检 查 PostgreSQL 源 代码 详情 。 分 析 树 结构 改变 时 不 会 有 通知 。 
tag 
命令 标签 和 事件 触发 器 正在 运行 的 事件 有 关 ， 例 如 "CREATE FUNCTION" o 


一 个 事件 触发 器 函数 必须 返回 一 个 NuLL 指针 (不 是 SQL null 值 ， 也 就 是 ， 不 要 设 
i@ isull 为 真 ) 。 


37.4. 一 个 完整 的 事件 触发 器 的 例子 


这 是 用 C 编 写 的 事件 触发 器 图 数 的 一 个 非常 简单 的 例子 。 〔 用 过 程 语言 编写 的 触发 器 的 例子 
可 以 在 过 程 语言 的 文档 中 找到 。) 


函数 noddl 在 每 次 调用 它 时 提出 一 个 异常 。 事 件 触发 器 定义 在 ddl_command_start 事件 时 联 
系 辑 数 。 影 响 是 阻止 所 有 DDL 命 合 (除了 在 Section 37.1 中 提 到 的 例外 ) 运行 


这 是 触发 器 函数 的 源 代 码 : 
#include "postgres.h" 
#include "commands/event_trigger.h" 
PG_MODULE_MAGIC; 
Datum nodd1(PG_FUNCTION_ARGS) ; 
PG_FUNCTION_INFO_V1(noddl1); 


Datum 
nodd1(PG_FUNCTION_ARGS) 
{ 
EventTriggerData *trigdata; 


if (!CALLED_AS_EVENT_TRIGGER(fcinfo)) /* internal error */ 
elog(ERROR, "not fired by event trigger manager"); 


trigdata = (EventTriggerData *) fcinfo->context; 
ereport(ERROR, 
(errcode(ERRCODE_INSUFFICIENT_PRIVILEGE), 


errmsg( "command \"%s\" denied", trigdata->tag))); 


PG_RETURN_NULL(); 


在 编译 源 代码 之 后 (参阅 Section 35.9.6) ， 声 明 画 数 和 触发 器 : 


CREATE FUNCTION noddl() RETURNS event_trigger 
AS 'nodd1' LANGUAGE C; 


CREATE EVENT TRIGGER noddl ON ddl_command_start 
EXECUTE PROCEDURE nodd1(); 


现在 可 以 测试 触发 的 操作 : 


=# \dy 
List of event triggers 
Name | Event | Owner | Enabled | Procedure | Tags 
> Pe 
noddl | ddl_command_start | dim | enabled | noddl | 
(1 row) 


=# CREATE TABLE foo(id serial); 
ERROR: command "CREATE TABLE" denied 


在 这 种 情况 下 ， 当 你 需要 做 这 些 的 时 候 为 了 能 够 运行 一 些 DDL 命 全 ， 你 必须 终止 事件 触发 器 
或 禁用 它 。 只 在 事务 期 间 禁 用 触发 器 是 方便 的 : 


BEGIN; 
ALTER EVENT TRIGGER noddl DISABLE; 
CREATE TABLE foo (id serial); 
ALTER EVENT TRIGGER noddl ENABLE; 
COMMIT; 


(回想 一 下 ， 事 件 触发 器 自己 的 DDL 命 邻 不 受 事件 触发 器 的 影响 。 ) 
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本 章 讨 论 PostgreSQL 里 的 规则 系统 。 生产 规则 系统 的 概念 是 很 简单 的 ， 但 是 在 实际 使 用 的 时 
候 会 碰 到 很 多 细节 问题 。 


有 些 其 它 数 据 库 系统 定义 动态 的 数据 库 规则 。 这 些 通常 是 存储 过 程 和 触发 器 ， 在 PostgreSQL 
里 ， 这 些 示 西 也 可 以 通过 本 数 和 触发 器 来 实现 。 


规则 系统 (更 准确 地 说 是 查询 重 写 规则 系统 ) 是 和 存储 过 程 和 触发 器 完全 不 同 的 东西 。 它 把 查 
询 修 改 为 需要 考虑 规则 的 形式 ， 然 后 把 修改 过 的 查询 传递 给 查询 规划 器 执行 。 这 是 非常 有 效 
的 工具 并 且 可 以 用 于 许多 像 查询 语言 过 程 、 视 图 、 版 本 等 。 这 个 规则 系统 的 理论 基础 和 能 

在 数据 库 系 统 中 的 规则 ， 过 程 ， 缓 存 和 视图 和 数据 库 系 统 中 为 版 本 模型 使 用 生产 规则 的 统一 
框架 里 有 讨论 。 


38.1. 查询 树 


要 理解 规则 系统 如 何 工作 ， 首 先 要 知道 规则 何 时 被 激发 以 及 它 的 输入 和 结果 是 什么 。 


规则 系统 位 于 分 析 器 和 规划 器 之 间 。 以 分 析 器 输出 的 查询 树 以 及 用 户 定义 的 重 写 规 则 作为 输 
A, 重 写 规 则 也 是 一 个 查询 树 ， 只 不 过 增加 了 一 些 扩展 信息 ， 然 后 创建 雳 个 或 者 多 个 查询 树 
作为 结果 。 所 以 它 的 输入 和 输出 仍然 是 那些 分 析 器 可 以 生成 的 东西 ， 因 而 任何 规则 系统 看 到 
的 东西 都 是 可 以 用 SQL 语句 表达 的 。 


那么 什么 是 查询 树 呢 ? 它 是 一 个 SQL 语 句 的 内 部 表现 形式 ， 这 时 组 成 该 语句 的 每 个 独立 部 分 都 
是 分 别 存 储 的 。 如 果 你 设置 了 配置 参数 debug_print_parse , debug_print_rewritten , 

或 debug_print_plan ， 那 么 就 可 以 在 服务 器 日 志 中 看 到 这 些 查询 树 。 规则 动作 也 是 以 查询 树 
的 方式 存储 的 ， 存 放 在 系统 表 pg_rewrite 里 面 。 不 过 不 是 用 像 调 试 输出 那样 的 格式 ， 但 包含 
的 内 容 是 完全 一 样 的 。 


阅读 一 个 裸 查 询 树 需要 一 定 的 经 验 ， 但 是 因为 理解 查询 树 的 SQL 表现 就 足以 理解 规则 系统 ， 
所 以 这 份 文档 将 不 会 告诉 你 如 何 读 取 它 们 。 


当 读 取 本 章 中 查询 树 的 SQL 表现 时 ， 必须 能 够 识别 该 语句 被 分 解 后 放 在 查询 树 里 的 成 员 。 查 
询 树 的 成 员 有 


命令 类 型 (command type) 
这 是 一 个 简单 的 值 ， 说 明 哪 条 命令 ( SELECT ， INSERT, UPDATE, DELETE ) 生 成 这 个 查询 树 。 
范围 表 (range table) 


范围 表 是 一 个 查询 中 使 用 的 关系 的 列表 。 在 sect 语句 里 就 是 在 FRoM 关键 字 后 面 给 出 的 关 
Ro 


每 个 范围 表 表 示 一 个 表 或 一 个 视图 ， 表 明 是 查询 里 哪个 成 员 调 用 了 它 。 在 查询 树 里 ， 范围 表 
是 用 代号 而 不 是 用 名 字 引 用 的 ， 所 以 这 里 不 用 像 在 SQL 语句 里 一 样 关心 是 否 有 重 名 问题 。 这 
种 情况 在 引入 了 规则 的 范围 表 后 可 能 会 发 生 。 本 章 的 例子 将 不 讨论 这 种 情况 。 


结果 关系 (result relation) 
这 是 一 个 范围 表 的 索引 ， 用 于 标识 查询 结果 前 往 的 表 。 


SELECT 查询 通常 没有 结果 关系 。 特 例 seLEcT inro 几乎 等 于 一 个 跟随 INSERT ... SELECT 
的 CREATE TABLE ， 所 以 这 里 就 不 单独 讨论 了 。 


在 INSERT ，UPDATE ，DELETE 命令 里 ， 结果 关系 是 更 改 发 生 影响 的 表 或 视图 。 


目标 列 (target list) 


目标 列 是 一 列 定义 查询 结果 的 表达 式 。 在 sect 的 情况 下 ， 这 些 表达 式 就 是 构建 查询 的 最 终 
输出 的 东西 。 它 们 是 位 于 SELECT 和 FROM 关键 字 之 间 的 表达 式 ( * 只 是 表明 一 个 关系 的 所 有 
字段 的 缩写 ， 它 被 分 析 器 扩展 为 独立 的 字段 ， 因 此 规则 系统 永远 看 不 到 它 )。 


DELETE 不 需要 正常 的 目标 列 是 因为 它们 不 产生 任何 结果 。 相反 的 ， 规 划 器 会 向 空 目的 标 列 中 
增加 一 条 特殊 的 CTID 记 录 ， 以 允许 执行 器 找到 被 删除 的 行 。 ( 当 结 果 关 系 是 一 个 普通 的 表 时 
添加 CTID。 如 果 结 果 关 系 是 一 个 视图 ， 则 添加 所 有 的 行 变 量 ， 描 述 在 Section 38.2.4。) 


对 于 insert 命令 里 面 ， 目 标 列 描述 了 应 该 进入 结果 关系 的 新 行 。 这 些 行 由 那些 在 vALuEs F 
句 里 的 表达 式 或 在 INSERT ... SELECT 语句 里 的 sELECT 子 句 里 面 的 表达 式 构 成 。 重 写 过 程 的 
第 一 步 就 是 为 任何 不 是 由 原始 的 查询 赋值 ， 并 且 有 缺 省 值 的 字段 增加 目标 列表 项 。 任何 其 它 
的 字段 ( 既 无 给 出 值 也 无 缺 省 值 ) 将 由 规划 器 自动 赋予 一 个 常量 NULL 表达 式 。 


对 于 UPDATE 命令 ， 目 标 列 描述 应 该 蔡 换 旧 行 的 新 行 。 在 规则 系统 里 ， 它 只 包含 来 自命 命 

的 SET column = expression 部 分 抽取 的 表达 式 。 这 时 ， 规划 器 将 通过 插入 从 旧 行 抽取 数据 到 
新 行 的 表达 式 的 方法 处 理 缺 失 的 字段 。 就 像 对 DELETE ， 规 则 系统 添加 CTID 或 整 行 变量 使 执 
行者 可 以 识别 要 被 更 新 的 旧 行 。 


目标 列 里 的 每 个 元 素 都 包含 着 一 个 表达 式 ， 它 可 以 为 常量 值 、 一 个 指向 某 个 范围 表 里 面 的 关 
系 的 一 个 字段 的 变量 、 一 个 参数 、 一 个 由 函数 调用 /常量 /变量 /操作 符 等 构成 的 表达 式 树 。 


条 件 (qualification) 


查询 条 件 是 一 个 表达 式 ， 它 非常 类 似 那些 包含 在 目标 列 里 的 条 目 。 这 个 表达 式 的 值 是 一 个 布 
尔 值 ， 通过 此 值 来 判断 对 最 终结 果 行 是 否 要 执 操 作 ( INSERT , UPDATE , DELETE ,或 
SELECT )。 它 是 一 个 SQL 语句 的 WHERE 子 句 。 


连接 树 (join tree) 


查询 的 连接 树 显示 了 FROM 子 名 的 结构 。 对 于 像 SELECT ... FROM a, b, c 这 样 的 简单 查询 ， 
连接 树 只 是 一 个 FRoM 项 的 简单 列表 ， 因 为 允许 以 任意 顺序 连接 它们 。 但 如 果 使 用 了 som K 
达 式 (尤其 是 外 连接 的 时 候 )， 就 必须 按照 该 连接 显示 的 顺序 进行 连接 。 在 这 种 情况 下 ， 连 接 
树 显示 JOIN 表达 式 的 结构 。 与 特定 的 join 子 句 (来 自 on 或 usis 表达 式 ) 相 关 的 限制 做 为 
附加 在 那些 连接 树 节点 的 条 件 表达 式 存 储 。 事实 证 明 把 顶层 whERE 表达 式 也 当做 附加 在 顶层 
连接 树 项 的 条 件 来 存储 是 非常 方便 的 。 所 以 实际 上 连接 树 代表 SELECT 语句 

的 FRoM 和 wHERE 子 句 。 


其 它 (others) 


查询 树 的 其 它 部 分 ， 像 oRDER BY 子 句 ， 不 准备 在 这 里 讨论 。 规则 系统 在 附加 规则 时 将 在 那里 
(ORDER BY 子 句 ) 蔡 换 一 些 条 目 ， 但 是 这 对 于 规则 系统 的 基本 原理 并 没有 多 大 关系 。 


38.2. 视图 和 规则 系统 


PostgreSQL 里 的 视图 是 通过 规则 系统 来 实现 的 。 下 面 的 命令 : 


CREATE VIEW myview AS SELECT * FROM mytab; 


实际 上 和 下 面 两 条 命令 : 


CREATE TABLE myview (_same column list as mytab_); 
CREATE RULE "_RETURN" AS ON SELECT TO myview DO INSTEAD 
SELECT * FROM mytab; 


之 间 本 质 上 没有 区 别 ， 因 为 这 就 是 cREATE View 命令 在 内 部 实际 执行 的 内 容 。 这 样 做 有 一 些 
负 作用 。 其 中 之 一 就 是 在 PostgreSQL 系统 表 里 的 视图 的 信息 与 一 般 表 的 信息 完全 一 样 。 所 以 
对 于 查询 分 析 器 来 说 ， 表 和 视图 之 间 完 全 没有 区 别 。 它 们 是 同样 的 事物 : 关系 。 


38.2.1. SELECT 规则 如 何 运 转 


ON SELECT 的 规则 在 最 后 一 步 应 用 于 所 有 查询 ， 哪 怕 给 出 的 是 一 条 INSERT, UPDATE 或 
DELETE 命令 。 而 且 与 其 它 命 令 类 型 上 的 规则 有 不 同 的 语意 ， 那 就 是 它们 在 现场 修改 查询 树 而 
不 是 创建 一 个 新 的 查询 树 。 所 以 先 介绍 SELECT 规则 。 


目前 ， 一 个 on SELECT 规则 里 只 能 有 一 个 动作 ， 而 且 它 必须 是 一 个 无 条 件 的 INsTEAD (取代 ) 
的 sELEcT 动作 。 有 这 个 限制 是 为 了 仿 规 则 安全 到 普通 用 户 也 可 以 打开 它们 ， 并 且 它 限 
制 ON SELECT 规则 使 之 行为 类 似 视图 。 


本 文档 的 例子 是 两 个 连接 视图 ， 它 们 做 一 些 运算 并 且 因此 会 涉及 到 更 多 视图 的 使 用 。 这 两 个 
视图 之 一 稍 后 将 利用 对 INSERT, UPDATE , DELETE 操作 附加 规则 的 方法 自 定 义 ， 这 样 做 最 终 
的 结果 就 是 这 个 视图 表现 得 像 一 个 具有 一 些 特殊 功能 的 真正 的 表 。 这 个 例子 不 适合 于 开始 的 
简单 易 懂 的 例子 ， 从 这 个 例子 开始 讲 可 能 会 让 讲解 变 得 有 些 难以 理解 。 但 是 用 一 个 覆盖 所 有 
关键 点 的 例子 来 一 步 一 步 讨 论 要 比 举 很 多 例子 搞 乱 思维 好 。 





比如 ， 需 要 一 个 小 巧 的 min 琅 数 用 于 返回 两 个 整数 值 中 较 小 的 那个 。 用 下 面 方法 创建 它 : 


CREATE FUNCTION min(integer, integer) RETURNS integer AS $$ 
SELECT CASE WHEN $1 < $2 THEN $1 ELSE $2 END 
$$ LANGUAGE SQL STRICT; 


头 两 个 规则 系统 要 用 到 的 表 如 下 : 


CREATE TABLE shoe_data ( 


shoename text, -- 主键 
sh_avail integer, -- ( 鞋 的 ) 可 用 对 数 
slcolor text, -- 首选 的 鞋 带 颜色 
slminlen real, -- BRAKE 
slmaxlen real, -- 鞋 带 最 长 长 度 
slunit text -- 长 度 单 位 


Ne 


CREATE TABLE shoelace_data ( 


sl_name text, -- 主键 
sl_avail integer, -- ( 鞋 的 ) 可 用 对 数 
sl_color text, -- ems 
sl_len real, -- 鞋 带 长 度 
sl_unit text -- 长 度 单位 


CREATE TABLE unit ( 

un_name text, -- 主键 

un_fact real -- 转换 成 厘米 的 系数 
); 


你 可 以 看 到 ， 这 些 表 代表 鞋 店 的 数据 。 
视图 创建 为 : 


CREATE VIEW shoe AS 

SELECT sh.shoename, 
sh.sh_avail, 
sh.slcolor, 
sh.slminlen, 
sh.slminlen * un.un_fact AS slminlen_cm, 
sh.slmaxlen, 
sh.slmaxlen * un.un_fact AS slmaxlen_cm, 
sh.slunit 

FROM shoe_data sh, unit un 
WHERE sh.slunit = un.un_name; 


CREATE VIEW shoelace AS 

SELECT s.sl_name, 
.Sl_avail, 
.Sl_color, 
.sl_len, 
.Sl_unit, 

s.sl_len * u.un_fact AS sl_len_cm 
FROM shoelace_data s, unit u 

WHERE s.sl_unit = u.un_name; 


OO mn wm wm 


CREATE VIEW shoe_ready AS 
SELECT rsh.shoename, 
rsh.sh_avail, 
rsl.sl_name, 
rsl.sl_avail, 
min(rsh.sh_avail, rsl.sl_avail) AS total_avail 
FROM shoe rsh, shoelace rsl 
WHERE rsl.sl_color = rsh.slcolor 
AND rsl.sl_len_cm >= rsh.slminlen_cm 
AND rsl.sl_len_cm <= rsh.slmaxlen_cm; 


创建 shoelace 视图 的 cREATE view 命令 (也 是 用 到 的 最 简单 的 一 个 ) 将 创建 一 个 shoelace 关系 
并 且 在 pg_rewrite 表 里 增 加 一 个 记录 ， 告诉 系统 有 一 个 重 写 规则 应 用 于 所 有 范围 表 里 引 用 
了 shoelace 关系 的 查询 。 该 规则 没有 规则 条 件 (将 在 非 sELEcT 规则 讨论 ， 因 为 目前 


eae = 


的 seLEcT 规则 不 可 能 有 这 些 东 西 ) 并 且 它 是 instead (取代 ) 型 的 。 要 注意 规则 条 件 与 查询 条 件 
不 一 样 。 规则 动作 有 一 个 查询 条 件 。 规 则 的 动作 是 一 个 查询 树 ， 这 个 查询 是 树 视 图 创建 命令 
中 的 sELEcT 语句 的 一 个 拷贝 。 





Note: 你 在 表 pg_rewrite 里 看 到 的 两 个 额外 的 用 于 new 和 oo 的 范围 表 记 录 
对 SELECT 规则 不 感 兴趣 。 





现在 填充 unit , shoe_data ，shoelace_data ， 并 且 在 视图 上 运行 一 个 简单 的 查询 : 

INSERT INTO unit VALUES ('cm', 1.0); 

INSERT INTO unit VALUES ('m', 100.0); 

INSERT INTO unit VALUES ('inch', 2.54); 

INSERT INTO shoe_data VALUES ('shi', 2, 'black', 70.0, 90.0, 'cm'); 
INSERT INTO shoe_data VALUES ('sh2', ©, 'black', 30.0, 40.0, ‘inch'); 
INSERT INTO shoe_data VALUES ('sh3', 4, 'brown', 50.0, 65.0, 'cm'); 
INSERT INTO shoe_data VALUES ('sh4', 3, 'brown', 40.0, 50.0, ‘inch'); 
INSERT INTO shoelace_data VALUES ('sl1i', 5, 'black', 80.0, 'cm'); 
INSERT INTO shoelace_data VALUES ('s12', 6, 'black', 100.0, 'cm'); 
INSERT INTO shoelace_data VALUES ('s13', ©, 'black', 35.0 , '‘inch'); 
INSERT INTO shoelace_data VALUES ('sl14', 8, 'black', 40.0 , '‘inch'); 
INSERT INTO shoelace_data VALUES ('s15', 4, 'brown', 1.0 , 'm'); 
INSERT INTO shoelace_data VALUES ('sl6', ©, 'brown', 0.9 , 'm'); 
INSERT INTO shoelace_data VALUES ('s17', 7, 'brown', 60 , 'cm'); 
INSERT INTO shoelace_data VALUES ('s18', 1, 'brown', 40 , '‘inch'); 
SELECT * FROM shoelace; 

sl_name | sl_avail | sl_color | sl_len | sl_unit | sl_len_cm 

Pensa Smee 证 

sl1 | 5 | black | 80 | cm | 80 

s12 | 6 | black | 100 | cm | 100 

s17 | 7 | brown | 60 | cm | 60 

s13 | © | black | 35 | inch | 88.9 

sl4 | 8 | black | 40 | inch | 101.6 

s18 | 1 | brown | 40 | inch | 101.6 

s15 | 4 | brown | 1 |m | 100 

sl6 | © | brown | 0.9 |m | 90 

(8 rows) 

ES kz 


文 是 可 以 在 视图 上 做 的 最 简单 的 seLEcT ， 所 以 把 它 作为 解释 视图 规则 的 基本 命令 。 
SELECT * FROM shoelace 被 分 析 器 解释 成 下 面 的 查询 树 : 


SELECT shoelace. 
shoelace. 
shoelace. 

FROM shoelace 


shoelace.sl_avail, 
shoelace.sl_len, 
shoelace.sl_len_cm 


sl_name, 
sl_color, 
sl_unit, 
shoelace; 


EAN 2A 


然后 把 这 些 交 给 规则 系统 。 规 则 系统 把 范围 表 (range table) 过 滤 一 通 ， 
何 关 系 的 规则 。 当 为 shoelace 记录 义理 范围 表 时 (到 目前 为 止 唯一 的 一 个 )， 
里 有 _RETURN 规则 ， 查 询 树 类 似 下 面 这 样 


检查 
检查 


下 有 没有 适用 任 
它 会 发 现 查 询 树 


SELECT s.sl_name, s.sl_avail, 
s.sl_color, s.sl_len, s.sl_unit, 
s.sl_len * u.un_fact AS sl_len_cm 

FROM shoelace old, shoelace new, 
shoelace_data s, unit u 
WHERE s.sl_unit = u.un_name; 


为 扩展 该 视图 ， 重 写 器 简单 地 创建 一 个 子 查询 范围 表 记 录 ， 它 包含 规则 动作 的 查询 树 ， 然后 
用 这 个 范围 表 记 录取 代 原 先 引 用 视图 的 那个 。 生 成 的 重 写 查询 树 几乎 与 你 键 和 人 的 那个 一 样 : 


SELECT shoelace.sl_name, shoelace.sl_avail, 
shoelace.sl_color, shoelace.sl_len, 
shoelace.sl_unit, shoelace.sl_len_cm 

FROM (SELECT s.sl_name, 

.Sl_avail, 

.Sl_color, 

.Sl_len, 

.Sl_unit, 

s.sl_len * u.un_fact AS sl_len_cm 
FROM shoelace_data s, unit u 
WHERE s.Sl_unit = u.un_name) shoelace; 


S 
S 
S 
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不 过 还 是 有 一 个 区 别 : 子 查询 范围 表 有 两 个 额外 的 记录 shoelace old 和 shoelace new 。 这 些 
记录 并 不 直接 参与 查询 ， 因为 它们 没有 被 子 查 询 的 连接 树 或 者 目标 列表 引用 。 重 写 器 用 它们 
存储 最 初出 现在 引用 视图 的 范围 表 里 面 的 访问 权限 检查 。 这 样 ， 执行 器 仍然 会 检查 该 用 户 是 
否 有 访问 视图 的 合适 权限 ， 即 使 在 重 写 查询 里 面 没有 对 视图 的 直接 使 用 也 如 此 。 


这 是 应 用 的 第 一 个 规则 。 规 则 系统 继续 检查 顶层 查询 里 剩 下 的 范围 表 记录 (本 例 中 没有 了 )， 
并 且 它 在 加 进来 的 子 查询 中 递归 地 检查 范围 表 记 录 ， 看 看 其 中 有 没有 引用 视图 的 (不 过 这 样 不 
会 扩展 old 或 new ， 否 则 会 无 穷 递归 下 去 !)。 在 这 个 例子 中 ， 没 有 用 

于 shoelace_data 或 unit ESAN), 所 以 重 写 结束 并 且 上 面 的 就 是 给 规划 器 的 最 终结 果 。 


现在 想 写 这 么 一 个 查询 : 这 个 查询 找 出 目前 在 店 里 有 配对 鞋 带 的 鞋子 (颜色 和 长 度 ) ， 并 且 
配对 的 鞋 带 数 大 于 或 等 于 二 。 


SELECT * FROM shoe_ready WHERE total_avail >= 2; 
shoename | sh_avail | sl_name | sl_avail | total_avail 


sh3 | 4 | s17 | 
(2 rows) 


这 回 分 析 器 的 输出 是 查询 树 : 


SELECT shoe_ready.shoename, shoe_ready.sh_avail, 
shoe_ready.sl_name, shoe_ready.sl_avail, 
shoe_ready.total_avail 

FROM shoe_ready shoe_ready 
WHERE shoe_ready.total_avail >= 2; 


应 用 的 第 一 个 规则 将 是 用 于 shoe ready 视图 的 ， 结 果 是 生成 查询 树 : 


SELECT shoe_ready.shoename, shoe_ready.sh_avail, 
shoe_ready.sl_name, shoe_ready.sl_avail, 
shoe_ready.total_avail 

FROM (SELECT rsh.shoename, 

rsh.sh_avail, 
rsl.sl_name, 
rsl.sl_avail, 
min(rsh.sh_avail, rsl.sl_avail) AS total_avail 

FROM shoe rsh, shoelace rsl 

WHERE rsl.sl_color = rsh.slcolor 
AND rsl.sl_len_cm >= rsh.slminlen_cm 
AND rsl.sl_len_cm <= rsh.slmaxlen_cm) shoe_ready 
WHERE shoe_ready.total_avail >= 2; 


与 上 面 类 似 ， 用 于 shoe 和 shoelace 的 规则 替换 到 子 查询 范围 表 里 ， 生 成 一 个 最 终 的 三 层 查 
询 树 : 


SELECT shoe_ready.shoename, shoe_ready.sh_avail, 
shoe_ready.sl_name, shoe_ready.sl_avail, 
shoe_ready.total_avail 

FROM (SELECT rsh.shoename, 
rsh.sh_avail, 
rsl.sl_name, 
rsl.sl_avail, 
min(rsh.sh_avail, rsl.sl_avail) AS total_avail 
FROM (SELECT sh.shoename, 
sh.sh_avail, 
sh.slcolor, 
sh.slminlen, 
sh.slminlen * un.un_fact AS slminlen_cm, 
sh.slmaxlen, 
sh.slmaxlen * un.un_fact AS slmaxlen_cm, 
sh.slunit 
FROM shoe_data sh, unit un 
WHERE sh.slunit = un.un_name) rsh, 
(SELECT s.sl_name, 

.Sl_avail, 

.Sl_color, 

.Sl_len, 

.Sl_unit, 

.Sl_len * u.un_fact AS sl_len_cm 

FROM shoelace_data s, unit u 
WHERE s.Sl_unit = u.un_name) rsl 
WHERE rsl.sl_color = rsh.slcolor 
AND rsl.sl_len_cm >= rsh.slminlen_cm 
AND rsl.sl_len_cm <= rsh.slmaxlen_cm) shoe_ready 
WHERE shoe_ready.total_avail > 2; 
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最 后 规划 器 会 把 这 个 树 压 缩 成 一 个 两 层 查询 树 : 最 下 层 的 secect 将 " 拖 到 "中 间 

的 SELECT 中 ， 因 为 没有 必要 分 别处 理 它们 。 但 是 中 间 的 sELEcT 仍然 和 顶层 的 分 开 ， 因 为 它 
包含 聚集 函数 。 如 果 把 它们 也 拉 进 来 ， 那 它 就 会 修改 最 顶层 sect 的 行为 ， 那 可 不 是 想 要 
的 。 不 过 ， 压 缩 查询 树 是 重 写 系 统 自己 不 需要 关心 的 优化 操作 。 


38.2.2. 非 SELECT 语句 的 视图 规则 


AATE AHN PELAHABMAMP RASA, MEMA EMERARA R KE, 
视图 规则 不 需要 命令 类 型 ， 但 是 结果 关系 可 能 会 影响 查询 重 写 的 工作 方式 ， 因为 如 果 结 果 关 
系 是 一 个 视图 则 需要 特别 的 注意 。 


一 个 sect 的 查询 树 和 用 于 其 它 命 全 的 查询 树 只 有 少数 几 个 区 别 。 显 然 ， 它们 的 命令 类 型 不 
同 并 且 对 于 sELECT 之 外 的 命令 ， 结果 关系 指向 结果 将 前 往 的 范围 表 入 口 。 任 何其 它 东 西 都 完 
全 是 一 样 的 。 所 以 如 果 有 两 个 表 tt 和 t2 分 别 有 字 段 a 和 pb ， 下 面 两 个 语句 的 查询 树 : 


SELECT t2.b FROM t1, t2 WHERE ti.a = t2.a; 


UPDATE t1 SET b = t2.b FROM t2 WHERE ti.a = t2.a; 


几乎 是 一 样 的 。 特 别 是 : 
。 范围 表 包含 表 t1 和 t2 的 记录 。 
。 目标 列表 包含 一 个 变量 ， 该 变量 指向 表 t2 的 范围 表 入 口 的 b 字段 。 
。 条 件 表达 式 比较 两 个 范围 的 字段 a 以 寻找 相等 行 。 
。 连接 树 显示 tı 和 t2 之 间 的 简单 连接 。 


结果 是 ， 两 个 查询 树 生 成 相似 的 执行 规划 : 它们 都 是 两 个 表 的 连接 。 对 于 upar 语句 来 说 ， 
规划 器 把 ta 缺失 的 字段 追加 到 目标 列 因而 最 终 查 询 树 看 起 来 像 : 


UPDATE t1 SET a = ti.a, b = t2.b FROM t2 WHERE t1.a = t2.a; 


因此 执行 器 在 连接 上 运行 的 结果 和 下 面 语句 是 完全 一 样 的 : 


SELECT ti.a, t2.b FROM t1, t2 WHERE t1.a = t2.a; 


但 是 在 uppATE 里 有 点 问题 : 做 链接 的 执行 器 计划 部 分 不 关心 连接 结果 的 含义 是 什么 。 它 只 是 
产生 一 个 行 的 结果 集 。 一 个 是 SELECT 命 命 而 另 一 个 是 UPDATE 命令 实际 是 在 执行 器 的 更 高 级 
处 理 的 ， 这 里 知道 这 是 一 个 uppATE ， 而 且 它 还 知道 结果 要 记录 到 表 ti BK. 但 是 现 有 的 
记录 中 的 哪 一 行 要 被 新 行 取 代 呢 ? 


要 解决 这 个 问题 ， 在 UPDATE 和 DELETE 语句 的 目标 列表 里 面 增 加 了 另外 一 个 入 口 : 当前 的 行 
ID (CTID)。 这 是 一 个 有 着 特殊 特性 的 系统 字段 。 它 包含 行 在 文件 块 中 的 块 编 号 和 位 置信 息 。 
在 已 知 表 的 情况 下 ， 可 以 通过 CTID 检 索 最 初 的 需要 更 新 的 td 行 。 在 把 CTID 加 到 目标 列表 
中 去 以 后 ， 查 询 看 上 去 实际 上 像 这 样 : 


SELECT t1.a, t2.b, t1.ctid FROM t1, t2 WHERE ti.a = t2.a; 


现在 ， 另 一 个 PostgreSQL 的 细节 进入 到 这 个 阶段 里 了 。 这 时 ， 表 中 的 旧 行 还 没有 被 覆盖 ， 这 
就 是 为 什么 RoLLBACK 飞快 的 原因 。 在 一 个 uppate 里 ， 新 的 结果 f ee oe 
之 后 ) 并 且 把 CTID 指 向 的 旧 数 据 行 的 行头 里 面 的 cmax 2 xmax 设置 为 当前 命 合计 数 器 和 当前 
事务 ID 。 这 样 旧 的 行 就 被 隐藏 起 来 并 且 在 事务 提交 之 vacuum 清理 器 就 可 以 真正 把 它们 
删除 掉 。 


知道 了 这 些 ， 就 可 以 简单 的 把 视图 的 规则 应 用 到 任意 命令 中 。 规 则 和 命令 没有 区 别 。 


38.2.3. PostgreSQL 里 视图 的 强大 能 


上 面 演示 了 规则 系统 如 何 融 合 视图 定义 到 初始 查询 树 中 去 。 在 第 二 个 例子 里 ， 一 个 简单 的 对 
视图 的 sELECT 创建 了 一 个 四 表 联 合 的 查询 树 ( unit 以 不 同 的 名 称 用 了 两 次 )。 


在 规则 系统 里 实现 视图 的 好 处 是 ， 规 划 器 在 一 个 查询 树 里 拥有 所 有 信息 : 应 该 扫描 哪个 表 + 表 
之 间 的 关系 + 视图 的 资格 限制 + 初始 查询 的 资格 (条 件 )。 并 且 仍 然 是 ee 
视图 的 联合 的 情况 下 。 现 在 规划 器 必须 决定 执行 查询 的 最 优 路 径 。 规划 器 拥有 越 多 信息 ， 它 

的 决策 就 越 好 。 并 且 PostgreSQL 里 的 规则 系统 的 实现 保证 这 些 信 es 
询 的 所 有 信息 。 


38.2.4. 更 新 一 个 视图 


如 果 视 图 命名 为 INSERT, UPDATE , DELETE 的 目标 关系 会 怎样 ?在 完成 上 面 描述 的 蔡 换 之 后 ， 
就 有 一 个 这 样 的 查询 树 : 结果 关系 指向 一 个 是 子 查询 的 范围 表 记 录 ， 这 样 可 不 能 运行 。 在 
PostgreSQL 中 有 几 种 方式 支持 更 新 一 个 视图 的 外 观 。 


如 果子 查询 从 一 个 单一 的 基本 关系 选择 或 者 足够 简单 ， 重 写 可 以 自动 的 用 底层 的 基本 关系 蔡 
代 子 查询 ， 所 以 insert, UPDATE 或 DELETE 以 适当 的 方式 应 用 于 基本 关系 。 视 图 因为 " 足 
够 简单 "而 被 称 为 可 自动 更 新 的 。 有 关 这 种 可 以 自动 更 新 的 视图 的 更 详细 的 信息 请 参 

kJ CREATE VIEW. 


或 者 ， 操 作 可 能 通过 一 个 用 户 提供 的 在 视图 上 的 instead oF 触发 器 处 理 。 PE 
况 下 略 有 不 同 。 对 于 insert, 重 写 并 不 对 视图 做 什么 ， 让 它 作 为 查询 的 结果 关系 。x 

于 UPDATE 和 DELETE ， 重 写 仍 然 需要 扩展 视图 查询 ， ee 行 。 所 
以 ， 视 图 正常 扩展 ， 但 是 另外 一 个 不 扩展 的 范围 表 条 目 添加 到 查询 中 ， 代表 视图 作为 结果 关 
Ro 


现在 出 现 的 问题 是 如 何 识别 出 视图 中 要 更 新 的 行 。 回 想 当 结 果 关 系 是 一 个 表 时 ， 一 个 特殊 的 
CTID 条 目 被 添加 到 目标 列表 ， 以 识别 出 要 被 更 新 的 行 的 物理 位 置 。 如 果 结 果 关系 是 一 个 视图 
这 将 不 会 工作 ， 因 为 视图 没有 任何 CTID， 因为 它 的 行 没有 真实 的 物理 位 置 。 相 反 ， 对 

于 UPDATE 或 DELETE 操作 ， 一 个 特殊 的 wholerow 条 目 被 添加 到 目标 列表 ， 它 扩大 到 包含 视 
图 的 所 有 列 。 执 行 器 使 用 这 个 值 提供 "old" 行 到 INsTEAD oF 触发 器 。 由 触发 器 基于 | 旧 行 和 新 行 
值 找 出 来 的 需要 更 新 什么 。 


另外 一 个 可 能 是 用 户 定义 INSTEAD 规则 ， 为 视图 上 的 INSERT, UPDATE , 和 DELETE 命令 指定 
Star, 这 些 规则 将 重 写 命令 ， 通 常 进 入 一 个 命令 更 新 一 个 或 更 多 的 表 ， 而 不 是 视图 。 这 
是 下 一 节 的 主题 。 

请 注意 ， 首 先 评估 规则 ， 在 规划 和 执行 之 前 重 写 原先 的 查询 。 因 此 ， 如 果 一 个 视图 

有 INSTEAD oF 触发 器 ， 也 有 在 INSERT, UPDATE , 或 DELETE 上 的 规则 ， 那 么 规则 将 被 首先 评 
估 ， 根据 评估 结果 ， 触 发 器 可 能 不 会 使 用 。 

在 一 个 简单 视图 上 的 INSERT, UPDATE , 或 DELETE 查询 的 自动 重 写 总 是 最 后 党 试 。 因 此 ， 如 
果 一 个 视图 有 规则 或 触发 器 ， 他 们 将 履 盖 自动 更 新 视图 的 缺 省 行为 。 

如 果 视 图 上 没有 INSTEAD 规则 或 INSTEAD oF 触发 器 ， 并 且 重 写 不 能 作为 一 个 在 底层 基本 关系 
上 的 更 新 自动 重 写 查询 ， 那么 将 抛 出 一 个 错误 ， 因 为 执行 器 不 能 像 这 样 的 更 新 视图 。 


38.3. 物化 视图 


PostgreSQL 里 的 物化 视图 像 视图 那样 使 用 规则 系统 ， 但 是 用 类 表 的 形式 保存 结果 。 


CREATE MATERIALIZED VIEW mymatview AS SELECT * FROM mytab 


和 : 
CREATE TABLE mymatview AS SELECT * FROM mytab; 
之 间 最 主要 的 区 别 是 物化 视图 不 能 随后 直接 被 更 新 ， 并 且 创 建物 化 视图 的 查询 就 像 视 图 的 查 
询 存储 那样 存储 ， 所 以 新 数据 可 以 用 下 面 命令 产生 : 
REFRESH MATERIALIZED VIEW mymatview; 
PostgreSQL 系 统 目录 中 有 关 物 化 视图 的 信息 和 表 或 视图 的 信息 一 样 。 所 以 对 于 解析 器 ， 物 化 


视图 是 一 个 关系 ， 就 像 一 个 表 或 一 个 视图 。 当 在 查询 中 引用 一 个 物化 视图 时 ， 数据 直接 从 物 
化 视图 返回 ， 就 像 从 一 个 表 返 回 ; 规则 只 是 用 来 填充 物化 视图 。 


当 访问 存储 在 物化 视图 中 的 数据 时 ， 通 常 比 直 接 访问 底层 表 或 通过 一 个 视图 更 快 ， 数据 并 不 
总 是 当前 的 ; 然而 有 时 不 需要 当前 数据 。 考 虑 一 个 记录 销售 的 表 : 


CREATE TABLE invoice ( 


invoice_no integer PRIMARY KEY, 
seller_no integer, -- 销售 人 员 的 ID 
invoice_date date, -- 销售 日 期 
invoice_amt numeric(13,2) -- 销售 数量 


Ne 


如 果 人 们 希望 能 够 快速 的 图 形 化 历史 销售 数据 ， 他 们 可 能 想 要 汇总 ， 可 能 不 关心 当前 未 完成 
的 数据 : 


CREATE MATERIALIZED VIEW sales_summary AS 
SELECT 
seller_no, 
invoice_date, 
sum(invoice_amt)::numeric(13,2) as sales_amt 
FROM invoice 
WHERE invoice_date < CURRENT_DATE 
GROUP BY 
seller_no, 
invoice_date 
ORDER BY 
seller_no, 
invoice_date; 


CREATE UNIQUE INDEX sales_summary_seller 
ON sales_summary (seller_no, invoice_date); 


物化 视图 可 以 用 来 在 为 销售 人 员 创 建 的 控制 面板 上 显示 图 形 。 可 以 使 用 下 面 的 SQL 语句 在 每 
天 晚上 更 新 统计 数据 : 


REFRESH MATERIALIZED VIEW sales_summary; 


物化 视图 的 另 一 个 用 处 是 允许 对 远程 系统 中 的 数据 快速 访问 ， 通 过 一 个 外 部 数据 封装 器 。 下 
面 是 一 个 简单 的 使 用 file_fdw 的 例子 ， 有 计时 ， 但 是 因为 这 是 使 用 的 在 本 地 系统 的 缓存 ， 外 
部 数据 封装 器 到 远程 系统 的 性 能 可 能 更 大 。 


CREATE EXTENSION file_fdw; 
CREATE SERVER local_file FOREIGN DATA WRAPPER file_fdw; 
CREATE FOREIGN TABLE words (word text NOT NULL) 
SERVER local_file 
OPTIONS (filename '/etc/dictionaries-common/words' ); 
CREATE MATERIALIZED VIEW wrd AS SELECT * FROM words; 
CREATE UNIQUE INDEX wrd_word ON wrd (word); 
CREATE EXTENSION pg_trgm,; 
CREATE INDEX wrd_trgm ON wrd USING gist (word gist_trgm_ops); 
VACUUM ANALYZE wrd; 


现在 让 我 们 拼写 检查 一 个 单词 。 直 接 使 用 file_fdw 
SELECT count(*) FROM words WHERE word = 'caterpiler'; 


计划 是 : 


Aggregate (cost=4125.19. .4125.20 rows=1 width=0) (actual time=26.013..26.014 rows=1 loo 
-> Foreign Scan on words (cost=0.00..4124.70 rows=196 width=0) (actual time=26.011.. 
Filter: (word = 'caterpiler'::text) 
Rows Removed by Filter: 99171 
Foreign File: /etc/dictionaries-common/words 
Foreign File Size: 938848 
Total runtime: 26.081 ms 


JI 
如 果 使 用 物化 视图 ， 查 询 更 快速 : 





Aggregate (cost=4.44..4.45 rows=1 width=0) (actual time=0.074..0.074 rows=1 loops=1) 
-> Index Only Scan using wrd_word on wrd (cost=0.42..4.44 rows=1 width=0) (actual ti 
Index Cond: (word = 'caterpiler'::text) 
Heap Fetches: 0 
Total runtime: 0.119 ms 


E EE] 
无 论 哪 种 方式 ， 这 个 词 的 拼写 是 错误 的 ， 所 以 我 们 看 看 我 们 想 要 的 。 还 是 使 用 file_fdw 


ad) 





SELECT word FROM words ORDER BY word <-> 'caterpiler' LIMIT 10; 


cater 
caterpillar 
Caterpillar 
caterpillars 
caterpillar's 
Caterpillar's 
caterer 
caterer's 
caters 
catered 

(10 rows) 


Limit (cost=2195.70..2195.72 rows=10 width=32) (actual time=218.904..218.906 rows=10 lo 
-> Sort (cost=2195.70..2237.61 rows=16765 width=32) (actual time=218.902..218.904 ro 
Sort Key: ((word <-> 'caterpiler'::text)) 
Sort Method: top-N heapsort Memory: 25kB 
-> Foreign Scan on words (cost=0.00..1833.41 rows=16765 width=32) (actual time 
Foreign File: /etc/dictionaries-common/words 
Foreign File Size: 938848 
Total runtime: 218.966 ms 


E] 
使 用 物化 视图 : 





Limit (cost=0.28..1.02 rows=10 width=9) (actual time=24.916..25.079 rows=10 loops=1) 
-> Index Scan using wrd_trgm on wrd (cost=0.28..7383.70 rows=99171 width=9) (actual 
Order By: (word <-> 'caterpiler'::text) 
Total runtime: 25.884 ms 


SSS SSS SS 
如 果 你 能 允许 定期 更 新 远程 数据 到 本 地 数据 库 ， 会 带 来 可 观 的 性 能 优势 。 





38.4. 在 INSERT , UPDATE ,和 DELETE 上 的 规 
mi 
定义 在 INSERT , UPDATE , DELETE 上 的 规则 与 前 一 章 描述 的 视图 规则 完全 不 同 。 首 先 ， 他 们 
的 CREATE RULE 命令 允许 更 多 : 

。 它们 可 以 没有 动作 。 

。 它们 可 以 有 多 个 动作 。 

e 他 们 可 以 是 Insta 或 ALso ( 缺 省 )。 

e HAR new 和 oo 变 得 有 用 了 。 

。 它们 可 以 有 规则 资格 条 件 。 


第 二 ， 它 们 不 是 就 地 修改 查询 树 ， 而 是 创建 雳 个 或 多 个 新 查询 树 并 且 可 能 把 原始 的 那个 扔 
掉 。 


38.4.1. 更 新 规则 是 如 何 运 转 的 
把 下 面 语 法 : 


CREATE [ OR REPLACE ] RULE _name_ AS ON _event_ 
TO _table_ [ WHERE _condition_ ] 
DO [ ALSO | INSTEAD ] { NOTHING | _command_ | ( _command_ ; _command_... ) } 


Ezt, ERARE, update rules( 更 新 规则 ) 意 思 是 定义 在 INSERT, UPDATE , 3% 
DELETE 上 的 规则 。 

如 果 坦 询 树 的 结果 关系 和 命令 类 型 与 cREATE RULE 命令 里 给 出 的 对 象 和 事件 一 样 的 话 ， 规则 
系统 就 把 更 新 规则 应 用 上 去 。 对 于 更 新 规则 ， 规 则 系统 创建 一 个 查询 树 列表 。 一 开始 查询 树 
是 空 的 ， 这 里 可 以 有 需 个 ( NoTHING 关键 字 )、 一 个 、 或 多 个 动作 。 为 简单 起 见 ， 先 看 一 个 只 
有 一 个 动作 的 规则 。 这 个 规则 可 以 有 需 个 或 一 个 条 件 并 且 它 可 以 是 INsTEAD 或 aso ( 缺 省 )。 
何 为 规则 条 件 ? 它 是 一 个 限制 条 件 ， 告 诉 规则 动作 什么 时 候 要 人 做， 什么 时 候 不 要 做 。 这 个 条 件 
可 以 只 引用 new 和 /或 oo HAM, 它们 基本 上 是 代表 以 对 象形 式 给 出 的 基本 关系 (但 是 有 着 
特殊 含义 )。 

所 以 ， 对 这 个 单 动作 的 规则 生成 查询 树 ， 有 下 面 三 种 情况 。 


没有 条 件 ， 也 没有 ALso 或 INSTEAD 


来 自 规 则 动作 的 查询 树 ， 附 加 了 原始 查询 树 的 条 件 。 


给 出 了 条 件 ， 有 ALso 
来 自 规 则 动作 的 带 有 规则 条 件 的 查询 树 并 且 附 加 了 原始 查询 树 的 条 件 。 
给 出 了 条 件 ， 有 INSTEAD 


来 自 规则 动作 带 有 规则 条 件 的 查询 树 以 及 原始 查询 树 的 条 件 ; 以 及 附加 了 相反 规则 条 件 的 原 
始 查询 树 。 


最 后 ， 如 果 规 则 是 ALso ， 那 么 最 初 未 修改 的 查询 树 被 加 入 到 列表 。 因为 只 有 合格 
的 INSTEAD 规则 已 经 在 初始 的 查询 树 里 面 ， 所 以 对 于 单 动作 规则 最 终 得 到 一 个 或 者 两 个 查询 
树 。 


对 于 ON INSERT 规则 ， 原 来 的 查询 (如 果 没 有 被 instead 取代 ) 是 在 任何 规则 增加 的 动作 之 前 完 
成 的 。 这 样 就 允许 动作 看 到 插入 的 行 。 但 是 对 oN UPDATE 和 on DELETE 规则 ， 原 来 的 查 ne 
在 规则 增加 的 动作 之 后 完成 的 。 这 样 就 确保 动作 可 以 看 到 将 要 更 新 或 者 将 要 删除 的 行 

则 ， 动 作 可 能 什么 也 不 做 ， 因为 它们 发 现 没有 符合 它们 要 求 的 行 。 


从 规则 动作 生成 的 查询 树 被 再 次 送 到 重 写 系 统 ， 并 且 可 能 附加 更 多 的 规则 ， 结 果 是 更 多 的 或 
更 少 的 查询 树 。 所 以 规则 动作 必须 是 另 一 个 命令 类 型 或 者 和 规则 所 在 的 关系 不 同 的 另 一 个 结 
RAR, 否则 这 桩 的 递归 过 程 就 会 没完 没 了 (规则 的 递 规 展开 会 被 检测 到 ， 并 当 作 一 个 错误 报 


告 )。 


在 pg_rewrite 系统 表 中 action 里 的 查询 树 只 是 模板 。 因为 他 们 可 以 引用 范围 表 

的 new 和 oLp ， 在 使 用 它们 之 前 必须 做 一 些 调整 。 对 于 任何 对 new 的 引用 ， 都 要 先 在 初始 
查询 的 目标 列 中 搜索 对 应 的 条 目 。 如 果 找 到 ， 把 该 条 目 表 达 式 放 到 引用 里 。 否 

则 new 和 oLp 的 含义 一 样 (对 于 UPDATE ) 或 者 被 NULL 替代 (对 于 insert )。 任 何 对 oLp 的 引 
用 都 用 结果 关系 的 范围 表 的 引用 蔡 换 。 


在 系统 完成 更 新 规则 的 附加 之 后 ， 它 再 附加 视图 规则 到 生成 的 查询 树 上 。 视 图 无 法 插入 新 的 
更 新 动作 ， 所 以 没有 必要 向 视图 重 写 的 输出 附加 更 新 规则 。 


38.4.1.1. 循序 渐进 的 第 一 个 规则 


假设 希望 跟踪 shoelace_data 关系 中 的 sl_avail 字段 。 所 以 设置 一 个 日 志 表 和 一 条 规则 ， 这 
条 规则 每 次 在 用 uPpATE 更 新 shoelace data 表 时 都 要 往 数 据 库 里 写 一 条 记录 。 


CREATE TABLE shoelace_log ( 


sl_name text, -- 鞋 带 变化 了 
sl_avail integer, -- 新 的 可 用 数值 
log_who text, -- 谁 干 的 
log_when timestamp -- 什么 时 候 


) 
CREATE RULE log_shoelace AS ON UPDATE TO shoelace_data 
WHERE NEW.sl_avail <> OLD.sl_avail 
DO INSERT INTO shoelace_log VALUES ( 
NEW.sl_name, 
NEW.sl_avail, 
current_user, 
current_timestamp 


); 


现在 有 人 键入 : 


UPDATE shoelace_data SET sl_avail = 6 WHERE sl_name = 's17'; 


然后 看 看 日 志 表 : 


SELECT * FROM shoelace_log; 
sl_name | sl_avail | log_who | log_when 


s17 | 6 | Al | Tue Oct 20 16:14:45 1998 MET DST 


这 是 想 要 的 。 后 端 发 生 的 事情 如 下 。 分 析 器 创建 查询 树 : 


UPDATE shoelace_data SET sl_avail = 6 
FROM shoelace_data shoelace_data 
WHERE shoelace_data.sl_name = 's17'; 


这 里 是 一 个 带 有 条 件 表 达 式 的 ON UPDATE 规则 log shoelace 


NEW.sl_avail <> OLD.sl_avail 


和 动作 : 


INSERT INTO shoelace_log VALUES ( 
new.sl_name, new.sl_avail, 
current_user, current_timestamp ) 

FROM shoelace_data new, shoelace_data old; 


这 个 输出 看 起 来 有 点 奇怪 ， 因 为 你 不 能 写 INSERT ... VALUES... FROM, 这 里 的 FRoM FOR 
是 表示 查询 树 里 有 用 于 new 和 old 的 范围 表 记 录 。 这 些 东 西 的 存在 是 因为 这 样 一 来 它们 就 可 
以 被 INSERT 命令 的 查询 树 里 的 变量 引用 。 


该 规则 是 一 个 有 条 件 的 aso 规则 ， 所 以 规则 系统 必须 返回 两 个 查询 树 : 更 改过 的 规则 动作 
和 原始 查询 树 。 在 第 一 步 里 ， 原 始 查询 的 范围 表 集成 到 规则 动作 查询 树 里 。 生 成 : 


INSERT INTO shoelace_log VALUES ( 
new.sl_name, new.sl_avail, 
current_user, current_timestamp ) 

FROM shoelace_data new, shoelace_data old, 
**shoelace_data shoelace_data**; 


第 二 步 把 规则 条 件 增加 进去 ， 所 以 结果 集 限 制 为 sl_avail 改变 了 的 行 : 


INSERT INTO shoelace_log VALUES ( 
new.sl_name, new.sl_avail, 
current_user, current_timestamp ) 

FROM shoelace_data new, shoelace_data old, 
shoelace_data shoelace_data 
**WHERE new.sl_avail <> old.sl_avail**; 


这 个 东西 看 起 来 更 奇怪 ， 因 为 insert... VALUES 也 没有 were FH, 不 过 规划 器 和 执行 器 
对 此 并 不 在 意 。 它 们 毕竟 还 要 为 INSERT ... SELECT 支持 这 种 功能 。 


第 三 步 把 原始 查询 树 的 条 件 加 进去 ， 把 结果 集 进 一 步 限制 成 只 有 被 初始 查询 树 改 变 的 行 : 


INSERT INTO shoelace_log VALUES ( 
new.sl_name, new.sl_avail, 
current_user, current_timestamp ) 

FROM shoelace_data new, shoelace_data old, 
shoelace_data shoelace_data 

WHERE new.sl_avail <> old.sl_avail 

**AND shoelace_data.sl_name = 'sl17'**; 


第 四 步 把 NEw 引用 蔡 换 为 从 原始 查询 树 来 的 目标 列 或 从 结果 关系 来 的 相 匹 配 的 变量 引用 : 


INSERT INTO shoelace_log VALUES ( 
**shoelace_data.sl_name**, **6**, 
current_user, current_timestamp ) 

FROM shoelace_data new, shoelace_data old, 
shoelace_data shoelace_data 
WHERE **6** <> old.sl_avail 
AND shoelace_data.sl_name = 's17'; 


第 五 步 用 结果 关系 引用 把 oLp 引用 替换 掉 : 


INSERT INTO shoelace_log VALUES ( 
shoelace_data.sl_name, 6, 
current_user, current_timestamp ) 

FROM shoelace_data new, shoelace_data old, 
shoelace_data shoelace_data 
WHERE 6 <> **shoelace_data.sl_avail** 
AND shoelace_data.sl_name = 'sl7'; 


这 就 成 了 。 因 为 规则 aso 还 输出 原始 查询 树 。 简 而 言 之 ， 从 规则 系统 输出 的 是 一 个 两 个 查 
询 树 的 列表 ， 和 与 下 面 语句 相同 : 


INSERT INTO shoelace_log VALUES ( 
shoelace_data.sl_name, 6, 
current_user, current_timestamp ) 

FROM shoelace_data 
WHERE 6 <> shoelace_data.sl_avail 
AND shoelace_data.sl_name = 's17'; 


UPDATE shoelace_data SET sl_avail = 6 
WHERE sl_name = 's17'; 


这 就 是 执行 的 顺序 以 及 规则 要 做 的 事情 。 
做 的 替换 和 追加 的 条 件 用 于 确保 如 果 原 始 的 查询 是 下 面 这 样 


UPDATE shoelace_data SET sl color = 'green' 
WHERE sl_name = 's17'; 


就 不 会 有 日 期 记录 写 到 表 里 。 因 为 这 回 原始 查询 树 不 包含 有 关 sl_avail 的 目标 列 
X, NEw.sl_avail 将 被 shoelace_data.sl avail 代替 ， 所 以 ， 规 则 生成 的 额外 命令 是 : 


INSERT INTO shoelace_log VALUES ( 
shoelace_data.sl_name, **shoelace_data.sl_avail**, 
current_user, current_timestamp ) 
FROM shoelace_data 
WHERE **shoelace_data.sl_avail** <> shoelace_data.sl_avail 
AND shoelace_data.sl_name = 's17'; 


并 且 条 件 将 永远 不 可 能 是 真 值 。 
如 果 最 初 的 查询 修改 多 个 行 ， 它 也 能 运行 。 所 以 如 果 写 出 下 面 命令 


UPDATE shoelace_data SET sl_avail = 
WHERE sl_color = 'black'; 


实际 上 有 四 行 被 更 新 ( sl1 ，sl2 ，s13 ,和 sis), 但 sis 已 经 是 sl_avail = 


始 的 查询 树 条 件 已 经 不 一 样 了 ， 结果 是 规则 生成 下 面 的 额外 查询 树 : 


INSERT INTO shoelace_log 
SELECT shoelace_data.sl_name, 0, 
current_user, current_timestamp 
FROM shoelace_data 
WHERE 0 <> shoelace_data.sl_avail 
AND **shoelace_data.sl_color = 'black'**; 


到 这 里 就 明白 为 什么 原始 查询 树 最 后 执行 非常 重要 。 如 果 upate 将 先 被 执行 ， 


0 。 这 回 ， 原 
所 有 的 行 都 已 


经 设 为 需 ， 所 以 记 日 志 的 insert 将 不 能 找到 任何 符合 o alt;agt; shoelace_data.sl_avail 条 


件 的 行 。 


38.4.2. 与 视图 合作 


一 个 保护 视图 关系 ， 使 其 避免 有 人 可 以 在 其 中 INSERT ，UPDATE , DELETE 的 简单 方法 是 让 那些 
查询 树 被 丢弃 。 创 建 下 面 规 则 : 


CREATE RULE shoe_ins_protect AS ON INSERT TO shoe 
DO INSTEAD NOTHING; 

CREATE RULE shoe_upd_protect AS ON UPDATE TO shoe 
DO INSTEAD NOTHING; 

CREATE RULE shoe_del_protect AS ON DELETE TO shoe 
DO INSTEAD NOTHING; 


如 果 现 在 任何 人 试图 对 视图 关系 shoe 做 上 面 的 任何 操作 ， 规则 系统 将 应 用 这 些 规则 。 因 为 
这 些 规则 没有 动作 而 且 是 INsTEAD ， 结果 是 生成 的 查询 树 将 是 空 的 并 且 整 个 查询 将 变 得 空空 
如 也 ， 因为 经 过 规则 系统 处 理 后 没有 什么 东西 剩 下 来 用 于 优化 或 执行 了 。 


一 个 更 复杂 的 使 用 规则 系统 的 方法 是 用 规则 系统 创建 一 个 重 写 查询 树 的 规则 ， 使 查询 树 对 真 
实 的 表 进 行 正确 的 操作 。 要 在 视图 shoelace 上 做 这 个 工作 ， 创建 下 面 规则 : 


CREATE RULE shoelace_ins AS ON INSERT TO shoelace 
DO INSTEAD 
INSERT INTO shoelace_data VALUES ( 
NEW.sl_name, 
NEW.sl_avail, 
NEW.sl_color, 
NEW.sl_len, 
NEW.sl_unit 


); 


CREATE RULE shoelace_upd AS ON UPDATE TO shoelace 
DO INSTEAD 
UPDATE shoelace_data 
SET sl_name = NEW.sl_name, 
sl_avail = NEW.sl_avail, 
sl_color = NEW.sl_color, 
sl_len = NEW.s1_len, 
sl_unit = NEW.sl_unit 
WHERE sl_name = OLD.sl_name; 
CREATE RULE shoelace_del AS ON DELETE TO shoelace 
DO INSTEAD 
DELETE FROM shoelace_data 
WHERE sl_name = OLD.sl_name; 


如 果 你 打算 在 视图 上 支持 RETURNING 查询 ， 就 要 让 规则 包含 RETURNING 计算 视图 行 数 的 子 
句 。 这 对 于 基于 单个 表 的 视图 来 说 通常 非常 琐碎 ， 但 是 连接 诸如 shoelace 之 类 的 视图 很 单调 
乏味 。 一 个 插入 情况 的 例子 如 下 : 


CREATE RULE shoelace_ins AS ON INSERT TO shoelace 
DO INSTEAD 
INSERT INTO shoelace_data VALUES ( 
NEW.sl_name, 
NEW.sl_avail, 
NEW.sl_color, 
NEW.sl_len, 
NEW.sl_unit 


RETURNING 
shoelace_data.*, 
(SELECT shoelace_data.sl_len * u.un_fact 
FROM unit u WHERE shoelace_data.sl_unit = u.un_name); 


注意 ， 这 个 规则 同时 支持 该 视图 上 的 INSERT 和 INSERT RETURNING 查询 ， INSERT 将 简单 的 忽 
略 RETURNING 子 句 。 


假设 现在 有 一 包 鞋 带 到 达 商 店 ， 还 有 一 个 大 的 部 件 列表 。 但 是 不 想 每 次 都 手工 更 新 
shoelace 视图 。 取而代之 的 是 创建 了 两 个 小 表 : 一 个 是 可 以 从 到 货 清单 中 插入 东西 ， 另 一 个 
是 一 个 特殊 的 技巧 。 创 建 这 些 的 命 分 如 下 : 


CREATE TABLE shoelace_arrive ( 
arr_name text, 
arr_quant integer 


); 


CREATE TABLE shoelace ok ( 
ok_name text, 
ok_quant integer 


); 

CREATE RULE shoelace_ok_ins AS ON INSERT TO shoelace_ok 
DO INSTEAD 
UPDATE shoelace 


SET sl_avail = sl_avail + NEW.ok_quant 
WHERE sl_name = NEW.ok_name; 


现在 你 可 以 用 来 自 部 件 列表 的 数据 填充 表 shoelace_arrive T : 


SELECT * FROM shoelace_arrive; 


arr_name | arr_quant 


s13 | 10 

s16 | 20 

s18 | 20 
(3 rows) 


jE FR 1 bh — IRRA, 


SELECT * FROM shoelace; 


sl_name | sl_avail | sl_color | sl_len | sl_unit | sl_len_cm 

Sao es aces (ha te See Set tS ene Se eite= eae ere Seer mn eS 
sl1 | 5 | black | 80 | cm | 80 
s12 | 6 | black | 100 | cm | 100 
s17 | 6 | brown | 60 | cm | 60 
$13 | © | black | 35 | inch | 88.9 
sl4 | 8 | black | 40 | inch | 101.6 
s18 | 1 | brown | 40 | inch | 101.6 
s15 | 4 | brown | 1 |m | 100 
s16 | © | brown | 0.9 | m | 90 
(8 rows) 


把 到 货 鞋 带 移 到 (shoelace_ok) 中 : 


INSERT INTO shoelace ok SELECT * FROM shoelace_arrive; 


然后 检查 结果 : 


SELECT * FROM shoelace ORDER BY sl_name; 


sl_name | sl_avail | sl_color | sl_len | sl_unit | sl_len_cm 

EE TE Sth S oS Sea Sethe Sas aS aAa o aa ae 
sl1 | 5 | black | 80 | cm | 80 
s12 | 6 | black | 100 | cm | 100 
s17 | 6 | brown | 60 | cm | 60 
sl4 | 8 | black | 40 | inch | 101.6 
s13 | 10 | black | 35 | inch | 88.9 
s18 | 21 | brown | 40 | inch | 101.6 
s15 | 4 | brown | 1 |m | 100 
s16 | 20 | brown | 0.9 |m | 90 
(8 rows) 


SELECT * FROM shoelace_log; 
sl_name | sl_avail | log_who| log_when 


| | Tue Oct 20 19:14:45 1998 MET DST 
| | Tue Oct 20 19:25:16 1998 MET DST 
s16 | 20 | Al | Tue Oct 20 19:25:16 1998 MET DST 
| | Tue Oct 20 19:25:16 1998 MET DST 


从 INSERT ... SELECT 语句 到 这 个 结果 经 过 了 长 长 的 一 段 过 程 。 而 且 对 查询 树 转化 的 描述 将 是 
本 文档 的 最 后 。 首 先是 生成 分 析 器 输出 : 


INSERT INTO shoelace_ok 
SELECT shoelace_arrive.arr_name, shoelace_arrive.arr_quant 
FROM shoelace_arrive shoelace_arrive, shoelace_ok shoelace_ok; 


现在 应 用 第 一 条 规则 shoelace_ok_ins 把 它 转换 成 : 


UPDATE shoelace 
SET sl_avail = shoelace.sl_avail + shoelace_arrive.arr_quant 
FROM shoelace_arrive shoelace_arrive, shoelace_ok shoelace_ok, 
shoelace_ok old, shoelace_ok new, 
shoelace shoelace 
WHERE shoelace.sl_name = shoelace_arrive.arr_name; 


并 且 把 原始 的 对 shoelace_ok 的 INSERT 丢弃 掉 。 这 样 重 写 后 的 查询 再 次 传 入 规则 系统 并 且 第 
二 次 应 用 了 规则 shoelace_upd 生成 : 


UPDATE shoelace_data 
SET sl_name = shoelace.sl_name, 
sl_avail = shoelace.sl_avail + shoelace_arrive.arr_quant, 
sl_color = shoelace.sl_color, 
sl_len = shoelace.sl_len, 
sl_unit = shoelace.sl_unit 
FROM shoelace_arrive shoelace_arrive, shoelace_ok shoelace_ok, 
shoelace_ok old, shoelace_ok new, 
shoelace shoelace, shoelace old, 
shoelace new, shoelace_data shoelace_data 
WHERE shoelace.sl_name = shoelace_arrive.arr_name 
AND shoelace_data.sl_name = shoelace.sl_name; 


同样 这 是 一 个 Instead 规则 | 并 且 前 一 个 查 询 树 被 丢弃 掉 。 注意 这 个 查询 仍然 是 使 用 视 
shoelace ， 但 是 规则 系统 还 没有 完成 这 一 步 ， 所 以 它 继续 在 这 上 面 应 用 规则 _RETURN ， 然 
后 得 到 : 


UPDATE shoelace_data 
SET sl_name = s.sl_name, 
sl_avail = s.sl_avail + shoelace_arrive.arr_quant, 
sl_color = s.sl_color, 
sl_len = s.sl_len, 
sl_unit = s.sl_unit 
FROM shoelace_arrive shoelace_arrive, shoelace_ok shoelace_ok, 
shoelace_ok old, shoelace_ok new, 
shoelace shoelace, shoelace old, 
shoelace new, shoelace_data shoelace_data, 
shoelace old, shoelace new, 
shoelace_data s, unit u 
WHERE s.Sl_name = shoelace_arrive.arr_name 
AND shoelace_data.sl_name = s.sl_name; 


最 后 ， 应 用 规则 log shoelace ， 生 成 额外 的 查询 树 : 


INSERT INTO shoelace_log 
SELECT s.sl_name, 
s.sl_avail + shoelace_arrive.arr_quant, 
current_user, 
current_timestamp 
FROM shoelace_arrive shoelace_arrive, shoelace_ok shoelace_ok, 
shoelace_ok old, shoelace_ok new, 
shoelace shoelace, shoelace old, 
shoelace new, shoelace_data shoelace_data, 
shoelace old, shoelace new, 
shoelace_data s, unit u, 
shoelace_data old, shoelace_data new 
shoelace_log shoelace_log 
WHERE s.Sl_name = shoelace_arrive.arr_name 
AND shoelace_data.sl_name = s.sl_name 
AND (s.Sl_avail + shoelace_arrive.arr_quant) <> s.sl_avail; 


这 样 ， 在 规则 系统 用 完 所 有 的 规则 后 返回 生成 的 查询 树 。 
所 以 最 终 得 到 两 个 等 效 于 下 面 SQL 语句 的 查询 树 : 


INSERT INTO shoelace_log 
SELECT s.sl_name, 
s.sl_avail + shoelace_arrive.arr_quant, 
current_user, 
current_timestamp 
FROM shoelace_arrive shoelace_arrive, shoelace_data shoelace_data, 
shoelace_data s 
WHERE s.Sl_name = shoelace_arrive.arr_name 
AND shoelace_data.sl_name = s.sl_name 
AND s.Sl_avail + shoelace_arrive.arr_quant <> s.sl_avail; 


UPDATE shoelace_data 
SET sl_avail = shoelace_data.sl_avail + shoelace_arrive.arr_quant 
FROM shoelace_arrive shoelace_arrive, 
shoelace_data shoelace_data, 
shoelace_data s 
WHERE s.Sl_name = shoelace_arrive.sl_name 
AND shoelace_data.sl_name = s.sl_name; 


结果 是 从 一 个 关系 来 的 数据 插入 到 另 一 个 中 ， 到 了 第 三 个 中 变 成 更 新 ， 在 到 第 四 个 中 变 成 更 
新 加 上 记 日 志 ， 最 后 在 第 五 个 规则 中 缩减 为 两 个 查询 。 


有 一 个 小 细节 有 点 让 人 难受 。 看 看 生成 的 两 个 查询 ， 会 发 现 shoelace_data 关系 在 范围 表 中 
出 现 了 两 次 而 实际 上 绝对 可 以 缩 为 一 次 。 因 为 规划 器 不 处 理 这 些 ， 所 以 对 规则 系统 输出 
的 INSERT 的 执行 规划 会 是 


Nested Loop 
-> Merge Join 
-> Seq Scan 
-> Sort 
-> Seq Scan on s 
-> Seq Scan 
-> Sort 
-> Seq Scan on shoelace_arrive 
-> Seq Scan on shoelace_data 


在 省 略 多 余 的 范围 表 后 的 结果 将 是 


Merge Join 
-> Seq Scan 
-> Sort 
-> Seq Scan on s 
-> Seq Scan 
-> Sort 
-> Seq Scan on shoelace_arrive 


这 也 会 在 日 志 关 系 中 生成 完全 一 样 的 记录 。 因 此 ， 规 则 系统 导致 对 表 shoelace_data 的 一 次 
多 余 的 打 描 ， 而 且 同 样 多 余 的 打 描 会 在 uor 里 也 一 样 多 做 一 次 。 不 过 要 想 把 这 些 不 足 去 掉 
是 一 样 太 困难 的 活 了 。 


最 后 对 PostgreSQL 规 则 系统 及 其 功能 做 一 个 演示 。 假设 你 向 你 的 数据 库 中 添加 一 些 比 较 罕见 
的 鞋 带 : 


INSERT INTO shoelace VALUES ('sl19', ©, 'pink', 35.0, 'inch', 0.0); 
INSERT INTO shoelace VALUES ('sl10', 1000, 'magenta', 40.0, 'inch', 0.0); 


建立 一 个 视图 检查 哪 种 shoelace 记录 在 颜色 上 和 任何 鞋子 都 不 相配 。 用 于 这 个 的 视图 是 : 


CREATE VIEW shoelace_mismatch AS 
SELECT * FROM shoelace WHERE NOT EXISTS 
(SELECT shoename FROM shoe WHERE slcolor = sl_color); 


它 的 输出 是 : 


SELECT * FROM shoelace_mismatch; 


sl_name | sl_avail | sl_color | sl len | sl_unit | sl_len_cm 
sas eseae= 站 
S19 | 9 | pink | 35 | inch | 88.9 
s110 | 1000 | magenta | 40 | inch | 101.6 


现在 想 这 样 设置 : 没有 库存 的 不 匹配 的 鞋 带 都 从 数据 库 中 删除 。 为 了 让 这 事 对 PostgreSQL 
点 难度 ， 不 直接 删除 它们 。 取而代之 的 是 再 创建 一 个 视图 : 


CREATE VIEW shoelace can delete AS 
SELECT * FROM shoelace_mismatch WHERE sl_avail = 0; 


然后 用 下 面 方法 做 : 


DELETE FROM shoelace WHERE EXISTS 
(SELECT * FROM shoelace_can_delete 
WHERE sl_name = shoelace.sl_name); 


Frà: 


SELECT * FROM shoelace; 


sl_name | sl_avail | sl_color | sl_len sl_unit | sl_len_cm 


Sapa seae= eee meld ores Ca a ans e rte 
sl1 | 5 | black | 80 | cm | 80 
s12 | 6 | black | 100 | cm | 100 
s17 | 6 | brown | 60 | cm | 60 
sl4 | 8 | black | 40 | inch | 101.6 
s13 | 10 | black | 35 | inch | 88.9 
s18 | 21 | brown | 40 | inch | 101.6 
s110 | 1000 | magenta | 40 | inch | 101.6 
s15 | 4 | brown | 1 |m | 100 
s16 | 20 | brown | 0.9 |m | 90 

(9 rows) 


对 一 个 视图 的 LT, RPRMAFA-T RAR T OPMRE/FENRAANF AWARE, 
这 四 个 视图 之 一 本 身 有 一 个 拥有 对 一 个 视图 的 子 查询 条 件 ， 该 条 件 计 算 使 用 的 视图 的 列 ; 最 
后 重 写成 了 一 个 查询 树 ， 该 查询 树 从 一 个 真正 的 表 里 面 把 需要 删除 的 数据 删除 。 





我 想 在 现实 世界 里 只 有 很 少 的 机 会 需要 上 面 的 这 样 的 构造 。 但 这 些 东 西 能 运转 肯定 让 你 舒 
服 。 


38.5. 规则 和 权限 


由 于 PostgreSQL 规 则 系统 对 查询 的 重 写 ， 非 初 始 查询 指定 的 其 它 表 /视图 被 访问 。 使 用 更 新 
规则 的 时 候 ， 这 可 能 包括 对 表 的 写 权 限 。 


重 写 规则 并 不 拥有 一 个 独立 的 所 有 者 。 关 系 ( 表 或 视图 ) 的 所 有 者 自动 成 为 重 写 规 则 的 缺 省 所 有 
者 。 PostgreSQL 规 则 系统 改变 缺 省 的 访问 控制 系统 的 特性 。 因 规 则 而 使 用 的 关系 要 对 定义 
规则 所 有 者 进行 权限 检查 ， 而 不 是 激活 规则 的 用 户 ， 这 意味 着 一 个 用 户 只 需要 对 他 的 查询 里 
明确 指定 的 表 / 视 图 拥有 所 需 的 权限 就 可 进行 操作 。 


例如 : 某 用 户 有 一 个 电话 号 码 列表 ， 其 中 一 些 是 私人 的 ， 另 外 的 一 些 是 办 公 室 秘书 需要 的 。 
他 可 以 用 下 面 方法 构建 查询 : 


CREATE TABLE phone_data (person text, phone text, private boolean); 
CREATE VIEW phone_number AS 
SELECT person, CASE WHEN NOT private THEN phone END AS phone 
FROM phone_data; 
GRANT SELECT ON phone_number TO secretary; 


除了 他 以 外 (还 有 数据 库 超级 用 户 ) 没 有 人 可 以 访问 phone_data Ro 但 因为 GRANT MIRA, 4 
书 可 以 从 phone_number 视图 上 运行 SELECT 。 规 则 系统 将 把 从 phone_number 里 的 seLEcT Æ 
EAM phone_data 里 的 SELECT 。 因 为 用 户 是 phone_number 的 所 有 者 ， 因此 也 是 规则 的 所 有 
者 ， 所 以 现在 要 检查 他 对 phone_data 的 读 访问 的 权限 ， 而 这 个 查询 是 被 允许 的 。 同 时 也 要 检 
查访 问 phone_number 的 权限 ， 但 这 是 对 一 个 被 撤消 权限 的 用 户 进行 检查 的 ， 所 以 除了 用 户 自 
己 和 秘书 外 没有 人 可 以 使 用 它 。 


权限 检查 是 按 规则 逐条 进行 的 。 所 以 此 时 的 秘书 是 唯一 的 一 个 可 以 看 到 公共 电话 号 码 的 人 。 
但 秘书 可 以 设立 另 一 个 视图 并 且 赋 予 该 视图 公共 权限 。 这 样 ， 任何 人 都 可 以 通过 秘书 的 视图 
看 到 phone_number 数据 。 秘书 不 能 做 的 事情 是 创建 一 个 直接 访问 phone_data 的 视图 (实际 上 
他 是 可 以 的 ， 但 没有 任何 作用 ， 因 为 每 个 访问 都 会 因 通 不 过 权限 检查 而 被 踢 出 事务 )。 而 且 用 
户 很 快 会 认识 到 ， 秘书 开放 了 他 的 phone_number 视图 后 ， 他 还 可 以 撤消 他 的 访问 权限 。 这 
样 ， 所 有 对 秘书 视图 的 访问 马上 就 失效 了 。 


有 些 人 会 认为 这 种 逐条 规则 的 检查 是 一 个 安全 漏洞 ， 但 事实 上 不 是 。 如 果 这 样 做 不 能 奏效 ， 
秘书 将 必须 建立 一 个 与 phone_number 有 相同 字段 的 表 并 且 每 天 拷贝 一 次 数据 进去 。 那么 这 是 
他 自己 的 数据 因而 可 以 赋予 其 它 人 访问 的 权力 。 一 个 GRANT 意味 着 "我 信任 你 "。 如 果 某 个 你 
信任 的 人 做 了 上 面 的 事情 ， 那 你 就 该 想 想 是 否 该 REVOKE 了 。 


请 注意 ， 当 视图 可 以 用 来 隐藏 使 用 了 上 面 的 技术 的 特定 的 内 容 时 ， 它们 不 能 用 来 可 靠 地 隐藏 
在 不 可 视 的 行 的 数据 ， 除 非 已 经 设置 了 security_barrier 标志 。 例 如 ， 下 面 的 视图 是 不 安全 
的 : 


CREATE VIEW phone_number AS 
SELECT person, phone FROM phone_data WHERE phone NOT LIKE '412%'; 


这 个 视图 可 能 看 起 来 是 安全 的 ， 因 为 规则 系统 将 重 写 phone_number 里 面 的 任意 

SELECT 到 phone_data 里 面 的 sELECT ， 并 且 添 加 只 有 不 是 以 412 开 头 的 phone 才 是 所 需要 的 
条 目的 条 件 。 但 是 如 果 用 户 可 以 创建 他 或 她 自己 的 画 数 ， 那 么 使 规划 器 在 NoT LIKE 表达 式 
之 前 执行 用 户 定义 的 函数 也 不 困难 。 例 如 : 


CREATE FUNCTION tricky(text, text) RETURNS bool AS $$ 
BEGIN 

RAISE NOTICE '% => %', $1, $2; 

RETURN true; 
$$ LANGUAGE plpgsql COST 0.0000000000000000000001; 


SELECT * FROM phone_number WHERE tricky(person, phone); 


phone_data 表 里 的 每 个 人 和 电话 号 码 将 作为 一 个 notice 打印 ， 因为 规划 器 将 在 更 多 的 昂贵 
的 NoT LIKE 之 前 执行 廉价 的 tricky 函数 。 即 使 阻止 了 用 户 定义 新 的 画 数 ， 内 建 的 函数 可 以 
用 在 类 似 的 安全 系统 里 。 (例如 ， 大 多 数 转换 函数 在 他 们 产生 的 错误 信息 中 包含 他 们 的 输入 
值 。) 


类 似 的 注意 事项 应 用 于 更 新 规则 。 在 上 一 章 的 例子 里 ， 例 子 数据 库 里 的 表 的 所 有 者 可 以 把 
shoelace 视图 的 SELECT , INSERT , UPDATE , DELETE 权限 赋予 其 他 人 。 但 对 shoelace_log 只 
有 secect 权限 。 写 日 志 记 录 的 规则 动作 仍然 可 以 成 功 的 执行 。 并 且 其 它 用 户 可 以 看 到 日 志 记 
录 。 但 他 不 能 创建 伪 记 录 ， 而 且 他 也 不 能 对 现 有 记录 进行 修改 或 删除 。 在 这 种 情况 下 ， 不 能 
通过 使 规划 器 改变 操作 的 顺序 来 推翻 规则 ， 因为 唯一 引用 shoelace_log 的 规则 是 一 个 未 修饰 
的 INSERT. 在 更 复杂 的 情形 中 这 可 能 不 是 真 的 。 


当 必 须 为 视图 提供 行 级 别 的 安全 性 时 ， security_barrier 属性 应 该 应 用 于 视图 。 这 样 就 阻止 
了 在 行 上 调用 恶意 的 选择 函数 和 操作 ， 直 到 视图 完成 了 它 的 工作 。 例如 ， 如 果 上 面 显示 的 视 
图 像 这 样 创 建 ， 它 将 是 安全 的 : 


CREATE VIEW phone_number WITH (security_barrier) AS 
SELECT person, phone FROM phone_data WHERE phone NOT LIKE '412%'; 


带 有 security_barrier 创建 视图 可 能 执行 起 来 更 糟糕 。 通常 ， 这 是 没有 办 法 避免 的 : 如 果 可 
能 危及 安全 ， 那 么 最 快 可 能 的 计划 必须 拒绝 。 因为 这 个 原因 ， 缺 省 不 启用 这 个 选项 。 


当 义 理 的 函数 没有 副作用 时 ， 查 询 计 划 器 有 更 大 的 有 灵活 性 。 这 样 的 函数 被 称 为 LEAKPROOF ， 
包括 许多 简单 、 常 用 的 操作 符 ， 例 如 许多 相等 操作 符 。 查 询 计划 器 可 以 安全 的 允许 这 样 的 孙 
数 在 查询 执行 过 程 的 任何 时 候 评估 。 因为 在 行 上 不 可 见 的 调用 它们 不 会 给 用 户 泄露 任何 关于 
不 可 见 行 的 信息 。 相 反 的 ， 一 个 函数 可 能 会 抛 出 一 个 错误 ， 取 决 于 作为 参数 (例如 在 浴 出 或 
除 以 需 的 情况 下 抛 出 一 个 错误 ) 接收 到 的 值 是 非 防止 港 圳 的， 并 且 如 果 在 安全 视图 的 行 过 滤 
器 之 前 应 用 可 能 提供 重要 的 关于 不 可 见 行 的 信息 。 


理解 这 个 是 重要 的 ， 即 使 视图 创建 时 带 有 了 security_barrier 选项 ， 狭义 来 讲 ， 为 了 安全 ， 

只 有 不 可 见 元 组 的 内 容 不 会 被 传送 到 可 能 不 安全 的 函数 。 用 户 很 可 能 对 于 推断 不 可 见 的 数据 
有 其 他 的 意思 ; 例如 ， 他 们 使 用 ExPLAIN 看 到 查询 计划 ， 或 测量 查询 在 视图 上 的 运行 时 间 。 

恶意 攻击 者 也 许 能 够 推断 不 可 见 数 据 的 数量 ， 或 者 甚至 获得 一 些 关 于 数据 分 布 或 常见 值 的 信 
息 (因为 这 些 事情 可 能 影响 计划 的 运行 时 间 ; 其 至 ， 因 为 他 们 也 反映 在 优化 器 的 统计 数据 

中 ， 计 划 的 选择 ) 。 如 果 关 心 了 这 些 "covert channel" 类 型 的 攻击 ， 那 么 给 这 些 数据 授予 任何 
权限 可 能 是 不 明智 的 。 


38.6. AL) AAS ATA A 


PostgreSQL 服 务 器 为 它 收 到 的 每 个 命令 返回 一 个 命令 状态 字符 串 ， 比如 INSERT 149592 1 o 
如 果 没 有 涉及 规则 ， 那 么 这 些 就 很 简单 ， 但 是 如 果 查 询 是 被 规则 重 写 的 又 会 怎样 呢 ? 


规则 对 命令 状态 的 影响 如 下 : 


。 如 果 查 询 不 存在 无 条 件 的 INsTEAD 规则 ， 那 么 最 初 给 出 的 查询 将 会 被 执行 ， 并 且 它 的 命 
今 状态 将 像 平 常 一 样 返回 。 但 是 请 注意 如 果 存 在 任何 条 件 INsTEAD 规则 ， 那么 他 们 的 条 
件 的 反 条 件 将 会 已 经 加 到 最 初 的 查询 里 了 。 这 样 可 能 会 减少 它 处 理 的 行 数 ， 如 果 这 样 的 


话 ， 报 告状 态 将 受 影响 。 


。 如 果 查 询 有 任何 无 条 件 的 INsTEAD 规则 ， 那 么 最 初 的 查询 将 完全 不 会 被 执行 。 在 这 种 情 
况 下 ， 服 务 器 将 返回 由 INsTEAD 规则 (条 件 的 或 非 条 件 的 ) 插入 的 最 后 一 条 和 源 查 询 同 命 
使 类 型 ( INSERT, UPDATE , 或 DELETE ) 查 询 的 命令 状态 。 如 果 规 则 添加 的 查询 都 不 符合 这 
些 要 求 ， 那么 返回 的 命令 状态 显示 源 查 询 类 型 而 行 计 数 和 OID 字段 为 需 。 


(这 个 系统 是 在 PostgreSQL 7.3 建 立 的 。 在 之 前 的 版 本 里 ， 命令 状态 可 能 在 规则 退出 时 显示 
不 同 的 结果 。) 


程序 员 可 以 用 下 面 的 方法 确保 任何 需要 的 INsTEAD 规则 都 是 在 上 面 第 二 种 情况 里 设置 命令 状 
态 的 规则 : 给 这 个 规则 命名 为 字母 顺序 最 后 一 个 活动 的 规则 ， 这 样 它 就 最 后 附加 。 


38.7. AU) SARK ae BY Cb ae 


许多 用 触发 器 可 以 干 的 事情 同样 也 可 以 用 PostgreSQL 规 则 系统 来 实现 。 目前 不 能 用 规则 来 实 
现 的 东西 之 一 是 某 些 约束 ， 特 别 是 外 键 。 可 能 在 某 字 段 的 值 没 有 在 另 一 个 表 里 出 现 的 情况 下 
用 一 条 有 条 件 的 规则 把 查询 重 写 为 NOTHING 。 不 过 这 样 做 数据 就 会 被 不 声 不 响 的 扔 掉 ， 因 而 
这 也 不 是 一 个 好 主意 。 如 果 需 要 检查 有 效 的 值 ， 而 且 如 果 是 无 效 值 出 现时 要 生成 一 个 错误 信 
息 ， 这 种 情况 下 要 用 触发 器 来 做 。 


在 本 节 中 ， 我 们 专注 于 使 用 规则 本 节 中 的 所 有 更 新 规则 的 示例 也 可 以 使 用 在 视图 
上 的 INSTEAD oF 触发 器 实现 。 编 写 这 样 的 触发 器 通常 比 编写 规则 要 容易 ， 尤其 是 需要 复杂 
的 逻辑 执行 更 新 时 。 


对 于 两 者 都 可 用 的 情况 ， 哪 个 更 好 取决 于 对 数据 库 的 使 用 。 角 发 器 为 每 个 涉及 到 的 行 执 行 一 
次 。 规则 修改 查询 或 生成 额外 的 查询 。 所 以 如 果 在 一 个 语句 中 涉及 到 多 行 ， 一 个 生成 额外 查 
询 的 规则 通 o 个 对 每 一 行 都 分 别 执行 一 次 (而 且 要 重新 决定 做 什么 很 多 次 ) 的 触发 
器 快 一 些 。 不 过 ， 触 发 器 的 方法 从 概念 上 要 远 比 规则 的 方法 简单 ， 并 且 很 容易 让 新 手 可 以 做 
正确 事情 。 


下 面 展示 一 个 在 同一 个 情况 下 选择 规则 与 触发 器 的 对 比例 子 。 例 如 这 里 有 两 个 表 : 


CREATE TABLE computer ( 

hostname text, -- 已 索引 
manufacturer text -- 已 索引 

); 


CREATE TABLE software ( 


software text, -- 已 索引 
hostname text -- 已 索引 
) 


两 个 表 都 有 好 几 千 行 ， 并 且 hostname 上 的 索引 是 唯一 的 。 规 则 /触发 器 应 该 实现 这 样 一 个 约 
R, 这 个 约束 从 software 表 中 删除 引用 已 删除 计算 机 的 行 。 触 发 器 可 以 用 下 面 这 条 命令 


DELETE FROM software WHERE hostname = $1; 


因为 触发 器 是 为 从 computer 里 面 删 除 的 每 一 个 独立 的 行 调 用 一 次 ， 那么 它 可 以 准备 并 且 保 存 
这 个 命令 的 规划 ， 把 hostname 作为 参数 传递 。 规则 应 该 这 样 写 


CREATE RULE computer_del AS ON DELETE TO computer 
DO DELETE FROM software WHERE hostname = OLD.hostname; 


现在 看 看 这 两 种 不 同 的 删除 。 在 下 面 情况 : 


DELETE FROM computer WHERE hostname = 'mypc.local.net'; 


对 表 computer 使 用 索引 (快速 ) 进 行 打 描 并 且 由 触发 器 声明 的 查询 也 用 索引 进行 打 描 (同样 快 
速 )。 规则 里 多 出 来 的 查询 是 一 个 : 


DELETE FROM software WHERE computer .hostname 
AND software.hostname 


"mypc.local.net' 
computer .hostname; 


因为 已 经 建立 了 合适 的 索引 ， 规 划 器 将 创建 一 个 下 面 的 规划 


Nestloop 
-> Index Scan using comp_hostidx on computer 
-> Index Scan using soft_hostidx on software 


所 以 在 规则 和 触发 器 的 实现 之 间 没 有 太 多 的 速度 差别 。 


下 面 的 删除 希望 删 掉 所 有 2000 个 hostname 以 old 开头 的 计算 机 (记录 )。 有 两 个 可 能 的 用 于 
这 个 用 途 的 查询 。 一 个 是 : 


DELETE FROM computer WHERE hostname >= 'old' 
AND hostname < 'ole' 


规则 增加 的 命令 是 : 


DELETE FROM software WHERE computer.hostname >= 'old' AND computer.hostname < 'ole' 
AND software.hostname = computer.hostname; 


查询 的 规划 将 会 是 


Hash Join 
-> Seq Scan on software 
-> Hash 
-> Index Scan using comp_hostidx on computer 


另 一 个 可 能 的 查询 是 : 
DELETE FROM computer WHERE hostname ~ 'Aold'; 


它 由 规则 增加 执行 规划 是 : 


Nestloop 
-> Index Scan using comp_hostidx on computer 
-> Index Scan using soft_hostidx on software 


这 表明 ， 规 划 器 不 能 认识 到 表 computer 里 的 hostname 的 条 件 在 多 个 条 件 表 达 式 以 ANp WA 
式 组 合 在 一 起 时 同样 可 以 用 于 software 上 的 索引 扫描 ， 就 像 在 用 正则 表达 式 的 查询 里 一 样 。 
触发 器 将 在 任何 2000 个 要 被 删除 的 旧 计 算 机 里 被 调用 一 次 ， 结果 是 对 computer 的 一 次 索引 
扫描 和 对 software 的 2000 次 索引 扫描 。 规则 的 实现 将 会 使 用 两 个 使 用 索引 的 命令 来 完成 。 
所 以 software 表 的 实际 大 小 决定 了 规则 进行 顺序 扫描 后 是 否 仍然 更 快 。 即 使 所 有 要 使 用 的 索 
引 块 都 很 快 在 缓冲 里 出 现 ， 执行 2000 个 在 SPI 管理 器 上 的 查询 仍然 要 花 不 少时 间 。 


我 们 要 看 的 最 后 一 个 查询 是 : 

DELETE FROM computer WHERE manufacturer = 'bim'; 
同样 ， 这 也 会 导致 从 computer 表 里 删 除 多 行 。 所 以 触发 器 同样 会 向 执行 器 提交 很 多 查询 。 规 
则 生成 的 命令 将 会 是 : 


DELETE FROM software WHERE computer.manufacturer = 'bim' 
AND software.hostname = computer.hostname; 


4B SR, ) SRW SORE et ADNR HAREA. Rut (PAT computer 的 另外 一 个 索引 : 


Nestloop 
-> Index Scan using comp_manufidx on computer 
-> Index Scan using soft_hostidx on software 


在 任何 一 种 情况 下 ， 从 规则 系统 出 来 的 额外 查询 都 或 多 或 少 与 查询 中 涉及 到 的 行 数量 相对 独 
立 。 

概括 来 说 ， 规 则 只 是 在 它们 的 动作 生成 了 又 大 又 烂 的 条 件 连接 时 才 比 触发 器 有 较 大 速度 差 
异 ， 这 时 规划 器 将 失效 。 


Chapter 39. 过 程 语言 


PostgreSQL 人 允许 用 户 定 义 的 函数 使 用 SQL 和 C 之 外 的 语言 编写 。 通常 这 些 人 额外 的 语言 叫 过 程 
语言 (PLs)。 如 果 用 一 种 过 程 语言 书写 了 一 个 画 数 ， 那么 数据 库 服务 器 没有 任何 内 建 的 办 法 
RAAT IZ LAIR ICA, 实际 上 这 些 任务 都 传递 给 一 个 知道 如 何 处 理 这 些 细节 的 处 理 器 处 理 。 
这 个 处 理 器 既 可 以 自己 做 所 有 的 分 析 , 语 法 分 析 ， 执 行 等 工作 ， 也 可 以 充当 PostgreSQL 和 一 
种 现 有 的 编程 语言 实现 之 间 的 "胶水 "。 处 理 器 本 身 是 一 个 C 语言 函数 ， 它 被 编译 成 共享 对 象 
并 且 在 需要 的 时 候 加 载 ， 就 像 其 它 C 函数 一 样 。 


目前 在 标准 的 PostgreSQL 发 布 里 有 四 种 过 程 语言 可 用 : PL/pgSQL (Chapter 40), PL/Tel 
(Chapter 41), PL/Perl (Chapter 42) 和 PL/Python (Chapter 43), 还 有 几 种 额外 的 过 程 语 言 没 
有 包含 在 核心 发 布 里 。Appendix H 里 面 有 如 何 找到 它们 的 信息 。 用 户 可 以 定义 其 它 语言 。 开 
发 一 种 新 的 过 程 语言 的 基本 信息 在 Chapter 51 里 介绍 。 


39.1. ZJE HE 


如 果 你 要 使 用 某 种 过 程 语言 ， 那 么 你 必须 把 它 " 安 装 " 到 要 使 用 它 的 数据 库 里 。 不 过 那些 安装 
到 数据 库 templatel iene 程 语言 会 自动 在 随后 创建 的 数据 库 中 安装 。 因为 templatea 中 的 
目录 通过 CREATE DATABASE 进行 拷贝 ， 因此 数据 库 管 理 员 可 以 决定 哪个 数据 库 可 以 使 用 哪 种 语 
E, 以 及 决定 缺 省 时 可 以 使 用 哪些 语言 。 


对 于 那些 随 着 标准 版 本 发 布 的 语言 ， 只 需要 使 用 CREATE EXTENSION _language_name_ 把 语言 
安装 到 当前 数据 库 中 即 可 。 另外 ， 也 可 以 使 用 createlang 程 序 在 shell 命 信行 上 安装 语言 。 比 
如 ， 要 将 PL/Perl 安 装 到 templates 数据 库 中 ， 可 以 使 用 : 


createlang plperl template1 


推荐 下 面 描述 的 手工 程序 来 安装 没有 作为 扩展 包装 的 定制 语言 。 
手工 安装 过 程 语言 


一 个 过 程 语 言 是 按 五 个 步骤 安装 到 数据 库 里 面 去 的 ， 这 些 任务 必须 由 数据 库 超 级 用 户 执行 。 
在 大 多 数 情况 下 所 需 的 SQL 命令 应 该 被 打包 成 "扩展 "的 安装 脚本 ， 因此 CREATE EXTENSION 可 
以 用 于 执行 它们 。 


1. 必须 编译 和 安装 该 语言 处 理 器 的 共享 对 象 并 安装 到 一 个 合适 的 库 目录 中 。 方法 和 安装 用 
户 定义 的 C 画 数 的 方法 (Section 35.9.6) 一 样 。 通 常 ， 语言 处 理 器 需要 外 部 库 提供 实际 的 
引擎 ; 如 果 是 这 样 ， 那么 这 些 库 也 必须 安装 。 


2， 义 理 器 必须 使 用 下 面 的 命令 声明 


CREATE FUNCTION _handler_function_name_() 
RETURNS language_handler 
AS '_path-to-shared-object_' 
LANGUAGE C; 


language_handler 的 返回 类 型 告诉 数据 库 系 统 该 本 数 并 不 返回 任何 已 定义 的 SQL 数据 类 
型 ， 并 且 不 能 在 SQL 语句 中 被 直接 使 用 。 


3. 可 选 步骤 ， 语 言 处 理 器 可 以 提供 一 个 "内 置 "本 数 ， 这 个 辑 数 执行 使 用 这 种 语言 编写 的 匿 
名 代码 块 (DORT) 。 如 果 通 过 该 语言 提供 一 个 内 置 久 理 函数 ， 那 么 用 下 面 的 命令 声 
AR: 


CREATE FUNCTION _inline_function_name_(internal) 
RETURNS void 
AS '_path-to-shared-object_' 
LANGUAGE C; 


4 可 选 步骤 ， 语 羊 处 理 器 可 以 提供 一 个 "验证 器 " 贺 数 ， 这 个 琐 数 为 没有 实际 执行 它 的 正确 
性 而 检查 函数 定义 。 如 果 存 在 的 话 ， 通 过 create FUNCTION 调用 验证 图 数 。 如 果 通 过 这 
种 语言 提供 了 验证 图 数 ， 那 么 用 下 面 的 命 命 声 明 


CREATE FUNCTION _validator_function_name_(oid) 
RETURNS void 
AS '_path-to-shared-object_' 
LANGUAGE C STRICT; 


CREATE [TRUSTED] [PROCEDURAL] LANGUAGE _language-name_ 
HANDLER _handler_function_name_ 
[INLINE ~_inline_function_name_~ ] 
[VALIDATOR ~_validator_function_name_~] ; 


可 选 关 键 字 TRusTED 指明 该 语言 不 授予 访问 用 户 不 拥有 的 数据 的 权限 ， 为 一 个 没有 超级 
用 户 权 限 的 普通 数据 库 用 户 设 计 可 信任 语言 ， 并 且 允 许 他 们 安全 地 使 用 这 种 语言 创建 本 
数 和 触发 器 过 程 。 因为 PL 琅 数 在 数据 库 服务 器 中 执行 ， 所 以 TRUSTED 标志 应 该 只 是 用 
于 那些 不 人 允许 访问 数据 库 服务 器 内 部 或 文件 系统 的 语言 。 PL/pgSQL, PL/Tcl 和 PL/Perlis 
言 都 是 可 信和 的 。PL/TclU, PL/PerlU 和 PL/PythonU 都 被 设计 成 提供 无 限 的 功能 ， 因 此 不 应 
该 标记 为 可 信 。 


Example 39-1 显 示 了 如 何 手工 安装 PL/Perl 语 言 。 
Example 39-1. 手工 安装 PL/Perl 


下 面 的 命 合 告 诉 数据 库 服务 器 哪里 才能 找到 用 于 PL/Perl 语 言 的 调用 处 理 器 函数 的 共享 对 象 。 


CREATE FUNCTION plperl_call_handler() RETURNS language_handler AS 
"$libdir/plperl' LANGUAGE C; 


PL/Perl| 有 一 个 内 置 处 理 函 数 和 验证 图 数 ， 因 此 我 们 也 要 声明 它们 


CREATE FUNCTION plperl_inline_handler(internal) RETURNS void AS 
'$libdir/plperl' LANGUAGE C; 


CREATE FUNCTION plperl_validator(oid) RETURNS void AS 
'$libdir/plperl' LANGUAGE C STRICT; 


AA. 
Apa : 


CREATE TRUSTED PROCEDURAL LANGUAGE plperl 
HANDLER plperl_call_handler 
INLINE plperl_inline_handler 
VALIDATOR plperl_validator; 


声明 了 前 面 所 定义 的 函数 应 该 被 那些 调用 语言 属性 是 plperl 的 KARAR R mt FEE A. 


ETRY PostgreSQLkARE, PL/pgSQL Sh Ras = tll (EA QR "ibrary" E PAM, 
进一步 来 涪 ，PL/pgSQL 语 言 自身 安装 到 所 有 数据 库 中 ， 如 果 配 置 了 Tel 支持， 那么 PL/Tcl 和 
PL/TclU 的 处 理 器 也 都 被 编译 并 安装 到 同一 个 库 目录 中 。 但 是 语言 自身 缺 省 不 安装 到 任何 数 
据 库 中 ， 类 似 的 ， 如 果 配 置 了 Perl 支 持 ， 则 PL/Perl| 和 PL/PerlU 的 处 理 器 也 都 编译 并 且 安 装 。 
并 且 如 果 配 置 了 Python 支 持 ， 则 安装 PL/PythonU 人 处理 器 。 但 是 这 些 语言 缺 省 不 安装 。 


Chapter 40. PL/pgSQL - SQL 过 程 语 
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40.1. 概述 

PL/pgSQL 是 PostgreSQL 数 据 库 系统 的 一 个 可 加 载 的 过 程 语言 。 PL/pgSQL 的 设计 目标 是 创 
建 一 种 可 加 载 的 过 程 语言 ， 可 以 

。 AFUERA R tE, 

。 为 SQL 语言 增加 控制 结构 ， 

。 执行 复杂 的 计算 ， 

HAMAR PELE, WR RER, 

。 定义 为 被 服务 器 信任 的 语言 ， 

。 容易 使 用 。 


PL/pgSQL 创 建 的 画 数 可 以 在 那些 使 用 内 置 画 数 一 样 的 情形 下 使 用 。 上 比如， 可 以 创建 复杂 的 条 
件 计算 画 数 ， 并 随后 将 之 用 于 定义 操作 符 或 者 用 于 函数 索引 中 。 


在 PostgreSQL 9.0 及 其 之 后 的 版 本 中 ，PL/pgSQL 是 默认 安装 的 。 当然 ，PL/pgSQL 仍 然 是 一 
个 可 加 载 的 模块 ， 因 此 ， 如 果实 际 安全 需要 ， 管 理 员 也 可 以 选择 将 它 介 载 掉 。 


40.1.1. 使 用 PL/pgSQL 的 优点 


SQL 是 PostgreSQL 和 大 多 数 其 它 关 系 型 数据 库 的 命令 语言 。 它 是 可 移植 的 ， 并 且 容 易学 习 使 
用 。 但 是 所 有 SQL 语句 都 必须 由 数据 库 服 务 器 独立 地 执行 。 


这 就 意味 着 你 的 客户 端 应 用 必须 把 每 条 命令 发 送 到 数据 库 服 务 器 ， 等 待 它 义 理 这 个 命令 ， 接 
结果 ， 对 结果 进行 一 些 处 理 ， 然后 再 给 服务 器 发 送 另 外 一 条 命令 。 所 有 这 些 示 西 都 会 产生 

进程 间 通 讯 ， 并 且 如 果 你 的 客户 端 在 另外 一 台 机 器 上 甚至 还 会 产生 网 络 开销 。 

通 


= 


通过 PL/pgSQL， 可 以 把 运算 块 和 一 系列 命令 在 数据 库 服 务 器 内 部 组 成 一 个 块 ， 这 样 就 拥有 了 
过 程 语言 的 能 力 并 且 简 化 SQL 的 使 用 ， 因而 节约 了 大 量 的 时 间 ， 因 为 不 需要 进行 客户 端 / 服 
务 器 通讯 。 


。 忽略 了 客户 端 和 服务 器 端 之 间 的 额外 往返 行程 。 

。 客户 端 不 需要 的 中 间 结 果 无 需 在 服务 器 端 和 客户 端 来 回 传递 。 

。 不 需要 多 次 语法 分 析 步 又 。 

比 起 不 使 用 存储 函数 来 ， 这 样 做 能 够 产生 明显 的 性 能 提升 。 

同样 ， 在 PL/pgSQL 里 ， 仍 然 可 以 使 用 SQL 的 所 有 数据 类 型 ， 操 作 符 和 男 数 。 


40.1.2. 支持 的 参数 和 结果 数据 类 型 


使 用 PL/pgSQL 所 写 的 函数 能 够 接受 服务 器 支持 的 任何 标量 或 数组 数据 类 型 作为 参数 ， FEA 
样 能 够 返回 这 些 类 型 的 结果 ， 它们 还 可 以 接受 或 者 返回 任意 用 名 字 声 明 的 复合 类 型 ( 行 类 
型 )。 还 可 以 将 一 个 PL/pgSQL 画 数 声 明 为 一 个 返回 record 类 型 ( 行 类 型 )， 表明 该 结果 是 一 个 
行 类 型 ， 这 个 行 的 字段 是 在 调用 它 的 查询 中 指定 的 ， 就 像 在 Section 7.2.1.4 里 讨论 的 那样 。 


与 声明 SQL 画 数 一 样 ， 通 过 使 用 varc 可 以 对 PL/pgSQL 进行 声明 为 能 接受 可 变数 目的 参 
数 。 正如 在 Section 35.4.5 中 讨论 的 那样 。 


PL/pgSQL 辑 数 还 可 以 声明 为 接受 并 返回 多 态 的 anyelement , anyarray , anynonarray , 
anyenum 和 anyrange 类 型 。 一 个 多 态 函 数 实际 操作 的 数据 类 型 可 以 在 不 同 的 调用 环境 中 变 
化 ， 如 在 Section 35.2.5 里 讨论 的 那样 。 Section 40.3.1 是 一 个 使 用 例子 


PL/pgSQL 还 可 以 声明 为 任何 一 个 单个 实例 返回 的 数据 类 型 "set"， 或 者 表 。 这 样 的 函数 通过 为 
结果 集 每 个 需要 返回 的 元 素 执 行 一 个 RETURN NEXT 生成 它 的 输出 ， 或 者 通过 使 
用 RETURN QUERY 来 输出 评估 查询 的 结果 。 


最 后 ， 如 果 返 回 的 结果 没有 太 大 的 价值 ，PL/pgSQL 画 数 可 以 声明 为 返回 void 。 


PL/pgSQL 辑 数 也 可 以 声明 为 输出 某 种 类 型 的 参数 ， 来 代替 明确 的 返回 类 型 声明 。 这 人 么 做 并 
未 给 该 语言 增加 任何 基础 设施 ， 只 是 通常 更 方便 些 ， 特 别 是 返回 多 行 数值 的 时 候 。 同 时 ， 也 
可 以 用 RETURNS TABLE 来 代替 RETURNS SETOF o 


具体 的 例子 在 Section 40.3.1 和 Section 40.6.1 中 。 


40.2. PL/pgSQL 的 结构 


PL/pgSQL 是 一 种 块 结构 的 语言 。 加 数 定 义 的 所 有 文本 都 必须 是 一 个 块 (block) 。 可 以 用 下 
面 的 方法 定义 一 个 块 : 


[ << _label ‘>> ] 
[ DECLARE 
*_declarations_~ ] 
BEGIN 
_statements_ 
END [ ~_label_~ ]; 


块 中 的 每 个 声明 和 每 条 语句 都 是 用 一 个 分 号 终止 的 ， 如 果 一 个 子 块 在 另外 一 个 块 里 ， 那 
A END 后 面 必 须 有 个 分 号 ， 如 上 所 述 ; 不 过 结束 事 数 体 的 最 后 的 enn 可 以 不 要 这 个 分 号 。 














Tip: 一 个 常见 的 错误 是 紧 跟 在 BEGIN 之 后 使 用 一 个 分 号 ， 这 是 不 正确 的 ， 并 且 会 返回 一 


-人 个、 五 、 
八 语 法 错误 。 








如 果 你 想 标 记 出 在 exit 声明 中 的 block， 或 者 描述 在 block 中 所 声明 的 变量 名 字 ， 此 时 ， 可 以 
选择 使 用 _label_»o WREE ENp 之 后 给 出 一 个 标签 ， 那 么 ， 它 必 须 与 block 开 始 时 定义 的 标 
答 相 匹配 。 


所 有 的 关键 字 都 是 不 区 分 大 小 写 的 ， 正 如 在 SQL 命 命中 一 样 ， 会 隐 式 的 将 其 转换 成 小 写 ， 除 
非 是 使 用 双 引 号 。 


如 同 在 普通 的 SQL 语句 中 一 样 ， 在 PL/pgSQL 代 码 中 ， 用 同样 的 方式 定义 注释 : 在 语句 的 最 
后 ， 通 过 一 个 双 破 折 号 ( -- ) 来 开始 一 条 行 注释 。 而 块 注释 是 成 对 出 现 的 ， 通 过 /* 和 */ 来 
定义 。 

块 语句 段 里 的 任何 语句 都 可 以 是 一 个 子 块 。 子 块 可 以 用 于 逻辑 分 组 或 者 把 变量 局 部 化 为 作用 
于 一 个 较 小 的 语句 组 。 为 了 子 块 的 持续 时 间 任 何 同样 命名 的 外 部 子 块 的 变量 在 子 块 中 声明 变 
量 ， 但 是 如 果 你 符合 它们 的 名 字 和 它们 子 块 标签 ， 无 论 如 何 你 可 以 访问 外 部 变量 ， 比 如 : 


CREATE FUNCTION somefunc() RETURNS integer AS $$ 
<< outerblock >> 


DECLARE 
quantity integer := 30; 
BEGIN 
RAISE NOTICE 'Quantity here is %', quantity; -- 在 这 里 的 数量 是 30 
quantity := 50; 
-- 创建 一 个 子 块 
DECLARE 
quantity integer := 80; 
BEGIN 
RAISE NOTICE 'Quantity here is %', quantity; -- 在 这 里 的 数量 是 80 
RAISE NOTICE ‘Outer quantity here is %', outerblock.quantity; -- 在 这 里 的 数量 是 50 
END; 
RAISE NOTICE 'Quantity here is %', quantity; -- 在 这 里 的 数量 是 50 


RETURN quantity; 
END; 
$$ LANGUAGE plpgsql; 


SERIES 


Note: 在 任何 PL/pgSQL 画 数 主体 周围 有 隐藏 的 "外 部 块 "。 这 个 块 提供 函数 参数 的 声明 
(如 果 有 ) ， 以 及 一 些 特殊 变量 比如 Founn (参阅 Section 40.5.5), 外 部 块 可 以 使 用 画 
数 的 名 字 标 记 ， 意 味 着 参数 和 特殊 变量 可 以 满足 本 数 名 字 。 


一 定 不 要 把 PL/pgSQL 里 用 于 语句 分 组 的 BEGIN / enn 和 用 于 事务 控制 的 数据 库 命令 搞 混 了 。 
PL/pgSQL 的 BEGIN / END 只 是 用 于 分 组 ; 它们 不 会 开始 和 结束 一 个 事务 。 MAAR HE 
总 是 在 一 个 由 外 层 命 令 建 立 起 来 的 事务 里 执行 ， 它们 无 法 开始 或 者 提交 事务 ， 因 为 
PostgresaL REZ. 不 过 ， 一 个 包含 ExcEPTION 子 句 的 块 实际 上 形成 一 个 子 事务 ， 
它 可 以 在 不 影响 外 层 事务 的 情况 下 回 滚 。 更 多 相关 信息 请 参阅 Section 40.6.6。 


40.3. 声明 


所 有 在 块 里 使 用 的 变量 都 必须 在 一 个 块 的 声明 段 里 声明 。 唯一 的 例外 是 一 个 For 循环 里 的 循 
环 变 量 是 在 一 个 整数 范围 内 迭代 的 ， 被 自动 声明 为 整数 变量 。 并 且 同 祥 从 游标 结果 中 ror 循 
环 迭 代 的 循环 变量 自动 被 声明 为 记录 变量 。 


PL/pgSQL 变 量 可 以 使 用 任意 的 SQL 数 据 类 型 ， 比如 integer , varchar 和 char 等 等 。 


user_id integer; 

quantity numeric(5); 

url varchar; 

myrow tablename%ROWTYPE; 

myfield tablename.columnname%TYPE; 
arow RECORD; 


一 个 变量 声明 的 一 般 性 语法 是 : 


_name_ [ CONSTANT ] _type_ [ COLLATE ~_collation_name_~ ] [ NOT NULL ] [ { DEFAULT | := } 
a] E S 


如 果 给 出 了 DEFAULT 子 句 ， 那 么 它 声明 了 在 进入 该 块 的 时 候 赋予 该 变量 的 初始 值 。 如 果 没 有 
给 出 DEFAULT 子 句 ， 那 么 该 变量 初始 化 为 SQL NULL。 constant 选项 避免 了 该 变量 被 赋值 ， 

这 样 其 数值 在 该 块 的 范围 内 保持 常量 。 coLLATE 选项 声明 变量 使 用 的 排序 规则 (参见 Section 
40.3.6) > 如 果 声 明了 not NULL ， 那 么 赋予 NULL 的 数值 特 运行 时 导致 错误 。 所 以 所 有 声明 
为 NOT NULL 的 变量 还 必须 声明 一 个 非 空 的 缺 省 值 。 





缺 省 值 是 在 每 次 进入 该 块 的 时 候 计 算 的 ， 而 不 是 每 次 调用 画 数 时 。 因此 ， 如 果 把 now) 赋予 
一 个 类 型 为 timestamp 的 变量 会 令 变 量 拥有 本 数 实际 调用 的 时 间 ， 而 不 是 函数 预 编译 的 时 
间 。 


例如 : 


quantity integer DEFAULT 32; 
url varchar := 'http://mysite.com'; 
user_id CONSTANT integer := 10; 


40.3.1. 声明 函数 参数 


传递 给 函数 的 参数 都 是 用 s1, 32 等 等 这 样 的 标识 符 。 为 了 增加 可 读 性 ， 可 以 为 $n 
数 名 声明 别名 。 然后 别名 或 者 数字 标识 符 都 可 以 指向 参数 值 。 


有 两 种 创建 别名 的 方法 ， 比 较 好 的 是 在 cREATE FUNCTION 命令 里 给 出 参数 名 ， 比 如 : 


CREATE FUNCTION sales_tax(subtotal real) RETURNS real AS $$ 
BEGIN 
RETURN subtotal * 0.06; 
END; 
$$ LANGUAGE plpgsql; 


另外 一 个 方法 〈 也 是 PostgreSQL 8.0 以 前 的 唯一 的 方法 ) , 是 使 用 声明 语法 明确 声明 别名 : 


_name_ ALIAS FOR $_n_; 


这 个 风格 的 同一 个 例子 看 起 来 像 下 面 这 样 : 


CREATE FUNCTION sales_tax(real) RETURNS real AS $$ 


DECLARE 

subtotal ALIAS FOR $1; 
BEGIN 

RETURN subtotal * 0.06; 
END; 


$$ LANGUAGE plpgsql; 


Note: 这 两 个 例子 的 作用 不 是 完全 一 致 的 。 在 第 一 个 例子 中 ， subtotal 可 以 作 
为 sales_tax.subtotal 被 引用 ， 而 在 第 二 个 例子 中 是 不 可 以 的 。 (我 们 在 内 部 块 中 附加 
标签 ， 反 而 subtotal 符合 这 个 标签 ) 。 


更 多 例子 : 


CREATE FUNCTION instr(varchar, integer) RETURNS integer AS $$ 
DECLARE 
v_string ALIAS FOR $1; 
index ALIAS FOR $2; 
BEGIN 这 里 放 一 些 使 用 v_string 和 index 的 计算 
END; 
$$ LANGUAGE plpgsql; 


CREATE FUNCTION concat_selected_fields(in_t sometablename) RETURNS text AS $$ 
BEGIN 
RETURN in_t.f1 || in_t.f3 || in_t.f5 || in_t.f7; 
END; 
$$ LANGUAGE plpgsql; 


如 果 一 个 PL/pgSQL 画 数 声明 中 含有 输出 参数 ， 那么 就 会 给 予 输出 参数 sn 的 名 字 以 及 可 
选 的 别名 ， 方法 和 其 它 正常 输入 参数 一 样 。 一 个 输出 参数 实际 上 是 初始 值 为 NULL 的 变量 ; 
在 函数 执行 的 过 程 中 ， 应 该 给 它 赋值 。 该 参数 的 最 后 数值 是 返回 的 东西 。 比 如 ， 销售 额 - 税 费 
的 例子 也 可 以 这 么 做 : 


CREATE FUNCTION sales_tax(subtotal real, OUT tax real) AS $$ 
BEGIN 
tax := subtotal * 0.06; 
END; 
$$ LANGUAGE plpgsql; 


请 注意 忽略 了 RETURNS real 一 当然 也 可 以 包含 它 ， 不 过 这 样 就 显得 多 余 了 。 


输出 参数 在 返回 多 个 数值 的 时 候 非 常 有 用 。 一 个 简单 的 例子 是 : 


CREATE FUNCTION sum_n_product(x int, y int, OUT sum int, OUT prod int) AS $$ 
BEGIN 
sum := X + y; 
prod := x * y; 
END; 
$$ LANGUAGE plpgsql; 


正如 在 Section 35.4.4 里 面 讨 论 的 ， 这 样 做 实际 上 为 函数 的 结果 创建 了 一 个 匿名 的 记录 类 型 。 
如 果 给 出 一 个 RETURNS 子 句 ， 那 么 它 就 必须 使 用 RETURNS record o 


另 一 个 声明 PL/pgSQL 画 数 的 方法 是 使 用 RETURNS TABLE ， 例 如 : 


CREATE FUNCTION extended_sales(p_itemno int) 
RETURNS TABLE(quantity int, total numeric) AS $$ 
BEGIN 
RETURN QUERY SELECT quantity, quantity * price FROM sales 
WHERE itemno = p_itemno; 
END; 
$$ LANGUAGE plpgsql; 


这 完全 等 价 于 声明 一 个 或 多 个 our 参数 ， 并 且 声 明 RETURNS SETOF``_sometype_ o 


如 果 将 PL/pgSQL 画 数 的 返回 类 型 声明 为 多 态 类 型 ( anyelement ，anyarray , anynonarray , 
anyenum , 或 者 anyrange ), 那么 就 会 创建 一 个 特殊 的 $0 参数 ， 它 的 数据 类 型 是 函数 的 实际 
返回 类 型 ， 和 从 实际 输入 类 型 的 推导 类 型 一 样 (参阅 Section 35.2.5)。 这 样 就 允许 西数 像 
Section 40.3.3 里 显示 的 那样 访问 它 的 实际 返回 类 型 。 se 初始 化 为 空 ， 并 且 可 以 被 画 数 修 
改 ， 所 以 ， 如 果 需 要 ， 它 可 以 用 于 保存 返回 值 ， 虽 然 这 并 非 必须 。 so 还 可 以 给 予 一 个 别 
Zo teal, x MHRA + 操作 符 的 数据 类 型 上 运转 : 


CREATE FUNCTION add_three_values(vi anyelement, v2 anyelement, v3 anyelement ) 
RETURNS anyelement AS $$ 
DECLARE 
result ALIAS FOR $0; 
BEGIN 
result := vi + v2 + v3; 
RETURN result; 
END; 
$$ LANGUAGE plpgsql; 


通过 将 一 个 或 多 个 输出 参数 声明 为 多 态 类 型 ， 可 以 达到 相同 的 效果 。 在 这 种 情况 下 ， 特 殊 的 
参数 so 不 会 使 用 ; 输出 参数 自己 起 这 个 作用 。 比 如 : 


CREATE FUNCTION add_three_values(vi anyelement, v2 anyelement, v3 anyelement, 
OUT sum anyelement ) 
AS $$ 
BEGIN 
sum := vi + v2 + v3; 
END; 
$$ LANGUAGE plpgsql; 


40.3.2. 别名 


_newname_ ALIAS FOR _oldname_; 


别名 语法 比 在 之 前 章节 提 到 的 更 普通 : 可 以 为 任何 一 个 参数 声明 别名 ， 而 不 仅仅 只 是 对 画 
数 。 这 样 做 的 主要 目的 是 为 已 经 有 名 字 的 参数 重新 定义 一 个 名 字 ， 例 如 触发 器 中 的 new 或 
者 oLD 。 


例如 : 


DECLARE 
prior ALIAS FOR old; 
updated ALIAS FOR new; 


由 于 ans 创建 了 两 种 不 同 的 方式 来 命名 相同 的 对 象 ， 因 此 ， 无 限制 的 使 用 会 造成 混淆 。 最 
好 是 在 重 写 预定 名 称 时 使 用 。 


40.3.3. 拷贝 类 型 


_variable %TYPE 


%TYPE 提供 一 个 变量 或 者 表 字 段 的 数据 类 型 。 你 可 以 用 这 个 声明 将 要 保存 数据 库 数值 的 变 
量 。 上 比如 ， 假 如 你 在 users 表 里 面 有 一 个 user_id 字段 。 要 声明 一 个 和 users.user_id 类 型 
相同 的 变量 ， 可 以 这 样 写 : 


user_id users.user_id%TYPE; 


通过 使 用 xrYyPE ， 你 无 需 知道 引用 的 结构 的 数据 类 型 ， 并 且 ， 最 重要 的 是 ， 如 果 被 引用 项 的 
数据 类 型 在 将 来 变化 了 (比如 把 user_id 的 类 型 从 Integer 改 成 real )， 也 不 需要 修改 西数 定 
Lo 


“TYPE 对 多 态 画 数 特别 有 用 ， 因 为 内 部 变量 的 数据 类 型 可 能 在 不 同调 用 中 不 一 样 。 可 以 通过 
给 函数 的 参数 或 者 结果 占 位 符 附 加 wTYPE 的 方法 来 创建 合适 的 变量 。 


name table_name_%ROWTYPE; 
_name_ _composite_type_name_j; 





一 个 复合 类 型 变量 叫做 行 变量 (或 者 /row-type 变 量 )。 这 样 的 一 个 变量 可 以 保存 一 次 sELEcT 或 
者 FoR 命令 结果 的 完整 一 行 ， 只 要 命令 的 字段 集 匹 配 该 变量 声明 的 类 型 。 行 数 值 的 字段 使 用 
点 表示 法 访问 ， 比 如 rowar.field 。 


行 变 量 可 以 声明 为 和 一 个 现 有 的 表 或 者 视图 的 行 类 型 相同 ， 方法 是 使 

用 _table_name ``%ROWTYPE 表示 法 ; 或 者 你 也 可 以 声明 它 的 类 型 是 一 个 复合 类 型 的 名 字 。 
为 每 个 表 都 有 一 个 相关 联 的 同名 数据 类 型 ， 在 PostgreSQL 里 实在 是 无 所 谓 你 写 不 

E %ROWTYPE 。 但 是 有 x%RowTYPE 的 形式 移植 性 更 好 。 


函数 的 参数 可 以 是 复合 类 型 ( 表 的 完整 行 )。 这 个 时 候 ， 对 应 的 标识 符 sn 将 是 一 个 行 变 
量 ; 并 且 可 以 从 中 选 先 取 字 段 ， 比 如 $1.user_id o 


在 一 个 行 类 型 的 变量 中 ， 只 可 以 访问 用 户 定 义 的 表 中 行 的 属性 ， 不 包括 OID 或 者 其 它 系 统 属 
性 (因为 该 行 可 能 来 自 一 个 视图 )。 该 行 类 型 的 数据 域 继承 表 中 像 charn ) 这 种 类 型 字段 
的 尺寸 和 精度 。 


这 里 是 一 个 使 用 复合 类 型 的 例子 。 table1 和 table2 是 现 有 的 表 ， 至 少 包含 代码 中 提 到 的 字 
段 : 
CREATE FUNCTION merge_fields(t_row table1) RETURNS text AS $$ 
DECLARE 
t2_row table2%ROWTYPE; 
BEGIN 
SELECT * INTO t2_row FROM table2 WHERE ... ; 
RETURN t_row.f1 || t2_row.f3 || t_row.f5 | "t2 row. f7; 
$$ LANGUAGE plpgsql; 


SELECT merge _fields(t.*) FROM tablei t WHERE ... ; 


40.3.5. 记录 类 型 


_name_ RECORD; 


纪录 变量 类 似 行 类 型 变量 ， 但 是 它们 没有 预定 义 的 结构 。 它 们 在 SELECT 或 者 FoR 命令 中 获 
取 实 际 的 行 结构 。 一 个 行 变 量 的 子 结构 可 以 在 每 次 赋值 的 时 候 改 变 。 这 样 做 的 一 个 结果 是 : 
在 一 个 记录 变量 被 赋予 数值 之 前 ， 它 没有 子 结构 ， 并 且 任 何 对 其 中 的 数据 域 进 行 访 问 的 企图 
都 将 产生 一 个 运行 时 错误 。 


请 注意 ， _ RECORD 不 是 真正 的 数据 类 型 ， 只 是 一 个 占 位 符 。 还 应 该 意识 到 在 把 一 个 PL/pgSQL 
PACS AA 4 RG) record 类 型 的 时 候 ， 它 和 一 个 记录 变量 的 概念 并 不 完全 相同 ， 即使 这 个 本 数 
可 能 使 用 一 个 记录 变量 保存 它 的 结果 也 如 此 。 在 这 两 种 情况 下 书写 函数 的 时 候 ， 实 际 的 行 结 
构 都 是 未 知 的 ， 但 是 对 于 返回 record 的 函数 来 说 ， 实际 的 结构 是 在 调用 它 的 查询 被 分 析 的 
时 候 决 定 的 ， 而 行 变 量 可 以 在 运行 中 改变 其 行 结构 。 


40.3.6. PL/pgSQL 交 量 的 排序 规则 


当 PL/pgSQL 玉 数 有 排序 规则 数据 类 型 的 一 个 以 上 的 参数 时 ， 排序 规则 确定 每 个 画 数 调用 依赖 
于 分 配给 实际 参数 的 排序 规则 ， 正 如 Section 22.2, 如 果 排 序 规则 成 功 被 识别 (上 比如 ， 在 这 些 
参数 之 间 没 有 隐 式 排序 规则 冲突 ) ， 那 么 所 有 排序 规则 参数 作为 有 隐 式 排序 规则 对 待 。 这 将 
影响 本 数 内 部 排序 规则 敏感 操作 行为 。 比 如 ， 考 虑 : 


CREATE FUNCTION less_than(a text, b text) RETURNS boolean AS $$ 
BEGIN 
RETURN a < b; 


$$ LANGUAGE plpgsql; 


SELECT less_than(text_field_1, text_field_2) FROM table1; 
SELECT less_than(text_field_1, text_field_2 COLLATE "C") FROM table1; 


less_than 的 第 一 次 使 用 出 于 比较 将 使 用 text_field_1 和 text_field_2 的 通用 排序 规则 ， 然 
而 第 二 次 使 用 将 使 用 c 排序 规则 。 


此 外 ， 被 识别 的 排序 规则 也 被 假定 为 任何 局 部 变量 是 collatable 类 型 的 排序 规则 。 因此 这 个 轿 
数 没有 任何 不 同 ， 如 果 它 被 写 为 : 


CREATE FUNCTION less_than(a text, b text) RETURNS boolean AS $$ 
DECLARE 
local_a text : 
local_b text : 
BEGIN 
RETURN local_a < local_b; 
END; 
$$ LANGUAGE plpgsql; 


a; 
b; 


如 果 没 有 collatable 数 据 类 型 的 参数 ， 或 者 没有 通用 排序 规则 可 以 识别 他 们 ， 那 么 参数 和 局 部 
变量 使 用 数据 类 型 的 缺 省 排序 规则 (这 往往 是 数据 库 的 缺 省 排序 规则， 但 是 可 能 不 同 于 域 类 
型 变量 ) 。 


collatable 数 据 类 型 的 局 部 变量 可 以 有 与 声明 中 包含 coLLATE 选项 的 相关 联 的 不 同 排序 规则 。 
比如 ， 


DECLARE 
local_a text COLLATE "en_US"; 


这 个 选项 覆盖 排序 规则 ， 否 则 按照 上 述 规 则 给 定 变量 。 


同时 ， 如 果 期 望 强迫 在 特定 操作 中 使 用 特定 排序 规划， 当然 明确 的 coLLATE 子 句 可 以 写 EER 
数 中 。 


CREATE FUNCTION less_than_c(a text, b text) RETURNS boolean AS $$ 
BEGIN 


RETURN a < b COLLATE "C"; 
END; 
$$ LANGUAGE plpgsql; 


这 将 重 写 与 表 列 ， 参 数 ， 或 者 表达 式 中 使 用 的 局 部 变量 相关 联 的 排序 规则 ， 正 如 在 纯 SQL 命 
今 中 一 样 。 


40.4. Rik 


所 有 在 PL/pgSQL 语 句 里 使 用 的 表达 式 都 是 用 服务 器 的 普通 SQL 执行 器 进行 处 理 的 。 例如 ， 
当 要 写 一 个 如 下 的 PL/pgSQL 声 明 时 


IF _expression_ THEN ... 


PL/pgSQL 会 通过 在 SQL 引擎 中 输入 类 似 下 面 的 查询 来 计算 表达 式 


SELECT _expression_ 


一 旦 形成 seLEcT 命令 ， 任 何 出 现 的 PL/pgSQL 变 量 名 会 由 参数 取代 ， 正如 在 Section 40.10.1 
讨论 的 那样 。 因此 ， 只 需要 定义 一 次 SELECT 查询 计划 ， 之 后 可 以 重复 使 用 。 也 就 是 说 ， 第 
一 次 使 用 表达 式 时 ， 本 质 上 是 生效 的 是 PREPARE Oo. 例如 ， 我 们 声明 两 个 整 型 变 

量 x 和 >y : 


IF x < y THEN... 


后 台 实 际 执 行 的 是 : 


PREPARE _statement_name_(integer, integer) AS SELECT $1 < $2; 


并 且 ， 一 条 EXECUTE 说 明 语 句 会 处 于 预备 状态 ， 以 后 每 一 次 执行 IF 语句 时 都 会 调用 该 说 明 
语句 ， 将 当前 PL/pgSQL 变 量 的 值 提供 为 参数 值 。 通常 情况 下 ， 对 于 PL/pgSQL 用 户 来 说 ， 
这 样 做 并 不 是 特别 重要 ， 不 过 ， 当 在 进行 错误 诊断 时 ， 如 果 知 道 这 一 点 的 话 会 很 有 用 。 更 多 
详细 信息 参阅 Section 40.10.2。 


40.5. 基本 语句 


本 节 以 及 随后 的 一 节 里 ， 描述 所 有 PL/pgSQL 明 确 可 以 理解 的 语句 类 型 。 任何 无 法 识别 为 这 
样 类 型 的 语句 将 被 做 为 SQL 命令 看 待 ， 并 且 被 发 送 到 主 数 据 库 引擎 执行 ， 正 如 在 节 Section 
40.5.2 和 Section 40.5.3 中 描述 的 那样 。 


40.5.1. 赋值 
2—~SPL/pgSQL & SAK M0 F: 


_variable_ := _expression_; 


如 上 所 述 ， 语 句 中 的 表达 式 是 用 一 个 发 送 到 主 数据 库 引 擎 的 sELEcT 命令 计算 的 。 该 表达 式 必 
须 生成 单一 的 数值 。 表 达 式 必须 只 能 生成 一 个 值 (如 果 变 量 一 个 行 或 者 record， 那 么 该 值 可 

能 是 一 个 行 ) 。 目标 变量 可 以 是 一 个 简单 的 变量 (可 以 用 一 个 block 的 名 字 来 描述 ) ， 行 或 

record 变 量 的 字段 ， 或 者 是 一 个 简单 变量 或 字段 的 数组 元 素 。 


如 果 表 达 式 的 结果 数据 类 型 和 变量 数据 类 型 不 一 致 ， 或 者 变量 具有 已 知 的 尺寸 /精度 ( 比 

如 char(20) )， 结果 值 将 隐 含 地 被 PL/pgSQL 解 释 器 用 结果 类 型 的 输出 函数 和 变量 类 型 的 答 
ABB. 注意 ， 如 果 结 果 数 值 的 字符 串 形 式 不 是 输入 函数 可 以 接受 的 形式 ， 那么 这 样 做 
可 能 导致 类 型 输入 函数 产生 的 运行 时 错误 。 


例子 : 


tax := subtotal * 0.06; 
my_record.user_id := 20; 


40.5.2. 执行 一 个 没有 结果 的 查询 
对 于 不 返回 任何 行 的 SQL 命 舍 ， 例 如 没有 RETURNING 子 句 的 insert, 你 可 以 简单 的 在 
PL/pgSQL 画 数 内 写 上 该 语句 ， 然后 执行 该 图 数 即 可 。 


出 现在 查询 文本 中 的 任何 PL/pgSQL 变 量 名 都 会 被 参数 符号 代替 ， 并 在 运行 时 将 参数 值 替换 为 
变量 的 当前 值 。 就 像 之 前 描述 的 表达 式 进程 ， 可 以 查看 资料 Section 40.10.1。 


当 以 这 种 方式 执行 一 条 SQL 命令 ， 这 条 命令 在 PL/pgSQL 中 缓存 并 且 在 执行 规划 中 重新 使 用 。 
正如 在 Section 40.10.2 中 讨论 的 。 


有 时 评估 一 个 表达 式 或 SELECT 查询 但 是 丢弃 其 结果 也 是 有 用 的 ， 例如 ， 调 用 一 个 具有 副作用 
的 函数 ， 但 对 它 的 结果 不 感 兴 趣 。 要 在 PL/pgSQL 中 这 样 做 ， 可 以 使 用 PERFORM 语句 : 


PERFORM _query_; 


这 将 执行 query 并 丢弃 其 结果 。 用 sec 命令 重 写 _query ， 并 将 serect Miz 

为 PERFORM ， 对 于 wITH 查询 ， 使 用 perrorm 并 且 将 查询 放 在 括号 中 (在 这 种 情况 下 ， 查询 
只 仅仅 返回 一 行 ) 。 这 样 ，PL/pgSQL 变 量 将 会 在 查询 中 被 照常 替换 。 另外 ， 如 果 查 询 生 成 
至 少 一 行 结果 的 话 ， 特殊 变量 FouNp 将 会 被 设 为 真 ， 否 则 将 被 设 为 假 。 (查阅 Section 
40.5.5) 

















{z 


Note: 有 些 人 可 能 期 望 直接 写 SELECT 就 能 同样 达到 此 目的 ， 但 目前 确实 只 有 PERFORM 一 
这 样 返 


种 方法 。 诸如 SELECT 回 行 的 查询 将 会 被 当 作 错 误 拒 绝 ， 除非 其 带 有 一 个 下 面 将 
要 讨论 的 into 子 句 。 


例如 : 


PERFORM create_mv('cs_session_page_requests_mv', my_query); 


40.5.3. 执行 一 个 仅 有 单行 结果 的 查询 

如 果 一 个 SQL 命令 的 结果 是 一 个 单独 的 行 (可 能 有 多 个 字段 )， 那么 可 以 将 其 赋予 一 个 记录 变 
量 、 行 类 型 变量 、 标 量变 量 的 列表 。 这 可 以 通过 在 基本 SQL 命令 之 后 添加 一 个 Into 子 句 达 
到 。 例 如 : 


SELECT _select_expressions_ INTO [STRICT] _target_ FROM ...; 


INSERT ... RETURNING _expressions_ INTO [STRICT] _target_; 
UPDATE ... RETURNING _expressions_ INTO [STRICT] _target_; 
DELETE ... RETURNING _expressions_ INTO [STRICT] _target_; 


这 里 的 target 可 以 是 一 个 记录 变量 、 TES. SARNA ALR, BSDaizz/ 
行 字段 列表 。 PL/pgSQL 变 量 将 被 照常 代入 查询 的 其 余部 分 ， 适用 于 带 
有 RETURNING 的 SELECT , INSERT / UPDATE / DELETE, 以 及 返回 行 集合 的 命 邻 ( 比 


如 EXPLAIN )。 BR Into FAA, SQL 命令 与 其 在 PL/pgSQL 外 面 时 完全 相同 。 


Tip: 请 注意 ， 上 面 带 有 into 的 SELECT 和 PostgreSQL 普 通 的 SELECT into 命令 是 不 一 
样 的 ， 后 者 的 into 目标 是 一 个 新 创建 的 表 。 如 果 你 想 在 PL/pgSQL 辑 数 里 从 一 


个 sELECT 结果 中 创建 表 ， 那么 请 使 用 cREATE TABLE ... AS SELECT 语法 。 








如 果 将 一 行 或 者 一 个 变量 列表 用 做 目标 ， 那 么 查询 的 结果 必需 作为 数目 或 者 数据 类 型 精确 匹 
配 目标 的 结构 ， 否则 就 会 产生 运行 时 错误 。 如 果 目 标 是 一 个 记录 变量 ， 那 么 它 自动 将 自己 配 
置 成 命令 结果 列 的 行 类 型 。 

INTO 子 句 几乎 可 以 出 现在 SQL 命令 的 任何 地 方 。 习惯 上 把 它 写 在 SELECT ma 


的 _select_expressions, 列表 的 之 前 或 之 后 ， 对 于 其 它 命 合 则 位 于 结尾 。 我 们 建议 你 遵守 这 
个 约定 ， 以 防 万 一 PL/pgSQL 分 析 器 在 未 来 的 版 本 中 变 得 更 加 严格 。 


如 果 没 有 在 INTO 指 定 STRICT， 那 么 target 将 被 设 为 查询 返回 结果 的 第 一 行 或 者 NULL( 查 询 返 
回 替 行 )， 请 注意 ， 除 非 用 ORDER BY 进行 排序 ， 否 则 "the first row" 是 不 明确 的 。 第 一 行 之 
后 的 所 有 结果 都 将 被 丢弃 。 你 可 以 检查 特殊 变量 FOUND( 参 见 Section 39.5.5) 来 判断 查询 是 否 
至 少 返 回 一 行 。 

SELECT * INTO myrec FROM emp WHERE empname = myname; 

IF NOT FOUND THEN 


RAISE EXCEPTION 'employee % not found', myname; 
END IF; 


如 果 指 定 了 strict 选项 ， 那么 查询 必须 返回 恰好 一 个 行 或 者 是 运行 时 的 错误 ， BA 
是 NO_DATA_FOUND (没有 行 )， 要 么 是 Too_MANY_Rows (多 于 一 行 )。 可 以 使 用 异常 块 来 捕获 这 些 
#52, AL : 


BEGIN 
SELECT * INTO STRICT myrec FROM emp WHERE empname = myname; 
EXCEPTION 
WHEN NO_DATA_FOUND THEN 
RAISE EXCEPTION 'employee % not found', myname; 
WHEN TOO_MANY_ROWS THEN 
RAISE EXCEPTION ‘employee % not unique', myname; 
END; 


成 功 执 行 了 一 个 带 有 strict 的 命令 之 后 ， FouNp 将 总 是 被 设 为 真 。 


对 于 带 有 RETURNING 的 INSERT / UPDATE / DELETE ， 即使 没有 指定 strict ，PL/pgSQL 也 会 在 
返回 多 行 时 报错 。 这 是 因为 没有 oRDER BY 之 类 的 选项 用 于 确定 究竟 返回 那 一 行 。 


Note: strict 兼容 Oracle PL/SQLAY SELECT INTO 行为 以 及 相关 语句 。 





对 于 如 何 处 理 一 个 SQL 查 询 中 返回 的 多 行 ， 参 见 Section 40.6.4。 


40.5.4. iT HARD 


UR 22 Fs SA SE REYPL/pgSQLWMBtmkaAwrs, 也 就 是 那些 每 次 执行 的 时 候 都 会 涉及 不 
同 表 或 不 同 数据 类 型 的 命令 。 在 这 样 的 情况 下 ， PL/pgSQL 试 图 为 命令 (正如 Section 40.10.2 
讨论 的 ) 缓冲 执行 计划 的 一 般 企图 将 不 再 合适 。 为 了 义理 这 样 的 问题 ， 提 供 了 execute 语句 : 


EXECUTE _command-string_ [ INTO [STRICT] ~_target_~ ] [ USING ~_expression_~ [, ... ] ]; 
nk 了 | 


这 里 的 _command-string_ 是 一 个 生成 字符 串 (类 型 为 text ) 的 表达 式 ， 该 字符 串 包 含 要 执行 的 
命令。 而 _target_ 是 一 个 记录 变量 、 行 变量 、 逗 号 分 隔 的 简单 变量 列表 、 逗号 分 隅 的 记录 / 
行列 表 ， 来 存储 命令 的 结果 。 通 过 使 用 usIN6 表达 式 ， 将 参数 值 插入 到 命令 中 。 


请 特别 注意 在 该 命令 字符 串 里 将 不 会 发 生 任何 PL/pgSQL 变 量 代 换 。 变量 的 数值 必需 在 构造 的 
时 候 插 入 该 字符 串 的 值 ， 或 者 也 可 以 使 用 下 面 介绍 的 参数 。 


同时 ， 对 于 通过 execute ANOS, RAMEEZ 相反 ， 在 该 语句 每 次 运行 的 
时 候 ， 命 令 都 准备 一 次 。 命令 字符 串 可 以 在 过 程 里 动态 地 生成 以 便于 对 各 种 不 同 的 表 和 字段 
进行 操作 。 


INTO 子 句 声明 SQL 命 命 的 结果 应 该 传递 到 哪里 。 如 果 提 供 了 一 个 行 变量 或 者 一 个 变量 列 
K, 那么 它 必 须 和 查询 生成 的 结果 的 结构 一 样 (如 果 使 用 了 记录 变量 ， 那 么 它 回 自动 调整 为 匹 
配 结果 的 结构 )。 如 果 返 回 了 多 行 ， 那 么 只 有 第 一 行将 被 赋予 Into 变量 。 如 果 返 回 需 行 ， 那 
AJF Into 变量 赋予 NULL。 如 果 没有 声明 INTo 子 句 ， 则 抛弃 查询 结果 。 


如 果 使 用 了 strict 选项 ， 那 么 在 查询 没有 恰好 返回 一 个 行 的 情况 下 将 会 报错 。 


该 命令 可 以 使 用 那些 在 命 伟 中 被 引用 为 $1 ，s$2 等 的 参数 值 。 这 些 标签 指向 的 是 在 usine F 
句 中 使 用 的 值 。 这 样 做 可 以 很 好 的 将 数据 值 以 文本 类 型 插入 到 命令 字符 串 中 : 避免 了 运行 期 
间 在 数据 值 和 文本 类 型 之 间 转 换 的 开销 ， 并 且 这 种 方法 不 是 倾向 于 进行 SQL-injection， 因为 
没有 进行 引用 和 转 义 的 必要 。 例 如 : 


EXECUTE 'SELECT count(*) FROM mytable WHERE inserted_by = $1 AND inserted <= $2' 
INTO c 
USING checked_user, checked_date; 


需要 注意 的 是 ， 参 数 标签 只 能 用 于 数据 值 一 如 果 想 要 使 用 动态 的 已 知 的 表 或 列 的 名 字 ， 那么 
必须 将 它们 以 文本 字符 串 类 型 插入 到 命令 中 。 例如 ， 当 上 面 那个 查询 需要 在 一 个 动态 选择 的 
表 上 执行 时 ， 你 可 以 这 人 么 做 : 


EXECUTE 'SELECT count(*) FROM ' 
| | tabname: :regclass 
|| ”WHERE inserted_by = $1 AND inserted <= $2' 
INTO c 
USING checked_user, checked_date; 


另 一 个 关于 参数 标签 的 限制 是 ， 它们 只 能 在 SELECT, INSERT, UPDATE 和 DELETE 命令 中 使 
A. 在 另 一 种 语法 类 型 中 ， 通 常 称 为 通用 语法 中 ， 可 以 将 参数 值 以 文本 类 型 插入 ， 哪怕 它们 
只 是 数据 值 。 


如 在 上 面 第 一 个 例子 中 的 ， 带 有 一 个 简单 常量 字符 串 和 usins 参数 的 Execute PS, CHD 
能 上 等 同 于 直接 在 PL/pgSQL 中 写 命 令 ， 并 且 人 允许 PL/pgSQL 交 量 自动 替换 。 最 重要 的 不 同 之 
处 在 于 ， EXECUTE 会 在 每 一 次 执行 时 ， 根 据 当前 的 参数 值 更 新 该 命令 计划 ， 在 这 一 点 上 ， 
PL/pgSQL 可 能 创建 一 个 命令 计划 ， 并 将 其 放 于 缓存 中 以 待 重 新 使 用 。 当 命 令 计 划 对 参数 值 
的 依赖 性 很 强 时 ， 对 于 使 用 execute 积极 确保 通用 计划 不 被 选择 是 很 有 帮助 的 。 


EXECUTE 命令 目前 不 支持 seLEcT into, 但 是 支持 一 个 纯 SELECT 命令 ， 并 且 声 明 一 


个 into 作为 命令 本 身 的 一 部 分 。 


Note: PL/pgSQL 中 的 execute 语法 与 PostgreSQL 服 务 器 支持 的 EXECUTE 语 法 无 关 。 
服务 器 支持 的 execute 语法 不 能 被 PL/pgSQL 男 数 直 接 使 用 〈 并 且 也 没有 必要 ) 。 





Example 40-1. 动态 查询 中 的 引用 值 


使 用 动态 命令 的 时 候 经 常 需要 逃逸 单 引号 。 建议 使 用 美元 符 界定 函数 体内 的 固定 文本 。 WR 
你 有 没有 使 用 美元 符 界定 的 老 代 码 ， 请 参考 Section 40.11.1， 这 样 在 把 老 代 码 转换 成 更 合理 
的 结构 时 ， 会 节省 你 的 一 些 精力 。 


插入 到 构造 出 来 的 查询 中 的 动态 数值 也 需要 特殊 处 理 ， 因为 他 们 自己 可 能 包含 引号 字符 。 一 
个 例子 (这 里 都 假设 你 使 用 了 美元 符 作为 整体 ， 所 以 引号 标记 不 需要 加 倍 ) : 


EXECUTE 'UPDATE tbl SET ' 
| quote_ident(colname) 


quote_literal(newvalue) 


| 

| 

| ' WHERE key = ' 

| quote_literal(keyvalue); 


| 
| 
| 
| 
| 
这 个 例子 显示 了 quote_ident 和 quote_literal MAEA (参阅 Section 9.4) 。 为 了 安 
人 全， 包含 字 段 和 表 标 识 符 的 变量 应 该 传递 给 quote_ident HR PHASMANRiA, I 
果 中 的 数值 在 构造 出 来 的 命 舍 字 符 串 里 是 文本 字符 串 ， 那么 应 该 传递 给 quote_literal 。 它 
们 俩 都 会 采取 合适 的 步骤 把 输入 文本 包围 在 单 或 双 引 号 里 ， 并 且 对 任何 嵌入 其 中 的 特殊 字符 
进行 合适 的 逃逸 处 理 。 


因为 quote_literal 被 标记 为 strict, 当 发 出 带 有 null 参 数 的 请 求 时 ， 往往 会 返回 一 个 
null, 在 上 面 的 例子 中 ， 如 果 newvalue 或 者 keyvalue 是 null， 整个 动态 查询 字符 串 会 变 成 
null， 最 终 execute 会 报错 。 可 以 通过 使 用 quote_nullable WAKE RAZ, 除了 当 发 出 
带 有 null 参 数 的 请 求 时 ， 往 往 会 返回 一 个 字符 串 NULL 之 外 ， ARA quote literal 一 样 工 
作 。 例 如 : 


EXECUTE 'UPDATE tbl SET ' 
| quote_ident(colname) 


| 

| quote_nullable(newvalue) 
| ' WHERE key = ' 
| 


| 
| 
| 
| 
|| quote_nullable(keyvalue) ; 


如 果 处 理 的 参数 值 是 null， 那 么 应 该 用 quote_nullable 来 代替 quote_literal o 


通常 ， 应 该 注意 确保 查询 中 的 null 值 返回 意料 之 外 的 结果 。 例 如 : 


"WHERE key = ' || quote_nullable(keyvalue) 


如 果 keyvalue 是 null， 那么 该 WHERE 子 句 永远 不 会 成 功 ， 因为 当 = RER A Anullik FR, 
操作 返回 的 结果 往往 是 null。 如 果 想 让 null 同 普通 关键 字 一 样 使 用 ， 那 么 将 上 面 的 命令 修改 如 
F: 


'WHERE key IS NOT DISTINCT FROM ' || quote_nullable(keyvalue) 


目前 ， IS NOT DISTINCT FROM 义理 效率 不 如 = ， 因 此 如 非 必 要 ， 不 用 这 么 做 。 关 于 null 
和 1s prstinct 的 资料 可 参阅 Section 9.2。 


请 注意 美元 符 界定 只 对 包围 固定 文本 有 用 。 如 果 想 像 下 面 这 样 做 上 面 的 例子 ， 那 就 太 糟 糕 了 : 


EXECUTE 'UPDATE tbl SET ' 
quote_ident(colname) 


| | 

| | 

| | newvalue 
|| '$$ WHERE key = ' 

|| quote_literal(keyvalue) ; 


因为 如 果 newvalue 的 内 容 碰巧 含有 ss ， 那 么 这 段 代 码 就 有 毛病 了 。 同样 的 问题 可 能 出 现在 
你 选用 的 任何 美元 符 界定 分 隔 符 上 。 因此 ， 要 想 安全 地 包围 事先 不 知道 的 文本 ， > 须 恰当 的 


使 用 quote_literal , quote_nullable 或 者 quote_ident o 


动态 SQL 语句 可 以 使 用 format KAZE HE (参阅 Section 9.4) 。 比 如 : 


EXECUTE format('UPDATE tbl SET %I = %L WHERE key = %L', colname, newvalue, keyvalue); 


在 usins 子 句 连接 中 使 用 format RX : 


EXECUTE format('UPDATE tbl SET %I = $1 WHERE key = $2', colname) 
USING newvalue, keyvalue; 


这 种 形式 更 有 效 ， 因 为 参数 newalue and keyvalue 不 转换 为 文本 。 


关于 动态 命令 和 execute 的 另 一 个 例子 是 Example 40-9, 这 个 例子 制作 并 执行 了 一 个 定义 新 
PALA CREATE FUNCTION #43. 


40.5.5. 获取 结果 状态 


有 好 几 种 方法 可 以 判断 一 条 命令 的 效果 。 第 一 个 方法 是 使 用 cet pracnostics ， 它 的 形式 如 
F: 


GET [ CURRENT ] DIAGNOSTICS _variable_ = _item_[, ... ]; 
这 条 命令 允许 检索 系统 状态 标识 符 。 每 个 itm 是 一 个 关键 字 ， 表示 一 个 将 要 赋予 该 特定 变 
量 的 状态 值 (该 变量 应 该 和 要 接收 的 数值 类 型 相同 )。 当前 可 用 的 状态 项 有 Row_couNT 、 最 后 一 


个 SQL 命 全 发 送 到 SQL 引 警 处 理 的 行 数量 、 REsULT_oID ， 最 后 一 条 SQL 命令 插入 的 最 后 一 
行 的 OID。 请 注意 RESULT oD 只 有 在 一 个 向 包含 OID 的 表 中 INSERT 的 命 合 之 后 才 有 用 。 


例如 : 


GET DIAGNOSTICS integer_var = ROW_COUNT; 


另外 一 个 判断 命令 效果 的 方法 是 一 个 boolean 类 型 的 特殊 变量 Foun, 它 在 每 个 PL/pgSQL 
函数 调用 中 Founp 开始 都 为 假 。 并 被 下 列 语句 设置 


e 一 个 SELECT into 语句 如 果 返 回 一 行 则 将 FouNp 设置 为 真 ， 如 果 没 有 返回 行 则 设置 为 
假 。 


e 一 个 PERFORM 语句 如 果 生 成 (或 抛弃 ) 一 行 ， 则 将 rou 设置 为 真 ， 如 果 没 有 生成 行 则 为 
假 。 


e。 如 果 至 少 影响 了 一 行 ， 那 么 UPDATE , INSERT 和 DELETE 语句 设置 FOUND 为 真 ， 如 果 没 
用 于 受 影响 则 为 假 。 

。 一 个 FETCH 语句 如 果 返 回 行 则 设置 FouNp 为 真 ， 如 果 不 返 回 行 则 为 假 
e 当成 功 定位 游标 的 位 置 时 ， move 将 FouNp 设 为 真 ， 反 之 为 假 。 


e — For 或 者 FoREACH 语句 如 果 和 迭代 了 一 次 或 多 次 ， 则 设置 FouNp 真 ， 否 则 为 假 。 只 
有 在 循环 退出 的 时 候 才 设置 FouNp ; 在 循环 执行 的 内 部 ， FouNp 不 被 循环 语句 修改 ， 但 
是 在 循环 体 里 它 可 能 被 其 它 语 句 的 执行 而 修改 。 


e 如 果 坦 询 结果 返回 至 少 一 个 行 ，_ RETURN QUERY and RETURN QUERY EXECUTE 声明 


将 FouNp 设 为 真 ， 反之 如 果 没 有 返回 行 ， 则 为 假 。 


其 他 的 PL/pgSQL 声 明 不 会 改变 FouNp 的 位 置 。 尤其 需要 注意 的 一 点 是 EXECUTE BIE 
改 GET DIAGNOSTICcS 的 输出 ， 但 不 会 修改 FouNp 的 输出 。 


FOUND 是 每 个 PL/pgSQL 里 的 局 部 变量 ; 任何 对 它 的 任何 修改 只 影响 当前 的 函数 。 


40.5.6. 什么 也 不 做 


有 时 一 个 什么 也 不 做 的 占 位 语句 也 是 很 有 用 的 。 例如 ， 用 于 if/then/else 的 空 分 支 。 可 以 使 
用 NuLL 语句 达到 这 个 目的 。 


NULL; 


比如 ， 下 面 的 两 段 代码 是 相等 的 : 


BEGIN 
y := x / 0; 
EXCEPTION 
WHEN division_by_zero THEN 
NULL; -- ignore the error 
END; 
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BEGIN 
y:=x/0; 
EXCEPTION 


WHEN division_by_zero THEN -- ignore the error 
END; 


究竟 使 用 哪 一 个 取决 于 个 人 的 喜好 。 


Note: 在 Oracle 的 PL/SQL 中 ， 不 允许 出 现 空 语句 列 ， 所 以 在 这 种 情况 下 必须 使 
用 NuLL 语句 ， 而 PL/pgSQL 人 允许 你 什么 也 不 写 。 


40.5. 基本 语句 1310 


40.6. 控制 结构 


控制 结构 可 能 是 PL/pgSQL 中 最 有 用 的 (以 及 最 重要 ) 的 部 分 了 。 利用 PL/pgSQL 的 控制 结构 
你 可 以 以 非常 灵活 而 且 强 大 的 方法 操纵 PostgreSQL 的 数据 。 


40.6.1. MEAG 


Sap By LA FASE M ESB RE EHE : RETURN 和 RETURN NEXT o 


40.6.1.1. RETURN 


RETURN _expression_; 


带 表 达 式 的 RETURN AFEK RE 并 把 _expression_ 的 值 返回 给 调用 者 。 这 种 形式 用 于 不 返 
lo] 2 GAYPL/pgSQLER. 


如 果 画 数 中 返回 标量 类 型 ， 那 么 表达 式 结 果 将 被 自动 转换 成 图 数 的 返回 类 型 ， 就 像 在 赋值 中 
eis 但 是 要 返回 一 个 复合 ( 行 ) 数 值 ， 你 必须 写 一 个 准确 提供 需求 列 集合 的 表达 式 ， 
可 能 需要 显 式 转换 。 


如 果 你 声明 带 有 输出 参数 的 画 数 ， 那 么 就 只 需要 写 无 表达 式 的 RETUR 。 那么 输出 参数 变量 的 
当前 值 将 被 返回 。 


如 果 你 声明 函数 返回 void ， 那 么 一 个 RETURN 语句 可 以 用 于 提前 退出 函数 ; 但 是 不 要 
在 RETURN 后 面 写 一 个 表达 式 。 


一 个 本 数 的 返回 值 不 能 是 未 定义 。 如 果 控 制 到 达 了 画 数 最 顶层 的 块 而 没有 磋 到 一 个 return 语 
句 ， 那么 它 就 会 发 生 一 个 错误 。 不 过 ， 这 个 限制 不 适用 于 带 输 出 参数 的 函数 以 及 那些 返 
E] void 的 函数 。 在 这 些 例 子 里 ， 如 果 顶 层 的 块 结束 ， 则 自动 执行 一 个 RETUR 语句 。 


例子 


- RE — Ana X Hw 
RETURN 1 + 2; 
RETURN scalar_var; 


- RORA ZEKA 
RETURN composite_type_var; 
RETURN (1, 2, 'three'::text); -- must cast columns to correct types 


40.6.1.2. RETURN NEXT 和 RETURN QUERY 


RETURN NEXT _expression_; 
RETURN QUERY _query_; 
RETURN QUERY EXECUTE _command-string_ [ USING ~_expression_~ [, ... ] ]; 


gn 52—-SPL/pgSQLW AAA ARE] setor _sometype_, 那么 遵循 的 过 程 则 略 有 不 同 。 在 
这 种 情况 下 ， 要 返回 的 独立 项 是 在 RETURN NEXT 或 者 RETURN QUERY 命令 里 声明 的 ， 然后 最 后 
有 一 个 不 带 参数 的 RETURN 命 合用 于 告诉 这 个 画 数 已 经 完成 执行 了 。 RETURN NEXT 可 以 用 于 标 
RNAAR ; 对 于 复合 类 型 ， 将 返回 一 个 完整 的 结果 "table"。 RETURN QUERY 命令 将 一 
条 查询 的 结果 追加 到 一 个 函数 的 结果 集中 。 RETURN NEXT 和 RETURN QUERY 在 单一 集合 返回 函 
数 中 自由 混合 ， 在 这 种 情况 下 ， 结 果 将 被 级 联 。 


RETURN NEXT 和 RETURN QUERY 实际 上 不 会 从 辑 数 中 返回 ， 它们 是 将 需 或 者 多 个 行 追 加 到 函数 
的 结果 集中 。 然后 继续 执行 PL/pgSQL 画 数 里 的 下 一 条 语句 。 随 着 后 继 的 RETURN NEXT 或 
者 RETURN QUERY 命令 的 执行 ， 结果 集 就 建立 起 来 了 。 最 后 一 个 RETR 应 该 没有 参数 ， CH 
致 控制 退出 该 画 数 (或 者 你 可 以 简单 地 让 控制 到 达 画 数 的 结尾 )。 


RETURN QUERY 有 一 个 变形 RETURN QUERY EXECUTE, 指定 查询 将 被 动态 执行 。 参数 表达 式 可 以 
通过 usins 插入 到 计算 查询 字符 串 中 ， 以 ExEcuTE 命 命 的 同样 方式 。 


DORIAN AMS, BARR RE SA i RIA UAV RETURN NEXT. 输出 参数 的 当 
前 值 将 被 保存 ， 用 于 最 终 返 回 。 请 注意 如 果 有 多 个 输出 参数 ， 比如 声明 函数 为 返 

回 SETOF record 或 者 是 在 只 有 一 个 类 型 为 _sometype_ 的 输出 参数 时 声明 为 SETOF 
_sometype_, 这 样 二 能 创建 一 个 带 有 输出 参数 的 返回 集合 的 函数 。 


下 面 是 一 个 使 用 RETURN NEXT 的 画 数 例子 : 


CREATE TABLE foo (fooid INT, foosubid INT, fooname TEXT); 
INSERT INTO foo VALUES (1, 2, 'three'); 
INSERT INTO foo VALUES (4, 5, 'six'); 


CREATE OR REPLACE FUNCTION get_all_foo() RETURNS SETOF foo AS 
$BODY$ 
DECLARE 
r foo%rowtype; 
BEGIN 
FOR r IN 
SELECT * FROM foo WHERE fooid > 0 
LOOP -- 可 以 在 这 里 做 一 些 处 理 
RETURN NEXT r; -- return current row of SELECT 
END LOOP; 
RETURN; 
END 
$BODY$ 
LANGUAGE plpgsql; 


SELECT * FROM get_all_foo(); 


这 是 一 个 使 用 RETURN query AEG: 


CREATE FUNCTION get_available_flightid(date) RETURNS SETOF integer AS 
$BODY$ 
BEGIN 
RETURN QUERY SELECT flightid 
FROM flight 
WHERE flightdate >= $1 
AND flightdate < ($1 + 1); 
-- 由 于 没有 完成 执行 ， 我 们 可 以 检查 行 是 否 返回 并 且 如 果 没 有 则 抛 出 异常 。 
IF NOT FOUND THEN 
RAISE EXCEPTION 'No flight at %.', $1; 
END IF; 


RETURN; 
END 
$BODY$ 
LANGUAGE plpgsql; 
-- 如 果 没 有 可 用 航班 ， 则 返回 可 用 航班 或 者 抛 出 异常 。 
SELECT * FROM get_available_flightid(CURRENT_DATE); 


Note: 目前 RETURN NEXT 和 RETURN QUERY 32 9U7EM ES BORG) 2 BIBS HRA Rie 
K, MRE MANA. RRB RSMR—TPPL/pgSQLWNWMtK—TERAWAR 

E, 性 能 可 能 会 很 差 : 数据 将 被 写 到 磁盘 上 以 避免 内 存 耗 尽 ， BEHWRMERRMETAR 
集 的 生成 之 前 不 会 退出 。 将 来 的 PL/pgSQL 版 本 可 能 会 允许 用 户 定义 没有 这 样 限制 的 返 
OAKA. 目前 ， 数 据 开 始 向 磁盘 里 写 的 时 刻 是 由 配置 变量 work_mem 控 制 的 。 拥 
有 足够 内 存 的 管理 员 如 果 想 在 内 存 里 存储 更 大 的 结果 集 ， 则 可 以 考虑 把 这 个 参数 增 大 一 


此 
—o 


40.6.2. 条 件 


IF 和 case 语句 让 你 可 以 根据 某 种 条 件 执行 命令 。 PL/pgSQL 有 三 种 形式 的 IF 


e IF... THEN 
© IF... THEN ... ELSE 
e IF... THEN ... ELSIF ... THEN ... ELSE 
以 及 两 种 形式 的 case : 
e CASE ... WHEN ... THEN ... ELSE ... END CASE 
© CASE WHEN ... THEN ... ELSE ... END CASE 


40.6.2.1. IF-THEN 


IF _boolean-expression_ THEN 
_statements_ 
END IF; 


IF-THEN 语句 是 IF 的 最 简单 形式 。 如 果 条 件 为 真 ， 在 THEN 和 END IF 之 间 的 语句 将 被 执 
行 。 否则 ， 将 忽略 它们 。 


例如 : 


IF v_user_id <> 0 THEN 
UPDATE users SET email = v_email WHERE user_id = v_user_id; 
END IF; 


40.6.2.2. IF-THEN-ELSE 


IF _boolean-expression_ THEN 
_statements_ 

ELSE 
_statements_ 

END IF; 


IF-THEN-ELSE 语句 增加 了 IF-THEN 的 分 支 ， 让 你 可 以 声明 在 条 件 为 假 的 时 候 执 行 的 语句 。 
(请 注意 这 包含 条 件 是 NULL 的 情况 ) 。 


例如 : 


IF parentid IS NULL OR parentid = '' 
THEN 
RETURN fullname; 
ELSE 
RETURN hp_true_filename(parentid) || '/' || fullname; 
END IF; 


IF v_count > 0 THEN 
INSERT INTO users_count (count) VALUES (v_count); 


RETURN 't'; 
ELSE 

RETURN 'f'; 
END IF; 


40.6.2.3. IF-THEN-ELSIF 


IF _boolean-expression_ THEN 


_statements_ 

[ ELSIF ~_boolean-expression_~ THEN 
*_statements_- 

[ ELSIF ~_boolean-expression_~ THEN 
*_statements_~ 
zai 

[ ELSE 


`_statements_` ] 
END IF; 


有 时 不 止 两 个 选择 。 IF-THEN-ELSIF 反 过 来 提供 了 一 个 简便 的 方法 来 检查 选择 条 件 。 IF Hl 
断 会 陆续 检查 ， 直 到 找到 第 一 个 为 真 的 ， 然 后 执行 相关 声明 ， 如 此 ， 直到 en IF (不 会 检 
测 IF 子 查询 ) 。 如 果 没有 一 个 条 件 符合 IF 判断 ， 那 么 会 接着 执行 ELsE 判断 。 


例如 : 

IF number = © THEN 
result := 'zero'; 

ELSIF number > © THEN 
result := 'positive'; 

ELSIF number < © THEN 
result := 'negative'; 

ELSE -- 唯一 可 能 性 是 号 码 为 空 
result := 'NULL'; 

END IF; 


ELSIF 关键 字 也 可 以 写成 ELSEIF 。 


另 一 个 可 以 实现 该 目的 的 方法 是 使 用 IF-THEN-ELSE 声明 ， 如 下 : 


IF demo_row.sex = 'm' THEN 
pretty_sex := 'man'; 
ELSE 
IF demo_row.sex = 'f' THEN 
pretty_sex := 'woman'; 
END IF; 
END IF; 


然而 ， 这 个 方法 需要 为 每 个 r B END IF ， 因此 当 有 很 多 选择 时 ， 这 种 方法 明显 比 esr 繁 
琐 。 


40.6.2.4. 简单 CASE 


CASE _search-expression_ 


WHEN _expression_ [, ~_expression_~ [ ... ]] THEN 
_statements_ 
[ WHEN ~_expression_~ [, ~_expression_~ [ ... ]] THEN 
~_statements_~ 
[ ELSE 
~_statements_~ ] 
END CASE; 


cASE 简单 的 形式 提供 基于 操作 数 平等 的 条 件 执行 。 _search-expression 被 评价 并 且 先后 比 
较 wHEN 子 句 中 的 每 个 _ 表 达 式 ”。 如 果 找 到 匹配 ， 那 么 相应 的 statements. 被 执行 ， 然后 控 
制 在 END case 之 后 传递 到 下 一 个 语句 。 (随后 的 wen 表达 式 不 被 评估 。) 如 果 没 有 发 现 匹 
配 ， 执 行 ELSE _statements_ ; 但 如 果 ELsE 是 不 存在 的 ， 然 后 引发 cAsE_NoT_FouND 异常 。 


例如 : 


CASE x 
WHEN 1, 2 THEN 


msg := 'one or two'; 
ELSE 
msg := ‘other value than one or two'; 
END CASE; 


40.6.2.5. 搜索 CASE 


CASE 
WHEN _boolean-expression_ THEN 
_statements_ 
[ WHEN ~_boolean-expression_~ THEN 
~_statements_~ 
[ ELSE 
~_statements_~ ] 
END CASE; 


case 搜索 形式 基于 布尔 表达 式 的 真理 提供 条 件 执 行 。 每 个 whEN $4 

的 _boolean-expression_ 依次 被 评估 ， 直到 找到 一 个 产生 true 为 止 。 然后 执行 相应 

的 _statements_, 控制 enn case 之 后 传递 到 下 一 个 语句 。 (随后 不 评估 whEN 表达 式 ) 。 
如 果 发 现 没 有 真实 结果 ， 则 执行 ELSE`、_statements”; 但 如 果 ELsE 是 不 存在 的 ， 那 么 引发 


CASE_NOT_FOUND 异常 。 
例如 : 


CASE 
WHEN x BETWEEN © AND 10 THEN 
msg := 'value is between zero and ten'; 
WHEN X BETWEEN 11 AND 20 THEN 
msg := 'value is between eleven and twenty'; 
END CASE; 


CASE 这 种 形式 完全 等 价 于 IF-THEN-ELSIF ， 除 了 达到 忽略 错误 中 的 ELsE 子 句 结果 而 不 是 什 
么 都 不 做 的 规则 。 


40.6.3. 简单 循环 


使 用 Loop , EXIT , CONTINUE , WHILE, FOR 和 FOREACH 语句 ， 可 以 控制 PL/pgSQL 画 数 重 复 


一 系列 命令。 


40.6.3.1. 循环 


[ <<°_label_~>> ] 
LOOP 
_statements_ 
END LOOP [ ~_label_~ ]; 


Loop 定义 一 个 无 条 件 的 循环 ， 无 限 循环 ， 直到 由 exit 或 者 return 语句 终止 。 可 选 
的 _label_ 可 以 由 exit 和 continue 语句 使 用 ， 用 于 在 储 套 循环 中 声明 应 该 应 用 于 哪 一 尽 循 
环 。 


40.6.3.2. 退出 


EXIT [ ~_label_~ ] [ WHEN ~_boolean-expression_~ ]; 


如 果 没 有 给 出 label ， 那 么 退出 最 内 层 的 循环 ， 然后 执行 跟 在 END Loop 后 面 的 语句 。 如 
RAH label ， 那么 它 必须 是 当前 或 者 更 高 层 的 启 套 循环 块 或 者 语句 块 的 标签 。 然后 该 命 
名 块 或 者 循环 就 会 终止 ， 而 控制 落 到 对 应 循环 / 块 的 ENp 语句 后 面 的 语句 上 。 


如 果 声 明了 wen, 循环 退出 只 有 在 _boolean-expression 为 真 的 时 候 才 发 生 ， 否则 控制 会 
落 到 ExIT 后 面 的 语句 上 。 


EXIT 可 以 用 于 在 所 有 的 循环 类 型 中 ， 它 并 不 仅仅 限制 于 在 无 条 件 循 环 中 使 用 。 


在 和 secin 块 一 起 使 用 的 时 候 ， exit 把 控制 交 给 块 结 束 后 的 下 一 个 语句 。 需要 注意 的 是 ， 
一 个 标签 必须 用 于 这 个 目的 ; 一 个 没有 标记 的 exit 永远 无 法 与 BEGIN 进行 匹配 。 (这 是 
PostgreSQL 8.4 之 前 版 本 的 一 个 变化 ， 这 将 允许 未 标记 EXIT 匹配 BEGIN 块 ) o 


例如 : 


LOOP 


- 一 些 计算 
IF count > © THEN 
EXIT; -- exit loop 
END IF; 
END LOOP; 


LOOP 


- 一 些 计算 
EXIT WHEN count > 0; -- 和 前 面 的 例子 相同 结果 
END LOOP; 


<<ablock>> 
BEGIN 


- 一 些 计算 
IF stocks > 100000 THEN 
EXIT ablock; -- 导致 从 BEGIN 块 退出 
END IF; 
- 忽略 这 儿 的 计算 ， 当 stocks > 100000 时 
END; 


40.6.3.3. CONTINUE 


CONTINUE [ ~_label_~ ] [ WHEN ~_boolean-expression_~ ]; 


如 果 没 有 给 出 label ， 那 么 就 开始 最 内 层 循环 的 下 一 次 执行 。 也 就 是 说 ， 控 制 传递 回 给 循 
环 控制 表达 式 (如 果 有 )， 然 后 重新 计算 循环 体 。 如 果 出 现 了 _label_ ， 它 声明 即将 继续 执行 
的 循环 的 标签 。 


如 果 声 明了 whEN ， 那 么 循环 的 下 一 次 执行 只 有 E _boolean-expression. 为 真 的 情况 下 才 进 
行 。 否则 ， 控 制 传递 给 coNTINUE 后 面 的 语句 。 


conTINUE 可 以 用 于 所 有 类 型 的 循环 ; 它 并 不 仅仅 限于 无 条 件 循环 。 
例如 : 


LOOP 


- 一 些 计 算 
EXIT WHEN count > 100; 
CONTINUE WHEN count < 50; 
-- 在 [50 .. 100] 内 的 计算 
END LOOP; 


40.6.3.4. WHILE 


[ <<`_label_`>> ] 

WHILE _boolean-expression_ LOOP 
_statements_ 

END LOOP [ ~_label_~ ]; 


只 要 条 件 表 达 式 ( _boolean-expression.) 为 真 ， WHILE 语句 就 会 不 停 的 在 一 系列 语句 上 进 
行 循环 ， 条 件 是 在 每 次 进入 循环 体 的 时 候 被 检查 。 


例如 : 


WHILE amount_owed > 0 AND gift_certificate_balance > 0 LOOP 
- 这 里 的 一 些 计算 
END LOOP; 


WHILE NOT done LOOP 
- 这 里 的 一 些 计算 
END LOOP; 


40.6.3.5. For (Integer = =) 


[ <<°_label_~>> ] 

FOR _name_ IN [ REVERSE ] _expression_ .. _expression_ [ BY ~_expression_~ ] LOOP 
_statements_ 

END LOOP [ ~_label_~ ]; 


这 种 形式 的 For 对 一 定 范围 的 整数 进行 迭代 的 循环 。 变量 name 会 自动 定义 为 BY 类 型 并 且 
只 在 循环 里 存在 (任何 该 变量 名 的 现存 定义 在 此 循环 内 都 将 被 忽略 )。 给 出 范围 上 下 界 的 两 个 
表达 式 在 进入 循环 的 时 候 计 算 一 次 。 BY 子 句 指定 迭代 步 长 ( 缺 省 为 1)， 但 如 果 声 明 


了 REVERSE 步 长 将 变 为 相应 的 负 值 。 
一 些 整数 FoR 循环 的 例子 : 


FOR i IN 1..10 LOOP 
-- 我 将 在 值 1, 2, 3, 4, 5, 6,7,8,9,10 中 循环 
END LOOP; 


FOR i IN REVERSE 10..1 LOOP 

-- 将 在 值 10, 9, 8,7,6,5,4,3,2,14 中 循环 
END LOOP; 
FOR i IN REVERSE 10..1 BY 2 LOOP 


-- 将 在 值 10,8,6,4, 2 中 循环 
END LOOP; 


如 果 下 界 大 于 上 界 (或 者 是 在 reverse 情况 下 是 小 于 )， 那么 循环 体 将 完全 不 被 执行 。 而 且 不 
会 抛 出 任何 错误 。 
如 果 _label_ 被 附加 到 For 循环 ， 那 么 整数 循环 变量 可 以 使 用 label. 引用 适当 名 称 。 


40.6.4. 通 万 命令 结果 
使 用 不 同类 型 的 FoR 循环 ， 你 可 以 通 历 一 个 命令 的 结果 并 且 对 其 进行 相应 的 操作 。 语 法 是 : 


[ <<°_label_*>> ] 

FOR _target_ IN _query_ LOOP 
_statements_ 

END LOOP [ ~_label_~ ]; 





_target_ 是 一 个 记录 变量 、 行 变 量 、 逗 号 分 隔 的 标量 变量 列表 _target ”被 连续 不 断 赋予 所 
有 来 自 _query_ 的 行 ， 并 且 循 环 体 将 为 每 行 执 行 一 次 。 下 面 是 一 个 例子 : 


CREATE FUNCTION cs_refresh_mviews() RETURNS integer AS $$ 
DECLARE 

mviews RECORD; 
BEGIN 

RAISE NOTICE 'Refreshing materialized views...'; 


FOR mviews IN SELECT * FROM cs_materialized_views ORDER BY sort_key LOOP 
-- 现在 "mviews" 里 有 了 一 条 来 自 cs_materialized_views 的 记录 


RAISE NOTICE 'Refreshing materialized view %s ...', quote_ident(mviews.mv_name) ; 
EXECUTE 'TRUNCATE TABLE ' || quote_ident(mviews.mv_name); 
EXECUTE 'INSERT INTO ' 
|| quote_ident(mviews.mv_name) || ' ' 
|| mviews.mv_query; 
END LOOP; 


RAISE NOTICE 'Done refreshing materialized views.'; 
RETURN 1; 

END; 

$$ LANGUAGE plpgsql; 


4 — 





如 果 循 环 是 用 一 个 exit 语句 终止 的 ， 那么 在 循环 之 后 你 仍然 可 以 访问 最 后 赋值 的 行 。 


FOR 语句 中 使 用 的 这 种 query, 可 以 是 任何 返回 行 的 SQL 命令 ， 通常 是 SELECT, Mig A 
有 RETURNING 子 句 的 INSERT , UPDATE 或 DELETE 也 是 可 以 的 ， 一 些 诸如 EXPLAIN 之 类 的 命令 
也 可 以 。 


PL/pgSQL 变 量 代替 查询 文本 ， 并 且 查 询 计 划 为 了 重新 使 用 被 缓存 ， 正 如 Section 40.10.1 和 
Section 40.10.2。 


FOR-IN-EXECUTE 语句 是 通 历 所 有 行 的 另外 一 种 方法 : 


[ <<`_label_`>> ] 

FOR _target_ IN EXECUTE _text_expression_ [ USING ~_expression_~ [, ... ] ] LOOP 
_statements_ 

END LOOP [ ~_label_~ ]; 


这 个 例子 类 似 前 面 的 形式 ， 只 不 过 源 查询 语句 声明 为 了 一 个 字符 串 表 达 式 ， 这 样 它 在 每 次 进 
入 FoR 循环 的 时 候 都 会 重新 计算 和 生成 执行 计划 。 这 样 就 允许 程序 员 在 一 个 预先 规划 好 了 的 
命令 所 获得 的 速度 和 一 个 动态 命令 所 获得 的 灵活 性 (就 像 一 个 简单 的 execute 语句 那样 ) 之 间 

进行 选择 。 当 使 用 execute 时 ， 可 以 通过 usins 将 参数 值 插 入 到 动态 命令 中 。 


对 于 一 个 需要 将 结果 和 迭代 的 查询 ， 另外 一 个 声明 的 方法 是 将 它 定义 为 游标 (cursor), AS 
阅 Section 40.7.4。 


40.6.5. im 7 Ža 


FOREACH 循环 类 似 于 For 循环 ， (BR Bie FSQOLSAMRENT, CAMBER (—-K 
TS, FOREACH 是 通 历 复合 值 表 达 式 组 成 部 分 ; 循环 通 历 除数 组 外 的 复合 值 变量 将 来 可 以 被 
添加 。) FOREACH 语句 循环 数组 是 : 


[ <<`_label_`>> ] 

FOREACH _target_ [ SLICE ~_number_~ ] IN ARRAY _expression_ LOOP 
_statements_ 

END LOOP [ ~_label_~ ]; 


没有 stice ， 或 者 如 果 声 明 sticeo, W) 循环 通 万 通过 评估 _expression_ 产生 的 数组 的 单个 
元 素 。 _target_ 变量 分 配 每 个 序列 中 的 元 素 值 ， 并 为 每 个 元 素 执 行 循环 体 。 这 里 是 台历 整 
数 数组 元 素 的 一 个 例子 : 


CREATE FUNCTION sum(int[]) RETURNS int8 AS $$ 
DECLARE 
s int8 := 0; 
x int; 
BEGIN 
FOREACH x IN ARRAY $1 
LOOP 
S GS See 
END LOOP; 
RETURN s; 
END; 
$$ LANGUAGE plpgsql; 


3 bea 不 仑 数组 维 数 的 数量 。 尽管 _target_ 通常 只 是 一 个 单一 的 变量 ， 
循环 复合 值 的 数组 (记录 ) 时 ， 它 可 以 是 一 个 变量 列表 ， 在 这 种 情况 下 ， 每 个 数组 元 素 ， 
ee pa a 


以 正 数 sLIcE 值 ， FoREACH 通 历 数组 的 元 素 部 分 ， 而 不 是 单一 元 素 。 slice 的 值 必 须 是 不 大 
于 数组 维 数 的 整数 常数 。 _target ”变量 必须 是 一 个 数组 ， 并 且 它 接收 数组 值 的 连续 片段 ， 
而 每 个 片段 是 通过 sL 指定 的 维 数 。 这 里 是 通 历 一 维 切片 的 一 个 例子 


CREATE FUNCTION scan_rows(int[]) RETURNS void AS $$ 
DECLARE 

x int[]; 
BEGIN 

FOREACH x SLICE 1 IN ARRAY $1 

LOOP 

RAISE NOTICE ‘row = %', x; 

END LOOP; 
END; 
$$ LANGUAGE plpgsql; 


SELECT scan_rows(ARRAY[[1, 2,3], [4,5,6],[7,8,9],[10,11,12]]); 


NOTICE: row = {1,2,3} 
NOTICE: row = {4,5,6} 
NOTICE: row = {7,8,9} 
NOTICE: row = {10,11,12} 


40.6.6. 捕获 错误 


缺 省 时 ， 一 个 在 PL/pgSQL 画 数 里 发 生 的 错误 退出 函数 的 执行 ， 并 且 实 际 上 其 周围 的 事务 也 会 
退出 。 你 可 以 使 用 一 个 带 有 exception 子 句 的 BEGIN 块 捕获 错误 并 且 从 中 恢复 。 其 语法 是 正 
常 的 BEGIN 块 语法 的 一 个 扩展 : 


[ <<` label `>> ] 


[ DECLARE 
~_declarations_~ ] 
BEGIN 
_statements_ 
EXCEPTION 
WHEN _condition_ [ OR ~_condition_~ ... ] THEN 
_handler_statements_ 
[ WHEN ~_condition_~ [ OR ~_condition_~ ... ] THEN 
*_handler_statements_~ 
.] 
END; 


如 果 没 有 发 生 错 误 ， 这 种 形式 的 块 只 是 简单 地 执行 所 有 _statements_, 然后 转 到 下 一 

个 enn 之 后 的 语句 。 但 是 如 果 在 _statements_ 内 部 发 生 了 一 个 错误 ， 则 对 _statements_ 的 
进一步 处 理 将 废弃 ， 然 后 转 到 exception 列表 。 系统 搜索 这 个 列表 ， 寻 找 匹 配 错误 的 第 一 

个 _condition_ o 如 果 找 到 匹配 ， 则 执行 对 应 的 _handler_statements_ , 然后 转 到 END 之 后 

的 下 一 个 语句 。 如 果 没 有 找到 匹配 ， 该 错误 就 会 广播 出 去 ， 就 好 像 根本 没有 exception 子 句 

一 样 : 该 错误 可 以 被 一 个 包围 块 用 exception 捕获 ， 如 果 没 有 包围 块 ， 则 退出 函数 的 义理 。 


_condition. 的 名 字 可 以 是 Appendix A 里 显示 的 任何 名 字 。 一 个 范畴 名 匹配 任意 该 范畴 里 的 
AiR. 特殊 的 条 件 名 oTHERS 匹配 除了 QuERY_cANCELED 之 外 的 所 有 错误 类 型 。 可 以 用 名 字 捕 
获 QUERY_CANCELED ， 不 过 通常 是 不 明智 的 。 条 件 名 是 大 小 写 无 关 的 。 同 时 也 可 以 通 
过 SQLSTATE 来 声明 一 个 错误 条 件 ， 例如 : 


WHEN division_by_zero THEN ... 
WHEN SQLSTATE '22012' THEN ... 


WORE 中 的 _handler_statements_ 里 发 生 了 新 错误 ， 那么 它 不 能 被 这 个 EXCEPTION 子 句 捕 
获 ， 而 是 传播 出 去 。 一 个 外 层 的 ExcEPTION 子 句 可 以 捕获 它 。 


如 果 一 个 错误 被 exception 捕获 ，PL/pgSQL 辑 数 的 局 部 变量 保持 错误 发 生 时 的 原 值 ， 但 是 所 
有 该 块 中 想 固 化 在 数据 库 中 的 状态 都 回 滚 。 作为 一 个 例子 ， 让 我 们 看 看 下 面 片断 : 


INSERT INTO mytab(firstname, lastname) VALUES('Tom', 'Jones'); 
BEGIN 
UPDATE mytab SET firstname = 'Joe' WHERE lastname = 'Jones'; 
x HS ap ale 
y := x / 0; 
EXCEPTION 
WHEN division_by_zero THEN 
RAISE NOTICE ‘caught division_by_zero'; 
RETURN x; 
END; 


当 控 制 到 达 给 y 赋值 的 地 方 时 ， 它 会 带 着 一 个 division_by_zero 错误 失败 。 这 个 错误 将 
被 EXCEPTION 子 句 捕获 。 而 在 RETURN 语句 里 返回 的 数值 将 是 x 的 增 量 值 。 但 是 uppATE 已 
经 被 回 滚 。 然 而 ， 在 该 块 之 前 的 INSERT 将 不 会 回 滚 ， 因此 最 终 的 结果 是 数据 库 包 


= Tom Jones 而 不 是 Joe Jones o 





Tip: 进入 和 退出 一 个 包含 ExcEPTION 子 名 的 块 要 比 不 包含 的 块 开 销 大 的 多 。 因此 ， 不 必 
要 的 时 候 不 要 使 用 EXCEPTION 。 














Example 40-2. uppate / INSERT 异常 
这 个 例子 根据 使 用 异常 处 理 器 执行 恰当 的 uppATE 或 者 INSERT o 


CREATE TABLE db (a INT PRIMARY KEY, b TEXT); 


CREATE FUNCTION merge_db(key INT, data TEXT) RETURNS VOID AS 


$$ 
BEGIN 
LOOP 
-- 第 一 次 尝试 更 新 key 
UPDATE db SET b = data WHERE a = key; 
IF found THEN 
RETURN; 
END IF; 
-- 不 存在 ， 所 以 尝试 插入 key, 如 果 其 他 人 同时 插入 相同 的 key， 我 们 可 能 得 到 了 唯一 key 失 败 。 
BEGIN 
INSERT INTO db(a,b) VALUES (key, data); 
RETURN; 
EXCEPTION WHEN unique_violation THEN 
-- 什么 也 不 做 ， 并 且 循 环 党 试 再 次 更 新 。 
END; 
END LOOP; 
END; 
$$ 


LANGUAGE plpgsql; 


SELECT merge_db(1, 'david'); 
SELECT merge_db(1, 'dennis'); 


这 个 代码 假设 通过 INSERT 不 是 说 表 上 触发 器 函数 中 的 insert 产生 unique violation 错误 ， 
如 果 表 上 有 超过 一 个 以 上 的 唯一 索引 ， 它 可 能 行为 不 端 ， 因为 将 重 斌 操作 不 论 哪 个 索引 产生 
zi. 可 以 通过 特性 讨论 下 一 步 检查 捕获 的 错误 是 预期 的 来 获取 更 高 的 安全 性 。 


40.6.6.1. 获得 有 关 错 误 的 信息 


异常 处 理 程序 经 常 需要 确定 发 生 的 具体 错误 。 有 两 种 方法 来 获得 当前 PL/pgSQL 异 常 : 特殊 
变量 和 GET STACKED DIAGNOSTICS 命令 的 有 关 信 息 。 


在 一 个 异常 处 理 程序 中 ， 特 殊 变 量 sosar 包含 相当 于 发 生 异 常 的 错误 代码 (参考 Table A- 
1 获得 可 能 错误 代码 列 ) 。 特殊 变量 sQLERRM 包含 与 异常 有 关 的 错误 消息 。 这 些 变量 是 在 异 
常人 处理 外 未 被 定义 的 。 


在 一 个 异常 处 理 程 序 中 ， 也 可 以 检索 关于 使 用 GET stacken pIAGNOSTICS 命 合 的 当前 异常 信 
息 ， 形成 了 : 


GET STACKED DIAGNOSTICS _variable_ = _item_[, ... ]; 


每 个 item 是 识别 被 分 配 到 指定 变量 的 状态 值 (应 该 是 接收 它 的 正确 数据 类 型 ) 的 一 个 关键 
字 。 目前 可 用 的 状态 显示 在 Table 40-1 中 。 


Table 40-1. 错误 诊断 值 


名 字 类 型 描述 
RETURNED_SQLSTATE text 异常 的 SQLSTATE 错 误 代 码 
COLUMN_NAME text 与 异常 相关 的 列 名 
CONSTRAINT_NAME text 与 异常 相关 的 约束 名 
PG_DATATYPE_NAME text 与 异常 相关 的 数据 类 型 名 
MESSAGE_TEXT text 异常 的 主要 消息 文本 
TABLE_NAME text 与 异常 相关 的 表 名 
SCHEMA_NAME text 与 异常 相关 的 模式 名 
PG_EXCEPTION_DETAIL text 异常 的 详细 信息 文本 ， 如 果 任 何 
PG_EXCEPTION_HINT text 异常 的 提示 信息 文本 ， 如 果 任 何 
PG_EXCEPTION_CONTEXT text 描述 调用 堆栈 的 文本 线程 


如 果 异 常 没有 设置 项 值 ， 则 返回 空 字 符 串 。 


例子 : 


DECLARE 
text_vari text; 
text_var2 text; 
text_var3 text; 

BEGIN 


- 一 些 处 理 可 能 引起 异常 


EXCEPTION WHEN OTHERS THEN 
GET STACKED DIAGNOSTICS text_var1 = MESSAGE_TEXT, 
text_var2 PG_EXCEPTION_DETAIL, 
text_var3 PG_EXCEPTION_HINT; 


END; 


40.7. 游标 


如 果 不 想 一 次 执行 整个 命令 ， 可 以 设置 一 个 封装 该 命令 的 游标 (cursor), 然后 每 次 读 取 几 
行 命令 结果 。 这 么 干 的 一 个 原因 是 在 结果 包含 数量 非常 大 的 行 时 避免 内 存 耗 尽 。 不 过 
PL/pgSQL 用 户 不 必 担 心 这 个 ， 因 为 FoR 循环 自动 在 内 部 使 用 一 个 游标 以 避免 内 存 问题 。 一 
个 更 有 趣 的 用 法 是 某 个 函数 可 以 返回 一 个 它 创 建 的 游标 的 引用 ， 这 样 就 允许 调用 者 读 取 各 
行 。 从 而 提供 了 一 种 从 函数 返回 一 个 结果 集 的 手段 。 


40.7.1. 声明 游标 变量 


所 有 在 PL/pgSQL 里 对 游标 的 访问 都 是 通过 游标 变量 实现 的 ， 它 总 是 特殊 的 数据 类 
型 refcursor o 创建 游标 变量 的 一 个 方法 是 把 它 声 明 为 一 个 类 型 为 refcursor 的 变量 。 另外 
一 个 方法 是 使 用 游标 声明 语法 ， 像 下 面 这 样 : 


_name_ [ [ NO ] SCROLL ] CURSOR [ ( ~_arguments_~ ) ] FOR _query_; 


(Oracle 兼 容 中 ror 可 以 用 is RÆ) 如 果 定 义 了 scRoLL ， 则 游标 可 以 向 后 回 滚 ; 如 果 定 义 
了 No scRoLL ， 则 向 后 抓 取 的 动作 被 拒绝 ; 如 果 二 者 都 没有 定义 ， 那么 是 否 进行 向 后 取 的 动 
作 会 根据 查询 来 判断 。 如 果 有 _arguments_, 那么 它 是 一 个 和 逗号 分 隔 _name ``_datatype 4 
表 ， 这 个 列表 定义 由 已 给 查询 中 的 参数 值 来 蔡 代 的 name。 实际 用 于 代 换 这 些 名 字 的 数值 将 
在 游标 打开 之 后 声明 。 


例如 : 


DECLARE 
curs1 refcursor; 
curs2 CURSOR FOR SELECT * FROM tenk1; 
curs3 CURSOR (key integer) FOR SELECT * FROM tenk1 WHERE uniquei = key; 


所 有 这 三 个 变量 都 是 refcursor 类 型 ， 但 是 第 一 个 可 以 用 于 任何 命令 ， 而 第 二 个 已 经 绑 定 
(bound) 了 一 个 声明 完整 的 命令 ， 最 后 一 个 是 绑 定 了 一 个 带 参 数 的 命令 。 key 将 在 游标 打 
开 的 时 候 被 代 换 成 一 个 整数 。 变量 cursi 可 以 称 之 为 未 绑 定 的 ， 因为 它 没有 和 任何 查询 相 绑 
定 。 


40.7.2. 打开 游标 


在 你 使 用 游标 检索 行 之 前 ， 你 必需 先 打 开 它 。 这 是 和 SQL 命令 DECLARE CURSOR 相等 的 操作 。 
PL/pgSQL 有 三 种 形式 的 open 语句 ， 两 种 用 于 未 绑 定 的 游标 变量 ， 另外 一 种 用 于 已 绑 定 的 游 
标 变量 。 








Note: 可 以 通过 Section 40.7.4 中 描述 的 FoR 语句 ， 在 不 用 打开 游标 的 情况 下 使 用 已 绑 定 
的 游标 。 


40.7.2.1. OPEN FOR _query_ 


OPEN _unbound_cursorvar_ [ [ NO ] SCROLL ] FOR _query_; 


该 游标 变量 打开 并 且 执 行 给 出 的 查询 。 游 标 不 能 是 已 经 打开 的 ， 并 且 它 必需 是 声明 为 一 个 未 
绑 定 的 游标 (也 就 是 声明 为 一 个 简单 的 refcursor 变量 )。 查询 必须 是 一 条 SELECT 或 者 其 它 返 
回 行 的 东西 (比如 ExPLAIN )。 查询 是 和 其 它 在 PL/pgSQL 里 的 SQL 命令 平等 对 待 的 : 先 代 换 
PL/pgSQL 的 变量 名 ， 而 且 执行 计划 为 将 来 可 能 的 复 用 缓存 起 来 。 4—FSPLpgSOLZ SRE 
换 到 游标 查询 中 时 ， 被 蔡 换 的 值 是 在 oPEN 时 它 所 具有 的 值 。 后 续 的 改变 不 会 影响 游标 的 动 
作 ， 对 于 一 个 已 经 绑 定 的 游标 来 说 ， SCROLL 和 No ScROLL 这 两 个 选项 具有 相同 的 含义 。 


一 个 例子 : 


OPEN cursi FOR SELECT * FROM foo WHERE key = mykey; 


40.7.2.2. OPEN FOR EXECUTE 


OPEN _unbound_cursorvar_ [ [ NO ] SCROLL ] FOR EXECUTE _query_string 
[ USING ~_expression_~ [, ... ] ]; 





打开 游标 变量 并 且 执 行 给 出 的 查询 。 游 标 不 能 是 已 打开 的 ， 并 且 必 须 声 明 为 一 个 未 绑 定 的 游 
标 (也 就 是 一 个 简单 的 refcursor 变量 )。 命令 是 用 和 那些 用 于 EXECUTE 命令 一 样 的 方法 声明 的 
字符 串 表 达 式 ， 这 样 ， 就 有 了 命 命 可 以 在 两 次 运行 间 发 生变 化 的 灵活 性 。 参阅 Section 
40.10.2) 这 也 意味 着 在 命令 字符 串 上 不 能 进行 变量 蔡 换 。 跟 ExEcuTE 一 起 ， 通 过 使 

用 usins ， 参 数值 可 以 被 插入 到 动态 命 爷 中 。 对 于 一 个 已 经 绑 定 的 游标 来 

说 ， SCROLL 和 No scROLL 这 两 个 选项 具有 相同 的 含义 。 


一 个 例子 : 


OPEN curs1 FOR EXECUTE 'SELECT * FROM ' quote_ident(tabname) 


| | 
|| ”WHERE coli = $1' USING keyvalue; 


2 


在 这 个 例子 中 ， 表 名 被 插入 到 文本 查询 中 ， 因此 使 用 quote_ident() 时 要 注意 SQL 注入 。 
过 usine 参数 对 插入 的 cola 进行 比较 值 ， 因 此 不 需要 使 用 引号 。 


40.7.2.3. 打开 一 个 绑 定 的 游标 


OPEN _bound_cursorvar_ [ ( [ ~_argument_name_~ := ] ~_argument_value_~ [, ...] ) ]; 


这 种 形式 的 open 用 于 打开 一 个 游标 变量 ， 该 游标 变量 的 命令 是 在 声明 的 时 候 和 它 绑 定 在 一 
起 的 。 游 标 不 能 是 已 经 打开 的 。 当 且 仅 当 该 游标 声明 为 接受 参数 的 时 候 ， 语 句 中 才 必 需 出 现 
一 个 实际 参数 值 表达 式 的 列表 。 这 些 值 将 代 换 到 命令 中 。 


一 个 绑 定 的 游标 的 命令 计划 总 是 认为 可 缓冲 的 ， 这 种 情况 下 没有 等 效 的 ExEcuTE 。 需要 注意 
的 是 scRoLL 和 no scROLL 不 能 在 open 中 被 声明 ， 因为 游标 的 滚动 动作 已 经 被 定义 了 。 


参数 值 可 以 使 用 positiona/ 或 者 named 符 号 传递 。 在 位 置 符号 中 ， 所 有 的 参数 以 顺序 指定 。 在 
命名 法 中 ， 每 个 参数 的 名 称 使 用 := 声明 以 从 参数 表达 式 中 分 开 。 类 似 于 调用 函数 ， 
在 Section 4.3 中 描述 ， 它 也 人 允许 混合 位 置 和 命名 法 。 


例子 (以 上 使 用 游标 声明 的 例子 ): 


OPEN curs2; 
OPEN curs3(42); 
OPEN curs3(key := 42); 


因为 在 绑 定 游标 查询 上 做 了 变量 替换 ， 有 两 种 方法 将 值 传递 到 游标 : 要 么 使 用 明确 参数 
到 open ， 或 者 隐 式 地 在 查询 中 引用 PL/pgSQL 变 量 。 然而 ， 只 有 在 绑 定 游标 之 前 声明 的 变量 
将 取代 它 。 在 这 两 种 情况 下 可 以 在 opEN 时 决定 将 被 传递 的 值 。 例 如 ， 另 一 种 方式 来 获得 相 
同 的 效果 如 curs3 上 面 的 例子 

DECLARE 


key integer; 
curs4 CURSOR FOR SELECT * FROM tenk1 WHERE unique1 = key; 


BEGIN 
key := 42; 
OPEN curs4; 


40.7.3. 使 用 游标 


一 旦 你 已 经 打开 了 一 个 游标 ， 那 么 你 就 可 以 用 这 里 描述 的 语句 操作 它 。 


这 些 操 作 不 需要 发 生 在 和 打开 该 游标 开始 操作 的 同一 个 事 数 里 。 你 可 以 从 函数 里 返回 一 

个 refcursor 值 ， 然 后 让 调用 者 操作 该 游标 。 在 内 部 ， refcursor 值 只 是 一 个 包含 该 游标 命 
使 的 活跃 查询 的 信使 的 字符 串 名 。 这 个 名 字 可 以 传 来 传 去 ， 可 以 赋予 其 它 refcursor 变量 等 
等 ， 也 不 用 担心 扰乱 信使 。 


所 有 信使 在 事务 的 结尾 都 会 隐 含 地 关闭 。 因此 一 个 refcursor 值 只 能 在 该 事务 结束 前 用 于 引 
用 一 个 打开 的 游标 。 


40.7.3.1. FETCH 


FETCH [ ~_direction_~ { FROM | IN } ] _cursor_ INTO _target_; 





FETCH 从 游标 中 检索 下 一 行 到 目标 中 ， 目标 可 以 是 一 个 行 变 量 、 记 录 变 量 、 逗 号 分 隔 的 普通 
变量 列表 ， WR SELECT INTo 一 样 ， 如 果 下 一 行 中 没有 ， 目 标 会 设 为 NULL。 如 
fa] SELECT into, 可 以 使 用 特殊 变量 FouNp 来 检查 是 否 检索 出 一 个 行 。 


_direction. 子 句 可 以 是 任何 一 个 SQL FETCH 命 邻 允 许 的 变量 ， 除了 那些 可 以 抓 取 不 止 一 
行 的 ; 形 如 : NEXT, PRIOR, FIRST, LAST, ABSOLUTE _count_, RELATIVE 

_count_ , FORWARD 或 者 BACKWARD 。 忽略 _direction_ 作为 声明 的 next 是 相同 的 。 
_direction. 值 需要 往 后 移动 可 能 会 失败 ， 除 非 声明 的 或 者 打开 的 游标 带 有 scRoLL 选项 。 


_cursor ”必须 是 一 个 指向 一 个 打开 的 游标 的 refcursor 变量 的 名 字 。 
一 个 例子 : 


FETCH curs1 INTO rowvar; 

FETCH curs2 INTO foo, bar, baz; 
FETCH LAST FROM curs3 INTO x, y; 
FETCH RELATIVE -2 FROM curs4 INTO x; 


40.7.3.2. MOVE 


MOVE [ ~_direction_~ { FROM | IN } ] _cursor_; 


MOVE 重新 定位 一 个 游标 ， 而 不 需要 检索 任何 数据 。 move 的 工作 方式 与 FETcH 及 其 相似 ， 
除了 它 只 是 重新 定位 游标 并 且 不 返回 至 移动 到 的 行 。 在 进行 SELECT into 命令 时 ， 声明 
的 FouNp 变量 可 以 用 来 检查 下 一 个 需要 移动 到 的 行 是 否 存在 。 


_direction 可 以 是 任何 一 个 SQL FETCH 命令 允许 的 变量 ， 如 下 next, PRIOR, FIRST, 
LAST, ABSOLUTE _count_, RELATIVE _count_, ALL, FORWARD [ _count_ | ALL ] 或 
者 BACKWARD [ _count_ | ALL ]。 忽略 _direction_ 作为 声明 的 next 是 相同 的 。 

_direction. 值 需 要 往 后 移动 可 能 会 失败 ， 除 非 声 明 的 或 者 打开 的 游标 带 有 scRoLL 选项 。 


例如 : 


MOVE curs1; 

MOVE LAST FROM curs3; 

MOVE RELATIVE -2 FROM curs4; 
MOVE FORWARD 2 FROM curs4; 


40.7.3.3. UPDATE/DELETE WHERE CURRENT OF 


UPDATE _table_ SET ... WHERE CURRENT OF _cursor_; 
DELETE FROM _table_ WHERE CURRENT OF _cursor_; 


当 一 个 游标 被 定位 到 一 个 表 的 行 上 ， 那 么 通过 使 用 该 游标 来 识别 该 行 ， 从 而 进行 更 新 或 删除 
操作 。 当 然 ， 对 于 如 何 定义 游标 查询 (特别 是 没有 分 组 时 ) 是 存在 一 定 限 制 的 ; 在 游标 中 使 
用 FoR UPDATE 是 个 不 错 的 主意 。 更 多 信息 可 参阅 DECLARE。 


例如 : 


UPDATE foo SET dataval = myval WHERE CURRENT OF cursi1; 


40.7.3.4. CLOSE 


CLOSE _cursor_; 


close 关闭 支撑 在 一 个 打开 的 游标 下 面 的 信使 。 这 样 就 可 以 在 事务 结束 之 前 释放 资源 ， 或 者 
释放 掉 该 游标 变量 ， 用 于 稍 后 再 次 打开 。 


例如 : 


CLOSE curs1; 


40.7.3.5. 返回 游标 


PL/pgSQL 画 数 可 以 向 调用 者 返回 游标 这 个 功能 用 于 从 画 数 里 返回 多 行 或 多 列 ， 特别 是 巨大 的 
结果 集 。 要 想 这 么 做 ， 该 琅 数 必须 打开 游标 并 且 把 该 游标 的 名 字 返 回 给 调用 者 ， 或 者 简单 的 
使 用 指定 的 入 口 名 或 调用 者 已 知 的 名 字 打 开 游 标 。 调用 者 然后 从 游标 里 抓 取 行 。 游 标 可 以 由 
调用 者 关闭 ， 或 者 是 在 事务 结束 的 时 候 自动 关闭 。 


函数 返回 的 游标 名 可 以 由 调用 者 声明 或 者 自动 生成 。 要 声明 一 个 信使 的 名 字 ， 只 要 在 打开 游 
标 之 前 ， 给 refcursor 变量 赋予 一 个 字符 串 就 可 以 了 。 refcursor 变量 的 字符 串 值 将 

被 open 当 作 下 层 的 信使 的 名 字 使 用 。 不 过 ， 如 果 refcursor 变量 是 空 ， 那么 open 将 自动 生 
成 一 个 和 现 有 信使 不 冲突 的 名 字 ， 然后 将 它 赋予 refcursor 变量 。 


Note: 一 个 绑 定 的 游标 变量 其 名 字 初 始 化 为 对 应 的 字符 串 值 ， 因此 信使 的 名 字 和 游标 变 
量 名 同名 ， 除 非 程 序 员 在 打开 游标 之 前 通过 赋值 覆盖 了 这 个 名 字 。 但 是 一 个 未 绑 定 的 游 
标 变量 初始 化 的 时 候 缺 省 是 空 ， 因此 它 会 收 到 一 个 自动 生成 的 唯一 名 字 ， 除 非 被 覆盖 。 











下 面 的 例子 显示 了 一 个 调用 者 声明 游标 名 字 的 方法 : 


CREATE TABLE test (col text); 
INSERT INTO test VALUES ('123'); 


CREATE FUNCTION reffunc(refcursor) RETURNS refcursor AS ' 


BEGIN 
OPEN $1 FOR SELECT col FROM test; 
RETURN $1; 

END; 


' LANGUAGE plpgsql; 


BEGIN; 

SELECT reffunc('funccursor'); 
FETCH ALL IN funccursor; 
COMMIT; 


下 面 的 例子 使 用 了 自动 生成 的 游标 名 : 


CREATE FUNCTION reffunc2() RETURNS refcursor AS ' 
DECLARE 
ref refcursor; 
BEGIN 
OPEN ref FOR SELECT col FROM test; 
RETURN ref; 
END; 
' LANGUAGE plpgsql; 
-- 需要 在 一 个 事务 中 使 用 游标 。 
BEGIN; 
SELECT reffunc2(); 


reffunc2 
<unnamed cursor 1> 
(1 row) 


FETCH ALL IN "<unnamed cursor 1>"; 
COMMIT; 


下 面 的 例子 显示 了 从 一 个 图 数 里 返回 多 个 游标 的 方法 : 


CREATE FUNCTION myfunc(refcursor, refcursor) RETURNS SETOF refcursor AS $$ 
BEGIN 
OPEN $1 FOR SELECT * FROM table_1; 
RETURN NEXT $1; 
OPEN $2 FOR SELECT * FROM table 2; 
RETURN NEXT $2; 
END; 
$$ LANGUAGE plpgsql; 
-- 需要 在 事务 里 使 用 游标 。 
BEGIN; 


SELECT * FROM myfunc('a', 'b'); 
FETCH ALL FROM a; 


FETCH ALL FROM b; 
COMMIT; 


40.7.4. 通过 游标 结果 进行 循环 


有 这 人 么 一 个 FoR 语法 的 变形 ， 它 允许 通过 游标 返回 的 行进 行 迭 代 。 如 下 : 


[ <<*_label_*>> ] 





FOR _recordvar_ IN _bound_cursorvar_ [ ( [ ~_argument_name_~ := ] ~_argument_value_~ [, . 
_statements_ 

END LOOP [ ~_label_~ ]; 

‘| = =] 





在 声明 游标 变量 时 ， 它 必须 已 经 绑 定 到 一 些 查询 语句 上 ， 并 且 不 能 是 打开 状态 。 FOR 语法 会 
自动 打开 游标 ， 并 且 当 退出 循环 时 自动 关闭 游标 。 只 有 当 游 标 被 声明 要 使 用 参数 时 ， 必须 有 
一 列 实际 参数 值 表达 式 。 这 些 值 会 被 替换 到 查询 中 ， 采 用 如 同 open 的 方式 (Bh Section 
40.7.2.3)。 

_recordvar ”变量 会 自动 定义 为 record 类 型 ， 并 且 只 存在 于 循环 中 (循环 中 任何 的 定义 变量 
名 的 动作 都 会 被 忽略 ) 。 每 一 个 由 游标 返回 的 行 都 会 陆续 的 被 分 配 到 记录 变量 中 ， 然 后 执行 
循环 体 。 


AO. 8. 错误 和 消 a 


利用 RAISE 语句 报告 信息 以 及 抛 出 错误 。 














RAISE [ ~_level_~ ] '_format_' [, ~_expression_~ [, ... ]] [ USING ~_option_~ = ~_express 
RAISE [ ~_level_~ ] _condition_name_ [ USING ~_option_~ = ~_expression_~ [, ... ] ]; 
RAISE [ ~_level_~ ] SQLSTATE '_sqlstate_' [ USING ~_option_~ = ~_expression_~ [, ... ] ]; 
RAISE [ ~_level_~ ] USING _option_ = _expression_ [, ... ]; 
RAISE ; 

‘| rl | 








_level_ 选项 声明 了 错误 的 严重 性 等 级 。 可 能 的 级 别 有 DEBUG , LOG, INFO, NOTICE , 
WARNING ， 和 EXCEPTION ， 默 认 的 是 EXCEPTION. EXCEPTION 会 抛 出 一 个 错误 (强制 关闭 当前 
仅仅 是 产生 不 同 的 优先 级 信息 。 无 论 是 将 优先 级 别 的 信息 是 报告 给 客户 
端 ， 还 是 写 到 服务 器 日 志 ， 亦 或 是 二 者 都 是 ， 都 是 由 log_min_messages 和 
client_min_messages 配 置 变量 控制 的 。 参阅 Chapter 18 获 取 更 多 细节 。 


如 果真 有 的 话 ， 在 level ZA, 你 可 以 写 _format_ ， (这 必须 是 一 个 简单 的 字符 串 文 

本 ， 而 不 是 表达 式 ) 。 格式 字符 串 声明 要 报告 的 错误 信息 文本 。 格式 字符 串 可 以 遵循 插入 到 
信息 中 的 可 选 参数 表达 式 。 在 格式 字符 串 里 ， % 被 下 一 个 可 选 参数 的 外 部 表现 形式 代替 。 要 
表示 % 字符 必须 发 出 ( x% )。 


在 这 个 例子 里 ， v_job_id 的 值 将 代替 字符 串 中 的 % : 


RAISE NOTICE 'Calling cs_create_job(%)', v_job_id; 


你 可 以 通过 在 _option_ = _expression_ 项 后 边 写 USING 来 附加 额外 信息 到 错误 报告 中 。 每 
一 个 _expression. 可 以 是 任何 字符 串 值 表达 式 。 人 允许 的 option. 关键 字 是 : 


MESSAGE 


设置 错误 消息 文本 。 这 个 选项 不 能 用 于 包含 usine 之 前 的 格式 字符 串 的 Rre 形式 中 。 


DETAIL 


提供 一 个 错误 详细 信息 。 


HINT 
提供 提示 信息 。 
ERRCODE 


指定 错误 代码 (SQLSTATE) 用 来 报告 ， 通 过 条 件 名 ， 如 Appendix A， 或 直接 作为 五 个 字符 
的 SQLSTATE 代 码 。 


COLUMN “CONSTRAINT DATATYPE TABLE SCHEMA 


提供 一 个 相关 对 象 名 称 。 
该 例子 会 强制 退出 事务 ， 并 返回 如 下 提示 : 


RAISE EXCEPTION 'Nonexistent ID --> %', user_id 
USING HINT = 'Please check your user ID'; 


下 面 两 个 例子 在 设置 SQLSTATE 方 面具 有 相同 的 作用 : 


'unique_violation'; 
'23505'; 


RAISE 'Duplicate user ID: %', user_id USING ERRCODE 
RAISE 'Duplicate user ID: %', user_id USING ERRCODE 


这 是 第 二 个 RAISE 语法 ， 其 中 主要 参数 是 条 件 名 字 或 者 要 报告 的 SQLSTATE， 比 如 : 


RAISE division_by_zero; 
RAISE SQLSTATE '22012'; 


在 这 个 语法 中 ， using 可 以 来 提供 一 个 通用 的 错误 信息 ， 详 情 ， 或 者 提示 。 另 一 个 较 早 的 例 
子 是 : 


RAISE unique_violation USING MESSAGE = 'Duplicate user ID: ' || user_id; 


另 一 个 变形 是 写 RAISE USING 或 者 RAISE’*_level_ USING, 然后 将 其 他 的 所 有 东西 都 放 
在 ustne FIFA, 


最 后 一 个 RAISE 变形 中 没有 任何 参数 。 这 种 形式 只 能 在 BEGIN 块 的 exception 字句 中 使 用 。 
它 的 作用 是 将 正在 义理 的 错误 放 到 下 一 个 封闭 的 块 中 。 


Note: 在 PostgreSQL 9.1 之 前 ， 没有 参数 的 RAISE 被 解释 为 包含 有 活跃 异常 处 理 程序 的 
块 中 重新 抛 出 错误 。 因此 ， exception 子 句 同 套 在 该 处 理 器 中 无 法 抓 取 它 ， 即 使 

RAISE TERREI ExcEPTION 子 句 块 中 。 这 被 认为 是 合 人 惊讶 并 且 不 兼容 Oracle 的 
PL/SQL. 


如 果 RAISE EXCEPTION 中 没有 声明 SQLSTATE 的 情形 名 称 ， 那么 缺 省 使 用 RAISE_EXCEPTION 
( P9601 )。 如 果 没 有 声明 信息 文本 ， 那 么 缺 省 将 情形 名 称 或 SQLSTATE 作 为 信息 文本 。 


Note: 当 通 过 SQLSTATE 编 码 声 明 一 个 错误 代码 时 ， 你 不 能 限制 预定 义 错 误 代 码 ， 但 是 
可 以 选择 任何 由 五 个 数字 和 /或 者 大 宇 ASCII 字 母 组 成 的 错误 代码 ， 而 不 是 c0000, LW 
避免 抛 出 以 三 个 需 结 尾 的 错误 代码 ， 因 为 这 些 是 类 别 码 并 且 只 能 通过 捕获 整个 类 别 来 获 
取 。 


40.9. 触发 器 过 程 
40.9.1. 对 数据 变化 的 触发 


PL/pgSQL 可 以 用 于 定义 触发 器 过 程 。 一 个 触发 器 过 程 是 用 CREATE FUNCTION 命令 创建 的 ， 创 
建 的 形式 是 一 个 不 接受 参数 并 且 返 回 trigger 类 型 的 函数 。 请 注意 该 酚 数 即使 

在 CREATE TRIGGER 声明 里 声明 为 准备 接受 参数 ， 它 也 必需 声明 为 无 参数 ， 因 为 触发 器 的 参数 
是 通过 Tc_ARGv 传递 的 (下 面 有 描述 )。 


在 一 个 PL/pgSQL 画 数 当 做 触发 器 调用 的 时 候 ， 系统 会 在 顶层 的 声明 段 里 自动 创建 几 个 特殊 变 
量 。 有 如 下 这 些 : 

NEW 

数据 类 型 是 RECORD ; 该 变量 为 行 级 触发 器 中 的 insert / UPDATE 操作 存储 新 数据 行 。 在 语句 
级 别 的 触发 器 里 这 个 变量 以 及 DELETE 操作 未 赋值 。 

OLD 

数据 类 型 是 RECORD ; 该 变量 为 行 级 触发 器 中 的 UPDATE / DELETE 操作 存储 旧 数 据 行 。 在 语句 
级 别 的 触发 器 里 以 及 对 INSERT 动作 ， 这 个 变量 未 赋值 。 

TG_NAME 

数据 类 型 是 name ; 该 变量 包含 实际 触发 的 触发 器 名 。 

TG_WHEN 

数据 类 型 是 text ; 是 一 个 由 触发 器 定义 决定 的 字符 串 ( BEFORE, AFTER 或 者 INSTEAD OF )o 
TG_LEVEL 

数据 类 型 是 text ; 是 一 个 由 触发 器 定义 决定 的 字符 串 ( Row 或 者 STATEMENT )。 

TG_OP 

数据 类 型 是 text ; 是 一 个 说 明 激 活 触发 器 的 操作 的 字符 串 ( INSERT, UPDATE ， DELETE 或 
者 TRUNCATE )。 

TG_RELID 

数据 类 型 是 oid ; 是 激活 触发 器 调用 的 表 的 对 象 标识 (OID)。 

TG_RELNAME 

数据 类 型 是 name ; 是 激活 触发 器 调用 的 表 的 名 称 。 反对 使 用 ， 并 会 在 将 来 的 版 本 中 消失 ， 
推荐 使 用 TG_TABLE_NAME o 


TG_TABLE_NAME 


数据 类 型 是 name ; 是 激活 触发 器 调用 的 表 的 名 称 。 


TG_TABLE_SCHEMA 


数据 类 型 是 name ; 是 激活 触发 器 调用 的 表 的 模式 名 。 


TG_NARGS 


数据 类 型 是 integer ; 是 在 CREATE TRIGGER 语句 里 面 赋予 触发 器 过 程 的 参数 的 个 数 。 


TG_ARGV[] 


数据 类 型 是 text 的 数组 ; 是 CREATE TRIGGER 语句 里 的 参数 。 下 标 从 0 开始 记 数 。 非法 下 标 
(小 于 0 或 者 大 于 等 于 tg_nargs ) 导 致 返回 一 个 NULL 值 。 


一 个 触发 器 函数 必须 返回 NuLL 或 者 是 一 个 与 激活 触发 器 运行 的 表 的 记录 / 行 结构 完全 相同 的 
数据 。 


BEFORE 触发 的 行 级 别 触 发 器 可 以 返回 一 个 NULL， 告诉 触发 器 管理 器 忽略 对 该 行 剩 下 的 操 
作 ， 也 就 是 说 ， 随 后 的 触发 器 将 不 再 执行 ， 并 且 不 会 对 该 行 产 生 INSERT / UPDATE / DELETE 动 
VF). 如 果 返 回 了 一 个 非 NULL 的 行 ， 那 么 将 继续 对 该 行 数值 进行 处 理 。 请 注意 ， 返 回 一 个 和 
原来 的 NEw 不 同 的 行 数值 将 修改 那个 将 插入 或 更 新 的 行 因此 ， 如 果 想 在 没有 修改 行 值 的 同时 
成 功 的 执行 触发 器 动作 ， 那 么 需要 返回 NEw (或 等 价 的 ) 。 为 了 修改 行 存储 ， 可 以 用 一 个 值 
直接 代替 NEw 里 的 某 个 数值 并 且 返 回 之 ， 或 者 也 可 以 构建 一 个 全 新 的 记录 / 行 再 返回 。 

在 DELETE 上 的 before 触 发 器 的 情况 下 ， 返回 值 没有 直接 的 影响 ， 但 是 它 不 得 不 是 非 null 以 允 
许 触 发 器 操作 继续 执行 。 请 注意 DELETE 触发 器 中 new 是 null， 因 此 返回 往往 是 不 明智 

BY, DELETE 触发 器 通常 情况 返回 oLD o 


INSTEAD OF 触发 器 (总 是 行 级 触发 器 ， 并 且 只 能 用 于 视图 ) 可 以 返回 null 标 记 他 们 不 执行 任 
何 更 新 ， 并 且 应 该 忽略 这 些 行 操作 的 剩余 部 分 (上 比如， 随后 的 触发 器 不 会 被 触发 ， 并 且 为 了 
周围 的 INSERT / UPDATE / DELETE 在 受 影响 的 行 状态 下 不 计算 行 ) 。 另外 应 该 返回 一 个 空 值 ， 
用 来 标记 触发 器 执行 所 需要 的 操作 。 为 了 INSERT 和 UPDATE 操作 ， 返 回 值 应 是 New, 这 个 
触发 器 函数 可 以 修改 以 支持 INSERT RETURNING 和 UPDATE RETURNING (这 也 将 影响 传递 到 任何 
随后 触发 器 的 行 值 ) 。 为 了 DELETE 操作 ， 返 回 值 应 是 oLp o 


一 个 AFTER 行 级 别 的 触发 器 或 者 BEFORE 或 者 AFTER 语句 级 别 的 触发 器 返回 值 将 总 是 被 忽 
A; 它们 也 可 以 返回 NULL 来 忽略 返回 值 。 不 过 ， 任何 这 种 类 型 的 触发 器 仍然 可 以 通过 抛 出 
一 个 错误 来 退出 整个 触发 器 操作 。 


Example 40-3 显 示 了 一 个 PL/pgSQL 写 的 触发 器 过 程 的 例子 。 
Example 40-3. PL/pgSQL 人 触发 器 过 程 


下 面 的 示例 触发 器 的 作用 是 : 任何 时 候 表 中 插入 或 更 新 了 行 ， 当 前 的 用 户 名 和 时 间 都 记录 入 
行 中 。 并 且 它 保证 给 出 了 懂 员 名 称 并 且 薪水 是 一 个 正 数 。 


CREATE TABLE emp ( 
empname text, 
salary integer, 
last_date timestamp, 
last_user text 


Ne 


CREATE FUNCTION emp_stamp() RETURNS trigger AS $emp_stamp$ 
BEGIN 


-- 检查 是 否 给 出 了 empname 和 Salary 
IF NEW.empname IS NULL THEN 
RAISE EXCEPTION 'empname cannot be null'; 
END IF; 
IF NEW.salary IS NULL THEN 
RAISE EXCEPTION '% cannot have null salary', NEW.empname; 
END IF; 


-- 必须 付 账 给 谁 ? 
IF NEW.salary < © THEN 
RAISE EXCEPTION '% cannot have a negative salary', NEW.empname; 
END IF; 


-- 记 住 何 时 何人 的 薪水 被 修改 了 


NEW. last_date : 
NEW. last_user : 
RETURN NEW; 
END; 
$emp_stamp$ LANGUAGE plpgsql; 


current_timestamp; 
current_user; 


CREATE TRIGGER emp_stamp BEFORE INSERT OR UPDATE ON emp 
FOR EACH ROW EXECUTE PROCEDURE emp_stamp(); 


另外 一 个 向 表 里 记 录 变 化 的 方法 涉及 创建 一 个 新 表 ， 然后 为 后 来 发 生 的 每 次 插入 、 更 新 或 者 
删除 动作 保存 一 行 。 这 个 方法 可 以 当 作 对 一 个 表 的 审计 。 Example 40-4 显 示 了 一 个 
PL/pgSQL 写 的 审计 触发 器 过 程 的 例子 。 


Example 40-4. PL/pgSQL 审 计 触 发 器 过 程 


这 个 例子 触发 器 保证 了 在 emp 表 上 的 任何 插入 、 更 新 、 删除 动作 都 被 记录 到 了 emp_audit 表 
里 (也 就 是 审计 )。 当前 时 间 和 用 户 名 会 被 记录 到 数据 行 里 ， 以 及 还 有 执行 的 操作 。 


CREATE TABLE emp ( 
empname text NOT NULL, 
salary integer 


Ne 


CREATE TABLE emp_audit( 


operation char (1) NOT NULL, 
stamp timestamp NOT NULL, 
userid text NOT NULL, 
empname text NOT NULL, 


salary integer 


Ne 


CREATE OR REPLACE FUNCTION process_emp_audit() RETURNS TRIGGER AS $emp_audit$ 
BEGIN 


-- 在 emp_audit 里 创建 一 行 ， 反 映 对 emp 的 操作 ， 

-- 使 用 特殊 变量 TG_OP 获 取 操 作 类 型 。 

IF (TG_OP = 'DELETE') THEN 
INSERT INTO emp_audit SELECT 'D', now(), user, OLD.*; 
RETURN OLD; 

ELSIF (TG_OP = 'UPDATE') THEN 
INSERT INTO emp_audit SELECT 'U', now(), user, NEW.*; 
RETURN NEW; 

ELSIF (TG_OP = 'INSERT') THEN 
INSERT INTO emp_audit SELECT 'I', now(), user, NEW.*; 
RETURN NEW; 

END IF; 

RETURN NULL; -- result is ignored since this is an AFTER trigger 

END; 
$emp_audit$ LANGUAGE plpgsql; 


CREATE TRIGGER emp_audit 
AFTER INSERT OR UPDATE OR DELETE ON emp 
FOR EACH ROW EXECUTE PROCEDURE process_emp_audit(); 


先前 例子 的 一 个 变化 使 用 连接 主 表 到 审计 表 的 视图 ， 显示 上 次 修改 的 每 个 项 。 这 个 方法 还 记 
录 了 改变 表 的 完整 审计 追踪 ， 但 是 也 提出 了 审计 追踪 的 简单 视图 ， 显 示 来 源 于 每 项 审计 追踪 
的 最 后 修改 的 时 间 戳 。 Example 40-5 显 示 了 PL/pgSQL 中 视图 上 的 审计 触发 器 的 例子 。 


Example 40-5. 审计 PL/pgSQL 视 图 触发 器 程序 


这 个 例子 使 用 视图 上 的 一 个 触发 器 更 新 ， 并 且 确保 任何 插入 ， 更 新 或 删除 视图 中 的 一 行 被 记 
录 (BD, F&M) 在 emp_audit RH, 当前 时 间 和 用 户 名 被 记录 ， 连 同 执行 操作 类 型 ， 而 且 视 
图 显示 每 一 行 的 最 后 修改 时 间 。 


CREATE TABLE emp ( 
empname text PRIMARY KEY, 
salary integer 


Ne 


CREATE TABLE emp_audit( 


operation char (1) NOT NULL, 
userid text NOT NULL, 
empname text NOT NULL, 
salary integer, 

stamp timestamp NOT NULL 


Ne 


CREATE VIEW emp_view AS 
SELECT e.empname, 
e.salary, 
max(ea.stamp) AS last_updated 
FROM emp e 
LEFT JOIN emp_audit ea ON ea.empname = e.empname 
GROUP BY 1, 2; 


CREATE OR REPLACE FUNCTION update_emp_view() RETURNS TRIGGER AS $$ 
BEGIN 


-- 在 emp 上 执行 所 需 操作 ， 并 且 在 emp_audit 中 创建 一 行 以 反映 emp 所 做 的 变化 。 
IF (TG_OP = 'DELETE') THEN 

DELETE FROM emp WHERE empname = OLD.empname; 

IF NOT FOUND THEN RETURN NULL; END IF; 


OLD.last_updated = now(); 
INSERT INTO emp_audit VALUES('D', user, OLD.*); 
RETURN OLD; 
ELSIF (TG_OP = 'UPDATE') THEN 
UPDATE emp SET salary = NEW.salary WHERE empname = OLD.empname; 
IF NOT FOUND THEN RETURN NULL; END IF; 


NEW. last_updated = now(); 
INSERT INTO emp_audit VALUES('U', user, NEW.*); 
RETURN NEW; 
ELSIF (TG_OP = 'INSERT') THEN 
INSERT INTO emp VALUES(NEW.empname, NEW.salary); 


NEW. last_updated = now(); 
INSERT INTO emp_audit VALUES('I', user, NEW.*); 
RETURN NEW; 
END IF; 
END; 
$$ LANGUAGE plpgsql; 


CREATE TRIGGER emp_audit 


INSTEAD OF INSERT OR UPDATE OR DELETE ON emp_view 
FOR EACH ROW EXECUTE PROCEDURE update_emp_view(); 


触发 器 的 一 个 用 途 是 维持 另外 一 个 表 的 概要 。 生成 的 概要 可 以 用 于 在 某 些 查询 中 代替 原始 表 
(通常 可 以 大 大 缩小 运行 时 间 )。 这 个 技巧 经 常用 于 数据 仓库 ， 这 个 时 候 ， 需要 测量 的 表 ( 叫 事 
实 表 ) 可 能 会 非常 巨大 。 Example 40-6 演 示 了 一 个 PL/pgSQL 触 发 器 过 程 的 例子 ， CART 
数据 仓库 的 一 个 事实 表 维 护 一 个 概要 表 。 


Example 40-6. 一 个 维护 概要 表 的 PL/pgSQL 鲁 发 器 过 程 


下 面 的 模式 有 一 部 分 是 基于 数据 仓库 工具 里 面 的 Grocery Store 例 子 。 


-- ER - 时 间 维 以 及 销售 事实 。 


CREATE TABLE time_dimension ( 


time_key 
day_of_week 
day_of_month 
month 
quarter 

year 


Ne 


integer 
integer 
integer 
integer 
integer 
integer 


NOT 
NOT 
NOT 
NOT 
NOT 
NOT 


NULL, 
NULL, 
NULL, 
NULL, 
NULL, 
NULL 


CREATE UNIQUE INDEX time_dimension_key ON time_dimension(time_key); 


CREATE TABLE sales_fact ( 


time_key 
product_key 
store_key 
amount_sold 
units_sold 
amount_cost 


Ne 


CREATE INDEX sales_fact_time ON sales_fact(time_key); 


-- 摘要 表 - 根 据 时 间 的 销售 。 


integer NOT NULL, 
integer NOT NULL, 
integer NOT NULL, 
numeric(12,2) NOT NULL, 
integer NOT NULL, 


numeric(12,2) NOT NULL 


CREATE TABLE sales_summary_bytime ( 
integer NOT NULL, 
numeric(15,2) NOT NULL, 


time_key 
amount_sold 
units_sold 
amount_cost 


Ne 


numeric(12) NOT NULL, 
numeric(15,2) NOT NULL 


CREATE UNIQUE INDEX sales_summary_bytime_key ON sales_summary_bytime(time_key) ; 


-- 7EUPDATE, INSERT, DELETE ad (52 $7 ete = Pee ALA AR & BS 


CREATE OR REPLACE FUNCTION maint_sales_summary_bytime() RETURNS TRIGGER 
AS $maint_sales_summary_bytime$ 


DECLARE 


delta_time_key 


delta_amount_sold 
delta_units_sold 
delta_amount_cost 


BEGIN 
-- 计算 增 / 减 量 
IF (TG_OP = 'DELETE') THEN 
delta_time_key = OLD.time_key; 
delta_amount_sold = -1 * OLD.amount_sold; 
delta_units_sold = -1 * OLD.units_sold; 
delta_amount_cost = -1 * OLD.amount_cost; 


ELSIF (TG_OP 


integer; 
numeric(15,2); 
numeric(12); 
numeric(15,2); 


"UPDATE') THEN 


-- 禁止 改变 time_key 的 更 新 
-- (可 能 并 不 是 很 强制 ， 因 为 DELETE + INSERT 是 大 多 数 可 能 产生 的 修改 )。 


IF ( OLD.time_key != NEW.time_key) THEN 
RAISE EXCEPTION 'Update of time_key 


END IF; 


delta_time_key = OLD.time_key; 
delta_amount_sold = NEW.amount_sold - OLD.amount_sold; 
delta_units_sold = NEW.units_sold - OLD.units_sold; 

delta_amount_cost = NEW.amount_cost - OLD.amount_cost; 


ELSIF (TG_OP 


"INSERT ' ) THEN 


delta_time_key = NEW.time_key; 
delta_amount_sold = NEW.amount_sold; 


: % -> % not allowed', 


OLD.time_key, NEW.time_key; 


delta_units_sold = NEW.units_sold; 
delta_amount_cost = NEW.amount_cost; 


END IF; 
- -用 新 数值 插入 或 更 新 概要 行 。 


<<insert_update>> 
LOOP 
UPDATE sales_summary_bytime 
SET amount_sold = amount_sold + delta_amount_sold, 
units_sold = units_sold + delta_units_sold, 
amount_cost = amount_cost + delta_amount_cost 
WHERE time_key = delta_time_key; 


EXIT insert_update WHEN found; 


BEGIN 
INSERT INTO sales_summary_bytime ( 
time_key, 
amount_sold, 
units_sold, 
amount_cost) 
VALUES ( 
delta_time_key, 
delta_amount_sold, 
delta_units_sold, 
delta_amount_cost 


); 
EXIT insert_update; 


EXCEPTION 
WHEN UNIQUE_VIOLATION THEN 
-- do nothing 
END; 
END LOOP insert_update; 


RETURN NULL; 


END; 
$maint_sales_summary_bytime$ LANGUAGE plpgsql; 


CREATE TRIGGER maint_sales_summary_bytime 
AFTER INSERT OR UPDATE OR DELETE ON sales_fact 
FOR EACH ROW EXECUTE PROCEDURE maint_sales_summary_bytime(); 


INSERT INTO sales_fact VALUES(1,1,1,10,3,15); 
INSERT INTO sales_fact VALUES(1,2,1,20,5,35); 
INSERT INTO sales_fact VALUES(2,2,1,40,15,135); 
INSERT INTO sales_fact VALUES(2,3,1,10,1,13); 
SELECT * FROM sales_summary_bytime; 

DELETE FROM sales_fact WHERE product_key = 1; 
SELECT * FROM sales_summary_bytime; 

UPDATE sales_fact SET units_sold = units_sold * 2; 
SELECT * FROM sales_summary_bytime; 


40.9.2. 事件 触发 器 


PL/pgSQL 用 于 定义 事件 触发 器 。PostgreSQL 要 求 作 为 事件 触发 器 调用 的 程序 必须 声明 为 无 
ARA, 并 且 返 回 event_trigger 类 型 。 


当 PL/pgSQL 画 数 作为 事件 触发 器 调用 时 ， 在 顶层 自动 创建 一 些 特 殊 变 量 ， 他 们 是 : 


TG_EVENT 


数据 类 型 tet ;表示 事件 的 字符 串 触发 触发 器 。 

TG_TAG 

数据 类 型 tet ;包含 命令 标签 的 变量 触发 的 触发 器 。 
Example 40-7 显 示 PL/pgSQL 中 的 事件 触发 器 程序 例子 。 
Example 40-7. PL/pgSQL 事 件 触发 器 程序 


这 个 例子 触发 器 每 次 执行 可 支持 命令 时 简单 触发 norice 消息 。 


CREATE OR REPLACE FUNCTION snitch() RETURNS event_trigger AS $$ 
BEGIN 
RAISE NOTICE ‘snitch: % %', tg_event, tg_tag; 
END; 
$$ LANGUAGE plpgsql; 


CREATE EVENT TRIGGER snitch ON ddl_command_start EXECUTE PROCEDURE snitch(); 


40.10. 在 后 台 下 的 PL/pgSQL 


本 节 讨 论 PL/pgSQL 用 户 知道 的 比较 重要 的 一 些 实现 细节 。 


40.10.1. 变量 替换 


在 PL/pgSQL 画 数 内 的 SQL 语句 和 表达 式 可 以 参考 变量 和 函数 的 参数 。 在 后 台 ，PL/pgSQL 蔡 
代 这 些 参考 查询 参数 。 参数 只 会 按照 句法 允许 一 个 参数 或 列 引用 的 地 方 被 取代 。 作 为 一 个 极 
端的 例子 ， 考虑 不 好 的 编程 风格 的 这 个 例子 : 


INSERT INTO foo (foo) VALUES (foo); 
foo 第 一 次 出 现 一 定 在 语法 上 是 表 名 字 ， 所 以 它 不 会 被 取代 ， 即 使 男 数 有 一 个 可 变 名 foo. 


第 二 次 发 生 必 须 是 表 列 名 称 ， 所 以 它 也 不 会 被 取代 。 只 有 第 三 次 发 生 是 参考 画 数 变量 的 一 个 
候选 。 











Note: 9.0 之 前 的 PostgreSQL 版 本 可 能 党 斌 所 有 三 种 情况 中 替换 变量 ， 导 致 语法 错误 。 


由 于 变量 的 名 字 语 法 上 和 表 列 名 字 没 有 什么 不 同 ， 参 考 表 的 语句 中 有 模糊 : 它 是 一 个 给 定 的 
名 字 意 味 着 引用 一 个 表 列 ， 或 一 个 变量 ? 让 我 们 改变 以 往 的 例子 


INSERT INTO dest (col) SELECT foo + bar FROM src; 


在 这 里 ， dest 和 src 必须 是 表 名 ， 并 且 col 必须 是 dest 的 列 ， 但 是 foo 和 bar DRZH 
数 变量 或 者 src 的 列 。 


默认 情况 下 ， 如 果 在 一 个 SQL 语句 中 的 名 字 可 以 参考 一 个 变量 或 表 列 ， 则 PL/pgSQL 将 报告 错 
误 。 你 可 以 通过 重 命 名 变量 或 列 ， 或 限定 不 明确 的 引用 ， 或 者 告诉 PL/pgSQL 说 明 更 喜欢 哪 
个 来 解决 这 样 的 问题 。 


最 简单 的 解决 方案 是 重 命 名 变量 或 列 。 一 个 常见 的 编码 规则 是 使 用 PL/pgSQL 变 量 的 不 同 命名 
惯例 而 不 是 你 使 用 列 名 称 。 上 比如， 如 果 你 一 贯 地 命名 男 数 变量 v ` something., 然而 你 的 
列 没 有 以 v_ 开头 命名 ， 不 会 发 生 冲 突 。 


另外 你 可 以 限定 含糊 的 引用 以 使 得 它们 明确 。 在 上 面 的 例子 中 ， src.foo 将 是 表 列 的 明确 参 
考 。 为 了 创建 明确 的 引用 变量 ， 在 标记 块 声明 它 并 且 使 用 块 标 签 (参阅 Section 40.2) 。 比 
如 ， 


<<block>> 
DECLARE 
foo int; 
BEGIN 
FOOSE 
INSERT INTO dest (col) SELECT block.foo + bar FROM src; 


这 里 block. foo 意味 着 变量 ， 即使 在 src 中 有 一 列 foo o KARSA, 以 及 特殊 变量 
如 FouND ， 可 以 满足 豆 数 的 名 字 ， 因 为 他 们 在 使 用 函数 名 标记 的 外 部 块 中 隐 式 声明 。 


有 时 修复 在 PL/pgSQL 编 码 主体 下 所 有 不 明确 的 引用 是 不 切实 际 的 。 在 这 种 情况 下 ， 你 可 以 指 
定 PL/pgSQL 应 该 解决 不 明确 的 引用 ， 作 为 变量 〈 即 兼容 PostgreSQL 9.0 之 前 的 PL/pgSQL 的 
行为 ) ， 或 作为 表 列 (与 其 他 一 些 系 统 兼 容 ， 如 Oracle) 


要 改变 在 系统 范围 基础 上 的 这 种 行为 ， 设 置 配置 参数 plpgsql.variable_conflict 为 error , 
use_variable 或 者 use_column 之 一 〈( error GW) MBA) 。 此 参数 会 影响 PL/pgSQL 画 
数 中 语句 后 续 的 编译 ， 但 不 是 在 当前 会 话 中 已 编译 的 语句 。 由 于 更 改 此 设置 可 以 导致 
PL/pgSQL 画 数 行为 意 想不到 的 变化 ， 它 只 能 由 超级 用 户 改变 。 


你 也 可 以 在 功能 分 析 的 基础 上 设 定 行为 ， 通 过 在 画 数 文本 的 开始 多 插 和 这些 特殊 的 命令 之 


#variable_conflict error 
#variable_conflict use_variable 
#variable_conflict use_column 


这 些 命令 只 影响 写 人 的 函数 ， 并 且 重 写 plpgsql.variable_conflict 的 设置 。 例如 


CREATE FUNCTION stamp_user(id int, comment text) RETURNS void AS $$ 
#variable_conflict use_variable 
DECLARE 
curtime timestamp := now(); 
BEGIN 
UPDATE users SET last_modified = curtime, comment = comment 
WHERE users.id = id; 
END; 
$$ LANGUAGE plpgsql; 


在 UPDATE 命令 中 ， curtime , comment ,和 id 将 引用 函数 的 变量 和 users 是 否 具 有 这 些 名 称 
列 的 参数 。 请 注意 我 们 必须 限定 到 whERE FA users.id 的 引用 以 使 得 它 引 用 表 列 。 我 们 没 
有 必要 限定 引用 到 comment 作为 uPDATE 列表 中 的 目标 ， 因为 语法 上 必定 是 users NI, 我 
们 可 以 写 不 依赖 于 这 种 方式 的 variable_conflict 设置 的 同样 本 数 : 


CREATE FUNCTION stamp_user(id int, comment text) RETURNS void AS $$ 
<<fn>> 
DECLARE 
curtime timestamp := now(); 
BEGIN 
UPDATE users SET last_modified = fn.curtime, comment = stamp_user.comment 
WHERE users.id = stamp_user.id; 


$$ LANGUAGE plpgsql; 


变量 代 换 不 会 发 生 在 给 定 ExEcuTE 或 者 它 的 变种 之 一 的 命令 字符 串 中 。 如 果 你 需要 插入 一 个 
不 同 的 值 到 这 个 命令 中 ， 执行 它 作 为 构建 字符 串 值 的 一 部 分 ， 或 使 用 usine, EAN Section 
40.5.4 说 明 的 。 


变量 替换 目前 只 能 在 SELECT , INSERT, UPDATE 和 DELETE 命令 中 运行 ， 因 为 主要 的 SQL 引擎 
允许 这 些 命令 中 的 查询 参数 。 为 了 使 用 其 他 语句 类 型 中 非 恒 定 的 名 称 或 值 (一 般 称 为 实用 语 
句 ) ， 你 必须 构建 实用 语句 作为 字符 串 并 且 execute 它 。 


40.10.2. 计划 缓存 


PL/pgSQL 解 释 器 解析 函数 的 源 文本 并 且 第 一 次 函数 被 调用 时 (每 个 会 话 中 ) 产生 一 个 内 部 二 
HAM. 指令 树 充 分 翻译 PL/pgSQL 语 名 结构， 但 个 别 SQL 表达 式 和 在 函数 中 使 用 的 
SQL 命令 不 是 立即 翻译 。 


在 函数 中 首先 执行 每 个 表达 式 和 SQL 命令 ，PL/pgSQL 解释 器 解析 并 且 分 析 命 令 以 创建 预备 语 
句 ， 使 用 SPI 管 理 的 sPI_prepare HR, 随后 访问 表达 式 或 命令 重新 使 用 事先 准 各 好 的 语 
句 。 因此 ， 带 有 条 件 编码 路 径 的 画 数 很 少 被 访问 将 不 会 产生 分 析 不 在 当前 会 话 中 执行 的 命 命 
的 开销 ， 一 个 缺点 是 在 一 个 特定 的 表达 或 命令 中 的 错误 不 能 被 检测 到 直到 执行 达到 函数 部 分 
( 珊 碎 的 语法 错误 在 初步 解析 传递 期 间 将 被 检测 到 ， 但 是 任何 更 深 的 东西 将 不 会 被 检测 到 直 
到 执行 为 止 。) 


PL/pgSQL (或 者 更 准确 的 说 ，SPI 管 理 者 ) 可 以 尝试 与 任何 特别 已 准备 语句 相关 的 缓存 执行 
计划 。 如 果 没 有 使 用 缓存 计划 ， 那么 在 每 次 访问 语句 中 产生 一 个 新 的 执行 计划 ， 并 且 当前 的 
参数 值 〈( 即 ，PL/pgSQL 变量 值 ) 可 以 用 来 优化 选择 方案 。 如 果 语 句 没 有 参数 ， 或 是 执行 多 
次 ，SPI 管 理 者 将 考虑 创建 genemc 计 划 不 依赖 于 特定 的 参数 值 ， 并 且 缓 存 再 利用 。 只 有 执行 
计划 对 PL/pgSQL 变 量 中 引用 的 值 不 太 人 敏感 时 ， 人 往往 会 发 生 。 如 果 是 ， 每 次 生成 一 个 计划 都 是 
净 赢 。 参阅 PREPARE 获 得 更 多 有 关 预 各 语句 行为 信息 。 


因为 PL/pgSQL 保 存 已 预备 好 语句 并 且 有 时 以 这 种 方式 执行 计划 ， 直接 出 现在 PL/pgSQL 酚 数 
中 的 SQL 命令 必须 查阅 相同 表 和 每 个 执行 列 ; 也 就 是 说 ， 你 不 能 使 用 参数 作为 SQL 命令 的 表 
或 列 的 名 字 。 为 了 应 对 这 个 限制 ， 你 可 以 使 用 PL/pgSQL execute 语句 构建 动态 命令 ; 以 执 
行 新 的 解析 分 析 和 每 个 执行 上 构建 新 的 执行 计划 为 代价 。 


记录 变量 的 可 变性 质 提出 连接 中 的 另 一 个 问题 。 当 在 表达 式 或 语句 中 使 用 记录 变量 字段 时 ， 
该 字段 数据 类 型 必须 不 能 从 函数 的 一 个 调用 到 下 一 个 改变 ， 因为 当 表 达 式 第 一 个 到 达 时 使 用 
目前 数据 类 型 分 析 每 个 表达 式 。 EXECUTE 必要 时 可 以 用 于 解决 这 个 问题 。 


如 果 相同 函数 作为 多 个 表 的 触发 器 使 用 ， PL/pgSQL 为 了 每 个 胡 独 立地 准 各 并 且 缓 存 声明 ; 
即 ， 有 一 个 触发 器 郴 数 和 表 组 合 的 高 速 缓 存 ， 而 不 只 是 为 每 个 本 数 。 这 解决 了 一 些 数据 关 型 
不 同 的 问题 ; 例如 ， 一 个 触发 器 画 数 可 以 使 用 命名 key 的 列 成 功 运行 ， 即 使 发 生 不 同 的 表 中 
有 不 同 的 类 型 。 


同样 ， 具 有 多 态 性 参数 类 型 的 函数 有 一 个 他 们 被 调用 的 实际 参数 类 型 的 每 个 组 合 的 单独 声明 
缓存 ， 所 以 该 数据 类 型 差异 不 会 导致 意外 失败 。 


语句 缓存 有 时 会 对 时 间 人 敏感 值 的 解释 有 今 人 惊讶 的 影响 。 例如 在 这 两 个 函数 要 做 的 内 容 之 间 
有 区 别 : 


CREATE FUNCTION logfunci(logtxt text) RETURNS void AS $$ 
BEGIN 
INSERT INTO logtable VALUES (logtxt, 'now'); 


$$ LANGUAGE plpgsql; 


和 


CREATE FUNCTION logfunc2(logtxt text) RETURNS void AS $$ 
DECLARE 
curtime timestamp; 
BEGIN 
curtime := 'now'; 
INSERT INTO logtable VALUES (logtxt, curtime); 
END; 
$$ LANGUAGE plpgsql; 


在 logfunc1 的 情况 下 ， 该 PostgreSQL 主 解析 器 知道 当 分 析 INSERT 时 字符 种 'now' 应 解释 
为 wae, 因为 logtable 目标 列 是 那 种 类 型 。 因此 ， 当 分 析 insert if, 'now' 将 被 转换 
为 timestamp BE, 然后 在 会 话 的 整个 生命 周期 中 用 于 logtunca 的 所 有 调用 。 不 用 说 ， 这 
不 是 程序 员 希 望 的 。 一 个 更 好 的 办 法 是 使 用 now() 或 者 current_timestamp RX. 


在 logfunc2 的 情况 下 ， PostgreSQL 主 解析 器 并 不 知道 'now' 应 该 成 为 什么 类 型 ， 因 此 它 返 
回 包含 字符 串 nw 类 型 text 的 数据 值 。 随后 分 配给 局 部 变量 curtime 期 间 ， PL/pgSQL 解 
析 器 通过 调用 text_out 和 timestamp_in 转换 画 数 特 这 个 字符 串 转 换 为 timestamp 类 型 ， 
此 ， 作 为 编程 期 望 每 次 执行 时 更 新 计算 时 间 戳 。 尽管 这 正如 预期 的 那样 发 生 ， 这 不 是 非常 有 
效 的 ， 所 以 now) 函数 的 使 用 仍然 会 是 一 个 更 好 的 主意 。 


40.11. 开发 PL/pgSQL 的 一 些 提 示 


用 PL/pgSQL 做 开发 的 一 个 好 方法 是 简单 地 使 用 文本 编辑 器 创建 画 数 ， 然后 在 另外 一 个 控制 台 
里 ， 用 psql 加 载 这 些 函 数 。 如 果 你 用 这 种 方法 ， 那 么 用 cREATE oR REPLACE FUNCTION SAME 
个 好 主意 。 这 样 ， 重 读 文 件 就 可 以 更 新 琅 数 定义 。 上 比如 : 


CREATE OR REPLACE FUNCTION testfunc(integer) RETURNS integer AS $$ 


$$ LANGUAGE plpgsql; 


在 运行 psql 的 时 候 ， VAR FAP oMRRa SRM MIE: 


\i filename.sql 


然后 马上 发 出 SQL 命 合 测 试 该 轿 数 。 


另外 一 个 开发 PL/pgSQL 程 序 的 好 方法 是 使 用 一 种 支持 过 程 语 言 开 发 的 GUI 工具 。 比如 
pgAdmin， 当 然 还 有 其 它 的 。 这 些 工具 通常 提供 了 一 些 很 有 用 的 功能 ， 比如 逃逸 单 引号 使 得 
重建 和 调试 函数 更 简单 等 。 


40.11.1. 引号 标记 处 理 


pe 函数 的 代码 都 是 在 cREATE FuNcTION 里 以 一 个 字符 串 文本 的 方式 声明 的 。 如 果 你 用 
边 包 围 单 引 号 的 常规 方式 写字 符 串 文本 ， 那 么 任何 函数 体内 的 单 引 号 都 必须 写 双 份 ; 类 似 
ao eae. 双 份 引号 非常 乏味 ， 在 更 复 末 的 场合 下 ， 代 码 可 能 会 让 人 难以 理 
解 ， 因为 你 很 容易 发 现 自己 需要 半 打 甚至 更 多 相连 的 引号 。 建议 你 用 "dollar-quoted" 的 字符 
串 文 本 来 写 函 数 体 。 (参阅 Section 4.1.2.4)。 使 用 美元 符 界定 的 时 候 ， 你 从 不 需要 对 任何 引号 
写 双 份 ， 只 需要 为 每 层 引 号 包围 财 套 选择 一 个 不 同 的 美元 符号 包围 分 隔 符 即 可 。 上 比如， 你 可 


能 这 么 写 CREATE FUNCTION MT : 


CREATE OR REPLACE FUNCTION testfunc(integer) RETURNS integer AS $PROC$ 


$PROC$ LANGUAGE plpgsql; 
在 这 个 画 数 体 中 ， 可 以 在 SQL 命令 里 使 用 单 引 号 包围 文本 字符 串 ， 用 ss 分 隔 那些 SQL 命令 
的 片断 。 如 果 你 需要 对 包含 ss 的 文本 进行 引号 包围 ， 可 以 使 用 so 等 等 。 


下 表 展 示 了 不 使 用 美元 符 界 定 的 时 候 该 如 何 写 单 引 号 。 把 美元 符 引 号 之 前 的 引号 包围 的 代码 
转换 成 某 种 可 以 理解 的 形式 时 ， 应 该 会 用 得 上 。 


1 个 单 引 号 


开始 /结束 函数 体 ， 比 如 : 
CREATE FUNCTION foo() RETURNS integer AS ' 
' LANGUAGE plpgsq1; 
在 函数 体内 部 的 任何 位 置 ， 问 号 都 必须 成 对 出 现 。 
2 个 单 引 号 
对 于 函数 体内 的 字符 串 文本 ， 比 如 : 


a_output := ''Blah''; 
SELECT * FROM users WHERE f_name=''foobar''; 


在 美元 符 界 定 的 方法 里 ， 你 只 要 写 : 


a_output := 'Blah'; 
SELECT * FROM users WHERE f_name='foobar'; 


两 种 情况 都 是 PL/pgSQL 分 析 器 期 望 看 到 的 东西 。 
4 个 单 引 号 
如 果 你 在 函数 体 中 的 字符 串 里 面 需要 一 个 单 引 号 ， 比 如 : 
a_output := a_output || '' AND name LIKE ''''foobar'''' AND xyz'' 
a_output 的 值 将 是 AND name LIKE 'foobar' AND xyz o 
使 用 美元 符 界定 的 方法 应 该 这 样 写 : 
a_output := a_output || $$ AND name LIKE 'foobar' AND xyz$$ 
注意 ， 这 样 的 美元 符 界 定 的 分 隔 符 并 不 是 只 有 $$ 。 
6 个 单 引 号 
如 果 一 个 在 函数 体 中 的 字符 串 内 的 单 引 号 与 该 字符 串 常 量 结尾 前 后 相连 ， 比 如 : 


a_output := a_output || '' AND name LIKE ''''foobar'!'''' 


a_output 的 值 将 是 AND name LIKE 'foobar' o 


用 美元 符 界定 的 方法 则 为 是 : 


a_output := a_output || $$ AND name LIKE 'foobar'$$ 


10 个 单 引 号 


如 果 你 想 要 在 字符 串 常 量 里 有 两 个 单 引 号 (它们 在 一 起 是 8 个 了 ) ， 并 且 这 两 个 单 引 号 和 该 字符 
串 常 量 的 结尾 相连 (又 加 2 个 )。 可 能 只 有 在 写 一 个 生成 其 它 范 数 的 男 数 的 时 候 ， Example 
40-9 里 那样 。 上 比如 : 


a_output := a_output || '' if v_'' || 
referrer_keys.kind || '' like Ti 
|| referrer_keys.key_string |] ‘''''''tt'! 
then return '''''' || referrer_keys.referrer_type 


| DART ARs end if;''; 


a output 的 值 将 是 : 


bp Wore dill Yon then return end 是 外 


使 用 美元 符 界定 的 方法 应 该 这 样 写 : 


a_output := a_output || $$ if v_$$ || referrer_keys.kind || $$ like '$$ 
|| referrer_keys.key_string || $$' 
then return '$$ || referrer_keys.referrer_type 
|| $$'; end if; $$; 


假设 我 们 只 需要 在 a_output 里 放 单 引号 ， 因 为 在 使 用 前 它 会 被 重新 引号 包围 。 


40.12. 从 Oracle PL/SQL 进 行 移植 


本 节 解 释 了 PostgreSQL 的 PL/pgSQL 和 Oracle 的 PLUSQL 语 言 之 间 的 差别 ， 希望 能 对 那些 从 
Oracle@ 向 PostgreSQL 移 植 应 用 的 人 有 所 帮助 。 


PL/pgSQL 与 PL/SQL 在 许多 方面 都 非常 类 似 。 它 是 一 种 块 结 构 的 ， 祈 使 语气 (命令 性 ) 的 语言 
并 且 必 须 声 明 所 有 变量 。 赋值 、 循 环 、 条 件 等 都 很 类 似 。 在 从 PL/SQL 向 PL/pgSQL 移 植 的 时 
候 必 须 记 住 一 些 事情 : 


。 如 果 一 个 SQL 命令 中 使 用 的 名 字 是 一 个 表 中 的 列 名 ， 或 者 是 一 个 画 数 中 变量 的 引用 ， 那 
么 PL/SQL 会 将 它 当 作 一 个 变量 名 。 这 对 应 的 是 PL/pgSQL 的 plpgsql.variable_conflict 
= use colum 动作 (不 是 默认 动作 ) ， 参考 Section 40.10.1 中 的 描述 。 首先 ， 最 好 是 
避免 这 种 模糊 的 方式 ， 但 如 果 不 得 不 移植 一 个 依赖 于 该 动作 的 大 量 的 代码 ， 那么 设 


ia variable_conflict 是 个 不 错 的 主意 。 


e 在 PostgreSQL 里 ， 郴 数 体 必须 罕 成 字符 串 文 本 ， 因此 你 需要 使 用 美元 符 界定 或 者 逃逸 函 
数 体 里 面 的 单 引号 ( 见 Section 40.11.1)。 


e。 应 该 用 模式 把 函数 组 织 成 不 同 的 组 ， 而 不 是 用 包 。 


。 因为 没有 包 ， 所 以 也 没有 包 级 别 的 变量 。 这 一 点 有 时 候 挺 讨厌 。 你 可 以 在 临时 表 里 保存 
会 话 级 别 的 状态 。 


e 带 有 reverse 的 整数 的 For 循环 的 工作 模式 是 不 一 样 的 : PL/SQL 中 是 从 第 二 个 数 向 第 
一 个 数 倒 计 ， 而 PL/pgSQL 是 从 第 一 个 数 想 第 二 个 数 倒 计 ， 因此 在 移植 时 ， 需 要 交换 循 
环 边界 。 不 幸 的 是 这 种 不 兼容 性 是 不 太 可 能 改变 的 (参阅 Section 40.6.3.5) 。 


e。 通 万 查询 的 FoR 循环 (而 不 是 循环 游标 ) 同样 有 不 同 的 工作 模式 : 必须 已 经 声明 了 目标 
变量 ， 在 这 一 点 上 PL/SQL 通 常 是 隐 式 的 声明 。 这 样 做 的 优点 是 ， 在 退出 循环 后 ， 仍 然 可 
以 获得 变量 值 。 


。 在 使 用 游标 变量 方面 ， 存 在 一 些 记 数 法 差异 。 


40.12.1. 移植 样 例 


Example 40-8 演 示 了 如 何 从 PL/SQL 向 PL/pgSQL 移 植 一 个 简单 的 函数 。 
Example 40-8. 从 PL/SQL 向 PL/pgSQL 移 植 一 个 简单 的 函数 


下 面 是 一 个 Oracle PL/SQLAR: 


CREATE OR REPLACE FUNCTION cs_fmt_browser_version(v_name varchar, 
v_version varchar ) 

RETURN varchar IS 
BEGIN 

IF v_version IS NULL THEN 

RETURN v_name; 

END IF; 

RETURN v_name || '/' || v_version; 
END; 
/ 
show errors; 


jE Fie — m HAA SPL/pgSQLS ZÉIT A : 


。 在 函数 原型 里 的 return (不 是 函数 体 里 的 ) 关 键 字 到 了 PostgreSQL 里 就 是 RETURNS o 还 
有 ， is 变 成 As ， 并 且 你 还 需要 增加 一 个 LANGUAGE 子 句 ， 因为 PL/pgSQL 并 非 唯一 可 
HAKE (Miss Ao 


。 在 PostgreSQL 里 ， 画 数 体 被 认为 是 一 个 字符 串 文 本 ， 所 以 你 需要 使 用 单 引 号 或 者 美元 符 
REC, 这 个 包围 符 代 替 了 Oracle 最 后 的 那个 / 。 


e 在 PostgreSQL 里 没有 show errors 命令 ， 不 需要 这 个 命令 是 因为 错误 是 自动 报告 的 。 


下 面 是 这 个 函数 移植 到 PostgreSQL 之 后 的 样子 : 


CREATE OR REPLACE FUNCTION cs_fmt_browser_version(v_name varchar, 
v_version varchar) 

RETURNS varchar AS $$ 
BEGIN 

IF v_version IS NULL THEN 

RETURN v_name; 

END IF; 

RETURN v_name || '/' || v_version; 
END; 
$$ LANGUAGE plpgsql; 


Example 40-987 T MBH — Th Ol BATRA, 以 及 演示 了 如 何 处 理 引 
号 逃逸 的 问题 。 
Example 40-9. 从 PL/SQL 向 PL/pgSQL 移 植 一 个 创建 其 它 本 数 的 函数 


下 面 的 过 程 从 一 个 sect 语句 中 抓 取 若干 行 ， 然后 为 了 提高 效率 ， 又 用 IF 语句 中 的 结果 制 
作 了 一 个 巨大 的 函数 。 


这 是 Oracle 版 本 : 


CREATE OR REPLACE PROCEDURE cs_update_referrer_type_proc IS 
CURSOR referrer_keys IS 
SELECT * FROM cs_referrer_keys 
ORDER BY try_order; 
func_cmd VARCHAR( 4000); 
BEGIN 
func_cmd := 'CREATE OR REPLACE FUNCTION cs_find_referrer_type(v_host IN VARCHAR, 
v_domain IN VARCHAR, v_url IN VARCHAR) RETURN VARCHAR IS BEGIN'; 


FOR referrer_key IN referrer_keys LOOP 


func_cmd := func_cmd | | 
' IF v_' || referrer_key.kind 
|| ' LIKE ''' || referrer_key.key_string 
|| ''' THEN RETURN ''' || referrer_key.referrer_type 
lt eA END LE 
END LOOP; 
func_cmd := func_cmd || ' RETURN NULL; END;'; 
EXECUTE IMMEDIATE func_cmd; 
END; 
/ 


show errors; 


下 面 是 这 个 函数 在 PostgreSQL 里 面 的 样子 : 


CREATE OR REPLACE FUNCTION cs_update_referrer_type_proc() RETURNS void AS $func$ 
DECLARE 
referrer_keys CURSOR IS 
SELECT * FROM cs_referrer_keys 
ORDER BY try_order; 
func_body text; 
func_cmd text; 
BEGIN 
func_body := 'BEGIN'; 


FOR referrer_key IN referrer_keys LOOP 
func_body := func_body || 


' IF v_' || referrer_key.kind 
|| ' LIKE ' || quote_literal(referrer_key.key_string) 
|| ' THEN RETURN ' || quote_literal(referrer_key.referrer_type) 
END SEE: 
END LOOP; 
func_body := func_body || ' RETURN NULL; END;'; 
func_cmd := 


"CREATE OR REPLACE FUNCTION cs_find_referrer_type(v_host varchar, 
v_domain varchar, 
v_url varchar) 

RETURNS varchar AS ' 
|| quote_literal(func_body ) 
|| ' LANGUAGE plpgsql;' ; 


EXECUTE func_cmd; 
END; 
$func$ LANGUAGE plpgsql; 


请 注意 函数 体 是 如 何 独立 制作 并 且 传 递 给 quote_literal ， 对 其 中 的 单 引号 复制 双 份 的 。 需 
要 这 个 技巧 是 因为 无 法 使 用 美元 符 界定 定义 新 画 数 : 没 法 保证 referrer_key.key_string 字段 
过 来 的 字符 串 会 解析 成 什么 样子 。 可 以 假设 referrer_key.kind 是 只 有 host ，domain 或 者 


url , (BÆ referrer_key.key_string 可 能 是 任何 东西， 特别 是 它 可 能 包含 美元 符 。 这 个 函数 
实际 上 是 对 原来 Oracle 版 本 的 一 个 改进 ， 因为 如 果 在 referrer_key.key_string 或 者 
referrer_key.referrer_type 包含 单 引号 的 时 候 ， 它 不 会 生成 有 毛病 的 代码 。 


Example 40-10 演 示 了 如 何 移 植 一 个 带 有 our 参数 和 字符 串 处 理 的 函数 。 PostgreSQL 里 面 没 
AAE instr 画 数 ， 但 是 你 可 以 用 其 它 函 数 的 组 合 来 绕 开 它 。 在 Section 40.12.3 里 有 一 个 
PL/pgSQL 的 instr 实现 ， 你 可 以 用 它 让 你 的 移植 变 得 更 简单 些 。 


Example 40-10. 从 PL/SQL 向 PL/pgSQL 移 植 一 个 字符 串 操 作 和 our 参数 的 过 程 
下 面 的 Oracle PL/SQL 过 程 用 于 分 析 一 个 URL 并 且 返 回 若干 个 元 素 ( 主 机 、 路 径 、 命 今 )。 


下 面 是 Oracle 版 本 : 


CREATE OR REPLACE PROCEDURE cs_parse_url( 
v_url IN VARCHAR, 
v_host OUT VARCHAR, -- 这 个 变量 是 要 传 回 的 
v_path OUT VARCHAR, -- 3 是 
v_query OUT VARCHAR) -- 还 有 这 个 

IS 
a_posi1 INTEGER; 
a_pos2 INTEGER; 
BEGIN 
v_host := NULL; 
v_path := NULL; 
v_query := NULL; 
a_posi1 := instr(v_url, '//'); 


IF a_posi = 0 THEN 
RETURN; 
END IF; 
a_pos2 := instr(v_url, '/', a_pos1 + 2); 
IF a_pos2 = 0 THEN 
v_host := substr(v_url, a_posi + 2); 
v_path := '/'; 
RETURN; 
END IF; 


v_host : 
a_posi : 


= substr(v_url, a_posi + 2, a_pos2 - a_posi - 2); 
= instr(v_url, '?', a_pos2 + 1); 
IF a_posi = 0 THEN 
v_path := substr(v_url, a_pos2); 
RETURN; 
END IF; 


v_path := substr(v_url, a_pos2, a_posi1 - a_pos2); 
v_query := substr(v_url, a_posi + 1); 

END; 

/ 

show errors; 


下 面 就 是 把 这 个 过 程 翻译 成 PL/ipgSQL 可 能 的 样子 : 


CREATE OR REPLACE FUNCTION cs_parse_url( 
v_url IN VARCHAR, 


v_host OUT VARCHAR, -- 这 个 将 被 传 回 
v_path OUT VARCHAR, -- 这 个 也 传 回 
v_query OUT VARCHAR) -- 还 有 这 个 

AS $$ 

DECLARE 


a_pos1 INTEGER; 
a_pos2 INTEGER; 


BEGIN 
v_host := NULL; 
v_path := NULL; 
v_query := NULL; 
a_posi := instr(v_url, '//'); 


IF a_posi = 0 THEN 


RETURN; 
END IF; 
a_pos2 := instr(v_url, '/', a_posi + 2); 
IF a_pos2 = 0 THEN 
v_host := substr(v_url, a_posi + 2); 
v_path := '/'; 
RETURN; 
END IF; 
v_host substr(v_url, a_posi + 2, a_pos2 - a posi - 2); 


a_posi1 := instr(v_url, '?', a_pos2 + 1); 


IF a_posi = 0 THEN 
v_path := substr(v_url, a_pos2); 


RETURN; 
END IF; 

v_path := substr(v_url, a_pos2, a_posi1 - a_pos2); 
v_query := substr(v_url, a_posi + 1); 


END; 
$$ LANGUAGE plpgsql; 


这 个 函数 可 以 这 么 用 : 


Z 


SELECT * FROM cs_parse_url('http://foobar.com/query.cgi?baz'); 


Example 40-11 演 示 了 如 何 一 个 使 用 各 种 Oracle 专 有 特性 的 过 程 。 
Example 40-11. 从 PL/SQL 向 PL/pgSQL 移 植 一 个 过 程 


Oracle 版 本 : 





CREATE OR REPLACE PROCEDURE cs_create_job(v_job_id IN INTEGER) IS 
a_running_job_count INTEGER; 
PRAGMA AUTONOMOUS_TRANSACTION;<a name="CO.PLPGSQL-PORTING-PRAGMA">**(1)**</a> 
BEGIN 
LOCK TABLE cs_jobs IN EXCLUSIVE MODE;<a name="CO.PLPGSQL-PORTING-LOCKTABLE">**(2)**</ 


SELECT count(*) INTO a_running_job_count FROM cs_jobs WHERE end_stamp IS NULL; 


IF a_running_job_count > © THEN 
COMMIT; -- free lock<a name="CO.PLPGSQL -PORTING-COMMIT">**(3)**</a> 
raise_application_error(-20000, 
"Unable to create a new job: a job is currently running.'); 
END IF; 


DELETE FROM cs_active_job; 
INSERT INTO cs_active_job(job_id) VALUES (v_job_id); 


BEGIN 
INSERT INTO cs_jobs (job_id, start_stamp) VALUES (v_job_id, sysdate); 
EXCEPTION 
WHEN dup_val_on_index THEN NULL; -- don't worry if it already exists 
END; 
COMMIT; 
END; 
i 


show errors 
Eee OSO 


像 这 样 的 过 程 可 以 很 容易 用 返回 void 的 函数 移植 到 PostgreSQL 里 。 对 这 个 过 程 特别 感 兴趣 
是 因为 它 可 以 教 一 些 东西 : 








(1) 
在 PostgreSQL 里 没有 pracma 语句 。 
(2) 


如 果 你 在 PL/pgSQL 里 做 一 个 Lock TABLE ， 那么 这 个 锁 在 调用 该 命令 的 事务 
释放 。 


(3) 


你 不 能 在 PL/pgSQL 画 数 里 发 出 coMMIT 。 画 数 是 在 外 层 的 事务 里 运行 的 ， 因 此 commit 2H 
着 结束 范 数 的 执行 。 不 过 ， 在 这 个 特殊 场合 下 ， 这 是 不 必要 的 了 ， 因为 Lock TABLE 获取 的 
锁 将 在 抛 出 错误 的 时 候 释放 。 


小 
= 
N 
对 
4| < 
Hp 


下 面 是 把 这 个 过 程 移植 到 PL/pgSQL 里 的 一 种 方法 : 





CREATE OR REPLACE FUNCTION cs_create_job(v_job_id integer) RETURNS void AS $$ 
DECLARE 

a_running_job_count integer; 
BEGIN 

LOCK TABLE cs_jobs IN EXCLUSIVE MODE; 


SELECT count(*) INTO a_running_job_count FROM cs_jobs WHERE end_stamp IS NULL; 


IF a_running_job_count > 0 THEN 
RAISE EXCEPTION 'Unable to create a new job: a job is currently running';<a name= 
END IF; 


DELETE FROM cs_active_job; 
INSERT INTO cs_active_job(job_id) VALUES (v_job_id); 


BEGIN 
INSERT INTO cs_jobs (job_id, start_stamp) VALUES (v_job_id, now()); 
EXCEPTION 
WHEN unique_violation THEN <a name="CO.PLPGSQL-PORTING-EXCEPTION">**(2)**</a> 
-- don't worry if it already exists 
END; 
END; 
$$ LANGUAGE plpgsql; 


Aoo ëg 
(1) 


RAISE 的 语法 和 Oracle 的 类 似 语句 差别 相当 明 Bo 尽管 RAISE ~_exception_name_ 运行 的 基本 
情况 相似 。 


(2) 


PL/pgSQL 里 支持 的 异常 的 名 字 和 Oracle 的 不 同 。 内 置 的 异常 名 要 大 的 多 (参阅 Appendix A). 
目前 还 不 能 声明 用 户 定义 的 异常 名 。 





整个 过 程 和 Oracle 的 等 效 的 主要 的 功能 型 差别 是 ， 在 cs_jobs 上 持 有 的 排他 锁 将 保持 到 调用 
的 事务 结束 。 同样 ， 如 果 调 用 者 后 来 退出 (比如 说 因为 错误 )， 这 个 过 程 的 效果 将 被 回 滚 掉 。 


40.12.2. 其 它 注意 事项 
本 节 解 释 几 个 从 Oracle PL/SQLE# PostgreSQL 移植 的 几 个 其 它 方面 的 事情 。 


40.12.2.1. F F EAK S EA 


在 PL/pgSQL 里 ， 如 果 一 个 异常 被 ExcEPTION 子 句 捕获 ， 那么 所 有 自 这 个 块 的 BEGIN 以 来 的 
数据 库 改 变 都 会 被 自动 回 滚 。 也 就 是 说 ， 这 个 行为 等 于 你 在 Oracle 里 的 : 


BEGIN 
SAVEPOINT s1; 


-COde here 
EXCEPTION 

WHEN ... THEN 
ROLLBACK TO s1; 
... code here ... 

WHEN ... THEN 
ROLLBACK TO s1; 

. code here ... 


END; 


如 果 你 在 翻译 使 用 savePoINT 和 RoLLBACK To 的 Oracle 过 程 ， 那么 你 的 活 儿 很 好 干 : RES 
略 sAVEPOINT 和 ROLLBACK To 即 可 。 如 果 你 要 翻译 的 过 程 使 用 了 不 同 


的 SAVEPOINT 和 ROLLBACK To ， 那 么 就 需要 想 想 了 。 


40.12.2.2. EXECUTE 


PL/pgSQL 版 本 的 execute 类 似 PL/SQL 和 运转 ， 不 过 你 必须 记 住 要 像 Section 40.5.4 里 描述 的 那 
样 用 quote_literal 和 quote_ident 。 如 果 你 不 用 这 些 函 数 ， 那 么 
像 EXECUTE 'SELECT * FROM $1'; 这 样 的 构造 是 不 会 运转 的 。 


40.12.2.3. ¢{EPL/pgSQLin 2x 


PostgreSQL 25-4R A DNA EAE th 34 FSR GANT : "volatility" ( 易 变 的 ， 在 给 出 的 参数 相 
同时 ， KA % SRO ial 255R)40"strictness" (PRAIS, WMREASMASNULL, AANBZORE 
NULL), 参考 CREATE FUNCTION 的 手册 获取 细节 。 


如 果 要 使 用 这 些 优化 属性 ， 那 么 你 的 cREATE FUNCTION 语句 可 能 看 起 来 像 这 样 : 


CREATE FUNCTION foo(...) RETURNS integer AS $$ 


$$ LANGUAGE plpgsql STRICT IMMUTABLE; 


40.12.3. 附录 


本 节 和 包含 Oracle 兼 容 的 instr WA, MANAS bMS ta E. 


模拟 Oracle 概念 的 instr WA 
语法 : instr(string1，string2，[n]，[m]) 这 里 的 [] 表示 可 选 参数 


从 stringl 的 第 n 个 字符 开始 寻找 string2 的 第 m 个 出 现 。 
如 果 n 是 负数 ， 则 从 后 向 前 着 。 如 果 没 有 传递 m, MEA 1( 从 第 一 个 字符 开始 找 )。 


CREATE FUNCTION instr(varchar, varchar) RETURNS integer AS $$ 
DECLARE 

pos integer; 
BEGIN 

pos:= instr($1, $2, 1); 


RETURN pos; 
END; 
$$ LANGUAGE plpgsql STRICT IMMUTABLE; 


CREATE FUNCTION instr(string varchar, string_to_search varchar, beg_ 
RETURNS integer AS $$ 
DECLARE 
pos integer NOT NULL DEFAULT 0; 
temp_str varchar; 
beg integer; 
length integer; 
ss_length integer; 
BEGIN 
IF beg_index > © THEN 
temp_str := substring(string FROM beg_index); 
pos := position(string_to_search IN temp_str); 


IF pos = © THEN 


RETURN O; 
ELSE 
RETURN pos + beg_index - 1; 
END IF; 
ELSIF beg_index < © THEN 
ss_length := char_length(string_to_search); 


length := char_length(string); 
beg := length + beg_index - ss_length + 2; 


WHILE beg > 0 LOOP 
temp_str := substring(string FROM beg FOR ss_length); 
pos := position(string_to_search IN temp_str); 


IF pos > © THEN 
RETURN beg; 
END IF; 


beg := beg - 1; 
END LOOP; 


RETURN 0; 
ELSE 
RETURN 0; 
END IF; 
END; 
$$ LANGUAGE plpgsql STRICT IMMUTABLE; 


CREATE FUNCTION instr(string varchar, string_to_search varchar, 
beg_index integer, occur_index integer) 
RETURNS integer AS $$ 
DECLARE 
pos integer NOT NULL DEFAULT 0; 
occur_number integer NOT NULL DEFAULT O; 
temp_str varchar; 
beg integer; 
i integer; 
length integer; 
ss_length integer; 
BEGIN 
IF beg_index > © THEN 
beg := beg_index; 
temp_str := substring(string FROM beg_index); 


FOR i IN 1..occur_index LOOP 
pos position(string_to_search IN temp_str); 


IF i = 1 THEN 

beg := beg + pos - 1; 
ELSE 

beg := beg + pos; 
END IF; 


temp_str := substring(string FROM beg + 1); 
END LOOP; 


index integer) 


IF pos = © THEN 
RETURN O; 
ELSE 
RETURN beg; 
END IF; 
ELSIF beg_index < © THEN 
ss_length := char_length(string_to_search); 
length := char_length(string); 
beg := length + beg_index - ss_length + 2; 


WHILE beg > 0 LOOP 
temp_str := substring(string FROM beg FOR ss_length); 


pos := position(string_to_search IN temp_str); 


IF pos > © THEN 
occur_number := occur_number + 1; 


IF occur_number = occur_index THEN 
RETURN beg; 
END IF; 
END IF; 


beg := beg - 1; 
END LOOP; 


RETURN 0; 
ELSE 
RETURN 0; 
END IF; 
END; 
$$ LANGUAGE plpgsql STRICT IMMUTABLE; 
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PL/Tcl 是 一 种 用 于 PostgreSQL 数 据 库 系统 的 可 加 载 的 过 程 化 语言 ， 它 让 我 们 可 以 用 Tcl 语言 
来 书写 范 数 和 触发 器 过 程 。 


41.1. 概述 


以 使 用 强大 的 字符 串 处 理 库 。 


好 的 限制 是 ， 所 有 东西 都 是 在 一 个 安全 的 Tcl 解释 器 里 面 运 行 的 。 除了 一 个 有 限 的 Tcl 安全 命 
今 集 外 ， 只 有 很 少 的 几 个 命令 可 以 通过 SPI 访问 数据 库 以 及 通过 elog() 生成 错误 信息 。 不 
RC HAAR, Tcl 没有 办 法 访问 数据 库 后 端 内 部 或 者 获得 OS 级 的 PostgreSQL 服务 器 进程 
的 权限 。 因 此 ， 任 何 非特 权 的 数据 库 用 户 都 可 以 被 允许 使 用 这 种 语言 。 


另外 的 实现 级 限制 是 Tcl 过 程 不 能 用 于 创建 新 数据 库 类 型 的 输入 /输出 画 数 。 


有 时 候 需 要 写 一 些 不 受 安 全 Te 限制 的 Tcl 函数 ， 比 如 ， 可 能 需要 一 个 可 以 发 送 邮 件 的 Tcl R 
数 。 要 义理 这 样 的 问题 ， 有 一 个 PL/Tcl 的 变种 ， 叫 PL/Tclu (不 可 信 的 Tcl), 这 个 语言 和 
PL/Tcl 是 完全 一 样 的 ， 只 不 过 使 用 了 一 个 完整 的 To 解释 器 。 如 果 你 使 用 了 PL/TcIU， 那 么 你 
必须 把 它 安装 成 一 种 不 可 信 的 过 程 语言 ， 这 样 只 有 数据 库 超级 用 户 可 以 用 它 创 建 画 数 。 
PL/TcIUBR MES HER: 你 写 的 函数 一 定 不 要 做 任何 预算 外 的 事情 ， 因 为 它 能 干 所 有 数 
据 库 管 理 员 能 干 的 事情 。 


如 果 在 安装 过 程 的 配置 步骤 中 声明 了 Tcl 支持 ， 那 么 PL/Tcl 和 PL/TclU 的 调用 处 理 器 是 在 制作 
时 自动 制作 并 安装 到 PostgreSQL 库 目录 中 去 的 。 要 在 某 个 特定 的 数据 库 中 安装 PL/Tcl 和 /或 
PL/TclU, 那么 你 可 以 使 用 CREATE EXTENSION 命令 或 createlang 程序 。 tb 

如 createlang pltcl _dbname_ 或 createlang pltclu _dbname_ o 


41.2. PL/Tcl KAŽ 


要 用 PL/Tcl 语 言 创 建 一 个 函数 ， 使 用 标准 的 CREATE FUNCTION 语 法 : 


CREATE FUNCTION _funcname_ (_argument-types_) RETURNS _return-type_ AS $$ 
# PL/Tcl function body 
$$ LANGUAGE pltcl; 


PL/TclIU 是 一 样 的 ， 除 了 语言 应 该 声明 为 pltclu 之 外 。 


函数 体 就 是 一 段 Tcl 代码 。 当 在 一 个 查询 里 面 调 用 这 个 图 数 ， 参 数 是 作为 变量 $1 .… 
n_ 传递 给 Tcl 脚本 的 。 结果 是 用 通常 的 方法 从 Tel 代码 中 返回 的 ， 就 是 用 一 


个 return 语句 。 


比如 ， 一 个 简单 的 返回 两 个 整数 值 中 较 大 值 的 酚 数 可 以 这 


CREATE FUNCTION tcl_max(integer, integer) RETURNS integer AS $$ 
if {$1 > $2} {return $1} 
return $2 

$$ LANGUAGE pltcl STRICT; 


意 strict 子 句 ， 它 让 我 们 可 以 不 用 考虑 输入 为 NULL 的 情况 : 如 果 传 递 了 一 个 NULL 
该 图 数 实际 上 就 不 会 被 调用 ， 而 只 是 自动 返回 一 个 NULL 结果 。 


如 果 是 一 个 不 严格 的 函数 且 一 个 参数 的 实际 值 是 NULL ， 那 么 对 应 的 sn 变量 将 被 设置 
为 一 个 空 字 符 串 。 要 检测 一 个 特定 的 参数 是 否 为 NULL ， 可 以 使 用 argisnull WRX. 上 比如， 
假设 要 求 tcl_max 在 一 个 参数 为 null 而 另外 一 个 为 非 null 时 返回 非 null 参数 ， MA null : 


CREATE FUNCTION tcl_max(integer, integer) RETURNS integer AS $$ 
if {[argisnull 1]} { 
if {[argisnull 2]} { return_null } 
return $2 


} 
if {[argisnull 2]} { return $1 } 
if {$1 > $2} {return $1} 
return $2 
$$ LANGUAGE pltcl; 


如 上 所 述 ， 要 从 PL/Tcl 函数 中 返回 一 个 NULL 数值 ， 可 以 执行 return_null 。 FBWRES 
严格 ， 都 可 以 这 么 做 。 


复合 类 型 的 参数 是 当做 Tcl 数组 传递 给 函数 的 。 数 组 中 的 元 素 名 字 就 是 复合 类 型 里 的 属性 名 
字 。 如 果 在 传递 的 行 中 某 个 属性 为 NULL 数值 ， 那 它 就 不 会 在 数组 中 出 现 。 下 面 是 一 个 例 
F: 


CREATE TABLE employee ( 
name text, 
salary integer, 
age integer 


Ni 


CREATE FUNCTION overpaid(employee) RETURNS boolean AS $$ 
if {200000.0 < $1(salary)} { 
return "t" 


} 
if {$1(age) < 30 && 100000.0 < $1(salary)} { 
return "t" 


return "f" 
$$ LANGUAGE pltcl; 
目前 没有 返回 复合 类 型 结果 的 支持 。 也 不 支持 返回 结果 集 。 
PL/Tcl 目 前 还 不 是 完全 支持 域 类 型 : 它 看 待 域 类 型 和 下 层 的 标量 类 型 是 一 样 的 。 这 就 意味 着 
与 域 关联 的 约束 将 不 会 被 强制 。 对 于 函数 参数 ， 这 不 是 什么 问题 ， 但 是 如 果 你 把 PL/Tcl 函 数 声 
明 为 返回 一 个 域 类 型 ， 那 么 就 有 危险 。 


41.3. PL/Tcl 里 的 数据 值 


提供 给 PL/Tcl 函数 脚本 的 参数 值 都 只 是 转换 成 文本 形式 的 输入 参数 (就 像 它 们 用 sELECT 语句 
显示 出 来 的 那样 )。 相 反 ， return 可 以 用 任何 可 以 为 画 数 所 声明 的 返回 类 型 接受 的 输入 格式 
的 字符 串 。 因 此 ， 在 PL/Tcl 函数 里 ， 所 有 数值 只 是 文本 字符 串 。 


41.4. PL/Tcl 里 的 全 局 量 


有 时 候 在 两 次 过 程 落 数 调 用 或 者 不 同 的 责 数 之 间 保 存 一 些 全 局 数据 是 非常 有 用 的 。 在 PL/Tcl 
里 实现 这 个 目标 相当 容易 ， 但 是 这 里 有 一 些 限制 必须 熟悉 。 


由 于 安全 原因 ，PL/Tcl 通 过 一 个 在 单独 的 Tcl 解 释 器 里 的 SQL 角色 执行 范 数 调用 。 通过 有 另外 
一 个 用 户 的 PL/Tcl 画 数 行为 的 用 户 阻 止 了 偶然 的 或 恶意 的 干扰 。 每 个 这 样 的 干扰 对 于 任意 
的 "全 局 " Tcl 变 量 将 有 它 自己 的 值 。 因此 ， 当 且 公 当 他 们 通过 同一 个 SQL 角色 执行 时 ， 两 个 
PL/TcI 函 数 才 分 享 相同 的 全 局 变量 。 在 一 个 多 个 SQL 角色 下 的 单个 会 话 执行 脚本 的 应 用 中 
(通过 SECURITY DEFINER 图 数 ， 使 用 set RoLE SS) 可 能 需要 采取 明确 的 步 台 确 保 PL/Tcl 函 
数 可 以 分 享 数据 。 要 做 到 这 点 ， 确 保 可 以 通讯 的 函数 属于 同一 个 用 户 ， 并 且 标 识 它 

们 SECURITY DEFINER o 当然 必须 注意 这 种 函数 不 能 用 来 做 任何 计划 外 的 动作 。 


所 有 在 一 个 会 话 中 使 用 的 PL/TcIU 责 数 在 同一 个 Tcl 解 释 器 里 执行 ， 不 同 于 用 于 PL/Tcl 画 数 的 解 
释 器 。 所 以 全 局 数据 自动 在 PL/TcIU 画 数 间 分 享 。 没 有 考虑 安全 风险 ， 因 为 所 有 PL/TcIU 函 数 
在 同一 个 可 靠 地 级 别 执行 ， 即 数据 库 超级 用 户 。 


为 了 保护 PL/Tcl 过 程 相 互 之 间 不 至 于 互相 干扰 ， 每 个 过 程 可 以 通过 upvar 命令 访问 一 个 全 局 
数组 。 此 变量 的 全 局 名 称 是 过 程 的 内 部 名 称 ， 其 局 部 名 称 是 ep 。 建议 使 用 o A WANK 
久 私 有 状态 数据 的 存储 。 而 把 普通 的 Tcl 全 局 变量 只 用 于 那些 你 想 在 多 个 过 程 之 间 共 享 的 变 
= (Es, o 数组 只 在 一 个 特定 的 解释 器 里 是 全 局 的 ， 所 以 它们 没有 绕 开 上 面 提 到 的 
安全 限制 。) 


一 个 使 用 co 的 例子 在 下 面 的 spi_execp 例子 里 显示 。 


41.5. 在 PL/Tcl 里 访问 数据 库 


在 PL/Tcl 过 程 体 里 有 下 面 的 命令 可 以 用 于 访问 数据 库 : 
spi_exec’ ?-count N ? ?-array hame ? command ? loop-body’? 


执行 一 个 以 字符 串 形 式 给 出 的 SQL 查询 。 查 询 中 的 错误 会 导致 抛 出 一 个 错误 。 否 则 ， 
spi_exec 的 返回 值 是 命令 义理 的 行 数 ( 选 出 、 插 入 、 更 新 、 删 除 )， 如 果 该 命令 是 一 个 功能 性 
语句 则 返回 需 。 另 外 ， 如 果 查 询 是 一 条 SELECT 语句 ， 那么 选 出 的 字段 值 按照 下 面 描述 的 方法 
放 在 Tel 变量 中 。 

可 选 的 -count 值 告诉 spi_exec 在 该 查询 中 义理 的 最 大 的 行 数 。 其 效果 和 把 查询 设置 为 一 个 
游标 ， 然 后 说 FETcH _n 是 一 样 的 。 

如 果 查 询 是 一 个 sELECT 语句 ， 那 么 其 结果 列 的 数值 将 放 在 用 各 字段 名 命名 的 Te FSH, 如 
果 给 出 了 -array 选项 ， 那 么 字段 值 郊 放 到 这 个 命名 的 相关 数组 中 ， 字 段 名 用 做 数组 索引 。 
如 果 查 询 是 sELECT 语句 并 且 没有 给 出 _loop-body_ 脚本， 那么 只 有 结果 的 头 一 行 会 存储 到 
Tcl 变量 中 ; 如 果 还 有 其 它 行 的 话 ， 将 会 被 忽略 。 如 果 查 询 没 有 返回 任何 行 ， 那 么 不 会 存储 什 
么 数据 (这 个 情况 可 以 通过 检查 spi_exec 的 结果 来 判断 )。 比 如 : 


spi_exec "SELECT count(*) AS cnt FROM pg_proc" 


将 设置 Tcl 变量 sent HAMAR pg_proc 中 的 行 数 。 


如 果 给 出 了 可 选 的 _loop-body_ 参数 ， 那么 它 就 是 一 小 段 Tcl 脚本 ， 它 会 为 查询 结果 中 的 每 一 
行 执行 一 次 (注意 : 如 果 给 出 的 查询 不 是 sSELECT ， 那么 忽略 _loop-body_ )。 在 每 次 迭代 之 
前 ， 当前 行 的 字段 的 数值 都 存储 到 Tcl 变量 中 去 了 。 比 如 : 


spi_exec -array C "SELECT * FROM pg_class" { 
elog DEBUG "have table $C(relname)" 


将 为 pg class 的 每 一 行 打印 一 行 日 志 信息 。 这 个 特性 和 其 它 Tel 循环 构造 的 运 做 方式 类 似 ; 
特别 是 continue 和 break 在 循环 体 中 的 作用 和 平常 是 一 样 的 。 


如 果 一 个 查询 结果 的 某 个 字段 是 NULL ， 那 么 其 目标 变量 就 是 "unset" 而 不 会 设置 上 什么 东 
西 。 


spi_prepare _query_ _typelist_ 


为 后 面 的 执行 准备 并 保存 一 个 查询 规划 。 保 存 的 规划 的 生命 期 就 是 当前 会 话 的 生命 期 。 


查询 可 以 使 用 参数 ， 这 些 参数 是 规划 实际 执行 的 时 候 提供 的 数值 的 占 位 符 。 在 查询 字符 串 
E, 用 符号 $1 .… _ 引用 各 个 参数 。 如 果 查 询 使 用 了 人 参数， 那么 参数 类 型 名 必需 以 一 
个 Tel ee 如果 没 有 使 用 参数 那么 给 _typelist_ 写 一 个 空 列表 。 


spi_prepare 的 返回 值 是 一 个 可 以 在 随后 的 spi_execp 调用 中 使 用 的 查询 ID 。 参 
阅 spi_execp 获取 例子 


spi_execp’ ?-count N ? ?-array name ? ?-nulls String ? queryid ? value-list ? ? loop- 
body’? 


执行 一 个 前 面 用 spi_prepare 准备 的 查询 。 _queryid 是 spi_prepare 返回 的 ID 。 如 果 该 查 
pal age 那么 必需 提供 一 个 value-list_ : 这 是 一 个 Tcl 列表 ， 里 面包 含 那些 参数 的 
实际 数值 。 这 个 列表 的 长 度 必需 和 前 面 给 spi_prepare 提供 上 的 参数 类 型 列表 的 长 度 一 样 长 。 
nen 那么 省 略 _value-list_ o 


-nulls 可 选 的 数值 是 一 个 空白 字符 串 和 字符 'n' ， 告 诉 spi_execp 哪些 参数 是 NULL 。 如 
果 给 出 ， 那 么 它 必需 和 _value-list_ ay 如 果 没 有 给 出 ， 那 么 所 有 参数 值 都 是 非 
NULL 。 


除了 查询 及 其 参数 声明 的 方式 之 外 ， spi_execp 的 使 用 方法 基本 上 和 spi_exec 一 
样 。 -count ，-array ，_loop-body ”选项 都 是 一 样 的 ， 结 果 数 值 也 一 样 。 


下 面 是 一 个 使 用 预 各 规划 的 PL/Tcl 函数 的 例子 


CREATE FUNCTION t1_count(integer, integer) RETURNS integer AS $$ 
if {![ info exists GD(plan) ]} { 
# prepare the saved plan on the first call 
set GD(plan) [ spi_prepare \ 
"SELECT count(*) AS cnt FROM t1 WHERE num &gt;= \$1 AND num &lt;= \$2" \ 
[ list int4 int4 ] ] 


} 
spi_execp -count 1 $GD(plan) [ list $1 $2 ] 
return $cnt 

$$ LANGUAGE pltcl; 


EE 
需要 在 给 spi_prepare 的 查询 字符 串 里 放 反 和 斜 枉 ， 以 确保 son 标记 会 原样 传递 
给 spi_prepare ， 而 不 是 被 Tcl 的 变量 代 换 替换 掉 。 


spi_lastoid 


如 果 该 查询 是 单行 INSERT 并 且 被 修改 的 表 包 含 OID ， 则 返回 最 后 的 
spi_exec 或 spi_execp 查询 插入 的 行 的 OID, MRAZ, HBS, 


quote _string_ 


在 给 出 的 字符 串 里 将 所 由 单 引 号 和 反 斜 杠 字 符 复制 成 双 份 。 它 可 以 用 于 安全 地 处理 那 些 要 输 
和 人 到 spi_exec 或 spi_prepare 中 的 SQL 命令 中 的 引号 包围 字符 串 。 比如 ， 假如 一 个 SQL 命 
今 看 起 来 像 这 样 


"SELECT '$val' AS ret" 


这 里 的 Tcl 变量 val 实际 上 包含 doesn't o 这 样 最 后 的 命令 字符 串 会 是 这 样 : 


SELECT 'doesn't' AS ret 


而 这 个 字符 串 在 spi_exec 或 spi_prepare 的 时 候 会 导致 一 个 分 析 错 误 。 了 能 工作 正常 ， 提 
交 的 命令 应 该 包含 : 


SELECT 'doesn''t' AS ret 


在 PL/Tcl 中 可 以 这 样 构造 : 


"SELECT '[ quote $val ]' AS ret" 


spi_execp 的 一 个 优点 是 你 不 需要 像 这 样 引 号 包围 参数 值 ， 因为 参数 绝 不 会 当做 SQL 查询 
字符 串 的 一 部 分 被 分 析 。 





elog level msg 


发 出 一 个 日 志 或 者 错误 消息 。 可 能 的 级 别 是 DEBUG, LOG, INFO, NOTICE , WARNING , ERROR 
和 FATAL o ERROR 抛 出 一 个 错误 条 件 : 如 果 没 有 被 周围 的 Tcl 代 码 捕 获 ， 那 么 该 错误 传 到 调 
用 的 查询 中 ， 导致 当前 事务 或 子 事务 退出 。 作 用 和 Tcl 的 error 命令 相同 。 FATAL 退出 当前 
事务 并 且 导 致 当前 会 话 关闭 (可 能 在 PL/Tcl 函数 里 没有 什么 理由 使 用 这 个 错误 级 别 ， 提供 它 主 
o 其 他 级 别 只 产生 不 同 的 优先 级 信息 。 某 个 优先 级 别 的 信息 是 报告 给 客户 端 还 

写 到 服务 器 日 志 ， 还 是 两 个 都 做 是 由 log_min_messages 和 client_min_messages 配 置 变量 
a. 参阅 Chapter 18 获 取 更 多 细节 。 


41.6. PL/Tcl 里 的 触发 右 过 程 


触发 器 过 程 可 以 用 PL/Tcl 写 。PostgreSQL 要 求 当做 触发 器 调用 的 过 程 必需 声明 为 没有 参数 
并 且 返 回 类 型 为 trigger 的 函数 。 

触发 器 管理 器 传递 给 过 程 体 的 信息 是 通过 下 面 变量 传递 的 : 
$TG_name 

CREATE TRIGGER 语句 里 的 触发 器 名 称 。 

$TG_relid 

导致 触发 器 被 调用 的 表 的 对 象 ID 。 

$TG_table_name 

导致 触发 器 被 调用 的 表 的 名 字 。 

$TG_table_schema 

导致 触发 器 被 调用 的 表 的 模式 。 


$TG_relatts 


以 一 个 空 表 元 素 为 前 导 的 表 中 字段 名 称 的 Te 列表。 所 以 用 Tcl 命 令 lsearch 在 列表 里 查找 元 
素 名 称 时 ， 返 回 的 从 1 开始 计数 的 正 整数 ， 与 PostgreSQL 里 字段 编号 的 传统 一 样 。 已 经 被 删 
除 掉 的 字段 位 置 的 空 的 列表 元 素 仍 然 会 出 现 ， 这样， 属性 编号 与 字段 的 对 应 就 是 正确 的 。 


$TG_when 

由 触发 器 事件 类 型 决定 的 字符 串 BEFORE ， AFTER BK INSTEAD OF 

$TG_level 

由 触发 器 事件 类 型 决定 的 字符 串 Row 或 STATEMENT 

$TG_op 

由 触发 器 事件 类 型 决定 的 字符 串 INSERT , UPDATE , DELETE 或 TRUNCATE 

$NEW 

一 个 关联 数组 ， 包 含 Insert 或 UPDATE 动作 的 新 表 行 值 ， 如 果 是 DELETE 则 为 空 。 该 数组 是 


用 字段 名 做 索引 的 。 那 些 为 空 的 字段 不 会 在 数组 中 出 现 。 这 不 是 为 语句 级 别 的 触发 器 设置 
的 。 


$0LD 


一 个 关联 数组 ， 包 含 UPDATE 或 DELETE 动作 的 新 表 行 ， 如 果 是 INSERT 则 为 空 。 该 数组 是 用 
字段 名 做 索引 的 。 那 些 为 空 的 字段 不 会 在 数组 中 出 现 。 这 不 是 为 语句 级 别 的 触发 器 设置 的 。 


$args 


如 同 在 cREATE TRIGGER 语句 里 给 出 的 参数 一 样 的 Te 程序 参数 表 。 这 些 参数 在 过 程 体 里 可 以 
通过 $1 . $ n 来 访问 。 


鲁 发 器 过 程 返回 的 值 是 字符 串 ok 或 skip 之 一 ， 或 者 一 个 像 array get Tel 命令 返回 的 数组 
那样 的 东西 。 如 果 返 回 值 是 ok ， 触 发 触发 器 的 操作 ( INSERT / UPDATE / DELETE ) 将 会 正常 进 
行 。 sKIP 告诉 触发 器 管理 器 不 声 不 响 地 忽略 该 行 的 操作 。 如 果 返 回 一 个 数组 ， 那么 它 告诉 
PL/Tcl 返回 一 个 修改 后 的 行 给 触发 器 管理 器 。 这 仅仅 对 行 级 别 的 BEFORE INSERT 或 

UPDATE 触发 器 有 意义 ， 修 改 的 行 而 不 是 siew 里 面 给 出 的 行 被 插入 ; 或 对 于 行 级 别 

的 INSTEAD OF INSERT 或 UPDATE 触发 器 ， 返回 的 行 用 来 提供 

给 INSERT RETURNING 或 UPDATE RETURNING 命令 。 其 他 触发 器 类 型 忽略 返回 值 。 


下 面 是 一 个 小 的 触发 器 过 程 的 例子 ， 它 强制 表 内 的 一 个 整数 值 对 行 的 更 新 次 数 进行 跟踪 。 对 
插入 的 新 行 ， 该 值 初始 化 为 0 并 且 在 每 次 更 新 操作 中 加 一 。 


CREATE FUNCTION trigfunc_modcount() RETURNS trigger AS $$ 
switch $TG_op { 
INSERT { 
set NEW($1) 0 


} 
UPDATE { 
set NEW($1) $0LD($1) 
incr NEW($1) 
} 
default { 
return OK 
} 
return [array get NEW] 
$$ LANGUAGE pltcl; 
CREATE TABLE mytab (num integer, description text, modcnt integer); 


CREATE TRIGGER trig_mytab_modcount BEFORE INSERT OR UPDATE ON mytab 
FOR EACH ROW EXECUTE PROCEDURE trigfunc_modcount('modcnt'); 


请 注意 触发 器 过 程 本 身 并 不 知道 字段 名 字 ; 那些 是 从 触发 器 参数 中 提供 的 。 这 样 就 可 以 让 将 
触发 器 过 程 复 用 于 不 同 的 表 。 


41.7. 模块 和 unknown HIMES 


PL/Tcl 使 用 时 支持 自动 加 载 Tel 代码 。 它 识别 一 个 特殊 的 pltcl_modules R, 该 表 被 认为 包含 
Tel 代码 的 模块 。 如 果 存 在 这 个 表 ， 则 在 数据 库 会 话 中 的 PL/Tcl 汞 数 第 一 次 执行 之 前 ， 从 该 表 
中 抓 取 unknown 模块 并 加 载 到 Te 解释 器 中 。 (如 果 在 一 个 会 话 中 有 多 个 ， 将 单独 为 每 个 Tcl 
解释 器 发 生 ; B Section 41.4, ) 


因为 unknow 模块 实际 上 可 以 包含 任何 你 需要 的 初始 化 脚本 ， 它 通常 是 定义 为 一 个 Tcl 
unknown 过 程 ， 在 Te 不 能 识别 一 个 调用 的 过 程 名 的 时 候 就 调用 它 。PL/Tcl 这 个 过 程 的 标准 版 
本 试图 在 pltcl modules 里 找到 一 个 定义 所 需要 过 程 的 模块 。 如 果 找 到 一 个 ， 那 么 把 它 加 载 
入 解释 器 ， 然后 允许 继续 按照 原来 的 过 程 调用 义理 。 另外 还 定义 了 一 个 pltcl_modfuncs 表 ， 
它 提供 了 哪个 函数 由 哪个 模块 定义 的 索引 ， 因 此 坦 找 过 程 相 当 快 。 


PostgreSQL 包 括 维 护 这 些 表 的 支持 脚本 : pltcl_loadmod , pltcl_listmod , pltcl_delmod 以 
及 标准 share/unknown.pltcl 中 unknown 模块 的 源 代 码 。 这 个 模块 必须 一 开始 就 加 载 和 人 每 个 数 
据 库 才能 支持 自动 加 载 机 制 。 


表 pltcl modules 和 pltcl_modfuncs 必需 可 以 为 所 有 人 读 取 ， 但 是 把 它 做 成 只 有 数据 库 管 理 
员 可 写 并 拥有 是 明智 的 。 作 为 一 个 安全 预防 ， PL/Tcl 将 忽略 pltcl modules (并 且 因 此 ， 不 党 
试 加 载 unknown 模块 ) 除非 它 被 超级 用 户 所 有 。 但 是 这 个 表 上 的 更 新 权限 可 以 赋予 给 其 他 用 
户 ， 如 果 你 足够 信任 他 们 。 


41.8. Tcl 过 程 名 字 


在 PostgreSQL 里 ， 同 一 个 画 数 名 字 可 以 用 于 不 同 的 函数 定义 ， 只 要 参数 个 数 或 者 它们 的 类 型 
不 同 。 不 过 ，Tcl 要 求 所 有 的 过 程 名 字 都 是 唯一 的 。 PL/Tcl 通过 把 内 部 Tcl 过 程 名 字 包 含 该 函 
数 来 自 系 统 表 pg_proc 的 对 象 ID 作为 名 字 的 一 部 分 来 处 理 这 些 问题 。 因此 同名 不 同 参 数 类 

型 的 PostgreSQL 本 数 也 将 会 有 不 同 的 Tcl 过 程 名 。 这 个 问题 通常 对 PL/Tcl 程序 员 而 言 不 算 

哈 ， 但 是 在 调试 的 时 候 可 能 会 看 到 。 


Chapter 42. PL/Perl - Perl 过 程 语言 


Table of Contents 
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PL/Perl 是 一 种 可 加 载 的 过 程 语言 ， 通 过 它 可 以 用 Perl 编程 语言 编写 PostgreSQL 本 数 。 


使 用 PL/Perl 的 主要 优点 是 允许 在 函数 中 大 量 使 用 来 自 Per 的 义理 字符 串 的 操作 和 郴 数 。 
PL/pgSQL 很 难 分 析 的 复杂 字符 串 对 Perl 来 说 却 是 小 菜 一 碟 。 


要 在 特定 数据 库 里 安装 PL/Perl ， 使 用 CREATE EXTENSION plperl ， 或 在 shell 命 令 行 里 使 用 


createlang plperl _dbname_ o 





Tip: 如 果 某 种 编程 语言 安装 到 template1 ， 那 么 所 有 随后 创建 的 数据 库 都 会 自动 安装 这 
种 语言 Fo 


Note: 使 用 源码 包 的 用 户 必须 在 安装 过 程 中 特别 打开 PL/Perl 的 编译 。 请 参考 Chapter 15 
获取 更 多 信息 。 二 进 制 包 的 用 户 可 能 会 在 一 些 独立 的 子 包 中 找到 PL/Per| 。 





42.1. PL/Perl 函数 和 参数 


要 用 PL/Perl 语言 创建 一 个 范 数 ， 可 以 使 用 标准 的 CREATE FUNCTION 语 法 : 


CREATE FUNCTION _funcname_ (_argument-types_) RETURNS _return-type_ AS $$ 
# PL/Perl function body 
$$ LANGUAGE plper1; 


PBA i Perl 代码。 实际 上 ，PL/Perl 胶水 代码 将 其 封装 在 一 个 Per 子 过 程 里 。 一 个 
PL/Perl 芳 数 在 一 个 标量 环境 中 调用 ， 所 以 不 能 返回 一 个 列表 。 你 可 以 像 下 面 描述 的 那样 用 返 
回 引 用 的 方法 返回 非 标量 值 (arrays, records, 和 sets) 。 


PL/Perl 也 支持 DO 语 句 调 用 匿名 代码 块 : 


DO $$ 
# PL/Perl code 
$$ LANGUAGE plper1; 


TEAR SAFES, MEARE REA. BM CHT 4 MRT 


Note: 在 Perl 里 使 用 ee 程 是 很 危险 的 ， 特 别 是 它们 在 闭 包 里 引用 了 词法 变 
量 的 时 候 。 因为 PL/Perl 是 封装 在 一 个 子 过 程 里 ， 因 此 ， 任 何 你 放 进 去 的 命名 子 过 程 都 
将 被 谋 套 。 通 常 ， 创建 一 coderef 调用 的 匿名 子 过 程 要 安全 得 多 。 想 要 获取 更 多 细 
节 ， 请 参阅 variable "%s" will not stay shared 里 的 记录 或 perldiag 手 册页 中 

的 variable "%s" is not available ， 或 在 Internet 上 搜索 "per| ME MALE". 


CREATE FUNCTION 命令 的 语法 要 求 把 函数 体 写 成 字符 串 常 量 。 通常 处 理 字 符 串 文本 用 美元 符 界 
定 更 方便 (参阅 Section 4.1.2.4), 如 果 你 想 使 用 传统 的 E'' 逃逸 语法 ， 必 须 双 写 范 数 体 里 使 用 
的 任何 单 引 号 ( ' ) 和 反 斜 杠 (、)( 参 见 Section 4.1.2.1) 


参数 和 结果 都 是 和 任何 其 它 Per 子 过 程 里 那样 义理 的 : @_ 里 传递 的 ， 结果 值 是 
用 return 返回 或 者 作为 妙 数 中 最 后 计算 的 表达 式 的 值 返 


比如 ， 一 个 返回 两 个 整数 中 较 大 值 的 函数 可 以 这 人 么 写 : 


CREATE FUNCTION perl_max (integer, integer) RETURNS integer AS $$ 
if ($_[0] > $_[1]) { return $_[0]; } 
return $_[1]; 

$$ LANGUAGE plper1; 


Note: 为 了 能 够 在 PL/Perl 里 使 用 ， 参 数 将 从 数据 库 编码 转换 为 UTF-8， 然 后 在 返回 时 从 
UTF-8 回 到 数据 库 编 码 。 


QO SR 24 BN 1 2 — A NULL 那么 其 参数 值 将 以 Perl 中 "undefined" 的 形式 出 现 。 上 面 的 函数 定 
义 在 输入 为 NULL 时 的 行为 不 是 很 正常 (实际 上 ， 它 将 表现 得 好 像 它 们 都 是 需 一 样 )。 可 以 给 
函数 定义 增加 strict 让 PostgreSQL 做 一 些 更 合理 的 事情 : 如 果 传 递 进来 一 个 NULL ， 那么 
该 图 数 则 根本 不 会 被 调用 ， 而 只 是 自动 返回 一 个 NULL 结果 。 另 外 ， 可 以 在 画 数 体 里 检查 未 
定义 的 输入 。 比 如 ， 假 设想 收 到 一 个 NULL 和 一 个 非 NULL 参数 的 perl_max 返回 非 NULL 
的 参数 ， 而 不 是 NULL : 


CREATE FUNCTION perl_max (integer, integer) RETURNS integer AS $$ 
my ($x, $y) = @,; 
if (not defined $x) { 
return undef if not defined $y; 
return $y; 


return $x if not defined $y; 
return $x if $x > $y; 
return $y; 

$$ LANGUAGE plper1; 


E e ted 范 数 中 返回 一 个 NULL ， 可 以 返回 一 个 未 定义 的 数值 。 TEA 
否 严格 ， 都 可 以 这 人 么 做 。 


任何 一 个 不 是 引用 的 函数 参数 是 一 个 字符 串 ， 这 是 相关 数据 类 型 在 标准 PostgreSQL 外 部 文本 
里 的 表示 。 普 通 数 字 或 文本 类 型 的 情况 下 ，Perl 将 只 是 做 正确 的 事情 ， 程 序 员 不 需要 担心 。 
然而 ， 在 其 他 情况 下 ， 需 要 将 参数 转换 为 Perl 可 用 的 形式 。 例 如 ， decode_bytea KIŠE MAA 
来 转换 类 型 bytea 的 参数 为 非 逃逸 的 二 进 制 。 


相似 的 ， 传 回 PostgreSQL 的 值 必须 是 外 部 文本 表示 格式 。 例如 ， encode_bytea 图 数 可 以 用 
来 为 一 个 类 型 为 bytea 的 返回 值 逃 逸 二 进 制 数据 。 


Perl 可 以 用 Perl 数组 引用 的 方式 返回 PostgreSQL 数 组 。 下 面 是 一 个 例子 


CREATE OR REPLACE function returns_array() 
RETURNS text[][] AS $$ 

KELUGN ramba ee Citra CONN taille: 
$$ LANGUAGE plper1; 


select returns_array(); 


Perl 作 为 一 个 PostgreSQL: :InServer: :ARRAY 对 象 传递 PostgreSQL 数组 。 这 个 对 象 可 以 被 视 为 
一 个 数组 引用 或 一 个 字符 串 ，Penl 为 PostgreSQL 低 于 9.1 的 版 本 编写 了 代码 ， 人 允许 向 后 兼容 。 
例如 : 


CREATE OR REPLACE FUNCTION concat_array_elements(text[]) RETURNS TEXT AS $$ 
my $arg = shift; 
my $result = ""; 
return undef if (!defined $arg); 


# as an array reference 


for (@$arg) { 
$result .= $_; 
} 


# also works as a string 
$result .= $arg; 


return $result; 
$$ LANGUAGE plper1; 


SELECT concat_array_elements(ARRAY['PL','/', 'Perl']); 





Note: 多 维 数 组 的 表现 就 和 每 个 Perl 程 序 员 引用 低 维 数组 的 引用 一 样 。 


合 类 型 的 参数 是 当做 指向 散 列 的 引用 传递 给 琅 数 的 。 散 列 的 键 字 是 复合 类 型 的 属性 名 。 下 
面 是 一 个 例子 : 


CREATE TABLE employee ( 
name text, 
basesalary integer, 
bonus integer 


) 

CREATE FUNCTION empcomp(employee) RETURNS integer AS $$ 
my ($emp) = @,; 
return $emp->{basesalary} + $emp->{bonus}; 

$$ LANGUAGE plper1; 


SELECT name, empcomp(employee.*) FROM employee; 


使 用 同 桩 的 办 法 ， 一 个 PL/Perl BMALGEE—TH AX BOER : 返回 一 个 包含 所 需要 的 
属性 的 散 列 的 引用 。 比 如 ， 


CREATE TYPE testrowperl AS (f1 integer, f2 text, f3 text); 

CREATE OR REPLACE FUNCTION perl_row() RETURNS testrowperl AS $$ 
return {f2 => 'hello', f1 => 1, f3 => 'world'}; 

$$ LANGUAGE plper1; 


SELECT * FROM perl_row(); 


在 声明 的 结果 数据 类 型 里 的 任何 字段 如 果 在 散 列 里 面 没有 出 现 ， 那 么 都 会 当 作 NULL 返回 。 


PL/Perl 函数 也 能 返回 标量 或 者 复合 类 型 的 集合 。 通 常 你 希望 一 次 返回 一 行 ， 一 方面 加 速 画 数 
启动 时 间 ， 另 外 一 方面 防止 在 内 存 里 堆积 整个 结果 集 。 可 以 用 下 面 说 明 的 函 
数 return_next o 请 注意 在 最 后 的 return_next ， 你 必须 放 一 个 return 或 者 (最 好 


是 ) return undef o 


CREATE OR REPLACE FUNCTION perl_set_int(int) 
RETURNS SETOF INTEGER AS $$ 
foreach (0..$ [0]) { 
return_next($_); 
} 


return undef; 
$$ LANGUAGE plper1; 


SELECT * FROM perl_set_int(5); 


CREATE OR REPLACE FUNCTION perl_set() 

RETURNS SETOF testrowperl AS $$ 
return_next({ f1 => 1, f2 => 'Hello', f3 => 'World' }); 
return_next({ f1 => 2, f2 => 'Hello', f3 => 'PostgreSQL' }); 
return_next({ f1 => 3, f2 => 'Hello', f3 => 'PL/Perl' }); 
return undef; 

$$ LANGUAGE plper1; 


对 于 小 的 结果 集 ， 你 可 以 返回 一 个 指向 一 个 数组 的 引用 ， 这 个 数组 可 以 包含 标量 ， 指 向 数组 
的 引用 ， 或 者 指向 简单 类 型 ， 数 组 类 型 以 及 复合 类 型 等 的 散 列 的 引用 。 这 里 是 一 个 简单 的 例 
F, 它 把 整个 结果 集 当 作 一 个 数组 引用 返回 : 
CREATE OR REPLACE FUNCTION perl_set_int(int) RETURNS SETOF INTEGER AS $$ 
return [0..$_[0]]; 
$$ LANGUAGE plper1; 
SELECT * FROM perl_set_int(5); 
CREATE OR REPLACE FUNCTION perl_set() RETURNS SETOF testrowperl AS $$ 
return [ 
{ f1 => 1, f2 => 'Hello', f3 => 'World' }, 
{ f1 => 2, f2 => 'Hello', f3 => 'PostgreSQL' }, 
{ f1 => 3, f2 => 'Hello', f3 => 'PL/Perl' } 
l; 
$$ LANGUAGE plperl; 


SELECT * FROM perl_set(); 


如 果 你 想 在 自己 的 代码 里 使 用 strict 用 法 你 有 几 种 选择 。 对 于 临时 全 局 使 用 你 可 以 ser 
plperl.use_strict 为 真 。 这 个 参数 影响 随后 的 PL/Perl 画 数 的 编译 ， 但 是 不 影响 在 当前 会 话 
里 已 经 编译 了 的 画 数 。 为 了 永久 全 局 使 用 ， 可 以 在 postgresql.conf 文件 里 设 

ia plperl.use_strict ABD 


要 在 特定 的 函数 中 永久 使 用 ， 只 需要 简单 地 在 函数 体 的 顶部 放置 : 


use strict; 


如 果 你 的 Perl 是 版 本 5.10.0 或 更 高 ， 那 么 feature 程序 也 适用 于 use o 


42.2. PL/Perl 里 的 数据 值 


提供 给 PL/Perl 函数 代码 的 参数 值 只 是 简单 地 将 输入 参数 转换 成 文本 形式 (就 像 它 们 被 
SELECT 语句 显示 的 那样 )。 与 之 相对 的 是 ， return 和 return_next 命 全 将 接受 任何 函数 声明 
的 返回 类 型 可 以 接受 的 输入 格式 的 字符 串 。 


42.3. A EKA 


42.3.1. 从 PL/Perl 访 问 数 据 库 


从 Perl 函数 里 访问 数据 库 本 身 可 以 通过 下 面 的 孙 数 做 到 
spi_exec_query ( query [, max-rows ]) 


spi_exec_query 执行 一 个 SQL 命令 然后 把 整个 结果 集 当 作 一 个 指向 散 列 引用 的 引用 返回 。 
只 有 在 你 知道 结果 集 相 对 比较 小 的 时 候 才 能 用 这 个 命令 。 下 面 是 一 个 带 有 人 额外 的 最 大 行 数 的 
查询 ( SELECT 命令 ) 的 例子 。 


$rv = spi_exec_query('SELECT * FROM my_table', 5); 


tM my_table 里 返回 最 多 577. HOR my_table 有 一 个 字段 是 my_column ， 那 么 可 以 用 下 面 
的 方法 从 结果 的 第 $i 行 获 取 其 值 : 


$foo = $rv-&gt; {rows}[$i] -&gt; {my_column}; 


从 一 个 SELECT 查询 返回 的 总 行 数 可 以 这 样 访问 : 


$nrows = $rv-&gt; {processed} 


这 里 是 一 个 使 用 其 它 命令 的 例子 : 


$query = "INSERT INTO my_table VALUES (1, 'test')"; 
$rv = spi_exec_query($query); 


你 可 以 用 下 面 方法 访问 状态 (如 SPI_OK_INSERT ) : 


$res = $rv-&gt; {status}; 


这 样 获取 影响 的 行 数 : 


$nrows = $rv-&gt; {processed}; 


下 面 是 一 个 完整 的 例子 : 


CREATE TABLE test ( 
i int, 
v varchar 


Ne 


INSERT INTO test (i, v) VALUES (1, 'first line'); 
INSERT INTO test (i, v) VALUES (2, 'second line'); 
INSERT INTO test (i, v) VALUES (3, ‘third line'); 
INSERT INTO test (i, v) VALUES (4, '‘immortal'); 


CREATE OR REPLACE FUNCTION test_munge() RETURNS SETOF test AS $$ 
my $rv = spi_exec_query('select i, v from test;'); 
my $status = $rv-&gt;{status}; 
my $nrows = $rv-&gt; {processed}; 
foreach my $rn (0 .. $nrows - 1) { 
my $row = $rv-&gt; {rows}[$rn]; 
$row-&gt; {i} += 200 if defined($row-&gt; {i}); 
$row-&gt;{v} =~ tr/A-Za-z/a-zA-Z/ if (defined($row-&gt;{v})); 
return_next ($row) ; 
} 
return undef; 
$$ LANGUAGE plper1; 


SELECT * FROM test_munge(); 


spi_query(***_command_*) Spifetchrow(```_cursor ) ~*spi_cursor_close(***_cursor_ ) 


spi_query 和 spi_fetchrow 一 起 用 于 义理 那些 行 集 可 能 比较 大 ， 或 者 是 在 你 收 到 行 的 时 候 就 
返回 的 场合 。 spi_fetchrow 只 能 和 spi_query 一 起 使 用 。 下 面 的 例子 演示 了 如 何 使 用 : 


CREATE TYPE foo_type AS (the_num INTEGER, the_text TEXT); 


CREATE OR REPLACE FUNCTION lotsa md5 (INTEGER) RETURNS SETOF foo_type AS $$ 

use Digest::MD5 qw(md5_hex); 
my $file = '/usr/share/dict/words'; 
my $t = localtime; 
elog(NOTICE, "opening file $file at $t" ); 
open my $fh, '@lt;', $file # 这 是 访问 文件 ! 

or elog(ERROR, "cannot open $file for reading: $!"); 
my @words = &lt;$fh&agt;; 
close $fh; 
$t = localtime; 
elog(NOTICE, "closed file $file at $t"); 
chomp(@words) ; 
my $row; 
my $sth = spi_query("SELECT * FROM generate_series(1,$_[0]) AS b(a)"); 
while (defined ($row = spi_fetchrow($sth))) { 

return_next({ 

the_num =&gt; $row-&gt; {a}, 
the_text =&gt; md5_hex($words[rand @words]) 

3); 

} 


return; 
$$ LANGUAGE plperlu; 


SELECT * from lotsa_md5(500); 


通常 ， 应 当 重 复 spi_fetchrow 直到 其 返回 undef 以 表示 没有 行 可 以 读 取 了 ， 此 时 
由 spi_query 返回 的 游标 将 被 自动 释放 。 如 果 你 确实 不 想 读 取 所 有 行 ， 可 以 明确 调 
用 spi_cursor_close 来 释放 游标 ， 否则 将 会 导致 内 存 泄漏 。 


spi_prepare(***_command_*, ~_argument types_`) Spiquery_prepared(’*_plan , arguments ) 


[, _attributes_ ], _arguments_ ) `spi_freeplan(```_plan_ ) 


spi_prepare , spi_query_prepared , spi_exec_prepared , spi_freeplan 为 预备 查询 实现 同样 
的 功能 。 spi_prepare 接受 一 个 带 有 编号 的 参数 占 位 符 的 字符 串 和 一 个 参数 类 型 的 字符 串 列 
表 : 


$plan = spi_prepare('SELECT * FROM test WHERE id &gt; $1 AND name = $2', 
'INTEGER', 'TEXT'); 


一 旦 一 个 查询 规划 通过 调用 spi_prepare 准备 好 ， 该 规划 就 可 以 代 蔡 查询 字符 串 ， 不 管 是 

在 spi_exec_prepared 中 (与 spi_exec_query 返回 的 结果 相同 ) 还 是 在 spi_query_prepared 中 

(与 spi_query 返回 的 游标 相同 )， 之 后 可 以 被 传递 给 spi_query o spi_exec_prepared 可 选 的 

第 二 个 参数 是 一 个 属性 的 哈 希 引用 ; 当前 唯一 支持 的 属性 是 limit, 设置 查询 返回 行 的 最 小 

数量 

预备 查询 的 好 处 是 可 以 为 多 个 查询 的 执行 使 用 一 个 预备 规划 。 在 规划 不 再 被 需要 之 后 ， 可 以 
过 


通过 spi_freeplan 释放 : 


CREATE OR REPLACE FUNCTION init() RETURNS VOID AS $$ 
$_SHARED{my_plan} = spi_prepare('SELECT (now() + $1)::date AS now', 
"INTERVAL'); 
$$ LANGUAGE plper1; 


CREATE OR REPLACE FUNCTION add_time( INTERVAL ) RETURNS TEXT AS $$ 
return spi_exec_prepared( 
$_SHARED{my_plan}, 
$_[0] 
)-&gt; {rows}-&gt; [0] -&gt; {now}; 
$$ LANGUAGE plper1; 


CREATE OR REPLACE FUNCTION done() RETURNS VOID AS $$ 
spi_freeplan( $_SHARED{my_plan}); 
undef $ SHARED{my_plan}; 

$$ LANGUAGE plper1; 


SELECT init(); 
SELECT add_time('1 day'), add_time('2 days'), add_time('3 days'); 
SELECT done(); 

add_time | add_time | add_time 


a EAA aie eye =. ne a ee EETA eer ee 
2005-12-10 | 2005-12-11 | 2005-12-12 


注意 ， spi_prepare 中 的 参数 是 通过 $1, $2, $3 .… 表示 的 ， 因此 避免 在 双 引 号 中 声明 查询 字 
符 串 ， 那 样 可 能 会 导致 难以 发 现 的 臭虫 。 


另外 一 个 说 明 spi_exec_prepared 里 的 可 选 参数 的 使 用 的 例子 : 


CREATE TABLE hosts AS SELECT id, ('192.168.1.'||id)::inet AS address 
FROM generate_series(1,3) AS id; 


CREATE OR REPLACE FUNCTION init_hosts_query() RETURNS VOID AS $$ 
$_SHARED{plan} = spi_prepare('SELECT * FROM hosts 
WHERE address &lt;&lt; $1', ‘inet'); 
$$ LANGUAGE plper1; 


CREATE OR REPLACE FUNCTION query_hosts(inet) RETURNS SETOF hosts AS $$ 
return spi_exec_prepared( 
$_SHARED{plan}, 
{limit =&gt; 2}, 
$_[0] 
)-&gt; {rows}; 
$$ LANGUAGE plper1; 


CREATE OR REPLACE FUNCTION release_hosts_query() RETURNS VOID AS $$ 
spi_freeplan($_SHARED{plan}) ; 
undef $_SHARED{plan}; 

$$ LANGUAGE plper1; 


SELECT init_hosts_query(); 
SELECT query_hosts('192.168.1.0/30'); 
SELECT release_hosts_query(); 


query_hosts 


(1,192.168.1.1) 
(2,192.168.1.2) 
(2 rows) 


42.3.2. PL/Perl BAIS WE 


`elog(```_level_ , _msg ) 





发 出 一 条 日 志 或 者 错误 信息 。 可 能 的 级 别 是 DEBUG, LOG, INFO, NOTICE , WARNING , 
ERROR o ERROR 抛 出 一 个 错误 条 件 。 如 果 这 个 错误 没有 被 周围 的 Perl 代码 捕获 ， 那 么 错误 将 
a ke 导致 当前 事务 或 者 子 事务 退出 。 这 实际 上 相当 于 Perl 的 die PAo 

它 级 别 只 是 生成 不 同 优先 级 的 消息 。 特 定 优先 级 的 消息 是 否 报告 给 客户 端 、 写 到 服务 器 日 
或 者 两 个 都 做 ， 是 由 配置 参数 log_min_messages 和 client min messages 控制 的 。 参 
阅 Chapter 18 获 取 更 多 信息 。 


`quote_literal(```_string_ ) 


适当 的 返回 在 一 个 SQL 语句 字符 串 中 作为 字符 串 文 本 引用 的 给 定 字 符 串 。 财 入 的 单 引 号 和 反 
斜 杠 要 加 一 倍 。 请 注意 ， quote_literal 在 未 定义 的 输入 上 返回 未 定义 ; 如 果 参 数 是 未 定义 
的 ， quote_nullable 往往 是 更 合适 的 。 


~*quote_nullable( ~~ ~_string_ ) 


适当 的 返回 在 一 个 SQL 语句 字符 串 中 作为 字符 串 文本 引用 的 给 定 字符 串 。 或 者 ， 如 果 参 数 是 
未 定义 的 ， 返回 不 加 引号 的 字符 串 "NULL"。 钳 入 的 单 引 号 和 反 斜 杠 要 加 一 倍 。 


`quote_ident(```_string_ ) 


适当 的 返回 在 一 个 SQL 语句 字符 串 中 作为 一 个 标识 符 引 用 的 给 定 字符 串 。 只 有 在 必要 时 添加 
引号 〈 也 就 是 ， 如 果 字 符 串 包含 非 标识 符 字符 或 是 case-folded) . WRAS SMMRP E 
加 一 倍 。 


`decode_bytea(```_string_ ) 
RG AEF A RABAT BE, Mi bytea 编码 。 
~encode_bytea(***_string_ ) 

返回 给 定 字符 串 的 二 进 制 数据 内 容 的 bytea 编码 格式 。 
encode_array_literal(***_array_>) encodearray _literal(``_array , delimiter ) 


返回 引用 的 数组 的 内 容 ， 以 在 数组 里 的 字符 串 文 本 的 格式 (参阅 Section 8.15.2), 如 果 不 是 一 
个 数组 的 引用 则 返回 未 改变 的 参数 值 。 如 果 分 隔 符 没 用 指定 或 是 未 定义 的 ， 则 数组 文字 元 素 
之 间 的 分 隔 符 缺 省 是 "”，"。 


~encode_typed_literal(°**_value_ , _typename_ ) 


转换 一 个 Perl 变 量 为 作为 第 二 个 参数 传递 的 数据 类 型 的 值 和 返回 一 个 这 个 值 的 字符 串 表 示 。 
正确 义理 矿 套 数组 和 复合 类 型 的 值 。 


`encode_array_constructor(```_array_ ) 


返回 引用 的 数组 的 内 容 ， 以 在 数组 构造 器 里 的 字符 串 的 格式 (参阅 Section 4.2.12) 个 别 的 值 
用 quote_nullable 引用 。 如 果 不 是 对 数组 的 引用 ， 那 么 返回 参数 值 用 quote_nullable 引用 。 


~looks_like_number (~~ *_string_ ) 


根据 Perl|， 如 果 给 定 字符 串 的 内 容 看 起 来 像 一 个 数字 则 返回 真 ， 否 则 返回 假 。 如 果 参 数 是 未 定 
义 则 返回 未 定义 。 忽略 前 置 和 后 置 的 空格 。 Inf 和 Infinity 被 认为 是 数字 。 


~is_array_ref( ~~ ~_argument_ ) 


如 果 给 定 参 数 可 能 被 视 为 一 个 数组 引用 则 返回 真 ， 也 就 是 ， 如 果 参 数 的 参考 是 array 或 


PostgresQL: :Inserver::ARRAY 。 否 则 返回 假 。 


42.4. PL/Perl 里 的 全 局 变量 


你 可 以 利用 全 局 散 列 %_sHARED 保存 数据 ， 包 括 代码 引用 ， 持续 时 间 可 以 达到 当前 会 话 的 生命 
期 。 


下 面 是 一 个 共享 数据 的 例子 : 


CREATE OR REPLACE FUNCTION set_var(name text, val text) RETURNS text AS $$ 
if ($_SHARED{$_[0]} = $_[1]) { 
return 'ok'; 
} else { 
return "cannot set shared variable $_[0] to $_[1]"; 


} 
$$ LANGUAGE plper1; 


CREATE OR REPLACE FUNCTION get_var(name text) RETURNS text AS $$ 
return $ SHARED{$ [0]}; 
$$ LANGUAGE plper1; 


SELECT set_var('sample', ‘Hello, PL/Perl! How''s tricks?'); 
SELECT get_var('sample'); 


下 面 是 一 个 使 用 代码 引用 的 稍微 复 来 些 的 例子 : 


CREATE OR REPLACE FUNCTION myfuncs() RETURNS void AS $$ 
$_SHARED{myquote} = sub { 
my $arg = shift; 
$arg =~ S/(['\\])/\\$1/g; 
return "'$arg'"; 


J}; 

$$ LANGUAGE plperl; 

SELECT myfuncs(); /* #S4(EmR */ 

/* #0 —MER S| ARR */ 

CREATE OR REPLACE FUNCTION use_quote(TEXT) RETURNS text AS $$ 
my $text_to_quote = shift; 
my $qfunc = $_SHARED{myquote}; 


return &$qfunc($text_to_quote); 
$$ LANGUAGE plper1; 


如 果 不 在 乎 易 读 性 ， 你 可 以 用 一 行 return $_SHARED{myquote}-agt;($_[0]); 代替 上 面 的 三 行 。 


为 了 安全 原因 ，PL/Penl 通 过 一 个 SQL 角色 在 一 个 单独 为 这 个 角色 的 解释 器 里 执行 丁 数 调用 。 
这 阻止 了 有 另 一 个 用 户 的 PL/Perl 函 数 的 表现 的 用 户 的 悉 意 干扰 或 事故 。 每 个 这 样 的 解释 器 有 
它 自己 的 %_sHARED 变量 值 和 其 他 全 局 状态 。 因 此 ， 当 且 仅 当 通 过 相同 的 SQL 角色 执行 时 ， 
两 个 PL/Perl 函 数 才 将 分 享 相同 的 %_sHARED 值 。 在 多 个 SQL 角色 下 ， 只 有 一 个 会 话 执行 代码 
的 应 用 中 (通过 sEcuRITY DEFINER PHAM, (EA set RoLE 等 ) , 可 能 需要 采取 明确 的 步骤 保证 
PL/Perl 范 数 可 以 通过 %_sHARED 分 享 数 据 。 要 做 到 这 点 ， 确 保 应 该 沟通 的 函数 是 由 相同 的 用 
户 所 有 的 ， 并 且 标 记 他 们 为 SECURITY DEFINER o 当然 必须 要 注意 这 样 的 函数 不 能 用 来 做 意料 
之 外 的 事情 。 


42.5. 可 信 的 和 不 可 信 的 PL/Perl 


通常 ，PL/Perl 是 作为 一 种 叫 plperl 的 "可 信 " 编 程 语言 安装 的 。 在 这 种 设置 中 ， 为 了 保持 安 
全 ， 某 些 Perl 操作 被 关闭 掉 了 。 通 常 ， 受 限制 的 操作 都 是 那些 和 环境 相互 交互 的 动作 。 这 包 
括 文件 句柄 操作 、 require 、 use (对 于 外 部 模块 )。 没有 办 法 访问 数据 库 服务 器 进程 内 部 或 
者 获取 具有 服务 器 进程 权限 的 OS 级 别 的 访问 ， 就 像 C 函数 那样 。 因此 ， 任 何 非特 权 的 数据 
库 用 户 都 可 以 允许 使 用 这 种 语言 。 


这 里 是 一 个 无 法 运转 的 函数 的 例子 ， 因 为 出 于 安全 原因 ， 文 件 系统 的 操作 是 不 允许 的 : 


CREATE FUNCTION badfunc() RETURNS integer AS $$ 
my $tmpfile = "/tmp/badfile"; 
open my $fh, '>', $tmpfile 
or elog(ERROR, gqq{could not open the file "$tmpfile": $!}); 
print $fh "Testing writing to a file\n"; 
close $fh or elog(ERROR, qq{could not close the file "$tmpfile": $!}); 
return 1; 
$$ LANGUAGE plper1; 


创建 这 个 函数 将 会 失败 ， 因 为 它 使 用 的 非法 调用 将 会 被 验证 器 捕获 。 


有 时 候 想 写 不 受 限制 的 Perl 函数 。 比 如 ， 可 能 需要 一 个 能 发 送 邮 件 的 Perl 函数 。 为 了 义理 这 
种 情况 ， PL/Perl 也 可 以 安装 为 "不 可 信 的 "的 语言 PL/PerlU。 在 这 种 情况 下 ， 可 以 使 用 完整 的 
Perl 语言 。 当 安装 这 个 语言 时 ， plperlu 这 个 名 字 可 以 选取 不 可 信和 的 PL/Perl 变种 。 


PL/PerlU 画 数 的 作者 必须 注意 不 能 把 该 本 数 用 于 做 任何 不 想 做 的 事情 ， 因为 它 可 以 干 任何 数 
据 库 管理 员 能 干 的 事情 。 请 注意 数据 库 系 统 只 人 允许 数据 库 超级 用 户 创建 不 可 信 语 言 写 的 孙 
数 。 


如 果 上 面 的 函数 由 超级 用 户 用 plperlu 创建 ， 那 么 执行 就 会 成 功 。 


同样 的 方式 ， 如 果 语言 被 声明 为 plperlu 而 不 是 plperl1 ， 那么 用 Perl 写 的 匿名 代码 块 可 以 使 
用 受 限 制 的 操作 ， 但 是 调用 者 必须 是 超级 用 户 。 


Note: 当 PL/Perl 函 数 在 一 个 单独 的 为 每 个 SQL 用 户 的 Perl 解 释 器 里 运行 时 ， 所 有 的 
PL/PerlU 男 数 在 一 个 单独 的 Perl 解 释 器 里 的 给 定 会 话 中 执行 (不 是 用 于 PL/Perl 范 数 的 那 
个 解释 器 ) 。 这 人 允许 PL/PerlU 函数 自由 的 分 享 数据 ， 但 是 在 PL/Perl 和 PL/PerlU WAZ 
间 不 会 有 通讯 发 生 。 


Note: Perl 在 一 个 进程 中 不 能 支持 多 个 解释 器 ， 除 非 在 编译 时 给 它 适当 的 标 

se usemultiplicity 或 useithreads o ( usemultiplicity 是 首选 的 ， 除 非 你 实际 需要 
使 用 线程 。 获取 更 多 信息 ， 请 参阅 perlembed 手 册页 。) 如 果 PL/Perl 与 一 个 没有 这 样 编 
译 的 Perl 的 副本 一 起 使 用 ， 那 么 每 个 会 话 只 可 能 有 一 个 Perl 解 释 器 ， 所 以 任意 一 个 会 话 
只 能 执行 PL/PerlU 玉 数 ， 或 PL/Perl 玉 数 ， 他 们 都 是 通过 同一 个 SQL 角 色调 用 的 。 


42.6. PL/Perl 触发 器 


PL/Perl FIAARKS SARA AHR, EDA BAH, AISI sto 包含 了 当前 触发 事 
件 的 信息 。 sm 是 一 个 全 局 变量 ， 它 对 于 每 次 触发 器 调用 都 能 够 获取 一 个 局 部 值 。 $_Tp AK 
列 引 用 的 字段 有 : 


$_TD-&gt ; {new} {foo} 
字段 foo 的 NEw 值 

$_TD-agt ; {01d} {foo} 

字段 foo 的 oLp 值 

$_TD-&gt ; {name} 

被 调用 的 触发 器 的 名 字 

$_TD-agt ; {event} 

触发 器 事件 : INSERT , UPDATE , DELETE , TRUNCATE ,或 UNKNOWN 
$_TD-&gt ; {when} 

何 时 调用 触发 器 : BEFORE , AFTER , INSTEAD OF ,或 UNKNOWN 
$_TD-&gt;{flevel} 

触发 器 的 级 别 : ROW, STATEMENT , 5% UNKNOWN 

$_TD-&gt; {relid} 

触发 触发 器 的 表 的 OID 

$_TD-&gt; {table_name} 

触发 触发 器 的 表 的 名 字 

$_TD-&gt; {relname} 

触发 触发 器 的 表 的 名 字 。 已 经 废弃 了 ， 并 且 可 能 在 将 来 的 版 本 中 移 除 。 请 使 用 $_TD-> 
{table_name}。 

$_TD-&gt; {table_schema} 

触发 触发 器 的 表 的 模式 名 

$_TD-&gt; {argc} 

触发 器 函数 的 参数 个 数 


@{$_TD-&gt; {args}} 


fk ABBAS, WR s_Tp-&gt; {argc} 为 0 则 不 存在 。 
行 级 别 的 触发 器 返回 下 列 之 一 : 


return; 


执行 该 操作 


"SKIP" 


不 执行 该 操作 


"MODIFY" 
表明 new ITTRA RK ASN AIS at 
下 面 是 一 个 触发 器 画 数 ， 演 示 了 上 面 的 一 些 示 西 。 


CREATE TABLE test ( 
i int, 
v varchar 


Ne 


CREATE OR REPLACE FUNCTION valid_id() RETURNS trigger AS $$ 
if (($_TD->{new}{i} >= 100) || ($_TD->{new}{i} <= 0)) { 
return "SKIP"; # 跳 过 INSERT/UPDATE AS 
} elsif ($_TD->{new}{v} ne "immortal") { 
$_TD->{new}{v} .= "(modified by trigger)"; 
return "MODIFY";  # 修 改 一 行 并 且 执 行 INSERT/UPDATE AD 


} else { 
return; # 执行 INSERT/UPDATE 命 兮 


$$ LANGUAGE plper1; 
CREATE TRIGGER test_valid_id_trig 


BEFORE INSERT OR UPDATE ON test 
FOR EACH ROW EXECUTE PROCEDURE valid_id(); 


42.7. 后 台 PL/Pernl 


42.7.1. Ace 


本 节 列 出 影响 PL/Perl 的 配置 参数 。 
plperl.on_init ( string ) 


指定 当 Perl 触 发 器 第 一 次 初始 化 时 执行 Perl 代 码 ， 在 这 之 前 是 专业 为 了 plperl 或 plperlu 使 
用 的 。 当 这 段 代 码 执行 时 SPI 函 数 是 不 适用 的 。 如 果 代 码 因 错误 而 失败 ， 那么 它 将 退出 解释 器 
的 初始 化 ， 并 且 传 播 错误 到 调用 的 查询 ， 导 致 当前 事务 或 子 事务 退出 。 


Perl 代 码 限 制 为 单个 字符 串 。 更 长 的 代码 可 以 放 入 一 个 模块 ， 并 且 由 on_init 字符 串 加 载 。 例 
F 


plperl.on_init 
plperl.on_init 


"require "plperlinit.p1"' 
"use lib "/my/app"; use MyApp::PgInit;' 


任何 由 plperl.on_init 直接 或 非 直 接 加 载 的 模块 ， 都 将 适用 于 plperl 使 用 。 这 可 能 会 创建 
一 个 安全 风险 。 要 查看 哪个 模块 被 加 载 了 可 以 使 用 : 


DO 'elog(WARNING, join ", ", sort keys %INC)' LANGUAGE plperl; 


如 果 plperl 库 包含 在 shared_preload libraries 里 面 ， 那 么 初始 化 将 在 postmaster 中 发 生 ， 这 种 
情况 下 要 额外 考虑 postmaster 不 稳定 的 风险 。 利 用 这 一 特性 的 首要 原因 是 Perl 模 块 通 

过 plperl.on_init 加 载 需要 在 postmaster 启 动 的 情况 下 ， 并 且 在 个 人 的 数据 库 会 话 中 不 会 有 
额外 开销 加 载 ， 立 即 可 用 。 然 而 ， 请 记 住 ， 额 外 开销 只 是 在 第 一 次 Perl 解 释 器 被 数据 库 会 话 
使 用 的 时 候 避 免 ， 也 就 是 PL/PerlU 或 PL/Perl 是 调用 PL/Perl 函 数 的 第 一 个 SQL 角 色 。 在 一 个 
数据 库 会 话 中 创建 的 任何 额外 的 Perl 解 释 器 必须 重新 执行 plperl.on_init 。 同 样 ， 在 
Windows 上 ， 从 预 加 载 中 不 会 有 任何 节省 ， 因 为 在 postmaster 进 程 中 创建 的 Perl 解 释 器 不 会 
传播 到 子 进 程 。 


这 个 postmaster 只 能 在 postgresql.conf 文件 或 服务 器 命令 行 中 设置 。 
plperl.on_plperl_init ( string ) plperl.on_plperlu_init ( string ) 


这 些 参数 指定 当 Perl 解 释 器 专门 分 别 为 plperl 或 plperlu 时 执行 Perl 代 码 。 当 PL/Per| 或 
PL/PerlU 函 数 在 一 个 数据 库 会 话 中 第 一 次 执行 时 会 发 生 这 种 情况 ， 或 当 一 个 额外 的 解释 器 因 
为 其 他 语言 的 调用 或 一 个 PL/Perl 玉 数 被 一 个 新 的 SQL 角 色调 用 而 创建 时 ， 也 会 发 生 这 种 情 


况 。 这 遵循 任何 由 plperl.on_init 所 做 的 初始 化 。 YinttPerlt} 3a Fis ASPIRA. 
在 plperl.on_plperl_init 里 面 的 Perl 代 码 在 "锁定 "解释 器 后 执行 ， 并 且 因此 只 能 执行 信任 的 
操作 。 


如 果 代 码 因 错 误 而 失败 ， 那 么 它 将 退出 解释 器 的 初始 化 ， 并 且 传播 错误 到 调用 的 查询 ， 导 致 
当前 事务 或 子 事务 退出 。 任何 Perl 已 经 做 的 动作 不 会 回 滚 ; 但 是 ， 那 个 解释 器 将 不 会 再 使 
用 。 如 果 语 言 再 次 被 使 用 ， 那么 初始 化 将 在 一 个 新 的 Perl 解 释 器 中 尝试 。 


只 有 超级 用 户 可 以 改变 这 些 设置 。 尽 管 这 些 设 置 可 以 在 一 个 会 话 中 改变 ， 但 是 这 些 改变 将 不 
会 影响 到 已 经 用 来 执行 琅 数 的 Perl 解 释 器 。 


plperl.use_strict ( boolean ) 


43% 1SPL/PelW RNS Sheet, MAR strict 编译 指示 。 这 个 参数 不 影响 已 经 用 
当前 会 话 编译 过 的 画 数 。 


42.7.2. 限制 及 缺少 的 特性 


下 面 的 特性 目前 还 在 PL/Perl 里 面 缺少 ， 但 是 欢迎 贡献 。 
e PL/Perl 函数 无 法 相互 直接 调用 。 
。 SPI 目前 尚未 完全 实现 。 


。 如 果 你 用 spi_exec_query 抓 取 非 常 大 的 数据 集 ， 你 应 该 明白 这 些 数据 都 会 放 到 内 存 里 。 
你 可 以 用 前 面 演示 的 spi_query / spi_fetchrow 来 避免 这 些 。 


类 似 的 问题 也 会 发 生 在 一 个 返回 集合 的 函数 用 return 给 PostgreSQL 传递 回去 一 个 巨大 
的 行 合 。 你 也 可 以 像 前 面 演 示 的 那样 用 return_next 返回 每 个 返回 行 的 方法 避免 这 个 
问题 。 

。 当 一 个 会 话 正常 结束 时 ， 不 是 因为 一 个 致命 的 错误 而 结束 ， 执 行 任何 已 经 定义 


的 END 块 。 当前 没有 其 他 动作 执行 。 特 别 的 ， 文 件 句柄 不 自动 刷新 并 且 对 象 不 自动 销 
毁 。 
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PL/Python 过 程 语 言 允 许 用 Python 语言 编写 PostgreSQL HR. Python 45. 


要 在 特定 的 数据 库 里 安装 PL/Python， 使 用 CREATE EXTENSION plpythonu ， 或 者 使 用 命令 行 工 
具 createlang plpythonu 数据库 名 称 ” ( 详 见 Section 43.1) o 











M 


Tip: 如 果 一 门 语言 安装 到 了 templates 数据 库 中 ， 那 么 所 有 的 随后 创建 的 数据 库 都 会 


动 的 安装 该 语言 。 








到 目前 为 止 PostgreSQL ， PL/Python 只 能 当成 一 种 "不 可 信任 的 " 语言 ， 意 思 是 他 没有 提供 
任何 限制 用 户 可 为 与 不 可 为 的 手段 ， 因此 他 被 重 命令 为 plpythonu , 可 信任 的 plpython 可 
能 在 将 来 某 个 时 间 能 够 获得 if a new secure execution mechanism is developed in Python. 
The writer of a function in untrusted PL/Python must take care that the function cannot be 
used to do anything unwanted, since it will be able to do anything that could be done by a 
user logged in as the database administrator. Only superusers can create functions in 
untrusted languages such as plpythonu . 


PostgreSQL 中 文 文档 9.3 


Note: Users of source packages must specially enable the build of PL/Python during 
the installation process. (Refer to the installation instructions for more information.) 
Users of binary packages might find PL/Python in a separate subpackage. 
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43.1. Python 2 vs. Python 3 


PL/Python supports both the Python 2 and Python 3 language variants. (The PostgreSQL 
installation instructions might contain more precise information about the exact supported 
minor versions of Python.) Because the Python 2 and Python 3 language variants are 
incompatible in some important aspects, the following naming and transitioning scheme is 
used by PL/Python to avoid mixing them: 


e The PostgreSQL language named plpython2u implements PL/Python based on the 
Python 2 language variant. 


e The PostgreSQL language named plpython3u implements PL/Python based on the 
Python 3 language variant. 


e The language named plpythonu implements PL/Python based on the default Python 
language variant, which is currently Python 2. (This default is independent of what any 
local Python installations might consider to be their "default", for example, what 

/usr/bin/python might be.) The default will probably be changed to Python 3 ina 
distant future release of PostgreSQL, depending on the progress of the migration to 
Python 3 in the Python community. 


This scheme is analogous to the recommendations in PEP 394 regarding the naming and 
transitioning of the python command. 


It depends on the build configuration or the installed packages whether PL/Python for 
Python 2 or Python 3 or both are available. 


Tip: The built variant depends on which Python version was found during the 
installation or which version was explicitly set using the PYTHON environment variable; 
see Section 15.4. To make both variants of PL/Python available in one installation, the 
source tree has to be configured and built twice. 


This results in the following usage and migration strategy: 


e Existing users and users who are currently not interested in Python 3 use the language 
name plpythonu and don't have to change anything for the foreseeable future. It is 
recommended to gradually "future-proof" the code via migration to Python 2.6/2.7 to 
simplify the eventual migration to Python 3. 


In practice, many PL/Python functions will migrate to Python 3 with few or no changes. 


e Users who know that they have heavily Python 2 dependent code and don't plan to ever 
change it can make use of the plpython2u language name. This will continue to work 
into the very distant future, until Python 2 support might be completely dropped by 
PostgreSQL. 


e Users who want to dive into Python 3 can use the plpython3u language name, which 
will keep working forever by today's standards. In the distant future, when Python 3 
might become the default, they might like to remove the "3" for aesthetic reasons. 


e Daredevils, who want to build a Python-3-only operating system environment, can 
change the contents of pg_pltemplate to make plpythonu be equivalent to 
plpython3u , keeping in mind that this would make their installation incompatible with 
most of the rest of the world. 


See also the document What's New In Python 3.0 for more information about porting to 
Python 3. 


It is not allowed to use PL/Python based on Python 2 and PL/Python based on Python 3 in 
the same session, because the symbols in the dynamic modules would clash, which could 
result in crashes of the PostgreSQL server process. There is a check that prevents mixing 
Python major versions in a session, which will abort the session if a mismatch is detected. It 
is possible, however, to use both PL/Python variants in the same database, from separate 
sessions. 


43.2. PL/Python Functions 


Functions in PL/Python are declared via the standard CREATE FUNCTION syntax: 


CREATE FUNCTION _funcname_ (_argument-list_) 
RETURNS _return-type_ 

AS $$ 
# PL/Python function body 

$$ LANGUAGE plpythonu; 


The body of a function is simply a Python script. When the function is called, its arguments 
are passed as elements of the list args ; named arguments are also passed as ordinary 
variables to the Python script. Use of named arguments is usually more readable. The result 
is returned from the Python code in the usual way, with return or yield (in case of a 
result-set statement). If you do not provide a return value, Python returns the default None . 
PL/Python translates Python's None into the SQL null value. 


For example, a function to return the greater of two integers can be defined as: 


CREATE FUNCTION pymax (a integer, b integer) 
RETURNS integer 
AS $$ 
if a> b: 
return a 
return b 
$$ LANGUAGE plpythonu; 


The Python code that is given as the body of the function definition is transformed into a 
Python function. For example, the above results in: 


def __plpython_procedure_pymax_23456(): 
if a> b: 
return a 
return b 


assuming that 23456 is the OID assigned to the function by PostgreSQL. 


The arguments are set as global variables. Because of the scoping rules of Python, this has 
the subtle consequence that an argument variable cannot be reassigned inside the function 
to the value of an expression that involves the variable name itself, unless the variable is 
redeclared as global in the block. For example, the following won't work: 


CREATE FUNCTION pystrip(x text) 
RETURNS text 

AS $$ 
x = x.strip() # error 
return x 

$$ LANGUAGE plpythonu; 


because assigning to x makes x a local variable for the entire block, and so the x on 
the right-hand side of the assignment refers to a not-yet-assigned local variable x , not the 
PL/Python function parameter. Using the global statement, this can be made to work: 


CREATE FUNCTION pystrip(x text) 
RETURNS text 

AS $$ 
global x 
x = x.strip() # ok now 
return x 

$$ LANGUAGE plpythonu; 


But it is advisable not to rely on this implementation detail of PL/Python. It is better to treat 
the function parameters as read-only. 


43.3. Data Values 


Generally speaking, the aim of PL/Python is to provide a "natural" mapping between the 
PostgreSQL and the Python worlds. This informs the data mapping rules described below. 


43.3.1. Data Type Mapping 
Function arguments are converted from their PostgreSQL type to a corresponding Python 
type: 

e PostgreSQL boolean is converted to Python bool . 


e PostgreSQL smallint and int are converted to Python int . PostgreSQL bigint 
and oid are converted to long in Python 2 and to int in Python 3. 


e PostgreSQL real, double , and numeric are converted to Python float . Note that 
for the numeric this loses information and can lead to incorrect results. This might be 
fixed in a future release. 


e PostgreSQL bytea is converted to Python str in Python 2 and to bytes in Python 3. 


In Python 2, the string should be treated as a byte sequence without any character 
encoding. 


e All other data types, including the PostgreSQL character string types, are converted to a 


Python str . In Python 2, this string will be in the PostgreSQL server encoding; in 
Python 3, it will be a Unicode string like all strings. 


e For nonscalar data types, see below. 


Function return values are converted to the declared PostgreSQL return data type as 
follows: 


e When the PostgreSQL return type is boolean , the return value will be evaluated for 
truth according to the Python rules. That is, 0 and empty string are false, but notably 
'f' is true. 


e When the PostgreSQL return type is bytea , the return value will be converted to a 
string (Python 2) or bytes (Python 3) using the respective Python built-ins, with the 
result being converted bytea . 


e For all other PostgreSQL return types, the returned Python value is converted to a string 


using the Python built-in str , and the result is passed to the input function of the 
PostgreSQL data type. 


Strings in Python 2 are required to be in the PostgreSQL server encoding when they are 
passed to PostgreSQL. Strings that are not valid in the current server encoding will 
raise an error, but not all encoding mismatches can be detected, so garbage data can 
still result when this is not done correctly. Unicode strings are converted to the correct 
encoding automatically, so it can be safer and more convenient to use those. In Python 
3, all strings are Unicode strings. 


e For nonscalar data types, see below. 


Note that logical mismatches between the declared PostgreSQL return type and the Python 
data type of the actual return object are not flagged; the value will be converted in any case. 


43.3.2. Null, None 


If an SQL null value is passed to a function, the argument value will appear as None in 
Python. For example, the function definition of pymax shown in Section 43.2 will return the 
wrong answer for null inputs. We could add strict to the function definition to make 
PostgreSQL do something more reasonable: if a null value is passed, the function will not be 
called at all, but will just return a null result automatically. Alternatively, we could check for 
null inputs in the function body: 


CREATE FUNCTION pymax (a integer, b integer) 
RETURNS integer 
AS $$ 
if (a is None) or (b is None): 
return None 
if a> bD: 
return a 
return b 
$$ LANGUAGE plpythonu; 


As shown above, to return an SQL null value from a PL/Python function, return the value 
None . This can be done whether the function is strict or not. 


43.3.3. Arrays, Lists 


SQL array values are passed into PL/Python as a Python list. To return an SQL array value 
out of a PL/Python function, return a Python sequence, for example a list or tuple: 


CREATE FUNCTION return_arr() 
RETURNS int[] 

AS $$ 

return (1, 2, 3, 4, 5) 

$$ LANGUAGE plpythonu; 


SELECT return_arr(); 
return_arr 


{1,2,3,4,5} 
(1 row) 


Note that in Python, strings are sequences, which can have undesirable effects that might 
be familiar to Python programmers: 


CREATE FUNCTION return_str_arr() 
RETURNS varchar[] 

AS $$ 

return "hello" 

$$ LANGUAGE plpythonu; 


SELECT return_str_arr(); 
return_str_arr 


43.3.4. Composite Types 


Composite-type arguments are passed to the function as Python mappings. The element 
names of the mapping are the attribute names of the composite type. If an attribute in the 
passed row has the null value, it has the value None in the mapping. Here is an example: 


CREATE TABLE employee ( 
name text, 

salary integer, 

age integer 


) 


CREATE FUNCTION overpaid (e employee) 
RETURNS boolean 
AS $$ 
if e["salary"] > 200000: 
return True 
if (e["age"] < 30) and (e["salary"] > 100000): 
return True 
return False 
$$ LANGUAGE plpythonu; 


There are multiple ways to return row or composite types from a Python function. The 
following examples assume we have: 


CREATE TYPE named_value AS ( 
name text, 
value integer 


ye 


A composite result can be returned as a: 
Sequence type (a tuple or list, but not a set because it is not indexable) 


Returned sequence objects must have the same number of items as the composite result 
type has fields. The item with index 0 is assigned to the first field of the composite type, 1 to 
the second and so on. For example: 


CREATE FUNCTION make_pair (name text, value integer) 
RETURNS named_value 
AS $$ 
return [ name, value ] 
# or alternatively, as tuple: return ( name, value ) 
$$ LANGUAGE plpythonu; 


To return a SQL null for any column, insert None at the corresponding position. 
Mapping (dictionary) 


The value for each result type column is retrieved from the mapping with the column name 
as key. Example: 


CREATE FUNCTION make_pair (name text, value integer) 
RETURNS named_value 

AS $$ 
return { "name": name, "value": value } 

$$ LANGUAGE plpythonu; 


Any extra dictionary key/value pairs are ignored. Missing keys are treated as errors. To 
return a SQL null value for any column, insert None with the corresponding column name as 
the key. 


Object (any object providing method _ getattr ) 


This works the same as a mapping. Example: 


CREATE FUNCTION make_pair (name text, value integer) 
RETURNS named_value 
AS $$ 
class named_value: 
def _init__ (self, n, V): 
self.name = n 
self.value = v 
return named_value(name, value) 


# or simply 
class nv: pass 
nv.name = name 
nv.value = value 
return nv 

$$ LANGUAGE plpythonu; 


Functions with out parameters are also supported. For example: 


CREATE FUNCTION multiout_simple(OUT i integer, OUT j integer) AS $$ 
return (1, 2) 
$$ LANGUAGE plpythonu; 


SELECT * FROM multiout_simple(); 


43.3.5. Set-returning Functions 


A PL/Python function can also return sets of scalar or composite types. There are several 
ways to achieve this because the returned object is internally turned into an iterator. The 
following examples assume we have composite type: 


CREATE TYPE greeting AS ( 
how text, 
who text 


Ne 


A set result can be returned from a: 
Sequence type (tuple, list, set) 


CREATE FUNCTION greet (how text) 

RETURNS SETOF greeting 
AS $$ 

# return tuple containing lists as composite types 

# all other combinations work also 

return ( [ how, "World" ], [ how, "PostgreSQL" ], [ how, "PL/Python" ] ) 
$$ LANGUAGE plpythonu; 


Iterator (any object providing _iter__ and next methods) 


CREATE FUNCTION greet (how text) 
RETURNS SETOF greeting 
AS $$ 
class producer: 
def _init__ (self, how, who): 


self.how = how 
self.who = who 
self.ndx = -1 


def _iter__ (self): 
return self 


def next (self): 
self.ndx += 1 
if self.ndx == len(self.who): 
raise StopIteration 
return ( self.how, self.who[self.ndx] ) 


return producer(how, [ "World", "PostgreSQL", "PL/Python" ]) 
$$ LANGUAGE plpythonu; 


Generator ( yield ) 


CREATE FUNCTION greet (how text) 
RETURNS SETOF greeting 
AS $$ 
for who in [ "World", "PostgreSQL", "PL/Python" ]: 
yield ( how, who ) 
$$ LANGUAGE plpythonu; 


Warning 


Due to Python bug #1483133, some debug versions of Python 2.4 (configured and 

compiled with option --with-pydebug ) are known to crash the PostgreSQL server when 
using an iterator to return a set result. Unpatched versions of Fedora 4 contain this bug. 
It does not happen in production versions of Python or on patched versions of Fedora 4. 


Set-returning functions with ouT parameters (using RETURNS SETOF record ) are also 
supported. For example: 


CREATE FUNCTION multiout_simple_setof(n integer, OUT integer, OUT integer) RETURNS SETOF 
return [(1, 2)] * n 
$$ LANGUAGE plpythonu; 


SELECT * FROM multiout_simple_setof(3); 


SS ee 





43.4. Sharing Data 


The global dictionary sp is available to store data between function calls. This variable is 
private static data. The global dictionary cp is public data, available to all Python functions 
within a session. Use with care. 


Each function gets its own execution environment in the Python interpreter, so that global 
data and function arguments from myfunc are not available to myfunc2 . The exception is 
the data inthe ep dictionary, as mentioned above. 


43.5. Anonymous Code Blocks 


PL/Python also supports anonymous code blocks called with the DO statement: 


DO $$ 
# PL/Python code 
$$ LANGUAGE plpythonu; 


An anonymous code block receives no arguments, and whatever value it might return is 
discarded. Otherwise it behaves just like a function. 


43.6. Trigger Functions 


When a function is used as a trigger, the dictionary TD contains trigger-related values: 


TD["event"] 


contains the event as a string: INSERT , UPDATE , DELETE , Of TRUNCATE . 


TD[ "when" ] 


contains one of BEFORE , AFTER , OF INSTEAD OF . 


TD["level"] 


contains RoW OF STATEMENT . 

TD["new"] > TD["old"] 

For a row-level trigger, one or both of these fields contain the respective trigger rows, 
depending on the trigger event. 


TD["name" 


contains the trigger name. 


TD["table_name" ] 


contains the name of the table on which the trigger occurred. 


TD["table_schema" ] 


contains the schema of the table on which the trigger occurred. 
TD["relid"] 

contains the OID of the table on which the trigger occurred. 
TD["args"] 


If the CREATE TRIGGER command included arguments, they are available in tTo["args"][o] to 


TD["args"][~°_n_ -1]. 


If TD["when"] iS BEFORE Or INSTEAD OF and TD["level"] iS Row ,you can return None or 
"ok" from the Python function to indicate the row is unmodified, "skip" to abort the event, 
or if TD["event"] iS INSERT Or UPDATE you can return "MoDIFY" to indicate you've 
modified the new row. Otherwise the return value is ignored. 


43.7. Database Access 


The PL/Python language module automatically imports a Python module called plpy . The 
functions and constants in this module are available to you in the Python code as 
plpy. ” ~_foo_ 


43.7.1. Database Access Functions 


The plpy module provides several functions to execute database commands: 
plpy. execute (``_query_ [, _max-rows_ ]) 


Calling plpy.execute with a query string and an optional row limit argument causes that 
query to be run and the result to be returned in a result object. 


The result object emulates a list or dictionary object. The result object can be accessed by 
row number and column name. For example: 


rv = plpy.execute("SELECT * FROM my_table", 5) 


returns up to 5 rows from my_table . If my_table has a column my_column , it would be 
accessed as: 


foo = rv[i]["my_column"] 


The number of rows returned can be obtained using the built-in len function. 
The result object has these additional methods: 
nrows (Y 


Returns the number of rows processed by the command. Note that this is not necessarily the 
same as the number of rows returned. For example, an uppaTE command will set this value 
but won't return any rows (unless RETURNING is used). 


“status (Y 
The spi_execute() return value. 
colnames`()```coltypes`()` coltypmods () 


Return a list of column names, list of column type OIDs, and list of type-specific type 
modifiers for the columns, respectively. 


These methods raise an exception when called on a result object from a command that did 
not produce a result set, e.g., UPDATE without RETURNING , Or DROP TABLE . But it is OK to 
use these methods on a result set containing zero rows. 


-SE (y 


The standard _str_ method is defined so that it is possible for example to debug query 


execution results using plpy.debug(rv) . 
The result object can be modified. 


Note that calling plpy.execute will cause the entire result set to be read into memory. Only 
use that function when you are sure that the result set will be relatively small. If you don't 
want to risk excessive memory usage when fetching large results, use plpy.cursor rather 


than plpy.execute 


plpy. prepare (``_query_ |, _argtypes_ ]) plpy. execute (``_plan_ [, _arguments_ [, 


_max-rows_ ]]) 


plpy.prepare prepares the execution plan for a query. It is called with a query string and a 
list of parameter types, if you have parameter references in the query. For example: 


plan = plpy.prepare("SELECT last_name FROM my_users WHERE first_name = $1", ["text"]) 


text is the type of the variable you will be passing for $1 . The second argument is 
optional if you don't want to pass any parameters to the query. 


After preparing a statement, you use a variant of the function plpy.execute to run it: 


rv = plpy.execute(plan, ["name"], 5) 


Pass the plan as the first argument (instead of the query string), and a list of values to 
substitute into the query as the second argument. The second argument is optional if the 
query does not expect any parameters. The third argument is the optional row limit as 
before. 


Query parameters and result row fields are converted between PostgreSQL and Python data 
types as described in Section 43.3. The exception is that composite types are currently not 
supported: They will be rejected as query parameters and are converted to strings when 
appearing in a query result. As a workaround for the latter problem, the query can 
sometimes be rewritten so that the composite type result appears as a result row rather than 
as a field of the result row. Alternatively, the resulting string could be parsed apart by hand, 
but this approach is not recommended because it is not future-proof. 


When you prepare a plan using the PL/Python module it is automatically saved. Read the 
SPI documentation (Chapter 44) for a description of what this means. In order to make 
effective use of this across function calls one needs to use one of the persistent storage 
dictionaries sp or GD (see Section 43.4). For example: 


CREATE FUNCTION usesavedplan() RETURNS trigger AS $$ 
plan = SD.setdefault("plan", plpy.prepare("SELECT 1")) 
# rest of function 

$$ LANGUAGE plpythonu; 


plpy. Cursor (**_query_ ) plpy. Cursor (**_plan_ [, _arguments_ ]) 


The plpy.cursor function accepts the same arguments as plpy.execute (except for the 
row limit) and returns a cursor object, which allows you to process large result sets in 
smaller chunks. As with plpy.execute , either a query string or a plan object along with a list 
of arguments can be used. 


The cursor object provides a fetch method that accepts an integer parameter and returns 
a result object. Each time you call fetch , the returned object will contain the next batch of 
rows, never larger than the parameter value. Once all rows are exhausted, fetch starts 
returning an empty result object. Cursor objects also provide an iterator interface, yielding 
one row at a time until all rows are exhausted. Data fetched that way is not returned as 
result objects, but rather as dictionaries, each dictionary corresponding to a single result row. 


An example of two ways of processing data from a large table is: 


CREATE FUNCTION count_odd_iterator() RETURNS integer AS $$ 
odd = 0 
for row in plpy.cursor("select num from largetable"): 
if row['num'] % 2: 
odd += 1 
return odd 
$$ LANGUAGE plpythonu; 


CREATE FUNCTION count_odd_fetch(batch_size integer) RETURNS integer AS $$ 
odd = 0 
cursor = plpy.cursor("select num from largetable") 
while True: 
rows = cursor.fetch(batch_size) 
if not rows: 
break 
for row in rows: 
if row['num'] % 2: 
odd += 1 
return odd 
$$ LANGUAGE plpythonu; 


CREATE FUNCTION count_odd_prepared() RETURNS integer AS $$ 
odd = 0 

plan 
rows 


= plpy.prepare("select num from largetable where num % $1 &lt;&gt; 0", ["integer"]) 
= list(plpy.cursor(plan, [2])) 

return len(rows) 

$$ LANGUAGE plpythonu; 








Cursors are automatically disposed of. But if you want to explicitly release all resources held 
by acursor, use the close method. Once closed, a cursor cannot be fetched from 
anymore. 


Tip: Do not confuse objects created by plpy.cursor with DB-API cursors as defined by 
the Python Database API specification. They don't have anything in common except for 
the name. 


43.7.2. Trapping Errors 


Functions accessing the database might encounter errors, which will cause them to abort 
and raise an exception. Both plpy.execute and plpy.prepare can raise an instance of a 
subclass of plpy.sPIError , which by default will terminate the function. This error can be 
handled just like any other Python exception, by using the try/except construct. For 
example: 


CREATE FUNCTION try_adding_joe() RETURNS text AS $$ 
try: 
plpy.execute("INSERT INTO users(username) VALUES ('joe')") 
except plpy.SPIError: 
return "something went wrong" 
else: 
return "Joe added" 
$$ LANGUAGE plpythonu; 


The actual class of the exception being raised corresponds to the specific condition that 
caused the error. Refer to Table A-1 for a list of possible conditions. The module 
plpy.spiexceptions defines an exception class for each PostgreSQL condition, deriving 
their names from the condition name. For instance, division_by_zero becomes 
DivisionByZero , unique_violation becomes UniqueViolation , fdw_error becomes 
FdwError , and so on. Each of these exception classes inherits from spierror . This 
separation makes it easier to handle specific errors, for instance: 


CREATE FUNCTION insert_fraction(numerator int, denominator int) RETURNS text AS $$ 
from plpy import spiexceptions 
try: 
plan = plpy.prepare("INSERT INTO fractions (frac) VALUES ($1 / $2)", ["int", "int"]) 
plpy.execute(plan, [numerator, denominator] ) 
except spiexceptions.DivisionByZero: 
return "denominator cannot equal zero" 
except spiexceptions.UniqueViolation: 
return "already have that fraction" 
except plpy.SPIError, e: 
return "other error, SQLSTATE %s" % e.sqlstate 
else: 
return "fraction inserted" 
$$ LANGUAGE plpythonu; 
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Note that because all exceptions from the plpy.spiexceptions module inherit from 
SPIError , an except Clause handling it will catch any database access error. 


As an alternative way of handling different error conditions, you can catch the SPIError 
exception and determine the specific error condition inside the except block by looking at 
the sqlstate attribute of the exception object. This attribute is a string value containing the 
"SQLSTATE" error code. This approach provides approximately the same functionality 


43.8. Explicit Subtransactions 


Recovering from errors caused by database access as described in Section 43.7.2 can lead 
to an undesirable situation where some operations succeed before one of them fails, and 
after recovering from that error the data is left in an inconsistent state. PL/Python offers a 
solution to this problem in the form of explicit subtransactions. 


43.8.1. Subtransaction Context Managers 


Consider a function that implements a transfer between two accounts: 


CREATE FUNCTION transfer_funds() RETURNS void AS $$ 
try: 
plpy.execute("UPDATE accounts SET balance 
plpy.execute("UPDATE accounts SET balance 
except plpy.SPIError, e: 
result = "error transferring funds: %s" % e.args 
else: 
result = "funds transferred correctly" 
plan = plpy.prepare("INSERT INTO operations (result) VALUES ($1)", ["text"]) 
plpy.execute(plan, [result]) 
$$ LANGUAGE plpythonu; 


EE E] 


balance - 100 WHERE account_name 
balance + 100 WHERE account_name 


'joe'" 
'mary' 





If the second uppate statement results in an exception being raised, this function will report 
the error, but the result of the first UPDATE_ will nevertheless be committed. In other words, 
the funds will be withdrawn from Joe's account, but will not be transferred to Mary's account. 


To avoid such issues, you can wrap your plpy.execute calls in an explicit subtransaction. 
The plpy module provides a helper object to manage explicit subtransactions that gets 
created with the plpy.subtransaction() function. Objects created by this function implement 
the context manager interface. Using explicit subtransactions we can rewrite our function as: 


CREATE FUNCTION transfer_funds2() RETURNS void AS $$ 
try: 
with plpy.subtransaction(): 
plpy.execute("UPDATE accounts SET balance 
plpy.execute("UPDATE accounts SET balance 
except plpy.SPIError, e: 
result = "error transferring funds: %s" % e.args 
else: 
result = "funds transferred correctly" 
plan = plpy.prepare("INSERT INTO operations (result) VALUES ($1)", ["text"]) 
plpy.execute(plan, [result]) 
$$ LANGUAGE plpythonu; 


balance - 100 WHERE account_name 
balance + 100 WHERE account_name 











Note that the use of try/catch is still required. Otherwise the exception would propagate to 
the top of the Python stack and would cause the whole function to abort with a PostgreSQL 
error, so that the operations table would not have any row inserted into it. The 
subtransaction context manager does not trap errors, it only assures that all database 
operations executed inside its scope will be atomically committed or rolled back. A rollback 
of the subtransaction block occurs on any kind of exception exit, not only ones caused by 
errors originating from database access. A regular Python exception raised inside an explicit 
subtransaction block would also cause the subtransaction to be rolled back. 


43.8.2. Older Python Versions 


Context managers syntax using the with keyword is available by default in Python 2.6. If 
using PL/Python with an older Python version, it is still possible to use explicit 
subtransactions, although not as transparently. You can call the subtransaction manager's 

_enter and _exit__ functions using the enter and exit convenience aliases. The 
example function that transfers funds could be written as: 


CREATE FUNCTION transfer_funds_old() RETURNS void AS $$ 
try: 
subxact = plpy.subtransaction() 
subxact.enter() 
try: 
plpy.execute("UPDATE accounts SET balance 
plpy.execute("UPDATE accounts SET balance 
except: 
import sys 
subxact.exit(*sys.exc_info()) 
raise 
else: 
subxact.exit(None, None, None) 
except plpy.SPIError, e: 
result = "error transferring funds: %s" % e.args 
else: 
result = "funds transferred correctly" 


balance - 100 WHERE account_name 
balance + 100 WHERE account_name 


plan = plpy.prepare("INSERT INTO operations (result) VALUES ($1)", ["text"]) 
plpy.execute(plan, [result]) 
$$ LANGUAGE plpythonu; 


a 





Note: Although context managers were implemented in Python 2.5, to use the with 
syntax in that version you need to use a future statement. Because of implementation 
details, however, you cannot use future statements in PL/Python functions. 


43.9. Utility Functions 


The plpy module also provides the functions plpy.debug(**_msg_ ), plpy.log(**_msg_ ), 

plpy.info(**_msg_ ), plpy.notice(~~_msg_ ), plpy.warning(**_msg_ ), plLpy,error( ~_msg_ ), 
and plpy.fatal(**_msg_ ). plpy.error and plpy.fatal actually raise a Python exception 
which, if uncaught, propagates out to the calling query, causing the current transaction or 
subtransaction to be aborted. raise plpy.Error(**_msg_ ) and raise plpy.Fatal(**_msg_ ) 
are equivalent to calling plpy.error and plpy.fatal , respectively. The other functions only 
generate messages of different priority levels. Whether messages of a particular priority are 
reported to the client, written to the server log, or both is controlled by the 
log_min_messages and client_min_messages configuration variables. See Chapter 18 for 
more information. 


Another set of utility functions are plpy.quote_literal(**_string_ ), 
plpy.quote_nullable(**_string_ ), and plpy.quote_ident(**_string_ ). They are equivalent 
to the built-in quoting functions described in Section 9.4. They are useful when constructing 

ad-hoc queries. A PL/Python equivalent of dynamic SQL from Example 40-1 would be: 


plpy.execute("UPDATE tbl SET %s = %s WHERE key = %s" % ( 
plpy.quote_ident(colname), 
plpy.quote_nullable(newvalue), 
plpy.quote_literal(keyvalue) )) 


43.10. Environment Variables 


Some of the environment variables that are accepted by the Python interpreter can also be 
used to affect PL/Python behavior. They would need to be set in the environment of the main 
PostgreSQL server process, for example in a start script. The available environment 
variables depend on the version of Python; see the Python documentation for details. At the 
time of this writing, the following environment variables have an affect on PL/Python, 
assuming an adequate Python version: 


@ PYTHONHOME 

@ PYTHONPATH 

@ PYTHONY2K 

@ PYTHONOPTIMIZE 

@ PYTHONDEBUG 

@ PYTHONVERBOSE 

@ PYTHONCASEOK 

@ PYTHONDONTWRITEBYTECODE 
@ PYTHONIOENCODING 
@ PYTHONUSERBASE 

@ PYTHONHASHSEED 


(lt appears to be a Python implementation detail beyond the control of PL/Python that some 
of the environment variables listed on the python man page are only effective ina 
command-line interpreter and not an embedded Python interpreter.) 


Chapter 44. 服务 器 编程 接口 


Table of Contents 
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SP|_connect -- 把 一 个 过 程 与 SPI 管理 器 连接 起 来 

SPI_finish -- 把 一 个 过 程 与 SPI 管理 器 断 开 

SPI_push -- 对 SPI 堆栈 进行 压 栈 操作 以 允许 递归 的 SPI 使 用 

SPI_pop -- 弹出 SPI 堆栈 以 从 递归 的 SPI 使 用 中 返回 

SPI_execute -- 执行 一 条 命 兮 

SPI_exec -- 执行 一 个 读 / 写 命令 

SPI_execute_with_args -- 执行 一 个 带 有 外 联 参数 的 命令 

SPI_prepare -- 准备 一 个 规划 但 不 立即 执行 它 

SPI_prepare_cursor -- 准备 一 个 语句 但 不 立即 执行 它 

SPI_prepare_params -- 准备 一 个 语句 但 不 立即 执行 它 

SPI_getargcount -- 返回 一 个 sPI_prepare 准备 的 已 准备 好 语句 需要 的 参数 个 数 
SPI_getargtypeid -- 返回 sPI_prepare 准备 的 已 准备 好 语句 的 参数 的 数据 类 型 OID 
SPI_is_cursor_plan -- 如 果 一 个 spI_prepare 准备 的 语句 可 以 和 sPI_cursor_open 一 
起 使 用 ， 则 返回 true 

SPI_execute_plan -- 执行 一 个 sPI_prepare 准备 的 语句 
SPI_execute_plan_with_paramlist -- 执行 一 个 sPI_prepare 准备 的 已 准备 好 的 语句 
SPI_execp -- 以 读 / 写 模式 执行 一 个 准备 的 查询 规划 

SPI_cursor open -- 用 spI_prepare 创建 的 语句 设置 一 个 游标 
SPI_cursor_open_with_args -- 使 用 查询 和 参数 设置 一 个 游标 
SPI_cursor_open_with_paramlist -- 使 用 参数 设置 一 个 游标 

SPl_cursor_find -- 用 名 字 寻 找 并 执行 一 个 现存 的 游标 

SPI_cursor_fetch -- 从 一 个 游标 里 抓 取 一 些 行 

SPI_cursor_move -- 移动 一 个 游标 

SPI_scroll_cursor_fetch -- 从 一 个 游标 中 抓 取 一 些 行 

SPI_scroll_cursor_move -- 移动 一 个 游标 

SPI_cursor_close -- 关闭 一 个 游标 

SPI_keepplan -- 保存 一 个 预备 语句 

SPI_saveplan -- 保存 一 个 预备 语句 














e。 44.2. 接口 支持 函数 


o 
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o 
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o 


SPI_fname -- 从 指定 的 字段 编号 判断 字段 名 字 
SPI_fnumber -- 判断 声明 字段 名 的 字段 编号 
SPI_getvalue -- 返回 声明 字段 的 字符 串 值 
SPI_getbinval -- 返回 声明 字段 的 二 进 制 值 
SPI_gettype -- 返回 声明 字段 的 数据 类 型 名 


o SPI_gettypeid -- 返回 声明 字段 的 数据 类 型 OID 
o SPI_getrelname -- 返回 声明 关系 的 名 字 
o SPI_getnspname -- 返回 声明 关系 的 名 字 空 间 
。 44.3. 内 存 管理 
o SPI_palloc -- 在 上 层 执行 器 环境 里 分 配 内 存 
o SPI_repalloc -- 在 上 层 执行 器 环境 里 重新 分 配 内 存 
o SPI_pfree -- 在 上 层 执行 器 环境 里 释放 内 存 
o SPI_copytuple -- 在 上 层 执行 者 环境 里 制作 一 个 行 的 拷 由 
o SPI_returntuple -- 准备 把 一 个 行当 作 Datum 返回 
o SPI_modifytuple -- 通过 蔡 换 一 个 给 出 行 的 选 定 的 字段 创建 一 行 
o SPI freetuple -- 释放 在 上 层 执行 者 环境 里 分 配 的 一 行 
o SPI freetuptable -- 释放 一 个 由 spI_execute 或 者 类 似 的 画 数 创建 的 行 集 
o SPI_freeplan -- 释放 一 个 前 面 保存 的 预备 语句 
。 44.4. 数据 改变 的 可 视 性 
© 44.5. 例子 


服务 器 编程 接口 (SPI) 给 在 用 户 定 义 的 C 函 数 里 面 运 行 SQL 查询 的 能 力 。SQL 是 一 套 接口 函 
数 ， 用 于 简化 对 分 析 器 、 规划 器 和 执行 器 的 访问 。SQL 还 进行 一 些 内 存 管理 的 工作 。 
Note: 过 程 语 言 的 存在 也 提供 了 其 它 的 一 些 在 过 程 里 执行 SQL 命令 的 方法 。 这 些 语言 中 
的 大 部 分 本 身 就 是 基于 SPI 的 ， 因此 这 份 文档 可 能 会 对 那些 语言 的 用 户 同 样 有 帮助 。 








AT ERIS, RE Ai" WR" (function) KKK SPI 接 口 琅 数 ， 用 "过 程 "(procedure) 代表 用 
户 用 SPI 定 义 的 C RX, 


注意 ， 如 果 一 条 通过 SPI 调用 的 命令 失败 ， 那 么 控制 不 会 返回 到 你 的 过 程 中 。 取而代之 的 
是 ， 你 的 过 程 执 行 所 在 的 事务 或 者 子 事务 全 部 回 滚 。 这 一 点 看 起 来 可 能 很 奇怪 ， 因 为 大 多 数 
SPI 函数 的 文档 里 都 有 错误 返回 习惯 。 不 过 ， 那 些 习惯 只 适用 于 在 SPI 酚 数 自己 内 部 检测 到 
的 错误 。 可 以 通过 在 你 自己 的 可 能 失败 的 SPI 调用 周围 建立 一 个 子 事务 的 方法 来 在 错误 之 后 
恢复 控制 。 目前 还 没有 写 这 方面 的 文档 ， 因 为 所 需要 的 机 制 仍然 在 变化 。 


如 果 执 行 成 功 了 ，SPI 画 数 返 回 一 个 非 负 结果 (或 者 通过 返回 一 个 整数 值 或 放 在 全 局 变 
= sprresult 里 ， 像 下 面 描 述 的 那样 )。 出 错时 ， 返 回 一 个 负数 或 NULL 结果 。 


使 用 SPI 的 源 代码 文件 必须 包含 头 文件 executor/spi.h o 
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SPI|_getargtypeid -- 返回 sp1_prepare 准 各 的 已 准备 好 语句 的 参数 的 数据 类 型 OID 
SPI_is_cursor_plan -- 如 果 一 个 spI_prepare 准备 的 语句 可 以 和 spI_cursor_open 一 起 使 
用 ， 则 返回 true 

SPl_execute_plan -- 执行 一 个 sPI_prepare 准备 的 语句 
SPI_execute_plan_with_paramlist -- 执行 一 个 sPI_prepare 准备 的 已 准备 好 的 语句 
SPI_execp -- 以 读 / 写 模式 执行 一 个 准备 的 查询 规划 

SPI_cursor open -- 用 spi_prepare 创建 的 语句 设置 一 个 游标 
SPI_cursor_open_with_args -- 使 用 查询 和 参数 设置 一 个 游标 
SPI_cursor_open_with_paramlist -- 使 用 参数 设置 一 个 游标 

SPI_cursor find -- 用 名 字 寻 找 并 执行 一 个 现存 的 游标 

SPI_cursor_fetch -- 从 一 个 游标 里 抓 取 一 些 行 

SPI_cursor_move -- 移动 一 个 游标 

SPI_scroll_cursor_fetch -- 从 一 个 游标 中 抓 取 一 些 行 

SPI_scroll_cursor_move -- 移动 一 个 游标 

SPI_cursor_close -- 关闭 一 个 游标 

SPI_keepplan -- 保存 一 个 预备 语句 

SPI_saveplan -- 保存 一 个 预备 语句 











SPI connect 


Name 


SPl_connect -- 把 一 个 过 程 与 SPI 管理 器 连接 起 来 


Synopsis 


int SPI_connect(void) 


Fea aah 
sPI_connect 打开 一 个 从 过 程 调用 到 SP 管理 器 的 连接 。 如 果 你 需要 通过 SPI 执行 命令 ， 你 
DOF BART, 有 些 工具 类 SPI 函数 可 以 从 未 连接 的 过 程 中 调用 。 


如 果 你 的 过 程 已 经 连接 了 ， 那 么 spr_connect 将 返回 一 个 SPI ERROR_CONNECT 错 误 信 
息 。 请 注意 如 果 一 个 过 程 已 经 调用 了 sPI_connect 然后 它 直 接 调 用 另外 一 个 又 会 调 

用 spr_connect 的 过 程 的 时 候 也 会 发 生 这 种 问题 。 尽 管 以 一 个 SQL 命令 里 调用 另外 一 个 使 用 
SPI 的 函数 的 形式 对 SPI 管理 器 进行 递归 调用 是 允许 的 ， 但 是 直接 的 府 套 调用 spr_connect 

和 spPI_finish 是 不 允许 的 (不 过 ， 可 以 看 看 spI_push 和 spI_pop )。 


返回 值 


SPI_OK_CONNECT 
成 功 时 
SPI_ERROR_CONNECT 


失败 时 


SPI finish 


Name 


SPI_finish -- 把 一 个 过 程 与 SPI 管理 器 断 开 


Synopsis 


int SPI_finish(void) 


SPI_finish 关闭 一 个 现 有 的 到 SPI 管理 器 的 连接 。 在 完成 你 的 过 程 的 当前 调用 所 必须 的 SPI 
操作 之 后 ， 你 必须 调用 这 个 函数 。 不 过 ， 如 果 你 通过 elog(ERROR) 退出 事务 ， 那么 你 就 不 需 
要 担心 这 件 事 情 。 在 这 种 情况 下 ，SPI 将 自动 清理 干净 。 


如 果 spI_finish 是 在 当前 没有 有 效 连接 的 情况 下 被 调用 的 ， 你 可 能 
个 SPI_ERROR_UNCONNECTED 的 返回 。 这 样 做 没有 什么 根本 性 问题 ， 这 
何事 情 。 


会 得 到 一 
=i 
意 


味 着 SPI 管理 器 不 做 任 


w% lol 


SPI_OK_FINISH 


如 果 正 常 断 开 


SPI_ERROR_UNCONNECTED 


如 果 从 一 个 未 连接 的 过 程 调用 


SPI push 


Name 


SPI_push -- 对 SPI 堆栈 进行 压 栈 操作 以 人 允许 递归 的 SPI 使 用 


Synopsis 


void SPI_push(void) 


fi ah 


在 执行 另外 一 个 可 能 也 使 用 了 SPI 的 过 程 之 前 ， 应 该 调用 spPI_push 。 之 后 ，SPI 不 再 是 "已 
连接 "状态 ， 除 非 再 次 进行 sPI_push ， 否则 SPI 函数 调用 将 被 拒绝 。 这 样 就 保证 了 你 的 过 程 
的 SPI 状态 和 另外 一 个 你 调用 的 过 程 的 状态 之 间 的 干净 的 隔离 。 在 另外 一 个 过 程 返回 后 ， 调 
用 spPI_pop 恢复 对 你 自己 的 SPI 状态 的 访问 。 


请 注意 SPI_execute 和 相关 的 函数 在 把 控制 交 回 SQL 执行 引擎 之 前 自 动 做 与 SPI_push 相当 的 
工作 ， 因此 你 在 使 用 这 些 函 数 的 时 候 不 用 担心 这 些 。 只 有 在 你 直接 调用 任意 可 能 包含 
sPI_connect 调用 的 代码 的 时 候 ， 你 才 需 要 发 出 sPI_push 和 SPI_pop o 


SPI pop 


Name 


SPI_pop -- 弹出 SPI 堆栈 以 从 递归 的 SPI 使 用 中 返回 


Synopsis 


void SPI_pop(void) 


sPI_pop 从 SPI 调用 堆栈 里 弹出 前 面 的 环境 。 参阅 spr_push o 


SPI_ execute 


Name 


SPI_execute -- 执行 一 条 命 兮 


Synopsis 


int SPI_execute(const char * command, bool read_only, long count) 


描述 

SPI_execute 执行 声明 的 SQL 命令 获取 count 行 。 如 果 read_only 为 true ， 命 令 必 须 是 只 
读 的 ， 因此 可 以 略微 降低 一 些 执行 的 开销 。 

这 个 函数 只 能 在 已 连接 的 过 程 中 调用 。 


如 果 count 是 雳 ， 则 在 命令 适合 的 所 有 行 上 执行 。 如 果 count 大 于 0 ， 那 么 将 不 会 超过 
count 行 被 检索 ; 当 达 到 计数 时 执行 停止 ， 很 像 在 查询 中 添加 了 一 个 LIMIT 子 句 。 比 如 ， 


SPI_execute("SELECT * FROM foo", true, 5); 


将 从 表 中 最 多 检索 5 行 。 请 注意 ， 这 样 一 个 限制 只 在 命 命 实际 返回 行 时 有 效 。 例 如 ， 


SPI_execute("INSERT INTO foo SELECT * FROM bar", false, 5); 


插入 bar 中 的 所 有 行 ， 忽 略 count 参数 。 不 过 ， 


SPI_execute("INSERT INTO foo SELECT * FROM bar RETURNING *", false, 5); 


将 最 多 插入 5 行 ， 因 为 在 检索 到 第 5 个 RETURNING 结果 行 之 后 执行 将 停止 。 


你 可 以 在 一 个 字符 串 里 传递 多 个 命令 。 spr_execute 返回 最 后 执行 的 命令 的 结果 。 count 的 
限制 独立 地 应 用 于 每 一 个 命令 〈 即 使 实际 只 返回 最 后 的 结果 ) 。 限制 不 会 应 用 于 规则 生成 的 


TEA 
KIM To 


如 果 read_only @ false, sPI_execute 递增 命令 计数 器 并 且 在 字符 串 里 执行 每 个 命令 之 前 
计算 一 个 新 的 快照 。 如 果 当 前 事务 的 隔离 级 别 是 SERIALIZABLE 或 REPEATABLE READ, 这 个 快 
照 实 际 上 并 不 改变 ， 但 是 在 READ coMMITTED 模式 里 ， 这 个 快照 更 新 允许 每 个 命令 看 到 其 它 会 


话 的 新 提交 的 事务 的 结果 。 这 样 实 际 上 是 为 了 修改 数据 库 的 命 信 有 一 致 的 行为 。 


如 果 read_only 是 true, SPI_execute 并 不 更 新 快照 或 者 命令 计数 器 ， 并 且 它 只 多 许 简 单 
的 seLEcT 命令 出 现在 命令 字符 串 里 。 这 个 命令 使 用 为 周围 的 查询 建立 起 来 的 快照 执行 。 这 
个 执行 模式 比 读 / 写 模式 执行 得 略微 块 些 ， 因 为 它 消除 了 每 个 命令 的 一 些 开 销 。 并 且 它 还 允许 
制作 真正 的 稳定 函数 : 因为 随后 的 执行 都 将 使 用 同一 个 快照 ， 结果 里 不 会 有 改变 。 


通常 ， 在 同一 个 使 用 SPI 的 函数 里 混 末 只 读 和 读 写 命 令 是 不 明智 的 ; 那样 可 能 导致 非常 混乱 
的 行为 ， 因 为 只 读 的 查询 不 能 看 到 任何 读 写 的 查询 做 的 数据 库 更 新 。 


(最 后 ) 一 条 命令 执行 返回 的 结果 的 实际 行 数 会 放 在 全 局 的 变量 SPI_processed 里 。 aR ES BLY 
返回 值 是 spI_ok_SELECT 、 SPI_OK_INSERT_RETURNING 、 SPI_OK_DELETE_RETURNING 

或 SPI_OK_UPDATE_RETURNING ， 那 么 你 可 以 使 用 全 局 指针 spITupleTable *SPI_tuptable 访问 结 
果 行 。 一 些 实用 命令 (比如 ExPLAIN ) 还 返回 行 集合 ， 并 且 spr_tuptable 也 将 在 这 种 情况 下 包 
AR, ERAMA (copy , CREATE TABLE As ) 并 不 返回 行 集 ， 所 以 spI_tuptable 为 
NULL， 但 是 它们 仍然 返回 spPI_processed 中 处 理 了 的 行 数 。 


结构 SPITupleTable 是 这 样 定义 的 : 


typedef struct 


MemoryContext tuptabcxt; /* memory context of result table */ 
uint32 alloced; /* number of alloced vals */ 

uint32 free; /* number of free vals */ 

TupleDesc tupdesc; /* row descriptor */ 

HeapTuple *vals; /* rows */ 


} SPITupleTable; 


vals 是 一 个 指向 数据 行 的 的 指针 数组 (有 效 记 录 的 数目 由 spr_processed 给 出 )。 tupdesc 是 
| 行 描 述 符 ， 你 可 以 传递 给 SPI 函数 义理 这 些 数 据 行 。 tuptabcxt 、 alloced 和 free 是 
SPI 的 内 部 字段 ， 并 非 给 SPI 调用 者 使 用 的 。 


spI_finish 释放 所 有 在 当前 过 程 中 分 配 的 spITupleTable 。 如 果 你 已 经 处 理 完 特定 的 结 
表 ， 那 么 可 以 更 早 地 释放 它 ， 方 法 是 调用 spI_freetuptable o 


AY Ed 
参数 
const char * command 
包含 要 执行 的 命令 的 字符 串 
bool read_only 
true 用 于 只 读 的 执行 


long count 


返回 的 最 大 行 数 ， 或 者 没有 限制 时 为 o 


RIE) (6 


如 果 命 令 执 行 成 功 ， 那 么 返回 下 列 值 之 一 ( 非 负数 ) : 


SPI_OK_SELECT 


如 果 执 行 了 一 个 SELECT 但 不 是 SELECT INTO 


SPI_OK_SELINTO 


如 果 执 行 了 一 条 SELECT INTO 


SPI_OK_INSERT 


如 果 执 行 了 一 条 INSERT 


SPI_OK_DELETE 


如 果 执 行 了 一 条 DELETE 


SPI_OK_UPDATE 


如 果 执 行 了 一 条 UPDATE 


SPI_OK_INSERT_RETURNING 
如 果 执 行 了 一 条 INSERT RETURNING 
SPI_OK_DELETE_RETURNING 

如 果 执 行 了 一 条 DELETE RETURNING 


SPI_OK_UPDATE_RETURNING 


如 果 执 行 了 一 条 UPDATE RETURNING 


SPI_OK_UTILITY 


如 果 执 行 了 一 条 实用 命令 (比如 CREATE TABLE ) 
SPI_OK_REWRITTEN 

WORX OFF Bt 

发 生 错误 时 ， 返 回 下 列 负数 值 之 一 : 
SPI_ERROR_ARGUMENT 


如 果 command NULL 或 count 小 于 0 


SPI_ERROR_COPY 


如 果 企 图 进行 copy To stdout 或 COPY FROM stdin 


SPI_ERROR_TRANSACTION 


一 个 规则 重新 写 人 了 另 一 个 类 型 的 命令 


(比如 ， uPDATE 变 成 一 个 INSERT ) 


如 果 党 试 事务 操纵 命令 ( BEGIN, COMMIT , ROLLBACK , SAVEPOINT , PREPARE TRANSACTION , 


COMMIT PREPARED , ROLLBACK PREPARED , 或 它们 的 变种 ) 
SPI_ERROR_OPUNKNOWN 
命令 类 型 未 知 (不 应 该 发 生 ) 


SPI_ERROR_UNCONNECTED 


如 果 从 一 个 未 连接 的 过 程 中 调用 

<r 

EA 

PR SPI 34 447 BE IB S SPI_processed 和 SPI_tuptable (只 是 一 个 指针 ， 不 是 结构 的 内 


容 )。 如 果 你 需要 跨越 后 面 的 调用 访问 SPI_execute 或 者 另 一 个 查询 执行 函数 的 结果 表 ， 那 么 
需要 把 这 两 个 全 局 变量 保存 到 一 个 局 部 过 程 变量 中 。 


SPI_ exec 


Name 
SPl_exec -- 执行 一 个 读 / 写 命令 
Synopsis 
int SPI_exec(const char * command, long count) 
vb 
摘 述 
SPI_exec 和 sPI_execute 一 样 ， 只 是 相当 于 后 者 的 readonly 参数 总 是 false o 


参数 


const char * command 
包含 需要 执行 的 命令 的 字符 串 
long count 


返回 的 最 大 行 数 ， 或 者 没有 限制 时 为 o 


返回 值 


参见 SPI_execute o 


SPI_execute_with_args 


Name 


SPl_execute_with_args -- 执行 一 个 带 有 外 联 参 数 的 命令 


Synopsis 


int SPI_execute_with_args(const char *command, 
int nargs, Oid *argtypes, 
Datum *values, const char *nulls, 
bool read_only, long count) 


fia ah 


SPI_execute_with_args 执行 一 个 可 能 包含 引用 外 部 提供 的 参数 的 命令 。 该 命令 文本 作 
Asn 引用 一 个 参数 ， 并 且 该 调用 为 每 个 这 样 的 符号 指定 数据 类 型 和 值 。 read_only 和 
count 的 解释 和 在 spr_execute 中 一 样 。 


与 SPI_execute 比较 ， 这 个 例 程 的 主要 优势 是 数据 值 可 以 插入 命 今 ， 而 不 用 引用 /逃逸 ， 并 且 
因此 少 了 许多 SQL 注入 攻击 的 危险 。 


相似 的 结果 可 以 用 跟着 SPI_execute_plan 的 SPI_prepare 达到 ; 不 过 ， 当 使 用 这 个 画 数 时 ， 
该 查询 规划 总 是 自 定义 为 提供 的 特定 的 参数 值 。 对 于 一 次 性 查询 执行 ， 这 个 函数 应 该 优先 执 
行 。 如 果 用 许多 不 同 的 参数 执行 相同 的 命 舍 ， 哪 种 方法 可 能 会 更 快 ， 取 决 于 重新 规划 的 开销 
与 自 定义 规划 的 好 处 的 对 上 比 。 


参数 


const char * command 


输入 参数 的 个 数 ( $1 ，$2 , 等 ) 
Oid * argtypes 


长 度 nargs 的 一 个 数组 ， 包 含 参数 的 数据 类 型 的 OID 


Datum * values 

KE nargs 的 一 个 数组 ， 包 含 实际 参数 值 
const char * nulls 

KE nargs 的 一 个 数组 ， 描 述 哪个 参数 为 空 


如 果 nulls 是 NULL , 那么 SPI_execute_with_args 假设 没有 参数 为 空 。 Bn, 如 果 对 应 的 参 
数值 是 非 空 的 ， 那 么 nulls 数组 的 每 一 项 都 应 该 是 ' ， 或 者 如 果 对 应 的 参数 值 为 空 ， 那 么 
nulls 数组 的 每 一 项 都 是 'n' 。 (在 后 面 这 种 情况 下 ， 对 应 的 values 项 中 的 实际 值 无 关 紧 
要 。) 请 注意 ， nulls 不 是 文本 字符 串 ， 只 是 一 个 数组 : 它 不 需要 no 终止 符 。 


bool read_only 
true 用 于 只 读 的 执行 


long count 


返回 的 最 大 行 数 ， 或 者 没有 限制 时 为 o 


返回 值 


返回 值 和 spr_execute 相同 。 


如 果 成 功 ， sPI_processed 和 SPI_tuptable 和 在 spPI_execute 中 一 样 设置 。 


SPI_ prepare 


Name 


SPI_prepare -- 准备 一 个 规划 但 不 立即 执行 它 


Synopsis 


SPIPlanPtr SPI_prepare(const char * command, int nargs, Oid * argtypes) 


Fea ah 
SPI_prepare 为 声明 的 命令 创建 和 返回 一 个 预备 语句 但 是 不 执行 查询 。 该 预备 语句 稍 后 可 以 
使 用 sPI_execute_plan 重复 的 执行 。 


如 果 相 同 或 者 类 似 的 查询 要 多 次 重复 执行 ， 那 么 通常 只 进行 一 次 解析 分 析 应 该 是 更 好 些 ， 并 
且 此 外 可 能 有 利于 为 该 命令 重复 使 用 一 个 执行 规划 。 sPI_prepare 把 一 个 命令 字符 串 转 换 成 
一 个 封装 解析 分 析 的 结果 的 预备 语句 。 如 果 发 现 为 每 个 执行 生成 一 个 自 定义 规划 没什么 帮 
助 ， 那么 该 预备 语句 也 为 缓存 一 个 执行 规划 提供 位 置 。 


可 以 把 预 编写 的 查询 通用 化 ， 方 法 是 在 那些 普通 查询 里 是 常量 的 地 方 书写 参数 ( $1 ，$2 等 
等 )。 参数 的 数值 随后 在 调用 SPI_execute_plan 的 时 候 声明 。 这 样 就 允许 已 准备 的 查询 在 远 比 
没有 参数 时 广泛 得 多 的 场合 下 使 用 。 


SPI_prepare 返回 的 语句 只 能 在 当前 过 程 调 用 中 使 用 ， 因为 sPI_finish 释放 为 这 样 一 个 语句 
分 配 的 内 存 。 不 过 ， 一 个 语句 可 以 用 画 数 SPI_keepplan 或 SPI_saveplan 保存 更 长 的 时 间 。 


参数 


const char * command 


全 入 参数 的 个 数 ( s1, $2 FF) 
Oid * argtypes 


一 个 指针 ， 指 向 包含 参数 数据 类 型 的 OID 数 组 


TRIE) (6 


SPI_prepare 返回 一 个 指向 一 个 SPIPlan 的 非 空 指针 ， SPIPlan 是 一 个 表示 预 各 语句 的 不 透 
明 结 构 。 错 误 时 将 返回 NuLL ， 并 且 spr_result 将 设置 为 和 spr_execute 使 用 的 同样 错误 的 
错误 代码 ， 例 外 是 在 command 是 NULL 的 时 候 ， 或 者 是 nargs 小 于 0 或 者 nargs 大 于 0 并 


H argtypes 是 NULL 的 时 候 会 被 设置 成 SPI_ERROR_ARGUMENT o 


AS 


) 王 局 


如 果 没 有 定义 参数 ， 那么 在 第 一 次 使 用 SPI_execute_plan 时 将 创建 一 个 通用 规划 ， 并 且 也 用 
于 所 有 随后 的 执行 。 如 果 有 参数 ， 前 几 次 使 用 sPI_execute_plan 将 生成 特定 于 提供 的 参数 值 
的 自 定义 规划 。 相同 的 预 各 语句 使 用 足够 多 次 之 后 ， sPI_execute_plan 将 建立 一 个 通用 规 
划 ， 并 且 如 果 该 通用 规划 并 不 比 自 定义 规划 昂贵 的 多 的 话 ， 它 将 开始 使 用 该 通用 规划 而 不 是 
每 次 重新 规划 。 如 果 这 个 缺 省 行为 不 合适 ， 你 可 以 通过 传 

递 CURSOR_OPT_GENERIC_PLAN 或 CURSOR_OPT_CUSTOM_PLAN 标志 到 SPI_prepare_cursor 来 修改 


它 ， 分 别 强制 使 用 通用 或 自 定 义 规 划 。 


尽管 预 各 语句 的 要 点 是 为 了 避免 重复 的 解析 分 析 和 规划 语句 ， 但 是 在 语句 中 使 用 的 数据 库 对 
象 自 上 次 使 用 预备 语句 以 来 经 历 了 明确 的 (DDL) 改变 时 ，PostgreSQL 将 在 使 用 它 之 前 强制 
重新 分 析 和 重新 规划 语句 。 另外 ， 如 果 search path 的 值 在 下 一 次 使 用 时 发 生 了 改变 时 ， 该 
语句 将 使 用 新 的 search_path 重新 解析 。 (后 者 的 行为 是 PostgreSQL 9.3 新 增 的 。) 参 

J PREPARE 获取 更 多 关于 预 各 语句 的 行为 的 信息 。 


这 个 图 数 应 该 只 从 一 个 已 连接 的 过 程 中 调用 。 


sPIPlanptr 声明 为 一 个 指针 ， 指 向 spi.n 中 的 一 个 不 透明 的 结构 类 型 。 党 试 直 接 访 问 它 的 内 
容 是 不 明智 的 ， 因 为 那样 会 使 得 你 的 代码 在 未 来 的 PostgreSQL 修 订 版 本 中 更 容易 破裂 。 


ZF spPipPlanpPtr 是 历史 用 法 ， 因 为 数据 结构 不 再 需要 包含 一 个 执行 规划 。 


SPI_prepare_cursor 


Name 


SPI_prepare_cursor -- 准备 一 个 语句 但 不 立即 执行 它 


Synopsis 


SPIPlanPtr SPI_prepare_cursor(const char * command, int nargs, 
Oid * argtypes, int cursorOptions) 


SPI_prepare_cursor 和 spI_prepare 相同 ， 除了 它 也 允许 说 明 规划 器 的 "游标 选项 "参数 。 这 是 
一 个 位 掩 码 ， 让 Declarecursorstmt 的 options 字段 拥有 nodes/parsenodes.h 中 显示 的 
{io SPI_prepare 总 是 将 游标 选项 看 做 需 。 


参数 


const char * command 

命令 字符 串 

int nargs 

输入 参数 的 个 数 ( s1, $32 FF) 

Oid * argtypes 

一 个 指针 ， 指 向 一 个 包含 参数 数据 类 型 的 OID 的 数组 
int cursorOptions 


游标 选项 的 整数 位 标记 ; 雳 表示 缺 省 行为 


上 运 回 值 


SPI_prepare_cursor 有 和 spI_prepare 一 样 的 返回 约定 。 


MAN 
) 王 局 


cursoroptions 中 的 有 效 位 包括 cursoR_OPT_SCROLL 、 
CURSOR_OPT_NO_SCROLL 、 CURSOR_OPT_FAST_PLAN 、 


CURSOR_OPT_GENERIC_PLAN 和 CURSOR_OPT_CUSTOM_PLAN o 特别 要 注意 忽略 了 CURSOR_OPT_HOLD o 


SPI prepare params 


Name 


SPI_prepare_params -- 准备 一 个 语句 但 不 立即 执行 它 


Synopsis 


SPIPlanPtr SPI_prepare_params(const char * command, 
ParserSetupHook parserSetup, 
void * parserSetupArg, 
int cursorOptions) 


SPI_prepare_params 为 指定 的 命令 创建 并 返回 一 个 预备 语句 ， 但 是 不 执行 该 命令 。 x PRL 
相当 于 SPI_prepare_cursor , RT AS GS EN Shook WAM IAMS | AMF 
析 。 


const char * command 

命令 字符 串 

ParserSetupHook parserSetup 
解析 器 hook 设 置 功 能 

void * parserSetupArg 

A parserSetup 传递 参数 

int  cursorOptions 


游标 选项 的 整 型 位 标记 ; 雾 表 示人 缺 省 行为 


返回 值 


SPI_prepare_params 有 和 spI_prepare 一 样 的 返回 约定 。 


SPI getargcount 


Name 
SPI_getargcount -- 返回 一 个 sPI_prepare 准备 的 已 准备 好 语句 需要 的 参数 个 数 
Synopsis 


int SPI_getargcount(SPIPlanPtr plan) 


SPI_getargcount 返回 执行 一 个 sPI_prepare 准备 的 已 准备 好 语句 需要 的 参数 个 数 


参数 


SPIPlanPtr plan 


预备 语句 ( spr_prepare 返回 的 ) 


返回 值 


plan 预期 参数 的 个 数 。 如 果 plan 是 NuLL REM, sPI result 设置 为 
SPI_ERROR_ARGUMENT 并 返回 -1. 


SPI_getargtypeid 


Name 


SPI_getargtypeid -- 返回 sp1_prepare 准 各 的 已 准备 好 语句 的 参数 的 数据 类 型 OID 


Synopsis 


Oid SPI_getargtypeid(SPIPlanPtr plan, int argIndex) 


fia ah 


SPI_getargtypeid 返回 spr_prepare 准备 的 已 准备 好 语句 的 第 argindex 个 参数 的 类 型 ID ， 
用 OID 表示 。 第 一 个 参数 的 索引 为 需 。 


参数 


SPIPlanPtr plan 
预备 语句 ( spr_prepare 返回 的 ) 
int argIndex 


以 需 为 基 的 参数 索引 


返回 值 


给 出 索引 位 置 的 参数 的 类 型 OID， 如 果 plan 为 NULL 或 无 效 ， 或 argindex 小 于 0 或 者 大 于 
或 等 于 为 plan 声明 的 参数 个 数 ， 则 spr_result 设置 为 SPI_ERROR_ARGUMENT 并 且 返 
回 Invalidoid 。 


SPI_is_cursor_plan 


Name 
SPI_is_cursor_plan -- 如 果 一 个 sPI_prepare 准备 的 语句 可 以 和 spr_cursor_open 一 起 使 用 ， 
则 返回 true 


Synopsis 


bool SPI_is_cursor_plan(SPIPlanPtr plan) 


fia aah 


如 果 一 个 spr_prepare 准备 的 语句 可 以 作为 参数 传递 给 

SPI_cursor_open W] SPI_is_cursor_plan 返回 true , 如 果 不 是 这 样 则 返回 false 。 评判 的 
标准 是 这 个 plan 代表 一 个 单个 命令 ， 并 且 这 个 命令 返回 元 组 ; 例如 一 个 包含 INTo FA 
的 sELECT 或 者 包含 RETURNING 子 句 的 UPDATE 。 


参数 


SPIPlanPtr plan 


预备 语句 ( spr_prepare 返回 的 ) 


返回 值 


表明 该 plan 是 否 可 以 生成 一 个 游标 的 true 或 false, spPI_result 设置 为 需 。 如 果 不 可 能 
确定 结果 例如， 如 果 plan 是 nur 或 无 效 ， 或 者 如 果 在 没有 连接 到 SPI 时 调用 ) ， 那 
4, spI_result 设置 为 合适 的 错误 代码 ， 并 且 返 回 false o 


SPI_execute_plan 


Name 


SPI_execute_plan -- 执行 一 个 spr_prepare 准备 的 语句 


Synopsis 


int SPI_execute_plan(SPIPlanPtr plan, Datum * values, const char * nulls, 
bool read_only, long count) 


= 


fia ah 


SPI_execute_plan 执行 一 个 SPI_prepare 或 它 的 兄弟 节点 之 一 准备 的 语句 。 read_only 和 
count 的 含义 和 spI_execute 里 面 的 相同 。 


SPIPlanPtr plan 

预备 语句 ( spr_prepare 返回 的 ) 

Datum * values 

一 个 实际 的 参数 值 的 数组 。 必 须 和 语句 的 参数 个 数 相同 。 
const char * nulls 

一 个 描述 哪个 参数 是 空 的 数组 。 必 须 和 话 句 的 参数 个 数 相同 。 


如 果 nulls 是 NULL ， 那 么 SPI_execute_plan 假设 没有 参数 为 空 。 否则 ， 如 果 对 应 的 参数 值 
是 非 空 的 ， 那 么 nuiis 数组 的 每 一 项 都 应 该 是 ' ' ， 或 者 如 果 对 应 的 参数 值 为 空 ， 那 么 
nulls 数组 的 每 一 项 都 是 'n' 。 (在 后 面 这 种 情况 下 ， 对 应 的 values 项 中 的 实际 值 无 关 紧 
要 。) 请 注意 ， nulls 不 是 文本 字符 串 ， 只 是 一 个 数组 : 它 不 需要 no 终止 符 。 


bool read_only 
true 用 于 只 读 的 执行 


long count 


返回 的 最 大 行 数 ， 或 者 没有 限制 时 为 o 


返回 值 


返回 值 和 spr_execute 的 一 样 ， 另 外 还 有 下 面 几 个 可 能 的 错误 ( 负 值 ) 结 果 : 


SPI_ERROR_ARGUMENT 


如 果 plan 是 NULL 或 者 无 效 ， 或 者 count 小 于 0 
SPI_ERROR_PARAM 

如 果 values 是 NuLL HH plan 准 各 了 一 些 参数 
成 功 时， 


SPI_processed 和 SPI_tuptable 的 设置 和 SPI_execute 里 一 样 。 


SPI_execute_plan_with_paramlist 


Name 


SPl_execute_plan_with_paramlist -- 执行 一 个 sPI_prepare 准 各 的 已 准备 好 的 语句 


Synopsis 


int SPI_execute_plan_with_paramlist(SPIPlanPtr plan, 
ParamListInfo params, 
bool read_only, 
long count) 


fia ah 


SPI_execute_plan_with_paramlist 执行 一 人 SPI_prepare 准备 的 已 准备 好 的 语句 。 这 个 西数 
相当 于 sPI_execute_plan ， 除了 要 传递 给 查询 的 有 关 参 数值 信息 的 表现 不 

[A], ParamListInfo 表示 法 可 以 方便 的 传递 早已 在 该 格式 中 可 用 的 值 。 它 也 支持 使 用 动态 参 
数 设 置 ， 通过 paramListInfo 中 指定 的 hook 画 数 。 


参数 


SPIPlanPtr plan 

预备 语句 ( sPI prepare 返回 的 ) 

ParamListInfo params 

包含 参数 类 型 和 值 的 数据 结构 ; 如 果 没有 则 为 NULL 
bool read_only 

true 用 于 只 读 的 执行 

long count 


返回 的 最 大 行 数 ， 或 者 没有 限制 时 为 o 


返回 值 


返回 值 和 SPI_execute_plan 的 相 同 。 


如 果 成 功 ， spI_processed 和 spI_tuptable 的 设置 和 spr_execute_plan 里 的 相同 。 


SPI execp 


Name 


SPI_execp -- 以 读 / 写 模式 执行 一 个 准备 的 查询 规划 


Synopsis 


int SPI_execp(SPIPlanPtr plan, Datum * values, const char * nulls, long count) 


fia ah 


SPI_execp 和 sPI_execute_plan 一 样 ， 只 是 后 者 的 read_only 参数 总 是 为 false o 


参数 


SPIPlanPtr plan 

预备 语句 ( spr_prepare 返回 的 ) 

Datum * values 

实际 的 参数 值 的 数组 ， 必 须 和 语句 的 参数 个 数 一 样 。 
const char * nulls 

一 个 描述 哪个 参数 是 空 的 数组 。 必 须 和 参数 的 个 数 一 样 。 


如 果 nulls 是 NuLL ， 那 么 sPI_execp 假设 没有 参数 为 空 。 否 则 ， 如 果 对 应 的 参数 值 是 非 空 
BY, ABA nulls 数组 的 每 一 项 都 应 该 是 ，' ， 或 者 如 果 对 应 的 参数 值 为 空 ， 那 么 nulls 数 
组 的 每 一 项 都 是 'n' 。 (在 后 面 这 种 情况 下 ， 对 应 的 values 项 中 的 实际 值 无 关 紧 要 。) 请 
注意 ， nulls 不 是 文本 字符 串 ， 只 是 一 个 数组 : 它 不 需要 '\e' 终止 符 。 


long count 


返回 的 最 大 行 数 ， 或 者 没有 限制 时 为 6 


上 运 回 值 


参阅 spl_execute_plan o 


成 功 时 ， sPI_processed 和 SPI_tuptable 的 设置 和 spr_execute 里 一 样 。 


SPI_cursor_open 


Name 


SPI_cursor_open -- 用 spi_prepare 创建 的 语句 设置 一 个 游标 


Synopsis 


Portal SPI_cursor_open(const char * name, SPIPlanPtr plan, 
Datum * values, const char * nulls, 
bool read_only) 


FA 
SPI_cursor_open 设置 一 个 游标 (内 部 叫 入 口 )， 这 个 游标 可 以 执行 SPI_prepare 准备 的 语句 。 
参数 和 对 应 的 spr_execute_plan 参数 具有 相同 的 含义 。 


使 用 游标 而 不 是 直接 执行 语句 有 两 个 优点 。 首 先 ， 结 果 行 可 以 每 次 检索 一 小 部 分 ， 避免 那些 
返回 大 量 数 据 行 的 查询 造成 的 内 存 缺乏 。 第 二 ， 一 个 人 口 可 以 在 当前 过 程 之 外 存活 (实际 上 ， 
它 可 以 活 到 当前 事务 的 结尾 )。 给 过 程 的 调用 者 返回 一 个 人 口 名 是 一 种 返回 行 结果 集 的 方法 。 


传人 参数 数据 将 被 拷贝 到 游标 的 入口， 所 以 它 在 游标 仍然 存在 时 可 以 被 释放 。 


参数 


const char * name 

入 口 的 名 字 ， 或 者 是 用 NuLL 让 系统 选择 一 个 名 字 
SPIPlanPtr plan 

预备 语句 ( spr_prepare 返回 的 ) 

Datum * values 

一 个 实际 参数 值 的 数组 。 必 须 和 语句 的 参数 个 数 相等 。 
const char * nulls 


一 个 描述 哪些 参数 是 NULL 的 数组 。 必 须 和 语句 的 参数 个 数 相等 。 


如 果 nulls 是 NULL ， 那么 SPI_cursor_open 假设 没有 参数 为 空 。 人 否则， 如 果 对 应 的 参数 值 是 
非 空 的 ， 那 么 nulls 数组 的 每 一 项 都 应 该 是 ' ， 或 者 如 果 对 应 的 参数 值 为 空 ， 那 么 

nulls 数组 的 每 一 项 都 是 'n' 。 (在 后 面 这 种 情况 下 ， 对 应 的 values 项 中 的 实际 值 无 关 紧 
要 。) 请 注意 ， nulls 不 是 文本 字符 串 ， 只 是 一 个 数组 : 它 不 需要 no 终止 符 。 


bool read only 


true 用 于 只 读 的 执行 


上 运 回 值 


指向 包含 游标 入 口 的 指针 。 请 注意 ， 这 里 没有 错误 返回 约定 ; 任何 错误 都 将 通过 elog 报 


pa = 
Ao 


SPI_cursor_open_with_args 


Name 


SPI_cursor_open_with_args -- 使 用 查询 和 参数 设置 一 个 游标 


Synopsis 


Portal SPI_cursor_open_with_args(const char *name, 
const char *command, 
int nargs, Oid *argtypes, 
Datum *values, const char *nulls, 
bool read_only, int cursorOptions) 





fi ah 


SPI_cursor_open_with_args 设置 一 个 游标 (内 部 的 ， 一 个 入 口 ) ， 该 游标 将 执行 指定 的 查 
询 。 大 多 数 参数 和 spI_prepare_cursor 和 spI_cursor_open 的 对 应 参数 有 相同 的 含义 。 





对 于 一 次 性 查询 执行 ， 跟 着 SPI_cursor_open 的 spi_prepare_cursor 应 该 会 偏爱 这 个 豆 数 。 
如 果 相 同 的 命 合用 不 同 的 参数 执行 ， 哪 种 方法 可 能 更 快 ， 取决 于 重新 规划 的 开销 和 自 定义 规 
划 的 益处 的 比较 。 


传人 参数 数据 将 被 拷贝 到 游标 的 入 口 ， 所 以 它 在 游标 仍然 存在 时 可 以 被 释放 。 


参数 


const char * name 
AROMAS, X wu 让 系统 选择 一 个 名 字 


const char * command 


输入 参数 的 个 数 ( $1 ，s$2 等 等 ) 
Oid * argtypes 


KÆ nargs 的 一 个 数组 ， 包 括 参 数 数据 类 型 的 OID 


Datum * values 
KE nargs 的 一 个 数组 ， 包 括 实际 的 参数 值 


const char * nulls 


KE nargs 的 一 个 数组 ， 描 述 哪个 参数 为 空 


如 果 nulls 是 NULL , 那么 SPI_cursor_open_with_args 假设 没有 参数 为 空 。 否则 ， 如 果 对 应 
的 参数 值 是 非 空 的 ， 那 么 nulis 数组 的 每 一 项 都 应 该 是 ' ' ， 或 者 如 果 对 应 的 参数 值 为 空 ， 
那么 nulls 数组 的 每 一 项 都 是 'n' 。 在 后 面 这 种 情况 下 ， 对 应 的 values 项 中 的 实际 值 无 
关 紧 要 。) 请 注意 ， nulls 不 是 文本 字符 串 ， 只 是 一 个 数组 : 它 不 需要 '\o' 终止 符 。 





bool read_only 
true 用 于 只 读 的 执行 
int cursorOptions 


游标 选项 的 整 型 位 标记 ; 雾 表 示人 缺 省 行为 


上 运 回 值 


指向 包含 游标 入 口 的 指针 。 请 注意 ， 这 里 没有 错误 返回 约定 ; 任何 错误 都 将 通过 elog 报 


a = 
Foo 


SPI_cursor_open_with_paramlist 


Name 


SPI_cursor_open_with_paramlist -- 使 用 参数 设置 一 个 游标 


Synopsis 


Portal SPI_cursor_open_with_paramlist(const char *name, 
SPIPlanPtr plan, 
ParamListInfo params, 
bool read_only) 





fia ah 


SPI_cursor_open_with_paramlist 设置 一 个 游标 (内 部 的 ， 一 个 入 口 ) ， 该 游标 将 执行 一 
个 SPI_prepare 准备 的 已 准备 好 的 语句 。 这 个 函数 相当 于 sPI_cursor_open ， 除了 要 传递 给 
查询 的 有 关 参 数值 信息 的 表现 不 同 。 ParamListInfo 表示 法 可 以 方便 的 传递 早已 在 该 格式 中 
可 用 的 值 。 它 也 支持 使 用 动态 参数 设置 ， 通过 paramListInfo 中 指定 的 hook 男 数 。 





传人 参数 数据 将 被 拷贝 到 游标 的 入 口 ， 所 以 它 在 游标 仍然 存在 时 可 以 被 释放 。 


参数 


const char * name 

入 口 的 名 字 ， 或 者 是 NuLL 让 系统 选择 一 个 名 字 
SPIPlanPtr plan 

预备 语句 ( sPI prepare 返回 的 ) 

ParamListInfo params 

包含 参数 类 型 和 值 的 数据 结构 ; 如 果 没 有 则 为 NULL 
bool read_only 


true 用 于 只 读 的 执行 


上 运 回 值 


指向 包含 游标 入 口 的 指针 。 请 注意 ， 这 里 没有 错误 返回 约定 ; 任何 错误 都 将 通过 elog 报 


pa ml 
Fo 


SPI_cursor_find 


Name 
SPl_cursor_find -- 用 名 字 寻 找 并 执行 一 个 现存 的 游标 
Synopsis 


Portal SPI_cursor_find(const char * name) 


SPI_cursor_find 通过 名 字 寻 找 一 个 现存 的 入 口 。 主要 用 于 解析 一 些 其 它 函 数 返 回 的 文本 的 游 
标 名 字 。 


参数 


const char * name 


入 口 的 名 字 


返回 值 


指向 指定 名 称 的 入 口 的 指针 ， 如 果 没有 找到 就 是 NULL 


SPI_cursor_fetch 


Name 
SPI_cursor_fetch -- 从 一 个 游标 里 抓 取 一 些 行 
Synopsis 
void SPI_cursor_fetch(Portal portal, bool forward, long count) 
vp 
摘 述 


SPI_cursor_fetch 从 一 个 游标 里 抓 取 一 些 行 。 PRS MF SQL na FETCH 的 一 个 子 集 
(参阅 spPI_scroll_cursor_fetch 获取 更 多 功能 性 ) 。 


参数 


Portal portal 





包含 游标 的 入 口 
bool forward 

向 前 抓 取 时 为 真 ， 向 后 抓 取 时 为 假 
long count 


要 抓 取 的 最 大 行 数 


亿 回 值 

成 功 时 ， 像 SPI_execute 那样 设置 SPI_processed 和 SPI_tuptable 
XT 二 

7h Ss 


如 果 游 标的 规划 没有 带 有 cuRsoR_oPT_scROLL 选项 创建 ， 那么 向 后 抓 取 会 失败 。 


SPI_cursor_move 


Name 


SPI_cursor_move -- 移动 一 个 游标 
Synopsis 
void SPI_cursor_move(Portal portal, bool forward, long count) 


fia ah 


SPI_cursor_move 忽略 游标 中 的 一 些 行 。 2X SRRASAUF SQL 命令 MovE 的 一 个 子 集 (参阅 
SPI_scroll_cursor_move 获取 更 多 功能 性 ) 。 


参数 


Portal portal 





包含 游标 的 人 口 

bool forward 

向 前 移动 时 为 真 ， 向 后 移动 时 为 假 
long count 


移动 的 最 大 行 数 
+> =x 
) 王 局 


如 果 游 标的 规划 没有 带 有 cuRsoR_oPT_scROLL 选项 创建 ， 那么 向 后 移动 会 失败 。 


SPI_scroll_cursor_fetch 


Name 
SPI_scroll_cursor_fetch -- 从 一 个 游标 中 抓 取 一 些 行 
Synopsis 


void SPI_scroll_cursor_fetch(Portal portal, FetchDirection direction, 
long count) 





= 


JAR 


SPI_scroll_cursor_fetch 从 一 个 游标 中 抓 取 一 些 行 。 PHS MF SOLA FETCH o 


参数 


Portal portal 





包含 游标 的 入 口 

FetchDirection direction 

FETCH_FORWARD 、 FETCH_BACKWARD 、 FETCH_ABSOLUTE 或 FETCH_RELATIVE 之 一 
long count 


FETCH_FORWARD 或 FETCH_BACKWARD 抓 取 的 最 大 行 数 ; FeTCH_ABSOLUTE 抓 取 的 绝对 行 数 ; 
或 FETCH_RELATIVE 抓 取 的 相对 行 数 。 


WRI) (6 


如 果 成 功 ， spI_processed 和 spr_tuptable 的 设置 和 spr_execute 里 一 样 。 


参阅 SQLFETCH 命 令 获 取 direction 和 count 参数 的 解释 的 详细 信息 。 


如 果 游 标的 规划 没有 带 有 cursoR_OPT_SCROLL 选项 创建 ， 那么 方向 值 而 不 是 FETCH_FORWARD 会 
失败 。 


SPI_scroll_cursor_move 


Name 
SPI_scroll_cursor_move -- 移动 一 个 游标 
Synopsis 


void SPI_scroll_cursor_move(Portal portal, FetchDirection direction, 
long count) 





JAR 


SPI_scroll_cursor_move 忽略 游标 中 的 一 些 行 数 。 这 个 函数 相当 于 SQL 命令 MOVE o 


参数 


Portal portal 


= 





包含 游标 的 人 口 

FetchDirection direction 

FETCH_FORWARD 、 FETCH BACKWARD 、 FETCH_ABSOLUTE 或 FETCH_RELATIVE 之 一 
long count 


FETCH_FORWARD 或 FETCH_BACKWARD 移动 的 行 数 ;  FETCH_ABSOLUTE 移动 的 绝对 行 数 ; 
或 FETCH_RELATIVE 移动 的 相对 行 数 


返回 值 


如 果 成 功 ， spI_processed 的 设置 和 spr_execute 里 的 一 样 。 SPI_tuptable 设置 为 NULL, 
因为 这 个 画 数 没有 返回 行 。 


参阅 SQL FETCH 命 合 获 取 direction 和 count 参数 的 解释 的 详细 信息 。 


如 果 游 标的 规划 没有 使 用 cuRsoR_oPT_scRoLL 选项 创建 ， 那么 方向 值 而 不 是 FETCH_FORWARD 会 
失败 。 


SPI_cursor_close 


Name 


SPI_cursor_close -- 关闭 一 个 游标 


Synopsis 


void SPI_cursor_close(Portal portal) 


摘 述 
SPI_cursor_close 关闭 一 个 前 面 创建 的 游标 并 且 释 放 其 入 口 存储 。 
在 事务 结尾 ， 所 有 打开 的 游标 都 自动 关闭 。 只 有 在 希望 更 早 释放 资源 的 时 候 才 需要 调用 


SPI_cursor_close o 


AL 
参数 
Portal portal 


包含 游标 的 和 人口 


SPI_keepplan 


Name 


SPI_keepplan -- 保存 一 个 预备 语句 


Synopsis 


int SPI_keepplan(SPIPlanPtr plan) 


SPI_keepplan 保存 一 个 已 经 传递 了 的 语句 ( SPI_prepare 准 各 的 ) 7 所 以 它 将 不 会 通 
过 SPI_finish 或 者 事务 管理 器 释放 。 这 给 了 你 在 当前 会 话 中 你 的 过 程 的 随后 调用 重新 使 用 预 
各 语句 的 能 力 。 


参数 


SPIPlanPtr plan 


要 保存 的 预备 语句 


VR [O) 46 
成 功 时 为 0 ; 如 果 plan NULL 或 者 无 效 的 ， 那么 是 spr_ERROR_ARGUMENT 


<= ae 


) 王 局 


通过 指针 调整 ， 传 入 参数 重 定位 到 参数 存储 (不 需要 拷贝 数据 ) 。 如 果 你 稍 后 想 要 删除 它 ， 
在 其 上 使 用 SPI_freeplan o 


SPI saveplan 


Name 


SPI_saveplan -- 保存 一 个 预备 语句 


Synopsis 


SPIPlanPtr SPI_saveplan(SPIPlanPtr plan) 


SPI_saveplan 在 内 存 里 保存 一 个 传递 进来 的 语句 (用 SPI_prepare 准备 的 )， CHARS 
被 sPI_finish 和 事务 管理 器 释放 ， 并 且 返 回 一 个 指向 拷贝 的 语句 的 指针 。 这 样 就 给 你 在 当 
前 会 话 里 的 随后 的 调用 中 复 用 这 个 预备 规划 的 能 力 。 


参数 


SPIPlanPtr plan 


要 保存 的 预备 语句 


上 运 回 值 


指向 保存 的 规划 的 指针 ; 如 果 不 成 功 则 为 NULL 。 出 错 的 时 候 ， 像 下 面 这 样 设置 SPI_result 


SPI_ERROR_ARGUMENT 


如 果 plan 是 NULL 或 者 无 效 的 


SPI_ERROR_UNCONNECTED 


如 果 从 一 个 未 连接 的 过 程 中 调用 


原先 传人 的 语句 并 没有 释放 ， 所 以 你 可 能 希望 在 其 上 执行 spr_treeplan, 以 避免 内 存 泄 露 直 


到 spPI_finish o 


在 大 多 数 情 况 下 ， spPI_keepplan AZIAK, 因为 它 基 本 上 不 需要 物理 上 拷贝 预备 语句 的 
数据 结构 就 完成 了 相同 的 结果 。 


44.2. 接口 支持 西数 


Table of Contents 


e SPI fname -- 从 指定 的 字段 编号 判断 字段 名 字 
e SPI fnumber -- 判断 声明 字段 名 的 字段 编号 

e SPI_getvalue -- 返回 声明 字段 的 字符 串 值 

e SPI_getbinval -- 返回 声明 字段 的 二 进 制 值 

e SPI_gettype -- 返回 声明 字段 的 数据 类 型 名 

e SPI_gettypeid -- 返回 声明 字段 的 数据 类 型 OID 
e SPI_getrelname -- 返回 声明 关系 的 名 字 

e SPI_getnspname -- 返回 声明 关系 的 名 字 空 间 


这 里 描述 的 函数 提供 了 从 sPI_execute 返回 的 结果 集 以 及 其 它 SPI 接口 画 数 中 抽取 信息 的 便 
利 的 接口 。 


所 有 本 节 描 述 的 函数 都 可 以 用 于 已 连接 和 未 连接 的 过 程 。 


SPI fname 


Name 


SPI_fname -- 从 指定 的 字段 编号 判断 字段 名 字 


Synopsis 


char * SPI_fname(TupleDesc rowdesc, int colnumber ) 


SPI_fname 返回 指定 字段 的 字段 名 字 。 你 可 以 在 不 在 需要 的 时 候 用 pfree 释放 这 个 名 字 的 副 
本 占据 的 空间 。 


siz 
参数 
TupleDesc rowdesc 
输入 行 描述 
int colnumber 


字段 编号 (从 1 开始 ) 


返回 值 


字段 名 ; 如 果 colnumber 超出 范围 则 返回 NuLL o 错误 时 ， SPI_result 设置 
为 SPI_ERROR_NOATTRIBUTE 。 


SPL fnumber 


Name 


SPI_fnumber -- 判断 声明 字段 名 的 字段 编号 


Synopsis 


int SPI_fnumber(TupleDesc rowdesc, const char * colname) 


SPI_fnumber 返回 声明 名 字 的 字段 的 字段 编号 。 


如 果 colname 引用 的 是 一 个 系统 字段 (比如 oid), 那么 将 返回 合适 的 负数 字段 编号 。 调 用 者 
应 该 仔细 测试 返回 值 是 spI_ERROR_NOATTRIBUTE 才能 判断 是 一 个 错误 ; 除非 要 拒绝 系统 字段 ， 
否则 ， 测 试 结果 小 于 或 者 等 于 0 是 不 正确 的 判断 方法 。 


参数 


TupleDesc rowdesc 
输入 行 描 述 
const char * colname 


字段 名 


返回 值 


字段 编号 (从 1 开始 记 )， 如 果 没 有 找到 该 名 字 的 字段 ， 返回 spI_ERROR_NOATTRIBUTE 


SPI getvalue 


Name 


SPI_getvalue -- 返回 声明 字段 的 字符 串 值 


Synopsis 


char * SPI_getvalue(HeapTuple row, TupleDesc rowdesc, int colnumber) 


SPI_getvalue 返回 声明 的 字段 的 数值 的 字符 串 表 现形 式 。 
结果 是 放 在 用 palloc 分 配 的 内 存 里 的 。 在 你 不 需要 它 之 后 ， 你 可 以 使 用 pfree 释放 内 存 。 


参数 

HeapTuple row 
要 检查 的 输入 行 
TupleDesc rowdesc 
输入 行 描述 

int colnumber 


字段 编号 (从 1 开始 ) 


返回 值 


字段 值 ， 如 果 字 段 是 空 ， 或 者 colnumber 超出 范围 ( SPI_result 设置 
为 SPI_ERROR_NOATTRIBUTE )， 或 者 没有 可 用 的 输出 函数 ( sPI_result 设置 为 
SPI_ERROR_NOOUTFUNC ) 的 时 候 ， 返 回 nue o 


SPI getbinval 


Name 


SPI_getbinval -- 返回 声明 字段 的 二 进 制 值 


Synopsis 


Datum SPI_getbinval(HeapTuple row, TupleDesc rowdesc, int colnumber, 
bool * isnull) 


SPI_getbinval 以 数据 的 内 部 形式 ( 像 类 型 Datum ) 返回 声明 字段 的 数值 。 
这 个 函数 并 不 为 数据 分 配 新 的 空间 。 如 果 是 传递 引用 ， 那 么 返回 值 将 是 指向 传递 的 行 的 指 


HeapTuple row 
输入 的 要 检查 的 行 
TupleDesc  rowdesc 
偷 人 行 描述 

int colnumber 
字段 编号 (从 1 开始 记 ) 
bool * isnull 


字段 里 NULL 的 标志 


返回 值 


返回 该 字段 的 二 进 制 值 。 如 果 字 段 为 空 ， 那 么 isnull 指向 的 变量 设置 为 真 ， 否 则 为 假 。 


时 y 
日 1 天 ult L 
o 


SPI gettype 


Name 


SPI_gettype -- 返回 声明 字段 的 数据 类 型 名 


Synopsis 


char * SPI_gettype(TupleDesc rowdesc, int colnumber) 


SPI_gettype 返回 声明 字段 的 数据 类 型 名 字 的 一 份 拷贝 。 如 果 你 不 再 需要 它 了 ， 你 可 以 使 
用 pfree 释放 名 字 的 拷贝 。 


siz 
参数 
TupleDesc rowdesc 
输入 行 描述 
int colnumber 


字段 编号 (从 1 开始 记 ) 


上 运 回 值 


声明 的 字段 的 数据 类 型 名 ， 如 果 错 误 ， 则 为 NULL o 错误 时 ， SPI_result 设置 
为 SPI_ERROR_NOATTRIBUTE 。 


SPI gettypeid 


Name 


SPI_gettypeid -- 返回 声明 字段 的 数据 类 型 OID 


Synopsis 


Oid SPI_gettypeid(TupleDesc rowdesc, int colnumber) 


fia ah 


SPI_gettypeid 返回 声明 字段 的 数据 类 型 的 OID。 


参数 


TupleDesc rowdesc 
输入 行 描述 
int colnumber 


字段 编号 (从 1 开始 记 ) 
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声明 字段 的 数据 类 型 的 OID， 或 者 错误 时 是 Invalidoid o 在 出 错 的 时 候 ， spPI_result 设置 
为 SPI_ERROR_NOATTRIBUTE 。 


SPI getrelname 


Name 


SPI_getrelname -- 返回 声明 关系 的 名 字 


Synopsis 


char * SPI_getrelname(Relation rel) 


SPI_getrelname 返回 声明 的 关系 的 名 字 之 一 份 拷贝 。 


用 pfree 释放 这 个 拷贝 。 


参数 


Relation rel 


输入 天 系 


返回 值 


声明 的 关系 的 名 字 。 


如 果 你 不 再 需要 这 个 名 字 ， 可 以 


SPI_getnspname 


Name 
SPI_getnspname -- 返回 声明 关系 的 名 字 空 间 
Synopsis 


char * SPI_getnspname(Relation rel) 


SPI_getnspname 返回 一 份 声 明 的 Relation 所 属 的 名 字 空 间 的 名 字 的 拷贝 。 这 个 数值 等 于 该 
关系 的 模式 。 在 你 使 用 完毕 之 后 ， 应 该 pfree 这 个 函数 的 返回 值 。 


参数 


Relation rel 


输入 天 系 


返回 值 


声明 关系 的 名 字 空 间 的 名 字 


44.3. 内 存 管 理 


Table of Contents 


e SPI_palloc -- 在 上 层 执行 器 环境 里 分 配 内 存 

e SPI_repalloc -- 在 上 层 执行 器 环境 里 重新 分 配 内 存 

e SPI_pfree -- 在 上 层 执行 器 环境 里 释放 内 存 

e SPI_copytuple -- 在 上 层 执行 者 环境 里 制作 一 个 行 的 拷 由 

e SPI_returntuple -- 准 各 把 一 个 行当 作 Datum 返回 

e SPI_modifytuple -- 通过 蔡 换 一 个 给 出 行 的 选 定 的 字段 创建 一 行 

e SPI freetuple -- 释放 在 上 层 执行 者 环境 里 分 配 的 一 行 

e SPI freetuptable -- 释放 一 个 由 spI_execute 或 者 类 似 的 函数 创建 的 行 集 
e SPI freeplan -- 释放 一 个 前 面 保存 的 预备 语句 


PostgreSQL 在 内 存 环境 中 分 配 内 存 ， 它 提供 了 在 许多 地 方 分 配 的 ， 有 着 不 同 的 生命 期 的 许多 
内 存 块 的 一 个 方便 的 管理 方法 。 删除 一 个 环境 则 释放 所 有 在 其 内 部 分 配 的 内 存 。 因 此 ， 没 必 
要 跟踪 独立 的 对 象 以 避免 内 存 泄漏 ; 而 是 只 要 管理 少量 的 环境 。 palloc 和 相关 的 画 数 从 " 当 
前 " 的 环境 中 分 配 内 存 。 


sPI_connect 创建 一 个 新 的 内 存 环境 并 且 将 其 标记 为 当前 的 环境 。 spPI_finish 恢复 前 一 个 内 
存 环境 并 且 删 除 spr_connect 创建 的 环境 。 这 些 动作 确保 在 你 的 过 程 中 分 配 的 临时 内 存在 过 
程 结尾 的 时 候 都 被 回收 ， 避 人 免 内 存 泄漏 。 


不 过 ， 如 果 你 的 过 程 需要 返回 一 个 已 分 配 的 内 存 对 象 ( 比 如 一 个 传递 引用 的 数据 类 型 )， 那么 

你 就 不 能 用 palloc 分 配 返 回 的 对 象 ， 至 少 是 不 能 在 你 已 经 和 SPI 连接 上 的 时 候 。 如 果 你 试 

图 这 么 做 ， 那么 该 对 象 将 在 sPI_finish 的 时 候 被 释放 ， 因而 你 的 过 程 就 不 能 可 靠 地 工作 了 ! 
要 解决 这 个 问题 ， 使 用 sPI_palloc 分 配 内 存 给 你 的 返回 对 象 。 sPI_palloc 从 "上 层 执行 者 环 
境 " 中 分 配 空间 ， 也 就 是 调用 spi_connect 时 候 的 当前 环境 内 存 环境 ， 该 环境 是 从 你 的 过 程 返 
回 数值 的 正确 环境 。 


如 果 还 没有 连接 到 SPI 的 时 候 调 用 它 ， sPI_palloc 的 行为 和 简单 的 palloc 一 样 。 在 一 个 过 
程 和 SPI 管理 器 连接 之 前 ， 当前 的 内 存 环境 是 上 层 执行 者 环境 ， 因 此 所 有 该 过 程 使 
用 palloc 或 者 SPI 工具 函数 分 配 的 空间 都 是 在 这 个 环境 中 分 配 的 。 


在 调用 sPI_connect 之 后 ， 当 前 环境 是 该 过 程 私有 的 ， 由 spPI_connect 制作 的 环境 。 所 有 通 
过 palloc 、 repalloc 或 者 SPI 工具 辑 数 ( 除 了 spr_copytuple 、 

SPI_returntuple 、 SPI_modifytuple 和 sPI_palloc ) 分 配 的 内 存 都 是 在 这 个 环境 中 分 配 的 。 
如 果 一 个 过 程 与 SPI 管理 器 断 开 (通过 spr finish )， 那么 当前 环境 恢复 为 上 层 执 行 器 环境 ， 
并 且 所 有 在 该 过 程 的 内 存 环境 中 分 配 的 内 存 都 释放 掉 并 且 不 能 再 次 使 用 ! 


所 有 在 本 节 内 描述 的 函数 都 可 以 在 已 连接 的 和 未 连接 的 过 程 中 使 用 。 在 未 连接 的 过 程 中 ， 他 
们 的 行为 和 下 层 的 原始 后 端 画 数 ( palloc 等 ) 相 同 。 
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SPI_palloc 


Name 


SPI_palloc -- 在 上 层 执行 器 环境 里 分 配 内 存 


Synopsis 


void * SPI_palloc(Size size) 


SPI_palloc 在 上 层 执行 者 环境 里 分 配 内 存 。 


参数 


Size size 


要 分 配 的 存储 空间 的 ， 以 字 节 记 


返回 值 


指向 声明 尺寸 的 新 空间 的 指针 


SPI_repalloc 


Name 


SPI_repalloc -- 在 上 层 执行 器 环境 里 重新 分 配 内 存 


Synopsis 


void * SPI_repalloc(void * pointer, Size size) 


Fea ah 
SPI_repalloc 改变 一 个 前 面 用 spr_palloc 分 配 的 内 存 段 的 大 小 。 


这 个 男 数 现在 和 repalloc 没什么 区 别 。 保 留 它 只 是 为 了 向 后 兼容 现 有 的 代码 。 


void * pointer 
一 个 指向 现 有 存储 的 指针 
Size size 


分 配 的 内 存 的 大 小 ， 以 字 节 记 


返回 值 


一 个 指向 新 存储 空间 的 指针 ， 大 小 为 你 声明 的 大 小 ， 并 且 从 现 有 区 域 里 拷贝 了 内 存 


SPI_pfree 


Name 


SPI_pfree -- 在 上 层 执行 器 环境 里 释放 内 存 


Synopsis 


void SPI_pfree(void * pointer) 


SPI_pfree 释放 前 面 用 SPI_palloc 或 SPI_repalloc 分 配 的 内 存 。 
ANKARI pfree 没什么 不 同 。 保 留 它 主要 是 为 了 向 下 兼容 现 有 代码 。 


void * pointer 


一 个 指向 要 释放 的 现 有 内 存 的 指针 


SPI copytuple 
Name 


SPI_copytuple -- 在 上 层 执 行者 环境 里 制作 一 个 行 的 拷 由 


Synopsis 


HeapTuple SPI_copytuple(HeapTuple row) 


SPI_copytuple 在 上 层 执行 者 环境 里 制作 一 个 行 的 拷贝 。 这 个 辑 数 通常 用 于 从 触发 器 里 返回 
一 个 修改 过 的 行 。 在 声明 为 返回 复合 类 型 的 函数 里 ， 应 该 使 用 SPI_returntuple 。 


参数 


HeapTuple row 


要 拷贝 的 行 


上 运 回 值 


拷贝 行 ; 只 有 在 tuple 是 NULL 的 时 候 为 NULL 


SPI returntuple 


Name 


SPI_returntuple -- 准 各 把 一 个 行当 作 Datum 返回 


Synopsis 


HeapTupleHeader SPI_returntuple(HeapTuple row, TupleDesc rowdesc) 


sPI_returntuple 在 上 层 执行 者 环境 里 制作 一 个 行 的 拷贝 ， 并 且 把 它 以 行 类 型 Datum 的 形式 
返回 。 所 返回 的 指针 在 返回 之 前 只 需要 用 pointerGetDatum 转换 成 Datum o 


请 注意 这 ee 明 为 返回 复合 类 型 的 范 数 。 它 不 用 于 触发 器 ; 
用 spPI_copytuple 在 触发 器 中 返回 一 个 修改 过 的 行 。 


Alz 
参数 
HeapTuple row 
将 要 被 拷贝 的 行 
TupleDesc rowdesc 


行 的 描述 符 (每 次 都 传递 同 祥 的 描述 符 可 以 获取 最 高 缓冲 效率 ) 


区 回 值 


指向 拷贝 出 来 的 行 的 HeapTupleHeader ; 只 有 在 row 或 rowdesc 是 NULL 的 时 候 才 返回 NULL 


SPL modifytuple 


Name 


SPl_modifytuple -- 通过 蔡 换 一 个 给 出 行 的 选 定 的 字段 创建 一 行 


Synopsis 


HeapTuple SPI_modifytuple(Relation rel, HeapTuple row, int ncols, 
int * colnum, Datum * values, const char * nulls) 


fia ah 


SPI_modifytuple 通过 给 选 定 的 字段 蔡 换 新 值 ， EN 贝 其 它 字段 的 原 值 的 方法 创建 一 个 新 行 。 不 ` 
修改 输入 的 行 。 


参数 


Relation rel 
只 用 于 该 行 的 行 描 述 符 的 源 ( 传 递 一 个 关系 而 不 是 一 个 行 描述 符 是 一 个 误 特性 )。 
HeapTuple row 
要 修改 的 行 
int ncols 
要 修改 的 字段 数目 
int * colnum 
长 度 ncols 的 一 个 数组 ， 包 含 要 修改 的 字段 的 数目 (字段 编号 从 1 开始 记 ) 
Datum * values 
KE ncols 的 一 个 数组 ， 包 含 声 明 字 段 的 新 值 
const char * nulls 


KE ncols 的 一 个 数组 ， 描 述 哪个 新 值 是 空 


如 果 nulls 是 NULL ， 那 么 spr_modifytuple 假设 没有 参数 为 空 。 否 则 ， 如 果 对 应 的 参数 值 是 
非 空 的 ， 那 么 nulls 数组 的 每 一 项 都 应 该 是 ' ' ， 或 者 如 果 对 应 的 参数 值 为 空 ， 那 么 

nulls 数组 的 每 一 项 都 是 'n' 。 (在 后 面 这 种 情况 下 ， 对 应 的 values 项 中 的 实际 值 无 关 紧 
要 。) 请 注意 ， nulls 不 是 文本 字符 串 ， 只 是 一 个 数组 : CHEE no 终止 符 。 


亿 回 值 


修改 后 的 新 行 ， 在 上 层 执 行者 环境 里 分 配 ; 只 有 在 row 是 NuLL 的 时 候 为 NULL 
+2 at, SPI_result 的 设置 如 下 : 


SPI_ERROR_ARGUMENT 


如 果 rel 是 NuLL ， 或 者 如 果 row 是 NuLL ， 或 者 如 果 ncols 小 于 或 者 等 于 0 ， 或 


者 colnum 是 NULL, 或 者 如 果 values 是 NULL o 


SPI_ERROR_NOATTRIBUTE 


如 果 colnum 包含 一 个 无 效 的 字段 编号 (小 于 或 者 等 于 0 或 者 大 于 row 里 的 字段 数 ) 


SPI freetuple 


Name 


SPI_freetuple -- 释放 在 上 层 执 行者 环境 里 分 配 的 一 行 


Synopsis 


void SPI_freetuple(HeapTuple row) 


SPI_freetuple 释放 一 个 前 面 在 上 层 执 行者 环境 里 分 配 的 行 。 


这 个 加 数 和 heap_freetuple 没什么 区 别 。 保 留 它 主要 是 为 了 向 后 兼容 现 有 代码 。 


HeapTuple row 


要 释放 的 行 


SPI freetuptable 


Name 


SPI_freetuptable -- 释放 一 个 由 spr_execute 或 者 类 似 的 函数 创建 的 行 集 


Synopsis 


void SPI_freetuptable(SPITupleTable * tuptable) 


SPI_freetuptable 释放 一 个 由 前 面 的 SPI 命令 执行 函数 ， 比如 spr_execute 创建 的 行 集 。 
此 ， 这 个 本 数 调用 的 时 候 通常 用 全 局 变量 SPI_tuptable 作为 参数 。 


如 果 一 个 SPI 过 程 需要 执行 多 条 命令 并 且 不 想 把 前 面 的 命令 的 结果 保存 到 其 结尾 的 话 ， 那么 
这 个 加 数 就 很 有 用 。 请 注意 任何 没有 释放 的 行 集 都 会 在 sPI_finish 的 时 候 释 放 。 另 外 ， 如 果 
一 个 子 事务 开始 并 且 然 后 在 一 个 SPI 过 程 的 执行 中 退出 ， 那么 SPI 自 动 释放 任何 子 事务 运行 时 
创建 的 行 集 。 


在 PostgreSQL 9.3 中 开始 ， sPI_freetuptable 包含 保护 逻辑 防卫 重复 请 求 删除 同一 个 行 集 。 
在 以 前 的 版 本 中 ， 重 复 删 除 将 会 导致 崩溃 。 


A LA 
参数 
SPITupleTable * tuptable 


一 个 指向 要 释放 的 行 集 的 指针 ， 或 者 什么 也 不 做 时 为 NULL 


SPI freeplan 


Name 
SPI_freeplan -- 释放 一 个 前 面 保存 的 预备 语句 
Synopsis 


int SPI_freeplan(SPIPlanPtr plan) 


SPI_freeplan 释放 一 个 以 前 由 SPI_prepare 返回 的 或 者 是 用 SPI_keepplan 或 SPI_saveplan 
保存 的 预备 语句 。 


参数 


SPIPlanPtr plan 


指向 要 释放 的 语句 的 指针 


上 运 回 值 


成 功 时 为 0 ; 如 果 plan 是 NULL 或 无 效 ， 返回 SPI_ERROR_ARGUMENT 


44.4. 效 据 改变 的 可 视 性 


下 面 规则 决定 使 用 SPI( 或 者 任何 其 它 C 画 数 ) 的 函数 里 面 的 数据 修改 的 可 视 性 : 


e 在 一 个 SQL 间 ， 任 何 这 个 命令 做 的 数据 改变 都 是 命令 本 身 所 看 不 到 的 。 比 
如 ， 在 下 面 命令 里 


INSERT INTO a SELECT * FROM a; 


插入 的 行 是 sELEcT 部 分 看 不 到 的 。 


。 命令 C 做 的 修改 可 以 被 C 之 后 开始 的 所 有 命令 看 到 ， 不 管 他 们 是 在 C 里 面 (在 执行 CH 
间 ) 还 是 在 C 完成 后 开始 的 。 


。 一 个 命 舍 ， 如 果 是 在 一 个 SQL 命 命 调 用 的 函数 (普通 函数 或 者 是 触发 器 ) 里 通过 SPI 执行 
的 ， 那么 它 遵 循 上 面 两 个 规则 之 一 ， 上 县 体 哪个 取决 于 传递 给 SPI 的 读 / 写 标志 。 以 只 读 
模式 执行 的 命 爸 遵 循 第 一 条 规则 : 它们 看 不 见 调用 它 的 命令 做 的 修改 。 以 读 写 模式 执行 
的 规则 遵循 第 二 条 规则 : 它们 可 以 看 到 泛 今 为 止 所 做 的 所 有 改变 。 


e。 所 有 标准 的 过 程 语言 都 根据 函数 的 易 失 性 属性 设置 SPI 读 写 模式 。 STABLE 
和 IMMUTABLE 豆 数 是 以 只 读 模 式 设置 的 ， 而 voatr 豆 数 是 以 读 写 模 式 设置 的 。 虽 然 其 
E C 加 数 可 以 违反 这 个 规定 ， 但 是 这 么 做 不 是 好 事 。 


下 一 节 里 包含 一 些 例子 ， 演 示 了 这 些 规则 的 应 用 。 


44.5. 例子 


这 是 一 个 非常 简单 的 SPI 使 用 的 例子 。 过 程 execq 在 其 第 一 个 参数 里 接收 一 个 SQL HF, 
第 二 个 参数 接收 一 个 行 计 数 ， 用 spI_exec 执行 这 个 查询 并 且 返 回 查 询 执行 过 的 记录 个 数 。 
你 可 以 在 src/test/regress/regress.c 中 的 源码 树 和 spi 模 块 里 找 更 复杂 的 例子 。 


#include "postgres.h" 


#include "executor/spi.h" 
#include "utils/builtins.h" 


#ifdef PG_MODULE_MAGIC 
PG_MODULE_MAGIC; 
#endif 


int execq(text *sql, int cnt); 
int 


execq(text *sql, int cnt) 


{ 


char *command; 
int ret; 
int proc; 


/* ”把 给 出 的 text 对 象 转换 成 C 字符 串 */ 
command = text_to_cstring(sql); 


SPI_connect(); 
ret = SPI_exec(command, cnt); 


proc = SPI_processed; 


ee 

* 如 果 取出 了 一 些 行 ， 通 过 elog(INFO) 打印 它们 
z 
if (ret > © && SPI_tuptable != NULL) 
{ 


TupleDesc tupdesc = SPI_tuptable->tupdesc; 
SPITupleTable *tuptable = SPI_tuptable; 
char buf[8192]; 

int aby jy 


for (j = 0; j < proc; j++) 


{ 
HeapTuple tuple = tuptable->vals[j]; 
for (i = 1, buf[0] = 0; i <= tupdesc->natts; i++) 
snprintf (buf + strlen (buf), sizeof(buf) - strlen(buf), " %s%s", 
SPI_getvalue(tuple, tupdesc, i), 
(i == tupdesc->natts) ? " " : " |"); 
elog(INFO, "EXECQ: %s", buf); 
} 


} 


SPI_finish(); 
pfree(command) ; 


return (proc); 


这 个 事 数 使 用 了 调用 习惯 版 本 0 ， 为 了 是 让 例子 更 容易 理解 。 在 真实 的 应 用 里 ， 你 应 该 使 用 
新 的 版 本 1 的 接口 。 


下 面 是 你 在 把 函数 编译 成 共享 库 之 后 声明 它 的 方法 (详情 请 看 Section 35.9.6) 


CREATE FUNCTION execq(text, integer) RETURNS integer 
AS '_filename_' 
LANGUAGE C; 


下 面 是 一 个 会 话 例子 : 


=> SELECT execq('CREATE TABLE a (x integer)', 0); 
execq 


=> INSERT INTO a VALUES (execq('INSERT INTO a VALUES (0)', 0)); 
INSERT © 1 

=> SELECT execq('SELECT * FROM a', 0); 

INFO: EXECQ: 0 -- execq 插 入 © 47 

INFO: EXECQ: 1 -- execq 返回 ， 被 上 层 INSERT 插入 


execq 


=> SELECT execq('SELECT * FROM a', 10); 

INFO: EXECQ: 0 

INFO: EXECQ: 1 

INFO: EXECQ: 2 -- 9 + 2, 就 像 声明 的 那样 只 插入 了 一 行 


=> DELETE FROM a; 

DELETE 3 

=> INSERT INTO a VALUES (execq('SELECT * FROM a', 0) + 1); 
INSERT 0 1 

=> SELECT * FROM a; 


1 -- 在 (9)+1 里 面 没有 行 
(1 row) 


=> INSERT INTO a VALUES (execq('SELECT * FROM a', 0) + 1); 
INFO: EXECQ: 1 

INSERT © 1 

=> SELECT * FROM a; 


2 -- 在 atl 里 面 有 一 行 
(2 rows) 


-- 下 面 示范 了 改变 数据 可 视 性 的 规则 : 


=> INSERT INTO a SELECT execq('SELECT * FROM a', ©) * x FROM a; 


INFO: EXECQ: 1 
INFO: EXECQ: 2 
INFO: EXECQ: 1 
INFO: EXECQ: 2 
INFO: EXECQ: 2 


INSERT © 2 
=> SELECT * FROM a; 
X 


4 

2 

2 -- 247 * 1 (x ERIT) 

6 -- 3 行 (2 + 1 刚刚 插入 的 ) * 2 (第 二 行 里 的 x) 
(4 rows) ANAAAN 


在 不 同 的 调用 里 execq() 看 到 的 东西 不 同 


Chapter 45. 后 台 工 作 进 程 


PostgreSQL 可 以 扩展 在 分 立 的 进程 中 运行 用 户 提供 的 代码 。 命令 postgres 启动 ， 停止 和 监 
控 这 些 进 程 ， 人 允许 它们 的 生命 周期 与 服务 器 状态 紧密 关联 。 这 些 进程 可 以 选择 连接 
PostgreSQL 的 共享 内 存 并 与 数据 库 内 部 连接 ; 它们 也 可 以 串 行 地 运行 多 个 事务 ， 就 像 常规 的 
客户 端 连接 的 服务 器 进程 。 另 外 ， 通 过 链接 到 libpq， 它 们 可 以 连接 到 服务 器 并 且 和 常规 的 客 
户 端 应 用 表现 一 样 。 


Warning 


使 用 后 台 工 作 进 程 有 着 相当 大 的 牢固 和 安全 风险 。 这 是 因为 它们 是 用 C 语 言 写 的 ， 有 着 不 
受 限 制 的 数据 访问 方式 。 乐 于 使 用 包含 后 台 工 作 进 程 的 模块 的 管理 员 们 应 当 极 度 地 当 
心 。 只 有 仔细 审计 过 的 模块 才 应 该 被 允许 运行 后 台 工 作 进 程 。 


只 有 shared_preload_libraries 里 列 出 的 模块 能 够 运行 后 台 工 作 进 程 。 想 要 运行 后 台 工 作 程 
序 的 模块 需要 通过 从 它 的 _pc_init() 调用 RegisterBackgroundworker( BackgroundWorker 
*worker ) 来 注册 这 个 程序 。 Backgroundworker 结构 是 这 样 定义 的 : 


typedef void (*bgworker_main_type)(void *main_arg); 
typedef struct Backgroundworker 


{ 
char bgw_name[BGW_MAXLEN]; 
int bgw_flags; 
BgWorkerStartTime bgw_start_time; 
int bgw_restart_time; /* in seconds, or BGW_NEVER_RESTART */ 
bgworker_main_type bgw_main; 
Datum bgw_main_arg; 


} Backgroundworker; 


bgw_name 是 用 于 日 志 消 息 ， 进 程 列 表 和 类 似 环 境 的 一 个 字符 串 。 


bgw_flags 是 一 个 按 位 与 的 比特 掩 码 ， 显 示 模 块 想 要 的 容量 。 可 能 的 值 有 
BGWORKER_SHMEM_ACCESS 《要 求 访 问 共 享 内 存 ) 和 

BGWORKER_BACKEND_DATABASE_CONNECTION 《要 求 能 够 建立 一 个 数据 库 连 接 ， 通 过 这 个 连接 伺候 
可 以 运行 事务 和 查询 ) 。 一 个 使 用 BGWORKER_BACKEND_DATABASE_CONNECTION 连接 数据 库 的 后 台 
工作 程序 还 必须 用 BGwoRKER_SHMEM_ACCESS 联接 共享 内 存 ， 否 则 程序 的 启动 会 失败 。 


bgw_start_time 是 某 种 服务 器 状态 ， 在 此 期 间 应 当 由 postgres 启动 进程 ; 它 可 以 是 下 面 几 
个 值 之 一 : BgWorkerStart_PostmasterStart ( postgres 完成 自身 初始 化 后 就 立即 启动 iF 
求 此 种 启动 方式 的 进程 不 能 进行 数据 库 连 接 ) ， Bgworkerstart_consistentstate (R 
个 热 备份 系统 中 达到 了 一 至 状态 嗣后 动 。 TCH aE SUP SIT GER HH) , 
BgWorkerStart_RecoveryFinished 《只 要 系统 进入 普通 读 写 状态 就 启动 ) 。 cere 
ARS a Pea ASA. FRLABRERER BAN EM; 进入 不 同 状态 时 
进程 不 停 。 


bgw_restart_time 是 以 秒 记 的 时 间 间 隔 。 一 旦 进程 骨 溃 ， postgres 应 当 在 重启 进程 前 等 待 这 
一 段 时 间 。 它 可 以 是 任何 的 正 值 ， 或 者 是 Bew_NEVER_RESTART 以 表明 在 进程 月 溃 时 不 重启 进 


程 。 


bgw_main 是 当 进 程 被 启动 时 指向 所 运行 本 数 的 一 个 指针 。 该 函数 必须 使 用 void * 类 型 的 单 
一 参数 并 返回 void 类 型 的 值 。 bgw_main_arg 将 作为 唯一 参数 被 传递 给 此 函数 。 注 意 全 局 变 


量 MyBgworkerEntry 指向 进程 注册 时 传递 的 Backgroundworker 结构 的 一 份 拷 贝 。 


进程 一 旦 运行 ， 就 可 以 通过 调用 BackgroundworkerInitializeconnection( char dbname , char 
username ) 连接 到 一 个 数据 库 。 这 样 进程 可 以 使 用 spr i 如 果 

dbname 值 为 NULL， 会 话 不 被 连接 到 任何 特定 数据 库 ， 但 是 可 以 获取 共享 的 目录 。 如 果 
username 值 为 NULL， 进 程 会 以 initdb ee 每 个 后 台 进 程 只 
能 调用 一 次 BackgroundWorkerlnitializeConnection， 它 不 能 切换 数据 库 。 


Signals are initially blocked when control reaches the 控制 bgw_main WAF IRM EES, # 
且 必 须 由 此 郴 数 解锁 ; 这 样 在 必要 时 可 以 允许 进程 定制 它 的 信号 处 理 程序 。 通 过 调 

用 BackgroundworkerUnblockSignals F 可 以 在 新 进 Ht RE 中 为 信号 解锁 ， 通过 调 

用 BackgroundwWorkerBlockSignals 可 以 加 锁 。 


后 台 工 作 程序 是 被 预期 连续 运行 的 ; 如 果 它 们 干净 的 退出 了 ， postgres 会 立即 重启 它们 。 4 
它们 无 事 可 做 时 ， 考 虑 进入 可 中 断 的 睡眠 ; 通过 调用 waitLatch() 可 以 实现 这 一 点 。 调 用 该 

Peat HATE WL_POSTMASTER_DEATH 标志 被 设置 ， 并 且 在 postgres 自身 终止 的 紧急 情况 下 为 提 

示 的 退出 验证 返回 码 。 


worker_spi contrib 模 块 包含 一 个 展示 一 些 有 用 技术 的 范例 。 


VI 参考 手册 


这 份 参考 里 的 条 目 给 各 个 相关 对 象 提供 了 权威 、 完 整 、 正式 的 概要 。 有 关 使 用 PostgreSQL 的 
更 多 信息 (叙述 、 教 程 、 例 子 )， 可 以 在 本 书 的 其 它 部 分 找到 。 参 阅 在 每 个 参考 页 里 的 交叉 引 
用 。 


参考 手册 里 的 条 目 也 可 以 在 传统 的 "man" 页 里 获得 。 
Table of Contents 

。 |. SLAS 
ABORT -- 放弃 当前 事务 
ALTER AGGREGATE -- 修改 一 个 聚集 函数 的 定义 
ALTER COLLATION -- 修改 一 个 排序 规则 定义 
ALTER CONVERSION -- 修改 编码 转换 的 定义 
ALTER DATABASE -- 修改 一 个 数据 库 
ALTER DEFAULT PRIVILEGES -- 定义 默认 的 访问 权限 
ALTER DOMAIN -- 修改 一 个 域 的 定义 
ALTER EXTENSION -- 修改 扩展 定义 
ALTER EVENT TRIGGER -- 修改 事件 触发 器 的 定义 
ALTER FOREIGN DATA WRAPPER -- 修改 外 来 数据 抓 取 的 定义 
ALTER FOREIGN TABLE -- 修改 外 部 表 的 定义 
ALTER FUNCTION -- 修改 一 个 函数 的 定义 
ALTER GROUP -- 修改 角色 名 或 者 成 员 关 系 
ALTER INDEX -- 改变 一 个 索引 的 定义 
ALTER LANGUAGE -- 修改 一 个 过 程 语言 的 定义 
ALTER LARGE OBJECT -- change the definition of a large object 
ALTER MATERIALIZED VIEW -- 修改 物化 视图 的 定义 
ALTER OPERATOR -- 修改 一 个 操作 符 的 定义 


ALTER OPERATOR CLASS -- 修改 一 个 操作 符 类 的 定义 


ALTER OPERATOR FAMILY -- 修改 操作 符 族 的 定义 

ALTER ROLE -- 修改 一 个 数据 库 角色 

ALTER RULE -- 修改 一 个 规则 的 定义 

ALTER SCHEMA -- 修改 一 个 模式 的 定义 

ALTER SEQUENCE -- 更 改 一 个 序列 生成 器 的 定义 

ALTER SERVER -- 更 改 外 部 服务 器 的 定义 

ALTER TABLE -- 修改 表 的 定义 

ALTER TABLESPACE -- 修改 一 个 表 空 间 的 定义 

ALTER TEXT SEARCH CONFIGURATION -- 更 改 文 本 搜索 配置 的 定义 
ALTER TEXT SEARCH DICTIONARY -- 更 改 文本 搜索 字典 的 定义 。 
ALTER TEXT SEARCH PARSER -- 更 改 一 个 文本 搜索 解析 器 的 定义 
ALTER TEXT SEARCH TEMPLATE -- 更 改 文本 搜索 模板 的 定义 
ALTER TRIGGER -- 修改 一 个 触发 器 的 定义 

ALTER TYPE -- 修改 一 个 类 型 的 定义 。 

ALTER USER -- 修改 一 个 数据 库 角色 。 

ALTER USER MAPPING -- 更 改 用 户 映射 的 定义 

ALTER VIEW -- 更 改 视图 定义 

ANALYZE -- 收集 与 数据 库 有 关 的 统计 信息 

BEGIN -- 开始 一 个 事务 块 

CHECKPOINT -- 强制 一 个 事务 日 志 检 查 点 

CLOSE -- 关闭 游标 

CLUSTER -- 根据 一 个 索引 对 某 个 表盘 簇 化 排序 

COMMENT -- 定义 或 者 改变 一 个 对 象 的 注释 

COMMIT -- 提交 当前 事务 

COMMIT PREPARED -- 提交 一 个 早先 为 两 阶段 提交 准备 好 的 事务 
COPY -- 在 表 和 文件 之 间 拷 贝 数据 


CREATE AGGREGATE -- 定义 一 个 新 的 聚集 事 数 
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CREATE CAST -- 定义 一 个 用 户 定义 的 转换 

CREATE COLLATION -- 定义 一 个 新 的 排序 规则 
CREATE CONVERSION -- 定义 一 个 新 的 编码 转换 
CREATE DATABASE -- 创建 一 个 新 数据 库 

CREATE DOMAIN -- 定义 一 个 新 域 

CREATE EXTENSION -- 安装 一 个 扩展 

CREATE EVENT TRIGGER -- 定义 一 个 事件 触发 器 
CREATE FOREIGN DATA WRAPPER -- 定义 一 个 外 部 数据 封装 器 
CREATE FOREIGN TABLE -- 定义 一 个 新 外 部 表 
CREATE FUNCTION -- 定义 一 个 新 函数 

CREATE GROUP -- 定义 一 个 新 数据 库 角 色 

CREATE INDEX -- 创建 一 个 索引 

CREATE LANGUAGE -- define a new procedural language 
CREATE MATERIALIZED VIEW -- 定义 一 个 物化 视图 
CREATE OPERATOR -- 定义 一 个 新 操作 符 

CREATE OPERATOR CLASS -- 定义 一 个 新 操作 符 类 
CREATE OPERATOR FAMILY -- 定义 一 个 新 操作 符 族 
CREATE ROLE -- 定义 一 个 新 的 数据 库 角色 

CREATE RULE -- 定义 一 个 新 重 写 规 则 

CREATE SCHEMA -- 定义 一 个 新 模式 

CREATE SEQUENCE -- 定义 一 个 新 序列 发 生 器 
CREATE SERVER -- 定义 一 个 新 的 外 服务 器 

CREATE TABLE -- 定义 一 个 新 表 

CREATE TABLE AS -- 从 一 条 查询 的 结果 中 定义 一 个 新 表 


CREATE TABLESPACE -- 定义 一 个 新 的 表 空 间 


CREATE TEXT SEARCH CONFIGURATION -- 定义 一 个 新 的 文本 搜索 配置 


CREATE TEXT SEARCH DICTIONARY -- 定义 一 个 新 的 文本 搜索 字典 
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CREATE TEXT SEARCH PARSER -- 定义 一 个 新 的 文本 搜索 的 解析 器 


CREATE TEXT SEARCH TEMPLATE -- 定义 一 个 新 的 文本 搜索 模板 


CREATE TRIGGER -- 定义 一 个 新 触发 器 
CREATE TYPE -- 定义 一 个 新 数据 类 型 


CREATE USER -- 定义 一 个 新 数据 库 角色 


CREATE USER MAPPING -- 定义 一 个 新 的 用 户 到 外 部 服务 器 的 映射 


CREATE VIEW -- 定义 一 个 新 视图 
DEALLOCATE -- 删除 一 个 预备 语句 

DECLARE -- 定义 一 个 游标 

DELETE -- 删除 一 个 表 中 的 行 

DISCARD -- 丢弃 会 话 状态 

DO -- 执行 匿名 代码 块 

DROP AGGREGATE -- 删除 一 个 聚集 画 数 
DROP CAST -- 删除 一 个 类 型 转换 

DROP COLLATION -- 删除 一 个 排序 规则 

DROP CONVERSION -- 删除 一 个 编码 转换 
DROP DATABASE -- 删除 一 个 数据 库 

DROP DOMAIN -- 删除 一 个 域 

DROP EXTENSION -- 删除 一 个 扩展 

DROP EVENT TRIGGER -- 删除 一 个 事件 触发 器 
DROP FOREIGN DATA WRAPPER -- 删除 一 个 外 部 数据 封装 
DROP FOREIGN TABLE -- 删除 一 个 外 部 表 
DROP FUNCTION -- 删除 一 个 画 数 

DROP GROUP -- 删除 一 个 数据 库 角色 

DROP INDEX -- 删除 索引 

DROP LANGUAGE -- 删除 一 个 过 程 语言 


DROP MATERIALIZED VIEW -- 删除 一 个 物化 视图 
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DROP OPERATOR -- 删除 一 个 操作 符 

DROP OPERATOR CLASS -- 删除 一 个 操作 符 类 

DROP OPERATOR FAMILY -- 删除 一 个 操作 符 族 

DROP OWNED -- 删除 一 个 数据 库 角色 所 拥有 的 数据 库 对 象 
DROP ROLE -- 删除 一 个 数据 库 角 色 

DROP RULE -- 删除 一 个 重 宇 规 则 

DROP SCHEMA -- 删除 一 个 模式 

DROP SEQUENCE -- 删除 一 个 序列 

DROP SERVER -- 删除 一 个 外 部 服务 器 描述 符 

DROP TABLE -- 删除 一 个 表 

DROP TABLESPACE -- 删除 一 个 表 空 间 

DROP TEXT SEARCH CONFIGURATION -- 删除 一 个 文本 搜索 配置 
DROP TEXT SEARCH DICTIONARY -- 删除 一 个 文本 搜索 字典 
DROP TEXT SEARCH PARSER -- 删除 一 个 文本 搜索 解析 器 
DROP TEXT SEARCH TEMPLATE -- 删除 一 个 文本 搜索 模板 
DROP TRIGGER -- 删除 一 个 触发 器 

DROP TYPE -- 删除 一 个 数据 类 型 

DROP USER -- 删除 一 个 数据 库 角色 

DROP USER MAPPING -- 删除 用 户 的 外 部 服务 器 映射 
DROP VIEW -- 删除 一 个 视图 

END -- 提交 当前 事务 

EXECUTE -- 执行 一 个 预备 语句 

EXPLAIN -- 显示 一 个 语句 的 执行 规划 

FETCH -- 用 游标 从 查询 中 抓 取 行 

GRANT -- 赋予 访问 权限 

INSERT -- 在 表 中 创建 新 行 


LISTEN -- 监听 一 个 通知 
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LOAD -- 加 载 一 个 共享 库 文 件 

LOCK -- 锁定 一 个 表 

MOVE -- 定位 一 个 游标 

NOTIFY -- 生成 一 个 通知 

PREPARE -- 创建 一 个 预备 语句 

PREPARE TRANSACTION -- 为 当前 事务 做 两 阶段 提交 的 准备 
REASSIGN OWNED -- 修改 数据 库 对 象 的 属 主 

REFRESH MATERIALIZED VIEW -- 替换 物化 视图 的 内 容 
REINDEX -- 重建 索引 

RELEASE SAVEPOINT -- 删除 一 个 先前 定义 的 保存 点 

RESET -- 把 一 个 运行 时 参数 重 置 为 缺 省 值 

REVOKE -- 删除 访问 权限 

ROLLBACK -- 退出 当前 事务 

ROLLBACK PREPARED -- 取消 一 个 先前 为 两 阶段 提交 准备 好 的 事务 
ROLLBACK TO SAVEPOINT -- 回 滚 到 一 个 保存 点 
SAVEPOINT -- 在 当前 事务 里 定义 一 个 新 保存 点 

SECURITY LABEL -- 定义 或 改变 一 个 应 用 于 对 象 的 安全 标签 
SELECT -- 从 表 或 视图 中 取出 若干 行 

SELECT INTO -- 从 一 条 查询 的 结果 中 定义 一 个 新 表 

SET -- 修改 运行 时 参数 

SET CONSTRAINTS -- 设置 当前 事务 的 约束 检查 模式 

SET ROLE -- 在 当前 会 话 中 设置 当前 用 户 标识 

SET SESSION AUTHORIZATION -- 为 当前 会 话 设置 会 话 用 户 标识 符 和 当前 用 户 标识 符 
SETTRANSACTION -- 设置 当前 事务 的 特性 

SHOW -- 显示 运行 时 参数 的 值 

START TRANSACTION -- 开始 一 个 事务 块 


TRUNCATE -- 清空 一 个 或 一 组 表 


UNLISTEN -- 停止 监听 通知 信息 
UPDATE -- 更 新 一 个 表 中 的 行 
VACUUM -- 垃圾 收集 以 及 可 选 地 分 析 一 个 数据 库 
VALUES -- 计算 一 个 或 一 组 行 
e |l. PostgreSQL 客户 端 应 用 程序 
clusterdb -- cluster a PostgreSQL database 
createdb -- 创建 一 个 新 PostgreSQL 数据 库 
createlang -- 安装 一 个 PostgreSQL 过 程 语言 
createuser -- 创建 一 个 新 的 PostgreSQL 用 户 帐 户 
dropdb -- 删除 一 个 PostgreSQL HE = 
droplang -- 删除 一 个 PostgreSQL 过 程 语言 
dropuser -- 删除 一 个 PostgreSQL 用 户 账户 
ecpg -- RABY SQL C 预 处 理 器 
pg_basebackup -- 做 一 个 PostgreSQL 集群 的 基础 备份 
pg_config -- retrieve information about the installed version of PostgreSQL 
pg_dump -- 将 一 个 PostgreSQL 数 据 库 转 储 到 一 个 脚本 文件 或 者 其 它 兴 档 文件 中 
pg_dumpall -- 将 一 个 PostgreSQL 数 据 库 集群 转 储 到 一 个 脚本 文件 中 
pg_isready -- check the connection status of a PostgreSQL server 
pg_receivexlog -- PostgreSQL 集群 中 的 流 事 务 日 志 
pg_restore -- 从 pg_dump 创 建 的 各 份 文件 中 恢复 PostgreSQL 数 据 库 
psql -- PostgreSQL 交 互 终端 
reindexdb -- 重建 PostgreSQL 数 据 库 索引 
vacuumdb -- 收集 垃圾 并 分 析 一 个 PostgreSQL 数 据 库 
。 Ill. PostgreSQL 服务 器 应 用 程序 
initdb -- 创建 一 个 新 的 PostgreSQL 数 据 库 徐 (cluster) 
pg_controldata -- 显示 一 个 集群 的 控制 信息 


pg_ctl -- initialize, start, stop, or control a PostgreSQL server 


pg_resetxlog -- 重 置 一 个 数据 库 集 群 的 预 写 日 志 以 及 其 它 控制 内 容 
postgres -- PostgreSQL 数据 库 服 务 器 


postmaster -- PostgreSQL 数据 库 服务 器 


I. SQL 命令 


这 部 分 包含 那些 PostgreSQL 支 持 的 SQL 命令 的 信息 。 
每 条 


条 命令 的 标准 兼容 性 信息 可 以 在 相关 的 参考 页 中 找到 。 
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ABORT -- 放弃 当前 事务 

ALTER AGGREGATE -- 修改 一 个 聚集 函数 的 定义 
ALTER COLLATION -- 修改 一 个 排序 规则 定义 

ALTER CONVERSION -- 修改 编码 转换 的 定义 

ALTER DATABASE -- 修改 一 个 数据 库 

ALTER DEFAULT PRIVILEGES -- 定义 默认 的 访问 权限 
ALTER DOMAIN -- 修改 一 个 域 的 定义 

ALTER EXTENSION -- 修改 扩展 定义 

ALTER EVENT TRIGGER -- 修改 事件 触发 器 的 定义 
ALTER FOREIGN DATA WRAPPER -- 修改 外 来 数据 抓 取 的 定义 
ALTER FOREIGN TABLE -- 修改 外 部 表 的 定义 

ALTER FUNCTION -- 修改 一 个 函数 的 定义 

ALTER GROUP -- 修改 角色 名 或 者 成 员 关 系 

ALTER INDEX -- 改变 一 个 索引 的 定义 

ALTER LANGUAGE -- 修改 一 个 过 程 语言 的 定义 

ALTER LARGE OBJECT -- change the definition of a large object 
ALTER MATERIALIZED VIEW -- 修改 物化 视图 的 定义 
ALTER OPERATOR -- 修改 一 个 操作 符 的 定义 

ALTER OPERATOR CLASS -- 修改 一 个 操作 符 类 的 定义 
ALTER OPERATOR FAMILY -- 修改 操作 符 族 的 定义 
ALTER ROLE -- 修改 一 个 数据 库 角 色 

ALTER RULE -- 修改 一 个 规则 的 定义 

ALTER SCHEMA -- 修改 一 个 模式 的 定义 

ALTER SEQUENCE -- 更 改 一 个 序列 生成 器 的 定义 
ALTER SERVER -- 更 改 外 部 服务 器 的 定义 

ALTER TABLE -- 修改 表 的 定义 

ALTER TABLESPACE -- 修改 一 个 表 空 间 的 定义 


ALTER TEXT SEARCH CONFIGURATION -- 更 改 文本 搜索 配置 的 定义 


ALTER TEXT SEARCH DICTIONARY -- 更 改 文 本 搜索 字典 的 定义 。 
ALTER TEXT SEARCH PARSER -- 更 改 一 个 文本 搜索 解析 器 的 定义 
ALTER TEXT SEARCH TEMPLATE -- 更 改 文 本 搜索 模板 的 定义 
ALTER TRIGGER -- 修改 一 个 触发 器 的 定义 


这 里 的 "SQL" 就 是 该 语 


通常 的 含义 ; 


ALTER TYPE -- 修改 一 个 类 型 的 定义 。 

ALTER USER -- 修改 一 个 数据 库 角 色 。 

ALTER USER MAPPING -- 更 改 用 户 映射 的 定义 

ALTER VIEW -- 更 改 视图 定义 

ANALYZE -- 收集 与 数据 库 有 关 的 统计 信息 

BEGIN -- 开始 一 个 事务 块 

CHECKPOINT -- 强制 一 个 事务 日 志 检查 点 

CLOSE -- 关闭 游标 

CLUSTER -- 根据 一 个 索引 对 某 个 表盘 簇 化 排序 
COMMENT -- 定义 或 者 改变 一 个 对 象 的 注释 

COMMIT -- 提交 当前 事务 

COMMIT PREPARED -- 提交 一 个 早先 为 两 阶段 提交 准备 好 的 事务 
COPY -- 在 表 和 文件 之 间 找 贝 数据 

CREATE AGGREGATE -- 定义 一 个 新 的 聚集 加 数 

CREATE CAST -- 定义 一 个 用 户 定义 的 转换 

CREATE COLLATION -- 定义 一 个 新 的 排序 规则 

CREATE CONVERSION -- 定义 一 个 新 的 编码 转换 
CREATE DATABASE -- 创建 一 个 新 数据 库 

CREATE DOMAIN -- 定义 一 个 新 域 

CREATE EXTENSION -- 安装 一 个 扩展 

CREATE EVENT TRIGGER -- 定义 一 个 事件 触发 器 
CREATE FOREIGN DATA WRAPPER -- 定义 一 个 外 部 数据 封装 器 
CREATE FOREIGN TABLE -- 定义 一 个 新 外 部 表 

CREATE FUNCTION -- 定义 一 个 新 画 数 

CREATE GROUP -- 定义 一 个 新 数据 库 角色 

CREATE INDEX -- 创建 一 个 索引 

CREATE LANGUAGE -- define a new procedural language 
CREATE MATERIALIZED VIEW -- 定义 一 个 物化 视图 
CREATE OPERATOR -- 定义 一 个 新 操作 符 

CREATE OPERATOR CLASS -- 定义 一 个 新 操作 符 类 
CREATE OPERATOR FAMILY -- 定义 一 个 新 操作 符 族 
CREATE ROLE -- 定义 一 个 新 的 数据 库 角 色 

CREATE RULE -- 定义 一 个 新 重 写 规则 

CREATE SCHEMA -- 定义 一 个 新 模式 

CREATE SEQUENCE -- 定义 一 个 新 序列 发 生 器 

CREATE SERVER -- 定义 一 个 新 的 外 服务 器 

CREATE TABLE -- 定义 一 个 新 表 

CREATE TABLE AS -- 从 一 条 查询 的 结果 中 定义 一 个 新 表 
CREATE TABLESPACE -- 定义 一 个 新 的 表 空 间 

CREATE TEXT SEARCH CONFIGURATION -- 定义 一 个 新 的 文本 搜索 配置 
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CREATE TEXT SEARCH DICTIONARY -- 定义 一 个 新 的 文本 搜索 字典 
CREATE TEXT SEARCH PARSER -- 定义 一 个 新 的 文本 搜索 的 解析 器 


CREATE TEXT SEARCH TEMPLATE -- 定义 一 个 新 的 文本 搜索 模板 
CREATE TRIGGER -- 定义 一 个 新 触发 器 

CREATE TYPE -- 定义 一 个 新 数据 类 型 

CREATE USER -- 定义 一 个 新 数据 库 角 色 

CREATE USER MAPPING -- 定义 一 个 新 的 用 户 到 外 部 服务 器 的 映射 
CREATE VIEW -- 定义 一 个 新 视图 

DEALLOCATE -- 删除 一 个 预备 语句 

DECLARE -- 定义 一 个 游标 

DELETE -- 删除 一 个 表 中 的 行 

DISCARD -- 丢弃 会 话 状态 

DO -- 执行 匿名 代码 块 

DROP AGGREGATE -- 删除 一 个 聚集 男 数 

DROP CAST -- 删除 一 个 类 型 转换 

DROP COLLATION -- 删除 一 个 排序 规则 

DROP CONVERSION -- 删除 一 个 编码 转换 

DROP DATABASE -- 删除 一 个 数据 库 

DROP DOMAIN -- 删除 一 个 域 

DROP EXTENSION -- 删除 一 个 扩展 

DROP EVENT TRIGGER -- 删除 一 个 事件 触发 器 

DROP FOREIGN DATA WRAPPER -- 删除 一 个 外 部 数据 封装 
DROP FOREIGN TABLE -- 删除 一 个 外 部 表 

DROP FUNCTION -- 删除 一 个 函数 

DROP GROUP -- 删除 一 个 数据 库 角 色 

DROP INDEX -- 删除 索引 

DROP LANGUAGE -- 删除 一 个 过 程 语 言 

DROP MATERIALIZED VIEW -- 删除 一 个 物化 视图 

DROP OPERATOR -- 删除 一 个 操作 符 

DROP OPERATOR CLASS -- 删除 一 个 操作 符 类 

DROP OPERATOR FAMILY -- 删除 一 个 操作 符 族 

DROP OWNED -- 删除 一 个 数据 库 角 色 所 拥有 的 数据 库 对 象 
DROP ROLE -- 删除 一 个 数据 库 角 色 

DROP RULE -- 删除 一 个 重 写 规 则 

DROP SCHEMA -- 删除 一 个 模式 

DROP SEQUENCE -- 删除 一 个 序列 

DROP SERVER -- 删除 一 个 外 部 服务 器 描述 符 

DROP TABLE -- 删除 一 个 表 

DROP TABLESPACE -- 删除 一 个 表 空 间 

DROP TEXT SEARCH CONFIGURATION -- 删除 一 个 文本 搜索 配置 
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DROP TEXT SEARCH DICTIONARY -- 删除 一 个 文本 搜索 字典 
DROP TEXT SEARCH PARSER -- 删除 一 个 文本 搜索 解析 器 
DROP TEXT SEARCH TEMPLATE -- 删除 一 个 文本 搜索 模板 
DROP TRIGGER -- 删除 一 个 触发 器 

DROP TYPE -- 删除 一 个 数据 类 型 

DROP USER -- 删除 一 个 数据 库 角 色 

DROP USER MAPPING -- 删除 用 户 的 外 部 服务 器 映射 

DROP VIEW -- 删除 一 个 视图 

END -- 提交 当前 事务 

EXECUTE -- 执行 一 个 预备 语句 

EXPLAIN -- 显示 一 个 语句 的 执行 规划 

FETCH -- 用 游标 从 查询 中 抓 取 行 

GRANT -- 赋予 访问 权限 

INSERT -- 在 表 中 创建 新 行 

LISTEN -- 监听 一 个 通知 

LOAD -- 加 载 一 个 共享 库 文 件 

LOCK -- 锁定 一 个 表 

MOVE -- 定位 一 个 游标 

NOTIFY -- 生成 一 个 通知 

PREPARE -- 创建 一 个 预备 语句 

PREPARE TRANSACTION -- 为 当前 事务 做 两 阶段 提交 的 准 各 
REASSIGN OWNED -- 修改 数据 库 对 象 的 属 主 

REFRESH MATERIALIZED VIEW -- 替换 物化 视图 的 内 容 
REINDEX -- 重建 索引 

RELEASE SAVEPOINT -- 删除 一 个 先前 定义 的 保存 点 

RESET -- 把 一 个 运行 时 参数 重 置 为 缺 省 值 

REVOKE -- 删除 访问 权限 

ROLLBACK -- 退出 当前 事务 

ROLLBACK PREPARED -- 取消 一 个 先前 为 两 阶段 提交 准备 好 的 事务 
ROLLBACK TO SAVEPOINT -- 回 滚 到 一 个 保存 点 
SAVEPOINT -- 在 当前 事务 里 定义 一 个 新 保存 点 

SECURITY LABEL -- 定义 或 改变 一 个 应 用 于 对 象 的 安全 标签 
SELECT -- 从 表 或 视图 中 取出 若干 行 

SELECT INTO -- 从 一 条 查询 的 结果 中 定义 一 个 新 表 

SET -- 修改 运行 时 参数 

SET CONSTRAINTS -- 设置 当前 事务 的 约束 检查 模式 

SET ROLE -- 在 当前 会 话 中 设置 当前 用 户 标 识 

SET SESSION AUTHORIZATION -- 为 当前 会 话 设置 会 话 用 户 标 识 符 和 当前 用 户 标 识 符 
SET TRANSACTION -- 设置 当前 事务 的 特性 

SHOW -- 显示 运行 时 参数 的 值 


START TRANSACTION -- 开始 一 个 事务 块 
TRUNCATE -- 清空 一 个 或 一 组 表 

UNLISTEN -- 停止 监听 通知 信息 

UPDATE -- 更 新 一 个 表 中 的 行 

VACUUM -- 垃圾 收集 以 及 可 选 地 分 析 一 个 数据 库 
VALUES -- 计算 一 个 或 一 组 行 


ABORT 


Name 


ABORT -- 放弃 当前 事务 


Synopsis 


ABORT [ WORK | TRANSACTION | 


fia ah 


ABORT 回 滚 当前 事务 并 且 撤 销 所 有 当前 事务 中 所 做 的 更 改 。 这 个 命令 和 标准 SQL PP 
ROLLBACK 的 行为 完全 一 样 ， 只 是 由 于 历史 原因 而 保留 下 来 。 


参数 


WORK ` ` TRANSACTION 


可 选 的 关键 字 ， 它 们 没有 什么 作用 。 


、\ 一 - a 


a 


使 用 COMMIT 成 功 地 结束 一 个 事务 。 


在 事务 外 部 发 出 ABoRT 不 会 造成 损害 ， 但 是 会 产生 一 个 警告 信息 。 


例子 
放 奔 全 部 变更 : 


ABORT; 


RANE 


此 命令 是 PostgreSQL 基于 历史 原因 做 的 扩展 。 等 价 于 标准 SQL 的 RoLLBACK MA 
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EA 


参见 


BEGIN, COMMIT, ROLLBACK 


ABORT 1500 


ALTER AGGREGATE 


Name 


ALTER AGGREGATE -- ADREI SL 


Synopsis 


ALTER AGGREGATE _name_ ( _argtype_[, ... ] ) RENAME TO _new_name_ 
ALTER AGGREGATE _name_ ( _argtype_[, ... ] ) OWNER TO _new_owner_ 
ALTER AGGREGATE _name_ ( _argtype_[, ... ] ) SET SCHEMA _new_schema_ 
vs 
描述 
ALTER AGGREGATE 改 交 一 个 聚集 男 数 的 定义 。 


要 使 用 ALTER AGGREGATE ， 你 必须 是 该 聚集 男 数 的 所 有 者 。 要 改变 一 个 聚集 函数 的 模式 ， 你 
ic edicts CREATE 权限 。 BMSAAA, RL es 个 直接 或 间接 成 
， 并 且 该 角色 必须 在 聚集 本 数 的 模式 上 有 create 权限 。 (这 些 限 制 强制 了 修改 该 所 有 者 
i 除 和 重建 聚集 函数 不 能 做 的 事情 。 不 过 ， 超 级 用 户 可 以 用 任何 方法 任意 更 
聚集 函数 的 所 属 关系 。) 


参数 


现 有 的 聚集 辑 数 的 名 称 (可 以 有 模式 修饰 )。 
_argtype_ 


PRS NER A SHR, BSI -TSBSRRENM, TUSA + 代 蔡 输入 数据 类 型 
列表 。 


_new_name 


RR AAT EF. 


_new_owner_ 


PR SR EN LAAT AT A 


_new_schema_ 


PRR LA ATT 


例子 
把 一 个 接受 integer 类 型 参数 的 聚集 酌 数 myavg EMAA my_average 


ALTER AGGREGATE myavg(integer) RENAME TO my_average; 


把 一 个 接受 integer KHEBRHRAWNA myavg 的 所 有 者 改 为 joe 


ALTER AGGREGATE myavg(integer) OWNER TO joe; 


把 一 个 接受 integer 类 型 参数 的 聚集 男 数 myavg 移 动 到 模式 myschema 里 : 


ALTER AGGREGATE myavg(integer) SET SCHEMA myschema; 


RANE 


SQL 标准 里 没有 ALTER AGGREGATE 语句 。 


参见 


一 


CREATE AGGREGATE, DROP AGGREGATE 


ALTER COLLATION 


Name 


ALTER COLLATION -- 修改 一 个 排序 规则 定义 


Synopsis 


ALTER COLLATION _name_ RENAME TO _new_name_ 
ALTER COLLATION _name_ OWNER TO _new_owner_ 
ALTER COLLATION _name_ SET SCHEMA _new_schema_ 


摘 述 
ALTER COLLATION 修改 一 个 排序 规则 定义 . 


使 用 ALTER COLLATION 你 必须 拥有 排序 规则 . 若 要 更 改 拥有 者 ,你 必须 是 这 个 新 所 有 者 角色 的 直 
接 成 员 或 间接 成 员 , 而 且 这 个 角色 在 排序 规则 模式 上 必须 拥有 cREATE 权限 . (这 些 限 制约 束 你 
不 能 通过 放弃 或 重建 排序 规则 来 修改 所 有 者 做 任何 事 . 不 管 怎样 ,一 个 超级 用 户 能 修改 任何 排序 
规则 的 所 有 权 .) 


参数 


_name_ 


一 个 存在 的 排序 规则 的 名 称 (可 以 有 模式 修饰 ) 


_new_name 


排序 规则 的 新 名 称 . 


_new_owner_ 


新 排序 规则 的 拥有 者 . 


_new_schema_ 


新 的 排序 规则 模式 . 


示例 


重 命名 排序 规则 de DE 为 german : 


ALTER COLLATION "de_DE" RENAME TO german; 


修改 排序 规则 的 拥有 者 en_us 为 joe: 


ALTER COLLATION "en_US" OWNER TO joe; 


RANE 


在 SQL 标准 中 没有 ALTER COLLATION 语句 . 


请 参阅 


CREATE COLLATION, DROP COLLATION 


ALTER CONVERSION 


Name 


ALTER CONVERSION -- 修改 编码 转换 的 定义 


Synopsis 


ALTER CONVERSION _name_ RENAME TO _new_name_ 
ALTER CONVERSION _name_ OWNER TO _new_owner_ 
ALTER CONVERSION _name_ SET SCHEMA _new_schema_ 


摘 述 
ALTER CONVERSION 修改 编码 转换 的 定义 。 


要 使 用 ALTER CONVERSION ， 您 必须 是 该 编码 转换 的 所 有 者 。 要 修改 其 所 有 者 ， 您 必须 是 新 的 
所 属 角色 的 直接 或 者 间接 成 员 ， 并 且 该 角色 还 必须 在 该 编码 转换 的 模式 上 有 create 权限 。 
(这 些 限 制 强制 了 修改 该 所 有 者 不 会 做 任何 通过 删除 和 重建 编码 转换 不 能 做 的 事情 。 不 过 ， 
超级 用 户 可 以 任何 方式 修改 任意 编码 转换 的 所 有 属 关 系 。) 


参数 


_name_ 


现 有 的 编码 转换 的 名 称 ( 可 以 有 模式 修饰 )。 


_new_name 


编码 转换 的 新 名 字 。 


_new_owner_ 


编码 转换 的 新 所 有 者 。 


_new_schema_ 


编码 转换 的 新 模式 名 。 


例子 


要 把 编码 转换 iso_8859_1 to_utfs 重新 命名 为 latin1 to_unicode 


ALTER CONVERSION iso 8859 1 to utf8 RENAME TO latini_to_unicode; 


要 把 编码 转换 iso_8859 1 to_utf8 的 所 有 者 改变 为 joe 


ALTER CONVERSION iso_ 8859 1 to _ utf8 OWNER TO joe; 


兼容 性 


SQL 标准 里 没有 ALTER CONVERSION 语句 。 


参见 


D 


CREATE CONVERSION, DROP CONVERSION 


ALTER DATABASE 


Name 


ALTER DATABASE -- 修改 一 个 数据 库 


Synopsis 


ALTER DATABASE _name_ [ [ WITH ] _option_[... ] ] 
这 里 `_option ”可 以 是 以 下 参数 : 
CONNECTION LIMIT _connlimit_ 
ALTER DATABASE _name_ RENAME TO _new_name_ 
ALTER DATABASE _name_ OWNER TO _new_owner_ 
ALTER DATABASE _name_ SET TABLESPACE _new_tablespace_ 
ALTER DATABASE _name_ SET _configuration_parameter_ { TO | = } { _value_ | DEFAULT } 
ALTER DATABASE _name_ SET _configuration_parameter_ FROM CURRENT 


ALTER DATABASE name_ RESET _configuration_parameter_ 
ALTER DATABASE _name_ RESET ALL 


摘 述 
ALTER DATABASE 改变 一 个 数据 库 的 属性 。 


第 一 种 形式 改变 某 个 按 数据 库 设 置 的 相关 参数 。 ( 见 下 文 细 节 。) 只 有 数据 库 所 有 者 或 者 超 
级 用 户 可 以 改变 这 些 设置 。 


第 二 种 形式 修改 该 数据 库 的 名 称 。 只 有 数据 库 所 有 者 或 者 超级 用 户 可 以 重 命名 一 个 数据 库 ; 
非 超 级 用 户 必须 拥有 cREATEDB 权限 。 当前 的 数据 库 不 能 被 重 命 名 。 《如 果 你 需要 这 人 么 做 ， 
那么 需要 先 连接 另外 一 个 数据 库 。) 


第 三 种 形式 改变 数据 库 的 所 有 者 。 要 改变 所 有 者 ， 你 必须 是 该 数据 库 的 所 有 者 并 且 还 是 新 的 
所 有 角色 的 直接 或 者 间接 成 员 ， 并 且 还 必须 有 CREATEDB 权限 。 《请 注意 ， 超 级 用 户 自动 拥 
有 所 有 这 些 权 限 。) 


第 四 种 形式 改变 数据 库 的 缺 省 表 空 间 。 要 改变 缺 省 表 空 间 ， 你 必须 是 该 数据 库 的 所 有 者 或 是 
超级 用 户 ， 并 且 还 必须 有 新 的 表 空间 的 读 写 权限 。 这 个 语句 会 从 物理 上 将 一 个 数据 库 原来 缺 
省 表 空 间 上 的 表 和 索引 移 至 新 的 表 空 间 。 注 意 不 在 缺 省 表 空 间 的 表 和 索引 不 受 此 影响 。 


其 他 形式 为 PostgreSQL 数据 库 修 改 缺 省 的 会 话 运行 时 配置 变量 。 任何 时 候 在 一 个 数据 库 上 
启动 一 个 新 的 会 话 的 时 候 ， 一 些 特定 的 参数 值 会 成 为 当前 会 话 的 缺 省 值 。 与 指定 数据 库 相 关 
的 缺 省 会 覆盖 在 postgresql.conf 参数 文件 中 指定 的 对 应 值 或 是 从 postgres 服务 启动 时 在 命 
倒 行 上 指定 的 参数 值 。 只 有 数据 库 所 有 者 或 者 超级 用 户 可 以 为 一 个 数据 库 修改 会 话 缺 省 值 。 
有 些 变量 不 能 用 这 种 方法 设置 ， 或 者 是 只 能 由 超级 用 户 设置 。 


参数 


_name_ 


需要 修改 属性 的 数据 库 的 名 字 。 


_connlimit_ 


对 这 个 数据 库 可 以 做 多 少 个 并 发 连接 。-1 意味 着 没有 限制 。 


_new_name 


数据 库 的 新 名 字 。 


_new_owner_ 


数据 库 新 的 所 有 者 。 


_new_tablespace_ 


数据 库 的 新 的 缺 省 表 空 间 。 


_configuration_parameter_~~_value_ 


把 数据 库 的 指定 配置 参数 的 会 话 缺 省 值 设 置 为 给 定 的 数值 。 如果 _value Æ DEFAULT , BK 
者 是 相应 的 如 reset 选项 使 用 的 话 ， 那 么 与 数据 库 相 关 的 参数 设置 将 被 删除 ， 在 新 的 会 话 中 
将 继承 系统 级 的 缺 省 参数 值 。 用 reset ALL 可 清除 所 有 数据 库 相关 的 设置 。 

用 SET FROM CURRENT 可 保存 会 话 参 数 的 当前 值 保存 为 相关 的 数据 库 值 。 


参阅 SET 和 Chapter 18 获取 有 关 人 允许 的 参数 名 和 数值 的 更 多 信息 。 


NC = = 


ane 


也 可 以 把 一 个 会 话 缺 省 值 绑 定 到 一 个 特定 角色 上 而 不 是 某 个 数据 库 上 ; 参阅 ALTER ROLE. 
如 果 存 在 冲突 ， 那 么 角色 声明 的 参数 值 会 覆盖 数据 库 相 关 的 参数 值 。 


例子 


要 关闭 在 数据 库 test 上 缺 省 的 索引 扫描 : 


ALTER DATABASE test SET enable_indexscan TO off; 


RANE 


ALTER DATABASE 语句 是 一 个 PostgreSQL 扩展 。 


参见 


一 


CREATE DATABASE, DROP DATABASE, SET, CREATE TABLESPACE 


ALTER DEFAULT PRIVILEGES 


Name 


ALTER DEFAULT PRIVILEGES -- 定义 默认 的 访问 权限 


Synopsis 


ALTER DEFAULT PRIVILEGES 
[ FOR { ROLE | USER } _target_role_[, ...] ] 
[ IN SCHEMA _schema_name_ [, ...] ] 
_abbreviated_grant_or_revoke 





where ~_abbreviated_grant_or_revoke_~ is one of: 





GRANT { { SELECT | INSERT | UPDATE | DELETE | TRUNCATE | REFERENCES | TRIGGER } 
[，...] | ALL [ PRIVILEGES ] } 
ON TABLES 
TO { [ GROUP ] _role_name_ | PUBLIC } [, ...] [ WITH GRANT OPTION ] 


GRANT { { USAGE | SELECT | UPDATE } 
[，...] | ALL [ PRIVILEGES ] } 
ON SEQUENCES 
TO { [ GROUP ] _role_name_ | PUBLIC } [, ...] [ WITH GRANT OPTION ] 


GRANT { EXECUTE | ALL [ PRIVILEGES ] } 
ON FUNCTIONS 
TO { [ GROUP ] _role_name_ | PUBLIC } [, ...] [ WITH GRANT OPTION ] 


GRANT { USAGE | ALL [ PRIVILEGES ] } 
ON TYPES 
TO { [ GROUP ] _role_name_ | PUBLIC } [, ...] [ WITH GRANT OPTION ] 


REVOKE [ GRANT OPTION FOR ] 
{ { SELECT | INSERT | UPDATE | DELETE | TRUNCATE | REFERENCES | TRIGGER } 


[，...] | ALL [ PRIVILEGES ] } 
ON TABLES 
FROM { [ GROUP ] _role_name_ | PUBLIC } [, ...] 


[ CASCADE | RESTRICT ] 


REVOKE [ GRANT OPTION FOR ] 
{ { USAGE | SELECT | UPDATE } 


[, ...] | ALL [ PRIVILEGES ] } 
ON SEQUENCES 
FROM { [ GROUP ] _role_name_ | PUBLIC } [, ...] 


[ CASCADE | RESTRICT ] 


REVOKE [ GRANT OPTION FOR ] 
{ EXECUTE | ALL [ PRIVILEGES ] } 
ON FUNCTIONS 
FROM { [ GROUP ] _role_name_ | PUBLIC } [, ...] 
[ CASCADE | RESTRICT ] 


REVOKE [ GRANT OPTION FOR ] 
{ USAGE | ALL [ PRIVILEGES ] } 
ON TYPES 
FROM { [ GROUP ] _role_name_ | PUBLIC } [, ...] 
[ CASCADE | RESTRICT ] 


fa aah 


ALTER DEFAULT PRIVILEGES 多 许 你 设置 应 用 到 以 后 创建 的 对 象 的 权限 . (这 不 影响 已 分 配给 已 经 
存在 对 象 的 权限 .) 目前 , 只 有 表 ( 包 括 视图 和 外 部 表 )、 序 列 、 画 数 和 类 型 (包括 域 ) 的 权限 能 够 
被 更 改 . 


你 能 修改 那些 会 被 你 自己 或 那些 你 是 其 中 一 员 的 角色 所 创建 的 对 象 的 黑 认 权限 . 这 个 权限 能 被 
全 局 设置 (比如 : 给 所 有 在 当前 数据 库 创 建 的 对 象 ), 或 者 只 是 给 在 指定 模式 中 创建 的 对 象 . 默 
认 权 限 规 定 每 个 模式 的 都 会 被 加 上 ， 无 论 全 局 默认 权限 是 不 是 为 了 特殊 的 对 象 类 型 . 


根据 GRANT 下 的 解释 , 任何 对 象 类 型 的 默认 权限 通常 授权 全 部 可 授与 权限 给 对 象 所 有 者 , 以 
及 授权 一 些 权 限 给 PuBLIC .不管 怎样 ,改行 为 能 通过 使 用 ALTER DEFAULT PRIVILEGES BUS 
局 默认 权限 来 修改 . 


参数 


_target_role_ 


已 经 存在 并 且 是 一 个 成 员 的 前 角色 的 名 称 . 如 果 For RoLE RAR, 这 个 当前 角色 是 假设 的 . 
_schema_name_ 

已 存在 模式 的 名 称 . 如 果 特 别 指定 ， 随 后 在 该 模式 里 创建 的 对 象 ， 会 被 修改 为 默认 权限 . 如 果 
IN SCHEMA 被 省 略 了 ,全 局 默认 权限 也 被 更 改 了 . 

_role_name_ 

已 存在 的 用 来 授权 或 撤销 权限 的 角色 的 名 称 . 这 个 参数 ， 和 所 有 其 他 在 


_abbreviated_grant_or_revoke_ 中 的 参数 , 作用 如 GRANT 或 REVOKE 所 述 , 是 给 整个 类 的 对 
象 而 不 是 特定 的 命名 对 象 设置 权限 . 





备注 
使 用 psql's \ddp 命令 来 获取 已 存在 的 默认 权限 的 分 配 信息 . 权限 制 的 含义 与 GRANT 
下 xdp 的 解释 相同 。 


如 果 你 希望 删除 一 个 默认 权限 已 经 被 修改 的 角色 , 对 这 个 角色 来 说 ， 撤 销 默 认 权 限 上 的 修改 或 
者 使 用 prop owen BY 来 摆脱 该 角色 的 默认 权限 默认 权限 条 目 ， 这 是 必要 的 . 


示例 


给 你 后 来 在 模式 myschema 里 创建 的 所 有 表 (和 视图 ) 授予 SELECT 权限 ， 并 且 人 允许 角色 
webuser 对 他 们 执行 INSERT: 


ALTER DEFAULT PRIVILEGES IN SCHEMA myschema GRANT SELECT ON TABLES TO PUBLIC; 
ALTER DEFAULT PRIVILEGES IN SCHEMA myschema GRANT INSERT ON TABLES TO webuser; 


撤销 上 面 的 操作 , 因此 后 来 创建 的 表 不 会 拥有 上 比 常 规 情况 还 多 的 权限 : 


ALTER DEFAULT PRIVILEGES IN SCHEMA myschema REVOKE SELECT ON TABLES FROM PUBLIC; 
ALTER DEFAULT PRIVILEGES IN SCHEMA myschema REVOKE INSERT ON TABLES FROM webuser; 


为 角色 admin 之 后 创建 的 所 有 的 函数 ， 移 除 那些 通常 授权 在 函数 上 的 公共 EXECUTE 权限 : 


ALTER DEFAULT PRIVILEGES FOR ROLE admin REVOKE EXECUTE ON FUNCTIONS FROM PUBLIC; 


兼容 性 


在 SQL 标准 中 没有 ALTER DEFAULT PRIVILEGES 语句 . 


请 参阅 


GRANT, REVOKE 


ALTER DOMAIN 


Name 


ALTER DOMAIN -- 修改 一 个 域 的 定义 


Synopsis 


ALTER DOMAIN _name_ 

{ SET DEFAULT _expression_ | DROP DEFAULT } 

ALTER DOMAIN _name_ 

{ SET | DROP } NOT NULL 

ALTER DOMAIN _name_ 

ADD _domain_constraint_ [ NOT VALID ] 

ALTER DOMAIN _name_ 

DROP CONSTRAINT [ IF EXISTS ] _constraint_name_ [ RESTRICT | CASCADE | 
ALTER DOMAIN _name_ 

RENAME CONSTRAINT _constraint_name_ TO _new_constraint_name_ 
ALTER DOMAIN _name_ 

VALIDATE CONSTRAINT _constraint_name_ 

ALTER DOMAIN _name_ 

OWNER TO _new_owner_ 

ALTER DOMAIN _name_ 

RENAME TO _new_name_ 

ALTER DOMAIN _name_ 

SET SCHEMA _new_schema_ 





Fiqh 
ALTER DOMAIN 修改 一 个 域 的 定义 。 它 有 几 种 子 形式 : 
SET/DROP DEFAULT 


这 ee 或 者 删除 一 个 域 的 缺 省 值 。 请 注意 缺 省 值 只 适用 于 随后 的 insert 命令 ; 他 们 
不 影响 使 用 该 域 已 经 在 表 中 的 行 。 


SET/DROP NOT NULL 


这 些 形式 改变 一 个 域 是 否 标记 为 允许 NULL 值 或 者 是 不 允许 NULL 值 。 在 使 用 域 的 字段 包含 
非 空 的 值 的 时 候 ， 你 只 可 以 使 用 set NOT NULL o 


ADD _domain_constraint_ [NOT VALID ] 


这 种 形式 向 域 中 增加 一 种 新 的 约束 ， 使 用 的 语法 和 CREATE DOMAIN 一 样 。 当 一 个 新 的 约 
束 增加 至 域 中 时 ， 使 用 这 个 域 的 所 有 列 将 会 按 新 增 的 约束 条 件 进 行 检 查 。 这 些 检查 也 可 以 通 
过 使 用 not vALID 选项 来 增加 新 的 约束 条 件 进 行 关 闭 ; 约束 也 可 以 以 后 通 


过 ALTER DOMAIN ... VALIDATE CONSTRAINT 语句 生效 。 新 插 和 人 或 是 更 新 的 记录 将 会 按 所 有 约束 
进行 检查 ， 甚 至 是 标记 为 not VALID 的 约束 。 noT VALID 只 是 对 cHEcK 约束 生效 。 


DROP CONSTRAINT [IF EXISTS ] 


这 种 形式 删除 一 个 域 上 的 约束 。 如 果 使 用 了 IF exists 选项 并 且 约 束 并 不 存在 时 ， 系 统 不 会 
抛 出 错误 提示 ， 这 种 情况 下 系统 只 会 发 出 一 个 提示 信息 。 


RENAME CONSTRAINT 
这 种 形式 更 改 一 个 域 上 的 约束 名 称 。 
VALIDATE CONSTRAINT 


这 种 形式 将 域 上 以 前 以 NoT vALID 选项 增加 的 约束 进行 生效 ， 这 样 会 对 域 中 所 有 列 的 数据 按 
这 个 指定 的 约束 进行 验证 。 


OWNER 

这 种 形式 将 域 的 所 有 者 改变 为 一 个 指定 的 用 户 。 

RENAME 

这 种 形式 将 改变 域 的 名 称 。 

SET SCHEMA 

这 种 形式 将 改变 域 的 模式 。 所 有 和 与 这 个 域 有 关 的 约束 也 会 移 至 新 的 模式 。 


要 使 用 ALTER DoMAIN 语句 ， 您 必须 是 该 域 的 所 有 者 。 要 修改 一 个 域 的 模式 ， 您 还 必须 在 新 模 
式 上 拥有 cREATE 权限 。 要 修改 所 有 者 ， 您 还 必须 是 新 的 所 有 角色 的 直接 或 间接 成 员 ， 并 且 

该 成 员 必须 在 此 域 的 模式 上 有 create 权限 。 (这 些 限 制 强制 了 修改 该 所 有 者 不 会 做 任何 通过 
删除 和 重建 域 不 能 做 的 事情 。 不 过 ， 超 级 用 户 可 以 以 任何 方式 修改 任意 域 的 所 有 关系 。) 


参数 


一 个 要 修改 的 现 有 域 的 名 字 ( 可 以 有 模式 修饰 )。 
_domain_constraint_ 
域 的 新 域 约束 。 


_constraint_name_ 


要 删除 或 是 重 命名 的 原 有 约束 名 。 


_NOT VALID_ 


不 对 已 有 数据 进行 约束 的 有 效 性 验证 。 


CASCADE 


自动 级 联 删 除 依赖 这 个 约束 的 对 象 。 


RESTRICT 


如 果 有 任何 依赖 对 象 ， 则 拒绝 删除 约束 。 这 是 缺 省 行为 。 


_new_name 


域 的 新 名 称 。 


_new_constraint_name_ 


约束 的 新 名 称 。 


_new_owner_ 


域 的 新 的 所 有 者 的 用 户 名 。 


_new_schema_ 

域 的 新 的 模式 名 。 

注意 

目前 ， 如 果 命名 的 域 或 者 任何 派生 的 域 用 于 数据 库 中 任何 一 个 表 的 一 个 复合 列 中 ， 那么 


ALTER DOMAIN ADD CONSTRAINT 和 ALTER DOMAIN SET NOT NULL WAR, 最 终 ， 他 们 应 该 加 以 改 
进 以 达到 能 够 验证 这 种 找 套 列 的 新 约束 。 


例子 
给 一 个 域 增加 一 个 Not NULL AR : 


ALTER DOMAIN zipcode SET NOT NULL; 


从 一 个 域 里 删除 一 个 NoT NULL 约束 : 


ALTER DOMAIN zipcode DROP NOT NULL; 


向 一 个 域 里 增加 一 个 检查 约束 : 


ALTER DOMAIN zipcode ADD CONSTRAINT zipchk CHECK (char_length(VALUE) = 5); 


从 一 个 域 里 删除 一 个 检查 约束 : 


ALTER DOMAIN zipcode DROP CONSTRAINT zipchk; 


从 一 个 域 里 的 检查 约束 重 命名 : 


ALTER DOMAIN zipcode RENAME CONSTRAINT zipchk TO zip_check; 


把 域 移动 到 另外 一 个 模式 : 


ALTER DOMAIN zipcode SET SCHEMA customers; 


RANE 


除了 OWNER, RENAME, SET SCHEMA 和 VALIDATE CONSTRAINT 这 些 选项 是 PostgreSQL 扩 展 
外 ， ALTER DOMAIN 语句 基本 与 SQL 标准 兼容 。 App CONSTRAINT 相关 的 not VALID 选项 也 是 
PostgreSQL 的 扩展 。 


参见 


CREATE DOMAIN, DROP DOMAIN 


ALTER EXTENSION 


Name 


ALTER EXTENSION -- 修改 扩展 定义 


Synopsis 


ALTER EXTENSION _name_ UPDATE [ TO _new_version_ ] 
ALTER EXTENSION _name_ SET SCHEMA _new_schema_ 
ALTER EXTENSION _name_ ADD _member_object 

ALTER EXTENSION _name_ DROP _member_object 








where ~_member_object_~ is: 





AGGREGATE _agg_name_ (_agg_type_[, ...] ) | 

CAST (_source_type_ AS _target_type_) | 

COLLATION _object_name_ | 

CONVERSION _object_name_ | 

DOMAIN _object_name_ | 

EVENT TRIGGER _object_name_ | 

FOREIGN DATA WRAPPER _object_name_ | 

FOREIGN TABLE _object_name_ | 

FUNCTION _function_name_ ( [ [ _argmode_ ] [ _argname_ ] _argtype_[, ...] ] ) | 
MATERIALIZED VIEW _object_name_ | 

OPERATOR _operator_name_ (_left_type_, _right_type_) | 
OPERATOR CLASS _object_name_ USING _index_method_ | 
OPERATOR FAMILY _object_name_ USING _index_method_ | 
[ PROCEDURAL ] LANGUAGE _object_name_ | 

SCHEMA _object_name_ | 

SEQUENCE _object_name_ | 

SERVER _object_name_ | 

TABLE _object_name_ | 

TEXT SEARCH CONFIGURATION _object_name_ | 

TEXT SEARCH DICTIONARY _object_name_ | 

TEXT SEARCH PARSER _object_name_ | 

TEXT SEARCH TEMPLATE _object_name_ | 

TYPE _object_name_ | 

VIEW _object_name_ 

















ALTER EXTENSION 修改 一 个 已 安装 的 扩展 的 定义 . 这 里 有 几 种 方式 : 


UPDATE 


这 种 方式 更 新 这 个 扩展 到 一 个 新 的 版 本 . 这 个 扩展 必须 满足 一 个 适用 的 更 新 脚本 (或 者 一 系列 脚 
AN) 这 样 就 能 修改 当前 安装 版 本 到 一 个 要 求 的 版 本 . 


SET SCHEMA 


这 种 方式 移动 扩展 对 象 到 另 一 个 模式 . 这 个 扩展 必须 relocalabje 才 能 使 命令 成 功 . 


ADD member_object 





这 种 方式 添加 一 个 已 存在 对 象 到 扩展 . 这 主要 在 扩展 更 新 脚本 上 有 用 . 这 个 对 象 接着 会 被 视 为 
扩展 的 成 员 ; 显而易见 ,该 对 象 只 能 通过 取消 扩展 来 取消 . 


DROP member_object 


这 个 方式 从 扩展 上 移 除 一 个 成 员 对 象 . 主要 在 扩展 更 新 脚本 上 有 用 .这 个 对 象 没有 被 取消 , 只 
从 扩展 里 分 开 了 . 





参考 Section 35.15 来 获取 更 多 有 关 这 些 操作 的 信息 . 


你 必须 拥有 扩展 来 使 用 ALTER EXTENSION . 这 个 App / prop 方式 要 求 添加 /删除 对 象 的 所 有 
AL. 


_name_ 


已 安装 扩展 的 名 称 . 
希望 的 扩展 新 版 本 . 这 个 能 被 标识 符 和 字面 字符 重 写 .如 果 不 是 指定 的 ， 
ALTER EXTENSION UPDATE 党 试 去 更 新 到 不 管 是 什么 在 扩展 的 控制 文件 中 显示 的 默认 版 本 . 


_new_schema_ 
给 扩展 的 新 模式 . 
object_name_*~_agg_name function_name_ _operator_name_ 


从 扩展 里 被 被 添加 或 移 除 的 对 象 的 名 称 . 表 , 聚集 , 域 , 外 链表 ,函数 ,操作 符 , 操作 符 类 , 操作 符 
族 ,序列 , 文本 搜索 对 象 ,类 型 , 和 能 被 模式 合格 的 视图 的 名 称 . 


_agg_type_ 


PRR ES UR FE LA — Sag ASK. 去 引用 一 个 需 参 数 聚 集 图 数 , 写 * 代替 这 些 输入 数据 
ee 





_source_type_ 


强制 转换 的 源 数 据 类 型 的 名 称 . 


_target_type_ 


强制 转换 的 目标 数据 类 型 的 名 称 . 


_argmode_ 


这 个 画 数 参数 的 模型 ， IN ，ouT ，INoUT , 或 者 vARIADIC 


INOUT , 和 ”VARIADIC 参数 就 足够 了 . 


—argname_ 


函数 参数 的 名 称 . 注意 ALTER EXTENSION 不 关心 参数 名 称 , AABABAN-RERSES 


Za 


据 类 型 . 
_argtype_ 


HASAN SE KB (AO ARAE Hh), 如 果 任 何 . 


left_type right_type 





. 如 果 省 略 的 话 , 默认 的 是 IN. 
ALTER EXTENSION 不 关心 ouT SM, 因为 确认 郴 数 的 一 致 性 只 需要 输入 参数 .因此 列 出 in, 


操作 符 的 参数 的 数据 类 型 (可 以 有 模式 修饰 ). 为 前 弘 或 后 级 运算 符 的 丢失 参数 写 NONE . 


PROCEDURAL 


这 是 一 个 干扰 词 


示例 
更 新 hstore 扩展 到 版 本 2.0: 


ALTER EXTENSION hstore UPDATE TO '2.0'; 


更 新 hstore 扩展 的 模式 为 utils : 


ALTER EXTENSION hstore SET SCHEMA utils; 


添加 一 个 已 存在 的 了 范 BA hstore yR: 


ALTER EXTENSION hstore ADD FUNCTION populate_record(anyelement, hstore); 


RAIE 


ALTER EXTENSION 是 一 个 PostgreSQL 扩 展 . 


参阅 


CREATE EXTENSION, DROP EXTENSION 


>、 
注意 


数 数 


ALTER EVENT TRIGGER 


Name 


ALTER EVENT TRIGGER -- 修改 事件 触发 器 的 定义 


Synopsis 


ALTER EVENT TRIGGER _name_ DISABLE 

ALTER EVENT TRIGGER _name_ ENABLE [ REPLICA | ALWAYS ] 
ALTER EVENT TRIGGER _name_ OWNER TO _new_owner_ 

ALTER EVENT TRIGGER _name_ RENAME TO _new_name_ 


摘 述 
ALTER EVENT TRIGGER 改变 现 有 的 事件 触发 器 的 定义 。 
你 必须 是 超级 用 户 才能 修改 事件 触发 器 。 


参数 


_name_ 


修改 现 有 事件 触发 器 的 名 字 。 


_new_owner_ 


事件 触发 器 的 新 属 主 的 名 字 。 


_new_name _ 
事件 触发 器 的 新 名 字 。 
DISABLE / ENABLE [ REPLICA | ALWAYS ] TRIGGER 


这 些 配置 触发 事件 触发 器 的 方式 。 茶 用 的 触发 器 是 系统 已 知 的， 但 是 当 触发 事件 发 生 时 不 执 
行 。 is still known to the system, but is not executed when its triggering 参见 
session_replication_role. 


RANE 


在 SQL 规范 中 没有 ALTER EVENT TRIGGER 的 声明 。 


PostgreSQL 中 文 文档 9.3 


另 请 参见 


CREATE EVENT TRIGGER, DROP EVENT TRIGGER 


ALTER EVENT TRIGGER 1521 


ALTER FOREIGN DATA WRAPPER 


Name 


ALTER FOREIGN DATA WRAPPER -- 修改 外 来 数据 抓 取 的 定义 


Synopsis 


ALTER FOREIGN DATA WRAPPER _name_ 

[ HANDLER _handler_function_ | NO HANDLER ] 

[ VALIDATOR _validator_function_ | NO VALIDATOR ] 

[ OPTIONS ( [ ADD | SET | DROP ] _option_ ['_value_'] [, ... ]) ] 
ALTER FOREIGN DATA WRAPPER _name_ OWNER TO _new_owner_ 
ALTER FOREIGN DATA WRAPPER _name_ RENAME TO _new_name_ 





Description 


ALTER FOREIGN DATA WRAPPER 修改 外 来 数据 抓 取 的 定义 。 这 个 命令 的 第 一 个 形式 是 改变 函数 
的 支持 和 外 来 数据 抓 取 (至 少 要 求 一 个 语句 ) 的 属性 选项 。 第 二 个 形式 是 改变 外 来 抓 取 数 所 
的 所 有 者 。 


只 有 超级 用 户 能 够 修改 外 来 抓 取 数 据 。 此 外 ， 只 有 超级 用 户 能 够 。 


Parameters 
已 有 外 来 数据 抓 取 的 名 字 。 
HANDLER _handler_function_ 


AHR BGM ARS TE — “NAT BY Xe BK, 


NO HANDLER 

这 个 参数 用 来 指定 外 来 数据 抓 取 不 再 拥有 人 处理 加 数 。 
注意 ， 使 用 外 来 数据 抓 取 但 没有 handler 的 外 表 不 能 访问 。 
VALIDATOR _validator_function_ 


AKRAM AS E — DATEI e ie RK 


注意 ， 在 修改 验证 器 选项 后 外 来 数据 抓 取 ， 服 务 端 和 用 户 映射 会 失效 。 用 户 在 使 用 外 来 数据 
抓 取 之 前 需要 保证 这 个 选项 是 正确 的 。 


NO VALIDATOR 
这 个 用 来 指定 外 来 数据 抓 取 不 再 有 验证 器 函数 。 


OPTIONS ( [ ADD | SET | DROP ] option_ [' value_ ‘][, ...]) 





修改 外 来 数据 抓 取 的 选项 。 App , SET, and prop 指定 表现 的 动作 。 App 假定 如 果 没 有 明 
确 指定 操作 。 选 项 名 必须 唯一 ; 名 字 和 指 也 要 证 实 使 用 外 来 数据 抓 取 的 验证 器 函数 。 


_new_owner_ 


外 来 数据 抓 取 新 的 所 有 者 的 用 户 名 。 


_new_name 


外 来 数据 抓 取 的 新 名 称 。 


例子 
修改 一 个 外 来 数据 dbi ,增加 选项 foo , drop bar : 


ALTER FOREIGN DATA WRAPPER dbi OPTIONS (ADD foo '1', DROP 'bar'); 


修改 外 来 数据 抓 取 dbi 验证 器 为 bob.myvalidator : 


ALTER FOREIGN DATA WRAPPER dbi VALIDATOR bob.myvalidator; 


Compatibility 


ALTER FOREIGN DATA WRAPPER 确认 为 ISO/IEC 9075-9 (SQL/MED), 排除 HANDLER , 


VALIDATOR , OWNER TO ,和 RENAME 子 句 是 扩展 。 


See Also 


CREATE FOREIGN DATA WRAPPER, DROP FOREIGN DATA WRAPPER 


ALTER FOREIGN TABLE 


Name 


ALTER FOREIGN TABLE -- 修改 外 部 表 的 定义 


Synopsis 


ALTER FOREIGN TABLE 
Evelyn [lp ova 
ALTER FOREIGN TABLE IF EXISTS ] _name_ 
RENAME [ COLUMN ] _column_name_ TO _new_column_name 
ALTER FOREIGN TABLE [ IF EXISTS ] _name_ 
RENAME TO _new_name_ 
ALTER FOREIGN TABLE [ IF EXISTS ] _name_ 
SET SCHEMA _new_schema_ 
这 里 `_action ”是 下 列 之 一 : 


IF EXISTS ] _name_ 


ater 





ADD [ COLUMN ] _column_name data_type_ [ COLLATE _collation_ ] [ _column_constraint 
DROP [ COLUMN ] [ IF EXISTS ] _column_name_ [ RESTRICT | CASCADE ] 
ALTER [ COLUMN ] _column_name_ [ SET DATA ] TYPE _data_type_ 
ALTER [ COLUMN ] _column_name_ SET DEFAULT _expression_ 
ALTER [ COLUMN ] _column_name_ DROP DEFAULT 
ALTER [ COLUMN ] _column_name_ { SET | DROP } NOT NULL 
[ ] 
[ ] 
[ ] 








ALTER [ COLUMN ] _column_name_ SET STATISTICS _integer_ 

ALTER [ COLUMN ] _column_name_ SET ( _attribute_option_ = _value_[, ... ] ) 

ALTER [ COLUMN ] _column_name_ RESET ( _attribute_option_ [, ... ] ) 

ALTER [ COLUMN ] _column_name_ OPTIONS ( [ ADD | SET | DROP ] _option_ ['_value_'] [, 
OWNER TO _new_owner_ 














OPTIONS ( [ ADD | SET | DROP ] _option_ ['_value_'] [, ... ]) 
J E 
vb 
摘 述 


ALTER FOREIGN TABLE 修改 一 个 外 部 表 的 定义 。 这 里 有 好 几 种 形式 : 
ADD COLUMN 
这 种 形式 为 外 部 表 增 加 一 个 字段 ， 语 法 同 CREATE FOREIGN TABLE. 与 向 常规 表 增 加 字段 


不 同 ， 外 部 表 增 加 字段 不 会 引起 存储 空间 的 变化 ， 这 种 操作 简单 地 声明 了 外 部 表 是 可 获得 这 
些 新 字段 。 

DROP COLUMN [ IF EXISTS ] 

这 种 形式 删除 外 部 表 的 一 个 字段 。 如 果 表 中 的 该 字段 被 该 表 之 外 的 其 他 对 象 依 赖 ， 那 就 需 
增加 cascapE ; 比如 依赖 该 字段 的 视图 。 如 果 指 定 了 IF ExIsTS ， 则 在 字段 不 存在 时 也 不 会 
报错 ,只 是 产生 一 个 注意 信息 。 


IF EXISTS 


如 果 外 部 表 不 存在 ， 不 会 报错 ， 而 是 产生 一 个 注意 信息 。 
SET DATA TYPE 

这 种 形式 修改 一 个 外 部 表 字 上 段 的 数据 类 型 。 

SET / DROP DEFAULT 


这 种 形式 为 一 个 字段 设置 或 者 删除 缺 省 值 。 缺 省 值 只 应 用 于 随后 的 insert 或 UPDATE 命令 ; 
它们 不 会 导致 已 经 在 表 中 的 数值 的 修改 。 


SET / DROP NOT NULL 
标志 一 个 字段 是 否 人 允许 为 空 值 。 
SET STATISTICS 


这 个 形式 为 随后 的 ANALYZE 操 作 设 置 每 字段 的 统计 收集 目标 。 更 多 细节 请 参考 类 似 形 式 的 
ALTER TABLE 


SET ( _attribute option = _value_ [,...]) RESET ( _attribute_option_ [, ...]) 





这 种 形式 设置 或 重 设 每 一 个 属性 选项 ， 更 多 细节 ， 人 参考 ALTER TABLE 
OWNER 

这 个 形式 改变 外 部 表 的 所 有 者 为 指定 所 有 者 
RENAME 
RENAME 形式 改变 一 个 外 部 表 的 名 字 或 者 是 外 部 表 中 一 个 独立 字段 的 名 字 。 
SET SCHEMA 

这 种 形式 把 外 部 表 从 一 个 模式 移植 到 另 一 个 模式 。 


OPTIONS ( [ ADD | SET | DROP ] _option_ [' value_ 'J[, ...]) 





KE ARAM ACR SEA. ADD, SET, 和 prop 指定 执行 的 操作 。 如 果 没 有 显 式 设 
置 操作 ， 那 么 默认 就 是 ADD。 选 项 的 名 字 不 人 允许 重复 (尽管 表 选 项 和 表 字 段 选 项 可 以 有 相同 的 
ZF) 选项 的 名 称 和 值 也 会 通过 外 部 数据 封装 器 的 类 库 库 进行 校 验 。 


除 RENAME 和 SET schema 之 外 的 操作 都 可 以 写 组 合 在 一 起 ， 同 时 执行 。 例如 ， 在 单一 一 条 命 
令 中 ， 可 以 添加 多 个 列 和 (或者) 修改 多 个 列 的 数据 类 型 。 


你 必须 是 表 的 所 有 者 才能 使 用 ALTER FOREIGN TABLE HD, 要 修改 外 部 表 的 模式 ， 必 须 在 被 修 
改 的 新 模式 中 拥有 create 权限 。 要 改变 外 部 表 的 所 有 权 ， 你 必须 是 新 角色 的 直接 或 间接 成 

员 ， 并 且 这 个 新 角色 必须 在 该 表 的 模式 上 具有 create 权限 。 (这 强制 限制 在 进行 更 改 所 有 

者 的 操作 时 ， 如 果 无 法 通过 删除 后 重建 表 的 方式 完成 ， 那 么 就 不 能 做 任何 事 。 不 过 ， 超 级 用 

户 可 以 用 任何 方法 任意 更 改 表 的 所 有 者 。) 要 增加 一 个 字段 或 修改 一 个 字段 类 型 ， 必 须 在 数 
据 类 型 上 有 usace 权限 


_name_ 


待 修改 的 已 存在 外 部 表 的 名 字 〈 可 以 用 模式 修饰 ) 。 


_column_name_ 


现存 或 新 的 字段 名 称 。 


new_column_name 





字段 的 新 名 称 


_new_name 


表 的 新 名 称 

_data_type_ 

新 字段 的 类 型 ， 或 者 现存 字段 的 新 类 型 。 
CASCADE 


自动 删除 依赖 于 被 删除 字段 的 对 象 (比如 ， 引 用 该 字段 的 视图 ) 。 


RESTRICT 


如 果 有 依赖 于 此 字段 的 对 象 ， 则 拒绝 删除 该 字段 。 这 是 缺 省 行为 。 


_new_owner_ 


该 表 的 新 所 有 者 的 用 户 名 。 


_new_schema_ 


表 将 要 移植 到 的 新 的 模式 名 称 


ss ate 


) 王 局 


关键 字 coLuMN 是 多 余 的 ， 可 以 省 略 。 


通过 App coLuMN 添加 字段 ， 或 通过 prop coum 删除 字段 ， 或 通过 添加 not NULL 进行 约 
束 ， 或 通过 set pata TYPE 修改 字段 的 数据 类 型 ， 都 不 会 检查 数据 一 致 性 。 确 保 表 定义 和 远 
端 表 定义 相 匹 配 是 用 户 的 责任 。 


参考 CREATE FOREIGN TABLE 部 分 获取 更 多 有 效 参数 的 描述 。 


示例 


设 定 一 个 字段 不 为 空 : 


ALTER FOREIGN TABLE distributors ALTER COLUMN street SET NOT NULL; 


修改 外 部 表 的 选项 : 

ALTER FOREIGN TABLE myschema.distributors OPTIONS (ADD opti 'value', SET opt2, 'value2', 
‘| ae 
兼容 性 


ADD, DROP 和 SET DATA TYPE 这 三 种 形式 符合 SQL 标准 。 其 他 形式 是 PostgreSQL 的 扩 
展 。 另 外 ， 一 个 ALTER FOREIGN TABLE 命 令 中 设置 多 个 操作 的 功能 也 是 扩展 。 








ALTER FOREIGN TABLE DROP COLUMN 可 以 删除 外 部 表 中 的 公有 的 唯一 一 个 列 ， 删除 之 后 就 是 一 
个 无 字段 的 表 。 这 个 特性 是 PostgreSQL 的 扩展 ， 标 准 SQL 中 不 允许 字段 的 表 。 


ALTER FUNCTION 


Name 


ALTER FUNCTION -- 修改 一 个 函数 的 定义 


Synopsis 


ALTER FUNCTION _name_ ( [ [ _argmode_ ] [ _argname_ ] _argtype_[, ...] ] ) 
Taction [... ] [ RESTRICT ] 

ALTER FUNCTION _name_ ( [ [ _argmode_ ] [ _argname_ ] _argtype_[, ...] ] ) 
RENAME TO _new_name_ 

ALTER FUNCTION _name_ ( [ [ _argmode_ ] [ _argname_ ] _argtype_[, ...] ] ) 
OWNER TO _new_owner_ 

ALTER FUNCTION _name_ ( [ [ _argmode_ ] [ _argname_ ] _argtype_[, ...] ] ) 


SET SCHEMA _new_schema_ 

where ~_action_~ is one of: 

CALLED ON NULL INPUT | RETURNS NULL ON NULL INPUT | STRICT 
IMMUTABLE | STABLE | VOLATILE | [ NOT ] LEAKPROOF 

[ EXTERNAL ] SECURITY INVOKER | [ EXTERNAL ] SECURITY DEFINER 
COST _execution_cost_ 

ROWS _result_rows_ 

SET _configuration_parameter_ { TO | = } { _value_ | DEFAULT } 
SET _configuration_parameter_ FROM CURRENT 

RESET _configuration_parameter_ 

RESET ALL 


摘 述 
ALTER FUNCTION 修改 一 个 函数 的 定义 。 


要 使 用 ALTER FUNCTION ， 你 必须 是 该 本 数 的 所 有 者 。 要 修改 一 个 函数 的 模式 ， 你 还 必须 在 新 
模式 上 拥有 create 权限 。 要 修改 所 有 者 ， 你 必须 还 是 新 的 所 有 角色 的 直接 或 者 间接 的 成 
员 ， 并 且 该 成 员 必 须 在 此 画 数 的 模式 上 有 create 权限 。 (这 些 限制 保证 了 修改 所 有 者 和 删 
除 、 重 建 函 数 的 动作 没 啥 区 别 。 不 过 ， 超 级 用 户 可 以 用 任何 方法 修改 函数 的 所 有 关系 。 ) 


参数 


_name_ 


—T ABBE F(A ARE tH) 。 


_argmode_ 


参数 的 模式 : IN, our. INOUT 或 是 vARIADIC 。 如 省 略 的 话 ， 缺 省 是 IN 。 È 
意 ALTER FUNCTION 实际 不 会 关注 任何 ouT 参数 ， 因为 确认 阔 数 的 逻辑 只 需要 知道 输入 参 
数 。 因此 列 出 IN 、 Inout 和 vARIADIC 参数 就 足够 了 。 


—argname_ 


参数 的 名 字 。 请 注意 ALTER FUNCTION 实际 上 不 会 关注 参数 的 名 字 ， 因 为 只 有 参数 的 数据 类 型 
FAFA i A 4, 


_argtype_ 
MRA, EA AARIA HH (ALAR th). 
函数 的 新 名 字 。 


_new_owner_ 


函数 的 新 所 有 者 。 请 注意 如 果 画 数 标记 为 SECURITY DEFINER ， 那 么 它 随 后 将 以 新 的 所 有 者 执 


{To 


_new_schema_ 
函数 的 新 模式 名 称 。 
CALLED ON NULL INPUT`` RETURNS NULL ON NULL INPUT STRICT 


CALLED ON NULL INPUT 选项 会 在 函数 的 部 分 或 是 全 部 的 参数 是 NULL 的 时 候 会 调用 它 。 
RETURNS NULL ON NULL INPUT 或 STRIcCT 把 函数 改 成 如 果 任 何 一 个 参数 是 NULL 就 根本 不 执行 
并 且 自 动 返回 NULL 。 参阅 CREATE FUNCTION 获 取 更 多 信息 。 


IMMUTABLE STABLE VOLATILE 
把 函数 的 易 失 属性 修改 为 指定 类 型 。 参 阅 CREATE FUNCTION 了 解 更 多 细节 。 
[ EXTERNAL ] SECURITY INVOKER [ EXTERNAL ] SECURITY DEFINER 


SECURITY INVOKER 表明 该 本 数 将 带 着 调用 它 的 用 户 的 权限 执行 。 SECURITY DEFINER PBA% 
数 闻 以 创建 它 的 用 户 的 权限 执行 。 关键 字 ExTERNAL 不 是 必需 的 ， 仅 是 为 了 和 SQL 兼容 。 参 
阅 CREATE FUNCTION 了 解 更 多 细节 。 


LEAKPROOF 

FARAR. Be CREATE FUNCTION 了 解 更 多 细节 。 
COST _execution_cost_ 

更 改 画 数 的 估计 执行 成 本 。 CREATE FUNCTION 了 解 更 多 细节 。 


ROWS _result_rows_ 


Fe Oi I ante Se WAAR EHT. CREATE FUNCTION 了 解 更 多 细节 。 
_configuration_parameter_ _value_ 


SHARAN, RIKER HABSR AA we. WR value 是 DEFAULT, 或 者 相应 
地 RESET 选项 被 使 用 ， 郴 数 的 局 部 设置 参数 会 被 清除 ， 这 样本 数 会 使 用 当前 环境 中 的 参数 值 
来 执行 。 使 用 reset ALL 来 清理 所 有 的 函数 局 部 设置 参 数 。 SET FROM CURRENT 保存 会 话 的 参 
数 当 前 值 为 函数 调用 时 会 应 用 的 参数 值 。 


参阅 SET 和 Chapter 18 了 解 更 多 关于 允许 的 参数 名 称 和 数值 的 信息 。 


RESTRICT 


可 忽略 的 选项 ， 仅 为 了 符合 SQL 标准 。 


例子 
把 参数 类 型 为 integer AYER sqrt 重 命名 为 square_root 


ALTER FUNCTION sqrt(integer) RENAME TO square_root; 


把 参数 类 型 为 integer 的 函数 sqrt 的 所 有 者 修改 为 joe 


ALTER FUNCTION sqrt(integer) OWNER TO joe; 


把 参数 类 型 为 integer AANA sqrt 的 模式 修改 为 maths 


ALTER FUNCTION sqrt(integer) SET SCHEMA maths; 


整 自动 为 函数 设 定 的 搜索 路 径 : 


ALTER FUNCTION check_password(text) SET search_path = admin, pg_temp; 


BA FA E+ xt —7S ER AXA) search_path 自动 设置 


ALTER FUNCTION check_password(text) RESET search_path; 


这 个 函数 在 执行 时 所 用 的 搜索 路 径 将 是 根据 调用 者 所 用 的 搜索 路 径 。 


这 个 语句 部 分 兼容 SQL 标准 里 面 的 ALTER FUNCTION 语句 。 标准 允许 修改 函数 的 更 多 属性 ， 但 
是 没有 提供 修改 函数 名 字 的 功能 ， 也 没有 提供 把 一 个 函数 定义 为 安全 定义 器 的 功能 ， 更 没有 
修改 画 数 所 有 者 、 模 式 、 易 失 性 的 功能 。 标准 还 要 求 RESTRICT 关键 字 ， 这 在 PostgreSQL 里 
是 可 选 的 。 


参见 


ZZ 


CREATE FUNCTION, DROP FUNCTION 


ALTER GROUP 


Name 


ALTER GROUP -- 修改 角色 名 或 者 成 员 关 系 


Synopsis 


ALTER GROUP _group_name_ ADD USER _user_name_ [, ... ] 
ALTER GROUP _group_name_ DROP USER _user_name_ [, ... ] 
ALTER GROUP _group_name_ RENAME TO _new_name_ 


摘 述 
ALTER GROUP 修改 一 个 用 户 组 的 属性 。 这 是 一 条 过 时 的 命令 ， 不 过 出 于 向 后 兼容 的 原因 ， 还 
RIES, 因为 组 〈 以 及 用 户 ) 都 已 经 被 更 一 般 的 概念 : AB, ARET. 


前 两 个 形式 从 组 中 增加 或 者 删除 用 户 。 (任何 角色 都 可 以 当 作 "用 户 "或 者 "组 "来 做 这 个 事 
情 。) 这 个 变 体 实 际 上 等 效 于 给 命名 为 "组 "的 角色 名 上 赋予 或 者 撤销 成 员 关 系 ; 因此 ， 做 这 
个 事情 的 比较 好 的 方法 是 GRANT 或 者 REVOKE。 


第 三 种 变 体 修改 一 个 组 的 名 字 。 它 完全 等 效 于 用 ALTER ROLE 重 命名 角色 。 


参数 


_group_name_ 


要 更 改 的 组 (角色 ) 名 称 。 


_user_name_ 


准备 向 组 (角色 ) 中 增加 或 从 组 (角色) 中 删除 的 用 户 名 。 用 户 必 须 已 经 存在 。 
ALTER GROUP 并 不 创建 或 删除 用 户 。 


_new_name_ 


组 的 新 名 字 。 


例子 


向 组 中 增加 用 户 : 


ALTER GROUP staff ADD USER karl, john; 


从 组 中 删除 用 户 : 


ALTER GROUP workers DROP USER beth; 


FANE 


SQL 标准 里 没有 ALTER croup 语句 。 


参见 


-i 


GRANT, REVOKE, ALTER ROLE 


ALTER INDEX 


Name 


ALTER INDEX -- 改变 一 个 索引 的 定义 


Synopsis 


ALTER INDEX [ IF EXISTS ] _name_ RENAME TO _new_name_ 
ALTER INDEX [ IF EXISTS ] _name_ SET TABLESPACE _tablespace_name_ 
ALTER INDEX [ IF EXISTS ] _name_ SET ( _storage_parameter_ = _value_[, ... ] ) 


ALTER INDEX [ IF EXISTS ] _name_ RESET ( _storage_parameter_[, ... ] ) 
ss 
描述 
ALTER INDEX 改变 一 个 现 有 索引 的 定义 。 它 有 几 种 子 形式 : 
IF EXISTS 


使 用 此 选项 ， 当 索引 不 存在 时 不 会 抛 出 错误 ， 只 会 有 一 个 提示 信息 。 
RENAME 


RENAME 只 改变 索引 的 名 字 。 对 存储 的 数据 没有 影响 。 


SET TABLESPACE 


这 个 选项 会 改变 索引 的 表 空 间 为 指定 表 空 间 ， 并 且 把 索引 相关 的 数据 文件 移动 到 新 的 表 空间 
里 。 参见 CREATE TABLESPACE 


SET ( _storage_parameter_ = _value [,...]) 


这 个 选项 会 改变 索引 的 一 个 或 多 个 索引 方法 特定 的 存储 参数 。 参 见 CREATE INDEX 获 取 可 用 
参数 的 细节 。 需要 注意 的 是 素 引 内 容 不 会 被 这 个 命令 立即 修改 ， 根 据 参数 的 不 同 ， 你 可 能 需 
要 使 用 REINDEX 重 建 素 引 来 获得 期 望 的 效果 。 


RESET ( _storage_parameter_ [,...] ) 


这 个 选项 重 置 索引 的 一 个 或 多 个 索引 方法 特定 的 存储 参数 为 缺 省 值 。 与 sET 一 样 ， 可 能 需 
使 用 REINDEX 来 完全 更 新 索引 。 


参数 


_name_ 


要 修改 的 索引 的 名 字 ( 可 以 有 模式 修饰 )。 


_new_name_ 


索引 的 新 名 字 。 


_tablespace_name_ 
索引 将 移动 到 的 表 空 间 的 名 字 。 


_storage_parameter_ 


索引 方法 特定 的 存储 参数 的 名 字 。 


_value_ 


索引 方法 特定 的 存储 参数 的 新 值 。 根 据 参 数 的 不 同 ， 这 可 能 是 一 个 数字 或 单词 。 


NS E e d 
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这 些 操 作 也 可 以 用 ALTER TABLE 进 行 。 ALTER INDEX 实际 上 只 是 acter TABLE 用 于 索引 的 形 
式 的 一 个 别名 。 


以 前 还 有 一 个 ALTER INDEX owNER 变种 ， 但 是 现在 忽略 了 ( 带 一 个 警告 )。 一 个 索引 不 能 有 一 个 


和 其 表 的 属 主 不 同 的 所 有 者 。 改 变 该 表 的 所 有 者 将 自动 改变 索引 的 所 有 者 。 
不 允许 修改 系统 表 索 引 的 任何 部 分 。 

例子 

重 命名 一 个 现 有 的 索引 : 


ALTER INDEX distributors RENAME TO suppliers; 


把 一 个 索引 移动 到 另外 一 个 表 空 间 : 


ALTER INDEX distributors SET TABLESPACE fasttablespace; 


改变 索引 的 占 位 因数 (假定 该 索引 方法 支持 它 ) : 


ALTER INDEX distributors SET (fillfactor = 75); 
REINDEX INDEX distributors; 


PostgreSQL 中 文 文档 9.3 


ALTER INDEX 是 PostgreSQL 扩 展 。 


参见 


D 


CREATE INDEX, REINDEX 


ALTER INDEX 1536 


ALTER LANGUAGE 


Name 


ALTER LANGUAGE -- 修改 一 个 过 程 语 言 的 定义 


Synopsis 


ALTER [ PROCEDURAL ] LANGUAGE _name_ RENAME TO _new_name_ 
ALTER [ PROCEDURAL ] LANGUAGE _name_ OWNER TO _new_owner_ 


描述 
ALTER LANGUAGE 修改 一 个 语言 的 定义 。 目前 唯一 的 功能 就 是 重 命名 语言 或 是 设置 新 的 所 有 


者 。 只 有 超级 用 户 或 者 语言 的 所 有 者 可 以 使 用 ALTER LANGUAGE o 


参数 


_name_ 

z = a 
语言 的 名 字 。 
_new_name_ 


语言 的 新 名 字 。 


_new_owner_ 


语言 的 新 的 所 有 者 。 


兼容 性 


SQL 标准 里 没有 ALTER LANGUAGE 语句 。。 


D 


参见 


CREATE LANGUAGE, DROP LANGUAGE 


ALTER LARGE OBJECT 


Name 


ALTER LARGE OBJECT -- change the definition of a large object 


Synopsis 


ALTER LARGE OBJECT _large_object_oid_ OWNER TO _new_owner_ 





fia ah 


ALTER LARGE OBJECT 更 改 一 个 large object 的 定义 。 它 的 唯一 的 功能 是 分 配 一 个 新 的 所 有 者 。 
使 用 ALTER LARGE 0BJECT 必须 是 超 户 或 者 是 其 所 有 者 。 


参数 


large_object_oid 





= 4 X large object 的 OID 


_new_owner_ 


large object 新 的 所 有 者 


兼容 性 


在 SQL 标准 里 没有 ALTER LARGE OBJECT 语句 。 


相关 内 容 


Chapter 32 


ALTER MATERIALIZED VIEW 


Name 


ALTER MATERIALIZED VIEW -- 修改 物化 视图 的 定义 


Synopsis 


ALTER MATERIALIZED VIEW [ IF EXISTS ] _name_ 
actions a ea] 
ALTER MATERIALIZED VIEW [ IF EXISTS ] _name_ 
RENAME [ COLUMN ] _column_name_ TO _new_column_name 
ALTER MATERIALIZED VIEW [ IF EXISTS ] _name_ 
RENAME TO _new_name_ 
ALTER MATERIALIZED VIEW [ IF EXISTS ] _name_ 
SET SCHEMA _new_schema_ 





where ~_action_~ is one of: 


ALTER [ COLUMN ] _column_name_ SET STATISTICS _integer_ 

ALTER [ COLUMN ] _column_name_ SET ( _attribute_option_ = _value_ [, ... ] ) 
ALTER [ COLUMN ] _column_name_ RESET ( _attribute_option_ [, ... ] ) 

ALTER [ COLUMN ] _column_name_ SET STORAGE { PLAIN | EXTERNAL | EXTENDED | MAIN } 
CLUSTER ON _index_name_ 

SET WITHOUT CLUSTER 

SET ( _storage_parameter_ = _value_ [, ... ] ) 

RESET ( _storage_parameter_ [, ... ] ) 

OWNER TO _new_owner_ 

SET TABLESPACE _new_tablespace_ 





ALTER MATERIALIZED VIEW 改变 一 个 现 有 物化 视图 的 各 种 辅助 属性 。 


要 使 用 ALTER MATERIALIZED VIEW ， 你 必须 拥有 该 物化 视图 。 要 改变 一 个 物化 视图 的 模式 ， 也 
必须 有 在 新 模式 上 的 create 权限 。 要 修改 所 有 者 ， 你 必须 是 新 所 有 角色 的 直接 或 间接 成 员 ， 

并 且 该 角色 必须 在 该 物化 视图 的 模式 上 拥有 create 权限 。 (通过 删除 然后 重建 物化 视图 ， 这 
些 限 制 强制 修改 所 有 者 不 做 任何 你 不 能 做 的 事情 。 不 过 ， 一 个 超级 用 户 可 以 修改 任意 视图 的 
MAR. ) 


ALTER MATERIALIZED VIEW 可 用 的 语句 的 从 属 形式 和 动作 是 ALTER TABLE 可 用 的 一 个 子 集 ， 当 
用 于 物化 视图 时 有 相同 的 含义 。 参阅 ALTER TABLE 的 描述 获取 细节 。 


参数 


_name_ 


现 有 物化 视图 的 名 字 〈 可 以 有 模式 修饰 ) 。 


_column_name_ 


一 个 新 的 或 现 有 字段 的 名 字 。 


new_column_name 





为 一 个 现 有 字段 新 增 名 字 。 


_new_owner_ 


物化 视图 新 的 所 有 者 的 用 户 名 。 


_new_name_ 


物化 视图 的 新 名 字 。 


_new_schema_ 


物化 视图 的 新 模式 。 


例子 
重 命名 物化 视图 foo 为 bar : 


ALTER MATERIALIZED VIEW foo RENAME TO bar; 


兼容 性 


ALTER MATERIALIZED VIEW 是 一 个 PostgreSQL 扩 展 。 


义 见 


CREATE MATERIALIZED VIEW, DROP MATERIALIZED VIEW, REFRESH MATERIALIZED 
VIEW 


ALTER OPERATOR 


Name 


ALTER OPERATOR -- 修改 一 个 操作 符 的 定义 


Synopsis 


ALTER OPERATOR _name_ ( { _ left _ type | NONE } , { _right_type_ | NONE } ) OWNER TO _new_ 





ALTER OPERATOR _name_ ( { _left_type_ | NONE } , { _right_type_ | NONE } ) SET SCHEMA _ne 








ALTER OPERATOR 改变 一 个 操作 符 的 定义 。 目前 唯一 能 用 的 功能 是 改变 操作 符 的 所 有 者 。 


要 使 用 ALTER OPERATOR， 你 必须 是 该 操作 符 的 所 有 者 。 要 修改 所 有 者 ， 你 还 必须 是 新 的 

所 有 角色 的 直接 或 间接 成 员 ， 并 且 该 成 员 必 须 在 此 操作 符 的 模式 上 有 create 权限 。 (这 些 限 
制 强制 了 修改 该 所 有 者 不 会 做 任何 通过 删除 和 重建 操作 符 不 能 做 的 事情 。 不 过 ， 超 级 用 户 可 

以 以 任何 方式 修改 任意 操作 符 的 所 有 权 。 ) 


参数 


_name_ 


一 个 现 有 操作 符 的 名 字 ( 可 以 有 模式 修饰 )。 


_left_type_ 
操作 符 的 左 操作 数 的 数据 类 型 ; 如 果 没 有 左 操作 数 ， 那 么 写 none o 
_right_type_ 
操作 符 的 右 操作 数 的 数据 类 型 ; 如 果 没 有 右 操作 数 ， 那 么 写 none o 


_new_owner_ 


操作 符 的 新 所 有 者 。 


_new_schema_ 


操作 符 的 新 模式 名 。 


例子 
改变 一 个 用 于 text 的 用 户 定义 操作 符 a @@b: 


ALTER OPERATOR @@ (text, text) OWNER TO joe; 


RANE 


SQL 标准 里 没有 ALTER OPERATOR 语句 。 


参见 


D 


CREATE OPERATOR, DROP OPERATOR 


ALTER OPERATOR CLASS 


Name 


ALTER OPERATOR CLASS -- 修改 一 个 操作 符 类 的 定义 


Synopsis 


ALTER OPERATOR CLASS _name_ USING _index_method_ RENAME TO _new_name_ 
ALTER OPERATOR CLASS _name_ USING _index_method_ OWNER TO _new_owner_ 
ALTER OPERATOR CLASS _name_ USING _index_method_ SET SCHEMA _new_schema_ 











摘 述 
ALTER OPERATOR CLASS 修改 一 个 操作 符 类 的 定义 。。 


要 使 用 ALTER OPERATOR CLASS ， 你 必须 该 操作 符 类 的 所 有 者 。 要 修改 所 有 者 ， 你 还 必须 是 新 
的 所 有 角色 的 直接 或 间接 成 员 ， 并 且 该 成 员 必 须 在 此 操作 符 类 的 模式 上 有 create 权限 。 (这 
些 限 制 强制 了 修改 该 所 有 者 不 会 做 任何 通过 删除 和 重建 操作 符 类 不 能 做 的 事情 。 不 过 ， 超 级 
用 户 可 以 以 任何 方式 修改 任意 操作 符 类 的 所 有 权 。) 


参数 


_name_ 


一 个 现 有 操作 符 类 的 名 字 ( 可 以 有 模式 修饰 ) 。 


index_method 





一 个 操作 符 类 操作 的 索引 方法 的 名 字 。 


_new_name 


操作 符 类 的 新 名 字 。 


_new_owner_ 


操作 符 类 的 新 所 有 者 。 


_new_schema_ 


操作 符 类 的 新 模式 名 。 


PostgreSQL 中 文 文档 9.3 
DSS 
兼容 性 
SQL 标 准 里 没有 ALTER OPERATOR CLASS 语句 。 


参见 


— 


CREATE OPERATOR CLASS, DROP OPERATOR CLASS, ALTER OPERATOR FAMILY 


ALTER OPERATOR CLASS 1544 


ALTER OPERATOR FAMILY 


Name 


ALTER OPERATOR FAMILY -- 修改 操作 符 族 的 定义 


Synopsis 


ALTER OPERATOR FAMILY _name_ USING _index_method_ ADD 
{ OPERATOR _strategy_number_ _operator_name_ ( _op_type_, _op_type_ ) [ FOR SEARCH | F 
| FUNCTION _support_number_ [ ( _op_type_ [ , _op_type_ ] ) ] _function_name_ ( _argum 
Ii o 
ALTER OPERATOR FAMILY _name_ USING _index_method_ DROP 
{ OPERATOR _strategy_number_ ( _op_type_ [ , _op_type_ ] ) 
| FUNCTION _support_number_ ( _op_type_ [ , _op_type_ ] ) 
} [, ...] 
ALTER OPERATOR FAMILY _name_ USING _index_method_ RENAME TO _new_name_ 
ALTER OPERATOR FAMILY _name_ USING _index_method_ OWNER TO _new_owner_ 
ALTER OPERATOR FAMILY _name_ USING _index_method_ SET SCHEMA _new_schema_ 
































ALTER OPERATOR FAMILY 修改 一 个 操作 符 族 的 定义 。 你 可 以 添加 操作 符 和 支持 函数 到 该 族 、 从 
该 族 中 删除 它们 或 修改 该 族 的 名 字 或 所 有 者 。 


当 使 用 ALTER OPERATOR FAMILY 添加 操作 符 和 支持 函数 到 一 个 族 时 ， 它们 不 是 该 操作 符 族 中 任 
意 指定 操作 符 类 的 一 部 分 ， 只 是 "松散 "在 该 族 中 。 这 表明 这 些 操作 符 和 画 数 与 该 族 的 语义 兼 
a, 但 不 是 正确 运行 任何 指定 素 引 的 所 需 。 (操作 符 和 男 数 要 成 为 索引 的 所 需 ， 应 该 被 声明 
为 一 个 操作 符 类 的 一 部 分 ; 参阅 CREATE OPERATOR CLASS, ) PostgreSQL 将 人 允许 一 人 
O A Ra tines 但 是 操作 符 类 的 成 员 不 能 被 删除 ， 除非 删除 整个 
类 和 任何 依赖 于 它 的 索引 。 典 型 的 ， 单 数据 类 型 操作 符 和 郴 数 是 操作 符 类 的 一 部 分 ， 因为 需 
要 它们 支持 一 个 特定 数据 类 型 的 索引 ， 而 交叉 数据 类 型 操作 符 和 男 数 由 族 的 松散 成 员 组 成 。 


要 使 用 ALTER OPERATOR FAMILY ， 你 必须 是 一 个 超级 用 户 。 (做 这 个 限制 是 因为 一 个 错误 的 操 
作 符 族 定义 会 混淆 或 者 甚至 崩溃 服务 器 。 ) 


ALTER OPERATOR FAMILY 目前 并 不 检查 操作 符 族 定义 是 否 包 括 索引 方法 所 需 的 所 有 操作 符 和 西 
数 ， 也 不 检查 操作 符 和 画 数 是 否 来 自 一 个 自 相 一 致 的 集合 。 定 义 一 个 有 效 的 操作 符 族 是 用 户 
的 责任 。 


参阅 Section 35.14 获 取 更 多 信息 。 


_name_ 


一 个 现 有 操作 符 族 的 名 字 〈 可 以 有 模式 修饰 ) 。 


index_method 





使 用 这 个 操作 符 族 的 索引 方法 的 名 字 。 

_strategy_number_ 

该 索引 方法 的 与 该 操作 符 族 相关 的 一 个 操作 符 的 策略 数 。 

_operator_name_ 

与 该 操作 符 族 相关 的 一 个 操作 符 的 名 字 〈 可 以 有 模式 修饰 ) 。 

—op_type_ 

在 一 个 operator 子 句 中 ， 该 操作 符 的 操作 数 的 数据 类 型 或 NoNE 表示 一 个 左 目 或 右 目 操作 
符 。 不 像 CREATE OPERATOR CLASS 中 可 比较 的 语法 ， 必 须 总 是 指定 操作 数 的 数据 类 型 。 


在 一 个 ap Function 子 句 中 ， 豆 数 的 操作 数 的 数据 类 型 如 果 和 与 该 函数 的 输入 数据 类 型 不 同 ， 
则 打算 支持 操作 数 的 数据 类 型 。 对 于 B-tree 上 比较 函数 和 哈 希 函数 ， 不 需要 指定 _op type, 
因为 函数 的 输入 数据 类 型 总 是 要 使 用 的 正确 类 型 。 对 于 B-tree 排 序 支持 函数 和 所 有 在 GiST、 
SP-GiST 和 GIN 操 作 符 类 中 的 函数 ， 必 须 指 定 该 男 数 要 使 用 的 操作 数 的 数据 类 型 。 


在 prop Function 子 句 中 ， 打 算 支 持 的 函数 的 操作 数 的 数据 类 型 必须 指定 。 


sort_family_name 





描述 与 一 个 排序 操作 符 相关 的 排序 顺序 的 现 有 btree 操作 符 族 的 名 字 (可 以 有 模式 修饰 ) 。 
如 果 既 没有 指定 For SEARCH 也 没有 指定 FOR ORDER BY, 那么 FOR SEARCH 是 缺 省 。 


_support_number_ 


SRR AN— TSAI AKAN AE, 


_function_name_ 


BRR RORSIA BRERA BAMAF (可 以 有 模式 修饰 ) 。 


_argument_type_ 


AKASA HB. 


_new_name_ 


操作 符 族 的 新 名 字 。 


_new_owner_ 


操作 符 族 的 新 所 有 者 。 


_new_schema_ 
操作 符 族 的 新 模式 。 
OPERATOR 和 FUNCTION 子 句 可 以 以 任意 顺序 出 现 。 


3+ =z 
/ 工 忆 


请 注意 ， DRoP 语法 只 指定 了 操作 符 族 中 的 "位 置 "， 通过 策略 或 支持 数 和 输入 数据 类 型 。 占 领 
该 位 置 的 操作 符 或 函数 的 名 字 没 有 提 及 。 另外 ， 对 于 DROP Function 来 说 ， 要 指定 的 类 型 是 
该 画 数 打算 支持 的 输入 数据 类 型 ; 对 于 GiST、SP-GiST 和 GIN 索 引 来 说 ， 可 能 与 该 图 数 的 实 
际 输入 参数 类 型 无 关 。 


因为 索引 机 制 在 使 用 范 数 之 前 并 不 检查 男 数 上 的 访问 权限 ， 包括 一 个 操作 符 族 中 的 范 数 或 操 
作 符 相当 于 赋予 了 公共 执行 权限 。 这 对 于 操作 符 族 中 有 用 的 函数 的 种 类 通常 不 是 一 个 问题 。 


操作 符 不 应 该 通过 SQL 辑 数 定义 。 一 个 SQL 函 数 可 以 内 联 到 调用 查询 ， 这 将 阻止 优化 器 认识 
到 该 查询 匹配 一 个 索引 。 


在 PostgreSQL 8.4 之 前 ， OPERATOR FA 会 包括 一 个 RECHECK 选项 。 现 在 不 再 支持 这 个 了 ， 
为 一 个 索引 操作 符 是 否 是 "松散 的 "决定 了 运行 时 的 动态 。 这 人 允许 有 效 的 处 理 操作 符 可 能 或 可 
能 不 是 松散 的 的 情况 。 


例子 


下 列 的 示例 命令 添加 了 跨 数据 类 型 的 操作 符 和 支持 函数 到 一 个 操作 符 族 ， 该 操作 符 族 早已 包 
含 数据 类 型 int4 和 int2 的 B-tree 操 作 符 类 。 


ALTER OPERATOR FAMILY integer_ops USING btree ADD 


- int4 vs int2 
OPERATOR 1 < (int4, int2) , 
OPERATOR 2 <= (int4, int2) , 
OPERATOR 3 = (int4, int2) , 
OPERATOR 4 >= (int4, int2) , 
OPERATOR 5 > (int4, int2) , 
FUNCTION 1 btint42cmp(int4, int2) , 


- int2 vs int4 


OPERATOR 1 < (int2, int4) , 
OPERATOR 2 <= (int2, int4) , 
OPERATOR 3 = (int2, int4) , 


OPERATOR 5 > (int2, int4) , 


1 
2 
3 
OPERATOR 4 >= (int2, int4) , 
5 
FUNCTION 1 btint24cmp(int2, int4) ; 


再 次 删除 这 些 条 目 : 


ALTER OPERATOR FAMILY integer_ops USING btree DROP 


-- int4 vs int2 

OPERATOR 1 (int4, int2) 
OPERATOR 2 (int4, int2) 
OPERATOR 3 (int4, int2) 
OPERATOR 4 (int4, int2) 
OPERATOR 5 (int4, int2) 
FUNCTION 1 (int4, int2) 


SSS OS oS 


-- int2 vs int4 

OPERATOR 1 (int2, int4) 
OPERATOR 2 (int2, int4) 
OPERATOR 3 (int2, int4) 
OPERATOR 4 (int2, int4) 
OPERATOR 5 (int2, int4) 
FUNCTION 1 (int2, int4) 


Soo Se Se Se OSS 


RANE 


SQL 标准 中 没有 ALTER OPERATOR FAMILY 语句 。 


义 见 


CREATE OPERATOR FAMILY, DROP OPERATOR FAMILY, CREATE OPERATOR CLASS, 
ALTER OPERATOR CLASS, DROP OPERATOR CLASS 


ALTER ROLE 


Name 


ALTER ROLE -- 修改 一 个 数据 库 角色 


Synopsis 


ALTER ROLE _name_ [ [ WITH ] _option_[... ] ] 
这 里 的 ` option ”可 以 是 : 


SUPERUSER | NOSUPERUSER 

CREATEDB | NOCREATEDB 

CREATEROLE | NOCREATEROLE 

CREATEUSER | NOCREATEUSER 

INHERIT | NOINHERIT 

LOGIN | NOLOGIN 

REPLICATION | NOREPLICATION 

CONNECTION LIMIT _connlimit_ 

[ ENCRYPTED | UNENCRYPTED ] PASSWORD '_password_' 
VALID UNTIL '_timestamp_' 


ALTER ROLE _name_ RENAME TO _new_name_ 


ALTER ROLE _name_ [ IN DATABASE _database_name_ ] SET _configuration_parameter_ { TO | = 
ALTER ROLE { _name_ | ALL } [ IN DATABASE _database_name_ ] SET _configuration_parameter_ 
ALTER ROLE { _name_ | ALL } [ IN DATABASE _database_name_ ] RESET _configuration_paramete 
ALTER ROLE { _name_ | ALL } [ IN DATABASE _database_name_ ] RESET ALL 





ALTER ROLE 修改 一 个 PostgreSQL 角 色 的 属性 。 


这 个 命令 的 第 一 种 形式 可 以 修改 很 多 CREATE ROLE 里 面 声 明 的 角色 属性 。 (除了 增加 和 删 
除 成 员 关 系 的 选项 之 外 ， 所 有 可 能 的 属性 都 有 介绍 ; 使 用 GRANT 和 REVOKE 可 以 实现 前 述 两 
件 事 。) 没有 在 命令 里 提 到 的 属性 维持 它们 以 前 的 设置 。 数 据 库 超级 用 户 可 以 给 任何 角色 改变 
任何 设置 。 拥有 cREATEROLE 权限 的 角色 可 以 修改 任意 这 些 设置 ， 但 是 只 能 给 非 超级 用 户 和 非 
复制 用 户 角色 设置 。 普通 的 角色 只 能 修改 它们 自己 的 口令 。 


第 二 种 形式 可 以 修改 角色 的 名 称 。 数 据 库 超级 用 户 可 以 修改 任何 角色 的 名 称 。 拥 

有 CREATEROLE 权限 的 角色 可 以 给 非 超 级 用 户 角色 进行 重 命名 。 当前 会 话 的 用 户 的 角色 是 不 能 
改名 的 。 (如 果 一 定 需 要 这 么 做 ， 则 必须 以 另外 一 个 用 户 的 身份 连接 系统 。) 因为 mos 加 密 
的 口令 使 用 角色 名 字 作 为 加 密 的 盐 粒 ， 所 以 ， MRODS mps 加 密 的 ， 那 么 给 一 个 角色 改名 


At A 
会 清空 其 口 兮 。 


其 他 的 形式 更 改 一 个 角色 的 会 话 配置 参数 默认 值 ， 该 值 要 么 针对 所 有 的 数据 库 ， 要 么 使 

用 IN DATABASE 选项 ， 仅 针对 指定 的 数据 库 。 如 果 是 未 指定 角色 名 称 而 是 使 用 了 a 选项 ， 
则 所 有 角色 的 相关 参数 都 会 更 改 。 当 同 时 使 用 ALL 和 IN DATABASE 选项 时 ， 就 等 同 于 使 

用 ALTER DATABASE ... SET ... o 

当 角 色 随 后 开启 一 个 新 会 话 ， 指 定 的 值 变 成 了 会 话 的 默认 值 ， 这 些 参数 值 会 覆盖 任 

何 postgresql.conf 中 的 设置 或 者 从 postgres 命令 行 接收 到 的 参数 值 。 这 仅 在 登录 时 发 生 ; 
执行 SET ROLE 或 者 SET SESSION AUTHORIZATION 不 会 引起 新 的 配置 值 设置 。 AMAR 
据 库 所 设 定 的 参数 会 被 附加 到 一 个 角色 上 的 特定 数据 库 的 参数 所 履 盖 。 为 指定 数据 库 或 指定 
角色 所 设 定 的 参数 会 覆盖 为 所 有 角色 设 定 的 参数 。 

超级 用 户 可 以 更 改 任何 一 个 会 话 默认 值 。 有 cREATEROLE 权限 的 角色 可 以 为 非 超级 用 户 角 色 更 
改 默认 值 。 普通 的 角色 只 能 为 自己 设置 默认 值 。 某 些 配置 变量 不 能 这 样 设置 ， 或 者 只 要 超级 
用 户 才能 执行 。 只 有 超级 用 户 才能 为 所 有 数据 库 中 的 所 有 角色 更 改 参 数 设 置 。 


参数 


需要 修改 属性 的 角色 的 名 称 。 


SUPERUSER` `NOSUPERUSER CREATEDB NOCREATEDB CREATEROLE NOCREATEROLE CREATEUSER 
NOCREATEUSER INHERIT NOINHERIT LOGIN NOLOGIN REPLICATION NOREPLICATION 
CONNECTION LIMIT _connlimit_ PASSWORD _password_ ENCRYPTED UNENCRYPTED 
VALID UNTIL ' _timestamp_ ' 

这 些 选项 修改 由 CREATE ROLE 初始 设置 的 属性 。 要 获取 更 多 详细 信息 ， 请 参 

阅 CREATE ROLE 参考 页 。 


_new_name 


角色 的 新 名 字 。 


_database_name_ 
要 设置 配置 变量 的 数据 库 的 名 称 。 
_configuration_parameter_ _value_ 


把 该 角色 指定 的 参数 缺 省 值 设置 为 给 定 值 。 如 果 value DEFAULT 或 是 相当 于 使 

用 RESET ， 指定 角色 的 参数 值 会 被 清除 ， 这 样 该 角色 将 在 新 的 会 话 里 继承 系统 级 的 参数 缺 省 
值 。 使 用 reset ALL 会 清除 所 有 角色 相关 的 设置 。 使 用 SET From current 会 将 会 话 的 当前 参 
数值 保存 为 特定 角色 的 缺 省 参数 值 。 如 果 使 用 了 IN DATABASE 选项 ， 则 仅仅 指定 的 角色 和 数 
据 库 可 以 设置 或 者 清除 相关 参数 。 


特定 角色 的 参数 设置 仅仅 在 登录 时 起 效 ; SET ROLE 和 SET SESSION AUTHORIZATIONABE 
进行 特定 角色 的 参数 设置 。 


参阅 SET 和 Chapter 18 获 取 有 关 人 允许 的 参数 名 称 和 数值 的 更 多 信息 。 
ss a 

as 

使 用 CREATE ROLE 增加 新 角色 ， 使 用 DROP ROLE 删除 旧 角 色 。 


ALTER ROLE 不 能 改变 角色 的 成 员 关 系 。 可 以 使 用 GRANT 和 REVOKE 做 这 个 事情 。 


使 用 这 个 命令 指定 一 个 未 加 密 的 密码 时 必须 小 心 ， 因 为 密码 将 以 明文 方式 传送 到 服务 器 ， 并 
且 可 能 被 客户 端 命 令 历 史记 录 或 者 和 被 服务 器 日 志 记 录 。 psql 包 含 一 个 可 以 用 来 安全 修改 角色 
密码 的 \password 命令 ， 这 个 命令 不 会 暴露 明文 的 密码 。 


也 可 以 把 会 话 缺 省 参数 值 与 数据 库 绑 定 而 不 是 与 角色 绑 定 ; 参阅 ALTER DATABASE, WRA 
冲突 ， 那 么 指定 角色 加 数据 库 的 参数 设置 将 履 盖 指定 角色 的 参数 设置 ， 而 后 者 又 可 以 履 盖 指 
定数 据 库 的 参数 设置 。 


例子 
改变 一 个 角色 的 口令 : 


ALTER ROLE davide WITH PASSWORD 'hu8jmn3'; 


清除 一 个 角色 的 口 兮 : 


ALTER ROLE davide WITH PASSWORD NULL; 


改变 口令 失效 的 日 期 ， 声 明 口令 应 该 在 2015 年 5 月 4 日 中 午 失 效 ， 时 区 比 UTC 早 一 个 小 时 : 
ALTER ROLE chris VALID UNTIL 'May 4 12:00:00 2015 +1'; 

设置 一 个 口 命 永久 有 效 : 
ALTER ROLE fred VALID UNTIL ‘infinity'; 


授予 一 个 角色 创建 其 它 角 色 和 新 数据 库 的 权限 : 


ALTER ROLE miriam CREATEROLE CREATEDB; 


给 一 个 角色 设置 非 缺 省 的 maintenance_work_mem 参 数值 : 


ALTER ROLE worker_bee SET maintenance_work_mem = 100000; 


给 一 个 角色 设置 非 缺 省 的 、 指 定数 据 库 的 client_min_messages 参 数值 : 


ALTER ROLE fred IN DATABASE devel SET client_min_messages = DEBUG; 


FANE 


ALTER ROLE 语句 是 一 个 PostgreSQL 扩 展 。 


参见 


A 


CREATE ROLE, DROP ROLE, ALTER DATABASE, SET 


ALTER RULE 


Name 


ALTER RULE -- 修改 一 个 规则 的 定义 


Synopsis 


ALTER RULE _name_ ON _table_name_ RENAME TO _new_name_ 





摘 述 
ALTER RULE 修改 一 个 规则 的 定义 。 目 前 仅 可 以 修改 规则 的 名 称 。 


要 使 用 ALTER RULE ， 用 户 必须 是 应 用 了 指定 规则 的 表 或 视图 的 所 有 者 。 


参数 


_name_ 


要 修改 规则 的 名 称 。 


_table_name_ 


应 用 了 指定 规则 的 表 或 视图 的 名 称 (可 以 有 模式 修饰 符 ) 。 


_new_name 


规则 的 新 名 称 。 


例子 
将 一 个 规则 的 名 称 进行 重 命 名 : 


ALTER RULE notify_all ON emp RENAME TO notify_me; 


兼容 性 


ALTER RULE 是 PostgreSQL 的 扩展 ， 这 个 语句 会 重 写 系统 内 容 。 
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参见 


El 


CREATE RULE, DROP RULE 


ALTER RULE 1554 


ALTER SCHEMA 


Name 


ALTER SCHEMA -- 修改 一 个 模式 的 定义 


Synopsis 


ALTER SCHEMA _name_ RENAME TO _new_name_ 
ALTER SCHEMA _name_ OWNER TO _new_owner_ 


摘 述 
ALTER SCHEMA 修改 一 个 模式 的 定义 。 


要 使 用 ALTER schema ， 你 必须 是 该 模式 的 所 有 者 。 要 给 一 个 模式 重 命名 ， 你 必须 在 该 数据 库 
上 有 create 权限 。 要 修改 所 有 者 ， 你 还 必须 是 新 的 所 有 角色 的 直接 或 间接 成 员 ， 并 且 该 成 
员 必 须 在 此 数据 库 上 有 create 权限 。 (超级 用 户 自动 拥有 全 部 权限 。) 


参数 


_name_ 


现 有 模式 的 名 字 。 


_new_name 


模式 的 新 名 字 ， 新 名 字 不 能 以 pg 开头， 因为 这 些 名 字 是 保留 给 系统 模式 的 。 
_new_owner_ 


模式 的 新 所 有 者 。 


兼容 性 


SQL 标准 里 没有 ALTER SCHEMA 语句 。 
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CREATE SCHEMA, DROP SCHEMA 


ALTER SCHEMA 1556 


ALTER SEQUENCE 


Name 


ALTER SEQUENCE -- 更 改 一 个 序列 生成 器 的 定义 


Synopsis 


ALTER SEQUENCE [ IF EXISTS ] _name_ [ INCREMENT [ BY ] _increment_ ] 

MINVALUE _minvalue_ | NO MINVALUE ] [ MAXVALUE _maxvalue_ | NO MAXVALUE ] 
START [ WITH ] _start_ ] 

RESTART [ [ WITH ] _restart_ ] ] 

CACHE _cache_ ] [ [ NO ] CYCLE ] 

OWNED BY { _table_name_._column_name_ | NONE } ] 

ALTER SEQUENCE [ IF EXISTS ] _name_ OWNER TO _new_owner_ 

ALTER SEQUENCE [ IF EXISTS ] _name_ RENAME TO _new_name_ 

ALTER SEQUENCE [ IF EXISTS ] _name_ SET SCHEMA _new_schema_ 


Ce ee Ds De ss 





fia ah 


ALTER SEQUENCE 命令 修改 一 个 现 有 的 序列 发 生 器 的 参数 。 任何 没有 明确 在 ALTER SEQUENCE 
命令 里 声明 的 参数 都 将 保留 原先 的 设置 。 


要 使 用 ALTER SEQUENCE ， 你 必须 是 该 序列 的 所 有 者 。 要 改变 一 个 序列 的 模式 ， 你 必须 在 新 的 
模式 上 有 create 权限 。 要 改变 一 个 序列 的 所 有 者 ， 你 必须 也 是 新 的 所 有 角色 的 直接 或 者 间 
接 的 成 员 ， 并 且 那 个 角色 必须 有 序列 模式 上 的 create 权限 。 (这 些 约束 强制 在 改变 所 有 者 

时 只 能 做 删除 或 者 创建 序列 时 能 做 的 操作 。 然 而 ， 超 级 用 户 可 以 以 任何 方式 改变 任意 序列 的 
成 员 关 系 。) 


参数 


_name_ 


一 个 要 修改 的 序列 的 名 字 ( 可 以 有 模式 修饰 )。 

IF EXISTS 

当 序 列 不 存在 时 使 用 该 选项 不 会 出 现 错 误 信 息 ， 仅 有 一 个 提示 信息 。 
_increment_ 


INCREMENT BY _increment_ 选项 是 可 选 的 。 一 个 正 数 会 让 序列 成 为 递增 序列 ， 负 数 则 成 为 递 
减 序列 。 如 果 没 有 声明 ， 将 治 用 原来 的 递增 值 。 


_minvalue_~ “NO MINVALUE 


MINVALUE _minvalue. 是 一 个 可 选 选项 ， 它 决定 一 个 序列 可 以 生成 的 最 小 的 值 。 如 果 声 明 
了 No MINVALUE ， 那 么 将 使 用 缺 省 值 ， 对 于 递增 和 递减 的 序列 分 别 是 1 和 -2<sup 
class="calibre28">63</sup>-1。 如 果 没 有 声明 则 治 用 当前 的 最 小 值 。 


_maxvalue_ NO MAXVALUE 


MAXVALUE _maxvalue_ 是 一 个 可 选 选项 ， 它 决定 一 个 序列 可 以 生成 的 最 大 的 值 。 如 果 声 明 
了 No MAXVALUE 那么 将 使 用 缺 省 值 ， 对 于 递增 和 递减 的 序列 分 别 是 2<sup 
class="calibre28">63</sup>-1 和 -1。 如 果 没 有 声明 则 治 用 当前 的 最 大 值 。 


_Sstart_ 

START WITH _start_ 是 一 个 可 选 选项 ， 它 修改 序列 的 起 始 值 。 这 对 序列 当前 值 没 有 影响 ; 
它 信 设置 将 来 的 ALTER SEQUENCE RESTART 命令 将 会 使 用 的 值 。 

_restart_ 

RESTART [ WITH _restart_ ] 是 一 个 可 选 选项 ， 它 改变 序列 的 当前 值 。 这 相当 于 

用 is called = false 参数 调用 setval WA : 指定 的 值 将 会 通过 nextval 的 next 调 用 返 
E. 不 使 用 restart. 参数 值 来 使 用 RESTART 选项 相当 于 使 用 CREATE SEQUENCE 或 


由 ALTER SEQUENCE START WITH 设置 的 初始 值 。 

_cache_ 

CACHE _cache_ 选项 打开 序列 号 预 分 配 功能 以 及 为 了 快速 存 取 而 在 内 存 中 存储 的 功能 。 最 小 
值 是 1 (表示 每 次 只 能 生成 一 个 数值 ， 没 有 缓冲 ) 。 如 果 没 有 声明 ， 将 治 用 旧 的 缓冲 值 。 
CYCLE 

可 选 的 cyce 选项 用 于 设置 升序 序列 或 是 降序 序列 在 达到 _maxvalue_ 或 者 _minvalue_ 的 时 
候 循 环 使 用 。 如 果 达 到 了 极限 ， 那么 生成 的 下 一 个 数字 将 分 别 是 _minvalue_ 或 


者 _maxvalue_ o 


NO CYCLE 


如 果 声 明了 可 选 的 no cyce 选项 ， 任 何在 序列 达到 其 极限 后 对 nextval 的 调用 都 将 返回 错 
误 。 如 果 未 声明 cyce 或 者 No cyYcLE ， 那 么 将 治 用 原 有 的 循环 行为 。 


OWNED BY table_name_ . _column_name OWNED BY NONE 





OWNED BY 选项 将 序列 和 一 个 表 的 特定 字段 关联 ， 这 样 ， 如 果 那 个 字段 (或 整个 表 ) 被 删除 了 ， 
那么 序列 也 将 被 自动 删除 。 如 果 序 列 已 经 与 表 有 关联 后 ， 使 用 这 个 选项 后 新 关联 特 履 盖 旧 有 
的 关联 。 指定 的 表 必 须 与 序列 的 所 有 者 相同 并 且 在 同一 个 模式 中 。 使 用 owe BY none 将 删 
除 任何 已 经 存在 的 关联 ， 也 就 是 让 该 序列 变 成 "独立 "序列 。 


_new_ owner 


序列 新 所 有 者 的 用 户 名 。 


_new_name 


序列 的 新 名 称 。 


_new_schema_ 


序列 的 新 模式 。 
注意 


为 避免 从 同一 序列 获取 序列 值 的 并 发 事务 阻塞 ， 在 序列 产生 参数 上 的 ALTER SEQUENCE 的 影响 
从 不 回 滚 ; 这 些 改变 会 立刻 生效 并 且 是 不 可 逆 的 ; 然 
而 ， OWNED BY 、 OWNER TO, RENAME TO 和 SET SCHEMA 选项 会 引起 可 被 回 滚 的 普通 更 新 。 


除了 当前 的 正在 运行 取 值 操作 ， ALTER SEQUENCE 不 会 立刻 影响 后 台 的 nextval 结果 。 序列 在 
使 用 完 所 有 缓存 的 序列 值 后 才 会 使 用 变化 后 的 序列 参数 值 。 当 前 后 台 正 在 运行 取 值 操作 将 会 


立刻 受到 影响 。 


ALTER SEQUENCE 不 影响 序列 的 currval KA. (在 PostgreSQL 8.3 之 前 ， 有 时 会 影响 。) 


由 于 历史 原因 ， ALTER TABLE 也 可 用 于 序列 ; 但 是 ALTER TABLE 仅 有 的 与 序列 有 关 的 变化 等 价 
于 前 面 所 示 的 形式 。 


例子 
将 序列 serial 设 置 为 从 105 重 新 开始 取 值 : 


ALTER SEQUENCE serial RESTART WITH 105; 


RANE 


ALTER SEQUENCE 遵从 SQL 标准 ， 但 START WITH 、 
OWNED BY 、 OWNER TO 、 RENAME TO 和 SET SCHEMA 选项 是 PostgreSQL 的 扩展 。 


参见 


J 


CREATE SEQUENCE, DROP SEQUENCE 


ALTER SERVER 


Name 


ALTER SERVER -- 更 改 外 部 服务 器 的 定义 


Synopsis 


ALTER SERVER _name_ [ VERSION '_new_version_' ] 

[ OPTIONS ( [ ADD | SET | DROP ] _option_ ['_value_'] [, ... ] ) ] 
ALTER SERVER _name_ OWNER TO _new_owner_ 
ALTER SERVER _name_ RENAME TO _new_name_ 





摘 述 
ALTER SERVER 更 改 外 部 服务 器 的 定义 。 第 一 种 形式 改变 外 部 服务 器 版 本 字符 串 或 者 服务 器 的 
通用 选项 (至 少 需要 一 个 选项 ) 。 第 二 种 形式 改变 外 部 服务 器 的 所 有 者 。 


要 更 改 外 部 服务 器 ， 你 必须 是 外 部 服务 器 的 所 有 者 。 此 外 要 更 改 所 有 者 ， 你 必须 是 外 部 服务 
器 的 所 有 者 并 且 也 是 新 的 所 有 者 角色 的 直接 或 者 间接 成 员 ， 并 且 你 必须 对 外 部 服务 器 的 外 部 
数据 封装 器 有 usAGE 权限 。 《注意 超级 用 户 能 自动 满足 所 有 这 些 条 件 。) 


参数 


_name_ 


已 有 服务 器 的 名 称 。 


_new_version_ 


新 的 服务 器 版 本 。 


OPTIONS ( [ ADD | SET | DROP ] option_ [' value_ ‘][, ...]) 





外 部 服务 器 更 新 选项 。 ADDp 、 SET 和 prop 声明 要 被 执行 的 动作 。 若 没 有 明确 指定 操作 ， 则 
假定 为 ADD 。 选项 名 称 必须 是 唯一 的 ;名 称 和 数值 也 确认 是 使 用 服务 器 的 外 部 数据 封装 器 的 
库 。 


_new_owner_ 


外 部 服务 器 的 新 所 有 者 的 用 户 名 。 


_new_name 


外 部 服务 器 的 新 名 称 。 


例子 
更 改 服务 器 foo, 添加 连接 选项 : 


ALTER SERVER foo OPTIONS (host 'foo', dbname 'foodb'); 


更 改 服 务 器 foo， 更 改版 本 , 更 改 host 选 项 : 


ALTER SERVER foo VERSION '8.4' OPTIONS (SET host 'baz'); 


FANE 


ALTER SERVER 遵守 ISO/IEC 9075-9 (SQL/MED) 标 准 。 owNER TO 和 RENAME 选项 是 
PostgreSQL 扩 展 。 


参见 


一 


CREATE SERVER, DROP SERVER 


ALTER TABLE 


Name 


ALTER TABLE -- 修改 表 的 定义 


Synopsis 


ALTER TABLE [ IF EXISTS ] [ ONLY ] name [ * ] 
Bactvon= [Pe 
ALTER TABLE [ IF EXISTS ] [ ONLY ] name [ * ] 
RENAME [ COLUMN ] _column_name_ TO _new_column_name 
ALTER TABLE [ IF EXISTS ] [ ONLY ] _name_ [ * ] 
RENAME CONSTRAINT _constraint_name_ TO _new_constraint_name_ 
ALTER TABLE [ IF EXISTS ] _name_ 
RENAME TO _new_name_ 
ALTER TABLE [ IF EXISTS ] _name_ 
SET SCHEMA _new_schema_ 








其 中 `_action ”可 以 是 以 选项 之 一 : 


ADD [ COLUMN ] _column_name data_type_ [ COLLATE _collation_ ] [ _column_constraint 
DROP [ COLUMN ] [ IF EXISTS ] _column_name_ [ RESTRICT | CASCADE ] 











ALTER [ COLUMN ] _column_name_ [ SET DATA ] TYPE _data_type_ [ COLLATE _collation_ ] 
ALTER [ COLUMN ] _column_name_ SET DEFAULT _expression_ 

ALTER [ COLUMN ] _column_name_ DROP DEFAULT 

ALTER [ COLUMN ] _column_name_ { SET | DROP } NOT NULL 

ALTER [ COLUMN ] _column_name_ SET STATISTICS _integer_ 

ALTER [ COLUMN ] _column_name_ SET ( _attribute_option_ = _value_[, ... ] ) 

ALTER [ COLUMN ] _column_name_ RESET ( _attribute_option_ [, ... 

ALTER [ COLUMN ] _column_name_ SET STORAGE { PLAIN | EXTERNAL | EXTENDED | MAIN } 


ADD _table_constraint_ [ NOT VALID ] 

ADD _table_constraint_using_index_ 

VALIDATE CONSTRAINT _constraint_name_ 

DROP CONSTRAINT [ IF EXISTS ] _constraint_name_ [ RESTRICT | CASCADE | 
DISABLE TRIGGER [ _trigger_name_ | ALL | USER ] 
ENABLE TRIGGER [ _trigger_name_ | ALL | USER ] 
ENABLE REPLICA TRIGGER _trigger_name_ 

ENABLE ALWAYS TRIGGER _trigger_name_ 

DISABLE RULE _rewrite_rule_name_ 

ENABLE RULE _rewrite_rule_name_ 

ENABLE REPLICA RULE _rewrite_rule_name_ 
ENABLE ALWAYS RULE _rewrite_rule_name_ 
CLUSTER ON _index_name_ 

SET WITHOUT CLUSTER 

SET WITH OIDS 

SET WITHOUT OIDS 

SET ( _storage_parameter_ = _value_[, ... ] ) 
RESET ( _storage_parameter_[, ... ] ) 

INHERIT _parent_table 

NO INHERIT _parent_table 

OF _type_name_ 

NOT OF 

OWNER TO _new_owner_ 

SET TABLESPACE _new_tablespace_ 








and ~_table_constraint_using_index_~ is: 


[ CONSTRAINT _constraint_name_ ] 
{ UNIQUE | PRIMARY KEY } USING INDEX _index_name_ 
[ DEFERRABLE | NOT DEFERRABLE ] [ INITIALLY DEFERRED | INITIALLY IMMEDIATE ] 





ALTER TABLE 改变 一 个 现存 表 的 定义 。 它 有 好 几 种 子 形式 : 


ADD COLUMN 


这 种 形式 使 用 和 CREATE TABLE 一 样 的 语法 向 表 中 增加 一 个 新 的 字段 。 


DROP COLUMN [ IF EXISTS | 


这 种 形式 从 表 中 删除 一 个 字段 。 和 这 个 字段 相关 的 索引 和 表 约 束 也 会 被 自动 删除 。 如 果 任 何 
表 之 外 的 对 象 依 赖 于 这 个 字段 ， 必 须 使 用 cascape 选项 ， 上 比如 外 键 约束 、 视 图 等 。 如 果 使 用 
了 IF exists 选项 并 且 相 关 字 段 不 存在 ， 则 在 删除 时 不 会 显示 错误 ， 仅 会 有 一 个 提示 信息 。 


IF EXISTS 
如 果 使 用 了 IF exists 选项 并 且 表 不 存在 ， 则 在 删除 时 不 会 显示 错误 ， 仅 会 有 一 个 提示 信 
SET DATA TYPE 

这 种 形式 改变 表 中 一 个 字段 的 类 型 。 该 字段 涉及 的 索引 和 简单 的 表 约 束 将 被 自动 地 转换 为 使 
用 新 的 字段 类 型 ， 方 法 是 重新 分 析 最 初 提 供 的 表达 式 。 可 选 的 coLLATE 选项 定义 了 新 列 的 字 
符 集 排序 方式 ， 如 果 不 加 这 个 选项 ， 则 排序 方式 使 用 新 类 型 的 缺 省 值 。 可 选 的 UsING AME 
义 如 何 从 旧 的 字段 值 里 计算 新 的 字段 值 ; 如 果 省 略 ， 那 么 缺 省 的 转换 就 是 从 旧 类 型 向 新 类 型 
的 赋值 转换 。 如 果 从 旧 数 据 类 型 到 新 类 型 没有 隐 含 或 者 赋值 的 转换 ， 那 么 必须 提供 一 

个 USING 选项 。 


SET / DROP DEFAULT 


这 种 形式 设置 或 是 删除 一 列 的 缺 省 值 。 缺 省 值 仅 会 对 后 续 的 INSERT 或 是 UPDATE 命令 ， 不 会 
影响 已 经 在 表 中 存在 的 记录 。 


SET / DROP NOT NULL 


这 种 形式 修改 一 个 字段 是 否 人 允许 NULL 值 或 者 拒绝 NULL 值 。 如 果 表 中 字段 里 包含 非 NULL 
值 ， 那 么 你 只 可 以 使 用 set NoT NULL 选项 。 

SET STATISTICS 

这 种 形式 为 后 续 的 ANALYZE 操 作 设 置 每 列 的 数据 统计 目标 值 。 目标 值 可 以 设置 为 0 至 
10000 ; 相应 地 ， 设 置 为 -1 则 会 反 向 使 用 系统 缺 省 的 统计 目标 值 (default_statistics_target)。 
有 关 PostgreSQL 坦 询 规划 器 使 用 数据 统计 方面 的 更 多 信息 ， 可 以 参阅 Section 14.2。 


SET ( _attribute option = _value_ [,...]) RESET ( _attribute_option_ [, ...]) 





这 种 形式 设置 或 者 重 冒 每 个 属性 的 参数 值 。 目 前 ， 已 定义 的 属性 参数 值 

是 n_distinct 和 n_distinct_inherited ， 它们 会 覆盖 由 随后 的 ANALYZE 操 作 所 估算 的 
number-of-distinct-values。 n_distinct 影响 表 本 身 的 统计 值 ， 而 n_distinct_inherited 影响 
表 及 其 继承 子 表 的 统计 。 当 设 置 为 一 个 正 值 时 ， ANALYZE 将 会 假定 列 准确 包含 明确 的 非 空 值 
的 指定 数目 。 当 设 置 为 一 个 必须 大 于 或 者 等 于 -1 的 负 值 时 ， ANALYZzE 将 会 假定 在 列 中 的 不 同 
的 非 空 值 的 数目 与 表 的 大 小 关系 是 线性 的 ; 确切 的 统计 通过 将 估算 的 表 大 小 与 给 定数 字 的 绝 
对 值 相 乘 来 统计 。 例如 ， 值 -1 意味 着 在 此 列 中 的 所 有 值 是 不 同 的 ， 值 -0.5 意 味 着 每 个 值 平均 
出 现 两 次 。 当 表 的 大 小 随时 间 变 化 时 这 是 很 有 效 的 ， 尽 管 表 中 行 数 的 乘法 运算 在 查询 规划 计 
时 前 是 不 会 这 样 计算 的 ， 声明 一 个 0 值 来 正常 地 恢复 到 估计 不 同 数值 的 数目 。 要 获取 关于 使 
用 PostgreSQL 查 询 优化 器 做 统计 的 信息 ， 请 参阅 Section 14.2。 


SET STORAGE 


这 种 形式 为 一 个 字段 设置 存储 模式 。 这 个 设置 控制 这 个 字段 是 内 联 保存 还 是 保存 在 一 个 
TOAST 附 属 的 表 里 ， 以 及 数据 是 否 要 压缩 。 PLAIN 选项 必须 用 于 定 长 的 数值 ， 比 

如 E 并 且 是 内 联 的 、 不 压缩 的 。 MAIN 用 于 内 联 、 可 压缩 的 数据 。 ExTERNAL 用 于 外 部 
保存 、 不 压缩 的 数据 ， ExTENDED 用 于 外 部 的 压缩 数据 。 EXTENDED 是 大 多 数 支 持 非 PLAIN F 
K 值 。 使 用 EXTERNAL 将 会 在 text 和 bytea 字段 上 的 字符 串 操 作 更 快 ， 但 付出 
的 代价 是 增加 了 存储 空间 。 请 注意 set storace 本 身 并 不 改变 表 上 的 任何 东西 ， 只 是 设置 将 
来 的 表 操 作 时 ， 建 议 使 用 的 策略 。 参 阅 Section 58.2 获 取 更 多 信息 。 


ADD _table_constraint_ [NOT VALID ] 


这 种 形式 给 表 境 加 一 个 新 的 约束 ， 使 用 的 语法 和 CREATE TABLE 一 样 ， 而 与 NOT VALID 选项 
组 合 时 ， 这 种 约束 仅 在 对 外 键 和 CHECK 类 药 束 有 效 。 如 果 约 束 条 件 增 加 了 not va 选项 

后 ， 表 中 已 有 记录 是 否 满足 初始 约束 检查 会 被 跳 过 。 这 种 约束 会 对 后 续 的 新 增 记 录 或 是 记录 
更 新 产生 影响 〈 在 外 键 约束 的 情况 下 ， 除非 是 参照 的 表 中 有 匹配 的 记录 ， 否 则 这 样 的 情形 会 
出 错 ; 而 在 CHECK 约 束 下 ， 除 非 是 新 增 记 录 满 足 CHECK 约 束 条 件 ， 否 则 也 会 也 错 ) 。 (AR 
据 库 自 身 不 会 认定 这 种 约束 会 对 表 中 所 有 记录 生效 ， 除 非 是 在 使 用 了 VALIDATE CONSTRAINT 选 
项 进行 了 有 效 性 检查 。 


ADD _table_constraint_using_index_ 


这 种 形式 根据 已 有 的 唯一 索引 给 表 增 加 新 的 Primary KEY BK UNIQUE 约束 。 索 引 中 所 有 的 列 也 
会 在 包含 在 约束 中 。 


索引 中 不 能 含有 表达 式 列 或 者 是 局 部 索引 。 另 外 索引 的 缺 省 排序 方式 应 是 B-tree 类 型 。 这 些 限 
制 保证 了 索引 会 与 通过 正常 ADD PRIMARY KEY 或 ADD UNIQUE 选项 生成 的 索引 相同 。 


如 果 使 用 了 PRIMARY KEY 选项 ， ciii di EBELA not NULL ， 因 为 这 cbs 
的 列 去 执行 ALTER COLUMN SET NOT NULL 。 会 对 全 表 数 据 进行 扫描 以 验证 该 列 是 合 空 
t, (ERPS) ， 在 其 他 情况 下 ， 


如 果 指 定 了 一 个 约束 名 ， 索 引 将 会 被 重 命名 为 指定 的 约束 中 的 名 称 。 相 反 ， 约 束 会 被 命名 为 
索引 名 。 


在 这 个 命令 执行 后 ， 约 束 就 相当 于 是 索引 的 "所 有 者 "了 ， 就 如 同 使 用 
了 ADD PRIMARY KEY 或 ADD UNIQUE 命令 创建 的 索引 一 样 。 特别 要 注意 的 事 ， 这 种 情况 下 删除 
约束 也 会 清除 了 索引 。 


Note: 在 新 增 约 束 时 使 用 已 有 的 索引 对 新 约束 增加 时 对 表 记 录 的 较 长 时 间 不 能 更 新 的 问 
题 有 较 好 的 帮助 。 使 用 CREATE INDEX CONCURRENTLY 指令 可 以 实现 这 种 方式 ， 参 见 下 面 的 
示例 。 





VALIDATE CONSTRAINT 


这 种 形式 用 于 验证 一 个 外 键 或 是 一 个 使 用 NoT VALID 选项 创建 的 检查 类 约束 ， 通 过 扫描 全 表 
来 保证 所 有 记录 都 符合 约束 条 件 。 如 果 约 束 已 标记 为 有 效 时 ， 什 么 操作 也 不 会 发 生 。 


对 大 表 的 记录 进行 验证 一 般 是 一 个 很 长 的 过 程 ， 并 且 目 前 这 种 操作 还 需 
要 access EXcLUSIVE 排他 类 锁 。 初始 的 不 同 验 证 可 以 将 验证 工作 后 延至 系统 不 忙 时 进行 ， 或 
者 通过 先 花 一 点 额外 的 时 间 来 纠正 可 能 存在 的 错误 以 防止 新 错误 的 发 生 。 


DROP CONSTRAINT [ IF EXISTS ] 


这 种 形式 删除 一 个 表 中 指定 的 约束 ， 如 果 使 用 了 if exists 选项 并 且 约 束 并 不 存在 时 ， 也 不 
会 有 错误 产生 ， 仅 会 有 一 个 提示 信息 。 


DISABLE / ENABLE [ REPLICA | ALWAYS ] TRIGGER 


这 种 形式 禁用 或 者 启用 属于 该 表 的 触发 器 。 一 个 被 关闭 掉 的 触发 器 是 系统 仍然 知道 的 ， 但 是 
在 触发 器 事件 发 生 的 时 候 不 会 被 执行 。 对 于 一 个 推迟 了 的 触发 器 ， 在 触发 事件 发 生 的 时 候 会 
检查 打开 状态 ， 触 发 器 相关 的 函数 实际 也 不 会 执行 。 可 以 通过 指定 名 字 的 方法 启用 或 者 禁用 
任意 一 个 触发 器 ， 或 者 是 该 表 上 的 所 有 触发 器 ， 或 者 只 是 用 户 自 定义 的 触发 器 (这 个 选项 排除 
了 那些 用 于 实现 外 键 约束 或 是 可 延迟 的 唯一 性 约束 或 是 排他 性 约束 的 触发 器 )。 启用 或 者 禁用 
约束 触发 器 要 求 超级 用 户 权 限 ; 这 么 做 的 时 候 应 该 小 心 ， 因 为 如 果 触 发 器 不 执行 的 话 ， 约 束 
保证 的 数据 完整 性 也 就 没有 办 法 确保 了 。 触发 器 启动 原理 也 受 配置 变量 
session_replication_role 影 响 。 简单 启动 的 触发 器 将 会 在 复制 任务 为 "初始 "(默认 情况 ) 或 者 "本 
地 "时 启动 。 配置 为 ENABLE REPLICA 的 触发 器 将 会 仅 在 会 话 为 "replica" 模式 时 启动 ， 而 配置 
A ENABLE ALWAYS 的 触发 器 将 总 是 会 启动 ， 无 论 是 否 为 当前 复制 模式 。 


DISABLE / ENABLE [ REPLICA | ALWAYS ] RULE 


这 种 形式 配置 属于 表 的 重 写 规 则 制定 。 pes 对 系统 来 说 仍然 是 可 知 的 ， 但 在 坦 
询 重 写 期 间 是 不 被 应 用 的 。 语义 为 关闭 /启动 触发 器 。 这 个 配置 对 oN sELECT 规则 来 说 是 可 忽 
略 的 ， oe ae 即使 当前 会 话 处 于 一 RE rary 


CLUSTER ON 


这 种 形式 为 将 来 的 CLUSTER 操作 选择 默认 索引 。 KRGELFRABS A RCMB, 


SET WITHOUT CLUSTER 


这 种 形式 从 表 中 删除 最 近 一 次 用 到 的 CLUSTER 索引 定义 。 这 会 影响 将 来 不 声明 索引 的 盘 敌 化 
表 的 操作 。 
SET WITH OIDS 


这 种 形式 向 表 中 增加 一 个 oid 系统 字段 (参见 Section 5.4) o 如 果 表 中 已 存在 有 OID 字 段 ， 
则 操作 对 表 无 任何 影响 。 


注意 这 种 形式 与 ADD coLUMN oid oid 选项 并 不 相同 ， 后 者 对 给 表 增 加 一 个 普通 的 字段 ， 只 不 
过 它 的 名 称 恰 好 是 叫 oid ， 并 非 是 系统 字段 。 


SET WITHOUT OIDS 


这 种 形式 从 表 中 删除 oid 系统 字段 。 它 和 DROP coLuMN oid RESTRICT 完全 相同 ， 只 不 过 是 如 
果 表 上 已 经 没有 oid 字段 的 时 候 不 会 报错 。 


SET ( _storage_parameter_ = _value_ [,...]) 


这 种 形式 改变 表 的 一 个 或 者 更 多 存储 参数 。 参 阅 存 储 人 参数 获取 关于 可 用 参数 的 详细 信息 。 请 
注意 表 的 内 容 将 不 会 因为 此 命令 被 立刻 调整 ; 根据 此 参数 你 可 能 需要 重 写 此 表 来 得 到 希望 的 
效果 。 这 可 以 通过 VACUUM FULL、CLUSTER 或 者 ALTER TABLE 命令 中 的 选项 之 一 来 实现 。 


Note: A CREATE TABLE 人 允许 OIDS 在 WITH (**_storage_parameter_ ) 语 义 中 声明 ， 
但 ALTER TABLE 不 会 将 orms 作为 一 个 存储 参数 。 相反 地 ， 要 使 
FA SET WITH orps 和 SET wITHOUT oros 形式 来 更 改 OID 状 态 。 





RESET ( _storage_parameter_ [, ...] ) 


这 种 形式 重 置 表 的 一 个 或 多 个 存储 参数 为 缺 省 值 。 和 与 sET 选项 一 样 ， 根 据 参 数 的 不 同 可 能 需 
要 重 写 表 才能 获得 想 要 的 效果 。 


INHERIT parent_table 





这 种 形式 将 目标 表 添 加 为 指定 父 表 的 新 子 表 。 之 后 在 父 表 上 的 查询 将 包含 目标 表 中 的 记录 。 
要 被 添加 为 一 个 子 表 ， 目 标 表 必须 已 经 包含 所 有 与 父 表 相同 的 字段 ( 除 此 之 外 当然 也 可 以 包含 
一 些 其 它 字 段 )， 这 些 字段 的 数据 类 型 必须 匹配 ， 并 且 如 果 父 表 的 字段 有 NoT NULL 约束 的 话 子 
表 的 相应 字段 也 必须 有 NoT NULL 约束 。 


所 有 父 表 的 chEcK 约束 必须 同时 与 子 表 的 约束 匹配 。 不 过 一 些 标记 为 不 可 继承 类 的 约束 (类 
似 使 用 ALTER TABLE ... ADD CONSTRAINT ... NO INHERIT 创建 的 约束 ) 不 包括 在 内 ， MATK 
匹配 的 约束 也 不 能 标记 为 不 可 继承 。 目前 UNIQUE, PRIMARY KEY 和 FOREIGN KEY 约束 不 被 考 
虑 在 内 ， 但 是 将 来 可 能 会 有 所 改变 。 


NO INHERIT parent_table 





这 种 形式 从 指定 父 表 的 子 表 列表 中 删除 目标 表 。 这 样 ， 在 父 表 上 的 查询 将 不 再 目标 表 中 的 记 


OF _type_name_ 


这 种 形式 将 表 链 接 至 一 种 复合 类 型 ， 就 好 象 是 使 用 cREATE TABLE OF 选项 创建 表 一 样 。 表 的 字 
及 的 名 称 和 类 型 必须 精确 匹配 复合 类 型 中 的 定义 ， 不 过 oid 系统 字段 允许 不 一 样 。 表 不 能 是 
从 任何 其 他 表 继 承 的 。 这 些 限 制 确保 cREATE TABLE oF 选项 允许 一 个 相同 的 表 定 义 。 


NOT OF 
这 种 形式 将 一 个 与 某 类 型 进行 关联 的 表 进 行 关联 的 解除 。 


OWNER 


这 种 形式 改变 表 、 序 列 或 是 视图 的 所 有 者 为 一 个 指定 的 用 户 。 


SET TABLESPACE 


这 种 形式 更 改 表 的 表 空 间 为 一 个 指定 的 表 空 间 ， 并 将 与 这 个 表 相 关 的 数据 文件 移 至 新 的 表 空 
i], 表 上 如 果 有 索引 ， 一 般 不 会 移动 。 不 过 它们 也 可 以 通过 使 用 set TABLESPACE 命令 单独 移 
动 ， 参 见 CREATE TABLESPACE。 


RENAME 

RENAME 形式 改变 一 个 表 ( 或 者 索引 、 序 列 、 视 图 ) 的 名 称 ， 表 中 单个 字段 的 名 称 ， 或 是 表 中 约 
束 的 名 称 。 它们 对 存储 的 数据 没有 影响 。 

SET SCHEMA 


这 种 形式 把 表 移 动 到 另外 一 个 模式 。 相 关 的 索引 、 约 束 、 序 列 都 跟着 移动 。 


除了 RENAME 和 SET SCHEMA 之 外 所 有 动作 都 可 以 组 合 在 一 个 多 次 修改 列表 中 同时 使 用 。 比 
如 ， 可 以 在 一 个 命令 里 增加 几 个 字段 和 /或 修改 几 个 字段 的 类 型 。 对 于 大 表 ， 这 么 做 特别 有 
用 ， 因 为 只 需要 对 该 表 做 一 次 义理 。 


要 使 用 ALTER TABLE ， 你 必须 是 该 表 的 所 有 者 。 要 修改 一 个 表 的 模式 ， 你 还 必须 在 新 模式 上 
拥有 create 权限 。 要 把 该 表 添 加 为 一 个 父 表 的 新 子 表 ， 你 必须 同时 是 父 表 的 所 有 者 。 要 修 
改 所 有 者 ， 你 还 必须 是 新 的 所 有 角色 的 直接 或 间接 成 员 ， 并 且 该 成 员 必 须 在 此 表 的 模式 上 

有 create 权限 。 (这 些 限制 强制 了 修改 该 所 有 者 不 会 做 任何 通过 删除 和 重建 表 不 能 做 的 事 
情 。 不 过 ， 超 级 用 户 可 以 以 任何 方式 修改 任意 表 的 所 有 权 。) 增加 一 个 字段 或 是 改变 字段 的 
类 型 或 是 使 用 oF 选项 ， 你 也 必须 对 那个 数据 类 型 有 usa 权限 。 


参数 


_name_ 


要 修改 的 已 有 表 的 名 称 〈 可 以 有 模式 修饰 ) 。 若 声明 了 ony 选项 ， 则 只 有 那个 表 被 更 改 。 若 
未 声明 oNLY ， 该 表 及 其 所 有 子 表 都 将 会 被 更 改 。 另外 ， 可 以 在 表 名 称 后 面 精确 地 增加 * 选 
项 来 指定 包括 子 表 。 


_column_name_ 


现存 或 新 的 字段 名 称 。 


new_column_name 





现存 字段 的 新 名 称 。 
表 的 新 名 称 。 
_type_ 


新 字段 的 类 型 ， 或 者 现存 字段 的 新 类 型 。 


_table_constraint_ 

新 的 表 约 束 。 

_constraint_name_ 

要 删除 的 现 有 约束 的 名 字 。 

CASCADE 

级 联 删除 依赖 于 被 依赖 字段 或 者 约束 的 对 象 (比如 引用 该 字段 的 视图 )。 

RESTRICT 

如 果 字 段 或 者 约束 还 有 任何 依赖 的 对 象 ， 则 拒绝 删除 该 字段 。 这 是 缺 省 行为 。。 
_trigger_name_ 

要 启用 或 者 禁用 的 单个 触发 器 的 名 字 。 

ALL 

启用 或 者 禁用 所 有 属于 该 表 的 触发 器 。 (如 果 任 何 触 发 器 属于 内 部 会 产生 约束 的 触发 器 ， 这 
要 求 超级 用 户 权限 ， 例 如 那些 用 于 执行 外 键 约束 或 者 可 推迟 的 独特 性 和 排除 约束 。 ) 


USER 


启用 或 者 茶 用 所 有 属于 表 的 触发 器 ， 除 了 任何 属于 内 部 会 产生 约束 的 触发 器 ， 例 如 那些 用 于 
执行 外 键 约束 或 者 可 推迟 的 独特 性 和 排除 约束 。) 


_index_name_ 


要 标记 为 盘 敌 化 的 表 上 面 的 素 引 名 字 。 


_storage_parameter_ 


表 的 存储 参数 的 名 字 。 


_value_ 


表 的 存储 参数 的 新 值 ， 根 据 参数 的 不 同 ， 可 能 是 一 个 数字 或 单词 。 


parent_table 





将 要 与 该 表 建 立 /取消 关联 的 父 表 。 


_new_owner_ 


该 表 的 新 所 有 者 的 用 户 名 。 
_new_tablespace_ 

这 个 表 将 要 移动 到 的 表 空 间 名 字 。 
_new_schema_ 


表 将 移动 到 的 新 模式 的 名 字 。 


<< =r 
) 王 局 


COLUMN 关键 字 是 多 余 的 ， 可 以 省 略 。。 


如 果 用 App coLuMN 增加 一 个 字段 ， 那 么 所 有 表 中 现 有 行 都 初始 化 为 该 字段 的 缺 省 值 (如 果 没 有 
声明 DEFAULT 子 句 ， 那 么 就 是 NULL)。 


添加 一 个 非 空缺 省 值 列 或 者 改变 一 个 原 有 列 的 类 型 需要 重 写 整 个 表 和 索引 。 不 过 也 有 例外 ， 
如 果 使 用 usine 选项 不 改变 字段 的 内 容 并 且 字 段 的 新 旧 类 型 是 二 进 制 兼容 的 ， 也 可 以 不 重 写 
表 。 添加 或 者 删除 一 个 系统 oid 列 同样 需要 重 写 整 个 表 。 大 表 及 索引 的 重 写 可 能 需要 非常 长 
的 时 间 ， 并 且 也 临时 需要 两 倍 的 磁 总 空间 。 


增加 一 个 creck 或 NoT NULL 约束 将 会 扫描 该 表 以 保证 现 有 的 行 符合 约束 要 求 。 


提供 在 一 个 ALTER TABLE 里 面 声明 多 个 修改 的 主要 原因 是 原先 需要 的 对 表 的 多 次 扫描 和 重 宇 可 
以 组 合成 一 个 操作 。 


DROP COLUMN 命令 并 不 是 物理 上 把 字段 删除 ， 而 只 是 简单 地 把 它 标记 为 对 SQL 操作 不 可 见 。 
随后 对 该 表 的 插入 和 更 新 将 在 该 字段 存储 一 个 NULL 。 因此 ， 删 除 一 个 字段 是 很 快 的 ， 但 是 
它 不 会 立即 释放 表 在 磁盘 上 的 空间 ， 因 为 被 删除 了 的 字段 占据 的 空间 还 没有 回收 。 这 些 空间 
将 随 着 现 有 的 行 的 更 新 而 得 到 回收 。 (在 删除 系统 oid 列 时 ， 方 式 有 点 不 同 ， 这 个 操作 是 直接 
执行 了 一 次 表 的 重 宇 。) 


要 强制 立刻 执行 一 次 表 的 重 写 ， 可 以 使 用 VACUUM FULL、CLUSTER 或 是 ALTER TABLE 
命中 的 一 些 形式 。 这 些 命令 从 可 见 的 语义 上 不 会 对 表 产 生 更 新 ， 但 会 清除 不 再 有 用 的 数据。 


使 用 sET DATA TYPE 命令 中 的 usine 选项 实际 上 可 以 指定 任何 表达 式 涉及 到 记录 旧 值 ; 也 就 
是 说 ， 它 可 以 引用 除了 正在 被 转换 的 字段 之 外 其 它 的 字段 。 这 样 ， 就 可 以 用 set pata TYPE E 
语法 做 非常 普 静 性 的 转换 。 因为 这 个 灵活 性 ， usiN6 表达 式 并 没有 应 用 于 该 字段 的 缺 省 值 
(如 果 有 的 话 ) ; 结果 可 能 不 是 缺 省 表达 式 要 求 的 常量 表达 式 。 这 就 意味 着 如 果 从 旧 类 型 到 新 
类 型 没有 隐 含 或 者 赋值 转换 的 话 ， 那 么 即使 存在 usine 选项 ， SET DATA TYPE 也 可 能 无 法 把 
缺 省 值 转换 成 新 的 类 型 。 在 这 种 情况 下 ， 应 该 用 prop DEFAULT 先 删 除 缺 省 值 ， 执 行 

ALTER TYPE ， 然 后 使 用 set pEFAULT 增加 一 个 合适 的 新 缺 省 值 。 类 似 的 考虑 也 适用 于 涉及 该 
字段 的 索引 和 约束 。 


如 果 一 个 表 有 子 表 ， 那 么 如 果 不 在 子 表 上 做 同样 的 修改 的 话 ， 就 不 允许 在 父 表 上 增加 、 重 命 
名 、 修 改 一 个 字段 的 类 型 。 也 就 是 说 ， ALTER TABLE ONLY 将 被 拒绝 执行 。 这 样 就 保证 了 子 表 
总 是 有 和 父 表 匹配 的 字段 。 


一 个 递归 prop coLuMN 操作 将 只 有 在 子 表 并 不 从 任何 其 它 父 表 中 继承 该 字段 并 且 从 来 没有 独 
立定 义 该 字段 的 时 候 才能 删除 一 个 子 表 的 字段 。 一 个 非 递 及 的 prop coLuMN (也 就 是 

ALTER TABLE ONLY ... DROP COLUMN ) 从 来 不 会 删除 任何 子 表 字段 ， 而 是 把 他 们 标记 为 独立 定 
义 的 (而 不 是 继承 的 )。 o 


TRIGGER 、 CLUSTER, OWNER 和 TABLESPACE 的 操作 绝 不 会 递归 影响 到 子 表 ; 也 就 是 说 ， ee 
的 行为 就 像 总 是 声明 了 ony 一 样 。 只 有 没有 标记 为 NO INHERIT AY check 约束 才能 添加 一 
递归 性 的 约束 。 


不 允许 更 改 系统 表 结 构 的 任何 部 分 。 


请 参考 CREATE TABLE 部 分 获取 更 多 有 效 参数 的 描述 。Chapter 5 章节 里 有 更 多 有 关 继 承 的 信 
=| 
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例子 
向 表 中 增加 一 个 varchar 字段 : 


ALTER TABLE distributors ADD COLUMN address varchar(30); 


从 表 中 删除 一 个 字段 : 


ALTER TABLE distributors DROP COLUMN address RESTRICT; 


在 一 个 操作 中 修改 两 个 现 有 字段 的 类 型 : 


ALTER TABLE distributors 
ALTER COLUMN address TYPE varchar(80), 
ALTER COLUMN name TYPE varchar(100); 


使 用 一 个 usine 选项 ， 把 一 个 包含 UNIX i RE integer 字段 转化 成 


timestamp with time zone 字段 


ALTER TABLE foo 
ALTER COLUMN foo_timestamp SET DATA TYPE timestamp with time zone 
USING 
timestamp with time zone 'epoch' + foo_timestamp * interval '1 second'; 


同样 地 ， 当 字段 有 一 个 不 会 自动 转换 成 新 类 型 的 缺 省 值 表 达 式 时 : 


ALTER TABLE foo 
ALTER COLUMN foo_timestamp DROP DEFAULT, 
ALTER COLUMN foo_timestamp TYPE timestamp with time zone 
USING 
timestamp with time zone ‘epoch' + foo_timestamp * interval '1 second', 
ALTER COLUMN foo_timestamp SET DEFAULT now(); 


对 现 有 字段 改名 : 


ALTER TABLE distributors RENAME COLUMN address TO city; 


更 改 现 有 表 的 名 字 : 


ALTER TABLE distributors RENAME TO suppliers; 


更 改 现 有 约束 的 名 字 : 


ALTER TABLE distributors RENAME CONSTRAINT zipchk TO zip_check; 


给 一 个 字段 增加 一 个 非 空 约束 : 


ALTER TABLE distributors ALTER COLUMN street SET NOT NULL; 


从 一 个 字段 里 删除 一 个 非 空 约束 : 


ALTER TABLE distributors ALTER COLUMN street DROP NOT NULL; 


给 一 个 表 增 加 一 个 检查 约束 : 


ALTER TABLE distributors ADD CONSTRAINT zipchk CHECK (char_length( zipcode) 


5); 


给 一 个 表 且 不 包含 其 子 表 增加 一 个 检查 约束 : 


ALTER TABLE distributors ADD CONSTRAINT zipchk CHECK (char_length(zipcode) = 5) NO INHERI 





(这 个 检查 约束 也 不 会 被 以 后 新 增 的 子 表 继 承 。) 
删除 一 个 表 及 其 所 有 子 表 的 检查 约束 : 


ALTER TABLE distributors DROP CONSTRAINT zipchk; 


MRF BR-ME SAR 〈 不 包含 子 表 ) 

ALTER TABLE ONLY distributors DROP CONSTRAINT zipchk; 
《这 个 检查 约束 对 所 有 子 表 仍 保留 。) 

向 表 中 增加 一 个 外 键 约束 : 


ALTER TABLE distributors ADD CONSTRAINT distfk FOREIGN KEY (address) REFERENCES addresses 











给 表 增 加 一 个 (多 字段 ) 唯 一 约束 : 


ALTER TABLE distributors ADD CONSTRAINT dist_id_zipcode_key UNIQUE (dist_id, zipcode); 


给 一 个 表 增 加 一 个 自动 命名 的 主键 约束 ， 要 注意 的 是 一 个 表 只 能 有 一 个 主键 : 


ALTER TABLE distributors ADD PRIMARY KEY (dist_id); 


把 表 移 动 到 另外 一 个 表 空 间 : 


ALTER TABLE distributors SET TABLESPACE fasttablespace; 


把 表 移动 到 另外 一 个 模式 : 


ALTER TABLE myschema.distributors SET SCHEMA yourschema; 


重新 创建 一 个 主键 约束 ， 并 且 在 主键 索引 在 创建 时 不 影响 记录 的 更 新 : 


CREATE UNIQUE INDEX CONCURRENTLY dist_id_temp_idx ON distributors (dist_id); 
ALTER TABLE distributors DROP CONSTRAINT distributors_pkey, 
ADD CONSTRAINT distributors_pkey PRIMARY KEY USING INDEX dist_id_temp_idx; 


RANE 


ADD (不 包含 USING INDEX ), DROP, SET DEFAULT 和 SET DATA TYPE (不 包含 usine ERS 
SQL 标准 兼容 。 其 它 形式 是 PostgreSQL 对 SQL 标准 的 扩展 。 还 有 ， 在 一 个 ALTER TABLE 命 
邻里 声明 多 个 操作 也 是 扩展 。 

ALTER TABLE DROP COLUMN 可 以 用 于 删除 表 中 的 唯一 的 一 个 字段 ， 留 下 一 个 需 字 段 的 表 。 这 是 
对 SQL 的 扩展 ， 它 不 允许 需 字 段 表 。 


参见 


一 


CREATE TABLE 


ALTER TABLESPACE 


Name 


ALTER TABLESPACE -- 修改 一 个 表 空 间 的 定义 


Synopsis 


ALTER TABLESPACE _name_ RENAME TO _new_name_ 

ALTER TABLESPACE _name_ OWNER TO _new_owner_ 

ALTER TABLESPACE _name_ SET ( _tablespace_option_ = _value_[, ... ] ) 
ALTER TABLESPACE _name_ RESET ( _tablespace_option_[, ... ] ) 





摘 述 
ALTER TABLESPACE 改变 一 个 表 空 间 的 定义 。 


要 使 用 ALTER TABLESPACE ， 你 必须 是 该 表 空 间 的 所 有 者 。 要 修改 所 有 者 ， 你 还 必须 是 新 的 所 
有 角色 的 直接 或 间接 成 员 。 不 过 ， 超 级 用 户 自动 获得 这 些 权限 。 


参数 


_name_ 


一 个 现 有 的 表 空 间 的 名 称 。 


_new_name_ 


表 空 间 的 新 名 字 。 新 名 字 不 能 以 p 开头 ， 因 为 这 样 的 名 字 保留 给 系统 表 空 间 使 用 了 。 


_new_owner_ 


表 空 间 的 新 所 有 者 。 


_tablespace_option_ 


可 以 设置 或 者 重 置 的 表 空 间 参 数 。 目 前 ， 可 以 设置 的 参数 

是 seq_page_cost 和 random page_cost 。 为 一 个 表 空 间 设置 任 一 个 值 ， 将 会 覆盖 在 那个 表 空 
间 中 从 表 中 阅读 页 的 成 本 优化 器 的 一 般 估计 值 ， 正 如 同 通 过 同名 的 配置 参数 建立 的 。 (S$ 
阅 Seq_page_cost，random_page_cost) > 如 果 表 空间 所 在 的 磁盘 是 一 个 更 快 或 更 慢 的 其 它 
io 子 系统 ， 那 么 这 些 参数 是 有 用 的 。 


例子 
把 表 空 间 index_space 重 命 名 为 fast_raid 


ALTER TABLESPACE index_space RENAME TO fast_raid; 


改变 表 空 间 index_space 的 所 有 者 : 


ALTER TABLESPACE index_space OWNER TO mary; 


RAIE 


SQL 标准 里 没有 ALTER TABLESPACE 语句 。 


参见 


D 


CREATE TABLESPACE, DROP TABLESPACE 


ALTER TEXT SEARCH CONFIGURATION 


Name 


ALTER TEXT SEARCH CONFIGURATION -- 更 改 文本 搜索 配置 的 定义 


Synopsis 


ALTER TEXT SEARCH CONFIGURATION _name_ 


ADD MAPPING FOR _token_type_ [, ... ] WITH _dictionary_name_ [, ... ] 
ALTER TEXT SEARCH CONFIGURATION _name_ 
ALTER MAPPING FOR _token_type_ [, ... ] WITH _dictionary_name_ [, ... ] 


ALTER TEXT SEARCH CONFIGURATION _name_ 
ALTER MAPPING REPLACE _old_dictionary_ WITH _new_dictionary_ 
ALTER TEXT SEARCH CONFIGURATION _name_ 


ALTER MAPPING FOR _token_type_ [, ... ] REPLACE _old_dictionary_ WITH _new_dictionary_ 
ALTER TEXT SEARCH CONFIGURATION _name_ 
DROP MAPPING [ IF EXISTS ] FOR _token_type_[, ... ] 


ALTER TEXT SEARCH CONFIGURATION _name_ RENAME TO _new_name_ 
ALTER TEXT SEARCH CONFIGURATION _name_ OWNER TO _new_owner_ 
ALTER TEXT SEARCH CONFIGURATION _name_ SET SCHEMA _new_schema_ 


摘 述 
ALTER TEXT SEARCH CONFIGURATION 更 改 文本 搜索 配置 的 定义 。 您 可 以 将 映射 从 字 串 类 型 调整 
字典 ， 或 者 改变 配置 的 名 称 或 者 所 有 者 。 


要 使 用 ALTER TEXT SEARCH CONFIGURATION ， 您 必须 是 配置 的 所 有 者 。 


参数 


_name_ 


已 有 文本 搜索 配置 的 名 称 〈 可 以 有 模式 修饰 ) 。 


_token_type_ 


与 配置 的 语法 解析 器 关联 的 字 串 类 型 的 名 称 。 


_dictionary_name_ 


对 指定 的 字 串 类 型 将 要 被 搜索 使 用 的 文本 搜索 字典 的 名 称 。 如 果 有 多 个 字典 ， 则 它们 会 按 指 
定 的 顺序 搜索 。 


_old_dictionary_ 


映 身 中 拟 被 蔡 换 的 文本 搜索 字典 名 称 。 


_new_dictionary_ 


替换 _old_dictionary_ 的 文本 搜索 字典 的 名 称 。 


_new_name 


文本 搜索 配置 的 新 名 称 。 


_new_owner_ 


文本 搜索 配置 的 新 所 有 者 。 
_new_schema_ 
文本 搜索 配置 的 新 模式 名 。 


ADD MAPPING FOR 选项 安装 一 个 被 特定 字 串 类 型 搜索 用 的 字典 列表 ; 如 果 已 经 有 任何 一 个 字 串 
类 型 的 映射 ， 系 统 和 将 会 报错 。 ALTER MAPPING FoR 选项 也 有 相同 功能 ， 但 是 它 会 首先 清除 已 有 
的 字 串 类 型 的 映射 。 ALTER MAPPING REPLACE 选项 使 用 _new_dictionary_ & 

换 _old_dictionary ， 只 要 后 者 一 出 现 便 会 被 替换 。 这 些 仅仅 在 FoR 选项 出 现时 对 特定 字 串 
类 型 来 操作 ， 或 者 在 不 出 现时 对 所 有 配置 映射 来 操作 。 DROP MAPPING 选项 会 删除 所 有 特定 字 
串 类 型 相关 的 字典 ， 导 致 那些 类 型 的 字 串 被 文本 搜索 配置 忽略 。 除非 是 使 用 了 IF exists 选 

项 ， 否 则 如 果 对 指定 的 字 串 类 型 无 映射 ， 则 是 错误 的 。 


例子 


以 下 示例 执行 后 ， 在 my_config 这 个 配置 方案 内 使 用 之 内 使 用 english 字典 时 ， 会 
用 swedish 字典 代替 english 字典 。 


ALTER TEXT SEARCH CONFIGURATION my_config 
ALTER MAPPING REPLACE english WITH swedish; 


FANE 


在 SQL 标准 中 没有 ALTER TEXT SEARCH CONFIGURATION 语句 。 


参见 


J 


CREATE TEXT SEARCH CONFIGURATION, DROP TEXT SEARCH CONFIGURATION 


ALTER TEXT SEARCH DICTIONARY 


Name 
ALTER TEXT SEARCH DICTIONARY -- 更 改 文本 搜索 字典 的 定义 。 
Synopsis 


ALTER TEXT SEARCH DICTIONARY _name_ ( 
option [ = _value_ ] [, ... ] 





ALTER TEXT SEARCH DICTIONARY _name_ RENAME TO _new_name_ 
ALTER TEXT SEARCH DICTIONARY _name_ OWNER TO _new_owner_ 
ALTER TEXT SEARCH DICTIONARY _name_ SET SCHEMA _new_schema_ 


摘 述 
ALTER TEXT SEARCH DICTIONARY 更 改 文本 搜索 字典 的 定义 。 你 可 以 修改 字典 的 指定 模板 的 配置 
参数 ， 也 可 以 改变 字典 的 名 称 或 者 所 有 者 。 


要 使 用 ALTER TEXT SEARCH DICTIONARY ， 您 必须 是 字典 的 所 有 者 。 


参数 


已 有 文本 搜索 字典 的 名 称 (可 以 有 模式 修饰 )。 
_option_ 

为 该 字典 设置 的 指定 模板 选项 的 名 称 。 
_value_ 


用 于 指定 模板 选项 的 新 值 。 如 果 等 号 和 数值 省 略 ， 则 字典 中 该 选项 以 前 设置 的 数值 也 会 被 清 
除 ， 此 时 这 些 参 数 会 变 为 缺 省 值 。 


_new_name 


文本 搜索 字典 的 新 名 称 。 


_new_owner_ 


文本 搜索 字典 的 新 所 有 者 。 


_new_schema_ 


文本 搜索 字典 的 新 模式 。 
指定 模板 的 选项 可 以 以 任何 顺序 显示 。 


例子 
以 下 示例 命令 为 SnowbalHbased 字 典 改变 省 略 词 列表 。 其 他 参数 保持 不 变 。 


ALTER TEXT SEARCH DICTIONARY my_dict ( StopWords = newrussian ); 


以 下 示例 命令 改变 语言 选项 为 荷兰 ， 并 删除 完整 的 省 略 词 选 项 。 


ALTER TEXT SEARCH DICTIONARY my_dict ( language = dutch, StopWords ); 


接 下 来 的 示例 命令 "updates" 字 典 的 定义 ， 实 际 上 没有 做 任何 改变 。 


ALTER TEXT SEARCH DICTIONARY my_dict ( dummy ); 


(这 可 以 运行 的 原因 是 ， 选 项 删除 代码 不 会 报错 说 是 不 存在 这 样 的 选项 参数 。) 在 为 字典 修 
改 配置 文件 时 这 个 技巧 是 很 有 效 的 : ALTER 将 会 强制 现 有 的 数据 库 会 话 来 重读 配置 文件 ， 否 
则 如 果 预 先 已 经 读 过 ， 将 不 会 执行 此 操作 。 


兼容 性 


在 SQL 标准 中 没有 ALTER TEXT SEARCH DICTIONARY 语句 。 


参见 


一 


CREATE TEXT SEARCH DICTIONARY, DROP TEXT SEARCH DICTIONARY 


ALTER TEXT SEARCH PARSER 


Name 


ALTER TEXT SEARCH PARSER -- 更 改 一 个 文本 搜索 解析 器 的 定义 


Synopsis 


ALTER TEXT SEARCH PARSER _name_ RENAME TO _new_name_ 
ALTER TEXT SEARCH PARSER _name_ SET SCHEMA _new_schema_ 


摘 述 
ALTER TEXT SEARCH PARSER 更 改 一 个 文本 搜索 解析 器 的 定义 。 目 前 ， 唯 一 支持 的 功能 就 是 改变 
解析 器 的 名 称 。 


要 使 用 ALTER TEXT SEARCH PARSER ， 您 必须 是 超级 用 户 。 


参数 


_name_ 


已 有 文本 搜索 解析 器 的 名 称 (可 有 模式 修饰 ) 。 


_new_name 


文本 搜索 解析 器 的 新 名 称 。 


_new_schema_ 


文本 搜索 解析 器 的 新 模式 名 。 


兼容 性 


在 SQL 标准 中 没有 ALTER TEXT SEARCH PARSER 语句 。 


参见 


ZZ 


CREATE TEXT SEARCH PARSER, DROP TEXT SEARCH PARSER 


ALTER TEXT SEARCH TEMPLATE 


Name 


ALTER TEXT SEARCH TEMPLATE -- 更 改 文本 搜索 模板 的 定义 


Synopsis 


ALTER TEXT SEARCH TEMPLATE _name_ RENAME TO _new_name_ 
ALTER TEXT SEARCH TEMPLATE _name_ SET SCHEMA _new_schema_ 


摘 述 
ALTER TEXT SEARCH TEMPLATE 更 改 文本 搜索 模板 的 定义 。 目 前 ， 公 支持 修改 模板 的 名 称 。 


要 使 用 ALTER TEXT SEARCH TEMPLATE ， 您 必须 是 超级 用 户 。 


参数 


_name_ 


已 有 文本 搜索 模板 的 名 称 (可 有 模式 修饰 ) 。 


_new_name 


文本 搜索 模板 的 新 名 称 。 


_new_schema_ 


文本 搜索 模板 的 新 模式 名 。 


兼容 性 


在 SQL 标准 中 没有 ALTER TEXT SEARCH TEMPLATE 语句 。 


参见 


ZZ 


CREATE TEXT SEARCH TEMPLATE, DROP TEXT SEARCH TEMPLATE 


ALTER TRIGGER 


Name 


ALTER TRIGGER -- 修改 一 个 触发 器 的 定义 


Synopsis 


ALTER TRIGGER _name_ ON _table_name_ RENAME TO _new_name_ 





摘 述 

ALTER TRIGGER 改变 一 个 现 有 触发 器 的 定义 。 RENAME 选项 修改 触发 器 的 名 称 ， 而 不 用 改变 触 
发 器 的 定义 。 

你 必须 是 该 触发 器 作用 的 表 的 所 有 者 才能 改变 其 属性 。 


参数 


_name_ 


需要 修改 的 现 有 触发 器 的 名 称 。 


_table_name_ 


该 触发 器 作用 的 表 的 名 字 。 


现 有 触发 器 的 新 名 字 。 


MS = 


) 王 局 


临时 打开 或 者 关闭 触发 器 的 能 力 是 由 ALTER TABLE 而 不 是 ALTER TRIGGER 提供 的 ， 
A ALTER TRIGGER 没有 一 次 打开 或 者 关闭 所 有 表 的 触发 器 的 选项 。 


例子 


重新 命名 一 个 现 有 触发 器 : 


ALTER TRIGGER emp_stamp ON emp RENAME TO emp_track_chgs; 


RANE 


ALTER TRIGGER 是 PostgreSQL 对 SQL 标准 的 扩展 。 


参见 


D 


ALTER TABLE 


ALTER TYPE 


Name 


ALTER TYPE -- 修改 一 个 类 型 的 定义 。 


Synopsis 


ALTER 
ALTER 
ALTER 
ALTER 
ALTER 
ALTER 


TYPE 
TYPE 
TYPE 
TYPE 
TYPE 
TYPE 


name actions one 
_name_ OWNER TO _new_owner_ 
_name_ RENAME ATTRIBUTE _attribute_name_ TO _new_attribute_name_ [ CASCADE | R 
_name_ RENAME TO _new_name_ 
_name_ SET SCHEMA _new_schema_ 
_name_ ADD VALUE [ IF NOT EXISTS ] _new_enum_value_ [ { BEFORE | AFTER } _exis 











` action “可 以 是 下 列 选项 之 一 : 


ADD ATTRIBUTE _attribute_name data_type_ [ COLLATE _collation_ ] [ CASCADE | RESTRI 





DROP ATTRIBUTE [ IF EXISTS ] _attribute_name_ [ CASCADE | RESTRICT | 
ALTER ATTRIBUTE _attribute_name_ [ SET DATA ] TYPE _data_type_ [ COLLATE _collation_ 





ALTER TYPE 改变 一 个 现 有 类 型 的 定义 。 有 以 下 几 种 形式 : 


ADD ATTRIBUTE 


这 种 形式 给 复合 类 型 增加 新 的 属性 ， 与 CREATE TYPE 命 邻 语法 相同 。 


DROP ATTRIBUTE [ IF EXISTS ] 


这 种 形式 从 复合 类 型 删除 一 个 属性 。 如 果 指 定 了 if exists 选项 ， 并 且 属 性 不 存在 时 ， 不 会 
有 错误 产生 。 在 这 种 情况 下 系统 仅 会 有 一 个 提示 信息 。 


SET DATA TYPE 


这 种 形式 改变 一 种 复合 类 型 中 某 个 属性 的 类 型 。 


OWNER 


这 种 形式 改变 类 型 的 所 有 者 。 


RENAME 


这 种 形式 改变 类 型 的 名 称 或 是 一 个 复合 类 型 中 的 一 个 属性 的 名 称 。 


SET SCHEMA 


这 种 形式 将 类 型 移 至 一 个 新 的 模式 中 。 


ADD VALUE [ IF NOT EXISTS ] [ BEFORE | AFTER ] 


这 种 形式 给 枚 举 类 型 增加 一 个 新 值 。 新 值 在 枚 举 类 型 中 的 位 置 可 通过 对 一 个 已 有 数值 使 
用 BEFORE 或 AFTER 选项 来 指定 。 否 则 ， 新 值 会 加 在 值 列 表 的 最 后 面 。 


如 果 使 用 了 IF not exists 选项 ， 即 使 枚 举 中 已 含有 新 值 也 不 会 报错 ， 仅 有 提示 信息 。 相 反 ， 
新 增 一 个 枚 举 中 已 有 的 新 值 会 产生 错误 提示 。 


CASCADE 
自动 级 联 更 新 需 更 新 类 型 以 及 相关 联 的 记录 和 继承 它们 的 子 表 。 

RESTRICT 

如 果 需 联动 更 新 类 型 是 已 更 新 类 型 的 关联 记录 ， 则 拒绝 更 新 。 这 是 缺 省 选项 。 

ADD ATTRIBUTE 、 DROP ATTRIBUTE 和 ALTER ATTRIBUTE 选项 可 以 组 合成 一 个 列表 同时 义理 。 例 
如 ， 在 一 条 命令 中 同时 增加 几 个 属性 或 是 更 改 几 个 属性 的 类 型 是 可 以 实现 的 。 


要 使 用 ALTER TYPE ， 你 必须 是 该 类 型 的 所 有 者 。 要 修改 一 个 类 型 的 模式 ， 你 还 必须 在 新 模式 
上 拥有 create 权限 。 要 修改 所 有 者 ， 你 还 必须 是 新 的 所 有 角色 的 直接 或 间接 成 员 ， FAR 

成 员 必须 在 此 类 型 的 模式 上 有 create 权限 。 (这 些 限制 强制 了 修改 该 所 有 者 不 会 做 任何 通过 
删除 和 重建 类 型 不 能 做 的 事情 。 不 过 ， 超 级 用 户 可 以 以 任何 方式 修改 任意 类 型 的 所 有 权 。 ) 

要 增加 一 个 属性 或 是 修改 一 个 属性 的 类 型 ， 你 也 必须 有 该 类 型 的 usas 权限 。 


参数 


一 个 需要 修改 的 现 有 的 类 型 的 名 字 (可 以 有 模式 修饰 ) 。 
该 类 型 的 新 名 称 。 


新 所 有 者 的 用 户 名 。 


_new_schema_ 
该 类 型 的 新 模式 。 
_attribute_name_ 


拟 增加 、 更 改 或 删除 的 属性 的 名 称 。 


_new_attribute_name_ 


拟 改 名 的 属性 的 新 名 称 。 


_data_type_ 


拟 新 增 属 性 的 数据 类 型 ， 或 是 拟 更 改 的 属性 的 新 类 型 名 。 


new_enum_value 





拟 加 入 枚 举 类 型 值 列 表 中 的 新 值 。 和 所 有 枚 举 参数 一 样 ， 它 必须 使 用 引号 引起 来 。 


_existing_enum_value_ 


用 于 设 定 将 要 新 增 的 枚 举 值 在 枚 举 中 前 后 位 置 的 已 存在 的 枚 举 参 考 值 。 和 所 有 枚 举 参 数 一 
样 ， 它 必须 使 用 引号 引起 来 。 


<> ET 
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ALTER TYPE ... ADD VALUE (这 种 形式 给 枚 举 增 加 一 个 新 值 ) 命 使 是 不 能 在 一 个 事务 处 理 块 内 
部 执行 的 。 


与 处 理 枚 举 原 有 的 列表 值 相 比 ， 新 增 一 个 枚 举 值 有 时 有 点 慢 ， 这 一 般 出 现在 新 增 的 枚 举 值 使 
用 了 BEFORE 或 AFTER 选项 来 指定 新 值 的 位 置 ， 而 不 是 使 用 缺 省 的 选项 放 在 列表 最 后 。 不 过 
有 时 使 用 缺 省 放 在 最 后 也 会 慢 (这 在 该 枚 举 创建 后 其 OID 计 数 出 现 了 "复位 "情况 ) 。 当然 ， 这 
种 性 能 上 的 损失 是 很 小 的 。 如 果 用 户 介意 的 话 ， 可 以 通过 删除 这 个 枚 举 然 后 重新 创建 ， 或 是 
导出 数据 库 再 导入 即 可 恢复 正常 性 能 。 


例子 

重 命名 数据 类 型 : 
ALTER TYPE electronic_mail RENAME TO email; 

要 改变 一 个 用 户 定义 类 型 email 的 所 有 者 为 joe : 
ALTER TYPE email OWNER TO joe; 

把 用 户 定义 类 型 email 的 模式 改变 为 customers : 
ALTER TYPE email SET SCHEMA customers; 

给 一 个 数据 类 型 增加 一 个 新 的 属性 : 


ALTER TYPE compfoo ADD ATTRIBUTE f3 int; 


给 一 个 枚 举 类 型 增加 一 个 指定 位 置 的 新 值 : 


ALTER TYPE colors ADD VALUE 'orange' AFTER 'red'; 


RANE 


增加 或 删除 属性 是 SQL 标准 ， 其 他 选项 都 是 PostgreSQL 的 扩展 。 


参见 


一 


CREATE TYPE, DROP TYPE 


ALTER USER 


Name 


ALTER USER -- 修改 一 个 数据 库 角 色 。 


Synopsis 


ALTER USER _name_ [ [ WITH ] _option_[... ] ] 
where ~_option_~ can be: 


SUPERUSER | NOSUPERUSER 
| CREATEDB | NOCREATEDB 
| CREATEROLE | NOCREATEROLE 
| CREATEUSER | NOCREATEUSER 
| INHERIT | NOINHERIT 
| LOGIN | NOLOGIN 
| REPLICATION | NOREPLICATION 
| CONNECTION LIMIT _connlimit_ 
| [ ENCRYPTED | UNENCRYPTED ] PASSWORD '_password_' 
| VALID UNTIL '_timestamp_' 


ALTER USER _name_ RENAME TO _new_name_ 


ALTER USER _name_ SET _configuration_parameter_ { TO | = } { _value_ | DEFAULT } 
ALTER USER _name_ SET _configuration_parameter_ FROM CURRENT 

ALTER USER _name_ RESET _configuration_parameter_ 

ALTER USER _name_ RESET ALL 


ALTER USER 现在 是 ALTER ROLE 命令 的 别名 〈 即 两 者 相同 ) 。 


兼容 性 


ALTER USER 是 PostgreSQL 的 扩展 ，SQL 标 准 中 还 没有 完成 用 户 定义 相关 的 语法 。 


一 


参见 


ALTER ROLE 


ALTER USER MAPPING 


Name 


ALTER USER MAPPING -- 更 改 用 户 映射 的 定义 


Synopsis 


ALTER USER MAPPING FOR { _user_name_ | USER | CURRENT_USER | PUBLIC } 
SERVER _server_name_ 
OPTIONS ( [ ADD | SET | DROP ] _option_ ['_value_'] [, ... ] ) 





摘 述 
ALTER USER MAPPING 更 改 用 户 映射 的 定义 。 


外 服务 器 的 所 有 者 可 以 为 任何 用 户 更 改 那个 服务 器 的 户 映射 。 而 且 ， 若 已 将 服务 器 
的 usace 权限 授予 该 用 户 ， 那 么 该 用 户 可 以 为 其 自身 的 用 户 名 修改 用 户 映射 。 


参数 


_user_name_ 


映射 的 名 称 。 cuRRENT_USER 和 user 匹配 当前 用 户 的 名 称 。 PuBLIc 用 于 匹配 系统 中 已 有 和 将 
来 创建 的 所 有 用 户 名 。 


用 户 映 射 的 服务 器 名 称 。 


OPTIONS ( [ ADD | SET | DROP ] option_ [' value_ ‘][, ...]) 





用 户 映射 更 改选 项 。 新 的 选项 覆盖 所 有 先前 声明 的 选项 。 App . SET 和 prop 声明 要 执行 的 
操作 。 若 未 明确 声明 操作 ， 则 假定 为 App 。 选项 名 称 必 须 是 独一无二 的 ; 选项 也 要 通过 服务 
器 的 外 部 数据 封装 器 的 验证 。 


例子 


为 用 户 映 射 bob ， 服 务 器 foo 更 改 密码 : 


ALTER USER MAPPING FOR bob SERVER foo OPTIONS (user 'bob', password 'public'); 


RANE 


ALTER USER MAPPING 命令 符合 ISO/IEC 9075-9(SQL/MED) 标 准 。 但 是 有 一 点 点 语法 上 的 问 
题 : 标准 省 略 了 关键 字 FoR. CREATE USER MAPPING 和 DROP USER MAPPING 命 倒 都 在 类 似 的 位 
置 使 用 关键 字 Fo ， 并 且 IBM DB2 (作为 其 他 主要 SQL/MED 标 准 的 实现 者 ) 也 

在 ALTER USER MAPPING 命令 中 使 用 这 个 关键 字 ，PostgreSQL 是 在 标准 一 致 性 和 交互 操作 性 中 
取 了 一 个 中 间 位 置 。 


参见 


D 


CREATE USER MAPPING, DROP USER MAPPING 


ALTER VIEW 


Name 


ALTER VIEW -- 更 改 视图 定义 


Synopsis 








ALTER VIEW [ IF EXISTS ] _name_ ALTER [ COLUMN ] _column_name_ SET DEFAULT _expression_ 
ALTER VIEW [ IF EXISTS ] _name_ ALTER [ COLUMN ] _column_name_ DROP DEFAULT 

ALTER VIEW [ IF EXISTS ] _name_ OWNER TO _new_owner_ 

ALTER VIEW [ IF EXISTS ] _name_ RENAME TO _new_name_ 

ALTER VIEW [ IF EXISTS ] _name_ SET SCHEMA _new_schema_ 

ALTER VIEW [ IF EXISTS ] _name_ SET ( _view_option_name_ [= _view_option_value_] [, ... ] 
ALTER VIEW [ IF EXISTS ] _name_ RESET ( _view_option_name_[, ... ] ) 





ALTER VIEW 更 改 视图 的 各 种 辅助 属性 。 (如 果 你 是 更 改 视图 的 查询 定义 ， 要 使 


用 CREATE OR REPLACE VIEW 。 ) 


你 必须 是 视图 的 所 有 者 才 可 以 使 用 ALTER view. 要 改变 视图 的 模式 ， 您 必须 要 有 新 模式 

BY create 权限 。 要 改变 视图 的 所 有 者 ， 您 必须 是 新 所 属 角色 的 直接 或 者 间接 的 成 员 ， 并 且 
此 角色 必须 有 视图 模式 的 create 权限 。 (这 些 限 制 强制 更 改 所 有 者 不 会 做 任何 您 通过 删除 
或 者 重建 视图 时 不 能 做 的 操作 。 但 是 ， 一 个 超级 用 户 不 管 怎样 都 可 以 更 改 任何 视图 的 所 属 关 
Ro ) 


参数 


_name_ 


一 个 已 有 视图 的 名 称 ( 可 以 有 模式 修饰 ) 。 


IF EXISTS 
使 用 这 个 选项 ， 如 果 视 图 不 存在 时 不 会 产生 错误 ， 仅 有 会 有 一 个 提示 信息 。 


SET / DROP DEFAULT 


这 种 形式 设置 或 删除 一 个 列 的 缺 省 值 。 当 insert 和 uor 命令 的 对 象 是 视图 时 ， 使 用 这 个 
选项 时 可 以 在 视图 相关 的 规则 和 触发 器 启动 前 ， 设 置 视 图 列 的 缺 省 值 。 视图 列 的 缺 省 值 也 会 
优先 于 视图 相关 联 表 的 列 缺 省 值 生效 。 


_new_owner_ 


视图 新 所 有 者 的 用 户 名 称 。 


_new_name 


视图 的 新 名 称 。 


_new_schema_ 


视图 的 新 模式 。 


view_option_name 





将 要 设置 或 复位 的 选项 名 称 。 


view_option_value 





视图 选项 的 新 值 。 
<a 
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由 于 历史 原因 ， ALTER TABLE 也 可 用 于 视图 ; 但 是 ALTER TABLE 命令 中 允许 与 视图 相关 的 选 
项 与 上 面 所 列 选项 相同 。 


例子 


重 命名 视图 foo 为 bar : 


ALTER VIEW foo RENAME TO bar; 


对 一 个 可 更 新 视图 增加 列 缺 省 值 : 


CREATE TABLE base_table (id int, ts timestamptz); 
CREATE VIEW a_view AS SELECT * FROM base_table; 
ALTER VIEW a_view ALTER COLUMN ts SET DEFAULT now(); 


INSERT INTO base_table(id) VALUES(1); -- ts 现在 是 空 什 
INSERT INTO a_view(id) VALUES(2); -- ts 现在 是 当前 时 间 


兼容 性 


ALTER VIEW 是 PostgreSQL 对 SQL 标准 的 扩展 。 


PostgreSQL 中 文 文档 9.3 


参见 


El 


CREATE VIEW, DROP VIEW 


ALTER VIEW 1593 


ANALYZE 


Name 


ANALYZE -- 收集 与 数据 库 有 关 的 统计 信息 


Synopsis 


ANALYZE [ VERBOSE ] [ _table_name_ [ ( _column_name_ [, ...] ) ] ] 





摘 述 
ANALYZE 收集 数据 库 中 表 内 容 的 统计 信息 ， 然 后 把 结果 保存 在 系统 表 pg_statistic 里 。 随 
后 ， 查 询 规划 器 就 可 以 使 用 这 些 统计 帮助 判断 查询 的 最 佳 规划 。 


使 用 本 命令 时 如 果 不 带 任何 参数 ， ANALYzE 将 检查 当前 数据 库 里 的 所 有 表 。 如 果 有 参 
数 ， ANALYZE 只 检查 那个 指定 的 表 。 你 还 可 以 指定 一 些 字段 的 名 字 ， 在 这 种 情况 下 ， 将 只 收 
集 那些 字段 的 统计 信息 。 


参数 


VERBOSE 
显示 处 理 过 程 的 信息 。 
_table_name_ 


要 分 析 的 指定 表 ( 可 以 用 模式 名 修饰 ) 的 名 字 。 缺 省 是 当前 数据 库 里 所 有 表 (不 包含 外 部 数据 
表 ) 。 


_column_name_ 
ZSOMNBETRMNAT. MEENA FE 
Outputs 


如 果 使 用 了 versose 选项 ， 那 么 ANALYZE 在 执行 过 程 中 会 显示 很 多 进度 信息 ， 表 明 当 前 正在 
处 理 的 是 哪个 表 。 同时 打印 有 关 该 表 的 很 多 其 它 信息 。 


Ss = 
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只 有 在 明确 指定 了 外 部 数据 表 时 ， 这 些 表 才 会 被 分 析 人 处理 。 也 不 是 所 有 的 外 部 数据 封装 器 都 
支持 ANALYZE 。 如 果 表 的 封装 器 不 支持 ANALYZE ， 在 执行 此 命令 时 会 显示 一 个 警告 信息 ， 系 
统 不 会 做 任何 义理 。 


在 默认 的 PostgreSQL 配 置 中 ，autovacuum 守 扩 进 程 (参见 Section 23.1.6) 负责 在 初次 加 载 
数据 时 自动 分 析 表 。 因为 它们 会 改变 整个 常规 操作 。 当 autovacuum 关 闭 时 ， 周 期 性 地 运 

{T ANALYZE ， 或 者 在 对 表 的 大 部 分 内 容 做 了 更 改 之 后 马上 运行 它 是 个 好 习惯 。 准确 的 统计 信 
息 将 帮助 规划 器 选择 最 合适 的 查询 规划 ， 并 因此 改善 查询 处 理 的 速度 。 对 以 读 取 为 主要 负载 
的 数据 库 ， 一 种 比较 经 常 采 用 的 策略 是 每 天 在 低 负 荷 的 时 候 运 行 一 次 VACUUM 和 ANALYZE o 


ANALYZE 只 需要 在 目标 表 上 有 一 个 读 取 锁 ， 因 此 它 可 以 和 表 上 的 其 它 活动 并 发 地 运行 。 


ANALYZE 收集 的 统计 信息 通常 包括 每 个 字段 最 常用 数值 的 列表 以 及 显示 每 个 字段 里 数据 近似 
分 布 的 柱状 图 。 如 果 ANALYZE 认为 它们 都 没有 什么 用 (比如 在 一 个 拥有 唯一 约束 的 字段 上 没 
公共 的 数值 ) 或 者 是 该 字段 数据 类 型 不 支持 相关 的 操作 符 ， 那 么 它们 都 可 以 忽略 。 在 Chapter 
23 中 有 关于 统计 的 更 多 信息 。 


对 于 大 表 ， ANALYZE 采集 表 内 容 的 一 个 随机 抽样 做 统计 ， 而 不 是 检查 每 一 行 。 这 样 就 保证 了 
即使 是 在 很 大 的 表 上 也 只 需要 很 少时 间 就 可 以 完成 分 析 。 不 过 ， 要 注意 的 是 统计 只 是 近似 的 
结果 ， 而 且 每 次 运行 ANALYZE 时 ， 即 使 表 的 内 容 没 有 任何 变化 ， 分 析 的 结果 也 可 能 有 生 许 差 
Fo 这 也 会 导致 EXPLAIN 显 示 的 规划 器 的 预期 开销 有 一 些小 变化 。 在 极 少 的 情况 下 ， 此 非 决 
定论 会 引发 规划 器 在 ANALYZE 运行 后 引发 查询 计划 更 改 。 为 了 避免 这 个 问题 ， 可 以 提 

高 ANALYZE 收集 的 统计 数量 ， 像 下 面 描述 的 那样 。 


分 析 的 广度 可 以 通过 用 调整 default_statistics_target 配 置 参数 ， 或 者 是 以 每 字段 为 基础 通过 
用 ALTER TABLE ... ALTER COLUMN ... SET STATISTICS (参见 ALTER TABLEI) 设 置 每 字段 的 统计 
目标 来 控制 。 目标 数值 设置 最 常用 数值 列表 中 的 记录 的 最 大 数目 以 及 柱状 图 中 的 最 大 块 数 。 
缺 省 的 目标 数值 是 100， 不 过 可 以 调节 这 个 数值 获取 规划 器 计算 精度 和 ANALYZE 运行 所 需要 的 
时 间 以 及 pg_statistic 里 面 占据 的 空间 数目 之 间 的 平衡 。 特别 是 ， 把 统计 目标 设置 为 需 就 关 
闭 了 该 字段 的 统计 收集 。 这 么 做 对 那些 从 来 不 参与 到 查询 的 WHERE, GROUP BY 或 

者 ORDER BY 选项 里 的 字段 是 很 有 用 的 ， 因 为 规划 器 不 会 使 用 到 这 样 的 字段 上 的 统计 。 


在 被 分 析 的 字段 中 最 大 的 统计 目标 决定 统计 采样 的 行 数 。 增 大 目标 会 导致 ANALYzE 的 时 候 成 
比例 地 增 大 对 时 间 和 空间 的 需求 。 


ANALYZE 的 一 个 估计 值 是 出 现在 每 列 的 不 同 值 的 数目 。 因为 仅仅 行 的 一 个 子 集 被 检查 ,这 个 估 
计 值 有 时 会 很 不 准确 ， 甚 至 是 对 最 大 可 能 的 统计 目标 。 如 果 这 个 错误 导致 了 差 的 查询 计划 ， 
一 个 更 精确 的 值 可 以 通过 手动 确定 并 且 然 后 通 

过 ALTER TABLE ... ALTER COLUMN ... SET (n_distinct = ...) 安装 。 (参见 ALTER TABLE), 


如 果 已 分 析 的 表 有 一 个 或 者 更 多 子 表 ， ANALYzE 将 会 收集 统计 两 次 : 一 次 仅仅 在 父 表 的 行 
上 ， 第 二 次 是 在 父 表 及 其 所 有 子 表 的 行 上 。 第 二 次 收集 的 统计 数据 在 查询 规划 器 通 历 整个 继 
承 树 结构 时 会 用 到 。 不 过 ，autovacuum 守 护 进程 在 决定 触发 一 个 对 一 个 表 的 自动 分 析 时 ， 会 
仅仅 考虑 在 父 表 上 进行 插入 或 者 更 新 。 如 果 那 个 表 几 乎 不 插入 或 者 更 新 ， 继 承 的 统计 数据 将 
不 再 更 新 ， 除 非 您 手动 运行 ANALYZE 。 


如 果 拟 分 析 的 表 成 了 一 个 空 表 ， 则 ANALYZE 不 会 记录 该 表 的 统计 信息 。 而 原来 已 有 有 统计 信 


息 则 会 保留 。 
DN 
兼容 性 
SQL 标准 里 没有 ANALYZE 语句 。 
参见 


VACUUM, vacuumdb, Section 18.4.4, Section 23.1.6 


BEGIN 


Name 


BEGIN -- 开始 一 个 事务 块 


Synopsis 


BEGIN [ WORK | TRANSACTION ] [ _transaction_mode_ [, ...] ] 
~_transaction_mode “可 以 是 以 下 选项 之 一 : 
ISOLATION LEVEL { SERIALIZABLE | REPEATABLE READ | READ COMMITTED | READ UNCOMMITTED 


READ WRITE | READ ONLY 
[ NOT ] DEFERRABLE 


a L 
fis aah 


BEGIN 初始 化 一 个 事务 块 ， 也 就 是 说 所 有 BEGIN 命令 后 的 用 户 语 句 都 将 在 一 个 事务 里 面 执 行 
直到 给 出 一 个 明确 的 COMMIT 或 ROLLBACK。 缺 省 情况 下 (没有 Bec )，PostgreSQL 

以 "autocommit" 模 式 执行 事务 ， 也 就 是 说 ， 每 个 语句 在 其 自身 的 事务 中 执行 ， 并 且 在 语句 结束 
的 时 候 执 行 了 一 次 隐 含 的 提交 。 【〔 如 果 执 行 成 功 则 隐 含 地 执行 一 个 提交 ， 否 则 执行 回 滚 。) 


在 事务 块 里 语句 执行 的 明显 快 得 多 ， 因 为 事务 开始 /提交 需要 大 量 的 CPU 和 磁盘 活动 。 在 一 个 
事务 内 部 执行 多 条 语句 对 于 修改 若干 个 相关 的 表 的 时 候 也 是 很 有 用 的 : 在 所 有 相关 的 更 新 完 
成 之 前 ， 其 它 会 话 看 不 到 中 间 的 状态 。 


如 果 指定 了 隔离 级 别 、 读 / 写 模 式 或 者 是 延迟 模式 ， 那 么 新 事务 将 具有 那些 特征 。 就 像 执 行 了 
SET TRANSACTION 一 样 。 


参数 
WORK` * TRANSACTION 
可 选 关 键 字 ， 没 什么 作用 。 


参考 SET TRANSACTION 获取 这 个 语句 的 其 它 参 数 的 含义 。 


START TRANSACTION 有 着 和 BEGIN 一 样 的 功能 。 
使 用 COMMIT 或 ROLLBACK 结 束 一 个 事务 块 。 


在 一 个 现 有 事务 块 内 部 发 出 一 个 BEGIN 将 产生 一 个 警告 信息 。 事务 的 状态 将 不 会 被 影响 。 要 
想 在 一 个 事务 块 里 艇 套 事 务 ， 请 使 用 保存 点 功能 (参见 SAVEPOINT)。 


出 于 向 下 兼容 考虑 ， 在 随后 的 _transaction_modes_ 之 间 的 逗号 可 以 忽略 。 


例子 
开始 一 个 事务 块 : 


BEGIN; 


RANE 


BEGIN 是 PostgreSQL 语 言 的 扩展 。 它 等 价 于 SQL 标准 中 的 START TRANSACTION@ S, H 
其 命令 的 资料 中 包含 更 多 有 关 兼 容 性 的 信息 。 


DEFERRABLE* _transaction_mode_ 选项 是 PostgreSQL 的 扩展 。 


顺便 说 一 句 ， BEGIN 关键 字 在 嵌入 SQL 里 用 于 不 同 目的 。 建 议 你 在 移植 数据 库 应 用 时 仔细 检 
查 事 务 的 语意 。 


参见 


ZZ 


COMMIT, ROLLBACK, START TRANSACTION, SAVEPOINT 


CHECKPOINT 


Name 


CHECKPOINT -- 强制 一 个 事务 日 志 检 查 点 


Synopsis 


CHECKPOINT 
摘 述 

检查 点 是 一 个 事务 日 志 中 的 时 点 ， 所 有 数据 文件 都 在 该 时 点 被 更 新 以 反映 日 志 中 的 信息 ， 所 
有 数据 文件 都 笃 被 刷新 到 磁盘 。 请 参见 Section 29.4 获 取 更 多 有 关 的 信息 。 

CHECKPOINT 命令 执行 时 会 强制 设置 一 个 检查 点 ， 而 不 必 等 待 正常 的 系统 内 部 按 调度 程序 设置 
的 检查 点 (其 设置 见 Section 18.5.2) o cHEckPoINT 在 正常 的 操作 中 一 般 不 必 使 用 。 


在 数据 恢复 过 程 中 ， checkpoint 命令 会 强制 设置 一 个 复位 点 (参见 Section 29.4) ， 而 不 是 设 


只 有 超级 用 户 可 以 调用 CHECKPOINT o 


兼容 性 


CHECKPOINT 命令 是 PostgreSQL 语 言 的 扩展 。 


CLOSE 


Name 


CLOSE -- 关闭 游标 


Synopsis 


CLOSE { _name_ | ALL } 


摘 述 
cLOSE 释放 和 一 个 游标 关联 的 所 有 资源 。 不 允许 对 一 个 已 关闭 的 游标 再 做 任何 操作 。 一 个 不 
再 使 用 的 游标 应 该 尽早 关闭 。 


当 创 建 游标 的 事务 用 commit 或 ROLLBACK 终止 之 后 ， 每 个 不 可 保持 的 已 打开 游标 都 隐 含 关 
闭 。 当 创 建 游标 的 事务 通过 RoLLBACK 退出 之 后 ， 每 个 可 以 保持 的 游标 都 将 隐 含 关闭 。 当 创 
建 游标 的 事务 成 功 提交 ， 那 么 可 保持 的 游标 保持 打开 ， 直 到 执行 一 个 明确 的 close 命令 或 者 
客户 端 断 开 。 


参数 


_name 


一 个 待 关 闭 的 游标 的 名 字 。 


ALL 


关闭 所 有 打开 的 游标 。 


一- = 


) 王 局 


PostgreSQL 没 有 明确 打开 游标 的 open 语句 ; 一 个 游标 在 使 用 DECLARE 语句 声明 的 时 候 就 
可 以 被 认为 是 打开 了 。 可 以 使 用 DECLARE 命 邻 声明 游 标 。 
你 可 以 通过 查询 pg cursors 系统 视图 查看 所 有 可 获得 的 游标 。 


如 果 一 个 游标 在 一 个 随后 回 滚 的 保存 点 后 关闭 ， close 不 会 回 滚 ; 这 就 是 说 ， 游 标 仍然 关 
闭 。 


例子 
关闭 游标 Liahona : 


CLOSE liahona; 


兼容 性 


cLOSE 命令 与 SQL 标准 完全 兼容 。 cLosE ALL 是 一 个 PostgreSQL 扩 展 。 


参见 


一 


DECLARE, FETCH, MOVE 


CLUSTER 


Name 


CLUSTER -- #848—* 3451 st BV A PRHE 


Synopsis 


CLUSTER [VERBOSE] _table_name_ [ USING _index_name_ ] 
CLUSTER [VERBOSE] 


JAR 


CLUSTER 指示 PostgreSQL 基 于 索引 _index_name_ 的 内 容 对 表 _table_name_ AITE i BRE 
排序 。 索引 必须 已 经 在 表 table name 上 定义 过 的 索引 。 


当 对 一 个 表盘 敌 化 排序 后 ， 该 表 的 物理 存储 将 基于 索引 顺序 排序 。 盘 敌 化 是 一 次 性 操作 : 当 
表 将 来 被 更 新 之 后 ， 更 改 的 内 容 不 会 被 盘 徐 化 排序 。 也 就 是 说 ， 系 统 不 会 试图 按照 索引 顺序 
对 更 新 过 的 记录 重新 盘 复 化 排序 。 〈 如 果 用 户 想 要 这 个 效果 ， 可 以 通过 周期 性 地 手工 执行 该 
命令 的 方法 重新 盘 敌 化 排序 。 并 且 ， 设 置 表 的 FILLFACTOR 存储 参数 为 小 于 100% 可 以 帮助 总 
复 化 排序 在 更 新 时 排序 ， 因 为 若 有 足够 的 空间 可 用 ， 更 新 的 行 可 以 保存 在 相同 的 页 面 位 

E. ) 


fExt—T # RICHER ZIG, PostgreSQLBiz Itt A T RAR EAI T AbH. 
CLUSTER _table_name_ MÉARA HAIT A PREHR EAR ELEA ARCHER. tE 
可 以 用 CLUSTER 或 SET WITHOUT CLUSTER ERRA AFT A RHET], BARE 
之 前 的 设置 。 


不 含 参 数 的 cLusTER 会 将 当前 用 户 所 拥有 的 当前 数据 库 中 的 所 有 先前 进行 瘟 徐 化 排序 的 表 重 
新 处 理 ， 或 者 如 果 是 超级 用 户 使 用 这 个 命 合 时 ， 则 对 所 有 进行 过 盘 簇 化 排序 表 重 新 处 理 。 这 
种 形式 的 cluster 不 能 在 一 个 事务 里 面 调用 。 


在 对 一 个 表 进 行 盘 签 化 排序 的 时 候 ， 会 在 其 上 请 求 一 个 ACCESS EXCLUSIVE 锁 。 这 样 就 避免 了 
在 cLusTER 完成 之 前 执行 任何 其 它 的 数据 库 操 作 (包括 读 写 )。 


参数 


_table_name_ 


ROAM (可 以 有 模式 修饰 )。 


_index_name_ 


一 个 索引 名 称 。 


VERBOSE 


当 每 一 个 表 进 行 胡 簇 化 排序 时 打印 一 个 处 理 情况 报告 。 


MN 一 


) 王 局 


如 果 你 只 是 随机 的 访问 表 中 的 行 ， 那 么 表 中 数据 的 实际 存储 顺序 是 无 关 紧 要 的 。 但 是 ， 如 果 
对 某 些 特定 数据 的 访问 较 多 ， 而 且 有 一 个 索引 将 这 些 数据 分 组 ， 那 么 使 用 cLusTER 会 非常 有 
益处 。 如 果 从 一 个 表 中 请 求 一 定 索 引 范 围 的 值 ， 或 者 是 一 个 索引 值 对 应 多 行 ， CLUSTER 也 会 
有 助 于 应 用 ， 因 为 如 果 索 引 标识 出 第 一 匹配 行 所 在 的 存储 页 ， 所 有 其 它 行 也 可 能 已 经 在 同一 
个 存储 页 里 了 ， 这 样 便 节 省 了 磁盘 访问 的 时 间 ， 加 速 了 查询 。 


CLUSTER 在 盘 敌 化 排序 的 久 理 过 程 中 ， 可 以 按 一 个 索引 顺序 ， 也 可 以 按 一 个 排序 后 的 顺序 扫 
HAA, 它 会 基于 查询 规划 器 的 成 本 参数 和 表 的 统计 信息 选择 一 个 相对 较 快 的 方法 。 


CLUSTER 在 瘟 簇 化 排序 的 处 理 过 程 中 ， 系 统 先 创建 一 个 按照 索引 顺序 建立 的 表 的 临时 拷贝 。 
同时 也 建立 表 上 的 每 个 索引 的 临时 拷贝 。 因此 ， 需 要 磁盘 上 有 足够 的 剩余 空间 ， 至 少 是 表 大 
小 和 索引 大 小 的 和 。 


当 使 用 顺序 扫描 和 排序 操作 时 ， 系 统 会 创建 临时 排序 文件 ， 这 样 极 端 情况 下 ， 磁 盘 空 间 会 需 
要 至 少 约 2 倍 的 表 大 小 和 索引 大 小 。 这 个 方法 一 般 比 使 用 索引 的 方法 要 快 一 点 ， 但 如 果 对 磁 和 总 
空间 的 要 求 不 可 接受 ， 可 以 临时 设置 enable sort 为 off 来 禁用 这 个 选择 。 


建议 在 执行 意 徐 化 排序 前 ， 将 maintenance_work_mem 参 数 设 置 为 一 个 合理 的 较 大 数值 (但 
不 要 超过 可 以 保留 给 cluster 使 用 的 内 存 大 小 ) o 


因为 规划 器 记录 着 有 关 表 的 排序 的 统计 ， 所 以 建议 在 最 近 妆 簇 化 排序 后 的 表 上 运 
行 ANALYZE。 否 则 ， 规 划 器 可 能 会 选择 很 差劲 的 查询 规划 。 


因为 cLusTER 记录 着 哪些 索引 用 于 过 盘 徐 化 排序 ， 所 以 用 户 可 以 第 一 次 手工 指定 表 使 用 指定 
索引 进行 盘 复 化 排序 ， 以 后 设置 一 个 周期 化 执行 的 维护 脚本 ， 只 需 执行 不 带 参 数 
的 cLusTER 命令 ， 即 可 实现 对 想 要 周期 性 盘 复 化 排序 的 表 进 行 自 动 更 新 。 


例子 
按照 索引 employees_ind 的 顺序 对 employees R447 A FRICHEF : 


CLUSTER employees USING employees_ind; 


使 用 以 前 用 过 的 同一 个 索引 对 employees R4417 A PAGHE : 


CLUSTER employees; 


xt DB A GRACBER it BURT AT Ba A RHE : 


CLUSTER; 


兼容 性 
SQL 标准 里 没有 CLUSTER 语句 。 


CLUSTER _index_name_ ON _table_name 





的 语法 也 兼容 PostgreSQL 8.3 之 前 的 版 本 


参见 


J 


clusterdb 


COMMENT 


Name 


COMMENT -- 定义 或 者 改变 一 个 对 象 的 注释 


Synopsis 


COMMENT ON 
{ 
AGGREGATE _agg_name_ (_agg_type_[, ...] ) | 
CAST (_source_type_ AS _target_type_) | 
COLLATION _object_name_ | 
COLUMN _relation_name_._column_name_ | 
CONSTRAINT _constraint_name_ ON _table_name 
CONVERSION _object_name_ | 
DATABASE _object_name_ | 
DOMAIN _object_name_ | 
EXTENSION _object_name_ | 
EVENT TRIGGER _object_name_ | 
FOREIGN DATA WRAPPER _object_name_ | 
FOREIGN TABLE _object_name_ | 
FUNCTION _function_name_ ( [ [ _argmode_ ] [ _argname_ ] _argtype_[, ...] ] ) | 
INDEX _object_name_ | 
LARGE OBJECT _large_object_oid_ | 
MATERIALIZED VIEW _object_name_ | 
OPERATOR _operator_name_ (_left_type_, _right_type_) | 
OPERATOR CLASS _object_name_ USING _index_method_ | 
OPERATOR FAMILY _object_name_ USING _index_method_ | 
[ PROCEDURAL ] LANGUAGE _object_name_ | 
ROLE _object_name_ | 
RULE _rule_name_ ON _table_name_ | 
SCHEMA _object_name_ | 
SEQUENCE _object_name_ | 
SERVER _object_name_ | 
TABLE _object_name_ | 
TABLESPACE _object_name_ | 
TEXT SEARCH CONFIGURATION _object_name_ | 
TEXT SEARCH DICTIONARY _object_name_ | 
TEXT SEARCH PARSER _object_name_ | 
TEXT SEARCH TEMPLATE _object_name_ | 
TRIGGER _trigger_name_ ON _table_name_ | 
TYPE _object_name_ | 
VIEW _object_name_ 
ES e texti 
































摘 述 
COMMENT 存储 一 个 数据 库 对 象 的 注释 。 


每 个 对 象 只 存储 一 条 注释 ， 因 此 要 修改 一 个 注释 ， 对 同一 个 对 象 发 出 一 条 新 的 comment 命令 
即 可 。 要 删除 注释 ， 在 文本 字符 串 的 位 置 写 上 nu 即 可 。 当 删 除 对 象 时 ， 注 释 自动 被 删除 
掉 。 


对 大 多 数 对 象 ， 只 有 对 象 的 所 有 者 可 以 设置 注释 。 和 角色 没有 所 有 者 ， 所 以 comment on ROLE 命 
合 仅 可 以 由 超级 用 户 对 超级 用 户 角色 执行 ， 有 cREATEROLE 权限 的 角色 也 可 以 为 非 超级 用 户 角 
色 设 置 注释 ， 当 然 超 级 用 户 可 以 对 所 有 对 象 进行 注释 。 


注释 可 以 用 psql 程 序 中 的 \d 命令 检索 。 其 它 希 望 提取 注释 的 用 户 接口 设计 可 以 使 用 程序 psql 
使 用 的 同样 的 内 置 画 数 obj_description 、 col_description 和 shobj_description (参见 Table 
9-55)。 


参数 


object_name_*~~_relation_name_ . _column_name agg_name constraint_name_ 











_function_name_ _operator_name rule_name trigger_name_ 


BMA TAHIRA. R RS. HEM MI, geese, th, AAR. WR. RS, HE 
符 、 操 作 符 类 、 操 作 符 系列 、 序 列 、 全 文 搜 索 对 象 、 类 型 、 视 图， 名 字 可 以 有 模式 修饰 。 当 
对 一 个 字段 进行 注释 时 ， _relation_name_ ! 必需 是 针对 一 个 表 、 视图 、 复合 类 型 或 是 外 部 表 。 


_agg_type_ 
聚集 函数 操作 的 输入 参数 类 型 ， 要 引用 一 个 需 参 数 聚 集 画 数 ， 可 以 使 用 * 代 蔡 输入 数据 类 型 
列表 。 
_source_type_ 
类 型 转换 的 源 数 据 类 型 。 
_target_type_ 
类 型 转换 的 目标 数据 类 型 。 
_argmode_ 
函数 参数 的 模式 : IN, OUT, INouT 或 vARIADIc o WREAK, RELE IN 。 请 注 
意 


意 COMMENT ON FUNCTION 实际 上 不 会 使 用 ouT BM, 因为 只 要 有 输入 参数 就 可 以 判断 函数 的 
身份 了 。 因此 ， 只 要 列 出 IN 、 rout 和 VARIADIC 参数 就 足够 了 。 


_argname_ 


画 数 参数 的 名 字 。 请 注意 COMMENT on FUNCTION 实际 上 并 不 使 用 参数 名 ， 因 为 只 要 有 参数 的 数 
据 类 型 就 可 以 判断 西数 的 身份 。 


_argtype_ 
如 果 有 的 话 ， 是 函数 参数 的 数据 类 型 (可 以 用 模式 修饰 ) 


large_object_oid 





大 对 象 的 OID 。 


left_type right_type 





操作 符 参 数 的 数据 类 型 (可 以 用 模式 修饰 ) 。 当前 置 或 后 置 操作 符 不 存在 时 ， 可 以 增 
加 None 选项 。 


PROCEDURAL 


这 个 选项 没有 任何 用 处。 


_text_ 


新 的 注释 ， 以 字符 串 文本 的 方式 写 ; 如 果 是 NuLL 则 删除 注释 。 


<a 


E T 
目前 注释 浏览 没有 安全 机 制 : 任何 连接 到 某 数据 库 上 的 用 户 都 可 以 看 到 所 有 该 数据 库 对 象 的 


注释 。 共享 对 象 (比如 数据 库 、 角 色 、 表 空间 ) 的 注释 是 全 局 存储 的 ， 连 接 到 任何 数据 库 的 任 
何 用 户 都 可 以 看 到 它们 。 因此 ， 不 要 在 注释 里 存放 与 安全 有 关 的 敏感 信息 。 


例子 
给 表 mytable 加 注释 : 

COMMENT ON TABLE mytable IS 'This is my table.'; 
再 删除 注释 : 


COMMENT ON TABLE mytable IS NULL; 


一 些 例子 : 


COMMENT ON AGGREGATE my_aggregate (double precision) IS 'Computes sample variance'; 
COMMENT ON CAST (text AS int4) IS 'Allow casts from text to int4'; 

COMMENT ON COLLATION "fr_CA" IS 'Canadian French'; 

COMMENT ON COLUMN my_table.my_column IS 'Employee ID number'; 

COMMENT ON CONVERSION my_conv IS 'Conversion to UTF8'; 

COMMENT ON CONSTRAINT bar_col_cons ON bar IS 'Constrains column col'; 

COMMENT ON DATABASE my_database IS 'Development Database'; 

COMMENT ON DOMAIN my_domain IS 'Email Address Domain'; 

COMMENT ON EXTENSION hstore IS ‘implements the hstore data type'; 

COMMENT ON FOREIGN DATA WRAPPER mywrapper IS 'my foreign data wrapper'; 

COMMENT ON FOREIGN TABLE my_foreign_table IS 'Employee Information in other database'; 
COMMENT ON FUNCTION my_function (timestamp) IS 'Returns Roman Numeral'; 

COMMENT ON INDEX my_index IS 'Enforces uniqueness on employee ID'; 

COMMENT ON LANGUAGE plpython IS "Python support for stored procedures'; 

COMMENT ON LARGE OBJECT 346344 IS 'Planning document'; 

COMMENT ON MATERIALIZED VIEW my_matview IS 'Summary of order history'; 

COMMENT ON OPERATOR ^ (text, text) IS 'Performs intersection of two texts'; 

COMMENT ON OPERATOR - (NONE, integer) IS 'Unary minus'; 

COMMENT ON OPERATOR CLASS int4ops USING btree IS '4 byte integer operators for btrees'; 
COMMENT ON OPERATOR FAMILY integer_ops USING btree IS ‘all integer operators for btrees'; 
COMMENT ON ROLE my_role IS 'Administration group for finance tables'; 

COMMENT ON RULE my_rule ON my_table IS 'Logs updates of employee records'; 

COMMENT ON SCHEMA my_schema IS 'Departmental data'; 

COMMENT ON SEQUENCE my_sequence IS 'Used to generate primary keys'; 

COMMENT ON SERVER myserver IS 'my foreign server'; 

COMMENT ON TABLE my_schema.my_table IS ‘Employee Information'; 

COMMENT ON TABLESPACE my_tablespace IS 'Tablespace for indexes'; 

COMMENT ON TEXT SEARCH CONFIGURATION my_config IS 'Special word filtering'; 

COMMENT ON TEXT SEARCH DICTIONARY swedish IS 'Snowball stemmer for swedish language'; 
COMMENT ON TEXT SEARCH PARSER my_parser IS 'Splits text into words'; 

COMMENT ON TEXT SEARCH TEMPLATE snowball IS 'Snowball stemmer'; 

COMMENT ON TRIGGER my_trigger ON my_table IS 'Used for RI'; 

COMMENT ON TYPE complex IS 'Complex number data type'; 

COMMENT ON VIEW my_view IS 'View of departmental costs'; 


4 eee 


RANE 


SQL 标准 里 没有 comment 命 使。 


COMMIT 


Name 


COMMIT -- 提交 当前 事务 


Synopsis 


COMMIT [ WORK | TRANSACTION ] 


fia oh 

comit 提交 当前 事务 。 所 有 事务 的 更 改 都 焊 被 其 它 事 务 可 见 ， 
的 数据 有 效 性 。 

参数 


WORK ` ` TRANSACTION 


可 选 关 键 字 ， 没 有 任何 作用 。 


、\ 一 - a 


ae 


使 用 ROLLBACK 和 语句 退出 事务 。 


而 且 保 证 即使 有 崩溃 发 生 时 


在 一 个 事务 外 部 发 出 coMMIT 不 会 有 问题 ， 但 是 将 产生 一 个 警告 信息 。 


例子 
提交 当前 事务 以 让 所 有 变更 永久 化 : 


COMMIT; 


兼容 性 


SQL 标准 只 声明 了 coMMIT 和 coMMIT work 两 种 形式 。 


否则 这 条 命 邻 与 标准 完全 兼容 。 
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— 


参见 


BEGIN, ROLLBACK 


COMMIT 1610 


COMMIT PREPARED 


Name 


COMMIT PREPARED -- 提交 一 个 早先 为 两 阶段 提交 准备 好 的 事务 


Synopsis 


COMMIT PREPARED _transaction_id_ 


fia ah 


COMMIT PREPARED 提交 一 个 早先 为 两 阶段 提交 准备 好 的 事务 。 


参数 


_transaction_id_ 


要 提交 的 事务 标示 符 。 
MN N 

) 王 局 

要 提交 一 个 预 处 理 的 事务 ， 你 必须 是 最 初 执行 该 事务 的 用 户 或 超级 用 户 。 
个 会 话 里 执行 该 命令 。 

这 条 命令 不 能 在 事务 块 里 执行 。 预 处 理 的 事务 立即 提交 。 


所 有 目前 可 用 的 预 处 理事 务 都 在 系统 视图 pg_prepared_xacts 里 列 出 。 


Examples 


提交 事务 标识 符 为 foobar 的 事务 : 


COMMIT PREPARED 'foobar'; 


不 过 你 不 必 在 同一 


COMMIT PREPARED 是 PostgreSQL 的 扩展 。 该 命令 设计 给 外 部 事务 管理 系统 使 用 的 ，SQL 标 准 
只 涉及 部 分 功能 (如 X/Open XA) ， 但 这 些 功 能 目前 没有 标准 化 。 


参见 


一 


PREPARE TRANSACTION, ROLLBACK PREPARED 


COPY 


Name 


COPY -- 在 表 和 文件 之 间 拷 贝 数 据 


Synopsis 








COPY _table_name_ [ ( _column_name_ [, ...] ) ] 
FROM { '_filename_' | PROGRAM '_command_' | STDIN } 
[ [ WITH ] ( _option_ [, ...] ) ] 
COPY { _table_name_ [ ( _column_name_ [, ...] ) ] | ( _query_ ) } 
TO { '_filename_' | PROGRAM '_command_' | STDOUT } 
[ [ WITH ] ( _option_ [, ...] ) ] 


where ~_option_~ can be one of: 


FORMAT _format_name_ 

OIDS [ _boolean_ ] 

FREEZE [ _boolean_ ] 

DELIMITER '_delimiter_character_' 

NULL '_null_string_' 

HEADER [ _boolean_ ] 

QUOTE '_quote_character_' 

ESCAPE '_escape_character_' 

FORCE_QUOTE { ( _column_name_ [, ...] ) | * } 
FORCE_NOT_NULL ( _column_name_ [, ...] ) 
ENCODING '_encoding_name_' 


copy 在 PostgreSQL 表 和 文件 之 间 交 换 数据 。 copy To 把 一 个 表 的 所 有 内 容 都 拷贝 到 一 个 文 
件 ， 而 copy FRoM 从 一 个 文件 里 拷贝 数据 到 一 个 表 里 ( 把 数据 附加 到 表 中 已 经 存在 的 内 容 里 )。 


copy To 还 能 拷贝 SELECT 查询 的 结果 。 


如 果 声 明了 一 个 字段 列表 ， cory 将 只 在 文件 和 表 之 间 找 贝 已 声明 字段 的 数据 。 如 果 表 中 有 
任何 不 在 字段 列表 里 的 字段 ， 那 么 copy FRoM 将 为 那些 字段 插入 缺 省 值 。 


带 文件 名 的 copy 指示 PostgreSQL 服 务 器 直接 从 文件 中 读 写 数 据 。 如 果 声 明了 文件 名 ， 那 么 
服务 器 必须 可 以 访问 该 文件 ， 而 且 文件 名 必须 从 服务 器 的 角度 声明 。 如 果 使 用 了 procram 选 
项 ， 则 服务 器 会 从 指定 的 这 个 程序 进行 输入 或 是 写 入 该 程序 作为 输出 。 如 果 使 用 了 STIN 
或 sTbouT 选项 ， 那 么 数据 将 通过 客户 端 和 服务 器 之 间 的 连接 来 传输 。 


参数 


_table_name_ 


现存 表 的 名 字 ( 可 以 有 模式 修饰 )。。 

_column_name_ 

可 选 的 待 拷贝 字段 列表 。 如 果 没 有 声明 字段 列表 ， 那 么 将 使 用 所 有 字段 。 
_query_ 

一 个 必须 用 圆 括 弧 包 围 的 SELECT 或 VALUES 命 令 ， 其 结果 将 被 拷贝 。 
_filename_ 

输入 或 输出 文件 的 路 径 名 。 输 入 文件 名 可 以 是 绝对 或 是 相对 的 路 径 ， 但 输出 文件 名 必须 是 绝 
对 路 径 。 Windows 用 户 可 能 需要 使 用 E'' 字符 串 和 双 反 斜 线 作为 路 径 名 称 。 
PROGRAM 

需 执 行 的 程序 名 。 在 copy FRoM 命令 中 ， 输 入 是 从 程序 的 标准 输出 中 读 取 ， 而 
在 copy To 中 ， 命 邻 的 输出 会 作为 程序 的 标准 输入 。 


注意 ， 程 序 一 般 是 在 命令 行 界面 下 执行 ， 当 用 户 需要 传递 一 些 变量 给 程序 时 ， 如 果 这 些 变量 
的 来 源 不 是 可 靠 的 ， 用 户 必须 小 心 过 滤 处 理 那些 对 命令 行 界面 来 说 是 有 特殊 意义 的 字符 。 基 
于 安全 的 原因 ， 最 好 是 使 用 固定 的 命令 字符 串 ， 或 者 至 少 是 点 避免 直接 使 用 用 户 输 入 〈 应 先 
过 滤 特 殊 字 符 ) 。 


STDIN 
声明 输入 是 来 自 客 户 端 应 用 。 

STDOUT 

声明 输入 将 写 入 客户 端 应 用 。 

_boolean_ 

声明 用 户 所 选 的 选项 是 否 应 该 被 开启 或 者 关闭 。 您 可 以 写 TRUE 、 on 或 1 来 启用 这 个 选 
项 ， 并 且 用 FALSE 、 oFF 或 9 来 关闭 它 。 _boolean 值 也 可 以 被 省 略 ， 此 时 系统 使 用 缺 省 


值 TRUE 。 

FORMAT 

选择 被 读 或 者 写 的 数据 格式 : text. csv (逗号 分 隔 值 ) ， 或 者 binary. 默认 是 text o 
OIDS 

声明 为 每 行 记录 都 拷贝 内 部 对 象 标 识 (OID)。 【〔 如 果 为 一 个 query 拷贝 或 者 没有 orms WR 
声明 了 OIDS 选 项 ， 则 抛 出 一 个 错误 。) 


FREEZE 


请 求 拷贝 那些 已 冻结 的 数据 ， 就 类 似 使 用 vacuum FREEZE 的 效果 。 这 主要 于 用 于 初始 化 时 加 
载 数据 时 的 性 能 考虑 。 仅 在 表 记 录 初 始 创 建 或 是 在 当前 子 事务 中 被 清理 的 记录 会 补 冻结 ， 没 
有 游标 会 打开 ， 事 务 中 也 没有 数据 快照 。 
注意 此 时 其 他 的 事务 会 立刻 看 见 刚 加 载 的 数据 。 这 不 符合 MVCC 正 常 的 可 见 性 规则 ， 用 户 应 
注意 这 可 能 带 来 的 潜在 问题 。 
DELIMITER 
指定 分 隔 每 一 行 记 录 中 的 列 的 字符 。 默 认 是 文本 格式 的 制 表 符 ， csv 格式 的 逗号 。 必须 有 一 
个 独立 的 一 字 节 的 字符 。 在 使 用 binary 格式 时 这 个 选项 是 不 允许 的 。 
NULL 
声明 代表 一 个 空 值 的 字符 串 。 默 认 是 文本 格式 的 \N ， csv 格式 的 一 个 未 被 引用 的 空 字符 
$. 即使 是 文本 格式 您 可 能 也 更 偏向 于 空 串 ， 例 如 您 不 想 从 空 字符 串 中 区 分 空 值 。 在 使 
用 binary 格式 时 这 个 选项 是 不 允许 的 。 
Note: 在 使 用 copy FRoM 的 时 候 ， 任 何 匹 配 这 个 字符 串 的 字符 串 将 被 存储 为 NULL 值 ， 所 
以 你 应 该 确保 你 用 的 字符 串 和 copy To 相同 。 








HEADER 
声明 文件 包含 一 个 带 有 文件 中 每 列 名 称 的 标题 行 。 在 输出 时 ， 第 一 行 包含 表 中 的 列 名 ， 在 输 
入 时 ， 第 一 行 是 被 忽略 的 。 该 选项 仅仅 在 使 用 csv 格式 时 是 允许 的 。 

QUOTE 

指定 引用 数据 的 引用 字符 。 默 认 的 是 双 引 号 。 这 一 定 是 一 个 1 字 节 的 字符 。 该 选项 仅仅 在 使 
用 csv 格式 时 人 允许 。 

ESCAPE 

声明 应 该 出 现在 一 个 匹配 quote 值 的 数据 字符 之 前 的 字符 。 默认 与 quoTE 值 相同 (所 以 若 它 


出 现在 数据 中 ， 则 引用 字符 是 翻 一 倍 ) 。 这 一 定 是 一 个 1 字 节 的 字符 。 该 选项 只 有 在 使 
用 csv 格式 时 人 允许。 


FORCE_QUOTE 


强制 引用 在 每 个 指定 列 的 所 有 非 NULL 值 。 NULL 从 不 被 引用 。 如 果 声 明了 * ， 非 NuLL 值 将 
在 所 有 列 中 被 引用 。 这 个 选项 仅仅 在 copy To 中 并 且 仅 仅 在 使 用 csv 格式 时 人 允许 。 
FORCE_NOT_NULL 

默认 情况 下 空 字 符 串 是 空 的 ， 这 意味 着 空 值 将 会 被 读 作 长 度 为 雳 的 字符 串 而 不 是 空 值 ， 即 使 
当 他 们 不 被 引用 。 这 个 选项 仅仅 在 copy From 中 并 且 仅 仅 在 使 用 csv 格式 时 人 允许。 

ENCODING 


声明 文件 的 编码 集 是 _encoding_name_ 。 如 果 这 个 选项 省 略 ， 则 系统 使 用 当前 的 用 户 编码 集 。 
阅读 下 面 的 注意 事项 以 了 解 更 多 内 容 。 


Outputs 
4 coy 命令 执行 成 功 后 ， 会 在 屏幕 上 显示 


COPY _count_ 
式样 内 容 ， 这 里 count. 是 已 拷贝 成 功 的 记录 数 。 
\、 a 
EA 
copy 只 能 用 于 表 ， 不 能 用 于 视图 。 当 然 也 可 以 用 于 copy (SELECT * FROM _viewname_ )TO .… 


copy 仅仅 处 理 已 指定 的 特定 表 ; 它 将 不 复制 数据 到 子 表 或 从 子 表 中 复制 数据 。 因此 比 
如 copy _table TO 显示 与 SELECT * FROM ONLY _table_ 相同 的 数据 。 但 
是 COPY (SELECT * FROM _table_) TO ... 可 以 用 于 转 储 在 继承 层次 结构 的 所 有 数据 。 


你 对 任何 要 copy To 出 来 的 数据 必须 有 查询 的 权限 ， 对 任何 要 copy FRoM 入 数据 的 表 必 须 有 
插入 权限 。 对 列 在 命令 中 的 字段 拥有 列 权 限 也 是 必须 的 。 


copy 命令 里 面 的 文件 必须 是 由 服务 器 直接 读 或 写 的 文件 ， 而 不 是 由 客户 端 应 用 读 写 。 
此 ， 它 们 必须 位 于 数据 库 服务 器 上 或 者 可 以 被 数据 库 服务 器 所 访问 ， 而 不 是 客户 端 程序 。 它 
们 必须 被 运行 PostgreSQL 服 务 器 的 用 户 可 读 或 写 ， 而 不 是 客户 端 程序 。 由 PROGRAM 选项 指定 
的 命令 必须 是 由 服务 器 来 执行 的 ， 而 不 是 客户 端 程序 ， 必 须 是 由 PostgreSQL 所 属 的 用 户 。 
copy 在 指定 一 个 程序 或 是 命令 时 只 允许 数据 库 超级 用 户 来 执行 ， 因 为 它 允 许 读 写 任 意 服务 器 
有 权限 访问 的 文件 。 


不 要 混淆 copy 和 psdql 应 用 程序 中 的 [\copy](#calibre_link-1638) 指令 。 \copy 调 

用 copy FROM STDIN 或 copy To STDouT ， 然 后 把 数据 抓 取 / 存 储 到 一 个 psql 客 户 端 可 以 访问 的 文 
件 中 。 因此 ， 使 用 \copy 的 时 候 ， 文 件 访问 权限 是 由 客户 端 应 用 程序 而 不 是 服务 器 端 决定 
的 。 


建议 在 copy 里 的 文件 名 字 总 是 使 用 绝对 路 径 。 在 copy To 的 时 候 是 由 服务 器 强制 进行 的 ， 
但 是 对 于 copy FRoM ， 你 的 确 可 从 一 个 相对 路 径 的 文件 里 读 取 。 该 路 径 将 解释 为 相对 于 服务 
器 的 工作 目录 (通常 是 数据 目录 )， 而 不 是 客户 端的 工作 目录 。 


执行 一 个 PROGRAM 选项 指定 的 命令 有 可 能 还 会 受到 操作 系统 的 存 取 权 限 控制 ， 如 在 SELinux 
下 。 


coPY FROM 在 执行 时 会 触发 目标 表 上 所 有 人 触发 器 和 检查 约束 。 不 过 ， 不 会 执行 规则 。 


copy 输入 和 输出 会 被 Datestyle 参数 影响 。 为 了 和 其 它 PostgreSQL 不 同 服务 器 间 进 行 数据 
转移 (它们 可 能 是 非 缺 省 Datestyle 设置 )， 应 该 在 使 用 copy to 前 把 patestyle 参数 值 设 置 
为 iso, 另外 也 建议 在 导出 数据 时 ， 不 要 将 Intervalstyle 参数 设置 为 sql_standard 。 因为 
负 的 区 间 值 可 能 会 被 对 Intervalstyle 有 不 同 设置 的 服务 器 误解 。 


输入 数据 通过 ENcopING 参数 或 是 当前 客 户 端 编码 来 解 译 ， 输 出 数据 也 是 通过 encopine 参数 
或 是 为 当前 客户 端的 编码 来 编码 ， 即使 数据 不 经 过 客户 端的 ， 仍 会 通过 服务 器 直接 将 数据 从 
文件 中 读 出 或 者 写 入 到 文件 中 去 。 


copy 在 第 一 个 错误 处 停 下 来 。 这 些 在 copy To 中 不 应 该 导致 问题 ， 但 在 copy FRoM 时 目标 
表 会 已 经 接收 到 早先 的 行 ， 这 些 行 将 不 可 见 或 不 可 访问 ， 但 是 仍然 会 占据 磁盘 空间 。 如 果 你 
矶 巧 拷贝 大 量 数据 文件 的 话 ， 这 些 示 西 积累 起 来 可 能 会 占据 相当 大 的 磁盘 空间 。 你 可 以 调 
FA vacuum 来 恢复 那些 磁盘 空间 。 


文件 格式 
文本 格式 


当 使 用 text 格式 时 ， 读 写 的 文件 是 一 个 文本 文件 ， 每 行 代 表 表 中 一 个 行 。 行 中 的 列 (字段 ) 用 
分 隔 符 分 开 。 字 段 值 本 身 是 由 与 每 个 字段 类 型 相关 的 输出 画 数 生成 的 字符 串 ， 或 者 是 输入 画 
数 可 接受 的 字符 串 。 数据 中 使 用 特定 的 NULL 字 符 串 表示 那些 值 为 NULL 的 字段 。 如 果 输 入 文 
件 的 任意 行 包 含 比 预期 多 或 者 少 的 字段 ， 那 么 copy FRoM 将 抛 出 一 个 错误 。 如 果 声 明 

了 oms 选项 ， 那 么 DID 将 作为 第 一 个 字段 读 写 ， 放 在 所 有 用 户 字段 前 面 。 


数据 的 结束 可 以 用 一 个 只 包含 反 斜 杠 和 句点 (\.) 的 行 表示 。 如 果 从 文件 中 读 取 数据 ， 那 么 数 
据 结束 的 标记 是 不 必要 的 ， 因 为 文件 结束 符 可 以 起 到 相同 的 作用 ; 但 是 在 3.0 之 前 的 客户 端 协 
RE, 如 果 在 客户 端 应 用 之 间 拷 贝 数据 ， 那 么 必须 要 有 结束 标记 。 


反 斜 杠 字符 (、\ ) 可 以 用 于 copy 数据 ， 来 引用 那些 可 能 会 被 当 作 行 或 列 分 隔 符 的 数据 字符 。 
特别 是 以 下 字符 ， 若 以 一 列 值 的 一 部 分 出 现 则 必须 在 前 面 加 上 反 斜 杠 : 反 斜 枉 、 换 行 符 、 回 
车 以 及 当前 的 分 隔 符 字符 。 


声明 的 空 字符 串 被 copy To 不 加 任何 反 斜 杠 发 送 ; 与 之 相对 ， copy FRoM 在 删除 反 斜 杠 之 前 
拿 它 的 输入 与 空 字 符 串 比较 。 Alt, Rw 这 样 的 空 字符 串 不 会 和 实际 数据 值 \N 之 间 混 淆 
(因为 后 者 会 表现 成 \\N )。 


COPY FROM 能 够 识别 下 列 特殊 反 斜 杠 字 符 : 


字符 形式 字符 含义 


\b RHI (ASCII 8) 

Af 进 纸 (ASCII 12) 

Ni 换行 符 (ASCII 10) 

\r 回 车 符 (ASCII 13) 

\t 水 平 制 表 符 (ASCII 9) 

\v 垂直 制 表 符 (ASCII 11) 

\"*_digits_ 反 斜 杠 后 面 跟着 一 到 三 个 八进制 数 ， 表 示 ASCII 值 为 该 数 的 字符 


\ digits, RAL x 后 面 跟着 一 个 或 两 个 十 六 进 制 位 声明 指定 数值 编码 的 字符 


目前 ， copy To 绝 不 会 发 出 一 个 八进制 或 者 十 六 进 制 反 斜 杠 序列 ， 但 是 它 的 确 使 用 了 上 面 列 
出 的 其 它 字 符 用 于 控制 字符 。 


任何 其 他 未 在 上 表 中 提 及 的 斜 字符 将 会 用 来 表示 其 本 身 。 然 而 ， 也 要 注意 不 必要 的 情况 添加 
反 斜 枉 。 因为 这 可 能 意外 地 生成 一 个 匹配 数据 结束 标记 (、， ) 或 者 空 字 符 串 (默认 为 \N ) 的 
字符 串 。 这 些 字符 串 将 在 任何 其 他 反 斜 杠 处 理 做 完 之 前 确认 。 


强烈 建议 产生 copy 数据 的 应 用 程序 将 数据 换行 符 和 回 车 分 别 转换 为 \n 和 r 序列 。 目前 ， 
可 以 由 反 斜 杠 和 回 车 代表 一 个 数据 回 车 ， 并 且 由 反 斜 杠 和 换行 符 代表 一 个 数据 换行 。 然而 ， 
这 些 表示 法 在 将 来 的 版 本 中 可 能 无 法 接受 。 copy 文件 在 不 同 操作 系统 之 间 转 移 时 ， 它 们 也 非 
常 容易 被 误解 读 ， (例如 : 从 Unix 系统 移 到 Windows 系 统 ， 或 者 反 过 来 ) 。 


copy To 将 在 每 行 的 结尾 用 一 个 Unix 风 格 的 换行 符 ("\n "o 运行 在 Windows 上 的 服务 器 会 输 
出 的 回 车 换行 符 (" \r\n")， 但 只 是 用 于 copy 到 服务 器 文件 里 ; 为 了 在 不 同 平台 之 间 一 

致 ， copY To stpouT 总 是 发 送 " \n "而 不 管 服务 器 平台 是 什么 。 copY FROM 可 以 处 理 那 些 以 回 
车 符 、 换 行 符 、 回 车 /换行 符 作 为 行 结束 的 数据 。 为 了 减少 在 数据 中 出 现 的 未 逃逸 的 新 行 或 者 
回 车 导致 的 错误 ， 如 果 输 入 的 行 结尾 不 像 上 面 这 些 符号 ， copy FRoM 会 发 出 警告 。 


CSV 格式 


这 个 格式 用 于 输入 和 输出 逗号 分 隔 数 值 ( csv ) 文 件 格 式 ， 许 多 其 它 程 序 都 用 这 个 文件 格式 ， 上 比 
如 电子 表格 。 这 个 模式 下 生成 并 识别 逗号 分 隔 的 CSV 逃 逸 机 制 ， 而 不 是 使 用 PostgreSQL 标 准 
文本 的 逃逸 模式 。 


每 条 记录 的 值 都 是 用 DELIMITER 字符 分 隔 的 。 如 果 数 值 本 身 包含 分 隔 字 符 、 QuoTE F 

符 、 NULL 字符 串 、 回 车 符 、 换 行 符 ， 那 么 整个 数值 用 quote 字符 前 级 和 后 绥 ( 包 围 )， FER 
值 里 任何 quote 字符 或 escape 字符 都 前 导 逃 逸 字符 。 你 也 可 以 使 用 FoRcE_QuoTE 在 输出 

JE NuLL 的 指定 字段 值 时 强制 引号 包围 。 


csv 格式 没有 标准 的 办 法 区 分 一 个 NuLL 值 和 一 个 空 字 符 串 。 PostgreSQL 的 copy 通过 引号 
包围 来 处 理 这 些 。 一 个 当 作 nu 输出 的 NuLL 参数 值 是 没有 引号 包围 的 ， 而 匹配 非 nue F 
符 串 的 参数 值 是 用 引号 包围 的 。 比如 ， 使 用 缺 省 设置 时 ， 一 个 NuLL 是 写 做 一 个 无 引号 包围 

的 空 字符 串 ， 而 一 个 空 字符 串 数 值 写 做 双 引 号 包围 ( "" )。 读 取 数 值 也 遵循 类 似 的 规则 。 你 
可 以 使 用 FoRcE_NoT_NULL 来 避免 为 特定 字段 进行 NuLL 上 比较 。 


因为 对 于 csv 格式 而 言 ， 反 斜 杠 不 是 特殊 字符 ， 数 据 的 结束 标志 (\，) 可 以 作为 数据 值 出 
Ro 为 了 避免 任何 可 能 的 歧 意 ， 一 个 单独 的 \. 数据 值 在 输出 中 将 被 自动 使 用 引号 包围 ; 在 
输入 中 ， 如 果 被 引号 界定 ， 那 么 将 不 会 当 作 数 据 结束 标志 。 如 果 你 要 加 载 其 它 程序 创建 的 、 
有 未 用 引号 界定 字段 的 文件 ， 并 且 其 中 含有 、, 值 ， 你 就 必须 用 引号 进行 界定 。 


Note: 在 csv 模式 下 ， 所 有 字符 都 是 有 效 的 。 一 个 被 空白 包围 的 引号 界定 数值 ， 或 者 任 
何 非 DELIMITER 字符 ， 都 会 被 包含 这 些 字符 。 如 果 你 给 csv 行 填充 空白 的 系统 里 导 和 人 数 
据 到 定 长 字段 ， 那 么 可 能 会 导致 错误 。 如 果 出 现 这 种 情况 ， 你 可 能 需要 先 义理 一 

下 csv 文件 ， 删 除 结尾 空白 ， 然 后 再 向 PostgreSQL 里 导 和 数据。 





Note: CSV 格 式 可 以 识别 和 生成 引号 包围 的 回 车 和 换行 的 CSV 文 件 。 因 此 这 些 文件 并 不 
像 文本 模式 的 文件 那样 严格 地 每 条 记录 一 行 。 


Note: 许多 程序 生成 奇怪 的 并 且 有 时 候 不 正确 的 CSV 文 件 ， 所 以 这 个 文件 格式 更 像 一 种 
惯用 格式 ， 而 不 是 一 种 标准 。 因此 你 可 能 碰 到 一 些 不 能 使 用 这 个 机 制 输入 的 文件 ， 
而 copy 也 可 能 生成 一 些 其 它 程序 不 能 处 理 的 文件 。 


二 进 制 格式 


binary 形式 的 选项 会 使 得 所 有 的 数据 被 存储 / 读 作 二 进 制 格式 而 不 是 文本 。 IEMA 

和 csv 格式 的 要 快 一 些 ， 但 是 一 个 二 进 制 格式 文件 在 机 器 架构 和 PostgreSQL 版 本 之 间 的 可 移 
植 性 比较 差 。 另外 ， 二 进 制 格式 是 对 数据 类 型 有 一 定 要 求 的 ; 例如 ， 不 能 从 smallint 列 中 输 
出 二 进 制 数据 并 将 二 进 制 数 据 读 入 integer 列 ， 尽 管 在 文本 格式 下 那 会 运行 良好 。 


binary 文件 格式 包含 一 个 文件 头 ，0 或 更 多 包含 行 数据 的 元 组 ， 以 及 一 个 文件 尾 。 头 和 数据 
按照 网 络 字 节 顺序 。 


Note: 7.4 版 本 之 前 的 PostgreSQL 版 本 使 用 的 是 不 同 的 二 进 制 文件 格式 。 


文件 头 
文件 头 由 15 个 字 节 的 固定 域 组 成 ， 后 面 跟着 一 个 变 长 的 头 扩展 区 。 固 定 域 是 : 
pe 


11 字 节 的 序列 pecopy\n\377\r\n\o 一 ， 请 注意 字 节 需 是 签名 必须 的 一 部 分 。 (使 用 这 个 签名 
是 为 了 能 够 很 容易 看 出 文件 是 否 已 经 被 一 个 非 8 位 安全 的 转换 器 给 破坏 了 。 这 个 签名 会 被 行 尾 
转换 过 滤器 、 删 除 字 节 需 、 删 除 高 位 、 奇 偶 变 化 而 改变 。) 


32 位 整数 捧 码 表示 该 文件 格式 的 重要 方面 。 位 是 从 0(LSB) 到 31(MSB) 编码 的 ， 请 注意 这 个 
域 是 以 网 络 字 节 顺序 存储 的 (高 位 在 前 )， 后 继 的 整数 都 是 如 此 。 位 16-31 是 保留 用 做 关键 文件 
格式 信息 的 ; 如 果 阅 读 器 发 现 一 个 不 认识 的 位 出 现在 这 个 范围 内 ， 那 么 它 应 该 退出 。 位 0-15 
都 保留 为 标志 向 后 兼容 的 格式 使 用 ; 阅读 器 可 以 忽略 这 个 范围 内 的 不 认识 的 位 。 目前 只 定义 
了 一 个 标志 位 ， 而 其 它 的 必须 是 需 : 

Bit 16 

如 果 为 1， 那 么 在 数据 中 包括 了 OIDS ; 如 果 为 0， 则 没有 。 

头 扩 展 范 围 长 度 

32 位 整数 ， 以 字 节 计 的 头 剩 余 长 度 ， 不 包括 自身 。 目前 ， 它 是 需 ， 后 面 紧 跟 第 一 条 记录 行 。 
对 该 格式 的 更 多 修改 都 将 允许 额外 的 数据 出 现在 头 中 。 阅读 器 应 该 忽略 任何 它 不 知道 该 如 何 
处 理 的 头 扩 展 数据 。 

头 扩 展 数据 用 来 保存 自 定义 数据 序列 块 。 这 个 标志 域 无 意 告 诉 阅读 器 扩展 区 的 内 容 是 什么 。 
头 扩展 的 具体 设计 内 容留 给 以 后 的 版 本 使 用 。 

这 样 设计 就 允许 向 后 兼容 的 头 扩 展 (增加 头 扩 展 块 或 设置 低位 序 标 志 位 ) 以 及 非 向 后 兼容 的 修改 
(设置 高 位 标志 位 以 标识 这 样 的 修改 ， 并 且 根 据 需要 向 扩展 区 域 增 加 支持 数据 )。 


行 记 录 
每 条 行 都 以 一 个 16 位 整数 计数 开头 ， 该 计数 是 行 中 字段 的 数目 (目前 ， 在 一 个 表 里 的 每 行 都 有 
相同 的 计数 ， 但 可 能 不 会 永远 这 样 )。 然后 后 面 不 断 出 现行 中 的 各 个 字段 ， 字 段 先 是 一 个 32 位 


的 长 度 字 ， 后 面 跟着 很 多 的 字段 数据 。 长 度 字 并 不 包括 自己 ， 并 且 可 以 为 需 。 一 个 特例 
是 : -1 表示 一 个 NULL 字 段 值 。 在 NULL 情 况 下 ， 后 面 不 会 跟着 数值 字 节 。 


在 数据 域 之 间 没 有 对 齐 填充 或 者 任何 其 它 额 外 的 数据 。 


目前 ， 一 个 二 进 制 格式 文件 里 的 所 有 数据 值 都 假设 是 二 进 制 格式 的 (格式 代码 为 一 )。 预计 将 
来 的 扩展 可 能 增加 一 个 头 域 ， 人 允许 为 每 个 字段 声明 格式 代码 。 


为 了 判断 实际 行 数据 的 正确 二 进 制 格式 ， 你 应 该 阅读 PostgreSQL 源 代码 ， 特 别 是 该 字段 数据 
类 型 的 *send 和 *recv WR (这 些 函 数 可 以 在 源 代码 的 src/backend/utils/adt/ 目录 找到 )。 


如 果 在 文件 中 包括 了 OIDs， 那 么 该 OID 域 立即 跟 在 字段 计数 字 后 面 。 它 是 一 个 普通 的 字段， 
只 不 过 它 没有 包括 在 字段 计数 。 但 它 包括 长 度 字 ， 这 样 就 允许 方便 的 处 理 4 字 节 和 8 字 节 的 
OIDs， 并 且 如 果 某 个 家 伙 人 允许 OIDs 是 可 选 的 话 ， 那 么 还 可 以 把 OIDs 显 示 成 空 。 

文件 尾 

文件 尾 包 括 保 存 着 -1 的 一 个 16 位 整数 字 。 这 样 就 很 容易 与 一 条 行 的 域 计 数字 相 区 分 。 


如 果 一 个 域 计 数字 既 不 是 -1 也 不 是 预期 的 字段 的 数目 ， 那 么 闵 读 器 应 该 报错 。 这 样 就 提供 了 对 
丢失 与 数据 同步 的 额外 检查 。 


例子 
下 面 的 例子 把 一 个 表 拷 由 到 客户 端 ， 使 用 坚 线 (| ) 作 为 域 分 隔 符 : 


COPY country TO STDOUT (DELIMITER '|'); 


从 文件 中 找 贝 数据 到 country RA : 


COPY country FROM '/usri/proj/bray/sql/country_data'; 


把 'A' 开 头 的 国家 名 拷贝 到 一 个 文件 里 : 
COPY (SELECT * FROM country WHERE country_name LIKE 'A%') TO '/usr1/proj/bray/sql/a_list_ 
i 


可 以 通过 将 输出 数据 通过 管道 方式 重 定向 至 一 个 外 部 压缩 程序 的 方式 将 数据 拷贝 至 一 个 压缩 
文件 中 : 





COPY country TO PROGRAM 'gzip > /usri/proj/bray/sql/country_data.gz'; 


下 面 是 一 个 可 以 从 ston 中 拷贝 数据 到 表 中 的 例子 : 


AF AFGHANISTAN 
AL ALBANIA 

DZ ALGERIA 

ZM ZAMBIA 

ZW ZIMBABWE 


注意 ， 每 行 里 的 空白 实际 上 是 一 个 水 平 制 表 符 。 


下 面 的 是 同样 的 数据 ， 以 二 进 制 形 式 输 出 。 这 些 数据 是 用 Unix 工 具 od -c 过 滤 之 后 输出 的 。 
该 表 有 三 个 字段 ; 第 一 个 是 char(2) ， 第 二 个 是 text , 第 三 个 是 integer o 所 有 的 行 在 第 
三 个 域 都 是 一 个 null 值 。 


0000000 R G C 0 P Y \n 377 \r \n \O \O \O \O \O \O 
0000020 \O \O \O \0 003 \O \O \O 002 A F \O \O \O 013 A 
0000040 F G H A N I S il A N 377 377 377 377 NO 003 
0000060 \O \O \O 002 A L \O \O \O 007 A L B A N I 
0000100 A 377 377 377 377 \0 003 \O \O \O 002 D Z \O \O \O 
0000120 007 A L G E R 工 A 377 377 377 377 \0 003 \O \O 
0000140 \O 002 Z M \O \O \O 006 Z A M B I A 377 377 
0000160 377 377 \0 003 \O \O \O 002 Z W \0 \O \O \b Z I 
0000200 M B A B W E 377 377 377 377 377 377 


兼容 性 
SQL 标准 里 没有 copy 语句 。 


PostgreSQL9.0 以 前 使 用 下 面 的 语法 ， 现 在 仍然 支持 : 





COPY _table_name_ [ ( _column_name_ [, ...] ) ] 
FROM { '_filename_' | STDIN } 
[ [ WITH ] 
BINARY ] 
OIDS ] 


DELIMITER [ AS ] '_delimiter_' ] 
NULL [ AS ] '_null string_' ] 


Sit i fe Pe 





CSV [ HEADER ] 
[ QUOTE [ AS ] '_quote_' ] 
[ ESCAPE [ AS ] '_escape_' ] 
[ FORCE NOT NULL _column_name_ [, ...] ] ] ] 
COPY { _table_name_ [ ( _column_name_ [, ...] ) ] | ( _query_ ) } 
TO { '_filename_' | STDOUT } 
[ [ WITH ] 
[ BINARY ] 
[ OIDS ] 


[ DELIMITER [ AS ] '_delimiter_' ] 

[ NULL [ AS ] '_null string_' ] 

[ CSV [ HEADER ] 

[ QUOTE [ AS ] '_quote_' ] 

[ ESCAPE [ AS ] '_escape_' ] 

[ FORCE QUOTE { _column_name_ [, ...] | * } ] ] ] 


请 注意 : 在 这 个 语法 中 ， BINARY 和 csv 是 作为 独立 的 关键 字 ， 而 不 是 作为 Format 选项 的 一 
个 参数 。 


PostgreSQL7.3 以 前 使 用 下 面 的 语法 ， 现 在 仍然 支持 : 


COPY [ BINARY ] _table_name_ [ WITH OIDS ] 
FROM { '_filename_' | STDIN } 
[ [USING] DELIMITERS '_delimiter_' ] 
[ WITH NULL AS '_null string_' ] 


COPY [ BINARY ] _table_name_ [ WITH OIDS ] 
TO { '_filename_' | STDOUT } 
[ [USING] DELIMITERS '_delimiter_' ] 
[ WITH NULL AS '_null string_' ] 


CREATE AGGREGATE 


Name 


CREATE AGGREGATE -- © — DNAR ERA 


Synopsis 


CREATE AGGREGATE _name_ ( _input_data_type_[, ... ] ) ( 
SFUNC = _sfunc_, 
STYPE = _state_data_type 
[ , FINALFUNC = _ffunc_ ] 
[ , INITCOND = _initial_condition_ ] 
[ , SORTOP = _sort_operator_ ] 








) 
or the old syntax 


CREATE AGGREGATE _name_ ( 
BASETYPE = _base_type_, 
SFUNC = _sfunc_, 
STYPE = _state_data_type 
[ , FINALFUNC = _ffunc_ ] 
[ , INITCOND = _initial_condition_ ] 
[ , SORTOP = _sort_operator_ ] 





CREATE AGGREGATE 7EL—S PHARM, 一 些 常用 的 聚集 函数 已 经 包含 在 基础 软件 包 里 
T ; Section 9.20 里 有 文档 说 明 。 如 果 你 需要 定义 一 个 新 类 型 或 需要 一 个 还 没有 提供 的 聚集 
PYM, iX Bt CREATE AGGREGATE 便 可 派 上 用 场 。 


如 果 给 出 了 一 个 模式 的 名 字 ( 比 如 CREATE AGGREGATE myschema.myagg ... )， 那 么 该 聚集 酚 数 是 
在 指定 模式 中 创建 的 。 否则 它 是 在 当前 模式 中 创建 的 。 


一 个 聚集 琅 数 是 用 它 的 名 字 和 输入 数据 类 型 来 标识 的 。 同一 模式 中 如 果 两 个 聚集 处 理 的 输入 
数据 不 同 ， 它 们 可 以 有 相同 的 名 字 。 一 个 聚集 图 数 的 输入 数据 类 型 必须 和 所 有 同一 模式 中 的 
普通 函数 的 名 字 和 输入 类 型 不 同 。 


一 个 聚集 函数 是 用 一 个 或 两 个 普通 画 数组 成 的 : 一 个 状态 转换 男 数 _sfunc 和 一 个 可 选 的 最 
终 计 算 画 数 ffun 。 它们 是 这 样 使 用 的 : 


_sfunc_( internal-state, next-data-values ) ---> next-internal-state 
_ffunc_( internal-state ) ---> aggregate-value 


PostgreSQL 创 建 一 个 类 型 为 _stype_ 的 临时 变量 。 它 保存 这 个 聚集 的 当前 内 部 状态 。 对 于 每 
ie 入 数据 条 目 ， 都 调用 状态 转换 函数 计算 内 部 状态 值 的 新 数值 。 在 处 理 完 所 有 数据 后 ， 调 

一 次 最 终 义理 本 数 以 计算 聚集 的 返回 值 。 如 果 没 有 最 终 义理 函 数 ， 则 将 最 后 的 状态 值 当做 
Sa 


—TRR WBE Ete- DRR, WHEARBKA GNM a. 这 个 值 是 作为 一 个 类 
型 为 text 的 字段 存储 在 数据 库 里 的 ， 不 过 它们 必须 是 状态 值 数 据 类 型 的 合法 的 外 部 表现 形 
式 的 常量 。 如 果 没 有 提供 状态 ， 那 么 状态 值 初始 化 为 NULL 。 


如 果 该 状态 转换 函数 被 定义 为 "strict"， 那 么 就 不 能 用 NULL 输入 调用 它 。 此 时 ， 聚集 的 执行 
如 下 所 述 。 带 有 任何 NULL 输入 值 的 行将 被 忽略 (不 调用 此 函数 并 且 保 留 前 一 个 状态 值 )。 如 
果 初 始 状态 值 是 NULL ， 那 么 在 第 一 个 含有 非 NULL 值 的 行 上 ， 使 用 第 一 个 参数 值 蔡 换 状态 
值 ， 然后 状态 转换 男 数 在 随后 所 有 的 含有 非 NULL 值 的 行 上 调用 。 这 样 做 让 比较 容易 实现 
像 max 这 样 的 聚集 。 请 青 注 意 这 种 行为 只 是 当 state_data_type 与 input_data_type 相同 的 
时 候 才 表现 出 来 。 如 果 这 些 类 型 不 同 ， 你 必须 提供 一 个 非 NULL 的 初始 条 件 或 者 使 用 一 

非 "strict" 的 状态 转换 男 数 。 





如 果 状 态 转 换 回 ae a 那么 它 将 无 条 件 地 在 每 个 输入 行 上 调用 ， 并 且 必 须 自行 
处 理 NULL 输入 和 NULL 转换 值 ， 这 样 就 允许 聚集 的 作者 对 聚集 中 的 NULL 有 完全 的 控制 。 


如 果 最 终 转 换 画 数 定义 为 "strict"， 那 么 如 果 最 终 状 态 值 是 NULL 时 就 不 会 调用 它 ; 而 是 自动 输 
出 一 一 个 NULL 结果 。 (这 才 是 Strict 函数 的 正常 特征 。 ) 不 管 是 那 种 | 青 况 ， 最 终 处 理 贺 数 可 以 
自由 选择 是 否 返 回 NULL. 比如 ， avg 的 最 终 义 理 函 数 在 需 输 入 记录 时 就 会 返回 NULL 。 


行为 类 似 MIN 或 max 的 聚集 有 时 候 可 以 优化 为 使 用 素 引 ， 而 不 用 扫描 每 个 输入 行 。 如 果 这 
个 聚集 可 以 如 此 优化 ， 则 用 一 个 排序 操作 符 标 识 它 。 这 里 基本 的 要 求 是 聚集 必须 以 操作 符 兴 
纳 出 来 的 排序 顺序 生成 第 一 个 元 素 ; 换 句 话说 : 


SELECT agg(col) FROM tab; 


必须 等 于 : 


SELECT col FROM tab ORDER BY col USING sortop LIMIT 1; 


更 多 的 假设 是 聚集 忽略 NULL 输入 ， 并 且 只 有 在 输入 没有 非 空 数值 的 时 候 ， 它 才 生 成 NULL 结 
果 。 通常 ， 数 据 类 型 的 ait; 操作 符 是 min 的 适用 排序 操作 符 ， 而 egt; 是 max 的 适用 操 
VE. 请 注意 ， 除 非 声明 的 操作 符 是 B-tree 索引 操作 符 类 的 "小 于 "或 者 "大 于 "策略 号 ， 否则 
这 种 优化 将 不 会 生效 。 


要 创建 聚集 函数 ， 你 必须 具有 相关 参数 类 型 、 状 态 类 型 和 返回 类 型 的 使 用 权限 ， 也 必须 具有 
转换 函数 和 最 终 函 数 的 执行 权限 。 


参数 


_name_ 


要 创建 的 聚集 图 数 名 (可 以 有 模式 修饰 ) 。 


input_data_type 





该 聚集 男 数 要 处 理 的 输入 数据 类 型 。 要 创建 一 个 需 参 数 聚 集 辑 数 ， 可 以 使 用 * 代 蔡 输入 数据 
类 型 列表 。 ( count(* ) 就 是 这 种 聚 R SK AA — 个 实例 。 ) 


_base_type_ 


在 以 前 的 CREATE AGGREGATE 语法 中 ， 输 入 数据 类 型 是 通过 basetype 参数 指定 的 ， 而 不 是 写 在 
聚集 的 名 称 之 后 。 需要 注意 的 是 这 种 以 前 语法 仅 人 允许 一 个 输入 参数 。 要 创建 一 个 需 参 数 聚 集 
HŽ, 可 以 将 basetype 指定 为 "ANY" (而 不 是 )。 


_sfunc_ 


将 在 每 一 个 输入 行 上 调用 的 状态 转换 函数 的 名 称 。 对 于 有 _N_ 个 参数 的 聚集 画 

数 ， _sfunc_ 必须 有 _+1_ 个 参数 ， 其 中 的 第 一 个 参数 类 型 为 _state_data_type” ， 其 余 的 匹 
配 已 声 明 的 输 和 范 数 必须 返回 一 个 State_data_type 类 型 的 值 。 这 个 函数 接受 
当前 状态 值 和 当前 输入 数据 ， 并 返回 下 个 状态 值 。 








state_data_type 





聚集 的 状态 值 的 数据 类 型 。 
_ffunc_ 
在 转换 完 所 有 输入 行 后 调用 的 最 终 处 理 函 数 ， 它 计算 聚集 的 结果 。 WWMM meV TRH 


为 _state_data type 的 参数 。 聚集 的 输出 数据 类 型 被 定义 为 此 男 数 的 返回 类 型 。 如 果 没 有 
声明 frun. 则 使 用 聚集 结果 的 状态 值 作为 聚集 的 结果 ， 且 输出 类 型 为 _state datatype. 








_initial_condition_ 


状态 值 的 初始 设置 ( 值 )。 它 必须 是 一 个 state_data_type 类 型 可 以 接受 的 文本 常量 值 。 如 果 
没有 声明 ， 状 态 值 初始 为 NULL. 





_sort_operator_ 


用 于 MIN 或 max 类 型 聚集 的 排序 操作 符 。 这 个 只 是 一 个 操作 符 名 (可 以 有 模式 修饰 )。 这 个 操 
作 符 假设 接受 和 聚集 一 样 的 输入 数据 类 型 。 


CREATE AGGREGATE 的 参数 可 以 以 任何 顺序 书写 ， 而 不 只 是 上 面 显示 的 顺序 。 


例子 


参见 Section 35.10。 


CREATE AGGREGATE 是 PostgreSQL 语 言 的 扩展 。 SQL*PHRAHEA PRELREBAHD 


Ab 
Abo 


一 


参见 


ALTER AGGREGATE, DROP AGGREGATE 


CREATE CAST 


Name 


CREATE CAST -- 定义 一 个 用 户 定义 的 转换 


Synopsis 


CREATE CAST (_source_type_ AS _target_type_) 
WITH FUNCTION _function_name_ (_argument_type_ [, ...]) 
[ AS ASSIGNMENT | AS IMPLICIT ] 





CREATE CAST (_source_type_ AS _target_type_) 
WITHOUT FUNCTION 
[ AS ASSIGNMENT | AS IMPLICIT ] 





CREATE CAST (_source_type_ AS _target_type_) 
WITH INOUT 
[ AS ASSIGNMENT | AS IMPLICIT ] 





CREATE CAST 定义 一 个 新 的 转换 。 一 个 转换 说 明 如 何在 两 个 类 型 之 间 进 行 转 换 。 比 如 : 


SELECT CAST(42 AS floats); 


通过 调用 前 面 指 定 的 函数 闻 整 数 常 量 42 转 化 为 floats 类 型 ， 即 float8(int4) 的 形式 。 (如 
果 没 有 定义 合适 的 转换 , 转换 将 失败 。) 


两 种 形式 是 二 进 制 可 强制 转换 的 ， 这 意味 转换 可 以 在 不 调用 画 数 的 情况 下 自由 执行 。 这 要 求 
相应 的 值 使 用 相同 的 内 部 表示 。 例 如 ， text 和 varchar 形式 都 是 二 进 制 可 强制 转换 的 两 种 类 
型 。 二 进 制 可 可 强制 转换 未 必 是 一 个 对 称 的 关系 。 例 如 : xm 到 text 的 转换 可 以 在 当前 的 处 
理 中 可 直接 执行 。 但 相反 的 方向 的 转换 需要 一 个 函数 来 执行 ， 至 少 一 个 语法 检查 。 (两 种 二 
进 制 可 强制 转换 的 形式 也 被 称 为 二 进 制 兼容 。) 


您 可 以 定义 一 个 转换 为 使 用 wITH Inout 语法 的 WO conversion cast 转 化 转换 。 一 个 |/O 转 化 转 
换 通 过 调用 原 数据 库 类 型 的 输出 男 数 来 执行 ， 并 将 结果 传 给 目标 数据 类 型 的 输入 回 数 。 


缺 省 时 ， 只 有 在 明确 要 求 转换 的 情况 下 才 调 用 一 个 转换 ， 也 就 是 一 个 明确 的 casT(``_x_ AS 
_typename ) 或 XS e typename. 转换 要 求 。 





如 果 转 换 被 标记 为 As asstcnment ， 那 么 在 给 目标 数据 类 型 的 字段 赋值 的 时 候 ， 可 以 隐 含 调用 
它 。 上 比如， 假设 foo.fa 是 一 个 类 型 为 text 的 字段 ， 那么 : 


INSERT INTO foo (f1) VALUES (42); 


如 果 从 integer 类 型 到 text 类 型 的 转换 标记 为 As ASSIGNMENT ， 上 面 的 这 句 就 被 人 允许， 否则 
就 不 允许 。 (通常 用 术语 assignment cast 来 描述 这 种 转换 。) 


如 果 转 换 标 记 了 As IMPLICIT ， 那 么 可 以 在 任何 环境 下 调用 ， 不 管 是 作业 还 是 在 一 个 内 部 表达 
式 中 。 (我 们 通常 使 用 术语 implicit cast 来 描述 这 种 转换 。 ) 例如 ， 考 虑 下 面 这 个 查询 : 


SELECT 2 + 4.0; 


解析 器 初始 时 标记 常量 分 别 为 integer 和 numeric. 在 系统 目录 中 没有 integer + 

numeric 的 操作 符 ， 但 是 有 一 个 integer + numeric 操作 符 。 若 integer 到 numeric 的 转换 
是 可 以 执行 的 并 且 标 记 为 As IMPLICIT 一 则 该 查询 将 会 成 功 执行 。 解析 器 将 使 用 隐 性 的 转 
换 并 按 所 写 的 查询 生成 结果 : 


SELECT CAST ( 2 AS numeric ) + 4.0; 


现在 ， 目 录 提 供 了 一 个 从 numeric 到 integer 的 转换 。 如 果 那 个 转换 标记 了 as IMPLICIT 一 
而 它 并 不 是 一 然后 解析 器 会 面临 对 选择 上 面 的 解释 还 是 选择 numeric 常量 到 integer 的 转 
ie, 然后 应 用 integer + integer 操作 符 。 缺乏 选择 哪 一 种 处 理 方式 的 足够 信息 ， 系 统 会 
放 奔 执行 并 返回 查询 是 模棱两可 的 信息 。 两 种 转换 中 仅 有 一 个 是 缺 省 的 方式 正 是 我 们 设计 的 
方式 ， 我 们 让 解析 器 更 偏向 于 将 numeric -和 - integer 的 混合 表达 式 的 结果 视 作 numeric ; 
没有 关于 那 方 面 的 内 置信 息 。 


在 是 否 将 转换 标记 为 隐 性 的 问题 上 保守 一 些 是 明智 的 。 过 于 丰富 的 隐 含 转换 路 径 会 导致 
PostgreSQL 选 择 让 人 奇怪 的 命令 解析 ， 或 者 是 完全 不 能 解析 命令 ， 因 为 存在 多 个 可 能 的 解 
it. 一 个 好 的 规则 是 ， 只 有 在 同一 个 通用 类 型 范畴 里 面 的 那些 可 以 保留 转换 信息 的 类 型 之 间 
才 标 记 为 可 隐 含 调用 转换 。 比如 ， 从 int2 到 inta 可 以 合理 地 标记 为 隐 含 转换 ， 但 是 

从 floats 到 int4 也 许 应 该 标记 为 赋值 转换 。 跨 类 型 范围 的 转换 ， 比 如 text 到 int4 ， 只 
能 明确 地 转换 。 





Note: 有 时 ， 有 必要 为 了 可 用 性 和 标准 支持 的 原因 在 一 组 类 型 中 提供 多 个 隐 含 转换 ， 导 
致 上 述 无 法 避免 的 模棱两可 的 问题 。 解析 器 有 一 个 基于 type categories 和 preferred types 
的 启发 式 函 数 回 调 功 能 ， 有 助 于 在 这 种 情况 下 提供 所 期 望 的 行为 。 参半 CREATE TYPE 
获取 更 多 详细 信息 。 

















为 了 能 够 创建 一 个 转换 ， 您 必须 是 源 或 者 目标 数据 类 型 的 所 有 者 。 为 了 创建 一 个 强制 二 进 制 
的 转换 ， 您 必须 是 超级 用 户 。 (做 这 个 约束 的 原因 是 错误 的 二 进 制 可 强迫 转换 转换 可 以 很 容 
易 让 服务 器 骨 溃 。 ) 


参数 


_source_type_ 


转换 的 源 数 据 类 型 。 

_target_type_ 

转换 的 目标 数据 类 型 。 

_function_name_ ( _argument_type_ [, ...]) 

用 于 执行 转换 的 函数 。 RMEMBTUEARA SEH. 如 果 它 没有 用 模式 名 修饰 ， 那么 


该 本 数 将 从 模式 搜索 路 径 中 找 出 来 。 画 数 的 结果 数据 类 型 必须 匹配 转换 的 目标 类 型 。 它 的 参 
数 在 下 面 讨论 。 


WITHOUT FUNCTION 


表明 源 类 型 是 对 目标 类 型 是 二 进 制 可 强制 转换 的 ， 所 以 没有 画 数 需要 执行 此 转换 。 


WITH INOUT 


表明 转换 是 I/O 转 换 ， 通 过 调用 源 数 据 类 型 的 输出 画 数 来 执行 ， 并 将 结果 传 给 目标 数据 类 型 的 
Hy AR 


AS ASSIGNMENT 


表示 转换 可 以 在 赋值 模式 下 隐 含 调用 。 


AS IMPLICIT 
表示 转换 可 以 在 任何 环境 里 隐 含 调用 。 


转换 实现 函数 可 以 有 一 到 三 个 参数 。 第 一 个 参数 的 类 型 必须 与 转换 的 源 类 型 相同 的 ， 或 可 以 
从 转换 的 源 类 型 二 进 制 可 强制 转换 的 。 第 二 个 参数 ， 如 果 存 在 ， 必 须 是 integer 类 型 ; 它 接 
收 这些 与 目标 类 型 相关 联 的 类 型 修饰 符 ， 或 者 若 什 么 都 没有 则 是 -1。 第 三 个 参数 ， 如 果 存 
在 ， 必 须 是 boolean 类 型 ; 若 转换 是 一 个 显 式 类 型 转换 则 会 收 到 true, BÆ false o 
《奇怪 的 是 ， 在 一 些 情况 下 SQL 标准 要 求 对 显 式 和 隐 式 转换 的 不 同 表 现 。 我 们 不 推荐 您 设计 
自己 的 数据 类 型 ， 这 很 重要 。 ) 


一 个 转换 图 数 的 返回 类 型 必须 是 与 转换 的 目标 类 型 相同 或 者 对 转换 的 目标 类 型 二 进 制 可 强制 
转换 。 


通常 ， 一 个 转换 必须 有 不 同 的 源 和 目标 数据 类 型 。 然而 ， 若 有 多 于 一 个 参数 的 转换 实现 图 
数 ， 则 允许 声明 一 个 有 相同 的 源 和 目标 类 型 的 转换 。 这 用 于 表示 系统 目录 中 的 特定 类 型 的 长 
sail, 命名 的 函数 用 于 强制 一 个 该 类 型 的 值 为 第 二 个 参数 给 出 的 类 型 修饰 符 值 。 


如 果 一 个 类 型 转换 的 源 类 型 和 目标 类 型 不 同 ， 并 且 接 收 多 于 一 个 参数 ， 它 就 表示 从 一 种 类 型 
转换 成 另外 一 种 类 型 只 用 一 个 步骤 ， 并 且 同 时 实施 长 度 转换 。 如 果 没 有 这 样 的 项 可 用 ， 那么 
转换 成 一 个 使 用 了 类 型 修饰 词 的 类 型 将 涉及 两 个 步 又， 一 个 是 在 数据 类 型 之 间 转 换 ， 另外 一 
个 是 施加 修饰 词 指 定 的 转换 。 


对 域 类 型 的 转换 目前 没有 作用 。 转 换 一 般 是 针对 域 相 关 的 所 属 数据 类 型 。 
AN = 

7h Ss 

使 用 DROP CAST HIRA > ELAI HR. 


请 注意 ， 如 果 希 望 能 双向 转换 类 型 ， 那 么 你 需要 明确 地 定义 两 个 方向 的 转换 。 


通常 不 需要 创建 用 户 定义 类 型 与 标准 字符 串 类 型 之 间 的 转换 

( text, varchar 和 char(`、n_ )， 以 及 被 定义 为 字符 串 的 范畴 的 用 户 定义 的 类 型 )。 
PostgreSQL 为 此 提供 自动 JO 转 换 转 换 。 字符 串 类 型 的 自动 转换 可 以 认为 是 分 配 转 换 ， 而 来 
自 字 符 串 的 自动 转换 是 唯一 显 式 的 。 您 可 以 通过 声明 自己 的 转换 蔡 换 系统 的 自动 转换 ， 但 
是 ， 通 常 这 么 做 的 唯一 原因 是 ， 你 想 让 转化 比 标准 唯一 分 配 或 者 唯一 显 式 设 置 更 容易 调用 。 
另 一 个 可 能 的 原因 是 你 想 让 转化 变现 的 不 同 于 类 型 的 I/O 画 数 ; 但 是 最 重要 的 是 您 应 该 反复 考 
虑 这 是 否 是 一 个 好 主意 。 (少量 内 部 类 型 确实 对 转换 有 不 同 的 性 能 要 求 ， 大 部 分 是 因为 要 求 
SQL 标 准 。) 


在 PostgreSQL7.3 之 前 ， 每 个 与 数据 类 型 名 称 相同 的 函数 会 返回 那个 数据 类 型 ， 并 取 一 个 不 同 
类 型 的 参数 的 函数 ， 自 动 成 为 一 个 转换 画 数 。 在 面临 模式 引入 时 约定 已 取消 并 且 能 代表 系统 
表 中 的 二 进 制 可 强制 转换 。 内 置 的 转换 功能 仍然 遵循 这 种 命名 模式 ， 但 是 他 们 必须 像 系 统 

表 pg_cast 中 的 转换 一 样 显示 。 


虽然 不 是 必须 的 ， 但 是 还 是 建议 你 遵循 旧 的 命名 类 型 转换 实现 函数 的 习惯 ， 也 就 是 说 ， BA 
名 和 目标 数据 类 型 同名 。 许多 用 户 习 惯 于 使 用 函数 风格 的 表示 法 _typenane_( _x_ ) 来 做 数据 
类 型 转换 。 这 种 表示 法 恰好 就 是 调用 类 型 转换 实现 函数 ， 这 样 并 不 会 被 当 作 一 种 类 型 转换 而 
被 特殊 看 待 。 如 果 你 的 转换 画 数 没有 按照 这 种 传统 命名 ， 那 么 你 就 会 让 用 户 很 奇怪 。 因为 
PostgreSQL 人 允许 同名 不 同 参数 的 范 数 重 载 ， 因 此 同时 存在 多 个 从 不 同类 型 向 同样 类 型 转换 的 
同名 转换 画 数 一 点 问题 都 没有 。 


Note: 事实 上 前 面 所 述 是 过 分 简化 的 : CAPR PRRs MRA Ee THR 
求 而 不 需要 将 其 匹配 为 一 个 实际 函数 。 如 果 画 数 调用 name (x ) 不 准确 匹配 任何 现 有 
函数 ， 但 是 _name 是 一 个 数据 类 型 的 名 称 并 且 pg_cast 从 x 类 型 提供 了 一 个 二 进 制 
可 强制 转换 到 这 个 类 型 ， 则 调用 会 被 解析 为 一 个 二 进 制 可 强制 转换 。 即使 是 没有 任何 转 
换 函 数 ， 也 设计 了 一 种 异常 ， 二 进 制 可 强制 转换 可 以 通过 使 用 函数 语法 来 调用 ， le 
的 ， 若 无 pg_cast 条 目 ， 但 转换 会 到 达 或 者 来 自 一 个 字符 串 类 型 ， 调用 将 会 被 视 为 一 个 
IO 转换 转换 。 该 异常 情况 下 允许 MO 转换 转换 通过 使 用 画 数 语法 来 调用 。 








Note: 也 还 有 一 种 异常 中 的 异常 : 从 复合 数据 类 型 向 字符 串 类 型 的 /QO 转换 不 能 使 用 函数 
语法 ， 必 须 设 计 为 精确 的 转换 语法 (cast 或 :: 声明 ) 增加 这 种 异常 是 因为 在 介绍 过 
自动 执行 的 MO 转换 后 ， 用 户 会 发 现在 一 个 函数 或 是 字段 参考 时 很 容易 误 执 行 一 个 类 似 的 
转换 。 





例子 
为 了 从 类 型 bigint 到 类 型 int4 创建 一 个 指派 映射 要 通过 使 用 辑 数 int4(bigint) : 


CREATE CAST (bigint AS int4) WITH FUNCTION int4(bigint) AS ASSIGNMENT; 


(这 个 转换 在 系统 中 已 经 预先 定义 了 。 ) 


兼容 性 


CREATE CAST 指使 符合 SQL 标 准 ， 除 了 SQL 没 有 为 二 进 制 可 强制 转换 类 型 或 者 实现 图 数 的 额外 
参数 来 实现 功能 。 as IMPLICIT 也 是 一 个 PostgreSQL 扩 展 。 


参见 


一 


CREATE FUNCTION、CREATE TYPE 和 DROP CAST 


CREATE COLLATION 


Name 


CREATE COLLATION -- 定义 一 个 新 的 排序 规则 


Synopsis 


CREATE COLLATION _name_ ( 
[ LOCALE = _locale_, ] 
[ LC_COLLATE = _lc_collate_, ] 
[ LC_CTYPE = _lc_ctype_ ] 


) 
CREATE COLLATION _name_ FROM _existing_collation_ 


摘 述 

CREATE COLLATION 使 用 指定 操作 系统 中 的 编码 设置 定义 一 个 新 的 排序 规则 ， 或 是 从 一 个 已 存 
在 的 排序 规则 中 进行 复制 。 

要 创建 一 个 排序 规则 ， 你 必须 在 目标 模式 中 有 cREATE 权限 。 


参数 


_name_ 


排序 规则 的 名 称 。 排 序 规则 的 名 称 可 以 有 模式 修饰 符 。 如 果 没 有 ， 则 排序 规则 是 定义 在 当前 
模式 中 。 另外 排序 规则 在 指定 的 模式 中 名 称 必须 是 唯一 的 。 (系统 目录 中 人 允许 含有 不 同 内 部 
字符 编码 的 相同 排序 规则 名 ， 如 果 是 数据 库 的 编码 不 相 匹 配 ， 则 它们 会 被 忽略 。) 

_locale_ 

这 是 一 次 性 设置 Lc_coLLATE 和 Lc_cTYPE 的 快捷 方式 。 如 果 你 定义 了 这 个 变量 ， 就 不 能 定义 
其 他 两 个 变量 了 。 

_le_collate_ 

使 用 指定 操作 系统 中 的 字符 编码 来 设置 Lc_coLLATE o 字符 编码 对 当前 数据 库 来 说 必须 是 可 使 
用 的 。 (参见 CREATE DATABASE 了 解 更 精确 的 信息 。) 


_lc_ctype_ 


使 用 指定 操作 系统 中 的 字符 编码 来 设置 Lc_cTYPE 。 字符 编码 对 当前 数据 库 来 说 必须 是 可 使 用 
的 。 (参见 CREATE DATABASE 了 解 更 精确 的 信息 。) 


_existing_collation_ 


复制 已 存在 的 排序 规则 。 新 的 排序 规则 将 和 已 存在 的 规则 有 相同 的 属 生 ， 但 它 是 一 个 独立 的 
对 像 。 


MS = 


) 王 局 


使 用 pROP COLLATION 命令 可 以 删除 一 个 用 户 定义 的 排序 规则 。 


参见 Section 22.2 了 解 更 多 在 PostgreSQL 中 支持 的 排序 规则 。 


例子 


根据 操作 系统 中 的 系统 字符 编码 fr_FR.utf8 来 创建 一 个 排序 规则 (假定 当前 数据 库 的 编码 


是 UTF8 ): 
CREATE COLLATION french (LOCALE = 'fr_FR.utf8'); 


从 一 个 已 存在 的 排序 规则 中 复制 一 个 新 的 排序 规则 : 


CREATE COLLATION german FROM "de_DE"; 


这 对 在 应 用 程序 中 使 用 独立 于 操作 系统 的 排序 规则 名 是 很 方便 的 。 


兼容 性 


在 SQL 标准 中 有 create coLLATION 命令 ， 但 它 仅 限于 从 已 存在 的 排序 规则 中 拷贝 。 允许 创建 
一 个 新 的 排序 规则 是 PostgreSQL 的 扩展 。 


参见 


ZZ 


ALTER COLLATION, DROP COLLATION 


CREATE CONVERSION 


Name 


CREATE CONVERSION -- 定义 一 个 新 的 编码 转换 


Synopsis 


CREATE [ DEFAULT ] CONVERSION _name_ 
FOR _source_encoding_ TO _dest_encoding_ FROM _function_name_ 


CREATE CONVERSION 定义 字符 集 之 间 的 转换 。 标记 为 DEFAULT 的 转换 可 以 用 于 在 前 端 和 后 端 之 
间 的 自动 编码 转换 。 出 于 这 个 原因 ， 一 般 的 转换 如 从 编码 A 到 B 和 从 编码 B 到 A， 必 须 定 义 两 
种 转换 。 


为 了 可 以 创建 转换 ， 你 必须 有 函数 的 execute 权限 并 且 在 目标 模式 上 有 create 权限 。 


参数 


DEFAULT 
DEFAULT 选项 表示 这 种 转换 是 从 这 种 源 编 码 到 目标 编码 的 缺 省 转换 。 同一 个 模式 里 每 一 对 编 
码 应 该 只 有 一 个 缺 省 编码 转换 。 


_name 


转换 的 名 字 。 转 换 名 可 以 用 模式 修饰 。 如 果 没 有 ， 那 么 转换 就 在 当前 模式 中 定义 。 转换 名 在 
一 个 模式 里 必须 唯一 。 


_source_encoding_ 
源 编码 名 。 
_dest_encoding_ 
目标 编码 名 。 


_function_name_ 


用 于 执行 转换 的 函数 。 这 个 函数 名 可 以 用 模式 名 修饰 。 如 果 没 有 ， 那 么 将 从 路 径 中 找 出 这 个 
ER, 


TEES BU 2H AO RAE : 


conv_proc( 
integer, -- source encoding ID 
integer, -- destination encoding ID 
cstring, -- source string (null terminated C string) 
internal, -- destination (fill with a null terminated C string) 
integer -- source string length 
) RETURNS void; 


3 te 
ae 
FA prop conversion 删除 用 户 定义 的 转换 。 


创建 转换 所 需要 的 权限 可 能 在 未 来 的 版 本 中 改变 。 


例子 
用 myfunc 创建 一 个 从 uTF8 编码 到 Latina 编码 的 转换 : 


CREATE CONVERSION myconv FOR 'UTF8' TO 'LATIN1' FROM myfunc; 


RANE 


CREATE CONVERSION 是 PostgreSQL 的 扩展 。 在 SQL 标准 里 没有 cREATE conversion 语句 。 但 
有 一 个 在 语法 和 意义 上 都 很 相似 的 cREATE TRANSLATION 语句 。 


参见 


一 


ALTER CONVERSION, CREATE FUNCTION, DROP CONVERSION 


CREATE DATABASE 


Name 


CREATE DATABASE -- 创建 一 个 新 数据 库 


Synopsis 


CREATE DATABASE _name_ 
[ [ WITH ] [ OWNER [=] _user_name_ ] 
TEMPLATE [=] _template_ ] 
ENCODING [=] _encoding_ ] 
LC_COLLATE [=] _lc_collate_ ] 
LC_CTYPE [=] _lc_ctype_ ] 
TABLESPACE [=] _tablespace_name_ ] 
CONNECTION LIMIT [=] _connlimit_ ] ] 


Cees Be es ee Be De 


FA 
CREATE DATABASE 6] %—~#1PostgreSQL Riz Eo 


要 创建 一 个 数据 库 ， 你 必须 是 一 个 超级 用 户 或 者 有 特殊 的 cREATEDB 权限 。 BRICREATE 
USER. 


缺 省 情况 下 新 数据 库 将 通过 复制 标准 系统 数据 库 templates 来 创建 。 可 以 通过 TEMPLATE 
_name_ 指定 不 同 的 模板 。 尤其 是 ， 用 TEMPLATE templated 创建 一 个 很 纯净 的 、 只 包括 
PostgreSQL 预 定义 的 标准 对 象 的 数据 库 。 这 个 方法 对 于 避免 把 任何 已 经 加 入 到 template1 里 
的 本 地 安装 对 象 拷贝 到 新 数据 库 是 非常 有 用 的 。 


参数 


_name_ 


要 创建 的 数据 库 名 字 。 
数据 库 用 户 的 名 字 ， 他 将 是 新 数据 亩 的 所 有 者 ， 或 者 是 使 用 DEFAULT 选项 来 指定 当前 缺 省 用 


户 (也 就 是 执行 命令 的 用 户 )。 要 创建 一 个 其 他 角色 所 有 的 数据 库 ， 你 必须 是 那个 角色 的 直接 
或 间接 的 成 员 ， 或 者 是 超级 用 户 。 


_template_ 


模板 名 ， 即 从 哪个 模板 创建 新 数据 库 ， 或 者 使 用 DEFAULT 选项 来 指定 缺 省 模板 ( templatel )。 
_encoding_ 
创建 新 数据 库 使 用 的 字符 编码 。 可 以 使 用 文本 名 字 ( 例 如 'sQL_AscII' )、 整 数 编号 或 


是 DEFAULT 选项 来 指定 (模版 数据 库 的 编码 )。 PostgreSQL 服 务 器 支持 的 字符 集 在 Section 
22.3.1 里 有 描述 。 额外 的 限制 参见 下 文 。 


_lc collate_ 
用 于 新 数据 库 的 排序 规则 (LC_COLLATE)。 这 影响 到 应 用 对 字符 串 的 排序 顺序 ， 例 如 : 在 有 


ORDER BY 的 查询 中 ， 以 及 用 于 文本 列 的 索引 的 顺序 。 在 默认 情况 下 ， 使 用 模板 数据 库 的 排 
序 规则 。 请 看 以 下 附加 的 限制 。 


_lc_ctype_ 

用 于 新 数据 库 的 字符 分 类 ( Lc_cTYPE )。 这 影响 字符 的 分 类 ， 例 如 : NS ASMA. RR 
认 情 况 下 使 用 模板 数据 库 的 字符 分 类 。 请 看 以 下 附加 的 限制 。 

_tablespace_name_ 

和 新 数据 库 关联 的 表 空 间 名 字 ， 或 者 使 用 DEFAULT 选项 表示 使 用 模版 数据 库 的 表 空间 。 这 个 


表 空 间 将 成 为 在 这 个 数据 库 里 创建 的 对 象 的 缺 省 表 空间 。 参阅 CREATE TABLESPACE 获 取 
更 多 信息 。 


_connlimit_ 
数据 库 可 以 接受 多 少 并 发 的 连接 。-1( 缺 省 ) 意 味 着 没有 限制 。 


可 选 参数 可 以 按 任意 顺序 书写 ， 而 不 仅仅 是 上 面 显 示 的 顺序 。 


> = 


aa 


CREATE DATABASE 不 能 在 事务 块 里 面 执行 。 
类 似 "could not initialize database directory" 这 样 的 错误 ， 最 有 可 能 是 因为 数据 目录 的 权限 不 
够 或 者 磁盘 满 之 类 的 文件 系统 问题 。 
使 用 DROP DATABASE 删除 一 个 数据 库 。 
程序 createdb 是 这 个 命令 的 封装 ， 使 用 更 加 方便 。 


尽管 可 以 通过 把 某 数据 库 名 声明 为 模板 而 不 是 用 template1 ， 但 是 这 (还 ) 不 是 一 个 通用 

BY" copy DATABASE "功能 。 主要 的 限制 是 在 从 模版 复制 的 时 候 不 允许 有 其 它 会 话 链接 到 模版 数 
据 库 上 。 如 果 在 开始 执行 create DATABASE 的 时 候 有 其 它 会 话 正 连接 在 模版 数据 库 上 ， 那 么 操 
作 将 会 失败 ; 否则 直到 create DATABASE 完成 之 后 ， 才 人 允许 对 模板 数据 库 建立 新 的 会 话 连 接 。 

参见 Section 21.3 获 取 更 多 信息 。 


为 一 个 新 数据 库 指 定 的 字符 集 编 码 必 须 兼 容 所 选择 的 区 域 环 境 设 置 

( Lc_coLLATE 和 Lc_cTYPE )。 若 区 域 设置 为 c (或 相当 于 posix )， 那 么 所 有 的 编码 都 允许 ， 
但 是 对 于 其 他 的 区 域 设置 ， 只 有 一 个 编码 能 正常 工作 。 (Am, WindowsR, UTF-8 
编码 可 用 于 任何 区 域 设 置 。) CREATE DATABASE 将 会 允许 超级 用 户 来 指定 sQL_Ascri 编码 而 
不 考虑 区 域 设置 情况 ， 这 种 做 法 已 过 时 了 ， 是 不 宜 采 用 的 ， 它 会 导致 编码 与 不 兼容 区 域 设 置 
的 数据 被 存储 在 数据 库 中 时 字符 串 函 数 功能 会 不 正常 。 


除了 templateo 用 作 模 板 的 时 候 ， 其 他 数据 库 的 编码 和 区 域 设 置 必须 匹配 模板 数据 库 。 这 是 
因为 其 他 数据 库 可 能 会 包含 不 匹配 指定 编码 的 数据 ， 或 者 可 能 包含 排序 顺序 

受 Lc_coLLATE 和 Lc_cTYPE 影响 的 索引 。 复制 这 些 数据 会 导致 数据 库 被 新 设置 破坏 。 然 

Mm, templateo 公认 是 不 包含 任何 会 受到 影响 的 数据 或 者 索引 的 。 


CONNECTION LIMIT 选项 只 是 近似 地 强制 ; 如 果 两 个 新 的 连接 几乎 同时 发 起 ， 而 只 剩 下 一 个 连 
接 "slot" 了 ， 那 么 很 可 能 两 个 连接 都 失效 。 另 外 ， 超 级 用 户 连接 时 不 受 这 个 限制 。 


例子 
创建 一 个 新 数据 库 : 


CREATE DATABASE lusiadas; 


创建 一 个 由 用 户 salesapp 拥有 的 数据 库 sales, MARA HÆ salesspace : 


CREATE DATABASE sales OWNER salesapp TABLESPACE salesspace; 


创建 一 个 数据 库 music ， 支 持 ISO-8859-1 字 符 集 : 


CREATE DATABASE music ENCODING 'LATIN1i' TEMPLATE templated; 


在 这 个 例子 中 ， TEMPLATE templateo 选项 只 在 templates 的 编码 不 是 ISO-8859-1 时 被 请 求 。 
请 注意 : 更 改编 码 可 能 也 会 需要 选择 新 的 Lc_coLLATE 和 Lc_cTYPE 设置 。 


兼容 性 


在 sql 标 准 里 头 没有 CREATE DATABASE 语句 。 数 据 库 等 同 于 目录 ， 其 创建 是 交 给 具体 的 数 
据 库 实现 去 定义 的 。 


参见 


EA 


ALTER DATABASE, DROP DATABASE 


CREATE DOMAIN 


Name 


CREATE DOMAIN -- 定义 一 个 新 域 


Synopsis 


CREATE DOMAIN _name_ [ AS ] _data_type_ 
[ COLLATE _collation_ ] 
[ DEFAULT _expression_ ] 
[ _constraint_ [... ] ] 


where ~_constraint_~ is: 


[ CONSTRAINT _constraint_name_ ] 
{ NOT NULL | NULL | CHECK (_expression_) } 


描述 
CREATE DOMAIN 创建 一 个 新 的 数据 域 。 域 在 本 质 上 是 一 个 带 有 可 选 约束 的 数据 类 型 (限制 允许 
的 取 值 范围 )。 定 义 域 的 用 户 成 为 其 所 有 者 。 


如 果 给 出 一 个 模式 名 称 (比如 CREATE DOMAIN myschema.mydomain ... ), 那么 该 域 是 在 指定 的 模 
式 中 创建 的 。 否则 它 会 在 当前 模式 中 创建 。 域 名 字 必需 在 其 所 在 模式 中 的 现 有 类 型 和 域 中 唯 


o 


域 可 以 便于 把 不 同 表 之 间 的 公共 约束 提取 到 一 个 固定 位 置 进行 维护 。 比如 ， 在 多 个 表 中 都 含 
有 一 个 电子 邮件 地 址 字段 ， 这 个 字段 都 要 求 有 CHECK 的 约束 检查 来 验证 邮箱 的 有 效 性 。 此 时 
可 以 定义 并 使 用 一 个 域 ， 而 不 是 分 别 设置 每 个 表 的 约束 。 


要 创建 域 ， 你 必须 有 相关 数据 类 型 的 usace 权限 。 


参数 


_name_ 


要 创建 的 域名 字 ( 可 以 有 模式 修饰 ) 。 


_data_type_ 
域 的 下 层 数 据 类 型 。 这 时 可 以 包含 一 组 的 定义 选项 。 


_collation_ 


可 选 的 域 的 排序 规则 。 如 果 没 有 指定 排序 规则 ， 会 使 用 下 层 所 属 数据 类 型 的 排序 规则 。 如 果 
使 用 了 coLLATE 选项 ， 则 下 层 数据 类 型 必须 是 可 排序 的 。 


DEFAULT _expression_ 


DEFAULT 选项 为 域 数 据 类 型 的 字段 声明 一 个 缺 省 值 。 该 值 是 任何 不 含 变量 的 表达 式 (但 不 允许 
子 查询 )。 缺 省 表达 式 的 数据 类 型 必需 匹配 域 的 数据 类 型 。 如 果 没 有 声明 缺 省 值 ， 那 么 缺 省 值 
就 是 NULL 。 


缺 省 表达 式 将 用 于 任何 省 略 该 字段 值 的 插入 操作 。 如 果 为 特定 的 字段 声明 了 缺 省 值 ， 那么 它 
覆盖 任何 和 该 域 相 关联 的 缺 省 值 。 然后 ， 域 的 缺 省 覆盖 任何 与 下 层 数 据 类 型 相关 的 缺 省 。 


CONSTRAINT  _constraint name_ 


一 个 约束 的 可 选 名 称 。 如 果 没 有 声明 ， 系 统 将 自动 生成 一 个 名 字 。 


NOT NULL 
域 的 值 通常 不 能 为 空 。 然而 ， 对 于 有 此 约束 的 域 ， 若 分 配 了 匹配 的 空域 类 型 ， 则 仍然 可 能 会 


有 空 值 ， 例如 : 通过 一 个 LEFT OUTER JOIN 或 


者 INSERT INTO tab (domcol) VALUES ((SELECT domcol FROM tab WHERE false)) 。 


NULL 

这 个 域 的 数值 允许 为 NULL 。 这 是 缺 省 。 

这 个 子 句 只 是 用 于 和 非 标准 的 SQL 数据 库 兼 容 用 。 不 建议 在 新 的 应 用 中 使 用 它 。 
CHECK (``_expression_ ) 


CHECK 选项 声明 域 的 数值 必须 满足 的 完整 性 约束 或 测试 。 每 个 约束 必须 是 一 个 生成 布尔 结果 
的 表达 式 。 它 应 该 使 用 关键 字 vALuE 来 引用 被 测试 的 数值 。 


HAT, check 表达 式 不 能 包含 子 查询 ， 也 不 能 引用 除 VALUE 之 外 的 变量 。 


例子 


这 个 例子 创建 了 us_postal_code 数据 类 型 并 且 在 一 个 表 定 义 中 使 用 了 该 类 型 。 使 用 了 一 个 正 
则 表达 式 测 试 以 保证 这 些 数值 看 起 来 像 一 个 美国 的 邮政 编码 : 


CREATE DOMAIN us_postal_code AS TEXT 
CHECK ( 
VALUE ~ 'A\d{5}$!' 
OR VALUE ~ 'A\d{5}-\d{4}$' 
); 


CREATE TABLE us_snail_addy ( 
address_id SERIAL PRIMARY KEY, 
street1 TEXT NOT NULL, 
street2 TEXT, 
street3 TEXT, 
city TEXT NOT NULL, 
postal us_postal_code NOT NULL 

); 


兼容 性 
CREATE DOMAIN 命令 符合 SQL 标准 。 


参见 


ALTER DOMAIN, DROP DOMAIN 


CREATE EXTENSION 


Name 


CREATE EXTENSION -- 安装 一 个 扩展 


Synopsis 


CREATE EXTENSION [ IF NOT EXISTS ] _extension_name_ 
[ WITH ] [ SCHEMA _schema_name_ ] 
[ VERSION _version_ ] 
[ FROM _old_version_ ] 


摘 述 

create extension 命令 安装 一 个 新 的 扩展 到 一 个 数据 库 中 .必须 保证 没有 同名 的 扩展 已 经 被 安 
wE 

aS. 


安装 一 个 扩展 意味 着 执行 一 个 扩展 的 脚本 文件 .这 个 脚本 会 创建 一 个 新 的 SQL 实体 ,例如 函数 ， 
数据 类 型 ,操作 符 , 和 索引 支持 的 方法 . 


安装 扩展 需要 有 和 创建 他 的 组 件 对 象 相同 的 权限 .对 于 大 多 数 扩展 这 意味 着 需要 超 户 或 者 数据 
库 所 有 者 的 权限 . 对 于 后 续 的 权限 检查 和 该 扩展 脚本 所 创建 的 实体 ， 运 行 CREARE 
EXTENSION 命 令 的 角色 将 变 为 扩展 的 所 有 者 . 


参数 


IF NOT EXISTS 
如 果 系 统 已 经 存在 一 个 同名 的 扩展 ， 不 会 报错 ， 这 种 情况 下 会 给 出 一 个 提示 . 请 注意 该 参数 
不 保证 系统 存在 的 扩展 和 现在 脚本 创建 的 扩展 相同 . 
_extension_name_ 
将 被 安装 扩展 的 名 字 . PostgresQL 
从 SHAREDIR/extension/``_extension_name .control 这 个 文件 安装 扩展 . 
_schema_name_ 


扩展 的 实例 被 安装 在 该 模式 下 ,扩展 的 内 容 可 以 被 重新 安装 .指定 的 模式 必须 已 经 存在 .如 果 没 有 
指定 ,扩展 的 控制 文件 也 不 指定 一 个 模式 ,这 样 将 使 用 默认 模式 . 


注意 扩展 不 认为 它 在 任何 模式 里 面 :扩展 在 一 个 数据 库 范 围 内 的 名 字 是 不 受 限 制 的 ,但 是 一 个 扩 
展 的 实例 是 属于 一 个 模式 的 . 


_version_ 


安装 扩展 的 版 本 .这 个 可 以 写 为 一 个 标识 符 或 者 字符 串 . 默 认 的 版 本 在 扩展 的 控制 文件 中 指定 . 


_old_version_ 


当 你 想 升 级 安装 "old style" 模块 中 没有 的 内 容 时 ,你 必须 指定 FROM _old_version_ . 这 个 选项 
使 CREATE EXTENSION 运行 一 个 安装 脚本 将 新 的 内 容 安 装 到 扩展 中 ,而 不 是 创建 一 个 新 的 实体 . 注 
意 scHema 指定 了 包括 这 些 已 存在 实体 的 模式 . 


_old_version_ 的 值 由 扩展 的 作者 决定 ,如 果 有 多 个 旧 的 版 本 升级 到 一 个 扩展 这 个 值 可 能 会 改 
变 .对 于 pre-9.1PostgreSQL 提供 的 标准 扩展 , 当 升 级 扩展 时 使 用 unpackaged 代 
蔡 _old_version_ 


ss at 
) 王 局 


在 你 使 用 CREATE EXTENSION 去 安装 一 个 扩展 到 数据 库 之 前 ,扩展 所 需 的 文件 必须 被 安装 .安装 扩 
展 所 需 的 信息 在 Additional Supplied Modules. 


现在 可 以 安装 的 扩展 可 以 在 pg_available_extensions 或 


者 pg_available_extension_versions HEI. 


关于 写 一 个 扩展 信息 ,可 以 查看 Section 35.15. 


例子 
在 当前 数据 库 安 装 hstore 扩 展 : 


CREATE EXTENSION hstore; 


升级 一 个 9.1 安 装 的 hstore : 


CREATE EXTENSION hstore SCHEMA public FROM unpackaged; 
注意 指定 你 在 哪个 模式 安装 过 hstore . 


兼容 性 


CREATE EXTENSION 是 PostgreSQL 的 一 个 扩展 . 
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相关 内 容 


ALTER EXTENSION, DROP EXTENSION 
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CREATE EVENT TRIGGER 


Name 


CREATE EVENT TRIGGER -- 定义 一 个 事件 触发 器 


Synopsis 


CREATE EVENT TRIGGER _name_ 
ON _event_ 
[ WHEN _filter_variable_ IN (filter_value [, ... ]) [ AND... ] ] 
EXECUTE PROCEDURE _function_name_() 


CREATE EVENT TRIGGER 创建 一 个 新 的 事件 触发 器 .无 论 何 时 指定 的 事件 发 生 或 wen 的 条 件 满足 
触发 器 ， 触 发 器 加 数 将 被 执行 。 对 于 事件 触发 器 的 一 般 说 明 ， 请 见于 Chapter 37. 创建 事件 触 
发 器 的 用 户 将 变 为 它 的 拥有 者 . 


参数 


一 个 新 的 触发 器 的 名 字 . 这 个 名 字 必 须 在 数据 库 内 是 唯一 的 . 
_event_ 
MeH- TAERAA TF AF SESSA BSE LF Section 37.1. 


_filter_variable_ 


过 滤 事 件 的 变量 名 称 .这 将 限制 它 所 支持 的 事件 的 一 个 子 集 去 触发 该 触发 器 .现在 仅 支 
持 _filter_variable_ 值 为 TAG. 


filter_value 





可 以 触发 该 触发 器 的 _filter_variable 相关 的 值 .对 于 tac ,这 意味 着 一 个 tags 的 命令 列表 . 


(例如 . 'DROP FUNCTION’ ). 


_function_name_ 


— FA P BABU i SRY AH BRIG] event_trigger 类 型 . 


Notes 


只 有 超 户 能 创建 事件 触发 器 . 


在 单 用 户 模式 下 事件 触发 器 是 被 关闭 的 ( 详 见 于 postgres). 如 果 一 个 错误 的 事件 触发 器 关闭 了 
数据 库 , 在 单 用 户 模式 下 你 将 不 能 重启 数据 库 , 删 除 事件 触发 器 . 


Examples 
禁止 执行 任何 DDL 命 倒 : 


CREATE OR REPLACE FUNCTION abort_any_command() 
RETURNS event_trigger 
LANGUAGE plpgsql 
AS $$ 
BEGIN 
RAISE EXCEPTION 'command % is disabled', tg_tag; 
END; 
$$; 


CREATE EVENT TRIGGER abort_ddl ON ddl_command_start 
EXECUTE PROCEDURE abort_any_command(); 


Compatibility 


在 标准 的 SQL 语法 中 没有 CREATE EVENT TRIGGER 语句 . 


相关 内 容 


ALTER EVENT TRIGGER, DROP EVENT TRIGGER, CREATE FUNCTION 


CREATE FOREIGN DATA WRAPPER 


Name 


CREATE FOREIGN DATA WRAPPER -- 定义 一 个 外 部 数据 封装 器 


Synopsis 


CREATE FOREIGN DATA WRAPPER _name_ 
[ HANDLER _handler_function_ | NO HANDLER ] 
[ VALIDATOR _validator_function_ | NO VALIDATOR | 
[ OPTIONS ( _option_ '_value_' [, ... ] ) ] 





CREATE FOREIGN DATA WRAPPER 创建 一 个 新 的 外 部 数据 封装 器 。 创建 外 部 数据 封装 器 的 用 户 成 
为 其 所 有 者 。 


外 部 数据 封装 器 的 名 字 必 需 在 数据 库 中 唯一 。 
只 有 超级 用 户 可 以 创建 外 部 数据 封装 器 


参数 


_name_ 


要 创建 的 外 部 数据 封装 器 的 名 字 。 
HANDLER _handler_function_ 


_handler_function_ 是 先前 已 经 注册 了 的 函数 的 名 字 ， 用 来 为 外 部 表 检 索 执 行 男 数 。 处 理 器 
画 数 必须 没有 参数 ， 并 且 它 的 返回 类 型 必须 为 fdw_handler o 


不 用 久 理 器 函数 创建 外 部 数据 封装 器 是 可 能 的 ， 但 是 使 用 这 种 封装 器 的 外 部 表 只 能 被 声明 ， 
不 能 被 访问 。 


VALIDATOR _validator_function_ 


_validator_function ”是 先前 已 经 注册 了 的 函数 的 名 字 ， 用 来 检查 提供 给 外 部 数据 封装 器 的 
通用 选项 ， 还 有 使 用 该 外 部 数据 封装 器 的 外 部 服务 器 和 用 户 映 射 的 选项 。 a jk 2s A 
数 或 声明 了 No VALIDATOR, 那么 在 创建 时 将 不 检查 选项 。 (外 部 数据 封装 器 可 能 在 运行 时 忽 


略 或 拒绝 无 效 的 选项 说 明 ， 取决 于 实现 。) 验证 器 图 数 必须 接受 两 个 参数 : 一 个 类 型 
为 text[] ， 将 包含 存储 在 系统 目录 中 的 选项 的 数组 ， 一 个 类 型 为 oid ， 是 包含 这 些 选项 的 
系统 目录 的 OID。 忽 略 返回 类 型 ; AWA MAHA ereport(ERROR) 酌 数 报告 无 效 选项 。 


OPTIONS ( _option_ ' value_'[,...]) 





个 子 句 为 新 的 外 部 数据 封装 器 声明 选项 。 人 
并 且 是 经 过 外 部 数据 封装 器 的 验证 器 回 数 验证 了 的 。 选 项 名 必须 是 唯一 的 。 


MAN N 
a 


PostgreSQL 的 外 部 数据 功能 一 直 在 积极 开发 。 查询 的 优化 是 原始 的 〈 并 且 主 要 是 封装 器 ) o 
因此 ， 未 来 的 性 能 提升 有 很 大 的 空间 。 


例子 
创建 一 个 无 用 的 外 部 数据 封装 器 dummy : 


CREATE FOREIGN DATA WRAPPER dummy; 


创建 一 ON He ye TBS RE file_fdw_handler 的 外 部 数据 封装 iS os file : 


CREATE FOREIGN DATA WRAPPER file HANDLER file fdw handler; 


创建 一 个 带 有 一 些 选项 的 外 部 数据 封装 器 mywrapper : 


CREATE FOREIGN DATA WRAPPER mywrapper 
OPTIONS (debug 'true'); 


兼容 性 


CREATE FOREIGN DATA WRAPPER 遵从 ISO/IEC 9075-9 (SQL/MED)， 除 
了 HANDLER 和 VALIDATOR 子 句 是 扩展 ， 并 且 标 准 的 子 句 LIBRARY 和 LANGUAGE 没有 在 
PostgreSQL 中 实现 。 


请 注意 ， 然 而 ，SQL/MED 功 能 作为 一 个 整体 目前 是 不 符合 的 。 


X 
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ALTER FOREIGN DATA WRAPPER, DROP FOREIGN DATA WRAPPER, CREATE 
SERVER, CREATE USER MAPPING, CREATE FOREIGN TABLE 


CREATE FOREIGN DATA WRAPPER 1649 


CREATE FOREIGN TABLE 


Name 


CREATE FOREIGN TABLE -- 定义 一 个 新 外 部 表 


Synopsis 


CREATE FOREIGN TABLE [ IF NOT EXISTS ] _table_name_ ( [ 
column_name data_type_ [ OPTIONS ( _option_ '_value_' [, ... ] ) ] [ COLLATE _coll 
lo one 








SERVER _server_name_ 
[ OPTIONS ( _option_ '_value_' [, ... ] ) ] 
这 里 ` column_constraint _ ”可 以 是 : 





[ CONSTRAINT _constraint_name_ ] 
{ NOT NULL | 

NULL | 

DEFAULT _default_expr_ } 





CREATE FOREIGN TABLE 在 当前 数据 库 中 创建 一 个 外 部 表 ， 该 表 将 由 发 出 此 命令 的 用 户 所 有 。 


如 果 给 出 了 模式 名 (for example, CREATE FOREIGN TABLE myschema.mytable ... )， 那 么 表 是 在 
指定 模式 中 创建 的 。 否 则 在 当前 模式 中 创建 外 部 表 。 外 部 表 的 名 字 必 须 与 同一 个 模式 中 的 其 
它 外 部 表 ， 表 ， 序 列 ， 索 引 或 试图 的 名 字 不 同 


CREATE FOREIGN TABLE 还 自动 创建 一 个 数据 类 型 ， 该 数据 类 型 代表 对 应 该 外 部 表 一 行 的 复合 类 
型 。 因此 ， 外 部 表 不 能 和 同 模式 中 的 现 有 数据 类 型 同名 。 


为 了 创建 一 个 外 部 表 ， 除 了 对 外 部 表 所 有 字段 类 型 有 usace 权限 外 ， 还 必须 有 外 部 表 服 务 器 
的 usace 权限 。 


参数 


IF NOT EXISTS 


如 果 已 经 存在 相同 名 称 的 对 象 ， 在 这 种 情况 下 ， 不 会 抛 出 错误 ， 只 会 产生 一 个 通知 。 请 注意 
这 并 不 保证 将 要 创建 的 对 象 与 现 有 对 象 是 否 一 致 。 


_table_name_ 


要 创建 的 表 的 名 字 〈 可 以 用 模式 修饰 ) 。 
_column_name_ 
新 表 中 要 创建 的 字段 名 。 
_data_type_ 
该 字段 的 数据 类 型 . 它 可 以 包含 数组 说 明 符 。 有 关 PostgreSQL 支持 的 数据 类 型 的 更 多 信息 ， 
请 参考 Chapter 8。 
NOT NULL 
该 字段 不 允许 包含 null 值 。 
NULL 
该 字段 允许 包含 null 值 。 这 是 缺 省 。 
这 个 子 句 的 存在 只 是 为 和 那些 非 标准 SQL 数据 库 兼 容 。 我 们 不 建议 在 新 应 用 中 使 用 它 。 
DEFAULT _default_expr_ 
DEFAULT 子 句 给 它 所 出 现 的 字段 设 定 一 个 缺 省 数值 。 该 数值 可 以 是 任何 不 含 变量 的 表达 式 
(不 允许 使 用 子 查询 和 对 本 表 中 的 其 它 字段 的 交叉 引用 ) 。 缺 省 表达 式 的 数据 类 型 必须 和 字 
多 类 型 匹配 。 
缺 省 表达 式 将 被 用 于 任何 未 指定 该 字段 数值 的 插入 操作 。 如 果 字 段 上 没有 缺 省 值 ， 那 么 缺 省 
是 NULL。 


外 部 表 使 用 的 已 存在 的 外 部 服务 器 名 称 。 更 多 细节 ， 参 考 CREATE SERVER, 


OPTIONS ( _option_ ' _value_ '[,...]) 





选项 和 与 新 外 部 表 或 外 部 表 中 的 字段 有 关 。 人 允许 的 选项 名 称 和 值 ， 是 由 每 一 个 外 部 数据 封装 器 
中 来 说 是 特别 指定 的 。 也 是 通过 外 部 数据 封装 器 的 验证 事 数 来 验证 。 重 复 的 选项 名 称 是 不 被 
允许 的 (尽管 表 选 项 和 表 字 段 选项 可 以 有 相同 的 名 字 )。 


例子 


创建 外 部 表 films ,该 表 通 过 服务 器 film_server 访问 : 


CREATE FOREIGN TABLE films ( 


code char(5) NOT NULL, 

title varchar(40) NOT NULL, 
did integer NOT NULL, 
date_prod date, 

kind varchar (10), 

len interval hour to minute 


) 
SERVER film_server; 


mH 
兼容 性 
CREATE FOREIGN TABLE 命令 最 大 程度 上 符合 了 SQL 标准 ; 然而 ， 就 像 使 
用 create TABLE , NULL 约束 和 需 字 段 外 部 表 以 及 设 定 默认 值 的 功能 是 PostgreSQL 对 SQL 标 
准 的 扩展 。 
See Also 


ALTER FOREIGN TABLE, DROP FOREIGN TABLE, CREATE TABLE, CREATE SERVER 


CREATE FUNCTION 


Name 


CREATE FUNCTION -- 定义 一 个 新 函数 


Synopsis 


CREATE [ OR REPLACE ] FUNCTION 





_name_ ( [ [ _argmode_ ] [ _argname_ ] _argtype_ [ { DEFAULT | = } _default_expr_ ] [ 
[ RETURNS _rettype_ 
| RETURNS TABLE ( _column_name column_type_ [, ...] ) ] 
{ LANGUAGE _lang_name_ 
WINDOW 


IMMUTABLE | STABLE | VOLATILE | [ NOT ] LEAKPROOF 

CALLED ON NULL INPUT | RETURNS NULL ON NULL INPUT | STRICT 

[ EXTERNAL ] SECURITY INVOKER | [ EXTERNAL ] SECURITY DEFINER 

COST _execution_cost_ 

ROWS _result_rows_ 

SET _configuration_parameter_ { TO _value_ | = _value_ | FROM CURRENT } 
AS '_definition_' 

AS '_obj_file_', '_link_symbol_' 








[ WITH (attribute P ...] ) ] 





CREATE FUNCTION Æ 3L —S3TAYERAX. CREATE OR REPLACE FUNCTION 如 果 画 数 不 存 在 就 创建 一 
个 新 函数 ， 否 则 蔡 换 现 有 的 定义 。 用 户 必须 有 定义 该 图 数 所 用 语言 的 usace 权限 才能 定义 新 
HESE 


如 果 包 含 了 一 个 模式 名 ， 那 么 责 数 就 在 指定 的 模式 中 创建 。 否 则 它 会 在 当前 模式 中 创建 。 新 
责 数 的 名 字 不 能 和 同一 个 模式 中 的 任何 带 有 同样 参数 类 型 的 函数 同名 。 不 过 ， 参 数 类 型 不 同 
的 函数 可 以 同名 (这 叫做 重 裁 )。 


使 用 CREATE OR REPLACE FUNCTION 替换 一 个 现 有 回 数 的 定义 。 不 能 用 这 个 方法 修改 一 个 画 数 
的 名 字 或 者 参数 类 型 ， 否则 就 会 创建 一 个 新 的 画 数 。 同 样 CREATE OR REPLACE FUNCTION 也 不 
会 允许 你 修改 一 个 现 有 图 数 的 返回 类 型 。 要 做 这 些 事情 ， 你 必须 删除 并 重新 创建 画 数 。 如 果 
使 用 our 参数 ， 那 就 意味 着 除了 删除 函数 之 外 ， 你 不 能 修改 任何 our 参数 的 类 型 或 者 名 
字 。 

当 使 用 CREATE OR REPLACE FUNCTION 替换 现 有 图 数 的 定义 时 ， 不 会 改变 图 数 的 属 主 和 权限 。 
函数 其 他 的 属性 会 被 赋予 命 倒 中 给 定 的 值 或 默认 值 。 只 有 男 数 的 属 主 才 可 以 蔡 换 函数 (也 可 
以 是 属 主角 色 的 成 员 ) 。 


如 果 你 删除 然后 重建 一 个 函数 ， 新 琅 数 和 旧 函 数 将 是 不 同 的 实体 ; 你 就 需要 删除 现 有 引用 了 
老 函 数 的 规则 、 视 图 、 触 发 器 等 等 。 使 用 cREATE oR REPLACE FUNCTION 可 以 在 不 破坏 引用 该 
函数 的 对 象 的 前 提 下 修改 函数 定义 。 并 且 ， 使 用 acter Function 能 修改 一 个 已 有 函数 的 大 多 
数 属性 。 

创建 这 个 函数 的 用 户 将 成 为 函数 的 所 有 者 。 


你 必须 拥有 要 创建 画 数 的 参数 类 型 和 返回 值 类 型 的 usas 权限 ， 才 能 创建 该 图 数 。 


参数 


_name_ 


EO SN GRAF (A LAA r) 


_argmode_ 


参数 的 模式 : IN, our, INOUT ,或 vARIADIC o RAAE IN 。 只 有 ouT 模式 的 参数 后 
面 能 跟 VARIADIC 。 并 且 out 和 Inout 模式 的 参数 不 能 用 在 RETURNS TABLE 的 辑 数 定义 
中 。 


_argname_ 


一 个 参数 的 名 字 。 有 些 语 言 (包括 SQL 和 PL/pgSQL) 人 允许 你 在 画 数 体 里 使 用 参数 名 字 。 对 于 
其 它 语 言 ， 输 入 参数 名 字 只 是 额外 的 文档 ， 这 只 是 就 画 数 定义 本 身 而 盲 的 ;在 调用 画 数 时 你 
可 以 使 用 输入 参数 名 字 来 提高 可 读 性 。 ( 见 Section 4.3) 。 无 论 如 何 ， 输 出 参数 的 名 字 是 非 
常 重要 的 ， 因 为 它 定义 了 结果 行 类 型 的 列 名 。 【〔 如 果 你 省 略 了 输出 参数 的 名 字 ， 那 么 系统 会 
自动 选择 一 个 缺 省 的 列 名 。) 


_argtype_ 


该 函数 的 数据 类 型 (可 以 有 模式 修饰 )， 如 果 有 的 话 。 可 以 是 基本 类 型 ， 也 可 以 是 复合 类 型 、 
域 类 型 、 或 者 可 以 引用 一 个 现 有 字段 相同 的 类 型 。 

根据 实现 语言 的 不 同 ， 还 可 以 在 这 上 面 声明 " 伪 类 型 " (比如 cstring )。 伪 类 型 表示 实际 的 参 
数 类 型 要 么 是 没有 完整 地 声明 ， 要 么 是 在 普通 的 SQL 数据 类 型 之 外 。 


一 个 字段 的 类 型 是 用 _table_name . _column_name_ %TYPE 表示 的 ; 使 用 这 个 特性 有 时 候 可 
以 帮助 创建 一 个 不 受 表 定义 变化 影响 的 函数 。 





_default_expr_ 


当 参 数值 没有 指定 时 作为 参数 默认 值 的 表达 式 。 该 表达 式 的 类 型 必须 可 转化 为 参数 的 类 型 。 
只 有 输入 (也 包括 mou ) 参 数 才 能 有 默认 值 。 具 有 默认 值 参 数 的 输入 参数 必须 在 参数 列表 的 
最 后 。 


_rettype_ 


返回 值 的 数据 类 型 。 可 以 声明 为 一 个 基本 类 型 、 复 合 类 型 、 域 类 型 、 或 者 引用 一 个 表 的 现 有 
字段 类 型 。 根据 实现 语言 的 不 同 ， 还 可 以 在 这 上 面 声 明 " 俯 类 型 "比如 cstring )。 如 果 不 打 
算 返 回 任何 值 可 以 指定 void 作为 返回 类 型 。 

如 果 存 在 our 或 INouT 参数 ， 那 么 可 以 省 略 returns 子 句 。 如 果 出 现 了 ， 那么 它 必 须 隐 
含 的 和 输出 参数 结果 类 型 兼容 : 如 果 有 多 个 输出 参数 ， 则 必须 是 RECORD ， 如 果 只 有 一 个 输 
出 参数 ， 则 与 其 相同 。 

SETOF 修饰 词 表 示 该 本 数 将 返回 一 个 集合 ， 而 不 是 单独 一 条 。 


一 个 字段 的 类 型 是 通过 _table_name_ . _column_name_ %TYPE 引用 的 。 





_column_name_ 
RETURNS TABLE 的 语法 中 输出 字段 名 。 这 是 另 一 种 有 效 的 声名 带 名 字 的 ouT 类 型 参数 的 方 
xt, 而 且 RETURNS TABLE 4s RETURNS SETOF 。 


_column_type_ 


RETURNS TABLE 语法 中 输出 字段 的 数据 类 型 。 


_lang_name_ 


用 以 实现 图 村 数 的 语言 的 名 字 。 可 以 是 SQL, C , internal , 或 者 是 用 户 定义 的 过 程 语言 名 
字 。 该 名 字 可 以 用 单 引 号 包围 。 


WINDOW 


WINDOW 表示 该 酚 数 不 是 普通 函数 而 是 一 个 窗口 函数 。 这 个 属性 当前 仅 对 用 C 写 的 函数 起 作 
用 。 当 蔡 换 已 有 画 数 定义 时 不 能 改变 图 数 的 wzNpow 属性 。 


IMMUTABLE “STABLE VOLATILE 
这 些 属性 是 在 查询 优化 器 中 用 来 优化 汞 数 的 调用 的 ， 只 能 指定 一 个 。 缺 省 值 是 VOLATILE o 


IMMUTABLE 表示 该 范 数 不 能 修改 数据 库 ， 并 且 在 给 出 同样 的 参数 值 时 总 是 返回 同样 的 结果 ; 
也 就 是 说 ， 它 不 查询 数据 库 或 者 只 使 用 那些 没有 出 现在 参数 列表 里 的 信息 。 如 果 给 出 这 个 
项 ， 那 么 任何 全 部 使 用 常数 对 该 范 数 的 调用 都 将 立即 替换 为 该 画 数 的 值 。 


STABLE 表示 该 本 数 不 能 修改 数据 库 ， 对 相同 参数 值 ， 在 同一 次 表 扫 摘 里 ， 该 本 数 的 返回 值 
不 变 ， 但 是 返回 值 可 能 在 不 同 SQL 语句 之 间 变 化 。 这 个 选项 对 那些 结果 依赖 数据 库 查找 、 参 
数 变 量 (比如 当前 时 区 ) 之 类 的 函数 很 合适 。 但 对 于 那些 希望 查询 当前 命令 修改 的 行 的 
AFTER 类 型 的 触发 器 是 不 合适 的 。) 还 要 注意 current_timestamp HAJR EIEH, AAE 
们 的 值 在 一 次 事务 中 不 会 变化 。 


VOLATILE 表示 该 豆 数 值 其 至 可 以 在 一 次 表 打 描 内 改 交 ， 因此 不 会 做 任何 优化 。 只 有 很 少 的 
数据 库 函 数 在 这 个 概念 上 是 易 变 的 ; 一 些 例子 是 random() ，currval() ，timeofday() 。 请 
注意 任何 有 副作用 的 函数 都 必需 列 为 易 变 类 ， 即 使 其 结果 相当 有 规律 也 应 该 这 样 ， 这 样 才能 
避免 它 被 优化 ; 一 个 例子 就 是 setval() o 


更 多 细节 ， 请 参阅 Section 35.6. 


LEAKPROOF 


LEAKPROOF 表示 该 函数 没有 涉 密 方面 的 副作用 。 它 除 了 返回 值 外 ， 不 会 泄露 它 的 参数 的 任何 
信息 。 例 如 ， 一 个 画 数 抛 出 了 一 个 参数 不 正确 的 错误 ， 但 错误 消息 里 包含 了 参数 值 的 信息 ， 
那 这 个 函数 就 是 不 保密 的 (leakproof)。 查询 计划 生成 器 可 以 把 保密 的 函数 放 到 用 
security_barrier 选项 生成 的 视图 中 ， 而 不 保密 的 函数 则 不 可 以 。 参 见 CREATE VIEW 和 
Section 38.5。 这 个 选项 只 能 由 超级 用 户 设置 


CALLED ON NULL INPUT RETURNS NULL ON NULL INPUT STRICT 


CALLED ON NULL INPUT ( 缺 省 ) 表 明 该 函数 在 自己 的 某 些 参数 是 NULL 的 时 候 还 是 可 以 按照 正常 
的 方式 调用 。 画 数 的 作者 必须 负责 检查 NULL 以 及 进行 相应 地 处 理 。 


RETURNS NULL ON NULL INPUT 或 STRICT 表明 如 果 它 的 任何 参数 是 NULL， WHR AB RE 
NULL。 如 果 声 明了 这 个 参数 ， 则 如 果 存 在 NULL 参数 时 不 会 执行 该 回 数 ; 而 只 是 自动 假设 一 
个 NULL 结果 。 


[EXTERNAL] SECURITY INVOKER [EXTERNAL] SECURITY DEFINER 
SECURITY INVOKER ( 缺 省 ) 表 明 该 画 数 将 使 用 调用 它 的 用 户 权 限 执 行 。 sECURITY DEFINER 声明 
该 图 数 将 以 创建 它 的 用 户 的 权限 执行 。 


关键 字 EXTERNAL 的 目的 是 和 SQL 兼容 ， 它 是 可 选 的 ， 因 为 这 个 特性 适用 于 所 有 函数 ， 而 不 
仅仅 在 SQL 中 的 外 部 函数 。 The key word is allowed for SQL conformance, but it is optional 
since, unlike in SQL, this feature applies to all functions not only external ones. 


_execution_cost_ 
一 个 正 数 ， 表 示 以 cou_operator_ cost F¥*MAZAZBAANASHAAKH. 如 果 画 数 返 回 的 
是 一 个 结果 集 ， 它 表示 的 是 每 行 结果 的 代价 。 如 果 这 个 选项 没有 指定 ， 对 于 用 C 语 言 画 数 和 


内 部 函数 缺 省 值 为 1， 而 其 他 语言 定义 的 函数 缺 省 值 为 100。 较 大 的 值 会 使 查询 计划 生成 器 
在 不 必要 的 情况 下 尽量 避免 调用 该 本 数 。 


_result_rows_ 


一 个 正 数 给 出 了 查询 计划 生成 器 预期 的 该 画 数 返回 的 估算 的 结果 集 行 数 ， 它 仅 允许 返回 结果 
集 的 函数 指定 。 缺 省 值 为 1000。 


_configuration_parameter_ _value_ 


SET 语句 能 在 进入 函数 时 将 某 个 配置 参数 设置 成 指定 的 值 ， FAYSWROREN RSM ZAI 
值 。 SET FROM CURRENT 使 用 会 话 当 前 的 该 参数 值 做 为 进入 函数 时 的 该 参数 的 值 。 


如 果 一 个 加 数 创建 时 带 有 某 个 配置 参数 的 set 语句， 那么 在 函数 内 对 于 同一 参数 
的 set LocAL 语句 的 作用 域 久 限 于 该 函数 : 执行 函数 之 前 的 该 参数 的 值 会 在 函数 返回 后 恢 
复 。 然 而 一 个 一 般 的 同一 参数 的 set 语句 (不 带 Loca.) 的 作用 效果 将 在 函数 返回 后 继续 


保持 ， 直到 当 前 的 事务 回 滚 。 


关于 人 允许 设置 的 参数 和 值 的 进一步 信息 请 参考 SET 和 Chapter 18。 

_definition_ 

—VSELHBANFRH SRS, ALMATA. CUE -CARK —MeEmEtT 
目标 文件 的 路 径 、 一 个 SQL 查询 、 一 个 过 程 语 言 文本 。 


在 写本 数 体 字符 串 时 经 常 使 用 美元 符 引 用 语法 ( 见 Section 4.1.2.4) ， 而 不 通常 的 单 引 号 语 
法 ， 这 是 因为 如 果 不 使 用 美元 符 引 用 语法 ， 在 函数 定义 中 出 现 的 任何 单 引 号 和 反 斜 线 都 需要 
前 面 再 加 一 个 相应 的 相同 字符 来 转 义 。 


obj_file_ , _link_symbol 





这 个 形式 的 as 子 句 用 于 在 函数 的 C 源 文 件 里 的 名 字 和 SQL 名 字 不 同时 可 动态 加 载 C 语言 
RM, FRR _obj_file ”是 包含 可 动态 加 载 对 象 的 文件 名 ， 而 _link_symbol ”是 函数 的 链 
接 符号 ， 也 就 是 该 本 数 在 C 源 文件 里 的 名 字 。 如 果 省 略 了 链接 符号 ， 那 么 就 假设 它 和 被 定义 
的 SQL HRA. 


当 使 用 同一 个 可 动态 加 载 文件 重复 执行 命令 create Function 生成 事 数 时 ， 在 一 个 全 会 话 里 
该 文件 只 会 被 加 载 一 次 。 若 想 卸 载 或 重新 加 载 该 文件 〈 通 常 在 开发 过 程 中 使 用 ) ， 可 以 开启 
一 个 新 的 会 话 。 


_attribute_ 


ARRAN EAA wi. RRA BMA Lettie : 


isStrict 


SERN STRICT BK RETURNS NULL ON NULL INPUT o 


isCachable 
isCachable 是 IMMUTABLE 的 过 时 的 等 效 语法 ; 不 过 出 于 向 下 兼容 ， 仍 然 接受 它 。 
属性 名 是 大 小 写 无 关 的 。 


请 参阅 Section 35.3 获 取 更 多 关于 书写 函数 的 信息 。 


PostgreSQL PARRER; 也 就 是 只 要 输入 参数 不 同 ， 几 个 不 同 的 函数 可 以 同名 。 不 过 ， 
PARA C 名 字 必 须 不 同 ， 也 就 是 说 你 必须 给 予 重 载 的 C 画 数 不 同 的 C 名 字 ( 比 如 ， 使 用 
参数 类 型 作为 C 名 字 的 一 部 分 )。 


如 果 两 个 函数 同名 ， 并 且 输 入 参数 类 型 也 相同 ， 那么 就 认为 这 两 个 函数 是 一 样 的 ， 忽 略 所 有 
our 参数 。 因此 ， 下 面 的 声明 是 冲突 的 : 


CREATE FUNCTION foo(int) ... 
CREATE FUNCTION foo(int, out text) ... 


EMAANESRANMSRTMN NACE RA MN, 但 是 如 果 定 义 了 默认 值 在 调用 时 就 有 
可 能 产生 冲突 ， 例 如 ， 考 虑 下 面 定义 


CREATE FUNCTION foo(int) ... 
CREATE FUNCTION foo(int, int default 42) ... 


KHG foo(10) 将 会 失败 ， 因 为 系统 不 知道 该 调用 哪 一 个 函数 版 本 。 


NN a 
ťa 
允许 你 将 完整 的 SQL 类 型 语法 用 于 输入 参数 和 返回 值 。 不 过 ， 有 些 类 型 声明 的 细节 (比如 


numeric 类 型 的 精度 域 ) 是 由 下 层 画 数 实现 负责 的 ， a. CREATE FUNCTION ADIBI He 
吞 掉 (也 就 是 不 再 被 识别 或 强制 )。 


在 使 用 CREATE OR REPLACE FUNCTION 替换 一 个 已 存在 加 数 的 定义 时 ， 改变 函数 的 参数 名 字 有 
一 些 限制 。 你 不 能 对 已 使 用 了 名 字 的 输入 参数 改名 (但 是 你 可 以 给 没有 使 用 名 字 的 输入 参数 
加 一 个 名 字 ) 。 如 果 该 范 数 有 超过 一 个 输出 参数 ， 你 也 不 能 改变 输出 参数 的 名 字 ， 因 为 改名 
会 改变 用 来 描述 函数 返回 结果 的 匿名 复合 类 型 的 列 名 。 这 些 限制 都 是 为 了 使 在 蔡 换 函数 的 定 
义 后 对 该 本 数 的 已 有 调用 还 能 正常 工作 。 


如 果 一 个 范 数 声名 为 sTRICT ， 并 带 有 一 个 _vARIADIC 模式 的 参数 ， 参数 的 严格 性 检查 将 可 
变数 组 整体 看 作 非 空 的 (non-null) 。 所 以 当 调 用 时 参数 数组 有 空 (null) wR, ABBR 
然 会 被 调用 。 


例子 


这 里 是 一 些 简 单 的 例子 ， 用 于 帮助 你 开始 掌握 这 个 命令 。 更 多 信息 和 例子 ， 参阅 Section 
35.3 


CREATE FUNCTION add(integer, integer) RETURNS integer 
AS 'select $1 + $2;' 
LANGUAGE SQL 
IMMUTABLE 
RETURNS NULL ON NULL INPUT; 


利用 参数 名 用 PL/pgSQL 自 增 一 个 整数 : 


CREATE OR REPLACE FUNCTION increment(i integer) RETURNS integer AS $$ 
BEGIN 
RETURN i + 1; 
END; 
$$ LANGUAGE plpgsql; 


返回 一 个 包含 多 个 输出 参数 的 记录 : 


CREATE FUNCTION dup(in int, out f1 int, out f2 text) 
AS $$ SELECT $1, CAST($1 AS text) || ' is text' $$ 
LANGUAGE SQL; 


SELECT * FROM dup(42); 


你 可 以 通过 命名 明确 的 复合 类 型 的 方法 宛 长 地 干 同 祥 的 事情 : 


CREATE TYPE dup_result AS (f1 int, f2 text); 

CREATE FUNCTION dup(int) RETURNS dup_result 
AS $$ SELECT $1, CAST($1 AS text) || ' is text' $$ 
LANGUAGE SQL; 


SELECT * FROM dup(42); 


另 一 个 返回 多 列 的 方法 是 用 TABLE WR: 


CREATE FUNCTION dup(int) RETURNS TABLE(f1 int, f2 text) 
AS $$ SELECT $1, CAST($1 AS text) || ' is text' $$ 
LANGUAGE SQL; 


SELECT * FROM dup(42); 


SAT, TABLE 是 与 前 面 的 例子 完全 不 同 的 ， 因为 它 实 际 上 返回 的 是 一 个 结果 集 ， 而 不 仅仅 是 
一 条 记录 。 


编写 安全 的 SECURITY DEFINER 阔 数 


因为 SECURITY DEFINER 图 数 是 以 创建 它 的 用 户 的 权限 执行 的 ， 所 以 一 定 确保 这 样 的 画 数 不 被 
MA, ATR, 应 该 设置 search_path 排除 可 以 被 任何 不 信任 用 户 更 改 的 模式 。 这 能 避免 
恶 意 用 户 用 生成 的 对 象 来 替代 函数 中 用 到 的 对 象 的 攻击 方法 。 特别 应 该 注意 的 是 临时 表 模 
式 ， 该 模式 默认 在 搜索 路 径 中 排 在 第 一 个 ， 并 且 对 任何 用 户 可 写 。 为 安全 考虑 可 以 强制 临时 
表 模 式 最 后 被 搜索 。 为 了 达到 这 个 目的 ， 可 以 将 pg_temp 放 到 Search_path 的 最 后 。 下 面 是 
安全 定义 函数 的 一 个 例子 : 


CREATE FUNCTION check_password(uname TEXT, pass TEXT) 
RETURNS BOOLEAN AS $$ 
DECLARE passed BOOLEAN; 


BEGIN 
SELECT (pwd = $2) INTO passed 
FROM pwds 
WHERE username = $1; 
RETURN passed; 
END; 


$$ LANGUAGE plpgsql 
SECURITY DEFINER 
- 设置 安全 的 search_path: 信任 的 模式 ， 然 后 是 'pg_temp' 模式 
SET search_path = admin, pg_temp; 


因为 PostgreSQL 8.3 版 本 没有 set ñ, MUERTO AKRE RI ARG, KK 
置 和 恢复 search_path 参数 ， 而 使 用 ser 选项 则 简单 的 多 。 


另 一 个 需要 注意 的 是 : 默认 新 创建 的 本 数 的 执行 权限 被 授予 了 PuBLIc ， (更 多 信息 见 
GRANT) . 更 常见 的 是 你 希望 限制 安全 函数 只 给 某 些 用 户 使 用 。 为 了 实现 这 个 目的 ， 你 必须 
收回 默认 的 给 purc 的 权限 ， 并 且 单 独 给 选 定 用 户 分 配 权限 。 为 消除 新 男 数 能 被 所 有 人 执行 
的 时 间 窗 口 ， 可 以 在 一 个 事务 中 创建 和 设置 本 数 权限 ， 例 如 : 


BEGIN; 
CREATE FUNCTION check_password(uname TEXT, pass TEXT) ... SECURITY DEFINER; 
REVOKE ALL ON FUNCTION check_password(uname TEXT, pass TEXT) FROM PUBLIC; 
GRANT EXECUTE ON FUNCTION check_password(uname TEXT, pass TEXT) TO admins; 
COMMIT; 


RANE 


PostgreSQL 里 的 版 本 和 SQL:1999 里 的 create Function 命令 类 似 但 是 不 完全 兼容 。 属性 
和 可 以 使 用 的 语言 都 是 不 可 移植 的 。 


为 了 和 一 些 其 它 的 数据 库 系 统 兼 容 ， _argmode ”可 以 在 _argname ”之 前 或 者 之 后 宇 ， 但 是 
只 有 第 一 种 写法 是 与 标准 兼容 的 。 

对 于 默认 参数 ，SQL 标 准 仅 仅 规定 了 使 用 eraut 关键 字 的 语法 。 在 TSQL 和 Firebird 
中 ， 也 使 用 = 的 语法 。 


参见 


一 


ALTER FUNCTION, DROP FUNCTION, GRANT, LOAD, REVOKE, createlang 


CREATE GROUP 


Name 


CREATE GROUP -- 定义 一 个 新 数据 库 角 色 


Synopsis 


CREATE GROUP _name_ [ [ WITH ] _option_[... ] ] 
这 里 的 option “可 以 是 : 


SUPERUSER | NOSUPERUSER 
CREATEDB | NOCREATEDB 
CREATEROLE | NOCREATEROLE 
CREATEUSER | NOCREATEUSER 
INHERIT | NOINHERIT 

LOGIN | NOLOGIN 

[ ENCRYPTED | UNENCRYPTED ] PASSWORD '_password_' 
VALID UNTIL '_timestamp_' 

IN ROLE _role_name_ [, ...] 
IN GROUP _role_name_ [, ...] 
ROLE _role_name_ [, ...] 
ADMIN _role_name_ [, ...] 
USER _role_name_ [, ...] 
SYSID _uid_ 


CREATE GROUP 现在 是 CREATE ROLE 的 别名 。 


兼容 性 


SQL 标准 里 没有 CREATE GROUP 语句 。 


义 见 


CREATE ROLE 


CREATE INDEX 


Name 
CREATE INDEX -- 创建 一 个 索引 
Synopsis 


CREATE [ UNIQUE ] INDEX [ CONCURRENTLY ] [ _name_ ] ON _table_name_ [ USING _method_ ] 
( { _column_name_ | ( _expression_ ) } [ COLLATE _collation_ ] [ _opclass_ ] [ ASC | 








[ WITH ( _storage_parameter_ = _value_[, ... ] ) ] 
[ TABLESPACE _tablespace_name_ ] 
[ WHERE _predicate_ ] 





CREATE INDEX 在 一 个 指定 表 或 者 物化 视图 的 指定 列 上 创建 一 个 索引 ,索引 主要 用 来 提高 数据 库 
的 效率 (尽管 不 合理 的 使 用 将 导致 较 慢 的 效率 ) 


索引 的 键 字 是 用 列 名 来 声明 的 ,或 者 在 括号 里 面 写 一 个 表达 式 MARRS HS URS Bits 
可 以 指定 多 个 字段 . 


一 个 素 引 域 可 以 是 一 个 使 用 表 的 一 个 或 多 个 字段 进行 计算 的 表达 式 。 这 个 特性 可 以 快速 访问 
一 些 基础 数据 的 变形 .例如 ,一 个 在 upper (col) 上 计算 的 索引 允许 WHERE upper(col) = 'JIM' 字 
名 使 用 这 个 索引 . 


PostgreSQL 提 供 的 索引 类 型 包括 B-tree, hash, GiST, SP-GiST 和 GIN. 用 户 也 可 以 自己 定义 素 
引 类 型 ,但 这 是 相当 复杂 的 . 


当 使 用 wer 字句 ,将 会 创建 一 个 partial index. 一 个 部 分 索引 是 仅 包括 表 的 一 部 分 记录 的 索引 ， 
通常 是 比 表 中 其 他 部 分 更 有 用 的 记录 . 例如 ,如 果 你 有 一 个 包含 了 记 账 和 不 记 账 的 订单 ,不 记 帐 
的 订单 只 占 了 表 的 一 小 部 分 ,并 且 是 经 常 使 用 的 部 分 .你 可 以 在 这 部 分 上 建立 一 个 索引 来 提高 交 
率 . 另 一 个 应 用 是 使 用 whERE 和 ungue 来 强制 保证 表 的 一 个 子 集 的 唯一 性 .更 多 的 信息 

见 :Section 11.8 


WHERE 字句 的 表达 式 可 以 使 用 底层 表 的 列 ,并 且 可 以 是 用 它 的 所 有 列 ,而 不 仅仅 建立 素 引 的 列 . 
目前 子 查 询 和 聚合 表达 式 时 禁止 出 现在 wHERE 字句 的 ,这 个 限制 同样 适用 于 索引 . 


ERIE ERMA RARE A ci 2" immutable", Blt ih is Bik MS th WER, Mh 
不 受 任何 外 部 的 数据 的 影响 (例如 另 一 个 表 的 内 容 ,或 当前 时 间 ). 这 个 限制 保证 了 索引 的 定义 完 
整 性 .在 一 个 索引 或 wer 子 句 中 使 用 用 户 自 定义 的 函数 时 ,确保 在 定义 这 些 函 数 时 标记 他 们 是 
不 可 变 的 . 


Parameters 

UNIQUE 

当 索 引 被 创建 时 使 系统 检查 表 的 重复 值 (如 果 已 经 有 数据 ), 并 且 当 有 数据 插入 时 检查 唯一 性 . 当 
插入 数据 或 更 新 数据 导致 重复 记录 时 将 会 产生 一 个 错误 

CONCURRENTLY 

当 使 用 这 个 选项 时 , PostgreSQL 在 生成 索引 时 将 不 会 在 表 上 加 任何 锁 阻 止 并 发 的 插入 ,更 新 , 删 


除 .而 标准 的 建立 一 个 索引 将 产生 一 个 阻止 写 ( 不 包括 污 ) 的 锁 直 到 索引 建立 完毕 . 当 使 用 这 个 选 
项 时 有 一 些 问题 需要 注意 , 详 见 :并 发 建立 索引 . 

被 创建 索引 的 名 字 . 这 里 不 需要 包括 模式 的 名 字 , 索 引 总 是 在 同一 个 模式 中 作为 其 父 表 创建 的 .如 
果 忽 略 这 个 选项 ,PostgreSQL 基 于 父 表 的 名 字 和 建立 索引 的 列 选择 一 个 合适 的 名 字 . 


_table_name_ 


要 建立 索引 的 表 名 (可 能 有 模式 修饰 ) 

_method_ 

建立 索引 使 用 的 方法 名 字 . 可 选 的 方法 有 btree , hash , gist , spgist and gin .默认 方法 
是 btree . 


_column_name_ 


A 要 建立 素 引 的 列 名 . 

_expression_ 
基于 表 中 一 列 或 多 列 的 表达 式 . 在 上 面 的 语法 中 ,表达 式 必 须 在 园 括号 中 .如 果 表 达 式 有 男 数 调用 
的 格式 则 辆 括号 可 以 省 略 . 


_collation_ 


索引 使 用 排序 方式 的 名 字 , 默 认 索 引 使 用 创建 素 引 列 中 声明 的 排序 方式 ,创建 索引 的 表达 式 结 果 
的 排序 方式 .对 于 使 用 指定 排序 方式 的 表达 式 查 询 ,索引 使 用 指定 的 排序 是 高 效 的 . 


_opclass_ 


操作 符 类 的 名 字 , 详 细 内 容 见 下 面 . 


ASC 


指定 升序 排序 (默认 ). 

DESC 

指定 降序 排序 . 

NULLS FIRST 

指定 null 排 在 非 null 值 前 面 ,在 pesc 中 时 默认 的 . 

NULLS LAST 

指定 null 排 在 非 null 值 后 面 , 默认 在 ese 没有 指定 . 
_storage_parameter_ 

index-method-specific 存储 参数 的 名 字 . 详 细 见 :索引 存储 参数 . 
_tablespace_name_ 
在 哪个 表 空 间 建立 索引 ,如 果 不 指 定 ,将 使 用 default tablespace ,或 者 临时 表 的 索引 将 使 
Fatemp_tablespaces . 


_predicate_ 


部 分 索引 的 约束 表达 式 . 


索引 存储 参数 


可 选 的 with 子 句 指定 了 索引 的 storage parameters. 每 个 索引 方式 有 它 自己 的 存储 参数 .B-tree,， 
hash, GiST and SP-GiST 索 引 都 可 以 带 这 个 参数 . 


FILLFACTOR 

填充 因子 是 一 个 索引 实际 数据 的 百分比 , 它 决 定 索 引 方 法 占用 页 的 空间 的 比率 .对 于 B-trees, 在 
索引 创建 时 叶子 页 填充 这 个 百分比 的 数据 .其 余 的 用 来 扩展 索引 (添加 一 个 新 的 最 大 的 键 值 ). 如 
果 接 下 来 页 占用 100%, 它 将 会 分 页 ,这 将 导致 素 引 效率 的 逐渐 下 降 .B-tree 使 用 一 个 90 做 为 默认 
填充 比 ,但 是 可 以 选择 10 到 100 的 任何 值 .如 果 是 一 个 静态 表 , 填 充 比 使 用 100 将 会 最 大 的 减 小 素 
引 所 占 的 物理 空间 .但 是 对 于 有 大 量 更 新 的 表 一 个 较 小 的 填充 比 将 会 尽 可 能 的 减少 分 页 .其 他 的 
索引 方法 使 用 填充 比 是 不 同 的 但 是 大 致 方法 是 相同 ; 方法 之 间 的 默认 填充 比 不 是 一 致 的 . 
GiST 索 引领 外 接受 这 个 参数 : 

BUFFERING 

在 使 用 Section 55.3.1 建 立 素 引 时 决定 是 否 缓存 建立 的 方法 .使 用 oFF 关闭 这 个 功能 , on 打开 
这 个 功能 . 使 用 auto 它 初始 化 时 是 关闭 的 ,但 是 当 索 引 的 达到 effective_cache _size 将 会 打开 . 
默认 使 用 AuTo . 

GIN 素 引 接 受 一 个 不 同 的 参数 : 


FASTUPDATE 


这 个 设置 用 来 控制 在 Section 57.3.1 中 描述 的 快速 更 新 技术 . 它 是 一 个 布尔 类 型 参数 : oN 使 能 
快速 更 新 , OFF 关闭 这 个 功能 .( 在 Section 18.1 中 描述 了 人 允许 可 选 的 拼写 on and orr .) 默 认 


是 ON. 





Note: 通过 ALTER INDEX 关闭 FAsTUPDATE 防止 将 来 数据 插入 到 待 建立 的 索引 记录 中 ,但 是 
它 自 己 不 写 之 前 的 记录 到 磁 意 .你 可 以 使 用 vacuum 表 来 确保 待 建立 索引 空 . 




















并 发 建立 索引 


建立 一 个 索引 将 影响 正常 的 数据 库 操作 .一 般 的 PostgreSQL 锁 住 建立 索引 的 表 防 止 写 ， 然 后 
通过 扫描 表 来 建立 整个 索引 .其 他 的 事物 可 以 读 表 ,但 是 插 和 人 ,更 新 ,删除 操作 将 被 锁 住 直到 索引 
建立 完成 .如 果 这 是 一 个 线 上 的 生成 库 将 会 有 较 严 重 的 影响 .非常 大 的 表 将 使 用 数 个 小 时 来 建立 
索引 ,即使 一 个 较 小 的 表 ,对 于 生产 库 也 会 在 一 个 不 可 接受 的 时 间 内 锁 住 该 表 的 写 操 作 . 


PostgreSQL 支 持 建立 索引 时 不 锁 写 操作 .这 个 方法 通过 CREATE INDEX 时 指定 CONCURRENTLY 选 
项 , 当 使 用 这 个 选项 时 , PostgreSQL 必 须 打 描 表 2 次 , 它 必须 等 待 所 有 的 将 要 使 用 该 索引 的 事物 
结束 .所 以 这 个 方法 比 标准 的 建立 索引 需要 更 多 的 工作 并 且 花 费 更 多 的 时 间 . 然 而 ,在 建立 素 引 的 
时 候 它 允许 正常 的 操作 所 以 对 于 生产 环境 它 是 非常 有 用 的 .当然 在 建立 索引 时 额外 的 CPU 和 I/o 
开销 可 能 会 降低 其 他 操作 的 效率 . 


在 并 发 创建 索引 中 ， 索 引 在 一 个 事物 中 进入 系统 表 ， 然 后 两 表 扫 描 发 生 在 另外 的 事物 中 .在 
Ama SRS (EARE) 将 会 阻塞 并 发 索引 的 建立 直到 事物 完成 ， 甚至 在 
第 二 静 表 扫描 时 事物 仅仅 涉及 到 该 表 . 并 发 建立 索引 使 用 Section 47.59 中 的 方法 等 待 每 一 个 
发 生 的 事物 完成 . 


当 扫 描 表 时 发 生 了 问题 ， 例 如 一 个 唯一 索引 违反 了 唯一 性 ， create INDEX 将 会 失败 并 且 留 
一 个 "invalid" 索 引 ， 在 查询 时 这 个 索引 将 会 被 忽略 因为 他 是 不 完整 的 ; 然而 它 仍然 会 增加 更 新 
的 开销 .psql \d 命令 将 列 出 带 INvALID 的 索引 . 


postgres=# \d tab 
Table "public.tab" 


Column | Type | Modifiers 
yeaa ea E EA ee pre ere ey 
col | integer | 

Indexes: 


"idx" btree (col) INVALID 


这 种 情况 推荐 的 恢复 方法 是 删除 掉 索 引 并 且 再 次 执行 CREATE INDEX CONCURRENTLY. ( 另 一 种 重 


建 素 引 的 方法 是 使 用 REINDEX .然而 ， 因 为 REINDEX 不 支持 并 发 建立 索引 ， 所 以 这 种 方式 可 用 
MAB. ) 


另 一 个 缺点 是 当 并 发 建立 唯一 索引 第 二 通 扫 描 表 后 唯一 性 将 会 约束 其 他 事物 ， 这 意味 着 在 索 
引 建立 完成 前 在 其 他 查询 中 违反 了 该 索引 将 会 报 违 反 约 束 错 误 ， 即 使 最 后 索引 建立 失败 .如 
果 在 第 二 通 扫 描 发 生 了 错误 ， 在 后 续 的 操作 中 "invalid" 索 引 也 会 (在 相关 列 上 ) 保持 该 唯一 
性 . 


支持 建立 并 发 素 引 和 部 分 素 引 ， 在 这 些 语句 中 出 现 错误 将 会 产生 和 前 面 违 反 唯 一 性 约束 相似 


的 错误 . 


标准 建立 素 引 允许 并 行 的 执行 其 他 标准 的 建立 素 引 语句 ， 但 是 在 一 个 表 上 一 次 仅 可 以 有 一 个 
并 发 建立 素 引 语句 ， 在 这 两 种 情况 下 ， 建 立 素 引 的 同时 不 允许 有 其 他 模式 类 型 的 修改 ， 另 一 
个 不 同 点 是 CREATE INDEX 可 以 在 一 个 阻塞 的 事物 里 执行 ， 而 CREATE INDEX CONCURRENTLY 不 
可 以 . 


Notes 


在 Chapter 11 中 描述 了 什么 时 候 会 使 用 索引 ， 什 么 时 候 不 使 用 索引 ， 以 及 在 什么 情况 下 索引 是 
有 用 的 . 


Caution 


哈 希 索引 不 记录 到 WAL 日 志 中 ， 所 以 当 系 统 朋 溃 有 未 写 入 磁盘 的 数据 时 哈 希 索引 需要 使 

用 REINDEX 重新 建立 ， 哈 希 索 引 的 变化 不 能 在 恢复 一 个 基础 各 份 后 通过 流 复制 或 者 文件 复 
制 来 重 写 ,所 以 接 下 来 在 查询 中 使 用 他 们 将 会 给 出 错误 的 结果 .因为 这 些 原 因 使 用 哈 希 索 
引 是 有 阻碍 的 . 


现在 只 有 B-tree, GIST 和 GIN 支 持 多 列 素 引 . 默认 支持 最 多 32 列 . ( 当 编 译 PostgreSQL 时 可 
以 改变 这 个 限制 ) .现在 只 有 B-tree 支 持 唯一 索引 . 


对 于 索引 的 每 一 列 可 以 指定 一 个 operator class. operator class 标 识 了 索引 那 一 列 的 使 用 的 操 
作 符 .例如 一 个 B-tree 索 引 在 一 个 四 字 节 整数 上 可 以 使 用 int4_ops ; 这 个 操作 符 类 包括 四 字 
PRAHARA 实际 上 对 于 列 上 的 数据 类 型 默认 的 操作 符 类 时 足够 用 的 . 操作 符 类 主要 


用 于 一 些 有 多 种 排序 的 数据 ， 例 如， 我 们 想 按 照 绝 对 值 或 者 实数 部 分 排序 一 个 复数 .我 们 能 
通过 定义 两 个 操作 符 类 然后 当 建 立 索 引 时 选择 合适 的 类 .详细 的 操作 符 类 信息 请 参 


考 : Section 11.9 和 Section 35.14. 


索引 (现在 只 有 B-tree) 中 支持 有 序 扫描 的 字句 中 可 以 制定 asc , DESC, NULLS FIRST ,和 
NULLS LAST 修改 索引 的 排序 方式 .因为 一 个 有 序 的 索引 能 被 从 前 向 后 或 者 从 后 向 前 扫描 .。 建 
立 一 个 单列 的 pese 索引 是 没有 意义 的 .因为 在 一 个 标准 的 索引 是 已 经 排序 的 . 在 创建 多 列 索 
引 时 使 用 这 些 选 项 值 来 匹配 一 些 复合 查询 的 排序 请 求 ， 例 

如 SELECT ... ORDER BY x ASC, y DESC .如 果 你 在 查询 中 需要 支持 "nulls sort low" 特 性 NuLLs 选 
项 是 很 有 用 的 ， 而 不 是 默认 的 "nulls sort high", 


对 于 大 多 数 索 引 ， 创 建 索 引 的 速度 依赖 于 maintenance_work_mem 的 设置 . 只 要 你 没有 使 他 

超过 可 得 到 内 存 而 进入 swap 分 区 ， 较 大 的 值 将 会 减少 索引 创建 的 时 间 . 对 于 创建 哈 希 索引 的 
时 间 与 effective_cache size 值 相关 ,PostgreSQL 将 使 用 两 种 不 同 的 哈 希 索引 创建 方法 ， 主 要 

取决 于 索引 的 大 小 比 effective cache size 大 还 是 小 . 为 了 得 到 较 好 的 结果 ， 确 保 这 个 参数 的 
设置 考虑 到 可 用 内 存 ， 并 且 注 意 maintenance_work_mem 和 effective_cache_size 的 和 小 于 其 他 
程序 所 需要 的 内 存 空间 . 


使 用 DROP INDEX#I-R—T 4. 


PostgreSQL 之 前 的 版 本 有 一 个 R-tree 索 引 方 法 .这 个 方法 已 经 被 删除 因为 它 对 于 GiST 索 引 没 
有 明显 的 优势 .如 果 指 定 USING rtree ， CREATE INDEX 会 将 他 翻译 为 UsING gist ， 去 转换 老 
的 数据 库 版 本 到 GiST. 


Examples 
TER films 的 title 列 上 建立 B-tree 索 引 : 


CREATE UNIQUE INDEX title_idx ON films (title); 


允许 大 小 写 无 关 查 询 在 lower (title) 表达 式 上 建立 索引 : 


CREATE INDEX ON films ((lower(title))); 


(在 这 个 例子 中 我 们 可 以 选 在 忽略 索引 名 字 ， 系 统 将 给 出 一 个 名 字 ， 典 型 的 


是 films_lower_idx .) 


创建 一 个 使 用 非 默 认 排序 方式 的 索引 : 


CREATE INDEX title_idx_german ON films (title COLLATE "de_DE"); 


创建 一 个 null 值 的 非 默 认 排 序 的 索引 : 


CREATE INDEX title_idx_nulls_low ON films (title NULLS FIRST); 


创建 一 个 非 默认 填充 因子 的 索引 : 


CREATE UNIQUE INDEX title_idx ON films (title) WITH (fillfactor = 70); 


创建 一 个 将 快速 更 新 关闭 的 GIN 索 引 : 


CREATE INDEX gin_idx ON documents_table USING gin (locations) WITH (fastupdate = off); 


创建 一 个 在 films BY code 列 的 索引 ， 并 且 使 素 引 建立 在 indexspace RZ AH : 


CREATE INDEX code_idx ON films (code) TABLESPACE indexspace; 


fE—T BTEL o)EGISTHS|, ik Bes TER RH LAY 2S RE es AY A DOXER IETS : 


CREATE INDEX pointloc 

ON points USING gist (box(location, location) ); 
SELECT * FROM points 

WHERE box(location, location) && '(0,0),(1,1)'::box; 


创建 一 个 在 表 上 不 加 写 锁 的 索引 : 


CREATE INDEX CONCURRENTLY sales_quantity_index ON sales_table (quantity); 
Compatibility 
CREATE INDEX 是 PostgreSQL 语 言 的 扩展 . 在 SQL 标准 中 没有 索引 的 规定 . 


See Also 


ALTER INDEX, DROP INDEX 


CREATE LANGUAGE 


Name 


CREATE LANGUAGE -- define a new procedural language 


Synopsis 


CREATE [ OR REPLACE ] [ PROCEDURAL ] LANGUAGE _name_ 
CREATE [ OR REPLACE ] [ TRUSTED ] [ PROCEDURAL ] LANGUAGE _name_ 
HANDLER _call_handler_ [ INLINE _inline_handler_ ] [ VALIDATOR _valfunction_ ] 


Description 


CREATE LANGUAGE registers a new procedural language with a PostgreSQL database. 
Subsequently, functions and trigger procedures can be defined in this new language. 


Note: As of PostgreSQL 9.1, most procedural languages have been made into 
"extensions", and should therefore be installed with CREATE EXTENSION not 

CREATE LANGUAGE . Direct use of CREATE LANGUAGE should now be confined to extension 
installation scripts. If you have a "bare" language in your database, perhaps as a result 
of an upgrade, you can convert it to an extension using CREATE EXTENSION —_langname 
FROM unpackaged. 


CREATE LANGUAGE effectively associates the language name with handler function(s) that are 
responsible for executing functions written in the language. Refer to Chapter 51 for more 
information about language handlers. 


There are two forms of the CREATE LANGUAGE command. In the first form, the user supplies 
just the name of the desired language, and the PostgreSQL server consults the 

pg_pltemplate system catalog to determine the correct parameters. In the second form, the 
user supplies the language parameters along with the language name. The second form can 
be used to create a language that is not defined in pg_pltemplate , but this approach is 
considered obsolescent. 


When the server finds an entry in the pg_pltemplate catalog for the given language name, it 
will use the catalog data even if the command includes language parameters. This behavior 
simplifies loading of old dump files, which are likely to contain out-of-date information about 
language support functions. 


Ordinarily, the user must have the PostgreSQL superuser privilege to register a new 
language. However, the owner of a database can register a new language within that 
database if the language is listed in the pg_pltemplate catalog and is marked as allowed to 
be created by database owners ( tmpldbacreate is true). The default is that trusted 
languages can be created by database owners, but this can be adjusted by superusers by 
modifying the contents of pg_pltemplate . The creator of a language becomes its owner and 
can later drop it, rename it, or assign it to a new owner. 


CREATE OR REPLACE LANGUAGE will either create a new language, or replace an existing 
definition. If the language already exists, its parameters are updated according to the values 
specified or taken from pg_pltemplate , but the language's ownership and permissions 
settings do not change, and any existing functions written in the language are assumed to 
still be valid. In addition to the normal privilege requirements for creating a language, the 
user must be superuser or owner of the existing language. The REPLACE case is mainly 
meant to be used to ensure that the language exists. If the language has a pg_pltemplate 
entry then REPLACE will not actually change anything about an existing definition, except in 
the unusual case where the pg_pltemplate entry has been modified since the language was 
created. 


Parameters 


TRUSTED 


TRUSTED specifies that the language does not grant access to data that the user would not 
otherwise have. If this key word is omitted when registering the language, only users with 
the PostgreSQL superuser privilege can use this language to create new functions. 


PROCEDURAL 


This is a noise word. 


_name_ 


The name of the new procedural language. The name must be unique among the languages 
in the database. 


For backward compatibility, the name can be enclosed by single quotes. 
HANDLER _call_handler_ 


_call_handler_ is the name of a previously registered function that will be called to execute 
the procedural language's functions. The call handler for a procedural language must be 
written in a compiled language such as C with version 1 call convention and registered with 
PostgreSQL as a function taking no arguments and returning the language_handler type, a 
placeholder type that is simply used to identify the function as a call handler. 


INLINE _inline_handler_ 


_inline_handler_ is the name of a previously registered function that will be called to 
execute an anonymous code block (DO command) in this language. If no _inline_handler_ 
function is specified, the language does not support anonymous code blocks. The handler 
function must take one argument of type internal , which will be the po command's 
internal representation, and it will typically return void . The return value of the handler is 
ignored. 


VALIDATOR _valfunction_ 


_valfunction_ is the name of a previously registered function that will be called when a new 
function in the language is created, to validate the new function. If no validator function is 
specified, then a new function will not be checked when it is created. The validator function 
must take one argument of type oid , which will be the OID of the to-be-created function, 
and will typically return void . 


A validator function would typically inspect the function body for syntactical correctness, but 
it can also look at other properties of the function, for example if the language cannot handle 
certain argument types. To signal an error, the validator function should use the ereport() 
function. The return value of the function is ignored. 


The trusted option and the support function name(s) are ignored if the server has an entry 
for the specified language name in pg_pltemplate . 


Notes 


The createlang program is a simple wrapper around the CREATE LANGUAGE command. It 
eases installation of procedural languages from the shell command line. 


Use DROP LANGUAGE, or better yet the droplang program, to drop procedural languages. 


The system catalog pg_language (see Section 47.28) records information about the 
currently installed languages. Also, createlang has an option to list the installed languages. 


To create functions in a procedural language, a user must have the usace privilege for the 
language. By default, usace is granted to puBLic (i.e., everyone) for trusted languages. 
This can be revoked if desired. 


Procedural languages are local to individual databases. However, a language can be 
installed into the template1 database, which will cause it to be available automatically in all 
subsequently-created databases. 


The call handler function, the inline handler function (if any), and the validator function (if 
any) must already exist if the server does not have an entry for the language in 
pg_pltemplate . But when there is an entry, the functions need not already exist; they will be 
automatically defined if not present in the database. (This might result in CREATE LANGUAGE 
failing, if the shared library that implements the language is not available in the installation.) 


In PostgreSQL versions before 7.3, it was necessary to declare handler functions as 
returning the placeholder type opaque , rather than language_handler . To support loading of 
old dump files, CREATE LANGUAGE will accept a function declared as returning opaque , but it 
will issue a notice and change the function's declared return type to language_handler . 


Examples 


The preferred way of creating any of the standard procedural languages is just: 


CREATE LANGUAGE plper1l; 


For a language not known in the pg_pltemplate catalog, a sequence such as this is 
needed: 


CREATE FUNCTION plsample_call_handler() RETURNS language_handler 
AS '$libdir/plsample' 
LANGUAGE C; 

CREATE LANGUAGE plsample 
HANDLER plsample_call_handler; 


Compatibility 


CREATE LANGUAGE iS a PostgreSQL extension. 


See Also 


ALTER LANGUAGE, CREATE FUNCTION, DROP LANGUAGE, GRANT, REVOKE, 
createlang, droplang 


CREATE MATERIALIZED VIEW 


Name 


CREATE MATERIALIZED VIEW -- 定义 一 个 物化 视图 


Synopsis 


CREATE MATERIALIZED VIEW _table_name_ 
[ (_column_name_ [, ...] ) ] 
[ WITH ( _storage_parameter_ [= _value_] [, ... ] ) ] 
[ TABLESPACE _tablespace_name_ ] 
AS _query_ 
[ WITH [ NO ] DATA ] 


CREATE MATERIALIZED VIEW 定义 一 个 查询 的 物化 视图 。 在 命令 发 出 时 ， 该 查询 被 执行 并 且 用 
于 填充 视图 (除非 使 用 了 wm No pata) ， 并 且 可 以 稍 后 使 用 REFRESH MATERIALIZED VIEW 来 
刷新 。 


CREATE MATERIALIZED VIEW 类 似 于 create TABLE as, 除了 它 也 使 查询 记 住 初始 化 视图 ， 所 以 
稍 后 需要 时 也 可 以 被 刷新 。 物化 视图 和 表 一 样 有 许多 属性 ， 但 是 不 支持 临时 物化 视图 或 自动 
生成 OID。 


参数 


_table_name_ 


要 创建 的 物化 视图 的 名 字 〈 可 以 有 模式 修饰 ) 。 


_column_name_ 
新 的 物化 视图 中 的 字段 名 。 如 果 没 有 提供 字段 名 ， 那 么 使 用 查询 的 输出 字段 名 。 
WITH ( _storage_parameter_ [= _value_ ][,...]) 


这 个 子 句 为 新 的 物化 视图 指定 可 选 的 存储 参数 ; 参阅 存储 参数 获取 更 多 信息 。 所 
有 CREATE TABLE 支持 的 参数 ， cREATE MATERIALIZED VIEW 也 都 支持 ， 除 了 ors. 参 
MJ CREATE TABLE 获 取 更 多 信息 。 


TABLESPACE _tablespace_name_ 


_tablespace_name_ 是 新 的 物化 视图 在 其 中 创建 的 表 空 间 的 名 字 。 如 果 没 有 指定 ， 则 查询 


default_tablespace, 


_query_ 


SELECT、TABLE 或 VALUES 命令 。 这 个 查询 将 在 受到 安全 限制 的 操作 内 运行 ; 特别 的 ， 对 
函数 的 调用 本 身 创 建 临 时 表 将 会 失败 。 


WITH [ NO ] DATA 


这 个 子 句 说 明 物 化 视图 是 否 在 创建 时 填充 。 如 果 不 ， 物 化 视图 将 被 标记 为 不 可 扫描 ， FAA 
能 被 查询 ， 直 到 使 用 了 REFRESH MATERIALIZED VIEW o 


兼容 性 


CREATE MATERIALIZED VIEW 是 一 个 PostgreSQL 扩 展 。 


义 见 


ALTER MATERIALIZED VIEW, CREATE TABLE AS, CREATE VIEW, DROP 
MATERIALIZED VIEW, REFRESH MATERIALIZED VIEW 


CREATE OPERATOR 


Name 


CREATE OPERATOR -- 定义 一 个 新 操作 符 


Synopsis 


CREATE OPERATOR _name_ ( 
PROCEDURE = _function_name_ 
[, LEFTARG = _left_type_ ] [, RIGHTARG = _right_type_ ] 
[, COMMUTATOR = _com_op_ ] [, NEGATOR = _neg_op_ ] 
[, RESTRICT = _res_proc_ ] [, JOIN = _join_proc_ ] 
[, HASHES ] [, MERGES ] 


CREATE OPERATOR 定义 一 个 新 的 _name_ 操作 符 。 定义 该 操作 符 的 用 户 将 成 为 其 所 有 者 。 如 果 
给 出 了 一 个 模式 名 ， 那么 该 操作 符 将 在 指定 的 模式 中 创建 。 否 则 它 会 在 当前 模式 中 创建 。 


操作 符 name 是 一 个 最 多 NAMEDATALEN -1 长 的 ( 缺 省 为 63 个 ) 下 列 字 符 组 成 的 字符 串 : 


n /<>=~!I@#%^&|*? 
你 选择 名 字 的 时 候 有 几 个 限制 : 
。 -- 和 /* 不 能 在 操作 符 名 的 任何 地 方 出 现 ， 因为 它们 会 被 认为 是 一 个 注释 的 开始 。 
。 一 个 多 字符 的 操作 符 不 能 以 + 或 - 结尾 ， 除非 该 名 字 还 包含 至 少 下 面 字符 之 一 : 
~I@#%^&|'? 


例如 ， @- 是 一 个 允许 的 操作 符 名 ,但 *- 不 是 。 这 个 限制 允许 PostgreSQL 分 析 SQL 
兼容 的 查询 而 不 要 求 在 符号 之 间 有 空白 。 


。 zagt; 作为 一 个 操作 符 名 的 使 用 已 经 废弃 了 。 可 能 在 未 来 的 版 本 中 完全 禁用 。 
操作 符 != 在 输入 时 映射 成 &lt;&gt; ， 因此 这 两 个 名 称 总 是 等 价 的 。 


至 少 需要 定义 一 个 LEFTARG 和 RIGHTARG6 o 对 于 双 目 操作 符 来 说 ， 两 者 都 需要 定义 。 对 右 目 操 
作 符 来 说 ， 只 需要 定义 LEFTARG ， 而 对 于 左 目 操作 符 来 说 ， 只 需要 定义 RIGHTARG o 


同样 ， _function_name ”过 程 必 须 已 经 用 create FUNCTION 定义 过 ， 而 且 必 须 定 义 为 接受 正确 
数量 的 指定 类 型 参数 (一 个 或 是 两 个 )。 


其 它 子 句 声明 可 选 的 操作 符 优 化 子 句 。 他 们 的 含义 在 Section 35.13 里 定义 。 


要 想 能 够 创建 一 个 操作 符 ， 你 必须 在 参数 类 型 和 返回 类 型 上 有 usas 权限 ， REER EHR 
上 有 execute 权限 。 如 果 指 定 了 交换 或 者 负 操 作 符 ， 你 必须 拥有 这 些 操作 符 。 


参数 


_name_ 


要 定义 的 操作 符 。 可 用 的 字符 见 上 文 。 其 名 字 可 以 用 模式 修饰 ， 比 
如 CREATE OPERATOR myschema.+ (...) 。 如 果 没 有 模式 ， 则 在 当前 模式 中 创建 操作 符 。 同 一 个 
模式 中 的 两 个 操作 符 可 以 有 一 样 的 名 字 ， 只 要 他 们 操作 不 同 的 数据 类 型 。 这 叫做 重 载 。 


_function_name_ 
AFRA RRA 
_left_type_ 


操作 符 左 边 的 参数 数据 类 型 ， 如 果 存 在 的 话 。 如 果 是 左 目 操作 符 ， 这 个 参数 可 以 省 略 。 


_right_type_ 


操作 符 右 边 的 参数 数据 类 型 ， 如 果 存 在 的 话 。 如 果 是 右 目 操 作 符 ， 这 个 参数 可 以 省 略 。 


_com_op_ 


该 操作 符 对 应 的 交换 操作 符 。 


—neg_op_ 


该 操作 符 对 应 的 负 操 作 符 。 


_res_proc_ 


UCHR VE FT 4 Rik EE ARK. 


_join_proc_ 


WERE Rye Hest SUE iF (AL 


HASHES 


表明 此 操作 符 支 持 Hash 连接 。 


MERGES 


表明 此 操作 符 可 以 支持 一 个 融合 连接 。 


使 用 oPERATOR() 语法 在 como ”或 者 其 它 可 选 参数 里 给 出 一 个 模式 修饰 的 操作 符 名 ， 比 
如 : 


COMMUTATOR = OPERATOR(myschema.===) , 


参阅 Section 35.12 中 的 操作 符 章节 获取 更 多 信息 。 


在 CREATE OPERATOR 中 指定 操作 符 的 词法 优先 级 是 不 可 能 的 ， 因为 分 析 器 的 优先 级 行为 是 硬 链 
接 的 。 参 阅 Section 4.1.6 获取 优先 级 的 详细 信息 。 


废弃 的 选项 SORTI, soRT2 、 LTcMP 和 creme 以 前 用 于 指定 与 可 合并 连接 的 操作 符 相 关 的 排 
序 操作 符 的 名 字 。 现在 不 再 需要 了 ， 因 为 相关 操作 符 的 信息 通过 查询 B-tree 操 作 符 类 来 找 
到 。 如 果 给 出 了 这 些 中 的 一 个 选项 ， 那 么 会 忽略 该 选项 ， 除 非 暗中 设置 MERGES 为 真 。 


使 用 DROP OPERATOR 从 数据 库 中 删除 用 户 定义 操作 符 。 使 用 ALTER OPERATOR 修 改 一 个 
数据 库 里 的 操作 符 。 


例子 
下 面 命令 定义 一 个 新 操作 符 : 面积 相等 ， 用 于 box 数据 类 型 。 


CREATE OPERATOR === ( 
LEFTARG = box, 
RIGHTARG = box, 
PROCEDURE = area_equal_procedure, 
COMMUTATOR = ===, 
NEGATOR = !==, 
RESTRICT = area_restriction_procedure, 
JOIN = area_join_procedure, 
HASHES, MERGES 


RAIE 


CREATE OPERATOR 是 PostgreSQL 扩 展 。 SQL 标准 中 没有 该 语句 。 


义 见 


ALTER OPERATOR, CREATE OPERATOR CLASS, DROP OPERATOR 


CREATE OPERATOR CLASS 


Name 


CREATE OPERATOR CLASS -- 定义 一 个 新 操作 符 类 


Synopsis 


CREATE OPERATOR CLASS _name_ [ DEFAULT ] FOR TYPE _data_type_ 
USING _index_method_ [ FAMILY _family_name_ ] AS 
{ OPERATOR _strategy_number_ _operator_name_ [ ( _op_type_, _op_type_ ) ] [ FOR SEARCH 
| FUNCTION _support_number_ [ ( _op_type_ [ , _op_type_ ] ) ] _function_name_ ( _argum 











| STORAGE _storage_type_ 





fia ah 


CREATE OPERATOR CLASS 定义 一 个 新 的 操作 符 类 。 一 个 操作 符 类 定义 一 种 特定 的 数据 类 型 如 何 
与 一 种 索引 一 起 使 用 。 操作 符 类 声明 特定 的 操作 符 可 以 为 这 种 数据 类 型 以 及 这 种 索引 方法 填 
充 特定 的 角色 或 者 "策略 "。 操 作 符 类 还 声明 索引 方法 在 为 一 个 索引 字段 选 定 该 操作 符 类 的 时 
候 要 使 用 的 支持 过 程 。 所 有 操作 符 类 使 用 的 函数 和 操作 符 都 必须 在 创建 操作 符 类 之 前 定义 。 


如 果 给 出 了 模式 名 字 ， 那 么 操作 符 类 就 在 指定 的 模式 中 创建 。 否则 就 在 当前 模式 中 创建 。 在 
同一 个 模式 中 的 两 个 操作 符 类 可 以 有 同样 的 名 字 ， 但 它们 必须 用 于 不 同 的 索引 方法 。 


定义 操作 符 类 的 用 户 将 成 为 其 所 有 者 。 目 前 ， 创 造 者 必须 是 超级 用 户 。 做 这 样 的 限制 是 因为 
一 个 有 问题 的 操作 符 类 定义 会 让 服务 器 困惑 ， 基 至 崩溃 。 


CREATE OPERATOR CLASS 既 不 检查 这 个 类 定义 是 否 包含 所 有 索引 方法 需要 的 操作 符 以 及 本 数 ， 
也 不 检查 这 些 操作 符 和 画 数 是 否 形成 一 个 自 包 含 的 集合 。 定义 一 个 合法 的 操作 符 类 是 用 户 的 
责任 。 

相关 的 操作 符 类 可 以 集合 成 操作 符 族 。 添加 一 个 新 的 操作 符 类 到 一 个 已 经 存在 的 操作 符 族 ， 

在 CREATE OPERATOR CLASS 中 指定 FAMILY 选项 。 没有 这 个 选项 ， 新 建 的 类 会 放置 到 与 它 同 名 
的 族 中 (如果 不 存在 则 创建 它 ) 。 


参考 Section 35.14 获 取 更 多 信息 。 


参数 


_name_ 


将 要 创建 的 操作 符 类 的 名 字 ( 可 以 用 模式 修饰 )。 


DEFAULT 

表示 该 操作 符 类 将 成 为 它 的 数据 类 型 的 缺 省 操作 符 类 。 对 于 某 个 数据 类 型 和 访问 方式 而 言 ， 
最 多 有 一 个 操作 符 类 是 缺 省 的 。 

_data_type_ 

这 个 操作 符 类 义理 的 字段 的 数据 类 型 。 


index_method 





这 个 操作 符 类 处 理 的 索引 方法 的 名 字 。 

_family_name_ 

这 个 操作 符 类 添加 到 的 现 有 操作 符 族 的 名 字 。 如 果 没有 指定 ， 则 使 用 与 该 操作 符 类 相同 名 字 
的 操作 符 族 (如 果 不 存 在 则 创建 它 ) 。 


_strategy_number_ 


一 个 操作 符 和 这 个 操作 符 类 关联 的 索引 方法 的 策略 数 。 

_operator_name_ 

一 个 和 该 操作 符 类 关联 的 操作 符 的 名 字 ( 可 以 用 模式 修饰 )。 

_op_type_ 

在 oPERATOR 子 句 中 ， 该 操作 符 的 操作 数 的 数据 类 型 ， 或 者 是 NoNE 表示 左 目 或 者 右 目 操作 

符 。 通常 情况 下 可 以 省 略 操作 数 的 数据 类 型 ， 因 为 这 个 时 候 它 们 和 操作 符 类 的 数据 类 型 相 

同 。 

在 Function 子 句 中 ， 如 果 男 数 的 操作 数 数据 类 型 和 男 数 的 输入 数据 类 型 (a4 FB-tree Loe E 
数 和 哈 希 函数 ) 或 类 的 数据 类 型 (对 于 B-tree 排 序 支持 函数 和 所 有 在 GiST、SP-GiST 和 GIN 
操作 符 类 中 的 函数 ) 不 同 ， 那么 就 在 该 子 句 中 写 上 这 个 范 数 要 支持 的 操作 数 类 型 。 这 些 缺 省 
是 正确 的 ， 因此 _op_type. 不 需要 在 FuNcTION 子 句 中 指定 ， 除了 B-tree 排 序 支持 罚 数 支持 
交叉 数据 类 型 比较 的 情况 。 


sort_family_name 





描述 与 排序 操作 符 相 关 的 排序 顺序 的 现 有 btree 操作 符 族 的 名 字 (可 以 有 模式 修饰 ) 。 


如 果 既 没有 指定 For search ， 也 没有 指定 FOR ORDER BY, 那么 缺 省 是 FOR SEARCH o 


_support_number_ 


索引 方法 对 一 个 与 操作 符 类 关联 的 函数 的 支持 过 程 数 


_function_name_ 


— THR AFAR SUE tp), ARRERA A ERE BY SH FE. 


_argument_type_ 


MBA ASHE X A 


_storage_type_ 


实际 存储 在 索引 里 的 数据 类 型 。 通 常 它 和 字段 数据 类 型 相同 ， 但 是 一 些 索引 方法 (目前 是 GiST 
和 GIN) 人 允许 它 是 不 同 的 。 除非 索引 方法 允许 使 用 一 种 不 同 的 类 型 ， 否 则 必须 省 略 sToRAGE 子 
句 。 


OPERATOR 、 FUNCTION 和 storace 子 句 可 以 按照 任意 顺序 出 现 。 


注意 
因为 过 引 机 制 不 在 使 用 醒 数 前 检查 其 访问 机 制 ， 在 操作 符 关 中 包 合 操作 符 或 者 画 数 等 价 于 授 
给 所 有 人 执行 权限 。 这 对 于 那些 用 于 操作 符 类 的 丽 数 通常 不 会 导致 什么 问题 


操作 符 不 应 该 用 SQL 函数 定义 。 一 个 SQL 函数 很 可 能 是 内 联 到 调用 它 的 查询 里 面 ， 这 样 将 
阻止 优化 器 识别 这 个 查询 是 否 可 以 使 用 索引 。 


PostgreSQL 8.4 之 前 ， oPERATOR 子 句 可 以 包括 recheck 选项 。 现 在 不 再 支持 了 ， 因为 一 个 
索引 操作 符 是 否 是 "有 损耗 的 "， 现 在 是 在 运行 时 动态 确定 。 这 人 允许 高 效 的 处 理 操作 符 有 或 没 
有 损耗 的 情况 。 


例子 


下 面 的 例子 命令 为 数据 类 型 _int4 ( inta 数组 ) 定义 了 一 个 GIST 索引 操作 符 类 。 参 阅 intarray 
模块 获取 完整 的 例子 。 


CREATE OPERATOR CLASS gist__int_ops 
DEFAULT FOR TYPE _int4 USING gist AS 


OPERATOR 3 &&, 

OPERATOR 6 = (anyarray, anyarray), 

OPERATOR 7 @>, 

OPERATOR 8 <Q, 

OPERATOR 20 @@ (_int4, query_int), 

FUNCTION 1 g_int_consistent (internal, _int4, int, oid, internal), 
FUNCTION 2 g_int_union (internal, internal), 

FUNCTION 3 g_int_compress (internal), 

FUNCTION 4 g_int_decompress (internal), 

FUNCTION 5 g_int_penalty (internal, internal, internal), 
FUNCTION 6 g_int_picksplit (internal, internal), 
FUNCTION 7 g_int_same (_int4, _int4, internal); 
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CREATE OPERATOR FAMILY 


Name 


CREATE OPERATOR FAMILY -- 定义 一 个 新 操作 符 族 


Synopsis 


CREATE OPERATOR FAMILY _name_ USING _index_method 
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CREATE OPERATOR FAMILY 创建 一 个 新 的 操作 符 族 。 一 个 操作 符 族 定义 一 个 相关 的 操作 符 类 的 
集合 ， 或 许 还 有 和 与 这 些 操作 符 类 兼容 但 对 单独 索引 的 运行 不 重要 的 一 些 额外 的 操作 符 和 支持 
WA, (对 索引 来 说 重要 的 操作 符 和 辑 数 应 该 分 组 到 相关 的 操作 符 类 中 ， 而 不 是 "散漫 "在 操 
作 符 族 中 。 典 型 的 ， 单 数据 类 型 操作 符 绑 定 到 操作 符 类 中 ， 而 交叉 数据 类 型 操作 符 可 以 散漫 
在 一 个 包含 两 种 数据 类 型 的 操作 符 类 的 操作 符 族 中 。 ) 


新 的 操作 符 族 初始 为 空 。 应 该 随后 发 出 CREATE OPERATOR CLASS 命令 来 添加 所 包含 的 操作 符 
类 ， 和 可 选 的 ALTER OPERATOR FAMILY 命令 来 添加 "散漫 的 "操作 符 和 它们 对 应 的 支持 函数 。 


如 果 给 出 了 模式 名 ， 则 操作 符 族 在 指定 的 模式 中 创建 。 否 则 在 当前 模式 中 创建 。 同一 个 模式 
中 的 两 个 操作 符 族 可 以 有 相同 的 名 字 ， 只 要 他 们 处 理 的 索引 方法 不 同 就 可 以 。 


定义 操作 符 族 的 用 户 成 为 其 所 有 者 。 目 前 ， 创 建 操作 符 族 的 用 户 必须 是 超级 用 户 。 做 这 个 
限制 是 因为 错误 的 操作 符 族 的 定义 会 导致 服务 器 混乱 ， 甚 至 崩溃 。 ) 


参阅 Section 35.14 获 取 更 多 信息 。 


参数 


_name_ 


要 创建 的 操作 符 族 的 名 字 。 该 名 字 可 以 有 模式 修饰 。 


index_method 





这 个 操作 符 族 处 理 的 索引 方法 的 名 字 。 
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兼容 性 


CREATE OPERATOR FAMILY 是 一 个 PostgreSQL 扩展 。 在 SQL 标准 中 没有 这 个 语句 。 


XI 


ALTER OPERATOR FAMILY, DROP OPERATOR FAMILY, CREATE OPERATOR CLASS, 
ALTER OPERATOR CLASS, DROP OPERATOR CLASS 
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CREATE ROLE 


Name 


CREATE ROLE -- 定义 一 个 新 的 数据 库 角色 


Synopsis 


CREATE ROLE _name_ [ [ WITH ] _option_[... ] ] 


where 


~_option_~ can be: 


SUPERUSER | NOSUPERUSER 

CREATEDB | NOCREATEDB 

CREATEROLE | NOCREATEROLE 

CREATEUSER | NOCREATEUSER 

INHERIT | NOINHERIT 

LOGIN | NOLOGIN 

REPLICATION | NOREPLICATION 

CONNECTION LIMIT _connlimit_ 

[ ENCRYPTED | UNENCRYPTED ] PASSWORD '_password_' 
VALID UNTIL '_timestamp_' 


IN ROLE _role_name_ [, ...] 
IN GROUP _role_name_ [, ...] 
ROLE _role_name_ [, ...] 
ADMIN _role_name_ [, ...] 
USER _role_name_ [, ...] 
SYSID _uid_ 
Description 


CREATE ROLE 命令 用 于 为 PostgreSQL 数 据 库 集群 增加 新 的 角色 。 角色 是 拥有 数据 库 对 象 和 数 
据 库 权限 的 实体 。 一 个 角色 可 以 依据 其 被 使 用 的 情况 ， 被 看 做 一 个 用 户 "user" 或 者 一 个 组 
"group"。 参考 Chapter 20 和 Chapter 19 这 两 个 文档 ， 去 获取 有 关 用 户 和 认证 管理 的 相关 信 
息 。 你 必须 要 有 cREATEROLE 权限 ， 或 者 你 是 一 个 超级 用 户 ， 你 才能 使 用 CREATE ROLE 命令 。 


注意 ， 角 色 是 定义 在 数据 库 集 群 级 别 的 ， 所 以 在 集群 中 的 所 有 数据 库 中 都 是 有 效 的 。 


_name_ 


新 角色 的 名 称 。 


SUPERUSER “NOSUPERUSER 


这 两 个 条 件 决 定 一 个 新 的 角色 是 否 为 一 个 超级 用 户 ("superuser") ， 超 级 用 户 可 以 超越 数据 
库 内 的 所 有 访问 限制 。 超级 用 户 状 态 是 危险 的 ， 应 该 在 真正 需要 的 情况 下 才 被 使 用 。 你 自己 
必须 是 一 个 超级 用 户 ， 才 能 创建 一 个 新 的 超级 用 户 。 如 果 没 有 指定 这 个 条 件 ， 缺 省 是 


NOSUPERUSER o 
CREATEDB NOCREATEDB 


这 两 个 条 件 定义 用 户 创建 数据 库 的 权限 。 如 果 被 指定 为 cREATEDB ， 则 该 用 户 被 赋予 创建 数据 
库 的 权限 。 被 指定 为 NocREATEDB 将 没有 创建 数据 库 的 权限 。 如 果 没 有 指定 这 个 条 件 ， 缺 省 


是 NOCREATEDB o 


CREATEROLE NOCREATEROLE 


这 两 个 条 件 决 定 一 个 角色 是 否 被 允许 创建 新 角色 ( 即 ， 执 行 create ROLE 命令 的 权限 ) 。 一 
个 角色 如 果 被 赋予 cREATEROLE 权限 ， 则 同时 也 具有 了 修改 或 删除 其 他 角色 的 权限 。 如 果 没 有 


指定 这 个 条 件 ， 则 缺 省 是 NOCREATEROLE o 
CREATEUSER NOCREATEUSER 


这 两 个 条 件 是 过 时 的 ， 不 过 现在 仍 被 数据 库 接受 ， 他 们 和 条 件 suPERUSER NOSUPERUSER 是 等 
效 的 。 注意 ， 他 们 和 cREATEROLE NOCREATEROLE 并 无 关系 。 


INHERIT NOINHERIT 


These clauses determine whether a role "inherits" the privileges of roles it is a member of. A 
role with the INHERIT attribute can automatically use whatever database privileges have 
been granted to all roles it is directly or indirectly a member of. Without INHERIT , 
membership in another role only grants the ability to SET ROLE to that other role; the 
privileges of the other role are only available after having done so. If not specified, INHERIT 
is the default. 


LOGIN NOLOGIN 


These clauses determine whether a role is allowed to log in; that is, whether the role can be 
given as the initial session authorization name during client connection. A role having the 

LOGIN attribute can be thought of as a user. Roles without this attribute are useful for 
managing database privileges, but are not users in the usual sense of the word. If not 
specified, noLocin is the default, except when CREATE ROLE is invoked through its 
alternative spelling CREATE USER. 这 两 个 参数 决定 一 个 角色 是 否 有 登 进 数据 库 的 权限 ; 一 
个 拥有 Losin 属性 的 角色 (role) ， 可 以 被 视 为 一 个 用 户 (user) 。 


REPLICATION NOREPLICATION 


These clauses determine whether a role is allowed to initiate streaming replication or put the 
system in and out of backup mode. A role having the reptication attribute is a very highly 
privileged role, and should only be used on roles actually used for replication. If not 


specified, NOREPLICATION is the default. 
CONNECTION LIMIT _connlimit_ 


If role can log in, this specifies how many concurrent connections the role can make. -1 (the 
default) means no limit. 


PASSWORD _password_ 


Sets the role's password. (A password is only of use for roles having the LoGIN attribute, 
but you can nonetheless define one for roles without it.) If you do not plan to use password 
authentication you can omit this option. If no password is specified, the password will be set 
to null and password authentication will always fail for that user. A null password can 
optionally be written explicitly as PASSWORD NULL . 


ENCRYPTED UNENCRYPTED 


These key words control whether the password is stored encrypted in the system catalogs. 
(If neither is specified, the default behavior is determined by the configuration parameter 
password_encryption.) If the presented password string is already in MD5-encrypted format, 
then it is stored encrypted as-is, regardless of whether ENCRYPTED Or UNENCRYPTED iS 
specified (since the system cannot decrypt the specified encrypted password string). This 
allows reloading of encrypted passwords during dump/restore. 


Note that older clients might lack support for the MD5 authentication mechanism that is 
needed to work with passwords that are stored encrypted. 


VALID UNTIL ' _timestamp_ ' 


The VALID uNTIL Clause sets a date and time after which the role's password is no longer 
valid. If this clause is omitted the password will be valid for all time. 


IN ROLE _role_name_ 


The IN ROLE Clause lists one or more existing roles to which the new role will be 
immediately added as a new member. (Note that there is no option to add the new role as an 
administrator; use a separate GRANT command to do that.) 


IN GROUP _role_name_ 
IN GROUP is an obsolete spelling of IN ROLE . 
ROLE _role_name_ 


The rote clause lists one or more existing roles which are automatically added as 
members of the new role. (This in effect makes the new role a "group".) 


ADMIN _role_name_ 


The ADMIN clause is like Rote , but the named roles are added to the new role 
WITH ADMIN OPTION , giving them the right to grant membership in this role to others. 


USER _role_name_ 
The user clause is an obsolete spelling of the Rote clause. 
SYSID _uid_ 


The sys1p clause is ignored, but is accepted for backwards compatibility. 


Notes 


Use ALTER ROLE to change the attributes of a role, and DROP ROLE to remove a role. All 
the attributes specified by cREATE ROLE can be modified by later ALTER ROLE Commands. 


The preferred way to add and remove members of roles that are being used as groups is to 
use GRANT and REVOKE. 


The VALID UNTIL Clause defines an expiration time for a password only, not for the role per 
se. In particular, the expiration time is not enforced when logging in using a non-password- 
based authentication method. 


The INHERIT attribute governs inheritance of grantable privileges (that is, access privileges 
for database objects and role memberships). It does not apply to the special role attributes 
set by CREATE ROLE and ALTER ROLE . For example, being a member of a role with 
CREATEDB privilege does not immediately grant the ability to create databases, even if 
INHERIT is set; it would be necessary to become that role via SET ROLE before creating a 
database. 


The INHERIT attribute is the default for reasons of backwards compatibility: in prior releases 
of PostgreSQL, users always had access to all privileges of groups they were members of. 
However, NOINHERIT provides a closer match to the semantics specified in the SQL 
standard. 


Be careful with the cREATEROLE privilege. There is no concept of inheritance for the 

privileges of a CREATEROLE -role. That means that even if a role does not have a certain 

privilege but is allowed to create other roles, it can easily create another role with different 

privileges than its own (except for creating roles with superuser privileges). For example, if 

the role "user" has the cREATEROLE privilege but not the crEeATEDB privilege, nonetheless it 

can create a new role with the createps privilege. Therefore, regard roles that have the 
CREATEROLE privilege as almost-superuser-roles. 


PostgreSQL includes a program createuser that has the same functionality as CREATE ROLE 
(in fact, it calls this command) but can be run from the command shell. 


The CONNECTION LIMIT option is only enforced approximately; if two new sessions start at 
about the same time when just one connection "slot" remains for the role, it is possible that 
both will fail. Also, the limit is never enforced for superusers. 


Caution must be exercised when specifying an unencrypted password with this command. 
The password will be transmitted to the server in cleartext, and it might also be logged in the 
client's command history or the server log. The command createuser, however, transmits the 
password encrypted. Also, psq! contains acommand \password that can be used to safely 
change the password later. 


Examples 


Create a role that can log in, but don't give it a password: 


CREATE ROLE jonathan LOGIN; 


Create a role with a password: 


CREATE USER davide WITH PASSWORD 'jw8s0F4'; 


( CREATE USER is the Same aS CREATE ROLE except that it implies LoGIN .) 


Create a role with a password that is valid until the end of 2004. After one second has ticked 
in 2005, the password is no longer valid. 


CREATE ROLE miriam WITH LOGIN PASSWORD 'jw8s0F4' VALID UNTIL '2005-01-01'; 


Create a role that can create databases and manage roles: 


CREATE ROLE admin WITH CREATEDB CREATEROLE; 


Compatibility 


The cREATE ROLE Statement is in the SQL standard, but the standard only requires the 
syntax 


CREATE ROLE _name_ [ WITH ADMIN _role_name_ ] 


Multiple initial administrators, and all the other options of CREATE ROLE , are PostgreSQL 
extensions. 


The SQL standard defines the concepts of users and roles, but it regards them as distinct 
concepts and leaves all commands defining users to be specified by each database 
implementation. In PostgreSQL we have chosen to unify users and roles into a single kind of 
entity. Roles therefore have many more optional attributes than they do in the standard. 


The behavior specified by the SQL standard is most closely approximated by giving users 
the NOINHERIT attribute, while roles are given the INHERIT attribute. 


See Also 


SET ROLE, ALTER ROLE, DROP ROLE, GRANT, REVOKE, createuser 


CREATE RULE 


Name 


CREATE RULE -- 定义 一 个 新 重 宇 规 则 


Synopsis 


CREATE [ OR REPLACE ] RULE _name_ AS ON _event_ 
TO _table_name_ [ WHERE _condition_ ] 
DO [ ALSO | INSTEAD ] { NOTHING | _command_ | ( _command_ ; _command_... ) } 
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CREATE RULE 定义 一 个 适用 于 特定 表 或 者 视图 的 新 规则 。 CREATE OR REPLACE RULE 要 么 是 创建 
一 个 新 规则 ， 要 么 是 蔡 换 一 个 表 上 的 同名 规则 。 


PostgreSQL 规 则 系统 允许 在 更 新 、 插 入 、 删除 时 执行 一 个 其 它 的 预定 义 动 作 。 简 单 的 说 ， 
规则 就 是 在 指定 表 上 执行 指定 动作 的 时 候 ， 将 导致 一 些 额外 的 动作 被 执行 。 另外 ， 一 

个 INSTEAD 规则 可 以 用 另外 一 个 命令 取代 特定 的 命令 ， 或 者 邻 完全 不 执行 该 命令。 规则 还 可 
以 用 于 实现 SQL 视图 。 规则 实际 上 只 是 一 个 命令 转换 机 制 ， 或 者 说 命令 宏 。 这 种 转换 发 生 在 
命令 开始 执行 之 前 。 如 果 你 想 要 针对 每 个 物理 行 独立 发 生 的 操作 ， 那么 可 能 应 该 使 用 触发 器 
而 不 是 规则 。 有 关 规 则 系统 的 更 多 信息 可 以 在 Chapter 38 找 到 。 


目前 ， oN sELEcT 规则 必须 是 无 条 件 的 insten 规则 并 且 必 须 有 一 个 由 单独 一 条 SELECT 查询 
组 成 的 动作 。 因此 ， 一 条 on secr 规则 有 效 地 把 表 转 成 视图 ， 它 的 可 见 内 容 是 规则 

的 sELECT 查询 返回 的 记录 而 不 是 存储 在 表 GRA) 中 的 内 容 。 写 一 条 CREATE view MA 
比 创建 一 个 表 然 后 在 上 面 定义 一 条 oN SELECT 规则 的 风格 要 好 。 


你 可 以 创建 一 个 允许 更 新 的 视图 的 幻觉 ， 方 法 是 在 视图 上 定义 ON Insert 、 

ON UPDATE 、 ON DELETE 规则 (或 者 满足 你 需要 的 任何 上 述 规则 的 子 集 )， 用 合适 的 对 其 它 表 的 
更 新 蔡 换 在 视图 上 更 新 的 动作 。 如 果 打 算 支 持 INSERT RETURNING ZH, 就 必须 确保 在 规则 的 
结尾 放置 恰当 的 RETURNING 子 句 。 


如 果 你 想 在 复 厅 的 视图 更 新 上 使 用 条 件 规则 ， 那 么 这 里 就 有 一 个 补充 : 对 你 希望 在 视图 上 人 允 
许 的 每 个 动作 ， 你 都 必须 有 一 个 无 条 件 的 INsTEAD 规则 。 如 果 规 则 是 有 条 件 的 或 者 它 不 是 
INSTEAD ， 那 么 系统 仍 将 拒绝 执行 更 新 动作 ， 因为 它 认 为 最 终 会 在 视图 的 虚拟 表 上 执行 这 个 
动作 。 如 果 你 想 处 理 条 件 规则 上 的 所 有 有 用 的 情况 ， 那 只 需要 增加 一 个 无 条 件 的 


DO INSTEAD NOTHING 规则 确保 系统 明白 它 决 不 会 被 调用 来 更 新 虚拟 表 就 可 以 了 。 然后 把 条 件 
规则 做 成 非 insteaD ; 在 这 种 情况 下 ， 如 果 它 们 被 触发 ， 那 么 它们 就 增加 到 缺 省 
的 INSTEAD NOTHING 动作 中 。 (不 过 这 种 方法 目前 不 支持 RETURNING 查询 。) 


Note: 一 个 足够 简单 可 以 自动 更 新 的 视图 (参阅 CREATE VIEW) 不 需要 用 户 创建 的 使 
其 可 更 新 的 规则 。 不 过 ， 你 可 以 创建 一 个 明确 的 规则 ， 自动 更 新 转换 通常 比 明确 的 规则 
执行 的 更 好 。 








另 一 个 可 替换 的 价值 考虑 是 使 用 INsTEAD oF 触发 器 (参阅 CREATE TRIGGER) Bt 


则 。 


参数 


_name_ 


创建 的 规则 名 。 它 必须 在 同一 个 表 上 的 所 有 规则 名 字 中 唯一 。 同一 个 表 上 的 同一 个 事件 类 型 
的 规则 是 按照 字母 顺序 运行 的 。 


_event_ 
SELECT 、 INSERT, UPDATE, DELETE 事件 之 一 。 
_table_name_ 

规则 作用 的 表 或 者 视图 的 名 字 ( 可 以 有 模式 修饰 )。 


_condition_ 


任意 返回 boolean 的 SQL 条 件 表达 式 。 条 件 表达 式 除 了 引用 NEW 和 OLD 之 外 不 能 引用 任何 
RX, 并 且 不 能 有 聚集 酚 数 。 


INSTEAD 
INSTEAD 指示 使 用 该 命令 代 蔡 最 初 的 命令 。 

ALSO 

ALSO 指示 该 命令 点 该 在 最 初 的 命令 执行 之 后 一 起 执行 。 

如 果 既 没有 声明 aso 也 没有 声明 INsTEAD ， 那么 ALso 是 缺 省 。 

_command_ 

组 成 规则 动作 的 命令 。 有 效 的 命令 是 SELECT 、 INSERT. UPDATE. DELETE , NOTIFY 语句 
L=. 


在 _condition_ 和 _command_ 里 ， 特殊 的 表 名 字 NEW 和 OLD 可 以 用 于 指向 被 引用 表 里 的 数 
值 。 NEW 在 ON INSERT 和 oN UPDATE 规则 里 可 以 指向 被 插入 或 更 新 的 新 行 。 oLD 
在 ON UPDATE 和 on DELETE 规则 里 可 以 指向 现存 的 被 更 新 或 删除 的 行 。 


WN e e l 
vt FS 
为 了 在 表 上 定义 或 修改 规则 ， 你 必须 是 该 表 的 拥有 者 。 


在 视图 上 用 于 INSERT, UPDATE, DELETE 的 规则 中 可 以 添加 RETURNING 子 句 基于 视图 的 字 
段 返回 。 如 果 规 则 被 INSERT RETURNING 、 UPDATE RETURNING 、 DELETE RETURNING 命令 触发 ， 

这 些 子 句 将 用 来 计算 输出 结果 。 如 果 规 则 被 不 带 RETURNING 的 命令 触发 ， 那 么 规则 

的 RETURNING 子 句 将 被 忽略 。 目前 信人 允许 无 条 件 的 instead 规则 包含 RETURNING 子 句 ， mE 
在 同一 个 事件 内 的 所 有 规则 中 最 多 只 能 有 一 个 RETURNING 子 句 。 这 样 就 确保 只 有 一 

个 RETURNING 子 句 可 以 用 于 计算 结果 。 如 果 在 任何 有 效 规则 中 都 不 存在 RETURNING 子 句 ， 该 
视图 上 的 RETURNING 查询 将 被 拒绝 。 


有 一 件 很 重要 的 事情 是 要 避免 循环 规则 。 比 如 ， 尽 管 下 面 两 条 规则 定义 都 是 PostgreSQL 可 以 
接受 的 ， 但 其 中 一 条 的 sELEcT 命令 会 导致 PostgreSQL 报告 一 条 错误 信息 ， 因 为 该 查询 循环 
了 太 多 次 : 
CREATE RULE "_RETURN" AS 
ON SELECT TO t1 
DO INSTEAD 
SELECT * FROM t2; 
CREATE RULE "_RETURN" AS 
ON SELECT TO t2 
DO INSTEAD 
SELECT * FROM t1; 


SELECT * FROM t1; 


目前 ， 如 果 一 个 规则 包含 一 个 NoTIFY 命令 ， 那 么 该 NOTIFY 命令 将 被 无 条 件 执行 ， 也 就 是 
说 ， 即使 规则 不 施加 到 任何 行 上 面 ， 该 NoTIFY 也 会 被 执行 。 比如 ， 在 


CREATE RULE notify_me AS ON UPDATE TO mytable DO ALSO NOTIFY mytable; 


UPDATE mytable SET name = 'foo' WHERE id = 42; 


里 ， 一 个 NoTIFY 事件 将 在 uppate 的 时 候 发 出 ， 不 管 是 否 有 满足 id = 42 条 件 的 行 。 这 是 一 
个 实现 的 限制 ， 将 来 的 版 本 应 该 修补 这 个 毛病 。 


兼容 性 


CREATE RULE 是 PostgreSQL 语言 的 扩展 ， 整 个 规则 重 写 系 统 都 是 如 此 。 


义 见 


ALTER RULE, DROP RULE 


CREATE SCHEMA 


Name 


CREATE SCHEMA -- 定义 一 个 新 模式 


Synopsis 





CREATE SCHEMA _schema_name_ [ AUTHORIZATION _user_name_ ] [ _schema_element_[... ] ] 
CREATE SCHEMA AUTHORIZATION _user_name_ [ _schema_element_[... ] ] 

CREATE SCHEMA IF NOT EXISTS _schema_name_ [ AUTHORIZATION _user_name_ ] 

CREATE SCHEMA IF NOT EXISTS AUTHORIZATION _user_name_ 





摘 述 

CREATE SCHEMA 在 当前 数据 库 里 输入 一 个 新 模式 。 该 模式 名 将 在 当前 数据 库 里 现存 的 所 有 模 
式 名 中 唯一 。 

模式 实际 上 是 一 个 名 字 空 间 : 它 包 含 命名 对 象 ( 表 、 数 据 类 型 、 画 数 、 操 作 符 ) 这 些 名 字 可 以 
和 其 它 模式 里 存在 的 其 它 对 象 重 名 。 命 名 对 象 要 么 是 通过 用 模式 名 作为 前 级 "修饰 "进行 访 

问 ， 要 么 是 通过 设置 一 个 搜索 路 径 包 含 所 需要 的 模式 。 一 条 带 着 无 修饰 对 象 名 的 CREATE OD 
都 是 在 当前 模式 中 创建 创建 对 象 的 (在 搜索 路 径 最 前 面 的 模式 ; 可 以 用 current_schema WACK 
判断 )。 


另外 ， CREATE SCHEMA 可 以 包括 在 新 模式 中 创建 对 象 的 子 命令 。 这 些 子 命令 和 那些 在 创建 完 
模式 后 发 出 的 命令 没有 任何 区 别 ， 只 不 过 是 如 果 使 用 了 AUTHORIZATION 子 句 ， 那 么 所 有 创建 
的 对 象 都 将 被 该 用 户 拥有 。 


参数 


_schema_name_ 

要 创建 的 模式 名 字 。 如 果 省 略 ， 则 使 用 _user_name_ 作为 模式 名 。 这 个 名 字 不 能 以 pg_ F 
头 ， 因 为 这 样 的 名 字 保 留 给 系统 模式 使 用 。 

将 拥有 该 模式 的 用 户 的 角色 名 。 如 果 省 略 ， 缺 省 为 执行 该 命令 的 用 户 名 。 要 想 创 建 一 个 属于 
其 他 角色 的 模式 ， 你 必须 是 那个 角色 的 直接 或 非 直 接 成 员 ， 或 是 超级 用 户 。 


_schema_element_ 


一 个 SQL 语句 ， 定 义 一 个 要 在 模式 里 创建 的 对 象 。 目 前 ， 只 有 CREATE TABLE 、 
CREATE VIEW , CREATE INDEX 、 CREATE SEQUENCE 、 CREATE TRIGGER 和 GRANT 是 可 以 接受 的 


子 句 。 其 它 类 型 的 对 象 可 以 在 创建 完 模式 之 后 的 独立 命令 里 创建 。 


IF NOT EXISTS 


如 果 相 同名 字 的 模式 已 经 存在 ， 那 么 什么 也 不 要 做 〈 除 了 发 出 一 个 通知 ) 。 当 使 用 此 选项 
时 ， 不 能 包括 _schema_element_ 子 命令 。 

tr 

EA 

要 创建 模式 ， 调 用 该 命 售 的 用 户 必需 在 当前 数据 库 上 有 cea 权限 。 (当然 ， 超 级 用 户 可 以 
绕 开 这 个 检查 。) 

例子 

创建 一 个 模式 : 


CREATE SCHEMA myschema; 
ARP joe 创建 模式 ， 模 式 名 也 叫 joe 
CREATE SCHEMA AUTHORIZATION joe; 


创建 一 个 名 为 test 的 模式 ， 该 模式 被 用 户 joe 所 拥有 ， 除非 已 经 有 一 个 名 为 test 的 模式 。 
(这 和 与 joe 是 否 拥有 早已 存在 的 模式 无 关 。) 


CREATE SCHEMA IF NOT EXISTS test AUTHORIZATION joe; 


创建 一 个 模式 并 且 在 里 面 创建 一 个 表 : 


CREATE SCHEMA hollywood 
CREATE TABLE films (title text, release date, awards text[]) 
CREATE VIEW winners AS 
SELECT title, release FROM films WHERE awards IS NOT NULL; 


请 注意 上 面 独立 的 子 命 令 不 是 由 分 号 结尾 的 
下 面 的 命令 是 实现 同样 结果 的 等 效 语句 : 


CREATE SCHEMA hollywood; 
CREATE TABLE hollywood.films (title text, release date, awards text[]); 
CREATE VIEW hollywood.winners AS 

SELECT title, release FROM hollywood.films WHERE awards IS NOT NULL; 


RANE 


SQL 标准 允许 在 CREATE SCHEMA 里 面 有 一 个 DEFAULT CHARACTER SET 子 句 以 及 比 目 前 
PostgreSQL 可 以 接受 的 更 多 的 子 命令 。 


SQL 标准 声明 在 create schema 里 的 子 命令 可 以 以 任意 顺序 出 现 。 目前 PostgreSQL 里 的 实现 
还 不 能 处 理 所 有 子 命 全 里 前 向 引用 的 情况 ; 有 时 候 可 能 需要 重 排 一 下 子 命令 的 顺序 以 避免 前 
向 引用 。 


在 SQL 标准 里 ， 模 式 的 所 有 者 总 是 拥有 其 中 的 所 有 对 象 。 PostgreSQL 人 允许 模式 包含 非 模 式 
所 有 者 拥有 的 对 象 。 只 有 在 模式 所 有 者 将 自己 模式 的 cREATE 权限 给 了 其 他 人 ， 或 者 超级 用 
户 选择 在 该 模式 中 创建 对 象 时 ， 才 可 能 出 现 。 


IF NOT EXISTS 选项 是 一 个 PostgreSQL 扩 展 。 


义 见 


ALTER SCHEMA, DROP SCHEMA 


CREATE SEQUENCE 


Name 


CREATE SEQUENCE -- 定义 一 个 新 序列 发 生 器 


Synopsis 


CREATE [ TEMPORARY | TEMP ] SEQUENCE name [ INCREMENT [ BY ] _increment_ ] 
[ MINVALUE _minvalue_ | NO MINVALUE ] [ MAXVALUE _maxvalue_ | NO MAXVALUE ] 
[ START [ WITH ] _start_ ] [ CACHE _cache_ ] [ [ NO ] CYCLE ] 
[ OWNED BY { _table_name_._column_name_ | NONE } ] 





CREATE SEQUENCE 将 向 当前 数据 库 里 增加 一 个 新 的 序列 号 生成 器 。 包括 创建 和 初始 化 一 个 新 的 
名 为 _nane_” 的 单行 表 。 生 成 器 将 被 使 用 此 命令 的 用 户 所 有 。 


如 果 给 出 了 一 个 模式 名 ， 那 么 该 序列 就 在 给 定 的 模式 中 创建 的 。 否则 它 会 在 当前 模式 中 创 
建 。 临 时 序列 存在 于 一 个 特殊 的 模式 中 ， 因此 创建 临时 序列 的 时 候 不 能 给 出 模式 名 。 序 列 名 
必需 和 同一 模式 中 的 其 它 序 列 、 表 、 索 引 、 视 图 或 外 表 的 名 字 不 同 。 


在 创建 序列 后 ， 你 可 以 使 用 nextval 、 currval 和 setval 本 数 操作 序列 。 这 些 函 数 
在 Section 9.16 中 有 详细 文档 。 


尽管 你 不 能 直接 更 新 一 个 序列 ， 但 你 可 以 使 用 : 


SELECT * FROM _name_; 


检查 一 个 序列 的 参数 和 当前 状态 。 特 别 是 序列 的 last_value 字段 显示 了 任意 会 话 最 后 分 配 的 
数值 。 (当然 ， 如 果 其 它 会 话 正 积极 地 使 用 nextval ， 这 些 值 在 被 打印 出 来 的 时 候 可 能 就 已 
经 过 时 了 。) 


参数 


TEMPORARY 或 TEMP 


如 果 声 明了 这 个 修饰 词 ， 那 么 该 序列 对 象 只 为 这 个 会 话 创 建 ， 并 且 在 会 话 结束 的 时 候 自 动 删 
除 。 在 临时 序列 存在 的 时 候 ， 除非 用 模式 修饰 的 名 字 引 用 ， 否 则 同名 永久 序列 是 不 可 见 的 (在 
同一 会 话 里 )。 


将 要 创建 的 序列 名 (可 以 用 模式 修饰 ) 


_increment_ 


可 选 子 句 INCREMENT BY _increment_ 指定 序列 的 步 长 。 一 个 正 数 将 生成 一 个 递增 的 序列 ， g 
个 负数 将 生成 一 个 递减 的 序列 。 人 缺 省 值 是 1. 

_minvalue_`` NO MINVALUE 

可 选 的 子 句 MINVALUE ”_minvalue。 指定 序列 的 最 小 值 。 如 果 没 有 声明 这 个 子 句 或 者 声明 


了 NO MINVALUE ， 那么 递增 序列 的 缺 省 为 1 ， 递 减 序列 的 缺 省 为 -2<sup 
class="calibre28">63</sup>-1. 


_maxvalue_ NO MAXVALUE 


可 选 的 子 句 MAXVALUE _maxvalue_ 指定 序列 的 最 大 值 。 如 果 没 有 声明 这 个 子 句 或 者 声明 
了 No MAXVALUE ， 那么 递增 序列 的 缺 省 为 2<sup class="calibre28">63</sup>-1， 递 减 序列 的 
缺 省 为 -1 o 


_start_ 


可 选 的 子 句 START WITH _start。 REFINER. RAM FBS 
A _minvalue_, 对 于 递减 序列 为 _maxvalue o 


_cache_ 


可 选 的 子 句 cache cache. 为 快速 访问 而 在 内 存 里 预先 存储 多 少 个 序列 号 。 最 小 值 (也 是 缺 
省 值 ) 是 1 ， 表示 一 次 只 能 生成 一 个 值 ， 也 就 是 说 没有 缓存 。 


CYCLE NO CYCLE 


CYCLE 选项 可 用 于 使 序列 到 达 _maxvalue_ 或 _minvalue 时 可 循环 并 继续 下 去 。 也 就 是 如 果 
达到 极限 ， 生成 的 下 一 个 数据 将 分 别 是 _minvalue_ 或 _maxvalue_ o 


如 果 声 明了 no cyce ， 那 么 在 序列 达到 其 最 大 值 之 后 任何 对 nextval 的 调用 都 将 返回 一 个 错 
误 。 如 果 既 没有 声明 cycle 也 没有 声明 No cycle, 那么 No cycle 是 缺 省 。 


OWNED BY table_name_ . _column_name OWNED BY NONE 





OWNED BY 选项 将 序列 关联 到 一 个 特定 的 表 字 段 上 。 这 样 ， 在 删除 那个 字段 或 其 所 在 表 的 时 候 
将 自动 删除 绑 定 的 序列 。 指定 的 表 和 序列 必须 被 同一 个 用 户 所 拥有 ， 并 且 在 在 同一 个 模式 
中 。 默认 的 owen BY NONE 表示 不 存在 这 样 的 关联 。 


sl = 
7 A 
使 用 prop sequence 删除 一 个 序列 。 


序列 是 基于 bigint 运算 的 ， 因此 其 范围 不 和 6 超过 八字 节 的 整数 范围 
(-9223372036854775808 到 9223372036854775807)。 在 一 些 古老 的 平台 上 可 能 没有 对 八 
字 节 整数 的 编译 器 支持 ， 这 种 情况 下 序列 使 用 普通 的 integer 运算 范围 (-2147483648 到 
+2147483647)。 


如 果 cache 大 于 一 ， 并 且 这 个 序列 对 象 将 被 用 于 多 会 话 并 发 的 场合 ， 那 么 可 能 会 有 不 可 预 
料 的 结果 发 生 。 每 个 会 话 在 每 次 访问 序列 对 象 的 过 程 中 都 将 分 配 并 缓存 随后 的 序列 值 ， 并 且 
相应 增加 序列 对 象 的 last_value 。 这 样 ， 同一 个 事务 中 的 随后 的 _cache_-1 次 nextval 将 只 
是 返回 预先 分 配 的 数值 ， 而 不 是 使 用 序列 对 象 。 因此 ， 任 何在 会 话 中 分 配 了 却 没 有 使 用 的 数 
字 都 将 在 会 话 结束 时 去 失 ， 从 而 导致 序列 里 面 出 现 "空洞 "。 


另外 ， 尽 管 系统 保证 为 多 个 会 话 分 配 独立 的 序列 值 ， 但 是 如 果 考 虑 所 有 会 话 ， 那么 这 个 数值 
可 能 会 丢失 顺序 。 上 比如 ， 如 果 cache 为 10 ， 那 么 会 话 人 保留 了 1.10 并 且 返 

回 nextval =1， 然后 会 话 B 可 能 会 保留 11..20 然后 在 会 话 A 生成 nextval =2 之 前 返 

E] nextval =11。 因 此 ， 对 于 cache 等 于 一 的 情况 ， 可 以 安全 地 假设 nextval 值 是 顺序 生 

成 的 ; 而 如 果 把 cache 设置 为 大 于 一 ， 那么 你 只 能 假设 nextval 值 总 是 不 同 的 ， 却 不 按 顺 

序 生成 。 同样 ， last_value 将 反映 任何 会 话 保 留 的 最 后 数值 ， 不 管 它 是 否 便 被 nextval 返 

回 。 


另外 一 个 考虑 是 在 这 样 的 序列 上 执行 的 setval 将 不 会 被 其 它 会 话 注 意 到 ， 直 到 它们 用 光 他 们 
自己 缓存 的 数值 。 


例子 
创建 一 个 叫 serial 的 递增 序列 ， 从 101 开始 : 


CREATE SEQUENCE serial START 101; 


从 此 序列 中 选 出 下 一 个 数字 : 


SELECT nextval('serial'); 


nextval 


从 此 序列 中 选 出 下 一 个 数字 : 


SELECT nextval('serial'); 


nextval 


在 一 个 insert 中 使 用 此 序列 : 


INSERT INTO distributors VALUES (nextval('serial'), 'nothing'); 


在 一 个 copy FRoM 后 更 新 序列 : 


BEGIN; 
COPY distributors FROM 'input_file'; 
SELECT setval('serial', max(id)) FROM distributors; 


END; 


RANE 


CREATE SEQUENCE 遵循 SQL 标准 ， 只 有 下 面 的 例外 : 
e 还 不 支持 标准 的 As &1t; 数 据 类 型 &gt; 表达 式 。 
o 使 用 nextval() 画 数 而 不 是 标准 的 NEXT VALUE FoR 表达 式 获取 下 一 个 数值 。 


e owNED BY 子 句 是 PostgreSQL 的 扩展 。 


义 见 


ALTER SEQUENCE, DROP SEQUENCE 


CREATE SERVER 


Name 


CREATE SERVER -- 定义 一 个 新 的 外 服务 器 


Synopsis 


CREATE SERVER _server_name_ [ TYPE '_server_type_' ] [ VERSION '_server_version_' ] 
FOREIGN DATA WRAPPER _fdw_name_ 
[ OPTIONS ( _option_ '_value_' [, ... ] ) ] 





摘 述 
CREATE SERVER 定义 一 个 新 的 外 部 服务 器 。 定 义 该 服务 器 的 用 户 将 成 为 其 所 有 者 。 


一 个 外 部 服务 器 通常 将 关于 访问 外 部 数据 源 的 连接 信息 的 外 部 数据 容器 封装 起 来 。 用 户 特定 
的 额外 信息 可 以 由 用 户 映射 的 方式 来 指定 。 额外 的 用 户 特定 的 连接 信息 可 以 由 用 户 映射 的 方 
式 来 指定 。 


服务 器 名 称 必须 是 数据 库 内 唯一 的 。 
创建 服务 器 需要 外 部 数据 容器 上 有 usa 权限 。 


参数 


_server_name_ 


创建 外 部 服务 器 的 名 字 。 


_server_type_ 
可 选 的 服务 器 类 型 ， 对 外 部 数据 容器 可 能 有 用 。 


_server_version_ 


可 选 的 服务 器 版 本 ， 对 外 部 数据 容器 可 能 有 用 。 


_fdw_name_ 
管理 服务 器 的 外 部 数据 容器 的 名 字 。 


OPTIONS ( _option_ ' value_'[,...]) 





该 子 句 指定 了 服务 器 的 选项 。 该 选项 通常 定义 了 连接 的 详细 信息 ， 但 实际 上 名 称 和 值 是 依赖 
服务 器 的 外 部 数据 容器 。 
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当 使 用 dblink 模块 的 时 候 , 一 个 外 部 服务 器 的 名 字 可 以 使 用 如 dblink_connect 函 数 ， 用 于 表示 
连接 参数 。 这 样 需要 在 外 部 服务 器 上 有 usace 的 权限 ， 才 能 够 这 样 使 用 。 


示例 
通过 使 用 外 部 数据 容器 postgres_fdw 创建 外 部 服务 器 myserver : 


CREATE SERVER myserver FOREIGN DATA WRAPPER postgres_fdw OPTIONS (host 'foo', dbname 'foo 
到 |: 


参见 postgres_fdw 了 解 更 多 详情 。 


兼容 性 


CREATE SERVER ft ISO/IEC 9075-9 (SQL/MED) 标 准 。 





另 请 参见 


ALTER SERVER, DROP SERVER, CREATE FOREIGN DATA WRAPPER, CREATE 
FOREIGN TABLE, CREATE USER MAPPING 


CREATE TABLE 


Name 


CREATE TABLE -- 定义 一 个 新 表 


Synopsis 


CREATE [ [ GLOBAL | LOCAL ] { TEMPORARY | TEMP } | UNLOGGED ] TABLE [ IF NOT EXISTS ] _ta 














{ _column_name data_type_ [ COLLATE _collation_ ] [ _column_constraint_[... ] ] 
| _table_constraint_ 
| LIKE _source_table_ [ _like_option_... ] } 
L «++ ] 
[ INHERITS ( _parent_table_[, ... ] 
[ WITH ( _storage_parameter_ [= _value_] [, ... ] ) | WITH OIDS | WITHOUT OIDS ] 


[ ON COMMIT { PRESERVE ROWS | DELETE ROWS | DROP } ] 
[ TABLESPACE _tablespace_name_ | 


CREATE [ [ GLOBAL | LOCAL ] { TEMPORARY | TEMP } | UNLOGGED ] TABLE [ IF NOT EXISTS ] _ta 

OF _type_name_ [ ( 
{ _column_name_ WITH OPTIONS [ _column_constraint_[... ] ] 

| _table_constraint_ } 
Lod 

) ] 

[ WITH ( _storage_parameter_ [= _value_] [, ... ] ) | WITH OIDS | WITHOUT OIDS ] 

[ ON COMMIT { PRESERVE ROWS | DELETE ROWS | DROP } ] 

[ TABLESPACE _tablespace_name_ | 


这 里 的 ”_ column_constraint “是 : 


CONSTRAINT _constraint_name_ ] 

NOT NULL | 

NULL | 

CHECK ( _expression_ ) [ NO INHERIT ] | 

DEFAULT _default_expr_ | 

UNIQUE _index_parameters_ | 

PRIMARY KEY _index_parameters_ | 

REFERENCES _reftable_ [ ( _refcolumn_ ) ] [ MATCH FULL | MATCH PARTIAL | MATCH SIMPLE ] 
[ ON DELETE _action_ ] [ ON UPDATE _action_ ] } 

[ DEFERRABLE | NOT DEFERRABLE ] [ INITIALLY DEFERRED | INITIALLY IMMEDIATE ] 


an 


而 `_table_constraint “是 : 





[ CONSTRAINT _constraint_name_ ] 
{ CHECK ( _expression_ ) [ NO INHERIT ] | 
UNIQUE ( _column_name_ [, ... ] ) _index_parameters_ | 
PRIMARY KEY ( _column_name_ [, ... ] ) _index_parameters_ | 
EXCLUDE [ USING _index_method_ ] ( _exclude_element_ WITH _operator_ [, ... ] ) _index_ 
FOREIGN KEY ( _column_name_ [, ... ] ) REFERENCES _reftable_ [ ( _refcolumn_ [, ... ] ) 


[ MATCH FULL | MATCH PARTIAL | MATCH SIMPLE ] [ ON DELETE _action_ ] [ ON UPDATE _act 
[ DEFERRABLE | NOT DEFERRABLE ] [ INITIALLY DEFERRED | INITIALLY IMMEDIATE ] 


~_like_option_“#: 
{ INCLUDING | EXCLUDING } { DEFAULTS | CONSTRAINTS | INDEXES | STORAGE | COMMENTS | ALL } 


TE `UNIQUE`, “PRIMARY KEY` 和 
~EXCLUDE ` 约束 中 的 `_index_parameters_` 是 : 


[ WITH ( _storage_parameter_ [= _value_] [, ... ] ) ] 
[ USING INDEX TABLESPACE _tablespace_name_ ] 


~_exclude_element_~ in an ~EXCLUDE~ constraint is: 





{ _column_name_ | ( _expression_ ) } [ _opclass_ ] [ ASC | DESC ] [ NULLS { FIRST | LAST 





CREATE TABLE 在 当前 数据 库 创 建 一 个 新 的 空白 表 。 该 表 将 由 发 出 此 命令 的 用 户 所 拥有 。 


如 果 给 出 了 模式 名 (比如 CREATE TABLE myschema.mytable ... ), 那么 在 指定 的 模式 中 创建 表 ， 
否则 在 当前 模式 中 创建 。 临 时 表 存 在 于 一 个 特殊 的 模式 里 ， 因此 创建 临时 表 的 时 候 不 能 指定 
模式 名 。 表 名 字 必 需 在 同一 模式 中 的 其 它 表 、 序列、 索引、 视图 或 外 部 表 名 字 中 唯一 。 
CREATE TABLE 还 自动 创建 一 个 与 该 表 的 行 对 应 的 复合 数据 类 型 。 因此 ， 表 不 能 和 同 模式 中 的 
现 有 数据 类 型 同名 。 

可 选 的 约束 子 句 声明 约束 ， 新 行 或 者 更 新 的 行 必须 满足 这 些 约束 才能 成 功 插入 或 更 新 。 约束 
是 一 个 SQL 对 象 ， 它 以 多 种 方式 协助 在 表 上 定义 有 效 数 值 的 集合 。 

定义 约束 有 两 种 方法 : 表 约 束 和 列 约束 。 列 约束 是 作为 一 个 列 定义 的 一 部 分 定义 的 。 而 表 约 
束 并 不 和 某 个 列 绑 在 一 起 ， 它 可 以 作用 于 多 个 列 上 。 每 个 列 约束 也 可 以 写成 表 约 束 ; URE 
个 约束 只 影响 一 个 列 ， 那 么 列 约束 只 是 符号 上 的 简洁 方式 而 已 。 


要 能 创建 一 个 表 ， 你 必须 分 别 在 所 有 列 类 型 或 oF 子 句 的 类 型 上 有 usace 权限 。 


参数 


TEMPORARY 或 TEMP 


如 果 声 明了 ， 则 创建 为 临时 表 。 临时 表 在 会 话 结束 或 (可 选 ) 当 前 事务 的 结尾 (参阅 下 面 

的 on commit ) 自 动 删 除 。 除 非 用 模式 修饰 的 名 字 引 用 ， 否则 现 有 的 同名 永久 表 在 临时 表 存 在 
期 间 ， 在 本 会 话 过 程 中 是 不 可 见 的 。 任何 在 临时 表 上 创建 的 索引 也 都 会 被 自动 删除 。 

自动 清理 进程 不 能 访问 ， 因 此 不 能 清理 或 分 析 临 时 表 。 由 于 这 个 原因 ， 适 当 的 清理 和 分 析 操 
作 应 该 通过 会 话 SQL 命 令 来 执行 。 例 如 ， 如 果 一 个 临时 表 用 于 复杂 查询 中 ， 那 么 在 填充 临时 
表 之 后 在 临时 表 上 运行 ANALYZE 是 明智 的 。 

可 以 选择 在 TEMPORARY 或 TEMP 前 面 放 上 6LoBAL 或 Local 。 不 过 这 目前 对 PostgreSQL 来 说 
没有 任何 区 别 ， 并 且 已 经 废弃 了 ; 可 以 参阅 兼容 性 。 

UNLOGGED 

如 果 指 定 了 ， 则 表 作 为 非 日 志 表 来 创建 。 写 入 到 非 日 志 表 中 的 数据 并 不 写 入 预 写 式 日 志 (2 
阅 Chapter 29) ， 这 使 得 他 们 上 比 普 通 表 快 的 多 。 不 过 ， 他 们 不 是 崩溃 安全 的 : 一 个 非 日 志 
在 崩溃 或 不 清理 关机 之 后 被 自动 截断 。 非 日 志 表 的 内 容 也 不 复制 到 各 用 服务 器 。 任 何在 非 日 
志 表 上 创建 的 索引 也 自动 是 非 日 志 的 。 


IF NOT EXISTS 


如 果 同 名 的 关系 已 经 存在 ， 那 么 不 要 抛 出 一 个 错误 。 在 这 种 情况 下 发 出 一 个 通知 。 请 注意 ， 
不 保证 已 经 存在 的 关系 和 要 创建 的 关系 相像 。 


_table_name_ 


要 创建 的 表 的 名 字 ( 可 以 用 模式 修饰 ) 


OF _type_name_ 


创建 一 个 类 型 化 的 表 ， 它 的 结构 来 自 指定 的 复合 类 型 (名 字 可 以 有 模式 修饰 ) 。 一 个 类 型 化 
的 表 绑 定 到 它 的 类 型 ; 例如 ， 如 果 类 型 被 删除 (使 用 prop type ... cascade ) ， 则 该 表 也 将 
被 删除 。 


当 类 型 化 的 表 被 创建 时 ， 字 段 的 数据 类 型 取决 于 底层 复合 类 型 ， 而 不 是 通过 CREATE TABLE 命 
兮 指定 。 但 是 CREATE TABLE 命令 可 以 给 表 添 加 缺 省 和 约束 ， 并 且 可 以 指定 存储 参数 。 
_column_name_ 

在 新 表 中 要 创建 的 字段 名 字 。 


_data_type_ 


该 字段 的 数据 类 型 。 它 可 以 包括 数组 说 明 符 。 有 关 PostgreSQL 支持 的 数据 类 型 的 更 多 信息 ， 
请 参考 Chapter 8。 


COLLATE _collation_ 


COLLATE 给 字段 (必须 是 可 排序 的 数据 类 型 ) 分 配 一 个 排序 规则 。 如 果 没 有 指定 ， 则 使 用 字 
段 数据 类 型 的 缺 省 排序 。 


INHERITS ( _parent_table_ |[,...]) 





可 选 的 INHERITS 子 句 声明 一 系列 的 表 ， 新 表 自动 从 这 一 系列 表 中 继承 所 有 字段 。 


使 用 INHERITS 将 在 新 的 子 表 和 其 父 表 之 间 创 建 一 个 永久 的 关系 。 对 父 表 结构 的 修改 通常 也 会 
传播 到 子 表 。 缺 省 时 ， 扫 描 父 表 的 时 候 也 会 扫描 子 表 。 


如 果 在 多 个 父 表 中 存在 同名 字段 ， 那 么 就 会 报告 一 个 错误 ， 除非 这 些 字段 的 数据 类 型 在 每 个 
父 表 里 都 是 匹配 的 。 如 果 没 有 冲突 ， 那么 重复 的 字段 在 新 表 中 融合 成 一 个 字段 。 如 果 列 出 的 
新 表 字 段 名 和 继承 字段 同名 ， 那么 它 的 数据 类 型 也 必须 和 继承 字段 匹配 ， 并 且 这 些 字段 定义 
会 融合 成 一 个 。 如 果 新 表 为 该 字段 明确 声明 了 缺 省 值 ， 那 么 此 缺 省 值 将 覆盖 任何 继承 字段 的 
缺 省 值 。 否则 ， 该 字段 的 所 有 父 字段 缺 省 值 都 必须 相同 ， 否 则 就 会 报错 。 


cHECK 约束 本 质 上 以 和 字段 一 样 的 方式 合并 : 如 果 多 个 父 表 和 /或 新 表 的 定义 包含 相同 名 字 的 
CHECK 约束 ， 那 么 这 些 约 束 必须 都 有 相同 的 检查 表达 式 ， 否 则 会 报告 一 个 错误 。 有 相同 名 字 
和 表达 式 的 约束 将 合并 到 一 个 。 在 父 表 中 标记 为 NO INHERIT 的 约束 将 不 被 考虑 。 请 注意 ， 新 
表 中 未 命名 的 cHEck 约束 将 永远 不 被 合并 ， 因为 它 将 永远 都 有 一 个 唯一 的 名 字 。 


字段 STORAGE 设置 也 从 父 表 中 拷贝。 


LIKE _source_table_ [ _like_option_ ... ] 





LIK 子 句 声明 一 个 表 ， 新 表 自 动 从 这 个 表 里 面 继承 所 有 字段 名 及 其 数据 类 型 和 非 空 约束 。 


和 INHERITS 不 同 ， 新 表 与 原来 的 表 之 间 在 创建 动作 完毕 之 后 是 完全 无 关 的 。 在 源 表 做 的 任何 
修改 都 不 会 传播 到 新 表 中 ， 并 且 也 不 可 能 在 扫描 源 表 的 时 候 包 含 新 表 的 数据 。 


字段 缺 省 表达 式 只 有 在 声明 了 INCLUDING DEFAULTS 之 后 才 会 包含 进来 。 缺 省 是 不 包含 缺 省 表 
达 式 的 ， 结 果 是 新 表 中 所 有 字段 的 缺 省 值 都 是 NULL 。 


非 空 约束 将 总 是 复制 到 新 表 中 ， check 约束 则 仅 在 指定 了 INCLUDING CONSTRAINTS 的 时 候 才 复 
制 。 源 表 上 的 索引 、 PRIMARY KEY 和 UNIQUE 约束 仅 在 指定 了 INCLUDING INDEXES 子 句 的 时 候 
才 在 新 表 上 创建 。 此 规则 同时 适用 于 表 约 束 和 列 约束 。 


拷贝 字段 定义 的 sToRAGE 设置 只 在 声明 了 INcLupIN6 STORAGE 的 时 候 才 拷贝 。 缺 省 是 不 包 
括 storace 设置 的 ， 结果 是 新 表 中 的 拷贝 字段 有 特定 类 型 的 缺 省 设置 。 关 于 storace 设置 的 
更 多 信息 ， 请 参阅 Section 58.2, 


拷贝 字段 、 约 束 和 索引 的 注释 只 在 声明 了 INCLUDING comments 的 时 候 拷 贝 。 缺 省 是 不 包含 注 
释 的 ， 结 果 是 新 表 中 拷贝 的 字段 和 约束 没有 注释 。 


INCLUDING ALL 是 INCLUDING DEFAULTS INCLUDING CONSTRAINTS INCLUDING INDEXES INCLUDING STOR 
的 一 个 简写 形式 。 


请 注意 ， 和 INHERITS 不 同 ， 通 过 LIKE 拷贝 的 列 和 约束 并 不 使 用 相同 的 名 字 进 行 融合 。 如 果 
明确 的 指定 了 相同 的 名 字 或 者 在 另外 一 个 LIKE 子 句 中 ， 那 么 将 会 报错 。 


LIK 子 句 也 可 以 用 来 从 视图 、 外 表 或 复合 类 型 中 拷贝 字段 。 不 适用 的 选项 (如 ， 从 一 个 视 
图 中 INCLUDING INDEXES ) 都 被 忽略 。 


CONSTRAINT _constraint_name_ 


可 选 的 列 约束 或 表 约 束 的 名 字 。 如 果 约 束 本 身 是 非法 的 ， 那 么 其 名 字 将 会 出 现在 错误 信息 
h, 因此 像 col must be positive 这 样 的 名 字 可 以 表达 有 用 的 约束 信息 。 如 果 约 束 名 中 含有 
空格 则 必须 用 双 引 号 界定 。 如 果 没 有 指定 约束 名 ， 那 么 系统 将 会 自动 生成 一 个 名 字 。 


NOT NULL 

字段 不 允许 包含 NULL 值 

NULL 

字段 允许 包含 NULL 值 ， 这 是 缺 省 。 

这 个 子 句 的 存在 只 是 为 和 那些 非 标准 SQL 数据 库 兼 容 。 不 建议 在 新 应 用 中 使 用 它 。 
CHECK ( _expression_ )[NO INHERIT] 


cHEck 约束 声明 一 个 生成 布尔 结果 的 表达 式 ， 每 次 将 要 插入 的 新 行 或 者 将 要 被 更 新 的 行 必须 
使 表达 式 结果 为 真 或 未 知 才能 成 功 ， 否则 会 抛 出 一 个 异常 并 且 不 会 修改 数据 库 。 声明 为 字段 
约束 的 检查 约束 应 该 只 引用 该 字段 的 数值 ， 而 在 表 约 束 里 出 现 的 表达 式 可 以 引用 多 个 字段 。 


目前 ， chHEcK 表达 式 不 能 包含 子 查询 也 不 能 引用 除 当 前 行 字 段 之 外 的 变量 。 
用 No INHERIT 标记 的 约束 将 不 会 传递 到 子 表 中 去 。 


DEFAULT _default_expr_ 


DEFAULT 子 句 给 字段 指定 缺 省 值 。 该 数值 可 以 是 任何 不 含 变量 的 表达 式 (不 允许 使 用 子 查询 和 
对 本 表 中 的 其 它 字 段 的 交叉 引用 )。 缺 省 表达 式 的 数据 类 型 必须 和 字段 类 型 匹配 。 


缺 省 表达 式 将 被 用 于 任何 未 声明 该 字段 数值 的 插入 操作 。 如 果 没 有 指定 缺 省 值 则 缺 省 值 为 
NULL 。 


UNIQUE (column constraint) UNIQUE ( _column_name_ |, ... ] ) (table constraint) 


UNIQUE 约束 表示 表 里 的 一 个 或 多 个 字段 的 组 合 必 须 在 全 表 范 围 内 唯一 。 唯一 约束 的 行为 和 列 
约束 一 样 ， 只 不 过 多 了 跨 多 行 的 能 力 。 


对 于 唯一 约束 而 言 ，NULL 被 认为 是 互 不 相等 的 。 


每 个 唯一 约束 都 必须 给 其 使 用 的 字段 集合 赋予 一 个 与 其 它 唯一 约束 都 不 同 的 名 字 ， 并 且 也 不 
能 和 主键 约束 的 名 字 相同 ， 否 则 就 被 认为 是 同样 的 约束 写 了 两 次 。 


PRIMARY KEY (column constraint) PRIMARY KEY ( _column_name_ |, ... ] ) (table constraint) 


主键 约束 表明 表 中 的 一 个 或 者 一 些 字段 只 能 包含 唯一 (不 重复 ) 的 非 NULL 值 。 从 技术 上 
YF, PRIMARY KEY 只 是 UNIQUE 和 not NULL 的 组 合 ， 不 过 把 一 套 字段 标识 为 主键 同时 也 体现 
了 模式 设计 的 元 数据 ， 因为 主键 意味 着 可 以 拿 这 套 字 段 用 做 行 的 唯一 标识 。 


一 个 表 只 能 声明 一 个 主键 ， 不 管 是 作为 字段 约束 还 是 表 约 束 。 


主键 约束 使 用 的 字段 集合 应 该 与 其 它 唯一 约束 都 不 同 。 





EXCLUDE [ USING _index method ]( _exclude_element_ WITH _operator [, ...] ) 
_index_parameters_ [WHERE ( _predicate_ ) ] 


EXCLUDE 子 句 定义 一 个 排除 约束 ， 保 证 了 两 个 行 在 指定 的 字段 或 使 用 指定 操作 符 的 表达 式 上 
比较 时 ， 并 不 都 返回 TRuE 。 如 果 所 有 指定 的 操作 符 测试 都 相等 ， 那么 就 等 同 于 untque 4 
束 ， 尽 管 一 个 普通 的 唯一 约束 会 更 快速 。 不 过 ， 排 除 约束 可 以 指定 比 简单 相等 更 普通 的 约 
束 。 例 如 ， 你 可 以 通过 使 用 &e 操作 符 指定 一 个 约束 ， 在 一 个 表 中 没有 两 个 行 包含 重 受 的 圆 
A(S ig Section 8.8)。 


排除 约束 是 使 用 索引 实现 的 ， 所 以 每 个 指定 的 操作 符 都 必须 和 索引 访问 方法 的 一 个 合适 的 操 
作 符 类 (参阅 Section 11.9) 相关 。 要 求 操 作 符 是 可 交换 的 。 每 个 _exclude_element_ 可 以 指 
定 一 个 操作 符 类 和 /或 排序 选项 ; 这 些 在 CREATE INDEX 中 有 充分 的 描述 。 


访问 方法 必须 支持 amgettuple (参阅 Chapter 54); 目前 ， 这 意味 着 不 能 使 用 GIN。 尽 管 允 许 
使 用 ， 但 是 在 排除 约束 中 使 用 B-tree 或 哈 希 来 引 没什么 意义 ， 因为 一 个 普通 唯一 约束 做 的 更 
好 。 所 以 实际 中 ， 访 问 方法 总 是 GiST 或 SP-GiST。 


_predicate_ 允许 在 表 的 子 集 上 声明 一 个 排除 约束 ; FEA BB 3X AE TARRE 请 注 
意 ， 谓 语 需 要 有 括号 包围。 


REFERENCES _reftable_ [( _refcolumn_ )][ MATCH _matchtype_ ] [ON DELETE 
_action_ ] [ON UPDATE action ] (column constraint) FOREIGN KEY ( _column_name_ [, 
... |) REFERENCES _reftable_ [( _refcolumn_ [,...])][ MATCH _matchtype_ ][ ON 
DELETE action ] [ON UPDATE action ] (table constraint) 


这 些 子 句 声明 一 个 外 键 约束 ， 外 键 约束 要 求 新 表 中 一 列 或 多 列 组 成 的 组 应 该 只 包含 匹配 被 参 
考 的 表 中 对 应 字段 中 的 值 。 如 果 省 略 _refcolumn ， 则 使 用 _reftable 的 主键 。 被 参考 字段 
必须 是 被 参考 表 中 的 唯一 字段 或 者 主键 。 请 注意 ， 不 能 在 临时 表 和 永久 表 之 间 定 义 外 键 约 
束 。 

向 参考 字段 插入 的 数值 将 使 用 给 出 的 匹配 类 型 与 被 参考 表 中 被 参考 列 的 数值 进行 匹配 。 有 三 
种 匹配 类 型 : MATCH FULL , MATCH PARTIAL , MATCH SIMPLE ( 缺 省 )。 MATCH FULL 不 允许 一 个 多 
字段 外 键 的 字段 为 NULL ， 除 非 所 有 外 键 字段 都 为 NULL ; 如 果 都 是 NULL， 那 么 该 行 在 引用 
的 表 中 不 需要 有 匹配 。 MATcH SIMPLE 人 允许 任意 外 键 字段 为 NULL ; 如 果 都 是 NULL， 那 么 该 
行 在 引用 的 表 中 不 需要 有 匹配。 MATCH PARTIAL 目前 尚未 实现 。 (当然 ， NoT NULL 约束 可 以 
应 用 于 引用 字段 ， 以 阻止 这 些 情况 的 发 生 。) 

另外 ， 当 被 参考 字段 中 的 数据 改变 的 时 候 ， 那 么 将 对 本 表 的 字段 中 的 数据 执行 某 种 操作 。 

ON DELETE 子 名 声明 当 被 参考 表 中 的 被 参考 行 被 删除 的 时 候 要 执行 的 操作 。 类 似 

BY, ON UPDATE 子 句 声明 被 参考 表 中 被 参考 字段 更 新 为 新 值 的 时 候 要 执行 的 动作 。 如 果 该 行 
被 更 新 ， 但 被 参考 的 字段 实际 上 没有 变化 ， 那 么 就 不 会 有 任何 动作 。 除了 no action 检查 之 
外 的 其 他 参考 动作 都 不 能 推迟 ， 即使 该 约束 声明 为 可 推迟 也 是 如 此 。 下 面 是 每 个 子 句 的 可 能 
动作 : 

NO ACTION 

生成 一 个 错误 ， 表 明 删 除 或 更 新 将 产生 一 个 违反 外 键 约束 的 动作 。 如 果 该 约束 是 可 推迟 的 ， 
并 且 如 果 还 存在 任何 引用 行 ， 那 么 这 个 错误 将 在 检查 约束 的 时 候 生 成 。 这 是 缺 省 动作 。 
RESTRICT 

生成 一 个 表明 删除 或 更 新 将 导致 违反 外 键 约束 的 错误 。 和 no action 一 样 ， 只 是 动作 不 可 推 
Ro 

CASCADE 

删除 任何 引用 了 被 删除 行 的 行 ， 或 者 分 别 把 引用 行 的 字段 值 更 新 为 被 参考 字段 的 新 数值 。 


SET NULL 


把 引用 行 设置 为 NULL. 


SET DEFAULT 


把 引用 字段 设置 为 它们 的 缺 省 值 。〈 如 果 他 们 为 非 空 ， 那 么 被 引用 的 表 中 必须 有 一 行 匹 配 缺 
省 值 ， 否则 该 操作 将 会 失败 。) 


如 果 被 参考 字段 经 常 更 新 ， 那 么 给 引用 字段 增加 一 个 索引 可 能 是 合适 的 ， 这 样 与 外 键 约束 相 
关联 的 引用 动作 可 以 更 有 效 地 执行 。 


DEFERRABLE NOT DEFERRABLE 


这 两 个 关键 字 设 置 该 约束 是 否 可 推迟 。 一 个 不 可 推迟 的 约束 将 在 每 条 命令 之 后 马上 检查 。 可 
推迟 约束 可 以 推迟 到 事务 结尾 使 用 SET CONSTRAINTS 命 令 检 查 。 人 缺 省 是 NoT DEFERRABLE o 
目前 ， 只 有 UNIQUE 、 PRIMARY KEY 、 EXCLUDE 和 REFERENCES (外 键 ) 约束 接受 这 个 子 


句 。 NOT NULL 和 CHECK 约束 都 是 不 可 推迟 的 。 
INITIALLY IMMEDIATE INITIALLY DEFERRED 


如 果 约 束 是 可 推迟 的 ， 那 么 这 个 子 句 声明 检查 约束 的 缺 省 时 间 。 MRR 

是 INITIALLY IMMEDIATE ( 缺 省 )， 那么 每 条 语句 之 后 就 立即 检查 它 。 如 果 约 束 

是 INITIALLY DEFERRED, 那么 只 有 在 事务 结尾 才 检 查 它 。 约 束 检查 的 时 间 可 以 用 SET 
CONSTRAINTS 命 令 修 改 。 


WITH ( _storage_parameter_ [= _value_][,...]) 


这 个 子 句 为 表 或 索引 指定 一 个 可 选 的 存储 参数 ， 参 见 存储 参数 获取 更 多 信息 。 AFR 

的 with 子 句 还 可 以 包含 orps=TRUE 或 单独 的 orms 来 指定 给 新 表 中 的 每 一 行 都 分 配 一 个 
OID( 对 象 标识 符 )， 或 者 oIps=FALSE 表示 不 分 配 OID 。 如 果 没 有 指定 oms 默认 行为 取决 于 
default_with_oids 配 置 参 数 。 如 果 新 表 是 从 有 OID 的 表 继 承 而 来 ， 那 么 即使 明确 指 

定 oIDS=FALSE 也 将 强制 按照 oIDS=TRUE 执行 。 


如 果 明 确 或 隐 合 的 指定 了 oIDs=FALSE ， 新 表 将 不 会 存储 OID ， 也 不 会 为 插入 的 行 分 配 OID 

。 这 将 减 小 OID 的 开销 并 因此 延缓 了 32-bit OID 计数 器 的 循环 。 因 为 一 旦 计数 器 发 生 循环 之 
后 OID 将 不 能 被 视 为 唯一 ， 这 将 大 大 降低 OD 的 实用 性 。 另 外 ， 排除 了 OID 的 表 也 为 每 条 
记录 减 小 了 4 字 节 的 存储 空间 〈 在 大 多 数 机 器 上 ) ， 从 而 可 以 稍微 提升 一 些 性 能 。 


可 以 使 用 ALTER TABLE 从 已 有 的 表 中 删除 OID 列 。 
WITH OIDS WITHOUT OIDS 


这 些 是 被 废弃 的 、 分 别 等 价 于 with (ors) 和 with (0IDS=FALSE) 的 语法 。 如 果 想 同时 给 
出 oms 设置 和 存储 参数 ， 必 须 使 用 with... ) 语法 ; PEM, 


ON COMMIT 
可 以 使 用 on commit 控制 临时 表 在 事务 块 结尾 的 行为 。 这 三 个 选项 是 : 
PRESERVE ROWS 

在 事务 的 结尾 不 采取 任何 特别 的 动作 ， 这 是 缺 省 。 


DELETE ROWS 


在 每 个 事务 块 的 结尾 都 删除 临时 表 中 的 所 有 行 。 本 质 上 是 在 每 次 提交 事务 后 自动 执行 一 
个 TRUNCATE 命 倒 。 


DROP 
在 当前 事务 块 的 结尾 删除 临时 表 。 
TABLESPACE _tablespace_name_ 


指定 新 表 将 要 在 _tablespace_name ” 表 空 间 内 创建 。 如 果 没 有 声明 ， 将 使 
用 default_tablespace， 如 果 该 表 为 临时 表 ， 那 么 将 使 用 temp_tablespaces。 


USING INDEX TABLESPACE _tablespace_name_ 


这 个 子 句 允许 选择 与 一 个 UNIQUE, PRIMARY KEY 或 EXCLUDE 约束 相关 的 索引 创建 时 所 在 的 表 
空间 。 如 果 没 有 声明 ， 将 使 用 default tablespace, 如 果 该 表 为 临时 表 ， 那 么 特使 
用 temp _tablespaces。 


存储 参数 


WITH 子 句 可 以 为 表 指 定 存储 人 参数， 并 在 索引 上 创建 UNIQUE, PRIMARY KEY 或 EXCLUDE 的 
束 。 用 于 索引 的 存储 参数 在 CREATE INDEX 里 面 描述 。 目前 可 以 在 表 上 使 用 的 存储 参数 在 下 
面 列 出 。 对 于 每 个 参数 ， 除 非 指 明了 ， 有 一 个 额外 的 参数 是 相同 的 名 字 加 上 toast. 前 级， 

可 以 用 来 控制 表 的 次 要 TOAST 表 的 行为 ， 如 果 有 (参阅 Section 58.2 获 取 更 多 关于 TOAST 的 信 
息 )。 请 注意 ，TOAST 表 从 它 的 父 表 中 继承 autovacuum * 值 ， 如 果 没 有 设 


置 toast.autovacuum_* 设置 。 
fillfactor ( integer ) 


一 个 表 的 填充 因子 (fillfactor) 是 一 个 介 于 10 和 100 之 间 的 百分数 。 100( 完 全 填充 ) 是 默认 值 。 

如 果 指 定 了 较 小 的 填充 因子 ， INSERT 操作 仅 按 照 填充 因子 指定 的 百分率 填充 表 页 。 每 个 页 上 
的 剩余 空间 将 用 于 在 该 页 上 更 新 行 ， 这 就 使 得 or 有 机 会 在 同一 页 上 放置 同一 条 记录 的 新 
版 本 ， 这 上 比 把 新 版 本 放置 在 其 它 页 上 更 有 效 。 对 于 一 个 从 不 更 新 的 表 将 填充 因子 设 为 100 是 
最 佳 选择 ， 但 是 对 于 频繁 更 新 的 表 ， 较 小 的 填充 因子 则 更 加 有 效 。 这 个 参数 不 能 为 TOAST 表 
设置 。 


autovacuum_enabled , toast.autovacuum_enabled ( boolean ) 


在 一 个 特别 的 表 上 启用 或 茶 用 自动 清理 守护 进程 。 如 果 为 真 ， 当 更 新 或 删除 的 元 组 的 数量 超 
过 autovacuum_vacuum_threshold 加 上 autovacuum_vacuum_scale_factor 倍 的 当前 关系 中 评估 的 
活动 的 元 组 时 ， 自动 清理 守护 进程 将 在 一 个 特定 的 表 上 发 起 一 个 vacuum 操作 。 相似 的 ， 当 
插入 、 更 新 或 删除 的 元 组 的 数量 超过 autovacuum_analyze_threshold 加 

上 autovacuum_analyze_scale_factor 倍 的 当前 关系 中 评估 的 活动 的 元 组 时 ， 自动 清理 守护 进 
程 将 发 起 一 个 ayze 操作 。 如 果 为 假 ， 这 个 表 将 不 被 自动 清理 ， 除 了 防止 事务 Id 循环 。 参 
阅 Section 23.1.5 获取 更 多 关于 预防 循环 的 信息 。 注 意 ， 这 个 变量 从 autovacuum 设置 中 继承 
值 。 





autovacuum_vacuum_threshold , toast.autovacuum_vacuum_threshold ( integer ) 


在 一 个 特定 的 表 上 发 起 vacuum 操作 之 前 ， 更 新 或 删除 的 元 组 的 最 小 值 。 


autovacuum_vacuum_scale_factor , toast.autovacuum_vacuum_scale_factor ( float4 ) 








添加 到 autovacuum_vacuum_threshold 的 reltuples 的 乘 数 。 
autovacuum_analyze_threshold ( integer ) 

在 一 个 特定 的 表 上 发 起 ANALYzE 操作 之 前 ， 插 入 、 更 新 或 删除 的 元 组 的 最 小 值 。 
autovacuum_analyze_scale factor ( float4 ) 

添加 到 autovacuum_analyze_threshold 的 reltuples 乘 数 。 
autovacuum_vacuum_cost_delay , toast.autovacuum_vacuum_cost_delay ( integer ) 
自 定义 autovacuum_vacuum_cost_delay 参 数 。 

autovacuum_vacuum_cost_limit , toast.autovacuum_vacuum_cost_limit ( integer ) 
自 定 义 autovacuum_vacuum_cost _ limit 参数。 

autovacuum_freeze_min_age , toast.autovacuum_freeze_min_age ( integer ) 


ar = = 


自 定义 autovacuum_vacuum_cost_limit 参 数 。 请 注意 ， 自动 清理 将 忽略 设置 一 个 每 
表 autovacuum_freeze_min_age 大 于 半 个 系统 范围 的 autovacuum freeze_max_age 设 置 的 尝 


试 。 





autovacuum_freeze_max_age , toast.autovacuum_freeze_max_age ( integer ) 


自 定义 autovacuum_freeze_max_age 参 数 。 请 注意 ， 自动 清理 将 忽略 设置 一 个 每 
表 autovacuum_freeze_max_age 大 于 系统 范围 的 设置 的 党 试 〈 它 只 能 设置 的 较 小 一 些 ) 。 注 
意 ， 你 可 以 将 autovacuum_freeze_max_age 设置 的 非常 小 ， 甚 至 为 雳 ， 这 通常 是 不 明智 的 ， 


为 它 将 强制 频繁 的 清理 。 





autovacuum_freeze_table_age , toast.autovacuum_freeze_table_age ( integer ) 








EE Xvacuum_freeze_table age 参数 。 





en ew al 
a 


不 建议 在 新 应 用 中 使 用 OID ， 可 能 情况 下 ， 更 好 的 选择 是 使 用 一 个 sERIAL 或 者 其 它 序 列 发 
生 器 做 表 的 主键 。 如 果 一 个 应 用 使 用 了 OID 标识 表 中 的 特定 行 ， 那么 建议 在 该 表 的 oid 字段 
上 创建 一 个 唯一 约束 ， 以 确保 该 表 的 OID 即使 在 计数 器 循环 之 后 也 是 唯一 的 。 如 果 你 需要 一 
个 整个 数据 库 范 围 的 唯一 标识 ， 那 么 就 要 避免 假设 OID 是 跨 表 唯一 的 ， 你 可 以 

用 tableoid 和 行 OID 的 组 合 来 实现 这 个 目的 。 





Tip: 对 那些 没有 主键 的 表 ， 不 建议 使 用 oIDs=FALSE ， 因为 如 果 既 没有 OD 又 没有 唯一 
数据 字段 ， 那 么 就 很 难 标识 特定 的 行 。 





PostgreSQL 自动 为 每 个 唯一 约束 和 主键 约束 创建 一 个 索引 以 确保 其 唯一 性 。 因 此 ， 不 必 为 
主键 字段 明确 的 创建 索引 。 参 阅 CREATE INDEX 获 取 更 多 信息 。 


唯一 约束 和 主键 在 目前 的 实现 里 是 不 能 继承 的 。 如 果 把 继承 和 唯一 约束 组 合 在 一 起 会 导致 无 
法 运转 。 


一 个 表 不 能 超过 1600 个 字段 。 实 际 的 限制 比 这 个 更 低 ， 因 为 还 有 元 组 长 度 限制 。 


例子 
创建 films 和 distributors X : 


CREATE TABLE films ( 


code char(5) CONSTRAINT firstkey PRIMARY KEY, 
title varchar(40) NOT NULL, 

did integer NOT NULL, 

date_prod date, 

kind varchar (10), 

len interval hour to minute 


); 
CREATE TABLE distributors ( 
did integer PRIMARY KEY DEFAULT nextval('serial'), 


name varchar(40) NOT NULL CHECK (name <> '') 
); 


创建 一 个 带 有 2 维 数组 的 表 : 


CREATE TABLE array_int ( 
vector int[][] 


); 


AR films 定义 一 个 唯一 表 约 束 。 唯一 表 约 束 可 以 在 表 的 一 个 或 多 个 字段 上 定义 : 


CREATE TABLE films ( 


code char(5), 

title varchar(40), 

did integer, 

date_prod date, 

kind varchar(10), 

len interval hour to minute, 


CONSTRAINT production UNIQUE(date_prod) 


定义 一 个 检查 列 约束 : 


CREATE TABLE distributors ( 
did integer CHECK (did > 100), 
name varchar (40) 


Ne 


定义 一 个 检查 表 约 束 : 


CREATE TABLE distributors ( 
did integer, 
name varchar (40) 
CONSTRAINT con1 CHECK (did > 100 AND name <> '') 


Ne 


AR films 定义 一 个 主键 表 约 束 。 


CREATE TABLE films ( 


code char(5), 

title varchar (40), 

did integer, 

date_prod date, 

kind varchar (10), 

len interval hour to minute, 


CONSTRAINT code_title PRIMARY KEY(code, title) 
ye 


AR distributors 定义 一 个 主键 约束 。 下 面 两 个 例子 是 等 效 的 ， 第 一 个 例子 使 用 了 表 约 束 语 
法 ， 第 二 个 使 用 了 列 约束 语法 。 


CREATE TABLE distributors ( 
did integer, 
name varchar(40), 
PRIMARY KEY(did) 


Ne 


CREATE TABLE distributors ( 
did integer PRIMARY KEY, 
name varchar (40) 


i 


下 面 这 个 例子 给 字段 name 赋予 了 一 个 文本 常量 缺 省 值 ， 并 且 将 字段 did 的 缺 省 值 安排 为 通 
选择 序列 对 象 的 下 一 个 值 生 成 。 modtime 的 缺 省 值 将 是 该 行 插入 的 时 间 戳 。 


CREATE TABLE distributors ( 
name varchar(40) DEFAULT 'Luso Films', 
did integer DEFAULT nextval('distributors_serial'), 
modtime timestamp DEFAULT current_timestamp 


ye 


TER distributors 上 定义 两 个 NoT NULL WR, 其 中 之 一 明确 给 出 了 名 字 : 


CREATE TABLE distributors ( 
did integer CONSTRAINT no_null NOT NULL, 
name varchar(40) NOT NULL 


Ne 


A name 字段 定义 一 个 唯一 约束 : 


CREATE TABLE distributors ( 
did integer, 
name varchar(40) UNIQUE 
) 


相同 的 ， 声 明 为 一 个 表 约 束 : 


CREATE TABLE distributors ( 


did integer, 
name varchar (40), 
UNIQUE (name) 


Ne 


创建 同样 的 表 ， 并 为 表 以 及 唯一 索引 指定 70% 填充 率 : 


CREATE TABLE distributors ( 
did integer, 
name varchar(40), 
UNIQUE(name) WITH (fillfactor=70) 


) 
WITH (fillfactor=70); 


创建 一 个 带 有 排除 约束 的 表 circles, BILE RAR BBS : 


CREATE TABLE circles ( 
c circle, 
EXCLUDE USING gist (c WITH &&) 


NF 


TER Z i] diskvol1 里 创建 cinemas K : 


CREATE TABLE cinemas ( 
id serial, 
name text, 
location text 

) TABLESPACE diskvol1; 


创建 一 个 复合 类 型 和 类 型 化 的 表 : 


CREATE TYPE employee_type AS (name text, salary numeric); 


CREATE TABLE employees OF employee_type ( 
PRIMARY KEY (name), 
salary WITH OPTIONS DEFAULT 1000 


Ne 


兼容 性 


CREATE TABLE 遵循 SQL 标 准 ， 一 些 例外 情况 在 下 面 列 出 。 


临时 表 


尽管 cREATE TEMPORARY TABLE 的 语法 和 SQL 标准 的 类 似 ， 但 是 效果 是 不 同 的 。 在 标准 里 ， 临 
时 表 只 是 定义 一 次 并 且 从 空 内 容 开 始 自 动 存在 于 任何 需要 它们 的 会 话 中 。 PostgreSQL 要 求 每 
个 会 话 为 它们 使 用 的 每 个 临时 表 发 出 它们 自己 的 CREATE TEMPORARY TABLE OPS, 这 样 就 允许 
不 同 的 会 话 将 相同 的 临时 表 名 字 用 于 不 同 的 目的 ， 而 标准 的 实现 方法 则 把 一 个 临时 表 名 字 约 
束 为 具有 相同 的 表 结 构 。 


标准 定义 的 临时 表 的 行为 被 广泛 地 忽略 了 。PostgreSQL 在 这 方面 上 的 行为 类 似 于 许多 其 它 
SQL 数据 库 系 统 。 


SQL 标准 也 区 分 全 局 和 局 部 临时 表 ， 局 部 临时 表 对 于 每 个 会 话 中 的 每 个 SQL 模块 都 有 一 个 单 
独 的 内 容 设 置 ， 虽然 它 的 定义 仍然 在 会 话 中 共享 。 因 为 PostgreSQL 不 支持 SQL 模块 ， 所 以 
这 个 差别 在 PostgreSQL 不 相关 。 

出 于 兼容 考虑 ，PostgreSQL 将 接受 临时 表 声 明 中 的 6LoBAL 和 Loca, 关键 字 ， 但 是 他 们 没有 
任何 作用 。 不 建议 使 用 这 些 关键 字 ， 因 为 PostgreSQL 的 未 来 版 本 可 能 采取 更 加 标准 兼容 的 
它们 的 含义 。 

临时 表 的 on commit 子 句 也 类 似 于 SQL 标准 ， 但 是 有 些 区 别 。 如 果 忽 略 了 on commit 子 句 ， 
SQL 标准 声明 缺 省 的 行为 是 ON COMMIT DELETE Rows 。 但 是 PostgreSQL 里 的 缺 省 行为 

是 oN coMMIT PRESERVE Rows 。 在 SQL 标准 里 不 存在 oN coMMIT DROP 选项 。 


非 延 迟 的 唯一 性 约束 


当 UNIQUE 或 PRIMARY KEY 约束 是 不 可 延迟 的 时 ， 当 插 入 或 修改 一 个 行 时 ，PostgreSQL 立即 
检查 唯一 性 。SQL 标 准 说 唯一 约束 应 该 只 在 语句 的 结尾 强制 执行 ; 这 使 得 它 和 PostgreSQL 不 
同 ， 例 如 ， 一 个 命令 更 新 多 个 键 值 。 要 获得 标准 兼容 的 行为 ， 声 明 该 约束 为 ”DEFERRABLE 但 
是 不 能 延迟 (也 就 是 说 ， INITIALLY IMMEDIATE ) 。 要 知道 ， 这 会 比 立 即 检查 唯一 性 要 慢 的 


多 。 


列 检 查 约束 


SQL 标准 说 cHEck 列 约 束 只 能 引用 他 们 作用 的 字段 ; 只 有 check 表 约 束 才 能 引用 多 个 字段 。 
PostgreSQL 并 不 强制 这 个 限制 ; 它 把 字段 和 表 约 束 看 作 相 同 的 东西 。 


EXCLUDE 约束 


EXCLUDE 约束 类 型 是 一 个 PostgreSQL 扩 展 。 


NULL " 约 R" 


NULL "约束 "( 实 际 上 不 是 约束 ) 是 PostgreSQL 对 SQL 标准 的 扩展 ， 包括 它 是 为 了 和 其 它 一 些 
数据 库 系 统 兼 容 以 及 为 了 和 NoT NULL 约束 对 称 。 因 为 它 是 任何 字段 的 缺 省 ， 所 以 它 的 出 现 是 
没有 意义 的 。 


2k 7K 


通过 INHERITS 子 句 的 多 重 继承 是 PostgreSQL 语言 的 扩展 。SQL:1999 及 以 后 的 标准 使 用 不 
同 的 语法 和 语义 定义 了 单 继承 。 SQL:1999 风 格 的 继承 还 没有 在 PostgreSQL 中 实现 。 


BFR 


PostgreSQL 人 允许 创建 没有 字段 的 表 ( 比 如 CREATE TABLE foo(); )。 这 是 对 SQL 标准 的 扩展 ， 
标准 不 允许 存在 需 字 段 表 。 需 字段 表 本 身 没什么 用 ， 但 是 禁止 他 们 会 
给 ALTER TABLE DROP COLUMN 带 来 很 奇怪 的 情况 ， 所 以 ， 这 个 时 候 忽 视 标准 的 限制 概念 非常 清 


林木 
XEo 


WITH +4) 
WITH 子 句 是 PostgreSQL 的 扩展 ， 同 样 ， 存储 参数 和 OID 也 是 扩展 。 
表 空 间 


PostgreSQL 的 表 空 间 概念 不 是 标准 的 东西 。 因此 TABLESPACE 和 USING INDEX TABLESPACE 都 是 
扩展 。 


类 型 化 的 表 

类 型 化 的 表 实 现 了 SQL 标准 的 一 个 子 集 。 根 据 标 准 ， 类 型 化 的 表 有 对 应 于 底层 复合 类 型 和 一 
个 其 他 的 "自我 参考 字段 "。 PostgreSQL 没 有 明确 支持 这 些 自我 参考 字段 ， 但 是 相同 的 效果 可 
以 使 用 OID 特 性 达到 。 

XI 


ALTER TABLE, DROP TABLE, CREATE TABLE AS, CREATE TABLESPACE, CREATE 
TYPE 


CREATE TABLE AS 


Name 


CREATE TABLE AS -- 从 一 条 查询 的 结果 中 定义 一 个 新 表 


Synopsis 


CREATE [ [ GLOBAL | LOCAL ] { TEMPORARY | TEMP } | UNLOGGED ] TABLE _table_name_ 
[ (_column_name_ [, ...] ) ] 
[ WITH ( _storage_parameter_ [= _value_] [, ... ] ) | WITH OIDS | WITHOUT OIDS ] 
[ ON COMMIT { PRESERVE ROWS | DELETE ROWS | DROP } ] 
[ TABLESPACE _tablespace_name_ ] 
AS _query_ 
[ WITH [ NO ] DATA ] 


CREATE TABLE AS 创建 一 个 表 并 且 用 来 自 sELEcT 命令 的 结 bee BR. 该 表 的 字段 和 
SELECT 输出 字段 的 名 字 及 数据 类 型 相关 。 (不 过 你 可 以 通过 明确 地 给 出 一 个 字段 名 字 列 表 来 
覆盖 SELECT 输出 字段 的 名 字 。) 


CREATE TABLE AS 和 创建 视图 有 点 像 ， 不 过 两 者 之 间 实 在 是 差异 很 大 : 它 创建 一 个 新 表 并 且 只 
对 查询 计算 一 次 来 填充 这 个 新 表 。 新 表 不 能 跟踪 源 表 的 变化 。 相 比 之 下 ， 每 次 做 查询 的 时 
候 ， 视 图 都 重新 计算 定义 它 的 SELECT 语句 。 


参数 


GLOBAL 或 LOCAL 


忽略 ， 仅 仅 为 了 兼容 性 而 存在 。 这 些 关键 字 的 使 用 已 经 废弃 了 ; 请 参考 CREATE TABLE 获 取 
细节 。 


TEMPORARY 或 TEMP 


如 果 声 明了 这 个 选项 ， 则 该 表 作 为 临时 表 创 建 。 参阅 CREATE TABLE 获 取 细 节 。 


UNLOGGED 


如 果 声 明了 这 个 选项 ， 则 该 表 作 为 非 日 志 表 创建 。 参阅 CREATE TABLE 获 取 细 节 。 


_table_name_ 


要 创建 的 表 名 (可 以 用 模式 修饰 )。 

_column_name_ 

新 表 中 字段 的 名 称 。 如 果 没 有 提供 字段 名 字 ， 那 么 就 从 查询 的 输出 字段 名 中 获取 。 
WITH ( _storage_parameter_ [= _value_ ][,...]) 


这 个 子 句 为 新 表 指 定 了 可 选 的 存储 参数 ; 参见 存储 参数 获取 更 多 信息 。 with 子 句 还 可 以 包 
含 oIDS=TRUE (RR ors) 来 为 新 表 中 的 行 分 配 和 存储 OID( 对 象 表 示 符 ) ; 或 者 
FA oIDs=FALSE 表示 不 分 配 OID 。 参 见 CREATE TABLE 获 取 更 多 信息 。 


WITH OIDS* “WITHOUT OIDS 


这 些 是 反对 使 用 的 、 分 别 等 价 于 wITH (oros) 和 with (oIDS=FALSE) 的 语法 。 如 果 你 希望 同时 
给 出 oIDs 设置 和 存储 人 参数， 必须 使 用 wITH ( ..，) 语法 ; 见 下 文 。 


ON COMMIT 
可 以 使 用 oN commit 控制 临时 表 在 事务 块 结尾 的 行为 。 三 个 选项 是 : 
PRESERVE ROWS 

在 事务 的 结尾 不 采取 任何 特别 的 动作 ， 这 是 缺 省 。 

DELETE ROWS 


在 每 个 事务 块 的 结尾 都 删除 临时 表 中 的 所 有 行 。 本 质 上 是 在 每 次 提交 事务 后 自动 执行 一 
个 TRUNCATE 命 邻 。 


DROP 

在 当前 事务 块 的 结尾 将 删除 临时 表 。 

TABLESPACE _tablespace_name_ 

指定 新 表 将 要 在 _tablespace_name ” 表 空 间 内 创建 。 如 果 没 有 声明 ， 将 咨询 
default_tablespace, 或 如 果 该 表 为 临时 表 ， 那 么 将 使 用 temp_tablespaces。 
_query_ 


一 个 SELECT、TABLE 或 VALUES 命 令 ， 或 者 一 个 运行 预备 好 的 SELECT, TABLE 或 VALUES 
查询 的 EXECUTE 命 兮 。 


WITH [ NO ] DATA 


这 个 子 句 指定 查询 产生 的 数据 是 否 应 该 拷贝 到 新 表 中 。 如 果 不 ， 那 么 只 拷贝 表 结 构 。 RAE 
拷贝 数据 。 


这 条 命令 在 功能 上 等 效 于 SELECT INTO， 但 是 更 建议 你 用 这 个 命令 ， 因 为 它 不 太 可 能 
和 sELEcT Into 语法 的 其 它 方面 混淆 。 另外 ， CREATE TABLE AS 提供 了 sELEcT into 功能 的 超 


集 。 


在 PostgreSQL 8.0 之 前 ， CREATE TABLE AS 总 是 在 它 创 建 的 表 中 包含 OID ， 而 在 
PostgreSQL 8.0 Æ, CREATE TABLE As 命令 允许 明确 声明 是 否 应 该 包含 OID 。 如 果 没 有 明确 
声明 是 否 应 该 包含 OID ， 那么 使 用 配置 变量 default with_oids 的 设置 。 到 了 PostgreSQL 这 
个 变量 缺 省 为 假 ， 缺 省 行为 和 8.0 之 前 的 版 本 不 同 。 因 此 ， 那 些 要 求 cREATE TABLE As 创建 
的 表 包 含 OID 的 应 用 应 该 明确 声明 wrth (orms) 以 确保 要 求 的 行为 。 


例子 
创建 一 个 只 包含 表 films 中 最 近 的 记录 的 新 表 films_recent : 


CREATE TABLE films_recent AS 
SELECT * FROM films WHERE date_prod >= '2002-01-01'; 


要 完整 的 拷贝 一 个 表 ， 也 可 以 使 用 TABLE 命令 的 简易 形式 : 


CREATE TABLE films2 AS 
TABLE films; 


使 用 预备 语句 创建 一 个 只 包含 表 films 中 最 近 的 记录 的 新 临时 表 films_recent ， 该 临时 表 包 
含 OID 并 且 在 事务 结束 时 将 被 删除 : 


PREPARE recentfilms(date) AS 
SELECT * FROM films WHERE date_prod > $1; 

CREATE TEMP TABLE films_recent WITH (OIDS) ON COMMIT DROP AS 
EXECUTE recentfilms('2002-01-01'); 


RANE 


CREATE TABLE AS 兼容 SQL 标准 ， 下 面 是 非 标准 的 扩展 : 

。 标准 要 求 在 子 查询 子 句 周围 有 圆 括 弧 ， 在 PostgreSQL 里 ， 这 些 圆 括 弧 是 可 选 的 。 
。 在 标准 中 ， WITH [ No ] DATA 子 句 是 必 选 的 ; 在 PostgreSQL 中 ， 它 是 可 选 的 。 

。 PostgreSQL 处 理 临 时 表 的 方法 和 标准 相差 较 大 ; 参阅 CREATE TABLE 获 取 细 节 。 
e with 子 句 是 PostgreSQL 扩 展 ， 并 且 SQL 标准 中 也 没有 存储 参数 和 OID. 


e PostgreSQL 表 空间 的 概念 也 不 是 标准 的 一 部 分 。 因此 TABLESPACE 子 句 也 是 扩展 。 
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XI 


CREATE MATERIALIZED VIEW, CREATE TABLE, EXECUTE, SELECT, SELECT INTO, 
VALUES 


CREATE TABLE AS 1720 


CREATE TABLESPACE 


Name 


CREATE TABLESPACE -- 定义 一 个 新 的 表 空 间 


Synopsis 


CREATE TABLESPACE _tablespace_name_ [ OWNER _user_name_ ] LOCATION '_directory_' 


摘 述 

CREATE TABLESPACE 注册 一 个 集群 范围 内 的 新 表 空 间 。 表 空 间 的 名 字 必 须 在 该 数据 库 集群 中 的 
任何 现 有 表 空 间 中 唯一 。 
表 空 间 人 允许 超级 用 户 在 文件 系统 中 定义 一 个 可 选 的 位 置 ， 这 个 位 置 可 以 存放 代表 数据 库 对 象 
的 数据 文件 (比如 表 和 索引 )。 


一 个 用 户 ， 如 果 有 合适 的 权限 ， 就 可 以 把 CREATE DATABASE , CREATE TABLE , CREATE INDEX , 
ADD CONSTRAINT 之 一 传递 给 _tablespace_name_, 这 样 就 让 这 些 对 象 的 数据 文件 存储 在 指定 
的 表 空 间 里 。 


参数 


_tablespace_name_ 

要 创建 的 表 空 间 的 名 字 。 这 个 名 字 不 能 以 pg。 Fk, 因为 这 些 名 字 是 保留 给 系统 表 空间 使 用 
的 。 

_user_name_ 

将 拥有 这 个 表 空 间 的 用 户 名 。 如 果 省 略 ， 缺 省 为 执行 此 命令 的 用 户 名 。 只 有 超级 用 户 可 以 创 
建 表 空间 ， 但 是 他 们 可 以 把 表 空 间 的 所 有 者 授予 非 超级 用 户 。 

_directory_ 


用 于 表 空 间 的 目录 。 目 录 必 须 是 空 的 ， 并 且 由 运行 PostgreSQL 系统 用 户 所 有 。 目 录 必 须 用 一 
个 绝对 路 径 声 明 。 


只 有 在 那些 支持 符号 连接 的 系统 上 才 支 持 表 空间 。 


CREATE TABLESPACE 不 允许 在 一 个 事务 块 内 部 执行 。 


例子 
在 /data/dbs 创建 一 个 表 空 间 dbspace : 


CREATE TABLESPACE dbspace LOCATION '/data/dbs'; 


在 /data/indexes 创建 一 个 表 空 间 indexspace 并 由 用 户 genevieve 所 有 : 


CREATE TABLESPACE indexspace OWNER genevieve LOCATION '/data/indexes'; 


FANE 


CREATE TABLESPACE 是 PostgreSQL 扩 展 。 


义 见 


CREATE DATABASE, CREATE TABLE, CREATE INDEX, DROP TABLESPACE, ALTER 
TABLESPACE 


CREATE TEXT SEARCH CONFIGURATION 


Name 


CREATE TEXT SEARCH CONFIGURATION -- 定义 一 个 新 的 文本 搜索 配置 


Synopsis 


CREATE TEXT SEARCH CONFIGURATION _name_ ( 
PARSER = _parser_name_ | 
COPY = _source_config 





CREATE TEXT SEARCH CONFIGURATION 创建 新 的 文本 搜索 配置 。 一 个 文本 搜索 配置 声明 一 个 能 将 
一 个 字符 串 划 分 成 符号 的 文本 搜索 解析 器 ， 加 上 可 以 用 于 确定 搜索 对 哪些 标记 感 兴趣 的 字 
典 


7x0 


若 仅 声明 分 析 器 ， 那 么 新 的 文本 搜索 配置 初始 没有 从 符号 类 型 到 词典 的 映射 ， 因此 会 忽略 所 
有 的 单词 。 后 来 的 ALTER TEXT SEARCH CONFIGURATION 命令 必须 用 于 创建 映射 来 使 得 配置 是 有 
效 的 。 或 者 ， 可 以 拷贝 现 有 的 文本 搜索 配置 。 


若 模 式 名 称 已 给 出 ， 那 么 文本 搜索 配置 会 在 声明 的 模式 中 创建 。 否 则 会 在 当前 模式 创建 。 
定义 文本 搜索 配置 的 用 户 成 为 其 所 有 者 。 


查阅 Chapter 12 获 取 更 多 信息 。 


参数 


_name_ 


要 创建 的 文本 搜索 配置 的 名 称 。 该 名 称 可 以 有 模式 修饰 。 


_parser_name_ 


用 于 该 配置 的 文本 搜索 分 析 器 的 名 称 。 


source_config 


要 复制 的 现 有 文本 搜索 配置 的 名 称 。 





注意 
PARSER 和 copy 选项 是 互相 排斥 的 ， 因为 当 一 个 现 有 配置 被 复制 ， 其 分 析 器 配置 也 被 复制 
ie 


FANE 


在 SQL 标准 中 没有 CREATE TEXT SEARCH CONFIGURATION 语句 。 


义 见 


ALTER TEXT SEARCH CONFIGURATION, DROP TEXT SEARCH CONFIGURATION 


CREATE TEXT SEARCH DICTIONARY 


Name 


CREATE TEXT SEARCH DICTIONARY -- 定义 一 个 新 的 文本 搜索 字典 


Synopsis 


CREATE TEXT SEARCH DICTIONARY _name_ ( 
TEMPLATE = _template_ 
[, _option_ = _value_ [, ... ]] 





CREATE TEXT SEARCH DICTIONARY 创建 一 个 新 的 文本 搜索 字典 。 一 个 文本 搜索 字典 指定 了 一 个 
发 现 查询 中 感 兴趣 或 者 不 感 兴趣 的 词 的 方式 。 一 个 基于 文本 搜索 模板 的 字典 ， 它 声明 了 实际 
上 执行 工作 的 函数 。 通常 字典 提供 了 一 些 选项 ， 这 些 选项 控制 模板 函数 的 详细 性 能 。 


若 给 出 模式 名 称 ， 那 么 文本 搜索 字典 就 会 在 指定 模式 中 创建 。 否 则 会 在 当前 模式 中 创建 。 
创建 文本 搜索 字典 的 用 户 将 成 为 其 所 有 者 。 


Sh] Chapter 12 获 取 更 多 详细 信息 。 


参数 


要 创建 的 文本 搜索 字典 的 名 称 。 名 称 可 以 有 模式 修饰 。 
_template_ 

定义 字典 基本 行为 的 文本 搜索 模板 的 名 称 。 

_option_ 

为 该 字典 设置 的 特定 模板 选项 的 名 称 。 

_value_ 


用 于 特定 模板 选项 的 值 。 如 果 该 值 不 是 一 个 简单 的 标识 符 或 号 码 ， 它 必须 被 引用 (如 果 您 希 
望 ， 您 就 可 以 一 直 引 用 它 ) 。 


这 个 选项 可 以 以 任何 顺序 出 现 。 


例子 
下 面 的 示例 命令 用 停 用 词 的 非 标准 列表 创建 了 一 个 基于 snowball 的 字典 。 


CREATE TEXT SEARCH DICTIONARY my_russian ( 
template = snowball, 
language = russian, 
stopwords = myrussian 


Ne 


RAIE 


在 SQL 标准 中 没有 CREATE TEXT SEARCH DICTIONARY 语句 。 


义 见 


ALTER TEXT SEARCH DICTIONARY, DROP TEXT SEARCH DICTIONARY 


CREATE TEXT SEARCH PARSER 


Name 


CREATE TEXT SEARCH PARSER -- 定义 一 个 新 的 文本 搜索 的 解析 器 


Synopsis 


CREATE TEXT SEARCH PARSER _name_ ( 
START = _start_function_ , 
GETTOKEN = _gettoken_function_ , 
END = _end_function_ , 
LEXTYPES = _lextypes_function_ 
[, HEADLINE = _headline_function_ ] 


CREATE TEXT SEARCH PARSER 定义 一 个 新 的 文本 搜索 的 解析 器 。 一 个 文本 搜索 解析 器 定义 一 个 
将 文本 字符 串 分 解 为 符号 的 方法 ， 并 且 为 符号 设 定 类 型 (类 ) 。 一 个 解析 器 本 身 不 是 特别 有 
H, 但 必须 连同 一 些 文本 搜索 字典 一 起 绑 定 到 一 个 文本 搜索 配置 中 ， 用 于 搜索 。 


若 给 出 模式 名 称 ， 那 么 文本 搜索 解析 器 就 会 在 指定 模式 中 创建 。 否 则 会 在 当前 模式 中 创建 。 


您 必须 是 超级 用 户 才 能 使 用 CREATE TEXT SEARCH PARSER. (做 这 个 限制 的 原因 是 一 个 错误 的 
文本 搜索 解析 器 的 定义 会 混淆 甚至 崩溃 服务 器 。) 


参阅 Chapter 12 获 取 更 多 信息 。 


参数 


_name_ 


要 创建 的 文本 搜索 解析 器 的 名 称 。 名 称 可 以 有 模式 修饰 。 


_start_function_ 


解析 器 启动 函数 的 名 称 。 


_gettoken_function_ 


为 解析 器 获取 下 一 个 符号 的 函数 的 名 称 。 


_end_function_ 


ARNT as 2 RAYE MM 

_lextypes_function_ 

fieitaslextypesWMNAM (一 个 返回 关于 其 产生 的 符号 类 型 集 的 信息 的 画 数 ) 。 

_headline_function_ 

解析 器 的 标题 画 数 的 名 称 ( 一 个 总 结 一 组 符号 的 函数 ) 。 
给 


RU SAS, MAMA ARE th. RA 
URE MEN. ERT RAAB BY. 


出 参数 类 型 ， 因为 函数 的 每 种 类 型 的 参数 
参数 可 以 以 任何 顺序 出 现 ， 不 仅 是 上 面 所 示 的 。 


兼容 性 


在 SQL 中 没有 CREATE TEXT SEARCH PARSER 语句 。 


义 见 


ALTER TEXT SEARCH PARSER, DROP TEXT SEARCH PARSER 


CREATE TEXT SEARCH TEMPLATE 


Name 


CREATE TEXT SEARCH TEMPLATE -- 定义 一 个 新 的 文本 搜索 模板 


Synopsis 


CREATE TEXT SEARCH TEMPLATE _name_ ( 
[ INIT = _init_function_ , ] 
LEXIZE = _lexize_function_ 


CREATE TEXT SEARCH TEMPLATE 定义 一 个 新 的 文本 搜索 模板 。 文本 搜索 模板 定义 执行 文本 搜索 
字典 的 函数 。 一 个 模板 本 身 无 效 的 ， 必须 作为 一 个 字典 实例 化 示 能 使 用 。 字 典 通 常 声明 给 定 
AIBA Sl i AL 


若 给 出 模式 名 称 ， 那 么 文本 搜索 模板 会 在 声明 的 模式 中 创建 。 否 则 会 在 当前 模式 创建 。 


您 必须 是 超级 用 户 使 用 cREATE TEXT SEARCH TEMPLATE o 做 这 个 限制 的 原因 是 一 个 错误 的 文本 
搜索 模板 定义 可 能 会 混淆 甚至 骨 溃 服务 器 。 从 字典 中 分 离 模板 的 原因 是 模板 封装 定义 字典 
的 "不 安全 "方面 。 在 定义 字典 时 可 以 设置 的 参数 对 于 要 设置 的 非特 权 用 户 来 说 是 安全 的 ， 
此 创建 一 个 字典 不 需要 特权 操作 。 


Bh Chapter 12 获 取 更 多 信息 。 


参数 


_name_ 


要 创建 的 文本 搜索 模板 的 名 称 。 名 称 可 以 有 模式 修饰 。 


_init_function_ 


AAR A) HAH LAY BN 


_lexize_function_ 


模板 的 lexize 画 数 的 名 称 。 


若 需 要 ， 画 数 名 可 以 有 模式 修饰 。 未 给 出 参数 类 型 ， 因为 每 个 函数 类 型 的 参数 列表 都 是 预定 
的 。lexize 加 数 是 必须 的 ， 而 init 男 数 是 可 选 的 。 


参数 可 以 以 任何 顺序 出 现 ， 不 仅仅 是 上 面 显 示 的 那样 。 


兼容 性 


在 SQL 标准 中 没有 CREATE TEXT SEARCH TEMPLATE 语句 。 


义 见 


ALTER TEXT SEARCH TEMPLATE, DROP TEXT SEARCH TEMPLATE 


CREATE TRIGGER 


Name 


CREATE TRIGGER -- 定义 一 个 新 触发 器 


Synopsis 


CREATE [ CONSTRAINT ] TRIGGER _name_ { BEFORE | AFTER | INSTEAD OF } { _event_[ OR... ] 
ON _table_name_ 
[ FROM _referenced_table_name_ 
{ NOT DEFERRABLE | [ DEFERRABLE ] { INITIALLY IMMEDIATE | INITIALLY DEFERRED } } 
[ FOR [ EACH ] { ROW | STATEMENT } ] 
[ WHEN ( _condition_ ) ] 
EXECUTE PROCEDURE _function_name_ ( _arguments_ ) 


where ~_event_~ can be one of: 


INSERT 

UPDATE [ OF _column_name_ [, ... ] ] 
DELETE 

TRUNCATE 





fia ah 


CREATE TRIGGER 创建 一 个 新 的 触发 器 。 触发 器 将 与 指定 表 或 视图 关联 并 且 将 在 特定 事件 发 生 
时 执行 声明 的 _function_name_ EBX. 


触发 器 可 以 声明 为 在 对 记录 进行 操作 之 前 (在 检查 约束 之 前 和 INSERT, UPDATE, DELETE 4h 
行 前 ) ; 或 操作 完成 之 后 (在 检查 约束 之 后 和 完成 INSERT, UPDATE, UPDATE 操作 ) ; 或 取代 
操作 (在 视图 上 插入 、 更 新 或 删除 ) 触发 。 如 果 触 发 器 在 事件 之 前 或 者 取代 事件 ， 触发 器 可 
能 略 过 当前 记录 的 操作 或 改变 被 插入 的 记录 (只 对 UPDATE 和 uPDATE 操作 有 效 )。 如 果 触 发 器 
在 事件 之 后 ， 所 有 更 改 ， 包 括 其 他 触发 器 的 影响 ， 对 触发 器 都 是 "可 见 "的 。 


一 个 被 标记 为 FOR EACH Row 的 触发 器 为 操作 修改 的 每 一 行 都 调用 一 次 。 比如， 一 个 影响 10 
行 的 bfLETE 将 导致 任何 在 目标 关系 上 的 oN DELETE 触发 器 独立 调用 10 次 ， 每 个 被 删除 的 行 
调用 一 次 。 相 比 之 下 ， 一 个 被 标记 为 FOR EACH STATEMENT 的 触发 器 只 执行 一 次 ， 而 不 管 有 多 
少 行 被 修改 。 (特别 是 ， 一 个 修改 需 行 的 操作 仍然 会 导致 合适 的 FOR EACH STATEMENT 触发 器 
被 执行 。 


指定 为 触发 INSTEAD oF 触发 器 事件 的 触发 器 必须 被 标记 为 ”FoR EACH Row ， 并 且 只 能 在 视图 
上 定义 。 视 图 上 的 BEFORE 和 AFTER 触发 器 必须 被 标记 为 FOR EACH STATEMENT 。 


另外 ， 触 发 器 可 能 被 定义 为 为 TRUNCATE 触发 ， 尽管 只 有 For EACH STATEMENT o 
下 面 表 总 结 中 的 触发 器 类 型 可 能 被 用 在 表 和 视图 上 : 


何 时 事件 行 级 别 语句 级 别 
BEFORE INSERT / UPDATE / DELETE 表 表 和 视图 
TRUNCATE 表 
AFTER INSERT / UPDATE / DELETE 表 表 和 视图 
TRUNCATE = 表 
INSTEAD OF INSERT / UPDATE / DELETE 视图 一 
TRUNCATE a = 


还 有 ， 触 发 器 定义 可 以 声明 一 个 布尔 wei 条 件 ， 用 来 测试 触发 器 是 否 应 该 被 触发 。 在 行 级 
别 触 发 器 中 ， wHEN 条 件 可 以 检测 该 行 的 字段 的 旧 的 和 /或 新 值 。 语句 级 别 的 触发 器 也 可 以 拥 
有 wien 和 条件， 尽管 该 特性 对 于 它们 来 说 不 太 有 用 ， 因为 该 条 件 不 能 引用 表 中 的 任何 值 。 

如 果 多 个 同类 型 的 触发 器 为 同一 事件 做 了 定义 ， 那 么 它们 将 按照 字母 顺序 被 触发 。 


当 声 明了 coNSTRAINT 选项 时 ， 这 个 命令 创建 一 个 约束 触发 器 。 作为 正规 触发 器 也 是 相同 的 ， 
除了 触发 器 触发 的 时 间 可 以 使 用 SET CONSTRAINTS 调整 。 约 束 触发 器 必须 是 AFTER Row fh 
发 器 。 它们 可 以 在 导致 触发 事件 的 语句 的 结束 触发 ， 也 可 以 在 包含 的 事务 的 结束 触发 ; 在 后 
面 一 种 情况 下 ， 它 们 被 称 为 延迟 的 。 一 个 等 待 延迟 的 触发 器 触发 也 可 以 通过 使 

用 SET CONSTRAINTS 强制 立即 发 生 。 当 它 们 实现 的 约束 非法 时 ， 约 束 触 发 器 预计 会 引发 一 个 异 
Ho 

SELECT 并 不 更 改 任何 行 ， 因 此 你 不 能 创建 sELEcT 触发 器 。 这 种 场合 下 规则 和 视图 更 合适 


此 
—— 0 


请 参考 Chapter 36 获 取 更 多 触发 器 信息 。 


_name_ 


赋予 新 触发 器 的 名 称 。 它 必需 和 任何 作用 于 同一 表 的 触发 器 不 同 。 该 名 字 不 能 是 模式 修饰 的 
一 触发 器 继承 它 的 表 的 模式 。 对 于 约束 触发 器 ， 当 使 用 set constraints 修改 触发 器 的 行为 
时 ， 这 也 是 要 使 用 的 名 字 。 


BEFORE’ “AFTER INSTEAD OF 


决定 该 图 数 是 在 事件 之 前 、 之 后 还 是 取代 事件 时 调用 。 约束 触发 器 只 能 被 声明 为 AFTER o 


_event_ 


INSERT 、 UPDATE 、 DELETE 或 TRUNCATE 之 一 。 它 声明 激发 触发 器 的 事件 。 多 个 事件 可 以 
用 oR 声明 。 


对 于 UPDATE BF, (HAR SSA APS SRR BE 


UPDATE OF _column_namei_ [, _column_name2_... ] 





该 触发 器 将 只 在 至 少 一 个 列表 中 的 字段 在 uppATE 命令 的 目标 中 提 及 时 触发 。 

INSTEAD OF UPDATE 事件 不 支持 字段 的 列表 。 

_table_name_ 

触发 器 作用 的 表 或 视图 的 名 称 ( 可 以 有 模式 修饰 ) 

_referenced_table_name_ 

约束 引用 的 另外 一 个 表 的 名 字 〈 可 以 有 模式 修饰 ) 。 这 个 选项 用 于 外 键 约束 ， 不 推荐 用 于 一 
般 用 途 。 只 能 为 约束 触发 器 指定 。 

DEFERRABLE NOT DEFERRABLE INITIALLY IMMEDIATE INITIALLY DEFERRED 

触发 器 的 默认 时 机 。 参 阅 CREATE TABLE 文 档 获取 这 些 约束 选项 的 详细 信息 。 只 能 为 约束 触 
发 器 指定 。 

FOR EACH ROW FOR EACH STATEMENT 

这 些 选项 声明 触发 器 过 程 是 否 为 触发 器 事件 影响 的 每 个 行 触 发 一 次 ， 还 是 只 为 每 条 SQL 语句 
触发 一 次 。 如 果 都 没有 声明 ， 那么 FoR EACH STATEMENT 将 是 缺 省 。 约束 触发 器 只 能 声明 


为 FOR EACH ROW 。 

_condition_ 

一 个 决定 触发 器 函数 实际 上 是 否 执行 的 布尔 表达 式 。 如 果 声 明了 wien, 那么 该 图 数 只 

有 _condition ”返回 true 时 被 调用 。 在 For EACH Row PRA BSH, wHEN 条 件 可 以 通过 分 别 
写 OLD. ~ ~_column_name_ 或 NEW.  ~_column_name_ 参考 字段 的 旧 的 和 /或 新 的 行 值 。 当 

SK, INSERT 触发 器 不 能 参考 omn, o 触发 器 不 能 参考 NEw 。 


INSTEAD OF 触发 器 不 支持 whEN 条 件 。 
目前 ， wHEN 表达 式 不 能 包含 子 查询 。 


请 注意 ， 对 于 约束 触发 器 ， wien 条 件 的 计算 是 不 延迟 的 ， 只 是 在 行 更 新 操作 执行 之 后 立即 
发 生 。 如 果 该 条 件 计算 不 为 真 ， 那么 触发 器 就 不 排队 延迟 执行 。 
_function_name_ 


一 个 用 户 提供 的 画 数 ， 它 声明 为 不 接受 参数 并 且 返 回 trigger KH, 该 函数 将 在 触发 器 被 触 
发 时 调用 。 


_arguments_ 


一 个 可 选 的 用 至 号 分 隔 的 参数 列表 ， 它 将 在 触发 器 执行 的 时 候 提 供给 函数 。 这 些 参数 是 文本 
字符 串 常量 。 也 可 以 在 这 里 写 简 单 的 名 字 和 数值 常量 ， 但 是 它们 会 被 转换 成 字符 串 。 请 检查 
该 触发 器 男 数 的 实现 语言 的 描述 ， 找 出 如 何在 该 落 数 中 访问 这 些 参数 ; 这 些 参数 可 能 和 普通 
的 范 数 参数 不 同 。 


MN 一 


ae 


要 在 表 上 创建 一 个 触发 器 ， 用 户 必需 在 该 表 上 有 TRIGGER 权限 。 Artie in se eae 
有 execute 权限 。 


使 用 DROP TRIGGER 删 除 触 发 器 。 


字段 特有 的 触发 器 (使 用 uppaTe oF _column_name ”定义 的 ) 将 在 它 的 任意 字段 作为 目标 列 
出 在 upare 命令 的 set 列表 中 时 触发 。 当 触发 器 没有 触发 时 ， 字 上 段 的 值 也 是 有 可 能 改变 
的 ， 因 为 通过 BEFORE UPDATE 触发 器 做 的 行内 容 的 改变 是 不 考虑 的 。 相 反 的 ， ME 

如 UPDATE ... SET x = x ... 将 触发 在 字段 x 上 的 触发 器 ， 尽 管 字段 的 值 没有 改变 。 


在 BEFORE 触发 器 中 ， wien 条 件 只 在 函数 被 或 将 被 执行 之 前 计算 ， 所 以 使 用 whEN 与 在 触发 
器 画 数 的 开始 测试 相同 的 条 件 并 无 实质 区 别 。 要 特别 的 注意 ， 条 件 看 到 的 new 行 是 当前 的 

值 ， 可 能 被 早 些 的 触发 器 修改 了 。 BA, BEFORE 触发 器 的 whEN 条 件 不 允许 检测 new TH 
系统 字段 (比如 oid )， 因 为 那些 目前 还 没有 设置 。 


在 AFTER 触发 器 中 ， whEN 条 件 只 在 行 更 新 发 生 之 后 计算 ， 并 且 它 决定 一 个 事件 是 否 在 语句 
的 最 后 排队 触发 该 触发 器 。 所 以 当 AFTER 触发 器 的 wen 条 件 没有 返回 真 时 ， 不 需要 排队 一 
个 事件 ， 也 不 需要 在 语句 的 最 后 重新 抓 取 行 。 如 果 触 发 器 只 需要 为 少量 的 行 触发 ， 这 会 导致 
修改 许多 行 的 语句 明显 的 加 速 。 


在 PostgreSQL 7.3 以 前 ， 必须 把 触发 器 函数 声明 为 返回 opaque 占 位 类 型 ， 而 不 
是 trigger 类 型 。 为 了 支持 加 载 老 的 转 储 文件 ， CREATE TRIGGER 将 接受 一 个 声明 为 返回 
opaque 的 范 数 ， 但 是 它 将 发 出 一 条 NOTICE 并 且 把 函数 声明 的 返回 类 型 改 成 trigger o 


例子 
当 表 accounts 的 一 行 要 被 更 新 时 ， AutT HA check_account_update 


CREATE TRIGGER check_update 
BEFORE UPDATE ON accounts 
FOR EACH ROW 
EXECUTE PROCEDURE check_account_update(); 


同样 的 ， 但 是 只 在 字段 balance 4 uppate 命 合 的 目标 中 指定 时 执行 该 贺 数 : 


CREATE TRIGGER check_update 
BEFORE UPDATE OF balance ON accounts 
FOR EACH ROW 
EXECUTE PROCEDURE check_account_update(); 


这 种 形式 只 在 字段 balance 实际 上 改变 了 值 时 执行 该 贺 数 : 


CREATE TRIGGER check_update 
BEFORE UPDATE ON accounts 
FOR EACH ROW 
WHEN (OLD.balance IS DISTINCT FROM NEW.balance) 
EXECUTE PROCEDURE check_account_update(); 


只 在 改变 了 什么 东西 时 ， 调 用 加 数 记录 accounts 的 更 新 : 


CREATE TRIGGER log_update 
AFTER UPDATE ON accounts 
FOR EACH ROW 
WHEN (OLD.* IS DISTINCT FROM NEW.*) 
EXECUTE PROCEDURE log_account_update(); 


AR—TAIMA HA view_insert_row 以 在 一 个 视图 下 插入 行 到 表 : 


CREATE TRIGGER view_insert 
INSTEAD OF INSERT ON my_view 
FOR EACH ROW 
EXECUTE PROCEDURE view_insert_row(); 


Section 36.4 包 含 一 个 完整 的 用 C 写 的 触发 器 函数 的 例子 。 


兼容 性 


PostgreSQL 里 的 CREATE TRIGGER 语句 实现 了 一 个 SQL 标准 的 子 集 。 目 前 仍然 缺少 下 面 的 功 


4b . 
Ae - 


e SQL 人 允许 你 为 "old" 和 "new" 行 或 者 表 定 义 别名 ， 用 于 定义 触发 器 的 动作 (也 就 
是 CREATE TRIGGER ... ON tablename REFERENCING OLD ROW AS somename NEW ROW AS othername 
)。 因为 PostgreSQL 允许 触发 器 过 程 以 任意 数量 的 用 户 定义 语言 进行 书写 ， 所 以 访问 数 
据 的 工作 是 用 和 语言 相关 的 方法 实现 的 。 


e PostgreSQL 不 允许 旧 的 和 新 的 表 在 语句 级 别 的 触发 器 中 引用 ， 也 就 是 ， 包 含 所 有 旧 的 
和 /或 新 的 行 的 表 ， 在 SQL 标准 中 被 oLp TABLE 和 new TABLE 子 句 提 及 。 


e PostgreSQL 只 允许 为 触发 的 动作 执行 用 户 定义 的 范 数 。 SQL 标准 允许 执行 一 些 其 它 的 
命令 ， 比 如 拿 create TABLE 作为 触发 器 动作 。 这 个 限 止 并 不 难 绕 开 ， 只 要 创建 一 个 执行 
这 些 命令 的 用 户 定义 的 函数 即 可 。 


SQL 要 求 多 个 触发 器 应 该 以 创建 的 时 间 顺 序 执行 。 PostgreSQL 采 用 的 是 按照 名 字 顺 序 ， 并 
认为 这 样 更 加 方便 。 


SQL 要 求 必须 在 级 联 DELETE 完成 之 后 再 触发 级 联 删 除 上 的 ”BEFORE DELETE 触发 器 。 
PostgreSQL 的 行为 是 BEFORE DELETE 将 永远 在 删除 动作 之 前 触发 ， 即使 对 于 级 联 删 除 也 是 如 
此 ， 我 们 认为 这 样 更 一 致 。 如 果 BEFoRE 触发 器 在 由 引用 操作 引起 的 更 新 期 间 修改 行 或 阻止 更 
新 ， 仍 然 存在 不 标准 的 行为 。 这 将 导致 违反 约束 或 者 存储 不 符合 参照 完整 性 的 数据 。 


用 or 给 一 个 触发 器 声明 多 个 动作 是 PostgreSQL 对 SQL 标准 的 扩展 。 


触发 触发 器 TRUNCATE 的 能 力 是 一 个 PostgreSQL 对 SQL 标准 的 扩展 ， 就 像 在 视图 上 定义 语句 
级 别 触发 器 的 能 


CREATE CONSTRAINT TRIGGER 是 一 个 PostgreSQL 对 SQL 标准 的 扩展 。 


义 见 


ALTER TRIGGER, DROP TRIGGER, CREATE FUNCTION, SET CONSTRAINTS 


CREATE TYPE 


Name 
CREATE TYPE -- 定义 一 个 新 数据 类 型 
Synopsis 


CREATE TYPE _name_ AS 
( [ _attribute_name data_type_ [ COLLATE _collation_] [, ... ] ] ) 





CREATE TYPE _name_ AS ENUM 
(li Lad el lip Shee J) Ip 3} 


CREATE TYPE _name_ AS RANGE ( 
SUBTYPE = _subtype_ 
[ , SUBTYPE_OPCLASS = _subtype_operator_class_ ] 
[ , COLLATION = _collation_ ] 
[ , CANONICAL = _canonical_function_ ] 
[ , SUBTYPE_DIFF = _subtype_diff_function_ ] 
) 


CREATE TYPE _name_ ( 

INPUT = _input_function_, 

OUTPUT = _output_function_ 
, RECEIVE = _receive_function_ ] 
, SEND = _send_function_ ] 
, TYPMOD_IN = _type_modifier_input_function_ ] 
, TYPMOD_OUT = _type_modifier_output_function_ ] 
, ANALYZE = _analyze_function_ ] 
, INTERNALLENGTH = { _internallength_ | VARIABLE } ] 
, PASSEDBYVALUE ] 
, ALIGNMENT = _alignment_ ] 
, STORAGE = _storage_ ] 
, LIKE = _like_type_ ] 
, CATEGORY = _category_ ] 
, PREFERRED = _preferred_ ] 
, DEFAULT = _default_ ] 
, ELEMENT = _element_ ] 
, DELIMITER = _delimiter_ ] 
, COLLATABLE = _collatable_ ] 


aM MO IM I gd aean md, 


) 


CREATE TYPE _name_ 


摘 述 
CREATE TYPE 为 当前 数据 库 注 册 一 个 新 的 数据 类 型 。 定义 该 类 型 的 用 户 成 为 其 所 有 者 。 


如 果 给 出 模式 名 ， 那 么 该 类 型 是 在 指定 模式 中 创建 。 否 则 它 将 在 当前 模式 中 创建 。 类 型 名 必 
需 和 同一 模式 中 任何 现 有 的 类 型 或 者 域 不 同 。 (因为 表 和 数据 类 型 有 联系 ， 所 以 类 型 名 也 不 
能 和 同 模式 中 的 表 名 字 冲 突 。) 


有 5 种 形式 的 cREATE TYPE ， 显 示 在 上 面 的 语法 摘要 里 。 他 们 分 别 创建 复合 类 型 、 枚 举 类 型 、 
范围 类 型 、 基 本 类 型 或 壳 类 型 。 前 四 个 在 下 面 依次 讨论 。 壳 类 型 是 简单 的 一 个 稍 后 定义 的 类 
型 的 占 位 符 ; 通过 发 出 没有 参数 只 有 类 型 名 的 create TYPE 创建 。 当 创建 范围 类 型 和 基本 类 
型 时 ， 亮 类 型 作为 向 前 引用 需要 ， 在 下 面 章节 中 讨论 。 


复合 


CREATE TYPE 的 第 一 种 形式 创建 一 个 复合 类 型 。 复合 类 型 是 通过 一 列 属性 名 和 数据 类 型 声明 
的 。 如 果 它 的 数据 类 型 可 排序 ， 那么 也 可 以 指定 属性 的 排序 。 复 合 类 型 本 质 上 和 一 个 表 的 行 
类 型 一 样 ， 但 是 如 果 只 是 想 定义 一 个 类 型 ， 那 么 使 用 create TYPE 就 可 以 避免 直接 创建 实际 
的 表 。 一 个 独立 的 复合 类 型 是 有 用 的 ， 例 如 ， 做 为 一 个 画 数 的 参数 或 者 返回 类 型 。 


:型 


P 


要 想 能 够 创建 一 个 复合 类 型 ， 必 须 在 所 有 的 属性 类 型 上 有 usAGE 权限 。 


枚 举 关 弄 


CREATE TYPE 的 第 二 种 形式 创建 一 个 枚 举 (enum) 类 型 ， 在 Section 8.7 中 描述 。 枚 举 类 型 接 
受 一 个 或 更 多 的 引用 标签 的 列表 ， 每 个 标签 必须 小 于 NAMEDATALEN 字 节 长 度 (在 标准 的 
PostgreSQL 建 立 中 是 64 字 节 ) 。 


范围 类 型 
CREATE TYPE 的 第 三 种 形式 创建 一 个 新 的 范围 类 型 ， 在 Section 8.17 中 描述 。 


范围 类 型 的 _subtype ”可 以 是 有 一 个 相关 的 b-tree 操 作 符 类 (决定 范围 类 型 值 的 顺序 ) 的 任意 
类 型 。 通常 子 类 型 的 缺 省 b-tree 操 作 符 类 用 于 决定 顺序 ; 要 使 用 一 个 非 缺 省 的 操作 符 类 ， 

用 _subtype_opclass_ 指定 它 的 名 字 。 如 果子 类 型 是 可 排序 的 ， 并 且 你 希望 在 范围 的 排序 中 使 
用 非 缺 省 的 排序 ， 那么 使 用 _collation ”选项 指定 想 要 的 排序 。 


可 选 的 _canonical ”图 数 必须 接受 一 个 被 定义 的 范围 类 型 的 参数 ， 并 且 返 回 相 同类 型 的 值 。 

适用 时 ， 这 用 于 转换 范围 类 型 到 标准 形式 。 参 阅 Section 8.17.8 获取 更 多 信息 。 创 建 一 

个 _canonical ”加 数 比较 棘手 ， 因 为 它 必 须 在 范围 类 型 可 以 被 声明 之 前 定义 。 要 做 到 这 点 ， 

必须 先 创 建 一 个 壳 类 型 ， 壳 类 型 是 一 个 除了 名 字 和 所 有 者 之 外 没有 其 他 属性 的 占 位 符 类 型 。 

这 可 以 通过 发 出 没有 其 他 额外 参数 的 cREATE TYPE _name_ 命令 来 完成 。 然后 可 以 使 用 该 壳 
类 型 作为 参数 和 结果 声明 该 男 数 ， 最 后 可 以 使 用 相同 的 名 字 声 明 范 围 类 型 。 这 将 自动 使 用 有 
效 的 范围 类 型 蔡 代 壳 类 型 条 目 。 


可 选 的 _subtype_ditf_ HAUAS AD subtype 类 型 的 值 作为 参数 ， 并 且 返 回 双 精度 值 
表示 两 个 给 定 值 之 间 的 不 同 。 虽然 这 是 可 选 的， 但 是 提供 它 允 许 GiST 索 引 在 范围 类 型 字段 上 
有 更 大 的 效率 。 参阅 Section 8.17.8 获 取 更 多 信息 。 


基本 类 型 


CREATE TYPE 的 第 四 种 形式 创建 一 个 新 的 基本 类 型 (标量 类 型 )。 要 创建 一 个 新 的 基本 类 型 ， 你 
必须 是 一 个 超级 用 户 。 做 这 个 限制 是 因为 一 个 错误 的 类 型 定义 会 混淆 或 者 甚至 崩溃 服务 
器 。 ) 


参数 可 以 按 任意 顺序 出 现 ， 而 不 是 上 面 显示 的 那样 ， 并 且 大 多 数 都 是 可 选 的 。 必须 在 定义 类 
型 之 前 先 用 CREATE FUNCTION 注册 两 个 或 更 多 个 函数 。 SEER _input_function_ 

和 _output_function_ 是 必须 的 ， 而 函数 _receive_function_ 、 _send_function_ «s 
_type_modifier_input_function_ s _type_modifier_output_function_ 


和 _analyze_function. 是 可 选 的 。 通常 ， 这 些 画 数 必须 用 C 或 者 其 它 低 层 语 言 编 写 


_input_function_ 图 数 将 该 类 型 的 外 部 文本 形式 转换 成 可 以 被 该 类 型 的 操作 符 和 图 数 识别 的 
内 部 形式 。 _output_function_ 用 途 相 反 。 输入 加 数 可 以 声明 为 接受 一 个 类 型 为 cstring 的 
BH, 或 者 接受 三 个 类 型 分 别 为 cstring 、 oid, integer 的 参数 。 第 一 个 参数 是 C 字符 
串 形式 的 输入 文本 ， 第 二 个 参数 是 该 类 型 自身 的 OID( 数 组 类 型 除外 ， 这 种 情况 下 它们 接受 自 
身 元 素 的 类 型 OID)， 第 三 个 是 目标 字段 的 typmod (如 果 未 知 则 传递 -1)。 输入 画 数 必须 返回 
一 个 自身 数据 类 型 的 值 。 通 常 ， 输 入 画 数 应 当 被 声明 为 STRICT, 否则 当 读 取 NULL 输入 时 
将 被 使 用 第 一 个 参数 为 NULL 进行 调用 ， 并 且 必 须 仍 然 返回 NULL 或 报错 。 (这 个 特性 主要 
是 为 了 支持 域 输入 函数 ， 这 种 函数 可 能 需要 拒绝 NULL 输入 。) 输出 函数 必须 被 声明 为 接受 
一 个 新 数据 类 型 的 参数 ， 并 且 必 须 返 回 cstring 类 型 。 输 出 函数 不 会 被 使 用 NULL 调用 。 


可 选 的 _receive_function ”把 该 类 型 的 外 部 二 进 制 表现 形式 转换 成 内 部 表现 形式 。 如 果 没 有 
提供 这 个 画 数 ， 那么 该 类 型 不 能 用 二 进 制 输 入 。 二 进 制 格式 应 该 选取 那 种 比较 容易 转换 同时 
还 有 一 定 移植 性 的 内 部 格式 。 上 比如 ， 标 准 的 整数 数据 类 型 使 用 网 络 字 节 序 作为 外 部 的 二 进 制 
表现 形式 ， 而 内 部 表现 形式 则 是 机 器 的 本 机 字 节 序 。 例 如 ， 接收 酚 数 应 该 声明 为 接受 一 个 类 
型 为 internal 的 参数 ， 或 者 是 三 个 类 型 分 别 为 internal, oid, integer 的 参数 。 第 一 个 
参数 是 一 个 指向 一 个 stringInfo 缓冲 区 的 、 保 存 接受 字 节 串 的 指针 ; 可 选 的 参数 和 文本 输入 
函数 一 样 。 接收 画 数 必须 返回 一 个 该 类 型 的 数据 值 。 通 常 接收 画 数 应 当 被 声明 为 STRICT, 

否则 否则 当 读 取 NULL 输入 时 将 被 使 用 第 一 个 参数 为 NULL 进行 调用 ， 并 且 必 须 仍然 返回 

NULL 或 报错 。 这 个 特性 主要 是 为 了 支持 域 接收 西数 ， 这 种 函数 可 能 需要 拒绝 NULL 输入 。 

同样 ， 可 选 的 _send_function ”把 类 型 的 内 部 表现 形式 转换 为 外 部 二 进 制 表现 形式 。 如 果 没 
有 提供 这 些 函 数 ， 那么 类 型 就 不 能 用 二 进 制 方式 输出 。 发 送 图 数 必须 声明 为 接收 一 个 新 数据 
类 型 并 且 必 须 返 回 bytea 结果 。 发 送 图 数 不 会 被 以 NULL 值 调用 。 


这 个 时 候 你 应 该 觉得 奇怪 ， 输 入 和 输出 画 数 怎么 可 以 声明 为 返回 新 类 型 的 结果 或 者 是 接受 新 
类 型 的 参数 ， 而 且 是 在 新 类 型 创建 之 前 就 需要 创建 它们 。 答 案 是 类 型 必须 被 首先 定义 为 一 个 
RZE, 它 只 是 一 个 除了 名 称 和 属 主 之 外 没有 其 他 属性 的 占 位 符 类 型 。 这 可 以 通过 没有 其 他 
额外 参数 的 CREATE TYPE _name_ 命令 来 完成 。 然后 就 可 以 引用 该 壳 类 型 定义 输入 输出 函 
数 。 最 后 ， cREATE TYPE 把 这 个 这 类 型 替换 成 完整 的 、 有 效 的 类 型 定义 ， 这 样 就 可 以 使 用 新 
类 型 了 。 

如 果 支 持 类 型 修饰 符 ， 那么 可 选 的 _type_modifier_input_function_ 


和 _type_modifier_output_function ”是 需要 的 ， 这 是 附属 于 类 型 声明 的 可 选 的 约束 ， 
如 char(5) 和 numeric(30,2) 。PostgreSQL 人 允许 用 户 定义 的 类 型 接受 一 个 或 多 个 简单 的 约束 


或 标识 符 作 为 修饰 符 。 不 过 ， 这 个 信息 必须 能 够 装 进 一 个 非 负 的 整 型 值 里 ， 以 在 系统 表 中 存 
žo _type_modifier_input_function ”以 cstring 数组 的 形式 传送 声明 的 修饰 符 。 它 必须 检 
查 值 的 有 效 性 〈 如 果 值 是 错误 的 则 抛 出 一 个 错误 ) ， 如 果 是 正确 的 ， 则 返回 一 个 非 负 的 
integer 值 ， 该 值 将 被 作为 字段 "typmod" 存 储 。 如 果 类 型 没有 
_type_modifier_input_function_ , 那么 类 型 修饰 符 将 被 拒 

绝 。 _type_modifier_output_function 转换 内 部 的 整数 typmod 值 为 用 户 显示 的 正确 形式 。 它 
必须 返回 一 个 cstring 值 ， 该 值 是 附加 到 类 型 名 之 后 的 准确 的 字符 串 ; 如 numeric 的 函数 返 
回 (30,2) o 允许 省 上 略 _type_modifier_output_function_ , 省 略 的 情况 下 ， 缺 省 显示 形式 是 
只 有 存储 的 typmod 整 型 值 包含 在 圆 插 号 中 。 


可 选 的 _analyze_function_ 为 该 数据 类 型 的 字段 执行 与 该 类 型 相关 的 统计 信息 收集 。 me 
时 ， 如 果 该 类 型 有 个 缺 省 的 B-tree 操作 符 类 ， 那 么 ANALYzE 将 尝试 使 用 该 类 型 的 "等 于 "和 "小 
于 "操作 符 收集 信息 。 对 于 非 标 量 类 型 ， 这 种 行为 很 可 能 不 合适 ， 因 此 可 以 通过 提供 一 个 自 定 
LAD RMBE EC. 分 析 男 数 必 须 声 明 为 接收 单独 一 个 internal 类 型 的 参数 ， 并 且 返 回 
一 个 boolean 结果 。 分 析 函 数 的 详细 API 在 src/include/commands/vacuum.h Œ. 


尽管 新 类 型 的 内 部 表现 形式 只 有 输入 输出 函数 和 其 它 你 创建 来 使 用 该 类 型 的 函数 了 解 ， 但 内 
部 表现 形式 还 是 有 几 个 属性 必须 为 PostgreSQL 声 明 。 _internallength 是 最 重要 的 一 个 。 
基本 数据 类 型 可 定义 成 为 定 长 ， 这 时 _internallength_ 是 一 个 正 整 数 ， 也 可 以 是 变 长 的 ， 通 
过 把 _internallength. 34 X VARIABLE 表示 。 (在 内 部 ， 这 个 状态 是 通过 将 typlen 设置 为 -1 
实现 的 。) 所 有 变 长 类 型 的 内 部 形式 都 必须 以 一 个 四 字 节 整数 开头 ， 这 个 整数 给 出 此 类 型 这 个 
数值 的 全 长 。 


可 选 的 标记 PASSEDBYVALUE 表明 该 类 型 的 数值 是 按 值 而 不 是 引用 传递 。 你 不 能 传递 那些 内 部 
形式 大 于 patum 类 型 尺寸 (大 多 数 机 器 上 是 4 SH, 有 些 是 8 字 节 ) 的 数据 类 型 的 值 。 


_alignment_ 参数 声明 该 数据 类 型 要 求 的 对 齐 存 储 方式 。 人 允许 的 数值 等 效 于 按照 1, 2, 4, 8 F 
节 边 界 对 齐 。 请 注意 变 长 类 型 必须 有 至 少 4 字 节 的 对 齐 ， 因为 它们 必须 包含 一 个 inta 作为 
第 一 个 部 分 。 


_storage。 参数 允许 为 变 长 数据 类 型 选择 存储 策略 ( 定 长 类 型 只 人 允许 使 用 plain). plain = 
明 该 数据 类 型 总 是 用 内 联 的 方式 而 不 是 压缩 的 方式 存储 。 extended 声明 系统 将 首先 试图 压缩 
一 个 长 的 数据 值 ， 然后 如 果 它 仍然 太 长 的 话 就 将 它 的 值 移出 主 表 ， 但 系统 将 不 会 压缩 它 。 
external 声明 禁止 系统 进行 压缩 并 且 人 允许 将 它 的 值 移出 主 表 。 main DHAR, BETH 
把 数值 移动 出 主 表 (如 果实 在 不 能 放 在 一 行 里 的 话 ， 仍 将 移动 出 主 表 ， 它 

比 extended 和 external 项 更 愿意 保存 在 主 表 里 )。 


_like_type 参数 为 指定 数据 类 型 的 基本 代表 属性 提供 一 个 可 选 的 方式 : 从 某 些 现 有 的 类 型 
中 撕 贝 他 们 。 _internallength 、 _passedbyvalue 、 _alignment 和 _storage_ 的 值 从 命 
名 的 类 型 中 拷贝 。 (这 是 可 能 的 ， 尽 管 通常 不 需要 ， 通 过 和 LIKE 子 句 一 起 指定 他 们 ， KE 
盖 一 些 这 些 值 。) 这 种 方式 指定 代表 ， 在 新 类 型 "piggybacks" 的 低级 实现 以 某 种 方式 在 现 有 
类 型 上 时 尤其 有 用 。 


_category_ 和 _preferred ”参数 可 以 用 于 帮助 控制 哪个 隐 式 转换 将 被 用 于 模糊 的 情况 。 每 
个 数据 类 型 都 属于 一 个 由 单个 ASCII 字 符 命 名 的 类 ， 并 且 每 个 类 型 不 是 "preferred" 就 是 不 在 它 
的 类 中 。 当 这 个 规则 对 于 解析 重 载 本 数 或 操作 符 有 帮助 时 ， 解析 器 更 愿意 转换 为 优先 的 类 型 
(但 是 只 限于 来 自 不 在 相同 类 中 的 其 他 类 型 ) 。 更 多 信息 请 参阅 Chapter 10。 对 于 没有 隐 式 
转换 到 或 来 自任 意 其 他 类 型 的 类 型 ， 保留 这 些 设置 作为 缺 省 就 足够 了 。 不 过 ， 对 于 有 隐 式 转 
换 的 的 相关 类 型 的 组 ， 通常 标记 他 们 都 属于 一 个 类 并 且 在 该 类 中 选取 一 个 或 两 个 "最 一 般 " 的 
类 型 作为 优先 是 有 帮助 的 。 当 添加 一 个 用 户 定义 的 类 型 到 一 个 现 有 的 内 建 类 时 ， 

_category 参数 尤 其 有 用 ， 如 数值 型 或 字符 串 类 型 。 但 是 ， 也 有 可 能 创建 新 的 完全 用 户 定义 
的 类 型 类 别 。 选取 任意 ASCII 字 符 而 不 是 一 个 大 写 的 字母 来 命名 这 样 一 个 类 别 。 


如 果 用 户 希 望 字段 的 数据 类 型 缺 省 时 不 是 NULL ， 那 么 可 以 在 DEFAULT 关键 字 里 声 明 一 个 缺 
省 值 (可 以 被 附着 在 特定 字段 上 的 peFAULT 子 句 覆盖 )。 


用 ELEMENT 关键 字 声 明 数 组 元 素 的 类 型 。 比如 ， ELEMENT = int4 定义 了 一 个 4 字 节 整数 
( int4 ) 的 数组 。 有 关 数 组 类 型 的 更 多 细节 在 下 面 描述 。 


可 用 delimiter, 指定 用 于 这 种 类 型 数组 的 外 部 形式 的 数值 之 间 的 分 隔 符 。 缺 省 的 分 隔 符 是 
25(,) 请 注意 分 隔 符 是 和 数组 元 素 类 型 相关 联 ， 而 不 是 数组 类 型 本 身 。 


如 果 可 选 的 布尔 参数 _collatable AB, 那么 该 类 型 的 字段 定义 和 表达 式 可 以 通过 使 
用 coLLATE 子 句 携带 排序 信息 。 取 决 于 在 该 类 型 上 画 数 操 作 符 的 实现 ， 以 实际 上 利用 排序 信 
AB; 仅仅 通过 标记 该 类 型 可 排序 ， 这 就 不 会 自动 发 生 。 


数组 类 型 


在 创建 用 户 定义 类 型 的 时 候 ，PostgreSQL 自动 创建 一 个 与 之 关联 的 数组 类 型 ， 其 名 字 由 该 元 
素 类 型 的 名 字 前 级 一 个 下 划 线 组 成 ， 并 且 如 果 有 必要 保持 它 小 于 NAMEDATALEN 字 节 长 度 时 截 
断 。 如果 这 样 生 成 的 名 字 与 一 个 现 有 的 类 型 名 冲突 ， 那 么 重复 该 进程 ， 知道 找到 一 个 不 冲 
突 的 名 字 。) 这 个 隐 含 创建 的 数组 类 型 是 变 长 并 且 使 用 内 建 的 array_in 和 array_out 输入 和 
EH, 数组 类 型 追踪 它 的 元 素 类 型 的 所 有 者 或 模式 的 任意 更 改 ， 并 且 如 果 元 素 类 型 有 更 
改 时 删除 。 


你 很 可 能 会 问 如 果 系 统 自动 制作 正确 的 数组 类 型 ， 那 为 什么 还 要 有 个 ELEMENT 选项 ? 使 
用 ELEMENT 的 场合 有 一 : 你 定义 的 定 长 类 型 碰巧 在 内 部 是 一 个 一 定数 目 相 同事 物 的 数组 ， 而 
你 又 想 人 允许 这 N 个 事物 可 以 通过 下 标 直 接 访问 ， 除 了 某 些 操作 符 将 把 该 类 型 当做 整体 进行 处 
理 。 比如 ， 类 型 point 表示 为 两 个 浮 点 数 ， 每 个 可 以 用 point[6] 和 point[1] 访问 。 请 注意 
这 个 功能 只 适用 于 定 长 类 型 ， 并 且 其 内 部 形式 是 一 个 相同 定 长 域 的 序列 。 一 个 可 以 下 标 化 的 
变 长 类 型 必须 有 被 array_in 和 array_out 使 用 的 一 般 化 的 内 部 表现 形式 。 出 于 历史 原因 
(也 就 是 ， 这 是 明显 错误 的 ， 但 是 要 改变 它 却 太 晚 了 ) ， 定 长 数组 类 型 的 下 标 从 0 开始 ， 而 
不 是 像 变 长 数组 那样 的 从 1 开始 。 


参数 


将 要 创建 的 类 型 名 (可 以 有 模式 修饰 ) 

_attribute_name_ 

复合 类 型 的 一 个 属性 (字段 ) 的 名 字 

_data_type_ 

要 成 为 一 个 复合 类 型 的 字段 的 现 有 数据 类 型 的 名 字 

_collation_ 

与 复合 类 型 或 范围 类 型 字段 有 关 的 现 有 排序 的 名 字 

_label_ 

表示 与 枚 举 类 型 的 值 有 关 的 文本 标签 的 字符 串 字 面值 

_subtype_ 

元 素 类 型 的 名 字 ， 范 围 类 型 将 代表 的 范围 
_subtype_operator_class_ 

该 子 类 型 的 b-tree 操 作 符 类 的 名 字 

_canonical_function_ 

范围 类 型 的 标准 化 图 数 的 名 字 

_subtype_diff_function_ 

子 类 型 的 差异 函数 的 名 字 

_input_function_ 

一 个 函数 的 名 称 ， 将 数据 从 外 部 文本 形式 转换 成 内 部 格式 。 
_output_function_ 

一 个 画 数 的 名 称 ， 将 数据 从 内 部 格式 转换 成 适 于 显示 的 外 部 文本 形式 。 
_receive_function_ 

一 个 函数 的 名 称 ， 把 数据 从 类 型 的 外 部 二 进 制 形式 转换 成 内 部 形式 
_send_function_ 

一 个 函数 的 名 称 ， 把 数据 从 类 型 的 内 部 形式 转换 成 外 部 二 进 制 形式 
_type_modifier_input_function_ 

一 个 范 数 的 名 称 ， 把 修饰 符 的 数组 类 型 转换 成 内 部 形式 


_type_modifier_output_function_ 


一 个 函数 的 名 称 ， 把 类 型 的 修饰 符 的 内 部 形式 转换 成 外 部 形式 
_analyze_function_ 

ABA FE BUT Kit DHT HAA 

_internallength_ 

一 个 数值 常量 ， 说 明 新 类 型 的 内 部 表现 形式 的 字 节 长 度 。 人 缺 省 假定 它 是 变 长 的 。 


_alignment_ 


该 数据 类 型 的 存储 对 齐 要 求 。 如 果 声 明了 ， 必 须 是 char, int2 、 int4 (HRA), double 之 


_storage_ 

该 数据 类 型 的 存储 策略 。 如 果 声 明了 ， 必 须 是 plain ( 缺 省 )、 

external 、 extended, main 之 一 。 

_like_type_ 

与 新 类 型 将 要 有 的 表现 相同 的 现 有 数据 类 型 的 名 字 。 _internallength_ , 


_passedbyvalue_, _alignment 、 _storage 的 值 是 从 该 类 型 中 拷贝 的 ， 除非 
在 CREATE TYPE 命令 中 明确 的 说 明 履 写 。 


_category_ 


这 个 类 型 的 类 别 代码 〈 单 个 ASCII 字 符 ) 。" 用 户 定义 类 型 " 却 省 是 'u! 。 其 他 标准 类 别 代码 可 
以 在 Table 47-52 中 找到 。 你 也 可 以 选择 其 他 ASCII 字 符 来 创建 自 定义 类 别 。 


_preferred_ 


如 果 这 个 类 型 在 它 的 类 型 类 别 中 是 首选 类 型 则 为 真 ， 否 则 为 假 。 缺 省 是 假 。 在 一 个 现 有 的 类 
型 类 别 中 创建 一 个 新 的 首选 类 型 时 要 非常 小 心 ， 因为 这 会 导致 行为 上 意外 的 变化 。 


_default_ 
该 类 型 的 缺 省 值 。 若 省 略 则 为 NULL 
_element_ 
被 创建 的 类 型 是 数组 ; 这 个 声明 数组 元 素 的 类 型 。 
_delimiter_ 
数组 元 素 之 间 分 隔 符 
_collatable_ 


如 果 这 个 类 型 的 操作 可 以 使 用 排序 信息 则 为 真 。 缺 省 为 假 。 


因为 一 旦 类 型 被 创建 之 后 对 它 的 使 用 就 没有 限制 ， 所 以 创建 一 个 基本 类 型 或 范围 类 型 就 等 价 
于 授予 所 有 用 户 执 行 类 型 定义 中 指定 的 各 个 画 数 的 权限 ， 这 对 于 大 多 数 类 型 定义 中 指定 的 函 
数 来 说 不 会 造成 什么 不 良 问题 。 但 是 如 果 你 设计 的 新 类 型 在 内 部 形式 和 外 部 形式 之 间 转 换 的 
时 候 使 用 "敏感 信息 "， 那么 你 仍然 要 再 三 考虑 、 多 加 小 心 。 


PostgreSQL 版 本 8.3 之 前 ， 生成 的 数组 类 型 的 名 字 总 是 正好 是 元 素 类 型 的 名 字 前 置 一 个 下 划 
线 字 符 ( _ )。 (因此 限制 类 型 名 字 的 长 度 比 其 他 名 字 的 字符 要 少 。) 虽然 这 仍然 是 通常 的 情 
况 ， 但 是 数组 类 型 名 字 可 能 会 有 变化 ， 假 使 最 大 长 度 名 字 或 与 下 划 线 开始 的 用 户 类 型 名 字 冲 
2, 依赖 于 这 个 约定 的 书写 代码 因此 奔 用 了 了。 取而代之， 使 用 pg_type . typarray 来 定位 与 
一 个 给 定 类 型 相关 的 数组 类 型 。 


避免 使 用 以 下 划 线 开始 的 类 型 和 表 名 是 明智 的 。 虽然 服务 器 将 改变 生成 的 数组 类 型 名 ， 以 避 
免 与 用 户 给 定 的 名 字 冲 突 ， 但 是 仍然 有 混淆 的 更 显 ， 尤其 是 老 的 客户 端 软件 可 能 假设 以 下 划 
线 开始 的 类 型 名 总 是 代表 数组 。 


PostgreSQL 版 本 8.2 之 前 ， 这 类 型 创建 语法 CREATE TYPE _name 并 不 存在 。 创建 新 的 基本 
类 型 之 前 必须 首先 创建 其 输入 函数 。 这 样 ，PostgreSQL 将 会 首先 把 新 类 型 的 名 字 看 作 输 入 画 
数 的 返回 类 型 并 隐 含 创建 达 类 型 ， 然后 这 个 壳 类 型 将 被 随后 定义 的 输入 输出 函数 引用 。 这 种 
老式 的 方法 目前 仍然 被 支持 ， 但 已 经 反对 使 用 ， 将 来 可 能 不 再 支持 。 同 样 ， 为 了 避免 画 数 定 
义 中 的 临时 过 类 型 偶然 地 搞 乱 系统 表 ， 当 输 入 男 数 用 C 语言 书写 时 ， 将 只 能 用 这 种 方法 创建 
壳 类 型 。 


在 PostgreSQL 7.3 以 前 ， 要 通过 使 用 占 位 伪 类 型 opaque 代 蔡 函数 的 前 向 引用 来 避免 创建 壳 
类 型 。7.3 之 前 cstring 参数 和 结果 同样 需要 声明 为 opaque 。 要 支持 加 载 旧 的 转 储 文件 ， 
CREATE TYPE 将 接受 那些 用 opaque 声明 的 输入 输出 函数 ， 但 是 它 将 发 出 一 条 通知 并 且 用 正确 
的 类 型 改变 函数 的 声明 。 


例子 
这 个 例子 创建 一 个 复合 类 型 并 且 在 一 个 函数 定义 中 使 用 它 : 


CREATE TYPE compfoo AS (f1 int, f2 text); 


CREATE FUNCTION getfoo() RETURNS SETOF compfoo AS $$ 
SELECT fooid, fooname FROM foo 
$$ LANGUAGE SQL; 


这 个 命令 创建 枚 举 类 型 ， 并 且 将 它 用 于 一 个 表 定 义 : 


CREATE TYPE bug_status AS ENUM ('new', 'open', 'closed'); 


CREATE TABLE bug ( 
id serial, 
description text, 
status bug_status 


Ne 


这 个 例子 创建 一 个 范围 类 型 : 


CREATE TYPE float8_range AS RANGE (subtype = floats, 


这 


CREATE TYPE box; 


CREATE FUNCTION my_box_in_function(cstring) RETURNS box AS ... 
CREATE FUNCTION my_box_out_function(box) RETURNS cstring AS ... 


CREATE TYPE box ( 
INTERNALLENGTH = 16, 
INPUT = my_box_in_function, 
OUTPUT = my_box_out_function 
); 


CREATE TABLE myboxes ( 
id integer, 
description box 


Ne 


subtype_diff = 


float8mi); 


个 命令 创建 box 基本 数据 类 型 ， 并 且 将 这 种 类 型 用 于 一 个 表 定 义 : 


i 


如 果 box 的 内 部 结构 是 一 个 四 个 float4 的 数组 ， 可 以 使 用 : 


CREATE TYPE box ( 
INTERNALLENGTH = 16, 
INPUT = my_box_in_function, 
OUTPUT = my_box_out_function, 
ELEMENT = float4 


Ne 


来 允许 一 个 box 的 数值 成 分 成 员 可 以 用 下 标 访问 。 否 则 该 类 
这 条 命令 创建 一 个 大 对 象 类 型 并 将 其 用 于 一 个 表 定 义 : 
CREATE TYPE bigobj ( 

INPUT = lo_filein, OUTPUT = lo_fileout, 


INTERNALLENGTH = VARIABLE 
); 
CREATE TABLE big_objs ( 

id integer, 

obj bigobj 


); 


型 和 前 面 的 行为 一 样 。 


更 多 的 例子 ， 包 括 合适 的 输入 和 输出 函数， 位 于 Section 35.11。 


兼容 性 


CREATE TYPE 命 命 的 第 一 种 形式 ， 创 建 一 
PostgreSQL 的 扩展 。SQL 标 准 中 的 CREATE TYPE 
其 他 形式 。 


合 类 型 ， 符合 SQL 标 准 。 


其 他 形式 是 


语句 也 定义 了 没有 在 PostgreSQL 中 实 


见 的 


用 0 属性 创建 一 个 复合 类 型 的 能 力 是 PostgreSQL 与 标准 具体 的 偏差 (类似 于 create TABLE 中 
的 相同 情况 ) o 


义 见 


ALTER TYPE, CREATE DOMAIN, CREATE FUNCTION, DROP TYPE 


CREATE USER 


Name 


CREATE USER -- 定义 一 个 新 数据 库 角 色 


Synopsis 


CREATE USER _name_ [ [ WITH ] _option_[... ] ] 
这 里 的 option “可 以 是 : 


SUPERUSER | NOSUPERUSER 

| CREATEDB | NOCREATEDB 

| CREATEROLE | NOCREATEROLE 

| CREATEUSER | NOCREATEUSER 

| INHERIT | NOINHERIT 

| LOGIN | NOLOGIN 

| REPLICATION | NOREPLICATION 
| CONNECTION LIMIT _connlimit_ 
| [ ENCRYPTED | UNENCRYPTED ] PASSWORD '_password_' 
| VALID UNTIL '_timestamp_' 

| IN ROLE _role_name_ [, ...] 

| IN GROUP _role_name_ [, ...] 
| ROLE _role_name_ [, ...] 

| ADMIN _role_name_ [, ...] 

| USER _role_name_ [, ...] 

| SYSID _uid_ 


CREATE USER 现在 是 CREATE ROLE 的 别名 。 唯一 的 区 别 是 CREATE USER 命令 缺 省 假设 
有 LOGIN, 而 CREATE ROLE 缺 省 是 NoLoGIN o 


兼容 性 


CREATE USER 语句 是 PostgreSQL 扩 展 。 SQL 标准 把 用 户 的 定义 交 给 了 实现 来 完成 。 


XIL 


CREATE ROLE 


CREATE USER MAPPING 


Name 


CREATE USER MAPPING -- 定义 一 个 新 的 用 户 到 外 部 服务 器 的 映射 


Synopsis 


CREATE USER MAPPING FOR { _user_name_ | USER | CURRENT_USER | PUBLIC } 
SERVER _server_name_ 
[ OPTIONS ( _option_ '_value_'[, ... ] ) ] 





摘 述 
CREATE USER MAPPING 定义 了 一 个 用 户 到 外 部 服务 器 的 映射 。 一 个 用 户 映 射 通常 封装 连接 信 
息 ， 外 部 数据 封装 器 与 外 部 服务 器 封装 的 信息 一 起 使 用 来 访问 外 部 数据 资源 。 


外 部 服务 器 的 所 有 者 可 以 为 任意 用 户 创建 服务 器 的 用 户 映射 。 另 外 ， 如 果 服 务 器 上 
的 usAGE 权限 已 经 授予 一 个 用 户 ， 那么 该 用 户 可 以 为 其 自身 用 户 名 创建 一 个 用 户 映射 ，。 


参数 


_user_name_ 


映射 到 外 部 服务 器 的 现 有 用 户 的 名 称 。 cuRRENT_UsER 和 user 匹配 当前 用 户 的 名 称 。 当 指 
E pusLic 时 ， 一 个 所 谓 的 公共 映射 就 创建 了 ， 当 没 有 特定 用 户 的 映射 适用 时 就 会 使 用 该 映 
射 。 


一 个 现 有 服务 器 的 名 称 ， 用 户 映射 就 是 为 其 创建 的 。 


OPTIONS ( _option_ ' value_'[,...]) 





该 子 句 声明 用 户 映射 的 选项 。 该 选项 通常 定义 映射 的 实际 用 户 名 和 密码 。 选项 名 称 必须 是 唯 
一 的 。 人 允许 的 选项 名 和 值 特定 于 服务 器 的 外 部 数据 封装 器 。 


例子 


为 用 户 bob ， 服 务 器 foo 创建 一 个 用 户 映 射 : 


CREATE USER MAPPING FOR bob SERVER foo OPTIONS (user 'bob', password 'secret'); 


RANE 


CREATE USER MAPPING 遵循 ISO/IEC 9075-9 (SQL/MED). 


XI 


ALTER USER MAPPING, DROP USER MAPPING, CREATE FOREIGN DATA WRAPPER, 
CREATE SERVER 


CREATE VIEW 


Name 


CREATE VIEW -- 定义 一 个 新 视图 


Synopsis 


CREATE [ OR REPLACE ] [ TEMP | TEMPORARY ] [ RECURSIVE ] VIEW _name_ [ ( _column_name_ [, 











[ WITH ( _view_option_name_ [= _view_option_value_] [, ... ] ) ] 
AS _query_ 
ER 
vs 
fea aah 


CREATE VIEW 定义 一 个 查询 的 视图 。 这 个 视图 不 是 物理 上 实际 存在 的 ， 并 且 在 该 视图 每 次 被 
引用 的 时 候 都 会 运行 一 次 查询 。 


CREATE OR REPLACE VIEW 类 似 ， 不 过 如 果 一 个 同名 的 视图 已 经 存在 ， 那么 将 替换 它 。 新 查询 
必须 生成 与 现 有 视图 查询 生成 的 字段 相同 的 字段 (也 就 是 ， 相同 的 字段 名 字 ， 相 同 的 顺序 和 
相同 的 数据 类 型 ) ， 但 是 可 能 添加 额外 的 字段 到 列表 的 结尾 。 该 计算 导致 输出 字段 可 能 完 
不 同 。 


如 果 给 出 了 一 个 模式 名 (比如 CREATE VIEW myschema.myview ... ), 那么 该 视图 将 在 指定 的 模式 
中 创建 ， 否 则 将 在 当前 模式 中 创建 。 临时 视图 存在 于 一 个 特殊 的 模式 里 ， 所 以 创建 临时 视图 
的 时 候 ， 不 能 给 出 模式 名 。 新 视图 名 字 必 需 和 同一 模式 中 任何 其 它 视图 、 表 、 序 列 、 索 引 或 
外 部 表 的 名 字 不 同 。 


FEF 
参数 
TEMPORARY 或 TEMP 


如 果 声 明了 这 个 子 句 ， 那 么 视图 就 以 临时 视图 的 方式 创建 。 临时 视图 在 当前 会 话 结束 的 时 候 
将 被 自动 删除 。 当 前 会 话 中 ， 在 临时 视图 存在 的 期 间 ， 将 无 法 看 到 现 有 的 同名 关系 ， 除 非 用 
模式 修饰 的 名 字 引 用 它们 。 

如 果 视 图 引用 的 任何 基础 表 是 临时 的 ， 那 么 视图 将 被 创建 为 临时 的 (不 管 是 否 声明 

了 TEMPORARY )。 


RECURSIVE 


创建 一 个 递归 的 视图 。 语 法 


CREATE RECURSIVE VIEW _name_ (_columns_) AS SELECT _ 


等 同 于 


CREATE VIEW _name_ AS WITH RECURSIVE _name_ (_columns_) AS (SELECT _..._) SELECT _columns 


‘| = = 








必须 为 一 个 递归 的 视图 指定 一 个 视图 字段 列表 。 


_name_ 


所 要 创建 的 视图 名 称 ( 可 以 有 模式 修饰 )。 


_column_name_ 
一 个 可 选 的 名 字 列 表 ， 用 作 视 图 的 字段 名 。 如 果 没 有 给 出 ， 字 段 名 取 自 查询 。 


WITH ( _view_option_name_ [= _view_option_value_ ][, ...] ) 





该 子 句 为 视图 指定 选项 参数 ; 目前 ， 唯 一 支持 的 参数 名 是 security_barrie, 当 视 图 打算 提 
供 行 级 安全 时 ， 应 该 启用 该 参数 。 参 阅 Section 38.5 获取 全 部 细节 。 


—query_ 


一 个 将 为 视图 提供 行 和 列 的 SELECT 或 VALUES 语 句 。 


+> = 

yt FS 

使 用 DROP VIEW 语句 删除 视图 。 

请 注意 视图 字段 的 名 字 和 类 型 不 一 定 是 你 们 期 望 的 那样 。 比 如 ， 


CREATE VIEW vista AS SELECT 'Hello World'; 


在 两 个 方面 很 糟糕 : 字段 名 缺 省 是 ?column? 并 且 字 段 的 数据 类 型 缺 省 是 unknow o 如 果 你 
想 视 图 的 结果 是 一 个 字符 串 文本 ， 那 么 请 像 下 面 这 样 使 用 : 


CREATE VIEW vista AS SELECT text 'Hello World' AS hello; 


对 视图 引用 的 表 的 访问 的 权限 由 视图 的 所 有 者 决定 。 在 一 些 情况 下 ， 这 可 用 于 提供 安全 但 是 
限制 访问 底层 表 。 不 过 ， 不 是 所 有 视图 对 于 筑 改 都 是 安全 的 ; 参阅 Section 38.5 获 取 细 节 。 
在 视图 里 调用 的 函数 当 作 他 们 直接 从 使 用 视图 的 查询 里 调用 看 待 。 因 此 ， 视图 的 用 户 必须 有 
调用 视图 使 用 的 所 有 画 数 的 权限 。 


“4 CREATE OR REPLACE View 用 在 一 个 现 有 的 视图 上 时 ， 只 改变 了 视图 定义 的 SELECT 规则 。 
其 他 视图 属性 ， 包 括 所 有 权 、 权 限 和 非 SELECT 规 则 ， 保持 不 变 。 要 替换 视图 ， 你 必须 拥有 
该 视图 〈 包 括 成 为 拥有 者 角色 的 一 员 ) 。 


可 更 新 的 视 
简单 的 视图 是 自动 可 更 新 的 : 系统 允许 INSERT, UPDATE 和 DELETE 语句 和 在 规则 表 上 一 样 
的 方式 在 视图 上 使 用 。 如 果 视 图 满足 所 有 下 列 的 条 件 ， 那 么 就 是 自动 可 更 新 的 : 

。 视图 在 它 的 Fo 列表 中 必须 只 有 一 个 条 目 ， 该 条 目 必须 是 一 个 表 或 其 他 可 更 新 视图 。 


e 视图 定义 必须 没有 在 顶级 包含 WITH, DISTINCT, GROUP BY 、 


HAVING 、 LIMIT 或 OFFSET 子 句 。 
。 视图 定义 必须 没有 在 顶级 包含 集合 运算 ( UNION, INTERSECT 或 EXCEPT ) o 


。 视图 的 选择 列表 中 的 所 有 字段 必须 简单 的 引用 底层 关系 的 字段 。 它们 不 能 是 表达 式 、 字 
面值 或 函数 。 也 不 能 引用 系统 字段 。 


。 在 视图 的 选择 列表 中 ， 底 野 关 系 的 字段 出 现 不 能 超过 一 次 。 
e。 视图 必须 没有 security_barrier 属性 。 


如 果 视 图 是 自动 可 更 新 的 ， 那 么 系统 将 转换 视图 上 的 任意 INSERT, UPDATE 或 DELETE 语句 
为 相应 的 底层 基本 关系 上 的 语句 。 


如 果 一 个 自动 可 更 新 的 视图 包含 一 个 whERE 条 件 ， 那么 该 条 件 约束 基本 关系 的 哪些 行 可 以 被 
视图 上 的 UPDATE 和 DELETE 语句 修改 。 不 过 ， 人 允许 UPDATE 更 改 一 个 行 ， 所 以 它 不 再 满 

E wer 条 件 ， 并 且 因 此 不 再 通过 视图 可 见 。 相似 的 ， INsERT 命令 可 以 潜在 的 插入 不 满 
E wHERE 条 件 的 基本 关系 行 ， 并 且 因 此 不 能 通过 视图 可 见 。 


不 满足 所 有 这 些 条 件 的 更 复杂 的 视图 缺 省 是 只 读 的 : 系统 将 不 允许 在 该 视图 上 插入 、 更 新 或 
删除 。 可 以 通过 在 该 视图 上 创建 INSTEAD oF 触发 器 获得 可 更 新 视图 的 效果 ， 该 触发 器 必须 转 
换 在 该 视图 上 的 尝试 插入 等 为 其 他 表 上 的 适当 动作 。 更 多 信息 请 参见 CREATE TRIGGER, 
还 有 一 种 可 能 性 是 创建 规则 (参阅 CREATE RULE) ， 但 是 实际 上 触发 器 更 容易 理解 和 正确 
使 用 。 


请 注意 ， 用 户 在 视图 上 执行 插入 、 更 新 或 删除 必须 在 该 视图 上 有 相应 的 插入 、 更 新 或 删除 的 
权限 。 此 外 ， 视 图 的 所 有 者 必须 在 底层 基础 关系 上 有 相关 的 权限 ， 但 是 执行 更 新 的 用 户 不 需 
要 在 底层 基础 关系 上 的 任何 权限 (参阅 Section 38.5) 。 


例子 


创建 一 个 由 所 有 喜剧 电影 组 成 的 视图 : 


CREATE VIEW comedies AS 
SELECT * 
FROM films 
WHERE kind = 'Comedy'; 


这 将 创建 一 个 视图 ， 在 视图 创建 的 时 候 包 含 film 表 中 字段 。 尽管 用 * 创建 了 该 视图 ， 但 是 
后 来 添加 到 表 中 的 字段 将 不 会 是 视图 的 一 部 分 。 
创建 一 个 由 数字 1 到 100 组 成 的 递归 的 视图 : 


CREATE RECURSIVE VIEW nums_1_100 (n) AS 
VALUES (1) 

UNION ALL 
SELECT n+1 FROM nums_1_100 WHERE n < 100; 


DSS 
兼容 性 
SQL 标准 为 cREATE view 声明 了 一 些 附加 的 功能 : 


CREATE VIEW _name_ [ ( _column_name_ [, ...] ) ] 
AS _query_ 
[ WITH [ CASCADED | LOCAL ] CHECK OPTION ] 





完整 的 SQL 命令 可 选 的 子 句 是 : 


CHECK OPTION 


这 个 选项 控制 自动 可 更 新 视图 的 行为 。 给 出 时 ， 对 视图 的 insert 和 UPDATE 都 要 检查 以 确保 
新 行 满足 视图 定义 的 条 件 (也 就 是 说 ， 新 行 应 该 可 以 通过 视图 看 到 ) 。 如 果 没 有 通过 检查 ， 

更 新 将 被 拒绝 。 没有 CHECK OPTION ， 允 许 对 视图 的 INSERT 和 UPDATE 命令 创建 通过 该 视图 

不 可 见 的 行 。 (后 者 的 行为 当前 只 有 PostgreSQL 提 供 。) 


LOCAL 
对 这 个 视图 进行 完整 性 检查 。 
CASCADED 


对 此 视图 和 任何 相关 视图 进行 完整 性 检查 。 在 既 没有 声明 cascapEp 也 没有 声明 LocAL 时 ， 假 


设 为 CASCADED 。 


CREATE OR REPLACE VIEW 是 PostgreSQL 的 扩展 。 临 时 视图 的 概念 也 是 扩展 。 WITH 子 句 也 是 
一 个 扩展 。 


义 见 


ALTER VIEW, DROP VIEW, CREATE MATERIALIZED VIEW 
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CREATE VIEW 1754 


DEALLOCATE 


Name 


DEALLOCATE -- 删除 一 个 预 各 语句 


Synopsis 


DEALLOCATE [ PREPARE ] { _name_ | ALL } 


fia ah 


DEALLOcATE 用 于 删除 前 面 编写 的 预备 语句 。 如 果 你 没有 明确 删除 一 个 预 各 语句 ， 那 么 它 将 在 
会 话 结束 的 时 候 被 删除 。 


有 关 预 各 语句 的 更 多 信息 。 参 阅 PREPARE。 


参数 


PREPARE 


_name_ 


将 要 删除 的 预备 语句 。 


ALL 


删除 所 有 和 预 各 语句 。 


兼容 性 


SQL 包括 一 个 DEALLOCATE #24), (HO RBAF RAT SAL. 


参见 


ZZ 


EXECUTE, PREPARE 


DECLARE 


Name 


DECLARE -- 定义 一 个 游标 


Synopsis 


DECLARE _name_ [ BINARY ] [ INSENSITIVE ] [ [ NO ] SCROLL ] 
CURSOR [ { WITH | WITHOUT } HOLD ] FOR _query_ 


DECLARE 人 允许 用 户 创建 游标 ， 用 于 在 一 个 大 的 查询 里 面 检索 少数 几 行 数据 。 在 游标 建立 后 ， 
使 用 FETCH 可 以 从 中 取出 行 。 


Note: 本 页 描述 游标 在 SQL 命 命 级别 的 使 用 。 如 果 你 试图 在 一 个 PL/pgSQL 画 数 里 面 使 用 
游标 ， 结果 往往 是 不 同 的 ; 2% Section 40.7。 


_name_ 


将 要 创建 的 游标 名 。 


BINARY 


命 游标 以 二 进 制 而 不 是 文本 格式 返回 数据 。 

INSENSITIVE 

表明 从 游标 检索 出 来 的 数据 不 应 该 被 发 生 在 游标 创建 后 的 游标 的 更 新 动作 影响 。 在 
PostgreSQL 里 ， 这 是 缺 省 行为 ; 这 个 关键 字 没 有 什么 作用 ， 只 在 为 了 和 SQL 标准 兼容 的 时 
候 接 受 它 。 


SCROLL ~NO SCROLL 


scROLL 声明 该 游标 可 以 用 于 以 倒序 的 方式 检索 数据 行 (也 就 是 反 向 检索 )。 根据 查询 的 执行 计 
划 的 不 同 ， 声 明 scRoLL 可 能 会 对 查询 的 执行 时 间 有 不 良 影响 。 No SCROLL 声明 该 游标 不 能 
于 以 倒序 的 方式 检索 数据 行 。 缺 省 仅 人 允许 在 某 些 情况 下 倒序 检索 ， 这 不 同 于 指定 scRoLL o 
参见 注意 获取 细节 。 


WITH HOLD WITHOUT HOLD 


WITH HOLD ( 缺 省 ) 声 明 该 游标 可 以 在 创建 它 的 事务 成 功 提交 后 继续 使 用 。 wITHouT HOLD 声明 
该 游标 不 能 在 创建 它 的 事务 之 外 使 用 。 


—query_ 
一 个 SELECT 或 VALUES 命 令 ， 它 提供 游标 返回 的 行 。 


BINARY ， INSENSITIVE ， SCROLL 关键 字 可 以 以 任何 顺序 出 现 。 


通常 游标 和 sELEcT 一 样 返 回 文 本 格式 。 BINARY 选项 声明 游标 应 该 返回 二 进 制 格式 的 数据 。 

这 样 就 减少 了 服务 器 和 客户 端的 转化 工作 ， 花费 程序 员 更 多 的 工作 解决 平台 依赖 的 二 进 制 数 
据 格 式 问 题 。 比如 ， 如 果 查 询 从 某 个 整数 列 返回 1 ， 在 缺 省 的 游标 里 将 获得 一 个 字符 串 1 ， 
但 在 二 进 制 游标 里 将 得 到 一 个 4 字 节 的 包含 该 数值 内 部 形式 的 数值 (大 端 顺序 )。 


应 该 小 心 使 用 二 进 制 游标 。 一 些 客户 端 应 用 (比如 psql) 是 不 能 识别 二 进 制 游标 的 ， 它 们 期 望 返 
回 的 数据 是 文本 格式 。 


Note: 如 果 客 户 端 应 用 使 用 "扩展 查询 "协议 发 出 FETcH to, 那么 Bind 协议 声明 数据 是 
用 文本 还 是 用 二 进 制 格式 检索 。 这 个 选择 覆盖 游标 的 定义 。 因此 ， 在 使 用 扩展 查询 协议 
的 时 候 ， 二 进 制 游标 的 概念 已 经 过 时 了 ， 任何 游标 都 可 以 当 作文 本 或 者 二 进 制 的 格式 发 
出 。 





如 果 没 有 声明 with HoLp ， 那 么 这 个 命令 创建 的 游标 只 能 在 当前 事务 中 使 用 。 这 样 ， 不 
带 WITH HOLD 的 DECLARE 在 事务 块 外 面 没 有 任何 用 处 : 游标 将 一 直 存 活 到 事务 结束 。 因 此 ， 
PostgreSQL 将 在 这 样 的 命令 出 现在 事务 块 外 面 的 时 候 报错 。 使 用 BEGIN, COMMIT 和 
ROLLBACK 定 义 一 个 事务 块 。 


如 果 声 明了 with HoLD 并 且 创 建 该 游标 的 事务 成 功 提交 ， 那么 游标 还 可 以 在 同一 会 话 随后 的 
事务 里 访问 。 但 如 果 创 建 它 的 事务 回 滚 ， 那么 游标 被 删除 。 带 w HOLD 创建 的 游标 是 用 一 
个 明确 的 close 命令 或 者 是 会 话 终止 来 关闭 的 。 在 目前 的 实现 里 ， 由 一 个 游标 代表 的 行 是 被 
找 贝 到 一 个 临时 文件 或 者 内 存 区 里 的 ， 这 样 他 们 就 仍然 可 以 在 随后 的 事务 中 被 访问 。 


当 查 询 包 含 FoR UPDATE 或 FOR SHARE 的 时 候 ， 不 能 指定 WITH HOLD o 


在 定义 一 个 要 用 来 反 向 抓 取 的 游标 的 时 候 ， 应 该 声明 scRoLL 选项 ， 这 是 SQL 标准 要 求 的 。 
不 过 ， 为 了 和 早期 的 版 本 兼容 ， 只 要 游标 的 查询 计划 简单 得 不 需要 额外 的 开销 ，PostgreSQL 
在 没有 声明 scRoLL 的 时 候 也 人 允许 反 向 抓 取 。 不 过 ， 建议 应 用 开发 人 员 不 要 依赖 于 使 用 没有 使 
用 scRoLL 定义 的 游标 的 反 向 查找 功能 。 如 果 声 明了 No scRoLL ， 那么 不 管 怎 样 都 会 禁止 反 
向 抓 取 的 功能 。 


当 查 询 包含 FOR UPDATE 或 FOR SHARE 时 也 不 允许 反 向 抓 取 ; 因此 在 这 种 情况 下 不 能 声 


明 scRoLL 。 


Caution 


如 果 调 用 任何 不 稳定 的 函数 ， 那 么 可 以 回 滚 并 且 with HoLp 游标 可 能 给 出 意外 的 结果 
(参阅 xref linkend="xfunc-volatility">) > 当 重 新 抓 取 到 以 前 抓 取 到 的 行 时 ， 画 数 可 能 会 
重新 执行 ， 可 能 导致 结果 与 之 前 的 不 同 。 一 个 绕 开 这 种 情况 的 方法 是 声明 WITH HOLD 游 
标 ， 并 且 在 从 它 读 取 任何 行 之 前 提交 事务 。 这 将 强制 游标 的 整个 输出 在 临时 存储 中 物 
化 ， 这 样 不 稳定 的 落 数 精确 的 每 行 只 执行 一 次 。 


如 果 游 标的 查询 包括 For UPDATE 或 FOR SHARE ， 那么 返回 的 行 在 它们 第 一 次 被 抓 取 的 时 候 锁 
定 ， 和 有 这 个 选项 的 SELECT 一 样 。 另 外 ， 返 回 行将 是 最 新 的 版 本 ; 因此 提供 这 些 选项 相当 
于 SQL 标准 调用 一 个 "敏感 的 游标 "。 (和 For UPDATE 或 FOR SHARE 一 起 指定 INSENSITIVE 是 


若 误 的 。 ) 
Caution 


如 果 游 标定 义 为 使 用 UPDATE ... WHERE CURRENT OF 或 DELETE ... WHERE CURRENT OF ， 通 
常 推荐 使 用 FoR uppate o 使 用 For uPDATE 阻止 其 他 会 话 在 抓 取 和 更 新 之 间 改 变 行 。 没 

有 FoR UPDATE ， 如 果 在 创建 游标 后 改变 了 行 ， 那 么 随后 的 whERE cuRRENT OF 命令 将 没有 
作用 。 


使 用 FoR uPDATE 的 另外 一 个 原因 是 ， 没 有 它 ， 如 果 游 标 查 询 不 符合 SQL 标准 的 "简单 可 更 

新 "原则 ， 那 么 随后 的 whERE CURRENT OF 可 能 会 失败 (尤其 是 ， 游 标 必须 只 引用 一 个 表 ， 并 且 
不 使 用 分 组 或 oRDER BY ) 。 不 是 简单 可 更 新 的 游标 可 能 会 也 可 能 不 会 工作 ， 取 决 于 计划 选择 
细节 ; 所 以 在 最 坏 的 情况 下 ， 应 用 可 能 在 测试 中 工作 而 在 生产 中 失败 。 


不 和 WHERE CURRENT oF 一 起 使 用 For uPDATE 的 主要 原因 是 ， 你 需要 游标 是 可 回 滚 的 ， 或 对 随 
后 的 更 新 不 敏感 的 (也 就 是 说 ， 持 续 显示 旧 的 数据 ) 。 如 果 需 要 这 样 ， 请 注意 上 面 显 示 的 注 
意 事项 。 | 


SQL 标准 中 的 游标 只 能 在 车 入 SQL(ESQLI) 的 应 用 中 使 用 。 PostgreSQL 服 务 器 没有 一 个 明确 
的 open 语句 ; 一 个 游标 被 认为 在 定义 时 就 已 经 打开 了 。 不 过 ，PostgreSQL RAM SQL f 
处 理 器 (ECPG) 支 持 SQL 标准 的 习惯 ， 包括 那些 和 DEcLARE 和 open 相关 的 语句 。 


可 以 通过 查询 pg cursors 系统 视图 看 到 所 有 可 用 游标 。 


例子 
定义 一 个 游标 : 


DECLARE liahona CURSOR FOR SELECT * FROM films; 


参阅 FETCH 获 取 有 关 游 标 使 用 的 更 多 例子 。 


RAIE 


SQL 标准 说 它 是 依赖 于 实现 的 ， 不 管 游标 对 缺 省 的 底层 数据 的 当前 更 新 是 否 敏 感 。 在 
PostgreSQL 中 ， 游 标 缺 省 是 敏感 的 ， 并 且 可 以 通过 声明 ror uPDATE 使 其 敏感 。 其 他 产品 工 
作 可 能 不 同 。 


SQL 标准 只 克 许 在 做 入 的 SQL 中 和 模块 中 使 用 游标 。 PostgreSQL 人 允许 交互 地 使 用 游标 。 
二 进 制 游标 是 PostgreSQL 扩 展 。 
XI 


CLOSE, FETCH, MOVE 


DELETE 


Name 


DELETE -- 删除 一 个 表 中 的 行 


Synopsis 


[ WITH [ RECURSIVE ] _with_query_ [, ...] ] 
DELETE FROM [ ONLY ] _table_name_ [ * ] [ [ AS ] _alias_ ] 
[ USING _using_list_ ] 
[ WHERE _condition_ | WHERE CURRENT OF _cursor_name_ ] 
[ RETURNING * | _output_expression_ [ [ AS ] _output_name_ ] [, ...] ] 


摘 述 
DELETE 从 指定 的 表 里 删 除 满足 whERE 子 句 的 行 。 如 果 were 子 句 不 存在 ， 将 删除 表 中 所 有 
行 。 结 果 是 一 个 有 效 的 空 表 。 


Tip: TRUNCATE 是 一 个 PostgreSQL 扩 展 ， 它 提 供 一 个 更 快 的 从 表 中 删除 所 有 行 的 机 
制 。 

使 用 数据 库 中 其 它 表 的 信息 删除 某 个 表 中 的 数据 行 有 两 个 办 法 : 使 用 子 查询 ， 或 者 

在 usins 子 句 中 声明 额外 的 表 。 哪 种 技巧 更 合适 取决 于 特定 的 环境 。 


可 选 的 RETURNING 子 句 将 使 得 DeLETE 计算 并 返回 实际 被 删除 了 的 行 。 任何 使 用 表 字 段 的 表达 
式 和 /或 usine 中 提 到 的 其 他 表 的 字段 ， 都 可 以 用 于 计算 。 RETURNING 列表 的 语法 
和 secect 输出 列表 的 语法 相同 。 


要 对 表 进 行 删除 ， 你 必须 对 它 有 DELETE 权限 ， 同 样 也 必须 有 usie 子 句 的 表 以 
及 _condition_ 上 读 取 的 表 的 SELECT 权限 。 


参数 


_with_query_ 


WITH 子 句 允许 指定 一 个 或 多 个 可 以 通过 DELETE 查询 中 的 名 字 引 用 的 子 查询 。 参阅 Section 
7.8 和 SELECT 获取 详细 信息 。 


_table_name_ 


要 删除 行 的 表 的 名 字 〈 可 以 有 模式 修饰 ) 。 如 果 在 表 的 名 字 前 指定 了 omy, 则 只 从 指定 的 
表 中 删除 匹配 的 行 。 如 果 没 有 指定 oNLYy ， 则 从 指定 的 表 及 其 所 有 子 表 中 的 删除 匹配 的 行 。 
可 选 的 ， 可 以 在 表 名 的 后 面 指定 * 以 明确 的 指出 包括 后 代表 。 


_alias_ 
目标 表 的 别名 。 如 果 提 供 了 别名 ， 那 么 它 将 完全 掩盖 实际 的 表 名 。 例 如 给 


定 DELETE FROM foo AS f Ziq, DELETE 语句 的 剩余 部 分 必须 使 用 f 而 不 是 foo 来 引用 该 
表 。 


_using_list_ 
表 表 达 式 列表 ， 人 允许 来 自 其 他 表 的 列 出 现在 wer 条 件 中 。 这 与 可 以 在 sELEcT may 


FROM 子 句 中 指定 的 表 列 表 相 似 。 例 如 ， 可 以 为 该 表 的 名 字 声 明 一 个 别名 。 不 要 在 
_using list 里 重复 目标 表 ， 除 非 你 希望 产生 一 个 自 连接 。 


_condition_ 


一 个 返回 boolean 值 的 表达 式 ， 只 用 表达 式 返 回 true 的 行 被 删除 。 

_cursor_name_ 

在 WHERE CURRENT OF 条 件 中 使 用 的 游标 的 名 字 。 要 删除 的 行 是 最 近 从 这 个 游标 获取 到 的 。 该 
游标 必须 是 一 个 在 pbELETE 的 目标 表 中 非 分 组 的 查询 。 请 注意 ， wHERE CURRENT OF 不 能 和 一 


个 布尔 条 件 一 起 指定 ， 参 阅 DECLARE 获 取 更 多 关于 和 wHERE cURRENT OF 一 起 使 用 游标 的 信 
自 


INO 


_output_expression_ 


计算 并 在 删除 行 后 由 pELETE 命令 返回 的 一 个 表达 式 。 该 表达 式 可 以 使 用 由 _table_name_ fp 
名 的 表 的 任意 字段 名 或 在 usis 中 列 出 的 表 。 * 返回 所 有 字段 。 


_output_name_ 


用 于 返回 的 列 名 称 。 


输出 
成 功 时 ， DELETE 命令 返回 形 如 
DELETE _count_ 
的 标签 。 _count_ 是 被 删除 的 行 数 。 请 注意 ， 当 删除 被 BEFORE DELETE 触发 器 取消 时 ， 这 个 


数字 可 能 小 于 匹配 _condition 的 行 数 。 如 果 _count 为 0 则 没有 行 被 该 查询 删除 ， 这 个 不 


认为 是 错误 。 


如 果 DELETE 命令 包含 一 个 RETURNING 子 句 ， 那 么 其 结果 非常 类 似 于 sELECT 语句 基 
于 RETURNING 子 句 中 包含 的 字段 和 值 列 表 的 结果 ， 只 是 基于 被 删除 的 行进 行 计算 而 已 。 


MAN 
) 王 局 


PostgreSQL 人 允许 你 在 wer 条 件 里 引用 其 它 表 的 字段 ， 方 法 是 在 usm 子 句 里 声明 其 它 
表 。 上 比如 ， 要 删除 给 出 制 片 商 制作 的 所 有 电影 ， 可 以 : 


DELETE FROM films USING producers 
WHERE producer_id = producers.id AND producers.name = 'foo'; 


这 里 实际 发 生 的 事情 是 在 films 和 producers 之 间 的 一 个 连接 ， 然后 所 有 成 功 连接 
的 films 行 都 标记 为 删除 。 这 个 语法 不 是 标准 的 ， 更 标准 的 语法 是 这 么 做 : 


DELETE FROM films 
WHERE producer_id IN (SELECT id FROM producers WHERE name = 'foo'); 


有 时 候 连 接 风格 比 子 查 询 风格 更 容易 写 或 者 执行 更 快 。 


例子 
删除 所 有 电影 (flms) 但 不 删除 音乐 (musicals) : 
DELETE FROM films WHERE kind <> 'Musical'; 
清空 films 表 : 
DELETE FROM films; 


从 tasks 表 及 其 子 表 中 删除 ， 并 返回 所 有 被 删除 的 行 : 


DELETE FROM tasks WHERE status = 'DONE' RETURNING *; 


删除 游标 c_tasks 当前 指向 的 tasks 的 行 : 


DELETE FROM tasks WHERE CURRENT OF c_tasks; 


兼容 性 


这 条 命令 遵循 SQL 标准 ， 但 是 usine 和 RETURNING 子 句 是 PostgreSQL 的 扩展 ， 就 像 
在 DELETE 中 使 用 with o 


DISCARD 


Name 


DISCARD -- 丢弃 会 话 状态 


Synopsis 


DISCARD { ALL | PLANS | TEMPORARY | TEMP } 


摘 述 
DISCARD 释放 与 数据 库 会 话 相 关 的 内 部 资源 。 这 些 资源 通常 在 会 话 结束 时 释放 。 


DISCARD TEMP 删除 所 有 在 当前 会 话 中 创建 的 临时 表 。 DISCARD PLANS 释放 所 有 的 内 部 缓存 查 
询 计划 。 DISCARD ALL 重 置 一 个 会 话 到 初始 状态 ,丢弃 临时 资源 和 新 设置 的 本 地 会 话 的 改变 。 


参 类 
参数 
TEMPORARY OF TEMP 


删除 在 当前 会 话 中 创建 的 所 有 的 临时 表 。 


PLANS 


释放 所 有 缓存 的 查询 计划 。 


ALL 


释放 所 有 和 与 当前 会 话 相 关 的 临时 资源 并 重 置 到 其 初始 状态 。 当前 ， 这 与 执行 以 下 语句 序列 有 
相同 的 效果 : 


SET SESSION AUTHORIZATION DEFAULT; 
RESET ALL; 

DEALLOCATE ALL; 

CLOSE ALL; 

UNLISTEN *; 

SELECT pg_advisory_unlock_all(); 
DISCARD PLANS; 

DISCARD TEMP; 


说 明 


DISCARD ALL 在 一 个 事务 内 部 模块 中 不 能 被 执行 。 


兼容 性 


DISCARD 是 一 个 PostgreSQL 扩 展 。 


DO 


Name 


DO -- 执行 匿名 代码 块 


Synopsis 


DO [ LANGUAGE _lang_name_ ] _code 





fia ah 
D0 执行 一 段 匿名 代码 块 , 换 句 话说， 在 程序 语言 过 程 中 一 次 性 执行 的 匿名 酌 数 。 


代码 块 被 看 做 是 没有 参数 的 一 段 画 数 体 ， 返 回 值 类 型 是 void 。 它 的 解析 和 执行 时 同一 时 刻 发 
生 的 。 


可 选 属性 LANGUAGE 可 以 在 代码 块 之 前 宇 ， 也 可 以 写 在 代码 块 的 后 面 。 


参数 


_code_ 
程序 语言 代码 可 以 被 执行 的 。 程 序 语言 必须 指定 为 字符 串 才 行 , MIRMA CREATE FUNCTION , 
推荐 使 用 美元 符号 一 样 。 


_lang_name_ 


用 来 解析 代码 的 程序 语言 的 名 字 ， 如 果 缺 省 ， 默 认 的 语言 是 plpgsql o 


注意 事项 


程序 语言 在 使 用 之 前 ， 必 须 
jz 


通过 命令 CREATE LANGUAGE 安装 到 当前 的 数据 库 中 。 plpgsql 是 
默认 的 安装 语言 ， 其 它 Jen 


装 昌 必须 指定 Eo 


i E 


如 果 语 言 是 不 受信 任 的 ， 用 户 必 须 有 使 用 程序 语言 的 usAGE 权限 ， 或 者 是 超级 用 户 。 在 语言 
上 ， 这 同 创 建 一 个 图 数 是 一 样 的 权限 要 求 。 


例子 
授予 角色 webuser 对 模式 public 下 视图 的 所 有 操作 权限 : 


DO $$DECLARE r record; 
BEGIN 

FOR r IN SELECT table_schema, table_name FROM information_schema.tables 

WHERE table_type = 'VIEW' AND table_schema = 'public' 
LOOP 
EXECUTE 'GRANT ALL ON ' || quote_ident(r.table_schema) || '.' || quote_ident(r.ta 

END LOOP; 

END$$; 


«| = 


RAIE 


SQL 标准 中 没有 po 语句 。 








XIL 


CREATE LANGUAGE 


DROP AGGREGATE 


Name 


DROP AGGREGATE -- 删除 一 个 聚集 函数 


Synopsis 


DROP AGGREGATE [ IF EXISTS ] _name_ ( _argtype_[, ... ] ) [ CASCADE | RESTRICT ] 


fia ah 


DROP AGGREGATE MIR- Cn FARRA. WTRAMBNA PO ae AREDAHMA 
者 。 


参数 


IF EXISTS 
如 果 指 定 的 聚集 不 存在 ， 那 么 发 出 一 个 notice 而 不 是 抛 出 一 个 错误 。 
现存 的 聚集 函数 名 (可 以 有 模式 修饰 ) 

_argtype_ 


PRR NRE ASR, BSIA-TFSBSRRRWM, A + 代 蔡 输入 数据 类 型 列 
Ro 


CASCADE 


2h HX A BRAK Fa PERS BLY xt 


RESTRICT 


WRAEK IR, MFR MPR TRAM, RERBRE, 


例子 


将 integer 类 型 的 聚集 辑 数 myavg 删除 : 


DROP AGGREGATE myavg(integer); 


RANE 


SQL 标准 里 没有 DROP AGGREGATE 语句 。 


义 见 


ALTER AGGREGATE, CREATE AGGREGATE 


DROP CAST 


Name 


DROP CAST -- 删除 一 个 类 型 转换 


Synopsis 


DROP CAST [ IF EXISTS ] (_source_type_ AS _target_type_) [ CASCADE | RESTRICT ] 





摘 述 
DROP cast 删除 一 个 先前 定义 过 的 类 型 转换 。 


要 能 删除 一 个 类 型 转换 ， 你 必须 拥有 源 或 者 目的 数据 类 型 。 这 是 和 创建 一 个 类 型 转换 相同 的 
权限 。 


参数 


IF EXISTS 


如 果 指 定 的 转换 不 存在 ， 那 么 发 出 一 个 notice 而 不 是 抛 出 一 个 错误 。 


_source_type_ 


类 型 转换 里 的 源 数据 类 型 。 
_target_type_ 


类 型 转换 里 的 目标 数据 类 型 。 


CASCADE ` ~RESTRICT 


这 些 键 字 没有 任何 效果 ， 因 为 在 类 型 转换 上 没有 依赖 关系 。 


例子 
删除 从 text 到 int 的 转换 : 


DROP CAST (text AS int); 


RANE 


DROP CAST 遵循 SQL 标准 。 


XIL 


CREATE CAST 


DROP COLLATION 


Name 


DROP COLLATION -- 删除 一 个 排序 规则 


Synopsis 


DROP COLLATION [ IF EXISTS ] _name_ [ CASCADE | RESTRICT ] 


摘 述 

DROP COLLATION 删除 一 个 已 经 定义 的 排序 规则 。 你 必须 是 该 排序 规则 的 所 有 者 才能 删除 它 。 
参数 

IF EXISTS 


如 果 指 定 的 排序 规则 不 存在 ， 那 么 发 出 一 个 notice 而 不 是 抛 出 一 个 错误 。 


_name 


排序 规则 名 (可 以 有 模式 修饰 )。 


CASCADE 


自动 删除 依赖 于 这 个 排序 规则 的 对 象 。 


RESTRICT 


如 果 有 任何 依赖 对 象 ， 则 拒绝 删除 这 个 排序 规则 。 这 是 缺 省 义理 。 


例子 
要 删除 名 为 german 的 排序 规则 : 


DROP COLLATION german; 


兼容 性 


DROP COLLATION 遵循 SQL 标准 ， 但 是 IF Exists 选项 是 PostgreSQL 的 扩展 。 


义 见 


ALTER COLLATION, CREATE COLLATION 


DROP CONVERSION 


Name 


DROP CONVERSION -- 删除 一 个 编码 转换 


Synopsis 


DROP CONVERSION [ IF EXISTS ] _name_ [ CASCADE | RESTRICT ] 


fia ah 


DROP CONVERSION 删除 一 个 先前 定义 过 的 编码 转换 。 要 想 删 除 一 个 转换 ， 你 必须 拥有 该 转换 。 


参数 


IF EXISTS 


如 果 指 定 的 转换 不 存在 ， 那 么 发 出 一 个 notice 而 不 是 抛 出 一 个 错误 。 


_name_ 


编码 转换 的 名 字 ( 可 以 用 模式 修饰 )。 


CASCADE ` ` RESTRICT 


这 些 关键 字 没有 作用 ， 因 为 编码 转换 上 没有 依赖 关系 。 


例子 
删除 一 个 叫做 myname 的 编码 转换 : 


DROP CONVERSION myname; 


兼容 性 


SQL 标准 里 没有 DROP conversion 语句 ， 但 是 有 一 个 与 CREATE TRANSLATION 同 在 


的 DROP TRANSLATION 语句 ， CREATE TRANSLATION 语句 类 似 于 PostgreSQL 中 
的 cREATE CONVERSION 语句 。 


义 见 


ALTER CONVERSION, CREATE CONVERSION 


DROP DATABASE 


Name 


DROP DATABASE -- 删除 一 个 数据 库 


Synopsis 


DROP DATABASE [ IF EXISTS ] _name_ 


fia aah 


DROP DATABASE MR-DA HEE. MR- An FA EME RADHA WRASSE ko 
ee 够 执 还 有 ， 如 果 你 或 者 任何 其 他 人 正在 与 目标 数据 库 连 
E, 那么 就 不 能 执行 这 条 命令 。 所 以 要 和 与 postgres 或 者 任何 其 它 数据 库 连 接 ， 再 发 出 这 条 命 


A 
Tho 


DROP DATABASE 不 能 撤销 ， 小 心 使 用 ! 


参数 


IF EXISTS 


如 果 指 定 的 数据 库 不 存在 ， 那 么 发 出 一 个 notice 而 不 是 抛 出 一 个 错误 。 


_name_ 


要 被 删除 的 现 有 数据 库 名 。 


N= a 


yam AA 


DROP DATABASE 不 能 在 事务 块 中 执行 。 
这 条 命令 在 和 目标 数据 库 连 接 时 不 能 执行 。 通 常 更 好 的 做 法 是 用 dropdb 程序 代替 ， 该 程序 是 
入 


此 命令 的 一 个 封装 。 


PostgreSQL 中 文 文档 9.3 


SQL 标准 里 没有 DROP DATABASE 语句 。 


义 见 


CREATE DATABASE 


DROP DATABASE 1776 


DROP DOMAIN 


Name 


DROP DOMAIN -- 删除 一 个 域 


Synopsis 


DROP DOMAIN [ IF EXISTS ] _name_ [, ...] [ CASCADE | RESTRICT ] 


摘 述 

DROP DOMAIN 删除 一 个 域 。 只 有 域 的 所 有 者 才能 删除 它 。 
参数 

IF EXISTS 


如 果 指 定 的 域 不 存在 ， 那 么 发 出 一 个 notice 而 不 是 抛 出 一 个 错误 。 


_name 


一 个 现 有 的 域 ( 可 以 有 模式 修饰 )。 


CASCADE 


级 联 删除 依赖 该 域 的 对 象 〈 例 如 表 字 段 ) 。 


RESTRICT 


如 果 有 任何 依赖 对 象 存在 ， 则 拒绝 删除 此 域 。 这 个 是 缺 省 。 


例子 
删除 box 域 


DROP DOMAIN box; 


兼容 性 


这 条 命令 兼容 SQL 标准 ， 但 IF exists 选项 是 一 个 PostgreSQL 扩 展 。 


义 见 


CREATE DOMAIN, ALTER DOMAIN 


DROP EXTENSION 


Name 


DROP EXTENSION -- 删除 一 个 扩展 


Synopsis 


DROP EXTENSION [ IF EXISTS ] _name_ [, ...] [ CASCADE | RESTRICT ] 


摘 述 

DROP EXTENSION 命令 从 数据 库 中 删除 一 个 扩展 。 在 删除 扩展 的 过 程 中 ， 构 成 扩展 的 组 件 也 会 
一 起 删除 。 

必须 是 扩展 的 拥有 者 才能 够 使 用 DROP EXTENSION 命令 。 


参数 


IF EXISTS 
当 使 用 IF exists 参数 ， 如 果 扩 展 不 存在 时 ， 不 会 抛 出 错误 ， 而 是 产生 一 个 通知 。 
_name_ 

已 经 安装 的 扩展 模块 的 名 称 。 

CASCADE 


自动 删除 依赖 于 该 扩展 的 对 象 。 


RESTRICT 


如 果 有 依赖 于 扩展 的 对 象 ， 则 不 允许 删除 次 扩展 〈 除 非 它 所 有 的 成 员 对 象 和 其 它 扩 展 对 象 在 
一 条 prop 命令 一 起 删除 ) 。 这 是 缺 省 行为 。 


例子 


从 当前 数据 库 中 删除 扩展 hstore 


DROP EXTENSION hstore; 


在 当前 数据 库 中 ， 如 果 有 使 用 hstore 的 对 象 的 ， 这 条 命令 就 会 失败 ， 比 如 任 一 表 中 的 字段 使 
用 hstore 类 型 。 这 时 增加 cAscApE 选项 会 强制 删除 扩展 和 依赖 于 扩展 的 对 象 。 


兼容 性 


DROP EXTENSION 是 PostgreSQL 的 扩展 。 


义 见 


CREATE EXTENSION, ALTER EXTENSION 


DROP EVENT TRIGGER 


Name 


DROP EVENT TRIGGER -- 删除 一 个 事件 触发 器 


Synopsis 


DROP EVENT TRIGGER [ IF EXISTS ] _name_ [ CASCADE | RESTRICT ] 


摘 述 


DROP EVENT TRIGGER 删除 一 个 已 存在 的 事件 触发 器 。 当前 用 户 是 事件 触发 器 的 所 有 者 才能 够 


执行 这 个 命令 。 


参数 


IF EXISTS 
当 使 用 IF exists ,如 果 事 件 触发 器 不 存在 时 ， 不 会 抛 出 错误 ， 而 是 产生 一 个 通知 。 


_name 


待 删除 的 事件 触发 器 的 名 称 。 


CASCADE 


自动 删除 依赖 于 事件 触发 器 的 对 象 。 


RESTRICT 


如 果 有 依赖 于 事件 触发 器 的 对 象 ， 则 不 允许 删除 这 个 事件 触发 器 。 这 是 缺 省 行为 。 


例子 
删除 事件 触发 器 snitch : 


DROP EVENT TRIGGER snitch; 


RANE 


SQL 标准 中 不 支持 DROP EVENT TRIGGER 语句 


义 见 


CREATE EVENT TRIGGER, ALTER EVENT TRIGGER 


DROP FOREIGN DATA WRAPPER 


Name 


DROP FOREIGN DATA WRAPPER -- 删除 一 个 外 部 数据 封装 


Synopsis 


DROP FOREIGN DATA WRAPPER [ IF EXISTS ] _name_ [ CASCADE | RESTRICT ] 


fi ah 


DROP FOREIGN DATA WRAPPER 删除 一 个 已 存在 的 外 部 数据 封装 器 。 当前 用 户 必须 是 外 部 数据 封 
装 器 的 所 有 者 才能 够 执行 此 命令 。 


参数 


IF EXISTS 


当 使 用 IF exists ,如 果 外 部 数据 封装 器 不 存在 时 ， 不 会 抛 出 错误 ， 而 是 产生 一 个 通知 。 


_name_ 


已 存在 的 外 部 数据 封装 器 的 名 称 。 


CASCADE 


自动 删除 依赖 外 部 数据 封装 器 的 对 象 《如 服务 器 ) 。 


RESTRICT 


如 果 有 依赖 于 外 部 数据 封装 器 的 对 象 ， 则 不 允许 删除 外 部 数据 封装 器 。 这 是 缺 省 行为 。 


例子 
删除 外 部 数据 封装 器 dbi : 


DROP FOREIGN DATA WRAPPER dbi; 


FANE 


DROP FOREIGN DATA WRAPPER X ISO/IEC 9075-9 (SQL/MED) 标 准 。 IF EXISTS 选项 是 
PostgreSQL 的 扩展 。 


义 见 


CREATE FOREIGN DATA WRAPPER, ALTER FOREIGN DATA WRAPPER 


DROP FOREIGN TABLE 


Name 


DROP FOREIGN TABLE -- 删除 一 个 外 部 表 


Synopsis 


DROP FOREIGN TABLE [ IF EXISTS ] _name_ [, ...] [ CASCADE | RESTRICT ] 


fi ah 


DROP FOREIGN TABLE 删除 一 个 外 部 表 。 只 有 外 部 表 的 所 有 者 才能 够 删除 外 部 表 。 


参数 


IF EXISTS 


当 使 用 IF exists ,如 果 外 部 表 不 存在 时 ， 不 会 抛 出 错误 ， 而 是 产生 一 个 通知 。 


_name_ 


待 删除 的 外 部 表 的 名 称 (可 以 有 模式 修饰 ) 


CASCADE 


自动 删除 依赖 于 外 部 表 的 对 象 ( 如 视图 ) 


RESTRICT 


如 果 有 依赖 于 外 部 表 的 对 象 ， 则 不 允许 删除 外 部 表 。 这 是 缺 省 行为 。 


例子 
删除 外 部 表 films 和 distributors : 


DROP FOREIGN TABLE films, distributors; 


兼容 性 


此 命令 兼容 ISO/IEC 9075-9 (SQL/MED) 标 准 。 只 不 过 标准 只 允许 一 条 命令 删除 一 个 
表 。 IF EXISTS 选项 也 是 PostgreSQL 的 扩展 。 


义 见 


ALTER FOREIGN TABLE, CREATE FOREIGN TABLE 


DROP FUNCTION 


Name 


DROP FUNCTION -- 删除 一 个 画 数 


Synopsis 


DROP FUNCTION [ IF EXISTS ] _name_ ( [ [ _argmode_ ] [ _argname_ ] _argtype_ [, ...] ] ) 
[ CASCADE | RESTRICT ] 


so ns 


DROP FUNCTION 将 删除 一 个 现存 的 函数 。 要 执行 这 条 命令 ， 用 户 必 须 是 函数 的 所 有 者 。 必须 
声明 函数 的 参数 类 型 ， 因 为 几 个 不 同 的 函数 可 能 会 有 同样 的 名 字 和 不 同 的 参数 列表 。 


参数 


IF EXISTS 


如 果 指 定 的 函数 不 存在 ， 那 么 发 出 一 个 notice 而 不 是 抛 出 一 个 错误 。 


_name_ 


现存 的 函数 名 称 (可 以 有 模式 修饰 )。 


_argmode_ 


参数 的 模式 : IN (HRA), OUT, INOUT, VARIADIC o 请 注意 DROP FUNCTION 实际 上 并 不 注 
意 ouT 参数 ， 因为 判断 函数 的 身份 只 需要 输入 参数 。 因 此 列 出 in, Inout 和 vARIADIC 参数 
就 足够 了 。 


_argname_ 


参数 的 名 字 。 请 注意 DROP Function 实际 上 并 不 注意 参数 的 名 字 ， 因为 判断 画 数 的 身份 只 需 
要 输入 参数 的 数据 类 型 。 


_argtype_ 
如 果 有 的 话 ， 是 函数 参数 的 类 型 (可 以 用 模式 修饰 )。 


CASCADE 


级 联 删除 依赖 于 画 数 的 对 象 (比如 操作 符 或 触发 器 )。 


RESTRICT 


如 果 有 任何 依赖 对 象 存在 ， 则 拒绝 删除 该 画 数 。 这 个 是 缺 省 。 


例子 
RAS ALTE : 


DROP FUNCTION sqrt(integer); 


RANE 


SQL 标准 里 定义 了 一 个 DROP FUNCTION 语句 。 但 和 这 条 命令 不 兼容 。 


义 见 


CREATE FUNCTION, ALTER FUNCTION 


DROP GROUP 


Name 


DROP GROUP -- 删除 一 个 数据 库 角色 
Synopsis 

DROP GROUP [ IF EXISTS ] _name_ [, 
摘 述 
DROP GROUP 现在 是 DROP ROLE 的 别名 。 


兼容 性 


SQL 标准 里 没有 DROP croup 语句 。 


XIL 


DROP ROLE 


DROP INDEX 


Name 


DROP INDEX -- 删除 索引 


Synopsis 


DROP INDEX [ CONCURRENTLY ] [ IF EXISTS ] _name_ [, ...] [ CASCADE | RESTRICT ] 


fi ah 


prop INDEX 从 数据 库 中 删除 一 个 现存 的 索引 。 要 执行 这 个 命令 ， 你 必须 是 索引 的 所 有 者 


参数 


CONCURRENTLY 


在 表 上 删除 索引 的 同时 不 对 查询 ， 插 和 入， 更新， 删除 加 锁 。 普通 的 prop INDEX 会 使 表 获 得 
独占 锁 ， 阻 塞 其 他 的 访问 ， 直 到 索引 删除 完成 。 使 用 此 选项 , 会 由 阻塞 变 为 等 待 ， 直 到 其 他 冲 
突 事 物 结束 。 


使 用 此 选项 时 有 几 个 注意 事项 。 只 能 指定 一 个 素 引 的 名 称 ， 并 且 cascae 选项 不 支持 。 ( 同 
at, 一 个 索引 是 UNIQUE Or PRIMARY KEY 约束 的 时 候 ， 不 能 以 此 方式 删除 。) 同时 ， 正 规 的 
DROP INDEX 命令 可 以 在 事物 内 执行 , (A DROP INDEX CONCURRENTLY 不 可 以 在 事物 内 执行 . 


IF EXISTS 
如 果 指 定 的 索引 不 存在 ， 那 么 发 出 一 个 notice 而 不 是 抛 出 一 个 错误 
_name_ 


要 删除 的 索引 名 (可 以 有 模式 名 字 )。 


CASCADE 


级 联 删 除 依赖 于 该 索引 的 对 象 。 


RESTRICT 


如 果 有 依赖 对 象 存 在 ， 则 拒绝 删除 该 索引 。 这 个 是 缺 省 。 


Examples 
此 命令 将 删除 title_idx 索引 : 


DROP INDEX title_idx; 


FANE 


DROP INDEX 是 PostgreSQL 语言 扩展 。 在 SQL 标准 里 没有 索引 的 规定 。 


请 参阅 


CREATE INDEX 


DROP LANGUAGE 


Name 
DROP LANGUAGE -- 删除 一 个 过 程 语言 
Synopsis 
DROP [ PROCEDURAL ] LANGUAGE [ IF EXISTS ] _name_ [ CASCADE | RESTRICT ] 


fia aah 


DROP LANGUAGE 删除 售 注 册 过 的 过 程 语 言 name。 必须 是 超级 用 户 或 该 过 程 语言 的 所 有 者 才能 


使 用 DROP LANGUAGE 。 





Note: 自 PostgreSQL 9.1 起 ， 大 多 数 过 程 语言 成 为 了 "extensions"， 因此 删除 时 应 该 使 
用 DROP EXTENSION， 不 能 使 用 prop LANGUAGE o 


IF EXISTS 
如 果 指定 的 过 程 语言 不 存在 ， 那 么 发 出 一 个 notice 而 不 是 抛 出 一 个 错误 。 
_name_ 


现存 语言 的 名 称 。 出 于 向 下 兼容 的 考虑 ， 这 个 名 字 可 以 用 单 引 号 包围 。 


CASCADE 


级 联 删 除 依 赖 于 该 语言 的 对 象 (比如 该 语言 写 的 函数 )。 


RESTRICT 


如 果 存 在 依赖 对 象 ， 则 拒绝 删除 。 这 个 是 缺 省 。 


例子 


下 面 命令 删 除 plsample 语言 : 


DROP LANGUAGE plsample; 


RANE 


SQL 标准 里 没有 DROP LANGUAGE 语句 。 


义 见 


ALTER LANGUAGE, CREATE LANGUAGE, droplang 


DROP MATERIALIZED VIEW 


Name 


DROP MATERIALIZED VIEW -- 删除 一 个 物化 视图 


Synopsis 


DROP MATERIALIZED VIEW [ IF EXISTS ] _name_ [, ...] [ CASCADE | RESTRICT ] 


fi ah 


DROP MATERIALIZED VIEW 删除 一 个 现存 的 物化 视图 。 要 执行 这 个 命令 ， 你 必须 是 物化 视图 的 所 
有 者 。 


IF EXISTS 
如 果 指 定 的 物化 视图 不 存在 ， 那 么 发 出 一 个 notice 而 不 是 抛 出 一 个 错误 。 


_name _ 


要 删除 的 物化 视图 (可 以 有 模式 修饰 )。 


CASCADE 


级 联 删 除 依 赖 于 该 物化 视图 的 对 象 (例如 其 他 物化 视图 或 普通 视图 ) 。 


RESTRICT 


如 果 有 依赖 对 象 存 在 ， 则 拒绝 删除 该 物化 视图 。 这 个 是 缺 省 。 


例子 
此 命令 将 删除 order_summary 物化 视图 : 


DROP MATERIALIZED VIEW order_summary; 


PostgreSQL 中 文 文档 9.3 


兼容 性 


DROP MATERIALIZED VIEW 是 PostgreSQL 的 一 个 扩展 。 


xX J 


CREATE MATERIALIZED VIEW, ALTER MATERIALIZED VIEW, REFRESH 
MATERIALIZED VIEW 


DROP MATERIALIZED VIEW 1795 


DROP OPERATOR 


Name 


DROP OPERATOR -- 删除 一 个 操作 符 


Synopsis 


DROP OPERATOR [ IF EXISTS ] _name_ ( { _left_type_ | NONE } , { _right_type_ | NONE } ) [ 


ee 


DROP OPERATOR 语句 从 数据 库 中 删除 一 个 现存 的 操作 符 。 要 执行 这 个 命令 ， 你 必须 是 操作 符 
所 有 者 。 


参数 


IF EXISTS 








如 果 指 定 的 操作 符 不 存在 ， 那 么 发 出 一 个 notice 而 不 是 抛 出 一 个 错误 。 
一 个 现存 的 操作 符 的 名 字 ( 可 以 有 模式 修饰 )。 

_left_type_ 

该 操作 符 左 操作 数 的 类 型 。 如 果 没 有 则 写 none o 

_right_type_ 

该 操作 符 右 操作 数 的 类 型 。 如 果 没 有 则 写 none o 

CASCADE 

级 联 删 除 依 赖 于 此 操作 符 的 所 有 对 象 。 

RESTRICT 


如 果 有 任何 依赖 对 象 则 拒绝 删除 此 操作 符 。 这 个 是 缺 省 。 


例子 


将 用 于 integer JAIRI arb 删除 : 


DROP OPERATOR ^ (integer, integer); 


为 类 型 bit 删除 左 单 目 位 操作 符 ~b 


DROP OPERATOR ~ (none, bit); 


删除 用 于 bigint 的 阶乘 x! 


DROP OPERATOR ! (bigint, none); 


RANE 


SQL 标准 里 没有 prop OPERATOR 语句 。 


义 见 


CREATE OPERATOR, ALTER OPERATOR 


DROP OPERATOR CLASS 


Name 


DROP OPERATOR CLASS -- 删除 一 个 操作 符 类 


Synopsis 


DROP OPERATOR CLASS [ IF EXISTS ] _name_ USING _index_method_ [ CASCADE | RESTRICT ] 





摘 述 
DROP OPERATOR CLASS 删除 一 个 现 有 操作 符 类 。 要 执行 这 条 命令 ， 你 必须 是 此 操作 符 类 的 所 有 
者 。 


DROP OPERATOR CLASS 不 删除 被 类 引用 的 任何 操作 符 或 函数 。 如 果 有 任何 索引 依赖 于 该 操作 符 
类 ， 必 须 声 明 cAscApE 来 全 部 删除 。 


参数 


IF EXISTS 
如 果 指定 的 操作 符 类 不 存在 ， 那 么 发 出 一 个 notice 而 不 是 抛 出 一 个 错误 。 
_name_ 


一 个 现存 操作 符 类 的 名 字 ( 可 以 用 模式 修饰 )。 


index_method 





操作 符 类 所 引用 的 索引 访问 方法 的 名 字 。 
CASCADE 
级 联 删 除 依赖 于 该 操作 符 类 的 对 象 。 


RESTRICT 


如 果 有 任何 依赖 对 象 存 在 ， 则 拒绝 删除 此 操作 符 类 。 这 个 行为 是 缺 省 。 


DROP OPERATOR CLASS 不 会 删除 包含 该 类 的 操作 符 族 ， 即 使 没有 其 他 东西 存在 于 族 中 也 一 样 
(尤其 是 ， 族 是 由 cREATE OPERATOR CLASS 创建 的 时 ) 。 一 个 空 的 操作 符 族 是 无 害 的 ， 但 是 为 
了 整洁 你 可 能 希望 用 DROP OPERATOR FAMILY 删除 这 个 族 ; 或 更 直接 的 在 一 开始 就 使 


用 DROP OPERATOR FAMILY 。 


例子 
删除 B-tree 操作 符 类 widget_ops : 


DROP OPERATOR CLASS widget_ops USING btree; 


如 果 有 任何 现存 的 索引 使 用 这 个 操作 符 类 ， 那 么 这 条 命令 将 不 能 执行 。 增加 一 个 cascave M 
除 这 样 的 索引 以 及 这 个 操作 符 类 。 


兼容 性 


SQL 标准 里 没有 DROP OPERATOR CLASS 语句 。 


义 见 


ALTER OPERATOR CLASS, CREATE OPERATOR CLASS, DROP OPERATOR FAMILY 


DROP OPERATOR FAMILY 


Name 


DROP OPERATOR FAMILY -- 删除 一 个 操作 符 族 


Synopsis 


DROP OPERATOR FAMILY [ IF EXISTS ] _name_ USING _index_method_ [ CASCADE | RESTRICT ] 





摘 述 
DROP OPERATOR FAMILY 删除 一 个 现 有 的 操作 符 族 。 要 执行 这 条 命令 ， 你 必须 是 此 操作 符 族 的 
所 有 者 。 


DROP OPERATOR FAMILY 包含 删除 任何 包含 在 该 族 内 的 操作 符 类 ， 但 是 不 会 删除 被 该 族 引 用 的 
任何 操作 符 或 函数 。 如 果 有 任何 索引 依赖 于 该 族 内 的 操作 符 类 ， 则 需要 声明 cAscApE 来 一 起 
删除 。 


参数 


IF EXISTS 
如 果 指定 的 操作 符 族 不 存在 ， 那 么 发 出 一 个 notice 而 不 是 抛 出 一 个 错误 。 


一 个 现存 操作 符 族 的 名 字 ( 可 以 用 模式 修饰 )。 


index_method 


操作 符 族 所 引用 的 索引 访问 方法 的 名 字 


CASCADE 





级 联 删 除 依 赖 于 该 操作 符 族 的 对 象 。 


RESTRICT 


如 果 有 任何 依赖 对 象 存 在 ， 则 拒绝 删除 此 操作 符 族 。 这 个 行为 是 缺 省 。 


例子 


删除 B-tree 操作 符 类 float ops : 


DROP OPERATOR FAMILY float_ops USING btree; 


如 果 有 任何 现存 的 索引 使 用 该 族 中 的 操作 符 类 ， 那 么 这 条 命令 将 不 能 执行 。 增加 一 
个 CASCADE 删除 这 样 的 索引 以 及 这 个 操作 符 族 。 


兼容 性 


SQL 标准 里 没有 DROP OPERATOR FAMILY 语句 。 


义 见 


ALTER OPERATOR FAMILY, CREATE OPERATOR FAMILY, ALTER OPERATOR CLASS, 
CREATE OPERATOR CLASS, DROP OPERATOR CLASS 


DROP OWNED 


Name 


DROP OWNED -- 删除 一 个 数据 库 角 色 所 拥有 的 数据 库 对 象 


Synopsis 


DROP OWNED BY _name_ [, ...] [ CASCADE | RESTRICT ] 


Description 


DROP OWNED 删除 一 个 数据 库 角色 所 拥有 的 所 有 数据 库 对 象 。 所 有 该 角色 在 当前 数据 库 里 和 共 
享 对 象 (数据 库 ， 表 空间 ) 上 的 所 有 对 象 上 的 权限 都 将 被 撤销 。 


参数 


_name_ 


将 要 删除 所 拥有 对 象 并 且 撤销 其 权限 的 角色 名 。 


CASCADE 


级 联 删 除 所 有 依赖 于 被 删除 对 象 的 对 象 。 


RESTRICT 


拒绝 删除 那些 有 任何 依赖 对 象 存在 的 对 象 。 这 个 是 缺 省 。 


S> 一 


ae 


DROP OWNED 常用 来 做 删除 角色 前 的 准备 工作 。 因为 pro owNED 仅 会 对 当前 数据 库 产 生 影 
响 ， 所 以 通常 需要 在 每 个 该 角色 拥有 对 象 的 数据 库 上 执行 一 次 。 


使 用 cAscApE 选项 可 能 损害 到 其 他 用 户 所 拥有 的 对 象 。 
REASSIGN OWNED 命 令 可 以 用 来 重新 分 配 某 个 或 某 些 角色 所 拥有 对 象 的 属 主 。 
该 角色 拥有 的 数据 库 和 表 空 间 将 被 删除 。 


FANE 


DROP OWNED 语句 是 一 个 PostgreSQL 扩 展 。 


义 见 


REASSIGN OWNED, DROP ROLE 


DROP ROLE 


Name 


DROP ROLE -- 删除 一 个 数据 库 角色 


Synopsis 


DROP ROLE [ IF EXISTS ] _name_ [, ...] 


摘 述 
DROP ROLE 删除 指定 的 角色 。 要 删除 一 个 超级 用 户 角色 ， 你 自己 必须 也 是 一 个 超级 用 户 ; 要 
删除 非 超级 用 户 角 色 ， 你 必须 有 cREATEROLE 权限 。 


不 能 删除 仍然 被 集群 中 的 任意 数据 库 引 用 的 角色 ， 如 果 想 删除 它 ， 会 抛 出 一 个 错误 。 在 删除 
一 个 角色 之 前 ， 你 必须 删除 它 拥有 的 所 有 对 象 (或 者 重新 赋予 他 们 新 的 所 有 者 )， 并 且 撤 销 赋 
予 该 角色 的 任何 权限 。REASSIGN OWNED 和 DROP OWNED 命 令 可 以 达到 这 个 目的 。 


不 过 ， 没 有 必要 删除 涉及 该 角色 的 角色 成 员 关 系 ; DRoP ROLE 自动 撤销 目标 角色 在 任何 其 它 
角色 里 面 的 成 员 关 系 ， 以 及 其 它 角色 在 目标 角色 里 的 成 员 关 系 。 其 它 角色 不 会 被 删除 ， 也 不 


ASE ri BY By, 
会 受到 其 O RIRI o 


参数 


IF EXISTS 


如 果 指 定 的 角色 不 存在 ， 那 么 发 出 一 个 notice 而 不 是 抛 出 一 个 错误 。 


_name 


要 删除 的 角色 名 字 。 


~ = 


) 王 局 


PostgreSQL 包 含 了 一 个 dropuser 程 序 ， 有 着 和 这 个 命令 相同 的 功能 (实际 上 ， 它 调用 这 个 命 
倒 )， 但 是 它 可 以 从 命令 行 上 运行 。 


例子 
删除 一 个 角色 : 


DROP ROLE jonathan; 


FANE 


SQL 标准 定义 了 prop RoLE ， 但 它 只 人 允许 每 次 删除 一 个 角色 ， 并 且 它 声明 了 和 PostgreSQL 使 
用 的 不 同 的 权限 要 求 。 


义 见 


CREATE ROLE, ALTER ROLE, SET ROLE 


DROP RULE 


Name 


DROP RULE -- 删除 一 个 重 写 规 则 


Synopsis 


DROP RULE [ IF EXISTS ] _name_ ON _table_name_ [ CASCADE | RESTRICT ] 





fi ah 


DROP RULE 删除 一 个 规则 。 


参数 


IF EXISTS 
如 果 指 定 的 规则 不 存在 ， 那 么 发 出 一 个 notice 而 不 是 抛 出 一 个 错误 。 


_name 


要 删除 的 现存 规则 名 称 。 


_table_name_ 


该 规则 应 用 的 关系 名 字 ( 可 以 有 模式 修饰 )。 


CASCADE 


级 联 删 除 依赖 于 此 规则 的 对 象 。 


RESTRICT 


如 果 有 任何 依赖 对 象 ， 则 拒绝 删除 此 规则 。 这 个 是 缺 省 。 


例子 
删除 重 写 规则 newrule : 


DROP RULE newrule ON mytable; 


FANE 


DROP RULE 是 一 个 PostgreSQL 语 言 的 扩展 ， 就 像 查询 重 写 系统 。 


义 见 


CREATE RULE, ALTER RULE 


DROP SCHEMA 


Name 


DROP SCHEMA -- 删除 一 个 模式 


Synopsis 


DROP SCHEMA [ IF EXISTS ] _name_ [, ...] [ CASCADE | RESTRICT ] 


摘 述 
DROP SCHEMA 从 数据 库 中 删除 模式 。 


模式 只 能 被 它 的 所 有 者 或 者 超级 用 户 删除 。 请 注意 ， 所 有 者 即使 溉 有 拥有 模式 中 任何 对 象 也 
可 以 删除 模式 (以 及 模式 中 的 所 有 对 象 )。 


参数 


IF EXISTS 


如 果 指 定 的 模式 不 存在 ， 那 么 发 出 一 个 notice 而 不 是 抛 出 一 个 错误 。 


模式 的 名 字 。 
CASCADE 

自动 删除 包含 在 模式 中 的 对 象 ( 表 、 男 数 等 等 )。 
RESTRICT 


如 果 模 式 包含 任何 对 象 ， 则 拒绝 删除 它 。 这 个 是 缺 省 。 


例子 
从 数据 库 中 删除 模式 mystuff 以 及 它 包 含 的 所 有 东西 : 


DROP SCHEMA mystuff CASCADE; 


RANE 


DROP SCHEMA 和 SQL 标准 完全 兼容 ， 只 不 过 标准 只 允许 每 条 命令 删除 一 个 模式 。 另 
外 ， IF EXISTS 选项 是 PostgreSQL 扩 展 。 


义 见 


ALTER SCHEMA, CREATE SCHEMA 


DROP SEQUENCE 


Name 


DROP SEQUENCE -- 删除 一 个 序列 


Synopsis 


DROP SEQUENCE [ IF EXISTS ] _name_[, ...] [ CASCADE | RESTRICT ] 
vb 
描述 
prop SEQUENCE 从 数据 库 中 删除 序列 号 生成 器 。 只 有 其 所 有 者 或 超级 用 户 才能 将 其 删除 。 
参数 
IF EXISTS 


如 果 指 定 的 序列 不 存在 ， 那 么 发 出 一 个 notice 而 不 是 抛 出 一 个 错误 。 


_name 


序列 名 (可 以 有 模式 修饰 )。 


CASCADE 


级 联 删 除 依赖 序列 的 对 象 。 


RESTRICT 


如 果 存 在 任何 依赖 的 对 象 ， 则 拒绝 删除 序列 。 这 个 是 缺 省 。 


例子 
从 数据 库 中 删除 序列 serial : 


DROP SEQUENCE serial; 


兼容 性 


DROP SEQUENCE 遵循 SQL 标 准 ， 只 是 标准 只 允许 每 条 命令 删除 一 个 序列 。 并 且 ， IF EXISTS 
选项 是 PostgreSQL 的 扩展 。 


义 见 


CREATE SEQUENCE, ALTER SEQUENCE 


DROP SERVER 


Name 


DROP SERVER -- 删除 一 个 外 部 服务 器 描述 符 


Synopsis 


DROP SERVER [ IF EXISTS ] _name_ [ CASCADE | RESTRICT ] 


fi ah 


DROP SERVER 删除 一 个 现 有 外 部 服务 器 描述 符 。 为 了 执行 该 命令 ， 当前 用 户 必 须 是 该 服务 器 
的 所 有 者 。 


参数 


IF EXISTS 
如 果 指定 的 服务 器 不 存在 ， 那 么 发 出 一 个 notice 而 不 是 抛 出 一 个 错误 。 


_name_ 


一 个 既 有 服务 器 的 名 称 。 


CASCADE 


级 联 删除 依赖 服务 器 的 对 象 (比如 用 户 映 射 )。 


RESTRICT 


若 有 任何 对 象 依赖 服务 器 则 拒绝 删除 它 。 这 个 是 默认 。 


例子 
若 存在 则 副 除 服务 器 foo : 


DROP SERVER IF EXISTS foo; 


RANE 


DROP SERVER 遵守 ISO/IEC 9075-9 (SQL/MED), IF Exists 子 句 是 PostgreSQL 扩 展 。 


XIL 


CREATE SERVER, ALTER SERVER 


DROP TABLE 


Name 


DROP TABLE -- 删除 一 个 表 


Synopsis 


DROP TABLE [ IF EXISTS ] _name_ [, ...] [ CASCADE | RESTRICT ] 


DROP TABLE 从 数据 库 中 删除 表 或 视图 。 只 有 表 的 者 、 模式 所 有 者 和 超级 用 户 才能 删除 一 个 
表 。 要 清空 而 不 是 删除 表 ， 请 使 用 DELETE 或 TRUNCATE。 


DROP TABLE 总 是 删除 目标 表 上 现 有 的 任何 索引 、 规 则 、 触 发 器 、 约 束 。 但 是 ， 要 删除 一 个 有 
视图 或 者 其 它 表 用 外 键 约束 引用 的 表 ， 必 须 声明 cAscADE o cascade 将 删除 引用 的 视图 ， 但 
是 如 果 是 外 键 约束 ， 那 么 就 只 删除 外 键 约束 ， 而 不 是 另外 一 个 表 。 


参数 


IF EXISTS 
如 果 指定 的 表 不 存在 ， 那 么 发 出 一 个 notice 而 不 是 抛 出 一 个 错误 。 
_name_ 


要 删除 的 现存 表 的 名 字 ( 可 以 有 模式 修饰 )。 


CASCADE 


级 联 删 除 依赖 于 表 的 对 象 (比如 视图 )。 


RESTRICT 


如 果 存 在 依赖 对 象 ， 则 拒绝 删除 该 表 。 这 个 是 缺 省 。 


例子 


删除 films 和 distributors 表 : 


DROP TABLE films, distributors; 


RANE 


此 命令 兼容 SQL 标准 。 只 不 过 标准 只 允许 一 条 命令 删除 一 个 表 。 此 外 ， IF Exists 选项 是 
PostgreSQL 的 扩展 。 


义 见 


ALTER TABLE, CREATE TABLE 


DROP TABLESPACE 


Name 


DROP TABLESPACE -- 删除 一 个 表 空 间 


Synopsis 


DROP TABLESPACE [ IF EXISTS ] _name_ 


摘 述 
DROP TABLESPACE 从 系统 里 删除 一 个 表 空 间 。 


一 个 表 空 间 只 能 由 其 所 有 者 或 者 超级 用 户 删 除 。 在 删除 一 个 表 空 间 之 前 ， 表 空 间 里 面 不 能 
任何 数据 库 对 象 。 即 使 当前 数据 库 里 面 已 经 没有 任何 对 象 在 使 用 这 个 表 空 间 了 ， 也 有 可 能 
其 它 的 数据 库 对 象 存留 在 这 个 表 空 间 里 。 同 样 ， 如 果 在 任何 活动 会 话 的 temp _tablespaces 中 
列 出 了 该 表 空 间 ， DpRoP 可 能 会 因为 临时 文件 存在 于 该 表 空 间 中 而 失败 。 


参数 


IF EXISTS 
如 果 指定 的 表 空 间 不 存在 ， 那 么 发 出 一 个 notice 而 不 是 抛 出 一 个 错误 。 
_name_ 


表 空 间 的 名 字 。 


h e e l 
ťa 


DROP TABLESPACE 不 能 出 现在 事务 块 内 部 。 


例子 


从 系统 里 删除 表 空 间 mystuff : 


DROP TABLESPACE mystuff; 


RANE 


DROP TABLESPACE 是 PostgreSQL 扩 展 。 


义 见 


CREATE TABLESPACE, ALTER TABLESPACE 


DROP TEXT SEARCH CONFIGURATION 


Name 


DROP TEXT SEARCH CONFIGURATION -- 删除 一 个 文本 搜索 配置 


Synopsis 


DROP TEXT SEARCH CONFIGURATION [ IF EXISTS ] _name_ [ CASCADE | RESTRICT ] 


fi ah 


DROP TEXT SEARCH CONFIGURATION 删除 既 有 文本 搜索 配置 。 要 执行 这 个 命令 ， 你 必须 是 该 配置 
的 所 有 者 。 


参数 


IF EXISTS 


如 果 指 定 的 文本 搜索 配置 不 存在 ， 那 么 发 出 一 个 notice 而 不 是 抛 出 一 个 错误 。 


_name 


一 个 现 有 文本 搜索 配置 的 名 称 (可 有 模式 修饰 ) 。 


CASCADE 


级 联 删 除 依 赖 文 本 搜索 配置 的 对 象 。 


RESTRICT 


若 有 任何 对 象 依赖 文本 搜索 配置 对 拒绝 删除 它 。 这 是 默认 情况 。 


例子 
删除 文本 搜索 配置 my_english : 


DROP TEXT SEARCH CONFIGURATION my_english; 


若 有 任何 现 有 索引 引用 to_tsvector 调用 中 的 配置 ， 该 命令 将 不 会 成 功 。 添加 cascave 来 删 
除 这 样 的 索引 连带 文本 搜索 配置 。 


兼容 性 


在 SQL 标准 中 没有 DROP TEXT SEARCH CONFIGURATION 语句 。 


义 见 


ALTER TEXT SEARCH CONFIGURATION, CREATE TEXT SEARCH CONFIGURATION 


DROP TEXT SEARCH DICTIONARY 


Name 


DROP TEXT SEARCH DICTIONARY -- 删除 一 个 文本 搜索 字典 


Synopsis 


DROP TEXT SEARCH DICTIONARY [ IF EXISTS ] _name_ [ CASCADE | RESTRICT ] 


fi ah 


DROP TEXT SEARCH DICTIONARY 删除 一 个 文本 搜索 字典 。 要 执行 这 个 命令 ， 你 必须 是 该 字典 的 
所 有 者 。 


参数 


IF EXISTS 


如 果 指 定 的 文本 搜索 字典 不 存在 ， 那 么 发 出 一 个 notice 而 不 是 抛 出 一 个 错误 。 


_name 


一 个 现 有 文本 搜索 字典 的 名 称 (可 有 模式 修饰 ) 。 


CASCADE 


级 联 删除 依赖 该 文本 搜索 字典 的 对 象 。 


RESTRICT 


若 有 任何 对 象 依赖 文本 搜索 字典 则 拒绝 删除 它 。 这 是 默认 情况 。 


例子 
删除 文本 搜索 字典 english : 


DROP TEXT SEARCH DICTIONARY english; 


若 有 使 用 该 字典 的 任何 现 有 文本 搜索 配置 ， 该 命令 将 不 会 成 功 。 添加 cascave 来 删除 字典 连 
同文 本 搜索 配置 。 


兼容 性 


在 SQL 标准 中 没有 DROP TEXT SEARCH DICTIONARY 语句 。 


义 见 


ALTER TEXT SEARCH DICTIONARY, CREATE TEXT SEARCH DICTIONARY 


DROP TEXT SEARCH PARSER 


Name 


DROP TEXT SEARCH PARSER -- 删除 一 个 文本 搜索 解析 器 


Synopsis 


DROP TEXT SEARCH PARSER [ IF EXISTS ] _name_ [ CASCADE | RESTRICT ] 


fi ah 


DROP TEXT SEARCH PARSER 删除 一 个 现 有 文本 搜索 解析 器 。 你 必须 是 超级 用 户 才 能 使 用 此 命 


A 
To 


参数 


IF EXISTS 


如 果 指 定 的 文本 搜索 解析 器 不 存在 ， 那 么 发 出 一 个 notice 而 不 是 抛 出 一 个 错误 。 


_name_ 


一 个 现 有 文本 搜索 解析 器 的 名 称 (可 有 模式 修饰 )。 


CASCADE 


级 联 删除 依赖 该 文本 搜索 解析 器 的 对 象 。 


RESTRICT 


若 有 任何 对 象 依 赖 文本 搜索 解析 器 则 拒绝 删除 它 。 这 是 默认 情况 。 


例子 
删除 文本 搜索 解析 器 my_parser : 


DROP TEXT SEARCH PARSER my_parser, 


若 有 使 用 该 解析 器 的 任何 现 有 文本 搜索 配 
连同 解析 器 。 


RANE 


在 SQL 标准 中 没有 DROP TEXT SEARCH PARSER 语句 。 


一 
x 

=)» 
中 
> 
H> 
得 
= 


添加 cascave 来 删除 配置 


义 见 


ALTER TEXT SEARCH PARSER, CREATE TEXT SEARCH PARSER 


DROP TEXT SEARCH TEMPLATE 


Name 


DROP TEXT SEARCH TEMPLATE -- 删除 一 个 文本 搜索 模板 


Synopsis 


DROP TEXT SEARCH TEMPLATE [ IF EXISTS ] _name_ [ CASCADE | RESTRICT ] 


fi ah 


DROP TEXT SEARCH TEMPLATE 删除 一 个 现 有 文本 搜索 模板 。 你 必须 是 超级 用 户 才能 使 用 此 命 


A 
To 


参数 


IF EXISTS 


如 果 指 定 的 文本 搜索 模板 不 存在 ， 那 么 发 出 一 个 notice 而 不 是 抛 出 一 个 错误 。 


_name_ 


既 有 文本 搜索 模板 的 名 称 〈 可 有 模式 修饰 ) 。 


CASCADE 


级 联 删除 依赖 该 文本 搜索 模板 的 对 象 。 


RESTRICT 


若 有 任何 对 象 依赖 文本 搜索 模板 则 拒绝 删除 它 。 这 是 默认 的 情况 。 


例子 
w 除 文本 搜索 模板 thesaurus : 


DROP TEXT SEARCH TEMPLATE thesaurus; 


若 有 任何 使 用 模板 的 由 有 文本 搜索 字典 则 该 命令 将 不 会 成 功 。 添加 cascave 来 删除 此 类 字典 
以 及 模板 。 


兼容 性 


在 SQL 标准 中 没有 DROP TEXT SEARCH TEMPLATE 语句 。 


义 见 


ALTER TEXT SEARCH TEMPLATE, CREATE TEXT SEARCH TEMPLATE 


DROP TRIGGER 


Name 


DROP TRIGGER -- 删除 一 个 触发 器 


Synopsis 


DROP TRIGGER [ IF EXISTS ] _name_ ON _table_name_ [ CASCADE | RESTRICT ] 





fia ah 


DROP TRIGGER 删除 一 个 现存 触发 器 的 定义 。 要 执行 这 个 命令 ， 当前 用 户 必 须 是 定义 触发 器 所 
在 的 表 的 所 有 者 。 


参数 


IF EXISTS 
如 果 指定 的 触发 器 不 存在 ， 那 么 发 出 一 个 notice 而 不 是 抛 出 一 个 错误 。 
_name_ 


要 删除 的 触发 器 名 。 


_table_name_ 


触发 器 定义 所 在 的 表 的 名 称 ( 可 以 有 模式 修饰 )， 


CASCADE 


级 联 删 除 依赖 此 触发 器 的 对 象 。 


RESTRICT 


如 果 有 任何 依赖 对 象 存 在 ， 那 么 拒绝 删除 。 这 个 是 缺 省 。 


例子 


删除 films RHY if_dist_exists 触发 器 : 


DROP TRIGGER if_dist_exists ON films; 


FANE 


PostgreSQL 里 的 prop TRIGGER 语句 和 SQL 标准 不 兼容 。 在 SQL 标准 里 ， 触 发 器 名 字 不 是 
表 所 局 部 拥有 的 ， 所 以 命令 只 是 简单 的 DROP TRIGGER _name_ o 


义 见 


CREATE TRIGGER 


DROP TYPE 


Name 


DROP TYPE -- 删除 一 个 数据 类 型 


Synopsis 


DROP TYPE [ IF EXISTS ] _name_ [, ...] [ CASCADE | RESTRICT ] 


摘 述 

prop TYPE 删除 一 个 用 户 定义 的 数据 类 型 。 只 有 类 型 所 有 者 才 可 以 删除 它 。 
参数 

IF EXISTS 


如 果 指 定 的 类 型 不 存在 ， 那 么 发 出 一 个 notice 而 不 是 抛 出 一 个 错误 。 
_name_ 


要 删除 的 类 型 名 (可 以 有 模式 修饰 )。 


CASCADE 


级 联 删除 依赖 该 类 型 的 对 象 (比如 字段 、 函 数 、 操 作 符 等 等 ) 


RESTRICT 


如 果 有 依赖 对 象 ， 则 拒绝 删除 该 类 型 。 这 个 是 缺 省 。 


例子 
删除 box 类 型 : 


DROP TYPE box; 


兼容 性 


命令 类 似 于 SQL 标准 里 对 应 的 命令， 不 过 ， IF Exists 选项 是 PostgreSQL 的 扩展 。 但 
意 ，PostgreSQL 里 的 大 多 数 create TYPE 命令 和 数据 类 型 扩展 机 制 是 和 SQL 标准 里 


义 见 


ALTER TYPE, CREATE TYPE 


DROP USER 


Name 


DROP USER -- 删除 一 个 数据 库 角 色 
Synopsis 


DROP USER [ IF EXISTS ] _name_ [, ...] 


fia ah 


DROP USER 现在 是 DROP ROLE 的 别名 。 


兼容 性 


义 见 


DROP ROLE 


DROP USER MAPPING 


Name 


DROP USER MAPPING -- 删除 用 户 的 外 部 服务 器 映射 


Synopsis 


DROP USER MAPPING [ IF EXISTS ] FOR { _user_name_ | USER | CURRENT_USER | PUBLIC } SERVER 





fia ah 


DROP USER MAPPING 从 外 部 服务 器 删除 一 个 已 存在 的 用 户 映射 。 


外 部 服务 器 的 属 主 可 以 删除 该 服务 器 上 任意 用 户 的 用 户 映射 。 另外 ， 如 果 usace 服务 器 上 的 


权限 已 经 被 授权 给 该 用 户 ， 该 用 户 可 以 删除 其 同名 的 用 户 映射 


参数 


IF EXISTS 


当 用 户 映 射 不 存在 的 时 候 抛 错 。 在 此 情况 下 发 提示 。 


_user_name_ 


映射 的 用 户 名 。 cURRENT_USER 和 user 匹配 当前 用 户 的 名 称 。 
有 目前 和 未 来 用 户 名 。 


_server_name_ 


用 户 映射 的 服务 名 。 


示例 
当 服 务 foo 存在 时 ， 删 除 一 个 用 户 映射 bob : 


DROP USER MAPPING IF EXISTS FOR bob SERVER foo; 


PUBLIC 用 于 匹配 系统 中 的 所 


FANE 


DROP USER MAPPING 符合 ISO/IEC 9075-9 (SQL/MED), IF Exists $7 PostgreSQL 的 
扩展 选项 。 


另 请 参见 


CREATE USER MAPPING, ALTER USER MAPPING 


DROP VIEW 


Name 


DROP VIEW -- 删除 一 个 视图 


Synopsis 


DROP VIEW [ IF EXISTS ] _name_ [, ...] [ CASCADE | RESTRICT ] 


摘 述 

prop VIEW 从 数据 库 中 删除 一 个 现存 的 视图 。 执 行 这 条 命令 必须 是 视图 的 所 有 者 。 
参数 

IF EXISTS 


如 果 指 定 的 视图 不 存在 ， 那 么 发 出 一 个 notice 而 不 是 抛 出 一 个 错误 。 
_name_ 


要 删除 的 视图 名 称 ( 可 以 有 模式 修饰 )。 


CASCADE 


级 联 删 除 依赖 此 视图 的 对 象 (比如 其 它 视图 )。 


RESTRICT 


如 果 有 依赖 对 象 存 在 ， 则 拒绝 删除 此 视图 。 这 个 是 缺 省 。 


例子 
下 面 命令 将 删除 kinds 视图 : 


DROP VIEW kinds; 


兼容 性 


这 条 命令 遵循 SQL 标准 。 只 是 标准 只 多 许 一 条 命令 删除 一 个 视图 。 此 外 ， IF Exists 选项 是 
PostgreSQL 的 扩展 。 


义 见 


ALTER VIEW, CREATE VIEW 


END 


Name 


END -- 提交 当前 事务 


Synopsis 


END [ WORK | TRANSACTION ] 


fia ah 


END 提交 当前 事务 。 所 有 当前 事务 做 的 修改 都 可 被 其 它 事务 看 到 并 且 保 证 崩溃 情况 下 的 持续 
性 。 它 是 一 个 PostgreSQL 的 扩展 ， 等 效 于 COMMIT。 


参数 


WORK ` ` TRANSACTION 


可 选 关键 字 ， 没 有 作用 。 


Ns TE 
$a 


用 ROLLBACK 退 出 事务 。 


在 一 个 事务 块 之 外 发 出 ENp 不 会 有 什么 损害 ， 但 是 它 会 生成 一 个 警告 信息 。 


例子 
提交 当前 事务 ， 今 所 有 改变 生效 : 


END; 


RANE 


END 是 PostgreSQL 的 扩展 ， 提供 与 COMMIT 相 同 的 功能 ， 后 者 是 SQL 标准 声明 的 语句 。 
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XI 


BEGIN, COMMIT, ROLLBACK 


END 1836 


EXECUTE 


Name 


EXECUTE -- 执行 一 个 预备 语句 


Synopsis 


EXECUTE _name_ [ ( _parameter_ [, ...] ) ] 


fia oh 
EXECUTE 执行 一 个 前 面 准备 好 的 预备 语句 。 因 为 一 个 预备 语句 只 在 会 话 的 生命 期 里 存在 ， 那 
么 预备 语句 必须 是 在 当前 会 话 的 前 些 时候 用 PREPARE 语句 创建 的 。 


如 果 创 建 预 各 语句 的 PREPARE isi ries 那么 传递 给 EXECUTE 语句 的 必须 是 一 个 
兼容 的 参数 集 ， 否 则 就 会 生成 一 个 错误 。 请 注意 (和 本 数 不 同 )， 预 备 语句 不 会 基于 参数 的 类 
型 或 者 参数 个 数 重 载 : 在 一 ee eee 


有 关 创 建 和 使 用 预备 语句 的 更 多 信息 ， 请 参阅 PREPARE。 


参数 


_name_ 


要 执行 的 预备 语句 的 名 字 。 


_parameter_ 


给 预备 语句 的 一 个 参数 的 具体 数值 。 它 必 须 是 一 个 生成 与 创建 这 个 预备 语句 时 指定 参数 的 数 
据 类 型 相 兼容 的 值 的 表达 式 。 


输出 


EXECUTE 返回 的 命令 标签 是 预备 语句 的 命令 标签 ， 不 是 execute BY. 


Examples 


例子 在 PREPARE 文 档 的 Examples 小 节 给 出 。 


兼容 性 


SQL 标准 包括 一 个 execute 语句 ， 但 它 只 用 于 艇 入 式 SQL 。 EXECUTE 实现 的 EXECUTE 的 语 
法 也 略微 不 同 。 


义 见 


DEALLOCATE, PREPARE 


EXPLAIN 


Name 


EXPLAIN -- 显示 一 个 语句 的 执行 规划 


Synopsis 


EXPLAIN [ ( _option_ [, ...] ) ] _statement_ 
EXPLAIN [ ANALYZE ] [ VERBOSE ] _statement_ 


这 里 的 -_option “可 以 是 下 列 之 一 : 


ANALYZE [ _boolean_ 
VERBOSE [ _boolean_ 
COSTS [ _boolean_ ] 
BUFFERS [ _boolean_ ] 
TIMING [ _boolean_ ] 
FORMAT { TEXT | XML | JSON | YAML } 


Ft 
学 


这 条 命令 显示 PostgreSQL 规 划 器 为 所 提供 的 语句 生成 的 执行 规划 。 执行 规划 显示 语句 引用 的 
表 是 如 何 被 扫描 的 (简单 的 顺序 扫描 ， 还 是 素 扫 描 )， 并 且 如 果 引 用 了 多 个 表 ， 采用 了 什么 衬 
的 连接 算法 从 每 个 输入 的 表 中 取出 所 需要 的 记录 。 


显示 出 来 的 最 关键 的 部 分 是 预计 的 语句 执行 开销 ， 这 就 是 规划 器 对 运行 该 语句 所 需 时 间 的 估 
计 (以 任意 的 开销 单位 计量 ， 但 是 通常 意味 着 磁 胡 页 面 存 取 )。 实 际 上 显示 了 两 个 数字 : 返回 
第 一 行 记录 前 的 启动 开销 ， 和 返回 所 有 记录 的 总 开销 。 对 于 大 多 数 查 询 而 襄 ， 关 心 的 是 总 开 
销 ， 但 是 ， 在 某 些 环境 下 ， 比 如 一 个 exists 子 查询 里 ， 规划 器 将 选择 最 小 启动 开销 而 不 是 
最 小 总 开销 (因为 执行 器 在 获取 一 条 记录 后 总 是 要 停 下 来 )。 同样 ， 如 果 你 用 一 条 LIMIT FA 
限制 返回 的 记录 数 ， 规划 器 会 在 最 终 的 开销 上 做 一 个 合理 的 插值 以 计算 哪个 规划 开销 最 省 。 


ANALYZE 选项 导致 查询 被 实际 执行 ， 而 不 仅仅 是 规划 。 显 示 中 加 入 了 实际 的 运行 时 间 统计 ， 
包括 在 每 个 规划 节点 内 部 花 掉 的 总 时 间 ( 以 毫秒 计 ) 和 它 实际 返回 的 行 数 。 这 些 数据 对 搜索 该 
规划 器 的 预期 是 否 和 现实 相近 很 有 帮助 。 


Important: 要 记 住 的 是 查询 实际 上 在 使 用 ANALYzE 选项 的 时 候 是 执行 的 。 尽 
E EXPLAIN 会 抛弃 任何 SELECT 返回 的 输出 ， 但 是 其 它 查 询 的 副作用 还 是 一 样 会 发 生 
的 。 如 果 你 在 INSERT , UPDATE , DELETE , CREATE TABLE AS , EXECUTE 语句 里 使 


用 EXPLAIN ANALYZE 而 且 还 不 想 让 查询 影响 数据 ， 可 以 用 下 面 的 方法 : 





BEGIN; 
EXPLAIN ANALYZE ...; 
ROLLBACK; 


只 能 声明 ANALYZE 和 versose 选项 ， 并 且 只 能 以 那 种 顺序 ， 不 能 将 选项 列表 放 在 圆 括号 中 。 
PostgreSQL 9.0 之 前 ， 只 支持 不 用 圆 括号 的 语法 。 人 们 希望 只 在 圆 括号 语法 中 支持 所 有 新 的 


选项 。 


参数 


ANALYZE 


执行 命令 并 显示 实际 运行 时 间 和 其 他 统计 。 这 个 参数 缺 省 为 FALSE o 


VERBOSE 


显示 关于 规划 的 额外 的 信息 。 特 别 的 包括 规划 树 上 的 每 个 节点 的 输出 字段 列表 ， 模式 修饰 表 
和 函数 名 ， 表 达 式 中 的 标签 变量 总 是 和 他 们 的 范围 表 别 名 在 一 起 ， 并 且 总 是 打印 统计 数据 中 
显示 的 每 个 触发 器 的 名 字 。 这 个 参数 缺 省 为 FALSE o 


COSTS 


包括 每 个 规划 节点 的 估计 局 动 成 本 和 总 成 本 的 信息 ， 也 包括 估计 行 数 和 估计 的 每 行 的 宽度 。 
这 个 参数 缺 省 为 TRUE 。 


BUFFERS 


包含 缓冲 区 使 用 的 信息 。 特 别 的 ， 包 括 共享 块 命中 、 读 、 脏 和 写 的 次 数 ， 本 地 块 命中 、 读 、 

脏 和 写 的 次 数 ， 临时 块 读 和 写 的 次 数 。 命 中 意味 着 避免 了 读 ， 因 为 块 在 需要 时 已 经 在 缓存 中 
发 现 了 。 共享 块 包含 普通 表 和 索引 的 数据 ; 本 地 块 包含 临时 表 和 索引 的 数据 ; 而 临时 块 包含 
用 于 排序 、 哈 希 、 物化 规划 节点 和 相似 情况 的 短期 工作 数据 。 脏 块 的 数量 表示 这 个 查询 改变 
的 先前 未 更 改 的 块 的 数量 ; 写 块 的 数量 表示 在 查询 处 理 的 时 候 被 这 个 后 端 驱 逐 出 缓存 的 先前 
脏 了 的 块 的 数量 。 高 级 节点 显示 的 块 的 数量 包含 所 有 它 的 子 节点 使 用 的 块 的 数量 。 在 文本 格 
式 中 ， 只 打印 非 需 值 。 这 个 参数 可 能 只 在 ANALYzE 也 启用 的 时 候 使 用 。 它 的 缺 省 为 FALSE o 


TIMING 


在 输出 中 包含 实际 启动 时 间 和 每 个 节点 花费 的 时 间 。 重 复读 系统 块 的 总 开销 会 在 某 些 系统 上 
显著 的 减缓 查询 的 速度 ， 所 以 当 需 要 只 有 实际 行 被 计算 ， 并 且 没 有 准确 时 间 时 ， 设 置 这 个 参 
数 为 FALSE 会 很 有 用 。 即使 是 用 这 个 选项 关闭 了 节点 级 别 的 时 间 ， 也 测量 整个 语句 的 运行 时 
间 。 这 个 参数 可 能 只 在 ANALYzE 也 上 启用 的 时 候 使 用 。 它 缺 省 为 TRUE o 


FORMAT 


声明 输出 格式 ， 可 以 为 TEXT XML, JSON 或 YAML。 非 文本 的 输出 包含 文本 输出 格式 相同 的 
息 ， 但 是 更 容易 被 程序 解析 。 这 个 参数 缺 省 为 TEXT o 


— 
Tli 


_boolean_ 

声明 选中 的 选项 打开 或 者 关闭 。 可 以 用 Tue, on 或 1 启用 这 个 选项 ， 用 FALSE ，oFF 或 
6 禁用 这 个 选项 。 在 假设 为 TRUE 的 情况 下 ， _boolean_ 值 也 可 以 忽略 ， 

_statement_ 


你 想 要 查看 执行 规划 的 任何 SELECT , INSERT, UPDATE , DELETE , VALUES , EXECUTE , 


DECLARE , 或 CREATE TABLE AS 语句 之 一 。 


输出 


命令 的 结果 是 从 _statement_ 选择 的 规划 的 文字 描述 ， 可 选 的 有 执行 统计 数据 的 注 
释 。Section 14.1 描 述 提供 的 信息 。 


SN a 
AA 
为 了 让 PostgreSQL 查 询 规划 器 在 优化 查询 的 时 候 做 出 合理 的 判断 ， pg statistic 数据 应 该 


为 所 有 用 于 查询 的 表 更 新 。 通 常 autovacuum daemon 会 自动 注意 这 些 。 但 是 如 果 一 个 表 最 近 
在 内 容 上 有 大 量 的 更 改 ， 你 可 能 需要 手动 ANALYZE 而 不 是 等 待 autovacuum 赶 上 变化 。 


为 了 测量 运行 时 在 执行 规划 中 每 个 节点 的 开销 ， EXPLAIN ANALYZE 的 当前 应 用 增加 查询 执行 开 
销 的 性 能 分 析 。 结 果 ， 在 一 个 查询 上 运行 EXPLAIN ANALYZE 有 时 会 比 普 通 查 询 明 显 的 花费 更 多 
的 时 间 。 超 支 的 数量 依赖 于 查询 的 本 质 和 使 用 的 平台 。 最 坏 的 情况 发 生 在 他 们 本 身 的 规划 节 
点 时 每 个 执行 需要 非常 少 的 时 间 ， 并 且 在 操作 系统 相当 慢 的 机 器 上 需要 获得 时 刻 。 


例子 


显示 一 个 对 只 有 一 个 integer 列 和 10000 行 表 的 简单 查询 的 查询 规划 : 


EXPLAIN SELECT * FROM foo; 


QUERY PLAN 


Seq Scan on foo (cost=0.00..155.00 rows=10000 width=4) 
(1 row) 


相同 的 查询 用 JSON 输 出 格式 : 


EXPLAIN (FORMAT JSON) SELECT * FROM foo; 
QUERY PLAN 


"Plan": { 
"Node Type": "Seq Scan", 
"Relation Name": "foo", 
"Alias": "foo", 
"Startup Cost": 0.00, 
"Total Cost": 155.00, 
"Plan Rows": 10000, 
"Plan Width": 4 


J 
} 
] 


(1 row) 


十 十 十 十 十 十 十 十 十 十 十 十 


如 果 存 在 一 个 索引 ， 并 且 使 用 一 个 可 应 用 索引 的 wer 条 件 的 查询 ， EXPLAIN 会 显示 不 同 的 
规划 : 


EXPLAIN SELECT * FROM foo WHERE i = 4; 


QUERY PLAN 
Index Scan using fi on foo (cost=0.00..5.98 rows=1 width=4) 
Index Cond: (i = 4) 
(2 rows) 


相同 的 查询 ， 但 是 用 YAML 格 式 : 


EXPLAIN (FORMAT YAML) SELECT * FROM foo WHERE i='4'; 
QUERY PLAN 
- Plan: 

Node Type: "Index Scan" 
Scan Direction: "Forward" 
Index Name: "fi" 
Relation Name: "foo" 
Alias: "foo" 
Startup Cost: 0.00 
Total Cost: 5.98 
Plan Rows: 1 
Plan Width: 4 
Index Cond: "(i = 4)" 

(1 row) 


二 十 十 十 十 十 十 十 二 ++ 


XML 格 式 留 给 读者 做 练习 。 


这 是 相同 的 查询 关闭 成 本 估算 : 


EXPLAIN (COSTS FALSE) SELECT * FROM foo WHERE i = 4; 


QUERY PLAN 
Index Scan using fi on foo 
Index Cond: (i = 4) 
(2 rows) 


下 面 是 一 个 使 用 了 聚集 画 数 的 查询 的 查询 规划 的 例子 : 


EXPLAIN SELECT sum(i) FROM foo WHERE i < 10; 


QUERY PLAN 
Aggregate (cost=23.93..23.93 rows=1 width=4) 
-> Index Scan using fi on foo (cost=0.00..23.92 rows=6 width=4) 
Index Cond: (i < 10) 
(3 rows) 


下 面 是 一 个 使 用 ExPLAIN EXECUTE 显示 一 个 已 预 编写 的 查询 规划 的 例子 : 


PREPARE query(int, int) AS SELECT sum(bar) FROM test 
WHERE id > $1 AND id < $2 
GROUP BY foo; 


EXPLAIN ANALYZE EXECUTE query(100, 200); 


QUERY PLAN 
HashAggregate (cost=39.53..39.53 rows=1 width=8) (actual time=0.661..0.672 rows=7 loops 
-> Index Scan using test pkey on test (cost=0.00..32.97 rows=1311 width=8) (actual t 
Index Cond: ((id > $1) AND (id < $2)) 
Total runtime: 0.851 ms 
(4 rows) 


= 





注意 这 里 显示 的 数字 ， 依 赖 于 所 包含 的 表 的 实际 内 容 。 还 请 注意 该 数字 甚至 还 有 选择 的 查询 
策略 都 有 可 能 在 各 个 PostgreSQL 版 本 之 间 不 同 ， 因 为 规划 器 在 不 断 改进 。 另外 ， ANALYZE 
命令 使 用 随机 的 采样 来 估计 数据 统计 ; 因此 ， 一 次 新 的 ANALYzE 运行 之 后 开销 估计 可 能 会 变 
化 ， 即 使 数据 的 实际 分 布 没有 改变 也 这 样 。 


兼容 性 


在 SQL 标准 中 没有 EXPLAIN 语句 。 


义 见 


ANALYZE 


FETCH 


Name 


FETCH -- 用 游标 从 查询 中 抓 取 行 


Synopsis 


FETCH [ _direction_ [ FROM | IN ] ] _cursor_name_ 
这 里 的 `_direction_ ”可 以 为 空 或 下 列 之 一 : 


NEXT 

PRIOR 

FIRST 

LAST 

ABSOLUTE _count_ 
RELATIVE _count_ 
_count_ 

ALL 

FORWARD 

FORWARD _count_ 
FORWARD ALL 
BACKWARD 
BACKWARD _count_ 
BACKWARD ALL 


摘 述 
FETCH 使 用 游标 检索 行 。 


一 个 游标 有 一 个 由 FETcH 使 用 的 相关 联 的 位 置 。 游 标的 位 置 可 以 在 查询 结果 的 第 一 行 之 前 ， 
或 者 在 结果 中 的 任意 行 ， 或 者 在 结果 的 最 后 一 行 之 后 。 刚 创建 完 之 后 ， 游 标 是 放 在 第 一 行 之 
前 的 。 在 抓 取 了 一 些 行 之 后 ， 游 标 放 在 检索 到 的 最 后 一 行 上 。 如 果 FETcH 抓 完了 所 有 可 用 
行 ， 那么 它 就 停 在 最 后 一 行 后 面 ， 或 者 在 反 向 抓 取 的 情况 下 是 停 在 第 一 行 前 面 。 FETCH ALL 
或 FETCH BACKWARD ALL 将 总 是 把 游标 的 位 置 放 在 最 后 一 行 或 者 在 第 一 行 前 面 。 


NEXT ， PRIOR ，FIRST ，LAST ，ABSOLUTE ，RELATIVE 形式 在 恰当 地 移动 游标 之 后 抓 取 一 个 
行 。 如 果 没 有 数据 行 了 ， 那 么 返回 一 个 空 的 结果 ， 此 时 游标 就 会 停 在 查询 结果 的 最 后 一 行 之 
后 或 者 第 一 行 之 前 。 


FORWARD 和 BACKWARD 形式 在 向 前 或 者 向 后 移动 的 过 程 中 抓 取 指定 的 行 数 ， 然后 把 游标 定位 在 
最 后 返回 的 行 上 ; 或 者 是 ， 如 果 _count ”大 于 可 用 的 行 数 ， 则 在 所 有 行 之 前 或 之 后 。 


RELATIVE © , FORWARD © , BACKWARD 6 都 要 求 在 不 移动 游标 的 前 提 下 抓 取 当前 行 ， 也 就 是 重 
新 抓 取 最 近 刚 刚 抓 取 过 的 行 。 除非 游标 定位 在 第 一 行 之 前 或 者 最 后 一 行 之 后 ， 这 个 动作 都 应 
该 成 功 ， 而 在 那 两 种 情况 下 ， 不 返回 任何 行 。 


Note: 本 页 描述 在 SQL 命令 级 别 的 游标 的 使 用 。 如 果 你 党 试 在 PL/pgSQL 里 使 用 游标 ， 那 
么 规则 是 不 同 的 ， 参 阅 Section 40.7。 


_direction_ 

_direction. 定义 抓 取 的 方向 和 抓 取 的 行 数 。 它 可 以 是 下 述 之 一 : 
NEXT 

抓 取 下 一 行 ( 缺 省 )。 

PRIOR 

抓 取 前 面 一 行 。 

FIRST 

抓 取 查询 的 第 一 行 (和 ABsoLuTE 1 相同 )。 
LAST 

抓 取 查询 的 最 后 一 行 (和 ABsoLuTE -1 相同 )。 
ABSOLUTE _count_ 


抓 取 查询 中 第 _count_ 行 ， 或 者 如 果 count 为 负 就 从 查询 结果 末尾 抓 取 第 abs(`` count_ ) 
行 。 如 果 _count 超出 了 范围 ， 那么 定位 在 第 一 行 之 前 和 最 后 一 行 之 后 的 位 置 ; 特别 
是 ABSOLUTE 0 定位 在 第 一 行 之 前 。 


RELATIVE _count_ 


抓 取 随后 的 第 _count_ 47, KRAMER count. 为 负 就 抓 取 前 面 的 第 abs(`_count_) 行 。 如 
果 有 数据 的 话 ， RELATIVE 9 重新 抓 取 当 前 行 。 


_count_ 


抓 取 随后 的 _count_ 行 (和 FORWARD _count_ 一 样 )。 


ALL 


抓 取 所 有 剩余 的 行 (和 FoRwARD ALL 一 样 )。 


FORWARD 


抓 取 下 一 行 (和 next 一 样 )。 


FORWARD _count_ 

抓 取 随后 的 _count_ 行 。 FoRwARD 9 重新 抓 取 当 前 行 。 

FORWARD ALL 

抓 取 所 有 剩余 行 。 

BACKWARD 

抓 取 前 面 一 行 (和 prior 一 样 )。 

BACKWARD _count_ 

抓 取 前 面 的 _count ” 行 (向 后 扫描 )。 BAckwARDp o 重新 抓 取 当前 行 。 
BACKWARD ALL 


抓 取 所 有 前 面 的 行 (向 后 扫描 )。 


_count_ 


count. 可 能 是 一 个 有 符号 的 整数 常量 ， 决定 要 抓 取 的 行 数 和 方向 。 对 
于 Forward 和 BACKWARD 的 情况 ， 声明 一 个 带 负 号 的 _count_ 等 效 于 改变 
FORWARD 和 BACKWARD 的 方向 。 


_Cursor_name_ 


一 个 打开 的 游标 的 名 称 。 


输出 
成 功 完成 时 ， 一 个 FETcH 命令 返回 一 个 形 如 下 面 的 标记 


FETCH _count_ 


这 里 的 count. 是 抓 取 的 行 数 (可 能 是 需 )。 请 注意 在 psql 里 ， 命 令 标 签 实际 上 不 会 显示 ， 
为 psql 用 抓 取 的 行 数 代替 了 。 


WN e e A 
) 王 局 


如 果 你 想 使 用 FETcH next 之 外 的 任何 FETcH 变种 ， 或 者 是 带 负数 计数 的 FETCH Forward, Ap 
么 定义 游标 的 时 候 应 该 带 上 scRoLL 选项 。 对 于 简单 的 查询 ，PostgreSQL 会 允许 那些 没 
SCROLL 选项 定义 的 游标 也 可 以 反 向 抓 取 ， 但 是 最 好 不 要 依赖 这 个 行为 。 如 果 游 标定 义 了 
NO SCROLL ， 那 么 不 允许 反 向 抓 取 。 


ABSOLUTE 抓 取 不 会 比 用 相对 位 移 移 动 到 需要 的 数据 行 更 快 : 因为 下 层 的 实现 必须 通 历 所 有 中 
间 的 行 。 负 数 的 绝对 抓 取 甚至 更 糟糕 : 查询 必须 一 直 读 到 结尾 才能 找到 最 后 一 行 ， 然 后 从 那 


里 开始 反 向 通 历 。 不 过 ， 回 退 到 查询 开头 (比如 FETcH ABSOLUTE o ) 很 快 。 


使 用 DECLARE 语 名 定义 一 个 游标 。MOVE 语句 改变 游标 位 置 而 不 检索 数据 。 


例子 
下 面 的 例子 用 一 个 游标 跨 过 一 个 表 。 


BEGIN WORK; 


-- 建立 一 个 游标 : 
DECLARE liahona SCROLL CURSOR FOR SELECT * FROM films; 


-- 抓 取 头 5 行 到 游标 liahona 里 : 
FETCH FORWARD 5 FROM liahona; 


code | title | did | date prod | kind | len 
下 本 ES $2 SO Sara on aaa a SoS Ses Ss eee em aos ce ertammosSse 
BL101 | The Third Man | 101 | 1949-12-23 | Drama | 01:44 
BL102 | The African Queen | 101 | 1951-08-11 | Romantic | 01:43 
JL201 | Une Femme est une Femme | 102 | 1961-03-12 | Romantic | 01:25 
P_301 | Vertigo | 103 | 1958-11-14 | Action | 02:08 
P_302 | Becket | 103 | 1964-02-03 | Drama | 02:28 
-- 抓 取 前 面 行 : 

FETCH PRIOR FROM liahona; 

code | title | did | date_prod | kind | len 

本 Po 

P_301 | Vertigo | 103 | 1958-11-14 | Action | 02:08 


-- 关闭 游标 并 提交 事务 : 
CLOSE liahona; 
COMMIT WORK; 


RANE 


SQL 标准 定义 的 FETcH RAF RRA TR. AERA Ferch 变种 是 把 结果 数据 


像 sELEcT 结果 那样 返回 ， 而 不 是 把 它 放 在 属 主 变量 里 。 除 了 这 点 之 外 ， 
完全 向 前 兼容 。 


FETCH 和 SQL 标准 


涉及 FoRwARD 和 BACKWARD 的 Fetch 形式 ， 包括 FETCH _count_ 和 FETCH aLL 形式 (此 


时 FORWARD 是 隐 含 的 )， 是 PostgreSQL 的 扩展 。 


SQL 标准 只 允许 游标 前 面 有 FRoM ， 可 选 的 IN ， 或 者 把 它们 都 省 去 ， 是 一 个 扩展 。 


义 见 


CLOSE, DECLARE, MOVE 


GRANT 


Name 


GRANT -- 赋予 访问 权限 


Synopsis 


GRANT { { SELECT | INSERT | UPDATE | DELETE | TRUNCATE | REFERENCES | TRIGGER } 
[，...] | ALL [ PRIVILEGES ] } 


ON { [ TABLE ] _table_name_ [, ...] 
| ALL TABLES IN SCHEMA _schema_name_ [, ...] } 
TO { [ GROUP ] _role name | PUBLIC } [, ...] [ WITH GRANT OPTION ] 
GRANT { { SELECT | INSERT | UPDATE | REFERENCES } ( _column_name_ [, ...] ) 
[, ...] | ALL [ PRIVILEGES ] ( _column_name_ [, ...] ) } 


ON [ TABLE ] _table_name_ [, ...] 
TO { [ GROUP ] _role_name_ | PUBLIC } [, ...] [ WITH GRANT OPTION ] 
GRANT { { USAGE | SELECT | UPDATE } 
[，...] | ALL [ PRIVILEGES ] } 
ON { SEQUENCE _sequence_name_ [, ...] 
| ALL SEQUENCES IN SCHEMA _schema_name_ [, ... 
TO { [ GROUP ] _role_name_ | PUBLIC } [, ...] [ WITH GRANT OPTION ] 
GRANT { { CREATE | CONNECT | TEMPORARY | TEMP } [, ...] 
ON DATABASE _database_name_ [, ...] 
TO { [ GROUP ] _role_name_ | PUBLIC } [, ...] [ 


| ALL [ PRIVILEGES ] } 
WITH GRANT OPTION ] 


GRANT { USAGE | ALL [ PRIVILEGES ] } 

ON DOMAIN _domain_name_ [, ...] 

TO { [ GROUP ] _role_name_ | PUBLIC } [, ...] [WITH GRANT OPTION ] 
GRANT { USAGE | ALL [ PRIVILEGES ] } 

ON FOREIGN DATA WRAPPER _fdw_name_ [, ...] 

TO { [ GROUP ] _role_name_ | PUBLIC } [, ...] [ WITH GRANT OPTION ] 
GRANT { USAGE | ALL [ PRIVILEGES ] } 

ON FOREIGN SERVER _server_name_ [, ...] 

TO { [ GROUP ] _role_name_ | PUBLIC } [, ...] [ WITH GRANT OPTION ] 
GRANT { EXECUTE | ALL [ PRIVILEGES ] } 

ON { FUNCTION _function_name_ ( [ [ _argmode_ ] [ 

| ALL FUNCTIONS IN SCHEMA _schema_name_ [, 
TO { [ GROUP ] _role_name_ | PUBLIC } [, ...] [ 


arg_name_ ] 


[, 


arg_type TIT) 





WITH GRANT OPTION ] 


GRANT { USAGE | ALL [ PRIVILEGES ] } 
ON LANGUAGE _lang_name_ [, ...] 
TO { [ GROUP ] _role_name_ | PUBLIC } [, ...] [ WITH GRANT OPTION ] 
GRANT { { SELECT | UPDATE } [, ...] 
ON LARGE OBJECT _loid_ [, ...] 


| ALL [ PRIVILEGES ] } 


TO { [ GROUP ] _role_name_ | PUBLIC } [, 


GRANT { { CREATE | USAGE } [, ...] 
ON SCHEMA _schema_name_ [, ...] 
TO { [ GROUP ] _role_name_ | PUBLIC } [, 


GRANT { CREATE | ALL [ PRIVILEGES ] } 
ON TABLESPACE _tablespace_name_ [, ...] 
TO { [ GROUP ] _role_name_ | PUBLIC } [, 


GRANT { USAGE | ALL [ PRIVILEGES ] } 
ON TYPE _type_name_ [, ...] 
TO { [ GROUP ] _role_name_ | PUBLIC } [, 


GRANT _role_name_ [, ...] TO _role_name_ [, 


aa a | 


t 


...] [ WITH GRANT OPTION ] 


| ALL [ PRIVILEGES ] } 


...] [ WITH GRANT OPTION ] 


...] [ WITH GRANT OPTION ] 


...] [ WITH GRANT OPTION ] 


...] [ WITH ADMIN OPTION ] 





GRANT 命令 有 两 个 基本 变种 : 一 个 变种 是 给 数据 库 对 象 ( 表 、 字 段 、 视 图 、 外 部 表 、 序 列 、 数 
据 库 、 外 部 数据 封装 器 、 外 部 服务 器 、 画 数 、 过 程 语言 、 模式 、 表 空间 ) 赋 予 权限 ; 一 个 变种 
是 赋予 一 个 角色 中 的 成 员 关 系 。 这 些 变种 在 很 多 方面 都 非常 类 似 ， 但 是 它们 之 间 的 区 别 也 有 
足够 理由 来 分 开 描 述 。 


在 数据 库 对 象 上 的 GRANT 


这 个 变种 的 GRANT 命 命 在 数据 库 对 象 上 给 一 个 或 多 个 角色 授予 特定 的 权限 。 这 些 权 限 追 加 到 
已 经 授予 的 权限 上 。 


也 有 一 个 选项 赋予 一 个 或 多 个 模式 内 的 相同 类 型 的 所 有 对 象 权 限 。 这 个 功能 当前 只 支持 表 ， 
序列 和 画 数 (但 请 注意 ALL TABLES 被 认为 包含 视图 和 外 部 表 ) 。 


关键 字 PuBLIC 表示 该 权限 要 赋予 所 有 和 角色， 包括 那些 以 后 可 能 创建 的 用 户 。 Puc 可 以 看 
做 是 一 个 隐 合 定义 好 的 组 ， 它 总 是 包括 所 有 和 角色。 任何 特定 的 角色 都 将 拥有 直接 赋予 他 / 它 的 
权限 ， 加 上 他 / 它 所 处 的 任何 组 ， 以 及 再 加 上 赋予 PugLic 的 权限 的 总 和 。 


如 果 声 明了 WITH GRANT oPTION ， 那 么 权限 的 接收 者 也 可 以 将 此 权限 赋予 他 人 ， 否则 就 不 能 授 
权 他 人 。 这 个 选项 不 能 赋予 PUBLIC o 


对 于 对 象 的 所 有 者 (通常 就 是 创建 者 ) 而 言 ， 没 有 什么 权限 需要 赋予 ， 因 为 所 有 者 缺 省 就 持 有 所 
有 权限 。 不 过 ， 所 有 者 出 于 安全 考虑 可 以 选择 废弃 一 些 他 自己 的 权限 。 


删除 一 个 对 象 的 权力 ， 或 者 是 任意 修改 它 的 权力 都 不 是 可 赋予 的 权限 ; 它 是 创建 者 固有 的 ， 
并 且 不 能 赋予 或 撤销 。 〈 然 而， 一 个 类 似 的 影响 可 以 通过 赋予 或 撤销 拥有 这 个 对 象 的 角色 的 
成 员 关 系 来 获得 ; 参阅 下 文 。) 所 有 者 也 隐 含 地 拥有 该 对 象 的 所 有 授权 选项 。 


PostgreSQL 给 PugLIc 对 象 的 某 些 类 型 赋予 缺 省 的 权限 。 在 表 、 字 段 、 模 式 或 表 空 间 上 缺 省 
会 赋予 PuL 权限 。 对 于 其 他 类 型 ， 赋予 pur 以 下 缺 省 的 权限 : 数据 库 为 ”CONNECT 

和 CREATE TEMP TABLE 权限 ; 图 数 为 execute 权限 ; BA usace 权限 。 对 象 所 有 者 当然 可 
以 revoke 缺 省 的 或 明确 赋予 的 权限 。 出 于 最 大 安全 性 考虑 ， 在 创建 该 对 象 的 同一 个 事务 中 发 
出 REVOKE 就 不 会 打开 给 别 的 用 户 使 用 该 对 象 的 窗口 。 同 样 ， 这 些 缺 省 初始 化 权限 设置 可 以 

使 用 ALTER DEFAULT PRIVILEGES 命 令 改 变 。 


可 能 的 权限 有 : 
SELECT 


允许 对 声明 的 表 、 视 图 、 序 列 SELECT 任 意 字段 或 指定 字段 列表 。 还 允许 做 COPY 的 源 。 这 
个 权限 也 需要 引用 UPDATE 或 DELETE 现 存 的 字段 值 。 对 于 序列 而 言 ， 这 个 权限 还 允许 使 用 
currval 画 数 。 对 于 大 对 象 ， 这 个 权限 允许 读 对 象 。 


INSERT 


允许 向 声明 的 表 INSERT 一 个 新 行 。 如 果 列 出 了 指定 的 字段 ， 那么 只 有 列 出 的 字段 被 指派 
给 INSERT 命令 〈 其 他 字段 因此 接受 缺 省 的 值 ) 。 同时 还 允许 做 COPY。 


UPDATE 


允许 对 声明 的 表 中 任意 字段 或 指定 的 字段 列表 做 UPDATE。 实际 上 ， 任 何 重要 的 uppATE 命令 
也 需要 seLEcT 权限 ， 因为 必须 引用 表 字 段 决 定 要 更 新 哪个 行 ， 和 /或 为 字段 计算 新 值 。 

SELECT ... FOR UPDATE 和 SELECT ... FOR SHARE 也 至 少 在 一 个 字段 上 要 求 这 个 权限 ， 除 

了 sELECT 权限 之 外 。 上 比如 ， 这 个 权限 允许 使 用 nextval 和 setval WE, 对 于 大 对 象 ， 这 个 
权限 允许 写 或 截断 对 象 。 


DELETE 


允许 从 声明 的 表 中 DELETE 行 。 实 际 上 ， 任 何 重要 的 peLETE 命令 也 需要 sELECT 权限 ， 因 为 
必须 引用 表 字 段 决定 要 删除 哪个 行 。 


TRUNCATE 
允许 在 指定 的 表 上 TRUNCATE。 
REFERENCES 


要 创建 一 个 外 键 约束 ， 你 必须 在 参考 字段 和 被 参考 字段 上 都 拥有 这 个 权限 。 该 权限 可 能 赋予 
了 表 的 所 有 字段 ， 或 只 是 赋予 了 指定 的 字段 。 


TRIGGER 

允许 在 声明 表 上 创建 触发 器 (参见 CREATE TRIGGER 语 句 )。 
CREATE 

对 于 数据 库 ， 人 允许 在 该 数据 库 里 创建 新 的 模式 。 


对 于 模式 ， 人 允许 在 该 模式 中 创建 新 的 对 象 。 要 重 命 名 一 个 现 有 对 象 ， 你 必需 拥有 该 对 象 并 且 
对 包含 该 对 象 的 模式 拥有 这 个 权限 。 


对 于 表 空 间 ， 人 允许 在 其 中 创建 表 ， 索 引 和 临时 文件 ， 以 及 人 允许 创建 数据 库 的 时 候 把 该 表 空间 
指定 为 其 缺 省 表 空 间 。 请 注意 ， 搬 销 这 个 权限 不 会 改变 现 有 对 象 的 存放 位 置 。 


CONNECT 


允许 用 户 连 接 到 指定 的 数据 库 。 该 权限 将 在 连接 启动 时 检查 (除了 检查 pg_hba.conf 中 的 任何 
限制 之 外 )。 


TEMPORARY TEMP 
人 允许 在 使 用 指定 数据 库 的 时 候 创建 临时 表 
EXECUTE 


允许 使 用 指定 的 函数 并 且 可 以 使 用 任何 利用 这 些 函 数 实现 的 操作 符 。 这 是 适用 于 函数 的 唯一 
权限 。 该 语法 同样 适用 于 聚集 画 数 。 


USAGE 


对 于 过 程 语言 ， 人 允许 使 用 指定 过 程 语言 创建 该 语言 的 函数 。 这 是 适用 于 过 程 语 言 的 唯一 权 
BR 

对 于 模式 ， 人 允许 访问 包含 在 指定 模式 中 的 对 象 (假设 该 对 象 的 所 有 权 要 求 同 样 也 设置 了 )。 最 
终 这 些 就 允许 了 权限 接受 者 "查询 "模式 中 的 对 象 。 没 有 这 个 权限 仍然 可 以 看 见 这 些 对 象 的 名 字 
(比如 通过 查询 系统 视图 )。 同 样 ， 撤 销 该 权限 之 后 ， 现 有 的 后 端 可 能 有 在 查找 之 前 就 执行 了 的 
语句 ， 因此 这 不 是 一 个 很 安全 的 限制 对 象 访问 的 方法 。 

对 于 序列 ， 该 权限 允许 使 用 currval 和 nextval WRX. 

对 于 类 型 和 域 ， 该 权限 人 允许 在 创建 表 、 画 数 和 其 他 模式 对 象 时 使 用 类 型 或 域 。 (请 注意 ， 它 
不 控制 类 型 的 一 般 " 使 用 "， 例 如 显示 在 查询 中 的 该 类 型 的 值 。 它 只 防止 依赖 于 该 类 型 的 对 象 
被 创建 。 该 权限 的 主要 目的 是 控制 哪个 用 户 在 类 型 上 创建 依赖 ， 该 依赖 会 防止 用 户 稍 后 改变 
类 型 。) 

对 于 外 部 数据 封装 器 ， 该 权限 使 权限 接受 者 能 够 使 用 那个 外 部 数据 封装 器 创建 新 的 服务 器 。 
对 于 服务 器 ， 该 权限 使 权限 接受 者 能 够 使 用 该 服务 器 创建 外 部 表 ， 并 且 也 能 创建 、 修改 或 删 
除 他 自己 的 用 户 的 与 该 服务 器 相关 的 用 户 映射 。 


ALL PRIVILEGES 


一 次 性 给 予 所 有 可 以 赋予 的 权限 。 PRIVILEGES 关键 字 在 PostgreSQL 里 是 可 选 的 ， 但 是 严格 
的 SQL 要 求 有 这 个 关键 字 。 


其 它 命 爸 要 求 的 权限 都 在 相应 的 命 命 的 参考 页 上 列 出 。 


角色 上 的 GRANT 


这 个 变种 的 GRANT 命令 把 一 个 角色 的 成 员 关 系 赋予 一 个 或 多 个 其 它 角 色 。 角色 里 的 成 员 关 系 
很 重要 ， 因 为 它 会 将 赋予 该 角色 的 权限 传播 给 所 有 该 角色 的 成 员 。 


如 果 声 明了 wITH ADMIN oPTION ， 那 么 该 成 员 随 后 就 可 以 将 角色 的 成 员 关 系 赋予 其 它 角 色 ， 以 
及 撤销 其 它 角色 的 成 员 关 系 。 如 果 没 有 admin 选项 ， 普 通用 户 就 不 能 这 么 做 。 不 过 ， 数据 库 
超级 用 户 可 以 给 任何 人 赋 与 或 者 撤销 任何 角色 的 任何 成 员 关 系 。 拥 有 cREATEROLE 权限 的 角色 
可 以 赋予 或 者 撤销 任何 非 超级 用 户 角色 的 成 员 关 系 。 


与 权限 不 同 ， 角 色 的 成 员 关 系 不 能 被 赋予 puBLIc 。 需 要 注意 的 是 ， 这 种 形式 的 命令 不 允许 使 
用 无 意义 的 croup 关键 字 。 


= a 


$a 


REVOKE 命 令 用 于 删除 访问 权限 。 


PostgreSQL 8.1 以 来 ， 用 户 和 组 的 概念 统一 为 角色 。 因此 不 再 需要 使 用 关键 字 croup 来 确 
定 接受 者 是 一 个 用 户 还 是 一 个 组 。 仍然 允许 在 命令 中 出 现 GRouP ， 但 这 是 一 个 噪声 字 。 


一 个 用 户 可 以 他 有 相应 权限 的 字段 上 执行 SELECT ，INSERT 等 ， 该 权限 是 在 指定 字段 或 整个 表 
+, 在 表 级 别 授予 权限 然后 从 一 个 字段 上 撤销 该 权限 将 不 会 做 你 希望 发 生 的 事情 : 表 级 别 的 
授权 不 受 字段 级 别 操作 的 影响 。 


如 果 非 对 象 所 有 者 企图 在 对 象 上 GRANT 权限 ， 而 该 用 户 没 有 该 对 象 上 指定 的 权限 ， 那么 命令 
将 立即 失败 。 只 要 有 某 些 可 用 的 权限 ， 该 命令 就 会 继续 ， 但 是 它 只 授予 那些 该 用 户 有 授权 选 
项 的 权限 。 如 果 没 有 可 用 的 授权 选项 ， 那 么 GRANT ALL PRIVILEGES 形式 将 发 出 一 个 警告 信 
A, 其 它 命令 形式 将 发 出 在 命令 中 提 到 的 、 但 是 没有 授权 选项 的 那些 权限 相关 的 警告 信息 。 
这 些 语 句 原 则 上 也 适用 于 对 象 所 有 者 ， 但 是 因为 所 有 者 总 是 被 认为 拥有 所 有 授权 选项 ， 所 以 
这 种 情况 永远 不 会 发 生 在 所 有 者 身上 。 


要 注意 数据 库 超级 用 户 可 以 访问 所 有 对 象 ， 而 不 会 受 对 象 的 权限 设置 影响 。 这 个 特点 类 似 
Unix 系统 的 root 的 权限 。 和 root 一 样 ， 除 了 必要 的 情况 ， 总 是 以 超级 用 户 身份 进行 操作 
是 不 明智 的 做 法 。 


如 果 一 个 超级 用 户 选 择 发 出 一 个 GRANT 或 REVOKE 命令 ， 那 么 这 条 命令 将 是 以 被 影响 对 象 的 
所 有 者 的 形式 执行 的 。 特 别 是 ， 通过 这 种 方法 赋 与 的 权限 将 显得 好 像 是 由 对 象 所 有 者 赋 与 
的 。 对 于 角色 成 员 关 系 ， 成 员 关 系 的 赋 与 就 会 像 是 通过 包含 角色 自己 赋 与 的 一 祥 。 


GRANT 和 REVOKE 也 可 以 不 由 被 影响 对 象 的 所 有 者 来 执行 ， 而 是 由 拥有 该 对 象 的 角色 的 一 个 
成 员 来 执行 ， 或 者 是 一 个 在 该 对 象 上 持 有 WITH GRANT option 权限 的 角色 的 成 员 。 在 这 种 情况 
F, 该 权限 将 被 纪录 为 是 由 实际 拥有 该 对 象 或 者 持 有 with GRANT option 权限 的 对 象 赋 与 
的 。 比 如 ， 如 果 表 ta RAB WA, 并 且 ui 是 g 的 一 个 成 员 ， 然 后 u 可 以 把 ta 的 
权限 赋予 uz ， 但 是 这 些 权限 将 表现 为 是 由 g 直接 赋予 的 。 任何 g1 角色 的 成 员 都 可 以 在 之 
后 撤销 这 些 权限 。 


如 果 执 行 GRANT 的 角色 所 持 有 的 所 需 权限 是 通过 角色 成 员 关 系 间接 获得 的 ， 那么 究竟 是 那个 
角色 将 被 纪录 为 赋予 权限 的 角色 就 是 未 知 的 。 在 这 种 情况 下 ， 最 好 的 方法 是 使 用 SET ROLE 成 
为 你 想 执行 GRANT 命令 的 指定 角色 。 


在 表 上 赋予 的 权限 不 会 自动 传播 到 该 表 使 用 的 序列 上 ， 和 包括 sera 字段 上 的 序列 。 必须 单独 
设置 序列 的 权限 。 


使 用 psql 的 \dp 命令 获取 表 和 字段 的 现存 权限 的 有 关 的 信息 。 例 如 : 


=> \dp mytable 
Access privileges 


Schema | Name | Type | Access privileges | Column access privileges 
Se eee ee e 
public | mytable | table | miriam=arwdDxt/miriam | colt: 

: =r/miriam : miriam_rw=rw/miriam 


: admin=arw/miriam 
(1 row) 


\dp 显示 的 条 目 解 释 如 下 : 


rolename=xxxx -- 赋予 一 个 角色 的 权限 
=XXXX -- 赋予 PUBLIC 的 权限 


yr -- SELECT ("i") 
w -- UPDATE ("5") 

a -- INSERT ("3820") 

d -- DELETE 

D -- TRUNCATE 

x -- REFERENCES 

t -- TRIGGER 

X -- EXECUTE 

U -- USAGE 

C -- CREATE 

c -- CONNECT 

T -- TEMPORARY 

t -- ALL PRIVILEGES (用 于 表 ， 用 于 其 他 对 象 时 不 同 ) 
* -- 给 前 面 权限 的 授权 选项 


/yyyy -- 授 出 这 个 权限 的 角色 


arwdDx 


HÈ miriam 在 建 完 mytable 表 之 后 再 做 下 面 的 语句 ， 就 可 以 得 到 上 面 例子 的 结果 : 


GRANT SELECT ON mytable TO PUBLIC; 
GRANT SELECT, UPDATE, INSERT ON mytable TO admin; 
GRANT SELECT (coli), UPDATE (col1) ON mytable TO miriam_rw; 


对 于 非 表 的 对 象 ， 可 以 使 用 \d 命令 显示 他 们 的 权限 。 


如 果 一 个 给 定 的 对 象 的 "Access privileges" 字 段 是 空 的 ， 这 意味 着 该 对 象 有 人 缺 省 权限 (也 就 是 
说 ， 它 的 权限 字段 是 NULL)。 缺 省 权限 总 是 包括 所 有 者 的 所 有 权限 ， 以 及 根据 对 象 的 不 同 ， 
可 能 包含 一 些 给 pu 的 权限 。 对 象 上 第 一 个 GRANT 或 Revoke 将 实例 化 这 个 缺 省 权限 ( 比 
如 ， 产生 {miriam=arwdDxt/miriam} ) 然后 根据 每 次 特定 的 需求 修改 它 。 相似 的 ， "Column 
access privileges" 中 的 记录 只 为 非 缺 省 权限 字段 。 (请 注意 : 为 了 这 个 目的 ， "default 
privileges" 总 是 意味 着 该 对 象 类 型 的 内 建 缺 省 权限 。 受 ALTER DEFAULT PRIVILEGES 命令 影响 权 
限 的 对 象 总 是 和 一 个 包括 ALTER 影响 的 明确 权限 记录 一 起 显示 。 ) 


请 注意 所 有 者 的 隐 含 授权 选项 没有 在 显示 出 来 的 访问 权限 里 标记 出 来 。 只 有 在 授权 选项 明确 
地 授予 某 人 之 后 ， 才 会 显示 一 个 * 。 


例子 
EK films 的 插入 权限 赋予 所 有 用 户 : 


GRANT INSERT ON films TO PUBLIC; 


赋予 用 户 manuel 对 视图 kinds 的 所 有 权限 : 


GRANT ALL PRIVILEGES ON kinds TO manuel; 


请 注意 ， 如 果 上 面 的 命令 由 超级 用 户 或 者 kind 的 所 有 者 执行 ， 那 么 它 实际 上 会 赋予 所 有 权 
PR, 如 果 由 其 他 人 执行 ， 那 么 它 会 赋予 这 个 "其 他 人 "拥有 授权 选项 的 所 有 权限 。 


把 角色 admins 的 成 员 关 系 赋 与 用 户 joe : 


GRANT admins TO joe; 


DSS 
兼容 性 
根据 SQL 标准 ， 在 ALL PRIVILEGES 里 的 PRIVILEGES 关键 字 是 必须 的 。 SQL 标准 不 支持 在 一 
条 命令 里 对 多 个 表 设 置 权限 。 


PostgreSQL 人 允许 一 个 对 象 所 有 者 撤销 它 自 己 的 普通 权限 : 比如 ， 一 个 表 所 有 者 可 以 让 自己 对 
这 个 表 是 只 读 的 ， 方 法 是 撤销 自己 的 INSERT, UPDATE, DELETE ,和 TRUNCATE 权限 。 根 据 
SQL 标准 ， 这 是 不 可 能 的 。 原 因 是 PostgreSQL 把 所 有 者 的 权限 当 作 由 所 有 者 给 自己 赋予 

的 ; 因此 也 可 以 撤销 他 们 。 在 SQL 标准 里 ， 所 有 者 的 权限 是 假设 为 " SYSTEM" 实 体 赋 予 
的 。 因为 所 有 者 不 是 " SYSTEM"， 所 以 他 不 能 撤销 这 些 权限 。 


根据 SQL 标准 ， 授 权 选 项 可 以 授予 pu ; PostgreSQL 只 支持 授予 授权 选项 给 角色 。 
SQL 标准 对 其 它 类 型 的 对 象 提供 了 一 个 usace 权限 : 字符 集 、 校 勘 、 转 换 。 


在 SQL 标准 中 ， 序 列 只 有 一 个 usAGE 权限 ， 该 权限 控制 NExT VALUE FoR 表达 式 的 使 用 ， 该 表 
达 式 相当 于 PostgreSQL 中 的 nextval ENR. Fret BR sELECT 和 UPDATE 是 PostgreSQL 的 扩 
展 。 序 列 usas 权限 应 用 到 currval 本 数 也 是 一 个 PostgreSQL 扩 展 (就 像 画 数 本 身 ) 。 


在 数据 库 、 表 空间 、 模 式 、 语 言 上 的 权限 是 PostgreSQL 扩 展 。 


义 见 


REVOKE, ALTER DEFAULT PRIVILEGES 


INSERT 


Name 


INSERT -- 在 表 中 创建 新 行 


Synopsis 





[ WITH [ RECURSIVE ] _with_query_ [, ...] ] 

INSERT INTO _table_name_ [ ( _column_name_ [, ...] ) ] 
{ DEFAULT VALUES | VALUES ( { _expression_ | DEFAULT } [, ...] ) [, ...] | _query_ } 
[ RETURNING * | _output_expression_ [ [ AS ] _output_name_ ] [, ...] ] 


| 7 
描述 


INSERT 向 表 中 插入 新 行 。 可 以 一 次 插入 用 值 表达 式 声明 的 一 行 或 多 行 ， 或 者 一 个 查询 结果 表 
现 出 来 的 需 行 或 多 个 行 。 


目标 列表 中 的 列 /字段 可 以 按 任何 顺序 排列 。 如 果 完 全 没有 列 出 任何 字段 名 ， 那 么 缺 省 是 全 部 
字段 ， 顺序 是 按照 表 声 明 的 时 候 的 顺序 ; 如 果 vaus FORA query 里面 只 提供 

了 AN_ 个 字段 ， 那 么 就 是 头 _N_ 个 字段 。 vALUES 子 句 或 者 query 提供 的 数值 是 以 从 左 到 
右 的 方式 与 明确 或 者 隐 伟 的 字段 列表 关联 的 。 


每 个 没有 在 明确 或 者 隐 含 的 字段 列表 中 出 现 的 字段 都 将 填充 缺 省 值 ， 如 果 有 声明 的 缺 省 值 则 
用 声明 的 那个 ， 如 果 没 有 则 用 NULL. 
如 果 每 个 字段 的 表达 式 不 是 正确 的 数据 类 型 ， 系 统 将 试图 进行 自动 的 类 型 转换 。 


可 选 的 RETURNING 子 句 将 导致 INSERT 计算 和 返回 实际 插入 的 行 ， 它 主要 用 于 获取 缺 省 的 计算 
值 (比如 序列 值 )， 不 过 ， 任 何 使 用 该 表 字 段 的 表达 式 都 是 允许 的 。 RETURNING 列表 的 语法 都 
与 secect 的 输出 列表 相同 。 


要 想 向 表 中 插入 数据 ， 你 必须 有 INsERT 权限 。 如 果 指 定 了 一 个 字段 列表 ， 那么 只 需要 在 列表 
字段 上 的 insert 权限 。 使 用 RETURNING 子 句 需要 要 在 RETURNING 中 提 到 的 所 有 字段 上 

的 SELECT 权限 。 如 果 你 使 用 了 query. 子 句 插入 来 自 查 询 里 的 数据 行 ， 你 还 需要 拥有 在 查 
询 里 使 用 的 表 或 字段 的 SELECT 权限 。 


参数 


_with_query_ 


WITH 子 句 人 允许 声明 一 个 或 多 个 可 以 在 insert 查询 中 通过 名 字 引 用 的 子 查询 。 参 阅 Section 
7.8 和 SELECT 获取 详细 信息 。 


_query_ ( SELECT 语句 ) 也 包含 一 个 with 子 句 是 可 能 的 。 在 这 种 情况 下 ， 两 套 
_with_query_ 都 可 以 在 _query ”中 引用 ， 但 是 第 二 个 优先 ， 因 为 它 伐 套 更 紧密 。 


_table_name_ 


现存 表 的 名 称 ( 可 以 有 模式 修饰 )。 


_column_name_ 


通过 table name 命名 的 表 中 的 字段 名 。 必 要 时 ， 字段 名 可 以 有 子 字段 名 或 者 数组 下 标 修 
饰 。 向 一 个 复合 类 型 中 的 某 些 字段 插 和 人 数据 的 话 ， 其 它 字段 将 是 NULL. 


DEFAULT VALUES 
所 有 字段 都 会 用 它们 的 缺 省 值 填充 。 
_expression_ 


赋予 对 应 的 column 的 一 个 有 效 表 达 式 或 值 。 
DEFAULT 

对 应 的 column 将 被 它 的 缺 省 值 填 充 。 
—query_ 


一 个 查询 ( SELECT 语句 )， 它 提供 插入 的 数据 行 。 请 参考 SELECT 语句 获取 语法 描述 。 


_output_expression_ 


INSERT 命令 在 每 一 行 都 被 插入 之 后 用 于 计算 输出 结果 的 表达 式 。 该 表达 式 可 以 使 用 通 
过 _table_name_ 命名 的 表 的 的 任意 字段 。 可 以 使 用 * 返回 被 插入 行 的 所 有 字段 。 


_output_name_ 

一 个 字段 的 输出 名 称 。 

人 

输出 

成 功 完 成 后 ， 一 条 insert 命令 返回 一 个 下 面 形式 的 命令 标签 


INSERT _oid_ _count_ 


_count_ 是 插入 的 行 数 。 如 果 _count_ 正好 是 一 ， 并 且 目 标 表 有 OID, AA oid 是 赋予 
插入 行 的 OID。 否则 oid ZS, 


如 果 INSERT 命令 包含 RETURNING 子 句 ， 其 结果 将 和 一 个 SELECT 语句 相同 ， 包 含 那 些 基 于 该 
命令 实际 插入 的 行 计 算 的 、 定 义 在 RETURNING 列表 中 的 字段 的 值 。 


例子 
OX films 里 插入 单独 一 行 : 


INSERT INTO films VALUES 
('UA502', 'Bananas', 105, '1971-07-13', 'Comedy', '82 minutes'); 


在 这 个 例子 里 面 省 略 了 字段 len ， 因 此 在 它 里 面 将 存储 缺 省 值 : 


INSERT INTO films (code, title, did, date_prod, kind) 
VALUES ('T_601', 'Yojimbo', 106, '1961-06-16', 'Drama'); 


在 这 个 例子 里 ， 用 wrar 子 句 作为 日 期 字段 ， 而 不 是 声明 一 个 数值 : 


INSERT INTO films VALUES 

('UA502', 'Bananas', 105, DEFAULT, 'Comedy', '82 minutes'); 
INSERT INTO films (code, title, did, date_prod, kind) 

VALUES ('T_601', 'Yojimbo', 106, DEFAULT, 'Drama'); 


插入 一 行 完全 由 缺 省 值 组 成 的 数据 行 : 


INSERT INTO films DEFAULT VALUES; 


使 用 多 行 values 语法 插入 多 行 : 


INSERT INTO films (code, title, did, date_prod, kind) VALUES 
('B6717', 'Tampopo', 110, '1985-02-10', 'Comedy'), 
('HG120', 'The Dinner Game', 140, DEFAULT, 'Comedy'); 


从 表 tmp_films 中 插入 几 行 到 表 films P, 字段 布局 与 films 相同 : 


INSERT INTO films SELECT * FROM tmp_films WHERE date_prod < '2004-05-07'; 


插入 数组 : 


-- 创建 一 个 空 的 3x3 游 戏 板 来 玩 图- 和 - 叉 游戏 (这 些 查询 创建 相同 的 板 属性 ) 
INSERT INTO tictactoe (game, board[1:3][1:3]) 

VALUES (1, fa ae oo wate ew ae AR Ata: Mau VAR E N 
-- 上 述 例子 中 的 下 标 并 非 真 正 必须 
INSERT INTO tictactoe (game, board) 

VALUES (2, '{{X, " Lee altri MOA W Dey ates Me Xe ttt) ge 


向 distributors 表 插 入 一 个 单独 的 行 ， 并 返回 由 pEFAULT 子 句 生成 的 序列 值 : 


INSERT INTO distributors (did，dname) VALUES (DEFAULT, 'XYZ Widgets') 
RETURNING did; 


增加 销售 人 员 为 Acme Corporation 的 打折 力度 ， 并 且 在 日 志 表 中 记录 真 个 更 新 了 的 行 和 当前 
时 间 : 
WITH upd AS ( 
UPDATE employees SET sales_count = sales_count + 1 WHERE id = 
(SELECT sales_person FROM accounts WHERE name = 'Acme Corporation' ) 


RETURNING * 


) 
INSERT INTO employees_log SELECT *, current_timestamp FROM upd; 


RAIE 


INSERT 语句 与 SQL 标准 兼容 。 但 RETURNING 子 句 是 PostgreSQLi R, MIRTE INsERT 中 使 
用 with. 同样 ， 省 略 字段 名 列表 ， 但 是 并 非 所 有 字段 都 从 vALuEs FORA _query ”填充 的 
这 种 用 法 是 标准 不 允许 的 。 


可 能 碰 到 的 关于 query. 子 句 特性 的 限制 在 SELECT 语句 中 有 相关 文档 。 


LISTEN 


Name 


LISTEN -- 监听 一 个 通知 


Synopsis 


LISTEN _channel_ 


摘 述 
LISTEN 将 当前 会 话 注册 为 通知 通道 _channel_ 的 监听 器 。 如 果 当 前 会 话 已 经 被 注册 为 该 通知 
通道 的 监听 器 ， 那 么 什么 也 不 做 。 


当 执 行 了 命令 NOTIFY _channel_ 后， 不管 是 此 会 话 还 是 其 它 连 接 到 同一 数据 库 的 会 话 ， 所 

有 正在 监听 此 通知 通道 的 会 话 都 将 收 到 通知 ， 并 且 接 下 来 每 个 会 话 将 通知 与 其 相连 的 前 端 应 

用 。 

使 用 uste 命 合 可 以 将 一 个 会 话 内 已 注册 的 通知 通道 删除 。 同 样 ， 会 话 退 出 时 自动 删除 该 
会 话 正在 监听 的 已 注册 通知 通道 。 

前 端 应 用 检测 通知 事件 的 方法 取决 于 PostgreSQL 应 用 使 用 的 编程 接口 。 如 果 使 用 基本 的 libpq 
库 ， 那 么 应 用 将 srei 当 作 普通 SQL 命令 使 用 ， 而 且 必 须 周期 地 调用 Panotifies 过 程 来 检 
测 是 否 有 通知 到 达 。 其 它 像 libpgtcl 接 口 提供 了 更 高 级 的 控制 通知 事件 的 方法 ; 实际 上 ， 使 用 
libpgtcl 的 应 用 程序 员 不 应 该 直接 使 用 LisTEN 或 UNLISTEN 。 请 参考 你 使 用 的 接口 的 文档 获取 


更 多 细节 。 


NOTIFY 的 手册 页 包含 更 广泛 的 关于 LIsTEN 和 NoTIFY 的 使 用 的 讨论 。 


参数 


_channel_ 


通知 通道 的 名 字 ， 可 以 是 任意 标识 符 。 


LISTEN 在 事务 提交 时 生效 。 如 果 LIsTEN BY unisten 在 一 个 稍 后 回 滚 的 事务 中 执行 ， 那 么 
被 监听 的 通知 通道 的 设置 不 会 改变 。 


一 个 已 经 执行 了 LISTEN 的 事务 不 能 准备 两 阶段 提交 。 


例子 
在 psql 里 配制 和 执行 一 个 监听 /通知 序列 : 


LISTEN virtual; 
NOTIFY virtual; 
Asynchronous notification "virtual" received from server process with PID 8448. 


RANE 


SQL 标准 里 没有 LISTEN 语句 。 


义 见 


NOTIFY, UNLISTEN 


LOAD 


Name 


LOAD -- 加 载 一 个 共享 库 文件 


Synopsis 


LOAD '_filename_' 


个 命令 加 载 一 个 共享 库 文 件 到 PostgreSQL 服 务 器 的 地 址 空间 。 如 果 该 文件 已 经 被 加 载 ， 那 
这 条 命 合 什 么 也 不 做 。 包 含 C 画 数 的 共享 库 文件 在 其 中 之 一 的 函数 被 调用 时 自动 加 载 。 因 
此 ， 一 个 明确 的 Loa 通常 只 需要 加 载 一 个 修改 服务 器 行为 的 库 ， 通 过 "hooks" 而 不 是 提供 一 


组 函数 来 修改 服务 器 行为 。 


这 
a 


文件 名 是 用 和 CREATE FUNCTION 里 描写 的 共享 库 的 名 字 相 同方 法 声明 的 ; 特别 要 注意 等 是 
可 以 依赖 搜索 路 径 和 自动 附加 系统 标准 共享 库 扩 展 名 的 特点 。 参阅 Section 35.9 获 取 更 多 细 
节 。 


非 超级 用 户 仅 可 以 将 LoAp 用 于 $libdir/plugins/ 中 的 库 文 件 ， 也 就 是 说 指定 
的 _filename_ 必须 精确 的 以 该 字符 串 开 头 。 数据 库 管 理 员 有 责任 确保 仅 将 "安全 "的 库 文件 安 
装 在 那里 。 


兼容 性 


LoAD 是 PostgreSQL 扩 展 。 


义 见 


CREATE FUNCTION 


LOCK 


Name 


LOCK -- 锁定 一 个 表 


Synopsis 


LOCK [ TABLE ] [ ONLY ] name [ * ] [, ...] [ IN _lockmode_ MODE ] [ NOWAIT ] 
这 里 的 `_ 1ockmode “可 以 是 下 列 之 一 : 


ACCESS SHARE | ROW SHARE | ROW EXCLUSIVE | SHARE UPDATE EXCLUSIVE 
| SHARE | SHARE ROW EXCLUSIVE | EXCLUSIVE | ACCESS EXCLUSIVE 


LOCK TABLE 获取 一 个 表 级 锁 ， 必 要 时 等 待 任何 冲突 的 锁 释 放 。 如 果 声 明了 nowart, HB 

么 Lock TABLE 并 不 等 待 它 所 需要 的 锁 : 如 果 无 法 立即 获取 该 锁 ， 那 么 该 命令 退出 并 且 发 出 一 
个 错误 信息 。 如 果 成 功 获取 了 这 个 锁 ， 那 么 它 就 会 在 当前 事务 的 余下 部 分 一 直 保 持 。 没 

有 UNLOCK TABLE 命令 ; 锁 总 是 在 事务 结尾 释放 。 


在 为 那些 引用 了 表 的 命令 自动 请 求 锁 的 时 候 ，PostgreSQL 总 是 尽 可 能 使 用 最 小 限制 的 锁 模 
式 。 LOCK TABLE 是 为 你 在 需要 更 严格 的 锁 的 场合 提供 的 。 例如 ， 假 设 一 个 应 用 在 " 读 已 提 
交 " 隔 离 级 别 上 运行 事务 ， 并 且 它 需要 保证 在 表 中 的 数据 在 事务 的 运行 过 程 中 都 存在 。 要 实现 
这 个 目的 ， 你 可 以 在 查询 之 前 对 表 使 用 sHarE 锁 模式 进行 锁定 。 这 样 将 保护 数据 不 被 并 发 修 
改 并 且 为 任何 更 进一步 的 对 表 的 读 操 作 提 供 实 际 的 当前 状态 的 数据 ， 因为 sHARE 锁 模式 与 任 
何 写 操 作 需 要 的 Row ExcLusIvE 模式 冲突 ， 并 且 你 的 Lock TABLE _name IN SHARE MODE 
语句 将 等 到 所 有 当前 持 有 Row Exclusive 模式 的 锁 提 交 或 回 耸 后 才 执 行 。 因 此 ， 一 旦 你 获得 
该 锁 ， 那 么 就 不 会 存在 未 提交 的 写 操 作 ， 并 且 其 他 人 只 能 在 你 释放 锁 之 后 才能 再 次 获取 锁 。 


如 果 运 行 在 可 重复 读 或 可 串 行 化 隔离 级 别 实现 类 似 的 效果 的 时 候 ， 你 必须 在 执行 任 

何 sELEcT 或 数据 修改 语句 之 前 运行 一 个 Lock TABLE 语句 。 一 个 可 重复 读 或 可 串 行 化 事务 的 
数据 图 像 籽 在 其 第 一 个 sELEcT 或 者 数据 修改 语句 开始 的 时 候 冻 结 住 。 稍 后 的 Lock TABLE 将 
仍然 阻止 并 发 的 写 ， 但 它 不 能 保证 事务 读 取 的 东西 对 应 最 近 提 交 的 数值 。 


如 果 一 个 此 类 的 事务 准备 修改 一 个 表 中 的 数据 ， 那 么 应 该 使 用 shARE Row ExcLUSIVE 锁 模式 ， 
而 不 是 shARE 模式 。 这 样 就 保证 任意 时 刻 只 有 一 个 此 类 的 事务 运行 。 不 这 样 做 就 可 能 会 死 
锁 : 当 两 个 并 发 的 事务 可 能 都 请 求 sar 模式 ， 然 后 试图 更 改 表 中 的 数据 时 ， 两 个 事务 在 实 
际 执行 更 新 的 时 候 都 需要 Row EXCLUSIVE 锁 模 式 ， 但 是 它们 无 法 再 次 获取 这 个 锁 。 WER, 


一 个 事务 自己 的 锁 是 从 不 冲突 的 ， 因 此 一 个 事务 可 以 在 持 有 shARE 模式 的 锁 的 时 候 请 

求 Row ExcLusIvE 模式 (但 是 不 能 在 任何 其 它 事务 持 有 snare 模式 的 时 候 请 求 )。 为 了 避免 死 
锁 ， 所 有 事务 应 该 保证 以 相同 的 顺序 对 相同 的 对 象 请 求 锁 ， 并 且 ， 如 果 涉 及 多 种 锁 模式 ， 那 
么 事务 应 该 总 是 最 先 请 求 最 严格 的 锁 模式 。 


有 关 锁 模式 和 锁定 策略 的 更 多 信息 ， 请 参考 Section 13.3。 


参数 


_name_ 


要 锁定 的 现存 表 的 名 字 ( 可 以 有 模式 修饰 )。 如 果 在 表 名 前 声明 了 ony ， 那 么 只 有 那 一 个 表 被 
锁定 。 如 果 没 有 声明 ony ， 那 么 该 表 和 它 的 所 有 后 代表 MRA) 都 被 锁定 。 可 选 的 ，* 
可 以 在 表 名 后 面 指定 ， 明 确 表 明 包含 后 代表 。 


命令 LOCK TABLE a, b; 等 效 于 LOCK TABLE a; LOCK TABLE b; 。 表 是 按照 Lock TABLE 命令 中 声 
明 的 顺序 一 个 接 一 个 顺序 上 锁 的 。 


_lockmode_ 

锁 模 式 声明 这 个 锁 和 哪些 锁 冲 突 。 锁 模式 在 Section 13.3 里 描述 。 

如 果 没 有 声明 锁 模 式 ， 那 么 使 用 最 严格 的 模式 access EXCLUSIVE 模式 。 
NOWAIT 


声明 Lock TABLE 不 去 等 待 任何 冲突 的 锁 释 放 : 如 果 无 法 不 等 待 立即 获取 所 要 求 的 锁 ， 那 么 事 
务 退 出 。 


MN at 
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LOCK TABLE ... IN ACCESS SHARE MODE 需要 在 目标 表 上 有 SELECT 权限 。 所 有 其 它 形式 
的 Lock 需要 表 级 别 的 UPDATE, DELETE 或 TRUNCATE 权限 。 


LOCK TABLE 在 事务 块 的 外 部 没什么 用 : 锁 依然 被 持 有 直到 声明 结束 。 因此 如 果 Lock 在 一 个 
事务 块 外 面 使 用 ，PostgreSQL 会 报告 一 个 错误 。 使 用 BEGIN 和 COMMIT (或 ROLLBACK) Œ 
义 一 个 事务 块 。 


Lock TABLE 只 义理 表 级 的 锁 ， 因 此 那些 有 Row 字样 的 锁 都 是 用 词 不 当 。 这 些 模式 名 字 通 常 应 
该 理解 为 用 户 试图 在 一 个 被 锁定 的 表 中 获取 行 级 的 锁 。 同 样 ， Row exclusive 模式 也 是 一 个 
可 共享 的 表 级 锁 。 一 定 要 记 住 ， 只 要 是 涉及 到 Lock TABLE ， 那 么 所 有 锁 模 式 都 有 相同 的 语 
意 ， 区 别 只 是 它们 与 哪 种 锁 冲 突 的 规则 。 有 关 如 何 获取 一 个 行 级 锁 的 信息 ， 请 参阅 Section 
13.3.2 和 sELEcT 命令 参考 页 的 锁定 子 句 子 句 信息 。 


例子 
演示 在 往 一 个 外 键 表 上 插入 时 在 有 主键 的 表 上 使 用 shARE 的 锁 : 


BEGIN WORK; 
LOCK TABLE films IN SHARE MODE; 
SELECT id FROM films 

WHERE name = 'Star Wars: Episode I - The Phantom Menace'; 
-- 如 果 记 录 没 有 返回 则 ROLLBACK 
INSERT INTO films_user_comments VALUES 

(_id_, 'GREAT! I was waiting for it for so long!'); 
COMMIT WORK; 


在 执行 删除 操作 时 对 一 个 有 主键 的 表 进 行 SHARE ROW EXCLUSIVE 锁 : 


BEGIN WORK; 

LOCK TABLE films IN SHARE ROW EXCLUSIVE MODE; 

DELETE FROM films_user_comments WHERE id IN 
(SELECT id FROM films WHERE rating < 5); 

DELETE FROM films WHERE rating < 5; 

COMMIT WORK; 


RAIE 


在 SQL 标准 里 面 没 有 Lock TABLE ， 可 以 使 用 set Transaction 来 声明 当前 事务 的 级 别 。 
PostgreSQL 也 支持 这 个 ， BRMSET TRANSACTION 获取 详 细 信 息 。 


除了 ACCESS SHARE , ACCESS EXCLUSIVE , SHARE UPDATE EXCLUSIVE 锁 模 式 外 ，PostgreSQL 锁 


模式 和 Lock TABLE 语句 都 与 那些 在 Oracle 里 面 的 兼容 。 


MOVE 


Name 


MOVE -- 定位 一 个 游标 


Synopsis 


MOVE [ _direction_ [ FROM | IN ] ] _cursor_name_ 
where ~_direction_~ can be empty or one of: 


NEXT 

PRIOR 

FIRST 

LAST 

ABSOLUTE _count_ 
RELATIVE _count_ 
_count_ 

ALL 

FORWARD 

FORWARD _count_ 
FORWARD ALL 
BACKWARD 
BACKWARD _count_ 
BACKWARD ALL 


move 在 不 检索 数据 的 情况 下 重新 定位 一 个 游标 。 MovE 的 工作 类 似 于 FETcH AD, GREE 
定位 游标 而 不 返回 行 。 


Move 命令 的 参数 与 FETcH 命令 的 参数 相同 ; 请 参考 FETCH 命 令 获 取 语 法 和 参数 的 详细 信 
息 。 


输出 
成 功 完成 时 ， move 命令 将 返回 一 个 下 面 形 式 的 命令 标签 


MOVE _count_ 


_count_ 是 一 个 带 同 参数 的 FETcH 命令 会 返回 的 行 数 (可 能 为 需 )。 


例子 


BEGIN WORK; 
DECLARE liahona CURSOR FOR SELECT * FROM films; 


-- 忽略 开头 5 行 : 


MOVE FORWARD 5 IN liahona; 
MOVE 5 


-- Fetch the 6th row from the cursor liahona: 
FETCH 1 FROM liahona; 


code | title | did | date_prod | kind | len 

3 Be ee 
P_303 | 48 Hrs | 103 | 1982-10-22 | Action | 01:37 
(1 row) 

-- 关闭 游标 liahona 并 提交 事务 : 


CLOSE liahona; 
COMMIT WORK; 


FANE 


SQL 标准 里 没有 move 语句 。 


义 见 


CLOSE, DECLARE, FETCH 


NOTIFY 


Name 


NOTIFY -- 生成 一 个 通知 


Synopsis 


NOTIFY _channel_ [ , _payload_ ] 


摘 述 


NOTIFY 命令 向 当前 数据 库 中 所 有 执行 过 LISTEN _channel_, 正在 监听 特定 通道 名 字 的 前 
端 应 用 发 送 一 个 通知 事件 和 一 个 可 选 的 "payload" 字 符 串 。 通知 对 所 有 用 户 可 见 。 


NOTIFY 为 访问 同一 个 PostgreSQL 数据 库 的 一 组 进程 提供 了 一 种 简单 的 进程 间 通 讯 机 制 。 负 
载 字 符 串 可 以 和 通知 一 起 发 送 ， 并 且 传 送 结构 化 数据 的 更 高 级 的 机 制 可 以 通过 使 用 数据 库 中 
的 表 从 通知 者 传递 数据 到 接收 者 。 


传递 给 前 端的 通知 事件 包括 通知 通道 名 、 发 出 通知 的 后 端 进程 PID 和 负载 字符 串 ， 如 果 已 经 
指定 了 字符 串 则 该 负载 字符 串 为 空 。 


定义 将 要 用 于 给 定数 据 库 的 通道 名 和 每 个 意味 着 什么 取决 于 数据 库 设 计 者 。 通常 ， 通 知 通道 
名 与 数据 库 里 的 表 的 名 字 相 同 ， 通 知事 件 实际 上 意味 着 "我 修改 了 此 数据 库 ， 请 看 一 眼 有 什么 
新 东西 "。 NoTIFY 和 Listen 命令 并 不 强制 这 种 联系 。 例 如 ， 数 据 库 设计 者 可 以 使 用 几 个 不 同 
的 通道 名 来 标志 一 个 表 的 几 种 不 同 改变 。 另外 ， 负 载 字 符 串 可 以 用 来 区 分 各 种 情况 。 


当 NoTIFY 用 于 通知 某 一 特定 表 修 改 的 动作 的 发 生 ， 一 个 实用 的 编程 技巧 是 将 NoTIFY 放 在 一 
个 由 表 更 新 触发 的 规则 里 。 用 这 种 方法 ， 通知 将 在 表 更 新 的 时 候 自动 触发 ， 而 且 应 用 程序 员 
RATHI Siz BEE. 


NOTIFY 和 SQL 事务 用 某 种 重要 的 方法 进行 交换 。 首 先 ， 如 果 NoTIFY 在 事务 内 部 执行 ， 通 

知事 件 直到 事务 提交 才 会 送出 。 这 么 做 是 有 道理 的 ， 因 为 如 果 事 务 退 出 了 ， 那么 在 它 里 面 的 
所 有 命令 都 没有 效果 (包括 NoTIFY )。 但 如 果 有 人 希望 通知 事件 立即 发 送 ， 这 就 不 太 好 了 。 其 
次 ， 当 一 个 正在 监听 的 会 话 在 一 次 事务 内 收 到 一 个 通知 信号 ， 直到 本 次 事务 完成 (提交 或 退 

出 ) 之 前 ， 该 通知 事件 将 不 被 送 到 与 之 相连 的 客户 端 。 同 样 ， 如 果 一 个 通知 在 事务 内 部 发 送出 
去 了 ， 而 该 事务 稍 后 又 退出 了 ， 就 希望 通知 可 以 在 某 种 程度 上 被 撤消 ， 因为 通知 一 旦 发 送出 
去 ， 服 务 器 便 不 能 从 客户 端 "收回 "通知 ， 所 以 通知 事件 只 是 在 事务 之 间 传 递 。 这 一 点 就 要 求 
使 用 NoTIFY 作为 实时 信号 的 应 用 应 该 确保 他 们 的 事务 尽 可 能 短 。 


如 果 相 同 的 通道 名 已 经 从 相同 的 事务 中 发 出 了 同样 的 负载 字符 串 多 次 ， 数据 库 服务 器 可 以 决 
定 只 送出 一 个 字符 串通 知 。 另 一 方面 ， 不 同 负 载 字符 串 的 通知 将 总 是 作为 不 同 通知 传送 。 相 
似 的， 来 自 不 同事 件 的 通知 将 永远 不 会 被 并 人 一 个 通知 。 除 了 删除 稍 后 复制 通知 的 实例 ， 
NOTIFY 保证 来 自 相 同事 务 的 通知 以 它们 被 传送 的 顺序 到 达 。 也 保证 来 自 不 同事 务 的 信息 以 事 
务 提交 的 顺序 到 达 。 


客户 端 经 常会 自己 发 送 与 正在 监听 的 通知 通道 一 样 的 NoTIFY 。 这 时 它 ( 客 户 端 ) 也 和 其 它 正在 
监听 的 会 话 一 样 收 到 一 个 通知 事件 。 这 样 可 能 导致 一 些 无 用 的 工作 (与 应 用 逻辑 有 关 )。 例 
如 ， 对 客户 端 刚 写 过 的 表 又 进行 一 次 读 操 作 以 发 现 是 否 有 更 新 。 可 以 通过 检查 服务 器 进程 的 
PID( 在 通知 事件 中 提供 ) 是 否 与 自己 的 会 话 的 PID 一 致 (从 libpq 中 取得 ) 避 免 这 样 的 额外 工作 。 
当 他 们 一 样 时 ， 说 明 这 是 其 自身 回 弹 的 信息 ， 可 以 忽略 。 


参数 


_channel_ 
生成 信号 (通知 ) 的 通知 通道 (任何 标识 符 )。 
_payload_ 


"payload" 字 符 串 与 通知 交流 。 必 须 指 定 为 简单 的 字符 串 文本 。 缺 省 配置 中 必须 少 于 8000 字 
Po 《如 果 二 进 制 数据 或 大 量 的 信息 需要 交流 ， 最 好 放 在 数据 库 表 中 并 发 送 该 记录 的 键 


~ a 
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有 一 个 已 经 发 送 的 持 有 通知 但 目前 还 未 被 所 有 监听 会 话 处 理 的 序列 。 如 果 这 个 序列 满 了 ， 会 
话 调用 NoTIFY 将 会 在 提交 时 失败 。 序 列 是 相当 大 的 (标准 安装 中 是 8GB) 并 且 应 该 足够 为 几 
乎 每 个 使 用 情况 大 。 但 是 ， 如 果 会 话 执行 LISTEN 并 且 然 后 进入 一 个 事务 很 长 时 间 那 么 将 不 会 
有 清除 发 生 。 一 旦 序列 是 半 满 的 ， 您 将 在 日 志 中 看 到 警告 指向 您 的 会 话 阻止 清除 。 在 这 种 情 
况 下 ， 应 该 确保 这 个 会 话 结束 他 的 当前 事务 ， 这 样 清理 能 够 进行 。 


一 个 已 经 执行 了 NoTIFY 的 事务 不 能 准备 两 阶段 提交 。 


pg_notify 


也 可 以 使 用 画 
数 pg_notify`( text ，text ) 发 送 一 个 通知 。 画 数 接受 通道 名 作为 第 一 个 参数 ， 负 载 作为 第 二 个 参数 。 如 果 你 需要 
NOTIFY 命令 更 简单 。 


例子 


在 psql 里 配置 和 执行 一 个 监听 /通知 序列 : 


LISTEN virtual; 

NOTIFY virtual; 

Asynchronous notification "virtual" received from server process with PID 8448. 

NOTIFY virtual, 'This is the payload'; 

Asynchronous notification "virtual" with payload "This is the payload" received from serv 


LISTEN foo; 


SELECT pg_notify('fo' || 'o', 'pay' || 'load'); 
Asynchronous notification "foo" with payload "payload" received from server process with 


aj — 


RAIE 


SQL 标准 里 没有 NoTIFY 语句 。 








义 见 


LISTEN, UNLISTEN 


PREPARE 


Name 


PREPARE -- 创建 一 个 预备 语句 


Synopsis 


PREPARE _name_ [ ( _data_type_ [, ...] ) ] AS _statement_ 





摘 述 


PREPARE 创建 一 个 预备 语句 。 一 个 预 各 语句 是 服务 器 端的 对 象 ， 可 以 用 于 优化 性 能 。 在 执 
行 PREPARE 语句 的 时 候 ， 指 定 的 查询 被 解析 、 分 析 、 重 写 。 当 随后 发 出 execute 语句 的 时 
候 ， 预 各 语句 被 规划 和 执行 。 这 种 分 工 避 免 了 重复 解析 分 析 工 作 ， 人 允许 执行 计划 依赖 于 所 提 
供 的 特定 的 参数 值 。 


预备 语句 可 以 接受 参数 : 在 它 执行 的 时 候 替 换 到 查询 中 的 数值 。 可 以 在 一 个 预备 语句 里 按照 

位 置 来 引用 参数 ， 比如 s1, $2 等 。 可 以 指定 一 个 相应 的 参数 数据 类 型 列表 。 如 果 一 个 参数 
的 数据 类 型 没有 被 指定 或 声明 为 unknown, 那么 其 类 型 将 根据 该 参数 所 使 用 的 实际 上 下 文 环 
境 进 行 推测 (如 果 有 可 能 的 话 )。 当 执行 该 语句 的 时 候 ， 将 在 execute 语句 中 为 这 些 参数 指定 

实际 值 。 参 见 EXECUTE 获 取 更 多 信息 。 


预备 语句 只 是 在 当前 数据 库 会 话 的 过 程 中 存在 。 如 果 客 户 端 退 出 ， 那 么 预备 语句 就 会 被 遗 
忘 ， 因 此 必须 在 被 重新 使 用 之 前 重新 创建 。 这 也 意味 着 一 个 预备 语句 不 能 被 多 个 数据 库 客户 
端 同时 使 用 ; 但 是 ， 每 个 客户 端 可 以 创建 它们 自己 的 预备 语句 来 使 用 。 预 各 语句 可 以 用 
DEALLOCATE 命 令 手 工 清除 。 


如 果 一 个 会 话 准备 用 于 执行 大 量 类 似 的 查询 ， 那 么 预备 语句 可 以 获得 最 大 限度 的 性 能 优势 。 
如 果 坦 询 非 常 复 杂 ， 需 要 复 条 的 规划 或 者 重 写 ， 那 么 性 能 差距 将 更 加 明显 。 比 如 ， 如 果 查 询 
设计 许多 表 的 连接 ， 或 者 有 多 种 规则 要 求 应 用 。 如 果 查 询 的 规划 和 重 写 相 对 简单 ， 而 执行 起 
来 开销 相当 大 ， 那 么 预备 语句 的 性 能 优势 就 不 那么 明显 。 


参数 


_name_ 


给 予 这 个 特定 的 预备 语句 任意 名 字 。 它 必须 在 一 个 会 话 中 是 唯一 的 ， 并 且 用 于 执行 或 者 删除 
一 个 预备 语句 。 


_data_type_ 


预备 语句 的 某 个 参数 的 数据 类 型 。 如 果 某 个 参数 的 数据 类 型 未 指定 或 指定 为 unknown ， 那么 
将 根据 该 参数 使 用 的 上 下 文 环境 进行 推断 。 可 以 使 用 $1 ，$2 等 等 在 预备 语句 内 部 引用 这 个 
参数 。 


_statement_ 


SELECT , INSERT , UPDATE , DELETE ,或 VALUES 语句 之 一 。 


ss ate 


a 


如 果 预 备 语句 执行 了 足够 长 的 时 间 ， 服 务 器 可 能 最 终 决 定 保存 并 重新 使 用 一 个 一 般 的 计划 ， 
而 不 是 每 次 重新 计划 。 如 果 预 各 语句 没有 参数 ， 那 么 将 立即 发 生 ; 否则 只 在 一 般 计 划 看 起 来 
不 比 依赖 于 特定 参数 值 的 计划 昂贵 时 发 生 。 典型 的 ， 只 有 查询 的 性 能 对 提供 的 特定 的 参数 值 
相当 迟钝 时 选择 一 般 的 计划 。 


为 了 查询 PostgreSQL 用 于 预备 语句 的 查询 计划 ， 使 用 EXPLAIN。 如 果 正 在 使 用 一 个 一 般 的 
计划 ， 它 将 包含 参数 符号 sin, 此 时 定制 计划 将 有 代入 的 当前 实际 人 参数 的 值 。 


有 关 查 询 规 划 和 PostgreSQL 为 查询 优化 的 目的 收集 统计 的 更 多 信息 ， 参阅 ANALYZE 文 档 。 


尽管 预 各 语句 的 重点 是 避免 重复 分 析 和 规划 语句 ， 但 PostgreSQL 在 使 用 它 之 前 强制 重复 分 析 
和 重复 计划 语句 ， 每 当 在 语句 中 使 用 的 数据 库 对 象 自前 一 次 使 用 预备 语句 后 经 历 了 明确 
(DDL) 的 变化 时 。 还 有 ， 如 果 search_path 的 值 在 到 下 一 个 使 用 时 改变 了 ， 那么 语句 将 使 用 新 
的 search_path 重新 分 析 。 (后 面 的 行为 是 PostgreSQL 9.3 新 增 的 。) 使 用 预备 语句 语义 的 
规则 几乎 等 于 反复 重新 提交 相同 的 查询 文本 ， 但 是 如 果 没有 对 象 定义 改变 那么 将 有 一 个 性 能 
优势 ， 尤 其 是 保持 使 用 最 佳 的 规划 。 语义 等 价 不 完美 的 一 个 例子 是 如 果 语 句 引 用 一 个 未 经 限 
定名 字 的 表 ， 然后 在 一 个 模式 中 创建 了 一 个 相同 名 字 的 表 出 现在 search_path 中 靠 前 的 地 
方 ， 那 么 将 不 会 自动 重复 分 析 ， 因 为 用 于 语句 的 对 象 没有 改变 。 但 是 ， 如 果 其 他 改变 强制 了 
一 个 重复 分 析 ， 那么 新 表 将 在 后 来 的 使 用 中 引用 。 


可 以 通过 查询 pg_prepared_statements 有 系统 视图 获得 某 个 会 话 中 所 有 可 用 的 预备 语句 。 


Examples 
为 一 个 INSERT 语句 创建 一 个 预备 语句 然后 执行 它 : 


PREPARE fooplan (int, text, bool, numeric) AS 
INSERT INTO foo VALUES($1, $2, $3, $4); 
EXECUTE fooplan(i, ‘Hunter Valley', 't', 200.00); 


为 一 个 SELECT 语句 创建 一 个 预 各 语句 然后 执行 它 : 


PREPARE usrrptplan (int) AS 
SELECT * FROM users u, logs 1 WHERE u.usrid=$1 AND u.usrid=l.usrid 


AND 1.date = $2; 
EXECUTE usrrptplan(1, current_date); 


注意 ， 第 二 个 参数 的 数据 类 型 并 未 指定 。 所 以 将 从 上 下 文 环境 推测 $2 的 类 型 。 


兼容 性 


SQL 标准 包含 一 个 PREPARE 语句 ， 但 是 它 只 用 于 和 能 入 式 SQL 。 PostgreSQL 实现 
的 PREPARE 语句 的 语法 也 略 有 不 同 。 


义 见 


DEALLOCATE, EXECUTE 


PREPARE TRANSACTION 


Name 


PREPARE TRANSACTION -- 为 当前 事务 做 两 阶段 提交 的 准备 


Synopsis 


PREPARE TRANSACTION _transaction_id_ 


摘 述 


PREPARE TRANSACTION 为 当前 事务 的 两 阶段 提交 做 准备 。 在 命令 之 后 ， 事务 就 不 再 和 当前 会 话 
关联 了 ; 它 的 状态 完全 保存 在 磁盘 上 ， 它 被 提交 成 功 的 可 能 性 非常 高 ， 即使 是 在 请 求 提交 
前 数据 库 发 生 了 崩溃 也 如 此 。 

一 旦 准 各 好 了 ， 一 个 事务 就 可 以 在 积 后 用 COMMIT PREPARED ROLLBACK PREPARED 
命令 分 别 进行 提交 或 者 回 滚 。 这 些 命令 可 以 从 任何 会 话 中 发 出 ， 而 不 光 是 最 初 执行 事务 的 那 
个 会 话 。 

从 发 出 命令 的 会 话 的 角度 来 看 ， PREPARE TRANSACTION 不 同 于 RoLLBAcK : 在 执行 它 之 后 ， 就 
不 再 有 活跃 的 当前 事务 了 ， 并 且 预 各 事务 的 效果 无 法 见 到 (在 事务 提交 的 时 候 其 效果 会 再 次 可 
见 )。 

如 果 PREPARE TRANSACTION 因为 某 些 原因 失败 ， 那么 它 就 会 变 成 一 个 RoLLBACK ， 当 前 事务 被 
取消 。 


参数 


_transaction_id_ 


一 个 任意 的 标识 符 ， 用 于 后 面 在 COMMIT PREPARED 或 ROLLBACK PREPARED 的 时 候 标 识 这 个 事 
务 。 这 个 标识 符 必 须 以 字符 串 文本 的 方式 书写 ， 并 且 必 须 小 于 200 字 节 长 。 它 不 能 和 任何 当 
前 预 各 事务 已 经 使 用 了 的 标识 符 同 名 。 


PREPARE TRANSACTION 不 是 为 了 在 应 用 或 交互 会 话 中 使 用 。 它 的 目的 是 允许 外 部 的 事务 管理 器 
实现 多 个 数据 库 或 者 与 其 他 事务 源 实现 原子 的 全 局 事务 。 除非 你 写 一 个 事务 管理 器 ， 否 则 你 


不 应 该 使 用 PREPARE TRANSACTION 。 
这 条 命令 必须 在 一 个 事务 块 里 面 使 用 。 用 BEGIN 开 始 一 个 事务 。 


目前 ， 不 允许 对 那些 执行 了 涉及 临时 表 ， 或 者 是 创建 了 带 WITH Ho 游标 ， 或 者 执行 
了 LISTEN 或 UNLISTEN 的 事务 进行 PREPARE o 这 些 特 性 和 当前 会 话 绑 定 得 实在 是 太 紧 密 了 ， 
因此 在 一 个 预备 事务 里 没什么 可 用 的 。 


如 果 事 务 用 ser (没有 Local 选项 ) 修改 了 运行 时 参数 ， 这 些 效果 
在 PREPARE TRANSACTION 之 后 保留 ， 并 且 不 会 被 任何 以 后 的 
COMMIT PREPARED 或 ROLLBACK PREPARED 所 影响 。 因此 ， 在 这 方面 ， PREPARE TRANSACTION 表 


现 得 更 像 commit 而 不 是 ROLLBACK o 


所 有 目前 可 用 的 预 各 事务 都 在 系统 视图 pg_prepared_xacts 里 面 列 出 。 


Caution 


把 一 个 事务 长 时 间 停 在 预 各 状态 是 不 明智 的 : 它 会 影响 vacuum 回收 存储 的 能 力 ， FEE 
极端 情况 可 能 导致 数据 库 关 闭 以 阻止 包括 事务 ID (参阅 Section 23.1.5) 。 还 要 记 住 ， 事 
务 会 继续 持 有 它们 持 有 的 锁 。 OA 
实 了 其 它 数据 库 也 准备 好 提交 之 后 ， 提 交 或 者 回 滚 事务 。 


如 果 你 还 没有 设置 一 个 额外 的 事务 管理 器 追踪 预备 事务 和 确保 他 们 得 到 及 时 关闭 ， 最 好 通过 
设置 max_prepared_transactions 为 0 来 保持 预备 事务 特征 不 可 用 。 这 将 阻止 意外 的 创建 可 能 
被 遗忘 和 最 终 导致 问题 的 预备 事务 。 | 


例子 
为 当前 事务 做 两 阶段 提交 的 准备， 使 用 foobar 做 为 事务 标识 符 : 


PREPARE TRANSACTION 'foobar'; 


RANE 


PREPARE TRANSACTION 是 一 个 PostgreSQL 扩 展 。 该 命令 设计 是 给 外 部 事务 管理 系统 使 用 ， 
SQL 标 准 只 涉及 部 分 功能 (如 X/Open XA) ， 但 这 些 功能 目前 没有 标准 化 。 


义 见 


COMMIT PREPARED, ROLLBACK PREPARED 


REASSIGN OWNED 


Name 


REASSIGN OWNED -- 修改 数据 库 对 象 的 属 主 


Synopsis 


REASSIGN OWNED BY _old_role_ [, ...] TO _new_role_ 
vb 
摘 述 
REASSIGN OWNED 要 求 系 统 和 所 有 old_roles 拥有 的 数据 库 对 象 的 属 主 更 改 为 new_role。 
参数 
_old_role_ 


旧 属 主 的 角色 名 。 当 前 数据 库 和 所 有 共享 对 象 (数据 库 ， 表 空间 ) 中 该 角色 所 拥有 的 所 有 对 象 
的 属 主将 改 为 _new_role o 


_new_role_ 


将 要 成 为 这 些 对 象 属 主 的 新 角色 的 名 字 


ss 一 一 


) 王 局 


REASSIGN OWNED 常用 于 在 删除 角色 之 前 的 准备 工作 。 因 为 REASSIGN owNED 不 影响 其 他 数据 库 
中 的 对 象 ， 所 以 必须 在 即将 删除 的 角色 拥有 对 象 的 每 一 个 数据 库 中 执行 该 命令 。 
REASSIGN OWNED 要 求 原 角色 和 目标 角色 上 的 权限 。 


DROP OWNED 可 以 用 来 删除 角色 所 拥有 的 所 有 对 象 。 还 请 注意 DROP owNED 只 需要 原 角 色 的 
权限 。 


REASSIGN OWNED 并 不 影响 old_roles 在 不 被 其 拥有 的 对 象 上 的 权限 。 使 用 prop owNED 来 删除 
这 些 权 限 。 


FANE 


REASSIGN OWNED 语句 是 一 个 PostgreSQL 扩 展 。 


XIL 


DROP OWNED, DROP ROLE, ALTER DATABASE 


REFRESH MATERIALIZED VIEW 


Name 


REFRESH MATERIALIZED VIEW -- 替换 物化 视图 的 内 容 


Synopsis 


REFRESH MATERIALIZED VIEW _name_ 
[ WITH [ NO ] DATA ] 


REFRESH MATERIALIZED VIEW 完全 蔡 换 一 个 物化 视图 的 内 容 。 旧 的 内 容 被 丢弃 。 如 果 声 明 
了 with DATA (RRA) ， 后 端 查询 被 执行 以 提供 新 的 数据 ， 物化 视图 留 在 可 扫描 的 状态 。 
如 果 声 明了 with no pATA ， 那么 不 会 产生 新 的 数据 ， 并 且 物 化 视图 留 在 一 个 不 可 扫描 的 状 


xX 


Ro 


参数 


_name_ 


要 刷新 内 容 的 物化 视图 的 名 字 〈 可 以 有 模式 修饰 ) 。 


MN we ol 


aa 


当 保 留 了 未 来 的 CLUSTER 操作 的 缺 省 索引 时 ， REFRESH MATERIALIZED VIEW 不 要 求生 成 的 行 
基于 这 个 属性 。 如 果 你 希望 数据 根据 生成 排序 ， 必 须 在 后 端 查询 中 使 用 一 个 oRDER BY 子 句 。 


例子 


这 个 命令 将 刷新 物化 视图 order_summary 的 内 容 ， 使 用 来 自 物 化 视图 定义 的 查询 ， 并 且 使 它 
留 在 可 扫描 的 状态 : 


REFRESH MATERIALIZED VIEW order_summary; 


这 个 命令 将 清空 物化 视图 annual_statistics_basis 的 存储 区 ， 并 使 它 留 在 不 可 扫描 的 状态 : 


REFRESH MATERIALIZED VIEW annual_statistics_basis WITH NO DATA; 


RAIE 


REFRESH MATERIALIZED VIEW 是 一 个 PostgreSQL 扩 展 。 


XIL 


CREATE MATERIALIZED VIEW, ALTER MATERIALIZED VIEW, DROP MATERIALIZED 
VIEW 


REINDEX 


Name 


REINDEX -- 重建 索引 


Synopsis 


REINDEX { INDEX | TABLE | DATABASE | SYSTEM } _name_ [ FORCE ] 


fia ah 


REINDEX 使 用 存储 在 索引 表 中 的 数据 重建 索引 ， 蔡 换 旧 的 索引 的 副本 。 使 用 REINDEX 有 两 个 
主要 原因 : 


。 索引 崩溃 ， 并 且 不 再 包含 有 效 的 数据 。 尽 管理 论 上 这 是 不 可 能 发 生 的 ， 但 实际 上 索引 会 
因为 软件 毛病 或 者 硬件 问题 而 月 演 。 REINDEX 提供 了 一 个 恢复 方法 。 


。 来 引 交 得 " 腔 肿 "， 包 含 大 量 的 空 页 或 接近 空 页 。 这 个 问题 在 某 些 罕见 访问 模式 时 会 发 生 
在 B-tree 索引 上 。 REINDEX 通过 写 一 个 不 带 无 用 索引 页 的 新 素 引 提供 了 缩小 索引 空间 消 
耗 的 途径 。 参阅 Section 23.2 获 取 更 多 信息 。 


为 索引 更 改 了 存储 参数 (例如 填充 因子 )， 并 且 和 希望 这 个 更 改 完全 生效 。 


e 使 用 CONCURRENTLY 选项 创建 索引 失败 ， 留 下 了 一 个 "非法 "索引 。 这 样 的 索引 之 无 用 你， 
但 是 可 以 通过 REINDEX 重建 新 索引 来 覆盖 。 注 意 ， REINDEX 不 能 并 发 创建 。 要 在 生产 环 
境 中 重建 素 引 并 且 尽 可 能 减 小 对 尖峰 负载 的 影响 ， 可 以 先 删 除 旧 索引 ， 然 后 使 


FA CREATE INDEX CONCURRENTLY 命令 重建 新 索引 。 


INDEX 
重新 建立 指定 的 索引 。 


TABLE 


重新 建立 指定 表 的 所 有 索引 。 如 果 表 有 从 属 的 "TOAST" 表 ， 那 么 这 个 表 也 会 重新 来 引 。 


DATABASE 


重建 当前 数据 库 里 的 所 有 索引 。 也 处 理 在 共享 系统 表 上 的 索引 。 这 种 形式 的 REINDEX 不 能 在 
事务 块 中 执行 。 


SYSTEM 


在 当前 数据 库 上 重建 所 有 系统 表 上 的 索引 。 包 括 在 共享 系统 表 上 的 索引 。 不 会 处 理 在 用 户 表 
上 的 索引 。 这 种 形式 的 REINDEX 不 能 在 事务 块 中 执行 。 


_name_ 


需要 重建 素 引 的 索引 、 表 、 数 据 库 的 名 称 。 表 和 索引 名 可 以 有 模式 修饰 。 目 前 ， 
REINDEX DATABASE 和 REINDEX SYSTEM 只 能 重建 当前 数据 库 的 索引 ， 因此 其 参数 必须 匹配 当前 
数据 库 的 名 字 。 


FORCE 


如 果 你 怀疑 一 个 用 户 表 上 的 索引 骨 溃 了 ， 你 可 以 简单 地 使 用 REINDEX INDEX 重建 该 索引 ， 或 
者 使 用 REINDEX TABLE 重建 该 表 上 的 所 有 索引 。 


如 果 你 从 一 个 崩溃 的 系统 表 索 引 上 恢复 ， 事 情 会 更 环 手 一 些 。 这 种 情况 下 ， 系统 必须 不 能 使 
用 任何 有 疑问 的 素 引 。 实 际 上 ， 在 这 种 情况 下 ， 你 可 能 发 现 服务 器 进程 在 启动 之 后 马上 就 崩 
溃 了 ， 因 为 依赖 于 骨 溃 了 的 索引 。 要 想 安 全 恢复 ， 服务 器 必须 带 着 -p 选项 启动 ， 它 禁止 服 
务 器 在 查找 系统 表 的 时 候 使 用 索引 。 


达到 这 个 目的 的 一 个 方法 是 停止 服务 器 然后 带 着 -P 命令 行 选项 启动 一 个 独立 的 PostgreSQL 
服务 器 。 然 后 ， 根据 你 希望 恢复 的 程度 ， 发 出 REINDEX DATABASE ， REINDEX SYSTEM , 

REINDEX TABLE ， REINDEX INDEX 命令 。 如 果 还 有 怀疑 ， 使 用 REINDEX SYSTEM 选择 重新 构造 数 
据 库 中 全 部 的 系统 索引 。 然后 退出 独立 服务 器 会 话 并 且 重 馈 普 通 的 服务 器 。 参 阅 postgres F 
册页 获取 有 关 如 何 与 独立 服务 器 交互 的 信息 。 


另外 ， 一 个 普通 的 会 话 可 以 在 其 命令 行 选 项 里 使 用 -p 选项 启动 。 这 么 做 的 方法 因 不 同 的 客 
户 端 而 异 ， 但 是 在 所 有 基于 libpq 的 客户 端 上 ， 都 可 以 通过 在 启动 客户 端 之 前 设 

IE PeopTIONS 环境 变量 为 -Pp 来 实现 。 请 注意 尽管 这 个 方法 并 不 要 求 锁 住 其 它 客 户 端 ， 但 是 
禁止 其 它 客 户 端 连 接受 损 的 数据 库 ， 直到 完成 修补 是 一 个 明智 的 选择 。 


REINDEX 类 似 于 删除 并 重建 素 引 ， 表 现在 它们 都 是 从 需 开 始 重建 。 不 过 ， 从 锁 的 角度 考虑 ， 

两 者 是 有 区 别 的 。 REINDEX 锁 住 对 索引 的 父 表 的 写 操 作 ， 但 是 不 锁 读 操 作 。 并 且 它 还 在 被 处 
理 的 特定 索引 上 保持 一 个 排他 锁 ， 这 样 它 将 阻止 试图 使 用 该 索引 的 读 操 作 。 相 上 比 之 

F, DROP INDEX 在 父 表 上 短暂 的 保持 一 个 排他 锁 ， 同 时 锁 住 读 和 写 。 随 后 的 CREATE INDEX 

锁 住 写 操 作 但 是 不 会 锁 住 读 操作 ; 因为 索引 还 不 存在 ， 所 以 不 会 有 试图 使 用 它 的 读 操作 ， 意 
味 着 操作 中 不 会 有 阻塞 ， 只 不 过 读 操作 会 被 迫 只 能 使 用 顺序 扫 摘 。 


对 一 个 索引 或 者 表 进 行 重建 索引 ， 要 求 你 是 该 索引 或 者 表 的 所 有 者 。 对 一 个 数据 库 重 建 索引 
要 求 你 是 该 数据 库 的 所 有 者 (注意 ， 可 以 重建 其 它 用 户 拥有 的 索引 )。 当然 ， 超 级 用 户 总 是 可 
以 重建 所 有 索引 。 


PostgreSQL 8.1 之 前 ， REINDEX DATABASE 只 处 理 系 统 素 引 ， 而 不 是 人 们 从 名 字 猜 测 的 那样 ， 
处 理 所 有 索引 。 这 个 行为 现在 已 经 改变 了 ， 以 减少 意外 的 因素 。 旧 的 行为 可 以 通 


过 REINDEX SYSTEM 获得 。 


PostgreSQL 7.4 之 前 ， REINDEX TABLE 并 不 自动 处 理 TOAST 表 ， 因 此 这 些 表 必须 用 独立 的 命 
令 进 行 处 理 。 这 人 么 做 仍然 可 以 ， 但 是 已 经 多 余 了 。 


例子 
重建 一 个 单独 的 索引 : 


REINDEX INDEX my_index; 


重建 表 my_table 上 的 所 有 索引 : 


REINDEX TABLE my_table; 


重建 一 个 数据 库 上 的 所 有 系统 索引 ， 不 管 系统 索引 是 否 仍然 有 效 : 
$ <kbd class="literal">export PGOPTIONS="-P"</kbd> 
$ <kbd class="literal">psql broken_db</kbd> 


broken_db=> REINDEX DATABASE broken_db; 
broken_db=> \q 


兼容 性 


SQL 标准 里 没有 REINDEX 命令 。 


RELEASE SAVEPOINT 


Name 


RELEASE SAVEPOINT -- 删除 一 个 先前 定义 的 保存 点 


Synopsis 


RELEASE [ SAVEPOINT ] _savepoint_name_ 


摘 述 
RELEASE SAVEPOINT 删除 一 个 当前 事务 先前 定义 的 保存 点 。 


把 一 个 保存 点 删除 就 令 其 无 法 作为 回 滚 点 使 用 ， 除 此 之 外 它 没有 其 它 用 户 可 见 的 行为 。 它 并 
不 能 撤销 在 保存 点 建立 起 来 之 后 执行 的 命令 的 影响 。 要 撤销 那些 命令 可 以 使 用 ROLLBACK 
TO SAVEPOINT. 在 不 再 需要 的 时 候 删 除 一 个 保存 点 可 以 仿 系 统 在 事务 结束 之 前 提前 回收 一 


些 资源 。 


RELEASE SAVEPOINT 也 删除 指定 保存 点 之 后 建立 的 所 有 保存 点 。 


参数 


_Savepoint_name_ 


要 删除 的 保存 点 的 名 字 。 


声明 一 个 以 前 没有 定义 的 保存 点 名 字 将 导致 错误 。 

如 果 事 务 在 回 滚 状 态 ， 则 不 能 释放 保存 点 。 

如 果 多 个 保存 点 拥有 同样 的 名 字 ， 只 有 最 近 定 义 的 那个 才 被 释放 。 
例子 


建立 并 稍 后 删除 一 个 保存 点 : 


BEGIN; 
INSERT INTO table1 VALUES (3); 
SAVEPOINT my_savepoint; 
INSERT INTO table1 VALUES (4); 
RELEASE SAVEPOINT my_savepoint; 
COMMIT; 


上 面 的 事务 将 同时 插入 3 和 4。 


兼容 性 


这 条 命令 遵循 SQL 标准 。 标 准 规定 关键 字 sAvEpPoINT 是 必须 的 。 但 PostgreSQL 人 允许 省 略 它 。 


义 见 


BEGIN, COMMIT, ROLLBACK, ROLLBACK TO SAVEPOINT, SAVEPOINT 


RESET 


Name 


RESET -- 把 一 个 运行 时 参数 重 置 为 缺 省 值 


Synopsis 


RESET _configuration_parameter_ 
RESET ALL 


摘 述 
RESET 将 运行 时 参数 恢复 为 缺 省 值 。 RESET 是 下 面 语 句 的 一 个 变种 


SET _configuration_parameter_ TO DEFAULT 


请 参考 SET 命令 获取 详细 信息 。 


缺 省 值 是 变量 可 以 拥有 并 且 在 当前 会 话 中 没有 用 ser 设置 过 的 值 。 这 个 数值 的 实际 源头 可 能 
是 编译 时 的 缺 省 : 配置 文件 、 命 令 行 开 关 、 针 对 每 个 数据 库 或 每 用 户 的 缺 省 设置 。 这 与 将 它 
定义 为 "在 会 话 开始 时 该 参数 的 值 "有 轻微 的 不 同 ， 因 为 如 果 值 来 自 配置 文件 ， 将 会 被 重新 设 
置 为 现在 配置 文件 中 声明 的 东西 。 参 阅 Chapter 18 获 取 细 节 。 


RESET 的 事务 性 行为 和 set 相同 : 它 的 影响 将 会 被 事务 回 滚 撤销 。 


参数 


_configuration_parameter_ 


可 预 置 的 运行 时 参数 名 。 可 用 的 参数 在 Chapter 18 和 SET 参考 页 中 记录 。 


ALL 


把 所 有 运行 时 参数 设置 为 缺 省 值 。 


例子 


把 timezone 配置 变量 设 为 其 缺 省 值 : 


RESET timezone; 


RANE 


RESET 是 PostgreSQL 扩 展 。 


义 见 


SET, SHOW 


REVOKE 


Name 


REVOKE -- 删除 访问 权限 


Synopsis 


REVOKE [ GRANT OPTION FOR ] 


{ { SELECT | INSERT | UPDATE | DELETE | TRUNCATE | REFERENCES | TRIGGER } 


[, ...] | ALL [ PRIVILEGES ] } 
ON { [ TABLE ] _table_name_ [, ...] 

| ALL TABLES IN SCHEMA _schema_name_ [, . 
FROM { [ GROUP ] _role_name_ | PUBLIC } [, ...] 
[ CASCADE | RESTRICT ] 


REVOKE [ GRANT OPTION FOR ] 


SE 


{ { SELECT | INSERT | UPDATE | REFERENCES } ( _column_name_ [, 


[, ...] | ALL [ PRIVILEGES ] ( _column_name_ [, 
ON [ TABLE ] _table_name_ [, ...] 

FROM { [ GROUP ] _role_name_ | PUBLIC } [, ...] 
[ CASCADE | RESTRICT ] 


REVOKE [ GRANT OPTION FOR ] 
{ { USAGE | SELECT | UPDATE } 
[，...] | ALL [ PRIVILEGES ] } 
ON { SEQUENCE _sequence_name_ [, ...] 
| ALL SEQUENCES IN SCHEMA _schema_name_ [, 
FROM { [ GROUP ] _role_name_ | PUBLIC } [, ...] 
[ CASCADE | RESTRICT ] 


REVOKE [ GRANT OPTION FOR ] 
{ { CREATE | CONNECT | TEMPORARY | TEMP } [, 
ON DATABASE _database_name_ [, ...] 
FROM { [ GROUP ] _role_name_ | PUBLIC } [, ...] 
[ CASCADE | RESTRICT ] 


REVOKE [ GRANT OPTION FOR ] 
{ USAGE | ALL [ PRIVILEGES ] } 
ON DOMAIN _domain_name_ [, ...] 
FROM { [ GROUP ] _role_name_ | PUBLIC } [, ...] 
[ CASCADE | RESTRICT ] 


REVOKE [ GRANT OPTION FOR ] 
{ USAGE | ALL [ PRIVILEGES ] } 
ON FOREIGN DATA WRAPPER _fdw_name_ [, ... 
FROM { [ GROUP ] _role_name_ | PUBLIC } [, ...] 
[ CASCADE | RESTRICT ] 


REVOKE [ GRANT OPTION FOR ] 
{ USAGE | ALL [ PRIVILEGES ] } 
ON FOREIGN SERVER _server_name_ [, ...] 
FROM { [ GROUP ] _role_name_ | PUBLIC } [, ...] 
[ CASCADE | RESTRICT ] 


REVOKE [ GRANT OPTION FOR ] 
{ EXECUTE | ALL [ PRIVILEGES ] } 
ON { FUNCTION _function_name_ ( [ [ _argmode_ ] 


atc], J) oF 


-13 


[ _arg_name 


] 


-]) 


.] | ALL [ PRIVILEGES ] } 


arg_type 





| ALL FUNCTIONS IN SCHEMA _schema_name_ [, 
FROM { [ GROUP ] _role_name_ | PUBLIC } [, ...] 


phe lie 


[, 


:]] 


) 


[ CASCADE | RESTRICT ] 


REVOKE [ GRANT OPTION FOR ] 
{ USAGE | ALL [ PRIVILEGES ] } 
ON LANGUAGE _lang_name_ [, ...] 
FROM { [ GROUP ] _role_name_ | PUBLIC } [, ...] 
[ CASCADE | RESTRICT ] 


REVOKE [ GRANT OPTION FOR ] 
{ { SELECT | UPDATE } [, ...] | ALL [ PRIVILEGES ] } 
ON LARGE OBJECT _loid_ [, ...] 
FROM { [ GROUP ] _role_name_ | PUBLIC } [, ...] 
[ CASCADE | RESTRICT ] 


REVOKE [ GRANT OPTION FOR ] 
{ { CREATE | USAGE } [, ...] | ALL [ PRIVILEGES ] } 
ON SCHEMA _schema_name_ [, ...] 
FROM { [ GROUP ] _role_name_ | PUBLIC } [, ...] 
[ CASCADE | RESTRICT ] 


REVOKE [ GRANT OPTION FOR ] 
{ CREATE | ALL [ PRIVILEGES ] } 
ON TABLESPACE _tablespace_name_ [, ...] 
FROM { [ GROUP ] _role_name_ | PUBLIC } [, ...] 
[ CASCADE | RESTRICT ] 


REVOKE [ GRANT OPTION FOR ] 
{ USAGE | ALL [ PRIVILEGES ] } 
ON TYPE _type_name_ [, ...] 
FROM { [ GROUP ] _role_name_ | PUBLIC } [, ...] 
[ CASCADE | RESTRICT ] 


REVOKE [ ADMIN OPTION FOR ] 
_role_name_ [, ...] FROM _role_name_ [, ...] 
[ CASCADE | RESTRICT ] 





REVOKE 撤销 以 前 赋予 一 个 或 多 个 角色 的 权限 。 关 键 字 pwe 代表 隐 含 定义 的 、 拥 有 所 有 角 
色 的 组 。 


参阅 GRANT 命 命 的 描述 获取 权限 类 型 的 含义 。 


请 注意 ， 任 何 特定 的 角色 都 将 拥有 直接 赋予 它 的 权限 ， 加 上 它 所 在 组 的 权限 ， 再 加 上 赋 

予 puBLIC 的 权限 的 总 和 和。 因此 ， 举 例 来 说 ， 广 止 puw 的 sELEcT 权限 并 不 意味 着 所 有 角 
色 都 失去 了 对 该 对 象 的 sELEcT 权限 : 那些 直接 得 到 的 权限 以 及 通过 一 个 组 得 到 的 权限 仍然 有 
效 。 相 似 的 ， 废 止 一 个 用 户 的 sELEcT 权限 可 能 并 不 阻止 用 户 使 用 sect, WR puw 或 
其 他 成 员 组 仍然 拥有 SELECT 权限 。 


如 果 指 定 了 GRANT OPTION FoR ， 那 么 只 是 撤销 对 该 权限 的 授权 的 权力 ， 而 不 是 撤销 该 权限 本 
身 。 否 则 ， 权 限 和 授权 选项 都 被 撤销 。 


如 果 一 个 用 户 持 有 某 个 权限 ， 并 且 还 有 授权 的 选项 ， 并 且 还 把 这 个 权限 赋予 了 其 它 用 户 ， 那 
么 那些 其 它 用 户 持 有 的 权限 都 叫做 依赖 性 权限 。 如 果 第 一 个 用 户 持 有 的 权限 或 者 授权 选项 被 
撤销 ， 而 依赖 性 权限 仍然 存在 ; 那么 如 果 声 明了 cAscApE ， 则 所 有 依赖 性 权限 都 被 撤销 ， A 


则 撤销 动作 就 会 失败 。 这 个 递 规 的 撤销 只 影响 那 种 通过 一 个 用 户 链 赋予 的 权限 ， 这 个 链条 可 
以 通过 这 条 Revoke 命令 里 面 给 出 的 用 户 跟 踪 。 因 此 ， 如 果 权 限 本 身 是 通过 其 它 用 户 赋予 的 ， 
那么 被 影响 的 用 户 可 以 有 效 地 保留 这 个 权限 。 


当 在 表 上 撤销 权限 时 ， 相 应 的 字段 权限 〈 如 果 有 ) 也 自动 撤销 。 另 一 方面 ， 如 果 已 经 赋予 了 
一 个 角色 在 表 上 的 权限 ， 那 么 在 单独 的 字段 上 删除 相同 的 权限 将 不 会 有 作用 。 


在 撤销 一 个 角色 里 的 成 员 关 系 的 时 候 ， 不 是 调用 avin option 而 是 调用 Grant option, (A 
行为 类 似 。 不 过 这 种 形式 的 命令 不 允许 出 现 croup 噪声 字 。 


<= ate 


) 王 局 


使 用 psql 的 \dp 命令 显示 在 一 个 现存 表 和 字段 上 赋予 的 权限 。 又 见 GRANT 获 取 关 于 格式 的 信 
息 。 对 于 非 表 对 象 ， 可 以 使 用 \d 命令 显示 他 们 的 权限 。 


一 个 用 户 只 能 撤销 由 它 自己 直接 赋予 的 权限 。 举 例 来 涪 ， 如 果 用 户 人 带 着 授权 选项 把 一 个 权 
限 赋予 了 用 户 B， 然后 用 户 B 又 赋予 了 用 户 C ， 那 么 用 户 A 不 能 直接 将 C 的 权限 撤销 。 但 
是 ， 用 户 人 A 可 以 撤销 用 户 B 的 授权 选项 ， 并 且 使 用 cAscApE 选项 ， 这 样 ， 用 户 C 的 权限 就 
会 自动 被 撤销 。 另 外 一 个 例子 : 如 果 入 和 B 都 赋予 了 C 同样 的 权限 ， 则 A 可 以 撤销 他 自己 
的 授权 选项 ， 但 是 不 能 撤销 B 的 ， 因 此 C 仍然 有 效 地 拥有 该 权限 。 


如 果 一 个 对 象 的 非 所 有 者 试图 Revoke 对 象 上 的 权限 ， 那 么 ， 如 果 这 个 用 户 没有 该 对 象 上 的 权 
R, 则 命令 马上 失败 。 只 要 他 有 某 些 权限 ， 则 命令 继续 ， 但 是 它 只 撤销 那些 该 用 户 有 授权 选 
项 的 权限 。 如 果 没 有 在 授权 选项 ， 那 么 REVOKE ALL PRIVILEGES 形式 将 发 出 一 个 错误 信息 ， 而 
对 于 其 它 形式 的 命令 而 言 ， 如 果 同 样 是 命令 中 指定 名 字 的 权限 没有 相应 的 授权 选项 ， 那么 该 
命令 将 发 出 一 个 警告 。 原 则 上 这 些 语句 也 适用 于 对 象 所 有 者 ， 但 是 因为 所 有 者 总 是 认为 持 有 
所 有 授权 选项 ， 所 以 这 种 情况 绝 不 会 发 生 。 


如 果 一 个 超级 用 户 发 出 一 个 GRANT 或 REVOKE 命令 ， 那 么 命令 是 以 被 影响 的 对 象 的 所 有 者 执 
行 的 。 因 为 所 有 权限 最 终 从 对 象 所 有 者 (可 能 间接 通过 赋 权 选项 ) 获 取 ， 超 级 用 户 可 以 废除 所 
有 权限 ， 但 是 这 样 就 要 求 像 上 面 说 的 那样 使 用 cAscApE o 


REVOKE 也 可 以 由 一 个 并 非 被 影响 对 象 的 所 有 者 来 执行 ， 不 过 这 个 角色 必须 是 拥有 该 对 象 的 角 
色 的 成 员 ， 或 者 是 一 个 在 该 对 象 上 持 有 WITH GRANT option 的 角色 的 成 员 。 在 这 种 情况 下 ， 
该 命令 执行 起 来 就 好 像 是 由 实际 拥有 该 对 象 的 角色 ， 或 者 是 在 该 对 象 上 持 有 

WITH GRANT OPTION 权限 的 角色 发 出 的 一 样 。 比 如 ， 如 果 表 ti Moi MA, Mu = g1 的 
MA, ABA ur 可 以 撤销 tt 上 的 权限 ， 而 纪录 为 gt 发 出 的 命 舍 。 这 种 现 像 包 括 ui 和 其 
它 g 角色 成 员 发 出 的 授权 。 


如 果 执 行 revoke 的 角色 持 有 权限 是 通过 多 层 成 员 关 系 获得 的 ， 那么 具体 是 哪个 包含 的 角色 执 
行 的 该 命令 就 是 未 声明 的 。 在 这 种 场合 下 ， 最 好 的 方法 是 使 用 set ROLE 成 为 你 希望 执 

ÍT Revoke 的 角色 。 不 这 人 么 做 的 后 果 可 能 导致 删除 你 不 想 删 除 的 权限 ， 或 者 是 啥 权限 都 没有 删 
BR 


例子 
撤销 公众 在 表 films 上 的 插入 权限 : 


REVOKE INSERT ON films FROM PUBLIC; 


撤销 用 户 manuel 对 视图 kinds 的 所 有 权限 : 


REVOKE ALL PRIVILEGES ON kinds FROM manuel; 


请 注意 这 样 实 际 上 意味 着 "撤销 所 有 我 赋予 的 权限 "。 
删除 用 户 joe 的 admins 成 员 关 系 : 


REVOKE admins FROM joe; 


RAIE 


GRANT 命令 的 兼容 性 信息 基本 上 也 适用 于 Revoke 。 标准 要 求 RESTRICT 或 CASCADE 必须 出 
m, 但 是 PostgreSQL 假 设 缺 省 是 RESTRICT o 


义 见 


GRANT 


ROLLBACK 


Name 


ROLLBACK -- 退出 当前 事务 


Synopsis 


ROLLBACK [ WORK | TRANSACTION | 


fia ah 


ROLLBACK 回 滚 当前 事务 并 取消 当前 事务 中 的 所 有 更 新 。 


参数 


WORK ` ` TRANSACTION 


可 选 的 关键 字 。 没 有 作用 。 


NA at 


) 王 局 


使 用 COMMIT 语 句 将 对 事务 进行 提交 。 


如 果 不 在 一 个 事务 内 部 发 出 RoLLBAcK 不 会 有 问题 ， 但 是 将 抛 出 一 个 警告 信息 。 


例子 
取消 所 有 更 改 : 


ROLLBACK; 


RANE 


SQL 标准 只 声明 了 两 种 形式 ROLLBACK 和 ROLLBACK woRK 。 否则 完全 兼容 。 
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XI 


BEGIN, COMMIT, ROLLBACK TO SAVEPOINT 


ROLLBACK 1892 


ROLLBACK PREPARED 


Name 


ROLLBACK PREPARED -- 取消 一 个 先前 为 两 阶段 提交 准备 好 的 事务 


Synopsis 


ROLLBACK PREPARED _transaction_id_ 


摘 述 


ROLLBACK PREPARED 回 滚 一 个 处 于 准备 好 状态 的 事务 。 


参数 


_transaction_id_ 


要 回 滚 掉 的 事务 的 事务 标识 符 。 


MN N 
ťia 


要 想 回 滚 掉 一 个 预备 事务 ， 你 必须 要 么 是 最 初 发 起 事务 的 用 户 ， 要 么 是 超级 用 户 。 但 你 不 必 
在 执行 事务 的 同一 个 会 话 里 。 


这 条 命令 不 能 在 事务 块 里 执行 。 预 各 事务 将 被 马上 回 滚 。 
所 有 当前 可 用 的 预备 事务 都 在 系统 视图 pg_prepared xacts 中 列 出 。 


例子 
回 滚 一 个 使 用 事务 标识 符 foobar 标识 的 事务 : 


ROLLBACK PREPARED 'foobar'; 


ROLLBACK PREPARED 是 PostgreSQL 的 扩展 。 是 为 外 部 事务 管理 系统 设计 的 ， 一 些 被 标准 (比如 
X/Open XA) 所 覆盖 ， 但 是 SQL 方 面 的 这 些 系 统 是 非 标 准 化 的 。 


义 见 


PREPARE TRANSACTION, COMMIT PREPARED 


ROLLBACK TO SAVEPOINT 


Name 


ROLLBACK TO SAVEPOINT -- 回 滚 到 一 个 保存 点 


Synopsis 


ROLLBACK [ WORK | TRANSACTION ] TO [ SAVEPOINT ] _savepoint_name_ 


fa ah 


DARABERGREVLZEATHeED. RERDAAM, FARE TOURER EZ 
点 


No 


ROLLBACK TO SAVEPOINT 隐 含 地 删除 所 有 在 该 保存 点 之 后 建立 的 保存 点 。 


参数 


_Savepoint_name_ 


回 滚 截至 的 保存 点 。 


= a 


) 王 局 


使 用 RELEASE SAVEPOINT 删 除 一 个 保存 点 ， 而 不 会 抛弃 这 个 保存 点 建立 之 后 执行 的 命 合 结 
果 。 


声明 一 个 还 没有 建立 的 保存 点 名 字 是 一 个 错误 。 


在 保存 点 方面 ， 游 标 有 一 些 非 事务 性 的 行为 。 任 何在 保存 点 里 打开 的 游标 都 会 在 回 滚 掉 这 个 
保存 点 之 后 关闭 。 如 果 一 个 前 面 打开 了 的 游标 在 保存 点 里 面 ， 并 且 游 标 被 一 

个 FETCH 或 move 命令 影响 ， 而 这 个 保存 点 稍 后 回 滚 了 ， 那 么 这 个 游标 仍然 在 FETcH 让 它 指 
向 的 位 置 (也 就 是 ， 由 FETcH 造成 的 游标 动作 不 会 被 回 滚 )。 关 闭 一 个 游标 的 行为 也 不 会 被 回 
滚 给 撤消 掉 。 但 是 ， 如 果 由 游标 查询 引起 的 副作用 (如 查询 调用 不 稳定 函数 引起 的 副作用 ) 

在 一 个 稍 后 会 回 滚 的 保存 点 发 生 ， 那么 他 们 也 会 回 滚 。 如 果 一 个 游标 的 操作 导致 事务 回 滚 ， 

那么 这 个 游标 就 会 置 于 不 可 执行 状态 。 所 以 ， 尽 管 一 个 事务 可 以 用 RoLLBACK To SAVEPOINT 重 
新 恢复 ， 但 是 游标 不 能 再 使 用 了 。 


例子 
撤销 my_savepoint 建立 之 后 执行 的 命令 的 影响 : 


ROLLBACK TO SAVEPOINT my_savepoint; 


游标 位 置 不 受 保存 点 回 滚 的 影响 : 


BEGIN; 
DECLARE foo CURSOR FOR SELECT 1 UNION SELECT 2; 
SAVEPOINT foo; 


FETCH 1 FROM foo; 
?column? 


ROLLBACK TO SAVEPOINT foo; 


FETCH 1 FROM foo; 
?column? 


COMMIT; 


兼容 性 


SQL 标 准 声明 关键 字 savepornt 是 必须 的 ， 但 是 PostgreSQL 和 Oracle 人 允许 省 略 saverornt 关 
键 字 。SQL 只 人 允许 work 而 不 是 TRANSACTION 作为 RoLLBACK 后 面 的 无 意义 关键 字 。 还 有 ， 
SQL 有 一 个 可 选 的 AND [ no ] charn 子 句 ， 目 前 PostgreSQL 还 不 支持 。 否则 ， 这 个 命 命 完 
全 兼容 SQL 标准 。 


义 见 


BEGIN, COMMIT, RELEASE SAVEPOINT, ROLLBACK, SAVEPOINT 


SAVEPOINT 


Name 


SAVEPOINT -- 在 当前 事务 里 定义 一 个 新 保存 点 


Synopsis 


SAVEPOINT _savepoint_name_ 


摘 述 
SAVEPOINT 在 当前 事务 里 建立 一 个 新 的 保存 点 。 


保存 点 是 事务 中 的 一 个 特殊 记号 ， 它 允许 将 那些 在 它 建立 后 执行 的 命令 全 部 回 滚 ， 把 事务 的 
状态 恢复 到 保存 点 所 在 的 时 刻 。 


参数 


_savepoint_name_ 


赋予 新 保存 点 的 名 字 。 


= a 


) 王 局 


使 用 ROLLBACK TO SAVEPOINT 回 滚 到 一 个 保存 点 。 使 用 RELEASE SAVEPOINT 删除 一 个 
保存 点 ， 但 是 保留 该 保存 点 建立 后 执行 的 命令 的 效果 。 


保存 点 只 能 在 一 个 事务 块 里 面 建立 。 在 一 个 事务 里 面 可 以 定义 多 个 保存 点 。 


例子 


建立 一 个 保存 点 ， 稍 后 撤销 这 个 保存 点 建立 后 执行 的 所 有 命令 的 结果 : 


BEGIN; 
INSERT INTO table1 VALUES (1); 
SAVEPOINT my_savepoint; 
INSERT INTO table1 VALUES (2); 
ROLLBACK TO SAVEPOINT my_savepoint; 
INSERT INTO table1 VALUES (3); 
COMMIT; 


上 面 的 事务 将 插入 数值 1 和 3 ， 而 不 会 插入 2 。 
建立 并 稍 后 删除 一 个 保存 点 : 


BEGIN; 
INSERT INTO table1 VALUES (3); 
SAVEPOINT my_savepoint; 
INSERT INTO table1 VALUES (4); 
RELEASE SAVEPOINT my_savepoint; 
COMMIT; 


上 面 的 事务 将 插入 3 和 4。 


兼容 性 


SQL 要 求 在 另外 一 个 同名 保存 点 建立 的 时 候 自动 删除 前 面 那个 同名 保存 点 。 在 PostgreSQL 
里 ， 将 保留 旧 的 保存 点 ， 但 是 在 回 滚 或 者 释放 的 时 候 ， 只 使 用 最 近 的 那个 。 

用 RELEASE SAVEPOINT 释放 了 新 的 保存 点 将 导致 日 的 再 次 成 为 

ROLLBACK TO SAVEPOINT 和 RELEASE SAVEPOINT 可 以 访问 的 保存 点 。 AMI, SAVEPOINT 是 完全 


符合 SQL 标准 的 。 


义 见 


BEGIN, COMMIT, RELEASE SAVEPOINT, ROLLBACK, ROLLBACK TO SAVEPOINT 


SECURITY LABEL 


Name 


SECURITY LABEL -- 定义 或 改变 一 个 应 用 于 对 象 的 安全 标签 


Synopsis 


SECURITY LABEL [ FOR _provider_ ] ON 
{ 
TABLE _object_name_ | 
COLUMN _table_name_._column_name_ | 
AGGREGATE _agg_name_ (_agg_type_[, ...] ) | 
DATABASE _object_name_ | 
DOMAIN _object_name_ | 
EVENT TRIGGER _object_name_ | 
FOREIGN TABLE _object_name_ 
FUNCTION _function_name_ ( [ [ _argmode_ ] [ _argname_ ] _argtype_[, ...] ] ) | 
LARGE OBJECT _large_object_oid_ | 
MATERIALIZED VIEW _object_name_ | 
[ PROCEDURAL ] LANGUAGE _object_name_ | 
ROLE _object_name_ | 
SCHEMA _object_name_ | 
SEQUENCE _object_name_ | 
TABLESPACE _object_name_ | 
TYPE _object_name_ | 
VIEW _object_name_ 
} IS '_label_' 











fia ah 


SECURITY LABEL 为 一 个 数据 库 对 象 申 请 一 个 安全 标签 。 每 一 个 标签 提供 程序 的 任意 数量 的 安 
全 标签 都 可 以 与 一 个 给 定 的 数据 库 对 象 关 联 。 标签 提供 者 是 可 加 载 模块 ， 通 过 使 用 画 
数 register_label_provider 记录 他 们 自己 。 


Note: register_label_provider 不 是 SQL 辑 数 ; 只 能 从 C 代 码 存 人 后 端 调用 。 


标签 提供 者 决定 一 个 给 定 的 标签 是 否 有 效 ， 并 且 是 否 允 许 将 那个 标签 分 配给 一 个 给 定 的 对 

ee 或 如 何 
解释 安全 标签 ; 只 是 提供 过 一 个 存储 它们 的 机 制 。 实 际 上 ， 这 个 便利 是 为 了 人 允许 集成 基于 标 
ae ee a 
签 ， 而 不 是 传统 的 自主 访问 控制 (DAC) 概念 ， 如 用 户 和 组 。 


参数 


object_name_~~_table_name.column_name agg_name function_name_ 








有 标签 的 对 象 的 名 字 。 可 模式 修饰 的 表 、 集 群 、 域 、 外 部 表 、 画 数 、 序 列 、 类 型 和 视图 的 名 
字 。 

_provider_ 

与 这 个 标签 相关 的 提供 者 的 名 字 。 被 指名 的 提供 者 必须 被 加 载 并 且 必 须 同 意 提出 的 标签 操 
作 。 如 果 只 加 载 了 一 个 提供 者 ， 那 么 为 了 简洁 会 省 略 提供 者 的 名 字 。 

_arg_type_ 

RSVR AGED, BSA-TSSMORRDR, iQ AMEX BOVE 
写 二 o 

_argmode_ 

HASHIR : IN, OUT, INOUT , 或 vARIADIC 。 如 果 省 略 ， 缺 省 是 IN 。 请 注 

意 


， SECURITY LABEL ON FUNCTION 并 不 实际 注意 our 参数 ， 因 为 只 需要 和 输入 参数 判断 函数 的 
安全 。 所 以 列 出 IN, Inout , 和 vARIADIC 就 足够 了 。 


_argname_ 


HASRA. At, SECURITY LABEL ON FUNCTION 并 不 实际 注意 参数 名 字 ， 因 为 只 需 
参数 数据 类 型 判断 函数 的 身份 。 


_argtype_ 


MAB, ERKASI EE (可 以 有 模式 修饰 ) 。 


large_object_oid 





大 对 象 的 OID。 


PROCEDURAL 


新 的 安全 标签 ， 写 作 一 个 字符 串 ; 或 nur, 以 删除 安全 标签 。 


例子 
下 列 例子 显示 了 如 何 改变 一 个 表 的 安全 标签。 


SECURITY LABEL FOR selinux ON TABLE mytable IS 'system_u:object_r:sepgsql_table_t:s0'; 


兼容 性 
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SQL 标准 中 没有 SECURITY LABEL M Po 


义 见 


sepgsql, dummy_seclabel 


SECURITY LABEL 1901 


SELECT 


Name 


SELECT, TABLE, WITH -- 从 表 或 视图 中 取出 若干 行 


Synopsis 


[ WITH [ RECURSIVE ] _with_query_ [, ...] ] 
SELECT [ ALL | DISTINCT [ ON ( _expression_ [, ...] ) ] ] 
* | _expression_ [ [ AS ] _output_name_ ] [, ...] 
FROM _from_item_[, ...] ] 
WHERE _condition_ ] 
GROUP BY _expression_ [, ...] ] 
HAVING _condition_ [, ...] ] 
WINDOW _window_name_ AS ( _window_definition_ ) [, ...] ] 





{ UNION | INTERSECT | EXCEPT } [ ALL | DISTINCT ] _select_ ] 

ORDER BY _expression_ [ ASC | DESC | USING _operator_ ] [ NULLS { FIRST | LAST } ] 
LIMIT { _count_ | ALL } ] 

OFFSET _start_ [ ROW | ROWS ] ] 

FETCH { FIRST | NEXT } [ _count_ ] { ROW | ROWS } ONLY ] 

FOR { UPDATE | NO KEY UPDATE | SHARE | KEY SHARE } [ OF _table_name_ [, ...] ] [ NO 


Eee Oe ee Oe Be Oe ee Be et et 


这 里 的 `” from_item_ ”可 以 是 : 

















[ ONLY ] _table_name_ [ * ] [ [ AS ] _alias_ [ ( _column_alias_ [, ...] ) ] ] 

[ LATERAL ] ( _select_ ) [ AS ] _alias_ [ ( _column_alias_[, ...] ) ] 
with_query_name_ [ [ AS ] _alias_ [ ( _column_alias_[, ...] ) ] ] 

[ LATERAL ] _function_name_ ( [ _argument_ [, ...] ] ) [ AS ] _alias_ [ ( _column_ali 

[ LATERAL ] _function_name_ ( [ _argument_ [, ...] ] ) AS ( _column_definition_ [, .. 


_from_item_ [ NATURAL ] _join_type from_item_ [ ON _join_condition_ | USING ( _join 





` with_query “是 : 


with_query_name_ [ ( _column_name_ [, ...] ) ] AS ( _select_ | _values insert_ | 








TABLE [ ONLY ] _table_name_ [ * ] 





SELECT H#MSBPRESRAPRGHT. serect 通常 的 处 理 如 下 : 


1. 计算 列 出 在 w 中 的 所 有 查询 。 这 些 有 效 的 充当 可 以 在 FRoM 列表 中 引用 的 临时 表 。 一 
个 在 FRoM 中 多 次 引用 的 with 查询 只 计算 一 次 。 (参阅 下 面 的 WITH F ) 


2. 计算 列 出 在 FRoM 中 的 所 有 元 素 ( FROM 列表 中 的 每 个 元 素 都 是 一 个 实际 的 或 虚拟 的 表 )。 
如 果 在 Fon 列表 里 声明 了 多 个 元 素 ， 那 么 他 们 就 交叉 连接 在 一 起 (参见 下 面 的 FROWM F 
句 )。 


3. 如 果 声 明了 wer 子 句 ， 那 么 在 输出 中 消除 所 有 不 满足 条 件 的 行 。 (参见 下 面 的 
WHERE 子 句 。) 


4 如果 声 明了 croup BY 子 句 ， 输 出 就 组 合成 匹配 一 个 或 多 个 数值 的 不 同 组 里 。 如 果 出 现 
了 HAVING 子 句 ， 那 么 它 消 除 那些 不 满足 给 出 条 件 的 组 。 “参见 下 面 的 GROUP BY 子 句 
和 HAVING 子 句 。) 


5 实际 输出 行业 使 用 sELEcT 输出 表达 式 针 对 每 一 个 选中 的 行 或 行 组 进行 计算 。 (参见 下 面 
的 SELECT 列表 。 ) 


6. SELECT DISTINCT 从 结果 中 消除 重复 的 行 。 sELECT DISTINCT on 消除 匹配 所 有 指定 表达 式 
的 行 。 SELECT ALL (MA) 返回 所 有 的 行 ， 包括 重复 的 行 。 (参阅 下 面 的 DISTINCT 子 
句 。 ) 


7. 使 用 UNION , intersect ， Except 可 以 把 多 个 SELECT 语句 的 输出 合并 成 一 个 结果 
集 。 union 操作 符 返 回 两 个 结果 集 的 并 集 。 INTERSECT 操作 符 返 回 两 个 结果 集 的 交集 。 
EXCEPT 操作 符 返 回 在 第 一 个 结果 集 对 第 二 个 结果 集 的 差 集 。 不 管 哪 种 情况 ， 重复 的 行 都 
被 删除 ， 除 非 声 明了 a o IREF prsTINcT 可 以 用 来 明确 的 声明 消除 重复 的 行 。 请 注 
意 ， pIsTINCT 在 这 里 是 缺 省 的 行为 ， 即使 aL 是 sELEcT 本 身 的 缺 省 。 (BM FHM 
UNION 子 句 、/NTERSECT 子 句 、 EXCEPT 子 句 。) 


8， 如 果 声 明了 orr BY 子 句 ， 那 么 返回 的 行将 按照 指定 的 顺序 排序 。 如 果 没 有 给 
出 oRDER BY ， 那 么 数据 行 是 按照 系统 认为 可 以 最 快 生 成 的 顺序 给 出 的 。 (参阅 下 面 的 
ORDER BY 子 句 。) 


9. 如果 给 出 了 LIMIT (或 FETCH FIRST ) 或 oFFSET 子 句 ， 那 么 SELECT 语句 只 返回 结果 行 的 
一 个 子 集 。 (参阅 下 面 的 LIMIT F. ) 


10. 如 果 声 明了 For UPDATE , FOR NO KEY UPDATE , FOR SHARE 或 FOR KEY SHARE 子 句 ， 那 


4 sELECT 语句 对 并 发 的 更 新 锁 住 选 定 的 行 。 (参阅 下 面 的 锁定 子 句 子 句 。) 


你 必须 对 每 个 在 SELECT 命令 中 使 用 的 字段 有 seLEcT 权限 。 使 用 FOR NO KEY UPDATE , 
FOR UPDATE , FOR SHARE 或 FOR KEY SHARE 还 要 求 UPDATE 权限 (至 少 选择 每 个 表 的 一 列 ) 。 


参数 


WITH 子 句 


WITH 子 句 允许 声明 一 个 或 多 个 可 以 在 主 查询 中 通过 名 字 引 用 的 子 查询 。 子 查询 在 主 查 询 期 
间 有 效 的 充当 临时 表 或 视图 。 每 个 子 查询 可 以 是 SELECT, VALUES, INSERT, UPDATE 或 
DELETE 语句 。 当 在 with 中 写 一 个 数据 修改 语句 时 ( INSERT, UPDATE 或 DELETE) ， 通 常 
包含 一 个 RETURNING 子 句 。 RETURNING 的 输出 而 不 是 语句 修改 的 底层 表 的 输出 形成 被 主 查询 
读 取 的 临时 表 。 如 果 省 略 了 RETURNING ， 该 语句 仍然 执行 ， 但 是 不 会 产生 输出 ， 所 以 不 能 作 
为 一 个 表 被 主 查 询 引 用 。 


必须 为 每 个 WITH 查询 声明 一 个 名 字 〈 没 有 模式 修饰 ) 。 可 选 的 ， 可 以 指定 字段 名 的 列表 ; 
如 果 省 略 了 ， 那 么 字段 名 从 子 查询 中 推断 出 。 


如 果 声 明了 recursive ， 那 么 允许 sect 子 查询 通过 名 字 引 用 它 自 己 。 比如 一 个 有 下 面 形式 
的 子 查询 


_non_recursive_term_ UNION [ ALL | DISTINCT ] _recursive_term_ 


递归 的 自我 引用 必须 在 wro DAMM. FAAARA DA MARA. 不 支持 递 
愉 的 数据 修改 语句 ， 但 是 可 以 在 数据 修改 语句 中 使 用 递 妆 的 SELECT 查询 的 结果 。 参 
iJ Section 7.8 获 取 一 个 例子 。 


RECURSIVE 的 另外 一 个 作用 是 with 查询 不 需要 排序 : 一 个 查询 可 以 引用 另外 一 个 稍 后 出 现在 
列表 中 的 查询 。 (但 是 ， 循 环 引 用 或 相互 递归 没有 实现 。) 没有 RECURSIVE, WITH 查询 只 能 
引用 更 早出 现在 wITH 列表 中 的 同 层 级 的 with 查询 。 


with 查询 的 主要 特性 是 他 们 只 在 主 查 询 的 每 次 执行 中 评估 一 次 ， 即使 主 查 询 引 用 了 他 们 多 
次 也 是 如 此 。 特 别 的 ， 保 证 数据 修改 语句 只 被 执行 一 次 ， 不 管 主 查询 读 取 他 们 的 所 有 或 任意 
的 输出 。 

主 查 询 和 with 查询 (理论 上 ) 同时 执行 。 这 意味 着 w 中 的 数据 修改 语句 的 影响 不 能 从 查 
询 的 其 他 部 分 看 到 ， 除 非 读 取 它 的 RETURNING 输出 。 如 果 两 个 这 样 的 数据 修改 语句 尝试 修改 
相同 的 行 ， 那 么 结果 是 未 知 的 。 


参阅 Section 7.8 获 取 额 外 的 信息 。 


FROM +‘) 


FROM 子 句 为 SELECT 声明 一 个 或 者 多 个 源 表 。 如 果 声 明了 多 个 源 表 ， 那么 结果 就 是 所 有 源 表 
的 笛 卡 儿 积 (交叉 连接 )。 但 是 通常 会 添加 一 些 条 件 (通过 wer ) , 把 返回 行 限 制 成 笛 卡 儿 
积 的 一 个 小 的 子 集 。 


FROM 子 句 可 以 包括 下 列 元 素 : 
_table_name_ 
一 个 现存 的 表 或 视图 的 名 字 (可 以 有 模式 修饰 )。 如 果 声 明了 oNLY ， 则 只 扫描 该 表 ; 否则 ， 该 


表 和 所 有 其 派生 表 ( 如 果 有 的 话 ) 都 被 扫描 。 可 以 在 表 名 后 面 跟 一 个 * 表示 扫描 所 有 其 后 代 
Ro 


_alias_ 
为 那些 包含 别名 的 FRoM 项 目 取 的 别名 。 别 名 用 于 缩写 或 者 在 自 连接 中 消除 歧义 ( 自 连接 中 同 


一 个 表 将 扫描 多 次 )。 如 果 提 供 了 别名 ， 那 么 它 就 会 完全 隐藏 表 或 者 函数 的 实际 名 字 ; 比如 ， 
如 果 给 出 FRoM foo As f, ABA seLEcT 剩 下 的 东西 必须 把 这 个 FRoM 项 按照 f 而 不 是 foo 引 


用 。 如 果 写 了 别名 ， 也 可 以 提供 一 个 字段 别名 列表 ， 这 样 可 以 替换 表 中 一 个 或 者 多 个 字段 的 
名 字 。 

_select_ 

可 以 在 FRoM 子 句 里 出 现 一 个 子 SELECT o 它 的 输出 作用 好 像 是 为 这 条 sELEcT 命令 在 其 生存 
期 里 创建 一 个 临时 表 。 请 注意 这 个 子 SELECT 必须 用 园 括 红包 围 。 并 且 必 须 给 它 一 个 别名 。 
当然 ，VALUES 同 样 也 可 以 在 这 里 使 用 。 


with_query_name 





WITH 查询 通过 写 它 自己 的 名 字 来 引用 ， 就 像 查询 的 名 字 就 是 一 个 表 的 名 字 。 (KM 
E, WITH 查询 为 主 查询 隐藏 了 相同 名 字 的 任意 实际 表 。 如 果 需 要 ， 可 以 通过 模式 限定 表 的 
名 字 来 引用 相同 名 字 的 实际 表 。) 别名 可 以 用 相同 的 方式 提供 给 表 。 


_function_name_ 


函数 (特别 是 那些 返回 结果 集 的 函数 ) 调 用 可 以 出 现在 FRoM FOB, 这 么 做 就 好 像 在 这 

个 sELEcT 命 合 的 生命 期 中 ， 把 函数 的 输出 创建 为 一 个 临时 表 一 样 。 当然 也 可 以 使 用 别名 。 如 
果 写 了 别名 ， 还 可 以 写 一 个 字段 别名 列表 ， 为 函数 返回 的 复合 类 型 的 一 个 或 多 个 属性 提供 名 
FH MRNA L ARE record 类 型 ， 那么 必须 出 现 一 个 As 关键 字 或 者 别名 ， 后 面 跟 
着 一 个 形 如 ( column_name data_type_ [,...] ) 的 字段 定义 列表 。 这 个 字段 定义 列表 必须 
匹配 范 数 返回 的 字段 的 实际 数目 和 类 型 。 





_join_type_ 

下 列 之 一 : 
e [ INNER ] JOIN 
@ LEFT [ OUTER ] JOIN 
@ RIGHT [ OUTER ] JOIN 
@ FULL [ OUTER ] JOIN 
© CROSS JOIN 


必须 为 INNER 和 ouTER 连接 类 型 声明 一 个 连接 条 件 ， 也 就 是 NATURAL , ON 
_join_condition , OF USING (**_join_column_ [,...]J)Z—. 它们 的 含义 见 下 文 ， 对 
于 cross JOIN 而 言 ， 这 些 子 句 都 不 能 出 现 。 


一 个 JoIN 子 句 组 合 两 个 FROM 项 ， 为 了 方便 我 们 将 其 作为 "tables" 引用 ， 尽 管 实 际 上 他 们 可 
以 是 任意 Fon 条 目的 类 型 。 必 要 时 使 用 圆 括 弧 以 决定 伐 套 的 顺序 。 如 果 没 有 圆 括 
弧 ， JoIN MARAE, EEA F, soi ABLES ARR From 列表 绑 定 得 更 紧 。 


CROSS JOIN 和 INNER JOIN 生成 一 个 简单 的 笛 卡 儿 积 ， 和 你 在 FRoM 的 顶层 列 出 两 个 表 的 结果 
相同 ， 但 是 受到 连接 条 件 (GORA) 的 限制 。 cRoss Jorn 等 效 于 INNER JOIN ON (TRUE) , tE 
就 是 说 ， 没有 被 条 件 删 除 的 行 。 这 种 连接 类 型 只 是 符号 上 的 方便 ， 因 为 它们 和 你 用 简单 的 


FROM 和 WHERE 的 效果 一 样 。 

LEFT OUTER JOIN 返回 笛 卡 儿 积 中 所 有 符合 连接 条 件 的 行 ， 再 加 上 左 表 中 通过 连接 条 件 没有 匹 
配 右 表 行 的 那些 行 。 这 样 ， 左 边 的 行将 扩展 成 生成 表 的 全 长 ， 方法 是 在 那些 右 表 对 应 的 字段 
位 置 填 上 NULL 。 请 注意 ， 只 在 计算 匹配 的 时 候 ， 才 使 用 JorN 子 句 的 条 件 ， 外 层 的 条 件 是 
在 计算 完毕 之 后 施加 的 。 

相应 的 ， RIGHT ouTER JOIN 返回 所 有 内 连接 的 结果 行 ， 加 上 每 个 不 匹配 的 右边 行 (左边 用 
NULL 扩展 )。 这 只 是 一 个 符号 上 的 便利 ， 因为 总 是 可 以 把 它 转换 成 一 个 LEFT OUTER JOIN ， 

只 要 把 左边 和 右边 的 输入 对 掉 一 下 即 可 。 

FULL OUTER JOIN 返回 所 有 内 连接 的 结果 行 ， 加 上 每 个 不 匹配 的 左边 行 (右边 用 NULL 扩展 )， 
再 加 上 每 个 不 匹配 的 右边 行 (左边 用 NULL 扩展 )。 


ON _join_condition_ 
一 个 生成 boolean 类 型 结果 的 表达 式 (类 似 wer FAD), 限定 连接 中 那些 行 是 匹配 的 。 
USING ( _join_column_ [, ...] ) 


一 个 形 如 ustne ( a, b, ... ) WA, 

是 ON left_table.a = right_table.a AND left_table.b = right_table.b... 的 缩写 。 同 

$, USING 音 涵 着 每 对 等 效 字 段 中 只 有 一 个 包含 在 连接 输出 中 ， 而 不 是 两 个 都 输出 的 意思 。 
NATURAL 

NATURAL 是 一 个 usIN6 列表 的 缩写 ， 这 个 列表 说 的 是 两 个 表 中 同名 的 字段 。 


LATERAL 


LATERAL 关键 字 可 以 放 在 一 个 子 sELECT From 项 目的 前 面 。 这 允许 子 SELECT 引用 出 现 
在 FRoM 列表 之 前 的 FRoM 条 目 中 的 字段 。 (没有 LATERAL ， 每 个 子 SELECT 独立 评估 并 且 以 
此 不 能 交叉 引用 任何 其 他 FRoM 条 目 。) 


LATERAL 也 可 以 放 在 一 个 函数 调用 FRoM 条 目的 前 面 ， 但 是 这 种 情况 下 它 是 一 个 噪声 字 ， 
为 函数 表达 式 可 以 在 任何 情况 下 引用 前 面 的 Fom 条 目 。 


LATERAL 可 以 出 现在 FROM 列表 的 顶层 ， 或 出 现在 JoIN 树 中 。 在 后 面 当前 情况 下 ， 它 也 可 以 
引用 Jorm 左 侧 和 右 侧 的 任意 条 目 。 


当 FRoM RAGA LATERAL 交叉 引用 时 ， 评 估 收 益 如 下 : 对 于 提供 交叉 引用 字段 的 FRoM RA 
的 每 一 行 ， 或 提供 字段 的 多 个 FRoM 条 目的 行 集 ， 使 用 该 字段 的 行 或 行 集 值 评估 LATERAL 条 
目 。 结果 行 像 往常 一 样 和 计算 他 们 的 行 连接 。 这 是 从 字段 源 表 重复 每 行 或 行 集 。 
字段 源 表 必须 INNER 或 LEFT 连接 LATERAL RA, 其 他 为 LATERAL 条 目 计 算 每 个 行 集 的 行 集 
将 不 会 是 明确 定义 的 行 集 。 因此 ， 尽 管 一 个 构造 (如 _x RIGHT JOIN LATERAL _y_) 在 
语法 结构 上 合法 ， 并 不 实际 上 人 允许 v 引用 x. 


WHERE 子 句 
可 选 的 whERE 条 件 有 如 下 常见 的 形式 : 


WHERE _condition_ 


这 里 condition. 可 以 是 任意 生成 类 型 为 ”boolean 的 表达 式 。 任 何不 满足 这 个 条 件 的 行 都 会 
从 输出 中 删除 。 如 果 一 个 行 的 数值 代入 到 条 件 中 计算 出 来 的 结果 为 真 ， 那 么 该 行 就 算 满 足 条 
件 。 


GROUP BY 子 句 
可 选 的 croup BY 子 句 的 一 般 形式 


GROUP BY _expression_ [, ...] 


它 将 把 所 有 在 组 合 表达 式 上 拥有 相同 值 的 行 压 缩 成 一 行 。 _expression_ 可 以 是 一 个 输入 字段 
名 字 ， 或 者 是 一 个 输出 字段 ( sELEcT 列表 项 ) 的 名 字 或 序号 ， 或 者 也 可 以 是 任意 输入 字段 组 成 
的 表达 式 。 在 有 歧义 的 情况 下 ， 一 个 crou BY 的 名 字 将 被 解释 成 输入 字段 的 名 字 ， 而 不 是 输 
出 字段 的 名 字 。 

如 果 使 用 了 聚集 函数 ， 那 么 就 会 对 每 组 中 的 所 有 行进 行 计算 并 生成 一 个 单独 的 值 (而 如 果 没 
有 croup BY ， 那 么 聚集 将 对 选 出 来 的 所 有 行 计 算出 一 个 单独 的 值 )。 如 果 出 现 了 croup sy, 
那么 SELECT 列表 表达 式 中 再 引用 那些 没有 分 组 的 字段 就 是 非法 的 ， 除 非 放 在 聚集 函数 里 ， 
或 未 分 组 的 字段 琅 数 上 依赖 于 分 组 的 字段 ， 因 为 对 于 未 分 组 的 字段 ， 可 能 会 返回 多 个 数值 。 
如 果 分 组 的 字段 (或 它们 的 一 个 子 集 ) 是 包含 未 分 组 字段 的 表 的 主键 ， 那 么 存在 一 个 函数 依 
Bo 


HAVING 子 句 
可 选 的 HAvIN6 子 句 有 如 下 形式 : 


HAVING _condition_ 


3% condition. 与 为 where 子 句 里 声明 的 相同 。 


HAVING 去 除了 一 些 不 满足 条 件 的 组 行 。 它 与 whERE 不 同 : wer 在 使 用 croup BY 之 前 过 滤 
出 单独 的 行 ， 而 HAVING 过 滤 由 croup BY 创建 的 行 。 在 _condition 里 引用 的 每 个 字段 都 必 
须 无 歧义 地 引用 一 个 分 组 的 行 ， 除 非 引 用 出 现在 一 个 聚集 事 数 里 。 


HAVING 的 出 现 把 查询 变 成 一 个 分 组 的 查询 ， 即 使 没有 croup BY 子 句 也 这 样 。 这 一 点 和 那些 
包含 聚集 加 数 但 没有 croup BY 子 句 的 查询 里 发 生 的 事情 是 一 样 的 。 所 有 选取 的 行 都 被 认为 会 
形成 一 个 单一 的 组 ， 而 sELECT 列表 和 navic 子 句 只 能 从 聚集 本 数 里 面 引 用 表 的 字段 。 这 样 
的 查询 在 HAvING 条 件 为 真 的 时 候 将 发 出 一 个 行 ， 如 果 为 非 真 ， 则 返回 需 行 。 

WINDOW F% 

WINDOW 子 句 的 一 般 形式 是 


WINDOW _window_name_ AS ( _window_definition_ ) [, ...] 





这 里 的 _window_name_ 是 可 以 在 OVER 子 句 中 引用 的 名 字 或 随后 的 窗口 定义 ， 这 里 


的 _window_definition_ 是 


[ _existing_window_name_ ] 

[ PARTITION BY _expression_ [, ...] ] 

[ ORDER BY _expression_ [ ASC | DESC | USING _operator_ ] [ NULLS { FIRST | LAST } ] [L . 
[ _frame_clause_ ] 


Eee 


如 果 声 明了 _existing_window_name_ , 那么 必须 引用 一 个 在 WINDOW 列表 中 出 现 的 更 早 的 项 } 
新 的 窗口 从 这 个 项 中 拷贝 分 区 子 句 ， 和 排序 子 句 (如果 有 ) 。 在 这 种 情况 下 ， 这 个 新 的 窗口 
不 能 声明 他 自己 的 partition BY 子 句 ， 但 是 如 果 找 贝 的 窗口 没有 排序 子 句 的 话 他 可 以 声 

BA oRDER BY FA. 新 窗口 总 是 使 用 他 自己 的 框架 子 句 ; 拷贝 的 窗口 必须 不 能 声明 框架 子 句 。 








PARTITION BY 列表 的 元 素 的 以 与 GROUP BY 子 句 的 元 素 相同 的 方式 来 解释 ， 除 了 他 们 总 是 

简单 的 表达 式 并 且 从 不 是 一 个 输出 列 的 名 称 或 者 编号 。 另外 一 个 差异 是 这 些 表达 式 可 以 包含 

聚集 函数 调用 ， 而 在 常规 的 croup BY 子 句 中 这 是 不 允许 的 。 在 这 里 允许 是 因为 开 窗 在 分 组 和 
聚集 之 后 发 生 。 


同样 的 ， oRDER BY 列表 的 元 素 以 与 ORDER BY FA 的 元 素 相同 的 方式 来 解释 ， 除 了 这 个 表 
达 式 总 是 作为 简单 的 表达 式 并 且 从 不 是 一 个 输出 列 的 名 称 或 者 编号 。 


可 选 的 frame_clause A RAF ERNE OS EE (不 是 所 有 ) 定义 窗口 框架 。 窗口 框架 是 查 
询 中 的 每 行 ( 称 为 当前 T) 的 一 组 相关 行 。 frame_clause 可 以 是 下 列 之 一 








[ RANGE | ROWS ] _frame_start_ 
[ RANGE | ROWS ] BETWEEN _frame_start_ AND _frame_end 





这 里 的 frame_start 和 frame_end 可 以 是 下 列 之 一 





UNBOUNDED PRECEDING 
_value_ PRECEDING 
CURRENT ROW 
_value_ FOLLOWING 
UNBOUNDED FOLLOWING 


如 果 省 略 了 _frame_end_ , 那么 它 的 缺 省 是 CURRENT ROW o 限制 是 _frame_start_ 不 能 
是 UNBOUNDED FOLLOWING ， _frame_end_ 不 能 是 UNBOUNDED PRECEDING , _frame_end_ 选项 在 
上 面 的 列表 中 不 能 比 _frame_start。 选项 出 现 的 早 ， 例 如 RANGE BETWEEN CURRENT ROW AND 


_value ”PRECEDING 是 不 允许 的 。 


缺 省 框架 选项 是 RANGE UNBOUNDED PRECEDING ， 这 

与 RANGE BETWEEN UNBOUNDED PRECEDING AND CURRENT Row 相同 ; 它 将 框架 设置 为 分 区 中 的 所 有 
行 ， 在 oRDER BY 序列 中 是 从 当前 行 的 最 后 一 个 元 素 开 始 〈 这 意味 着 若 无 oRDER BY 则 是 所 有 
47) 。 通常 ， UNBOUNDED PRECEDING 表示 框架 从 分 区 的 第 一 行 开始 ， 类 似 的 

UNBOUNDED FOLLOWING 表示 框架 以 分 区 的 最 后 一 行 结束 (不管 是 RANGE 还 是 Rows 模式 ) o 
在 rows 模式 ， CURRENT Row 意味 着 框架 以 当前 行 开始 或 结束 ; 但 是 在 Rance 模式 ， 意 味 着 
框架 以 当前 行 在 oRDER BY 序列 中 的 第 一 个 或 最 后 一 个 元 素 开始 或 结束 。 _value_ 

PRECEDING 和 _value_ FOLLOWING 子 句 目前 只 人 允许 在 Rows 模式 。 他 们 表明 框架 以 当前 行 之 
前 或 者 之 后 许多 行 开始 或 者 结束 。 value 必须 是 一 个 不 包含 任何 变量 、 聚 集 函 数 或 者 窗口 
函数 的 整 型 表达 式 。 该 值 不 能 为 空 或 者 负 值 ; 但 可 以 为 0， 并 且 这 时 选择 当前 行 本 身 。 


注意 如 果 orveR BY 排序 不 能 唯一 地 排列 行 ， 那 么 Rows 选项 可 能 产生 不 可 预测 的 结 
Ro RANGE 选项 是 为 了 确保 oRDER BY 序列 中 的 对 等 的 行 能 得 到 同等 对 待 ; 任何 两 个 对 等 行将 
会 都 在 或 者 都 不 在 框架 中 。 


一 个 wINDow 语句 的 目的 是 指定 出 现在 查询 的 SELECT 列表 或 者 ORDER BY 子 句 中 的 window 
WANT, HAA LIER over 子 句 中 通过 名 称 引用 wINpow 子 句 条 目 。 一 

个 WINDow 子 名 条目 不 需要 在 任何 地 方 都 引用 ; 若 它 不 在 查询 中 使 用 ， 它 将 被 忽略 。 可 以 使 用 
窗口 程序 而 根本 不 需要 任何 wio 子 句 ， 因为 一 个 窗口 画 数 调用 可 以 直接 在 其 over FOR 
指定 其 窗口 定义 。 然 而 ， wiw 子 句 会 在 多 个 窗口 画 数 需要 相同 窗口 定义 时 保存 输入 。 


窗口 函数 在 Section 3.5, Section 4.2.8, 和 Section 7.2.4 中 有 详细 描述 。 


SELECT 列表 


SELECT 列表 (在 SELECT 和 FRoM 关键 字 之 间 的 部 分 ) 声明 组 成 SELECT 语句 的 输出 行 的 表达 
式 。 这 些 表达 式 可 以 (并 且 通 常 也 会 ) 引 用 在 FRoM 子 句 里 面 计算 出 来 的 字段 。 


就 像 在 一 个 表 中 ， 一 个 sect 的 每 个 输出 列 都 有 一 个 名 称 。 在 一 个 简单 的 SELECT 中 ， 该 名 
称 仅 用 于 标记 显示 的 列 ， 但 当 sELEcT 是 一 个 较 大 查询 的 子 查询 时 ， 名 称 被 较 大 查询 视 为 子 查 
询 产生 的 虚 表 的 字段 名 。 为 了 指定 用 于 输出 列 的 名 称 ， 要 在 列表 达 式 后 写 As 

_output_name_ o (您 可 以 省 略 AS ， 但 只 有 当 所 需 的 输出 名 称 不 匹配 任何 PostgreSQL 关 键 

Fat (请 参阅 Appendix C)。 为 了 防止 将 来 可 能 的 关键 字 添 加 ， 建议 您 要 么 写 As 要 么 用 双 引 

号 引起 输出 名 称 。) 如 果 你 不 指定 一 个 字段 名 ， PostgreSQL 会 自动 选择 一 个 名 称 。 如 果 字 段 
的 表达 式 是 一 个 简单 的 列 引 用 ， 那么 选择 的 名 称 与 字段 名 相同 ; 在 更 复杂 的 情况 下 ， 可 能 会 
使 用 一 个 函数 或 类 型 名 ， 或 系统 会 依赖 于 一 个 类 似 ?column? 的 生成 名 。 


一 个 输出 列 的 名 称 可 以 用 来 参考 oRDER BY 和 croup BY 子 句 中 的 字段 的 值 ， 而 不 是 
在 wer 或 者 HAvIN6 子 句 中 的 ; 反而 您 必须 在 那里 写 出 表达 式 。 


除了 表达 式 ， 也 可 以 在 俞 出 列表 中 使 用 表示 所 有 字段 。 还 可 以 用 _table_name_ .* 作为 来 自 
该 表 的 所 有 字段 的 缩写 。 这 些 情 况 下 用 As 指定 新 名 称 是 不 可 能 的 ; 输出 列 的 名 称 将 会 与 表 
列 的 名 称 相同 。 


DISTINCT F% 


如 果 声 明了 sELECT pistinct ， 那 么 就 从 结果 集中 删除 所 有 重复 的 行 (每 个 有 重复 的 组 都 保留 
一 行 )。 SELECT ALL 声明 相反 的 作用 : 所 有 行 都 被 保留 (这 是 缺 省 )。 


SELECT DISTINCT ON ( _expression_ [,...]) 只 保留 那些 在 给 出 的 表达 式 上 运算 出 相同 结果 的 
行 集合 中 的 第 一 行 。 DIsTINCT on 表达 式 是 使 用 与 oRDER BY 相同 的 规则 进行 解释 的 〈 见 上 
X) 。 请 注意 ， 除非 使 用 了 oRDER BY 来 保证 需要 的 行 首 先 出 现 ， 否 则 ，" 第 一 行 " 是 不 可 预测 
的 。 比 如 : 


SELECT DISTINCT ON (location) location, time, report 
FROM weather_reports 
ORDER BY location, time DESC; 


为 每 个 地 点 检索 最 近 的 天 气 报告 。 但 是 如 果 没 有 使 用 oRDER BY 来 强制 对 每 个 地 点 的 时 间 值 进 
行 降 序 排序 ， 那 么 就 会 得 到 每 个 地 点 的 不 知道 什么 时 候 的 报告 。 

DISTINCT ON 表达 式 必须 匹配 最 左边 的 ORDER BY 表达 式 。 ORDER BY 子 句 将 通常 包含 额外 的 
表达 式 来 判断 每 个 pIsTINCT on 组 里 面 需要 的 行 的 优先 级 。 


UNION +) 
UNION 子 句 的 一 般 形 式 是 : 


_select_statement_ UNION [ ALL | DISTINCT ] _select_statement_ 


这 里 的 _select_statement_ 是 任意 没有 ORDER BY , LIMIT , FOR NO KEY UPDATE , FOR UPDATE , 
FOR SHARE , 或 FOR KEY SHARE 子 句 的 SELECT 语句 。 如 果 用 圆 括 弧 包 

E, ORDER BY 和 LIMIT 可 以 附着 在 子 表 达 式 里 。 如 果 没 有 圆 括 缴 ， 这 些 子 句 将 交 

给 UNION 的 结果 使 用 ， 而 不 是 给 它们 右边 的 输入 表达 式 。 


UNION 操作 符 计 算 那 些 涉及 到 的 所 有 sELEcT 语句 返回 的 行 的 结果 联合 。 一 个 行 如 果 至 少 在 
两 个 结果 集中 的 一 个 里 面 出 现 ， 那么 它 就 会 在 这 两 个 结果 集 的 集合 联合 中 。 两 个 作为 UNION 
直接 操 作 数 的 sELEcT 必须 生成 相同 数目 的 字段 ， 并 且 对 应 的 字段 必须 有 兼容 的 数据 类 型 。 


缺 省 的 uoi 结果 不 包含 任何 重复 的 行 ， 除 非 声明 了 ALL 选项 。 ALL 制止 了 消除 重复 的 动 
作 。 因 此 ， uNIoN ALL 通常 比 unton 明显 要 快 ， 可 能 的 情况 下 尽量 使 用 ALL 。 DISTINCT 可 
以 明确 的 指定 消除 重复 行 的 缺 省 行为 。 


同一 个 SELECT 语句 中 的 多 个 uwo 操作 符 是 从 左 向 右 计 算 的 ， 除非 用 圆 括 弧 进行 了 标识 。 
目前 ， FOR NO KEY UPDATE , FOR UPDATE , FOR SHARE 和 FOR KEY SHARE 不 能 在 uNIoN 的 结 


或 输入 中 声明 。 


INTERSECT 子 句 
INTERSECT 子 句 的 一 般 形 式 是 : 


_select_statement_ INTERSECT [ ALL | DISTINCT ] _select_statement_ 
_select_statement_ 是 任何 不 带 ORDER BY , LIMIT , FOR NO KEY UPDATE , FOR UPDATE , 
FOR SHARE , 或 FOR KEY SHARE 子 句 的 SELECT 语句 。 


INTERSECT 计算 涉及 的 secect 语句 返回 的 行 集合 的 交集 。 如 果 一 个 行 在 两 个 结果 集中 都 出 
现 ， 那 么 它 就 在 两 个 结果 集 的 交集 中 。 


INTERSECT 的 结果 不 包含 任何 重复 行 ， 除 非 你 声明 了 aL 选项 。 用 了 ALL 以后， 一 个 在 左边 
的 表 里 有 m 个 重复 而 在 右边 表 里 有 n 个 重复 的 行将 在 结果 集中 出 现 min( m, n ) 次 。 
DISTINCT 可 以 明确 的 指定 消除 重复 行 的 缺 省 行为 。 


除非 用 圆 括号 指明 顺序 ， 同 一 个 sELECT 语句 中 的 多 个 INTERSECT 操作 符 是 从 左 向 右 计 算 


的 。 INTERSECT 比 uNION 绑 定 得 更 紧 ， 也 就 是 说 A UNION B INTERSECT C 将 理解 成 
A UNION (B INTERSECT C) 。 


目前 ， 不 能 给 intersect 的 结果 或 者 任何 intersect 的 输入 声明 FOR NO KEY UPDATE , 


FOR UPDATE ， FOR SHARE 和 FOR KEY SHARE o 


EXCEPT 子 句 
EXCEPT 子 句 有 如 下 的 通用 形式 : 


_select_statement_ EXCEPT [ ALL | DISTINCT ] _select_statement_ 


_select_statement_ 是 任何 没有 ORDER BY , LIMIT , FOR NO KEY UPDATE , FOR UPDATE , 
FOR SHARE , 或 FOR KEY SHARE 子 句 的 sELECT 表达 式 。 


EXCEPT 操作 符 计 算 存 在 于 左边 SELECT 语句 的 输出 而 不 存在 于 右边 sect 语句 输出 的 行 。 


except 的 结果 不 包含 任何 重复 的 行 ， 除 非 声 明了 aL 选项 。 使 用 aL 时 ， 一 个 在 左边 表 中 
有 m 个 重复 而 在 右边 表 中 有 n 个 重复 的 行将 在 结果 中 出 现 max( m - _n ,0) 次 。 
DISTINCT 可 以 明确 的 指定 消除 重复 行 的 缺 省 行为 。 


除非 用 圆 括 弧 指 明 顺 序 ， 否 则 同一 个 sELEcT 语句 中 的 多 个 ExcEPT 操作 符 是 从 左 向 右 计 算 
AY. EXCEPT 和 uNION 的 绑 定 级 别 相同 。 


目前 ， 不 能 给 except 的 结果 或 者 任何 except 的 输入 声明 FOR NO KEY UPDATE , FOR UPDATE , 
FOR SHARE 和 FOR KEY SHARE 子 句 。 


ORDER BY 子 句 
可 选 的 ORDER BY 子 句 有 下 面 的 一 般 形式 : 


ORDER BY _expression_ [ ASC | DESC | USING _operator_ ] [ NULLS { FIRST | LAST } ] [, 
| 


ORDER BY 子 句 导 致 结果 行 根 据 指 定 的 表达 式 进 行 排序 。 如 果 根 据 最 左边 的 表达 式 ， 两 行 的 结 
果 相 同 ， 那 么 就 根据 下 一 个 表达 式 进行 比较 ， 依 此 类 推 。 如 果 对 于 所 有 声明 的 表达 式 他 们 都 
相同 ， 那 么 按 随机 顺序 返回 。 


每 个 _expression_ 可 以 是 一 个 输出 字段 ( SELECT 列表 项 ) 的 名 字 或 者 序号 ， 或 者 也 可 以 是 用 输 
入 字段 的 数值 组 成 的 任意 表达 式 。 


序数 指 的 是 输出 字段 按 顺 序 (从 左 到 右 ) 的 位 置 。 这 个 特性 可 以 对 没有 唯一 名 称 的 字段 进行 排 
序 。 这 不 是 必须 的 ， 因 为 总 是 可 以 通过 as are 一 个 要 输出 的 字段 赋予 一 个 名 称 。 


在 oRDER BY 里 还 可 以 使 用 任意 表达 式 ， 包 括 那 些 没有 出 现在 _SELEcT 输出 列表 里 面 的 字段 。 
因此 下 面 的 语句 现在 是 合法 的 : 


SELECT name FROM distributors ORDER BY code; 


这 个 特性 的 一 个 局 限 就 是 应 用 于 UNION , INTERSECT , EXCEPT 子 句 的 结果 的 oRDER BY FAA 
能 在 一 个 输出 字段 名 或 者 数字 上 声明 ， 而 不 能 在 一 个 表达 式 上 声明 。 


如 果 一 个 oRDER BY 表达 式 是 一 个 简单 名 称 ， 同 时 匹配 结果 字段 和 输入 字段 ， oRDER BY 将 把 
它 解释 成 结果 字段 名 称 。 这 和 croup BY 在 同样 情况 下 做 的 选择 正 相 反 。 这 样 的 不 一 致 是 用 来 
和 SQL 标准 兼容 的 。 


可 以 给 oRDER BY 子 句 里 每 个 字段 加 一 个 可 选 的 asc (HE, HA) nese (降序 ) 关 键 字 。 还 
可 以 在 usine 子 句 里 声明 一 个 排序 操作 符 来 实现 排序 。 排 序 操作 符 必须 小 于 或 大 于 某 些 B- 
tree 操 作 符 族 的 成 员 。 asc 等 效 于 使 用 usING alt; 而 ose 等 效 于 使 用 usine &gt; o 但 是 
一 个 用 户 定义 类 型 的 创建 者 可 以 明确 定义 缺 省 的 排序 顺序 ， 并 且 可 以 使 用 其 他 名 称 的 操作 
符 。 


如 果 指 定 NuLLs vast ， 空 值 会 在 所 有 非 空 值 之 后 排序 ; 如 果 指 定 NULLS FIRST, ZARE 
有 非 空 值 之 前 排序 。 如 果 两 者 均 未 指定 ， 当 指定 asc MRA, FRIAR MN NULLS LAST ， 
并 且 当 指定 pesc 时 ， 默 认 反 应 时 是 NULLS FIRST (因此 ， 默认 地 认为 空 是 大 于 非 空 的 ) 。 当 
指定 usine 时 ， 默认 空 排序 依赖 于 操作 符 是 小 于 还 是 大 于 操作 符 。 


请 注意 排序 选项 仅 适用 于 他 们 遵循 的 表达 式 ; 例如 oRDER BY x, y Desc 不 意味 着 
与 ORDER BY x DESC, y DESC 相同 。 


字符 类 型 的 数据 是 按照 占用 于 被 排序 的 字段 的 排序 规则 排序 的 。 可 以 在 需要 时 通过 在 
_expression_ 中 包含 COLLATE FBR, 例如 ORDER BY mycolumn COLLATE "en_US" o 更 多 信 
息 请 参阅 Section 4.2.10 和 Section 22.2, 


LIMIT +) 
LIMIT 子 句 由 两 个 独立 的 子 句 组 成 : 


LIMIT { _count_ | ALL } 
OFFSET _start_ 


_count_ 声明 返回 的 最 大 行 数 ， 而 start. 声明 开始 返回 行 之 前 忽略 的 行 数 。 如 果 两 个 都 指 
定 了 ， 那 么 在 开始 计算 _count ”个 返回 行 之 前 将 先 跳 过 _start_ 行 。 


如 果 _count_ 表达 式 评估 为 NULL， 它 被 当做 vomit ALL ， 也 就 是 ， 没 有 限制 。 如 果 
_start_ 评估 为 NULL， 他 与 oFFSET o 相同 对 待 。 


SQL:2008 引 入 了 一 个 不 同 的 语法 来 达到 相同 的 效果 ， 这 也 是 PostgreSQL 支 持 的 。 这 是 : 


OFFSET _start_ { ROW | ROWS } 
FETCH { FIRST | NEXT } [ _count_ ] { ROW | ROWS } ONLY 


在 该 语法 中 ， 为 _start_ 或 count ”提供 除 简单 整 型 常量 之 外 的 东西 时 ， 你 必须 写 圆 括号 。 
如 果 count. Æ Ferch 子 句 中 省 略 了 ， 它 默认 为 1。 Row 和 rows 以 及 FIRST 和 next 是 不 
影响 这 些 子 句 的 效果 的 干扰 词 。 根据 该 标准 ， 若 两 个 都 存在 则 oFFSET 子 句 必须 在 FETCH F 
句 之 前 出 现 ; 但 是 PostgreSQL 的 要 求 更 为 宽松 并 且 人 允许 任意 一 种 顺序 。 





使 用 LIMIT 的 一 个 好 习惯 是 使 用 一 个 oRDER BY 子 句 把 结果 行 限 制 成 一 个 唯一 的 顺序 。 否则 你 
会 得 到 无 法 预料 的 结果 子 集 ， 你 可 能 想 要 第 十 行 到 第 二 十 行 ， 但 是 是 以 什么 顺序 的 第 十 行 到 
第 二 十 行 ? 除非 你 声明 oRpER BY ， 否 则 你 不 知道 什么 顺序 。 


查询 优化 器 在 生成 查询 规划 时 会 把 LIMIT 考虑 进去 ， 所 以 你 很 有 可 能 因 给 出 的 

LIMIT 和 oFFSET 值 不 同 而 得 到 不 同 的 规划 (生成 不 同 的 行 序 )。 因此 用 不 同 

BY LIMIT / OFFSET 值 选择 不 同 的 查询 结果 的 子 集 将 不 会 产生 一 致 的 结果 ， 除 非 你 用 oRDER BY 
强制 生成 一 个 可 预计 的 结果 顺序 。 这 可 不 是 bug ; 这 是 SQL 生来 的 特点 ， 因为 除非 用 

了 ORDER BY 约束 顺序 ，SQL 不 保证 查询 生成 的 结果 有 任何 特定 的 顺序 。 


如 果 没 有 一 个 oRDER BY 来 强制 选择 一 个 确定 性 子 集 ， 那 么 重复 执行 相同 的 LIMIT 查询 返回 不 
同 的 表 行 的 子 集 甚 至 都 是 可 能 的 。 同 样 ， 这 不 是 一 个 漏洞 ; 结果 的 确定 在 这 种 情况 下 没 法 保 
证 。 

锁定 子 名 

FOR UPDATE ， FOR NO KEY UPDATE , FOR SHARE 和 FOR KEY SHARE 是 锁定 子 句 ;他 们 影响 
SELECT 如 何 从 表 中 锁定 行 作为 获得 的 行 。 

锁定 子 句 的 一 般 形 式 : 


FOR _lock_strength_ [ OF _table_name_ [, ...] ] [ NOWAIT ] 





这 里 的 _lock_strength_ 可 以 是 下 列 之 一 ; 


UPDATE 

NO KEY UPDATE 
SHARE 

KEY SHARE 


FOR UPDATE 全 那些 被 SELECT 检索 出 来 的 行 被 锁 住 ， 就 像 要 更 新 一 样 。 这 样 就 避免 它们 在 当 
前 事务 结束 前 被 其 它 事务 修改 或 者 删除 ; 也 就 是 说 ， 其 它 企图 UPDATE ，DELETE ， 

SELECT FOR UPDATE , SELECT FOR NO KEY UPDATE , SELECT FOR SHARE 或 

SELECT FOR KEY SHARE 这 些 行 的 事务 将 被 阻塞 ， 直 到 当前 事务 结束 。 FoR UPDATE 锁 模式 也 可 
以 通过 在 一 个 行 上 pELETE 或 在 特定 的 字段 上 修改 值 的 uppATE 获得 。 目 前 ， 为 uPDATE 情况 
考虑 的 字段 设置 是 那些 有 唯一 索引 并 且 可 以 用 于 外 键 的 〈 所 以 不 考虑 局 部 索引 和 表达 式 索 
引 ) ， 但 是 这 个 可 能 会 在 将 来 改变 。 同 样 ， 如 果 一 个 来 自 其 它 事 务 的 UPDATE ，DELETE , 
SELECT FOR UPDATE 已 经 锁 住 了 某 个 或 某 些 选 定 的 行 ， SELECT FOR UPDATE 将 等 到 那些 事务 结 
束 ， 并 且 将 随后 锁 住 并 返回 更 新 的 行 (或 者 不 返回 行 ， 如 果 行 已 经 被 删除 )。 但 是 ， 

在 REPEATABLE READ 或 SERIALIZABLE 事务 内 部 ， 如 果 在 事务 开始 时 要 被 锁定 的 行 已 经 改变 
了 ， 那 么 将 抛 出 一 个 错误 。 更 多 的 讨论 参阅 Chapter 13。 


FOR NO KEY UPDATE 的 行为 类 似 ， 只 是 获得 的 锁 比 较 弱 : 这 个 锁 将 不 锁定 尝试 在 相同 的 行 上 获 
得 锁 的 SELECT FOR KEY SHARE 命令 。 这 个 锁 模 式 也 可 以 通过 任何 不 争取 For UPDATE 锁 
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的 uPDATE 获得 。 


FOR SHARE 的 行为 类 似 ， 只 是 它 在 每 个 检索 出 来 的 行 上 要 求 一 个 共享 锁 ， 而 不 是 一 个 排 它 
锁 。 一 个 共享 锁 阻 塞 其 它 事务 在 这 些 行 上 执行 UPDATE , DELETE , SELECT FOR UPDATE 或 
SELECT FOR NO KEY UPDATE ， 却 不 阻止 他 们 执行 SELECT FOR SHARE 或 


SELECT FOR KEY SHARE o 


FOR KEY SHARE 的 行为 类 似 于 For share ， 只 是 锁 比 较 弱 : BASE sELEcT FoR UPDATE 但 不 阻 
塞 SELECT FOR NO KEY UPDATE. 一 个 共享 键 块 阻塞 其 他 事务 执行 DELETE 或 任意 改变 键 值 
的 uppate ， 但 是 不 阻塞 其 他 uppate ， 也 不 阻止 SELECT FOR NO KEY UPDATE , 


SELECT FOR SHARE ,或 SELECT FOR KEY SHARE o 


为 了 避免 操作 等 待 其 它 事务 提交 ， 使 用 NowAIT 选项 。 如 果 被 选择 的 行 不 能 立即 被 锁 住 ， 那么 
语句 将 会 立即 汇报 一 个 错误 ， 而 不 是 等 待 。 请 注意 ， NowAIT 只 适用 于 行 级 别 的 锁 ， 要 求 的 表 
级 锁 Row SHARE 仍然 以 通常 的 方法 进行 (参阅 Chapter 13)。 如 果 需 要 申请 表 级 别 的 锁 同 时 又 不 
等 待 ， 那 么 你 可 以 使 用 LOCK 的 NowAIT 选项 。 


如 果 在 锁定 子 句 中 明确 指定 了 表 名 字 ， 那 么 将 只 有 这 些 指定 的 表 被 锁定 ， 其 他 在 sect 中 使 
用 的 表 将 不 会 被 锁定 。 一 个 其 后 不 带 表 列表 的 锁定 子 句 将 锁定 该 声明 中 所 有 使 用 的 表 。 WR 
锁定 子 句 应 用 于 一 个 视图 或 者 子 查 询 ， 它 同样 将 锁定 所 有 该 视图 或 子 查 询 中 使 用 到 的 表 。 但 
是 这 些 子 句 不 适用 于 被 主 查 询 引用 的 with 查询 。 如 果 你 想 要 行 锁定 发 生 在 with 查询 中 ， 那 
么 在 with 查询 中 指定 锁定 子 句 。 


多 个 锁定 子 句 可 以 用 于 为 不 同 的 表 指 定 不 同 的 锁定 模式 。 如 果 一 个 表 出 同时 出 现 (或 隐 含 同时 
出 现 ) 在 多 个 锁定 子 句 中 ， 那 么 将 看 做 只 被 最 强 的 那个 声明 了 处 理 。 类 似 的 ， 如 果 影 响 一 个 表 
的 任意 子 句 中 出 现 了 nowa, 那么 该 表 将 按照 NOwAIT 处 理 。 


锁定 子 句 不 能 在 那些 无 法 使 用 独立 的 表 行 清晰 标识 返回 行 的 环境 里 使 用 ; 比如 ， 它 不 能 和 聚 
集 一 起 使 用 。 


当 锁 定子 句 出 现在 SELECT 查询 的 顶层 时 ， 锁 定 的 行 恰好 是 被 查询 返回 的 行 ; 在 连接 查询 的 情 
况 下 ， 锁 定 的 行 是 那些 有 助 于 返回 连接 的 行 。 另外， 满足 查询 条 件 的 行 作 为 查询 快照 笃 被 锁 
定 ， 尽 管 如 果 在 快照 后 他 们 被 更 新 不 再 满足 查询 条 件 就 不 再 被 返回 。 如 果 使 用 了 mT, A 
么 一 旦 返回 足够 的 行 满 足 限制 锁定 将 停止 “(但 是 请 注意 ， 通 过 oFFsET 跳 过 的 行将 被 锁定 ) 。 
相似 的 ， 如 果 锁 定子 句 用 于 游标 查询 ， 只 有 实际 抓 取 到 的 行 或 通过 游标 跳 过 的 行将 被 锁定 。 


当 锁 定子 句 出 现在 子 sELECT 中 时 ， 锁 定 的 行 是 那些 通过 子 查询 返回 到 外 查询 的 行 。 这 些 包含 
的 行 可 能 比 单独 检查 子 查询 时 给 出 的 行 更 少 ， 因 为 外 查询 的 条 件 可 能 会 用 来 优化 子 查 询 的 执 
行 。 例如 : 


SELECT * FROM (SELECT * FROM mytable FOR UPDATE) ss WHERE coli = 5; 


将 只 锁定 coli = 5 的 行 ， 即 使 那个 条 件 不 是 子 查询 中 的 原文 。 
以 前 的 版 本 未 能 保持 锁 ， 通 过 一 个 稍 后 的 保存 点 来 改善 。 例 如 ， 这 段 代 码 : 


BEGIN; 
SELECT * FROM mytable WHERE key = 1 FOR UPDATE; 
SAVEPOINT s; 

UPDATE mytable SET ... WHERE key = 1; 

ROLLBACK TO s; 


FOR UPDATE 锁 将 会 在 ROLLBACK To 之 后 无 法 保持 。 这 在 版 本 9.3 中 已 经 修复 了 。 


Caution 


一 个 sELECT 命令 运行 在 READ coMMITTED 事务 隔离 级 别 和 使 用 oRDER BY 和 一 个 锁定 子 句 
返回 顺序 混乱 的 行 是 可 能 的 。 这 是 因为 oRDER BY 先生 效 。 命 邻 排序 结果 ， 但 是 可 能 会 在 
其 中 一 行 或 多 行 上 获取 锁 的 时 候 被 阻塞 。 一 旦 sELEcT 的 阻塞 被 解除 后 ， 某 些 顺 序 字 段 值 
可 能 被 修改 ， 导 致 这 些 行 混 乱 了 (尽管 他 们 还 是 原先 字段 值 的 顺序 ) 。 可 以 在 需要 的 时 
候 通过 在 子 查询 中 放置 For UPDATE/SHARE 子 句 来 避 开 ， 例 如 


SELECT * FROM (SELECT * FROM mytable FOR UPDATE) ss ORDER BY column1; 


请 注意 这 将 导致 锁定 mytable 的 所 有 行 ， 而 顶层 的 FoR UPDATE 将 会 实际 上 仅 锁 住 返 回 行 。 这 
可 能 会 产生 一 个 显著 的 性 能 差异 ， 尤 其 是 如 果 oRDER BY 与 LIMIT 或 者 其 他 限制 结合 。 仅 当 顺 
序列 的 并 发 更 新 是 预期 的 并 且 需 要 一 个 严格 的 排序 结果 时 ， 该 技术 才 是 建议 使 用 的 。 


在 REPEATABLE READ 或 SERIALIZABLE 事务 隔离 级 别 ， 这 可 能 会 导致 一 个 序列 化 失败 
( SQLSTATE 为 '40001' ) ， 所 以 在 这 些 隔离 级 别 下 接收 次 序 混乱 的 行 是 不 可 能 的 。 | 


TABLE MS 
BA. 
TW 


Ap 


TABLE _name_ 


完全 等 价 于 : 


SELECT * FROM _name 


它 可 以 用 作 复 末 查 询 中 的 一 部 分 的 一 个 顶级 的 命令 或 者 一 个 节省 空间 的 语法 变 体 。 


例子 
FR films 和 表 distributors 连接 在 一 起 H 


SELECT f.title, f.did, d.name, f.date_prod, f.kind 
FROM distributors d, films f 
WHERE f.did = d.did 


title | did | name | date_prod | kind 
0 当下 用 下 有 生生 用 有 
The Third Man | 101 | British Lion | 1949-12-23 | Drama 
The African Queen | 101 | British Lion | 1951-08-11 | Romantic 


统计 用 kind 分 组 的 每 组 电影 的 长 度 len 总 和 : 


SELECT kind, sum(len) AS total FROM films GROUP BY kind; 


kind | total 
Ey yet ey eS et 
Action | 07:34 
Comedy | 02:58 
Drama | 14:28 
Musical | 06:42 
Romantic | 04:38 


统计 用 kind 分 组 的 每 组 电影 的 长 度 len 总 和 不 足 五 小 时 的 组 : 


SELECT kind, sum(len) AS total 
FROM films 
GROUP BY kind 
HAVING sum(len) < interval '5 hours'; 


Comedy 


| 02:58 


Romantic | 04:38 


下 面 两 个 例子 是 根据 第 二 列 ( name ) 的 内 容 对 单独 的 结果 排序 的 相同 的 方法 : 


SELECT * FROM distributors ORDER BY name; 
SELECT * FROM distributors ORDER BY 2; 


下 面 这 个 例子 演示 如 何 获得 表 distributors 和 actors 的 连接 ， 
的 取出 来 。 因 为 只 取 了 不 重复 的 行 ， 所 以 关键 字 ALL RAKT : 


| 
十 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 


20th Century Fox 
Bavaria Atelier 
British Lion 
Columbia 

Jean Luc Godard 
Luso films 
Mosfilm 
Paramount 

Toho 

United Artists 
Walt Disney 
Warner Bros. 
Westward 


只 将 每 个 表 中 以 字母 W 开头 


distributors: actors: 


did | name id | name 

See 二 SC en see ep a ere ye et 
108 | Westward 1 | Woody Allen 
111 | Walt Disney 2 | Warren Beatty 


112 | Warner Bros. 3 | Walter Matthau 


SELECT distributors.name 

FROM distributors 

WHERE distributors.name LIKE 'W%' 
UNION 
SELECT actors.name 

FROM actors 

WHERE actors.name LIKE 'W%'; 


Walt Disney 
Walter Matthau 
Warner Bros. 
Warren Beatty 
Westward 
Woody Allen 


这 个 例子 显示 了 如 何在 From 子 句 中 使 用 函数 ， 包 括 带 有 和 不 带 字段 定义 列表 的 。 


CREATE FUNCTION distributors(int) RETURNS SETOF distributors AS $$ 
SELECT * FROM distributors WHERE did = $1; 
$$ LANGUAGE SQL; 


SELECT * FROM distributors(111); 
did | name 


111 | Walt Disney 


CREATE FUNCTION distributors_2(int) RETURNS SETOF record AS $$ 
SELECT * FROM distributors WHERE did = $1; 
$$ LANGUAGE SQL; 


SELECT * FROM distributors_2(111) AS (f1 int, f2 text); 
fis f2 


111 | Walt Disney 


这 个 例子 显示 了 如 何 使 用 一 个 简单 的 wrTH 子 句 : 


WITH t AS ( 
SELECT random() as x FROM generate_series(1, 3) 


) 
SELECT * FROM t 
UNION ALL 
SELECT * FROM t 


0.534150459803641 
0.520092216785997 
0.0735620250925422 
0.534150459803641 
0.520092216785997 
0.0735620250925422 


请 注意 with 查询 只 评估 一 次 ， 所 以 我 们 获得 两 组 相同 的 三 个 随机 值 。 


这 个 例子 使 用 with recursive 从 一 个 只 显示 直接 属 下 的 表 中 找到 所 有 职员 Mary 的 属 下 (E 
或 间接 ) ， 和 他 们 的 间接 级 别 ， 


WITH RECURSIVE employee_recursive(distance, employee_name, manager_name) AS ( 
SELECT 1, employee_name, manager_name 
FROM employee 
WHERE manager_name = 'Mary' 
UNION ALL 
SELECT er.distance + 1, e.employee_name, e.manager_name 
FROM employee_recursive er, employee e 
WHERE er.employee_name = e.manager_name 


SELECT distance, employee_name FROM employee_recursive; 


请 注意 递归 查询 的 典型 形式 : 一 个 初始 条 件 ， 紧 接着 是 uNIoN ， AREA aR. A 
pn 回 元 组 ， 否 则 查询 将 无 限 循环 下 去 。 〈 请 人 参阅 Section 7.8 获 
取 更 多 示例 。) 


这 个 例子 使 用 LATERAL 为 manufacturers 表 的 每 行 应 用 一 个 设置 返回 函数 


get_product_names() 


SELECT m.name AS mname, pname 
FROM manufacturers m, LATERAL get_product_names(m.id) pname; 


当前 没有 任何 产品 的 制造 商 将 不 会 出 现在 结果 中 ， 因 为 这 是 一 个 内 连接 。 如 果 我 们 希望 在 结 
果 中 包括 这 种 制造 商 的 名 字 ， 我 们 可 以 这 样 做 : 


SELECT m.name AS mname, pname 
FROM manufacturers m LEFT JOIN LATERAL get_product_names(m.id) pname ON true; 


RANE 


SELECT 语句 和 SQL 标准 兼容 。 但 是 还 有 一 些 扩展 和 一 些 缺 少 的 特性 。 


省 略 from 子 名 


PostgreSQL 人 允许 在 一 个 查询 里 省 略 FRoM FA. 它 的 最 直接 用 途 就 是 计算 简单 的 常量 表达 式 
的 结果 : 


SELECT 2+2; 


?column? 


它 有 些 SQL 数据 库 不 能 这 人 么 做 ， 除 非 引入 一 个 单行 的 伪 表 做 为 secect 的 数据 源 。 


请 注意 ， 如 果 没 有 声明 Fon 子 句 ， 那 么 查询 不 能 引用 任何 数据 库 表 。 比如 ， 下 面 的 查询 是 
非法 的 : 


SELECT distributors.* WHERE distributors.name = 'Westward'; 


PostgreSQL 8.1 之 前 的 版 本 支持 这 种 形式 的 查询 ， 为 查询 里 引用 的 每 个 表 都 增加 一 个 隐 合 的 
条 目 到 FRoM 子 句 中 。 现在 这 个 不 再 是 允许 的 了 。 


省 略 As 关键 字 


tachi 每 当 新 列 名 称 是 一 个 有 效 的 列 名 时 〈 也 就 是 ， 与 任意 保留 关键 字 都 不 同 ) ， 

选 的 关键 字 As 可 以 在 输出 列 名 之 前 省 略 。PostgreSQL 限制 略 多 一 些 : 不 管 是 保留 还 是 不 
留 ， 如 果 新 列 名 匹配 任何 关键 字 ， As 是 必要 的 。 建议 的 做 法 是 使 用 As 或 者 双 括 号 括 起 输 
出 列 名 称 ， 以 阻止 与 将 来 补充 的 关键 字 有 任何 可 能 的 冲突 。 


在 From 项 中 ， 标 准 和 PostgreSQL 都 允许 as 在 一 个 无 限制 关键 字 别 名 之 前 省 略 。 但 是 这 对 
输出 列 名 是 不 切实 际 的 ， 因 为 语法 的 歧义 。 


ONLY 和 继承 
SQL 标准 需要 在 写 oNLY 时 括号 括 起 表 名 ， 例 如 


SELECT * FROM ONLY (tab1), ONLY (tab2) WHERE ... o PostgreSQL 认 为 括号 是 可 选 的 。 
PostgreSQL 人 允许 写 一 个 尾随 的 * 以 明确 指定 包括 子 表 的 非 ony 行为 。 标 准 不 允许 这 样 。 


(该 点 同样 适用 于 所 有 支持 oNLY 选项 的 SQL 命令 。 ) 


FROM 中 的 函数 调用 


PostgreSQL 人 允许 把 函数 调用 直接 写作 From 列表 的 一 个 成 员 。 在 SQL 标准 中 应 该 有 必要 在 
F SELECT 中 包含 这 样 一 个 函数 ; 也 就 是 ， 该 语法 FROM _func_(...) _alias_ 等 价 于 

FROM LATERAL (SELECT _func (...)) _alias 。 请 注意 LATERAL 被 认为 是 隐 含 的 ; 这 是 因为 
标准 要 求 LATERAL 语义 为 一 个 在 FRoM 中 的 unnest() 条 目 。PostgreSQL 对 待 unnest() 和 其 
他 设置 返回 范 数 相同 。 





GROUP BY 和 ORDER BY 里 可 用 的 命名 空间 


在 SQL-92 标准 里 ， oRDER BY 子 句 只 能 使 用 输出 字段 名 或 者 编号 ， 而 croup BY 子 句 只 能 用 
基于 输入 字段 名 的 表达 式 。PostgreSQL 对 这 两 个 子 句 都 进行 了 扩展 ， 人 允许 另外 一 种 选择 (但 
是 如 果 存 在 歧义 ， 则 使 用 标准 的 解释 )。 PostgreSQL 还 允许 两 个 子 句 声明 任意 的 表达 式 。 请 
注意 在 表达 式 中 出 现 的 名 字 总 是 被 当 作 输入 字段 名 ， 而 不 是 输出 字段 名 。 


SQL:1999 以 及 之 后 的 一 个 略微 不 同 的 定义 并 不 能 和 SQL-92 完全 向 前 兼容 。 不 过 ， 在 大 多 
数 情况 下 ，PostgreSQL 将 把 一 个 oRDER BY 或 GRouP BY 表达 式 解 析 成 为 SQL:1999 制定 的 那 
样 。 


PK BLK Hi 


PostgreSQL 只 在 表 的 主键 包含 在 croup BY WRAP aRU (WIFE croup By 中 省 略 
字段 ) 。 SQL 标准 指定 应 该 被 识别 的 附加 条 件 。 


WINDOW 子 句 限制 


SQL 标准 为 窗口 _frame_clause_ 提供 了 附加 选项 。 PostgreSQL 目 前 仅 支 持 上 面 列 出 的 选项 。 





LIMIT 和 OFFSET 


子 句 LIMIT 和 oFFSET 是 PostgreSQL 特定 的 语法 ， 也 是 MySQL 使 用 的 。SQL:2008 标 准 引 入 

了 OFFSET ... FETCH {FIRST|NEXT} ... 获取 相同 的 功能 ， 如 上 面 的 //MI/T 子 句子 句 所 示 。 该 
语法 也 被 IBM DB2 使 用 。 (为 Oracle 所 写 的 应用 程序 通常 使 用 一 个 涉及 自动 生成 的 rownum 列 
的 工作 区 ， 来 实现 这 些 子 句 的 效果 ， 这 在 PostgreSQL 中 是 不 可 用 的 。) 

FOR NO KEY UPDATE , FOR UPDATE , FOR SHARE , FOR KEY SHARE 


尽管 FoR UPDATE 出 现在 了 SQL 标准 中 ， 但 是 标准 只 允许 它 作 为 DECLARE CURSOR 的 一 个 选项 。 
PostgreSQL 人 允许 它 出 现在 任意 SELECT 查询 和 子 SELECT 查询 中 ， 但 是 这 是 一 个 扩 
展 。 FOR NO KEY UPDATE , FOR SHARE , FOR KEY SHARE 变 体 和 NowAIT 选项 ， 没有 出 现在 标准 


中 。 


WITH 中 的 数据 修改 语句 


PostgreSQL7tif INSERT, UPDATE ，DELETE FAYE with 查询 。 这 在 SQL 标 准 中 是 没有 的 。 


非 标准 的 子 句 


子 句 DISTINCT on 在 SQL 标准 中 未 定义 。 


SELECT INTO 


Name 


SELECT INTO -- 从 一 条 查询 的 结果 中 定义 一 个 新 表 


Synopsis 


[ WITH [ RECURSIVE ] _with_query_ [, ...] ] 

SELECT [ ALL | DISTINCT [ ON ( _expression_ [, ...] ) ] ] 
* | _expression_ [ [ AS ] _output_name_ ] [, ...] 
INTO [ TEMPORARY | TEMP | UNLOGGED ] [ TABLE ] _new_table_ 
[ FROM _from_item_ [, ...] ] 


WHERE _condition_ ] 

GROUP BY _expression_ [, ...] ] 

HAVING _condition_ [, ...] ] 

WINDOW _window_name_ AS ( _window_definition_ ) [, ...] ] 

{ UNION | INTERSECT | EXCEPT } [ ALL | DISTINCT ] _select_ ] 





LIMIT { _count_ | ALL } ] 
OFFSET _start_ [ ROW | ROWS ] ] 
FETCH { FIRST | NEXT } [ _count_ ] { ROW | ROWS } ONLY ] 


[ 
[ 
[ 
[ ORDER BY _expression_ [ ASC | DESC | USING _operator_ ] [ NULLS { FIRST | LAST } ] 
[ 
[ FOR { UPDATE | SHARE } [ OF _table_name_ [, ...] ] [ NOWAIT ] [...] ] 





SELECT INTO 从 一 个 查询 中 创建 一 个 新 表 , 并 且 将 查询 到 的 数据 插入 到 新 表 中 。 数 据 并 不 返回 
给 客户 端 ， 这 一 点 和 普通 的 sELEcT 不 同 。 新 表 的 字段 具有 和 sELEcT 的 输出 字段 相同 的 名 字 
和 数据 类 型 。 


参数 


TEMPORARY 或 TEMP 


如 果 声 明了 这 个 关键 字 ， 那 么 该 表 是 作为 一 个 临时 表 创 建 的 。 请 参考 CREATE TABLE 获 取 细 
节 。 

UNLOGGED 

如 果 指定 了 ， 那 么 表 作 为 一 个 非 日 志 表 创建 。 参 阅 CREATE TABLE 获 取 详 细 信息 。 


_new_table_ 


要 创建 的 表 的 名 字 ( 可 以 有 模式 修饰 )。 


所 有 其 它 参数 都 在 SELECT 中 有 详细 描述 。 


Sa at 
) 王 局 


CREATE TABLE AS 的 作用 和 SELECT INTO 类 似 。 建议 使 用 CREATE TABLE AS 语法 。 实际 
上 ， 它 是 不 能 在 ECPG 或 PL/pgSQL 中 使 用 的 ， 因为 它们 对 Into 子 句 的 解释 是 不 同 的 。 而 
H, CREATE TABLE AS 提供 了 sELECT INTo 所 提供 功能 的 超 集 。 


在 PostgreSQL 8.1 以 前 ， sELECT Into 创建 的 表 总 是 缺 省 包含 OID 。 到 了 PostgreSQL 8.1, 
这 不 再 是 缺 省 了 ， 要 想 在 新 表 中 包含 OID ， 可 以 打开 default with_oids 配 置 参数 . 命 
43 CREATE TABLE AS 可 以 使 用 wITH oros 子 句 包含 oid 列 。 


例子 
创建 一 个 新 表 films_recent ， 它 的 值 包含 来 自 films 的 最 近 的 条 目 : 


SELECT * INTO films_recent FROM films WHERE date_prod >= '2002-01-01'; 


FANE 


SQL 标准 用 sevect into 表示 选取 数值 到 一 个 宿主 程序 的 标量 变量 中 ， 而 不 是 创建 一 个 新 
表 。 这 种 用 法 实际 上 就 是 在 ECPG (Chapter 33) 和 PL/pgSQL(Chapter 40) 里 的 用 途 。 
PostgreSQL 用 sELEcT into 创建 表 是 历史 原因 。 在 新 代码 里 最 好 使 用 CREATE TABLE AS 实现 
这 个 目的 。 


义 见 


CREATE TABLE AS 


SET 


Name 


SET -- 修改 运行 时 参数 


Synopsis 


SET [ SESSION | LOCAL ] _configuration_parameter_ { TO | = } { _value_ | '_value_' | DEFA 
SET [ SESSION | LOCAL ] TIME ZONE { _timezone_ | LOCAL | DEFAULT } 


本 — 








sET 命令 修改 运行 时 配置 参数 。 许 多 在 Chapter 18 里 面 列 出 的 运行 时 参数 可 以 用 ser 在 运行 
时 设置 。 但 是 有 些 要 求 使 用 超级 用 户 权 限 来 修改 ， 而 其 它 有 些 则 在 服务 器 或 者 会 话 开始 之 后 
不 能 修改 。 请 注意 sET 只 影响 当前 会 话 使 用 的 数值 。 


如 果 set (或 相等 的 set session ) 是 在 一 个 稍 后 退出 的 事务 里 发 出 的 ， 那么 set 命令 的 效 
果 将 在 事务 回 滚 之 后 消失 。 一 旦 包围 它 的 事务 提交 ， 那么 其 效果 将 持续 到 会 话 结束 ， 除 非 被 
另外 一 个 SET BH. 


不 管 是 否 提交 ， set coca, 的 效果 只 持续 到 当前 事务 结束 。 一 个 特例 是 在 一 个 事务 里 面 
的 set 后 面 跟着 一 个 set LocAL : 在 事务 结束 之 前 只 能 看 到 set coca, 的 数值 ， 但 是 之 后 (如 
果 事 务 提交 )， 则 是 sET 的 值 生 效 。 


SET 或 SET LocAL 的 影响 也 可 以 通过 回 滚 到 一 个 命令 之 前 的 保存 点 取消 。 


如 果 set coca. 在 一 个 对 相同 变量 有 set 选项 的 画 数 内 使 用 (请 参阅 CREATE 

FUNCTION), set LocAL 命令 的 影响 在 范 数 退 出 时 消失 ; 也 就 是 说 ， 画 数 调用 时 起 作用 的 值 
不 论 如何 都 会 还 原 。 这 人 允许 set LocAL 用 来 对 函数 内 的 一 个 参数 进行 动态 和 反复 修改 ， 尽管 
仍然 方便 使 用 set 选项 来 保存 和 存储 调用 程序 的 值 。 然 而 ， 规则 的 sET 命 命 重 写 任何 画 数 内 
的 sET 选项 ; 其 影响 将 会 持续 ， 除 非 回 滚 。 


Note: 在 PostgreSQL 8.0 到 8.2 版 本 中 ， 一 个 set Loca. 的 影响 将 通过 释放 一 个 较 早 的 保 
存 点 被 取消 ， 或 者 通过 从 一 个 PL/pgSQL 异常 块 成 功 退出 。 该 选项 已 被 更 改 ， 因 为 它 被 
认为 是 非 直观 的 。 


SESSION 


声明 这 个 命令 只 对 当前 会 话 起 作用 。 如 果 sessron 或 coca, 都 没 出 现 ， 那么 这 个 是 缺 省 。 


LOCAL 


声明 该 命令 只 在 当前 事务 中 有 效 。 在 commit 或 者 ROLLBACK 之 后 ， 会 话 级 别 的 设置 将 再 次 生 
效 。 请 注意 如 果 在 BEGIN 块 之 外 运行 ， 那么 set loca 将 表现 出 没有 作用 ， 因为 事务 将 立即 


结束 。 
_configuration_parameter_ 


可 设置 的 运行 时 参数 的 名 字 。 可 用 的 参数 在 Chapter 18 和 下 面 有 文档 。 


_value_ 


参数 的 新 值 。 值 可 以 声明 为 字符 串 常 量 、 标 识 符 、 数 字 ， 或 者 逗号 分 隔 的 上 面 这 些 示 西 的 列 
K, 视 特 定 变 量 而 定 。 对 于 特定 参数 是 恰当 的 。 可 以 写 出 DEFAULT 把 这 些 参 数 设置 为 它们 的 
缺 省 值 。 (也 就 是 说 ， 如 果 在 当前 会 话 中 没有 set 执行 ， 已 有 的 任何 数值 都 会 设置 。) 


除了 在 Chapter 18 里 面 有 文档 记载 的 配置 参数 之 外 ， 还 有 几 个 只 能 用 set 命令 设置 ， 或 者 是 
有 特殊 的 语法 的 参数 。 


SCHEMA 


SET SCHEMA '**_value_ ' 是 SET search_path TO _value_ 的 别名 。 使 用 该 语法 只 可 指定 一 个 
模式 。 
NAMES 


SET NAMES _value_ 是 SET client_encoding TO _value_ 的 别名 。 


SEED 


为 随机 数 生成 器 ( 辑 数 random ) 设 置 内 部 的 种 子 。 人 允许 的 值 是 介 于 -1 和 1 之 间 的 浮 点 数 ， 然 
后 它 会 被 乘 以 2<sup class="calibre28">31</sup>-1。 


也 可 以 通过 调用 setseed MAKE BHF : 


SELECT setseed(_value_); 


TIME ZONE 


SET TIME ZONE _value 是 SET timezone TO ”_value ”的 一 个 别名 。 语 法 SET TIME ZONE fù 
许 为 时 区 设置 特殊 的 语法 。 下 面 是 有 效 值 的 例子 : 

'PST8PDT' 
加 州 伯 克利 的 时 区 。 


"Europe/Rome' 


意大利 时 区 。 


=h 


UTC 以 西 7 小 时 的 时 区 (等 效 于 PDT)。 正 值 为 UTC 以 未 。 


INTERVAL '-08:00' HOUR TO MINUTE 


UTC 以 西 8 小 时 的 时 区 (等 效 于 PST), 


LOCAL ` ~ DEFAULT 
将 时 区 设置 为 你 的 本 地 时 区 (也 就 是 ， 服 务 器 的 timezone 缺 省 值 )。 
参阅 Section 8.5.3 获 取 有 关 时 区 的 更 多 细节 。 
<tr 
ES 


FAR set_config 提供 了 等 效 的 功能 。 参 阅 Section 9.26, 同时 ， 可 以 UPDATE 这 
个 pg_settings 系统 视图 来 执行 sET 的 等 价 操 作 。 


例子 
设置 模式 搜索 路 径 : 


SET search_path TO my_schema, public; 


把 日 期 时 间 风 格 设置 为 传统 的 POSTGRES 风 格 (日 在 月 前 ) : 


SET datestyle TO postgres, dmy; 


把 时 区 设置 为 加 州 伯克利 : 


SET TIME ZONE 'PST8PDT'; 


为 意大利 设置 时 区 : 


SET TIME ZONE 'Europe/Rome'; 


RANE 


SET TIME ZONE 扩展 了 在 SQL 标准 里 定义 的 语法 。 标 准 只 人 允许 有 一 个 数字 时 区 偏 移 ， 而 
PostgreSQL 还 人 允许 完整 更 灵活 的 时 区 声明 。 所 有 其 它 的 set 特性 都 是 PostgreSQL 扩 展 。 
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XI 


RESET, SHOW 


SET 1927 


SET CONSTRAINTS 


Name 


SET CONSTRAINTS -- 设置 当前 事务 的 约束 检查 模式 


Synopsis 


SET CONSTRAINTS { ALL | _name_ [, ...] } { DEFERRED | IMMEDIATE } 


fia ah 


SET CONSTRAINTS 设置 当前 事务 里 的 约束 检查 的 特性 。 IMMEDIATE 约束 是 在 每 条 语句 后 面 进行 
检查 。 DEFERRED 约束 一 直到 事务 提交 时 才 检 查 。 每 个 约束 都 有 自己 


的 IMMEDIATE 或 DEFERRED 模式 。 


从 创建 的 时 候 开 始 ， 一 个 约束 总 是 给 定 为 DEFERRABLE INITIALLY DEFERRED , 

DEFERRABLE INITIALLY IMMEDIATE , NOT DEFERRABLE 三 个 特性 之 一 。 第 三 种 总 是 IMMEDIATE , 
并 且 不 会 受 SET CONSTRAINTS 影响 。 头 两 种 以 指定 的 方式 启动 每 个 事务 ， 但 是 他 们 的 行为 可 以 
在 事务 里 用 set coNSTRAINTS 改变 。 


带 着 一 个 约束 名 列表 的 SET constraints 改变 这 些 约束 的 模式 (都 必须 是 可 推迟 的 )。 每 个 约束 
名 都 可 以 是 模式 修饰 的 。 如 果 没 有 指定 任何 模式 名 ， 那 么 使 用 当前 模式 搜索 路 径 查 找 第 一 个 
匹配 名 。 SET CONSTRAINTS ALL 改变 所 有 可 推迟 约束 的 模式 。 


当 SET CONSTRAINTS 把 一 个 约束 从 DEFERRED AEX IMMEDIATE 的 时 候 ， 新 模式 反作用 式 地 起 作 
用 : 任何 将 在 事务 结束 准 各 检查 的 数据 修改 都 将 在 执行 SET constraints 的 时 候 检 查 。 如 果 
违反 了 任何 约束 ， SET constraints 都 会 失败 (并 且 不 会 修改 约束 模式 )。 

此 ， set constraints 可 以 用 于 强制 在 事务 中 某 一 点 进行 约束 检查 。 


目前 ， 仅 UNIQUE , PRIMARY KEY , REFERENCES (外 键 ), 和 EXCLUDE 约束 受 该 设置 影 
"o NOT NULL 和 CHECK 约束 总 在 一 行 被 插入 或 者 修改 时 被 检查 (REBAR) 。 RE 
BA DEFERRABLE 的 唯一 性 和 排除 性 约束 也 立即 检查 。 


被 声明 为 "约束 触发 "的 触发 器 的 触发 也 是 受 该 设置 控制 的 ， 他 们 在 相关 约束 应 被 检查 的 相同 
时 间 触 发 。 


因为 PostgreSQL 不 要 求 约束 名 称 在 一 个 模式 内 是 独一无二 的 (但 每 个 表 必 须 唯 一 ) ， 多 于 一 
个 约束 名 匹配 一 个 特定 约束 名 是 可 能 的 。 在 这 种 情况 下 ， sET constraints 将 作用 于 所 有 的 匹 
配 。 对 于 一 个 无 模式 限定 的 名 称 ， 一 且 一 个 或 多 个 匹配 在 搜索 路 径 下 的 相同 模式 中 被 找到 ， 
路 径 中 晚 出 现 的 模式 不 会 被 搜索 。 


这 个 命令 只 在 当前 事务 里 修改 约束 的 行为 。 因 此 ， 如 果 你 在 事务 块 之 外 ( BEGIN / commit 对 ) 
执行 这 个 命 舍 ， 它 将 没有 任何 作用 。 


兼容 性 


这 条 命令 与 SQL 标准 里 定义 的 行为 兼容 ， 只 不 过 ， 在 PostgreSQL 里 ， 它 不 适用 于 noT NULL 
和 check 约束 。 还 有 ，PostgreSQL 立即 检查 不 可 推 延 的 唯一 性 约束 ， 不 是 像 标准 建议 的 那 
样 在 语句 末 检 查 。 


SET ROLE 


Name 


SET ROLE -- 在 当前 会 话 中 设置 当前 用 户 标识 


Synopsis 


SET [ SESSION | LOCAL ] ROLE _role_name_ 
SET [ SESSION | LOCAL ] ROLE NONE 
RESET ROLE 


fia ah 


这 条 命 合 业 当前 会 话 的 当前 用 户 标识 为 _role_name 。 角色 名 可 以 写成 表 识 符 或 者 是 字符 串 
文本 。 在 set ROLE LA, SQL 命令 的 权限 检查 就 是 针对 这 个 用 户 了 ， 就 像 当初 用 这 个 用 户 登 
录 一 样 。 


当前 会 话 的 用 户 必 须 是 指定 的 _role_name ”角色 的 成 员 。 但 超级 用 户 可 以 选择 任何 角色 。 
SESSION 和 LocAL 修饰 词 的 作用 和 普通 的 SET 命令 一 样 。 


NONE 和 RESET 形式 重 置 当前 用 户 标识 为 当前 会 话 用 户 标 识 符 。 任 何 用 户 都 可 以 执行 这 种 形 
式 。 


Ws e e h 
) 王 局 


使 用 这 条 命令 ， 它 可 能 会 增加 一 个 用 户 的 权限 ， 也 可 能 会 限制 一 个 用 户 的 权限 。 如 果 会 话 用 
户 的 角色 有 INHERITS 属性 ， 那 么 它 自动 拥有 它 能 set ROLE 变 成 的 角色 的 所 有 权限 ; 在 这 种 
情况 下 ， set ROLE 实际 上 是 删除 了 所 有 直接 赋予 会 话 用 户 的 权限 ， 以 及 它 的 所 属 角色 的 权 
限 ， 只 剩 下 指定 角色 的 权限 。 另 一 方面 ， 如 果 会 话 用 户 的 角色 有 NoINHERITS 属 

ME, SET ROLE 删除 直接 赋予 会 话 用 户 的 权限 ， 而 获取 指定 角色 的 权限 。 


实际 上 ， 如 果 一 个 超级 用 户 set ROLE 为 一 个 非 超 级 用 户 ， 它 会 失去 其 超级 用 户 权 限 。 


SET ROLE 有 和 SET SESSION AUTHORIZATION 类 似 的 效果 ， 但 是 其 中 涉及 的 权限 检查 有 区 
别 。 还 有 ， SET SESSION AUTHORIZATION 决定 其 后 有 什么 角色 可 以 执行 SET ROLE 命令 ， 而 
FA set ROLE 并 不 修改 稍 后 的 set RoLE 可 以 设置 的 角色 集 。 


SET ROLE 并 不 如 同 角色 的 ALTER ROLE 设置 所 声明 的 那样 义理 会 话 变量 ; 这 只 在 登陆 时 发 
生 。 


SET ROLE 不 能 在 SECURITY DEFINER 加 数 内 使 用 。 


例子 


SELECT SESSION_USER, CURRENT_USER; 


session_user | current_user 


SET ROLE 'paul'; 
SELECT SESSION_USER, CURRENT_USER; 


session_user | current_user 


BR 
兼容 性 
PostgreSQL 人 允许 标识 符 语法 ("rolename" )， 而 SQL 标准 要 求 角 色 名 字 写 成 字符 串 文 本 。 


SQL 并 不 允许 在 事务 里 面 执 行 这 条 命令 ; PostgreSQL 并 未 做 此 限制 ， 因 为 没有 理由 限制 。 
SESSION 和 LocAL 修饰 词 是 PostgreSQL 的 扩展 ， 还 有 reset 语法 也 一 样 。 


义 见 


SET SESSION AUTHORIZATION 


SET SESSION AUTHORIZATION 


Name 


SET SESSION AUTHORIZATION -- 为 当前 会 话 设 置 会 话 用 户 标识 符 和 当前 用 户 标识 符 


Synopsis 


SET [ SESSION | LOCAL ] SESSION AUTHORIZATION _user_name_ 
SET [ SESSION | LOCAL ] SESSION AUTHORIZATION DEFAULT 
RESET SESSION AUTHORIZATION 


摘 述 
这 条 命令 把 当前 会 话 里 的 会 话 用 户 标 识 和 当前 用 户 标 识 都 设置 为 _user_name_ 。 这 个 用 户 名 


可 以 写成 一 个 标识 符 或 者 一 个 字符 串 文 本 。 使 用 这 yo 
稍 后 再 切换 回 超 级 用 户 。 


会 话 用 户 标识 符 一 开始 设置 为 (可 过 认证 的 ) 客 户 端 提供 的 用 户 名 。 当前 用 户 标 识 符 通常 
等 于 会 话 用 户 标 识 符 ， 但 是 可 色 Ws SECURITY DEFINER 的 环境 里 或 者 类 似 的 机 制 里 临时 改变 。 
也 可 以 用 SET ROLE 来 修改 。 当前 用 户 的 身份 和 权限 检查 有 关 。 


ee 会 话 用 户 标识 符 才 能 改变 成 
它 用 户 。 否 则 ， 只 能 使 用 登录 时 使 用 认证 用 户 ， 系 统 才 接 受 该 命令 。 


SESSION 和 LocAL 修饰 词 和 普通 SET 命令 里 的 作用 相同 。 


DEFAULT 和 RESET 形式 重 置 会 话 和 当前 用 户 标识 符 为 初始 认证 的 用 户 名 。 这 些 形式 可 以 为 任 
何 用 户 执行 。 


So at 
) 王 局 


SET SESSION AUTHORIZATION 不 能 用 在 SECURITY DEFINER AXA. 


例子 


SELECT SESSION_USER, CURRENT_USER; 


session_user | current_user 


SET SESSION AUTHORIZATION 'paul'; 
SELECT SESSION_USER, CURRENT_USER; 


session_user | current_user 


RANE 


SQL 标准 允许 一 些 其 它 的 表达 式 出 现在 文本 username 的 位 置 上 ， 不 过 这 个 东西 实际 上 并 
不 重要 。PostgreSQL 人 允许 标识 符 语法 ( "username" )， 而 SQL 不 允许 。SQL 不 允许 在 一 个 事 
务 的 过 程 中 用 这 条 命令 ; PostgreSQL 没 有 这 个 限制 ， 因 为 没有 什么 理由 不 允许 这 样 用 。 
SESSION 和 LocAL 是 PostgreSQL 扩 展 ， RESET 语法 也 是 。 


标准 里 头 把 执行 这 个 命令 所 需 的 必要 权限 ， 交 给 具体 的 数据 库 实 现 自 己 去 定义 。 


义 见 


SET ROLE 


SET TRANSACTION 


Name 


SET TRANSACTION -- 设置 当前 事务 的 特性 


Synopsis 


SET TRANSACTION _transaction_mode_ [, ...] 
SET TRANSACTION SNAPSHOT _snapshot_id_ 
SET SESSION CHARACTERISTICS AS TRANSACTION _transaction_mode_ [, ...] 


这 里 的 “_transaction_mode_` 是 下 列 之 一 : 


ISOLATION LEVEL { SERIALIZABLE | REPEATABLE READ | READ COMMITTED | READ UNCOMMITTED 
READ WRITE | READ ONLY 
[ NOT ] DEFERRABLE 





fia aah 


SET TRANSACTION 命令 为 当前 事务 设置 特性 。 它 对 后 面 的 事务 没有 影响 。 
SET SESSION CHARACTERISTICS 为 一 个 会 话 中 随后 的 每 个 事务 设置 缺 省 的 事务 特性 。 在 单独 的 
事务 中 ， 可 以 用 set TRANSACTION 覆盖 这 些 默认 事务 特性 。 


可 用 的 事务 特性 是 事务 隔离 级 别 、 事 务 访问 模式 ( 读 / 写 或 者 只 读 ) 和 可 推迟 的 模式 。 另外 ， 可 
以 选择 一 个 快照 ， 只 为 当前 事务 而 不 是 作为 会 话 缺 省 。 

事务 的 隔离 级 别 决定 一 个 事务 在 有 其 它 事务 并 发 运行 时 它 能 够 看 到 什么 数据 

READ COMMITTED 

一 条 语句 只 能 看 到 在 它 开 始 之 前 的 数据 。 这 是 缺 省 。 

REPEATABLE READ 

当前 事务 中 的 所 有 语句 只 能 看 到 在 这 次 事务 第 一 条 查询 或 者 修改 数据 的 语句 执行 之 前 已 经 提 
交 的 数据 。 

SERIALIZABLE 

当前 事务 中 的 所 有 语句 只 能 看 到 在 这 次 事务 第 一 条 查询 或 者 修改 数据 的 语句 执行 之 前 已 经 提 


交 的 数据 。 如 果 当 前 并 发 的 可 串 行 化 事务 的 读 或 写 模 式 中 任意 一 个 事务 (一 次 一 个 ) 执行 创 
建 不 可 能 发 生 的 情况 ， 那么 其 中 的 一 个 事务 将 会 带 有 serialization_failure 错误 退出 。 


SQL 标准 还 定义 了 另外 一 个 级 别 ， READ UNCOMMITTED o PostgreSQL READ UNCOMMITTED 
被 当 作 READ COMMITTED 。 


事务 隔离 级 别 在 事务 中 第 一 个 查询 或 数据 修改 语句 ( SELECT ，INSERT ，DELETE ， UPDATE , 
FETCH , 或 copy ) 执 行 之 后 就 不 能 再 次 设置 。 参阅 Chapter 13 获取 有 关 事 务 隔离 级 别 和 并 发 
性 控制 的 更 多 信息 。 


事务 访问 模式 决定 事务 是 读 / 写 还 是 只 读 。 读 / 写 是 缺 省 。 如 果 一 个 事务 是 只 读 ， 而 且 写 入 的 表 
不 是 临时 表 ， 和 那么 下 面 的 SQL 命令 是 不 允许 的 : INSERT, UPDATE , DELETE , COPY FROM ; 
而 所 有 的 cREATE ，ALTER ，DROP ; COMMENT ， GRANT , REVOKE , TRUNCATE ; EXPLAIN ANALYZE , 


EXECUTE 都 不 允许。 这 是 一 个 高 层次 的 只 读 概 念 ， 它 并 不 阻止 所 有 对 磁盘 的 写 入 。 


DEFERRABLE 事务 属性 没什么 影响 ， 除 非 事务 也 是 SERIALIZABLE 和 READ ONLY 。 当 为 一 个 事务 
选择 所 有 这 三 个 属性 时 ， 事务 可 能 会 在 第 一 次 请 求 它 的 快照 时 堵塞 ， 之 后 运行 时 可 以 不 需要 
正常 的 sERIALIZABLE 事务 的 开销 并 且 不 会 有 任何 导致 序列 化 失败 或 被 取消 的 风险 。 这 个 模式 
很 适合 于 长 时 间 运 行 的 报告 或 备份 。 


SET TRANSACTION SNAPSHOT 命令 人 允许 一 个 新 的 事务 运行 的 快照 与 一 个 现存 事务 的 相同 。 该 已 
有 的 事务 必须 已 经 用 pg_export_snapshot WMA (参阅 Section 9.26.5) 输出 了 它 的 快照 。 这 个 
画 数 返 回 一 个 快照 标识 符 ， 这 个 标识 符 必须 给 SET TRANSACTION SNAPSHOT 以 指出 要 输出 哪个 
快照 。 该 标识 符 在 这 个 命 伟 中 必须 写作 字符 串 ， 例 如 '606663A1-1' o 

SET TRANSACTION SNAPSHOT 只 能 在 该 事务 第 一 次 查询 或 数据 修改 语句 执行 之 前 设置 ， 

( SELECT , INSERT ， DELETE ， UPDATE , FETCH, copy), 另外， 事务 必须 已 经 设置 

为 SERIALIZABLE 或 REPEATABLE READ 隔离 级 别 ( 否 则 ， 快 照会 被 立即 丢弃 ， 因 为 

READ COMMITTED 模式 为 每 个 命令 接受 一 个 新 的 快照 ) 。 如 果 导 入 事务 使 用 sERIALIZABLE 隔离 
级 别 ， 那 么 输出 快照 的 事务 必须 也 使 用 该 隔离 级 别 。 还 有 ， 非 只 读 的 序列 化 事务 不 能 从 一 个 
只 读 的 事务 中 导入 一 个 快照 。 


MN 王 
ťia 


如 果 执 行 SET TRANSACTION 之 前 没有 执行 START TRANSACTION 或 BEGIN ， 那 么 它 会 显得 没有 效 


果 一 样 ， 因 为 事务 将 立即 结 
可 以 用 在 BEGIN 或 START TRANSACTION 里 面 声 明 所 需要 的 _transaction_modes ”的 方法 来 避免 


使 用 SET TRANSACTION 。 但 是 这 个 选项 不 适用 于 SET TRANSACTION SNAPSHOT o 


会 话 的 缺 省 事务 模式 也 可 以 通过 设置 配置 参数 default transaction isolation, 
default_transaction_read_only, 和 default_ transaction_deferrable 的 方法 来 设置 。 (实际 

上 SET SESSION CHARACTERISTICS 只 是 一 个 用 set 来 设置 这 些 参数 的 另 一 种 等 效 的 方法 )。 这 就 
意味 着 缺 省 值 可 以 通过 ALTER DATABASE 或 在 配置 文件 里 等 方法 设置 。 参 考 Chapter 18 获 取 更 
多 信息 。 


例子 


开启 一 个 与 已 经 存在 的 事务 具有 相同 快照 的 新 事务 ， 首 先 从 现存 事务 中 输出 快照 。 这 将 返回 
快照 的 标识 符 ， 例 如 : 


BEGIN TRANSACTION ISOLATION LEVEL REPEATABLE READ; 
SELECT pg_export_snapshot(); 
pg_export_snapshot 


000003A1-1 
(1 row) 


然后 在 新 打开 的 事务 的 开始 的 SET TRANSACTION SNAPSHOT 命令 中 给 出 快照 标识 符 : 


BEGIN TRANSACTION ISOLATION LEVEL REPEATABLE READ; 
SET TRANSACTION SNAPSHOT '000003A1-1'; 


oy h 
兼容 性 
这 些 命令 在 SQL 标准 中 定义 了 ， 除 了 DEFERRABLE 事务 模式 和 SET TRANSACTION SNAPSHOT 格式 
是 PostgreSQL 的 扩展 。 


标准 里 的 缺 省 事务 隔离 级 别 是 SERIALIZABLE ; 但 在 PostgreSQL 里 ， 缺 省 隔离 级 别 是 
READ COMMITTED ， 但 是 你 可 以 用 上 面 描述 的 方法 修改 它 。 


在 SQL 标准 里 还 有 另外 一 种 事务 特性 可 以 用 这 些 命令 设置 : 诊断 范围 的 大 小 。 这 个 概念 只 用 
FRAR SQL ， 因 此 没有 在 PostgreSQL 服 务 器 里 实现 。 


SQL 标准 要 求 在 相连 的 _transaction_modes ”之 间 使 用 逗号 ， 但 是 因为 历史 原因 ， 
PostgreSQL 70 if BEB MES. 


SHOW 


Name 


SHOW -- 显示 运行 时 参数 的 值 


Synopsis 


SHOW _name_ 
SHOW ALL 


摘 述 


SHOW 将 显示 当前 运行 时 参数 的 数值 。 这 些 变量 可 以 通过 set 语句 、 编 辑 postgresql.conf X 
件 、“PGoPTIONS 环境 变量 (在 使 用 基于 libpq 的 应 用 程序 的 时 候 )、 启动 postgres 服务 器 的 命令 
行 参数 来 设置 。 参 闭 Chapter 18 获 取 细 节 。 


参数 


_name_ 


运行 时 参数 的 名 称 。 可 用 的 参数 在 Chapter 18 以 及 SET 手册 页 里 面 有 文档 。 另 外 ， 还 有 一 些 
参数 可 以 显示 ， 但 是 不 能 设置 : 


SERVER_VERSION 
显示 服务 器 的 版 本 号 。 


SERVER_ENCODING 


显示 服务 器 端的 字符 集 编 码 。 目 前 ， 这 个 参数 只 能 显示 但 不 能 设置 ， 因为 编码 是 在 创建 数据 
库 的 时 候 决 定 的 。 

LC_COLLATE 

显示 数据 库 的 排序 规则 区 域 设 置 (文本 顺序 )。 目 前 ， 这 个 参数 只 能 显示 但 不 能 设置 ， 因为 它 
是 在 数据 库 创 建 的 时 候 设 置 的 。 

LC_CTYPE 


显示 数据 库 字符 集 分 类 的 区 域 设 置 。 目 前 ， 这 个 参数 只 能 显示 但 不 能 设置 ， 因为 它 是 在 数据 
库 创建 的 时 候 设置 的 。 


IS_SUPERUSER 


如 果 当 前 角色 拥有 超级 用 户 权 限 ， 则 为 真 。 


ALL 


显示 所 有 配置 参数 值 以 及 其 描述 。 


Ne = 
ťia 
PENX current_setting 生成 相同 的 输出 ; 参阅 Section 9.26, 28, pg settings 系统 视图 生 


成 同样 的 信息 。 


例子 
显示 参数 patestyle 的 当前 设置 : 


SHOW DateStyle; 
DateStyle 


显示 参数 geqo 的 当前 设置 : 


SHOW gedo ， 
geqo 


显示 所 有 设置 : 


SHOW ALL; 
setting | description 
+ 


off | Allows modifications of the structure of ... 





xmloption | content | Sets whether XML data in implicit parsing ... 
zero_damaged_pages | off | Continues processing past damaged page headers. 
(196 rows) 


SS ay 





sHow 命令 是 PostgreSQL 扩 展 。 
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XI 


SEIT RESET 


SHOW 1939 


START TRANSACTION 


Name 


START TRANSACTION -- 开始 一 个 事务 块 


Synopsis 


START TRANSACTION [ _transaction_mode_ [, ...] ] 
这 里 的 `_ transaction_mode “是 下 列 之 一 : 


ISOLATION LEVEL { SERIALIZABLE | REPEATABLE READ | READ COMMITTED | READ UNCOMMITTED 
READ WRITE | READ ONLY 
[ NOT ] DEFERRABLE 


这 条 命令 开始 一 个 新 的 事务 块 。 如 果 声 明了 隔离 级 别 、 读 写 模 式 或 可 推迟 模式 ， 那么 新 事务 
就 使 用 这 些 特性 ， 如 同 执 行 了 SET TRANSACTION 一 样 。 它 和 BEGIN 命 仿 等 价 。 


参数 


参阅 SET TRANSACTION 获 取 有 关 这 个 语句 参数 合 义 的 信息 。 


兼容 性 


在 标准 里 ， 没 必要 声明 start TRANSACTION 来 开始 一 个 事务 块 : 任何 SQL 语句 都 隐 含 地 开始 
一 个 事务 块 。PostgreSQL 的 行为 可 以 认为 是 隐 含 地 在 每 条 没有 跟 

在 START TRANSACTION 或 BEGIN 后 面 的 命令 自动 发 出 一 条 coMMIT ， 因 此 这 个 行为 常 被 称 作 " 自 
动 提交 "。 其 它 关 系数 据 库 系 统 可 能 也 提供 自动 提交 这 一 方便 的 特性 。 


DEFERRABLE ”_transaction_mode ”是 一 个 PostgreSQL 语 言 扩展 。 


SQL 标准 要 求 在 相连 的 _transaction_modes ”之 间 有 逗号 ， 但 是 出 于 历史 原因 ，PostgreSQL 
允许 省 略 这 个 逗号 。 


又 见 SETTRANSACTION 的 兼容 性 小 节 。 
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XI 


BEGIN, COMMIT, ROLLBACK, SAVEPOINT, SET TRANSACTION 


START TRANSACTION 1941 


TRUNCATE 


Name 


TRUNCATE -- 清空 一 个 或 一 组 表 


Synopsis 


TRUNCATE [ TABLE ] [ ONLY ] _name_ [ * ] ] 
[ RESTART IDENTITY | CONTINUE IDENTITY ] [ CASCADE | RESTRICT ] 


TRUNCATE 快速 地 从 一 堆 表 中 删除 所 有 行 。 它 和 在 每 个 表 上 进行 无 条 件 的 peLETE Al RIM 
果 ， 不 过 因为 它 不 做 表 扫 描 ， 因 而 快 得 多 。 另 外 ， 它 快速 回收 磁盘 空间 ， 而 不 是 请 求 一 个 随 
后 的 vacuum 操作 。 在 大 表 上 最 有 用 。 


参数 


_name_ 


ee ey 如 果 在 表 名 前 声明 了 oy, 那么 只 有 那个 表 会 被 清空 。 
如 果 没 有 声明 oNLY ， 这 个 表 以 及 其 所 有 子 表 (4A) 会 被 清空 。 可 选 地 ,可 以 在 表 名 后 声 
BA * BE ar he 


RESTART IDENTITY 
截断 表 中 的 序列 字段 的 序列 值 将 被 重 置 。 
CONTINUE IDENTITY 


不 要 改变 序列 的 值 。 此 为 缺 省 。 


CASCADE 


级 联 清空 所 有 在 该 表 上 有 外 键 引用 的 表 ， 或 者 由 于 cascave 而 被 添加 到 组 中 的 表 。 


RESTRICT 


如 果 有 外 键 引 用 数据 并 且 引用 表 没 有 在 命令 行 中 列 出 ， 则 拒绝 清空 。 这 是 缺 省 。 


MAN 
) 王 局 


你 必须 对 表 有 TRUNCATE 权限 以 清空 它 。 


TRUNCATE 在 在 操作 的 每 个 表 上 请 求 一 个 access EXCLUSIVE 锁 ， 这 种 锁 会 阻塞 表 上 的 所 有 其 他 
并 发 操作 。 当 声明 了 RESTART IDENTITY 时 ， 任何 被 重 馈 的 序列 也 会 被 排他 锁 锁 住 。 如 果 需 要 
对 一 个 表 并 发 访问 ， 那么 应 该 使 用 DELETE 命令 。 


如 果 从 其 它 表 有 到 某 个 表 的 外 键 引 用 ， 那 么 就 不 能 对 该 表 使 用 Truncate ， 除非 这 些 表 在 同一 
个 命 舍 中 也 被 清空 。 在 这 种 情况 下 检查 有 效 性 要 求 进行 表 打 描 ， 而 truncate 并 不 做 这 样 的 事 
情 。 CASCADE 选项 可 以 用 于 级 联 包含 所 有 依赖 表 ， 但 是 使 用 此 选项 必须 十 分 小 心 ， 否 则 可 能 
丢失 原本 不 想 丢 失 的 数据 。 


TRUNCATE 不 会 触发 任何 在 该 表 上 的 on DELETE 触发 器 。 但 它 会 触发 on TRUNCATE 触发 器 。 如 
果 任 何 表 上 定义 有 oN TRUNCATE 触发 器 ， 则 所 有 的 BEFORE TRUNCATE 触发 器 会 在 任何 截断 发 
生 之 前 触发 ， 而 所 有 AFTER TRUNCATE 触发 器 会 在 最 后 一 个 截断 执行 后 和 任何 序列 重 设 后 被 触 
发 。 该 触发 器 会 以 表 执 行 的 顺序 触发 〈 首 先是 命令 中 列 出 的 ， 然 后 是 任何 基于 级 联 添加 


的 ) 。 


Warning 


TRUNCATE 不 是 mvcc 安全 的 操作 (参考 mvcc 的 文档 ) 。 在 截断 之 后 ， 所 有 并 发 的 事务 看 
到 的 该 表 都 是 空 的 ， 即 使 他 们 在 截断 发 生前 使 用 快照 。 这 将 是 一 个 针对 截断 发 生 之 前 没 
有 访问 截断 表 的 事务 的 问题 ， 在 事务 中 对 截断 表 的 任何 访问 至 少 产 生 一 个 

ACCESS SHARE 锁 ， 这 将 阻塞 truncate 直到 事务 完成 。 所 以 截断 不 会 导致 在 相同 表 上 连续 
查询 时 表 内 容 上 的 明显 不 一 致 ， 但 会 导致 截断 表 和 数据 库 中 其 他 表 在 内 容 上 可 见 的 不 一 


致 性 。 
TRUNCATE 在 事务 中 断 表 数据 是 安全 可 的 : 只 要 开启 的 事物 不 提交 ， 则 事物 会 安全 回 滚 。 


当 声 明了 RESTART IDENTITY it, F&A ALTER SEQUENCE RESTART 操作 也 会 事务 性 的 完成 ; 也 
就 是 ， 如 果 包 围 的 事务 没有 提交 ， 它 们 将 回 滚 。 这 不 同 于 ALTER SEQUENCE restart 的 正常 行 
为 。 要 知道 ， 如 果 在 序列 重启 之 后 与 事务 回 滚 之 前 执行 了 额外 的 序列 操作 ， 那么 这 些 操作 的 
影响 也 会 回 滚 ， 但 是 它们 在 currval() 上 的 影响 不 会 回 滚 ; 也 就 是 ， 在 事务 之 

后 ， currval() 将 继续 反映 在 失败 事务 中 获得 的 最 后 序列 值 ， 即使 序列 本 身 可 能 与 其 不 再 一 
致 。 这 类 似 于 currval() 在 一 个 失败 事务 后 的 普通 行为 。 


例子 
清空 bigtable 和 fattable X : 


TRUNCATE bigtable, fattable; 


同样 地 ， 也 重 置 任何 相关 的 序列 生成 器 : 


TRUNCATE bigtable, fattable RESTART IDENTITY; 


清空 othertable 表 ， 并 且 级 联 清空 所 有 通过 外 键 约束 引用 othertable 的 表 : 


TRUNCATE othertable CASCADE; 


兼容 性 


SQL:2008 标 准 包括 一 个 有 语法 TRUNCATE TABLE _tablename_ 的 TRUNCATE 命 

Mo CONTINUE IDENTITY / RESTART IDENTITY 也 出 现在 那个 标准 中 ， 但 是 有 轻微 的 不 同和 相关 
的 含义 。 该 命令 的 一 些 并 发 行为 通过 标准 定义 实现 的 ， 所 以 ， 如 果 必 要 ， 应 该 考虑 上 面 的 说 
明 并 与 其 他 实现 比较 。 


UNLISTEN 


Name 


UNLISTEN -- 停止 监听 通知 信息 


Synopsis 


UNLISTEN { _channel_ | * } 


FA 
UNLISTEN 用 于 删除 一 个 现 有 的 已 注册 NoTIFY 事件 。 untisten 取消 当前 PostgreSQL 会 话 中 
所 有 对 通知 通道 名 为 _channel_ 的 监听 。 特殊 的 条 件 通 配 符 * 取消 对 当前 会 话 的 所 有 监听 。 


NOTIFY 包 含 一 些 对 LISTEN 和 NoTIFY 的 更 广泛 的 讨论 。 


参数 


_channel_ 


通知 通道 名 称 (任意 标识 符 )。 


该 会 话 当 前 的 所 有 监听 都 将 被 清除 。 


~ a 


al 

即使 取消 一 个 你 没有 监听 的 事件 ， 后 端 也 不 会 警告 或 报错 。 
每 个 会 话 在 退出 时 都 会 自动 执行 UNLISTEN * 。 

一 个 已 经 执行 了 uNLISTEN 的 事务 不 能 为 二 阶段 提交 做 准备 。 
例子 


注册 一 个 : 


LISTEN virtual; 
NOTIFY virtual; 
Asynchronous notification "virtual" received from server process with PID 8448. 


一 旦 执行 了 UNLISTEN ， 以 后 的 NoTIFY 信息 都 将 被 忽略 : 


UNLISTEN virtual; 
NOTIFY virtual; 
-- 收 不 到 NOTIFY 事件 


兼容 性 


SQL 标准 里 没有 UNLISTEN 命令 。 


义 见 


LISTEN, NOTIFY 


UPDATE 


Name 


UPDATE -- 更 新 一 个 表 中 的 行 


Synopsis 


[ WITH [ RECURSIVE ] _with_query_ [, ...] ] 
UPDATE [ ONLY ] _table_name_ [ * ] [ [ AS ] alias ] 
SET { _column_name_ = { _expression_ | DEFAULT } | 
( _column_name_ [, ...] ) = ( { _expression_ | DEFAULT } [, ...] ) } [, ...] 
[ FROM _from_list_ ] 
[ WHERE _condition_ | WHERE CURRENT OF _cursor_name_ ] 
[ RETURNING * | _output_expression_ [ [ AS ] _output_name_ ] [, ...] ] 





UPDATE 改变 满足 条 件 的 所 有 行 中 指定 的 字段 值 。 只 在 se 子 句 中 出 现 需要 修改 的 行 ， 没 有 
出 现 的 其 他 字段 保持 它们 原来 的 数值 。 


使 用 同一 数据 库 里 其 它 表 的 信息 来 更 新 一 个 表 有 两 种 方法 : 使 用 子 查询 ， 或 者 在 FRoM FA 
里 声明 另外 一 个 表 。 哪 个 方法 更 好 取决 于 具体 的 环境 。 


可 选 的 RETURNING 子 句 将 导致 uppATE 基于 每 个 被 更 新 的 行 计 算 返 回 值 。 任何 使 用 表 的 字段 的 
表达 式 或 FRoM 中 使 用 的 其 他 表 的 字段 都 可 以 用 于 计算 。 计算 的 时 候 使 用 刚刚 被 更 新 过 的 字 
段 新 值 。 RETURNING 列表 的 语法 与 SELEcT 的 输出 列表 相同 。 


你 必须 对 表 或 至 少 在 列 出 的 要 被 更 新 的 字段 上 有 uppate 权限 ， 同样 在 _expressions_ 
或 _condition_ 条 件 里 提 到 的 任何 字段 上 也 要 有 SELECT 权限 。 


参数 


_with_query_ 


WITH 子 句 允许 声明 一 个 或 多 个 可 以 在 uppATE 查询 中 通过 名 字 引 用 的 子 查询 。 参 阅 Section 
7.8 和 SELECT 获取 详细 信息 。 


_table_name_ 


要 更 新 的 表 的 名 称 (可 以 有 模式 修饰 )。 如 果 在 表 名 前 声明 了 ony, 那么 只 在 该 表 中 更 新 匹配 
的 行 。 如 果 没 有 声明 oNLY ， 那 么 该 表 的 任何 继承 表 内 的 匹配 行 也 要 更 新 。 可 选 的 ， 可 以 在 
表 名 后 面 声 明 * 以 明确 表明 包含 后 代表 。 


_alias_ 

目标 表 的 别名 。 如 果 指 定 了 别名 ， 那 么 它 将 完全 遮盖 表 的 本 名 。 例 如 ， 给 定 

UPDATE foo As f 之 后 ， 剩 余 的 uppATE 语句 必须 用 f 而 不 是 foo 引用 这 个 表 。 
_column_name_ 

X _table_name 中 的 字段 名 。 必 要 时 ， 字段 名 可 以 用 子 域 名 或 者 数组 下 标 修饰 。 不 要 在 指定 
字段 名 的 时 候 加 上 表 名 字 。 比如 UPDATE tab SET tab.col = 1 就 是 错误 的 。 

_expression_ 

给 字段 赋值 的 表达 式 。 表 达 式 可 以 使 用 这 个 或 其 它 字段 更 新 前 的 旧 值 。 

DEFAULT 

把 字段 设置 为 它 的 缺 省 值 ， 如 果 没 有 缺 省 表达 式 ， 那 么 就 是 NULL。 

_from_list_ 

一 个 表 表 达 式 的 列表 ， 人 允许 来 自 其 它 表 中 的 字段 出 现在 were 条 件 里 和 更 新 表达 式 中 。 这 个 


类 似 于 可 以 在 一 个 sect 语句 的 FROM FA 子 句 里 声明 表 列 表 。 请 注意 目标 表 绝 对 不 能 
现在 _from list 里， 除非 你 是 在 使 用 一 个 自 连接 (此 时 它 必须 以 _from_list_ 的 别名 出 现 )。 


_condition_ 


一 个 返回 boolean 结果 的 表达 式 。 只 有 这 个 表达 式 返 回 true 的 行 才 会 被 更 新 。 


_Cursor_name_ 


在 WHERE CURRENT OF 条 件 下 使 用 的 游标 的 名 称 。 要 更 新 的 行 是 最 近 从 该 游标 中 抓 去 的 行 。 该 
游标 必须 是 一 个 uppate 目标 表 中 的 非 分 组 查询 。 请 注意 WHERE CURRENT OF 不 能 与 布尔 条 件 
一 起 声明 。 参 阅 DECLARE 获 取 更 多 关于 通过 WHERE cURRENT oF 使 用 游标 的 信息 。 


_output_expression_ 


在 所 有 需要 更 新 的 行 都 被 更 新 之 后 ， UPDATE 命令 用 于 计算 返回 值 的 表达 式 。 这 个 表达 式 可 以 
使 用 任何 _table_name ”命名 的 表 以 及 FRoM 中 列 出 的 表 的 字段 。 写 上 * 表示 返回 所 有 字段 。 


_output_name_ 


字段 的 返回 名 称 。 


Outputs 


成 功 完 成 后 ， upPDATE 返回 形 如 


UPDATE _count_ 


的 命令 标签 。 _count ”是 更 新 的 行 数 ， 包括 没有 改变 值 的 匹配 行 。 请 注意 当 更 新 受 
到 BEFORE UPDATE 触发 器 的 抑制 时 ， 这 个 数字 可 能 小 于 匹配 condition. 的 行 数 。 如 
R cout. 为 0， 则 没有 行 被 这 个 查询 更 新 (这 个 不 认为 是 错误 )。 


如 果 UPDATE 包含 RETURNING 子 句 ， 那 么 返回 的 结果 将 类 似 于 包含 在 RETURNING 列表 中 定义 的 
字段 和 值 的 sELECT 语句 ， 只 不 过 返回 结果 是 基于 被 更 新 的 行 而 已 。 

NN > 

壮 尽 


在 出 现 FRoM 子 句 的 时 候 ， 实 际 上 发 生 的 事情 是 目标 表 和 _from_list 里 提 到 的 表 连 接 在 一 
起 ， 并 且 每 个 连接 输出 行 都 代表 一 个 目标 表 的 更 新 操作 。 在 使 用 FRoM 的 时 候 ， 你 应 该 保证 
连接 为 每 个 需要 修改 的 行 最 多 生成 一 个 输出 行 。 换 句 话说 ， 一 个 目标 行 不 应 该 和 超过 一 行 来 
自 其 它 表 的 数据 行 连接 。 如 果 它 连接 了 多 于 一 个 行 ， 那么 连接 行 里 面 将 会 只 有 一 行 用 于 更 新 
目标 行 ， 但 是 究竟 使 用 哪 行 是 很 难 预 期 的 事情 。 


为 这 个 不 确定 性 ， 只 在 子 查询 里 面 引 用 其 它 表 是 安全 的 ， 尽 管 通常 更 难 读 并 且 比 使 用 连接 
也 更 慢 些 。 


例子 
ER films 里 的 字段 kind 里 的 词 Drama 用 Dramatic RË : 


UPDATE films SET kind = 'Dramatic' WHERE kind = 'Drama'; 


调整 表 weather 中 的 某 行 的 温度 并 把 该 行 的 降水 量 设置 为 缺 省 值 : 


UPDATE weather SET temp_lo = temp_lo+i, temp_hi = temp_lo+15, prcp = DEFAULT 
WHERE city = 'San Francisco' AND date = '2003-07-03'; 


做 同样 的 事情 并 返回 更 新 后 的 条 目 : 


UPDATE weather SET temp_lo = temp_lo+1, temp_hi = temp_lo+15, prcp = DEFAULT 
WHERE city = 'San Francisco' AND date = '2003-07-03' 
RETURNING temp_lo, temp_hi, prcp; 


使 用 另 一 种 字段 列表 语法 来 做 同样 的 事情 : 


UPDATE weather SET (temp_lo, temp_hi, prcp) = (temp_lot+i, temp_lo+15, DEFAULT) 
WHERE city = 'San Francisco' AND date = '2003-07-03'; 


增加 负责 Acme 公司 客户 的 销售 员 的 销售 计数 ， 使 用 FRoM 子 句 语 法 : 


UPDATE employees SET sales_count = sales_count + 1 FROM accounts 
WHERE accounts.name = 'Acme Corporation' 
AND employees.id = accounts.sales_person; 


使 用 wer 子 句 里 的 子 查询 执行 同样 的 操作 : 


UPDATE employees SET sales_count = sales_count + 1 WHERE id = 
(SELECT sales_person FROM accounts WHERE name = 'Acme Corporation'); 


试图 带 着 库存 量 插 入 一 个 新 的 库存 项 。 如 果 该 项 存在 ， 则 更 新 现 有 项 的 库存 数 。 要 做 这 件 事 


情 而 又 不 使 整个 事务 失效 ， 使 用 保留 点 。 


BEGIN; 

-- 其 它 操作 

SAVEPOINT sp1; 

INSERT INTO wines VALUES('Chateau Lafite 2003', '24'); 

-- 假设 上 面 因为 一 个 唯一 键 字 违 例 而 失效 ， 

-- 因此 现在 发 出 这 些 命令 : 

ROLLBACK TO spi; 

UPDATE wines SET stock = stock + 24 WHERE winename = 'Chateau Lafite 2003'; 
- - 继续 其 它 操 作 ， 最 后 

COMMIT; 


更 改 表 films 的 kind 列 ， 在 游标 c_films 目前 定位 的 行 上 : 


UPDATE films SET kind = 'Dramatic' WHERE CURRENT OF c_films; 


cA hy 
兼容 性 
这 条 命令 遵循 SQL 标准 。 只 是 From 和 RETURNING 子 句 是 PostgreSQL 扩 展 ， 就 像 
和 uPDATE 一 起 使 用 wITH o 
标准 的 字段 列表 语法 允许 从 行 值 表达 式 指 定 字段 列表 ， 比 如 一 个 子 查询 : 


UPDATE accounts SET (contact_last_name, contact_first_name) = 
(SELECT last_name, first_name FROM salesmen 
WHERE salesmen.id = accounts.sales_id); 


这 个 功能 目前 尚未 实现 : 源 必 须 是 一 个 独立 的 表达 式 。 


有 些 其 它 数 据 库 系统 提供 一 个 FRoM 选项 ， 在 这 个 选项 下 ， 认为 目标 表 会 再 次 在 FRoM 里 列 
出 。 这 不 是 PostgreSQL 解析 From 的 方式 。 移 植 使 用 这 类 扩展 的 应 用 时 要 注意 。 


VACUUM 


Name 


VACUUM -- 垃圾 收集 以 及 可 选 地 分 析 一 个 数据 库 


Synopsis 





VACUUM [ ( { FULL | FREEZE | VERBOSE | ANALYZE } [, ...] ) ] [ _table_name_ [ (_column_na 
VACUUM [ FULL ] [ FREEZE ] [ VERBOSE ] [ _table_name_ ] 
VACUUM [ FULL ] [ FREEZE ] [ VERBOSE ] ANALYZE [ _table_name_ [ (_column_name_ [, ...] ) 








vacuum 回收 死 行 占据 的 存储 空间 。 在 一 般 的 PostgreSQL 操作 里 ， 那 些 已 经 DELETE 的 行 或 
者 补 UPDATE 过 后 过 时 的 行 并 没有 从 它们 所 属 的 表 中 物理 删除 ; 在 完成 vacuum 之 前 它们 仍 
然 存 在 。 因 此 有 必要 周期 地 运行 vacuum, 特别 是 在 经 常 更 新 的 表 上 。 


如 果 没 有 参数 ， vAcuuM 义理 当前 用 户 有 权限 vacuum 的 当前 数据 库 里 的 每 个 表 ， 如 果 有 参 
数 ， vAcuuM 只 义理 那个 表 。 


VACUUM ANALYZE 先 执行 一 个 vacuum 然后 是 给 每 个 选 定 的 表 执 行 一 个 ANALYZE 。 对 于 日 常 维 
护 脚本 而 言 ， 这 是 一 个 很 方便 的 组 合 。 参 阅 ANALYZE 获 取 更 多 有 关 其 处 理 的 细节 。 


简单 的 vacuum (没有 FULL ) 只 是 简单 地 回收 空间 并 且 今 其 可 以 再 次 使 用 。 这 种 形式 的 命令 可 
以 和 对 表 的 普通 读 写 并 发 操作 ， 因 为 没有 请 求 排他 锁 。 然 而 ， 额外 的 空间 并 不 返回 到 操作 系 
% 〈 在 大 多 数 情况 下 ) ; 仅 保 持 在 相同 的 表 中 可 重用 。 vacuum FULL 将 表 的 全 部 内 容重 写 到 
一 个 没有 任何 多 余 空间 的 新 磁盘 文件 中 ， 人 允许 未 使 用 的 空间 返回 到 操作 系统 中 。 这 种 形式 要 
慢 许 多 并 且 在 处 理 的 时 候 需 要 在 表 上 施加 一 个 排 它 锁 。 


当选 项 列表 被 括号 括 起 来 时 ， 该 选项 可 以 任意 顺序 来 守 。 没 有 圆 插 号 ， 选 项 必须 按 以 上 显示 
的 顺序 指定 。 加 圆 括号 的 语法 在 PostgreSQL 9.0 中 添加 ; 不 加 括号 的 语法 已 经 废弃 了 。 


参数 


FULL 


选择 "完全 "清理 ， 这 样 可 以 恢复 更 多 的 空间 ， 但 是 花 的 时 间 更 多 并 且 在 表 上 施加 了 排 它 锁 。 
该 方法 也 需要 额外 的 磁 瘟 空间 ， 因 为 它 写 了 一 个 表 的 新 拷贝 并 且 不 释放 旧 的 拷贝 ， 直 到 操作 
完成 。 通常 这 应 该 只 用 于 当 一 个 大 量 的 空间 需要 在 这 个 表 中 回收 时 。 


FREEZE 


选择 激进 的 行 "冻结 "。 指 定 FREEZE 相当 于 执行 vacuum 时 将 vacuum freeze_min_age 参 数 设 
AS, 
VERBOSE 
为 每 个 表 打 印 一 份 详细 的 清理 工作 报告 。 
ANALYZE 
更 新 用 于 优化 器 的 统计 信息 ， 以 决定 执行 查询 的 最 有 效 方法 。 
_table_name_ 
清理 的 表 的 名 称 (可 以 有 模式 修饰 )。 缺 省 时 是 当前 数据 库 中 的 所 有 表 。 


_column_name_ 


要 分 析 的 具体 的 字段 名 称 。 缺 省 是 所 有 字段 。 若 指定 一 个 字段 列表 ， 就 暗含 ANALYZE o 


输出 


如 果 指 定 了 vERBosE ， 那 么 vacuum 将 发 出 处 理 过 程 中 的 信息 ， 以 表明 当前 正在 处 理 哪个 表 。 
各 种 有 关 这 些 表 的 统计 也 会 打印 出 来 。 


sat 
) 王 局 
清空 一 个 表 ， 一 个 人 必须 通常 是 表 的 所 有 者 或 是 一 个 超级 用 户 。 然 而 ， 数据 库 所 有 者 允许 


清空 他 们 的 数据 库 中 的 所 有 表 ， 除 了 共享 目录 。 (对 共享 目录 的 限制 意味 着 一 个 真正 的 数据 
库 范围 的 vacuum 仅 能 由 超级 用 户 执行 。) vacuum 将 跳 过 调用 用 户 没 有 权限 清空 的 任何 表 。 


VACUUM 不 能 在 事务 块 内 执行 。 


对 于 有 GIN 索 引 的 表 ， vacuum (LET) 也 完成 任何 挂 起 索引 插入 内 容 ， 通 过 移动 挂 起 
索引 条 目 到 主 GIN 索 引 结构 中 的 相应 位 置 。 参阅 Section 57.3.1 获 取 详 细 信息 。 


建议 生产 数据 库 经 常 清理 (至 少 每 晚 一 次 )， 以 保证 不 断 地 删除 死 行 。 尤 其 是 在 增删 了 大 量 记 录 
之 后 ， 对 受 影响 的 表 执 行 vacuum ANALYZE 命令 是 一 个 很 好 的 习惯 。 这 样 做 将 更 新 系统 目录 为 
最 近 的 更 改 ， 并 且 人 允许 PostgreSQL 查询 优化 器 在 规划 用 户 查 询 时 有 更 好 的 选择 。 


不 建议 日 常 使 用 FuLL 选项 ， 但 是 可 以 在 特殊 情况 下 使 用 。 一 个 例子 就 是 在 你 删除 或 更 新 了 
一 个 表 的 大 部 分 行 之 后 ， 希望 从 物理 上 缩小 该 表 以 减少 磁 胡 空间 占用 并 且 人 允许 更 快 的 表 打 
描 。 VACUUM FULL 通常 要 比 单纯 的 vacuum 收缩 更 多 的 表 尺 寸 。 


vacuum 导致 1O 流量 增加 ， 可 能 会 导致 其 它 活动 会 话 的 性 能 恶劣 。 因 此 ， 有 时 候 会 建议 使 用 
基于 开销 的 vacuum 延迟 特性 。 参阅 Section 18.4.4 获 取 细 节 。 


PostgreSQL 包 含 一 个 "autovacuum" 设 施 ， 它 可 以 自动 进行 日 常 的 vacuum 维护 。 关 于 手动 和 
自动 清理 的 更 多 细节 ， 参见 Section 23.1。 


例子 
下 面 是 一 个 在 培 变 (regression) 数 据 库 里 某 个 表 上 执行 vacuum 的 一 个 例子 


regression=# VACUUM (VERBOSE, ANALYZE) onek; 

INFO: vacuuming "public.onek" 

INFO: index "onek_uniquei" now contains 1000 tuples in 14 pages 
DETAIL: 3000 index tuples were removed. 

© index pages have been deleted, © are currently reusable. 

CPU 0.01s/0.08u sec elapsed 0.18 sec. 

INFO: index "onek_unique2" now contains 1000 tuples in 16 pages 
DETAIL: 3000 index tuples were removed. 

© index pages have been deleted, © are currently reusable. 

CPU 0.00s/0.07u sec elapsed 0.23 sec. 

INFO: index "onek_hundred" now contains 1000 tuples in 13 pages 
DETAIL: 3000 index tuples were removed. 

© index pages have been deleted, © are currently reusable. 

CPU 0.01s/0.08u sec elapsed 0.17 sec. 

INFO: index "onek_stringui" now contains 1000 tuples in 48 pages 
DETAIL: 3000 index tuples were removed. 

9 index pages have been deleted, © are currently reusable. 

CPU 0.01s/0.09u sec elapsed 0.59 sec. 

INFO: "onek": removed 3000 tuples in 108 pages 

DETAIL: CPU 0.01s/0.06u sec elapsed 0.07 sec. 

INFO: "onek": found 3000 removable, 1000 nonremovable tuples in 143 pages 
DETAIL: © dead tuples cannot be removed yet. 

There were © unused item pointers. 

© pages are entirely empty. 

CPU 0.07s/0.39u sec elapsed 1.56 sec. 

INFO: analyzing "public.onek" 

INFO: "onek": 36 pages, 1000 rows sampled, 1000 estimated total rows 
VACUUM 


FANE 


SQL 标准 里 没有 vacuum 语句 。 


义 见 


vacuumdb, Section 18.4.4, Section 23.1.6 


VALUES 


Name 


VALUES -- 计算 一 个 或 一 组 行 


Synopsis 


VALUES ( Texpression [, ...] ) | 
[ ORDER BY _sort_expression_ [ ASC | DESC | USING _operator_ ] [, ...] ] 
[ LIMIT { _count_ | ALL } ] 
[ OFFSET _start_ [ ROW | ROWS ] ] 
[ FETCH { FIRST | NEXT } [ _count_ ] { ROW | ROWS } ONLY ] 


fia ah 


VALUES 根据 给 定 的 值 表达 式 计 算 一 个 或 一 组 行 的 值 。 它 通 常用 于 在 一 个 较 大 的 命令 内 生成 一 
个 "常数 表 "， 但 是 它 也 可 以 用 于 自身 。 


如 果 指 定 了 多 行 ， 那 么 每 一 行 都 必须 拥有 相同 的 元 素 个 数 。 结果 表 字 段 的 数据 类 型 将 根据 表 
达 式 的 明确 或 隐 含 的 数据 类 型 确定 ， 使 用 的 规则 与 uNION (Section 10.5) 相 同 。 


在 大 命令 里 面 ， vALuES 人 允许 出 现在 任何 SELECT 可 以 出 现 的 地 方 。 因为 它 在 语法 上 非常 类 似 
于 SELECT ， 可 以 在 values 命令 中 使 用 oRDER By ，LIMIT (或 相等 的 FETCH FIRST ), 和 
OFFSET 子 句 。 


参数 


_expression_ 


用 于 计算 或 插入 结果 表 指 定 地 点 的 常量 或 者 表达 式 。 在 一 个 出 现在 INSERT 顶层 的 vALUES 列 
FAA, _expression ”可 以 被 DEFAULT 替换 以 表示 插入 目的 字段 的 缺 省 值 。 除 此 以 外 ， 
当 vaLues 出 现在 其 他 场合 的 时 候 是 不 能 使 用 DEFAULT 的 。 


_sort_expression_ 


一 个 表示 如 何 排序 结果 行 的 表达 式 或 者 整数 常量 。 这 个 表达 式 可 以 按照 column1 , column2 等 
等 引用 vALuEs 的 结果 列 。 更 多 细节 参见 ORDER BY 子 句 。 


_operator_ 


一 个 排序 操作 符 。 更 多 细节 参见 ORDER BY 子 句 。 


返回 的 最 大 行 数 。 更 多 细节 参见 LIMIT F. 


在 开始 返回 行 之 前 跳 过 的 行 数 。 更 多 细节 参见 LIMIT 子 句 。 


<tr 
7 

应 当 避 免 使 用 vaus 返回 数量 非常 大 的 结果 行 ， 否 则 可 能 会 遭遇 内 存 耗 尽 或 者 性 能 低下 。 
现在 INSERT 中 的 values 是 一 个 特殊 情况 ， 因为 目标 字段 类 型 可 以 从 insert 的 目标 表 获 
知 ， 并 不 需要 通过 扫描 vALuEs 列表 来 推测 ， 所 以 在 此 情况 下 可 以 处 理 非常 大 的 结果 行 。 
例子 

一 个 光秃秃 的 vALUES 命令 : 


VALUES (1, 'one'), (2, 'two'), (3, 'three'); 


这 将 返回 一 个 三 行 两 列 的 表 ， 它 在 效果 上 相当 于 : 


SELECT 1 AS columni, 'one' AS column2 
UNION ALL 

SELECT 2, 'two' 

UNION ALL 

SELECT 3, 'three'; 


wa, values 会 用 于 一 个 大 SQL 命令 中 ， 最 常见 的 是 用 于 insert 命令 : 


INSERT INTO films (code, title, did, date_prod, kind) 
VALUES ('T_601', 'Yojimbo', 106, '1961-06-16', 'Drama'); 


在 用 于 insert 时 ， VALUES 列表 中 的 项 可 以 使 用 veraur 来 表示 使 用 字段 的 缺 省 值 : 


INSERT INTO films VALUES 
('UA502', 'Bananas', 105, DEFAULT, 'Comedy', '82 minutes'), 
('T_601', 'Yojimbo', 106, DEFAULT, 'Drama', DEFAULT); 


VALUES 还 可 以 用 于 子 sELECT 可 以 应 用 的 场合 。 比如 在 一 个 FRoM FAH: 


出 


SELECT f.* 
FROM films f, (VALUES('MGM', 'Horror'), ('UA', 'Sci-Fi')) AS t (studio, kind) 
WHERE f.studio = t.studio AND f.kind = t.kind; 


UPDATE employees SET salary = salary * v.increase 


FROM (VALUES(1, 200000, 1.2), (2, 400000, 1.4)) AS v (depno, target, increase) 
WHERE employees.depno = v.depno AND employees.sales >= v.target; 


当 vatues 用 于 From 子 句 中 的 时 候 ， 必 须 使 用 As FO), 这 和 与 用 于 SELECT 时 一 样 。 并 不 要 
Kas 子 句 为 每 个 字段 都 指定 一 个 别名 ， 但 是 这 样 做 是 一 个 好 习惯 。PostgreSQL 中 vALuES 
缺 省 的 字段 名 是 column1 ，column2 等 等 ， 但 这 些 缺 省 的 名 字 并 不 一 定 与 其 他 数据 库 系统 相 
同 。 


当 VALUES 用 了 INSERT 的 时 候 ， 所 有 的 值 都 将 按照 目标 字段 自动 做 类 型 转换 。 但 是 在 其 他 场 
合 就 可 能 必须 明确 指定 恰当 的 数据 类 型 。 如 果 所 有 的 项 都 是 引号 包围 的 字面 常量 ， 强制 指定 
第 三 个 paren ened 类 型 : 


SELECT * FROM machines 
WHERE ip_address IN (VALUES('192.168.0.1'::inet), ('192.168.0.10'), ('192.168.1.43')); 


Tip: 对 于 简单 的 IN 测试 ， 更 好 的 方法 是 依赖 于 IN 的 标量 列表 形式 ， 而 不 是 使 用 上 
yk values 查询 。 标 量 列表 的 方法 写 的 更 少 ， 而 且 通 常 也 更 有 效 。 


兼容 性 


VALUES 符合 SQL 标准 ， 此 外 ， LIMIT 和 oFFsET 是 PostgreSQL 扩 展 ; 又 见 SELECT。 





义 见 


INSERT, SELECT 


ll. PostgreSQL 客户 端 应 用 程序 


部 分 包含 PostgreSQL 客 户 端 应 用 程序 和 工具 的 参考 信息 。 这 里 的 命令 并 非 全 部 是 通用 工 
， 有 些 可 能 需要 特殊 的 权限 。 这 些 应 用 的 一 般 性 特点 是 它们 可 以 在 任何 主机 上 运行， 与 数 
据 库 服务 器 所 处 的 位 置 无 关 。 


当 在 命令 行 指定 时 ， 用 户 和 数据 库 名 保留 大 小 写 ， 空 格 或 特殊 字符 可 能 需要 引起 来 。 表 名 和 
其 他 标识 符 不 保留 大 小 写 〈 除 了 那些 记录 ) 并 且 需 要 引起 来 。 


yo g 
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clusterdb 


Name 


clusterdb -- cluster a PostgreSQL database 


Synopsis 


clusterdb [ _connection-option_...][ --verbose | -v ][ --table | -t _table_ ]... 
[ _dbname_ ] 

clusterdb [ _connection-option_...][ --verbose | -v ] --all | -a 
Description 


clusterdb is a utility for reclustering tables in a PostgreSQL database. It finds tables that 
have previously been clustered, and clusters them again on the same index that was last 
used. Tables that have never been clustered are not affected. 


clusterdb is a wrapper around the SQL command CLUSTER. There is no effective difference 
between clustering databases via this utility and via other methods for accessing the server. 


Options 

clusterdb accepts the following command-line arguments: 
-a --all 

Cluster all databases. 
[-d] _dbname_ [--dbname=]~~_dbname_ 


Specifies the name of the database to be clustered. If this is not specified and -a (or 
--all ) is not used, the database name is read from the environment variable PGDATABASE . 
If that is not set, the user name specified for the connection is used. 


-e --echo 
Echo the commands that clusterdb generates and sends to the server. 


-q --quiet 


Do not display progress messages. 
-t _table --table=`>`_table_ 

Cluster _table_ only. Multiple tables can be clustered by writing multiple -t switches. 
-v --verbose 

Print detailed information during processing. 
-V --version 

Print the clusterdb version and exit. 
-2 --help 

Show help about clusterdb command line arguments, and exit. 

clusterdb also accepts the following command-line arguments for connection parameters: 
-h _host_ --host=``_host_ 


Specifies the host name of the machine on which the server is running. If the value begins 
with a slash, it is used as the directory for the Unix domain socket. 


-p _port_ --port=``_port_ 


Specifies the TCP port or local Unix domain socket file extension on which the server is 
listening for connections. 


-U _username_  --username=``_username_ 
User name to connect as. 
-Ww  --no-password 


Never issue a password prompt. If the server requires password authentication and a 
password is not available by other means such asa .pgpass file, the connection attempt 
will fail. This option can be useful in batch jobs and scripts where no user is present to enter 
a password. 


-W = --password 
Force clusterdb to prompt for a password before connecting to a database. 


This option is never essential, since clusterdb will automatically prompt for a password if the 
server demands password authentication. However, clusterdb will waste a connection 
attempt finding out that the server wants a password. In some cases it is worth typing -w to 
avoid the extra connection attempt. 


--maintenance-db= ~_dbname_ 


Specifies the name of the database to connect to discover what other databases should be 
clustered. If not specified, the postgres database will be used, and if that does not exist, 
template1 will be used. 


Environment 


PGDATABASE PGHOST PGPORT PGUSER 
Default connection parameters 


This utility, like most other PostgreSQL utilities, also uses the environment variables 
supported by libpq (see Section 31.14). 


Diagnostics 
In case of difficulty, see CLUSTER and psq| for discussions of potential problems and error 


messages. The database server must be running at the targeted host. Also, any default 
connection settings and environment variables used by the libpq front-end library will apply. 


Examples 


To cluster the database test : 


<samp class="literal">$</samp> <kbd class="literal">clusterdb test</kbd> 


To cluster a single table foo inadatabase named xyzzy : 


<samp class="literal">$</samp> <kbd class="literal">clusterdb --table foo xyzzy</kbd> 


See Also 


CLUSTER 


createdb 


Name 


createdb -- 创建 一 个 新 PostgreSQL 数据 库 


Synopsis 


createdb [ _connection-option_ ...] [ _option_ ...] [ _dbname_ [ _description_ ]] 





createdb 创建 一 个 新 PostgreSQL 数据 库 。 


通常 ， 执 行 这 个 命令 的 数据 库 用 户 将 成 为 新 数据 库 的 所 有 者 。 不 过 ， 如 果 拥 有 合适 的 权限 ， 
那么 也 可 以 通过 -0 指定 其 他 用 户 。 


createdb 是 一 个 SQL #843 CREATE DATABASE 的 封装 。 因此 ， 用 哪 种 方法 创建 的 数据 库 都 
一 样 。 


选项 


createdb 接受 下 列 命令 行 参 数 : 


_dbname_ 


要 创建 的 数据 库 名 。 该 名 称 应 该 在 本 节点 的 所 有 PostgreSQL 数据 库 中 是 唯一 的 。 缺 省 创建 
的 数据 库 名 称 是 与 当前 系统 用 户 同 名 。 


_description_ 
指定 与 新 创建 的 数据 库 相 关 的 注释 。 

-D _tablespace_``--tablespace=``_tablespace_ 

指定 数据 库 默 认 表 空间 。 (这 个 名 称 被 当 作 一 个 用 双 引 号 插 起 来 的 标识 符 处 理 。) 
-e --echo 

回 显 createdb 生成 并 发 送 到 服务 端的 命令 。 


-E  _encoding_ --encoding="~_encoding_ 


指定 在 此 数据 库 中 使 用 的 字符 编码 方案 。 PostgreSQL 服务 器 支持 的 字符 集 在 Section 22.3.1 
里 列 出 。 


-1] _ locale --locale=``_locale_ 


指定 在 此 数据 库 中 使 用 的 语言 环境 。 这 相当 于 同时 指定 --1c-collate 和 --lc-ctype 选项 。 


--lc-collate=°~_locale_ 


指定 数据 库 的 LC_COLLATE 设 置 。 


--lc-ctype=``_locale_ 
指定 数据 库 的 LC_CTYPE 设 置 。 

-0 _owner_  --oOwner="~_owner_ 

EMAAR MAE ENP. (这 个 名 称 被 当 作 一 个 用 双 引 号 括 起 来 的 标识 符 处 理 。) 

-T _template --template=``_template_ 

指定 创建 此 数据 库 的 模板 数据 库 。 (这 个 名 称 被 当 作 一 个 用 双 引 号 括 起 来 的 标识 符 处 理 。) 
-V --version 


输出 createdb 命 合 的 版 本 信息 ， 然 后 


bi 
EE 


-? --help 
显示 createdb 命 令 的 帮助 信息 ， 然 后 退出 。 


选项 -0D ，-1，-E，-0 ,和 -T 对 应 底层 的 SQL 命令 CREATE DATABASE 的 选项 ; 更 多 
信息 可 以 参考 该 命令 的 手册 页 。 


createdb 还 接受 以 下 命令 行 选项 用 于 连接 参数 : 

-h _host_ --host=、_host_ 

指定 运行 服务 器 的 主机 名 。 如 果 数 值 以 斜 杠 开 头 则 被 用 作 到 Unix 域 套 接 字 的 路 径 。 
-p _port_ --port=``_port_ 

指定 服务 器 侦 听 的 TCP 端 口 或 一 个 本 地 Unix 域 套 接 字 文 件 的 扩展 (描述 符 )。 

-U _username_ --username=``_username_ 

进行 联接 的 用 户 名 。 


-Ww  --no-password 


永远 不 提示 输入 密码 。 如 果 服 务 器 要 求 密码 验证 和 密码 通过 其 他 方式 如 .pgpass 文件 〈 验 
证 ) 不 可 用 ， 则 联接 尝试 将 失败 。 此 选项 在 不 需要 用 户 输入 密码 的 批 处 理 作 业 和 脚本 中 非常 
有 用 。 


-W --password 
强制 createdb 联 接 到 数据 库 之 前 提示 输入 密码 。 


这 个 选项 不 是 必须 的 ， 如 果 服 务 器 要 求 认证 密码 createdb 会 自动 提示 需 输入 密码 。 然而 ， 
createdb 会 浪费 一 个 联接 尝试 判断 出 该 服务 器 需要 密码 。 在 某 些 情况 下 ， 这 是 值得 键 
A -w 以 避免 多 余 的 联接 尝试 。 


--maintenance-db=``_dbname_ 


指定 要 创建 新 数据 库 时 联接 的 数据 库 名 称 。 如 果 没 有 指定 ， 将 使 用 postgres 数据 库 ; 如 果 
不 存在 (或 是 正在 创建 的 新 数据 库 的 名 称 ) ， 将 使 用 template1 数据 库 。 


环境 变量 
如 果 设置 了 ， 那 么 就 是 要 创建 的 新 数据 库 的 名 称 ， 除 非 在 命令 行 上 进行 覆盖 。 


缺 省 的 联接 参数 。 如 果 没 有 在 命令 行 上 和 PGpATABASE 中 声明 数据 库 名 称 的 话 ， P6USER 还 决 
定 了 要 创建 的 数据 库 名 称 。 


此 实用 工具 ， 像 大 多 其 他 的 PostgreSQL 实 用 工具 ， 还 使 用 libpq 支 持 的 环境 变量 ( 见 Section 
31.14) 。 


如 果 有 问题 ,将 会 显示 后 端 错 误 信 息 。 参半 CREATE DATABASE 和 psql 获 取 可 能 的 问题 和 错 
误 消 息 的 描述 。 数据 库 服 务 端 必须 运行 在 目标 主机 。 此 外 ， 前 端 库 libpq 中 的 所 有 缺 省 连接 设 
置 和 环境 变量 都 将 适用 。 


示例 
用 缺 省 数据 库 服务 器 创建 一 个 demo 数据 库 


<samp class="literal">$</samp> <kbd class="literal">createdb demo</kbd> 


A 


在 主机 eden 上 创建 demo 数据 库 ， 端 口 是 5000， 使 用 LATIN1 编码 方案 ， 并 且 回 是 执行 的 命 
TT: 


<samp class="literal">$</samp> <kbd class="literal">createdb -p 5000 -h eden -E LATIN1 -e 
<samp class="literal">CREATE DATABASE demo ENCODING 'LATIN1';</samp> 


引 





一 





另 请 参阅 


dropdb, CREATE DATABASE 


createlang 


Name 


createlang -- 安装 一 个 PostgreSQL 过 程 语 言 


Synopsis 


createlang [ _connection-option_ ...] _langname_ [ _dbname_ ] 

createlang [ _connection-option_...] --list | -1 [ _dbname_ ] 
bh 

描述 


createlang 是 一 个 用 于 向 PostgreSQL 数 据 库 中 增加 编程 语言 的 工具 。 


createlang 信 是 对 SQL 命令 CREATE EXTENSION 的 封装 。 


Caution 


createlang 是 一 个 废弃 了 的 可 能 在 未 来 PostgreSQL 版 本 中 删除 的 命令 。 建议 直接 使 
FA CREATE EXTENSION 命 兮 。 


createlang 接 受 下 列 命令 行 参数 : 


_langname_ 
指定 要 安装 的 程序 语言 的 名 称 。 (名 称 需 小 写 。) 

[-d] _dbname_``[--dbname=]``_dbname_ 

指定 向 哪个 数据 库 增 加 该 语言 。 缺 省 使 用 和 当前 系统 用 户 同名 的 数据 库 。 
-e --echo 

回 显 所 执行 的 SQL 命令 。 

wy ee 


显示 在 目标 数据 库 中 已 经 安装 的 语言 的 列表 。 


-v --version 

输出 createlang 命 令 的 版 本 信息 ， 然 后 退出 。 

-? --help 

显示 createlang 命 令 的 帮助 信息 ， 然 后 退出 。 

createlang 还 接受 以 下 命令 行 选项 用 于 联接 参数 : 

-h _host_  --host="*_host_ 

指定 运行 服务 器 的 主机 名 。 如 果 数 值 以 斜 杠 开 头 则 被 用 作 到 Unix 域 套 接 字 的 路 径 。 
-p _port_ --port="*_port_ 


指定 服务 器 侦 听 的 TCP 端 口 或 一 个 本 地 Unix 域 套 接 字 文 件 的 扩展 (描述 符 )。 


-U _username_ --uUsername= ~_username_ 
村 联接 的 用 户 名 。 
-Ww  --no-password 


永远 不 提示 输入 密码 。 如 果 服 务 器 要 求 密码 验证 和 密码 (FA) 通过 其 他 方式 如 .pgpass X 
件 (验证 ) 不 可 用 ， 则 联接 尝试 将 失败 。 此 选项 在 不 需要 用 户 输 入 密码 的 批 外 理 作业 和 脚本 
中 非常 有 用 。 


-W  --password 
强制 createlang 联 接 到 数据 库 之 前 提示 输入 密码 。 


这 个 选项 不 是 必须 的 ， 如 果 服 务 器 要 求 认证 密码 createlang 会 自动 提示 需 输 入 密码 。 然而 ， 
createlang 会 浪费 一 个 联接 党 试 判断 出 该 服务 器 需要 密码 。 在 某 些 情况 下 ， 这 是 值得 键入 -w 
以 避免 多 余 的 联接 党 试 。 


= 
环境 变量 
PGDATABASE PGHOST PGPORT PGUSER 
缺 省 的 联接 参数 


此 实用 工具 ， 像 大 多 其 他 的 PostgreSQL 实 用 工具 ， 还 使 用 libpq 支 持 的 环境 变量 ( 见 Section 
31.14)。 


大 多 数 错 误 信 息 都 是 自 解释 的 。 如 果 不 是 ， 使 用 --echo 选项 运行 createlang 然 后 查看 相应 的 
SQL 命令 的 详细 信息 。 此 外 ， 前 端 库 libpq 中 的 所 有 缺 省 连接 设置 和 环境 变量 都 将 适用 。 


注意 
使 用 droplang 删 除 一 种 语言 。 
示例 


把 pltcl 语言 安装 到 数据 库 templatel 里 : 


<samp class="literal">$</samp> <kbd class="literal">createlang pltcl template1</kbd> 


注意 ， 安 装 到 template 中 的 语言 将 自动 安装 到 随后 创建 的 其 他 数据 库 中 。 


~ 


另 请 参阅 


droplang, CREATE EXTENSION, CREATE LANGUAGE 


createuser 


Name 


createuser -- 创建 一 个 新 的 PostgreSQL 用 户 帐 户 


Synopsis 


createuser [ _connection-option_ ...] [ _option_ ...] [ _username_ ] 





createuser 创 建 一 个 新 的 PostgreSQL AP (更 准确 地 说 是 一 个 角色 ) 。 只 有 超级 用 户 和 具 
有 cREATEROLE 权限 的 用 户 可 以 创建 新 的 用 户 。 因此 createuser 必 须 由 超级 用 户 或 者 是 具有 
CREATEROLE 权限 的 用 户 执 行 。 


如 果 你 想 创建 一 个 新 的 超级 用 户 ， 你 必须 以 超级 用 户 身 份 连接 ， 而 不 仅仅 是 一 个 
有 cREATEROLE 权限 的 用 户 。 成 为 超级 用 户 就 意味 着 将 在 数据 库 里 绕 开 所 有 访问 权限 检查 ， 
此 ， 不 要 轻易 授予 超级 用 户 权 限 。 


createuser 是 对 SQL 命令 CREATE ROLE 的 封装 。 因此 ， 用 哪 种 方法 创建 的 用 户 都 一 样 。 


选项 


createuser 接 受 下 列 命令 行 参 数 : 


_username_ 


指定 要 创建 的 PostgreSQL 用 户 名 称 。 此 名 称 必须 与 本 PostgreSQL 安 装 的 所 有 现 有 角色 不 
同 。 


-c _number_**--connection-limit="~_number_ 
为 新 用 户 设置 最 大 数目 的 连接 限制 。 缺 省 为 无 限制 。 
-d  --createdb 
人 允许 该 新 用 户 创建 数据 库 。 


-D --no-createdb 


禁止 该 新 用 户 创建 数据 库 。 这 是 缺 省 (设置 ) 。 


-e  --echo 

回 显 createuser 生 成 并 发 送 到 服务 端的 命令 。 

-E  --encrypted 

加 密 存 储 在 数据 库 中 的 用 户 的 密码 。 如 果 没 有 指定 ， 使 用 缺 省 设置 。 
-i --inherit 

该 新 角色 将 自动 继承 其 所 属 角色 组 的 权限 。 这 是 缺 省 〈 设 置 ) 。 

-I --no-inherit 

该 新 角色 将 不 会 自动 继承 他 所 属 角色 组 的 权限 。 

--interactive 


若 没 有 在 命令 行 上 指定 用 户 名 ， 提 示 缺 少 用 户 名 。 并 且 -d/-p, -r/-R, -s/ -s 选项 任 
何 属性 没有 在 命令 行 指 定 ， 也 会 提示 缺少 属性 (而 不 会 使 用 缺 省 值 ) 。 (PostgreSQL 9.1 以 
前 这 是 缺 省 的 设置 。) 


-l  --login 


该 新 用 户 将 允许 登录 (也 就 是 说 ， 用 户 名 可 以 作为 初始 会 话 的 用 户 标 识 符 ) o RRS GE 
E) o 


-L  --no-login 


该 新 用 户 将 不 允许 登录 。 【〔 作 为 管理 数据 库 权 限 的 手段 ， (设置 ) 没有 登录 权限 的 角色 仍然 
是 有 必要 的 。) 


-N --unencrypted 
不 加 密 存 储 在 数据 库 中 的 用 户 的 密码 。 如 果 没有 指定 ， 使 用 缺 省 设置 
-P = --pwprompt 


如 果 给 出 〈 此 选项 ) ，createuser 将 提示 输入 新 用 户 的 密码 。 如 果 不 准备 使 用 密码 认证 方 
式 ， 那 么 没 必要 这 么 做 。 


-r --createrole 

该 新 用 户 将 允许 创建 新 角色 ( 即 ， 该 用 户 将 拥有 cREATEROLE 权限 ) 。 
-R --no-createrole 

该 新 用 户 将 不 能 创建 新 角色 。 这 是 缺 省 (设置 ) 。 

-s  --superuser 


该 新 用 户 将 是 一 个 超级 用 户 。 


-S  --no-superuser 
该 新 用 户 将 不 是 一 个 超级 用 户 。 这 是 缺 省 〈 设 置 ) 。 
-V --version 


输出 createuser 命 令 的 版 本 信息 ， 然 后 退出 。 


--replication 


该 新 用 户 将 拥有 REPLICATION 权限 〈 即 角色 能 和 启动 复制 ) ， 完整 的 描述 见 文档 CREATE 
ROLE。 


--no-replication 


该 新 用 户 将 没有 REPLICATION 权限 (〈 即 角色 不 能 启动 复制 ) ， 完整 的 描述 见 文档 CREATE 
ROLE。 


-? --help 
显示 createuser 命 令 的 帮助 信息 ， 然 后 退出 。 
createuser 还 接受 以 下 命令 行 选项 用 于 连接 参数 : 
-h _host_  --host="*_host_ 
指定 运行 服务 端的 主机 名 。 如 果 数 值 以 斜 枉 开头 则 被 用 作 到 Unix 域 套 接 字 的 路 径 。 
-p _port_ --port=、_port_ 
指定 服务 端 侦 听 的 TCP 端 口 或 一 个 本 地 Unix 域 套 接 字 文 件 的 扩展 (描述 符 )。 
-U _username --username=``_username_ 
了 联接 的 用 户 名 (不 是 要 创建 的 用 户 名 ) 。 
-mw --no-password 


永远 不 提示 输入 密码 。 如 果 服 务 器 要 求 密码 验证 和 密码 (FA) 通过 其 他 方式 如 .pgpass X 
件 (验证 ) 不 可 用 ， 则 联接 尝试 将 失败 。 此 选项 在 不 需要 用 户 输 入 密码 的 批 处 理 作 业 和 脚本 
中 非常 有 用 。 


-W --password 
强制 createuser 提 示 输 入 密码 (用 于 联接 到 服务 端 ， 而 不 是 新 用 户 的 密码 ) 。 


这 个 选项 不 是 必须 的 ， 如 果 服 务 器 要 求 认证 密码 createuser 会 自动 提示 需 输 入 密码 。 然而 ， 
createuser 会 浪费 一 个 联接 尝试 判断 出 该 服务 器 需要 密码 。 在 某 些 情况 下 ， 这 是 值得 键 
入 -w 以 避免 多 余 的 联接 尝试 。 


x > E 
环境 变量 
PGHOST PGPORT PGUSER 


缺 省 的 联接 参数 


此 实用 工具 ， 像 大 多 其 他 的 PostgreSQL 实 用 工具 ， 还 使 用 libpq 支 持 的 环境 变量 ( 见 Section 
31.14)。 


诊断 


如 果 有 问题 ， 将 会 显示 后 端 错误 信息 。 参 阅 CREATE ROLE 和 psql 获 取 可 能 的 问题 和 错误 消 
息 的 描述 。 数据 库 服 务 端 必 须 运 行 在 目标 主机 。 此 外 ， 前 端 库 libpq 中 的 所 有 缺 省 连接 设置 和 
环境 变量 都 将 适用 。 


示例 
在 缺 省 数据 库 服务 器 上 创建 一 个 joe 用 户 : 


<samp class="literal">$</samp> <kbd class="literal">createuser joe</kbd> 


To create a user joe on the default database server with prompting for some additional 
attributes: 


<samp class="literal">$</samp> <kbd class="literal">createuser --interactive joe</kbd> 

<samp class="literal">Shall the new role be a superuser? (y/n)</samp> <kbd class="literal 
<samp class="literal">Shall the new role be allowed to create databases? (y/n)</samp> <kb 
<samp class="literal">Shall the new role be allowed to create more new roles? (y/n)</samp 


六 
在 主机 eden 端口 5000 的 服务 端 里 创建 ( 跟 上 例 ) 一 样 joe 用 户 ， 明确 指定 属性 ， 请 看 下 列 


AA. 
Apa : 





<samp class="literal">$</samp> <kbd class="literal">createuser -h eden -p 5000 -S -D -R - 
<samp class="literal">CREATE ROLE joe NOSUPERUSER NOCREATEDB NOCREATEROLE INHERIT LOGIN;< 


HESS 


创建 超级 用 户 joe ， 并 立即 指定 一 个 密码 : 





<Samp class="literal">$</samp> <kbd class="literal">createuser -P -s -e joe</kbd> 

<samp class="literal">Enter password for new role:</samp> <kbd class="literal">xyzzy</kbd 
<samp class="literal">Enter it again:</samp> <kbd class="literal">xyzzy</kbd> 

<samp class="literal">CREATE ROLE joe PASSWORD 'md5b5f5ba1a423792b526f799ae4eb3d59e' SUPE 


‘ saa 








在 上 面 例 子 中 ， 虽 然 新 密码 在 输入 的 时 候 实际 上 并 不 会 回 显 出 来 ， 但 是 我 们 还 是 明确 的 把 它 
显示 出 来 了 。 正如 你 看 到 的 ， 密 码 是 加 密 后 发 送 到 客户 端 。 如 果 使 用 选项 --unencrypted 密 
码 将 会 回 显 出 来 (也 可 能 在 服务 器 日 志和 其 他 地 方 ) ， 所 以 在 其 他 人 能 看 到 你 的 屏幕 的 时 候 
不 要 使 用 -e 选项 。 


另 请 人 参阅 


dropuser, CREATE ROLE 


dropdb 


Name 


dropdb -- 删除 一 个 PostgreSQL 数据 亩 


Synopsis 


dropdb [ _connection-option_ ...] [ _option_ ...] _dbname 





摘 述 
dropdb 删除 一 个 现 有 PostgreSQL 数据 库 。 执行 此 命令 的 用 户 必 须 是 数据 库 超级 用 户 或 者 是 
数据 库 的 所 有 者 。 


dropdb 是 对 SQL##43DROP DATABASE 的 封装 。 因此 ， 用 哪 种 方法 删除 数据 库 都 一 样 。 


选项 


dropdb 接受 下 列 命令 行 参数 : 


_dbname_ 


指定 要 删除 的 数据 库 名 称 


-e``--echo 
回 显 dropdb 生 成 并 发 送 到 服务 端的 命令 。 
-i --interactive 
在 做 任何 破坏 性 动作 前 发 出 确认 提示 。 
-v --version 


输出 dropdb 命 令 的 版 本 信息 ， 然 后 退出 。 


--if-exists 
不 要 抛 出 如 果 数 据 库 不 存在 时 发 出 的 错误 。 
-?  --help 


显示 dropdb 命 邻 的 帮助 信息 ， 然 后 退出 。 


dropdb 还 接受 以 下 命令 行 选 项 用 于 连接 参数 : 

-h _host_ --host="*_host_ 

指定 运行 服务 器 的 主机 名 。 如 果 数 值 以 斜 杠 开 头 则 被 用 作 到 Unix 域 套 接 字 的 路 径 。 
-p _port_ --port=、_port_ 


指定 服务 器 侦 听 的 TCP 端 口 或 一 个 本 地 Unix 域 套 接 字 文 件 的 扩展 (描述 符 )。 


-U _username_ --username= ~_username_ 
进行 联接 的 用 户 名 。 
-Ww --no-password 


永远 不 提示 输入 密码 。 如 果 服务 器 要 求 密码 验证 和 密码 通过 其 他 方式 如 .pgpass X (G 
证 ) 不 可 用 ， 则 联接 尝试 将 失败 。 此 选项 在 不 需要 用 户 输入 密码 的 批 处 理 作 业 和 脚本 中 非常 
有 用 。 


-W --password 
强制 dropdb 联接 到 数据 库 之 前 提示 输入 密码 。 


这 个 选项 不 是 必须 的 ， 如 果 服 务 器 要 求 认证 密码 dropdb 会 自动 提示 需 输入 密码 。 然而 
dropdb 会 浪费 一 个 联接 尝试 判断 出 该 服务 器 需要 密码 。 在 某 些 情 况 下 ， 这 是 值得 键入 -w 
以 避免 多 余 的 联接 尝试 。 


--maintenance-db=— ~_dbname_ 


JEER MIRAGE EN SERB. 如 果 没 有 指定 ， 将 使 用 postgres 数据 库 ; MRA 
存在 (或 是 正在 被 删除 的 数据 库 ) ， 将 使 用 templates 数据 库 。 


xz H 

环境 变量 
PGHOST PGPORT PGUSER 

缺 省 的 联接 参数 


此 实用 工具 ， 像 大 多 其 他 的 PostgreSQL 实用 工具 ， 还 使 用 libpq 支 持 的 环境 变量 ( 见 Section 
31.14)。 


MRA i] Bi, BR DROP DATABASE 和 psq| 获取 可 能 的 问题 和 错误 消息 的 描述 。 数据 库 服 
务 器 必须 在 目标 机 器 上 运行 。 此 外 ， 前 端 库 libpq 中 的 所 有 缺 省 连接 设置 和 环境 变量 都 将 适 
用 。 


示例 
副 除 缺 省 数据 库 服务 器 上 的 deno 数据 库 : 


<Samp class="literal">$</samp> <kbd class="literal">dropdb demo</kbd> 


在 主机 eden 上 删除 demo 数据 库 ， 端 口 是 5000， 执行 命令 前 提示 并 且 回 显 执行 的 命令 : 


<Samp class="literal">$</samp> <kbd class="literal">dropdb -p 5000 -h eden -i -e demo</kb 
<samp class="literal">Database "demo" will be permanently deleted. 

Are you sure? (y/n)</samp> <kbd class="literal">y</kbd> 

<samp class="literal">DROP DATABASE demo; </samp> 


a ae 





另 请 参阅 


createdb, DROP DATABASE 


droplang 


Name 


droplang -- 删除 一 个 PostgreSQL 过 程 语言 


Synopsis 


droplang [ _connection-option_ ...] _langname_ [ _dbname_ ] 

droplang [ _connection-option_...] --list | -1 [ _dbname_ ] 
bh 

JAR 


droplang 是 一 个 从 PostgreSQL 数 据 库 中 删除 现 有 过 程 语 言 的 工具 。 
droplang *tSQL#p43 DROP EXTENSION 的 封装 。 


Caution 
droplang 是 一 个 废弃 了 的 可 能 在 未 来 PostgreSQL 版 本 中 删除 的 命 舍 。 建议 直接 使 


用 DROP EXTENSION 命令。 


droplang 接 受 下 列 命令 行 参数 : 

_langname_ 

指定 要 删除 的 程序 语言 的 名 称 。 (名 称 需 小 写 。) 

[-d] _dbname_**[--dbname=]**_dbname_ 

指定 从 哪个 数据 库 删 除 该 语言 。 缺 省 使 用 和 当前 系统 用 户 同名 的 数据 库 。 
-e --echo 

回 显 所 执行 的 SQL 命令 。 

=) [ES 


显示 在 目标 数据 库 中 已 经 安装 的 语言 的 列表 。 


-V --version 
输出 droplang 命 令 的 版 本 信息 ， 然 后 退出 。 


-?  --help 


~ 


显示 droplang 命 令 的 帮助 信息 ， 然 后 退出 。 

droplang 还 接受 以 下 命令 行 选项 用 于 联接 参数 : 

-h _host_  --host="~_host_ 

指定 运行 服务 器 的 主机 名 。 如 果 数 值 以 斜 杠 开 头 则 被 用 作 到 Unix 域 套 接 字 的 路 径 。 
-p _port_ --port="*_port_ 


指定 服务 器 侦 听 的 TCP 端 口 或 一 个 本 地 Unix 域 套 接 字 文 件 的 扩展 (描述 符 )。 


-U _username_ --uUsername= ~_username_ 
进行 联接 的 用 户 名 。 
-Ww --no-password 


永远 不 提示 输入 密码 。 如 果 服 务 器 要 求 密码 验证 和 密码 (FA) 通过 其 他 方式 如 .pgpass X 
件 (验证 ) 不 可 用 ， 则 联接 尝试 料 失 败 。 此 选项 在 不 需要 用 户 输入 密码 的 批 处 理 作业 和 脚本 
中 非常 有 用 。 


-W --password 
强制 droplang 联 接 到 数据 库 之 前 提示 输入 密码 。 


这 个 选项 不 是 必须 的 ， 如 果 服 务 器 要 求 认证 密码 droplang 会 自动 提示 需 输 入 密码 。 然而 
droplang 会 浪费 一 个 联接 尝试 判断 出 该 服务 器 需要 密码 。 在 某 些 情况 下 ， 这 是 值得 键 
入 -w 以 避免 多 余 的 联接 尝试 。 


Ir LER 
环境 变量 
PGDATABASE PGHOST PGPORT PGUSER 
缺 省 的 联接 参数 


此 实用 工具 ， 像 大 多 其 他 的 PostgreSQL 实 用 工具 ， 还 使 用 libpq 支 持 的 环境 变量 ( 见 Section 
31.14) 。 


大 多 数 错 误 信 息 都 是 自 解释 的 。 如 果 不 是 ， 使 用 - -echo 选项 运行 droplang 然 后 查看 相应 的 
SQL 命令 的 详细 信息 。 此 外 ， 前 端 库 libpq 中 的 所 有 缺 省 联接 设置 和 环境 变量 都 将 适用 。 


3 
ya 
使 用 createlang 添 加 一 种 语言 。 
示例 


删除 pltcl 语言 : 


<samp class="literal">$</samp> <kbd class="literal">droplang pltcl dbname</kbd> 


另 请 参阅 


createlang, DROP EXTENSION, DROP LANGUAGE 


dropuser 


Name 


dropuser -- 删除 一 个 PostgreSQL 用 户 账户 


Synopsis 


dropuser [ _connection-option_ ...] [ _option_ ...] [ _username_ ] 





fea aah 
dropuser#i/BR2L4 PostgreSQL 用 户 。 只 有 超级 用 户 和 拥有 cREATEROLE 权限 的 用 户 可 以 删除 
PostgreSQL 用 户 。 (要 删除 一 个 超级 用 户 ， 你 必须 首先 是 超级 用 户 。) 


dropuser 是 对 SQL#P4SDROP ROLE 的 封装 。 因此 ， 用 哪 种 方法 删除 用 户 都 一 样 。 


选项 


dropuser 接 受 下 列 命令 行 参 数 : 


_username_ 


指定 要 删除 的 PostgreSQL 用 户 名 称 。 如 果 没 有 在 命令 行 上 指定 用 户 名 称 和 指定 了 
-i / --interactive 选项 ， 将 会 提示 输入 一 个 名 称 。 


-e``--echo 
回 显 dropuser 生 成 并 发 送 到 服务 端的 命 命 。 

-i --interactive 

真正 删除 用 户 之 前 提示 确认 ， 并 且 如 果 没 有 在 命令 行 指 定名 称 将 提示 输入 用 户 名 。 
-v --version 


输出 dropuser 命 令 的 版 本 信息 ， 然 后 退出 。 


--if-exists 
不 要 抛 出 如 果 用 户 不 存在 时 发 出 的 错误 。 


-?  --help 


显示 dropuser 命 令 的 帮助 信息 ， 然 后 退出 。 

dropuser 还 接受 以 下 命令 行 选项 用 于 连接 参数 : 

-h _host_ --host="*_host_ 

指定 运行 服务 器 的 主机 名 。 如 果 数 值 以 斜 杠 开 头 则 被 用 作 到 Unix 域 套 接 字 的 路 径 。 
-p _port_ --port=``_port_ 

指定 服务 器 侦 听 的 TCP 端 口 或 一 个 本 地 Unix 域 套 接 字 文 件 的 扩展 (描述 符 )。 

-U _username_ --username=``_username_ 

进行 联接 的 用 户 名 (不 是 要 删除 的 用 户 名 ) 。 

-w --no-password 


永远 不 提示 输入 密码 。 如 果 服 务 器 要 求 密码 验证 和 密码 ( 且 ) 通过 其 他 方式 如 .pgpass 文件 
(验证 ) 不 可 用 ， 则 联接 尝试 将 失败 。 此 选项 在 不 需要 用 户 输入 密码 的 批 你 理 作 业 和 脚本 中 
非常 有 用 。 


-W  --password 
强制 dropuser 联 接 到 数据 库 之 前 提示 输入 密码 。 


这 个 选项 不 是 必须 的 ， 如 果 服 务 器 要 求 认 证 密码 dropuser 会 自动 提示 需 输 入 密码 。 然而 
dropuser 会 浪费 一 个 联接 尝试 判断 出 该 服务 器 需要 密码 。 在 某 些 情况 下 ， 这 是 值得 键 
A -w 以 避免 多 余 的 联接 尝试 。 


x > E 
环境 变量 
PGHOST PGPORT PGUSER 


缺 省 的 联接 参数 


此 实用 工具 ， 像 大 多 其 他 的 PostgreSQL 实 用 工具 ， 还 使 用 libpq 支 持 的 环境 变量 ( 见 Section 
31.14)。 


如 果 有 问题 ， 参 阅 DROP ROLE 和 psql 获 取 可 能 的 问题 和 错误 消息 的 描述 。 数据 库 服务 器 必 
须 在 目标 机 器 上 运行 。 此 外 ， 前 端 库 libpq 中 的 所 有 缺 省 连接 设置 和 环境 变量 都 将 适用 。 


示例 


删除 缺 省 数据 库 服务 器 上 的 joe AP: 


<samp class="literal">$</samp> <kbd class="literal">dropuser joe</kbd> 


在 主机 eden 上 删除 joe 用 户 ， 端 口 5000， 执行 命令 前 提示 并 且 回 显 执行 的 命令 : 


<Samp class="literal">$</samp> <kbd class="literal">dropuser -p 5000 -h eden -i -e joe</k 
<samp class="literal">Role "joe" will be permanently removed. 

Are you sure? (y/n)</samp> <kbd class="literal">y</kbd> 

<samp class="literal">DROP ROLE joe;</samp> 


«| — 











另 请 参阅 


createuser, DROP ROLE 


ecpg 


Name 


ecpg -- BABY SQL C 预 处 理 器 


Synopsis 


ecpg [ _option_...] _file_... 





ecpg 是 一 个 嵌入 的 用 于 C 语言 的 SQL 预 编译 器 。 CHERRA SQL 语句 的 C 程序 通过 将 SQL 
调用 替换 成 特殊 的 男 数 调 用 的 方法 转换 成 普通 的 C 代码 。 然后 输出 的 文件 就 可 以 用 任何 C 编 
译 工 具 进 行 处 理 。 


ecpg 将 把 命令 行 上 给 出 的 每 个 输入 文件 转换 成 对 应 的 C 输出 文件 。 输入 文件 最 好 

有 .pgc 扩展 名 ， 这 样 ， 这 个 扩展 将 被 替换 成 .c 来 决定 输出 文件 名 。 如 果 输 入 文件 的 扩展 不 
是 .pgc ， 那么 输出 文件 名 将 通过 在 全 文件 名 后 面 附加 .c 来 生成 。 输出 文件 名 也 可 以 

用 -o 选项 履 盖 。 


本 手册 页 并 不 描述 能 入 的 SQL 语句 ， 参 阅 Chapter 33 获 更 多 信息 。 


ecpg 接受 下 面 命令 行 参数 : 

-c 

为 SQL 代码 自动 生成 某 种 C 代码 。 目 前 ， 这 个 选项 可 以 用 于 EXEC SQL TYPE o 
-C _mode_ 

设置 一 个 兼容 模式 。 _mode_ 可 以 是 INFORMIX 或 INFORMIX_SE 之 一 。 

-D _symbol_ 

定义 一 个 C 预 处 理 器 符号 。 


同时 也 分 析 系 统 包含 文件 。 


-I _directory_ 


声明 一 个 附加 的 包含 路 径 。 用 于 寻找 通过 exec so INCLUDE 包含 的 文件 。 RAB: . (当前 
目录 )、 /usr/local/include 、 在 编译 时 定义 的 PostgreSQL 包 含 路 径 ( 缺 省 为 : 
/usr/local/pgsql/include )、 /usr/include o 顺序 同上 。 


-o _filename_ 

指定 ecpg 应 该 把 它 的 所 有 输出 写 到 给 出 的 filename E, 

-r _option_ 

选择 一 个 运行 时 行为 。 _option 可 以 是 下 列 的 : 

no_indicator 

不 使 用 指示 器 ， 但 是 使 用 特殊 的 值 来 表示 空 值 。 历 史上 有 过 数据 库 使 用 这 种 方法 。 
prepare 


使 用 它们 之 前 预备 所 有 语句 。Libecpg 将 保存 一 个 预备 语句 的 缓冲 ， 并 且 如 果 再 次 执行 就 重复 
使 用 一 个 语句 。 如 果 缓 存 运行 满 了 ，Libecpg 将 释放 最 近 使 用 的 语句 。 


questionmarks 
允许 问号 标识 为 了 兼容 原因 作为 占 位 符 。 很 久 以 前 这 是 缺 省 。 
-t 


打开 自动 提交 模式 。 在 这 种 模式 下 ， 每 个 查询 都 自动 提交 ， 除 非 它 是 包围 在 一 个 明确 的 事务 
块 中 。 在 缺 省 模式 下 ， 命 邻 只 是 在 发 出 ExEc sor commit 的 时 候 提交 。 


打印 额外 的 信息 ， 包 括 版 本 和 "include" 路 径 。 


--version 


打印 ecpg 版 本 然后 退出 。 


-?>>--help 


显示 关于 ecpg 命 令 行 参数 的 帮助 ， 然 后 退出 。 

sl = 

as 

在 编译 预 处 理 的 C 代码 文件 的 时 候 ， 编 译 器 需要 能 够 找到 PostgreSQL 包含 目录 里 面 的 ECPG 


头 文件 。 因 此 ， 在 调用 编译 器 的 时 候 可 能 需要 使 用 -I 选项 ( 比 


如 -I/usr/local/pgsql/include Jo 


(SFA YT BRA SQL 的 C 代码 必须 和 1ibecpg 库 链 接 ， 比 如 ， 使 用 这 样 的 链接 选 
项 : -L/usr/local/pgsql/lib -lecpg o 


这 些 目录 的 实际 值 可 以 通过 pg_config 找 到 。 


例子 


如 果 你 有 一 个 叫 progi.pge JERA SQL 的 C 源 代 码 ， 你 可 以 用 下 面 的 命令 序列 创建 一 个 可 
执行 程序 : 


ecpg prog1.pgc 
cc -I/usr/local/pgsql/include -c progi.c 
cc -0 prog1 progi.o -L/usr/local/pgsql/lib -lecpg 


pg_basebackup 


Name 


pg_basebackup -- 做 一 个 PostgreSQL 集群 的 基础 各 份 


Synopsis 


pg_basebackup [ _#_ ...] 


摘 述 


pg_basebackup 用 来 给 一 个 运行 的 PostgreSQL 数据 库 集 群 进行 基础 备份 。 进 行 时 不 会 影响 到 
连接 到 数据 库 的 客户 端 ， 并 且 同 时 可 以 用 于 时 间 点 恢复 (参阅 Section 24.3) 和 日 志 传输 或 流 
复制 各 用 服务 器 的 起 始点 (参阅 Section 25.2) 。 


pg_basebackup 做 一 个 数据 库 集 群 文件 的 二 进 制 拷贝 ， 同 时 确保 系统 自动 进出 自动 各 份 模 
式 。 备 份 总 是 使 用 整个 的 数据 库 集群 ， 不 可 能 只 各 份 单个 的 数据 库 或 数据 库 对 象 。 对 于 单个 
数据 库 各 份 ， 必 须 使 用 如 pg_dump 的 工具 。 


备份 时 通过 一 个 普通 的 PostgreSQL 连 接 制 作 的 ， 并 且 使 用 复制 协议 。 该 连接 必须 由 超级 用 户 
或 一 个 拥有 REPLICATION 权限 的 用 户 完成 (参阅 Section 20.2) ， 并 且 pg_hba.cont 必须 明确 
允许 复制 连接 。 该 服务 器 也 必须 由 max_ wal _senders 配 置 ， 设置 足够 高 的 级 别 ， 对 于 各 份 至 
少 有 一 个 会 话 可 用 。 


在 同一 时 刻 可 能 有 多 个 pg_basebackup 运行 ， 但 是 从 性 能 来 说 最 好 只 采取 一 个 各 份 ， 然 后 复制 
结果 。 


pg_basebackup 不 止 可 以 从 主机 各 份 还 可 以 从 各 机 备份 。 要 从 备 机 各 份 ， 设置 各 机 以 使 其 可 
以 接受 复制 连接 (也 就 是 ， 设 置 max_wal_senders 和 hot standby， 并 且 配 置 host-based 
authentication) 。 也 需要 在 主机 上 和 启用 full_page_writes。 


请 注意 ， 这 里 有 几 个 从 备 机 在 线 备份 的 限制 : 
。 各 份 历 史 文件 不 是 在 数据 库 集群 备份 时 创建 的 。 


。 不 保证 所 有 需要 备份 的 WAL 文 件 在 备份 的 最 后 归档 。 如 果 你 计划 使 用 备份 作为 为 档 恢 
复 ， 并 希望 保证 此 刻 所 有 需要 的 文件 都 可 以 使 用 ， 你 需要 通过 使 用 -x 选项 将 他 们 包含 
到 备份 中 。 


。 如 果 备 机 在 在 线 备份 期 间 被 提升 为 主机 ， 则 备份 失败 。 


。 所 有 需要 各 份 的 WAL 记 录 必 须 包 含 足 够 的 全 版 书 守 ， 这 需要 你 在 主机 上 局 
用 full_page writes 并 且 不 使 用 类 似 pg_compresslog 这 样 的 工具 作为 archive_command 
从 WAL 文 件 中 删除 全 版 书写 。 


选项 


下 列 的 命令 行 选项 控制 输出 的 位 置 和 格式 。 
-D _directory_~°--pgdata="~_directory_ 


宇和 输出 的 目录 。pg_basebackup 将 创建 目录 和 任何 父 目 录 (如 果 需 要 ) 。 该 目录 可 能 已 经 存 
在 ， 但 是 如 果 该 目录 已 经 存在 并 且 不 为 空 则 是 一 个 错误 。 


当 备份 在 tar 模 式 ， 并 且 目录 以 - RIS) 声明 ， 那 么 tar 文 件 将 写 人 stdout o 


这 个 选项 是 必需 的 。 


仅 


-F _format_  --format=°~_format_ 
选择 输出 格式 。 _format_ 可 以 是 下 列 之 一 : 
p plain 


将 输出 写作 普通 的 文件 ， 该 文件 与 当前 数据 目录 和 表 空 间 有 相同 的 布局 。 当 集群 没有 额外 的 
表 空 间 时 ， 整个 数据 库 将 被 放 入 目标 目录 中 。 如 果 集群 包含 额外 的 表 空 间 ， 那 么 主 数据 目录 
将 被 放 入 目标 目录 中 ， 但 是 所 有 其 他 表 空 间 将 被 放 入 与 它们 在 服务 器 上 相同 的 绝对 路 径 中 。 


这 是 缺 省 的 格式 。 
t tar 


将 输出 写作 目标 目录 中 的 tar 文 件 。 主 数据 目录 将 被 写成 一 个 命名 为 base.tar 的 文件 ， 所 有 其 
他 表 空间 将 以 表 空 间 OID 命 名 。 


如 果 值 - (GRITS) 被 声明 为 目标 目录 ， 那 么 tar 内 容 将 被 写成 标准 输出 ， 适合 于 管道 如 
gzip。 只 有 集群 没有 额外 的 表 空 间 时 这 才 是 可 能 的 。 


-R --write-recovery-conf 


在 输出 目录 (或 使 用 tar 格 式 时 为 基础 当 档 文件 ) 中 写 一 个 最 小 的 recovery.conf 以 减轻 设置 
一 个 各 用 服务 器 。 


-Xx --xlog 
使 用 这 个 选项 等 同 于 使 用 方法 fetch 的 -x 。 


-X _method_ = --xlog-method=* ~_method_ 


在 各 份 中 包含 所 需 的 事务 日 志文 件 《WAL 文 件 ) 。 这 将 包括 所 有 在 各 份 期 mn 
志 。 如 果 声 明了 这 个 选项 ， 那 么 直接 在 提取 出 的 目录 (不 需要 参考 日 志 为 档 ) 中 启动 一 
进程 是 可 能 的 。 因此 使 其 成 为 一 个 完全 独立 的 备份 。 


支持 下 列 收集 事务 日 志 的 方法 : 
f fetch 


事务 日 志文 件 在 各 份 结束 时 收集 。 因 此 ，wal keep segment 参数 有 必要 设置 的 足够 高 ， 使 
日 志 在 各 份 结束 之 前 不 会 被 删除 。 如 果 日 志 在 要 被 转移 的 时 候 已 经 转动 了 ， 那么 备份 将 失败 
并 且 不 能 使 用 。 


S Stream 


当 备份 创建 时 流 事务 日 志 。 这 将 在 运行 各 份 时 打开 又 一 个 到 服务 器 的 连接 并 并 行 启动 流 事务 
日 志 。 因此 ， 它 将 使 用 两 个 max wal senders 参 数 配 置 的 插 横 。 只 要 客户 端 可 以 跟 上 接收 到 
的 事务 日 志 ， 使 用 这 个 方法 需要 没有 额外 的 事务 日 志 在 主机 上 保存 。 


-Z --gzip 
启用 tar 文 件 输出 的 gzip 压 缩 ， 使 用 缺 省 的 压缩 级 别 。 只 有 使 用 tar 模 式 的 时 候 可 用 压缩 。 
-Z _level --compress=``_level_ 


启用 tar 文 件 输 出 的 gzip 压 缩 ， 并 声明 压缩 级 别 (1 到 9，9 为 顶级 压缩 ) 。 只 有 使 用 tar 模 式 的 时 
候 可 用 压缩 。 


下 列 的 命 命 行 选项 控制 备份 的 生成 和 程序 的 运行 。 


-c _fast|spread_ --checkpoint=°~_fast|spread_ 
置 检查 点 模式 为 fast 或 spread (HRA) 。 
-l _label --label="~_label_ 


为 备份 设置 标签 。 如 果 没 有 声明 ， 将 使 用 " pg_basebackup 基础 各 份 "的 默认 值 。 
-P --progress 


启用 进展 报告 。 启用 这 个 选项 将 会 在 备份 期 间 发 送 一 个 大 概 的 进展 报告 。 因 为 数据 库 可 能 会 
在 备份 期 间 改 变 ， 所 以 这 只 是 一 个 大 概 并 且 可 能 不 正好 是 100% 结束 。 特 别 是 ， 当 在 备份 中 
包含 WAL 日 志 时 ， 数 据 的 总 量 不 能 提前 估计 ， 并 且 这 种 情况 下 一 旦 它 传 递 的 总 估计 不 包含 
WAL， 那么 估计 的 目标 大 小 还 会 增加 。 


当 启 用 这 个 选项 时 ， ee A 然后 返回 并 发 送 实际 的 内 容 。 这 
样 可 能 会 导致 各 份 时 间 稍 长 一 些 ， 尤 其 是 在 发 送 第 一 个 数据 之 前 的 时 间 稍 长 。 


-Vv  --verbose 


启用 元 长 模式 。 将 在 启动 和 关闭 时 输出 一 些 额外 的 步骤 ， 如 果 也 启用 了 进度 报告 ， 则 也 显示 
当前 正在 被 义理 的 准确 的 文件 名 。 


下 列 的 命令 行 选项 控制 数据 库 连 接 参数 。 
-d _connstr_  --dbname= connstr_ 
声明 用 来 连接 到 服务 器 的 参数 ， 作 为 一 个 连接 字符 串 。 参 阅 Section 31.1.1 获 取 更 多 信息 。 


该 选项 被 称 为 --dbname 是 为 了 与 其 他 客户 端 应 用 的 一 致 性 ， 但 是 因为 pg_basebackup 不 连接 
到 集群 中 的 任何 特别 的 数据 库 ， 所 以 将 忽略 连接 字符 串 中 的 数据 库 名 字 。 


-h _host_ --host=` host 


声明 服务 器 正在 运行 的 机 器 的 主机 名 。 如 果 这 个 值 以 一 个 斜 线 开始 ， 则 被 用 作 Unix 域 套 接 字 
的 目录 。 默认 从 peost 环境 变量 中 获取 (如果 设置 了 ) ， 否 则 尝试 一 个 Unix 域 套 接 字 连 接 。 


-p _port_  --port=*~_port_ 


声明 服务 器 正在 监听 的 TCP 端 口 或 本 地 Unix 域 套 接 字 文 件 扩展 。 缺 省 是 PsPoRT 环境 变量 (如 
果 设 置 了 ) ， 否 则 是 内 编译 的 缺 省 。 


-s _interval  --status-interval=``_interval_ 


声明 状态 数据 包 发 送 回 服务 器 的 秒 数 。 这 人 允许 对 服务 器 进程 的 更 简单 的 监视 。 为 了 避免 连接 
超时 ， 替 值 完全 禁用 定期 状态 更 新 ， 尽 管 服务 器 需要 时 仍然 发 送 一 个 更 新 。 缺 省 值 是 10 秒 。 


-U _username_ --username=``_username_ 
连接 的 用 户 名 。 
-Ww  --no-password 


从 不 发 出 密码 提示 问题 。 如 果 服 务 器 要 求 密 码 认 证 并 且 密 码 不 可 用 于 其 他 意思 如 .pgpass 文 
件 ， 则 连接 党 试 将 会 失败 。 该 选项 在 批量 工作 和 不 存在 用 户 输 入 密码 的 脚本 中 很 有 帮助 。 


-W  --password 
强制 pg_basebackup 在 连接 到 数据 库 之 前 提示 一 个 密码 。 


这 个 选项 从 来 不 是 至 关 重 要 的 ， 因 为 如 果 服 务 器 需求 密码 认证 ， 则 pg_basebackup 自动 提示 
一 个 密码 。 不 过 ，pg_basebackup 将 在 找 出 服务 器 想 要 一 个 密码 上 浪费 一 个 连接 尝试 。 在 某 
些 情况 下 ， 值 得 输入 -w 以 避免 额外 的 连接 尝试 。 


其 他 选项 也 可 用 : 
-V --version 


打印 pg_basebackup 版 本 然后 退出 。 


-?  --help 


显示 关于 pg_basebackup 命 令 行 参数 的 帮助 然后 退出 。 


环境 变量 


这 个 工具 ， 类 似 大 多 数 其 他 PostgreSQL 实 用 工具 ， 也 使 用 由 libpq 支 持 的 环境 变量 ( 参 
J Section 31.14) 。 


注意 
备份 将 包含 数据 目录 和 表 空 间 中 的 所 有 文件 ， 包 括 配 置 文 件 和 任何 第 三 方 放置 在 目录 中 的 额 
外 文件 。 数据 目录 中 只 人 允许 普通 的 文件 和 目录 ， 不 允许 符号 链接 或 特殊 设备 文件 。 


当 恢 复 一 个 备份 时 ，PostgreSQL 管 理 表 空间 的 方式 ， 所 有 额外 表 空 间 的 路 径 必 须 完全 相同 。 
不 过 ， 主 数据 目录 可 以 重新 定位 任意 位 置 。 


pg_basebackup 可 以 作用 于 相同 版 本 或 更 老 版 本 的 服务 器 (最 低 9.1) ， 不 过 ，WAL 流 模式 
(-X 流 ) 只 能 是 服务 器 版 本 9.3。 

例子 

在 mydbserver 创建 一 个 服务 器 的 基础 各 份 ， 并 存储 到 本 地 目录 /usr/local/pgsql/data 中 : 


<samp class="literal">$</samp> <kbd class="literal">pg_basebackup -h mydbserver -D /usr/l 
小 


创建 一 个 本 地 服务 器 的 各 份 ， 用 一 个 为 每 个 表 空 间 压 缩 的 tar 文 件 ， 并 存储 到 目录 backup E, 
运行 时 显示 进度 报告 : 





<samp class="literal">$</samp> <kbd class="literal">pg_basebackup -D backup -Ft -z -P</kb 
OSS SS SSS aa 
创建 一 个 单 表 空间 本 地 数据 库 的 各 份 并 使 用 bzip2 压 缩 : 





<samp class="literal">$</samp> <kbd class="literal">pg_basebackup -D - -Ft | bzip2 > back 


如 果 数 据 库 中 有 多 个 表 空 间 那么 这 个 命令 将 会 失败 。 





义 见 
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pg_config 


Name 


pg_config -- retrieve information about the installed version of PostgreSQL 


Synopsis 


pg_config [ _option_ ...] 


Description 


The pg_config utility prints configuration parameters of the currently installed version of 
PostgreSQL. It is intended, for example, to be used by software packages that want to 
interface to PostgreSQL to facilitate finding the required header files and libraries. 


Options 


To use pg_config, supply one or more of the following options: 


--bindir 


Print the location of user executables. Use this, for example, to find the psql program. This 
is normally also the location where the pg_config program resides. 


--docdir 


Print the location of documentation files. 


--htmldir 


Print the location of HTML documentation files. 


--includedir 
Print the location of C header files of the client interfaces. 
--pkgincludedir 


Print the location of other C header files. 


--includedir-server 


Print the location of C header files for server programming. 


--libdir 
Print the location of object code libraries. 
--pkglibdir 


Print the location of dynamically loadable modules, or where the server would search for 
them. (Other architecture-dependent data files might also be installed in this directory.) 


--localedir 


Print the location of locale support files. (This will be an empty string if locale support was 
not configured when PostgreSQL was built.) 


--mandir 
Print the location of manual pages 
--sharedir 
Print the location of architecture-independent support files 
--sysconfdir 
Print the location of system-wide configuration files. 
--pgxs 
Print the location of extension makefiles. 
--configure 


Print the options that were given to the configure script when PostgreSQL was configured 
for building. This can be used to reproduce the identical configuration, or to find out with 
what options a binary package was built. (Note however that binary packages often contain 
vendor-specific custom patches.) See also the examples below. 


--CCc 


Print the value of the cc variable that was used for building PostgreSQL. This shows the C 
compiler used. 

--cppflags 
Print the value of the cpprLacs variable that was used for building PostgreSQL. This shows 
C compiler switches needed at preprocessing time (typically, -1 switches). 

--cflags 
Print the value of the cFLacs variable that was used for building PostgreSQL. This shows C 
compiler switches. 


--cflags_sl 


Print the value of the cFLAcs_st variable that was used for building PostgreSQL. This 
shows extra C compiler switches used for building shared libraries. 


--ldflags 
Print the value of the LDFLAGS variable that was used for building PostgreSQL. This shows 
linker switches. 

--ldflags_ex 
Print the value of the LDFLAGS_EX variable that was used for building PostgreSQL. This 
shows linker switches used for building executables only. 

--ldflags_sl 
Print the value of the LDFLAGS_SL variable that was used for building PostgreSQL. This 
shows linker switches used for building shared libraries only. 

--libs 
Print the value of the Liss variable that was used for building PostgreSQL. This normally 
contains -1 switches for external libraries linked into PostgreSQL. 


--version 


Print the version of PostgreSQL. 


-?>>--help 
Show help about pg_config command line arguments, and exit. 


If more than one option is given, the information is printed in that order, one item per line. If 
no options are given, all available information is printed, with labels. 


Notes 


The option --includedir-server was added in PostgreSQL 7.2. In prior releases, the server 
include files were installed in the same location as the client headers, which could be 
queried with the option --includedir . To make your package handle both cases, try the 
newer option first and test the exit status to see whether it succeeded. 


The options --docdir , --pkgincludedir , --localedir , --mandir , --sharedir 

--sysconfdir , --cc , --cppflags , --cflags , --cflags_sl , --ldflags , --ldflags_sl 
and --libs were added in PostgreSQL 8.1. The option --htmldir was added in 
PostgreSQL 8.4. The option --1dflags_ex was added in PostgreSQL 9.0. 


In releases prior to PostgreSQL 7.1, before pg_config came to be, a method for finding the 
equivalent configuration information did not exist. 


Example 


To reproduce the build configuration of the current PostgreSQL installation, run the following 


command: 


eval ./configure ~pg_config --configure- 


The output of pg_config --configure contains shell quotation marks so arguments with 
spaces are represented correctly. Therefore, using eval is required for proper results. 


pg_dump 


Name 


pg_dump -- 将 一 个 PostgreSQL 数 据 库 转 储 到 一 个 脚本 文件 或 者 其 它 为 档 文 件 中 


Synopsis 


pg_dump [ _connection-option_ ...] [ _option_ ...] [ _dbname_ ] 





fi aah 


pg_dump 是 一 个 用 于 备份 PostgreSQL 数据 库 的 工具 。 它 其 至 可 以 在 数据 库 正 在 使 用 的 时 候 进 
行 完整 一 致 的 各 份 。 pg_dump 并 不 阻塞 其 它 用 户 对 数据 库 的 访问 ( 读 或 者 写 )。 


转 储 格式 可 以 是 一 个 脚本 或 者 轨 档 文件 。 脚 本 转 储 的 格式 是 纯 文本 ， 它 包含 许多 SQL 命令 ， 
这 些 SQL 命令 可 以 用 于 重建 该 数据 库 并 将 之 恢复 到 保存 成 脚本 的 时 候 的 状态 。 使 用 psql 从 这 
样 的 脚本 中 恢复 。 它们 其 至 可 以 用 于 在 其 它 机 器 其 至 是 其 它 硬 件 体系 的 机 器 上 重建 该 数据 
F, 通过 对 脚本 进行 一 些 修改 ， 其 至 可 以 在 其 它 SQL 数据 库 产 品 上 重建 该 数据 库 。 


轨 档 文件 格式 必须 和 pg_restore 一 起 使 用 重建 数据 库 。 它们 人 允许 pg_restore 对 恢复 什么 东西 进 
行 选择 ， 或 者 苏 至 是 在 恢复 之 前 对 需要 恢复 的 条 目 进 行 重新 排序 。 为 档 文 件 也 是 设计 成 可 以 
跨 平台 移植 的 。 


如 果 一 种 候选 文件 格式 和 pg_restore 结 合 ， 那么 pg_dump 就 能 提供 一 种 灵活 的 为 档 和 传输 机 
制 。 pg_dump 可 以 用 于 备份 整个 数据 库 ， 然 后 就 可 以 使 用 pg_restore 检 查 这 个 归档 和 /或 选择 
要 恢复 的 数据 库 部 分 。 最 灵活 的 输出 文件 格式 是 "custom"( 自 定义 ) 格 式 ( -Fc ) 和 

"directory" (目录 ) 格式 ( -Fd )。 它们 允许 对 为 档 元 素 进 行 选取 和 重新 排列 ， 支 持 并 行 恢复 并 
且 缺 省 时 是 压缩 的 。 "directory" 格 式 是 唯一 支持 并 行 转 储 的 格式 。 

在 运行 pg_dump 的 时 候 ， 应 该 检查 输出 ， 看 看 是 否 有 任何 警告 存在 (在 标准 错误 上 打印 )， 特 
别 是 下 面 列 出 的 限制 。 


选项 


下 面 的 命 命 行 参数 控制 输出 的 内 容 和 格式 。 


_dbname_ 


将 要 转 储 的 数据 库 名 。 如 果 没有 声明 这 个 参数 ， 那 么 使 用 环境 变量 PepATABASE o 如 果 那 个 环 
境 变量 也 没 声明 ， 那 么 使 用 发 起 连接 的 用 户 名 。 


-a``--data-only 

只 输出 数据 ， 不 输出 模式 (数据 定义 )。 转 储 表 数 据 、 大 对 象 和 序列 值 。 

这 个 选项 类 似 于 声明 --section=data ， 但 是 只 是 因为 历史 原因 存在 并 不 完全 相同 。 
-b --blobs 


在 转 储 中 包含 大 对 象 。 除 非 指定 了 --schema ，--table ，--schema-only 开关 ， 否 则 这 是 默认 
行为 。 因 此 -o 开关 仅 用 于 在 选择 性 转 储 的 时 候 添 加 大 对 象 。 


-C --clean 


输出 命令 在 输出 创建 数据 库 命 令 之 前 先 清理 (drop) 该 数据 库 对 象 。 《如 果 任 何 对 象 在 目标 数 
据 库 中 不 存在 ， 则 转 储 可 能 生成 一 些 无 害 的 错误 信息 。) 


这 个 选项 只 是 对 纯 文本 格式 有 意义 。 对 于 为 档 格 式 ， 可 以 在 调用 pg_restore 的 时 候 声 明 该 选 
项 。 


-C --create 


以 一 条 创建 该 数据 库 本 身 并 且 和 与 这 个 数据 库 连 接 命令 开头 进行 输出 。 如 果 是 这 种 形式 的 脚 
本 ， 那么 你 在 运行 脚本 之 前 和 目的 安装 中 的 哪个 数据 库 连 接 就 不 重要 了 。 如 果 也 声明 了 
--clean ， 那 么 脚本 在 重新 连接 到 数据 库 之 前 删除 并 重新 创建 目标 数据 库 。 

这 个 选项 只 对 纯 文 本 格式 有 意义 。 对 于 慷 档 格式 ， 可 以 在 调用 pg_restore 的 时 候 声明 该 选 
项 。 


-E  _encoding_  --encoding=``_encoding_ 


以 指定 的 字符 集 编 码 创 建 转 储 。 缺 省 时 ， 转 储 是 按照 数据 库 编码 创建 的 。 另外 一 个 获取 同样 
结果 的 方法 是 将 pecLIENTENCODING 环境 变量 设置 为 期 望 的 转 储 编码 。 


=H | pales. Booties) spades 


把 输出 发 往 指 定 的 文件 。 文 件 基础 输出 格式 时 可 以 省 略 这 个 参数 ， 这 种 情况 下 使 用 标准 输 
出 。 但 是 ， 在 声明 目标 目录 而 不 是 文件 时 必须 给 出 目录 输出 格式 。 在 这 种 情况 下 ， 目录 通 
过 pg_dump 创建 并 且 必 须 之 前 不 存在 。 


-F _format_  --format=°~_format_ 
选择 输出 的 格式 。 _format_ 可 以 是 下 列 之 一 
p plain 


纯 文 本 SQL 脚本 文件 ( 缺 省 )。 


C custom 


适合 输入 到 pg_restore 里 的 自 定义 格式 为 档 。 加 上 目录 输出 格式 ， 这 是 最 灵活 的 格式 ， 它 人 允 
许 在 转 储 期 间 对 已 归档 的 条 目 进 行 手 动 选择 和 重新 排列 。 这 个 格式 缺 省 的 时 候 是 压缩 的 。 


d directory 


适合 输入 到 pg_restore 里 的 目录 格式 轨 档 。 这 将 创建 一 个 目录 ， 该 目录 包含 一 个 为 每 个 被 转 
储 的 表 和 二 进 制 大 对 象 的 文件 ， 加 上 一 个 号 称 目录 的 文件 ， 该 文件 以 pg_restore 可 读 的 机 器 
可 读 格 式 描 述 转 储 的 对 象 。 目录 格式 为 档 可 以 用 标准 Unix 工 具 操 作 ; 例如 ， 在 非 压缩 为 档 中 
的 文件 可 以 用 gzip 工 具 压 缩 。 这 个 格式 缺 省 的 时 候 是 压缩 的 ， 并 且 也 支持 并 行 转 储 。 


t tar 


适合 输入 到 pg_restore 里 的 tar MME. tar 格 式 兼 容 目 录 格 式 ; 提取 tar 格 式 愉 档 产生 一 个 
有 效 的 目录 格式 归档 。 不 过 ， tar 格 式 不 支持 压缩 并 且 限 制 单独 的 表 为 8 GB。 还 有 ， 表 数据 条 
目的 相关 顺序 在 转 储 期 间 不 能 更 改 。 


-i  --ignore-version 
一 个 现在 已 经 不 用 了 的 废弃 选项 。 
-j _njobs --jobs=``_njobs_ 


通过 同时 转 储 _njobs_ 表 并 行 运行 转 储 。 该 选项 减少 了 转 储 的 时 间 ， 但 是 也 增加 了 数据 库 服 
务 器 的 负载 。 可 以 只 将 这 个 选项 用 于 目录 输出 格式 ， 因为 这 是 多 进程 可 以 同时 写 它 们 的 数据 
的 唯一 的 输出 格式 。 


pgdquwmp 将 打开 ` mobs` + 1 个 到 数据 库 的 连接 ，， 所 以 确保 你 的 max_connections 设 置 足够 高 
以 适应 所 有 的 连接 。 


运行 并 行 转 储 时 在 数据 库 对 象 上 请 求 排 他 锁 会 导致 转 储 失败 。 原 因 是 pg_dump 主 进程 在 工作 
进程 稍 后 转 储 的 对 象 上 请 求 共 享 锁 ， 这样 做 是 为 了 确保 在 转 储 运行 时 没有 人 删除 它们 或 移 走 
它们 。 如 果 另 一 个 客户 端 然 后 在 一 个 表 上 请 求 一 个 排他 锁 ， 该 锁 和 将 不 被 授予 ， 但 是 将 会 排队 
等 候 主 进程 的 共享 锁 释 放 。 因此 ， 任 意 其 他 访问 表 的 请 求 也 将 不 被 授予 ， 并 且 会 在 排他 锁 请 
求 后 排队 。 这 包含 工作 进程 尝试 转 储 这 个 表 。 i a A 为 
了 检测 这 个 冲突 ， pg_dump 工 作 进 程 请 求 使 用 NowAIT 选项 请 求 另 外 一 个 共享 锁 。 如 果 没 有 
授予 工作 进程 这 个 共享 锁 ， 那 么 肯定 是 另外 一 个 人 在 此 期 间 请 求 了 一 pee FARA Z 
法 继续 进行 转 储 了 ， 所 以 pg_dump 只 能 退出 转 储 。 


对 于 一 个 一 致 的 备份， 数据 库 服 务 器 需要 支持 同步 快照 ， 这 是 PostgreSQL 9.2 引入 的 一 个 特 
性 。 有 了 这 个 特性 ， 数 据 库 客 户 端 可 以 保证 他 们 看 到 相同 的 数据 设置 ， 即 使 它们 使 用 不 同 的 
连接 。 pg_dump -j 使 用 多 个 数据 库 连 接 ; 它 与 主 进程 连接 到 数据 库 一 次 ， 然 后 再 次 连接 到 每 
个 worker 工 作 。 没有 同步 快照 特性 ， 不 同 的 worker 工 作 将 不 会 保证 在 每 个 连接 中 看 到 相同 的 
数据 ， 这 将 导致 一 个 不 一 致 的 备份 。 


DO ARRAS TE —T9.2:2 UBAR SF aa lie THT ih, BOMB REESE HEART 
worker 工 作 连 接 到 数据 库 之 间 ， 数据 库 内 容 不 会 改变 。 最 简单 的 方法 是 在 开始 备份 之 前 叫 停 
所 有 数据 修改 进程 (DDL 和 DML) 访问 数据 库 。 你 也 需要 在 9.2 之 前 的 PostgreSQL 服 务 器 上 
运行 pg_dump -j 时 ， 声明 --no-synchronized-snapshots 参数 。 


-n _schema --schema=``_schema_ 


只 转 储 匹 配 _schema_ 的 模式 内 容 ， 包括 模式 本 身 以 及 其 中 包含 的 对 象 。 如 果 没 有 声明 这 个 选 
A, 所 有 目标 数据 库 中 的 非 系 统 模 式 都 会 被 转 储 出 来 。 可 以 使 用 多 个 -n 选项 指定 多 个 模 
式 。 同样 ， _schema_ 参数 将 按照 psql 的 \d 命令 的 规则 (参见 Pattems) 被 解释 为 匹配 模式 ， 
因此 可 以 使 用 通配符 匹配 多 个 模式 。 在 使 用 通配符 的 时 候 ， 最 好 用 引号 进行 界定 ， 以 防止 
shell 将 通配符 进行 扩展 。 参 阅 例子 。 


Note: 如 果 指 定 了 -n ， 那 么 pg_dump 将 不 会 转 储 那些 模式 所 依赖 的 其 他 数据 库 对 象 。 
因此 ， 无 法 保证 转 储 出 来 的 内 容 一 定 能 够 在 另 一 个 干净 的 数据 库 中 恢复 成 功 。 





Note: 非 模式 对 象 ( 比 如 大 对 象 ) 不 会 在 指定 -n 的 时 候 被 转 储 出 来 。 你 可 以 使 
用 --blobs 明确 要 求 转 储 大 对 象 。 

















-N _schema --exclude-schema=" ~_schema_ 


不 转 储 任何 匹配 schema 的 模式 内 容 。 模式 匹配 规则 与 -n 完全 相同 。 可 以 指定 多 个 -n 以 
排除 多 种 匹配 的 模式 。 


如 果 同 时 指定 了 -n 和 -N ， 那 么 将 只 转 储 匹 配 -n 但 不 匹配 -N 的 模式 。 如 果 出 现 -N 但 是 
不 出 现 -n ， 那么 匹配 -n 的 模式 将 不 会 被 转 储 。 


-0 --oids 


作为 数据 的 一 部 分 ， 为 每 个 表 都 输出 对 象 标识 (OIDs)。 如 果 你 的 应 用 需要 OID 字 段 的 话 (比如 
在 外 键 约束 中 用 到 )， 那 么 使 用 这 个 选项 。 否则 ， 不 应 该 使 用 这 个 选项 。 


-0 --no-owner 


不 把 对 象 的 所 有 权 设 置 为 对 应 源 数据 库 。pg_dump 默 认 发 出 

ALTER OWNER 或 SET SESSION AUTHORIZATION 语句 以 设置 创建 的 数据 库 对 象 的 所 有 权 。 如 果 这 
些 脚本 将 来 没有 被 超级 用 户 (或 者 拥有 脚本 中 全 部 对 象 的 用 户 ) 运 行 的 话 将 会 失败 。 -0 选项 
就 是 为 了 让 该 脚本 可 以 被 任何 用 户 恢 复 并 且 将 脚本 中 对 象 的 所 有 权 赋 予 该 选项 指定 的 用 户 。 


这 个 选项 只 是 对 纯 文 本 格式 有 意义 。 对 于 愉 档 格式 ， 在 调用 pg_restore 的 时 候 可 以 声明 该 选 


项 。 
-R --no-reconnect 
这 个 选项 已 经 过 时 ， 但 是 出 于 向 下 兼容 的 考虑 ， 仍 然 接 受 这 个 选项 。 


-Ss  --schema-only 


只 输出 对 象 定义 (模式 )， 不 输出 数据 。 

这 个 选项 与 --data-only 相反 。 类似 于 ， 但 是 由 于 历史 原因 不 等 于 声明 
--section=pre-data --section=post-data o 

不 要 与 --schema 选项 混淆 ， --schema 使 用 不 同 含义 的 "schema"。 


排除 表 数 据 只 是 数据 库 中 表 的 一 个 子 集 ， 人 参阅 --exclude-table-data o 
-S _username_ --Superuser="~_username_ 


指定 关闭 触发 器 时 需要 用 到 的 超级 用 户 名 。 它 只 有 使 用 了 --disable-triggers 的 时 候 才 有 影 
响 。 一 般 情 况 下 最 好 不 要 输入 这 个 参数 ， 而 是 用 超级 用 户 启 动 生成 的 脚本 。 


-t _table --table=~~_table_ 
只 转 储 出 匹配 table, 的 表 (或 视图 、 序 列 、 外 表 ) 。 可 以 使 用 多 个 -t 选项 匹配 多 个 表 。 
同样 ， _table。 参数 将 按照 psql 的 \d 命令 的 规则 (参见 Patterns) 被 解释 为 匹配 模式 ， 因此 可 


以 使 用 通配符 匹配 多 个 模式 。 在 使 用 通配符 的 时 候 ， 最 好 用 引号 进行 界定 ， 以 防止 shell 将 通 
配 符 进 行 扩 展 。 人 参阅 例子 。 


使 用 了 -t Zi, -n 和 -N 选项 就 失效 了 。 因 为 被 -t 选中 的 表 将 无 视 -n 和 -N 选项 而 被 
转 储 ， 同 时 除了 表 之 外 的 其 他 对 象 不 会 被 转 储 。 
Note: 如 果 指 定 了 -t ， 那 么 pg_dump 将 不 会 转 储 任何 选中 的 表 依 赖 的 其 它 数 据 库 对 
Ro AH, 无 法 保证 转 储 出 来 的 表 能 在 一 个 干净 的 数据 库 中 成 功 恢复 。 


Note: -t 选项 与 PostgreSQL 8.2 之 前 的 版 本 不 兼容 。 之 前 的 -t tab 将 转 储 所 有 名 

为 tab WHR, 但 是 现在 只 转 储 在 默认 搜索 路 径 中 可 见 的 表 。 写 成 -t '*.tab' 将 等 价 于 
老 版 本 的 行为 。 同样 ， 你 必须 用 -t sch.tab 而 不 是 老 版 本 的 -n sch -t tab 选择 特定 模 
式 中 的 表 。 


-T _table  --exclude-table="~_table_ 


不 要 转 储 任何 匹配 table 模式 的 表 。 模式 匹配 规则 与 -t 完全 相同 。 可 以 指定 多 个 -T AH 
除 多 种 匹配 的 表 。 


如 果 同 时 指定 了 -t 和 -T ， 那 么 将 只 转 储 匹 配 -t 但 不 匹配 -T 的 表 。 如 果 出 现 -T 但 是 不 
出 现 -t ， 那么 匹配 -7 的 表 将 不 会 被 转 储 。 


-v --verbose 


指定 宛 余 模式 。 这 样 将 令 pg_dump 输出 详细 的 对 象 评 注 以 及 转 储 文件 的 馈 停 时 间 和 进度 信息 
到 标准 错误 上 。 


-V --version 


打印 pg_dump 版 本 然后 退出 。 


-Xx --no-privileges --no-acl 
禁止 转 储 访问 权限 (grant/revoke MS) 
-Z _0..9_ --compress="~_0..9_ 


指定 要 使 用 的 压缩 级 别 。0 表 示 不 压缩 。 对 于 自 定义 愉 档 格式 ， 指 定单 个 表 数 据 段 的 压缩 ， 并 
且 缺 省 是 中 等 水 平 的 压缩 。 对 于 纯 文本 输出 ， 设 置 非 雳 压缩 级 别 会 压缩 整个 输出 文件 ， 就 像 
通过 gzip 反 馈 回 来 一 样 ; 但 是 缺 省 是 不 压缩 的 。 tar 为 档 模 式 当 前 不 支持 压缩 。 


--binary-upgrade 


此 选项 用 于 在 线 升级 工具 。 不 建议 也 不 支持 用 于 其 他 目的 。 该 选项 的 行为 可 能 会 在 将 来 的 版 
本 中 改变 。 


--column-inserts --attribute-inserts 


把 数据 转 储 为 带 有 明确 字段 名 的 Insert 命令 ( INSERT INTO _table_ ( _column_, ...) 
VALUES ...)。 这 样 会 导致 恢复 非常 缓慢 ， 它 主要 用 于 制作 那 种 可 以 用 于 其 它 非 PostgreSQL 
数据 库 的 转 储 。 由 于 这 个 选项 为 每 条 记录 都 生成 一 条 命 舍 ， 因 此 如 果 其 中 某 一 行 命令 出 错 ， 
那么 将 仅 有 该 行 数据 丢失 ， 而 不 是 整个 表 的 数据 丢失 。 





--disable-dollar-quoting 


这 个 选项 关闭 使 用 美元 符 界定 函数 体 。 强 制 它们 用 SQL 标准 的 字符 串 语法 的 引号 包围 。 
--disable-triggers 
这 个 选项 只 是 和 创建 仅 有 数据 的 转 储 相关 。 它 告诉 pg_dump 包含 在 恢复 数据 时 临时 关闭 目标 


表 上 触发 器 的 命令 。 如 果 在 表 上 有 参照 完整 性 检查 或 者 其 它 触 发 器 ， 而 恢复 数据 的 时 候 不 想 
重 载 他 们 ， 那 么 就 点 该 使 用 这 个 选项 。 


目前 ， 为 --disable-triggers 发 出 的 命令 必须 以 超级 用 户 来 执行 。 因 此 ， 你 应 该 同时 
用 -s 声明 一 个 超级 用 户 名 ， 或 者 最 好 是 用 一 个 超级 用 户 的 身份 来 启动 这 个 生成 的 脚本 。 


这 个 选项 只 对 纯 文 本 格式 有 意义 。 对 于 避 档 格式 ， 可 以 在 调用 pg_restore 的 时 候 声明 这 个 选 


项 。 
--exclude-table-data=``_table_ 


不 要 转 储 任何 匹配 _table_ 模式 的 表 。 模式 匹配 规则 与 -t 完全 相同 。 可 以 给 出 多 
个 --exclude-table-data 以 排除 多 个 匹配 的 表 。 当 你 需要 指定 表 的 定义 时 该 选项 是 有 用 的 ， 
即使 你 不 需要 表 里 面 的 数据 。 


要 排除 数据 库 中 所 有 表 的 数据 ， 参 阅 --schema-only 。 


--inserts 


将 数据 输出 为 的 Insert 命令 (而 不 是 copy) 这 样 会 导致 恢复 非常 缓慢 。 这 个 选项 主要 用 于 
制作 那 种 可 以 用 于 其 它 非 PostgreSQL 数 据 库 的 转 储 。 由 于 这 个 选项 为 每 条 记录 都 生成 一 条 命 
çS, 因此 如 果 其 中 某 一 行 命 命 出错， 那么 将 仅 有 该 行 数据 和 去 失 ， 而 不 是 整个 表 的 数据 丢失 。 
请 注意 ， 如 果 你 重新 排列 了 字段 顺序 ， 那 么 恢复 可 能 会 完全 失败 。 --column-inserts 更 安 
全 ， 但 是 也 更 慢 。 

--lock-wait-timeout=°~_timeout_ 

在 转 储 开始 的 时 候 不 要 等 待 请 求 一 个 共享 表 锁 。 相 反 ， 如 果 无 法 在 指定 的 timeout. 内 锁 住 
表 则 失败 。 timeout 可 以 用 任意 set statement_timeout 接受 的 格式 声明 。 (允许 的 值 依赖 于 


你 转 储 的 服务 器 版 本 ， 但 是 自 7.3 以 来 ， 所 有 的 版 本 都 接受 毫秒 的 整数 值 。 当 从 7.3 以 前 的 版 
本 服务 器 中 转 储 时 ， 省 略 该 选项 。) 


--no-security-labels 

不 转 储 安全 标签 。 

--no-synchronized-snapshots 

该 选项 允许 在 9.2 以 前 的 服务 器 上 运行 pg_dump -j 了 参阅 -j 参数 的 文档 获取 更 多 信息 。 
--no-tablespaces 


不 要 输出 选择 表 空 间 的 命 合 。 有 了 该 选项 ， 所 有 对 象 在 转 储 期 间 都 将 在 缺 省 的 表 空 间 中 创 
建 。 


这 个 选项 只 是 对 纯 文 本 格式 有 意义 。 对 于 愉 档 格式 ， 在 调用 pg_restore 的 时 候 可 以 声明 该 选 
项 。 

--no-unlogged-table-data 

不 要 转 储 未 记录 表 的 内 容 。 该 选项 对 于 表 定 义 (模式 ) 是 否 转 储 没有 影响 ; 它 只 阻止 转 储 表 
的 数据 。 当 从 各 用 服务 器 转 储 时 ， 示 记录 表 中 的 数据 总 是 排除 。 

--quote-all-identifiers 

强制 给 所 有 标识 符 加 上 引号 。 这 在 转 储 一 个 数据 库 到 一 个 可 能 引入 了 额外 关键 字 的 新 版 本 中 
时 可 能 是 有 用 的 。 

--section=°~_sectionname_ 

只 转 储 命名 的 章节 。 该 章节 名 可 以 是 pre-data ，data ,或 post-data 。 可 以 多 次 声明 这 个 选 
项 以 选择 多 个 章节 。 缺 省 是 转 储 所 有 章节 。 


数据 章节 包含 实际 的 表 数 据 、 大 对 象 内 容 和 序列 值 。 原 始 数据 项 包含 索引 、 鲁 发 器 、 规则 和 
约束 (除了 验证 检查 约束 ) 的 定义 。 之 前 的 数据 项 包含 所 有 其 他 数据 定义 项 。 


--serializable-deferrable 


为 转 储 使 用 一 个 可 串 行 化 的 事务 ， 以 保证 使 用 的 快照 和 稍 后 的 数据 库 状 态 一 致 ; 做 这 些 是 通 
过 等 待 事务 流 中 的 一 个 点 ， 该 点 没有 异常 会 出 现 ， 所 以 不 会 有 转 储 失败 或 导致 其 他 事务 
serialization_failure 而 回 滚 的 风险 。 参阅 Chapter 13 获取 关于 事务 隔离 和 并 发 控制 的 更 多 


信息 
Aso 


这 个 选项 对 于 只 打算 灾难 恢复 的 转 储 没有 益处 。 对 于 原始 数据 库 仍 然 在 更 新 时 ， 加 载 一 个 数 
据 库 的 拷贝 作为 报告 或 其 他 只 读 加 载 共享 的 转 储 是 有 帮助 的 。 没有 这 个 选项 ， 转 储 会 反应 一 
个 与 任何 事务 最 终 提交 的 序列 化 执行 不 一 致 的 状态 。 GUO, WORE THR A, ARES 
在 转 储 中 显示 一 部 分 ， 而 不 是 批 处 理 中 的 所 有 条 目 。 


在 pg_dump 开 始 时 ， 如 果 没 有 读 写 事务 在 活动 ， 则 这 个 选项 没有 什么 影响 。 如 果 有 读 写 事务 
在 活动 ， 那 么 转 储 开始 时 可 能 会 延迟 一 段 不 确定 的 时 间 。 一 旦 运行 ， 有 没有 开关 的 性 能 是 一 
样 的 。 


--use-set-session-authorization 


输出 符合 SQL 标准 的 SET SESSION AUTHORIZATION 命令 而 不 是 ALTER OWNER 命令 来 确定 对 象 所 
有 权 。 这 样 邻 转 储 更 加 符合 标准 ， 但 是 如 果 转 储 文件 中 的 对 象 的 历史 有 些 问题 ， 那么 可 能 不 
能 正确 恢复 。 并 且 ， 使 用 set SESSION AUTHORIZATION 的 转 储 需要 数据 库 超级 用 户 的 权限 才能 
转 储 成 功 ， 而 ALTER owNER 需要 的 权限 则 低 得 多 。 


-? --help 

显示 关于 pg_dump 命 令 行 参数 的 帮助 然后 退出 。 

下 面 的 命令 行 参 数控 制 数 据 库 的 连接 参数 。 

-d dbname --dbname=``_dbname_ 

声明 要 连接 的 数据 库 名 称 。 相 当 于 在 命令 行 中 声明 _dbname ”作为 第 一 个 非 选 项 参数 。 


如 果 这 个 参数 包含 一 个 = 符号 或 以 一 个 有 效 的 URI 前 级 ( postgresql:// 或 postgres:// ) 开 
始 ， 那么 将 其 看 做 一 个 conninfo 字符 串 。 参 阅 Section 31.1 获取 更 多 信息 。 


-h _host  --host= host 


指定 运行 服务 器 的 主机 名 。 如 果 数 值 以 斜 枉 开头 ， 则 被 用 作 到 Unix 域 套 接 字 的 路 径 。 RA 
从 PGHosT 环境 变量 中 获取 (如 果 设 置 了 的 话 )， 否 则 ， 党 试 一 个 Unix 域 套 接 字 连 接 。 


-p _port_ --port=``_port_ 


指定 服务 器 正在 侦 听 的 TCP 端口 或 本 地 Unix 域 套 接 字 文件 的 扩展 (描述 符 )。 缺 省 使 
用 pcport 环境 变量 (如 果 设 置 了 的 话 )， 否 则 ， 编 译 时 的 缺 省 值 。 


-U _username_  --username=``_username_ 
连接 的 用 户 名 。 


-Ww --no-password 


从 不 发 出 密码 提示 问题 。 如 果 服 务 器 要 求 密 码 认 证 并 且 密 码 不 可 用 于 其 他 意思 如 .pgpass 文 
件 ， 则 连接 党 试 将 会 失败 。 该 选项 在 批量 工作 和 不 存在 用 户 输 入 密码 的 脚本 中 很 有 帮助 。 


-W  --password 
强制 pg_dump 在 连接 到 数据 库 之 前 提示 一 个 密码 。 


这 个 选项 从 来 不 是 至 关 重 要 的 ， 因 为 如 果 服 务 器 需求 密码 认证 ， 则 pg_dump 自动 提示 一 个 密 
码 。 不 过 ，pg_dump 将 在 找 出 服务 器 想 要 一 个 密码 上 浪费 一 个 连接 尝试 。 在 某 些 情况 下 ， 值 
得 输入 -w 以 避免 额外 的 连接 尝试 。 


--role=``_rolename_ 


指定 创建 转 储 的 角色 名 。 这 个 选项 导致 连接 到 数据 库 之 后 pgdump 发 出 一 个 SET ROLE 
rolename #4. 当 认 证 的 用 户 (通过 -U 指定) 缺乏 pg_dump 所 需 的 权限 时 是 很 有 用 的 ， 可 以 
转变 成 有 所 需 权 限 的 角色 。 一 些 安装 有 反对 作为 超级 用 户 直 接 登 录 的 政策 ， 使 用 这 个 选项 允 
许 转 储 不 违反 该 政策 。 


> E 

环境 变量 
PGDATABASE PGHOST PGOPTIONS PGPORT PGUSER 

缺 省 连接 参数 。 


这 个 功用 ， 类 似 大 多 数 其 他 PostgreSQL 实 用 工具 ， 也 使 用 由 libpq 支 持 的 环境 变量 ( 参 
J Section 31.14) 。 


pg_dump 在 内 部 使 用 seLEcT 语句 。 如 果 你 运行 pg_dump 时 碰 到 问题 ， 确 认 你 能 够 使 用 像 
psql 这 样 的 程序 从 数据 库 选取 信息 。 还 有 ， 要 申请 任何 libpq 前 端 库 要 使 用 的 缺 省 连接 设置 和 


环境 变量 。 


pg_dump 的 数据 库 活动 通常 由 统计 收集 器 收集 。 如 果 不 需要 ， 你 可 以 通过 PGoPTIONS 或 


ALTER USER 命令 设置 参数 track_counts 为 假 。 


= a 


) 王 局 


如 果 你 的 数据 库 给 templatel 数据 库 增加 了 任何 你 自己 的 东西 ， 那 么 请 注意 把 pg_dump 的 输 
出 恢复 到 一 个 真正 空 的 数据 库 中 ; 否则 你 可 能 会 收 到 因为 重复 定义 所 追加 的 对 象 而 造成 的 错 
误 信息 。 要 制作 一 个 没有 任何 本 地 附属 物 的 数据 库 ， 可 以 从 templateo 而 不 是 template1 拷 
贝 ， 比 如 : 


CREATE DATABASE foo WITH TEMPLATE templated; 


在 进行 纯 数据 转 储 并 且 使 用 了 选项 --disable-triggers 的 时 候 ， pg_dump 发 出 一 些 查询 先 关 
闭 用 户 表 上 的 触发 器 ， 然后 插入 数据 ， 插 入 完成 后 再 打开 触发 器 。 如 果 恢 复 动作 在 中 间 停 
JE, 那么 系统 表 可 能 就 会 处 于 一 种 错误 状态 。 


tar 为 档 的 成 员 的 大 小 限制 于 8 GB 。 这 是 tar 文件 格式 的 固有 限制 。 因此 这 个 格式 无 法 用 于 
任何 大 小 超过 这 个 尺寸 的 表 。 tar 为 档 和 任何 其 它 输出 格式 的 总 大 小 是 不 受 限制 的 ， 只 是 可 能 
会 有 操作 系统 的 限制 。 


pg_dump 生 成 的 转 储 文件 并 不 包含 优化 器 用 于 查询 规划 决策 的 统计 信息 。 因此 ， 恢 复 完 之 
后 ， 建 议 在 每 个 已 恢复 的 对 象 上 运行 ANALYzZE ， 以 保证 最 佳 的 性 能 ; 参阅 Section 23.1.3 和 
Section 23.1.6 获取 更 多 信息 。 转 储 文件 也 不 包含 任何 ALTER DATABASE ... SET 命令 ; 这 些 设 
置 通 过 pg_dumpall 转 储 ， 连 同 数据 库 用 户 和 其 他 安装 范围 的 设置 。 


因为 pg_dump 常 用 于 向 新 版 本 的 PostgreSQL 中 传递 数据 ， 所 以 pg_dump 的 输出 预计 可 以 加 
REE pg_dump 的 版 本 更 新 的 PostgreSQL 服务 器 版 本 中 。pg_dump 还 可 以 从 比 它 自身 版 本 
老 的 PostgreSQL 服务 器 中 转 储 。 (当前 ， 支 持 后 退 到 版 本 7.0 的 服务 器 。) Ait, pg dump 
不 能 从 上 比 它 自身 主 版 本 新 的 PostgreSQL 服 务 器 中 转 储 ; 它 会 拒绝 尝试 ， 而 不 是 冒险 制作 一 个 
不 可 用 的 转 储 。 另 外 ， 它 不 保证 pg_dumop 的 输出 可 以 加 载 到 一 个 旧 的 主 版 本 的 服务 器 中 ， 即 
使 该 转 储 是 从 那个 版 本 的 服务 器 中 而 来 。 加 载 转 储 文件 到 一 个 旧 的 服务 器 可 能 需要 手动 编辑 
转 储 文 件 ， 以 删除 不 被 旧版 本 理解 的 语法 。 

例子 


将 mydb 数据 库 转 储 到 一 个 SQL 脚本 文件 : 


<samp class="literal">$</samp> <kbd class="literal">pg_dump mydb > db.sql</kbd> 


将 上 述 脚本 导入 一 个 (新 建 的 ) 数 据 库 newdb : 

<samp class="literal">$</samp> <kbd class="literal">psql -d newdb -f db.sql</kbd> 
将 数据 库 转 储 为 自 定义 格式 的 为 档 文件 

<samp class="literal">$</samp> <kbd class="literal">pg_dump -Fc mydb > db.dump</kbd> 


将 数据 库 转 储 为 目录 格式 归档 : 


<samp class="literal">$</samp> <kbd class="literal">pg_dump -Fd mydb -f dumpdir</kbd> 


将 数据 库 转 储 为 目录 格式 归档 ， 并 行 5 个 worker 工 作 : 


<samp class="literal">$</samp> <kbd class="literal">pg_dump -Fd mydb -j 5 -f dumpdir</kbd 
Ki — 
RE) RASC SAS ATE BY) HEE newdb 








<samp class="literal">$</samp> <kbd class="literal">pg_restore -d newdb db.dump</kbd> 


转 储 一 个 名 为 mytab 的 表 : 


<samp class="literal">$</samp> <kbd class="literal">pg_dump -t mytab mydb > db.sql</kbd> 
ER 可 
4% fig detroit 模式 中 所 有 以 emp 开头 的 表 ， 但 是 不 包括 employee_log 表 i 


<samp class="literal">$</samp> <kbd class="literal">pg_dump -t 'detroit.emp*' -T detroit. 
E 
转 储 所 有 以 east 或 west 开头 并 以 gsm 结尾 的 模式 ， 但 是 不 包括 名 字 中 含有 test 模式 : 





<samp class="literal">$</samp> <kbd class="literal">pg_dump -n 'east*gsm' -n 'west*gsm' - 
SS SS SS a ee. 
同上 ， 不 过 这 一 次 使 用 正则 表达 式 的 方法 : 





<Samp class="literal">$</samp> <kbd class="literal">pg_dump -n '(east|west)*gsm' -N '*tes 
ol a a T) 
转 储 所 有 数据 库 对 象 ， 但 是 不 包括 名 字 以 ts 开头 的 表 : 





<samp class="literal">$</samp> <kbd class="literal">pg_dump -T 'ts_*' mydb > db.sql</kbd> 
1 
在 -t 等 选项 中 指定 大 写字 母 或 大 小 写 混 合 的 名 字 必 须 用 双 引 号 界定 ， 否则 将 被 自动 转换 为 


小 写 (参见 Patterns)。 但 是 因为 双 引 号 在 shel 中 有 特殊 含义 ， 所 以 必须 将 双 引 号 再 放 进 单 引 
号 中 。 这 样 一 来 ， 要 转 储 一 个 大 小 写 混合 的 表 名 ， 你 就 需要 像 下 面 这 样 : 


<samp class="literal">$</samp> <kbd class="literal">pg_dump -t "\"MixedCaseName\"" mydb > 
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Name 


pg_dumpall -- 将 一 个 PostgreSQL 数 据 库 集群 转 储 到 一 个 脚本 文件 中 


Synopsis 


pg_dumpall [ _connection-option_ ...] [ _option_ ...] 





fia ah 


pg_dumpall 可 以 转 储 一 个 数据 库 集群 里 的 所 有 数据 库 到 一 个 脚本 文件 。 该 脚本 文件 包含 可 以 
用 于 作为 psql 输 入 的 SQL 命 分 ， 从 而 恢复 数据 库 。 它 通过 对 数据 库 集 群 里 的 每 个 数据 库 调 
用 pg_dump 实现 这 个 功能 。pg_dumpall 还 转 储 出 所 有 数据 库 公用 的 全 局 对 象 。 而 pg_dump 
并 不 保存 这 些 对 象 。 这 些 信息 包括 数据库 用 户 和 组 、 表 空间 ， 以 及 性 能 如 适用 于 整个 数据 库 
的 访问 权限 。 


因为 pg_dumpall 从 所 有 数据 库 中 读 取 表 ， 所 以 你 很 可 能 需要 以 数据 库 超级 用 户 的 身份 连接 ， 
这 样 才 能 生成 完整 的 转 储 。 同 样 ， 你 也 需要 超级 用 户 的 权限 执行 保存 下 来 的 脚本 ， 这 些 才 能 
增加 用 户 和 组 ， 以 及 创建 数据 库 。 


SQL 脚本 将 写 出 到 标准 输出 。 使 用 [-flfile] 选 项 或 shell 操作 符 把 它 重 定向 到 文件 。 


pg_dumpall 需 要 和 PostgreSQL 服务 器 连接 多 次 (每 个 数据 库 一 次 )。 如 果 你 使 用 口令 认 证 ， 可 
能 每 次 都 会 询问 口令 。 这 种 情况 下 写 一 个 -/.pgpass 可 能 会 比较 方便 。 参阅 Section 31.15 获 
取 更 多 信息 。 


选项 


下 列 命令 行 参数 用 于 控制 输出 内 容 和 格式 : 


-a``--data-only 
只 转 储 数据 ， 不 转 储 模式 (数据 定义 )。 
-C --clean 


在 转 储 结果 中 包含 那些 重建 之 前 清理 (drop) 数 据 库 对 象 的 SQL 命令 。 对 规则 和 表 空 间 
的 prop 也 会 添加 进来 。 


-f _filename_ --file= ~_filename_ 
发 送 输出 到 指定 的 文件 。 如 果 省 略 了 这 个 选项 ， 就 使 用 标准 输出 。 
-g --globals-only 
只 转 储 全 局 对 象 (角色 和 表 空 间 )， 而 不 转 储 数据 库 。 
-i --ignore-version 
一 个 现在 已 经 忽略 了 的 废弃 选项 。 
-0 --oOids 


作为 数据 的 一 部 分 ， 为 每 个 表 都 输出 对 象 标 识 (OID)。 如 果 你 的 应 用 需要 OID 字 段 的 话 ( 比 如 在 
外 键 约束 中 用 到 )， 那 么 使 用 这 个 选项 。 否则 ， 不 应 该 使 用 这 个 选项 。 


-0 --no-owner 


不 把 对 象 的 所 有 权 设 置 为 对 应 源 数 据 库 。pg_dumpall 默 认 发 出 

ALTER OWNER 或 SET SESSION AUTHORIZATION 语句 以 设置 创建 的 数据 库 对 象 的 所 有 权 。 如 果 这 
些 脚本 将 来 没有 被 超级 用 户 (或 者 拥有 脚本 中 全 部 对 象 的 用 户 ) 运 行 的 话 将 会 失败 。 -0 选项 
就 是 为 了 让 该 脚本 可 以 被 任何 用 户 恢 复 并 且 将 脚本 中 对 象 的 所 有 权 赋 予 该 选项 指定 的 用 户 。 


-r --roles-only 
只 转 储 角 色 ， 不 转 储 数据 库 或 表 空 间 。 

-s --schema-only 

只 输出 对 象 定义 (模式 )， 不 输出 数据 。 

-S _username --superuser=``_username_ 


指定 关闭 触发 器 时 需要 用 到 的 超级 用 户 名 。 它 只 有 使 用 了 --disable-triggers 的 时 候 才 有 影 
响 。 一 般 情况 下 最 好 不 要 输入 这 个 参数 ， 而 是 用 超级 用 户 启 动 生 成 的 脚本 。 


-t  --tablespaces-only 
只 转 储 表 空 间 ， 不 转 储 数据 库 或 角色 。 
-Vv --Vverbose 


指定 元 余 模式 。 这 样 将 邻 pg_dumpall 输出 转 储 文件 的 启 停 时 间 和 进度 信息 到 标准 错误 上 。 它 
将 同时 启用 pg_dump 的 宛 余 输 出 。 


-V --version 
打印 pg_dumpall 的 版 本 然后 退出 。 


-Xx --no-privileges --no-acl 


禁止 转 储 访问 权限 (grant/revoke MA) 
--binary-upgrade 


这 个 选项 用 于 本 地 升级 工具 。 不 建议 也 不 支持 用 于 其 他 目的 。 该 选项 的 性 能 可 能 会 在 将 来 的 
版 本 中 改变 。 


--column-inserts --attribute-inserts 


把 数据 转 储 为 带 有 明确 字段 名 的 INSERT 命令 ( INSERT INTO _table_ ( _column_., ...) 
VALUES ...)。 这 样 会 导致 恢复 非常 缓慢 ， 它 主要 用 于 制作 那 种 可 以 用 于 其 它 非 PostgreSQL 
数据 库 的 转 储 。 





--disable-dollar-quoting 


这 个 选项 关闭 使 用 美元 符 界定 范 数 体 。 强 制 它 们 用 SQL 标准 的 字符 串 语 法 的 引号 包围 。 
--disable-triggers 
这 个 选项 只 是 和 创建 仅 有 数据 的 转 储 相关 。 它 告诉 pg_dumpall 包含 在 恢复 数据 时 临时 关闭 目 


标 表 上 触发 器 的 命令 。 如 果 在 表 上 有 参照 完整 性 检查 或 者 其 它 触发 器 ， 而 恢复 数据 的 时 候 不 
想 重 载 他 们 ， 那 么 就 应 该 使 用 这 个 选项 。 


目前 ， 为 --disable-triggers 发 出 的 命令 必须 以 超级 用 户 来 执行 。 因 此 ， 你 应 该 同时 

用 -s 声明 一 个 超级 用 户 名 ， 或 者 最 好 是 用 一 个 超级 用 户 的 身份 来 启动 这 个 生成 的 脚本 。 
--inserts 

把 数据 转 储 为 INSERT 命令 (而 不 是 copy) 这 样 将 令 恢 复 过 程 非常 缓慢 ， 这 个 选项 主要 用 于 


制作 那 种 可 以 用 于 其 它 非 PostgreSQL 数 据 库 的 转 储 。 请 注意 ， 如 果 你 重新 排列 了 字段 顺 
序 ， 那 么 恢复 可 能 会 完全 失败 。 --column-inserts 更 安全 ， 但 是 也 更 慢 。 
--lock-wait-timeout=*~_timeout_ 

在 转 储 开始 的 时 候 不 要 等 待 请 求 一 个 共享 表 锁 。 相 反 ， 如 果 无 法 在 指定 的 timeout. 内 锁 住 
表 则 失败 。 timeout 可 以 用 任意 set statement_timeout 接受 的 格式 声明 。 人 允许 的 值 依赖 于 你 
转 储 的 服务 器 版 本 ， 但 是 自 7.3 以 来 ， 所 有 的 版 本 都 接受 毫秒 的 整数 值 。 当 从 7.3 以 前 的 版 本 
服务 器 中 转 储 时 ， 省 略 该 选项 。 


--no-security-labels 
不 转 储 安全 标签 。 
--no-tablespaces 


不 要 输出 为 对 象 创建 表 空 间或 选择 表 空 间 的 命 售 。 有 了 该 选项 ， 所 有 对 象 在 转 储 期 间 都 将 在 
缺 省 的 表 空 间 中 创建 。 


--no-unlogged-table-data 


不 要 转 储 未 记录 表 的 内 容 。 该 选项 对 于 表 定 义 (模式 ) 是 否 转 储 没有 影响 ; CREER R 
的 数据 。 


--quote-all-identifiers 


强制 给 所 有 标识 符 加 上 引号 。 这 在 转 储 一 个 数据 库 到 一 个 可 能 引入 了 额外 关键 字 的 新 版 本 中 
时 可 能 是 有 用 的 。 


--use-set-session-authorization 


输出 符合 SQL 标准 的 SET SESSION AUTHORIZATION 命令 而 不 是 ALTER OWNER 命令 来 确定 对 象 所 
有 权 。 这 样 令 转 储 更 加 符合 标准 ， 但 是 如 果 转 储 文件 中 的 对 象 的 历史 有 些 问题 ， 那么 可 能 不 
能 正确 恢复 。 


-2 --help 

显示 关于 pg_dumpall 命 邻 行 参 数 的 帮助 然后 退出 。 

下 面 的 命令 行 参 数控 制 数据 库 的 连接 参数 。 

-d _connstr_ --dbname=``_connstr_ 

指定 用 于 连接 到 服务 器 的 参数 ， 作 为 连接 字符 串 。 参 阅 Section 31.1.1 获 取 更 多 信息 。 


为 了 和 与 其 他 客户 端 应 用 保持 一 致 ， 这 个 选项 被 叫做 --dpname ， 但 是 因为 pg_dumpall 需 要 连接 
到 多 个 数据 库 ， 所 以 连接 字符 串 中 的 数据 库 名 将 会 省 略 。 使 用 -1 选项 指定 用 于 转 储 全 局 对 
象 的 数据 库 名 和 找 出 应 该 转 储 的 其 他 数据 库 。 


-h _host_  --host=>~_host_ 


指定 运行 服务 器 的 主机 名 。 如 果 数 值 以 斜 枉 开头 ， 则 被 用 作 到 Unix 域 套 接 字 的 路 径 。 RA 
从 PGHosT 环境 变量 中 获取 (如 果 设 置 了 的 话 )， 否 则 ， 党 试 一 个 Unix 域 套 接 字 连 接 。 


-1 _dbname --database=``_dbname_ 


指定 用 于 转 储 全 局 对 象 的 数据 库 名 和 找 出 应 该 转 储 的 其 他 数据 库 。 如 果 没 有 声明 ， 将 使 
用 postgres 数据 库 ， 如 果 postgres 数据 库 不 存在 ， 则 使 用 templates o 


-p _port_ --port=``_port_ 


指定 服务 器 正在 侦 听 的 TCP 端口 或 本 地 Unix 域 套 接 字 文件 的 扩展 (描述 符 )。 缺 省 使 
FA pcport 环境 变量 (如 果 设 置 了 的 话 )， 否 则 ， 编 译 时 的 缺 省 值 。 


-U _username_  --username=``_username_ 
连接 的 用 户 名 。 


-Ww --no-password 


从 不 发 出 密码 提示 问题 。 如 果 服 务 器 要 求 密 码 认 证 并 且 密 码 不 可 用 于 其 他 意思 如 .pgpass 文 
件 ， 则 连接 党 试 将 会 失败 。 该 选项 在 批量 工作 和 不 存在 用 户 输 入 密码 的 脚本 中 很 有 帮助 。 


-W --password 
强制 pg_dumpall 在 连接 到 数据 库 之 前 提示 一 个 密码 。 


这 个 选项 从 来 不 是 至 关 重 要 的 ， 因 为 如 果 服 务 器 需求 密码 认证 ， 则 pg_dumpall 自动 提示 一 个 
密码 。 不 过 ，pg_dumpall 将 在 找 出 服务 器 想 要 一 个 密码 上 浪费 一 个 连接 尝试 。 在 某 些 情况 
下 ， 值 得 输入 -w 以 避免 额外 的 连接 尝试 。 


请 注意 ， 密码 提示 将 在 每 个 要 转 储 的 数据 库 上 发 生 。 通常 ， 建 立 一 1 ~/.pgpass 文件 比 依赖 
于 手动 输入 密码 好 的 多 。 


--role=``_rolename_ 


指定 创建 转 储 的 角色 名 。 这 个 选项 导致 连接 到 数据 库 之 后 pgdumpall 发 出 一 个 sET ROLE 
`rolename #4. 当 认 证 的 用 户 (通过 -U 指定) 缺乏 pg_dumpall 所 需 的 权限 时 是 很 有 用 的 ， 可 
以 转变 成 有 所 需 权 限 的 角色 。 一 些 安装 有 反对 作为 超级 用 户 直 接 登 录 的 政策 ， 使 用 这 个 选项 
允许 转 储 不 违反 该 政策 。 


环境 变量 
PGHOST PGOPTIONS PGPORT PGUSER 

缺 省 连接 参数 。 

这 个 功用 ， 类 似 大 多 数 其 他 PostgreSQL 实 用 工具 ， 也 使 用 由 libpq 支 持 的 环境 变量 ( 参 


J Section 31.14) 。 


= a 


) 王 局 


为 pg_dumpall 在 内 部 调用 pg_dump， 所 以 ， 一 些 诊断 信息 可 以 参考 pg_dump。 


恢复 完 之 后 ， 建 议 在 每 个 已 恢复 的 对 象 上 运行 ayze 。 这 样 优化 器 就 可 以 得 到 有 用 的 统 
计 。 你 也 可 以 用 vacuumdb -a -z 清理 所 有 数据 库 。 


pg_dumpall 要 求 所 有 需要 的 表 空 间 目 录 在 进行 恢复 之 前 就 必须 存在 ， 否则 在 非 标 准 位 置 创建 
数据 库 将 会 失败 。 


例子 


转 储 所 有 数据 库 : 


<samp class="literal">$</samp> <kbd class="literal">pg_dumpall > db.out</kbd> 


从 该 文件 中 恢复 数据 库 : 


<samp class="literal">$</samp> <kbd class="literal">psql -f db.out postgres</kbd> 


执行 这 个 命令 的 时 候 连接 到 哪个 数据 库 无 关 紧 要 ， 因 为 pg_dumpall 创建 的 脚本 将 会 包含 恰当 
的 创建 和 连接 数据 库 的 命令 。 


义 见 


看 看 pg_dump 获 取 可 能 的 错误 条 件 的 详细 信息 。 


pg_isready 


Name 


pg_isready -- check the connection status of a PostgreSQL server 


Synopsis 


pg_isready [ _connection-option_ ...] [ _option_ ...] 





Description 


pg_isready is a utility for checking the connection status of a PostgreSQL database server. 
The exit status specifies the result of the connection check. 


Options 


-d _dbname_*~ --dbname=~ ~_dbname_ 
Specifies the name of the database to connect to. 


If this parameter contains an = sign or starts with a valid URI prefix ( postgresql:// or 
postgres:// ), itis treated as a conninfo string. See Section 31.1.1 for more information. 


-h _hostname_ --host=°~_hostname_ 


Specifies the host name of the machine on which the server is running. If the value begins 
with a slash, it is used as the directory for the Unix-domain socket. 


-p _port_ --port=``_port_ 


Specifies the TCP port or the local Unix-domain socket file extension on which the server is 
listening for connections. Defaults to the value of the pcport environment variable or, if not 
set, to the port specified at compile time, usually 5432. 


-q  --quiet 
Do not display status message. This is useful when scripting. 


-t _seconds_ --timeout=° ~_seconds_ 


The maximum number of seconds to wait when attempting connection before returning that 
the server is not responding. Setting to 0 disables. The default is 3 seconds. 


-U  _username_  --username=" ~_username_ 

Connect to the database as the user _username_ instead of the default. 
-V --version 

Print the pg_isready version and exit. 
-?  --help 


Show help about pg_isready command line arguments, and exit. 


Exit Status 


pg_isready returns o to the shell if the server is accepting connections normally, 1 if the 
server is rejecting connections (for example during startup), 2 if there was no response to 
the connection attempt, and 3 if no attempt was made (for example due to invalid 
parameters). 


Environment 


pg_isready , like most other PostgreSQL utilities, also uses the environment variables 
supported by libpq (see Section 31.14). 


Notes 


The options --dbname and --username can be used to avoid gratuitous error messages in 
the logs, but are not necessary for proper functionality. 


Examples 
Standard Usage: 


<samp class="literal">$</samp> <kbd class="literal">pg_isready</kbd> 
<samp class="literal">/tmp:5432 - accepting connections</samp> 

<samp class="literal">$</samp> <kbd class="literal">echo $?</kbd> 
<samp class="literal">0</samp> 


Running with connection parameters to a PostgreSQL cluster in startup: 


<samp 
<samp 
<samp 
<samp 


图 


class="literal">$</samp> <kbd class="literal">pg_isready -h localhost -p 5433</kbd> 
class="literal">localhost:5433 - rejecting connections</samp> 
class="literal">$</samp> <kbd class="literal">echo $?</kbd> 
class="literal">1</samp> 
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Running with connection parameters to a non-responsive PostgreSQL cluster: 


<samp 
<samp 
<samp 
<samp 


class="literal">$</samp> <kbd class="literal">pg_isready -h someremotehost</kbd> 
class="literal">someremotehost:5432 - no response</samp> 
class="literal">$</samp> <kbd class="literal">echo $?</kbd> 
class="literal">2</samp> 


pg_receivexlog 


Name 


pg_receivexlog -- PostgreSQL # PHF 4 AG 


Synopsis 


pg_receivexlog [ _option_ ...] 


fia ah 


pg_receivexlog 用 于 从 一 个 运行 的 PostgreSQL 集群 中 流 事务 日 志 。 该 事务 日 志 流 使 用 流 复制 
协议 ， 并 写 入 到 文件 的 本 地 目录 中 。 这 个 目录 可 以 被 用 作 使 用 时 间 点 恢复 的 注 档 目录 ( 参 
J Section 24.3) 。 


pg_receivexlog 在 服务 器 上 产生 事务 日 志 时 实时 流 事务 日 志 ， HAAR archive _ command 那 
样 等 待 段 的 完成 。 因 为 这 个 原因 ， 当 使 用 pg_receivexlog 时 不 需要 设置 archive_timeout。 


事务 日 志 在 普通 的 PostgreSQL 连 接 上 流出 ， 并 且 使 用 复制 控制 。 必须 由 超级 用 户 或 
有 REPLICATION 权限 的 用 户 (参阅 Section 20.2) 连接 ， 并 且 pg_hba.cont 必须 明确 的 允许 复 
制 连接 。 服 务 器 也 必须 配置 的 max_wal senders 足 够 高 ， 使 流 至 少 有 一 个 会 话 可 用 。 


如 果 失 去 连接 ， 或 者 不 能 初步 建立 ， 带 有 一 个 非 致 命 错 误 ，pg_receivexlog 将 无 限 的 重 试 连 
接 ， 并 尽快 重建 流 。 要 避免 这 种 行为 ， 使 用 -n 参数 。 


选项 


下 列 的 命令 行 选 项 控制 输出 的 位 置 和 格式 。 


-D _directory_~~--directory="~_directory_ 
写 输 出 的 目录 。 


这 个 参数 是 必需 的 。 
下 列 的 命令 行 选 项 控制 程序 的 运行 。 
-n --no-loop 


不 要 循环 连接 错误 。 相 反 ， 立 即 带 有 错误 退出 。 


-v --verbose 
启用 元 余 模式 。 

下 列 的 命 命 行 选项 控制 数据 库 连 接 参数 。 

-d _connstr_ --dbname=``_connstr_ 

声明 用 来 连接 到 服务 器 的 参数 ， 作 为 一 个 连接 字符 串 。 参 阅 Section 31.1.1 获 取 更 多 信息 。 


该 选项 被 称 为 --dbname 是 为 了 与 其 他 客户 端 应 用 的 一 致 性 ， 但 是 因为 pg_receivexlog 不 连接 
到 集群 中 的 任何 特别 的 数据 库 ， 所 以 将 忽略 连接 字符 串 中 的 数据 库 名 字 。 


-h _host_ --host= host 


声明 服务 器 正在 运行 的 机 器 的 主机 名 。 如 果 这 个 值 以 一 个 斜 线 开 始 ， 则 被 用 作 Unix 域 套 接 字 
的 目录 。 默认 从 PGHosT 环境 变量 中 获取 〈 如 果 设 置 了 ) ， 否 则 尝试 一 个 Unix 域 套 接 字 连接 。 


-p _port_ --port=``_port_ 


声明 服务 器 正在 监听 的 TCP 端 口 或 本 地 Unix 域 套 接 字 文 件 扩展 。 缺 省 是 PsPoRT 环境 变量 (如 
果 设 置 了 ) ， 否 则 是 内 编译 的 缺 省 。 


-s _interval  --status-interval=``_interval_ 


声明 状态 数据 包 发 送 回 服务 器 的 秒 数 。 这 人 允许 对 服务 器 进程 的 更 简单 的 监视 。 为 了 避免 连接 
超时 ， 雳 值 完全 蔡 用 定期 状态 更 新 ， 尽 管 服务 器 需要 时 仍然 发 送 一 个 更 新 。 缺 省 值 是 10 秒 。 


-U _username_  --username=``_username_ 
连接 的 用 户 名 。 
-Ww  --no-password 


从 不 发 出 密码 提示 问题 。 如 果 服 务 器 要 求 密码 认证 并 且 密 码 不 可 用 于 其 他 意思 如 .pgpass X 
件 ， 则 连接 尝试 将 会 失败 。 该 选项 在 批量 工作 和 不 存在 用 户 输入 密码 的 脚本 中 很 有 帮助 。 


-W --password 
强制 pg_receivexlog 在 连接 到 数据 库 之 前 提示 一 个 密码 。 


这 个 选项 从 来 不 是 至 关 重 要 的 ， 因 为 如 果 服 务 器 需求 密码 认证 ， 则 pg_receivexlog 自动 提示 
一 个 密码 。 不 过 ，pg_receivexlog 将 在 找 出 服务 器 想 要 一 个 密码 上 浪费 一 个 连接 尝试 。 在 某 
些 情况 下 ， 值 得 输入 -w 以 避免 额外 的 连接 尝试 。 


其 他 选项 也 可 用 : 
-V --version 


打印 pg_receivexlog 版 本 然后 退出 。 


-?  --help 


显示 关于 pg_receivexlog 命 邻 行 参数 的 帮助 然后 退出 。 


环境 变量 
这 个 工具 ， 类 似 大 多 数 其 他 PostgreSQL 实 用 工具 ， 也 使 用 由 libpq 支 持 的 环境 变量 ( 参 
J Section 31.14) 。 
NN ON 
ÆA 
当 使 用 pg_receivexlog 而 不 是 archive_ command 时 ， 服务 器 将 持续 回收 事务 日 志文 件 ， 即 使 
备份 没 有 适当 的 兴 档 ， 因 为 这 里 没有 失败 的 命令 。 可 以 通过 在 文件 还 未 适当 的 轨 档 时 有 一 
个 archive_ command 失 败 来 绕 开 : 


archive_command = 'sleep 5 && test -f /mnt/server/archivedir/%f ' 


最 初 的 时 限 是 必须 的 ， 因 为 pg_receivexlog 使 用 异步 复制 工作 ， 并 且 因 此 稍微 落后 于 主机 。 


例子 
要 从 服务 器 mydbserver 流 事务 日 志 ， 并 将 其 存储 到 本 地 目录 /usr/local/pgsql/archive 中 : 


<Samp class="literal">$</samp> <kbd class="literal">pg_receivexlog -h mydbserver -D /usr/ 
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pg_basebackup 


pg_restore 


Name 


pg_restore -- 从 pg_dump 创 建 的 备份 文件 中 恢复 PostgreSQL 数 据 库 


Synopsis 


pg_restore [ _connection-option_ ...] [ _option_ ...] [ _filename_ ] 





fia ah 


pg_restore 用 于 恢复 由 pg_dump 转 储 的 任何 非 纯 文本 格式 中 的 PostgreSQL 数 据 库 。 CHR 
出 必要 的 命 合 重 建 数 据 库 ， 并 把 它 恢复 成 转 储 时 的 样子 。 为 档 ( 各 份 ) 文 件 还 人 允许 pg_restore 有 
选择 地 进行 恢复 ， 莽 至 在 恢复 前 重新 排列 条 目的 顺序 。 为 档 的 文件 设计 成 可 以 在 不 同 的 硬件 
体系 之 间 移 植 。 


pg_restore 可 以 按照 两 种 模式 操作 。 如 果 声 明了 数据 库 名 字 ， 那么 pg_restore 连 接 到 那个 数据 
库 并 直接 恢复 兴 档 内 容 到 数据 库 里 。 否则 ， 先 创建 一 个 包含 重建 数据 库 所 必须 的 SQL 命令 能 
脚本 ， 并 且 写 入 到 一 个 文件 或 者 标准 输出 。 这 个 脚本 输出 等 效 于 pg_dump 的 纯 文 本 输出 格 
式 。 因 此 ， 一 些 控制 输出 的 选项 就 是 模拟 pg_dump 的 选项 设置 的 。 


显然 ，pg_restore 无 法 恢复 那些 不 存在 为 档 文件 中 的 信息 ; 比如 ， 如 果 为 档 是 用 "把 数据 转 储 
为 INSERT 命令 "选项 制作 的 ， 那么 pg_restore 将 不 能 使 用 copy 语句 加 载 数据 。 


ae 


选项 


pg_restore 接 受 下 列 命令 行 参数 : 


_filename_ 


要 恢复 的 备份 文件 (或 目录 ， 对 于 目录 格式 为 档 ) 的 位 置 。 如 果 没 有 声明 ， 则 使 用 标准 输 
Ao 


-a``--data-only 


只 恢复 数据 ， 而 不 恢复 表 模 式 (数据 定义 )。 恢 复 表 数据 、 大 对 象 和 序列 值 ， 如 果 在 档案 中 存 
在 。 


这 个 选项 类 似 于 ， 但 是 由 于 历史 原因 不 等 于 声明 --section=data o 


-C --clean 


创建 数据 库 对 象 前 先 清理 (删除 ) 它 们 。 (如 果 任 一 对 象 不 在 目标 数据 库 中 ， 这 可 能 会 产生 一 
些 无 害 的 错误 信息 。) 


-C --create 


在 恢复 数据 库 之 前 先 创建 它 。 如 果 也 声明 了 --clean, 那么 在 连接 到 数据 库 之 前 删除 并 重建 
目标 数据 库 。 


如 果 出 现 了 这 个 选项 ， 和 -d 在 一 起 的 数据 库 名 只 是 用 于 发 出 最 初 的 
DROP DATABASE 和 CREATE DATABASE 命令 。 所 有 数据 都 恢复 到 名 字 出 现在 为 档 中 的 数据 库 中 
去 。 


-d _dbname_ = --dbname="~_dbname_ 
与 数据 库 _dbname 连接 并 且 直 接 恢复 到 该 数据 库 中 。 
-e --exit-on-error 


如 果 在 向 数据 库 发 送 SQL 命令 的 时 候 碰 到 错误 ， 则 退出 。 缺 省 是 继续 执行 并 且 在 恢复 结束 时 


显示 一 个 错误 计数 。 

-f _filename_ --file=``_filename_ 

指定 生成 的 脚本 的 输出 文件 ， 或 者 出 现 -1 选项 时 用 于 列表 的 文件 ， 缺 省 是 标准 输出 。 
-F _format_ --format=``_format_ 


指定 各 份 文件 的 格式 。 因 为 pg_restore 会 自动 判断 格式 ， 所 以 如 果 一 定 要 指定 的 话 ， 它 可 以 
是 下 面 之 一 : 


c custom 
各 份 的 格式 是 来 自 pg_dump 的 自 定 义 格 式 。 
d directory 
各 份 是 一 个 目录 为 档 。 

t tar 
备份 是 一 个 tar Jat 

-i --ignore-version 
一 个 现在 已 经 忽略 了 的 已 废弃 的 选项 。 

-I _index  --index=**_index_ 


只 恢复 命名 的 索引 。 


-j  _number-of-jobs_ --jobs=*~_number-of-jobs_ 


运行 pBg_restore 耗 时 最 多 的 部 分 ， 该 部 分 使 用 多 重 并 发 工作 加 载 数据 、 创建 索引 或 创建 约 
束 。 这 个 选项 可 以 显著 的 减少 恢复 一 个 大 数据 库 到 一 个 运行 多 重 处 理 器 服务 器 的 时 间 。 

每 个 工作 是 一 个 过 程 或 一 个 线程 ， 取 决 于 操作 系统 ， 并 使 用 一 个 单独 到 服务 器 的 连接 。 

该 选项 的 最 佳 值 依赖 于 服务 器 、 客 户 端 和 网 络 的 硬件 设置 。 因 素 包 含 CPU 内 核 的 数量 和 磁 瘟 
设置 。 良好 的 开端 是 服务 器 上 CPU 内 核 的 数量 ， 但 是 较 大 的 值 在 许多 情况 下 也 可 以 更 快 的 恢 
复 。 当然 ， 太 高 的 值 因 为 超 负荷 将 会 导致 性 能 降低 。 

该 选项 只 支持 自 定义 和 目录 愉 档 格式 。 输 入 必须 是 有 规律 的 文件 或 目录 (例如 不 是 通道 ) 。 


发 出 一 个 脚本 而 不 是 连接 目录 到 一 个 数据 库 服务 器 时 忽略 该 选项 。 还 有 ， 多 重工 作 不 能 
与 --single-transaction 选项 一 起 使 用 。 


-l --list 


列 出 备份 的 内 容 。 这 个 操作 的 输出 可 以 用 作 -L 选项 的 输入 。 请 注意 ， 如 果 过 滤 开 关 
如 -n 或 -t 和 -1 一 起 使 用 ， 它们 将 限制 列 出 的 条 目 。 


-L _list-file_ --use-list=°~*_list-file_ 

以 它们 在 文件 中 出 现 的 顺序 只 恢复 在 _list-file 里面 的 元 素 。 请 注意 ， 如 果 过 滤 开 关 

如 -n 或 -t 和 -1 一 起 使 用 ， 它们 将 进一步 的 限制 恢复 的 条 目 。 

_list-file 通常 通过 编辑 先前 -1 操作 的 输出 来 创建 。 你 可 以 移动 或 删除 各 个 行 并 且 也 可 以 
通过 在 行 开头 放置 分 号 ( ; ) 的 方式 注释 。 例 子 见 下 文 。 

-n _namespace_ --schema=``_schema_ 


只 恢复 指定 名 字 的 模式 里 面 的 对 象 。 这 个 选项 可 以 和 -t 选项 一 起 使 用 ， 实现 只 转 储 一 个 表 
的 数据 。 


-0 --no-owner 


不 要 输出 设置 对 象 权 限 与 最 初 数据 库 匹 配 的 命令 。 缺 省 时 ，pg_restore 发 

出 ALTER OWNER 或 SET SESSION AUTHORIZATION 语句 设置 创建 出 来 的 模式 元 素 的 所 有 者 权限 。 
如 果 最 初 的 数据 库 连 接 不 是 由 超级 用 户 (或 者 是 拥有 所 有 创建 出 来 的 对 象 的 同一 个 用 户 ) 发 起 
的 ， 那 么 这 些 语句 将 失败 。 如 果 使 用 -o ， 那 么 任何 用 户 都 可 以 用 于 初始 的 连接 ， 并 且 这 个 
用 户 将 拥有 所 有 创建 出 来 的 对 象 。 


-P _function-name(argtype [, ...])_  --function="~_function-name(argtype [, ...])_ 


只 恢复 指定 的 命名 画 数 。 请 注意 仔细 拼写 画 数 名 及 其 参数， 应 该 和 转 储 的 内 容 列 表 中 的 完全 
一 样 。 


-R --no-reconnect 


RPRABARAT, BEA TARRA FRADRAER, 

-s  --schema-only 

只 恢复 表 结 构 (数据 定义 )， 不 恢复 数据 ， 在 这 个 意义 上 来 说 在 为 档 里 有 模式 的 记录 。 
这 个 选项 是 --data-only 的 相反 。 它 类 似 于 ， 但 是 因为 历史 原因 不 等 于 声明 


--section=pre-data --section=post-data o 
请 不 要 和 --schema 选项 混淆 ， 那 里 使 用 了 "模式 "(schema) 的 其 它 含义 。 
-S _username_  --Superuser=°~_username_ 


设置 关闭 触发 器 时 使 用 的 超级 用 户 的 用 户 名 。 只 有 在 设置 了 --disable-triggers 的 时 候 才 有 
用 。 


-t _table --table=``_table_ 


只 恢复 指定 的 表 的 定义 和 /或 数据 。 可 以 声明 多 个 -t 指定 多 个 表 。 可 以 和 -n 选项 组 合 以 声 
明 一 个 模式 。 


-T _trigger_ --trigger=~_trigger_ 
只 恢复 指定 的 触发 器 。 

-Vv --verbose 
声明 元 余 模 式 。 

-V --version 


打印 pg_restore 的 版 本 然后 退出 。 

-x --no-privileges --no-acl 
禁止 恢复 访问 权限 (grant/revoke 命令 )。 
-1 --single-transaction 


将 整个 恢复 过 程 作 为 一 个 完整 的 事务 来 执行 ， 也 就 是 将 所 有 恢复 命令 放 在 BEGIN / commit 之 
间 。 这 将 保证 恢复 要 么 全 部 成 功 要 么 没有 任何 影响 。 该 选项 隐 含 --exit-on-error o 
--disable-triggers 

这 个 选项 只 有 在 执行 仅 恢复 数据 的 时 候 才 相关 。 它 告诉 pg_restore 在 加 载 数 据 的 时 候 执 行 一 


些 命令 临时 关闭 在 目标 表 上 的 触发 器 。 如 果 你 在 表 上 有 完整 性 检查 或 者 其 它 触 发 器 ， 而 你 又 
不 希望 在 加 载 数据 的 时 候 激 活 它 们 ， 那么 可 以 使 用 这 个 选项 。 


目前 ， 为 --disable-triggers 发 出 的 命令 必须 以 超级 用 户 发 出 。 因 此 ， 你 应 该 也 要 用 -s 声 
明 一 个 超级 用 户 名 ， 或 者 更 好 是 以 超级 用 户 身份 运行 pg_restore. 


--no-data-for-failed-tables 


缺 省 时 ， 即 使 创建 表 的 命令 因为 该 表 已 经 存在 而 失败 了 ， 表 中 的 数据 仍 将 被 恢复 。 使 用 这 个 
选项 之 后 ， 这 些 表 的 数据 就 将 跳 过 恢复 操作 。 如 果 目 标 数据 库 已 经 包含 所 需 恢复 的 某 些 表 的 
内 容 时 ， 该 选项 就 很 有 用 处 了 。 比如 ， 用 于 PostgreSQL 扩 展 的 辅助 表 ( 例 如 PostGIS) 就 可 能 
已 经 在 目标 数据 库 中 恢复 过 了 ， 使 用 该 选项 就 可 以 防止 多 次 恢复 以 致 重复 或 者 覆盖 了 已 经 恢 
复 的 数据 。 

该 选项 仅 在 直接 向 一 个 数据 库 中 恢复 的 时 候 有 效 ， 在 生成 SQL 脚本 输出 时 无 效 。 
--no-security-labels 

RSHGRBRE RAND, MERHER C1. 

--no-tablespaces 
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--Section= ~_sectionname_ 


值 恢 复 指 定 的 章节 。 章 节 名 可 以 是 pre-data ，data ,或 post-data 。 可 以 多 次 声明 这 个 选项 
以 选择 多 个 章节 。 缺 省 是 恢复 所 有 章节 。 


数据 章节 包含 实际 的 表 数据 和 大 对 象 定义 。 原 始 数据 项 包含 索引 、 鲁 发 器 、 规 则 和 约束 (CR 
了 验证 检查 约束 ) 的 定义 。 先 前 的 数据 项 包含 所 有 其 他 数据 定义 项 。 


--use-set-session-authorization 


输出 SQL 标准 的 SET SESSION AUTHORIZATION 命令 ， 而 不 是 ALTER OWNER 命令 来 确定 对 象 的 所 
有 权 。 这 样 令 转 储 与 标准 兼容 的 更 好 ， 但 是 根据 转 储 中 对 象 的 历史 ， 这 个 转 储 可 能 不 能 恰当 
地 恢复 。 


-2 --help 
显示 关于 pg_restore 命 令 行 参数 的 帮助 然后 退出 。 
pg_restore 还 接受 下 面 的 命令 行 参 数 做 为 连接 参数 : 
-h _host_ --host=``_host_ 


指定 运行 服务 器 的 主机 名 。 如 果 数 值 以 斜 枉 开头 ， 则 被 用 作 到 Unix 域 套 接 字 的 路 径 。 RA 
从 PGHosT 环境 变量 中 获取 (如 果 设 置 了 的 话 )， 否 则 ， 尝试 一 个 Unix 域 套 接 字 连 接 。 


-p _port_ --port=``_port_ 


指定 服务 器 正在 侦 听 的 TCP 端口 或 本 地 Unix 域 套 接 字 文件 的 扩展 (描述 符 )。 缺 省 使 
FA pcport 环境 变量 (如 果 设 置 了 的 话 )， 否 则 ， 编 译 时 的 缺 省 值 。 


-U _username_ --uUsername= ~_username_ 


要 连接 的 用 户 名 。 
-Ww  --no-password 


从 不 发 出 密码 提示 问题 。 如 果 服 务 器 要 求 密 码 认 证 并 且 密 码 不 可 用 于 其 他 意思 如 .pgpass 文 
件 ， 则 连接 党 试 将 会 失败 。 该 选项 在 批量 工作 和 不 存在 用 户 输 入 密码 的 脚本 中 很 有 帮助 。 


-W --password 
强制 pg_restore 在 连接 到 数据 库 之 前 提示 一 个 密码 。 


这 个 选项 从 来 不 是 至 关 重 要 的 ， 因 为 如 果 服 务 器 需求 密码 认证 ， 则 pg_restore 自动 提示 一 个 
密码 。 不 过 ，pg_restore 将 在 找 出 服务 器 想 要 一 个 密码 上 浪费 一 个 连接 尝试 。 在 某 些 情况 
下 ， 值 得 输入 -w 以 避免 额外 的 连接 尝试。 


--role= ~_rolename_ 


指定 执行 转 储 的 角色 名 。 这 个 选项 导致 连接 到 数据 库 之 后 pgrestore 发 出 一 个 SET ROLE 

` rolename #4. 当 认 证 的 用 户 (通过 -U` 指 定 ) 缺乏 pg_restore 所 需 的 权限 时 是 很 有 用 的 ， 可 以 
转变 成 有 所 需 权 限 的 角色 。 一 些 安装 有 反对 作为 超级 用 户 直 接 登 录 的 政策 ， 使 用 这 个 选项 允 
许 转 储 不 违反 该 政策 。 


Ir LER 
环境 变量 
PGHOST PGOPTIONS PGPORT PGUSER 
缺 省 连接 参数 。 


这 个 功用 ， 类 似 大 多 数 其 他 PostgreSQL 实 用 工具 ， 也 使 用 由 libpq 支 持 的 环境 变量 ( 参 
阅 Section 31.14) 。 不 过 ， 当 没有 提供 数据 库 名 字 时 ， 并 不 读 取 PGDATABASE 。 


当 使 用 -d 选项 声明 了 直接 数据 库 连 接 时 ， pg_restore 在 内 部 执行 SQL 语句 。 如 果 你 运行 
pg_restore 出 了 毛病 ， 请 确保 你 能 用 类 似 psql 这 样 的 东西 从 数据 库 中 选取 信息 。 还 有 ， 将 会 
应 用 libpq 前 端 库 使 用 的 任何 缺 省 连接 设置 和 环境 变量 。 


ss ate 
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如 果 你 的 安装 给 templates 数据 库 增加 了 任何 你 自己 的 东西 ， 那么 请 注意 把 pg_restore 的 输 
出 恢复 到 一 个 真正 空 的 数据 库 中 ; 否则 你 可 能 会 收 到 因为 重复 定义 所 追加 的 对 象 而 造成 的 错 
误 信 息 。 要 制作 一 个 没有 任何 本 地 附属 物 的 数据 库 ， 可 以 从 templateo 而 不 是 template1 $6 
A, Peso: 


CREATE DATABASE foo WITH TEMPLATE templated; 


pg_restore 的 局 限 如 下 : 


。 当 向 一 个 已 经 存在 的 表 恢 复数 据 ， 并 且 还 使 用 了 --disable-triggers 选项 时 ， 
pg_restore 在 插入 数据 前 放出 一 些 查 询 关 闭 用 户 表 上 的 触发 器 ， 在 数据 插入 完成 后 重新 
打开 它们 。 如 果 恢 复 的 中 途 停 止 ， 那 么 系统 表 可 能 多 于 错误 状态 。 


e pg_restore 不 能 选择 性 的 的 恢复 大 对 象 。 例如 ， 只 恢复 指定 的 表 。 如 果 一 个 为 档 包 含 大 
对 象 ， 那 么 所 有 大 对 象 都 将 被 恢复 ， 或 如 果 他 们 通过 -L 、 -t 或 其 他 选项 排除 则 一 个 也 
不 恢复 。 


参阅 pg_dump 的 文 挡 获 取 有 关 pg_dump 的 局 限 的 细节 。 


一 旦 完成 恢复 ， 最 好 在 每 个 恢复 的 对 象 上 运行 ANALYZE ， 以 便 给 优化 器 有 用 的 统计 。 参 
阅 Section 23.1.3 和 Section 23.1.6 获 取 更 多 信息 。 


例子 
假定 我 们 已 经 转 侍 了 mydb 数据 库 到 一 个 自 定义 格式 的 文件 中 : 


<samp class="literal">$</samp> <kbd class="literal">pg_dump -Fc mydb > db.dump</kbd> 


删除 该 数据 库 并 从 转 储 中 重建 : 


<samp class="literal">$</samp> <kbd class="literal">dropdb mydb</kbd> 
<samp class="literal">$</samp> <kbd class="literal">pg_restore -C -d postgres db.dump</kb 
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在 -d 中 指定 的 数据 库 可 以 是 当前 集群 中 的 任意 数据 库 ; pg_restore 仅 用 该 名 字 来 为 mydb 发 
出 CREATE DATABASE 命令 。 使 用 -c 可 以 确保 数据 总 是 会 被 恢复 到 转 储 文件 中 指定 名 字 的 数据 
库 里 面 。 


将 转 储 出 来 的 数据 重新 加 载 到 一 个 新 建 的 数据 库 newdb 中 : 





<samp class="literal">$</samp> <kbd class="literal">createdb -T templateO newdb</kbd> 
<samp class="literal">$</samp> <kbd class="literal">pg_restore -d newdb db.dump</kbd> 


注意 ， 这 里 没有 使 用 -c 选项 ， 而 是 直接 链接 到 将 要 恢复 的 数据 库 上 。 还 要 注意 的 是 ， 我 们 
从 templated 而 不 是 template1 创建 了 新 数据 库 以 确保 干净 。 


要 对 项 目 重 新 排序 ， 首 先 必须 转 储 归档 的 目录 : 


<samp class="literal">$</samp> <kbd class="literal">pg_restore -1 db.dump > db.list</kbd> 


al = z] 


这 个 文件 由 一 行头 和 每 个 条 目 一 行 组 成 ， 比 如 : 








; Archive created at Mon Sep 14 13:55:39 2009 
: dbname: DBDEMOS 

F TOC Entries: 81 

7 Compression: 9 

> Dump Version: 1.10-0 

Format: CUSTOM 

i Integer: 4 bytes 

7 offset: 8 bytes 

> Dumped from database version: 8.3.5 

7 Dumped by pg_dump version: 8.3.8 


Selected TOC Entries: 
3; 2615 2200 SCHEMA - public pasha 
1861; © © COMMENT - SCHEMA public pasha 
1862; © © ACL - public pasha 


317; 1247 17715 TYPE public composite pasha 
319; 1247 25899 DOMAIN public domainO pasha 


这 里 分 号 是 注释 分 隔 符 ， 而 行 开头 的 数字 代表 赋 给 每 个 项 目的 内 部 轨 档 ID 。 
文件 内 的 行 可 以 注释 、 删 除 和 /或 重新 排列 。 比 如 : 


10; 145433 TABLE map_resolutions postgres 
;2; 145344 TABLE species postgres 

;4; 145359 TABLE nt_header postgres 

6; 145402 TABLE species_records postgres 
;8; 145416 TABLE ss_old postgres 


可 以 用 做 pg_restore 的 输入 并 且 只 会 恢复 项 目 10 和 6 (以 这 个 顺序 ) : 


<samp class="literal">$</samp> <kbd class="literal">pg_restore -L db.list db.dump</kbd> 
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pg_dump, pg_dumpall, psql 


psql 


Name 


psql -- PostgreSQL 3é H zii 


Synopsis 


psql [ _option_ ...] [ _dbname_ [ _username_ ]] 





fia ah 


psql 是 一 个 以 终端 为 基础 的 PostgreSQL 前 端 。 它 允 许 你 交互 地 键入 查询 ， 然 后 把 它们 发 送 给 
PostgreSQL, 再 显示 查询 的 结果 。 另外 ， 输 入 可 以 来 自 一 个 文件 。 还 有 ， 它 提供 了 一 些 元 
命令 和 多 种 类 似 shell 的 特性 来 实现 书写 脚本 以 及 对 大 量 任务 的 自动 化 。 


-a``--echo-all 


在 读 取 行 时 向 标准 输出 打印 所 有 内 容 。 这 个 选项 在 脚本 处 理 时 比 交 互 模式 时 更 有 用 。 这 个 选 
项 等 效 于 设置 变量 Echo 为 allo 


-A --no-align 
切换 到 非 对 齐 输出 模式 。 ( 缺 省 输出 模式 是 对 齐 的 。) 
-C _command_ --command= command 


声明 psql 将 执行 一 条 查询 字符 串 command, AARE. 这 在 shel 脚本 里 很 有 用 。 Ba GE 
E) 文件 ( psqirc 和 ~/.psqirc ) 忽略 这 个 选项 。 


_command 必须 是 一 条 完全 可 以 被 服务 器 分 析 的 字符 串 (也 就 是 ， 它 不 包含 psql- 特 有 的 特 
性 ) ， 或 一 个 反 斜 杠 命 令 。 因 此 你 不 能 混合 使 用 SQL 和 psql 元 命令 使 用 这 个 选项 。 要 想 混 
合 使 用 ， 你 可 以 把 字符 串 重 定向 到 psql 里 ， 像 这 样 : 


echo '\x \\ SELECT * FROM foo;' | psalo (\\ 用 于 隔 开 元 命令 )。 
如 果 命 令 字 符 串 包含 多 个 SQL 命 舍 ， 那 么 他 们 将 在 一 个 事务 里 处 理 ， 除 非 在 字符 串 里 包含 了 


明确 的 BEGIN / commit 命令 把 他 们 分 成 多 个 事务 。 这 个 和 从 psql 的 标准 输入 里 给 它 填 充 相同 
字符 串 不 同 。 此 外 ， 只 有 最 后 一 个 SQL 命令 的 执行 结果 被 返回 。 


-d _dbname_ = --dbname="~_dbname_ 
指定 想 要 连接 的 数据 库 名 称 。 这 相当 于 把 _dbname_ 作为 命 合 行 的 第 一 个 非 选项 参数 。 


如 果 该 参数 包含 一 个 = 标志 或 开始 于 一 个 有 效 的 URI 前 级 ( postgresq1:// 
或 postgres:// ), 它 被 视 为 一 个 conninfo 字符 串 。 见 Section 31.1.1 获 取 更 多 信息 。 


-e  --echo-queries 
把 所 有 发 送 给 服务 器 的 查询 同时 也 回 显 到 标准 输出 。 等 效 于 把 变量 EcHo 设置 为 queries o 
-E --echo-hidden 


eA \d 和 其 它 反 斜 杠 命 令 (内 部 命令 ) 生成 的 实际 查询 。 你 可 以 使 用 这 个 命令 学 习 psdl 
的 内 部 操作 。 这 等 效 于 在 psql 里 设置 变量 ECHO_HIDDEN o 


-f _filename_-  --file= ~_filename_ 


使 用 _filename ”作为 命令 的 语句 源 而 不 是 交互 式 读 和 人 查询 。psdql 将 在 义理 完 文件 后 结束 。 
这 个 选项 在 很 多 方面 等 效 于 内 部 命令 \i 。 
如 果 _filename ”是 - ( 连 字 符 )， 则 从 标准 输入 读 取 。 


使 用 这 个 选项 与 使 用 psql alt; _filename 有 微小 的 区 别 。 通常 ， 两 者 都 回 按照 你 预期 那样 
运行 ， 但 是 使 用 -t 打开 了 一 些 很 好 的 特性 ， 比 如 带 行 号 的 错误 信息 。 而 且 ， 使 用 这 个 选项 
还 可 能 减 小 启动 的 开销 。 另 一 方面 ， 使 用 shell 输入 重 定向 的 方式 (理论 上 ) 能 保证 生成 和 你 手 
工 输入 所 有 内 容 时 收 到 的 (输出 ) 完全 一 样 的 输出 。 


-F _separator_  --field-separator= `_separator_ 


指定 _separator 作为 不 对 齐 输出 的 字段 分 隔 符 。 SMF \pset fieldsep 或 \f o 


-h _hostname_ --host=°~_hostname_ 
指定 正在 运行 服务 器 的 主机 名 。 如 果 主 机 名 以 斜 杠 开头 ， 则 它 被 用 作 到 Unix 域 套 接 字 的 路 
径 。 


-H --html 
打开 HTML 格 式 输 出 (模式 ) 。 等 效 于 \pset format html 或 \H 命令。 
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列 出 所 有 可 用 的 数据 库 ， 然 后 退出 。 其 他 非 连 接 选项 将 被 忽略 。 这 是 类 似 于 元 命令 \list o 
-L _filename --log-file=``_filename_ 

除了 正常 的 输出 ， 把 所 有 查询 输出 写 到 文件 _filename_ 中 。 


-n --no-readline 


Do not use readline for line editing and do not use the history. This can be useful to turn off 
tab expansion when cutting and pasting. 


-o _filename_ --output=°~_filename_ 
Put all query output into file _filename_ . This is equivalent to the command \o . 
-p _port_  --port=*~_port_ 


Specifies the TCP port or the local Unix-domain socket file extension on which the server is 
listening for connections. Defaults to the value of the pcport environment variable or, if not 
set, to the port specified at compile time, usually 5432. 


-P _assignment_ --pset=°~_assignment_ 


Specifies printing options, in the style of \pset . Note that here you have to separate name 
and value with an equal sign instead of a space. For example, to set the output format to 
LaTeX, you could write -P format=latex . 


-q --quiet 


Specifies that psql should do its work quietly. By default, it prints welcome messages and 
various informational output. If this option is used, none of this happens. This is useful with 
the -c option. Within psql you can also set the quiet variable to achieve the same effect. 


-R _separator_ --record-separator= ~_separator_ 


Use _separator_ as the record separator for unaligned output. This is equivalent to the 
\pset recordsep Command. 


-Ss  --Single-step 


Run in single-step mode. That means the user is prompted before each command is sent to 
the server, with the option to cancel execution as well. Use this to debug scripts. 


-S  --single-line 


Runs in single-line mode where a newline terminates an SQL command, as a semicolon 
does. 


Note: This mode is provided for those who insist on it, but you are not necessarily 
encouraged to use it. In particular, if you mix SQL and meta-commands on a line the 
order of execution might not always be clear to the inexperienced user. 


-t  --tuples-only 


Turn off printing of column names and result row count footers, etc. This is equivalent to the 
\t command. 


-T _table_options_ --table-attr=°~*_table_options_ 
Specifies options to be placed within the HTML table tag. See \pset for details. 
-U _username_ --username=~~_username_ 


Connect to the database as the user _username_ instead of the default. (You must have 
permission to do so, of course.) 


-v _assignment_  --set=``_assignment_  --variable=``_assignment_ 


Perform a variable assignment, like the \set meta-command. Note that you must separate 
name and value, if any, by an equal sign on the command line. To unset a variable, leave off 
the equal sign. To set a variable with an empty value, use the equal sign but leave off the 
value. These assignments are done during a very early stage of start-up, so variables 
reserved for internal purposes might get overwritten later. 


-V --version 
Print the psql version and exit. 
-Ww  --no-password 


Never issue a password prompt. If the server requires password authentication and a 
password is not available by other means such asa .pgpass file, the connection attempt 
will fail. This option can be useful in batch jobs and scripts where no user is present to enter 
a password. 


Note that this option will remain set for the entire session, and so it affects uses of the meta- 
command \connect as well as the initial connection attempt. 


-W --password 
Force psql to prompt for a password before connecting to a database. 


This option is never essential, since psql will automatically prompt for a password if the 
server demands password authentication. However, psql will waste a connection attempt 
finding out that the server wants a password. In some cases it is worth typing -w to avoid 
the extra connection attempt. 


Note that this option will remain set for the entire session, and so it affects uses of the meta- 
command \connect as well as the initial connection attempt. 


-Xx  --expanded 
Turn on the expanded table formatting mode. This is equivalent to the \x command. 


-X, --no-psqlirc 


Do not read the start-up file (neither the system-wide psqirc file nor the user's ~/.psqirc 
file). 


-z  --field-separator-zero 
Set the field separator for unaligned output to a zero byte. 
-0 --record-separator-zero 


Set the record separator for unaligned output to a zero byte. This is useful for interfacing, for 
example, with xargs -6 . 


-1 --single-transaction 


When psql executes a script, adding this option wraps BEGIN / commit around the script to 
execute it as a single transaction. This ensures that either all the commands complete 
successfully, or no changes are applied. 


If the script itself uses BEGIN , COMMIT , Or ROLLBACK , this option will not have the desired 
effects. Also, if the script contains any command that cannot be executed inside a 
transaction block, specifying this option will cause that command (and hence the whole 
transaction) to fail. 


-?  --help 


Show help about psql command line arguments, and exit. 


Exit Status 


psql returns 0 to the shell if it finished normally, 1 if a fatal error of its own occurs (e.g. out of 
memory, file not found), 2 if the connection to the server went bad and the session was not 
interactive, and 3 if an error occurred in a script and the variable on_ERROR_sToP was set. 


Usage 


Connecting to a Database 


psql is a regular PostgreSQL client application. In order to connect to a database you need 
to know the name of your target database, the host name and port number of the server, and 
what user name you want to connect as. psql can be told about those parameters via 
command line options, namely -d, -h, -p ,and -u respectively. If an argument is found 
that does not belong to any option it will be interpreted as the database name (or the user 
name, if the database name is already given). Not all of these options are required; there are 
useful defaults. If you omit the host name, psql will connect via a Unix-domain socket to a 


server on the local host, or via TCP/IP to localhost on machines that don't have Unix- 
domain sockets. The default port number is determined at compile time. Since the database 
server uses the same default, you will not have to specify the port in most cases. The default 
user name is your Unix user name, as is the default database name. Note that you cannot 
just connect to any database under any user name. Your database administrator should 
have informed you about your access rights. 


When the defaults aren't quite right, you can save yourself some typing by setting the 
environment variables PGDATABASE , PGHOST , PGPORT and/or PGusER to appropriate values. 
(For additional environment variables, see Section 31.14.) It is also convenient to have a 

~/.pgpass file to avoid regularly having to type in passwords. See Section 31.15 for more 
information. 


An alternative way to specify connection parameters is ina conninfo string or a URI, which 
is used instead of a database name. This mechanism give you very wide control over the 
connection. For example: 


$ <kbd class="literal">psql "service=myservice sslmode=require"</kbd> 
$ <kbd class="literal">psql postgresql://dbmaster :5433/mydb?sslmode=require</kbd> 


This way you can also use LDAP for connection parameter lookup as described in Section 
31.17. See Section 31.1.2 for more information on all the available connection options. 


If the connection could not be made for any reason (e.g., insufficient privileges, server is not 
running on the targeted host, etc.), psql will return an error and terminate. 


If at least one of standard input or standard output are a terminal, then psql sets the client 
encoding to "auto", which will detect the appropriate client encoding from the locale settings 
( LC_CTYPE environment variable on Unix systems). If this doesn't work out as expected, the 
client encoding can be overridden using the environment variable PGCLIENTENCODING . 


Entering SQL Commands 


In normal operation, psql provides a prompt with the name of the database to which psql is 
currently connected, followed by the string =&gt; . For example: 


$ <kbd class="literal">psql testdb</kbd> 
psql (9.3.1) 
Type "help" for help. 


testdb=> 


At the prompt, the user can type in SQL commands. Ordinarily, input lines are sent to the 
server when a command-terminating semicolon is reached. An end of line does not 
terminate a command. Thus commands can be spread over several lines for clarity. If the 


command was sent and executed without error, the results of the command are displayed on 
the screen. 


Whenever a command is executed, psql also polls for asynchronous notification events 
generated by LISTEN and NOTIFY. 


Meta-Commands 


Anything you enter in psql that begins with an unquoted backslash is a psql meta-command 
that is processed by psq| itself. These commands make psdl more useful for administration 
or scripting. Meta-commands are often called slash or backslash commands. 


The format of a psql command is the backslash, followed immediately by a command verb, 
then any arguments. The arguments are separated from the command verb and each other 
by any number of whitespace characters. 


To include whitespace in an argument you can quote it with single quotes. To include a 
single quote in an argument, write two single quotes within single-quoted text. Anything 
contained in single quotes is furthermore subject to C-like substitutions for \n (new line), 

\t (tab), \b (backspace), \r (carriage return), \f (form feed), \**_digits_ (octal), 
and \x**_digits_ (hexadecimal). A backslash preceding any other character within single- 
quoted text quotes that single character, whatever it is. 


AN 


Within an argument, text that is enclosed in backquotes (``) is taken as a command line that 
is passed to the shell. The output of the command (with any trailing newline removed) 
replaces the backquoted text. 


If an unquoted colon ( : ) followed by a psql variable name appears within an argument, it is 
replaced by the variable's value, as described in SQL Interpolation. 


Some commands take an SQL identifier (such as a table name) as argument. These 
arguments follow the syntax rules of SQL: Unquoted letters are forced to lowercase, while 
double quotes ( " ) protect letters from case conversion and allow incorporation of 
whitespace into the identifier. Within double quotes, paired double quotes reduce to a single 
double quote in the resulting name. For example, Foo"BarR"BAZ is interpreted as fooBARbaz , 


and "A weird"" name" becomes A weird" name . 


Parsing for arguments stops at the end of the line, or when another unquoted backslash is 
found. An unquoted backslash is taken as the beginning of a new meta-command. The 
special sequence \\ (two backslashes) marks the end of arguments and continues parsing 
SQL commands, if any. That way SQL and psql commands can be freely mixed on a line. 
But in any case, the arguments of a meta-command cannot continue beyond the end of the 
line. 


The following meta-commands are defined: 
\a 
If the current table output format is unaligned, it is switched to aligned. If it is not unaligned, it 


is set to unaligned. This command is kept for backwards compatibility. See \pset fora 
more general solution. 





\c Or \connect [ _dbname_ [ _username_ ][ _host_ ][ _port_ ]] 


Establishes a new connection to a PostgreSQL server. If the new connection is successfully 


made, the previous connection is closed. If any of _dbname_ , _username host_ OF 


_port_ are omitted or specified as - , the value of that parameter from the previous 
connection is used. If there is no previous connection, the libpq default for the parameter's 


value is used. 


If the connection attempt failed (wrong user name, access denied, etc.), the previous 
connection will only be kept if psql is in interactive mode. When executing a non-interactive 
script, processing will immediately stop with an error. This distinction was chosen as a user 
convenience against typos on the one hand, and a safety mechanism that scripts are not 
accidentally acting on the wrong database on the other hand. 


\C [ _title | 


Sets the title of any tables being printed as the result of a query or unset any such title. This 
command is equivalent to \pset title _title_ . (The name of this command derives from 
"caption", as it was previously only used to set the caption in an HTML table.) 


\cd [ _directory_ ] 


Changes the current working directory to _directory_ . Without argument, changes to the 
current user's home directory. 


Tip: To print your current working directory, use \! pwd . 
\conninfo 
Outputs information about the current database connection. 


\copy { table_ [( _column_list_ )]|( _query_ )}{ from | to }{ _'filename'_ | 
program _'command'_ | stdin | stdout | pstdin | pstdout } [ [with ] ( _option_ [, ...] )] 





Performs a frontend (client) copy. This is an operation that runs an SQL COPY command, 
but instead of the server reading or writing the specified file, psql reads or writes the file and 
routes the data between the server and the local file system. This means that file 
accessibility and privileges are those of the local user, not the server, and no SQL superuser 
privileges are required. 


When program is specified, _command_ is executed by psql and the data from or to 
_command_ is routed between the server and the client. This means that the execution 
privileges are those of the local user, not the server, and no SQL superuser privileges are 
required. 


\copy ... from stdin | to stdout reads/writes based on the command input and output 
respectively. All rows are read from the same source that issued the command, continuing 
until \. is read or the stream reaches EOF. Output is sent to the same place as command 
output. To read/write from psql's standard input or output, use pstdin or pstdout . This 
option is useful for populating tables in-line within a SQL script file. 


The syntax of the command is similar to that of the SQL COPY command, and _option_ 

must indicate one of the options of the SQL COPY command. Note that, because of this, 

special parsing rules apply to the \copy command. In particular, the variable substitution 
rules and backslash escapes do not apply. 


Tip: This operation is not as efficient as the SQL copy command because all data 
must pass through the client/server connection. For large amounts of data the SQL 
command might be preferable. 


\copyright 
Shows the copyright and distribution terms of PostgreSQL. 
\d[S+] [ _pattern_ | 


For each relation (table, view, index, sequence, or foreign table) or composite type matching 
the _pattern_ , show all columns, their types, the tablespace (if not the default) and any 
special attributes such as not NULL or defaults. Associated indexes, constraints, rules, and 
triggers are also shown. For foreign tables, the associated foreign server is shown as well. 
("Matching the pattern" is defined in Patterns below.) 


For some types of relation, \d shows additional information for each column: column 
values for sequences, indexed expression for indexes and foreign data wrapper options for 
foreign tables. 


The command form \d+ is identical, except that more information is displayed: any 
comments associated with the columns of the table are shown, as is the presence of OIDs in 
the table, the view definition if the relation is a view. 


By default, only user-created objects are shown; supply a pattern or the s modifier to 
include system objects. 


Note: If \d is used without a _pattern_ argument, it is equivalent to \dtvse which 
will show a list of all visible tables, views, sequences and foreign tables. This is purely a 


convenience measure. 


\da[S] [ _pattern_ ] 


Lists aggregate functions, together with their return type and the data types they operate on. 
If _pattern_ is specified, only aggregates whose names match the pattern are shown. By 
default, only user-created objects are shown; supply a pattern or the s modifier to include 
system objects. 


\db[+] [ _pattern_ ] 


Lists tablespaces. If _pattern_ is specified, only tablespaces whose names match the 
pattern are shown. If + is appended to the command name, each object is listed with its 
associated permissions. 


\dc[S+] [ _pattern_ ] 


Lists conversions between character-set encodings. If _pattern_ is specified, only 
conversions whose names match the pattern are listed. By default, only user-created objects 
are shown; supply a pattern or the s modifier to include system objects. If + is appended 
to the command name, each object is listed with its associated description. 


\dC[+] [ _pattern_ ] 


Lists type casts. If _pattern_ is specified, only casts whose source or target types match 
the pattern are listed. If + is appended to the command name, each object is listed with its 
associated description. 


\dd[S] [ _pattern_ ] 


Shows the descriptions of objects of type constraint , operator class , operator family , 
rule ,and trigger . All other comments may be viewed by the respective backslash 
commands for those object types. 


\dd displays descriptions for objects matching the _pattern_ , or of visible objects of the 
appropriate type if no argument is given. But in either case, only objects that have a 
description are listed. By default, only user-created objects are shown; supply a pattern or 
the s modifier to include system objects. 


Descriptions for objects can be created with the COMMENT SQL command. 
\ddp [ _pattern_ ] 


Lists default access privilege settings. An entry is shown for each role (and schema, if 
applicable) for which the default privilege settings have been changed from the built-in 
defaults. If _pattern_ is specified, only entries whose role name or schema name matches 
the pattern are listed. 


The ALTER DEFAULT PRIVILEGES command is used to set default access privileges. The 
meaning of the privilege display is explained under GRANT. 


\dD[S+] [ _pattern_ ] 


Lists domains. If _pattern_ is specified, only domains whose names match the pattern are 
shown. By default, only user-created objects are shown; supply a pattern or the s modifier 
to include system objects. If + is appended to the command name, each object is listed 
with its associated permissions and description. 


\dE[S+] [ _pattern_ ] \di[S+] [ _pattern_ ] \dm[S+] [ _pattern_ ] \ds[S+] [ 


_pattern_ ] \dt[S+] [ _pattern_ ] \dv[S+] [ _pattern_ ] 


In this group of commands, the letters E, i, m, s, t ,and v stand for foreign table, 
index, materialized view, sequence, table, and view, respectively. You can specify any or all 
of these letters, in any order, to obtain a listing of objects of these types. For example, \dit 
lists indexes and tables. If + is appended to the command name, each object is listed with 
its physical size on disk and its associated description, if any. If _pattern_ is specified, only 
objects whose names match the pattern are listed. By default, only user-created objects are 
shown; supply a pattern or the s modifier to include system objects. 


\des[+] [ _pattern_ ] 


Lists foreign servers (mnemonic: "external servers"). If _pattern_ is specified, only those 
servers whose name matches the pattern are listed. If the form \des+ is used, a full 
description of each server is shown, including the server's ACL, type, version, options, and 
description. 


\det[+] [ _pattern_ ] 


Lists foreign tables (mnemonic: "external tables"). If _pattern_ is specified, only entries 
whose table name or schema name matches the pattern are listed. If the form \det+ is 
used, generic options and the foreign table description are also displayed. 


\deu[+] [ _pattern_ ] 


Lists user mappings (mnemonic: "external users"). If _pattern_ is specified, only those 
mappings whose user names match the pattern are listed. If the form \deu+ is used, 
additional information about each mapping is shown. 

Caution 


\deu+ might also display the user name and password of the remote user, so care 
should be taken not to disclose them. 


\dew[+] [ _pattern_ ] 


Lists foreign-data wrappers (mnemonic: "external wrappers"). If _pattern_ is specified, only 
those foreign-data wrappers whose name matches the pattern are listed. If the form \dew+ 
is used, the ACL, options, and description of the foreign-data wrapper are also shown. 


\df[antwS+] [ _pattern_ ] 


Lists functions, together with their arguments, return types, and function types, which are 
classified as "agg" (aggregate), "normal", "trigger", or "window". To display only functions of 
specific type(s), add the corresponding letters a, n, t ,Or w to the command. If 
_pattern_ is specified, only functions whose names match the pattern are shown. If the 
form \df+ is used, additional information about each function, including security, volatility, 
language, source code and description, is shown. By default, only user-created objects are 
shown; supply a pattern or the s modifier to include system objects. 


Tip: To look up functions taking arguments or returning values of a specific type, use 
your pagers search capability to scroll through the \df output. 


\dF[+] [ _pattern_ ] 


Lists text search configurations. If _pattern_ is specified, only configurations whose names 
match the pattern are shown. If the form \dF+ is used, a full description of each 
configuration is shown, including the underlying text search parser and the dictionary list for 
each parser token type. 


\dFd[+] [ _pattern_ ] 


Lists text search dictionaries. If _pattern_ is specified, only dictionaries whose names 
match the pattern are shown. If the form \dFd+ is used, additional information is shown 
about each selected dictionary, including the underlying text search template and the option 
values. 


\dFp[+] [ _pattern_ ] 


Lists text search parsers. If _pattern_ is specified, only parsers whose names match the 
pattern are shown. If the form \dFp+ is used, a full description of each parser is shown, 
including the underlying functions and the list of recognized token types. 


\dFt[+] [ _pattern_ ] 


Lists text search templates. If _pattern_ is specified, only templates whose names match 
the pattern are shown. If the form \dFt+ is used, additional information is shown about 
each template, including the underlying function names. 


\dg[+] [ _pattern_ | 


Lists database roles. (Since the concepts of "users" and "groups" have been unified into 
"roles", this command is now equivalent to \du .) If _pattern_ is specified, only those roles 
whose names match the pattern are listed. If the form \dg+ is used, additional information 
is shown about each role; currently this adds the comment for each role. 


\d1 
This is an alias for \1o_list , which shows a list of large objects. 
\dL[St+] [ _pattern_ ] 


Lists procedural languages. If _pattern_ is specified, only languages whose names match 
the pattern are listed. By default, only user-created languages are shown; supply the s 
modifier to include system objects. If + is appended to the command name, each language 
is listed with its call handler, validator, access privileges, and whether it is a system object. 


\dn[St+] [ _pattern_ ] 


Lists schemas (namespaces). If _pattern_ is specified, only schemas whose names match 
the pattern are listed. By default, only user-created objects are shown; supply a pattern or 
the s modifier to include system objects. If + is appended to the command name, each 
object is listed with its associated permissions and description, if any. 


\do[S] [ _pattern_ ] 


Lists operators with their operand and return types. If _pattern_ is specified, only operators 
whose names match the pattern are listed. By default, only user-created objects are shown; 
supply a pattern or the s modifier to include system objects. 


\do[S+] [ _pattern_ ] 


Lists collations. If _pattern_ is specified, only collations whose names match the pattern 
are listed. By default, only user-created objects are shown; supply a pattern or the s 
modifier to include system objects. If + is appended to the command name, each collation 
is listed with its associated description, if any. Note that only collations usable with the 
current database's encoding are shown, so the results may vary in different databases of the 
same installation. 


\dp [ _pattern_ ] 


Lists tables, views and sequences with their associated access privileges. If _pattern_ is 
specified, only tables, views and sequences whose names match the pattern are listed. 


The GRANT and REVOKE commands are used to set access privileges. The meaning of 
the privilege display is explained under GRANT. 


\drds [ _role-pattern_ [ _database-pattern_ ]] 


Lists defined configuration settings. These settings can be role-specific, database-specific, 
or both. _role-pattern_ and _database-pattern_ are used to select specific roles and 
databases to list, respectively. If omitted, or if * is specified, all settings are listed, including 
those not role-specific or database-specific, respectively. 


The ALTER ROLE and ALTER DATABASE commands are used to define per-role and per- 
database configuration settings. 


\dT[S+] [ _pattern_ ] 


Lists data types. If _pattern_ is specified, only types whose names match the pattern are 
listed. If + is appended to the command name, each type is listed with its internal name 
and size, its allowed values if itis an enum type, and its associated permissions. By default, 
only user-created objects are shown; supply a pattern or the s modifier to include system 
objects. 


\du[+] [ _pattern_ ] 


Lists database roles. (Since the concepts of "users" and "groups" have been unified into 
"roles", this command is now equivalent to \dg .) If _pattern_ is specified, only those roles 
whose names match the pattern are listed. If the form \du+ is used, additional information 
is shown about each role; currently this adds the comment for each role. 


\dx[+] [ _pattern_ ] 


Lists installed extensions. If _pattern_ is specified, only those extensions whose names 
match the pattern are listed. If the form \dx+ is used, all the objects belonging to each 
matching extension are listed. 


\dy[+] [ _pattern_ | 


Lists event triggers. If _pattern_ is specified, only those event triggers whose names match 
the pattern are listed. If + is appended to the command name, each object is listed with its 
associated description. 


\e Or \edit [ ”filename ][ _line_number_ ] 





If _filename_ is specified, the file is edited; after the editor exits, its content is copied back 
to the query buffer. If no _filename_ is given, the current query buffer is copied to a 
temporary file which is then edited in the same fashion. 


The new query buffer is then re-parsed according to the normal rules of psql, where the 
whole buffer is treated as a single line. (Thus you cannot make scripts this way. Use \i for 
that.) This means that if the query ends with (or contains) a semicolon, it is immediately 
executed. Otherwise it will merely wait in the query buffer; type semicolon or \g to send it, 
or \r to cancel. 


If a line number is specified, psql will position the cursor on the specified line of the file or 
query buffer. Note that if a single all-digits argument is given, psql assumes it is a line 
number, not a file name. 


Tip: See under Environment for how to configure and customize your editor. 
\echo _text_ [... ] 


Prints the arguments to the standard output, separated by one space and followed by a 
newline. This can be useful to intersperse information in the output of scripts. For example: 


=&gt; &lt;kbd class="literal"&gt;\echo “date &lt;/kbd&gt; 
Tue Oct 26 21:40:57 CEST 1999 


If the first argument is an unquoted -n the trailing newline is not written. 


Tip: If you use the \o command to redirect your query output you might wish to use 
\gecho instead of this command. 


\ef [ ~°_function_description_ [ _line_number_ ] ] 





This command fetches and edits the definition of the named function, in the form of a 

CREATE OR REPLACE FUNCTION command. Editing is done in the same way as for \edit . After 
the editor exits, the updated command waits in the query buffer; type semicolon or \g to 
send it, or \r to cancel. 


The target function can be specified by name alone, or by name and arguments, for example 
foo(integer, text) . The argument types must be given if there is more than one function of 
the same name. 


If no function is specified, a blank create FUNCTION template is presented for editing. 


If a line number is specified, psql will position the cursor on the specified line of the function 
body. (Note that the function body typically does not begin on the first line of the file.) 


Tip: See under Environment for how to configure and customize your editor. 
\encoding [ _encoding_ ] 


Sets the client character set encoding. Without an argument, this command shows the 
current encoding. 


\f [ _string_ ] 


Sets the field separator for unaligned query output. The default is the vertical bar ( | ). See 
also \pset fora generic way of setting output options. 


\g [{ _filename_ | |**_command_ }] 


Sends the current query input buffer to the server and optionally stores the query's output in 
_filename_ or pipes the output into a separate Unix shell executing _command_ . The file or 
command is written to only if the query successfully returns zero or more tuples, not if the 
query fails or is a non-data-returning SQL command. 


Abare \g is essentially equivalent to a semicolon. A \g with argument is a "one-shot" 
alternative to the \o command. 


\gset [ _prefix_ ] 


Sends the current query input buffer to the server and stores the query's output into psql 
variables (see Variables). The query to be executed must return exactly one row. Each 
column of the row is stored into a separate variable, named the same as the column. For 
example: 


=&gt; &lt;kbd class="literal"&gt;SELECT 'hello' AS vari, 10 AS var2&lt;/kbd&gt; 
-&gt; &lt;kbd class="literal"&gt;\gset&lt;/kbd&gt; 

=&gt; &lt;kbd class="literal"&gt;\echo :Var1 :var2&lt;/kbd&gt; 

hello 10 


If you specify a _prefix_ , that string is prepended to the query's column names to create 
the variable names to use: 


=&gt; &lt;kbd class="literal"&gt;SELECT 'hello' AS vari, 10 AS var2&lt;/kbd&gt; 
-&gt; &lt;kbd class="literal"&gt;\gset result_&lt;/kbd&gt; 

=&gt; &lt;kbd class="literal"&gt;\echo :result_vari :result_var2&lt;/kbd&gt; 
hello 10 


If a column result is NULL, the corresponding variable is unset rather than being set. 
If the query fails or does not return one row, no variables are changed. 
\h Or \help [  _command_ ] 


Gives syntax help on the specified SQL command. If _command_ is not specified, then psql 
will list all the commands for which syntax help is available. If _command_ is an asterisk ( * ), 
then syntax help on all SQL commands is shown. 


Note: To simplify typing, commands that consists of several words do not have to be 
quoted. Thus it is fine to type <kbd class="literal">\help alter table</kbd>. 
\H 
Turns on HTML query output format. If the HTML format is already on, it is switched back to 


the default aligned text format. This command is for compatibility and convenience, but see 
\pset about setting other output options. 


\i _filename_ 


Reads input from the file _filename_ and executes it as though it had been typed on the 
keyboard. 


Note: If you want to see the lines on the screen as they are read you must set the 
variable EcHo to all. 


\ir _filename_ 


The \ir command is similar to \i , but resolves relative file names differently. When 
executing in interactive mode, the two commands behave identically. However, when 
invoked from a script, \ir interprets file names relative to the directory in which the script is 
located, rather than the current working directory. 


\l[+] Or \list[+] [ _pattern_ ] 


List the databases in the server and show their names, owners, character set encodings, 
and access privileges. If _pattern_ is specified, only databases whose names match the 
pattern are listed. If + is appended to the command name, database sizes, default 
tablespaces, and descriptions are also displayed. (Size information is only available for 
databases that the current user can connect to.) 


\lo_export _loid_ _filename_ 


Reads the large object with OID _1oid_ from the database and writes it to _filename_. 
Note that this is subtly different from the server function 10_export , which acts with the 
permissions of the user that the database server runs as and on the server's file system. 


Tip: Use \lo_list to find out the large object's OID. 
\lo_import _filename_ [| _comment_ ] 


Stores the file into a PostgreSQL large object. Optionally, it associates the given comment 
with the object. Example: 


foo=&gt; &lt;kbd class="literal"&gt;\lo_import '/home/peter/pictures/photo.xcf' 'a pictur 
lo_import 152801 


EE) 





The response indicates that the large object received object ID 152801, which can be used 
to access the newly-created large object in the future. For the sake of readability, it is 
recommended to always associate a human-readable comment with every object. Both 
OIDs and comments can be viewed with the \lo_list command. 


Note that this command is subtly different from the server-side lo_import because it acts 
as the local user on the local file system, rather than the server's user and file system. 


\lo_list 


Shows a list of all PostgreSQL large objects currently stored in the database, along with any 
comments provided for them. 


\lo_unlink _loid_ 

Deletes the large object with OID _1loid_ from the database. 
Tip: Use \1lo_list to find out the large object's OID. 

\o [{ _filename_ | |°°_command_ }] 


Saves future query results to the file _filename_ or pipes future results into a separate Unix 
shell to execute _command_ . If no arguments are specified, the query output will be reset to 
the standard output. 


"Query results" includes all tables, command responses, and notices obtained from the 
database server, as well as output of various backslash commands that query the database 
(such as \d ), but not error messages. 

Tip: To intersperse text output in between query results, use \qgecho . 


\p 
Print the current query buffer to the standard output. 
\password [ _username_ ] 


Changes the password of the specified user (by default, the current user). This command 
prompts for the new password, encrypts it, and sends it to the server as an ALTER ROLE 
command. This makes sure that the new password does not appear in cleartext in the 
command history, the server log, or elsewhere. 





\prompt [ _text_ ] _name 


Prompts the user to supply text, which is assigned to the variable _name_ . An optional 
prompt string, _text_ , can be specified. (For multiword prompts, surround the text with 
single quotes.) 


By default, \prompt uses the terminal for input and output. However, if the -f command 
line switch was used, \prompt uses standard input and standard output. 


\pset _option_ [ _value_ ] 





This command sets options affecting the output of query result tables. _option_ indicates 
which option is to be set. The semantics of _value_ vary depending on the selected option. 
For some options, omitting _value_ causes the option to be toggled or unset, as described 
under the particular option. If no such behavior is mentioned, then omitting _value_ just 
results in the current setting being displayed. 


Adjustable printing options are: 


border 


The _value_ must be a number. In general, the higher the number the more borders and 
lines the tables will have, but this depends on the particular format. In HTML format, this will 
translate directly into the border=... attribute; in the other formats only values 0 (no 
border), 1 (internal dividing lines), and 2 (table frame) make sense. latex and 

latex-longtable also supporta border value of 3 which adds a dividing line between each 
row. 


columns 


Sets the target width for the wrapped format, and also the width limit for determining 
whether output is wide enough to require the pager or switch to the vertical display in 
expanded auto mode. Zero (the default) causes the target width to be controlled by the 
environment variable coLumns , or the detected screen width if coLumns is not set. In 
addition, if columns is zero then the wrapped format only affects screen output. If columns 
is nonzero then file and pipe output is wrapped to that width as well. 


expanded (or x ) 


If _value_ is specified it must be either on or off , which will enable or disable expanded 
mode, or auto .上 _value_ is omitted the command toggles between the on and off 
settings. When expanded mode is enabled, query results are displayed in two columns, with 
the column name on the left and the data on the right. This mode is useful if the data 
wouldn't fit on the screen in the normal "horizontal" mode. In the auto setting, the expanded 
mode is used whenever the query output is wider than the screen, otherwise the regular 
mode is used. The auto setting is only effective in the aligned and wrapped formats. In other 
formats, it always behaves as if the expanded mode is off. 


fieldsep 


Specifies the field separator to be used in unaligned output format. That way one can create, 
for example, tab- or comma-separated output, which other programs might prefer. To set a 
tab as field separator, type \pset fieldsep '\t' . The default field separatoris '|' (a 
vertical bar). 


fieldsep_zero 


Sets the field separator to use in unaligned output format to a zero byte. 


footer 


If _value_ is specified it must be either on or off which will enable or disable display of 


the table footer (the (**_n_ rows) count). If _value_ is omitted the command toggles 


footer display on or off. 


format 


Sets the output format to one of unaligned , aligned , wrapped , html , latex (uses 
tabular ), latex-longtable , or troff-ms . Unique abbreviations are allowed. (That would 
mean one letter is enough.) 


unaligned format writes all columns of a row on one line, separated by the currently active 
field separator. This is useful for creating output that might be intended to be read in by other 
programs (for example, tab-separated or comma-separated format). 


aligned format is the standard, human-readable, nicely formatted text output; this is the 
default. 


wrapped format is like aligned but wraps wide data values across lines to make the output 
fit in the target column width. The target width is determined as described under the 

columns option. Note that psql will not attempt to wrap column header titles; therefore, 

wrapped format behaves the same as aligned if the total width needed for column headers 
exceeds the target. 


The html , latex , latex-longtable , and troff-ms formats put out tables that are 

intended to be included in documents using the respective mark-up language. They are not 

complete documents! This might not be necessary in HTML, but in LaTeX you must have a 

complete document wrapper. latex-longtable also requires the LaTeX longtable and 
booktabs packages. 


linestyle 


Sets the border line drawing style to one of ascii , old-ascii Or unicode . Unique 
abbreviations are allowed. (That would mean one letter is enough.) The default setting is 
ascii . This option only affects the aligned and wrapped output formats. 


ascii Style uses plain ASCII characters. Newlines in data are shown using a + symbol in 
the right-hand margin. When the wrapped format wraps data from one line to the next 
without a newline character, a dot ( . ) is shown in the right-hand margin of the first line, and 
again in the left-hand margin of the following line. 


old-ascii style uses plain ASCII characters, using the formatting style used in PostgreSQL 
8.4 and earlier. Newlines in data are shown using a : symbol in place of the left-hand 
column separator. When the data is wrapped from one line to the next without a newline 
character,a ; symbol is used in place of the left-hand column separator. 


unicode style uses Unicode box-drawing characters. Newlines in data are shown using a 
carriage return symbol in the right-hand margin. When the data is wrapped from one line to 
the next without a newline character, an ellipsis symbol is shown in the right-hand margin of 
the first line, and again in the left-hand margin of the following line. 


When the border setting is greater than zero, this option also determines the characters 
with which the border lines are drawn. Plain ASCII characters work everywhere, but Unicode 
characters look nicer on displays that recognize them. 


null 


Sets the string to be printed in place of a null value. The default is to print nothing, which can 
easily be mistaken for an empty string. For example, one might prefer \pset null '(null)' . 


numericlocale 


If _value_ is specified it must be either on or off which will enable or disable display of 
a locale-specific character to separate groups of digits to the left of the decimal marker. If 
_value_ is omitted the command toggles between regular and locale-specific numeric 
output. 


pager 


Controls use of a pager program for query and psql help output. If the environment variable 
PAGER is Set, the output is piped to the specified program. Otherwise a platform-dependent 
default (Such as more ) is used. 


When the pager optionis off , the pager program is not used. When the pager option is 

on , the pager is used when appropriate, i.e., when the output is to a terminal and will not fit 
on the screen. The pager option can also be set to always , which causes the pager to be 
used for all terminal output regardless of whether it fits on the screen. \pset pager without 
a _value_ toggles pager use on and off. 


recordsep 
Specifies the record (line) separator to use in unaligned output format. The default is a 
newline character. 


recordsep_zero 
Sets the record separator to use in unaligned output format to a zero byte. 
tableattr (or T ) 


In HTML format, this specifies attributes to be placed inside the table tag. This could for 
example be cellpadding Or bgcolor . Note that you probably don't want to specify border 
here, as that is already taken care of by \pset border . If no _value_ is given, the table 
attributes are unset. 


In latex-longtable format, this controls the proportional width of each column containing a 
left-aligned data type. It is specified as a whitespace-separated list of values, e.g. 
'9.2 0.2 0.6' . Unspecified output columns use the last specified value. 


title 


Sets the table title for any subsequently printed tables. This can be used to give your output 
descriptive tags. If no _value_ is given, the title is unset. 


tuples_only (or t ) 


If _value_ is specified it must be either on or off which will enable or disable tuples-only 
mode. If _value_ is omitted the command toggles between regular and tuples-only output. 
Regular output includes extra information such as column headers, titles, and various 
footers. In tuples-only mode, only actual table data is shown. 


Illustrations of how these different formats look can be seen in the Examples section. 


Tip: There are various shortcut commands for \pset . See \a, \C, W, \t, V, 
and \x. 


Note: It is an error to call \pset without any arguments. In the future this case might 
show the current status of all printing options. 


\q Or \quit 
Quits the psql program. In a script file, only execution of that script is terminated. 
\gecho _text_ [... ] 


This command is identical to \echo except that the output will be written to the query output 
channel, as set by \o. 


\r 
Resets (clears) the query buffer. 
\s [ _filename_ ] 


Print or save the command line history to _filename_ . If _filename_ is omitted, the history 
is written to the standard output. This option is only available if psql is configured to use the 
GNU Readline library. 


\set [ name_ [ _value_ [...]]] 








Sets the psql variable _name_ to _value_ , or if more than one value is given, to the 
concatenation of all of them. If only one argument is given, the variable is set with an empty 
value. To unset a variable, use the \unset command. 


\set without any arguments displays the names and values of all currently-set psql 
variables. 


Valid variable names can contain letters, digits, and underscores. See the section Variables 
below for details. Variable names are case-sensitive. 


Although you are welcome to set any variable to anything you want, psql treats several 
variables as special. They are documented in the section about variables. 


Note: This command is unrelated to the SQL command SET. 





\setenv [ _name_ [ _value_ ] ] 


Sets the environment variable _name_ to _value_ , or ifthe _value_ is not supplied, unsets 





the environment variable. Example: 


testdb=&gt; &lt;kbd class="literal"&gt;\setenv PAGER less&lt;/kbd&gt; 
testdb=&gt; &lt;kbd class="literal"&gt;\setenv LESS -imx4F&lt;/kbd&gt; 


\sf[+] _function_description_ 


This command fetches and shows the definition of the named function, in the form of a 
CREATE OR REPLACE FUNCTION command. The definition is printed to the current query output 
channel, as set by `o. 


The target function can be specified by name alone, or by name and arguments, for example 
foo(integer, text) . The argument types must be given if there is more than one function of 
the same name. 


If + is appended to the command name, then the output lines are numbered, with the first 
line of the function body being line 1. 


\t 


Toggles the display of output column name headings and row count footer. This command is 
equivalent to \pset tuples_only and is provided for convenience. 


\T _table_options_ 


Specifies attributes to be placed within the table tag in HTML output format. This 
command is equivalent to \pset tableattr _table_options_. 


\timing [ _on_ | _off_ ] 


Without parameter, toggles a display of how long each SQL statement takes, in milliseconds. 
With parameter, sets same. 


\unset _name_ 
Unsets (deletes) the psql variable _name . 
\w _filename_ \w | command 


Outputs the current query buffer to the file _filename_ or pipes it to the Unix command 


_command_ . 


\watch [ _seconds_ ] 


Repeatedly execute the current query buffer (like \g ) until interrupted or the query fails. 
Wait the specified number of seconds (default 2) between executions. 


\x[ on | _ off | _auto | 





Sets or toggles expanded table formatting mode. As such it is equivalent to \pset expanded . 
\z [ _pattern | 


Lists tables, views and sequences with their associated access privileges. Ifa _pattern_ is 
specified, only tables, views and sequences whose names match the pattern are listed. 


This is an alias for \dp ("display privileges"). 
\! [  _command_ ] 


Escapes to a separate Unix shell or executes the Unix command _command_ . The 
arguments are not further interpreted; the shell will see them as-is. In particular, the variable 
substitution rules and backslash escapes do not apply. 


\? 


Shows help information about the backslash commands. 


Patterns 


The various \d commands accepta _pattern_ parameter to specify the object name(s) to 
be displayed. In the simplest case, a pattern is just the exact name of the object. The 
characters within a pattern are normally folded to lower case, just as in SQL names; for 
example, \dt Foo will display the table named foo . As in SQL names, placing double 
quotes around a pattern stops folding to lower case. Should you need to include an actual 
double quote character in a pattern, write it as a pair of double quotes within a double-quote 
sequence; again this is in accord with the rules for SQL quoted identifiers. For example, 

\dt "Foo""BAR" will display the table named Foo"BAR (not foo"bar ). Unlike the normal 
rules for SQL names, you can put double quotes around just part of a pattern, for instance 

\dt FOOo"FOo"BAR will display the table named fooFoobar . 


Whenever the _pattern_ parameter is omitted completely, the \d commands display all 
objects that are visible in the current schema search path — this is equivalent to using * 
as the pattern. (An object is said to be visible if its containing schema is in the search path 
and no object of the same kind and name appears earlier in the search path. This is 
equivalent to the statement that the object can be referenced by name without explicit 
schema qualification.) To see all objects in the database regardless of visibility, use *.* as 
the pattern. 


Within a pattern, * matches any sequence of characters (including no characters) and ? 
matches any single character. (This notation is comparable to Unix shell file name patterns.) 
For example, \dt int* displays tables whose names begin with int . But within double 
quotes, * and ? lose these special meanings and are just matched literally. 


A pattern that contains a dot ( . ) is interpreted as a schema name pattern followed by an 
object name pattern. For example, \dt foo*.*bar* displays all tables whose table name 
includes bar that are in schemas whose schema name starts with foo . When no dot 
appears, then the pattern matches only objects that are visible in the current schema search 
path. Again, a dot within double quotes loses its special meaning and is matched literally. 


Advanced users can use regular-expression notations such as character classes, for 
example [0-9] to match any digit. All regular expression special characters work as 
specified in Section 9.7.3, except for . which is taken as a separator as mentioned above, 
* which is translated to the regular-expression notation .* , ? which is translated to . , 
and $ which is matched literally. You can emulate these pattern characters at need by 
writing ? for ., (°*_R_+|)for R ,or C`- R_]|) for R ?. $ isnotneeded asa 
regular-expression character since the pattern must match the whole name, unlike the usual 
interpretation of regular expressions (in other words, $ is automatically appended to your 
pattern). Write 
“at the beginning and/or end if you don't wish the pattern to be anchored. Note that withir 


\do’). 


Advanced Features 


Variables 


psql provides variable substitution features similar to common Unix command shells. 
Variables are simply name/value pairs, where the value can be any string of any length. The 
name must consist of letters (including non-Latin letters), digits, and underscores. 


To set a variable, use the psdl meta-command \set . For example, 


testdb=> <kbd class="literal">\set foo bar</kbd> 


sets the variable foo to the value bar . To retrieve the content of the variable, precede the 
name with a colon, for example: 


testdb=> <kbd class="literal">\echo :foo</kbd> 
bar 


This works in both regular SQL commands and meta-commands; there is more detail in SQL 
Interpolation, below. 


If you call \set without a second argument, the variable is set, with an empty string as 
value. To unset (i.e., delete) a variable, use the command \unset . To show the values of all 
variables, call \set without any argument. 


Note: The arguments of \set are subject to the same substitution rules as with other 
commands. Thus you can construct interesting references such as 

\set :foo 'something' and get "soft links" or "variable variables" of Perl or PHP fame, 
respectively. Unfortunately (or fortunately?), there is no way to do anything useful with 
these constructs. On the other hand, \set bar :foo is a perfectly valid way to copy a 


variable. 


A number of these variables are treated specially by psql. They represent certain option 
settings that can be changed at run time by altering the value of the variable, or in some 
cases represent changeable state of psql. Although you can use these variables for other 
purposes, this is not recommended, as the program behavior might grow really strange 
really quickly. By convention, all specially treated variables' names consist of all upper-case 
ASCII letters (and possibly digits and underscores). To ensure maximum compatibility in the 
future, avoid using such variable names for your own purposes. A list of all specially treated 
variables follows. 


AUTOCOMMIT 


When on (the default), each SQL command is automatically committed upon successful 
completion. To postpone commit in this mode, you must enter a BEGIN or 

START TRANSACTION SQL command. When off or unset, SQL commands are not 
committed until you explicitly issue commit or enp . The autocommit-off mode works by 
issuing an implicit BEGIN for you, just before any command that is not already in a 
transaction block and is not itself a BEGIN or other transaction-control command, nor a 
command that cannot be executed inside a transaction block (Such as vacuum ). 


Note: In autocommit-off mode, you must explicitly abandon any failed transaction by 
entering ABORT Or ROLLBACK . Also keep in mind that if you exit the session without 
committing, your work will be lost. 


Note: The autocommit-on mode is PostgreSQL's traditional behavior, but autocommit- 
off is closer to the SQL spec. If you prefer autocommit-off, you might wish to set it in the 
system-wide psqlrc file or your ~/.psqirc file. 


COMP_KEYWORD_CASE 
Determines which letter case to use when completing an SQL key word. If set to lower or 


upper , the completed word will be in lower or upper case, respectively. If set to 
preserve-lower Or preserve-upper (the default), the completed word will be in the case of 


the word already entered, but words being completed without anything entered will be in 
lower or upper case, respectively. 


DBNAME 


The name of the database you are currently connected to. This is set every time you 
connect to a database (including program start-up), but can be unset. 


ECHO 


If set to ail , all lines entered from the keyboard or from a script are written to the standard 
output before they are parsed or executed. To select this behavior on program start-up, use 
the switch -a .Ifsetto queries , psql merely prints all queries as they are sent to the 
server. The switch for this is -e . 


ECHO_HIDDEN 


When this variable is set and a backslash command queries the database, the query is first 
shown. This way you can study the PostgreSQL internals and provide similar functionality in 
your own programs. (To select this behavior on program start-up, use the switch -e .) If you 
set the variable to the value noexec , the queries are just shown but are not actually sent to 
the server and executed. 


ENCODING 


The current client character set encoding. 


FETCH_COUNT 


If this variable is set to an integer value > 0, the results of SELECT queries are fetched and 
displayed in groups of that many rows, rather than the default behavior of collecting the 
entire result set before display. Therefore only a limited amount of memory is used, 
regardless of the size of the result set. Settings of 100 to 1000 are commonly used when 
enabling this feature. Keep in mind that when using this feature, a query might fail after 
having already displayed some rows. 


Tip: Although you can use any output format with this feature, the default aligned 
format tends to look bad because each group of FETCH_couNT rows will be formatted 
separately, leading to varying column widths across the row groups. The other output 
formats work better. 


HISTCONTROL 


If this variable is set to ignorespace , lines which begin with a space are not entered into the 
history list. If set to a value Of ignoredups , lines matching the previous history line are not 
entered. A value of ignoreboth combines the two options. If unset, or if set to any other 
value than those above, all lines read in interactive mode are saved on the history list. 


Note: This feature was shamelessly plagiarized from Bash. 
HISTFILE 


The file name that will be used to store the history list. The default value is ~/.psql_history . 
For example, putting: 


\set HISTFILE ~/.psql_history- :DBNAME 


in ~/.psqirc will cause psql to maintain a separate history for each database. 


Note: This feature was shamelessly plagiarized from Bash. 


HISTSIZE 
The number of commands to store in the command history. The default value is 500. 


Note: This feature was shamelessly plagiarized from Bash. 


HOST 


The database server host you are currently connected to. This is set every time you connect 
to a database (including program start-up), but can be unset. 


IGNOREEOF 


If unset, sending an EOF character (usually Control+D) to an interactive session of psq] will 
terminate the application. If set to a numeric value, that many EOF characters are ignored 
before the application terminates. If the variable is set but has no numeric value, the default 
is 10. 


Note: This feature was shamelessly plagiarized from Bash. 


LASTOID 


The value of the last affected OID, as returned from an INSERT OF \lo_import Command. 
This variable is only guaranteed to be valid until after the result of the next SQL command 
has been displayed. 


ON_ERROR_ROLLBACK 


When on if a statement in a transaction block generates an error, the error is ignored and 
the transaction continues. When interactive , such errors are only ignored in interactive 
sessions, and not when reading script files. When off (the default), a statement ina 
transaction block that generates an error aborts the entire transaction. The 
on_error_rollback-on mode works by issuing an implicit savepornt for you, just before each 
command that is in a transaction block, and rolls back to the savepoint on error. 


ON_ERROR_STOP 


By default, command processing continues after an error. When this variable is set, it will 
instead stop immediately. In interactive mode, psql will return to the command prompt; 
otherwise, psql will exit, returning error code 3 to distinguish this case from fatal error 
conditions, which are reported using error code 1. In either case, any currently running 
scripts (the top-level script, if any, and any other scripts which it may have in invoked) will be 
terminated immediately. If the top-level command string contained multiple SQL commands, 
processing will stop with the current command. 


PORT 


The database server port to which you are currently connected. This is set every time you 
connect to a database (including program start-up), but can be unset. 


PROMPT1 PROMPT2 PROMPTS 


These specify what the prompts psql issues should look like. See Prompting below. 

QUIET 
This variable is equivalent to the command line option -q . It is probably not too useful in 
interactive mode. 


SINGLELINE 


This variable is equivalent to the command line option -s . 


SINGLESTEP 


This variable is equivalent to the command line option -s . 

USER 
The database user you are currently connected as. This is set every time you connect to a 
database (including program start-up), but can be unset. 

VERBOSITY 


This variable can be set to the values default , verbose , Or terse to control the verbosity 
of error reports. 


SQL Interpolation 


A key feature of psql variables is that you can substitute ("interpolate") them into regular SQL 
statements, as well as the arguments of meta-commands. Furthermore, psql provides 
facilities for ensuring that variable values used as SQL literals and identifiers are properly 
quoted. The syntax for interpolating a value without any quoting is to prepend the variable 
name with a colon ( : ). For example, 


testdb=> <kbd class="literal">\set foo 'my_table'</kbd> 
testdb=> <kbd class="literal">SELECT * FROM :foo;</kbd> 


would query the table my_table . Note that this may be unsafe: the value of the variable is 
copied literally, so it can contain unbalanced quotes, or even backslash commands. You 
must make sure that it makes sense where you put it. 


When a value is to be used as an SQL literal or identifier, it is safest to arrange for it to be 
quoted. To quote the value of a variable as an SQL literal, write a colon followed by the 
variable name in single quotes. To quote the value as an SQL identifier, write a colon 
followed by the variable name in double quotes. These constructs deal correctly with quotes 
and other special characters embedded within the variable value. The previous example 
would be more safely written this way: 


testdb=> <kbd class="literal">\set foo 'my_table'</kbd> 
testdb=> <kbd class="literal">SELECT * FROM :"foo";</kbd> 


Variable interpolation will not be performed within quoted SQL literals and identifiers. 
Therefore, a construction such as _':foo' doesn't work to produce a quoted literal from a 
variable's value (and it would be unsafe if it did work, since it wouldn't correctly handle 
quotes embedded in the value). 


One example use of this mechanism is to copy the contents of a file into a table column. 
First load the file into a variable and then interpolate the variable's value as a quoted string: 


testdb=> <kbd class="literal">\set content ‘cat my_file.txt </kbd> 
testdb=> <kbd class="literal">INSERT INTO my_table VALUES (:'content');</kbd> 


(Note that this still won't work if my_file.txt contains NUL bytes. psql does not support 
embedded NUL bytes in variable values.) 


Since colons can legally appear in SQL commands, an apparent attempt at interpolation 
(that is, :name , :'name' ,Or :"name" ) is not replaced unless the named variable is 
currently set. In any case, you can escape a colon with a backslash to protect it from 
substitution. 


The colon syntax for variables is standard SQL for embedded query languages, such as 
ECPG. The colon syntaxes for array slices and type casts are PostgreSQL extensions, 
which can sometimes conflict with the standard usage. The colon-quote syntax for escaping 
a variable's value as an SQL literal or identifier is a psql extension. 


Prompting 


The prompts psql issues can be customized to your preference. The three variables 

PROMPT1 , PROMPT2 , and PROMPT3 contain strings and special escape sequences that 
describe the appearance of the prompt. Prompt 1 is the normal prompt that is issued when 
psql requests a new command. Prompt 2 is issued when more input is expected during 
command input because the command was not terminated with a semicolon or a quote was 
not closed. Prompt 3 is issued when you run an SQL copy command and you are expected 
to type in the row values on the terminal. 


The value of the selected prompt variable is printed literally, except where a percent sign 
( % ) is encountered. Depending on the next character, certain other text is substituted 
instead. Defined substitutions are: 


96M 
The full host name (with domain name) of the database server, or [local] if the connection 


is over a Unix domain socket, or [local:**_/dir/name_ ], if the Unix domain socket is not at 
the compiled in default location. 


%m 
The host name of the database server, truncated at the first dot, or [local] if the 
connection is over a Unix domain socket. 

%&gt; 
The port number at which the database server is listening. 

%n 
The database session user name. (The expansion of this value might change during a 
database session as the result of the command SET SESSION AUTHORIZATION .) 


%/ 


The name of the current database. 

%- 

Like %/ , but the outputis ~ (tilde) if the database is your default database. 

%H 

If the session user is a database superuser, thena # , otherwise a &gt; . (The expansion 


of this value might change during a database session as the result of the command 


SET SESSION AUTHORIZATION .) 


%R 


In prompt 1 normally = , but ^ if in single-line mode, and : if the session is disconnected 
from the database (which can happen if \connect fails). In prompt 2 the sequence is 
replaced by - , * , a single quote, a double quote, or a dollar sign, depending on whether 
psql expects more input because the command wasn't terminated yet, because you are 
inside a /* ... */ comment, or because you are inside a quoted or dollar-escaped string. 
In prompt 3 the sequence doesn't produce anything. 


%X 


Transaction status: an empty string when not in a transaction block, or * when in a 
transaction block, or ! when in a failed transaction block, or 2 when the transaction state 
is indeterminate (for example, because there is no connection). 


%``_digits_ 

The character with the indicated octal code is substituted. 

%:``_name_``: 

The value of the psql variable _name_ . See the section Variables for details. 
“% command `> 

The output of _command_ , similar to ordinary "back-tick" substitution. 

%[ ... %] 


Prompts can contain terminal control characters which, for example, change the color, 
background, or style of the prompt text, or change the title of the terminal window. In order 
for the line editing features of Readline to work properly, these non-printing control 
characters must be designated as invisible by surrounding them with %[ and %] . Multiple 
pairs of these can occur within the prompt. For example: 


testdb=&gt; \set PROMPT1 '%[%033[1; 33; 40m%]%n@%/%R%[%033 [Om%]%H# ' 
results in a boldfaced ( 1; ) yellow-on-black ( 33;40 ) prompt on VT100-compatible, color- 
capable terminals. 


To insert a percent sign into your prompt, write %% . The default prompts are '%/%R%# ' for 
prompts 1 and 2, and ‘agt;agt; ' for prompt 3. 


Note: This feature was shamelessly plagiarized from tcsh. 


Command-Line Editing 


psql supports the Readline library for convenient line editing and retrieval. The command 
history is automatically saved when psql exits and is reloaded when psql starts up. Tab- 
completion is also supported, although the completion logic makes no claim to be an SQL 
parser. The queries generated by tab-completion can also interfere with other SQL 
commands, e.g. SET TRANSACTION ISOLATION LEVEL . If for Some reason you do not like the tab 
completion, you can turn it off by putting this in a file named .inputrc in your home 
directory: 


$if psql 
set disable-completion on 
$endif 


(This is not a psql but a Readline feature. Read its documentation for further details.) 


Environment 


COLUMNS 


If \pset columns is zero, controls the width for the wrapped format and width for 
determining if wide output requires the pager or should be switched to the vertical format in 
expanded auto mode. 


PAGER 
If the query results do not fit on the screen, they are piped through this command. Typical 


values are more or less . The default is platform-dependent. The use of the pager can be 
disabled by using the \pset command. 


PGDATABASE PGHOST PGPORT PGUSER 
Default connection parameters (see Section 31.14). 
PSQL_EDITOR EDITOR VISUAL 


Editor used by the \e and \ef commands. The variables are examined in the order listed; 
the first that is set is used. 


The built-in default editors are vi on Unix systems and notepad.exe on Windows systems. 


PSQL_EDITOR_LINENUMBER_ARG 


When \e or \ef is used with a line number argument, this variable specifies the 
command-line argument used to pass the starting line number to the user's editor. For 
editors such as Emacs or vi, this is a plus sign. Include a trailing space in the value of the 
variable if there needs to be space between the option name and the line number. 
Examples: 


PSQL_EDITOR_LINENUMBER_ARG='+' 
PSQL_EDITOR_LINENUMBER_ARG='--line ' 


The default is + on Unix systems (corresponding to the default editor vi , and useful for 
many other common editors); but there is no default on Windows systems. 


PSQL_HISTORY 


Alternative location for the command history file. Tilde ( ~ ) expansion is performed. 


PSQLRC 


Alternative location of the user's .psqirc file. Tilde ( ~ ) expansion is performed. 


SHELL 


Command executed by the \! command. 


TMPDIR 
Directory for storing temporary files. The default is /tmp . 


This utility, like most other PostgreSQL utilities, also uses the environment variables 
supported by libpq (see Section 31.14). 


Files 


e Unless itis passedan -x or -c option, psql attempts to read and execute commands 


from the system-wide psqlrc file and the user's ~/.psqirc file before starting up. (On 
Windows, the user's startup file is named %APPDATA%\postgresql\psqirc.conf .) See 
_PREFIX_ /share/psqlrc.sample for information on setting up the system-wide file. It 
could be used to set up the client or the server to taste (using the \set and SET 
commands). 


The location of the user's ~/.psqirc file can also be set explicitly via the PSQLRC 
environment setting. 


e Both the system-wide psqirc file and the user's ~/.psqirc file can be made psql- 
version-specific by appending a dash and the PostgreSQL major or minor psql release 
number, for example ~/.psqirc-9.2 Or ~/.psqlirc-9.2.5 . The most specific version- 
matching file will be read in preference to a non-version-specific file. 


e The command-line history is stored in the file ~/.psql_history , or 
%APPDATA%\postgresql\psql_history on Windows. 


The location of the history file can also be set explicitly via the PSQL_HISTORY 
environment setting. 


Notes 


e In an earlier life psql allowed the first argument of a single-letter backslash command to 
start directly after the command, without intervening whitespace. As of PostgreSQL 8.4 
this is no longer allowed. 


e psql works best with servers of the same or an older major version. Backslash 
commands are particularly likely to fail if the server is of a newer version than psq| itself. 
However, backslash commands of the \d family should work with servers of versions 
back to 7.4, though not necessarily with servers newer than psq| itself. The general 
functionality of running SQL commands and displaying query results should also work 
with servers of a newer major version, but this cannot be guaranteed in all cases. 


If you want to use psql to connect to several servers of different major versions, it is 
recommended that you use the newest version of psql. Alternatively, you can keep a 
copy of psql from each major version around and be sure to use the version that 
matches the respective server. But in practice, this additional complication should not be 
necessary. 


Notes for Windows Users 


psql is built as a "console application". Since the Windows console windows use a different 
encoding than the rest of the system, you must take special care when using 8-bit 
characters within psql. If psql detects a problematic console code page, it will warn you at 
startup. To change the console code page, two things are necessary: 


e Set the code page by entering <kbd class="literal">cmd.exe /c chcp 1252</kbd>. (1252 
is a code page that is appropriate for German; replace it with your value.) If you are 
using Cygwin, you can put this command in /etc/profile . 


e Set the console font to Lucida Console , because the raster font does not work with the 
ANSI code page. 


Examples 


The first example shows how to spread a command over several lines of input. Notice the 
changing prompt: 


testdb=> <kbd class="literal">CREATE TABLE my_table (</kbd> 

testdb(> <kbd class="literal"> first integer not null default 0,</kbd> 
testdb(> <kbd class="literal"> second text)</kbd> 

testdb-> <kbd class="literal">;</kbd> 

CREATE TABLE 


Now look at the table definition again: 


testdb=> <kbd class="literal">\d my_table</kbd> 
Table "my_table" 
Attribute | Type | Modifier 
+ 


first | integer not null default 0 


second | text 


Now we change the prompt to something more interesting: 


testdb=> <kbd class="literal">\set PROMPT1 '%n@%m %~%R%# '</kbd> 
peter@localhost testdb=> 


Let's assume you have filled the table with data and want to take a look at it: 


peter@localhost testdb=> SELECT * FROM my_table; 
first | second 


Sheeran Ce E 
1 | one 
2 | two 
3 | three 
4 | four 

(4 rows) 


You can display tables in different ways by using the \pset command: 


peter@localhost testdb=> <kbd class="literal">\pset border 2</kbd> 
Border style is 2. 
peter@localhost testdb=> <kbd class="literal">SELECT * FROM my_table;</kbd> 


eee ee + 
| 1 | one | 
| 2 | two | 
| 3 | three | 
| 4 | four | 
diocese omar + 
(4 rows) 


peter@localhost testdb=> <kbd class="literal">\pset border 0</kbd> 

Border style is 0. 

peter@localhost testdb=> <kbd class="literal">SELECT * FROM my_table;</kbd> 
first second 


2 two 

3 three 

4 four 
(4 rows) 


peter@localhost testdb=> <kbd class="literal">\pset border 1</kbd> 

Border style is 1. 

peter@localhost testdb=> <kbd class="literal">\pset format unaligned</kbd> 
Output format is unaligned. 

peter@localhost testdb=> <kbd class="literal">\pset fieldsep ","</kbd> 
Field separator is ",". 

peter@localhost testdb=> <kbd class="literal">\pset tuples_only</kbd> 
Showing only tuples. 

peter@localhost testdb=> <kbd class="literal">SELECT second, first FROM my_table;</kbd> 
one,1 

two, 2 

three, 3 

four,4 


[| 


Alternatively, use the short commands: 


peter@localhost testdb=> <kbd class="literal">\a \t \x</kbd> 

Output format is aligned. 

Tuples only is off. 

Expanded display is on. 

peter@localhost testdb=> <kbd class="literal">SELECT * FROM my_table;</kbd> 


-[ RECORD 1 ]- 
first | 1 
second | one 
-[ RECORD 2 ]- 
first | 2 
second | two 
-[ RECORD 3 ]- 
first | 3 
second | three 
-[ RECORD 4 ]- 
first | 4 


second | four 


reindexdb 


Name 


reindexdb -- 重建 PostgreSQL 数 据 库 索引 


Synopsis 


reindexdb [ _connection-option_...][ --table | -t _table_ ]...[ --index | -i 


_index_ ]...[ _dbname_ ] 


reindexdb [ _connection-option_...] --all | -a 

reindexdb [ _connection-option_...] --system | -s [ _dbname_ ] 
shh 

描述 


reindexdb 是 一 个 重建 数据 库 索 引 的 工具 。 


reindexdb SQL 命令 REINDEX 的 包装 。 因此 ， 用 哪 种 方法 重建 索引 都 一 样 。 


选项 

reindexdb accepts the following command-line arguments: reindexdb 接 受 下 列 命令 行 参 数 : 
-a``--all 

xt ATA Hee EERI. 
[-d] _dbname_  [--dbname=] ~~_dbname_ 


指定 要 重建 素 引 的 数据 库 的 名 字 。 如 果 没 有 指定 并 且 也 没有 使 用 -a (或 --all ) , BAM 
据 库 名 从 环境 变量 PGpATABASE 中 读 取 。 如 果 没 有 设置 环境 变量 ， 那 么 就 使 用 连接 使 用 的 用 户 
名 。 


-e  --echo 
回 显 reindexdb 生 成 并 发 送 给 数据 库 的 命令 。 
-i _index  --index=``_index_ 


仅 对 index, 索引 进行 重建 。 可 以 通过 写 多 个 -i 选项 重建 多 个 索引 。 


-q --quiet 

不 显示 进程 信息 。 

-s  --system 

对 数据 库 的 系统 表 重 建 素 引 。 

-t _table --table=``_table_ 

仅 对 table RERS. 可 以 通过 宇多 个 -t 选项 给 多 个 表 重 建 索 引 。 
-v --version 

打印 reindexdb 的 版 本 然后 退出 。 

-? --help 


显示 关于 reindexdb 命 合 行 参数 的 帮助 然后 退出 。 


reindexdb 还 接受 下 列 命令 行 参数 作为 连接 参数 : 

-h _host_ --host=``_host_ 

指定 运行 服务 器 的 主机 名 。 如 果 数 值 以 斜 枉 开头 ， 则 被 用 作 到 Unix 域 套 接 字 的 路 径 。 
-p _port --port=``_port_ 


指定 服务 器 正在 侦 听 的 TCP 端口 或 本 地 Unix 域 套 接 字 文件 的 扩展 (描述 符 )。 


-U _username_ --uUsername= ~_username_ 
连接 的 用 户 名 。 
-Ww  --no-password 


从 不 发 出 密码 提示 问题 。 如 果 服 务 器 要 求 密码 认证 并 且 密 码 不 可 用 于 其 他 意思 如 .pgpass 文 
件 ， 则 连接 尝试 将 会 失败 。 该 选项 在 批量 工作 和 不 存在 用 户 输入 密码 的 脚本 中 很 有 帮助 。 


-W --password 
强制 reindexdb 在 连接 到 数据 库 之 前 提示 一 个 密码 。 


这 个 选项 从 来 不 是 至 关 重 要 的 ， 因 为 如 果 服 务 器 需求 密码 认证 ， 则 reindexdb 自动 提示 一 个 密 
码 。 不 过 ，reindexdb 将 在 找 出 服务 器 想 要 一 个 密码 上 浪费 一 个 连接 尝试 。 在 某 些 情况 下 ， 值 
得 输入 -w 以 避免 额外 的 连接 尝试。 


--maintenance-db=``_dbname_ 


指定 要 连接 到 的 数据 库 的 名 字 以 发 现 其 他 应 该 重建 索引 的 数据 库 。 如 果 没 有 指定 ， 那么 将 使 
用 postgres 数据 库 ， 如 果 该 数据 库 不 存在 ， 则 使 用 templatel o 


Ir _—F 
环境 变量 
PGDATABASE PGHOST PGPORT PGUSER 
缺 省 连接 参数 


这 个 功用 ， 类 似 大 多 数 其 他 PostgreSQL 实 用 工具 ， 也 使 用 由 libpq 支 持 的 环境 变量 ( 参 
阅 Section 31.14) 。 


如 果 遇 到 麻烦 ， 参 阅 REINDEX 和 psq| 获取 潜在 问题 和 错误 信息 的 论述 。 数 据 库 服务 器 必须 在 
目标 主机 上 和 运行。 同样 ， 任何 libpq 前 端 库 可 获得 的 缺 省 设置 和 环境 变量 都 将 生效 。 


MN 一 
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reindexdb 可 能 需要 多 次 连接 PostgreSQL 服务 器 ， 且 每 次 都 询问 密码 。 此 时 使 
用 ~/.pgpass 文件 将 会 很 方便 。 参见 Section 31.15 获 取 更 多 信息 。 


例子 
重建 数据 库 test 中 的 所 有 索引 : 


<samp class="literal">$</samp> <kbd class="literal">reindexdb test</kbd> 


重建 数据 库 abcd 中 名 为 foo 的 表 上 的 bar 索引 : 


<samp class="literal">$</samp> <kbd class="literal">reindexdb --table foo --index bar abc 





义 见 


REINDEX 


vacuumdb 


Name 


vacuumdb -- 收集 垃圾 并 分 析 一 个 PostgreSQL 数 据 库 


Synopsis 


vacuumdb [ _connection-option ...][ _option_...][ --table | -t _table_ [( _column 


[,---] )] ] …[ _dbname_] 








vacuumdb [ _connection-option_ ...][ _option_...] --all | -a 





vacuumdb 是 一 个 用 于 整理 PostgreSQL 数据 库 的 工具 。vacuumdb 还 将 会 生成 用 于 
PostgreSQL 查 询 优化 器 的 内 部 统计 数据 。 


vacuumdb 是 SQL 命令 VACUUM 的 封装 。 因此 ， 用 哪 种 方法 清理 数据 库 都 一 样 。 


选项 

vacuumdb 接 受 下 列 命令 行 参数 : 
-a``--all 

清理 所 有 数据 库 。 
[-d] _dbname_  [--dbname=] ~ ~_dbname_ 


声明 要 被 清理 或 分 析 的 数据 库 名 称 。 如 果 没 有 声明 这 个 参数 并 且 没 有 使 用 -a 或 --all, BP 
么 从 将 环境 变量 PGpATABASE 里 读 取 数 据 库 名 。 如 果 那 个 也 没有 设置 ， 则 使 用 连接 的 用 户 名 。 


-e --echo 

回 显 vacuumdb 生 成 并 发 送 给 服务 器 的 命令 。 
er er 

执行 "完全 "清理 。 


-F --freeze 


强制 "冻结 "元 组 。 
-q  --quiet 
不 显示 进程 信息 。 


-t _table_ [( _column_ [,...])] --table="*_table_ [( _column_ [,...])] 








只 是 清理 或 分 析 table. 字段 名 称 只 是 在 与 --analyze 或 --analyze-only 选项 联合 使 用 时 
才 需 要 声明 。 可 以 通过 写 多 个 -t 选项 清理 多 个 表 。 

















Tip: 如 果 你 声明 了 要 清理 的 字段 ， 你 可 能 不 得 不 在 shell 上 逃逸 圆 括 弧 ( 见 下 面 的 例子 )。 











-v --verbose 
在 处 理 过 程 中 打印 详细 信息 。 

-v --version 

打印 vacuumdb 版 本 然后 退出 。 

-z --analyze 

计算 用 于 优化 器 的 统计 数据 。 

-Z --analyze-only 

只 计算 用 于 优化 器 的 该 数据 库 的 统计 值 (不 清理 ) 。 


-? --help 


-h _host_  --host=*~_host_ 
指定 运行 服务 器 的 主机 名 。 如 果 数 值 以 斜 枉 开头 ， 则 被 用 作 到 Unix 域 套 接 字 的 路 径 。 
-p _port_  --port=*~_port_ 


指定 服务 器 正在 侦 听 的 TCP 端口 或 本 地 Unix 域 套 接 字 文件 的 扩展 (描述 符 )。 


-U _username_ --username=``_username_ 
连接 的 用 户 名 。 
-Ww  --no-password 


从 不 发 出 密码 提示 问题 。 如 果 服 务 器 要 求 密 码 认 证 并 且 密 码 不 可 用 于 其 他 意思 如 .pgpass X 
件 ， 则 连接 尝试 将 会 失败 。 该 选项 在 批量 工作 和 不 存在 用 户 输 入 密码 的 脚本 中 很 有 帮助 。 


-W --password 
强制 vacuumdb 在 连接 到 数据 库 之 前 提示 一 个 密码 。 


这 个 选项 从 来 不 是 至 关 重 要 的 ， 因 为 如 果 服 务 器 需求 密码 认证 ， 则 vacuumdb 自动 提示 一 个 密 
码 。 不 过 ，vacuumdb 将 在 找 出 服务 器 想 要 一 个 密码 上 浪费 一 个 连接 尝试 。 在 某 些 情况 下 ， 值 
得 输入 -w 以 避免 额外 的 连接 尝试 。 


--maintenance-db=``_dbname_ 


指定 要 连接 到 的 数据 库 的 名 字 以 发 现 其 他 应 该 清理 的 数据 库 。 如 果 没 有 指定 ， 那么 将 使 
FA postgres 数据 库 ， 如 果 该 数据 库 不 存在 ， 则 使 用 templatel o 


_—F 
环境 变量 
PGDATABASE PGHOST PGPORT PGUSER 
缺 省 连接 参数 


这 个 工具 ， 类 似 大 多 数 其 他 PostgreSQL 实 用 工具 ， 也 使 用 由 libpq 支 持 的 环境 变量 ( 参 
阅 Section 31.14) 。 


如 果 出 差错 了 。 参 阅 VACUUM 和 psq| 获取 关于 错误 信息 和 可 能 问题 的 详细 描述 。 数 据 库 服务 
器 必须 在 目标 主机 上 和 运行。 同样 ， 任 何 libpq 前 端 库 可 获得 的 缺 省 设置 和 环境 变量 都 将 生效 。 


MN 
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vacuumdb 可 能 需要 与 PostgreSQL 服务 器 连接 若干 次 ， 每 次 都 询问 口令 。 在 这 种 情况 下 ， 设 
立 一 个 -/.pgpass 文件 是 比较 方便 的 。 参阅 Section 31.15 获 取 更 多 信息 。 


例子 
整理 数据 库 test = 


<samp class="literal">$</samp> <kbd class="literal">vacuumdb test</kbd> 


为 优化 器 清理 和 分 析 一 个 名 为 bigdb 的 数据 库 : 


<samp class="literal">$</samp> <kbd class="literal">vacuumdb --analyze bigdb</kbd> 


清理 数据 库 xyzzy 中 名 为 foo MR, 并 且 为 优化 器 分 析 列 bar 


<samp class="literal">$</samp> <kbd class="literal">vacuumdb --analyze --verbose --table 


«| = _&£ 
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VACUUM 


Ill. PostgreSQL 服务 器 应 用 程序 


这 部 分 包括 PostgreSQL 服 务 器 应 用 和 支持 工具 的 参考 信息 。 这 些 命令 只 能 用 于 在 数据 库 服务 
器 所 在 的 主机 上 运行 。 其 它 工具 程序 在 Reference ll, PostgreSQL 客户 端 应 用 程序 中 列 出 。 


Table of Contents 


initdb -- 创建 一 个 新 的 PostgreSQL 数 据 库 往 (cluster) 
pg_controldata -- 显示 一 个 集群 的 控制 信息 

pg_ctl -- initialize, start, stop, or control a PostgreSQL server 
pg_resetxlog - 重 置 一 个 数据 库 集群 的 预 写 日 志 以 及 其 它 控制 内 容 
postgres -- PostgreSQL 数据 库 服务 器 

postmaster -- PostgreSQL 数据 库 服务 器 


Initdb 
Name 


initdb -- 创建 一 个 新 的 PostgreSQL 数 据 库 簇 (cluster) 


Synopsis 


initdb [ _option_...] [ --pgdata | -D ] _directory_ 


initdb 创建 一 个 新 的 PostgreSQL 数 据 库 得 (cluster) 。 —SMHRE (cluster) 是 由 单个 
服务 端 实例 管理 的 多 个 数据 库 的 集合 。 


创建 数据 库 系 统 包括 创建 数据 库 数 据 的 宿主 目录 ， 生 成 共享 的 系统 表 (不 属于 任何 特定 数据 
库 的 表 ) 和 创建 template 和 postgres 数据 库 。 当 你 以 后 再 创建 一 个 新 数据 库 

时 ， template1 数据 库 里 所 有 内 容 都 会 拷贝 过 来 。 (因此 ， 任何 在 template1 里 面 安装 的 示 
西 都 自动 拷贝 到 以 后 创建 的 数据 库 中 。) postgres 数据 库 是 一 个 缺 省 数据 库 ， 用 于 给 用 户 、 
工具 、 第 三 方 应 用 提供 缺 省 数据 库 。 


尽管 initdb 会 尝试 创建 相应 的 数据 目录 ， 但 经 常会 没有 权限 做 这 件 事 。 因 为 所 要 创建 目录 的 
父 目录 通常 被 root 所 拥有 。 要 初始 化 这 种 设置 ， 用 root 创 建 一 个 空 数据 目录 ， 然 后 用 

chown 把 该 目录 的 所 有 权 交 给 数据 库 用 户 帐 号 ， 然 后 su 成 数据 库 用 户 ， 最 后 以 数据 库 用 户 
身份 运行 initdb 。 


initdb 必须 以 运行 数据 库 服 务 端的 用 户 身份 运行 ， 因为 服务 端 需要 访问 initdb 创建 的 目录 
和 文件 。 因为 服务 端 通常 是 以 非 root 身 份 运行 的 ， 因 此 一 般 也 就 不 以 root 用 户 运行 
initdh (事实 上 将 拒绝 你 以 root 用 户 运行 它 ) 。 


initdb 初始 化 该 数据 库 答 (cluster) 的 缺 省 区 域 和 字符 集 编码 。 字符 编码 排序 ( Lc_coLLATE ) 
和 字符 集 类 ( Lc_cTYPE , 也 就 是 大 写 、 小 写 、 数 字 等 ) 可 以 在 数据 库 创建 的 时 候 独 立 设置 。 
initdb 决定 了 templates RHEE, 这 个 设置 将 成 为 所 有 其 它 ( 以 后 新 建 ) 数据 库 的 缺 省 。 


要 更 改 默认 的 排序 顺序 或 字符 集 分 类 ， 使 用 --lc-collate 和 --lc-ctype 选项 。 使 
用 c 或 posix 之 外 的 字符 编码 排序 还 会 有 性 能 影响 。 因此 在 运行 initdb 的 时 候 就 做 出 正确 
的 选择 是 非常 重要 的 。 


在 服务 端 启动 时 ， 你 可 以 使 用 --locale 设置 缺 省 的 所 有 语言 环境 类 别 ， 包 括 排 序 顺 序 和 字符 
集 种 类 。 其 余 的 语言 环境 类 别 以 后 可 以 修改 。 所 有 服务 器 区 域 值 ( 1c_* ) 可 以 用 show a 显 
示 。 更 多 细节 可 以 在 Section 22.1 找 到 。 


要 修改 缺 省 编码 ， 可 以 使 用 --encoding 选项 。 更 多 细节 可 以 在 Section 22.3 找 到 。 


选项 
-A  _authmethod_~~ --auth=~*~_authmethod_ 


这 个 选项 指定 本 地 用 户 在 pg_hba.conf 里 面 设置 的 认证 方法 。 ( host 和 local 所 在 行 )。 BR 
非 你 信任 所 有 本 地 系统 用 户 。 否则 不 要 使 用 trust 。 trust 是 缺 省 的 。 


--auth-host= ~_authmethod_ 


这 个 选项 指定 本 地 TCP/IP 联 接 用 户 在 pg_hba.conf 里 面 设置 的 认证 方法 。 ( host 所 在 行 )。 
--auth-local=° ~_authmethod_ 


这 个 选项 指定 本 地 Unix-domain socket 联 接 用 户 在 pg_hba.conf 里 面 设置 的 认证 方法 。 
( local 所 在 行 )。 


-D _directory_ --pgdata="~_directory_ 


a Aran (cluster) 应 该 存放 在 哪个 目录 。 这 是 initdb 惟一 (必须 ) 需要 的 信 
息 ， 但 是 你 可 以 通过 设置 《pepATA 环境 变量 来 避免 键入 ， 这 样 做 可 能 方便 一 些 ， 因 为 稍 后 数据 
库 服务 器 ( postgres ) 可 以 通过 同一 个 变量 找到 数据 库 目 录 。 


-E _encoding_ --encoding=*~_encoding_ 


选择 模板 数据 库 的 编码 方式 。 这 将 是 你 以 后 创建 的 数据 库 的 缺 省 编码 方式 ， 除非 你 创建 数据 
库 时 履 盖 了 它 。 缺 省 是 从 区 域 设 置 中 获得 的 ， 如 果 没 有 区 域 设置 ， 就 是 SQLASCII o 
PostgreSQL 服务 器 支持 的 字符 集 在 Section 22.3.1 里 描述 。 


-k  --data-checksums 


使 用 数据 页 产生 校 验 和 ， 以 帮助 MO 系统 ， 否 则 将 静音 检测 损坏 。 启用 校 验 和 可 能 产生 明显 的 
性 能 损失 。 此 选项 只 能 在 初始 化 过 程 中 设置 ， 并 且 以 后 不 能 更 改 。 如 果 设 置 ， 那 么 在 所 有 数 
据 库 中 计算 所 有 对 象 的 校 验 和 。 


--locale=``_locale_ 


00 (cluster) 设置 缺 省 的 区 域 。 如 果 没 有 指定 这 个 选项 ， 那么 区 域 是 从 initdp 运 
行 的 环境 中 继承 过 来 的 。 区 域 设 置 在 Section 22.1 里 描述 。 


--lc-collate="~_locale_ --lc-ctype="*_locale_ --lc-messages=``_locale_ 


--lc-monetary=``_locale_ --lc-numeric=``_locale_ --lc-time=``_locale_ 


类 似 --locale , 但 是 只 设 置 特殊 范 DERRY Ki, 


--no-locale 
相当 于 --locale=C o 
-N  --nosync 


缺 省 情况 下 into 会 等 待 所 有 的 文件 被 安全 地 写 入 到 磁盘 中 。 此 选项 会 导致 initdb 不 进行 
等 待 ， 这 样 更 快 ， 但 意味 着 随后 的 操作 系统 崩溃 可 能 把 数据 目录 损坏 。 


--pwfile="*_filename_ 

D initdb 从 文件 中 读 取 数 据 库 超 级 用 户 的 密码 。 该 文件 的 第 一 行 被 作为 密码 。 
-S  --sync-only 

安全 地 写 入 所 有 数据 库 文件 到 磁盘 然后 退出 。 这 并 不 进行 任何 普通 initdb 操 作 。 
-T _CFG_ --text-search-config=°*_CFG_ 

设置 缺 省 的 文本 搜索 配置 。 见 default text _search_config 了 解 更 多 信息 。 

-U _username --username=``_username_ 


选择 数据 库 超 级 用 户 的 用 户 名 。 缺 省 是 运行 initdb 的 用 户 的 有 效用 户 。 超 级 用 户 的 名 字 是 什 
么 并 不 重要 ， 但 是 可 以 选择 习惯 的 名 字 postgres， 即 使 和 操作 系统 的 用 户 名 不 一 样 也 没 关 
Ro 


-W --pwprompt 


D initdb 提示 输入 数据 库 超级 用 户 的 口令 。 如 果 你 不 准备 使 用 口令 认证 ， 这 个 选项 并 不 重 
要 。 否 则 你 将 不 能 使 用 口令 认证 ， 直 到 你 设置 了 口令 。 


-X _directory_ --xlogdir=``_directory_ 

此 选项 指定 事务 日 志 应 该 存放 在 哪个 目录 。 
其 它 不 常用 的 参数 还 有 : 

-d --debug 


从 初始 化 后 端 打印 调试 输出 以 及 一 些 其 它 的 一 些 普 通用 户 不 太 感 兴 趣 的 信息 。 初始 化 后 端 
是 initdb 用 于 创建 系统 表 的 程序 。 这 个 ; 选项 生成 大 量 非 常 枯燥 的 输出 。 


-L _directory_ 


告诉 initdb 初始 化 数据 库 时 所 需要 的 输入 文件 的 位 置 。 通常 不 需要 。 如 果 需 要 你 明确 指定 的 
话 ， 程 序 会 提示 你 输入 


-n --noclean 


meant, 4 initdb 创建 数据 库 往 (cluster) 时 出 错 ， 它 将 在 检测 到 不 能 结束 工作 之 前 将 其 创 
建 的 所 有 文件 删除 。 这 个 选项 禁止 任何 清理 动作 ， 因 而 对 调试 很 有 用 。 


其 它 参 数 : 
-V --version 


输出 initdb 命 令 的 版 本 信息 ， 然 后 退出 。 
-? --help 


显示 initdb 命 邻 的 帮助 信息 ， 然 后 退出 。 


环境 变量 
PGDATA 
tee RHE EDR (cluster) 存储 的 目录 ; 可 以 使 用 -p 选项 覆盖 。 


此 实用 工具 ， 像 大 多 其 他 的 PostgreSQL 实用 工具 ， 还 使 用 libpq 支 持 的 环境 变量 libpq ( 见 
Section 31.14)。 


NN at 

x 

vt FS 

initdb 还 可 以 通过 调用 pg_ctl initdb . 


另 请 参阅 


pg_ctl, postgres 


pg_controldata 


Name 


pg_controldata -- 显示 一 个 集群 的 控制 信息 


Synopsis 


pg_controldata [ _option_ ][ _datadir_ ] 


HA 
pg_controldata 打印 那些 在 initdb 过 程 中 初始 化 的 信息 ， 比如 表 版 本 。 它 还 显示 有 关 预 写 
日 志和 检查 点 处 理 相关 的 信息 。 这 些 信 息 是 集群 范围 内 有 效 的 ， 并 不 和 某 个 数据 库 相 关 。 


这 个 命令 只 应 该 由 安装 服务 器 的 用 户 运行 ， 因 为 它 要 求 对 数据 目录 的 读 访问 权限 。 你 可 以 在 
命令 行 上 声明 数据 目 录 ， 或 者 使 用 PGDATA 环境 变量 。 这 个 工具 支持 -V 和 --version 选项 ， 
可 以 打印 pg_controldata 的 版 本 然后 退出 。 还 支持 -? 和 --help 选项 ， 输 出 支持 的 参数 。 


环境 变量 
PGDATA 


缺 省 数据 目录 位 置 


pg_ctl 


Name 


pg_ctl -- initialize, start, stop, or control a PostgreSQL server 


Synopsis 
pg_ctl init[db] [ -s ][ -Dp _datadir_][ -o _initdb-options_ ] 


pg_ctl start [ -w][ -t _seconds_][-s][-D datadir ][ -1 _filename_ ][ -o 


_options_][-p _path_][ -c ] 


pg_ctl stop [ -w][-t _seconds_][-s][-D _datadir_][-m s[mart] | frast] | 


i[mmediate] ] 


pg_ctl restart [ -w][ -t _seconds_][-s][-p _datadir_][ -c ][ -m srmart] | 


f[ast] | i[mmediate] ][ -o _options_ | 
pg_ctl reload [-s][-D _datadir_ ] 
pg_ctl status [ -D _datadir_ ] 

pg_ctl promote [ -s ][ -D _datadir_ ] 


pg ctl kill signal_name process_id_ 





pg_ctl register [ -N _servicename_][ -u _username_][ -P _password_ ][ -D 


_datadir_][-S arutol | d[emand] ][ -w][ -t _seconds_][-s ][-o _options_ ] 


pg_ctl unregister [ -N  _servicename_ ] 


Description 


pg_ctl is a utility for initializing a PostgreSQL database cluster, starting, stopping, or 
restarting the PostgreSQL database server (postgres), or displaying the status of a running 
server. Although the server can be started manually, pg_ctl encapsulates tasks such as 
redirecting log output and properly detaching from the terminal and process group. It also 
provides convenient options for controlled shutdown. 


The init Or initdb mode creates a new PostgreSQL database cluster. A database 
cluster is a collection of databases that are managed by a single server instance. This mode 
invokes the initdb command. See initdb for details. 


In start mode, a new server is launched. The server is started in the background, and its 
standard input is attached to /dev/null (or nul on Windows). On Unix-like systems, by 
default, the server's standard output and standard error are sent to pg_ctl's standard output 
(not standard error). The standard output of pg_ctl should then be redirected to a file or 
piped to another process such as a log rotating program like rotatelogs; otherwise postgres 
will write its output to the controlling terminal (from the background) and will not leave the 
shell's process group. On Windows, by default the server's standard output and standard 
error are sent to the terminal. These default behaviors can be changed by using -1 to 
append the server's output to a log file. Use of either -1 or output redirection is 
recommended. 


In stop mode, the server that is running in the specified data directory is shut down. Three 
different shutdown methods can be selected with the -m option. "Smart" mode (the default) 
waits for all active clients to disconnect and any online backup to finish. If the server is in hot 
standby, recovery and streaming replication will be terminated once all clients have 
disconnected. "Fast" mode does not wait for clients to disconnect and will terminate an 
online backup in progress. All active transactions are rolled back and clients are forcibly 
disconnected, then the server is shut down. "Immediate" mode will abort all server 
processes immediately, without a clean shutdown. This will lead to a crash-recovery run on 
the next restart. 


restart mode effectively executes a stop followed by a start. This allows changing the 
postgres Command-line options. restart might fail if relative paths specified were 
specified on the command-line during server start. 


reload mode simply sends the postgres process a SIGHUP signal, causing it to reread its 
configuration files ( postgresql.conf , pg_hba.conf , etc.). This allows changing of 
configuration-file options that do not require a complete restart to take effect. 


status mode checks whether a server is running in the specified data directory. If it is, the 
PID and the command line options that were used to invoke it are displayed. If the server is 
not running, the process returns an exit status of 3. 


In promote mode, the standby server that is running in the specified data directory is 
commanded to exit recovery and begin read-write operations. 


kill mode allows you to send a signal to a specified process. This is particularly valuable 
for Microsoft Windows which does not have a kill command. Use --help to see a list of 
supported signal names. 


register mode allows you to register a system service on Microsoft Windows. The -s 
option allows selection of service start type, either "auto" (start service automatically on 
system startup) or "demand" (start service on demand). 


unregister mode allows you to unregister a system service on Microsoft Windows. This 
undoes the effects of the register command. 


Options 
-c---core-file 


Attempt to allow server crashes to produce core files, on platforms where this is possible, by 
lifting any soft resource limit placed on core files. This is useful in debugging or diagnosing 
problems by allowing a stack trace to be obtained from a failed server process. 


-D _datadir_ --pgdata _datadir_ 


Specifies the file system location of the database configuration files. If this is omitted, the 
environment variable PGDATA is used. 


-1 _filename_ --log _filename_ 


Append the server log output to _filename_ . If the file does not exist, it is created. The 
umask is set to 077, so access to the log file is disallowed to other users by default. 


-m _mode_ --mode _mode_ 


Specifies the shutdown mode. _mode_ canbe smart , fast , Or immediate , or the first 
letter of one of these three. If this is omitted, smart is used. 


-o _options_ 
Specifies options to be passed directly to the postgres command. 


The options should usually be surrounded by single or double quotes to ensure that they are 
passed through as a group. 


-o _initdb-options_ 
Specifies options to be passed directly to the initdb command. 


The options should usually be surrounded by single or double quotes to ensure that they are 
passed through as a group. 


-p _path_ 


Specifies the location of the postgres executable. By default the postgres executable is 
taken from the same directory as _ pg_ct1 , or failing that, the hard-wired installation 
directory. It is not necessary to use this option unless you are doing something unusual and 
get errors that the postgres executable was not found. 


In init mode, this option analogously specifies the location of the initdb executable. 
-S  --silent 
Print only errors, no informational messages. 

-t --timeout 


The maximum number of seconds to wait when waiting for startup or shutdown to complete. 
The default is 60 seconds. 


-V --version 
Print the pg_ctl version and exit. 
-W 


Wait for the startup or shutdown to complete. Waiting is the default option for shutdowns, but 
not startups. When waiting for startup, pg_ct1 repeatedly attempts to connect to the server. 
When waiting for shutdown, pg_ct1 waits for the server to remove its PID file. This option 
allows the entry of an SSL passphrase on startup. pg_ctl returns an exit code based on 
the success of the startup or shutdown. 


-W 


Do not wait for startup or shutdown to complete. This is the default for start and restart 
modes. 


-?  --help 


Show help about pg_ctl command line arguments, and exit. 


Options for Windows 


-N _servicename_ 


Name of the system service to register. The name will be used as both the service name and 
the display name. 


-P  _password_ 
Password for the user to start the service. 


-S _start-type_ 


Start type of the system service to register. start-type can be auto , or demand , or the first 
letter of one of these two. If this is omitted, auto is used. 


-U _username_ 


User name for the user to start the service. For domain users, use the format 


DOMAIN\username 


Environment 


PGDATA 
Default data directory location. 


pg_ctl , like most other PostgreSQL utilities, also uses the environment variables supported 
by libpq (see Section 31.14). For additional server variables, see postgres. 


Files 


postmaster.pid 


The existence of this file in the data directory is used to help pg_ctl determine if the server is 
currently running. 


postmaster.opts 


If this file exists in the data directory, pg_ctl (in restart mode) will pass the contents of the 
file as options to postgres, unless overridden by the -o option. The contents of this file are 
also displayed in status mode. 


Examples 


Starting the Server 
To start the server: 


<samp class="literal">$</samp> <kbd class="literal">pg_ctl start</kbd> 


To start the server, waiting until the server is accepting connections: 


<samp class="literal">$</samp> <kbd class="literal">pg_ctl -w start</kbd> 


To start the server using port 5433, and running without fsync , use: 


<samp class="literal">$</samp> <kbd class="literal">pg_ctl -o "-F -p 5433" start</kbd> 


Stopping the Server 
To stop the server, use: 


<samp class="literal">$</samp> <kbd class="literal">pg_ctl stop</kbd> 


The -m option allows control over how the server shuts down: 


<samp class="literal">$</samp> <kbd class="literal">pg_ctl stop -m fast</kbd> 


Restarting the Server 


Restarting the server is almost equivalent to stopping the server and starting it again, except 
that pg_ctl saves and reuses the command line options that were passed to the previously 
running instance. To restart the server in the simplest form, use: 


<samp class="literal">$</samp> <kbd class="literal">pg_ctl restart</kbd> 


To restart the server, waiting for it to shut down and restart: 


<samp class="literal">$</samp> <kbd class="literal">pg_ctl -w restart</kbd> 


To restart using port 5433, disabling fsync upon restart: 

<samp class="literal">$</samp> <kbd class="literal">pg_ctl -0 "-F -p 5433" restart</kbd> 
[a P A 
Showing the Server Status 
Here is sample status output from pg_ctl: 


<samp class="literal">$</samp> <kbd class="literal">pg_ctl status</kbd> 
<samp class="literal">pg_ctl: server is running (PID: 13718) 
/usr/local/pgsql/bin/postgres "-D" "/usr/local/pgsql/data" "-p" "5433" "-B" "128"</samp> 


rr 有限 | 


This is the command line that would be invoked in restart mode. 


See Also 
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pg_resetxlog 


Name 


pg_resetxlog -- 重 置 一 个 数据 库 集 群 的 预 写 日 志 以 及 其 它 控制 内 容 


Synopsis 


pg_resetxlog [ -f ][ -n][ -o _oid_][-x _ xid ][-e _xid_epoch_][ -m 
mxid_ , _mxid_][ -0 _mxoff_][ -1 _xlogfile_] _datadir_ 





pg_resetxlog 清理 预 写 日 志 (WAL) 并 且 可 以 有 选择 地 重 置 其 它 一 些 存储 在 pg_control 文件 中 
的 控制 信息 。 有 时 候 ， 如 果 这 些 文件 骨 溃 了 ， 就 需要 这 个 功能 。 一 定 只 把 它 用 作 最 后 的 方 
法 ， 就 是 说 只 有 因为 这 样 的 衣 溃 导致 服务 器 无 法 启动 的 时 候 才 使 用 。 


运行 这 个 命令 之 后 ， 可 能 就 可 以 启动 服务 器 了 ， 但 是 ， 一 定 要 记 住 数据 库 可 能 因为 部 分 提交 
的 事务 而 含有 不 完整 的 数据 。 你 应 该 马上 转 储 数据 ， 运行 initdb ， 然 后 重新 加 载 。 在 重新 加 
载 之 后 ， 检查 不 完整 的 部 分 然后 根据 需要 进行 修复 。 


这 个 命 合 只 能 由 安装 服务 器 的 用 户 运行 ， 因 为 它 需要 对 数据 目录 的 读 写 权限 。 出 于 安全 者 
Š, pg_resetxlog 不 使 用 环境 变量 pepATA ， 你 必须 在 命令 行 上 声明 数据 目录 。 


如 果 pg_resetxlog 抱怨 说 它 无 法 判断 用 于 pg_control 的 有 效 数 据 ， 那 么 你 可 以 强制 它 继续 处 
理 ， 方 法 是 声明 -f (强制) 开关 。 在 这 种 情况 下 ， 那 些 丢 失 了 的 数据 将 用 模糊 的 近似 数值 代 
替 。 大 多 数字 段 都 可 以 匹配 上 ， 但 是 下 一 个 OID 、 下 一 个 事务 ID 、 下 一 个 事务 ID 的 
epoch( 时 间 点 )、 下 一 个 多 事务 ID( 两 阶段 提交 的 东西 )、 下 一 个 多 事务 偏 移 量 、WAL 开始 地 
址 可 能 需要 手工 帮助 ， 这 些 字段 可 以 使 用 下 面 讨 论 的 选项 设置 。 如 果 你 不 能 判断 所 有 这 些 字 
段 的 正确 数值 ， 那么 -f 仍然 可 以 使 用 ， 但 是 这 样 恢复 过 来 的 数据 库 正 确 性 更 值得 怀疑 : 立 
即 转 储 和 重新 加 载 是 必须 的 。 在 转 储 之 前 不 要 执行 任何 修改 数据 的 操作 ， 因为 任何 这 样 的 动 
作 都 可 能 把 事情 搞 得 更 糟糕 。 


-0, -x, -e, m, -0, -1 开关 人 允许 手工 设置 下 一 个 OID 、 下 一 个 事务 ID 、 下 一 个 事务 
ID epoch, 下 一 个 和 最 旧 的 多 事务 ID 、 下 一 个 多 事务 偏 移 量 、WAL 起 始 位 置 的 数值 。 只 有 
在 pg_resetxlog 无 法 通过 读 取 pg control 判断 合适 的 数值 的 时 候 才 需要 它 。 安 全 的 数值 可 
以 用 下 面 的 方法 判断 : 


。 对 于 下 一 个 事务 ID( -x ) 而 言 ， 一 个 安全 的 数值 是 看 看 数据 目录 里 的 pg_clog 里 数值 最 
大 的 文件 名 ， 然 后 加 一 ， 然 后 再 乘 上 1048576 。 请 注意 那些 文件 名 是 十 六 进 制 的。 通常 
也 以 十 六 进 制 的 形式 声明 选项 值 是 最 简单 的 。 比如 ， 如 果 0011 是 pg_clog 里 最 大 的 记 
录 ， -x oxi200000 就 可 以 了 (后 面 的 五 个 需 提 供 了 合适 的 乘积 )。 


。 下 一 个 多 事务 ID( -m 的 第 一 部 分 ) 的 安全 值 可 以 通过 查看 数据 目录 里 
pg_multixact/offsets 子 目 录 里 面 的 数字 最 大 的 文件 名 ， 加 一 ， 然后 乘 以 65536 得 到 。 
相反 的 ， 最 老 多 事务 ID ( -mn 的 第 二 部 分 ) 的 安全 值 可 以 通过 查看 相同 目录 里 的 数字 最 
小 的 文件 名 ， 然 后 乘 以 65536 得 到 。 和 上 面 一 样 ， 文 件 名 是 十 六 进 制 的 ， 因 此 最 简单 的 
方法 是 给 选项 声明 一 个 十 六 进 制 的 开关 值 ， 然后 在 结尾 加 四 个 雳 。 


下 一 个 多 事务 偏 移 量 ( -o ) 的 安全 值 可 以 通过 检查 数据 目录 里 pg_multixact/members 子 目 
录 下 的 数字 最 大 的 文件 名 ， 加 一 ， 然后 乘 以 65536 得 到 。 和 上 面 一 样 ， 文 件 名 是 十 六 进 
HN, 这 里 没有 像 上 面 一 样 添加 雪 的 简单 方法 。 


WAL 的 起 始 位 置 ( -1 ) 应 该 比 目 前 存在 于 数据 目录 pg_xlog 里 面 的 任何 WAL 段 文件 号 都 
大 。 它 的 文件 名 也 是 十 六 进 制 的 ， 并 且 有 三 部 分 。 第 一 部 分 是 "时 间 线 1D"， 通 常 应 该 保 
持 相 同 。 上 比如 ， 如 果 o0000001000000320000004A 是 pg_xlog 里 最 大 的 条 目 ， 那么 选 


择 -1 00000001000000320000004B 或 更 多 。 


> Note: pg_resetxlog 本 身 查 看 pg_xlog 里 面 的 文件 ， 并 选择 一 个 缺 省 的 超过 最 后 一 个 
现存 文件 号 的 -1 设置 。 因 此 ， 只 有 知道 WAL 段 文件 当前 不 在 pg_xlog 中 时 ， 才 需要 手 
动 调整 -1 ， 例如 离线 为 档 中 的 条 目 ; 或 如 果 pg_xlog 的 内 容 完 全 丢失 。 


没有 很 容易 的 办 法 来 判断 比 数据 库 中 最 大 的 OID 大 一 号 的 下 一 个 OID ， 不 过 很 走运 的 
是 获取 正确 的 下 一 个 OID 并 非 非常 关键 的 事情 。 


o 除了 由 pg_resetxlog 设 定 的 字段 外 ， 事务 ID epoch 实际 上 并 未 存储 在 数据 库 里 的 任何 
地 方 。 所 以 只 要 是 涉及 到 数据 库 自身 的 任何 数值 都 有 效 。 你 可 能 需要 调整 这 个 值 以 确保 
诸如 Slony-| 之 类 的 备份 系统 能 够 正常 工作 。 如 果 是 这 样 的 话 ， 上 应当 从 下 游 已 复制 的 数据 
库 中 获取 恰当 的 值 。 


-n (无 操作 ) 选 项 指示 pg_resetxlog 打印 从 pg_control 重新 构造 的 数值 然后 不 修改 任何 值 就 
退出 。 这 主要 是 一 个 调试 工具 ， 但 是 在 pg_resetxlog 真正 处 理 前 进行 的 合理 性 检查 的 时 候 可 
能 会 有 用 。 


-v 和 --version 选项 打印 pg_resetxlog 的 版 本 然后 退出 。 选 项 -? 和 --help 显示 参数 的 
支持 信息 然后 退出 。 
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在 服务 器 运行 的 时 候 一 定 不 要 运行 这 个 命令 。 如 果 发 现在 数据 文件 目录 里 有 锁 文 件 ， 那 
4, pg_resetxlog 将 拒绝 启动 。 如 果 服 务 器 崩溃 ， 那么 可 能 会 剩 下 一 个 锁 文 件 ; 如 果 这 样 ， 你 
可 以 删除 该 锁 文 件 以 便 允 许 pg_resetxlog 运行 。 但 是 在 你 这 人 么 做 之 前 ， 一 定 要 确保 没有 任何 


后 端 服务 器 进程 仍 在 运行 。 


postgres 


Name 


postgres -- PostgreSQL 数据 库 服 务 器 


Synopsis 


postgres [ _option ...] 


fia ah 


postgres 是 PostgreSQL 数 据 库 服务 器 。 客户 端 应 用 程序 为 了 访问 数据 库 ， 将 通过 网 络 或 本 
地 连接 到 一 个 运行 中 的 postgres 进程 。 然 后 该 postgres 实例 将 启动 一 个 独立 的 服务 器 进程 
来 处 理 这 个 连接 。 


一 个 postgres 总 是 管理 来 自 同一 个 数据 库 集群 的 数据 。 一 个 数据 库 集 群 是 一 组 在 同一 个 文件 
系统 位 置 ("数据 区 ") 存 放 数 据 的 数据 库 。 一 个 系统 上 可 以 同时 运行 多 个 postgres 进程 ， 只 要 
他 们 使 用 不 同 的 数据 区 和 不 同 的 端口 号 ( 见 下 文 )。 postgres 启动 时 需要 知道 数据 区 的 位 置 ， 

该 位 置 必须 通过 -p 选项 或 P6pDATA 环境 变量 指定 ; 没有 和 缺 省 值 。 通 常 ， -p 或 pepATA 都 直 
接 指向 由 initdb 创 建 的 数据 区 。 其 他 可 能 的 文件 布局 在 Section 18.2 里 面 有 讨论 。 


缺 省 时 postgres 在 前 台 馈 动 并 将 日 志 信 息 输出 到 标准 错误 。 但 在 实际 应 用 中 ， postgres 应 
当 作为 后 台 进 程 启动 ， 而 且 多 数 是 在 系统 启动 时 自动 启动 。 


postgres 还 能 以 单 用 户 模式 运行 。 这 种 用 法 主要 用 于 initdb 的 初始 化 过 程 中 。 有 时 候 它 也 被 
用 于 调试 或 灾难 性 恢复 。 注 意 ， 单 用 户 模式 运行 的 服务 器 并 不 适合 于 调试 ， 因 为 没有 实际 的 
进程 间 通 讯 和 锁 动 作 发 生 。 当 从 shel 上 以 单 用 户 模式 调用 时 ， 用 户 可 以 输入 查询 ， 然后 结 
果 会 在 屏幕 上 以 一 种 更 适合 开发 者 阅读 (不 适合 普通 用 户 ) 的 格式 显示 出 来 。 在 单 用 户 模式 
下 ， 将 把 会 话 用 户 ID 设 为 1 并 赋予 超级 用 户 权 限 。 该 用 户 不 必 实 际 存 在 ， 因此 单 用 户 模式 
运行 的 服务 器 可 以 用 于 对 某 些 意外 损坏 的 系统 表 进 行 手工 恢复 。 


选项 


postgres 接受 下 列 命令 行 参 数 。 关 于 这 些 选项 的 更 详细 讨论 请 参考 Chapter 18。 你 也 可 以 通 
过 设置 一 个 配置 文件 来 减少 敲 击 这 些 选项 。 有 些 ( 安 全 的 ) 选 项 还 可 以 从 连接 过 来 的 客户 端 设 
置 ， 以 一 种 应 用 相关 的 方法 久 对 该 会 话 生 效 。 比如 ， 如 果 设 置 了 pcoPTIoNS 环境 变量 ， 那 么 


基于 libpq 的 客户 端 束 都 把 那个 字符 串 传递 给 服务 器 ， 并 被 服务 器 解释 成 postgres MRITA 
项 。 


通用 用 途 
-A 0|1 


打开 运行 时 断言 检查 ， 是 检测 编程 错误 的 调试 帮助 。 只 有 在 编译 PostgreSQL 时 打开 了 它 ， 你 
才能 使 用 它 。 和 缺 省 是 打开 。 


-B _nbuffers_ 


ee id 理 的 共享 内 存 缓冲 区 数量 。 这 个 参数 的 缺 省 值 是 initdb 自 动 选 择 的 ; 声 
明 这 个 选项 等 同 于 设置 shared_buffers 配 置 参数 。 


-C name_ = _value 





设置 一 个 命名 的 运行 时 参数 。PostgreSQL 支 持 的 配置 参数 在 Chapter 18 里 描述 。 大 多 数 其 它 
命 命 行 选项 实际 上 都 是 这 样 的 参数 赋值 的 短 形式 。 -c 可 以 出 现 多 次 从 而 设置 多 个 参数 。 


p 


T 


-C _name_ 


打印 命名 的 运行 时 参数 的 值 ， 然 后 退出 。 (Sami - 选项 获取 详细 信息 。 ) 这 个 选项 
可 以 在 一 个 运行 的 服务 器 上 使 用 ， 返回 来 自 postgresql.conf 的 值 ， 通过 在 这 个 | 调用 中 提供 的 
参数 修改 。 当 集群 启动 时 ， 它 不 反应 提供 的 参数 。 


这 个 选项 本 应 为 与 服务 器 进程 交互 的 其 他 程序 ， 例 如 pg_cil， 查询 配置 参数 值 。 面 向 用 户 的 
应 用 应 该 使 用 xref linkend="sql-show"> 或 pg_settings 视图 。 


-d _debug-level_ 


设置 调试 级 别 。 数 值 越 高 ， 写 到 服务 器 日 志 的 调试 输出 越 多 。 取 值 范围 是 1 到 5。 还 可 以 针 
对 某 次 单独 的 会 话 使 用 -a 0 来 防止 从 父 postgres 进程 继承 日 志 级 别 。 


-D _datadir_ 
声明 数据 库 配 置 文件 的 文件 系统 路 径 。 细 节 详 见 Section 18.2。 


把 缺 省 日 期 风格 设置 为 "European"， 也 就 是 说 用 omy 规则 解释 日 期 输入 ， 并 且 在 一 些 日 期 输 
出 格式 里 日 子 在 月 份 前 面 打印 。 参 阅 Section 8.5 获 取 更 多 细节 。 


-F 


关闭 fsync 调用 以 提高 性 能 ， 但 是 要 冒 系统 骨 溃 时 数据 毁坏 的 风险 。 声明 这 个 选项 等 效 关 闭 
了 fsync 参 数 。 在 使 用 之 前 阅读 详细 文档 ! 


-h _hostname_ 


指定 postgres 侦 听 来 自前 端 应 用 TCP/IP 连接 的 IP 主机 名 或 地 址 。 数值 也 可 以 是 一 个 用 去 
号 分 隔 的 地 址 列表 ， 或 者 * 表示 监听 所 有 可 用 的 地 址 。 空 值 表示 不 监听 任何 IP 地 址 ， 而 只 
使 用 Unix 域 套 接 字 与 服务 器 连接 。 缺 省 只 监听 localhost。 声明 这 个 选项 等 效 于 设 

置 listen_addresses 配 置 参 数 。 


dd ea 过 E TOFAP ea ae es 没有 这 个 选项 ， 服务器 将 
只 接受 本 地 连接 。 3X7] 个 选项 等 效 于 在 postgresql.conf 中 或 者 通 过 -h 选项 


JẸ listen_addresses 设 为 * 


选项 已 经 废弃 了 ， 因 为 它 不 能 实现 listen_addresses 的 所 有 功能 。 所 以 最 好 直接 设 


listen_addresses o 


-k _directory_ 


指定 postgres 侦 听 来 自前 端 应 用 连接 的 Unix 域 套 接 字 的 目录 。 该 值 也 可 以 是 逗号 分 隔 的 目 
录 列 表 。 空 值 表明 不 监听 任何 Unix 域 套 接 字 ， 在 这 种 情况 下 ， 只 有 TCP/IP 套 接 字 可 以 用 来 
连接 到 服务 器 。 缺 省 通常 是 /tmp ， 但 是 可 以 在 编译 的 时 候 修改 。 声 明 这 个 选项 等 同 于 设 
置 unix_socket_directories 配置 参数 。 


-1 


这 个 选项 使 用 SSL 进 行 的 安全 通讯 。 要 使 用 这 个 选项 ， 编译 PostgreSQL 时 你 必须 打开 了 SSL 
支持 。 有 关 使 用 SSL 的 信息 ， 请 参考 Section 17.9。 


-N  _max-connections_ 


pee eee de 户 端 (也 就 是 最 多 同时 运行 多 少 个 服务 器 进程 )。 这 个 参数 的 
缺 省 值 自 动 通过 initdb 选 择 。 声明 这 个 选项 等 效 于 声明 max_connections 配 置 参数 。 


-o _extra-options_ 


在 _extra-options ”里 面 指定 的 命令 行 选项 将 被 传递 给 所 有 由 这 个 postgres 派生 的 服务 进 
i, 如 果 选 项 字符 串 包 含 任何 空白 ， 那 么 整个 字符 串 必 须 用 引号 界定 。 


反对 使 用 该 选项 ， 所 有 服务 器 进程 的 命令 行 选项 都 可 以 直接 在 postgres 命令 行 上 指定 。 
=p _port_ 


指定 postgres 侦 听 客户 端 连 接 的 TCP/IP 端口 或 本 地 Unix 域 套 接 字 文件 的 扩展 。 缺 省 的 端 
口号 是 环境 变量 PPoRT 的 值 。 如 果 PPoRT 没有 设置 ， 那么 缺 省 是 PostgreSQL 编译 时 指定 
的 值 (通常 是 5432)。 如 果 你 声明 了 一 个 非 缺 省 端口 ， 那么 所 有 前 端 应 用 都 必须 用 命令 行 选 项 
或 者 PPoRT 声明 同一 个 端口 。 


SS) 


在 每 条 命令 结束 时 打印 时 间 信 息 和 其 它 统 计 信息 。 这 个 选项 对 测试 性 能 和 调节 缓冲 区 数量 有 
好 处 。 


-S  _work-mem_ 


声明 内 部 排序 和 散 列 在 求助 于 临时 磁盘 文件 之 前 可 以 使 用 的 内 存 数 量 。 参阅 Section 18.4.1% 
描述 的 配置 变量 work_mem o 


-V>>--version 
打印 postgres 版 本 然后 退出 。 


` _name_ = _value 





设置 一 个 命名 的 运行 时 参数 ; 其 缩写 形式 是 -c 。 


--describe-config 


以 制 表 符 分 隔 的 copy 格式 ， 导 出 服务 器 内 部 配置 变量 、 描 述 、 缺 省 值 。 设计 它 主要 是 给 管 
理工 具 使 用 。 


-?  --help 


显示 关于 postgres 命 令 行 参数 的 帮助 然后 退出 。 


部 分 内 部 选项 


这 里 描述 的 选项 主要 用 于 调试 用 途 ， 并 且 在 某 些 情况 下 帮助 严重 损坏 的 数据 库 恢 复 。 不 应 该 
在 生产 数据 库 的 设置 中 使 用 这 些 选项 。 在 这 里 列 出 只 是 给 PostgreSQL 系统 开发 人 员 使 用 的 。 
另外 这 些 选项 都 可 能 在 未 来 版 本 中 改变 或 删除 而 不 加 说 明 。 


ftslilolpbpltlnlmlnh y, 


禁止 某 种 扫描 和 连接 方法 的 使 用 : s Mi 分 别 关 闭 顺序 和 索引 扫描 ，o。，b 和 t DHX 
闭 只 有 索引 扫描 、 位 图 索引 扫描 和 TID 扫 描 ， 而 n，m ,和 h 分 别 关 闭 铸 套 循环 ， 融 合 
(merge) 和 Hash 连接 。 


顺序 打 描 和 岩 套 循环 都 不 可 能 完全 被 关闭 。 -fs 和 -fn 选项 仅仅 是 在 存在 其 它 方法 时 阻碍 优 
化 器 使 用 这 些 方 法 姻 了 。 

该 选项 主要 用 于 调试 导致 服务 器 进程 异常 崩溃 的 问题 。 对 付 这 种 情况 的 一 般 策略 是 通知 所 有 
其 它 服务 器 进程 终止 并 重新 初始 化 共享 内 存 和 信号 灯 。 这 是 因为 一 个 出 错 的 服务 器 进程 可 能 
在 终止 之 前 就 已 经 对 共享 的 东西 造成 了 破坏 。 该 选项 指定 postgres 不 重新 初始 化 共享 数据 结 
构 。 一 个 有 经 验 的 系统 程序 员 这 时 就 可 以 使 用 调试 器 检查 共享 内 存 和 信号 灯 状 态 。 


-0 
允许 修改 系统 表 的 结构 。 这 个 人 参数 用 于 initdb o 


-P 


读 取 系 统 表 时 忽略 系统 索引 ， 但 在 更 改 数据 时 仍然 更 新 索引 。 这 对 于 从 索引 已 经 损坏 的 系统 
表 中 恢复 是 很 有 帮助 的 。 


-t parrser] | pl[anner] | e[xecutor] 
打印 与 每 个 主要 系统 模块 相关 的 查询 记 时 统计 。 它 不 能 和 -s 选项 一 起 使 用 。 
-T 


该 选项 主要 用 于 调试 导致 服务 器 进程 异常 月 溃 的 问题 。 对 付 这 种 情况 的 一 般 策 略 是 通知 所 有 

其 它 服 务 器 进程 终止 并 重新 初始 化 共享 内 存 和 信号 灯 。 这 是 因为 一 个 出 错 的 服务 器 进程 可 能 
在 终止 之 前 就 已 经 对 共享 的 未 西 造成 了 破坏 。 该 选项 指定 postgres 通过 发 送 sicstop 信号 
停止 其 他 所 有 服务 器 进程 ， 但 是 并 不 让 它们 退出 。 这 样 就 允许 系统 程序 员 手 动 从 所 有 服务 器 
进程 搜集 内 核 转 储 。 


-v _protocol_ 
声明 这 次 会 话 使 用 的 前 /后 服务 器 协议 的 版 本 数 。 该 选项 仅 在 内 部 使 用 。 


-W _seconds_ 

一 旦 看 见 这 个 选项 ， 进 程 就 睡眠 标 出 的 秒 数 。 这 桩 就 给 开发 者 一 些 时 间 把 调试 器 附着 在 该 服 
务 器 进程 上 。 

单 用 户 模式 的 选项 

下 面 的 选项 仅 在 单 用 户 模式 下 可 用 。 

--Single 

选中 单 用户 模 式 。 这 个 必须 是 命令 行 中 的 第 一 个 选项 。 

_database_ 


要 访问 的 数据 库 名 字 。 这 个 必须 是 命令 行 中 的 最 后 一 个 选项 。 如 果 忽 略 掉 则 人 缺 省 为 用 户 名 。 


1 
m 


禁止 使 用 新 行 作为 语句 分 隔 符 。 
-r _filename_ 


将 所 有 服务 器 输出 日 志保 存 到 filename 中 。 在 多 用 户 模式 下 该 选项 将 被 忽略 ， 所 有 进程 都 
将 使 用 stderr。 


环境 变量 


PGCLIENTENCODING 
客户 端 使 用 的 缺 省 字符 编码 。 客 户 端 可 以 独立 地 覆盖 它 。 这 个 值 也 可 以 在 配置 文件 里 设置 。 
PGDATA 

缺 省 数据 目录 位 置 。 

PGDATESTYLE 

运行 时 参数 DateStyle 的 缺 省 值 。 现 在 反对 使 用 该 环境 变量 。 

PGPORT 

缺 省 端口 号 (最 好 在 配置 文件 中 设置 )。 

TZ 


服务 器 的 时 区 。 


一 个 提 到 了 semget 或 shmget 的 错误 信息 可 能 意味 着 你 需要 重新 配置 你 的 内 核 ， 提供 足够 的 
共享 内 存 和 信号 灯 。 更 多 讨论 ， 参 阅 Section 17.4。 你 也 可 以 通过 降低 shared buffers 值 以 减 
少 PostgreSQL 的 共享 内 存 的 消耗 ， 或 者 降低 max_connections 值 减少 PostgreSQL 的 信号 灯 
的 消耗 。 


如 果 碰 到 一 个 说 另外 一 个 服务 器 正在 运行 的 错误 信息 ， 可 以 根据 不 同 的 系统 使 用 命令 


<samp class="literal">$</samp> <kbd class="literal">ps ax | grep postgres</kbd> 


> 
口 


<samp class="literal">$</samp> <kbd class="literal">ps -ef | grep postgres</kbd> 


如 果 确 信 没 有 冲突 的 服务 器 正在 运行 ， 那 么 你 可 以 删除 消息 里 提 到 的 锁 文 件 然后 再 次 运行 。 


抱怨 无 法 绑 定 端口 的 错误 信息 可 能 表明 该 端口 已 经 被 其 它 非 PostgreSQL 进程 使 用 。 如 果 终 
IF postgres 后 又 马上 用 同一 个 端口 运行 它 ， 也 可 能 得 到 这 个 错误 信息 ; 这 时 ， 你 必须 多 等 几 
秒 ， 等 操作 系统 关闭 了 该 端口 后 再 试 。 最 后 ， 如 果 你 使 用 了 一 个 操作 系统 认为 是 保留 的 端 
口 ， 也 可 能 导致 这 个 错误 信息 。 例 如 ， 许多 Unix 版 本 认为 低 于 1024 的 端口 号 是 "可 信任 
A", 因而 只 有 Unix 超级 用 户 可 以 使 用 它们 。 


<a 
) 王 局 


pg_ctl 工 具 可 以 用 于 安全 而 有 效 地 启 停 postgres 服务 器 。 


如 果 有 可 能 ， 不 要 使 用 sireki ASCE postgres 服务 器 进程 。 这 样 会 阻止 postgres 在 退出 
前 释放 它 持 有 的 系统 资源 (例如 共享 内 存 和 信号 灯 )。 这 样 可 能 会 影响 到 将 来 启动 新 的 
postgres 进程 。 


可 以 使 用 SIGTERM , SIGINT , SIGQUIT 信号 正常 结束 postgres 服务 器 进程 。 第 一 个 信号 将 等 
待 所 有 的 客户 端 退出 后 才 退 出 。 第 二 个 将 强制 断 开 所 有 客户 端 ， 而 第 三 个 将 不 停止 立刻 退 
出 ， 导 致 在 重启 时 的 恢复 运行 。 


sIGHUP 会 重新 加 载 服务 器 配置 文件 。 也 可 以 向 一 个 单独 的 服务 器 进程 发 送 sre 信号 ， 但 


是 这 样 做 没什么 意义 。 


要 取消 一 个 正在 运行 的 查询 ， 可 以 向 正在 执行 该 查询 的 进程 发 送 STGINT 信号 。 要 终止 一 个 后 
端 进程 ， 可 以 向 那个 进程 发 送 sicterm 信和 号。 也 可 以 参阅 Section 9.26.2 里 面 
的 pg_cancel backend 和 pg_terminate_backend 获取 这 两 个 动作 的 相等 SQL 调 用 。 


postgres 服务 器 发 送 si6QuIT 信号 告诉 子 服 务 器 进程 立即 退出 且 不 做 清理 工作 ， 用 户 应 当 尽 
量 避 免 使 用 该 信号 。 同时 ， 发 送 SIGKILL 信号 也 是 不 明智 的 : += postgres 进程 将 把 这 个 信 
号 当 作 崩 溃 信 号 ， 然后 会 强制 其 他 兄弟 进程 作为 标准 的 朋 江 回复 过 程 退出 。 


Rh 


- 选项 在 FreeBSD 或 OpenBSD 上 无 法 运行 ， 应 该 使 用 -co 这 在 受 影响 的 系统 里 是 个 臭 
虫 ; 如 果 这 个 毛病 没有 修补 好 ， 将 来 的 PostgreSQL 版 本 将 提供 一 个 绕 开 的 办 法 。 


用 法 


启动 一 个 单 用 户 模式 的 服务 器 : 


<kbd class="literal">postgres --single -D /usr/local/pgsql/data ~_other-options_~ my_data 


用 -5 给 服务 器 提供 正确 的 数据 库 目 录 的 路 径 ， 或 者 确保 环境 变量 pea 已 经 正确 设置 。 同 
时 还 要 声名 你 想 用 的 特定 数据 库 名 字 。 





通常 ， 单 用 户 模式 的 服务 器 把 换行 符 当 做 命令 输入 完成 字符 ; 它 还 不 懂 分 号 的 作用 ， 因为 那 
些 东 西 是 在 psql 里 的 。 要 想 把 一 行 分 成 多 行 守 }， 你 必需 在 除 最 后 一 个 换行 符 以 外 的 每 个 换行 
符 前 面 敲 一 个 反 斜 杠 。 


但 是 如 果 使 用 了 -j 命令 行 选项 ， 新 行将 不 被 当 作 命令 结束 符 。 此 时 服务 器 将 从 标准 输入 一 
直 读 取 到 EOF 标 志 为 止 ， 然后 把 所 有 读 到 的 内 容 当 作 一 个 完整 的 命令 字符 串 看 待 ， 并 且 反 斜 
杠 与 换行 符 也 被 当 作 普通 字符 来 看 待 。 


输入 EOF(Control+D) 即 可 退出 会 话 。 如 果 你 已 经 使 用 了 -j 则 必须 连续 使 用 两 个 EOF 才 行 。 


请 注意 单 用 户 模式 运行 的 服务 器 不 会 提供 复 条 的 行 编辑 功能 (比如 ， 没 有 命令 行 历史 )。 单 用 
户 模式 也 不 做 任何 后 台 处 理 ， 像 自动 检查 点 。 


例子 
用 人 缺 省 值 在 后 台 和 启动 postgres 


<Samp class="literal">$</samp> <kbd class="literal">nohup postgres >logfile 2>&1 </dev/nu 


‘ — 8 








在 指定 的 端口 启动 postgres , 401234 : 


<Samp class="literal">$</samp> <kbd class="literal">postgres -p 1234</kbd> 


要 连接 到 这 个 服务 器 使 用 psql， 用 -P 选项 指定 这 个 端口 : 
<samp class="literal">$</samp> <kbd class="literal">psql -p 1234</kbd> 


或 者 设置 环境 变量 Pcport 


<samp class="literal">$</samp> <kbd class="literal">export PGPORT=1234</kbd> 
<samp class="literal">$</samp> <kbd class="literal">psql</kbd> 


命名 的 运行 时 参数 可 以 用 下 列 的 风格 之 一 设置 : 


<Samp class="literal">$</samp> <kbd class="literal">postgres -c work_mem=1234</kbd> 
<samp class="literal">$</samp> <kbd class="literal">postgres --work-mem=1234</kbd> 


两 种 形式 都 覆盖 那些 现 有 的 在 postgresql.conf PHAY work_mem 设置 。 请 注意 在 参数 名 里 的 
下 划 线 在 命令 行 上 可 以 写成 下 划 线 ， 也 可 以 写成 连 字符 。 除了 用 于 短期 的 实验 以 外 ， 更 好 的 
习惯 是 编辑 postgresql.conf 里 面 的 设置 ， 而 不 是 倚赖 命令 行 开 关 设 置 参 数 。 


义 见 


initdb, pg_ctl 


postmaster 


Name 


postmaster -- PostgreSQL 数据 库 服 务 器 


Synopsis 
postmaster [ _option_...] 
fia oh 

postmaster 是 postgres 的 别名 ， 反对 使 用 。 


义 见 


postgres 


Vil. 内 部 


这 部 分 包含 可 以 用 于 PostgreSQL 开发 人 员 的 分 类 信息 。 
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作者 : 本 章 最 初 是 Enhancement of the ANSI SQL Implementation of PostgreSQL 的 一 部 
D, BÆ Stefan Simkovics 在 维也纳 理工 大 学 写 的 硕士 论文 ， 是 由 O.Univ.Prof.Dr. 
Georg Gottlob 和 Univ.Ass. Mag. Katrin Seyr 指导 的 。 


本 章 给 出 了 PostgreSQL 后 端 服务 器 的 内 部 结构 的 一 个 概貌 。 在 阅读 完毕 下 面 的 章节 后 ， 你 应 
该 对 查询 是 如 何 处 理 的 有 一 个 概念 了 。 本 章 并 不 准备 提供 对 PostgreSQL 内 部 操作 的 详细 描 
述 ， 因为 这 样 的 一 份 文档 将 会 非常 房 大 。 本 章 只 是 试图 帮助 读者 了 解 从 后 端 收 到 查询 后 到 结 
果 返 回 给 客户 端 之 间 一 般 操作 顺序 。 


46.1. 查询 经 过 的 路 径 


下 面 是 一 个 简短 的 描述 ， 描 述 一 个 查询 从 开始 到 得 到 结果 要 经 过 的 阶段 。 


1. 


首先 必须 先 建立 起 从 应 用 程序 到 PostgreSQL 服 务 器 的 连接 。 应 用 程序 向 服务 器 发 送 查 询 
然后 等 待 接收 从 服务 器 返回 的 结果 。 


分 析 器 阶段 检查 从 应 用 程序 (客户 端 ) 发 送 过 来 的 查询 ， 核对 语法 并 创建 一 个 查询 树 。 


重 写 系 统 接收 分 析 阶 段 来 的 查询 树 且 搜索 任何 应 用 到 查询 树 上 的 规则 (存储 在 系统 表 
里 )， 并 根据 给 出 的 规则 体 进 行 转换 。 


重 写 系 统 的 一 个 应 用 就 是 实现 视图 。 当 一 个 查询 访问 一 个 视图 时 (也 就 是 一 个 虚拟 表 )， 
重 写 系 统 改写 用 户 的 查询 ， 使 之 成 为 一 个 访问 在 视图 定义 里 给 出 的 对 基本 表 的 查询 。 


规划 器 /优化 器 接收 ( 改 于 后 的 ) 查 询 树 然后 创建 一 个 查询 规划 ， 这 个 查询 规划 是 执行 器 的 
输入 。 


它 (规划 器 /优化 器 ) 首 先 创 建 所 有 得 出 相同 结果 的 可 能 的 路 径 。 例如 ， 如 果 待 扫描 的 关系 
上 有 一 个 索引 ， 那 么 扫描 的 路 径 就 有 两 个 。 一 个 可 能 是 简单 的 顺序 查找 ， 而 另 一 个 可 能 
就 是 使 用 索引 的 查找 。 下 一 步 是 计算 出 不 同 路 径 的 执行 开销 ， 并 且 选 择 和 返回 开销 最 少 
的 那 条 。 开 销 最 小 的 路 径 然 后 会 被 展开 成 为 一 个 可 以 供 执行 器 使 用 的 完整 的 查询 规划 。 


执行 器 递归 地 走 过 规划 树 并 且 按 照 规划 指定 的 方式 检索 数据 行 。 执行 器 在 对 关系 进行 扫 
描 时 使 用 存储 系统 进行 排序 和 连接 ， 计 算 条 件 并 且 最 终 交 回 生成 的 数据 行 。 


在 随后 的 小 节 里 ， 将 对 上 面 的 每 一 个 步骤 进行 更 详细 的 讨论 ， 以 便 让 对 PostgreSQL 的 内 部 控 
制 和 数据 结构 有 一 个 更 准确 的 理解 。 


46.2. 连接 是 如 何 建立 起 来 的 


PostgreSQL 是 用 一 个 简单 的 "每 用 户 一 进程 " 的 client/server 模型 实现 的 。 在 这 种 模式 里 一 个 

客户 端 进程 只 与 恰好 一 个 服务 器 进程 连接 。 因 为 不 知道 具体 要 建立 多 少 个 连接 ， 所 以 不 得 不 
利用 一 个 主 进程 在 每 次 连接 请 求 时 派生 出 一 个 新 的 服务 器 进程 来 。 这 个 主 进程 叫 

做 postgres ， 它 监听 着 一 个 特定 的 TCP/IP 端口 等 待 进来 的 连接 。 每 当 检测 到 一 个 连接 请 求 
at, postgres 进程 派生 出 一 个 新 的 服务 器 进程 。 服务 器 进程 之 间 使 用 信号 灯 和 共享 内 存 进 行 
通讯 ， 以 确保 在 并 发 的 数据 访问 过 程 中 的 数据 完整 性 。 

客户 端 进程 可 以 是 任何 理解 PostgreSQL 协 议 (在 Chapter 48 里 描述 ) 的 程序 。 许 多 客户 端 都 是 

基于 C 话 言 库 libpq 的 程序 ， 但 是 也 存在 几 个 对 协议 独立 的 实现 ， 比 如 Java JDBC 了 驱动 。 


一 且 建 立 起 来 连接 ， 客 户 端 进程 就 可 以 向 后 端 (服务 器 ) 进 程 发 送 查 询 了 。 查询 是 通过 纯 文本 
传输 的 ， 也 就 是 说 在 前 端 ( 客 户 端 ) 不 做 任何 分 析 处 理 。 服 务 器 分 析 查 询 ， 创建 执行 规划 ， 执 
行 该 规划 并 且 通 过 已 经 建立 起 来 的 连接 把 检索 出 来 的 数据 行 返回 给 客户 端 。 


46.3. 分 析 器 阶段 


分 析 器 阶段 含 两 个 部 分 : 
e 在 gram.y 和 scan.1 里 定义 的 分 析 器 是 使 用 Unix 工具 bison 和 flex 创 建 的 。 


。 转换 处 理 对 分 析 器 返回 的 数据 结构 进行 修改 和 增补 。 


46.3.1. 分 析 器 


分 析 器 必须 检查 (以 纯 ASCII 文本 方式 到 来 的 ) 查 询 字符 串 的 语法 。 如 果 语 法 正确 ， 则 创建 一 
个 分 析 树 并 将 之 传 回 ， 否 则 ， 返 回 一 个 错误 。 实现 分 析 器 和 词法 器 使 用 了 著名 的 Unix 工具 
bison 和 flex。 


词法 器 在 文件 scan.1 BPEL, 负责 识别 标识 符 和 SQL 关键 字 等 。 对 于 发 现 的 每 个 关键 字 或 
者 标识 符 都 会 生成 一 个 记号 并 且 传 递 给 分 析 器 。 

分 析 器 在 文件 gram.y 里 定义 并 且 包 含 一 套 语法 规则 和 触发 规则 时 执行 的 动作 。 动 作 代 码 ( 实 
际 上 是 C 代码 ) 用 于 建立 分 析 树 。 

文件 scan.1 用 flex 转 换 成 C 源 文件 scan.c ， 而 gram.y 用 bison 转换 成 gram.c 。 在 完成 这 


些 转换 后 ， 一 个 通用 的 C 编译 器 就 可 以 用 于 创建 分 析 器 。 干 万 不 要 对 生成 的 C 源 文件 做 修 
改 ， 因 为 下 一 次 调用 flex 或 bison 时 会 把 它们 覆盖 。 














Note: 上 面 提 到 的 转换 和 编译 是 使 用 跟随 PostgreSQL 发布 的 makefiles 自 动 完成 的 。 





对 bison 或 者 gram.y 里 的 语法 规则 的 详细 描述 超出 本 文 的 范围 。 有 很 多 关于 flex 和 bison 的 书 
籍 和 文档 。 你 在 开始 研究 gramy 里 给 出 的 语法 之 前 应 该 对 bison 很 熟悉 ， 否 则 你 是 看 不 懂 那 
里 面 的 内 容 ， 理解 不 了 发 生 了 什么 事情 的 。 





46.3.2. 转换 义理 


分 析 器 阶段 只 使 用 和 SQL 语法 结构 相关 的 固定 规则 创建 一 个 分 析 树 。 它 不 会 查找 任何 系统 
表 ， 因此 就 不 可 能 理解 请 求 查询 里 面 的 详细 的 语意 。 在 分 析 器 技术 之 后 ， 转换 处 理 接受 分 析 
器 传 过 来 的 分 析 树 然后 做 进一步 处 理 ， 解 析 哪 些 查 询 中 引用 了 哪个 表 、 哪个 函数 、 哪 个 操作 
符 的 语意 。 所 生成 的 表示 这 个 信息 的 数据 结构 叫做 查询 树 。 


把 裸 分 析 和 语意 分 析 分 成 两 个 过 程 的 原因 是 系统 表 查 找 只 能 在 一 个 事务 中 进行 ， 而 不 想 在 一 
接收 到 查询 字符 串 就 发 起 一 个 事务 。 锅 分 析 阶 段 已 经 足够 可 以 标识 事务 控制 命令 
BEGIN, ROLLBACK 等 )， 并 且 这 些 东 西 不 用 任何 进一步 的 分 析 就 可 以 执行 。 一 旦 知道 正在 处 


理 一 个 真正 的 查询 (比如 serect 或 uppate ), 就 可 以 发 起 一 个 事务 了 (如 果 还 没 开始 这 人 么 一 
个 )。 只 有 这 个 时 候 可 以 调用 转换 义理 。 


转换 处 理 生成 的 查询 树 结构 上 在 很 大 程度 上 类 似 于 裸 分 析 树 ， 但 是 在 细节 上 有 很 多 区 别 。 比 
如 ， 在 分 析 树 里 的 Funccall 节点 代表 那些 看 上 去 像 画 数 调 用 的 东西 。 根据 引用 的 名 字 是 一 个 
普通 画 数 还 是 一 个 聚集 事 数 ， 这 个 可 能 被 转换 成 一 个 FuncExpr 或 Aggref 节点 。 同 祥 ， 有 关 
字段 和 表达 式 结果 的 具体 数据 类 型 也 添加 到 查询 树 中 。 


46.4. PostgreSQL 规 则 系统 


PostgreSQL 有 一 个 强大 的 规则 系统 ， 用 以 描述 视图 和 不 明确 的 视图 更 新 。 最 初 的 
PostgreSQL 规 则 系统 由 两 个 实现 组 成 : 


。 第 一 个 能 用 的 规则 系统 采用 行 级 别 的 义理 ， 是 在 执行 器 的 深层 实现 的 。 每 次 访问 一 条 独 
立 的 行 时 都 要 调用 规则 系统 。 这 个 实现 在 1995 年 被 删除 了 ， 那 时 伯 克 力 Postgres mE 
的 最 后 一 个 官方 版 本 正 转 换 成 Postgres95。 


。 第 二 个 规则 系统 的 实现 从 技术 角度 来 说 叫 查 询 重 写 。 重 写 系统 是 一 个 存在 于 分 析 器 阶段 
和 规划 器 /优化 器 之 间 的 一 个 模块 。 这 个 技术 实现 仍然 存在 。 


查询 重 写 在 Chapter 38 里 有 上 比较 详细 的 讨论 ， 所 以 无 需 再 次 介绍 。 只 需要 说 明 重 写 器 的 输入 
和 输出 都 是 查询 树 ， 也 就 是 说 ， 在 树 的 语意 细节 的 表现 或 者 层次 方面 没有 变化 。 可 以 把 重 写 
系统 当 作 某 种 宏 展开 的 机 制 。 


46.5. 规划 器 /优化 器 


规划 器 /优化 器 的 任务 是 创建 一 个 优化 执行 规划 。 一 个 特定 的 SQL 查询 (因此 也 就 是 一 个 查询 
树 ) 实 际 上 可 以 以 多 种 不 同 的 方式 执行 ， 每 种 都 生成 相同 的 结果 集 。 如 果 可 能 ， 查 询 优化 器 将 
检查 每 个 可 能 的 执行 规划 ， 最 终 选 择 认为 运行 最 快 的 执行 计划 。 





Note: 有 些 情况 下 ， 检 查 一 个 查询 所 有 可 能 的 执行 方式 会 花 去 很 多 时 间 和 内 存 空间 。 特 
别 是 在 正在 执行 的 查询 涉及 大 量 连 接 操作 的 时 候 。 为 了 在 合理 的 时 间 里 判断 一 个 合理 的 
(而 不 是 优化 的 ) 查 询 计划 。PostgreSQL 当 连 接 的 数量 超过 一 个 闽 值 (参阅 
geqo_threshold) 时 使 用 基因 查询 优化 器 (参阅 Chapter 53)。 














规划 器 的 搜索 过 程 实 际 上 是 与 叫做 paths 的 数据 结构 一 起 结合 运转 的 ， 这 个 数据 结构 是 一 个 很 
简单 的 规划 的 精简 版 本 ， 它 只 包括 规划 器 用 来 决策 所 必须 的 信息 。 在 找到 最 经 济 的 路 径 之 
后 ， 就 制作 一 个 完整 的 规划 树 传递 给 执行 器 。 它 有 足够 的 详细 信息 ， 代 表 着 需要 执行 的 计 
划 ， 执 行 器 可 以 读 懂 并 运行 之 。 在 本 章 剩余 部 分 ， 将 忽略 路 径 和 规划 之 间 的 区 别 。 


46.5.1. 生成 可 能 的 规划 


规划 器 /优化 器 通过 为 扫描 查询 里 出 现 的 每 个 关系 ( 表 ) 生 成 规划 。 可 能 的 规划 是 由 每 个 关系 上 
有 哪些 可 用 的 索引 决定 的 。 对 一 个 关系 总 是 可 以 进行 一 次 顺序 查找 ， 所 以 总 是 会 创建 只 使 用 
顺序 查找 的 规划 。 假 设 一 个 关系 上 定义 着 一 个 索引 (例如 B-tree 索引 )， 并 且 一 条 查询 包含 约 
3R relation.attribute OPR constant o 如 果 relation.attribute 健 巧 匹配 B-tree 索引 的 关键 
FHH or 又 是 列 出 在 索引 的 操作 符 类 中 的 操作 符 中 的 一 个 ， 那么 将 会 创建 另 一 个 使 用 B- 
tree 索引 扫描 该 关系 的 规划 。 如 果 还 有 别 的 索引 ， 而 且 查 询 里 面 的 约束 又 和 那个 索引 的 关键 
字 匹 配 ， 则 还 会 生成 更 多 的 规划 。 也 会 为 索引 生成 索引 打 描 规划 ， 这 个 规划 有 一 种 可 以 匹配 
查询 的 oRDER BY FA (如果 有 ) 的 顺序 ， 或 者 有 一 种 可 能 对 融合 加 入 〈 见 下 面 ) 有 用 的 顺 
序 。 


如 果 查 询 需 要 加 入 两 个 或 者 更 多 的 关系 ， 在 所 有 的 对 单一 关系 的 扫描 可 行 的 规划 被 发 现 后 ， 
连接 各 个 关系 的 规划 就 要 被 考虑 了 。 有 三 种 可 能 的 连接 策略 : 


。 REMTE : 对 左边 的 关系 里 面 找到 的 每 条 行 都 对 右边 关系 进行 一 次 扫描 。 这 个 策略 
容易 实现 ， 但 是 可 能 会 很 耗费 时 间 。 (但 是 ， 如 果 右 边 的 关系 可 以 用 索引 扫描 ， 那么 这 
个 可 能 就 是 个 好 策略 。 可 以 用 来 自 左 边关 系 的 当前 行 的 数值 为 键 字 进 行 对 右边 关系 的 索 
引 扫描 。) 


。 融合 连接 : 在 连接 开始 之 前 ， 每 个 关系 都 对 连接 字段 进行 排序 。 然后 对 两 个 关系 并 发 扫 
描 ， 匹 配 的 行 就 组 合 起 来 形成 连接 行 。 这 种 联合 更 有 吸引 力 ， 因为 每 个 关系 都 只 用 扫描 
一 次 。 要 求 的 排序 步骤 可 以 通过 明确 的 排序 步 又， 或 者 是 使 用 连接 键 字 上 的 索引 按照 恰 
当 的 顺序 扫描 关系 。 


e Hash 连接 : 首先 扫描 右边 的 关系 ， 并 用 连接 的 字段 作为 散 列 键 字 加 载 进 入 一 个 Hash 
表 ， 然 后 扫描 左边 的 关系 ， 并 将 找到 的 每 行 用 作 散 列 键 字 来 以 定位 表 里 匹 配 的 行 。 


如 果 查 询 里 的 关系 多 于 两 个 ， 最 后 的 结果 必须 通过 一 个 连接 步骤 树 建立 ， 每 个 步骤 有 两 个 输 
入 。 规 划 器 检查 不 同 的 连接 顺序 可 能 ， 找 出 开销 最 小 的 。 


如 果 查 询 使 用 少 于 geqo_threshold 的 关系 ， 一 个 近乎 详尽 的 查询 用 来 进行 查找 最 好 的 连接 顺 
序 。 规 划 器 优先 的 考虑 介 于 任何 两 个 关系 间 的 连接 子 句 ， 在 whERE 条 件 中 存在 一 个 匹配 的 连 
接 子 句 (PA, IEIR where relt.attri=rel2.attr2 这 样 的 约束 ) 。 没有 连接 子 句 的 连接 对 

只 有 在 没有 别 的 选择 的 时 候 才 考虑 ， 也 就 是 说 ， 一 个 关系 没有 和 任何 其 它 关 系 的 连接 子 句 可 
用 。 所 有 可 能 的 规划 都 是 为 每 个 被 规划 器 考虑 的 链接 对 生成 的 ， 并 且 那 个 (预计 是 ) RAX 
的 被 选择 。 


当 geqo_threshold 渝 出 时 ， 连 接 序列 被 认为 是 由 启发 式 方法 决定 的 ， 描述 在 Chapter 53. GB 
则 ， 流 程 是 相同 的 。 


完成 的 查询 树 由 对 基础 关系 的 顺序 或 者 索引 扫描 组 成 ， 并 根据 需要 加 上 嵌 套 循环 、 融 合 、 以 
及 Hash 连接 节点 ， 加 上 任何 需要 的 辅助 步 又， 比如 排序 节点 或 者 聚集 画 数 计 算 节 点 等 。 大 
多 数 这 些 规划 节点 类 型 都 有 额外 的 做 选择 ( 抛 奔 那 些 不 符合 指定 布尔 条 件 的 行 ) 和 投影 (基于 给 
出 的 字段 数值 计算 一 个 派生 出 的 字段 集 ， 也 就 是 在 需要 时 计算 标量 表达 式 )。 规 划 器 的 一 

任 是 从 wer 子 句 中 附加 选择 条 件 以 及 为 规划 树 最 合适 的 节点 计算 所 需要 的 输出 表达 式 。 


46.6. 执行 如 


执行 器 接受 规划 器 /优化 器 创建 的 查询 规划 然后 递 轨 地 处理 它 ， 抽取 所 需要 的 行 集合 。 它 实际 
上 是 一 个 需求 -拉动 地 流水 线 机 制 。 每 次 调用 一 个 规划 节点 地 时 候 ， 它 都 必须 给 出 更 多 的 一 个 
行 ， 或 者 汇报 它 已 经 完成 行 的 传递 了 。 


为 了 提供 一 个 具体 的 例子 ， 假 设 顶端 节点 是 一 个 MergeJoin 节点 。 在 做 任何 融合 之 前 ， 首 先 
得 抓 取 两 行 (每 个 子规 划一 行 )。 因此 执行 器 递归 地 调用 自己 来 处 理子 规划 ( 它 从 附着 

在 lefttree 上 的 子规 划 开 始 )。 新 的 顶端 节 点 ( 左 子规 划 的 顶端 节点 ) 假 设 是 ， 一 个 sort $ 
点 ， 然后 还 是 需要 递 为 地 获取 一 个 输入 行 。 sort 节点 的 子 节点 可 能 是 一 个 seqscan PR, 
代表 对 一 个 表 的 实际 读 取 动作 。 这 个 节点 的 执行 导致 执行 器 从 表 中 抓 取 一 行 然后 把 它 返 回 给 
调用 的 节点 。 sort 将 不 断 调用 它 的 子 节点 以 获取 需要 排序 的 所 有 行 。 在 用 尽 输入 之 后 (由 子 
节点 返回 一 个 NULL 而 不 是 一 行 表 示 )， sort 代码 执行 排序 ， 然后 就 可 以 返回 它 的 第 一 个 输 
出 行 ， 也 就 是 按照 排序 顺序 输出 的 第 一 行 。 它 仍然 保持 剩 下 的 行 的 排序 状态 ， 这 样 在 随后 有 
需求 的 时 候 ， 它 就 可 以 按照 排序 顺序 返回 这 些 行 。 


MergeJoin 节点 也 会 类 似 地 要 求 从 它 的 右边 子规 划 获 取 第 一 行 。 然后 它 比较 这 两 行 看 看 它们 
是 否 能 连接 ; 如 果 能 ， 那 么 它 给 它 的 调用 者 返回 一 个 连接 行 。 在 下 一 次 调用 的 时 候 ， 或 者 是 
在 它 无 法 连接 当前 的 两 行 的 时 候 就 是 这 次 调用 的 时 候 ， 它 抓 取 其 中 一 个 表 的 下 一 行 ( 抓 取 哪个 
表 取 决 于 比较 结果 如 何 )， 然 后 再 检查 看 看 两 个 表 是 否 匹 配 。 最 后 ， 其 中 一 个 子规 划 耗 尽 资 
源 ， 而 MergeJoin 返回 NULL, 表明 无 法 继续 生成 更 多 的 连接 行 。 


复 条 的 查询 可 能 包含 许多 层 的 规划 节点 ， 但 是 一 般 的 过 程 都 是 一 样 的 : 每 个 节点 在 每 次 被 调 
用 的 时 候 都 计算 并 返回 它 的 下 一 个 输出 行 。 每 个 节点 同样 负责 附加 上 任何 规划 器 赋予 它 的 选 
择 或 者 投影 表达 式 。 


执行 器 机 制 是 用 于 计算 所 有 的 四 种 基本 SQL 查询 类 型 的 : SELECT ， INSERT ， 

UPDATE 和 DELETE o 对 于 SELECT MA, 顶层 的 执行 器 代码 只 是 需要 发 送 查 询 规划 树 返 回 的 
每 一 行 给 客户 端 。 对 于 insert, 返回 的 每 一 行 都 插入 到 insert 声明 的 目标 表 中 。 也 就 是 在 
一 个 名 为 ModifyTable 的 特殊 的 顶级 规划 节点 执行 。 (一 个 简单 的 insert ... VALUES 命令 创 
建 一 个 简单 的 规划 树 ， 包含 一 个 Result 节点 ， 它 只 计算 得 出 一 个 结果 行 ， 并 

EH ModifyTable 执行 这 个 插入 。 但 是 INSERT ... SELECT 可 能 需要 执行 器 的 全 部 能 力 。) 对 
于 UPDATE ， 规划 器 安排 每 个 计算 出 来 的 行 都 包括 所 有 更 新 的 字段 ， 加 上 原来 的 目标 行 的 
TID( 元 组 ID 或 行 ID) ; 这 些 数据 输入 到 一 个 ModifyTable 节点 ， 这 个 节点 使 用 这 些 信 息 创 建 一 
个 新 的 更 新 过 的 行 ， 并 且 标 记 旧 行 被 删除 。 对 于 DELETE ， 规 划 实 际 上 返回 的 唯一 的 一 个 字段 
是 TID ， 然后 ModifyTable 节点 简单 地 使 用 这 个 TID 访问 每 个 目标 行 ， 并 且 把 它们 标记 为 已 
删除 。 
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系统 表 是 关系 型 数据 库 管 理 系 统 存放 结构 元 数据 的 地 方 ， 比 如 表 和 字段 以 及 内 部 登记 信息 
等 。 PostgreSQL 的 系统 表 就 是 普通 表 。 你 可 以 删除 然后 重建 这 些 表 、 增加 列 、 插 入 和 更 新 
数值 ， 然 后 彻底 把 系统 搞 垮 。 不 应 该 手工 修改 系统 表 ， 通常 总 有 SQL 命令 可 以 做 这 些 事情 。 
比如 ， CREATE DATABASE 向 pg_database 表 插 入 一 行 ， 并 且 实 际 上 在 磁盘 上 创建 该 数据 库 。 
有 几 种 特别 深奥 的 操作 例外 ， 比 如 增加 索引 访问 方法 。 


47.1. 概述 


Table 47-1 列 出 了 系统 表 。 每 个 表 更 详细 的 文档 在 后 面 。 


大 多 数 系 统 表 都 是 在 数据 库 创建 的 过 程 中 从 模版 数据 库 中 拷贝 过 来 的 ， 因 此 都 是 数据 库 相 关 
的 。 少数 表 是 在 一 个 集群 中 物理 上 所 有 数据 库 共 享 的 ; 这 些 表 在 独立 的 表 的 描述 中 用 指明 
了 。 


Table 47-1. 系统 表 


REF 用 途 
pg_aggregate 聚集 函数 
pg_am 索引 访问 方法 
pg_amop 访问 方法 操作 符 
pg_amproc 访问 方法 支持 过 程 
pg_attrdef 字段 缺 省 值 
pg_attribute 表 的 列 ("属性 ") 
pg_authid 认证 标识 符 ( 角 色 ) 
pg_auth_members 认证 标识 符 成 员 关 系 
pg_cast 转换 (数据 类 型 转换 ) 
pg_class KR RI ÆI, AA ("KR") 
pg_constraint 检查 约束 、 唯 一 约束 、 主 键 约束 、 外 键 约束 
pg_collation 排序 规则 (本 地 信息 ) 
pg_conversion 编码 转换 信息 
pg_database 本 集群 内 的 数据 库 
pg_db_role_setting 每 个 角色 和 每 个 数据 库 设 置 
pg_default_acl 对 象 类 型 的 缺 省 权限 
pg_depend 数据 库 对 象 之 间 的 依赖 性 
pg_description 数据 库 对 象 的 描述 或 注释 
pg_enum 定义 枚 举 标签 和 值 
pg_event_trigger 事件 触发 器 
pg_extension 安装 扩展 


pg_foreign_data_wrapper 定义 外 部 数据 封装 器 
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pg ts dict 
pg_ts_parser 
pg_ts_template 
pg_type 


pg_user_mapping 
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BeIREWRAKNER. RENN] -TRERIRST LACS RANT RHF 
字段 ) 进行 操作 的 函数 ， 它 返回 从 这 些 值 中 计算 出 的 一 个 数值 。 典 型 的 聚集 酌 数 是 sun, 
count ，max 。 pg_aggregate 里 的 每 条 记录 都 是 一 条 pg_proc 里 面 的 记录 的 扩展 。 pg_proc 
记录 承载 该 聚集 的 名 字 、 输 入 和 输出 数据 类 型 ， 以 及 其 它 一 些 和 普通 画 数 类 似 的 信息 。 


Table 47-2. pg_aggregate 字段 


名 字 类 型 引用 描述 
聚集 函数 
aggfnoid regproc pg_proc .oid 的 pg_proc 
OID 
aggtransfn regproc pg_proc .oid 转换 函数 
TALEE 
aggfinalfn regproc pg_proc .oid 数 (如 果 没 有 
则 为 需 ) 
关联 排序 操 
aggsortop oid pg_operator .0id 作 符 (如 果 没 
聚集 函数 
, E 
aggtranstype oid pg_type .oid (状态 ) 数 据 
的 数据 类 型 


转换 状态 的 初始 值 。 这 是 一 个 文本 数据 
域 ， 它 包含 初始 值 的 外 部 字符 串 表 现形 
式 。 如 果 数 据 域 是 null ， 那 么 转换 状态 
值 从 null 开始 。 


agginitval text 


新 聚集 函数 是 用 CREATE AGGREGATES SEMA. BSection 35.10 KMAFRSEREH 
数 以 及 转换 本 数 的 含义 等 的 更 多 信息 。 


47.3. pg_am 


pg_am 存储 有 关 索 引 访问 方法 的 信息 。 系 统 支持 的 每 种 索引 访问 方法 都 有 一 行 。 这 个 表 的 内 
容 在 Chapter 54 详 细 讨 论 。 


Table 47-3. pg_am 字段 


名 字 类 型 引用 描述 
a za 行 标识 符 (隐藏 属性 ; 必须 明确 
选择 ) 
amname name 访问 方法 的 名 字 
这 个 访问 方法 的 操作 符 策略 个 
amstrategies ae 数 ， 或 者 如 果 访 问 方 法 没有 一 
个 国定 的 操作 符 策略 集 则 为 0。 
amsupport int2 这 个 访问 方法 的 支持 过 程 个 数 
EET SISI 这 种 访问 方式 是 否 支持 通过 索 


引 字段 值 的 命令 扫描 排序 ? 
这 种 访问 方式 是 否 支持 通过 索 








amcanorderbyop bool 引 字段 上 操作 符 的 结果 的 命 合 
扫描 排序 ? 
amcanbackward bool 这 种 访 问 方式 是 否 支 持 向 后 扫 
描 ? 
、 SS g] es fed 
amcanunique bool Se Ae BSH — R 
Š ar =n PA 
amcanmulticol bool 这 种 访 ] 方 式 是 否 支 持 多 字段 
RII? 
这 种 访问 方式 是 否 支 持 第 一 个 
amoptionalkey bool 索引 字段 上 没有 任何 约束 的 扫 
描 ? 
这 种 访问 方式 是 否 
h bool 
sac ER 2h 持 ScalarArrayOpExpr 搜索 ? 
这 种 访问 方式 是 否 
hnull bool 
aT ae PUNT oe 持 Is NULL / NOT NULL 搜索 ? 
允许 索引 存储 的 数据 类 型 与 列 
amstorage bool 的 数据 类 型 不 同 ? 
JESS NS sk FU AA 
amclusterable bool 允许 在 | 这 种 类 型 的 索引 上 


群集 ? 
允许 这 种 类 型 的 一 个 索引 管理 


ampredlocks bool 


amkeytype 


aminsert 


ambeginscan 


amgettuple 


amgetbitmap 


amrescan 


amendscan 


ammarkpos 


amrestrpos 


ambuild 
ambuildempty 


ambulkdelete 


amvacuumcleanup 


amcanreturn 


amcostestimate 


amoptions 


oid 


regproc 


regproc 


regproc 


regproc 


regproc 


regproc 


regproc 


regproc 


regproc 


regproc 


regproc 


regproc 


regproc 


regproc 


regproc 


pg_type 


pg_proc 


pg_proc 


pg_proc 


pg_proc 


pg_proc 


pg_proc 


pg_proc 


pg_proc 


pg_proc 
pg_proc 


pg_proc 


pg_proc 


pg_proc 


pg_proc 


pg_proc 


.oid 


.Oid 


.Oid 


.Oid 


.Oid 


.Oid 


.Oid 


.Oid 


.Oid 


.Oid 
.Oid 
.Oid 


.Oid 


.Oid 


.Oid 


.Oid 


存储 在 索引 里 的 数 
据 的 类 型 ， 如 果 不 
是 一 个 固定 的 类 型 
则 为 0 


"插入 这 个 行 " PK 


"准备 索引 扫描 " E 
数 


"下 一 个 有 效 行 " K 
数 , 如 果 没 有 则 为 0 


" 抓 取 所 有 有 效 行 " 
EM, 如 果 没有 则 为 
0 


"(重新 ) 开始 索引 
扫描 " 函数 


"索引 扫描 后 清理 " 


"标记 当前 扫描 位 置 " 
exp 


"恢复 已 标记 的 扫描 
位 置 " ER 
"建立 新 素 引 " WR 
"建立 空 素 引 " EBL 
批量 删除 函数 


vacuum 后 的 清理 


检查 是 否 素 引 支持 
唯一 索引 扫描 的 孙 
数 ， 如 果 没 有 则 为 0 


估计 一 个 索引 扫描 
开销 的 画 数 


为 一 个 索引 分 析 和 
确认 reloptions 的 
函数 


47.4. pg_amop 


pg_amop 表 存 储 有 关 和 访问 方法 操作 符 族 关联 的 信息 。 如 果 一 个 操作 符 是 一 个 操作 符 族 中 的 
成 员 ， 那 么 在 这 个 表 中 会 占据 一 行 。 一 个 族 成 员 是 一 个 search 操 作 符 或 一 个 ordering 操 作 
符 。 一 个 操作 符 可 以 在 多 个 族 中 出 现 ， 但 是 不 能 在 一 个 族 中 的 多 个 搜索 位 置 或 多 个 排序 位 置 
中 出 现 。 (尽管 不 太 可 能 ， 但 这 是 允许 的 ， 一 个 操作 符 可 以 被 搜索 和 排序 目的 使 用 。) 


Table 47-4. pg_amop 字段 


名 字 类 型 引用 描述 
行 标识 符 (隐藏 属 
oid oid 性 ; 必须 明确 选 
择 ) 
amopfamily oid pg_opfamily .oid 这 个 项 的 操作 符 族 
amoplefttype oid pg_type .oid 操作 符 的 左 输入 类 型 
amoprighttype oid pg_type .oid 操作 符 的 右 输入 类 型 
amopstrategy int2 操作 符 策略 数 
操作 符 目的 ， 
amoppurpose char s 为 搜索 
或 。 为 排序 
amopopr oid pg_operator .0id 该 操作 符 的 OID 
amopmethod oid pg_am .Oid 索引 访问 方式 操作 符 族 
如 果 是 一 个 排序 操作 符 ， 则 为 这 个 项 
amopsortfamily oid pg_opfamily .oid 排序 所 依据 的 btree 操 作 符 族 ; 如 果 是 


一 个 搜索 操作 符 ， 则 为 0 


"搜索 "操作 符 表 明 这 个 操作 符 族 的 一 个 索引 可 以 被 搜索 ， 找 到 所 有 满足 WHERE 
_indexed_column_ _operator_ _constant_ 的 行 。 显然 ， 这 样 的 操作 符 必 须 返 回 布尔 值 ， 并 
且 它 的 左 输入 类 型 必须 匹配 素 引 的 字段 数据 类 型 。 


"排序 "操作 符 表 明 这 个 操作 符 族 的 一 个 索引 可 以 被 扫描 ， 返 回 以 ORDER BY _indexed_column_ 
_operator_ _constant。 顺序 表示 的 行 。 这 样 的 操作 符 可 以 返回 任意 可 排序 的 数据 类 型 ， 它 
的 左 输入 类 型 也 必须 匹配 索引 的 字段 数据 类 型 。 oRDER BY 的 确切 的 语义 是 

由 amopsortfamily 字段 指定 的 ， 该 字段 必须 为 操作 符 的 返回 类 型 引用 一 个 btree 操 作 符 族 。 


Note: 目前 ， 假 设 排序 操作 符 的 排序 顺序 是 被 族 缺 省 引用 的 ， 也 就 是 Asc NULLS LAST 。 
这 可 以 通过 添加 附加 的 行 来 明确 声明 排序 选项 来 释放 。 





一 个 项 的 amopmethod 必须 匹配 它 包 含 的 操作 符 族 的 opfmethod (包括 amopmethod 是 故意 违 
反 性 能 原因 的 表 结 构 的 规范 化 ) 。 同 样 ， amoplefttype 和 amoprighttype 必须 匹配 引用 的 
pg_operator 的 oprleft 和 oprright o 


47.5. pg_amproc 


pg_amproc 存储 有 关 和 与 访问 方法 操作 符 族 相关 联 的 支持 过 程 的 信息 。 每 个 属于 某 个 操作 符 族 
的 支持 过 程 都 占有 一 行 。 


Table 47-5. pg_amproc 字段 


名 字 类 型 引用 描述 

oid oid 行 标 识 符 (隐藏 属性 ; 必须 明 
确 选 择 ) 

REEE oid pg_opfamily .Oid 该 项 的 操作 符 族 
amproclefttype oid pg_type oid ee 
amprocrighttype oid pg_type .oid Eee eae 
amprocnum int2 支持 过 程 编 号 
amproc regproc pg_proc .oid 过 程 的 OID 


amproclefttype 和 amprocrighttype 字段 的 习惯 解释 ， 他 们 标识 一 个 特定 支持 过 程 支 持 的 操 

作 符 的 左 和 右 输入 类 型 。 对 于 某 些 访 问 方式 ， 他 们 匹配 支持 过 程 本 身 的 输入 数据 类 型 ， 对 其 
他 的 则 不 这 样 。 有 一 个 对 索引 的 " 缺 省 " 支持 过 程 的 概念 ， amproclefttype 和 amprocrighttype 
都 等 于 索引 操作 符 类 的 opcintype o 


47.6. pg_attrdef 


pg_attrdef 表 存 储 字段 缺 省 值 。 字 段 的 主要 信息 存放 在 pg_attribute ( 见 下 文 )。 只 有 明确 声 
明 一 个 缺 省 值 (该 表 何 时 创建 或 字段 何 时 增加 ) 的 字段 在 这 里 有 行 。 


Table 47-6. pg_attrdef 字段 


名 字 类 型 引用 描述 
oid oid 行 标 识 符 (隐藏 属性 ;必须 明确 选择 ) 
adrelid oid pg_class .oid 这 个 字段 所 属 的 表 
adnum int2 pg_attribute .attnum 字段 数目 
adbin pg_node_tree 字段 缺 省 值 的 内 部 表现 形式 
adsrc text 人 类 可 读 的 缺 省 值 的 内 部 表现 形式 


adsrc 是 历史 遗留 ， 最 好 不 要 使 用 它 ， 因为 它 并 未 跟踪 可 能 影响 缺 省 值 表现 形式 的 外 部 变 
化 。 反 编译 adbin 字段 (比如 ， 用 pg_get_expr ) 是 更 好 的 显示 缺 省 值 的 方法 。 


47.7. pg_attribute 

pg_attribute 表 存 储 关 于 表 的 字段 的 信息 。 数 据 库 里 每 个 表 的 每 个 字段 都 在 pg_attribute 里 
有 一 行 。 还 有 用 于 索引 ， 以 及 所 有 在 pg_class 里 有 记录 的 对 象 。 

术语 属性 等 效 于 列 /字段 ， 使 用 它 是 历史 原因 。 


Table 47-7. pg_attribute 字段 


名 字 类 型 引用 描述 

此 字段 

attrelid oid pg_class .oid 所 属 的 
attname name 字段 名 字 

这 个 字 

atttypid oid pg_type .oid 段 的 数 

据 类 型 


控制 ANALYZE 为 这 个 字段 积累 的 统计 细 
节 的 级 别 。 需 值 表示 不 收集 统计 信息 。 f 
数 表 示 使 用 系统 缺 省 的 统计 对 象 。 正 数值 

attstattarget int4 的 确切 信息 是 和 数据 类 型 相关 的 。 对 于 标 
量 数 据 类 型 ， attstattarget 既是 要 收集 
的 "最 常用 数值 " 的 目标 数目 ， 也 是 要 创建 
的 柱状 图 的 目标 数量 。 


attlen int2 是 本 字段 类 型 的 pg_type.typlen 的 拷贝 


字段 数目 。 普 通 字段 是 从 1 开始 计数 的 。 
系统 字段 (比如 oid ) 有 (任意 ) 负 数 。 


如 果 该 字段 是 数组 ， 那 么 是 维 数 ， 否 则 是 
attndims int4 0 。 目 前 ， 一 个 数组 的 维 数 并 未 强制 ， 
此 任何 非 需 值 都 表示 "这 是 一 个 数组 "。 


在 磁盘 上 的 时 候 总 是 -1 ， 但 是 如 果 加 载 
attcacheoff Int4 入 内 存 中 的 行 描述 器 中 ， 它 可 能 会 被 更 新 
以 缓冲 在 行 中 字段 的 偏 移 量 。 


记录 创建 新 表 时 支持 的 类 型 特定 的 数据 ( 比 

如 一 个 varchar 字段 的 最 大 长 度 )。 它 传 
atttypmod int4 递 给 类 型 相关 的 输入 函数 和 长 度 转换 图 数 

当做 第 三 个 参数 。 其 值 对 那些 不 需 

要 atttypmod 的 类 型 通常 为 -1 。 


这 个 字段 类 型 的 pg_type.typbyval BY 
wn 


NO 


attnum int2 


attbyval bool 


这 个 字段 的 类 型 的 pg_type.typstorage 的 


attstorage char 这 个 字段 可 以 在 字段 创建 之 后 改变 ， 以 便 


于 控制 存储 策略 。 
attalign char 这 个 字段 类 型 的 pg_type.typalign 的 拷贝 
这 代表 一 个 非 空 约束 。 可 以 改变 这 个 字段 
OO peas 以 打开 或 者 关闭 这 个 约束 。 
这 个 字段 有 一 个 缺 省 值 ， 此 时 它 对 
atthasdef bool 应 pg_attrdef 表 里 实际 定义 此 值 的 记 
Ko 
这 个 字段 已 经 被 删除 了 ， 不 再 有 效 。 一 个 
已 经 删除 的 字段 物理 上 仍然 存在 表 中 ， 但 
aS an 会 被 分 析 器 忽略 ， 因 此 不 能 再 通过 SQL 
访问 。 
这 个 字段 是 局 部 定义 在 关系 中 的 。 请 注意 
cans ee R 一 个 字段 可 以 同时 是 局 部 定义 和 继承 的 。 
这 个 字段 所 拥有 的 直接 祖先 的 个 数 。 如 果 
attinhcount int4 一 个 字段 的 祖先 个 数 非 需 ， 那么 它 就 不 能 
被 删除 或 重 命名 。 
这 个 字 
及 定义 
的 排序 
规则 ， 
如 果 这 
attcollation oid pg_collation .oid 个 字段 
不 是 排 
序 规则 
数据 类 
型 则 为 
0. 
EER scliten[] ”如果 在 这 个 字段 上 明确 的 获得 任意 ， 则 为 
字段 级 访问 权限 。 
er 属性 级 选项 ， 使 用 "keyword=value" 格 式 的 
字符 串 
ee zi 属性 级 外 部 数据 封装 器 选项 ， 使 


用 "keyword=value" 格 式 的 字符 串 


在 一 个 已 被 删除 字段 的 pg_attribute 记录 里 ， atttypid SRBSHS, (BZ attlen MHS 
从 pg_type 拷贝 的 仍然 有 效 。 这 人 么 安排 是 为 了 对 付 后 来 被 删除 的 字段 的 数据 类 型 也 被 删除 的 
情况 ， 因 为 这 个 时 候 不 再 有 pg_type TS. attlen 和 其 它 字 段 可 以 用 于 解析 表 中 一 行内 容 。 


47.8. pg_authid 


pg_authid 包含 有 关 数 据 库 认证 标识 符 ( 角 色 ) 的 信息 。 一 个 角色 体现 "用 户 " 和 "组 "的 概念 。 一 
个 用 户 实际 上 只 是 一 个 设置 了 rolcanlogin 标志 的 角色 。 任 何 角色 (不 管 是 否 设置 
了 rolcanlogin 标志 ) 都 可 以 有 其 它 角 色 做 为 成 员 ; 参阅 pg auth members o 


因为 这 个 系统 表 包 含 口 售 ， 所 以 它 不 是 公共 可 读 的 。 pg_roles 是 一 个 在 pg_authid 上 的 可 读 
视图 ， 只 是 把 口令 域 填 成 了 空白 。 


Chapter 20 包 含 用 户 和 权限 管理 的 详细 信息 。 


因为 用 户 标识 是 集群 范围 的 ， pg_authid 在 一 个 集群 里 所 有 的 数据 库 之 间 是 共享 的 : 每 个 集 
群 只 有 一 个 pg_authid 拷贝 ， 而 不 是 每 个 数据 库 一 个 。 


Table 47-8. pg_authid 字段 


oid 

rolname 
rolsuper 
rolinherit 
rolcreaterole 


rolcreatedb 


rolcatupdate 


rolcanlogin 


rolreplication 


rolconnlimit 


rolpassword 


rolvaliduntil 


bool 


bool 


int4 


text 


timestamptz 


行 标识 符 (隐藏 属性 ; 必须 明确 选择 ) 

角色 名 称 

角色 拥有 超级 用 户 权 限 

角色 自动 继承 其 所 属 角 色 的 权限 

角色 可 以 创建 更 多 角色 

角色 可 以 创建 数据 库 

角色 可 以 直接 更 新 系统 表 。 如 果 没 有 设置 这 个 字段 
为 真 ， 即 使 超级 用 户 也 不 能 这 人 么 做 。 
角色 可 以 登录 ， 也 就 是 说 ， 这 个 角色 可 以 给 予 会 话 
认证 标识 符 。 


角色 是 一 个 复制 的 角色 。 也 就 是 说 ， 这 个 角色 可 以 
发 起 流 复制 (参阅 Section 25.2.5) 和 使 用 
pg_start_backup 和 pg_stop_backup 设置 /取消 设置 


系统 备份 模式 。 


对 于 可 以 登录 的 角色 ， 限 制 其 最 大 并 发 连接 数 
量 。-1 表示 没有 限制 。 


口令 (可 能 是 加 密 的 ) ; 如 果 没 有 则 为 NULL。 如 果 密 
码 是 加 密 的 ， 该 字段 将 以 ms 字符 串 开 始 ， 后 面 跟 
着 一 个 32 字 符 的 十 六 进 制 MD5 哈 希 值 。 该 MD5 哈 希 
将 是 用 户 的 口令 加 上 用 户 名 。 例如 ， 如 果 用 

È joe 的 口令 为 xyzzy ，PostgreSQL 将 存储 MD5 
哈 希 为 xyzzyjoe 。 不 遵从 这 个 格式 的 密码 被 假设 为 
未 加 密 的 。 


口令 失效 时 间 ( 只 用 于 口令 认证 ) ; 如 果 没 有 失效 期 ， 
则 为 null 


47.9. pg_auth_members 


pg_auth_members 显示 角色 之 间 的 成 员 关 系 。 任 何 非 闭 环 的 关系 集合 都 是 允许 的 。 


因为 用 户 标识 是 集群 范围 的 ， pg_auth_members 是 在 一 个 集群 里 的 所 有 数据 库 之 间 共 享 的 : 每 
个 集群 里 只 有 一 个 pg_auth_members 拷贝 ， 而 不 是 每 个 数据 库 一 个 。 


Table 47-9. pg_auth_members 字段 


Ze 类 型 引用 描述 
roleid oid pg_authid .oid TEAR 员 的 角色 的 
属于 roleid 角色 的 
memben oid pg_authid .Oid 一 个 成 员 的 角色 的 
ID 
grantor oid pg_authid oid ee 员 KRHA 


如 果 member 可 以 把 roleid 角色 的 
成 员 关 系 赋 予 其 它 角 色 ， 则 为 真 。 


admin_option bool 


47.10. pg_cast 


pg_cast 表 存 储 数 据 类 型 转换 路 径 ， 包 括 内 置 路 径 和 用 户 定义 的 路 径 。 


应 该 注意 ， pg_cast 并 不 表示 系统 知道 如 何 执行 的 每 种 类 型 转换 ; 只 表示 那些 不 能 从 某 些 通 
用 法 则 中 推导 出 的 。 例 如 ， 在 一 个 域 类 型 和 它 的 基本 类 型 之 间 的 转换 ， 不 是 明确 的 

由 pg_cast 表示 的 。 另外 一 个 重要 的 例外 是 "automatic MO conversion casts"， 这 些 使 用 数据 
KDA CHVONMMARARM text 或 其 他 字符 串 类 型 转换 的 执行 ， 不 是 由 pg_cast 明确 表 
示 的 。 


Table 47-10. pg cast 字段 


名 字 类 型 引用 描述 
pee oid 行 标识 符 ( 隐 藏 属性 ; 必须 明确 选择 ) 
castsource oid pg_type oid Pr 
casttarget oid pg_type .oid rs ies 
用 于 执行 这 个 
转换 的 函数 的 
castfunc oid pg_proc oid caress 
To 
一 个 函数 ， 那 
AAS. 


标识 这 个 转换 可 以 在 什么 环境 里 调 
Ho e 表示 只 能 进行 明确 的 转换 (使 
用 cast 或 :: 语法 )。 a 表示 在 赋值 给 目 


castcontext char ， 标 字段 的 时 候 陷 含 调用 ， 也 可 以 明确 调 
用 。 i 表示 在 表达 式 中 隐 含 ， 当 然 也 包括 
其 它 情 况 。 
标识 转换 是 怎么 执行 的 。 f 表示 使 用 了 
pee 在 castfunc 字段 里 指定 的 函数 。 i 表示 


使 用 了 输入 /输出 函数 。 b 表示 该 类 型 是 二 
进 制 兼容 的 ， 因此 不 需要 什么 转换 。 


在 pg_cast 里 列 出 的 类 型 转换 函数 必须 总 是 以 类 型 转换 的 源 类 型 作为 它 的 第 一 个 参数 类 型 ， 

并 且 返 回 类 型 转换 的 目的 类 型 作为 它 的 结果 类 型 。 一 个 类 型 转换 画 数 最 多 有 三 个 参数 。 如 果 

出 现 了 第 二 个 参数 ， 必须 是 integer 类 型 ; 它 接受 与 目标 类 型 关联 的 修饰 词 ， 如 果 没 有 ， 就 
是 -1 。 如 果 出 现 了 第 三 个 参数 ， 那么 必须 是 boolean 类 型 ; 如 果 该 类 型 转换 是 一 种 明确 的 转 


换 ， 那 么 它 接 受 true, BUIS false o 


在 pg cast 里 创建 一 条 源 类 型 和 目标 类 型 相同 的 记录 是 合理 的 ， 只 要 相关 联 的 函数 接受 多 过 
一 个 参数 。 这 样 的 记录 代表 "长 度 转换 画 数 "， 他 们 把 该 类 型 的 数值 转换 为 对 特定 的 类 型 修饰 
词 数值 合法 的 值 。 


如 果 一 条 pg_cast 记录 有 着 不 同 的 原 类 型 和 目标 类 型 ， 并 且 有 一 个 接收 多 于 一 个 参数 的 范 
数 ， 那 么 它 就 意味 着 用 一 个 步骤 从 一 种 类 型 转换 到 另外 一 种 类 型 ， 同时 还 附加 一 个 长 度 转 
换 。 如 果 没 有 这 样 的 记录 ， 那 么 转换 成 一 个 使 用 了 类 型 修饰 词 的 类 型 涉及 两 个 步骤 ， 一 个 是 
在 数据 类 型 之 间 转 换 ， 另 外 一 个 是 附加 修饰 词 。 


47.11. 


pg_class 


pg class 表 记 载 表 和 几乎 所 有 有 字段 或 者 是 那些 类 似 表 的 东西 。 包括 索引 (不 过 还 要 参 
阅 pg_index )、 序 列 、 视 图 、 物 化 视图 、 复合 类 型 和 一 些 特殊 关系 类 型 ; 参阅 relkind 。 在 
下 面 ， 当 指 所 有 这 些 对 象 的 时 候 说 "关系 "(relations)。 不 是 所 有 字段 对 所 有 关系 类 型 都 有 意 


义 。 


Table 47-11. pg_class 字段 


oid 


relname 


relnamespace 


reltype 


reloftype 


relowner 


relam 


relfilenode 


reltablespace 


类 型 引用 
i 行 标识 符 (隐藏 属性 ; 必须 明确 选 
择 ) 
name 表 、 索 引 、 视 图 等 的 名 字 。 
oid pg_namespace .Oid 
oid pg_type .oid 
oid pg_type .oid 
oid pg_authid .oid 
oid pg_am .Oid 


这 个 关系 在 磁盘 上 的 文件 的 名 
字 ，0 表 示 这 是 一 个 "映射 的 " 关 


ii JE 

a 系 ， 它 的 文件 名 取决 于 行 级 别 
的 状态 

oid pg_tablespace .oid 


包含 这 个 关系 的 
名 字 空 间 ( 模 式 ) 的 
OID 


如 果 有 ， 则 为 对 
应 这 个 表 的 行 类 
型 的 数据 类 型 的 
OID(51 43, 
它们 没 

有 pg_type 记 
录 )。 


对 于 类 型 表 ， 为 
底层 复合 类 型 的 
OID， 对 于 所 有 
其 他 关系 为 0 


关系 所 有 者 


如 果 行 是 索引 ， 
那么 就 是 所 用 的 
访问 模式 (B-tree， 
hash 等 等 ) 


这 个 关系 存储 所 
在 的 表 空间 。 如 
RAR, NER 
FRAASE 
的 缺 省 表 空 间 。 
RARE A 


relpages 


reltuples 


relallvisible 


reltoastrelid 


reltoastidxid 


relhasindex 


relisshared 


relpersistence 


relkind 


int4 


float4 


int4 


bool 


bool 


char 


char 


上 没有 文件 ， 则 


这 个 字段 没有 什 
么 意义 。 
以 页 (大 小 为 BLcksz ) 的 此 表 在 
磁盘 上 的 形式 的 大 小 。 它 只 是 
规划 器 用 的 一 个 近似 值 ， 是 
FH vacuum ，ANALYZE 和 几 个 
DDL aes, tb 
如 CREATE INDEX 更 新 。 
表 中 行 的 数目 。 只 是 规划 器 使 用 
的 一 个 估计 值 ， 
FH vacuum , ANALYZE 和 几 个 
DDL aa, tb 
如 CREATE INDEX 更 新 。 
在 表 的 可 见 映射 中 标记 所 有 可 见 
的 页 的 数目 。 只 是 规划 器 使 用 的 
Sa tel ee 
FH vacuum , ANALYZE 和 几 个 
DDL 命令 ， 比 
如 CREATE INDEX 更 新 。 
与 此 表 关 联 的 


TOAST 表 的 OID 
， 如 果 没 有 为 0 
。TOAST 表 在 一 
个 从 属 表 里 " 离 
线 "存储 大 字段 。 


对 于 TOAST 表 
是 它 的 索引 的 
OID, MARE 
TOAST 表 则 为 0 


pg_class .Oid 


pg_class .0id 


如 果 它 是 一 个 表 而 且 至 少 有 (或 
者 最 近 有 过 ) 一 个 索引 ， 则 为 
真 


FTO 


如 果 该 表 在 整个 集群 中 由 所 有 数 
据 库 共 享 则 为 真 。 只 有 某 些 系统 
表 (比如 pg_database ) 是 共享 


y 
o 


p = permanent table (永久 
X) , u = unlogged table (未 
加 载 的 表 ) , t = temporary 
table (临时 表 ) 


r = ordinary table (普通 表 ) , 
i =index (索引 ) , s = 
sequence (序列 ) , v = 
view (视图 ) ，m = 
materialized view (物化 视图 ) ， 
c = composite type (复合 类 


relnatts 


relchecks 


relhasoids 


relhaspkey 


relhasrules 


relhastriggers 


relhassubclass 


relispopulated 


relfrozenxid 


relminmxid 


relacl 


reloptions 


int2 


int2 


bool 


bool 


bool 


bool 


bool 


bool 


aclitem[] 


text[] 


型 ) ，t = TOAST 
table (TOAST 表 ) , f = 
foreign table (外 部 表 ) 


关系 中 用 户 字段 数目 (除了 系统 
字段 以 外 )。 在 pg_attribute 里 
肯定 有 相同 数目 对 应 行 。 又 


见 pg_attribute.attnum 。 


表 里 的 cHEck 约束 的 数目 ; 参 


阅 pg_constraint X 


如 果 为 关系 中 每 行 都 生成 一 个 
OID NAB 


如 果 这 个 表 有 一 个 (或 者 佛经 有 
一 个 ) 主 键 ， 则 为 真 。 


如 表 有 (或 佛经 有 ) 规则 就 为 
真 ; 参阅 pg_rewrite 表 


如 果 表 有 (或 者 佛经 有 ) 触 发 器 ， 
WAH ; 参阅 pg_trigger 表 


如 果 有 (或 者 佛经 有 ) 任 何 继承 的 
子 表 ， 为 真 。 


如 果 关 系 是 填充 的 则 为 真 (对 所 
有 关系 为 真 ， 除 了 一 些 物化 视 
图 ) 


该 表 中 所 有 在 这 个 之 前 的 事务 
ID 已 经 被 一 个 固定 的 ("frozen") 
事务 ID Bie. 这 用 于 跟踪 该 表 
是 否 需要 为 了 防止 事务 ID BS 
或 者 允许 收缩 pg_clog 而 进行 
清理 。 如 果 该 关系 不 是 表 则 为 需 


( InvalidTransactionId )。 


该 表 中 所 有 在 这 个 之 前 的 多 事务 
ID 已 经 被 一 个 事务 ID 替换 。 这 
用 于 跟踪 该 表 是 否 需要 为 了 防止 
多 事务 ID BARNARD 

缩 pg_clog 而 进行 清理 。 如 果 
该 关系 不 是 表 则 为 雳 


( InvalidTransactionId )。 


访问 权限 。 参 六 GRANT 和 
REVOKE 获 取 详 细 信 息 。 


访问 方法 特定 的 选项 ， 使 
用 "keyword=value" 格 式 的 字符 
串 


pg_class 中 的 几 个 布尔 标识 是 懒 于 维护 的 : 如 果 这 是 正确 的 状态 则 他 们 被 保证 为 真 ， 但 是 当 
状态 不 再 是 真 时 不 会 被 立马 重新 设置 为 假 。 例 如 ， relhasindex 是 由 CREATE INDEX 设置 的 ， 
但 是 从 不 用 prop INDEX 删除 。 相反 ， 如 果 发 现 表 没有 索引 了 ， 由 vacuum A 

除 relhasindex 。 这 个 安排 避免 了 竞 态 条 件 ， 提 高 了 并 发 性 。 


47.12. pg_event_trigger 


pg_event_trigger 表 存 储 时 间 触发 器 。 参阅 Chapter 37 获取 详细 信息 。 


Table 47-12. pg_event_trigger 字段 


一 一 | 
名 字 
evtname 


evtevent 


evtowner 


evtfoid 


evtenabled 


evttags 


类 型 
name 


name 


oid 


char 


text[] 


引用 


触发 器 名 字 ( 必 须 是 唯一 的 ) 
标识 触发 器 触发 的 事件 


pg_authid .oid 


pg_proc .Oid 


控制 在 哪个 session_replication_role 模 块 中 触发 事件 
触发 器 。 o = 触发 器 在 "origin" 和 "local" 模 块 里 面 触 
R, D = 禁用 触发 器 ， R = 触发 器 在 "replica" 模 块 
里 面 触 发 ， A = 触发 器 总 是 触发 。 


这 个 触发 器 将 要 触发 的 命 命 标 签 。 如 果 为 NULL， 这 个 
触发 器 的 触发 不 受命 命 标 签 的 基础 限制 。 


Et iit 


47.13. pg_constraint 

pg_constraint 存储 表 上 的 检查 约束 、 主键 、 唯一 约束 、 外 键 约束 和 排除 约束 。 字段 约束 不 
会 得 到 特殊 对 待 。 每 个 字段 约束 都 等 效 于 某 些 表 约 束 。 非 空 约束 记录 在 pg_attribute RH, 
未 定义 的 约束 触发 器 (用 CREATE CONSTRAINT TRIGGER 创建 ) 也 在 此 表 中 产生 一 个 条 目 。 

在 域 上 面 的 检查 约束 也 存储 在 这 里 。 


Table 47-13. pg constraint FES 


ATF 类 型 引用 描述 
SS 了 行 标识 符 (隐藏 属性 ; 必须 明 
确 选 择 ) 
conname name 约束 名 (不 一 定 是 唯一 的 !) 
A> ro 
connamespace oid pg_namespace .Oid ze 


contype char 
Tu X 。= 排除 约束 
condeferrable bool 这 个 约束 可 以 推迟 吗 ? 


condeferred bool 缺 省 时 这 个 约束 是 否 推 过 
的 ? 
这 个 约束 经 过 验证 了 吗 ? 目 
convalidated bool 前 ， 外 键 约 束 和 CHECK 约 
束 只 能 是 假 
这 个 约束 所 在 的 表 ; 
conrelid oid pg_class .oid 如 果 不 是 表 约 束 则 为 
0 
| | l 这 个 约束 所 在 的 域 ; 
contypid pg_type oid 如 果 不 是 一 个 域 约束 
则 为 0 
如 果 是 唯一 、 主 键 、 
conindid oid pg_class .oid a 
引 ; 否则 为 0 
confrelid oid pg_class .oid men eA D 


外 键 更 新 操作 代码 : a 
无 动作 ，r = 限制 ，c 


confupdtype char 


confupdtype 


confdeltype 


confmatchtype 


conislocal 


coninhcount 


connoinherit 


conkey 


confkey 


conpfeqop 


conppeqop 


conffeqop 


conexclop 


conbin 


consrc 


char 


char 


char 


bool 


int4 


bool 


int2[] 


int2[] 


oid[] 


oid[] 


oid[] 


oid[] 


pg_node_tree 


text 


级 联 ，n = 设置 为 空 ，d = 
设置 为 缺 省 


外 键 删 除 操作 代码 : a = 
无 动作 ， la 一 限制 ， c = 
级 联 ，n = 设置 为 空 , d = 
设置 为 缺 省 


外 键 匹 配 类 型 : f = 全 部 ， 
p = 部 分 s = 简单 的 


这 个 约束 是 为 关系 本 地 定义 
的 。 请 注意 ， 约 束 可 以 本 地 
定义 和 同时 继承 。 

这 个 约束 直接 继承 祖先 的 数 
量 。 一 个 拥有 非 雳 祖先 的 约 
束 不 能 被 删除 或 重 命名 。 


这 个 约束 是 为 关系 本 地 定义 
的 。 它 是 一 个 非 继承 的 约 


lel 


pg_attribute .attnum 


pg_attribute .attnum 


pg_operator .0id 


pg_operator .0id 


pg_operator .0id 


pg_operator .Oid 


如 果 是 一 个 检查 约束 ， 那 就 
是 其 表达 式 的 内 部 形式 


如 果 是 检查 约束 ， 则 是 表达 
式 的 人 类 可 读 形 式 


如 果 是 表 约 束 (AS 
外 键 ， 但 是 不 包含 约 
束 触发 器 ) ， 则 是 约 
束 字段 的 列表 


如 果 是 一 个 外 键 ， 是 
参考 的 字段 的 列表 


如 果 是 一 个 外 键 ， 是 
PK = FK 比 较 的 相等 
操作 符 的 列表 


如 果 是 一 个 外 键 ， 是 
PK = PK 比较 的 相等 
操作 符 的 列表 


如 果 是 一 个 外 键 ， 是 
FK = FK 比 较 的 相等 
操作 符 的 列表 


如 果 是 一 个 排除 约 
束 ， 是 每 个 字段 排除 
操作 符 的 列表 
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Note: consrc 在 被 引用 的 对 象 改 变 之 后 不 会 被 更 新 ， 它 不 会 跟踪 字段 的 名 字 修改 。 与 其 
依赖 这 个 字段 ， 最 好 还 是 使 用 pg_get_constraintdef() 来 抽取 一 个 检查 约束 的 定义 。 


Note: pg_class.relchecks 需要 和 在 此 表 上 为 每 个 关系 找到 的 检查 约束 的 数 目 一 致 。 


47.13. pg_constraint 2135 


47.14. pg_collation 


pg_collation 表 描 述 可 用 的 排序 规则 ， 本 质 上 从 一 个 SQL 名 字 映 射 到 操作 系统 本 地 类 别 。 FS 
J Section 22.2 获 取 详 细 信息 。 


Table 47-14. pg collation 字段 


名 字 类 型 引用 描述 
a ey 行 标识 符 (隐藏 属性 ; 必须 明确 选 
择 ) 
collname name 排序 规则 名 (每 个 名 字 空 间 和 编 
码 唯一 ) 

Aor AN 人 
collnamespace oid pg_namespace .oid Sae 
colonne oid pg_authid .oid 排序 规则 的 所 有 者 
collencoding int4 排序 规则 可 用 的 编码 ， 如 果 适 用 

于 任意 编码 为 -1 
collcollate name 这 个 排序 规则 对 象 
的 LC_COLLATE 
coLTCEYRE name 这 个 排序 规则 对 象 的 LC CTYPE 


请 青 注意 3 这 个 表 中 的 主键 是 ( collname , collencoding , collnamespace ) 不 只 是 ( collname , 
collnamespace )。 PostgreSQL 通 常 忽 略 所 有 的 collencoding 不 等 于 当前 数据 库 编 码 或 -1 的 
排序 规则 ， 并 且 和 collencoding = -1 里 的 条 目 有 相同 名 字 的 新 条 目的 创建 是 被 禁止 的 。 因 
此 ， 使 用 一 个 受 限 制 的 SQL 名 字 ( _schema_ ._name_) 足 够 去 定义 一 个 排序 规则 ， 即 使 根据 表 
的 定义 这 不 是 唯一 的 。 这 种 方式 定义 表 的 原因 是 initdb 在 集群 初始 化 时 用 所 有 在 系统 上 可 用 的 
区 域 设 置 的 条 目 填充 了 它 ， 所 以 必须 能 够 保持 所 有 可 能 在 集群 中 用 的 到 编码 的 条 目 。 





在 templateo 数据 库 中 ， 创 建 编 码 不 匹配 数据 库 编码 的 排序 规则 可 能 是 有 用 的 ， 因为 他 们 可 
以 匹配 稍 后 从 templateo 复制 来 的 数据 库 编 码 。 目 前 这 些 必 须 手动 完成 。 


47.15. pg conversion 


pg_conversion 描述 编码 转换 信息 。 参 阅 CREATE CONVERSIONR RE SER. 


Table 47-15. pg_conversion 字段 


oid 


conname 


connamespace 


conowner 
conforencoding 
contoencoding 
conproc 


condefault 


类 型 


oid 


name 


oid 

oid 
int4 
int4 
regproc 


bool 


引用 


行 标 识 符 ( 隐 藏 属性 ; 必须 明 
确 选择 ) 


转换 名 字 ( 在 一 个 名 字 空 间 里 
是 唯一 的 ) 


pg_namespace .Oid 


pg_authid .oid 
源 编码 ID 
目的 编码 ID 
pg_proc .oid 


如 果 这 是 缺 省 转换 则 为 真 


包含 这 个 转换 的 名 字 空 
间 的 OID 


编码 转换 的 属 主 


转换 过 程 


47.16. pg_database 


pg_database 表 存 储 关于 可 用 数据 库 的 信息 。 数 据 库 是 用 CREATE DATABASE 创 建 的 。 参 
考 Chapter 21 获取 一 些 参数 的 详细 含义 。 


和 大 多 数 系 统 表 不 同 ， pg_database 是 在 一 个 集群 里 的 所 有 数据 库 共 享 的 : 每 个 集群 只 有 一 
份 pg_database 拷贝 ， 而 不 是 每 个 数据 库 一 份 。 


Table 47-16. pg database 字段 


AF 类 型 引用 描述 
a sH 行 标识 符 ( 隐 藏 属性 ; 必须 明 
确 选 择 ) 
datname name 数据 库 名 字 


类 月 通常 为 其 : 
datdba oid pg_authid .oid 2 is AA 


数据 库 的 字符 编码 方式 

( pg_encoding_to_char() 能 
够 料 这 个 数字 转换 为 相应 的 
编码 名 称 ) 


这 个 数据 库 的 
LC_COLLATE 


datctype name 这 个 数据 库 的 LC_CTYPE 
如 果 为 真 则 此 数据 库 可 以 用 


CREATE DATABASE 的 
TEMPLATE 子 句 ， 把 新 数据 
库 创 建 为 此 数据 库 的 克隆 。 


如 果 为 假 则 没有 人 可 以 连接 
到 这 个 数据 库 。 这 个 字段 用 
Tt templateo 数据 库 不 
被 更 改 。 


设置 该 数据 库 上 允许 的 最 大 
datconnlimit int4 并 发 连接 数 ，-1 表示 无 限 
制 |。 


数据 库 里 最 后 一 个 系统 OID 
; 对 pg_dump 特 别 有 用 。 


该 数据 库 中 中 所 有 在 这 个 之 
前 的 事务 ID 已 经 被 一 个 固 
定 的 ("frozen") #4 ID 蔡 
换 。 这 用 于 跟踪 该 数据 库 是 
否 需 要 为 了 防止 事务 ID 重 


encoding Int4 


datcollate name 


datistemplate bool 


datallowconn bool 


datlastsysoid oid 


datfrozenxid xid 


datfrozenxid 


datminmxid 


dattablespace 


datacl 


oid 


aclitem[] 


BMA HME 

pg_clog 而 进行 清理 。 它 是 
针对 每 个 表 
的 pg_class . 
中 的 最 小 值 。 


relfrozenxid 


该 数据 库 中 中 所 有 在 这 个 之 
前 的 多 事务 ID 已 经 被 一 个 
事务 ID 蔡 换 。 这 用 于 跟踪 
该 数据 库 是 否 需要 为 了 防止 
事务 ID Banat ay 
pg_clog 而 进行 清理 。 它 是 
针对 每 个 表 

的 pg_class . 
中 的 最 小 值 。 


relfrozenxid 


pg_tablespace .Oid 
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该 数据 库 的 缺 省 表 空 间 。: 
这 个 数据 库 里 ， 所 

有 pg_class . reltablespa' 
为 需 的 表 都 将 保存 在 这 个 ; 
空间 里 ; 特别 要 指出 的 是 ， 
所 有 非 共享 的 系统 表 也 都 : 
放 在 这 里 。 


47.17. pg_db_role_setting 


pg_db_role setting 记录 已 经 为 运行 时 配置 变量 设置 的 缺 省 值 ， 为 每 个 角色 和 数据 库 的 组 
a 
Oo 


不 像 大 多 数 系统 表 ， pg_db_role_setting 在 一 个 集群 中 的 所 有 数据 库 中 共享 : 这 只 是 每 个 集 
群 pg_db_role_setting 的 一 个 复制 ， 不 是 每 个 数据 库 。 


Table 47-17. pg_db_role_setting 字段 


名 字 关 弄 引用 描述 
wl eS SE HŽ 人 里 
setdatabase oid pg_database oid ee 
setrole oid pg_authid .oid 人 
setconfig text[] 默认 为 运行 时 配 


ate 


47.18. pg default_acl 


pg_default_acl 表 存 储 分 配给 新 创建 对 象 的 初始 化 权限 。 


Table 47-18. pg_default_acı 字段 


名 字 3 引用 描述 
seins ar 行 标 识 符 (隐藏 属性 ;必须 明确 
选择 ) 
defaclrole oid pen Oid a 
与 这 个 条 目 相关 
defaclnamespace oid pg_namespace .oid i nl 
为 0 


这 个 条 目的 对 象 的 类 型 : r = 
defaclobjtype char 关系 ( 表 ， 视图 ) ,Ss = 序列 ， 
f = WA, 1 = 类 型 
这 种 类 型 的 对 象 在 创建 时 应 该 
有 的 访问 权限 


defaclacl aclitem[] 


pg_default_acl 条 目 显 示 了 分 配给 属于 指定 用 户 的 对 象 的 初始 权限 。 当前 有 两 种 条 目 类 

型 : defaclnamespace = 0 的 "全 局 "条 目 ， 和 引用 一 个 特定 模式 的 "每 模式 "条 目 。 如 果 当 前 是 
全 局 条 目 ， 那么 它 为 每 个 对 象 类 型 重 写 正常 硬 链 接 的 缺 省 权限 。 如 果 当 前 是 每 模式 条 目 ， 表 
示 权 限 被 添加 到 全 局 或 硬 链 接 的 缺 省 权限 。 


请 注意 ， 当 一 个 ACL 条 目 在 另 一 个 表 中 为 空 时 ， 用 来 为 它 的 对 象 表示 硬 链接 的 缺 省 权限 ， 不 
是 此 刻 可 能 在 pg_default_acl 中 的 东西 。 pg_default_acl 只 在 对 象 创建 时 访问 。 


47.19. pg depend 


pg_depend Riz, 录 数 据 库 对 象 之 间 的 依赖 关系 。 这 个 信息 允许 DROP 命令 找 出 哪些 其 它 对 象 必 
须 由 prop cASCADE WIR, 或 者 是 在 DROP restrict 的 情况 下 避免 删除 。 


这 个 表 的 功能 类 似 pg_shdepend ， 用 于 记录 那些 在 数据 库 集群 之 间 共 享 的 对 象 之 间 的 依赖 性 
关系 。 


Table 47-19. pg depend 字段 


名 字 类 型 引用 描述 
有 倚赖 对 

classid oid pg_class .oid Z 
OID 
指定 的 依 

ahaa oid 任意 OID 属性 赖 对 象 的 
OID 


对 于 表 字 段 ， 这 个 是 该 属性 的 字段 数 
objsubid int4 ( objid 和 classid 引用 表 本 身 )。 对 于 所 有 其 
它 对 象 类 型 ， 目 前 这 个 字段 是 需 。 


被 引用 对 
象 所 在 的 
系统 表 的 
OID 


指定 的 被 
refobjid oid 任意 OID 属性 引用 对 象 
的 OID 


refclassid oid pg_class .oid 


对 于 表 字段 ， 这 个 是 该 字段 的 字段 号 
refobjsubid int4 ( refobjid 和 refclassid 引用 表 本 身 )。 对 于 
所 有 其 它 对 象 类 型 ， 目 前 这 个 字段 是 替 。 
一 个 定义 这 个 依赖 关系 特定 语义 的 代码 。 见 下 


o 


deptype char 


在 所 有 情况 下 ， 一 个 pg_depend 记录 表示 被 引用 的 对 象 不 能 在 有 依赖 的 对 象 被 删除 前 删除 。 
不 过 ， 这 里 还 有 几 种 由 deptype 定义 的 情况 : 


DEPENDENCY_NORMAL (n) 


独立 创建 的 对 象 之 间 的 一 般 关 系 。 有 倚 吉 的 对 象 可 以 在 不 影响 被 引用 对 象 的 情况 下 删除 。 被 
引用 对 象 只 有 在 声明 了 casca 的 情况 下 油 除 ， 这 时 有 依赖 的 对 象 也 被 删除 。 例子 : 一 个 表 
字段 对 其 数据 类 型 有 一 般 依赖 关系。 


DEPENDENCY_AUTO (a ) 


有 依赖 对 象 可 以 和 被 引用 对 象 分 别 删 除 ， 并 且 如 果 删 除了 被 引用 对 象 则 应 该 被 自动 删除 (不 管 
是 RESTRICT 或 cascabe 模式 )。 例 子 : 一 个 表 上 面 的 命名 约束 是 在 该 表 上 的 自动 依赖 关系 ， 
因此 如 果 和 删除 了 表 ， 它 也 会 被 删除 。 


DEPENDENCY_INTERNAL ( i ) 


有 依赖 的 对 象 是 作为 被 引用 对 象 的 一 部 分 创建 的 ， 实 际 上 只 是 它 的 内 部 实现 的 一 部 分 。 

prop 有 依赖 对 象 是 不 能 直接 允许 的 (将 告诉 用 户 发 出 一 条 删除 被 引用 对 象 的 bpRoP )。 一 个 对 
被 引用 对 象 的 prop 将 传播 到 有 依赖 对 象 ， 不 管 是 否 声明 了 cAscApE 。 例子 : 一 个 创建 来 强 
制 外 键 约束 的 触发 器 在 该 约束 的 pg_constraint 记录 上 是 标记 为 内 部 依赖 的 。 


DEPENDENCY_EXTENSION (e) 


依赖 对 象 是 被 依赖 对 象 extension 的 一 个 成 员 (参阅 pg extension ) 。 依赖 对 象 只 可 以 通过 
在 被 依赖 对 象 上 DROP EXTENSION 删除 。 本 数 上 这 个 依赖 类 型 和 内 部 依赖 一 样 动 作 ， 但 是 它 为 
了 清晰 和 简化 pg_dump 保 持 分 开 。 


DEPENDENCY PIN ( p) 


没有 有 依赖 对 象 ; 这 种 类 型 的 记录 标志 着 系统 本 身 依赖 于 被 引用 对 象 ， 因 此 这 个 对 象 决 不 能 
HR. 这 种 类 型 的 记录 只 有 在 initdb 的 时 候 创 建 。 有 依赖 对 象 的 字段 里 是 需 。 


将 来 可 能 还 会 有 其 它 依赖 的 风格 。 


47.20. pg description 


pg_description 表 可 以 给 每 个 数据 库 对 象 存储 一 个 可 选 的 描述 (注释 )。 你 可 以 用 COMMENT 
命令 操作 这 些 描述 ， 并 且 可 以 用 psql 的 \d 命令 查看 。 许 多 内 置 的 系统 对 象 的 描述 提供 了 


pg_description 的 初始 内 容 。 


pg_shdescription 提供 了 类 似 的 功能 ， 它 记录 了 整个 集群 范围 内 共享 对 象 的 注释 。 


Table 47-20. pg_description 字段 


objoid 


classoid 


objsubid 


description 


类 型 


oid 


oid 


int4 


text 


引用 


任意 oid 属性 


pg_class .0id 


对 于 一 个 表 字 段 的 注释 ， 它 是 字段 号 
( objoid 和 classoid 指向 表 自 身 )。 对 于 其 它 
HREM, CEB. 


作为 对 该 对 象 的 描述 的 任意 文本 


描述 


这 条 描述 所 
描述 的 对 象 
的 OID 


这 个 对 象 出 
现 的 系统 表 
的 OID 


47.21. pg_enum 


pg_enun 表 包 含 显 示 每 个 枚 举 类 型 值 和 标签 的 记录 。 给 定 枚 举 类 型 的 内 部 表示 实际 上 
是 pg_enum 里 面相 关 行 的 OID。 


Table 47-21，pg_enum 字段 


名 字 类 型 引用 描述 
ead ET 行 标识 符 (隐藏 属性 ; 必须 明 
确 选择 ) 
enumtypid oid pg_type .Oid 拥有 这 个 枚 举 值 


的 pg_type 记录 的 OID 


这 个 枚 举 值 在 它 的 枚 举 类 型 
中 的 排序 位 置 


enumlabel name 这 个 枚 举 值 的 文本 标签 


enumsortorder float4 


pg_enum 行 的 OID 跟 着 一 个 特殊 规则 : 偶数 的 OID 保 证 用 和 它们 的 枚 举 类 型 一 样 的 排序 顺序 排 
序 。 也 就 是 ， 如 果 两 个 偶数 OID 属 于 相同 的 枚 举 类 型 ， 那 么 较 小 的 OID 必 须 有 较 

小 enumsortorder 值 。 奇数 OID 需 要 富 无 关系 的 排序 顺序 。 这 个 规则 允许 枚 举 比较 例 程 在 许多 
常见 情况 下 避 开 目录 查找 。 创建 和 修改 枚 举 类 型 的 例 程 只 要 可 能 就 尝试 分 配偶 数 OID 给 枚 举 
值 。 

当 创 建 了 一 个 枚 举 类 型 时 ， 它 的 成 员 赋 予 了 排序 顺序 位 置 1.. no 但 是 随后 添加 的 成 员 可 能 
会 分 配 enumsortorder 的 负 值 或 分 数值 。 对 这 些 值 的 唯一 要 求 是 它们 要 正确 的 排序 和 在 每 个 
枚 举 类 型 中 唯一 。 


47.22. pg_extension 


pg_extension 表 存 储 了 关于 已 安装 的 扩展 的 信息 。 参阅 Section 35.15 获 取 有 关 扩 展 的 详细 信 
息 。 


Table 47-22. pg_extension 字段 


BF 类 型 引用 描述 
sie er 行 标 识 符 (隐藏 属性 ; 必须 明 
确 选 择 ) 
extname name 扩展 名 
extowner oid pg_authid .oid 扩展 的 所 有 者 
a1 人 人 + 
extnamespace oid pg_namespace .Oid 包含 扩展 的 输出 对 象 的 模 
Sa 


如 果 扩 展 可 以 重新 加 载 到 另 


extrelocatable bool 一 个 模式 则 为 真 
extversion text 扩展 的 版 本 名 
扩展 的 配置 表 
extconfig oid[] pg_class .Oid 的 regclass OID 的 数 
组 ， 如 果 没 有 则 为 NULL 
扩展 的 配置 表 的 whERE 子 
extcondition text[] 句 过 滤 条 件 的 数组 ， 如 果 没 


有 则 为 NULL 


请 注意 ， 不 同 于 大 多 数 有 "namespace" 字 段 的 表 ， extnamespace 并 不 意味 着 扩展 属于 哪个 模 
式 。 扩 展 名 从 不 模式 限定 。 extnamespace 表明 模式 包含 大 多 数 或 所 有 的 扩展 的 对 象 。 如 
果 extrelocatable 为 真 ， 那么 这 个 模式 必须 实际 上 包含 所 有 属于 该 扩展 的 模式 限定 的 对 象 。 


47.23. pg_foreign_data_wrapper 


pg_foreign data wrapper 表 存 储 外 部 数据 封装 器 定义 。 一 个 外 部 数据 封装 器 是 在 外 部 服务 器 
驻 留 外 部 数据 的 机 制 ， 是 可 以 访问 的 。 


Table 47-23. pg_foreign_data_wrapper 字段 


AF 类 型 引用 描述 
ate rt 行 标识 符 (隐藏 属性 ; 必 
须 明确 选择 ) 
fdwname name 外 部 数据 封装 器 名 
fdwowner oid pg_authid .oid 外 部 数据 封装 器 的 所 有 者 


引用 一 个 负责 为 外 部 数据 圭 
Beane ia Be PASAY x IB 
数 。 如 果 没 有 提供 处 理 画 数 
WAS 


SA-A, ix 
验证 器 函数 负责 验证 给 予 外 
部 数据 封装 支 器 的 选项 、 外 

fdwvalidator oid pg_proc .oid 部 服务 器 选项 和 使 用 外 部 数 
据 封 装 器 的 用 户 映射 的 有 效 
性 。 如 果 没 有 提供 验证 器 
RM 4 


fdwhandler oid pg_proc .0id 


访问 权限 ; 参阅 GRANT 


fdwacl aclitem[] 和 REVOKE 获 取 详 细 信 
息 。 
外 部 数据 封装 器 指定 选 
fdwoptions text[] 项 ， 使 


用 "keyword=value" 格 式 
的 字符 串 


47.24. pg_foreign_server 


pg_foreign_server 表 存 储 外 部 服务 器 定义 。 一 个 外 部 服务 器 描述 了 一 个 外 部 数据 源 ， 例 如 一 
个 远程 服务 器 。 外 部 服务 器 通过 外 部 数据 封装 器 访问 。 


Table 47-24. pg foreign_server 字段 


名 字 类 型 引用 描述 

it ay 行 标识 符 (隐藏 属性 ; 必须 明确 选 
择 ) 

srvname name 外 部 服务 器 名 
srvowner oid pg_authid .oid 外 部 服务 器 的 所 有 者 
SR oid pg_foreign_data_wrapper .Oid 人 
srvtype text 服务 器 的 类 型 (可 选 ) 
srvversion text 服务 器 的 版 本 (可 选 ) 


访问 权限 ; GRANTH 
REVOKE 获 取 详 细 信 息 。 

外 部 服务 器 指定 选项 ， 使 
srvoptions text[] 用 "keyword=value" 格 式 的 字符 


o 


srvacl aclitem[] 


47.25. pg_foreign_table 


pg_foreign_table 表 包 含 关于 外 表 的 辅助 信息 。 一 个 外 表 首 先 通 过 一 个 pg_class 记录 表现 ， 


就 像 一 个 普通 表 。 CGH pg_foreign_table 记录 包含 只 和 外 表 相 关 的 信息 ， 没 有 任何 其 他 类 型 
的 天 系 。 


Table 47-25. pg_foreign_table 字段 


名 字 类 型 引用 描述 
i i 1 这 个 外 表 
ftrelid d 
oe oi pg_class .0id fH pg_class 未 的 OiD 
这 个 A 立 q 
ftserver oid pg_foreign_server .Oid o a 
ftoptions text[] 外 表 选 项 ， 使 


用 "keyword=value" 格 式 的 字符 上 串 


47.26. pg_index 


pg_index 包含 关于 索引 的 一 部 分 信息 。 其 它 的 信息 大 多 数 在 pg_class o 


Table 47-26. pg_index 字段 


名 字 


indexrelid 


indrelid 


indnatts 


indisunique 


indisprimary 


indisexclusion 


indimmediate 


indisclustered 


indisvalid 


int2 


bool 


bool 


bool 


bool 


bool 


bool 


类 型 


引用 


pg_class .oid 


pg_class .oid 


索引 中 的 字段 数目 ( 复 
制 


的 pg_class.relnatts ) 


如 果 为 真 ， 这 是 个 唯 
一 索引 


如 果 为 真 ， 该 索引 代 
表 该 表 的 主键 。 这 个 
字段 为 真 的 时 

候 indisunique 应 该 总 
是 为 真 。 


如 果 为 真 ， 那 么 这 个 
索引 支持 一 个 排除 约 
R 


如 果 为 真 ， 立 即 强制 

对 插入 进行 唯一 性 检 

查 ( 如 

果 indisunique 不 为 真 
则 是 不 相关 的 ) 


如 果 为 真 ， 那 么 该 表 
最 后 在 这 个 索引 上 建 
T fk 

RAB, PARR 
引 可 以 用 于 查询 。 如 
果 为 假 ， 那 么 该 索引 
可 能 不 完整 : 仍然 必 
须 

在 INSERT / UPDATE 操 
作 时 进行 更 新 ， 不 过 
不 能 安全 的 用 于 查 
询 。 如 果 是 唯一 索 
引 ， 那 么 唯一 属性 也 


描述 
这 个 索引 在 pg_class 里 
的 记录 的 OID 


使 用 这 个 索引 的 表 
在 pg_class 里 的 记录 的 
OID 


indcheckxmin 


indisready 


indislive 


indkey 


indcollation 


indclass 


indoption 


bool 


bool 


bool 


int2vector 


oidvector 


oidvector 


int2vector 


不 保证 为 真 。 


如 果 为 真 ， 查 询 必 须 
不 是 使 用 索引 ， 知 道 
这 个 pg_index 行 

的 xmin 低 于 它们 

的 TransactionxXmin = 
件 地 平 线 ， 因 为 该 表 
可 能 包含 他 们 能 看 到 
的 不 兼容 的 行 的 断 热 
链 。 


如 果 为 真 ， 该 索引 目 
前 已 准备 好 插入 。 如 
果 为 假 ， 那 么 该 索引 
必须 通 

过 INSERT / UPDATE 操 


作 忽 略 。 


如 果 为 假 ， 那 么 该 索 
引 正 在 被 删除 ， 并 且 
应 该 被 所 有 目的 所 忽 
人 


pg_attribute .attnum 


pg_collation .Oid 


pg_opclass .oid 


这 是 indnatts 值 的 一 
个 数组 ， 存 储 每 个 字 
段 标志 位 。 这 个 标志 
位 的 含义 是 通过 索引 
的 访问 方式 定义 的 。 


这 是 一 个 包 

& indnatts 值 的 数组 ， 
这 些 数组 值 表示 这 个 索 
引 所 建立 的 表 字 段 。 比 
如 一 个 值 为 1 3 的 意思 
是 第 一 个 字段 和 第 三 个 
字段 组 成 这 个 索引 键 

字 。 这 个 数组 里 的 需 表 
明 对 应 的 索引 属性 是 在 
这 个 表 字 段 上 的 一 个 表 
达 式 ， 而 不 是 一 个 简单 
的 字段 引用 。 


对 于 每 个 在 这 个 索引 键 
字 中 的 字段 ， 这 个 字段 
包含 用 于 这 个 索引 的 排 
序 规 则 的 OID。 


对 于 索引 键 字 里 面 的 每 
个 字段 ， 这 个 字段 都 包 
含 一 个 指向 所 使 用 的 操 
作 符 类 的 OID ， 参 
阅 pg_opclass 获取 细 
Fe 


indexprs 


indpred 


pg_node_tree 


pg_node_tree 


表达 式 树 

(以 nodeTostring() 形 
式 表 现 ) 用 于 那些 非 简 
单字 段 引 用 的 索引 属 
性 。 它 是 一 个 列表 ， 
在 indkey 里 面 的 每 个 
雳 条 目 一 个 元 素 。 如 
果 所 有 索引 属性 都 是 
简单 的 引用 ， 则 为 


o 


部 分 索引 断言 的 表达 
式 树 

(以 nodeTostring() 的 
形式 表现 )。 如 果 不 是 
部 分 素 引 ， 则 是 空 字 
符 串 。 


47.27. pg_inherits 


pg_inherits 记录 关于 表 继 承 层次 的 信息 。 数 据 库 里 每 个 直接 的 子 系 表 都 有 一 条 记录 。 


的 继承 可 以 通过 追溯 记录 链 来 判断 。 


Table 47-27. pg_inherits 字段 


名 字 


inhrelid 


inhparent 


inhseqno 


类 型 


oid 


oid 


int4 


引用 


pg_class .oid 


pg_class .oid 


一 一 


如 果 一 个 子 表 存 在 多 个 直系 父 表 (多 重 继承 )， 这 个 数字 
表明 此 继承 字段 的 排列 顺序 。 计数 从 1 开始 。 


间接 


描述 


子 
的 
OID 


47.28. pg_language 


pg_language 登记 编程 语言 ， 你 可 以 用 这 些 语言 或 接口 写 范 数 或 者 存储 过 程 。 参阅 CREATE 
LANGUAGE 和 Chapter 39 获 取 更 多 关于 语言 义理 器 的 信息 。 


Table 47-28. pg language 字段 


oid 


lanname 


lanowner 


lanispl 


lanpltrusted 


lanplcallfoid 


laninline 


lanvalidator 


lanacl 


类 型 


bool 


bool 


aclitem[] 


引用 


行 标识 符 (隐藏 属性 ;必须 明确 
选择 ) 


语言 的 名 字 
pg_authid .oid 


对 于 内 部 语言 而 言 是 假 (比如 

SQL)， 对 于 用 户 定义 的 语言 

则 是 真 。 目前 ，pg_dump 仍 

然 使 用 这 个 东西 判断 哪 种 语言 
Bee, 但 是 这 些 可 能 在 将 
来 被 其 它 机 制 取代 。 

如 果 这 是 可 信 语 言 则 为 真 ， 意 
味 着 系统 相信 它 不 会 被 授予 任 
何 正常 SQL 执行 环境 之 外 的 

权限 。 只 有 超级 用 户 可 以 用 不 
可 信 的 语言 创建 画 数 。 


pg_proc .Oid 


pg_proc .Oid 


pg_proc .Old 


访问 权限 ， 参 闵 GRANT 和 
REVOKE 获 取 细 节 。 


语言 的 所 有 者 


对 于 非 内 部 语言 ， 这 
是 指向 该 语言 处 理 器 
BIH, iB <a 
是 一 个 特殊 函数 ， 
负责 执行 以 某 种 语言 
BNA AR. 


这 个 字段 引用 一 个 负 
责 执行 "inline" 匿 名 代 
码 块 的 函数 (DO 
块 ) 。 如 果 不 支 持 
AAR AS. 


这 个 字段 引用 一 个 语 
ARAARA, Ef 
责 检 查 新 创建 的 函数 
的 语法 和 有 效 性 。 
如 果 没 有 提供 校 验 
a, WAS. 


47.29. pg_largeobject 


pg_largeobject 表 保 存 那 些 标记 着 "大 对 象 "的 数据 。 一 个 大 对 象 是 使 用 其 创建 时 分 配 的 OID 
标识 的 。 每 个 大 对 象 都 分 解 成 足够 小 的 小 段 或 者 "页面 "以 便 以 行 的 形式 存储 
在 pg_largeobject 里 。 每 页 的 数据 定义 为 LoBLKSIZE (目前 是 BLcksz/4 或 者 通常 是 2K F 


节 )。 


PostgreSQL 9.0 之 前 ， 没 有 许可 结构 与 大 对 象 相关 。 因 此 ， pg_largeobject 公开 可 读 并 且 可 
以 用 来 包含 系统 中 所 有 大 对 象 的 OID (MAR) 。 现 在 不 再 是 这 样 了 ; 使 
用 pg_largeobject_metadata 获取 大 对 象 OID 的 列表 。 


Table 47-29. pg_largeobject 字段 


名 字 类型 引用 描述 
| , 包含 本 页 的 大 

loid oid largeobject_metadata .Oid a 
上 对 象 的 标识 符 


pageno int4 本 页 在 其 大 对 象 数 据 中 的 页 码 从 雳 开始 计算 


存储 在 大 对 象 中 的 实际 数据 。 这 些 数 据 绝 不 会 


data bytea 
超过 LoBLKSIZE 字 节 ， 而 且 可 能 更 少 。 


pg_largeobject 的 每 一 行 保存 一 个 大 对 象 的 一 个 页 面 ， 从 该 对 象 内 部 的 字 节 偏 移 
( pageno * LOBLKSIZE ) 开 始 。 这 种 实现 允许 松散 的 存储 : 页 面 可 以 丢失 ， 而 且 可 以 
比 LoBLKsIzE 字 节 少 (即使 它们 不 是 对 象 的 最 后 一 页 )。 大 对 象 内 丢失 的 部 分 读 做 需 。 


47.30. pg_largeobject_metadata 


pg_largeobject_metadata 表 存 储 与 大 数据 相关 的 元 数据 。 实际 的 大 对 象 数据 存储 在 


pg_largeobject E, 


Table 47-30. pg_largeobject_metadata FX 


名 字 类 型 引用 描述 
oid oid 行 标识 符 (隐藏 属性 ; 必须 明确 选择 ) 
lomowner oid pg_authid .oid 大 对 象 的 所 


访问 权限 ; 参阅 GRANT 和 REVOKE 获 取 详 


lomacl acliten[ ] = 
细 信 息 。 


47.31. pg_namespace 


pg_namespace 存储 名 字 空 间 。 名 字 空 间 是 SQL 模式 下 层 的 结构 : 每 个 名 字 空 间 有 独立 的 关 
Rm, 类 型 等 集合 但 并 不 会 相互 冲突 。 


Table 47-31. pg_namespace 字段 


名 字 类 型 引用 描述 
oid oid 行 标识 符 (隐藏 属性 ; 必须 明确 选择 ) 
nspname name 名 字 空 间 的 名 字 


Bao ig Aa 
nspowner oid pg_authid .oid sat a 


访问 权限 ; BJ GRANTAIREVOKE# BX 


nspacl aclitem[] 
细节 。 


47.32. pg_opclass 


pg_opclass ena aes 作 符 类 。 每 个 操作 符 类 为 一 种 特定 数据 类 型 和 一 种 特定 索引 


访问 方法 定义 索引 字段 的 语义 


一 个 操作 符 类 本 质 上 指定 一 个 特定 的 操作 符 族 适用 于 一 个 特 


定 的 可 索引 的 字段 数据 类 型 。 索引 的 字段 实际 可 用 的 族 中 的 操作 符 集 是 接受 字段 的 数据 类 型 
作为 它们 的 左边 的 输入 的 那个 。 


操作 符 类 在 Section 35.14 里 有 比较 详细 的 描述 。 


Table 47-32. pg_opclass 字段 


opcmethod 


opcname 
opcnamespace 
opcowner 
opcfamily 


opcintype 


opcdefault 


opckeytype 


类 型 


bool 


引用 描述 
行 标识 符 (隐藏 属性 ;必须 明 
确 选 择 ) 
操作 符 类 所 服务 的 索引 访问 方 
pg_am .Oid A 


~ 
/ 


这 个 操作 符 类 的 名 字 


pg_namespace .0id 这 个 操作 符 类 的 名 字 空 间 
pg_authid .oid 操作 符 类 属 主 

pg_opfamily .oid 包含 该 操作 符 类 的 操作 符 族 
pg_type .oid 操作 符 类 索引 的 数据 类 型 
如 果 操 作 符 类 

是 opcintype 的 缺 省 ， 则 

为 真 

7 索引 数据 的 类 型 ， 如 果 


和 opcintype HAR] AS 


一 个 操作 符 类 的 opcmethod 必须 匹配 包含 它 的 操作 符 族 的 opfmethod 。 同样 ， 对 于 任意 给 
的 opcmethod 和 opcintype 的 组 合 ， 不 能 有 超过 一 I~ pg_opclass TA opcdefault ABD 


47.33. pg_operator 


pg_operator 存储 有 关 操 作 符 的 信息 。 参 阅 CREATE OPERATOR 和 733.12 获取 这 些 操作 
符 参 数 的 细节 。 


Table 47-33. pg_operator 字段 


名 字 类 型 引用 描述 
oid oid 行 标 识 符 (隐藏 属性 ;必须 明确 选择 ) 
oprname name 操作 符 的 名 字 
oprnamespace oid pg_namespace .Oid panei 
oprowner oid pg_authid .oid 操作 符 所 有 者 


b =infix = 中 组 (" 两 边 )， 1 = 前 


oprkind char 级 ("左边 ")， = - 后 级 ("右边 ") 
oprcanmerge bool 这 个 操作 符 支持 合并 连接 
oprcanhash bool 这 个 操作 符 支 持 Hash 连接 
oprieft oid pg_type .0id 左 操作 数 的 类 型 
oprright oid pg_type .oid 右 操作 数 的 类 型 
oprresult oid pg_type .oid 结果 类 型 
此 操作 符 的 交换 
oprcom oid pg_operator .0id 符 ， 如 果 存 在 的 
话 
此 操作 符 的 反 转 
oprnegate oid pg_operator .Oid 器 ， 如 果 存 在 的 
话 
字 现 这 个 操作 龟 
oprcode regproc pg_proc .Oid 操作 符 
oprrest regproc pg_proc .oid eee eee 
IO 4F ILI = 
oprjoin regproc pg_proc .oid a ees 
选择 性 计算 EE 


未 用 的 字段 包含 震 。 上 比如 ， oprleft 对 于 前 级 操作 符 而 言 是 需 。 


47.34. pg_opfamily 


pg_opfamily 表 定 义 操作 符 族 。 每 个 操作 符 族 是 一 个 操作 符 和 相关 支持 例 程 的 集合 ， 其 中 的 
例 程 实现 为 一 个 特定 的 索引 访问 方式 指定 的 语义 。 另 外 ， 族 中 的 操作 符 都 是 "兼容 的 "， 通过 
由 访问 方式 指定 的 方法 。 操 作 符 族 的 概念 允许 交叉 数据 类 型 操作 符 和 索引 一 起 使 用 ， FAA 
理 的 使 用 访问 方式 的 语义 的 知识 。 

操作 符 族 在 Section 35.14 里 面 描述 。 


Table 47-34. pg opfamily 字段 


名 宇 类 型 引用 描述 
必须 明确 选 
证 


操作 符 族 使 用 的 索引 方 


opfmethod oid pg_am .Oid 
4. 
opfname name 这 个 操作 符 族 的 名 字 
opfnamespace oid pg_namespace .0id 这 个 操作 符 的 名 字 空 间 
opfowner oid pg_authid .oid 操作 符 族 的 所 有 者 


定义 一 个 操作 符 族 的 大 多 数 信息 不 在 它 的 pg_opfamily 行 里 面 ， 而 是 在 相关 的 行 po_amop ， 


pg_amproc 和 pg_opclass 里 。 


47.35. pg_pltemplate 


pg_pltemplate RA it tA 言 存储 "模板 "信息 。 一 个 语 言 的 模板 允许 该 语言 可 以 在 某 个 数据 库 
里 使 用 简单 的 CREATE LANGUAGE 命令 创建 ， 而 不 需要 声明 实现 细节 。 


和 许多 系统 表 不 一 样 ， pg_pltemplate cere oan teh: 每 个 集群 只 有 
I pg_pltemplate 的 拷贝 ， 而 不 是 每 个 数据 库 一 个 。 这 样 就 允许 这 些 信息 在 需要 时 每 个 数 
据 库 都 可 以 访问 。 


Table 47-35. pg_pltemplate 字段 


a 类 型 = 

tmplname name 这 个 模板 所 应 用 的 语言 的 名 字 

tmpltrusted boolean 如 果 语 言 被 认为 是 可 信 的 ， 则 为 真 
tmpldbacreate boolean 如 果 语 言 可 以 通过 数据 库 所 有 者 创建 则 为 
tmplhandler text 调用 义理 器 函数 的 名 字 

tmplinline text 匿名 块 处 理 器 事 数 的 名 字 ， 如 果 没 有 则 为 null 
tmplvalidator text 校 验 函数 的 名 字 ， 如 果 没 有 则 为 NULL 
tmpllibrary text 实现 语言 的 共享 库 的 路 径 

tmplacl aclitem[] 模板 的 访问 权限 (未 使 用 ) 


目前 还 没有 任何 命令 可 以 用 于 操作 过 程 语 言 模板 ; 要 修改 内 置 的 信息 ， 超级 用 户 必须 使 用 普 


通 的 INSERT , DELETE , UPDATE 命 兮 修改 该 表 。 


Note: 很 有 可 能 在 将 来 的 PostgreSQL 版 本 中 删除 pg_pltemplate ， 为 了 支持 过 程 语 言 的 
信息 保持 在 它们 各 自 的 扩展 安装 脚本 中 。 


47.36. pg_proc 


pg_proc RF HAF WA( Rite NR. BRCREATE FUNCTION 和 Section 35.33 RH 


多 信息 。 


该 表 包 含 聚 集 酚 数 和 普通 酌 数 的 数据 。 如 果 proisagg AR, 


一 个 匹配 行 。 


Table 47-36. pg_proc 字段 


Qe 
oid 
proname 
pronamespace 
proowner 


prolang 


procost 


prorows 


provariadic 


protransform 


proisagg 


proiswindow 


prosecdef 


name 


oid 


Float4 


float4 


oid 


regproc 


bool 


bool 


bool 


引用 


行 标 识 符 ( 隐 藏 属性 ;必须 明 
确 选择 ) 


MS 
pg_namespace .Oid 
pg_authid .Oid 


pg_language .oid 


估计 执行 成 本 (以 
cpu_operator_cost 为 单位 ); 


k= 


如 果 proretset , 这 是 每 一 行 
返回 的 成 本 


估计 的 结果 行 数 (如 果 
非 proretset nAg) 


pg_type .Old 


pg_proc .oid 


Ek} 到 
Oe 
A 并 
mt AW 
Oot 
Be} 全 
Oe 


驳 数 是 一 个 安全 定义 器 (也 就 
一 个 "setuid" 画 数 ) 

函数 没有 副作用 。 没 有 关 
该 参数 的 信息 传递 ， 除 非 


HN fill Bet 


那么 在 pg_aggregate 里 应 该 有 


包含 该 函数 名 字 
空间 的 OID 


函数 的 所 有 者 


这 个 本 数 的 实现 
语言 或 调用 接口 


可 变数 组 参数 的 
元 素 的 数据 类 
W, RKR 
有 可 变 参 数 则 为 
= 


AAT 
以 简化 其 他 函数 
(参阅 Section 
35.9.11) 


proleakproof 


proisstrict 


proretset 


provolatile 


pronargs 


pronargdefaults 


prorettype 


proargtypes 


bool 


bool 


bool 


char 


oidvector 


Lane 任何 函数 都 有 
能 抛 出 一 个 错误 ， 取决 于 
记 民 基数 全 是 不 并 业 的 。 


如 果 任 何 调用 参数 是 空 ， 那 
么 图 数 返 回 空 。 这 时 图 数 实 
际 上 连 调用 都 不 调用 。 不 
是 "strict" 的 范 数 必须 准备 处 
理 空 输入 。 


函数 返回 一 个 集合 (也 就 是 
说 ， 指 定数 据 类 型 的 多 个 数 
值 ) 


告诉 该 图 数 的 结果 是 否 只 依 
赖 于 它 的 输入 参数 ， 或 者 还 
会 被 外 接 因 素 影响 。 对 

于 "不 可 变 的 "(immutable) 萎 
数 它 是 i, 这 样 的 函数 对 
于 相同 的 输入 总 是 产生 相同 
的 结果 。 对 于 "稳定 的 " 
(stable) 函数 它 是 s ，( 对 于 
固定 输入 ) 其 结果 在 一 次 扫描 
Be oh oe 
(volatile) HME v, He 
果 可 能 在 任何 时 候 变 化 。 

v 也 用 于 那些 有 副作用 的 函 
数 ， 因 此 调用 它们 无 法 得 到 
优化 。 


参数 数目 
有 缺 省 值 的 参数 的 数量 


pg_type .oid 


pg_type .oid 


返回 值 的 数据 类 
型 


-NERKA 
数 的 数据 类 型 的 
数组 。 数 组 里 只 
包括 输入 参数 ( 包 
括 Inout 和 
VARIADIC 参 
数 )， 因 此 代表 该 
函数 的 调用 签名 
(接口 )。 


一 个 包含 画 数 参 
数 的 数据 类 型 的 
数组 。 数 组 里 包 
括 所 有 参数 的 类 
型 (包括 ouT 

和 INouT 参数 ) ; 
不 过 ， 如 果 所 有 
参数 都 是 IN 参 


proargmodes 


proargnames 


proargdefaults 


prosrc 


probin 


proconfig 


char[] 


text[] 


pg_node_tree 


text 


text 


text[] 


BH, 那么 这 个 字 
段 就 会 是 空 。 请 
注意 数组 下 标 是 
以 1 为 起 点 的 ， 
而 因为 历史 原 
Al, 

ee 的 
下 标 起 点 为 


plies (ME BR A 
组 ， 编 码 如 下 : i KR 

IN SR, oR 

out BR, bX 

INOUT BW, v 表 
VARIADIC BA, tK 
TABLE 参数 。 如 果 所 有 参 
数 都 是 IN 参数 ， 那 么 这 个 
字段 为 空 。 请 注意 ， 下 标 对 
应 的 是 proallargtypes 的 位 
E, 而 不 是 proargtypes o 


—MAF NBER SZ FAY 
数组 。 没 有 名 字 的 参数 在 数 
组 里 设置 为 空 字 符 串 。 a 
没有 一 个 参数 有 名 字 ， 这 个 
字段 将 是 空 。 请 注意 ， 此 数 
组 的 下 标 对 应 
proallargtypes 而 不 

是 proargtypes o 


缺 省 值 的 表达 式 树 

(用 nodeToString() 表 
十 

和 pronargdefaults 参数 一 
起 列 出 的 ， 对 应 最 后 _N_ 个 
ae (也 就 是 ， 最 

后 _N_ 个 proargtypes 位 
DE RW ARAOS 
数 ， 那 么 这 个 字段 为 null。 


这 个 字段 告诉 函数 处 理 器 如 
A. 它 实际 上 对 
于 解释 语言 来 说 就 是 函数 的 
源 程 序 ， 或 者 一 个 链接 符 
号 ， 一 个 文件 名 ， 或 者 是 任 
何其 它 的 东西 ， 具 体 取决 于 
语言 /调用 习惯 的 实现 。 


关于 如 何 调 用 该 函数 的 附加 
信息 。 同 样 ， 其 含义 也 是 和 
语言 相关 的 。 


函数 的 运行 时 配置 变量 的 本 
地 设置 


| 引 | 


S N 
lS 


N 
¢ 


引 | 


访问 权限 ; 参阅 GRANT 和 
proacl aclitem[] REVOKE 获 取 细 节 。 


对 于 内 置 和 动态 加 载 得 编译 函数 ， prosrc TARRI C 语言 名 字 ( 链 接 符 号 )。 对 于 所 有 其 它 
当前 已 知 的 语言 类 型 ， prosrc 包含 该 图 数 的 源 文 本 。 probin 除了 用 于 动态 加 载 的 CWA 
外 没有 其 它 用 途 ， 这 个 时 候 它 给 出 包含 给 函数 的 共享 库 的 文件 名 。 


47.37. pg_range 


pg_range 存储 关于 范围 类 型 的 信息 。 除 了 pg type 里 类 型 的 记录 。 


Table 47-37. pg_range 字段 


名 字 类 型 引用 
rngtypid oid pg_type .oid 
rngsubtype oid pg_type .Oid 
rngcollation oid pg_collation .Oid 
rngsubopc oid pg_opclass .oid 
rngcanonical regproc pg_proc .oid 
rngsubdiff regproc pg_proc .oid 


范围 类 型 的 OID 


这 个 范围 类 型 的 元 素 类 型 (FR 
型 ) 的 OID 

用 于 范围 比较 的 排序 规则 的 OID， 如 
果 没 有 则 为 需 

用 于 范围 比较 的 子 类 型 的 操作 符 类 
的 OID 


转换 范围 类 型 为 规范 格式 的 函数 的 
OID， 如 果 没 有 则 为 0。 


返回 两 个 double precision 元 素 值 
的 不 同 的 函数 的 OID， 如 果 没 有 则 为 
0. 





rngsubopc (如 果 元 素 类 型 是 可 排序 的 则 加 上 rngcollation) 决定 用 于 范围 类 型 的 排序 顺 


序 。 当 元 素 类 型 是 离散 的 时 使 用 rngcanonical o 


高 范围 类 型 上 的 GiST 索 引 的 性 能 。 


rngsubdiff 是 可 选 的 ， 但 是 应 该 应 用 于 提 


47.38. pg_rewrite 


pg_rewrite 存储 为 表 和 视图 定义 的 重 写 规 则 。 


Table 47-38. pg_rewrite 字段 


名 学 类 型 引用 
外 
oid oid 行 标识 符 (隐藏 属性 ; 必须 明确 选择 ) 
rulename name 规则 名 称 
使 
用 
这 
条 
m 
ev_class oid pg_class .oid a 
的 
表 
名 
称 
noua ee 这 条 规则 适用 的 字段 (目前 总 是 为 -1， 表 示 整 个 
表 ) 
SEE P 规则 适用 的 事件 类 型 : 1 = SELECT ,2 = 
UPDATE , 3 = INSERT , 4 = DELETE 
控制 规则 在 哪个 session_replication_ role 模块 
触发 。 0 = 规则 "origin" 和 "local" 模块 触发 
bled h ge! 
anna ras D = 规则 被 禁用 ，R = 规则 在 "replica" 模块 
ARR, A = 规则 总 是 触发 。 
is_instead bool 如 果 该 规则 是 INSTEAD 规则 ， 那 么 为 真 


ev_qual 


ev_action 


pg_node_tree 


pg_node_tree 


规则 的 资格 条 件 的 表达 式 树 
(以 nodetostring() 形式 存在 ) 


规则 动作 的 查询 树 (以 nodeTostring() 形式 存 
在 ) 


Note: 如 果 一 个 表 在 这 个 系统 表 里 有 任何 规则 存在 ， 那 么 pg_class.relhasrules 必须 为 


一 =~o 


47.39. pg_seclabel 


pg_seclabel 表 存 储 数据 对 象 上 的 安全 标签 。 安全 标签 可 以 和 SECURITY LABEL 命 邻 一 起 操 
作 。 查看 安全 标签 的 简单 些 的 方法 请 参阅 Section 47.65。 


pg_shseclabel 表 的 作用 类 似 ， 只 是 它 是 用 于 在 一 个 数据 库 集群 内 共享 的 数据 库 对 象 的 安全 
标签 上 的 。 


Table 47-39. pg_seclabel 字段 


aF 类 型 引用 描述 
这 个 安全 
标签 所 属 
的 对 象 的 
OID 


objoid oid 任意 OID 属 性 


出 现 这 个 
xt RAK 
AA KH 
OID 


classoid oid pg_class .Oid 


对 于 一 个 在 表 字 段 上 的 安全 标签 ， 这 是 字段 号 
objsubid int4 ( objoid 和 classoid 参考 表 本 身 ) 。 对 于 所 有 
其 他 对 象 类 型 ， 这 个 字段 是 需 。 
provider text 与 这 个 标签 相关 的 标签 提供 程序 。 


label text 应 用 于 这 个 对 象 的 安全 标签 。 


47.40. pg_shdepend 


pg_shdepend 记录 数据 库 对 象 和 共享 对 象 (比如 角色 ) 之 间 的 依赖 性 关系 。 这 些 信息 允许 
PostgreSQL 保 证 在 企图 删除 这 些 对 象 之 前 ， 这 些 对 象 是 没有 被 引用 的 。 


pg_depend 表 的 作用 类 似 ， 只 是 它 是 用 于 在 一 个 数据 库 内 部 的 对 象 的 依赖 性 关系 的 。 


和 其 它 大 多 数 系统 表 不 同 ， pg_shdepend 是 在 集群 里 面 所 有 的 数据 库 之 间 共 享 的 : 每 个 数据 
库 集群 只 有 一 个 pg_shdepend , 而 不 是 每 个 数据 库 一 


Table 47-40. pg_shdepend 字段 


名 字 类 型 引用 描述 
依赖 对 象 所 在 的 数 


HER OID, m 


dbid oid pg_database .0id 享 对 象 ， 则 为 
是 共享 
= 

classid oid pg_class .oid alesis 
ta Ap 3 

objid oid ” ”任意 oid 属性 E 


对 于 一 个 表 字 段 ， 这 是 字段 号 
( objid 和 classid 参考 表 本 身 ) o 
对 于 所 有 其 他 对 象 类 型 ， 这 个 字段 为 


o 


objsubid int4 


被 引用 对 象 所 在 的 
refclassid oid pg_class .oid 系统 表 的 OID( 必 须 
是 一 个 共享 表 ) 


指定 的 被 引用 对 象 


refobjid oid 任意 oid 属性 的 OID 


一 段 代 码 ， 定 义 了 这 个 依赖 性 关系 的 特 


deptype char 、 
定语 义 ; 参阅 下 文 。 


在 任何 情况 下 ， 一 条 pg_shdepend 记录 就 表明 这 个 被 引用 的 对 象 不 能 在 未 删除 依赖 对 象 的 前 
提 下 删除 。 不 过 ， deptype 同时 还 标 出 了 几 种 不 同 的 子 风格 : 

SHARED_DEPENDENCY_OWNER (o ) 

被 引用 的 对 象 (必须 是 一 个 角色 ) 是 依赖 对 象 的 所 有 者 。 


SHARED_DEPENDENCY_ACL (a ) 


被 引用 的 对 象 (必须 是 一 个 角色 ) 在 依赖 对 象 的 ACL( 访 问 控制 列表 ， 也 就 是 权限 列表 ) 里 提 到 。 
SHARED_DEPENDENCY_ACL 不 会 在 对 象 的 所 有 者 头 上 添加 的 ， 因 为 所 有 者 会 有 一 个 


SHARED_DEPENDENCY_OWNER 记录 。 
SHARED_DEPENDENCY_PIN ( p) 


没有 依赖 对 象 ; 这 类 记录 标识 系统 自身 依赖 于 该 被 依赖 对 象 ， 因 此 这 样 的 对 象 绝对 不 能 被 删 
Ro 这 种 类 型 的 记录 只 是 由 initdb 创建 。 这 样 的 依赖 对 象 的 字段 都 是 需 。 


其 它 依赖 性 的 风格 可 能 在 将 来 会 出 现 。 请 注意 ， 目 前 的 定义 只 是 支持 把 角色 当 作 被 引用 对 
象 。 


47.41. pg_shdescription 

pg_shdescription 为 共享 数据 库 对 象 存储 可 选 的 注释 。 可 以 使 用 COMMENT 命 邻 操 作 注 释 的 
内 容 ， 使 用 psql 的 \d 命令 查看 注释 内 容 。 

pg_description 提供 了 类 似 的 功能 ， 它 记录 了 单个 数据 库 中 对 象 的 注释 。 


不 同 于 大 多 数 系 统 表 ， pg_shdescription 是 在 集群 里 面 所 有 的 数据 库 之 间 共 享 的 : 每 个 数据 
库 集群 只 有 一 个 pg_shdescription ， 而 不 是 每 个 数据 库 一 个 。 


Table 47-41. pg_shdescription 字段 


名 字 类 型 引用 描述 
objoid oid 任意 oid 属性 这 条 描述 所 描述 的 对 象 的 
~ OID 
classoid oid pg_class oid 这 个 对 象 出 现 的 系统 表 的 
OID 
description text (a 


47.42. pg _shseclabel 


pg_shseclabel 表 存 储 在 共享 数据 库 对 象 上 的 安全 标签 。 安全 标签 可 以 用 SECURITY LABEL 
命令 操作 。 查看 安全 标签 的 简单 点 的 方法 ， 请 参阅 Section 47.65。 


pg_seclabel 表 的 作用 类 似 ， 只 是 它 是 用 于 在 单个 数据 库 内 部 的 对 象 的 安全 标签 的 。 


不 同 于 大 多 数 的 系统 表 ， pg_shseclabel 在 一 个 集群 中 的 所 有 数据 库 中 共享 : 每 个 数据 库 集 
群 只 有 一 个 pg_shseclabel , 而 不 是 每 个 数据 库 一 个 。 


Table 47-42. pg_shseclabel 字段 


名 字 类 型 引用 描述 
objoid oid 任意 OID 属 性 Tau ee 
SS oid pg_class .Oid 出 现 这 个 对 象 的 系统 表 的 OID 
Pda ER n 签 相关 的 标签 提供 程 


label text 应 用 于 这 个 对 象 的 安全 标签 。 


47.43. pg_statistic 


pg_statistic 表 存 储 有 关 该 数据 库 内 容 的 统计 数据 。 记录 是 由 ANALYZE 创 建 的 ， 并 且 随 后 
被 查询 规划 器 使 用 。 请 注意 所 有 统计 信息 天 生 都 是 近似 的 数值 ， 即 使 假设 它 是 最 新 的 也 如 
此 。 


通常 这 里 对 于 每 个 被 分 析 了 的 表 字段 有 一 条 stainherit = false 的 记录 。 如 果 该 表 有 继承 
的 子 代 ， 那 么 也 会 创建 一 条 带 有 stainherit = true 的 记录 。 这 个 行 表示 字段 在 继承 树 上 的 
状态 ， 也 就 是 ， 对 于 这 个 数据 的 状态 ， 你 应 该 看 到 SELECT _column FROM _table_%*, 
而 stainherit = false 行 的 结果 为 SELECT _column FROM ONLY _table 。 


pg_statistic 还 存储 有 关 索 引 表 达 式 数值 的 统计 数据 。 这 些 是 把 他 们 当 作 实际 的 数据 字段 来 
描述 的 ; 特别 是 ， starelid 引用 来 引 。 不 过 ， 普 通 的 非 表 达 式 来 引 字段 没有 记录 ， 因 为 会 和 
下 层 的 表 字 段 记录 宛 余 。 当前 ， 索 引 表 达 式 的 记录 总 是 有 stainherit = false o 


因为 不 同类 型 的 统计 信息 适用 于 不 同类 型 的 数据 ， pg_statistic 被 设计 成 不 太 在 意 自己 存储 
的 是 什么 类 型 的 统计 。 只 有 极为 常用 的 统计 信息 (比如 NULL 的 含量 ) 才 在 pg statistic 里 给 
予 专 用 的 字段 。 其 它 所 有 东西 都 存储 在 " 槽 位 "中 ， 而 模 位 是 一 组 相关 的 字段 ， 它 们 的 内 容 用 
槽 位 中 的 一 个 字段 的 代码 号 码 表示 。 更 详细 的 信息 请 参 


阅 src/include/catalog/pg_statistic.h o 


pg_statistic 不 应 该 是 公众 可 读 的 ， 因为 即使 是 表 内 容 的 统计 信息 也 应 该 认为 是 敏感 的 。 例 
子 : 薪水 字段 的 最 大 最 小 值 肯定 是 相当 让 人 感 兴趣 的 。 pg_stats 是 一 个 在 pg_statistic 上 
的 全 局 可 读 的 视图 ， 它 只 显示 那些 表 对 于 当前 用 户 可 读 的 信息 。 


Table 47-43. pg statistic 字段 


名 字 


starelid 


staattnum 


stainherit 


stanullfrac 


stawidth 


stadistinct 


stakind ~_N 


staop  _N 


stanumbers ~ 


stavalues ~ 


SNe 


ENZ 


int2 


bool 


float4 


int4 


float4 


int2 


float4[] 


anyarray 


引用 


pg_class .oid 


pg_attribute .attnum 


如 果 为 真 ， 那 么 统计 数据 包含 继 
承 子 字段 ， 不 只 是 指 定 关系 中 的 
值 。 


该 字段 中 为 NULL 的 记录 的 比率 


| 
以 字 节 计 


字段 里 唯一 的 非 NULL 数据 值 的 
数目 。 一 个 大 于 需 的 数值 是 独立 
数值 的 实际 数目 。 一 个 小 于 雳 的 
数值 是 表 中 行 数 的 乘 数 的 负数 ( 比 
如 ， 一 个 字段 的 数值 平均 出 现 概 
率 为 两 次 ， 那么 可 以 表示 

为 stadistinct = -0.5) Ba 
示 独 立 数值 的 数目 未 知 。 


一 个 编码 ， 表 示 这 种 类 型 的 统计 
存储 在 pg_statistic 行 的 
第 _N_ 个 " 槽 位 "。 


pg_operator .0id 


第 N_ 个 " 槽 位 "的 相关 类 型 的 数 
值 统 计 ， 如 果 该 槽 位 和 数值 没有 
关系 ， 那 么 就 是 NULL 。 


第 nN_ 个 " 槽 位 "相关 类 型 的 字段 
数据 值 ， 如 果 该 槽 位 类 型 不 存储 


任何 数据 值 那么 就 是 NULL 。 每 
个 数组 的 元 素 值 实际 上 都 是 指定 
字段 的 数据 类 型 ， 或 相关 类 型 如 
一 个 数组 的 元 素 类 型 ， 因此 ， 除 
了 把 这 些 字 段 的 类 型 定义 

成 anyarray 之 外 ， 没 有 更 好 的 

IRo 


描述 


所 描述 的 字段 所 
属 的 表 或 者 索引 


所 描述 的 字段 的 
个 数 


一 个 用 于 生成 这 
些 存储 在 

a oN. “he 
位 "的 统计 信息 的 
操作 符 。 比如 ， 
一 个 柱 面 图 槽 位 
会 显示 &lt; 操 
作 符 ， 该 操作 符 
定义 了 该 数据 的 
排序 顺序 。 


47.44. pg_tablespace 
pg_tablespace 存储 有 关 可 用 的 表 空 间 的 信息 。 表 可 以 放置 在 特定 的 表 空 间 里 ， 以 帮助 管理 
磁盘 布局 。 


与 大 多 数 系统 表 不 同 ， pg_tablespace 在 一 个 集群 中 的 所 有 数据 库 之 间 共 享 : 每 个 集群 只 有 
一 份 pg_tablespace 的 拷贝 ， 而 不 是 每 个 数据 库 一 个 。 


Table 47-44. pg_tablespace 字段 


名 字 类 型 引用 描述 
本 au 行 标识 符 (隐藏 属性 ; 必须 明确 
指 7) 
spcname name REAT 


' we i 空间 的 所 有 者 ， 通 
spcowner oid pg_authid .oid A e = 
访问 权限 ; 2 GRANTH 

REVOKE # BX 2 7» 


spcacl aclitem[] 


空间 级 选项 ， 使 
spcoptions text[] 用 "keyword=value" 格 式 的 字符 


47.45. pg_trigger 


pg_trigger 存储 表 和 视图 上 面 的 触发 器 。 BRCREATE TRIGGER 获 取 更 多 信息 。 


Table 47-45. pg trigger 字段 


AF 类 型 引用 描述 
T zE 行 标识 符 ( 隐 藏 属性 ;必须 明确 
选择 ) 
tgrelid oid pg_class .oid poe 
触发 器 名 称 (在 同一 表 的 所 有 
tgname name 触发 器 中 必须 唯一 ) 
tgfoid oid pg_proc .oid 要 调用 的 函数 
tgtype int2 标识 触发 器 条 件 的 位 掩 码 
在 session_replication_role 模 
块 里 控制 触发 器 的 触发 。 0 
= 触发 器 在 "origin" 和 "local" 模 
tgenabled char 块 里 触发 ， p = 禁用 触发 
aa, R = 触发 器 
在 "replica" 模 块 里 触发 ， A 
= 触发 器 总 是 触发 。 
如 果 触 发 器 是 内 部 产生 的 则 
tgisinternal bool 为 真 (通常 ， 强制 约束 由 
tgconstraint 指定 ) 
tgconstrrelid oid pg_class .oid gree 
索引 支持 唯一 、 
tgconstrindid oid pg_class .oid 主键 或 参照 完整 
性 约束 
pg_constraint 条 
tgconstraint oid pg_constraint .Oid 目 与 触发 器 相 
关 ， 如 果 有 
tgdeferrable bool BOF He FRIES HEEB 7 
rere ae 如 果 约束 触发 器 是 初始 可 推 
RAR 
ne ue fee RON 


如 果 触 发 器 是 指 
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tgattr int2vector pg_attribute .attnum 定 字段 的 则 为 字 
Bs ; 否则 为 空 
数组 

传递 给 触发 器 的 参数 字符 
tgargs bytea 
—_ ý 串 ， 每 个 都 是 用 NULL 结尾 
触发 器 的 whEN 条 件 的 表达 式 
tgqual pg_node_tree 树 (用 nodeToString() 表示 )， 


如 果 没 有 则 为 空 
当前 ， 指 定 字段 的 触发 只 支持 upar 事件 ， 因 此 tgattr 只 和 事件 类 型 相关 。 tgtype 可 能 
包含 一 些 其 他 事件 类 型 ， 但 是 假定 那些 是 在 表 范 围 的 ， 不 管 tgattr 里 有 什么 。 


Note: 当 tgconstraint JES ay, tgconstrrelid , tgconstrindid , tgdeferrable ,和 和 
tginitdeferred 与 引用 的 pg_constraint 条 目 在 很 大 程度 上 是 宛 余 的 。 然而 ， 不 可 延缓 
的 触发 器 与 可 延缓 的 约束 关联 是 可 能 的 : 外 键 约束 可 以 有 一 些 可 延缓 和 不 可 延缓 的 触发 
Zro 

Note: 如 果 一 个 关系 有 任何 触发 器 在 这 个 表 里 ， 则 pgclass.relhastriggers 必须 为 真 。 


47.45. pg _trigger 2177 


47.46. pg_ts_config 


pg_ts_config 表 包 含 表 示 文 本 搜索 配置 的 记录 。 一 个 配置 指定 一 个 特定 的 文本 搜索 解析 器 和 
一 个 为 了 每 个 解析 器 的 输出 类 型 使 用 的 字典 的 列表 。 解析 器 在 pg_ts_config 记录 中 显示 ， 但 
是 字典 映射 的 标记 是 由 pg_ts_config_map 里 面 的 辅助 记录 定义 的 。 


PostgreSQL 的 文本 搜索 功能 在 Chapter 12 里 面 描述 。 


Table 47-46. pg _ts_config 字段 


名 字 类 型 引用 描述 
oa aa 行 标识 符 (隐藏 属性 ; 必须 明 
确 选 择 ) 

cfgname name 文本 搜索 配置 名 

ES ee Oi 包含 这 个 配置 的 名 字 空 间 的 
OID 

cfgowner oid pg_authid .oid 配置 的 所 有 者 
sy 个 人 7 口 

ree T | we old 这 个 配置 的 文本 搜索 解析 器 


的 OID 


47.47. pg_ts_config_map 


pg_ts_config mp 表 包 含 为 每 个 文本 搜索 配置 的 解析 器 的 每 个 输出 符号 类 型 ， 显示 哪个 文本 
搜索 字典 应 该 被 咨询 、 以 什么 顺序 搜索 的 记录 。 


PostgreSQL 的 文本 搜索 功能 在 Chapter 12 里 描述 。 


Table 47-47. pg_ts_config_map 字段 


名 字 类 型 
mapcfg oid 
maptokentype integer 
mapseqno integer 
mapdict oid 


引用 
pg_ts_config .oid 


由 配置 的 解析 器 发 出 的 一 


个 符号 类 型 


以 什么 顺序 咨询 这 个 记录 
( 低 mapseqno 为 先 ) 


pg_ts_dict .oid 


描述 


拥有 这 个 映射 记录 
的 pg_ts_config 记录 的 OID 


要 咨询 的 文本 搜索 字典 的 
OID 


47.48. pg_ts_dict 


pg ts dict 表 包 含 定义 文本 搜索 字典 的 记录 。 字典 取决 于 文本 搜索 模板 ， 该 模板 声明 所 有 需 
BA mM ;字典 本 身 提供 模板 支持 的 用 户 可 设置 的 参数 的 值 。 这 种 分 工 允 许字 典 通过 非 
权限 用 户 创建 。 参数 由 文本 字符 串 dictinitoption 指定 ， 参 数 的 格式 和 意义 取决 于 模板 。 


PostgreSQL 的 文本 搜索 功能 在 Chapter 12 里 描述 。 


Table 47-48. pg ts dict 字段 


LF 类 型 引用 描述 
Sari 行 标识 符 (隐藏 属性 ; 必须 明 
确 选择 ) 
dictnane nane 文本 搜索 字典 名 
兮 这 个 空 色 的 oot» 
dictnamespace oid pg_namespace .oid 包含 这 个 字段 的 名 字 空 间 
的 OID 
dictownen oid pg_authid .oid 字典 的 所 有 者 
这 个 字典 的 T 
dicttemplate oid pg_ts_template .oid oe 


dictinitoption text 该 模板 的 初始 化 选项 字符 串 


47.49. pg_ts_parser 


pg_ts_parser 表 包 含 定 义 文本 解析 器 的 记录 。 解析 器 负责 分 裂 输入 文本 为 词 位 ， 并 且 为 每 个 
词 位 分 配 标记 类 型 。 因为 解析 器 必须 通过 C 语 言 级 别 的 函数 实现 ， 所 以 新 解析 器 的 创建 局 限 
于 数据 库 超 级 用 户 。 


PostgreSQL 的 文本 搜索 功能 在 Chapter 12 里 描述 。 


Table 47-49. pg _ts_parser 字段 


名 字 类 型 引用 描述 
pr ae 行 标识 符 (隐藏 属性 ;必须 明 
确 选 择 ) 
prsname name 文本 搜索 解析 器 名 
Ao AA 口 人 S50 
prsnamespace oid pg_namespace .Oid sree 解析 器 的 名 字 空 
prsstart regproc pg_proc .oid 解析 器 的 启动 函数 的 OID 
ia SHY K—S 45 iz, AS 
prstoken regproc pg_proc .oid ie 标记 函数 
prsend regproc pg_proc .oid 解析 器 的 关闭 函数 的 OID 
prsheadline regproc pg_proc .oid PRIT 2s A tp 2 EN ALAYOID 
prslextype regproc pg_proc .oid 解析 器 的 lextype 画 数 的 


OID 


47.50. pg _ts_ template 

pg_ts_template 表 包 含 定义 文本 搜索 模板 的 记录 。 模板 是 文本 搜索 字典 的 类 的 实现 框架 。 
ABAD AB Cis Sx SM, 索引 新 模板 的 创建 局 限于 数据 库 超级 用 户 。 
PostgreSQL 的 文本 搜索 功能 在 Chapter 12 里 描述 。 


Table 47-50. pg_ts_template 字段 


名 字 类 型 引用 描述 
aie saa 行 标 识 符 (隐藏 属性 ; 必须 明 
确 选择 ) 
tmplname name 文本 搜索 模板 名 
Sax Ais bY =U 
tmplnamespace oid pg_namespace .Oid arn 模板 的 名 字 空 
tmplinit regproc pg_proc .oid 模板 的 初始 化 函数 的 OID 


tmpllexize regproc pg_proc .oid 模板 的 lexize 函 数 的 OID 


图 


47.51. pg _type 


pg_type 存储 有 关 数 据 类 型 的 信息 。 基 本 类 型 和 枚 举 类 型 (标量 类 型 ) 是 用 CREATE TYPE AV 
的 ， 域 是 使 用 CREATE DOMAIN 创 建 的 。 同时 还 为 数据 库 中 每 个 表 自 动 创建 一 个 复合 类 型 ， 
以 表示 该 表 的 行 结构 。 还 可 以 用 create TYPE as 创建 复合 类 型 。 


Table 47-51. pg_type 字段 


名 罕 类 型 引用 描述 
rie Bo 行 标识 符 ( 隐 藏 属性 ; 必须 明确 
选择 ) 
typname name 数据 类 型 名 
. 含 这 个 类 型 的 名 字 
typnamespace oid pg_namespace .oid S 
typownen org pg_authid .oid 该 类 型 的 所 有 者 


对 于 定 长 类 型 是 该 类 型 内 部 表 
现形 式 的 字 节 数目 。 对 于 变 长 
类 型 是 负数 。 -1 表示 一 种 " 变 
长 "类 型 (有 长 度 字 属性 的 数 
据 )， -2 表示 这 是 一 个 NULL 
结尾 的 C 字符 串 。 


判断 内 部 过 程 传递 这 个 类 型 的 
数值 时 是 通过 传 值 还 是 传 引 
用 。 如 果 该 类 型 不 是 1, 2, 4， 
typbyval bool 8 字 节 长 将 只 能 按 引 用 传递 ， 
因此 typbyval 最 好 是 假 。 即 
使 可 以 传 值 ，typbyval 也 可 以 
为 假 。 
对 于 基础 类 型 是 bp。 ， 对 于 复合 
类 型 是 。 (比如 ， 一 个 表 的 行 
类 型 )。 对 于 域 类 型 是 d ， 对 


typlen int2 


typtype char 于 枚 举 类 型 是 。， HFK 
型 是 p ， 对 于 范围 类 型 
[三 | 
<i X 


JL typrelid 和 typbasetype 。 


typcategory 是 数据 类 型 的 任 
意 分 类 ， 该 数据 类 型 被 触发 器 


iE ie h A 

i os 用 来 决定 哪 种 降 式 转换 应 该 
是 "首选 "。 参阅 Table 47-52。 

typispreferred bool 如 果 类 型 在 它 的 typcategony 


里 是 首选 转换 目标 则 为 真 。 
如 果 定 义 了 类 型 则 为 真 ， 如 果 


typisdefined 


typdelim 


typrelid 


typelem 


typarray 


bool 


char 


是 一 种 尚未 定义 的 类 型 的 占 位 
符 则 为 假 。 如 果 为 假 ， 那么 除 
了 该 类 型 名 称 ， 名 字 空 间 ， 和 
OID 之 外 没有 可 靠 的 信息 。 

当 分 析 数 组 输入 时 ， 分 隔 两 个 
此 类 型 数值 的 字符 。 请 注意 该 
分 隔 符 是 与 数组 元 素数 据 类 型 
相关 联 的 ， 而 不 是 和 数组 数据 
类 型 关联 。 


pg_class .0id 


pg_type .Oid 


pg_type .oid 


如 果 是 复合 类 型 

(JL typtype ) 那 么 这 
个 字段 指向 pg_class 
中 定义 该 表 的 行 。 对 
于 自由 存在 的 复合 类 
型 ， pg_class 记录 并 
不 表示 一 个 表 ， 但 是 
总 需要 它 来 查找 该 类 
型 连接 

的 pg_attribute 记 

录 。 对 于 非 复合 类 型 
Ao 


如 果 不 为 0 ， 那 么 它 
标识 pg_type 里 面 的 
另外 一 行 。 当前 类 型 
可 以 像 一 个 数组 产生 
类 型 为 typelem 的 值 
一 样 当做 下 标 。 

个 "真正 的 "数组 类 型 
是 变 长 的 ( typlen = 
-1)， 但 是 一 些 定 长 的 
( typlen > 0) 类 型 也 
497 SESH typelem 
( 比 

如 name 和 point )。 
如 果 一 个 定 长 类 型 拥 
有 一 个 typelem , AB 
么 他 的 内 部 形式 必须 
是 typelem 数据 类 型 
的 某 个 数目 的 个 数 
值 ， 不 能 有 其 它 数 
据 。 变 长 数组 类 型 有 
一 个 该 数组 子 过 程 定 
义 的 头 (文件 )。 


如 果 typarray FES, 
那么 它 在 pg_type 里 
定义 另外 一 行 ， 该 行 
是 将 这 个 类 型 作为 元 
素 的 "真正 的 "数组 类 
AUA 


typinput regproc pg_proc .oid 输入 转换 图 数 (文本 格 
式 ) 
输出 转换 画 数 (文本 格 
式 ) 
输入 转换 函数 (二 进 制 


typreceive regproc pg_proc .oid 格式 )， 如 果 没有 则 为 
0 


偷 出 转换 函数 (二 进 制 
Re fee Lees pg_proc .oid 格式 )， 如 果 没 有 则 为 
0 


类 型 修饰 符 输 入 画 
typmodin regproc pg_proc .oid 数 ， 如 果 类 型 不 支持 
修饰 符 则 为 0 


RAE a FF A H E 
typmodout regproc pg_proc .oid 数 ， 如 果 使 用 标准 格 
式 则 为 0 


自 定义 的 ANALYzE BX 
typanalyze regproc pg_proc .oid BM, VOR te ES 
数 ， 则 为 0 


typoutput regproc pg_proc .0id 





当 存 储 此 类 型 的 数值 时 要 求 的 
对 齐 性 质 。 它 应 用 于 磁盘 存储 
以 及 该 值 在 PostgreSQL 内 部 
的 大 多 数 形式 。 如 果 数 值 是 连 
续 存 放 的 ， 比 如 在 磁盘 上 以 完 
全 的 裸 数据 的 形式 存放 时 ， AB 
么 先 在 此 类 型 的 数据 前 填充 空 
白 ， 这 样 它 就 可 以 按照 要 求 的 
界限 存储 。 对 齐 引 用 是 该 序列 
中 第 一 个 数据 的 开头 。 


typalign char 


可 能 的 值 有 : 


e c= char 对 齐 ， 也 就 是 不 需要 对 齐 。 

e s = short 对 齐 (在 大 多 数 机 器 上 是 2 字 节 ) 

e i = int 对 齐 ( 在 大 多 数 机 器 上 是 4 FH) 

e d = double 对 齐 (在 大 多 数 机 器 上 是 8 字 节 ， 但 不 一 定 是 全 部 ) 


Note: 对 于 在 系统 表 里 使 用 的 类 型 ， 在 pg_type 里 定义 的 尺寸 和 对 齐 必须 和 编译 器 在 一 
个 表示 表 的 一 行 的 结构 里 的 布局 一 样 。 || typstorage | char | 告诉 一 个 变 长 类 型 (那些 
有 typlen = -1 的 ) 说 该 类 型 是 否 准 各 好 应 付 非 常规 值 ， 以 及 对 这 种 类 型 的 属性 的 缺 省 策 
略 是 什么 。 可 能 的 值 有 


@ p :数值 总 是 以 简 单方 式 存 储 


e e :数值 可 以 存储 在 一 个 "次 要 "关系 中 (如 果 该 关系 有 这 人 么 一 个 ， 参 


阅 pg_class.reltoastrelid ) 
e m: 数值 可 以 以 内 联 的 压缩 方式 存储 
© x :数值 可 以 以 内 联 的 压缩 方式 或 者 在 "次 要 " 表 里 存 储 。 


请 注意 m 域 也 可 以 移 到 从 属 表 里 存储 ， 但 只 是 最 后 的 解决 方法 ( 。 和 x 域 先 移 走 )。 || 
typnotnull | bool | 代表 在 某 类 型 上 的 一 个 NOTNULL 约束 。 目 前 只 用 于 域 。 | | 
typbasetype | oid | pg_type .oid | 如 果 这 是 一 个 域 (参阅 typtype )， 那么 标识 作为 这 个 类 
型 的 基础 的 类 型 。 如 果 不 是 域 则 为 需 。 || typtypmod | int4 | 域 使 用 typtypmod 记录 要 作用 
到 它们 的 基础 类 型 上 的 typmod (如 果 基 础 类 型 不 使 用 typmod 则 为 -1)。 如 果 这 种 类 型 不 是 
域 ， 那 么 为 -1 。 | | typndims | inta | 如 果 是 一 个 域 数组 ， 那 么 typndims 是 数组 维 数 的 数 
值 (也 就 是 说 ， typbasetype 是 一 个 数组 类 型 ) 。 非 域 非 数 组 类 型 为 需 。 | | typcollation | 
oid | pg_collation .oid | 指定 类 型 的 排序 规则 。 如 果 类 型 不 支持 排序 ， 则 为 0。 一 个 支持 排 
序 的 基础 类 型 类 有 DEFAULT_COLLATION_OID 。 一 个 可 排序 类 型 的 域 可 以 有 一 些 其 他 排序 OID， 
如 果 为 该 域 指定 了 一 个 的 话 。 || typdefaultbin | pg_node_tree | 如 果 为 非 NULL ， 和 那么 它 
是 该 类 型 缺 省 表达 式 的 nodeToString() 表现 形式 。 目前 这 个 字段 只 用 于 域 。 | | typdefault 
text | 如 果 某 类 型 没有 相关 缺 省 值 ， 那 么 typdefault 是 NULL. SOR typdefaultbin 不 是 
NULL ， 那 么 typdefault 必须 包含 一 个 typdefaultbin 代表 的 缺 省 表达 式 的 人 类 可 读 的 版 
本 。 如 果 typdefaultbin 为 NULL 但 typdefault Ae, ABA typdefault 是 该 类 型 缺 省 值 的 外 
部 表现 形式 ， 可 以 把 它 交 给 该 类 型 的 输入 转换 器 生成 一 个 常量 。 | | typacl | aclitem[] | 访 
HARR ; 参阅 GRANT 和 REVOKE 获 取 细 节 。 | 


Table 47-52 列 出 了 系统 定义 的 typcategory 的 值 。 任何 未 来 添加 到 这 个 列表 的 也 是 大 写 的 
ASCII 字 母 。 所 有 其 他 ASCII 字 符 为 用 户 定义 的 范畴 保留 。 


Table 47-52. typcategory 代码 


代码 


数组 类 型 
布尔 类 型 

合 类 型 
日 期 /时 间 类 型 
枚 举 类 型 
几何 类 型 

网 络 地 址 类 型 
数值 类 型 

伪 类 型 
范围 类 型 
字符 串 类 型 
时 间 间 隅 类 型 
用 户 定义 类 型 
位 串 类 型 
未 知 类 型 


种 类 


47.52. pg_user_mapping 


pg_user_mapping 表 存 储 从 本 地 用 户 到 远程 的 映射 。 普通 用 户 访问 这 个 表 是 受到 限制 的 ， 使 用 


视图 访问 pg_user_mappings 。 


Table 47-53. pg_user_mapping 字段 


ak am 引用 pem 
oid oid 行 标 识 符 (隐藏 属性 ; 必须 明 
确 选择 ) 
ol oid pg_authid .oid 被 映射 的 本 地 用 户 的 OID， 


如 果 用 户 映 射 是 公共 的 则 为 0 


包含 这 个 映射 的 外 部 服务 器 
的 OID 


umserver oid pg_foreign_server .Oid 


用 户 映 射 指 定 选 项 ， 使 
umoptions text[] 用 "keyword=value" 格 式 的 字 
FE 


47.53. RAMA 
除了 系统 表 之 外 ，PostgreSQL 还 提供 了 一 系列 内 置 的 视图 。 系统 视图 提供 了 坦 询 系统 表 的 一 
些 便利 的 访问 方法 。 其 它 一 些 视图 提供 了 访问 内 部 服务 器 状态 的 方法 。 


信息 模式 (Chapter 34) 提 供 了 另外 一 套 视图 ， 它 的 功能 覆盖 了 系统 视图 的 功能 。 因 为 信息 模式 
是 SQL 标准 ， 而 这 里 描述 的 视图 是 PostgreSQL 特 有 的 ， 所 以 最 好 用 信息 模式 来 获取 自己 需 
要 的 所 有 信息 。 


Table 47-54 列 出 了 这 里 描述 的 所 有 系统 视图 。 下 面 是 每 个 视图 更 详细 的 信息 。 有 些 视图 提供 
了 对 统计 收集 器 的 结果 的 访问 ; 他 们 在 Table 27-1 里 列 出 。 


除了 特别 声明 的 ， 这 里 描述 的 所 有 视图 都 是 只 读 的 。 


Table 47-54. 系统 视 
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pg_available_extensions 


pg_available_extension_versions 


pg_cursors 
pg_group 

pg_indexes 

pg_locks 

pg_matviews 
pg_prepared_statements 
pg_prepared_xacts 
pg_roles 

pg_rules 

pg_seclabels 
pg_settings 

pg_shadow 

pg_stats 

pg_tables 
pg_timezone_abbrevs 
pg_timezone_names 
pg_user 
pg_user_mappings 


pg_views 


47.53. 系统 视图 


用 途 
可 用 的 扩展 
可 用 扩展 的 版 本 
打开 的 游标 
数据 库 用 户 的 组 
索引 
当前 持 有 的 锁 
物化 视图 
预备 语句 
预备 事务 
数据 库 角色 
规则 
安全 标签 
参数 设置 
数据 库 用 户 
规划 器 统计 
K 
时 区 缩写 
时 区 名 
数据 库 用 户 
用 户 映 射 


视 


2190 


47.54. pg_available_extensions 


pg_available_extensions 视图 列 出 了 可 用 于 安装 的 扩展 。 又 见 pg_extension R, 显示 了 当 
前 安装 了 的 扩展 。 


Table 47-55. pg_available_extensions 字段 


ay 类 型 描述 
name name 扩展 名 
default_version text = 缺 省 版 本 的 名 字 ， 如 果 没有 指定 则 为 NuLL 
installed version tet ”扩展 当前 安装 版 本 ， 如 果 没 有 安装 任何 版 本 则 为 NULL 
comment text ”扩展 的 控制 文件 中 的 评论 字符 串 


= 

w 

并 
‘so 
Ht 
Tt 
val 


pg_available_extensions 视 医 


47.55. pg_available_extension_versions 


pg_available_extension_versions 视图 列 出 了 可 用 于 安装 的 指定 扩展 版 本 。 X 
见 pg_extension R, 显示 了 当前 安装 了 的 扩展 。 


Table 47-56. pg_available_extension_versions 字段 


ma So 

名 字 类 型 
name name 
version text 
installed bool 
superuser bool 
relocatable bool 
schema name 
requires name[ ] 
comment text 


扩展 名 

版 本 名 

如 果 这 个 扩展 的 这 个 版 本 是 当前 已 经 安装 了 的 则 为 真 

如 果 只 人 允许 超级 用 户 安 装 这 个 扩展 则 为 真 

如 果 扩 展 可 以 重新 加 载 到 另 一 个 模式 则 为 真 

扩展 必须 安装 到 的 模式 名 ， 如 果 部 分 或 全 部 可 重新 定位 则 


为 NULL 
先决 条 件 扩 展 的 名 字 ， 如 果 没 有 则 为 NULL 
扩展 的 控制 文件 中 的 评论 字符 串 


P : . i=! ` 
pg_available_extension_versions ZEA 读 的 。 


47.56. pg_cursors 


pg_cursors 列 出 了 当前 可 用 的 游标 。 游 标 可 以 用 几 种 不 同 的 方法 定义 : 
e 通过 DECLARE 语 句 

。 在 前 /后 端 协议 中 通过 Bind 信息 ， 具 体 在 Section 48.2.3 中 描述 。 

。 通过 服务 器 编程 接口 (SPI)， 具 体 在 Section 44.1 中 描述 。 


pg_cursors 显示 上 述 所 有 方法 创建 的 游标 。 除非 被 声明 为 wITH HoLD ， 游 标 仅 存在 于 定义 它 
们 的 事务 的 生命 期 中 。 因此 非 持久 游标 仅 能 够 在 视图 中 存在 到 创建 该 游标 的 事务 结束 时 为 
止 。 

Note: 因为 游标 用 于 在 PostgreSQL 内 部 实现 一 些 比 如 过 程 语言 之 类 的 组 件 。 

此 pg_cursors 可 能 包含 并 非 由 用 户 明 确 创建 的 游标 。 


Table 47-57. pg_cursors 字段 


名 字 类 型 描述 
name text 游标 名 
statement text 声明 该 游标 的 查询 字符 串 
如 果 该 游标 是 持久 的 (也 就 是 在 声明 该 游标 的 事务 结 
is_holdable boolean 束 后 仍然 可 以 访问 该 游标 ) 则 为 true ; 否则 
为 false 
einer OEN, a BINARY 则 为 true ; 否则 
J false 


如 果 该 游标 可 以 滚动 (也 就 是 允许 以 不 连续 的 方式 检 


is_scrollable boolean d nts 
RN) 为 true ; GMA false 
creation_time timestamptz 声明 该 游标 的 时 间 惟 


pg_cursors 视图 是 只 读 的 。 


47.57. pg_group 


pg_group 的 存在 是 为 了 向 下 兼容 : 它 模拟 一 个 存在 于 PostgreSQL 版 本 8.1 之 前 的 系统 表 。 
它 显示 所 有 标记 为 不 是 rolcanlogin 的 角色 的 名 字 和 成 员 ， 这 就 是 近似 于 用 做 组 的 那些 角色 


的 集合 了 。 


Table 47-58. pg group 字段 


BF 类 型 
groname name 
grosysid oid 
grolist oid[ ] 


引用 
pg_authid .rolname 


pg_authid .oid 


pg_authid .oid 


组 的 名 字 
组 的 ID 


一 个 数组 ， 包 含 这 个 组 里 面 所 有 角色 的 
ID 


47.58. pg_indexes 


pg_indexes 提供 对 数据 库 中 每 个 索引 的 有 用 信息 的 访问 。 


Table 47-59. pg_indexes 字段 


名 字 类 型 引用 
schemaname name pg_namespace .nSpname 
tablename name pg_class .relname 
indexname name pg_class .relname 
tablespace name pg_tablespace .Ssocname 


索引 定义 (一 个 重建 


indexdef text 
的 CREATE INDEX MP) 


描述 
包含 表 和 索引 的 模式 的 名 字 
此 索引 所 服务 的 表 的 名 字 
索引 的 名 字 


包含 索引 的 表 空 间 名 字 ( 如 果 是 数 
据 库 缺 省 ， 则 为 NULL) 


47.59. pg_locks 


pg_locks 提供 有 关 在 数据 库 服 务 器 中 由 打开 的 事务 持 有 的 锁 的 信息 。 参阅 Chapter 13% MA 
关 锁 的 更 多 的 讨论 。 


pg_locks 对 每 个 活路 的 可 锁定 对 象 、 请 求 的 锁 模 式 、 以 及 相关 的 事务 保存 一 行 。 因 此 ， 如 果 
多 个 事务 持 有 或 者 等 待 对 同一 个 对 象 的 锁 ， 那么 同一 个 可 锁定 的 对 象 可 能 出 现 多 次 。 不 过 ， 
一 个 目前 没有 锁 在 其 上 的 对 象 将 肯定 不 会 出 现 。 

有 好 几 种 不 同 的 可 锁定 对 象 : 一 个 关系 (也 就 是 一 个 表 )、 关 系 中 独立 页 面 、 关系 中 独立 的 
行 、 一 个 事务 ID (虚拟 和 永久 |D) 、 以 及 一 般 的 数据 库 对 象 (用 类 别 OID 和 对 象 OID 标识 ， 
表示 方法 和 pg_description 或 pg_depend 一 样 ) 还 有 ， 扩 展 一 个 关系 的 权限 也 是 用 一 种 独立 的 
可 锁定 对 象 表示 的 。 另外 ，"advisory" 锁 可 以 用 在 有 用 户 定义 的 含义 的 数据 上 。 


Table 47-60. pg_locks 字段 


名 字 类 型 引用 描述 
可 锁定 对 象 的 类 型 : 
relation , extend , 
locktype text Rages GEULIS 
transactionid , 
virtualxid , object , 
userlock ,或 advisory 
目标 所 在 的 数据 库 
的 OID ， 如 果 目 标 
AHS x 4 
database oid pg_database .0id Roe Geer 
是 一 个 事务 ID ， 就 
是 null 。 
关系 的 OID ， 如 果 
relation oid pg_class .oid Sa 
分 ， 则 为 null 
关系 内 部 的 页 面 编号 ， 如 果 
page integer 目标 不 是 行 页 不 是 关系 页 ， 
则 为 null 
tuple smallint 页 面 里 面 的 行 编号 ， RE 
标 不 定 行 ， 则 为 null 
事务 的 虚拟 ID ， 如 果 目 标 
virtualxid text 不 是 虚拟 事务 ID ， 就 是 
null 
transactionid xid 事务 的 ID ， 如 果 目 标 不 是 


事务 ID ， 就 是 null 


包含 该 目标 的 系统 
表 的 OID, RE 
标 不 是 普通 数据 库 
对 象 ， 则 为 null 


目标 在 其 系统 表 内 
的 OID ， 如 果 目 标 
不 是 普通 数据 库 对 
象 ， 则 为 null 


classid oid pg_class .oid 


objid oid 任意 OID 属 性 


字段 编号 

( classid 和 objid 指向 表 
BS) 如 果 目 标 是 其 它 普 
通 数 据 库 对 象 ， 这 个 字段 是 
雳 。 如 果 这 个 目标 不 是 普通 
数据 库 对 象 ， 则 为 null 


持 有 此 锁 或 者 在 等 待 此 锁 的 
事务 的 虚拟 ID 


持 有 或 者 等 待 这 个 锁 的 服务 
器 进程 的 进程 ID 。 如 果 锁 
是 被 一 个 预 各 事务 持 有 的 ， 
那么 为 null 


这 个 进程 持 有 的 或 者 是 期 望 
mode text 的 锁 模 式 (参阅 Section 
13.3.1 和 Section 13.2.3) 


MARA, AR, WARS 
待 锁 ， 为 假 

如 果 锁 通过 快速 路 径 
fastpath boolean 真 ， 如 果 通 过 主 锁 表 
假 


objsubid smallint 


virtualtransaction text 


pid integer 


granted boolean 


granted 为 真 时 表明 指定 事务 持 有 一 个 锁 。 为 假 则 表明 该 事务 当前 等 待 使 用 这 个 锁 ， 这 就 暗 
示 着 某 个 其 它 的 事务 正在 同样 的 可 锁定 对 象 上 持 有 冲突 的 锁 模式 。 等 待 的 会 话 将 一 直 睡 眠 ， 
直到 另外 一 个 锁 释放 (或 者 侦 测 到 一 个 死 锁 条 件 )。 一 个 事务 一 次 最 多 等 待 一 个 锁 。 


每 个 事务 都 在 它 持续 的 时 间 里 在 他 自己 的 虚拟 事务 ID 上 持 有 一 个 排他 锁 。 如 果 给 事务 赋予 一 
个 永久 ID (通常 只 在 事务 改变 数据 库 的 状态 时 发 生 ) ， 那 么 它 也 在 它 的 永久 事务 ID 上 持 有 一 
个 排 它 锁 ， 直 到 它 结束 。 如 果 一 个 事务 认为 它 必 须 等 待 另外 一 个 事务 ， 它 会 以 企图 在 另外 一 
个 事务 ID 上 获取 共享 锁 的 方式 实现 之 〈 虚 拟 的 或 永久 的 ID 取决 于 情景 ) 。 这 个 锁 只 有 在 另外 
一 个 事务 终止 并 且 释 放 它 的 锁 的 前 提 下 才能 成 功 。 


尽管 行 是 一 种 可 以 锁定 的 对 象 ， 但 是 有 关 行 级 别 锁 的 信息 是 存储 在 磁盘 上 的 ， 而 不 是 在 内 存 
里 ， 因此 ， 行 级 别 的 锁 通 常 不 会 出 现在 这 个 视图 里 。 如 果 一 个 事务 在 等 待 一 个 行 级 别 的 锁 ， 
那么 它 通 常会 在 这 个 视图 里 以 等 待 当前 持 有 该 行 锁 的 永久 事务 ID 的 方式 出 现 。 


建议 锁 可 以 在 由 单独 一 个 bigint 值 或 两 个 integer 值 组 成 的 键 上 获得 。 一 个 bigint 键 的 高 / 
低位 部 分 分 别 在 classid 和 objid 字段 中 显示 ， 并 且 objsubid 等 于 1。 原先 的 bigint 值 可 
以 通过 表达 式 (classid::bigint &lt;&lt; 32) | objid::bigint 重新 组 装 。 integer 组 成 的 键 
前 半 部 分 在 classid 字段 中 显示 、 后 半 部 分 在 objid 字段 中 显示 ， 并 且 objsubid 等 于 2 。 
键 的 实际 含义 取决 于 用 户 的 定义 。 建议 锁 是 针对 单个 数据 库 的 ， 因 此 database 字段 对 于 建议 
锁 就 显得 很 有 意义 了 。 


pg_locks 提供 了 一 个 数据 库 集 群 里 的 所 有 的 锁 的 全 局 视图 ， 而 不 仅仅 那些 和 当前 数据 库 相 关 
的 。 尽 管 它 的 relation 字段 可 以 和 pg_class . oid 连接 起 来 以 标识 被 锁 住 的 关系 ， 但 是 这 
个 方法 目前 只 能 对 在 当前 数据 库 里 的 关系 有 用 (那些 database 字段 是 当前 数据 库 的 OID 或 者 
雳 的 数据 库 )。 


pid 字段 可 以 可 以 和 pg_stat_activity 视图 的 pid 字段 连接 起 来 获取 持 有 或 者 等 待 持 有 每 个 
锁 的 会 话 的 更 多 信息 。 同样 ， 如 果 你 使 用 预 各 事务 ， 可 以 把 transaction 字段 

和 pg_prepared_xacts 视图 的 transaction 字段 连接 起 来 获取 持 有 锁 的 那个 预 各 事务 的 更 多 信 
息 。 一 个 预 各 事务 不 能 等 竺 任何 锁 ， 但 是 在 运行 的 时 候 ， 它 继续 持 有 它 已 经 请 求 到 的 锁 。 


pg_locks 显示 独立 系统 的 普通 锁 管 理 器 和 谓词 锁 管理 器 的 数据 ; 另外 ， 普通 锁 管 理 器 细 分 它 
的 锁 为 普通 和 fast-path 锁 。 这 个 数据 不 保证 是 完全 一 致 的 。 当 请 求 视 图 时 ，fast-path 锁 的 数 
据 ( fastpath = true) 从 每 个 后 端 一 次 收集 ， 在 整个 锁 管 器 中 没有 冻结 状态 ， 所 以 当 收 集 
信息 时 ， 可 以 获取 锁 或 释放 锁 。 不 过 ， 要 注意 的 是 ， 这 些 锁 不 和 任意 其 他 当前 锁 发 生 冲 突 。 
在 所 有 后 端 已 经 查询 fast-path 锁 之 后 ， 剩余 的 普通 锁 管理 器 作为 一 个 单元 ， 并 且 一 个 所 有 剩 
余 锁 的 一 致 的 快照 作为 原子 动作 收集 。 在 解锁 普通 锁 管 理 器 之 后 ， 谓 词 锁 管理 器 同样 的 锁 
住 ， 并 且 所 有 谓词 锁 作 为 一 个 原子 动作 收集 。 因此 ， 除 了 fast-path 锁 ， 每 个 锁 管理 器 将 给 出 
一 致 的 结果 集 ， 但 是 因为 我 们 不 同时 锁 住 锁 管理 器 ， 锁 可 能 在 我 们 访问 普通 锁 管 理 器 之 后 、 
访问 谓词 锁 管 理 器 之 前 获取 或 释放 。 

如 果 这 个 视图 访问 的 非常 频繁 ， 那 么 锁 住 普通 和 /或 谓词 锁 管 理 器 可 能 会 对 数据 库 性 能 有 些 影 
响 。 锁 只 持 有 从 锁 管 理 器 获取 数据 所 需要 的 最 小 的 时 间 ， 但 是 这 并 不 能 完全 消除 性 能 影响 的 
可 能 性 。 


47.60. pg_matviews 


pg_matviews 视图 提供 了 访问 关于 每 个 物化 视图 在 数据 库 中 的 有 用 信息 的 接口 。 


Table 47-61. pg_matviews 字段 


ha 
AF 

schemaname 

matviewname 


matviewowner 


tablespace 


hasindexes 


ispopulated 


definition 


类 型 
name 
name 


name 


name 


boolean 


boolean 


text 


引用 
pg_namespace .nSpname 
pg_class .relname 


pg_authid .rolname 


pg_tablespace .Socname 


如 果 物 化 视图 有 (或 最 近 
A) 任何 素 引 则 为 真 


如 果 物 化 视图 当前 填充 
则 为 真 


物化 视图 定义 (一 个 重新 
构造 的 sELECT 查询 ) 


描述 
包含 物化 视图 的 模式 名 
物化 视图 的 名 字 
物化 视图 的 所 有 者 的 名 字 
包含 物化 视图 的 名 字 空 间 的 


名 字 〈 如 果 对 于 数据 库 是 缺 
省 的 则 为 null) 


47.61. pg_prepared_statements 


pg_prepared_statements 显示 所 有 当前 会 话 中 可 用 的 预备 语句 。 参见 PREPARE 获 取 关 于 预 各 
语句 的 更 多 信息 。 


每 个 预备 语句 在 pg_prepared_statements 中 都 有 对 应 的 一 条 记录 。 当 一 条 新 的 预 各 语句 创建 
后 该 视图 中 就 会 新 增 一 条 记录 ， 同 样 ， 当 一 条 预 各 语句 被 释放 后 (比如 通过 DEALLOCATE 命 
邻 )， 相 应 的 记录 也 会 被 删除 。 


Table 47-62. pg_prepared_statements 字段 
名 字 类 型 描述 
Hane text 预备 语句 的 标识 符 


创建 该 预 各 语句 的 查询 字符 串 。 对 于 从 SQL 创建 
的 预备 语句 而 言 是 客户 端 提 交 的 ”PREPARE 语句 。 


tat t t È Ewa LU =< a 
i EN i 对 于 通过 前 /后 端 协议 创建 的 预备 语句 而 言 是 预 各 
语句 自身 的 文本 。 
prepare_time timestamptz 创建 该 预备 语句 的 时 间 稚 
该 预备 语句 期 望 的 参数 类 型 ， 以 regtype 类 型 的 数 
parameter_types regtype[] 组 格式 出 现 。 与 该 数组 元 素 相 对 应 的 OID 可 以 通 
过 把 regtype 值 转换 为 oid 值得 到 。 
如 果 该 预备 语句 是 通过 PREPARE 语句 创建 的 则 
from sql boolean A true > 如 果 是 通过 前 /后 端 协议 创建 的 则 


WH false 


pg_prepared_statements 视 是 只 读 的 。 


47.62. pg_prepared_xacts 


pg_prepared_xacts 显示 那些 当前 准 各 好 进行 两 阶段 提交 的 事务 的 信息 (参阅 PREPARE 
TRANSACTION 获 取 细 节 )。 


pg_prepared xacts 为 每 个 预备 事务 包含 一 行 。 如 果 事 务 提 交 或 者 回 滚 ， 


Table 47-63. pg_prepared_xacts 字段 


名 字 
transaction 
gid 
prepared 


owner 


database 


类 型 


xid 


text 
timestamp with time zone 


name 


name 


引用 
预备 事务 的 数字 事务 标 


1A 


赋予 该 事务 的 全 局 事务 


标识 


事务 准备 好 提交 的 时 间 


pg_authid .rolhame 


pg_database .datname 


则 删除 该 条 记录 。 


执行 该 事务 的 
用 户 的 名 字 

执行 该 事务 所 
在 的 数据 库 名 


在 访问 pg_prepared_xacts 视图 的 时 候 ， 内 部 事务 管理 器 数据 结构 被 暂时 锁 住 ， 并 且 为 显示 视 
图 制作 了 一 份 拷贝 。 这 样 就 保证 了 视图 生成 一 个 一 致 的 结果 集 ， 而 不 会 阻塞 正常 的 操作 太 长 


时 间 。 当 然 ， 即 便 这 么 做 ， 如 果 过 于 频繁 地 访问 这 个 视图 ， 


的 影响 。 


肯定 也 会 对 数据 库 性 能 造成 一 定 


47.63. pg_roles 


pg_roles 提供 访问 数据 库 角色 有 关 信 息 的 接口 。 它 只 是 一 个 pg authid 表 的 公开 可 污 部 分 
的 视图 ， 把 口令 字段 用 空白 填充 了 。 


该 视图 明确 的 显示 了 底层 表 的 OD 字段 ， 可 以 用 于 与 其 它 表 连接 。 


Table 47-64. pg roles 字段 


名 字 类 型 引用 
PUN 
rolname name 角色 名 
rolsuper bool 有 超级 用 户 权限 的 角色 
rolinherit bool 自动 继承 属 主角 色 权 限 的 角色 
rolcreaterole bool 可 以 创建 更 多 角色 的 角色 
rolcreatedb bool 可 以 创建 数据 库 的 角色 
可 以 直接 更 新 系统 表 的 角色 。 除 非 这 个 字段 关 
rolcatupdate bool A 否则 超级 用 户 也 不 能 are 又 为 
| 可 以 登录 的 角色 ， 也 就 是 说 ， 这 个 角色 可 以 给 
nan a 予 初始 化 会 话 认证 的 标识 符 。 
复制 的 角色 。 也 就 是 说 ， 这 个 角色 可 以 初始 化 
ee ee 流 复制 (参阅 Section 25.2.5) 和 使 
用 pg_start_backup 和 pg_stop_backup 设置 / 
重 设 系 统 各 份 模式 。 
se À 对 于 可 以 登录 的 角色 ， 这 儿 限 制 了 该 角色 人 允许 
ee a 发 起 的 最 大 并 发 连接 数 。 -1 表示 无 限制 。 
rolpassword text 不 是 口令 (总 是 wx# wwxwn ) 
rolvaliduntil timestamptz 口 分 失效 日 期 (只 用 于 口令 认证 ) 如 果 没有 失 
效 期 ， 为 NULL 
rolconfig text[] 运行 时 配置 变量 的 用 户 指定 的 缺 省 
角 
oid oid pg_authid .oid = 
ID 


47.64. pg_rules 


pg rules 提供 对 查询 重 写 规则 的 有 用 信息 访问 的 接口 。 


Table 47-65. pg_rules 字段 


名 字 类 型 引用 描述 
schemaname name pg_namespace .nspname 包含 表 的 模式 的 名 字 
tablename name pg_class .relname 规则 作用 的 表 的 名 字 
rulename name pg_rewrite .rulename 规则 的 名 字 
definition text ”规则 定义 (一 个 重新 构造 的 创建 命令 ) 


pg_rules 视图 排除 了 视图 和 物化 视图 的 on sELECT 规则 ; 就 是 那些 可 以 
在 pg_views 和 pg_matviews 里 看 到 的 。 


47.65. pg_seclabels 


pg_seclabels 提供 关于 安全 标签 的 信息 。 它 是 一 个 pg seclabel 表 容 易 查询 的 版 本 。 


Table 47-66. pg_seclabels 字段 


名 字 


objoid 


classoid 


objsubid 


objtype 


objnamespace 


objname 


provider 


label 


int4 


text 


oid 


text 


text 


text 


引用 


任意 OID 属 性 


pg_class .0id 


对 于 一 个 在 表 字 段 上 的 安全 标签 ， 是 字 
段 编号 (引用 表 本 身 的 objoid 

和 classoid ) 。 对 于 所 有 其 他 对 象 类 
W, IFRA, 


这 个 标签 出 现 的 对 象 的 类 型 ， 文 本 格 
IN 


pg_namespace .Oid 


这 个 标签 适用 的 对 象 的 名 字 ， 文 本 格 


Ze 
pg_seclabel .provider 


pg_seclabel .label 


描述 


这 个 安全 标签 指 
向 的 对 象 的 OID 


这 个 对 象 出 现 的 
系统 表 的 OID 


这 个 对 象 的 名 字 
空间 的 OID， 如 
果 适 用 ; 否则 为 
NULL. 


与 这 个 标签 相关 
的 标签 提供 者 。 
适用 于 这 个 对 象 
的 安全 标签 。 


47.66. pg_settings 


pg_settings 提供 了 对 服务 器 运行 时 参数 的 访问 。 它 实 际 上 是 SHOW 和 SET 命令 的 另外 一 个 
接口 。 它 还 提供 一 些 用 show 不 能 直接 获取 的 参数 的 访问 ， 比 如 最 大 和 最 小 值 。 


Table 47-67. pg settings 字段 


293 类 型 描述 
name text 运行 时 配置 参数 名 
setting text 参数 的 当前 值 
unit text 参数 的 隐 合 单元 
category text 参数 的 逻辑 组 
short_desc text 参数 的 一 个 简短 的 描述 
extra_desc text 有 关 参 数 的 额外 的 ， 更 详细 的 描述 
context text 这 个 参数 的 值 要 求 的 环境 (FI) 
vartype text 参数 类 型 ( bool ，enum ，integer ，real ，string ) 
source text 当前 参数 值 的 来 源 
min_val text 该 参数 允许 的 最 小 值 ( 非 数 字 值 为 null) 
max_val text 这 个 参数 允许 的 最 大 的 数值 ( 非 数 字 值 为 null) 
enumvals text [] 枚 举 参数 允许 的 值 〈 非 枚 举 值 为 null) 
boot_val text 如 果 参 数 没 有 设置 则 为 服务 器 启动 时 假设 的 参数 值 
reset_val text RESET 在 当前 会 话 中 将 重 设 的 参数 值 

置 当前 值 的 配置 文件 (从 源码 而 不 是 配置 文件 设置 值 或 当 

sourcefile text 通过 非 超级 用 户 检查 时 为 null) ; 当 在 配置 文件 中 使 


用 include 指令 时 是 有 帮助 的 。 


冒 当前 值 的 配置 文件 中 的 行 编码 (从 源码 而 不 是 配置 文件 
设置 值 或 当 通 过 非 超 级 用 户 检查 时 为 null) 


sourceline integer 


AJLA context 的 可 能 值 。 以 减少 困难 的 改变 设置 的 顺序 ， 它 们 是 : 


internal 


不 能 直接 更 改 这 些 设 置 ; 它们 反映 了 内 部 确定 的 值 。 其 中 的 一 些 可 以 通过 用 不 同 的 配置 选项 
重建 服务 器 ， 或 通过 改变 提供 给 initdb 的 选项 来 更 改 。 


postmaster 


这 些 选项 只 在 服务 器 启动 时 使 用 ， 所 以 任何 改变 都 需要 重启 服务 器 。 这 些 ; 
在 postgresql.conf 文件 中 ， 或 当 服务 器 启 启动 时 传递 给 命令 行 。 当然 ， 带 有 任何 
低 context 类 型 的 设置 也 可 以 在 服务 器 启动 时 设置 


Sighup 


这 些 设置 可 以 在 postgresql.conf 中 改变 而 不 用 重启 服务 器 。 nie 到 主 进程 
使 其 重读 postgresql.conf 并 应 用 改变 。 主 进程 也 将 SIGHUP 信 号 传递 给 它 的 子 进程 ， 这 样 
它们 所 有 都 使 用 新 值 。 


backend 


这 些 设置 可 以 在 postgresql.conf 中 改变 而 不 用 重启 服务 器 ; 它们 也 可 以 在 连接 需求 包 中 为 特 
定 的 会 话 设置 (例如 ， 通 过 libpq 的 peopTIoNs 环境 变量 ) 。 不 过 ， 这 些 设置 在 会 话 启动 后 永 
远 不 会 改变 。 如 果 你 在 postgresql.conf 中 改变 了 它们 ， 那 么 发 送 一 个 SIGHUP 信号 到 主 进 
程 使 其 重读 postgresql.conf 。 新 值 将 只 影响 随后 加 载 的 会 话 。 


superuser 
这 些 值 可 以 在 postgresql.conf 中 设置 ， 或 在 一 个 会 话 中 通过 ser 命令 设置 ; 但 是 只 有 超级 
用 户 可 以 通过 SET 改变 它们 。 在 postgresql.conf 中 改变 它们 将 只 在 没有 会 话 本 地 值 是 使 
用 SET 建立 的 时 影响 现 有 会 话 。 
user 
这 些 值 可 以 在 postgresql.conf 中 设置 ， 或 在 一 个 会 话 中 通过 ser 命 命 设置。 人 允许 任何 用 户 


改变 他 们 的 会 话 本 地 值 。 postgresql.conf 中 的 改变 将 只 在 没有 会 话 本 地 值 是 使 用 sET 建立 
的 时 影响 现 有 会 话 。 


参阅 Section 18.1 获 取 更 多 关于 改变 这 些 参数 的 各 种 方式 的 信息 


不 能 对 pg_settings 视图 进行 插入 或 者 删除 ， 但 是 可 以 更 新 。 对 pg_settings 中 的 一 行进 行 
UPDATE 等 效 于 在 该 命名 参数 上 执行 SET 命令 。 这 个 修改 只 影响 当前 会 话 使 用 的 数值 。 如 果 
在 一 个 最 后 退出 的 事务 中 发 出 了 uar op, AA ua 命 命 的 效果 将 在 事务 回 滚 之 后 消 
失 。 一 旦 包围 它 的 事务 提交 ， 这 个 效果 将 固化 ， 直 到 会 话 结束 ， 除非 由 其 它 


的 UPDATE 或 SET 命令 覆盖 。 


47.67. pg_shadow 


pg_shadow 存在 是 为 了 向 下 兼容 : 它 模拟 了 一 个 PostgreSQL 版 本 8.1 之 前 的 系统 表 。 它 显示 
了 所 有 在 pg_authid 中 标记 了 rolcanlogin 的 角色 的 属性 。 


这 个 系统 表 的 名 字 来 自 于 该 表 不 能 被 公众 可 读 ， 因 为 它 包含 口 舍 。 pg_user 是 一 个 在 
pg_shadow 上 公开 可 读 的 视图 ， 只 是 把 口令 域 填 成 了 空白 。 


Table 47-68. pg shadow 字段 


名 字 类 型 引用 
qs 
用 
usename name pg_authid .rolname 户 
名 
用 
usesysid oid pg_authid .oid ft 
ID 
usecreatedb bool 用 户 可 以 创建 数据 库 
usesuper bool 用 户 是 超级 用 户 
用 户 可 以 更 新 系统 表 。 即 使 超级 用 户 ， 如 果 这 个 字 
We l 段 不 是 真 ， 也 不 能 更 新 系统 表 。 
cor eo 人 
工 vo 


口令 (可 能 是 加 密 的 ) ; 如 果 没 有 则 为 null。 参 阅 
pg_authid 获取 加 密 的 口 倒是 如 何 存储 的 信息 。 


valuntil abstime 口令 失效 的 时 间 ( 只 用 于 口令 认证 ) 
useconfig text[] 运行 时 配置 变量 的 会 话 缺 省 


passwd text 


47.68. pg_stats 


pg_stats 提供 对 存储 在 pg statistic 表 里 面 的 信息 的 访问 。 这 个 视图 允许 只 访问 那些 

在 pg_statistic 里 面 对 应 用 户 有 权限 读 取 的 表 的 数据 行 ， 因此 可 以 安全 地 人 允许 公众 访问 这 个 
视图 。 

pg_stats 也 设计 成 把 信息 以 一 种 更 易 读 的 方式 出 现 的 形式 ， 它 比 下 层 的 系统 表 更 容易 阅读 ， 
代价 就 是 如 果 在 pg_statistic 里 定义 了 新 的 数据 槽 位 ， 那 么 必须 扩展 它 的 视图 定义 。 


Table 47-69. pg stats 字段 


机 ti 
名 字 类 型 引用 述 
外 
包 
a 
此 
表 
schemaname name pg_namespace .nSpname 的 
模 
= 
名 
=z 
表 
tablename name pg_class .relname 2 
= 
attname name pg_attribute .attname 


Hh Ot FS Nt BE BEST l w 


如 果 为 真 ， 那 么 这 行 包 含 继承 的 子 字 


inherited bool 

段 ， 不 只 是 指定 表 的 值 。 
null_frac real 记录 中 字段 为 空 的 百分比 
avg_width integer 字段 记录 以 字 节 记 的 平均 宽度 


如 果 大 于 需 ， 就 是 在 字段 中 独立 数值 的 
(Ait. MRSS, 就 是 独立 数值 
的 数目 被 行 数 除 的 负数 。 用 负数 形式 是 


n_distinct 


most_common_vals 


most_common_freqs 


histogram_bounds 


correlation 


most_common_elems 


most_common_elem_freqs 


elem_count_histogram 


在 数组 里 的 元 素 的 最 大 数目 可 以 用 ALTER TABLE SET STATISTICS 命令 一 个 一 个 字段 地 控制 ， 


real 


anyarray 


real[] 


anyarray 


real 


anyarray 


real[] 


real[] 


因为 ANALYZE 认为 独立 数值 的 数目 是 随 
着 表 增 长 而 增长 ; 正 数 的 形式 用 于 在 字 
段 看 上 去 好 像 有 固定 的 可 能 值 数 目的 情 
况 下 。 上 比如 ， -1 表示 一 个 唯一 字段 ， 独 
立 数值 的 个 数 和 行 数 相 同 。 


一 个 字段 里 最 常用 数值 的 列表 。 如 果 看 
上 去 没有 啥 数值 比 其 它 更 常见 ， 则 为 


null 


一 个 最 常用 数值 的 频率 的 列表 ， 也 就 是 
说 ， 每 个 出 现 的 次 数 除 以 行 数 。 如 
果 most_common_vals 是 null ， 则 为 
null. 


一 个 数值 的 列表 ， 它 把 字段 的 数值 分 成 

几 组 大 致 相同 热门 的 组 。 如 果 

在 most_common_vals 里 有 数值 ， 则 在 这 

个 饼 图 的 计算 中 省 略 。 如 果 字 段 数据 类 
型 没有 alt; 操作 符 或 

者 most_common_vals 列表 代表 了 整个 分 

布 性 ， 则 这 个 字段 为 null。 


统计 和 与 字段 值 的 物理 行 序 和 逻辑 行 序 有 
关 。 它 的 范围 从 -1 到 +1 。 在 数值 接近 
-1 或 者 +1 的 时 候 ， 在 字段 上 的 索引 扫 
描 将 被 认为 比 它 接近 雳 的 时 候 开 销 更 
D, 因为 减少 了 对 磁盘 的 随机 访问 。 如 
果 字 段 数据 类 型 没有 ait; 操作 符 ， 那 么 
这 个 字段 为 null。 


经 常 在 字段 值 中 出 现 的 非 空 元 素 值 的 列 
表 。 (标量 类 型 为 空 。) 


最 常见 元 素 值 的 频率 列表 ， 也 就 是 ， 至 
少 包含 一 个 给 定 值 的 实例 的 行 的 分 数 。 

每 个 元 素 频 率 跟着 两 到 三 个 附加 的 值 ; 
它们 是 在 每 个 元 素 频 率 之 前 的 最 小 和 最 
大 值 ， 还 有 可 选择 的 null 元 素 的 频率 。 

( 当 most_common_elems 为 null 时 ， 为 

null) 


该 字段 中 值 的 不 同 非 空 元 素 值 的 统计 直 


方 图 ， 跟 着 不 同 非 空 元 素 的 平均 值 。 
(标量 类 型 为 空 。) 


者 通过 设置 运行 时 参数 default_statistics_target 全 局 地 设置 。 


或 


47.69. pg_tables 


pg_tables 提供 了 对 有 关 数 据 库 中 每 个 表 的 有 用 信息 地 访问 。 


Table 47-70. pg_tables 字段 


ro 
名 字 
Schemaname 
tablename 


tableowner 


tablespace 


hasindexes 


hasrules 


hastriggers 


类 型 
name 
name 


name 


name 


boolean 


boolean 


boolean 


引用 
pg_namespace .NSpname 
pg_class .relname 


pg_authid .rolname 


pg_tablespace .SPpcname 


pg_class .relhasindex 


pg_class .relhasrules 


pg_class .relhastriggers 


描述 
包含 表 的 模式 名 字 
表 的 名 字 
表 的 所 有 者 的 名 字 


包含 表 的 表 空 间 名 字 ( 如 果 是 
数据 库 缺 省 ， 则 为 null) 


如 果 表 拥有 (或 者 最 近 拥 有 ) 任 
RS], WAR 


如 果 表 有 (BRERA) 规则 ， 
NAB 


如 果 表 有 (MERA) 触发 
器 ， 则 为 真 


47.70. pg_timezone_abbrevs 


pg_timezone_abbrevs 提供 了 输入 例 程 能 够 识别 的 所 有 时 区 缩写 。 当 运 行 时 参 
数 timezone_abbreviations 发 生 改 变 的 时 候 ， 该 视图 的 内 容 也 会 发 生 改 变 。 


Table 47-71. pg_timezone_abbrevs 字段 


EF 类 型 hl 
abbrev text 时 区 缩写 
utc_offset interval 相对 于 UTC 的 偏 移 量 


is_dst boolean 如 果 这 是 一 个 夏 时 制 时 区 缩写 则 为 真 


47.71. pg_timezone_names 


pg_timezone_names 显示 了 所 有 能 够 被 SET TIMEZONE 识别 的 时 区 名 及 其 缩写 、UTC 偏 移 量 、 

是 否 夏 时 制 。 (学 术 上 ，PostgreSQL 使 用 UT1 而 不 是 UTC， 因 为 它 不 处 理 疼 秒 。) TAFE 
pg_timezone_abbrevs 中 显示 的 缩写 ， 许 多 这 些 名 字 都 隐 含 着 夏 合 时 转换 规则 。 因 此 ， 在 跨越 
夏 合 时 边界 时 相关 信息 会 发 生变 化 。 显示 的 信息 给 予 当前 的 cuRRENT_TIMESTAMP 值 进行 计算 。 


Table 47-72. pg_timezone_names 字段 


Ze 类 型 描述 
name text 时 区 名 
abbrev text 时 区 缩写 
utc_offset interval 相对 于 UTC 的 偏 移 量 ( 正 数 为 东 格 林 威 治 ) 


is dst boolean 如 果 当 前 正 处 于 夏 合 时 范围 则 为 真 


47.72. pg_user 


pg_user 提供 了 对 数据 库 用 户 的 相关 信息 的 访问 。 这 个 视图 只 是 一 个 pg_shadow 的 公众 可 读 
的 部 分 的 视图 化 ， 它 把 口令 域 给 刷 掉 了 。 


Table 47-73. pg_user 字段 


LF 类 型 描述 
usename name 用 户 名 
usesysid oid 用 户 ID 
usecreatedb bool 用 户 可 以 创建 数据 亩 
usesuper bool 用 户 是 一 个 超级 用 户 
gg me 用 pa 即使 超级 用 户 也 不 能 这 么 干 ， 除 非 
userepl bool 用 户 可 以 初始 化 流 复制 并 且 使 系统 处 于 或 离开 各 份 模式 。 
passwd text 不 是 口令 (总 是 为 ******** ) 
valuntil abstime 口令 失 效 的 时 间 (只 用 于 口令 认证 ) 


Sod EXHI 运行 时 配置 参数 的 会 话 缺 省 


47.73. pg_user_mappings 


pg_user_mappings 提供 访问 关于 用 户 映 射 的 信息 的 接口 。 这 个 视图 只 是 一 
个 pg_user_mapping 的 公众 可 读 的 部 分 的 视图 化 ， 如 果 用 户 无 权 使 用 它 则 空 着 选项 字段 。 


Table 47-74. pg_user_mappings 字段 


名 字 


umid 
srvid 


srvname 


umuser 


usename 


umoptions 


类 型 


name 


name 


text[] 


引用 


pg_user_mapping .oid 
pg_foreign_server .Oid 


pg_foreign_server .Srvname 


pg_authid .oid 


被 映射 的 本 地 用 户 的 名 字 


如 果 当 前 用 户 是 外 部 服务 器 的 所 有 者 ， 
则 为 用 户 映射 指定 选项 ， 使 
用 "keyword=value" 字 符 串 ， 否 则 为 null 


描述 
用 户 映射 的 OID 


包含 这 个 映射 的 外 
部 服务 器 的 OID 


外 部 服务 器 的 名 字 


被 映射 的 本 地 角色 
的 OID， 如 果 用 户 
映射 是 公共 的 则 为 
0 


47.74. pg_views 


pg_views 提供 了 对 数据 库 里 每 个 视 的 有 用 信息 的 访 问 途径 。 


Table 47-75. pg views 字段 


名 字 类 型 引用 描述 
schemaname name pg_namespace .nSpname 包含 此 视图 的 模式 名 字 
viewname name pg_class .relname 视图 的 名 字 
viewowner name pg_authid .rolname 视图 的 所 有 者 的 名 字 


definition text 视图 定义 (一 个 重建 的 sELEcT 查询 ) 
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PostgreSQL 使 用 一 种 基于 消息 的 协议 用 于 前 端 和 后 端 (服务 器 和 客户 机 ) 之 间 通 讯 。 该 协议 是 
在 TCP/IP 和 Unix 域 套 接 字 上 实现 的 。 端口 号 5432 已 经 在 IANA 注册 为 使 用 这 种 协议 的 常 
用 端口 ， 但 实际 上 任何 非特 权 端 口号 都 可 以 使 用 。 


这 份 文 档 描 述 了 版 本 3.0 的 协议 ， 在 PostgreSQL 7.4 和 以 后 的 版 本 中 实现 。 对 于 以 前 的 协议 

的 描述 ， 请 参考 以 前 版 本 的 PostgreSQL 文档 。 一 个 服务 器 可 以 支持 多 种 协议 版 本 。 初 始 化 

的 启动 消息 告诉 服务 器 客户 端 可 以 接受 的 协议 版 本 ， 然 后 服务 器 则 遵守 该 版 本 的 协议 (如 果 它 
能 做 到 的 话 )。 


为 了 可 以 有 效 地 为 多 个 客户 端 提供 服务 ， 服 务 器 为 每 个 客户 端 派 生 一 个 新 的 "后 端 "进程 。 在 
目前 的 实现 里 ， 在 检测 到 到 来 的 连接 请 求 后 ， 马 上 创建 一 个 新 的 子 进 程 。 不 过 ， 这 些 是 对 协 
议 透明 的 。 对 于 协议 而 言 ， 术 语 "后 端 " 和 "服务 器 "是 可 以 互 换 的 ; 类 似 的 还 有 "前 端 "和 "客户 
端 "也 是 可 以 互 换 的 。 


48.1. 概要 


协议 在 启动 和 正常 操作 过 程 中 有 不 同 的 阶段 。 在 启动 阶段 里 ， 前 端 打 开 一 个 到 服务 器 的 连接 
并 且 认 证 自身 以 满足 服务 器 。 这 些 可 能 包含 一 条 消息 ， 也 可 能 包含 多 条 消息 ， 根 据 使 用 的 认 
证 方法 而 不 同 。 如 果 所 有 这 些 事情 都 运行 平稳 ， 那 么 服务 器 就 发 送 状态 信息 给 前 端 ， 并 最 后 
进入 正常 操作 。 除了 初始 化 的 启动 请 求 之 外 ， 这 部 分 协议 是 服务 器 驱动 的 。 


在 正常 操作 中 ， 前 端 发 送 查 询 和 其 它 命令 到 后 端 ， 然 后 后 端 返回 查询 结果 和 其 它 响应 。 AD 
数 几 种 情况 (比如 NoTIFY ) 是 后 端 发 送 主动 提供 的 消息 ， 但 绝 大 多 数 情 况 下 会 话 都 是 由 前 端 请 
求 驱动 的 。 


会 话 的 终止 通常 是 由 前 端 来 选择 的 ， 但 是 也 可 以 在 某 些 情况 下 由 后 端 强制 执行 。 不 管 那 种 情 
况 ， 如 果 后 端 关 闭 连 接 ， 那 么 他 将 在 退出 之 前 回 滚 ( 完 成 ) 所 有 打开 的 (未 完成 的 ) 事 务 。 


在 正常 操作 中 ，SQL 命令 可 以 通过 两 个 子 协议 中 的 任何 一 个 执行 。 在 "简单 查询 "协议 中 ， 前 
端 只 是 发 送 一 个 文本 查询 串 ， 然 后 后 端 马上 解析 并 执行 它 。 在 "扩展 查询 "协议 中 ， 查 询 的 处 
理 被 分 割 为 多 个 步骤 : 解析 ， 参 数值 绑 定 ， 和 执行 。 这 样 就 可 以 提供 灵活 性 和 性 能 的 改进 ， 
代价 是 额外 的 复 杀 性 。 


正常 操作 有 用 于 类 似 copy 这 样 的 额外 的 子 协议 。 


48.1.1. 消息 概述 


所 有 通讯 都 是 通过 一 个 消息 流 进行 的 。 消息 的 第 一 个 字 节 标识 消息 类 型 ， 然 后 后 面 跟着 的 四 
个 字 节 声明 消息 剩 下 部 分 的 长 度 (这 个 长 度 包 插 长 度 域 自 身 ， 但 是 不 包括 消 息 类 型 字 节 )。 R 
下 的 消息 内 容 由 消息 类 型 决定 。 由 于 历史 原因 ， 客 户 端 发 送 的 最 早 的 消息 (启动 消息 ) 没 有 初始 
的 消息 类 型 字 节 。 


为 了 避免 和 消息 流失 去 同步 ， 服 务 器 和 客户 端 通常 都 是 把 整个 消息 读 取 到 一 个 缓冲 区 里 (使 用 
字 节 计数 )， 然 后 才 试 图 处 理 其 内 容 。 这 样 在 处 理 内 容 的 过 程 中 ， 如 果 发 现 错误 ， 就 比较 容易 
恢复 。 在 非常 军 见 的 情况 下 (比如 说 没有 足够 的 内 存 用 来 缓冲 消息 )， 接 收 端 可 以 使 用 字 节 计 
数 来 判断 它 在 重新 读 取 消息 之 前 需要 忽略 多 少 输入 。 


通常 ， 服 务 器 和 客户 端 都 需要 注意 决 不 发 送 一 条 不 完整 的 消息 。 这 些 通常 是 通过 在 发 送 消息 
之 前 ， 在 一 个 缓冲 区 里 整理 整 条 消息 。 如 果 在 发 送 或 者 接受 一 条 消息 的 中 间 发 生 了 通讯 错 
误 ， 那 么 唯一 合理 的 反应 是 放弃 连接 ， 因 为 能 够 恢复 消息 边界 同步 的 可 能 性 很 小 。 


48.1.2. 扩展 查询 概述 


在 扩展 查询 协议 中 ，SQL 命令 的 执行 是 被 分 割 成 多 个 步骤 的 。 步骤 与 步骤 之 间 保 存 的 状态 是 
由 两 类 的 对 象 代表 的 : 预备 语句 和 入 口 。 一 个 预备 语句 代表 一 个 文本 查询 字符 串 的 经 过 语法 
分 析 ， 语 意 分 析 ， 以 及 规划 之 后 的 结果 。 一 个 预备 语句 不 一 定 就 是 可 以 执行 的 ， 因 为 它 可 能 
还 缺乏 参数 的 值 。 一 个 入 口 代表 一 个 已 经 可 以 执行 的 或 者 已 经 部 分 执行 过 的 语句 ， 所 有 参数 
都 已 经 填充 到 位 了 。 (对 于 SELECT 语句 ， 入 口 等 效 于 一 个 打开 的 游标 ， 使 用 不 同 的 术语 是 因 
为 游标 不 能 义理 非 SELECT 语句 )。 


完整 的 执行 周期 包括 一 个 解析 步骤 ， 它 用 一 个 文本 的 查询 字符 串 创 建 一 个 预备 语句 ; 一 个 绑 
定 步骤 ， 它 用 一 个 预 各 语句 和 任何 所 需要 的 参数 值 创 建 一 个 人 口 ; 以 及 一 个 执行 步骤 ， 它 运 
行 一 个 入 口 的 查询 。 如 果 是 一 个 返回 数据 行 的 查询 ( SELECT ，SHow 等 )， 可 以 告诉 执行 步骤 
只 抓 取 有 限 的 一 些 行 ， 这 样 就 可 能 需要 多 个 执行 步骤 来 完成 操作 。 


后 端 可 以 跟踪 多 个 预备 语句 和 人口 (但 是 要 注意 ， 这 些 只 在 一 个 会 话 内 部 存在 ， 从 来 不 能 在 会 
话 之 间 共 享 )。 现存 的 预备 语句 和 和 口 都 是 用 创建 它们 的 时 候 赋 予 的 名 字 引 用 的 。 另外 ， 还 存 
在 一 个 "未 命名 "的 预备 语句 和 人 和 人口。 尽管 它们 的 行为 和 命名 对 象 大 部 分 相同 ， 但 是 它们 是 针 

对 只 执行 一 次 然后 就 抛弃 的 查询 进行 优化 过 的 ， 而 在 命名 对 象 上 的 操作 是 针对 多 次 使 用 优化 

的 。 


48.1.3. 格式 和 格式 代码 


特定 数据 类 型 的 数据 可 以 用 几 种 不 同 的 格式 中 的 任意 一 种 来 传递 。 到 PostgreSQL 7.4 的 时 
候 ， 只 支持 "文本 "和 "二 进 制 "两 种 格式 ， 但 是 协议 为 未 来 的 扩展 提供 了 的 手段 。 任意 值 要 求 的 
格式 是 用 一 个 格式 代码 声明 的 。 客 户 端 可 以 为 每 个 传输 的 参数 值 和 查询 结果 的 每 个 字段 声明 
一 个 格式 代码 。 文本 的 格式 代码 是 0， 二 进 制 的 格式 代码 是 1， 所 有 其 它 的 格式 代码 都 保留 给 
将 来 定义 。 


文本 方式 的 数值 是 特定 数据 类 型 的 输入 /输出 转换 函数 接受 或 者 生成 的 数值 的 字符 串 形式 。 在 
传输 时 的 表现 上 ， 字 符 串 末尾 没有 空 字符 ; 如 果 前 端 要 想 把 收 到 的 值 当 作 C 字符 串 处 理 ， 那 
么 必须 自己 加 上 一 个 。 (另外 ， 文 本 格式 不 允许 岁入 的 空 。) 


整数 的 二 进 制 表现 形式 采用 网 络 字 节 序 (高 位 在 前 )。 对 于 其 它 数 据 类 型 ， 请 参考 文档 或 者 源 
代码 了 解 其 二 进 制 表现 形式 。 请 注意 ， 复 条 的 数据 类 型 的 二 进 制 形式 可 能 在 不 同 服务 器 版 本 
之 间 变 化 ; 文本 格式 通常 是 最 具有 移植 性 的 选择 。 


48.2. 消息 流 


本 节 描 述 消息 流 ， 以 及 每 种 消息 类 型 的 语意 (每 种 消息 的 准确 表现 细节 在 Section 48.5 里 )。 
连接 的 状态 不 同 ， 存 在 几 种 不 同 的 子 协议 : BH. Bi, WRG. copy 、 结 束 。 还 有 用 
于 异步 操作 (包括 通知 响应 和 命 合 取消 ) 的 特殊 规定 ， 这 些 异步 操作 可 能 在 启动 阶段 过 后 的 任何 
时 间 产 生 。 


48.2.1. Ba 


要 开始 一 个 会 话 ， 前 端 打 开 一 个 与 服务 器 的 连接 并 且 发 送 一 个 启动 消息 。 这 个 消息 包括 用 户 
名 以 及 用 户 希望 与 之 连接 的 数据 库 ; 它 还 标识 要 使 用 的 特定 的 协议 版 本 。 (AN, BARRA 
以 包括 用 于 运行 时 参数 的 额外 设置 。) 服务 器 然后 就 使 用 这 些 信息 以 及 它 的 配置 文件 的 内 容 
(比如 pg_nba.conf ) 以 判断 这 个 连接 是 否 可 以 接受 ， 以 及 需要 什么 样 的 额外 的 认证 (如 果 有 )。 


然后 服务 器 就 发 送 合适 的 认证 请 求 消息 ， 前 端 必须 用 合适 的 认证 响应 消息 来 响应 (比如 一 个 口 
S) 对 所 有 的 认证 方法 ， 除 了 GSSAPI 和 SSPI， 最 多 只 有 一 次 请 求 和 响应 。 有 些 认 证 方法 则 
根本 不 需要 前 端的 响应 ， 因 此 就 没有 认证 请 求 发 生 。 对 于 GSSAPI 和 SSPI， 为 了 完成 认证 则 
可 能 需要 多 次 数据 包 的 交换 。 


认证 周期 的 结束 要 么 是 服务 器 拒绝 连接 (ErrorResponse)， 要 么 是 服务 器 发 送 
AuthenticationOk 消 息 。 


这 个 阶段 来 自 服务 器 可 能 消息 是 : 
ErrorResponse 

连接 请 求 被 拒绝 。 然 后 服务 器 马上 关闭 连接 。 
AuthenticationOk 

认证 信息 的 交换 成 功 完成 。 
AuthenticationKerberosV5 


现在 前 端 必 须 与 服务 器 进行 一 次 KerberosV5 认证 对 话 ( 是 Kerberos 规 范 的 一 部 分 ， 在 这 里 没 
有 描述 )。 如 果 对 话 成 功 ， 服 务 器 响应 一 个 AuthenticationOk 消 息 ， 否 则 它 响应 一 个 
ErrorResponse 消 息 。 


AuthenticationCleartextPassword 


现在 前 端 必 须发 送 一 个 包含 明文 口令 的 PasswordMessage 包 。 如 果 这 是 正确 的 口 舍 ， 服 务 
器 用 一 个 AuthenticationOk 包 响 应 ， 否 则 它 响 应 一 个 ErrorResponse 包 。 


AuthenticationMD5Password 


现在 前 端 必须 发 送 一 个 包含 用 MD5 加 密 的 口令 (包括 用 户 名 ) KW PasswordMessage, W% 
时 使 用 在 AuthenticationMD5Password 消息 里 指定 的 4 字 节 随机 盐 粒 。 如 果 这 是 正确 口令 ， 
服务 器 用 一 个 AuthenticationOk 响应 ， 否 则 它 用 一 个 ErrorResponse 响应 。 实际 的 
PasswordMessage FJ LAi it SQLiS 

名 concat('md5',md5(concat(md5(concat(password, username)), random-salt))) 计算 得 到 。 ( 注 
意 mds() 画 数 的 返回 值 是 16 进 制 表 示 的 字符 串 。 ) 


AuthenticationSCMCredential 


这 个 响应 只 会 在 那些 支持 SCM 信任 消息 的 本 地 Unix 域 连 接 上 出 现 。 前 端 必 须发 出 一 条 
SCM 信任 消息 然后 发 送 一 个 数据 字 节 。 (数据 字 节 的 内 容 并 不 会 被 关心 ; 它 的 作用 只 是 确保 
服务 器 等 待 了 足够 长 的 时 间 来 接受 信任 信息 。) 如 果 信 任 是 可 以 接受 的 ， 那 么 服务 器 用 
AuthenticationOk 响应 ， 否 则 用 ErrorResponse 响应 。 (只 有 9.1 以 前 的 服务 器 才 可 能 发 出 这 
个 消息 ， 并 且 这 个 消息 最 终 可 能 会 被 从 协议 中 删除 。) 


AuthenticationGSS 


现在 前 端 必须 发 起 一 个 GSSAPI 协 商 。 作为 响应 前 端 将 随 着 GSSAPI 数 据 流 的 最 初 部 分 发 送 一 
个 PasswordMessage 包 。 如 果 需 要 进一步 的 消息 ， 服 务 端 将 以 AuthenticationGSSContinue 
作为 响应 。 


AuthenticationSSPI 


现在 前 端 必须 发 起 一 个 SSPI 协 商 。 作为 响应 前 端 将 随 着 SSPI 数 据 流 的 最 初 部 分 发 送 一 个 
PasswordMessage 包 。 如 果 需 要 进一步 的 消息 ， 服 务 端 将 以 AuthenticationGSSContinue 作 
为 响应 。 


AuthenticationGSSContinue 


这 个 消息 包含 GSSAPI 或 SSPI 协 商 的 上 一 个 步骤 AuthenticationGSS, AuthenticationSSPI 或 
前 一 个 AuthenticationGSSContinue) 的 响应 数据 。 如 果 这 个 消息 中 的 GSSAPI 或 SSPI 数 据 指 
示 需 要 更 多 的 数据 以 完成 认证 过 程 ， 前 端 必须 用 另 一 个 PasswordMessage 包 发 送 这 些 数据 。 
如 果 通 过 这 个 消息 GSSAPI 或 SSPI 认 证 已 完成 ， 服 务 端 下 次 将 发 送 AuthenticationOk 指 示 认 证 
成 功 或 ErrorResponse 指 示 认 证 失败 。 


如 果 前 端 不 支持 服务 器 要 求 的 认证 方式 ， 那 么 它 应 该 马上 关闭 连接 。 


在 收 到 AuthenticationOk 包 之 后 ， 前 端 必 须 等 竺 来自 后 端的 更 多 消息 。 在 这 个 阶段 会 启动 一 
个 后 端 进程 ， 而 前 端 只 是 一 个 感 兴 趣 的 看 热闹 的 。 启动 尝试 仍然 有 可 能 失败 
(ErrorResponse)， 但 是 通常 情况 下 ， 后 端 将 发 送 一 些 ParameterStatus 消息 、 
BackendKeyData 、 最 后 是 ReadyForQuery 。 


在 这 个 阶段 ， 后 端 业 党 试 应 用 任何 在 启动 消息 里 给 出 的 额外 的 运行 时 参数 设置 。 如 果 成 功 ， 
这 些 值 将 成 为 会 话 的 缺 省 值 。 错 误 将 导致 ErrorResponse 并 退出 。 


这 个 阶段 来 自 后 端的 可 能 消息 是 : 


BackendKeyData 


这 个 消息 提供 了 密 钥 (secret-key) 数 据 ， 前 端 如 果 想 要 在 稍 后 发 出 取消 的 请 求 ， 则 必须 保存 这 
个 数据 。 前 端 不 应 该 响应 这 个 消息 ， 但 是 应 该 继续 侦 听 等 待 ReadyForQuery 消息 。 


ParameterStatus 


这 个 消息 告诉 前 端 有 关 后 端 参 数 的 当前 (初始 化 ) 设 置 ， 上 比如 client_encoding 或 DateStyle 
等 。 前 端 可 以 忽略 这 个 消息 ， 或 者 记录 其 设置 用 于 将 来 使 用 ; 参阅 Section 48.2.6 获 取 更 多 细 
节 。 前 端 不 应 该 响应 这 个 消息 ， 而 是 应 该 继续 侦 听 ReadyForQuery 消息 。 


ReadyForQuery 

后 端 启动 成 功 ， 前 端 现在 可 以 发 出 命令 。 
ErrorResponse 

后 端 启动 失败 。 在 发 送 完 这 个 消息 之 后 连接 被 关闭 。 
NoticeResponse 


发 出 了 一 个 警告 消息 。 前 端 应 该 显示 这 个 消息 ， 并 且 继 续 等 待 ReadyForQuery 或 
ErrorResponse 。 


后 端 在 每 个 查询 循环 后 都 会 发 出 一 个 相同 的 ReadyForQuery 消息 。 前 端 可 以 合理 地 认为 
ReadyForQuery 是 一 个 查询 循环 的 开始 ， 或 者 认为 ReadyForQuery 是 启动 阶段 和 每 个 随后 
查询 循环 的 结束 ， 具 体 是 哪 种 情况 取决 于 前 端的 编码 需要 。 


48.2.2. 简单 查询 


一 个 查询 循环 是 由 前 端 发 送 一 条 Query 消息 给 后 端 进 行 初始 化 的 。 这 条 消息 包含 一 个 用 文本 
字符 串 表 示 的 SQL 命令 (或 者 一 些 命令 )。 后 端 根 据 查 询 命令 字符 串 的 内 容 发 送 一 条 或 者 更 多 
条 响应 消息 给 前 端 ， 并 且 最 后 是 一 条 ReadyForQuery 响应 消息 。 ReadyForQuery 通知 前 端 
它 可 以 安全 地 发 送 新 命 全 了 。 (实际 上 前 端 不 必 在 发 送 其 它 命 分 之 前 等 待 ReadyForQuery , 
但 是 这 样 一 来 ， 前 端 必须 负责 区 分 早先 发 出 的 命 分 失 败 ， 而 稍 后 发 出 的 命令 成 功 的 情况 。 ) 


从 后 端 来 的 可 能 的 消息 是 : 

CommandComplete 

一 个 SQL 命令 正常 结 

CopylnResponse 

后 端 已 经 准备 好 从 前 端 拷贝 数据 到 一 个 表 里 面 去 。 又 见 Section 48.2.5, 


CopyOutResponse 


后 端 已 经 准备 好 从 一 个 表 里 拷贝 数据 到 前 端 里 面 去 。 又 见 Section 48.2.5, 
RowDescription 


表示 为 了 响应 一 个 SELECT ，FETCH 等 的 查询 ， 将 要 返回 一 个 行 。 这 条 消息 的 内 容 描述 了 这 
行 的 字段 布局 。 这 条 消息 后 面 将 跟着 每 个 返回 给 前 端的 行 一 个 的 DataRow 消息 。 


DataRow 

SELECT , FETCH 等 查询 返回 的 结果 集中 的 一 行 。 

EmptyQueryResponse 

识别 了 一 个 空 的 查询 字符 串 。 

ErrorResponse 

出 错 了 。 

ReadyForQuery 

查询 字符 串 的 处 理 完 成 。 发 送 一 个 独立 的 消息 来 标识 这 个 是 因为 查询 字符 串 可 能 包含 多 个 


SQL #843. (CommandComplete 只 是 标记 一 条 SQL 命令 义理 完 半 ， 而 不 是 整个 字符 串 。) 
ReadyForQuery 总 会 被 发 送 ， 不 管 是 处 理 成 功 结束 还 是 产生 错误 。 


NoticeResponse 


发 送 了 一 个 与 查询 有 关 的 警告 消息 。 注 意 警 告 消息 是 附加 在 其 它 响应 上 的 ， 也 就 是 说 ,后 端 料 


继续 义理 该 命令 。 


SELECT (或 其 它 返 回 结果 集 的 查询 ， 比 如 EXPLAIN 或 show ) 查 询 的 响应 通常 包含 
RowDescription ， 雳 个 或 者 多 个 DataRow 消息 ， 以 及 最 后 的 CommandComplete 。 从 或 者 
到 前 端的 copy 使 用 Section 48.2.5 里 提 到 的 特殊 的 协议 。 所 有 其 它 查询 类 型 通常 只 生成 一 个 
CommandComplete 消息 。 


因为 查询 字符 串 可 能 包含 若干 个 查询 (用 分 号 分 隔 )， 所 以 在 后 端 完成 查询 字符 串 的 处 理 之 前 可 
能 有 好 几 个 这 样 的 响应 序列 。 如 果 整 个 字符 串 已 经 处 理 完 ， 后 端 已 经 准备 好 接受 新 查询 字符 
串 的 时 候 则 发 出 ReadyForQuery 消息 。 


如 果 收 到 一 个 完全 空 (除了 空白 之 外 没有 内 容 ) 的 查询 字符 串 ， 那 么 响应 是 一 条 
EmptyQueryResponse 后 面 跟着 ReadyForQuery 。 


在 出 现 错误 的 时 候 ， 发 出 一 个 ErrorResponse 消息 ， 后 面 跟着 ReadyForQuery 。 查询 字符 
串 的 所 有 后 继 的 处 理 都 被 ErrorResponse 中 止 (即使 里 面 还 有 查询 也 这 么 干 )。 请 注意 这 些 事 
情 可 能 在 处 理 一 个 查询 产生 的 消息 序列 的 中 途 发 生 。 


在 简单 查询 模式 ， 检 索 出 来 的 数值 的 格式 总 是 文本 的 ， 除 非 给 出 的 命令 是 从 一 个 声明 
了 BINARY 选项 的 游标 上 的 FETcH o 在 这 种 情况 下 ， 检 索 出 来 的 数值 是 二 进 制 格式 的 。 在 
RowDescription 消息 里 给 出 的 格式 代码 告诉 用 了 哪 种 格式 。 


前 端 在 等 待 其 它 类 型 的 消息 时 必须 准备 接收 ErrorResponse 和 NoticeResponse 消息 。 参 
阅 Section 48.2.6 后 端 因 为 外 部 的 事件 可 能 生成 的 消息 。 


建议 的 方法 是 把 前 端 代码 写成 状态 机 的 风格 ， 它 可 以 在 任何 时 刻 接 受 任何 有 意义 的 消息 ， 而 
不 是 写成 假设 消息 的 准确 序列 的 代码 。 


48.2.3. 扩展 查询 


扩展 的 查询 协议 把 上 面 描述 的 简单 协议 分 裂 成 若干 个 步骤 。 准 各 的 步骤 可 以 多 次 复 用 以 提高 
效率 。 另外 ， 还 可 以 获得 额外 的 特性 ， 比 如 把 数据 值 作为 独立 的 参数 提供 的 可 能 性 ， 而 不 是 
把 它们 直接 插入 一 个 查询 字符 串 。 


在 扩展 的 协议 里 ， 前 端 首先 发 送 一 个 Parse 消息 ， 它 包含 一 个 文本 查询 字符 串 ， 另 外 还 有 一 
些 有 关 参 数 占 位 符 的 数据 类 型 的 信息 ， 以 及 一 个 最 终 预 各 语句 对 象 的 名 字 ( 一 个 空 字 符 串 选择 
未 命名 的 预备 语句 )。 响应 要 么 是 一 个 ParseComplete 要 么 是 ErrorResponse 。 参 数 数 据 类 
型 可 以 用 OID 来 声明 ; 如 果 没 有 给 出 ， 那 么 分 析 器 将 试图 用 它 对 付 无 类 型 的 字符 串 常 量 的 方 
法 来 推导 其 数据 类 型 。 


Note: 一 个 参数 数据 类 型 可 以 通过 设置 为 零 ， 或 者 让 参数 类 型 OID 的 数目 比 查 询 字符 串 
里 的 参数 符号 ( $8*…n_) 的 数目 少 的 方法 不 予 声明 。 另外 一 个 特例 是 参数 的 类 型 可 以 声明 
A void (也 就 是 伪 类 型 void 的 OID)。 这 是 为 了 允许 用 于 某 些 函数 参数 的 参数 符号 实 
际 上 是 OUT 参数 。 通常 情况 下 ， 没 有 什么 环境 会 用 到 void 参数 ， 但 是 如 果 在 函数 的 
参数 列表 里 出 现 了 这 人 么 一 个 参数 符号 ， 那 么 它 实际 上 会 被 忽略 。 比如， 一 个 像 这 样 的 汞 
数 调 用 : foo($1,$2,$3,$4) ， 如 果 $3 和 $4 声明 为 类 型 是 void ， 那 么 这 个 函数 调用 
可 以 匹配 一 个 带 有 两 个 IN 和 两 个 OUT 参数 的 函数 。 


Note: 在 一 个 Parse 消息 里 包含 的 查询 字符 串 不 能 包含 超过 一 个 SQL 语句 ; 否则 就 会 报 
告 一 个 语法 错误 。 这 个 限制 在 简单 查询 协议 中 并 不 存在 ， 但 是 它 存在 于 扩展 的 协议 中 ， 
因为 允许 预备 语句 或 者 和 人口 包含 多 个 命令 将 导致 协议 过 度 地 复 杀 。 





如 果 成 功 创建 了 一 个 命名 的 预备 语句 对 象 ， 那 么 它 将 持续 到 当前 会 话 结束 ， 除 非 明 确 删 除 。 
一 个 未 命名 的 预 各 语句 只 持续 到 下 一 个 声明 未 命名 的 语句 的 Parse 语句 发 出 为 止 (请 注意 一 个 
简单 的 查询 消息 也 删除 未 命名 语句 )。 命名 的 预备 语句 必须 明确 地 关闭 ， 然 后 才能 用 一 个 
Parse 消息 重新 定义 ， 但 是 未 命名 的 语句 并 不 要 求 这 个 动作 。 命名 的 预备 语句 也 可 以 在 SQL 
命令 级 创建 和 访问 ， 方 法 是 使 用 PREPARE 和 EXECUTE o 


只 要 预备 语句 还 存在 ， 那 么 就 可 以 使 用 Bind 消息 很 容易 地 使 之 进入 执行 状态 。 Bind 消息 给 
出 源 预 各 语句 的 名 字 ( 空 字符 串 表 示 未 命名 的 预备 语句 )， 目 标 人 口 的 名 字 ( 空 字符 串 表 示 未 命 
名 的 入 口 )， 以 及 用 于 那些 在 预备 语句 中 出 现 的 所 有 参数 占 位 符 的 数值 。 提供 的 参数 集 必 须 匹 


配 那 些 预备 语句 需要 的 未 西 。( 如 果 你 在 Parse 消息 里 声明 任何 void BM, AA Bind 消 
息 里 给 它们 传递 NULL 值 。) Bind 还 声明 用 于 查询 返回 的 任何 数据 的 格式 ; 格式 可 以 一 次 声 
明 ， 也 可 以 每 个 字段 进行 声明 。 响 应 要 么 是 BindComplete 要 么 是 ErrorResponse 。 


Note: 输出 的 格式 是 文本 还 是 二 进 制 是 由 Bind 里 给 出 的 格式 代码 决定 的 ， 不 管用 的 是 什 
A SQL 命令 。 在 使 用 扩展 的 查询 协议 的 时 候 ， 游 标 声明 里 的 BINARY 属性 是 不 起 作用 
的 。 











典型 的 查询 计划 在 处 理 Bind 消 息 后 生成 。 预备 语句 如 果 不 包含 参数 ， 或 者 被 反复 执行 的 情况 
下 ， 服 务 端 可 能 会 保存 创建 好 的 查询 计划 并 在 后 续 的 针对 同样 的 Bind 消 息 中 重用 它 。 但 是 ， 
只 有 确保 这 样 作成 的 通用 的 查询 计划 不 至 于 上 比 依赖 于 特定 参数 值 的 查询 计划 效率 差 太 多 的 情 
况 下 ， 服 务 端 才 会 这 人 么 做 。 就 协议 而 言 这 些 是 透明 的 。 


如 果 成 功 创建 了 一 个 命名 的 入 口 对 象 ， 那 么 它 将 持续 到 当前 会 话 结束 ， 除 非 明确 删除 。 一 个 
未 命名 的 入 口 只 持续 到 事务 结束 或 下 一 个 声明 未 命名 的 入 口 的 Bind 消 息 发 出 为 止 (请 注意 一 个 
简单 的 查询 消息 也 删除 未 命名 入 口 )。 命名 的 入 口 必须 明确 地 关闭 ， 然 后 才能 用 另 一 个 Bind 

消息 重新 定义 ， 但 是 未 命名 的 语句 并 不 要 求 这 个 动作 。 命名 的 入 口 也 可 以 在 SQL 命令 级 创建 
和 访问 ， 方 法 是 使 用 pEcLARE CURSOR 和 FETCH o 


只 要 存在 一 个 入 口 ， 那 么 就 可 以 用 一 个 Execute 消息 执行 它 。 Execute 消息 声明 入 口 的 名 字 
( 空 字符 串 表示 未 命名 入 口 ) 和 一 个 最 大 的 结果 行 计数 ( 需 表 示 " 抓 取 所 有 行 ")。 结果 行 计 数 只 对 
包含 返回 结果 集 的 入 口 有 意义 ; 在 其 它 情况 下 ， 该 命令 总 是 执行 到 结束 ， 而 行 计 数 会 被 忽 
o Execute 可 能 的 响应 和 那些 通过 简单 查询 协议 发 出 的 查询 一 样 ， 只 不 过 Execute 不 会 导 
致 后 端 发 出 ReadyForQuery 或 者 RowDescription 。 


如 果 Execute 在 一 个 入 口 的 执行 完成 之 前 终止 (因为 达到 了 一 个 非 需 的 结果 行 计数 )， 它 将 发 送 
一 个 PortalSuspended 消息 ; 这 个 消息 的 出 现 告诉 前 端 应 该 在 同一 个 人 口上 发 出 另外 一 个 
Execute 以 完成 操作 。 在 入 口 的 执行 完成 之 前 ， 不 会 发 出 表示 源 SQL 命令 结束 的 
CommandComplete 消息 。 因此 Execute 阶段 的 结束 总 是 由 出 现下 列 之 一 的 消息 标志 的 : 
CommandComplete 、EmptyQueryResponse( 如 果 入 口 是 从 一 个 空 字 符 串 创建 出 来 的 )、 
ErrorResponse 、PortalSuspended 。 


每 个 扩展 查询 消息 序列 完成 后 ， 前 端 都 应 该 发 出 一 条 Sync 消息 。 这 个 无 参数 的 消息 导致 后 
端 关 闭 当前 事务 一 如 果 当 前 事务 不 是 在 一 个 BEGIN / commit 事务 块 中 的 话 ("关闭 "的 意思 就 
是 在 没有 错误 的 情况 下 提交 ， 或 者 是 有 错误 的 情况 下 回 滚 )。 然后 响应 一 条 ReadyForQuery 
消息 。Sync 的 目的 是 提供 一 个 错误 恢复 的 重新 同步 的 点 。 如 果 在 处 理 任何 扩展 查询 消息 的 时 
候 侦 测 到 任何 错误 ， 那 么 后 端 发 出 ErrorResponse ， 然 后 读 取 并 抛 奔 消 息 ， 直 到 一 个 sync 的 
到 来 ， 然 后 发 出 ReadyForQuery 并 且 返 回 到 正常 的 消息 义理 中 。 (但 是 要 注意 如 果 正 在 义理 
Sync 的 时 候 发 生 了 错误 ， 那 么 不 会 忽略 任何 东西 一 这 样 就 保证 了 为 每 个 Sync 发 出 一 个 并 且 
只 有 一 个 的 ReadyForQuery 。 








Note: Sync 并 不 导致 一 个 用 BEGIN 打开 的 事务 块 关 闭 。 可 以 侦 测 到 这 种 情况 ， 因 为 
ReadyForQuery 消息 包含 事务 状态 信息 。 











除了 这 些 基 本 的 ， 必 须 的 操作 之 外 ， 在 扩展 查询 协议 里 还 有 几 种 可 选 的 操作 可 以 使 用 。 


Describe 消息 (入 口 变 体 ) 指 定 一 个 现 有 的 入 口 的 名 字 ( 如 果 是 一 个 未 命名 的 入 口 则 是 一 个 空 字 
FE) 响应 是 一 个 RowDescription 消息 ， 它 描述 了 执行 入 口 将 要 返回 的 行 ; 或 者 是 一 个 
NoData 消息 (如 果 入 口 并 不 包含 会 返回 行 的 查询 ) ; 或 者 是 一 个 ErrorResponse( 如 果 没 有 这 个 
AQ). 


Describe 消息 (语句 变 体 ) 指 定 一 个 现 有 的 预备 语句 的 名 字 ( 如 果 是 一 个 未 命名 的 预备 语句 则 是 
一 个 空 字 符 串 )。 响应 是 一 个 描述 该 语句 需要 的 参数 的 ParameterDescription 消息 ， 后 面 跟着 
一 个 描述 语句 最 终 执行 后 返回 的 行 的 RowDescription 消息 (或 者 是 NoData 消息 ， 如 果 该 语句 
不 返回 行 )。 如 果 没 有 这 样 的 预备 语句 ， 则 返回 ErrorResponse 。 请 注意 因为 还 没有 发 出 
Bind ， 所 以 后 端 还 不 知道 用 于 返回 字段 的 格式 ; 在 这 种 情况 下 ，RowDescription 消息 里 面 的 
格式 代码 字段 将 是 需 。 





Tip: 在 大 多 数 情 况 下 ， 前 端 在 发 出 Execute 之 前 应 该 发 出 某 种 Describe 的 变 体 ， 以 保证 
它 知道 如 何 解 析 它 将 得 到 的 结果 。 

















Close 消息 关闭 一 个 现 有 的 预备 语句 或 者 入 口 ， 并 且 和 释放 资源 。 对 一 个 不 存在 的 语句 或 者 入 
口 名 字 发 出 Close 不 是 一 个 错误 。 响应 通常 是 CloseComplete ， 但 如 果 在 释放 资源 的 时 候 发 
生 了 一 些 困 难 也 可 以 是 ErrorResponse 。 请 注意 关闭 一 个 预备 语句 隐 合 地 关闭 任何 从 该 语句 
构造 出 来 的 打开 的 入 口 。 


Flush 消息 并 不 导致 任何 特定 的 输出 的 生成 ， 但 是 强制 后 端 发 送 任何 还 在 它 的 输出 缓冲 区 中 停 
留 的 数据 。 Flush 必须 在 除 Sync 外 的 任何 扩展 查询 命令 后 面 发 出 (如 果 前 端 希望 在 发 出 更 多 

的 命令 之 前 检查 该 命令 的 结果 的 话 )。 如 果 不 Flush ， 后 端 返回 的 消息 将 组 合成 最 小 可 能 的 数 
据 包 个 数 ， 以 减少 网 络 负荷 。 


Note: 简单 查询 消息 大 概 等 于 一 系列 使 用 未 命名 的 预 各 语句 和 无 参数 的 人口 对 象 的 Parse 
、Bind 、 入 口 Describe 、Execute 、Close 、Sync 。 一 个 区 别 是 它 会 在 查询 字符 串 中 

接受 多 个 SQL 语句 ， 并 在 会 话 中 为 每 个 语句 自动 执行 绑 定 /描述 /执行 序列 。 另外 一 个 区 

别 是 它 不 会 返回 ParseComplete 、Bindcomplete 、CloseComplete 、NoData 消息 。 


48.2.4. 函数 调用 


图 数 调 用 子 协议 允许 客户 端 请 求 一 个 对 存在 于 数据 库 pg_proc 系统 表 中 的 任意 画 数 的 直接 调 
用 。 客户 端 必 须 在 该 萎 数 上 有 执行 的 权限 。 


Note: 函数 调用 子 协议 是 一 个 遗留 的 特性 ， 在 新 代码 里 最 好 避免 用 它 。 类 似 的 结果 可 以 
通过 设置 一 个 SELECT function($1, ...) 预备 语句 获得 。 这 样 贺 数 调用 循环 就 可 以 用 
Bind/Execute Ë, 


一 个 画 数 调用 循环 是 由 前 端 向 后 端 发 送 一 条 FunctionCall 消息 初始 化 的 。 然后 后 端 根 据 范 数 


调用 的 结果 发 送 一 条 或 者 更 多 响应 消息 ， 并 且 在 最 后 是 一 条 ReadyForQuery 响应 消息 。 
ReadyForQuery 通知 前 端 它 可 以 安全 地 发 送 一 条 新 的 查询 或 者 函数 调用 了 。 


从 后 端 来 的 可 能 的 消息 是 : 
ErrorResponse 

发 生 了 一 个 错误 。 
FunctionCallResponse 


函数 调用 完成 并 且 在 消息 中 返回 一 个 结果 。 GER, HAA MNRAS Sipe, 
不 能 处 理 行 类 型 或 者 结果 集 。) 


ReadyForQuery 


函数 调用 义理 完成 。ReadyForQuery 将 总 是 被 发 送 ， 不 管 是 成 功 完成 处 理 还 是 发 生 了 一 个 错 


`n 
IRo 
NoticeResponse 
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48.2.5. COPY 操 作 


copy 命令 允许 在 服务 器 和 客户 端 之 间 高 速 的 大 批量 数据 传输 。 拷贝 和 和 拷贝 出 操作 每 个 都 
把 连接 切换 到 一 个 独立 的 子 协议 中 ， 并 且 持 续 到 操作 结束 。 


拷贝 人 模式 (数据 传输 到 服务 器 ) 是 在 后 端 执行 一 个 coPY FRoM STDIN 语句 的 时 候 初 始 化 的 。 后 
端 发 送 一 个 CopylnResponse 消息 给 前 端 。 前 端 应 该 发 送 需 条 或 者 更 多 CopyData 消息 ， 形 
成 一 个 输出 数据 的 流 。 (消息 的 边界 和 行 的 边界 没有 任何 相关 性 要 求 ， 尽 管 通常 那 就 是 合理 的 
边界 选择 。) 前 端 可 以 通过 发 送 一 个 CopyDone 消息 来 终止 拷贝 人 操作 (允许 成 功 终止 )， 也 可 
以 发 出 一 个 CopyFail 消息 ( 它 将 导致 copy 语句 带 着 错误 失败 )。 然后 后 端 就 恢复 回 它 在 
copy 开始 之 前 的 命令 处 理 模 式 ， 可 能 是 简单 查询 协议 ， 也 可 能 是 扩展 查询 协议 。 然后 它 会 
发 送 CommandComplete( 如 果 成 功 ) 或 者 ErrorResponse( 如 果 失 败 )。 


如 果 在 拷贝 入 模式 下 后 端 检 测 到 了 错误 (包括 接受 接收 到 CopyFiail 消息 ， 或 者 是 任何 除了 
CopyData 或 者 CopyDone 之 外 的 前 端 消 息 )， 那 么 后 端 料 发 出 一 个 ErrorResponse 消息 。 如 
果 copy 命令 是 通过 一 个 扩展 的 查询 消息 发 出 的 ， 那 么 后 端 从 现在 开始 将 抛 奔 前 端 消息 ， 直 
到 一 个 Sync 消息 到 达 ， 然 后 它 将 发 出 ReadyForQuery 并 且 返 回 到 正常 的 处 理 中 。 如 

R copy 命 命 是 在 一 个 简单 查询 消息 里 发 出 的 ， 那 么 该 消息 剩余 部 分 被 丢弃 然后 发 出 
ReadyForQuery 消息 。 不 管 是 哪 种 情况 ， 任 何 前 端 发 出 的 CopyData, CopyDone, CopyFail 
消息 都 将 被 简单 地 抛弃 。 


后 端 将 会 忽略 拷贝 入 模式 时 接收 到 的 Flush 和 Sync 消息 。 收 到 任何 其 它 非 拷贝 消息 ， 会 引 
发 错误 ， 如 前 所 述 这 样 会 导致 退出 拷贝 人 状态 。 (Flush 和 Sync 的 例外 是 为 了 方便 客户 端 库 
在 执行 Execute 消息 后 始终 发 送 Flush 或 Sync 而 不 检查 所 执行 的 命令 是 否 是 一 个 COPY 


FROM STDIN 命令 。) 


拷贝 出 模式 (数据 从 服务 器 发 出 ) 是 在 后 端 执行 一 个 copy to stoout 语句 的 时 候 初 始 化 的 。 后 
端 发 出 一 个 CopyOutResponse 消息 给 前 端 ， 后 面 跟着 需 或 者 多 个 CopyData 消息 (总 是 每 行 
一 个 )， 然 后 跟着 CopyDone 。 然后 后 端 回 退 到 它 在 coy 开始 之 前 的 命令 义理 模式 ， 然 后 发 
送 CommandComplete 。 前 端 不 能 退出 传输 (除非 是 关闭 连接 或 者 发 出 一 个 Cancel 请 求 )， 
但 是 它 可 以 抛弃 不 需要 的 CopyData 和 CopyDone 消息 。 


在 拷贝 出 模式 中 ， 如 果 后 端 检 测 到 错误 ， 那 么 它 将 发 出 一 个 ErrorResponse 消息 并 且 回 到 正 
常 的 尔 理 。 前 端 应 该 把 收 到 ErrorResponse 当 作 终 止 拷 贝 出 模式 的 标志 。 


NoticeResponse 和 ParameterStatus 消 息 有 可 能 夹 在 CopyData 消 息 间 出 现 。 前 端 必 须 处 理 这 
种 情况 ， 并 且 也 应 该 准备 好 人 处理 其 它 异步 消息 (参阅 Section 48.2.6)。 除 此 以 外 ， 任 何 
CopyData 和 CopyDone 以 外 的 消息 应 该 被 视 作 拷贝 出 模式 的 中 止 。 


还 有 一 个 拷贝 相关 的 模式 ， 称 作 双 向 拷贝 ， 它 允许 从 和 到 服务 端的 高 速 的 批量 数据 传输 。 双 
向 拷贝 模式 由 多 于 walsender 模 式 的 后 端 执 行 一 条 START_REPLICATION 语句 初始 化 。 后 端 发 送 
一 个 CopyBothResponse 绘 前端。 然后 后 端 和 前 端 可 能 都 发 送 CopyData 消 息 ， 直 到 有 一 方 发 
出 一 个 CopyDone 消 息 。 客户 端 发送 CopyDone 消 息 后 ， 连 接 从 双向 拷贝 模式 切换 到 拷贝 出 模 
式 ， 并 且 客 户 端 不 应 该 再 发 出 任何 CopyData 消 息 。 相似 的 ， 如 果 服 务 端 发 出 CopyDone 消 
息 ， 连 接 进 入 拷贝 和 模式， 并 且 服 务 端 不 应 该 再 发 出 任何 CopyData 消 息 。 两 边 都 发 送 了 
CopyDone 消 息 后 ， 拷 贝 模式 终止 ， 后 端 返回 到 命令 义理 模式 。 在 双向 拷贝 模式 中 ， 如 果 后 
端 检 出 错误 ， 将 发 出 一 个 ErrorResponse 消 息 ， 丢 弃 任何 来 自前 端的 消息 直到 收 到 Sync 消 
息 ， 然 后 发 送 ReadyForQuery 消 息 并 返回 到 普通 的 处 理 模 式 。 前 端点 把 收 到 ErrorResponse 
消息 作为 在 两 个 方向 上 都 终止 拷贝 的 标志 ， 这 个 时 候 不 应 该 发 出 CopyDone 消 息 。 请 参 

阅 Section 48.3 获 得 更 多 有 关 双 向 拷贝 模式 下 子 协议 传输 的 信息 。 


LL A= /二 


CopylnResponse，CopyOutResponse 和 CopyBothResponse 消息 包含 了 告诉 前 端 每 行 的 字 
段 数 以 及 每 个 字段 使 用 的 格式 代码 的 信息 。 (就 目前 的 实现 而 言 ， 某 个 copy 操作 的 所 有 字段 
都 使 用 同样 的 格式 ， 但 是 消息 设计 并 不 做 这 个 假设 。) 


48.2.6. 异步 操作 


有 几 种 情况 下 后 端 会 发 送 一 些 并 非 由 特定 的 前 端的 命令 流 提 示 的 消息 。 在 任何 时 候 前 端 都 必 
须 准 备 处 理 这 些 消 息 ， 即 使 是 并 未 涉及 到 查询 处 理 的 时 候 。 至 少 ， 应 该 在 开始 读 取 查 询 响 应 
之 前 检查 这 些 情况 。 


NoticeResponse 消息 有 可 能 是 因为 外 部 的 活动 而 生成 的 ; 比如 ， 如 果 数 据 库 管理 员 进 行 一 
次 "快速 "数据 库 关闭 ， 那 么 后 端 将 在 关闭 连接 之 前 发 送 一 个 NoticeResponse 来 通知 这 件 事 。 
因此 ， 前 端 应 该 总 是 准备 接受 和 显示 NoticeResponse 消息 ， 即 使 连接 表面 上 是 空闲 的 时 候 也 
如 此 。 


如 果 后 端 认 为 前 端 应 该 知道 的 任何 参数 的 实际 值 发 生 了 变化 ， 那 么 都 会 产生 ParameterStatus 
消息 。 这 些 最 经 常 发 生 的 地 方 是 前 端 执 行 的 一 个 set 命令 的 响应 ， 并 且 这 个 时 候 实 际 上 是 同 
步 (但 是 也 有 可 能 是 数据 库 管 理 员 改变 了 配置 文件 然后 SIGHUP 了 服务 器 导致 的 参数 状态 的 变 
化 )。 同样 ， 如 果 一 个 set 命令 回 滚 ， 那 么 也 会 生成 合适 的 ParameterStatus 消息 以 报告 当前 
有 效 的 数值 。 


目前 ， 系 统 内 有 一 套 会 生成 ParameterStatus 消息 的 硬 编码 的 参数 : 他 们 是 

server_version ~ server_encoding 、 client encoding 、 application_name 、 is_superuser 、 
session_authorization 、 DateStyle 、 IntervalStyle 、 TimeZone 、 integer_datetimes 以 
及 standard_conforming_strings o (8.0 以 前 的 版 本 不 会 报 

E server_encoding 、 TimeZone 和 integer_datetimes o 8.1 以 前 的 版 本 不 会 报 

告 standard_conforming_strings 。 8.4 以 前 的 版 本 不 会 报告 Intervalstyle 。 9.0 以 前 的 版 本 
不 会 报告 application_name 。) 请 注 

意 server_version ~ Sserver_encoding 和 integer_datetimes 是 伪 参 数 ， 启动 后 不 能 修改 。 这 
个 参数 集合 可 能 在 将 会 改变 ， 或 者 甚至 是 变 成 可 以 配置 的 。 因 此 ， 前 端 应 该 简单 地 忽略 那些 
它 不 懂 或 者 不 关心 的 ParameterStatus 。 


如 果 前 端 发 出 一 个 Listen 命 伟 ， 那 么 为 同一 个 通道 名 执行 了 NoTIFY 命令 后 ， 将 收 到 后 端 发 
来 的 一 个 NotificationResponse 消息 (不 要 和 NoticeResponse 混淆 )。 





Note: 目前 ，NotificationResponse 只 能 在 一 个 事务 外 面 发 送 ， 因 此 它 将 不 会 在 一 个 命令 
响应 序列 中 间 出 现 ， 但 是 它 可 能 在 ReadyForQuery 之 前 出 现 。 不 过 ， 在 前 端 逻 辑 中 做 
上 述 假 设 是 不 明智 的 。 好 的 做 法 是 在 协议 的 任何 点 上 都 可 以 接受 NotificationResponse 


o 








48.2.7. 取消 正在 处 理 的 请 求 


在 一 条 查询 正在 处 理 的 时 人 息 ， 前 端 可 能 请 求 取消 这 个 查询 。 这 样 的 取消 请 求 不 是 直接 通过 打 
开 的 当前 连接 发 送 给 后 端的 ， 这 么 做 是 因为 实现 的 有 效 性 : 不 希望 后 端 在 处 理 查询 的 过 程 中 
不 停 地 检查 前 端 来 的 输入 。 取消 请 求 应 该 相对 而 言 比较 少见 ， 所 以 把 取消 做 得 稍微 答 拙 一 

些 ， 以 便 不 影响 正常 状况 的 性 能 。 


要 发 送 一 条 取消 请 求 ， 前 端 打 开 一 个 与 服务 器 的 新 连接 并 且 发 送 一 条 CancelRequest 消息 ， 
而 不 是 通常 在 新 连接 中 经 常 发 送 的 StartupPacket 消息 。 服务 器 将 义理 这 个 请 求 然后 关闭 连 
接 。 出 于 安全 原因 ， 对 取消 请 求 消息 不 做 直接 的 响应 。 


除非 CancelRequest 消息 包含 与 连接 启动 过 程 中 传递 给 前 端的 相同 的 键 数据 (PID 和 安全 键 
字 )， 否 则 它 将 被 忽略 。 如 果 该 请 求 匹 配 当 前 运行 着 的 后 端的 PID 和 安全 键 字 ， 则 退出 当前 查 
询 的 处 理 (目前 的 实现 里 采用 的 方法 是 向 正在 处 理 该 查询 的 后 端 进程 发 送 一 个 特殊 的 信号 )。 


取消 信号 可 能 有 也 可 能 没有 任何 作用 。 例如 ， 如 果 它 在 后 端 已 经 完成 了 查询 的 处 理 后 到 这， 
那么 它 就 没有 作用 。 如 果 取 消 起 作用 了 ， 其 结果 是 当前 命令 带 着 一 个 错误 消息 提前 退出 。 


这 人 么 做 是 对 安全 和 有 效 性 通盘 考虑 的 结果 ， 前 端 没 有 直接 的 方法 获知 一 个 取消 请 求 是 否 
功 。 它 必须 继续 等 待 后 端 对 查询 响应 。 执 行 取消 仅仅 是 增加 了 当前 查询 快 些 结束 的 可 能 性 ， 
以 及 增加 了 当前 查询 会 带 着 一 条 错误 消息 失败 而 不 是 成 功 执行 的 可 能 性 。 


因为 取消 请 求 是 通过 新 的 连接 发 送 给 服务 器 而 不 是 通过 通常 的 前 /后 端 通讯 连接 ， 所 以 取消 请 
求 可 能 是 任意 进程 执行 的 ， 而 不 仅仅 是 要 取消 查询 的 前 端 。 这 样 可 能 对 创建 多 进程 应 用 有 某 
种 有 灵活 性 的 好 处 。 但 是 同时 这 样 也 带 来 了 安全 风险 ， 因 为 这 样 任何 一 个 非 认 证 用 户 都 可 能 试 
图 取消 查询 。 这 个 安全 风险 通过 要 求 在 取消 请 求 中 提供 一 个 动态 生成 的 安全 键 字 排 除 。 


48.2.8. 终止 


通常 ， 优 雅 的 终止 过 程 是 前 端 发 送 一 条 Terminate 消 息 并 且 立 刻 关闭 连接 。 一 旦 收 到 这 个 消 
息 ， 后 端 马 上 关闭 连接 并 且 退 出 。 


在 少数 情况 下 (比如 通过 一 个 管理 员 命令 关闭 数据 库 )， 后 端 可 能 在 没有 任何 前 端 请 求 的 情况 下 
断 开 连接 。 在 这 种 情况 下 ， 后 端 将 在 它 断 开 连 接 之 前 尝试 发 送 一 个 错误 或 者 通知 消息 ， 给 出 
断 开 的 原因 。 


其 它 终止 的 情况 发 生 在 各 种 失效 的 场合 ， 上 比如 某 一 方 的 内 核 转 储 ， 失 去 通讯 链 路 ， 丢 失 了 消 
息 边界 同步 等 。 不 管 是 前 端 还 是 后 端 看 到 了 一 个 意外 的 连接 关闭 ， 那 么 它 应 该 清理 现场 并 且 
终止 。 如 果 前 端 不 想 终止 自 己 ， 那 么 它 可 以 通过 再 次 连接 服务 器 的 方式 重启 一 个 新 的 后 端 。 
如 果 收 到 了 一 个 无 法 识别 的 消息 ， 那 么 也 建议 关闭 连接 ， 因 为 出 现 这 种 情况 可 能 意味 着 是 去 
失 了 消息 边界 的 同步 。 


不 管 是 正常 还 是 异常 的 终止 ， 任 何 打开 的 事务 都 会 回 滚 ， 而 不 是 提交 。 不 过 ， 应 该 注意 的 是 
如 果 一 个 前 端 在 一 个 非 seLEcT 查询 正在 处 理 的 时 候 断 开 ， 那 么 后 端 很 可 能 在 注意 到 断 开 之 前 
先 完成 查询 的 处 理 。 如 果 查 询 处 于 任何 事务 块 之 外 (( BEGIN ... commit 序列 )， 那 么 其 结果 很 
可 能 在 得 知 断 开 之 前 被 提交 。 


48.2.9. SSL 会 话 加 密 


如 果 编 译 PostgreSQL 的 时 候 打 开 了 SSL 支 持 ， 那 么 前 后 端 通讯 就 可 以 用 SSL 加 密 。 这 样 就 提 
供 了 一 种 在 攻击 者 可 能 捕获 会 话 通讯 数据 包 的 环境 下 保证 通讯 安全 的 方法 。 有 关 使 用 SSL 加 
密 PostgreSQL 会 话 的 更 多 信息 ， 请 参阅 Section 17.9。 


要 开始 一 次 SSL 加 密 连 接 ， 前 端 先是 发 送 一 个 SSLRequest 消息 ， 而 不 是 StartupMessage 。 
然后 服务 器 以 一 个 包含 s 或 N 的 字 节 响应 ， 分 别 表 示 它 愿意 还 是 不 愿意 进行 SSL。 如 果 前 端 
对 响应 不 满意 ， 那 么 它 可 以 关闭 连接 。 要 在 s 之 后 继续 ， 那 么 先进 行 与 服务 器 的 SSL 和 启动 握 
手 ( 没 有 在 这 里 描述 ， 这 是 SSL 规 范 的 一 部 分 )。 如 果 这 些 成 功 了 ， 那 么 继续 发 送 普 通 的 
StartupMessage 。 这 种 情况 下 ，StartupMessage 和 所 有 随后 的 数据 都 将 由 SSL 加 密 。 要 
在 N 之 后 继续 ， 则 发 送 普通 的 StartupMessage 然后 不 带 加 密 进行 处 理 。 


前 端 应 该 也 准备 处 理 一 个 来 自 服务 器 的 给 SSLRequest 的 ErrorMessage 响应 。 这 种 情况 只 
有 在 那些 SSL 支 持 被 加 入 到 PostgreSQL 以 前 的 服务 上 才 会 出 现 。 (这 样 的 服务 器 太古 老 了 ， 
很 可 能 根本 就 不 存在 。) 在 这 种 情况 下 ， 连 接 必 需 关 闭 ， 但 是 前 端 可 以 选择 打开 一 个 新 的 连接 
然后 不 带 SSL 进 行 连接 。 


一 个 初始 化 的 SSLRequest 也 可 以 用 于 为 了 发 送 一 条 CancelRequest 消息 而 打开 的 连接 中 。 
如 果 协 议 本 身 并 未 提供 某 种 方法 强制 SSL 加 密 ， 那 么 管理 员 可 以 把 服务 器 配置 为 拒绝 未 加 密 的 


会 话 ， 这 是 认证 检查 的 一 个 副产品 。 


48.3. 流 复 制 协议 


为 了 初始 化 流 复制 ， 前 端 需要 发 送 带 replication 参数 的 startup 消 息 。 这 告诉 后 端 进入 
walsender 模 式 ， 在 这 个 模式 下 可 以 发 送 数量 不 多 的 复制 命令 集 而 不 是 通常 的 SQL 命 伟 。 并 且 
在 walsender 模 式 下 ， 只 能 使 用 简单 查询 协议 。 walsender 模 式 下 可 以 接受 的 命令 如 下 : 


IDENTIFY SYSTEM 
请 求 服 务 端 标识 自己 。 服 务 端 会 应 答 一 个 只 有 一 行 的 结果 集 ， 包 含 3 个 字段 。 
Systemid 


标识 数据 库 集群 的 唯一 的 系统 标识 符 。 这 个 可 以 用 于 检查 初始 化 各 机 用 的 基础 各 份 来 自 同一 
个 数据 库 集群 。 


timeline 

当前 的 时 间 线 ID(TimelinelD)。 同样 可 用 于 检查 各 机 和 主机 的 一 致 性 。 

xlogpos 

当前 的 xlog 的 写 入 位 置 。 可 用 于 获得 在 事务 日 志 中 流 从 哪 而 开始 的 已 知 的 位 置信 息 。 
TIMELINEHISTORY `_tli 


请 求 服务 端 为 时 间 线 tli 发 送 时 间 线 历史 文件 。 服务 端 会 点 答 一 个 只 有 一 行 的 结果 集 ， 包 


含 3 个 字段 。 

filename 

时 间 线 历史 文件 的 文件 名 ， 上 比如 00000002.history。 
content 

时 间 线 历史 文件 的 内 容 。 

STARTREPLICATION `_XXX/XXX TIMELINE tl? 


指示 服务 端 从 时 间 线 _t1li” 上 的 WAL 位 置 _xxx/xxx_ 开始 WAL 流 。 服务 端 可 能 会 回应 一 个 错 
误 ， 比 如 ， 如 果 在 请 求 的 WAL 段 已 经 被 回收 的 情况 下 。 如 果 成 功 ， 服 务 端 响应 一 个 
CopyBothResponse 消 息 ， 然 后 开启 到 前 端的 WAL 流 。 


如 果 客 户 端 请 求 的 时 间 线 不 是 最 新 的 ， 但 是 是 服务 端 历史 的 一 部 分 ， 服 务 端 笃 会 传送 从 请 求 
的 开始 点 开始 直到 服务 端 切换 到 另 一 个 时 间 线 为 止 这 个 时 间 线 上 的 所 有 WAL。 如 果 客 户 端 请 
求 的 流 正 好 在 旧时 间 线 的 终点 上 ， 服 务 端 会 立即 响应 一 个 CommandComplete 而 不 进入 COPY 
模式 。 


传送 完 这 个 非 最 新 的 时 间 线 上 的 所 有 WAL 后 ， 服 务 端 退出 COPY 模 式 结束 流 。 当 客户 端 也 以 
退出 COPY 模 式 作 为 应 答 ， 服 务 端 发 送 一 个 只 有 一 行 的 结果 集 ， 包 含 2 的 字段 ， 指 示 在 这 个 服 
务 器 上 的 下 一 个 时 间 线 。 第 一 列 是 下 一 个 时 间 线 的 ID， 第 二 列 是 发 生 切 换 的 XLOG 位 置 。 通 
常 切换 点 是 已 经 传送 的 WAL 流 的 终点 ， 但 是 在 极端 的 情况 下 ， 服 务 端 发 送 的 WAL 可 能 来 自 自 
己 升 级 前 还 没有 回放 的 旧 的 时 间 线 。 最 终 服务 端 发 送 CommandComplete 消 息 并 准备 接收 新 
的 命令。 


WAL 数 据 作 为 一 系列 的 CopyData 消 息 发 送 。 〈 这 克 许 混合 其 它 信息 ， 具 体 而 言 服务 端 在 开始 
流 之 后 发 生 了 失败 可 以 发 送 ErrorResponse 消 息 。) 每 个 从 服务 端 到 客户 端的 CopyData 消 息 
的 装载 数据 中 包含 下 面 的 格式 的 消息 : 


XLogData (B) 

Byte1('w’) 

标识 消息 是 一 个 WAL 数 据 。 
Int64 

消息 内 的 WAL 数 据 开始 点 。 
Int64 

当前 服务 端 上 的 WAL 禾 点 。 
Int64 

传送 时 服务 端 上 的 系统 时 间 ， 是 从 2000-01-01 午 夜 开 始 的 微 秒 数 。 
Byte _n_ 

WAL 数 据 流 的 片段 。 


单个 的 WAL 记 录 一 定 不 会 被 分 割 成 2 个 XLogData 消 息 。 当 一 个 WAL 记 录 跨 越 WAL 页 的 边界 ， 
并 且 因 此 已 经 被 连续 的 记录 分 割 了 ， 可 以 在 页 边界 上 分 割 。 换 句 话说 ， 第 一 个 主要 的 WAL 记 
录 和 它 后 续 的 记录 可 能 以 不 同 XLogData 消 息 传送 。 


主 keepalive 消 息 (B) 

Byte1('k') 

标识 这 是 一 个 发 送 者 的 keepalive 消 息 。 
Int64 

服务 端 上 当前 的 WAL 终 点 。 

Int64 


传送 时 服务 端 上 的 系统 时 间 ， 是 从 2000-01-01 午 夜 开始 的 微 秒 数 。 


Byte1 
1 意味 着 客户 端 应 该 尽 可 能 快 的 应 答 这 个 消息 ， 以 防止 超时 切断 连接 。0 的 意思 相反 。 


接受 进程 可 以 在 任何 时 间 使 用 以 下 消息 格式 ( 同 祥 作为 CopyData 消 息 的 装载 数据 ) 应 答 发 送 
者 : 


备 机 状态 更 新 (F) 

Byte1('r’) 

标识 这 是 一 个 接受 者 的 状态 更 新 消息 。 

Int64 

各 机 上 接受 并 写 入 磁盘 的 上 次 的 WAL 字 节 +1 的 位 置 。 

Int64 

各 机 上 刷新 到 磁盘 的 上 次 的 WAL 字 节 +1 的 位 置 。 

Int64 

备 机 上 已 经 应 用 的 上 次 的 WAL 字 节 +1 的 位 置 。 

Int64 

传送 时 客户 端 上 的 系统 时 间 ， 是 从 2000-01-01 午 夜 开 始 的 微 秒 数 。 
Byte1 

如 果 是 1， 客 户 端 请 求 服务 端 立即 应 答 这 个 消息 。 这 用 于 ping 服 务 端 以 测试 连接 是 否 还 健康 。 
热 备 机 的 反馈 消息 (F) 

Byte1('h') 

标识 这 是 一 个 热 各 机 的 反馈 消息 。 

Int64 

传送 时 客户 端 上 的 系统 时 间 ， 是 从 2000-01-01 午 夜 开 始 的 微 秒 数 。 
Int32 


备 机 上 现在 的 xmin。 如 果 备 机 正在 传送 热 备 机 反馈 将 不 再 发 到 这 个 连接 上 的 通知 ， 这 个 值 可 
能 为 0。 之 后 非 零 的 消息 可 能 再 初始 化 反馈 机 制 。 


Int32 


各 机 的 当前 时 间 戳 。 


BASEBACKUP [ LaBeL “label'_ ] [ PROGRESS ] [ FAST ] [ WAL ] [ NOWAIT] 


指示 服务 器 开始 一 个 基础 备份 的 流 。 系 统 将 在 备份 开始 前 自动 进入 备份 模式 ， 并 且 在 备份 完 
成 后 回 到 原来 的 状态 。 可 以 接受 以 下 选项 : 


LABEL _'label'_ 
设 定 备份 的 标签 。 如 果 没 有 指定 ， 则 使 用 base backup o 标签 的 引号 使 用 规则 
与 standard_conforming_strings 开 关 打 开 时 的 标准 SQL 字 符 串 相同 。 


PROGRESS 


请 求 产 生 进 度 报告 时 要 用 的 信息 。 这 将 在 每 个 表 空 间 的 头 部 发 回 一 个 近似 的 大 小 ， 用 于 计算 
到 流 结束 还 有 多 少 距离 。 这 个 大 小 是 在 传输 前 通过 一 次 性 统计 所 有 文件 的 大 小 获取 的 ， 可 能 
会 产生 性 能 上 的 冲击 - 实际 上 在 传送 第 一 个 流 前 可 能 会 花 比 较 长 的 时 间 。 既然 数据 库 文 件 可 
能 在 备份 过 程 中 改变 ， 这 个 大 小 只 是 近似 的 ， 并 且 在 估算 和 实际 发 送 文件 之 间 可 能 增长 和 收 
缩 。 


FAST 
请 求 一 个 快速 的 检查 点 (checkpoint)。 
WAL 


包含 这 个 各 份 所 必要 的 WAL 段 。 将 包括 在 各 份 开 始 和 结束 期 间 pg_xlog 目录 下 的 所 有 base 目 
录 tar 文 件 。 


NOWAIT 


缺 省 时 备份 会 等 待 最 后 一 个 需要 的 xlog 段 被 为 档 ， 或 者 在 没有 启用 为 档 的 情况 下 发 出 一 个 警 
mo 指定 NowAIT 可 以 把 等 待 和 警告 无 效 ， 让 客户 端 负责 确认 需要 的 日 志 是 否 有 效 。 


备份 开始 时 ， 服 务 端 首先 发 送 2 个 通常 的 结果 集 ， 然 后 是 1 个 以 上 的 CopyResponse 结 果 。 


最 初 的 通常 的 结果 集 里 ， 包 含 由 2 列 构成 的 单一 行 的 备份 位 置 。 第 一 个 列 是 XLogRecPtr 形 式 
的 开始 位 置 ， 第 二 列 是 对 应 的 时 间 线 ID。 


第 二 个 通常 的 结果 集 里 各 个 表 空 间 一 行 数据 。 每 行 包含 的 字段 如 下 : 
spcoid 

RA iq oid, base 目 录 的 情况 下 则 为 NULL o 

spclocation 

表 空 间 目 录 的 完全 路 径 。base 目 录 的 情况 下 则 为 NULL o 

size 


要 求 进度 状况 报告 的 情况 下 ， 表 空间 的 估算 容量 。 没有 要 求 的 情况 下 为 nL o 


个 通常 结果 集 之 后 被 送 过 来 的 是 一 个 以 上 的 CopyResponse 结 果 。 一 个 是 PGDATA 用 
其 余 的 则 是 每 个 pg_default 、 pg global 以 外 的 追加 表 空 间 都 有 一 个 。 CopyResponse 
果 内 的 数据 是 表 空 间 内 容 的 tar 形 式 (遵照 POSIX 1003.1-2008 规 定 的 "ustar 交 换 形式 ") 的 
转 储 (dump)。 但 是 ， 标 准 规定 的 最 后 的 2 个 需 数 据 块 被 省 掉 了 。 tar 数 据 结束 后 ， 和 开始 位 置 
的 形式 相同 ， 是 包含 各 份 终 了 位 置 的 最 终 的 结果 集 。 


第 二 
es 


Adatah MEDRE Hitara Aa s FAIRE X, FEC ilzPostgreSQe 的 文件 
还 是 相同 目录 下 的 其 它 在 文件 。 但 是 以 下 文件 被 排除 在 外 


e postmaster.pid 


© postmaster.opts 


e pg_xlog ， 包含 子 目 录 。 如 果 各 份 是 包含 WAL 执 行 的 ， 将 包含 一 个 合成 版 的 pg_xlog o 
它 只 包含 对 于 备份 工 作 必 须 的 文件 而 没有 其 余 的 内 容 。 


如 果 服 务 器 的 文件 系统 支持 的 话 ， 所 有 者 ， 组 和 文件 模式 会 被 设置 。 


所 有 的 表 空 间 被 传送 完 后 ， 发 送 最 终 的 通常 结果 集 。 这 个 结果 集 里 包含 单一 行 单 一 列 的 
XLogRecPtr 格 式 的 各 份 结束 位 置 。 


48.4. 消息 数据 类 型 


本 节 描 述 消息 里 用 到 的 基本 数据 类 型 。 
inti (n) 


一 个 网 络 字 节 顺 序 的 n 位 整数 。 如 果 声 明了 i ， 它 就 是 将 出 现 的 确切 值 ， 否 则 这 个 数值 
就 是 一 个 变量 。 比如 Int16 ，Int32(42)。 


Int n_[_k_] 


一 个 k 个 n 位 整数 元 素 的 数组 ， 每 个 都 是 以 网 络 字 节 顺序 存储 的 。 数组 长 度 k 总 是 
由 消息 前 面 的 字段 来 判断 的 。 比 如 Int16[M] 


String( _s_ ) 


一 个 (C 风格 的 ) 空 结尾 的 字符 串 。 对 字符 串 没有 特别 的 长 度 限制 。 如 果 声 明了 s , PAC 
是 将 出 现 的 确切 的 数值 ， 否 则 这 个 数值 就 是 一 个 变量 。 比如 String, String("user")。 


Note: 后 端 返回 的 字符 串 的 可 能 长 度 没有 预定 义 的 限制 。 所 以 前 端 必 须 使 用 良好 的 编码 
策略 ， 使 用 某 种 可 扩展 的 缓冲 区 以 便 能 接受 任何 能 放 进 内 存 里 的 东西 。 如 果 那 样 做 不 可 
行 ， 则 读 取 全 长 的 字符 捉 然后 抛弃 不 能 放 进 你 的 定 长 缓冲 区 的 尾部 字符 。 

Byte n_(_c_) 


精确 的 on FP. 如 果 字 段 宽 度 n 不 是 一 个 常量 ， 那 么 总 是 可 以 从 消息 中 更 早 的 字段 中 判 
断 它 。 如 果 声 明了 c 那么 它 是 确切 数值 。 例 如 Byte2, Byte1(\n') 


48.5. 消息 格式 


本 节 描 述 各 种 消息 的 详细 格式 。 每 种 消息 都 标记 为 它 是 由 一 个 前 端 (F)， 一 个 后 端 (B) 或 者 两 者 
(F &B) 发 送 的 。 请 注意 ， 尽 管 每 条 消息 在 开头 都 包含 一 个 字 节 计数 ， 消 息 格式 也 定义 为 可 以 
不 用 参考 字 节 计数 就 可 以 找到 消息 的 结尾 。 这 样 就 增加 了 有 效 性 检查 。CopyData 消息 是 一 
个 例外 ， 因 为 它 形 成 一 个 数据 流 的 一 部 分 ; 任意 独立 的 CopyData 消息 可 能 是 无 法 自 解 释 

的 。 


AuthenticationOk (B) 
Byte1('R’) 
标识 该 消息 是 一 条 认证 请 求 。 
Int32(8) 

以 字 节 记 的 消息 内 容 长 度 ， 包 括 这 个 长 度 本 身 。 
Int32(0) 
声明 该 认证 是 成 功 的 。 
AuthenticationKerberosV5 (B) 
Byte1('R’) 
标识 该 消息 是 一 条 认证 请 求 。 
Int32(8) 

以 字 节 记 的 消息 内 容 长 度 ， 包 括 长 度 自身 。 
Int32(2) 
声明 需要 Kerberos V5 认证 。 
AuthenticationCleartextPassword (B) 
Byte1('R’) 
标识 该 消息 是 一 条 认证 请 求 。 
Int32(8) 

以 字 节 记 的 消息 内 容 长 度 ， 包 括 长 度 自身 。 
Int32(3) 


声明 需要 一 个 明文 的 口令。 


AuthenticationMD5Password (B) 
Byte1('R’) 

标识 这 条 消息 是 一 个 认证 请 求 。 

Int32(12) 

以 字 节 记 的 消息 内 容 的 长 度 ， 包 括 长 度 本 身 。 
Int32(5) 

声明 需要 一 个 MD5 加 密 的 口 今 。 

Byte4 

加 密 口 邻 的 时 候 使 用 的 盐 粒 。 
AuthenticationSCMCredential (B) 
Byte1('R’) 

标识 这 条 消息 是 一 个 认证 请 求 。 

Int32(8) 

以 字 节 计 的 消息 内 容 长 度 ， 包 括 长 度 本 身 。 
Int32(6) 

声明 需要 一 个 SCM 信任 消息 。 
AuthenticationGSS (B) 

Byte1('R’) 

标识 这 条 消息 是 一 个 认证 请 求 。 

Int32(8) 

以 字 节 记 的 消息 内 容 的 长 度 ， 包 括 长 度 本 身 。 
Int32(7) 

声明 需要 GSSAPI 认 证 。 
AuthenticationSSPI (B) 

Byte1('R’) 

标识 这 条 消息 是 一 个 认证 请 求 。 


Int32(8) 


以 字 节 记 的 消息 内 容 的 长 度 ， 包 括 长 度 本 身 。 
Int32(9) 
声明 需要 SSPI 认 证 。 


AuthenticationGSSContinue (B) 


Byte1('R’) 
标识 这 条 消息 是 一 个 认证 请 求 。 
Int32 


以 字 节 记 的 消息 内 容 的 长 度 ， 包 括 长 度 本 身 。 
Int32(8) 
标识 本 消息 包含 GSSAPI 或 SSPI 数 据 。 
Byte _n_ 
GSSAPI 或 者 SSPI 认 证 数据 。 


BackendKeyData (B) 


Byte1('K’) 

标识 该 消息 是 一 个 取消 键 字数 据 。 如 果 前 端 希望 
它 必须 保存 这 个 值 。 

Int32(12) 


以 字 节 记 的 消息 内 容 的 长 度 ， 包 插 长 度 本 身 。 


Int32 

此 后 端的 密 钥 

Bind (F) 

Byte1('B') 

标识 该 消息 是 一 个 绑 定 命令 
Int32 


以 字 节 记 的 消息 内 容 的 长 度 ， 包 插 长 度 本 身 。 


能 够 在 稍 后 发 出 CancelRequest 消息 ， 那 么 


String 

目标 入 口 的 名 字 ( 空 字符 串 则 选取 未 命名 的 入 口 ) 

String 

源 预 备 语句 的 名 字 ( 空 字符 串 则 选取 未 命名 的 预备 语句 ) 
Int16 


后 面 跟 着 的 参数 格式 代码 的 数目 (在 下 面 的 c_ 中 说 明 )。 这 个 数值 可 以 是 0， 表 示 没 有 参数 ， 
或 者 是 参数 都 使 用 缺 省 格式 (文本 ) ; 或 者 是 1， 这 种 情况 下 声明 的 格式 代码 应 用 于 所 有 参数 ; 
或 者 它 可 以 等 于 实际 数目 的 参数 。 


Int16[ _c_] 

参数 格式 代码 。 目 前 每 个 都 必须 是 0( 文 本 ) 或 者 1( 二 进 制 )。 

Int16 

后 面 跟着 的 参数 值 的 数目 (可 能 为 需 )。 这 些 必须 和 查询 需要 的 参数 个 数 匹配 。 
然后 ， 每 个 参数 都 会 出 现下 面 的 字段 对 : 

Int32 


参数 值 的 长 度 ， 以 字 节 记 ( 这 个 长 度 并 不 包含 长 度 本 身 )。 可 以 为 0。 一 个 特殊 的 情况 是 ，-1 表 
示 一 个 NULL 参数 值 。 在 NULL 的 情况 下 ， 后 面 不 会 跟着 数值 字 节 。 


Byte _n_ 

参数 值 ， 格 式 是 用 相关 的 格式 代码 表示 的 。 _n_ 是 上 面 的 长 度 。 
在 最 后 一 个 参数 之 后 ， 出 现下 面 的 字段 : 

Int16 


后 面 跟着 的 结果 字段 格式 代码 数目 (下 面 的 _R_ 描述 )。 这 个 数目 可 以 是 0 表示 没有 结果 字段 ， 
或 者 结果 字段 都 使 用 缺 省 格式 (文本 ) ; 或 者 是 1， 这 种 情况 下 声明 格式 代码 应 用 于 所 有 结果 字 
段 (如 果 有 的 话 ) ; 或 者 它 可 以 等 于 查询 的 结果 字段 的 实际 数目 。 


Int16[ _R_ ] 

结果 字段 格式 代码 。 目 前 每 个 必须 是 0( 文 本 ) 或 者 1( 二 进 制 )。 
BindComplete (B) 

Byte1('2') 


标识 消息 为 一 个 绑 定 结束 标识 符 


Int32(4) 
以 字 节 记 的 消息 长 度 ， 包 括 长 度 本 身 。 
CancelRequest (F) 

Int32(16) 

以 字 节 记 的 消息 长 度 ， 包 括 长 度 本 身 。 
Int32(80877102) 


取消 请 求 代码 。 选 这 个 值 是 为 了 在 高 16 位 包含 1234 ， 低 16 位 包含 s678 。 (为 避免 混 
乱 ， 这 个 代码 必须 与 协议 版 本 号 不 同 。) 


Int32 
目标 后 端的 进程 号 (PID) 
Int32 
目标 后 端的 密 钥 
Close (F) 
Byte1('C') 
标识 这 条 消息 是 一 个 Close HT. 
Int32 
以 字 节 计 的 消息 内 容 长 度 ， 包 括 长 度 本 身 。 
Byte1 
' s 关闭 一 个 准备 的 语句 ; 或 者 ' P 关闭 一 个 人 口 。 
String 
一 个 要 关闭 的 预备 语句 或 者 入口 的 名 字 ( 一 个 空 字符 串 选择 未 命名 的 预备 语句 或 者 人 口 )。 
CloseComplete (B) 
Byte1('3') 
标识 消息 是 一 个 Close 完毕 指示 器 。 
Int32(4) 
以 字 节 记 的 消息 内 容 的 长 度 ， 包 插 长 度 本 身 。 


CommandComplete (B) 


Byte1('C') 
标识 此 消息 是 一 个 命令 结束 响应 。 
Int32 
以 字 节 记 的 消息 内 容 的 长 度 ， 包 括 长 度 本 身 。 
String 
命令 标记 。 它 通常 是 一 个 单字 ， 标 识 那 个 命令 完成 。 
公公 


对 于 INSERT 命令 ， 标 记 是 INSERT _oid  _rows”， 这 里 的 rows, 是 插入 的 行 数 。 
oid 在 _rows 为 1 并 且 目 标 表 有 OID 的 时 候 是 插入 行 的 对 象 ID ; 否则 oid 就 是 0。 





对 于 DELETE QG, HiL DELETE _rows_, HN _rows_ 是 删除 的 行 数 。 
对 于 UPDATE AD, HLE UPDATE _rows, , REKI rows, 是 更 新 的 行 数 。 
对 于 SELECT 或 CREATE TABLE AS 命令， 标记 是 SELECT _rows_, 这 里 的 _rows_ 是 检 出 的 行 
数 。 

对 于 move MD, iLE Move ”_rows” ， 这 里 的 rows, 是 游标 位 置 改 变 的 行 数 。 

对 于 FETCH 命令 ， 标 记 是 FETCH _rows” ， 这 里 的 _rows 是 从 游标 中 检索 出 来 的 行 数 。 


对 于 copy 命 倒 ， 标 记 是 COPY _rows” ， 这 里 的 _rows, 是 拷贝 的 行 数 。 (注意 : 这 个 行 数 
只 出 现在 PostgreSQL 8.2 及 以 后 的 版 本 中 ) 。 


CopyData (F & B) 
Byte1('d') 
标识 这 条 消息 是 一 个 COPY 数据 。 
Int32 
以 字 节 记 的 消息 内 容 的 长 度 ， 包 括 长 度 本 身 。 
Byte _n_ 


copy 数据 流 的 一 部 分 的 数据 。 从 后 端 发 出 的 消息 总 是 对 应 一 个 数据 行 ， 但 是 前 端 发 出 的 消 
息 可 以 任意 分 割 数据 流 。 


CopyDone (F & B) 
Byte1('c') 
标识 这 条 消息 是 一 个 COPY 结束 指示 器 。 


Int32(4) 


字 节 计 的 消息 内 容 长 度 ， 包 插 长 度 本 身 。 
CopyFail (F) 
Byte1(f) 
标识 这 条 消息 是 一 个 copy 失败 指示 器 。 
Int32 

以 字 节 记 的 消息 内 容 的 长 度 ， 包 括 长 度 本 身 。 
String 
一 个 报告 失败 原因 的 错误 消息 。 
CopylnResponse (B) 
Byte1('G') 


标识 这 条 消息 是 一 条 StartCopyln( 开 始 拷贝 输入 ) 响 应 消息 。 前 端 现在 必须 发 送 一 条 拷贝 人 数 
据 ( 如 果 还 没准 备 好 做 这 些 事情 ， 那 么 发 送 一 条 CopyFail 消息 )。 


Int32 
以 字 节 记 的 消息 内 容 的 长 度 ， 包 括 长 度 本 身 。 
Int8 


0 表示 全 部 的 copy 格式 都 是 文本 的 (数据 行 由 换行 符 分 隔 ， 字 段 由 分 隔 字符 分 隔 等 等 )。 1% 
示 都 是 二 进 制 的 (类 似 DataRow 格式 )。 参 闵 COPY 获 取 更 多 信息 。 


Int16 
数据 中 要 拷贝 的 字段 数 (由 下 面 的 n 解释 )。 
Int16[ N_ ] 


每 个 字段 将 要 使 用 的 格式 代码 ， 目 前 每 个 都 必须 是 0( 文 本 ) 或 者 1( 二 进 制 )。 如 果 全 部 拷贝 格式 
都 是 文本 的 ， 那 么 所 有 的 都 必须 是 0。 


CopyOutResponse (B) 
Byte1('H') 


标识 这 条 消息 是 一 条 StartCopyOut( 开 始 拷 贝 输出 ) 响 应 消息 。 这 条 消息 后 面 将 跟着 一 条 拷贝 
出 数据 消 息 。 


Int32 


以 字 节 记 的 消息 内 容 的 长 度 ， 包 括 它 自己 。 


Int8 


0 表示 全 部 copy BREED EC (ELSE TEA BAT AE, 字段 由 分 隔 字符 分 隔 等 等 )。 1 表示 所 
有 拷贝 格式 都 是 二 进 制 的 (类 似 于 DataRow 格式 )。 参 阅 COPY 获 取 更 多 信息 。 


Int16 
要 拷贝 的 数据 的 字段 的 数目 (在 下 面 的 _N_、 说 明 )。 
Int16[ N_ ] 


每 个 字段 要 使 用 的 格式 代码 。 目 前 每 个 都 必须 是 0( 文 本 ) 或 者 1( 二 进 制 )。 如 果 全 部 的 拷贝 格式 
都 是 文本 ， 那 么 所 有 的 都 必须 是 0。 


CopyBothResponse (B) 
Byte1('W') 
标识 这 条 消息 是 一 条 StartCopyBoth( 开 始 双 向 拷贝 ) 响 应 消息 。 这 个 消息 只 会 被 流 复制 使 用 。 
Int32 
以 字 节 记 的 消息 内 容 的 长 度 ， 包 括 它 自己 。 
Int8 


0 表示 全 部 拷贝 copy 格式 都 是 文本 (数据 行 由 换行 符 分 隔 ， 字 段 由 分 隔 字 符 分 隔 等 等 )。 1% 
示 所 有 拷贝 格式 都 是 二 进 制 的 (类 似 于 DataRow 格式 )。 参 阅 COPY 获 取 更 多 信息 。 


Int16 
数据 中 要 拷贝 的 字段 数 (由 下 面 的 n 解释)。 
Int16[ N_ ] 


每 个 字段 要 使 用 的 格式 代码 。 目 前 每 个 都 必须 是 0( 文 本 ) 或 者 1( 二 进 制 )。 如 果 全 部 的 拷贝 格式 
都 是 文本 ， 那 么 所 有 的 都 必须 是 0。 


DataRow (B) 
Byte1('D') 
标识 这 个 消息 是 一 个 数据 行 。 
Int32 
以 字 节 记 的 消息 内 容 的 长 度 ， 包 括 长 度 自身 。 
Int16 


后 面 跟着 的 字段 值 的 个 数 (可 能 是 需 )。 


然后 ， 每 个 字段 都 会 出 现下 面 的 数据 域 对 : 
Int32 


字段 值 的 长 度 ， 以 字 节 记 ( 这 个 长 度 不 包括 它 自己 )。 可 以 为 0。 一 个 特殊 的 情况 是 ，-1 表示 一 
个 NULL 的 字段 值 。 在 NULL 的 情况 下 就 没有 跟着 数据 字段 。 


Byte _n_ 

一 个 字段 的 数值 ， 以 相关 的 格式 代码 表示 的 格式 展现 。 _n_ 是 上 面 的 长 度 。 
Describe (F) 

Byte1('D') 

标识 消息 是 一 个 Describe T. 

Int32 

以 字 节 记 的 消息 内 容 的 长 度 ， 包 括 字 节 本 身 。 

Byte1 

' s "描述 一 个 预备 语句 ; 或 者 ' P ' 描 述 一 个 入 口 。 

String 


要 描述 的 预备 语句 或 者 入 口 的 名 字 ( 或 者 一 个 空 字符 串 ， 就 会 选取 未 命名 的 预备 语句 或 者 入 
口 )。 


EmptyQueryResponse (B) 

Byte1('l') 

标识 这 条 消息 是 对 一 个 空 查 询 字符 串 的 响应 。 (这 个 消息 替换 了 CommandComplete. ) 
Int32(4) 

以 字 节 记 的 消息 内 容 长 度 ， 包 括 它 自己 。 

ErrorResponse (B) 

Byte1('E') 

标识 消息 是 一 条 错误 

Int32 

以 字 节 记 的 消息 内 容 的 长 度 ， 包 括 长 度 本 身 。 


消息 体 由 一 个 或 多 个 标识 出 来 的 字段 组 成 ， 后 面 跟 着 一 个 字 节 需 作 为 终止 符 。 字 段 可 以 以 任 
何 顺 序 出 现 。 对 于 每 个 字段 都 有 下 面 的 东西 : 


Byte1 


一 个 标识 字段 类 型 的 代码 ; 如 果 为 震 ， 这 就 是 消息 终止 符 并 且 不 会 跟着 有 字符 串 。 目前 定义 
的 字段 类 型 在 Section 48.6 列 出 。 因为 将 来 可 能 增加 更 多 的 字段 类 型 ， 所 以 前 端 应 该 不 声 不 响 
地 忽略 不 认识 类 型 的 字段 。 


String 
字段 值 
Execute (F) 
Byte1('E') 
标识 消息 识 一 个 Execute 命令 。 
Int32 
以 字 节 记 的 消息 内 容 的 长 度 ， 包 括 长 度 自身 。 
String 
要 执行 的 入 口 的 名 字 ( 空 字符 串 选 定 未 命名 的 和 人口 )。 
Int32 
要 返回 的 最 大 行 数 ， 如 果 人 和 人口 包 含 返回 行 的 查询 (否则 忽略 )。 需 表示 "没有 限制 "。 
Flush (F) 
Byte1('H') 
标识 消息 识 一 条 Flush 命令 。 
Int32(4) 
以 字 节 记 的 消息 内 容 的 长 度 ， 包 插 长 度 本 身 。 
FunctionCall (F) 
Byte1('F') 
标识 消息 是 一 个 函数 调用 。 
Int32 
以 字 节 记 的 消息 内 容 的 长 度 ， 包 括 长 度 本 身 。 
Int32 


声明 待 调 用 的 函数 的 对 象 标 识 (OID)。 


Int16 


后 面 跟着 的 参数 格式 代码 的 数目 (用 下 面 的 c 表示 )。 它 可 以 是 0， 表 示 没 有 参数 ， 或 者 是 所 
有 参数 都 使 用 缺 省 格式 (文本 ) ; 或 者 是 1， 这 种 情况 下 声明 的 格式 代码 应 用 于 所 有 参数 ; 或 者 
它 可 以 等 于 参数 的 实际 个 数 。 


Int16[ _c_ ] 

参数 格式 代码 。 目 前 每 个 必须 是 0( 文 本 ) 或 者 1( 二 进 制 )。 
Int16 

声明 提供 给 函数 的 参数 个 数 

然后 ， 每 个 参数 都 出 现下 面 字 段 对 : 

Int32 


以 字 节 记 的 参数 值 的 长 度 ( 不 包括 长 度 自己 )。 可 以 为 震 。 一 个 特殊 的 例子 是 ，-1 表示 一 个 
NULL 参数 值 。 如 果 是 NULL ， 则 没有 参数 字 节 跟 在 后 面 。 


Byte _n_ 

参数 的 值 ， 格 式 是 用 相关 的 格式 代码 表示 的 。 _n 是 上 面 的 长 度 。 
在 最 后 一 个 参数 之 后 ， 出 现下 面 的 字段 : 

Int16 

函数 结果 的 格式 代码 。 目 前 必须 是 0( 文 本 ) 或 者 1( 二 进 制 )。 
FunctionCallResponse (B) 

Byte1('V') 

MRR Se NKRA ER 

Int32 

以 字 节 计 的 消息 内 容 长 度 ， 包 括 长 度 本 身 。 

Int32 


以 字 节 记 的 函数 结果 值 的 长 度 (不 包括 长 度 本 身 )。 可 以 为 需 。 一 个 特殊 的 情况 是 -1 表示 
NULL Kft R. WREE NULL 则 后 面 没 有 数值 字 节 跟随 。 


Byte _n_ 
函数 结果 的 值 ， 格 式 是 相关 联 的 格式 代码 标识 的 。 _n ”是 上 面 的 长 度 。 


NoData (B) 


Byte1('n') 
标识 这 条 消息 是 一 个 无 数据 指示 器 
Int32(4) 
以 字 节 计 的 消息 内 容 长 度 ， 包 括 长 度 本 身 。 
NoticeResponse (B) 
Byte1('N’) 
标识 这 条 消息 是 一 个 通知 
Int32 
以 字 节 计 的 消息 内 容 长 度 ， 包 括 长 度 本 身 。 


消息 体 由 一 个 或 多 个 标识 字段 组 成 ， 后 面 跟着 字 节 需 作 为 中 止 符 。 字 段 可 以 以 任何 顺序 出 
现 。 对 于 每 个 字段 ， 都 有 下 面 的 东西 : 


Byte1 


一 个 标识 字段 类 型 的 代码 ; 如 果 为 需 ， 那 么 它 就 是 消息 终止 符 ， 并 且 后 面 不 会 跟着 字符 串 。 
目前 定义 的 字段 类 型 在 Section 48.6 里 列 出 。 因为 将 来 可 能 会 增加 更 多 字段 类 型 ， 所 以 前 端 应 
该 将 不 识 马 | 的 字段 安静 地 忽略 掉 。 


String 
字段 值 
NotificationResponse (B) 
Byte1('A’) 
标识 这 条 消息 是 一 个 通知 响应 
Int32 
以 字 节 计 的 消息 内 容 长 度 ， 包 括 长 度 本 身 。 
Int32 
通知 后 端 进程 的 进程 ID 
String 
触发 通知 的 通道 (channel) 的 名 字 
String 
从 通知 进程 传递 过 来 的 "装载 (payload) "字符 串 。 


ParameterDescription (B) 
Byte1('t') 
标识 消息 是 一 个 参数 描述 
Int32 

以 字 节 计 的 消息 内 容 长 度 ， 包 括 长 度 本 身 。 
Int16 
语句 所 使 用 的 参数 的 个 数 (可 以 为 需 ) 
然后 ， 对 每 个 参数 ， 有 下 面 的 东西 : 
Int32 
声明 参数 数据 类 型 的 对 象 ID 
ParameterStatus (B) 
Byte1('S') 
标识 这 条 消息 是 一 个 运行 时 参数 状态 报告 
Int32 

以 字 节 计 的 消息 内 容 长 度 ， 包 括 长 度 本 身 。 
String 
被 报告 的 运行 时 参数 的 名 字 
String 
参数 的 当前 值 
Parse (F) 
Byte1('P') 
标识 消息 是 一 条 Parse MR- 
Int32 

以 字 节 计 的 消息 内 容 长 度 ， 包 括 长 度 本 身 。 
String 
目的 预备 语句 的 名 字 ( 空 字符 串 表 示 选 取 了 未 命名 的 预备 语句 ) 


String 


要 解析 的 查询 字符 串 
Int16 


声明 的 参数 数据 类 型 的 数目 (可 以 为 需 )。 请 注意 这 个 参数 并 不 意味 着 可 能 在 查询 字符 串 里 出 
现 的 参数 个 数 的 意思 ， 只 是 前 端 希望 预先 声明 的 类 型 的 数目 。 


然后 ， 对 每 个 参数 ， 有 下 面 的 东西 : 
Int32 
声明 参数 数据 类 型 的 对 象 ID 。 在 这 里 放 一 个 雳 等 效 于 不 声明 该 类 型 。 
ParseComplete (B) 
Byte1('1') 
标识 这 条 消息 是 一 个 Parse 完成 指示 器 。 
Int32(4) 
字 节 计 的 消息 内 容 长 度 ， 包 插 长 度 本 身 。 
PasswordMessage (F) 
Byte1('p') 


标识 这 条 消息 是 一 个 口令 响应 。 注意 这 也 被 使 用 在 GSSAPI 和 SSPI 响 应 消息 中 。 (这 实际 上 
是 一 个 设计 错误 ， 既 然 这 里 包含 的 数据 不 是 一 个 NULL 终 止 的 字符 串 ， 而 可 能 是 任意 的 二 进 制 
数据 。) 


Int32 

以 字 节 计 的 消息 内 容 长 度 ， 包 括 长 度 本 身 。 
String 

口 邻 (必要 的 情况 下 ， 是 加 密 后 的 )。 
PortalSuspended (B) 

Byte1('s') 


标识 这 条 消息 是 一 个 入 口 挂 起 指示 器 。 请 注意 这 个 消息 只 出 现在 达到 一 条 Execute 消息 的 行 
计数 限制 的 时 候 。 


Int32(4) 
以 字 节 计 的 消息 内 容 长 度 ， 包 括 长 度 本 身 。 


Query (F) 


Byte1('Q') 

标识 消息 是 一 个 简单 查询 。 

Int32 

以 字 节 计 的 消息 内 容 长 度 ， 包 括 长 度 本 身 。 
String 

查询 字符 串 自 身 

ReadyForQuery (B) 

Byte1('Z’) 

标识 消息 类 型 。 在 后 端 为 新 的 查询 循环 做 好 准备 的 时 候 ， 总 会 发 送 ReadyForQuery 
Int32(5) 

以 字 节 计 的 消息 内 容 长 度 ， 包 括 长 度 本 身 。 
Byte1 


当前 后 端 事务 状态 指示 器 。 可 能 的 值 是 空闲 状况 下 的 ' I '( 不 在 事务 块 里 ) ; 在 事务 块 里 
是 ' T ' ; 或 者 在 一 个 失败 的 事务 块 里 是 ' E "(在 事务 块 结束 之 前 ， 任 何 查询 都 将 被 拒绝 )。 


RowDescription (B) 

Byte1('T') 

标识 消息 是 一 个 行 描述 

Int32 

以 字 节 计 的 消息 内 容 长 度 ， 包 括 长 度 本 身 。 
Int16 

声明 在 一 个 行 里 面 的 字段 数目 (可 以 为 需 ) 
然后 对 于 每 个 字段 ， 有 下 面 的 东西 : 
String 

字段 名 字 

Int32 

如 果 字 段 可 以 标识 为 一 个 特定 表 的 字段 ， 那 么 就 是 表 的 对 象 ID ; HUMES. 


Int16 


如 果 该 字段 可 以 标识 为 一 个 特定 表 的 字段 ， 那 么 就 是 该 表 字 段 的 属性 号 ; 否则 就 是 需 。 
Int32 

字段 数据 类 型 的 对 象 ID 

Int16 

数据 类 型 尺寸 (参阅 pg_type.typlen )。 请 注意 负数 表示 变 宽 类 型 。 

Int32 

类 型 修饰 词 (参阅 pg_attribute.atttypmod )。 修 饰 词 的 含义 是 类 型 相关 的 。 

Int16 


用 于 该 字段 的 格式 码 。 目 前 会 是 0( 文 本 ) 或 者 1( 二 进 制 )。 从 语句 的 Describe 返回 的 
RowDescription 里 ， 格 式 码 还 是 未 知 的 ， 因 此 总 是 需 。 


SSLRequest (F) 
Int32(8) 

以 字 节 计 的 消息 内 容 长 度 ， 包 括 长 度 本 身 。 
Int32(80877103) 


SSL 请 求 码 。 选取 的 数值 在 高 16 位 里 包含 1234 ， 在 低 16 位 里 包含 5679 。 为 了 避免 混淆 ， 
这 个 编码 必须 和 任何 协议 版 本 号 不 同 。 


StartupMessage (F) 
Int32 

以 字 节 计 的 消息 内 容 长 度 ， 包 括 长 度 本 身 。 
Int32(196608) 


协议 版 本 号 。 高 16 位 是 主 版 本 号 (对 这 里 描述 的 协议 而 言 是 3)。 低 16 位 是 次 版 本 号 (对 于 这 
里 描述 的 协议 而 言 是 0)。 


协议 版 本 号 后 面 跟着 一 个 或 多 个 参数 名 和 值 字符 串 的 配对 。 要 求 在 最 后 一 个 名 字 / 数 值 对 后 面 
有 个 字 节 需 。 参 数 可 以 以 任意 顺序 出 现 。 user 是 必须 的 ， 其 它 都 是 可 选 的 。 每 个 参数 都 是 这 
样 声 明 的 : 


String 
参数 名 。 目 前 可 以 识别 的 名 字 是 : 


user 


用 于 连接 的 数据 库 用 户 名 。 必 须 ; 无 缺 省 。 


database 


要 连接 的 数据 库 。 缺 省 是 用 户 名 。 


options 
给 后 端的 命 合 行 参数 。( 这 个 特性 已 经 上 废弃， 更 好 的 方法 是 设置 单独 的 运行 时 参数 。) 


除了 上 面 的 外 ， 在 后 端 和 启动 的 时 候 可 以 设置 的 任何 运行 时 参数 都 可 以 列 出 来 。 这 样 的 设置 将 
在 后 端 馈 动 的 时 候 附加 (在 分 析 了 命 合 行 参数 之 后 ， 如 果 有 的 话 )。 这 些 值 将 成 为 会 话 缺 省 。 


String 

参数 值 

Sync (F) 

Byte1('S') 

表示 该 消息 为 一 条 Sync MT. 
Int32(4) 

以 字 节 计 的 消息 内 容 长 度 ， 包 括 长 度 本 身 。 
Terminate (F) 

Byte1('X’) 

标识 消息 是 一 个 终止 消息 。 
Int32(4) 


以 字 节 计 的 消息 内 容 长 度 ， 包 括 长 度 本 身 。 
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48.6. 错误 和 通知 消息 字段 
本 节 描 述 那些 可 能 出 现在 ErrorResponse 和 NoticeResponse 消息 里 的 字段 。 每 个 字段 类 型 
有 一 个 单字 节 标 识 记 号 。 请 注意 ， 任 意 给 定 的 字段 类 型 在 每 条 消息 里 都 应 该 最 多 出 现 一 次 。 
S 


严重 性 : 该 字段 的 内 容 是 ERROR ，FATAL ，PANIC (在 一 个 错误 消息 里 )，wARNING , NOTICE ， 
DEBUG , INFO, Loc (在 一 条 通知 消息 里 ) 之 一 ， 或 者 是 这 些 的 某 种 本 地 化 翻译 的 字符 串 。 总 是 


会 出 现 。 


C 


代码 : 错误 的 SQLSTATE 代码 (参阅 Appendix A)。 不 能 本 地 化 。 总 是 出 现 。 
消息 : 人 类 可 读 的 错误 消息 的 主体 。 这 些 消 息 应 该 准确 并 且 简 洁 ( 通 常 是 一 行 )。 总 是 出 现 。 
细节 : 一 个 可 选 的 从 属 错误 消息 ， 承 载 有 关 问 题 的 更 多 错误 消息 。 可 以 是 多 行 。 


提示 : 一 个 可 选 的 有 关 如 何 处 理 问 题 的 建议 。 它 和 细节 不 同 的 地 方 是 它 提出 了 建议 (可 能 并 不 


位 置 : 这 个 字段 值 是 一 个 十 进 制 ASCI 整数 ， 表 示 一 个 错误 游标 的 位 置 ， 它 是 一 个 指向 原始 
查询 字符 串 的 索引 。 第 一 个 字符 的 索引 是 1 ， 位 置 是 以 字符 计算 而 非 字 节 计 算 的 。 


p 


内 部 位 置 : 这 个 域 和 P 域 定义 相同 ， 但 是 它 用 于 游标 的 位 置 指向 一 个 内 部 生成 的 命 舍 ， 而 不 
是 用 于 客户 端 提交 的 命令 。 这 个 字段 出 现 的 时 候 ， 总 是 会 出 现 q FER 
q 


内 部 查询 : 失败 的 内 部 生成 的 命令 的 文本 。 比 如 ， 它 可 能 是 一 个 PL/pgSQL 画 数 发 出 的 SQL 
查询 。 


W 


哪里 : 一 个 指示 错误 发 生 的 环境 的 指示 器 。 目 前 ， 这 个 参数 包含 一 个 活路 的 过 程 语 言 函 数 的 
调用 堆栈 的 追溯 和 内 部 生成 的 查询 。 这 个 追溯 每 条 记录 一 行 ， 最 新 的 在 最 上 面 。 


S 


模式 名 : 如 果 错 误 和 一 个 特定 的 数据 库 对 象 相关 ， 则 是 包含 该 对 象 的 模式 的 名 字 。 


t 


RE: 如 果 错 误 和 一 个 特定 的 表 相 关 ， 则 是 这 个 表 的 名 字 。 ( 表 的 模式 名 参考 模式 名 字段 ) 
列 名 :如 果 错 误 和 一 个 特定 的 列 相 关 ， 则 是 这 个 列 的 名 字 。 (特定 的 表 参 考 模 式 名 和 表 名 字 
段 ) 

d 

数据 类 型 名 :如 果 错 误 和 一 个 特定 的 数据 类 型 相关 ， 则 是 这 个 数据 类 型 的 名 字 。 (数据 类 型 的 模 
式 名 参考 模式 名 字段 ) 

约束 名 :如 果 错 误 和 一 个 特定 的 约束 相关 ， 则 是 这 个 约束 的 名 字 。 相关 的 表 或 者 域 参 考 上 面 列 
出 的 字段 。 (因为 这 个 目的 ， 索 引 被 当 作 约束 对 待 ， 即 使 它们 不 是 通过 约束 语法 创建 的 ) 


E 


文件 : 报告 错误 的 源 代码 位 置 的 文件 名 。 


ÍT : 报告 错误 的 源 代码 位 置 的 行 号 。 


HE: 报告 错误 的 源 代码 过 程 名 。 


Note: 模式 名 、 表 名 、 列 名 、 数 据 类 型 名 以 及 约束 名 相关 的 字段 只 是 提供 给 有 限 的 错误 
类 型 。 参考 Appendix A。 前 端 不 应 该 假设 只 要 出 现 了 其 中 一 个 字段 就 一 定 会 有 其 它 字 

段 。 核心 的 错误 源 遵守 上 面 提 到 的 相互 关系 ， 但 是 用 户 自 定 义 函 数 可 能 以 不 同 的 方式 使 
用 这 些 字段 。 同样 ， 客 户 端 不 应 该 假设 这 些 字 段 指 示 了 在 当前 数据 库 中 同时 存在 的 对 

象 。 


客户 端 负责 对 显示 信息 进行 格式 化 输出 以 符合 需要 ; 特别 是 它 应 该 根据 需要 断 开 长 的 行 。 在 
苦 误 消息 字段 里 出 现 的 换行 符 应 该 当 作 一 个 分 段 的 符号 ， 而 不 是 换行 。 





48.7. 自 协 议 2.0 以 来 的 变化 的 概述 


本 节 提 供 一 个 快速 的 变化 检查 列表 ， 以 便于 那些 试图 将 现 有 的 客户 端 库 更 新 到 3.0 协议 的 开 
发 人 员 。 


初始 化 的 启动 包 用 了 一 个 灵活 的 字符 串 列 表格 式 取 代 了 固定 的 格式 。 请 注意 ， 运 行 时 参数 的 
会 话 缺 省 值 现在 可 以 直接 在 启动 包 中 声明 。 (实际 上 ， 你 可 以 在 使 用 options 字段 之 前 干 这 件 
事情 ， 但 是 因为 options 的 宽度 限制 以 及 缺乏 引用 值 中 的 空白 的 方法 ， 这 并 不 是 很 安全 的 技 
巧 。) 


现在 所 有 的 消息 在 消息 类 型 字 节 后 面 都 有 一 个 长 度 计数 (除了 启动 包 之 外 ， 它 没有 类 型 字 节 )。 
同时 还 要 注意 现在 PasswordMessage 有 一 个 类 型 字 节 。 


ErrorResponse 和 NoticeResponse(' £ ' 和 ' n '") 消 息 现在 包含 多 个 字段 ， 从 这 些 字段 里 客户 端 
代码 可 以 组 合 出 自己 所 希望 的 详细 程度 的 错误 消息 。 请 注意 独立 的 字段 通常 不 是 用 换行 符 终 
止 的 ， 虽 然 在 者 协议 里 发 送 的 单个 字符 串 总 是 会 用 换行 符 终 止 。 


The ReadyForQuery(' z ') 消 息 包括 一 个 事务 状态 指示 符 。 


BinaryRow 和 DataRow 消息 类 型 之 间 的 区 别 不 再 存在 了 ; 单个 DataRow 消息 类 型 用 于 返回 
所 有 格式 的 数据 。 请 注意 DataRow 的 布局 已 经 改变 成 比较 容易 分 析 了 。 同 样 ， 二 进 制 数值 
的 表现 形式 已 经 改变 了 : 它 不 再 是 直接 和 服务 器 的 内 部 表现 形式 绑 定 。 


有 了 一 种 新 的 "扩展 查询 "的 子 协议 ， 它 增加 了 前 端 消 息 类 型 Parse, Bind, Execute, Describe, 
Close, Flush, Sync ， 以 及 后 端 消 息 类 型 ParseComplete, BindComplete, PortalSuspended, 
ParameterDescription, NoData, CloseComplete 。 现 有 的 客户 端 不 用 关心 这 个 子 协议 ， 但 是 
利用 这 个 子 协议 将 可 能 改进 性 能 或 者 功能 。 


copy 数据 现在 封装 到 了 CopyData 和 CopyDone 消息 里 。 现在 有 种 很 好 的 方法 从 正在 进行 
的 copy 动作 中 恢复 错误 。 最 后 一 行 的 特殊 的 "\ "不 再 必须 了 ， 并 且 在 copy our 的 过 程 中 
不 再 发 送 。 (在 copy IN 的 时 候 它 仍然 被 认为 是 一 个 终止 符 ， 但 是 它 的 使 用 已 经 废弃 了 并 且 
最 终 闻 被 删除 。) 现在 支持 二 进 制 copy 。CopylnResponse 和 CopyOutResponse 消息 包括 
指示 字段 数目 和 每 个 字段 格式 的 信息 域 。 


FunctionCall 和 FunctionCallResponse 消息 的 布局 变化 了 。 FunctionCall 现在 支持 给 画 数 传 
递 NULL 参数 。 它 同 样 可 以 处 理 以 文本 或 者 二 进 制 格 式 传递 参数 和 检索 结果 。 不 用 再 认为 
FunctionCall 有 潜在 的 安全 性 漏洞 ， 因 为 它 并 不 提供 对 内 部 服务 器 数据 表现 形式 的 直接 访问 。 


后 端 在 启动 的 时 候 为 它 认为 客户 端 库 感 兴趣 的 所 有 参数 发 送 ParameterStatus(' s ) 消 息 。 随 
后 ， 如 果 这 些 参数 的 活路 值 发 生变 化 ， 那 么 发 送 一 条 ParameterStatus 消息 。 
RowDescription(' T ') 消 息 为 所 描述 的 行 的 每 个 字段 装载 新 表 的 OD 和 字段 号 数据 域 。 它 同样 
还 为 每 个 字段 显示 了 格式 代码 。 


后 端 不 再 生成 CursorResponse(' p ') 消 息 。 


NotificationResponse(' A ) 消 息 有 一 个 额外 的 字符 串 域 ， 它 可 以 携带 来 自 NoTIFY 事件 发 送 者 
的 "装载 (payload) "数据 。 


EmptyQueryResponse(' 1 ) 以 前 包含 一 个 空 字 符 串 参数 ; 这 个 已 经 被 删除 了 。 
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o 49.3.16. 本 地 化 


49.1. 格式 


代码 格式 使 用 每 个 制 表 符 4 列 的 空白 ， 目 前 是 保留 制 表 符 状态 (也 就 是 说 制 表 符 不 被 展开 为 空 
白 )。 每 个 逻辑 缩 进 层 次 都 是 更 多 的 一 个 制 表 符 。 


布局 规则 ( 花 括 弧 定位 等 ) 遵 循 BSD 传统 。 特 别 的 ， if 、 while. switch 等 的 控制 块 的 大 
括号 从 它们 自己 的 行 开始 。 


限制 行 的 长 度 ， 这 样 代码 在 80 字 段 的 窗口 内 可 读 。 (这 并 不 意味 着 你 不 能 超过 80 个 字段 。 例 
如 ， 在 任意 地 方 分 解 一 个 长 的 错误 消息 字符 串 ， 只 是 为 了 保持 代码 在 80 个 字段 内 ， 可 能 不 是 
为 了 可 读 性 。) 


不 要 使 用 C++ 风 格 的 注释 ( // 注释 )。 严 格 的 ANSI C 编 译 器 不 接受 它们 。 相同 的 原因 ， 不 要 
使 用 C++ 扩展 ， 比 如 在 块 中 声明 新 的 变量 。 


多 行 注 释 块 的 首选 风格 是 


* comment text begins here 
* and continues here 
2 


Wits, TAJA RENEA kpgindenigReare, 但 是 它 将 回流 注释 块 缩 进 ， 就 像 
它们 是 纯 文本 。 如 果 你 想 要 在 缩 进 块 中 保留 换行 ， 像 这 样 添 加 破 折 号 : 


* comment text begins here 
* and continues here 
* 


虽然 提交 的 补丁 并 不 需要 完全 遵循 这 些 格式 化 规则 ， 最 好 还 是 这 人 么 做 。 你 的 代码 将 会 在 下 一 
个 版 本 之 前 被 pgindent 人 处 理 ， 虽然 这 样 做 不 会 让 它 看 起 来 比 其 它 的 格式 化 习惯 更 好 看 。 一 个 
补丁 的 好 的 经 验 法 则 是 "让 新 的 代码 看 起 来 像 是 被 已 有 的 代码 包围 "。 


src/tools 目录 包含 了 适用 于 emacs 的 示范 配置 文件 ，xemacs 或 vim 用 户 也 必须 确保 其 格式 
代码 也 符合 上 述 规范 。 


文本 浏览 工具 more 和 less 可 以 用 下 面 命令 调用 : 


more -X4 
less -x4 


这 样 就 可 以 让 他 们 正确 显示 制 表 符 。 


49.2. 报告 服务 器 里 的 错误 


在 服务 器 代码 里 生成 的 错误 、 警 告 以 及 日 志 信息 应 该 用 ereport 或 者 它 的 兄弟 elog 创建 。 
这 个 函数 的 使 用 已 经 复 末 得 需要 做 些 解 释 了 。 


每 条 消息 都 有 两 个 必须 的 要 素 : 一 个 严重 级 别 (范围 从 DEBUG 到 panic ) 和 一 个 主要 消息 文 
本 。 除 此 之 外 还 有 可 选 的 元 素 ， 最 常见 的 就 是 一 个 遵循 SQL 标准 的 SQLSTATE 习惯 的 错误 
标识 码 。 ereport RARE- CAKA, 它 的 存在 主要 是 为 了 便于 让 消息 生成 看 起 来 像 C 代 
7 BAER. ereport 直接 接受 的 唯一 参数 是 严重 级 别 。 主 消息 文本 和 任何 附加 消息 元 
素 都 是 通过 在 ereport 调用 里 调用 辅助 本 数 (比如 errmsg ) 生 成 的 。 


典型 的 调用 ereport 的 方式 看 起 来 可 能 像 下 面 这 术 


ereport(ERROR, 
(errcode(ERRCODE_DIVISION_BY_ZERO), 
errmsg("division by zero"))); 


这 样 就 声明 了 错误 严重 级 别 ERROR (一 个 普通 错误 )。 errcode 调用 指定 一 个 

在 src/include/utils/errcodes.h 里 面 使 用 宏 定 义 的 SQLSTATE 错 误 代 码 。 errmsg 调用 提供 
主要 的 消息 文本 。 请 注意 包围 在 辅助 画 数 调用 周围 的 额外 的 圆 括 弧 一 这 么 做 虽然 烦人 ， 但 是 
语法 上 是 必须 的 。 


然后 是 一 个 更 复杂 的 例子 : 


ereport(ERROR, 
(errcode(ERRCODE_ AMBIGUOUS_FUNCTION), 
errmsg("function %s is not unique", 
func_signature_string(funcname, nargs, 
NIL, actual_arg_types)), 
errhint("Unable to choose a best candidate function. 
"You might need to add explicit typecasts."))); 


这 个 例子 演示 了 使 用 格式 化 代码 把 运行 时 数值 族人 一 个 消息 文本 的 用 法 。 同样 ， 还 提供 了 一 
个 可 选 的 "暗示 "信息 。 


ereport 可 用 的 附属 过 程 有 : 


e errcode(sqlerrcode) 为 该 条 件 声明 SQLSTATE 错误 标识 符 代 码 。 如 果 没 有 调用 这 个 过 
程 ， 并 且 错 误 严 重 级 别 是 ERROR 或 更 高 ， 那么 错误 标识 符 缺 省 
是 ERRCODE_INTERNAL_ERROR ， 如 果 错 误 严 重 级 别 是 WARNING 则 为 ERRCODE_WARNING ， 否 
则 (用 于 notice 或 者 更 低级 别 ) 为 ERRCODE_SUCCESSFUL_COMPLETION 。 虽然 这 些 缺 省 都 很 方 
便 ， 但 是 最 好 还 是 在 省 略 errcode() 调用 之 前 三 思 。 


errmsg(const char *msg, ...) 声明 主 错 误 消 息 文 本 ， 以 及 可 能 的 插入 其 中 的 运行 时 数 
值 。 插 入 是 使 用 sprintf 风格 的 格式 代码 插入 的 。 除 了 sprintf 接受 的 标准 格式 代码 ， 
还 接受 xm 用 于 插入 strerror 为 当前 errno 值 返回 的 错误 信息 。 [1] wm 并 不 要 求 

在 errmsg 的 参数 列表 里 有 任何 对 应 的 项 目 。 请 注意 这 个 消息 字符 串 在 格式 代码 得 到 处理 
之 前 将 不 会 通过 gettext 运行 获取 合适 的 本 地 化 。 


errmsg_internal(const char *msg, ...) 和 errmsg 一 样 ， 只 是 消息 字符 串 将 不 会 包含 在 
国际 化 消息 字典 里 。 这 个 函数 应 该 用 于 "不 可 能 发 生 " 的 情况 ， 也 就 是 不 值得 展开 进行 翻 
译 的 场合 。 


errmsg_plural(const char *fmt_singular, const char *fmt_plural, unsigned long n, ...) 
RMR errmsg, 但 是 支持 消息 的 各 种 复数 形式 。 _fmt_singular ”是 英语 单数 形式 ， 
_fmt_plural 是 英语 复数 形式 ， _n ”是 决定 使 用 哪个 复数 形式 的 整数 值 ， 剩 余 的 参数 根 
据 选择 的 格式 字符 串 进行 格式 化 。 更 多 信息 请 查看 Section 50.2.2。 


errdetail(const char *msg, ...) 提供 一 个 可 选 的 "详细 "信息 ; 在 存在 额外 的 信息 ， 并 且 
很 适合 放 在 主 消息 里 面 的 时 候 使 用 这 个 函数 。 消息 字符 串 人 处 理 的 方法 和 errmsg 完全 一 
样 。 


errdetail_internal(const char *msg, ...) 和 errdetail 一 样 ， 只 是 消息 字符 串 将 不 会 
包含 在 国际 化 消息 字典 里 。 这 个 男 数 应 该 用 于 不 值得 展开 进行 翻译 的 详细 消息 ， 比如 ， 
因为 它们 太 技 术 了 以 至 于 对 大 多 数 用 户 来 说 无 用 。 


errdetail_plural(const char *fmt_singular, const char *fmt_plural, unsigned long n, .. 


类 似 于 errdetail, 但 是 支持 消息 的 各 种 复数 形式 。 更 多 信息 请 查阅 Section 50.2.2, 


errdetail log(const char *msg, ...) 和 errdetail 一 样 ， 除了 这 个 字符 串 只 到 服务 器 
日 志 ， 从 不 到 客户 端 。 如 果 errdetail (或 它 的 以 上 相同 的 其 中 之 一 ) 

和 errdetail_log 都 使 用 了 ， 那 么 一 个 字符 串 到 客户 端 ， 另 一 个 到 服务 器 日 志 。 这 对 于 
过 于 安全 敏感 或 太 大 而 不 能 包含 进发 送 到 客户 端的 报告 中 的 错误 细节 来 说 是 有 用 的 。 


errhint(const char *msg, ...) 提供 一 个 可 选 的 " 章 示 "消息 } 3X PHA FERATE h 
问题 的 建议 ， 而 不 是 提供 错误 的 事实 。 消息 字符 串 义理 的 方式 和 errmsg 一 样 。 


errcontext(const char *msg, ...) 通常 不 会 直接 从 ereport 消息 点 里 直接 调用 ; 而 是 用 
在 error_context_stack 回调 函数 里 提供 有 关 错 误 发 生 的 环境 的 信息 ， 比 如， 当前 的 位 置 
是 在 一 个 PLEMESS, 消息 字符 串 的 处 理 和 errmsg 完全 一 样 。 和 其 它 辅 助 画 数 不 
fal, 3X SEN BUTE— OR ereport 调用 里 可 以 调用 多 次 ; 随后 的 调用 生成 的 字符 串 将 带 着 各 
自 的 换行 符 连接 在 原来 的 字符 串 上 。 


errposition(int cursorpos) 声明 一 个 错误 在 查询 字符 串 里 的 文本 位 置 。 目前 它 只 是 在 汇 
报 查 询 处 理 过 程 中 的 词法 和 语法 分 析 阶 段 检测 到 的 错误 有 用 。 


errtable(Relation rel) 指定 一 个 关系 ， 关系 名 和 模式 名 应 该 作为 辅助 字段 包含 在 错误 
报告 内 。 


© errtablecol(Relation rel, int attnum) 指定 一 个 字段 ， 该 字段 的 名 字 、 表 名 和 模式 名 应 
该 作为 辅助 字段 包含 在 错误 报告 中 。 


© errtableconstraint(Relation rel, const char *conname) 指定 一 个 表 约 束 ， 该 表 约 束 的 
名 字 、 表 名 和 模式 名 应 该 作为 辅助 字段 包含 在 错误 报告 中 。 不 管 它们 是 否 有 一 个 相关 
的 pg constraint 项 ， 索 引 都 应 该 被 认为 是 约束 。 小 心地 传递 底层 堆 关 系 ， 不 只 是 索引 
本 身 ， 作为 rel o 


e errdatatype(Oid datatypeoid) 指定 一 个 数据 类 型 ， 它 的 名 字 和 模式 名 应 该 作为 辅助 字段 
包含 在 错误 报告 中 。 


® errdomainconstraint(0id datatypeOid, const char *conname) 指定 一 个 域 约束 ， 该 域 约束 


的 名 字 、 域 名 和 模式 名 应 该 作为 附属 字段 包含 在 错误 报告 中 。 


@ errcode for_file access() 是 一 个 便利 函数 ， 它 可 以 为 一 个 文件 访 问 类 的 系统 调用 选择 
一 个 合适 的 SQLSTATE 错误 标识 符 。 它 利 用 保存 下 来 的 errno 判断 生成 哪个 错误 代 
码 。 通常 它 应 该 和 主 错误 消息 文本 里 的 ‰ 结合 使 用 。 


@ errcode_for_socket_access() E— MEF ER, 它 可 以 为 一 个 套 接 字 相 关 的 系统 调用 选 
择 一 个 合适 的 SQLSTATE 错误 标识 符 。 


e errhidestmt(bool hide_stmt) 可 以 用 来 在 主 日 志 中 指定 消息 的 statement: 部 分 的 消除 。 
如 果 消 息 文 本 早已 包括 当前 语句 ， 那么 这 通常 是 合适 的 。 


Note: errtable 、 errtablecol 、 errtableconstraint 、 

errdatatype 或 errdomainconstraint 中 最 多 只 有 一 个 加 数 应 该 用 在 一 个 ereport 调用 
中 。 这 些 函 数 的 存在 允许 应 用 提取 与 没有 检测 潜在 本 地 化 错误 消息 文本 的 错误 条 件 相 关 
的 数据 库 对 象 的 名 字 。 这 些 画 数 应 该 用 在 应 用 希望 自动 错误 处 理 的 错误 报告 中 。 自 
PostgreSQL 9.3 起 ， 完全 覆盖 只 是 为 了 SQLSTATE class 23 中 的 错误 而 存在 (违反 完整 
约束 ) ， 但 是 有 可 能 会 在 未 来 扩展 。 


还 有 一 个 老 一 些 的 elog 玉 数 ， 仍 然 在 频繁 使 用 。 一 个 elog 调用 : 


elog(level, "format string", ...); 
完全 等 效 于 : 
ereport(level, (errmsg_internal("format string", ...))); 


请 注意 SQLSTATE 错误 代码 总 是 缺 省 的 ， 并 且 消 息 字符 串 并 没有 翻译 。 因 此 ， elog 应 该 只 
用 于 内 部 错误 以 及 低层 的 调试 日 志 。 任何 普通 用 户 感 兴趣 的 消息 都 应 该 通过 ereport 生成 。 

当然 ， 还 有 大 量 内 部 的 "不 可 能 发 生 "的 错误 检查 使 用 elog ; 因为 这 些 信息 最 好 还 是 表示 得 
简单 些 好 。 


书写 好 的 错误 消息 的 建议 可 以 在 Section 49.3 找 到 。 


Notes 


[1] 也 就 是 说 ， 在 到 达 ereport 调用 的 时 候 当 前 的 数值 ; 在 附属 报告 过 程 里 对 errno 的 修改 将 
会 影响 他 。 但 是 如 果 你 在 errmsg 的 参数 列表 里 明确 地 写 strerror(errno) ， 这 一 点 就 不 能 
保证 了 ， 因 此 ， 请 不 要 这 么 做 。 


49.3. 错误 消息 风格 指导 


这 份 风 格 向 导 的 目的 是 希望 能 把 所 有 PostgreSQL 生成 的 消息 维护 一 个 一 致 的 ， 用 户 友好 的 风 
格 。 


49.3.1. 何去何从 


主 信息 应 该 简短 ， 基 于 事实 ， 并 且 避 免 引 用 类 似 特 定 函 数 名 等 这 样 的 实现 细节 。 "简短 "意味 
着 "在 正常 情况 下 应 该 能 放 在 一 行 里 "。 如 果 需 要 保持 主 信息 的 简短 ， 或 者 如 果 你 觉得 需要 提 
到 失败 的 特定 系统 调用 之 类 的 实现 细节 ， 可 以 使 用 一 个 详细 信息 。 主 信息 和 详细 信息 都 应 该 
是 基于 事实 的 。 使 用 一 个 提示 消息 给 出 一 个 修补 问题 的 提示 ， 特 别 是 在 提出 的 建议 可 能 并 不 
总 是 有 效 的 情况 下 。 


比如 ， 可 以 不 这 么 写 


IpcMemoryCreate: shmget(key=%d, size=%u, 0%0) failed: %m 
(plus a long addendum that is basically a hint) 


而 是 : 
Primary : could not create shared memory segment: %m 
Detail: Failed syscall was shmget(key=%d, size=%u, 0%0 ) ， 
Hint: the addendum 


NR : 保持 主 消息 的 简短 可 以 使 它 的 内 容 有 效 ， 并 且 让 客户 端的 屏幕 空间 布局 可 以 做 出 

蕴 误 信息 保留 一 行 就 足够 的 假设 。 而 详细 信息 和 提示 信息 可 以 转移 到 一 个 元 余 模 式 里 ， 或 
a 个 弹出 的 错误 细节 的 窗口 。 同样 ， 详 细 信 息 和 提示 信息 通常 都 会 在 服务 器 日 志 里 消 
除 ， 以 节约 空间 。 对 实现 细节 的 引用 最 好 避免 ， 因 为 毕竟 用 户 不 知道 细节 。 


49.3.2. 格式 


不 要 在 消息 文本 里 放任 何 有 关 格 式 化 的 特定 的 假设 。 除非 是 客户 端 或 者 服务 器 日 志 为 了 符合 
自己 需要 回 卷 了 长 行 。 在 长 信息 里 ， 新 行 字符 (mn) 可 以 用 于 分 段 建议 。 不 要 用 新 行 结束 一 条 消 
息 。 不 要 使 用 tab 或 者 其 它 格式 化 字符 。 在 错误 环境 下 的 显示 里 ， 系统 会 自动 给 独立 级 别 的 
环境 ， 比 如 ， 画 数 调 用 ， 增 加 新 行 。 


基本 原理 : 信息 不 一 定 非 得 在 终端 类 型 的 显示 器 上 显示 。 在 GUI 显示 或 者 在 浏览 器 里 ， 这 些 
格式 指示 器 最 好 被 忽略 。 


49.3.3. 5/5 
在 需要 的 时 候 ， 英 文 文本 应 该 使 用 双 引号 引起 来 。 其 它 语言 的 文本 应 该 一 致 地 使 用 一 种 引 
号 ， 这 种 用 法 应 该 和 出 版 习惯 以 及 其 它 程序 的 计算 输出 一 致 。 


基本 原理 : 选择 双 引 号 而 不 是 单 引 号 从 某 种 角度 来 说 是 随机 选择 ， 但 是 应 该 是 最 优 的 选择 。 
有 人 建议 过 根据 SQL 传统 ， 在 不 同 对 象 类 型 上 使 用 不 同 的 引号 (也 就 是 说 ， 字符 串 单 引 号 ， 
标识 符 双 引号 )。 但 是 这 是 一 种 语言 内 部 的 技巧 ， 许 多 用 户 甚至 都 不 熟悉 ， 并 且 也 不 能 厌战 到 
其 它 类 型 的 引号 场合 ， 也 不 能 翻译 成 其 它 语言 ， 而 且 也 没 哈 意义 。 


49.3.4. 使 用 引号 
总 是 用 引号 分 隔 文件 名 ， 有 用户 提供 的 标识 符 ， 以 及 其 它 可 能 包含 字 的 变量 。 不 要 用 引号 包含 
那些 不 会 包含 字 的 变量 (比如 ， 操 作 符 )。 


在 后 端 里 有 些 函 数 会 根据 需要 在 他 们 的 输出 上 加 双 引 号 (比如 format_type_be() )。 不 要 在 这 
类 图 数 的 输出 上 加 额外 的 引号 。 


基本 原理 : 对 象 的 名 字 绊 入 到 信息 里 面 之 后 ， 可 能 造成 歧义 。 在 一 个 插入 的 名 字 的 起 始 和 终 
止 的 位 置 保持 一 致 。 但 是 不 要 在 信息 里 混杂 大 量 不 必要 的 或 者 重复 的 引号 。 


49.3.5. 语法 和 标点 


对 于 主 错误 信息 和 详细 /提示 信息 ， 规 则 不 同 : 
主 错误 信息 : 首 字母 不 要 大 写 。 不 要 用 句号 结束 信息 。 绝 对 不 要 用 叹 号 结束 一 条 信息 。 


详细 和 提示 信息 : 使 用 完整 的 句子 ， 并 且 用 句号 终止 每 个 语句 。 句 子 首 字母 大 写 。 如 有 后 面 
有 另外 一 个 句子 ， 那 么 在 句号 后 面 放置 两 个 空格 (对 于 英文 来 说 ; 可 能 不 适合 其 他 语言 ) 。 


着 误 上 下 文字 符 串 : 不 要 大 写 首 字母 ， 不 要 用 名 号 结束 字符 串 。 上 下 文字 符 串 应 该 通常 不 是 
完整 的 句子 。 


基本 原理 : 避免 标点 可 以 让 客户 端 应 用 比较 容易 的 把 信息 做 入 到 各 种 语言 环境 中 。 并 且 ， È 
消息 也 经 常 不 是 完整 的 句子 。 并 且 ， 如 果 信 息 长 得 超过 一 个 句子 ， 那么 就 应 该 把 他 们 分 裂 成 
主 信 息 和 详细 信息 部 分 。 不 过 ， 详细 和 提示 信息 长 得 多 并 且 可 能 需要 包含 多 个 句子 。 为 了 保 
持 一 致 ， 这 些 句 子 应 该 遵循 完整 句子 得 风格 ， 即 使 他 们 只 有 一 个 句子 。 


49.3.6. 大 写字 符 和 与 小 写字 答 比 较 


消息 用 语 使 用 小 写字 符 ， 包 括 主 错 误 信息 的 首 字 母 。 如 果 消 息 中 出 现 SQL 命 信 和 关键 字 ， 用 
Ks. 


基本 原理 : 这 样 很 容易 让 所 有 东西 看 起 来 都 一 样 ， 因 为 有 些 消息 是 完整 的 句子 ， 有 些 不 是 。 


49.3.7. HBR AEA 


使 用 主动 语气 。 如 果 有 主语 ， 那 么 就 使 用 完整 的 句子 ("A 不 能 做 B")。 如 果 主 语 是 程序 自己 ， 
那么 就 使 用 电报 风格 的 语言 ; 不 要 用 "我 "作为 程序 的 主语 。 


基本 原理 : 程序 不 是 人 。 不 要 假装 成 其 他 的 。 


49.3.8. 现代 时 与 过 去 时 的 比较 


如 果 尝 试 某 事 失败 ， 但 可 能 下 次 尝试 的 时 候 成 功 (可 能 是 修补 了 某 些 问题 之 后 )， 那么 使 用 过 
去 时 。 如 果 错 误 肯 定 是 永久 的 ， 那 么 用 现代 时 。 


下 面 的 两 个 形式 的 句子 之 间 有 重要 的 语义 差别 : 


could not open file "%s": %m 


和 : 


cannot open file "%s" 


第 一 个 句子 的 意思 是 打开 某 个 文件 的 企图 失败 。 这 个 信和 
满 "或 者 "文件 不 存在 "之 类 的 。 过 去 时 的 语气 应 该 是 合适 
或 者 有 问题 的 文件 存在 了 。 


第 二 种 形式 表示 打开 指定 文件 的 功能 根本 就 不 在 程序 里 存在 ， 或 者 是 这 么 做 概念 上 是 错误 
的 。 现代 时 语气 是 合适 的 ， 因 为 这 个 条 件 将 无 限期 存在 。 


息 应 该 给 出 一 个 原因 ， 比如 说 " 磁 瘟 
的 ， 因 为 下 次 磁 瘟 可 能 不 再 是 满 的 ， 


基本 原理 : 当然 ， 普 通用 户 将 不 会 仅仅 从 信息 的 时 态 上 得 出 大 量 的 结论 ， 但 是 既然 语言 提供 
给 语法 ， 那 么 就 应 该 正确 使 用 。 


49.3.9. 对 象 类 型 


在 引用 一 个 对 象 的 名 字 的 时 候 ， 说 明 它 是 什么 类 型 的 对 象 。 


基本 原理 : 否则 ， 没 人 知道 "foo.barbaz" 指 的 是 什么 。 


49.3.10. Athol 


方 括 弧 只 用 (1) 在 命令 概要 里 表示 可 选 的 参数 ， 或 者 (2) 表 示 一 个 数组 下 标 。 


基本 原理 : 任何 其 它 的 未 西 都 不 能 对 应 这 两 种 众所周知 的 习惯 用 法 并 且 会 让 人 混淆 。 


49.3.11. BRR 
如 果 一 个 信息 包含 其 它 地 方 生成 的 文本 ， 用 下 面 的 风格 包含 


could not open file %s: %m 


基本 原理 : 很 难 估计 所 有 可 能 放 在 这 里 的 错误 代码 并 且 把 它 放 在 一 个 平滑 的 句子 里 ， 所 以 需 
要 某 种 方式 的 标点 。 也 佛经 建议 把 嵌入 的 文本 放 在 圆 括 弧 里 ， 但 是 如 果 嵌 入 文本 是 信息 的 最 
重要 部 分 ， 那 么 就 不 太 自 然 ， 而 这 种 情况 是 很 经 常 的 。 


49.3.12. 错误 的 原因 


消息 应 该 总 是 说 明 为 什么 发 生 错误 。 比 如 : 


BAD : could not open file %s 
BETTER: could not open file %s (I/O failure) 


如 果 不 知道 原因 ， 那 么 你 最 好 修补 代码 。 


49.3.13. HAZ 


不 要 在 错误 信息 里 包含 报告 过 程 的 名 字 。 需 要 的 时 候 ， 有 别 的 机 制 找 出 这 个 画 数 ， 并 且 ， 对 
于 大 多 数 用 户 ，3 这 个 信息 也 没什么 用 。 如 果 错 误 信 息 在 缺少 函数 名 的 情况 下 没有 什么 意义 ， 
那么 重新 措辞 。 


BAD : pg_atoi: error in "z": cannot parse "z" 
BETTER: invalid input syntax for integer: "z" 


也 避免 提 及 被 调用 的 函数 名 字 ; 应 该 说 代码 试图 做 什么 : 


BAD: open() failed: %m 
BETTER: could not open file %s: %m 


如 果 确 实 必要 ， 在 详细 信息 里 提出 系统 调用 。 在 某 些 场合 下 ， 提供 给 系统 调用 的 具体 数值 是 
适合 放 在 详细 信息 里 的 。 


基本 原理 : 用 户 不 知道 这 些 函 数 都 干 些 只 


49.3.14. 尽量 避免 的 字眼 


Unable/ 不 能 . "Unable/ 不 能 " 几乎 是 被 动 语气 。 最 好 使 用 "cannot/ 无 法 "或 者 "could not". 


Bad/ 坏 的 . 类 似 "bad result/ 坏 结果 "这 样 的 错误 信息 真 的 是 很 难 聪 明 地 解释 。 最 好 写 出 为 什么 
结果 是 "bad/ 坏 的 "， 比 如 ，"invalid format/ 非 法 格式 "。 


lllegal/ 非 法 . "llegal/ 非 法 "表示 违反 了 法 律 ， 剩 下 的 就 是 "invalid/ 无 效 的 "。 但 是 最 好 还 是 说 为 
什么 无 效 。 


Unknown/ 未 知 . 尽量 避免 使 用 "unknown/ 未 知 "。 想 想 "error: unknown response", 如 果 你 不 
知道 响应 是 什么 ， 你 怎么 知道 是 错误 ?"Unrecognized/ 无 法 识别 的 " 通常 是 更 好 的 选择 。 还 有 
最 好 要 包括 被 抱怨 的 数值 。 


BAD : unknown node type 
BETTER: unrecognized node type: 42 


Find/ 找 到 和 Exists/ 存 在 比较 . 如 果 程 序 使 用 一 个 相当 复杂 的 算法 来 定位 一 个 资源 (比如 ， 一 
个 路 径 搜 索 )， 并 且 算 法 失败 了 ， 那 么 说 程序 无 法 "find/ 找 到 "该 资源 是 合理 的 。 但 是 ， 如 果 预 
期 的 资源 位 置 是 已 知 的 但 是 程序 无 法 在 那里 访问 它 ， 那么 说 这 个 资源 不 "exist/ 存 在 "。 这 种 情 
况 下 用 "find/ 找 到 " 听 起 来 语气 比较 弱 并 且 会 混淆 事实 。 


May 和 Can 和 Might 比较 . "May" 上 暗示 权限 (如 ，"You may borrow my rake.") ， 在 文档 或 
短 误 消息 中 很 少 使 用 。"Can" 上 暗示 能 力 (如 ，"| can liftthatlog.") ，"might" 暗 示 可 能 性 
(30, "It might rain today.") 使 用 适当 的 单词 澄清 意义 和 帮助 翻译 。 


缩写 . 避免 缩写 ， 像 "can't" ; 使 用 "cannot" 代 蔡 。 


49.3.15. 正确 地 拼写 


用 单词 的 全 拼 。 上 比如 ， 避 人 免 下 面 这 样 的 缩写 : 
e spec 
e stats 
e parens 
e auth 
e xact 


基本 原理 : 这 样 将 改善 一 致 性 。 


49.3.16. 本 地 化 
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50.1. 寄语 翻译 家 


PostgreSQL 程序 (服务 器 和 客户 端 ) 可 以 用 你 喜爱 的 语言 提示 消息 ， 只 要 那些 消息 被 翻译 过 。 

创建 和 维护 翻译 过 的 消息 集 需 要 那些 熟悉 自己 的 语言 并 且 希 望 为 PostgreSQL 做 一 些 事 情 的 
Ao 实际 上 要 干 这 件 事 你 完全 不 必 是 个 程序 员 。 本 章 讲 的 就 是 如 何 帮 助 PostgreSQL 做 这 件 
事 。 


50.1.1. 要 求 


本 章 是 有 关 软 件 工具 的 ， 不 会 评判 你 的 语言 能 力 。 理 论 上 ， 你 只 需要 一 个 文本 编辑 器 。 但 这 
种 情况 只 存在 于 你 不 想 看 看 自己 翻译 的 消息 的 情况 下 ， 这 种 情况 很 难 发 生 吧 。 在 你 配置 你 的 
源 程序 的 时 候 ， 记 住 要 使 用 --enable-nls 选项 。 这 样 也 会 检查 libintl 库 和 msgfmt 程序 ， 它 
们 是 所 有 最 终 用 户 都 需要 的 东西 。 要 试验 你 的 工作 ， 遵 照 安装 指导 中 相应 的 部 分 就 可 以 了 。 


如 果 你 想 开 始 一 个 新 的 翻译 工作 或 者 想 做 消息 表 合 并 工作 (下 面 描述 )， 那 么 你 就 还 分 别 需要 有 
GNU 兼容 的 xgettext 和 msgmerge 。 稍 后 将 试 着 整理 它 ， 这 样 ， 如 果 你 使 用 的 是 一 个 打包 
的 源码 发 布 ， 那 么 你 就 不 再 需 要 xgettext (从 Git 里 下 源码 还 是 需要 的 )。 现 在 推荐 GNU 
Gettext 0.10.36 或 者 更 高 版 本 。 


你 的 本 地 gettext 实现 应 该 和 它 自身 的 文档 在 一 起 发 布 。 其 中 有 一 些 可 能 和 下 面 的 内 容重 复 ， 
但 如 果 要 知道 额外 的 细节 ， 你 应 该 看 看 它们 。 


50.1.2. 概念 


消息 原文 (英语 ) 和 它们 的 (可 能 ) 翻 译 过 的 等 价 物 都 放 在 消息 表 里 ， 每 个 程序 一 个 (不 过 相关 的 
程序 可 以 共享 一 个 消息 表 ) 以 及 每 种 目标 语言 一 个 。 消息 表 有 两 种 文件 格式 : 第 一 种 是 "PO" 
(可 移植 对 象 ) 文 件 ， 它 是 纯 文 本 文件 ， 带 一 些 翻译 者 编辑 的 特殊 语法 。 第 二 种 是 "MO"( 机 器 对 
象 ) 文 件 ， 它 是 从 相应 的 PO 文件 生成 的 二 进 制 文 件 ， 在 国际 化 了 的 程序 运行 的 时 候 使 用 。 翻 
译 者 并 不 处 理 MO 文件 ; 实际 上 几乎 没 人 义理 它 。 


消息 表 的 文件 扩展 名 分 别 是 .po 或 .mo 就 一 点 也 不 奇怪 了 。 主 文件 名 要 么 是 它 对 应 的 程序 
名 ， 要 么 是 该 文件 适用 的 语言 ， 视 情 况 而 定 。 这 种 做 法 有 点 让 人 混淆 。 上 比如 psql.po (psql 
的 PO 文件 ) 或 者 fr.mo (法 语 的 MO 文件 )。 


PO 文件 的 文件 格式 如 下 所 示 : 


# comment 


msgid "original string" 
msgstr "translated string" 


msgid "more original" 
msgstr "another translated" 
"string can be broken up like this" 


msgid 是 从 程序 源 代码 中 抽取 的 (其 实 不 必 是 从 源码 ， 但 这 是 最 常用 的 方法 )。 msgstr 行 初始 
为 空 ， 由 翻译 者 填充 有 用 的 字符 串 。 该 字符 串 可 以 包含 C 风格 的 逃逸 字符 并 且 可 以 像 演示 的 
那样 跨行 继续 。 下 一 行 必须 从 该 行 的 开头 开始 。 


字符 引入 一 个 注释 。 如 果 # 后面 紧 跟着 空白 ， 那 么 
这 是 翻译 者 维护 的 注释 。 文件 里 也 可 能 有 目 动 注 
H, CNET # 后 面 紧 跟 看 非 实 白 字符 。 这 些 是 
各 种 在 PO 文件 上 操作 的 工具 生成 的 ， 主 要 目的 是 
帮助 翻译 者 。 


#. automatic comment 
#: filename.c:1023 
#, flags, flags 


.风格 的 注释 是 从 使 用 消息 的 源 文件 中 抽取 的 。 程序 
员 可 能 已 经 插入 了 一 些 消息 给 翻译 者 ， 上 比如 那些 预 
期 的 格式 等 。 # 注释 表示 该 消息 在 源 程 序 中 使 用 的 
准确 位 置 。 翻译 者 不 需要 查看 程序 源 文件 ， 不 过 如 
果 他 觉得 翻译 得 不 对 劲 ， 那 么 他 也 可 以 查看 。 #, 注 
释 写 合 从 人 种 程度 上 朱 远 消息 的 标 忘 。 目前 有 两 个 
标志 : 如 果 该 消息 因为 程序 源 文件 的 修改 变 得 过 时 

T, WAE fuzzy (模糊 ) 标 志 。 翻译 者 然后 就 
可 以 核实 这 些 然后 可 能 删 I 际 这 个 fuzzy 标 志 。 TA 青 注 
意 fuzzy 消 息 是 最 终 用 户 不 可 见 的 。 另外 一 个 标志 
c-format , 表示 该 消息 是 一 个 printf 风格 的 
格式 模版 。 这 就 意味 着 翻译 也 应 该 是 一 个 格式 化 字 


符 串 ， 带 有 相同 数目 和 相同 类 型 的 占 位 符 。 有 用 于 
核实 这 些 的 工具 ， 它 们 生成 c 风格 标志 的 键 。 


50.1.3. 创建 和 维护 消息 表 
好 ， 那 怎么 创建 一 "空白 "的 消息 表 呢 ? 首先 ， 进 入 包含 你 想 翻 译 消息 的 程序 所 在 的 目录 。 如 果 
那里 有 一 个 文件 叫 nis.mk ， 那 么 这 个 程序 就 已 经 准 各 好 翻译 了 。 


如 果 目 录 里 已 经 有 一 些 .po 文件 了 ， 那 么 就 是 有 人 已 经 做 了 一 些 翻 译 工 作 了 。 这 些 文件 是 

用 _language_ .po 命名 的 ， 这 里 的 _language_ ISO 639-1 规定 的 两 字母 语言 代码 (小 写 ) 

， 比 如 fr.po 指 的 是 法 语 。 如 果 每 种 语言 需要 多 过 一 种 的 翻译 ， 那 么 这 些 文件 也 可 以 叫做 

_language_ region .po 这 里 的 region 是 [ISO 3166-1 规定 的 两 字母 国家 代码 (大 写 )] (http://www.iso 
pt_BR.po 指 的 是 巴西 葡萄 牙 语 。 如 果 你 找到 了 你 想 要 的 语言 文件 ， 那 么 你 就 可 以 在 那个 文件 
EFE. 


如 果 你 需要 开始 一 个 新 的 翻译 工作 ， 那 么 首先 运行 下 面 的 命令 


gmake init-po 


这 样 将 创建 一 个 文件 _progname_ .pot。 (FA .pot 和 "生产 中 "使 用 的 PO 文件 区 分 开 。 Tht 
表 '"template"。) 把 这 个 文件 拷贝 成 _language_ .po 然后 编辑 它 。 要 让 程序 知道 有 新 语言 可 以 
用 ， 还 要 编辑 文件 nls.mk 以 增加 该 语言 (或 者 语言 和 国家 ) 代 码 到 类 似 下 面 这 样 的 行 : 


AVAIL_LANGUAGES := de fr 


(当然 可 能 还 有 其 它 国家 。 ) 


随 着 下 层 的 程序 或 者 库 的 改变 ， 程 序 员 可 能 修改 或 者 增加 消息 。 这 个 时 候 ， 你 不 必 从 头 再 
来 。 只 需要 运行 下 面 的 命令 


gmake Update-po 


它 将 创建 一 个 新 的 空 消 息 表 文件 (你 开始 时 用 的 pot 文件 ) 并 且 会 把 它 和 现 有 的 PO 文件 合并 起 
来 。 如 果 合 并 算法 不 能 确定 某 条 具体 的 消息 是 否 合 并 正确 ， 那 么 它 就 会 像 上 面 解释 那样 把 它 
定义 为 "fuzzy"( 模 糊 )。 新 的 PO 文件 会 保存 为 带 .po.new 扩展 的 文件 。 


50.1.4. 编辑 PO 文件 


PO 文件 可 以 用 普通 的 文本 编辑 器 编辑 。 翻译 者 应 该 只 修改 那些 在 msgstr 指示 符 后 面 的 双 引 
号 中 间 的 内 容 ， 也 可 以 增加 评注 和 修改 模糊 (fuzzy) 标 志 。 Emacs 有 一 个 用 于 PO 的 模式 ， 我 
觉得 相当 好 用 。 


不 需要 把 PO 文件 完全 填 满 。 如 果 有 些 字符 串 没 有 翻译 (或 者 是 一 个 空白 的 翻译 )， 那 么 软件 会 
自动 使 用 原始 的 字符 串 。 也 就 是 说 提交 一 个 未 完成 的 翻译 包括 在 源码 树 中 并 不 是 一 个 问题 ; 

那样 可 以 留 下 让 其 他 人 继续 你 的 工作 的 空间 。 不 过 ， 鼓 励 你 在 完成 一 次 合并 之 后 首先 消除 模 
糊 的 条 目 。 要 知道 模糊 的 条 目 是 不 会 被 安装 的 ; 它们 只 起 到 表示 可 能 是 正确 翻译 的 引用 的 作 
用 。 


下 面 是 一 些 编辑 翻译 消息 的 时 候 要 记 住 的 事情 : 


。 确保 如 果 原 始 消息 是 以 换行 结尾 的 话 ， 翻 译 后 的 消息 也 如 此 。 类 似 的 情况 适用 于 tab 
等 。 


。 如 果 最 初 的 字符 串 是 printf 格式 的 字符 串 ， 那 么 翻译 串 也 必须 如 此 。 翻译 串 还 要 有 同 
样 的 格式 声明 词 ， 并 且 顺 序 相 同 。 有 时 候 语 言 的 自然 规则 会 让 这 人 么 做 几乎 不 可 能 或 者 及 
其 难看 。 这 时 候 你 可 以 用 下 面 的 格式 : 


msgstr "Die Datei %2$s hat %1$u Zeichen." 


这 样 ， 第 一 个 占 位 符 实际 上 使 用 列表 里 的 第 二 个 参数 。 _digits_$ 应 该 跟 在 % 后 面 并 
且 在 其 它 格式 操作 符 之 前 。 这 个 特性 实际 上 存在 于 printf BAUR. 你 可 能 从 来 没有 
听 说 过 它 ， 因 为 除了 消息 国际 化 以 外 它 没有 什么 用 你 。 


。 如 果 原 始 的 字符 串 包含 语言 错误 ， 那 么 请 报告 它 (或 者 在 程序 源 文 件 中 直接 修补 它 )， 然 后 
按照 正常 翻译 。 正确 的 字符 串 可 能 在 程序 源 文件 更 新 的 时 候 被 合并 进来 。 如 果 最 初 的 字 
符 串 与 事实 不 符 ， 那 么 请 报告 它 (或 者 自己 修补 它 ) 但 是 不 要 翻译 它 。 相反 ， 你 可 以 在 PO 
文件 中 用 注解 给 该 字符 串 做 个 标记 。 


。 维护 风格 和 原始 字符 串 的 语气 。 特 别 是 那些 不 成 句子 的 消息 ( cannot open file %s ) 可 能 
不 应 该 以 大 写字 符 开 头 (如 果 你 的 语言 区 分 大 小 写 的 话 ) 或 者 用 句号 结束 (如 果 你 的 语言 里 
有 符号 标志 )。 阅读 节 Section 49.3 可 能 会 有 所 帮助 。 


。 如 果 你 不 知道 一 条 消息 是 什么 意思 ， 或 者 它 很 含糊 ， 那 么 在 开发 者 邮递 列表 上 询问 。 
为 可 能 说 英语 的 最 终 用 户 也 可 能 不 明白 它 或 者 觉得 它 不 好 理解 ， 所 以 最 好 改善 这 条 消 
息 


INO 


50.2. 寄语 程序 员 


50.2.1. 机 理 


本 节 描 述 如 何在 属于 PostgreSQL 版 本 的 程序 或 者 库 里 面 支持 本 地 语言 。 目前 它 只 适用 于 C 


语言 。 
向 程序 中 增加 NLS 支持 
1. 把 下 面 的 代码 插入 到 程序 的 开头 : 


#ifdef ENABLE_NLS 
#include &lt;locale.hé&gt; 
#endif 


#ifdef ENABLE_NLS 

setlocale(LC_ALL, ""); 
bindtextdomain("_progname_", LOCALEDIR); 
textdomain("_progname_"); 

#endif 


(这 里 的 _progname ”实际 上 可 以 自由 选择 。) 


2. 如 果 发 现 一 条 需要 翻译 的 消息 ， 那 么 就 需要 插入 一 个 对 gettext() 的 调用 。 比 如 


fprintf(stderr, "panic level %d\n", lvl); 


会 改 成 


fprintf(stderr, gettext("panic level %d\n"), lvl); 


(如 果 没 有 配置 NLS ， 那 么 gettext 会 定义 成 空 操作 。) 

文 么 干 会 出 现 一 堆 示 西 。 一 种 常用 的 缩写 是 

#define _(x) gettext(x) 

如 果 程 序 只 通过 一 个 或 者 少数 几 个 画 本 数 做 大 部 分 的 消息 传递 ， 比如 后 端 里 的 ereport() 
» 那么 也 可 以 用 另外 一 个 方法 。 在 这 些 函 数 的 内 部 对 所 有 输入 字符 串 调 用 gettext o 


3. 在 程序 源 代码 所 在 的 目录 里 加 一 个 文件 nls.mk o 这 个 文件 将 被 当做 makefile 读 取 。 在 
这 里 需要 做 下 面 一 些 变 量 的 赋值 : 


CATALOG_NAME 


那些 在 textdomain() 调用 里 提供 的 程序 的 名 字 。 

AVAIL_LANGUAGES 

提供 的 翻译 的 语言 列表 ， 开 始 的 时 候 是 空 的 。 

GETTEXT_FILES 

一 列 包含 可 翻译 字符 串 的 文件 ， 也 就 是 那些 用 gettext 或 者 其 它 相应 手段 标记 了 的 文 
件 。 最 终 ， 这 里 会 包括 几乎 所 有 的 程序 源 文 件 。 如 果 列 表 太 长 ， 你 可 以 把 第 一 个 " 文 
件 "写成 一 个 + 和 第 二 个 词组 成 ， 第 二 个 词 是 一 个 文件 ， 在 这 个 文件 里 每 行 包含 一 个 文 
件 名 。 


GETTEXT_TRIGGERS 


生成 给 翻译 者 使 用 的 消息 表 的 工具 ， 以 便 知道 哪些 本 数 调用 包含 可 翻译 字符 串 。 缺 省 时 
只 知道 gettext() 调用 。 如 果 你 使 用 了 或 其 它 标识 符 ， 那 么 你 需要 把 它们 列 在 这 

里 。 如 果 可 翻译 字符 串 不 是 第 一 个 参数 ， 那 么 该 项 需要 是 这 样 的 形式 : func:2 (用 于 第 
二 给 参数 )。 如 果 画 数 支持 多 个 消息 ， 那 么 该 项 看 起 来 就 像 这 禅 : func:1,2 (识别 单个 和 多 
个 消息 参数 )。 


编译 系统 将 自动 制作 和 安装 消息 表 。 


50.2.2. 消息 书写 指导 

这 里 是 一 些 关 于 如 何 书写 易于 翻译 的 消息 的 指导 : 

。 不 要 在 运行 时 构造 语句 ， 比 如 像 
printf("Files were %s.\n", flag ? "copied" : "removed"); 
语句 里 这 样 的 单词 顺序 会 让 其 它 语 言 很 难 翻译 。 而 且 ， 即 使 你 记得 在 每 个 片断 上 调用 
gettext() ， 这 些 片 断 也 不 一 定 能 很 好 地 独立 翻译 。 最 好 复制 一 些 代 码 ， 好 让 每 条 消息 


可 以 当 作 有 机 的 整体 进行 翻译 。 只 有 数字 ， 文 件 名 和 类 似 的 运行 时 变量 才 应 该 在 运行 时 
插入 消息 文本 。 


出 于 类 似 的 原因 ， 下 面 的 东西 不 能 用 : 


printf("copied %d file%s", n, n!=1 ? "Ss": ""); 


因为 它 假设 了 如 何 形成 复数 形 。 如 果 你 看 到 这 样 的 东西 ， 你 可 以 用 下 面 方法 解决 


if (n==1) 
printf("copied 1 file"); 
else 
printf("copied %d files", n): 


不 过 还 是 有 让 人 失望 的 时 候 ， 有 些 语言 在 某 些 特殊 规则 上 有 超过 两 种 形式 。 通常 最 好 是 
通过 消息 的 设计 避免 这 些 示 西 ， 比 如 你 可 以 这 样 写 : 


printf("number of copied files: %d", n); 


如 果 你 真 的 要 构造 一 条 恰当 的 复数 形 消息 ， 也 是 支持 的 ， 但 形式 上 有 一 点 笨拙 。 比如 当 
通过 ereport() 生成 一 条 概要 或 者 详细 消息 时 ， 你 可 以 这 样 写 : 
errmsg_plural("copied %d file", 

"copied %d files", 

n) 
第 一 个 参数 是 对 应 英文 单数 形 的 格式 字符 串 ， 第 二 个 参数 是 对 应 英文 复数 形 的 格式 字符 
串 ， 第 三 个 参数 是 决定 是 否 是 复数 形 的 一 个 整数 值 。 随后 的 参数 和 通常 一 样 对 应 与 格式 
字符 串 中 的 参数 值 。 〈 通 常 ， 控 制 复数 形 的 值 也 是 格式 字符 串 中 的 其 中 一 个 参数 。) R 
语 中 只 关心 n 是 不 是 1， 但 其 它 语言 中 可 能 有 多 个 复数 形 。 针对 英文 中 作为 一 组 的 2 个 
格式 字符 串 ， 翻 译 者 能 够 为 根据 n 的 运行 值 选 中 的 恰当 的 那个 提供 多 个 替代 字符 串 。 
如 果 你 需要 一 条 不 直接 调用 errmsg 或 errdetail 的 复数 形 消息 ， 必须 使 用 下 层 
的 ngettext 加 数 。 具 体 参 考 gettext 的 文档 。 


如 果 你 想 和 翻译 者 进行 交流 ， 比 如 说 一 条 消息 是 如 何 与 其 它 输出 对 齐 的 ， 那 么 在 该 字符 
串 出 现 之 前 ， 放 上 一 条 以 translator 开头 的 注释 ， 比 如 


/* translator: This message is not what it seems to be. */ 


这 些 注释 都 拷贝 到 消息 表 文件 里 ， 这 样 翻译 者 就 可 以 看 见 它们 了 。 


Chapter 51. 书写 一 个 过 程 语 说 处 理 絮 


调用 男 数 的 时 候 ， 如 果 函 数 的 书写 语言 不 是 目前 的 "版 本 -1" 的 编译 语言 接口 (这 包括 用 户 定义 
的 过 程 语言 写 的 画 数 ， 用 SQL 写 的 函数 ， 以 及 用 版 本 0 的 编译 语言 接口 写 的 玉 数 )， 都 会 通过 一 
个 调用 处 理 器 处 理 具体 的 语言 。 调用 义理 器 有 责任 用 一 种 有 意义 的 方法 执行 这 个 画 数 ， 比 如 
说 解析 所 提供 的 文本 等 等 。 本 章 简介 如 何 书写 一 个 新 的 过 程 语言 调用 处 理 器。 


过 程 语 言 的 调用 处 理 器 是 一 个 "普通 "的 函数 ， 必 须 使 用 一 种 编译 语言 来 写 ， 上 比如 C ， 使 用 版 

本 -1 的 接口 ， 并 且 在 PostgreSQL 里 注册 成 接受 需 个 参数 并 且 返 回 类 型 为 language_handler o 

这 个 特殊 的 伪 类 型 标识 该 图 数 为 一 个 调用 处 理 器 并 且 避 免 它 直 接 在 SQL 命令 中 被 调用 。 关于 
C 语 言 调用 规范 以 及 动态 加 载 的 更 过 细节 请 参考 Section 35.9。 


调用 处 理 器 的 调用 方式 和 其 它 辑 数 一 样 : 它 接受 一 个 指向 一 个 FunctioncallInfopata 

struct 的 指针 ， 这 个 指针 包含 参数 值 和 有 关 被 调用 的 函数 的 信息 ， 并 且 预 期 它 返 回 一 

个 patum 结果 (如 果 它 希望 返回 一 个 SQL 的 空 结果 ， 那 么 可 能 设置 isnull 字段 )。 调用 处 理 
器 和 普通 的 被 调 梢 数 的 区 别 是 FunctionCallinfoData 结构 的 flinfo-&gt;fn_oid 字段 包含 实 
际 要 调用 的 函数 的 OID ， 而 不 是 调用 处 理 器 自身 。 调用 处 理 器 必须 使 用 这 个 字段 判断 要 执行 
哪个 图 数 。 通 常 ， 传 递 进来 的 参数 列表 也 是 按照 目标 萎 数 的 声明 设置 的 ， 而 不 是 给 调用 人 处理 
器 设置 的 。 


MRAR pg_proc 里 抓 取 了 汞 数 入 口 以 及 分 析 被 调 函 数 的 参数 和 返回 类 型 就 是 调用 处 理 器 的 事 
了 。 来 自 CREATE FUNCTION 命令 中 的 AS 子 句 将 会 在 pg_proc 行 的 prosrc 字段 中 找到 。 这 
个 通常 是 过 程 语 言 本 身 的 源 文本 ， 但 也 可 以 是 别 的 未 西 ， 比 如 一 个 指向 某 个 文件 的 路 径 名 ， 

或 者 任何 告诉 调用 处理 器 如 何 详细 处 理 的 东西 。 


通常 ， 每 个 SQL 语句 里 面 可 能 要 调用 同一 个 本 数 多 次 。 调用 义理 器 可 以 利 

用 flinfo-&gt; fn_extra FRETET HbS RA XR AKRA a. 这 个 字段 初始 为 NULL ， 
但 是 可 以 被 调用 处 理 器 设置 为 指向 有 关 被 调 男 数 的 信息 。 在 随后 的 调用 中 ， 如 

果 flinfo-&gt;fn_extra 已 经 为 非 NULL ， 那 么 就 可 以 直接 使 用 它 而 免 于 重新 查找 信息 。 调用 
处 理 器 必须 确保 flinfo-&gt;fn_extra 是 用 于 指向 一 块 至 少 会 生存 到 当前 查询 结束 的 内 存 区 
里 ， 因 为 一 个 FmgrInfo 数据 结构 将 会 保存 那么 长 的 时 间 。 一 个 实现 这 个 要 求 的 方法 是 在 
flinfo-&gt;fn_mcxt 声明 的 内 存 环境 里 分 配 一 块 额外 的 数据 ; 这 样 的 数据 通常 和 FmgrInfo 
自己 有 一 样 的 生命 期 。 但 是 处 理 器 也 可 以 同样 选择 使 用 一 个 更 长 生存 期 的 环境 ， 这 样 它 就 可 
以 跨 查 询 缓 存 图 数 定义 。 


在 过 程 语言 玉 数 以 触发 器 的 形式 调用 的 时 人 息 ， 就 没有 什么 参数 以 通常 的 方式 传递 进来 ， 而 是 
FunctionCallinfoData 的 Context 字段 指向 一 个 TriggerData 结构 ， MARRS BHAA 
用 里 面 的 nu 那样 。 一 个 语言 处 理 器 应 该 为 过 程 语言 图 数 提供 获取 触发 器 信息 的 机 制 |。 


下 面 是 一 个 用 C 写 的 存储 过 程 语言 处 理 器 的 模版 : 


#include "postgres.h" 
#include "executor/spi.h" 
#include "commands/trigger.h" 
#include "fmgr.h" 

#include "access/heapam.h" 
#include "utils/syscache.h" 
#include "catalog/pg_proc.h" 
#include "catalog/pg_type.h" 


#ifdef PG_MODULE_MAGIC 
PG_MODULE_MAGIC; 
#endif 


PG_FUNCTION_INFO_V1(plsample_call_handler); 


Datum 
plsample_call_handler (PG_FUNCTION_ARGS) 
{ 

Datum retval; 


if (CALLED_AS_TRIGGER(fcinfo) ) 


{ 
Vhs 
* 作为 触发 器 过 程 调用 
ey, 
TriggerData *trigdata = (TriggerData *) fcinfo->context; 
retval =... 
} 
else 
{ 
7 * 
* (FAS 
“A 
retval =... 
} 


return retval; 


在 打点 的 地 方 放 上 几 千 行 代码 就 可 以 完成 调用 处 理 器 。 


在 把 处 理 器 画 数 编译 成 一 个 可 加 载 的 模块 (参阅 Section 35.9.6) 之 后 ， 下 面 的 命令 就 可 以 注册 
这 个 例子 过 程 语 言 : 


CREATE FUNCTION plsample_call_handler() RETURNS language_handler 
AS '_filename_' 
LANGUAGE C; 

CREATE LANGUAGE plsample 
HANDLER plsample_call_handler; 


尽管 提供 一 个 调用 义理 器 对 创建 一 个 最 小 的 过 程 语言 已 经 足够 了 ， 但 是 还 有 另外 两 个 可 选 的 
函数 如 果 也 能 提供 的 话 将 会 让 这 个 语言 更 加 容易 使 用 。 它们 是 有 效 性 验证 函数 和 内 联 义 理 
器 。 提供 有 效 性 验证 本 数 将 会 允许 CREATE FUNCTION 时 进行 语言 方面 的 检查 。 提供 内 联 
处 理 器 将 会 允许 该 语言 支持 通过 DO 命 命 执行 的 匿名 代码 块 。 


如 果 过 程 语言 提供 了 有 效 性 验证 画 数 ， 必 须 将 它 声 明 为 带 单 个 oid 类 型 参数 的 函数 。 有 效 性 
验证 范 数 的 返回 结果 会 被 忽略 ， 因 此 习惯 上 将 其 声明 为 返回 void 。 有 效 性 验证 函数 
在 CREATE FUNCTION 命令 执行 的 末尾 被 调用 ， 这 时 已 经 创建 或 者 更 新 了 一 个 使 用 这 个 过 程 语 言 


书写 的 画 数 。 传 入 的 OID 是 这 个 图 数 在 pg_proc 中 对 应 行 的 OID。 有 效 性 验证 函数 必须 以 通 
常 的 方式 获取 这 一 行 并 做 一 些 恰当 的 检查 。 通常 的 检查 包括 : 确认 画 数 的 参数 和 结果 类 型 是 
被 该 语言 支持 的 ， 画 数 体 是 符合 该 语言 语法 的 。 如 果 有 效 性 验证 男 数 发 现 函 数 是 正确 的 ， 只 
需要 返回 就 可 以 了 。 如 果 发 现 了 错误 应 该 通过 ereport() 报告 错误 。 抛 出 一 个 错误 将 强行 回 
滚 事务 并 避免 了 不 正确 的 函数 定义 被 提交 。 


有 效 性 验证 函数 通常 应 该 遵循 check_function_ bodies 参 数 的 设置 。 如 果 被 设置 为 无 效 ， 任 何 
昂贵 的 或 依赖 于 上 下 文 的 检查 应 该 被 跳 过 。 这 个 参数 会 被 pg_dump 关 闭 ， 这 样 就 不 用 担心 东 
数 体 对 其 他 数据 库 中 的 对 象 有 依赖 关系 了 。 (因为 这 个 要 求 ， 调 用 义理 器 不 应 该 假定 有 效 性 
验证 函数 已 经 做 过 了 完整 的 检查 。 有 效 性 验证 范 数 存 在 的 目的 并 不 是 让 调用 义理 器 可 以 省 略 
检查 ， 而 是 为 了 在 CREATE Function 命令 中 包含 明显 的 错误 时 可 以 立即 通知 用 户 ) 精确 的 选择 
要 检查 哪些 东西 是 由 有 效 性 验证 男 数 决 定 的 ， 注 意 当 check_function_bodies BMA, AKL 

的 CREATE FUNCTION 代码 仅 执 行 附加 在 函数 上 ser 子 句 。 因此 ， 当 check_function_bodies 无 
效 时 ， 很 明显 应 该 跳 过 哪些 东西 的 结果 将 被 GUC 参 数 影响 的 检查 ， 以 避免 加 载 dump 时 出 现 错 
误 的 失败 。 


如 果 过 程 语言 提供 了 内 联 处 理 器 ， 必 须 将 它 声明 为 带 单个 interna 类 型 参数 的 函数 。 内 联 处 
理 器 的 返回 结果 会 被 忽略 ， 因 此 习惯 上 将 其 声明 为 返回 void 。 当 一 个 使 用 该 语言 的 po 语句 
执行 时 ， 内 联 处 理 器 将 被 调用 。 实际 传递 的 参数 是 一 个 InlinecodeBlock 结构 的 指针 。 这 个 
结构 包含 了 po 语句 的 参数 信息 ， 尤 其 是 要 执行 的 匿名 代码 块 的 文本 。 内 联 处 理 器 将 执行 这 
个 代码 并 返回 。 

建议 打包 所 有 这 些 画 数 的 声明 以 及 cREATE LANGUAGE 命令 自身 到 一 个 扩展 中 ， 这 样 只 需要 一 个 
简单 的 CREATE EXTENSION 命令 就 可 以 安装 这 个 语言 了 。 关于 书写 扩展 的 方法 ， 请 参考 Section 
23915 


如 果 想 书写 自己 的 调用 人 处理 器 ， 那 么 包含 在 标准 发 布 里 面 的 过 程 语言 是 很 好 的 例子 。 参 考 一 
下 源 代码 树 中 的 src/pl FAX. CREATE LANGUAGE 参 考 页 面 中 也 有 一 些 有 用 的 信息 。 


Chapter 52. 写 一 个 外 数据 包 
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© 52.4. 外 数据 封装 查询 规划 


在 外 表 上 的 所 有 操作 都 是 通过 它 的 外 数据 封装 进行 处理 的 ， 它 由 核心 服务 器 调用 函数 集 组 
成 。 外 数据 封装 负责 从 远程 数据 源 抓 取 数据 ， 并 且 将 它 返回 给 PostgreSQL 执 行 器 。 如 果 支 
持 更 新 外 表 ， 那 么 封装 也 必须 处 理 。 本 章 概述 了 如 何 写 新 的 外 数据 封装 。 


尝试 自己 写 的 时 候 ， 在 标准 发 布 中 的 外 数据 包 是 好 的 参考 。 查看 下 源 代码 树 的 contrib 子 
H. CREATE FOREIGN DATA WRAPPER 参考 页 也 有 一 些 有 用 细节 。 


Note: SQL 标准 指定 写 外 数据 封装 接口 。 然 而 ，PostgreSQL 不 会 实现 API， 因 为 努力 调 
节 它 到 PostgreSQL 将 是 巨大 的 ， 并 且 标 准 API 没 有 获得 广泛 采用 。 


52.1. ABE AWA 


FOWHSBEXM—TRBRR, FARR DAERA. RATDWRDASE—THwiPE 
言 里 比如 C， 使 用 版 本 -1 接口 。 关 于 在 C 语 言 中 调用 约定 和 动态 加 载 的 详细 细节 ， 参 
# Section 35.9。 


JoT8 FRG SH eH, AAMAR, AT URBMAP A 
用 回调 函数 。 写 FDW 的 努力 在 于 实现 这 些 回调 范 数 。 使 用 无 参 的 PostgreSQL 注 册 人 处 理 函 
数 ， 并 且 返 回 特殊 伪 类 型 fdw_handler 。 回调 函数 是 普通 C 本 数 ， 是 不 可 见 的 或 者 在 SQL 级 
别 上 可 随时 调用 的 。 在 Section 52.2 中 描述 回调 本 数 。 


验证 图 数 负 责 验 证 由 create 和 ALTER 命令 为 外 数据 封装 ， 以 及 外 服务 器 ， 用 户 映 射 和 使 用 
封装 的 外 表 给 定 的 选项 ， 验 证 图 数 必须 作为 两 个 参数 来 注册 ， 验 证 包含 该 选项 的 文本 数组 ， 
并 且 该 选项 与 表示 对 象 类 型 的 OID 相 关联 在 系统 目录 OID 形 式 下 该 对 象 被 存储 在 ， 要 

ds ForeignDatawrapperRelationId , ForeignServerRelationId , UserMappingRelationId ,或 
者 ForeignTableRelationId 中 ) 。 如 果 不 提 供 验 证 函数 ， 则 在 对 象 创建 时 间或 者 对 象 交 更 时 
间 不 检查 该 选项 


52.2. 外 数据 封装 回调 程序 


FDW 多 理 画 数 返 回 包含 指向 下 面 描述 的 回调 函数 指针 的 palloc'd FdwRoutine 结构 。 扫描 相关 
函数 是 必须 的 ， 其 余 的 是 可 选 的 。 


在 src/include/foreign/fdwapi.h 中 声明 FdwRoutine 结构 类 型 ， 参阅 额外 详情 。 


52.2.1. 扫描 外 表 的 FDW 程 序 


void 

GetForeignRelSize (PlannerInfo *root, 
RelOptiInfo *baserel, 
Oid foreigntableid); 


获得 评估 外 表 关 系 大 小 。 这 就 是 所 谓 的 开始 扫描 外 表 的 查询 规划 。 root 是 关于 查询 的 规划 
器 的 全 局 信息 ; baserel 是 关于 这 个 表 的 规划 器 信息 ; foreigntableid 是 外 表 的 pg_class 
OID. ( foreigntableid 可 以 从 规划 器 数据 结构 中 获得 ， 但 是 它 明确 被 传递 用 来 节省 力 


气 。) 


在 说 明 限 制 资格 测试 执行 过 滤 之 后 ， 该 加 数 应 该 更 新 baserel-&gt;rows 为 通过 表 打 描 返 回 的 
行 期 望 数 。 baserel-&gt;rows 的 初始 值 仅 仅 是 恒定 缺 省 估计 ， 如 果 可 能 的 话 ， 这 应 该 被 葵 
换 。 如 果 它 可 以 对 平均 结果 行 宽度 计算 出 更 好 的 评估 ， 那 么 该 函数 可 能 也 会 选择 更 

新 baserel-&gt;width o 


参阅 Section 52.4 可 以 获取 额外 信息 。 


void 

GetForeignPaths (PlannerInfo *root, 
RelOptiInfo *baserel, 
Oid foreigntableid); 


创建 外 表 扫 描 的 可 能 访问 路 径 。 这 就 是 所 谓 的 查询 规划 。 它 被 调用 的 参数 


和 GetForeignRelSize 相 同 。 


该 图 数 必须 为 外 表 扫 描 产 生 至 少 1 个 访问 路 径 ( ForeignPath 节点 ) 而 且 必须 调用 add_path 添加 
每 个 这 样 的 路 径 到 baserel-&gt;pathlist 中 。 推荐 使 用 create_foreignscan_path 建 

立 ForeignPath 节点 。 该 图 数 可 以 生成 多 个 访 问 路 径 ， 比如 具有 有 效 pathkeys 表示 预 排序 结 
果 路 径 。 每 个 访问 路 径 必 须 包 含 成 本 估计 ， 并 且 包 含 需要 标识 具体 预期 扫描 方法 的 任何 FDW- 
私有 信息 。 


参阅 Section 52.4 获 取 额 外 信息 。 


ForeignScan * 

GetForeignPlan (PlanneriInfo *root, 
RelOptInfo *baserel, 
Oid foreigntableid, 
ForeignPath *best_path, 
List *tlist, 
List *scan_clauses); 


从 所 选择 的 外 访问 路 径 中 创建 Foreignscan 规划 节点 。 这 从 查询 规划 结尾 被 调用 。 该 参数 
为 GetForeignRelsize ， 加 上 所 选择 的 ForeignPath (通过 GetForeignPaths 预先 生成 ) ， 通 
过 规划 节点 发 出 目标 列表 ， 并 且 限 制 子 句 通过 规划 节点 被 执行 。 


RK BW 2h 6) EFF ARIE] Foreignscan 规划 节点 ; 推荐 使 用 make_foreignscan 建 


立 ForeignScan 节点 。 


一 | 


Ñ 


参阅 Section 52.4 获 取 额 外 信息 。 


void 
BeginForeignScan (ForeignScanState *node, 
int eflags); 


开始 执行 一 个 外 部 扫描 。 这 是 在 执行 器 启动 期 间 调 用 。 它 应 该 执行 扫描 开始 前 需要 的 任何 初 
始 化 。 但 没有 开始 执行 实际 扫描 〈 应 该 执行 第 一 次 调用 IterateForeignscan ) o 
ForeignScanState 节点 已 经 被 创建 ， 但 是 它 的 fdw_state 字段 仍然 是 NULL。 通 

过 Foreignscanstate 节点 扫描 的 表 信 息 (尤其 是 ， 来 自 底层 的 Foreignscan 规划 节点 ， 它 包 
含 任何 通过 GetForeignPlan 提供 的 FDW- 私 有 信息 ) 。 eflags 包含 描述 该 规划 节点 执行 器 的 
操作 模式 的 标志 位 。 


注意 当 (eflags & EXEC_FLAG_EXPLAIN ONLY) 为 真 时 ， 该 回 数 不 应 该 执行 任何 外 部 可 见 行为 ; 
它 应 该 为 ExplainForeignscan 和 EndForeignScan 执行 最 小 需求 使 得 节点 状态 有 效 。 


TupleTableSlot * 
IterateForeignScan (ForeignScanState *node); 


从 外 部 源 读 取 一 行 ， 在 元 组 表 模 中 返回 它 (节点 的 ScanTupleSlot 用 于 这 个 目的 ) o 如 果 没 
有 更 多 行 可 用 ， 那 么 返回 NULL。 元 组 表 模 基础 设施 允许 返回 物理 或 者 虚拟 元 组 。 在 大 多 数 情 
况 下 后 者 选择 从 性 能 角度 更 可 取 。 注意 这 被 称 为 在 调用 期 间 被 重 置 的 短暂 内 存 语 境 。 如 果 你 
需要 较 长 时 间 存 储 ， 或 者 使 用 节点 的 Estate 的 es_query_cxt ， 那么 在 BeginForeignscan 中 
创建 内 存 上 下 文 。 


返回 的 行 必须 匹配 扫描 外 表 的 列 标志 。 如 果 你 选择 优化 掉 不 需要 的 列 ， 那 么 你 应 该 在 那些 列 
位 置 插入 空 值 。 


注意 PostgreSQL 的 执行 器 并 不 在 平 返 回 的 行 是 否 违反 任何 在 外 表 列 定义 的 NoT NULL 约束 一 
但 是 规划 器 关心 ， 如 果 NuLL 值 出 现在 声明 列 中 而 不 包含 它们 ， 那 么 可 能 错误 地 优化 查询 。 
当 用 户 声明 不 应 该 存在 时 ， 如 果 遇 到 nu 值 ， 它 可 能 会 适当 提高 错误 《正如 你 需要 在 数据 


类 型 不 匹配 的 情况 下 执行 ) 。 


void 
ReScanForeignScan (ForeignScanState *node); 


从 开始 重启 打 描 。 注 意 任何 参数 打 描 取决 于 已 改变 的 值 ， 因此 扫描 不 一 定 返回 完全 相同 的 
行 。 


void 
EndForeignScan (ForeignScanState *node); 


结束 扫描 并 且 释 放 资 源 。 释 放 palloc 内 存 往往 不 重要 ， 但 是 比如 打开 文件 并 且 和 链接 远程 服务 器 
应 该 被 清理 干净 。 


52.2.2. 更 新 外 表 FDW 程 序 


如 果 FDW 支 持 可 写 外 表 ， 那么 它 应 该 提供 一 些 或 者 所 有 下 面 的 依赖 于 FDW 的 需要 和 能 力 的 
Bg RX : 


void 

AddForeignUpdateTargets (Query *parsetree, 
RangeTblEntry *target_rte, 
Relation target_relation); 


FEB t Ris FRA ASE ING LAIAT UPDATE 和 DELETE 操作 。 FDW 可 能 需要 额外 信息 ， 比 
如 行 ID 或 者 主键 列 值 ， 为 了 确保 它 可 以 找到 确切 行 更 新 或 者 删除 。 为 了 支持 它 ， 该 画 数 可 以 
添加 额外 隐藏 ， 或 者 "Yunk"， 在 uPDATE 或 者 DELETE 中 从 外 表 中 检索 列表 中 的 目标 列 。 


要 做 至 添加 TargetEntry 项 到 parsetree-&gt;targetList , 包含 读 取 的 额外 值 的 表达 
式 。 每 个 这 样 的 项 必须 被 标记 resjunk = true, 并且 有 一 个 不 同 的 resname 在 执行 期 间 标 
识 它 。 避免 使 用 匹配 ction 或 者 wholerow `_N_ 的 名 称 ， 正 如 核心 系统 可 以 产生 这 些 名 
字 的 垃圾 列 。 


在 改写 过 程 中 调用 该 范 数 ， 而 不 是 规划 器 ， 因 此 该 可 用 信息 不 同 于 可 用 的 规划 程序 。 
当 target_rte 和 target_relation 描述 目标 外 表 时 ， parsetree 是 UPDATE 或 者 DELETE fp ia 


的 解析 树 。 


如 果 AddForeignupdateTargets 指针 被 设置 为 NULL, 那么 没有 额外 目标 表达 式 被 添加 。 (这 
将 不 可 能 实现 DELETE 操作 ， 尽 管 upate 可 能 仍然 是 可 行 的 ， 如 果 FDW 依 赖 于 一 个 标识 行 的 
未 改变 主键 ) 。 


List * 

PlanForeignModify (PlannerInfo *root, 
ModifyTable *plan, 
Index resultRelation, 
int subplan_index); 


执行 任何 额外 规划 操作 需要 插入 ， 更 新 或 者 删除 外 表 。 BM EMF iT BRE 
的 ModifyTable 规划 节点 的 FPDW- 私 有 信息 。3 这 个 私有 信 Ep AW 必须 有 List 形式 ， 并 且 在 执行 阶 


BR Se AS 2D BeginForeignModify o 


root 是 关于 查询 的 规划 器 的 全 局 信息 。 plan 是 Modifytable 规划 节点 ， 除 

了 fdwprivLists 字段 外 它 是 完整 的 。 resultRelation 通过 射程 表 索 引 识别 目标 外 表 。 
subplan_index 识 别 从 需 开 始 计算 的 ModifyTable 规划 节点 是 哪个 目标 ; 如 果 你 想 要 索 
引 plan-&gt;plans 或 者 其 他 plan $ AFE 吉 构 ， 那么 使 用 它 。 


参阅 Section 52.4 获 取 更 多 额外 信息 。 


如 果 planForeignModify 指针 被 设置 为 NULL ， 没有 采取 额外 规划 时 间 操 作 ， 并 
H fdw_private 列表 转交 给 BeginForeignModify #3. 


void 
BeginForeignModify (ModifyTableState *mtstate, 
ResultRelInfo *rinfo, 
List *fdw_private, 
int subplan_index, 
int eflags); 


开始 执行 一 个 外 表 修 改 操 作 。 这 个 程序 在 执行 器 启动 时 调用 。 应 该 在 实际 表 修 改 前 执行 任何 
初始 化 。 随后 ， ExecForeignInsert , ExecForeignUpdate 或 者 ExecForeignDelete 需要 每 个 元 


组 被 插入 ， 更 新 或 者 删除 。 


mtstate 是 被 执行 的 ModifyTable 规划 节点 的 整体 状态 ; 关于 规划 的 全 局 数据 和 执行 状态 通 
过 该 结构 是 可 用 的 。 rinfo 是 描述 目标 外 表 的 ResultRelInfo 结构 。 
( ResultRelInfo 的 ri_Fdwstate 字段 用 于 FDW 存 储 任何 需要 该 操作 的 私有 状态 。) 如 果 任 
何 的 ， 那 么 fdw_private 包含 通过 PlanForeignModify 产生 的 私有 数据 。 subplan_index 识 
别 ModifyTable 规划 节点 是 哪个 目标 。 eflags 包含 描述 这 个 规划 节点 的 执行 器 操作 模式 的 标 
志 位 。 


注意 当 (eflags & EXEC_FLAG_EXPLAIN_ONLY) 为 真 时 ， 该 函数 不 应 该 执行 任何 外 部 可 见 操作 ; 
它 应 该 为 ExplainForeignModify 和 EndForeignModify 执行 最 小 需求 使 得 节点 状态 有 效 。 


如 果 BeginForeignModify 指针 被 设置 为 nu, 那么 在 执行 器 启动 期 间 不 采取 任何 操作 。 


TupleTableSlot * 

ExecForeigninsert (EState *estate, 
ResultReliInfo *rinfo, 
TupleTableSlot *slot, 
TupleTableSlot *planSlot); 


插入 一 个 元 组 到 外 表 。 estate 是 查询 的 全 局 执行 状态 。 rinfo 是 描述 目标 外 表 

的 ResultRelinfo 结构 。 slot 包含 要 插入 的 元 组 ; 它 将 匹配 外 表 rowtype 定 义 。 
planSlot 包含 通过 ModifyTable 规划 节点 的 子 计划 产生 的 元 组 ; 它 不 同 于 可 能 包含 额 
外 "junk" 列 的 slot o 


返回 值 要 么 是 包含 实际 插入 的 数据 的 槽 (这 可 能 与 提供 的 数据 不 同 ， 比 如 作为 触发 器 操作 结 
R) ， 如 果 没 有 行 实际 被 插入 ， 那 么 返回 NULL (再 次 ， 通 常 作 为 触发 器 结果 ) 。 传 入 
的 slot 可 以 重新 用 于 这 个 目的 。 


只 有 INSERT 查询 有 RETURNING 子 句 时 ， 才 使 用 返回 槽 中 的 数据 。 因 此 ，FDW 可 能 选择 优化 
返回 依赖 于 RETURNING 子 句 内 容 的 一 些 或 者 全 部 列 。 然而 ， 必 须 返 回 一 些 插 槽 表示 成 功 ， 或 
者 查询 报告 的 行 数 是 错误 的 。 


如 果 ExecForeignInsert 指针 被 设置 为 NULL, 尝试 插入 外 表 将 带 有 错误 信息 而 失败 。 


TupleTableSlot * 

ExecForeignUpdate (EState *estate, 
ResultRelInfo *rinfo, 
TupleTableSlot *slot, 
TupleTableSlot *planSlot); 


更 新 外 表 上 的 元 组 。 estate 是 查询 的 全 局 执行 状态 。 rinfo 是 描述 目标 外 表 的 
ResultRelinfo 结构 。 slot 包含 元 组 的 新 数据 ; 它 将 匹配 外 表 rowtype 定 义 。 planSlot a 
含 通过 ModifyTable 规划 节点 的 子 计 划 产 生 的 元 组 ; 它 不 同 于 可 能 包含 额外 "junk" 列 

的 slot 。 尤其 是 ， 通 过 AddForeignupdateTargets 请 求 的 任何 垃圾 列 将 从 该 槽 中 提供 。 


返回 值 要 么 是 包含 实际 更 新 的 行 的 槽 (这 可 能 与 提供 的 数据 不 同 ， 比 如 作为 触发 器 操作 结 
果 ) ， 如 果 没 有 行 实际 被 更 新 ， 那 么 返回 NULL (再 次 ， 通 常 作 为 触发 器 结果 ) 。 传 入 
的 slot 可 以 重新 用 于 这 个 目的 。 


只 有 UPDATE 查询 有 RETURNING FAH, 才 使 用 返回 槽 中 的 数据 。 因 此 ，FDW 可 能 选择 优化 
返回 依赖 于 RETURNING 子 句 内 容 的 一 些 或 者 全 部 列 。 然而 ， 必 须 返 回 一 些 插 槽 表示 成 功 ， 或 
者 查询 报告 的 行 数 是 错误 的 。 


如 果 ExecForeignupdate 指针 被 设置 为 wi, 党 试 更 新 外 表 将 带 有 错误 信息 而 失败 。 


TupleTableSlot * 

ExecForeignDelete (EState *estate, 
ResultReliInfo *rinfo, 
TupleTableSlot *slot, 
TupleTableSlot *planSlot); 


删除 外 表 上 的 元 组 。 estate 是 查询 的 全 局 执行 状态 。 rinfo 是 描述 目标 外 表 的 
ResultRelInfo 结构 。 slot 不 包含 任何 有 用 调用 ， 但 是 可 以 用 于 保留 返回 的 元 组 。 
planSlot 包含 通过 ModifyTable 规划 节点 的 子 计 划 产 生 的 元 组 ; 尤其 是 ， 它 将 具有 通 
过 AddForeignUpdatetargets 请 求 的 任何 垃圾 列 。 垃圾 列 必 须 用 于 标识 要 删除 的 元 组 。 


返回 值 要 么 是 包含 实际 被 删除 行 的 槽 ， 如 果 没 有 行 实际 被 删除 ， 那 么 返回 NULL (再 次 ， 通 常 
作为 触发 器 结果 ) 。 传 入 的 slot 可 以 用 于 保留 返回 的 元 组 。 


只 有 DELETE 查询 有 RETURNING FA, 才 使 用 返回 槽 中 的 数据 。 因 此 ，FDW 可 能 选择 优化 
返回 依赖 于 RETURNING 子 句 内 容 的 一 些 或 者 全 部 列 。 然而 ， 必 须 返 回 一 些 插 槽 表示 成 功 ， 或 
者 查询 报告 的 行 数 是 错误 的 。 


如 果 ExecForeignDelete 指针 被 设置 为 NULL, 党 试 删 PRA ZS a A 4 若 误 信息 而 失败 。 


void 
EndForeignModify (EState *estate, 
ResultRelInfo *rinfo); 


结束 表 更 新 并 且 释 放 资 源 。 释 放 palloc 内 存 往往 不 重要 ， 但 是 比如 打开 文件 并 且 链 接 远 程 服务 
器 应 该 被 清理 干净 。 


如 果 EndForeignModify 指针 被 设置 为 NULL ， ABA TE ANF 村 器 关闭 期 间 不 采取 任何 操 作 。 


int 
IsForeignRelUpdatable (Relation rel); 


报告 指定 外 表 支 持 的 更 新 操作 。 返 回 值 应 该 是 规则 事件 数 的 位 掩 码 ， 标 志 着 使 用 cmdtype 枚 
举 通过 外 表 支 持 的 操作 ; 即 (1 &lt;&lt; CMD_UPDATE) = 4 为 UPDATE , 


(1 &1t;&lt; CMD_INSERT) = 8 为 INSERT 并 且 (1 &lt;&lt; CMD_DELETE) = 16 X DELETE o 


如 果 IsForeignRelupdatable 指针 被 设置 为 NULL ， 那 么 FDW 分 别 提供 ExecForeignInsert , 
ExecForeignUpdate 或 者 ExecForeignDelete ， 那 么 外 表 被 认为 是 可 插入 ， 可 更 新 或 者 可 删除 
的 。 如 果 FDW 支 持 一 些 可 更 新 的 和 一 些 不 可 更 新 的 表 ， 那 么 需要 这 个 函数 。 《即使 这 样 ， 它 
允许 在 执行 程序 中 抛 出 错误 而 不 是 在 这 个 函数 中 进行 检查 。 然 而 ， 该 函数 用 于 

在 information_schema 视图 中 显示 可 更 新 。 ) 


52.2.3. EXPLAIN 的 FDW 程 序 


void 
ExplainForeignScan (ForeignScanState *node, 
ExplainState *es); 


为 外 表 扫 描 打 印 额 外 ExPLAIN 输出 。 该 函数 可 以 调用 explainPropertytext FIAAK WARN 
到 ExPLAIN 输出 字段 。 es 中 的 标志 位 可 以 用 于 决定 打印 什么 ， 并 且 检 
查 Foreignscanstate 节点 状态 用 来 在 ExPLAIN ANALYZE 情况 下 提供 运行 时 统计 。 


如 果 ExplainForeignscan 指针 被 设置 为 NULL , ABA 在 expan 期 间 不 打印 额外 信息 。 


void 
ExplainForeignModify (ModifyTableState *mtstate, 
ResultRelInfo *rinfo, 
List *fdw_private, 
int subplan_index, 
struct ExplainState *es); 


为 外 表 更 新 打印 额外 ExPLAIN 输出 。 该 加 数 可 以 调用 explainPropertytext 和 相关 阔 数 添加 
到 ExPLAIN 输出 字段 。 es 中 的 标志 位 可 以 用 于 决定 打印 什么 ， 并 且 检 
查 ModifyTablestate 节点 状态 用 来 在 ExPLAIN analyze 情况 下 提供 运行 时 统计 。 前 四 个 参数 


为 BeginForeignModify 是 相同 的 。 


如 果 ExplainForeignModify 指针 被 设置 为 NuLL ， 那 么 在 ExPLAIN 期 间 不 打印 任何 额外 信息 。 


52.2.4. ANALYZE 的 FDW 程 序 


bool 

AnalyzeForeignTable (Relation relation, 
AcquireSampleRowsFunc *func, 
BlockNumber *totalpages); 


当 在 外 表 上 执行 ANALYZE 时 ， 调 用 该 函数 。 如 果 FDW 可 以 收集 外 表 的 统计 ， 它 应 该 返 
Ba, 并 且 提 供 一 个 指针 给 范 数 ， 该 函数 从 func 中 的 表 中 收集 样本 行 。 以 
及 totalpages 的 页 中 表 的 估计 大 小 。 Bm, WH false o 


如 果 FDW 不 支持 任何 表 的 统计 ， 那 么 AnalyzeForeignTable 指针 可 以 设置 为 NULL o 
如 果 提供 ， 那 么 样本 收集 事 数 必须 有 识别 标志 


int 

AcquireSampleRowsFunc (Relation relation, int elevel, 
HeapTuple *rows, int targrows, 
double *totalrows, 
double *totaldeadrows); 


应 该 从 表 中 收集 达到 targrows 行 的 随机 抽样 调查 ， 并 且 存 储 到 调用 者 提供 的 rows 数组 。 必 
须 返 回收 集 行 的 真实 数 。 此 外 ， 将 表 中 死 的 和 活 行 总 数 估计 存储 到 输出 参数 totalrows 和 
totaldeadrows 中 。 (如 果 FDW 没有 死 行 的 任何 概念 ， 那 么 设置 totaldeadrows HS. ) 


52.3. 外 数据 封装 辅助 函数 


从 核心 服务 器 输出 一 些 辅 助 芳 数 ， 因 此 外 数据 封装 作者 可 以 很 容易 访问 FDW- 相 关 对 象 的 属 
性 ， 比 如 FDW 选 项 。 为 了 使 用 任何 这 些 函 数 ， 你 需要 包含 你 的 源 文件 中 的 头 文 
件 foreign/foreign.h o 该 头 文 件 也 定义 了 这 些 函 数 返 回 的 结构 体 类 型 。 


ForeignDataWrapper * 
GetForeignDataWrapper(Oid fdwid); 


函数 为 给 定 OID 的 外 数据 封装 回 一 个 ForeignDatawrapper 对 象 。 ForeignDatawrapper 对 
yaa FDW 的 属性 (参阅 foreign/foreign.h 获取 更 多 详情 ) 。 


ForeignServer * 
GetForeignServer(Oid serverid); 


WAH AEOIDAIAARA ZsIREI—F Foreignserver 对 象 。 Foreignserver HRES 服务 器 
seal (参阅 foreign/foreign.h 获取 更 多 详情 ) 。 


UserMapping * 
GetUserMapping(Oid userid, Oid serverid); 


EEEN 定 服务 器 上 给 定 角 色 的 用 户 映 射 返回 UserMapping 对 象 。 (如 果 没 有 特定 用 户 映 
那么 它 将 返回 puc 映射 ， 或 者 如 果 什 么 没有 ， 则 抛 出 错误 。) Usermapping IRES 
用 户 映射 属性 (参阅 foreign/foreign.h 获取 详情 ) g 


ForeignTable * 
GetForeignTable(Oid relid); 


函数 为 给 定 OID 外 表 返 回 Foreigntable 对 象 。 ForeignTable 对 象 包含 外 表 属 性 (参阅 
foreign/foreign.h 获取 更 多 详情 )。 


List * 
GetForeignColumnOptions(Oid relid, AttrNumber attnum); 


该 函数 返回 在 列表 DefElem 形式 中 具有 给 定 外 表 OID 和 属性 数 每 列 FDW 选 项 ， 如 果 该 列 没有 
选项 ， 那 么 返回 需 。 
一 些 对 象 类 型 除了 基于 OID 的 那个 有 基于 名 字 的 查找 函数 : 


ForeignDataWrapper * 
GetForeignDataWrapperByName(const char *name, bool missing_ok); 


该 图 数 返 回 具 有 给 定名 称 的 外 数据 封装 的 ForeignDatawrapper 对 象 。 如 果 没 有 找到 封装 ， 如 
果 missing_ok 是 真 的 ， 那 么 返回 NULL， 否 则 抛 出 错误 。 


ForeignServer * 
GetForeignServerByName(const char *name, bool missing_ok); 


该 图 数 为 给 定名 字 的 外 服务 器 返回 Foreignserver 对 象 。 如 果 没 有 找到 服务 器 ， 如 果 
missing_ok 是 真 的 ， 那 么 返回 NULL， 否 则 抛 出 错误 。 


52.4. 外 数据 封装 查询 规划 


FDWIE} EN2X GetForeignRelsize , GetForeignPaths , GetForeignPlan 和 
PlanForeignModify 必须 适合 PostgreSQL 规 划 器 的 工作 。 这 有 一 些 他 们 必须 做 的 说 明 。 


在 root 和 baserel 中 的 信息 可 以 用 于 减少 从 外 表 中 (因此 降低 成 本 ) 读 取 的 信息 量 。 
baserel-&gt;baserestrictinfo 特别 有 趣 ， 正 如 它 包含 应 该 用 于 过 滤 读 取 的 行 的 限制 资格 测试 
( wHERE clauses) (FDW 本 身 不 需要 执行 这 些 测试 ， 正 如 核心 执行 者 反而 可 以 检查 它 

们 。) baserel-&gt;reltargetlist 可 以 用 于 决定 需要 抓 取 哪 个 列 ; 但 是 注意 它 仅 仅 列 出 通过 
Foreignscan 规划 节点 发 出 的 列 ， 不 是 在 质量 评估 中 使 用 的 列 也 不 是 查询 输出 列 。 


各 种 私有 字段 可 用 于 FDW 规 划 函 数 保持 信息 。 一 般 来 说 ， 无 论 在 FDW 私 有 字段 存储 什么 应 该 
是 palloc， 所 以 它 将 在 规划 结束 后 被 回收 。 


baserel-&gt; fdw_private 是 ae) 指针 ， 可 用 于 FDW 规 划 函 数 存储 与 特定 外 表 相 关 的 信息 。 当 
创建 baserel 结 点 时 ， 核 心 规划 器 并 不 接触 它 除 了 初始 化 为 NULL 外 。 
从 GetForeignRelSize 到 GetForeignPaths 和 /或 者 GetForeignPaths 到 GetForeignPlan 传递 信 


息 是 非常 有 用 的 ， 从 而 避免 重复 计算 。 


GetForeignPaths 可 以 通过 在 ForeignPath 节点 的 fdw_ private 字段 存储 私有 信息 标识 不 同 访 
问 路 径 的 含义 。 作为 List 指针 声明 fdw_private ， 但 是 实际 上 可 以 包含 任何 由 于 核心 规划 
器 没有 接触 的 东西 。 然 而 ， 最 好 办 法 是 通过 nodeTostring 可 倾 式 表示 形式 ， 用 于 调试 后 端 可 
用 支持 。 


GetForeignPlan 可 以 检查 所 选 的 ForeignPath 节点 的 fdw_private 字段 ， 并 且 可 以 产生 放 
在 Foreignscan 规划 节点 中 的 fdw_exprs 和 fdw_private 列表 ， 在 执行 时 间 他 们 可 用 。 这 些 
列表 必须 在 copyobject 知道 如 何 拷贝 的 形式 中 被 表示 。 fdw_private 列表 没有 其 他 限制 ， 并 
且 不 能 通过 任何 方式 的 核心 后 端 进行 解释 。 fdw_exprs 列表 如 果 不 是 需 ， 那 么 希望 包含 在 运 
行 时 执行 的 表达 式 树 。 这 些 树 将 通过 规划 器 使 得 它们 完全 可 执行 进行 后 处 理 。 


在 GetForeignPlan 中 ， 往 往 目标 列表 可 以 拷贝 到 规划 节点 中 。 已 通过 的 scan_clauses 列 表 包 
GA baserel-&gt;baserestrictinfo 相同 分 句 ， 但 是 为 了 更 好 的 执行 效率 可 能 重新 排序 。 在 
简单 情况 下 FDW 可 以 从 scan_clauses 列 表 (使 用 extract_actual_clauses ) 中 删 

BR Restrictinfo jm, 并 且 将 所 有 分 句 放 入 规划 节点 的 资格 列表 中 ， 这 意味 着 在 运行 期 间 通 
过 执行 器 将 检查 所 有 分 句 。 更 多 复 杀 的 FDW 可 能 检查 一 些 内 部 分 句 ， 在 这 种 情况 下 那些 分 句 
可 以 从 规划 节点 的 列表 中 删除 ， 以 便 执 行 器 不 会 浪费 复查 它们 的 时 间 。 


作为 一 个 例子 ，FDW 可 能 标识 一 些 来 自 _foreign_variable = _sub_expression_ 的 限制 分 
句 ， 它 决定 了 在 给 定 _sub_expression 的 本 地 评估 值 的 远程 服务 器 上 被 执行 。 

在 GetForeignPaths 期 间 产 生 了 该 分 句 的 实际 标识 ， 因为 它 会 影响 路 径 的 成 本 估算 。 路 径 
的 fdw_private 字段 可 能 包含 一 个 指向 已 标识 分 句 的 RestrictInfo 节点 的 指针 。 然 

后 GetForeignPlan Mscanclauses# 删除 该 分 句 ， 但 是 增加 


` sub_expression 到 fdwexprs 以 确保 它 获得 可 执行 形式 。 它 也 可 能 将 控制 信息 放 到 规划 节点 的 fdw_private 
字段 以 告知 执行 画 数 在 运行 时 间 执 行 什么 。 传 送 到 远程 服务 器 的 查询 可 能 涉及 到 像 WHERE _foreign_variable 
fdw_exprs` 表 达 式 树 评估 中 获得 的 参数 值 。 





FDW 应 该 总 是 构建 至 少 一 个 仅仅 依赖 于 表 的 限制 分 句 的 路 径 ， 在 连接 查询 中 ， 它 也 可 能 选择 
构建 依赖 于 连接 分 句 的 路 径 ， 比如 _foreign_variable = local_variable_ o 该 分 句 没有 
在 baserel-&gt;baserestrictinfo 中 找到 ， 但 是 必须 在 关系 的 连接 列表 中 寻找 。 使 用 分 句 的 
路 径 被 称 为 "参数 化 路 径 "。 它 必须 标识 用 于 使 用 param_info 合适 值 的 已 选择 连接 分 句 的 其 他 
关系 ; 使 用 get_baserel_parampathinfo 计算 该 值 。 在 GetForeignPlan 中 ， 连接 分 句 

的 _local_variable_ 部 分 将 被 添加 到 fdw_exprs 中 ， 然后 运行 时 该 情况 与 普通 限制 分 句 一 样 
运行 。 





当 规划 一 个 UPDATE 或 者 DELETE 的 时 候 ， PlanForeignModify 可 以 查找 外 表 的 RelOptInfo 结 
构 ， 并 且 充 分 使 用 通过 扫描 规划 画 数 预先 创建 的 baserel-&gt;fdw_private 数据 。 然而 ， 

在 INSERT 中 不 扫描 目标 表 ， 所 以 没有 RelOptInfo o 通过 PlanForeignModify 返回 

的 List 与 Foreignscan 规划 节点 的 fdw_private 列表 有 相同 的 限制 ， 即 它 必须 包 

& copyobject 知道 如 何 拷贝 的 结构 。 


UPDATE 或 者 DELETE 反对 外 部 数据 源 支 持 并 发 更 新 ， 推 荐 Foreignscan 操作 锁定 抓 取 的 行 ， 
也 许 通过 SELECT FOR UPDATE 的 等 价 物 。 当 在 SELECT FoR UPDATE/SHARE 引用 外 表 时 ，FDW 可 
能 也 会 在 抓 取 时 选择 锁定 行 。 如 果 没 有 做 ， 就 有 关外 表 来 说 ， 那么 FoR uPDATE 或 
者 FOR SHARE 选项 本 质 上 是 无 操作 的 。 这 种 操作 可 能 会 产生 本 地 表 操 作 上 轻微 的 语义 差异 ， 
行 锁定 通常 尽 可 能 的 延迟 : 远程 行 可 能 获得 锁定 即使 他 们 随后 没有 本 地 应 用 限制 或 者 连接 条 
件 。 然而 ， 匹 配 局 部 语义 确实 需要 每 行 的 领 外 远程 访问 ， 并 且 不 可 能 依赖 于 外 部 数据 源 提供 
的 锁定 语义 内 容 。 
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53.1. 作为 复杂 优化 问题 的 查询 处 理 


在 所 有 关系 型 操作 符 里 ， 最 难以 处 理 和 优化 的 一 个 是 连接 。 一 个 查询 需要 回答 的 可 选 规划 的 
数目 将 随 着 该 查询 包含 的 连接 的 个 数 呈 指数 增长 。 在 访问 关系 分 支 时 的 进一步 优化 措施 是 由 
多 种 多 样 的 连接 方法 (例如 嵌 套 循环 、 索 引 扫 描 、 融 合 连 接 等 ) 来 支持 处 理 独 立 的 连接 和 多 种 
多 样 的 索引 (比如 PostgreSQL 中 的 B-tree, hash, GiST# GIN). 


目前 PostgreSQL 优 化 器 的 实现 在 候选 策略 空间 里 执行 一 个 近似 穷 举 搜索 。 这 个 算法 最 早 是 在 
IBM System R database 数据 库 中 引入 的 ， 它 生成 一 个 近乎 最 优 的 连接 顺序 ， 但 是 如 果 查 询 
中 的 连接 增长 得 很 大 ， 它 可 能 会 消耗 大 量 的 时 间 和 内 存 空 间 。 这 样 就 使 普通 的 PostgreSQL 坦 
询 优化 器 不 适合 那 种 连接 了 大 量 表 的 查询 。 


德国 弗 来 堡 矿业 及 技术 大 学 自动 控制 系 的 成 员 在 试图 把 PostgreSQL 作为 用 于 一 个 电力 网 维护 
中 做 决策 支持 的 知识 库 系 统 的 后 端 时 ， 碰 到 了 上 面 的 问题 。 该 DBMS 需要 为 知识 库 系 统 的 推 
导 机 处 理 很 大 的 连接 查询 。 在 可 能 的 查询 规划 空间 里 进行 检索 的 恶劣 性 能 引起 了 人 们 对 发 展 
新 的 优化 技术 的 需求 。 


在 随后 的 内 容 里 ， 描 述 了 一 个 基因 算法 ， 这 个 算法 用 一 种 对 涉及 大 量 连接 的 查询 很 有 效 的 方 
式 解决 了 连接 顺序 的 问题 。 


53.2. 基因 算法 


基因 算法 (GA) 是 一 种 和 启发 式 的 优化 法 ， 它 是 通过 不 确定 的 随机 搜索 进行 操作 。 优化 问题 的 可 
能 解 的 集合 被 认为 是 个 体 组 成 的 种 群 。 一 个 个 体 对 它 的 环境 的 适应 程度 由 它 的 适应 性 表示 。 

一 个 个 体 在 搜索 空间 里 的 参照 物 用 染色 体 表 示 ( 实 际 上 是 一 套 字 符 串 )。 一 个 基因 是 染色 体 的 
一 个 片段 ， 基 因 是 被 优化 的 单个 参数 的 编码 。 对 一 个 基因 的 典型 的 编码 可 以 是 二 进 制 或 整 

通过 仿真 进化 过 程 的 重组 、 变 异 、 选 择 找到 新 一 代 的 搜索 点 ， 它 们 的 平均 适应 性 要 比 它们 的 
祖先 好 。 


根据 comp.ai.genetic FAQ ， 不 论 怎么 强调 GA 在 解决 一 个 问题 时 不 是 纯 随机 搜索 都 不 过 份 。 
GA 使 用 随机 处 理 ， 但 是 结果 明显 不 是 随机 的 ( 比 随机 更 好 )。 


Figure 53-1. 基因 算法 的 结构 化 框 


P(t) 时 刻 t 的 父 代 
P"(t) 时 刻 t 的 子 代 
—— 衣 站 旬 
| >>>>>>>>>>> Algorithm GA <<<<<<<<<<<<<<| 
ee ee daie ae e a i 
| INITIALIZE t := 0 | 
So 全 e 
| INITIALIZE P(t) | 
re 
| evaluate FITNESS of P(t) | 
S ai as a ep a Aa minae i i aa ae n n N 
while not STOPPING CRITERION do | 
ay el i ara + 

| P'(t) := RECOMBINATION{P(t)} | 

On aaa aaa + 

| P''(t) := MUTATION{P'(t)} | 


53.3. PostgreSQL 里 的 基因 查询 优化 (GEQO) 


GEQO 模 块 是 试图 解决 类 似 著 名 的 旅行 商 问 题 (TSP) 的 查询 优化 问题 的 。 可 能 的 查询 规划 被 当 
作 整 数字 符 串 进行 编码 。 每 个 字符 串 代 表 查 询 里 面 一 个 关系 到 下 一 个 关系 的 连接 的 顺序 。 例 
如 ， 下 面 的 连接 树 


UN 

UNE2 
UX Ss 
4 1 


是 用 整数 字符 串 '4-1-3-2' 编 码 的 ， 这 就 是 说 ， 首 先 连接 关系 4' 和 '1'， 然 后 '3'， 然 后 是 '2,， 这 里 
的 1, 2, 3, 4 都 是 PostgreSQL 优 化 器 里 的 关系 标识 (ID)。 


在 PostgreSQL 里 的 GEQO 实 现 的 一 些 特性 是 : 


。 使 用 稳定 状态 的 GA( 蔡 换 全 体 中 最 小 适应 性 的 个 体 ， 而 不 是 整 代 的 替换 ) 允许 向 改进 了 的 
查询 规划 快速 逼近 。 这 一 点 对 在 合理 时 间 内 义理 查询 是 非常 重要 的 ; 


。 边缘 重组 交叉 的 使 用 特别 适 于 在 用 GA 解 决 TSP 问 题 时 保持 边缘 损失 最 低 。 
。 否决 了 把 突变 作为 基因 操作 符 的 做 法 ， 这 样 生成 合法 的 TSP 漫 游 时 不 需要 修复 机 制 。 
GEQO 模 块 的 一 部 分 是 采用 的 D.Whitley 的 Genitor 算法 。 


GEQO 模 块 让 PostgreSQL 查 询 优化 器 可 以 通过 非 穷 举 搜索 有 效 地 支持 大 的 连接 查询 。 


53.3.1. GEQO 生 成 的 候选 规划 


GEQO 规 划 过 程 使 用 标准 的 规划 器 代码 生成 各 个 独立 表 的 扫描 规划 。 然后 用 遗传 算法 生成 连 
接 规划 。 正 如 上 面 讲 到 的 ， 每 个 候选 的 连接 规划 由 基本 表 的 连接 序列 表示 。 在 初始 阶段 ， 
GEQO 简 单 的 生成 一 些 随机 的 连接 序列 。 对 每 个 连接 序列 ， 调 用 标准 的 规划 器 代码 评估 以 这 
样 的 连接 序列 执行 查询 的 成 本 。 (对 连接 序列 的 每 一 个 步骤 ， 考 虑 所 有 可 能 的 三 种 连接 策 
略 ; 并 且 所 有 初期 决定 的 关系 扫描 规划 也 是 有 效 的 。 评估 值 是 所 有 这 些 可 能 性 中 最 廉价 的 。 
) 评估 成 本 更 低 的 连接 序列 被 认为 比 代价 高 的 那些 连接 序列 "更 加 合适 "。 基 因 算 法 淘汰 那些 
最 不 合适 的 候选 。 然后 通过 组 合 最 合适 的 基因 生成 新 的 候选 ， 即 通过 随机 选择 一 部 分 低 成 本 
的 连接 序列 去 产生 作为 候选 的 新 的 序列 。 这 个 过 程 不 断 重复 直到 考虑 过 的 连接 序列 达到 一 个 
预 设 的 值 ， 然 后 在 搜索 期 间 找到 的 最 好 的 结果 作为 最 终生 成 的 执行 计划 。 


这 个 过 程 天 生 是 不 确定 的 ， 因 为 在 选择 初期 总 群 以 及 随后 对 最 佳 候 补 实施 "突变 "时 都 带 有 随机 


性 。 为 了 避免 被 选中 的 计划 发 生 令 人 惊讶 的 变化 ， 每 次 GEQO 算 法 执行 都 根据 当 
前 geqo_seed 参 数 的 设置 开始 一 个 随机 数 生成 器 。 只 要 geqo_seed 以 及 其 他 GEQO 参 数 保持 


固定 ， 对 一 个 给 定 的 查询 (以 及 其 他 规划 器 输入 ， 比 如 统计 信息 ) 将 生成 相同 的 执行 计划 。 如 
果 要 党 试 不 同 的 搜索 路 径 ， 可 以 党 试 改 变 geqo_seed o 


53.3.2. PostgreSQL GEQO 未 来 的 实现 任务 


还 需要 一 些 工 作 来 改进 基因 算法 的 参数 设置 。 在 文 
件 src/backend/optimizer/geqo/geqo_main.c 里 的 过 程 gimme_pool_size 和 
gimme_number_generations 在 设置 参数 时 不 得 不 为 两 个 竞争 需求 做 出 折衷 : 


。 查询 规划 的 优化 

。 计算 义理 时 间 
在 当前 的 实现 中 ， 每 个 候选 连接 序列 的 适应 性 是 通过 运行 标准 规划 器 的 连接 选择 和 代价 评估 
代码 从 头 开始 评估 的 。 当 不 同 的 候选 使 用 相似 的 连接 子 序列 ， 将 有 大 量 的 工作 会 重复 。 通过 
保持 子 序列 的 代价 评估 值 可 以 显著 的 提升 速度 。 问 题 在 于 要 避免 为 了 保持 这 个 状态 而 不 合理 
的 内 存 扩 展 。 
在 最 基本 的 层面 上 ， 并 不 清楚 用 给 TSP 涉及 的 GA 算法 解决 查询 优化 的 问题 是 否 合适 。 在 


TSP 的 情况 下 ， 与 任何 子 字符 串 ( 部 分 旅游 ) 相 关 的 开销 都 是 独立 于 旅游 的 其 它 部 分 的 ， 但 是 目 
前 ， 这 一 点 对 于 查询 优化 是 不 同 的 。 因此 ， 可 以 怀疑 边缘 重组 交叉 是 否 最 有 效 的 突变 过 程 。 
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53.4. 进一步 阅读 


下 面 的 资源 包含 一 些 额 外 的 关于 基因 算法 的 信息 : 
e The Hitch-Hikers Guide to Evolutionary Computation, (FAQ for news://comp.ai.genetic) 
e Evolutionary Computation and its application to art and design, by Craig Reynolds 
。 数据 库 系 统 原理 


e POSTGRES 查 询 优 化 器 的 设计 和 实现 
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本 章 定义 PostgreSQL 核 心 系统 和 索引 访问 方法 之 间 的 接口 ， 后 者 管理 独立 的 索引 类 型 。 除 
了 在 这 里 声明 的 东西 之 外 ， 核 心 系统 对 索引 一 无 所 知 ， 因 此 可 以 通过 书写 累加 上 来 的 代码 ， 
开发 一 种 完全 新 的 索引 类 型 。 


PostgreSQL 里 的 所 有 索引 技术 上 都 叫做 从 属 索 引 ， 也 就 是 说 ， 索 引 在 物理 上 是 与 它 描 述 的 表 
文件 分 离 的 。 每 个 素 引 是 以 其 自己 的 物理 关系 的 方式 存储 的 ， 因 此 它们 也 在 pg_class RAR 
里 面 有 记录 描述 。 一 个 索引 的 内 容 是 完全 在 其 索引 访问 方法 的 控制 之 下 的 。 kal, MAR 
引 访 问 方法 都 把 索引 分 裂 成 标准 大 小 的 页 面 ， 这 样 他 们 就 可 以 使 用 普通 的 存储 管理 器 和 缓冲 
区 管理 器 来 访问 索引 的 内 容 了 。 (所 有 现 有 的 索引 访问 方法 更 是 使 用 Section 58.6 里 面 描述 的 
RENT Ht, FASS TAMER AIH ; 但 是 这 些 东 西 都 不 是 强制 访问 方法 执行 
的 。 也 就 是 说 必要 的 话 你 可 以 不 用 这 些 标准 格式 。) 


索引 实际 上 是 一 些 数 据 的 键 值 与 索引 的 父 表 中 的 行 版 本 (元 组 ) 的 行 标识 符 或 TID 之 间 的 映射 。 
一 个 TID 由 一 个 块 号 和 一 个 该 块 内 的 项 编号 组 成 (参阅 Section 58.6)。 这 些 就 是 从 该 表 中 抓 取 
某 个 特定 行 版 本 所 需 的 足够 的 信息 。 索引 并 不 直接 知道 在 MVCC 下 ， 同 一 个 逻辑 行 可 能 有 多 
个 现存 的 版 本 ; 对 于 索引 而 言 ， 每 个 元 组 都 是 一 个 独立 的 对 象 ， 都 需要 自己 的 索引 项 。 
此 ， 对 一 行 的 更 新 总 是 为 该 行 创建 全 新 的 索引 项 ， 即 使 键 值 没有 改变 也 如 此 (HOT 元 组 是 个 
例外 ， 但 索引 并 不 处 理 这 些 ) 。 已 经 上 废弃 的 元 组 的 索引 项 是 在 废弃 元 组 自己 被 回收 的 时 候 回 
收 (通过 vacuum)。 


54.1. 索引 的 系统 表 记 录 


每 个 索引 访问 方法 都 在 系统 表 pg_am 里 面 用 一 行 来 描述 (参阅 Section 47.3)。 一 个 pg_an 行 的 
主要 内 容 是 引用 pg_proc 里 面 的 记录 ， 用 来 标识 索引 访问 方法 提供 的 索引 访问 图 数 。 这 些 画 
数 的 接口 (API) 在 本 章 后 面 描 述 。 另 外 ， pg_am 的 数据 行 声 明了 有 几 个 素 引 访问 方法 的 固定 属 
性 ， 上 比如 ， 它 是 否 支 持 多 字段 素 引 。 目前 还 没有 创建 、 删 除 pg_am 记录 的 特殊 支持 ; 任何 想 
写 这 么 一 个 新 的 访问 方法 的 人 都 需要 能 够 自己 向 这 个 表 里 面 插 入 合适 的 新 行 。 


要 想 有 真正 用 处 ， 一 个 索引 访问 方法 还 必须 有 一 个 或 多 个 操作 符 族 和 操作 符 类 ， 定 义 在 
pg_opfamily , pg_opclass , pg_amop 和 pg_amproc 里 面 。 这 些 记 录 人 允许 规划 器 判断 哪些 查询 
的 条 件 可 以 适用 于 用 这 个 索引 访问 方法 创建 的 索引 。 操作 符 族 和 操作 符 类 在 Section 35.14 里 
面 定义 ， 是 读 取 本 章 的 前 提 之 一 。 


一 个 独立 的 索引 是 由 一 行 pg_class 记录 以 物理 关系 的 方式 描述 的 ， 加 上 一 个 pg_index 行 ， 
表示 该 索引 的 逻辑 内 容 一 也 就 是 说 ， 它 所 拥有 的 索引 字段 集 ， 以 及 被 相关 的 操作 符 类 捕获 的 
这 些 字段 的 语义 。 索引 字段 ( 键 值 ) 可 以 是 下 层 表 的 字段 ， 也 可 以 是 该 表 的 数据 行 上 的 表达 
式 。 索引 访问 方法 通常 不 关心 索引 的 键 值 来 自 哪 里 ( 它 总 是 操作 经 过 预计 算 的 键 值 )， 但 是 它 
会 对 pg_index 里 面 的 操作 符 类 信息 很 感 兴趣 。 所 有 这 些 系 统 表 记录 都 可 以 当 作 Relation 数 
据 结构 的 一 部 分 访问 ， 这 个 数据 结构 会 被 传递 到 对 该 索引 的 所 有 操作 上 。 


pg_am 中 的 有 些 标志 字段 的 含义 并 不 那么 直观 。 amcanunique 的 需求 在 Section 54.5 里 讨论 ， 
amcanmulticol 标志 断言 该 索引 访问 方法 支持 多 字段 素 引 ， amoptionalkey 断言 它 允 许 对 那 种 
在 第 一 个 索引 字段 上 没有 给 出 可 索引 限制 子 句 的 扫描 。 如 果 amcanmulticol 为 假 ， 那 

和 amoptionalkey 实际 上 说 的 是 该 访问 方法 是 否 允 许 不 带 限 制 子 句 的 全 索引 扫描 。 那些 支持 
多 字段 索引 的 访问 访 法 必须 支持 那些 在 省 略 了 除 第 一 个 字段 以 外 的 其 它 字段 的 约束 的 扫描 ; 
不 过 ， 系 统 人 允许 这 些 访问 访 法 要 求 在 第 一 个 字段 上 出 现 一 些 限制 ， 这 一 点 是 通过 把 
amoptionalkey 设置 为 假 来 实现 的 。 一 个 访问 访 法 可 能 设置 amoptionalkey XR URET 
引 NULL 值 的 话 。 因为 大 多 数 可 以 索引 的 操作 符 都 是 严格 的 ， 因 此 不 能 对 NULL 输入 返回 
TRUE ， 所 以 ， 第 一 眼看 见 会 觉得 不 为 NULL 存储 索引 记录 的 想法 很 吸引 人 : 因为 他 们 不 可 
能 被 一 个 索引 扫描 返回 。 不 过 ， 这 个 想法 在 一 个 给 出 的 索引 字段 上 没有 限制 子 句 的 索引 扫描 
的 情况 下 就 不 行 了 ; 这 样 的 扫描 应 该 包括 NULL 行 。 实际 上 ， 这 意味 着 设置 

了 amoptionalkey 为 真 的 素 引 必须 索引 NULL 值 ， 因 为 规划 器 可 能 会 决定 在 根本 没有 扫描 键 字 
的 时 候 使 用 这 样 的 索引 。 这 样 的 索引 必须 可 以 在 完全 没有 扫描 键 字 的 情况 下 运行 。 另外 一 个 
限制 是 一 个 支持 多 字段 索引 的 索引 访问 方法 必须 索引 第 一 个 字段 后 面 的 字段 的 NULL 值 ， 因 为 
规划 器 会 认为 这 个 索引 可 以 用 于 那些 没有 限制 这 些 字段 的 查询 。 上 比如， 假设 有 个 在 (a,b) 上 的 
索引 ， 而 一 个 查询 的 条 件 是 WHERE a = 4 。 系 统 会 认为 这 个 索引 可 以 用 于 打 描 a = 4 的 数据 
行 ， 如 果 素 引 忽 略 了 b 为 空 的 数据 行 ， 那 么 就 是 错误 的 。 不 过 ， 如 果 第 一 个 索引 字段 值 是 
空 ， 那 么 忽略 它 是 OK 的 。 一 个 索引 NULL 值 的 索引 访问 方法 可 能 会 设置 amsearchnulls ， 表 
明 它 支持 rs NULL 和 rs not NULL 子 句 作为 搜索 条 件 。 


54.2. 条 引 访 问 方 法 函数 


索引 访问 方法 必须 提供 的 索引 构造 和 维护 西数 有 : 


IndexBuildResult * 

ambuild (Relation heapRelation, 
Relation indexRelation, 
IndexInfo *indexInfo) ; 


创建 一 个 新 素 引 。 素 引 关 系 已 经 物理 上 创建 好 了 ， 但 是 是 空 的 。 必须 用 索引 访问 方法 要 求 的 
固定 数据 和 代表 所 有 已 经 在 表 里 的 行 的 数据 项 填充 它 。 通常 ， ambuild HABA 
用 IndexBuildHeapscan() 扫描 该 表 以 获取 现 有 行 并 计算 需要 插入 索引 的 键 字 。 


void 
ambuildempty (Relation indexRelation); 


创建 一 个 空 的 索引 ， 并 写 到 给 定 关系 的 初始 fork(INIT_FORKNUM) 中 。 这 个 方法 只 会 为 
unlogged 表 调用 ;在 服务 器 重启 动 时 写 和 人 到 初始 fork 的 空 索引 会 被 复制 到 主 关系 。 


bool 
aminsert (Relation indexRelation, 
Datum *values, 
bool *isnull, 
ItemPointer heap_tid, 
Relation heapRelation, 
IndexUniqueCheck checkUnique) ; 


向 现 有 索引 插入 一 个 新 行 。 values 和 isnull 数组 给 出 需要 制作 索引 的 键 字 值 ， 

而 heap_tid 是 要 被 索引 的 TID 。 如 果 该 访问 方法 支持 唯一 索引 ( 它 的 pg_am . amcanunique 标 
志 是 真 )， 那么 checkunique 指示 需要 执行 这 种 唯一 性 检查 。 具体 情况 依赖 于 该 唯一 制约 是 否 
是 可 延期 的 (deferrable) 而 不 同 ; 详细 请 参阅 Section 54.5。 通常 访问 方法 只 有 在 执行 唯一 
性 检查 时 才 需 要 heapRelation 参数 ( 它 将 深入 到 heap 中 确认 行 是 否 是 活 的 )。 


只 有 当 checkunique 是 UNIQUE_CHECK_PARTIAL 时 ， 该 贺 数 的 返回 值 地 有 意义 。 TRUE 的 返回 值 
意味 着 新 的 索引 项 是 唯一 的 ，FALSE 意 味 着 不 唯一 (并且 延期 的 唯一 性 检查 必须 被 调度 ) o 
其 它 情况 下 推荐 返回 常量 FALSE。 


一 些 索 引 可 能 并 不 索引 所 有 的 行 。 如 果 行 不 被 索引 ， aminsert 应 该 不 做 任何 事情 就 直接 返 
回 。 


IndexBulkDeleteResult * 

ambulkdelete (IndexVacuumInfo *info, 
IndexBulkDeleteResult *stats, 
IndexBulkDeleteCallback callback, 
void *callback_state); 


M5|P HIRT. 这 是 一 个 "批量 删除 "的 操作 ， 通 常 都 是 通过 扫描 整个 索引 ， 检 查 每 条 记 
录 ， 看 看 它 是 否 需要 被 删除 来 实现 的 。 可 以 调用 传递 进来 的 callback 画 数 ， 调 用 风格 是 : 
callback(``_TID , callback_state) returns bool, 其 作用 是 判断 某 个 用 其 引用 的 TID 标识 的 
索引 项 是 否 需要 删除 。 必须 返回 NULL 或 者 是 一 个 palloc 出 来 的 ， 包 含 删 除 操作 执行 影响 的 
统计 信息 的 结构 。 如 果 不 需要 向 amvacuumcleanup 传递 信息 ， 返 回 NULL 也 是 OK 的 。 


由 于 maintenance_work_mem 的 限制 ， 在 删除 多 行 的 时 候 ambulkdelete 可 能 需要 被 调用 多 

次 ， stats 参数 是 先前 在 这 个 索引 上 的 调用 结果 (在 一 个 vAcuuM 操作 内 部 第 一 次 调用 的 话 则 
是 NULL) 这 将 允许 AM 在 整个 操作 过 程 中 积累 统计 信息 。 典型 的 ， 如 果 传 递 的 stats 不 是 
null 的 话 ， ambulkdelete 将 会 修改 并 返回 相同 的 结构 。 


IndexBulkDeleteResult * 
amvacuumcleanup (IndexVacuumInfo *info, 
IndexBulkDeleteResult *stats); 


f£— vacuum 操作 (一 个 或 多 个 ambulkdelete 调用 ) 之 后 清理 。 虽然 不 必 做 任何 返回 索引 状态 
之 外 的 任何 其 他 事情 ， 但 是 它 通 常用 于 批量 清理 ， 比 如 说 回收 空 的 索引 页 面 。 stats 是 最 后 
的 ambulkdelete 调用 返回 的 东西 或 者 NULL( 如 果 因 为 没有 行 需要 删除 而 未 调 

用 ambulkdelete 的 话 )。 如 果 结 果 不 是 NULL ， 那 么 它 必须 是 一 个 palloc 出 来 的 结构 。 CA 
含 的 统计 信息 将 用 于 更 新 pg_class 并 且 由 vacuum 报告 (如 果 给 出 了 vERBosE )。 如 果 索 引 

在 vacuum 操作 的 过 程 中 根本 没有 改变 ， 那 么 返回 NULL 也 是 OK 的 ， 否 则 必须 返回 当前 状 


xX 


No 


4£PostgreSQL8.44, amvacuumcleanup 也 会 在 ANALYZE 完成 时 被 调用 。 这 时 ， stats 总 是 为 
NULL， 并 且 返 回 值 会 被 忽略 。 通过 检查 info-&gt;analyze_only 可 以 区 分 出 这 种 情况 。 建议 
访问 方法 在 这 样 的 调用 里 除了 插入 后 的 清理 不 要 做 其 他 事情 ， 并 且 这 只 在 autovacuum 工 作 进 
程 中 。 


bool 
amcanreturn (Relation indexRelation); 


检查 索引 是 否 支 持 index-only 打 描 ， 通 过 为 一 个 索引 项 以 IndexTuple 的 形式 返回 被 索引 的 列 
fio 如 果 支 持 返 回 TRUE， 否 则 返回 FALSE。 如 果 索 引 AM 永 远 不 支持 index-only 扫 描 ( 上 比如 
hash， 它 只 存储 哈 希 值 而 不 是 原始 数据 ) ， 可 以 有 充分 的 理由 把 pg_am 中 的 amcanreturn 字 
RREA, 


void 

amcostestimate (PlannerInfo *root, 
IndexPath *path, 
double loop_count, 
Cost *indexStartupCost, 
Cost *indexTotalCost, 
Selectivity *indexSelectivity, 
double *indexCorrelation); 


tRNR aR. ABA F Section 54.6 中 有 详细 的 讨论 。 


bytea * 
amoptions (ArrayType *reloptions, 
bool validate); 


为 一 个 索引 分 析 和 验证 reloptions 数组 ， 仅 当 一 个 索引 存在 非 空 reloptions 数组 时 才 会 被 调 

FA. reloptions 是 一 个 text 数组 ， 包 含 jname_``=``_value_ 格式 的 项 。 该 函数 应 当 创 建 一 
个 bytea 值 ， 该 值 将 被 拷贝 进 索 引 的 relcache 项 的 rd_options 字段 。 bytea 值 的 数据 内 容 
可 以 由 访问 方法 定义 ， 不 过 目前 所 有 的 标准 访问 方法 都 使 用 stdRdoptions 结构 。 

当 validate 为 真 时 ， 如 果 任 何 一 个 选项 不 可 识别 或 者 含有 非法 值 ， 该 函数 都 应 当 报 告 一 个 适 
当 的 错误 信息 ; 当 validate 为 假 时 ， 非 法 项 应 该 被 悄 展 的 忽略 。 “〈 当 载 入 已 经 存储 

在 pg_catalog 中 的 选项 时 ， validate 为 假 ， 仅 在 访问 方法 已 经 改变 了 选项 规则 的 时 候 才 可 能 

找到 非法 项 ， 在 此 情况 下 可 以 忽略 废弃 的 项 。) ”如 果 上 默认 行为 正 是 想 要 的 ， 那 么 返回 NULL 
也 OK 。 





索引 的 目的 当然 是 支持 那些 包含 一 个 可 以 索引 的 whERE 条 件 的 行 的 扫描 ， 这 个 条 件 通 常 叫 修 
饰 词 或 扫描 键 字 。 索引 扫描 的 语义 在 下 面 的 Section 54.3 里 面 有 更 完整 的 描述 。 一 个 索引 访 
问 方法 可 以 支持 "plain" 索 引 扫描 ，"bitmap" 索 引 扫 描 ， 或 者 两 者 都 支持 。 必须 或 可 以 提供 的 与 
扫描 有 关 的 函数 有 : 


IndexScanDesc 

ambeginscan (Relation indexRelation, 
int nkeys, 
int norderbys); 


准 各 一 个 索引 扫描 。 nkeys 和 norderbys 参 素 指示 扫描 中 使 用 的 修饰 词 和 排序 操作 符 的 个 
数 ; 它们 可 能 对 空间 分 配 有 用 。 注意 实际 的 扫描 键 还 没有 提供 。 结果 必须 是 一 个 palloc 出 来 
的 结构 。 由 于 实现 的 原因 ， 索 引 访问 方法 必须 通过 调用 RelationGetIndexScan() 来 创建 这 个 
结构 。 在 大 多 数 情况 下 ， ambeginscan 本 身 除 了 调用 上 面 这 个 函数 和 可 能 获取 一 些 锁 之 外 几 
乎 不 干 别 的 事情 ; 索引 扫描 启动 时 的 有 趣 部 分 在 amrescan Œ, 


void 

amrescan (IndexScanDesc scan, 
ScanKey keys, 
int nkeys, 
Scankey orderbys, 
int norderbys); 


启动 或 重新 和 启动 一 个 索引 扫描 ， 可 能 会 使 用 新 的 扫描 键 字 。 【要 使 用 先前 提供 的 键 重启 动 ， 
给 keys 和 /或 者 orderbys 传人 NULL) 记 住 扫描 键 字 或 排序 操 a a 

ambeginscan 的 数值 。 实际 上 ， 重 新 启动 特性 用 于 这 样 的 场景 : AAA T aR aE 

环 (nested-loop) 连 接 选中 时 ， 需 要 一 个 新 的 键 比 较 值 ， 但 是 扫描 键 结构 仍然 是 相同 的 。 
boolean 


amgettuple (IndexScanDesc scan, 
ScanDirection direction); 


在 给 出 的 打 描 里 抓 取 下 一 个 行 ， 向 给 出 的 方向 移动 (在 索引 里 向 前 或 者 向 后 )。 如 果 抓 取 到 了 
行 ， 则 返回 TRUE ， 如 果 没 有 抓 到 匹配 的 行 ， 返 回 FALSE. 在 为 TRUE 的 时 候 ， 该 行 的 

TID 存储 在 scan 结构 里 。 请 注意 "成 功 "只 是 意味 着 索引 包含 一 个 匹配 打 描 键 字 的 条 目 ， 并 不 
是 说 该 行 仍然 在 堆 中 存在 ， 或 者 是 能 够 通过 调用 者 的 快照 检查 (译注 : MVCC 快照 ， 用 于 判断 
事务 边界 内 的 行 可 视 性 )。 如 果 成 功 ， amgettuple 必须 设置 scan-&gt;xs_recheck 为 TRUE 或 
FALSE. FALSE 意 味 着 已 经 可 以 确定 索引 项 匹配 扫描 键 字 。 TRUE 意味 着 尚 不 确定 ， 在 取 到 
堆 元 组 后 必须 对 堆 元 组 再 次 检查 代表 这 个 扫描 键 值 的 条 件 。 


如 果 索 引 支 持 index-only 扫 描 〈 比 如 ， amcanreturn 为 它 返 回 TRUE) ， 那么 成 功 执行 后 ， 这 
个 AM 也 必须 检查 scan-&gt;xs_want_itup ， 如 果 为 TRUE, 它 必须 通过 存储 

在 scan-&gt;xs_itup 中 的 IndexTuple 指针 以 及 元 组 描述 符 scan-agt;xs_itupdesc 为 这 个 索引 
项 返回 原始 的 被 索引 数据 。 《访问 方法 需要 负责 维护 被 这 个 指针 引用 的 数据 。 至 少 在 该 扫描 
下 一 次 调用 amgettuple ， amrescan 或 amendscan 前 ， 这 个 数据 必须 保持 完好 ) 


如 果 访 问 方法 支持 "plain" 索 引 扫 描 ， 只 需要 提供 amgettuple HM MRA, EC 
的 pg_am 行 中 的 amgettuple 字段 必须 被 设置 成 需 。 


Int64 
amgetbitmap (IndexScanDesc scan, 
TIDBitmap *tbm); 


在 指定 的 扫描 中 抓 取 所 有 元 组 并 把 它们 加 入 到 调用 者 提供 的 TIpBitmap 中 〈 换 名 话说 ， 元 组 
的 ID 集合 加 入 到 某 个 已 存在 的 bitmap) 。 画 数 返回 抓 取 到 的 元 组 数 〈 这 可 能 只 是 一 个 近似 计 
数 ， 某 些 AM 实 例 并 不 检测 重复 ) 。 当 插 入 元 组 的 TID 到 bitmap，amgetbitmap 可 以 指示 对 特定 
的 元 组 TID 需 要 对 扫描 条 件 做 再 检查 。 这 和 amgettuple KAPIA HŽ xs_recheck 类 似 。 
注意 : 在 当前 实现 中 ， 支 持 这 个 特性 涉及 到 支持 bitmap 自 身 的 有 损 存 储 ， 因 此 调用 者 为 可 再 
检查 的 元 组 再 次 检查 扫描 条 件 和 部 分 素 引 谓词 GRAN) 。 然而 ， 这 可 能 不 会 总 是 正确 
的 。 amgetbitmap 和 amgettuple 不 能 在 同一 个 索引 扫描 中 使 用 ; 在 使 用 amgetbitmap 的 时 候 
还 有 其 它 限 制 ， 在 Section 54.3 里 给 出 解释 。 


只 有 访问 方法 支持 "bitmap" 索 引 扫描 时 才 需 要 提供 amgetbitmap HA. 如 果 访 问 方法 不 支持 的 
话 ， 必 须 在 它 的 pg am 行 里 设置 amgetbitmap FRAS, 


void 
amendscan (IndexScanDesc scan); 


结束 扫描 并 释放 资源 。 不 应 该 释放 scan 本 身 ， 但 访问 方法 内 部 使 用 的 任何 锁 或 者 销 (pin) 都 应 
该 释放 。 


void 
ammarkpos (IndexScanDesc scan); 


标记 当前 扫描 位 置 。 访 问 方 法 只 需要 支持 每 次 扫描 里 面 有 一 个 被 记 住 的 扫描 位 置 。 


void 
amrestrpos (IndexScanDesc scan); 


把 扫描 恢复 到 最 近 标 记 的 位 置 。 


通常 ， 任 何 索 引 访问 方法 男 数 的 pg_proc 记录 都 应 该 显示 正确 数目 的 参数 ， 只 是 把 类 型 都 声 
明 为 类 型 internal (因为 大 多 数 参数 的 类 型 都 是 SQL 不 识别 的 类 型 ， 并 且 不 希望 用 户 直 接 调 
FAAS), 返回 类 型 根据 具体 情况 声明 为 void, internal , Of boolean, 唯一 的 例外 是 
amoptions ， 它 应 当 被 声明 为 接受 text[] 和 bool 并 返回 bytea 。 这 样 就 允许 客户 端 代码 执 
行 amoptions 以 确认 选项 设置 的 有 效 性 。 


54.3. 索引 扫 摘 


在 一 个 索引 打 描 里 ， 索 引 访 问 方法 负责 把 它 拿 到 的 那些 据说 匹配 扫描 键 字 的 所 有 行 之 TID 的 
回流 。 访问 方法 不 会 参 入 从 索引 的 父 表 中 实际 抓 取 这 些 行 的 动作 中 ， 也 不 会 判断 他 们 是 否 通 
过 了 扫描 的 时 间 条 件 测试 或 者 是 其 它 条 件 。 


一 个 打 描 键 字 是 乡 如 index_key operator_~~_constant_ 的 WHERE 子 句 的 内 部 表现 形式 ， 
这 里 的 索引 键 字 是 索引 中 的 一 个 字段 ， 而 操作 符 是 和 该 索引 字段 相关 联 的 操作 符 族 的 一 个 成 
Ro 一 个 索引 扫描 拥有 需 个 或 者 多 个 扫描 键 字 ， 他 们 是 隐 含 着 AND 的 关系 一 返回 的 行 被 认 
为 是 满 所 所 有 列 出 的 条 件 的 行 。 





访问 方法 可 以 声称 自己 是 有 损 的 或 对 特定 的 查询 需要 再 检查 。 这 意味 着 ， 索 引 扫 描 会 返回 所 
有 通过 扫描 键 字 的 条 目 并 可 能 加 上 一 些 不 能 通过 的 条 目 。 核心 系统 的 索引 扫描 装置 之 后 会 对 
堆 元 组 应 用 索引 条 件 以 确认 是 否 真 的 这 个 元 组 应 该 被 选中 。 如 果 再 检查 选项 没有 被 指定 ， 索 
引 扫描 必须 精确 返回 匹配 的 条 目 。 


请 注意 ， 确 保 找 到 所 有 条 目 以 及 确保 所 有 条 目 都 通过 给 出 的 扫描 键 字 的 条 件 完 全 是 访问 方法 
的 责任 。 还 有 ， 核 心 系统 将 只 是 简单 的 把 所 有 匹配 扫描 键 字 和 操作 符 族 的 whERE 子 句 传递 过 
来 ， 而 不 会 做 任何 语义 分 析 ， 以 判断 他 们 是 否 元 余 或 者 是 否 相互 矛盾 。 举例 来 说 ， 给 

出 WHERE x &gt; 4 AND x &gt; 14 where x ， 这 里 的 x 是 一 个 b-tree 索引 字段 ， 那么 把 第 
一 个 扫描 键 字 识别 成 元 余 的 和 可 抛 奔 的 工作 是 b-tree amrescan MAAS. amrescan 过 程 中 
所 需要 的 预 处 理 的 范围 将 由 索引 访问 方法 把 扫描 键 字 缩 减 为 一 个 "规范 化 "形式 的 具体 需要 而 

定 。 


一 些 访问 方法 以 明确 的 顺序 返回 索引 项 ， 另 外 一 些 则 不 是 。 实际 上 访问 方法 可 以 支持 两 种 不 
同 的 排序 输出 方法 : 


e. 以 自然 的 数据 顺序 返回 条 目的 访问 方法 (比如 btree) 应 该 设置 pg_am . amcanorder 为 
真 。 当前 ， 这 样 的 访问 方法 必须 为 它们 的 相等 和 排序 操作 符 使 用 btree 兼 容 的 策略 数 。 


e 支持 排序 操作 的 访问 方法 必须 设置 pg_am . amcanorderbyop 为 真 。 这 表明 这 个 索引 能 够 以 
满足 ORDER BY _index_key_``_operator_  _constant。 的 顺序 返回 条 目 。 这 种 形式 的 打 
描 修饰 子 能 够 像 前 面 描述 的 那样 被 传人 amrescan o 





amgettuple 函数 有 一 个 direction FM, CALA ForwardscanDirection (正常 情况 ) 或 者 
BackwardScanDirection 。 如 果 amrescan 之 后 的 第 一 次 调用 声明 BackwardScanDirection ， 那 
么 匹配 条 件 的 索引 记录 集 是 从 后 向 前 扫描 的 ， 而 不 是 通常 的 从 前 向 后 扫描， 

此 amgettuple 必须 返回 索引 中 最 后 的 匹配 行 ， 而 不 是 通常 情况 下 的 第 一 条 。 (这 些 事情 只 会 
在 那些 设置 了 amcanorder 为 真 的 访问 方法 上 会 发 生 。) 在 第 一 次 调用 之 后 ， amgettuple 必 
须 准备 从 最 近 返 回 的 条 目的 位 置 开 始 ， 在 两 个 方向 上 进行 扫描 步 进 。 (但 是 ， 如 

果 pg_am . amcanbackward 为 假 ， 所 有 随后 的 调用 将 会 和 第 一 次 调用 使 用 相同 的 顺序 。 ) 


支持 排序 扫描 的 访问 方法 必须 支持 在 扫描 上 "标记 "位 置 ， 并 在 之 后 可 以 返回 这 个 被 标记 的 位 
E. 相同 的 位 置 可 能 被 恢复 多 次 。 然而 ， 每 次 扫描 只 有 一 个 位 置 需要 被 记 住 ; 一 次 新 

的 ammarkpos 调用 会 覆盖 先前 被 标记 的 位 置 。 不 支持 排序 扫描 的 访问 方法 仍然 可 以 

在 pg_am 中 提供 标记 和 恢复 函数 ， 但 是 如 果 被 调用 可 以 让 这 些 画 数 抛 出 错误 。 


扫描 位 置 和 标记 位 置 (如 果 存 在 ) 都 必须 在 面 对 索 引 中 存在 并 发 插入 和 删除 的 时 候 保持 一 致 性 。 
如 果 一 条 并 发 新 插入 的 记录 并 未 被 一 次 扫描 返回 (而 如 果 扫描 开始 的 时 候 该 记录 就 存在 的 话 ， 

则 会 被 返回 )， 或 者 说 扫描 通过 重新 扫描 或 者 回头 扫描 返回 这 样 的 记录 (即使 它 第 一 次 跑 的 时 
候 没有 返回 这 样 的 行 ) ， 对 于 系统 来 说 ， 这 种 情况 是 可 以 接受 的 。 类 似 的 还 有 ， 一 个 并 发 的 
删除 可 以 反映 ， 也 可 以 不 反应 一 个 扫描 的 结果 。 重要 的 是 ， 插 入 或 者 删除 不 会 导致 扫描 会 略 
过 或 者 重复 返回 本 身 不 是 被 插入 或 者 删除 的 条 目 。 


如 果 索 引 存储 原始 的 被 索引 数据 值 (而 不 是 某 种 有 损 的 表现 形式 ) ， 对 支持 index-only 扫 描 是 
有 用 的 ， 这 时 ， 索 引 返 回 实际 的 数据 而 不 仅 是 堆 元 组 的 TID。 只 有 在 可 见 性 映射 显示 这 个 TID 
在 一 个 全 可 见 页 上 是 这 才 有 效 ; 否则 还 是 必须 检查 堆 元 组 的 MVCC 可 见 性 。 但 是 访问 方法 不 
需要 关心 这 件 事 。 


作为 amgettuple 的 替代 ， 索 引 扫 描 可 以 可 以 通过 一 次 amgetbitmap 调用 抓 取 所 有 元 组 来 完 
成 。 这 明显 可 能 比 amgettuple 更 高 效 ， 因 为 可 以 避免 在 访问 方法 内 部 的 加 锁 解 锁 。 一 般 而 
=, amgetbitmap 和 重复 调用 amgettuple 有 相同 的 效果 ， 但 是 为 了 简化 我 们 加 入 了 一 些 限 
制 。 首先 ， amgetbitmap 一 次 返回 所 有 元 组 ， 并 且 不 支持 标记 和 恢复 位 置 。 第 二 ， 在 bitmap 
中 返回 的 元 组 没有 任何 指定 的 顺序 ， 这 也 是 amgetbitmap 没有 direction 参数 的 原因 。 ( 排 
序 操作 也 就 永远 不 会 被 应 用 到 这 样 的 打 描 上 ) 既然 没有 办 法 返回 被 索引 元 组 的 内 容 ， 也 就 不 
会 有 使 用 amgetbitmap 的 index-only 扫 描 。 最 后 ， amgetbitmap 不 能 保证 对 被 返回 元 组 上 实施 
任何 在 Section 54.4 中 描述 的 锁 。 


注意 ， 如 果 一 个 访问 方法 的 内 部 实现 不 适合 实现 其 中 一 个 API 的 话 ， 人 允许 一 个 访问 方法 只 实 
现 amgetbitmap 和 amgettuple 中 的 一 个 。 


544.85 AE E 


索引 访问 方法 必须 支持 多 个 进程 对 索引 的 并 发 更 新 。 在 索引 扫描 期 间 ，PostgreSQL 核 心 系 统 
在 索引 上 抓 取 AccessShareLock , 并 且 在 更 新 索引 期 间 ( 包 括 VACUUM ) 也 会 抓 

取 RowExclusiveLock o 因为 这 些 锁 类 型 不 会 冲突 ， 所 以 访 问 方法 有 责任 处 理 任何 它 自 己 需 要 
的 更 细致 的 锁 需 求 。 把 整个 索引 锁 住 的 排他 锁 只 是 在 创建 和 出 除 索 引 或 者 REINDEX 的 时 候 使 
用 。 


创建 一 个 支持 并 发 更 新 的 索引 类 型 通常 要 求 对 所 需 的 行为 进行 广泛 的 并 且 细 致 的 分 析 。 对 于 
b-tree 和 Hash 索引 类 型 ， 你 可 以 读 取 在 src/backend/access/nbtree/README 和 
src/backend/access/hash/README 里 面 描 述 的 设计 决策 。 


除了 索引 自己 内 部 的 一 致 性 要 求 之 外 ， 并 发 更 新 产生 了 一 些 有 关 父 表 ( 堆 ) 和 索引 之 间 的 一 致 性 
问题 。 因为 PostgreSQL 是 把 堆 的 访问 和 更 新 与 索引 的 访问 和 更 新 分 开 的 。 用 下 面 的 规则 处 
理 这 样 的 问题 : 


。 在 制作 一 行 的 素 引 记录 之 前 ， 先 做 堆 记 录 。 (因此 并 发 的 索引 扫描 很 可 能 看 不 到 堆 记 
ko 这 么 做 应 该 是 OK 的 ， 因 为 索引 读者 应 该 对 未 提交 的 行 不 感 兴趣 。 不 过 需要 看 
Section 54.5. ) 


。 如 果 一 条 堆 记 录 要 被 删除 (被 vacuum )， 所 有 其 索引 记录 都 必须 首先 删除 。 


。 对 于 并 发 索引 类 型 ， 一 次 索引 扫描 必须 在 保存 有 amgettuple 最 后 返回 记录 的 索引 页 面 上 
维护 一 个 销 ， 而 ambulkdelete 不 能 删除 其 它 后 端 用 销 固定 的 索引 页 面 里 面 的 记录 。 A 
需要 这 条 规则 在 下 面 解释 。 


如 果 没 有 第 三 条 规则 ， 那 么 一 个 索引 读者 是 可 能 在 一 条 索引 记录 刚 要 被 vacuum 删除 之 前 看 到 
它 ， 然后 在 对 应 的 堆 记 录 已 经 被 vAcuum 删除 时 ， 去 找 这 条 堆 记 录 。 如 果 读 者 到 达 该 项 时 ， 
该 项 编号 仍然 没有 使 用 ， 那 么 这 种 情况 不 会 导致 严重 的 问题 ， 因 为 空 的 项 槽 位 会 

被 heap_fetch() 忽略 。 但 是 如 果 第 三 个 后 端 已 经 为 其 它 什 么 东西 复 用 了 这 个 项 槽 位 又 如 何 ? 
如 果 使 用 MVCC 兼容 的 快照 ， 那 么 就 不 会 有 问题 ， 因 为 新 占据 的 槽 位 当然 是 太 新 了 ， 因 而 无 
法 通过 快照 测试 。 但 是 ， 对 于 非 MVCC 兼容 的 快照 (比如 snapshotNow )， 那 么 就 有 可 能 接受 
并 返回 一 个 实际 上 并 不 匹配 扫描 键 字 的 行 。 可 以 通过 要 求 打 描 键 字 在 所 有 场合 下 都 重新 检查 
的 方法 来 避免 这 种 情况 ， 但 是 这 种 方法 开销 太 大 了 。 取而代之 的 是 ， 通 过 在 索引 页 面 上 使 用 
一 个 销 ， 当 作 一 个 代理 ， 告 诉 系 统 说 ， 读 者 可 能 还 在 对 应 堆 记录 的 索引 记录 上 空 "飞行 "。 

让 ambulkdelete 在 这 样 的 销 上 阻塞 可 确保 vacuum 无 法 在 读者 完成 读 取 之 前 删除 堆 记 录 。 这 


阻塞 开销 。 


这 个 解决 方法 要 求索 引 扫 描 必须 是 "同步 的 " : 必须 在 扫描 完 对 应 的 索引 记录 之 后 马上 抓 取 每 个 
HEko 这 样 的 方案 开销 比较 大 ， 原 因 有 若干 个 。 而 "异步 的 "扫描 ， 可 以 先 从 索引 里 收集 很 
多 TID ， 然 后 在 稍 后 的 某 个 时 间 访 问 堆 行 ， 这 祥 就 会 绕 开 很 多 索引 锁 的 开销 ， 以 及 可 以 允许 


更 有 效 的 堆 访 问 模式 。 但 是 按照 上 面 的 分 析 ， 在 非 MVCC 兼容 快照 上 必须 使 用 同步 方法 ， 而 
对 使 用 MVCC 快照 的 查询 ， 使 用 异步 扫描 应 该 是 可 行 的 。 


在 amgetbitmap 索引 扫描 里 ， 访问 方法 不 需要 保证 在 任何 返回 的 行 上 保持 一 个 销 。 毕竟 ， 除 
了 给 最 后 一 个 行 加 销 之 外 ， 也 没 法 给 其 它 的 加 。 因此 ， 只 能 在 MVCC 兼容 的 快照 里 使 用 这 样 
的 扫描 。 


如 果 没 有 设置 ampredlocks ， 任 何在 可 串 行 化 事务 中 使 用 这 个 索引 访问 方法 的 扫描 将 会 在 整个 
索引 上 获得 一 个 非 阻塞 的 谓词 锁 。 与 其 并 发 的 另 一 个 可 串 行 化 事务 向 这 个 索引 中 插 和 人 任何 一 
个 元 组 时 都 会 引发 一 个 读 写 冲突 。 如 果 在 并 发 的 可 串 行 化 事务 间 检 测 到 某 种 模式 的 读 写 冲 
突 ， 为 了 保证 数据 一 致 性 其 中 一 个 事务 可 能 会 被 取消 。 如 果 设 置 了 这 个 标志 ， 表 明 这 种 索引 
访问 方法 实现 了 精细 的 谓词 锁 ， 因 而 趋向 于 削减 这 种 事务 取消 的 频 度 。 


54.5. R5IE— IER E 


PostgreSQL 使 用 唯一 索引 来 强制 SQL 唯一 约束 ， 唯 一 索引 实际 上 是 不 允许 多 条 记录 有 相同 键 
值 的 的 索引 。 一 个 支持 这 个 特性 的 访问 方法 要 设置 pg_am . amcanunique AB. (Ba, RA 
b-tree 支持 它 。) 


因为 MVCC ， 必 须 人 允许 重复 的 条 目 物理 上 存在 于 索引 之 中 : 该 条 目 可 能 指向 某 个 逻辑 行 的 后 
面 的 版 本 。 实际 想 强 制 的 行为 是 ， 任 何 MVCC 快照 都 不 能 包含 两 条 相同 的 索引 键 字 。 这 种 
要 求 在 向 一 个 唯一 索引 插入 新 行 的 时 候 分 解 成 下 面 的 几 种 情况 : 


。 如 果 一 个 有 冲突 的 合法 行 被 当前 事务 删除 ， 这 是 可 以 的 。 (特别 是 因为 一 个 UPDATE 总 
是 在 插入 新 版 本 之 前 删除 旧版 本 ， 这 样 就 允许 一 个 行 上 的 UPDATE 不 用 改变 键 字 进 行 操 
作 。) 


。 如 果 一 个 在 等 待 提交 的 事务 插入 了 一 行 有 冲突 的 数据 ， 那 么 准备 插入 数据 的 事务 必须 等 
待 看 看 改 事务 是 否 提 交 。 如 果 该 事务 回 滚 ， 那 么 就 没有 冲突 。 如 果 它 没有 删除 冲突 行 然 
后 提交 ， 那 么 就 有 一 个 唯一 性 违例 。 《实际 上 只 是 等 待 另 外 那个 事务 结束 ， 然 后 在 程序 
里 重 做 可 视 性 检查 。) 


类 似 的 ， 如 果 一 个 有 冲突 的 有 效 行 被 一 个 准备 提交 的 事务 删除 ， 那 么 另外 一 个 准备 提交 
的 插入 事务 必须 等 待 该 事务 提交 或 者 退出 ， 然 后 重 做 测试 。 


此 外 ， 根 据 上 面 的 规则 报告 唯一 性 违反 前 ， 访 问 方法 必须 重新 检查 刚 被 插入 的 行 是 否 仍然 " 活 
着 "。 如 果 这 一 行 已 经 因为 事务 的 提交 而 " 死 掉 了 "， 那 么 不 应 当 发 出 任何 错误 。 (这 种 情况 不 
可 能 出 现在 插入 一 个 由 当前 事务 创建 的 行 的 普通 场景 下 。 但 是 


在 CREATE UNIQUE INDEX CONCURRENTLY 的 过 程 中 是 可 能 的 。) 


我 们 要 求索 引 访问 方法 自己 进行 这 些 测试 ， 这 就 意味 着 它 必 须 检 查 堆 ， 以 便 查 看 那些 根据 索 
引 内 容 表 明 有 重复 键 字 的 任意 行 的 提交 状态 。 这 样 做 之 无 疑问 地 很 难看 并 且 也 不 是 模块 化 

的 ， 但 是 这 样 可 以 节约 重复 的 工作 : 如 果 我 们 实施 分 离 的 探测 ， 那 么 ， 当 查找 新 行 的 索引 项 
的 插入 位 置 时 ， 必 须 重 复 对 冲突 行 的 索引 查找 。 并 且 ， 没 有 很 显然 的 方法 来 避免 竞争 条 件 ， 

除非 冲突 检查 是 插入 新 索引 项 的 整体 动作 的 一 部 分 。 


如 果 唯 一 性 约束 是 可 延期 的 ， 情 况 将 更 加 复杂 : 我 们 需要 能 够 为 新 行 插入 一 个 新 的 索引 项 ， 

但 推迟 任何 唯一 性 违反 的 错误 ， 直 到 语句 结束 甚至 更 晚 。 为 了 避免 不 必要 的 重复 搜索 索引 ， 

索引 访问 方法 应 该 在 初始 插入 时 做 一 个 初步 的 唯一 性 约束 检查 。 如 果 结 果 明 确 地 显示 没有 和 
活着 的 元 组 没有 冲突 ， 那 么 事情 已 经 完成 了 。 否则 当 需 要 实施 这 个 约束 时 ， 我 们 需要 调度 一 
个 再 检查 。 如 果 再 检查 时 ， 被 插入 的 元 组 和 有 着 相同 键 的 其 他 元 组 都 还 活着 ， 那 么 必须 报告 
tiko (为 此 ，" 活 着 "实际 上 意味 着 "在 该 索引 项 的 HOT 链 上 的 任何 一 个 元 组 还 活着 "。) 为 
了 实现 这 个 ， aminsert 图 数 被 传 入 拥有 下 列 某 一 个 值 的 checkunique 参数 : 


e UNIQUE_CHECK_NO 指示 不 检查 唯一 性 约束 (这 是 一 个 非 唯一 素 引 ) o 


e UNIQUE_CHECK_YES 指示 这 是 一 个 非 可 推迟 唯一 性 约束 ， 并 且 正 如 上 面 描述 的 必须 立即 检 
查 唯一 性 约束 。 


e ”UNIQUE_CHECK_PARTIAL 指示 这 个 唯一 性 约束 是 可 延期 的 。 PostgreSQL 将 使 用 这 种 模式 插 
入 每 一 行 的 索引 项 。 访问 方法 必须 允许 在 索引 中 插入 重复 的 项 目 ， 并 且 通 过 
让 aminsert 返回 FALSE 报 告 任何 潜在 的 重复 。 对 每 一 个 返回 FALSE 的 行 ， 一 个 延期 的 
再 检查 将 会 被 调度 。 


访问 方法 必须 识别 任何 可 能 违反 唯一 性 约束 的 行 ， 但 是 对 它 来 说 把 不 违反 唯一 性 约束 的 
行 报告 成 可 能 违反 并 不 是 一 个 错误 。 这 人 允许 不 必 等 待 其 他 事务 完成 就 可 以 完成 检查 ; 在 
这 里 被 报告 的 冲突 不 被 当成 错误 并 且 将 在 以 后 进行 再 检查 ， 那 时 冲突 可 能 已 经 消失 了 。 


© ”UNIQUE_CHECK_EXISTING 指示 这 是 对 一 个 被 报告 有 潜在 唯一 性 违反 的 行 的 被 延期 的 再 检 
查 。 尽管 是 通过 调用 aminsert 画 数 ， 这 种 情况 下 访问 方法 必须 不 能 插 和 人 新 的 索引 项 。 
相应 的 索引 项 已 经 存在 了 。 当 然 ， 访 问 方法 必须 检查 是 否 有 另 一 个 活着 的 索引 项 。 WR 
有 并 且 目 标 行 仍然 活着 的 话 报告 错误 。 


UNIQUE_CHECK_EXISTING 被 调用 时 ， 建 议 访 问 方法 进一步 去 确认 目标 行 已 经 在 素 引 中 有 一 

个 索引 项 ， 如 果 没 有 则 报错 。 这 是 个 好 的 做 法 ， 因 为 传人 aminsert 的 索引 元 组 的 值 可 能 
被 重新 计算 。 如 果 索 引 定义 涉及 不 是 真正 不 可 变 (immutable) 的 函数 ， 我 们 可 能 会 在 素 
引 中 错误 的 区 域 查找 。 检查 目标 行 可 以 在 再 检查 中 被 找到 确保 我 们 正在 扫描 原始 插入 时 
使 用 的 相同 的 元 组 值 。 


54.6. 识 引 开销 估计 函数 


系统 给 amcostestimate 一 些 描述 可 能 的 索引 扫描 的 信息 ， 包 括 一 个 WHERE 子 句 和 ORDER 
BY 子 句 的 列表 ， 这 个 子 句 列表 是 系统 认为 可 以 被 索引 使 用 的 东西 。 它 必须 返回 访问 该 索引 的 
开销 估计 值 以 及 WHERE 子 句 的 选择 性 (也 就 是 说 ， 在 索引 扫描 期 间 检索 的 将 被 返回 的 数据 行 
在 父 表 中 所 占据 的 比例 )。 对 于 简单 的 场合 ， 几 乎 开销 估计 器 的 所 有 工作 都 可 以 通过 调用 优化 
器 里 面 的 标准 过 程 完 成 ;有 amcostestimate 这 个 函数 的 目的 是 允许 索引 访问 方法 提供 和 索引 
类 型 相关 的 知识 ， 这 样 也 许可 以 改进 标准 的 开销 估计 。 


每 个 amcostestimate 加 数 都 必须 有 下 面 这 样 的 签名 : 


void 

amcostestimate (PlannerInfo *root, 
IndexPath *path, 
double loop_count, 
Cost *indexStartupCost, 
Cost *indexTotalCost, 
Selectivity *indexSelectivity, 
double *indexCorrelation); 


头 3 个 参数 是 输入 : 
root 
规划 器 的 有 关 正 在 被 处 理 的 查询 的 信息 。 
path 
被 考虑 的 索引 访问 路 径 。 除 了 开销 和 选择 性 其 他 所 有 的 域 都 是 有 效 的 。 


loop_count 


索引 扫描 的 重复 次 数 ， glace tenet oat 44 SIR FRERBUMARBHERUEL 
扫描 时 ， 通 常 它 大 于 1。 注意 开销 估算 仍然 只 是 为 了 一 次 扫描 ; 一 个 大 的 loop_count 的 意思 
在 多 次 打 描 间 进 行 某 些 缓存 可 能 是 合适 的 。 


后 面 四 个 参数 是 传递 引用 的 输出 : 


*indexStartupCost 


置 为 索引 启动 处 理 的 开销 


*indexTotalCost 


E A RSE RA 


*indexSelectivity 


置 为 索引 的 选择 性 


*indexCorrelation 


设置 为 索引 扫描 顺序 和 下 层 的 表 的 顺序 之 间 的 相关 有 效 性 

PERF (hit Awa CS, MER SQL 或 者 任何 可 用 的 存储 过 程 语言 ， 因 为 它们 必 
须 访问 规划 器 /优化 器 的 内 部 数据 结构 。 

索引 访问 开销 应 该 以 src/backend/optimizer/path/costsize.c 使 用 的 单位 进行 计算 : 一 个 顺序 
硫 盘 块 抓 取 开销 是 seq_page_cost ， 一 个 非 顺序 抓 取 开销 是 random_page_cost ， 而 处 理 一 个 
索引 行 的 开销 通常 应 该 是 cpu_index_tuple_cost 。 另外 ， 在 任何 索引 处理 期 间 调 用 的 比较 操 
作 符 ， 都 应 该 增加 一 个 数量 为 cpu_operator_cost 倍数 的 开销 (特别 是 计算 索引 条 件 
indexquals 自己 的 时 候 )。 


访问 开销 应 该 包括 所 有 和 与 扫描 索引 本 身 相 关 的 磁盘 和 CPU 开销 ， 但 是 不 包括 检索 或 者 处 理 素 
引 标 识 出 来 的 父 表 的 行 的 开销 。 


"启动 开销 "是 总 扫描 开销 中 的 这 样 一 部 分 : 在 开始 抓 取 第 一 行 之 前 ， 必 须 花 掉 的 开销 。 对 于 
大 多 数 索 引 ， 这 个 可 以 是 雾 ， 但 是 那些 启动 开销 很 大 的 索引 类 型 可 能 不 能 把 它 设 置 为 需 。 


indexSelectivity 应 该 设置 成 在 索引 打 描 期 间 ， 父 表 中 的 行 被 选 出 来 的 部 分 的 百分比 。 在 有 
损耗 的 查询 的 情况 下 ， 这 个 值 通常 比 实际 通过 给 出 的 查询 条 件 的 行 所 占 的 百分比 要 高 。 


indexCorrelation 应 该 设置 成 索引 顺序 和 表 顺 序 之 间 的 相关 性 (范围 在 -1.0 到 1.0 之 间 )。 这 
个 数值 用 于 调整 从 父 表 中 抓 取 行 的 开销 估计 。 


当 loop_count 大 于 1， 返回 的 数值 应 当 在 每 一 次 索引 打 描 之 间 平 均 。 
开销 估计 
一 个 典型 的 开销 估计 器 会 像 下 面 这 样 进行 处 理 : 


1. 基于 给 出 的 查询 条 件 ， 估 计 并 返回 父 表 中 将 被 访问 的 行 的 百分比 。 MRR RS! KA 
关 的 知识 ， 那 么 使 用 标准 的 优化 器 函数 clauselist_selectivity() : 


*indexSelectivity = clauselist_selectivity(root, path-&gt;indexquals, 
path-&gt; indexinfo-&gt;rel-&gt;relid, 
JOIN_INNER, NULL); 


2. 估计 在 打 描 过 程 中 将 被 访问 的 索引 行 数 。 对 于 许多 索引 类 型 ， 这 个 等 
于 indexSelectivity 乘 以 索引 中 的 行 数 ， 但 是 可 能 更 多 。 (请 注意 ， 索引 的 总 页 面 数 和 
行 数 可 以 从 path-&gt;indexinfo 结构 中 获得 。) 


3. 估计 在 扫描 中 将 取出 的 索引 页 面 数 量 。 这 个 可 能 就 是 indexselectivity 乘 以 索引 的 总 页 
面 数 。 


4. 计算 索引 访问 开销 。 一 个 通用 的 估计 器 可 以 这 么 干 : 


Ye 
* Our generic assumption is that the index pages will be read 
* sequentially, so they cost seq_page_cost each, not random_page_cost. 
* Also, we charge for evaluation of the indexquals at each index row. 
* All the costs are assumed to be paid incrementally during the scan. 
o/h 
cost_qual_eval(&index_qual_cost, path-&gt;indexquals, root); 
*indexStartupCost = index_qual_cost.startup; 
*indexTotalCost = seq_page_cost * numIndexPages + 
(cpu_index_tuple_cost + index_qual_cost.per_tuple) * numIndexTuples; 


不 过 ， 上 面 没有 考虑 多 次 重复 索引 扫描 中 索引 读 取 的 开销 分 排 。 


5， 估 计 索 引 的 相关 性 。 对 于 简单 的 在 单个 字段 上 的 有 序 索 引 ， 这 个 值 可 以 从 pg_statistic 中 
检索 。 如 果 相 关 性 是 未 知 ， 那 么 保守 的 估计 是 需 ( 没 有 相关 性 )。 


开销 估计 器 函数 的 例子 可 以 在 src/backend/utils/adt/selfuncs.c 里 面 找到 。 
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55.1. 介绍 


GiST 的 意思 是 通用 的 搜索 树 (Generalized Search Tree), 它 是 一 种 平衡 树 结构 的 访问 方法 ， 
在 系统 中 作为 一 个 基本 模版 ， 可 以 使 用 它 实 现任 意 索 引 模 式 。 B-trees, R-trees 和 许多 其 它 的 
索引 模式 都 可 以 用 GiST 实 现 。 


GiST 的 一 个 优点 是 ， 它 允许 伴随 相应 访问 方法 的 定制 数据 类 型 由 该 数据 类 型 领域 里 的 专家 而 
不 是 数据 库 专 家 来 开发 。 
这 里 的 有 些 信息 是 来 自 加 州 大 学 伯 克 力 分 校 的 GIST 项 目 网 站 和 Marcel Kornacker 的 论文 


Access Methods for Next-Generation Database Systems。 PostgreSQL 里 的 GiST 实 现 目前 
主要 是 TeodorSigae 和 OlegBartunov 维护 的 ， 在 他 们 的 网 站 上 有 更 多 信息 。 


55.2. 扩展 性 


传统 上 ， 实 现 一 种 新 的 索引 访问 方法 意味 着 大 量 的 艰苦 工作 。 必 须 理解 数据 库 的 内 部 工作 机 
制 ， 比 如 锁 的 机 制 和 预 写 日 志 。 GiST 接 口 有 一 个 高 层 的 抽 像 ， 只 要 求 访 问 方法 的 实现 者 实现 
被 访问 的 数据 类 型 的 语意 。 GiST 层 本 身 会 处 理 并 发 ， 日 志和 搜索 树 结构 等 任务 。 


不 要 把 这 个 扩展 性 和 其 它 标准 搜索 树 的 扩展 性 混淆 在 一 起 ， 比 如 它们 所 能 义理 的 数据 等 方 
面 。 比如 ，PostgreSQL 支 持 可 扩展 的 B-trees 和 哈 希 来 引 。 这 就 意味 着 可 以 用 PostgreSQL 
在 任意 你 需要 的 数据 类 型 上 建立 B-tree 或 哈 希 。 但 是 B-trees 只 支持 范围 谓词 

( &lt; 、 =, &gt; ), 而 哈 希 仅 支 持 相 等 查询 。 


所 以 ， 如 果 你 用 PostgreSQL B-tree 索引 了 一 个 图 像 集 ， 那 么 你 就 只 能 发 出 类 似 "图 像 x 和 
Ry 相等 吗 "、" 图 像 x 是 不 是 比 图 像 y 小 "、" 图 像 x 是 否 大 于 图 像 y" 这 样 的 查询 。 依赖 于 你 

在 这 个 环境 下 定义 的 "等 于 "、" 小 于 "、" 大 于 "的 含义 ， 上 面 这 些 查 询 可 能 有 意义 。 但 是 ， 使 用 
一 个 基于 GiST 的 索引 ， 你 可 以 创建 一 些 方法 来 提出 和 领域 相关 的 问题 ， 上 比如 " 找 出 所 有 马 的 
像 " 或 者 " 找 出 所 有 了 曝光 过 头 的 图 像 "。 


要 让 一 种 GiST 访 问 方法 跑 起 来 只 要 实现 几 个 用 户 定 义 方法 ， 这 些 方法 定义 了 树 里 面 的 键 字 的 
行为 。 当然 ， 为 了 支持 那些 怪异 的 查询 ， 这 些 方 法 也 会 相当 怪异 ， 但 是 对 于 所 有 标准 的 查询 
(B-tree, R-tree 等 )， 他 们 是 相当 直接 的 。 简单 说 ，GiST 组 合 了 扩展 性 和 通用 性 ， 以 及 代码 
复 用 和 一 个 干净 的 界面 。 


GiST 用 的 索引 操作 符 类 必须 提供 7 个 方法 ， 第 8 个 方法 是 可 选 的 。 索引 的 正确 性 通过 正确 的 实 
现 same , consistent 和 union 方法 来 确保 ,而 索引 的 效率 (大 小 和 速度 ) 依 赖 

于 penalty 和 picksplit o 剩 下 的 2 个 方法 是 compress 和 decompress ， 它 们 人 允许 索引 持 有 的 
内 部 数据 和 它 索 引 的 对 象 数据 的 类 型 不 同 。 叶子 节点 的 类 型 必须 和 被 索引 数据 相同 ， 而 其 他 
节点 可 以 是 任意 C 结 构 ( 但 是 ， 这 里 仍然 必须 遵守 PostgreSQL 中 数据 类 型 的 规则 ， 对 可 变 大 小 
数据 请 参考 varlena )。 如 果树 的 内 部 数据 类 型 在 SQL 级 别 存在 ， 可 以 

在 CREATE OPERATOR CLASS 命令 中 使 用 sToRAGE 选项 。 可 选 的 第 8 个 方法 是 distance MR 


望 操作 符 类 支持 排序 的 扫描 (最 邻近 搜索 ) ， 就 需要 提供 这 个 方法 。 


consistent 


给 定 一 个 索引 项 p 和 查询 值 9 ， 这 个 函数 决定 是 否 索 引 项 和 查询 "一 致 " ; 也 即 是 ， 对 任何 该 
索引 项 代表 的 行 ， 谓 词 " _indexed_column `、` indexable_operator q "是 否 可 能 为 真 ? 对 叶子 
索引 项 这 等 价 于 测试 索引 条 件 ， 对 内 部 树 节点 它 指示 是 否 有 必要 扫描 该 节点 代表 的 索引 子 
树 。 当 结 果 为 true ， 必 须 还 要 返回 recheck 标志 位 。 这 指示 了 谓词 是 精确 为 真 还 是 只 是 可 
能 为 真 。 如 果 recheck = false ， 索 引 已 经 精确 地 测试 了 谓词 条 件 ， BOR recheck = 

true ， 相 应 的 行 仅 仅 是 一 个 候选 匹配 。 这 种 情况 下 ， 系 统 还 将 自动 对 实际 的 行 值 进行 评 

价 _indexable_operator, 以 检查 是 否 真 的 匹配 。 这 一 规则 人 允许 GiST 同 时 支持 无 损 索引 和 有 损 
索引 。 


这 个 事 数 的 SQL 声 明 必 须 按照 如 下 方式 。 


CREATE OR REPLACE FUNCTION my_consistent(internal, data type, smallint, oid, internal) 
RETURNS bool 

AS 'MODULE_PATHNAME' 

LANGUAGE C STRICT; 


C 模 块 中 的 对 应 代码 可 以 参考 下 面 的 骨架 代码 。 


Datum my_consistent(PG_FUNCTION_ARGS) ; 
PG_FUNCTION_INFO_V1(my_consistent); 


Datum 

my_consistent(PG_FUNCTION_ARGS) 

{ 
GISTENTRY *entry = (GISTENTRY *) PG_GETARG_POINTER(0); 
data_type *query = PG_GETARG_DATA_TYPE_P(1); 
StrategyNumber strategy = (StrategyNumber) PG_GETARG_UINT16(2); 
/* Oid subtype = PG_GETARG_OID(3); */ 





bool *recheck = (bool *) PG_GETARG_POINTER(4); 
data_type *key = DatumGetDataType(entry-&gt; key); 
bool retval; 

Vis 


* 根据 strategy, key 和 query 决 定 返回 值 。 

* 使 用 GIST_LEAF(entry ) 可 以 感知 画 数 在 索引 树 的 什么 位 置 被 调用 ， 上 比如 这 在 支持 = 操作 符 时 很 方便 
* (可 以 在 非 叶 子 节点 检查 非 空 的 union( ) 和 在 叶子 节点 检测 等 价 性 )。 

*recheck = true; /* 如 果 是 精确 检查 则 为 假 */ 


PG_RETURN_BOOL(retval) ) 


这 里 ky 是 索引 中 的 一 个 元 素 ， 而 query 是 要 在 索引 中 查找 的 值 。 strategyNumber 参数 指示 
要 应 用 操作 符 类 中 的 哪个 操作 符 ， 它 必 须 是 CREATE OPERATOR CLASS 命令 指定 的 操作 符 编 号 之 
一 。 依赖 于 在 操作 符 类 中 包含 的 操作 符 ， query 的 数据 类 型 可 能 和 操作 符 不 同 ， 但 是 上 面 的 
骨架 代码 假设 不 是 这 种 情况 。 


union 


这 个 方法 用 于 合并 树 中 的 信息 。 输 入 一 个 项 目的 集合 ， 这 个 函数 生成 一 个 代表 所 有 给 定 项 目 
的 新 的 索引 项 目 。 


这 个 男 数 的 SQL 声 明 必 须 按照 如 下 方式 。 


CREATE OR REPLACE FUNCTION my_union(internal, internal) 
RETURNS internal 

AS 'MODULE_PATHNAME' 

LANGUAGE C STRICT; 


C 模 块 中 的 对 应 代码 可 以 参考 下 面 的 骨架 代码 。 


Datum my_union(PG_FUNCTION_ARGS) ; 
PG_FUNCTION_INFO_V1(my_union); 


Datum 
my_union(PG_FUNCTION_ARGS ) 


GistEntryVector *entryvec = (GistEntryVector *) PG_GETARG_POINTER(0); 
GISTENTRY *ent = entryvec-&gt;vector; 
data_type ‘out, 


int numranges, 
i = 0; 


numranges = entryvec-&gt;n; 
tmp = DatumGetDataType(ent[0].key); 
out = tmp; 


if (numranges == 1) 
{ 


out = data_type_deep_copy(tmp); 





PG_RETURN_DATA_TYPE_P(out); 


} 
for (i = 1; i &lt; numranges; i++) 
{ 
old = out; 
tmp = DatumGetDataType(ent[i].key); 
out = my_union_implementation(out, tmp); 
} 


PG_RETURN_DATA_TYPE_P(out); 





正如 你 看 到 的 ， 这 个 骨架 代码 中 我 们 义理 了 符合 union(x，Y，z) = union(union(x, Y), z) 的 
数据 类 型 。 在 GiST 支 持 方法 中 实现 适当 的 union 算 法 也 可 以 很 容易 地 支持 其 它 不 符合 这 一 条 
件 的 数据 类 型 。 


union 的 实现 豆 数 应 该 返回 一 个 由 palloc() 分 配 的 内 存 的 指针 。 不 能 简单 地 直接 返回 输入 的 
东西 。 


compress 
把 数据 项 转换 为 适合 在 索引 页 中 存储 的 格式 。 


这 个 男 数 的 SQL 声 明 必 须 按照 如 下 方式 。 


CREATE OR REPLACE FUNCTION my_compress(internal) 
RETURNS internal 

AS 'MODULE_PATHNAME' 

LANGUAGE C STRICT; 


C 模 块 中 的 对 应 代码 可 以 参考 下 面 的 骨架 代码 。 


Datum my_compress(PG_FUNCTION_ARGS) ; 
PG_FUNCTION_INFO_V1(my_compress); 


Datum 
my_compress(PG_FUNCTION_ARGS) 


GISTENTRY *entry = (GISTENTRY *) PG_GETARG_POINTER(0O); 
GISTENTRY *retval; 


if (entry-&gt;leafkey) 


/* 把 entry-&gt;key 蔡 换 为 压缩 的 版 本 */ 
compressed_data_type *compressed_data = palloc(sizeof(compressed_data_type) ); 


/* Mentry-&gt; keyi878*compressed_data */ 
retval = palloc(sizeof(GISTENTRY) ); 


gistentryinit(*retval, PointerGetDatum(compressed_data), 
entry-&gt;rel, entry-&gt;page, entry-&gt;offset, FALSE); 


} 

else 
/* 通常 不 需要 对 非 叶 子 节点 做 任何 处 理 */ 
retval = entry; 

} 


PG_RETURN_POINTER(retval) ; 


当然 ， 为 了 压缩 叶子 节点 ， 你 需要 把 _compressed_data_type_ 适 配 到 特定 的 数据 类 型 。 
根据 你 的 需求 ， 可 能 还 需要 关心 如 何 压缩 nu 值 ， 例 如 存储 为 (Datum) o, WA 
像 gist_circle_compress 那样 。 


decompress 


与 compress HAER. 把 数据 项 的 索引 表现 转换 为 可 以 被 数据 库 义 理 的 格式 。 


这 个 男 数 的 SQL 声 明 必 须 按 照 如 下 方式 。 


CREATE OR REPLACE FUNCTION my_decompress(internal) 
RETURNS internal 

AS 'MODULE_PATHNAME' 

LANGUAGE C STRICT; 


C 模 块 中 的 对 应 代码 可 以 参考 下 面 的 骨架 代码 。 


Datum my_decompress(PG_FUNCTION_ARGS) ; 
PG_FUNCTION_INFO_V1(my_decompress) ; 


Datum 
my_decompress(PG_FUNCTION_ARGS ) 


PG_RETURN_POINTER(PG_GETARG_POINTER(®@) ); 


上 面 的 骨架 代码 适合 不 需要 解压 缩 的 场合 。 


penalty 


返回 插入 新 项 目 到 特定 分 支 的 "代价 " 值 。 项 目 将 会 被 插入 到 树 中 penalty 最 小 的 路 径 。 
penalty 的 返回 值 应 该 是 非 负 数 。 如 果 返 回 了 负 数 将 会 被 当 作 0 义理 。 


这 个 男 数 的 SQL 声 明 必 须 按照 如 下 方式 。 


CREATE OR REPLACE FUNCTION my_penalty(internal, internal, internal) 
RETURNS internal 

AS 'MODULE_PATHNAME' 

LANGUAGE C STRICT; -- in some cases penalty functions need not be strict 


C 模 块 中 的 对 应 代码 可 以 参考 下 面 的 骨架 代码 。 


Datum my_penalty(PG_FUNCTION_ARGS); 
PG_FUNCTION_INFO_V1(my_penalty); 


Datum 
my_penalty(PG_FUNCTION_ARGS) 
{ 


GISTENTRY ‘*origentry = (GISTENTRY *) PG_GETARG_POINTER(@); 
GISTENTRY *newentry = (GISTENTRY *) PG_GETARG_POINTER(1); 
float *penalty = (float *) PG_GETARG_POINTER(2); 
data_type *orig = DatumGetDataType(origentry-&gt; key); 
data_type *new = DatumGetDataType(newentry-&gt; key); 


*penalty = my_penalty_implementation(orig, new); 
PG_RETURN_POINTER(penalty) ; 


penalty 图 数 对 素 引 的 性 能 非常 重要 。 在 插 和 人 阶段 ， 它 可 以 用 来 决定 把 新 增加 项 目 插 入 到 哪 
个 分 支 。 在 查询 阶段 ， 越 平衡 的 索引 ， 检 索 速 度 越 快 。 


picksplit 


如 果 需 要 分 裂 一 个 索引 页 面 的 时 候 ， 这 个 函数 决定 页 面 中 哪些 项 目 保存 在 旧 页 面 里 ， 哪 些 移 
动 到 新 页 面 里 。 


这 个 画 数 的 SQL 声明 必须 按照 如 下 方式 。 


CREATE OR REPLACE FUNCTION my_picksplit(internal, internal) 
RETURNS internal 

AS 'MODULE_PATHNAME' 

LANGUAGE C STRICT; 


C 模 块 中 的 对 应 代码 可 以 参考 下 面 的 骨架 代码 。 


Datum my_picksplit(PG_FUNCTION_ARGS) ; 
PG_FUNCTION_INFO_V1(my_picksplit); 


Datum 
my_picksplit (PG_FUNCTION_ARGS) 
{ 


GistEntryVector *entryvec = (GistEntryVector *) PG_GETARG_POINTER(0); 
OffsetNumber maxoff = entryvec-&gt;n - 1; 
GISTENTRY *ent = entryvec-&gt;vector; 
GIST_SPLITVEC *v = (GIST_SPLITVEC *) PG_GETARG_POINTER(1); 
int aly: 
nbytes; 


OffsetNumber *left, 
*right; 
data_type *tmp_union; 
data_type *unionL; 
data_type *unionkR; 
GISTENTRY **raw_entryvec; 


maxoff 
nbytes 


= entryvec-&gt;n - 1; 

= (maxoff + 1) * sizeof(OffsetNumber ); 
v-&gt;spl_left = (OffsetNumber *) palloc(nbytes); 
left = v-&gt;spl_left; 

v-&gt;spl_nleft = 0; 


v-&gt;spl_right = (OffsetNumber *) palloc(nbytes); 
right = v-&gt;spl_right; 
v-&gt;spl_nright = 0; 


unionL 
unionR 


= NULL; 

= NULL; 

/* 初始 化 项 目 数组 */ 

raw_entryvec = (GISTENTRY **) malloc(entryvec-&gt;n * sizeof(void *)); 

for (i = FirstoOffsetNumber; i &lt;= maxoff; i = OffsetNumberNext(i)) 
raw_entryvec[i] = &(entryvec-&gt;vector[i]); 


for (i = FirstoOffsetNumber; i &lt;= maxoff; i = OffsetNumberNext(i)) 


{ 
int real_index = raw_entryvec[i] - entryvec-&gt;vector; 
tmp_union = DatumGetDataType(entryvec-&gt;vector[real_index].key); 
Assert(tmp_union != NULL); 
Ar 
* 选择 放置 索引 项 目的 位 置 ， 并 相应 地 更 新 unionL 和 unionR。 
* 追加 项 目 到 v_spl_left 或 者 v_spl_right， 并 注意 处 理 计数 器 。 
BA 
if (my_choice_is_left(unionL, curl, unionR, curr)) 
if (unionL == NULL) 
unionL = tmp_union; 
else 
unionL = my_union_implementation(unionL, tmp_union); 
*left = real_index; 
++left; 
++(v-&gt;spl_nleft); 
} 
else 
{ 
Te 
* 右边 做 相同 处 理 
a 
} 
} 


v-&gt;spl_ldatum = DataTypeGetDatum(unionL) ; 
v-&gt;spl_rdatum = DataTypeGetDatum(unionR) ; 
PG_RETURN_POINTER(v); 


像 penalty —#¥, picksplit 函数 对 索引 的 性 能 也 非常 重要 ， 设计 合适 
的 penalty 和 picksplit 加 数 直接 关系 到 实现 良好 性 能 的 GiST 素 引 。 


same 


2 个 索引 项 目 等 价 时 为 真 ， 否 则 为 假 。 


X PP LAYSQL AS AA FRAT RAT. 


CREATE OR REPLACE FUNCTION my_same(internal, internal, internal) 
RETURNS internal 

AS 'MODULE_PATHNAME' 

LANGUAGE C STRICT; 


C 模 块 中 的 对 应 代码 可 以 参考 下 面 的 骨架 代码 。 
Datum my_same(PG_FUNCTION_ARGS) ; 
PG_FUNCTION_INFO_V1(my_same) ; 


Datum 
my_same(PG_FUNCTION_ARGS ) 





prefix_range *v1 PG_GETARG_PREFIX_RANGE_P(0); 
prefix_range *v2 PG_GETARG_PREFIX_RANGE_P(1); 
bool *result = (bool *) PG_GETARG_POINTER(2); 





*result = my_eq(v1, v2); 
PG_RETURN_POINTER(result); 


由 于 历史 的 原因 ， same KAHTE SAI Roa, 而 是 将 标志 位 存储 到 由 第 3 个 参数 指 
向 的 位 置 。 


distance 


给 定 一 个 索引 项 目 p 和 查询 值 9 ， 这 个 图 i ta AER 如 果 操 作 符 类 包含 任 
何 排序 的 操作 符 ， 必 须要 提供 这 个 函数 。 ee ei 可 以 实现 使 
用 了 排序 操作 符 的 查询 ， 因 此 结果 必须 和 操作 符 的 语义 一 致 。 对 一 个 叶子 索引 项 目 ， 结 果 只 
是 到 索引 项 目的 距离 ; 对 内 部 项 目 ， 结 果 必 pen nee aie 


这 个 男 数 的 SQL 声 明 必 须 按 照 如 下 方式 。 


CREATE OR REPLACE FUNCTION my_distance(internal, data type, smallint, oid) 
RETURNS float8 

AS 'MODULE_PATHNAME' 

LANGUAGE C STRICT; 


C 模 块 中 的 对 应 代码 可 以 参考 下 面 的 骨架 代码 。 


Datum my_distance(PG_FUNCTION_ARGS) ; 
PG_FUNCTION_INFO_V1(my_distance); 


Datum 
my_distance(PG_FUNCTION_ARGS) 


GISTENTRY *entry = (GISTENTRY *) PG_GETARG_POINTER(0O); 
data_type *query = PG_GETARG_DATA_TYPE_P(1); 

StrategyNumber strategy = (StrategyNumber) PG_GETARG_UINT16(2); 
/* Oid subtype = PG_GETARG_OID(3); */ 

data_type *key = DatumGetDataType(entry-&gt; key); 





double retval; 

es 

* determine return value as a function of strategy, key and query. 
w/e 


PG_RETURN_FLOAT8(retval); 


distance 图 数 的 参数 ， sg 其 他 和 consistent WAH, 一 个 叶子 节点 的 
距离 值 必须 是 精确 的 ， 因 为 一 旦 返回 了 元 组 就 没有 办 法 再 进行 排序 了 。 对 内 部 节点 允许 一 定 
程度 的 近似 ， pian ai a 个 子 节点 的 实际 距离 。 比如 ， 在 地 理应 用 中 到 矩形 边界 的 距 
离 就 足够 了 。 结果 值 可 以 是 任何 有 限 的 floats 类 型 值 。 (无 穷 和 负 无 穷 用 于 在 内 部 作为 空 
等 情况 使 用 ， 因 此 ， 不 建议 distance 返回 这 些 值 。) 


所 有 的 GiST 支 持 方法 通常 在 短 周期 内 存 上 下 文中 被 调用 ， 也 就 是 说 ， 在 每 个 元 组 被 处 理 

后 CurrentMemoryContext 都 会 被 重 置 。 因此 不 太 需 要 担心 pfree 被 palloc 出 来 的 所 有 东西 。 然 
而 ， 有 些 情况 下 ， 需 要 支持 方法 在 多 次 调用 间 绥 存 数据 。 为 了 实现 这 个 目的 ， 需 要 

在 fcinfo-&gt; flinfo-&gt; fn_mcext 中 分 配 关 生命 周期 的 数据 ， 并 且 

在 fcinfo- -&gt; flinfo-&gt;fn_extra 中 保存 其 + 指针 。 这 样 的 数据 在 索引 操 作 ( 比 如 : 单个 的 GiST 
素 引 打 描 ， 素 引 创 建 或 素 引 元 组 插入 ) 完 成 后 仍然 有 效 。 在 覆盖 fn_extra 的 值 前 要 小 心 的 
pfree 掉 先前 的 值 ， 否 则 在 操作 期 间 内 存 泄漏 会 越 积 越 多 。 


55.3. 实现 


55.3.1. 缓存 的 GiST 创 建 


通过 插入 所 有 元 组 来 创建 一 个 很 大 GiST 索 引 通 常 速度 会 很 慢 。 因为 如 果 索 引 元 组 被 分 散 到 索 
引 的 各 个 地 方 ， 并 且 索 引 因为 太 大 而 不 能 完全 放 和 人 和 缓存， 那么 插入 将 需要 触发 很 多 随机 IO。 

从 9.2 版 开始 ，PostgreSQL 支 持 更 加 高 效 的 基于 缓存 的 GiST 索 引 创 建 方法 ,这 种 方法 可 以 极 大 
地 减少 非 排序 数据 集 所 需 的 随机 IO。 但 对 于 很 好 地 排序 过 的 数据 集 ， 这 种 方法 效果 甚 微 ， 甚 
至 完全 没有 。 因为 这 种 情况 下 一 次 只 有 少量 的 页 接收 新 元 组 ， 即 使 整个 索引 不 能 放 入 缓存 ， 

这 些 页 却 可 以 完全 放 到 缓存 里 。 

但 是 ， 缓 存 的 索引 创建 需要 更 多 地 调用 penalty HA, XAAH—HKMARICPUAIER. 而 

且 ， 缓 存 的 索引 创建 使 用 的 缓存 需要 占用 临时 的 磁盘 空间 ， 最 大 为 索引 的 最 终 大 小 。 缓存 也 
可 能 影响 最 终生 成 的 索引 的 质量 ， 既 有 正面 的 也 有 负面 的 影响 。 影响 依赖 于 不 同 的 因素 ， 比 
如 输入 数据 的 分 布 和 操作 符 类 的 实现 。 


缺 省 情况 下 ， 当 索引 大 小 达到 effective_cache_ size 时 ，GiST 索 引 创建 会 切换 到 缓存 方式 。 在 
执行 CREATE INDEX 命 令 时 ， 也 可 以 通过 BUFFERING 参数 手动 打开 或 关闭 缓存 方式 。 RAT 
为 在 大 多 数 场合 都 是 合适 的 ， 但 是 如 果 输 入 的 数据 是 排 过 序 的 ， 关 闭 缓 存 可 能 多 少 会 快 一 

占 


IWNO 


55.4. 例 


PostgreSQL 的 源码 发 布 中 包含 了 一 些 使 用 GiST 实 现 的 索引 方法 的 例子 。 当前 的 核心 系统 提 
供 了 全 文 检索 支持 ( tsvector 和 tsquery 的 索引 ) 以 及 针对 一 些 内 建 的 几何 数据 类 型 ( 参 

阅 src/backend/access/gist/gistproc.c ) 的 R-Tree 等 价 的 功能 。 以 下 contrib 模块 也 包含 了 
GiST 操 作 符 类 。 


btree_gist 

针对 一 些 数据 类 型 的 B-tree 等 价 功能 
cube 

多 维 立 方 体 的 索引 


hstore 


存储 键 值 对 的 模块 


Intarray 


int4 值 的 一 维 数组 的 RD-Tree 


ltree 
树 状 结构 的 索引 
pg_trgm 


使 用 trigram 匹 配 计算 文本 的 相似 度 


seg 


" 浮 点 数 范围 "的 索引 
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56.1. 介绍 


SP-GiST 是 空间 分 割 的 (Space-Partitioned)GiST 的 省 略语 。 SP-GiST 支 持 分 区 的 搜索 树 ， 这 
有 助 于 开发 四 叉 树 ，KD 树 ， 基 数 树 (radix tree) 等 范围 广泛 的 不 同 的 非 平衡 数据 结构 。 这 些 结 
构 的 共通 特征 是 它们 反复 地 把 搜索 空间 划分 成 大 小 不 必 相 等 的 分 区 。 能 很 好 的 匹配 分 区 规则 
的 查询 会 非常 快 。 


这 些 流行 的 数据 结构 一 开始 是 被 设计 用 在 内 存 中 的 。 在 内 存 中 ， 它 们 通常 被 设计 为 由 指针 链 
接 起 来 的 动态 分 配 的 节点 的 集合 。 这 不 适合 直接 在 磁盘 上 存储 ， 因 为 这 些 指针 链 相 当 长 可 能 
需要 太 多 的 磁 角 访问 。 相对 的 ， 基 于 磁 喜 的 数据 结构 应 该 在 最 小 的 /O 上 有 很 高 的 展开 。 SP- 
GiST 要 解决 的 挑战 是 把 搜索 树 映射 到 磁 总 页 面 上 ， 通 过 这 种 方式 即使 青 历 很 多 节点 也 只 需 访 
PRD A & A Eo 


和 GiST 一 样 ，SP-GiST 人 允许 伴随 相应 访问 方法 的 定制 数据 类 型 由 该 数据 类 型 领域 里 的 专家 而 
不 是 数据 库 专家 来 开发 。 


这 里 的 有 些 信息 是 来 自 普 渡 大 学 (Purdue University) 的 SP-GiST 索 引 项 目 网 站 。 PostgreSQL 
中 的 SP-GiST 实现 目前 主要 是 Teodor Sigaev 和 Oleg Bartunov 维护 的 ， 在 他 们 的 网 站 上 有 
更 多 信息 。 


56.2. 扩展 性 


SP-GiST 提 供 了 一 个 高 度 抽 象 的 接口 ,只 需要 访问 方法 开发 人 员 实 现 特定 于 给 定数 据 类 型 的 方 
法 。SP-GiST 核 心 负责 高 效 的 磁盘 映射 和 搜索 树 结构 。 它 还 负责 考虑 并 发 性 和 日 志 记 录 。 


SP-GiST 树 的 叶 元 组 包含 和 被 索引 列 相同 数据 类 型 的 值 。 在 根 层 级 的 叶 元 组 总 是 包含 原来 的 
索引 数据 值 ,但 是 低层 级 的 叶 元 组 可 能 只 包含 一 个 压缩 表示 ,如 一 个 后 级 。 在 这 种 情况 下 ,操作 
符 类 支持 函数 必须 能 够 ， 通 过 利用 从 到 达 叶 元 组 所 经 过 的 内 部 元 组 中 收集 到 的 信息 ， 重 建 原 
始 值 。 


内 部 元 组 更 为 复 条 ,因为 它们 是 搜索 树 中 的 分 支点 。 每 个 内 部 元 组 包含 由 一 个 或 多 个 节点 组 成 
的 集合 ,表示 一 组 类 似 的 叶 元 组 值 。 一 个 节点 包含 一 个 链接 指向 另 一 个 低级 内 部 元 组 ,或 指向 一 
个 短 的 叶 元 组 的 列表 ， 这 些 叶 元 组 存储 在 相同 的 索引 页 面 中 。 每 个 节点 都 有 一 个 用 来 描述 它 
的 标签 。 例 如 ,在 一 个 基数 树 中 节点 标签 可 以 是 字符 串 值 的 下 一 个 字符 。 可 选 地 ,一 个 内 部 元 组 
可 以 有 一 个 前 级 值 ,描述 了 它 的 所 有 成 员 。 在 基数 树 中 这 可 能 是 其 所 代表 的 字符 串 的 共同 前 

级 。 前 级 值 不 一 定 真 的 是 一 个 前 级 ,可 以 是 操作 符 类 所 要 求 的 任何 数据 。 例如 ,在 四 叉 树 中 它 
可 以 存储 可 度量 四 个 象限 的 中 心 点 ， 四 叉 树 的 内 部 元 组 也 就 会 相应 的 存储 四 个 节点 ， 每 个 代 
表 了 这 个 中 心 点 周围 的 一 个 象限 。 


一 些 树 算法 需要 知道 当前 元 组 的 层级 (或 深度 ), 所 以 SP-GiST 核 心 为 操作 符 类 提供 了 在 向 下 访问 
树 时 管理 层级 计数 的 能 力 。 并 且 也 支持 在 需要 时 递增 地 重建 所 代表 的 值 。 


Note: SP-GiST 核 心 代 码 考虑 了 null 条 目 。 尽管 SP-GiST 索 引 为 被 索引 列 中 的 null 值 存储 
了 的 条 目 ,但 这 对 索引 操作 符 类 代码 是 隐藏 的 :null 索 引 条 目 或 搜索 条 件 不 会 被 传递 给 操作 
符 类 的 方法 。 (假定 SP-GiST 操 作 符 是 严格 的 ,因此 不 能 在 null 值 上 匹配 成 功 。) 因 此 后 面 也 
就 不 会 再 讨论 null 值 的 问题 了 。 

















一 个 用 于 SP-GiST 的 索引 操作 符 类 必须 提供 五 个 用 户 定义 的 方法 。 所 有 五 个 方法 按照 约定 接 
受 两 个 internal 参数 ， 第 一 个 参数 是 一 个 指向 包含 了 支持 方法 的 输入 值 的 C 结 构 体 的 指针 ， 
而 第 二 个 参数 是 一 个 指向 放置 输出 值 的 C 结 构 体 的 指针 。 其 中 四 个 方法 只 是 返回 void, 因 为 它们 
所 有 的 结果 都 出 现在 输出 结构 体 里 ;但 leaf_consistent 返回 一 个 布尔 结果 。 这 些 方法 不 能 修改 
全 人 结构 体 中 的 任何 域 。 在 所 有 情况 下 ， 在 调用 用 户 定义 的 方法 之 前 ， 输 出 结构 体 的 内 容 被 
用 初始 化 为 0。 

五 个 用 户 定义 的 方法 如 下 : 

config 


回 关 于 索引 实现 的 静态 信息 ,包括 前 级 的 数据 类 型 OID 和 节点 标签 的 数据 类 型 。 


WR 
EXER AYS QL E BA Ws 25 Ba ERR i: 


CREATE FUNCTION my_config(internal, internal) RETURNS void ... 


第 一 个 参数 是 一 个 指向 C 结 构 体 spgconfigin AHAH GARAGE. ALTAE 
个 指向 C 结 构 体 spgconfigout 的 指针 ,该 范 数 必须 填充 结果 数据 到 里 面 。 


typedef struct spgConfigIn 


Oid attType; /* Data type to be indexed */ 
} spgConfigIn; 


typedef struct spgConfigOut 


Oid prefixType; /* Data type of inner-tuple prefixes */ 

Oid labelType; /* Data type of inner-tuple node labels */ 
bool canReturnData; /* Opclass can reconstruct original data */ 
bool longValuesOK; /* Opclass can cope with values &gt; 1 page */ 


} spgConfigOut; 
传递 attType 是 为 了 支持 多 态 索 引 操 作 符 类 。 对 普通 固定 数据 类 型 操作 符 类 , 它 将 总 是 有 相同 
的 值 ,因此 可 以 忽略 。 


对 于 不 使 用 前 组 的 操作 符 类 ，prefixType 可 以 被 设置 成 vorporp 。 同样 ,对 不 使 用 节点 标签 的 
操作 符 类 ， labelType 可 以 被 设置 成 VOIDOID o 如 果 操 作 符 类 能 够 重建 最 初 提 供 的 索引 

44, canReturnData 应 设置 为 true。 RAY attType 是 可 变 长 类 型 并 且 操 作 符 类 能 够 通过 反复 
的 添加 后 级 分 割 很 长 的 值 的 时 候 ， longValuesOK 才 应 该 被 设置 为 true( 参 见 Section 56.3.1)。 


choose 
选择 一 种 方法 将 一 个 新 值 插入 到 一 个 内 部 元 组 。 
函数 的 SQL 声 明 必 须 看 起 来 像 这 样 : 


CREATE FUNCTION my_choose(internal, internal) RETURNS void ... 


第 一 个 参数 是 一 个 指向 C 结 构 体 spgchoosein WH CARA AA AE. 第 二 个 参数 是 一 
个 指向 C 结 构 体 spgchooseout 的 指针 ,该 画 数 必须 填充 结果 数据 到 里 面 。 


typedef struct spgChooseIn 


Datum datum; /* original datum to be indexed */ 
Datum leafDatum; /* current datum to be stored at leaf */ 
int level; /* current level (counting from zero) */ 


/* Data from current inner tuple */ 


bool allTheSame; /* tuple is marked all-the-same? */ 

bool hasPrefix; /* tuple has a prefix? */ 

Datum prefixDatum; /* if so, the prefix value */ 

int nNodes; /* number of nodes in the inner tuple */ 
Datum *nodeLabels; /* node label values (NULL if none) */ 


} spgChooseIn; 


typedef enum spgChooseResultType 


{ 
spgMatchNode = 1, /* descend into existing node */ 
spgAddNode, /* add a node to the inner tuple */ 
spgSplitTuple /* split inner tuple (change its prefix) */ 


} spgChooseResultType; 


typedef struct spgChooseOut 


{ 
spgChooseResultType resultType; /* action code, see above */ 
union 
{ 
struct /* results for spgMatchNode */ 
{ 
int nodeN; /* descend to this node (index from 0) */ 
int levelAdd; /* increment level by this much */ 
Datum restDatum; /* new leaf datum */ 
} matchNode; 
struct /* results for spgAddNode */ 
{ 
Datum nodeLabel; /* new node's label */ 
int nodeN; /* where to insert it (index from 0) */ 
} addNode; 
struct /* results for spgSplitTuple */ 
{ 
/* Info to form new inner tuple with one node */ 
bool prefixHasPrefix; /* tuple should have a prefix? */ 
Datum prefixPrefixDatum; /* if so, its value */ 
Datum nodeLabel; /* node's label */ 
/* Info to form new lower-level inner tuple with all old nodes */ 
bool postfixHasPrefix; /* tuple should have a prefix? */ 
Datum postfixPrefixDatum; /* if so, its value */ 
} splitTuple; 
result; 


} spgChooseout ; 


datum 是 被 插入 到 索引 的 原始 数据 。 leafDatum 最 初 和 datum 是 一 样 的 ， 如 果 画 

数 choose 或 者 picksplit 把 它 修 改 了 ， 在 树 的 低层 级 可 能 会 不 同 。 当 插 入 搜索 到 达 叶 页 面 ， 
当前 的 leafpatum 值 就 是 存储 到 新 生成 的 叶 元 组 中 的 值 。 level 是 当前 内 部 元 组 的 层级 ， 从 
0， 也 就 是 根 的 层级 ， 开 始 计数 。 如 果 当 前 内 部 元 组 包含 多 个 等 价 节点 ， allThesame 为 
true( 参 见 Section 56.3.3)。 如 果 当 前 内 部 元 组 包含 前 级 ， hasPrefix Atrue. 此 

时 ， prefixpatum 是 前 级 值 。 nNodes 是 内 部 元 组 中 包含 子 节点 的 数量 ， nodeLabels 是 它们 
的 标签 值 的 数组 ,或 者 是 NULL 如 果 没 有 标签 的 话 。 


choose 图 数 可 以 确定 新 值 匹 配 一 个 现 有 的 子 节点 ,或 者 必须 添加 一 个 新 的 子 节点 ,或 者 新 值 与 
元 组 前 级 不 一 致 ,所 以 内 部 元 组 必须 分 裂 开 以 创建 一 个 限制 较 少 的 前 级 。 


如 果 新 值 匹 配 的 一 个 现 有 的 子 节点 ,把 resultType 设置 为 spgMatchNode 。 把 nodeN 设置 为 那 
个 索引 节点 在 节点 数组 中 的 索引 (从 0 开始 )。 把 leveladd 设置 为 ， 由 下 降 到 那个 节点 导致 
的 level 增 量 ; 或 者 为 0 如 果 操 作 符 类 不 使 用 层级 。 把 restpatum 设置 为 和 datum 相等 的 
值 ， 如 果 操作 符 类 从 一 个 层级 到 下 一 个 层级 不 会 修改 数据 值 ; 否则 将 其 设置 为 修改 后 的 值 ， 
它 在 下 一 个 层级 被 用 作 leafDatum o 


如 果 必 须 添加 一 个 新 的 子 节点 ,把 resultType 设置 为 spgAddNode 。 设置 nodeLabel 为 新 节点 
的 标签 ,并 设置 nodeN 为 插入 位 置 在 节点 数组 中 的 索引 (从 0 开始 )。 添加 了 节点 后 ，choose HM 
将 再 次 与 被 修改 的 内 部 元 组 一 起 被 调用 ， 那 次 调用 应 该 导致 一 个 spgMatchNode 结果 。 


如 果 新 值 与 元 组 前 级 是 不 一 致 的 ,把 resultType 设置 为 spgsplitTuple 。 这 一 动作 把 所 有 现 有 
的 节点 移动 到 一 个 新 的 低层 级 的 内 部 元 组 ,并 把 现 有 内 部 元 组 替换 为 一 个 只 有 一 个 链接 到 新 的 

低层 级 内 部 元 组 的 单个 节点 的 元 组 。 设 定 prefixHasPrefix 表明 是 否 新 的 较 高 的 元 组 应 该 有 一 
个 前 级 ,如 果 是 的 话 ， 设 置 prefixPrefixpatum 为 前 级 值 。 这 个 新 的 前 级 值 必 须 比 原来 的 限制 

足够 小 以 接受 新 的 被 索引 值 ,而 且 应 当 不 超过 原 前 级 的 长 度 。 设置 nodeLabel 为 指向 新 的 低层 
级 内 部 元 组 的 节点 的 标签 值 。 设 定 postfixHasPrefix 表明 是 否 新 的 较 低 的 元 组 应 该 有 一 个 前 
组 ,如 果 是 的 话 ， 设 置 postfixPrefixpatum 为 前 级 值 。 这 两 个 前 级 和 额外 的 标签 的 组 合 必须 与 
原始 前 级 具有 相同 的 含义 ,因为 没有 机 会 改变 被 移动 到 新 的 低层 级 元 组 中 的 节点 标签 ， 也 不 能 

改变 任何 子 索 引 条 目 。 节点 被 分 裂 后 ，choose 会 被 再 次 调用 ， 针 对 替换 的 内 部 元 组 。 那 个 调 

用 通常 会 导致 spgAddNode 结果 ,因为 分 裂 步骤 添加 的 节点 标签 可 能 不 会 匹配 新 值 ; 所 以 在 那 之 
后 ,还 会 有 第 三 次 调用 ,最 后 的 调用 返回 spgMatchNode ,人 允许 插入 操作 下 去 到 叶 层 级 。 


picksplit 
决定 如 何在 一 组 叶 元 组 之 上 创建 一 个 新 的 内 部 元 组 。 
男 数 的 SQL 声 明 必 须 看 起 来 像 这 样 : 


CREATE FUNCTION my_picksplit(internal, internal) RETURNS void ... 


第 一 个 参数 是 一 个 指向 C 结 构 体 spgPicksplitin 的 指针 ,包含 画 数 的 输入 数据 。 第 二 个 参数 是 
一 个 指向 C 结 构 体 spgpPicksplitout 的 指针 ,该 函数 必须 填充 结果 数据 到 里 面 。 


typedef struct spgPickSplitIn 
{ 


int nTuples; /* number of leaf tuples */ 
Datum *datums; /* their datums (array of length nTuples) */ 
int level; /* current level (counting from zero) */ 


} spgPickSplitIn; 


typedef struct spgPickSplitoOut 


bool hasPrefix; /* new inner tuple should have a prefix? */ 
Datum prefixDatum; /* if so, its value */ 

int nNodes; /* number of nodes for new inner tuple */ 

Datum *nodeLabels; /* their labels (or NULL for no labels) */ 

int *mapTuplesToNodes; /* node index for each leaf tuple */ 

Datum *leafTupleDatums; /* datum to store in each new leaf tuple */ 


} spgPickSplitout; 


nTuples oe a datums 是 数据 值 的 数组 。 level 是 所 有 的 叶 元 组 共享 的 
当前 层级 ,这 将 成 为 新 的 内 部 元 组 的 层级 。 


hasPrefix 表明 是 否 新 的 内 部 元 组 应 该 有 一 个 前 级 ,如 果 是 的 话 设置 prefixDatum 前 级 值 。 
nNodes 表明 新 内 部 元 组 将 包含 的 节点 数量 ,并 设置 nodeLabels 为 它们 的 标签 值 的 数组 。 (如 果 
节点 不 需要 标签 ,设置 nodeLabels 为 NULL; 有 关 详 细 信 息 , 请 参见 Section 56.3.2。) ik 

i mapTuplesToNodes 为 各 个 叶 元 组 应 该 被 分 配 的 节点 的 索引 (从 0 开始 ) 的 数组 。 设 

i& leafTuplepatums 为 存储 在 新 的 叶 元 组 的 值 的 数组 (如 果 操 作 符 类 从 一 个 层级 到 下 一 个 层级 
不 修改 数据 ,它们 将 和 输入 数据 相同 )。 SER, picksplit 函数 负责 分 配 (palloc) nodeLabels , 


mapTuplesToNodes 和 leafTupleDatums 数组 。 


如 果 提 供 了 不 止 一 个 叶 元 组 ,预计 picksplit 豆 数 会 把 它们 分 类 到 多 个 节点 ,否则 不 可 能 把 叶 元 
组 分 和 裂 到 多 个 页 面 ,这 是 这 个 操 dn A 因此 ,如 果 picksplit HAW Xess ak 
在 同一 节点 ,核心 SP-GiST 代 码 将 覆盖 这 一 决定 并 生成 一 个 内 部 元 组 ， 这 些 叶 元 组 会 被 随机 分 
配 到 这 EA daa O 这 样 的 元 组 被 设置 

了 allThesame 标志 ， 以 表示 发 生 这 sean choose 和 inner_consistent AWA zj /J Vò 
对 待 这 样 的 内 部 元 组 。 有 关 更 多 信息 ,请 参见 Section 56.3.3, 


只 有 当 config 函数 设置 longvaluesok 为 true, 并 且 提 供 了 大 于 一 页 面 的 输入 值 时 ， 

picksplit 才 可 以 被 应 用 到 单个 叶 元 组 。 在 这 种 情况 下 操作 的 要 点 是 剥离 前 级 并 产生 一 个 新 
的 、 更 短 的 叶 数 据 值 。 这 个 调用 将 被 反复 执行 ， 直 到 叶 数 据 已 经 短 到 可 以 放 到 一 个 被 生成 的 
页 面 上 。 有 关 更 多 信息 ,请 参见 Section 56.3.1。 


inner_consistent 
返回 树 搜索 需要 继续 访问 的 节点 集合 (分 支 )。 
函数 的 SQL 声 明 必 须 看 起 来 像 这 样 


CREATE FUNCTION my_inner_consistent(internal, internal) RETURNS void ... 


第 一 个 参数 是 一 个 指向 C 结 构 体 spgInnerConsistentiIn WH 2S hans ABE. 第 二 个 
参数 是 一 个 指向 C 结 构 体 spginnerconsistentout 的 指针 ,该 男 数 必须 填充 结果 数据 到 里 面 。 


typedef struct spgInnerConsistentIn 


ScanKey scankeys; /* array of operators and comparison values */ 
int nkeys; /* length of array */ 

Datum reconstructedValue; /* value reconstructed at parent */ 
int level; /* current level (counting from zero) */ 

bool returnData; /* original data must be returned? */ 


/* Data from current inner tuple */ 


bool allTheSame; /* tuple is marked all-the-same? */ 
bool hasPrefix; /* tuple has a prefix? */ 

Datum prefixDatum; /* if so, the prefix value */ 

int nNodes; /* number of nodes in the inner tuple */ 
Datum *nodeLabels; /* node label values (NULL if none) */ 


} spgInnerConsistentIn; 


typedef struct spgInnerConsistentOut 


int nNodes; /* number of child nodes to be visited */ 
int *nodeNumbers; /* their indexes in the node array */ 

int *levelAdds; /* increment level by this much for each */ 
Datum *reconstructedValues; /* associated reconstructed values */ 


} spgInnerConsistentOut; 


长 度 为 nkeys 的 scankeys 数组 描述 了 索引 搜索 条 件 。 这 些 条 件 以 "AND" 联 接 在 一 起 ， BN, 只 
有 满足 所 有 条 件 的 索引 条 目 才能 匹配 这 个 查询 。 (注意 ,如 果 nkeys 为 0 意味 着 所 有 索引 条 目 都 
满足 查询 。 ) 通常 这 个 函数 只 关心 每 个 数组 项 目的 sk_strategy 和 sk_argument 字段 ,它们 分 别 
给 出 了 可 索引 的 操作 符 和 比较 值 。 特别 是 没有 必要 看 sk_flags 以 检查 比较 值 是 否 为 NULL, 因 
为 SP-GiST 核 心 代码 会 过 滤 掉 这 样 的 条 件 。 reconstructedvalue 是 为 父 元 组 重建 的 值 ; 如 果 
在 根 层 级 或 inner_consistent 本 数 在 父 层级 没有 提供 一 个 值 ， 它 会 是 0。 level 是 当前 内 部 
元 组 的 层级 ， 从 0， 也 就 是 根 的 层级 ， 开 始 计数 。 returnpata 为 true ， 如 果 这 个 查询 需要 重 
建 数据 的 话 ; 只 有 config WAHA T canreturndata 时 ， 才 有 可 能 是 这 样 。 allThesame 是 
true， 如 果 当 前 内 部 元 组 标记 "all-the-same"; 在 这 种 情况 下 的 所 有 节点 具有 相同 的 标签 (如 果 有 
的 话 ), 所 以 要 么 全 部 要 么 没有 一 个 匹配 这 个 查询 (参见 Section 56.3.3)。 如 果 当 前 内 部 元 组 包 
SRA, hasPrefix 为 true。 此 时 ， prefixDatum 是 前 级 值 。 nNodes 是 内 部 元 组 中 包含 子 节 
点 的 数量 ， nodeLabels 是 它们 的 标签 值 的 数组 ,或 者 是 NULL 如 果 节 点 没有 标签 。 


nNodes 必须 被 设置 为 搜索 需要 访问 的 子 节点 的 数量 , 并 且 nodeNumbers 必须 被 设置 的 它们 的 
索引 的 数组 。 如 果 操 作 符 类 跟踪 层级 ,设置 levelAdds 为 向 下 访问 到 每 个 节点 时 层级 增 量 的 数 
组 。 (通常 这 些 增 量 对 所 有 节点 是 相同 的 ,但 这 并 不 一 定 是 这 样 ,所 以 使 用 一 个 数组 )。 如 果 需 
重建 数据 值 ,设置 reconstructedvalues 为 每 个 要 访问 的 子 节点 的 重建 值 的 数组 ;否则 , 保 

持 reconstructedvalues 为 NULL。 注意 ,inner_consistent WA #DBC(palloc) 


nodeNumbers ， levelAdds 和 reconstructedValues 数组 。 


leaf_consistent 


如 果 叶 元 组 满足 查询 返回 true。 
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CREATE FUNCTION my_leaf_consistent(internal, internal) RETURNS bool ... 


第 一 个 参数 是 一 个 指向 Cz 吉 构 体 spgLeafConsistentIn 的 指针 ， Qe LAY 44 ABLE. 第 二 个 参 
数 是 一 个 指向 C 结 构 体 spgLeafconsistentout 的 指针 ,该 本 数 必须 填充 结果 数据 到 里 面 。 


typedef struct spgLeafConsistentIn 


ScanKey scankeys; /* array of operators and comparison values */ 
int nkeys; /* length of array */ 

Datum reconstructedValue; /* value reconstructed at parent */ 
int level; /* current level (counting from zero) */ 

bool returnData; /* original data must be returned? */ 

Datum leafDatum; /* datum in leaf tuple */ 


} spgLeafConsistentIn; 
typedef struct spgLeafConsistentout 


Datum leafValue; /* reconstructed original data, if any */ 
bool recheck; /* set true if operator must be rechecked */ 
} spgLeafConsistentOut; 


长 度 为 nkeys BY scankeys 数组 描述 了 索引 搜索 条 件 。 这 些 条 件 以 "AND" 联 接 在 一 起 ， 即 ， 只 
有 满足 所 有 条 件 的 素 引 条 目 才能 匹配 这 个 查询 。 (注意 ,如 果 nkeys 为 0 意味 着 所 有 索引 条 目 都 
满足 查询 。 ) 通常 这 个 函数 只 关心 每 个 数组 项 目的 sk _strategy 和 sk_argument 字段 ,它们 分 别 

给 出 了 可 索引 的 操作 符 和 比较 值 。 特别 是 没有 必要 看 sk_flags 以 检查 比较 值 是 否 为 NULL, 因 
为 SP-GiST 核 心 代码 会 过 滤 掉 这 样 的 条 件 。 reconstructedvalue 是 父 元 组 重建 的 值 ; 如 果 在 
根 层 级 或 inner_consistent 酌 数 在 父 层 级 没有 提供 一 个 值 ， 它 会 是 0。 level 是 当前 叶 元 组 
的 层级 ， 从 0， 也 就 是 根 的 层级 ， 开 始 计 数 。 returnpata 为 true ， 如 果 这 个 查询 需要 重建 数 
据 的 话 ; 只 有 config KAUPAT canReturnpata 时 ， 才 有 可 能 是 这 样 。 leafDatum 是 存储 在 
当前 叶 元 组 中 的 键 值 。 


如 果 这 个 叶 元 组 匹配 查询 ， 这 个 函数 必须 返回 true ,否则 返回 false. 在 true 的 情况 下 ,如 
FR returnpata 是 true, 那么 leafvalue 必须 被 设置 为 最 初 提供 的 这 个 叶 元 组 索引 的 值 。 如 
果 匹 配 是 不 确定 的 ，recheck 也 被 设置 为 true ， 因 此 操作 符 必 须 被 重新 应 用 到 实际 的 堆 元 组 
上 以 验证 匹配 。 


所 有 SP-GiST 支 持 方法 通常 在 一 个 短期 的 内 存 上 下 文中 被 调用 ;也 就 是 说 , 在 处 理 每 一 个 元 组 
后 CurrentMemoryContext 将 被 重 置 。 因此 不 太 需 要 担心 地 去 pfree 你 palloc 出 来 的 所 有 东西 。 

( config 方法 是 一 个 例外 : 它 应 该 尽量 避免 内 存 泄露 。 但 通常 config 方法 除了 把 常数 赋值 到 
传递 过 来 的 结构 体 中 外 ， 其 它 什 么 也 不 需要 做 。) 


如 果 被 索引 列 是 一 个 collatable 数 据 类 型 ,该 索引 排序 规则 将 被 传递 给 所 有 的 支持 方法 ,使 用 标准 


的 PG_GET_COLLATION() 机 制 。 


56.3.1. SP-GiST 的 限制 


单个 的 叶 元 组 和 内 部 元 组 必须 容纳 在 一 个 索引 页 (默认 8KB) 里 。 AL Sele KAR 
的 值 时 ,长 值 只 能 被 像 基 数 树 这 样 的 方法 支持 ,在 树 的 每 一 层 包含 一 个 前 级 ,这 个 前 级 足够 短 ,可 
容纳 在 一 个 页 面 上 ,并 且 最 后 的 叶子 层级 包括 的 后 级 也 足够 短 以 容纳 在 一 个 页 面 上 。 操作 符 类 
只 有 准备 好 了 人 处理 这 样 的 事情 ， 才 应 该 设置 longvaluesok 为 TRUE。 否则 ,SP-GiST 核 心 将 拒 
绝 一 个 太 大 以 致 不 能 装 入 一 个 页 面 的 数据 值 的 索引 请 求 。 


同样 ,不 要 让 内 部 元 组 增长 得 过 大 以 致 不 能 容纳 在 一 个 索引 页 面 ,这 也 是 操作 符 类 的 责任 ; 这 限 
制 了 在 一 个 内 部 元 组 里 可 以 使 用 的 子 节点 的 数量 ,以 及 一 个 前 级 值 的 最 大 大 小 。 


另 一 个 限制 是 , 当 一 个 内 部 元 组 的 节点 指向 一 组 叶 元 组 ,这 些 元 组 必须 都 在 相同 的 索引 页 面 上 。 
(这 个 设计 决定 是 为 了 减少 寻 址 以 及 节省 把 这 些 元 组 联接 在 一 起 的 链接 的 空间 )。 如 果 叶 元 组 
的 集合 增 大 到 超过 一 个 页 面 ,就 会 执行 分 裂 并 插入 一 个 中 间 的 内 部 元 组 。 为 了 解决 这 个 问题 ,新 
内 部 元 组 必须 把 叶子 中 的 值 的 集合 划分 到 多 个 节点 组 。 如 果 操 作 符 类 的 picksplit HARRE 
这 样 做 ,SP-GiST 将 会 采取 Section 56.3.3 中 描述 的 非常 手段 。 


56.3.2. 没有 节点 标签 的 SP-GiST 


一 些 树 算法 在 每 个 内 部 元 组 中 使 用 固定 数量 的 节点 ; 例如 ,在 四 叉 树 中 总 是 正好 的 有 4 个 节点 ， 
它们 代表 围绕 内 部 元 组 的 中 心 点 的 四 个 象限 。 在 这 种 情况 下 代码 典型 的 通过 数值 和 节点 打 交 
道 ,没有 必要 有 显 式 的 节点 标签 。 为 了 废止 节点 标签 (从 而 节省 一 些 空间 )，picksplit KZ A 
为 nodeLabels 数组 返回 NULL。 结果 这 将 导致 随后 调用 choose 和 inner_consistent ENA 
时 ， nodeLabels 为 NULL。 原则 上 ,节点 标签 可 用 于 一 些 内 部 元 组 ， 而 在 相同 索引 的 其 它 元 组 
上 省 略 。 


当 使 用 一 个 包含 无 标签 节点 的 内 部 元 组 时 ，choose MAURE] spgAddNode 是 错误 的 , 因为 在 这 种 
情况 下 ， 节 点 的 集合 被 假定 为 固定 的 。 同样 也 没有 在 spgsplitTuple 动作 中 产生 无 标签 节点 
的 条 款 ， 因 为 预计 将 需要 一 个 spgAddNode 动作 。 


56.3.3. "All-the-same" 内 部 元 组 


如 果 操 作 符 类 的 picksplit 男 数 不 能 把 提供 的 叶子 值 划分 到 至 少 两 个 分 类 中 ， SP-GiST 核 心 
可 以 覆盖 picksplit HAER 如 果 发 生 了 这 种 事情 ,包含 多 个 节点 的 新 的 内 部 元 组 会 被 创 
建 。 每 个 节点 的 标签 都 和 picksplit 给 一 个 节点 使 用 的 标签 相同 (如 果 有 的 话 ), 并 且 叶 值 被 随 


机 划分 到 这 些 等 价 节 点 中 。 allthesame 标志 会 被 设置 到 这 个 内 部 元 组 上 ， 以 警告 choose 和 
inner_consistent PY BLIX 个 元 组 可 能 没有 它们 期 望 的 节点 集合 。 


当 义 理 一 个 allTheSame 元 组 ，choose 的 结果 spgMatchNode 被 解释 为 新 的 值 可 以 被 分 配 到 任何 
等 价 节点 ;核心 代码 将 忽略 提供 的 noden 值 并 随机 的 进入 其 中 一 个 节点 (以 保持 树 的 平衡 )。 
choose 返回 spgAddNode 是 错误 的 ， 因 为 将 使 这 些 节 点 不 再 是 所 有 都 等 价 。 如 果 要 插入 的 值 
不 匹配 现 有 的 节点 ， 必 须 使 用 spgsplitTuple 动作 。 


当 义 理 一 个 alltheSame 元 组 ，inner_consistent 贺 数 应 该 返回 所 有 或 没有 一 个 节点 作为 继续 索 
引 搜 索 的 目标 ,因为 他 们 都 是 等 价 的 。 这 可 能 需要 也 可 能 不 需要 任何 特殊 的 代码 ,这 取决 
于 inner_consistent 图 数 通常 假设 了 多 少 节点 的 含义 。 


56.4. 例 


PostgreSQL 源 码 发 布 包括 几 个 SP-GiST 索 引 操作 符 类 的 例子 。 目前 核心 系统 提供 了 文本 列 上 
的 基数 树 和 点 的 两 种 树 类 型 :四 又 树 和 KD 树 。 如 果 要 查看 代码 ， 可 进 


人 src/backend/access/spgist/ 。 
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57.1. 介绍 


GIN 的 意思 是 通用 倒 排 素 引 (Generalized Inverted Index), GIN 被 设计 用 于 这 样 一 种 情况 : 被 
索引 项 是 组 合 值 ， 而 被 索引 人 处理 的 查询 需要 搜索 出 现在 这 些 组 合 值 中 的 元 素 值 。 比如 ， 项 目 
可 能 是 文档 ， 查 询 可 以 是 搜索 包含 多 个 特定 单词 的 文档 。 


我 们 使 用 项 目 这 个 词 指 代 被 索引 的 组 合 值 ， 键 指 代 一 个 元 素 值 。 GIN 本 身 总 是 存储 和 搜索 
键 ， 而 不 是 项 目 值 。 


GIN 索 引 存 储 一 系列 (key, posting list) 对 ， 这 里 的 posting list 是 一 组 出 现 键 的 行 |D。 每 一 个 被 
索引 的 项 目 都 可 能 包含 多 个 键 ， 因 此 同一 个 行 ID 可 能 会 出 现在 多 个 posting list 中 。 每 个 键 值 
只 被 存储 一 次 ， 因 此 在 相同 的 键 出 现在 很 多 项 目的 情况 下 ，GIN 索 引 是 非常 紧凑 的 。 


GIN 索 引 之 所 以 是 通用 的 ， 是 因为 GIN 访问 方法 不 需要 了 解 它 所 加 速 的 操作 。 取而代之 的 
是 ， 它 使 用 为 特殊 数据 类 型 定义 的 定制 策略 。 策略 定义 了 如 何 从 被 索引 项 目 和 查询 条 件 中 抽 
出 键 ， 以 及 如 何 决 定 包含 了 查询 中 一 些 键 的 一 行 是 否 确实 满足 查询 条 件 。 


GIN 的 一 个 优点 是 它 人 允许 由 领域 专家 而 不 是 由 数据 库 专家 来 开发 附带 适当 的 访问 方法 的 自 定 
义 数据 类 型 。 这 一 点 与 使 用 GiST 很 相似 。 


PostgreSQL 中 的 GIN 实现 主要 由 Teodor Sigaev 和 Oleg Bartunov 维护 。 关于 GIN 的 更 多 信 
息 可 以 访问 他 们 的 网 站 。 


57.2. 扩展 性 


GIN 接 口 有 一 个 高 层次 的 抽象 ， 仅 要 求实 现 被 访问 数据 类 型 的 语义 即 可 。 GIN 层 自身 可 以 义理 
并 发 操作 、 记 录 日 志 、 搜 索 树 结构 。 


定义 一 个 GIN 访 问 方法 所 要 做 的 所 有 事情 就 是 实现 四 个 (或 五 个 ) 用 户 定义 的 方法 ， 这 些 方法 定 
义 了 键 在 树 中 的 行为 、 键 与 键 之 间 的 关系 、 被 索引 的 项 目 、 能 够 使 用 索引 的 查询 。 简 而 言 
之 ，GIN 将 扩展 性 与 普 豆 性、 代码 重用 、 清 晰 的 接口 结合 在 了 一 起 。 


一 个 GIN 索 引 操 作 符 类 必须 实现 的 四 个 方法 如 下 : 


int compare(Datum a, Datum b) 


hak my 4a (RERR SIR A)ARE-—T)F, SFRAFSHN A, DURT — Me 
小 于 、 等 于 或 大 于 第 二 个 键 。 NULL 的 键 永远 不 会 被 传 入 这 个 图 数 。 


Datum *extractValue(Datum itemValue, int32 *nkeys, bool **nullFlags) 


给 定 一 个 被 索引 的 项 目 ， 返 回 一 个 对 应 的 由 palloc 分 配 的 键 的 数组 。 返 回 的 键 的 数目 必须 存储 
在 *nkeys 中 。 如 果 任 何 键 可 能 为 NULL， 还 要 palloc 一 个 包含 *nkeys 个 bool 元 素 的 数组 ， 
将 地 址 存储 到 “*nullFlags ， 并 且 根 据 需要 设置 NULL 值 。 如 果 所 有 键 都 是 非 NULL 的 ， 可 以 
jk *nullFlags 保持 为 NULL ( 它 的 初始 值 ) 。 如 果 输 入 的 项 目 不 包 含 任何 键 ， 返 回 值 可 以 


WA NULL o 


Datum *extractQuery(Datum query, int32 *nkeys, StrategyNumber n, bool **pmatch, Pointer **: 


给 定 一 个 被 查询 的 值 ， 返 回 一 个 对 应 的 palloc 分 配 的 键 数组 。 也 就 是 说 ， query 是 可 索引 操 
作 符 右 侧 的 值 ， 而 该 操作 符 左 侧 是 被 索引 的 字段 。 n 是 操作 符 类 中 的 操作 符 策略 号 (参见 
Section 35.14.2)。 通常 ， extractQuery 需要 考量 n 来 决定 query 的 数据 类 型 以 及 提取 键 值 
的 方法 。 返回 的 数组 的 元 素 个 数 必须 存放 在 *nkeys 中 。 如 果 任 何 键 可 能 为 NULL， 还 要 
palloc 一 个 包含 *nkeys 个 bool 元 素 的 数组 ， 将 地 址 存储 到 *nullFlags , 并 且 根 据 需要 设置 
NULL 值 。 如 果 所 有 键 都 是 非 NULL 的 ， 可 以 让 *nullFlags 保持 为 NULL ( 它 的 初始 值 ) 。 如 
R query 不 包含 任何 键 ， 返 回 值 可 以 为 NULL o 


SearchMode 是 一 个 输出 参数 ， 它 人 允许 extractQuery 指定 一 些 关 于 如 何 执行 搜索 的 细节 。 如 
果 *searchMode 被 设置 成 GIN_SEARCH_MODE_DEFAULT (这 也 是 调用 画 数 前 它 被 初始 化 的 值 )， 只 
有 匹配 至 少 一 个 返回 的 键 才 能 被 认为 是 候选 的 匹配 。 如 果 *searchMode 被 设置 
成 GIN_SEARCH_MODE_INCLUDE_EMPTY ， 除了 包含 至 少 一 个 匹配 的 键 的 项 目 ， 根 本 不 包含 任何 键 
的 项 目 也 被 视 为 候选 的 匹配 。 (这 个 模式 对 于 实现 像 “ 是 否 是 子 集 ” 这 样 的 操作 是 有 用 的 ) 如 
果 *searchMode 被 设置 成 GIN_sEARCH_MoDE_ALL ， 索引 中 所 有 非 NULL 的 项 目 都 被 认为 是 候选 
的 匹配 ， 不 管 它 们 是 否 匹 配 返 回 的 键 中 的 任何 一 个 。 (这 个 模式 比 起 其 它 两 个 要 慢 很 多 ， 


为 它 必须 要 打 描 整个 素 引 ， 但 这 对 正确 的 实现 边界 条 件 可 能 是 必要 的 。 一 个 需要 这 种 模式 的 
操作 符 在 大 多 数 时 候 很 可 能 不 是 一 个 好 的 GIN 操 作 符 类 的 候选 。) 用 于 设置 这 个 模式 的 符号 
定义 在 access/gin.h 中 。 


pmatch 是 在 部 分 匹配 时 需要 用 到 的 一 个 输出 参数 。 如 果 使 用 它 ， extractQuery 必须 分 配 一 
个 有 *nkeys 个 布尔 值 的 数组 ， 并 把 数组 地 址 保存 到 *pmatcn 。 数组 的 每 个 元 素 应 该 被 设置 
为 : TRUE， 如 果 相 应 的 键 需 要 部 分 匹配 ; 或 者 FALSE， 如 果 不 是 。 如 果 *pmatch 被 设置 

为 NLL ，GIN 假 设 不 需要 部 分 匹配 。 在 函数 调用 前 这 个 值 被 初始 化 成 了 nue, 因此 ， 对 于 
不 支持 部 分 匹配 的 操作 符 类 ， 可 以 简单 的 忽略 这 个 参数 。 


extra_data 是 一 个 允许 extractQuery 传递 额外 数据 给 consistent 和 comparePartial 的 输出 
BR, 如 果 使 用 它 ， extractQuery 必须 分 配 一 个 包含 *nkeys 个 Pointer 元 素 的 数组 ， 并 把 数 
组 地 址 保存 到 *extra_data ， 然 后 把 它 想 附加 的 东西 存储 到 各 个 独立 的 指针 中 。 在 函数 调用 

前 这 个 值 被 初始 化 成 了 nu, 因此 ， 对 于 不 需要 附加 数据 的 操作 符 类 ， 可 以 简单 的 忽略 这 

个 参数 。 如 果 *extra data 被 设置 了 ， 那 么 整个 数组 会 被 传 给 consistent 方法 ， 适当 的 元 素 
会 被 传 给 comparePartial 方法 。 


bool consistent(bool check[], StrategyNumber n, Datum query, int32 nkeys, Pointer extra_da 


如 果 被 索引 项 目 满足 策略 号 为 n 的 查询 操作 符 (或 可 能 满足 ， 如 果 recheck 指 示 符 被 返回 了 的 
话 ) 返回 TRUE。 这 个 男 数 并 不 直接 访问 被 索引 项 目的 值 ， 因 为 GIN 并 没有 精确 的 把 项 目 保存 
下 来 ， 但 是 需要 知道 哪些 从 查询 中 提取 的 键 值 出 现在 给 定 的 索引 项 目 中 。 check 数组 的 长 度 
是 nkeys ， 这 与 先前 针对 这 个 query 调用 的 extractQuery 男 数 返回 的 键 值 的 数目 相同 。 如 果 
被 索引 项 目 包 含 了 相应 的 查询 键 ， check 数组 中 对 应 的 元 素 值 就 是 TRUE。 比如 ， 如 果 
(check[i] == TRUE)， 那 么 意味 着 extractauery 的 结果 数组 的 第 i 个 键 出 现在 了 索引 项 目 中 。 
考虑 到 consistent 可 能 会 用 到 ， 原始 的 query 也 被 作为 参数 传人 进来 。 与 此 相同 的 还 

有 extractQuery PAA AY queryKeys[ ] 和 nullFlags[] o extra_data 是 extractQuery exp 
返回 的 额外 数据 数组 ， 如 果 没 有 的 话 就 是 NULL 。 


当 extractQuery 在 querykeys[] 中 返回 一 个 NULL 的 键 值 ， 如 果 被 索引 项 目 包含 NULL 键 值 ， 
相应 的 check[] 中 的 元 素 是 TRUE。 也 就 是 说 ， check[] 的 语义 很 

像 IS NOT DISTINCT FROM, 如 果 需 要 知道 是 通常 值 匹 配 还 是 NULL 匹 配 ， consistent WAAI 
以 检查 相应 的 nullFlags[] 元 素 。 


成 功 执行 后 ， 如 果 对 这 个 元 组 需要 执行 查询 操作 符 是 否 匹 配 的 再 检查 ， *recheck 需要 被 设置 
为 TRUE， 如 果 索 引 测 试 已 经 是 精确 的 了 ， 则 设 为 FALSE。 也 就 是 说 ，FALSE 的 返回 值 确保 
堆 元 组 不 匹配 这 个 查询 ; 伴随 *recheck 为 FASLE 的 TRUE 的 返回 值 确保 堆 元 组 匹配 这 个 查 
询 ; 伴随 *recheck 为 TRUE 的 TRUE 的 返回 值 意味 着 堆 元 组 可 能 匹配 这 个 查询 ， 因此 需要 取 
得 这 个 堆 元 组 ， 并 通过 直接 针对 原始 的 被 索引 项 目 评估 查询 操作 符 的 方式 进行 再 检查 。 


GIN 操 作 符 类 可 以 可 选 地 提供 第 五 个 酌 数 。 


int comparePartial(Datum partial_key, Datum key, StrategyNumber n, Pointer extra_data) 


比较 一 个 部 分 匹配 查询 键 和 一 个 索引 键 。 返回 一 个 整形 值 ， 它 个 符号 代表 了 不 同 的 含义 : 小 
于 0 意味 着 索引 键 不 匹配 查询 ， 但 是 索引 扫描 应 该 继续 ; 0 意味 着 索引 键 匹 配 查 询 ; 大 于 0 指 
示 应 该 终止 索引 扫描， 因为 不 可 能 再 有 更 多 的 匹配 。 这 里 提供 了 生成 部 分 一 致 查询 的 操作 符 
的 策略 号 n ， 以 防 需要 用 它 的 语义 去 决定 何 时 终止 扫描 。 同样 

的 ， extra_data 是 extractquery 生成 的 额外 数据 数组 中 的 相应 元 素 ， 或 者 为 NULL， 如 果 没 
有 的 话 。 NULL 的 键 永远 不 会 被 传 入 这 个 图 数 。 


为 了 支持 "部 分 匹配 "查询 ， 一 个 操作 符 类 必须 提供 comparePartial 方法 ， 并 且 当 遇 到 部 分 匹 
配 查 询 时 ， 它 的 extractQuery 方法 必须 设置 pmatch 参数 。 详细 请 参考 Section 57.3.2。 


上 面 的 各 种 Datum 值 的 实际 数据 类 型 根据 操作 符 类 的 不 同 而 不 同 。 传人 到 extractValue 中 的 
项 目 值 总 是 操作 符 类 的 输入 类 型 ， 所 有 的 键 值 类 型 必须 这 个 类 的 STORAGE 类 型 。 传人 

到 extractQuery 和 consistent 的 query 参数 的 类 型 是 由 策略 号 识别 的 类 成 员 操作 符 的 右 操 
作 数 的 输入 类 型 。 它 不 需要 和 项 目 类 型 相同 ， 只 要 可 以 从 中 抽取 出 正确 类 型 的 键 值 。 


57.3. 实现 


在 内 部 ，GIN 索 引 包 含 一 个 在 键 上 构造 的 B-tree 索 引 ， 每 个 键 是 一 个 或 多 个 被 索引 项 目的 一 个 
元 素 ( 比 如 ， 一 个 数组 的 一 个 成 员 ) 。 并 且 叶 子 页 上 每 个 元 组 包含 了 或 者 堆 指 针 的 B-tree 的 一 
个 指针 (一 个 "posting tree") ， 或 者 ， 当 列表 小 到 足以 和 键 值 一 起 存储 到 一 个 索引 元 组 中 
时 ， 则 是 堆 指 针 的 一 个 简单 列表 〈 一 个 "posting list") , 


从 PostgreSQL 9.1 开 始 ，NULL 的 键 值 可 以 被 包含 到 索引 里 。 对 NULL 的 或 根 
据 extractvalue 不 包含 任何 键 的 被 索引 项 ， 占 位 符 null 被 包含 到 了 索引 中 。 这 就 允许 应 该 找 
到 空 项 目的 搜索 可 以 执行 。 


多 列 GIN 素 引 通过 在 组 合 值 ( 列 号 ， 键 值 ) 上 建立 一 个 单个 的 B-tree 实 现 。 不 同 列 的 键 值 可 以 
有 不 同 的 类 型 。 


57.3.1. GIN 快 速 更 新 技术 


由 于 倒 排 索引 的 本 质 特性 ， 更 新 一 个 GIN 索 引 可 能 会 比较 慢 。 插入 或 更 新 一 个 堆 行 可 能 导致 
许多 往 素 引 的 插入 〔 从 被 索引 项 目 中 抽取 出 的 每 一 个 键 一 个 ) 。 从 PostgreSQL 8.4 开 始 ， 
GIN 可 以 通过 插入 新 的 元 组 到 一 个 临时 的 ， 待 处 理 实体 的 未 排序 列表 ， 来 推迟 很 多 这 样 的 工 
VE, 当 表 被 vacuumed， 或 者 如 果 待 处 理 实体 的 列表 太 大 了 (大 于 work_mem) ， 这 些 实体 
被 使 用 和 初始 索引 创建 时 用 到 的 相同 的 bulk 插 入 方法 ， 移 动 到 主要 的 GIN 数 据 结 构 。 即使 把 额 
外 的 vacuum 开 销 算 进 去 ， 这 也 大 大 提升 了 GIN 索 引 更 新 的 速度 。 而 且 ， 这 种 额外 开销 的 工作 
可 以 通过 后 台 进 程 而 不 是 前 端 查询 来 处 理 。 


这 种 方法 的 主要 缺点 在 于 搜索 时 除了 常规 的 索引 还 必须 要 扫描 待 处 理 实体 的 列表 。 因此 ， 大 
的 待 处 理 实体 的 列表 会 显著 的 拖 慢 搜索 。 另 一 个 缺点 是 ， 虽 然 大 多 数 更 新 很 快 ， 一 个 导致 待 
处 理 列表 (pending list) 变 得 " 太 大 "的 更 新 将 引发 一 个 立即 的 清理 周期 ， 并 因此 比 起 其 它 更 新 会 
非常 慢 。 恰当 的 使 用 autovacuum 可 以 最 小 化 这 两 个 问题 。 


如 果 一 致 的 响应 时 间 比 更 新 速度 更 重要 ， 可 以 通过 把 GIN 索引 的 存储 人 参数 FAsTUPDATE 设置 为 
off 而 不 使 用 竺 义理 实体 。 详细 请 参考 CREATE INDEX, 


57.3.2. 部 分 匹配 算法 


GIN 可 以 支持 "部 分 匹配 "查询 。 即 : 查询 并 不 决定 单个 或 多 个 键 的 一 个 精确 的 匹配 ， 而 是 ， 可 
能 的 匹配 落 在 一 个 合理 的 狭窄 键 值 范围 内 (根据 compare 支持 函数 决定 的 键 值 排序 顺序 ) o 
此 时 ， extractQuery 方法 并 不 返回 一 个 用 于 精确 匹配 的 键 值 ， 取 而 代 之 的 是 ， 返回 一 个 要 被 


搜索 的 键 值 范 围 的 下 边界 ， 并 且 设 置 pmatch 为 true。 然后 ， 这 个 键 值 范围 被 使 
用 comparePartial 进行 扫描 。 comparePartial 必须 为 一 个 相 匹 配 的 索引 键 返回 0， 不 匹配 但 
依然 在 被 搜索 范围 内 时 返回 小 于 0 的 值 ， 对 超过 可 以 匹配 的 范围 的 索引 键 则 返回 大 于 0 的 值 。 


57.4. GIN 提 示 和 与 技巧 


创建 vs 插入 


由 于 可 能 要 为 每 个 项 目 插入 很 多 键 ， 所 以 GIN 索 引 的 插入 可 能 比较 慢 。 对 于 向 表 中 大 量 插入 
的 操作 ， 我 们 建议 先 删除 GIN 索 引 ， 在 完成 插入 之 后 再 重建 它 。 


由 于 从 PostgreSQL 8.4 开 始 可 以 使 用 延迟 索引 了 ， 这 个 建议 已 经 没有 那么 必要 了 。 (详细 请 
参考 Section 57.3.1。) 但 是 ， 对 于 非常 大 量 的 更 新 ， 最 好 还 是 先 删除 ， 而 后 再 重建 索引。 


maintenance_work_mem 


GIN 素 引 的 构建 时 间 对 maintenance _work_mem 的 设置 非常 敏感 。 它 没有 为 在 索引 创建 期 间 少 使 
用 工作 内 存 做 出 努力 。 


work_mem 


在 一 系列 往 已 有 的 启用 了 FAsTuppATE 的 GIN 索 引 的 插入 操作 期 间 ， 只 要 待 处 理 实体 列表 的 大 
小 超过 了 work_mem ， 和 有 系统 就 会 清理 这 个 列表 。 为 了 避免 可 观察 到 的 响应 时 间 的 大 起 大 落 ， 让 
待 处 理 实体 列表 在 后 台 被 清理 是 比较 合适 的 〈 比 如 通过 autovacuum) 。 前 台 清 理 操作 可 以 通 
过 增加 work_mem 或 者 更 加 激进 的 autovacuum 来 避免 。 然而 ， 扩 大 work_mem 意味 着 如 果 发 生 
了 前 台 清 理 ， 那 么 它 的 执行 时 间 将 更 长 。 

gin_fuzzy_search_limit 

开发 GIN 索 引 的 主要 目的 是 为 了 让 PostgreSQL 支持 高 度 可 伸缩 的 全 文 索引 ， 并 且 常 常会 遇见 
全 文 索引 返回 海量 结果 的 情形 。 而 且 ， 这 经 常 发 生 在 查询 高 频 词 的 时 候 ， 因 而 得 到 的 结果 集 
没什么 用 处 。 因为 从 磁盘 读 取 大 量 记 录 并 对 其 进行 排序 会 消耗 大 量 资 源 ， 这 在 产品 环境 下 是 
不 能 接受 的 (注意 ， 索 引 搜 索 本 身 是 很 快 的 )。 

为 了 易于 控制 这 种 情况 ，GIN 有 一 个 可 配置 的 返回 结果 行 数 的 软 上 限 配置 参数 
gin_fuzzy_search_limit > MAH 0 表示 没有 限制 。 如 果 设 置 了 非 需 值 ， 那 么 返回 的 结果 就 
是 从 完整 结果 集中 随机 选择 的 一 部 分 。 

" 软 "的 意思 是 实际 返回 的 结果 集 大 小 可 能 与 指定 值 稍 有 出 入 ， 具 体 取决 于 查询 以 及 系统 的 随机 
数 发 生 器 的 品质 。 


经 验 上 ， 数 千 的 值 (比如 5000 一 20000) 可 以 工作 得 很 好 。 





57.5. 限制 


GIN 假 定 可 索引 的 操作 符 是 严格 的 。 也 就 是 说 ， 对 于 NULL 项 目 值 ， extractvalue 根本 不 会 被 
调用 (取而代之 是 一 个 被 自动 创建 的 索引 实体 占 位 符 ) ; 并 且 ， 对 于 NULL 查 

询 ， extractQuery 也 根本 不 会 被 调用 (取而代之 是 这 样 的 查询 被 假定 为 不 满足 条 件 ) 。 不 
过 ， 包 含 在 非 NULL 复 合 项 目 或 查询 值 中 的 NULL 键 值 是 支持 的 。 


57.6. 例子 


PostgreSQL 的 源码 发 布 中 包含 了 tsvector 和 所 有 内 部 类 型 的 一 维 数组 的 GIN 操 作 符 类 。 
tsvector 上 的 前 级 搜 索 利用 GIN 的 部 分 匹配 特性 实现 。 以 下 contrib 模块 也 包含 了 GIN 操 作 
符 类 。 


btree_gin 
许多 数据 类 型 的 B-tree 等 价 功 能 
hstore 
存储 键 值 对 的 模块 
intarray 
对 int[] 的 增强 支持 
pg_trgm 


使 用 三 连词 (trigram) 匹配 的 文本 相似 度 计算 


Chapter 58. 数据 库 物理 存储 


Table of Contents 


58.1. 数据 库 文件 布局 
e 58.2. TOAST 

e 58.3. 自由 空间 映射 
。 58.4. 可 见 映 射 

。 58.5. 初始 化 分 支 

。 58.6. 数据 库 分 页 文件 


本 章 对 PostgreSQL 数据库 使 用 的 物理 存储 格式 提供 一 个 概述 。 


58.1. 效 据 库 文件 布局 


本 节 在 文件 和 目录 的 层次 上 描述 存储 格式 。 


传统 上 ， 数 据 库 集群 所 需要 的 配置 和 数据 文件 都 存储 在 集群 的 数据 目录 里 ， RAE 
量 PGpATA 来 引用 。 〈 用 于 定义 它 的 环境 变量 名 称 之 后 ) ”PG6DATA 的 一 个 常见 位 
值 /var/1ib/pgsql/data 。 不 同 服务 器 实例 管理 的 多 个 集群 ， 可 以 在 同一 台 机 器 上 共存 。 


PGDATA 目录 包含 一 些 子 目录 和 控制 文件 ， 在 Table 58-1 中 显示 。 除了 这 些 必要 的 东西 外 ， 集 
群 配置 文件 postgresql.conf ， pg_hba. conf 和 pg_ident.conf 通常 都 存储 在 PGDATA 这 里 。 
(尽管 PostgreSQL 8.0 和 之 后 版 本 中 ， 有 可 能 把 它们 放 在 其 他 地 方 ) 。 


Table 58-1. pepata AB 


项 
PG_VERSION 
base 
global 
pg_clog 
pg_multixact 
pg_notify 
pg_serial 
pg_snapshots 
pg_stat_tmp 
pg_subtrans 
pg_tblspc 
pg_twophase 
pg_xlog 


postmaster.opts 


postmaster.pid 


描述 
一 个 包含 PostgreSQL 主 版 本 号 的 文件 
包含 与 每 个 数据 库 对 应 的 子 目录 的 子 目 录 
包含 集群 范围 的 表 的 子 目 录 ， 比 如 pg_database 
包含 事务 提交 状态 数据 的 子 目录 
包含 多 重 事务 状态 数据 的 子 目 录 ( 使 用 共享 的 行 锁 ) 
包含 LISTEN/NOTIFY 状 态 数据 的 子 目录 
包含 已 提交 可 串 行 化 事务 信息 的 子 目 录 
包含 输出 快照 的 子 目录 
包含 临时 文件 的 统计 子 系统 的 子 目录 
包含 子 事务 状态 数据 的 子 目录 
包含 指向 表 空 间 的 符号 链接 的 子 目录 
包含 用 于 预备 事务 的 状态 文件 的 子 目录 
包含 WAL( 预 写 日 志 ) 文 件 的 子 目 录 
一 个 记录 服务 器 最 后 一 次 启动 时 使 用 的 命令 行 参 数 的 文件 
一 个 锁 文 件 ， 记录 着 当前 服务 器 主 进程 ID(PID)， 集 群 数据 目录 路 
径 ， 服 务 器 主 起 始 时 间 戳 ， 端 口号 ， Unix- 域 套 接 目 录 路 径 
(Windows t€) ， 第 一 个 有 效 listen_address(IP 地 址 或 者 * ， 如 


果 不 监 听 TCP， 则 为 空 )， 以 及 共享 内 存 段 ID， (在 服务 器 关闭 之 后 
此 文件 就 不 存在 了 ) 。 


对 于 集群 里 的 每 个 数据 库 ， 在 PGDATA``/base 里 都 有 对 应 的 一 个 子 目 录 ， 子 目 录 的 名 字 是 该 
数据 库 在 pg_database 里 的 OID。 这 个 子 目 录 是 该 数据 库 文 件 的 缺 省 位 置 ; 特别 值得 一 提 的 
=, 该 数据 库 的 系统 表 存 储 在 此 。 


每 个 表 和 索引 都 存储 在 独立 的 文件 里 ， 对 于 普通 关系 ， 这 些 文件 以 该 表 或 者 该 索引 的 jenoae 
号 命名 ， 该 号 码 可 以 在 pg_class . relfilenode 中 找到 。 但 是 对 于 临时 性 关系 ， 文 件 名 称 形 
st t` BBB_ FFF, # BBB 是 创建 文件 的 后 端 1D， 并 且 FFF 是 filenode 号 。 在 任何 情况 下 ， 除 了 主 文人 
fsm 的 文件 里 。 表 也 有 可 见 映射 _， 存 储 在 一 个 分 叉 文 件 ， 后 级 为 vm, 用 来 跟踪 那些 已 知 
没有 死 行 的 页 ， 该 可 见 映射 在 Section 58.4 进 一 步 的 描述 。 未 记录 的 表 和 索引 有 三 分 之 一 分 
支 ， 被 称 之 为 初始 化 分 支 ， 使 用 后 级 init 存储 在 分 支 中 (参阅 Section 58.5) 。 


Caution 


请 注意 ， 哩 然 一 个 表 的 filenode 通 常 和 它 的 OID 相 同 ， 但 实际 上 并 不 必须 如 此 ; 有 些 操 
作 ， 上 比如 TRUNCATE ，REINDEX ，CLUSTER 以 及 一 些 特殊 的 ALTER TABLE 形式 ， 都 可 以 改变 
filenode 而 同时 保留 OID。 避 免 假定 flenode 和 表 OID 相 同 。 还 有 ， 对 于 某 种 系统 表 包 

括 pg_class 自身 ， pg_class . relfilenode BES, 这 些 表 的 实际 的 flenode 编 号 存储 在 
低级 别 的 数据 结构 ， 并 且 可 以 使 用 pg_relation_filenode() PIKE. 


在 表 或 者 索引 超过 1 GB 之 后 ， 将 分 割 成 1GB 大 小 的 段 。 第 一 个 段 的 文件 名 和 filenode 相 同 ; 
随后 的 段 名 名 为 flenode.1, filenode.2 .… 等 等 。 这 样 的 安排 避免 了 在 某 些 平台 上 的 有 文件 大 小 
限制 的 问题 。 (实际 上 ，1GB 只 是 缺 省 的 段 大 小 。 当 构建 PostgreSQL 时 ， 可 以 使 用 配置 选 
项 --with-segsize 调整 段 大 小 。) 原则 上 ， 自 由 空间 映射 和 可 见 映射 叉 文件 可 能 需要 多 个 
段 ， 尽管 这 在 实践 中 不 可 能 发 生 。 


一 个 表 如 果 有 些 字段 里 面 可 能 存储 相当 大 的 数据 ， 那么 就 会 有 个 相关 联 的 TOAST 表 ， ATF 
储 无 法 在 表 的 数据 行 中 放置 的 超大 行 外 数据 。 如 果 有 的 话 ， pg_class . reltoastrelid 从 一 
个 表 链 接 到 它 的 TOAST 表 。 参阅 Section 58.2 获 取 更 多 信息 。 


表 的 内 容 和 索引 在 Section 58.6 中 有 讨论 。 


表 空 间 把 情况 搞 得 更 复杂 些 。 每 个 用 户 定 义 的 表 空 间 都 在 PGDATA``/pg_tblspc 目录 里 面 有 一 
个 符号 连接 ， 它 指向 物理 的 表 空 间 目 录 ( 就 是 在 CREATE TABLESPACE 命令 里 声明 的 那个 目录 )。 

这 个 符号 连接 是 用 表 空 间 的 OID 命名 的 。 在 物理 的 表 空 间 目 录 内 部 ， 有 个 依赖 PostgreSQL 
服务 器 版 本 的 命名 的 子 目 录 ， 如 PG6_9.6 201008051, (使 用 这 个 子 目 录 的 原因 是 为 了 让 后 续 
版 本 的 数据 库 不 产生 冲突 的 情况 下 ， 可 以 使 用 相同 的 create TABLESPACE 位 置 值 。) 在 有 指 

定 版 本 的 子 目录 里 ， 每 个 在 表 空间 中 有 元 素 的 数据 库 有 个 子 目 录 ， 命名 为 数据 库 的 OID。 表 
和 索引 存储 在 那个 目录 ， 使 用 filenode 命 名 方法 。 pg default 没有 通过 pg_tblspc 关联 ， 但 
是 对 应 PGDATA``/base o 类 似 的 还 有 ， pg global 没有 通过 pg_tblspc 关联 ， 而 是 对 


应 PGDATA``/global o 

pg_relation_filepath() 酌 数 用 于 显示 任何 关系 的 全 路 径 。 (相对 于 PepATA ) 蔡 代 记 住 许多 
上 述 规则 ， 它 往往 是 有 用 的 。 但 是 请 记 住 ， 这 个 函数 只 给 了 关系 主 分 叉 文件 的 第 一 部 分 的 名 
称 一 你 可 能 还 需要 一 段 数字 和 /或 fsm or vm 用 来 找到 关联 该 关系 的 所 有 文件 。 


创建 临时 文件 (对 于 操作 如 更 多 数据 于 可 适合 内 存 的 排序 ) 在 PGDATA``/base/pgsql_tmp ， 或 
如 果 表 空间 不 是 指定 的 pg default, 在 表 空 间 目 录 下 的 pgsql_tmp FAR. 临时 文件 的 名 表 
示 为 pgsql_tmp``_PPP . _NNN ， 这 里 ppp. 是 后 台 拥 有 的 PID 和 nnn 是 后 台 来 区 分 不 同 的 
临时 文件 。 





98.2. TOAST 


本 节 提 供 一 个 TOAST 的 概述 。 (超大 字段 存储 技术 ) 


因为 PostgreSQL 的 页 面 大 小 是 固定 的 (通常 是 8Kb)， 并 且 不 允许 行 跨越 多 个 页 面 ， 因 此 不 可 
能 直接 存储 非常 大 的 字段 值 。 为 了 突破 这 个 限制 ， 大 的 字段 值 被 压缩 和 /或 打 碎 成 多 个 物理 
行 。 这 些 事情 对 用 户 都 是 透明 的 ， 只 是 在 后 端 代码 上 有 一 些小 的 影响 。 这 个 技术 称 为 
TOAST。 ("切片 面包 之 后 最 好 的 东西 ")) 


只 有 一 部 分 数据 类 型 支持 TOAST 一 ( 没 必 要 在 那些 不 可 能 生成 大 的 字段 值 的 数据 类 型 强制 这 
种 额外 开销 )。 要 支持 TOAST， 数 据 类 型 必须 有 变 长 (Varlena) 表 现形 式 ， 这 个 时 候 ， 任 何 存储 
的 数值 的 头 32 位 都 是 存储 着 以 字 节 记 的 数值 的 总 长 度 (包括 长 度 本 身 )。 TOAST 并 不 约束 剩 下 
的 表现 形式 。 所 有 支持 TOAST 的 数据 类 型 之 C 级 别 的 画 数 都 必须 仔细 人 处理 TOAST 的 输入 值 。 
也 就 是 通常 是 在 对 一 个 输入 值 做 任何 事情 之 前 调用 P6_DEToAST_DATUM ; 但 是 在 某 些 情况 下 也 
存在 更 高 效 的 方法 。 


TOAST 占 用 变 长 的 关 度 字 的 两 位 (在 大 型 机 器 上 高 位 序 ， 在 小 型 机 器 上 低位 序 ) ， 因此 限制 
TOAST 数 据 类 型 任何 值 的 逻辑 大 小 为 1 GB (2<sup class="calibre28">30</sup> - 1 字 节 ) o 
当 两 位 都 是 需 时 ， 该 值 是 一 个 普通 的 非 TOAST 数 据 类 型 的 值 ， 长 度 字 的 剩 下 位 给 总 数据 大 小 
以 字 节 计 (包括 长 度 字 ) 。 当 设置 最 高 或 最 低位 ， 该 值 仅 有 一 个 字 节 头 蔡 代 通 常 的 4 字 节 头 ， 
而 剩余 的 位 给 总 数据 大 小 以 字 节 计 (包括 长 度 字 ) 。 作为 一 个 特殊 的 情况 下 ， 如 果 剩余 位 都 
ES (其 将 不 可 能 包含 自身 的 长 度 ) ， 该 值 为 一 个 指向 存储 在 TOAST 表 的 行 外 数据 。 (一 个 
TOAST 指 针 的 大 小 是 给 定 的 在 第 二 个 字 节 的 数据 。) 单字 节 头 的 值 没有 对 齐 任何 特定 的 边 
界 。 最 后 当 清除 最 高 或 最 低位 时 ， 但 是 设置 了 临近 的 位 ， 压 缩 了 数据 内 容 ， 在 使 用 前 必须 解 
压缩 。 在 这 种 情况 下 长 度 字 剩 余 位 给 压缩 数据 的 总 大 小 ， 而 不 是 原 数 据 的 。 请 注意 压缩 也 可 
能 是 行 外 数据 ， 但 是 变 长 的 头 不 会 告诉 这 是 否 发 生 一 反而 TOAST 指 针 的 内 容 告诉 这 些 。 


如 果 一 个 表 中 有 任何 一 个 字段 是 可 以 TOAST 的 ， 那么 该 表 籽 有 一 个 关联 的 TOAST 表 ， 其 OID 
存储 在 表 的 pg_class . reltoastrelid 记录 里 ， 行 外 TOAST 过 的 数值 保存 在 TOAST 表 里 ， 下 
面 有 更 详细 的 描述 。 


这 里 使 用 的 压缩 技术 是 非常 简单 并 且 非 常 快 速 的 LZ 族 压 缩 技术 。 参 
阅 src/backend/utils/adt/pg_lzcompress.c 获取 细节 。 


将 外 数据 分 割 成 (如 果 压 缩 过 ， 在 压缩 之 后 ) 最 多 TOAST_MAX_CHUNK_SIZE ( 缺 省 选择 这 个 值 ， 
2000 字 节 ， 使 4 块 行将 适合 一 内 存 页 ， 约 2000 个 字 节 ) 字 节 ， 每 个 块 都 作为 独立 的 行 在 
TOAST 表 里 为 所 属 表 存储 。 每 个 TOAST 表 都 有 chunk_id 字段 (一 个 表示 特定 TOAST 值 的 
OID), chunk_seq (一 个 序列 号 ， 存 储 该 块 在 数值 中 的 位 置 )、 chunk_data (该 块 实际 的 数 
据 )。 在 chunk_id 和 chunk_seq 上 有 一 个 唯一 索引 ， 提 供 对 数值 的 快速 检索 。 因此 ， 一 个 表 
示 行 外 TOAST 值 的 指针 数据 需要 存储 要 查阅 的 TOAST 的 OID 和 特定 数值 的 OID( 它 


BY chunk_id )。 为 了 方便 ， 指 针 数 据 还 存储 逻辑 数据 的 尺寸 (原始 的 未 压缩 的 数据 长 度 ) 以 及 实 
际 存储 的 尺寸 (如 果 使 用 了 压缩 ， 则 两 者 不 同 )。 加 上 头 部 的 长 度 字 ， 一 个 TOAST 指 针 数 据 的 
总 尺寸 是 18 字 节 ， 不 管 它 代表 的 数值 的 实际 长 度 是 多 大 。 


TOAST 代 码 只 有 在 准备 向 某 表 中 存储 超过 TOAST_TUPLE_THRESHOLD 字 节 (通常 是 2KB) 的 行 的 时 
候 才 会 触发 。 TOAST 代 码 将 压缩 和 /或 行 外 存储 字段 值 ， 直到 数值 比 ToAST_TUPLE_TARGET F 
$ (通常 是 2KB) 短 ， 或 者 无 法 得 到 更 好 的 结果 的 时 候 才 停止 。 在 一 个 UPDATE 操 作 过 程 
中 ， 未 改变 的 字段 值 通常 原样 保存 ; 所 以 ， 如 果 UPDATE 一 个 带 有 行 外 数据 的 行 时 ， 如 果 行 
外 数据 值 没有 变化 ， 那么 将 不 会 有 TOAST 开 销 存在 。 


TOAST 代 码 识别 四 种 不 同 的 存储 TOAST 字 段 的 策略 : 


e PLAIN 避免 压缩 或 者 行 外 的 存储 ;此 外 ， 它 禁止 使 用 单字 节 的 头 变 长 类 型 。 这 只 是 对 那些 
不 能 TOAST 的 数据 类 型 放 有 可 能 。 


© EXTENDED 人 允许 压缩 和 行 外 存储 。 这 是 大 多 数 TOAST 的 数据 类 型 的 缺 省 。 首 先 将 企图 进 
行 压缩 ， 如 果 行 仍然 太 大 ， 那 么 则 进行 行 外 存储 。 


e EXTERNAL 允许 行 外 存储 ， 但 是 不 许 压 缩 。 使 用 ExTERNAL , PARLE 
在 text 和 bytea 字段 上 的 子 字符 串 操作 更 快 (代价 是 增加 了 存储 空间 )， 因 为 这 些 操作 是 
经 过 优化 的 : 如 果 行 外 数据 没有 压缩 ， 那么 它们 只 会 去 抓 取 需要 的 部 分 。 


© MAIN 人 允许 压缩 ， 但 不 允许 行 外 存储 。 实际 上 ， 在 这 样 的 字段 上 仍然 会 进行 行 外 存储 ， 
但 只 是 作为 没有 办 法 把 数据 行 变 得 更 小 的 情况 下 使 之 足以 容纳 一 个 页 面 的 最 后 的 手段 。 


每 个 TOAST 的 数据 类 型 都 为 该 数据 类 型 的 字段 指定 一 个 缺 省 策略 ， 但 是 特定 表 的 字段 的 存储 
策略 可 以 用 ALTER TABLE SET STORAGE 修改 。 


这 个 方法 比 那 些 更 直接 的 方法 ， 上 比如 允许 行 值 直接 跨越 多 个 页 面 ， 有 更 多 优点 。 假 设 查 询 通 
常 是 用 相对 比较 短 的 键 值 进行 匹配 的 ， 那么 大 多 数 执行 器 的 工作 都 将 使 用 主 行 记录 完成 。 
TOAST 属 性 的 大 值 ， 只 是 在 把 结果 集 发 送 给 客户 端的 时 候 才 抽出 来 (如 果 选 择 了 它 的 话 )。 
此 ， 主 表 要 小 得 多 ， 并 且 它 的 大 部 分 行 都 存储 在 共享 缓冲 区 里 ， 因 此 就 可 以 不 需要 任何 行 外 
存储 。 排序 集 也 缩小 了 ， 并 且 排 序 将 更 多 地 在 内 存 里 完成 。 一 个 小 测试 表明 ， 一 个 用 于 保存 
HTML 页 面 以 及 它们 的 URL 的 表 ， 包 括 TOAST 表 在 内 ， 存储 将 近 一 半 大 小 的 裸 数据 ， 而 主 表 
只 包含 全 部 数据 的 10%(URL 和 一 些小 的 HTML 页 面 )。 与 在 一 个 非 TOAST 的 对 比 表 里 面 存 储 
(把 全 部 HTML 页 面 裁剪 成 7KB 以 匹配 页 面 大 小 )， 没有 任何 运行 时 的 区 别 。 


58.3. 目 由 空间 映射 


每 个 堆 和 索引 关系 ， 除 了 哈 希 索引 ， 有 个 自由 空间 映射 (FSM) 来 保持 跟踪 关系 中 可 用 的 空 
Ho 将 同时 在 独立 的 关系 叉 文件 存储 主 关系 数据 ， 以 关系 的 filenode 编号 命名 ， 加 上 一 

个 fsm 后 级 。 例如 ， 如 果 一 个 关系 的 filenode 是 12345， 存储 FSM 在 一 个 叫 12345_fsm 的 文 
FE, 在 与 主 关系 文件 相同 目录 里 。 


自由 空间 映射 组 织 为 一 个 FSM 页 树 。 FSM 页 底层 存储 每 个 堆 (或 索引 ) 页 上 可 用 的 自由 空 
间 ， 使 用 一 个 字 节 来 代表 每 一 个 如 页 。 高 级 别 的 从 低级 别 聚合 信息 。 


每 个 FSM 页 是 一 个 二 叉 树 ， 存 储 在 一 个 数组 ， 每 个 节点 一 个 字 节 。 每 个 叶 节 点 代表 一 个 堆 
页 ， 或 低级 别 的 FSM 页 。 在 每 个 非 叶 节 点 ， 存 储 其 子 节点 值 的 高 级 别 的 值 。 因此 在 根 节点 存 
储 叶 节 点 的 最 大 值 。 


参阅 src/backend/storage/freespace/README 关于 更 详细 的 FSM 是 怎样 的 结构 ， 怎样 更 新 和 搜 
索 它 。pg_freespacemap 模 块 可 以 用 来 审查 存储 在 自由 空间 映射 的 信息 。 


58.4. 可 见 映 射 


每 个 堆 关 系 有 个 可 见 映 射 (VM) 来 保持 跟踪 那些 包含 行 的 页 ， 对 于 所 有 活动 的 事务 可 见 。 同 
时 在 独立 的 关系 叉 文件 存储 主 关系 数据 ， 以 关系 的 flenode 号 ， 加 上 一 个 vm 后 级 命名 。 例 
如 ， 如 果 一 个 关系 的 filenode 是 12345， 存 储 VM 在 一 个 叫 12345_vm 文件 里 ， 与 主 关 系 文件 在 
同一 目录 。 请 注意 索引 没有 VM。 


可 见 映射 在 简单 的 在 每 个 堆 页 存储 1 位 。 一 个 设置 位 意味 着 在 页 上 所 有 的 行 对 于 所 有 事务 可 见 
的 。 这 意味 着 不 包含 任何 行 的 页 ， 需 要 清理 ; 使 用 index-only scans 回答 仅仅 使 用 索引 元 的 
查询 也 可 以 使 用 这 些 信息 。 


这 个 意义 上 的 映射 是 保守 的 ， 我 们 要 确定 每 当 设 置 位 ， 我 们 知道 条 件 是 真 ， 但 是 如 果 没 有 设 
置 位 ， 它 可 能 是 真 ， 也 可 能 不 是 真 。 通过 清理 设置 可 见 了 映射 位 ， 但 是 通过 页 上 的 任何 数据 修 
改 操 作 进行 清理 。 


58.5. 初始 化 分 支 


每 个 未 记录 的 表 ， 以 及 未 记录 表 的 每 一 个 索引 ， 有 一 个 初始 化 分 支 。 初 始 化 分 支 是 一 个 空 表 
或 相应 类 型 的 索引 。 当 一 个 未 记录 的 表 由 于 月 演 必 须 重 置 为 空 。 初始 化 分 支 被 拷贝 给 主 分 
支 ， 并 且 擦 除 任何 其 他 的 分 支 〈 根 据 需要 他 们 会 自动 重建 ) 。 


58.6. 效 据 库 分 页 文件 


本 节 提 供 一 个 在 PostgreSQL 表 和 索引 使 用 的 页 格式 的 概述 。[1] 序列 和 TOAST 表 的 格式 就 像 
一 个 普通 表 的 。 

下 面 说 明 一 下 ， 一 个 字 节 假定 为 包含 8 位 。 另 外， 术语 项 为 存储 在 页 上 的 一 个 独立 数据 值 。 
在 表 中 ， 一 项 是 一 行 ; 在 索引 中 ， 一 项 为 一 个 素 引 条 目 。 

每 个 表 和 索引 存储 为 固定 大 小 的 页 数组 。 (通常 8 KB， 不 过 当 编 译 服 务 器 的 时 候 ， 可 以 选择 
不 同 的 页 大 小 ) 在 表 中 ， 所 有 的 页 是 逻辑 等 价 的 ， 所 以 一 个 特殊 项 ( 行 ) 可 以 存储 在 任意 
页 。 在 索引 ， 第 一 页 通常 保留 为 持 有 控制 信息 的 元 页 ， 这 里 可 以 有 不 同类 型 的 索引 页 ， 依 赖 
于 索引 访问 方法 。 


Table 58-2 显 示 一 个 页 的 整体 布局 ， 这 里 每 页 有 5 部 分 。 


Table 58-2. 页 整体 布局 


项 描述 
PageHeaderData ”24 字 节 长 整 型 。 包 含 关 于 页 的 一 般 信息 ， 包 含 自由 空间 指针 。 
ltemldData 指向 实际 项 的 ( 偏 移 量 ， 长 度 ) 数组 对 。 每 项 4 字 节 。 
re poner 从 这 个 区 域 开始 分 配 新 项 指针 ， 或 从 结尾 分 配 新 项 指 
ltems 实际 项 本 身 


Special space 


索引 访问 方法 专用 数据 。 不 同方 法 存储 不 同 的 数据 。 普 通 表 里 为 
gu 


o 


每 页 的 前 24 个 字 节 构成 一 个 页 头 (PageHeaderData) 。 在 Table 58-3 有 它 的 详细 格式 。 前 
两 个 字段 跟踪 相关 页 的 最 近 的 WAL 条 目 。 下 边 的 一 个 2 字 节 的 字段 是 包含 标志 位 。 随后 由 3 个 
2 字 节 整数 字段 ( pd_lower ，pd_upper ,和 pd_special ) 。 这 些 包 含 分 别 为 从 页 开始 到 未 分 
配 空间 的 开始 ， 到 未 分 配 空间 的 结束 ， 专用 空间 的 开始 的 偏 移 字 节 数 。 下 边 页 头 的 2 字 节 ， 
pd_pagesize_version, 存储 页 大 小 和 版 本 指示 符 。 从 PostgreSQL 8.3 开 始 版 本 编号 是 4 ; 
PostgreSQL 8.1 和 8.2 使 用 版 本 编号 3 ; PostgreSQL 8.0 使 用 版 本 编号 2 ; PostgreSQL 7.3 和 
7.4 使 用 版 本 编号 1 ; 先前 发 布 版 本 使 用 版 本 编号 0。 (在 大 多 数 这 些 版 本 中 ， 基 本 的 页 布局 和 
头 格式 没有 变化 ， 但 是 堆 布 局 有 行头 .) 页 面 大 小 是 基本 上 只 存在 一 个 交叉 检查 ; 在 安装 的 版 
本 中 ， 这 里 不 支持 多 于 一 页 大 小 的 。 最 后 一 个 字段 是 个 提示 ， 显 示 是 否 整理 页 ， 可 能 是 有 利 
的 。 它 跟踪 在 页 上 最 旧 的 未 修整 的 XMAX。 


Table 58-3. PageHeaderData 布 局 


字段 类 型 描述 
8 
ut LSN: 该 页 上 xlog 日 志 记 录 变 化 的 最 后 
pd_Isn XLogRecPtr Fs 字 节 的 下 一 字 节 
2 ER 
S zr H p- 上 甘 已 
aa uinie = T 间 线 ID ( 仅 其 最 低 16 
节 
2 
pd_flags uint16 = 标志 位 
节 
2 
pd_lower LocationIndex = 到 自由 空间 开始 的 偏 移 量 
节 
2 
pd_upper Locationlndex ， 字 到 自由 空间 结尾 的 偏 移 量 
节 
2 
pd_special LocationIndex = 到 专用 空间 开始 的 偏 移 量 
节 
2 
pd_pagesize version — uint16 字 页 大 小 和 版 本 编号 布局 信息 
节 
4 = js 入 ES h Sm 
pd_prune_xid Transactionld a 页 上 最 旧 的 本 修 整 的 XMAX 如 果 没 有 
M WA 0 


在 src/include/storage/bufpage.h 可 以 找到 所 有 的 详细 信息 。 


下 面 的 页 头 是 项 标识 符 〈 itemIdpata ) ， 每 个 需要 4 字 节 。 一 个 项 标识 符 包含 一 个 到 项 开始 
的 字 节 偏 移 ， 以 字 节 计 的 长 度 ， 和 一 些 影响 它 解释 的 属性 位 。 新 项 标识 符 需 要 从 未 分 配 空间 
的 开始 分 配 。 可 以 通过 查看 pd_lower 来 确定 项 标识 符 的 数量 ， 分 配 新 的 标示 符 ， 其 会 增 
加 。 因 为 一 个 项 标示 符 从 来 不 移动 直到 释放 了 它 ， 实 际 上 ， 每 个 指针 为 PostgreSQL 所 创建 的 
一 项 由 页 号 和 项 标识 符 的 索引 构成 。 ( ItemPointer , 还 可 以 称 为 CTID ) o 


项 本 身 存储 在 从 未 分 配 的 空间 的 结尾 向 后 分 配 的 空间 。 确 切 的 结构 取决 于 包含 什么 表 。 表 和 
序列 两 都 使 用 一 个 名 为 HeapTupleHeaderData 的 结构 ， 下 面 描述 。 


后 这 段 是 "特殊 段 "其 包含 想 存 放 的 任何 访问 方法 。 例如 ，b-tree 索 引 存 储 连接 页 左右 的 兄 
， 以 及 相应 的 索引 结构 的 一 些 其 它 数 据 。 普通 的 表 根 本 没有 使 用 特殊 段 。 (通过 设 


最 
弟 
i pd_special 等 于 页 大 小 来 表示 ) 


所 有 表 行 结构 方式 相同 。 有 个 固定 大 小 的 头 〈 在 大 多 数 机 器 占用 23 字 节 ) ， 随后 一 个 NULL 
位 图 的 可 选项 ， 对 象 ID 字段 ， 和 用 户 数据 。 该 头 的 详细 信息 在 Table 58-4。 实际 的 用 户 数据 
( 行 中 列 ) 由 tho 表示 的 偏 移 量 开始 ， 它 必须 始终 是 为 平台 的 MAXALIGN 间 距 的 倍数 。 
NULL 位 图 仅 存在 ， 如 果 在 t_infomask 设置 了 HEAP_HASNULL 位 。 如 果 它 存在 ， 它 就 开始 
于 固定 头 的 后 面 ， 占 用 足够 的 字 节 ， 每 数据 列 一 位 。 (BBE, t natts 位 一 块 ) 在 这 个 位 列 
表 中 ， 一 个 1 位 标识 非 空 ， 一 个 0 位 是 空 。 对 象 ID REE, MRE t_infomask 设置 了 
HEAP HASOID 位 。 如 果 存 在 ， 它 将 出 现在 t_hoff 边 界 前 。 任 何 需 要 做 t_hoff 的 MAXALIGN 
倍数 的 填充 ， 出 现在 NULL 位 图 和 对 象 ID 之 间 。 ( 反 过 来 又 保证 对 象 ID 得 到 恰当 的 对 齐 ) 


Table 58-4. HeapTupleHeaderData 布 局 


字段 类 型 kE 描述 
t_xmin Transactionld 4 字 节 hi AXIDEX 
t_xmax Transactionld 4 字 节 删除 XID 戳 
t_cid Commandld 4 字 节 ”插入 和 /或 删除 CID 惟 (使 用 t_xvac 履 盖 ) 
t_xvac Transactionld 4 字 节 ”VACUUM 操作 移动 一 行 版 本 的 XID 
t_ctid ltemPointerData 677% ”这 个 当前 的 或 新 行 版 本 的 TID 
t infomask2 uint16 2 字 节 ”字段 个 数 ， 加 上 各 种 标志 位 
t_infomask uint16 2 字 节 ”各 种 标志 位 数 
t_hoff uint8 1 字 节 ”用 户 数据 偏 移 量 


在 src/include/access/htup.h 可 以 找到 所 有 的 详细 信息 。 


解释 实际 数据 只 能 从 其 它 表 获取 信息 来 做 ， 大 多 pg_attribute 。 需要 来 表示 字段 位 置 的 键 值 
是 attlen 和 attalign o 没有 直接 获取 特定 字段 的 方法 ， 除 仅 当 有 固定 宽度 字段 并 且 没 有 空 
值 的 情况 外 。 所 有 这 些 策略 封装 在 函数 heap_getattr，fastgetattr 和 heap_getsysattr。 


要 读 取 数据 你 需要 逐次 检查 每 个 属性 。 首 先 检查 字段 是 否 为 NULL 依 据 NULL 位 图 。 如 果 是 ， 
跳 到 下 一 个 。 然 后 确定 你 已 经 右 对 齐 。 如 果 字段 是 固定 宽度 的 字段 ， 那么 所 有 的 字 节 简单 的 
放置 。 如 果 它 是 变 长 的 字段 (attlen = -1) 那么 它 是 一 个 更 复杂 的 位 。 所 有 变 长 数据 类 型 共享 
通用 的 头 结 构 struct varlena ， 其 包括 存储 值 的 总 长 度 和 一 些 标志 位 。 依赖 这 些 标志 ， 数 据 
可 能 是 行内 或 在 一 个 TOAST 表 ; 它 也 可 能 是 压缩 的 。 (参阅 Section 58.2) 


Notes 


[1] 实际 上 ， 索 引 访问 方法 不 需要 使 用 这 个 页 格式 。 所 有 已 经 存在 的 索引 方法 需要 使 用 基本 格 
式 ， 但 是 保持 在 索引 元 页 上 的 数据 通常 不 遵循 项 布局 规则 。 


Chapter 59. BKI 后 端 接口 


Table of Contents 


。 59.1. BKI 文件 格式 

e 59.2. BKI RS 

。 59.3. 系统 初始 化 的 BKI 文 件 的 结构 
e 59.4. 例子 


后 端 接口 (BKI) 文 件 是 一 些 用 特殊 语言 写 的 脚本 ， 这 些 脚本 是 PostgreSQL 后 端 能 够 理解 的 ， 
以 特殊 的 "bootstrap" (引导 ) 模 式 运 行 ， 这 种 模式 允许 在 不 存在 系统 表 的 雳 初始 条 件 下 执行 数 
ERM, 而 普通 的 SQL 命令 要 求 系统 表 必 须 存 在 。 因 此 BKI 文件 可 以 用 于 在 第 一 时 间 创 建 
数据 库 系 统 。 (可 能 除 此 以 外 也 没有 其 它 用 处 。) 


在 创建 一 个 新 的 数据 库 集群 的 时 候 ，initdb 就 是 使 用 BKI 文件 来 完成 其 工作 的 一 部 分 。initdb 使 
用 的 输入 的 文件 是 作为 编译 和 安装 PostgreSQL 的 一 部 分 ， 由 一 个 叫 genbki.pl 的 程序 创建 

的 ， 这 个 程序 读 取 源 代 码 树 目录 的 src/include/catalog’ 目录 里 面 的 几 个 特殊 格式 的 C 头 文 
件 。 生 成 的 BKI 文 件 叫 postgres.bki 并 且 通 常安 装 在 安装 树 里 的 share 子 目 录 。 


相关 的 信息 可 以 在 有 关 initdb 的 文档 中 找到 。 


59.1. BKI 文件 格式 


本 节 描 述 PostgreSQL 后 端 是 如 何 理解 BKI 文 件 。 如 果 把 postgres.bki 文件 拿 来 做 为 例子 ， 这 
些 描述 会 变 得 容易 理解 些 。 


BKI 输 入 是 由 一 系列 命令 组 成 的 。 命 令 是 由 一 些 记号 组 成 的 ， 具体 是 什么 由 命令 语法 决定 。 记 
号 通常 是 用 空白 分 隔 的 ， 但 是 如 果 没 有 歧义 的 话 可 以 不 要 。 没有 什么 特殊 的 命令 分 陋 符 ; 语 
法 上 无 法 属于 前 面 命 售 的 记号 开始 新 的 一 条 命令 。 《通常 你 会 把 一 条 新 的 命令 放 在 新 的 一 行 
上 以 保持 清晰 。) 记号 可 以 是 某 些 关键 字 ， 特殊 字符 ( 圆 括 弧 ， 豆 号 等 )， 数 字 ， 或 者 双 引 号 

字符 串 。 所 有 东西 都 是 大 小 写 敏 感 的 。 


以 # 开头 的 行 被 忽略 。 


59.2. BKI #74 


create _tablename_ _tableoid_ [ bootstrap ][ shared_relation ] [ without_oids ] 


[ rowtype_oid _oid_]( _name1_ = typel |, _name2_ = _type2_,...]) 





创建 一 个 名 为 _tablename 并且 OID 为 _tableoid 的 表 ， 表 字段 在 圆 括 缴 中 给 出 。 


bootstrap.c 直接 支持 下 列 字 段 类 型 : bool , bytea , char (1 字 节 )， name , int2 , int4 ， 
regproc , regclass , regtype , text , oid , tid, xid , cid , int2vector , oidvector , 
_inta (2X48), _text (数组 )，_oid (数组 )，_char (数组 )，_aclitem (数组 )。 尽管 可 以 创建 包含 
其 它 类 型 字段 的 表 ， 但 是 只 有 在 创建 完 pg_type 并 且 填 充 了 合适 的 记录 之 后 才 行 。 这 实际 上 
就 意味 着 在 系统 初始 化 表 中 ， 只 能 使 用 这 些 字段 类 型 ， 而 非 系统 初始 化 表 可 以 使 用 任意 内 置 
类 型 。 


如 果 声 明了 bootstrap ， 那 么 将 只 在 磁盘 上 创建 表 ; 不 会 向 pg_class ，pg_attribute 等 系统 
表 里 面 输入 任何 东西 。 因 此 这 样 的 表 将 无 法 被 普通 的 SQL 操作 访问 ， 直到 那些 记录 用 硬 办 法 
(用 insert 命 邻 ) 填 入 。 这 个 选项 用 于 创建 pg_class 等 自身 。 


如 果 声 明了 shared_relation ， 那 么 表 就 作为 共享 表 创 建 。 除 非 声 明了 without_oids, 否则 

将 会 有 OID 。 表 的 行 类 型 OID (( pg_type OID) 可 以 可 选 的 通过 rowtype_oid 子 句 声明 ; 如 
果 没 有 声明 ， 会 自动 为 表 生 成 一 个 DID。 (如 果 声 明了 bootstrap ， 那 么 rowtype oid FAE 
没有 用 的 ， 但 是 它 可 以 在 文档 中 给 出 。) 


open _tablename_ 

打开 一 个 名 为 _tablename_ 的 表 ， 准 各 插入 数据 。 任何 当前 已 经 打开 的 表 都 会 被 关闭 。 
close [ _tablename_ ] 

关闭 打开 的 表 。 给 出 的 表 名 用 于 交叉 检查 ， 但 并 不 是 必须 的 。 


insert [ OID = _oid_value_] ( _valuet value2 ... ) 





如 果 oid value. 4S, MAM _valuet_, _value2, 等 作为 字段 值 以 及 _oid value. 作为 其 
OID( 对 象 标 识 ) 向 打开 的 表 插 入 一 条 新 记录 ， 否则 省 略 子 句 ， 而 表 则 拥有 OID ， 并 赋予 下 一 
个 可 用 的 OID 数值 。 





NULL 可 以 用 特殊 的 关键 字 _nul1l 声明。 包含 空白 的 值 必 须 用 双 引 号 枯 起 。 


declare [ unique ] index _indexname_ _indexoid_ on _tablename_ using _amname_ 


@ _opclass1 _name1_ |, ...] ) 


在 一 个 叫 _tablename 的 表 上 用 _amname_ 访问 方法 创建 一 个 OID 是 _indexoid_ 的 叫做 
_indexname_ 的 索引 。 索引 的 字段 叫 name1 , _name2 等 ， 而 使 用 的 操作 符 类 分 别 
是 _opclassi_, _opclass2. 等。 将 会 创建 索引 文件 和 恰当 的 系统 表 记 录 ， 但 是 索引 内 容 不 会 





被 此 命令 初始 化 。 
declare toast _toasttableoid_  _toastindexoid on  —_tablename_ 


ABA _tablename_ 的 表 创 建 一 个 TOAST 表 。 32^ TOAST AY OID Æ _toasttableoid_, 
其 索引 的 OID 是 _toastindexoid_ o 与 declare index 一 样 ， 索引 的 填充 会 被 推迟 。 


build indices 


填充 前 面 声 明 的 索引 。 


59.3. 系统 初始 化 的 BKI 文 件 的 结构 


open 命令 打开 的 表 需 要 系统 事先 存在 另外 一 些 基本 的 表 ， 在 这 些 表 存在 并 拥有 数据 之 前 ， 
不 能 使 用 open 命令 。 这 些 最 低 限 度 必须 存在 的 表 是 pg_class , pg_attribute , 

pg_proc ，pg_type 。 为 了 允许 这 些 表 自 己 被 填充 ， 带 bootstrap 选项 的 create 隐 含 打开 所 
创建 的 表 用 于 插入 数据 。 


同样 ， declare index 和 declare toast 命令 也 不 能 在 它们 所 需要 系统 表 创 建 并 填充 之 前 使 
用 。 


因此 ， postgres.bki 文件 的 结构 必须 是 这 样 的 : 
1. create bootstrap 其 中 一 个 关键 表 

2. insert 数据 ， 这 些 数据 至 少 描述 这 些 关 键 表 本 身 
3. close 

4. 重复 创建 和 填充 其 它 关 键 表 

5. create (不 带 bootstrap ) 一 个 非 关 键 表 

6. open 

7. insert 需要 的 数据 

8. close 

9 重复 创建 其 它 非 关 键 表 
10. 定义 索引 

11. build indices 


当然 ， 肯 定 还 有 其 它 未 记录 文档 的 顺序 依赖 关系 。 


59.4. 例子 


下 面 的 命令 集 将 创建 OID 为 420 名 为 test_table WR, 该 表 有 两 个 类 型 分 别 为 int4 和 text 
的 字段 cola 和 colb, 然后 向 该 表 插 入 两 行 。 


create test_table 420 (cola = int4, colb = text) 
open test_table 

insert OID=421 ( 1 "valuei" ) 

insert OID=422 ( 2 _null_ ) 

close test_table 


Chapter 60. 规划 器 如 何 使 用 统计 信息 


本 章 建 立 在 Section 14.1 和 Section 14.2 里 面 讨 论 的 材料 上 ， 显示 了 关于 规划 器 如 何 使 用 的 
额外 的 详细 信息 。 系统 统计 信息 来 预计 一 个 查询 运行 的 各 个 阶段 可 能 返回 的 行 数 。 这 是 规划 
过 程 中 的 一 个 重要 的 部 分 ， 因为 它 提 供 了 开销 计算 中 的 大 部 分 原始 材料 。 


本 章 的 目的 不 是 在 细节 上 给 代码 写 文 档 (代码 本 身 就 是 文档 )， 而 是 给 出 一 个 规划 器 如 何 使 用 
统计 信息 的 概述 。 这 样 可 能 可 以 降低 那些 想 以 后 阅读 这 部 份 代码 的 人 的 学 习 难 度 。 


60.1. 行 预期 的 例子 


下 面 的 例子 使 用 的 PostgreSQL 回 为 测试 数据 库 中 的 表 。 输出 结果 是 从 8.3 版 获得 的 。 之 前 或 
之 后 版 本 的 动作 可 能 会 有 所 变化 。 同时 需要 注意 的 是 ， 在 产生 统计 信息 时 ， ayz 使 用 的 
是 随机 采样 ， 在 使 用 一 次 新 的 ANALYZzE 之 后 ， 结 果 可 能 会 发 生 轻 微 的 改变 。 


让 我 们 以 一 个 很 简单 的 查询 开始 : 


EXPLAIN SELECT * FROM tenk1; 


QUERY PLAN 


Seq Scan on tenk1 (cost=0.00..458.00 rows=10000 width=244) 


规划 器 如 何 判 断 tenka 里 面 行 的 基数 在 Section 14.2 里 面 介绍 ， 为 了 完整 ， 在 这 里 重复 一 
下 。 行 数 或 页 数 是 从 pg_class 里 面 查 出 来 的 : 


SELECT relpages, reltuples FROM pg_class WHERE relname = 'tenki1'; 


relpages | reltuples 
之 A EOE E E 


358 | 10000 


这 些 数字 表示 表 中 当前 最 新 的 vacuum 或 者 ANALYZE 。 之 后 ， 规 划 器 取出 表 中 当前 实际 的 块 号 
(这 个 操作 的 开销 很 小 ， 不 需要 扫描 全 表 ) 。 WRS relpages 不 同 ， 那 么 根据 达到 的 一 个 当 
前 函数 估计 值 ， reltuples 会 进行 一 定 的 缩放 。 在 这 种 情况 下 ， relpages 的 值 是 最 新 的 ， 
因此 估计 的 行 与 reltuples 相同 。 


换 一 个 在 WHERE 子 句 里 面 带 有 范围 条 件 的 例子 : 


EXPLAIN SELECT * FROM tenk1 WHERE uniquei < 1000; 


QUERY PLAN 


Bitmap Heap Scan on tenk1 (cost=24.06..394.64 rows=1007 width=244) 
Recheck Cond: (unique1 < 1000) 
-> Bitmap Index Scan on tenki_unique1 (cost=0.00..23.80 rows=1007 width=0) 
Index Cond: (unique1 < 1000) 


规划 器 检查 were FARA, 并 为 pg_operator 中 的 alt; WITRE RARA. SRE 
在 oprrest 列 中 ， 并 且 在 这 个 例子 中 的 条 目 是 scalarltsel o scalarltsel HX 

从 unique1 为 uniquel 检索 直方 图 。 对 于 手工 查询 来 说 ， 这 样 做 可 以 更 方便 ， 更 直观 的 查 
看 pg_stats 视图 : 


SELECT histogram_bounds FROM pg_stats 
WHERE tablename='tenk1' AND attname='unique1'; 


histogram_bounds 


{0, 993, 1997, 3050, 4040, 5036, 5957, 7057, 8029, 9016, 9995} 


然后 ， 把 直方 图 里 面包 含 "< 1000" 的 部 分 找 出 来 。 这 就 是 选择 性 。 直方 图 把 范围 分 隔 成 相同 
频率 的 段 ， 所 以 要 做 的 只 是 把 的 数值 所 在 的 段 找 出 来 ， 然后 计算 它 里 面 占 的 部 分 以 及 所 有 该 
值 之 前 的 部 分 。 值 1000 很 明显 在 第 二 个 段 (993-1997) 里 ， 因 此 ， 假 设 每 个 段 里 面 的 分 布 是 线 
性 的 ， 那么 就 可 以 计算 出 选择 性 : 


selectivity (1 + (1000 - bucket[2].min)/(bucket[2].max - bucket[2].min) )/num_buckets 
(1 + (1000 - 993)/(1997 - 993))/10 


0.100697 


也 就 是 一 个 段 加 上 第 二 个 段 的 线性 部 分 ， 除 以 总 段 数 。 那么 估计 的 行 数 现在 可 以 用 选择 性 
和 tenki 的 基数 之 积 计 算 : 


rows rel_cardinality * selectivity 


= 10000 * 0.100697 
= 1007 (rounding off) 


然后 考虑 一 个 wHERE 子 句 里 等 于 条 件 的 例子 : 


EXPLAIN SELECT * FROM tenk1 WHERE Stringu1 = 'CRAAAA'; 


QUERY PLAN 


Seq Scan on tenk1 (cost=0.00..483.00 rows=30 width=244) 
Filter: (stringu1 = 'CRAAAA': :name) 


规划 器 再 次 检查 were FAR, HA = (是 eqsel ) 查找 可 选 函 数 。 对 于 等 价 估 计 而 言 ， 
直方 图 并 不 是 有 用 的 ; 相反 ， 最 常见 的 值 (MCV) 列 表 可 以 用 来 决定 可 选项 。 让 我 们 来 看 一 下 
MCV， 带 有 一 些 人 额外 的 列 会 很 有 效 : 


SELECT null_frac, n_distinct, most_common_vals, most_common_freqs FROM pg_stats 
WHERE tablename='tenk1' AND attname='stringu1'; 


null_frac 0 
n_distinct 676 


| 
| 
most_common_vals | {EJAAAA, BBAAAA, CRAAAA, FCAAAA, FEAAAA, GSAAAA, JOAAAA, MCAAAA, NAAAAA, WGAAA 
most_common_freqs | {0.00333333, 0.003, 0.003, 0.003, 0.003, 0.003, 0.003, 0.003, 0.003, 0.003} 


ME 


因为 MCV 中 有 cRAAAA ， 那 么 可 选项 只 是 MCF 列 表 中 的 一 个 相关 条 目 : 





selectivity = mcf[3] 


0.003 


像 之 前 一 样 ， 行 的 估计 数 只 是 和 前 面 一 样 用 tenka 的 基数 乘 以 选择 性 : 


10000 * 0.003 
30 


rows 


现在 看 看 同样 的 查询 ， 但 是 字符 串 常量 是 不 在 MCV 列 表 里 的 : 


EXPLAIN SELECT * FROM tenk1 WHERE stringui = 'xxx'; 


QUERY PLAN 


Seq Scan on tenk1 (cost=0.00..483.00 rows=15 width=244) 
Filter: (stringu1 = 'xxx'::name) 


这 个 时 候 的 问题 是 完全 不 同 的 一 个 : 在 数据 值 不 在 MCV 列 表 里 面 时 ， 如 何 估 计 选 择 性 就 是 完 
全 另外 一 个 问题 了 。 解 决 方法 是 利用 该 值 不 在 列表 里 头 的 事实 ， 结合 已 知 的 所 有 MCV 出 现 的 
频率 ， 用 减法 得 出 : 


selectivity (1 - sum(mvf))/(num_distinct - num_mcv) 
(1 - (0.00333333 + 0.003 + 0.003 + 0.003 + 0.003 + 0.003 + 
0.003 + 0.003 + 0.003 + 0.003))/(676 - 10) 


= 0.0014559 


也 就 是 ， 为 MCV 增 加 所 有 的 频率 ， 并 且 从 1 减 去 ， 然后 用 其 它 无 重复 值 的 个 数 来 分 开 。 这 相 
当 于 假设 不 是 MCV 中 的 列 的 分 数 巨 量 的 分 布 在 所 有 其 他 不 同 值 中 。 需要 注意 的 是 ， 没 有 
NULL 值 ， 因 此 不 需要 担心 这 些 (否则 需要 从 分 子 中 减 去 NULL 分 数 ) 。 估算 的 行 数 然后 照例 
计算 : 


10000 * 0.0014559 
15 (rounding off) 


rows 


之 前 带 有 uniquei alt; 1000 的 例子 是 scalarltsel 实际 执行 的 简单 化 。 现在 已 经 看 过 了 使 用 
MCV 的 例子 ， 可 以 增加 一 些 具 体 细 节 了 。 这 个 例子 这 样子 是 正确 的 ， 因 为 uniquel 是 一 个 唯 
一 属性 列 ， 那么 它 没有 MCV (显然 ， 没 有 一 个 值 能 比 其 它 值 更 通用 ) 。 对 一 个 非 唯一 属性 列 
而 言 ， 通 常会 有 直方 图 和 MCV 列 表 ， 并 且 直 方 图 不 包括 MCV 表 示 的 列 总 体 那 部 分 。 在 这 种 情 
况 下 ， scalarltsel 直接 应 用 条 件 到 每 个 MCV 列 表 的 值 上 如 "< 1000") ， 并 且 增 加 那些 条 
件 判断 为 真 的 MCV 的 频率 。 这 给 出 准确 的 是 MCV 表 的 部 分 的 选择 的 准确 估计 。 然后 直方 图 使 
用 与 上 述 方式 相同 的 估计 选择 表 的 部 分 ， 其 不 是 MCV， 那么 组 合 这 两 个 数字 来 估计 总 的 选择 
性 。 例 如 ， 考 虑 


EXPLAIN SELECT * FROM tenk1 WHERE stringu1 < 'IAAAAA'; 


QUERY PLAN 
Seq Scan on tenk1 (cost=0.00..483.00 rows=3077 width=244) 
Filter: (stringu1 < 'IAAAAA': :name) 


我 们 已 看 到 关于 stringu1 的 MCV 信 息 ， 这 里 是 它 的 直方 图 : 


SELECT histogram_bounds FROM pg_stats 
WHERE tablename='tenk1' AND attname='stringu1'; 


histogram_bounds 


{AAAAAA, CQAAAA, FRAAAA, IBAAAA, KRAAAA, NFAAAA, PSAAAA, SGAAAA, VAAAAA, XLAAAA, ZZAAAA} 


检查 MCV 列 表 ， 我 们 发 现 前 6 项 满足 条 件 stringul &lt; 'IAAAAA' ， 而 不 是 最 后 4 项 ， 所 以 最 
常见 的 部 分 MCV 选 择 性 是 


selectivity sum(relevant mvfs) 
0.00333333 + 0.003 + 0.003 + 0.003 + 0.003 + 0.003 


0.01833333 


累加 所 有 的 MCF， 也 告诉 我 们 由 MCVs 表 示 的 常见 的 总 比例 是 0.03033333， 而 且 因此 由 直方 
图 表示 的 比例 是 0.96966667。 (再 次 ,没有 NULL， 否 则 这 里 我 们 排斥 它们 ) 我 们 可 以 看 

到 IAAAAA 值 落 在 第 三 段 直方 图 的 结尾 部 分 。 关于 不 同 字符 串 的 频率 使 用 些 较 普通 的 假设 ， 规 
划 器 达到 估计 0.298387 为 直方 图 中 小 于 raaa 的 部 分 。 我 们 然后 组 合 估计 值 为 MCV 和 非 
MCV 常 见 : 


selectivity = mcv_selectivity + histogram_selectivity * histogram_fraction 
= 0.01833333 + 0.298387 * 0.96966667 
= 0.307669 

rows 10000 * 0.307669 


3077 (rounding off) 


尤其 是 在 这 个 例子 中 ，MCV 列 表 的 纠正 很 小 ， 因 为 列 分 布 实际 上 很 平坦 。 (统计 分 析 显 示 这 
些 特殊 值 往往 比 其 它 的 更 常见 大 部 分 由 于 抽样 误差 ) 在 更 典型 的 情况 下 这 里 有 些 值 显著 的 比 
其 它 的 更 常见 ， 这 复 厅 的 处 理 过程 ， 有 用 的 提高 了 精度 ， 因 为 选择 性 对 于 那些 最 常见 的 值 来 
说 ， 查 找 准 确 。 


现在 考虑 一 个 wer 子 句 中 带 有 多 个 条 件 的 情况 : 


EXPLAIN SELECT * FROM tenk1 WHERE unique1 < 1000 AND stringu1 = 'xxx'; 


QUERY PLAN 
Bitmap Heap Scan on tenk1 (cost=23.80..396.91 rows=1 width=244) 
Recheck Cond: (unique1 < 1000) 
Filter: (stringu1 = 'xxx'::name) 
-> Bitmap Index Scan on tenki_unique1 (cost=0.00..23.80 rows=1007 width=0) 
Index Cond: (unique1 < 1000) 


规划 器 认为 这 两 个 条 件 是 独立 的 ， 因 此 可 以 同时 执行 语句 的 独立 查询 : 


selectivity = selectivity(unique1 < 1000) * selectivity(stringui = 'xxx') 
= 0.100697 * 0.0014559 
= 0.0001466 

rows 10000 * 0.0001466 


1 (rounding off) 


E 注意 的 是 ， 从 位 图 索引 扫描 中 返回 的 估计 行 数值 影响 索引 使 用 的 条 件 ; 这 一 点 很 重要 ， 
它 会 影响 之 后 的 堆栈 抓 取 估计 开销 。 


H 


最 后 检查 一 个 包含 连接 的 查找 : 


EXPLAIN SELECT * FROM tenk1 t1, tenk2 t2 
WHERE t1.unique1 < 50 AND t1.unique2 = t2.unique2; 


QUERY PLAN 
Nested Loop (cost=4.64..456.23 rows=50 width=488) 

-> Bitmap Heap Scan on tenk1 t1 (cost=4.64..142.17 rows=50 width=244) 
Recheck Cond: (unique1 < 50) 
-> Bitmap Index Scan on tenki_unique1 (cost=0.00..4.63 rows=50 width=0) 

Index Cond: (uniquei < 50) 

-> Index Scan using tenk2_unique2 on tenk2 t2 (cost=0.00..6.27 rows=1 width=244) 

Index Cond: (unique2 = t1i.unique2) 


在 tenk1 上 的 unique1 &lt; 50 RETRETE A. 这 个 条 件 是 用 类 似 上 面 的 那 
个 范围 例子 的 方法 义理 的 。 但 是 这 次 数值 50 落 在 uniquel 的 直方 图 表 的 第 一 个 段 内 : 


selectivity = (© + (50 - bucket[1].min)/(bucket[1].max - bucket[1].min) )/num_buckets 
= (0 + (50 - 0)/(993 - 0))/10 
= 0.005035 

rows 


ok 


0000 * 0.005035 
© (rounding off) 


此 链接 的 限制 是 t2.unique2 = tl.unique2 。 操 作 符 是 我 们 熟悉 的 = ， Ama NAE 
从 pg_operator 的 oprjoin 字段 获得 的 ， 并 且 是 eqjoinsel ə eqjoinsel 为 tenk2 和 
tenki 查找 统计 信息 : 


SELECT tablename, null_frac,n_distinct, most_common_vals FROM pg_stats 
WHERE tablename IN ('tenki', 'tenk2') AND attname='unique2'; 


tablename | null_frac | n_distinct | most_common_vals 
et tm ry 二 
tenk1 | 9 | -1 | 
tenk2 | 9 | -1 | 


在 这 个 例子 里 ， 没 有 unique 的 MCV 信 息 ， 因为 所 有 数值 看 上 去 都 是 唯一 的 ， 因此 可 以 使 用 
一 个 只 依赖 唯一 数值 数目 和 NULL 数 目 百分比 的 算法 来 给 两 个 表 计 算 (选择 性 ) : 


selectivity (1 - null_fraci) * (1 - null_frac2) * min(1/num_distinct1, 1/num_distinct2) 


0) * (1 - ©) / max(10000, 10000) 


nou ul 
一 
_ 


El RE | 


也 就 是 说 ， 把 每 个 表 都 减 去 一 里 面 NULL 的 比例 ， 然 后 除 以 数值 的 最 大 值 。 连接 可 能 选 出 来 的 
行 数 是 以 庶 套 循环 里 的 两 个 输入 值 的 笛 卡尔 积 的 总 行 数 ， 乘 以 选择 性 计算 出 来 的 : 








rows (outer_cardinality * inner_cardinality) * selectivity 
(50 * 10000) * 0.0001 


50 


这 里 有 两 列 的 MCV 列 表 ， eqjoinsel 将 直接 使 用 MCV 列 表 比 较 来 决定 连接 由 MCV 表 示 的 常见 
列 部 分 的 选择 。 下 面 常见 的 剩 下 的 估计 值 跟 显 示 这 里 的 方法 相同 。 


需要 注意 的 是 ， inner_cardinality 表示 为 10000， 也 就 是 未 修改 的 tenk2 大 小 。 它 可 能 出 现 
从 检查 expan 输出 ， 其 连接 行 的 估计 值 来 自 50* 1， 就 是 ， 由 外 部 行 数 乘 以 由 每 个 内 部 索引 
扫描 的 tenk2 获取 的 估计 行 数 。 但 是 这 不 是 那 种 情况 : 估计 连接 关系 的 大 小 在 考虑 任何 特定 
的 连接 计划 之 前 。 如 果 任 何事 情 工 作 很 好 ， 那么 两 种 方式 估计 的 连接 大 小 将 产生 相关 的 同样 
的 答案 ， 但 是 由 于 四 舍 五 入 误差 和 其 它 因 素 它 们 有 时 差异 较 明显 。 


在 src/backend/optimizer/util/plancat.c 中 有 对 一 个 表 大 小 的 估计 (在 任何 WHERE 字句 之 
前 ) 。 在 src/backend/optimizer/path/clausesel.c 中 有 对 字句 选择 性 的 通用 逻辑 。 
在 src/backend/utils/adt/selfuncs.c 中 有 特定 操作 符 的 可 选 画 数 。 
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Appendix A. PostgreSQL 错误 代码 


PostgreSQL 服 务 器 发 出 的 所 有 消息 都 赋予 了 五 个 字符 的 错误 代码 ， 这 些 代码 遵循 SQL 

的 "SQLSTATE" 代 码 的 习惯 。 需要 知道 发 生 了 什么 错误 条 件 的 应 用 通常 应 该 测试 错误 代码 ， 
而 不 是 查看 文本 错误 信息 。 这 些 错 误 代 码 轻 易 不 会 随 着 PostgreSQL 的 版 本 更 新 而 修改 ， 并 
且 一 般 也 不 会 随 着 错误 信息 的 本 地 化 而 发 生 修改 。 请 注意 有 些 (但 不 是 全 部 ) PostgreSQL 生 成 
的 错误 代码 是 由 SQL 标准 定义 的 ; 有 些 标准 没有 定义 的 错误 条 件 是 发 明 的 或 者 是 从 其 它 数 据 
库 借 来 的 。 


根据 标准 ， 错 误 代码 的 头 两 个 字符 表示 错误 类 别 ， 而 后 三 个 字符 表示 在 该 类 别 内 特定 的 条 
件 。 因此 ， 那 些 不 能 识别 特定 错误 代码 的 应 用 仍然 可 以 从 错误 类 别 中 推断 要 做 什么 。 


Table A-1 里 面 列 出 了 PostgreSQL 9.3.1 定义 的 所 有 错误 代码 (有 些 实际 上 目前 并 没有 使 用 ， 

是 SQL 标准 定义 了 )。 错 误 类 别 也 列 出 在 此 。 对 于 每 个 错误 类 别 都 有 个 "标准 "的 错误 代码 ， a 
的 最 后 三 个 字符 是 00. 这 个 代码 只 用 于 那些 落 在 该 类 别 内 ， 但 是 没有 赋予 任何 更 准确 的 代 
码 的 错误 条 件 。 


"条 件 名 " 列 显示 的 标志 是 在 PL/pgSQL 里 面 使 用 的 条 件 名 。 条 件 名 大 小 写 无 关 。 (请 注意 
PL/pgSQL 并 不 识别 警告 ， 这 一 点 和 错误 、 条 件 名 正 相 反 ; 那些 是 00，01，02 类 别 。) 


ATESA 错误 ， 服 务 器 报告 与 错误 相关 的 数据 库 对 象 的 名 称 (一 个 表 ， 表 字段 ， 数 据 
类 型 ， 或 者 常 ; 例如 ， 唯 一 约束 的 名 字 导 致 了 一 个 unique violation 错误 。 类 似 的 名 字 
在 单独 的 错误 报告 字段 信息 中 提供 ， 这 样 应 用 程序 就 不 用 党 试 去 从 可 能 的 本 地 化 人 可 读 的 信 
息 eae 它们 。 EPostgreSQL 9.3, x13x-MaBNSEBERFEFSOLSTATE #23 
的 错误 中 〈 完 整 性 约束 违反 ) , 但 这 个 可 能 在 将 来 扩展 。 


Table A-1. PostgreSQL 错误 代码 


错误 代码 条 件 名 


Class 00 一 Successful 
Completion 


00000 successful_completion 


Class 01 — Warning 


01000 warning 

0100C dynamic_result_sets_returned 

01008 implicit_zero_bit_padding 

01003 nuli value eliminated _in set funct1ion 
01007 privilege_not_granted 

01006 privilege_not_revoked 


01004 string_data_right_truncation 


01P01 


Class 02 — No Data (this is 
also a warning class per 
the SQL standard) 


02000 


02001 


Class 03 — SQL Statement 
Not Yet Complete 


03000 


Class 08 — Connection 
Exception 


08000 
08003 
08006 
08001 
08004 
08007 


08P01 


Class 09 — Triggered 
Action Exception 


09000 


Class 0A — Feature Not 
Supported 


0A000 


Class 0B — Invalid 
Transaction Initiation 


0B000 


Class 0F — Locator 
Exception 


OF000 


OFOO1 


Class 0L — Invalid Grantor 
9L000 


OLPO1 


Class 0P — Invalid Role 
Specification 


0P000 


Class 0Z 一 Diagnostics 
Exception 


deprecated_feature 


no_data 


no_additional_dynamic_result_sets_returned 


sql_statement_not_yet_complete 


connection_exception 

connection_does_not_exist 

connection_failure 
sqiclient_unable_to_establish_sqlconnection 
sqlserver_rejected_establishment_of_sqlconnection 
transaction_resolution_unknown 


protocol _violation 


triggered_action_exception 


feature_not_supported 


invalid_transaction_initiation 


locator_exception 


invalid_locator_specification 


invalid_grantor 


invalid_grant_operation 


invalid_role_specification 


0Z000 diagnostics_exception 


0Z002 stacked_diagnostics_accessed_without_active_handler 


Class 20 — Case Not 
Found 


20000 case_not_found 


Class 21 — Cardinality 
Violation 


21000 cardinality_violation 


Class 22 — Data Exception 

















22000 data_exception 

2202E array_subscript_error 

22021 character_not_in_repertoire 

22008 datetime_field_overflow 

22012 division_by_zero 

22005 error_in_assignment 

2200B escape_character_conflict 

22022 indicator_overflow 

22015 interval_field_overflow 

2201E invalid_argument_for_logarithm 

22014 invalid_argument_for_ntile_function 
22016 invalid_argument_for_nth_value_function 
2201F invalid_argument_for_power_function 
2201G invalid_argument_for_width_bucket_function 
22018 invalid_character_value_for_cast 

22007 invalid_datetime_format 

22019 invalid_escape_character 

2200D invalid_escape_octet 

22025 invalid_escape_sequence 

22P06 nonstandard_use_of_escape_character 
22010 invalid_indicator_parameter_value 

22023 invalid_parameter_value 

2201B invalid_regular_expression 

2201W invalid_row_count_in_limit_clause 

2201X invalid_row_count_in_result_offset_clause 
22009 invalid_time_zone_displacement_value 
2200C invalid_use_of_escape_character 





2200G most_specific_type_mismatch 


22004 
22002 
22003 
22026 
22001 
22011 
22027 
22024 
2200F 
22P01 
22P02 
22P03 
22P04 
22P05 
2200L 
2200M 
2200N 
2200S 


2200T 


Class 23 — Integrity 
Constraint Violation 


23000 
23001 
23502 
23503 
23505 
23514 


23P01 


Class 24 — Invalid Cursor 
State 


24000 


Class 25 — Invalid 
Transaction State 


25000 
25001 
25002 
25008 


25003 


null_value_not_allowed 
null_value_no_indicator_parameter 


numeric_value_out_of_range 





string_data_length_mismatch 
string_data_right_truncation 
substring_error 

trim_error 
unterminated_c_string 
zero_length_character_string 
floating_point_exception 
invalid_text_representation 
invalid_binary_representation 
bad_copy_file_format 
untranslatable_character 
not_an_xml_document 
invalid_xml_document 
invalid_xml_content 
invalid_xml_comment 


invalid_xml_processing_instruction 


integrity_constraint_violation 
restrict_violation 
not_null_violation 
foreign_key_violation 
unique_violation 
check_violation 


exclusion_violation 


invalid_cursor_state 


invalid_transaction_state 
active_sql_transaction 
branch_transaction_already_active 
held_cursor_requires_same_isolation_level 


inappropriate_access_mode_for_branch_transaction 








25004 inappropriate_isolation_level_for_branch_transaction 


25005 no_active_sql_transaction_for_branch_transaction 
25006 read_only_sql_transaction 

25007 schema_and_data_statement_mixing_not_supported 
25P01 no_active_sql_transaction 

25P02 in_failed_sql_transaction 


Class 26 — Invalid SQL 
Statement Name 


26000 invalid_sql_statement_name 


Class 27 — Triggered Data 
Change Violation 


27000 triggered_data_change_violation 


Class 28 — Invalid 
Authorization Specification 


28000 invalid_authorization_specification 


28P01 invalid_password 


Class 2B — Dependent 
Privilege Descriptors Still 


Exist 
2B000 dependent_privilege_descriptors_still_exist 
2BP01 dependent_objects_still_exist 


Class 2D — Invalid 
Transaction Termination 


2D000 invalid_transaction_termination 


Class 2F — SQL Routine 





Exception 

2F000 sql_routine_exception 

2F005 function_executed_no_return_statement 
2F002 modifying_sql_data_not_permitted 
2F003 prohibited_sql_statement_attempted 
2F004 reading_sql_data_not_permitted 





Class 34 — Invalid Cursor 
Name 


34000 invalid_cursor_name 


Class 38 — External 
Routine Exception 


38000 external_routine_exception 
38001 containing_sql_not_permitted 


38002 modifying_sql_data_not_permitted 





38003 prohibited_sql_statement_attempted 


38004 reading_sql_data_not_permitted 





Class 39 — External 
Routine Invocation 


Exception 

39000 external_routine_invocation_exception 
39001 invalid_sqlstate_returned 

39004 null_value_not_allowed 

39P01 trigger_protocol_violated 

39P02 srf_protocol_ violated 


Class 3B — Savepoint 


Exception 
3B000 savepoint_exception 
3B001 invalid_savepoint_specification 


Class 3D — Invalid Catalog 
Name 


3D000 invalid_catalog_name 


Class 3F — Invalid Schema 
Name 


3F000 invalid_schema_name 


Class 40 — Transaction 


Rollback 

40000 transaction_rollback 

40002 transaction_integrity_constraint_violation 
40001 serialization_failure 

40003 statement_completion_unknown 

40P01 deadlock_detected 


Class 42 — Syntax Error or 
Access Rule Violation 





42000 syntax_error_or_access_rule_violation 
42601 syntax_error 

42501 insufficient_privilege 

42846 cannot_coerce 

42803 grouping_error 

42P20 windowing_error 

42P19 invalid_recursion 

42830 invalid_foreign_key 


42602 invalid_name 


42622 
42939 
42804 
42P18 
42P21 
42P22 
42809 
42703 
42883 
42P01 
42P02 
42704 
42701 
42P03 
42P04 
42723 
42P05 
42P06 
42P07 
42712 
42710 
42702 
42725 
42P08 
42P09 
42P10 
42611 
42P11 
42P12 
42P13 
42P14 
42P15 
42P16 


42P17 


Class 44 — WITH CHECK 
OPTION Violation 


44000 


name_too_long 

reserved_name 
datatype_mismatch 
indeterminate_datatype 
collation_mismatch 
indeterminate_collation 
wrong_object_type 
undefined_column 
undefined_function 
undefined_table 
undefined_parameter 
undefined_object 
duplicate_column 
duplicate_cursor 
duplicate_database 
duplicate_function 
duplicate_prepared_statement 
duplicate_schema 
duplicate_table 
duplicate_alias 
duplicate_object 
ambiguous_column 
ambiguous_function 
ambiguous_parameter 
ambiguous_alias 
invalid_column_reference 
invalid_column_definition 
invalid_cursor_definition 
invalid_database_definition 
invalid_function_definition 
invalid_prepared_statement_definition 
invalid_schema_definition 
invalid_table_definition 


invalid_object_definition 


with_check_option_violation 





Class 53 — Insufficient 


Resources 

53000 insufficient_resources 

53100 disk_full 

53200 out_of_memory 

53300 too_many_connections 

53400 configuration_limit_exceeded 


Class 54 — Program Limit 


Exceeded 

54000 program_limit_exceeded 
54001 statement_too_complex 
54011 too_many_columns 

54023 too_many_arguments 


Class 55 — Object Not In 
Prerequisite State 


55000 object_not_in_prerequisite_state 
55006 object_in_use 

55P02 cant_change_runtime_param 

55P03 lock_not_available 


Class 57 — Operator 


Intervention 

57000 operator_intervention 
57014 query_canceled 

57P01 admin_shutdown 

57P02 crash_shutdown 

57P03 cannot_connect_now 
57P04 database_dropped 


Class 58 — System Error 
(errors external to 


PostgreSQL itself) 

58000 system_error 
58030 io_error 

58P01 undefined_file 
58P02 duplicate_file 


Class F0 — Configuration 
File Error 


F0000 config file error 


F0001 lock_file_exists 


Class HV — Foreign Data 
Wrapper Error (SQL/MED) 

















HV000 fdw_error 

HV005 fdw_column_name_not_found 

HV002 fdw_dynamic_parameter_value_needed 
HV010 fdw_function_sequence_error 

HVO21 fdw_inconsistent_descriptor_information 
HVO24 fdw_invalid_attribute_value 

HV007 fdw_invalid_column_name 

HV008 fdw_invalid_column_number 

HV004 fdw_invalid_data_type 

HV006 fdw_invalid_data_type_descriptors 
HVO91 fdw_invalid_descriptor_field_identifier 
HVOOB fdw_invalid_handle 

HVOOC fdw_invalid_option_index 

HVOOD fdw_invalid_option_name 

HV090 fdw_invalid_string_length_or_buffer_length 
HVOOA fdw_invalid_string_format 

HV009 fdw_invalid_use_of_null_pointer 
HVO14 fdw_too_many_handles 

HVOO1 fdw_out_of_memory 

HVOOP fdw_no_schemas 

HVOOJ fdw_option_name_not_found 

HVOOK fdw_reply_handle 

HVOOQ fdw_schema_not_found 

HVOOR fdw_table_not_found 

HVOOL fdw_unable_to_create_execution 
HVOOM fdw_unable_to_create_reply 

HVOON fdw_unable_to_establish_connection 
Class P0 — PL/pgSQL 

Error 

P0000 plpgsql_error 

P0001 raise_exception 

P0002 no_data_found 

P0003 too_many_rows 


Class XX — Internal Error 
XX000 internal_error 


XX001 data_corrupted 
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XX002 index_corrupted 


Appendix A. PostgreSQL 错误 代码 2392 


Appendix B. 日 期 /时 间 支 持 
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PostgreSQL 使 用 一 个 内 部 的 启发 式 分 析 器 用 于 所 有 的 日 期 /时 间 支 持 。 日 期 和 时 间 都 是 以 字 
符 串 形式 输入 的 ， 然后 用 一 个 初步 的 判断 分 解 为 在 该 数 域 里 可 以 有 什么 桩 的 信息 。 每 个 数 域 
都 被 解释 ， 并 且 要 么 是 被 赋予 一 个 数字 值 ， 要 么 是 忽略 ， 要 么 是 被 拒绝 。 分 析 器 里 包含 内 部 
的 查询 表 ， 用 于 所 有 文本 域 ， 包括 月 份 、 星期 几 、 时 区 。 


这 份 附录 包含 这 些 查 询 表 的 信息 ， 以 及 描述 了 分 析 器 用 来 对 时 间 和 日 期 解码 的 步骤 。 


B.1. 日 期 /时 间 输入 解析 


日 期 /时 间 类 型 输入 都 是 使 用 下 列 过 程 进行 解码 的 。 


1. 把 输入 的 字符 串 分 解 为 一 个 个 记号 ， 然 后 把 每 个 记号 分 成 字符 串 、 时 间 、 时 区 、 数 字 几 

ji， 如 果 一 个 数字 记号 包含 一 个 冒号 ( : )， 那么 这 是 一 个 时 间 字 符 串 。 包 括 随后 所 有 的 
数据 位 和 冒号 。 

i， 如 果 这 个 数字 记号 包含 一 个 划 线 ( - ) BAL / )、 多 个 点 ( . )， 那么 它 就 是 一 个 日 


期 字符 串 ， 可 能 有 一 个 文本 月 份 。 如 果 一 个 日 期 记号 已 经 看 过 ， 那 么 将 被 解析 为 时 
区 名 (比如 America/New_York )。 


ii， 如 果 这 个 记号 只 是 数字 ， 那 么 它 要 么 是 一 个 单独 的 字段 ， 要 么 是 一 个 ISO8601 连 接 
的 日 期 (比如 19990113 是 1999 年 1 月 13 日 ) 或 者 是 连接 的 时 间 ( 比 如 141516 是 
14:15:16). 


iv. 如 果 记 号 以 一 个 加 号 ( + ) 或 减 号 ( - ) 开 头 ， 那么 它 要 么 是 一 个 时 区 ， 要 么 就 是 一 个 
特殊 的 字段 。 


2， 如 果 记 号 是 一 个 文本 字符 串 ， 那 么 和 可 能 的 字符 串 进 行 匹配 : 
i 把 这 个 记号 当 作 时 区 缩写 进行 二 分 表 查 找 。 
iii， 如 果 没 有 找到 ， 再 做 一 次 二 分 表 查 找 ， 看 看 这 个 记号 是 特殊 字符 串 (比如 today 小、 
日 期 (比如 Thursday )、 月 份 (比如 January )， 还 是 一 个 无 关 痛 痒 的 字 (比如 at, 
on )o 
诈 ， 如 果 还 没有 找到 ， 抛 出 一 个 错误 。 
3， 如 果 记 号 是 一 个 数字 或 者 数字 字段 : 
i， 如 果 有 八 位 或 者 六 位 数字 ， 而 且 前 面 也 没有 读 到 其 它 日 期 字段 ， 那么 就 解释 成 一 
个 "concatenated date( 连 接 的 日 期 )" (比如 19990118 或 者 990118 )。 这 里 的 解析 
是 YYYYMMDD 或 者 YYMMDD o 
ii 如 果 记 号 是 三 位 数字 ， 并 且 已 经 解码 了 一 个 年 份 ， 那 么 解释 成 一 年 中 的 日 。 
ii， 如 果 已 经 读 取 了 四 位 或 六 位 数字 ， 并 且 已 经 读 取 了 一 个 年 份 ， 那么 就 解析 成 时 间 
( HHMM 或 者 HHMMss ). 


iv， 如 果 是 三 位 或 更 多 位 并 且 还 没有 找到 日 期 字段 ， 则 解析 成 一 个 年 份 (这 个 解析 强制 剩 
余 的 日 期 字段 的 顺序 为 yy-mm-dd)。 


v. 否则 ， 日 期 字段 的 顺序 被 认为 是 遵循 Datestyle 设置 : mm-dd-yy,dd-mm-yy,yy-mm- 
dd 之 一 。 如 果 发 现 月 份 或 者 日 期 字段 超出 范围 ， 则 抛 出 一 个 错误 。 


4， 如 果 声 明了 BC， 则 对 年 份 取 其 负数 并 加 一 ， 用 于 内 部 保存 。 因为 在 格 里 高 利 历 法 里 没有 
老年 ， 所 以 数字 上 的 1BC 是 公元 需 年 。 

5 如果 没有 声明 BC 并 且 年 份 字段 有 两 个 数据 位 的 长 度 ， 那 么 把 年 份 调整 为 4 位 。 如 果 该 字 
段 小 于 70， 那 么 加 2000， 否 则 加 1900。 
> Tip: 格 里 高 利 年 份 AD 1-99 可 以 用 前 导 需 的 方式 使 用 4 位 数字 (也 就 是 说 gg98。 是 AD 
99)。 


B.2. 日 期 /时 间 关 键 字 


Table B-1 显 示 被 当做 月 份 名 字 缩 写 的 记号 。 


Table B-1. Month Names 


月 份 
January 
February 
March 
April 
May 
June 
July 
August 
September 
October 
November 


December 


Table B-2 显 示 被 识别 为 星期 几 的 名 字 。 
Table B-2. Day of the Week Names 


星期 
Sunday 
Monday 
Tuesday 
Wednesday 
Thursday 
Friday 
Saturday 


Table B-3 显 示 用 于 各 种 修饰 用 途 的 记号 。 


Table B-3. 日 期 /时 间 字 段 修 饰 词 


Jan 
Feb 
Mar 


Apr 


Jun 
Jul 
Aug 


Sep, Sept 


Oct 
Nov 


Dec 


Sun 
Mon 
Tue, Tues 


Wed, Weds 


Thu, Thur, Thurs 


Fri 
Sat 


KS 
Iy 


KS 
IN 


di 


a 


AM 


AT 


JULIAN 


ON 


PM 


T 


标识 符 


12:00 之 前 的 时 间 
忽略 

下 一 个 字段 是 儒 略 日 
忽略 
12:00 以 及 之 后 的 时 间 


下 一 个 字段 是 时 间 


B.3. 日 期 /时 间 配 置 文件 


一 些 时 区 缩写 并 不 很 标准 ，PostgreSQL 提 供 一 种 定制 服务 器 可 接受 的 缩写 集合 。 
timezone_abbreviations 运行 时 配置 参数 定义 缩写 的 有 效 集合 。 该 配置 参数 可 以 被 任何 数据 
库 用 户 更 改 ， 但 是 其 取 值 范围 只 能 由 数据 库 管理 员 更 改 ， 事实 上 可 用 的 值 都 

是 .../share/timezonesets/ 目录 中 的 文件 名 。 通过 添加 或 修改 其 中 的 文件 ， 管 理 员 就 可 以 控 
制 可 用 的 时 区 缩写 。 


timezone_abbreviations 可 以 被 设 为 .../share/timezonesets/ H 录 下 的 任意 文件 名 (文件 名 只 
允许 包含 字母 )。 禁止 在 timezone_abbreviations 中 使 用 非 字 母 字符 是 为 了 防止 读 取 目 录 之 外 
的 文件 以 及 其 它 不 该 读 取 的 文件 。 


时 区 缩写 文件 中 可 以 包含 空白 行 和 以 # 开头 的 注释 。 非 注释 行 必须 是 以 下 格式 : 


time_zone_name offset 
time_zone_name offset_ D 
@INCLUDE _file_name_ 
@OVERRIDE 








time_zone_name_ 是 被 定义 的 缩写 名 。 _offset 是 该 时 区 相对 于 UTC 偏 移 量 (以 秒 计 )， 向 
东 为 正 ， 向 西 为 负 。 例 如 -18000 表 示 在 格林 威 治 以 西 5 小 时 ， 也 就 是 美国 东部 标准 时 
Ho D 表示 该 时 区 使 用 夏令 时 而 不 是 标准 时 。 因为 目前 所 有 已 知 的 时 区 偏 移 量 都 以 15 分 钟 为 
单位 ， 因此 偏 移 量 的 秒 数 必须 是 900 的 倍数 。 





@INCLUDE 语法 用 于 包含 .../share/timezonesets/ 目录 中 的 其 它 文件 ， JUAREZ, 不 过 
并 不 允许 无 限 深度 的 馈 套 。 


@OVERRIDE 语法 表示 后 面 项 的 定义 可 以 覆盖 前 面 的 项 (比如 ， 从 包含 文件 中 获得 ) ， 没有 这 
一 点 ， 同 一 时 区 缩写 的 矛盾 定义 被 认为 是 一 个 错误 。 


默认 安装 时 ， Default 文件 包含 世界 上 几乎 所 有 不 冲突 的 时 区 缩写 。 F 
外 ， Australia 和 India 文件 用 于 这 些 区 域 : 这 些 文件 首先 被 包含 在 Default 文件 中 并 在 随 
后 按 需 修 改 或 者 添加 时 区 。 


为 了 便于 参考 ， 标 准 安装 也 包含 了 Africa.txt , America.txt 等 文件 ， 它们 包含 了 所 

有 zoneinfo 时 区 数据 库 中 的 时 区 缩写 。 这 些 文件 中 的 时 区 名 定义 可 以 复制 到 自 定 义 的 配置 文 
件 中 。 需要 注意 的 是 ， 这 些 文件 名 不 能 直接 用 于 timezone_abbreviations ， 因为 这 些 文件 名 
中 包含 句点 。 


Note: 如 果 在 读 取 时 区 数据 集 时 出 错 ， 将 不 会 点 用 任何 新 值 ， 仍 将 使 用 旧 的 数据 集 。 如 
果 这 个 错误 是 在 数据 库 服 务 器 启动 时 发 生 的 ， 那 么 启动 将 失败 。 


Caution 


配置 文件 中 的 时 区 缩写 定义 将 会 覆盖 PostgreSQL 内 置 的 非 时 区 含义 。 例如 australia Bc 
冒 文件 定义 了 sat (南澳 洲 标 准时 间 )， 如 果 激 活 了 该 文件 ， 那 么 sat 将 不 会 被 识别 为 星 
期 六 的 缩写 。 


Caution 


如 果 你 修改 .../share/timezonesets/ 中 的 文件 ， 那么 你 必须 自己 手动 备份 ， 因 为 数据 库 
转 储 不 会 包含 这 个 目录 的 内 容 。 


B.4. 单位 历史 


该 SQL 标准 指出 "在 一 个 ' 日 期 时 间 形 式 ' 定 义 中 ， "日 期 时 间 值 ' 按 照 阳 历 通过 日 期 和 时 间 的 自然 
规则 被 限制 "。 PostgreSQL 遵 循 SQL 标 准 通过 阳历 计算 特定 日 期 ， 其 至 使 用 日 历 的 几 年 前 。 
这 条 规则 被 称 为 预期 的 阳历 。 


儒 略 日 是 由 Julius Caesar 在 公元 前 45 年 引入 的 ， 直 到 1582 年 开始 使 用 公历 之 前 ， 西方 国家 一 
直 使 用 儒 略 日 。 在 儒 略 日 中 ， 一 年 近似 等 于 365+1/4=365.25 天 ， 大 约 在 128 年 的 出 现 一 个 1 
天 的 错 。 


不 断 积 累 的 历法 错误 促使 教皇 格 里 高 利 十 三 世 (Gregory XI 中 按照 与 弥撒 议会 (Council of 
Trent) 一 致 的 精神 改革 了 历法 。 在 罗马 历法 里 ， 一 年 是 近似 365 + 97 /400 天 = 365.2425 天 。 
因此 对 应 于 罗马 历法 ， 大 约 要 3300 年 ， 才 会 积累 一 天 的 误差 。 


近似 的 365+97/400 是 通过 利用 下 面 的 规则 ， 规 定 每 400 年 有 97 个 头 年 实现 的 : 


每 个 可 被 4 整除 的 年 是 一 个 半年 
不 过 ， 可 被 100 整 除 的 年 不 是 头 年 
但 是 ， 可 以 被 400 整 除 的 年 还 是 半年 。 


因此 ，1700,1800,1900,2100 和 2200 年 都 不 是 头 年 。 而 1600,2000,2400 年 是 头 年 。 相 比 而 
言 ， 旧 式 的 Julian 历法 里 面 只 有 能 被 4 整除 的 年 是 半年 。 


罗马 教皇 在 1582 年 2 月 宣布 从 1582 的 10 月 中 删除 10 天 ， 也 就 是 10 月 15 号 紧 跟 在 10 月 4 号 的 后 
面 。 信奉 天 主教 的 国家 (意大利 、 波 兰 、 葡 萄 牙 、 西 班 牙 等 ) 很 快 就 遵循 了 这 个 规定 ， 但 新 教 
国家 拒绝 使 用 ， 而 希腊 未 正教 国家 却 一 直 拖 延 到 20 世 纪 开 始 的 时 候 才 逐渐 遵守 这 个 规定 。 大 
英 帝 国 及 其 殖民 地 (包含 今天 的 美国 ) 在 1752 年 开始 引用 使 用 ， 也 就 是 1752 年 9 月 2 号 之 后 紧 跟 
着 14 号 ， 这 就 是 为 什么 Unix 系 统 上 的 cal 程序 会 产生 如 下 输出 的 原因 : 


$ <kbd class="literal">cal 9 1752</kbd> 
September 1752 
S M Tu WTh F S 
w214 15 16 
17 18 19 20 21 22 23 
24 25 26 27 28 29 30 


但 是 ， 当 然 ， 这 个 日 历 对 于 英国 领土 是 唯一 有 效 的 ， 不 是 其 它 地 方 。 因为 党 试 跟踪 在 不 同 的 
时 间 不 同 地 方 使 用 的 实际 日 历 是 困难 和 混乱 的 ， PostgreSQL 不 会 尝试 ， 而 是 遵循 所 有 日 期 的 
阳历 规则 ， 即 使 这 种 方法 是 历史 上 不 准确 的 。 


在 世界 的 不 同 地 方 ， 发 明了 许多 不 同 的 历法 ， 有 许多 比 罗马 历法 系统 还 早 。 例如 ， 中 国 历法 
的 最 早 应 用 可 以 追溯 到 公元 前 14 世 纪 。 传说 黄帝 在 公元 前 2637 就 发 明了 这 个 历法 ， 也 就 是 日 
历 。 中 华人 民 共 和 国 使 用 罗马 历法 用 于 民用 。 中 国 历法 用 于 决定 节日 /节气 。 


Julian Date 系 统 是 日 历 的 另 一 种 类 型 ， 跟 Julian calendar 无 关 ， 尽 管 与 这 个 日 历 类 似 命 名 是 
TAARA "Julian Date" 系 统 是 法 国学 者 Joseph Justus Scaliger(1540-1609) 发 明 的 ， 可 
能 是 取 自 Scaliger 的 父亲 的 名 字 ， 意大利 学 者 Julius Caesar Scaliger(1484-1558)。 在 Julian 日 
期 系统 ， 每 天 产生 一 个 序列 号 ， 从 JD0 开 始 (有 时 被 叫做 the Julian 日 期 ) > JD0 在 Julian 日 
历 中 对 应 公元 前 4713 年 1 月 1 日 ， 在 Gregorian 日 历 中 对 应 公元 前 4714 年 11 月 24 日 。 Julian 日 
期 计算 经 常 在 天 文学 家 标注 夜间 观测 时 被 用 到 ， 因此 一 个 日 期 就 是 从 一 个 正午 UTC 到 下 一 个 
正午 UTC。 而 不 是 从 午夜 到 另 一 个 午夜 : JD0 设 计 的 24 小 时 是 从 公元 前 4714 年 11 月 24 日 的 正 
午 UTC 到 公元 前 4714 年 11 月 25 日 的 正午 UTC。 


尽管 PostgreSQL 在 输入 输出 日 期 时 支持 Julian Date 日 期 符号 (也 用 在 一 些 内 部 的 日 期 时 间 日 
历 上 ) ， 它 不 观察 从 正午 到 正午 的 精密 运行 。 PostgreSQL 运 行 Julian Date 日 期 系统 从 午夜 
到 午夜 。 


Appendix C. SQL 关键 字 


Table C-1 列 出 了 所 由 在 SQL 标准 和 PostgreSQL 里 是 关键 字 的 记号 。 你 可 以 在 Section 4.1.1 
里 找到 相关 的 背景 信息 。 《由 于 空间 原因 ， 只 包括 SQL 标准 的 最 后 两 个 版 本 和 为 了 历史 兼容 
的 SQL-92。 这 些 和 其 他 中 间 标 准 版 本 的 差异 很 小 。) 


SQL 里 有 保留 字 和 非 保 留 字 之 分 。 根 据 标准 ， 保留 字 是 那些 真正 的 关键 字 ; 决 不 能 用 它们 做 
标识 符 。 非 保留 字 只 是 在 特定 的 环境 里 有 特殊 的 含义 ， 而 在 其 它 环 境 里 是 可 以 用 做 标识 符 
的 。 大 多 数 非 保 留 字 实际 上 都 是 SQL 声明 的 内 建 表 和 函数 的 名 字 。 而 非 保留 字 的 概念 实质 上 
只 是 用 来 表示 在 某 些 场合 里 ， 在 一 个 字 上 附加 了 一 些 预 先 定义 的 含义 。 


在 PostgreSQL 里 ， 分 析 器 的 工作 有 些 复 休 。 因 为 存在 好 几 种 不 同 范畴 的 记号 ， 从 那些 永远 不 
可 能 用 做 标识 符 的 到 那些 和 普通 标识 符 比 较 起 来 在 分 析 器 里 完全 没有 任何 特殊 状态 的 (后 者 通 
Mabe SQL 声明 的 函数 )。 即 使 保留 关键 字 在 PostgreSQL 里 都 没有 完全 保留 ， 而 是 可 以 用 做 
字段 标签 。 上 比如 ， 虽 然 cHEck 是 保留 关键 字 ， 但 是 SELECT 55 as CHECK 语句 完全 行 得 通 。 


在 Table C-1 的 PostgreSQL 字 段 里 ， 我 们 把 那些 分 析 器 明确 知道 ， 但 是 允许 作为 字段 或 表 名 
的 关键 字 分 类 为 " 非 保留 "。 虽然 一 些 关 键 宇 是 非 保留 的 ， 但 是 却 不 能 用 做 函数 或 者 数据 类 型 
名 字 ， 我 们 对 这 些 关键 字 相 应 做 了 的 标记 。 大 多 数 这 类 记号 代表 有 特殊 语法 的 内 置 函 数 或 者 
数据 类 型 。 仍 然 可 以 使 用 这 些 画 数 或 者 类 型 ， 但 是 用 户 不 能 重新 定义 它们 。 标 记 为 "保留 "的 
都 是 那些 不 允许 作为 字段 或 表 名 的 。 有 些 保留 关键 字 还 可 以 用 做 函数 或 数据 类 型 的 名 字 ; 这 
点 在 表 中 也 显示 出 来 了 。 如 果 没 有 那样 标记 ， 那 么 只 人 允许 出 现在 "AS" 字 上 段 标 签名 里 面 。 


一 条 通用 的 规则 是 : 如 果 你 看 到 任何 古怪 的 分 析 错 ， 说 命令 包含 任何 这 里 列 出 的 关键 字 做 标 
识 符 ， 那么 你 可 以 先 试 试用 双 引 号 把 那个 标识 符 括 起 来 ， 看 看 问题 是 否 消 失 。 

在 开始 学 习 Table C-1 之 前 还 要 理解 的 一 件 重要 的 事情 是 : 一 个 关键 字 在 PostgreSQL 中 没有 
保留 并 不 意味 着 与 该 关键 字 相关 的 特性 没有 实现 。 同 样 ， 关键 字 的 存在 也 并 不 表明 某 个 特性 
就 一 定 存 在 。 


Table C-1. SQL 关键 字 


关键 字 PostgreSQL SQL:2011 SQL:2008 as 
A 非 保留 非 保留 
ABORT 非 保留 
ABS 保留 保留 
ABSENT 非 保留 非 保留 
ABSOLUTE 非 保 留 非 保留 非 保留 保留 


ACCESS 非 保 留 


ACCORDING 非 保留 非 保留 


ACTION 非 保留 FRE HRE BE 
ADA 非 保留 非 保留 RE 

ADD 非 保留 FRE HRE BE 
ADMIN 非 保留 非 保留 RE 

AFTER 非 保留 FRE RE 

AGGREGATE 非 保 留 

ALL 保留 保留 保留 保留 
ALLOCATE 保留 保留 保留 

ALSO 非 保留 

ALTER 非 保留 保留 保留 保留 
ALWAYS 非 保留 FRE RE 

ANALYSE 保留 

ANALYZE 保留 

AND 保留 保留 保留 保留 
Any 保留 保留 保留 保留 
ARE 保留 保留 保留 

ARRAY 保留 保留 保留 

ARRAY_AGG 保留 保留 

ARRAY_MAX_CARDINALITY 保 留 

as 保留 保留 保留 保留 
asc 保留 FRE HRE BE 
ASENSITIVE 保留 保留 

ASSERTION 非 保留 FRE 。 ” 非 保留 BE 
ASSIGNMENT 非 保留 非 保留 RE 
ASYMMETRIC 保留 保留 保留 

AT 非 保留 保留 保留 保留 
ATOMIC 保留 保留 

ATTRIBUTE 非 保留 非 保留 RE 
ATTRIBUTES 保留 保留 


保留 (可 以 
AUTHORIZATION 是 函数 或 类 保留 保留 保留 


AVG 


BACKWARD 


BASE64 


BEFORE 


BEGIN 


BEGIN _FRAME 


BEGIN_PARTITION 


BERNOULLI 


BETWEEN 


BIGINT 


BINARY 


BIT 


BIT_LENGTH 


BLOB 


BLOCKED 


BOM 


BOOLEAN 


BOTH 


BREADTH 


BY 


6 


CACHE 


CALL 


CALLED 


CARDINALITY 


型 ) 

保留 

非 保留 

非 保留 

非 保留 

非 保留 
保留 

保留 

非 保留 

非 保留 不 
能 是 画 数 或 
类 型 ) 

非 保留 不 
能 是 画 数 或 
类 型 ) 
保留 (可 以 
是 函数 或 类 
型 ) 

非 保留 (不 
能 是 画 数 或 
类 型 ) 
保留 

保留 

非 保留 

非 保留 

非 保留 (不 
能 是 画 数 或 
类 型 ) 
保留 

非 保留 

非 保留 

非 保留 

非 保留 
保留 

非 保留 
保留 


保留 


非 保留 
非 保留 
保留 


非 保留 


保留 


保留 


保留 


保留 


保留 
非 保留 
非 保留 


保留 


保留 
非 保留 
保留 
非 保留 


保留 
保留 
保留 


保留 


非 保留 


保留 


保留 


保留 


保留 


非 保留 


保留 


保留 


保留 


保留 


保留 


CASCADE 


CASCADED 


CASE 


CAST 


CATALOG 


CATALOG_NAME 


CEIL 


CEILING 


CHAIN 


CHAR 


CHARACTER 


CHARACTERISTICS 


CHARACTERS 


CHARACTER_LENGTH 


CHARACTER_SET_CATALOG 


CHARACTER_SET_NAME 


CHARACTER_SET_SCHEMA 


CHAR_LENGTH 


CHECK 


CHECKPOINT 


CLASS 


CLASS_ORIGIN 


CLOB 


CLOSE 


CLUSTER 


COALESCE 


COBOL 


COLLATE 


非 保留 
非 保留 
保留 
保留 
非 保留 
非 保留 
保留 
保留 
非 保留 
非 保留 (不 
HE = LEX, 
类 型 ) 
非 保留 (不 
HE = ELEY, 
类 型 ) 
非 保留 
非 保留 
保留 
非 保留 
非 保留 
非 保留 
保留 
保留 
非 保留 
非 保留 
非 保留 
保留 
非 保留 
非 保留 
非 保留 (不 
HE = ELEY, 
类 型 ) 
非 保留 
保留 


非 保留 


保留 
保留 
保留 


非 保留 
非 保留 


保留 
保留 


非 保留 


保留 


保留 


非 保留 
非 保留 


保留 


非 保留 
非 保留 
非 保留 


保留 
保留 


非 保留 


保留 
保留 


保留 


非 保留 


保留 


非 保留 


保留 
保留 
保留 


非 保留 
非 保留 


非 保留 


保留 


保留 


非 保留 


保留 


非 保留 
非 保留 
非 保留 


保留 
保留 


非 保留 


保留 


保留 


非 保留 


保留 


保留 
保留 
保留 
保留 
保留 


保留 


保留 


保留 


保留 


保留 


保留 


COLLATION 


COLLATION_CATALOG 


COLLATION_NAME 


COLLATION_SCHEMA 


COLLECT 


COLUMN 


COLUMNS 


COLUMN_NAME 


COMMAND_FUNCTION 


COMMAND_FUNCTION_CODE 


COMMENT 


COMMENTS 


COMMIT 


COMMITTED 


CONCURRENTLY 


CONDITION 


CONDITION _NUMBER 


CONFIGURATION 


CONNECT 


CONNECTION 


CONNECTION_NAME 


CONSTRAINT 


CONSTRAINTS 


CONSTRAINT_CATALOG 


CONSTRAINT_NAME 


CONSTRAINT_SCHEMA 


CONSTRUCTOR 


CONTAINS 


CONTENT 


保留 (可 以 
是 函数 或 类 
型 ) 

非 保留 

非 保留 

非 保留 
保留 

保留 

非 保留 

非 保留 

非 保留 

非 保留 

非 保留 

非 保留 

非 保留 


非 保留 


保留 (可 以 
型 ) 
保留 
非 保留 
非 保留 
保留 
非 保留 
非 保留 
保留 
非 保留 
非 保留 
非 保留 
非 保留 
非 保留 
保留 
非 保留 


非 保留 


非 保留 
非 保留 
非 保留 
保留 

保留 

非 保留 
非 保留 
非 保留 
非 保留 


保留 


非 保留 


保留 
非 保留 


保留 

非 保留 
非 保留 
保留 

非 保留 
非 保留 
非 保留 
非 保留 
非 保留 
非 保留 
非 保留 


非 保留 


非 保留 
非 保留 
非 保留 


保留 


非 保留 
非 保留 


保留 


非 保留 


非 保留 


保留 

非 保留 
非 保留 
保留 

非 保留 
非 保留 
非 保留 
非 保留 


非 保留 


保留 


保留 


保留 


保留 
保留 


OEE 非 保留 非 保留 非 保留 保留 


CONTROL 非 保留 非 保留 

CONVERSION 非 保 留 

CONVERT 保留 保留 保留 

cory 非 保留 

CORR 保留 保留 

CORRESPONDING 保留 保留 保留 

cost 非 保留 

COUNT 保留 保留 保留 

COVAR_POP 保留 保留 

COVAR_SAMP 保留 保留 

CREATE 保留 保留 保留 保留 
保留 (可 以 

cross TEARS RE 保留 保留 
型 ) 

csv 非 保留 

CUBE 保留 保留 

CUME_DIST 保留 保留 

CURRENT 非 保留 保留 保留 保留 

CURRENT_CATALOG 保留 保留 保留 

CURRENT_DATE 保留 保留 保留 保留 

CURRENT_DEFAULT_TRANSFORM_GROUP 保留 保留 

CURRENT_PATH 保留 保留 

CURRENT_ROLE 保留 保留 保留 

CURRENT_ROW 保留 
保留 (可 以 

CURRENT_SCHEMA EKA 保留 保留 
型 ) 

CURRENT_TINE 保留 保留 保留 保留 

CURRENT_TIMESTAMP 保留 保留 保留 保留 

CURRENT_TRANSFORM_GROUP_FOR_TYPE 保留 保留 

CURRENT_USER 保留 保留 保留 保留 


CURSOR 非 保留 保留 保留 保留 


CURSOR_NAME 


CYCLE 


DATA 


DATABASE 


DATALINK 


DATE 


DATETIME_INTERVAL_CODE 


DATETIME_INTERVAL_PRECISION 


DAY 


DB 


DEALLOCATE 


DEC 


DECIMAL 


DECLARE 


DEFAULT 


DEFAULTS 


DEFERRABLE 


DEFERRED 


DEFINED 
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e D.1. 支持 的 特性 
。 D.2. 不 支持 的 特性 


本 节 试 图 描述 PostgreSQL 在 多 大 程度 上 遵循 SQL 标 准 。 下 面 的 信息 不 是 兼容 性 的 全 部 内 容 ， 
但 是 它 提供 了 一 个 从 用 户 角度 来 看 ， 既 合 理 又 有 用 的 足够 的 细节 信息 。 


SQL 标准 的 正式 名 称 是 ISO/IEC 9075 "Database Language SQL", 标准 的 修改 版 会 经 常 地 发 
布 ; 最 近 更 新 的 一 个 版 本 出 现在 2011 年 。 那个 版 本 被 称 作 ISO/IEC 9075:2011, 或 者 简称 
SQL:2011。 这 个 版 本 之 前 的 是 SQL:2008, SQL:2003, SQL:1999 和 SQL-92。 每 个 版 本 都 蔡 
代 前 面 那个 ， 所 以 声称 兼容 早期 版 本 没有 什么 官方 的 好 人 处。 PostgreSQL 开 发 瞄准 兼容 标准 
最 新 官方 版 本 ， 只 要 这 样 的 兼容 不 会 与 传统 的 特性 或 者 常识 冲突 。 许多 SQL 标准 要 求 的 特性 
都 得 到 了 支持 ， 只 是 有 些 时 候 语 法 或 者 函数 略微 不 同 。 更 多 有 关 标 准 兼容 的 特性 将 在 未 来 的 
版 本 里 看 到 。 


SQL-92 为 兼容 性 定义 了 三 种 特性 集合 : Entry, Intermediate 和 Full。 大 部 分 数据 库 管 理 系 统 声 
明 在 Entry 级 别 遵循 SQL 标准 兼容 性 ， 因为 中 等 和 完全 的 特性 要 么 是 太 庞 大 ， 要 么 就 是 和 传 
统 的 行为 相 冲 突 。 


从 SQL:1999 开 始 ，SQL 标 准 定义 了 一 个 很 大 的 独立 特性 集合 ， 而 不 是 SQL-92 那 样 宽泛 而 又 
低 效率 的 三 个 级 别 。 这 些 特性 中 的 一 个 很 大 的 子 集 形成 "核心 "特性 ， 它们 是 每 种 兼容 SQL 的 
实现 必须 提供 的 特性 。 其 它 的 特性 都 是 可 选 的 。 有 些 可 选 的 特性 组 合 在 一 起 形成 " 包 "， SQL 
的 实现 可 以 号 称 遵循 这 些 包 ， 也 就 是 声称 遵循 特定 的 特性 组 。 


SQL:2003 标 准 也 分 裂 成 一 系列 部 分 : 每 种 都 用 一 个 缩写 来 标识 。 请 注意 这 些 部 分 并 非 连续 编 
号 的 。 


e ISO/IEC 9075-1 Framework (SQL/Framework) 

e ISO/IEC 9075-2 基础 (SQL/Foundation) 

e ISO/IEC 9075-348 FA Æ #0 (SQL/CLI) 

© ISO/IEC 9075-42 A 4 ik 432 (SQL/PSM) 

。 ISO/IEC 9075-9 外 部 数据 管理 (SQL/MED) 

。 ISO/IEC 9075-10 对 象 语言 绑 定 (SQL/OLB) 

e ISO/IEC 9075-11 信 息 及 定义 模式 (SQL/Schemata) 


。 ISO/IEC 9075-13 Java 语 言 的 过 程 和 类 型 (SQL/JRT) 


e ISO/IEC 9075-14 XML 相关 的 规范 (SQL/XML) 


PostgreSQL i i51,2,9,114114, 34#RODBC3R HBR, 13 被 PL/Java 插 件 覆 盖 。 但 是 这 些 组 件 
目前 没有 严格 的 兼容 检查 。 目前 没有 实现 PostgreSQL 的 第 4 和 10 部 分 。 


PostgreSQL 支 持 大 多 数 SQL:2011 的 主要 特性 。 在 总 共 179 个 强制 要 求 完全 兼容 的 核心 特性 
里 ， PostgreSQL 遵 循 至 少 160 个 。 另外， PostgreSQL 还 支持 一 长 串 可 选 的 特性 。 值得 一 提 
的 是 ， 在 写 这 些 的 时 候 ， 没有 任何 当前 版 本 的 数据 库 管理 系统 声称 支持 全 部 核心 SQL:2011。 


下 面 的 两 节 列 出 了 PostgreSQL 支 持 的 特性 ， 以 及 PostgreSQL 目 前 尚 不 支持 的 SQL:2011 特 
性 。 这 两 个 列表 都 是 近似 的 : 被 列 为 支持 的 特性 可 能 在 某 些 次 要 细节 方面 与 标准 不 一 致 ， 被 
列 为 不 支持 的 特性 也 可 能 实际 上 已 经 被 实现 。 文档 的 主体 部 分 包含 了 大 多 数 能 否 正常 工作 的 
精确 信息 。 


Note: 包含 一 个 连 字符 的 特性 代码 表示 一 个 子 特性 。 因此 ， 如 果 不 支 持 特定 的 子 特性 ， 
那么 主 特性 也 会 列 在 不 支持 的 特性 ， 即使 支持 其 它 的 子 特性 也 如 此 。 
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UNIQUE constraints of NOT 
NULL columns 


PRIMARY KEY constraints 
Basic FOREIGN KEY constraint 
with the NO ACTION default for 
both referential delete action and 


referential update action 


CHECK constraints 


Column defaults 


NOT NULL inferred on 


E141- 
08 


E141- 
10 


E151 


E151- 
01 


E151- 
02 


E152 


E152- 
01 


E152- 
02 


E153 


E161 


E171 
F021 


F021- 
01 


F021- 
02 


F021- 
03 


F021- 
04 


F021- 
05 


F021- 
06 


F031 


F031- 
01 


F031- 


Core 


Core 


Core 


Core 


Core 


Core 


Core 


Core 


Core 


Core 


Core 


Core 


Core 


Core 


Core 


Core 


Core 


Core 


Core 


Core 


Core 


NOT NULL inferred on 
PRIMARY KEY 


Names in a foreign key can be 
specified in any order 


Transaction support 


COMMIT statement 


ROLLBACK statement 


Basic SET TRANSACTION 
statement 


SET TRANSACTION statement: 
ISOLATION LEVEL 
SERIALIZABLE clause 


SET TRANSACTION statement: 
READ ONLY and READ WRITE 
clauses 


Updatable queries with 
subqueries 


SQL comments using leading 
double minus 


SQLSTATE support 


Basic information schema 


COLUMNS view 


TABLES view 


VIEWS view 


TABLE_CONSTRAINTS view 


REFERENTIAL_CONSTRAINTS 
view 


CHECK_CONSTRAINTS view 


Basic schema manipulation 


CREATE TABLE statement to 
create persistent base tables 


CREATE VIEW statement 


02 


F031- 
03 


F031- 
04 


F031- 
13 


F031- 
16 


F031- 
19 


F032 


F033 


F034 


F034- 
01 


F034- 
02 


F034- 
03 


F041 


F041- 
01 


F041- 
02 


F041- 
03 


F041- 
04 


F041- 
05 


F041- 
07 


F041- 
08 


Core 


Core 


Core 


Core 


Core 


Core 


CASCADE drop behavior 


ALTER TABLE statement: 
DROP COLUMN clause 


Extended REVOKE statement 


REVOKE statement performed 
by other than the owner of a 
schema object 


REVOKE statement: GRANT 
OPTION FOR clause 


REVOKE statement to revoke a 
privilege that the grantee has 
WITH GRANT OPTION 


Core 


Core 


Core 


Core 


Core 


Core 


Core 


Core 


CREATE VIEW statement 


GRANT statement 


ALTER TABLE statement: ADD 
COLUMN clause 


DROP TABLE statement: 
RESTRICT clause 


DROP VIEW statement: 
RESTRICT clause 


REVOKE statement: RESTRICT 
clause 


Basic joined table 


Inner join (but not necessarily 
the INNER keyword) 


INNER keyword 


LEFT OUTER JOIN 


RIGHT OUTER JOIN 


Outer joins can be nested 


The inner table in a left or right 
outer join can also be used in an 
inner join 


All comparison operators are 
supported (rather than just =) 


F051- 
01 


F051- 
02 


F051- 
03 


F051- 
04 


F051- 
05 


F051- 
06 


F051- 
07 


F051- 
08 


F052 
F053 
F081 


att 


F111- 
01 


F111- 
02 


F111- 
03 


F131 


F131- 
01 


F131- 
02 


F131- 
03 


Core 


Core 


Core 


Core 


Core 


Core 


Core 


Core 


Enhanced datetime facilities 
OVERLAPS predicate 
Core 


Isolation levels other than 
SERIALIZABLE 


READ UNCOMMITTED 
isolation level 


READ COMMITTED isolation 
level 


REPEATABLE READ isolation 
level 


Core 


Core 


Core 


Core 


DATE data type (including 
support of DATE literal) 


TIME data type (including 
support of TIME literal) with 
fractional seconds precision of at 
least 0 


TIMESTAMP data type 
(including support of 
TIMESTAMP literal) with 
fractional seconds precision of at 
least 0 and 6 


Comparison predicate on DATE, 
TIME, and TIMESTAMP data 


types 


Explicit CAST between datetime 
types and character string types 


CURRENT_DATE 


LOCALTIME 


LOCALTIMESTAMP 


Intervals and datetime arithmetic 


UNION and EXCEPT in views 


Grouped operations 


WHERE, GROUP BY, and 
HAVING clauses supported in 
queries with grouped views 


Multiple tables supported in 
queries with grouped views 


Set functions supported in 
queries with grouped views 


03 


F131- 
04 


F131- 
05 


F171 


F191 


F200 
F201 
F221 


F222 


F231 


F231- 
01 


F231- 
02 


F231- 
03 


F251 
F261 


F261- 
01 


F261- 
02 


F261- 
03 


F261- 
04 


F262 
F271 
F281 
F302 
F302- 


Core 


Core 


Multiple schemas per user 


Enhanced integrity 
management 


TRUNCATE TABLE statement 
Core 
Core 


INSERT statement: DEFAULT 
VALUES clause 


Privilege tables 


TABLE_PRIVILEGES view 


COLUMN_PRIVILEGES view 


USAGE_PRIVILEGES view 


Domain support 


Core 


Core 


Core 


Core 


Core 


Extended CASE expression 
Compound character literals 
LIKE enhancements 
INTERSECT table operator 
INTERSECT DISTINCT table 


queries with grouped views 


Subqueries with GROUP BY and 
HAVING clauses and grouped 
views 


Single row SELECT with 
GROUP BY and HAVING 
clauses and grouped views 


Referential delete actions 


CAST function 


Explicit defaults 


CASE expression 


Simple CASE 


Searched CASE 


NULLIF 


COALESCE 


F302- 
01 


F302- 
02 
F304 


F311- 
01 


F311- 
02 


F311- 
03 


F311- 
05 


F321 
F361 
F381 


F381- 
01 


F381- 
02 


F381- 
03 


F382 
F383 
F391 
F392 
F393 
F401 


F401- 
01 


F401- 
02 


F401- 
04 


F402 


INTERSECT DISTINCT table 
operator 


INTERSECT ALL table operator 


EXCEPT ALL table operator 


Core CREATE SCHEMA 
C CREATE TABLE for persistent 
ore 
base tables 
Core CREATE VIEW 
Core GRANT statement 


User authorization 
Subprogram support 
Extended schema manipulation 


ALTER TABLE statement: 
ALTER COLUMN clause 


ALTER TABLE statement: ADD 
CONSTRAINT clause 


ALTER TABLE statement: 
DROP CONSTRAINT clause 


Alter column data type 

Set column not null clause 
Long identifiers 

Unicode escapes in identifiers 
Unicode escapes in literals 


Extended joined table 


NATURAL JOIN 


FULL OUTER JOIN 


CROSS JOIN 


Named column joins for LOBs, 
arrays, and multisets 


F411 


F421 
F431 


F431- 
01 


F431- 
02 


F431- 
03 


F431- 
04 


F431- 
05 


F431- 
06 


F441 


F442 


F471 
F481 


F491 


F501 


F501- 
01 


F501- 
02 


F501- 
03 


F502 


F502- 
01 


F502- 
02 


F502- 


Enhanced datetime facilities Time zone specification 


National character 


Read-only scrollable cursors 


FETCH with explicit NEXT 


FETCH FIRST 


FETCH LAST 


FETCH PRIOR 


FETCH ABSOLUTE 


FETCH RELATIVE 


Extended set function support 


Mixed column references in set 


functions 
Core Scalar subquery values 
Core Expanded NULL predicate 


manes ont hn Constraint management 


management 
C Features and conformance 
ore i 
views 
Core SQL_FEATURES view 
Core SQL_SIZING view 
Core SQL_LANGUAGES view 


Enhanced documentation 
tables 


SQL_SIZING_PROFILES view 


SQL_IMPLEMENTATION_INFO 
view 


regardir 
literal 
interpre 


F531 
F555 
F561 
F571 
F591 
F611 
F641 
F651 
F661 
F672 
F690 
F692 


F701 


F711 
F731 
F761 
F762 
F763 
F771 
F781 
F791 
F801 


F850 


F851 


F852 


F855 


F856 


F857 


Temporary tables 

Enhanced datetime facilities 
Full value expressions 
Truth value tests 

Derived tables 

Indicator data types 

Row and table constructors 
Catalog name qualifiers 
Simple tables 

Retrospective check constraints 
Collation support 

Extended collation support 


Enhanced integrity 
management 


ALTER domain 

INSERT column privileges 
Session management 
CURRENT_CATALOG 
CURRENT_SCHEMA 
Connection management 
Self-referencing operations 
Insensitive cursors 

Full set function 


Top-level <order by clause> in 
<query expression> 


<order by clause> in subqueries 


Top-level <order by clause> in 
views 


Nested <order by clause> in 
<query expression> 


Nested <fetch first clause> in 
<query expression> 


Top-level <fetch first clause> in 
<query expression> 


Enhanced seconds precision 


but no character set support 


Referential update actions 


F858 


F859 


F860 


F861 


F862 


F863 


F864 


F865 


S071 


S092 
S095 
S096 
S098 
S111 

S201 


S201- 
01 


S201- 
02 


S211 
T031 
T071 


T121 


1122 


T131 


<query expression> 


<fetch first clause> in 
subqueries 


Top-level <fetch first clause> in 
views 


<fetch first row count> in <fetch 
first clause> 


Top-level <result offset clause> 
in <query expression> 


<result offset clause> in 
subqueries 


Nested <result offset clause> in 
<query expression> 


Top-level <result offset clause> 
in views 


<offset row count> in <result 
offset clause> 


Enhanced object support 


Arrays of user-defined types 
Array constructors by query 
Optional array bounds 
ARRAY_AGG 

Enhanced object support 


SQL-invoked routines on arrays 


Array parameters 


Array as result type of functions 


Enhanced object support 
BOOLEAN data type 
BIGINT data type 


WITH (excluding RECURSIVE) 
in query expression 


WITH (excluding RECURSIVE) 
in subquery 


Recursive query 


SQL paths in function and type 
name resolution 


ONLY in query expressions 


User-defined cast functions 


T131 
T132 
T141 
IFS 


T152 


ZA 


F172 


mM 


T191 


T201 


T211- 
01 


T211- 
02 


T211- 
03 


T211- 
04 


T211- 
05 


T211- 
07 


T212 


T213 
T231 


T241 


T271 


T281 


Recursive query 

Recursive query in subquery 
SIMILAR predicate 
DISTINCT predicate 


DISTINCT predicate with 
negation 


LIKE clause in table definition 


AS subquery clause in table 
definition 


Extended LIKE clause in table 
definition 


Enhanced integrity 
management 


Enhanced integrity 
management 


Active database, Enhanced 
integrity management 


Active database, Enhanced 
integrity management 


Active database, Enhanced 
integrity management 


Active database, Enhanced 
integrity management 


Active database, Enhanced 
integrity management 


Active database, Enhanced 
integrity management 


Enhanced integrity 
management 


INSTEAD OF triggers 
Sensitive cursors 


START TRANSACTION 
statement 


Savepoints 


SELECT privilege with column 
granularity 


Referential action RESTRICT 


Comparable data types for 
referential constraints 


Triggers activated on UPDATE, 
INSERT, or DELETE of one 
base table 


BEFORE triggers 


AFTER triggers 


FOR EACH ROW triggers 


Ability to specify a search 
condition that must be true 
before the trigger is invoked 


TRIGGER privilege 


Enhanced trigger capability 


T312 OVERLAY function 


T321- User-defined functions with no 


gi i overloading 

ie ~ Core Function invocation 
ae Core ROUTINES view 
ass Core PARAMETERS view 
T323 Explicit security for external 


routines 
T331 Basic roles 


Overloading of SQL-invoked 


er functions and procedures 


Bracketed SQL comments (/.../ 


T351 
comments) 
T441 ABS and MOD functions 


T461 Symmetric BETWEEN 
predicate 

T491 LATERAL derived table 
T501 Enhanced EXISTS predicate 


Optional key words for default 


Too 
syntax 

T581 Regular expression substring 
function 

T591 UNIQUE constraints of possibly 


null columns 
T614 NTILE function 
TTS LEAD and LAG functions 
FIRST VALUE and 


Loni LAST_VALUE function 

T621 Enhanced numeric functions 

T631 Cow IN predicate with one list 
element 

T651 SQL-schema statements in 


SQL routines 


T655 Cyclically dependent routines 


X011 
X016 
X020 
X031 
X032 
X034 
X035 
X036 
X037 
X040 


X041 


X042 


X043 


X044 


X045 


X046 


X047 


X048 


X049 


X050 


X051 


X052 


X053 


X054 


Arrays of XML type 
Persistent XML values 
XMLConcat 

XMLEIement 

XMLForest 

XMLAgg 

XMLAgg: ORDER BY option 
XMLComment 

XMLPI 

Basic table mapping 


Basic table mapping: nulls 
absent 


Basic table mapping: null as nil 


Basic table mapping: table as 
forest 


Basic table mapping: table as 
element 


Basic table mapping: with target 
namespace 


Basic table mapping: data 
mapping 


Basic table mapping: metadata 
mapping 


Basic table mapping: base64 
encoding of binary strings 


Basic table mapping: hex 
encoding of binary strings 


Advanced table mapping 


Advanced table mapping: nulls 
absent 


Advanced table mapping: null 
as nil 


Advanced table mapping: table 
as forest 


Advanced table mapping: table 
as element 


Advanced table mapping: target 


X055 


X056 


X057 


X058 


X059 


X060 


X061 


X070 


X071 


X072 


X090 


X120 


X121 


X400 


X410 


namespace 


Advanced table mapping: data 
mapping 


Advanced table mapping: 
metadata mapping 


Advanced table mapping: 
base64 encoding of binary 
strings 


Advanced table mapping: hex 
encoding of binary strings 


XMLParse: Character string 
input and CONTENT option 


XMLParse: Character string 
input and DOCUMENT option 


XMLSerialize: Character string 
serialization and CONTENT 
option 


XMLSerialize: Character string 
serialization and DOCUMENT 
option 


XMLSerialize: Character string 
serialization 


XML document predicate 


XML parameters in SQL 
routines 


XML parameters in external 
routines 


Name and identifier mapping 


Alter column data type: XML 
type 


D.2. 不 支持 的 特性 


下 面 这 些 在 SQL:2011 中 定义 的 特性 在 目前 的 PostgreSQL 版 本 中 还 没有 实现 ， 
况 下 可 以 获得 等 效 的 功能 。 





标识 
符 包 描述 


B011 Embedded Ada 

B013 Embedded COBOL 
B014 Embedded Fortran 
B015 Embedded MUMPS 
B016 Embedded Pascal 
B017 Embedded PL/I 

B031 Basic dynamic SQL 
B032 Extended dynamic SQL 


uae <describe input statement> 

B033 Untyped SQL-invoked function 
arguments 

B034 Dynamic specification of cursor 


attributes 
B035 Non-extended descriptor names 


Extensions to embedded SQL 
exception declarations 


B041 
B051 Enhanced execution rights 
B111 Module language Ada 
B112 Module language C 

B113 Module language COBOL 
B114 Module language Fortran 
B115 Module language MUMPS 
B116 Module language Pascal 
B117 Module language PL/I 
B121 Routine language Ada 


B122 Routine language C 


B123 
B124 
B125 
B126 
B127 
B128 


B211 


B221 


E182 


F054 


F121 


F121- 
01 


F121- 
02 


F122 


F123 
F181 


F202 


F263 


F291 


F301 


F311 


F311- 
04 


F312 
F313 


Routine language COBOL 
Routine language Fortran 
Routine language MUMPS 
Routine language Pascal 
Routine language PL/I 
Routine language SQL 


Module language Ada: VARCHAR 
and NUMERIC support 


Routine language Ada: VARCHAR 
and NUMERIC support 


Core 


TIMESTAMP in DATE type 
precedence list 


Basic diagnostics management 
GET DIAGNOSTICS statement 


SET TRANSACTION statement: 
DIAGNOSTICS SIZE clause 


Enhanced diagnostics 
management 


All diagnostics 
Core 


TRUNCATE TABLE: identity 
column restart option 


Commaz-separated predicates in 
simple CASE expression 


UNIQUE predicate 


CORRESPONDING in query 
expressions 


Core 


Core 


MERGE statement 
Enhanced MERGE statement 
MERGE statement with DELETE 


Module language 


Multiple module support 


Schema definition 
statement 


CREATE VIEW: WITH 
CHECK OPTION 


F341 


F384 


F385 


F386 


F394 
F403 
F451 
F461 


F492 


F521 


F671 


F693 


F695 


F696 


F721 


F741 
F751 
F812 
F813 
F821 
F831 


F831- 
01 


F831- 
02 


F841 
F842 


branch 


no ROUTINE_* USAGE 


Usage tables ables 
Drop identity property clause 


Drop column generation 
expression clause 


Set identity column generation 
clause 


Optional normal form specification 
Partitioned joined tables 
Character set definition 

Named character sets 


Optional table constraint 
enforcement 


Enhanced integrity management Assertions 


intentionally 


Enhanced integrity management Subqueries in CHECK omitted 


SQL-session and client module 
collations 


Translation support 


Additional translation 
documentation 


Deferrable constraints foreign and unique keys 


only 
Referential MATCH types no partial match yet 
View CHECK enhancements 
Core Basic flagging 


Extended flagging 
Local table references 


Full cursor update 


Updatable scrollable cursors 


Updatable ordered cursors 


LIKE_REGEX predicate 
OCCURENCES_REGExX function 


F842 
F843 
F844 
F845 


F846 


F847 


F866 


F867 


S011 


S011- 
01 


S023 


S024 


S025 
S026 


S027 


S028 
S041 


S043 


S051 


S081 
S091 


S091- 
01 


S091- 
02 


S091- 
03 


S094 


OCCURENCES_ REGEX function 
POSITION_REGEX function 
SUBSTRING_REGEX function 
TRANSLATE_REGEX function 


Octet support in regular 
expression operators 


Nonconstant regular expressions 


FETCH FIRST clause: PERCENT 
option 


FETCH FIRST clause: WITH TIES 
option 


Core 

Core 

Basic object support 
Enhanced object support 


Final structured types 
Self-referencing structured types 


Create method by specific method 
name 


Permutable UDT options list 


Basic object support 


Enhanced object support 


Basic object support 


Enhanced object support 


Basic array support 


Arrays of built-in data types 


Arrays of distinct types 


Array expressions 


Arrays of reference types 


Distinct data types 


USER_DEFINED_TYPES 
view 


Basic structured types 


Enhanced structured 
types 


Basic reference types 


Enhanced reference 
types 


Create table of type 


Subtables 


partially supported 


partially 
supported 


S097 
$151 
$161 
$162 
$202 
$231 
$232 
$233 
$241 
$242 
$251 
$261 
$271 
$272 
$274 
$275 
$281 
$291 
$301 


$401 


$402 


S403 
S404 
T011 


T021 


T022 


T023 
T024 


T041 


Array element assignment 
Basic object support 
Enhanced object support 


Subtype treatment for references 


SQL-invoked routines on multisets 


Enhanced object support 
Array locators 

Multiset locators 

Transform functions 

Alter transform statement 
User-defined orderings 
Specific type method 

Basic multiset support 
Multisets of user-defined types 
Multisets of reference types 
Advanced multiset support 
Nested collection types 
Unique constraint on entire row 
Enhanced UNNEST 


Distinct types based on array 
types 


Distinct types based on distinct 
types 


ARRAY_MAX_CARDINALITY 
TRIM_ARRAY 


Timestamp in Information Schema 


BINARY and VARBINARY data 
types 


Advanced support for BINARY and 


VARBINARY data types 
Compound binary literal 


Spaces in binary literals 


Basic object support 


Type predicate 
Subtype treatment 


Structured type locators 


Basic LOB data type 
support 


T041- 
01 


T041- 
02 


T041- 
03 


T041- 
04 


T041- 
05 


T042 
T043 
T044 
T051 
T052 


T053 


T061 
T101 


ca 


T174 
IEIS 
T176 


IK 


T178 


T180 
T181 


T211 


T211- 


Basic object support 


Basic object support 


Basic object support 


Basic object support 


Basic object support 


Extended LOB data type support 
Multiplier T 

Multiplier P 

Row types 

MAX and MIN for row types 


Explicit aliases for all-fields 
reference 


UCS support 
Enhanced nullability determination 


Updatable joins, unions, and 
columns 


Identity columns 
Generated columns 
Sequence generator support 


Sequence generator support: 
simple restart option 


Identity columns: simple restart 
option 


System-versioned tables 
Application-time period tables 


Active database, Enhanced 
integrity management 


Active database, Enhanced 


support 


BLOB data type 


CLOB data type 


POSITION, LENGTH, 
LOWER, TRIM, UPPER, 
and SUBSTRING 
functions for LOB data 


types 


Concatenation of LOB 
data types 


LOB locator: non- 
holdable 


Basic trigger capability 


Support for run-time rules 


06 


T211- 
08 


T251 


T261 
T272 
T285 
T301 


T321 


T321- 
02 


TAE 
04 


T321- 
05 


T322 


T324 


T325 


T326 
T332 


T431 


T432 


T433 


T434 
T471 
T472 


integrity management 


Active database, Enhanced 


integrity management 


SET TRANSACTION statement: 


LOCAL option 


Chained transactions 


Enhanced savepoint management 


Enhanced derived column names 


Functional dependencies 


Core 


Core 


Core 


Core 


PSM 


Explicit security for SQL routines 


Qualified SQL parameter 
references 


Table functions 


Extended roles 
OLAP 


Nested and concatenated 
GROUPING SETS 


Multiargument GROUPING 


function 
GROUP BY DISTINCT 
Result sets return value 


DESCRIBE CURSOR 


triggers and constraints 


Multiple triggers for the 
same event are executed 
in the order in which they 
were created in the 
catalog 


partially supported 


Basic SQL-invoked 
routines 


User-defined stored 
procedures with no 
overloading 


CALL statement 


RETURN statement 


Declared data type 
attributes 


mostly supported 


Extended grouping 
capabilities 


intentionally 
omitted 


T495 


T502 


T511 


T521 


T522 


T541 
T561 


TO 


T572 


T601 


T611 


T612 
T613 


T616 


T618 


T619 
T620 


T641 


T652 


T653 


T654 


M001 
M002 
M003 


Combined data change and 


: different syntax 
retrieval 


Period predicates 
Transaction counts 


Named arguments in CALL 
statement 


Default values for IN parameters of 
SQL-invoked procedures 


Updatable table references 
Holdable locators 


Array-returning external SQL- 
invoked functions 


Multiset-returning external SQL- 
invoked functions 


Local cursor references 


OLAP Elementary OLAP 
operations 

Advanced OLAP operations some forms supported 

Sampling 


Null treatment option for LEAD and 
LAG functions 


NTH_VALUE function function exists, but some 
= options missing 

Nested window functions 

WINDOW clause: GROUPS option 


only some syntax variants 


Multiple column assignment supported 


SQL-dynamic statements in SQL 
routines 


SQL-schema statements in 
external routines 


SQL-dynamic statements in 
external routines 


Datalinks 
Datalinks via SQL/CLI 
Datalinks via Embedded SQL 


most forms 
supported 


M005 
M006 
M007 
M009 
M010 
M011 
M012 
M013 
M014 
M015 
M016 
M017 


M018 


M019 


M020 


M021 


M022 


M023 


M024 


M030 


M031 


X012 
X013 
X014 
X015 
X025 


Foreign schema support 
GetSQLString routine 
TransmitRequest 

GetOpts and GetStatistics routines 
Foreign data wrapper support different API 
Datalinks via Ada 

Datalinks via C 

Datalinks via COBOL 

Datalinks via Fortran 

Datalinks via M 

Datalinks via Pascal 

Datalinks via PL/I 


Foreign data wrapper interface 
routines in Ada 


Foreign data wrapper interface 


routines in C different API 


Foreign data wrapper interface 
routines in COBOL 


Foreign data wrapper interface 
routines in Fortran 


Foreign data wrapper interface 
routines in MUMPS 


Foreign data wrapper interface 
routines in Pascal 


Foreign data wrapper interface 
routines in PL/I 


SQL-server foreign data support 


Foreign data wrapper general 
routines 


Multisets of XML type 
Distinct types of XML type 
Attributes of XML type 
Fields of XML type 
XMLCast 


X030 


X038 


X065 


X066 


X068 
X069 


X073 


X074 


X075 
X076 


X077 


X078 


X080 


X081 


X082 


X083 


X084 


X085 


X086 


X091 
X096 


X100 


X101 


XMLDocument 


XMLText 


XMLParse: BLOB input and 
CONTENT option 


XMLParse: BLOB input and 
DOCUMENT option 


XMLSerialize: BOM 
XMLSerialize: INDENT 


XMLSerialize: BLOB serialization 
and CONTENT option 


XMLSerialize: BLOB serialization 
and DOCUMENT option 


XMLSerialize: BLOB serialization 
XMLSerialize: VERSION 


XMLSerialize: explicit ENCODING 
option 


XMLSerialize: explicit XML 
declaration 


Namespaces in XML publishing 


Query-level XML namespace 
declarations 


XML namespace declarations in 
DML 


XML namespace declarations in 
DDL 


XML namespace declarations in 
compound statements 


Predefined namespace prefixes 


XML namespace declarations in 
XMLTable 


XML content predicate 
XMLExists 


Host language support for XML: 
CONTENT option 


Host language support for XML: 
DOCUMENT option 


Host language support for XML: 


X111 


X112 


X113 


X114 


X131 
X132 
X133 


X134 


X135 


X141 


X142 


X143 


X144 


X145 


X151 


X152 


X153 


X155 


X157 


X160 


VARCHAR mapping 


Host language support for XML: 
CLOB mapping 


Host language support for XML: 
BLOB mapping 


Host language support for XML: 
STRIP WHITESPACE option 


Host language support for XML: 
PRESERVE WHITESPACE option 


Query-level XMLBINARY clause 
XMLBINARY clause in DML 
XMLBINARY clause in DDL 


XMLBINARY clause in compound 
statements 


XMLBINARY clause in subqueries 


IS VALID predicate: data-driven 
case 


IS VALID predicate: ACCORDING 
TO clause 


IS VALID predicate: ELEMENT 
clause 


IS VALID predicate: schema 
location 


IS VALID predicate outside check 
constraints 


IS VALID predicate with 
DOCUMENT option 


IS VALID predicate with 
CONTENT option 


IS VALID predicate with 
SEQUENCE option 


IS VALID predicate: NAMESPACE 
without ELEMENT clause 


IS VALID predicate: NO 
NAMESPACE with ELEMENT 
clause 


Basic Information Schema for 
registered XML Schemas 
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Advanced Information Schema for 
registered XML Schemas 


XML null handling options 
NIL ON NO CONTENT option 


XML(DOCUMENT(UNTYPED)) 
type 


XML(DOCUMENT(ANY)) type 
XML(SEQUENCE) type 


XML(DOCUMENT(XMLSCHEMA)) 
type 


XML(CONTENT(XMLSCHEMA)) 
type 


XMLQuery 


XMLQuery: RETURNING 
CONTENT 


XMLQuery: RETURNING 
SEQUENCE 


XMLQuery: passing a context item 


XMLQuery: initializing an XQuery 
variable 


XMLQuery: EMPTY ON EMPTY 
option 


XMLQuery: NULL ON EMPTY 
option 


XML 1.1 support 


XML passing mechanism BY 
VALUE 


XML passing mechanism BY REF 
XML(CONTENT(UNTYPED)) type 
XML(CONTENT(ANY)) type 


RETURNING CONTENT in XML 
publishing 


RETURNING SEQUENCE in XML 
publishing 


Persistent XML values of 
XML(DOCUMENT(UNTYPED)) 


type 
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X263 


X264 
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X272 
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X301 


X302 


XML(DOCUMENT(ANY)) type 


Persistent XML values of 
XML(CONTENT(UNTYPED)) type 


Persistent XML values of 
XML(CONTENT(ANY)) type 


Persistent XML values of 
XML(SEQUENCE) type 


Persistent XML values of 
XML(DOCUMENT(XMLSCHEMA)) 


type 


Persistent XML values of 
XML(CONTENT(XMLSCHEMA)) 


type 
XML type: ELEMENT clause 


XML type: NAMESPACE without 
ELEMENT clause 


XML type: NO NAMESPACE with 
ELEMENT clause 


XML type: schema location 
XMLValidate: data-driven case 


XMLValidate: ACCORDING TO 
clause 


XMLValidate: ELEMENT clause 
XMLValidate: schema location 


XMLValidate: with DOCUMENT 
option 


XMLValidate with CONTENT 
option 


XMLValidate with SEQUENCE 
option 


XMLValidate NAMESPACE without 
ELEMENT clause 


XMLValidate: NO NAMESPACE 
with ELEMENT clause 


XMLTable 


XMLtTable: derived column list 
option 


XMLTable: ordinality column option 


X303 XMLTable: column default option 
X304 XMLTable: passing a context item 


XMLTable: initializing an XQuery 


X305 variable 
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版 本 说 明 包 含 每 个 PostgreSQL 版 本 中 重大 变化 ， 在 上 面 列 出 的 主要 特性 和 迁移 问题 。 版 本 
说 明 不 包含 只 影响 少数 用 户 或 者 改变 是 内 部 的 不 是 用 户 可 见 的 那些 变化 。 比如 ， 在 几乎 每 一 
个 版 本 中 都 会 改进 优化 器 。 但 是 这 种 改进 往往 通过 用 户 作 为 简单 快速 查询 被 观察 。 

每 个 版 本 变化 的 完整 列表 可 以 通过 查看 每 个 版 本 的 Git 日 志 获得 。 pgsql-committers email list 
也 记录 所 有 源 代码 变化 。 还 有 网 络 接口 显示 了 特定 文件 的 变化 。 


每 项 目 附近 出 现 的 名 称 代表 了 该 项 目的 主要 开发 人 员 。 当 然 所 有 的 变化 包含 社区 讨论 和 补丁 
检查 ， 因 此 每 个 项 目 真正 的 是 社区 的 努力 。 


E.1. 版 本 9.3.1 


发 布 日 期 : 2013-10-10 


这 个 版 本 包含 各 种 自 9.3.0 以 来 的 修复 。 关 于 9.3 主 版 本 的 新 特性 信息 ， 请 查看 Section E.2。 


E.1.1. 迁移 到 版 本 9.3.1 


运行 9.3.X 的 用 户 不 需要 转 储 /恢复 。 


E.1.2. 修改 列表 


。 用 JSON 功 能 更 新 hstore 扩 展 (Andrew Dunstan) 


在 9.3.2 之 前 安装 了 hstore 的 用 户 必须 执行 : 


ALTER EXTENSION hstore UPDATE; 


添加 两 个 新 的 JSON 画 数 和 一 个 计算 。 


修复 创建 范围 索引 时 的 内 存 泄露 (Heikki Linnakangas) 

。 序列 化 快照 修复 (Kevin Grittner Heikki Linnakangas) 

。 修复 libpq SSL 死 锁 错 误 (Stephen Frost) 

。 修复 pg_receivexlog 中 的 时 间 线 处 理 错误 (Heikki Linnakangas, Andrew Gierth) 
e 阻止 cREATE FUNCTION 检查 SET 变量 ， 除 非 启 用 函数 体检 查 (Tom Lane) 


。 删除 清理 没有 索引 的 表 期 间 罕 见 的 不 正确 的 警告 (Heikki Linnakangas) 


E.2. 版 本 9.3 


k #5 AHA: 2013-09-09 


E.2.1. 概述 


PostgreSQL 9.3 中 主要 的 改进 包括 : 
。 添加 物化 视图 
。 让 简单 的 视图 可 自动 更 新 
e 为 Json 数据 类 型 添加 许多 特性 ， 包 括 操作 符 和 男 数 ， 从 sson 值 中 提取 元 素 
。 为 FROM 子 句 子 查询 和 回 数 调用 实现 了 SQL 标 准 的 LATERAL 选项 
。 人 允许 外 部 数据 封装 器 支持 在 外 部 表 上 书写 〈 插 人 /更 新 /删除 ) 
e 添加 一 个 Postgres 外 部 数据 封装 器 ， 人 允许 访问 其 他 Postgres 服 务 器 
。 添加 对 事件 触发 器 的 支持 
。 添加 选择 能 力 到 checksum 数据 页 和 报告 损坏 
。 阻止 非 键 字段 行 更 新 阻塞 外 键 检 查 
。 大 大 的 减少 System V 共享 内 存 的 需求 


下 面 的 章节 是 对 以 上 条 例 更 加 详细 的 解释 。 


E.2.2. 迁移 到 版 本 9.3 


对 于 那些 想 要 从 任何 以 前 的 版 本 中 迁移 数据 的 人 来 说 ， 需 要 使 用 pg_dumpall 或 pg_upgrade 
转 储 / 恢 复 。 


版 本 9.3 包 含 一 些 可 能 影响 与 以 前 版 本 兼容 性 的 修改 。 观 察 下 列 的 不 兼容 性 : 


E.2.2.1. 服务 右 设 置 
e 重 命 名 replication_timeout 为 wal sender_timeout (Amit Kapila) 


这 些 设置 控制 WAL 发 送 超时 。 


要 求 超级 用 户 权 限 设置 comit delay, 因为 它 现 在 可 以 潜在 的 延迟 其 他 会 话 (Simon 
Riggs) 


允许 内 存 中 排序 使 用 它们 分 配 的 所 有 内 存 (Jeff Janes) 


基于 以 前 的 行为 设置 work_mem 的 用 户 可 能 需要 重新 访问 该 设置 。 


E.2.2.2. 其 他 


如 果 一 个 元 组 在 被 更 新 或 删除 之 前 早已 被 一 个 BEFORE 触发 器 更 新 或 删除 了 ， 则 抛 出 一 个 


44% (Kevin Grittner) 


以 前 ， 最 初 的 更 新 默默 的 跳 过 了 ， 导 致远 辑 上 的 不 一 致 性 ， 因 为 触发 器 可 能 基于 计划 更 
新 传播 数据 到 其 他 地 方 。 现在 抛 出 了 一 个 错误 ， 阻 止 不 一 致 的 结果 被 提交 。 如 果 这 个 改 
变 影响 了 你 的 应 用 ， 那么 最 好 的 解决 方法 通常 是 移动 数据 传播 动作 到 一 个 AFTER 触发 

器 。 

如 果 一 个 查询 中 调用 了 一 个 不 稳定 的 函数 修改 了 稍 后 该 查询 本 身 修改 的 行 ， 也 会 抛 出 这 
个 错误 。 这 样 的 情况 以 前 导致 默默 的 跳 过 更 新 。 


修改 多 行 字段 oN UPDATE SET NULL/SET DEFAULT 外 键 动作 ， 影 响 该 约束 的 所 有 字段 ， 不 只 
是 那些 在 uppate 中 修改 了 的 字段 (Tom Lane) 


以 前 ， 我 们 将 只 设置 这 些 对 应 于 uPDATE 修改 过 的 被 引用 字段 的 引用 字段 。 这 是 SQL-92 
要 求 的 ， 但 是 最 近 的 SQL 标 准 版 本 指定 了 新 的 行为 。 


如 果 searcn_path 改变 了 ， 则 强制 缓存 的 计划 重新 规划 (Tom Lane) 


以 前 ， 如 果 查 询 用 一 个 新 的 search_path 设置 重新 执行 ， 那么 早已 在 当前 的 会 话 中 生成 
的 缓存 的 计划 是 不 会 重 做 的 ， 导 致意 外 的 行为 。 


修复 to number(), 正确 的 处 理 一 个 句点 用 作 分 隔 符 (Tom Lane) 


以 前 ， 一 个 句点 被 看 做 是 一 个 小 数 点 ， 即 使 本 地 说 它 不 是 并 且 使 用 p 格式 代码 声明 本 地 
特定 的 小 数 点 的 使 用 。 如 果 也 使 用 了 Fm 格式 ， 那么 这 会 导致 错误 的 答案 。 


修复 strict 非 设置 返回 男 数 ， 让 在 它们 的 参数 中 的 设置 返回 函数 正确 的 返回 空 行 (Tom 
Lane) 


传递 到 严格 函数 的 空 值 应 该 导致 一 个 空 的 输出 ， 但 是 相反 的 ， 输 出 行 彻 底 被 压制 。 
在 一 个 连续 的 流 中 存储 WAL， 而 不 是 每 4GB 就 跳 过 最 后 16MB 段 (Heikki Linnakangas) 


以 前 ， 由 于 这 个 跳 过 ， 以 FF 结束 名 字 的 WAL 文 件 是 不 使 用 的 。 如 果 你 有 WAL 各 份 或 恢 
复 脚 本 考虑 到 这 种 行为 ， 将 需要 调整 它们 。 


在 pg_constraint.confmatchtype 中 ， 存储 缺 省 的 外 键 匹 配 类 型 (non- FULL , 
non- PARTIAL ) 为 s ， 人 代表" 简单 的 " (Tom Lane) 


以 前 这 种 情况 通过 u 表示 ， 人 代表" 未 指定 "。 


E.2.3. 修改 列表 


下 面 你 将 找到 PostgreSQL 9.3 和 以 前 的 主 版 本 之 间 详 细 的 变化 。 


E.2.3.1. ik 4 de 


E.2.3.1.1. 锁定 


。 阻止 非 键 字段 行 更 新 阻塞 外 键 检 查 (Álvaro Herrera, Noah Misch, Andres Freund, 
Alexander Shulgin, Marti Raudsepp, Alexander Shulgin) 


这 个 修改 提高 了 并 发 性 ， 并 减少 了 更 新 的 表 包 含 在 外 键 约 束 中 时 死 锁 的 可 能 性 。 

UPDATE 并 不 改变 任何 现在 在 行 上 采用 新 的 No KEY UPDATE 锁 模 式 的 外 键 中 引用 的 字段 ， 
虽然 外 键 约束 使 用 新 的 kEY sHaRe 锁 模式 ， 这 与 no KEY UPDATE 并 不 冲突 。 所 以 这 里 没 
有 阻塞 ， 除 非 修 改 了 外 键 字 段 。 


添加 配置 变量 lock timeout ， 允许 限制 一 个 会 话 将 等 待 多 长 时 间 去 请 求 任何 一 个 锁 
(Zoltan Boszormenyi) 


E.2.3.1.2. #45] 
。 为 范围 数据 类 型 添加 SP-GiST 支 持 (Alexander Korotkov) 
。 人 多 许 不 记录 GiST 索 引 (Jeevan Chalke) 


提高 GiST 索 引 插入 的 性 能 ， 通 过 有 多 个 同样 好 的 选择 时 随机 化 选择 页 面 来 实现 (Heikki 
Linnakangas) 


。 CHENG 75 851 FIH XE (Robert Haas) 

E.2.3.1.3. 优化 程序 
。 为 范围 类 型 收集 并 使 用 上 界 、 下 界 和 范围 长 度 的 直方 图 (Alexander Korotkov) 
e 为 索引 访问 改善 优化 器 的 成 本 估算 (Tom Lane) 


为 通过 散 列 聚集 实现 DISTINCT 改善 优化 器 的 哈 希 表 尺 寸 估计 (Tom Lane) 


抑制 非 操 作 符 结果 并 限制 规划 节点 (Kyotaro Horiguchi, Amit Kapila, Tom Lane) 


。 当 规 划 器 只 关心 总 的 开销 时 ， 通 过 没有 保持 规划 在 基本 的 便宜 启动 成 本 上 减少 规划 器 开 
销 (Tom Lane) 


E.2.3.1.4. 一 般 性 能 


添加 copy FREEZE 选项 ， 避免 稍 后 标记 元 组 为 冻结 的 开销 (Simon Riggs, Jeff Davis) 
e 改善 NuMERIC 计算 的 性 能 (Kyotaro Horiguchi) 
e 改善 等 待 comit delay 的 会 话 的 同步 (Peter Geoghegan) 
这 大 大 的 提高 了 commit_delay 的 有 效 性 。 
。 通过 不 要 截断 还 未 接触 任何 临时 表 的 事务 中 的 临时 表 ， 提 
高 


= CREATE TEMPORARY TABLE ... ON COMMIT DELETE ROWS 选项 的 性 能 (Heikki Linnakangas) 


让 清理 在 删除 过 期 的 元 组 之 后 重新 检查 可 见 性 (Pavan Deolasee) 
这 提高 了 页 面 被 标记 为 所 有 可 见 的 可 能 性 。 
。 添加 每 资源 所 有 者 锁 缓 存 (Jeff Janes) 
这 加 速 了 持 有 多 个 锁 的 多 语句 事务 中 语句 完成 时 的 锁 统计 ; 这 对 于 pg_dump 尤 其 有 用 。 
。 避免 在 一 个 创建 新 的 关系 的 事务 提交 时 打 描 整个 关系 缓存 (Jeff Janes) 
这 加 速 了 在 连续 的 小 事务 中 创建 许多 表 的 会 话 ， 比 如 运行 一 个 pg_restore 。 
。 提高 删除 许多 关系 的 事务 的 性 能 (Tomas Vondra) 


E.2.3.1.5. 监视 


e 添加 可 选 的 能 力 到 checksum 数据 页 并 报告 损坏 (Simon Riggs, Jeff Davis, Greg Smith, 
Ants Aasma) 


checksum 选 项 可 以 在 initdb 期 间 设 置 。 

。 分 离 统 计 收 集 器 的 数据 文件 到 独立 的 全 局 和 每 数据 库 文 件 (Tomas Vondra) 
这 减少 了 统计 数据 追踪 的 MO 需求 。 

。 修复 统计 收集 器 ， 以 便 在 系统 时 钟 倒退 的 情况 下 正确 的 操作 (Tom Lane) 
以 前 ， 统 计 收 集 器 会 停止 ， 直 到 时 间 再 次 到 达 最 后 记录 的 时 间 。 

。 当 我 们 想 要 在 这 里 停止 记录 时 ， 发 出 一 个 告知 性 的 消息 到 主 进程 标准 错误 (Tom Lane) 
这 会 帮助 用 户 减 少 在 主 进程 启动 期 间 只 记录 标准 错误 的 常见 配置 中 ， 在 哪里 查看 日 志 输 
出 的 混淆 。 

E.2.3.1.6. 认证 


e 当 发 生 认 证 失败 时 ， 记 录 相 关 的 py_hba.conf 行 ， 简化 意外 失败 的 调试 (Magnus 
Hagander) 


e 改进 LDAP 错 误 报 告 和 文档 (Peter Eisentraut) 


。 在 URL 格 式 中 添加 对 指定 LDAP 认 证 参数 的 支持 ， 每 RFC 4516 (Peter Eisentraut) 


e 修改 ssi ciphers BR, LA DEFAULT 启动 ， 而 不 是 以 ALL 启动 ， 然后 删除 不 安全 的 密码 
(Magnus Hagander) 


这 会 产生 一 个 更 合适 的 SSL 密 码 设置 。 
。 分 析 并 加 载 pg_ident.conf 一 次 ， 而 不 是 在 每 个 连接 中 (Amit Kapila) 


这 类 似 于 pg_hba.conf 的 义理 。 


E.2.3.1.7. 服务 器 设置 
。 大 大 的 减少 了 System V 共享 内 存 的 需求 (Robert Haas) 


在 类 Unix 的 系统 上 ， mmap() 现在 用 于 大 多 数 PostgreSQL 的 共享 内 存 。 对 于 大 多 数 用 
户 ， 这 将 消除 任何 为 共享 内 存 调 整 内 核 参数 的 需要 。 


。 人 允许 主 进程 监听 多 个 Unix 域 套 接 字 (Honza Horak) 


配置 参数 unix_socket_directory 被 unix_socket_directories 取代 ， 它 接受 一 个 路 径 列 


表 。 

© 人 允许 配置 文件 的 路 径 被 处 理 (Magnus Hagander, Greg Smith, Selena Deckelmann) 
这 样 一 个 路 径 在 服务 器 配置 文件 中 用 include_dir 指定 。 

e 为 shared buffers 增加 最 大 initdb 配 置 值 到 128MB (Robert Haas) 
这 是 initdb 打 算 在 postgresql.conf 中 设置 的 最 大 值 ; 以 前 的 最 大 值 是 32MB。 


。 在 主 进程 退出 时 ， 删 除外 部 PID 文 件 ， 如 果 有 (Peter Eisentraut) 


E.2.3.2. 复制 和 恢复 
。 人 允许 流 复制 备用 遵循 时 间 线 切换 (Heikki Linnakangas) 


这 人 允许 流 备用 服务 器 从 一 个 新 晋升 为 主要 地 位 的 伺服 接受 WAL 数 据 。 以 前 ， 其 他 各 用 会 
请 求 重新 同步 以 开始 跟随 新 的 主机 。 


e YMISQLHRM pg_is_in_backup() 和 pg_backup_start_time() (Gilles Darold) 





Hen BH oh ADHIKA. 
e 提高 synchronous_commit 禁用 时 流 日 志 切 换 的 性 能 (Andres Freund) 
。 人 多 许 更 快 的 晋升 流 各 用 为 主 服 务 器 (Simon Riggs, Kyotaro Horiguchi) 


。 添加 最 后 检查 点 的 重 做 位 置 到 pg_controldata 的 输出 (Fujii Masao) 


这 个 信息 对 于 确定 恢复 需要 哪个 WAL 文 件 是 有 帮助 的 。 


允许 像 pg_receivexlog 这 样 的 工具 用 不 同 的 架构 在 计算 机 上 运行 (Heikki Linnakangas) 


ee ese 但 是 他 们 现在 可 以 以 任意 架构 在 
机 器 上 传输 和 存储 ， 因为 流 复制 协议 现在 是 与 机 器 无 关 的 。 


e 让 pg_basebackup --write-recovery-conf 输出 一 个 最 小 的 recovery.conf 文件 (Zoltán 
Böszörményi, Magnus Hagander) 


这 简化 了 设置 一 个 备用 服务 器 。 


e 允许 pg_receivexlog 和 pg_basebackup --xlog-method 义理 流 时 间 线 切换 (Heikki 
Linnakangas) 


添加 wal_receiver_timeout 参数 控制 WAL 接 收回 的 超时 (Amit Kapila) 


这 人 允许 更 快速 的 检测 连接 失败 。 


改变 WAL 记 录 格 式 ， 以 允许 跨 页 面 分 离 记 录 头 (Heikki Linnakangas) 


新 的 格式 更 紧凑 ， 并 且 书 写 更 有 效 。 


E.2.3.3. 查询 


e 为 FROM 子 句 子 查询 和 吏 数 调用 实现 SQL 标 准 的 LATERAL 选项 (Tom Lane) 


个 特性 允许 FRoM 中 的 子 查询 和 加 数 从 FRoM 子 句 中 的 其 他 表 中 引用 字段 。 LATERAL 关 
we 先 的 。 


e 添加 对 输送 copy 和 psql \copy 数据 到 /从 一 个 外 部 程序 的 支持 (Etsuro Fujita) 


e 人 允许 规则 中 的 一 个 多 行 vALuEs 子 名 引用 oLp / new (Tom Lane) 


E.2.3.4. 对 象 操作 
。 添加 对 事件 触发 器 的 支持 (Dimitri Fontaine, Robert Haas, Alvaro Herrera) 
这 人 允许 DDL 命 令 运 行 时 ， 以 启用 事件 的 语言 书写 的 服务 器 端的 函数 被 调用 。 
。 人 允许 外 部 数据 封装 器 支持 在 外 部 表 上 写 入 〈 插 和 人 /更 新 /删除 ) (KaiGai Kohei) 
e 添加 CREATE SCHEMA ... IF NoT EXISTS 子 句 (Fabrizio de Royes Mello) 
e 让 REASSIGN owNED 也 修改 共享 对 象 的 所 有 权 (Alvaro Herrera) 


。 如 果 给 定 的 初始 值 字 符 串 对 于 事务 数据 类 型 来 说 不 是 有 效 的 输入 ， 那么 


jk CREATE AGGREGATE 投诉 (Tom Lane) 


e 抑制 cREATE TABLE 关于 隐 式 索引 和 序列 创建 的 消息 (Robert Haas) 
这 些 消息 现在 在 peEBu61 宛 长 模式 中 出 现 ， 所 以 它们 缺 省 将 不 显示 。 

。 当 一 个 不 存在 的 模式 在 表 名 中 指定 时 ， 人 允许 DROP TABLE IF EXISTS 成 功 (Bruce Momjian) 
以 前 ， 如 果 该 模式 不 存在 ， 它 抛 出 一 个 错误 。 

。 提供 带 有 约束 违反 细节 的 客户 端 作为 单独 的 字段 (Pavel Stehule) 
这 人 允许 客户 端 检索 表 、 字 段 、 数 据 类 型 或 约束 名 错误 细节 。 以 前 这 样 的 信息 必须 从 错误 
字符 串 中 提取 。 客户 端 库 支 持 需 要 访问 这 些 字段 。 

E.2.3.4.1. ALTER 

e 在 ALTER TYPE ... ADD VALUE 中 支持 IF NOT EXISTS 选项 (Andrew Dunstan) 
这 对 于 有 条 件 的 添加 值 到 枚 举 类 型 是 有 用 的 。 

e 添加 ALTER ROLE ALL SET 为 所 有 用 户 建立 设置 (Peter Eisentraut) 


这 允许 设置 应 用 到 所 有 数据 库 中 的 所 有 用 户 。 ALTER DATABASE SET 早已 允许 在 单个 数据 
库 中 为 所 有 用 户 添加 设置 。 postgresql.conf 也 有 类 似 作 用 。 


e 为 ALTER RULE ... RENAME 添加 支持 (Ali Dar) 


E.2.3.4.2. VIEWS 
e 添加 物化 视图 (Kevin Grittner) 


不 像 普通 视图 ， 基 础 表 是 读 取 每 个 访问 的 ， 物 化 视图 在 创建 或 刷新 时 创建 物理 表 。 访问 
物化 视图 然后 从 它 的 物理 表 中 读 取 。 现在 还 没有 任何 增 量 刷新 物化 视图 或 通过 基础 表 访 
问 自动 访问 它们 的 便利 。 

e 让 简单 视图 自动 可 更 新 (Dean Rasheed) 


从 一 个 基础 表 中 引用 一 些 或 所 有 字段 的 简单 视图 现在 缺 省 是 可 更 新 的 。 更 复杂 的 视图 可 
以 使 用 INsTEAD oF 触发 器 或 INSTEAD 规则 使 其 可 更 新 。 


e 添加 CREATE RECURSIVE VIEW 语法 (Peter Eisentraut) 
内 部 的 ， 这些 翻译 为 CREATE VIEW ... WITH RECURSIVE ... o 


。 改善 视图 /规则 打印 代码 ， 以 处 理 引 用 的 表 重 命名 或 字段 重 命 名 、 添 加 或 删除 了 的 情况 
(Tom Lane) 


表 和 字段 重 命名 会 产生 的 情况 是 : 如 果 我 们 只 是 替代 新 的 名 称 为 一 个 规则 或 视图 的 原始 


MA, 那么 结果 是 有 歧义 的 。 这 个 修改 修复 了 规则 转 储 代码 ， 当 需要 保存 原来 的 语义 
at, 插入 手动 制作 的 表 和 字段 别名 。 


E.2.3.5. 数据 类 型 
。 增加 大 对 象 的 最 大 尺寸 从 2GB 到 4TB (Nozomi Anzai, Yugo Nagata) 
这 个 修改 包括 添加 64 位 大 对 象 访 问 功能 ， 在 服务 器 中 和 libpq 中 。 
e 允许 文本 的 时 区 名 称 ， 比 如 ， "America/Chicago"， 在 ISO 格式 的 timestamptz 输入 
的 "T" 字 段 中 (Bruce Momjian) 
E.2.3.5.1. JSON 
。 IREME sson 值 中 提取 元 素 (Andrew Dunstan) 
© Sti ISON 和 值 被 转换 为 记录 (Andrew Dunstan) 


e 添加 函数 转换 标量 、 记 录 和 hstore 值 为 sson (Andrew Dunstan) 


E.2.3.6. 函数 


e 添加 array_remove() 和 array_replace() PMX (Marco Nenciarini, Gabriele Bartolini) 
e 人 允许 concat() 和 format() 正确 的 扩展 vARIADIC 标签 的 参数 (Pavel Stehule) 
e 改进 format() ， 提供 字段 宽度 和 左 / 右 对 齐 选项 (Pavel Stehule) 


e 让 to_char() ，to_date() ,和 to_timestamp() 正确 的 处 理 负 的 世纪 值 (BC) (Bruce 
Momjian) 


以 前 ， 该 行为 不 是 错误 就 是 与 正 的 /AD 义理 不 一 致 ， 比 如 ， 格式 标记 "I|YYY-IW-DY"。 


e i to date() 和 to _timestamp() 在 混合 ISO 和 Gregorian 周 /天 命名 时 返 反 回 正确 的 结果 
(Bruce Momjian) 


e 在 每 个 SELECT 目标 列表 项 和 FROM 项 之 后 ， 让 pg get viewdef() 缺 省 开始 一 个 新 行 
(Marko Tiikkaja) 


这 减少 了 视图 打印 中 的 线段 长 度 ， 例 如 在 pg_dump 的 输出 中 。 


e 修复 map_sql_value_to_xml_value() ， 以 与 基础 类 型 相同 的 打印 方式 ， 打印 域 类 型 的 值 
(Pavel Stehule) 





对 于 某 些 内 建 类 型 ， 比 如 boolean ， 有 特殊 的 格式 规则 ; 这 些 规则 现在 也 应 用 到 这 些 类 
型 上 的 域 。 


E.2.3.7. 服务 器 痕 的 语言 


E.2.3.7.1. PL/pgSQL 服 务 器 端 语 言 


。 人 允许 PL/pgSQL 使 用 带 有 复合 类 型 表达 式 的 RETUR (Asif Rehman) 
以 前 ， 在 一 个 返回 复合 类 型 的 函数 中 ， RETURN 只 能 引用 一 个 复合 类 型 的 变量 。 
。 人 允许 PL/pgSQL 作 为 单独 的 字段 存 取 约束 违反 细节 (Pavel Stehule) 
e 人 允许 PL/pgSQL 访 问 copy 处 理 的 行 数 (Pavel Stehule) 
PL/pgSQL 函 数 中 执行 的 copy 现在 更 新 通过 GET DIAGNOSTICS x = ROW COUNT 恢复 的 值 。 
。 人 允许 未 保留 的 关键 字 用 作 PL/pgSQL 中 的 标识 符 (Tom Lane) 
在 PL/pgSQL 语 法 中 的 某 些 地 方 ， 关 键 字 必须 加 引号 用 作 标 识 符 ， 即 使 它们 名 义 上 是 未 保 
留 的 。 
E.2.3.7.2. PL/Python 服 务 器 端 语 言 
。 添加 PL/Python 结 果 对 象 字符 串 义 理 器 (Peter Eisentraut) 
这 人 允许 plpy.debug(rv) 输出 合理 的 东西 。 
e 让 PL/Python 转 化 OID 值 为 一 个 适当 的 Python 数值 类 型 (Peter Eisentraut) 


。 义理 和 内 部 SPI 错 误 一 样 明 确 发 生 (用 PL/Python 的 raise ) 的 SPI 错 误 (Oskari Saarenmaa 
and Jan Urbanski) 


E.2.3.8. 服务 器 编程 接口 (SP1) 
。 阻止 SPI 元 组 表 在 子 事务 退出 期 间 泄 露 (Tom Lane) 


在 任何 失败 的 子 事务 的 结尾 ， 内 核 SPI 代 码 现 在 释放 任何 在 该 子 事务 期 间 创建 的 SPI 元 组 

Ro 这 避免 了 对 使 用 SPI 代 码 的 需要 ， 保 持 在 错误 恢复 代码 中 追踪 这 样 的 元 组 表 和 手动 释 
MEN. 未 能 这 样 做 会 在 PLUpgSQL 和 可 能 其 他 SPI 客 户 端 中 导致 一 些 事物 寿命 内 存 泄露 
问题 。 sPI_freetuptable() 现在 保护 自己 免 受 多 次 释放 请 求 ， 所 以 任何 现 有 代码 需要 小 
心 清理 ， 不 应 该 被 这 个 修改 破坏 。 


。 人 允许 SPI 画 数 访问 被 copy 处 理 的 行 数 (Pavel Stehule) 


E.2.3.9. 客户 端 应 用 
。 添加 命令 行 工 具 pg isready, 检查 服务 器 是 否 准 各 好 了 接受 连接 (Phil Sorber) 


e 为 pg_restore, clusterdb, reindexdb, 和 vacuumdb 支持 多 个 --table 参数 (Josh 
Kupershmidt) 


这 类 似 于 pg_dump 的 --table 选项 的 工作 方式 。 


e 添加 --dbname 选项 到 pg _dumpall, pg_basebackup, 和 pg _receivexlog， 允许 指定 一 个 


连接 字符 串 (Amit Kapila) 


e 添加 libpq 画 数 Paconninfo() ， 返回 连接 信息 (Zoltan Böszörményi, Magnus Hagander) 


E.2.3.9.1. psql 
。 调整 画 数 开销 设置 ， 这 样 psql 选 项 卡 实现 和 模式 搜索 更 有 效 (Tom Lane) 


e 提高 psql 的 选项 卡 实现 履 盖 (Jeff Janes, Dean Rasheed, Peter Eisentraut, Magnus 
Hagander) 


e 多 许 psql --single-transaction 模式 在 从 标准 输入 中 读 取 时 工作 (Fabien Coelho, Robert 
Haas) 


以 前 这 个 选项 只 在 从 一 个 文件 中 读 取 时 工作 。 
。 当 连 接 到 一 个 老 的 服务 器 时 ， 删 除 psql 警 告 (Peter Eisentraut) 
当 连 接 到 一 个 比 psq| 的 主 版 本 更 新 的 服务 器 时 ， 仍 然 发 出 一 个 警告 。 
E.2.3.9.1.1. 反 斜 杠 命 兮 
。 添加 psql 命 令 watch ， 重 复 的 执行 一 个 SQL 命令 (Will Leinweber) 
。 添加 psql 命 令 \gset ， 在 psql 变 量 中 存储 查询 结果 (Pavel Stehule) 
。 添加 SSL 信 息 到 psql 的 \conninfo 命令 (Alastair Turner) 
e 添加 "Security" 字 段 到 psql 的 \df+ 输出 (Jon Erdman) 
e 允许 psql 命 令 \1 接受 一 个 数据 库 名 字模 式 (Peter Eisentraut) 
。 在 psql 中 ， 如 果 没 有 活动 的 连接 ， 则 不 允许 \connect 使 用 缺 省 (Bruce Momjian) 
如 果 服务 器 骨 溃 可 能 会 出 现 这 种 情况 。 


在 用 psql 的 \g _file ”SQL 命令 执行 失败 之 后 正确 的 重 置 状态 (Tom Lane) 
以 前 ， 来 自 随后 的 SQL 命令 的 输出 会 意外 的 继续 进行 同一 个 文件 。 
E.2.3.9.1.2. 输出 
e 添加 一 个 latex-longtable 输出 格式 到 psql (Bruce Momjian) 
这 个 格式 允许 表 跨 越 多 个 页 面 。 
e 添加 border=3 输出 模式 到 psql latex 格式 (Bruce Momjian) 


。 在 psql 的 仅 元 组 和 扩展 输出 模式 中 ， 不 再 为 需 行 发 出 "(No rows)" (Peter Eisentraut) 


。 在 psql 的 未 对 齐 、 扩 展 输 出 模式 中 ， 不 再 为 需 行 输出 一 个 空 行 (Peter Eisentraut) 


E.2.3.9.2. pg_dump 
e 添加 pg_dump --jobs 选项 并 行 转 储 表 (Joachim Wieland) 
e 让 pg_dump 输 出 范 数 有 一 个 更 加 可 预见 的 顺序 (Joel Jacobson) 
。 修复 pg_dump 发 出 的 tar 文 件 ， 与 POSIX 一 致 (Brian Weaver, Tom Lane) 
e 添加 --dbname 选项 到 pg_dump， 与 其 他 客户 端 命令 一 致 (Heikki Linnakangas) 


最 后 提供 的 数据 库 名 可 能 没有 标志 。 


E.2.3.9.3. initdb 
e 让 initdb 同 步 最 近 创 建 的 数据 目录 (Jeff Davis) 


这 确保 了 在 initdb 之 后 很 快 系统 崩溃 情况 下 的 数据 完整 性 。 可 以 使 用 --nosync 禁用 此 功 


能 。 
e 添加 initdb --sync-only 选项 同步 数据 目录 到 持久 存储 (Bruce Momjian) 
这 是 通过 pg_upgrade 使 用 的 。 
。 在 文件 系统 的 挂 载 点 上 放置 数据 目录 时 ， 让 initdb 发 出 一 个 警告 (Bruce Momjian) 


E.2.3.10. 源 代码 


。 添加 基础 设施 以 允许 插件 后 端 工作 进程 (Alvaro Herrera) 
。 创建 一 个 集中 的 超时 API (Zoltan Böszörményi) 


。 创建 libpgcommon 并 删除 这 里 的 pg_malloc() AH Hh RX (Alvaro Herrera, Andres 
Freund) 


这 人 允许 libpgport 只 用 于 可 移植 性 相关 的 代码 。 
© 为 戏 入 在 较 大 结构 内 的 列表 连接 添加 支持 (Andres Freund) 
。 为 所 有 信号 使 用 sA_RESTART ， 包 括 st6ALRM (Tom Lane) 


确保 在 翻译 errcontext() 消息 时 使 用 了 正确 的 文本 域 (Heikki Linnakangas) 


标准 化 命名 客户 端 侧 的 内 存 分 配 本 数 (Tom Lane) 


。 如 果 某 些 编译 时 常量 条 件 不 符合 ， 那 么 为 "静态 断言 " 提供 支持 将 会 在 编译 时 失败 (Andres 
Freund, Tom Lane) 


在 客户 端 侧 代码 中 支持 Assert() (Andrew Dunstan) 


添加 修饰 以 通知 C 编 译 器 一 些 ereport() 和 elog() 调用 不 返回 (Peter Eisentraut, Andres 
Freund, Tom Lane, Heikki Linnakangas) 


人 允许 选项 通过 PG REGRESS_DIFF_OPTS 传递 到 回 轨 测试 输出 比较 工具 中 (Peter Eisentraut) 
为 CREATE INDEX CONCURRENTLY 添加 隔离 测试 (Abhijit Menon-Sen) 

删除 类 型 定义 int2 / int4 ， 因 为 他 们 更 好 的 表现 为 int16 / int32 (Peter Eisentraut) 
修复 Mac OS X 上 的 install-strip (Peter Eisentraut) 

删除 configure 标 志 --disable-shared ， 因为 不 再 支持 它 了 (Bruce Momjian) 

在 Perl 中 重 写 pgindent (Andrew Dunstan) 

提供 Emacs 宏 设置 Perl 格 式 匹配 PostgreSQL 的 perltidy 设 置 (Peter Eisentraut) 

运行 工具 检查 关键 字 列 表 ， 查 看 何 时 后 端 语法 发 生 了 改变 (Tom Lane) 

改变 UESCAPE lex 的 方式 ， 大 大 的 减少 了 词法 分 析 程序 表 的 大 小 (Heikki Linnakangas) 
集中 flex 和 bison make 规 则 (Peter Eisentraut) 

这 对 于 pgxs 作 者 是 有 用 的 。 

修改 许多 内 部 后 端 画 数 ， 返 回 对 象 or 而 不 是 空 (Dimitri Fontaine) 

这 对 于 事件 触发 器 是 有 用 的 。 

为 事务 回调 构造 pre-commit/pre-prepare/pre-subcommit 事 件 (Tom Lane) 

使 用 事务 回调 的 可 加 载 模块 可 能 需要 修改 ， 以 处 理 这 些 新 的 事件 类 型 。 

添加 回 数 pg_identify_object() ， 生产 一 个 机 器 可 读 的 数据 库 对 象 的 描述 (Álvaro 


Herrera) 

添加 在 acter 对 象 之 后 的 服务 器 挂 钧 (KaiGai Kohei) 

实现 一 个 通用 二 进 制 堆 并 将 它 用 于 合并 附加 操作 (Abhijit Menon-Sen) 
提供 一 个 工具 在 更 新 src/timezone/data 文件 时 ， 帮 助 检测 时 区 缩写 改变 (Tom Lane) 

为 libpq 和 ecpg 库 添加 pkg-config 支 持 (Peter Eisentraut) 

删除 src/tool/backend ， 因 为 该 内 容 在 PostgreSQL wiki 上 (Bruce Momjian) 

分 离 WAL 读 取 作 为 一 个 独立 的 设施 (Heikki Linnakangas, Andres Freund) 

使 用 64 位 整数 表示 WAL 位 置 ( xLogRecPtr )， 替代 两 个 32 位 的 整数 (Heikki Linnakangas) 


通常 ， 需 要 读 取 WAL 格 式 的 工具 将 需要 调整 


允许 PL/Python 支 持平 台 特定 的 包含 路 径 (Peter Eisentraut) 


允许 OS X 上 的 PL/Python 建立 Python 的 定制 版 本 (Peter Eisentraut) 


E.2.3.11. 附加 的 模块 


E.2. 


添加 一 个 Postgres 外 部 数据 封装 器 贡献 模块 ， 以 允许 访问 其 他 Postgres 服 务 器 (Shigeru 
Hanada) 


这 个 外 部 数据 封装 器 支持 写 。 

添加 pg_xlogdump 贡 献 程 序 (Andres Freund) 

添加 对 在 pg_trgm 中 索引 正则 表达 式 搜 索 的 支持 (Alexander Korotkov) 
改善 pg_trgm 对 多 字 节 字符 的 处 理 (Tom Lane) 


在 一 个 没有 wcstombs() 或 towlower() 库 图 数 的 平台 上 ， 这 会 导致 pg_trgm 索引 内 容 中 非 
ASCIl 数 据 的 不 兼容 的 改变 。 在 这 样 的 情况 下 ， REINDEX 这 些 索 引 以 确保 正确 的 搜索 结 
果 。 


添加 一 个 pgstattuple 画 】 数 ， 报 告 GIN 索引 等 待 插入 的 列表 的 大 小 (Fujii Masao) 

让 oid2name, pgbench, 和 vacuumlo 设 置 fallback_application_name (Amit Kapila) 
改善 pg_test_timing 的 输出 (Bruce Momjian) 

改善 pg_test_fsync 的 输出 (Peter Geoghegan) 


创建 一 个 专用 的 外 部 数据 封装 器 ， 带 有 它 自己 的 选项 验证 器 范 数 ， dblink (Shigeru 
Hanada) 


当 使 用 这 个 FDW 定 义 一 个 dblink 连 接 的 目标 时 ， 取 代 使 用 连接 选项 的 硬 连 线 列 表 ， 咨询 
底层 的 libpq 库 查看 支持 哪个 连接 选项 。 

3.11.1. pg_upgrade 

允许 pg_upgrade 并 行 转 储 和 恢复 (Bruce Momjian, Andrew Dunstan) 


这 人 允许 数据 库 的 并 行 模式 转 储 /恢复 ， 也 人 允许 每 个 表 空 间 并 行 拷贝 /连接 数据 文件 。 使 
用 --jobs 选项 指定 并 行 的 级 别 。 


让 pg_upgrade 在 当前 目录 中 创建 Unix 域 套 接 字 (Bruce Momjian, Tom Lane) 
这 减少 了 在 升级 期 间 某 个 人 意外 连接 的 可 能 性 。 


让 pg_upgrade --check 模式 正确 的 检测 非 缺 省 套 接 字 目 录 的 位 置 (Bruce Momjian, Tom 
Lane) 


为 拥有 许多 表 的 数据 库 提高 pg_upgrade 的 性 能 (Bruce Momjian) 
显示 执行 的 命令 改进 pg_upgrade 的 日 志 (Alvaro Herrera) 


通过 
改进 拷贝 /连接 期 间 pg_upgrade 的 状态 显示 (Bruce Momjian) 


E.2.3.11.2. pgbench 


添加 --foreign-keys 选项 到 pgbench (Jeff Janes) 

这 添加 了 外 键 约束 到 pgbench 创 建 的 标准 表 ， 用 于 外 键 性 能 测试 。 
允许 pgbench 集 合 性 能 统计 和 每 --aggregate-interval 秒 产 生 输 出 (Tomas Vondra) 
添加 pgbench --sampling-rate 选项 ， 控制 事务 日 志 的 百分比 (Tomas Vondra) 
减少 并 改进 pgbench 的 初始 化 模式 的 状态 消息 输出 (Robert Haas, Peter Eisentraut) 
添加 pgbench -q 模式 ， 每 5 秒 打 印 一 行 输出 (Tomas Vondra) 
在 初始 化 期 间 输 出 pgbench 经 过 和 预 估 的 剩余 时 间 (Tomas Vondra) 


允许 pgbench 使 用 更 大 的 比例 系数 ， 当 请 求 的 比例 系数 超过 20000 时 ， 改变 相关 的 字段 
从 integer 到 bigint (Greg Smith) 


E.2.3.12. 文档 


允许 创建 EPUB 格 式 文档 (Peter Eisentraut) 

更 新 FreeBSD 内 核 配 置 文档 (Brad Davis) 

改进 wINDow JUX (Bruce Momjian, Florian Pflug) 

添加 使 用 说 明 ， 在 Mac OS X 上 建立 文档 工具 链 (Peter Eisentraut) 


改进 commit delay 文档 (Peter Geoghegan) 


E.3. 版 本 9.2.5 


发 布 日 期 : 2013-10-10 


该 版 本 包含 来 自 9.2.4 的 各 种 修复 。 关 于 9.2 主 要 版 本 新 功能 的 信息 ， 请 参阅 Section E.8。 


E.3.1. 迁移 到 版 本 9.2.5 


为 了 运行 9.2.X 不 需要 转 储 / 恢 复 。 
同时 ， 如 果 你 是 从 早 于 9.2.2 的 版 本 上 更 新 ， 参 阅 9.2.2 发 布 说 明 。 


E.3.2. 变化 


。 [防止 多 字 节 编码 中 非 ASClIl 非 双 引 号 标识 符 的 小 写 转 换 (Andrew Dunstan) 
以 前 的 操作 是 错误 的 而 且 混乱 的 。 
e 当 创 建 范围 索引 时 修复 内 存 泄露 。(Heikki Linnakangas) 
e 当 wal level = hot_standby 的 时 候 ， 修 复 后 端 写 进 程 中 检查 点 内 存 泄露 。(Naoya Anzai) 
。 修复 通过 1o_open() 故障 产生 的 内 存 泄露 。(Heikki Linnakangas) 
e 当 work_mem 正 使 用 大 于 24GB 的 内 存 时 ， 那 么 修复 内 存 过 量 使 用 错误 。(Stephen Frost) 
。 可 串 行 化 快照 修复 (Kevin Grittner, Heikki Linnakangas) 
e 修复 libpq SSL 死 锁 错 误 (Stephen Frost) 
。 修复 线程 ibpq 应 用 中 可 能 的 SSL 网 络 堆 变化 (Nick Phillips, Stephen Frost) 
。 当 在 通用 和 自 定义 计划 之 间 选 择 时 ， 提 高 计划 成 本 估计 (Tom Lane) 
当 计划 成 本 高 时 ， 那 么 该 变化 将 有 利于 通用 计划 。 
。 正确 计算 估计 布尔 列 包含 许多 NULL 值 的 行 (Andrew Gierth) 


当 估 计 计 划 成 本 时 ， 先 前 的 测试 像 col Is NOT TRUE 和 col IS NOT FALSE 没有 合理 的 
NULL 值 因素 。 


。 修复 UNION ALL 并 且 继 承 查 询 以 正确 重新 检查 参数 化 路 径 (Tom Lane) 
修复 不 理想 的 查询 规划 潜在 地 被 选择 的 情况 。 


e IIED wer 子 句 到 不 安全 的 UNION/INTERSECT 子 查询 中 (Tom Lane) 


这 样 登 加 可 能 产生 错误 。 

修复 通过 不 恰当 地 处 理 日 期 类 型 修饰 符 产 生 的 罕见 的 croup BY 查询 错误 (Tom Lane) 
修复 有 删除 列 的 外 表 的 pg_dump (Andrew Dunstan) 

先前 这 种 情况 可 能 导致 pg_upgrade 错 误 。 

重新 安排 相关 扩展 规则 的 pg_dump 你 理 和 事件 触发 (Joe Conway) 

如 果 通 过 pg_dump -t 或 者 -n 指定 ， 那 么 强制 扩展 表 转 储 (Joe Conway) 

允许 转 储 编码 更 好 地 人 处理 基本 表 上 已 删除 的 列 (Tom Lane) 

使 用 显示 正确 格式 名 的 目录 为 档 修 复 pg_restore -1 (Fujii Masao) 

正确 记录 使 用 uNIQUE 和 PRIMARY KEY 语法 创建 的 索引 注释 (Andres Freund) 

这 将 修复 并 行 pg_restore 故 障 。 


造成 pg_basebackup -x 使 用 空 xlog 目 录 抛 出 错误 而 不 是 骨 溃 的 原因 (Magnus Hagander, 
Haruka Takatsuka) 


清理 切换 之 前 合理 保证 WAL 文 件 传输 (Fujii Masao) 
以 前 ， 在 备 库 上 所 有 WAL 文 件 被 取代 之 前 可 能 关闭 流 复制 连接 。 
在 恢复 期 间 提 高 WAL 段 时 间 线 处 理 (Heikki Linnakangas) 


修复 REINDEX TABLE 和 REINDEX DATABASE 以 恰当 的 重新 生效 约束 并 且 标 记 无 效 索 引 为 有 
效 (Noah Misch) 


REINDEX INDEX 一 直 正 常 工作 。 

在 插入 SP-GiST 索 引 期 间 避 免 死 锁 (Teodor Sigaev) 

在 并 发 CREATE INDEX CONCURRENTLY 操作 期 间 修 复 可 能 死 锁 (Tom Lane) 
修复 GiST 索 引 查找 骨 溃 (Tom Lane) 

修复 regexp_matches() 义理 需 长 度 匹 配 (Jeevan Chalke) 

KA, SKE LAR A LR ERS Lec. 

修复 过 于 复杂 的 正则 表达 式 的 错误 (Heikki Linnakangas) 

为 反 向 引用 结合 非 贫 禁 量词 修复 正则 表达 式 匹 配 错误 (Jeevan Chalke) 
避免 CREATE FUNCTION 检查 SET 变量 除非 启动 画 数 体检 查 (Tom Lane) 


人 允许 ALTER DEFAULT PRIVILEGES 在 模式 上 操作 不 需要 CREATE 权 限 (Tom Lane) 


放宽 用 于 查询 中 关键 字 的 限制 (Tom Lane) 
特别 地 ， 放 宽 角 色 名 称 ， 语 言 名 字 ， EXPLAIN 和 copy wm, LAM ser 值 的 关键 字 限 


制 。 这 人 允许 COPY ... (FORMAT BINARY) 事先 BINARY 需要 单 引 号 。 
在 copy 失败 期 间 打 印 合适 行 数 (Heikki Linnakangas) 
修复 pgp_pub_decrypt() 因此 为 带 有 密码 的 秘 钥 工 作 (Marko Kreen) 


pg_upgrade 使 用 agt;pg_dump --quote-all-identifiers 避免 在 版 本 之 间 关 键 字 改变 的 问 
题 (Tom Lane) 


在 清理 无 索引 表 中 删除 少 有 的 不 正确 的 警告 (Heikki Linnakangas) 

在 已 取消 文件 截断 请 求 后 提高 分 析 统 计生 成 (Kevin Grittner) 

当 在 预备 查询 中 执行 事务 控制 命令 (比如 RoLLBACK ) 时 ， 避 人 免 可 能 的 失败 (Tom Lane) 
允许 在 所 有 平台 上 无 穷 大 的 各 种 拼写 (Tom Lane) 

支持 无 穷 大 的 值 是 "inf', "+inf", "-inf", "infinity", "+infinity" 和 "-infinity"。 

当 关 闭 track_activities 的 时 候 ， 避 免 不 必 要 报告 (Tom Lane) 

扩展 记录 和 数组 比较 行 的 能 力 (Rafal Rzepecki,Tom Lane) 

当 psql 的 PsQLRc 变量 包含 一 个 波浪 号 防止 骨 溃 (Bruce Momjian) 

添加 spinlock 支 持 ARM64 (Mark Salter) 


为 了 lsrael, Morocco, Palestine,Paraguay 中 DST 交 化 规律 的 DST 交 化 规律 更 新 时 间 区 域 
数据 文件 到 tzdata 版 本 2013d。 同时 为 Macquarie lsland 修 正 历史 区 域 数据 (Tom Lane) 


E.4. 版 本 9.2.4 


发 布 日 期 : 2013-04-04 


该 版 本 包含 了 9.2.3 的 各 种 修复 。 关 于 9.2 主 要 版 本 的 新 功能 信息 ， 请 参阅 Section E.8。 


E.4.1. 迁移 到 版 本 9.2.4 


为 了 运行 9.2.X 不 需要 转 储 /恢复 。 


然而 ， 该 版 本 修正 了 GiST 索 引 管 理 的 一 些 错误 。 在 安装 这 个 更 新 之 后 ，_REINDEX 任何 GiST 索 
引 满足 一 个 或 更 多 个 下 面 描述 的 条 件 是 明智 的 。 


同时 ， 如 果 你 正 从 9.2.2 更 早 版 本 中 更 新 ， 参 闵 9.2.2 的 发 布 说 明 。 


E.4.2. 变化 


。 修复 服务 器 命令 行 开 关 安 全 解析 (Mitsumasa Kondo, Kyotaro Horiguchi) 


包含 以 " - "开头 的 数据 库 名 字 的 连接 请 求 可 以 用 来 损坏 或 者 破坏 服务 器 的 数据 目录 文 
件 ， 即 使 最 终 拒绝 该 请 求 。(CVE-2013-1899) 


。 在 每 个 postmaster 子 进程 中 重 置 OpenSSL 随 机 状态 (Marko Kreen) 


通过 contrib/pgcrypto 函数 产生 的 随机 数 可 能 对 于 另外 一 个 猜测 的 数据 库 用 户 相 对 容 
易 ， 避 免 这 种 情况 。 当 postmaster 使 用 ssl = on 被 配置 时 ， 该 风险 是 非常 显著 的 ， 但 
是 大 多 数 连 接 不 能 使 用 SSL 加 密 。 (CVE-2013-1900) 


e 使 用 REPLICATION 权 限 检查 测试 当前 用 户 不 是 认证 用 户 (Noah Misch) 


一 个 未 经 授权 的 数据 库 用 户 可 以 利用 这 个 错误 调用 pg_start_backup() 或 
者 pg_stop_backup() ,因此 可 能 干扰 常规 备份 的 创建 。(CVE-2013-1901) 


。 当 不 适合 这 样 执 行 时 ， 不 使 用 "fuzzy" 几 何 比 较 修复 GiST 素 引 。(Alexander Korotkov) 


核心 几何 类 型 使 用 "fuzzy" 等 式 执 行 比较 ， 但 是 gist_box_same 必须 执行 精确 比较 ， 否 则 
GiST 索 引 使 用 它 可 能 变 得 不 一 致 。 安 装 这 个 更 新 之 后 ， 用 户 应 该 在 box, polygon ， 
circle 或 者 point 列 上 REINDEX 任何 GiST 索 引 ， 因 为 所 有 这 些 使 用 gist_box_same o 


。 修复 不 正确 的 范围 并 集 以 及 为 了 可 变 宽 度数 据 类 型 使 用 contrib/btree_ gist 的 GiST 素 引 
中 惩罚 逻辑 ， 也 就 是 text, bytea, bit 和 numeric 列 (Tom Lane) 


这 些 错 误 可 能 导致 不 一 致 索引 ， 其 中 一 些 出 现 的 关键 字 不 会 被 搜索 发 现 ， 并 且 在 无 用 的 
索引 膨胀 中 ， 在 安装 此 更 新 后 建议 用 户 REINDEX 这 种 索引 。 


修复 为 多 列 索 引 在 GiST 页 中 分 离 代码 的 错误 (Tom Lane) 


这 些 错 误 可 能 导致 不 一 致 索引 ， 其 中 一 些 出 现 的 关键 字 不 会 被 搜索 发 现 ， 并 且 在 索引 中 
是 不 必要 的 无 效 的 搜索 。 在 安装 此 更 新 后 建议 用 户 REINDEX 多 列 GiST 索 引 。 


修复 gist_point_consistent 处 理 模 糊 一 致 性 (Alexander Korotkov) 


在 point 列 GiST 索 引 上 的 素 引 打 描 可 能 有 时 产生 不 同 于 顺序 打 描 的 结果 ， A 
为 gist_point_consistent 不 同意 底层 操作 编码 关于 是 否 精 确 或 者 模糊 的 执行 比较 。 


在 WAL 重 放 中 修复 缓冲 区 泄露 (Heikki Linnakangas) 
在 回放 期 间 这 个 缺陷 可 能 产生 "不 正确 的 本 地 针 数 "错误 ， 使 得 恢复 不 可 能 。 


确保 我 们 在 进入 兴 档 恢复 前 执行 故障 修复 ， 如 果 数 据 库 没 有 规则 地 中 断 ， 并 
且 recovery.conf 文件 是 存在 的 (Heikki Linnakangas, Kyotaro Horiguchi, Mitsumasa 
Kondo) 


这 需要 确保 数据 库 在 一 定 情况 下 的 一 致 性 ， 比如 初始 化 一 个 来 自 运行 的 服务 器 上 的 文件 
系统 快照 的 备用 服务 器 。 


避免 在 月 淡 恢复 期 间 删 除 未 为 档 的 WAL 文 件 (Heikki Linnakangas, Fujii Masao) 
修复 DELETE RETURNING 中 的 亲 乱 情况 (Tom Lane) 


在 这 样 的 情况 下 ， DELETE RETURNING 试图 从 当前 进程 不 再 有 任何 针 的 共享 缓冲 区 中 抓 取 
数据 。 如 果 一 些 其 他 进程 同时 改变 缓冲 区 ， 这 将 导致 垃圾 RETURNING WW, BAAR. 


修复 规则 表达 式 编 译 中 的 无 限 循环 风险 (Tom Lane, Don Porter) 
修复 规则 表达 式 编 译 中 潜在 的 空 指针 引用 (Tom Lane) 
合适 的 地 方 修复 to_char() R(EAASCIA) SH & 2] (Tom Lane) 


这 种 修复 一 些 区 域 独 立 化 的 模板 模式 的 不 当 行为 ， 但 是 在 Turkish 区 域 中 胡乱 操作 " TI "和 


修复 时 间 戳 1999-12-31 24:00:00 不 必要 的 拒绝 (Tom Lane) 

修复 SQL 语言 范 数 可 以 安全 的 用 于 支持 范围 类 型 的 范 数 (Tom Lane) 

当 一 个 事务 执行 UNLISTEN 然后 Listen 时 ， 修 复 远 辑 错 误 (Tom Lane) 

该 会 话 根本 不 监听 通知 事件 ， 尽 管 它 确 实在 这 种 情况 下 应 该 监听 。 

在 列 被 添加 到 依赖 于 其 他 视图 的 视图 中 之 后 修复 可 能 的 规划 器 崩溃 (Tom Lane) 


修复 EXPLAIN (ANALYZE, TIMING OFF) 中 的 性 能 问题 (Pavel Stehule) 
删除 无 效 的 "picksplit 不 支持 的 二 次 分 裂 "日 志 消息 (Josh Hansen, Tom Lane) 


该 消息 似乎 被 添加 到 从 未 写 和 的 期 望 代 码 中 ， 并 且 可 能 从 来 不 是 ， 因 为 二 次 分 裂 的 GiST 
的 缺 省 处 理 实际 上 相当 好 。 所 以 停止 打扰 关于 它 的 最 终 用 户 。 


删除 gist_box_picksplit() 中 残留 的 二 次 分 裂 支持 (Tom Lane) 


这 不 仅 是 二 次 分 裂 的 实现 不 如 缺 省 实现 ， 它 实际 上 更 糟 。 所 以 删除 它 并 让 和 缺 省 代码 路 径 
义理 该 情况 。 


修复 发 送 会 话 的 最 后 几 个 事务 提交 /终止 计数 到 统计 收集 器 的 可 能 错误 (Tom Lane) 
消除 在 PL/Perl 中 的 spi_prepare() WAHIA (Alex Hunsaker, Tom Lane) 
修复 pg_dumpall 以 义理 正确 包含" = "的 数据 库 名 字 (Heikki Linnakangas) 

当 给 定 一 个 不 正确 的 连接 字符 上 串 时 ， 避 免 pg_dump 中 崩溃 (Heikki Linnakangas) 
忽略 pg_dump 和 pg_upgrade 中 的 无 效 素 引 (Michael Paquier, Bruce Momjian) 


各 份 无 效 素 引 可 能 导致 恢复 时 间 的 问题 ， 比如 如 果 索 引 创建 失败 的 原因 是 它 试 图 强制 不 
满足 表 的 数据 的 唯一 性 条 件 。 同 时 ， 如 果 素 引 创建 实际 上 仍然 在 进行 中 ， 认为 它 是 一 个 
不 受 约束 的 DDL 变 化 似乎 是 合理 的 ， 其 中 pg_dump 不 期 望 各 份 。pg_upgrade 现 在 也 跳 过 
无 效 素 引 而 非 失败 。 


在 pg_basebackup 中 ， 当 各 份 表 空 间 时 ， 仅 仅 包 含 当前 服务 器 版 本 的 子 目录 (Heikki 
Linnakangas) 


在 pg_basebackup 和 pg_receivexlog 中 添加 服务 器 版 本 检查 ， 因此 它们 与 不 工作 的 版 本 
联合 失败 (Heikki Linnakangas) 


修复 contrib/dblink 以 安全 地 处 理 patestyle 或 者 Intervalstyle 的 不一致 设置 (Daniel 
Farina, Tom Lane) 


先前 ， 如 果 远 程 服务 器 有 这 些 人 参数 的 不 同 设置 ， 可 能 错误 地 污 取 模糊 日 期 。 这 个 修复 确 
保 了 通过 dblink 查询 抓 取 的 日 期 时 间 和 间隔 列 将 正确 的 被 解释 。 注意 然而 这 个 不 一 致 的 
设置 仍然 有 风险 ， 因 为 出 现在 SQL 命令 中 发 送 到 远程 服务 器 的 文本 值 可 能 比 他 们 局 部 的 
有 不 同 的 解释 。 


修复 contrib/pg_trgm 的 similarity) 辑 数 为 少 于 三 个 的 字符 串 返 回 需 (Tom Lane) 
先前 它 返回 NaN 由 于 内 部 除 以 需 。 
使 用 Microsoft Visual Studio 2012 启动 编译 PostgreSQL (Brar Piening, Noah Misch) 


为 了 Chile, Haiti, Morocco, Paraguay 和 一 些 Russian 区 域 中 DST 变 化 规律 更 新 时 间 区 域 数 
据 文件 到 tzdata 版 本 2013d。 同时 为 更 多 地 方 修正 历史 区 域 数据 。 


同时 ， 为 俄罗斯 和 其 他 地 方 的 最 近 变 化 更 新 时 区 缩写 文件 : cHoT, GET, IRKT, KGT, 

KRAT ，MAGT ，MAWT ，MSK ，NOVT ，OMST ，TKT ，VLAT ，WsT ，YAKT ，YEKT 现在 遵从 他 
们 当前 的 含义 ， 以 及 vorr (Europe/Volgograd) 和 MIsT (Antarctica/Macquarie) 被 添加 

到 缺 省 缩写 列表 中 。 


E.5. 版 本 9.2.3 


发 布 日 期 : 2013-02-07 


此 版 本 包含 了 9.2.2 各 种 修复 。 关 于 9.2 主 要 版 本 的 新 功能 的 信息 ， 人 参阅 Section E.8。 


E.5.1. 迁移 到 版 本 9.2.3 


为 了 运行 9.2.X 不 需要 转 储 /恢复 。 


然而 ， 如 果 你 是 从 早 于 9.2.2 的 版 本 上 更 新 ， 参 阅 9.2.2 发 布 说 明 。 


E.5.2. 变化 


防止 来 自 SQL 的 enum_recv 的 执行 (Tom Lane) 


轴 数 被 错误 声明 ， 人 允许 简单 SQL 命 全 导致 服务 器 月 溃 。 原 则 上 攻击 者 可 以 使 用 它 检查 
te 我 们 该 感谢 Sumit Soni (通过 Secunia SVCRP) 报 告 这 个 问题 。 
(CVE-2013-0255) 


当 检 测 WAL 回 放 期 间 达 到 一 致 性 数据 库 状态 时 ， 修 复 多 个 问题 。 (Fujii Masao, Heikki 
Linnakangas, Simon Riggs, Andres Freund) 


当 不 需要 实际 恢复 工作 时 ， 修 复 结束 各 份 点 检查 (Heikki Linnakangas) 

这 个 错误 可 能 导致 不 正确 的 "在 线 备份 结束 之 前 WAL 结 束 "错误 。 

当 截 断 关系 文件 时 更 新 最 小 恢复 点 (Heikki Linnakangas) 

一 旦 数据 被 丢弃 ， 在 时 间 线 中 的 早 一 点 停止 恢复 不 再 安全 。 

在 改变 恢复 目标 时 间 线 之 后 修复 WAL 段 重新 回收 利用 (Heikki Linnakangas) 
正确 地 恢复 来 自 级 联 各 用 服务 器 上 为 档 的 时 间 线 历史 文件 (Heikki Linnakangas) 
修复 热 各 份 服务 器 上 的 锁 冲 突 检测 (Andres Freund, Robert Haas) 

修复 热 各 份 模式 中 错过 的 取消 事件 (Noah Misch, Simon Riggs) 

取消 冲突 的 热 备 查询 的 需求 有 时 会 被 错过 ， 人 允许 这 些 查询 查看 不 一 致 数据 。 

用 户 可 以 连接 之 前 防止 从 暂停 中 恢复 暂停 功能 (Tom Lane) 


修复 SQL 语法 以 允许 下 标 或 者 来 自 子 SELECT 结果 的 字段 选择 (Tom Lane) 


解决 繁忙 工作 负载 下 的 自动 清理 截断 的 性 能 问题 (Jan Wieck) 


在 表 末尾 的 空白 页 截断 需要 排他 锁 ， 但 是 当 有 冲突 的 锁 请 求 时 ， 自 动 清理 编码 失败 (并 
且 释 放 表 锁 ) 。 在 负载 下 ， 截 断 不 会 发 生 是 可 能 的 ， 导 致 表 膨 胀 。 通 过 执行 部 分 截断 进 
HES, 释放 锁 ， 然 后 尝试 重新 获取 锁 并 且 继 续 。 该 修复 在 冲突 请 求 到 达 后 自动 清理 释 
放 锁 之 前 将 大 大 减少 平均 时 间 。 


提高 sPI_execute 的 性 能 以 及 相关 画 数 ， 从 而 提高 了 PL/pgSQL 的 execute (Heikki 
Linnakangas, Tom Lane) 


删除 一 些 数 据 拷贝 开销 ， 它 被 增加 到 9.2 中 作为 计划 的 缓存 机 制 中 的 修订 结果 。 和 与 9.1 相 
比较 消除 了 性 能 回 为 ， 也 节省 了 内 存 ， 特 别 是 当 要 执行 的 查询 字符 串 包 含 许多 SQL 语句 
的 时 候 。 


另 一 个 好 处 是 ， 多 个 语句 查询 字符 串 现 在 完全 连续 地 被 处 理 ， 这 是 我 们 在 运行 解析 分 析 
之 前 完成 早期 语句 的 执行 以 及 在 下 面 一 个 中 进行 规划 。 这 消除 了 长 期 存在 的 问题 ， 在 影 
响 以 后 声明 操作 的 DDL 中 将 表现 为 预期 的 。 


恢复 索引 用 法 的 pre-9.2 成 本 估算 (Tom Lane) 

修正 因子 的 不 妥当 变化 为 使 用 非常 大 的 索引 导致 不 符合 要 求 的 高 成 本 估计 。 

修复 DROP INDEX CONCURRENTLY 中 的 间 钦 崩溃 (Tom Lane) 

修复 在 cREATE/DROP INDEX CONCURRENTLY 期 间 的 共享 内 存 锁 表 的 潜在 败坏 (Tom Lane) 


在 一 个 元 组 超过 页 面 大 小 减 去 填充 因子 的 情况 下 修复 copy 的 多 个 元 组 插入 代码 (Heikki 
Linnakangas) 


前 面 的 编码 可 以 进入 一 个 无 限 循环 。 
当 扫 描 pg_tablespace 的 时 候 防 止 竞争 条 件 (Stephen Frost, Tom Lane) 


如 果 有 pg_tablespace 项 的 并 发 更 新 ， 那么 cREATE DATABASE 和 DROP DATABASE 可 能 行为 
不 当 。 


防止 prop owNED 试图 把 整个 数据 库 或 表 空 间 删 除 (Alvaro Herrera) 
为 安全 起 见 ， 这 些 对 象 的 所 有 权 必 须 被 重新 分 配 ， 而 不 是 删 掉 。 
修复 vacuum freeze_table_age 实现 中 的 错误 (Andres Freund) 


为 了 超过 vacuum freeze min age 事务 已 存在 的 安装 中 ， 这 个 错误 阻止 使 用 部 分 表 扫描 自 
动 清理 ， 以 致 于 全 表 打 描 总 是 相反 的 。 


当 RowExpr 或 者 xmlexpr 是 解析 分 析 2 倍 时 ， 防 止 不 当 行为 (Andres Freund, Tom Lane) 


这 个 错误 可 能 在 上 下 文中 是 用 户 可 见 的 比如 CREATE TABLE LIKE INCLUDING INDEXES 。 


提高 哈 希 表 的 大 小 计算 中 整数 浴 出 的 防御 (Jeff Davis) 

解决 数据 类 型 权限 相关 的 一 些 错误 (Tom Lane) 

有 一 些 类 型 的 默认 权限 问题 ， 并 且 pg_dump 失 败 备份 这 样 的 权限 。 
修复 服务 器 崩溃 后 忽略 剩余 的 临时 表 的 失败 (Tom Lane) 


修复 为 Windows 上 大 小 的 原因 交 蔡 postmaster 日 志文 件 的 失败 (Jeff Janes, Heikki 
Linnakangas) 


拒绝 to_date() 中 超出 范围 的 日 期 (Hitoshi Harada) 
修复 pg_extension_config_dump() 恰当 地 处理 扩展 更 新 情况 (Tom Lane) 
这 个 事 数 将 为 目标 表 取 代 任 何 现 有 项 ， 使 其 在 扩展 更 新 脚本 中 可 用 。 
修复 在 尽 可 能 简单 的 表达 式 中 计划 时 间 误 差 的 PL/pgSQL 的 报告 (Tom Lane) 
前 面 的 编码 有 时 导致 省 略 conTeXT 追踪 误差 中 的 第 一 行 。 
修复 函数 作为 多 表 触 发 器 的 PL/Python 的 处 理 (Andres Freund) 
确保 非 ASCII 提 示 字 符 串 被 转换 为 Windows 上 正确 的 代码 页 (Alexander Law, Noah Misch) 
这 个 错误 影响 psql 和 一 些 其 他 客户 端 程序 。 
当 没 有 连接 到 数据 库 的 时 候 ， 修 复 psql 的 \? 命令 中 的 ARAYA Sa (Meng Qingzhong) 


当 正 在 运行 pg_basebackup 的 时 候 ， 如 果 删 除了 关系 文件 ， 那 么 修复 可 能 的 错误 (Heikki 
Linnakangas) 


当 pg_basebackup -x fetch 在 备用 服务 器 备份 的 时 候 ， 忍 受 时 间 线 切换 (Heikki 
Linnakangas) 


当 在 热 各 服务 器 上 运行 的 时 候 ， 使 pg_dump 排 除 未 记录 的 表 中 的 数据 (Magnus 
Hagander) 


这 将 失败 ， 因 为 在 备用 服务 器 上 数据 是 不 可 用 的 ， 所 以 认为 最 方便 的 是 自动 假设 


--no-unlogged-table-data 。 
修复 pg_upgrade 安 全 地 你 理 无 效 素 引 (Bruce Momjian) 
修复 pg_upgrade 的 -O/-o 选 项 (Marti Raudsepp) 
修复 libpq 的 PaprintTuples 中 一 个 字 节 缓冲 区 洽 出 (Xi Wang) 
过 时 的 函数 不 用 在 PostgreSQL 自 身 的 任何 地 方 ， 但 它 可 能 仍然 被 客户 端 代码 使 用 。 


使 得 ecpglib 正 确 使 用 已 翻译 消息 (Chen Huajun) 


在 MSVC 上 正确 安装 ecpg_compat 和 pgtypes # (Jiang Guiqing) 
如 果 它 不 是 通过 系统 提供 的 ， 那 么 在 libecpg 中 包含 isinf() 我 们 的 版 本 (Jiang Guiqing) 


为 已 提供 的 函数 重新 安排 配置 测试 ， 因此 它 不 会 被 来 自 libeditlibreadline 的 假冒 输出 蚌 午 
(Christoph Berg) 


确保 Windows 随 时 间 编 译 数 增加 (Magnus Hagander) 


当 交 叉 编译 Windows 时 ， 使 得 pgxs 生 成 带 有 正确 .exe 后 级 的 可 执行 程序 (Zoltan 
Boszormenyi) 


添加 新 的 时 区 缩写 FET (Tom Lane) 


有 一 些 东 欧 时 区 。 


E.6. 版 本 9.2.2 


发 布 日 期 : 2012-12-06 


这 个 版 本 包含 9.2.1 的 各 种 修复 。 有 关 9.2 主 要 版 本 的 新 功能 的 信息 ， 参 阅 Section E.8。 


E.6.1. 迁移 到 版 本 9.2.2 


为 了 运行 9.2.X 不 需要 转 储 / 恢 复 。 


然而 ， 你 可 能 需要 执行 REINDEX 操作 以 调整 并 发 建立 素 引 问题 ， 正如 下 面 描述 的 第 一 个 
changelog 项 。 


同时 ， 如 果 你 正在 从 版 本 9.2.0 更 新 ， 那 么 请 参阅 9.2.1 的 发 布 说 明 。 


E.6.2. 变化 


e 修复 与 cREATE/DROP INDEX CONCURRENTLY 相关 的 多 个 错误 (Andres Freund, Tom Lane, 
Simon Riggs, Pavan Deolasee) 


当 在 CREATE INDEX CONCURRENTLY 最 初 阶段 添加 DROP INDEX CONCURRENTLY 人 允许 不 正确 索引 
决定 ， 引 入 错误 ; 因此 通过 该 命令 建立 的 索引 可 能 败坏 。 在 应 用 该 更 新 后 推荐 使 
FA CREATE INDEX CONCURRENTLY 在 9.2.X 中 重新 建立 索引 。 


另外 ， 当 改变 索引 的 pg_index 行 状态 时 ， 修 复 cREATE/DROP INDEX CONCURRENTLY 使 用 合适 
更 新 。 这 避免 竟 争 条 件 导 致 并 发 会 话 错过 更 新 目标 索引 ， 因 此 再 次 导致 败坏 同时 创建 索 
Bl. 


同时 ， 修 复 各 种 其 他 操作 以 确保 他 们 忽略 了 一 个 来 自 失 败 
的 CREATE INDEX CONCURRENTLY 命 合 的 无 效 素 引 。 最 重要 的 是 vacum, 因为 在 采用 调整 
动作 以 修复 或 者 删除 无 效 素 引 之 前 在 表 上 可 以 很 容易 启动 自动 清理 。 


同时 修复 DROP INDEX CONCURRENTLY 用 来 不 禁用 插入 到 目标 索引 直到 所 有 查询 使 用 它 。 
如 果 取 消 DROP INDEX CONCURRENTLY :先前 编码 可 以 留 下 未 删除 的 索引 ， 修 复 不 正当 操作 。 
e 为 了 DROP INDEX CONCURRENTLY 调整 谓词 锁 (Kevin Grittner) 


先前 ， 在 错误 的 时 间 义 理 SSI 谓 词 锁 ， 可 能 导致 与 bpRoP 并 行 执行 的 可 串 行 化 事务 不 正确 
操作 。 


。 在 WAL 回 放 期 间 修 复 缓冲 区 锁定 (Tom Lane) 


当 回 放 WAL 记 录影 响 超过 一 页 时 ， 那 么 WAL 回 放 编 码 不 能 仔细 锁定 缓冲 区 。 这 可 能 导致 
热 各 份 查询 瞬时 看 到 不 一 致 状态 ， 导 致 错误 结果 或 者 意外 失败 。 


修复 GIN 索 引 在 WAL 产 生 逮 辑 中 的 错误 (Tom Lane) 

这 可 能 导致 素 引 败坏 ， 如 果 发 生 破损 页 失败 。 

修复 SP-GiST 索 引 在 WAL 回 放 退 辑 错误 (Tom Lane) 

这 可 能 导致 崩溃 后 索引 败坏 ， 或 者 是 在 各 用 服务 器 上 。 

在 WAL 恢 复 期 间 修 复 基 础 各 份 位 置 的 不 正确 检查 (Heikki Linnakangas) 
数据 库 达 到 一 致 状态 之 前 该 错误 允许 热 备份 模式 启动 。 

当 推 动 热 备 服务 器 正常 运行 时 ， 正 常 删除 启动 进程 的 虚拟 XID 锁 (Simon Riggs) 
该 监督 可 以 防止 某 种 操作 的 后 续 执行 比如 CREATE INDEX CONCURRENTLY o 
避免 各 用 模式 中 假冒 的 " 失 序 时 间 线 ID" 错 误 (Heikki Linnakangas) 

在 它 接 收 到 关机 信号 之 后 阻止 postmaster 发 起 新 的 子 进 程 (Tom Lane) 

该 错误 可 能 导致 比较 长 的 关闭 ， 或 者 即使 从 来 没有 完成 没有 额外 用 户 操作 。 


当 log_rotation_age Hit 2431 SP at (大 约 25 天 ) , 那么 修复 syslogger 进 程 而 不 会 失 
Re. (Tom Lane) 


当 请 求 的 超时 过 期 的 时 候 ， 那 么 修复 waitLatch() 以 及 时 返回 (Jeff Janes, Tom Lane) 


与 以 前 的 编码 ， 非 等 待 终 止 中 断 的 稳定 流 可 能 会 延迟 从 waitLatch() 无 限期 的 返回 。 这 
已 被 证 明 是 一 个 自动 清理 发 射 进程 中 的 问题 ， 可 能 会 导致 其 他 地 方 的 麻烦 。 


当 内 存 不 足 的 时 候 避 免 内 部 哈 希 表 的 败坏 (Hitoshi Harada) 
防止 已 删除 表 文 件 描述 符 在 以 前 事务 结束 中 保持 打开 (Tom Lane) 
这 应 该 减少 长 期 以 来 已 删除 的 表 继 续 占 用 磁盘 空间 问题 。 


当 一 个 新 的 子 进程 无 法 为 它 的 闭锁 创建 一 个 管道 的 时 候 ， 防 止 数据 库 端 的 月 演 和 重启 
(Tom Lane) 


虽然 新 的 进程 失败 了 ， 没 有 充分 的 理由 强迫 数据 库 端 重新 启动 ， 所 以 要 避免 。 当 内 核 差 
不 多 超出 文件 描述 符 的 时 候 ， 这 提高 了 重 棒 性 。 


避免 与 加 入 不 平 的 子 查 询 的 规划 器 骨 溃 (Tom Lane) 
修复 外 连接 上 的 非 严 格 等 价 从 句 的 规划 (Tom Lane) 


规划 器 可 以 获得 来 自分 句 等 同 于 其 他 一 些 的 非 严 格 构建 的 不 正确 的 约束 ， 例 如 
WHERE COALESCE(foo, 0) =0, 当 foo 来 自 外 连接 的 空 侧 。 9.2 显 示 了 比 以 前 的 版 本 更 多 
的 情况 下 的 这 种 类 型 错误 ， 但 是 基本 的 错误 已 经 有 很 长 时 间 。 


使 用 继承 树 上 的 索引 优化 MIN / max 修复 SELECT DISTINCT (Tom Lane) 
该 计划 在 给 定 的 这 些 因 素 的 结合 "未 能 重新 找到 MinMaxAgglnfo 记 录 " 可 能 失败 。 


确保 规划 器 将 隐 式 和 显 式 转换 出 于 所 有 目的 看 作 等 效 的 ， 除了 少数 情况 下 实际 上 是 一 个 


语义 差异 (Tom Lane) 
当 考 虑 是 否 部 分 束 引 可 用 于 查询 时 ， 包 含 join 子 句 (Tom Lane) 


严格 的 join 子 句 可 以 充分 建立 一 个 x rs NoT NULL 断言 ， 比 如 。 修复 9.2 中 的 规划 器 回 
归 分 析 ， 因 为 先前 版 本 可 能 做 了 可 比较 推理 。 


当 同 一 索引 中 有 很 多 可 索引 join 子 句 时 ， 限 制 规划 器 时 间 的 增长 (Tom Lane) 
提高 规划 器 的 能 力 以 证 明 等 价 类 的 排除 约束 (Tom Lane) 
修复 散 列 子规 划 中 的 部 分 行 匹配 以 正确 义理 交叉 类 型 例子 Tom Lane) 


这 影响 到 多 列 NoT IN 子规 划 ， 比 如 whERE (a, b) NOT IN (SELECT x, y FROM...) 当 例 


如 o 和 y DHA inta 和 ints 时 。 这 个 错误 导致 错误 结果 或 依据 所 涉及 的 具体 数据 类 
型 崩溃 。 


修复 btree 标记 /恢复 函数 以 处 理 数 组 键 (Tom Lane) 


APRA ESRA 内 侧 是 使 用 _indexed_colum_ = ANY( _array_ ) 条 件 的 素 引 打 描 
的 合并 联接 中 的 错误 结果 。 


为 采用 更 少 快照 恢复 补丁 (Tom Lane) 


减少 查询 执行 中 采取 的 快照 数 的 9.2 变 化 导致 一 些 在 以 前 版 本 中 没有 见 过 的 异常 行为 ， 
因为 执行 会 继续 在 锁定 查询 使 用 的 表 之 前 获得 的 一 个 快照 。 因此 ， 例 如 ， 查 询 将 不 保证 
能 够 看 到 前 面 事务 提交 的 更 新 即使 该 事务 有 排他 锁 。 我 们 可 能 会 在 未 来 版 本 中 重新 审视 
它 ， 但 同时 把 它 以 9.2 之 前 方式 放 回 到 原 处 。 


当 为 AFTER ROW UPDATE/DELETE 触发 器 重新 读 取 旧 的 元 组 时 ， 获 取 缓 冲 锁 (Andres Freund) 


在 十 分 特殊 的 情况 下 ， 这 可 能 会 导致 传递 不 正确 的 数据 到 一 个 触发 器 wen R, 或 对 
一 个 外 键 执行 触发 器 重新 检测 逻辑 。 这 可 能 导致 崩溃 ， 或 在 错误 决定 情况 下 触发 触发 
器 。 


修复 ALTER COLUMN TYPE 正确 处 理 继 承 的 检查 约束 (Pavan Deolasee) 


这 在 以 前 8.4 版 本 中 正常 工作 ， 并 且 现 在 在 8.4 及 以 后 版 本 中 也 正常 工作 。 


修复 ALTER EXTENSION SET SCHEMA 的 错误 以 移动 一 些 附属 对 象 到 新 模式 中 (Alvaro Herrera, 
Dimitri Fontaine) 


在 扩展 查询 协议 中 正确 处 理 CREATE TABLE AS EXECUTE (Tom Lane) 


不 要 在 DROP RULE IF NOT EXISTS and DROP TRIGGER IF NOT EXISTS 中 修改 输入 解析 树 
(Tom Lane) 


如 果 重 新 执行 这 些 类 型 之 一 的 已 缓存 语句 ， 那 么 可 能 产生 错误 。 
修复 REASSIGN OWNED 处 理 表 空间 上 的 授权 (Alvaro Herrera) 
忽略 视图 系统 列 错误 的 pg_attribute 项 (Tom Lane) 


视图 没有 任何 系统 列 。 然 而 ， 当 转换 表 到 视图 时 我 们 忘 了 删除 该 项 。 在 9.3 以 及 以 后 被 正 
确 修复 ， 但 在 以 前 的 分 支 中 我 们 需要 防卫 现 有 的 错误 转换 视图 。 


修复 规则 输出 以 正确 转 储 INSERT INTO _table_ DEFAULT VALUES(Tom Lane) 

当 在 一 个 查询 中 有 太 多 UNION / intersect / EXCEPT 子 名 时， 防止 堆 栈 浴 出 (Tom Lane) 
当 使 用 -1 区 分 尽 可 能 低 的 整数 值 时 ， 避 免 平 台 相 关 错 误 (Xi Wang, Tom Lane) 

修复 日 期 分 析 中 可 能 访问 以 前 的 字符 串 末尾 (Hitoshi Harada) 


如 果 在 检查 点 期 间 发 生 XID 概 括 并 且 wal_level 是 hot_standby ， 那么 修复 错误 以 提前 
XID 时 代 (Tom Lane, Andres Freund) 


当 这 个 错误 对 PostgreSQL 自 身 没 有 特别 影响 时 ， 对 于 依赖 于 txid_current() AHE 
数 是 一 个 坏 的 应 用 : TXID 值 将 出 现 回 退 。 


修复 pg_terminate_backend() 和 pg_cancel_backend() 不 要 为 非 存 在 的 目标 过 程 抛 出 错误 
(Josh Kupershmidt) 


当 通 过 超级 用 户 调用 的 时 候 ， 该 种 情况 已 经 按照 预期 进行 ， 但 是 当 通 过 普通 用 户 调用 的 
时 候 并 不 这 样 。 


修复 页 面 边界 pg_stat_replication . sync_state 的 显示 (Kyotaro Horiguchi) 


如 果 为 了 Unix 域 套 接 字 的 路 径 名 长 度 超过 特定 平台 限制 ， 那么 产生 可 理解 的 错误 消息 
(Tom Lane, Andrew Dunstan) 


以 前 这 可 能 导致 一 些 无 用 的 东西 ， 比 如 "域名 解析 不 可 恢复 故障 " 
当 发 送 复合 列 值 给 客户 端 时 ， 修 复 内 存 泄露 (Tom Lane) 
通过 提交 时 不 搜索 子 事务 锁 节 省 一 些 周期 (Simon Riggs) 


在 事务 中 持 有 许多 排他 锁 ， 这些 无 效 活动 可 能 是 相当 昂贵 的 。 


使 得 pg_ctl 关 于 读 取 postmaster.pid 文件 更 加 健壮 (Heikki Linnakangas). 
这 将 修复 竞争 条 件 和 可 能 的 文件 描述 符 泄 漏 。 


如 果 提 出 错误 编码 数据 ， 并 且 client_encoding 设置 是 客户 端 编码 ， 上 比如 SJIS， 那么 可 
能 在 psql 中 有 崩溃 (Jiang Guiging) 


在 数据 不 是 具 档 预先 数据 段 中 使 得 pg_dump 各 份 sequence set 项 (Tom Lane) 


这 种 修复 了 --data-only 和 --section=data 意义 之 间 不 良 的 不 一 致 ， 并 修复 各 份 被 标记 
为 可 扩展 配置 表 序 列 。 


修复 --clean 模式 中 DROP DATABASE 命 命 的 pg_dump 的 处 理 (Guillaume Lelarge) 


9.2.0 开 始 ， pg_dump --clean 提出 prop DATABASE ， 根据 使 用 场景 这 是 无 用 的 或 者 危险 
的 。 现在 不 再 是 这 样 了 。 这 种 变化 也 将 修复 --clean 和 --create 的 结合 以 正常 运行 ， 
即 ， 发 出 prop DATABASE 然后 重新 连接 目标 数据 库 之 前 发 出 CREATE DATABASE o 


为 了 循环 依赖 的 视图 和 没有 关系 的 选项 修复 pg_dump(Tom Lane) 


当 视 图 涉及 没有 选项 不 正常 工作 的 情况 下 的 循环 依赖 时 ， 先前 修复 是 备份 关系 选项 。 它 
发 出 ALTER VIEW foo SET () ， 这 是 无 效 的 语法 。 


修复 通过 tar 输出 格式 中 pg_dump 发 出 的 restore.sql 脚本 中 的 错误 (Tom Lane) 


该 脚本 在 名 字 包 括 大 写字 母 的 表 上 可 能 失败 。 同 时 ， 使 脚本 在 --inserts 模式 中 和 规则 
COPY 模 式 中 能 够 恢复 数据 。 


修复 pg_restore 接 受 符 合 POSIX 标 准 的 tar 的 文件 (Brian Weaver, Tom Lane) 


pg_dump 的 tar 输出 模式 的 原始 编码 产生 不 能 与 POSIX 标 准 完全 一 致 的 文件 。 这 是 9.3 
版 本 的 修正 。 这 个 补丁 更 新 以 前 的 分 支 ， 以 致 于 它们 会 接受 不 正确 的 和 正确 的 格式 ， 为 
了 避免 9.3 出 现 的 兼容 性 问题 。 


修复 通过 pg_basebackup 发 出 的 tar 文件 到 符合 POSIX 标 准 (Brian Weaver, Tom Lane) 


当 给 出 了 数据 目录 相应 路 径 时 ， 修 复 pg_resetxlog 以 正确 定位 postmaster.pid (Tom 
Lane) 


这 个 错误 可 能 导致 pg_resetxlog 没 有 注意 到 使 用 数据 目录 的 一 个 活跃 postmaster。 
修复 libpq 的 10_import() 和 1o_export() 范 数 以 正确 报告 文件 /O 错 误 (Tom Lane) 
修复 藤 套 结构 指针 变量 的 ecpg 父 理 (Muhammad Usama) 

修复 ecpg 的 ecpg_get_data KIZU E% x E% a (Michael Meskes) 


防止 pg_upgrade 斌 图 义理 系统 目录 的 TOAST 表 (Bruce Momjian) 


当 information_schema 已 被 删除 或 重新 创建 时 ， 这 修复 了 发 现 的 错误 。 其 他 错误 也 是 可 
能 的 。 


通过 设置 新 群集 中 synchronous_commit 到 off 提升 pg_upgrade 性 能 (Bruce Momjian) 
使 得 contrib/pageinspect 的 btree 页 检查 函数 当 检 查 页 时 采用 缓冲 锁 (Tom Lane) 
解决 malloc(0) 和 realloc(NULL, 0) 不 可 移植 操作 (Tom Lane) 


平台 上 这 些 调 用 返回 NuLL ， 一 些 代码 错误 地 认为 内 存 不 足 。 对 数据 库 不 包含 用 户 自 定 
义 聚 合 已 损坏 的 pg_dump 是 已 知 的 。 可 能 还 有 其 他 的 情况 。 


确保 make install 为 扩展 创建 extension 安装 目录 (Cédric Villemain) 
以 前 ， 如 果 在 扩展 的 Makefile 中 设置 MopuLEDIR ， 可 以 省 略 该 步 。 
修复 pgxs 支 持 AlIX 上 编译 可 加 载 模块 (Tom Lane) 

编译 不 在 AIX 上 运行 的 初始 源码 树 外 部 模块 。 


为 了 Cuba, Israel, Jordan, Libya, Palestine, Western Samoa 以 及 Brazil 区 域 中 DST 变 化 规 
律 更 新 时 区 数据 文件 到 tzdata 版 本 2012j。 


E.7. 版 本 9.2.1 


发 布 日 期 : 2012-09-24 


该 版 本 包含 来 自 9.2.0 的 各 种 修复 。 关 于 9.2 主 要 版 本 新 功能 的 信息 ， 请 参阅 Section E.8。 


E.7.1. 迁移 到 版 本 9.2.1 


为 了 运行 9.2.X 不 需要 转 储 / 恢 复 。 


然而 ， 你 可 能 需要 执行 REINDEX 和 /或 者 vacuum 操作 从 下 面 第 一 个 changelog 项 描述 的 数据 损 
坏 错误 影响 中 恢复 。 


E.7.2; 变化 


。 修复 WAL 回 放 期 间 共 享 缓冲 区 持久 性 标记 (Jeff Davis) 


这 个 错误 会 导致 在 检查 点 缓冲 区 不 被 输出 ， 如 果 服 务 器 稍 后 骨 溃 而 没有 输出 这 些 缓冲 ， 
导致 数据 损坏 。 损坏 可 能 在 随后 月 溃 恢 复 的 任何 服务 器 上 发 生 ， 但 它 很 显然 可 能 在 备用 
从 属 服务 器 上 发 生 ， 因为 这 些 执行 了 更 多 WAL 回 放 。 btree 和 GIN 索 引 有 低 概 率 损坏 。 

表 " 可 见 视图 "有 更 高 概率 的 损坏 ， 这 可 能 会 导致 来 自 素 引 扫 拉 的 错误 结果 ， 正 确 的 表 数 
据 不 能 被 这 错误 损坏 。 

虽然 没有 索引 的 损坏 ， 由 于 这 个 错误 已 经 在 该 字段 发 生 ， 作为 预防 措施 建议 产品 升级 到 
9.2.1 后 在 合适 的 时 间 安 装 REINDEX 所 有 btree 和 GIN 索 引 。 

同时 ， 当 vacuum freeze table age 设置 为 需 的 时 候 ， 建议 执行 所 有 表 的 vacuum, ee 
修复 任何 不 正确 可 见 性 的 视图 数据 。 当 它 需要 更 长 的 时 间 来 完成 的 时 候 ， 可 以 调 


整 vacuum cost_delay 以 减少 清理 的 性 能 影响 。 





o 修复 涉及 WHERE _indexed_column_ IN ( _list_of_values_ ) 查 询 输 出 可 能 不 正确 的 排序 
(Tom Lane) 





。 修复 涉及 croup BY Rid TAlwindowlN MAA SEM LAY A 54] BY AL Kl 28 (Tom Lane) 


修复 执行 器 参数 的 规划 器 分 配 (Tom Lane) 
该 错误 可 能 导致 来 自打 描 同 一 个 with 子 查询 多 次 的 查询 错误 结果 。 
。 提高 索引 打 描 中 join 条 件 的 规划 器 处 理 (Tom Lane) 


。 提高 涉及 前 级 的 文本 搜索 查询 的 选择 性 估计 ， 上 比如 wordi: 模式 (Tom Lane) 


修复 权限 变化 的 延迟 识别 (Tom Lane) 
除了 有 可 能 没有 注意 到 自 事务 开始 时 已 提交 的 并 行 GRANT 或 者 Revo 的 事务 外 ， 不 需要 


锁 的 命令 。 

当 列 是 数组 类 型 域 时 ， 修 复 ANALYzE 而 不 失败 (Tom Lane) 

如 果 递 轨 PL/Perl 函 数 在 执行 的 时 候 被 重新 定义 ， 那 么 防止 PL/Perl 前 汪 (Tom Lane) 
解决 PL/Perl 中 可 能 的 错误 优化 (Tom Lane) 


一 些 Linux 发 布 包含 pthread.h 不 正确 的 版 本 ， 导 致 PL/Perl 中 不 正确 的 编译 代码 ， 如 果 
PL/Perl 函 数 调用 另外 抛 出 错误 的 一 个 ， 那 么 导致 衣 溃 。 


删除 来 自 pg_upgrade 的 pg_config 上 的 不 必要 依赖 (Peter Eisentraut) 


为 了 Fiji 的 DST 变 化 规律 更 新 时 区 数据 文件 到 tzdata 版 本 2012f 


E.8. 版 本 9.2 


发 布 日 期 : 2012-09-10 


E.8.1. 概述 
此 版 本 主要 集中 在 性 能 上 的 改进 ， 但 新 的 SQL 功 能 不 缺乏 。 工 作 在 各 份 支持 领域 继续 进行 。 
主要 功能 包括 : 
。 人 允许 查询 从 来 引 中 检索 数据 ， 避 人 免 堆 访问 (索引 扫描 ) 
。 即使 当 使 用 预备 语句 时 ， 人 允许 规划 器 为 特定 参数 值 产生 自 定义 规划 
。 提高 规划 器 使 用 谋 套 循环 内 部 索引 扫描 的 能 
。 人 允许 流 复制 转发 数据 到 其 他 从 属 ( 级 联 复制 ) 
e 人 允许 pg_basebackup 执 行 来 自 备 用 服务 器 的 基础 备份 
。 添加 pg_receivexlog 工 具 以 为 档 作 为 他 们 写 入 的 WAL 文 件 
。 添加 SP-GiST (空间 划分 GiST) 索 引 访问 方法 
e 添加 range data types 支 持 
。 添加 JsoN 数据 类 型 
e 为 视图 增加 security_barrier 选项 
。 多 许 libpq 连 接 字符 串 有 URI 的 格式 
。 添加 单行 处 理 模 式 到 libpq 更 好 的 处 理 大 的 结果 集 
以 上 项 的 更 多 详情 在 下 面 的 章节 有 介绍 。 


E.8.2. 迁移 到 版 本 9.2 


使 用 pg_dump 转 储 /恢复 ， 或 者 使 用 pg_upgrade 从 任何 以 前 版 本 中 渤 移 数 据 。 
版 本 9.2 包 含 可 能 影响 与 先前 版 本 的 兼容 性 的 一 些 变化 。 观察 下 面 的 不 兼容 : 


E.8.2.1. 系统 目录 


e 从 pg tablespace 中 删除 spclocation 字段 (Magnus Hagander) 


Ce 从 而 当 移 动 表 空 间 时 ， 可 能 有 和 遗漏 错 
RAR. 在 服务 器 关闭 时 ， 通 过 手动 调节 符号 链接 ， 这 种 变化 允许 删除 表 空 间 目 录 。 为 
了 蔡 换 该 字段 ， 我 们 添加 pg_tablespace_location() 允许 符号 链接 查询 。 


移动 tsvector 最 常见 元 素 统计 到 新 的 pg_stats 列 (Alexander Korotkov) 


为 了 在 most_common_vals 和 most_common_freqs 的 tsvector 列 中 可 用 的 原先 的 数据 查 


询 most_common_elems 和 most_common_elem_freqs o 


E.8.2.2. BAX 


删除 hstore's =&gt; 操作 符 (Robert Haas) 


用 户 应 该 使 用 hstore(text，text) o 自 PostgreSQL 9.0， 当 创 建 命 名 =&et; 的 操作 符 ， 
则 发 出 一 个 警告 信息 。 因为 SQL 标准 保留 了 另 一 个 使 用 的 标记 。 


确保 xpath() 在 字符 串 值 中 逃逸 特殊 字符 (Florian Pflug) 

丛 若 没有 这 个 ， 那 么 对 于 结果 可 能 不 是 有 效 的 XML。 

使 用 pg_relation_size() 并 且 如 果 该 对 象 不 存在 则 返回 空 (Phil Sorber) 
这 可 以 防止 查询 调用 这 些 函 数 从 并 发 prop 后 立即 返回 错误 。 


使 用 ExTRACT(EPoCH FROM timestamp without time zone ) 从 当地 午夜 测量 时 间 ， 而 不 是 
UTC 午夜 (Tom Lane) 


一 变化 恢复 在 版 本 7.3 中 缺乏 考虑 的 变化 。 从 UTC 午夜 测量 是 不 一 致 的 ， 因为 它 使 结 
果 依 赖 于 timezone 设置 ， 这 不 应 该 有 timestamp without time zone 的 计算 。 以 前 的 操作 
仍然 可 以 通过 二 映射 输 A 值 到 timestamp with time Zone 可 用 。 


正确 解析 带 有 尾随 yesterday , today 和 tomorrow 的 时 间 字 符 串 (Dean Rasheed) 
先前 SELECT '04:00:00 yesterday'::timestamp 返回 午夜 时 yesterday 的 日 期 。 
修复 to_date() 和 to_timestamp() 以 封装 不 完整 日 期 到 2020(Bruce Momjian) 


先前 ， 提 供 年 以 及 不 一 致 封装 低 于 四 位 的 年 掩 码 。 


E.8.2.3. 对 象 修改 


防止 ALTER DoMAIN 工作 于 非 域 类 型 上 (Peter Eisentraut) 
在 非 域 类 型 上 所 有 者 和 模式 变化 是 可 能 


在 CREATE FUNCTION 中 不 再 强 制 小 写 过 程 语言 名 字 (Robert Haas) 


当 反 引号 语言 标识 符 仍 然 是 小 写字 母 时 ， 字 符 串 和 带 引 号 的 标识 符 不 再 强行 向 下 。 
此 ， 例 如 cREATE FUNCTION ... LANGUAGE 'c' 将 不 再 工作 ; 它 必 须 拼写 'c' ， 或 更 好 地 省 
略 引 号 。 


。 改变 外 键 执行 触发 器 系统 产生 的 名 称 (Tom Lane) 
这 一 变化 确保 在 涉及 自我 参照 的 外 键 约束 的 情况 下 以 正确 的 顺序 触发 触发 器 。 


E.8.2.4. 命令 行 工 具 
。 提供 一 致 的 反 引号 ， 变 量 扩张 ， 以 及 psql 元 命令 参数 中 的 引用 子 字符 串 操作 (Tom Lane) 


以 前 ， 当 不 通过 相 令 文本 空白 分 隔 的 时 候 。 奇 怪 地 人 处理 这 种 引用 。 例如 'Foo'BAR 作 
为 Foo BAR 被 输出 (空间 意外 插入 ) 并 且 Foo'BAR'BAZz 输出 不 变 (不 删除 期 望 的 引 
用 ) o 


。 不 再 将 clusterdb 表 名 看 作 双 引号 ; 不 再 将 reindexdb 表 和 索引 名 看 作 双 引号 (Bruce 
Momjian) 


如 果 希 望 引用 ， 那 么 用 户 现 在 必须 在 命令 参数 中 包含 双 引 有 号。 
e createuser 缺 省 不 再 提示 选项 设置 (Peter Eisentraut) 
使 用 --interactive 获得 旧 的 操作 。 


e 禁用 dropuser 中 的 用 户 名 提示 ， 除非 指定 - -interactive (Peter Eisentraut) 


E.8.2.5. 服务 器 设置 
。 添加 服务 器 参数 以 指定 服务 器 端 SSL 文 件 位 置 


这 人 允许 改变 名 字 和 文件 位 置 ， 该 文件 先前 作为 server.crt , server.key , root.crt 和 数 
据 目 录 中 root.crl 的 硬 编码 。 缺 省 时 服务 器 将 不 再 检查 root.crt 或 者 root.crl ; 加 
载 这 些 文件 ， 相 关 参 数 必须 设置 为 非 缺 省 值 。 


。 删除 silent_mode 参数 (Heikki Linnakangas) 

可 以 使 用 pg_ctl start -1 postmaster.log 获得 类 似 操作 。 
。 删除 不 再 需要 的 wal_sender_delay 参数 (Tom Lane) 
e 删除 custom_variable classes 参数 (Tom Lane) 


通过 该 设置 提供 的 检查 是 含糊 的 。 现 在 可 以 以 任何 类 名 作为 任何 设置 前 级 。 


E.8.2.6. 监控 


重 命名 pg_stat_activity .procpid 到 pid ， 匹 配 其 他 系统 表 (Magnus Hagander) 
创建 一 个 单一 的 pg_stat_activity 列 以 报告 进程 状态 (Scott Mead, Magnus Hagander) 
先前 的 query 和 query_start 值 现 在 仍然 可 用 于 空闲 会 话 ， 允许 增强 分 析 。 


当 查 询 完成 时 ， 重 命名 pg_stat_activity . current_query 到 query ， 因 为 它 是 不 清楚 的 


(Magnus Hagander) 
改变 所 有 SQL 级 别 统计 时 序 值 到 以 毫秒 计 的 Floats FV 


这 种 变化 消除 设计 假设 该 值 精确 到 微 秒 ， 没 有 更 多 的 (因为 floats 值 可 以 是 分 数 ) 。 受 
影响 的 

All : pg_stat_user_functions . total_time , pg_stat_user_functions . self_time , pg_stat_: 
. total_time ， 和 pg_stat_xact_user_functions . self_time o 潜在 这 些 列 的 统计 函数 现在 
返回 floats BY, MAE bigint 微 秒 。 现 在 以 毫秒 测 

= 

= 


contrib/pg_stat_statements 的 total_time Jl, 





E.8.3. 交 化 


下 面 你 将 发 现在 PostgreSQL 9.2 和 先前 主要 版 本 之 间 变 化 的 详细 情况 。 


E.8.3.1. Ak Aas 


E.8.3.1.1. 性 能 


© 人 允许 查询 只 从 素 引 中 检索 数据 ， 避 人 免 堆 访 问 (Robert Haas, lbrar Ahmed, Heikki 


Linnakangas, Tom Lane) 


此 功能 通常 被 称 为 只 索引 扫描 。 为 了 只 包含 对 所 有 会 话 可 见 的 元 组 堆 页 可 以 忽略 挫 访 
问 ， 正如 可 见 视图 报道 的 ; 因此 该 效益 主要 适用 于 大 多 数 静 态 数据 。 可 见 视图 将 损坏 安 
全 作为 执行 该 功能 的 必要 组 成 部 分 。 


增加 SP-GiST( 空 间 划分 GiST) 素 引 访问 方法 (Teodor Sigaev, Oleg Bartunov Tom Lane) 


SP-GiST 与 GIST 的 灵活 性 相 比 较 ， 但 支持 不 平衡 分 段 搜索 结构 而 不 是 平衡 树 。 为 了 适当 
的 问题 ，SP-GiST 在 索引 编译 时 间 和 搜索 时 间 上 上 比 GiST 更 快 。 


允许 组 提交 在 重负 载 下 有 效 工 作 (Peter Geoghegan, Simon Riggs, Heikki Linnakangas) 
此 前 ， 批 量 提 交 无 效 作为 已 增加 的 写 入 工作 量 ， 由 于 内 部 锁 争 用 。 

允许 使 用 一 个 新 的 快速 路 径 锁 定 机 制 管理 未 竞争 锁 (Robert Haas) 

减少 创建 虚拟 事务 ID 锁 的 开销 (Robert Haas) 


减少 串 行 化 隔离 级 别 锁 的 开销 (Dan Ports) 


提高 PowerPC 和 Itanium spinlock 性 能 (Manabu Ori, Robert Haas, Tom Lane) 
。 减少 共享 的 无 效 缓存 消息 开销 (Robert Haas) 


© 移动 PPRoc 共享 内 存 数 组 频繁 访问 的 成 员 到 一 个 单独 数组 中 (Pavan Deolasee, Heikki 
Linnakangas, Robert Haas) 

。 通过 成 批 地 添加 元 组 到 堆 中 提高 copy 性 能 (Heikki Linnakangas) 
通过 产生 内 存 分 配 开销 少 的 树 的 几何 数据 类 型 提高 GiST 索 引 性 能 。 


。 提高 GiST 索 引 编译 时 间 (Alexander Korotkov, Heikki Linnakangas) 


允许 提示 位 被 迅速 设置 为 临时 的 和 未 标记 表 (Robert Haas) 


。 人 允许 通过 内 联 进 行 排序 ， 非 SQL 可 调用 比较 函数 (Peter Geoghegan, Robert Haas, Tom 
Lane) 


e 增 大 基于 shared buffers 的 CLOG 缓 冲 区 规模 数量 (Robert Haas, Simon Riggs, Tom 
Lane) 


。 当 删 除 表 或 者 数据 库 时 ， 提 高 发 生 的 缓冲 池 扫描 性 能 (Jeff Janes, Simon Riggs) 
。 当 许 多 表 被 删除 或 截断 时 ， 提 高 检查 点 的 fsync 请 求 阵列 性 能 (Tom Lane) 
e Windows 上 传递 文件 描述 符 安全 码 到 子 进程 (Heikki Linnakangas) 


这 人 允许 Windows 会 话 使 用 上 比 以 前 更 多 的 打开 文件 描述 符 。 


E.8.3.1.2. 进程 管理 
。 创建 一 个 执行 检查 点 的 专门 后 台 进 程 (Simon Riggs) 
原先 后 端 写 进程 执行 脏 页 宇和 信和 检查 点 。 分 离 成 两 个 过 程 允 许 每 个 目标 可 预见 地 完成 。 
。 通过 快速 唤醒 walwriter 提 高 异步 提交 操作 (Simon Riggs) 
以 前 ， wal_writer_delay fiR WALSH the & ; 现在 填充 WAL 缓 冲 区 也 触发 WAL 写 人。 


。 在 不 活跃 期间 让 bgwriter, walwriter， 检 查 点 ， 数 据 采 集 器 ， 日 志 收 集 器 和 六 档 日 志 后 端 
进程 更 有 效 睡 眠 (Peter Geoghegan, Tom Lane) 


当 没 什么 事 可 做 的 时 候 ， 这 一 系列 的 变化 会 降低 进程 唤醒 频率 ， 大 幅 降 低空 闲 服 务 器 上 
的 功 耗 。 


E.8.3.1.3. 优化 器 
。 允许 规划 器 生成 特定 参数 的 自 定 义 规划 ， 即 使 当 使 用 预 处 理 语句 的 时 候 (Tom Lane) 


以 往 ， 一 个 预备 语句 总 是 有 一 个 单一 的 "通用 "计划 被 用 于 所 有 的 参数 值 ， 通常 远 不 如 用 
于 包含 显 式 恒定 值 的 非 预备 语句 规划 。 现 在 ， 规 划 器 试图 生成 特定 参数 值 的 自 定 义 规 
划 。 一 个 通用 计划 将 只 能 用 在 自 定义 规划 多 次 证 明 没 有 任何 好 处 的 情况 。 这 种 变化 应 该 
消除 原先 从 预备 语句 使 用 中 见 到 过 的 性 能 损失 (包括 PL/pgSQL 中 的 非 动态 语句 ) 。 


。 提高 规划 器 使 用 翌 套 循环 内 部 索引 打 描 的 能 力 (Tom Lane) 


新 的 "参数 化 路 径 " 机 制 多 许 内 部 索引 扫描 使 用 超过 扫描 中 一 个 连接 水 平 的 关系 值 。 这 可 
以 大 大 提高 语义 限制 (如 外 连接 ) 允许 的 连接 顺序 的 情况 下 的 性 能 。 


。 提高 对 外 部 数据 封装 器 的 规划 API (Etsuro Fujita, Shigeru Hanada, Tom Lane) 
封装 器 现在 可 以 为 表 提供 多 种 访问 "路 笃 "， 在 连接 规划 中 更 加 灵活 。 

。 识别 非 表 关系 的 自 相 矛 盾 限 制 分 句 (Tom Lane) 
当 constraint_exclusion 打开 时 ， 执 行 这 个 检查 。 

e StF indexed_col op ANY(ARRAY[...]) 条 件 用 于 纯 索 引 扫 描 并 且 仅 仅 索 引 打 描 (Tom Lane) 
以 前 这 样 的 条 件 只 能 用 于 位 图 索引 扫描 。 

e 在 boolean 列 上 支持 MIN / max 索引 优化 (Marti Raudsepp) 

。 当 估 计 设 置 行 数 时 ， 解 释 了 在 SELECT 目标 列 中 设置 返回 范 数 的 原因 (Tom Lane) 

。 修复 规划 器 更 可 靠 的 处 理 带 有 重复 列 来 引 (Tom Lane) 

。 收集 并 且 使 用 数组 元 素 次 数 统计 (Alexander Korotkov, Tom Lane) 


这 种 变化 提高 了 数组 alt;@ ，s& 和 aot; 操作 符 (数组 容量 和 重 司 部 分 ) 的 选择 性 估 
计 。 


。 人 允许 收集 外 表 的 统计 (Etsuro Fujita) 
。 提高 使 用 部 分 素 引 的 成 本 估计 (Tom Lane) 
。 提高 在 子 查询 中 引用 列 统计 的 规划 器 能 力 (Tom Lane) 


。 提高 子 查询 使 用 prsTINcT 的 统计 估计 (Tom Lane) 


E.8.3.1.4. 认证 


。 不 要 把 角色 名 字 和 pg_hba.conf 中 声明 的 samerole 看 作 自 动 包含 超级 用 户 的 (Andrew 
Dunstan) 


这 使 得 它 更 容易 使 用 组 角色 的 reject 行 。 
e 调节 pg_hba.conf 过 程 更 加 一 致 地 处 理 邻 牌 解析 (Brendan Jurd, Alvaro Herrera) 


e 不 允许 空 pg_hba.conf 文件 (Tom Lane) 


这 样 做 是 为 了 更 快速 检测 配置 错误 。 
使 用 超级 用 户 权 限 意味 着 复制 权限 (Noah Misch) 
这 样 避免 了 需要 明确 地 分 配 这 类 权限 。 


E.8.3.1.5. 监控 


试图 在 后 端 贿 溃 期 间 记 录 当 前 查询 字符 串 (Marti Raudsepp) 

使 得 自动 清理 VO 活 动 日 志 更 加 兄长 (Greg Smith, Noah Misch) 

这 条 记录 是 通过 10g _autovacuum_min_duration 触发 的 。 

使 WAL 回 放 尽 快报 告 错误 (Fujii Masao) 

一 旦 服务 器 到 主 模式 只 报告 错误 的 情况 。 

添加 pg_xlog location_diff() 以 简化 WAL 位 置 比较 (Euler Taveira de Oliveira) 
这 对 于 计算 复制 滞后 是 有 用 的 。 

支持 Windows 上 可 配置 的 事件 日 志 应 用 程序 名 称 (MauMau, Magnus Hagander) 


这 人 允许 不 同 的 情况 下 使 用 不 同 的 标识 符 事 件 日 志 ， 通过 设置 event_source 服务 器 参数 ， 
这 类 似 于 syslog ident 工作 方式 。 


改变 "意外 的 块 结束 "消息 到 pegucr 级 别 ， 除 非 有 一 个 已 打开 事务 (Magnus Hagander) 
这 种 变化 减少 笨拙 地 关闭 数据 库 连接 应 用 导致 的 日 志 振 动 。 


E.8.3.1.6. 统计 视图 


跟踪 临时 文件 大 小 和 pg_stat_database 系统 视图 中 的 文件 数 (Tomas Vondra) 
添加 一 个 死 锁 计数 器 到 pg_stat_database 系统 视图 (Magnus Hagander) 
添加 服务 器 参数 track_io_timing 跟踪 l/O 时 序 (Ants Aasma, Robert Haas) 


报告 pg_stat_bgwriter 中 的 检查 点 定时 信息 (Greg Smith, Peter Geoghegan) 


E.8.3.1.7. 服务 器 设置 


默默 忽略 search_path 指定 的 不 存在 的 模式 (Tom Lane) 
这 使 得 更 加 方便 使 用 通用 路 径 设置 ， 可 能 包含 一 些 不 存在 于 数据 库 中 的 模式 。 
允许 超级 用 户 设置 deadlock timeout 每 个 会 话 ， 而 不 是 每 个 集群 (Noah Misch) 


这 人 允许 为 了 可 能 涉及 到 死 锁 的 事务 减少 deadlock_timeout ， 因此 更 快 地 检查 故障 。 另 
外 ， 增 加 该 值 可 以 用 于 减少 由 于 死 锁 选择 取消 会 话机 会 。 


。 添加 服务 器 参数 temp file limit 限制 每 个 会 话 临时 文件 空间 使 用 率 (Mark Kirkwood) 
。 在 加 载 相 关 扩 展 之 前 允许 超级 用 户 sET 扩展 的 超级 用 户 自 定义 变量 (Tom Lane) 


系统 现在 记得 是 否 sET 通过 超级 用 户 被 执行 ， 因此 当 加 载 扩 展 时 ， 可 以 执行 适当 的 权限 
检查 。 


e 添加 postmaster -c 选项 查询 配置 参数 (Bruce Momjian) 
允许 pg_ctl 更 好 地 人 处理 pepata 或 者 -p 指向 配置 目录 的 情况 。 
e 以 CREATE DATABASE 中 隐 含 值 替 换 空 的 区 域名 (Tom Lane) 
这 可 以 防止 服务 器 重启 后 不 同 地 解释 pg_database . datcollate 或 者 datctype 的 情况 。 


E.8.3.1.7.1. postgresql.conf 


© 人 允许 报告 postgresql.conf 中 的 多 个 错误 ， 而 不 仅仅 是 第 一 个 (Alexey Klyukin, Tom 
Lane) 


© 人 允许 通过 所 有 会 话 处 理 postgresql.conf 的 加 载 ， 即 使 有 一 些 设置 对 特定 会 话 是 无 效 的 
(Alexey Klyukin) 


以 前 ， 这 种 无 效 会 话 值 可 能 导致 所 有 设置 变化 被 该 会 话 忽略 。 
。 为 配置 文件 添加 一 个 include_if_exists 功能 (Greg Smith) 
这 个 和 include 一 样 运行 ， 除 了 如 果 忽 略 该 文件 不 会 抛 出 错误 外 。 
e 在 initdb 期 间 识别 服务 器 时 区 ， 并 且 相 应 设置 postgresql.conf 项 timezone 和 


log_timezone 
这 避免 了 服务 器 启动 时 昂贵 的 时 区 探测 。 


° 修复 pg_settings 以 报告 Windows 上 postgresql.conf 行 号 (Tom Lane) 


E.8.3.2. 各 份 和 恢复 
。 人 允许 流 复制 转发 数据 到 其 他 从 属 (级 联 复制 )(Fujii Masao) 
以 前 只 有 主 服务 器 可 以 提供 流 复制 日 志文 件 到 各 用 服务 器 。 
e 添加 新 的 synchronous commit 模式 remote_write (Fujii Masao, Simon Riggs) 


该 模式 等 待 备 用 服务 器 写 事务 数据 到 它 自己 的 操作 系统 ， 但 是 不 等 待 数据 被 刷新 到 各 用 
Ti £& 


e 添加 pg_receivexlog 工 具 为 档 他 们 写 入 的 WAL 文 件 变化 ， 而 不 是 等 待 完成 的 WAL 文 件 
(Magnus Hagander) 


允许 pg_basebackup 从 备用 服务 器 上 做 基础 备份 (Jun Ishizuka, Fujii Masao) 
该 功能 允许 基础 备份 工作 从 主 服务 器 上 被 卸载 。 
当 pg_basebackup 在 执行 备份 时 ， 人 允许 WAL 文 件 流 (Magnus Hagander) 


人 允许 在 主 库 上 丢弃 之 前 传递 WAL 文 件 到 备 库 。 


E.8.3.3. 查询 


如 果断 开 客 户 端 连接 ， 取 消 运 行 的 查询 (Florian Pflug) 
如 果 在 查询 中 后 端 监测 客户 端 连 接 损 坏 ， 那 么 它 现在 将 取消 查询 而 不 是 党 试 完 成 它 。 
在 行 表 达 式 运行 时 保留 列 名 (Andrew Dunstan, Tom Lane) 


当 行 值 被 转换 为 hstore 或 者 json 类 型 时 : 结果 值 字段 有 期 望 名 ， 那 么 该 变化 允许 有 更 
好 结果 。 


改善 用 于 子 - sELECT 结果 的 列 标签 (Marti Raudsepp) 
以 前 使 用 一 般 标 签 ?column? 。 
提高 决定 未 知 值 类 型 的 探索 法 (Tom Lane) 


当 考 虑 多 态 操 作 符 的 时 候 ， 长 期 规则 是 一 个 未 知 常量 可 能 与 现在 应 用 它 的 操作 者 一 端的 
值 有 同样 类 型 ， 而 不 仅仅 操作 符 匹 配 。 


关于 创建 映射 或 者 来 自 域 类 型 的 警告 (Robert Haas) 
这 种 投射 没有 景 乡 响 。 


当 行 不 能 进行 cHEck 或 者 not NULL 约束 时 ， 显示 行内 容 作为 错误 详细 信息 (Jan 
Kundrat) 


当 插 入 或 者 更 新 处 理 多 行 时 ， 这 将 很 容易 识别 哪 行 是 有 问题 的 。 


E.8.3.4. 对 象 操作 


在 并 行 DDL 中 提供 更 可 靠 操作 (Robert Haas, Noah Misch) 


该 变化 增加 了 锁定 ， 它 应 该 删除 多 种 情况 中 "高 速 缓存 查找 失败 "错误 。 另外 ， 不 再 可 能 
添加 关系 到 正在 删除 的 模式 中 ， 先 前 导致 不 一 致 系统 目录 内 容 的 情况 。 


添加 CONCURRENTLY 选项 到 DRoP INDEX (Simon Riggs) 
允许 索引 删除 不 锁定 其 他 会 话 。 
允许 外 数据 包 有 每 一 列 选项 (Shigeru Hanada) 


改进 视图 定义 的 输出 (Andrew Dunstan) 


E.8.3.4.1. 约束 


允许 check 约束 被 声明 为 not vALID (Alvaro Herrera) 


添加 not VALID 约束 不 会 导致 扫描 的 表 可 以 验证 已 存在 行 满足 该 约束 。 随后 ， 检 查 新 添 
加 或 者 更 新 的 行 。 当 考虑 constraint_exclusion 时 ， 规划 器 忽略 这 些 约束 。 因 为 它 不 确 
定 所 有 行 可 以 满足 该 约束 。 


新 的 ALTER TABLE VALIDATE 命令 允许 为 已 存在 行 检查 noT vaio 限制 ， 之 后 被 转换 成 普 
通 约束 。 


允许 cHEck 限制 被 声明 为 ”No INHERIT (Nikhil Sontakke, Alex Hunsaker, Alvaro Herrera) 
这 使 得 它们 只 在 父 表 是 可 执行 的 ， 而 不 是 子 表 。 


添加 该 能 力 到 rename 约 束 (Peter Eisentraut) 


~ 


E.8.3.4.2. ALTER 


减少 重新 编译 表 需 要 以 及 RSID ALTER TABLE ... ALTER COLUMN TYPE 操作 (Noah 
Misch) 


增加 varchar 或 者 varbit 列 长 度 限制 ， 或 者 完全 删除 限制 ， 不 再 需要 表 重 写 。 类 似 地 ， 
增加 numeric 列 人 允许 的 精度 ， 或 者 改变 约束 的 numeric 列 到 不 受 约束 的 numeric, 不 再 
TERE, 在 涉及 Interval ， timestamp 和 timestamptz 类 型 的 相似 情况 中 避免 表 重 
写 。 

避免 ALTER TABLE 在 不 必要 的 情况 下 验证 外 键 约束 (Noah Misch) 

增加 IF exists 选项 到 一 些 ALTER 命令 中 (Pavel Stehule) 


比如 ALTER FOREIGN TABLE IF EXISTS foo RENAME TO bar o 


添加 ALTER FOREIGN DATA WRAPPER ... RENAME 和 ALTER SERVER ... RENAME (Peter 


Eisentraut) 

添加 ALTER DOMAIN ... RENAME (Peter Eisentraut) 

你 可 能 已 经 使 用 ALTER TYPE 重 命名 域 。 

在 不 存在 约束 上 为 ALTER DOMAIN ... DROP CONSTRAINT 抛 出 一 个 错误 (Peter Eisentraut) 


一 个 IF EXISTS 选项 已 被 添加 以 提供 先前 操作 。 


E.8.3.4.3. CREATE TABLE 


人 允许 CREATE TABLE (LIKE ...) 来 自 外 表 ， 视 图 和 复合 类 型 (Peter Eisentraut) 


比如 ， 模 式 匹配 视图 的 允许 创建 表 。 
。 当 拷 贝 索 引 注 释 时 ， 修 复 CREATE TABLE (LIKE ...) 以 避免 素 引 名 冲突 (Tom Lane) 


e 修复 CREATE TABLE ... AS EXECUTE 以 处 理 wITH no pata 和 列 名 称 规格 (Tom Lane) 


E.8.3.4.4. 对 象 权限 
e 为 视图 添加 security_barrier 选项 (KaiGai Kohei, Robert Haas) 


该 选项 可 以 防止 优化 可 能 允许 视图 受 保护 数据 暴露 给 用 户 ， 上 比如 推动 涉及 不 安全 函数 的 
子 句 到 视图 的 wer FA. 这 种 视图 预期 比 普通 视图 执行 更 差 。 


e 添加 新 的 LEAKPROooF WARM sizes 数 可 以 安全 地 向 下 推进 到 security_barrier 视图 
(KaiGai Kohei) 


增加 数据 类 型 权限 支持 (Peter Eisentraut) 


在 类 型 和 域 上 添加 SQL- 一 致 usAGE 权限 支持 。 其 意图 是 可 以 限制 哪个 用 户 在 类 型 上 可 以 
创建 依赖 ， 因 为 这 种 依赖 限制 修改 该 类 型 的 用 户 能 


e 检查 在 SELECT INTO / CREATE TABLE AS 中 的 INSERT 权限 (KaiGai Kohei) 


因为 通过 SELECT INTO 或 者 CREATE TABLE AS 创建 该 对 象 ， 那 么 创建 者 通常 有 插入 权限 ; 
但 是 有 一 种 不 真 的 困境 情况 ， 比如 当 ALTER DEFAULT PRIVILEGES 已 经 删除 该 权限 时 。 


E.8.3.5. 实用 操作 
© 人 允许 vacuum 更 容易 忽略 不 能 被 锁定 的 页 (Simon Riggs, Robert Haas) 
这 种 变化 会 大 大 降低 vacuum 获得 "stuck" 等 待 其 他 会 话 的 发 生 率 。 
e 使 得 EXPLAIN (BUFFERS) 计算 脏 块 和 写 入 的 (Robert Haas) 
o 使 得 EXPLAIN ANALYZE 报告 通过 过 滤 步 骤 拒 绝 的 行 数 (Marko Tiikkaja) 


当时 间 值 是 不 想 要 的 ， 人 允许 EXPLAIN ANALYZE 避免 时 间 开 销 (Tomas Vondra) 


通过 设置 新 的 TIMING 选项 到 FALSE 来 完成 。 


E.8.3.6. 数据 类 型 
e 添加 支持 range data types (Jeff Davis, Tom Lane, Alexander Korotkov) 


一 系列 数据 类 型 存储 从 属于 它 的 基本 数据 类 型 的 上 限 和 下 限 。 它 支 持 类 似 包含 ， 重 侣 和 
交叉 的 操作 。 


e 添加 sson 数据 类 型 (Robert Haas) 


这 种 类 型 存储 带 有 适当 验证 的 JSON (JavaScript 对 象 表示 法 ) 数 据 。 


RNA 


x 
e 添加 array_to_json() 和 row_to_json() (Andrew Dunstan) 
e 添加 smALLSERIAL 数据 类 型 (Mike Pultz) 
这 就 像 sSERIAL ， 除 了 它 以 两 个 字 节 整数 列 ( int2 ) 存 储 序列 之 外 。 


e 人 允许 domains 被 声明 为 not vALID (Alvaro Herrera) 


在 域 创建 时 间 设 置 该 选项 ， 或 者 通过 ALTER DOMAIN ... ADD CONSTRAINT ... NOT VALID . 
ALTER DOMAIN ... VALIDATE CONSTRAINT 充分 验证 该 限制 。 


e AT money 数据 类 型 支持 更 多 的 区 域 指定 格式 选项 (Tom Lane) 


特别 的 ， 为 了 该 值 顺序 ， 标 志 ， 以 及 货币 输出 中 的 货币 符号 纪念 POSIX 选 项 。 另 外 ， 确 
保 干 位 分 隔 符 只 被 插入 到 小 数 点 左边 ， 正 如 POSIX 要 求 的 。 


e 为 macaddr 数据 类 型 添加 按 位 "and", "or" 和 "not" 操 作 符 (Brendan Jurd) 
。 当 提 供 一 个 标量 值 时 ， 允许 xpath 返回 单一 元 素 XML 数 组 (Florian Pflug) 


先前 ， 它 返回 空 数组 。 这 种 变化 也 将 导致 xpath_exists() 为 这 种 表达 式 返 回 真 ， 而 不 是 
假 。 


。 提高 XML 错误 义理 以 变 得 更 健壮 (Florian Pflug) 


E.8.3.7. 函数 


e 人 允许 非 超 级 用 户 在 其 他 会 话 从 属于 同一 用 户 时 使 用 py cancel packend() 
和 pg_terminate_backend() (Magnus Hagander, Josh Kupershmidt, Dan Farina) 


以 前 只 有 超级 用 户 被 允许 使 用 这 FRX, 
。 人 多 许 事务 快照 的 输入 和 输出 (Joachim Wieland, Tom Lane) 


这 允许 多 个 事务 共享 数据 库 状 态 的 同一 视图 。 快 照 是 通过 pg_export_snapshot() 输出 ， 
通过 SET TRANSACTION SNAPSHOT 输入 。 只 有 当前 正在 运行 的 事务 快照 可 以 被 输入 


。 支持 表达 式 上 的 coLLaTIon For (Peter Eisentraut) 
返回 表达 式 排序 规则 的 字符 串 表 示 。 
e 添加 pg_opfamily_is visible() (Josh Kupershmidt) 


e 添加 numeric variant of pg_size_pretty() 适用 于 pg_xlog_location_diff() (Fujii 
Masao) 


e 添加 pg_trigger_depth() EX2X(Kevin Grittner) 


报告 当前 触发 器 调用 深度 。 

人 允许 string agg() 义理 bytea 值 (Pavel Stehule) 

在 一 个 较 大 的 量化 子 表达 式 中 发 生 后 向 引用 的 地 方 修复 正则 表达 式 (Tom Lane) 
比如 ^(\wr)( \1)+$ 。 先 前 版 本 并 不 检查 后 向 引用 实际 匹配 第 一 次 出 现 。 


E.8.3.8. 信息 模 陈 


添加 信息 模式 视图 role_udt_grants , udt_privileges , #0 user_defined_types (Peter 
Eisentraut) 


添加 复合 类 型 属性 到 信息 模式 element_types 视图 (Peter Eisentraut) 
信息 模式 中 实现 interval type 列 (Peter Eisentraut) 
以 前 这 些 列 读 取 为 空 。 


在 信息 模式 attributes ，columns , domains 和 element_types 视图 中 实现 排序 规则 相关 
列 (Peter Eisentraut) 


在 信息 模式 taple_privileges 视图 中 实现 with_hierarchy 列 (Peter Eisentraut) 
增加 序列 usace 权限 显示 到 信息 模式 中 (Peter Eisentraut) 
使 信息 模式 显示 人 缺 省 权限 (Peter Eisentraut) 


先前 ， 非 空缺 省 权限 没有 出 现在 视图 中 。 


E.8.3.9. 服务 器 端 语言 


E.8.3.9.1. PL/pgSQL 服 务 器 端 语 言 


允许 PL/pgSQL open 游标 命令 提供 参数 名 (Yeb Havinga) 

添加 GET STACKED DIAGNOSTICS PL/pgSQL 命 命 检 索 异 常 信息 (Pavel Stehule) 
通过 缓存 类 型 信息 加 快 PL/pgSQL 数 组 赋值 (Pavel Stehule) 

是 高 性 能 以 及 为 长 连续 ELSIF 子 句 内 存 损耗 (Tom Lane) 

在 PL/pgSQL 错 误 消 息 中 输出 画 数 签名 ， 而 不 仅仅 是 名 字 (Pavel Stehule) 


E.8.3.9.2. PL/Python 服 务 器 端 语 言 


添加 PL/Python SPI 游 标 支持 (Jan Urbanski) 


这 人 允许 PL/Python 读 取 部 分 结果 集 。 


添加 结果 元 数据 画 数 到 PL/Python (Peter Eisentraut) 
具体 地 说 ， 这 增加 了 结果 对 象 辑 数 .colnames ，.coltypes 和 .coltypmods o 


删除 支持 Python 2.2 (Peter Eisentraut) 


E.8.3.9.3. SQL 服 务 器 端 语言 


KiHSQLiZS HAERS RAZ (Matthew Draper) 
ATERAT, hah MAKASAR, FHBABSESQAL HMARHERAE, 


E.8.3.10. & > tim A 


添加 initdb 选项 --auth-local 和 --auth-host (Peter Eisentraut) 


这 人 允许 local 和 host pg_hba.conf 认证 设置 的 分 散 控制 ， --auth 仍然 控制 着 两 个 。 


~ 
> 


添加 --replication / --no-replication 标记 到 createuser 以 控制 备份 权限 (Fujii Masao) 


加 --if-exists 选项 到 dropdb 和 dropuser (Josh Kupershmidt) 


Ne 
心 


给 出 命令 行 工具 以 指定 要 连接 数据 库 名 字 ， 如 果 postgres 数据 库 连 接 失 败 ， 那么 回 退 


到 template1 (Robert Haas) 


E.8.3.10.1. psql 


添加 基于 显示 宽度 的 显示 模式 以 自动 扩展 输出 (Peter Eisentraut) 

增加 auto 选项 到 \x OT, SER 输出 比 屏幕 宽 的 时 候 ， 会 切换 到 扩展 模式 。 
允许 脚本 文件 的 包含 是 相对 于 它 被 调用 的 文件 目录 命名 的 (Gurjeet Singh) 
这 是 执行 新 的 命 爷 \ir o 

在 psql 变 量 名 中 添加 支持 非 ASCIll 字 符 (Tom Lane) 

添加 支持 主要 版 本 特定 .psqlrc 文件 (Bruce Monjian) 

psql 支 持 次 要 版 本 特定 .psqlrc 文件 。 

提供 环境 变量 覆盖 psql 历 史 并 且 和 启动 文件 位 置 (Andrew Dunstan) 

如 果 设 置 ， 那 么 PsQL_HISTORY 和 PsQLRC 决定 这 些 文件 名 。 

添加 \setenv 命令 修 改 传递 给 子 进 程 的 环境 变量 (Andrew Dunstan) 

命名 .sql 扩展 的 psql 的 临时 编辑 文件 (Peter Eisentraut) 


这 人 允许 扩展 敏感 编辑 者 选择 正确 模式 。 


。 人 允许 psql 使 用 需 字 节 字 段 并 且 记 录 分 隔 符 (Peter Eisentraut) 
使 用 需 字 节 (NUL) 分 隔 符 的 各 种 shell 工 具 ， 上 比如 find。 

© 使 用 \timing 选项 报告 查询 失败 时 间 (Magnus Hagander) 
以 前 只 为 成 功 查询 报道 时 间 。 

e 统一 并 固定 \copy 和 SQL copy Mpsql(Noah Misch) 


这 修复 错误 操作 更 加 可 预测 并 且 设 置 \set ON_ERROR_ROLLBACK o 


E.8.3.10.2. 信息 命令 
。 使 得 \d 在 序列 上 显示 拥有 它 的 表 / 列 名 (Magnus Hagander) 
e 显示 \d+ 中 列 的 统计 目标 (Magnus Hagander) 
。 显示 \du 中 角色 密码 截止 日 期 (Fabrizio de Royes Mello) 
。 显示 投射 ， 转 换 ， 域 和 语言 说 明 (Josh Kupershmidt) 
这 些 分 别 包 含 在 \dc+ ， xdc+ ，\dp+ 和 \dL 输出 中 。 
。 显示 SQL/MED 对 象 说 明 (Josh Kupershmidt) 
这 些 分 别 包 括 在 \des+ ，\det+ 输出 ， \dew+ 外 服务 器 ， 外 表 ， 和 外 数据 包装 器 
e 改变 \dd 仅 显 示 没 有 自身 反 斜 杠 命令 对 象 类 型 的 说 明 (Josh Kupershmidt) 
E.8.3.10.3. Tab 实 现 
e 在 psql tab 实 现 中 ， 在 大 小 写 情 况 下 依照 新 的 comP_kEYwoRD_cAsE 设置 实现 SQL 关键 字 
。 添加 tab 实 现 支持 execute (Andreas Karlsson) 
e 在 GRANT / REVOKE 中 添加 角色 引用 的 tab 实 现 (Peter Eisentraut) 
。 当 必 要 的 时 人 息 ， 人 允许 文件 名 的 tab 实 现 可 以 提供 引用 (Noah Misch) 
。 改变 tab 实 现 支持 TABLE 也 包含 视图 (Magnus Hagander) 
E.8.3.10.4. pg dump 
e 添加 --exclude-table-data 选项 到 pg_dump (Andrew Dunstan) 
这 人 允许 在 每 个 表 基 础 上 各 份 表 的 定义 而 不 是 它 的 数据 。 
e 添加 --section 选项 到 pg_dump 和 pg_restore (Andrew Dunstan) 


有 效 值 是 pre-data ，data , 和 post-data 。 给 定 的 该 选项 不 止 一 次 的 选择 两 个 或 更 多 部 
分 。 


。 使 用 pg_dumpall 首 先 备份 所 有 角色 ， 然 后 角色 上 的 所 有 配置 设置 (Phil Sorber) 
这 人 允许 角色 的 配置 设置 提 及 其 他 没有 产生 错误 的 角色 。 
。 如 果 在 新 的 集群 中 丢失 postgres 数据 库 ， 那 么 允许 pg_dumpall 避 免 错 误 (Robert Haas) 
。 按照 用 户 名 顺序 各 份 外 服务 器 用 户 映射 (Peter Eisentraut) 
这 有 助 于 产生 确定 性 备份 文件 。 
e 以 可 预见 性 顺序 各 份 操作 符 (Peter Eisentraut) 
e 当 扩 展 配 置 表 通 过 pg_dump 被 备份 时 ， 收 紧 规则 (Tom Lane) 
。 使 得 pg_dump 发 出 更 多 有 用 的 依赖 信息 (Tom Lane) 


包含 在 为 档 格式 转 储 中 的 依赖 关系 以 前 使 用 非常 有 限 ， 因为 他 们 经 常 引 用 似乎 不 在 转 储 
中 的 对 象 。 现在 他 们 在 转 储 对 象 之 间 代表 实际 的 依赖 关系 (可 能 是 间接 的 ) 。 


。 当 各 份 多 个 数据 库 对 象 时 ， 提 高 pg_dump 的 性 能 (Tom Lane) 


E.8.3.11. libpg 
。 人 允许 libpq 连 接 字符 串 有 URI 的 格式 (Alexander Shulgin) 


该 语法 以 postgres:// 开头 。 这 可 以 允许 应 用 程序 为 URI 表 示 数 据 库 连 接 避 人 免 实 现 它 们 自 
身 解析 器 。 


。 添加 连接 选项 以 禁用 SSL 压 缩 (Laurenz Albe) 
这 可 以 用 于 删除 快速 网 络 中 SSL 压 缩 的 开销 。 
。 为 了 更 好 处 理 大 的 结果 集 添加 单行 你 理 模 式 
此 前 ，libpq 将 其 返回 给 应 用 程序 之 前 总 是 收集 内 存 中 整个 查询 结果 。 


@ 添加 Const 限定 符 到 函数 PQconnectdbParams , PQconnectStartParams , 
和 PQpingParams 的 声明 (Lionel Elie Mamane) 


e 人 允许 .pgpass 文件 在 密码 域 中 包含 转 义 字符 (Robert Haas) 
e 当 必 须 终 止 进程 时 ， 党 试 库 图 数 使 用 abort) RË exit() (Peter Eisentraut) 


这 个 选择 并 不 妨碍 使 用 正常 退出 代码 程序 ， 并 产生 一 个 可 以 由 调用 者 捕捉 的 信号 。 


E.8.3.12. 源码 
。 删除 封闭 端口 号 (Peter Eisentraut) 


不 再 支持 下 列 平台 : dgux, nextstep, sunos4, svr4, ultrix4, univel, bsdi。 


。 添加 使 用 MS Visual Studio 2010 支 持 编译 (Brar Piening) 
。 启动 使 用 MinGW-w64 32- 位 编译 器 进行 编译 (Lars Kanis) 
Ba J+ 


o 在 安装 期 间 安 装 plpgsql.h 到 include/server (Heikki Linnakangas) 


。 提高 问 锁 装置 以 包含 postmaster 终 止 的 检测 (Peter Geoghegan, Heikki Linnakangas, Tom 
Lane) 


后 端 进程 先前 必须 意识 到 调查 事件 ， 这 消除 了 主要 原因 之 一 。 
。 支持 的 地 方 使 用 C 灵 活 数 组 元 素 (Peter Eisentraut) 
。 提高 并 行事 务 回 具 测试 (isolationtester) (Noah Misch) 
。 在 当前 目录 中 修改 thread test 创建 它 的 测试 文件 ， 而 不 是 /tmp (Bruce Momjian) 
。 提高 fex 和 bison 和 警告 和 错误 报告 (ITom Lane) 
。 添加 内 存 屏 障 支持 (Robert Haas) 
这 是 目前 未 使 用 的 。 
。 修改 pgindent 使 用 typedef 文 件 (Bruce Momjian) 
。 由 于 被 发 送 到 服务 器 添加 处 理 消 息 钓 子 (Martin Pihlak) 
e 为 prop 命 合 添 加 对 象 访问 钓 (KaiGai Kohei) 
。 集中 prop 义理 一 些 对 象 类 型 (KaiGai Kohei) 
。 添加 pg_upgrade 测 试 套件 (Peter Eisentraut) 
。 伴随 TCL 8.5.11 同步 正则 表达 式 代码 并 且 改 善 内 部 处 理 (Tom Lane) 
。 移动 CRC 表 到 libpgport， 在 一 个 单独 的 include 文 件 中 提供 它们 (Daniel Farina) 
© 为 了 用 于 主要 发 布 声明 创建 添加 选项 到 git_changelog (Bruce Momjian) 


e 支持 Linux 的 /proc/self/oom_score_adj API (Tom Lane) 


E.8.3.13. 额外 模块 
。 通过 使 用 libpq 的 新 单行 处 理 模 式 提高 dblink 的 效率 (Kyotaro Horiguchi, Marko Kreen) 
这 个 改进 不 适用 于 dblink_send_query() / dblink_get_result() o 
e 在 file_ fdw 中 支持 force_not_null 选项 (Shigeru Hanada) 


e 为 pg_archivecleanup 实 现 演习 模式 (Gabriele Bartolini) 


这 只 输出 已 删除 文件 名 。 
添 


。 添加 新 的 pgbench 切 换 --unlogged-tables , --tablespace 和 --index-tablespace (Robert 
Haas) 


e 改变 pg _test_fsync 以 测试 一 定量 的 时 间 ， 而 不 是 固定 周期 数 (Bruce Momjian) 
删除 -0 /周期 选项 ， 并 且 添 加 - s / 秒 。 
e 添加 pg_test_timing 功 能 以 测量 时 钟 一 致 性 和 时 间 开 销 (Ants Aasma, Greg Smith) 


e 添加 tcn (触发 变更 通知 ) 模块 在 表 变 更 上 生成 NoTIFY 事件 (Kevin Grittner) 


E.8.3.13.1. pg_upgrade 
。 调整 pg_upgrade 环 境 变量 (Bruce Momjian) 


重 命名 data,bin 和 以 po 开头 的 port 环 境 变量 ， 支持 PGPORTOLD / PGPORTNEW , HX 
代 PGPORT o 


。 检查 pg_upgrade 记 录 和 错误 报告 (Bruce Momjian) 


创建 四 个 附加 的 日 志文 件 ， 并 且 成 功 时 删除 它们 。 添加 - -retain 选项 无 条 件 的 保留 
这 些 文件 。 同 时 删除 不 必要 的 pg_upgrade 选 项 -g / -6 / -1 选项 ， 固定 日 志文 件 的 权 
BR. 


e 使 pg_upgrade 创 建 一 个 脚本 增 量 生成 更 精确 的 优化 统计 (Bruce Momjian) 
这 降低 了 升级 后 产生 最 小 的 集群 统计 所 需要 的 时 间 。 
e 人 允许 pg_upgrade 更 新 没有 postgres 数据 库 的 旧 的 集群 (Bruce Momjian) 
e 人 允许 pg_upgrade 处 理 新 的 或 旧 的 数据 库 丢 失 情 况 ， 只 要 它们 是 空 的 (Bruce Momjian) 


e 人 允许 pg_upgrade 处 理 配 置 目 录 安 装 (Bruce Momjian) 


e 在 pg_upgrade 中 ， 添 加 -o / -0 选项 传递 参数 到 服务 器 (Bruce Momjian) 
对 配置 目录 安装 有 作用 。 


e 改变 pg_upgrade 使 用 缺 省 port 50432(Bruce Momjian) 
这 有 助 于 在 更 新 期 间 避 免 意外 的 客户 端 连接 。 
。 减少 pg_upgrade 集 群 锁定 (Bruce Momjian) 


具体 来 说 ， 如 果 使 用 链接 模式 ， 那 么 只 锁定 旧 的 集群 。 并 且 在 存储 模式 之 后 执行 。 


E.8.3.13.2. pg_stat_statements 


e 人 允许 pg_stat_statements 通 过 SQL 文 本 标准 化 聚集 类 似 查 询 (Peter Geoghegan, Tom 
Lane) 


使 用 非 参 数 化 SQL 应 用 程序 的 用 户 可 以 没有 详细 的 日 志 分 析 监 控 查 询 性 能 。 
。 增加 脏 块 和 写 入 块 计算 以 及 读 / 守 时 间 到 pg_stat_statements (Robert Haas, Ants Aasma) 


。 避免 pg_stat_statements 来 自 prepare 和 execute 命令 的 重复 计算 (Tom Lane) 


E.8.3.13.3. sepgsql 
。 在 全 局 对 象 上 支持 security LABEL (KaiGai Kohei, Robert Haas) 
具体 来 涪 ， 添 加 数据 库 安全 标签 ， 表 空间 ， 和 角色 。 
。 人 允许 sepgsql 接 受 数据 库 标 签 (KaiGai Kohei) 
© 在 各 种 对 象 的 创建 过 程 中 执行 Sepgsql 权 限 检 查 (KaiGai Kohei) 
e 添加 sepgsql_setcon() 和 相关 画 数 以 控制 sepgsql 安 全 域 (KaiGai Kohei) 


。 添加 sepgsql 用 户 空 间 访 问 缓存 以 提高 性 能 (KaiGai Kohei) 


E.8.3.14. 文档 


。 使 用 网 站 上 的 样式 表 添 加 规则 用 以 随意 编译 HTML 文 档 (Magnus Hagander) 
使 用 gmake STYLE=website draft . 
e 改善 ExPLAIN 文档 (Tom Lane) 
。 记录 用 户 /数据 库 名 通过 命令 行 工 具 如 vacuumdb 使 用 双 引 号 保存 (Bruce Momjian) 
。 记录 通过 客户 端 MD5 认 证 返回 的 实际 字符 串 (Cyan Ogilvie) 
e 反对 在 CREATE TEMP TABLE 中 使 用 GLogAL 和 LocAL (Noah Misch) 


PostgreSQL 早 已 把 这 些 关 键 词 看 作 没 有 操作 ， 并 且 继 续 这 样 做 ; 但 在 未 来 他 们 可 能 意味 
着 SQL 标准 的 内 容 ， 所 以 应 用 程序 应 避免 使 用 它们 。 


E.9. 发 布 9.1.10 


发 布 日 期 : 2013-10-10 


该 发 布 包含 了 9.1.9 的 各 种 修复 。 关于 9.1 主 要 版 本 新 功能 的 信息 ， 请 参阅 Section E.19。 


E.9.1. 迁移 到 版 本 9.1.10 


为 了 运行 9.1.X 不 需要 转 储 /恢复 。 
同时 ， 如 果 你 是 从 9.1.6 更 早 版 本 更 新 ， 参 阅 9.1.6 的 发 布 说 明 。 


E.9.2. 变化 


。 [防止 多 字 节 编码 中 非 ASClIl 非 双 引 号 标识 符 的 小 写 转 换 (Andrew Dunstan) 
以 前 的 操作 是 错误 的 而 且 混乱 的 
e 当 wal_level = hot_standby 的 时 候 ， 修复 后 端 写 进程 中 检查 点 内 存 泄露 。(Naoya Anzai) 
。 修复 通过 lo_open() 故障 产生 的 内 存 泄露 。(Heikki Linnakangas) 
e 当 work_mem 正 使 用 大 于 24GB 的 内 存 时 ， 那么 修复 内 存 过 量 使 用 错误 。(Stephen Frost) 
。 可 串 行 化 快照 修复 (Kevin Grittner, Heikki Linnakangas) 
。 修复 libpq SSL 死 锁 错 误 (Stephen Frost) 
。 修复 线程 libpq 应 用 中 可 能 的 SSL 网 络 堆 变 化 (Nick Phillips, Stephen Frost) 
。 正确 计算 估计 布尔 列 包 含 许多 NULL 值 的 行 (Andrew Gierth) 


当 估 计 计 划 成 本 时 ， 先 前 的 测试 像 col Is NOT TRUE 和 col IS NOT FALSE 没有 合理 的 
NULL 值 因素 。 


e Alb #00 where 子 句 到 不 安 全 的 UNION/INTERSECT 子 查询 中 (Tom Lane) 

以 前 这 样 琶 加 可 能 产生 错误 。 
。 修复 通过 不 恰当 地 处 理 日 期 类 型 修饰 符 产 生 的 罕见 的 croup BY 查询 错误 (Tom Lane) 
。 修复 有 删除 列 的 外 表 的 pg_dump (Andrew Dunstan) 

先前 这 种 情况 可 能 导致 pg_upgrade 错 误 。 


。 重新 安排 相关 扩展 规则 的 pg_dump 钦 理 和 事件 触发 (Joe Conway) 


如 果 通 过 pg_dump -t 或 者 -n 指定 ， 那么 强制 扩展 表 转 储 (Joe Conway) 
允许 转 储 编码 更 好 地 久 理 基本 表 上 已 删除 的 列 (Tom Lane) 
使 用 显示 正确 格式 名 的 目录 为 档 修复 pg_restore -1 (Fujii Masao) 
正确 记录 使 用 uNIQUE 和 primary Key 语法 创建 的 索引 注释 (Andres Freund) 
这 将 修复 并 行 pg_restore 故 障 。 
清理 切换 之 前 合理 保证 WAL 文 件 传 输 (Fujii Masao) 
以 前 ， 在 各 库 上 所 有 WAL 文 件 被 取代 之 前 可 能 关闭 流 复制 连接 。 
在 恢复 期 间 提 高 WAL 段 时 间 线 义理 (Heikki Linnakangas) 


修复 REINDEX TABLE 和 REINDEX DATABASE 以 恰当 的 重新 生效 约束 并 且 标 记 无 效 索 引 为 有 
效 (Noah Misch) 


REINDEX INDEX 一 直 正 常 工作 。 

在 并 发 CREATE INDEX CONCURRENTLY 操作 期 间 修 复 可 能 死 锁 (Tom Lane) 

修复 regexp_matches() AES k & PL Ac(Jeevan Chalke) 

Jc, SKE LAR A Lok eg iRS Lac. 

修复 过 于 复杂 的 正则 表达 式 的 错误 (Heikki Linnakangas) 

为 反 向 引用 结合 非 贪 攀 量词 修复 正则 表达 式 匹 配 错误 (Jeevan Chalke) 

避免 CREATE FUNCTION 检查 SET 变量 除非 启动 函数 体检 查 (Tom Lane) 

允许 ALTER DEFAULT PRIVILEGES 在 模式 上 操作 不 需要 CREATE 权 限 (Tom Lane) 

放宽 用 于 查询 中 关键 字 的 限制 (Tom Lane) 

特别 地 ， 放 宽 角色 名 称 ， 语 言 名 字 ， EXPLAIN 和 copy 选项 ， 以 及 set 值 的 关键 字 限 


fil], 这 允许 copy ... (FORMAT BINARY) 事先 BINARY 需要 单 引 号 。 
修复 pgp_pub_decrypt() 因此 为 带 有 密码 的 秘 钥 工 作 (Marko Kreen) 


pg_upgrade 使 用 agt;pg_dump --quote-all-identifiers 避免 在 发 布 之 间 关 键 字 改变 的 问 
题 (Tom Lane) 


在 清理 无 索引 表 中 三 除 少 有 的 不 正确 的 警告 (Heikki Linnakangas) 

在 已 取消 文件 截断 请 求 后 提高 分 析 统 计生 成 (Kevin Grittner) 

当 在 预备 查询 中 执行 事务 控制 命令 (比如 RoLLBACK jit, 避免 可 能 的 失败 (Tom Lane) 
允许 在 所 有 平台 上 无 穷 大 的 各 种 拼写 (Tom Lane) 


SHAN "int", "+inf", "-inf", "infinity", "+infinity"#"-infinity". 
。 扩展 记录 和 数组 比较 行 的 能 力 (Rafal Rzepecki, Tom Lane) 


e 为 了 |srael, Morocco, Palestine,Paraguay 中 DST 变 化 规律 的 DST 变 化 规律 更 新 时 间 区 域 
数据 文件 到 tzdata 发 布 2013d。 同时 为 Macquarie lsland 修 正 历史 区 域 数据 (Tom Lane) 


E.10. £ 79.1.9 


发 布 日 期 : 2013-04-04 


该 版 本 包含 了 9.1.8 的 各 种 修复 。 关于 9.1 主 要 版 本 的 新 功能 信息 ， 请 参阅 Section E.19。 


E.10.1. 迁移 到 版 本 9.1.9 


为 了 运行 9.1.X 不 需要 转 储 / 恢 复 。 


然而 ， 该 发 布 修正 了 GiST 索 引 管 理 的 一 些 错误 。 在 安装 这 个 更 新 之 后 ， REINDEX 任何 GiST 
索引 满足 一 个 或 更 多 个 下 面 描述 的 条 件 是 明智 的 。 


同时 ， 如 果 你 正 从 9.1.6 更 早 版 本 中 更 新 ， 参 阅 9.1.6 的 发 布 说 明 。 


E.10.2. 变化 


。 修复 服务 器 命令 行 开 关 安 全 解析 (Mitsumasa Kondo, Kyotaro Horiguchi) 


包含 以 " - "开头 的 数据 库 名 字 的 连接 请 求 可 以 用 来 损坏 或 者 破坏 服务 器 的 数据 目录 文 
件 ， 即 使 最 终 拒绝 该 请 求 。(CVE-2013-1899) 


。 在 每 个 postmaster 子 进程 中 重 置 OpenSSL 随 机 状态 (Marko Kreen) 


通过 contrib/pgcrypto 函数 产生 的 随机 数 可 能 对 于 另外 一 个 猜测 的 数据 库 用 户 相对 容 
易 ， 避免 这 种 情况 。 当 postmaster 使 用 ssl = on 被 配置 时 ， 该 风险 是 非常 显著 的 ， 
但 是 大 多 数 连接 不 能 使 用 SSL 加 密 。(CVE-2013-1900) 


。 使 用 REPLICATION 权 限 检 查 测试 当前 用 户 不 是 认证 用 户 (Noah Misch) 


一 个 未 经 授权 的 数据 库 用 户 可 以 利用 这 个 错误 调用 pg_start_backup() 或 
者 pg_stop_backup() ,因此 可 能 干扰 常规 各 份 的 创建 。(CVE-2013-1901) 


。 当 不 适合 这 样 执 行 时 ， 不 使 用 "fuzzy" 几 何 比较 修复 GiST 索 引 。 (Alexander Korotkov) 


核心 几何 类 型 使 用 "fuzzy" 等 式 执 行 比较 ， 但 是 gist_box_same 必须 执行 精确 比较 ， 否则 
GiST 索 引 使 用 它 可 能 变 得 不 一 致 。 安装 这 个 更 新 之 后 ， 用 户 应 该 在 box, polygon, 
circle 或 者 point 列 上 REINDEX 任何 GiST 索 引 ， 因为 所 有 这 些 使 用 gist_box_same o 


。 修复 不 正确 的 范围 并 集 以 及 为 了 可 变 宽 度数 据 类 型 使 用 contrib/btree_gist 的 GiST 索 引 
中 惩罚 逻辑 ， 也 就 是 text, bytea, bit 和 numeric 列 (Tom Lane) 


这 些 错 误 可 能 导致 不 一 致 索引 ， 其 中 一 些 出 现 的 关键 字 不 会 被 搜索 发 现 ， 并 且 在 无 用 的 
索引 膨胀 中 ， 在 安装 此 更 新 后 建议 用 户 REINDEX 这 种 索引 。 


修复 为 多 列 素 引 在 GiST 页 中 分 离 代码 的 错误 (Tom Lane) 


这 些 错误 可 能 导致 不 一 致 素 引 ， 其 中 一 些 出 现 的 关键 字 不 会 被 搜索 发 现 ， 并 且 在 索引 中 
是 不 必要 的 无 效 的 搜索 。 在 安装 此 更 新 后 建议 用 户 REINDEX 多 列 GiST 索 引 。 


修复 gist_point_consistent 义理 模糊 一 致 性 (Alexander Korotkov) 


在 point 列 GiST 索 引 上 的 索引 扫描 可 能 有 时 产生 不 同 于 顺序 扫描 的 结果 ， 
为 gist_point_consistent 不 同意 底层 操作 编码 关于 是 否 精确 或 者 模糊 的 执行 比较 。 


在 WAL 重 放 中 修复 缓冲 区 泄露 (Heikki Linnakangas) 
在 回放 期 间 这 个 缺陷 可 能 产生 "不 正确 的 本 地 针 数 "错误 ， 使 得 恢复 不 可 能 。 
修复 DELETE RETURNING 中 的 亲 乱 情况 (Tom Lane) 


在 这 样 的 情况 下 ， DELETE RETURNING 试图 从 当前 进程 不 再 有 任何 针 的 共享 缓冲 区 中 抓 取 
数据 。 如 果 一 些 其 他 进程 同时 改变 缓冲 区 ， 这 将 导致 垃圾 RETURNING 输出 ， BAAR. 


修复 规则 表达 式 编 译 中 的 无 限 循 环 风险 (Tom Lane, Don Porter) 
修复 规则 表达 式 编译 中 潜在 的 空 指针 引用 (Tom Lane) 
合适 的 地 方 修复 to_char() 只 PAASCIAN SH & I (Tom Lane) 


这 种 修复 一 些 区 域 独 立 化 的 模板 模式 的 不 当 行为 ， 但 是 在 Turkish 区 域 中 胡乱 操作 " TI "和 


" " 
loo 


修复 时 间 戳 1999-12-31 24:00:00 不 必要 的 拒绝 (Tom Lane) 

当 一 个 事务 执行 UNLISTEN 然后 Listen 时 ， 修 复 逻 辑 错 误 (Tom Lane) 

该 会 话 根本 不 监听 通知 事件 ， 尽 管 它 确 实在 这 种 情况 下 应 该 监听 。 

在 列 被 添加 到 依赖 于 其 他 视图 的 视图 中 之 后 修复 可 能 的 规划 器 崩溃 (Tom Lane) 
删除 无 效 的 "picksplit 不 支持 的 二 次 分 裂 " 日 志 消 息 (Josh Hansen, Tom Lane) 


该 消息 似乎 被 添加 到 从 未 写 入 的 期 望 代码 中 ， 并 且 可 能 从 来 不 是 ， 因 为 二 次 分 裂 的 GiST 
的 缺 省 处 理 实际 上 相当 好 。 所 以 停止 打扰 关于 它 的 最 终 用 户 。 


修复 发 送 会 话 的 最 后 几 个 事务 提交 /终止 计数 到 统计 收集 器 的 可 能 错误 (Tom Lane) 
消除 在 PL/Perl 中 的 spi_prepare() WAIA AEE (Alex Hunsaker, Tom Lane) 
修复 pg_dumpall 以 处 理 正 确 包含" = "的 数据 库 名 字 (Heikki Linnakangas) 


当 给 定 一 个 不 正确 的 连接 字符 串 时 ， 避免 pg_dump 中 月 溃 (Heikki Linnakangas) 


忽略 pg_dump 和 pg_upgrade 中 EARI (Michael Paquier, Bruce Momjian) 


备份 无 效 素 引 可 能 导致 恢复 时 间 的 问题 ， 比如 如 果 素 引 创建 失败 的 原因 是 它 试 图 强制 不 
满足 表 的 数据 的 唯一 性 条 件 。 同 时 ， 如 果 素 引 创建 实际 上 仍然 在 进行 中 ， 认为 它 是 一 个 
不 受 约束 的 DDL 变 化 似乎 是 合理 的 ， 其 中 pg_dump 不 期 望 各 份 。pg_upgrade 现 在 也 跳 过 
无 效 索 引 而 非 失败 。 


在 pg_basebackup 中 ， 当 各 份 表 空间 时 ， 仅仅 包含 当前 服务 器 版 本 的 子 目录 (Heikki 
Linnakangas) 


在 pg_basebackup 和 pg_receivexlog 中 添加 服务 器 版 本 检查 ， 因此 它们 与 不 工作 的 版 本 
联合 失败 (Heikki Linnakangas) 

修复 contrib/pg_trgm 的 similarity) 回 数 为 少 于 三 个 的 字符 串 返 回 需 (Tom Lane) 
先前 它 返回 NaN 由 于 内 部 除 以 需 。 


为 了 Chile, Haiti, Morocco, Paraguay 和 一 些 Russian 区 域 中 DST 变 化 规律 更 新 时 间 区 域 数 
据 文件 到 tzdata 发 布 2013b。 同时 为 更 多 地 方 修正 历史 区 域 数据 。 


同时 ， 为 俄罗斯 和 其 他 地 方 的 最 近 变 化 更 新 时 区 缩写 文件 : cHoT ，GET ，IRKT ，KGT ， 
KRAT , MAGT ，MAWT , MSK, NOVT, OMST, TKT, VLAT, WST, YAKT, YEKT 现在 遵从 他 
们 当前 的 含义 ， LAR vort (Europe/Volgograd) 和 mist (Antarctica/Macquarie) 被 添加 
到 缺 省 缩写 列表 中 。 


E.11. £ 49.1.8 


发 布 日 期 : 2013-02-07 


此 版 本 包含 了 9.1.7 各 种 修复 。 关于 9.1 主 要 版 本 的 新 功能 的 信息 ， 参阅 Section E.19。 


E.11.1. 迁移 到 9.1.8 


为 了 运行 9.1.X 不 需要 转 储 /恢复 。 
然而 ， 如 果 你 是 从 早 于 9.1.6 的 版 本 上 更 新 ， 参 阅 9.1.6 发 布 说 明 。 


E.11.2. 变化 


e 防止 来 自 SQL 的 enum_recv 的 执行 (Tom Lane) 


该 图 数 被 错误 声明 ， 人 允许 简单 SQL 命 合 导 致 服务 器 月 江 。 原则 上 攻击 者 可 以 使 用 它 检查 
服务 器 内 存 的 内 容 。 我 们 该 感谢 Sumit Soni (通过 Secunia SVCRP) 报 告 这 个 问题 。 
(CVE-2013-0255) 


e 当 检 测 WAL 回 放 期 间 达 到 一 致 性 数据 库 状态 时 ， 修 复 多 个 问题 。 (Fujii Masao, Heikki 
Linnakangas, Simon Riggs, Andres Freund) 


。 当 截 断 关 系 文件 时 ， 更 新 最 小 恢复 点 (Heikki Linnakangas) 
一 旦 丢弃 数据 ， 在 时 间 轴 早 一 点 的 时 候 停 止 恢 复 不 再 安全 。 
。 在 改变 恢复 目标 时 间 轴 后 修复 WAL 段 再 循环 (Heikki Linnakangas) 
。 在 热 各 模式 中 修复 失去 的 取消 (Noah Misch, Simon Riggs) 
取消 热 备份 查询 冲突 的 需要 有 时 会 被 错过 ， 人 允许 这 些 查询 来 查看 不 一 致 数据 。 
。 防止 用 户 可 以 连接 之 前 从 暂停 中 恢复 暂停 功能 (Tom Lane) 
。 修复 SQL 语法 以 允许 来 自 子 SELECT 结果 的 下 标 或 者 字段 选择 (Tom Lane) 
。 解决 策 忙 工作 负载 中 自动 清理 截断 的 性 能 问题 (Jan Wieck) 


在 表格 末尾 的 空白 页 截断 需要 排他 锁 ， 但 自动 清理 编码 失败 (并 且 释放 表 锁 ) 当 有 冲突 
的 锁 请 求 时 ， 在 负载 下 ， 很 可 能 截断 永远 都 不 会 发 生 ， 导 致 表 的 膨胀 。 通过 执行 局 部 截 
断 进 行 修复 ， 释 放 锁 ， 然 后 试图 重新 获取 锁 并 且 继 续 。 该 修复 在 自动 清理 释放 锁 之 前 冲 
突 请 求 到 达 之 后 将 大 大 减少 平均 时 间 。 


当 扫描 pg_tablespace 的 时 候 ， 防止 竞争 条 件 (Stephen Frost, Tom Lane) 


如 果 有 pg_tablespace 项 的 并 发 更 新 ， 那么 CREATE DATABASE 和 DROP DATABASE 可 能 行为 
不 当 。 


防止 prop owen 试图 删除 整个 数据 库 或 者 表 空 间 (Alvaro Herrera) 
为 了 安全 起 见 ， 这 些 对 象 的 所 有 权 必 须 被 重新 分 配 ， 而 不 是 删除 。 


修复 vacuum_freeze_table age 实现 中 的 错误 (Andres Freund) 





在 安装 中 不 只 存在 vacuum freeze minage 事务 ， 个 错误 防止 自动 清理 使 用 部 分 表 打 
fa, 因此 相反 可 能 会 发 生 全 表 打 描 。 


当 RowExpr 或 者 xmlExpr 被 解析 两 次 时 ， 避免 不 当 行 为 (Andres Freund, Tom Lane) 
这 个 错误 在 上 下 文中 是 用 户 可 见 的 ， 比如 CREATE TABLE LIKE INCLUDING INDEXES o 

提高 在 哈 希 表 大 小 计算 中 防御 整数 浴 出 (Jeff Davis) 

在 服务 器 崩溃 之 后 修复 忽略 剩余 临时 表 错 误 (Tom Lane) 

拒绝 to_date() 中 超期 范围 日 期 (Hitoshi Harada) 

修复 pg_extension_config_dump() 以 适当 义理 扩展 更 新 情况 (Tom Lane) 

这 个 画 数 现在 将 取代 目标 表 的 任何 已 经 存在 项 ， 使 它 可 以 用 于 扩展 更 新 脚本 。 

修复 函数 的 PL/Python 的 处 理 作为 多 表 上 的 触发 器 (Andres Freund) 

确保 非 ASCII 提 示 符 字符 串 被 翻译 成 Windows 上 正确 代码 页 (Alexander Law, Noah Misch) 

个 错误 影响 psql 和 一 些 其 他 客户 端 程序 。 
当 不 连接 数据 库 时 ， 修复 psql's \? 命令 中 可 能 的 崩溃 (Meng Qingzhong) 


当 正 在 运行 pg_basebackup 时 ， 如 果 删 除 关 系 文件 ， 那 么 修复 可 能 的 错误 (Heikki 
Linnakangas) 


当 在 热 备份 服务 器 上 运行 时 ， 使 得 pg_dumop 排除 未 记录 表 的 数据 (Magnus Hagander) 
因为 数据 在 备用 服务 器 上 是 不 可 用 的 ， 这 可 能 会 失败 ， 因此 它 似乎 认为 最 方便 的 是 自动 


假设 --no-unlogged-table-data 。 
修复 pg_upgrade 以 安全 义理 无 效 素 引 (Bruce Momjian) 
修复 libpq 的 PaprintTuples 中 一 个 字 节 缓冲 浴 出 (Xi Wang) 


个 以 往 的 画 数 不 再 通过 PostgreSQL 自 身 被 用 于 任何 地 方 ， 但 是 它 仍 然 可 能 通过 一 些 
a 出 代码 被 使 用 。 


使 得 ecpglib 正 确 使 用 已 翻译 信息 (Chen Huajun) 

在 MSVC 上 正确 安装 ecpg_compat 和 pgtypes 库 (Jiang Guiqing) 

如 果 它 不 是 通过 系统 提供 的 ， 那么 在 libecpg 中 包含 isinf() 版 本 (Jiang Guiqing) 
重新 配置 已 提供 函数 的 配置 济 试 ， 因此 它 不 会 被 libeditlibreadline 假 输出 蒙骗 。 
确保 随时 间 变 化 增加 的 Windows 编 译 数 (Magnus Hagander) 


当 为 Windows 交 叉 编译 时 ， 使 pgxs 编 译 带 有 正确 .exe 后 级 的 可 执行 文件 (Zoltan 
Boszormenyi) 


添加 新 的 时 区 缩写 FET (Tom Lane) 


这 用 于 一 些 东 欧 时 区 。 


E.12. 发 布 9.1.7 


发 布 日 期 : 2012-12-06 


此 版 本 包含 了 9.1.6 的 各 种 修复 。 关于 9.1 主 要 版 本 中 新 功能 的 信息 ， 参阅 Section E.19。 


E.12.1. 迁移 到 版 本 9.1.7 


为 了 运行 在 9.1.X 上 不 需要 转 储 /恢复 。 


然而 ， 如 果 你 正 从 9.1.6 早 期 版 本 更 新 ， 那 么 人 参阅 9.1.6 发 布 说 明 。 


E.12.2. %14k 


修复 与 CREATE INDEX CONCURRENTLY 相关 的 多 个 错误 (Andres Freund, Tom Lane) 


当 改 变 索引 的 pg_index 行 状态 时 ， 修复 CREATE INDEX CONCURRENTLY 使 用 适当 更 新 。 这 
可 以 防止 导致 并 发 会 话 错 过 更 新 目标 索引 的 竞争 条 件 ， 因此 导致 崩溃 同时 创建 索引 。 


同时 ， 修 复 各 种 其 他 操作 以 确保 他 们 忽略 来 源 于 失败 的 CREATE INDEX CONCURRENTLY AP 
的 无 效 索 引 。 这 些 中 最 重要 的 是 vacuum, 因为 在 采取 的 纠正 措施 用 于 修复 或 删除 无 效 
索引 之 前 ， 在 表 上 自动 清理 可 以 很 容易 地 被 运行 。 


在 WAL 回 放 期 间 修复 缓冲 区 锁定 (Tom Lane) 


当 回 放 影 响 多 页 的 WAL 记 录 时 ，WAL 回 放 代码 对 于 锁定 缓冲 区 不 够 小 心 。 这 可 能 热 备份 
查询 瞬时 看 到 不 一 致 的 状态 ， 导致 错误 结果 或 意外 的 失败 。 


修复 GIN 索 引 的 WAL 生 成 逮 辑 的 错误 (Tom Lane) 

如 果 发 生 残缺 页 故障 ， 那 么 这 会 导致 索引 月 溃 。 

当 推 进 热 备份 服务 器 正常 运行 时 ， 正确 删除 启动 进程 的 虚拟 XID 锁 (Simon Riggs) 
这 种 监督 可 以 防止 某 个 操作 的 后 续 执 行 比 如 CREATE INDEX CONCURRENTLY o 

在 待机 模式 下 避免 虚假 "out-of-sequence timeline ID" 错 误 (Heikki Linnakangas) 
在 接收 到 停机 信和 号 后 ， 防 止 发 起 新 的 子 进程 的 postmaster(Tom Lane) 

这 个 错误 可 能 导致 关闭 更 长 比 它 应 该 的 ， 或 者 没有 额外 用 户 操作 甚至 不 能 完成 。 
当 内 存 不 足 时 ， 那 么 避免 内 部 哈 希 表 的 骨 溃 (Hitoshi Harada) 


避免 已 删除 表 的 文件 描述 符 可 以 保持 打开 以 往事 务 结 束 (Tom Lane) 


这 可 以 减少 长 时 间 已 删除 表 继 续 占 用 磁盘 空间 的 问题 。 


当 一 个 新 的 子 进程 不 能 为 它 的 锁 创 建 一 个 管道 ， 那 么 防止 SHE man LAR (Tom 
Lane) 


尽管 新 的 进程 失败 ， 没有 充分 的 理由 强迫 数据 库 端 重启 ， 所 以 避免 它 。 当 内 核 基本 没有 
文件 描述 符 时 ， 那 么 这 提高 了 和 鲁 棒 性 。 


修复 外 连接 上 非 严 格 等 价 分 句 规划 (Tom Lane) 


规划 器 可 以 从 等 同 于 其 它 东 西 的 非 严格 建构 的 分 句 中 获取 不 正确 约束 ， 比如 当 foo 来 源 
于 外 连接 失效 端 时 ， WHERE COALESCE(foo, ©) = 0 o 


在 继承 树 上 使 用 索引 优化 的 mn / max 修复 SELECT DISTINCT (Tom Lane) 

该 规划 器 伴随 着 "没有 重新 找到 MinMaxAgglnfo 记 录 " 给 定 这 些 结 合 因素 而 失败 。 
提高 从 等 价 类 证 实 排他 约束 的 规划 器 能 力 (Tom Lane) 

修复 在 哈 希 子 计划 中 部 分 行 匹 配 以 正确 处 理 交 叉 类 型 情况 (Tom Lane) 


这 影响 多 列 not IN 子 计划 ， 比如 WHERE (a, b) NOT IN (SELECT x, y FROM...) 当 比 
Mb 和 y 分 别 是 inta 和 ints 的 时 候 。 这 个 错误 导致 错误 结果 或 者 取决 于 依赖 于 涉及 
到 的 特定 数据 类 型 的 月 涡 。 


当 为 AFTER ROW UPDATE/DELETE 触发 器 重新 读 取 旧 的 元 组 时 ， 那么 获取 缓冲 锁 (Andres 
Freund) 


在 非常 罕见 的 情况 下 ， 这 一 朴 忽 可 能 导致 传递 不 正确 数据 到 蚀 发 器 whEN 条 件 ， 或 者 为 
外 键 执 行 触发 器 预 检 查 逮 辑 。 这 可 能 导致 崩溃 ， 或 者 关于 是 否 触发 触发 器 的 错误 决定 。 


修复 ALTER coLuMN TYPE 以 正确 处 理 已 继承 的 检查 约束 (Pavan Deolasee) 
这 在 8.4 版 本 之 前 正常 运行 ， 并 且 现 在 在 8.4 以 及 以 后 也 正常 运行 。 


修复 ALTER EXTENSION SET SCHEMA 的 错误 以 移动 一 些 子 对 象 到 新 的 模式 (Alvaro Herrera, 
Dimitri Fontaine) 


修复 REASSIGN owned 以 处 理 表 空间 授权 (Alvaro Herrera) 
忽略 视图 系统 列 中 不 正确 的 pg_attribute 项 (Tom Lane) 


视图 没有 任何 系统 列 。 然 而 ， 当 转换 表 到 视图 时 ， 我 们 乓 了 删除 这 项 。 9.3 以 及 以 后 的 正 
确 修 复 ， 但 是 在 以 前 的 分 支 中 我 们 需要 防御 已 经 存在 的 错误 转换 视图 。 


修复 规则 输出 以 正确 备份 INSERT INTO _table_ DEFAULT VALUES(Tom Lane) 
当 在 查询 中 有 很 多 UNION / INTERSECT / except 子 句 时 ， 避免 栈 浴 出 (Tom Lane) 


当 将 最 小 可 能 整数 值 除 以 -1 时 ， 避 免 平 台 相 关 故 障 (Xi Wang, Tom Lane) 


修复 日 期 解析 中 字符 串 可 能 的 访问 先前 终止 部 分 (Hitoshi Harada) 


在 检查 点 期 间 如 果 产 生 XID 重 人 癌 ， 修 复 先 前 XID 纪 元 错误 ， 并 且 
wal_level 是 hot_standby (Tom Lane, Andres Freund) 


当 这 个 错误 对 PostgreSQL 自 身 没 有 特别 影响 ， 对 于 依赖 于 txid_current() 和 相关 图 数 : 
TXID 值 可 能 出 现 回 退 ， 这 是 一 个 不 好 的 应 用 。 


修复 页 面 边 界 上 pg_stat_replication . sync_state 的 显示 (Kyotaro Horiguchi) 


如 果 为 了 Unix 域 套 接 字 路 径 名 长 度 超过 了 特定 平台 限制 ， 那么 产生 一 个 可 理解 的 错误 信 
息 (Tom Lane, Andrew Dunstan) 


以 前 ， 这 可 能 导致 一 些 无 用 的 东西 ， 比 如 "域名 解析 中 不 可 恢复 错误 " 

当 发 送 复合 列 值 到 客户 端 时 ， 修 复 内 存 泄 露 (Tom Lane) 

使 得 pg_ctl 对 读 取 postmaster.pid 文件 更 具有 重 棒 性 (Heikki Linnakangas) 
修复 竞争 条 件 和 可 能 的 文件 描述 符 泄露 。 


如 果 提 出 错误 的 编码 数据 ， 修 复 psql 中 可 能 的 错误 ， FA client_encoding 设置 是 客户 端 
编码 ， 比 如 SJIS (Jiang Guiqing) 


在 不 是 为 档 的 预先 数据 部 分 的 数据 中 使 得 pg_dump 备 份 sSEQUENCE set 项 (Tom Lane) 
该 变化 修复 被 标记 为 扩展 配置 表 的 序列 的 各 份 。 
修复 在 tar 输出 格式 中 通过 pg_dump 发 出 的 restore.sql 脚本 中 的 错误 (Tom Lane) 


该 脚本 可 能 在 它 的 名 字 包 含 大 写字 符 的 表 中 完全 失败 。 另外 ， 使 得 脚本 有 能 力 存储 数据 
到 --inserts 模式 和 规则 的 COPY 模 式 。 


修复 pg_restore 以 接受 POSIX 标 准 tar 文件 (Brian Weaver, Tom Lane) 


pg_dump 的 tar 输出 模式 的 原 编码 产生 与 POSIX 标 准 不 完全 一 致 的 文件 。 这 是 9.3 版 本 
的 校正 。 这 个 补丁 更 新 先前 分 支 ， 以 致 于 它们 接受 正确 的 和 不 正确 格式 ， 当 发 布 9.3 
时 ， 和 希望 避免 兼容 性 问题 。 


修复 通过 pg_basebackup 到 POSIX 一 致 发 出 的 tar 文件 (Brian Weaver, Tom Lane) 


当 给 定 一 个 数据 目录 的 相对 路 径 时 ， 修 复 pg_resetxlog 以 正确 定位 postmaster.pid (Tom 
Lane) 


这 个 错误 可 能 导致 pg_resetxlog 没 有 注意 到 有 使 用 数据 目录 的 活跃 postmaster。 
修复 libpq 的 lo_import() 和 1o_export() 函数 以 正确 报告 文件 |/O 错 误 (Tom Lane) 


修复 嵌 套 结构 指针 变量 的 ecpg 久 理 (Muhammad Usama) 


修复 ecpg 的 ecpg_get_data 函数 以 正确 处 理 数组 (Michael Meskes) 


当 正 在 检查 页 的 时 候 ， 使 得 contrib/pageinspect 的 btree RK AWA AHH (Tom 
Lane) 


确保 make install 为 扩展 创建 extension 安装 目录 (Cédric Villemain) 
先前 ， 如 果 在 扩展 的 Makefile 中 设置 MopuLEDIR ， 可 以 忽略 这 步 。 
修复 pgxs 在 AlIX 上 支持 创建 可 加 载 模块 (Tom Lane) 

编译 起 初 源码 树 外 部 模块 在 AlX 上 不 工作 。 


在 Cuba, Israel, Jordan, Libya, Palestine, Western Samoa 以 及 Brazil 地 区 中 为 DST 变 化 规 
律 更 新 时 区 数据 文件 到 tzdata 发 布 2012j。 


E.13. £ 79.1.6 


发 布 日 期 : 2012-09-24 


该 发 布 中 包含 来 自 9.1.5 的 各 种 修复 。 关于 9.1 主 要 版 本 的 新 功能 的 信息 ， 参阅 Section E.19。 


E.13.1. 迁移 到 版 本 9.1.6 


为 了 运行 9.1.X 不 需要 转 储 /恢复 。 
然而 ， 你 可 能 需要 执行 REINDEX 从 下 面 第 一 个 日 志 项 描述 的 数据 损坏 错误 的 影响 中 恢复 。 
另外 ， 如 果 你 从 9.1.4 更 里 版 本 更 新 ， 查看 9.1.4 的 发 布 说 明 。 


E.13.2. %14k 


。 在 WAL 回 放 期 间 修 复 共 享 缓冲 区 的 持久 性 标记 (Jeff Davis) 


这 个 错误 会 导致 缓冲 区 在 检查 点 期 间 不 被 写 出 来 ， 如 果 服 务 器 没有 写 入 缓冲 区 崩溃 后 ， 

导致 数据 损坏 。 在 任何 服务 器 崩溃 恢复 之 后 发 生 崩 溃 ， 但 它 显 著 的 可 能 发 生 在 各 用 子 服 
务 器 上 ， 因为 这 些 执行 更 多 WAL 回 放 。 有 btree 和 GIN 索 引 损 坏 的 低 概 率 。 有 表 " 可 见 视 
图 "损坏 的 更 高 概率 。 幸运 的 是 ， 可 见 视图 是 9.1 中 非 关键 数据 ， 因此 9.1 安 装 中 这 样 的 损 
坏 最 糟糕 的 后 果 是 清理 短 哲 无 效 。 表 正 确 的 数据 无 法 被 这 个 错误 损坏 。 


虽然 没有 索引 损坏 ， 由 于 这 个 错误 已 经 在 该 字段 发 生 ， 作为 预防 措施 建议 在 更 新 到 9.1.6 
之 后 在 方便 的 时 候 产 品 安 装 REINDEX 所 有 btree 和 GIN 索 引 。 


同时 ， 如 果 你 打算 做 适当 升级 到 9.2.X， 在 做 这 些 之 前 所 以 建议 执行 所 有 表 的 vacuum ， 
当 vacuum freeze table age 设置 为 需 时 ， 这 将 确保 在 9.2.X 可 以 依赖 它 之 前 校正 可 见 视图 
中 的 任何 残留 的 错误 数据 。 可 以 调整 vacuum cost_delay 以 减少 清理 的 性 能 影响 ， 而 造 
成 它 需 要 更 长 时 间 完 成 。 





。 修复 执行 器 参数 的 规划 器 分 配 ， 并 且 为 CTE 规 划 节 点 修复 执行 器 的 重新 扫描 逮 辑 (Tom 
Lane) 


这 些 错误 可 以 导致 来 自 扫描 同一 with 子 查询 多 次 的 查询 的 错误 结果 。 


e 当 default_transaction_isolation 设置 为 serializable 的 时 候 ， 修复 错误 操作 (Kevin 
Grittner, Tom Lane, Heikki Linnakangas) 


症状 包含 Windows 启动 过 程 的 死机 ， 以 及 热 各 操作 的 死机 情况 。 
。 提高 涉及 前 级 的 文本 搜索 查询 的 选择 行 估 计 ， 比如 _word …:* 模式 (Tom Lane) 


提高 GiST 素 引 中 页 分 裂 决定 (Alexander Korotkov, Robert Haas, Tom Lane) 
多 列 GiST 索 引 由 于 这 个 错误 可 能 遭受 意外 膨胀 。 
如 果 仍 然 持 有 特权 ， 那 么 修复 终止 的 级 联 权限 撤销 (Tom Lane) 


如 果 我 们 撤销 一 些 角色 x 的 grant 选 项 ， 但 是 x 仍然 认为 该 选项 通过 其 他 人 的 
grant. 我 们 不 应 该 递归 地 撤销 _x_ 授予 的 角色 y 的 相应 特权 。 


不 接受 包含 分 配给 它们 的 模式 的 扩展 (Thom Brown) 
这 种 情况 创建 了 困惑 pg_dump 和 其 他 一 些 事情 的 循环 依赖 。 它 也 邻 人 困惑 ， 因 此 不 接受 


它 。 

提高 热 备份 不 当 配 置 错 误 的 错误 信息 (Gurjeet Singh) 
尝试 configure 探 查 mbstowcs_1 (Tom Lane) 

修复 AIX 一 些 版 本 上 的 编译 错误 。 

当 使 用 PL/Perl 时 ， 修 复 siGFPE 的 处 理 (Andres Freund) 


Perl 重 置 进程 的 srGFPE 义理 器 到 srt6_I6N ， 这 可 能 在 以 后 导致 崩溃 。 在 初始 化 PL/Perl 
之 后 恢复 正常 Postgres 信 号 处 理 程 序 。 


当 被 执行 时 ， 如 果 重 新 定义 递归 的 PL/Perl 函 数 ， 则 防止 PL/Perl 月 溃 (Tom Lane) 
解决 PL/Perl 中 可 能 的 错误 优化 (Tom Lane) 


一 些 Linux 发 布 包含 导致 PL/Perl 中 不 正确 编译 代码 的 pthread.h 不 正确 版 本 ， 如 果 
PL/Perl 函 数 调 用 抛 出 错误 的 另外 一 个 ， 那 么 导致 衣 溃 。 


修复 contrib/pg_trgm 'S LIKE 模式 分 析 代 码 中 的 错误 (Fujii Masao) 

如 果 模 式 包含 Like 转 义 字符 ， 那么 使 用 三 线性 索引 的 Like 查询 可 以 产生 错误 结果 。 
修复 Windows 上 行 尾 的 pg_upgrade 的 处 理 (Andrew Dunstan) 

以 前 ，pg_upgrade 可 能 添加 或 者 删除 运输 返回 比如 轴 数 体 的 地 方 。 


Windows 上 ， 使 得 pg_upgrade 在 它 发 出 的 脚本 中 使 用 反 斜 杠 路 径 分 隔 符 (Andrew 
Dunstan) 


删除 来 自 pg_upgrade 的 pg_config 的 不 必要 依赖 (Peter Eisentraut) 


为 了 Fiji 中 的 DST 变 化 规律 更 新 时 区 数据 文件 到 tzdata 发 布 2012f。 


E.14. & 69.1.5 


发 布 日 期 : 2012-08-17 


这 个 版 本 包含 9.1.4 的 各 种 修复 。 关 于 9.1 主 要 版 本 的 新 功能 的 信息 ， 参阅 Section E.19。 


E.14.1. 迁移 到 唉 本 9.1.5 


为 运行 9.1.X 不 需要 转 储 /恢复 。 
然而 ， 如 果 你 从 9.1.4 的 更 早 版 本 更 新 ， 参阅 9.1.4 的 发 布 说明 。 


E.14.2. %14k 


。 防止 通过 XML 实 体 引 用 访问 外 部 文件 夹 /URL(Noah Misch, Tom Lane) 


xml_parse() 可 以 尝试 读 取 外 部 文件 夹 或 者 URL 作 为 需要 解决 DTD 以 及 XML 值 中 的 实体 
引用 ， 从 而 允许 未 授权 数据 库 用 户 尝试 读 取 和 与 数据 库 服 务 器 权限 的 数据 。 当 外 部 数据 还 
没 直接 返回 给 用 户 时 ， 如 果 数 据 没有 解析 为 有 效 XML， 那 么 它 的 一 部 分 可 能 会 暴露 在 错 
误 信 息 中 ; 并 且 无 论 如 何 检查 文件 是 否 存在 的 能 力 可 能 对 攻击 者 有 用 。 


e 阻止 通过 contrib/xml2 BY xslt_process() 访问 外 部 文件 夹 /URL(Peter Eisentraut) 
libxslt 提 供 通 过 样式 表 命 合 读 写 文 件 夹 和 URL 的 能 力 ， 从 而 允许 未 授权 数据 库 用 户 以 读 写 


带 有 数据 库 服务 器 权限 的 数据 。 禁止 通过 libxslt 的 安全 选项 的 正确 使 用 。(CVE-2012- 
3488) 


Eat, WIR xslt_process() 的 能 力 从 外 部 文件 夹 /URL 中 读 取 文件 和 样式 表 。 当 这 是 已 证 
明 " 特 性 "时 ， 那 么 它 被 长 期 视 为 坏 主 意 。 为 了 CVE-2012-3489 修 复 打 破 该 能 力 ， 而 不 是 
付出 努力 尝试 修复 它 ， 我 们 只 是 打算 简单 地 删除 它 。 


。 防止 btree 索 引 页 过 早 回收 利用 (Noah Misch) 


当 我 们 允许 只 读 事务 略 过 已 分 配 XID 时 ， 当 只 读 事务 仍然 运行 到 它 时 ， 那么 我 们 介绍 已 
删除 btree 页 可 以 被 重新 利用 的 可 能 性 。 这 会 导致 不 正确 索引 搜索 结果 。 在 该 字段 产生 错 
误 的 可 能 性 很 低 ， 因 为 时 间 要 求 ， 但 尽管 如 此 它 应 该 被 修复 。 


。 修复 带 有 新 创造 或 者 重新 设置 序列 的 碰撞 安全 漏洞 (Tom Lane) 


如 果 在 新 创造 或 者 重新 设置 序列 上 执行 acter sequence, 然后 在 它 上 精确 执行 一 
个 nextval() 调用 ， 然后 服务 器 月 沉 了 ，WAL 回 放 可 以 恢复 序列 到 似乎 没有 执 
行 nextval() 的 状态 下 ， 然而 允许 通过 下 一 个 nextval() 调用 再 次 返回 第 一 个 序列 值 。 


特别 是 这 可 以 表现 为 serial 列 ， 因 为 串 行 列 的 序列 的 创建 包含 


ALTER SEQUENCE OWNED BY 步骤 。 

修复 enum 类 型 值 比较 的 竞争 条 件 (Robert Haas, Tom Lane) 

当 遇 到 一 个 被 添加 的 枚 举 值 时 ， 比较 可 能 失败 ， 因为 当前 查询 开始 。 

当 不 再 热 备份 时 ， 修复 txid_current() 以 报告 正确 时 代 (Heikki Linnakangas) 
这 修复 了 上 一 个 次 要 版 本 介绍 的 回 为 。 

防止 不 当 的 复制 连接 选择 作为 同步 各 用 (Fujii Masao) 


主 库 可 能 不 恰当 选择 虚假 服务 器 比如 pg_receivexlog 或 者 pg_basebackup 作为 同步 各 
用 ， 然 后 无 限期 等 待 它们 。 


当主 事务 有 很 多 子 事务 时 ， 修复 热 各 启用 错误 (Andres Freund) 

这 个 错误 导致 故障 报告 为 "无 效 XID 插 入 到 KnownAssignedXids 中 "。 

在 pg_start_backup() 之 后 确保 backup_label 文件 是 fsync (Dave Kerr) 
在 walsender 进 程 中 修复 超时 处 理 (Tom Lane) 


WAL 发 送 后 端 进程 以 建立 SIGALRM 处 理 程序 ， 意味 着 它们 会 永远 等 待 超 时 发 生 的 一 些 情 
况 。 


在 每 个 后 端 通过 walwriter 冲 洗 后 意识 到 walsender (Andres Freund, Simon Riggs) 
当 工作 负载 只 包含 异步 提交 事务 时 ， 这 大 大 减少 了 复制 延迟 。 
修复 LISTEN / NoTIFY 更 好 地 处 理 |/O 问 题 ， 比如 磁盘 空间 不 足 (Tom Lane) 


在 写 入 失败 后 ， 尝 试 发 送 更 多 NoTIFY 消息 的 所 有 子 序列 可 能 带 有 信息 如 "不 能 从 文 
件 "pgnotify/_nnnn " Ræ nnnnn`: 成 功 读 取 " 而 失败 。 


仅仅 允许 autovacuum 通 过 直接 的 封锁 进程 被 自动 取消 (Tom Lane) 


原 代 码 可 能 允许 某 些 情况 下 的 不 一 致 操作 ; 特别 是 ， EDF deadlock_timeout 宽 限 期 后 
可 以 取消 autovacuum。 


改善 autovacuum 取 消 记 录 (Robert Haas) 


修复 日 志 收 集 器 以 致 于 在 服务 器 启动 后 第 一 个 日 志 循 环 期 间 运 


行 log_truncate_on_rotation (Tom Lane) 
修复 with WETERE BERLE ( UNION / INTERSECT / EXCEPT ) (Tom Lane) 
确保 参照 子 查询 的 整 行 不 包含 任何 额外 的 croup BY 或 者 oRDER BY 列 (Tom Lane) 


在 ALTER TABLE ... ADD CONSTRAINT USING INDEX 期 间 修 复 产 生 的 依赖 (Tom Lane) 


这 个 命令 为 索引 留 下 了 多 余 的 pg_depend mM, 可 能 混淆 后 期 操作 ， 尤其 是 索引 列 之 一 


上 的 ALTER TABLE ... ALTER COLUMN TYPE 。 
修复 REASSIGN owNED 以 影响 扩展 (Alvaro Herrera) 
在 CREATE TABLE 期 间 check 约束 和 索引 定义 中 不 允许 拷贝 整 行 引 用 (Tom Lane) 


这 种 情况 可 以 产生 带 有 LIKE 或 者 INHERITS AY CREATE TABLE o 复制 整 列 变量 被 错误 地 
a 类 型 。 为 LIKE 拒绝 理由 似乎 是 合理 的 ， 因为 行 类 型 

能 后 面 会 分 散 。 为 INHERITS 我 们 理论 上 应 该 接受 它 ， 伴随 对 父 表 的 行 类 型 的 隐 含 胁 
; 但 比 起 后 端 补丁 似乎 是 安全 的 需要 更 多 的 工作 。 


修复 ARRAY(SELECT ...) 子 查 询 中 的 内 存 泄露 (Heikki Linnakangas, Tom Lane) 
修复 规划 器 传递 正确 规则 排序 到 操作 符 选 择 性 估计 者 (Tom Lane) 
任何 核心 选择 性 估计 画 数 先前 不 需要 这 个 ， 但 是 第 三 方 代码 可 能 需要 它 。 

从 正则 表达 式 修复 常见 前 缀 提取 (Tom Lane) 


该 代码 被 量化 的 括号 子 表达 式 搞 糊涂 了 ， 上 比如 ^(foo)?bar o 这 将 导致 这 种 模式 不 正确 的 
搜索 索引 优化 。 


修复 interval 常量 中 带 有 分 析 符 号 hh :mm 和 fie 3 iin SS 字段 的 错 


误 (Amit Kapila, Tom Lane) 





修复 pg_dump 以 更 好 义理 包含 部 分 croup BY 列表 的 视图 (Tom Lane) 


视图 在 croup BY 中 只 列 出 一 个 主键 列 ， 但 如 果 他 们 使 用 其 他 表 列 进行 分 组 ， 那 么 根据 主 
键 进行 标记 。 pg_dump 中 这 样 的 主键 依赖 的 恰当 处 理 导 致 差 的 有 序 转 储 ， 这 充其量 是 交 
率 很 低 的 恢复 而 且 在 最 坏 的 情况 可 能 会 导致 一 个 平行 的 pg_restore 运 行 的 彻底 失败 。 


在 PL/Perl 中 ， 当 使 用 SQL _ASCIl 编 码 时 ， 避免 设置 UTF8 标 记 (Alex Hunsaker, Kyotaro 
Horiguchi, Alvaro Herrera) 


当 转 换 Python Unicode 字 符 串 到 PL/Python 中 的 服务 器 编码 时 ， 使 用 Postgres 的 编码 转换 
KA, mA ePythoney. 


这 避免 了 一 些 拐角 情况 问题 ， 值得 注意 的 是 Python 不 支持 所 有 Postgres 编 码 。 一 个 显著 
功能 变化 是 如 果 服 务 器 编码 是 SQL_ASCII， 你 会 得 到 字符 串 UTF-8 表 示 形 式 ; 以 前 ， 字 
符 串 中 任何 非 ASCII 字 符 可 以 导致 错误 。 


修复 PostgreSQL 编 码 映射 到 PL/Python 中 的 Python 编码 (Jan Urbanski) 
适当 报告 contrib/xm1l2 的 xslt_process() 中 的 错误 (Tom Lane) 


为 Morocco 和 Tokelau 中 DST 变 化 规律 更 新 时 区 数据 文件 到 tzdata 发 布 2012e 


E.15. £ 79.1.4 


发 布 日 期 : 2012-06-04 


这 个 发 布 包含 来 自 9.1.3 的 各 种 修复 。 关于 9.1 主 要 版 本 的 新 功能 信息 ， 参阅 Section E.19。 


E.15.1. 迁移 到 版 本 9.1.4 


为 了 运行 9.1.X 不 需要 转 储 / 恢 复 。 


然而 ， 如 果 你 使 用 citext 数据 类 型 ， 并 且 通 过 运行 pg_upgrade 升 级 原先 主 版 本 ， 你 应 该 运 
{T CREATE EXTENSION citext FROM unpackaged 为 了 避免 citext 操作 中 排序 相关 故障 。 如 果 你 
从 包含 citext 数据 类 型 的 实例 中 的 9.1 之 前 数据 库 中 恢复 各 份 ， 那 么 同样 是 必须 的 。 在 更 新 
到 9.1.4 之 前 如 果 你 已 经 运行 CREATE EXTENSION AT, 你 反而 需要 手动 目录 更 新 正如 下 面 第 三 
个 日 志 项 解释 的 。 


另外 ， 如 果 你 从 9.1.2 更 里 版 本 进行 更 新 ， 参阅 9.1.2 发 布 说 明 。 


E.15.2. 变化 


e 修复 contribypgcrypto 的 DES crypt() BAH 不 正确 密码 转换 (Solar Designer) 


如 果 密 码 字 符 串 包含 字 节 值 ox8g ， 那 么 忽略 剩余 的 密码 ， 导致 密码 比 它 出 现 的 更 加 
弱 。 使 用 这 个 修复 ， 剩 余 字 符 串 被 恰当 地 包含 在 DES 哈 希 中 。 受 这 个 错误 影响 的 任何 存 
储 密码 值 将 不 再 匹配 ， 因 此 存储 值 可 能 需要 被 更 新 。(CVE-2012-2143) 


。 为 一 个 程序 语言 的 调用 处 理 程序 忽略 sEcuRITY DEFINER 和 set 属性 (Tom Lane) 
应 用 这 些 属性 到 调用 处理 器 可 以 使 服务 器 崩 涡 (CVE-2012-2655) 


e 党 试 contrib/citext 的 更 新 脚本 修复 citext 数组 的 排序 规则 和 超过 citext 的 域 (Tom 


Lane) 


发 布 9.1.2 为 citext 列 的 排序 规则 和 来 自 9.1 之 前 安装 的 数据 库 更 新 或 者 重 载 中 的 索引 提 
供 修复 。 但 是 这 个 修复 是 不 完整 的 : 它 忽 上 略 处 理 数组 和 citext 上 的 域 。 这 个 发 布 扩展 模 
块 的 更 新 脚本 以 处 理 这 些 情 况 。 如 以 前 ， 如 果 你 已 经 运行 更 新 脚本 ， 你 将 需要 手动 运行 
排序 规则 更 新 命 售 。 参阅 9.1.2 发 布 说 明 获 取 更 多 关于 做 这 个 的 详细 信息 。 


© Sif timestamp 输入 中 数值 时 区 偏 移 量 远离 UTC 达到 16 小 时 (Tom Lane) 


一 些 历 史 时 区 有 大 于 15 小 时 的 偏 移 量 ， 先 前 限制 。 这 可 能 导致 各 份 数据 值 在 重 载 期 间 被 
拒绝 。 


当 给 定时 间 恰 恰 是 当前 时 区 的 最 后 DST 转 变 时 间 时 ， (ES HY fe Bes te E(Tom Lane) 


这 次 跌 忽 已 有 很 长 时 间 ， 但 是 以 前 没有 被 注意 到 ， 因为 假设 大 多 数 DST 时 区 有 未 来 DST 
转换 的 不 明确 的 序列 。 


修复 text 到 name 并 且 char 到 name 投射 以 便 在 多 字 节 编码 中 正确 执行 字符 串 截 断 
(Karl Schnaitter) 


修复 to_tsquery() 中 内 存 找 贝 错误 (Heikki Linnakangas) 
当 在 热 备 中 执行 时 ， 确保 txid_current() 报告 正确 时 期 (Simon Riggs) 
修复 子 查 询 内 PlaceHolderVars 外 的 规划 器 处 理 (Tom Lane) 


这 个 错误 涉及 到 子 SELECT， 它 引用 来 自 周围 查询 的 外 部 连接 的 空 人 出 的 变量 。 在 9.1 中 ， 

这 个 错误 影响 的 查询 可 能 伴随 有 "错误 : 在 不 被 预期 的 地 方 发现 上 层 PlaceHolderVar" 而 失 
Mo 但 是 在 9.0 和 8.4 中 ， 你 可 能 默默 地 获得 可 能 的 错误 结果 ， 因 为 当 需 要 时 ， 传递 到 子 
查询 中 的 值 不 能 定位 到 空 。 


修复 有 不 是 简单 变量 输出 列 的 uNION a 子 查询 计划 (Tom Lane) 


这 种 情况 下 的 规划 在 9.1 中 有 着 明显 恶化 ， 作 为 错误 修正 "MergeAppend 子 目标 列 不 匹配 
MergeAppend" 错 误 的 结果 。 恢复 那个 修复 并 且 以 另 一 种 方式 执行 它 。 


当 pg_attribute 非常 大 时 ， 修复 缓慢 会 话 馈 动 (Tom Lane) 


如 果 pg_attribute 超过 了 shared_buffers 的 四 分 之 一 ， 在 会 话 开 始 时 有 时 需要 缓存 重 
SCO LAR AD ates, 导致 它 采 取 比 正常 更 长 的 时 间 。 如 果 许 多 新 会 话 马 上 开 
始 ， 那 么 问题 是 相当 严重 的 。 


确保 顺序 扫描 合理 地 检查 查询 取消 (Merlin Moncure) 
遇 到 许多 包含 非 活路 元 组 连续 页 的 扫描 不 会 同时 响应 中 断 。 
确保 返回 之 前 PG6SemaphoreLock() 清除 ImmediateInterruptok 的 Windows 实 现 (Tom Lane) 


这 种 下 忽 意味 着 在 同一 个 查询 中 后 来 收 到 的 查询 取消 中 断 可 能 在 不 安全 时 间 被 接受 ， 伴 
随 着 不 可 预知 的 但 不 好 的 结果 。 


当 输 出 视图 或 者 规则 时 ， 安 全 显示 整 行 变 量 (Abbas Butt, Tom Lane) 

涉及 层 义 名 字 ( 也 就 是 说 ， 该 名 字 可 以 是 一 个 表 或 者 查询 的 列 名 ) 的 情况 被 以 模糊 方式 输 
H, 冒险 转 储 和 重 载 之 后 不 同 地 解释 视图 或 者 规则 。 通过 附加 无 操作 计算 避免 模 凌 两 可 
的 情况 。 

修复 copy From 以 正确 处 理 与 无 效 编码 一 致 的 空 标记 字符 串 (Tom Lane) 


一 个 空 标记 字符 串 比 如 eoo 应 该 工作 ， 并 且 工 作 于 过 去 ， 但 是 这 种 情况 在 8.4 中 被 打 
破 。 


修复 EXPLAIN VERBOSE 为 可 写 CTE 包 含 RETURNING 子 句 (Tom Lane) 
在 咨询 锁 存 在 下 修复 PREPARE TRANSACTION 以 正常 工作 (Tom Lane) 


从 历史 看 ， PREPARE TRANSACTION 简单 忽略 了 任何 会 话 持 有 的 会 话 级 别 咨询 锁 ， 但 是 这 种 
情况 在 9.1 中 被 意外 损坏 。 


修复 未 记录 表 的 截断 (Robert Haas) 
在 search_path 的 非 交 互 式 分 配 中 忽略 缺失 模式 (Tom Lane) 


这 重新 排列 带 有 旧 分 支 的 9.1 的 操作 。 先 前 9.1 可 能 为 从 某 地 比如 ALTER DATABASE SET 中 
获得 的 search_path 设置 中 提 及 的 不 存在 的 模式 而 抛 出 错误 。 


修复 用 于 扩展 脚本 的 临时 或 者 短暂 表 的 错误 (Tom Lane) 


这 个 包含 比如 在 扩展 更 新 脚本 中 重 写 acter TABLE 的 情况 ， 因为 在 该 场景 后 使 用 临时 
Ro 


确保 autovacuum 工 作 进程 恰当 执行 堆栈 深度 检查 (Heikki Linnakangas) 

先前 ， 通 过 自动 ANALYzE 调用 的 无 限 递 轨 函 数 可 以 使 工作 进程 崩溃。 

修复 日 志 收 集 器 在 高 负载 下 没有 和 寺 失 日 志 一 致 性 (Andrew Dunstan) 

如 果 它 太 忙 ， 那 么 收集 器 先前 可 能 重新 收集 大 的 信息 失败 。 

修复 日 志 收 集 器 以 确保 它 在 接收 SIGHUP 之 后 重启 文件 旋转 (Tom Lane) 

修复 GiST 素 引 中 " 太 多 LWLocks 采 取 " 错 误 (Heikki Linnakangas) 

如 果 索 引 随 后 被 删除 ， 那 么 修复 GIN 索 引 WAL 重 放 逻 辑 而 不 失败 (Tom Lane) 
正确 检测 月 江 后 预备 事务 的 SSIl 冲 突 (Dan Ports) 

当 提 交 一 个 仅仅 修改 临时 表 的 事务 时 ， 避 兔 同步 复制 延迟 (Heikki Linnakangas) 


在 这 种 情况 下 事务 的 提交 记录 不 需要 冲刷 到 备用 服务 器 ， 但 是 一 些 代码 并 不 知道 等 待 它 
发 生 。 


修复 pg_basebackup 中 的 错误 处 理 (Thomas Ogrisegg, Fujii Masao) 

如 果 连 接 中 断 ， 那么 修复 walsender 不 进入 一 个 繁忙 循环 中 (Fujii Masao) 

修复 PL/pgSQL 的 RETURN NEXT 命令 中 的 内 存 泄露 (Joe Conway) 

当 目 标 是 函数 的 第 一 个 变量 时 ， 那 么 修复 PL/pgSQL 的 cet pracnostics 命令 (Tom Lane) 
确保 PL/Perl 包 具有 _Tp 变量 (Alex Hunsaker) 


当 它 们 被 藤 套 在 改变 当前 包 的 函数 调用 中 时 ， 这 个 错误 导致 触发 器 调用 失败 。 


BAROR A X% AYPL/Python HEX LAF S RAEE (Jan Urbanski) 

这 种 情况 通过 9.1 附 加 到 允许 提供 其 他 格式 的 复合 结果 值 而 被 意外 的 打 断 ， 比 如 词典 。 

在 psql 的 可 扩展 显示 ( \x ) 模 式 中 修复 内 存 结尾 潜在 访问 (Peter Eisentraut) 

当 数 据 库 包 含 许多 对 象 时 ， 那 么 修复 pg_dump 中 的 一 些 性 能 问题 (Jeff Janes, Tom Lane) 


如 果 数 据 库 包含 许多 视图 ， 或 者 如 果 许 多 对 象 在 依赖 循环 中 ， 或 者 如 果 有 许多 拥有 的 序 
列 ， 那 么 pg_dump 可 能 会 很 慢 。 


当 读 取 目 录 格 式 妇 档 时 ， 修 复 内 存 和 pg _restore 中 的 文件 描述 符 泄露 (Peter Eisentraut) 


为 数据 库存 储 在 集群 中 的 缺 省 表 空 间 中 包含 表 的 非 默认 胡 空 间 的 情况 而 修复 
pg_upgrade(Bruce Momjian) 


在 ecpg 中 ， 修 复 罕 见 内 存 泄露 并 且 sqicat 结构 后 可 能 覆盖 一 个 字 节 (Peter Eisentraut) 
修复 contrib/dblink 的 dblink_exec() 不 泄露 临时 数据 库 连 接 错误 (Tom Lane) 
修复 contrib/dblink LA 报告 错误 消息 中 正确 连接 名 (Kyotaro Horiguchi) 


当 删 除 多 个 大 对 象 的 时 候 ， 修复 contrib/vacuumlo 以 使 用 多 个 事务 (Tim Lewis, Robert 
Haas, Tom Lane) 


当 多 个 对 象 需要 被 删除 的 时 候 ， 这 个 改变 避免 超过 max_locks_per_transaction o 该 操作 
可 以 被 调整 为 具有 新 的 -1 (限制 ) 选 项 。 


为 了 在 Antarctica, Armenia, Chile, Cuba, Falkland Islands, Gaza, Haiti, Hebron, 
Morocco, Syria 和 Tokelau lslands 中 DST 变 化 规律 更 新 时 区 数据 文件 到 tzdata 发 布 
2012c ; 同时 为 Canada 万 史 修 正 。 


E.16. £ 79.1.3 


发 布 日 期 : 2012-02-27 


该 发 布 包含 了 9.1.2 的 各 种 修复 。 为 了 9.1 主 要 版 本 的 新 功能 的 更 多 信息 ， 参阅 Section E.19。 


E.16.1. 迁移 到 版 本 9.1.3 


为 运行 9.1.X 不 需要 转 储 /恢复 。 


然而 ， 如 果 你 从 9.1.2 的 更 早 版 本 更 新 ， 请 参阅 9.1.2 的 发 布 说 明 。 


E.16.2. %41k 


需要 为 CREATE TRIGGER 触发 器 函数 上 的 执行 权限 (Robert Haas) 


这 个 丢失 检查 可 能 允许 其 他 用 户 执 行 带 有 伪造 输入 数据 的 触发 器 玉 数 ， 通过 安装 它 到 它 
拥有 的 表 上 。 对 于 触发 器 函数 标记 SECURITY DEFINER 是 唯一 重要 的 ， 因为 否则 触发 器 萎 
数 运行 为 表 所 有 者 。(CVE-2012-0866) 


删除 SSL 证 书 中 常见 名 称 长 度 的 任意 限制 (Heikki Linnakangas) 


libpq 和 服务 器 截断 从 32 字 节 SSL 证 书 中 提取 的 通用 名 。 这 通常 会 导致 没有 什么 比 一 个 意 
想不到 的 验证 失败 更 精 糕 的 ， 但 是 有 一 些 令 人 难以 置信 的 情况 ， 它 可 能 允许 一 个 证 书 持 
有 者 模仿 另外 一 个 。 该 受害 者 必须 有 32 字 节 长 的 通用 名 。 并 且 攻 击 者 必须 说 服 可 信任 CA 
发 布 证 书 ， 其 中 通用 名 有 字符 串 作为 前 级 。 伪装 服务 器 也 需要 一 些 额 外 的 开发 重 定向 客 
户 端 连接 。(CVE-2012-0867) 


在 名 字 写 入 pg_dump 说 明 中 转换 新 行 到 空白 (Robert Haas) 


pg_dump 关 于 审查 输出 脚本 中 SQL 注 释 发 出 的 对 象 名 是 不 庶 愤 的 。 包含 换行 符 的 名 字 至 
少 使 得 脚本 语法 上 不 正确 。 当 肢 本 被 重新 加 载 时 ， 悉 意 制作 对 象 名 可 能 出 现 SQL 注 射 风 
险 。(CVE-2012-0868) 


修复 来 自 并 行 清理 插入 的 btree 索 引 崩 江 (Tom Lane) 


通过 插入 引起 的 索引 页 分 裂 有 时 可 以 导致 同时 运行 vacuum 而 错过 删除 本 应 该 删除 的 索引 
项 。 相 应 表 行 被 删除 后 ， 该 悬挂 索引 项 可 能 导致 错误 〈 比 如 "不 能 读 取 文 件 中 块 N.…") 或 
AEM, 无 关 行 后 默默 的 错误 查询 结果 被 重新 插入 到 当前 自由 表 位 置 。 这 个 错误 自从 发 
布 8.2 就 出 现 了 ， 但 是 发 生 如 此 罕见 以 致 它 没有 被 诊断 直到 现在 。 如 果 你 有 理由 怀疑 它 
已 经 在 你 的 数据 库 中 发 生 ， 那么 重新 索引 受 影响 索引 将 修复 这 问题 。 


修复 WAL 回 放 期 间 共 享 缓冲 区 临时 调 需 (Tom Lane) 


重 放 逻辑 有 时 为 需 并 且 重 填 共 享 缓冲 区 ， 因 此 内 容 肯 时 无 效 。 在 热 各 模式 中 这 可 以 导致 
正在 并 行 执 行 的 查询 看 到 垃圾 数据 。 可 能 导致 不 同 症状 ， 但 是 最 常见 的 是 "无 效 内 存 分 配 
请 求 大 小 "。 


修复 READ COMMITTED 复查 中 数据 修改 with 子 计划 处 理 (Tom Lane) 


如 果 父 UPDATE 或 者 DELETE 命令 需要 被 重新 评估 一 行 或 多 行 ， 由 于 read COMMITTED 模式 
中 并 发 更 新 ， 那 么 包含 INSERT / UPDATE / DELETE 的 with 子 句 可 能 崩溃 。 


修复 SS 事务 清理 中 困境 情况 (Dan Ports) 


当 结 束 一 个 读 写 串 行 化 事务 时 ， 如 果 所 有 剩余 的 活路 的 可 串 行 化 事务 是 只 读 的 ， 那 么 可 
能 产生 月 渍 。 


在 热 各 份 崩溃 后 修复 postmaster 以 党 试 重启 (Tom Lane) 


当 在 热 各 模式 中 进行 操作 时 如 果 任 何 后 端 进 程 骨 溃 ， 那 么 逻辑 错误 导致 postmaster 终 
止 ， 而 不 是 尝试 重启 集群 。 


修复 通过 最 新 更 新 行 拥有 的 toast 值 的 cLusTER / vacuum FULL 的 义理 (Tom Lane) 


这 种 踊 忽 可 能 导致 "重复 关键 值 违背 了 唯一 约束 "错误 被 报告 给 这 些 命令 之 一 中 的 toast 表 的 
索引 。 


当 改 变 表 所 有 者 时 ， 更 新 每 列 权 限 ， 不 仅仅 每 个 表 权 限 (Tom Lane) 


不 这 样 做 就 意味 着 任何 先前 已 授权 列 权 限 仍然 显示 为 已 被 旧 的 所 有 者 授权 。 这 意味 着 既 
不 是 新 所 有 者 也 不 是 超级 用 户 可 以 撤销 目前 难以 寻找 的 到 表 所 有 者 权限 。 


支持 外 数据 封装 和 REASSIGN owNED 中 的 外 服务 器 (Alvaro Herrera) 
如 果 它 需要 改变 任何 对 象 的 所 有 权 ， 那么 该 命令 伴随 "意外 数字 "错误 失败 。 
人 允许 ALTER USER/DATABASE SET 中 一 些 设 置 的 不 存在 值 (Heikki Linnakangas) 


Rit default_text_search_config , default_tablespace 和 temp_tablespaces 被 设置 为 
不 知道 的 名 字 。 这 是 因为 它们 可 能 在 另 一 个 数据 库 中 已 知 ， 该 设置 打算 使 用 的 地 方 ， 或 
者 为 了 表 空 间 情 况 因 为 表 空 间 可 能 不 会 被 创建 。 同样 问题 是 先前 已 确认 

为 search_path ， 并 且 这 些 设置 像 那 一 个 。 


修复 INsERT 表达 式 中 通过 coLLATE 产生 的 "不 支持 节点 类 型 "错误 (Tom Lane) 
当 我 们 删除 后 提交 表 文 件 有 问题 时 ， 避 人 免 月 渍 (Tom Lane) 


删除 表 导 致 事务 提交 之 后 删除 底层 磁盘 文件 。 在 失败 的 情况 中 〈 比 如 ， 由 于 错误 文件 权 
限 ) 那么 该 代码 应 该 发 出 警告 信息 并 且 继续 ， 因为 它 太 晚 了 而 终止 了 事务 。 这 个 逻辑 已 
作为 发 布 8.4 被 打破 ， 导致 这 种 情况 引起 PANIC 和 不 可 重新 启动 的 数据 库 。 


在 prop TABLESPACE 的 WAL 回 放 期 间 从 发 生 的 错误 中 恢复 (Tom Lane) 


重播 将 党 试 删 除 该 表 空 间 目 录 ， 但 是 可 能 会 失败 的 原因 是 多 方面 的 (例如 ， 这 些 目录 上 
不 正确 的 所 有 权 和 权限 ) 。 以 前 该 重播 代码 会 恐慌 ， 导致 数据 库 没 有 手册 干预 不 能 重新 
启动 。 似乎 记录 问题 并 且 继 续 是 更 好 的 ， 因 为 删除 该 目录 失败 的 唯一 结果 是 一 些 浪 费 的 
磁盘 空间 。 


修复 为 热 备 在 记录 AccessExclusiveLocks 中 的 竞争 条 件 (Simon Riggs) 


有 时 锁 可 能 被 记录 为 通过 "事务 需 " 持 有 。 这 对 于 从 服务 器 上 产生 断言 失败 至 少 是 已 知 
的 ， 并 且 可 能 是 更 严重 问题 的 原因 。 


在 WAL 回 放 期 间 正 确 跟踪 OID 计 数 器 ， 即 使 当 它 包围 周围 (Tom Lane) 


先前 OID 计 数 器 可 以 保持 在 较 高 的 值 上 直到 系统 退出 回放 模式 。 实际 结果 通常 为 雳 ， 但 
是 存在 这 样 一 种 情况 ， 各 用 服务 器 提升 到 主 服 务 器 可 能 需要 很 长 时 间 增加 OID 计 数 器 到 
一 个 合理 值 ， 一 旦 该 值 是 必须 的 。 


在 月 溃 恢 复 开始 时 阻止 发 出 误导 性 的 "一 致 的 恢复 状态 到 达 " 日 志 信息 (Heikki 
Linnakangas) 


修复 pg_stat_replication . replay_location 的 初始 值 (Fujii Masao) 
以 前 ， 显 示 的 值 可 能 是 错误 的 直到 至 少 一 个 WAL 记 录 已 被 回放 。 
修复 带 有 * 附属 的 正则 表达 式 逆 向 引用 (Tom Lane) 


而 不 是 执行 一 个 确切 的 字符 串 匹 配 ， 该 代码 有 效 地 接受 任何 满足 模式 子 表达 式 引用 逆向 
引用 符号 的 字符 串 。 


类 似 问 题 仍 然 困 扰 着 被 族人 到 大 的 量化 表达 式 中 的 逆向 引用 ， 而 不 是 量词 的 直接 主题 。 
这 将 在 未 来 PostgreSQL 发 布 中 得 以 解决 。 


修复 inet / cidr 值 处 理 中 最 新 引进 的 内 存 泄露 (Heikki Linnakangas) 


PostgreSQL 的 2011 年 12 月 份 发 布 的 补丁 导致 了 这 些 操作 中 内 存 泄露 ， 这 可 能 是 重要 情 
况 比 如 在 这 样 的 列 上 编译 btree 索 引 。 


修复 规划 器 的 能 力 通过 UNIoN ALL 推动 索引 表达 式 限 制 (Tom Lane) 
优化 这 种 类 型 通过 9.1.2 中 另 一 个 问题 修复 被 无 意识 禁用 。 
修复 引用 继承 表 上 UPDATE / DELETE 中 的 with 子 句 规划 (Tom Lane) 
这 个 错误 导致 "不 能 找到 CTE 规 划 " 错 误 。 

修复 GIN 估 计 成 本 以 处 理 column IN (...) 索引 条 件 (Marti Raudsepp) 


如 果 这 一 条 件 与 GIN 索 引 一 起 使 用 ， 那 么 这 种 疏忽 通常 导致 崩溃 。 


当 退 出 打开 的 失败 事务 会 话 ， 防 止 断言 失败 (Tom Lane) 

这 个 错误 对 正常 编译 未 启用 断言 没有 影响 。 

(ESSQLI8S WAH CREATE TABLE AS / SELECT INTO 之 后 的 悬挂 指针 (Tom Lane) 
在 大 多 数 情况 中 这 导致 断言 启用 编译 中 断言 失败 ， 但 是 更 糟 结果 是 可 能 的 。 

避免 Windows 上 syslogger 中 文件 句柄 的 双关 闭 (MauMau) 

通常 这 个 错误 是 无 形 的 ， 但 是 当 在 Windows 的 调试 版 本 上 运行 时 ， 它 可 能 导致 异常 。 
修复 plpgsql 中 I/O 转 换 关系 内 存 泄露 (Andres Freund, Jan Urbanski, Tom Lane) 

某 些 操作 可 能 泄露 内 存 直 到 当前 函数 结束 。 

解决 perl| 的 SvPVutf8() 函 数 中 的 错误 (Andrew Dunstan) 


当 操作 的 typeglob 或 者 某 个 只 读 对 象 比 如 sav 时 ， 该 本 数 崩溃 。 使 得 plperl 避 免 传 递 这 些 
给 它 。 


在 pg_dump 中 ， 如 果 扩 展 本 身 没 有 被 各 份 ， 那么 不 备份 扩展 的 配置 表 的 内 容 (Tom Lane) 
提升 继承 表 列 的 pg_dump 的 处 理 (Tom Lane) 


pg_dump 你 理 不 当 的 情况 下 ， 一 个 子 列 比 它 的 父 列 有 不 同 的 缺 省 表达 式 。 如 果 缺 省 文本 
上 和 与 父 类 的 缺 省 是 相同 的 ， 但 不 是 真 的 相同 (例如 ， 由 于 模式 搜索 路 径 的 差异 ) 不 会 被 
认为 是 不 同 的 ， 所 以 在 转 储 和 恢复 后 子 类 可 以 被 允许 继承 父 的 缺 省 。 在 它们 的 父 类 不 能 
微妙 地 错误 地 被 恢复 的 地 方 子 列 非 空 。 


为 了 INSERT 形 式 表 数 据 修复 pg_restore 的 直接 到 数据 库 模式 (Tom Lane) 


当 使 用 发 布 日 期 2011 年 九 月 或 者 十 二 月 的 pg_restore 的 时 候 ， 从 归档 文件 中 恢复 直接 到 
数据 库 伴随 --inserts 或 者 --column-inserts 选项 而 失败 ， 作为 另外 一 个 问题 修复 的 跪 
忽 结果 。 兴 档 文件 本 身 没有 错 ， 而 且 文本 模式 输出 是 好 的 。 


pg_upgrade X 2plpython 的 共享 库 的 重 命名 (Bruce Momjian) 

更 新 包含 plpython 的 9.1 之 前 数据 库 可 能 失败 ， 因 为 这 种 玻 忽 。 

允许 pg_upgrade 钦 理 包 含 regclass 列 的 表 (Bruce Momjian) 

因为 pg_upgrade 现 在 负责 保存 pg_class OID, 这 一 限制 没有 任何 理由 。 

当 正 在 寻找 SSL 客 户 端 证 书 文件 时 ， 使 得 libpq 忽 略 ENoTDIR 错误 (Magnus Hagander) 


这 人 允许 建立 SSL 连 接 ， 哩 然 没 有 证 书 ， 即使 当 用 户 的 家 目录 被 设置 为 像 /dev/null HE 


修复 ecpg 的 SQLDA 区 域 中 一 些 字 段 对 齐 问 题 (Zoltan Boszormenyi) 


在 ecpg DEALLOCATE 语句 中 人 允许 AT 选项 (Michael Meskes) 

支持 这 个 的 基础 设施 已 有 一 段 时 间 了 ， 但 由 于 玻 忽 仍然 有 拒绝 这 种 情况 的 错误 检查 。 
当 在 ecpg 中 定义 varchar 结 构 时 ， 不 要 使 用 变量 名 (Michael Meskes) 

修复 contrib/auto_explain 的 JSON 模 式 以 产生 有 效 的 JSON(Andrew Dunstan) 

当 它 使 用 花 括 号 时 ， 该 输出 使 用 顶层 方 括号 。 

修复 contrib/intarray BY int[] &int[] 操作 符 中 的 错误 (Guillaume Lelarge) 


如 果 最 小 整数 的 两 个 输入 数组 中 常见 的 是 1， 并 且 在 其 中 之 一 数组 中 有 较 小 的 值 ， 然 后 将 
1 从 结果 中 错误 地 省 略 。 


修复 contrib/pgcrypto BY encrypt_iv() 和 decrypt_iv() 中 的 错误 检查 (Marko Kreen) 


这 些 事 数 没有 成 功 报告 无 效 输入 错误 的 某 些 类 型 ， 并 且 反而 为 不 正确 输入 返回 随机 垃圾 
值 。 


修复 contrip/test_parser 中 一 字 节 缓冲 区 超出 范围 (Paul Guyot) 


该 代码 将 尝试 读 取 比 它 应 该 的 又 一 个 字 节 ， 这 将 在 困境 情况 下 月 溃 。 
为 contrib/test_parser 只 是 示例 代码 ， 这 本 身 不 是 一 个 安全 问题 ， 但 不 好 的 例子 代码 仍 


如 果 可 用 ， 那 么 在 ARM 上 为 spinlocks 使 用 _ sync_lock_test_and_set() (Martin Pitt) 





这 个 图 数 替 换 swe 指使 先 前 用 法 ， 它 已 经 废弃 并 且 在 ARMv6 和 之 后 的 不 可 用 。 报告 建 
议 该 旧 代 码 在 最 新 ARM 上 以 显著 方式 使 用 ， 但 是 不 能 简单 地 连锁 并 发 访问 ， 导 致 多 进程 
操作 中 的 离奇 失败 。 


当 编 译 接受 它 的 gcc 版 本 时 ， 使 用 -fexcess-precision=standard 选项 (Andrew Dunstan) 
这 阻止 各 种 各 样 的 情节 ， 其 中 gcc 最 新 版 本 将 产生 创造 性 结果 。 
允许 FreeBSD 上 线程 Python 的 使 用 (Chris Rees) 


我 们 配置 脚本 先前 认为 这 种 组 合 不 会 允许 ; 但 是 FreeBSD 修 复 该 问题 ， 因此 删除 错误 检 
查 。 


允许 MinGW 建 立 使 用 标准 命名 OpenSSL 库 (Tomasz Ostrowski) 


E.17. £ 79.1.2 


发 布 日 期 : 2011-12-05 


该 发 布 包含 来 自 9.1.1 的 各 种 修复 。 关 于 9.1 主 要 版 本 新 功能 的 信息 ， 参阅 Section E.19。 


E.17.1. 迁移 到 版 本 9.1.2 


为 运行 9.1.X 不 需要 转 储 /恢复 。 


然而 ， 在 information_schema.referential_constraints 视图 的 定义 中 发 现 了 一 个 长 期 错误 。 
如 果 你 依赖 该 视图 的 正确 结果 ， 那 么 你 应 该 像 下 面 第 一 个 更 新 记录 项 解释 的 替换 它 的 定义 。 


另外 ， 如 果 你 使 用 citext 数据 类 型 ， 并 且 你 通过 运行 pg_upgrade 从 以 前 的 主要 版 本 升级 ， 
你 应 该 运行 CREATE EXTENSION citext FROM unpackaged 以 避免 citext 操作 中 排序 规则 相关 的 
252, 如 果 你 从 包含 citext 数据 类 型 实例 的 9.1 之 前 数据 库 恢复 转 储 ， 那 么 同样 是 必要 的 。 
如 果 在 升级 到 9.1.2 之 前 你 已 经 运行 CREATE EXTENSION 命令 ， 你 将 不 需要 做 手动 更 新 目录 ， E 
如 第 二 个 记录 项 解释 的 那样 。 


E.17.2. 变化 


e 修复 information_schema.referential_constraints 视图 中 错误 (Tom Lane) 


该 视图 对 于 匹配 依赖 主键 的 外 键 约束 或 者 唯一 性 约束 不 够 仔细 。 这 可 能 导致 显示 所 有 外 
键 约束 的 错误 ， 或 者 显示 多 次 ， 或 者 声明 它 取 决 于 比 确实 存在 的 不 同 约束 。 


因为 该 视图 定义 是 通过 initdb 安 装 的 ， 只 是 升级 不 会 修复 该 问题 。 如 果 你 需要 在 现 有 的 安 
装 中 修复 这 个 问题 ， 你 可 以 (作为 一 个 超级 用 户 ) 删除 information_schema 模式 ， 然 后 
通过 _sHAREDIR_ /informationschema. sql 重新 创建 它 。 (如 果 你 不 确定 

”SHAREDIJR 在 哪里 ,运行 pg_config --sharedir) 必须 在 被 修复 的 每 个 数据 库 中 重复 。 


e 使 得 contrib/citext 的 更 新 脚本 修复 citext 列 和 索引 的 排序 规则 (Tom Lane) 


现 有 的 citext 列 和 索引 不 能 正确 标记 为 在 pg_upgrade 中 来 自 9.1 之 前 服务 器 的 
collatable 数 据 类 型 ， 或 者 当 包含 citext 类 型 的 9.1 之 前 备份 被 加 载 到 9.1 服 务 器 时 。 这 
导致 这 些 列 上 的 操作 有 错误 而 失败 ， 比如 "不 能 决定 为 字符 串 比 较 使 用 哪个 排序 规则 "。 
这 种 变化 可 以 通过 在 CREATE EXTENSION citext FROM unpackaged 中 升级 citext 模块 到 一 
个 适当 的 9.1 扩 展 的 相同 脚本 进行 修复 。 


如 果 你 有 直到 这 个 问题 的 以 前 升级 数据 库 ， 而 且 你 已 经 运行 CREATE EXTENSION, 你 可 以 
手动 运行 (作为 超级 用 户 ) 在 _sHAREDIR /extension/citext--unpackaged--1.0.sql 结尾 发 
SLAY UPDATE 命令 。 【如 果 你 不 确定 _sHAREDIR_ 在 哪 ， 那 么 运 

{T pg_config --sharedir 。) 如 果 不 确定 再 次 这 样 做 是 没有 害处 的 。 


修复 uppate 或 者 bELETE MAB SIREN PAL FREAK (Tom Lane) 
MRAM, AAWRR EAR, Alt 这 个 问题 间歇 性 地 出 现 。 
修复 GIN 索 引 更 新 WAL 记 录 的 错误 回放 (Tom Lane) 


这 可 能 导致 在 崩溃 后 或 者 热 备 服务 器 上 暂时 无 法 找到 索引 项 ， 然而 ， 该 问题 可 以 通过 索 
引 的 下 一 个 vacuum 被 修复 。 


修复 CREATE TABLE dest AS SELECT * FROM src 或 
者 INSERT INTO dest SELECT * FROM src 期 间 TOAST 相 关 数 据 损坏 (Tom Lane) 


如 果 表 通过 ALTER TABLE ADD COLUMN 被 修改 ， 那么 党 试 逐 字 拷贝 它 的 数据 到 另 一 个 表 在 
某 些 困境 情况 下 可 以 产生 朋 溃 结果 。 该 问题 表现 在 8.4 以 及 之 后 版 本 的 精确 形式 中 ， 但 
是 我 们 补丁 早期 版 本 以 及 有 其 他 编码 路 径 下 可 以 触发 相同 错误 。 


修复 热 各 启动 中 可 能 错误 (Simon Riggs) 
当初 始 快照 不 完整 时 ， 更 快 和 启动 热 各 (Simon Riggs) 
修复 toast 表 访问 陈旧 syscache 项 中 的 竞争 条 件 (Tom Lane) 


典型 症状 是 短暂 错误 像 "为 pg_toast 2619 中 toast 值 NNNNN 丢 失 块 号 0"， 其 中 引用 的 
toast 表 总 是 从 属于 一 个 系统 目录 。 


跟踪 用 于 参数 缺 省 表达 式 玉 数 依赖 (Tom Lane) 


以 前 ， 被 引用 的 对 象 没有 删除 或 者 修改 函数 而 被 删除 ， 当 使 用 该 函数 时 ， 导 致 错误 操 
作 。 请 注意 ， 仅 仅 安装 此 更 新 将 不 能 修复 丢失 依赖 项 ; 这 样 ， 你 之 后 需 

要 CREATE OR REPLACE 每 个 画 数 。 如 果 你 有 缺 省 依赖 非 内 置 对 象 的 函数 ， 这 样 做 是 值得 推 
荐 的 。 


修复 nestloop 连 接 中 占 位 符 变 量 的 错误 管理 (Tom Lane) 


个 错误 已 知 的 导致 "在 子 计 划 目 标 列 中 没有 找到 变量 "规划 器 错误 ， 并 且 当 涉及 到 外 部 
可 能 导致 错误 查询 输出 。 


1S Sb RRR IA TUBER window 2X(Tom Lane) 
以 前 这 些 可 能 伴随 "没有 找到 pathkey 项 排序 "规划 器 错误 而 失败 。 
修复 "MergeAppend 子 目录 列 不 匹配 MergeAppend" 规 划 器 错误 (Tom Lane) 


修复 collatable 和 noncollatable 输 入 索引 匹配 操作 符 (Tom Lane) 


在 9.1.0 中 ， 可 索引 操作 符 具 有 非 collatable 左 边 输入 类 型 和 collatable 右 边 输 入 类 型 不 会 
被 公认 为 匹配 左边 列 的 索引 。 例子 是 hstore ? text VERT 


人 允许 有 多 个 OUT 参 数 的 设置 返回 SQL 汞 数 的 内 联 (Tom Lane) 
不 能 信任 连接 删除 的 延缓 唯一 索引 (Tom Lane 和 Marti Raudsepp) 
延迟 唯一 性 约束 可 能 不 会 持 有 内 部 事务 ， 因此 假设 它 可 以 给 定 错误 的 查询 结果 。 


使 得 patumGetInetP() 解压 有 1 字 节 头 的 inet 数 据 ， 并 且 添 加 一 个 新 宏 ， 
DatumGetInetPP() 确实 没有 (Heikki Linnakangas) 


这 个 变化 不 影响 核心 代码 ， 但 是 可 能 阻止 希望 patumGetInetP() 按 惯例 产生 解压 数据 的 附 
DO 23 AB 


提高 money 类 型 的 输入 和 输出 的 区 域 支 持 (Tom Lane) 


除了 不 支持 所 有 标准 的 1c_monetary 格式 选项 ， 输 入 和 输出 函数 是 一 致 的 ， 意味 着 有 区 
域 各 份 money 值 不 能 被 重读 。 


不 要 让 transform null equals 影响 CASE foo WHEN NULL ... 结构 (Heikki Linnakangas) 


transform_null_equals 只 会 影响 直接 由 用 户 编写 的 foo = NULL 表达 式 ， 通过 CASE 这 


种 形式 内 部 产生 的 不 平等 检查 。 
改变 外 键 触发 器 创建 顺序 更 好 地 支持 自我 参照 外 键 (Tom Lane) 


一 个 级 联 外 键 引用 它 自己 的 表 ， 行 更 新 将 触发 oN UPDATE 触发 器 和 作为 一 个 事件 

的 CHECK o ON UPDATE 触发 器 必须 首先 执行 ， 否 则 cHEck 将 检查 该 行 的 非 最 终 状 态 并 
可 能 抛 出 一 个 不 合适 错误 。 然而 ， 这 些 触发 器 的 触发 顺序 是 由 自己 名 字 决 定 的 ， 其 中 

通常 按照 创建 顺序 排序 ， 因 为 触发 器 按照 惯例 "RI_ConstraintTrigger_NNNN" 有 自动 生 

成 的 名 字 。 一 个 适当 的 修复 将 需要 修改 该 惯例 ， 我 们 会 在 9.2 中 执行 ， 但 在 现 有 的 版 本 

中 改变 它 似 乎 有 风险 。 所 以 这 个 补丁 只 改变 触发 器 的 创建 顺序 。 用 户 遇 到 此 类 型 的 错误 

要 删除 并 重新 创建 外 键 约 束 使 得 它 的 触发 器 进入 正确 的 顺序 。 


修复 DROP OPERATOR FAMILY 中 IF EXISTS 正常 运行 (Robert Haas) 
不 人 允许 来 自 自己 脚本 中 扩展 的 删除 (Tom Lane) 

这 阻止 了 在 扩展 依赖 的 错误 管理 下 的 古怪 操作 。 
不 要 标记 自动 生成 类 型 为 扩展 成 员 (Robert Haas) 


关系 行 类 型 以 及 自动 生成 的 数组 类 型 不 需要 pg_depend 中 自己 的 扩展 成 员 项 ， 并 且 创 建 
这 样 的 项 使 得 扩展 更 新 复杂 化 。 


在 CREATE EXTENSION 中 处 理 无 效 的 早已 存在 的 search_path 设置 (Tom Lane) 


当 跟 踪 缓 冲 区 分 配 率 时 ， 避 免 浮 点 下 浴 (Greg Matthews) 


当 对 自身 无 害 时 ， 在 某 些 平台 上 这 可 能 导致 讨厌 的 内 核 日 志 信息 。 
防止 可 串 行 化 模式 下 运行 的 自动 清理 事务 (Tom Lane) 


以 前 自动 清理 使 用 集群 端 缺 省 事务 隔离 级 别 ， 但 是 没有 必要 使 用 高 于 READ 
COMMITTED 的 任何 未 西 ， 并 且 使 用 SERIALIZABLE 可 以 导致 其 他 进程 的 不 必要 延迟 。 


确保 walsender 进 程 迅速 反应 给 SIGTERM(Magnus Hagander) 

从 基础 各 份 中 排除 postmaster.opts (Magnus Hagander) 

当 在 Windows 下 启动 子 进 程 时 ， 保 留 配 置 文件 名 字 和 行 号 值 (Tom Lane) 
以 前 ， 这 些 在 pg_settings 视图 中 不 能 被 正确 显示 。 

修复 ecpg 的 SQLDA 区 域 中 不 正确 字段 对 齐 (Zoltan Boszormenyi) 

保留 psql 的 命令 历史 中 该 命令 中 的 空白 行 (Robert Haas) 

如 果 从 字符 串 中 删除 空 行 ， 前 者 操作 可 能 产生 问题 ， 比 如 。 

避免 pg_dump 中 特定 平台 无 限 循环 (Steve Singer) 

修复 pg_dump 中 纯 文本 输出 格式 的 压缩 (Adrian Klaver 和 Tom Lane) 


pg_dump 从 历史 角度 理解 没有 -F 切换 的 -z ， 这 意味 着 它 应 该 发 出 纯 文 本 输出 的 gzip 压 
缩 版 本 。 恢 复 该 行为 。 


修复 pg_dump 以 备份 自动 生成 类 型 之 间 用 户 定义 的 映射 ， 比如 表 rowtype(Tom Lane) 
修复 pg_dump 中 外 服务 器 名 字 的 丢失 引用 (Tom Lane) 

pg_upgrade 各 种 修复 (Bruce Momjian) 

正确 处 理 排斥 约束 ， 避 免 Windows 上 错误 ， 不 要 抱怨 8.4 数 据 库 中 不 匹配 toast 表 名 。 
在 PL/pgSQL 中 ， 人 允许 外 表 定 义 行 类 型 (Alexander Soudakov) 

解决 了 PL/Perl 玉 数 结果 转换 (Alex Hunsaker 和 Tom Lane) 


恢复 PL/Perl 汞 数 返回 void 的 9.1 之 前 操作 忽略 了 最 后 Perl 语 句 的 结果 值 ; 如 果 该 语句 返 
回 一 个 引用 ， 那 么 9.1.0 可 能 抛 出 错误 。 另外 ， 确 保 它 返回 复合 类 型 字符 串 值 ， 只 要 该 字 
符 串 符合 类 型 的 输入 格式 。 此 外 ， 当 画 数 的 声明 结果 类 型 分 别 不 是 数组 或 者 复合 类 型 
at, (先前 9.1 版 本 而 不 能 返回 字符 串 像 这 种 情况 中 的 ARRAY(6x221a9a0) 或 者 
HASH(0x221aa90) ) 党 试 返回 Perl 数 组 或 者 哈 希 而 抛 出 错误 。 


确保 PL/Perl 字 符 串 总 是 正确 的 UTF8 编 码 (Amit Khandekar 和 Alex Hunsaker) 


使 用 xsubpp 首 选 版 本 以 编译 PL/Perl， 不 一 定 操作 系统 的 主 拷贝 (David Wheeler 和 Alex 
Hunsaker) 


在 PL/Python 异 常 中 正确 扩散 SQLSTATE(Mika Eloranta 和 Jan Urbanski) 
为 Python 主 要 版 本 不 同 于 一 个 建立 的 不 要 安装 PL/Python 扩 展 文件 (Peter Eisentraut) 


如 果 他 们 提供 psql， 那 么 改变 所 有 contrib 扩展 脚本 文件 以 报告 有 用 错误 消息 (Andrew 


Dunstan 和 Tom Lane) 


这 有 助 于 教会 人 们 关于 使 用 cREATE EXTENSION 的 新 方法 加 载 这 些 文件 。 在 多 数 情况 下 ， 
使 用 的 脚本 可 能 直接 失败 ， 但 是 伴随 着 难以 解释 信息 。 


修复 contrib/dict_int 和 contrib/dict_xsyn 中 错误 编码 (Tom Lane) 
一 些 函 数 错误 地 假设 通过 palloc() 返回 的 内 存 保证 为 需 。 
从 正则 表达 式 测 试 机 制 中 删除 contrib/sepgsql 测试 (Tom Lane) 


因为 这 些 测 试 需要 root 权 限 ， 它 们 不 切实 际 地 自动 运行 。 相反 切换 到 手动 方式 ， 并 且 提 
供 测试 脚本 。 


修复 contrip/unaccent 的 配置 文件 解析 中 的 各 种 错误 (Tom Lane) 

接受 pgstatindex() 中 的 及 时 查询 取消 中 断 (Robert Haas) 

修复 Mac OS X 启 动 脚本 中 日 志文 件 名 的 错误 引用 (Sidar Lopez) 

恢复 wAL_pEBue 的 意外 激活 (Robert Haas) 

幸运 的 是 ， 作 为 调试 工具 ， 这 是 相当 便宜 的 ; 但 它 并 不 打算 缺 省 启用 ， 所 以 恢复 。 
确保 VPATH 编 译 正确 安装 所 有 服务 器 头 文件 (Peter Eisentraut) 

缩短 详细 错误 消息 中 报告 的 文件 名 (Peter Eisentraut) 


规则 编译 一 直 被 包含 错误 消息 调用 的 C 文 件 名 报告 ， 但 是 VPATH 编 译 之 前 报告 绝对 路 径 
名 。 


修复 中 美洲 Windows 时 区 名 解释 (Tom Lane) 


映射 "中 美洲 标准 时 间 " 为 csT6 ， 而 不 是 csT6coT ， 因为 在 中 美洲 任何 地 方 通常 观察 不 到 
DST。 


为 了 Brazil, Cuba, Fiji, Palestine, Russia 和 Samoa 中 DST 变 化 规律 更 新 时 区 数据 文件 到 
tzdata 发 布 2011n ; 以 及 历史 修正 Alaska 和 British East Africa。 


E.18. £ 79.1.1 


发 布 日 期 : 2011-09-26 


该 发 布 包含 了 9.1.0 少 量 修复 。 关 于 9.1 主 要 发 布 的 新 功能 的 信息 ， 参阅 Section E.19。 


E.18.1. 迁移 到 版 本 9.1.1 


运行 9.1.X 不 需要 备份 /恢复 。 


E.18.2. %14k 


e 使 得 pg_options_to_table 为 没有 值 的 选项 返回 空 (Tom Lane) 
以 前 这 种 情况 可 以 导致 服务 器 月 溃 。 
。 修复 GiST 索 引 打 描 末尾 的 内 存 泄露 (Tom Lane) 


执行 许多 单独 GiST 索 引 扫 描 的 命令 ， 比如 包含 很 多 行 的 表 上 新 的 基于 排斥 约束 的 GiST 验 
证 ， 由 于 这 种 泄露 可 能 短暂 地 需要 大 量 内 存 。 


e 修复 cREATE TEMPORARY TABLE 中 显示 引用 到 pg_temp 模式 (Robert Haas) 


这 过 去 是 被 允许 的 ， 但 是 在 9.1.0 中 失败 。 


E.19. & 79.1 


发 布 日 期 : 2011-09-12 


E.19.1. 概述 


该 发 布 显示 了 PostgreSQL 超 越 传 统 关 系数 据 库 功能 设置 为 新 ， 突破 性 功能 对 PostgreSQL 是 
唯一 的 。 发 布 9.0 中 介绍 的 流 复制 功能 通过 添加 同步 复制 选项 ， 流 备份 以 及 监测 改进 而 被 显 
著 增强 。 主 要 功能 包含 : 


。 人 允许 同步 复制 

。 添加 支持 外 表 

。 添加 每 列 collation 支 持 

。 添加 扩展 这 简化 附加 包 到 PostgreSQL。 

。 添加 真 的 可 串 行 化 隔离 级 别 

e 在 CREATE TABLE 中 使 用 uNLoGGED 选项 支持 未 记录 表 

e SF WITH 子 句 中 数据 修改 命 人 ( INSERT / UPDATE / DELETE ) 
。 添加 最 近邻 (ATHE) 搜索 到 GiST 索 引 

e 添加 sEcuRITY LABEL 命令 并 且 支 持 SELinux 权 限 控制 

e 更 新 PL/Python 服 务 器 端 语 言 


在 下 面部 分 将 详细 解释 上 面 项 。 


E.19.2. 迁移 到 版 本 9.1 


使 用 pg_dump 或 者 pg_upgrade 各 份 /恢复 ， 对 于 那些 希望 从 任何 以 前 发 布 中 迁移 数据 是 必须 
的 。 


版 本 9.1 包 含 了 可 能 影响 与 以 前 版 本 的 兼容 性 的 一 些 变化 。 观察 下 面 的 不 兼容 性 : 


E.19.2.1. 字符 串 


e 改变 standard_conforming_strings 的 缺 省 值 (Robert Haas) 


缺 省 情况 下 ， 反 斜 杠 是 字符 串 中 普通 字符 ， 而 不 是 转 义 字符 。 这 一 变化 删除 与 SQL 标准 
长 期 存在 的 不 兼容 。 escape_string warning 有 多 年 关于 这 个 用 法 的 警告 。 E'' 字符 串 
是 散 入 反 斜 杠 转 义 到 字符 串 中 的 正确 做 法 ， 并 且 这 种 变化 不 受 影响 。 


Warning 


这 个 变化 可 以 打 断 不 希望 的 应 用 ， 并 且 按 照旧 的 规则 执行 字符 串 逃 逸 。 该 结果 可 能 与 介 
绍 的 SQL 注 入 安全 中 断 一 样 严峻 。 确保 测试 应 用 遭受 不 可 信任 输入 ， 确保 它们 正确 处 理 
单 引号 和 文本 字符 串 中 反 斜 线 符号 。 


E.19.2.2. 转换 
。 不 允许 范 数 样式 和 属性 祥 式 数据 类 型 转换 为 复合 类 型 (Tom Lane) 


比如 ， 不 允许 _composite_value_ .text 和 text(**_composite_value_ )。 该 语法 的 无 意识 
使 用 经 常 导 致 错误 报告 ; 尽管 它 不 是 错误 ， 似 乎 追溯 到 拒绝 这 样 的 表达 式 更 好 。 当 实 际 
上 打算 整个 复合 值 计算 时 ， cast 和 :: 语法 仍然 可 以 使 用 。 


。 加 强 基 于 数组 的 域 转换 检查 (Tom Lane) 


当 域 是 基于 数组 类 型 时 ， 它 被 允许 "查看 " 域 类 型 访问 数组 元 素 ， 包含 下 标 域 值 抓 取 或 者 
分 配 一 个 元 素 。 分 配 这 样 一 个 域 值 元 素 ， 上 比如 通 

过 UPDATE ... SET domaincol[5] = ..., 将 导致 检查 域 类 型 的 约束 ， 然 而 检查 之 前 被 忽 
略 。 


E.19.2.3. 数组 
e 改变 string to_array() 为 老 长 字符 串 返 回 空 数组 (Pavel Stehule) 
以 前 返回 空 值 。 


e 改变 string to array() ， 所 以 NuLL 分 隔 符 分 离 字符 串 到 字符 (Pavel Stehule) 


先前 这 返回 空 值 。 
E.19.2.4. 对 象 修改 


。 修复 触发 器 之 前 /之 后 的 不 当 检 查 (Tom Lane) 


触发 器 可 以 在 三 种 情况 下 被 触发 : BEFORE, AFTER 或 者 INSTEAD oF 一 些 操作 。 触发 器 
BRACE ABS LSM FENN aR. 


。 需要 超级 用 户 或 者 cREATEROLE 权限 目的 是 设置 评论 角色 (Tom Lane) 


E.19.2.5. Ak 4 zmz ia 


e 改变 pg_last_xlog_receive_location() 因此 它 不 会 向 后 移动 (Fujii Masao) 


先前 ， 当 重新 启动 流 复制 的 时 候 ， pg_last_xlog_receive_location() 的 值 可 以 向 后 移 
动 。 


。 复制 连接 日 志 接 受 log connections (Magnus Hagander) 


先前 ， 复 制 连接 总 是 被 记录 。 


E.19.2.6. PL/pgSQLak 4 23 imiz A 
。 改变 不 带 参 数 的 PL/pgSQL 的 raise 命令 为 通过 附属 异常 块 可 捕获 (Piyush Newe) 
以 前 代码 块 中 RAISE 总 是 限于 附加 异常 块 中 ， 因 此 在 同一 范围 内 是 无 法 捕获 的 。 
© 调整 PL/pgSQL 的 错误 线 编号 代码 与 其 他 PL 相 一 致 (Pavel Stehule) 


先前 ，PL/pgSQL 在 范 数 体 开始 部 分 可 能 忽略 (不 计算 ) 空 行 。 由 于 这 是 不 符合 所 有 其 他 
语言 的 ， 特 殊 情况 下 被 删除 。 


© 使 得 PL/pgSQL 抱 怨 IN 和 OUT 参 数 名 冲突 (Tom Lane) 
以 前 ， 检 测 不 到 冲突 ， 该 名 字 可 能 就 默默 地 指向 OUT 参 数 。 
© PL/pgSQL 变 量 类 型 修饰 符 对 于 SQL 分 析 器 是 可 见 的 (Tom Lane) 


附属 于 PL/pgSQL 变 量 的 类 型 修饰 符 (比如 varchar 长 度 限 制 ) 在 分 配 之 间 被 执行 ， 但 是 
出 于 其 他 目的 被 忽略 。 这 些 变量 操作 更 像 声 明了 同一 描述 符 的 表 列 。 这 不 希望 在 多 数 情 
况 下 产生 任何 可 见 差异 ， 但 是 它 可 能 产生 通过 PL/pgSQL 责 数 发 布 的 一 些 SQL 命 使 的 微妙 
变化 。 


E.19.2.7. Contrib 


e 所 有 contrib 模 块 伴随 cREATE EXTENSION 被 安装 而 不 是 通过 手动 调用 它们 的 SQL 脚本 
(Dimitri Fontaine, Tom Lane) 


为 了 更 新 包含 contrib 模 块 9.0 版 本 的 现 有 数据 库 ， 使 
FA CREATE EXTENSION ... FROM unpackaged 封装 现 有 contrib 模 块 的 对 象 到 一 个 扩展 中 。 当 
从 先前 9.0 版 本 中 更 新 时 ， 使 用 旧 的 外 载 脚本 删除 contrib 模 块 的 对 象 ， 然后 使 


FA CREATE EXTENSION 。 


E.19.2.8. 其 他 的 不 兼容 


e 使 得 pg stat_reset() 重 置 所 有 数据 库 级 别 统计 (Tomas Vondra) 


一 些 pg_stat_database 计数 器 没有 被 重 置 。 


。 修复 一 些 information_schema.triggers 列 名 匹配 新 的 SQL 标准 名 (Dean Rasheed) 


。 把 ECPG 游 标 名 看 作 不 区 分 大 小 写 (Zoltan Boszormenyi) 


E.19.3. 变化 


下 面 你 将 发 现在 PostgreSQL 9.1 和 以 前 主要 发 布 之 间 的 变化 的 详细 列表 。 


E.19.3.1. fk 42s 


E.19.3.1.1. 性 能 
e 支持 在 create TABLE 中 使 用 uNLocGED 选项 的 未 记录 表 (Robert Haas) 
这 个 表 提 供 了 比 常规 表 更 好 的 更 新 性 能 ， 但 是 不 安全 : 它们 内 容 在 服务 器 崩溃 的 情况 下 
被 自动 清除 。 也 不 会 被 传送 到 各 份子 服务 器 。 


© ÙF FULL OUTER JOIN 作为 哈 希 连接 被 实现 ， 并 且 人 允许 LEFT OUTER JOIN 或 者 
RIGHT OUTER JOIN 的 一 侧 被 哈 希 (Tom Lane) 


以 前 FULL ouTER Jorn 只 能 作为 合并 连接 被 实现 ， 并 且 LEFT outer JOIN 和 
RIGHT OUTER JOIN 可 以 哈 希 连接 空 侧 。 这 些 变 化 提供 了 额外 查询 优化 可 能 性 。 


合并 复制 fsync 请 求 (Robert Haas, Greg Smith) 
这 大 大 提高 了 大 量 写 入 重 载 下 性 能 。 
e 提高 commit siblings 的 性 能 (Greg Smith) 


这 人 允许 较 少 开销 的 commit_siblings 的 使 用 。 


减少 大 的 ispell 词 典 存储 需求 (Pavel Stehule, Tom Lane) 


避免 " 盲 写 "后 将 数据 文件 打开 (Alvaro Herrera) 
这 修复 它们 被 删除 后 后 端 保持 文件 打开 时 间 ， 防 止 内 核 回 收 磁 意 空间 。 


E.19.3.1.2. 优化 器 


。 人 允许 继承 表 打 描 返回 有 意义 的 排序 结果 (Greg Stark, Hans-Jurgen Schonig, Robert 
Haas, Tom Lane) 


这 人 允许 使 用 oRDER BY ， LIMIT 或 者 带 有 继承 表 的 MIN / max 的 查询 的 更 好 优化 。 
。 提高 GIN 素 引 扫 描 成 本 估计 (Teodor Sigaev) 


。 tem ete Mwindowe ax Ah it (Tom Lane) 


E.19.3.1.3. 认证 


在 pg_hba.cont 中 支持 host 名 字 和 host 后 级 (比如 .example.com ) 

先前 只 支持 host IP 地 址 和 CIDR 值 。 

在 pg_hba.conf 的 host 列 支持 关键 字 all (Peter Eisentraut) 

以 前 为 了 这 个 人 们 使 用 0.0.0.0/0 或 者 ::/0 

在 不 支持 Unix 套 接 字 连接 的 平台 上 拒绝 pg_hba.conf 中 的 local 行 (Magnus Hagander) 


先前 ， 默 默 忽略 这 样 的 行 ， 这 可 能 是 合 人 惊讶 的 。 这 使 得 该 操作 更 像 其 他 不 支持 的 情 
况 。 


允许 GSSAPI 通过 SSPI 用 于 验证 到 服务 器 (Christian Ullrich) 
特别 是 允许 基于 Unix GSSAPI 客 户 端 执行 伴随 Windows 服 务 器 的 SSPI 认 证 。 
在 区 域 套 接 字 上 的 ident 认证 被 称 为 peer (Magnus Hagander) 


该 旧 的 术语 仍然 接受 向 后 兼容 性 ， 但 是 因为 这 两 种 方法 在 根本 上 是 不 同 的 ， 为 它们 采用 
不 同 的 名 字 似乎 更 好 。 


重 写 peer 认 证 以 避免 证 书 控制 信息 的 使 用 (Tom Lane) 


这 个 变化 使 得 同等 验证 码 更 加 简单 而 且 可 执行 性 更 好 。 然 而 ， 它 需要 平台 提 
供 getpeereid 加 数 或 者 等 效 套 接 字 操作 。 按 目前 所 知 ， 之 前 同等 认证 执行 唯一 
并 且 现 在 不 是 之 前 5.0 NetBSD. 


E.19.3.1.4. 监控 


添加 重启 点 和 检查 点 记录 详情 ， 通 过 log checkpoints 控制 (Fujii Masao, Greg Smith) 
新 的 详情 包含 WAL 文 件 以 及 同步 活动 。 

添加 log file mode 其 控制 通过 日 志 收集 器 创建 的 日 志文 件 权限 (Martin Pihlak) 

减少 syslog 记 录 人 缺 省 最 大 行 长 度 到 加 上 前 级 900 字 节 (Noah Misch) 


E.19.3.1.5. 统计 视图 


添加 client_hostname 列 到 pg_stat_activity (Peter Eisentraut) 
先前 只 报道 客户 端 地 址 。 
添加 pg stat_xact_* 统计 图 数 和 视图 (Joel Jacobson) 


这 些 更 像 数 据 库 端 统计 计算 视图 ， 但 是 反映 了 当前 事务 重要 性 。 


。 添加 数据 库 级 别 最 后 重 置 时 间 以 及 后 端 写 统计 视图 (Tomas Vondra) 
e 在 pg stat * tables 视图 中 添加 列 显 示 清 理 数 和 分 析 操 作 (Magnus Hagander) 
e 添加 buffers_backend_fsync 列 到 pg_stat_bgwriter (Greg Smith) 
这 个 新 列 计算 后 端 同步 缓冲 区 的 次 数 。 
E.19.3.1.6. 服务 器 设置 
e 提供 wal buffers 的 自动 调整 (Greg Smith) 
缺 省 情况 下 ， wal_buffers 的 值 基于 shared_buffers 的 值 被 自动 选择 。 


© WA deadlock_timeout , log_min_duration_statement 和 log_autovacuum_min_duration ig 


加 最 大 值 (Peter Eisentraut) 


这 些 参数 的 最 大 值 先 前 只 有 35 分 钟 。 现在 允许 更 大 值 。 


E.19.3.2. 各 份 与 恢复 


E.19.3.2.1. it till F024 2 Jats 
。 人 允许 同步 复制 (Simon Riggs, Fujii Masao) 


这 多 许 等 待 各 用 的 主 服务 器 在 承认 提交 前 写 事 务 信息 到 磁盘 。 每 次 各 用 起 着 同步 各 份 的 
作用 。 正如 通过 Synchronous_standby_names 设置 控制 。 在 每 个 事务 基础 上 使 
用 synchronous_commit 设置 可 以 启用 或 者 禁用 同步 复制 。 


。 使 用 流 复制 网 络 连 接 添加 发 送 文件 系统 备份 协议 支持 到 各 用 服务 器 (Magnus Hagander, 
Heikki Linnakangas) 


当 设 置 一 个 各 用 服务 器 时 ， 这 避免 了 手动 传送 文件 系统 各 份 的 需求 。 
e 添加 replication_timeout 设置 (Fujii Masao, Heikki Linnakangas) 


对 于 超过 replication_timeout 间隔 空间 的 复制 连接 将 自动 被 终止 。 先前 ， 失 败 连 接 通常 
不 能 被 检测 直到 TCP 超 时 消逝 ， 在 很 多 情况 下 这 是 不 方便 的 。 


。 添加 命令 行 工具 pg_basebackup 创建 一 个 新 的 备用 服务 器 或 者 数据 库 各 份 (Magnus 
Hagander) 


。 为 角色 添加 复制 许可 (Magnus Hagander) 


这 是 用 于 流 复制 的 只 读 权 限 。 它 允许 非 超 级 用 户 用 于 复制 连接 。 先前 只 有 超级 用 户 可 以 
启动 复制 连接 ; 缺 省 情况 下 超级 用 户 具有 此 权限 。 


E.19.3.2.2. 各 份 监 控 


。 增加 系统 视图 pg_stat_replication, 这 显示 了 WAL 发 送 者 进程 活动 (Itagaki Takahiro, 
Simon Riggs) 


报告 所 有 连接 备用 服务 器 的 状态 。 


e WN REAR pg_last_xact_replay_timestamp() (Fujii Masao) 





返回 了 主 库 产生 最 近 提 交 或 者 应 用 在 各 库 上 的 终止 记录 的 时 间 。 


E.19.3.2.3. HAD 
。 添加 配置 参数 hot_standby feedback 启动 各 库 以 推迟 主 库 旧 行 版 本 清理 (Simon Riggs) 
这 有 助 于 避免 各 库 上 取消 长 时 间 运 行 查询 。 


ASAN pg_stat_database_conflicts 系统 视图 以 显示 取消 的 查询 和 原因 (Magnus Hagander) 


e 
tee 
AS 


因为 删除 的 表 空 间 ， 锁 超时 ， 旧 快照 ， 保 留 区 以 及 死 锁 ， 可 以 发 生 取 消 。 
e 添加 conflicts 计算 到 pg stat database (Magnus Hagander) 
发 生 在 数据 库 中 的 冲突 数 。 
e 为 max_standby_archive_delay 和 max_standby_streaming_delay 增加 最 大 值 。 


每 个 参数 的 最 大 值 以 前 只 有 35 分 钟 。 现 在 允许 更 大 的 值 。 


添加 ERRCODE_T_R_DATABASE_DROPPED 错误 代码 以 报告 恢复 冲突 ， 由 于 已 删除 数据 库 
(Tatsuo Ishii) 


这 对 于 连接 池 软 件 是 有 用 的 。 
E.19.3.2.4. 恢复 控制 
。 添加 函 数 以 控制 流 复制 重播 (Simon Riggs) 


or EK es pg_xlog_replay_pause() , pg_xlog_replay_resume() ) FBEKANRE 
pg_is_xlog_replay_paused() 





e 添加 recovery.conf 设置 pause_at_recovery_target 在 目标 位 置 暂 停 恢复 (Simon Riggs) 
这 人 允许 需要 恢复 服务 器 检查 恢复 点 是 否 是 所 需 的 。 
e 使 用 pg create_restore_point() 添加 创建 命名 恢复 点 的 能 力 (Jaime Casanova) 


这 些 命 闻名 恢 (Sm 被 声明 为 使 用 新 的 recovery.conf 设置 recovery_target_name 的 恢复 目 


标 。 
。 人 允许 各 份 恢复 自动 切换 到 新 的 时 间 线 (Heikki Linnakangas) 
目前 备用 服务 器 为 周期 性 新 的 时 间 线 扫描 为 档 目 录 。 


e 添加 restart_after_crash 设置 ， 在 后 台 骨 省 后 禁用 自动 服务 器 重启 (Robert Haas) 
这 人 允许 外 部 集群 管理 软件 控制 数据 库 服务 器 是 否 重新 启动 。 
e 介 许 recovery.conf 使 用 和 postgresql.conf 相同 的 引用 操作 (Dimitri Fontaine) 


以 前 所 有 值 必 须 被 引用 。 


E.19.3.3. 查询 


。 添加 真 的 可 串 行 化 隔离 级 别 (Kevin Grittner, Dan Ports) 


先前 ， ee 这 人 允许 某 些 记录 异 
常 。 旧 的 快照 隔离 级 别 通 过 请 求 REPEATABLE READ 隔离 级 别 可 用 。 


e 人 允许 WITH 子 句 中 数据 修改 命令 ( INSERT / UPDATE / DELETE ) (Marko Tiikkaja, Hitoshi 
Harada) 


这 些 命令 可 以 使 用 RETURNING 传递 数据 到 所 包含 查询 。 


© 人 允许 WITH 子 句 被 附属 于 INSERT, UPDATE , DELETE 语句 (Marko Tiikkaja, Hitoshi 
Harada) 


e 当 在 croup BY 子 句 中 指定 主键 时 ， 人 允许 查询 目标 列 中 的 FE croup BY 列 (Peter 
Eisentraut) 


SQL 标准 允许 该 操作 ， 由 于 该 主键 ， 结 果 是 明确 的 。 
e 人 允许 UNION / INTERSECT / except 子 句 中 关键 字 DISTINCT 的 使 用 (Tom Lane) 
DISTINCT 是 缺 省 操作 ， 因 此 该 关键 字 的 使 用 是 多 余 的 ， 但 是 SQL 标 准 人 允许 它 。 


。 修复 普通 规则 查询 以 使 用 和 expan ANALYZzE 相同 快照 操作 (Marko Tiikkaja) 


先前 EXPLAIN ANALYZE 使 用 涉及 规则 的 查询 略微 不 同 的 快照 时 间 。 EXPLAIN ANALYZE 操作 
被 认为 更 合乎 逻辑 。 


E.19.3.3.1. 字符 串 
e 添加 每 列 collation 支 持 (Peter Eisentraut, Tom Lane) 


以 前 在 数据 库 创 建 中 选择 排序 规则 (文本 字符 串 排 序 ) 。 排序 规则 可 以 设置 每 列 ， 域 ， 
索引 ， 或 者 表达 式 ， 通过 SQL 标准 coLLATE FA 


E.19.3.4. 对 象 操作 


e 添加 extensions， 这 简化 了 附加 PostgreSQL 的 包装 (Dimitri Fontaine, Tom Lane) 


通过 新 的 CREATE / ALTER / DROP EXTENSION 命令 控制 扩展 。 这 取代 了 分 组 对 象 的 点 对 点 
方法 被 添加 到 PostgreSQL 安 装 中 。 


。 添加 支持 外 表 (Shigeru Hanada, Robert Haas, Jan Urbanski, Heikki Linnakangas) 


o 人 允许 新 值 通过 ALTER TYPE 被 添加 到 现 有 枚 举 类 型 中 (Andrew Dunstan) 


添加 ALTER TYPE ... ADD/DROP/ALTER/RENAME ATTRIBUTE (Peter Eisentraut) 
这 人 允许 复合 类 型 的 修改 。 
E.19.3.4.1. ALTER 对 象 
© 在 分 类 表 上 添加 RESTRICT / CASCADE 到 acter TYPE 操作 (Peter Eisentraut) 
这 控制 ADD / DROP / ALTER / RENAME ATTRIBUTE 级 联 操作 。 
e 支持 ALTER TABLE _name {OF | NOT OF} _type_ (Noah Misch) 
这 个 语法 允许 单独 表 成 为 分 类 表 ， 或 者 分 类 表 成 为 单独 的 。 
e 在 ALTER ... SET SCHEMA 命令 中 添加 支持 多 个 对 象 类 型 (Dimitri Fontaine) 


该 命令 现在 支持 转换 ， 算 子 ， 算 子 类 ， 算 子 族 ， 文 本 搜索 配置 ， 文 本 搜索 词典 ， 文 本 搜 
索 分 析 器 ， 以 及 文本 搜索 模板 。 


E.19.3.4.2. CREATE/ALTER TABLE 
e 添加 ALTER TABLE ... ADD UNIQUE/PRIMARY KEY USING INDEX (Gurjeet Singh) 
这 允许 使 用 现 有 唯一 索引 包含 同时 创建 的 唯一 索引 定义 主键 或 者 唯一 约束 。 
e 人 允许 ALTER TABLE 添加 没有 验证 的 外 键 (Simon Riggs) 


新 选项 称 为 NoT VALID 。 约束 的 状态 可 以 随后 被 修改 为 vALIDATED 并 且 执行 验证 检查 。 
同时 这 些 允 许 你 添加 对 读 写 操作 影响 最 小 的 外 键 。 


e Sti ALTER TABLE... SET DATA TYPE 避免 在 合适 情况 中 的 表 重 写 (Noah Misch, Robert 
Haas) 


比如 ， 转 换 varchar 列 使 得 text 不 再 需要 表 重 写 。 然而 ， 增 加 varchar 列 上 长 度 限制 
仍然 需要 表 重 写 。 


添加 cREATE TABLE IF NOT EXISTS 语法 (Robert Haas) 


如 果 该 表 已 经 存在 ， 那 么 允许 没有 导致 错误 的 表 创 建 。 


。 当 两 个 后 端 尝试 添 加 继承 孩子 到 同一 时 间 的 同一 表 时 ， 修复 可 能 "元 组 同时 更 新 "错误 
(Robert Haas) 


ALTER TABLE 需要 采取 更 强 锁定 父 表 ， 这 样 该 会 话 不 能 试图 同时 更 新 它 。 
E.19.3.4.3. 对 象 权 限 
e 添加 sEcURITY LABEL 命令 (KaiGai Kohei) 


这 人 允许 安全 标签 分 配给 对 象 。 


E.19.3.5. 实用 操作 
。 添加 事务 级 别 咨询 锁 (Marko Tiikkaja) 
这 与 现 有 会 话 级 别 咨询 锁 类 似 ， 但 是 在 事务 结束 时 自动 释放 这 种 锁 。 
e 使 得 TRUNCATE ... RESTART IDENTITY 相互 作用 的 重启 序列 (Steve Singer) 
如 果 在 提交 事务 活动 和 提交 完成 之 间 发 生 后 端 崩 溃 ， 那么 该 计数 器 可 能 已 经 不 同步 。 
E.19.3.5.1. COPY 
e 添加 encopinc 选项 到 copy To/From (Hitoshi Harada, Itagaki Takahiro) 
这 人 允许 分 别 从 客户 端 编 码 指定 copy 文件 编码 。 
e 添加 双向 copy 协议 支持 (Fujii Masao) 
当前 通过 流 复制 被 使 用 。 
E.19.3.5.2. EXPLAIN 


e 使 得 EXPLAIN VERBOSE 在 Functionscan 节点 中 显示 阔 数 调用 表达 式 (Tom Lane) 


E.19.3.5.3. VACUUM 
e 添加 额外 详情 到 vacuum FULL VERBOSE 和 CLUSTER VERBOSE 的 输出 中 (ltagaki Takahiro) 
新 信息 包含 活 的 和 死 的 元 组 数 ， 以 及 是 否 cLusTER 使 用 索引 重新 创建 。 
。 如 果 它 不 能 获得 表 锁 ， 那么 阻止 autovacuum 等 待 (Robert Haas) 
它 将 尝试 随后 清理 该 表 。 
E.19.3.5.4. CLUSTER 
e 当 它 似乎 比较 廉价 时 ， 人 允许 cluster 排序 表 而 不 是 打 描 索引 (Leonardo Francalanci) 


E.19.3.5.5. 索引 
。 添加 最 近邻 ( 算 子 排序 ) 搜索 到 GiST 索 引 (Teodor Sigaev, Tom Lane) 


这 人 允许 GiST 索 引 迅速 返回 带 有 LIMIT 的 查询 中 的 _N_ 最 近 值 。 比 如 


SELECT * FROM places ORDER BY location &lt;-&gt; point '(101,456)' LIMIT 10; 


找到 离 给 定 目标 点 最 近 的 十 个 位 置 。 
e 人 允许 GIN 索 引 素 引 无 效 和 空 值 (Tom Lane) 

这 人 允许 全 GIN 索 引 扫 描 ， 并 且 修 复 GIN 扫 描 可 能 失败 的 情况 。 
e 多 许 GIN 索 引 更 好 识别 重复 搜索 项 (Tom Lane) 

这 降低 了 索引 扫描 成 本 ， 尤其 是 在 避免 不 必要 全 扫描 索引 的 情况 下 。 
。 修复 GiST 索 引 充 分 碰撞 安全 (Heikki Linnakangas) 


先前 存在 需要 REINDEX 的 罕见 情况 (你 可 能 被 告知 ) 。 


E.19.3.6. 数据 类 型 
e 允许 numeric 在 一 般 情 况 下 使 用 更 紧凑 ， 两 字 节 标题 。 
以 前 所 有 numeric 值 有 四 字 节 标题 ， 这 种 变化 节省 磁盘 存储 。 
。 添加 通过 money 划分 money 的 支持 (Andy Balholm) 
。 HKD void 上 的 二 进 制 /O(Radoslaw Smogura) 
。 提高 几何 学 操作 符 的 斜 边 计 算 (Paul Matthews) 
这 避免 了 不 必要 的 浴 出 ， 也 可 能 更 精准 。 
。 支持 哈 希 数 组 值 (Tom Lane) 
这 提供 了 额外 查询 优化 可 能 性 。 
。 不 要 将 复合 类 型 看 作 可 分 类 的 除非 所 有 列 类 型 是 可 分 类 的 (Tom Lane) 
这 避免 了 可 能 的 运行 时 "不 能 识别 比较 画 数 "错误 ， 如 果 可 能 实现 没有 排序 的 查询 。 
BY, ANALYZE 不 会 尝试 为 该 复合 类 型 列 使 用 不 恰当 的 统计 收集 方法 。 
E.19.3.6.1. Casting 
。 添加 支持 money 和 numeric 之 间 的 转换 (Andy Balholm) 


e 添加 从 int4 和 ints 到 money 的 转换 (Joey Adams) 


。 如 果 它 是 一 个 分 类 表 ， 那么 允许 转换 表 的 行 类 型 到 表 的 父 类 型 (Peter Eisentraut) 
这 与 允许 转换 行 类 型 到 父 表 行 类 型 的 现 有 功能 类 似 。 
E.19.3.6.2. XML 
e 添加 XML 辑 数 xMLEXISTS 和 xpath_exists() PX#<(Mike Fowler) 
这 些 用 于 XPath 匹配 。 
天 


° 添加 XML 本 打数 xml_is_well_formed() , xml_is_well_formed_document() ， 





xml_is_well_formed_content() (Mike Fowler) 





这 些 检查 输入 是 否 是 恰当 形成 的 XML。 它们 提供 了 以 前 在 弃 用 的 contrib/xml2 模块 中 可 
用 的 功能 。 


E.19.3.7. HR 


© 添加 函数 format(text, ...) ， 这 类 似 于 C 的 printf() (Pavel Stehule, Robert Haas) 
它 目 前 支持 字符 串 ，SQL 文 本 以 及 SQL 标识 符 格 式 。 


。 添加 字符 串 画 数 concat() ，concat_ws() ，left() ，right() ,以 及 reverse() (Pavel 
Stehule) 


这 改善 了 与 其 他 数据 库 产品 的 兼容 性 。 
e RIEZ pg_read_binary_file() 以 读 取 二 进 制 文件 (Dimitri Fontaine, Itagaki Takahiro) 


e IIZ pg read file) 的 一 个 参数 版 本 以 读 取 整 个 文件 (Dimitri Fontaine, Itagaki 
eas 


e 为 空 值 义理 控 制 添加 array_to_string() 和 string_to_array() 的 三 个 参数 形式 (Pavel 
Stehule) 


E.19.3.7.1. 对 象 信息 画 数 
e 添加 pyg_describe_object() BX2<(Alvaro Herrera) 


该 回 数 用 于 获得 人 类 可 读 字 符 捉 描述 对 象 ， 基 于 pg class OID, 对 象 OID 以 及 子 对 象 
OID。 它 可 以 有 助 于 解释 pg depend 的 内 容 。 


。 更 新 内 置 操作 符 注释 和 潜在 函数 (Tom Lane) 
打算 通过 相关 算 子 使 用 的 范 数 同 桩 被 注释 。 


e 添加 回 数 quote all identifiers 强迫 ExPLAIN 中 以 及 系统 目录 函数 像 
pg_get_viewdef() 中 所 有 标识 符 引 用 。 


尝试 输出 模式 到 工具 和 伴随 不 同 引 用 规则 更 加 容易 的 其 他 数据 库 。 
e 添加 列 到 information_schema.sequences 系统 表 (Peter Eisentraut) 
先前 ， 尽 管 视 图 存在 ， 未 实现 关于 序列 参数 的 列 。 
e 在 hnas table privilege() PARIKKA I public 作为 伪 角 色 名 字 (Alvaro 


Herrera) 
这 人 允许 检查 public 权 限 。 
E.19.3.7.2. 函数 和 触发 器 创建 
e 支持 视图 上 Insta or 触发 器 (Dean Rasheed) 


该 功能 可 以 充分 实现 可 更 新 视图 。 


E.19.3.8. 服务 器 端 语言 


E.19.3.8.1. PL/pgSQL 服 务 器 端 语言 
e 添加 FOREACH IN ARRAY 到 PL/pgSQL(Pavel Stehule) 
这 比 通 历 数组 值 元 素 的 先前 方法 更 有 效 并 且 可 读 性 更 高 。 


e 人 允许 可 以 从 同一 地 方 捕获 ”RAISE ERROR 的 同一 位 置 捕获 不 带 参 数 的 Rase (Piyush 
Newe) 


前 面 编 码 从 包含 活跃 异常 处 理 程 序 块 中 抛 出 错误 。 新 操作 与 其 他 DBMS 产 品 更 加 一 致 。 


E.19.3.8.2. PL/Perl 服 务 器 端 语 言 
。 人 允许 通用 记录 参数 到 PL/Perl 函 数 (Andrew Dunstan) 
可 以 声明 PL/Perl 辑 数 接受 类 型 record 。 该 操作 与 任何 命名 复合 类 型 是 一 样 的 。 
e 转换 PL/Perl 数 组 参数 到 Perl 数 组 (Alexey Klyukin,Alex Hunsaker) 
字符 串 表 示 仍 然 可 用 。 
。 转换 PL/Perl 复 合 类 型 参数 到 Perl 哈 希 (Alexey Klyukin, Alex Hunsaker) 
字符 串 表 示 仍 然 可 用 。 
E.19.3.8.3. PL/Python 服 务 器 端 语 言 
。 添加 表 函 数 支 持 PL/Python(Jan Urbanski) 


PL/Python 现 在 可 以 返回 多 个 our 参数 和 记录 集 。 


添加 验证 器 给 PL/Python (Jan Urbanski) 
允许 PL/Python 函 数 在 函数 创建 时 间 是 语法 检查 的 。 

允许 PL/Python 中 SQL 查 询 异常 (Jan Urbanski) 

这 人 允许 从 PL/Python 异 常 块 中 访问 SQL 生 成 异常 错误 代码 。 
添加 明确 子 事务 到 PL/Python (Jan Urbanski) 
为 引用 字符 串 添 加 PL/Python 函 数 (Jan Urbanski) 
这 些 画 数 是 plipy.quote ident ， plpy.quote_ literal ， 和 plpy.quote_nullable o 
添加 跟踪 信息 到 PL/Python 错 误 (Jan Urbanski) 
从 带 有 PLy_elog 的 迭代 器 中 报告 PL/Python 错 误 (Jan Urbanski) 
修复 Python 3 异常 处 理 (Jan Urbanski) 


异常 类 以 前 在 Python 3 下 plpy 中 不 可 用 。 


E.19.3.9. & Pim A 


标记 createlang 和 droplang 为 废弃 的 现在 它们 只 是 调用 扩展 命令 (Tom Lane) 


E.19.3.9.1. psdl 


增加 psql 命 令 \conninfo 以 显示 当前 连接 信息 (David Christensen) 
添加 psql 命 令 \sf A ETRE E x (Pavel Stehule) 

添加 psql 命 令 \dL 罗列 语言 (Fernando Ike) 

添加 s ("system") 选 项 到 psql 的 \dn (罗列 模式 ) 命 令 (Tom Lane) 
没有 s 的 \dn 现在 抑制 系统 模式 。 

允许 psql 的 \e 和 \ef 命令 接受 用 于 定位 编辑 器 中 游标 的 行 号 (Pavel Stehule) 
按照 PsQL_EDITOR_LINENUMBER_ARG 环境 变量 被 传递 给 编辑 器 。 

psql 设 置 来 自 缺 省 操作 系统 区 域 的 客户 端 编码 (Heikki Linnakangas) 
如 果 没 有 设置 pecLIENTENCODING 环境 变量 ， 那么 只 会 发 生 。 

尝试 \d 区 分 唯一 索引 和 唯一 约束 (Josh Kupershmidt) 

当 讨论 9.0 或 者 之 后 服务 器 时 ， 尝试 \dt+ 报告 pg_table_size 而 不 


是 pg_relation_size (Bernd Helmle) 


这 是 表 大 小 更 加 有 效 的 度量 ， 但 是 注意 这 与 同一 显示 中 先前 报告 的 是 不 一 样 的 。 


。 额外 的 tab 实 现 支 持 (Itagaki Takahiro, Pavel Stehule, Andrey Popp, Christoph Berg, 
David Fetter, Josh Kupershmidt) 


E.19.3.9.2. pg_dump 


e 添加 pg_dump 和 pg_dumpall 选项 --quote-all-identifiers 强制 引用 所 有 标识 符 (Robert 
Haas) 


e 添加 directory 格式 给 pg_dump (Joachim Wieland, Heikki Linnakangas) 
内 部 类 似 于 tar pg_dump 格 式 。 


E.19.3.9.3. pg_ctl 
。 修复 pg_ctl， 所 以 它 不 再 错误 地 报告 服务 器 没有 运行 (Bruce Momjian) 
如 果 服 务 器 正在 运行 但 是 pg_ctl 无 法 验证 ， 先前 这 可 能 发 生 。 
。 提高 pg_ct| 和 启动 的 "wait" ( -w ) 选 项 (Bruce Momjian, Tom Lane) 


等 待 模式 现在 更 加 重 棒 ， 它 通过 非 缺 省 postmaster port 号 ， 非 缺 省 Unix 域 套 接 字 位 置 
权限 问题 ， 或 者 旧 的 postmaster 锁 文件 不 会 被 混乱 。 


e 添加 promote 选项 到 pg_ctl 用 来 切换 备用 服务 器 到 主 库 (Fujii Masao) 


E.19.3.10. 开发 工具 


E.19.3.10.1. libpq 


e 添加 libpq 连 接 选 项 client_encoding 这 就 像 PGCLIENTENCODING 环境 变量 (Heikki 
Linnakangas) 


{i auto 设置 基于 操作 系统 区 域 的 客户 端 编码 。 
e 添加 PQlibversion() BR, ti&Ellibpq = hkA(Magnus Hagander) 
libpq 已 有 paserverversion() 返回 服务 器 版 本 。 


e 当 通 过 伴随 新 的 requirepeer 连接 选项 的 Unix 域 套 接 字 连接 时 ， 人 允许 libpq 使 用 客户 端 检 
查 服务 器 进程 用 户 名 。(Peter Eisentraut) 


当 通 过 Unix 域 套 接 字 连接 时 ，PostgreSQL 人 允许 服务 器 检查 客户 端 用 户 名 。 


e 添加 Paping() 和 PQpingParams() 到 libpq (Bruce Momjian, Tom Lane) 


这 些 画 数 人 允许 不 尝试 打开 新 会 话 的 服务 器 状态 检测 。 


E.19.3.10.2. ECPG 
© 多 许 ECPG 接 受 WHERE CURRENT oF 子 句 中 动态 游标 名 称 (Zoltan Boszormenyi) 


。 尝试 ecpglib 写 带 有 15 位 精度 而 不 是 以 前 的 14 位 的 double 值 (Akira Kurosawa) 


E.19.3.11. 编译 选项 
。 使 用 可 以 接受 它 的 HP-UX C 编 译 器 的 +0libmerrno 编译 标记 (lbrar Ahmed) 
这 避免 了 最 新 HP 平台 上 math 库 调用 的 可 能 的 不 当 操 作 。 
E.19.3.11.1. Makefiles 
。 改善 并 行 make 支 持 (Peter Eisentraut) 
允许 更 快 编译 。 同 时 ， make -k 更 加 一 致 运行 。 
。 需要 GNU make 3.80 或 者 更 新 版 本 (Peter Eisentraut) 
由 于 并 行 make 改 进 这 是 必须 的 。 
e 添加 make maintainer-check 目标 (Peter Eisentraut) 


这 个 目标 执行 各 种 不 适用 于 编译 或 者 回归 测试 的 源 代码 检查 。 目前 ，duplicate_oids,， 
SGML 语 法 和 tab 检 查 ，NLS 语 法 检查 。 


。 支持 contrib 中 的 make check (Peter Eisentraut) 


以 前 只 有 make installcheck 运行 ， 但 是 现在 支持 临时 安装 中 测试 。 Th 
级 make check-world 包含 这 种 方式 测试 contrib 。 


E.19.3.11.2. Windows 
e 在 Windows 上 ， 人 允许 pg_ctl 注册 服务 为 自动 启动 或 者 是 按 需 启动 (Quan Zongliang) 
e 添加 Windows 上 支持 收集 崩溃 转 储 (Craig Ringer, Magnus Hagander) 
通过 非 调试 Windows 二 进 制 文件 产生 minidumps， 并 且 通 过 标准 调试 工具 进行 分 析 。 
e 启动 MinGW64 编 译 器 编译 (Andrew Dunstan) 


这 人 允许 编译 64 位 Windows 二 进 制 文件 即使 在 非 Windows 平 台 通 过 交叉 编译 。 


E.19.3.12. 源 代 码 


。 (Zir GUC & B78 44 WAPI(Tom Lane) 


以 往 分 配 钩 画 数 划分 检查 钧 和 分 配 钩 ， 前 者 可 以 失败 但 是 后 者 不 能 。 这 一 变化 将 影响 定 
义 自 定义 GUC 参 数 的 附加 模块 。 


。 添加 源 代码 锁 存 器 以 支持 等 待 事件 (Heikki Linnakangas) 
。 集中 数据 修改 权限 检查 逻辑 (KaiGai Kohei) 
© 为 了 保持 一 致 性 添加 缺失 的 get_ object _oid() A{(Robert Haas) 


e 为 了 compiling add-on modules 通过 删除 冲突 关键 字 提高 使 用 C++ 编译 器 的 能 力 (Tom 
Lane) 


。 添加 支持 DragonFly BSD (Rumko) 
。 出 于 后 端 使 用 暴露 quote_literal_cstr() (Robert Haas) 
。 在 缺 省 编码 中 运行 回 当 测试 (Peter Eisentraut) 
回 为 测试 以 前 总 是 运行 SQL_AscII 编码 。 
e 添加 src/tools/git_changelog 蔡 换 cvs2cl 和 pgcvslog (Robert Haas, Tom Lane) 
e 添加 git-external-diff 脚 本 到 src/tools (Bruce Momjian) 
这 用 于 产生 来 自 git 的 语 境 差异 
。 提高 支持 编译 Clang (Peter Eisentraut) 
E.19.3.12.1. IR 44544 
。 添加 源 代 码 钧 检查 权限 (Robert Haas, Stephen Frost) 
。 出 于 使 用 安全 框架 添加 后 对 象 创建 画 数 钓 (KaiGai Kohei) 


。 添加 客户 端 认 证 钩 (KaiGai Kohei) 


E.19.3.13. Contrib 


e 修改 contrib 模块 和 程序 语言 通过 新 的 扩展 机 制 安 装 (Tom Lane, Dimitri Fontaine) 
e 添加 contrib/file faw 外 数据 包 (Shigeru Hanada) 
外 表 使 用 这 个 外 数据 包 可 以 以 类 似 于 copy 的 方式 读 取 平 文件 。 
。 添加 最 近邻 搜索 支持 contrib/pg_trgm 和 contrib/btree gist (Teodor Sigaev) 
e 添加 contrib/btree_gist 支持 不 平等 搜索 (Jeff Davis) 


e 修复 contrib/fuzzystrmatch BY levenshtein() 回 数 以 处 理 多 字 节 字符 (Alexander 
Korotkov) 


e 添加 ssl_cipher() and ssl_version() KJE] contrib/sslinfo (Robert Haas) 

e 修复 contrib/intarray 和 contrib/hstore 提供 与 索引 空 数组 一 致 结果 (Tom Lane) 
先前 使 用 索引 的 空 数组 查询 可 能 返回 使 用 顺序 扫描 的 不 同 结果 。 

e 人 多 许 contrib/intarray 恰当 工作 在 多 维 数组 上 (Tom Lane) 


e 在 contrib/intarray E, 避免 在 没有 空 值 实际 存 在 的 情况 下 抱怨 空 值 存 在 的 错误 (Tom 
Lane) 


e 在 contrib/intarray 中 ， 修复 关于 空 数组 包含 操作 符 操作 (Tom Lane) 
空 数组 现在 正确 地 认为 被 包含 在 任何 其 他 数组 中 。 


e 删除 通过 xslt_process() 处 理 的 _parameter_ = _value_ 对 数 上 contrib/xm12 的 任意 限 
制 (Pavel Stehule) 


以 前 限制 是 10。 


e 在 contrib/pageinspect 中 ， 修复 heap_page_item 以 返回 32 位 值 的 infomask(Alvaro 
Herrera) 


这 避免 返回 负 值 ， 这 是 混乱 的 。 该 潜在 值 是 16 位 无 符号 整数 。 
E.19.3.13.1. 安全 
e 添加 contrib/sepgsql 连接 与 SELinux 的 权限 检查 (KaiGai Kohei) 
这 使 用 新 的 sEcuRITY LABEL 功能 。 
e 添加 contrib 模 块 auth_delay (KaiGai Kohei) 
在 返回 认证 失败 之 前 导致 服务 器 暂停 ; 设计 它 使 得 蛮 力 密码 攻击 更 加 困难 。 
e 添加 dummy seclabel contrib 模 块 (KaiGai Kohei) 
这 用 于 允许 回 为 测试 。 
E.19.3.13.2. 性 能 
e 添加 支持 LIke and rike 索引 搜索 到 contrib/pg_trgm (Alexander Korotkov) 


° 添加 levenshtein_less_equal() BESES contrib/fuzzystrmatch , 这 是 对 小 距离 的 优化 
(Alexander Korotkov) 


e 提高 contrib/seg 上 索引 查找 性 能 (Alexander Korotkov) 
。 提高 许多 关系 数据 库 pg_upgrade 的 性 能 (Bruce Momjian) 


e 添加 标记 到 contrib/pgbench 以 报告 每 个 语句 延迟 (Florian Pflug) 


E.19.3.13.3. Fsync 测 试 
© 移动 src/tools/test_fsync 到 contrib/pg_test_fsync (Bruce Momjian, Tom Lane) 
e 添加 o DIRECT 支持 到 contrib/pg_test_fsync (Bruce Momjian) 
这 匹配 通过 wal_sync_method 的 0_DIRECT 的 使 用 。 


e 添加 新 的 测试 给 contrib/pg_test_fsync (Bruce Momjian) 


E.19.3.14. 文档 


e 广泛 的 ECPG 文档 改进 (Satoshi Nagayasu) 
。 广泛 的 校对 和 文档 改进 (Thom Brown, Josh Kupershmidt, Susanne Ebrecht) 
e 为 exit_on_error 添加 文档 (Robert Haas) 
这 个 参数 导致 会 话 有 任何 错误 就 退出 。 
e 为 pg_options_to_table() 添加 文档 (Josh Berkus) 
这 个 画 数 显示 了 可 读 形 式 中 表 存 储 选 项 。 
。 文档 可 以 访问 使 用 (compositeval).* 语法 的 所 有 复合 类 型 字段 (Peter Eisentraut) 
e 文档 translate() 删除 没有 相应 的 to 字符 的 from 中 字符 (Josh Kupershmidt) 
e 为 CREATE CONSTRAINT TRIGGER 和 CREATE TRIGGER 合并 文档 (Alvaro Herrera) 
e 集中 权限 和 升级 文档 (Bruce Momjian) 
e 为 Solaris 10 添 加 内 核 调整 记录 (Josh Berkus) 
先前 只 有 Solaris 9 内 核 调 整 被 记录 。 
e 一 致 地 处理 History 文件 中 的 非 ASCIIl 字 符 (Peter Eisentraut) 


当 HISToRY 文件 是 英语 ， 我 们 必须 处 理 参 与 者 名 字 中 非 ASCIl 字 母 。 这 些 目前 是 音译 
的 ， 因此 它们 没有 关于 字符 集 假设 相当 易 读 。 


E.20. 版 本 9.0.14 


发 布 日 期 : 2013-10-10 


这 个 版 本 包含 各 种 自 9.0.13 以 来 的 修复 。 想 要 获得 关于 9.0 主 版 本 的 新 特性 信息 ， 请 参 
阅 Section E.34。 


E.20.1. 迁移 到 版 本 9.0.14 


运行 9.0.X 的 系统 不 需要 转 储 /恢复 。 


另外 ， 如 果 你 是 从 一 个 早 于 9.0.6 的 版 本 升级 而 来 ， 请 参阅 9.0.6 的 版 本 说 明 。 


E.20.2. 修改 列表 


。 阻止 多 字 节 编码 中 非 ASCIl 非 双 引 号 的 标识 符 的 小 写 转 换 (Andrew Dunstan) 
先前 的 行为 是 错误 并 且 混 乱 的 。 

e 修复 wal_level = hot_standby 时 后 台 写 作 检查 点 内 存 泄露 (Naoya Anzai) 

。 修复 10_open() 失败 导致 的 内 存 泄露 (Heikki Linnakangas) 

。 修复 work_mem 使 用 超过 24GB 内 存 的 内 存 过 度 使 用 错误 (Stephen Frost) 

。 修复 libpq SSL 死 锁 错 误 (Stephen Frost) 

。 修复 线程 libpq 应 用 程序 中 可 能 的 SSL 网 络 堆栈 损坏 (Nick Phillips, Stephen Frost) 

。 适当 的 计算 包含 许多 NULL 值 的 布尔 字段 的 行 估计 (Andrew Gierth) 


以 前 的 文本 ， 像 col IS NOT TRUE 和 col Is NoT FALSE ， 在 估计 规划 开销 时 并 不 能 适当 
的 包括 进 NULL 值 中 。 


e AIFS wer 子 句 下 推 到 不 安全 的 UNION/INTERSECT 子 查询 中 (Tom Lane) 
先前 这 样 的 下 推 可 能 产生 错误 。 

。 修复 不 适当 的 处 理 数据 类 型 修改 引起 的 稀有 的 GRouP BY 查询 错误 (Tom Lane) 

。 人 多 许 视图 转 储 代码 在 基 表 上 更 好 的 义理 已 删除 的 字段 (Tom Lane) 

e 适当 的 记录 用 untque 和 primary KEY 语法 创建 的 索引 注释 (Andres Freund) 


这 修复 了 一 个 并 行 的 pg_restore 错 误 。 


修复 了 REINDEX TABLE 和 REINDEX DATABASE , 以 正确 的 使 约束 重新 生效 ， 并 且 标 记 无 效 
的 索引 为 有 效 (Noah Misch) 


REINDEX INDEX 总 是 正常 工作 。 

修复 并 发 CREATE INDEX CONCURRENTLY 操作 期 间 可 能 的 死 锁 (Tom Lane) 

修复 regexp_matches() XES KEH (Jeevan Chalke) 

以 前 ， 像 个 这 样 的 需 长 度 匹 配 可 能 返回 很 多 匹配 。 

修复 过 度 复 杂 的 正则 表达 式 的 崩溃 (Heikki Linnakangas) 

修复 正则 表达 式 逆 向 引用 和 非 贪 禁 量词 结合 的 匹配 错误 (Jeevan Chalke) 

阻止 cREATE FUNCTION 检查 SET 变量 ， 除 非 启 用 函数 体检 查 (Tom Lane) 

人 允许 ALTER DEFAULT PRIVILEGES 在 模式 上 操作 ， 不 需要 CREATE 权 限 (Tom Lane) 
放松 了 在 查询 上 使 用 的 关键 字 的 限制 (Tom Lane) 

特别 的 ， 减 少 了 角色 名 、 语 言 名 、 EXPLAIN 和 copy 操作 、 还 有 ser 值 的 关键 字 的 限 


制 。 这 人 允许 COPY ... (FORMAT BINARY) 以 前 的 BINARY 需要 单 引 号 。 

修复 了 pgp_pub_decrypt() ， 这 样 它 为 带 有 口令 的 秘 钥 工 作 (Marko Kreen) 

删除 缺少 素 引 的 表 vacuum 期 间 稀 有 的 不 准确 的 警告 (Heikki Linnakangas) 
改善 取消 文件 截断 请 求 之 后 的 分 析 统 计 的 生成 (Kevin Grittner) 

避免 在 预备 查询 中 执行 事务 控制 命令 时 可 能 的 错误 (如 ROLLBACK) (Tom Lane) 
允许 在 所 有 平台 上 无 穷 的 各 种 拼写 (Tom Lane) 

支持 的 无 穷 的 值 是 "inf', "tint", "-inf", "infinity", "+infinity", #0 "-infinity". 

扩张 比较 行 的 能 力 到 记录 和 数组 (Rafal Rzepecki, Tom Lane) 


更 新 时 区 数据 文件 到 tzdata 版 本 2013d， 因 为 DST 规 律 在 lsrael, Morocco, Palestine, 
Paraguay 方 面 改变 了 。 另 外 ，Macquarie Island 历史 时 区 数据 纠正 (Tom Lane) 


E.21. 版 本 9.0.13 


发 布 日 期 : 2013-04-04 


这 个 版 本 包含 各 种 自 9.0.12 以 来 的 修复 。 想 要 获得 关于 9.0 主 版 本 的 新 特性 信息 ， 请 参 
阅 Section E.34。 


E.21.1. 迁移 到 版 本 9.0.13 


运行 9.0.X 的 系统 不 需要 转 储 /恢复 。 


不 过 ， 这 个 版 本 纠正 了 几 个 管理 GiST 素 引 的 错误 。 在 安装 这 个 更 新 之 后 ， 建议 REINDEX 任意 
满足 一 个 或 多 个 下 面 描述 的 条 件 的 GiST 素 引 。 


另外 ， 如 果 你 是 从 一 个 早 于 9.0.6 的 版 本 升级 而 来 ， 请 参阅 9.0.6 的 版 本 说 明 。 


E.21.2. 修改 列表 


。 修复 了 不 安全 的 服务 器 命令 行 开关 的 分 析 (Mitsumasa Kondo, Kyotaro Horiguchi) 
一 个 包含 数据 库 名 的 连接 请 求 以 " - “开始 有 可 能 被 破坏 ， 或 破坏 服务 器 的 数据 目录 中 的 
文件 ， 即 使 最 终 拒绝 了 该 请 求 。 (CVE-2013-1899) 

。 在 每 个 postmaster 子 进程 中 重症 OpenSSL 随 机 状态 (Marko Kreen) 


这 避免 了 contrib/pgcrypto AX MA REALAUIER A D a — SEE EB 户 猜 到 的 情况 。 
该 风险 只 在 postmaster 用 ssl = on 配置 但 是 大 多 数 连接 不 使 用 SSL 加 密 时 是 重要 的 。 
(CVE-2013-1900) 

。 修复 了 GIiST 素 引 在 不 适当 的 时 候 不 使 用 "fuzzy" 几 何 比 较 (Alexander Korotkov) 


核心 几何 类 型 执行 比较 使 用 "fuzzy" 相 等 ， 但 是 gist_box_same 必须 做 精确 的 比较 ， 否则 
GiST 使 用 它 索 引 可 能 变 成 不 一 致 的 。 在 安装 这 个 更 新 之 后 ， 用 户 应 该 REINDEX 在 box, 
polygon , circle ,或 point 字段 之 上 的 任何 GiST 索 引 ， 因为 所 有 这 些 索引 都 使 


用 gist_box_same o 


e 修复 为 变量 范围 的 数据 类 型 使 用 contrib/btree_gist 的 错误 的 范围 联合 和 GiST 索 引 中 的 
处 罚 逻 辑 ， 这 些 是 text, bytea, bit , 和 numeric 字段 (Tom Lane) 


这 些 错 误 可 能 导致 不 一 致 的 索引 ， 使 某 些 现 有 的 键 不 能 被 搜索 到 ， 和 无 用 的 索引 膨胀 。 
建议 用 户 在 安装 这 个 更 新 之 后 REINDEX 这 样 的 索引 。 


。 修复 多 字段 素 引 的 GiST 页 分 裂 代 码 中 的 错误 (Tom Lane) 


这 些 错 误 可 能 导致 不 一 致 的 索引 ， 使 某 些 现 有 的 键 不 能 被 搜索 到 ， 和 索引 中 不 需要 的 无 
效 搜 索 。 建议 用 户 在 安装 这 个 更 新 之 后 REINDEX 多 字段 GiST 素 引 。 


修复 gist_point_consistent 处 理 模 糊 一 致 (Alexander Korotkov) 


Gist 索 引 在 point 字段 上 的 索引 扫描 可 能 有 时 产生 不 同 于 顺序 扫描 的 结果 ， 
为 gist_point_consistent 与 潜在 的 操作 符 代 码 关 于 是 否 做 比较 或 模糊 不 一 致 。 


修复 WAL 重 放 中 的 缓冲 区 泄露 (Heikki Linnakangas) 
这 个 错误 可 能 导致 重 放 期 间 的 "incorrect local pin count" 错 误 ， 使 恢复 成 为 不 可 能 。 
修复 DELETE RETURNING 中 的 竞 态 条 件 (Tom Lane) 


在 正确 的 情况 下 ， DELETE RETURNING 可 以 尝试 从 当前 进程 不 再 有 任何 pin 的 共享 缓冲 区 获 
取 数 据 。 如 果 同 时 其 他 的 进程 改变 了 该 缓冲 区 ， 那 么 会 导致 垃圾 RETURNING 输出 ， 或 者 


HERRAR 

修复 正则 表达 式 编 译 中 无 限 循环 的 风险 (Tom Lane, Don Porter) 
修复 正则 表达 式 编译 中 潜在 的 空 指 针 解 除 参 照 (Tom Lane) 

修复 to_char() 在 适当 的 地 方 只 使 用 ASCII 小 写 化 规则 (Tom Lane) 


这 个 修复 了 一 些 应 该 环境 独立 的 临时 模式 的 错误 行为 ， 但 是 在 Turkish 环 境 中 错误 操作 
" I "和 和" i p 


(SS TF ARB BAYA 1) Bi 1999-12-31 24:00:00 的 拒绝 
修复 了 一 个 单一 事务 做 uNLISTEN 然后 Listen 的 逻辑 错误 (Tom Lane) 
该 会 话 一 点 也 不 监听 通知 事件 ， 尽 管 它 在 这 种 情况 下 很 确定 的 应 该 监听 。 


删除 没有 用 的 "picksplit doesn't support secondary split" 日 志 消 息 (Josh Hansen, Tom 
Lane) 


这 个 消息 看 起 来 已 经 添加 到 了 从 没有 写 过 的 期 望 代码 ， 并 且 可 能 永远 不 写 ， 因为 GiST 的 
二 次 分 裂 的 缺 省 处 理 实际 上 非常 好 。 所 以 停止 给 最 终 用 户 说 这 个 。 


修复 可 能 的 错误 : 发 送 会 话 的 最 后 几 个 事务 提交 /终止 计数 到 统计 收集 器 (Tom Lane) 
消除 PL/Perl 的 spi_prepare() 加 数 中 的 内 存 泄露 (Alex Hunsaker, Tom Lane) 

修复 pg_dumpall 处 理 正确 的 包含" = "的 数据 库 名 (Heikki Linnakangas) 

当 给 出 不 正确 的 连接 字符 串 时 避免 pg_dump 中 的 崩溃 (Heikki Linnakangas) 


忽略 pg_dump 和 pg_upgrade 中 无 效 的 索引 (Michael Paquier, Bruce Momjian) 


转 储 无 效 的 索引 会 在 恢复 时 导致 问题 ， 例 如 ， 如 果 索 引 创建 失败 的 原因 是 因为 它 试 图 通 
过 表 的 数据 强制 一 个 不 合适 的 唯一 条 件 。 还 有 ， 如 果 索 引 创 建 实 际 上 仍 在 进行 ， 那 么 认 
为 这 是 一 个 未 提交 的 DDL 变 化 看 起 来 是 合理 的 ， pg_dump 无 论 如 何 也 不 会 转 储 。 
pg_upgrade 现在 也 跳 过 无 效 的 索引 而 不 是 失败 。 


修复 contrib/pg_trgm 的 similarity() HRM, 使 其 为 trigram-less 字 符 串 返回 0 (Tom 
Lane) 


以 前 因为 内 部 除 需 ， 它 返回 nan o 


更 新 时 区 数据 文件 为 tzdata 版 本 2013b， 为 DST 规 律 在 Chile, Haiti, Morocco, Paraguay, 
和 一 些 Russian 地 区 的 改变 。 还 有 ， 为 许多 地 区 修正 历史 的 时 区 数据 。 


还 有 ， 为 在 Russia 和 其 他 地 方 里 的 最 近 的 改变 更 新 时 区 缩写 文件 : CHOT, GET, IRKT, 
KGT ，KRAT ，MAGT ，MAWT ，MSK ，NOVT ，OMST ，TKT ，VLAT ，WST ，YAKT ，YEKT 现在 
跟随 它们 的 当前 含义 ， voLT (Europe/Volgograd) 和 mIsT (Antarctica/Macquarie) 添 加 
到 了 缺 省 的 缩写 列表 。 


E.22. 版 本 9.0.12 


发 布 日 期 : 2013-02-07 


这 个 版 本 包含 各 种 自 9.0.11 以 来 的 修复 。 想 要 获得 关于 9.0 主 版 本 的 新 特性 信息 ， 请 参 
阅 Section E.34。 


E.22.1. 迁移 到 版 本 9.0.12 


运行 9.0.X 的 系统 不 需要 转 储 /恢复 。 


另外 ， 如 果 你 是 从 一 个 早 于 9.0.6 的 版 本 升级 而 来 ， 请 参阅 9.0.6 的 版 本 说 明 。 


E.22.2. 修改 列表 


e 阻止 SQL 执行 enum_recv (Tom Lane) 


该 画 数 是 错误 声明 的 ， 罗 许 一 个 简单 的 SQL 命令 使 服务 器 骨 溃 。 原 则 上 ， 攻击 者 可 以 使 
用 它 检 验 服 务 器 内 存 的 内 容 。 感 谢 Sumit Soni (via Secunia SVCRP) 报告 这 个 问题 。 
(CVE-2013-0255) 


。 修复 在 WAL 回 放 期 间 已 经 达到 一 个 一 致 的 数据 库 状 态 时 检测 的 多 重 问题 (Fujii Masao, 
Heikki Linnakangas, Simon Riggs, Andres Freund) 


。 截断 一 个 关系 文件 时 更 新 最 小 的 恢复 点 (Heikki Linnakangas) 
一 旦 数据 被 丢弃 ， 在 时 间 线 中 的 一 个 较 早 的 点 停止 恢复 已 经 不 再 安全 。 
。 修复 热 各 份 模式 中 丢失 的 取消 (Noah Misch, Simon Riggs) 
有 时 会 错过 取消 冲突 的 热 各 份 查询 的 需要 ， 此 时 允许 这 些 查 询 看 到 不 一 致 的 数据 。 
。 修复 SQL 语 法 允许 一 个 子 SELECT 结 果 加 下 标 或 字段 选择 (Tom Lane) 
。 修复 繁忙 的 工作 负载 中 自动 清理 截断 的 性 能 问题 (Jan Wieck) 


在 一 个 表 的 最 后 截断 空白 页 需要 排他 锁 ， 但 是 当 有 冲突 的 锁 请 求 时 autovacuum 编 码 失败 

(并 释放 表 锁 ) 。 负载 过 轻 ， 很 有 可 能 不 会 发 生 截断 ， 导 致 表 膨 胀 。 通 过 执行 一 个 部 分 
的 截断 ， 释 放 该 锁 ， 然后 尝试 再 次 请 求 这 个 锁 并 继续 来 修复 这 个 问题 。 这 个 修复 也 大 大 
的 减少 了 autovacuum 释放 该 锁 之 前 冲突 的 锁 请 求 到 达 之 后 的 平均 时 间 。 


e 7448 pg_tablespace 时 防止 竞 态 条 件 (Stephen Frost, Tom Lane) 


如 果 CREATE DATABASE 和 DROP DATABASE 并 发 的 更 新 pg_tablespace 记录 ， 那 么 它们 可 能 
行为 错误 。 


阻止 prop owen 试图 删除 整个 数据 库 或 表 空 间 (Alvaro Herrera) 
为 了 安全 ， 这 些 对 象 的 所 有 权 必 须 重 新 分 配 ， 而 不 是 抛弃 。 
修复 vacuum_freeze_table age 实现 中 的 错误 (Andres Freund) 


在 有 多 于 vacuum freeze min age 个 事务 存在 的 安装 中 ， 这 个 错误 阻止 使 用 部 分 表 扫 描 的 
autovacuum， 所 以 全 表 扫 描 将 总 是 发 生 。 


阻止 RowExpr 或 xmlExpr 解析 分 析 两 次 时 的 错误 行为 (Andres Freund, Tom Lane) 
这 个 错误 在 内 容 中 可 能 是 用 户 可 见 的 ， 如 CREATE TABLE LIKE INCLUDING INDEXES o 
提高 哈 希 表 大 小 计算 中 的 整数 浴 出 防御 (Jeff Davis) 

拒绝 to_date() 中 超出 范围 的 日 期 (Hitoshi Harada) 


确保 非 ASCII 提 示 字 符 串 在 Windows 上 转化 为 正确 的 代码 页 (Alexander Law, Noah 
Misch) 


这 个 错误 影响 psql 和 一 些 其 他 客户 端 程序 。 

修复 没有 连接 到 一 个 数据 库 时 psql 的 \? 命令 中 可 能 的 骨 溃 (Meng Qingzhong) 
修复 pg_upgrade 安 全 的 义理 无 效 的 索引 (Bruce Momjian) 

修复 libpq 的 poprinttuples 中 的 一 个 字 节 缓冲 区 浴 出 (Xi Wang) 

这 个 古老 的 函数 PostgreSQL 本 身 已 经 不 用 了 ， 但 是 一 些 客 户 端 代 码 可 能 仍然 在 使 用 。 
使 ecpglib 适 当 的 使 用 翻译 了 的 信息 (Chen Huajun) 

在 MSVC 上 适当 的 安装 ecpg_compat 和 pgtypes (Jiang Guiqing) 

在 libecpg 中 包括 我 们 的 isinf() 版 本 ， 如 果 系 统 没 有 提供 它 (Jiang Guiging) 


为 提供 的 函数 重新 排列 配置 的 测试 ， 这 样 它 不 会 被 来 自 libedit/libreadline 的 虚假 报告 欺骗 
(Christoph Berg) 


确保 Windows 建 立 编号 在 时 间 上 增加 (Magnus Hagander) 


当 在 Windows 上 交叉 编译 时 ， 使 带 有 正确 .exe 后 级 的 pgxs 建 立 可 执行 (Zoltan 
Boszormenyi) 


添加 新 的 时 间 惟 缩写 FET (Tom Lane) 


这 个 现在 用 于 一 些 东 欧 时 区 。 


E.23. 版 本 9.0.11 


发 布 日 期 : 2012-12-06 


这 个 版 本 包含 各 种 自 9.0.10 以 来 的 修复 。 想 要 获得 关于 9.0 主 版 本 的 新 特性 信息 ， 请 参 
阅 Section E.34。 


E.23.1. 迁移 到 版 本 9.0.11 


运行 9.0.X 的 系统 不 需要 转 储 /恢复 。 
另外 ， 如 果 你 是 从 一 个 早 于 9.0.6 的 版 本 升级 而 来 ， 请 参阅 9.0.6 的 版 本 说 明 。 


E.23.2. 修改 列表 


。 修复 了 多 个 与 cREATE INDEX CONCURRENTLY 相关 的 错误 (Andres Freund, Tom Lane) 


修复 CREATE INDEX CONCURRENTLY 以 在 改变 一 个 索引 的 pg_index 行 的 状态 时 使 用 按照 地 点 
的 更 新 。 这 阻止 了 会 导致 并 发 会 话 错 过 更 新 目标 索引 的 竞 态 条 件 ， 因此 导致 损坏 并 发 创 
建 的 索引 。 


另外 ， 修 复 了 各 种 其 他 操作 ， 以 保证 它们 忽略 失败 的 CREATE INDEX CONCURRENTLY 命令 产 
生 的 无 效 的 索引 。 最 重要 的 是 vAcuum ， 因为 在 采取 正确 的 动作 修复 或 删除 无 效 的 索引 之 
前 ， 一 个 auto-vacuum 可 以 很 容易 的 在 一 个 表 上 发 起 。 


。 修复 WAL 重 放 期 间 的 缓冲 区 锁定 (Tom Lane) 


当 重 放 WAL 记 录影 响 多 于 一 页 时 ，WAL 重 放 代 码 关 于 锁定 缓冲 区 不 够 小 心 。 这 会 导致 热 
备份 查询 短暂 的 看 到 不 一 致 的 状态 ， 导 致 错误 响应 或 意外 的 失败 。 


。 修复 在 GIN 索 引 的 WAL 生 产 逻 辑 中 的 一 个 错误 (Tom Lane) 
如 果 发 生 页 撕 裂 错误 ， 这 会 导致 索引 损坏 。 

。 当 推 进 热 备份 服务 器 正常 运行 时 ， 适 当 的 删除 启动 进程 的 虚拟 XID 锁 (Simon Riggs) 
这 个 监管 可 以 阻止 特定 操作 (如 CREATE INDEX CONCURRENTLY ) 的 连续 执行 。 

。 避免 各 用 模式 中 虚假 的 "out-of-sequence timeline ID" 错 误 (Heikki Linnakangas) 

。 阻止 postmaster 在 收 到 关闭 信号 后 发 起 新 的 子 进程 (Tom Lane) 
这 个 错误 能 引起 关闭 的 时 间 更 长 ， 黄 至 在 没有 额外 的 用 户 动作 下 永 不 完成 。 


避免 内 存 浴 出 时 内 部 哈 希 表 的 损坏 (Hitoshi Harada) 
修复 外 连接 上 非 绝对 相等 子 句 的 规划 (Tom Lane) 


该 规划 会 导致 不 正确 的 约束 : 一 个 子 句 等 于 一 个 其 他 非 绝对 构造 ， 例 如 
WHERE COALESCE(foo, 0) = 0, ， 当 foo 来 自 一 个 外 连接 的 可 为 null 方 时 。 


改善 规划 的 能 力 ， 检 验 来 自 相 等 子 句 的 排他 约束 (Tom Lane) 
修复 散 列 的 子规 划 中 的 部 分 行 匹 配 ， 正 确 的 处 理 交 叉 类 型 情况 (Tom Lane) 


这 个 影响 多 字段 NoT IN 子规 划 ， 如 WHERE (a, b) NOT IN (SELECT x, y FROM ...) 
A b 和 y 分 别 是 inta 和 ints 的 情况 。 这 个 错误 导致 错误 响应 或 骨 溃 依赖 于 特定 包含 
的 数据 类 型 。 


当 为 一 个 AFTER ROW UPDATE/DELETE 触发 器 重新 抓 取 老 的 元 组 时 获得 缓冲 区 锁 (Andres 
Freund) 


在 不 寻常 的 情况 下 ， 这 个 下 忽 会 导致 外 键 强制 触发 器 传送 不 正确 的 数据 到 预先 检查 逻 
He 这 样 会 导致 一 个 崩溃 ， 或 一 个 关于 是 否 触发 该 触发 器 的 不 正确 的 决定 。 


修复 ALTER COLUMN TYPE 正确 的 处 理 非 继 承 的 检查 约束 (Pavan Deolasee) 
这 在 8.4 之 前 的 版 本 中 运行 正确 ， 现 在 在 8.4 和 之 后 的 版 本 中 也 正确 运行 了 
修复 REASSIGN OWNED 处 理 表 空间 上 的 授权 (Alvaro Herrera) 

为 视图 系统 字段 忽略 不 正确 的 pg_attribute 条 目 (Tom Lane) 


视图 没有 任何 系统 字段 。 不 过 ， 我 们 在 转换 一 个 表 到 一 个 视图 时 忘记 删除 这 样 的 条 目 。 
这 在 9.3 和 之 后 的 版 本 中 适当 的 修复 了 ， 但 是 ， 在 之 前 的 分 支 中 我 们 需要 防卫 现存 的 错误 
转换 的 视图 。 


修复 规则 打印 以 正确 的 转 储 INSERT INTO _table_ DEFAULT VALUES (Tom Lane) 

当 在 一 个 查询 中 有 太 多 uno / INTERSECT / except 子 句 时 ， 防 止 堆栈 浴 出 (Tom Lane) 
当 用 -1 除 最 小 可 能 的 整数 时 ， 阻 止 依赖 于 平台 的 失败 (Xi Wang, Tom Lane) 
修复 日 期 解析 中 可 能 的 以 字符 串 结束 的 存 取经 过 (Hitoshi Harada) 


修复 在 检查 点 和 wal_level 是 hot_standby 期 间 ， 如 果 发 生 XID 打 包 未 能 提前 XID 纪 元 的 
错误 (Tom Lane, Andres Freund) 


个 错误 对 PostgreSQL 本 身 没有 特别 的 影响 ， 不 利于 依赖 于 txid_current() RIFE KX 
eo ore a ee 


如 果 一 个 Unix 域 套 接 字 的 路 径 名 长 度 超出 平台 特定 的 限制 ， 则 产生 一 个 可 以 理解 的 错误 


信息 (Tom Lane, Andrew Dunstan) 


以 前 ， 这 会 产生 相当 没有 帮助 的 事物 ， 如 "Non-recoverable failure in name resolution". 
修复 发 送 复 合 字段 值 到 客户 端 时 的 内 存 泄露 (Tom Lane) 

使 pg_ctl 读 取 postmaster.pid 文件 更 强健 (Heikki Linnakangas) 

修复 竞 态 条 件 和 可 能 的 文件 描述 符 泄 露 。 


修复 psql 中 可 能 的 朋 渍 ， 如 果 提 出 了 不 正确 编码 的 数据 和 client_encoding 设置 是 一 个 客 
户 端 唯一 编码 (如 SJIS) (Jiang Guiqing) 


修复 restore.sql 脚本 中 的 错误 ， 该 脚本 由 pg_dump 以 tar 输出 格式 发 出 (Tom Lane) 


该 脚本 在 名 字 包 含 大 写字 母 的 表 上 将 会 完全 的 失败 。 另外， 使 得 该 脚本 可 以 
在 --inserts 模式 和 定期 的 COPY 模 式 中 存储 数据 。 


修复 pg_restore 接 受 符合 POSIX 的 tar 文件 (Brian Weaver, Tom Lane) 


pg_dump 的 tar 输出 模式 的 原始 编码 产生 的 文件 并 不 完全 符合 POSIX 标 准 。 这 在 版 本 
9.3 中 已 经 纠正 了 。 这 个 补丁 更 新 之 前 的 分 支 ， 所 以 它们 将 接受 正确 和 不 正确 的 格式 ， 希 
望 9.3 出 来 时 避免 兼容 性 问题 。 


修复 pg_resetxlog 以 正确 的 定位 postmaster.pid ， 当 给 出 一 个 相关 的 路 径 到 数据 目录 时 
(Tom Lane) 


这 个 错误 会 导致 pg_resetxlog 不 注意 这 里 有 一 个 活动 的 postmaster 使 用 该 数据 目录 。 
修复 libpq 的 lo_import() 和 lo_export() 画 数 以 适当 的 报告 文件 MO 错误 (Tom Lane) 
修复 ecpg 族 套 结构 指针 变量 的 流程 (Muhammad Usama) 

修复 ecpg 的 ecpg_get_data 函数 正确 的 处 理 数 组 (Michael Meskes) 

使 contrib/pageinspect 的 btree 页 面 检 查 辑 数 在 检查 页 面 时 获得 缓冲 区 锁 (Tom Lane) 
修复 pgxs 支 持 以 在 AIX 上 建立 可 加 载 的 模块 (Tom Lane) 

在 不 在 AlX 上 运行 的 原始 源 代码 树 之 外 建立 模块 。 


更 新 时 区 数据 文件 到 tzdata 版 本 2012j， 因 为 DST 规 律 在 下 列 地 区 改变 了 : Cuba, Israel, 
Jordan, Libya, Palestine, Western Samoa, 还 有 部 分 Brazil。 


E.24. 版 本 9.0.10 


发 布 日 期 : 2012-09-24 


这 个 版 本 包含 各 种 自 9.0.9 以 来 的 修复 。 想 要 获得 关于 9.0 主 版 本 的 新 特性 信息 ， 请 参 
阅 Section E.34。 


E.24.1. 迁移 到 版 本 9.0.10 


运行 9.0.X 的 系统 不 需要 转 储 /恢复 。 
另外 ， 如 果 你 是 从 一 个 早 于 9.0.6 的 版 本 升级 而 来 ， 请 参阅 9.0.6 的 版 本 说 明 。 


E.24.2. 修改 列表 


。 修复 规划 者 的 执行 者 参数 的 分 配 ， 修 复 执 行者 为 CTE 规 划 节 点 的 重新 打 描 逻辑 (Tom 
Lane) 


IIE 


错误 会 导致 查询 的 错误 响应 ， 使 得 扫描 多 次 相同 的 with 子 查询 。 


ki 


。 YSGISTRS| FN n MDA RE (Alexander Korotkov, Robert Haas, Tom Lane) 
由 于 这 个 错误 ， 多 字段 GiST 素 引 可 能 遭受 意外 的 膨胀 。 
。 如 果 仍 然 持 有 权限 ， 修 复 级 联 权限 撤销 停止 (Tom Lane) 


如 果 我 们 从 一 些 角色 x 撤销 授予 选项 ， 但 是 x 通过 来 自 其 他 的 授予 仍然 持 有 这 个 选 
项 ， 我 们 不 应 该 递 轨 的 从 x 授予 的 角色 v 撤销 相应 的 权限 。 


。 改善 热 各 份 错误 配置 错误 的 错误 消息 (Gurjeet Singh) 
。 修复 使 用 PL/Perl 时 的 sierpe 的 义理 (Andres Freund) 


Perl 重 置 进 程 的 st6FPE 处 理 器 为 sI Ia, 这 个 稍 后 会 导致 月 溃 。 在 初始 化 PL/Perl 之 
后 恢复 正常 的 Postgres 信 号 处 理 器 。 


。 如 果 递 轨 的 PL/Perl 函 数 在 执行 时 被 重新 定义 ， 那 么 阻止 PL/Perl 崩 淡 (Tom Lane) 
。 绕 开 PL/Perl 中 可 能 的 错误 最 优化 (Tom Lane) 


一 些 Linux 发 布 包含 一 个 不 正确 的 pthread.h 版 本 ， 导致 PL/Perl 中 不 正确 的 编译 代码 ， 如 
果 PL/Perl 范 数 调用 另 一 个 抛 出 一 个 错误 的 函数 ， 会 导致 朋 渍 。 


e 修复 Windows 上 pg_upgrade 钦 理 行 尾 结束 符 (Andrew Dunstan) 


LART, pg_upgradeF] Be 4s 00S MERE + Byte SA 
e 在 Windows 上 ，pg_upgrade 在 它 发 出 的 脚本 里 使 用 反 斜 杠 路 径 分 隔 符 (Andrew Dunstan) 


。 更 新 时 区 数据 文件 到 tzdata 版 本 2012f， 因 为 DST 规 律 在 Fiji 改 变 了 。 


E.25. 版 本 9.0.9 


发 布 日 期 : 2012-08-17 


这 个 版 本 包含 各 种 自 9.0.8 以 来 的 修复 。 想 要 获得 关于 9.0 主 版 本 的 新 特性 信息 ， 请 参 
阅 Section E.34。 


E.25.1. 迁移 到 版 本 9.0.9 


运行 9.0.X 的 系统 不 需要 转 储 /恢复 。 


另外 ， 如 果 你 是 从 一 个 早 于 9.0.6 的 版 本 升级 而 来 ， 请 参阅 9.0.6 的 版 本 说 明 。 


E.25.2. 修改 列表 


阻止 通过 XML 实 体 引 用 访问 外 部 文件 /URL (Noah Misch, Tom Lane) 


xml_parse() 将 尝试 获取 解决 在 XM 值 中 引用 的 DTD 和 实体 所 需要 的 外 部 文件 或 URL， 
此 人 允许 非特 权 数 据 库 用 户 使 用 数据 库 服务 器 的 权限 尝试 获取 数据 。 但 是 外 部 数据 不 会 直 
接 返 回 给 用 户 ， 如 果 该 数据 不 可 以 解析 为 合法 的 XML， 则 它 的 一 部 分 会 以 错误 消息 的 方 
AIE ; 并 且 在 任何 情况 下 ， 仅仅 能 够 检查 文件 的 存在 可 能 对 一 个 攻击 者 有 用 。(CVE- 

2012-3489) 


阻止 通过 contrib/xml2 的 xslt_process() 访问 外 部 文件 /URL (Peter Eisentraut) 


libxslt 提 供 通过 样式 表 命 令 读 写 文 件 和 URL 的 能 力 ， 因此 允许 非特 权 的 数据 库 用 户 使 用 数 
据 库 服务 器 的 权限 读 写 数据 。 通过 适当 的 使 用 libxslt 的 安全 选项 禁用 该 功能 。 (CVE- 
2012-3488) 


另外 ， 删 除 xslt_process() 从 外 部 文件 /URL 获 取 文 档 和 样式 表 的 能 力 。 虽然 这 是 记录 中 
的 "特性 "， 但 是 它 状 期 被 认为 是 一 个 坏 的 想法 。 CVE-2012-3489 修 复 打 破 了 这 个 能 力 ， 
并 且 与 其 花费 时 间 党 试 修复 它 ， 不 如 立刻 删除 它 。 


阻止 btree 索 引 页 过 早 的 回收 (Noah Misch) 


当 我 们 允许 只 读 事务 跳 过 设 定 XID 时 ， 我 们 引入 了 已 删除 的 btree 索 引 页 可 以 被 回收 的 可 
能 性 ， 而 一 个 只 读 事务 仍然 在 该 索引 页 中 运行 。 这 可 能 会 导致 不 正确 的 索引 搜索 结果 。 
这 样 一 个 错误 发 生 在 字段 中 的 可 能 性 因为 计时 要 求 看 起 来 非常 低 ， 但 是 ， 尽 管 如 此 也 应 
该 修复 它 。 


。 用 新 创建 的 或 重新 设置 的 序列 修复 月 渍 安全 bug (Tom Lane) 


如 果 ALTER sequence 在 一 个 新 创建 的 或 重 置 的 序列 上 执行 ， 并 且 正 好 在 它 上 面 有 一 

个 nextval() 调用 ， 那 么 然后 服务 器 崩溃 了 ， WAL 重 放 将 恢复 该 序列 到 nextval() 还 没 
有 做 的 那个 状态 ， 因 此 人 允许 第 一 个 序列 值 再 次 被 下 一 个 nextval() 调用 返回 。 特别 的 ， 
这 会 为 serial 列 显示 ， 因 为 串 行 列 序列 的 创建 包括 一 个 ALTER SEQUENCE OWNED BY 步 
又 。 


修复 txid_current() ， 当 不 是 在 热 各 时 报告 正确 的 纪元 (Heikki Linnakangas) 

这 个 修复 了 前 一 个 小 版 本 中 引入 的 回 为 。 

修复 热 各 启动 里 的 bug， 当 一 个 主要 事务 有 许多 子 事务 时 (Andres Freund) 

这 个 错误 导致 和 "out-of-order XID insertion in KnownAssignedXids" 一 样 的 失败 报告 。 
确保 backup_label 文件 在 pg_start_backup() 之 后 是 同步 的 (Dave Kerr) 

修复 walsender 进 程 中 的 超时 义理 (Tom Lane) 


WAL 发 送 后 端 进程 忽略 了 建立 一 个 SIGALRM 义 理 器 ， 意味 着 它们 在 一 些 极端 情况 下 将 一 
直 等 待 ， 而 这 种 情况 应 该 发 生 的 是 超时 。 


改善 Back-patch 9.1 以 压缩 同步 请 求 队列 (Robert Haas) 
这 提高 了 检查 点 期 间 的 性 能 。 该 9.1 改 变现 在 看 起 来 对 于 back-patch 字 段 测 试 足够 安全 。 
修复 LISTEN / NoTIFY 以 更 好 的 义理 MO 问题 ， 例如 超出 磁盘 空间 (Tom Lane) 


在 写 入 失败 之 后 ， 所 有 随后 发 送 更 多 NoTIFY 信息 的 尝试 都 将 失败 ， 带 有 像 这 样 的 信 
息 : "Could not read from file "pgnotify/_nnnn " at offset nnnnn*: Success". 


只 允许 autovacuum 通 过 直接 阻塞 进程 被 自动 取消 (Tom Lane) 


原始 编码 允许 在 某 些 情况 下 不 一 致 的 行为 ; 特别 的 ，autovacuum 在 少 
于 deadlock_timeout 宽 限 期 后 被 取消 。 


改善 autovacuum 取 消 的 登陆 (Robert Haas) 


修复 日 志 收集 器 ， 以 便 10g truncate_on_rotation 在 服务 器 启动 后 的 第 一 个 日 志 旋 转 期 
ja] LVF (Tom Lane) 


修复 with 附属 于 一 个 储 套 的 集合 运算 ( UNION / INTERSECT / except ) (Tom Lane) 
确保 整个 行 引 用 子 查询 不 会 包括 任何 额外 的 Group By 或 oRDER BY 列 (Tom Lane) 
不 允许 在 CREATE TABLE 期 间 在 check 约束 和 索引 定义 中 拷贝 整个 行 引 用 (Tom Lane) 


这 种 情况 会 出 现在 带 有 LIKE 或 INHERITS 的 create TABLE 中 。 拷贝 的 整个 行 变量 用 原始 
表 而 不 是 新 表 的 行 类 型 错误 的 标记 。 拒 绝 LIkE 看 起 来 合理 的 情况 ， 因 为 行 类 型 可 能 
后 会 有 分 歧 。 对 于 INHERITS ， 我 们 应 该 允许 它 ， 隐 式 转换 为 当前 表 的 行 类 型 ; 但 是 这 样 


将 请 求 更 多 的 工作 。 
修复 ARRAY(SELECT ...) 子 查询 中 的 内 存 泄 露 (Heikki Linnakangas, Tom Lane) 
修复 正则 表达 式 中 公共 前 级 的 提取 (Tom Lane) 


该 代码 会 对 量化 的 加 上 括号 的 子 表达 式 感到 困惑 ， 如 ^(foo)?bar 。 这 会 导致 对 这 种 模式 
的 搜索 的 不 正确 的 索引 优化 。 


修复 interval 常量 中 有 符号 的 hh_* >: > ~_mm 和 ie 9° “ii SS 字段 分 析 的 
bug (Amit Kapila, Tom Lane) 





当 在 PL/Python 中 转换 一 个 Python Unicode 字 符 串 为 服务 器 编码 时 ， 使 用 Postgres 的 编码 
转换 画 数 ， 而 不 是 Python 的 (Jan Urbanski) 


这 避免 了 一 些 极端 情况 问题 ， 尤 其 是 Python 不 支持 所 有 的 Postgres 编 码 。 一 个 值得 注意 
的 功能 性 改变 是 ， 如 果 服 务 器 编码 是 SQL _ASCIl， 你 将 得 到 该 字符 串 的 UTF-8 表 示 ; 以 
前 ， 字 符 串 中 的 任何 非 ASCII 字 符 都 业 导 致 一 个 错误 。 


修复 PL/Python 中 PostgreSQL 编 码 的 映射 为 Python 编 码 (Jan Urbanski) 
适当 的 报告 contrib/xml2 的 xslt_process() 中 的 错误 (Tom Lane) 


更 新 时 区 数据 文件 为 tzdata 版 本 2012e， 因 为 Morocco 和 Tokelau 中 的 DST 规 律 改变 。 


E.26. 版 本 9.0.8 


发 布 日 期 : 2012-06-04 


这 个 版 本 包含 自 9.0.7 以 来 的 各 种 修复 。 想 要 获得 关于 9.0 主 版 本 的 新 特性 信息 ， 请 参 
阅 Section E.34。 


E.26.1. 迁移 到 版 本 9.0.8 


运行 9.0.X 的 系统 不 需要 转 储 /恢复 。 


另外 ， 如 果 你 是 从 一 个 早 于 9.0.6 的 版 本 升级 而 来 ， 请 参阅 9.0.6 的 版 本 说 明 。 


E.26.2. 修改 列表 


e 修复 contrib/pgcrypto BY DES crypt() 芳 数 中 不 正确 的 口 合 转换 (Solar Designer) 


如 果 一 个 口令 字符 串 包 含 字 节 值 ex8@6 ， 则 忽略 剩余 的 口令 ， 导致 口令 比 它 表 现 出 来 的 
还 要 弱 。 有 了 这 个 修复 ， 剩 余 的 字符 串 适 当 的 包含 在 DES 散 列 中 。 这 个 bug 影 响 的 任何 
存储 的 口令 值 将 因此 而 不 再 匹配 ， 所 以 存储 的 值 可 能 需要 更 新 。 (CVE-2012-2143) 


。 为 过 程 语言 的 调用 人 处理 器 忽略 sEcuRITY DEFINER 和 set 属性 (Tom Lane) 
应 用 这 样 的 属性 到 一 个 调用 义理 器 会 使 服务 器 骨 溃 。 (CVE-2012-2655) 
© Sif timestamp 输入 中 的 数字 时 区 偏 移 量 距离 UTC 多 达 16 个 小 时 (Tom Lane) 


一 些 历史 时 区 的 偏 移 量 大 于 15 个 小 时 ， 这 是 以 前 的 限制 。 这 会 导致 转 储 的 数据 值 在 重 载 
时 被 拒绝 。 


。 修复 给 定时 间 对 于 当前 时 区 来 说 正好 是 最 后 的 DST 转 换 时 间 时 的 时 间 惟 转换 义理 (Tom 
Lane) 


这 个 监管 已 经 有 很 长 一 段 时 间 了 ， 但 是 之 前 没有 注意 到 是 因为 大 多 数 使 用 DST 的 时 区 ， 
假设 有 一 个 未 来 DST 转 换 的 不 确定 序列 。 


e 修复 text 到 name 和 char 到 name 的 转换 ， 以 在 多 字 节 编码 中 正确 的 执行 字符 串 截 断 
(Karl Schnaitter) 


e 修复 to_tsquery() 中 的 内 存 复制 bug (Heikki Linnakangas) 
。 确保 在 热 备 上 执行 时 txid_current() 报告 正确 的 纪元 (Simon Riggs) 


。 修复 规划 证 处 理子 查询 中 外 部 PlaceHolderVars (Tom Lane) 


这 个 bug 关 注 引 用 变量 的 子 SELECT， 该 变量 来 自 周 围 查 询 的 外 连接 的 可 以 为 空 侧 。 在 
9.1 中 ， 被 这 个 bug 影 响 的 查询 将 会 失败 : "ERROR: Upper-level PlaceHolderVar found 
where not expected", 但 是 在 9.0 和 8.4 中 ， 你 可 能 只 是 得 到 错误 的 响应 ， 因 为 传送 到 子 
查询 中 的 值 在 应 该 为 空 时 不 是 空 。 


修复 pg_attribute 非常 大 时 会 话 启动 缓慢 (Tom Lane) 


如 果 pg_attribute 超过 shared_buffers 的 四 分 之 一 ， Bis Baa RAD Nis He 
时 ， 有 时 会 需要 缓存 重建 代码 ， 导致 花费 的 时 间 比 平 时 要 多 一 些 。 如 果 一 次 启动 许多 新 


会 话 ， 这 个 问题 尤其 严重 。 
确保 适当 频 度 的 取消 查询 的 序列 化 打 描 检查 (Merlin Moncure) 
一 个 扫描 遇 到 许多 包含 非 活动 元 组 的 页 面 时 将 不 会 响应 中 断 。 


确保 Windows 实 现在 返回 前 PGsemaphoreLock() 清理 ImmediateInterruptok (Tom Lane) 


这 个 下 忽 意味 着 在 一 个 不 安全 的 时 间 查 询 取消 中 断 的 接收 将 晚 于 相同 查询 的 接受 ， 会 有 


不 可 预料 但 不 好 的 后 果 。 


打印 视图 或 规则 时 安全 的 显示 整 行 变量 (Abbas Butt, Tom Lane) 


极端 情况 下 包括 歧义 的 名 字 (也 就 是 ， 该 名 字 是 该 查 ee 会 以 一 个 歧 
义 的 方式 输出 ， 导致 视图 或 规则 在 转 储 或 重 载 时 有 不 同 解释 的 风险 。 通 过 附加 一 个 no-op 


转换 避免 歧义 | B 况 。 
修复 copy From 以 正确 的 处 理 相当 于 无 效 编码 的 空 标 记 字符 串 (Tom Lane) 


空 标记 字符 串 如 Eno 应 该 生效 ， 并 且 在 过 去 确实 生效 ， 但 是 在 8.4 中 这 种 情况 就 打破 


了 。 

确保 autovacuum 工 作 进 程 正确 的 执行 堆栈 深度 检查 (Heikki Linnakangas) 
以 前 ， 自 动 ANALYzE 在 一 个 函数 中 调用 无 限 递 当 会 使 工作 进程 崩溃 。 
修复 日 志 收 集 器 ， 使 其 在 高 度 负 载 下 不 会 去 失 日 志 一 致 性 (Andrew Dunstan) 
该 收集 器 在 以 前 如 果 太 忙 太 会 在 重新 装配 大 的 信息 时 失败 。 

修复 日 志 上 收集 器 ， 确 保 在 接收 到 SIGHUP 后 重启 文件 循环 (Tom Lane) 

修复 GIN 索 引 的 WAL 重 放 逻 辑 ， 如 果 索 引 各 后 删除 则 使 其 不 会 失败 (Tom Lane) 
修复 PL/pgSQL 的 RETURN NEXT 命令 中 的 内 存 泄露 (Joe Conway) 

修复 PL/pgSQL 的 cet piacnostics 命 合 ， 当 目标 是 画 数 的 第 一 个 变量 时 (Tom Lane) 
修复 psql 的 扩展 显示 ( \x ) 模 式 中 潜在 的 内 存 访问 结束 (Peter Eisentraut) 

修复 数据 库 包含 许多 对 象 时 pg_dump 中 的 几 个 性 能 问题 (Jeff Janes, Tom Lane) 


如 果 数 据 库 包含 许多 模式 ， 或 者 如 果 许 多 对 象 在 依赖 循环 中 ， 或 者 如 果 有 许多 自身 拥有 
的 序列 ， 那么 pg_dump 会 变 得 非常 缓慢 。 

修复 pg_upgrade， 以 防 数据 库 以 非 缺 省 的 表 空 间 存储 ， 而 该 表 空 间 包含 一 个 在 集群 的 缺 
省 表 空 间 的 表 的 情况 (Bruce Momjian) 


在 ecpg 中 ， 修 复 少 见 的 内 存 泄露 和 可 能 的 salcat 结构 之 后 的 一 个 字 节 的 重 写 (Peter 
Eisentraut) 


修复 contrib/dblink 的 dblink_exec() 以 在 错误 时 不 泄露 临时 数据 库 连 接 (Tom Lane) 
修复 contrip/dblink 以 在 错误 信息 中 报告 正确 的 连接 名 (Kyotaro Horiguchi) 


修复 contrib/vacuumlo 以 在 删除 许多 大 对 象 时 使 用 多 个 事物 (Tim Lewis, Robert Haas, 
Tom Lane) 


这 个 改变 在 有 许多 大 对 象 需要 删除 时 ， 避 免 了 过 度 的 max_locks_per_transaction o 该 行 
为 可 以 根据 新 增 的 -1 (limit) 选项 调整 。 


更 新 时 区 数据 文件 到 tzdata 版 本 2012c， 因 为 DST 规 律 在 Antarctica, Armenia, Chile, 
Cuba, Falkland Islands, Gaza, Haiti, Hebron, Morocco, Syria, 和 Tokelau lslands 改 变 
了 ; 还 有 为 加 拿 大 的 历史 的 更 正 。 


E.27. 版 本 9.0.7 


发 布 日 期 : 2012-02-27 


这 个 版 本 包含 各 种 自 9.0.6 以 来 的 修复 。 想 要 获得 关于 9.0 主 版 本 的 新 特性 信息 ， 请 参 
阅 Section E.34。 


E.27.1. 迁移 到 版 本 9.0.7 


运行 9.0.X 的 系统 不 需要 转 储 /恢复 。 


另外 ， 如 果 你 是 从 一 个 早 于 9.0.6 的 版 本 升级 而 来 ， 请 参阅 9.0.6 的 版 本 说 明 。 


E.27.2. 修改 列表 


需要 在 触发 器 贺 数 CREATE TRIGGER 上 的 执行 权限 (Robert Haas) 


这 个 缺失 的 检查 会 允许 另外 一 个 用 户 通 过 在 他 自己 的 一 个 表 上 安装 触发 器 来 用 伪造 的 输 
入 数据 执行 触发 器 函数 。 这 只 在 触发 器 范 数 标 记 为 SECURITY DEFINER 时 是 有 意义 的 ， 
为 否则 触发 器 函数 会 作为 表 所 有 者 运行 。 (CVE-2012-0866) 


删除 SSL 认 证 中 通用 名 长 度 的 任意 限制 (Heikki Linnakangas) 


libpq 和 服务 器 都 缩短 了 从 SSL 认 证 中 提取 的 通用 名 为 32 字 节 。 通常 这 没什么 坏处 ， 除 了 
一 个 意外 的 认证 失败 ， 但 是 有 一 些 相 当 那 以 置信 的 情况 下 ， 它 可 能 允许 一 个 证 书 持 有 人 
冒充 另 一 个 。 受 害 者 必须 有 一 个 正好 是 32 字 节 长 度 的 通用 名 ， 攻击 者 必须 说 服 一 个 信任 
的 CA 发 出 一 份 证 明 书 ， 证 明 该 通用 名 有 那个 字符 串 作 为 前 级 。 冒充 一 个 服务 器 也 需要 一 
些 额 外 的 开发 重 定 向 客户 端 连接 。 


转换 写 入 pg_dump 注 释 中 的 名 字 中 的 换行 为 空格 (Robert Haas) 


pg_dump 对 于 在 它 的 输出 脚本 中 的 SQL 注 释 中 发 出 的 汉化 的 对 象 名 是 不 着 慎 的 。 一 个 包 
含 换行 的 名 字 将 至 少 使 得 脚本 在 语句 构成 上 不 正确 。 恶意 的 对 象 名 将 在 脚本 重 载 时 引入 
SQL 注 入 风险 。 (CVE-2012-0868) 


修复 插入 的 同时 做 清理 时 的 btree 索 引 损 坏 (Tom Lane) 


一 个 插入 导致 的 索引 页 分 裂 有 时 会 导致 并 发 的 运行 vAcuuM ， 导致 丢失 它 应 该 删除 的 素 引 
RA. HMR ARTZ, AZAR AAS MIX (如 "could not read block N in 
file ...") KA BR, 在 不 相关 的 行 重新 插入 到 表 中 行 释 放 的 位 置 时 得 到 错误 的 查询 结 


果 。 这 个 bug 自 从 版 本 8.2 就 已 经 存在 了 ， 但 是 因为 很 少 重 现 ， 所 以 直到 现在 才 诊 断 出 
来 。 如 果 你 怀疑 在 你 的 数据 库 中 发 生 了 这 种 情况 ， 那 么 在 受 影响 的 索引 上 重建 索引 就 可 
修复 问题 。 


修复 WAL 重 放 期 间 共 享 缓冲 区 的 瞬 态 汶 雳 (Tom Lane) 


重 放 逮 辑 会 有 时 清空 然后 回填 共享 缓冲 区 ， 这 样 内 容 会 在 瞬间 无 效 。 在 热 备 模式 ， 这 会 
导致 并 行 执行 的 查询 看 到 垃圾 数据 。 从 此 会 出 现 各 种 症状 ， 但 是 最 常见 的 一 个 是 "invalid 


memory alloc request size". 
修复 postmaster 在 热 各 崩溃 后 党 斌 重启 (Tom Lane) 


如 果 在 热 各 模式 操作 时 任意 后 端 进 程 崩 溃 ， 那 么 一 个 逻辑 错误 导致 postmaster 中 止 ， 而 
不 是 党 试 重启 集群 。 


修复 cLusTER / vacuum FULL 挂 起 最 近 更 新 的 行 拥有 的 toast 值 (Tom Lane) 


这 个 监督 可 能 会 导致 在 这 些 命 命 期 间 ， 在 toast 表 的 索引 上 报告 "duplicate key value 
violates unique constraint" 错 误 。 


在 改变 表 的 所 有 者 时 ， 更 新 每 行 的 权限 ， 而 不 只 是 更 新 每 表 的 权限 (Tom Lane) 


未 能 做 到 这 一 点 意味 着 任意 先前 授权 的 行 权 限 仍 然 显 示 为 是 通过 旧 的 所 有 者 授权 的 。 这 
意味 着 不 管 是 新 的 所 有 者 还 是 超级 用 户 都 不 能 撤销 该 现在 无 法 追踪 表 的 所 有 者 的 权限 。 


在 REASSIGN owNED 中 支持 外 部 数据 封装 和 外 部 服务 器 (Alvaro Herrera) 


如 果 需 要 改变 任意 这 样 的 对 象 的 为 属 ， 那 么 这 个 命 命 会 带 有 "unexpected classid" 错 误 失 
Wo 


人 允许 ALTER USER/DATABASE SET 中 的 一 些 设 置 是 不 存在 的 值 (Heikki Linnakangas) 


Rit default_text_search_config , default_tablespace ， 和 和 temp_tablespaces 设置 为 不 
知道 名 字 。 这 是 因为 他 们 可 能 在 另外 一 个 使 用 这 个 设置 的 数据 库 中 知道 ， 或 者 对 于 表 空 
间 来 说 ， 因为 表 空 间 可 能 还 未 创建 。 相 同 的 问题 早已 被 search_path 认识 到 ， 这 些 设置 
并 不 像 那 个 一 样 动作 。 


避免 在 提交 之 后 删除 表 文 件 有 问题 时 的 崩溃 (Tom Lane) 


删除 表 会 导致 在 事务 提交 之 后 删除 底层 磁盘 文件 。 如 果 失 败 (例如 ， 因 为 错误 的 文件 权 
R), 那么 该 代码 应 该 只 是 发 出 一 个 警告 信息 然后 继续 ， 因 为 退出 该 事务 已 经 太 晚 了 。 
这 个 逻辑 在 版 本 8.4 被 打破 ， 导 致 这 样 的 情况 引起 一 个 PANIC 和 一 个 不 可 重新 启动 的 数据 
库 。 


在 prop TABLESPACE 的 WAL 重 放 期 间 从 错误 事件 中 恢复 (Tom Lane) 


重 放 将 尝试 删除 表 空 间 的 目录 ， 但 是 有 各 种 会 失败 的 原因 〈 例 如 ， 在 这 些 目录 上 的 不 正 
确 的 所 有 权 或 权限 ) 。 以 前 ， 重 放 代 码 会 引起 恐慌 ， 致 使 数据 库 不 能 重新 启动 除非 手动 
介入 。 似乎 最 好 是 记录 该 问题 并 记录 ， 因 为 删除 目录 失败 的 唯一 后 果 是 浪费 一 些 磁盘 空 
间 。 


修复 为 热 备 记录 AccessExclusiveLocks 中 的 竞 态 条 件 (Simon Riggs) 


有 时 一 个 锁 被 记录 为 就 像 是 被 "transaction zero" 持 有 一 样 。 这 至 少 已 知 为 在 从 属 服务 器 
上 产生 声明 失败 ， 或 者 可 能 造成 更 严重 的 问题 。 


在 WAL 重 放 期 间 甚 至 打包 时 正确 的 跟踪 OID 计 数 器 (Tom Lane) 


以 前 ，OID 计 数 器 保持 停留 在 一 个 高 值 直到 系统 退出 重 放 模 式 。 实 际 的 结果 通常 为 雳 ， 
但 是 在 各 用 服务 器 中 ， 被 提升 到 master 的 情况 下 ， 一 且 值 是 必要 的 ， 可 能 需要 很 长 的 一 
段 时 间 促 进 OID 计 数 器 为 一 个 合理 的 值 。 


在 故障 修复 的 开始 阻止 发 出 误导 的 "consistent recovery state reached" 日 志 信 息 (Heikki 
Linnakangas) 


修复 pg_stat_replication . replay_location 的 初始 值 (Fujii Masao) 
之 前 ， 显 示 的 值 是 错误 的 ， 直 到 至 少 一 个 WAL 记 录 被 重 放 。 
修复 附加 * 的 正则 表达 式 的 逆向 引用 (Tom Lane) 


不 是 强制 一 个 准确 的 字符 串 匹 配 ， 而 是 该 代码 实际 上 接受 任意 满足 逆向 引用 符号 引用 的 
模式 子 表 达 式 的 字符 串 。 


一 个 类 似 的 问题 仍然 困扰 着 若 入 到 一 个 较 大 的 量化 的 表达 式 中 的 逆向 引用 ， 而 不 是 量词 
的 直接 主体 。 这 将 在 将 来 的 PostgreSQL 版 本 中 处理 。 


修复 处 理 inet / cidr 值 的 过 程 中 最 近 引 入 的 内 存 泄露 (Heikki Linnakangas) 


PostgreSQL 的 2011.12 版 本 中 的 一 个 补丁 导致 在 这 些 操 作 中 的 内 存 泄 露 ， 在 有 些 情况 下 
可 能 是 重要 的 ， 如 在 这 样 的 字段 上 建立 一 个 btree 素 引 。 


修复 在 一 个 SQL 语言 功能 中 cREATE TABLE AS / SELECT INTO 之 后 的 悬挂 指针 (Tom Lane) 


在 大 多 数 情况 下 ， 这 只 会 在 启用 声明 的 建立 中 导致 声明 失败 ， 但 是 有 可 能 有 更 糟糕 的 后 
果 。 


避免 在 Windows 上 的 syslogger 中 两 次 关闭 文件 句柄 (MauMau) 

通常 这 种 错误 是 不 可 见 的 ， 但 是 当 运 行 在 Windows 的 debug 版 本 上 时 它 会 导致 一 个 意外 。 
修复 plpgsql 中 I/O 转 换 相关 的 内 存 泄露 (Andres Freund, Jan Urbanski, Tom Lane) 
某 些 操 作 会 泄露 内 存 ， 直 到 当前 函数 的 结束 。 


改善 pg_dump 的 继承 表 字段 的 处 理 (Tom Lane) 


当 子 字段 有 一 个 与 父 字 段 不 同 的 缺 省 表达 式 时 ，pg_dump 会 错误 的 处 理 这 种 情况 。 如 果 
缺 省 和 父 字 段 的 缺 省 文本 上 相同 ， 但 是 实际 上 不 同 (例如 ， 因 为 模式 搜索 路 径 不 同 ) ， 
将 不 会 认为 是 不 同 ， 所 以 在 转 储 和 恢复 之 后 ， 人 允许 子 字段 继承 父 字段 的 缺 省 。 当 它 们 的 
父 字 段 不 是 也 可 以 恢复 巧妙 的 错误 时 ， 子 字段 为 NOT NULL o 


为 INSERT-style 表 数据 修复 pg_restore 的 direct-to-database 模 式 (Tom Lane) 


当 使 用 发 布 日 期 为 2011 年 12 月 或 9 月 的 pg_restore 时 ， Direct-to-databaseM # 
有 --inserts 或 --column-inserts 选项 制作 的 轨 档 文件 中 恢复 会 失败 ， 因 为 监督 在 另外 
一 个 问题 的 修复 中 。 该 轨 档 文件 本 身 没有 问题 ， 文 本 模式 输出 也 是 可 以 的 。 


允许 pg_upgrade 处 理 包含 regclass 字段 的 表 (Bruce Momjian) 
因为 pg_upgrade 现 在 注意 保存 pg_class OID， 不 再 有 任何 原因 限制 。 
当 查 找 一 个 SSL 客 户 端 证 书 文件 时 使 iibpq 忽 略 ENoTbIR 错误 (Magnus Hagander) 


这 允许 建立 SSL 连 接 ， 尽 管 不 带 有 证 书 ， 甚 至 用 户 的 根 目录 设置 为 类 似 /dev/null 的 东 
西 。 


修复 ecpg 的 SQLDA 区 域内 一 些 更 多 的 字段 对 齐 问题 (Zoltan Boszormenyi) 
在 ecpg DEALLOCATE 语句 中 人 允许 AT 选项 (Michael Meskes) 


支持 这 个 的 基础 构造 已 经 有 一 段 时 间 了 ， 但 是 通过 一 个 监督 ， 仍 然 有 一 个 错误 检查 拒绝 
该 情况 。 


在 ecpg 中 定义 一 个 varchar 结 构 时 不 要 使 用 变量 名 (Michael Meskes) 

修复 contrib/auto_explain 的 JSON 输 出 模式 以 产生 有 效 的 JSON (Andrew Dunstan) 
会 出 在 顶级 使 用 方 括号 ， 在 它 原 本 应 该 使 用 花 括号 的 地 方 。 

修复 contrib/intarray 的 int[] & int[] 操作 符 中 的 错误 (Guillaume Lelarge) 


如 果 两 个 输入 数组 有 相同 的 最 小 整数 为 1， 并 且 两 个 数组 中 都 有 更 小 的 值 ， 那么 1 将 会 不 
正确 的 从 结果 中 漏 掉 。 


修复 contrib/pgcrypto 的 encrypt_iv() 和 decrypt_iv() 中 的 错误 检测 (Marko Kreen) 


这 些 酌 数 未 能 报告 无 效 输入 错误 的 准确 类 型 ， 并 且 对 于 不 正确 的 输入 会 返回 随机 的 垃圾 
值 。 


修复 contrib/test_parser 中 的 一 字 节 缓冲 区 浴 出 (Paul Guyot) 


该 代码 将 会 试图 比 它 应 该 读 取 的 多 读 一 个 
为 contrib/test_parser 只 是 示例 代码 ， 这 


示例 代码 仍 是 坏 的 。 


字 节 ， 这 会 导致 极端 情况 下 的 崩溃 。 
对 它 本 身 来 说 不 是 一 个 安全 问题 ， 但 是 不 好 的 


如 果 可 用 ， 在 ARM 上 为 自 旋 锁 使 用 _sync_lock_test_and_set() (Martin Pitt) 





这 个 男 数 蔡 代 我 们 以 前 swe 指令 的 使 用 ， 该 指令 已 经 奔 用 了 并 且 在 ARMv6 和 以 后 的 版 
本 中 不 能 使 用 了 。 报告 显示 ， 老 旧 代 码 不 会 在 最 近 的 ARM 模 块 明显 的 失败 ， 但 是 简单 的 
不 互 锁 并 发 访问 ， 导致 在 多 进程 操作 中 奇怪 的 失败 。 


当 使 用 接受 -fexcess-precision=standard 的 gcc 版 本 建立 时 使 用 该 选项 (Andrew Dunstan) 
这 防止 了 混合 情形 下 gcc 的 最 近 版 本 将 产生 创新 结果 。 
允许 在 FreeBSD 上 使 用 线程 的 Python (Chris Rees) 


以 前 我 们 的 配置 脚本 相信 这 种 组 合 不 会 运行 ; 但 是 FreeBSD 修 复 了 这 个 问题 ， 所 以 删除 
那个 错误 检查 。 


E.28. 版 本 9.0.6 


发 布 日 期 : 2011-12-05 


这 个 版 本 包含 各 种 自 9.0.5 以 来 的 修复 。 想 要 获得 关于 9.0 主 版 本 的 新 特性 信息 ， 请 参 
阅 Section E.34。 


E.28.1. 迁移 到 版 本 9.0.6 


运行 9.0.X 的 系统 不 需要 转 储 /恢复 。 


然而 ， 在 information_schema.referential_constraints 视图 的 定义 中 发 现 了 一 个 长 期 存在 的 
252, 如 果 你 依赖 于 该 视图 的 正确 结果 ， 那么 你 应 该 如 下 第 一 条 变更 日 志 条 目 解释 的 那样 蔡 
换 它 的 定义 。 


另外 ， 如 果 你 是 从 一 个 早 于 9.0.4 的 版 本 升级 而 来 ， 那 么 请 参阅 9.0.4 的 版 本 声明 。 


E.28.2. 修改 列表 


e 修复 了 information_schema.referential_constraints 视图 中 的 bug (Tom Lane) 


这 个 视图 关于 匹配 外 键 约束 和 依赖 的 主键 或 唯一 键 约束 不 够 仔细 。 这 会 导致 无 法 显示 外 
键 约束 ， 或 显示 多 次 外 键 约束 ， 或 宣称 它 依 赖 于 与 它 实际 依赖 的 约束 不 同 的 约束 。 

由 于 该 视图 的 定义 是 通过 initdb 安 装 的 ， 只 是 升级 将 不 能 修复 这 个 问题 。 如 果 你 需要 在 一 
个 现 有 安装 上 修复 ， 你 可 以 〈 作 为 超级 用 户 ) 删除 information_schema 模式 然后 通过 寻 
JR _SHAREDIR_ /informationschema.sq/ 重 新 创建 它 。 如果 不 确定 

”SHAREDIR ‘te, 347 pg_config --sharedir, ) 必须 在 每 个 要 修复 的 数据 库 充 重复 这 
个 操作 。 


。 修复 加 入 标量 返回 画 数 的 输出 的 UPDATE 或 DELETE 期 间 可 能 的 损坏 (Tom Lane) 
只 有 在 同时 更 新 同一 个 目标 行 时 会 发 生 损 坏 ， 所 以 这 个 问题 只 是 间歇 性 的 出 现 。 
e 修复 WAL 记 录 为 GIN 索 引 更 新 不 正确 的 重 放 (Tom Lane) 


这 会 导致 崩溃 后 或 在 一 个 热 各 服务 器 上 有 一 个 瞬间 不 能 找到 索引 条 目 。 不 过 ， 该 问题 可 
以 通过 对 索引 的 下 一 个 vacuum 修复 。 


e 修复 CREATE TABLE dest AS SELECT * FROM src 或 INSERT INTO dest SELECT * FROM src 期 


间 TOAST 相 关 的 数据 损坏 (Tom Lane) 


如 果 一 个 表 已 经 通过 ALTER TABLE ADD coLumn 修改 ， 那么 逐 字 的 拷贝 它 的 数据 到 另 一 个 
表 在 某 些 极端 情况 下 会 产生 损坏 的 结果 。 该 问题 只 会 在 8.4 和 以 后 的 版 本 中 的 确定 形式 下 
Em, 但 是 我 们 也 在 更 早 的 版 本 中 打 了 补丁 ， 以 防 有 其 他 代码 路 径 会 触发 相同 的 bug。 


修复 热 各 启动 期 间 可 能 的 失败 (Simon Riggs) 
当 最初 的 快照 不 完整 时 更 快 的 启动 热 各 份 (Simon Riggs) 
修复 toast 表 访问 陈旧 的 syscache 条 目 期 间 的 竞 态 条件 (Tom Lane) 


典型 症状 是 类 似 "missing chunk number 0 for toast value NNNNN in pg_toast_2619" 这 
样 的 瞬 态 错误 ， 这 里 被 引用 的 toast 表 总 是 属于 系统 目录 。 


追踪 用 于 参数 缺 省 表达 式 中 的 条 目 上 的 范 数 的 依赖 性 (Tom Lane) 


以 前 ， 可 以 在 没有 删除 或 修改 画 数 之 前 删除 引用 对 象 ， 导 致使 用 该 玉 数 时 的 错误 行为 。 
请 注意 ， 仅 仅 安装 这 个 更 新 将 不 能 修复 丢失 的 依赖 条 目 ; 要 想 修复 ， 你 需要 在 每 一 个 这 
样 的 范 数 之 后 CREATE OR REPLACE 。 如 果 你 有 缺 省 依赖 于 非 内 建 对象 的 落 数 ， 建 议 这 样 
做 。 


允许 设置 -返回 SQL 责 数 内 联 多 个 OUT 参 数 (Tom Lane) 
对 于 加 入 删除 来 说 不 要 依赖 延迟 的 唯一 索引 (Tom Lane and Marti Raudsepp) 
延迟 的 唯一 约束 可 能 不 支持 内 部 事务 ， 所 以 假定 它 会 给 出 不 正确 的 查询 结果 。 


使 patumGetinetP() 取出 有 1 字 节 开头 的 inet 资 料 ， 并 且 添 加 一 个 新 的 宏 
DatumGetInetPP() (Heikki Linnakangas) 


这 个 改变 不 会 影响 核心 代码 ， 但 是 可 以 阻止 期 望 obatumcetInetP() 按照 通常 的 惯例 产生 非 
压缩 的 数据 的 扩展 代码 中 的 崩溃 。 


改善 money 类 型 的 输入 和 输出 的 语言 环境 支持 (Tom Lane) 
除了 不 支持 所 有 的 标准 1c_monetary 格式 化 选项 之 外 ， 输 入 和 输出 函数 也 是 不 一 致 的， 
这 意味 着 转 储 的 money 值 中 的 语言 环境 不 可 以 被 重新 读 取 。 


不 让 transform null equals 影响 CASE foo WHEN NULL ... 构造 (Heikki Linnakangas) 


transform_null_equals 只 应 该 影响 直接 由 用 户 编写 的 foo = NULL 表达 式 ， 不 是 这 种 形 
式 的 case 内 部 产生 的 平等 检查 。 


更 改 外 键 触发 创建 以 便 更 好 的 支持 自我 参考 的 外 键 (Tom Lane) 

对 于 参考 它 自 己 的 表 的 级 联 外 键 ， 一 个 行 更 新 将 作为 一 个 事件 触发 oN UPDATE 触发 器 和 
CHECK 触发 器 。 必 须 先 执 行 on UPDATE ARABS, AWM) cHEck 将 检查 行 的 一 个 非 最 终 状 
态 ， 并 且 可 能 抛 出 一 个 不 恰当 的 错误 。 不 过 ， 触 发 这 些 触发 器 的 顺序 则 取决 于 它们 的 名 
字 ， 它们 通常 以 创建 的 顺序 排序 ， 因 为 触发 器 自动 生成 的 名 字 遵 循 惯 


例 "RI_ConstraintTrigger NNNN", 适当 的 修复 需要 修改 该 惯例 ， 我 们 将 在 9.2 中 做 这 
块 ， 不 过 在 现存 的 版 本 中 改变 它 看 起 来 是 有 风险 的 。 所 以 这 个 修复 只 是 改变 触发 器 的 创 
建 顺 序 。 用 户 遇 到 这 个 类 型 的 错误 时 应 该 删除 并 重建 外 键 约 束 ， 以 使 它 的 触发 器 获得 正 
确 的 顺序 。 


当 跟 踪 缓 冲 区 分 配 率 时 避免 浮 点 型 下 浴 (Greg Matthews) 

当 它 本 身 无 害 时 ， 在 特定 平台 上 这 将 导致 恼人 的 内 核 日 志 信息 。 

当 在 Windows 下 书 动 子 进 程 时 ， 保 折 配 置 文件 名 和 行 号 值 (Tom Lane) 

以 前 ， 这 些 在 pg_settings 视图 中 显示 的 不 正确 。 

修复 ecpg 的 SQLDA 区 域 中 不 正确 的 字段 排列 (Zoltan Boszormenyi) 

保持 空 行 在 psql 的 命令 历史 的 命令 里 面 (Robert Haas) 

前 者 的 行为 可 能 导致 问题 ， 例 如 ， 如 果 一 个 空 行 从 一 个 字符 串 中 删除 。 

修复 pg_dump 以 转 储 用 户 定义 和 自动 生成 类 型 之 间 的 转换 ， 上 比如 表 的 行 类 型 (Tom Lane) 
pg_upgrade 的 各 种 修复 (Bruce Momjian) 


正确 的 处 理 排他 约束 ， 避 免 在 Windows 上 的 失败 ， 不 要 抱怨 8.4 数 据 库 中 错误 匹配 的 toast 
表 名 。 


使 用 xsubpp 的 首选 版 本 建立 PL/Perl， 不 一 定 要 操作 系统 的 主要 副本 (David Wheeler and 
Alex Hunsaker) 


修复 contrib/dict_int 和 contrib/dict_xsyn 中 不 正确 的 编码 (Tom Lane) 
某 些 函 数 不 正 确 的 假设 由 palloc() 返回 的 内 存 保证 调 到 需 位 。 

修复 contrib/unaccent 的 配置 文件 解析 中 的 各 种 错误 (Tom Lane) 

查询 取消 pgstatindex() 中 的 立即 中 断 (Robert Haas) 

修复 Mac OS X 启 动 脚本 中 日 志文 件 名 的 错误 引用 (Sidar Lopez) 

确保 VPATH 建 立 适 当 的 安装 所 有 的 服务 器 头 文件 (Peter Eisentraut) 

缩短 在 见长 的 错误 信息 中 报告 的 文件 名 (Peter Eisentraut) 


正规 的 建立 总 是 只 是 报告 包含 错误 信息 调用 的 C 文 件 的 名 字 ， 但 是 VPATH 建 立 以 前 报告 一 
个 绝对 路 径 名 。 


修复 Windows 时 区 名 称 中 美洲 (Central America) 的 说 明 (Tom Lane) 


映射 "Central America Standard Time" 到 cste ， 而 不 是 csT6cpT , 为 DST 在 中 美洲 通 
常 不 是 随处 可 见 的 。 


。 更 新 时 区 数据 文件 为 tzdata 版 本 2011n， 因 为 DST 规 律 在 Brazil Cuba, Fiji, Palestine, 
Russia, 和 Samoa 改 变 了 ; 还 有 Alaska 和 British East Africa 的 历史 的 修正 。 


E.29. 版 本 9.0.5 


发 布 日 期 : 2011-09-26 


这 个 版 本 包含 各 种 自 9.0.4 以 来 的 修复 。 要 想 获 得 关于 9.0 主 版 本 的 新 特性 信息 ， 请 参 
# Section E.34。 


E.29.1. 迁移 到 版 本 9.0.5 


运行 9.0.X 的 系统 不 需要 转 储 /恢复 。 
另外 ， 如 果 你 是 从 一 个 早 于 9.0.6 的 版 本 升级 而 来 ， 请 参阅 9.0.6 的 发 布 说 明 。 


E.29.2. 修改 列表 


。 修复 系统 目录 上 vacuum FuLL 或 cluster 之 后 目录 缓存 失效 (Tom Lane) 


在 某 些 情况 下 ， 重 定位 系统 目录 行 到 另 一 个 位 置 将 不 会 被 并 发 服务 器 进程 识别 ， 如 果 他 
们 然后 尝试 更 新 那 行 ， 那 么 允许 目录 损坏 的 发 生 。 最 坏 的 情况 可 能 是 完全 丢失 一 个 表 。 


。 修复 sinval 复 位 处 理 期 间 不 正确 的 操作 顺序 ， 并 且 保 证 TOAST OID 保 存 到 系统 目录 中 
(Tom Lane) 


这 些 错 误 可 能 导致 在 一 个 系统 目录 上 vacuum FuLL 或 cluster 之 后 的 瞬时 失效 。 
。 修复 索引 in-doubt HOT-updated 元 组 的 bug (Tom Lane) 
这 些 bug 可 能 导致 在 对 系统 目录 重建 索引 之 后 的 索引 损坏 。 不 认为 会 影响 用 户 的 索引 。 
。 修复 GiST 索 引 页 分 裂 进程 中 的 多 个 bug (Heikki Linnakangas) 
发 生 的 概率 很 低 ， 但 是 可 能 会 导致 素 引 损坏 。 
e 修复 tsvector_concat() 中 可 能 的 缓冲 区 浴 出 (Tom Lane) 
该 画 数 可 能 低估 了 它 的 结果 所 需 内 存 的 数量 ， 导 致 服务 器 骨 溃 。 
。 修复 处 理 "standalone" 参 数 时 xml_recv 中 的 崩溃 (Tom Lane) 
e 使 pg_options_to_table 为 不 带 值 的 选项 返回 NULL (Tom Lane) 
以 前 这 样 的 情况 会 导致 服务 器 崩溃 。 


。 避免 在 ANALYZE 和 SJIS-2004 编 码 转换 中 可 能 的 访问 超出 内 存 结尾 (Noah Misch) 


这 修复 了 一 些 非常 低 可 能 性 的 服务 器 月 淡 情 况 。 

保护 pg_stat_reset_shared() 不 输入 NULL (Magnus Hagander) 

修复 子 事务 中 检测 到 一 个 恢复 冲突 死 锁 时 可 能 的 失败 (Tom Lane) 
避免 热 各 期 间 回 收 btree 索 引 页 时 伪造 的 冲突 (Noah Misch, Simon Riggs) 
如 果 WAL 接 收 器 仍然 运行 在 恢复 的 结尾 ， 那 么 关闭 它 (Heikki Linnakangas) 
postmaster 以 前 在 这 种 情况 下 会 恐慌 ， 但 它 实 际 上 是 一 个 合法 的 情况 。 

修复 relcache 初 始 化 文件 无 效 中 的 竞 态 条 件 (Tom Lane) 


有 一 个 窗口 ， 一 个 新 的 后 端 进程 可 能 会 读 取 旧 的 初始 化 文件 ， 而 忽视 将 要 告诉 它 该 数据 
是 陈旧 的 的 inval 人 信息。 结果 将 会 是 目录 访问 中 的 奇异 的 失败 ， 典型 的 是 稍 后 启动 
时 "could not read block 0 in file ..."。 


修复 在 GiST 索 引 扫 描 结 尾 的 内 存 泄露 (Tom Lane) 


执行 许多 独立 GiST 索 引 扫 描 的 命 舍 ， 例 如 在 一 个 早已 包含 许多 行 的 表 上 验证 一 个 新 的 基 
于 GiST 的 排除 约束 ， 可 能 因为 这 个 漏洞 在 瞬间 需要 大 量 的 内 存 。 


修复 在 进入 命令 字符 串 和 LISTEN 是 活跃 的 时 必须 做 编码 转换 时 的 内 存 泄露 (Tom Lane) 


修复 支持 可 持 有 的 游标 和 plpgsql 的 RETURN NEXT 命令 的 tuplestores 中 的 错误 的 内 存 计算 
(导致 可 能 的 内 存 膨 腾 ) (Tom Lane) 


修复 BEFORE 和 AFTER 触发 器 都 存在 时 的 触发 器 whEN 条 件 (Tom Lane) 
如 果 已 经 有 一 个 BEFORE Row 触发 器 为 同一 个 更 新 触发 了 ， 那 么 为 ”AFTER ROW UPDATE if 


估 wen 条 件 可 能 会 骨 溃 。 

修复 构建 一 个 大 的 、 有 损耗 的 位 图 时 的 性 能 问题 (Tom Lane) 

修复 为 唯一 字段 的 连接 选择 性 估计 (Tom Lane) 

这 修复 了 一 个 可 能 导致 欠 佳 的 估计 连接 结果 大 小 的 错误 的 启发 式 规划 器 。 
修复 只 在 子 查询 目标 列表 中 出 现 的 找 套 的 PlaceHolderVar 表 达 式 (Tom Lane) 
这 个 错误 可 能 导致 外 连接 的 输出 不 正确 的 显示 为 NULL。 

允许 规划 器 认为 空 父 表 真 的 是 空 的 (Tom Lane) 


通常 一 个 空 表 为 了 规划 目的 会 假设 有 一 个 特定 的 最 小 尺寸 ; 但 是 这 个 启发 对 于 通常 永久 
为 空 的 继承 体系 的 父 表 来 说 看 起 来 次 大 于 利 。 


THRE exists 查询 适当 的 最 优化 (Tom Lane) 


修复 array- 和 path-creating 画 数 以 确保 填充 的 字 节 为 0 (Tom Lane) 


这 避免 了 规划 器 认为 语义 上 相等 的 常量 不 等 ， 导 致 欠 佳 的 最 优化 的 情况 。 
修复 ExPLAIN 以 处 理 内 部 索引 扫描 辅助 方案 内 的 控制 结果 节点 (Tom Lane) 
这 种 监督 通常 的 症状 是 "bogus varno" 错 误 。 


Ww 


复 _indexedcol_ Is NULL 条 件 的 btree 预 处 理 (Dean Rasheed) 


如 果 与 任意 其 他 类 型 的 btree 可 索引 条 件 在 同一 个 索引 字段 上 上 结合， 那么 这 样 一 个 条 件 可 
能 是 不 满足 的 。 该 情况 在 9.0.0 和 之 后 的 版 本 中 你 理 的 不 正确 ， 导 致 查询 输出 到 本 该 没有 
的 地 方 。 


绕 开 破 十 WAL 重 放 的 gcc 4.6.0 bug (Tom Lane) 

这 会 导致 在 服务 器 崩溃 后 去 失 已 提交 的 事务 。 

修复 视图 中 的 vALuEs 的 转 储 bug (Tom Lane) 

禁止 序列 上 的 SELECT FOR UPDATE/SHARE (Tom Lane) 

这 个 操作 不 会 像 预期 的 那样 工作 ， 并 且 会 导致 失败 。 

修复 vAcuuM 以 便 它 总 是 更 新 pg_class . reltuples / relpages (Tom Lane) 
这 修复 了 一 些 自动 清理 可 能 使 得 越 来 越 多 的 什么 时 候 清理 表 的 决策 欠 佳 的 情形 。 
当 计 算 一 个 哈 希 表 的 大 小 时 防止 整数 浴 出 (Tom Lan) 

修复 cLusTER 试图 访问 早已 删除 的 TOAST 数 据 的 情况 (Tom Lane) 
修复 初始 验证 事务 期 间 过 早 的 超时 失败 (Tom Lane) 

修复 为 "peer" 认 证 使 用 证 书 控制 信息 中 的 可 移植 性 错误 (Tom Lane) 

修复 需要 多 次 往返 时 的 SSPI 登 陆 (Ahmed Shinwari, Magnus Hagander) 


这 个 问题 的 典型 症状 是 在 SSPI 登 陆 期 间 的 "The function requested is not supported" 错 


误 。 

修复 添加 一 个 新 的 自 定义 变量 类 的 变量 到 postgresql.cont 时 的 失败 (Tom Lane) 
如 果 pg_hba.conf 包含 hostssl 但 是 SSL 是 禁用 的 时 ， 抛 出 一 个 错误 (Tom Lane) 
这 被 认为 是 更 加 用 户 友 好 的 行为 ， 以 前 这 桩 的 行 都 是 默默 地 忽视 。 

修复 DROP owNED BY 试图 删除 序列 上 的 缺 省 权限 时 的 失败 (Shigeru Hanada) 


修复 pg_srand48 种 子 初 始 化 中 的 打字 错误 (Andres Freund) 


这 导致 未 能 使 用 所 有 提供 的 种 子 。 这 个 画 数 没有 用 在 大 多 数 的 平台 上 (只 是 那些 没 
有 srandom 的 ) ， 并 且 一 个 比 预 期 较 少 随机 的 种 子 看 起 来 在 任何 情况 下 潜在 的 安全 风险 
都 很 小 。 


避免 LIMIT 和 oFFsET 值 的 和 超过 2^63 时 的 整数 浴 出 (Heikki Linnakangas) 
添加 浴 出 检查 到 generate_series() 的 int4 和 ints 版 本 (Robert Haas) 

修复 在 to_char() 中 消除 尾随 的 需 (Marti Raudsepp) 

在 Fm 格式 中 并 且 在 小 数 点 后 没有 数字 位 ， 小 数 点 左边 的 需 可 能 会 被 不 正确 的 消除 。 
修复 pg_size_pretty() 以 避免 输入 接近 2^63 而 浴 出 (Tom Lane) 

减少 记录 值 中 typmod 匹 配 的 plpgsql 的 检查 (Tom Lane) 

一 个 过 度 的 检查 可 能 会 导致 丢弃 应 该 保持 的 长 度 修饰 符 。 

正确 的 处 理 initdb 期 间 本 地 名 中 的 引号 (Heikki Linnakangas) 

该 情况 可 能 出 现 一 些 Windows 地 区 ， 如 "People's Republic of China"。 

在 pg_upgrade 中 ， 避 免 转 储 孤立 的 临时 表 (Bruce Momjian) 

这 防止 了 表 OID 分 配 在 旧 的 和 新 的 安装 中 不 同步 的 情况 。 

修复 pg_upgrade 以 在 从 8.3 升 级 而 来 期 间 保 持 toast 表 的 relfrozenxids (Bruce Momjian) 
未 能 做 到 这 点 会 导致 pg_clog 文件 在 升级 之 后 很 快 被 删 掉 。 

在 pg_upgrade 中 ， 修 复 -1 (log) 选 项 以 在 Windows 上 运行 (Bruce Momjian) 

在 pg_ctl 中 ， 在 Windows 上 支持 服务 注册 的 静音 模式 (MauMau) 

修复 从 一 个 不 同 的 文件 copy 期 间 psql 的 脚本 文件 行 号 计数 (Tom Lane) 

为 standard_conforming_strings 修复 pg_restore 的 direct-to-database 模 式 (Tom Lane) 


pg_restore 在 从 一 个 由 standard_conforming_strings 设置 为 on 制作 的 为 档 文件 中 直接 恢 
复 到 数据 库 服务 器 时 可 能 会 发 出 不 正确 的 命令 。 


对 于 并 行 pg_restore 的 不 支持 的 情况 更 加 用 户 友好 (Tom Lane) 

这 个 改变 确保 了 这 样 的 情况 能 被 检测 到 ， 并 且 在 采取 恢复 动作 之 前 被 报告 。 

修复 libpq 的 LDAP 服 务 查 找 代 码 中 的 write-past-buffer-end 和 内 存 泄露 (Albe Laurenz) 
在 libpq 中 ， 避 免 使 用 无 闭塞 的 MO 和 SSL 连 接 时 的 失败 (Martin Pihlak, Tom Lane) 
改善 bpq 对 连接 启动 时 失败 的 处 理 (Tom Lane) 


特别 的 ， 现 在 对 服务 器 在 SSL 连 接 和 启动 时 失败 的 fork() 报告 的 响应 更 加 理智 。 


改善 iibpq 对 于 SSL 失 败 的 错误 报告 (Tom Lane) 


修复 Pasetvalue() 以 避免 添加 一 个 新 的 元 组 到 一 个 最 初 从 服务 器 查询 获得 的 
PGresult 时 可 能 的 骨 溃 (Andrew Chernow) 


使 ecpglib 写 double 值 带 有 15 位 数字 精度 (Akira Kurosawa) 
在 ecpglib 中 ， 确 保 Lc_NuMERIC 设置 在 错误 之 后 恢复 (Michael Meskes) 
为 blowfish 有 符号 字符 的 错误 应 用 逆向 修复 (CVE-2011-2483) 


contrib/pg_crypto 的 blowfish 加 密 代 码 在 char 是 有 符号 的 平台 (大 多 数 是 ) 上 可 能 给 出 
错误 的 结果 ， 导 致 加 密 的 口令 比 原 有 的 强度 要 弱 。 


修复 contrib/seg 中 的 内 存 泄露 (Heikki Linnakangas) 

修复 pgstatindex() 以 对 于 空 素 引 给 出 一 致 的 结果 (Tom Lane) 
允许 使 用 perl 5.14 建 立 (Alex Hunsaker) 

修复 建立 和 安装 的 文件 路 径 包 含 空格 时 的 各 种 问题 (Tom Lane) 


更 新 时 区 数据 文件 到 tzdata 版 本 2011i， 因 为 DST 法 律 在 以 下 地 区 发 生 改 变 : Canada, 
Egypt, Russia, Samoa, 和 South Sudan。 


E.30. 版 本 9.0.4 


发 布 日 期 : 2011-04-18 


这 个 版 本 包含 各 种 自 9.0.3 以 来 的 修复 。 要 想 获取 9.0 主 版 本 的 新 特性 信息 ， 请 参阅 Section 
E.34。 


E.30.1. 迁移 到 版 本 9.0.4 


运行 9.0.X 版 本 的 用 户 不 需要 转 储 /恢复 。 


不 过 ， 如 果 您 的 安装 是 通过 运行 bg_upgrade 从 一 个 先前 的 主 版 本 升级 而 来 ， 您 应 该 采取 措施 
防止 由 于 pg_upgrade 中 一 个 现在 修复 的 bug 引 起 可 能 的 数据 丢失 。 建议 的 解决 方案 是 在 所 有 
的 TOAST 表 上 运行 vacuum FREEZE. 更 多 信息 可 以 参考 
http://wiki.postgresql.org/wiki/20110408pg_upgrade fix。 


E.30.2. 修改 刘表 


。 修复 pg_upgrade 对 TOAST 表 的 处 理 (Bruce Momjian) 


在 pg_upgrade 期 间 ，TOAST 表 的 pg_class . relfrozenxid 值 没有 正确 的 拷贝 到 新 的 安 
装 中 。 这 可 能 稍 后 导致 他 们 仍然 需要 在 TOAST 表 中 验证 元 组 时 ， pg_clog 文件 被 丢弃 ， 
导致 "could not access status of transaction" 失 败 。 


这 个 错误 造成 了 用 pg_upgrade 升 级 的 安装 的 数据 丢失 的 重大 风险 。 这 个 补丁 纠正 了 将 来 
使 用 pg_upgrade 的 问题 ， 但 是 没有 本 质 上 解决 已 经 用 错误 版 本 的 pg_upgrade 处 理 过 的 
安装 中 的 问题 。 


e 废止 错误 的 "PD _ALL VISIBLE flag was incorrectly set" (Heikki Linnakangas) 
VACUUM 有 时 会 发 出 这 个 警告 ， 实 际 上 是 有 效 的 。 
© 为 热 各 份 冲突 情况 使 用 更 好 的 SQLSTATE 错 误 代 码 (Tatsuo Ishii and Simon Riggs) 


所 有 可 重 试 的 冲突 错误 现在 有 一 段 错误 代码 表明 重 试 是 可 能 的 。 另外 ， 由 于 数据 库 在 
master 上 删除 引起 的 会 话 关 闭 现在 报告 为 ERRCODE_DATABASE_DROPPED , 而 不 
是 ERRCODE_ADMIN_SHUTDOWN ， 所 以 连接 池 能 正确 的 处 理 该 情形 。 


e 防止 间歇 性 挂 在 启动 进程 和 后 端 宇 进 程 的 交互 中 (Simon Riggs) 
这 影响 在 非 热 各 份 情况 下 的 恢复 。 
。 不 人 允许 包括 复合 类 型 本 身 (Tom Lane) 


这 阻止 了 在 服务 器 中 义理 复合 类 型 时 会 无 限 递归 的 情形 。 当 可 能 有 一 些 这 样 的 机 构 的 使 
用 时 ， 它们 似乎 不 能 足够 合 人 信服 的 证 明 所 需要 的 努力 ， 以 确保 它 总 是 安全 的 工作 。 


在 目录 缓存 初始 化 期 间 避 免 潜在 的 死 锁 (Nikhil Sontakke) 


在 某 些 情况 下 ， 缓 存 加 载 代 码 在 锁 住 索引 的 目录 之 前 会 在 系统 索引 上 请 求 共享 锁 。 这 可 
能 会 死 锁 对 进程 试图 请 求 其 他 独占 锁 ， 更 标准 的 顺序 。 


修复 当 有 并 发 更 新 到 目标 元 组 时 BEFORE ROW UPDATE 触发 器 处 理 中 的 悬空 指针 问题 (Tom 
Lane) 


观察 到 这 个 错误 在 试图 做 UPDATE RETURNING ctid 时 ， 会 导致 间歇 性 的 "cannot extract 
system attribute from virtual tuple" 失 败 。 有 一 个 非常 小 的 概率 会 发 生 更 严重 的 错误 ， 如 
为 更 新 的 元 组 生成 不 正确 的 索引 条 目 。 


当 等 待 一 个 表 的 延迟 触发 的 事件 时 ， 不 允许 DROP TABLE (Tom Lane) 


以 前 的 prop 会 通过 ， 导 致 触发 器 最 终 触 发 时 的 "could not open relation with OID nnn" 错 


误 。 
在 pg_hba.conf 中 允许 "replication" 作 为 一 个 用 户 名 (Andrew Dunstan) 


"replication" 在 数据 库 名 字 字 段 中 是 特殊 的 ， 但 是 它 在 用 户 名 字段 中 被 错误 的 认为 也 是 特 
殊 的 。 


阻止 GEQO 最 优化 期 间 由 WHERE 条 件 常 量 错误 触发 的 骨 溃 (Tom Lane) 
改善 规划 者 处 理 半 连接 和 反 连 接 的 情况 (Tom Lane) 

修复 子 SELECT 中 sELECT For UPDATE 的 处理 (Tom Lane) 

这 个 错误 通常 导致 "cannot extract system attribute from virtual tuple" 错 误 。 
修复 文本 搜索 的 选择 性 估计 以 计算 NULL (Jesper Krogh) 


修复 get_actual_variable_range() 以 支持 通过 索引 指导 插件 假设 的 索引 注入 (Gurjeet 
Singh) 


修复 包含 数组 分 片 的 PL/Python 内 存 泄露 (Daniel Popowich) 
当 用 户 的 根 目 录 不 可 用 时 人 允许 libpq 的 SSL 成 功 初始 化 (Tom Lane) 


如 果 是 SSL 模 式 ， 那 么 根 证 书 文件 不 是 必须 的 ， 也 就 不 需要 失败 。 这 个 改变 恢复 到 9.0 之 
前 版 本 的 行为 。 


修复 libpq 为 在 conninfo_array_parse 中 检测 到 的 错误 返回 有 用 的 错误 信息 (Joseph 
Adams) 


打字 错误 导致 库 返 回 NULL 给 应 用 ， 而 不 是 包含 错误 信息 的 Pecon 构成 。 


修复 ecpg 预 处 理 器 对 浮 点 数 常 量 的 处 理 (Heikki Linnakangas) 

修复 并 发 的 pg_restore 以 正确 的 义理 POST_DATA 条 目 上 的 注释 (Arnd Hannemann) 
修复 pg_restore 以 处 理 TOC 文 件 中 较 长 的 行 (超过 1KB) (Tom Lane) 

针对 由 过 度 热 情 的 编译 器 优化 和 被 零 除 引起 的 朋 淡 投入 更 多 的 保障 (Aurelien Jarno) 


支持 在 MIPS 上 的 FreeBSD 和 OpenBSD 中 使 用 dlopen() (Tom Lane) 


有 一 个 硬 链 接 假 设 这 个 系统 功能 在 这 些 系 统 的 MIPS 硬 件 上 不 可 用 。 那么 使 用 一 个 编译 时 


测试 ， 因 为 最 近 的 版 本 有 这 个 功能 。 

修复 HP-UX 上 的 编译 错误 (Heikki Linnakangas) 

避免 在 启动 过 程 中 非常 时 的 党 试 写 人 Windows 控 制 台 时 的 崩溃 (Rushabh Lathia) 
支持 为 Windows 用 MinGW 64 位 编译 器 建立 (Andrew Dunstan) 

修复 Windows 上 libintl 的 版 本 不 兼容 问题 (Hiroshi Inoue) 


修复 xcopy 在 Windows 生 成 脚本 中 的 使 用 ， 以 在 Windows 7 下 正确 的 运转 (Andrew 
Dunstan) 


这 只 影响 生成 脚本 ， 不 影响 安装 或 使 用 。 
修复 在 Cygwin 上 被 pg_regress 使 用 的 路 径 分 隔 符 (Andrew Dunstan) 


更 新 时 区 数据 文件 到 tzdata 版 本 2011f， 因 为 DST 规 律 在 以 下 地 区 发 生 了 改变 : Chile, 
Cuba, Falkland Islands, Morocco, Samoa, 和 Turkey ; 还 有 South Australia, Alaska, 和 
Hawaii 的 历史 修正 。 


E.31. 版 本 9.0.3 


发 布 日 期 : 2011-01-31 


这 个 版 本 包含 各 种 自 9.0.2 以 来 的 修复 。 要 想 获得 关于 9.0 主 版 本 的 新 特性 ， 请 参阅 Section 
E.34。 


E.31.1. 迁移 到 版 本 9.0.3 


运行 9.0.X 版 本 的 用 户 不 需要 转 储 /恢复 。 


E.31.2. 修改 列表 


。 在 退出 walreceiver 之 前 ， 确 保 所 有 接收 到 的 WAL 同 步 到 磁盘 (Heikki Linnakangas) 


否则 各 用 服务 器 会 重 放 一 些 未 同步 的 WAL， 想 象 的 到 ， 如 果 系 统 正好 在 此 时 崩溃 ， 则 会 
导致 数据 损坏 。 


。 避免 walreceiver 中 过 度 的 同步 活动 (Heikki Linnakangas) 
。 需要 时 使 ALTER TABLE 的 唯一 性 和 排除 约束 重新 生效 (Noah Misch) 
这 在 9.0 中 ， 由 于 试图 在 vAcuuM FuLL 和 cLusTER 期 间 抑制 重新 生效 而 坏 掉 了 ， 但 是 无 意 


间 也 影响 到 了 ALTER TABLE o 
。 为 继承 树 的 UPDATE 修复 EvalPlanQual， 该 继承 树 中 的 表 并 不 都 是 相似 的 (Tom Lane) 


表 行 类 型 (包括 只 在 一 些 子 表 中 出 现 的 少量 的 字段 ) 的 任何 变化 都 将 使 EvalPlanQual 代 
码 混乱 ， 导致 错误 行为 蕊 至 崩溃 。 因 为 EvalPlanQual 只 在 并 发 更 新 到 相同 的 行 时 执行 ， 
该 问题 只 能 间歇 的 看 到 。 


e 避免 EXPLAIN 试图 显示 一 个 简单 形式 的 case 表达 式 时 的 失败 (Tom Lane) 


如 果 case 的 测试 表达 式 是 一 个 常量 ， 那 么 规划 器 将 简化 case 为 一 个 困惑 表达 式 显 示 代 
码 的 形式 ， 导 致 "unexpected CASE WHEN clause" 错 误 。 


。 修复 现 有 下 标 范 围 之 前 的 数组 切片 的 分 配 (Tom Lane) 


如 果 新 添加 的 下 标 和 原先 存在 的 下 标 之 间 存 在 一 个 缺口 ， 代码 错误 估算 了 需要 多 少 条 目 
从 老 数 组 的 空位 图 中 拷贝 ， 可 能 导致 数据 损坏 或 甬 溃 。 


。 避免 为 了 非常 远 的 日 期 值 在 规划 器 中 意外 的 转换 浴 出 (Tom Lane) 


date 类 型 比 timestamp 类 型 支持 更 大 范围 的 日 期 ， 但 是 规划 器 假设 它 可 以 总 是 不 受 惩罚 
的 转换 一 个 日 期 为 时 间 稚 。 


修复 一 个 数组 包含 空 条 目 时 的 PL/Python 损 坏 (Alex Hunsaker) 
为 定义 一 个 数组 维度 的 常量 删除 ecpg 的 固定 的 长 度 限制 (Michael Meskes) 
(ES QE... & !(subexpression) | ... 的 tsquery 值 的 错误 解析 (Tom Lane) 


包含 这 些 操作 符 的 组 合 的 查询 没有 正确 的 执行 。 相 同 的 错误 存在 于 contrib/intarray 
的 query_int 类 型 和 contrib/ltree 的 1txtquery 类 型 。 


修复 contrib/intarray 的 query_int 类 型 输入 画 数 中 的 缓冲 区 浴 出 (Apple) 


这 个 错误 是 一 个 安全 风险 ， 因 为 该 本 数 的 返回 地 址 会 被 重 写 。 感谢 Apple Inc 的 安全 团队 
报告 这 个 问题 并 提供 了 该 修复 。 (CVE-2010-4015) 


修复 contrib/seg 的 GiST picksplit 算 法 中 的 错误 (Alexander Korotkov) 


这 可 能 会 导致 大 量 的 低 效 ， 尽 管 不 是 实际 上 错误 的 答案 ， 在 seg 字段 上 的 GiST 索 引 中 。 
如 果 你 有 这 样 的 一 个 索引 ， 那 么 考虑 在 安装 这 个 更 新 之 后 REINDEX 它 。 (这 与 之 前 更 新 
的 contrib/cube 中 修复 的 错误 相同 。 ) 


E.32. 版 本 9.0.2 


发 布 日 期 : 2010-12-16 


这 个 版 本 包含 各 种 自 9.0.1 以 来 的 修复 。 要 想 获 得 关于 9.0 主 版 本 的 新 特性 信息 ， 请 参 
# Section E.34。 


E.32.1. 迁移 到 版 本 9.0.2 


运行 9.0.X 版 本 的 用 户 不 需要 转 储 /恢复 。 


E.32.2. 修改 列表 


© 强制 缺 省 wal_sync_method 在 Linux 上 为 fdatasync (Tom Lane, Marti Raudsepp) 


linux 上 的 缺 省 实际 上 已 经 fdatasync 很 多 年 了 ， 但 是 最 近 的 内 核 改 变 导 臻 PostgreSQL 选 
择 了 open_datasync 。 这 个 选择 不 会 导致 任何 性 能 改进 ， 并 且 在 某 些 文件 系统 上 导致 彻 
BWA, 尤其 是 带 有 data=journal 接口 选项 的 ext4 o 


。 修复 热 各 重 放 期 间 的 "too many KnownAssignedXids" 错 误 (Heikki Linnakangas) 
。 修复 热 各 期 间 锁 捕获 中 的 竞 态 条 件 (Simon Riggs) 
。 避免 热 各 期 间 不 必要 的 冲突 (Simon Riggs) 


这 修复 了 一 些 认为 重 放 和 与 各 用 查询 相 冲 突 的 情况 《导致 重 放 延迟 或 可 能 取消 查询 ) ， 但 
是 没有 真正 的 冲突 。 


。 修复 为 GIN 索 引 WAL 重 放 逻 辑 中 的 各 种 错误 (Tom Lane) 


这 会 导致 复制 期 间 "bad buffer id: 0" 失 败 或 索引 内 容 的 损坏 。 


。 修复 起 始 检查 点 WAL 记 录 和 它 的 重 做 点 不 在 同一 个 WAL 段 中 时 的 从 基础 各 份 中 恢复 (Jeff 
Davis) 


。 修复 在 创建 主 数据 库 集 群 之 后 立即 启用 流 复 制 时 的 极端 情况 错误 (Heikki Linnakangas) 


。 修复 多 个 workers 持 续 活跃 了 很 长 一 段 时 间 时 autovacuum workers 的 持续 放 缓 (Tom 
Lane) 


autovacuum worker 如 果 处 理 了 足够 的 表 ， 那 么 它 有 效 的 vacuum_cost_limit 可 以 下 降 到 
接近 需 ， 导 致 它 运 行 极其 的 慢 。 


。 修复 autovacuum 启 动 器 中 长 期 的 内 存 泄露 (Alvaro Herrera) 


避免 试图 从 一 个 事务 外 面 报告 一 个 迫近 的 事务 概括 条 件 时 的 失败 (Tom Lane) 
这 个 监督 防止 了 事务 概括 太 近 之 后 的 恢复 ， 因 为 数据 库 启 动 处 理会 失败 。 
添加 支持 检测 寄存 器 栈 在 IA64 LAH (Tom Lane) 

IA64 体系 结构 有 两 个 硬件 堆栈 。 全 面 预防 堆栈 浴 出 失败 都 需要 检查 。 

添加 一 个 copyobject() 中 堆栈 浴 出 的 检查 (Tom Lane) 

某 些 代 码 路 笃 会 由 于 给 出 足够 复杂 的 查询 堆栈 渝 出 而 月 演 。 
修复 临时 GiST 索 引 中 页 面 分 裂 的 检测 (Heikki Linnakangas) 


在 一 个 临时 索引 中 有 "并 发 的 "页 分 裂 是 可 能 的 ， 例 如 有 一 个 打开 的 游标 在 插入 时 扫描 索 
引 。 GiST 未 能 检测 这 种 情况 ， 并 且 因 此 可 能 当 游 标的 执行 继续 时 交付 错误 的 结果 。 


修复 早期 连接 过 程 期 间 的 错误 检查 (Tom Lane) 


太 多 子 进 程 的 检查 在 某 些 情况 下 是 跳 过 的 ， 可 能 会 导致 试图 添加 新 的 子 进程 到 固定 大 小 
的 数组 时 postmaster 骨 溃 。 


提高 窗口 画 数 的 效率 (Tom Lane) 


某 些 情况 需要 提前 读 取 大 量 的 元 组 ， 但 是 work_mem 足够 大 的 允许 它们 都 在 内 存 中 进行 ， 
这 会 出 乎 意料 的 慢 。 尤 其 是 percent_rank() , cume_dist() 和 ntile() 有 这 个 问题 。 


避免 ANALYZE 复 杀 的 索引 表达 式 时 的 内 存 泄露 (Tom Lane) 
确保 使 用 整 行 Var 的 索引 依赖 于 它 的 表 (Tom Lane) 


一 个 像 create index i on t (foo(t.*)) 这 样 声明 的 素 引 ， 当 它 的 表 被 删除 时 它 不 会 自动 
被 删除 。 


在 prop owen BY 中 为 删除 属于 一 个 用 户 的 外 部 数据 封装 /服务 器 权限 添加 缺失 支持 
(Heikki Linnakangas) 


不 要 用 多 个 ouT SR'inline"—SSQLHR (Tom Lane) 
这 避免 了 由 于 丢失 关于 预期 的 结果 行 类 型 的 信息 而 引起 的 可 能 的 崩溃 。 
修复 内 联 一 个 参数 列表 包含 一 个 引用 可 内 联 的 用 户 函 数 的 设置 返回 范 数 时 的 崩溃 (Tom 


Lane) 


如 果 ORDER BY , LIMIT , FOR UPDATE ,或 WITH 附属 于 INSERT ... VALUES 的 values 部 分 
则 行为 正确 (Tom Lane) 


使 oFF 关键 字 无 限制 (Heikki Linnakangas) 


cee 
破 了 ， 因 为 PL/pgSQL 现在 将 所 有 的 内 核 保 留 字 作为 保留 


修复 coALESCE() 表达 式 的 常量 部 分 (Tom Lane) 
规划 器 有 时 试图 计算 子 表达 式 ， 实 际 上 从 未 达成 ， 可 能 导致 预想 不 到 的 错误 。 
修复 "could not find pathkey item to sort" 规 划 器 带 有 整 行 Vars 比 较 失 败 (Tom Lane) 


修复 连接 接受 (accept) 或 在 它 之 后 立即 做 的 调用 中 的 一 个 ) 失败 时 的 postmaster 崩 
#, 并 且 postmaster 是 用 GSSAPI 支 持 编 译 的 (Alexander Chernikov) 


在 从 RADIUS 认 证 服务 器 接收 到 一 个 无 效 的 响应 包 之 后 重 试 (Magnus Hagander) 
这 修复 了 一 个 低 风 险 潜 在 拒绝 服务 的 情况 。 

修复 了 log_temp_files 活跃 时 错过 了 删除 临时 文件 (Tom Lane) 

如 果 在 试图 发 出 日 志 消 息 时 发 生 错误 ， 删 除 文件 没有 做 ， 导 致 临时 文件 的 积累 。 
为 InhRelation 节点 添加 打印 功能 (Tom Lane) 

这 避免 了 启动 debug_print_parse 和 执行 确定 类 型 的 查询 时 的 失败 。 

修复 了 从 一 个 点 到 一 个 水 平 线段 的 距离 的 不 正确 的 计算 (Tom Lane) 

这 个 错误 影响 几 个 不 同 的 几何 距离 测量 操作 。 

修复 ecpg 中 交易 状态 的 不 正确 的 计算 (Itagaki Takahiro) 

修复 psql 的 Unicode 逃 逸 支持 中 的 错误 (Tom Lane) 

当 为 档 包 含 许多 大 对 象 (blobs) 时 加 速 并 行 的 pg_restore (Tom Lane) 

修复 PL/pgSQL 处 理 "简单 的 "表达 式 ， 以 不 在 递 及 或 错误 恢复 的 情况 下 失败 (Tom Lane) 
修复 PL/pgSQL 错 误 报告 ho-such-column 的 情况 (Tom Lane) 


截止 到 9.0， 有 时 会 报告 "missing FROM-clause entry for table foo"， 而 此 时 "record foo 
has no field bar" 将 会 更 合适 。 


修复 分 配 到 元 组 字段 时 PL/Python 遵 从 typmod (也 就 是 ， 长 度 或 精度 限制 ) (Tom Lane) 
这 修复 了 从 8.4 的 回 为 。 

188 PL/Python 44 38 i (638 [5] 4X (Jan Urbanski) 
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修复 contrib/cube 的 GiST picksplit 算 法 中 的 错误 (Alexander Korotkov) 


这 可 能 会 导致 大 量 的 低 效 ， 尽 管 不 是 实际 上 错误 的 答案 ， 在 cube 字段 上 的 GiST 索 引 
中 。 如 果 你 有 这 样 的 一 个 索引 ， 那 么 考虑 在 安装 这 个 更 新 之 后 REINDEX Éo 


不 要 在 contrib/dblink 中 发 出 "identifier will be truncated" 通 知 ， 除非 创建 新 的 连接 时 
(Itagaki Takahiro) 


修复 contrib/pgcrypto 中 丢失 公 钥 潜在 的 内 核 转 储 (Marti Raudsepp) 
修复 contrib/pg_upgrade 中 的 缓冲 区 浴 出 (Hernan Gonzalez) 
修复 contrip/xm12 的 XPath 查 询 画 数 中 的 内 存 泄露 (Tom Lane) 


更 新 失去 数据 文件 为 tzdata 版 本 2010o， 因 为 DST 规 律 在 Fii 和 Samoa 发 生 了 改变 ; 还 有 
Hong Kong 的 历史 修正 。 


E.33. 版 本 9.0.1 


发 布 日 期 : 2010-10-04 


这 个 版 本 包含 各 种 自 9.0.0 以 来 的 修复 。 要 想 获 得 关于 9.0 主 版 本 的 新 特性 信息 ， 请 参 
# Section E.34。 


E.33.1. 迁移 到 版 本 9.0.1 


运行 9.0.X 版 本 的 用 户 不 需要 转 储 /恢复 。 


E.33.2. 修改 列表 


e 在 PL/Perl 和 PL/Tcl 中 为 每 个 调用 的 SQL userid 使 用 单独 的 解释 器 (Tom Lane) 


这 个 改变 阻止 由 破坏 稍 后 在 相同 的 会 话 中 不 同 的 SQL 用 户 身份 执行 的 Perl 或 Tcl 代 码 引 起 
的 安全 问题 (例如 ， 在 sEcuRITY DEFINER A) 。 大 多 数 脚本 语言 提供 多 种 可 能 做 的 
方式 ， 如 重新 定义 被 目标 画 数 调用 的 标准 画 数 或 操作 符 。 没 有 这 个 改变 ， 任何 拥有 Perl 
或 Tcl 语 言 使 用 权限 的 SQL 用 户 都 可 以 用 目标 函数 所 有 者 的 SQL 特权 从 本 质 上 做 任何 事 
情 。 


这 个 改变 的 成 本 是 Prel 和 Tcl 函 数 之 间 有 意 的 沟通 变 得 更 加 困难 。 为 了 提供 一 个 逃逸 出 
口 ， PL/PerIU 和 PL/TclU 本 数 继 续 每 个 会 话 只 使 用 过 一 个 解释 器 。 


有 可 能 要 求 提 供 可 信任 的 执行 的 第 三 方程 序 语言 有 相同 的 安全 问题 。 我 们 建议 为 了 安全 
性 关键 目的 ， 联 系 你 依赖 的 PL 的 作者 。 


我 们 感谢 Tim Bunce 提 出 这 个 问题 (CVE-2010-3433)。 


e 改善 pg_get_expr() 安全 修复 ， 以 便 该 琅 数 仍然 可 以 用 作 子 查 询 的 输出 (Tom Lane) 


修复 占 位 符 的 位 置 不 正确 的 评价 (Tom Lane) 


这 个 错误 会 导致 查询 输出 应 该 为 空 时 为 非 空 。 如 果 外 连接 的 内 侧 是 一 个 在 它 的 输出 列表 
中 带 有 非 严格 表达 式 的 子 查询 。 


修复 连接 除去 占 位 符 表达 式 的 处 理 (Tom Lane) 


。 修复 可 能 的 union aLL 成 员 关 系 的 副本 打 描 (Tom Lane) 


阻止 未 监听 之 后 ProcesslncomingNotify() 中 的 无 限 循 环 (Jeff Davis) 


e 阻止 show_session_authorization() 在 autovacuum 进 程 中 崩溃 (Tom Lane) 


。 重新 允许 儒 略 日 期 的 输入 在 0001-01-01 AD 之 前 (Tom Lane) 


像 'J100000': :date 这 样 的 输入 在 8.4 之 前 是 可 以 工作 的 ， 但 是 添加 错误 检查 后 无 意 的 打 
破 了 。 


e 使 psql 识 别 DISCARD ALL 为 一 个 命 舍 ， 该 命令 不 应 该 在 自动 提交 关闭 模式 下 包含 在 事务 
块 中 (Itagaki Takahiro) 


。 更 新 建立 基础 结构 和 文档 以 体现 源 代 码 仓库 从 CVS 搬 至 Git (Itagaki Takahiro) 


E.34. 版 本 9.0 


发 布 日 期 : 2010-09-20 


E.34.1. 概述 


这 个 


PostgreSQL 版 本 添加 了 请 求 多 年 的 特性 ， 例 如 易于 使 用 的 复制 ， 大 规模 权限 改变 设施 ， 


和 匿名 代码 块 。 而 以 前 的 主 版 本 在 这 些 范围 是 保守 的 ， 这 个 版 本 显示 了 一 个 大 胆 的 新 的 渴望 
提供 的 设施 ， 新 的 和 现 有 的 PostgreSQL 用 户 将 包含 在 内 。 这 些 都 做 到 了 ， 只 是 有 少许 的 不 兼 


DSS 
合 。 


主要 的 增强 功能 包括 : 


内 建 复制 基于 日 志 传送 。 这 个 发 展 包 括 两 个 特点 : 流 复制 ， 人 允许 持续 为 档 (WAL) 文件 ， 
在 网 络 连接 上 流出 到 各 用 服务 器 ; 热 备份 ， 人 允许 持续 为 档 备 用 服务 器 以 执行 只 读 的 查 
询 。 有 效 效 应 是 支持 一 个 主 服 务 器 带 有 多 个 只 读 从 服务 器 。 


更 简单 的 数据 库 对 象 权限 管理 。 GRANT / REVOKE IN scHEMA 支持 在 现 有 的 对 象 上 的 大 量 的 
权限 更 改 ， 而 ALTER DEFAULT PRIVILEGES 人 允许 控制 将 来 创建 的 对 象 的 权限 。 大 对 象 
(BLOBs) 现在 也 支持 权限 管理 。 


明显 提高 存储 过 程 支持 。 po 语句 支持 ad-hoc 或 "anonymous" 代 码 块 。 加 数 现在 可 以 用 
命名 的 参数 来 调用 。 PL/pgSQL 现 在 是 缺 省 安装 的 ， PL/Perl 和 PL/Python 已 经 从 几 个 方 
面 增强 了 ， 包 括 对 Python3 的 支持 。 


全 面 支持 64 位 Windows 


更 高 级 的 报告 查询 ， 包 括 附 加 的 窗口 选项 ( PRECEDING 和 FoLLowING ) 和 控制 值 以 什么 顺序 
供应 给 聚集 函数 的 能 力 。 


新 增 触 发 特征 ， 包 括 SQL 标 准 兼 容 每 字段 触发 器 和 条 件 触发 器 执行 。 
可 延期 的 唯一 约束 。 大 量 的 更 新 到 唯一 键 现在 不 带 有 欺骗 是 可 能 的 了 。 
排除 约束 。 这 些 提供 了 一 个 唯一 约束 的 广义 版 本 ， 人 允许 执行 复杂 的 条 件 。 


新 增 和 加 强 的 安全 特性 ， 包 括 RADIUS 认 证 ，LDAP 认 证 改进 ， 和 一 个 新 的 贡献 模块 
passwordcheck 测试 密码 强度 。 


新 增高 性 能 实现 Listen / NoTIFY 特性 。 等 待 发 生 的 事件 现在 存储 在 一 个 基于 内 存 的 队 
列 中 ， 而 不 是 一 个 表 中 。 还 有 ，"payload" 字 符 串 可 以 被 每 个 事件 发 送 ， 而 不 是 和 以 前 一 
样 只 能 是 一 个 事件 名 传送 。 


新 增 vacuum FULL 的 实现 。 这 个 命令 现在 改写 全 部 的 表 和 索引 ， 而 不 是 移动 个 别 的 行 到 
紧密 空间 。 它 实 质 上 在 大 多 数 情况 下 更 快 ， 并 且 不 再 导致 索引 膨胀 。 


。 新 增 贡 献 模块 pg_upgrade ， 支持 从 8.3 或 8.4 到 9.0 的 就 地 升级 。 


。 对 于 特定 类 型 的 查询 的 多 种 性 能 增强 ， 包 括 删除 不 需要 的 连接 。 这 帮助 优化 了 一 些 自动 
生成 的 查询 ， 上 比如 由 对 象 关系 映射 (ORMs) 产生 的 那些 。 


e EXPLAIN 增强 。 该 输出 现在 可 以 用 在 JSON, XML, 或 YAML 格 式 中 ， 并 且 包 括 缓 冲 区 利 
用 和 以 前 不 可 用 的 其 他 数据 。 


® hstore 增强 ， 包括 新 功能 和 更 大 的 数据 容量 。 
以 上 的 条 目 在 下 面 的 章节 中 有 更 详细 的 介绍 。 


E.34.2. 迁移 到 版 本 9.0 
使 用 pg_dump 或 使 用 pg_upgrade 的 转 储 /恢复 ， 对 于 那些 想 要 从 任何 以 前 的 版 本 迁移 数据 的 
人 来 说 是 必须 的 。 


版 本 9.0 包 含 若 干 有 选择 的 突破 向 后 兼容 的 改变 ， 为 了 支持 新 特性 和 编码 质量 改善 。 特别 的 ， 
使 得 PL/pgSQL、Point-In-Time Recovery (PITR)、 或 Warm Standby 广 泛 应 用 的 用 户 ， 应 该 
测试 他 们 的 应 用 ， 因 为 在 这 些 地方 有 轻微 的 用 户 可 见 的 改变 。 观察 下 面 的 不 兼容 : 


E.34.2.1. ARs asi E 
。 删除 服务 器 参数 add_missing_from ， 该 参数 缺 省 为 off 已 经 很 多 年 了 (Tom Lane) 


。 删除 服务 器 参数 regex_flavor ， 该 参数 缺 省 为 advanced 已 经 很 多 年 了 (Tom Lane) 


e archive mode 现在 只 影响 archive_command ; 一 个 新 的 设置 ， wal_level ， 影响 预 写 式 
日 志 的 内 容 (Heikki Linnakangas) 


e log temp files 现在 使 用 缺 省 文件 尺寸 单位 kilobytes (Robert Haas) 


E.34.2.2. 查询 


e 当 查 询 一 个 parent table 时 ， 不 要 在 作为 查询 一 部 分 扫描 的 子 表 上 做 任何 单独 的 权限 检查 
(Peter Eisentraut) 


SQL 标准 声明 这 个 行为 ， 并 且 它 在 实际 上 比 以 前 在 每 个 子 表 上 和 父 表 一 样 检查 权限 的 行 
为 更 加 方便 。 


E.34.2.3. 数据 类 型 
e bytea 输出 现在 缺 省 以 十 六 进 制 格式 显示 (Peter Eisentraut) 


服务 器 参数 bytea_output 可 以 用 来 选择 传统 的 输出 格式 ， 如 果 为 了 兼容 需 ° 


。 数组 输入 现在 只 考虑 纯 ASCI| 空 白字 符 潜在 的 忽略 ; 它 将 永 不 忽略 非 ASCll 字 符 ， 即使 它 
们 根据 某 些 语言 环境 是 空白 (Tom Lane) 
这 避免 了 根据 服务 器 本 地 设置 ， 数 组 值 会 被 不 同 的 解释 的 某 些 极端 情况 。 

© 改善 标准 兼容 SIMILAR to 模式 和 SQL 风格 substring() 模式 (Tom Lane) 
这 包括 将 ? 和 {...} 处 理 为 模式 元 字符 ， 而 它们 以 前 只 是 简单 的 文字 字符 ; 这 相当 于 在 
SQL:2008 中 添加 的 新 特性 。 A, ^ 和 $ 现在 视 为 简单 的 文字 字符 ; 以 前 它们 视 为 元 
字符 ， 好 像 模式 遵从 POSIX 而 不 是 SQL 规则 。 还 有 ，SQL 标 准 的 substring) , (AW 


HSE, 不 再 干扰 子 字符 串 的 捕获 。 还 有 ， 括 号 表达 式 (字符 类 ) 的 处 理 现在 更 加 
标准 兼容 了 。 


根据 SQL 标准 ， 在 为 位 字符 串 的 3 参数 substring() 中 拒绝 负 的 长 度 值 (Tom Lane) 


当 减 少 分 数秒 精度 时 使 date_trunc 截断 而 不 是 圆 整 (Tom Lane) 
代码 对 于 基于 整 型 的 日 期 /时 间 总 是 这 样 动作 。 现 在 基于 浮 点 数 的 日 期 /时 间 行 为 相似 。 


E.34.2.4. 对 象 重 命名 


© 当 一 个 子 表 从 多 个 无 关 的 父 表 中 继承 相同 的 字段 时 ， 在 Rename 期 间 严 格 执行 字段 名 的 一 
致 性 (KaiGai Kohei) 


。 当 基 础 表 字 段 重 命名 时 不 再 自动 重 命名 素 引 和 索引 字段 (Tom Lane) 


超级 管理 员 仍 然 可 以 手动 重 命名 这 样 的 索引 和 字段 。 这 个 改变 将 需要 更 新 JDBC 驱 动 ， 和 
可 能 的 其 他 驱动 ， 以 便 唯 一 索引 在 重 命名 之 后 正确 的 重组 。 


e CREATE OR REPLACE FUNCTION 可 以 不 再 改变 函数 参数 声明 的 名 字 (Pavel Stehule) 


为 了 避免 在 命名 的 参数 调用 中 创建 歧义 ， 不 再 允许 在 一 个 现 有 画 数 的 声明 中 改变 输入 参 
数 的 别名 (尽管 名 字 仍 然 可 以 分 配给 以 前 未 命名 的 参数 ) 。 要 那样 做 ， 你 现在 必 
须 prop 并 重新 创建 该 轿 数 。 


E.34.2.5. PL/pgSQL 


。 如 果 变 量 名 与 查询 中 使 用 的 字段 名 冲突 ，PL/pgSQL 现 在 抛 出 一 个 错误 (Tom Lane) 
以 前 的 行为 是 绑 定 歧义 名 为 PL/pgSQL 变 量 优先 于 查询 字段 ， 这 经 常 导 致 人 人 吃惊 的 错误 
行为 。 扫 出 一 个 错误 允许 简单 的 检测 引起 歧义 的 情景 。 虽然 建议 函数 遇 到 这 种 类 型 的 错 
误 时 修改 为 移 除 该 冲突 ， 但 是 如 果 需 要 ， 旧 的 行为 可 以 被 修复 ， 通 过 配置 参 


数 plpgsql.variable_conflict , Ht SPS HAN iM #variable_conflict o 


© PL/pgSQL 不 再 允许 匹配 特定 SQL 保留 字 的 变量 名 (Tom Lane) 


这 是 校正 PL/pgSQL 分 析 器 更 密切 的 匹配 内 核 SQL 分 析 器 的 一 个 后 果 。 如 果 需 要 ， 变量 名 
可 以 用 双 引 号 引起 来 以 避免 这 种 限制 。 


。 PL/pgSQL 现 在 要 求 复 合 结果 的 字段 和 基础 类 型 一 样 匹 配 预 期 的 类 型 修饰 符 (Pavel 
Stehule, Tom Lane) 


例如 ， 如 果 结 果 类 型 的 字段 声明 为 NuMERIc(36,2) ， 那 么 它 不 再 适用 于 在 该 字段 中 返回 一 
个 其 他 精度 的 NuMERIC 。 以 前 的 版 本 忽略 了 检查 类 型 修饰 符 ， 并 且 因 此 允许 结果 行 实际 
上 并 不 符合 声明 的 限制 。 


。 PL/pgSQL 现 在 对 待 选择 到 复合 字段 更 加 一 致 (Tom Lane) 


以 前 ， 像 SELECT ... INTO _rec_._ fld. FROM... 这 样 的 声明 被 当做 是 标量 赋值 ， 即 
使 记录 字段 tla 是 复合 类 型 。 现在 ， 它 被 当做 记录 赋值 ， 当 mro 目标 是 一 个 复合 类 
型 的 规则 变量 时 也 是 一 样 的 。 所 以 被 赋予 到 字段 的 子 字 段 的 值 应 该 被 写 为 SELECT 列表 的 
单独 的 列 ， 不 是 在 以 前 版 本 中 Row(...) 构造 那样 。 


如 果 你 需要 一 个 在 9.0 和 以 前 版 本 中 都 能 运行 的 方式 来 做 这 点 ， 你 可 以 像 这 样 来 写 : 
rec_. _fld := ROW(...) FROM .…。 


删除 PL/pgSQL 的 RENAME 声明 (Tom Lane) 
取代 rename ， 使 用 as, 现在 可 以 为 任意 变量 创建 一 个 别名 ， 不 只 是 和 以 前 一 样 的 
美元 符号 参数 名 称 ( 如 $1 )。 
E.34.2.6. 其 他 的 不 兼容 
。 TEREA zegt; 作为 一 个 操作 符 名 称 (Robert Haas) 


将 来 版 本 的 PostgreSQL 可 能 完全 拒绝 这 种 操作 符 名 ， 为 了 支持 命名 函数 参数 的 SQL 标准 
符号 。 目 前 ， 仍 然 是 允许 的 ， 但 是 定义 这 样 的 一 个 操作 符 时 会 发 出 警告 。 


。 删除 对 没有 64 位 整数 数据 类 型 工作 的 平台 的 支持 (Tom Lane) 
认为 所 有 仍然 支持 的 平台 有 64 位 整数 数据 类 型 工作 。 


E.34.3. 修改 列表 


版 本 9.0 有 一 个 前 所 未 有 的 新 主 版 本 特性 的 数量 ， 超 过 200 个 增强 、 ee. HiT, AIBN 
数 和 其 他 修改 。 


E.34.3.1. 服务 妖 
E.34.3.1.1. 连续 存档 和 流 复制 


PostgreSQL 的 现 有 各 用 服务 器 性 能 已 经 扩展 为 支持 在 备用 服务 器 上 只 读 查 询 和 大 大 减少 主 从 
服务 器 之 间 的 延迟 。 对 于 很 多 用 户 ， 这 将 是 流 复制 的 一 个 有 用 和 低 管 理 的 形式 ， 要 么 为 了 高 
可 用 性 ， 要 么 为 了 水 平 伸缩 性 。 


© 允许 备用 服务 器 接受 只 读 查 询 (Simon Riggs, Heikki Linnakangas) 


这 个 特性 称 为 热 备份 。 有 新 的 postgresql.conf 和 recovery.conf 设置 控制 这 个 特性 ， 还 
有 大 量 的 文档 


。 人 多 许 预 写 式 日 志 (WAL) 数 据 流 到 各 用 服务 器 (Fujii Masao, Heikki Linnakangas) 


这 个 特性 称 为 流 复 制 。 以 前 的 WAL 数 据 只 能 以 整个 WAL 文件 〈 通 常 每 个 16 百 万 字 节 ) 为 
基本 单位 被 送 到 备用 服务 器 。 流 复制 消除 低 效 ， 并 且 人 允许 在 主 服 务 器 上 的 更 新 以 非常 小 
的 延迟 传送 到 各 用 服务 器 上 。 有 新 的 postgresql.conf 和 recovery.conf 设置 控制 这 个 特 
性 ， 还 有 大 量 的 文档 。 





° 添加 pg_last_xlog_receive_location() 和 pg_last_xlog_replay_location() ， 可 以 用 来 监 
控 各 用 服务 器 的 WAL 活 动 (Simon Riggs, Fujii Masao, Heikki Linnakangas) 


E.34.3.1.2. 性 能 


e 人 允许 通过 ALTER TABLESPACE ... SET/RESET 为 连续 的 和 随机 的 页 面 成 本 估算 
( seq_page_cost / random_page_cost ) 设置 每 个 表 空 间 的 值 (Robert Haas) 


。 提高 性 能 和 连接 查询 中 的 EvalPlanQual 再 核查 (Tom Lane) 


包含 连接 的 UPDATE , DELETE , 和 SELECT FOR UPDATE/SHARE 查询 现在 在 遇 到 最 近 更 新 的 
行 时 表现 的 更 好 。 


e 当 表 早 些 时 候 在 同一 个 事务 中 被 创建 或 截断 时 ， 改 善 TRUNCATE 的 性 能 (Tom Lane) 


提高 找到 继承 子 表 的 性 能 (Tom Lane) 


E.34.3.1.3. 优化 
。 删除 不 需要 的 外 连接 (Robert Haas) 


内 侧 的 外 连接 是 唯一 的 ， 并 且 不 被 连接 的 上 级 引用 ， 因 此 现在 删除 了 。 这 将 加 速 许 多 自 
动 生 成 的 查询 ， 如 那些 通过 对 象 关 系 映射 (ORMs) 创 建 的 查询 。 


e 人 允许 Is not NULL 限制 使 用 索引 (Tom Lane) 

这 对 于 在 包含 许多 空 值 的 索引 中 发 现 MAx() / MIN() 值 是 尤其 有 用 的 。 
e 改善 优化 器 为 DISTINCT 选择 何 时 使 用 物化 节点 ， 何 时 使 用 排序 和 散 列 (Tom Lane) 
e 改善 优化 器 为 包含 boolean alt;agt; 操作 符 的 表达 式 的 等 价 性 检测 (Tom Lane) 


E.34.3.1.4. GEQO 


。 每 次 GEQO 规 划一 个 查询 时 使 用 相同 的 随机 种 子 (Andres Freund) 


Genetic Query Optimizer (GEQO) 仍 然 选择 随机 规划 ， 它 现在 总 是 为 相同 的 查询 选择 相同 
的 随机 规划 ， 从 而 给 出 更 加 一 致 的 性 能 。 可 以 修改 geqo seed 试验 可 选择 的 规划 。 


。 改善 GEQO 规 划 选 择 (Tom Lane) 


这 避免 了 少 有 的 错误 "failed to make a valid plan"， 并 且 应 该 提升 了 规划 速度 。 


E.34.3.1.5. 优化 器 统计 信息 
e 改善 ANALYZE 以 支持 继承 树 统计 信息 (Tom Lane) 


这 对 于 分 区 表 特 别 有 用 。 不 过 ， 当 子 表 改 变 时 autovacuum 目 前 还 没有 自动 重新 分 析 父 
表 。 


。 当 需 要 重新 分 析 时 ， 改 善 autovacuum 的 检测 (Tom Lane) 
。 改善 优化 器 对 于 大 于 /小 于 比较 的 估计 (Tom Lane) 


当 查 阅 对 于 大 于 /小 于 比较 的 统计 信息 时 ， 如 果 上 比较 值 是 直方 图 的 第 一 个 或 最 后 一 个 ， 使 
用 一 个 索引 〈 如 果 可 用 ) 抓 全 当前 实际 字段 的 最 小 或 最 大 值 。 这 大 大 的 提高 了 估算 接近 
数据 范围 结尾 的 比较 值 的 精确 度 ， 尤其 是 当 范围 由 于 新 数据 的 添加 而 持续 变化 时 。 


。 人 允许 不 同 值 数量 统计 的 设置 使 用 acter TaLe (Robert Haas) 
这 人 允许 用 户 重 载 一 个 字段 的 不 同 值 的 估计 数量 或 百分比 。 这 个 统计 通常 通过 ANALYZE it 
算 ， 但 是 估计 可 能 会 差 些 ， 尤 其 是 在 有 非常 多 的 行 的 表 上 。 
E.34.3.1.6. 认证 


e 添加 对 RADIUS (Remote Authentication Dial In User Service) 认 证 的 支持 (Magnus 
Hagander) 


e 人 允许 LDAP(Lightweight Directory Access Protocol) 认证 在 "search/bind" 模 式 下 操作 
(Robert Fleming, Magnus Hagander) 


这 人 允许 用 户 先 查找 ， 然 后 系统 使 用 DN (Distinguished Name) 返回 给 那个 用 户 。 
e 添加 samehost 和 samenet 指定 到 pg_hba.conf (Stef Walter) 
这 些 分 别 匹 配 服 务 器 的 IP 地 址 和 子 网 地 址 。 
。 传递 信任 的 SSL 根 证 书 名 字 到 客户 端 ， 这 样 客户 端 可 以 返回 一 个 合适 的 客户 端 证 书 (Craig 
Ringer) 
E.34.3.1.7. 监控 


。 添加 客户 端 设置 应 用 名 的 能 力 ， 在 pg_stat_activity 中 显示 (Dave Page) 


这 人 允许 管理 员 表 现 数 据 流量 和 通过 源 应 用 寻找 故障 问题 。 

添加 SQLSTATE 选 项 ( %e ) 到 log line prefix (Guillaume Smet) 
这 人 允许 用 户 通过 错误 代码 数量 编制 错误 和 消息 的 统计 数据 。 

以 UTF16 编 码 写 入 Windows 事 件 记 录 (Itagaki Takahiro) 


现在 在 Windows 上 的 PostgreSQL 记 录 消 息 支持 多 种 语言 。 


E.34.3.1.8. 统计 计数 器 


添加 pg_stat_reset_shared('bgwriter') 为 后 端 守 入 重 置 集群 范围 的 共享 统计 数据 (Greg 
Smith) 


添加 pg_stat_reset_single table counters() 
和 pg_stat_reset_single_function_counters() ， 人 允许 为 单独 的 表 和 和男 数 重 置 统 计 计数 器 
(Magnus Hagander) 








E.34.3.1.9. 服务 器 设置 


允许 配置 参数 的 设置 基于 database/role combinations (Alvaro Herrera) 


以 前 ， 只 有 每 个 数据 库 和 每 个 角色 的 设置 是 可 能 的 ， 组 合 是 不 行 的 。 所 有 和 角色 和 数据 库 
设置 现在 存储 在 新 的 pg_db_role_setting 系统 目录 中 。 新 的 psql 命 令 \drds 显示 了 这 些 
设置 。 遗留 系统 视图 pg_roles ，pg_shadow， 和 pg_user 不 显示 组 合 设置 ， 并 且 因 此 不 
再 完全 的 代表 一 个 用 户 或 数据 库 的 配置 。 


添加 服务 器 参数 bonjour, 控制 启用 Bonjour 的 服务 器 是 否 通过 Bonjour 通 知 它 自己 (Tom 
Lane) 


缺 省 为 off， 意 味 着 它 不 做 通知 。 这 人 允许 包装 程序 分 配 馈 用 Bonjour 的 建立 时 不 用 担心 个 别 
用 户 可 能 不 想 要 这 个 特性 。 


添加 服务 器 参数 enable material , 控制 在 优化 器 中 物化 节点 的 使 用 (Robert Haas) 


缺 省 为 on。 为 off 时 ， 优 化 器 将 不 是 纯粹 的 为 性 能 原因 添加 物化 节点 ， 尽管 他 们 在 为 了 正 
确 性 的 需要 时 仍然 被 使 用 。 


修改 服务 器 参数 log temp files 使 用 干 字 节 为 缺 省 文件 大 小 单位 (Robert Haas) 
以 前 ， 如 果 没 有 声明 单位 ， 这 种 设置 解释 为 字 节 计 。 
当 postgresql.conf 重新 加 载 时 日 志 参 数值 的 变化 (Peter Eisentraut) 


这 使 得 管理 员 和 安保 员 审 计数 据 库 设置 的 修改 ， 并 且 也 非常 方便 检查 postgresql.conf 编 
辑 的 效果 。 


正确 执行 自 定义 服务 器 参数 的 超级 用 户 权 限 (Tom Lane) 


非 超级 用 户 不 能 再 为 服务 器 目前 不 知道 的 参数 发 出 ALTER ROLE / DATABASE SET 这 人 允许 服 
务 器 正确 的 检查 仅 超 级 用 户 的 参数 只 有 通过 超级 用 户 设 置 。 以 前 ， 人 允许 SET 并 且 在 会 话 
开始 的 时 候 忽略 ， 使 得 仅 超级 用 户 的 自 定 义 参 数 比 其 应 该 有 的 作用 要 小 的 多 。 


E.34.3.2. 查询 


e 在 应 用 LIMIT 之 后 执行 SELECT FOR UPDATE / SHARE 义理 ， 这 样 返回 的 行 数 总 是 可 预见 的 
(Tom Lane) 


以 前 ， 并 发 事务 所 做 的 改变 会 导致 SELECT FOR UPDATE 返回 的 行 数 出 平 意料 的 少 于 它 
AY LIMIT 声明 的 行 数 。 FoR UPDATE 和 oRDER BY 的 组 合 也 会 产生 令 人 惊讶 的 结果 ， 但 是 
可 以 通过 在 子 句 中 放置 For uppate 来 纠正 。 


© 人 多 许 传 统 的 和 SQL 标准 的 LIMIT / oFFsET 语法 混合 (Tom Lane) 
。 在 窗口 函数 中 扩展 支持 的 框架 选项 (Hitoshi Harada) 


框架 现在 可 以 以 current row 开始 ， 并 且 现 在 支持 Rows _n_ 
PRECEDING/ FoLLowING 选项 。 


e 使 得 SELECT INTO 和 CREATE TABLE AS 在 它们 的 命令 标签 中 返回 行 计 数 到 客户 端 
(Boszormenyi Zoltan) 


这 可 以 节省 到 客户 端的 整个 往返 ， 允 许 结果 计数 和 页 码 的 计算 不 带 有 附加 的 couNT & 
询 。 


E.34.3.2.1. Unicode 字符 串 
。 在 ue 字符 串 和 标识 符 中 支持 Unicode 代 理 对 ( 段 16 位 表现 ) (Peter Eisentraut) 


。 在 E'...' 字符 串 中 支持 Unicode 逃 逸 (Marko Kreen) 


E.34.3.3. 对 象 操 作 
。 通过 定义 冲刷 到 磁盘 加 速 create DATABASE (Andres Freund, Greg Stark) 


。 只 允许 注释 在 表 、 视 图 和 复合 类 型 的 字段 上 ， 不 允许 在 其 他 关系 类 型 如 索引 和 TOAST 表 
上 (Tom Lane) 


© DARS XE 的 创建 不 包含 值 (Bruce Momjian) 


。 使 有 存储 类 型 man 的 字段 的 值 保留 在 主 堆 页 上 ， 除了 不 适合 在 一 个 页 面 上 的 行 (Kevin 
Grittner) 


以 前 ， MAIN 值 被 迫 离开 到 TOAST 表 ， 直到 行 的 大 小 小 于 页 面 大 小 的 四 分 之 一 。 


E.34.3.3.1. ALTER TABLE 


e Æ ALTER TABLE DROP COLUMN 和 ALTER TABLE DROP CONSTRAINT 实现 了 IF EXISTS (Andres 
Freund) 


e 人 允许 ALTER TABLE 命令 重 写 表 以 跳 过 WAL 记 录 (Itagaki Takahiro) 


这 样 的 操作 要 么 生成 一 个 该 表 的 新 的 撕 贝 ， 要 么 回 滚 ， 所 以 可 以 跳 过 WAL 汶 档 ， 除非 运 
行 在 连续 为 档 模式 。 这 样 减少 了 I/O 开 支 ， 并 且 提 高 了 性 能 。 


e 修复 不 是 表 的 所 有 者 执行 ALTER TABLE _table ” ADD COLUMN _col serial 时 的 失败 
(Tom Lane) 


E.34.3.3.2. CREATE TABLE 


e 添加 在 CREATE TABLE ... LIKE 命令 中 拷贝 comments 和 storace 字符 串 的 支持 (Itagaki 
Takahiro) 


e 添加 拷贝 CREATE TABLE ... LIKE 命令 中 所 有 属性 的 快捷 方式 (ltagaki Takahiro) 
e 添加 SQL 标准 的 CREATE TABLE ... OF _type_ 命令 (Peter Eisentraut) 
这 人 允许 表 的 创建 匹配 一 个 现 有 的 复合 类 型 。 附 加 约束 和 默认 值 可 以 在 该 命 全 中 指定 。 


E.34.3.3.3. 约束 
。 添加 可 推迟 的 唯一 约束 (Dean Rasheed) 


这 人 允许 大 量 的 更 新 ， 如 UPDATE tab SET col = col + 1 ， 可 靠 的 运行 在 有 唯一 索引 或 标记 
为 主键 的 字段 上 。 如 果 约 束 被 指定 为 DEFERRABLE ， 那么 它 将 在 语句 的 最 后 被 检查 ， 而 不 
是 在 每 行 被 更 新 之 后 。 该 约束 检查 也 可 以 被 推迟 到 当前 事务 的 结尾 ， 人 允许 这 样 的 更 新 在 
多 个 SQL 命令 中 传播 。 


e 增加 了 排除 约束 (Jeff Davis) 


排除 约束 通过 允许 任意 的 比较 操作 符 (不 只 是 相等 ) 概括 唯一 约束 。 它们 是 
FA CREATE TABLE CONSTRAINT ... EXCLUDE 子 句 创建 的 。 排除 约束 最 常见 的 使 用 是 声明 字段 
记录 不 能 重复 ， 而 不 只 是 简单 的 不 能 相等 。 这 对 于 时 间 阶 段 和 其 他 范围 还 有 数组 是 有 用 
的 。 这 个 特性 为 许多 日 程 、 时 间 管 理 和 科学 应 用 加 强 了 数据 完整 性 的 检查 。 


。 改善 唯一 约束 违反 的 错误 消息 以 报告 导致 该 失败 的 值 (ltagaki Takahiro) 


例如 ， 唯 一 约束 违反 现在 可 以 报告 key (x)=(2) already exists o 


E.34.3.3.4. 对 象 权 限 


e 添加 使 用 新 的 GRANT / REVOKE IN SCHEMA 子 句 在 整个 模式 中 改变 大 量 权 限 的 能 力 (Petr 
Jelinek) 


这 简化 了 对 象 权限 的 管理 ， 并 且 使 得 应 用 数据 安全 更 容易 的 利用 数据 库 角色 。 


e 添加 ALTER DEFAULT PRIVILEGES 命令 以 控制 稍 后 创建 的 对 象 的 权限 (Petr Jelinek) 


这 大 大 的 简化 了 复杂 数据 库 应 用 中 对 象 权限 的 分 配 。 可 以 为 表 、 视 图 、 序 列 和 画 数 设置 
缺 省 权限 。 缺 省 可 以 在 每 个 模式 的 基础 上 或 者 数据 库 范围 内 分 配 。 


e 添加 用 GRANT / REVOKE 控制 大 对 象 (BLOB) 权 限 的 能 力 (KaiGai Kohei) 
以 前 ， 任 意 数据 库 用 户 可 以 读 取 或 者 修改 任何 大 对 象 。 现在 可 以 赋予 和 撤销 每 个 大 对 象 
的 读 取 和 写 入 权限 ， 并 且 追 踪 大 对 象 的 所 有 者 关系 。 


E.34.3.4. 实用 操作 


e 使 得 Listen / NoTIFY 存储 在 一 个 内 存 序列 中 等 待 事件 ， 而 不 是 在 一 个 系统 表 中 
(Joachim Wieland) 


这 在 保留 事务 支持 和 保证 交付 的 现 有 特性 时 大 幅度 的 提升 了 性 能 。 
e 多 许 NOTIFY 传送 一 个 可 选 的 "payload" 字 符 串 到 监听 器 (Joachim Wieland) 
这 大 大 的 提升 了 Listen / NoTIFY 作为 一 个 通用 的 事件 队列 系统 的 有 用 性 。 
。 人 允许 在 所 有 的 数据 库 系 统 目 录 上 cluster (Tom Lane) 
共享 的 目录 仍然 不 能 集群 。 
E.34.3.4.1. COPY 
e 接受 copy ... CSV FORCE QUOTE * (Itagaki Takahiro) 
现在 * 在 Force quote 子 句 中 可 以 用 作 " 所 有 字段 "的 简写 。 
e 添加 新 的 copy 语法 ， 人 允许 选项 在 圆 括号 内 部 指定 (Robert Haas, Emmanuel Cecchet) 


这 人 允许 未 来 的 coy 选项 有 更 大 的 灵活 性 。 仍 然 支 持 旧 的 语法 ， 但 是 只 对 已 经 存在 的 选 


项 。 


E.34.3.4.2. EXPLAIN 
e 人 允许 EXPLAIN 以 XML、JSON 或 YAML 格式 输出 (Robert Haas, Greg Sabino Mullane) 
新 的 输出 格式 是 容易 机 器 可 读 的 ， 支 持 分 析 ExPLAIN 输出 的 新 工具 的 发 展 。 
e 添加 新 的 BUFFERS 选项 报告 EXPLAIN ANALYZE 期 间 查 询 缓 冲 区 的 使 用 (Itagaki Takahiro) 


这 人 允许 为 单个 查询 更 好 的 查询 分 析 。 缓 冲 区 的 使 用 不 再 在 log_ statement_stats 和 相关 设 
置 的 输出 中 报告 。 


。 添加 散 列 使 用 信息 到 ExpLAIN 输出 (Robert Haas) 


e 添加 新 的 ExPLAIN 语法 ， 人 允许 选项 在 圆 括 号 内 部 指定 (Robert Haas) 


这 人 允许 未 来 的 ExPLAIN 选项 有 更 大 的 灵活 性 。 仍 然 支持 旧 的 语法 ， 但 是 只 对 已 经 存在 的 


Ge i 


项 。 


E.34.3.4.3. VACUUM 


e 改变 vacuum FULL 重 写 整个 表 和 重建 它 的 素 引 ， 而 不 是 围绕 紧 致 的 空间 移动 个 别 的 行 
(Itagaki Takahiro, Tom Lane) 


以 前 的 方法 通常 较 慢 ， 并 且 导 致 索引 膨胀 。 请 注意 ， 新 的 方法 将 在 vacuum FULL 期 间 瞬 
间 使 用 更 多 磁盘 空间 ; 可 能 是 正常 被 该 表 和 它 的 素 引 占用 的 空间 的 两 倍 。 


e 添加 新 的 vacuum 语法 ， 人 允许 选项 在 圆 括 号 内 部 指定 (Itagaki Takahiro) 
这 人 允许 未 来 的 vacuum 选项 有 更 大 的 灵活 性 。 仍 然 支持 旧 的 语法 ， 但 是 只 对 已 经 存在 的 选 
项 。 
E.34.3.4.4. 索引 
© 人 允许 索引 在 create INDEX 中 通过 省 略 素 引 名 自动 命名 (Tom Lane) 


。 缺 省 的 ， 多 字段 素 引 现在 以 所 有 它们 的 字段 命名 ; 索引 表达 式 字 段 现 在 基于 它们 的 表达 
式 命 名 (Tom Lane) 


。 重建 共享 系统 目录 索引 现在 是 完全 事务 性 并 且 骨 溃 安 全 了 (Tom Lane) 


以 前 ， 重 建 共享 索引 只 人 允许 在 单机 模式 ， 并 且 在 操作 期 间 崩 淡 会 使 索引 在 一 个 比 之 前 更 
糟糕 的 状态 。 


e 为 GiST 添 加 point_ops 运算 符 类 (Teodor Sigaev) 


这 个 特性 许可 GiST 索 引 point 字段 。 该 索引 可 以 用 于 查询 的 几 个 类 型 ， 如 _point_ 
&lt;@ _polygon. (点 在 多 边 形 中 ) 。 这 应 该 使 得 许多 PostGIS 查 询 快 很 多 。 


。 为 GIN 索 引 创 建 使 用 红 黑 二 叉 树 (Teodor Sigaev) 
红 黑 树 是 自动 平衡 的 。 避 免 了 非 随机 的 输入 顺序 情况 下 的 减速 。 


E.34.3.5. 数据 类 型 
e 人 允许 bytea 值 以 十 六 进 制 符号 书写 (Peter Eisentraut) 


服务 器 参数 pytea_output 控制 十 六 进 制 还 是 传统 格式 用 于 pytea 输出 。 当 连接 到 
PostgreSQL 9.0 或 更 新 的 服务 器 时 ，Libpq 的 ”PQescapeByteaconn() PRA ate ANH 
制 格 式 。 不 过 ，9.0 以 前 的 libpq 版 本 将 不 能 为 更 新 的 服务 器 处 理 十 六 进 制 格式 。 


新 的 十 六 进 制 格 式 将 直接 兼容 更 多 使 用 二 进 制 数据 的 应 用 ， 人 允许 它们 存储 和 检索 ， 而 不 
用 额外 的 转换 。 它 比 传统 的 格式 的 读 取 和 写 入 也 要 快 得 多 。 


允许 服务 器 参数 extra_ float_digits 增加 到 3 (Tom Lane) 


以 前 extra_float_digits 的 最 大 值 设置 是 20 在 某 些 情况 下 ， 需要 3 位 数 准确 的 转 储 和 
恢复 float4 值 。 pg_dump 现 在 在 从 允许 设置 为 3 的 服务 器 转 储 时 将 使 用 3 的 设置 。 


加 强 int2vector 值 的 输入 检查 (Caleb Welton) 


E.34.3.5.1. 全 文 检索 


在 同义词 字典 中 添加 前 级 支持 (Teodor Sigaev) 
添加 过 滤 字 典 (Teodor Sigaev) 

过 滤 字 典 人 允许 符号 被 修改 后 传送 到 随后 的 字典 。 

在 邮件 地 址 符号 中 人 允许 下 划 线 (Teodor Sigaev) 

为 解析 URL 符 号 使 用 更 符合 标准 的 规则 (Tom Lane) 


E.34.3.6. 函数 


允许 画 数 调用 提供 参数 名 ， 并 且 匹 配 它们 到 函数 定义 中 命名 的 参数 (Pavel Stehule) 


例如 ， 如 果 一 个 函数 定义 为 接受 参数 a 和 b ， 它 可 以 
用 func(a := 7, b := 12) 或 func(b := 12, a := 7) 调用 。 


支持 本 地 特定 的 正则 表达 式 处 理 UTF-8 服 务 器 编码 (Tom Lane) 


本 地 特定 的 正则 表达 式 功 能 包括 大 小 写 敏 感 匹配 和 本 地 特定 的 字符 类 。 以 前 ， 这 些 特性 
只 在 数据 库 使 用 一 个 单字 节 服 务 器 编码 (如 LATIN1) 时 ， 可 以 为 非 ASCII 字 符 正 确 的 工 
作 。 它 们 将 仍然 在 多 字 节 编码 下 错误 行为 ， 除了 UTF-8。 


在 to_char() ( EEEE 规范 ) 中 添加 对 科学 计数 法 的 支持 (Pavel Stehule, Brendan Jurd) 


使 得 to_char() 遵守 FM (填充 模式 ) 按照 x 、 YY 和 yvy 规格 (Bruce Momjian, Tom 
Lane) 


它 早 已 遵从 YYYY 。 


修复 to_char() 在 Windows 上 以 正确 的 编码 输出 本 地 化 的 数值 和 货币 字符 串 (Hiroshi 
Inoue, ltagaki Takahiro, Bruce Momjian) 


为 多 边 形 正确 计算 "重重 " "as" (Teodor Sigaev) 


多 边 形 e ( 重 壹 ) 运 算 符 以 前 选中 只 是 为 了 查看 两 个 多 边 形 的 边界 框 是 否 重 侣 。 现在 它 做 
一 个 更 正确 的 检查 。 多 边 形 ot; 和 at; (包含 /包含 于 ) 运算 符 以 前 选中 是 为 了 查看 
一 个 多 边 形 顶点 是 否 都 包含 在 另 一 个 中 ; 这 对 于 一 些 非 凸 多 边 形 会 错误 的 报告 "true"。 
现在 它们 检查 一 个 多 边 形 的 所 有 线段 都 包含 在 另 一 个 中 。 
E.34.3.6.1. 聚集 
© 人 允许 聚集 函数 使 用 ordeR BY (Andrew Gierth) 


例如 ， 现 在 支持 : array agg(a ORDER BY b) 。 这 对 于 输入 值 顺序 很 重要 的 聚集 是 有 用 
的 ， 并 且 消 除了 使 用 非 标准 的 子 查询 确定 顺序 的 需要 。 


。 多 参数 聚集 加 数 现在 可 以 使 用 pistinct (Andrew Gierth) 
e 添加 string agg() 画 数 ， 组 合 值 到 一 个 字符 串 (Pavel Stehule) 


e 用 orstinct 调用 的 聚集 本 数 ， 如 果 聚 集 转换 函数 没有 被 标记 为 strict, 那么 现在 传递 
NULL 值 (Andrew Gierth) 


例如 ， agg(DISTINCT x) 可 能 传递 一 个 NULL x 值 到 agg() o 这 和 非 bisTINcT 情况 的 行 
为 更 加 一 致 。 
E.34.3.6.2. 位 字符 串 


e 为 bit 字符 串 添加 get_bit() 和 set_bit() WAX, X bytea 映射 这 两 个 函数 (Leonardo 
F) 


e 为 bit 字符 串 和 bytea 实现 ovERLAY() (#44) (Leonardo F) 
E.34.3.6.3. 31 R AHA 


e 添加 pg table size() 和 pg_indexes_size() ， 提 供 一 个 更 加 用 户 友好 的 界面 到 
pg_relation_size() EY2X (Bernd Helmle) 


为 序列 权限 检查 添加 has_sequence_privilege() (Abhijit Menon-Sen) 
e 更 新 information_schema 视图 以 符合 SQL:2008 (Peter Eisentraut) 


e 使 得 information_schema 视图 为 char 和 varchar 字段 正确 的 显示 最 大 的 八 位 字 节 长 度 
(Peter Eisentraut) 


e 加 速 information_schema 权限 视图 (Joachim Wieland) 


E.34.3.6.4. 函数 和 人 触发 器 创建 


e 支持 使 用 bo 声明 执行 匿名 代码 块 (Petr Jelinek, Joshua Tolley, Hannu Valtonen) 


允许 服务 器 端 代码 的 执行 不 需要 创建 和 删除 临时 豆 数 定义 。 代码 可 以 以 任意 用 户 有 权 
aa ee 言 执行 。 


。 实现 服从 SQL 标准 的 每 字段 触发 (Itagaki Takahiro) 


这 样 的 触发 器 只 有 在 指定 的 字段 受到 查询 的 影响 时 触发 ， 如 : 出 现在 uPDATE 的 set 列 
表 中 。 


e 添加 when 子 句 到 create TRIGGER ， 人 允许 控制 触发 器 是 否 触 发 (ltagaki Takahiro) 
虽然 相同 类 型 的 检查 总 是 可 以 在 触发 器 内 部 执行 ， 但 是 在 外 部 的 whEN 子 句 中 做 检查 会 
有 性 能 优势 


E.34.3.7. 服务 器 端 语言 
e 添加 oR REPLACE 子 句 到 create LANGUAGE (Tom Lane) 
这 对 于 可 选择 的 安装 一 个 并 非 早已 存在 的 语言 是 有 帮助 的 ， 并 且 对 于 现在 PL/pgSQL 是 默 
认 安 装 的 尤其 有 帮助 。 
E.34.3.7.1. PL/pgSQL 服 务 器 端 语言 
。 了 缺 省 安装 PL/pgSQL (Bruce Momjian) 


如 果 管 理 员 担心 启用 它 会 有 安全 或 性 能 问题 ， 该 语言 仍然 可 以 从 个 别 的 数据 库 中 删除 。 


改善 PL/pgSQL 变 量 名 与 函数 的 查询 中 使 用 的 标识 符 冲突 时 的 处 理 (Tom Lane) 


缺 省 行为 是 有 冲突 时 抛 出 一 个 错误 ， 以 便 避 免 意外 的 行为 。 这 个 可 以 修改 ， 通过 配置 参 
数 plpgsql.variable_conflict 或 者 每 个 函数 的 选项 #variable_conflict ， 允许 使 用 变量 
或 者 查询 提供 的 字段 。 在 任何 情况 下 ，PL/pgSQL 将 不 再 尝试 蔡 换 不 符合 语法 规范 的 变 


量 。 
e 使 PL/pgSQL 使 用 主要 的 词法 分 析 程 序 ， 而 不 是 它 自己 的 版 本 (Tom Lane) 


这 确保 了 精确 的 追踪 主 系 统 的 细节 行为 ， 如 字符 串 逃 逸 。 一 些 用 户 变量 细节 ， 如 考虑 保 
留 在 PL/pgSQL 中 的 关键 字 的 设置 ， 已 经 因此 而 改变 了 。 


。 避免 为 无 效 的 记录 引用 抛 出 不 必要 的 错误 (Tom Lane) 


现在 只 有 引用 实际 抓 取 到 时 才 抛 出 一 个 错误 ， 而 不 是 每 当 到 达 封闭 的 表达 式 时 。 例如 ， 
许多 人 党 试 在 触发 器 中 这 样 做 : 


if TG_OP = 'INSERT' and NEW.coli = ... then 


现在 这 实际 上 将 如 预期 一 样 工 作 。 


。 提高 PL/pgSQL 你 理 包含 了 删除 字段 的 行 类 型 的 能 力 (Pavel Stehule) 
。 人 允许 输入 参数 在 PL/pgSQL 冰 数 内 部 分 配 值 (Steve Prentice) 


以 前 ， 输 入 参数 被 当做 声明 了 const 来 看 ， 所 以 函数 的 代码 不 能 改变 它们 的 值 。 这 个 限 
制 已 被 删除 ， 以 简化 范 数 从 其 他 没有 利用 该 等 价 限制 的 DBMSes 中 移植 。 输入 参数 现在 
像 本 地 变量 初始 化 为 传人 的 值 一 样 动作 。 


e 改进 PL/pgSQL 中 的 错误 位 置 报告 (Tom Lane) 
e 在 PL/pgSQL 中 添加 _count_ 和 ALL 选项 到 move FORWARD / BACKWARD (Pavel Stehule) 
e 人 允许 PL/pgSQL 的 whERE cuRRENT oF 使 用 游标 变量 (Tom Lane) 


e 允许 PL/pgSQL 的 open _cursor_ FOR EXECUTE 使 用 参数 (Pavel Stehule, Itagaki 
Takahiro) 


一 个 新 的 usine 子 句 完成 了 


E.34.3.7.2. PL/Perl 服 务 器 端 语言 


o 添加 新 的 PL/Perl 函 数 : quote literal() , quote_nullable() , quote_ident() , 
encode_bytea() , decode_bytea() , looks_like_number() , encode_array_literal() , 


encode_array_constructor() (Tim Bunce) 
。 添加 服务 器 参数 pblperl.on_init ， 指定 一 个 PL/Perl 初 始 化 函数 (Tim Bunce) 


plperl.on_plperl_init 和 plperl.on_plperlu_init 都 可 以 用 于 初始 化 ， 分 别针 对 信任 的 
和 不 信任 的 语言 。 


。 在 PL/Perl 中 支持 env 块 (Tim Bunce) 

END 块 目 前 不 允许 数据 库 访问 。 
e 在 PL/Perl 中 人 允许 use strict (Tim Bunce) 

Perl strict 检查 也 可 以 用 新 的 服务 器 参数 plperl.use strict 来 全 局 启用 。 
e 在 PL/Perl 中 人 允许 require (Tim Bunce) 


这 主要 是 测试 看 看 该 模块 是 否 加 载 上 上 了， 如果 没有 ， 产 生 一 个 错误 。 不 人 允许 加 载 管理 员 
没有 通过 初始 化 参数 预 加 载 的 模块 。 


e 如 果 使 用 了 Perl 版 本 5.10 或 更 新 ， 则 在 PL/Perl 中 人 允许 use feature (Tim Bunce) 


。 验证 了 PL/Perl 返 回 值 在 服务 器 编码 中 可 用 (Andrew Dunstan) 


E.34.3.7.3. PL/Python 服务 器 端 语言 


e 在 PL/Python 中 添加 Unicode 支 持 (Peter Eisentraut) 


如 果 需 要 ， 字 符 串 自动 转换 从 /到 服务 器 编码 。 
。 在 PL/Python 中 改善 bytea 支持 (Caleb Welton) 


传递 到 PL/Python 中 的 Bytea 值 现在 表示 为 二 进 制 ， 而 不 是 PostgreSQL bytea 文本 格 
式 。 包 含 空 字 节 的 Bytea 值 现在 也 从 PL/Python 中 适当 的 输出 。 也 改善 了 布尔 值 、 整 数 
值 和 浮 点 值 的 传送 。 


e 在 PL/Python 中 支持 arrays 作 为 参数 并 且 返 回 值 (Peter Eisentraut) 
。 改善 SQL 域 的 映射 为 Python 类 型 (Peter Eisentraut) 
e 添加 Python 3 支持 到 PL/Python (Peter Eisentraut) 
新 的 服务 器 端 语 言 称 作 plpython3u 。 不 能 用 于 Python 2 服务 器 端 语言 的 相同 会 话 中 。 


。 改善 PL/Python 中 的 错误 位 置 和 异常 报告 (Peter Eisentraut) 


E.34.3.8. 客户 应 用 程序 
e 添加 --analyze-only 选项 到 vacuumdh ， 不 带 有 清理 的 分 析 (Bruce Momjian) 


E.34.3.8.1. psq! 
。 添加 支持 引用 /逃逸 psq| = 的 值 作 为 SQL 字符 串 或 标识 符 (Pavel Stehule, Robert 


Haas) 
例如 ， :'var' 将 产生 值 var ， 引 用 并 适当 的 逃逸 为 字符 串 常 量 ， 而 :"var" 将 产生 它 的 
值 ， 引 用 并 且 逃 逸 为 一 个 标识 符 。 


在 通过 psql 读 取 的 脚本 文件 中 ， 忽略 前 导 的 UTF-8 编 码 的 Unicode 字 节 顺 序 标记 (Itagaki 
Takahiro) 


这 在 客户 端 编码 是 UTF-8 的 时 候 和 启用。 它 改 善 了 与 某 些 编辑 器 的 兼容 性 ， 主要 是 在 
Windows 上 ， 坚 持 插 入 这 样 的 标记 的 那些 。 


修复 psql --file - 以 适当 的 遵从 --single-transaction (Bruce Momjian) 


当 两 个 psdqI 会 话 并 行 运行 时 ， 避 免 psdl 的 命令 行 历 史 重 写 (Tom Lane) 


改善 psql 的 选项 卡 实现 支持 (Itagaki Takahiro) 


。 XH \timing 时 显示 它 的 输出 ， 不 管 "quiet" 模 式 (Peter Eisentraut) 


E.34.3.8.1.1. psql 显示 
改善 psql 中 封装 字段 的 显示 (Roger Leigh) 


这 个 行为 现在 是 缺 省 的 。 以 前 的 格式 通过 使 用 \pset linestyle old-ascii 可 用 。 


e 多 许 psql 通 过 \pset linestyle unicode 使 用 喜好 的 Unicode 线 条 特性 (Roger Leigh) 
E.34.3.8.1.2. psql \d #4 
。 使 \d 显示 从 指定 父 表 继承 而 来 的 子 表 (Damien Clochard) 
\d 只 显示 子 表 的 数量 ， 而 \d+ 显示 所 有 子 表 的 名 字 。 
。 在 \d index_name 中 显示 索引 字段 的 定义 (Khee Chin) 
定义 对 于 表达 式 索 引 是 有 用 的 。 
e 只 在 \d+ 中 显示 视图 的 定义 查询 ， 在 \d 中 不 显示 (Peter Eisentraut) 
总 是 包括 认为 过 度 了 见长 的 查询 。 
E.34.3.8.2. pg_dump 
e 使 pg_dump/pg_restore --clean 总 是 删除 大 对 象 (ltagaki Takahiro) 


。 修复 pg_dump， 使 其 在 启用 standard_conforming_strings 时 适当 的 转 储 大 对 象 (Tom 
Lane) 


当 转 储 到 一 个 为 档 文件 ， 并 且 然 后 从 pg_restore 生 成 脚本 输出 时 ， 以 前 的 编码 可 能 会 
Mo 


e pg_restore 现 在 在 生成 脚本 输出 时 以 十 六 进 制 格式 发 出 大 对 象 数据 (Tom Lane) 


如 果 该 脚本 然后 输入 到 一 个 9.0 以 前 的 服务 器 ， 那 么 这 可 能 会 导致 兼容 性 问题 。 要 绕 开 这 
个 问题 ， 直 接 恢复 到 该 服务 器 。 


e 人 允许 pg_dump 转 储 附加 到 复合 类 型 字段 的 注释 (Taro Minowa (Higepon)) 


e 使 pg_dump --verbose 在 文本 输出 模式 输出 pg_dump 和 服务 器 版 本 (Jim Cox, Tom 
Lane) 


这 些 在 自 定义 输出 模式 中 早已 提供 。 
e pg_restore 现 在 抱怨 是 否 在 开关 和 选项 文件 名 后 面 残存 任何 命令 行 参数 (Tom Lane) 
以 前 ， 它 默默 地 无 视 任何 这 样 的 参数 。 
E.34.3.8.3. pg_ctl 
。 在 系统 重新 启动 该 期 间 人 允许 使 用 pg _ctl 安全 的 启动 postmaster (Tom Lane) 


以 前 ，pg_ctl 的 父 进程 错误 的 认为 是 基于 旧 的 postmaster 锁 文件 运行 postmaster， 导 致 瞬 
间 的 不 能 启动 数据 库 。 


e 给 予 pg_ctl 初 始 化 数据 库 的 能 力 (通过 调用 initdb) (Zdenek Kotala) 


E.34.3.9. 开发 工具 


E.34.3.9.1. libpq 


YRDOATAibpqes2X paconnectdbParams() 和 PQconnectStartParams() (Guillaume Lelarge) 


Wee BEN 4 LIF paconnectdb() 和 PQconnectStart(), 除了 它们 接受 连接 选项 的 数组 以 
null 结 尾 ， 而 不 是 请 求 在 一 个 字符 串 中 提供 所 有 选项 


YRMOlibpqey2X PaescapeLiteral() 和 PQescapeIdentifier() (Robert Haas) 


这 些 函 数 返 回 适 当 引 用 和 逃逸 的 SQL 字符 串 字 面值 和 标识 符 。 调用 者 不 需要 预先 分 配 字 
符 串 结果 ， 如 poescapeStringconn() 要 求 。 


添加 每 用 户 服 务 文 件 的 支持 ( .pg_service.conf )， 在 站 点 范围 的 服务 文件 之 前 检查 


(Peter Eisentraut) 

如 果 不 能 找到 指定 的 libpq 服 务 ， 那 么 适当 的 报告 一 个 错误 (Peter Eisentraut) 

在 libpq 中 添加 TCP keepalive 设置 (Tollef Fog Heen, Fujii Masao, Robert Haas) 
Keepalive 设 置 早 已 在 TCP 连 接 的 服务 器 端 支 持 。 

在 提供 可 替代 方式 的 平台 上 ， 避 人 免 额外 的 系统 调用 在 libpq PRERA SIGPIPE 


(Jeremy Kerr) 

当 .pgpass 提供 的 口令 未 通过 时 ， 在 错误 消息 中 提 到 口令 的 来 源 (Bruce Momjian) 
加 载 所 有 客户 端 认 证 文件 中 给 出 的 SSL 认 证 (Tom Lane) 

改善 了 对 间接 签署 的 SSL 认 证 的 支持 。 


E.34.3.9.2. ecpg 


添加 SQLDA (SQL Descriptor Area) 支持 到 ecpg (Boszormenyi Zoltan) 
添加 DESCRIBE output ] 声明 到 ecpg (Boszormenyi Zoltan) 

添加 一 个 ECPGtransactionStatus 函数 以 返回 当前 事务 状态 (Bernd Helmle) 
在 ecpg Informix 兼 容 模式 中 添加 string 数据 类 型 (Boszormenyi Zoltan) 

人 允许 ecpg 没 有 限制 的 使 用 new 和 old 变量 名 (Michael Meskes) 

人 允许 ecpg 在 free() 中 使 用 变量 名 (Michael Meskes) 

使 ecpg_dynamic_type() 为 非 SQL3 数 据 类 型 返回 需 (Michael Meskes) 

以 前 ， 它 返回 该 数据 类 型 OID 的 负 值 。 然 而 ， 这 可 能 会 与 有 效 类 型 的 OID 混 淆 。 


在 早已 有 64 位 long 类 型 的 平台 上 支持 long long 类 型 (Michael Meskes) 


E.34.3.9.2.1. ecpg 游标 
。 在 ecpg 的 原始 模式 中 添加 超出 范围 游标 支持 (Boszormenyi Zoltan) 


当 调 用 了 open 时 ， 这 人 允许 DECLARE 使 用 范围 之 外 的 变量 。 这 个 工具 早已 存在 于 ecpg 的 
Informix 兼 容 模式 中 。 


。 在 ecpg 中 人 允许 动态 游标 名 (Boszormenyi Zoltan) 


e 人 允许 ecpg 在 FETcH 和 move 中 使 用 噪声 字 From 和 IN (Boszormenyi Zoltan) 


E.34.3.10. 构建 选项 
。 默认 局 用 客户 端 线程 安全 性 (Bruce Momjian) 
线程 安全 性 选项 可 以 用 configure --disable-thread-safety 禁用 。 
。 添加 控制 Linux 内 存 不 足 杀 手 的 支持 (Alex Hunsaker, Tom Lane) 


现在 /proc/self/oom_adj 人 允许 禁用 Linux 内 存 不 足 (OOM) 杀手 ， 推 荐 为 postmaster 禁 
用 OOM 杀 手 。 然后 为 postmaster 的 子 进程 重新 启用 OOM 杀 手 就 能 满足 需要 了 。 新 的 编 
译 阶 段 选 项 LINUx oom a 人 允许 为 子 进 程 重新 启用 杀手 。 


E.34.3.10.1. Makefiles 
e 新 增 makefile 指标 world, install-world 和 installcheck-world (Andrew Dunstan) 


这 类 似 于 现 有 的 all, install 和 installcheck 指标 ， 但 是 它们 也 构建 HTML 文 档 ， 构 
建 并 测试 contrib ， 和 测试 服务 器 端 语言 和 ecpg。 


。 添加 数据 和 文档 安装 位 置 控制 到 PGXS Makefiles (Mark Cave-Ayland) 


e 添加 Makefile 规 则 ， 作 为 一 个 HTML 文 件 或 者 作为 一 个 纯 文本 文件 构建 PostgreSQL 文 档 
(Peter Eisentraut, Bruce Momjian) 


E.34.3.10.2. Windows 


。 支持 在 64 位 Windows 上 编译 和 在 64 位 模式 中 运行 (Tsutomu Yamada, Magnus 
Hagander) 


这 人 允许 Windows 上 大 的 共享 内 存 大 小 。 


。 支持 服务 器 构建 使 用 Visual Studio 2008 (Magnus Hagander) 


E.34.3.11. 源 代码 


。 在 子 目录 树 中 发 布 预 建 的 文档 ， 而 不 是 作为 发 布 的 原始 码 中 的 tar 汶 档 文件 (Peter 
Eisentraut) 


例如 ， 预 建 的 HTML 文 档 现在 在 doc/src/sgmi/ntml/ 中 ; 手册 页 同样 的 方式 打包 。 

使 服务 器 的 词法 分 析 器 可 重 入 (Tom Lane) 

PL/pgSQL 使 用 词法 分 析 器 需要 这 点 。 

提升 内 存 分 配 的 速度 (Tom Lane, Greg Stark) 

用 户 定义 的 约束 触发 器 现在 在 pg_constraint 和 pg_trigger 中 都 有 记录 了 (Tom Lane) 
因为 这 个 改变 ， pg_constraint . pgconstrname 现在 是 多 余 的 ， 并 且 已 经 删除 了 。 


添加 系统 目录 字段 pg_constraint . conindid 和 pg_trigger . tgconstrindid , 以 便 更 好 
的 为 约束 执行 记录 索引 的 使 用 (Tom Lane) 

允许 使 用 单个 操作 系统 信号 传递 多 个 条 件 到 后 端 (Fujii Masao) 

这 人 允许 添加 新 的 特性 ， 不 用 管 平台 特定 的 信号 条 件 的 个 数 的 约束 。 


提高 源 代码 的 测试 覆盖 率 ， 包 括 contrib 、PL/Python 和 PL/Perl (Peter Eisentraut, 
Andrew Dunstan) 


删除 系统 表 引 导 对 平面 文件 的 使 用 (Tom Lane, Alvaro Herrera) 

这 提高 了 使 用 许多 规则 和 数据 库 时 的 性 能 ， 并 且 消 除了 一 些 可 能 的 故障 条 件 。 

为 "引导 "目录 自动 生成 pg_attribute 的 初始 内 容 (John Naylon) 

这 大 大 的 简化 了 到 这 些 目录 的 更 改 。 

分 裂 INSERT / UPDATE / DELETE 操作 execMain.c 的 进程 (Marko Tiikkaja) 

现在 在 单独 的 ModifyTable 节 点 中 执行 更 新 。 这 个 更 改 对 于 未 来 的 发 展 是 必要 的 基础 。 
简化 psql 的 SQL 帮助 文本 的 翻译 (Peter Eisentraut) 


减少 某 些 文件 名 的 长 度 ， 以 便 在 发 布 的 原始 码 中 的 所 有 文件 路 笃 都 小 于 100 个 字符 (Tom 


Lane) 

一 些 解压 程序 在 长 的 文件 路 径 上 有 问题 。 

添加 新 的 ERRCODE_INVALID_PASSWORD SQLSTATE 错误 代码 (Bruce Momjian) 

经 过 作者 的 许可 ， 删 除 少量 剩余 的 个 人 源码 版 权 声 明 (Bruce Momjian) 

个 人 版 权 声 明 是 无 关 紧 要 的 ， 但 是 社区 偶尔 不 得 不 回答 关于 他 们 的 问题 。 

添加 新 的 关于 在 非 持 久 模 式 中 运行 PostgreSQL 以 提升 性 能 的 文档 章节 (Bruce Momjian) 


重新 构造 HTML 文 档 makefile 规则 ， 以 使 它们 的 依赖 性 检查 正确 的 工作 ， 避 免 不 必 要 的 
重建 (Peter Eisentraut) 


。 为 手册 页 的 建立 使 用 DocBook XSL 样 式 表 ， 而 不 是 Docbook2X (Peter Eisentraut) 
这 改变 了 建立 手册 页 需要 的 工具 集 。 
。 改善 PL/Perl 代 码 结 构 (Tim Bunce) 


。 改进 PL/Perl 中 的 错误 环境 报告 (Alexey Klyukin) 


E.34.3.11.1. 新 构建 的 需求 


请 注意 ， 从 发 布 的 原始 码 建 立时 没有 应 用 这 些 需 求 ， 因为 原始 码 包 括 用 于 建立 的 这 些 程序 的 
文件 。 


。 需要 Autoconf 2.63 建 立 configure (Peter Eisentraut) 
。 需要 Flex 2.5.31 或 更 新 版 本 从 CVS 检 查 建 立 (Tom Lane) 


。 需要 Perl 版 本 5.8 或 更 新 版 本 从 CVS 检 查 建立 (John Naylor, Andrew Dunstan) 


E.34.3.11.2. 移植 性 
。 为 Bonjour 使 用 更 现代 的 API (Tom Lane) 
Bonjour 支 持 现在 需要 OS X 10.3 或 更 新 版 本 。 老 的 API 已 经 被 Apple 弃 用 了 。 
。 为 SuperH 体 系 结构 添加 自 旋 锁 支持 (Nobuhiro lwamatsu) 
。 如 果 支 持 ， 则 人 允许 非 GCC 编 译 器 使 用 内 联 函 数 (Kurt Harriman) 
。 删除 对 没有 运行 64 位 整数 数据 类 型 的 平台 的 支持 (Tom Lane) 
。 调整 LpFLAGs 的 使 用 ， 使 其 在 平台 间 更 加 的 一 致 (Tom Lane) 


LDFLAGS 现在 用 于 连接 可 执行 文件 和 共享 库 ， 我 们 在 连接 可 执行 文件 时 添加 
LDFLAGS_EX ， 在 连接 共享 库 时 添加 LDFLAGS_SL o 


E.34.3.11.3. 服务 器 编程 
。 使 后 端 头 文件 安全 的 包含 在 C++ 中 (Kurt Harriman, Peter Eisentraut) 


这 些 改 变 删除 关键 字 冲 突 ， 这 些 冲 突 在 以 前 使 得 C++ 在 后 端 代码 中 使 用 困难 。 不 过 ， 在 
为 后 端 功 能 使 用 C++ 时 ， 仍 然 有 其 他 复杂 性 。 在 适当 的 地 方 仍 然 需要 extern "c" { } ， 
内 存 管理 和 错误 处 理 仍然 是 有 问题 的 。 


e 添加 Aggcheckcallcontext() ， 用 于 检测 是 否 一 个 C 男 数 被 作为 一 个 聚集 调用 (Hitoshi 
Harada) 


e 为 searchsyscache() 和 相关 的 函数 修改 调用 规范 ， 以 避免 硬 线 连接 缓存 键 的 最 大 数量 
(Robert Haas) 


现 有 的 调用 目前 仍然 可 以 工作 ， 但 是 如 果 没 有 转变 到 新 的 风格 ， 预 计 会 在 9.1 或 更 新 的 版 
本 中 打 断 。 


e 需要 调用 fastgetattr() 和 heap_getattr() 后 端 宏 命令 ， 以 提供 非 NULL 第 四 参数 
(Robert Haas) 


。 自 定义 typanalyze 辑 数 应 该 不 再 依赖 于 vacattrstats . attr 确定 他 们 将 要 传送 的 数据 的 
类 型 (Tom Lane) 


变 为 允许 收集 索引 字段 上 的 统计 信息 ， 该 索引 字段 的 存储 类 型 不 同 于 底层 字段 的 数据 类 
型 。 有 新 的 字段 告诉 我 们 被 分 析 的 实际 的 数据 类 型 。 


E.34.3.11.4. 服务 器 Hook 


。 添加 解析 器 hook 人 处 理 ColumnRef 和 ParamRef 节 点 (Tom Lane) 


。 添加 处 理 实用 程序 hook， 这 样 可 加 载 的 模块 可 以 控制 实用 程序 命 合 (Itagaki Takahiro) 


E.34.3.11.5. 二 进 制 升级 支持 
e 添加 contrib/pg_upgrade 支持 在 线 升 级 (Bruce Momjian) 


这 避免 了 升级 到 一 个 新 的 PostgreSQL 主 版 本 时 转 储 / 重 载 数据 库 的 需要 ， 因此 ， 通 过 数 
量 级 减少 了 停机 时 间 。 支 持 从 PostgreSQL 8.3 或 8.4 升 级 到 9.0。 


。 添加 支持 在 二 进 制 升 级 期 间 保存 关系 relfilenode 值 (Bruce Momjian) 

。 添加 支持 在 二 进 制 升级 期 间 保 存 pg_type 和 pg_enum OIDs (Bruce Momjian) 

。 移动 表 空 间 中 的 数据 文件 到 PostgreSQL 版 本 特定 的 子 目 录 中 (Bruce Momjian) 
这 简化 了 二 进 制 升级 。 


E.34.3.12. 普通 发 布 版 
。 添加 多 线程 选项 ( -j ) 到 contrib/pgbench (Itagaki Takahiro) 
这 人 允许 pgbench 使 用 多 个 CPU， 降 低 pgbench 本 省 成 为 测试 障碍 的 风险 。 
e 添加 \shell 和 \setshell 元 命令 到 contrib/pgbench (Michael Paquier) 
e 为 contrip/dict_xsyn 新 增 特 性 (Sergey Karpov) 
新 选项 是 matchorig ， matchsynonyms 和 keepsynonyms 。 
。 添加 全 文本 字典 contrib/unaccent (Teodor Sigaev) 


这 个 过 滤 的 字典 删除 了 字母 的 重 (zhong) iz, 使 得 多 种 语言 上 的 全 文本 搜索 更 加 简 
单 。 


添加 dblink_get_notify() 到 contrib/dblink (Marcus Kempe) 
允许 dblink 中 的 异步 通知 。 
改善 contrib/dblink 义理 删除 了 的 字段 (Tom Lane) 


这 影响 了 dblink_build_sql_insert() 和 相关 的 函 RESE xe E] TEAR HE TT Se 
字段 编号 来 编号 字段 。 


大 大 的 增加 了 contrib/hstore 的 数据 长 度 限 制 ， 并 且 增 加 了 B-tree 和 哈 希 支持 ， 所 以 
在 hstore 字段 上 croup BY 和 pistinct 操作 成 为 可 能 (Andrew Gierth) 


也 添加 了 新 的 函数 和 操作 符 。 这 些 改进 使 得 hstore 一 个 功能 完整 键 值 存储 族人 到 
PostgreSQL 中 。 


添加 contrib/passwordcheck ， 支持 场地 特定 密码 强度 政策 (Laurenz Albe) 

这 个 模块 的 源 代码 应 该 被 修改 为 实现 场地 特定 密码 政策 。 

添加 contrip/pg_archivecleanup 工具 (Simon Riggs) 

目的 是 用 于 archive_cleanup_command 服务 器 参数 ， 以 删除 不 再 需要 的 为 档 文 件 。 
添加 查询 文本 到 contrib/auto_explain 输出 (Andrew Dunstan) 

添加 缓冲 区 访问 计数 到 contrib/pg_stat_statements (Itagaki Takahiro) 


更 新 contrib/start-scripts/linux ， 以 使 用 /proc/self/oom_adj 禁用 Linux 内 存 洽 出 
(OOM) 杀 手 (Alex Hunsaker, Tom Lane) 


E.35. 发 布 8.4.18 


发 布 日 期 : 2013-10-10 


该 发 布 包含 8.4.17 的 各 种 修复 。 关 于 8.4 主 要 版 本 的 新 功能 信息 ， 参阅 Section E.53。 


E.35.1. 迁移 到 8.4.18 


运行 8.4.X 不 需要 备份 /恢复 。 


同时 ， 如 果 你 从 8.4.10 的 更 早 版 本 中 升级 ， 参阅 8.4.10 的 发 布 说 明 。 


E.35.2. %14k 


。 防止 多 字 节 编码 中 非 ASCII 非 双 引 号 标识 符 转 换 (Andrew Dunstan) 
以 前 的 操作 是 错误 的 并 且 混 乱 的 。 
。 修复 通过 lo_open() 故障 导致 的 内 存 泄露 (Heikki Linnakangas) 
e 当 work_mem 正 使 用 超过 24GB 内 存 时 ， 修复 内 存 过 量 使 用 错误 (Stephen Frost) 
。 修复 libpq SSL 死 锁 错 误 (Stephen Frost) 
。 正确 计算 包含 许多 NULL 值 的 布尔 列 的 行 估计 (Andrew Gierth) 


当 估 计 计 划 成 本 时 ， 以 前 的 测试 像 col Is NOT TRUE 和 col IS NOT FALSE 没有 正确 把 
NULL 值 因素 计算 在 内 。 


e 防止 下 压 wHERE 子 句 到 不 安全 UNION/INTERSECT 子 查询 (Tom Lane) 
以 前 这 种 操作 可 能 产生 错误 。 
。 修复 通过 不 当 义理 数据 类 型 修饰 符 导 致 的 特殊 的 Group BY 查询 错误 (Tom Lane) 
© 人 允许 转 储 编码 更 好 地 处理 基 本 表 上 已 删除 的 列 (Tom Lane) 
。 修复 并 发 CREATE INDEX CONCURRENTLY 操作 间 的 可 能 的 死 锁 (Tom Lane) 
。 修复 雾 长 度 匹 配 的 regexp_matches() #£(Jeevan Chalke) 
以 前 ， 需 长 度 匹配 像 人 可 以 返回 许多 匹配 。 
。 (ER it FS AVE Wy) Reid TAB FH (Heikki Linnakangas) 


。 修复 为 反 向 引用 和 与 非 贪 禁 量 词 相 结合 的 正则 表达 式 匹 配 错 误 (Jeevan Chalke) 


防止 CREATE FUNCTION 检查 SET 变量 除非 启用 函数 体检 查 (Tom Lane) 

修复 pgp_pub_decrypt() 因此 为 带 有 密码 的 秘 钥 工 作 (Marko Kreen) 

删除 无 索引 表 的 清理 中 罕见 的 不 正确 警告 (Heikki Linnakangas) 

当 在 预备 查询 中 执行 事务 控制 命令 时 (比如 RoLLBACK ), 避免 可 能 错误 (Tom Lane) 
允许 所 有 平台 上 无 穷 大 的 各 种 拼写 (Tom Lane) 

支持 的 无 穷 大 值 是 "inf', "+inf", "-inf", "infinity", "+infinity" 和 "-infinity" 

扩展 比较 行 记 录 和 数组 能 力 (Rafal Rzepecki,Tom Lane) 


为 Israel，Morocco，Palestine，Paraguay 中 DST 交 化 规律 的 DST 交 化 更 新 时 区 数据 文 
件 到 tzdata 发 布 2013d。 同时 为 Macquarie lsland 历 史 时 区 数据 修正 (Tom Lane) 


E.36. 发 布 8.4.17 


发 布 日 期 : 2013-04-04 


该 发 布 包含 8.4.16 的 各 种 修复 。 关 于 8.4 主 要 发 布 的 新 功能 的 信息 ， 参阅 Section E.53。 


E.36.1. 迁移 到 版 本 8.4.17 


运行 8.4.X 不 需要 备份 /恢复 。 


然而 ， 该 发 布 修正 了 GiST 索 引 管 理 中 的 几 个 错误 。 安装 这 个 更 新 之 后 ， 对 于 REINDEX 满足 下 
面 描述 的 一 个 或 者 多 个 条 件 的 任何 GiST 索 引 是 明智 的 。 


同时 ， 如 果 你 从 8.4.10 更 时 版 本 更 新 ， 参 闵 8.4.10 的 发 布 说 明 。 


E.36.2. %14k 


。 在 每 个 postmaster 子 进程 中 重 置 OpenSSL 随 机 状态 (Marko Kreen) 


这 避免 了 这 样 一 种 情况 ， 其 中 通过 contrib/pgcrypto 产生 的 随机 值 可 能 对 于 另 一 个 数据 
库 用 户 相 对 容易 。 当 postmaster 可 以 配置 ssl = on 时 ， 该 风险 是 唯一 显著 的 ， 但 是 大 
多 数 连 接 不 使 用 SSL 加 密 。(CVE-2013-1900) 


。 当 它 不 适合 这 样 做 的 时 候 ， 修 复 GiST 索 引 不 使 用 "模糊 "几何 比较 (Alexander Korotkov) 


核心 几何 类 型 执行 使 用 "模糊 "平等 比较 ， 但 是 gist_box_same 必须 执行 精确 比较 ， 否 则 使 
用 它 的 GiST 索 引 可 能 变 得 不 一 致 。 安装 该 更 新 之 后 ， 用 户 应 该 
在 box , polygon ， circle 或 者 point 列 上 REINDEX 任何 GiST 索 引 。 因为 所 有 这 些 使 


用 gist_box_same o 


。 修复 不 正确 的 范围 并 集 以 及 为 了 可 变 宽 度数 据 类 型 使 用 contrib/btree_gist 的 GiST 索 引 
中 惩罚 逻辑 ， 也 就 是 text, bytea, bit 和 numeric 列 (Tom Lane) 


这 些 错 误 可 能 导致 不 一 致 素 引 ， 其 中 一 些 出 现 的 关键 字 不 会 被 搜索 发 现 ， 并 且 在 无 用 的 
索引 膨胀 中 ， 在 安装 此 更 新 后 建议 用 户 REINDEX 这 种 索引 。 


。 修复 为 多 列 素 引 在 GiST 页 中 分 离 代码 的 错误 (Tom Lane) 


这 些 错 误 可 能 导致 不 一 致 索引 ， 其 中 一 些 出 现 的 关键 字 不 会 被 搜索 发 现 ， 并 且 在 索引 中 
是 不 必要 的 无 效 的 搜索 。 在 安装 此 更 新 后 建议 用 户 REINDEX 多 列 GiST 索 引 。 


。 修复 正则 表达 式 编 译 中 无 限 循环 风险 (Tom Lane,Don Porter) 


修复 正则 表达 式 编 译 中 潜在 的 空 指针 取消 引用 (Tom Lane) 
修复 to_char() 在 合适 的 地 方 使 用 ASCII 大 小 写 折 县 规则 (Tom Lane) 


这 修复 了 应 该 区 域 独立 的 一 些 模板 模式 的 不 当 操作 ， 但 是 在 Turkish 地 区 胡乱 操 
He" "FI". 


修复 时 间 惟 1999-12-31 24:00:00 的 不 必要 拒绝 (Tom Lane) 
删除 无 效 的 "picksplit 不 支持 二 次 分 裂 " 日 志 消 息 (Josh Hansen, Tom Lane) 


该 消息 似乎 被 添加 到 从 未 写 入 的 期 望 代码 中 ， 并 且 可 能 从 来 不 是 ， 因 为 二 次 分 裂 的 GiST 
的 缺 省 义理 实际 上 相当 好 。 所 以 停止 打扰 关于 它 的 最 终 用 户 。 


修复 发 送 会 话 的 最 后 几 个 事务 提交 /终止 计数 到 统计 收集 器 的 可 能 错误 (Tom Lane) 
消除 PL/Perl 的 spi_prepare() WAR AW 4 itt (Alex Hunsaker, Tom Lane) 

修复 pg_dumpall 以 正确 处 理 包 含 " = "的 数据 库 名 字 (Heikki Linnakangas) 

当 给 定 一 个 不 正确 连接 字符 串 时 ， 避 免 pg_dump 骨 溃 (Heikki Linnakangas) 

忽略 pg_dump 中 无 效 素 引 (Michael Paquier) 


各 份 无 效 索 引 可 能 导致 恢复 时 间 的 问题 ， 比如 如 果 索 引 创建 失败 的 原因 是 它 试 图 强制 不 
满足 表 的 数据 的 唯一 性 条 件 。 同 时 ， 如 果 索 引 创建 实际 上 仍然 在 进行 中 ， 认为 它 是 一 个 
不 受 约束 的 DDL 变 化 似乎 是 合理 的 ， 其 中 pg_dump PHE. 


修复 contrib/pg_trgm 的 similarity) BMAYF=ATN SH Bike| S(Tom Lane) 
以 前 它 返 回 NaN 由 于 内 部 除 以 需 。 


为 了 Chile, Haiti, Morocco, Paraguay 和 一 些 Russian 区 域 中 DST 变 化 规律 更 新 时 间 区 域 数 
据 文件 到 tzdata 发 布 2013b。 同时 为 更 多 地 方 修正 历史 区 域 数据 。 


另外 ， 在 Russia 和 其 他 地 方 更 新 最 近 变 化 的 时 区 缩写 文件 : cHoT ，GET ，IRKT ，KGT ， 
KRAT ，MAGT ，MAWT ，MSK ，NOVT ，OMST ，TKT ，VLAT ，WST ，YAKT ，YEKT 现在 遵从 它 
们 当前 意义 ， 并 且 vort (Europe/Volgograd) 和 mist (Antarctica/Macquarie) 被 添加 到 
缺 省 缩写 列表 中 。 


E.37. 发 布 8.4.16 


Release Date: 2013-02-07 


该 发 布 包含 8.4.15 的 各 种 修复 。 关 于 8.4 主 要 发 布 的 新 功能 的 信息 ， 参阅 Section E.53。 


E.37.1. 迁移 到 版 本 8.4.16 


运行 8.4.X 不 需要 备份 /恢复 。 


然而 ， 如 果 你 从 8.4.10 更 早 版 本 更 新 ， 人 参阅 8.4.10 的 发 布 说 明 。 


E.37.2. 变化 


防止 来 自 SQL enum_recv 的 执行 (Tom Lane) 


该 图 数 被 错误 声明 ， 人 允许 简单 SQL 命 合 导 致 服务 器 月 江 。 原则 上 攻击 者 可 以 使 用 它 检查 
服务 器 内 存 的 内 容 。 我 们 该 感谢 Sumit Soni (通过 Secunia SVCRP) 报 告 这 个 问题 。 
(CVE-2013-0255) 


当 截 断 关系 文件 时 ， 更 新 最 小 恢复 点 (Heikki Linnakangas) 

一 旦 数据 被 丢弃 ， 在 时 间 轴 早 一 点 的 位 置 停止 恢复 不 再 安全 。 

修复 SQL 语法 以 允许 来 自 子 SELECT 结果 的 下 标 或 者 字段 选择 (Tom Lane) 
当 扫 描 pg_tablespace 时 ， 防 止 竞争 条 件 (Stephen Frost, Tom Lane) 


如 果 有 pg tablespace 项 的 并 发 更 新 ， 那么 CREATE DATABASE 和 DROP DATABASE 可 能 行为 
不 当 。 


防止 prop owNED 试图 删除 整个 数据 库 或 者 表 空 间 (Alvaro Herrera) 
为 了 安全 起 见 ， 这 些 对 象 所 有 权 必 须 被 重新 分 配 ， 而 不 是 删除 。 
修复 vacuum_freeze_table age 实现 中 的 错误 (Andres Freund) 


在 安装 中 不 只 存在 vacuum freeze minage BS, 这 个 错误 防止 自动 清理 使 用 部 分 表 打 
描 ， 因此 相反 可 能 会 发 生 全 表 打 描 。 


当 两 次 解析 分 析 RowExpr 或 者 xmlExpr 的 时 候 ， 防止 不 当 操 作 (Andres Freund, Tom 
Lane) 


这 个 错误 在 上 下 文中 是 用 户 可 见 的 ， 比如 CREATE TABLE LIKE INCLUDING INDEXES o 


提高 在 哈 希 表 大 小 计算 中 防御 整数 浴 出 (Jeff Davis) 

拒绝 to_date() 中 超期 范围 日 期 (Hitoshi Harada) 

确保 非 ASCII 提 示 符 字符 串 被 翻译 成 Windows 上 正确 代码 页 (Alexander Law, Noah Misch) 
这 个 错误 影响 psql 和 一 些 其 它 客户 端 程序 。 

当 没 有 连接 到 数据 库 时 ， 修复 psql 的 \? 命令 中 可 能 崩溃 (Meng Qingzhong) 

修复 libpq 的 poprinttuples 中 一 字 节 缓冲 区 浴 出 (Xi Wang) 


这 个 旧 的 函数 通过 PostgreSQL 自 身 并 不 在 任何 地 方 使 用 ， 但 是 它 可 能 被 一 些 客户 端 代码 
使 用 。 


使 得 ecpglib 正 确 使 用 已 翻译 消息 (Chen Huajun) 
在 MSVC 上 正确 安装 ecpg_compat 和 pgtypes 库 (Jiang Guiqing) 


为 已 提供 函数 重新 安排 配置 测试 ， 因此 它 不 会 被 假 输出 libedit/libreadline 而 欺骗 
(Christoph Berg) 


确保 随 着 时 间 推 移 Windows 编 译 数 增加 (Magnus Hagander) 


当 交 叉 编译 Windows 时 ， 使 得 pgxs 生 成 正确 .exe 后 级 的 可 执行 文件 (Zoltan 
Boszormenyi) 


添加 新 的 时 区 缩写 FET (Tom Lane) 


用 于 一 些 东 欧 时 区 。 


E.38. 发 布 8.4.15 


发 布 日 期 : 2012-12-06 


该 发 布 包 含 了 8.4.14 中 的 各 种 修复 。 关于 8.4 主 要 发 布 的 新 功能 信息 ， 参 阅 Section E.53。 


E.38.1. 迁移 到 版 本 8.4.15 


运行 8.4.X 不 需要 各 份 /恢复 。 
然而 ， 如 果 你 从 8.4.10 更 早 版 本 开始 更 新 ， 参 闵 8.4.10 的 发 布 说 明 。 


E.38.2. 变化 


e 修复 与 CREATE INDEX CONCURRENTLY 有 关 的 多 个 错误 (Andres Freund, Tom Lane) 


当 改 变 索 引 的 pg_index 行 的 状态 时 ， 修 复 CREATE INDEX CONCURRENTLY 以 使 用 就 地 更 新 。 
这 避免 了 竞争 条 件 ， 它 可 以 导致 并 发 会 话 错 过 更 新 目标 索引 ， 因此 导致 月 江 同时 已 创建 
索引 。 


同时 ， 修 复 各 种 其 他 操作 以 确保 他 们 忽略 来 源 于 失败 的 CREATE INDEX CONCURRENTLY PA 
的 无 效 素 引 。 这 些 中 最 重要 的 是 vacu, 因为 在 采取 的 纠正 措施 用 于 修复 或 删除 无 效 
索引 之 前 ， 在 表 上 自动 清理 可 以 很 容易 地 被 运行 。 


。 当 内 存 不 足 时 ， 避 免 内 部 哈 希 表 崩 溃 (Hitoshi Harada) 
。 修复 外 连接 上 非 严格 等 价 子 句 规划 (Tom Lane) 


规划 器 可 以 从 等 同 于 其 它 东 西 的 非 严 格 建构 的 分 句 中 获取 不 正确 约束 ， 上 比如 当 foo 来 源 
于 外 连接 失效 端 时 ， wHERE COALESCE(foo, 0) = 0。 


。 提高 规划 器 证 明 来 自 等 价 类 排除 约束 的 能 力 (Tom Lane) 
。 修复 在 哈 希 子 计划 中 部 分 行 匹 配 以 正确 处 理 交 叉 类 型 情况 (Tom Lane) 


这 影响 到 多 列 nor IN 子 计 划 ， 上 比如 WHERE (a, b) NOT IN (SELECT x, y FROM...) o 当 比 
如 b My DHA inta 和 ints o 这 个 错误 导致 不 正确 结果 或 者 是 依赖 于 具体 所 涉及 数 
据 类 型 的 月 江 。 


e 当 为 AFTER ROW UPDATE/DELETE 触发 器 重新 读 取 旧 的 元 组 时 ， 那么 获取 缓冲 锁 (Andres 
Freund) 


在 非常 罕见 的 情况 下 ， 2— mA Re S BE A TEREE He IT ARR ee he BE 
辑 。 这 可 能 导致 崩溃 ， 或 者 关于 是 否 触发 触发 器 的 错误 决定 。 


修复 ALTER COLUMN TYPE 以 正确 义理 继承 的 检查 约束 (Pavan Deolasee) 
这 在 8.4 之 前 发 布 中 正常 运行 ， 并 且 在 8.4 以 及 以 后 发 布 中 也 正常 运行 。 
修复 REASSIGN owNED 以 处 理 表 空间 授权 (Alvaro Herrera) 
为 视图 系统 列 忽略 不 正确 的 pg_attribute 项 (Tom Lane) 


视图 没有 任何 系统 列 。 然 而 ， 当 转换 表 到 视图 时 ， 我 们 筷 了 删除 这 项 。 9.3 以 及 以 后 的 正 
确 修 复 ， 但 是 在 以 前 的 分 支 中 我 们 需要 防御 已 经 存在 的 错误 转换 视图 。 


修复 规则 输出 正确 备份 INSERT INTO _table_ DEFAULT VALUES (Tom Lane) 
当 在 查询 中 有 许多 UNION / intersect / except 子 句 时 ， 防止 堆栈 浴 出 (Tom Lane) 
当 最 小 的 可 能 的 整数 值 除 以 -1 时 ， 避 免 平台 相关 故障 (Xi Wang, Tom Lane) 

修复 数据 解析 中 可 能 访问 字符 串 末 尾 (Hitoshi Harada) 


如 果 Unix 域 套 接 字 路 径 名 长 度 超过 平台 特定 限制 ， 那么 会 产生 可 以 理解 的 错误 消息 (Tom 
Lane, Andrew Dunstan) 


先前 ， 这 可 能 导致 一 些 无 用 的 东西 ， 比 如 "域名 解析 中 不 可 恢复 故障 "。 
当 发 送 复合 列 值 给 客户 端 时 ， 修 复 内 存 泄露 (Tom Lane) 

使 得 pg_ctl 关 于 读 取 postmaster.pid 文件 更 加 重 棒 (Heikki Linnakangas) 
修复 竞争 条 件 和 可 能 的 文件 描述 符 泄 露 。 


如 果 给 出 错误 编码 数据 并 且 client_encoding 设置 是 客户 端 编 码 ， 比 如 SJIS， 那 么 修复 
psql 中 的 可 能 骨 溃 (Jiang Guiging) 


修复 tar 输出 格式 中 通过 pg_dump 发 出 的 restore.sql 脚本 中 的 错误 (Tom Lane) 


该 脚本 可 能 在 它 的 名 字 包 含 大 写字 符 的 表 中 完全 失败 。 另外 ， 使 得 脚本 有 能 力 存储 数据 
到 --inserts 模式 和 规则 的 COPY 模 式 。 

修复 pg_restore 以 接受 POSIX 标 准 的 tar 文件 (Brian Weaver, Tom Lane) 

pg_dump 的 tar 输出 模式 的 原 编码 产生 与 POSIX 标 准 不 完全 一 致 的 文件 。 这 是 9.3 版 本 


的 校正 。 这 个 补丁 更 新 先前 分 支 ， 以 致 于 它们 接受 正确 的 和 不 正确 格式 ， 当 发 布 9.3 
时 ， 和 希望 避免 兼容 性 问题 。 


当 给 定 一 个 数据 目录 的 相对 路 径 时 ， 修复 pg_resetxlog 以 正确 定位 postmaster.pid (Tom 
Lane) 


该 错误 可 能 导致 pg_resetxlog 没 有 注意 到 使 用 数据 目录 的 活路 的 postmaster。 

修复 libpq 的 lo_import() 和 lo_export() EX@XDAIE Wa R EXOR (Tom Lane) 

修复 谋 套 结构 指针 交 量 的 ecpg 的 处 理 (Muhammad Usama) 

当 检 查 页 的 时 候 ， 使 得 contrib/pageinspect 的 btree 页 检查 函数 采取 缓冲 锁 (Tom Lane) 
修复 pgxs 以 支持 AlIX 上 编译 可 加 载 模块 (Tom Lane) 

编译 不 在 AIX 上 运行 的 源码 树 外 部 模块 。 


为 了 Cuba, Israel, Jordan, Libya, Palestine, Western Samoa 以 及 Brazil 部 分 中 的 DST 变 化 
规律 更 新 时 区 数据 文件 到 tzdata 发 布 2012j。 


E.39. 发 布 8.4.14 


发 布 日 期 : 2012-09-24 


该 发 布 包含 了 8.4.13 的 各 种 修复 ， 关 于 8.4 主 要 发 布 新 功能 的 信息 ， 参阅 Section E.53。 


E.39.1. 迁移 到 版 本 8.4.14 


运行 8.4.X 不 需要 备份 /恢复 。 


然而 ， 如 果 你 从 8.4.10 更 早 版 本 更 新 ， 人 参阅 8.4.10 的 发 布 说 明 。 


E.39.2. 变化 


。 修复 执行 器 参数 的 规划 器 分 配 ， 为 CTE 规 划 节 点 修复 执行 器 的 重新 扫描 逻辑 (Tom Lane) 


这 些 错误 可 以 导致 来 自打 描 相 同 wITH 子 查询 多 次 的 查询 的 错误 结果 。 

。 提高 GiST 索 引 中 页 分 隔 决 定 (Alexander Korotkov,Robert Haas, Tom Lane) 
多 列 GiST 索 引 可 能 由 于 这 个 错误 遭受 意外 膨胀 。 

。 如 果 仍 持 有 该 权限 ， 那 么 修复 级 联 权限 撤销 以 停止 (Tom Lane) 


如 果 我 们 撤销 一 些 角色 x 的 grant 选 项 ， 但 是 x 仍然 认为 该 选项 通过 其 他 人 的 
grant. 我 们 不 应 该 递归 地 撤销 _x_ 授予 的 角色 _Y_ 的 相应 特权 。 


e 当 使 用 PL/Perl 的 时 候 ， 修 复 sierpe 的 义理 (Andres Freund) 


Perl 重 置 进程 的 srGFPE 义理 器 到 sic cn, 这 可 能 在 以 后 导致 崩溃 。 在 初始 化 PL/Perl 


之 后 恢复 正常 Postgres 信 号 处 理 程 序 。 
e 当 被 执行 时 ， 如 果 重 新 定义 递归 的 PL/Perl 画 数 ， 则 防止 PUPenl 骨 溃 (Tom Lane) 
。 解决 PL/Perl 中 可 能 的 错误 优化 (Tom Lane) 


一 些 Linux 发 布 包含 导致 PL/Perl 中 不 正确 编译 代码 的 pthread.h 不 正确 版 本 ， 如 果 
PL/Perl 范 数 调用 抛 出 错误 的 另外 一 个 ， 那 么 导致 月 渍 。 


© 为 了 Fiji 中 DST 变 化 规律 更 新 时 区 数据 文件 到 tzdata 发 布 2012f 


E.40. 发 布 8.4.13 


发 布 日 期 : 2012-08-17 


该 发 布 包含 来 自 8.4.12 各 种 修复 。 关于 8.4 主 要 发 布 的 新 功能 的 信息 ， 参阅 Section E.53。 


E.40.1. 迁移 到 版 本 8.4.13 


运行 8.4.X 不 需要 备份 /恢复 。 


然而 ， 如 果 你 从 8.4.10 更 早 版 本 更 新 ， 人 参阅 8.4.10 的 发 布 说 明 。 


E.40.2. 变化 


。 通过 XML 实 体 引 用 避免 访问 外 部 文件 /URL(Noah Misch, Tom Lane) 


xml_parse() 可 以 尝试 读 取 外 部 文件 夹 或 者 URL 作 为 需要 解决 DTD 以 及 XML 值 中 的 实体 
引用 ， 从 而 允许 未 授权 数据 库 用 户 尝试 读 取 和 与 数据 库 服 务 器 权限 的 数据 。 当 外 部 数据 还 
没 直接 返回 给 用 户 时 ， 如 果 数 据 没有 解析 为 有 效 XML， 那 么 它 的 一 部 分 可 能 会 暴露 在 错 
误 信 息 中 ; 并 且 无 论 如 何 检查 文件 是 否 存在 的 能 力 可 能 对 攻击 者 有 用 。 


e 阻止 通过 contrib/xml2 BY xslt_process() 访问 外 部 文件 夹 /URL(Peter Eisentraut) 
libxslt 提 供 通 过 样式 表 命 合 读 写 文 件 夹 和 URL 的 能 力 ， 从 而 允许 未 授权 数据 库 用 户 以 读 写 


带 有 数据 库 服务 器 权限 的 数据 。 禁止 通过 libxslt 的 安全 选项 的 正确 使 用 。(CVE-2012- 
3488) 


Eet, MER xslt_process() 的 能 力 从 外 部 文件 夹 /URL 中 读 取 文 件 和 样式 表 。 当 这 是 已 证 


明 " 特 性 "时 ， 那 么 它 被 长 期 视 为 坏 主意 。 为 了 CVE-2012-3489 修 复 打 破 该 能 力 ， 而 不 是 
付出 努力 党 试 修复 它 ， 我 们 只 是 打算 简单 地 删除 它 。 


。 防止 btree 索 引 页 过 早 回收 利用 (Noah Misch) 


当 我 们 允许 只 读 事务 略 过 已 分 配 XID 时 ， 当 只 读 事务 仍然 运行 到 它 时 ， 那么 我 们 介绍 已 
删除 btree 页 可 以 被 重新 利用 的 可 能 性 。 这 会 导致 不 正确 索引 搜索 结果 。 在 该 字段 产生 错 
误 的 可 能 性 很 低 ， 因 为 时 间 要 求 ， 但 尽管 如 此 它 应 该 被 修复 。 


。 修复 带 有 新 创造 或 者 重新 设置 序列 的 碰撞 安全 漏洞 (Tom Lane) 


如 果 在 新 创造 或 者 重新 设置 序列 上 执行 acter sequence, 然后 在 它 上 精确 执行 一 
个 nextval() 调用 ， 然后 服务 器 月 沉 了 ，WAL 回 放 可 以 恢复 序列 到 似乎 没有 执 
行 nextval() 的 状态 下 ， 然而 允许 通过 下 一 个 nextval() 调用 再 次 返回 第 一 个 序列 值 。 


特别 是 这 可 以 表现 为 serial 列 ， 因 为 串 行 列 的 序列 的 创建 包含 


ALTER SEQUENCE OWNED BY 步 又 。 

在 pg_start_backup() 之 后 确保 backup_label 文件 是 fsync (Dave Kerr) 

后 面 补 丁 9.1 改 进 以 压缩 fSync 请 求 队列 (Robert Haas) 

在 检查 点 期 间 提高 了 性 能 。 9.1 交 化 已 看 到 似乎 安全 的 足够 字段 测试 到 后 面 补丁 中 。 
仅仅 允许 autovacuum 通 过 直接 的 封锁 进程 被 自动 取消 (Tom Lane) 


原 代 码 可 能 允许 某 些 情况 下 的 不 一 致 操作 ; 特别 是 ， 在 少 于 deadlock_timeout 宽 限 期 后 
可 以 取消 autovacuum。 


改善 autovacuum 取 消 记 录 (Robert Haas) 


修复 日 志 收 集 器 以 致 于 在 服务 器 启动 后 第 一 个 日 志 循 环 期 间 运 


行 log_truncate_on_rotation (Tom Lane) 

修复 with WETERE ERE ( UNION / INTERSECT / EXCEPT )(Tom Lane) 

确保 参照 子 查询 的 整 行 不 包含 任何 额外 的 croup BY XA oRDER By 列 (Tom Lane) 
在 CREATE TABLE 期 间 check 约束 和 索引 定义 中 不 允许 拷贝 整 行 引 用 (Tom Lane) 


这 种 情况 可 以 产生 带 有 LIKE 或 者 INHERITS 的 CREATE TABLE o 复制 整 列 变量 被 错误 地 
标记 带 有 不 是 一 个 新 的 原来 表 的 行 类 型 。 为 LIKE 拒绝 理由 似乎 是 合理 的 ， 因为 行 类 型 
可 能 后 面 会 分 散 。 为 INHERITS 我 们 理论 上 应 该 接受 它 ， 伴随 对 父 表 的 行 类 型 的 隐 含 胁 
人 迫 ; 但 比 起 后 端 补丁 似乎 是 安全 的 需要 更 多 的 工作 。 


修复 ARRAY(SELECT ...) 子 查询 中 的 内 存 泄 露 (Heikki Linnakangas, Tom Lane) 
从 正则 表达 式 修复 常见 前 级 提取 (Tom Lane) 


该 代码 被 量化 的 括号 子 表达 式 搞 糊涂 了 ， 上 比如 ^(foo)?bar o 这 将 导致 这 种 模式 不 正确 的 
搜索 索引 优化 。 


修复 interval 常量 中 带 有 解析 符号 hh ``: omm 和 hh :`、mm“``:``_ss 字段 错误 
(Amit Kapila, Tom Lane) 





正确 报告 contribyxm12 的 xslt_process() 中 错误 (Tom Lane) 


为 了 Morocco 和 Tokelau 中 DST 变 化 规律 更 新 时 区 数据 文件 到 tzdata 发 布 2012e 


E.41. 发 布 8.4.12 


发 布 日 期 : 2012-06-04 


该 发 布 包含 8.4.11 中 各 种 修复 。 关于 8.4 主 要 发 布 的 新 功能 的 信息 ， 参阅 Section E.53。 


E.41.1. 迁移 到 版 本 8.4.12 


运行 8.4.X 不 需要 备份 /恢复 。 


然而 ， 如 果 你 从 8.4.10 更 早 版 本 更 新 ， 参阅 8.4.10 发 布 说 明 。 


E.41.2. 变化 


e 修复 contribypgcrypto 的 DES crypt() BAH 不 正确 的 密码 转换 (Solar Designer) 


如 果 密 码 字 符 串 包 含 字 节 值 ox8e ， 那 么 忽略 剩余 的 密码 ， 导致 密码 比 它 出 现 的 更 加 
弱 。 使 用 这 个 修复 ， 剩 余 字 符 串 被 恰当 地 包含 在 DES 哈 希 中 。 受 这 个 错误 影响 的 任何 存 
储 密码 值 将 不 再 匹配 ， 因 此 存储 值 可 能 需要 被 更 新 。(CVE-2012-2143) 


。 为 程序 语言 的 调用 义理 器 忽略 sEcuRITY DEFINER 和 set 属性 (Tom Lane) 
应 用 这 些 属性 到 调用 处 理 器 可 以 使 服务 器 月 溃 (CVE-2012-2655) 
© Sif timestamp 输入 中 数值 时 区 偏 移 量 远离 UTC 达到 16 小 时 (Tom Lane) 


一 些 历史 时 区 有 大 于 15 小 时 的 偏 移 量 ， 先 前 限制 。 这 可 能 导致 各 份 数据 值 在 重 载 期 间 被 
拒绝 。 


。 当 给 定时 间 恰 恰 是 当前 时 区 的 最 后 DST 转 变 时 间 时 ， 修复 时 间 惟 转换 义理 (Tom Lane) 


这 次 中 忽 已 有 很 长 时 间 ， 但 是 以 前 没有 被 注意 到 ， 因为 假设 大 多 数 DST 时 区 有 未 来 DST 
转换 的 不 明确 的 序列 。 


e 修复 text 到 name 并 且 char 到 name 投射 以 便 在 多 字 节 编码 中 正确 执行 字符 串 截 断 
(Karl Schnaitter) 


e 修复 to_tsquery() 中 内 存 复制 错误 (Heikki Linnakangas) 
。 修复 子 查询 内 PlaceHolderVars 外 的 规划 器 处 理 (Tom Lane) 


这 个 错误 涉及 到 子 SELECT， 它 引用 来 自 周 围 查 询 的 外 部 连接 的 空 侧 的 变量 。 在 9.1 中 ， 
这 个 错误 影响 的 查询 可 能 伴随 有 "错误 : 在 不 被 预期 的 地 方 发 现 上 层 PlaceHolderVar" 而 失 
mo 但 是 在 9.0 和 8.4 中 ， 你 可 能 默默 地 获得 可 能 的 错误 结果 ， 因 为 当 需 要 时 ， 传递 到 子 


查询 中 的 值 不 能 定位 到 空 。 
当 pg_attribute 很 大 的 时 候 ， 修 复 缓 慢 会 话 启 动 (Tom Lane) 


如 果 pg_attribute 超过 了 shared_buffers 的 四 分 之 一 ， 在 会 话 开 始 时 有 时 需要 缓存 重 
建 代 码 可 以 触发 同步 打 描 逻辑 ， 导致 它 采 取 比 正常 更 长 的 时 间 。 如 果 许 多 新 会 话 马上 开 
始 ， 那 么 问题 是 相当 严重 的 。 


确保 顺序 扫描 合理 地 检查 查询 取消 (Merlin Moncure) 
遇 到 许多 包含 非 活路 元 组 连续 页 的 扫描 不 会 同时 响应 中 断 。 
确保 返回 之 前 PGSemaphoreLock() 清除 ImmediateInterruptok 的 Windows 实 现 (Tom Lane) 


这 种 下 忽 意味 着 在 同一 个 查询 中 后 来 收 到 的 查询 取消 中 断 可 能 在 不 安全 时 间 被 接受 ， 伴 
随 着 不 可 预知 的 但 不 好 的 结果 。 


当 输 出 视图 或 者 规则 时 ， 安 全 显示 整 行 变 量 (Abbas Butt, Tom Lane) 


涉及 歧义 名 字 ( 也 就 是 说 ， 该 名 字 可 以 是 一 个 表 或 者 查询 的 列 名 ) 的 情况 被 以 模糊 方式 输 
H, 冒险 转 储 和 重 载 之 后 不 同 地 解释 视图 或 者 规则 。 通过 附加 无 操作 计算 避免 模 凌 两 可 
的 | A bo 


修复 copy From 以 正确 处 理 与 无 效 编码 一 致 的 空 标记 字符 串 (Tom Lane) 


一 个 空 标 记 字 符 串 比如 E'\\e' 应 该 工作 ， 并 且 工 作 于 过 去 ， 但 是 这 种 情况 在 8.4 中 被 打 
破 。 


确保 autovacuum 工 作 进 程 恰当 执行 堆栈 深度 检查 (Heikki Linnakangas) 

先前 ， 通 过 自动 ANALYzE 调用 的 无 限 递 当 男 数 可 以 使 工作 进程 崩溃 。 

修复 日 志 收 集 器 在 高 负 戴 下 没有 丢失 日 志 一 致 性 (Andrew Dunstan) 

如 果 它 太 忙 ， 那 么 收集 器 先前 可 能 重新 收集 大 的 信息 失败 。 

修复 日 志 收集 器 以 确保 它 在 接收 SIGHUP 之 后 重启 文件 旋转 (Tom Lane) 

如 果 素 引 随 后 被 删除 ， 那 么 修复 GIN 索 引 WAL 回 放 逻 辑 而 不 失败 (Tom Lane) 

修复 PL/pgSQL 的 RETURN NEXT 命令 中 内 存 泄露 (Joe Conway) 

448 eeHANSB-T ESN, (ESPL/pgSQLA GET pracnostics 命令 (Tom Lane) 
修复 psql 的 扩展 显示 ( \x ) 模 式 中 潜在 的 访问 内 存 结尾 (Peter Eisentraut) 

当 数 据 库 包含 许多 对 象 时 ， 修 复 pg_dump 中 若干 性 能 问题 (Jeff Janes, Tom Lane) 


如 果 数 据 库 包含 许多 视图 ， 或 者 如 果 许 多 对 象 在 依赖 循环 中 ， 或 者 如 果 有 许多 拥有 的 序 
列 ， 那么 pg_dump 可 能 会 很 慢 。 


e 修复 contrib/dblink 的 dblink_exec() 不 泄露 临时 数据 库 连 接 错误 (Tom Lane) 
e 修复 contrib/dblink 以 报告 错误 消息 中 正确 连接 名 (Kyotaro Horiguchi) 


e 为 了 在 Antarctica, Armenia, Chile, Cuba, Falkland Islands, Gaza, Haiti, Hebron, 


Morocco, Syria 和 Tokelau lslands 中 DST 变 化 规律 更 新 时 区 数据 文件 到 tzdata 发 布 
2012c ; 同时 为 Canada 历 史 修正 。 


E.42. 发 布 8.4.11 


发 布 日 期 : 2012-02-27 


该 发 布 包含 8.4.10 各 种 修复 。 关 于 8.4 主 要 发 布 的 新 功能 的 信息 ， 参阅 Section E.53。 


E.42.1. 迁移 到 版 本 8.4.11 


运行 8.4.X 不 需要 备份 /恢复 。 


然而 ， 如 果 你 从 8.4.10 更 早 版 本 更 新 ， 人 参阅 8.4.10 发 布 说 明 。 


E.42.2. %14k 


需要 为 CREATE TRIGGER 触发 器 函数 上 的 执行 权限 (Robert Haas) 


这 个 丢失 检查 可 能 允许 其 他 用 户 执 行 带 有 伪造 输入 数据 的 触发 器 玉 数 ， 通过 安装 它 到 它 
拥有 的 表 上 。 对 于 触发 器 函数 标记 SECURITY DEFINER 是 唯一 重要 的 ， 因为 否则 触发 器 萎 
数 运行 为 表 所 有 者 。(CVE-2012-0866) 


删除 SSL 证 书 中 常见 名 称 长 度 的 任意 限制 (Heikki Linnakangas) 


libpq 和 服务 器 截断 从 32 字 节 SSL 证 书 中 提取 的 通用 名 。 这 通常 会 导致 没有 什么 比 一 个 意 
想不到 的 验证 失败 更 精 糕 的 ， 但 是 有 一 些 令 人 难以 置信 的 情况 ， 它 可 能 允许 一 个 证 书 持 
有 者 模仿 另外 一 个 。 该 受害 者 必须 有 32 字 节 长 的 通用 名 。 并 且 攻 击 者 必须 说 服 可 信任 CA 
发 布 证 书 ， 其 中 通用 名 有 字符 串 作为 前 级 。 伪装 服务 器 也 需要 一 些 额 外 的 开发 重 定向 客 
户 端 连接 。(CVE-2012-0867) 


在 名 字 写 入 pg_dump 说 明 中 转换 新 行 到 空白 (Robert Haas) 


pg_dump 关 于 审查 输出 脚本 中 SQL 注 释 发 出 的 对 象 名 是 不 庶 愤 的 。 包含 换行 符 的 名 字 至 
少 使 得 脚本 语法 上 不 正确 。 当 肢 本 被 重新 加 载 时 ， 悉 意 制作 对 象 名 可 能 出 现 SQL 注 射 风 
险 。(CVE-2012-0868) 


修复 来 自 并 行 清理 插入 的 btree 索 引 崩 江 (Tom Lane) 


通过 插入 引起 的 索引 页 分 裂 有 时 可 以 导致 同时 运行 vacuum 而 错过 删除 本 应 该 删除 的 索引 
项 。 相 应 表 行 被 删除 后 ， 该 悬挂 索引 项 可 能 导致 错误 〈 比 如 "不 能 读 取 文 件 中 块 N.…") 或 
AEM, 无 关 行 后 默默 的 错误 查询 结果 被 重新 插入 到 当前 自由 表 位 置 。 这 个 错误 自从 发 
布 8.2 就 出 现 了 ， 但 是 发 生 如 此 罕见 以 致 它 没有 被 诊断 直到 现在 。 如 果 你 有 理由 怀疑 它 
已 经 在 你 的 数据 库 中 发 生 ， 那么 重新 索引 受 影响 索引 将 修复 这 问题 。 


当 改 变 表 所 有 者 时 ， 更 新 每 列 权 限 ， 不 仅仅 每 个 表 权 限 (Tom Lane) 


不 这 样 做 就 意味 着 任何 先前 已 授权 列 权 限 仍然 显示 为 已 被 旧 的 所 有 者 授权 。 这 意味 着 既 
不 是 新 所 有 者 也 不 是 超级 用 户 可 以 撤销 目前 难以 寻找 的 到 表 所 有 者 权限 。 


人 允许 ALTER USER/DATABASE SET 中 一 些 设置 的 不 存在 值 (Heikki Linnakangas) 


人 允许 default_text_search_config , default_tablespace 和 temp_tablespaces 被 设置 为 
不 知道 的 名 字 。 这 是 因为 它们 可 能 在 另 一 个 数据 库 中 已 知 ， 该 设置 打算 使 用 的 地 方 ， 或 
者 为 了 表 空 间 情 况 因 为 表 空 间 可 能 不 会 被 创建 。 同样 问题 是 先前 已 确认 

为 search_path ， 并 且 这 些 设置 像 那 一 个 。 


当 我 们 删除 后 提交 表 文 件 有 问题 时 ， 避 免 崩 溃 (Tom Lane) 


删除 表 导 致 事务 提交 之 后 删除 底层 磁盘 文件 。 在 失败 的 情况 中 〈 比 如 ， 由 于 错误 文件 权 
限 ) 那么 该 代码 应 该 发 出 警告 信息 并 且 继续 ， 因为 它 太 晚 了 而 终止 了 事务 。 这 个 逻辑 已 
作为 发 布 8.4 被 打破 ， 导致 这 种 情况 引起 PANIC 和 不 可 重新 启动 的 数据 库 。 


在 WAL 回 放 期 间 正 确 跟踪 OID 计 数 器 ， 即 使 当 它 包围 周围 (Tom Lane) 


先前 OID 计 数 器 可 以 保持 在 较 高 的 值 上 直到 系统 退出 回放 模式 。 实际 结果 通常 为 雳 ， 但 
是 存在 这 样 一 种 情况 ， 各 用 服务 器 提升 到 主 服 务 器 可 能 需要 很 长 时 间 增加 OID 计 数 器 到 
一 个 合理 值 ， 一 旦 该 值 是 必须 的 。 


修复 带 有 * 附属 的 正则 表达 式 逆 向 引用 (Tom Lane) 


而 不 是 执行 一 个 确切 的 字符 串 匹 配 ， 该 代码 有 效 地 接受 任何 满足 模式 子 表达 式 引用 逆向 
引用 符号 的 字符 串 。 


类 似 问 题 仍 然 困 扰 着 被 禾 人 到 大 的 量化 表达 式 中 的 逆向 引用 ， 而 不 是 量词 的 直接 主题 。 
这 将 在 未 来 PostgreSQL 发 布 中 得 以 解决 。 


修复 inet / cidr 值 处 理 中 最 新 引进 的 内 存 泄露 (Heikki Linnakangas) 


PostgreSQL 的 2011 年 12 月 份 发 布 的 补丁 导致 了 这 些 操作 中 内 存 泄露 ， 这 可 能 是 重要 情 
况 比 如 在 这 样 的 列 上 编译 btree 索 引 。 


ESSLE WAH CREATE TABLE AS / SELECT INTO 之 后 的 悬挂 指针 (Tom Lane) 
在 大 多 数 情况 中 这 导致 断言 启用 编译 中 断言 失败 ， 但 是 更 糟 结果 是 可 能 的 。 

避免 Windows 上 syslogger 中 文件 句柄 的 双关 闭 (MauMau) 

通常 这 个 错误 是 无 形 的 ， 但 是 当 在 Windows 的 调试 版 本 上 运行 时 ， 它 可 能 导致 异常 。 
修复 plpgsql 中 MO 转换 关系 内 存 泄露 (Andres Freund, Jan Urbanski, Tom Lane) 


某 些 操作 可 能 泄露 内 存 直 到 当前 酚 数 结束 。 


提升 继承 表 列 的 pg_dump 的 处 理 (Tom Lane) 


pg_dump 你 理 不 当 的 情况 下 ， 一 个 子 列 比 它 的 父 列 有 不 同 的 缺 省 表达 式 。 如 果 缺 省 文本 
上 和 与 父 类 的 缺 省 是 相同 的 ， 但 不 是 真 的 相同 〈 例 如， 由 于 模式 搜索 路 径 的 差异 ) 不 会 被 
认为 是 不 同 的 ， 所 以 在 转 储 和 恢复 后 子 类 可 以 被 允许 继承 父 的 缺 省 。 在 它们 的 父 类 不 能 
微妙 地 错误 地 被 恢复 的 地 方 子 列 非 空 。 


为 了 INSERT 形 式 表 数据 修复 pg_restore 的 直接 到 数据 库 模 式 (Tom Lane) 


当 使 用 发 布 日 期 2011 年 九 月 或 者 十 二 月 的 pg_restore 的 时 候 ， 从 妇 档 文件 中 恢复 直接 到 
数据 库 伴 随 --inserts 或 者 --column-inserts 选项 而 失败 ， (FAZA-TH MESH 
忽 结果 。 为 档 文件 本 身 没有 错 ， 而 且 文 本 模式 输出 是 好 的 。 


在 ecpg DEALLOCATE 语句 中 人 允许 AT (Michael Meskes) 
支持 这 个 的 基础 设施 已 有 一 段 时 间 了 ， 但 由 于 玻 忽 仍 然 有 拒绝 这 种 情况 的 错误 检查 。 
修复 contrib/intarray 的 int[] &int[] 操作 符 中 的 错误 (Guillaume Lelarge) 


如 果 最 小 整数 的 两 个 输入 数组 中 常见 的 是 1， 并 且 在 其 中 之 一 数组 中 有 和 较 小 的 值 ， 然 后 将 
1 从 结果 中 错误 地 省 略 。 


修复 contrib/pgcrypto BY encrypt_iv() 和 decrypt_iv() 中 的 错误 检查 (Marko Kreen) 


这 些 事 数 没有 成 功 报告 无 效 输入 错误 的 某 些 类 型 ， 并 且 反而 为 不 正确 输入 返回 随机 垃圾 
值 。 


修复 contrib/test_parser 中 一 字 节 缓冲 区 超出 范围 (Paul Guyot) 


该 代码 将 尝试 读 取 比 它 应 该 的 又 一 个 字 节 ， 这 将 在 困境 情况 下 朋 溃 。 
为 contrib/test_parser 只 是 示例 代码 ， 这 本 身 不 是 一 个 安全 问题 ， 但 不 好 的 例子 代码 仍 
然 是 差 的 。 


如 果 可 用 ， 那 么 在 ARM 上 为 spinlocks 使 用 _sync_lock_test_and_set() (Martin Pitt) 





这 个 函数 替换 swe 指使 先前 用 法 ， 它 已 经 废弃 并 且 在 ARMv6 和 之 后 的 不 可 用 。 报告 建 
议 该 旧 代 码 在 最 新 ARM 上 以 显著 方式 使 用 ， 但 是 不 能 简单 地 连锁 并 发 访问 ， 导 致 多 进程 
操作 中 的 离奇 失败 。 


当 编 译 接受 它 的 gcc 版 本 时 ， 使 用 -fexcess-precision=standard 选项 (Andrew Dunstan) 
这 阻止 各 种 各 样 的 情节 ， 其 中 gcc 最 新 版 本 将 产生 创造 性 结果 。 
允许 FreeBSD 上 线程 Python 的 使 用 (Chris Rees) 


我 们 配置 脚本 先前 认为 这 种 组 合 不 会 允许 ; 但 是 FreeBSD 修 复 该 问题 ， 因此 删除 错误 检 
查 。 


E.43. 发 布 8.4.10 


发 布 日 期 : 2011-12-05 


该 发 布 包含 8.4.9 的 各 种 修复 ， 关于 8.4 主 要 发 布 的 新 功能 的 信息 ， 参阅 Section E.53。 


E.43.1. 迁移 到 版 本 8.4.10 


运行 8.4.X 不 需要 备份 /恢复 。 


然而 ， 在 information_schema.referential_constraints 视图 的 定义 中 发 现 了 一 个 长 期 错误 。 
如 果 你 依赖 该 视图 的 正确 结果 ， 那 么 你 应 该 像 下 面 第 一 个 更 新 记录 项 解释 的 替换 它 的 定义 。 


同时 ， 如 果 你 从 8.4.8 更 早 版 本 更 新 ， 参 阅 8.4.8 发 布 说 明 。 


E.43.2. 变化 


修复 information_schema.referential_constraints 视图 中 错误 (Tom Lane) 


该 视图 对 于 匹配 依赖 主键 的 外 键 约束 或 者 唯一 性 约束 不 够 仔细 。 这 可 能 导致 显示 所 有 外 
键 约束 的 错误 ， 或 者 显示 多 次 ， 或 者 声明 它 取决 于 比 确实 存在 的 不 同 约束 。 

因为 该 视图 定义 是 通过 initdb 安 装 的 ， 只 是 升级 不 会 修复 该 问题 。 如 果 你 需要 在 现 有 的 安 
装 中 修复 这 个 问题 ， 你 可 以 (作为 一 个 超级 用 户 ) 删除 information_schema 模式 ， 然 后 
通过 _sHAREDIR /informationschema.sq/ 重新 创建 它 。 (如 果 你 不 确定 

”SHAREDIJR 在 哪里 ， 运行 pg_config --sharedir) 必须 在 被 修复 的 每 个 数据 库 中 重复 。 


修复 GIN 索 引 更 新 WAL 记 录 的 错误 回放 (Tom Lane) 


这 可 能 导致 在 崩 江 后 或 者 热 各 服务 器 上 芹 时 无 法 找到 索引 项 ， 然而 ， 该 问题 可 以 通过 束 
引 的 下 一 个 vacuum 被 修复 。 


修复 CREATE TABLE dest AS SELECT * FROM src 或 
者 INSERT INTO dest SELECT * FROM src 期 间 TOAST 相 关 数 据 损 坏 (Tom Lane) 


如 果 表 通过 ALTER TABLE ADD COLUMN 被 修改 ， 那么 党 试 逐 字 拷贝 它 的 数据 到 另 一 个 表 在 
某 些 困境 情况 下 可 以 产生 骨 溃 结果 。 该 问题 表现 在 8.4 以 及 之 后 版 本 的 精确 形式 中 ， 但 
是 我 们 补丁 早期 版 本 以 及 有 其 他 编码 路 径 下 可 以 触发 相同 错误 。 


修复 toast 表 访问 陈旧 syscache 项 中 的 竞争 条 件 (Tom Lane) 


典型 症状 是 短暂 错误 像 "为 pg_toast 2619 中 toast 值 NNNNN 丢 失 块 号 0"， 其 中 引用 的 
toast 表 总 是 从 属于 一 个 系统 目录 。 


跟踪 用 于 参数 缺 省 表达 式 函 数 依赖 (Tom Lane) 


以 前 ， 被 引用 的 对 象 没有 删除 或 者 修改 函数 而 被 删除 ， 当 使 用 该 画 数 时 ， 导 致 错误 操 
作 。 请 注意 ， 仅 仅 安 装 此 更 新 将 不 能 修复 丢失 依赖 项 ; 这 样 ， 你 之 后 需 

要 CREATE OR REPLACE BPM, 如 果 你 有 缺 省 依赖 非 内 置 对 象 的 画 数 ， 这 样 做 是 值得 推 
荐 的 。 


人 允许 有 多 个 OUT 参 数 的 设置 返回 SQL 画 数 的 内 联 (Tom Lane) 


使 得 patumcetInetP() 解压 有 1 字 节 头 的 inet 数 据 ， 并 且 添 加 一 个 新 宏 ， 
DatumGetInetPP() 确实 没有 (Heikki Linnakangas) 


这 个 变化 不 影响 核心 代码 ， 但 是 可 能 阻止 希望 DatumGetInetP() 按 惯 例 产 生 解 压 数据 的 
附加 代码 中 崩溃 。 


提高 money 类 型 的 输入 和 输出 的 区 域 支 持 (Tom Lane) 


除了 不 支持 所 有 标准 的 1c_monetary 格式 选项 ， 输 入 和 输出 函数 是 一 致 的 ， 意味 着 有 区 
域 备份 money 值 不 能 被 重读 。 


县 : 


不 要 让 transform null equals 影响 CASE foo WHEN NULL ... 结构 (Heikki Linnakangas) 


transform_null_equals 只 会 影响 直接 由 用 户 编写 的 foo = NULL 表达 式 ， 通过 CASE 这 


种 形式 内 部 产生 的 不 平等 检查 。 
改变 外 键 触发 器 创建 顺序 更 好 地 支持 自我 参照 外 键 (Tom Lane) 


一 个 级 联 外 键 引用 它 自己 的 表 ， 行 更 新 将 触发 on UPDATE 触发 器 和 作为 一 个 事件 

的 CHECK o ON UPDATE 触发 器 必须 首先 执行 ， 否 则 check 将 检查 该 行 的 非 最 终 状 态 并 
且 可 能 抛 出 一 个 不 合适 错误 。 然而 ， 这 些 触发 器 的 触发 顺序 是 由 自己 名 字 决 定 的 ， 其 中 
通常 按照 创建 顺序 排序 ， 因 为 触发 器 按照 惯例 "RI_ConstraintTrigger_NNNN" 有 自动 生 
成 的 名 字 。 一 个 适当 的 修复 将 需要 修改 该 惯例 ， 我 们 会 在 9.2 中 执行 ， 但 在 现 有 的 版 本 
中 改变 它 似 乎 有 风险 。 所 以 这 个 补丁 只 改变 触发 器 的 创建 顺序 。 用 户 遇 到 此 类 型 的 错误 
要 删除 并 重新 创建 外 键 约 束 使 得 它 的 触发 器 进入 正确 的 顺序 。 


当 跟 踪 缓 冲 区 分 配 率 时 ， 避 免 浮 点 下 浴 (Greg Matthews) 

当 对 自身 无 害 时 ， 在 某 些 平台 上 这 可 能 导致 讨厌 的 内 核 日 志 信息 。 
4fEWindows F Ba FRE, 保留 配置 文件 名 字 和 行 号 值 (Tom Lane) 

以 前 ， 这 些 在 pg_settings 视图 中 不 能 被 正确 显示 。 

保留 psql 的 命令 历史 中 该 命令 中 的 空白 行 (Robert Haas) 

如 果 从 字符 串 中 删除 空 行 ， 前 者 操作 可 能 产生 问题 ， 比 如 。 

修复 pg_dump 以 各 份 自动 生成 类 型 之 间 用 户 定义 的 映射 ， 比如 表 rowtype(Tom Lane) 


使 用 xsubpp 首 选 版 本 以 编译 PL/Perl， 不 一 定 操作 系统 的 主 拷贝 (David Wheeler 和 Alex 
Hunsaker) 


修复 contrib/dict_int 和 contrib/dict_xsyn 中 入 错误 编码 (Tom Lane) 
一 些 酌 数 错误 地 假设 通过 十 palloc() 返回 的 内 存 保证 为 需 
e 接受 pgstatindex() 中 的 及 时 查询 取消 中 断 (Robert Haas) 


确保 VPATH 编 译 正 确 安 装 所 有 服务 器 头 文件 (Peter Eisentraut) 


缩短 详细 错误 消息 中 报告 的 文件 名 (Peter Eisentraut) 


规则 编译 一 直 被 包含 错误 消息 调用 的 C 文 件 名 报告 ， 但 是 VPATH 编 译 之 前 报告 绝对 路 径 
名 。 


。 修复 中 美洲 Windows 时 区 名 解释 (Tom Lane) 


映射 "中 美洲 标准 时 间 " 为 csT6 ， 而 不 是 csT6coT ， 因为 在 中 美洲 任何 地 方 通 常 观察 不 
到 DST。 


e 为 了 Brazil, Cuba, Fiji, Palestine, Russia 和 Samoa 中 DST 变 化 规律 更 新 时 区 数据 文件 到 
tzdata 发 布 2011n ; 以 及 历史 修正 Alaska 和 British East Africa. 


E.44. £ 78.4.9 


发 布 日 期 : 2011-09-26 


该 发 布 包含 来 自 8.4.8 的 各 种 修复 。 关 于 8.4 主 要 发 布 的 新 功能 的 信息 ， 参阅 Section E.53。 


E.44.1. 迁移 到 版 本 8.4.9 


为 运行 8.4.X 不 需要 备份/ 恢复 。 
然而 ， 如 果 你 从 8.4.8 更 早 版 本 更 新 ， 参 阅 8.4.8 发 布 说明 。 


E.44.2. %41k 


。 修复 存在 问题 的 热 更 新 元 组 的 索引 错误 (Tom Lane) 
这 些 错误 可 以 导致 重新 索引 系统 目录 后 索引 月 演 。 他 们 不 认为 会 影响 用 户 索 引 。 
。 修复 GiST 索 引 页 分 裂 处理 的 多 个 错误 (Heikki Linnakangas) 
发 生 的 概率 是 很 低 的 ， 但 是 可 以 导致 索引 失败 。 
e 修复 tsvector_concat() 中 可 能 的 缓冲 区 浴 出 (Tom Lane) 
该 函数 低估 它 的 结果 所 需要 的 内 存量 ， 导 致 服务 器 骨 溃 。 
e 当 处 理 "standalone" 参 数 时 ， 修 复 xml_recv 中 崩溃 (Tom Lane) 
e 使 得 pg_options_to_table 为 没有 值 的 选项 返回 NULL(Tom Lane) 
以 前 这 种 情况 可 以 导致 服务 器 崩溃 。 
。 避免 在 ANALYZE 和 SJIS-2004 编 码 转 换 中 可 能 访问 内 存 结尾 (Noah Misch) 
这 修复 了 一 些 概率 很 低 的 服务 器 月 淡 情 况 。 
。 防止 间歇 性 挂 在 启动 进程 和 bgwriter 进 程 的 相互 作用 中 (Simon Riggs) 
这 影响 了 在 非 热 备份 情 况 中 的 恢复 。 
。 修复 relcache 初 始 文件 失效 的 竞 态 条 件 (Tom Lane) 


有 一 个 Window， 其 中 新 的 后 台 进 程 可 以 读 一 个 陈旧 的 初始 化 文件 ， 但 是 忽略 了 告知 它 的 
数据 是 陈旧 的 无 效 消息 。 其 结果 在 目录 访问 中 是 奇怪 的 错误 ， 通 常 在 启动 之 后 "无 法 读 取 
文件 中 块 0..…"。 


($8 fEGISTSA5 | ta tas EWA itt Fe(Tom Lane) 


执行 许多 单独 GiST 索 引 扫 描 的 命 售 ， 比如 包含 很 多 行 的 表 上 新 的 基于 排斥 约束 的 GiST 验 


证 ， 由 于 这 种 泄露 可 能 短暂 地 需要 大 量 内 存 。 


修复 元 组 存储 可 支持 游标 以 及 plpgsql 的 RETURN NEXT 命令 中 不 正确 的 内 存 计算 (可 能 


RAFA) (Tom Lane) 

当 建 立 一 个 大 的 ， 有 损耗 的 位 图 时 ， 修 复 性 能 问题 (Tom Lane) 

修复 唯一 列 的 连接 选择 性 估计 (Tom Lane) 

这 修复 了 可 以 导致 连接 结果 大 小 的 较 差 估计 的 错误 的 规划 器 探 试 。 

修复 只 出 现在 子 select 目 标 列 中 的 找 套 PlaceHolderVar 表 达 式 (Tom Lane) 
这 个 错误 可 以 导致 错误 的 出 现 空 的 外 部 连接 的 输出 。 

运行 正确 优化 的 府 套 的 exists 查询 (Tom Lane) 


修复 数组 和 路 径 创 建 画 数 确保 填充 字 节 为 震 (Tom Lane) 


这 避免 了 规划 器 认为 语义 上 相同 的 常数 是 不 相等 的 一 种 情况 ， 导 致 低劣 的 优化 。 


修复 ExPLAIN 以 处 理 内 部 索引 扫描 子规 划 中 控制 结果 节点 (Tom Lane) 

这 种 忽视 的 通常 状况 是 "bogus varno" 错 误 。 

解决 了 打破 WAL 回 放 的 gcc 4.6.0 错 误 (Tom Lane) 

这 可 能 会 导致 服务 器 朋 溃 后 已 提交 事务 损失 。 

修复 视图 中 vALuES 各 份 错误 (Tom Lane) 

不 允许 序列 上 SELECT FOR UPDATE/SHARE (Tom Lane) 

该 操作 不 按 预 期 运行 并 且 导 致 错误 。 

修复 vAcuuM 所 以 它 总 是 更 新 pg_class . reltuples / relpages (Tom Lane) 
这 将 修复 对 于 当 vacuum 表 的 时 候 autovacuum 可 能 会 越 来 越 差 的 一 些 情况 。 
当 计算 哈 希 表 大 小 时 ， 防 止 整数 浴 出 (Tom Lane) 

修复 cLusTER 可 能 党 试 访问 已 删除 TOAST 数 据 (Tom Lane) 

修复 为 "peer" 认 证 使 用 凭证 控制 消息 的 可 能 错误 (Tom Lane) 

当 需 要 多 次 往返 时 ， 修 复 SSPI 登 录 (Ahmed Shinwari,Magnus Hagander) 


这 个 问题 典型 症状 是 在 SSPI 登 录 期 间 " 不 支持 该 娘 数 请 求 "错误 。 


如 果 pg_hba.conf 包含 hostssl1 ， 但 是 SSL 被 禁用 ， 抛 出 错误 (Tom Lane) 
这 一 结论 比 默默 忽略 这 些 行 的 先前 操作 更 加 人 性 化 。 
修复 pg_srand48 起 源 初始 化 中 的 typo (Andres Freund) 


这 导致 错误 使 用 已 提供 的 种 子 的 所 有 位 。 在 大 多 数 平台 上 不 使 用 这 个 功能 (只 有 那些 没 
有 srandom BY) ， 以 及 来 自任 何 情况 下 比 预 期 更 少 随机 种 子 似乎 最 小 的 潜在 安全 隐患 。 


当 LIMIT 和 oFFSET 总 数值 超过 2^63 的 时 候 ， 避免 整数 浴 出 (Heikki Linnakangas) 
添加 渝 出 检查 到 generate_series() 的 int4 和 ints 版 本 (Robert Haas) 

修复 to_char() 中 尾随 需 删 除 (Marti Raudsepp) 

PA FM 的 格式 ， 并 且 小 数 点 后 没有 数字 位 置 中 ， 小 数 点 左边 的 需 可 能 被 错误 地 删除 。 
修复 pg_size_pretty() 以 避免 接近 2^63 的 输入 浴 出 (Tom Lane) 
削弱 记录 值 中 typmod 匹 配 的 plpgsql 检 查 (Tom Lane) 

一 个 过 分 热情 检查 可 能 导致 丢弃 一 直 保 持 的 长 度 修 饰 符 。 

正确 处 理 initdb 期 间 的 区 域名 的 引用 (Heikki Linnakangas) 

这 种 情况 可 以 产生 一 些 Windows 区 域 ， 比 如" 中华 人民 共和 国 "。 

从 8.3 更 新 期 间 修复 pg_upgrade 保 存 toast 表 的 relfrozenxid (Bruce Momjian) 

如 果 不 这 样 做 可 能 导致 pg clog 文件 升级 后 很 快 被 删除 。 

在 pg_ctl 中 ， 支持 Windows 上 服务 注册 静止 模式 (MauMau) 

修复 从 不 同文 件 copy 时 脚本 文件 行 数 的 psql 计 数 (Tom Lane) 

为 standard_conforming_strings 修复 pg_restore 的 直接 到 数据 库 模式 (Tom Lane) 


当 从 standard_conforming_strings 设置 为 on 的 为 档 文件 中 直接 恢复 到 数据 库 服务 器 
时 ，pg_restore 可 以 发 出 错误 命令 。 


关于 平行 的 pg_restore 不 支持 情况 用 户 界 面 友好 (Tom Lane) 

该 变化 确保 了 在 采取 的 任何 恢复 操作 之 前 这 种 情况 被 检测 和 报告 。 

修复 写 入 超越 缓冲 区 末尾 以 及 在 libpq 的 LDAP 服 务 查 找 代码 中 的 内 存 泄漏 (Albe Laurenz) 
在 libpq 中 ， 当 使 用 非 阻 塞 WO 和 SSL 连 接 时 避免 错误 (Martin Pihlak, Tom Lane) 

连接 启动 时 提高 libpq 的 错误 处 理 (Tom Lane) 


特别 是 ， 在 SSL 连 接 启 动 时 fork() 错误 的 服务 器 报告 的 反应 是 明智 的 。 


提高 SSL 故 障 libpq 的 错误 报告 (Tom Lane) 


当 添 加 新 元 组 到 最 初 从 服务 器 查询 获得 的 Presult 时 ， 修复 Pasetvalue() 避免 可 能 朋 
ya (Andrew Chernow) 


使 得 ecpglib 写 入 带 有 15 位 数字 精度 的 double 值 (Akira Kurosawa) 
在 ecpglib 中 ， 确 保 错 误 之 后 恢复 Lc_NuMERIC 设置 (Michael Meskes) 
提供 上 游 修复 加 密 的 符号 字符 错误 (CVE-2011-2483)(Tom Lane) 


contrib/pg_crypto 的 加 密 代 码 可 以 在 字符 是 有 符号 的 (这 是 大 多 数 ) 平台 上 提供 错误 结 
果 ， 导 致 加 密 密 码 比 它们 所 应 该 的 更 弱 。 


修复 contrib/seg 中 的 内 存 泄露 (Heikki Linnakangas) 

修复 pgstatindex() 为 空 素 引 提供 一 致 结果 (Tom Lane) 

人 允许 编译 perl 5.14 (Alex Hunsaker) 

为 探测 系统 函数 的 存在 更 新 配置 脚本 方法 (Tom Lane) 

在 8.3 和 8.2 中 使 用 的 autoconf 的 版 本 可 能 被 执行 链接 时 优化 的 编译 器 愚弄 。 
修复 包含 空格 的 编译 安装 文件 路 径 的 相关 问题 (Tom Lane) 


更 新 时 区 数据 文件 到 为 Canada, Egypt, Russia, Samoa 和 South Sudan 中 的 DST 变 化 规律 
的 tzdata 发 布 2011i。 


E.45. £ 78.4.8 


发 布 日 期 : 2011-04-18 


该 发 布 包含 来 自 8.4.7 的 各 种 修复 ， 关于 8.4 主 要 发 布 的 新 功能 信息 ， 参阅 Section E.53。 


E.45.1. 迁移 到 版 本 8.4.8 


运行 8.4.X 不 需要 备份 /恢复 。 


然而 ， 如 果 你 的 安装 是 通过 运行 bg_upgrade 从 原先 主要 发 布 中 更 新 ， 你 应 该 采取 措施 避免 由 
于 pg_upgrade 中 现在 修复 错误 可 能 的 数据 丢失 。 建 议 方法 是 在 所 有 TOAST 表 上 运 

{T VACUUM FREEZE o http://wiki.postgresql.org/wiki/20110408pg_upgrade fix 中 更 多 信息 可 
用 。 


另外 ， 如 果 你 从 8.4.2 更 早 版 本 更 新 ， 参 阅 8.4.2 的 发 布 说 明 。 


E.45.2. %14k 


。 修复 pg_upgrade 的 TOAST 表 处 理 (Bruce Momjian) 


TOAST 表 的 pg_class . relfrozenxid 值 不 能 被 正确 拷贝 到 pg_upgrade 中 的 新 安装 中 。 
当 它 们 仍然 需要 验证 TOAST 表 中 的 元 组 时 ， 这 可 能 会 导致 丢弃 pg_clog ， 导致 "无 法 访 
问 事务 状态 "错误 。 


闭 误 引起 使 用 pg_upgrade 更 新 的 安装 中 数据 丢失 的 显著 风险 。 该 补丁 校对 
po- iii E 误 ， 但 是 自身 并 不 能 解决 已 被 pg_upgrade 旧 版 本 处 理 的 安 
装 中 的 问题 。 


抑制 不 正确 的 "PD_ALL_VISIBLE 标 记 被 不 正确 地 设置 "警告 (Heikki Linnakangas) 
VACUUM 有 时 在 实际 有 效 的 情况 下 发 出 警告 。 
。 不 允许 完全 包含 复合 类 型 (Tom Lane) 


当 义 理 复合 类 型 的 时 候 ， 这 可 以 避免 服务 器 无 限 地 重 现 的 情况 。 虽 然 有 些 可 能 用 这 种 结 
构 ， 它 们 似乎 不 足以 证 明 可 以 确保 安全 工作 。 


。 避免 目录 缓存 初始 化 期 间 潜 在 死 锁 (Nikhil Sontakke) 


在 某 些 情况 下 ， 缓 存 加 载 代码 会 在 锁定 索引 的 目录 之 前 的 系统 索引 上 获取 共享 锁 。 这 可 
能 停顿 过 程 以 试图 获取 排他 锁 ， 采 用 更 多 的 标准 顺序 。 


当 有 一 个 并 发 更 新 到 目标 元 组 时 ， 修 复 BEFORE row UPDATE 触发 器 处 理 中 的 基 挂 指针 问题 
(Tom Lane) 


尝试 执行 UPDATE RETURNING ctid 的 时 候 ， 已 被 观察 到 的 这 个 错误 导致 间歇 性 "无 法 从 
虚拟 元 组 提取 系统 属性 "错误 。 对 于 更 严重 的 错误 有 一 个 非常 小 的 概率 ， 如 为 更 新 的 元 组 
产生 不 正确 的 索引 项 。 


当 有 表 的 等 待 延 迟 触 发 器 事件 时 ， 不 允许 DRoP TABLE (Tom Lane) 

以 前 crop 可 以 通过 ， 当 触发 器 最 终 被 唤起 时 ， 导致 "无 法 打开 OID nnn 关 系 "的 错误 。 
在 GEQO 优 化 期 间 ， 避 人 免 通 过 常量 错误 WHERE 条 件 触 发 衣 涡 (Tom Lane) 
提高 半 连 接 和 反 连 接 情况 中 规划 器 的 处 理 (Tom Lane) 

修复 解释 空 的 原因 的 文本 搜索 的 选择 性 估计 (Jesper Krogh) 

是 高 处 理 已 删除 列 行 类 型 的 PL/pgSQL 的 能 力 (Pavel Stehule) 

这 是 在 9.0 之 前 修复 后 补丁 。 

修复 涉及 到 数组 片段 的 PL/Python 内 存 泄 露 (Daniel Popowich) 

修复 pg_restore 人 处 理 TOC 文 件 中 长 线 (超过 1KB) (Tom Lane) 

采取 更 多 防御 措施 阻止 崩溃 ， 由 于 使 用 过 度 热 情 的 编译 器 优化 除 以 需 (Aurelien Jarno) 
支持 MIPS 上 FreeBSD 和 OpenBSD 中 dlopen() 的 使 用 (Tom Lane) 


有 一 个 硬 连 线 假设 ， 即 该 系统 函数 在 这 些 系 统 上 的 MIPS 硬 件 上 不 可 用 。 代 蔡 使 用 编译 测 
试 ， 因为 最 新 版 本 中 存在 。 


修复 HP-UX 上 编译 失败 (Heikki Linnakangas) 

解决 Windows 上 与 libintl 版 本 不 兼容 问题 (Hiroshi Inoue) 

修复 Windows 编 译 脚 本 中 xcopy 的 使 用 以 便 在 Windows 7 中 正常 工作 (Andrew Dunstan) 
这 只 影响 到 编译 脚本 ， 没 有 安装 或 者 使 用 。 

修复 Cygwin 上 的 pg_regress 使 用 的 路 径 分 隔 符 (Andrew Dunstan) 


为 了 Chile, Cuba, Falkland Islands, Morocco, Samoa, 和 Turkey 中 DST 变 化 规律 更 新 时 区 
数据 文件 到 tzdata 发 布 2011f ; 同时 为 South Australia, Alaska 和 Hawaii 进 行 历史 修正 。 


E.46. & 18.4.7 


发 布 日 期 : 2011-01-31 


该 发 布 包含 8.4.6 各 种 修复 。 关 于 8.4 主 要 发 布 的 新 功能 的 各 种 信息 ， 2y Section E.53。 


E.46.1. 迁移 到 版 本 8.4.7 


运行 8.4.X 不 需要 各 份 /恢复 。 然 而 ， 如 果 你 从 8.4.2 更 早 版 本 更 新 ， 参阅 8.4.2 的 发 布 说 明 。 


E.46.2. %14k 


e 当 EXPLAIN 尝试 显示 简单 形式 case 表达 式 时 ， 避免 错误 (Tom Lane) 


如 果 case 的 测试 表达 式 是 常量 ， 规 划 器 可 以 简化 case 到 困惑 表达 式 显示 代码 形式 ， 
导致 "不 希望 的 CASE WHEN 子 句 "错误 。 


。 修复 分 配给 下 标的 现 有 范围 的 数组 片段 (Tom Lane) 


如 果 在 新 添加 的 下 标 和 最 早 预先 存在 的 下 标 之 间 存 在 差距 ， 该 代码 误 算 了 许多 需要 从 旧 


的 数组 无 效 的 位 图 拷贝 的 项 ， 可 能 导致 数据 损坏 或 骨 溃 。 


在 规划 非常 远 的 日 期 值 时 避免 意外 转换 浴 出 (Tom Lane) 


date 类 型 支持 比 通过 timestam 类 型 表示 的 更 广泛 日 期 ， 但 是 规划 器 假设 它 完 全 可 以 将 


日 期 转换 为 timestamp。 


e 当 standard_conforming_strings 是 on 时 ， 为 大 对 象 (BLOBs) 修 复 pg_restore 的 文本 输出 


(Tom Lane) 


虽然 直接 存储 到 数据 库 正 常 工 作 ， 如 果 pg_restore 要 求 SQL 文 本 输出 并 
且 standard_conforming_strings 在 源 数据 库 中 BRA, 字符 串 逃 逸 是 不 正确 的 。 


修复 包含 ...& !(subexpression) | ... 的 tsquery 值 的 错误 解析 (Tom Lane) 


包含 操作 符 这 种 组 合 的 查询 不 能 正确 被 执行 。 同 样 的 错误 存在 
于 contrib/intarray 的 query_int 类 型 和 contrib/ltree 的 ltxtquery 类 型 中 。 


e 修复 query_int 类 型 的 contrib/intarray 的 输入 画 数 中 的 缓冲 区 浴 出 (Apple) 


这 个 错误 是 一 个 安全 风险 ， 因 为 该 男 数 的 返回 地 址 可 以 被 覆盖 。 感谢 Apple Inc 的 安全 团 


队 报 告 这 个 问题 并 且 提 供 修复 (CVE-2010-4015) 


。 修复 contrib/seg 的 GiST picksplit 算 法 中 的 错误 (Alexander Korotkov) 


这 可 能 导致 相当 大 的 无 效率 ， 虽 然 在 seg 列 上 的 GiST 索 引 中 不 是 真 的 错误 答案 。 如 果 你 
有 这 样 一 个 索引 ， 可 以 在 安装 这 个 更 新 之 后 考虑 下 REINDEX 它 。 (这 与 以 前 更 新 
中 contrib/cube 中 被 修复 的 错误 是 相同 的 ) 。 


E.47. & 78.4.6 


发 布 日 期 : 2010-12-16 


该 发 布 包含 8.4.5 的 各 种 修复 。 关于 8.4 主 要 发 布 的 新 功能 的 信息 ， 参阅 Section E.53。 


E.47.1. 迁移 到 版 本 8.4.6 


运行 8.4.X 不 需要 备份 /恢复 。 然而 ， 如 果 你 从 8.4.2 更 早 版 本 更 新 ， 参阅 8.4.2 发 布 说 明 。 


E.47.2. 变化 


e mA wal sync method 为 Linux 上 fdatasync (Tom Lane, Marti Raudsepp) 


Linux 上 缺 省 实际 上 是 多 年 的 fdatasync ， 但 是 最 近 内 核 变 化 导致 PostgreSQL 选 
择 open_datasync o 这 种 选择 在 任何 性 能 改进 中 不 产生 结果 ， 并 且 导 致 某 些 文件 系统 的 
彻底 失败 ， 尤其 是 带 有 data=journal 挂 载 选项 的 ext4 o 


e (ES GINS 5|WAL GI 44-48 XH ik (Tom Lane) 

这 可 能 导致 " 坏 缓冲 区 id: "AM 或 者 复制 过 程 中 索引 内 容 的 损坏 。 
e 当 开 局 检查 点 WAL 记 录 不 在 同一 WAL 段 作为 重 做 点 时 ， 修复 基础 各 份 恢复 (Jeff Davis) 
e 当 多 个 执行 者 保持 活跃 很 长 时 间 的 时 候 ， 修 复 autovacuum 的 持续 放 缓 (Tom Lane) 


为 autovacuum 工 作者 有 效 的 vacuum_cost_limit 可 能 下 降 到 几乎 为 需 ， 如 果 它 义理 足够 
多 的 表 ， 使 其 运行 极其 缓慢 。 


。 添加 支持 ITA64 上 的 检测 寄存 器 栈 浴 出 (Tom Lane) 

IA64 结构 有 两 个 硬件 堆栈 。 堆 栈 浴 出 错误 的 充分 预防 需要 检查 这 两 个 。 
e 添加 copyobject() PRAHA £ (Tom Lane) 

RE SIRE RE SAR, ASHE Re AET- DERE RhE I, 
e 修复 临时 GiST 索 引 中 页 分 离 的 检测 (Heikki Linnakangas) 


当 执 行 插入 时 ， 如 果 比 如 有 一 个 打开 游标 扫描 索引 的 时 候 ， 在 临时 索引 中 可 能 有 "并 
发 "的 页 面 分 离 。 当 继续 执行 游标 时 ， GiST 未 能 检测 到 这 种 情况 ， 因 此 可 以 提供 错误 结 
果 。 


。 在 早期 连接 你 理 过 程 中 修复 错误 检查 (Tom Lane) 


在 一 些 情况 下 忽略 太 多 子 进程 检查 ， 当 尝试 添加 新 的 子 进 程 到 固定 大 小 数组 中 时 ， 可 能 
导致 postmaster 骨 溃 。 


提升 window 画 数 的 效率 (Tom Lane) 


某 些 情况 中 大 量 元 组 需要 提前 被 读 取 ， 但 是 work mem 大 到 足以 允许 它们 全 部 保存 在 内 存 


中 ， 况 意外 地 慢 。 percent_rank() , cume_dist() 和 ntile() 尤其 受到 这 个 问题 的 影响 。 
当 ANALYZE 复杂 索引 表达 式 的 时 候 ， 避 免 内 存 泄露 (Tom Lane) 

确保 使 用 整 行 Var 的 索引 依赖 于 它 的 表 (Tom Lane) 

当 删 除 表 的 时 候 ， 像 create index i on t (foo(t.*)) 声明 的 索引 可 能 不 会 自动 被 删除 。 
不 要 "内 联 "SQL 画 数 与 多 个 our 参数 (Tom Lane) 

由 于 关于 预期 结果 rowtype 信 息 丢 失 ， 这 避免 了 可 能 的 骨 省 。 


如 果 ORDER BY , LIMIT , FOR UPDATE , Or WITH 附属 于 INSERT ... VALUES 的 vALuEs 部 
分 ， 那 么 操作 正确 (Tom Lane) 


修复 coacesce() 表达 式 的 常数 合并 (Tom Lane) 
规划 器 有 时 会 试图 评估 事实 上 不 可 能 达到 的 可 能 会 导致 意外 错误 的 子 表达 式 。 


当 连 接 接受 失败 时 (accept) 或 者 在 它 之 后 立即 调用 ) ， 并 且 postmaster 和 GSSAPI 支 
持 一 起 编译 ， 修复 postmaster 崩 溃 。(Alexander Chernikov) 


当 log_temp_files 是 活路 的 ， 则 修复 临时 文件 忽略 的 取消 操作 (Tom Lane) 

当 试 图 发 出 日 志 信息 时 ， 如 果 发 生 错 误 ， 那 么 取消 不 执行 ， 导致 临时 文件 积累 。 

为 InhRelation 节点 添加 输出 功能 (Tom Lane) 

当 启 用 debug_print_parse 并 且 执 行 某 些 类 型 查询 时 ， 这 避免 失败 。 

修复 从 一 个 点 到 水 平 线段 距离 的 错误 计算 (Tom Lane) 

这 个 漏洞 影响 了 若干 个 不 同 的 几何 距离 测量 操作 符 。 

修复 ecpg 中 事务 状态 的 错误 计算 (ltagaki Takahiro) 

在 递 为 或 者 错误 恢复 的 情况 中 修复 "simple" 表 达 式 的 PL/pgSQL 你 理 而 不 失败 (Tom Lane) 
修复 设置 返回 画 数 的 PL/Python 的 处 理 (Jan Urbanski) 

在 迭代 器 生成 一 组 结果 中 尝试 调用 SPI 范 数 可 能 失败 。 


修复 contrib/cube 的 GiST picksplit 算 法 中 的 错误 (Alexander Korotkov) 


这 可 能 会 导致 相当 大 的 无 效率 ， 但 在 cube 列 上 的 GiST 索 引 中 ， 并 不 是 真 的 错误 结论 ， 
如 果 你 有 这 样 一 个 索引 ， 考 虑 在 安装 这 个 更 新 之 后 REINDEX 它 。 


不 要 发 出 contrib/dblink 中 "标识 符 将 被 截断 "的 信息 除了 创建 新 的 连接 (ltagaki Takahiro) 
修复 contrib/pgcrypto 中 对 失踪 公 钥 的 潜在 信息 转 储 (Marti Raudsepp) 
修复 contrib/xm12 的 XPath 查询 函数 中 的 内 存 泄露 (Tom Lane) 


为 Fii 和 Samoa 中 的 DST 变 化 规律 更 新 时 区 数据 文件 到 tzdata 发 布 2010o ; 也 为 了 香港 万 
史 修 正 。 


E.48. 发 布 8.4.5 


发 布 日 期 : 2010-10-04 


该 发 布 包含 来 自 8.4.4 中 的 各 种 修复 。 关于 8.4 主 要 版 本 的 新 功能 的 各 种 信息 ， 参 阅 Section 
E.53. 


E.48.1. 迁移 到 版 本 8.4.5 


运行 8.4.X 不 需要 各 份 /恢复 。 然 而 ， 如 果 你 从 8.4.2 的 早期 版 本 升级 ， 参阅 8.4.2 的 发 布 说 明 。 


E.48.2. %14k 


e 为 每 个 调用 PL/Perl/ 和 PL/Tcl 中 SQL userid 使 用 独立 解释 器 (Tom Lane) 


这 种 变化 可 以 防止 通过 凑 覆 随后 在 同一 会 话 中 另 一 个 SQL 用 户 身份 下 执行 的 Perl 或 Tcl 代 
码 造成 的 安全 问题 (例如 ， 在 sEcuRITY DEFINER WAH), 大 多 数 的 脚本 语言 提供 了 可 
以 执行 的 众多 方法 ， 如 重新 定义 标准 本 数 或 目标 函数 运算 符 。 没 有 这 种 变化 的 话 ， 任 何 
拥有 Perl 或 Tcl 语 言 使 用 权 的 SQL 用 户 可 以 执行 拥有 目标 画 数 所 有 者 的 SQL 权限 应 该 做 的 
事情 。 


这 种 变化 的 成 本 是 在 Perl 和 Tcl 函 数 之 间 沟 通 意图 变 得 更 加 困难 。 为 了 提供 一 个 逃生 出 
口 ，PL/PerlU 和 PL/TcIU 琅 数 继 续 每 个 会 话 中 仅仅 使 用 一 个 解释 器 。 这 没有 考虑 安全 问 
题 ， 因 为 在 数据 库 超 级 用 户 的 信任 级 别 上 执行 所 有 这 些 函 数 。 


可 能 声称 提供 可 信 执 行程 序 的 第 三 方程 序 语 言 有 类 似 的 安全 问题 。 我 们 建议 你 依赖 安全 
关键 用 途 联 系 任何 PL 的 作者 。 


我 们 应 该 感谢 Tim Bunce 提 出 这 个 问题 (CVE-2010-3433)。 


e 防止 pg_get_expr() 中 可 能 的 事故 ， 通过 禁止 适合 与 不 是 一 个 系统 目录 列 之 一 的 参数 一 
起 使 用 。(Heikki Linnakangas, Tom Lane) 


o 义理 退出 代码 128( ERROR_WAIT_NO_CHILDREN ) 作 为 Windows 上 非 致命 的 (Magnus 
Hagander) 


在 高 负荷 的 情况 下 ，Windows 进 程 在 使 用 错误 码 启 动 过 程 失败 。 之 前 postmaster 把 这 个 
看 作 恐 慌 条 件 并 且 重 新 启动 整个 数据 库 ， 但 这 似乎 是 反应 过 度 。 


。 修复 占 位 符 赋 值 不 正确 位 置 (Tom Lane) 


当 它 们 本 应 是 空 的 时 候 ， 这 个 错误 可 能 导致 查询 输出 非 空 。 在 该 情况 下 ， 输 出 列表 非 严 
格 的 表达 式 下 外 部 连接 的 内 部 是 一 个 子 选择 。 


修复 unon ALL 成 员 关 系 可 能 的 重复 打 描 (Tom Lane) 

修复 "不 能 处 理 非 计 划 子 查询 "错误 (Tom Lane) 

当 包 含 连接 别名 参考 的 子 查询 扩展 到 含有 另 一 个 子 选择 的 表达 式 中 时 ， 发 生 这 种 情况 。 
修复 引用 视图 或 出 现在 谋 套 子 查询 中 的 子 选择 的 整 列 变 量 的 不 当 处 理 (Tom Lane) 
修复 交叉 类 型 IN 比较 的 处 理 不 当 (Tom Lane) 

如 果 规 划 器 试图 实现 使 用 分 类 然后 唯一 的 完全 连接 计划 的 IN 连接 。 

修复 统计 tsvector 列 的 ANALYzE 的 计算 (Jan Urbanski) 

最 初代 码 可 以 产生 不 正确 统计 ， 导 致 之 后 错误 规划 选择 。 


优化 通过 array_agg() ， string_agg() 和 类 似 聚合 函 数 使 用 的 内 存 的 规划 器 估计 (Hitoshi 
Harada) 


以 往 过 低估 计 可 以 导致 内 存 不 足 错误 ， 由 于 哈 希 聚集 规划 不 恰当 的 选择 。 
修复 标记 缓存 计划 是 短暂 的 错误 (Tom Lane) 


当 CREATE INDEX CONCURRENTLY 在 进展 中 作为 一 个 参考 表 ， 如 果 已 准备 好 一 个 规划 ， 一 旦 
索引 是 现成 的 ， 它 应 该 重新 被 规划 。 这 是 不 会 发 生 的 。 


在 一 些 偶然 报道 btree 失 败 的 案例 中 减少 PANIC 到 ERROR， 并 提供 产生 错误 信息 中 的 额 
外 的 细节 。 


这 可 以 优化 使 用 错误 索引 的 系统 的 鲁 棒 性 。 
修复 GIN 索 引 部 分 匹配 查询 的 错误 搜索 逻辑 (Tom Lane) 


涉及 一 些 GIN 索 引 条 件 的 AND/OR 组 合 情 况 不 总 是 给 出 正确 答案 ， 有 时 候 比 必要 情况 慢 
的 多 。 


防止 autovacuum 进 程 中 show_session_authorization() 的 崩溃 (Tom Lane) 

并 不 是 所 有 返回 行 都 是 同一 rowtype 的 地 方 防范 琅 数 返回 集合 记录 (Tom Lane) 
修复 在 子 事务 回 滚 期 间 待定 触发 器 事件 列表 的 可 能 损坏 (Tom Lane) 

这 可 能 导致 崩溃 或 者 错误 触发 触发 器 。 

当 散 列 按 引用 传递 本 数 结果 时 ， 修 复 可 能 错误 (Tao Ma, Tom Lane) 


优化 join 列 中 NULL 的 合并 连接 处 理 (Tom Lane) 


如 果 排 序 顺 序 是 NULL 排 序 高 ， 那 么 合并 连接 可 以 完全 停止 到 达 第 一 个 NULL。 
当 写 入 它们 时 ， 注 意 fsync 锁 文件 内 容 ( postmaster.pid 和 socket 锁 文件 ) (Tom Lane) 


如 果 在 postmaster 和 启动 之 后 不 久 该 机 器 崩溃 ， 那 么 该 忽略 可 能 导致 损坏 的 锁 文 件 内 容 。 
反 过 来 又 可 以 防止 后 续 党 斌 启动 postmaster， 直 到 手动 删除 锁定 文件 。 


44) 8CXID2S = BREF SAM, 14% Ja(Andres Freund, Robert Haas) 

如 果 有 有 限 的 堆栈 空间 ， 初 始 编码 可 能 导致 崩溃 。 

避免 在 walwriter 过 程 中 保持 开放 旧 的 WAL 段 (Magnus Hagander, Heikki Linnakangas) 
先前 编码 可 以 防止 删除 不 再 需要 部 分 。 

修复 1og_line_prefix 's %i 逃逸 ， 这 在 后 台 和 启动 早期 时 会 产生 垃圾 (Tom Lane) 

避免 为 TOAST 表 部 分 指定 的 关系 选项 的 曲解 (ltagaki Takahiro) 


特别 是 ， fillfactor RRAS, 如 果 任 何其 他 reloption 已 经 为 该 表 设 置 ， 导 致 严重 的 
膨胀 。 


修复 ALTER TABLE ... ADD CONSTRAINT 中 继承 计数 跟踪 (Robert Haas) 
x g Ajat, S ALTER TABLE ... SET TABLESPACE 中 可 能 的 数据 损坏 (Jeff Davis) 


人 允许 CREATE DATABASE 和 ALTER DATABASE ... SET TABLESPACE 被 查询 取消 中 断 (Guillaume 


Lelarge) 

改善 CREATE INDEX 对 被 推荐 索引 表达 式 是 否 可 以 改变 的 检测 (Tom Lane) 

修复 REASSIGN owNED 以 处 理 算 子 类 和 族 (Asko Tiidumaa) 

当 比 较 两 个 空 的 tsquery 值 的 时 候 ， 修 复 可 能 的 核心 转 储 (Tom Lane) 

修复 模式 中 包含 % 伴随 _ 的 LIKE 的 处 理 (Tom Lane) 

我 们 之 前 已 经 修复 ， 但 是 仍 存 在 一 些 不 正确 处 理 的 情况 。 

重新 允许 Julian 日 期 输入 追溯 到 0001-01-01 AD (Tom Lane) 

在 8.4 之 前 输入 比如 '3100000'::date ， 但 是 通过 添加 的 错误 检查 无 意 打 破 。 

如 果 在 逼 历 游标 的 ror 循环 中 关闭 游标 ， 修 复 PL/pgSQL 抛 出 一 个 错误 ， 不 会 崩溃 。 


在 PL/Python 中 ， 抵 御 来 自 Pycobject_AsvoidPtr 和 pycobject_Fromvoidptr 的 空 指针 结果 
(Peter Eisentraut) 


在 libpq 中 ， 当 指定 host 和 hostaddr 的 时 候 ， 修 复 完整 SSL 证 书 验 证 。 


使 得 psql 将 prscARD ALL 看 做 在 自动 提交 关闭 模式 中 不 应 该 封装 在 事务 块 中 的 命令 
(Itagaki Takahiro) 


修复 SQL/MED 对 象 pg_dump 的 义理 中 的 一 些 问题 (Tom Lane) 

值得 注意 的 是 ， 如 果 通 过 非 超 级 用 户 执行 ，pg_dump 总 是 失败 ， 它 并 不 打算 这 样 。 
优化 非 可 查找 为 档 文 件 的 pg_dump 和 pg_restore 的 处 理 (Tom Lane, Robert Haas) 
对 于 并 行 转 储 的 正常 运作 很 重要 。 

提高 并 行 pg_restore 处 理 选择 性 转 储 ( -L option) 的 能 力 (Tom Lane) 

如 果 -L 文件 命令 非 缺 省 转 储 顺 序 ， 那 么 原 代 码 可 能 失败 。 

修复 ecpg 正 确 义 理 来 自 RETURNING 子 句 的 数据 (Michael Meskes) 

修复 ecpg 中 的 一 些 内 存 泄 露 (Zoltan Boszormenyi) 

优化 包含 已 删除 列 的 表 的 contrib/dblink 的 义理 (Tom Lane) 

修复 contrib/dblink 中 "重复 连接 名 "错误 之 后 的 连接 泄露 (ltagaki Takahiro) 

修复 contrib/dblink 以 正确 处 理 超过 62 字 节 的 连接 名 (ltagaki Takahiro) 

添加 hstore(text，text) KIE] contrib/hstore (Robert Haas) 


AREA ST EMER zegt; 操作 符 的 推荐 替代 者 。 它 后 面 打 补丁 ， 以 便 适 应 未 来 
代码 可 用 于 旧 的 服务 器 版 本 。 请 注意 ， 该 补丁 仅仅 在 安装 contrib/hstore 或 重新 安装 在 
一 个 特定 的 数据 库 中 有 效 。 用 户 可 能 更 愿意 手动 执行 CREATE FUNCTION 命令 来 代替 。 


更 新 基础 设施 建设 和 文档 以 反映 来 自 CVS 到 Git 的 源 代 码 存 储 库 的 移动 (Magnus Hagander 


and others) 


为 了 Egypt 和 Palestine 中 DST 变 化 规律 更 新 时 区 数据 文件 到 tzdata 发 布 2010| ; 也 是 出 于 
Finland 的 历史 修正 。 


这 种 变化 还 为 两 个 Micronesian 时 区 添加 了 新 的 名 字 : Pacific/Chuuk 目 前 优 于 
Pacific/Truk (并 且 首 选 缩写 是 CHUT 而 不 是 TRUT) 并 且 Pacific/Pohnpei 优 于 
Pacific/Ponape. 


使 得 Windows 的 "N. Central Asia Standard Time" 时 区 映射 到 Asia/Novosibirsk， 而 不 是 
Asia/Almaty (Magnus Hagander) 


Microsoft 改 变 来 自 KB976098 的 时 区 更 新 中 的 该 区 域 的 DST 操 作 。 Asia/Novosibirskz xt 
于 新 操作 的 更 好 匹配 。 


E.49. £ 78.4.4 


发 布 日 期 : 2010-05-17 


该 发 布 包含 来 自 8.4.3 的 各 种 修复 。 关 于 8.4 主 要 版 本 中 的 新 特性 的 信息 ， iB Section 
E.53. 


E.49.1. 迁移 到 版 本 8.4.4 


运行 8.4.X 不 需要 各 份 /恢复 。 然 而 ， 如 果 你 从 8.4.2 更 早 版 本 更 新 ， 参 阅 8.4.2 的 发 布 说 明 。 


E.49.2. 变化 


强制 plperl 中 使 用 opmask 限 制 应 用 于 整个 解释 器 ， 而 不 是 使 用 safe.pm (Tim Bunce, 
Andrew Dunstan) 


最 近 发 展 使 我 们 确信 safe.pm 太 不 安全 而 不 能 依靠 plperl 可 信赖 。 此 变化 删除 

了 safe.pm 的 使 用 ， 有 利于 使 用 应 用 于 操作 码 掩 码 的 一 个 单独 的 解析 器 。 该 变化 副作用 
包括 以 plperl 中 一 种 自然 的 方式 使 用 Perl 的 strict 编译 是 可 能 的 ， 并 且 Perl 

的 sa 和 sb 变量 按 预 期 以 排序 程序 执行 ， 而 且 该 函数 编译 显著 更 快 。 


阻止 PL/Tcl 执 行 来 自 pltcl_modules 的 不 信任 代码 (Tom) 


从 一 个 数据 库 表 中 自动 加 载 的 Tcl 代 码 的 PL/TcI 的 功能 可 以 为 了 特洛伊 木马 攻击 被 开发 ， 
因为 对 谁 可 以 创建 或 插入 该 表 是 没有 限制 的 。 这 种 变化 禁用 该 功能 ， 除 

非 pltcl modules 是 由 超级 用 户 拥 有 。 (然而 ， 不 检查 该 表 上 的 权限 ， 所 以 真正 需要 低 
于 安全 模块 表 中 的 安装 仍然 可 以 授予 适当 的 权限 给 值得 信赖 的 非 超级 用 户 ) 。 另外 ， 防 
止 加 载 代码 到 非 限制 "normal" Tcl 解 释 器 ， 除 非 我 们 真 的 要 执行 pltclu WR, 


修复 ALTER ... SET TABLESPACE 的 WAL 回 放 期 间 的 数据 损坏 (Tom) 


当 archive_mode 是 ON 时 ， ALTER ... SET TABLESPACE 生成 WAL 记 录 ， 其 中 回放 逻辑 是 不 
正确 的 。 它 可 以 将 数据 写 入 错误 的 地 方 ， 从 而 导致 可 能 的 不 可 恢复 的 数据 损坏 。 如 果 在 
提交 ALTER 之 后 和 下 一 个 检查 点 之 前 发 生 数 据 库 崩 溃 和 恢复 ， 数据 损坏 在 各 库 上 随时 被 
观察 ， 并 且 可 能 在 主 库 上 发 生 。?3???? 


如 果 在 relcache 项 重建 期 间 收 到 缓存 复位 信息 ， 那 么 修复 可 能 月 涡 (Heikki) 
当 修 复 相关 错误 的 时 候 ， 在 8.4.3 中 介绍 这 些 错误 。 


当 为 了 该 加 数 运行 语言 验证 器 的 时 候 ， 频 用 每 个 玉 数 GUC 设 置 (ltagaki Takahiro) 


RRS Am, MRAKA BRAKE, 一 个 例子 是 ， 如 
R search_path 不 正确 ， SQL 西数 可 能 不 被 解析 。 


当 constraint_exclusion = partition 的 时 候 ， 为 继承 uppATE 和 DELETE 目标 表 执 行 约 


束 排除 (Tom) 
AFRA, Bik ERNER REPRE sELEcT 命令 中 被 检查 。 
不 允许 未 经 授权 的 用 户 重 置 超级 用 户 唯 一 的 参数 设置 (Alvaro) 


以 前 ， 如 果 一 个 非特 权 用 户 为 自身 运行 ALTER USER... RESET ALL, 或 为 所 拥有 的 数据 
库 运 行 ALTER DATABASE ... RESET ALL, 这 将 删除 用 户 或 数据 库 的 所 有 特殊 参数 设置 ， 
2222? 甚至 是 那些 只 应 该 由 超级 用 户 改 变 的 设置 。 现 在 ， ALTER 将 只 删除 该 用 户 有 权限 
改变 的 参数 。 


当 context 附加 物 为 日 志 项 时 ， 如 果 发 生 宕 机 ， 避 人 免 后 台 关 机 时 可 能 的 崩溃 (Tom) 


在 某 些 情况 中 上 下 文 输出 图 数 可 能 失败 ， 因 为 当 它 打 印 日 志 信 息 的 时 人 息 ， 当 前 事务 已 经 
回 滚 。 


修复 recovery_end_command 中 %r 参数 的 错误 处 理 (Heikki) 

该 值 总 是 需 。 

确保 为 档 进 程 尽 可 能 快 地 响应 archive_command 中 变化 (Tom) 

当 case 表 过 式 是 一 个 没有 返回 行 的 查询 时 ， 修 复 pl/pgsql 的 case 语句 而 不 失败 (Tom) 
更 新 pl/perl 的 ppport.h 为 现代 Perl 版 本 (Andrew) 

修复 pl/python 中 各 种 内 存 泄露 (Andreas Freund, Tom) 

正确 义理 ecpg 中 空 字符 串 连接 参数 (Michael) 

当 扩 展 引 用 自身 的 一 个 变量 时 ， 避 人 免 在 psql 中 的 无 限 递 妥 (Tom) 

修复 psql 的 \copy 而 在 \copy (select ...) 中 点 周围 不 添加 空格 (Tom) 

在 数值 文字 中 小 数 点 周围 的 空格 可 能 导致 语法 错误 。 

当 在 上 下 文 环境 中 运行 不 匹配 client_encoding 的 时 候 ， 避免 psql 中 格式 错误 (Tom) 


为 了 使 用 contrib/intarray 操作 符 的 不 满足 条 件 的 查询 ， 修复 不 必要 的 "GIN 素 引 不 支持 
全 局 素 引 扫描 "错误 (Tom) 


确保 contrib/pgstattuple KAUR & kat AYIA PET (Tatsuhito Kasahara) 


确保 服务 器 启动 正确 处 理 shmget() 为 已 存在 的 共享 内 存 段 返回 Erva (Tom) 


在 包括 OS X 中 的 BSD 衍 生 的 内 核 上 观察 这 种 操作 ， 这 导致 了 抱怨 共享 内 存 请 求 大 小 过 大 
的 完全 误导 启动 错误 。 


避免 Windows 上 syslogger 处 理 过 程 中 可 能 的 月 渍 (Heikki) 
更 有 力 地 人 处理 Windows 注 册 表 中 不 完整 的 时 区 信息 (Magnus) 
更 新 已 知 的 Windows 时 区 名 字 的 设置 (Magnus) 


为 了 Argentina, Australian Antarctic, Bangladesh, Mexico, Morocco, Pakistan, Palestine, 
Russia, Syria, Tunisia 中 DST 变 化 规律 更 新 时 区 数据 文件 到 tzdata 发 布 2010j。 同时 为 
Taiwan 历 史 修正 。 


另外 ， 添 加 PksT (Pakistan Summer Time) 到 时 区 缩写 的 缺 省 设置 中 。 


E.50. £ 78.4.3 


发 布 日 期 : 2010-03-15 


该 发 布 包含 了 来 自 8.4.2 的 各 种 修复 。 关 于 8.4 主 要 版 本 的 新 功能 信息 ， 参 阅 Section E.53。 


E.50.1. 迁移 到 版 本 8.4.3 


运行 8.4.X 不 需要 各 份 /恢复 。 然 而 ， 如 果 你 从 8.4.2 更 早 版 本 更 新 ， 参 阅 8.4.2 发 布 说 明 。 


E.50.2. 变化 
e。 添加 新 的 配置 参数 ssl_renegotiation_limit 用 来 控制 我 们 多 久 一 次 执行 会 话 秘 钥 重新 协 
商 SSL 连 接 (Magnus) 


这 可 以 被 设置 为 需 以 完全 禁用 重新 协商 ， 如 果 使 用 一 个 已 破碎 的 SSL 库 。 这 可 能 被 要 求 。 
特别 是 ， 一 些 供应 商 为 导致 重新 协商 党 试 失败 的 CVE-2009-3555 打 补丁 。 


。 修复 后 台 启 动 过 程 中 可 能 的 死 锁 (Tom) 

。 由 于 在 relcache 明 确 重 载 中 没有 处 理 错 误 ， 修 复 可 能 的 月 溃 (Tom) 

。 由 于 使 用 蚌 空 指针 到 缓存 计划 ， 修 复 可 能 崩溃 (Tatsuo) 

© 由 于 缓存 计划 RoLLBACK 的 严重 失效 ， 修 复 可 能 崩溃 (Tom) 

。 当 试 图 从 子 事务 启动 故障 恢复 时 ， 修 复 可 能 的 骨 溃 (Tom) 

。 修复 与 使 用 保存 点 和 来 自 服务 器 编码 不 同 的 客户 端 编码 有 关 的 服务 器 内 存 泄漏 (Tom) 
。 修正 GIST 素 引 页 拆 分 中 结束 恢复 清理 期 间 发 出 的 不 正确 WAL 数 据 (Yoichi Hirai) 


如 果 在 结束 恢复 清理 中 已 经 完成 了 一 个 不 完整 的 GIST 插 入 后 我 们 运气 不 好 而 发 生 崩 溃 。 
这 将 导致 索引 损坏 ， 甚 至 在 WAL 回 放 期 间 更 有 可 能 发 生 错误 。 


。 为 GIN 索 引 修复 WAL 重 做 清理 方法 中 的 错误 (Heikki) 
。 修复 GIN 素 引 搜 索 中 打 描 键 的 不 正确 比较 (Teodor) 
e 使 得 为 bit 类 型 的 substring() 将 任何 负 的 长 度 看 作 "所 有 剩余 字符 串 "(Tom) 


先前 代码 只 处 理 -1， 并 且 可 能 为 其 他 负 值 产生 无 效 结果 值 ， 可 能 导致 月 溃 (CVE-2010- 
0442)。 


当 输 出 比特 宽度 大 于 不 同 于 8 位 倍数 的 给 定 整 数 的 时 候 ， 修 复 整 数 到 比特 串 转换 用 来 正确 
地 处 理 第 一 个 分 数字 节 (Tom) 


修复 病理 上 阻碍 正则 表达 式 匹 配 的 一 些 情况 (Tom) 

当 尝 试 内 联 返回 一 组 包含 已 删除 列 的 复合 类 型 的 SQL 画 数 的 时 候 ， 修 复 产生 的 错误 (Tom) 
修复 试图 更 新 复合 类 型 数组 列 元 素 字段 中 的 错误 (Tom) 

当 EXPLAIN 必须 打印 FieldStore 或 者 分 配 ArrayRef 表 达 式 的 时 候 ， 避免 错误 (Tom) 

这 种 情况 已 经 出 现 EXPLAIN VERBOSE 试图 输出 计划 节点 目标 列 。 


在 未 修饰 字符 串 出 现在 UNION / INTERSECT / EXCEPT 子 查询 中 的 情况 中 ， 避免 不 必要 强制 


41% (Tom) 
修复 8.4 之 前 执行 情况 中 的 回 为 分 析 。 


在 整 行 Var 中 有 包含 已 删除 列 的 rowtype 的 地 方 ， 避 免 不 符 合 要 求 的 rowtype 兼 容 检查 错误 
(Tom) 


当 最 后 位 置 正 好 在 一 段 边 界 时 ， 修 复 备 份 历史 文件 中 的 stop wat Location MLA 报告 下 一 
个 WAL 段 的 名 称 (ltagaki Takahiro) 


总 是 将 系统 目录 ID 传递 给 CREATE FOREIGN DATA WRAPPER 中 指定 的 选项 验证 图 数 (Martin 
Pihlak) 


修复 临时 文件 泄露 的 一 些 情 况 (Heikki) 


这 纠正 了 以 前 次 要 版 本 引入 的 问题 。 一 种 失败 情况 是 : 当 在 另 一 个 函数 的 异常 处 理 程序 
中 调用 plpgsql 辑 数 返 回 集 。 


添加 支持 执行 FULL JOIN ON FALSE (Tom) 


这 可 以 防止 来 自 8.4 之 前 发 布 的 一 些 查 询 的 回 轨 ， 该 查询 现在 可 以 简化 为 一 个 恒定 的 错误 
连接 条 件 。 


优化 布尔 变量 情况 下 约束 排除 处 理 ， 特别 是 有 可 能 排除 一 个 有 "bool_column = false" 约束 
的 分 区 (Tom) 


防止 将 INouT 映射 看 作 表 示 二 进 制 兼容 (Heikki) 
当 和 警告 不 能 授权 或 者 撤销 列 级 别 权 限 的 时 候 ， 包 含 该 消息 的 字段 名 (Stephen Frost) 


当 revoke 产生 多 条 消息 时 ， 这 个 原先 似乎 是 复制 品 ， 这 比 起 以 前 来 是 非常 有 用 的 ， 并 且 
避免 混淆 。 


当 读 取 pg_hba.conf 和 相关 文件 的 时 候 ， 如 果 @ 似乎 出 现在 引号 内 ， 不 要 
将 @something 看 作文 件 包含 请 求 ， 另 外 ， 也 不 要 将 @ 自身 看 作文 件 包含 请 求 (Tom) 


如 果 角 色 或 数据 库 的 名 字 以 @ 开头 ， 这 可 以 防止 不 稳定 操作 。 如 果 你 需要 包含 路 径 名 含 
有 空格 的 文件 ， 那 么 你 仍然 可 以 这 样 做 ， 但 是 你 必须 写 @"/patn to/file" 而 不 是 把 引号 
放 入 整个 构造 中 。 


如 果 目 录 被 命名 为 pg_hba.conf 中 和 相关 文件 的 包含 目标 ， 则 防止 在 一 些 平台 上 的 无 限 
循环 (Tom) 


如 果 没 有 设置 errno 时 sst_read 或 者 sst_write Km, 修复 可 能 无 限 循环 (Tom) 
据说 这 个 可 能 使 用 openssl 的 一 些 Windows 版 本 。 

不 允许 本 地 连接 中 GSSAPI 认 证 ， 因 为 它 需 要 hostname 以 正常 工作 (Magnus) 
保护 ecpg 应 用 意外 地 释放 字符 串 (Michael) 

如 果 连 接 断 开 ， 使 得 ecpg 报 告 合适 SQLSTATE(Michael) 

修复 psql \d 输出 中 单元 格 内 容 的 翻译 (Heikki) 


修复 psq| 的 numericlocale 选项 而 不 能 格式 化 字符 串 ， 它 不 属于 latex 和 troff 输 出 格式 
(Heikki) 


修复 psql 中 小 的 每 个 查询 内 存 泄露 (Tom) 


当 指 定 ON_ERROR_STOP 和 --single-transaction 的 时 候 ， 并 且 RS commit 期 间 发 生 错 
误 时 ， 使 得 psql 返 回 正确 退出 状态 (3)(Bruce) 


修复 外 部 服务 器 权限 的 pg_dump 的 输出 (Heikki) 

由 于 洽 出 依赖 性 ID， 在 平行 pg_restore 中 修复 可 能 崩溃 (Tom) 

在 复合 列 设置 为 空 的 情况 下 ， 修 复 plpgsql 错 误 (Tom) 

当 从 PL/PerlU 中 调用 PL/Perl 函 数 的 时 候 ， 修 复 可 能 失败 ， 反 之 亦 然 (Tim Bunce) 

在 PL/Python 中 添加 volatile 标记 以 避免 可 能 具体 编译 器 操作 不 当 (Zdenek Kotala) 
确保 PL/Tcl 完 全 初始 化 Tel 解释 器 (Tom) 

这 种 监督 的 唯一 已 知 现象 是 如 果 使 用 Tcl 8.5 或 者 更 高 版 本 ， 则 Tcl clock 命令 行为 不 当 。 
避免 在 失败 事务 或 者 子 事务 中 创建 人口 运行 ExecutorEnd (Tom) 

当 使 用 contrib/auto_explain 的 时 候 ， 这 是 已 知 错误 。 


当 许多 关键 列 被 指定 为 dblink_build_sql_* Mëtt, BALE contrib/dblink 崩溃 (Rushabh 
Lathia, Joe Conway) 


人 允许 contrib/itree 操作 中 需 维 数组 (Tom) 


这 种 情况 佛经 被 认为 一 个 错误 ， 但 它 更 方便 将 它 看 作 需 元 素数 组 。 当 1ltree 操作 应 用 
于 ARRAY(SELECT ...) 结果 和 没有 返回 行 的 子 查询 的 时 候 ， 特 别 是 这 可 以 避免 不 必要 的 故 
障 。 


修复 通过 内 存 管理 造成 的 contrib/xm12 中 各 种 崩溃 (Tom) 

使 得 contrib/xml2 编译 在 Windows 上 更 加 具有 重 棒 性 (Andrew) 

修复 Windows 上 信号 处 理 竞 争 条 件 (Radu llie) 

这 个 错误 已 知 现象 是 在 pg_listener 中 的 行 可 以 在 重负 载 下 被 删除 。 

如 果 C 编 译 器 不 提供 64 位 整数 数据 类 型 ， 使 得 配置 脚本 报告 错误 (Tom) 
这 种 情况 一 段 时 间 已 经 被 打 断 ， 不 再 值得 支持 ， 因 此 在 配置 时 间 拒 绝 它 。 


为 了 Bangladesh，Chile，Fiji， Mexico，Paraguay，Samoa 中 DST 变 化 规律 更 新 时 区 
数据 文件 到 tzdata 发 布 2010e。 


E.51. 发 布 8.4.2 


发 布 日 期 : 2009-12-14 


该 发 布 包含 来 自 8.4.1 的 各 种 修复 。 关 于 8.4 主 要 发 布 中 的 新 特性 信息 ， 参阅 Section E.53。 


E.51.1. 迁移 到 版 本 8.4.2 


运行 8.4.X 不 需要 各 份 /恢复 。 然 而 ， 如 果 有 任何 散 列 索 引 ， 在 更 新 到 8.4.2 之 后 你 应 该 


REINDEX 它们 ， 以 修复 可 能 受 损 。 


E.51.2. %14k 


。 防止 通过 索引 画 数 改变 会 话 局 部 状态 引起 的 间接 安全 威胁 (Gurjieet Singh, Tom) 
一 变化 防止 不 变 的 索引 郴 数 打 断 超级 用 户 会 话 (CVE-2009-4136)。 


。 拒绝 在 普通 名 字 (CN) 字段 中 包含 戏 入 的 空 字 节 的 SSL 证 书 (Magnus) 


这 避免 在 SSL 认 证 期 间 来 自 服务 器 或 者 客户 端 名 宇 的 证 书 的 意外 匹配 (CVE-2009-4034)。 


。 修复 散 列 索引 损坏 (Tom) 


该 8.4 变 化 使 得 散 列 索引 保持 通过 散 列 值 未 能 更 新 大 量 分 裂 和 紧缩 程序 以 保持 排序 的 项 。 
所 以 这 些 操作 的 任何 应 用 程序 可 能 导致 索引 的 永久 性 损坏 ， 在 这 个 意义 上 ， 搜索 可 能 无 


法 找到 存在 的 项 。 为 了 义理 这 个 ， 推 荐 你 已 安装 此 更 新 后 REINDEX 任何 散 列 索引 。 
。 修复 后 台 和 启动 时 缓存 初始 化 期 间 可 能 崩溃 (Tom) 


避免 空 的 同义词 词典 崩溃 (Tom) 


避免 在 不 安全 时 间 中 断 vacuum 信号 (Alvaro) 


如 果 已 经 坚定 元 组 动作 之 后 取消 了 vacuum FULL ， 该 修复 阻止 PANIC。 如 果 在 截断 该 表 


之 后 中 断 普 通 的 vacuum ， 阻 止 瞬 态 错误 。? 
由 于 在 哈 希 表 大 小 计算 中 整数 浴 出 ， 修 复 可 能 崩溃 (Tom) 
文 可 能 发 生 大 的 规划 器 评估 哈 希 连 接 结果 。 


如 果 在 内 部 依赖 对 象 上 党 试 DRop , 16S ARR (Tom) 


修复 inet / cidr 上 比较 中 稀少 崩溃 现象 (Chris Mikkelson) 


。 确保 不 忽略 通过 预 各 事务 持 有 的 共享 元 组 级 别 锁 (Heikki) 


修复 用 于 在 子 事务 中 访问 的 游标 临时 文件 的 提早 删除 (Heikki) 

当 旋 转 到 新 的 CSV 日 志文 件 时 ， 修 复 syslogger 处 理 中 内 存 泄露 (Tom) 
当 重新 解析 pg_hba.conf 的 时 候 ， 修 复 postmaster 中 的 内 存 泄露 (Tom) 
18S Windows4x IR F 3 44 (Jesse Morris) 


这 修复 了 数据 库 在 Windows 上 启动 失败 的 一 些 情况 ， 通常 带 有 误导 性 错误 信息 比如 "不 能 
定位 匹配 postgres 可 执行 程序 "。 


使 得 在 主 查 询 中 For UPDATE/SHARE 不 扩大 到 with 查询 中 (Tom) 


比如 ， 在 


WITH w AS (SELECT * FROM foo) SELECT * FROM w, bar ... FOR UPDATE 


FOR UPDATE 将 影响 bar 而 不 是 foo 。 这 比 原来 8.4 操 作 更 有 用 而 且 更 加 一 致 ， 党 试 扩 
AX FOR UPDATE 到 with 查询 中 ， 但 是 却 总 是 失败 ， 因 为 匹配 实现 限制 。 它 也 遵循 设计 规 
则 ， 如 果 主 查询 独立 ， 执 行 WITH 查询 。 


修复 在 另外 一 个 中 使 用 wITH recursive 查询 的 错误 (Tom) 

修复 散 列 索引 的 并 发 错误 (Tom) 

并 发 插 和 人 可 能 导致 索引 扫描 瞬时 报告 错误 结果 。 

当 分 割 取决 于 索引 的 非 首 列 时 ， 修 复 GiST 素 引 页 分 割 错误 逻辑 (Paul Ramsey) 
修复 为 多 列 GIN 素 引 使 用 fastupdate 激活 的 错误 搜索 结果 (Teodor) 

修复 GIN 索 引 WAL 项 创建 中 的 错误 (Tom) 


当 full_page_ writes 为 on 的 时 候 ， 这 些 错 误 被 隐藏 ， 但 是 如 果 在 下 一 个 检查 点 之 前 发 生 
AAS, 那么 关闭 WAL 回 放 错 误 是 一 定 的 。 


如 果 在 检查 点 结尾 回收 或 者 删除 旧 的 WAL 文 件 失败 ， 不 要 出 错误 (Heikki) 


更 好 地 将 这 个 问题 作为 非 致 命 性 的 并 且 人 允许 完成 检查 点 。 未 来 的 检查 点 将 重 试 取消 。 这 
样 的 问题 没有 预期 的 正常 运行 ， 但 通过 错误 设计 Windows 杀 毒 和 各 份 软件 造成 的 。 


确保 Windows 上 WAL 文 件 不 再 被 重复 轨 档 (Heikki) 
如 果 其 他 过 程 干扰 不 再 需要 的 文件 的 删除 ， 这 可 能 发 生 另 外 一 种 情况 。 
修复 PAM 密 码 处 理 更 加 鲁 棒 性 (Tom) 


上 面 的 代码 伴随 着 Linux pam_krb5 PAM 模 块 与 作为 域 控制 器 的 Microsoft 动 态 目录 结合 
Am. 它 可 能 还 有 其 他 问题 ， 因 为 它 采 用 关于 PAM 堆 栈 传递 给 它 什么 参数 的 不 合理 假 


设 。 
提高 GSSAPI 和 SSPI 认 证 方法 中 最 大 认证 邻 牌 (Kerberos ticket) 大 小 (lan Turner) 


当 为 Unix Kerberos 实现 有 足够 多 的 旧 的 2000 字 节 限 制 时 ， 通过 Windows 域 控制 器 发 出 
标签 可 以 更 大 。 


确保 域 约束 在 ARRAY[...]::domain 结构 中 被 强制 ， 其 中 域 不 在 数值 类 型 中 (Heikki) 
修复 为 涉及 复合 类 型 列 作为 外 键 的 情况 中 的 外 键 逻 辑 (Tom) 

确保 游标 的 快照 在 被 创建 后 不 被 修改 (Alvaro) 

如 果 在 同一 事务 中 后 续 操作 修改 数据 ， 这 可 能 导致 游标 传递 错误 结果 ， 应 该 返回 游标 。 
修复 cREATE TABLE 以 正确 合并 来 自 不 同 继承 父 表 的 缺 省 表达 式 (Tom) 

这 用 于 运行 ， 但 在 8.4 中 被 损坏 。 

重新 启用 序列 访问 统计 收集 (Akira Kurosawa) 


这 用 于 运行 ， 但 在 8.3 中 被 损坏 。 


Wr 


复 CREATE OR REPLACE FUNCTION 中 所 有 依赖 的 处 理 (Tom) 
修复 WHERE ` x = _x_ 条 件 的 错误 处 理 (Tom) 
在 某 些 情况 下 ， 可 以 作为 匈 余 忽略 ， 但 是 它们 不 是 一 它们 等 价 于 x Is NOT NULL o 


当 为 文本 相同 易 变 表达 式 使 用 哈 希 聚 合 实现 DISTINCT 的 时 候 ， 修复 不 正确 规划 结构 
(Tom) 


修复 易 变 SELECT DISTINCT on 表达 式 的 断言 错误 (Tom) 

修复 ts_stat() 而 在 空 的 tsvector 值 上 不 失败 (Tom) 

使 得 文本 搜索 解析 器 接受 XML 属性 中 下 划 线 (Peten) 

修复 xml 二 进 制 输入 中 编码 处 理 (Heikki) 

如 果 XML 头 没有 指定 编码 ， 我 们 现在 假设 缺 省 UTF-8 ; 先前 处 理 是 不 一 致 的 。 
修复 从 plperlu 调用 plperl 的 错误 ， 反 之 亦 然 (Tom) 


从 内 部 酚 数 退出 的 错误 可 能 导致 崩溃 ， 由 于 该 错误 为 外 部 本 数 重新 选择 正确 的 Perl 解 释 
器 。 


当 重 新 定义 PL/Perl 沙 数 的 时 候 ， 修 复 会 话 存在 期 内 存 泄露 (Tom) 


当 通 过 集合 返回 PL/Perl 函 数 返 回 时 ， 确 保 Perl 数 组 正确 转换 为 PostgreSQL 数 组 (Andrew 
Dunstan, Abhijit Menon-Sen) 


这 些 正常 运行 都 为 了 非 集合 返回 图 数 。 

修复 PL/Python 中 异常 处 理 的 罕见 月 汪 (Peter) 

修复 DECLARE cursor 语句 中 注释 的 ecpg 问 题 (Michael) 
修复 ecpg 不 把 最 近 添 加 的 关键 字 作 为 保留 字 (Tom) 


这 影响 了 关键 字 CALLED ， CATALOG ， DEFINER ， ENUM, FOLLOWING , INVOKER , OPTIONS , 


PARTITION ， PRECEDING ， RANGE ， SECURITY ， SERVER ， UNBOUNDED 和 WRAPPER 。 

重新 允许 psql 的 \df 画 数 名 字 参 数 中 的 正则 表达 式 特 殊 字符 (Tom) 

在 contrib/fuzzystrmatch 中 ， 纠 正 非 缺 省 成 本 levenshtein 距离 计算 (Marcin Mank) 
在 contrib/pg_standby 中 ， 禁 用 Windows 上 带 有 信号 触发 器 转移 (Fujii Masao) 

这 没有 什么 有 用 的 ， 因 为 Windows 没 有 Unix 风 格 讯号 ， 但 是 最 近 变 化 确实 崩溃 。 


将 FREEZE and verbose 选项 以 正确 顺序 放置 在 contribyvacuumdb 产生 的 vacuum 命令 中 
(Heikki) 


当 contrib/dblink 遇 到 错误 的 时 候 ， 修 复 链 接 的 可 能 泄露 (Tatsuhito Kasahara) 
确保 psql 的 flex 模 块 与 正确 系统 标题 定义 一 起 被 编译 (Tom) 


这 将 修复 平台 上 的 编译 错误 ， 其 中 --enable-largefile 在 产生 代码 中 导致 的 SHAT 
化 。 


使 得 postmaster 忽 略 任何 连接 请 求 包 中 的 application_name 参数 ， 以 优化 与 未 来 libpq 版 
本 的 兼容 (Tom) 


更 新 时 区 缩写 文件 以 匹配 当前 实际 情况 (Joachim Wieland) 
这 包含 添加 mT 到 缺 省 时 区 缩写 设置 。 


为 了 Antarctica, Argentina, Bangladesh, Fiji, Novokuznetsk, Pakistan, Palestine, Samoa, 
Syria 中 DST 交 化 规律 更 新 时 区 数据 文件 到 tzdata 发 布 2009s。 也 为 了 Hong Kong 历 史 纠 
正 。 


E.52. £ 78.4.1 


发 布 日 期 : 2009-09-09 


该 发 布 包含 来 自 8.4 中 的 各 种 修复 。 关 于 8.4 主 要 发 布 中 的 新 特性 信息 ， 2y Section E.53。 


E.52.1. 迁移 到 版 本 8.4.1 


运行 8.4.X 不 需要 备份 /恢复 。 


E.52.2. %14k 


。 在 当 档 恢复 结尾 修复 WAL 页 面 头 部 初始 化 (Heikki) 
这 可 能 导致 在 后 续 为 档 恢复 中 人 处理 WAL 的 错误 。 
。 修复 "归档 中 不 能 产生 新 的 WAL 项 "错误 (Tom) 
。 修复 在 崩溃 后 使 得 过 期 行 可 见 的 问题 (Tom) 
涉及 页 面 状 态 位 的 错误 可 能 在 服务 器 崩溃 后 不 能 正确 设置 。 
。 在 安全 定义 函数 中 不 允许 RESET ROLE 和 RESET SESSION AUTHORIZATION (Tom, Heikki) 


这 包含 了 在 之 前 补丁 中 漏 掉 的 一 种 情况 ， 在 安全 定义 画 数 中 不 人 允 
许 SET ROLE 和 SET SESSION AUTHORIZATION (Æ CVE-2007-6600) 


。 使 得 已 经 加 载 模块 的 Loa 成 为 非 操作 的 (Tom) 
以 前 Loan 尝试 卸载 并 且 重 新 加 载 该 模块 ， 但 是 这 不 安全 而 且 没 有 用 久 。 
。 ($A OBR PARTITION BY 和 ORDER BY 项 总 是 被 解释 为 简单 表达 式 (Tom) 


在 8.4.0 中 这 些 列 表 按 照 用 于 顶级 croup BY 和 oRDER BY 列表 规则 被 解析 。 但 是 每 个 SQL 
标准 是 不 正确 的 ， 并 且 可 能 导致 循环 。 


。 修复 半 连 接 规划 中 若干 错误 (Tom) 
在 IN 或 者 exists 与 另外 一 个 连接 一 起 使 用 的 情况 中 导致 错误 查询 结果 。 
。 修复 引用 外 连接 中 子 查 询 的 整 行 处 理 (Tom) 


例子 为 SELECT COUNT(ss.*) FROM ... LEFT JOIN (SELECT ...) ss ON ... o 这 里 ， 为 空 扩 
展 连接 行 ss.* 被 看 作为 Row(NULL, NULL, ...) ， 和 与 简单 空 不 一 样 ， 现 在 闻 它 看 作为 简单 
Ju 


-L0 


修复 Windows 共 享 内 存 分 配 代码 (Tsutomu Yamada, Magnus) 

该 错误 导致 经 常 报道 的 "不 能 附加 到 共享 内 存 "错误 信息 。 

修复 本 地 人 处理 plperl (Heikki) 

当 调 用 plperl 男 数 的 时 候 ， 导 致 数据 损坏 ， 该 错误 可 能 导致 服务 器 的 本 地 设置 改变 。 
修复 reloptions 的 处 理 以 确保 设置 一 个 选项 不 强制 为 其 它 的 缺 省 值 (ltagaki Takahiro) 


确保 "fast shutdown" 请 求 强制 终止 打开 会 话 ， 即 使 "smart shutdown" 已 经 在 进行 中 (Fujii 
Masao) 


避免 Group BY 查询 中 array_agg() 的 内 存 泄 露 (Tom) 
将 to_char(...，'TH') 看 作 带 有 'HH' / 'HH12' 后 级 的 大 写字 母 序 列 (Heikki) 
EBEA 'th' (小 写字 母 ) 被 处 理 。 


包含 time 和 time with time zone 输出 的 ExTRACT(second) 和 EXTRACT(milliseconds) 结 


果 中 的 小 数 部 分 (Tom) 
一 直 为 浮 点 datetime 配 置 工作 ， 但 在 整数 datetime 代 码 中 被 打 断 。 


4 x 大 于 2 百 万 并 且 整 数 datetime 在 使 用 中 的 时 候 ， 修复 INTERVAL ox ”ms' 渝 出 
(Alex Hunsaker) 


当 义 理 索 引 扫 描 中 toasted 值 得 时 候 ， 优 化 性 能 (Tom) 

这 对 PostGIS 是 特别 有 用 的 。 

修复 禁用 commit_delay 错误 (Jeff Janes) 

如 果 以 silent 模 式 启用 服务 器 ， 输 出 早期 启用 信息 到 postmaster.1og (Tom) 
以 前 丢弃 这 样 的 错误 信息 ， 导 致 调度 困难 。 

删除 翻译 常见 问题 (Peten) 

现在 主要 是 在 wiki 上 面 。 主要 的 问题 前 段 时 间 已 经 移 到 了 wiki 上 。 

如 果 postgresql.conf 为 空 ， 那 么 修复 pg_ctl 不 陷 和 人 无 限 循环 中 (Jeff Davis) 
修复 pg_dump 的 --binary-upgrade 模式 中 的 若干 错误 (Bruce, Tom) 

通过 pg_migrator 使 用 pg_dump --binary-upgrade 。 

修复 contrib/xml2 的 xslt_process() 以 正确 处 理 最 大 数量 参数 (二 十 )(Tom) 
提高 libpq 代 码 的 和 鲁 棒 性 以 恢复 copy From STDIN 中 错误 (Tom) 


当 安 装 两 个 库 的 时 候 ， 避 免 包 含 readline 和 editline 头 文件 的 冲突 (Zdenek Kotala) 


。 feXgccHik, CER- EPSE" a" nE" AERA" (Tom) 


e 为 Bangladesh, Egypt, Mauritius 中 DST 变 化 规律 更 新 时 区 数据 文件 到 tzdata 发 布 2009|l。 


E.53. & 778.4 


发 布 日 期 : 2009-07-01 


E.53.1. 概要 


经 过 多 年 研发 后 ，PostgreSQL 已 经 在 许多 领域 特性 比较 完整 。 该 发 布 显 示 一 个 针对 性 方法 来 
添加 特性 〈 比 如 ， 认 证 ， 监 测 ， 空 间 重 利用 ) ， 并 且 添 加 在 以 后 SQL 标准 中 定义 的 能 力 。 增 
强 的 主要 方面 是 : 


。 窗口 函数 

。 通用 表 表 达 式 和 递归 查询 
。 HARA A FSR 

。 并 行 恢 复 

。 列 权 限 

。 每 个 数据 库 本 地 设置 


。 改进 的 哈 希 索引 
e 改进 exists 和 not Exists 查询 连接 性 能 


。 容易 使 用 热 备份 

。 空闲 空间 映射 的 自动 大 小 

。 可 见 映 射 〈 大 大 降低 了 缓慢 变化 表 的 清理 开销 ) 

e 版 本 感知 psql( 旧 服务 器 之 前 使 用 反 斜 杠 命令 ) 

。 支持 用 户 认证 的 SSL 证 书 

。 STM IN Kit 

。 psql FEN 2x fy 3 45 4 

e 新 的 contrib 模 块 : pg_stat_statements, auto_explain, citext, btree_gin 


在 下 面 章节 中 将 详细 解释 以 上 所 列 项 。 


E.53.2. 迁移 到 版 本 8.4 


对 于 那些 希望 从 任何 以 前 发 布 中 迁移 数据 是 需要 使 用 pg_dump 各 份 / 恢 复 。 


观察 下 面 的 不 兼容 : 
E.53.2.1. 普通 的 


。 缺 省 使 用 64 位 整数 日 期 时 间 (Neil Conway) 


以 前 通 过 configure 的 - -enable-integer-datetimes 选项 进行 选择 。 为 保留 3 A VE, 
5 --disable-integer-datetimes 一 起 编译 。 


。 删除 ipcclean 实 用 命令 (Bruce) 


该 功能 仅仅 工作 于 几 个 平台 上 。 用 户 应 该 使 用 他 们 的 操作 系统 工具 


E.53.2.2. Ak 4 erik ia 


e 为 log min messages 更 改 缺 省 设置 为 warning (LABIA notice) 以 减少 日 志文 件数 量 
(Tom) 


e 为 max_prepared_transactions 改变 缺 省 设置 为 需 (以 前 为 5) (Tom) 


° 使 得 debug_print_parse , debug_print_rewritten , 和 debug_print_plan 在 LOG 消息 级 别 


输出 ， 而 不 是 像 从 前 的 DEBU61 (Tom) 
e debug_pretty_print 缺 省 为 on (Tom) 
© 删除 explain_pretty_print 参数 (不 再 需要 的 ) (Tom) 
。 通过 超级 用 户 使 得 log temp_files 可 定位 ， 像 其 它 日 志 选 项 (Simon Riggs) 


e 当 没 有 % 逃逸 出 现在 log filename 中 的 时 候 ， 删 除 epoch 时 间 惟 的 自动 追加 (Robert 
Haas) 


该 变化 是 因为 有 些 用 户 想 要 一 个 已 修复 的 日 志文 件 名 ， 用 于 外 部 日 志 轮 换 工具 
eM recovery.conf 删除 中 删除 log_restartpoints ; 代替 使 用 log_checkpoints (Simon) 
e 删除 krb_realm 和 krb_server_hostname ; 而 是 在 pg_hba,conf 中 设置 (Magnus) 


e 在 pg_hba.conf 中 有 显著 变化 ， 如 下 所 述 。 


E.53.2.3. 查询 


e 改变 TRUNCATE 和 Lock 以 适用 于 指定 表 的 子 表 (Peter) 
这 些 命令 现在 接受 避免 处 理子 表 的 oy 选项 ; 如 果 需 要 旧 操 作 ， 必 须 使 用 该 选项 。 


SELECT DISTINCT 和 UNION / INTERSECT / EXCEPT 不 再 总 是 产生 有 序 输 出 (Tom) 


之 前 ， 这 些 类 型 的 查询 总 是 通过 排序 /唯一 的 处 理 方式 ( 即 排序 然后 删除 相 令 重复) 去除 
重复 行 。 现在 ， 他 们 可 以 通过 哈 希 来 实现 ， 这 不 会 生成 有 序 输出 。 如 果 应 用 程序 依赖 于 
按照 排序 顺序 的 输出 ， ?????3? 那 么 推荐 解决 方法 是 添加 一 个 oRDER BY 子 句 。 作 为 一 个 
短期 解决 方法 ， 之 前 的 操作 可 以 通过 禁用 enable_hashagg 被 恢复 ， 但 是 这 是 一 个 性 能 昂 
贵 的 修复 。 SELECT DISTINCT on 从 不 使 用 散 列 ， 然 而 ， 因 此 ， 其 操作 不 改变 。 


强迫 子 表 继承 父 表 cHEck 约束 (Alex Hunsaker, Nikhil Sontakke, Tom) 


以 前 可 能 从 子 表 中 删除 该 约束 ， 当 扫描 父 表 的 时 人 息 ， 人 允许 违背 该 约束 的 行 可 见 。 这 被 认 
为 是 不 一 致 的 ， 也 违背 了 SQL 标 准 。 


禁止 负 的 LIMIT 或 者 oFFsET 值 ， 而 不 是 将 它们 视 为 雳 (Simon) 
禁止 事务 块 外 的 Lock TABLE (Tom) 

这 样 的 操作 是 无 效 的 ， 因 为 该 锁 将 被 立即 释放 。 

现在 序列 包含 一 个 额外 的 start_value 列 (Zoltan Boszormenyi) 


支持 ALTER SEQUENCE ... RESTART 。 


E.53.2.4. 函数 和 操作 符 


采用 numeric 需 放 到 分 数 千 上 返回 6， 而 不 是 抛 出 错误 ， 并 且 采 用 numeric BAFE 
上 返回 1 ， 而 不 是 错误 (Bruce) 


这 匹配 长 期 的 float8 操作 。 
允许 浮 点 值 的 一 元 负 号 产生 负 需 (Tom) 
修改 后 操作 更 加 遵循 IEEE- 标 准 。 


如 果 转 义 字 符 是 LI 模式 中 的 最 后 一 个 字符 ， 抛 出 一 个 错误 ( 即 它 没有 任何 逃逸 ) 
(Tom) 


此 前 ， 这 样 的 转 义 字符 被 默默 忽略 掉 ， 从 而 可 能 掩盖 应 用 程序 逻辑 错误 。 
删除 以 前 用 于 LIkE 索引 比较 的 -~= and ~alt;agt;~ 操作 符 (Tom) 
模式 索引 目前 使 用 规则 平等 操作 符 。 

xpath() 现在 将 参数 传递 给 libxml 没 有 任何 变化 (Andrew) 


这 意味 着 XML 参数 必须 是 一 个 良好 的 XML 文档 。 先 前 编码 试图 允许 XML 片段 ， 但 它 并 没 
有 很 好 地 工作 。 


让 xmlelement() 格式 属性 值 就 好 像 目 录 值 (Peter) 


此 前 ， 属 性 值 是 按照 正常 的 SQL 输出 操作 被 格式 化 ， 有 时 不 符合 XML 规则 。 
。 为 libxml- 使 用 范 数 重 写 内 存 管 理 (Tom) 

这 种 变化 应 该 避免 在 PL/Perl 中 使 用 libxml 和 其 他 附加 代码 的 一 些 兼 容 性 问题 。 
。 为 哈 希 函数 采取 更 快速 算法 (Kenneth Marshall, 依 据 Bob Jenkins 的 工作 ) 

许多 内 置 哈 希 函数 现在 在 小 端 和 大 端 平台 上 提供 不 同 的 结果 。 


E.53.2.4.1. 时 间 男 数 和 操作 符 


e Datestyle 不 再 控制 interval 输出 格式 ; 反而 有 一 个 新 变量 Intervalstyle (Ron 
Mayer) 


o 提高 timestamp 和 interval 输出 中 小 数秒 处 理 的 一 致 性 (Ron Mayer) 
文 可 能 导致 比 以 前 显示 不 同 数 量 的 小 数位 ， 或 者 四 舍 五 入 而 不 是 截断 。 


e 使 得 to_char() 的 本 地 的 月 份 /日 期 名 字 依 赖 于 Lc_TIME ， 而 不 是 Lc_messaces (Euler 
Taveira de Oliveira) 


© 导致 to_date() 和 to_timestamp() 更 加 一 致 报告 无 效 输入 错误 (Brendan Jurd) 


以 前 的 版 本 中 会 常常 忽略 或 默默 地 误 读 不 匹配 格式 字符 串 的 输入 。 这 种 情况 下 将 导致 错 


误 。 


© 为 了 子午 线 ( AM / PM ) 和 纪元 ( Bc / Ap ) 格 式 名 称 修复 to_timestamp() 而 不 需要 大 写 / 小 写 
匹配 (Brendan Jurd) 


比如 ， 输 入 值 ad 匹配 格式 字符 串 Ap 。 


E.53.3. 变化 


下 面 你 会 发 现在 PostgreSQL 8.4 和 之 前 主要 发 布 之 间 变 化 的 详细 说 明 。 


E.53.3.1. 性 能 
。 完善 优化 统计 计算 (Jan Urbanski, Tom) 
尤其 是 ， 估 计 全 文 搜索 操作 符 被 大 幅度 提高 。 
© JÙ} SELECT DISTINCT 和 UNION / INTERSECT / EXCEPT 可 以 使 用 哈 希 (Tom) 
这 意味 着 这 些 类 型 的 查询 不 再 自动 生成 有 序 输出 。 
。 创建 半 连 接 和 反 连 接 明确 概念 (Tom) 


这 项 工作 正规 化 IN(SELECT ...) 子 句 之 前 的 点 对 点 处 理 ， 并 延伸 
到 exists 和 not exists FAH, 它 可 能 导致 exists 和 not exists 查询 更 好 地 规划 。 
一 般 情 况 下 ， 逮 辑 上 相同 的 IN 和 exists 子 句 有 类 似 性 能 ， 而 此 前 的 IN 获胜 。 


提高 外 部 链接 下 子 选择 优化 (Tom) 


以 前 ， 一 个 子 选 择 或 视图 不 能 被 很 好 的 优化 ， 如 果 它 出 现在 外 连接 可 空 端 并 且 在 结果 列 
中 包含 非 严格 表达 式 (上 比如 ， 常 量 ) 。 


。 通过 使 用 Boyer-Moore-Horspool 搜 索 提高 text_position() 和 相关 函数 的 性 能 (David 
Rowley) 


这 对 长 期 搜索 模式 特别 有 帮助 。 

。 当 需 要 的 时 候 ， 通 过 写 文 件 降低 写 入 统计 收集 文件 /O 负 载 (Martin Pihlak) 

。 提高 批量 插入 性 能 (Robert Haas, Simon) 

e 从 10 到 100 增加 default_statistics_target 缺 省 值 (Greg Sabino Mullane, Tom) 
最 大 值 从 1000 增加 到 10000 。 

。 在 涉及 继承 或 者 UNION ace 的 查询 中 缺 省 执行 constraint_exclusion 检查 (Tom) 
新 的 constraint_exclusion 设置 ， 分 区 被 添加 以 指定 该 操作 。 

e 人 允许 I/O 预 读 取 位 图 索引 扫描 (Greg Stark) 


通过 effective_io_concurrency 控制 预 读数 量 。 只 有 内 核 有 posix_fadvise() 支持 时 该 功 
能 可 用 。 


。 AE FRoM 子 句 中 简单 集合 返回 SQL 画 数 (Richard Rowell) 


。 通过 为 连接 密 钥 值 提供 一 种 特殊 情况 来 优化 多 批 次 哈 希 连 接 性 能 ， 这 种 情况 在 外 部 关系 
中 特别 常见 (Bryce Cutt, Ramon Lawrence) 


。 通过 抑制 "physical tlist" 优 化 减少 多 批 次 哈 希 连 接 中 临时 数据 量 (Michael Henderson, 
Ramon Lawrence) 


e 避免 CREATE INDEX CONCURRENTLY 中 等 待 空闲 事务 会 话 (Simon) 


。 改进 共享 缓存 无 效 性 能 (Tom) 


E.53.3.2. 服务 大 


E.53.3.2.1. 设置 


o 转换 许多 postgresql.conf 设置 以 枚 举 值 ， 使 得 pg_settings 可 以 显示 有 效 值 (Magnus) 


添加 cursor_tuple fraction 参数 以 控制 规划 器 假设 被 抓 取 的 游标 行 (Robert Hell) 


人 允许 postgresql.conf 中 自 定义 变量 类 下 的 下 划 线 (Tom) 


E.53.3.2.2. 身份 验证 和 安全 


删除 支持 (不 安全 ) crypt 认证 方法 (Magnus) 


这 有 效 地 淘汰 了 先前 PostgreSQL7.2 客 户 端 库 ， 为 不 再 有 他 们 可 以 使 用 的 任何 非 明 文 
口 今 方法。 


支持 pg_ident.conf 中 正则 表达 式 (Magnus) 
人 允许 无 需 重 启 postmaster 改 变 Kerberos/GSSAPI 参 数 (Magnus) 
支持 服务 器 证 书 文件 中 SSL 证 书 链 (Andrew Gierth) 


包括 完整 证 书 链 使 客户 能 够 验证 证 书 ， 而 不 需要 存在 于 本 地 存储 中 的 所 有 中 间 CA 证 书 ， 
这 是 商业 CA 的 常见 情况 。 


报告 连接 ms 认证 和 db_user_namespace 启动 的 相应 错误 信息 (Bruce) 


E.53.3.2.3. pg_hba.conf 


改变 所 有 身份 验证 选项 使 用 name=value 语法 (Magnus) 


这 使 得 不 兼容 变化 到 ldap , pam 和 ident 身份 验证 方法 。 所 有 使 用 这 些 方法 
的 pg_hba.conf 项 需要 使 用 新 的 格式 被 重 写 。 


删除 ident sameuser 选项 ， 如 果 没 有 指定 usermap， 而 不 是 使 得 该 操作 缺 省 (Magnus) 
允许 为 所 有 外 部 身份 验证 方法 的 usermap 参 数 (Magnus) 

之 前 usermap 只 支持 ident 认证 。 

添加 clientcert 选项 以 控制 客户 端 证 书 请 求 (Magnus) 

以 前 这 是 通过 服务 器 的 数据 目录 中 根 证 书 文件 被 控制 。 

添加 cert 认证 方法 以 允许 User 认 证 通过 SSL 证 书 (Magnus) 

此 前 SSL 证 书 只 能 验证 客户 端 可 以 使 用 一 个 证 书 ， 而 不 是 验证 用 户 。 

人 允许 在 pg_hba.conf 中 指定 krbs ，gssapi 和 sspi 字段 和 kros 主机 设置 (Magnus) 
这 些 履 盖 了 postgresql.conf 中 设置 。 

为 krb5 ， gssapi 和 sspi 方法 添加 include_realm 参数 (Magnus) 


这 人 允许 来 自 不 同 领域 的 相同 用 户 名 被 认证 为 使 用 用 户 映射 的 不 同 数 据 库 用 户 。 


o 当 它 被 加 载 的 时 候 ， 完 整 解析 pg_hba.cont ， 以 致 于 可 以 立即 报告 错误 (Magnus) 


此 前 ， 文 件 中 的 大 多 数 错误 直到 客户 端 试 图 连接 时 才 会 被 检测 到 ， 所 以 一 个 错误 的 文件 
可 能 导致 系统 无 法 使 用 。 随 着 新 的 操作 ， 如 果 在 重 载 时 检测 到 错误 ， 那 么 坏 文件 被 拒 
绝 ， 并 且 postmaster 继 续 使 用 其 旧 副 本 。 


e 显示 pg_hba.conf 中 所 有 解析 错误 而 不 是 在 第 一 个 之 后 终止 (Selena Deckelmann) 


。 支持 Solaris 上 Unix 域 套 接 字 上 的 ident 认证 (Garick Hamlin) 


E.53.3.2.4. 连续 为 档 
。 提供 一 个 选项 到 pg_start_backup() 以 强制 尽快 完成 的 隐 含 检查 点 (Tom) 
缺 省 操作 避免 过 多 I/O 消 耗 ， 但 是 如 果 没 有 并 发 查询 活动 ， 这 是 之 无 意义 的 。 
e 让 pg_stop_backup() 等 待 修改 的 WAL 文 件 被 归档 (Simon) 


这 保证 各 份 在 pg_stop_backup() 完成 时 是 有 效 的 。 


当 启 用 为 档 时 ， 在 关闭 时 交替 最 后 WAL 段 以 致 于 所 有 事务 可 以 立即 被 为 档 (Guillaume 
Smet, Heikki) 


当 连 续 为 档 基 础 各 份 在 进展 中 时 ， 延 "smart" 关 机 (Laurenz Albe) 
。 如 果 请 求 "fast" 关 机 ， 那 么 取消 连续 为 档 基 础 各 份 (Laurenz Albe) 


© fF recovery.conf 布尔 变量 采取 同一 范围 字符 串 值 作为 postgresql.conf 布尔 值 (Bruce) 


E.53.3.2.5. 监控 


e 当 最 后 加 载 PostgreSQL 配 置 文件 的 时 候 ， 添 加 pg_conf_load_time() 以 报告 (George 
Gensure) 


e 添加 pg_terminate_backend() 以 安全 终止 后 台 ( st6TERM 信号 也 如 此 ) (Tom, Bruce) 


虽然 它 一 直 可 能 si6TERM 单一 后 端 ， 这 个 以 前 被 认为 是 不 支持 的 ; 并 且 测 试 的 情况 下 发 
现 了 一 些 被 修复 的 错误 。 


。 添加 跟踪 用 户 定义 画 数 的 调用 计数 以 及 运行 时 间 能 力 (Martin Pihlak) 


画 数 统计 出 现在 新 的 系统 视图 ， pg_stat_user_functions 中 。 通过 新 的 参 
数 track_functions 控制 跟踪 。 


e 在 pg_stat_activity 中 通过 新 的 track_activity_query_size 参数 允许 声明 最 大 查询 字符 
串 大 小 (Thomas Lee) 


增 大 最 大 线 长 度 发 送 到 syslog， 希 望 优化 性 能 (Tom) 


添加 只 读 配 置 变 量 segment_size , wal_block_size 和 wal_segment_size (Bernd Helmle) 


当 报 告 死 锁 时 ， 报 告 死 锁 服务 器 日 志 中 涉及 的 所 有 查询 文本 (ltagaki Takahiro) 
添加 pg_stat_get_activity(pid) 图 数 以 返回 关于 指定 进程 id 的 信息 (Magnus) 
人 允许 通过 stats_temp_directory 指定 服务 器 的 统计 文件 的 位 置 (Magnus) 


这 人 允许 统计 文件 被 放置 在 RAM 固 有 目录 中 以 减少 I/O 需 求 。 在 启动 /关闭 时 ， 文 件 被 拷贝 
到 它 的 传统 位 置 ( $pPepATA/global/ ) F, 所 以 重新 启动 时 被 保留 


E.53.3.3. 查询 


添加 支持 wINpow EFL(Hitoshi Harada) 

添加 支持 with FA(CTEs), @& wrth recursive (Yoshiyuki Asaba, Tatsuo Ishii, Tom) 
添加 TABLE 命令 (Peten) 

TABLE tablename 是 SELECT * FROM tablename 的 一 个 SQL 标准 简写 。 

当 声明 sELEcT (或 者 RETURNING ) 列 输出 标签 的 时 候 ， 人 允许 as 为 可 选 的 (Hiroshi Saito) 
该 操作 只 要 列 标签 没有 任何 PostgreSQL 关 键 字 ， 否 则 仍然 需要 As 。 


支持 在 secect 结果 列表 中 设置 返回 落 数 ， 即使 对 于 通过 tuplestore 返 回 其 结果 的 函数 
(Tom) 


EAE, 3 BURG RPL/pgSQLal# CPL/pgSQLi# E E SH WML HRA. 
在 聚集 和 分 组 查询 输出 中 支持 设置 返回 画 数 (Tom) 

允许 SELECT FOR UPDATE / SHARE 在 继承 树 上 进行 操作 (Tom) 

为 SQL/MED 添 加 基础 设施 (Martin Pihlak, Peter) 


然而 没有 远程 或 外 部 SQL/MED 功 能 ， 但 这 种 变化 提供 了 一 个 标准 化 的 ， 面 向 未 来 系统 ， 
用 于 管理 类 似 模块 dblink 和 plproxy 连接 信息 。 


当 引 用 的 模式 ， 辑 数 ， 操 作 符 或 者 操作 符 类 被 修改 的 时 候 ， 使 缓存 计划 无 效 (Martin 
Pihlak, Tom) 


这 提高 了 系统 对 反应 传输 中 DDL 变 化 的 能 
允许 复合 类 型 比较 以 及 匿名 复合 类 型 的 数组 (Tom) 


这 人 允许 构造 比如 row(1, 1.1) = any (array[row(7, 7.7), row(1, 1.0)]) o 在 递归 查询 中 
特别 有 用 。 


添加 使 用 代码 点 支持 Unicode 字 符 串 文本 和 标识 符 规 范 ， 比 


如 u&'dN\ogo61t\+900061' (Peter) 


。 拒绝 字符 串 文 本 中 \o00 和 copy 数据 (Tom) 
之 前 ， 这 被 接受 但 是 有 终止 字符 串 内 容 的 影响 。 

。 提高 解析 器 报告 错误 位 置 的 能 力 (Tom) 
为 许多 语义 错误 报道 一 个 错误 位 置 ， 比如 不 匹配 的 数据 类 型 ， 这 在 以 前 不 可 能 被 本 地 
化 。 

E.53.3.3.1. TRUNCATE 

© 支持 语句 级 别 on TRUNCATE 触发 器 (Simon) 

e 为 了 TRUNCATE TABLE 添加 RESTART / CONTINUE IDENTITY 选项 (Zoltan Boszormenyi) 
序列 的 起 始 值 可 以 通过 ALTER SEQUENCE START WITH 被 改变 。 

e 多 许 TRUNCATE tab1，tabl 成 功 (Bruce) 


e 添加 单独 truncate 许可 (Robert Haas) 


E.53.3.3.2. EXPLAIN 
e 采用 EXPLAIN VERBOSE 显示 每 个 规划 节点 的 输出 列 (Tom) 


此 前 EXPLAIN VERBOSE 输出 查询 规划 的 内 部 表示 。 (该 操作 通过 debug_print_plan 是 可 
用 的 。) 


。 采用 EXPLAIN 标识 子 计 划 以 及 单一 标签 的 初始 计划 (Tom) 
e 为 了 debug_print_plan 采用 ExPLAIN (Tom) 


© fù TE CREATE TABLE AS 上 进行 ExPLAIN (Peter) 


E.53.3.3.3. LIMIT / OFFSET 
e ti LIMIT 和 oFFSET 中 子 选择 (Tom) 
© 为 了 LIMIT / oFFSET 性 能 添加 SQL 标准 语法 (Peten) 


也 就 是 说 ， OFFSET num {ROW|ROWS} FETCH {FIRST|NEXT} [num] {ROW|ROWS} ONLY o 


E.53.3.4. 对 象 操作 


© 添加 列 级 权限 支持 (Stephen Frost, KaiGai Kohei) 
e 重 构 多 目标 prop 操作 以 减少 cascave 的 需要 (Alex Hunsaker) 


比如 ， 如 果 表 s ER A 上 有 依赖 物 ， 那 么 命令 DROP TABLE A, B 不 再 需要 CASCADE 选 


项 。 


。 通过 确保 在 开始 删除 对 象 依 赖 之 前 采取 锁定 ， 修 复 各 种 并 发 Do 命令 问题 (Tom) 
e 改善 DRoP 命令 中 依赖 性 报告 (Tom) 
e 添加 WITH [No] DATA 子 句 给 CREATE TABLE As ， 按 照 SQL 标 准 (Peter Tom) 
。 添加 支持 用 户 自 定义 I/O 转 换 模型 (Heikki) 
e Sti CREATE AGGREGATE 使 用 internal 转换 数据 类 型 (Tom) 
e 添加 LIKE 子 句 到 cREATE TYPE (Tom) 
这 简化 了 使 用 作为 已 存在 类 型 同一 内 部 表示 形式 的 数据 类 型 的 创建 。 

。 人 允许 类 型 类 别 指定 以 及 用 户 定义 的 基础 类 型 "首选 "状态 (Tom) 

这 人 允许 控制 用 户 定义 类 型 的 强制 操作 。 


© Sci CREATE OR REPLACE VIEW 添加 列 到 视图 结尾 (Robert Haas) 


E.53.3.4.1. ALTER 
e 添加 ALTER TYPE RENAME (Petr Jelinek) 


e 添加 ALTER SEQUENCE ... RESTART 【无 参数 ) 以 重 置 序列 到 其 初始 值 (Zoltan 
Boszormenyi) 


o 修改 ALTER TABLE 语法 以 允许 表 ， 索 引 ， 序 列 以 及 视图 合理 组 合 (Tom) 
这 种 变化 允许 下 面 新 语法 : 
© ALTER SEQUENCE OWNER TO 
© ALTER VIEW ALTER COLUMN SET/DROP DEFAULT 
© ALTER VIEW OWNER TO 


O ALTER VIEW SET SCHEMA 


这 里 没有 实际 的 新 功能 ， 但 之 前 你 不 得 不 表明 ALTER TABLE 可 以 做 这 些 事情 ， 使 其 混 
Bo 
e 添加 支持 语法 ALTER TABLE ... ALTER COLUMN... SET DATA TYPE (Peter) 
已 经 支持 的 功能 性 SQL 标准 语法 。 
e 采用 ALTER TABLE SET WITHOUT 0IDS 重 写 表 以 物理 删除 orp 值 (Tom) 


同时 添加 ALTER TABLE SET WITH 0IDS 重 写 表 添加 oID o 


E.53.3.4.2. 数据 库 操 作 


© 当 未 提交 预 各 事务 的 时 候 ， 改 善 CREATE / DROP / RENAME DATABASE 错误 报告 (Tom) 

。 每 个 数据 库 设 置 采用 Lc_coLLATE 和 Lc_cTYPE (Radek Strnad, Heikki) 
整理 类 似 编码 ， 总 是 配置 每 个 数据 库 。 

。 完善 检查 数据 库 编 码 ， 整 理 ( Lc_coLLATE ), 以 及 字符 类 ( Lc_cTYPE ) 匹 配 (Heikki, Tom) 


特别 注意 ， 当 从 templatee 拷贝 的 时 候 ， 一 个 新 的 数据 库 编码 和 语言 环境 设置 被 改变 。 
这 避免 了 可 能 拷贝 的 数据 不 匹配 该 设置 。 


添加 ALTER DATABASE SET TABLESPACE 移动 数据 库 到 一 个 新 的 表 空 间 (Guillaume Lelarge, 


Bernd Helmle) 


E.53.3.5. 实用 操作 
e 添加 VERBOSE 选项 到 cLUSTER 命 全 和 clusterdb 中 (Jim Cox) 
© 为 记录 待定 的 触发 器 事件 减少 内 存 需求 (Tom) 
E.53.3.5.1. 索引 
。 大 幅 提 高 建立 并 且 访 问 哈 希 索引 速度 (Tom Raney, Shreya Bhargava) 


这 使 得 散 列 索引 有 时 上 比 btree 索 引 的 速度 更 快 。 然而 ， 哈 希 来 引 仍 然 没有 碰撞 安全 。 


ei 


得 哈 希 索引 只 存储 哈 希 码 ， 而 不 是 素 引 列 的 完整 值 (Xiao Meng) 
这 大 大 减少 了 为 长 索引 值 的 散 列 索引 的 大 小 ， 从 而 提高 了 性 能 。 
。 实现 GIN 索 引 的 快速 更 新 选项 (Teodor Oleg) 
此 选项 大 大 提高 了 在 搜索 速度 中 小 的 不 利 后 果 上 的 更 新 速度 。 
e xxx_pattern_ops 索引 可 以 用 于 简单 平等 比较 ， 而 不 仅仅 为 LIKE (Tom) 


E.53.3.5.2. EX RSI 
。 当 在 全 文 素 引 中 执行 GIN 加 权 查 找 时 ， 删 除 该 需求 而 使 用 eee (Tom, Teodor) 
可 以 使 用 正常 的 @@ 文本 搜索 操作 符 。 
。 为 @@ 文本 搜索 操作 添加 优化 选择 函数 (Jan Urbanski) 
。 人 允许 全 文 搜索 中 前 级 匹配 (Teodor Sigaev,Oleg Bartunov) 
。 支持 多 列 GIN 索 引 (Teodor Sigaev) 


。 改善 支持 Nepali 语 言 和 Devanagari 字 母 (Teodon) 


E.53.3.5.3. VACUUM 


在 单独 每 个 关系 "fork" 文 件 中 跟踪 自由 空间 (Heikki) 


通过 vacuum 发 现 的 自由 空间 在 *_fsm 文件 中 被 记录 ， 而 不 是 在 一 个 固定 大 小 的 共享 存 
储 器 区 域 中 。 max_fsm_pages 和 max_fsm_relations 设置 已 被 移 除 ， 从 而 大 大 简化 了 自由 


空间 管理 。 
添加 可 见 视图 以 跟踪 不 需要 清理 页 面 (Heikki) 


这 人 允许 vacuum 以 避免 扫描 所 有 表 ， 只 有 表 中 的 一 部 分 需要 清理 的 时 候 。 可 见 视图 被 存储 
在 每 个 关系 "fork" 文 件 。 


添加 vacuum_freeze_table_age 参数 以 控制 当 vAcuuM 忽略 可 见 视图 并 且 执 行 全 表 扫 描 以 
冻结 元 组 。 


更 仔细 追踪 事务 快照 (Alvaro) 
这 提高 了 vacuum 在 长 时 间 运 行 的 事务 中 回收 空间 能 


添加 指定 每 个 关系 autovacuum 以 及 cREATE TABLE 中 TOAST 参 数 的 能 力 (Alvaro, Euler 
Taveira de Oliveira) 


自动 清理 选项 存储 在 系统 表 中 。 


添加 --freeze 选项 到 vacuumdb(Bruce) 


E.53.3.6. 数据 类 型 


为 文本 搜索 同义词 词典 添加 caseSensitive 选项 (Simon) 

完善 NUMERIC 划分 精度 (Tom) 

为 int2 与 inta 添加 基础 算术 操作 符 (Tom) 

这 消除 了 在 某 些 情况 中 显 式 投射 需求 。 

允许 uuID 输入 在 每 四 位 后 面 接受 可 选 的 连 字 符 (Robert Haas) 
允许 on / off 作为 布尔 数据 类 型 的 输入 (ltagaki Takahiro) 

为 类 型 numeric 在 输入 字符 串 中 nan 周围 允许 空格 (Sam Mason) 


E.53.3.6.1. 时 间 数 据 类 型 


拒绝 年 o Bc 以 及 ooo 和 0000 (Tom) 
以 前 这 些 被 解释 为 1 Bc 。 (注意 : F o A oo 仍然 假定 为 2000。 ) 


在 已 知 时 区 缩写 缺 省 列表 中 包含 sor (Singapore 时 间 ) 


支持 infinity 和 -infinity 作为 类 型 date 的 值 (Tom) 

使 得 interval 文本 解析 更 加 遵循 标准 (Tom, Ron Mayer) 

比如 ， INTERVAL '1' YEAR 目前 执行 应 该 做 的 内 容 。 

在 second 关键 字 之 后 ， 按 照 SQL 标准 允许 指定 interval 分 数秒 精度 (Tom) 


之 前 在 关键 字 interval 之 后 指定 精度 。 (为 了 向 后 兼容 ， 这 种 语法 仍 支持 ， 但 不 建议 使 
用 。) 数据 类 型 定义 现在 使 用 标准 格式 被 输出 。 


支持 ISO 8601 interval 语法 (Ron Mayer, Kevin Grittner) 
比如 ， 现 在 支持 INTERVAL 'P1Y2M3DT4H5M6.7S' o 
添加 IntervalStyle 参数 以 控制 Interval 值 如 何 输 出 (Ron Mayer) 


有 效 值 是 : postgres , postgres_verbose , sql_standard , iso_8601 o 只 有 当 一 些 字段 


有 正 / 负 名 称 的 时 候 ， 该 设置 也 控制 负 interval 输入 的 义理 。 
在 timestamp 和 interval 输入 中 优化 小 数秒 处 理 的 一 致 性 (Ron Mayer) 


E.53.3.6.2. 数组 


优化 适用 于 ARRAY[] 结构 映射 处 理 ， 比如 ARRAY[...]::integer[] (Brendan Jurd) 


之 前 PostgreSQL 试 图 为 ARRAY[] 结构 而 不 引用 随后 计算 确定 一 个 数据 类 型 。 这 在 许多 情 
况 下 可 能 失败 ， 特 别 是 当 ARRAY[] 构造 是 空 的 或 仅 包含 不 明确 项 如 NuLL 的 时 候 。 现在 
协商 该 计算 以 确定 该 数组 元 素 类 型 。 


使 得 SQL 语法 array 尺寸 可 选 以 匹配 SQL 标 准 (Peter) 
添加 array_ndims() 以 返回 数组 维 数 (Robert Haas) 


添加 array_length() 以 返回 指定 维 数 数组 长 度 (Jim Nasby, Robert Haas, Peter 
Eisentraut) 


添加 聚集 函数 array_agg() 作为 一 个 数组 返回 所 有 聚集 值 (Robert Haas,Jeff Davis, Peter) 
添加 unnest() 将 一 个 数组 转换 为 各 行 值 (Tom) 

这 是 array_agg() 的 反面 。 

添加 array_fill() 以 创建 初始 化 值 数组 (Pavel Stehule) 


添加 generate_subscripts() 以 简化 生成 数组 下 标 范 围 (Pavel Stehule) 


E.53.3.6.3. 宽 值 存储 (TOAST) 


认为 TOAST 压 缩 值 和 32 字 节 一 样 短 (之 前 256 字 节 ) (Greg Stark) 


。 使 用 TOAST 压 缩 之 前 要 求 最 低 25% 的 空间 节省 ， (之 前 20% 为 小 值 并 且 任 何 存储 为 大 


值 ) (Greg) 


。 优化 具有 较 大 和 较 小 toastable 字 段 混合 行 的 TOAST 馈 发 式 ， 使 我 们 更 愿意 使 得 较 大 值 超 


出 范围 并 且 不 压缩 较 小 值 (Greg, Tom) 


E.53.3.7. HR 


setseed() 文件 允许 从 -1 3l) 4 的 值 (不 只 Lz 9 到 1 ) 了 并 且 执 行 有 效 范围 (Kris 
Jurka) 


添加 服务 器 端 范 数 1lo_import(filename, oid) (Tatsuo) 


添加 quote_nullable() 其 操作 类 似 于 quote_literal() 但 为 空 参数 返回 字符 
串 NULL (Brendan Jurd) 


优化 全 文本 搜索 headline() 画 数 以 允许 提取 文本 若干 片段 (Sushant Sinha) 


添加 suppress_redundant_updates_trigger() fil & 25 EY gj 数 以 避免 无 数据 变化 更 新 开销 
(Andrew) 


添加 div(numeric, numeric) 执行 numeric 除法 而 没有 四 舍 五 入 (Tom) 


添加 generate_series() 的 timestamp 和 timestamptz 版 本 (Hitoshi Harada) 


E.53.3.7.1. 对 象 信息 函数 


过 需要 知道 当前 正在 运行 的 查询 的 函数 实现 current_query() 的 使 用 (Tomas Doran) 
添加 pg_get_keywords() 返回 解析 关键 字 列 表 (Dave Page) 
添加 pg_get_functiondef() & ARAPE SX (Abhijit Menon-Sen) 
当 解 析 不 包含 变量 的 表达 式 时 ， 人 允许 pg_get_expr() 第 二 个 参数 为 需 (Tom) 
修改 pg_relation_size() 以 使 用 regclass (Heikki) 
pg_relation_size(data_type_name) 不 再 起 作用 。 
添加 boot_val 和 reset_val 列 到 pg_settings 输出 (Greg Smith) 
为 配置 文件 中 变量 设置 添加 源 文件 名 和 行 号 列 到 pg_settings 输出 (Magnus, Alvaro) 
出 于 安全 原因 ， 这 些 列 只 对 超级 用 户 可 见 
添加 支持 CURRENT_CATALOG , CURRENT_SCHEMA , SET CATALOG , SET SCHEMA (Peter) 
为 存在 特性 提供 SQL 标准 语法 。 
添加 pg_typeof() 返回 任何 值 的 数据 类 型 (Brendan Jurd) 


。 采取 version() 这 返回 有 关 服 务 器 是 否 是 32 或 者 64 位 二 进 制 信 息 (Bruce) 
。 修复 信息 模式 列 is_insertable_into 和 is_updatable 操作 是 一 致 的 (Peter) 
e 改善 信息 模式 datetime_precision 列 的 操 作 (Peter) 


这 些 列 为 date 列 显示 为 需 并 上 且 time, timestamp 以 及 没有 声明 精度 的 interval 显示 
为 6( 默 认 精 度 ) ， 而 不 如 以 前 一 样 显示 为 空 。 


。 转换 剩余 内 置 集合 返回 画 数 使 用 our 参数 (Jaime Casanova) 
这 使 得 它 可 以 调用 没有 指定 列表 的 函数 : pg_show_all_settings() , pg_lock_status() , 


pg_prepared_xact() , pg_prepared_statement() , pg_cursor() 


e 采用 pg_*_is_visible() 和 has_*_privilege() 为 无 效 OID 返 回 NuLL ， 而 不 是 抛 出 错误 
(Tom) 


e 扩展 has_*_privilege() 图 数 以 允许 查询 一 个 调用 中 多 特权 的 OR(Stephen Frost, Tom) 


添加 has_column_privilege() 和 has_any_column_privilege() E2%(Stephen Frost, Tom) 


E.53.3.7.2. 函数 创建 

。 支持 可 变 参数 的 函数 ( 带 有 参数 可 变数 量 的 画 数 ) (Pavel Stehule) 
只 有 尾随 参数 是 可 选 的 ， 它 们 都 必须 是 相同 的 数据 类 型 。 

。 支持 函数 参数 的 缺 省 值 (Pavel Stehule) 

e 添加 CREATE FUNCTION ... RETURNS TABLE 子 句 (Pavel Stehule) 


e 334+SQLi4 AKORO] INSERT / UPDATE / DELETE RETURNING 子 句 的 输出 (Tom) 


E.53.3.7.3. PL/pgSQL 服 务 器 端 语言 
。 为 了 更 容易 地 将 数据 值 插入 到 动态 查询 字符 串 中 支持 ExEcUTE usine (Pavel Stehule) 
。 人 允许 循环 使 用 ror 循环 游标 结果 (Pavel Stehule) 
e 支持 RETURN QUERY EXECUTE (Pavel Stehule) 
e 优化 RAISE 命令 (Pavel Stehule) 
o 支持 DETAIL 和 HINT 字段 
o 支持 sQLsTATE 错误 代码 规范 
o 支持 异常 名 字 参 数 
o 允许 异常 块 中 无 参数 RATISE 重新 抛 出 当前 错误 


e sti EXCEPTION 列表 中 sQLsTATE 代码 规范 (Pavel Stehule) 
这 对 于 义理 自 定义 saLsTATE 代码 非常 有 用 。 
e 支持 case 语句 (Pavel Stehule) 


o 使 用 RETURN QUERY 设置 特殊 的 FouND 和 GET DIAGNOSTICS ”Row_couNT 变量 (Pavel 
Stehule) 


e 使 用 FETCH 和 move 设置 GET DIAGNOSTICS ”Row_couNT 变量 (Andrew Gierth) 
。 使 用 没有 标签 的 ExIT 总 是 退出 最 内 层 循环 (Tom) 


之 前 ， 如 果 有 一 个 BEGIN 块 比 任何 环 路 更 加 紧密 的 艇 套 ， 将 退出 该 块 。 新 的 操作 匹配 
Oracle(TM) 并 且 也 正如 通过 自身 文档 所 讲述 的 。 


使 得 字符 串 文 本 处 理 和 嵌 套 块 注释 匹配 主 SQL 解 析 器 的 处 理 (Tom) 
特别 是 ， 在 RAISE 中 格式 字符 串 执行 与 任何 其 他 字符 串 文 本 一 样 的 操作 ， 包含 从 属 


于 standard_conforming_strings o 当 standard_conforming_strings 为 on 的 时 候 ， 这 种 变 


化 也 修复 了 有 效 命 令 失 败 的 情况 。 
。 当 在 不 同 录 常 块 嵌 套 深度 中 调用 同一 本 数 的 时 候 ， 避 免 内 存 泄露 (Tom) 


E.53.3.8. 客户 端 应 用 
e 修复 pg_ctl restart 保存 命令 行 参 数 (Bruce) 


@ 添加 -w/ - -no-password 选项 防止 在 具有 -w/ --password 3 选项 实用 程序 中 的 密码 提示 
(Peter) 


。 删除 createdb, createuser, dropdb, dropuser 中 的 -a (默默 的 ) 选 项 (Peter) 


这 些 选项 不 起 作用 因为 PostgreSQL 8.3。 


E.53.3.8.1. psql 
。 删除 详细 的 启动 标志 ， 目 前 建议 help (Joshua Drake) 
。 使 用 help 显示 常见 的 反 斜 杠 命 令 (Greg Sabino Mullane) 


。 添加 \pset 格 式 包 模式 来 包装 输出 到 屏幕 宽度 ， 或 者 文件 /管道 输出 ， 如 果 设 
证 \pset 列 (Bryce Nesbitt) 


e 人 多 许 \pset 中 布尔 值 的 所 有 支持 的 拼写 ， 而 不 仅仅 on 和 off (Bruce) 


之 前 ， 除 了 "off' 外 的 任何 字符 串 默 默 地 认为 true 。 psql 抱 怨 无 法 识别 的 拼写 (但 是 仍然 
认为 true) 。 


。 使 用 宽 输 出 分 页 程序 (Bruce) 

。 在 一 个 字母 反 斜 枉 命 信 和 它 的 第 一 个 参数 之 间 需 要 一 个 空格 (Bernd Helmle) 
这 消除 了 有 层 义 的 历史 渊源 。 

。 改善 标签 完整 支持 模式 修饰 以 及 带 引 号 标识 符 (Greg Sabino Mullane) 

e 为 \timing 添加 可 选 的 on / off 参数 (David Fetter) 

。 显示 多 行 上 的 访问 控制 权 (Brendan Jurd, Andreas Scherbaum) 

。 使 用 \1 显示 数据 库 访问 权限 (Andrew Gilligan) 

。 使 用 \1+ 显示 数据 库 大 小 ， 如 果 权 限 允 许 (Andrew Gilligan) 


。 添加 \ef 命令 编辑 函数 定义 (Abhijit Menon-Sen) 


E.53.3.8.2. psql \d* ma 


。 使 得 没有 模式 参数 的 \d* 命令 显示 系统 对 象 ， 只 有 当 指 定 s 修饰 语 的 时 候 (Greg Sabino 
Mullane, Bruce) 


前 者 操作 与 \d 不 同形 式 不 一 致 ， 并 且 在 大 多 数 情况 下 它 没有 提供 简单 方法 查看 用 户 对 
象 。 


。 完善 与 旧 的 PostgreSQL 服 务 器 版 本 一 起 执行 (追溯 到 7.4) 的 \d* 命令 ， 而 不 仅仅 是 当 
前 服务 器 版 本 (Guillaume Lelarge) 


。 使 用 \d 显示 引用 已 选择 表 的 外 键 约束 (Kenneth D'Souza) 

。 在 序列 上 使 用 \d 显示 列 值 (Euler Taveira de Oliveira) 

。 添加 列 存 储 类 型 和 其 他 关系 选项 到 \d+ 显示 中 (Gregory Stark, Euler Taveira de Oliveira) 

e 显示 \dt+ 输出 中 关系 大 小 (Dickson S. Guedes) 

e 显示 \dT+ 中 enum 类 型 可 能 值 (David Fetter) 

。 人 允许 \dc 接受 通配符 模式 ， 这 可 以 匹配 涉及 到 投射 的 数据 类 型 (Tom) 

。 NNR HS \df 的 输出 ， 并 且 添 加 选项 只 列 出 函数 所 选 类 型 (David Fetter) 

e \df 不 隐藏 使 用 或 者 返回 类 型 cstring 的 函数 (Tom) 
此 前 ， 这 种 函数 被 隐藏 ， 因 为 他 们 大 多 是 数据 类 型 /O 琅 数 ， 这 被 认为 是 没有 意义 的 。 上 默 
认 情 况 下 有 关 隐 藏 系统 范 数 的 新 策略 使 得 该 缺点 不 必要 的 。 


E.53.3.8.3. pg_dump 


添加 --no-tablespaces 选项 到 pg_ dump/pg_dumpall/pg_restore 这 样 转 储 可 以 恢复 到 具 
有 非 匹 配 表 空 间 层 次 的 集群 中 (Gavin Roy) 


从 pg_dump 和 pg_dumpall 中 删除 -a 和 -D 选项 (Tom) 


这 些 选项 不 应 该 过 于 频繁 地 与 在 其 它 PostgreSQL 客 户 端 应 用 程序 中 选择 数据 库 名 称 的 选 
项 混淆 。 该 功能 仍然 可 用 ， 但 你 现在 必须 拼写 出 长 选项 名 称 --inserts 或 


者 --column-inserts 。 
从 pg_dump 和 pg_dumpall 中 删除 -i / --ignore-version 选项 (Tom) 


使 用 此 选项 不 会 抛 出 一 个 错误 ， 但 它 没有 效果 。 该 选项 被 移 除 ， 因 为 版 本 检查 对 安全 性 
是 必要 的 。 


在 转 储 和 恢复 中 禁用 statement_timeout (Joshua Drake) 

添加 pg_dump/pg_dumpall 选 项 --lock-wait-timeout (David Gould) 

如 果 在 指定 时 间 内 无 法 获取 共享 锁 ， 那 么 转 储 失败 。 

重新 排序 pg_dump --data-only 输出 用 来 转 储 在 引用 表 之 前 通过 外 键 参考 的 表 (Tom) 
当 外 键 存在 的 时 人 息 ， 人 允许 数据 加 载 。 如 果 循 环 引 用 采用 一 个 不 可 能 的 安全 排序 ， 发 


出 NOTICE 。 

允许 pg_dump, pg_dumpall 和 pg_restore 使 用 指定 用 户 (Benedek László) 
人 允许 pg_restore 使 用 多 个 并 发 连接 执行 恢复 (Andrew) 

通过 选项 --jobs 来 控制 连接 数 。 这 仅仅 支持 自 定义 格式 为 档 。 


E.53.3.9. 编程 工具 


E.53.3.9.1. libpq 


当 通 过 新 函数 1lo_import_with_oid() 导入 大 对 象 的 时 候 ， 人 允许 指定 orb (Tatsuo) 
添加 "events" 支 持 (Andrew Chernow, Merlin Moncure) 
这 添加 了 注册 回调 能 力 来 管理 联系 Pecon 和 Peresult 对 象 的 私有 数据 。 
优化 错误 处 理 以 允许 多 个 错误 信息 的 返回 作为 多 行 错误 报告 (Magnus) 
采用 pgexecParams() 和 相关 吏 数 为 空 查询 返回 PGRES_EMPTY_QUERY (Tom) 
之 前 返回 PGRES_COMMAND_OK o 
记录 Windows 上 如 何 避 免 wsacleanup() 的 开销 (Andrew Chernow) 


不 依赖 于 Kerberos 来 决定 缺 省 数据 库 用 户 名 (Magnus) 


之 前 ，libpq 的 Kerberos 编 译 将 使 用 从 任何 可 用 的 Kerberos 标 签 作为 缺 省 数据 库 用 户 名 的 
主体 名 称 ， 即使 连接 没有 使 用 Kerberos 认 证 。 这 被 认为 是 不 一 致 而 且 混 乱 的 。 有 或 没有 
Kerberos 同 样 的 方式 决定 缺 省 用 户 名 。 然而 ， 当 使 用 Kerberos 身 份 验证 的 时 候 ， 需 要 注 
意 的 是 数据 库 用 户 名 必须 匹配 该 标签 。 


E.53.3.9.2. libpq SSL (安全 套 接 层 ) 支 持 


修复 SSL 连 接 的 证 书 验证 (Magnus) 


libpq 现 在 支持 验证 两 种 证 书 和 SSL 连 接 时 服务 器 的 名 称 。 如 果 根 证 书 不 可 用 于 验证 ， 那 
么 SSL 连 接 失败 。 sslmode 参数 用 于 启用 证 书 验证 ， 并 设置 检查 水 平 。 默认 值 还 没有 做 


支持 通配符 服务 器 证 书 (Magnus) 


如 果 证 书 CN 以 * 开头 ， 它 将 被 视 为 一 个 通配符 ， 当 匹配 hostname 的 时 候 ， 允许 多 个 服 
务 器 同一 证 书 的 使 用 。 


允许 文件 位 置 指定 客户 端 证 书 (Mark Woodward, Alvaro, Magnus) 
增加 PainitopenssL 辑 数 允许 更 大 控制 OpenSSL/libcrypto 初 始 化 (Andrew Chernow) 


当 没有 数据 库 连 接 保持 打开 的 时 候 ， 使 用 libpq 注 销 它 的 OpenSSL 回 调 (Bruce, Magnus, 
Russell Smith) 


和 扼 载 libpq 库 的 应 用 程序 是 必须 的 ， 否 则 无 效 的 OpenSSL 回 调 将 保持 不 变 。 


E.53.3.9.3. ecpg 


。 添加 信息 本 地 化 支持 (Euler Taveira de Oliveira) 


。 从 服务 器 解析 器 自动 生成 ecpg 解 析 器 (Michael) 


之 前 ecpg 解 析 器 手动 维护 。 


E.53.3.9.4. 服务 器 编程 接口 (SPI 
。 添加 超出 行 参数 的 单一 使 用 规划 (Tom) 


e 添加 新 的 SPI_OK_REWRITTEN 返回 sPI_execute() 代码 (Heikki) 


当 命 令 被 重 写 为 命令 的 另 一 种 类 型 的 时 候 使 用 它 。 
从 executor/spi.h 中 删除 不 必要 内 含 物 (Tom) 
如 果 它 们 依赖 spi.h 包含 它们 需要 的 东西 ， SPI 使 用 模块 可 能 需要 添加 一 


些 #include 行 。 


E.53.3.10. 编译 选项 
。 使 用 Autoconf 2.61 更 新 编译 系统 (Peten) 
。 源码 编译 需要 GNU bison(Peten) 
这 个 有 效 的 使 用 了 许多 年 ， 但 是 现在 没有 基础 设施 声明 支持 其 它 解析 工具 。 


x 
e 添加 pg_config --ntmidir 选项 (Peter) 


= 


。 通过 内 部 服务 器 传递 float4 值 (Zoltan Boszormenyi) 


添加 configure 选 项 --disable-float4-byval 以 使 用 旧 操 作 。 使 用 旧式 (版 本 0) 的 外 部 C 
函数 调用 约定 并 通过 这 个 改变 打破 传递 或 者 返回 floats 值 ， 如 果 你 具有 这 样 的 画 数 ， 
并 且 不 想 更 新 它们 ， 


。 通过 64 位 平台 上 内 部 服务 器 传递 float8 , ints 和 相关 数据 类 型 值 (Zoltan Boszormenyi) 


添加 configure 选 项 - -disable-float8-byval 用 来 使 用 旧 的 操作 。 如 上 所 述 ， 该 变化 可 能 
打破 旧 形 式 外 部 C 男 数 。 


° 添加 配置 选项 --with-segsize , --with-blocksize , --with-wal-blocksize , 
--with-wal-segsize (Zdenek Kotala, Tom) 


这 简化 了 编译 时 控制 之 前 只 能 通过 编辑 pg_config_manual.h 来 改变 的 几 个 常数 。 
e 人 允许 在 Solaris 2.5 上 线程 编译 (Bruce) 
e 在 Solaris 上 使 用 系统 的 getopt_long() (Zdenek Kotala, Tom) 
这 使 得 选项 处 理 与 Solaris 用 户 期 望 的 更 加 一 致 。 
。 添加 Linux 上 Sun Studio 编 译 器 支持 (Julius Stroffek) 
。 追加 主 版 本 号 到 后 端 gettext 域 ， 而 soname 主 版 本 号 到 库 的 gettext 域 (Peter) 
这 简化 了 多 个 版 本 并 行 安装 。 
。 人 允许 支持 gcov 代 码 覆 盖 测 试 (Michelle Caisse) 
© 人 允许 在 Mingw 和 和 Cygwin 上 树 外 编译 (Richard Evans) 


。 修复 作为 交叉 编译 源 平台 Mingw 的 使 用 (Peter) 


E.53.3.11. 源 代码 


e 支持 64 位 时 区 数据 文件 (Heikki) 
这 添加 支持 超出 2038 年 夏 兮 也 时 (DST) 计 算 。 


不 赞成 平台 的 timet 数据 类 型 的 使 用 (Tom) 


有 些 平台 已 经 迁移 到 64 位 timet, 有 些 不 能 ，Windows 无 法 下 定 决心 它 在 做 什么 。 定 
SL pg_time_t 和 timet 具有 相同 的 含义 ， 但 始终 是 64 位 (除非 该 平台 不 具有 64 位 整数 
类 型 ) ， 并 且 使 用 所 有 模块 API 中 的 类 型 和 磁盘 上 的 数据 格式 。 


当 交 叉 编 译 的 时 候 ， 修 复 时 区 数据 库 义理 中 错误 (Richard Evans) 

在 一 个 步骤 中 连接 后 端 对 象 文 件 ， 而 不 是 一 个 阶段 中 (Peten) 

完善 gettext 支 持 以 便 复数 的 更 好 转化 (Peter) 

添加 PL 语言 的 信息 翻译 支持 (Alvaro, Peter) 

添加 更 多 DTrace 探 测 (Robert Lor) 

启用 Mac OS X Leopard 以 及 其 它 非 Solaris 平 台 上 的 DTrace 支 持 (Robert Lor) 


简化 并 且 标 准 化 C 字 符 串 和 text 数据 之 间 转 换 ， 出 于 此 目的 提供 普通 画 数 (Brendan 
Jurd, Tom) 


清理 include/catalog/ 头 文 件 以 致 于 前 端 程序 包含 它们 而 不 包含 postgres.h (Zdenek 
Kotala) 


采取 name 字符 对 齐 ， 并 且 抑制 素 引 中 name 项 的 需 填 充 (Tom) 
如 果 动 态 加 载 代码 执行 exit() 更 好 恢复 (Tom) 

添加 连接 让 插件 监控 执行 者 (ltagaki Takahiro) 

添加 连接 允许 规划 器 的 统计 查找 操作 被 覆盖 (Simon Riggs) 
为 自 定义 共享 内 存 需求 添加 shmem_startup_hook() (Tom) 


使 用 amgetbitmap 替换 索引 访问 方法 amgetmulti WAR, 并 且 为 amgettuple 扩展 API 可 
以 支持 操作 符 丢 失 的 运行 时 计算 (Heikki, Tom, Teodor) 


为 GIN 和 GIiST opclass consistent 画 数 的 API 已 经 被 扩展 。 
添加 支持 GIN 索 引 中 局 部 匹配 搜索 (Teodor Sigaev, Oleg Bartunov) 
使 用 布尔 relhastriggers 蔡 换 pg_class Jl) reltriggers (Simon) 
同时 删除 未 使 用 的 pg_class 列 relukeys , relfkeys 和 relrefs 。 
添加 relistemp 列 到 pg_class 解除 临时 表 识 别 (Tom) 

将 平台 FAQ 放 到 主 文档 中 (Peter) 

防止 解析 器 输入 文件 编译 冲突 (Peter) 


e 添加 korsu (Ukrainian) 2% #4(Peter) 
e 添加 Japanese 信 息 转 化 (Japan PostgreSQL 用 户 组 ) 
这 用 于 作为 单一 项 目 被 维护 。 


e 当 在 MSVC 编 译 系 统 上 设置 Lc_messaces 的 时 候 ， 修复 该 问题 (Hiroshi Inoue, Hiroshi 
Saito, Magnus) 


E.53.3.12. Contrib 


e 添加 contrib/auto_explain 在 查询 超过 指定 时 间 上 自动 运行 EXPLAIN (ltagaki Takahiro， 
Tom) 


e 添加 contrib/btree_gin 人 允许 GIN 索 引 人 处 理 更 多 数据 类 型 (Oleg, Teodor) 

。 添加 contrib/citext 提供 不 区 分 大 小 写 ， 多 字 节 文本 数据 类 型 (David Wheeler) 

© 为 语句 执行 统计 的 服务 器 范围 追踪 添加 contrib/pg_stat_statements (Itagaki Takahiro) 
。 添加 时 间 和 查询 模式 选项 到 contrib/pgbench (Itagaki Takahiro) 


e contrib/pgbench 使 用 表 名 pgbench_accounts , pgbench_branches , 
pgbench_history 和 pgbench_tellers ,而 不 仅仅 accounts , branches , 
history 和 tellers (Tom) 


通过 运行 pgbench 以 降低 意外 破坏 真实 数据 的 风险 。 
e 修复 contrib/pgstattuple 处 理 表 和 超过 20 亿 页 面 的 索引 (Tatsuhito Kasahara) 


e 在 contrib/fuzzystrmatch 中 ， 添 加 Levenshtein 字 符 串 距离 函数 版 本 允许 用 户 声明 插 
和 入， 删除 和 蔡 换 成 本 (Volkan Yazici) 


e 采用 contrib/ltree 支持 多 字 节 编码 (laser) 
e 启用 contrib/dblink 使 用 存储 在 SQL/MED 目 录 中 的 连接 信息 (Joe Conway) 
。 完善 来 自 远程 服务 器 错误 的 contrib/dblink 的 报告 (Joe Conway) 
e 使 用 contrib/dblink 设置 client_encoding 以 匹配 本 地 数据 库 的 编码 (Joe Conway) 
当 和 与 使 用 不 同 编码 的 远程 数据 库 通信 时 ， 这 可 以 避免 编码 问题 。 
。 确保 contrib/dblink 使 用 用 户 提供 的 密码 ， 并 且 不 是 意外 地 采取 服务 器 的 .pgpass 文件 


(Joe Conway) 
有 一 个 小 的 安全 增强 功能 。 


e 添加 fsm_page_contents() 到 contrib/pageinspect (Heikki) 


修改 get_raw_page() 支持 自由 空间 映射 ( * fsm ) 文 件 。 同时 更 


新 contrib/pg_freespacemap 。 

添加 支持 多 字 节 编码 到 contrib/pg_trgm (Teodor) 

XE contrib/intagg 使 用 新 的 函数 array_agg() 和 unnest() (Tom) 

故障 转移 之 前 使 用 contrib/pg_standby 回收 所 有 可 用 WAL(Fujii Masao, Simon, Heikki) 


为 了 使 这 项 工作 安全 ， 您 现在 需要 设置 recovery.conf 中 新 的 recovery_end_command 选项 
用 来 清理 故障 转移 后 的 触发 器 文件 。 pg_standby 将 不 再 删除 触发 器 文件 本 身 。 


contrib/pg_standby 的 -1 选项 现在 是 一 个 空 操作 ， 因为 它 使 用 符号 链接 不 安全 (Simon) 


E.54. 发 布 8.3.23 


发 布 日 期 : 2013-02-07 
该 发 布 包含 来 自 8.3.22 中 各 种 修复 。 关 于 8.3 主 要 发 布 中 新 特性 信息 ， 参阅 Section E.77。 
预计 这 是 8.3.X 系 列 中 最 后 PostgreSQL 发 布 。 鼓励 用 户 尽快 更 新 到 新 版 本 分 支 。 


E.54.1. 迁移 到 版 本 8.3.23 


运行 8.3.X 不 需要 各 份 /恢复 。 
然而 ， 如 果 从 8.3.17 更 早 版 本 更 新 ， 参 阅 8.3.17 发 布 说 明 。 


E.54.2. 变化 


。 避免 来 自 SQL enum_recv 的 执行 (Tom Lane) 


该 贺 数 被 错误 声明 ， 使 得 简单 SQL 命 合 造 成 服务 器 月 溃 。 原则 上 攻击 者 可 能 使 用 它 检 查 


服务 器 内 存 的 内 容 。 非常 感谢 Sumit Soni( 通 过 Secunia SVCRP) 报 告 这 个 问题 (CVE- 
2013-0255) 


。 修复 SQL 语法 以 允许 来 自 子 SELECT 结果 的 下 标 或 者 字段 选择 (Tom Lane) 


e 当 扫 描 pg_tablespace 的 时 候 ， 防 止 竞 态 条 件 (Stephen Frost, Tom Lane) 


如 果 有 pg_tablespace 项 的 并 发 更 新 ， 那么 CREATE DATABASE 和 DROP DATABASE 可 能 误 操 


作 。 
e 防止 prop owen 尝试 删除 整个 数据 库 或 者 表 空 间 (Alvaro Herrera) 
出 于 安全 考虑 ， 这 些 对 象 的 所 有 权 被 重新 分 配 ， 而 不 是 被 删除 。 


e 当 RowExpr 或 者 xmlExpr 被 解析 分 析 两 次 的 时 候 ， 避免 误 操 作 (Andres Freund, Tom 
Lane) 


该 错误 在 上 下 文中 是 用 户 可 见 的 ， 比 如 CREATE TABLE LIKE INCLUDING INDEXES o 
。 提高 在 哈 希 大 小 计算 中 防御 整数 浴 出 (Jeff Davis) 
© 确保 非 ASCII 提 示 字 符 串 被 转换 为 Windows 上 正确 代码 页 (Alexander Law, Noah Misch) 
这 个 错误 影响 psql 以 及 一 些 其 他 的 客户 端 程序 。 


e. 当 不 连接 到 数据 库 的 时 候 ， 修 复 psql 的 \? 命 命中 可 能 崩 汪 (Meng Qingzhong) 


修复 libpq 的 poprinttuples 中 一 个 字 节 缓冲 区 浴 出 (Xi Wang) 
这 个 以 往 函 数 不 会 被 PostgreSQL 自 身 使 用 ， 但 是 它 可 能 通过 客户 端 代码 被 使 用 。 


为 提供 的 函数 重新 分 配 配置 测试 ， 因此 它 不 会 通过 libeditlibreadline 虚 假 输 出 被 愚弄 
(Christoph Berg) 


确保 随时 间 推 移 Windows 编 译 数 增加 (Magnus Hagander) 


当 Windows 交 叉 编 译 时 ， 使 得 pgxs 建 立 具 有 正确 .exe 后 级 的 可 执行 文件 (Zoltan 
Boszormenyi) 


添加 新 的 时 区 缩写 FET (Tom Lane) 


这 被 用 于 一 些 东 欧 时 区 。 


E.55. 发 布 8.3.22 


发 布 日 期 : 2012-12-06 
该 发 布 包含 来 自 8.3.21 中 各 种 修复 。 关 于 8.3 主 要 发 布 中 新 特性 信息 ， 参阅 Section E.77。 


PostgreSQL 社 区 在 2013 年 2 月 为 8.3.X 发 布 系列 停止 发 布 更 新 。 鼓励 用 户 尽快 更 新 到 新 版 本 分 
支 。 


E.55.1. 迁移 到 版 本 8.3.22 


运行 8.3.X 不 需要 各 份 /恢复 。 
然而 ， 如 果 从 8.3.17 更 早上 版 本 更 新 ， 参 阅 8.3.17 发 布 说 明 。 


E.55.2. %14k 


o 修复 与 CREATE INDEX CONCURRENTLY 相关 的 多 个 错误 (Andres Freund, Tom Lane) 


当 改 变 索 引 pg_index 行 状 态 的 时 候 ， 修 复 CREATE INDEX CONCURRENTLY 以 使 用 适当 更 新 。 
这 可 以 防止 竞争 条 件 ， 它 可 以 导致 并 发 会 话 错 过 更 新 目标 索引 ， 从 而 造成 损坏 同时 创建 
索引 。 


此 外 ， 修 复 其 他 各 种 操作 以 确保 他 们 忽视 由 失败 cREATE INDEX CONCURRENTLY 导致 的 无 效 
索引 。 最 重要 的 是 ， 这 些 是 vacum, AA 在 该 表 上 采取 纠正 措施 以 修复 或 者 删除 无 效 
索引 之 前 自动 清理 很 容易 被 发 动 。 


。 当 内 存 不 足 的 时 候 ， 避 免 内 部 哈 希 表 的 损坏 (Hitoshi Harada) 
。 修复 外 部 连接 上 非 严 格 等 价 子 句 的 规划 (Tom Lane) 


规划 器 可 以 从 子 句 等 同 于 非 严 格 结构 中 别 的 方面 获取 不 正确 限制 ， 比 
如 WHERE COALESCE(foo, 0) = 0 当 foo 来 自 外 部 链接 的 空 侧 端 时 。 


。 完善 规划 器 来 自 等 价 类 排除 约束 能 力 (Tom Lane) 
。 修复 散 列 子 查询 中 部 分 行 匹配 以 正确 处 理 交 叉 类 型 情况 (Tom Lane) 


这 影响 了 多 列 not IN 子 计 划 ， 比 如 whERE (a, b) NOT IN (SELECT x, y FROM...) 。 当 比 


A o 和 y 分别 为 int4 和 ints 的 时 候 。 这 个 错误 导致 了 错误 结果 或 者 依赖 于 涉及 到 的 
特定 数据 类 型 的 崩溃 。 


“44 AFTER ROW UPDATE/DELETE 触发 器 重新 读 取 旧 元 组 的 时 候 ， 获取 缓冲 锁 (Andres 
Freund) 


在 非常 特殊 的 情况 下 ， 这 种 疏忽 可 能 导致 传递 不 正确 的 数据 来 预 检 查 外 键 执 行 触发 器 逮 
辑 。 这 可 能 会 导致 系统 崩溃 ， 或 者 关于 是 否 触发 触发 器 的 一 个 不 正确 的 决定 。 


修复 REASSIGN owNED 以 处 理 在 表 空 间 上 的 授权 (Alvaro Herrera) 
为 视图 上 系统 列 忽略 不 正确 pg_attribute 项 (Tom Lane) 


视图 没有 任何 系统 列 。 但 是 ， 当 转换 表 到 视图 时 ， 我 们 忘 了 删除 这 些 项 。 这 在 9.3 及 更 高 
版 本 中 被 正确 修复 ， 但 在 以 往 的 分 支 中 我 们 需要 防御 现 有 错误 转换 视图 。 


修复 规则 输出 以 正确 备份 INSERT INTO _table_ DEFAULT VALUES(Tom Lane) 

当 在 查询 中 有 许多 UNION / INTERSECT / except 子 句 的 时 候 ， 防止 堆栈 浴 出 (Tom Lane) 
当 最 小 可 能 整数 值 除 以 -1 的 时 候 ， 避 免 平台 依赖 错误 (Xi Wang, Tom Lane) 

修复 日 期 解析 中 可 能 访问 字符 串 结束 端 (Hitoshi Harada) 


如 果 Unix 域 套 接 字 路 径 名 长 度 超过 指定 平台 限制 ， 那 么 产生 可 理解 错误 消息 (Tom Lane, 
Andrew Dunstan) 


之 前 ， 这 可 能 导致 一 些 无 用 的 东西 ， 比 如 "域名 解析 中 不 可 恢复 故障 "。 

当 发 送 复合 列 值 到 客户 端的 时 候 ， 修 复 内 存 泄露 (Tom Lane) 

采取 pg _ctl 使 得 读 取 postmaster.pid 文件 更 加 重 棒 性 (Heikki Linnakangas) 
修复 竞争 条 件 和 可 能 文件 描述 符 泄露 。 


如 果 给 定 错 误 编码 数据 ， 并 且 client_encoding 设置 是 客户 端 编码 ， 比 如 SJIS， 修复 psql 
rh a) BE AAS (Jiang Guiqing) 


修复 在 tar 输出 格式 中 通过 pg_dump 发 出 的 restore.sql 脚本 中 错误 (Tom Lane) 


该 脚本 可 能 在 名 字 包 含 大 小 写字 母 的 表 中 完全 失败 。 同时 ， 使 得 该 脚本 可 以 恢 
复 --inserts 模式 以 及 规则 COPY 模 式 中 的 数据 。 


修复 pg_restore 以 接受 符合 POSIX 标 准 的 tar 文件 (Brian Weaver, Tom Lane) 


pg_dump 的 tar 输出 模式 的 原 编码 产生 不 完全 符合 POSIX 标 准 的 文件 。 这 在 9.3 版 本 已 
得 到 纠正 。 该 补丁 更 新 之 前 的 分 支 ， 以 致 于 他 们 同时 接受 不 正确 和 校正 后 的 格式 ， 当 9.3 
出 版 的 时 候 ， 和 希望 避免 兼容 性 问题 。 


当 给 定 一 个 相对 路 径 到 数据 目 录 的 时 候 ， 修复 pg_resetxlog 以 正确 定位 postmaster .pid 
(Tom Lane) 


该 错误 可 能 导致 png_resetxlog 没 有 注意 到 有 一 个 使 用 数据 目录 的 活跃 postmaster。 


e 修复 libpq 的 lo_import() 和 lo_export() 加 数 以 正确 报告 文件 |/O 错 误 (Tom Lane) 
。 修复 谨 套 结构 指针 变量 的 ecpg 的 处 理 (Muhammad Usama) 
e 当 检 查 页 的 时 候 ， 使 得 contrib/pageinspect Mbtree 7 & WAKE EH 4K (Tom Lane) 
。 修复 pgxs 支 持 在 AIX 上 建立 可 加 载 模块 (Tom Lane) 
在 原始 树 外 部 建构 模块 无 法 在 AIX 上 运行 。 


e 为 了 Cuba, Israel, Jordan, Libya, Palestine, Western Samoa 以 及 Brazil 部 分 中 DST 变 化 
更 新 时 区 数据 文件 到 tzdata 发 布 2012j。 


E.56. 发 布 8.3.21 


发 布 日 期 : 2012-09-24 
该 发 布 包含 来 自 8.3.20 中 各 种 修复 。 关 于 8.3 主 要 发 布 中 新 特性 信息 ， 参阅 Section E.77。 


PostgreSQL 社 区 在 2013 年 2 月 为 8.3.X 发 布 系列 停止 发 布 更 新 。 鼓励 用 户 尽快 更 新 到 新 版 本 分 
支 。 


E.56.1. 迁移 版 本 8.3.21 


运行 8.3.X 不 需要 各 份 /恢复 。 
然而 ， 如 果 从 8.3.17 更 早上 版 本 更 新 ， 参 阅 8.3.17 发 布 说 明 。 


E.56.2. %14k 


。 提高 GiST 索 引 中 页 分 离 决 定 (Alexander Korotkov,Robert Haas, Tom Lane) 


多 列 GiST 索 引 可 能 遭受 到 意 想 不 到 的 膨胀 ， 由 于 这 个 错误 。 


。 如 果 仍 然 持 有 权限 ， 那 么 修复 级 联 权限 撤销 中 断 (Tom Lane) 
如 果 我 们 从 某 个 角色 x 中 撤销 授权 选项 ， 但 x 仍然 持 有 通过 从 其 它 人 授权 的 选项 ， 


否则 ， 我 们 不 应 该 递归 撤销 从 x 授予 它 的 角色 (s) _y 的 相应 权限 。 
e 当 PL/Perl 在 使 用 中 的 时 候 ， 修 复 srt6FPE 的 处 理 (Andres Freund) 


Perl 重 冒进 程 的 srI6FPE 处 理 器 到 srt6_I6N ， 这 可 能 会 随后 导致 崩溃 。 在 初始 化 PL/Perl 
之 后 恢复 正常 的 Postgres 信 号 义理 器 。 


。 如 果 重 新 定义 北 为 PL/Perl 辑 数 而 被 执行 ， 避 免 PL/Perl 朋 渍 (Tom Lane) 
o 解决 PL/Perl 中 可 能 的 失败 最 佳 化 (Tom Lane) 


一 些 Linux 发 行 版 包含 导致 PL/Perl 中 不 正确 编译 代码 的 pthread.h 不 正确 的 版 本 ， 如 果 
PL/Perl 范 数 调用 抛 出 错误 的 另外 一 个 ， 那 么 导致 月 渍 。 


e 为 Fiji 中 DST 变 化 更 新 时 区 数据 文件 到 tzdata 发 布 2012f。 


E.57. 发 布 8.3.20 


发 布 日 期 : 2012-08-17 
该 发 布 包含 来 自 8.3.19 各 种 修复 ， 关 于 8.3 主 要 发 布 中 新 特性 信息 ， 参阅 Section E.77。 


PostgreSQL 社 区 在 2013 年 2 月 为 8.3.X 发 布 系列 停止 发 布 更 新 。 鼓励 用 户 尽快 更 新 到 新 版 本 分 
支 。 


E.57.1. 迁移 到 版 本 8.3.20 


运行 8.3.X 不 需要 各 份 /恢复 。 
然而 ， 如 果 从 8.3.17 更 早上 版 本 更 新 ， 参 阅 8.3.17 发 布 说 明 。 


E.57.2. 变化 


。 防止 通过 XML 实 体 引 用 访问 外 部 文件 /URL(Noah Misch, Tom Lane) 


xml_parse() 会 试图 获取 外 部 文件 或 作为 需要 解决 DTD 和 XML 值 中 实体 引用 的 URL， 从 
而 使 未 经 授权 的 数据 库 用 户 试图 获取 带 有 数据 库 服务 器 权限 的 数据 。 当 外 部 数据 不 会 直 
接 返 回 给 用 户 的 时 候 ， 它 的 部 分 可 以 暴露 在 错误 信息 中 ， 如 果 数 据 没有 解析 为 有 效 的 
XML; 并 且 在 任何 情况 下 检查 文件 存在 的 单纯 能 力 可 能 对 攻击 者 有 用 。 


避免 通过 contrib/xml2 的 xslt_process() 访问 外 部 文件 /URL(Peter Eisentraut) 


libxslt 提 供 了 通过 样式 表 命 全 文件 和 URL 读 取 和 写 入 能 力 ， 从 而 使 未 经 授权 的 数据 库 用 户 
读 取 和 写 入 具有 数据 库 服务 器 的 权限 数据 。 禁用 正确 使 用 libxslt 的 安全 选项 。(CVE- 
2012-3488) 


IEA, MIRR xslt_process() 从 外 部 文件 /URL 中 获取 文件 和 样式 表 。 当 这 是 一 个 记录 " 特 
性 "的 时 候 ， 长 期 被 视 为 一 个 坏 主意 。 为 CVE-2012-3489 的 修复 中 断 这 种 能 力 ， 而 非 耗 费 
精力 试图 修复 它 ， 我 们 只 是 简单 将 其 删除 。 


防止 过 早 回收 利用 btree 索 引 页 (Noah Misch) 


当 我 们 允许 只 读 事 务 跳 过 指定 XID 的 时 候 ， 我 们 引入 一 种 可 能 性 即 一 个 已 删除 btree 页 可 
能 被 循环 利用 ， 而 只 读 事务 还 在 运行 中 。 这 会 导致 不 正确 的 索引 搜索 结果 。 发 生 在 该 字 
段 中 这 种 错误 的 可 能 性 似乎 非常 低 ， 因为 定时 要 求 ， 但 尽管 如 此 它 应 该 被 修复 。 


。 修复 新 创建 或 者 重 置 序列 的 月 渍 安全 错误 (Tom Lane) 


如 果 ALTER SEQUENCE 在 新 创建 或 重 置 序列 中 被 执行 ， 然后 精确 执行 nextval() 调用 ， 之 
后 服务 器 崩溃 ，WAL 重 播 将 恢复 序列 到 一 个 状态 ， 它 似乎 没有 nextval() 被 完成 ， 因此 
允许 第 一 个 序列 值 通过 下 一 个 nextval() 调用 再 次 被 返回 。 特别 是 ， 这 可 能 表现 

为 serial 列 ， 因为 串 行 列 的 序列 的 创建 包括 ALTER SEQUENCE OWNED BY 473%, 


确保 backup_label 文件 在 pg_start_backup() 之 后 是 fsync 的 (Dave Kerr) 

回 到 补丁 9.1 改 进 以 压缩 fsSync 请 求 队列 (Robert Haas) 

这 提高 了 检查 点 期 间 性 能 。9.1 变 化 已 经 有 足够 字段 测试 对 于 备份 补丁 是 安全 的 。 
仅仅 人 允许 autovacuum 通 过 直接 阻 断 进程 被 自动 取消 (Tom Lane) 


原 编码 可 能 允许 某 些 情况 下 不 一 致 操作 ; 尤其 是 ，autovacuum 在 小 于 deadlock_timeout 
宽 限 期 后 可 能 被 取消 。 


提高 autovacuum 取 消 的 记录 (Robert Haas) 


修复 日 志 收 集 器 以 致 于 服务 器 启动 后 第 一 个 日 志 循 环 期 间 log_truncate_on_rotation 可 以 
运行 (Tom Lane) 


确保 子 查询 的 整 行 引 用 不 包含 任何 额外 的 croup BY 或 者 oRDER BY 列 (Tom Lane) 
不 允许 cHEck 限制 中 拷贝 整 行 引用 以 及 create TABLE 中 索引 定义 (Tom Lane) 


这 种 情况 可 以 产生 于 具有 LIkE 或 者 INHERITS 的 create TABLE 中 。 拷贝 的 整个 行 变量 被 
错误 地 标记 为 原 表 的 行 类 型 不 是 新 的 。 拒绝 该 种 情况 对 LIKE 似乎 是 合理 的 ， 因为 该 行 
类 型 很 可 能 之 后 存在 分 歧 ， 为 INHERITS 我 们 理论 上 允许 它 ， 带 有 隐 含 强制 父 表 行 类 型 ; 
但 是 这 上 比 似乎 安全 的 备份 补丁 需要 更 多 的 工作 。 


修复 ARRAY(SELECT ...) 子 查询 中 内 存 泄露 (Heikki Linnakangas, Tom Lane) 
修复 从 正则 表达 式 中 常见 前 级 的 提取 (Tom Lane) 


该 代码 可 以 通过 量化 括号 子 表 达 式 被 混淆 ， 上 比如 ^(foo)?bar o 这 可 能 导致 搜索 这 种 模式 
的 不 正确 索引 优化 。 


正确 报告 contrib/xm12 的 xslt_process() 中 的 错误 (Tom Lane) 


为 Morocco 和 Tokelau 中 DST 变 化 更 新 时 区 数据 文件 到 tzdata 发 布 2012e。 


E.58. 发 布 8.3.19 


发 布 日 期 : 2012-06-04 


该 发 布 包含 来 自 8.3.18 各 种 修复 ， 关 于 8.3 主 要 发 布 中 新 特性 信息 ， 参阅 Section E.77。 


E.58.1. 迁移 到 版 本 8.3.19 


运行 8.3.X 不 需要 各 份 /恢复 。 


然而 ， 如 果 从 8.3.17 更 早 版 本 更 新 ， 参 阅 8.3.17 发 布 说 明 。 


E.58.2. 变化 


e 修复 contrib/pgcrypto 的 DES crypt() BAH 不 正确 密码 转换 (Solar Designer) 


如 果 密 码 字符 串 包 含 字 节 值 ex8e ， 密码 的 剩余 部 分 被 忽略 ， 从 而 导致 该 密码 比 它 出 现 
的 更 弱 。 有 了 该 修复 ， 字 符 串 的 其 余部 分 被 正确 包含 在 DES 哈 希 中 。 任何 受 此 漏洞 影响 
的 存储 密码 值 将 因此 不 再 匹配 ， 所 以 存储 的 值 可 能 需要 被 更 新 。 


。 为 程序 语言 的 调用 人 处理 器 忽略 sEcuRITY DEFINER 和 set 属性 (Tom Lane) 

将 这 些 属性 应 用 到 调用 处 理 器 可 能 使 服务 器 崩溃 (CVE-2012-2655) 
e 人 允许 timestamp 输入 中 数字 时 区 偏 移 量 达 到 距离 UTC 16 小 时 (Tom Lane) 

一 些 历史 时 区 仿 移 量 超出 之 前 限制 15 小 时 。 这 可 能 导致 重 载 期 间 备份 数 据 值 被 拒绝 。 
。 当 给 定时 间 恰 好 是 当前 时 区 最 后 DST 过 渡 时 间 时 ， 修 复 时 间 戳 转换 义理 (Tom Lane) 


这 种 监督 已 经 很 长 时 间 了 ， 但 是 之 前 没有 注意 到 ， 因 为 大 部 分 DST 使 用 区 域 被 假定 具有 
未 来 DST 转 换 的 无 限 序 列 。 


e 修复 text 到 name 以 及 char 到 name 映射 用 来 在 多 字 节 编码 中 正确 执行 字符 串 截 断 
(Karl Schnaitter) 


e 修复 to_tsquery() 中 内 存 找 贝 错误 (Heikki Linnakangas) 
e 当 pg_attribute 比较 大 的 时 候 ， 修 复 缓慢 会 话 启动 (Tom Lane) 


如 果 pg_attribute 超出 shared_buffers 的 四 分 之 一 ， 在 会 话 启 动 期 间 需 要 缓存 重建 代码 
可 能 触发 同步 扫描 逻辑 。 导致 它 需 要 比 正常 长 好 几 倍 的 时 间 。 如 果 立 刻 启 动 许多 新 会 
话 ， 问 题 尤其 严重 。 


确保 顺序 扫描 合理 检查 查询 取消 (Merlin Moncure) 
包含 非 活路 元 组 的 许多 连续 页 扫描 不 会 相应 中 断 。 


确保 PGSemaphoreLock() 的 Windows 实 现在 返回 前 清理 ImmediateInterruptok (Tom Lane) 


该 足 忽 意 味 着 在 相同 的 查询 之 后 收 到 的 查询 取消 中 断 可 以 在 一 个 不 安全 的 时 刻 被 接受 ， 
具有 不 可 预测 性 ， 但 没有 好 的 结果 。 


当 输 出 视图 或 者 规则 的 时 候 ， 安 全 显示 整 行 变 量 (Abbas Butt, Tom Lane) 


涉及 模糊 名 字 〈 也 就 是 说 ， 这 个 名 字 可 以 是 表 或 者 查询 的 列 名 字 ) 的 情况 以 模糊 方式 被 
输出 ， 存在 风险 是 视图 或 者 规则 在 备份 或 者 重 载 之 后 可 能 被 不 同 地 解释 。 通过 附加 非 空 
操作 转换 避免 模糊 情况 。 


确保 autovacuum 工 作 进 程 正确 执行 堆栈 深度 检查 (Heikki Linnakangas) 
之 前 ， 通 过 自动 ANALYzE 激发 的 范 数 中 无 限 递 为 可 能 使 得 工作 进程 朋 涡 。 
修复 日 志 收 集 器 使 得 在 高 负载 下 不 会 丢失 日 志 一 致 性 (Andrew Dunstan) 
如 果 它 比较 繁忙 ， 该 收集 器 之 前 可 能 无 法 重新 分 配 大 信息 。 

修复 日 志 收 集 器 以 确保 它 在 收 到 SIGHUP 之 后 重启 文件 循环 (Tom Lane) 


当 该 目标 是 函数 的 第 一 个 变量 的 时 候 ， 修复 PL/pgSQL 的 cet pIAGNOsTICS 命令 (Tom 
Lane) 


当 数 据 库 包含 多 个 对 象 的 时 候 ， 修 复 pg_dump 中 若干 个 性 能 问题 (Jeff Janes, Tom Lane) 


如 果 数 据 库 包含 许多 模式 ， 或 者 如 果 许 多 对 象 在 依赖 循环 中 ， 或 者 如 果 有 许多 拥有 的 序 
列 ， 那么 pg_dump 可 能 会 很 慢 。 


修复 contrib/dblink 的 dblink_exec() 而 不 泄露 临时 数据 库 连接 错误 (Tom Lane) 


为 Antarctica, Armenia, Chile, Cuba, Falkland Islands, Gaza, Haiti, Hebron, Morocco, 
Syria 和 Tokelau Islands PDST # 1b Bat 时 区 数据 文件 到 tzdata 发 布 2012c ; 同时 为 
Canada 万 史 修 正 。 


E.59. 发 布 8.3.18 


发 布 日 期 : 2012-02-27 


该 发 布 包含 来 自 8.3.17 各 种 修复 。 关 于 8.3 主 要 发 布 中 新 特性 信息 ， 参阅 Section E.77。 


E.59.1. 迁移 到 版 本 8.3.18 


运行 8.3.X 不 需要 各 份 /恢复 。 


然而 ， 如 果 你 从 8.3.17 更 早 版 本 更 新 ， 人 参阅 8.3.17 发 布 说 明 。 


E.59.2. %14k 


为 CREATE TRIGGER 需要 触发 器 辑 数 执行 权限 (Robert Haas) 


这 种 缺失 检查 可 能 允许 其 他 用 户 执行 具有 虚假 输入 数据 的 触发 器 函数 ， 通过 所 拥有 的 表 
上 进行 安装 。 对 于 触发 器 事 数 标记 SECURITY DEFINER 是 有 意义 的 ， 因为 否则 作为 表 的 所 
BS ie (THAR SHR, 


转换 换行 到 写 入 pg_dump 中 名 字 中 的 空格 (Robert Haas) 


pg_dump 有 关 审 查 其 输出 脚本 中 SQL 注 释 中 发 出 的 对 象 名 称 是 不 说 愤 的 。 包含 新 行 的 名 
字 至 少 会 呈现 脚本 语法 不 正确 。 当 脚 本 被 重新 加 载 的 时 候 ， 悉 意 制作 的 对 象 名 称 可 以 提 
出 一 个 SQL 注 入 风险 。 


修复 来 自 清理 插入 中 的 btree 索 引 损 坏 (Tom Lane) 


插入 造成 的 索引 页 拆 分 有 时 可 能 会 导致 同时 运行 vacuum 错过 删除 它 应 该 删除 的 索引 项 。 
对 应 表 中 的 行 被 删除 后 ， 莽 空 索引 项 会 导致 错误 (如 "不 能 读 取 文件 块 N...") , RAR 
的 是 ， 错 误 查 询 结果 在 不 相关 行 之 后 重新 被 插入 到 已 释放 表 位 置 。 此 bug 已 自 8.2 版 本 中 
FE, 但 发 生 如 此 频繁 直到 现在 并 没有 被 诊断 。 如 果 您 有 理由 怀疑 它 出 现在 你 的 数据 库 
中 ， 重 新 索引 受 影响 的 索引 会 修复 该 问题 。 


允许 ALTER USER/DATABASE SET 中 一 些 设置 的 非 存在 值 (Heikki Linnakangas) 


允许 default_text_search_config , default_tablespace 和 temp_tablespaces 设置 为 那些 
不 知道 的 名 字 。 这 是 因为 它们 可 能 在 另 一 个 打算 使 用 该 设置 的 数据 库 中 是 已 知 的， 或 者 
表 空 间 中 ， 因为 该 表 空 间 可 能 尚未 被 创建 。 同 样 的 问题 之 前 公认 为 search_path ， 并 且 
这 些 设置 现在 像 那 一 个 。 


正确 跟踪 WAL 回 放 中 OID 计 数 器 ， 即 使 它 绕 回 (Tom Lane) 


之 前 的 OID 计 数 器 将 继续 保持 高 值 ， 直 到 系统 退出 重 放 模 式 。 实际 结果 通常 是 需 ， 但 是 
存在 这 种 情况 ， 其 中 备用 服务 器 被 提升 为 主 服务 器 可 能 需要 较 长 的 时 间 推进 OID 计 数 器 
到 一 个 合理 的 值 ， 一 旦 需要 该 值 的 时 候 。 


修复 附加 * 的 正则 表达 式 反 向 引用 (Tom Lane) 


不 是 强制 执行 精确 字符 串 匹 配 ， 代码 将 有 效 地 接受 任何 满足 引用 反 向 引用 符号 的 模式 子 
表达 式 的 字符 串 。 


类 似 的 问题 仍然 困扰 艇 入 到 较 大 量化 表达 式 中 的 反 向 引用 ， 而 不 是 量词 的 直接 主题 。 这 
将 在 未 来 的 PostgreSQL 版 本 中 得 到 解决 。 


修复 在 处 理 inet / cidr 值 中 最 近 引 入 的 内 存 泄 漏 (Heikki Linnakangas) 


在 2011 年 12 月 发 布 PostgreSQL 补 丁 导 致 操作 中 内 存 泄漏 ， 这 可 能 在 下 面 情况 中 非常 重 
要 ， 上 比如 在 这 样 的 列 中 构建 btree 索 引 。 


避免 Windows 上 syslogger 中 文件 句柄 的 双关 闭 (MauMau) 

通常 这 种 错误 是 不 可 见 的 ， 但 是 当 运 行 Windows 的 调试 版 本 时 ， 它 可 能 会 导致 异常 。 
修复 plpgsql 中 MO 转换 相关 内 存 泄露 (Andres Freund, Jan Urbanski, Tom Lane) 

某 些 操作 可 能 会 造成 内 存 泄漏 ， 直 到 当前 函数 结束 。 

提高 继承 表 列 的 pg_dump 处 理 (Tom Lane) 


pg_dump 你 理 不 当 的 情况 下 ， 子 列 比 其 父 列 有 不 同 的 缺 省 表达 式 。 如 果 缺 省 等 同 于 父 缺 
省 ， 但 实际 上 并 不 是 相同 的 (上 比如 ， 因 为 模式 搜索 路 径 差 异 ) ， 它 可 能 不 会 被 识别 为 不 
同 的 ， 以 便 转 储 之 后 恢复 子 列 可 能 被 允许 继承 父 缺 省 。 子 列 是 NoT NuULL ， 其 中 父 列 不 是 
的 也 可 以 错误 地 被 恢复 。 


为 INSERT 形 式 表 数据 修复 pg_restore 指 向 数据 库 模式 (Tom Lane) 


当 使 用 发 布 日 期 为 9 月 或 2011 年 12 月 份 的 pg_restore 的 时 候 ， 直接 到 数据 库 从 采 
用 --inserts 或 者 --column-inserts 选项 的 轨 档 文件 恢复 失败 。 作为 另 一 | 问题 修复 的 
监督 结果 。 为 档 文 件 本 身 没有 过 错 ， 而 且 文 本 模式 输出 是 好 的 。 


修复 contrib/intarray 'S int[] & int[] 操作 符 中 的 错误 (Guillaume Lelarge) 


如 果 最 小 整数 的 两 个 输入 数组 的 共同 点 是 1， 并 且 在 任何 数组 中 有 较 小 的 值 ， 那么 1 将 被 
错误 地 从 结果 中 忽略 。 


修复 contrib/pgcrypto BY encrypt_iv() 和 decrypt_iv() 中 的 错误 令 测 (Marko Kreen) 
这 些 函 数 没有 报告 无 效 输入 错误 的 一 些 类 型 ， 而 是 返回 不 正确 输入 的 随机 的 垃圾 值 。 


修复 contrib/test_parser 中 一 个 字 节 缓冲 区 浴 出 (Paul Guyot) 


该 代码 试图 读 取 一 个 比 它 应 该 更 多 的 字 节 ， 在 极端 情况 中 可 能 崩溃 。 由 
于 contrib/test_parser 只 是 示例 代码 ， 这 本 身 并 不 是 一 个 安全 问题 ， 但 糟糕 的 示例 代码 
仍然 很 糟糕 。 


如 果 可 用 ， 在 ARM 上 为 自 旋 锁 使 用 _sync_lock_test_and_set() (Martin Pitt) 





这 个 函数 替代 了 我 们 先前 使 用 的 swpe HED, CRAT, 并 且 在 ARMv6 及 更 高 版 本 中 
不 可 用 。 报 告 表明 旧 的 代码 在 最 近 的 ARM 上 以 明显 的 方式 执行 ， 但 根本 没有 互 锁 并 发 访 
问 ， 导 致 多 进程 操作 离奇 故障 。 


当 使 用 接受 它 的 gcc 版 本 构建 的 时 候 ， 使 用 -fexcess-precision=standard 选项 (Andrew 
Dunstan) 


这 可 以 防止 各 类 情况 ， 其 中 最 近 的 gcc 版 本 将 产生 创造 性 结果 。 
允许 FreeBSD 上 线程 Python 的 使 用 (Chris Rees) 


我 们 的 配置 脚本 之 前 认为 这 个 组 合 不 会 正常 工作 ; 但 FreeBSD 解 决 了 这 一 问题 ， 所 以 删 
除 错误 检查 。 


E.60. 发 布 8.3.17 


发 布 日 期 : 2011-12-05 


该 发 布 包含 来 自 8.3.16 中 各 种 修复 。 关 于 8.3 主 要 发 布 中 新 特性 信息 ， 参阅 Section E.77。 


E.60.1. 迁移 到 版 本 8.3.17 


运行 8.3.X 不 需要 各 份 /恢复 。 


然而 ， 在 information_schema.referential constraints 视图 中 发 现 长 期 的 错误 。 如 果 你 依赖 
于 该 视图 中 正确 的 结果 ， 那 么 你 应 该 像 下 面 第 一 个 更 新 日 志 项 解释 的 来 代替 它 的 定义 。 


另外 ， 如 果 你 从 8.3.8 更 早 版 本 更 新 ， 参 阅 8.3.8 发 布 说 明 。 


E.60.2. %14k 


ISS information_schema.referential constraints 视图 中 错误 (Tom Lane) 


该 视图 关于 外 键 约束 匹配 依赖 主 或 者 唯一 键 约束 是 不 够 谨慎 的 ， 这 可 能 导致 无 法 显示 外 
键 约束 ， 或 显示 它 多 次 ， 或 声称 它 取决 于 比 起 真正 的 一 个 不 同 的 约束 。 


由 于 视图 定义 是 由 initdb 安 装 ， 只 是 升级 不 会 解决 问题 。 如 果 您 需要 解决 现 有 的 安装 中 这 
个 问题 ， 您 可 以 (作为 超级 用 户 ) 删除 information_schema 模式 ， 然 后 通过 

_SHAREDIR_ /informationschema.sq/ 重 新 创建 它 。 (如 果 你 不 确定 

”SHAREDIJR 在 哪里 ， 去 行 bg_config --sharedir) 。 在 每 个 数据 库 中 肯定 重复 被 修复 。 


修复 CREATE TABLE dest AS SELECT * FROM src 或 
者 INSERT INTO dest SELECT * FROM src 中 TOAST 相 关 数 据 损坏 (Tom Lane) 


如 果 一 个 表 已 由 ALTER TABLE ADD coLumn 修改 ， 尝试 逐 宇 拷贝 其 数据 到 另 一 个 表 可 能 在 
某 些 极端 情况 中 产生 损坏 结果 。 这 个 问题 只 能 体现 在 8.4 及 更 高 版 本 中 的 精确 形式 中 ， 

但 是 我 们 修补 早期 版 本 以 及 其 他 的 代码 路 径 中 可 能 会 引发 同样 的 错误 。 

修复 toast 表 访问 旧 的 syscache 项 中 的 竞争 条 件 (Tom Lane) 

典型 的 症状 是 类 似 "在 pg_toast 2619 中 toast 值 NNNNN 缺 少 块 号 0" 的 短暂 错误 ， 其 中 所 引 
用 的 toast 表 将 永远 属于 一 个 系统 目录 。 


让 DatumGetInetP() 解压 具有 1 字 节 头 的 inet 数 据 ， 并 添加 一 个 新 的 
ZÆ, DatumGetInetPP() 不 这 样 做 (Heikki Linnakangas) 


这 种 变化 不 会 影响 到 核心 代码 ， 但 可 能 会 阻止 附加 代码 预期 DatumGetInetP() 按 通 常 惯例 
产生 解压 缩 数 据 而 崩溃 。 


提高 money 类 型 输入 和 输出 中 的 区 域 支 持 (Tom Lane) 


除了 不 支持 所 有 标准 lc monetary 格式 选项 外 ， 输入 和 输出 范 数 是 不 一 致 的 ， 意味 着 有 
个 区 域 中 备份 的 money 值 不 能 被 重新 读 取 。 


不 要 让 transform null equals 影响 CASE foo WHEN NULL ... 结构 (Heikki Linnakangas) 


transform_null_equals 应 该 影响 由 用 户 直 接 写 入 的 foo = NULL 表达 式 ， 而 不 是 通 
过 CASE 形式 内 部 产生 的 平等 检查 。 


改变 外 键 触 发 器 创建 顺序 更 好 地 支持 自 参 考 外 键 (Tom Lane) 


对 于 级 联 外 键 引 用 自己 的 表 ， 行 更 新 将 触发 oN UPDATE 触发 器 和 check 触发 器 作为 一 个 
事件 。 oN UPDATE 触发 器 必须 先 执 行 ， 否则 check 将 检查 该 行 的 非 最 终 状 态 而 且 可 能 引 
发 不 当 的 错误 。 然而 ， 这 些 触 发 器 的 触发 顺序 由 其 名 字 确 定 ， 通常 按照 创建 顺序 进行 排 
Fe, 因为 触发 器 有 按照 约定 "RI_ConstraintTrigger_ NNNN" 自 动 生 成 的 名 字 。 一 个 适当 

的 修复 要 求 修改 该 约定 ， 我 们 将 在 9.2 中 执行 ， 但 在 现 有 版 本 中 改变 它 似乎 有 风险 。 所 

以 这 个 补丁 只 是 改变 了 触发 器 的 创建 顺序 。 用 户 遇 到 此 类 型 的 错误 要 删除 并 重新 创建 外 
键 约 束 使 得 触发 器 到 正确 的 顺序 。 


当 跟 踪 缓 冲 区 分 配 率 时 ， 避 人 免 浮 点 下 浴 (Greg Matthews) 

虽然 本 身 无 害 ， 在 某 些 平台 上 这 可 能 导致 恼人 的 内 核 日 志 信 息 。 

保留 psql 命 全 历史 中 空白 行 (Robert Haas) 

比如 ， 如 果 空 行 从 一 个 字符 串 中 被 删除 ， 前 者 操作 可 能 会 导致 问题 。 

修复 pg_dump 以 各 份 自动 生成 类 型 之 间 用 户 定义 的 映射 ， 比如 表 行 类 型 (Tom Lane) 


使 用 xsubpp 的 首选 版 本 构建 PL/Perl， 不 一 定 是 操作 系统 主 拷贝 (David Wheeler 和 Alex 
Hunsaker) 


修复 contrib/dict_int 和 contrib/dict_xsyn 中 不 正确 编码 (Tom Lane) 

一 些 函 数 错 误 假定 通过 palloc() 返回 的 内 存 是 规 。 

实现 pgstatindex() 中 查询 取消 及 时 中 断 (Robert Haas) 

确保 VPATH 构 造 正 确 安装 所 有 服务 器 头 文 件 (Peter Eisentraut) 

缩短 详细 错误 信息 中 报告 的 文件 名 (Peter Eisentraut) 

常规 构造 一 直 报 道 包 含 错误 信息 调用 的 C 文 件 名 字 ， 但 VPATH 构 造 之 前 报道 绝对 路 径 名 。 


修复 中 美洲 地 区 Windows 时 区 名 称 解释 (Tom Lane) 


映射 "Central America Standard Time" 到 cste ， 而 不 是 csT6cpT ， 因 为 在 中 美洲 任何 地 
方 通常 不 会 观察 到 DST。 


为 Brazil, Cuba, Fiji, Palestine, Russia 和 Samoa 更 新 时 区 数据 文件 到 tzdata 发 布 2011n ; 
同时 为 Alaska 和 British East Africa 历 史 修 正 。 


E.61. 发 布 8.3.16 


发 布 日 期 : 2011-09-26 


该 发 布 包含 来 自 8.3.15 中 各 种 修复 。 关 于 8.3 主 要 发 布 中 新 特性 信息 ， 参阅 Section E.77。 


E.61.1. 迁移 到 版 本 8.3.16 


运行 8.3.X 不 需要 各 份 /恢复 。 然 而 ， 如 果 从 8.3.8 更 早 版 本 更 新 ， 参阅 8.3.8 发 布 说 明 。 


E.61.2. 变化 


。 修复 存在 疑问 HOT 更 新 元 组 的 索引 中 错误 (Tom Lane) 
该 错误 导致 在 重新 索引 系统 目录 之 后 索引 损坏 。 他 们 不 认为 会 影响 用 户 索引 。 
。 修复 GiST 索 引 页 划分 处 理 中 多 个 错误 (Heikki Linnakangas) 
发 生 的 概率 很 低 ， 但 是 这 些 可 能 导致 索引 损坏 。 
e 修复 tsvector_concat() 中 可 能 的 缓冲 区 浴 出 (Tom Lane) 
该 图 数 可 能 低估 了 该 结果 需要 内 存量 ， 导 致 服务 器 崩溃 。 
e 当 处 理 "standalone" 参 数 的 时 候 ， 修 复 xml_recv AAR (Tom Lane) 
© 可 能 避免 ANALYZE 中 以 及 SJIS-2004 编 码 转 换 中 访问 内 存 结尾 (Noah Misch) 
这 修复 了 一 些 概 率 较 低 的 服务 器 崩溃 情况 。 
。 修复 relcache 初 始 文 件 失 效 中 竞 态 条 件 (Tom Lane) 


有 一 个 窗口 ， 其 中 一 个 新 的 后 端 进程 可 以 读 取 一 个 陈旧 的 启动 文件 ， 但 错过 了 可 能 告诉 
它 数据 是 陈旧 的 无 效 消 息 。 其 结果 在 目录 访问 中 可 能 是 古怪 错误 ， 通 常 在 启动 过 程 之 
后 "无 法 读 取 文 件 中 块 0.…。 


。 修复 GiST 索 引 打 描 结尾 内 存 泄露 (Tom Lane) 


执行 许多 单独 的 GiST 索 引 扫描 命 舍 ， 比 如 已 经 含有 许多 行 的 表 中 基于 排斥 约束 新 的 GiST 
验证 ， 由 于 该 泄露 ， 可 能 瞬时 需要 大 量 内 存 。 


。 当 构 建 大 的 ， 有 损耗 位 图 的 时 候 ， 修 复 性 能 问题 (Tom Lane) 


。 修复 数组 和 路 径 创 建 男 数 以 确保 填充 字 节 为 震 (Tom Lane) 


这 避免 了 规划 器 将 认为 语义 相同 常数 是 不 相等 的 ， 导 致 劣质 优化 。 
解决 打 断 WAL 回 放 gcc 4.6.0 错 误 (Tom Lane) 

在 服务 器 崩溃 后 这 可 能 导致 已 提交 事务 丢失 。 

为 视图 中 vatues 修复 备份 错误 (Tom Lane) 

不 允许 序列 上 SELECT FOR UPDATE/SHARE (Tom Lane) 

该 操作 不 能 像 预 期 那样 执行 ， 并 且 可 能 导致 错误 。 

当 计 算 哈 希 表 大 小 的 时 候 ， 防 御 整数 浴 出 (Tom Lane) 

修复 cLusTER 可 能 党 试 访问 已 删除 TOAST 数 据 的 情况 (Tom Lane) 
修复 为 "peer" 认 证 使 用 凭证 控制 信息 中 的 可 移植 错误 (Tom Lane) 
当 需 要 多 个 往返 时 ， 修 复 SSPI 登 录 (Ahmed Shinwari,Magnus Hagander) 
这 个 错误 典型 现象 是 在 SSPI 登 录 期 间 " 不 支持 函数 需求 "错误 。 
修复 pg_srand48 开始 初始 化 中 的 错误 (Andres Freund) 


这 导致 未 能 使 用 提供 了 种 子 的 所 有 位 。 这 个 画 数 在 大 多 数 平台 上 (只 有 那些 没 
有 srandom ) 没有 被 使 用 ， 并 且 暴 露 于 比 预 期 种 子 不 太 随机 的 潜在 安全 隐患 在 任何 情况 
下 似乎 很 小 。 


当 LIMIT 和 oFFseT 值 总 和 超过 2^63 的 时 候 ， 吕 免 整数 浴 出 (Heikki Linnakangas) 
添加 浴 出 检查 到 generate_series() 的 int4 和 ints 版 本 (Robert Haas) 

修复 to_char() 中 尾随 需 删 除 (Marti Raudsepp) 

在 Fm 格式 中 ， 小 数 点 后 没有 数字 位 置 ， 老 到 小 数 点 左边 可 能 错误 地 被 删除 。 
修复 pg_size_pretty() 避免 输入 接近 2^63 浴 出 (Tom Lane) 

在 pg_ctl 中 ， 为 Windows 上 服务 注册 支持 静止 模式 (MauMau) 

在 从 一 个 不 同文 件 进行 copy 期 间 修复 脚本 文件 行 的 psql 的 计算 (Tom Lane) 

为 standard_conforming_strings 修复 pg_restore 直 接 到 数据 库 模式 (Tom Lane) 


当 从 standard_conforming_strings 设置 为 on 的 当 档 文件 直接 恢复 到 数据 库 服务 器 时 ， 
pg_restore 可 能 会 发 出 不 正确 的 命令 。 


修复 写 缓 冲 结束 以 及 libpq 的 LDAP 服 务 查 找 代 码 中 的 内 存 泄露 (Albe Laurenz) 
在 libpq 中 ， 当 使 用 非 阻塞 VO 以 及 SSL 连 接 时 ， 避 免 错 误 (Martin Pihlak, Tom Lane) 


在 连接 启动 过 程 中 优化 错误 的 libpq 人 处 理 (Tom Lane) 


尤其 是 ， 在 SSL 连 接 启 动 过程 中 fork() 错误 的 服务 器 报告 回应 是 明智 的 。 
为 SSL 错 误 优 化 libpq 的 错误 报告 (Tom Lane) 

采用 ecpglib 书 写 带 有 15 位 精度 的 double 值 (Akira Kurosawa) 

在 ecpglib 中 ， 确 保 Lc_NuMERIC 设置 在 错误 之 后 被 恢复 (Michael Meskes) 
为 加 密 符号 字符 错误 (CVE-2011-2483) 请 求 上 游 修复 (Tom Lane) 


contrib/pg_crypto 的 加 密 代 码 可 能 给 定 错误 结果 ， 在 char 是 有 符号 平台 上 (这 是 大 多 数 
情况 ) ， 导致 加 密 密 码 比 他 们 应 该 的 更 弱 。 


修复 contrib/seg 中 内 存 泄 露 (Heikki Linnakangas) 

修复 pgstatindex() 为 空 索 引 给 定 一 致 结果 (Tom Lane) 

允许 使 用 perl 5.14 编 译 (Alex Hunsaker) 

为 探测 系统 函数 的 存在 更 新 配置 脚本 方法 (Tom Lane) 

在 8.3 和 8.2 中 使 用 的 autoconf 的 版 本 可 能 通过 执行 链接 时 优化 编译 器 被 蚌 弄 。 
修复 编译 和 安装 包含 空格 的 文件 路 径 的 各 种 错误 (Tom Lane) 


为 Canada, Egypt, Russia, Samoa 和 South Sudan 中 DST 变 化 更 新 时 区 数据 文件 到 tzdata 
发 布 2011i。 


E.62. 发 布 8.3.15 


发 布 日 期 : 2011-04-18 


该 发 布 包含 来 自 8.3.14 的 各 种 修复 。 关 于 8.3 主 要 发 布 新 特性 的 信息 ， 参阅 Section E.77。 


E.62.1. 迁移 到 版 本 8.3.15 


运行 8.3.X 不 需要 各 份 /恢复 。 然 而 ， 如 果 从 8.3.8 更 早 版 本 更 新 ， 参阅 8.3.8 发 布 说 明 。 


E.62.2. %14k 


不 允许 完全 包含 复合 类 型 (Tom Lane) 


当 处 理 复 合 类 型 的 时 候 ， 这 可 以 防止 服务 器 可 能 无 限 递 为 的 情况 。 虽然 有 可 能 用 于 这 样 
的 结构 ， 他 们 似乎 并 没有 足够 的 说 服 力 来 证 明 需 要 努力 确保 它 始 终 安全 工作 。 


在 目录 缓存 初始 化 期 间 避 免 潜在 死 锁 (Nikhil Sontakke) 


在 某 些 情况 下 ， 缓 存 加 载 代 码 将 在 锁定 索引 目录 之 前 系统 索引 上 获取 共享 锁 。 这 可 能 会 
死 锁 进程 试图 获取 其 他 排 它 锁 ， 以 更 标准 顺序 。 


当 有 一 个 并 发 更 新 到 目标 元 组 的 时 候 ， 修 复 BEFORE Row UPDATE 触发 器 义理 中 AEH y 
题 (Tom Lane) 


当 党 斌 执行 UPDATE RETURNING ctid 的 时 候 ， 该 错误 已 被 观察 导致 间歇 性 "不 能 提取 虚拟 
元 组 系统 属性 "故障 。 对 于 更 严重 错误 有 一 个 非常 小 的 概率 ， 比 如 为 更 新 元 组 产生 不 正确 
索引 项 。 


当 该 表 有 等 待 延 迟 触 发 器 事件 的 时 候 ， 不 允许 DRoP TABLE (Tom Lane) 
之 前 DROP 可 能 完成 ， 当 触发 器 被 最 终 触 发 的 时 候 ， 导致 "不 能 打开 带 有 OID nnn 的 天 


系 "错误 。 

修复 涉及 到 数组 片段 的 PL/Python 内 存 泄露 (Daniel Popowich) 

修复 pg_restore 以 处 理 TOC 文 件 中 长 行 (超过 1KB) (Tom Lane) 

采取 更 多 保障 措施 防止 崩溃 ， 由 于 使 用 编译 器 优化 除 以 需 (Aurelien Jarno) 
支持 在 MIPS 上 FreeBSD 和 OpenBSD 中 使 用 dlopen()(Tom Lane) 


有 一 个 硬 连 线 假设 该 系统 函数 不 可 用 在 这 些 系 统 上 的 MIPS 硬 件 上 。 相反 使 用 编译 时 间 测 
试 ， 因 为 更 多 新 版 本 拥有 它 。 


修复 HP-UX 上 编译 错误 (Heikki Linnakangas) 

修复 Windows 上 与 libintl 版 本 兼容 问题 (Hiroshi Inoue) 

修复 Windows 编 译 脚本 中 xcopy 的 用 法 以 便 在 Windows 7 中 正确 执行 (Andrew Dunstan) 
这 只 影响 编译 脚本 ， 而 不 是 安装 或 者 用 法 。 

在 Cygwin 上 通过 pg_regress 来 修复 路 径 分 隔 符 (Andrew Dunstan) 


为 了 Chile, Cuba, Falkland Islands, Morocco, Samoa 和 Turkey 中 DST 变 化 更 新 时 区 数据 
文件 到 tzdata 发 布 2011f ; 同时 为 了 South Australia, Alaska 和 Hawaii 历 史 修正 。 


E.63. 发 布 8.3.14 


发 布 日 期 : 2011-01-31 


该 发 布 包含 来 自 8.3.13 中 各 种 修复 。 关 于 8.3 主 要 发 布 中 新 特性 信息 ， 参阅 Section E.77。 


E.63.1. 迁移 到 版 本 8.3.14 


运行 8.3.X 不 需要 各 份 /恢复 。 然 而 ， 如 果 从 8.3.8 更 早 版 本 更 新 ， 参阅 8.3.8 发 布 说 明 。 


E.63.2. 变化 


e 当 EXPLAIN 党 试 显示 简单 形式 case 表达 式 的 时 候 ， 避免 错误 (Tom Lane) 


如 果 case 的 测试 表达 式 是 一 个 常量 ， 那 么 规划 器 可 以 简化 case 到 迷惑 表达 式 显 示 代 码 
的 一 种 形式 中 ， 导致 "意外 CASE WHEN 子 句 "错误 。 


。 修复 下 标 现 有 范围 之 前 数组 片段 的 分 配 (Tom Lane) 


如 果 在 新 添加 的 下 标 和 最 初 预先 存在 的 下 标 之 间 有 间隙 ， 那么 代码 误 算 需要 从 旧 数 组 空 
位 图 中 拷贝 多 少 项 ， 有 可 能 导致 数据 损坏 或 崩溃 。 


。 避免 规划 遥远 日 期 值 中 意外 转换 浴 出 (Tom Lane) 


date 类 型 支持 比 timestamp 类 型 表示 的 更 广泛 的 日 期 ， 但 规划 器 假定 它 可 能 总 是 转换 日 
期 到 timestamp。 


e 当 standard_conforming_strings 是 on 的 时 候 ， 修复 大 对 象 (BLOBs)pg_restore 的 文本 输 
出 (Tom Lane) 


虽然 直接 恢复 到 数据 库 正常 执行 ， 如 果 pg_restore 被 要 求 SQL 文本 输出 并 且 源 数据 库 中 
已 经 启用 standard_conforming_strings , 那么 字符 串 逃 避 是 不 正确 的 。 


。 修复 包含 ... & !(subexpression) | ... 的 tsquery 4 的 错误 解析 (Tom Lane) 


不 能 正确 执行 包含 操作 符合 并 的 查询 。 contrib/intarray 的 query_int 类 型 
和 contrib/ltree 的 1txtquery 类 型 中 存在 同样 的 错误 。 


e 为 query_int 类 型 修复 contrib/intarray 的 输入 画 数 中 的 缓冲 区 渝 出 (Apple) 


该 错误 是 一 个 安全 风险 ， 因 为 函数 的 返回 地 址 可 能 被 重 写 。 感 谢 Apple Inc 的 安全 团队 报 
告 这 个 问题 并 且 提 供 修复 (CVE-2010-4015) 


e 修复 contrib/seg 的 GiST picksplit 算 法 错误 (Alexander Korotkov) 


这 可 能 导致 效率 低下 ， 尽 管 不 是 真 的 错误 答案 ， 在 seg 列 的 GiST 索 引 中 。 如 果 你 有 一 个 
索引 ， 在 安装 这 个 更 新 之 后 考虑 REINDEX Eo (这 与 之 前 更 新 中 contrib/cube 中 修复 的 
错误 是 一 样 的 ) 


E.64. 发 布 8.3.13 


发 布 日 期 : 2010-12-16 


该 发 布 包含 来 自 8.3.12 的 各 种 修复 。 关 于 8.3 主 要 发 布 的 新 特性 信息 ， 参 阅 Section E.77。 


E.64.1. 迁移 到 版 本 8.3.13 


运行 8.3.X 不 需要 各 份 /恢复 。 然 而 ， 如 果 从 8.3.8 更 早 版 本 更 新 ， 参阅 8.3.8 发 布 说 明 。 


E.64.2. %14k 


e 强迫 缺 省 wal sync method 为 Linux 上 fdatasync (Tom Lane, Marti Raudsepp) 


Linux 上 的 缺 省 很 多 年 一 直 fdatasync ， 但 最 近 的 内 核 变 化 反而 引起 PostgreSQL 到 选 
择 open_datasync 。 这 一 选择 不 会 引起 任何 性 能 改进 ， 并 且 在 某 些 文件 系统 造成 彻底 的 
失败 ， 尤其 是 带 有 data=journal 安装 选项 的 ext4 。 


。 修复 GIN 索 引 WAL 回 放 逻 辑 中 各 种 错误 (Tom Lane) 

这 可 能 导致 "bad buffer id: 0" 错 误 或 者 复制 过 程 中 索引 内 容 的 损坏 。 
。 当 开 始 检查 点 WAL 记 录 不 在 同一 WAL 段 作为 重 做 点 ， 修 复 基 础 备份 恢复 (Jeff Davis) 
e 当 多 个 执行 者 长 时 间 保 持 活 跃 ， 修 复 autovacuum 持 久 延 迟 (Tom Lane) 


为 自动 清理 者 的 有 效 vacuum_cost_limit 可 能 会 删除 到 几乎 为 需 ， 如 果 它 处 理 了 足够 的 
表 ， 导 致 它 运 行 得 非常 慢 。 


添加 支持 检测 IA64 上 寄存 器 堆栈 浴 出 (Tom Lane) 
IA64 结构 有 两 个 硬件 堆栈 。 全 面 预防 堆栈 浴 出 错误 需要 检查 两 者 。 


添加 copyobject() 中 的 堆栈 浴 出 检查 (Tom Lane) 


某 些 代码 路 径 可 能 崩溃 ， 因 堆栈 浴 出 产生 一 个 足够 复杂 的 查询 。 


修复 临时 GiST 索 引 中 页 面 拆 分 检查 (Heikki Linnakangas) 


它 可 能 在 临时 索引 中 有 一 个 "并 发 "页 拆 分 ， 例 如， 当 揪 入 完成 的 时 候 ， 如 果 有 一 个 打开 
的 游标 打 描 索引 ， 当 游 标 继续 执行 的 时 候 ，GiST 未 能 检测 这 种 情况 ， 并 因此 可 能 提供 错 
误 的 结果 。 


e 当 ANALYZE 复杂 索引 表达 式 的 时 候 ， 避 免 内 存 泄露 (Tom Lane) 


确保 使 用 整 行 Var 的 索引 仍然 依赖 于 它 的 表 (Tom Lane) 

当 删 除 表 的 时 候 ， 声 明 像 create index i on t (foo(t.*)) 的 索引 可 能 不 会 自动 被 删除 。 
不 能 "内 联 "SQL 函 数 与 多 个 our 参数 (Tom Lane) 

这 避免 可 能 骨 溃 ， 由 于 关于 预期 结果 行 类 型 信息 缺失 。 


如 果 ORDER BY , LIMIT, FOR UPDATE 或 者 WITH 附属 于 
INSERT ... VALUES 的 vALuES 部 分 ， 则 操作 正确 (Tom Lane) 


修复 coALEScE() 表达 式 的 常数 合并 (Tom Lane) 
规划 器 可 能 有 时 尝试 评估 实际 上 可 能 找 不 到 的 子 表达 式 ， 可 能 导致 意外 错误 。 


当 和 连接 尝试 ( accept() 或 者 它 之 后 立即 调用 ) 失败 时 ， postmaster 与 GSSAPI 支 持 一 起 
编译 (Alexander Chernikov) 


当 log_temp_files 是 活跃 的， 修复 临时 文件 的 忽略 断 开 (Tom Lane) 


当 尝试 发 出 日 志 信息 的 时 候 ， 如 果 发 生 错误 ， 那 么 删除 链接 不 执行 ， 导 致 临时 文件 积 
Ro 


添加 InhRelation 节点 输出 功能 (Tom Lane) 

当 激 活 debug_print_parse ， 并 且 执 行 某 种 类 型 查询 的 时 候 ， 避 免 错 误 。 

修复 从 一 个 点 到 一 个 水 平 线段 不 正确 计算 (Tom Lane) 

该 错误 影响 了 若干 个 不 同 几 何 距 离 测量 操作 符 。 

修复 "simple" 表 达 式 的 PL/pgSQL 处 理 可 以 在 递归 或 者 错误 恢复 情况 中 执行 (Tom Lane) 
修复 集合 返回 范 数 的 PL/Python 的 处 理 (Jan Urbanski) 

在 迭代 器 产生 一 组 结果 中 尝试 调用 SPI 范 数 可 能 失败 。 

修复 contrip/cube 的 GiST picksplit 算 法 中 的 错误 (Alexander Korotkov) 


这 可 能 会 导致 相当 大 的 效率 低下 ， 但 实际 上 并 不 是 错误 结论 ， 在 GiST 索 引 cube 列 中 。 
如 果 你 有 这 样 一 个 索引 ， 考 虑 在 安装 此 更 新 后 REINDEX 它 。 


不 能 发 出 contrib/dblink 中 "标识 符 被 截断 "注意 事项 ， 除 非 当 创建 新 链接 的 时 候 (ltagaki 
Takahiro) 


修复 contrib/pgcrypto 中 关于 丢失 公 钥 上 潜在 核心 转 储 (Marti Raudsepp) 
修复 contrib/xm12 的 XPath 查 询 男 数 中 的 内 存 泄露 (Tom Lane) 


为 了 Fii 和 Samoa 中 DST 变 化 更 新 时 区 数据 文件 到 tzdata 发 布 2010o ; 同时 为 了 Hong 
Kong 历史 修正 。 
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E.65. 发 布 8.3.12 


发 布 日 期 : 2010-10-04 


该 发 布 包含 来 自 8.3.11 的 各 种 修复 。 关于 8.3 主 要 发 布 的 新 特性 信息 ， 参 阅 Section E.77。 


E.65.1. 迁移 到 版 本 8.3.12 


为 运行 8.3.X 不 需要 各 份 /恢复 。 然 而 ， 如 果 从 8.3.8 更 早 版 本 更 新 ， 参阅 8.3.8 发 布 说 明 。 


E.65.2. %14k 


e 为 PL/Per|/ 和 PL/Tcl 中 每 个 调用 SQL userid 使 用 单独 解析 器 (Tom Lane) 


这 种 变化 可 以 防止 通过 映 覆 在 同一 会 话 下 另 一 个 SQL 用 户 身 份 执行 的 ( 例 

如 ， SECURITY DEFINER EAA) Perl 或 Tcl 的 代码 引起 的 安全 问题 。 大 多 数 的 脚本 语言 提 
供 可 以 执行 的 多 种 方式 ， 上 比如 重新 定义 通过 目标 加 数 调 用 的 标准 函数 或 操作 符 。 如 果 没 
有 这 些 变化 ， 使 用 Penl 或 Tel 语言 使 用 权 的 任何 SQL 用 户 本 质 上 可 以 执行 目标 男 数 所 有 者 
的 SQL 权限 。 


这 种 变化 的 成 本 是 在 Perl 和 Tcl 函 数 之 间 有 意 通 讯 变 得 更 加 困难 。 为 了 提供 一 个 安全 出 
O, PL/PerlU#0PL/TclURMakeePASShAic hei. 没有 考虑 安全 问题 ， 因 为 所 有 
这 些 函 数 在 数据 库 超级 用 户 的 信任 级 别 中 执行 。 


这 很 可 能 是 第 三 方 的 程序 语言 ， 声 称 可 以 提供 可 信 认 执行 程序 也 有 类 似 的 安全 问题 。 我 
们 建议 您 联系 依赖 于 安全 关键 目的 的 任何 PL 作 者 。 


我 们 非常 感谢 Tim Bunce 指 出 这 题 (CVE-2010-3433) 


e。 避免 在 pg_get_expr() 中 通过 禁用 它 打算 用 于 不 是 系统 目录 列 中 的 参数 的 可 能 骨 溃 
(Heikki Linnakangas, Tom Lane) 


o 把 退出 代码 128( ERROR_WAIT_NO_CHILDREN ) 作 为 Windows 上 非 致命 的 (Magnus Hagander) 


在 高 负载 下 ，Windows 进 程 有 时 会 在 错误 代码 启动 时 失败 。 之 前 postmaster 将 这 个 看 作 
AMR, HABA ewe Se, 但 是 这 似乎 是 一 种 过 度 反 应 。 


修复 附加 索引 扫描 中 非 严 格 的 OR 连接 子 句 的 不 正确 用 法 (Tom Lane) 


这 是 在 8.3 分 支 中 丢失 的 8.4 修 复 的 一 个 补丁 。 这 纠正 了 8.3.8 中 引入 的 一 个 错误 ， 它 可 能 
导致 外 连接 不 正确 结果 ， 当 内 在 关系 是 继承 树 或 者 UNION ALL 子 查询 的 时 候 。 


e 修复 unio ALL 成 员 关 系 的 可 能 重复 打 描 (Tom Lane) 


修复 "不 能 处 理 非 计划 子 查询 "错误 (Tom Lane) 
当 子 选择 包含 扩展 到 包含 另 一 子 选择 的 表达 式 中 连接 别名 引用 的 时 候 发 生 。 
修复 该 错误 以 标记 缓存 计划 为 瞬时 的 (Tom Lane) 


如 果 已 准备 好 规划 ， 当 CREATE INDEX CONCURRENTLY 是 所 引用 表 中 之 一 ， 它 被 认为 是 重新 
规划 ， 一 旦 索引 准备 使 用 。 这 没有 发 生 。 


在 一 些 偶 然 报 告 的 btree 错 误 情况 中 减少 PANIC 到 ERROR， 并 且 提 供 错误 信息 的 更 多 细节 
(Tom Lane) 


这 可 能 优化 使 用 损坏 素 引 系统 鲁 棒 性 。 

防止 show_session_authorization() 在 autovacuum 进 程 中 崩溃 (Tom Lane) 
防御 函数 返回 setof 记 录 ， 其 中 并 非 所 有 返回 行 都 是 同一 行 类 型 (Tom Lane) 
SUBS ARMA RAR, 16S A) RE iR(Tao Ma, Tom Lane) 
优化 join 列 中 NULL 的 合并 连接 处 理 (Tom Lane) 

如 果 排 序 顺序 是 空 排 序 高 ， 那 么 合并 连接 完全 达到 第 一 个 空 时 停止 。 


当 写 它 们 的 时 候 ， 注 意 fsync 锁 文件 的 内 容 (包含 postmaster.pid 和 套 接 锁 文件 ) (Tom 
Lane) 


如 果 postmaster 和 启动 后 不 久 主机 崩溃 ， 这 种 忽略 可 能 会 导致 损坏 的 锁 文件 内 容 。 这 可 能 
反 过 来 防止 后 续 试图 随后 启动 postmaster， 直到 锁 文 件 被 手动 删除 。 


4 ACXIDEIASiREF SSA HMR, f% Ja(Andres Freund, Robert Haas) 

如 果 有 有 限 的 堆栈 空间 ， 那 么 原 代 码 可 能 导致 崩溃 。 

避免 在 walwriter 进 程 中 保持 打开 旧 的 WAL 段 (Magnus Hagander, Heikki Linnakangas) 
之 前 代码 可 能 阻止 删除 不 需要 段 。 

修复 log line_prefix 的 «i 逃逸 ， 这 可 能 在 后 端 启动 初期 产生 垃圾 (Tom Lane) 

当 所 动 归档 的 时 候 ， 修 复 ALTER TABLE ... SET TABLESPACE 中 可 能 的 数据 损坏 (Jeff Davis) 


人 允许 CREATE DATABASE 和 ALTER DATABASE ... SET TABLESPACE 通过 查询 取消 被 中 断 
(Guillaume Lelarge) 


修复 REASSIGN OWNED 以 处 理 操作 符 类 和 族 (Asko Tiidumaa) 
当 比 较 两 个 空 tsquery 值 的 时 候 ， 修 复 可 能 的 核心 转 储 (Tom Lane) 
修复 包含 x 伴随 _ 模式 的 LIKE 的 处 理 (Tom Lane) 


我 们 之 前 已 经 修复 这 个 问题 ， 但 是 仍然 有 一 些 不 正确 处 理 情况 。 


在 PL/Python 中 ， 防 止 来 自 pycobject_AsVoidPtr 和 pycobject_FromvoidPtr 空 指针 结果 
(Peter Eisentraut) 


使 得 psql 认 为 DIScARD ALL 作为 不 应 该 包含 在 autocommit-off 模 式 事务 块 中 的 命令 (ltagaki 
Takahiro) 


修复 ecpg 以 义理 正确 来 自 RETURNING 子 句 的 数据 (Michael Meskes) 
完善 包含 已 删除 列 的 表 的 contrib/dblink 的 处 理 (Tom Lane) 

修复 contrib/dblink 中 "重复 连接 名 "错误 后 的 连接 泄露 (ltagaki Takahiro) 
修复 contrib/dblink 以 正确 处 理 超过 62 字 节 的 连接 名 (ltagaki Takahiro) 
添加 hstore(text，text) KIE] contrib/hstore (Robert Haas) 


该 图 数 代 蔡 已 过 时 的 gt; 操作 符 。 它 打 补丁 以 便 未 来 代码 可 用 于 旧 的 服务 器 版 本 。 请 
注意 ， 该 补丁 在 contrip/hstore 被 安装 或 重新 安装 在 一 个 特定 的 数据 库 之 后 有 效 。 相反 


用 户 可 能 更 愿意 手动 执行 CREATE FUNCTION < 命令 >。 


更 新 编译 基础 设施 和 文档 以 反映 从 CVS 到 Git 迁 移 的 源 代 码 库 (Magnus Hagander and 
others) 


为 了 Egypt 和 Palestine 中 的 DST 变 化 更 新 时 区 数据 文件 到 tzdata 发 布 2010| ; 同时 为 了 
Finland 历 史 修正 。 


这 种 变化 还 增加 了 两 个 Micronesian 时 区 新 的 名 称 : Pacific/Chuuk 现 在 优 于 
Pacific/Truk 〈 并 且 首选 缩写 CHUT 而 非 TRUT) Pacific/Pohnpei 优 于 Pacific/Ponape。 


采用 Windows 的 "N. Central Asia 标 准时 间 " 时 区 映射 到 Asia/Novosibirsk， 而 不 是 
Asia/Almaty (Magnus Hagander) 


Microsoft 改 变 了 来 自 KB976098 时 区 更 新 中 该 时 区 的 DST 操 作 。 Asia/Novosibirsk 更 好 的 
匹配 它 的 新 操作 。 


E.66. 发 布 8.3.11 


发 布 日 期 : 2010-05-17 


该 发 布 包含 来 自 8.3.10 的 各 种 修复 。 关 于 8.3 主 要 发 布 中 新 特性 信息 ， 参阅 Section E.77。 


E.66.1. 迁移 到 版 本 8.3.11 


运行 8.3.X 不 需要 各 份 /恢复 。 然 而 ， 如 果 从 8.3.8 更 早 版 本 更 新 ， 参 阅 8.3.8 发 布 说 明 。 


E.66.2. # 1b 


在 plperl 中 使 用 用 于 整个 解释 器 的 opmask 强 制 限制 ， 而 不 是 使 用 safe.pm (Tim Bunce, 
Andrew Dunstan) 


最 近 发 展 使 我 们 确信 Safe .pm 太 不 安全 而 依靠 plperl o 此 变化 删除 了 safe.pm 的 使 

用 ， 有 利于 使 用 应 用 于 操作 掩 码 的 独立 解析 器 。 该 变化 的 副作用 包括 它 在 plperl 中 以 一 
种 自然 的 方式 使 用 Perl 的 strict 编译 是 可 能 的 。 并 且 Perl 的 sa 和 sb 变量 在 某 种 程序 
中 按 预期 执行 ， 而 且 辑 数 编译 显著 更 快 。 


防止 PL/Tcl 执 行 来 自 pltcl_modules 的 不 可 靠 代码 (Tom) 


从 一 个 数据 库 表 中 自动 加 载 的 Tcl 代 码 PL/Tcl 功 能 可 能 会 被 特洛伊 木马 攻击 利用 ， 因为 关 
于 谁 可 以 创建 或 者 插入 该 表 没 有 限制 。 这 种 变化 禁用 该 功能 ， 除 非 pltcl_modules 是 由 
超级 用 户 拥有 。 《但 是 ， 不 检查 表 上 的 权限 ， 真 正 需 要 一 个 低 于 安全 模块 表 这 样 的 安装 
仍然 可 以 给 予 适当 的 权限 到 值得 信赖 的 非 超 级 用 户 ) 。 另外 ， 防 止 代 码 加 载 到 非 限 
制 "normal" Tcl 解 释 器 ， 除 非 我 们 真 的 要 执行 pltclu BYR. (CVE-2010-1170) 


如 果 在 relcache 项 重建 过 程 中 收 到 缓存 重 置 信息 ， 那 么 修复 可 能 月 溃 (Heikki) 
当 修 复 了 相关 错误 时 ， 该 错误 被 引入 到 8.3.10 中 。 
当 为 了 该 图 数 运 行 语言 验证 器 的 时 人 息 ， 应 用 每 个 汞 数 GUC 设 置 (ltagaki Takahiro) 


这 就 避 鲍 了 失败 ， 如 果 该 图 数 的 代码 没有 设置 无 效 ; 一 个 例子 是 SQL 函 数 可 能 不 解析 ， 
如 果 search_path 是 不 正确 的 。 


不 允许 无 特权 用 户 重 置 超级 用 户 参 数 设置 (Alvaro) 


以 前 ， 如 果 一 个 非特 权 用 户 为 自身 运行 ALTER USER ... RESET aLL, 或 者 为 拥有 的 数据 
库 运 行 ALTER DATABASE ... RESET ALL, 这 将 为 用 户 或 数据 库 删 除 所 有 特殊 参数 设置 ， 
甚至 是 那些 只 应 该 由 超级 用 户 改 变 的 参数 。 现在 ， ALTER 将 只 删除 该 用 户 有 权限 改变 的 


当 context 附加 物 到 日 志 项 的 时 候 ， 如 果 发 生 关 机 ， 那 么 避免 后 台 关 机 期 间 可 能 朋 演 
(Tom) 


在 某 些 情况 中 上 下 文 输 出 画 数 可 能 失败 ， 因 为 当 输 出 日 志 信息 的 时 候 ， 当 前 事务 已 经 被 
回 滚 。 


确保 为 档 进 程 尽 可 能 快 地 响应 archive_command 中 变化 (Tom) 

为 现代 Perl 版 本 更 新 pl/perl 的 ppport.h (Andrew) 

修复 plpython 中 各 种 内 存 泄 露 (Andreas Freund, Tom) 

当 扩 展 指向 自身 的 一 个 变量 的 时 候 ， 避 免 psql 中 无 限 递 为 (Tom) 
修复 psql 的 \copy 在 \copy (select ...) 中 点 周围 不 添加 空格 (Tom) 
在 数字 文本 小 数 点 周围 添加 空格 可 能 导致 语法 错误 。 


为 使 用 contrib/intarray 操作 符 的 未 能 满足 的 查询 修复 不 必要 "GIN 索 引 不 支持 整个 索引 
扫描 "错误 (Tom) 


确保 contrib/pgstattuple 豆 数 做 出 反应 及 时 取消 中 断 (Tatsuhito Kasahara) 
使 得 服务 器 启动 正确 义理 为 已 存在 共享 内 存 段 使 得 shmget() 返回 erva 的 情况 (Tom) 


这 种 操作 已 在 BSD 派 生 内 核 包 括 OS X 中 被 观察 。 这 导致 了 一 个 完全 误导 启动 失败 ， 抱 怨 
共享 内 存 请 求 大 小 太 大 。 


避免 Windows 上 syslogger 过 程 中 可 能 崩溃 (Heikki) 
更 加 重 棒 性 处 理 Windows 注 册 表 中 不 完整 时 区 信息 (Magnus) 
更 新 已 知 的 Windows 时 区 名 字 设 置 (Magnus) 


为 Argentina, Australian Antarctic, Bangladesh, Mexico, Morocco, Pakistan, Palestine, 
Russia, Syria, Tunisia 中 DST 变 化 更 新 时 区 数据 文件 到 tzdata 发 布 2010j ; 同时 为 Taiwan 
历史 修正 。 


另外 ， 添 加 pxst (Pakistan Summer Time) 到 时 区 缩写 的 缺 省 设置 中 。 


E.67. 发 布 8.3.10 


发 布 日 期 : 2010-03-15 


该 发 布 包含 来 自 8.3.9 的 各 种 修复 。 关 于 8.3 主 要 发 布 中 新 特性 信息 ， 2y Section E.77。 


E.67.1. 迁移 到 版 本 8.3.10 


运行 8.3.X 不 需要 各 份 /恢复 。 然 而 ， 如 果 从 8.3.8 更 早 版 本 更 新 ， 参阅 8.3.8 发 布 说 明 。 


E.67.2. 变化 


添加 新 的 配置 参数 ssl_renegotiation_limit 以 控制 多 久 为 SSL 连 接 执行 会 话 密 钥 协商 
(Magnus) 


这 可 以 被 设置 为 需 ， 以 完全 禁用 重新 协商 ， 如 果 使 用 损坏 的 SSL 库 ， 这 可 能 是 必需 的 。 
特别 是 ， 一 些 供应 两 为 CVE-2009-3555 导 致 谈判 尝试 失败 传输 临时 补丁 。 


在 后 台 馈 动 期 间 修复 可 能 死 锁 (Tom) 

由 于 relcache 重 新 载 人 期间 不 完全 处 理 错误 ， 那 么 修复 可 能 月 溃 (Tom) 

由 于 荐 空 指 针 用 于 缓存 计划 中 ， 修 复 可 能 崩溃 (Tatsuo) 

当 试 图 从 子 事务 启动 中 故障 恢复 的 时 候 ， 修 复 可 能 骨 溃 (Tom) 

修复 与 使 用 保存 点 和 不 同 于 服务 器 编码 的 客户 端 编码 相关 的 服务 器 内 存 泄漏 (Tom) 
修复 GIST 索 引 页 拆 分 的 结束 恢复 清理 过 程 中 发 出 的 不 正确 WAL 数 据 (Yoichi Hirai) 


如 果 在 已 经 完成 一 个 不 完整 GIST 插 和 人 后 结束 恢复 清理 期 间 不 够 幸运 而 发 生 有 崩溃 ， 这 可 能 
导致 素 引 损坏 ， 甚 至 更 可 能 发 生 WAL 回 放 期 间 的 错误 。 


为 bit 类 型 采用 substring() 将 任何 负 长 度 看 作 " 所 有 其 余 字 符 串 " (Tom) 


之 前 代码 可 以 那样 处 理 -1， 并 且 为 其 它 负 数值 产生 无 效 结果 值 ， 可 能 导致 衣 溃 (CVE- 
2010-0442)。 


当 输 出 比特 宽度 大 于 不 同 于 8 位 倍数 的 其 它 给 定 整数 的 时 候 ， 修复 整数 到 比特 字符 串 转 换 
以 正确 处 理 第 一 个 分 数字 节 (Tom) 


修复 异常 缓慢 正则 表达 式 匹 配 的 一 些 情况 (Tom) 


修复 通过 内 存 管理 引起 的 xm 义理 中 各 种 崩溃 (Tom) 


有 首次 应 用 在 8.4 中 变化 的 各 份 补丁 。 8.3 的 代码 是 有 问题 的 ， 但 新 的 代码 与 不 想 要 各 份 
补丁 完全 不 同 ， 直到 它 已 经 获得 一 些 现 场 测 试 。 


修复 试图 更 新 复合 类 型 数组 列 元 素 的 字段 中 的 错误 (Tom) 


当 结 束 位 置 正好 在 段 边 界 的 时 候 ， 修 复 备份 历史 文件 中 stop wat Location 项 用 来 报告 下 
一 个 WAL 段 名 字 (ltagaki Takahiro) 


修复 临时 文件 泄露 的 一 些 情 况 (Heikki) 


这 纠正 了 之 前 次 要 版 本 中 引入 的 一 个 问题 。 失败 的 情况 是 当 在 另 一 个 函数 的 异常 父 理 程 
序 中 调用 plpgsql 画 数 返回 集 的 时 候 。 


完善 布尔 变量 情况 下 约束 排除 义理， 特别 是 有 可 能 排除 具有 "bool_column = false" 约 束 的 
一 个 分 区 (Tom) 


当 读 取 pg_hba.conf 和 相关 文件 的 时 候 ， 不 要 将 @something 看 作为 文件 包含 请 求 ， 如 
果 @ 出 现在 引号 标记 内 ; 另外 ， 也 不 要 把 @ 本 身 看 作为 文件 包含 请 求 (Tom) 


如 果 角 色 或 者 数据 库 名 字 以 @ 开头 ， 那 么 避免 不 稳定 操作 。 如 果 你 需要 包含 一 个 路 径 名 
有 空格 的 文件 ， 那 么 你 仍然 可 以 这 样 做 。 但 是 你 必须 书写 @"/path to/file" 而 不 是 将 引 
号 放 在 整个 结构 周围。 


如 果 该 目录 被 命名 为 pg_hba.conf 和 相关 文件 中 包含 目标 ， 那 么 避免 一 些 平台 上 无 限 循 
环 (Tom) 


如 果 没 有 设置 errno 而 ssL_read 或 者 ssL_write 失败 ， 那 么 修复 可 能 的 无 限 循 环 (Tom) 
据说 这 是 openssl 的 一 些 Windows 版 本 。 

不 允许 本 地 连接 中 GSSAPI 认 证 ， 因 为 它 需 要 hostname 可 以 正常 起 作用 (Magnus) 

如 果断 开 连 接 ， 那 么 使 用 ecpg 报 告 适当 的 SQLSTATE (Michael) 


修复 psq| 的 numericlocale 选项 而 不 格式 化 字符 串 ， 它 不 应 该 是 latex 和 troff 输 出 格式 
(Heikki) 


当 指 定 ON_ERROR_STOP 和 --Single-transaction IREE COMMIT 期 间 的 错误 的 时 候 ， 使 
用 psql 返 回 正确 退出 状态 (3) (Bruce) 


当 复 合 列 被 设置 为 空 的 时 候 ， 修 复 这 种 情况 下 plpgsql 错 误 (Tom) 

当 从 PL/PerlU 中 调用 PL/Perl 函 数 或 者 反之 亦 然 ， 修 复 可 能 错误 (Tim Bunce) 

在 PL/Python 中 添加 volatile 标记 以 避免 可 能 指定 编译 器 错误 操作 (Zdenek Kotala) 
确保 PL/Tcl 完 全 初始 化 Tcl 解 析 器 (Tom) 

如 果 使 用 Tcl 8.5 或 者 更 高 版 本 ， 这 种 疏忽 的 唯一 症状 是 Tcl clock 命令 误 操 作 。 


当 许 多 关键 列 被 指定 为 dblink_build_sql_* PMA, WEG contrib/dblink PAAR 
(Rushabh Lathia, Joe Conway) 


人 允许 contrib/itree HVE HS 444A (Tom) 


这 种 情况 之 前 作为 错误 被 拒绝 ， 但 它 更 方便 地 把 它 看 作 同 一 个 需 元 素数 组 。 特别 是 ， 
当 Itree 操作 被 施加 给 ARRAY(SELECT ...) 结果 ， 并 且 子 选择 不 会 返回 行 ， 这 避免 了 不 
必要 的 错误 。 


修复 通过 内 存 管理 引起 的 contribyxm12 中 各 种 崩溃 (Tom) 

使 得 contrib/xml2 在 Windows 上 编译 更 加 鲁 棒 性 (Andrew) 

修复 Windows 信 号 处 理 中 竞争 条 件 (Radu llie) 

该 错误 一 个 显著 现象 是 pg_listener 中 的 行 在 重负 载 情况 下 已 经 被 删除 。 


为 Bangladesh, Chile, Fiji, Mexico, Paraguay, Samoa 中 DST 变 化 更 新 时 区 数据 文件 到 
tzdata 发 布 2010e。 


E.68. & 78.3.9 


发 布 日 期 : 2009-12-14 


该 发 布 包含 来 自 8.3.8 各 种 修复 。 关 于 8.3 主 要 发 布 中 新 特性 信息 ， 2y Section E.77。 


E.68.1. 迁移 到 版 本 8.3.9 


运行 8.3.X 不 需要 各 份 /恢复 。 然 而 ， 如 果 从 8.3.8 更 早 版 本 更 新 ， 参阅 8.3.8 发 布 说 明 。 


E.68.2. 变化 


。 保护 由 索引 豆 数 导致 的 间接 安全 威胁 改变 会 话 本 地 状态 (Gurjeet Singh, Tom) 
这 个 变化 阻止 不 可 改变 的 索引 函数 可 能 破坏 超级 用 户 会 话 (CVE-2009-4136)。 
。 拒绝 在 普通 名 字 (CN) 字 段 中 包含 谨 入 空 字段 的 SSL 证 书 (Magnus) 
这 可 以 防止 SSL 验 证 期 间 证 书 意外 匹配 到 服务 器 或 者 客户 端 名 称 (CVE-2009-4034)。 
。 在 后 台 启 动 时 缓存 初始 化 期 间 修复 可 能 月 溃 (Tom) 
e 避免 空 的 同义词 词典 月 溃 (Tom) 
。 防止 在 不 安全 时 期 信号 中 断 vacuum (Alvaro) 


它 已 经 提交 元 组 操作 之 后 ， 如 果 vacuum FuLL 被 取消 ， 那 么 该 修复 程序 阻止 了 PANIC， 
并 且 如 果 有 一 个 普通 的 vacuum 在 截断 该 表 之 后 被 中 断 ， 那 么 抛 出 瞬 态 错误 。 


。 由 于 哈 希 表 大 小 计算 中 整数 浴 出 ， 修 复 可 能 崩溃 (Tom) 
文 可 能 会 产生 对 散 列 结果 大 小 非常 大 的 规划 器 估计 。 
。 修复 inet / cidr 比较 中 罕见 骨 溃 (Chris Mikkelson) 
。 确保 通过 预备 事务 持 有 的 共享 元 组 级 别 锁 被 忽略 (Heikki) 
。 修复 用 于 子 事务 中 被 访问 的 游标 的 临时 文件 的 过 早 删 除 (Heikki) 
e 当 循 环 到 一 个 新 的 CSV 日 志文 件 的 时 候 ， 修 复 syslogger 进 程 中 内 存 泄露 (Tom) 
。 修复 Windows 许 可 降级 逻辑 (Jesse Morris) 


这 修复 了 数据 库 在 Windows 上 启动 失败 的 一 些 情况 ， 通 常 带 有 误导 性 错误 信息 比如 "没有 
找到 匹配 的 postgres 可 执行 文件 "。 


当 分 裂 取 决 于 索引 非 第 一 列 的 时 候 ， 修 复 GiST 素 引 页 分 裂 不 正确 逻辑 (Paul Ramsey) 
如 果 在 检查 点 结尾 回收 利用 或 者 删除 旧 的 WAL 文 件 失败 ， 不 要 出 错误 (Heikki) 


更 好 地 将 这 个 问题 看 作 是 非 致命 性 的 ， 并 且 人 允许 检查 点 来 完成 。 未 来 检查 点 将 重新 党 
删除 。 这 些 问 题 预 计 不 会 在 正常 操作 中 ， 但 都 被 认为 通 i ea 
份 软件 造成 的 。 


确保 Windows 上 WAL 文 件 不 要 反复 被 存档 (Heikki) 
如 果 一 些 其 他 进程 干扰 不 再 需要 文件 的 删除 ， 那 么 可 能 发 生 另 外 一 种 现象 。 
修复 PAM 密 码 义理 更 加 具有 重 棒 性 (Tom) 


之 前 代码 伴随 Linux pam_krbs PAM 模 块 和 Microsoft Active Directory 结 合 为 域 控制 器 而 失 
败 ， 它 可 能 在 其 他 地 方 有 问题 ， 因为 它 采 取 不 合理 的 假设 关于 PAM 堆 栈 可 能 会 传递 给 它 
什么 参数 。 


在 GSSAPI 和 SSPI 认 证 方法 中 提高 最 大 认证 使 牌 (Kerberos 标 签 ) 大 小 (lan Turner) 


当 旧 的 2000 字 节 限 制 对 于 Unix Kerberos 实 现 足够 的 时 候 ， 通过 Windows 域 控制 器 发 出 的 
标签 更 大 。 


重启 序列 访问 统计 收集 (Akira Kurosawa) 

这 用 于 执行 但 在 8.3 中 被 损坏 。 

修复 CREATE OR REPLACE FUNCTION 期 间 所 有 依赖 关系 的 处 理 (Tom) 
修复 WHERE ` x = _x_ 条 件 的 错误 处 理 (Tom) 


在 某 些 情况 下 这 可 能 作为 多 余 的 被 忽略 ， 但 是 它们 不 是 一 它们 等 同 于 x 


IS NOT NULL 。 

使 得 文本 搜索 解析 器 可 以 接受 XML 属性 中 下 划 线 (Peten) 

修复 xml 二 进 制 输入 中 编码 处 理 (Heikki) 

如 果 XML 头 不 指定 编码 ， 我 们 假设 缺 省 UTF-8 ; 之 前 处 理 是 不 一 致 的 。 

修复 从 plperlu 调用 plperl 错误 或 者 反之 亦 然 (Tom) 

从 内 部 画 数 的 错误 退出 可 能 会 导致 崩溃 ， 由 于 外 部 函数 未 能 重新 选择 正确 的 Perl 解 释 器 。 
当 重 新 定义 PL/Perl 函 数 的 时 候 ， 修 复 会 话 存在 期 内 存 泄露 (Tom) 


当 通 过 集合 返回 PL/Perl 范 数 的 时 候 ， 确 保 Perl 数 组 被 正确 转换 为 PostgreSQL 数 组 
(Andrew Dunstan, Abhijit Menon-Sen) 


为 非 设 置 返回 返回 正确 执行 。 


修复 PL/Python 中 异常 处 理 中 罕见 月 汪 (Peter) 
在 contrib/pg_standby 中 ， 禁 用 Windows 上 带 有 信号 的 触发 器 故障 转移 (Fujii Masao) 


这 从 来 没有 任何 有 用 的 ， 因 为 Windows 不 具备 Unix 风 格 信号 ， 但 最 近 发 生 的 变化 使 它 
IE AAS 


确保 psql 的 flex 模 块 与 正确 的 系统 头 定义 一 起 被 编译 (Tom) 
这 修复 了 平台 上 编译 错误 ， 该 平台 上 --enable-largefile 导致 产生 代码 中 不 兼容 变化 。 


使 postmaster 忽 略 连 接 请 求 数据 包 中 任何 application name BW, 以 提高 未 来 libpq 版 本 
的 兼容 性 (Tom) 


更 新 时 区 缩写 文件 以 匹配 当前 情况 (Joachim Wieland) 
这 包含 添加 mT 和 sor 到 缺 省 时 区 缩写 集合 


为 了 Antarctica, Argentina, Bangladesh, Fiji,Novokuznetsk, Pakistan, Palestine, Samoa, 
Syria 中 DST 变 化 更 新 时 区 数据 文件 到 tzdata 发 布 2009s ; 同时 为 了 Hong Kong 历 史 修 
正 。 


E.69. & 78.3.8 


发 布 日 期 : 2009-09-09 


该 发 布 包含 来 自 8.3.7 中 各 种 修复 。 关 于 8.3 主 要 发 布 中 新 特性 信息 ， 2y Section E.77。 


E.69.1. 迁移 到 版 本 8.3.8 


运行 8.3.X 不 需要 各 份 /恢复 。 然 而 ， 如 果 你 在 interval WEA 任何 哈 希 索引 ， 你 必须 在 更 新 
到 8.3.8 之 后 REINDEX 它们 。 另外 ， 如 果 你 从 8.3.5 更 早 版 本 更 新 ， 参 阅 8.3.5 发 布 说 明 。 


E.69.2. 变化 


修复 Windows 共 享 内 存 分 配 代 码 (Tsutomu Yamada, Magnus) 

该 错误 导致 经 常 报道 的 "无 法 重新 连接 到 共享 内 存 "错误 信息 。 

在 pg_start_backup() 期 间 强制 WAL 段 切换 (Heikki) 

这 避免 了 可 能 使 得 基础 备份 无 法 使 用 的 一 种 情况 。 

在 安全 定义 函数 中 不 允许 RESET ROLE 和 RESET SESSION AUTHORIZATION (Tom, Heikki) 


这 包含 了 之 前 补丁 中 忽略 的 一 种 情况 ， 即 在 安全 定义 加 数 中 不 人 允许 SET ROLE 和 
SET SESSION AUTHORIZATION (参阅 CVE-2007-6600) 


使 得 已 加 载 的 加 载 模块 的 Loan 为 空 操作 (Tom) 

之 前 ， Loa 尝试 卸载 并 且 重 新 加 载 模块 ， 但 是 这 是 不 安全 的 并 且 不 是 所 有 都 有 用 。 
在 LDAP 身 份 认 证 期 间 不 允许 空 密 码 (Magnus) 

EREI RRASA hA SELECT% (Tom) 

修复 从 排序 或 物化 规划 节点 输出 中 获取 整 行 值 相 关联 的 错误 (Tom) 

避免 synchronize_seqscans 改变 滚动 结果 和 WITH HoLD 游标 (Tom) 


当 在 AND 或 者 OR 列 表 中 有 超过 100 子 句 的 时 候 ， 恢复 规划 器 改变 无 效 部 分 索引 和 限制 排 
除 优化 (Tom) 


为 数据 类 型 interval 修复 哈 希 计算 (Tom) 


为 区 间 值 上 哈 希 连接 纠正 错误 结果 。 这 也 改变 了 区 间 列 哈 希 索引 的 内 容 。 如 果 您 有 任何 
这 样 的 索引 ， 你 必须 更 新 后 REINDEX 它们 。 


将 to_char(..., 'TH') 作为 带 有 :HH' / 'HH12' 后 缀 的 大 写字 母 序数 (Heikki) 
它 之 前 作为 'th (小 写 ) 被 处 理 。 


4 x 超过 2 百 万 ， 并 且 整 数 日 期 在 使 用 中 的 时 候 ， 修复 INTERVAL `x ms' 浴 出 (Alex 
Hunsaker) 


修复 点 和 线段 之 间距 离 的 计算 (Tom) 
这 导致 来 自 一 些 几何 算 子 的 不 正确 结果 。 


修复 money 数据 类 型 以 便 在 货币 量 没有 小 数位 数 的 情况 下 执行 ， 比 如 Japan(ltagaki 
Takahiro) 


修复 模式 包含 % 情况 下 的 LIke (Tom) 

正确 四 舍 五 入 日 期 输入 比如 66:12:57.9999999999999999999999999999 (Tom) 
修复 XML 操作 中 内 存 泄 露 (Tom) 

修复 GiST R-tree 操作 符 类 中 页 面 分 割 点 的 错误 选择 (Teodor) 


确保 "fast shutdown" 请 求 将 强制 终止 打开 会 话 ， 即使 "smart shutdown" 已 经 在 进行 中 
(Fujii Masao) 


当 输 入 值 GEA) FREER I A, ER SHA GNR PERE FEE(Tom) 
在 PL/pgSQL 中 的 某 些 情况 下 正确 执行 NOT NULL 域 限制 (Tom) 

修复 plperl 初 始 化 中 可 移植 性 问题 (Andrew Dunstan) 

如 果 postgresql.conf 是 空 的 ， 修 复 pg_ctl 不 进入 无 限 循环 (Jeff Davis) 

当 有 许多 大 对 象 的 时 候 ， 提 高 pg_dump 的 效率 (Tamas Vincze) 

使 用 sicusri 而 不 是 steQurtT 作为 pg_standby 故 障 信号 (Heikki) 

使 用 pg_standby 的 maxretries 选项 作为 记录 (Fujii Masao) 


当 键 或 者 值 太 长 而 不 适合 它 的 数据 结构 的 时 候 ， 而 不 是 默默 地 截断 它 ， 那 


么 contrib/hstore 抛 出 一 个 错误 。 

修复 contrib/xml2 的 xslt_process() 用 来 正确 义理 参数 的 最 大 数 (20) (Tom) 
提高 libpq 代 码 和 鲁 棒 性 以 恢复 copy FROM STDIN 中 错误 (Tom) 

当 安装 两 个 库 的 时 候 ， 吕 免 包含 readline 和 editline 头 文件 冲突 (Zdenek Kotala) 


为 Bangladesh, Egypt, Jordan, Pakistan, Argentina/San_Luis, Cuba, Jordan (历史 修 
iE) Mauritius, Morocco, Palestine, Syria, Tunisia 中 DST 变 化 更 新 时 区 数据 文件 到 
tzdata 发 布 2009|。 
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E.70. & 8.3.7 


发 布 日 期 : 2009-03-16 


该 发 布 包含 来 自 8.3.6 中 各 种 修复 。 关 于 8.3 主 要 发 布 中 新 特性 信息 ， 2y Section E.77。 


E.70.1. 迁移 到 版 本 8.3.7 


运行 8.3.X 不 需要 各 份 /恢复 。 然 而 ， 如 果 从 8.3.5 更 早 版 本 更 新 ， 参 阅 8.3.5 发 布 说 明 。 


E.70.2. 变化 


e 当 编 码 转 换 失败 的 时 候 ， 避 免 错 误 递 为 月 溃 (Tom) 


该 变化 为 相关 错误 情况 在 最 后 两 个 次 要 版 本 中 扩展 修复 。 之 前 修复 程序 为 最 初 问 题 报告 
进行 了 细 化 ， 但 我 们 现在 已 经 认识 到 通过 编码 转换 辑 数 抛 出 的 任何 错误 可 能 潜在 地 导致 
无 限 递归 ， 而 试图 报告 错误 。 如 果 我 们 发 现 已 经 营 入 了 一 个 递归 错误 报告 的 情况 时 ， 解 
决 的 办 法 是 禁用 转换 以 及 编码 转换 并 报告 任何 纯 ASCII 格 式 错误 消息 。 


© 不 允许 为 指定 转换 画 数 带 有 错误 编码 的 CREATE CONVERSION (Heikki) 
这 可 以 防止 编码 转换 失败 的 情况 。 之 前 变化 是 预防 同一 区 域 其 它 类 型 错误 的 手段 。 
。 修复 xpath) 不 会 修改 路 径 表 达 式 除非 必要 ， 并 且 当 必要 时 做 出 理智 尝试 (Andrew) 


SQL 标准 表明 xpath 致力 于 数据 是 一 个 文档 片段 ， 但 libxml 不 支持 这 一 点 ， 其 实 这 是 不 
明确 的 ， 按 照 XPath 标准 是 明智 的 。 xpath 试图 通过 修改 数据 和 路 径 表 达 式 解决 这 个 错 
误 匹 配 ， 但 是 修改 是 古怪 的 ， 并 可 能 导致 有 效 的 搜索 失败 。 现 在 ， xpath 检查 数据 是 否 
实际 上 是 一 个 良好 的 文档 ， 并 且 如 果 是 这 样 调用 不 改变 数据 或 路 径 表 达 式 的 libxml。 FA 
则 ， 一 个 不 太 可 能 失败 的 不 同 修改 方法 被 使 用 。 
> Note: 新 的 修改 方法 仍然 不 是 100% 合 人 满意 ， 并 且 它 似乎 没有 真正 的 解决 方案 是 可 能 
的 。 这 个 补丁 因此 被 看 作 是 一 个 短期 有 效 的 防止 不 必要 的 破坏 现 有 应 用 程序 。 
PostgreSQL 8.4 直 接 拒绝 在 不 是 一 个 腿 好 文档 的 数据 上 使 用 xpath o 

e 当 to_char() 指定 格式 代码 对 于 数据 参数 类 型 不 合适 的 时 候 ， 修 复核 心 转 储 (Tom) 

e。 当 C 语 言 环境 用 于 多 字 节 编码 的 时 候 ， 修 复 文 本 搜索 中 可 能 失败 (Teodon) 
在 平台 上 有 可 能 崩溃 ， 即 wchar t 比 int 更 罕 的 时 候 ， 尤 其 Windows 上 。 


。 修复 文本 搜索 解析 器 的 处 理 类 似 电 子 邮 件 包含 多 个 @ 字符 串 效 率 低 下 的 情况 (Heikki) 


修复 较 大 子 查询 输出 列表 中 子 sevect 规划 器 问题 (Tom) 


这 个 错误 已 知 现 象 是 "未 能 定位 分 组 列 "依赖 于 涉及 的 数据 类 型 错误 ; 但 是 也 有 可 能 是 其 
它 问题 。 


修复 隐 式 强制 case wHEN 的 反 编译 (Tom) 


党 试 检 查 或 者 备份 视图 的 时 候 ， 这 个 错误 可 能 导致 断言 启动 编译 中 断言 错误 ， 或 者 是 
其 它 情况 中 "意外 的 CASE WHEN 子 句 "错误 消息 。 


修复 TOAST 表 的 行 类 型 拥有 者 可 能 错误 分 配 (Tom) 


如 果 CLUSTER 或 者 ALTER TABLE 的 重 写 形式 通过 某 人 而 不 是 表 的 所 有 者 被 执行 ， 

pg_type 项 为 表 的 TOAST 表 将 最 终 标 记 为 由 别人 所 拥有 。 这 没有 造成 直接 的 问题 ， 因为 
普通 的 数据 库 操作 不 会 检查 TOAST rowtype 的 权限 。 然而 ， 它 可 能 会 导致 意外 故障 ， 如 
果 之 后 尝试 删除 发 出 该 命令 的 角色 (在 8.1 或 者 8.2 中 ) ， 或 者 已 经 这 样 做 之 后 (在 8.3 
中 ) 来 自 pg_dump 中 的 "数据 类 型 所 有 者 似乎 无 效 "警告 。 


如 果 当 前 会 话 从 来 没有 执行 任何 Listen 命令 ， 那 么 改变 UNLISTEN 迅速 退出 (Tom) 


多 数 情况 下 这 不 是 一 个 特别 有 用 的 优化 ， 但 因为 piscARD ALL 调用 UNLISTEN ， 之 前 编码 
导致 为 大 量 使 用 orscarp ALL 的 应 用 程序 带 来 巨大 的 性 能 问题 。 


修复 PL/pgSQL 没 有 把 into 在 INSERT 之 后 看 作 字 符 串 任意 位 置 的 一 个 INTO 变 量子 句 ， 
不 仅 在 开始 ; 尤其 是 ， 不 会 在 create RULE 中 INSERT into 中 失败 (Tom) 


在 块 退出 时 完全 清理 PL/pgSQL 错 误 状 态 变 量 (Ashesh Vashi 和 Dave Page) 


这 不 是 PL/pgSQL 本 身 存在 的 问题 ， 但 当 检 查 一 个 画 数 的 状态 的 时 候 ， 该 足 忽 可 能 导致 
PL/pgSQL 调 试 器 月 涡 。 


在 Windows 上 重新 尝试 失败 调用 到 callNamedPipe() (Steve Marshall, Magnus) 


看 起 来 这 个 函数 有 时 可 能 会 暂时 失效 ; 我 们 之 前 将 任何 故障 看 作 是 严重 的 错误 ， 这 可 能 混 
淆 LISTEN / NoTIFY 以 及 其 它 操作 。 


添加 must (Mauritius Island Summer Time) 到 已 知 的 时 区 缩写 缺 省 列表 中 (Xavier 
Bugaud) 


E.71. & 78.3.6 


发 布 日 期 : 2009-02-02 


该 发 布 包含 来 自 8.3.5 的 各 种 修复 。 关 于 8.3 主 要 发 布 中 新 特性 信息 ， 2y Section E.77。 


E.71.1. 迁移 到 版 本 8.3.6 


运行 8.3.X 不 需要 各 份 /恢复 。 然 而 ， 如 果 从 8.3.5 更 早 版 本 更 新 ， 参 阅 8.3.5 发 布 说 明 。 


E.71.2. 变化 


使 用 piscar ALL 发 布 咨询 锁 ， 除 了 它 已 经 做 的 之 外 (Tom) 

这 是 最 适合 的 操作 。 然 而 ， 这 可 能 影响 现 有 的 应 用 程序 。 

修复 整个 索引 GiST 打 描 以 便 正确 执行 (Teodor) 

如 果 在 GiST 素 引 上 集群 一 个 表 ， 那 么 这 个 错误 可 能 导致 行 丢 失 。 

修复 xmlconcat(NULL) 的 崩溃 (Peter) 

如 果 高 比特 位 字符 被 用 作 标 志 ， 那 么 修复 ispell 词典 中 可 能 崩溃 (Teodor) 


这 被 称 为 是 由 一 个 广泛 可 用 的 Norwegian 字 典 完成 的 ， 并 且 在 其 它 中 相同 的 条 件 可 能 存 
在 。 


修复 为 复合 类 型 pg_dump 错 误 顺 序 输出 (Tom) 

最 可 能 的 问题 是 在 索引 和 视图 需要 它们 之 后 为 用 户 定义 的 运算 符 类 而 被 备份 。 
完善 headline() 图 数 中 URL 的 处 理 (Teodor) 

完善 headline() ea Kheadlinefy x (Teodor) 


如 果 用 错误 的 转换 函数 为 指定 编码 对 创建 一 个 编码 转换 ， 防止 可 能 的 断言 故障 或 错误 转 
换 。(Tom, Heikki) 


修复 可 能 的 断言 失败 ， 如 果 在 PL/pgSQL 中 执行 语句 改写 成 另 一 种 语句 ， 例如 ， 如 
果 INSERT 改写 为 UPDATE (Heikki) 


确保 快照 可 用 于 数据 类 型 输入 男 数 (Tom) 


这 主要 影响 了 声明 为 涉及 用 户 定义 的 稳定 或 者 不 变 函 数 cHEck 限制 的 域 。 如 果 没 有 设置 
快照 ， 则 这 样 的 范 数 往往 失败 。 


为 用 于 数据 类 型 /O 中 SPI 使 用 函数 使 其 更 安全 ; 特别 是 用 于 域 检查 约束 (Tom) 

避免 vAcuuM 中 小 表 的 不 必要 锁定 (Heikki) 

修复 保持 ALTER TABLE ENABLE/DISABLE RULE 被 活路 会话 识别 的 问题 (Tom) 

修复 使 用 UPDATE RETURNING tableoid 返回 需 而 不 是 正确 OID 问 题 (Tom) 

允许 图 数 声明 为 采用 ANYARRAY 以 便 在 该 类 型 的 pg_statistic 列 上 执行 (Tom) 
这 便 经 运行 ， 但 是 在 8.3 中 无 意 被 损坏 。 

当 转 变 的 平等 应 用 于 外 部 连接 子 句 的 时 候 ， 修 复 选 择 性 的 规划 器 误 评估 (Tom) 

这 可 能 会 导致 查询 不 好 的 规划 


像 ... from a left join b on a.al = b.b1 where a.al = 42... o 
完善 长 IN 列表 的 优化 处 理 (Tom) 

当 启 用 约束 排除 的 时 候 ， 该 变化 避免 了 在 列表 上 浪费 大 量 时 间 。 
防止 在 GIN 索 引 构 建 期 间 同 步 打 描 (Tom) 


由 于 GIN 是 在 增加 TID 顺 序 中 为 插入 元 组 进行 了 优化 ， 选择 使 用 同步 打 描 可 能 会 
三 个 或 更 多 个 因素 的 编译 。 


E: 


确保 持 有 游标 的 内 容 不 依赖 于 TOAST 表 的 内 容 (Tom) 


此 前 ， 游 标 中 大 字段 值 可 能 会 表示 为 TOAST 指 针 ， 如 果 引 用 的 表 在 读 取 游 标 之 前 被 删 
除 ， 或 者 如 果 大 值 被 删除 ， 然 后 清理 。 这 可 能 失败 。 这 不 能 发 生 在 普通 游标 中 ， 但 它 可 
能 使 用 游标 保持 超过 它 创建 的 事务 。 


当 一 组 返回 画 数 没有 读 取 整个 结果 而 被 终止 ， 那 么 修复 内 存 泄露 (Tom) 
当 数 据 库 编码 不 是 UTF-8 的 时 候 ， 修 复 XML 本 数 中 编码 转换 问题 (Tom) 
修复 contrib/dblink 的 dblink_get_result(text,bool) 函数 (Joe) 

修复 来 自 contrib/sslinfo HAAI sth (Tom) 


当 在 命令 中 被 触发 一 次 以 上 的 时 候 ， 修 复 contrib/tsearch2 兼容 性 触发 器 的 不 正确 操作 
(Teodor) 


修复 autovacuum 中 可 能 错误 信号 (Heikki) 
支持 作为 Windows 7 beta 服 务 运行 (Dave 和 Magnus) 
修复 varchar 结 构 ecpg 的 处 理 (Michael) 


当 无 法 获得 PL/Penl 连 接 信 息 的 时 候 ， 修 复 configure 脚 本 用 来 正确 报告 错误 (Andrew) 


。 使 用 适当 的 所 有 文档 引用 pgsql-bugs 和 /或 者 pgsql-hackers , 而 不 是 现在 过 时 
的 pgsql-ports 和 pgsql-patches 邮件 列表 (Tom) 


e (为 Kathmandu 和 Switzerland, Cuba 中 历史 DST) 更 新 时 区 数据 文件 到 tzdata 发 布 2009a 


E.72. & 78.3.5 


4 #5 A HA: 2008-11-03 


该 发 布 包含 来 自 8.3.4 各 种 修复 。 关 于 8.3 主 要 发 布 中 新 特性 信息 ， 参阅 Section E.77。 


E.72.1. 迁移 到 唉 本 8.3.5 


运行 8.3.X 不 需要 各 份 /恢复 。 然 而 ， 如 果 从 8.3.1 更 早 版 本 更 新 ， 参 阅 8.3.1 发 布 说 明 。 BH, 
如 果 你 正在 运行 之 前 的 8.3.X 版 本 ， 推 荐 更 新 之 后 REINDEX 所 有 GiST 索 引 。 


E.72.2. 变化 


修复 GiST 素 引 损 坏 ， 由 于 在 删除 之 后 标记 错误 索引 项 " 死 的 "(Teodor) 


可 能 导致 索引 搜索 无 法 找到 他 们 应 该 找 的 行 。 损坏 的 索引 可 以 使 用 REINDEx 被 修复 。 
。 当 客 户 端 编码 不 能 表示 本 地 化 错误 消息 的 时 候 ， 修 复 后 台 月 漠 (Tom) 


我 们 已 经 解决 了 之 前 类 似 问题 ， 如 果 " 字 符 没 有 等 同 "消息 自身 不 能 被 转化 ， 但 是 可 能 仍 
然 失败 。 当 我 们 发 现 这 种 情况 的 时 候 ， 解 决 办 法 是 茶 用 本 地 化 并 且 发 送 纯 ASCII 错 误 消 
息 。 


修复 bytea 到 XML 映射 中 可 能 骨 溃 (Michael McMaster) 


当 深 度 谋 套 画 数 被 触发 器 调用 的 时 候 ， 修 复 可 能 崩溃 (Tom) 


。 提高 _expression_ IN ( _expression-list_ ) 查 询 优化 (Tom， 每 一 个 想法 都 来 自 Robert 
Haas) 


右边 有 查询 变量 比 起 之 前 版 本 已 经 在 8.2.x 和 8.3.x 中 被 低 效 处 理 ， 该 修复 为 这 种 情况 修复 
了 8.1 操 作 。 


e 当 子 sELECT 出 现在 FROM ， 多 行 vALUES 列表 ， 或 者 RETURNING 列表 中 的 函数 调用 中 的 
时 候 ， 修 复 规则 查询 的 错误 扩展 (Tom) 


这 个 问题 的 常见 现象 是 "未 知 节点 类 型 "错误 。 
e 在 GiST 索 引 的 rs wu 搜索 的 重复 扫描 中 ， 修 复 断 言 失败 (Teodon) 
。 在 散 列 聚集 规划 的 重复 扫描 中 ， 修 复 内 存 泄露 (Neil) 
。 当 新 定义 PL/pgSQL 触 发 器 画 数 作为 正常 范 数 被 调用 的 时 候 ， 确保 报告 一 个 错误 (Tom) 


在 CREATE DATABASE 开始 拷贝 文件 之 前 ， 强 迫 检 查 点 (Heikki) 
如 果 在 源 数 据 库 中 已 经 删除 了 文件 ， 这 可 以 防止 可 能 错误 。 


当 移 动 表 到 另外 一 个 使 用 ALTER SET TABLESPACE 的 表 空 间 时 ， 预 防 relfilenode 数 的 可 能 
冲突 (Heikki) 


该 命令 党 试 重新 使 用 已 有 文件 名 ， 而 不 是 选择 在 目标 目录 中 未 使 用 的 一 个 。 
当 单 个 查询 项 匹配 文本 第 一 个 字 的 时 候 ， 修 复 不 正确 文本 搜索 headline 生 成 (Sushant 


当 在 --enable-integer-datetimes 编译 中 使 用 非 1SO 日 期 类 型 时 ， 修复 间隔 值 中 小 数秒 不 
正确 显示 (Ron Mayer) 


当 他 们 被 逃逸 的 时 候 ， 使 用 re 上 比较 字符 不 区 分 大 小 写 (Andrew) 
确保 DISCARD 通过 语句 记录 被 正确 处 理 (Tom) 
在 PITR 恢 复 期 间 修复 最 后 完成 事务 时 不 正确 记录 (Tom) 


当 传 递 的 元 组 以 及 元 组 描述 符 有 不 同 列 数 时 ， 确 保 SPI_getvalue 和 sPI_getbinval 正确 
操作 (Tom) 


当 表 中 有 列 被 添加 或 者 删除 的 时 候 ， 这 种 情况 是 正常 的 ， 但 是 这 两 个 函数 不 能 正确 义理 
它 。 唯 一 可 能 后 果 是 不 正确 错误 显示 。 


标记 SessionReplicationRole 为 PGDLLIMPORT ， 因此 它 可 以 用 于 Windows 上 Slony 
(Magnus) 


当 使 用 libpq 的 gsslib 参数 的 时 候 ， 修复 小 的 内 存 泄露 (Magnus) 

在 连接 关闭 时 不 释放 通过 参数 字符 串 使 用 的 空格 。 

如 果 需 要 ， 那 么 确保 libgssapi 被 连接 到 libpq 中 (Markus Schaaf) 

修复 cREATE RoLE 的 ecpg 的 解析 (Michael) 

修复 pg_ctl restart 最 近 破 损 (Tom) 

确保 以 二 进 制 模式 打开 pg_control (ltagaki Takahiro) 
pg_controldata 和 pg_resetxlog 这 样 做 不 正确 ， 因此 在 Windows 上 可 能 失败 。 


更 新 时 区 数据 文件 到 tzdata 发 布 2008i (为 Argentina, Brazil, Mauritius, Syria 中 DST 变 化 ) 


E.73. & 78.3.4 


发 布 日 期 : 2008-09-22 


该 发 布 包含 来 自 8.3.3 中 各 种 修复 。 关 于 8.3 主 要 发 布 中 新 特性 信息 ， 参阅 Section E.77。 


E.73.1. 迁移 到 版 本 8.3.4 


运行 8.3.X 不 需要 各 份 /恢复 。 然 而 ， 如 果 从 8.3.1 更 早 版 本 更 新 ， 参 阅 8.3.1 发 布 说 明 。 


E.73.2. 变化 


。 修复 btree WAL 恢 复 编码 中 错误 (Heikki) 
如 果 通 过 页 拆 分 操作 中 途 结 束 WAL， 那 么 恢复 失败 。 
。 修复 为 HOT 页 修剪 错误 截断 XID 的 潜在 使 用 (Alvaro) 


个 错误 产生 通过 vacuum 查阅 的 系统 目录 损坏 风险 : 死 的 元 组 版 本 可 能 太 早 被 删除 。 
oe eee 因为 当 检 查 目 录 的 时 候 ， 该 系统 并 不 遵循 MVCC 
规则 ， 但 它 可 能 会 从 pg_dump 或 其 它 客户 端 程序 输出 中 导致 瞬时 错误 。 


e 修复 datfrozenxid 的 潜在 错误 计算 (Alvaro) 
这 个 错误 可 能 解释 了 删除 旧 的 pg_clog 数据 一 些 错 误 报 告 。 
e 在 pg_class 重新 被 索引 之 后 修复 不 正确 的 HOT 更 新 (Tom) 


如 果 在 同一 会 话 中 REINDEX TABLE pg_class 伴随 ALTER TABLE RENAME 或 者 
ALTER TABLE SET SCHEMA 命令 ， 可 能 发 生 pg_class 损坏 。 


e 修复 丢失 的 "combo cid" 情 况 (Karl Schnaitter) 
这 个 错误 使 得 行 对 于 通过 所 有 终止 的 多 个 子 事务 已 经 删除 的 事务 不 可 见 。 
。 如 果 该 表 目 前 的 检查 在 错误 的 时 间 被 删除 ， 那么 避免 自动 清理 崩溃 (Alvaro) 
e 从 32 位 到 64 位 扩展 本 地 锁 计 数 器 (Tom) 
该 反馈 是 计数 器 可 能 在 相当 长 事务 中 浴 出 ， 寻 致意 想不到 的 " 持 有 锁 " 错 误 。 
。 修复 GiST 索 引 扫 描 期 间 元 组 的 重复 输出 (Teodor) 
© 当 修改 任何 一 个 表 的 时 候 ， 从 头 回收 外 键 检 查 查询 (Tom) 


之 前 ，8.3 可 能 党 试 重新 规划 查询 ， 但 是 可 能 操作 之 前 生产 的 查询 文本 。 如 果 重 命名 表 或 
者 列 ， 那 么 导致 错误 。 


当 视 图 包含 一 个 简单 的 UNION ALL 结构 的 时 候 ， 修复 丢失 的 权限 检查 (Heikki) 
正确 检查 引用 表 权 限 ， 但 不 是 视图 本 身 权 限 。 


在 执行 器 和 启动 中 添加 检查 以 确保 通过 INSERT 或 者 uppATE 产生 的 元 组 匹配 目标 表 的 当前 
行 类 型 (Tom) 


这 种 情况 在 8.3 中 是 不 可 能 的 ， 但 是 在 以 前 版 本 中 可 以 发 生 ， 所 以 检查 似乎 是 谨慎 的 。 
修复 prop owned 期 间 可 能 的 重复 删除 (Tom) 

这 通常 会 导致 奇怪 错误 比如 "对 于 关系 NNN 缓 存 查找 失败 "。 

修复 XML 操作 中 若干 内 存 泄 露 (Kris Jurka, Tom) 

为 不 可 接受 的 目标 数据 类 型 修复 xmlserialize() 正确 改善 误差 (Tom) 

修复 文本 搜索 配置 文件 解析 中 错误 处 理 多 字 节 字符 的 地 方 (Tom) 

配置 文件 中 出 现 的 某 些 字符 总 是 引起 "无 效 字 节 序列 编码 "错误 。 

为 文本 搜索 配置 文件 中 报道 的 所 有 错误 提供 文件 名 和 行 号 位 置 (Tom) 


修复 AT time zone 首先 党 试 解析 它 的 时 区 参数 为 时 区 缩写 ， 并 且 如 果 失 败 ， 则 党 试 作为 
完整 时 区 名 ， 而 不 是 之 前 的 其 它 方式 (Tom) 


时 间 惟 输入 画 数 一 直 按 此 顺序 解决 模棱两可 的 区 域名 称 。 采用 AT TIME zone 这 样 做 提高 
了 一 致 性 ， 并 且 修 复 了 8.1 引 入 的 一 个 兼容 性 错误 : 在 模棱两可 的 情况 下 ， 我 们 现在 操作 
和 8.0 以 及 以 前 的 操作 都 是 一 样 的 ， 因为 在 旧版 本 中 AT Time zone 接受 only 缩写 。 


当 在 64 位 平台 上 运行 的 时 候 ， 修 复 datetime 输 入 函数 以 正确 检测 整数 渝 出 (Tom) 
当 显 示 有 单位 的 配置 参数 的 时 候 ， 防 止 单 位 换算 期 间 整 数 洽 出 (Tom) 

改善 写 很 长 日 志 信息 到 syslog 的 性 能 (Tom) 

允许 pg_hba.conf 中 LDAP URL 的 后 弘 部 分 空格 (Tom) 

修复 SELECT DISTINCT on 查询 上 游标 向 后 扫描 中 的 错误 (Tom) 

修复 规划 器 错误 可 能 不 正确 地 推翻 外 部 连接 下 面 的 Is NuLL 测试 (Tom) 

EAE oR 子 句 的 基础 上 通过 Is NULL 测试 同一 关系 触发 。 

修复 艇 套子 select 表 达 式 规划 器 错误 (Tom) 


如 果 外 部 子 select 对 父 查 询 没有 直接 相关 性 ， 但 内 部 确实 如 此 ， 可 能 不 会 为 新 的 父 查询 行 
计算 外 部 值 。 


修复 规划 器 以 估计 产生 布尔 结果 的 croup BY 表达 式 总 是 产生 两 组 ， 不 管 表达 式 的 内 容 


(Tom) 

比 起 规则 croup By 评估 某 个 布尔 测试 像 col rs NULL 来 说 更 加 准确 。 

当 ror 循环 的 目标 变量 是 包含 复合 类 型 字段 的 记录 ， 修 复 PL/pgSQL 而 不 失败 (Tom) 
修复 PL/Tcl 以 正确 操作 Tcl 8.5， 并 且 更 加 小 心 数据 编码 发 送 的 或 者 来 自 Tcl 的 (Tom) 
提高 PQescapeBytea() 的 性 能 (Rudolf Leitgeb) 


在 Windows 上 ， 通 过 避免 libpq 党 试 发 送 超过 64KB 每 个 系统 调用 解决 Microsoft 错 误 
(Magnus) 


修复 ecpg 正 确 处 理 set 命令 中 变量 (Michael) 
在 错误 发 送 一 个 SQL 命令 之 后 完善 pg_dump 和 pg_restore 的 错误 报告 (Tom) 
修复 pg_ctl 以 正确 保存 通过 restart 的 postmaster 命 令 行 参 数 (Bruce) 


修复 pg_standby 中 错误 的 WAL 文 件 截止 点 计算 (Simon) 


(为 Argentina, Bahamas, Brazil, Mauritius, Morocco,Pakistan, Palestine 和 Paraguay 中 


DST 变 化 ) 更 新 时 区 数据 文件 到 tzdata 发 布 2008f。 


E.74. & 8.3.3 


发 布 日 期 : 2008-06-12 


该 发 布 中 包含 8.3.2 中 修复 的 一 个 严重 的 和 较 小 的 错误 。 关于 8.3 主 要 发 布 中 新 特性 信息 ， 参 
# Section E.77。 


E.74.1. 迁移 到 版 本 8.3.3 


运行 8.3.X 不 需要 各 份 /恢复 。 然 而 ， 如 果 从 8.3.1 更 早 版 本 更 新 ， 参 阅 8.3.1 发 布 说 明 。 


E.74.2. %14k 


e 采用 pg_get_ruledef() 括 起 负 的 常量 (Tom) 


该 修复 程序 之 前 ， 视图 或 规则 中 负 常 数 可 能 被 各 份 ， 比方 说 ， -42::integer ， 这 是 不 正 
确 的 : 它 应 该 是 (-42)::integer ， 由 于 运算 符 优 先 级 规则 。 通常 这 样 差别 不 大 ， 但 它 
可 能 与 其 它 最 近 补 丁 相 互 作 用 导致 PostgreSQL 拒 绝 有 效 的 SELECT DISTINCT 视图 查询 内 
容 。 因为 这 可 能 会 导致 pg_dump 输 出 未 能 重新 加 载 ， 它 被 视 为 一 个 高 优先 级 补丁 。 转 储 
输出 实际 上 是 不 正确 的 唯一 的 发 行 版 本 是 8.3.1 和 8.2.7。 


e 使 用 ALTER AGGREGATE ... OWNER TO 更 新 pg_shdepend (Tom) 


如 果 之 后 在 prop owNED 或 者 REASSIGN OWNED 操作 中 涉及 到 聚集 ， 那 么 这 一 疏忽 可 能 导致 


Aiko 


E.75. & 78.3.2 


发 布 日 期 : 从 未 公布 
该 发 布 中 包含 8.3.1 中 各 种 修复 。 关 于 8.3 主 要 发 布 中 新 特性 信息 ， 参阅 Section E.77。 


E.75.1. 迁移 到 版 本 8.3.2 


运行 8.3.X 不 需要 各 份 /恢复 。 然 而 ， 如 果 从 8.3.1 更 早 版 本 更 新 ， 参 阅 8.3.1 发 布 说 明 。 


E.75.2. 变化 
。 当 使 用 UTF-8 数 据 库 编 码 和 不 同 客户 端 编码 的 时 候 ， 修 复 在 Windows 上 发 生 
的 ERRORDATA_STACK_SIZE exceeded Ast (TOM) 
e WA recovery_command 参数 中 %r 宏 修 复 不 正确 月 档 截 断 点 计算 (Simon) 
如 果 热 各 份 脚 本 依赖 于 wr 决定 何 时 丢弃 WAL 分 段 文 件 ， 这 可 能 导致 数据 丢失 。 


e 修复 ALTER TABLE ADD COLUMN ... PRIMARY KEY ， 使 得 新 列 被 正确 检查 以 查看 CHORD 
始 化 为 所 有 非 空 (Brendan Jurd) 


之 前 版 本 忽略 检查 这 项 需求 。 
e 修复 REASSIGN owNED 以 致 于 工作 于 程序 语言 (Alvaro) 
。 修复 在 非 sELEcT 顶级 操作 查询 中 SELECT FOR UPDATE/SHARE 作为 子 查询 出 现 的 问题 (Tom) 


。 当 从 同一 个 祖先 中 继承 约束 的 多 个 父 关 系 中 继承 "同一 "约束 的 时 候 ， 修复 可 能 


的 cREATE TABLE 错误 (Tom) 


e 修复 pg_get_ruledef() 以 显示 别名 ， 如 果 存 在 ， 附 加 到 uppaTE 或 者 DELETE 的 目标 表 中 
(Tom) 


。 恢复 之 前 8.3 操 作 TID 用 在 一 个 TidScan 规 划 结 果 中 静默 地 不 匹配 任何 行 中 的 范围 外 块 号 
(Tom) 


8.3.0 和 8.3.1 相 反 抛 出 一 个 错误 。 
。 修复 可 能 导致 许多 LWLocks 失败 的 GIN 错 误 (Teodon) 
e 为 tsquery ($8 4A GiST Lb 4% Bs (Teodor) 


e {$8 tsvector_update_trigger() 和 ts_stat() 用 来 接受 超出 它们 期 望 类 型 域 (Tom) 


修复 故障 以 支持 枚 举 数 据 类 型 作为 外 键 (Tom) 
当 解 压 损 坏 的 数据 时 ， 避 免 可 能 骨 溃 (Zdenek Kotala) 
修复 在 延迟 断 开 和 DROP DATABASE 之 间 竞 态 条 件 (Heikki) 


在 最 坏 的 情况 下 ， 这 可 能 会 导致 在 一 个 新 的 数据 库 删 除 新 创建 的 表 中 ， 获得 相同 OID 作 
为 最 近 删 除 的 ; 但 当然 这 是 非常 小 概率 情况 。 


修复 后 端的 SIGTERM 退 出 可 能 遗留 在 共享 内 存 中 损坏 状态 中 的 两 个 地 方 (Tom) 


两 种 情况 都 不 是 很 重要 ， 如 果 SIGTERM 用 于 关闭 整个 数据 库 集 群 ， 但 是 如 果 党 试 
SIGTERM 个 人 后 端 ， 可 能 有 问题 。 


修复 可 能 的 崩溃 ， 由 于 当 x 和 _y 具有 不 同 的 数据 类 型 的 时 候 ， 不 正确 规划 引 
#2 x IN (SELECT _y FROM .…) 子 句 。 当 从 y 的 类 型 转换 为 x 的 类 型 有 损耗 
时 ， 确保 该 操作 是 语义 正确 的 。 


修复 踊 忽 ， 避 免 规 划 器 蔡 代 已 知 的 Param 值 好 像 它 们 是 常数 (Tom) 


这 个 错误 部 分 茶 用 8.3.0 和 8.3.1 中 未 命名 扩展 查询 语句 优化 : 特别 是 如 果 LIKE 模 式 作为 参 
数 被 传递 ， 那 么 LIKE 到 索引 扫描 优化 将 永远 不 会 被 应 用 ， 并 且 取 决 于 参数 值 的 约束 排除 
也 不 能 正常 运行 。 


当 可 索引 的 MIN 或 者 max 聚集 用 于 pisTINCT 或 者 oRDER BY 的 时 候 ， 修 复 规 划 器 错误 
(Tom) 


修复 规划 器 以 确保 它 为 了 正 提供 排序 节点 的 规划 节点 从 来 不 使 用 "physical tlist"(Tom) 
这 导致 排序 摆布 比 实际 需要 的 更 多 数据 ， 因为 未 使 用 列 值 被 包含 在 排序 数据 中 。 
避免 查询 字符 串 的 不 必要 拷贝 (Tom) 

当 许 多 命令 作为 单一 查询 字符 串 被 提交 的 时 候 ， 修 复 了 8.3.0 中 介绍 的 性 能 问题 。 


当 检 查 子 事务 XID 的 时 候 ， 使 得 TransactionIdIscurrentTransactionId() 使 用 二 进 制 搜索 
而 不 是 线性 搜索 (Heikki) 


这 修复 了 8.3.0 中 比 之 前 版 本 显著 缓慢 的 情况 。 


修复 ISO-8859-5 和 其 它 编码 之 间 转 换 用 来 处 理 Cyrillic "Yo" 字 符 (使 用 两 个 点 的 e Al E ) 
(Sergey Burladyan) 


修复 一 些 数据 类 型 输入 函数 ， 尤 其 是 array_in() ， 被 允许 结果 中 未 使 用 字 节 包含 未 初始 
化 ， 不 可 预测 的 值 (Tom) 


这 可 能 导致 错误 ， 其 中 两 个 似乎 相同 文本 值 被 认为 不 相同 ， 导 致 解析 器 抗议 不 匹配 
的 oRDER BY 和 DISTINCT 表达 式 。 


修复 正则 表达 式 子 字符 串 匹 配 的 情况 ( substring(``_string_ XA _pattern_ )) (Tom) 


当 有 一 个 匹配 模式 整体 ， 但 用 户 指定 括号 子 表达 式 ， 并 且 子 表达 式 还 没有 得 到 匹配 。 那 
么 出 现 问 题 ， 一 个 例子 是 substring('foo' from 'foo(bar)?') o 这 应 该 返回 NULL， 
为 (bar) 不 匹配 ， 但 它 错误 地 返回 全 模式 匹配 ( 即 foo) 。 


阻止 发 动 自动 清理 防止 XID 重 县 的 取消 (Alvaro) 


善 未 确定 元 组 的 ANALYzE 的 处 理 〈 通 过 尚未 提交 的 事务 插入 或 者 删除 ) ， 以 使 它 报告 
给 作 闫 计 收集 器 的 数量 可 能 是 正确 的 (Pavan Deolasee) 


修复 initdb 拒 绝 --xlogdir ( -x ) 选 项 的 相对 路 径 (Tom) 
采用 psql 输 出 标签 字符 作为 适当 空间 数 ， 而 不 是 8.3.0 和 8.3.1 中 执行 的 \xe9 (Bruce) 


更 新 时 区 数据 文件 到 tzdata 发 布 2008c (为 Morocco, Iraq, Choibalsan, Pakistan, Syria, 
Cuba 和 Argentina/San_Luis 中 DST 变 化 ) 


添加 EcPGget_PGconn() E22 !lecpglib (Michael) 

修复 来 自 ecpg 的 pctypestimestamp_sub() RIŽA E ff 24 R (Michael) 
修复 ecpg 中 连续 行 标 记 的 处 理 (Michael) 

修复 contrib/cube BJZ Eh A) BEBY AR zt (Tom) 


当 输 入 查询 返回 NULL 值 的 时 候 ， 修 复 contrib/xml2 BY xpath_table() KŽP IZD $k He 
(Tom) 


修复 contrib/xml2 的 makefile 而 不 覆盖 crcs ,并且 为 libxslt 存 在 或 者 不 存在 使 其 自动 配 
置 (Tom) 


E.76. & 18.3.1 


发 布 日 期 : 2008-03-17 


该 发 布 包含 来 自 8.3.0 的 各 种 修复 。 关 于 8.3 主 要 发 布 中 新 特性 信息 ， 参 阅 Section E.77。 


E.76.1. 迁移 到 版 本 8.3.1 


运行 8.3.X 不 需要 各 份 /恢复 。 然 而 ， 如 果 你 受到 下 面 描述 的 Windows 区 域 问 题 的 影响 。 在 更 
新 之 后 你 可 能 需要 文本 列 上 REINDEX 索引 。 


E.76.2. %14k 


。 修复 认为 不 同 字符 组 合 是 相同 的 Windows 区 域 的 字符 串 比较 (Tom) 


当 使 用 UTF-8 数 据 库 编码 的 时 候 ， 此 修复 程序 仅 适 用 于 Windows。 相同 的 修复 程序 解决 
了 2 年 前 所 有 其 他 情况 ， 但 是 使 用 UTF-8 的 Windows 使 用 未 被 更 新 的 单独 代码 路 径 。 如 果 
你 正 使 用 认为 非 相同 字符 串 是 相同 的 区 域 ， 你 可 能 需要 REINDEX 以 修复 文本 列 上 现 有 索 
引 。 


修复 vacuum FULL 中 极端 情况 错误 (Tom) 


8.2 中 介绍 了 不 同 的 系统 目录 中 并 发 vacuum FULL 操作 之 间 的 潜在 死 锁 。 这 已 得 到 纠正 。 
8.3 执 行 的 更 糟糕 ， 因为 死 锁 可 能 出 现在 关键 代码 部 分 ， 使 其 PANIC 而 不 仅仅 是 ERROR 
条 件 。 


此 外 ， vacuum FULL 通过 清理 系统 目录 中 途 失 败 可 能 会 导致 并 发 数据 库 会 话 中 缓存 损坏 。 


当 义 理 没 有 活 元 组 页 的 时 候 ，8.3 中 介绍 的 另外 一 个 vacuum FULL 可 能 导致 月 溃 或 者 内 存 
不 足 报告 。 


修复 涉及 character 或 者 bit 列 的 外 键 检查 错误 操作 (Tom) 

如 果 引 用 列 不 同 除 兼 容 类 型 〈 比 如 varchar ) ， 那 么 错误 强制 约束 。 
在 无 操作 外 键 检查 中 避免 不 必要 死 锁 错误 (Stephan Szabo, Tom) 

当 重 新 规划 预备 查询 的 时 人 息 ， 修 复 可 能 的 核心 转 储 (Tom) 


该 错误 只 影响 协议 级 别 预 各 操作 ， 而 不 是 SQL prepare, 因此 常常 被 认为 JDBC, DBILA 
及 大 量 使 用 预 各 语句 的 其 它 客户 端 驱动 程序 。 


当 重 新 规划 调用 SPI 使 用 范 数 的 查询 时 ， 修 复 可 能 错误 (Tom) 


修复 逐 行 比较 涉及 不 同 数据 类 型 列 中 的 错误 (Tom) 
修复 长 期 存在 的 Listen / NoTIFY 竞 态 条 件 (Tom) 


在 极 少数 情况 中 执行 LISTEN 的 会 话 中 可 能 无 法 得 到 通知 ， 即 使 可 以 被 预计 ， 因 为 执 
行 NoTIFY 的 并 发 事务 被 观察 后 提交 。 


该 修复 的 负面 效果 是 已 经 执行 尚未 提交 的 LIsTEN 命令 的 事务 将 不 能 看 到 任 
何 pg_listener 中 LISTEN 行 , 应 该 选择 查看 ; 之 前 可 能 会 。 这 种 操作 从 来 没有 记录 一 种 
方式 或 者 其 它 ， 但 是 可 能 某 些 应 用 程序 依赖 于 旧 操 作 。 


在 一 个 预备 事务 中 不 允许 Listen 和 UNLISTEN (Tom) 


之 前 这 是 被 允许 的 ， 但 是 尝试 执行 它 有 各 种 不 好 的 结果 ， 尤 其 是 原始 后 台 不 能 退出 只 


AAS 


要 UNLISTEN 没有 提交 。 

不 允许 删除 预备 事务 中 临时 表 (Heikki) 

8.1 中 不 允许 ， 但 是 在 8.2 和 8.3 中 无 意 中 损 坏 了 该 检查 。 

当 在 使 用 哈 希 索 引 的 查询 中 发 生 错误 的 时 候 ， 修 复 罕 见 骨 溃 (Heikki) 
修复 tsquery 值 的 不 正确 比较 (Teodon) 

修复 单字 节 编 码 中 非 ASCII 字 符 Like 不 正确 操作 (Rolf Jentsch) 
禁用 xmlvalidate (Tom) 


该 图 数 应 该 在 8.3 版 本 之 前 删除 ， 但 是 无 意 中 留 在 源 代码 中 。 它 造成 小 的 安全 风险 ， 因为 
未 授权 用 户 可 以 使 用 它 读 取 访 问 服务 器 任何 文件 的 前 几 个 字符 。 


修复 集合 返回 画 数 的 某 些 用 法 的 内 存 泄露 (Neil) 
使 用 encode( bytea , 'escape') 转换 所 有 BAF PAE] nnn 八进制 转 义 序列 (Tom) 


当 数 据 库 编 码 是 多 字 节 时 ， 有 必要 避免 编码 问题 。 这 种 变化 可 能 为 预期 从 encode 中 指定 
结果 的 应 用 中 产生 兼容 问题 。 


修复 公元 前 2 月 29 号 日 期 时 间 值 的 输入 (Tom) 

关于 哪 一 年 是 头 年 前 者 编码 是 错误 的 。 

修复 ALTER owNER 的 一 些 变量 中 "未 知 节点 类 型 "错误 (Tom) 

避免 CREATE TABLE LIKE INCLUDING INDEXES 中 表 空 间 权限 错误 (Tom) 

当中 断 锁 等 待 的 时 候 ， 确 保 pg_stat_activity . waiting 标志 被 清除 (Tom) 
修复 Windows Vista 上 进程 权限 的 处 理 (Dave, Magnus) 


特别 是 ， 这 个 修复 允许 作为 管理 员 用 户 启动 服务 器 。 


更 新 时 区 数据 文件 到 tzdata 发 布 2008a (尤其 是 ， 最 近 Chile 变 化 ) ; 调整 时 区 缩写 ver 
(Venezuela) 意 味 着 UTC-4:30, not UTC-4:00 (Tom) 


修复 数组 ecpg 问 题 (Michael) 
修复 pg_ctl 以 正确 从 命令 行 选 项 中 提取 postmaster 的 端口 号 (ltagaki Takahiro, Tom) 


之 前 ， pg ctl start -w 可 能 党 斌 联系 错误 端口 上 postmaster， 导致 启动 错误 的 虚假 报 


使 用 -fwrapv 防御 最 近 gcc 版 本 中 可 能 的 错误 优化 (Tom) 
当 使 用 gcc 4.3 或 者 更 高 版 本 编译 PostgreSQL 的 时 候 ， 这 是 必要 的 。 


启动 使 用 MSVC 编译 contrib/uuid-ossp (Hiroshi Saito) 


E.77. & 718.3 


发 布 日 期 : 2008-02-04 


E.77.1. 概述 
随 着 显著 的 新 功能 和 性 能 增强 ， 此 版 本 对 于 PostgreSQL 是 一 个 重大 的 飞跃 。 通过 越 来 越 多 的 
社区 已 经 大 大 加 快 了 发 展 的 步伐 成 为 可 能 。 此 版 本 增加 了 以 下 主要 特性 : 

。 全 文 搜索 被 集合 到 核心 数据 库 系 统 中 

e 支持 SQL/XML 标 准 ， 包 含 新 的 操作 以 及 xm 数据 类 型 

e 枚 举 数 据 类 型 ( Enum ) 

。 复合 类 型 数组 

。 通用 唯一 标识 符 ( uuID ) 数 据 类 型 

。 添加 控制 是 否 nul 首先 排序 还 是 最 后 排序 

。 可 更 新 游标 

。 服务 器 配置 参数 可 以 基于 每 个 辑 数 被 设置 

。 用 户 定义 类 型 可 以 有 类 型 修饰 符 

。 当 更 新 表 定 义 变 化 或 者 统计 的 时 候 ， 自 动 重 新 规划 缓存 查询 

。 记录 和 统计 收集 中 大 量 优化 

e 为 Windows 上 认证 支持 安全 服务 提供 者 接口 (SSPI) 

。 支持 多 个 并 发 autovacuum 进 程 ， 和 其 它 autovacuum 优 化 

© 人 允许 使 用 Microsoft Visual C++ 编译 整个 PostgreSQL 发布 
主要 性 能 改进 如 下 。 大 部 分 这 些 功能 是 自动 的 ， 不 需要 用 户 改变 或 者 调整 : 

。 在 事务 提交 期 间 异 步 提交 延迟 写 入 WAL 

。 检查 点 写 操作 被 分 散在 一 个 较 长 时 间 周 期 内 用 来 平滑 每 个 检查 点 中 I/O 剧 增 

e 扒 元 组 (HOT) 加 快 了 大 部 分 uppATE 和 DELETE 的 空间 复 用 


及 时 后 端 写 策 略 提高 了 磁盘 写 效 率 


为 只 读 事务 使 用 非 持 久 事务 ID 减少 开销 和 vacuum 需求 


。 减少 每 个 字段 和 每 行 存储 开销 

。 大 顺序 扫描 不 再 频繁 删除 已 使 用 缓存 页 
。 并 发 大 顺序 打 描 可 以 共享 磁盘 读 取 

e ORDER BY ... LIMIT 无 需 排序 


在 下 面 章节 更 详细 解释 了 上 面 每 一 项 。 


E.77.2. 迁移 到 版 本 8.3 


使 用 pg_dump 的 备份 /恢复 为 了 那些 希望 从 任何 其 它 版 本 迁移 数据 。 
观察 下 面 的 不 兼容 性 : 


E.77.2.1. 普通 的 


。 非 字 符 数据 类 型 不 再 自动 转换 为 TEXT (Peter, Tom) 


之 前 ， 如 果 一 个 非 字 符 值 被 提供 给 要 求 text 输入 的 操作 者 或 函数 ， 它 会 自动 转换 
为 text ， 针 对 大 多 数 〈 但 不 是 全 部 ) 内 置 的 数据 类 型 。 这 不 再 发 生 : 为 了 所 有 非 字符 
串 类 型 需要 显 式 转换 为 text o 例如 ， 这 些 RAAB AT : 


substr(current_date, 1, 4) 
23 LIKE '2%' 


但 是 现在 分 别 导 致 " 画 数 不 存 在 "和 "操作 符 不 存在 "错误 。 使 用 显 式 转 换 而 不 是 : 


substr(current_date::text, 1, 4) 
23::text LIKE '2%' 


(当然 ， 你 也 可 以 使 用 更 详细 的 cAsT() 语法 了 。) 该 变化 的 原因 是 这 些 自动 强制 转换 过 
于 频繁 引起 伟人 惊讶 操作 。 一 个 例子 是 在 以 前 的 版 本 中 ， 接 受 这 个 表达 式 ， 但 并 没有 执 
行 预期 的 内 容 : 


current_date &lt; 2017-11-17 


这 实际 上 比较 日 期 为 整数 ， 这 应 该 被 (现在 是 ) 拒绝 一 但 双方 自动 转换 都 被 转换 
为 text 并 且 执 行文 本 比较 ， 因为 当 没 有 其 他 的 eit; 操作 符 的 时 候 ， 
text &lt; text 操作 符 可 以 匹配 表达 式 。 


类 型 char(`_n_ ) 和 varchar(``_n_ ) 仍 然 自动 转换 为 text. 另外 ， 自 动 转换 到 text 仍 
然 为 输入 级 联 ( || ) 操 作 符 执 行 ， 只 要 至 少 一 个 输入 是 字符 串 类 型 。 


来 自 contrib/tsearch2 全 文 搜 索 特 性 已 经 被 移动 到 核心 服务 器 中 ， 有 一 些小 的 语法 变化 
contrib/tsearch2 包含 一 个 兼容 接口 。 


ARRAY(SELECT ...) ， 其 中 SELECT 没有 返回 行 ， 现 在 返回 一 个 空 数组 ， 而 不 是 
NULL(Tom) 


基本 数据 类 型 的 数组 类 型 名 不 再 是 带 有 下 划 线 前 级 的 基础 类 型 名 


当 有 可 能 时 ， 旧 的 命名 约定 仍然 采用 ， 但 应 用 程序 代码 不 应 该 再 依赖 于 它 。 代替 使 用 新 
的 pg_type.typarray 列 ， 以 确定 与 给 定 的 类 型 相关 联 的 数组 数据 类 型 。 


ORDER BY ... USING _operator_ 必须 使 用 小 于 或 者 大 于 在 btree 操 作 符 类 中 定义 


的 _operator_ 

为 防止 不 一 致 结果 添加 该 限制 。 

SET LocaL 变化 持续 直到 最 外 层 事务 截止 ， 除 非 回 滚 (Tom) 

之 前 在 子 事务 提交 后 ( RELEASE SAVEPOINT 或 者 从 PL/pgSQL 异 常 块 中 退出 ) & 


失 sET Loca 的 影响 

在 事务 块 中 拒绝 的 命令 在 多 语句 查询 字符 串 中 被 拒绝 (Tom) 

比如 ， "BEGIN; DROP DATABASE; COMMIT" 被 拒绝 即使 作为 单一 查询 消息 被 提交 。 
事务 块 外 部 RoLLBACK 发 出 NOTICE 而 不 是 wARNING (Bruce) 

阻止 NOTIFY / LISTEN / UNLISTEN 接受 模式 限定 名 称 (Bruce) 

之 前 ， 这 些 命令 接受 schema.relation 但 是 忽略 模式 部 分 ， 这 是 全 人 困惑 的 。 
ALTER SEQUENCE 不 再 影响 序列 的 currval() 状态 (Tom) 

外 键 必须 匹配 交叉 数据 类 型 引用 的 可 索引 条 件 (Tom) 

这 改善 了 语义 一 致 性 并 且 可 以 避免 性 能 问题 。 

限制 对 象 大 小 函数 到 拥有 合理 权限 可 以 查看 该 信息 的 用 户 (Tom) 


比如 ， pg_database_size() 需要 connect RIR, 这 人 缺 省 授权 给 每 一 个 
人 。 pg tablespace_size() 在 表 空 间 上 需要 create 权限 ， 如 果 表 空间 是 数据 库 缺 省 表 空 


间 ， 则 允许。 
删除 非法 的 !!= ( 非 in) 操 作 符 (Tom) 
NOT IN (SELECT ...) 是 执行 该 操作 的 正确 方式 。 


内 部 哈 希 函数 更 加 一 致 分 布 (Tom) 


如 果 应 用 程序 代码 正 使 用 内 部 PostgreSQL 哈 希 画 数 计算 并 且 存 储 哈 希 值 ， 那么 哈 希 值 必 
须 被 再 生 。 


e 改变 处 理 可 变 长 度数 据 值 C 代 码 约 定 (Greg Stark, Tom) 


新 的 set_varsize() 宏 必须 用 于 设置 生成 varlena ANKE. 另外 ， 它 在 更 多 情况 中 有 
必要 扩展 ("de-TOAST") 的 输入 值 。 


。 连续 为 档 不 再 报告 每 个 成 功 六 档 操 作 到 服务 器 日 志 ， 除 非 使 用 DeBus 级 别 (Simon) 
E.77.2.2. 配置 参数 


。 管理 服务 器 参数 中 许多 变化 


删除 bgwriter_lru_percent , bgwriter_all_percent , bgwriter_all_maxpages ， 


stats_start_collector 和 stats_reset_on_server_start o redirect_stderr 重 命名 为 





logging_collector o stats_command_string 重 命名 为 track_activities o 
stats_block_level 和 stats_row_level 被 合并 为 track_counts o 一 个 新 的 布尔 配置 参 
数 archive_mode 控制 为 档 。Autovacuum 的 缺 省 设置 已 改变 。 


© 删除 stats_start_collector 参数 (Tom) 
我 们 现在 总 是 启动 收集 器 处 理 过 程 ， 除 非 UDP 套 接 创建 失败 。 


@ 删除 stats_reset_on_server_start BB (Tom) 





这 被 删除 ， 因 为 pg_stat_reset() 用 于 这 一 目的 。 
e postgresql.conf 中 注释 参数 导致 它 恢复 到 缺 省 值 (Joachim Wieland) 


之 前 ， 注 释 项 留 下 参数 的 值 未 改变 直到 下 次 服务 器 重新 启动 。 


E.77.2.3. 字符 编码 


。 添加 对 无 效 编码 数据 的 更 多 检查 (Andrew) 
该 变化 插入 反 斜 杠 逃 逸 字 符 串 处理 和 copy 逃逸 处 理 中 存在 的 一 些 漏洞 。 目前 检查 脱 转 
义 字 符 串 看 是 否 其 结果 创建 了 一 个 无 效 的 多 字 节 字符 。 

。 不 允许 与 服务 器 的 区 域 设置 不 一 致 的 数据 库 编码 (Tom) 


在 大 多 数 平台 上 ， c 区 域 是 与 任何 数据 库 编码 执行 的 唯一 区 域 。 其 它 区 域 设置 说 明了 一 
个 特定 的 编码 ， 并 且 如 果 数 据 库 编码 不 同 ， 则 错误 操作 (典型 的 症状 包括 虚假 文本 排序 
顺序 和 来 自 upper() 或 者 lower() 的 错误 结果 ) 现在 服务 器 拒绝 尝试 创建 有 一 个 不 兼容 
编码 的 数据 库 。 


。 确保 chr() 不 能 创建 无 效 编码 值 (Andrew) 


在 UTF8 编 码 数据 库 中 chr() 参数 被 认为 Unicode 代 码 点 。 在 其 它 多 字 节 编码 中 chr() 的 
参数 必须 指定 7 位 ASCII 字 符 。 不 再 接受 需 。 调 整 ascii() 以 达到 匹配 。 


调整 convert() 操作 用 来 确保 编码 有 效 性 (Andrew) 


convert() 的 两 个 参数 形式 已 被 删除 。 这 三 个 参数 的 形式 现在 需要 bytea 第 一 个 参数 ， 
并 返回 一 个 bytea 。 为 了 代 蔡 函数 缺失 ， 三 个 新 的 函数 被 添加 : 


o convert_from(bytea, name) 返回 text 一 从 指定 编码 的 第 一 个 参数 转化 到 数据 库 编 
码 


© convert_to(text, name) 返回 bytea —; 转换 数据 库 编码 的 第 一 个 参数 到 指定 编码 
o length(bytea, name) 返回 integer 一 给 定 指定 编码 字符 中 第 一 个 参数 长 度 

删除 转换 (参数 使 用 conversion_name) (Andrew) 

其 操作 不 符合 SQL 标 准 。 

客户 端 JOHAB 编 码 (Tatsuo) 


JOHAB 作 为 服务 器 端 编码 不 安全 。 


E.77.3. 变化 


下 面 你 将 发 现在 PostgreSQL 8.3 和 之 前 主要 发 布 版 本 之 间 变 化 的 详细 说 明 。 


E.77.3.1. 性 能 


在 事务 提交 期 间 异 步 提交 延迟 写 人 WAL(Simon) 


此 功能 极 大 地 提高 了 短期 数据 修改 事务 性 能 。 缺点 是 由 于 磁盘 写 人 延迟， 如 果 数 据 被 写 
入 到 磁盘 之 前 该 数据 库 或 操作 系统 骨 溃 ， 那么 提交 的 数据 将 会 去 失 。 此 功能 对 可 以 接受 
一 些 数 据 丢 失 的 应 用 程序 是 有 益处 的 。 不 像 关 闭 fsync ， 使 用 异步 提交 不 会 把 数据 库 一 
致 性 放 在 危险 的 处 境 中 ; 最 坏 的 情况 是 崩溃 后 最 后 几 个 据 称 已 提交 的 事务 可 能 不 会 被 提 
交 。 此 功能 通过 关闭 synchronous_commit 被 启用 (由 每 个 会 话 或 每 个 事务 来 完成 ， 如 果 
一 些 事 务 是 关键 的 ， 而 另 一 些 则 不 是 ) 。 wal writer_delay EE% £ pr Eak ik A AIP 
以 被 调整 以 控制 最 大 延迟 。 

检查 点 写 操 作 被 分 散在 一 个 较 长 时 间 周 期 内 用 来 平滑 每 个 检查 点 中 IJ/O 剧 增 (Itagaki 
Takahiro 和 Heikki Linnakangas) 


以 前 所 有 修改 过 的 缓冲 区 在 检查 点 期 间 尽 可 能 快 地 被 强制 到 磁盘 中 ， 造成 JO 剧 增 ， 降 低 
服务 器 的 性 能 。 这 种 新 方法 在 检查 点 中 向 外 扩散 到 磁 总 写 信 ， 降低 最 大 MO 使 用 。 (RA 
能 快 的 写 入 用 户 请 求 和 关闭 检查 点 ) o 


堆 元 组 (HOT) 为 uppate 和 DELETE 加 速 空间 再 利用 (Pavan Deolasee, 还 有 许多 其 他 的 
想法 ) 


UPDATE 和 DELETE 舍弃 死 元 组 ， 因为 执行 失败 的 INSERT 。 之 前 仅仅 vacuum 可 以 回收 通 
过 死 元 组 采取 的 空间 。 如 果 没 有 变化 到 索引 列 ， 那 么 在 Insert 或 者 uPDATE 的 时 候 HOT 
死 元 组 空间 可 以 被 自动 回收 。 这 人 允许 更 加 一 致 的 性 能 。 此 外 ，HOT 避 免 添加 重复 索引 


项 。 

实时 后 台 写 策略 提高 磁盘 写 入 效率 (Greg Smith, Itagaki Takahiro) 
这 极 大 降低 了 后 台 写 入 的 手动 调整 需要 。 

降低 每 个 字段 和 每 行 存储 开销 (Greg Stark, Heikki Linnakangas) 


数据 值 小 于 128 字 节 的 可 变 长 度数 据 类 型 将 看 到 3 至 6 个 字 节 的 存储 减少 。 例如 ， 两 个 相 
邻 的 char(1) 字段 现在 使 用 4 个 字 节 ， 而 不 是 16。 行 标 头 是 比 以 前 更 短 的 4 个 字 节 。 


为 只 读 事务 使 用 非 持 久 事务 ID 减少 开销 和 vacuum 需求 (Florian Pflug) 


非 持 久 性 事务 ID 不 会 增加 全 局 事务 计数 器 。 因 此 ， 它 能 减少 pg_clog 上 负载 FAA 
制 vacuum 以 防止 事务 ID 重 县 期 间 的 时 间 。 采取 的 其 它 性 能 改进 提高 了 并 发 性 。 


在 只 读 命令 后 避免 增加 命令 计数 器 (Tom) 


之 前 每 个 事务 2<sup class="calibre28">32</sup>(4 十 亿 ) 命 邻 的 硬性 限制 。 现在 唯一 的 命 
使 实际 上 改变 了 数据 库 计 数 ， 因此 ， 哩 然 这 一 限制 仍然 存在 ， 它 应 该 很 少 合 人 讨厌 。 


632 + AWALE EMAS El RERE(Simon) 
为 CLUSTER 和 copy 忽略 不 必要 的 WAL 写 进程 (Simon) 


除非 启用 WAL 为 档 ， 那 么 在 命 合 结 尾 为 cLusTER 和 fsync() 表 系 统 避免 WAL 写 操作 。 如 
果 在 同一 个 事务 中 创建 该 表 ， 那 么 与 copy 是 一 样 的 。 


大 顺序 打 描 不 再 频繁 删除 已 使 用 缓存 页 (Simon, Heikki, Tom) 
并 发 大 顺序 扫描 可 以 共享 磁盘 读 取 (Jeff Davis) 


通过 在 表 的 中 间 开 始 新 的 顺序 扫描 被 完成 《其 中 另 一 个 顺序 扫描 在 进行 中 ) ， 并 返回 开 
始 以 完成 。 这 会 影响 没有 指定 oRDER BY 的 查询 中 返回 行 的 顺序 。 如 果 有 必要 的 
话 ， synchronize_seqscans 配置 参数 可 以 用 来 禁用 它 。 


ORDER BY ... LIMIT 无 需 排序 (Greg Stark) 


这 是 通过 顺序 扫描 表 并 且 跟 踪 "top N" 候 选 行 执 行 ， 而 非 执 行 全 排序 整个 表 。 当 没有 匹配 
索引 并 且 LIMIT 不 大 的 时 候 ， 这 是 很 有 用 的 。 


将 信息 上 速度 限制 发 送 到 后 台 统计 收集 器 上 (Tom) 


这 降低 了 短 事务 开销 ， 但 是 可 能 有 时 在 统计 之 前 增加 延迟 。 
完善 许多 空 值 情况 下 哈 希 连接 性 能 (Tom) 
加 快 非 精 确 数 据 类 型 匹配 操作 符 查找 情况 (Tom) 


E.77.3.2. 服务 如 
缺 省 启用 Autovacuum (Alvaro) 
进行 了 几 处 修改 以 消除 启用 自动 清理 的 缺点 ， 从 而 证 明 缺 省 变化 。 一 些 其 他 自动 清理 参 
数 缺 省 也 被 修改 。 


支持 多 个 并 发 自动 清理 进程 (Alvaro, ltagaki Takahiro) 
这 人 允许 同时 运行 多 个 清理 。 这 可 以 阻止 大 表 清 理 延 迟 小 表 清 理 。 
当 表 定义 变化 或 者 统计 被 更 新 的 时 候 ， 自 动 重新 规划 缓存 查询 (Tom) 


如 果 临 时 表 在 函数 调用 之 间 被 删除 并 且 重 新 创建 ， 之 前 引用 临时 表 的 PL/pgSQL 辑 数 可 能 
会 失败 ， 除非 使 用 ExEcuTE 。 这 个 改进 解决 了 该 问题 和 许多 相关 的 问题 。 


添加 temp_tablespaces 参数 以 控制 临时 表 和 文件 的 表 空 间 (Jaime Casanova,Albert 
Cervera, Bernd Helmle) 

该 参数 定义 了 要 使 用 的 表 空 间 列 表 。 启用 在 多 个 表 空 间 上 分 散 MO 负 载 。 随机 表 空 间 在 创 
建 一 个 临时 对 象 时 被 选择 。 临时 文件 不 再 存储 在 每 个 数据 库 pgsql_tmp/ 目录 中 ， 而 在 
每 个 表 空 间 目 录 中 。 


将 临时 表 的 TOAST 表 放 在 pg_toast_temp_“`_nnn_ 命名 的 特殊 模式 中 (Tom) 





这 使 得 低级 别 的 代码 将 这 些 表 看 作 临 时 的 ， et 
EA 并 且 使 用 本 地 而 不 是 共享 缓存 的 访问 。 这 也 修复 了 一 个 错误 ， 其 中 后 端 意外 保持 打 
开 的 文件 引用 到 临时 TOAST 表 。 


修复 新 连接 请 求 恒 流 可 能 无 限 延迟 postmaster 完 成 关机 或 者 死机 重 和 启 的 问题 (Tom) 


警惕 非常 低 概率 的 数据 丢失 情况 ， 防 止 重新 使 用 已 删除 表 的 relfilenode， 直 到 下 一 个 检查 
点 之 后 (Heikki) 


修复 CREATE CONSTRAINT TRIGGER 用 来 转换 旧 形 式 外 键 触发 器 定义 到 规则 外 键 约 束 (Tom) 


这 将 缓解 来 自 7.3 之 前 数据 库 外 键 约束 移植 ， 如 果 它 们 从 来 没 使 用 contrib/adddepend 被 转 
移 。 


修复 DEFAULT NULL 重 写 继承 的 缺 省 值 (Tom) 


DEFAULT NULL 之 前 被 认为 噪声 短语 ， 但 是 它 应 该 〈 并 且 现 在 ) 覆盖 非 需 缺 省 否则 从 父 表 
或 者 域 中 被 继承 。 


e 添加 新 的 编码 EUC_JIS_2004 和 SHIFT_JIS_2004 (Tatsuo) 
这 些 新 编码 可 以 从 UTF-8 被 转换 。 


。 从 "数据 库 系 统 准 各 就 绪 " 到 "数据 库 系 统 准备 接受 连接 " 改变 服务 器 和 启动 日 志 信 息 ， 并 且 调 
整 其 定时 


仅仅 当 postmaster 准 备 好 接受 连接 的 时 候 出 现 该 信息 。 


E.77.3.3. 监控 


添加 log_autovacuum_min_duration 参数 以 支持 autovacuum 活 动 可 配置 记录 (Simon， 
Alvaro) 


添加 log lock waits 记录 锁 等 待 (Simon) 


e 添加 log_temp_files 记录 临时 文件 用 法 (Bill Moran) 


添加 log_checkpoints 参数 完善 检查 点 记录 (Greg Smith, Heikki) 
e log_line_prefix 目前 支持 所 有 过 程 中 %s 和 %c 逃逸 (Andrew) 


之 前 这 些 逃 逸 只 用 于 用 户 会 话 中 ， 而 不 是 后 台数 据 库 过 程 。 


添加 1og_restartpoints 控制 即时 恢复 重启 点 记录 (Simon) 


。 最 后 事务 结束 时 间 被 记录 到 恢复 结束 和 每 个 记录 重启 点 (Simon) 


Autovacuum 报 告 pg_stat_activity 中 活动 启动 时 间 (Tom) 


人 允许 逗号 分 隔 值 (CSV) 形式 的 服务 器 日 志 输 出 (Arul Shaji, Greg Smith, Andrew 
Dunstan) 


CSV 格 式 日 志文 件 可 以 很 容易 为 后 续 分 析 被 加 载 到 数据 库 表 中 。 
使 用 PostgreSQL 提 供 的 时 区 支持 服务 器 日 志 中 显示 的 格式 时 间 戳 (Tom) 


这 避免 了 提供 错误 编码 中 本 地 化 时 区 名 称 Windows 特 定 问题 。 有 一 个 新 
的 1og_timezone 参数 控制 用 于 日 志 消 息 中 的 时 区 ， 独立 于 客户 端 可 见 timezone SR, 


新 系统 视图 pg_stat_bgwriter 显示 关于 后 台 写 活动 统计 (Magnus) 
。 为 数据 库 端 元 组 统计 添加 新 列 到 pg_stat_database (Magnus) 

e 添加 xact_start (事务 启动 时 间 ) 列 到 pg_stat_activity (Neil) 
这 使 得 很 容易 识别 长 期 存在 的 事务 。 


添加 n_live _tuples 和 n_dead _tuples 列 到 pg_stat_all_tables 和 相关 视图 中 (Glen 
Parker) 


° 合并 stats_block_level 和 stats_row_level 参数 到 单一 参数 track_counts ， 这 控制 着 发 
送 到 统计 收集 器 过 程 的 所 有 信息 (Tom) 


e 重 命 名 stats_command_string 参数 为 track_activities (Tom) 


。 修复 活 的 和 死 的 元 组 统计 计数 以 意识 到 已 提交 的 和 终止 的 事务 有 不 同 效 果 (Tom) 


E.77.3.4. 认证 


。 为 Windows 上 认证 支持 安全 服务 提供 者 接口 (SSPI) (Magnus) 
e 支持 GSSAPI 认证 (Henry Hotz, Magnus) 
这 是 首先 的 本 地 Kerberos 认 证 ， 因 为 GSSAPI 是 行业 标准 。 
。 支持 全 球 SSL 配 置 文件 (Victor Wagner) 
e 添加 ssl_ciphers 参数 控制 可 接受 SSL 加 密 (Victor Wagner) 


e 添加 Kerberos 范 围 参 数 ， krb_realm (Magnus) 


E.77.3.5. 预 写 日 志 (WAL) 和 连续 兴 档 
。 改变 来 自 time_t 到 TimestampTz 表 示 形 式 的 事务 WAL 记 录 中 的 时 间 戳 记录 (Tom) 
在 WAL 中 提供 了 列 居 第 二 位 解决 方法 。 这 对 于 点 即时 恢复 有 益处 。 
。 减少 热 各 份 服务 器 需要 的 WAL 磁 盘 空 间 (Simon) 


这 种 变化 允许 热 各 用 服务 器 传递 最 时 仍然 需要 WAL 文 件 名 字 到 恢复 脚本 ， 人 允许 不 再 需要 
的 WAL 文 件 自动 清除 。 使 用 recovery.conf 中 restore_command 参数 %r 的 执行 。 


。 新 的 布尔 配置 参数 ， archive_mode ， 控制 妆 档 (Simon) 


之 前 设置 archive_command X EFRR M Jato IIE archive mode 使 归档 开启 和 关 
闭 ， 独 立 于 archive_command 。 这 用 于 暂时 停止 归档 。 


E.77.3.6. 查询 


© 全 文 搜索 被 集合 到 核心 数据 库 系 统 中 (Teodor, Oleg) 


文本 搜索 已 被 改进 ， 移 动 到 核心 代码 中 ， 并 且 缺 省 安装 。 contrib/tsearch2 包含 兼容 接 
口 。 


e 添加 控制 是 否 wu 首先 排序 还 是 最 后 排序 (Teodor, Tom) 


语法 是 ORDER BY ... NULLS FIRST/LAST 。 


© 人 允许 每 列 升序 /降序 ( asc / ese ) 索引 排序 选项 (Teodor, Tom) 


之 前 使 用 带 有 混合 asc / pesce 说 明 符 oRDER BY 的 查询 不 能 完全 使 用 索引 。 如 果 使 用 匹 
配 的 asc / pEsc 说 明 符 创建 索引 ， 那么 现在 在 这 种 情况 中 可 以 完全 使 用 索引 。 可 以 控制 
索引 中 NuLL 排序 顺序 。 


e 人 允许 col Is NULL 使 用 索引 (Teodon) 


可 更 新 游标 (Arul Shaji, Tom) 


这 消除 了 参考 主键 到 游标 返回 的 uppATE 或 者 DELETE 行 的 需要 。 语法 


为 UPDATE/DELETE WHERE CURRENT OF o 
e 人 允许 游标 中 FoR UPDATE (Arul Shaji, Tom) 


。 创建 通用 机 制 为 每 个 数据 类 型 支持 来 自 标准 字符 串 类 型 ( TEXT, VARCHAR ，CHAR ) 转 换 ， 
通过 调用 数据 类 型 的 |/O 画 数 (Tom) 


之 前 ， 这 样 的 转换 只 适用 于 此 目的 具有 专门 画 数 的 类 型 。 这 些 新 的 类 型 转换 只 在 字符 串 
方向 被 分 配 ， 显 式 仅 在 其 他 方向 ， 因此 应 该 创建 不 合 人 惊讶 的 操作 。 


。 当 所 有 输入 是 域 类 型 时 ， 人 允许 uno 和 相关 结构 返回 域 类 型 (Tom) 
之 前 ， 输 出 可 能 被 认为 是 域 的 基本 类 型 。 
。 当 使 用 两 种 不 同 数据 类 型 的 时 候 ， 人 允许 有 限 的 散 列 (Tom) 


这 人 允许 哈 希 连接 ， 哈 希 索 引 ， 散 列子 规划 ， 以 及 在 涉及 跨 数据 类 型 比较 的 情况 下 使 用 的 
散 列 聚合 ， 如 果 该 数据 类 型 具有 兼容 的 散 列 函数 。 目前 ， 跨 数据 类 型 散 列 支持 存在 


于 smallint / integer / bigint , 以 及 float4 / float8 中 。 
e 当 were 子 句 中 变量 相等 时 ， 改 善 优化 逻辑 检测 (Tom) 
这 人 允许 降序 排序 顺序 合并 连接 ， 并 且 改 进 识别 元 余 排 序列 。 
。 在 大 多 数 表 通过 约束 被 排除 的 情况 下 规划 大 继承 权时， 提高 性 能 (Tom) 


E.77.3.7. 对 象 操 作 
e 复合 类 型 数组 (David Fetter, Andrew, Tom) 


除了 显 式 声 明 的 复合 类 型 的 数组 外 ， 目前 支持 常规 表 和 视图 行 类 型 数组 ， 除 了 系统 目录 
行 类 型 ， 序 列 和 TOAST 表 。 


。 每 个 函数 基础 上 设置 服务 器 配置 参数 (Tom) 


比如 ， 如 果 在 运行 时 存在 不 同 的 search_path ， 画 数 可 以 设置 自身 的 search_path 避免 
意外 操作 。 安 全 定义 函数 可 以 设置 search_path 以 避免 安全 漏洞 。 


CREATE/ALTER FUNCTION 现在 可 以 支持 cost 和 Rows 选项 (Tom) 


cost 人 允许 男 数 调用 成 本 的 说 明 。 Rows 人 允许 平均 数 或 者 设置 返回 函数 返回 的 行 的 说 明 。 
在 选择 最 佳 规划 中 通过 优化 器 使 用 这 些 值 。 


实现 CREATE TABLE LIKE ... INCLUDING INDEXES (Trevor Hardcastle, Nikhil Sontakke, 
Neil) 


人 允许 CREATE INDEX CONCURRENTLY 忽略 其 它 数 据 库 中 事务 (Simon) 


添加 ALTER VIEW ... RENAME TO 和 ALTER SEQUENCE ... RENAME TO (David Fetter, Neil) 
之 前 这 可 能 通过 ALTER TABLE ... RENAME To 执行 。 


使 得 CREATE/DROP/RENAME DATABASE 短暂 等 待 冲 突 后 端 在 失败 之 前 退出 (Tom) 
这 增加 了 这 些 命 合成 功 的 可 能 性 。 
允许 触发 器 和 规则 出 于 复制 目的 在 使 用 配置 参数 组 中 无 效 (Jan) 


这 人 允许 复制 系统 禁用 触发 器 并 且 重 写 规 则 作为 无 需 直 接 修改 系统 目录 组 。 该 操作 通 
过 ALTER TABLE 和 新 参数 session_replication_role 被 控制 。 
用 


户 定义 类 型 可 以 有 类 型 修饰 符 (Teodor Tom) 
这 人 允许 用 户 定 义 类 型 采取 修饰 符 ， 像 ssnum(7) 。 之 前 只 有 内 和 置 数据 类 型 可 以 有 修饰 符 。 


E.77.3.8. 实用 命 分 


非 超 级 用 户 数 据 库 所 有 者 可 以 添加 可 信任 程序 语言 到 缺 省 数据 库 中 (Jeremy Drake) 


有 虽然 这 是 相当 安全 的 ， 一 些 管理 员 可 能 希望 撤销 该 权限 。 通 
过 pg_pltemplate . tmpldbacreate 控制 。 


允许 会 话 的 当前 参数 设置 作为 将 来 会 话 缺 省 使 用 (Tom) 


在 CREATE/ALTER FUNCTION ， ALTER DATABASE , 或 者 ALTER ROLE 中 使 


FA SET ... FROM CURRENT 执行 。 


实现 新 的 命令 DISCARD ALL , DISCARD PLANS , DISCARD TEMPORARY , CLOSE ALL 和 


DEALLOCATE ALL (Marko Kreen, Neil) 
这 些 命令 简化 重 置 数据 库 会 话 到 它 的 初始 状态 ， 并 且 特 别 有 利 于 连接 池 软 件 。 
使 得 cLusTER MVCC- 安 全 (Heikki Linnakangas) 


之 前 ， CLUSTER 可 能 丢弃 所 有 已 提交 为 死 的 元 组 ， 即使 仍然 有 事务 可 以 在 MVCC 可 见 规 
则 下 看 到 它们 。 


e 添加 CLUSTER 语法 : CLUSTER _table_ USING _index_ (Holger Schurig) 
仍然 支持 旧 的 cluster 语法 ， 但 是 新 形式 更 加 合理 。 
e 修复 ExPLAIN 以 致 于 它 可 以 更 加 准确 显示 复杂 规划 (Tom) 
参考 子规 划 输 出 总 是 正确 被 显示 ， 而 不 是 为 复杂 情况 使 用 ?column``_N_?。 
。 当 删 除 用 户 的 时 候 ， 限 制 报导 信息 量 (Alvaro) 


ZAI WR (或 党 试 删除 ) 拥有 很 多 对 象 的 用 户 可 能 导致 列 出 所 有 这 些 对 象 的 大 
的 notice 或 者 error 信息 ; 这 造成 一 些 客 户 端 应 用 程序 问题 。 信 息 长 度 是 有 限 的 ， 但 
一 个 完整 列表 仍 被 发 送 到 服务 器 日 志 。 


E.77.3.9. 数据 类 型 


e 支持 SQL/XML 标 准 ， 包 含 新 的 操作 以 及 xu 数据 类 型 (Nikolay Samokhvalov, Pavel 
Stehule, Peter) 


© 枚 举 数 据 类 型 ( enum ) (Tom Dunstan) 
这 个 特性 提供 了 方便 支持 小 的 ， 不 变 设置 允许 值 的 字段 。 创建 enum 类 型 的 例子 


是 CREATE TYPE mood AS ENUM ('sad', 'ok', 'happy') o 
。 通用 唯一 标识 符 ( uur ) 数 据 类 型 (Gevik Babakhani, Neil) 
这 紧密 匹配 RFC 4122。 
© 加 宽 money 数据 类 型 到 64 位 (D'Arcy Cain) 
这 大 大 增加 了 支持 money 的 范围 
e 修复 float4 / floats 以 不 断 地 处 理 infinity 和 nan ( 非 数 字 )(Bruce) 
之 前 代码 关于 从 浴 出 条 件 中 识别 Infinity 是 不 一 致 的 。 
。 在 boolean 值 的 输入 中 人 允许 前 导 和 尾随 空格 (Neil) 
e 阻止 copy 使 用 数字 和 大 小 写字 母 作 为 分 隔 符 (Tom) 


E.77.3.10. HA 


e 添加 新 规则 表达 式 范 数 regexp_matches() , regexp_split_to_array() 和 
regexp_split_to_table() (Jeremy Drake, Neil) 


这 些 画 数 提供 了 正则 表达 式 子 表达 式 的 提取 ， 并 且 人 允许 使 用 POSIX 正 则 表达 式 分 裂 字 符 
串 


o 


© 为 大 对 象 截断 添加 lo_truncate() (Kris Jurka) 


A floats 数据 类 型 实现 width_bucket() (Neil) 
添加 pg_stat_clear_snapshot() 用 来 丢弃 当前 事务 中 收集 的 统计 快照 (Tom) 


事务 中 统计 的 第 一 个 请 求 需要 事务 期 间 不 发 生变 化 的 统计 快照 。 此 函数 允许 快照 被 丢 
奔 ， 并 且 在 接 下 来 的 统计 查询 中 加 载 一 个 新 的 快照 。 这 对 PL/pgSQL 画 数 特别 有 用 ， 这 
些 函 数 被 限制 在 一 个 单一 事务 中 。 


添加 isodow 选项 EXTRACT() 和 date_part() (Bruce) 
这 返回 一 周 中 一 天 ， 星 期 日 为 七 。 ( dow 返回 星期 日 为 需 ) 


为 to_char() ， to_date() 和 to_timestamp() 添加 ID (一 周 中 ISO 天 ) 和 Ippp (一 年 中 

ISO 天 ) 格 式 代码 (Brendan Jurd) 

采用 to_timestamp() 和 to_date() 为 潜在 的 可 变 宽 度 字 段 假设 m (修剪 ) 选 项 (Bruce) 
这 匹配 Oracle 的 操作 。 


修复 to_date() / to_timestamp() iD (一 周 中 非 1SO 天 ) 字 段 中 偏 移 一 个 单位 转换 错误 
(Bruce) 


setseed() 返回 空 ， 而 不 是 无 效 整数 值 (Neil) 
为 NUMERIC 添加 哈 希 函数 (Neil) 
文 允 许 哈 希 索 引 和 基于 哈 希 规划 用 于 NuMERIC 列 。 


提高 LIKE / ILIKE 的 效率 ， 尤 其 是 多 字 节 字符 集 设置 像 UTF-8 (Andrew, Itagaki 
Takahiro) 


使 用 currtid() 画 数 需要 目标 表 上 sELECT 权限 (Tom) 
添加 几 个 txid_*() 辑 数 以 查询 活跃 事务 ID(Jan) 
这 对 于 各 种 复制 方法 是 有 用 的 。 


E.77.3.11. PL/pgSQLak 4 2simis S 


添加 可 滚动 游标 支持 ， 包 含 FETcH 中 方向 控制 (Pavel Stehule) 


人 允许 IN 作为 PL/pgSQL 的 FETcH 语句 中 FRoM 的 选择 ， 与 后 端的 FETcH 命令 一 致 (Pavel 
Stehule) 


添加 move 到 PL/pgSQL (Magnus, Pavel Stehule,Neil) 


实现 RETURN QUERY (Pavel Stehule, Neil) 


这 添加 了 想 要 返回 查询 结果 的 PL/pgSQL 设 置 返回 函数 的 便捷 语法 。 RETURN QUERY 比 环 
绕 RETURN NEXT 更 容易 而 且 更 有 效 。 


允许 函数 参数 名 字符 合 画 数 的 名 字 (Tom) 

比如 myfunc.myvar 。 在 变量 名 可 能 匹配 列 名 的 查询 中 声明 变量 非常 有 用 。 
使 得 块 标签 变量 正常 执行 (Tom) 

之 前 ， 外 部 级 别 块 标签 可 能 意外 干扰 内 部 级 别 记 录 或 者 行 引用 的 识别 。 
严格 控制 For 循环 step 值 的 需求 (Tom) 

防止 非 负 step 值 ， 并 且 人 处 理 循环 渝 出 。 

当 报 告 语法 错误 位 置 的 时 候 ， 提 高 精度 (Tom) 


E.77.3.12. HEARS amie S 


允许 类 型 名 参数 到 PL/Per| spi_prepare() 成 为 数据 类 型 别名 ， 除了 pg_type 中 发 现 的 名 
字 (Andrew) 


允许 类 型 名 参数 到 PL/Python plpy.prepare() 成 为 数据 类 型 别名 ， 除了 在 pg_type 中 发 
现 的 名 字 (Andrew) 


允许 类 型 名 参数 到 PL/Tc| spi_prepare 成 为 数据 类 型 别名 ， 除了 在 pg_type 中 发 现 的 名 
字 (Andrew) 


启动 PL/PythonU 在 Python 2.5 上 编译 (Marko Kreen) 


支持 在 兼容 的 Python 版 本 中 (Python 2.3 和 之 后 版 本 ) 真正 的 PL/Python 布 尔 类 型 (Marko 
Kreen) 


修复 后 台中 线程 启用 libtcl 产生 大 量 线程 的 PL/Tcl 问 题 (Steve Marshall, Paul 
Bayer,Doug Knight) 


这 导致 了 种 种 不 愉快 。 


E.77.3.13. psql 


分 别 列 出 \d 输出 中 禁用 触发 器 (Brendan Jurd) 

在 \d 模式 中 ， 总 是 逐 字 匹配 $ (Tom) 

显示 \da 输出 中 聚合 返回 类 型 (Greg Sabino Mullane) 
WINN aK AE \df+ 的 输出 中 (Neil) 


添加 \prompt 性 能 (Chad Wagner) 


e 添加 \pset , \t 和 \x 用 来 声明 on 或 者 off, 而 不 仅仅 是 切换 (Chad Wagner) 
e 添加 \sleep 能 力 (Jan) 

e 为 \copy BFA \timing 输出 (Andrew) 

。 提高 Windows 上 \timing 方法 (ltagaki Takahiro) 

。 在 每 个 反 斜 杠 命 令 后 冲洗 \o 输出 (Tom) 

e 当 读 取 -f 输入 文件 的 时 候 ， 正 确 地 检测 和 报告 错误 (Peter) 

。 删除 -u 选项 (该 选项 已 经 很 长 时 间 不 使 用 ) (Tom) 


E.77.3.14. pg_dump 


e 添加 --tablespaces-only 和 --roles-only 选项 到 pg_dumpall (Dave Page) 
。 添加 输出 文件 选项 到 pg_dumpall (Dave Page) 

这 在 Windows 上 有 用 ， 子 pg_dump 进 程 输 出 重 定向 不 执行 。 
e 人 允许 pg_dumpall 接 受 初始 连接 数据 库 名 而 不 是 缺 省 template1 (Dave Page) 
。 在 -n 和 -t 切换 中 ， 总 是 逐 字 匹配 $ (Tom) 
。 当 数 据 库 中 有 成 千 上 万 对 象 时 提高 性 能 (Tom) 
。 删除 -u 选项 (该 选项 已 经 很 长 时 间 不 使 用 ) (Tom) 


E.77.3.15. 其 它 客户 端 应 用 程序 
e 在 initdb 中 ， 人 允许 指定 pg_xlog 目录 位 置 (Euler Taveira de Oliveira) 
e pg_regress 中 支持 的 操作 系统 上 启用 服务 器 核心 转 储 生 成 (Andrew) 
。 添加 -t (超时 ) 参 数 到 pg_ctl(Bruce) 


当 等 待 服务 器 启动 或 者 关闭 的 时 人 息 ， 这 将 控制 pg_ctl 等 待 的 多 长 时 间 。 之 前 超时 被 硬 连 
线 为 60 秒 。 


e 添加 pg_ctl 选 项 来 控制 服务 器 核心 转 储 生成 (Andrew) 
© 人 允许 控制 C 取 消 clusterdb，reindexdb 和 vacuumdb (Itagaki Takahiro, Magnus) 
e *createdb, createuser, dropdb4l dropuser 抑 制 命令 标签 输出 (Peten) 


忽略 --quiet 选项 ， 并 且 在 8.4 中 删除 。 当 在 数据 库 上 操作 定位 到 标准 输出 上 而 非 标准 错 
误 上 时 ， 促 进 信息 ， 因 为 它们 并 不 是 真正 错误 。 


E.77.3.16. libpq 


如 果 它 包含 一 个 等 号 ， 那 么 解析 posetdblogin() 的 dbname 参数 作为 conninfo 字符 串 
(Andrew) 


这 人 允许 客户 端 程 序 中 conninfo 字符 串 的 使 用 仍然 使 用 PasetdbLogin() o 
支持 全 局 SSL 配 置 文件 (Victor Wagner) 

添加 环境 变量 PessLkEY 支持 SSL 硬 件 密 钥 (Victor Wagner) 

为 大 对 象 截断 添加 lo_truncate() (Kris Jurka) 


如 果 服 务 器 需要 密码 但 是 没有 提供 ， 那么 添加 PQconnectionNeedsPassword() 返回 真 (Joe 
Conway, Tom) 


如 果 失 败 连接 尝试 后 返回 真 ， 那 么 客户 端 应 用 程序 应 该 提示 用 户 输 入 密码 。 以 往 应 用 程 
序 不 得 不 检查 一 个 特定 的 错误 消息 字符 串 以 决定 是 否 需要 密码 ; 这 种 方法 现在 已 经 弃 
用 。 


如 果 提 供 的 密码 已 经 被 使 用 ， 那 么 添加 PaconnectionusedPassword() 返回 真 (Joe Conway, 
Tom) 


这 在 一 些 安全 的 地 方 是 有 用 的 ， 知 道 用 户 提供 的 密码 是 否 有 效 非常 重要 。 


E.77.3.17. ecpg 


使 用 V3 前 端 /后 端 协议 (Michael) 

这 添加 了 对 服务 器 端 预备 语句 的 支持 。 

使 用 本 地 支持 ， 而 不 是 Windows 上 pthreads(Magnus) 
是 高 ecpglib 的 线程 安全 (ltagaki Takahiro) 


使 得 ecpg 库 输出 必要 的 API 符 号 (Michael) 


E.77.3.18. Windowsin O 


允许 使 用 Microsoft Visual C++ 编译 整个 PostgreSQL & ta (Magnus 和 其 他 人 ) 


这 人 允许 基于 Windows 的 开发 人 员 可 以 使 用 熟悉 的 开发 和 调试 工具 。 用 Visual C++ 制作 的 
Windows 可 执行 文件 比 用 其 他 工具 集 制作 的 可 能 有 更 好 的 稳定 性 和 性 能 。 已 经 删除 仅仅 
客户 端的 Visual C++ 编译 脚本 。 


当 有 许多 子 进程 的 时 候 ， 大 大 减少 postmaster 的 内 存 使 用 (Magnus) 


允许 通过 管理 用 户 馈 动 回 为 测 试 (Magnus) 


添加 本 地 共享 内 存 实现 (Magnus) 


E.77.3.19. 服务 器 编程 接口 (SPI) 


在 SPI 中 添加 游标 相关 功能 (Pavel Stehule) 

允许 访问 游标 相关 规划 选项 ， 并 且 添 加 FETcH / move 程序 。 
允许 通过 spPI_execute 执行 游标 命令 (Tom) 

宏 SPI_ERROR_CURSOR 仍然 存在 但 永远 不 会 被 返回 。 

SPI 规 划 指 针 被 声明 为 spIPlanptr 而 不 是 void * (Tom) 


这 不 会 破坏 应 用 程序 代码 ， 但 是 推荐 切换 来 帮助 捕获 简单 程序 错误 。 


E.77.3.20. 编译 选项 


添加 configure 选 项 --enable-profiling 用 来 启动 代码 分 析 ( 使 用 gcc 执 行 )(Korry Douglas 
和 Nikhil Sontakke) 


添加 configure 选 项 --with-system-tzdata 用 来 使 用 操作 系统 的 时 区 数据 库 (Peter) 


修复 PGXS， 以 致 于 扩展 会 不 利于 PostgreSQL 的 安装 ， 其 中 pg_config 程 序 没有 首先 出 现 
在 PATH 中 (Tom) 


当 构 建 SGML 文 档 的 时 候 ， 支 持 gmake draft (Bruce) 
除非 使 用 draft ， 如 果 确 保 索 引 是 最 新 的 ， 那 么 文档 建立 将 被 重复 。 


E.77.3.21. 源 代 码 


EMAA DLLIMPORT 到 PGDLLIMPORT 以 避免 与 包含 〈 像 Tcl) 定义 DLLIMPORT 的 第 三 方 冲 
突 (Magnus) 


创建 "操作 符 类 "用 来 改善 涉及 交叉 数据 类 型 比较 的 查询 规划 (Tom) 
更 新 GIN extractQuery() API 人 允许 发 送信 号 没什么 可 以 满足 查询 (Teodor) 
删除 从 postgres_ext.h 到 pg_config_manual.h 的 NAMEDATALEN 定义 (Peter) 


在 所 有 平台 上 提供 strlcpy() 和 strlcat() , 并 且 蔡 换 strncpy() ， strncat() 的 易 出 
错 的 用 法 ， 等 (Peter) 


创建 钩子 以 便 使 外 部 插件 监听 (或 者 其 至 蔡 换 ) 规划 器 并 且 为 假设 情况 创建 规划 (Gurjeet 
Singh, Tom) 


创建 画 数 变量 join_search_hook 让 插件 覆盖 规划 器 的 连接 搜索 顺序 部 分 (Julius Stroffek) 


e 添加 tas() 支持 Renesas 的 M32R 钦 理 器 (Kazuhiro Inaoka) 

e quote_identifier() 和 pg_dump 不 再 引用 依据 语法 未 保留 的 关键 字 (Tom) 

e 改变 NUMERIC 数据 类 型 的 磁盘 上 的 表示 ， 以 致 于 sign_dscale 词 在 权重 之 前 (Tom) 
。 使 用 SYSV 信 号 而 不 是 SYSV >= 6.0, 即 OS X 10.2 及 以 上 的 POSIX(Chris Marcellino) 
e 添加 acronym 和 NFS 文 档 部 分 (Bruce) 


e "Postgres" 作 为 "PostgreSQL" 的 公认 别名 (Peter) 


当 服 务 器 关闭 的 时 候 ， 添 加 关于 避免 数据 库 服务 器 欺骗 的 文档 (Bruce) 


E.77.3.22. Contrib 


e 移动 contrib README 内 容 到 主 PostgreSQL 文 档 (Albert Cervera i Areny) 

© 为 低级 别 页 面 检查 添加 contrib/pageinspect (Simon, Heikki) 

。 为 控制 热 备份 操作 添加 contrib/pg_standby 模块 (Simon) 

。 为 使 用 OSSP UUID 库 生成 uur 值 添 加 contrib/uuid-ossp 模块 (Peter) 
使 用 configure --with-ossp-uuid 激活 ， 这 利用 新 的 uuip AE x Œ 


° 添加 contrib/dict_int , contrib/dict_xsyn 和 contrib/test_parser 模块 提供 样本 的 附 


加 文本 搜索 词典 模板 和 解析 器 (Sergey Karpov) 
e 人 允许 contrib/pgbench 设 置 填 充 因 子 (Pavan Deolasee) 
e 添加 时 间 惟 到 contrib/pgbench -1 (Greg Smith) 
。 添加 使 用 次 数 统计 到 contribypgbuffercache (Greg Smith) 
© 为 contrib/hstore 添加 GIN 支 持 (Teodor) 
e 为 contrib/pg_trgm 添加 GIN 支 持 (Guillaume Smet, Teodor) 
e 在 contrib/start-scripts 中 更 新 OS/X 启 动 脚本 (Mark Cotner, David Fetter) 
e 限制 pgrowlocks() 和 dblink_get_pkey() 到 在 目标 表 上 拥有 seLEcT 权限 的 用 户 中 (Tom) 
e 限制 contrib/pgstattuple 豆 数 到 超级 用 户 (Tom) 
e contrib/xml2 过 时 了 ， 计 划 在 8.4 中 删除 (Peten) 


核心 PostgreSQL 中 新 的 XML 支持 取代 该 模块 。 


E.78. 版 本 8.2.23 


发 布 日 期 : 2011-12-05 


这 个 版 本 包含 各 种 自 8.2.22 以 来 的 修复 。 关 于 8.2 主 版 本 的 新 特性 信息 ， 请 查看 Section 
E101; 


这 预计 是 8.2.X 系 列 的 最 后 一 个 PostgreSQL 版 本 。 建议 用 户 尽快 更 新 到 一 个 新 的 版 本 分 支 。 


E.78.1. 迁移 到 版 本 8.2.23 


运行 8.2.X 的 用 户 不 需要 转 储 /恢复 。 


不 过 ， 在 information_schema.referential_constraints 视图 的 定义 中 发 现 一 个 长 期 存在 的 错 
误 。 如 果 你 依赖 于 该 视图 的 正确 结果 ， 你 应 该 像 下 面 解 释 的 第 一 个 更 新 日 志 项 一 样 替 换 它 的 
定义 。 


还 有 ， 如 果 你 是 从 一 个 早 于 8.2.14 的 版 本 升级 而 来 ， 那 么 请 查看 8.2.14 的 版 本 声明 。 


E.78.2. 修改 列表 


e 修复 在 information_schema.referential constraints 视图 中 的 错误 (Tom Lane) 


这 个 视图 在 匹配 外 键 约束 到 决定 性 的 主键 或 唯一 键 约束 上 不 够 细心 。 这 会 导致 未 能 显示 
外 键 约束 ， 或 者 多 次 显示 外 键 约束 ， 或 者 抱怨 它 依 赖 于 一 个 与 它 实际 依赖 的 不 同 的 约 
束 。 


因为 视图 定义 是 通过 initdb 安 装 的 ， 只 是 升级 将 不 能 修复 该 问题 。 如 果 你 需要 在 一 个 现 有 
的 安装 中 修复 该 问题 ， 你 可 以 〈 作 为 超级 用 户 ) 删除 information_schema 模式 ， 然 后 通 
过 来 源 _sHAREDIR /informationschema. sql 重新 创建 它 。 (如 果 不 确定 

` SHAREDIR 2, 4 pg_config --sharedir。) 必须 在 每 个 要 修复 的 数据 库 中 重复 该 
步骤 。 


o 修复 CREATE TABLE dest AS SELECT * FROM src 或 ， INSERT INTO dest SELECT * FROM src 期 
间 TOAST 相 关 的 数据 损坏 (Tom Lane) 
如 果 一 个 表 通 过 ALTER TABLE ADD COLUMN 修改 了 ， 那么 尝试 逐 字 的 拷贝 它 的 数据 到 另外 
一 个 表 可 能 在 极端 情况 下 产生 损坏 的 结果 。 这 个 问题 只 能 在 8.4 及 以 后 的 版 本 中 以 这 个 精 
确 的 形式 来 验证 ， 不 过 我 们 也 给 早期 的 版 本 打 了 补丁 ， 以 防 有 其 他 的 代码 路 径 会 触发 相 
同 的 错误 。 


。 修复 toast 表 访问 陈旧 的 系统 缓存 记录 时 的 竞 态 条 件 (Tom Lane) 


典型 的 症状 是 像 "missing chunk number 0 for toast value NNNNN in pg_toast_2619" 这 
样 的 瞬 态 错误 ， 这 里 引用 的 toast 表 将 总 是 属于 一 个 系统 目录 。 


改善 money 类 型 的 输入 和 输出 中 的 本 地 支持 (Tom Lane) 


除了 不 支持 所 有 标准 的 1c_monetary 格式 选项 之 外 ， 输 入 和 输出 函数 是 不 考虑 的 ， 意 味 
着 有 的 环境 中 转 储 的 money 值 不 能 被 重新 读 取 。 


让 transform_null_equals 不 影响 CASE foo WHEN NULL ... 结构 (Heikki Linnakangas) 


transform_null_equals 只 应 该 影响 直接 由 用 户 编写 的 foo = NULL 表达 式 ， 不 等 
于 cAsE 的 这 个 格式 内 部 产生 的 检查 。 


修改 外 键 触发 器 创建 ， 要 求 更 好 的 支持 自我 引用 的 外 键 (Tom Lane) 


对 于 一 个 引用 自身 的 表 的 级 联 外 键 ， 一 个 行 更 新 将 作为 一 个 事件 触发 oN uPDATE 触发 器 
和 check 触发 器 。 必 须 先 执行 on UPDATE 触发 器 ， 否则 cHEck 将 检查 一 个 行 的 非 最 终 状 
态 ， 并 且 可 能 抛 出 一 个 不 合适 的 错误 。 然而 ， 这 些 触发 器 的 触发 顺序 是 通过 他 们 的 名 字 
决定 的 ， 通 常 以 特定 的 顺序 排序 ， 因为 触发 器 有 自动 生成 的 名 字 ， 遵 从 约 

定 "RI_ConstraintTrigger_NNNN"。 修改 该 约定 将 需要 一 个 适当 的 修复 ， 我 们 将 在 9.2 中 
实现 ， 但 是 在 现 有 的 版 本 中 修改 它 似乎 是 危险 的 。 所 以 这 个 路 径 只 是 改变 了 触发 器 的 创 
建 顺序 。 用 户 遇 到 这 个 类 型 的 错误 时 应 该 删除 并 重建 外 键 约束 ， 以 使 它 的 触发 器 的 顺序 
正确 。 


保护 psdql 命 邻 历史 中 的 命令 中 的 空 行 (Robert Haas) 
例如 ， 如 果 从 一 个 字符 串 文 本 中 删除 了 一 个 空 行 ， 前 者 的 行为 会 导致 问题 。 


使 用 xsubpp 的 首选 版 本 建立 PL/Perl， 不 一 定 是 操作 系统 的 主要 拷贝 (David Wheeler 和 
Alex Hunsaker) 


遵从 pgstatindex() 中 的 查询 取消 立即 中 断 (Robert Haas) 

确保 VPATH 构 建 适当 的 安装 所 有 的 服务 器 头 文件 (Peter Eisentraut) 

缩短 在 详细 错误 消息 中 报告 的 文件 名 (Peter Eisentraut) 

常规 的 构建 总 是 只 是 报告 包含 错误 消息 调用 的 C 文 件 的 名 字 ， 但 是 VPATH 构 建 以 前 报告 
一 个 绝对 路 径 名 。 

为 Central America 修 复 Windows 时 区 名 的 解释 (Tom Lane) 


映射 "Central America Standard Time" 到 cste ， 而 不 是 csT6cpT ， 因 为 DST 通 常 没有 观 
察 到 Central America 的 每 一 个 地 方 。 


更 新 时 区 数据 文件 到 tzdata 版 本 2011n， 因 为 DST 规 律 在 Brazil、Cuba、 Fiji, 
Palestine、Russia 和 Samoa 发 生 了 改变 ; 还 为 Alaska 和 British East Africa 做 了 历史 纠 
iE, 
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E.79. 版 本 8.2.22 


发 布 日 期 : 2011-09-26 


这 个 版 本 包含 各 种 自 8.2.21 以 来 的 修复 。 关 于 8.2 主 版 本 的 新 特性 信息 ， 请 查看 Section 
E.101; 


PostgreSQL 社 区 将 在 2011 年 12 月 停止 对 8.2.X 版 本 系列 发 布 更 新 。 建议 用 户 尽快 更 新 到 一 个 
新 的 版 本 分 支 。 


E.79.1. 迁移 到 版 本 8.2.22 


运行 8.2.X 的 用 户 不 需要 转 储 /恢复 。 不 过 ， 如 果 你 是 从 一 个 早 于 8.2.14 的 版 本 升级 而 来 ， 那么 
请 查看 8.2.14 的 版 本 声明 。 


E.79.2. 修改 列表 


。 修复 GiST 索 引 页 分 裂 处理 中 的 多 个 错误 (Heikki Linnakangas) 
发 生 的 可 能 性 很 低 ， 但 是 会 导致 索引 损坏 。 

。 避免 ANALYzE 中 可 能 的 访问 关闭 内 存 的 结尾 (Noah Misch) 
这 修复 了 一 个 非常 低 可 能 的 服务 器 崩溃 情况 。 

。 修复 relcache 初 始 化 文件 失效 中 的 竞 态 条 件 (Tom Lane) 


新 的 后 端 进程 中 有 一 个 窗口 会 读 取 陈 旧 的 初始 化 文件 ， 但 
的 的 inval 消 息 。 结果 会 是 目录 访问 中 奇怪 的 失败 ， 典 型 的 
block 0 in file ...". 


诉 它 该 数据 是 陈旧 


是 错过 会 告 
是 在 启动 后 "could not read 


在 


。 修复 GiST 索 引 打 描 结束 时 的 内 存 泄露 (Tom Lane) 


执行 许多 独立 GiST 索 引 打 描 的 命 分 ， 上 比如 在 一 个 早已 包含 许多 行 的 表 上 新 建 基 于 GiST 的 
排除 约束 的 验证 ， 由 于 这 个 泄露 ， 可 能 会 在 瞬间 需要 大 量 的 内 存 。 


。 修复 构建 一 个 大 型 的 、 有 损耗 的 位 图 时 的 性 能 问题 (Tom Lane) 
。 修复 数组 和 路 径 创 建 画 数 ， 确 保 填 充 字 节 是 需 (Tom Lane) 
这 避免 了 一 些 规划 器 认为 语义 上 相等 的 常数 不 等 ， 导 致 欠 佳 的 最 优化 的 情况 。 


。 绕 开 中 断 WAL 重 放 的 gcc 4.6.0 bug (Tom Lane) 


这 可 能 导致 在 服务 器 崩溃 后 丢失 已 提交 的 事务 。 

修复 一 个 视图 中 vatues 的 转 储 bug (Tom Lane) 

不 允许 在 一 个 序列 上 SELECT FoR UPDATE/SHARE (Tom Lane) 

这 个 操作 不 想 预 期 的 那样 工作 ， 并 且 会 导致 失败 。 

计算 一 个 哈 希 表 的 大 小 时 ， 防 止 整数 浴 出 (Tom Lane) 

修复 "peer" 认 证 的 证 书 控制 消息 中 正在 使 用 的 潜在 的 bug (Tom Lane) 
修复 pg_srand48 种 子 的 初始 化 中 的 打印 错误 (Andres Freund) 


这 导致 霖 能 使 用 提供 的 种 子 的 所 有 位 。 这 个 豆 数 没有 在 大 多 数 平台 上 使 用 (RAPER 
有 srandonm 的 平台 ) ， 并 且 在 任何 情况 下 ， 比 预期 的 随机 少 的 多 下 种 子 似乎 很 小 ， 有 洪 
在 的 安全 风险 。 


当 LIMIT 和 oFFsET 值 的 和 超过 2^63 时 ， 避免 整数 浴 出 (Heikki Linnakangas) 
添加 浴 出 检查 到 generate_series() 的 int4 和 ints 版 本 (Robert Haas) 

修复 to_char() 中 的 尾随 需 的 删除 (Marti Raudsepp) 

在 Fm 并 且 小 数 点 后 没有 数字 位 的 格式 中 ， 小 数 点 左 侧 的 需 可 能 会 被 错误 的 删除 。 
修复 pg_size_pretty() ， 避 免 接 近 2^63 的 输入 浴 出 (Tom Lane) 

修复 从 一 个 不 同 的 文件 copy 期 间 ，psdl 的 脚本 文件 行 号 的 计数 (Tom Lane) 

为 standard_conforming_strings 修复 pg_restore 的 直接 到 数据 库 模式 (Tom Lane) 


当 从 一 个 standard_conforming_strings 设置 为 on 制作 的 兴 档 文件 中 直接 恢复 到 一 个 数 
据 库 服务 器 时 ，pg_restore 可 能 发 出 不 正确 的 命令 。 


修复 libpq 的 LDAP 服 务 查 找 代 码 中 的 过 去 写 缓 冲 区 结束 和 内 存 泄 露 (Albe Laurenz) 
在 libpq 中 ， 避 免 使 用 非 闭塞 的 MO 和 SSL 连 接 时 的 失败 (Martin Pihlak, Tom Lane) 
改善 连接 启动 期 间 libpq 对 失败 的 处 理 (Tom Lane) 

特别 的 ，SSL 连 接 和 启动 期 间 响 应 forko 失败 的 服务 报告 现在 更 加 理智 。 

让 ecpglib 用 15 位 精度 写 double 值 (Akira Kurosawal) 

为 blowfish 带 符号 字符 bug 应 用 逆向 修复 (CVE-2011-2483) 


contrib/pg_crypto 的 blowfish 加 密 代 码 在 字符 是 有 符号 的 平台 上 (大 多 数 是 这 样 ) 会 给 
出 错误 的 结果 ， 导 致 加 密 的 口令 比 应 该 的 要 弱 。 


修复 contrib/seg 中 的 内 存 泄露 (Heikki Linnakangas) 


修复 pgstatindex() ， 为 空 素 引 给 出 一 致 的 结果 (Tom Lane) 
允许 使 用 perl 5.14 建 立 (Alex Hunsaker) 

为 系统 玉 数 存在 的 检测 更 新 配置 脚本 的 方法 (Tom Lane) 

我 们 在 8.3 和 8.2 中 使 用 的 autoconf 版 本 会 被 执行 连接 时 优化 的 编译 器 愚弄 。 
修复 建立 和 安装 文件 路 径 包 含 空 格 的 各 种 问题 (Tom Lane) 


更 新 时 区 数据 文件 到 tzdata 版 本 2011i， 因为 DST 规 律 在 Canada、Egypt、Russia、 
Samoa 和 South Sudan 发 生 了 改变 。 


E.80. 版 本 8.2.21 


发 布 日 期 : 2011-04-18 


这 个 版 本 包含 各 种 自 8.2.20 以 来 的 修复 。 关 于 8.2 主 版 本 的 新 特性 信息 ， 请 查看 Section 
E.101; 


E.80.1. 迁移 到 版 本 8.2.21 


运行 8.2.X 的 用 户 不 需要 转 储 /恢复 。 不 过 ， 如 果 你 是 从 一 个 早 于 8.2.14 的 版 本 升级 而 来 ， 那么 
请 查看 8.2.14 的 版 本 声明 。 


E.80.2. 修改 列表 


。 避免 目录 缓存 初始 化 期 间 潜 在 的 死 锁 (Nikhil Sontakke) 


在 某 些 情 况 下 ， 缓 存 加 载 代 码 会 在 锁定 索引 的 目录 之 前 在 系统 索引 上 请 求 共 享 锁 。 这 可 
能 死 锁 党 试 请 求 排他 锁 的 进程 ， 更 标准 的 顺序 。 


。 当 有 并 发 的 更 新 到 目标 行 时 ， 修 复 BEFORE Row UPDATE 触发 器 多 理 中 的 悬挂 指针 问题 
(Tom Lane) 


经 观察 到 这 个 bug 导 致 在 党 试 执行 UPDATE RETURNING ctid 时 ， 间歇 的 "cannot extract 
attribute from virtual tuple"Am, 有 非常 小 的 可 能 会 有 更 加 严重 的 错误 ， 比 如 为 
更 新 的 元 组 产生 不 正确 的 索引 项 。 


。 当 表 有 等 待 延 迟 触发 器 事件 时 ， 不 允许 DRoP TABLE (Tom Lane) 
以 前 prop 会 通过 ， 导 致 触发 器 最 终 触 发 时 "could not open relation with OID nnn" 错 误 。 
。 修复 包含 数组 切片 的 PL/Python 内 存 泄露 (Daniel Popowich) 
。 修复 pg_restore 以 处 理 TOC 文 件 中 的 长 行 (超过 1KB) (Tom Lane) 
e 针对 由 于 过 度 热 情 的 编译 器 优化 被 堆 除 引起 的 月 淡 投 入 更 多 的 保障 (Aurelien Jarno) 
。 支持 在 FreeBSD 和 OpenBSD 中 的 MIPS 上 的 使 用 dlopen() (Tom Lane) 


有 一 个 硬件 连接 的 假设 ， 这 些 系统 画 数 在 这 些 系 统 的 MIPS 硬 件 上 不 可 用 。 使 用 一 个 编译 
时 测试 蔡 代 ， 因 为 最 近 的 版 本 已 经 可 以 了 。 


。 修复 HP-UX 上 的 编译 失败 (Heikki Linnakangas) 


。 修复 Crywin 上 pg _regress 使 用 的 路 径 分 隔 符 (Andrew Dunstan) 


。 更 新 时 区 数据 文件 到 tzdata 版 本 2011f， 因为 DST 规 律 在 Chile、Cuba、Falkland 
lslands、Morocco、Samoa 和 Turkey 发 生 了 改变 ; 还 为 South Australia、Alaska 和 
Hawaii 做 了 历史 纠正 。 


E.81. 版 本 8.2.20 


发 布 日 期 : 2011-01-31 


这 个 版 本 包含 各 种 自 8.2.19 以 来 的 修复 。 关 于 8.2 主 版 本 的 新 特性 信息 ， 请 查看 Section 
E.101; 


E.81.1. 迁移 到 版 本 8.2.20 


运行 8.2.X 的 用 户 不 需要 转 储 /恢复 。 不 过 ， 如 果 你 是 从 一 个 早 于 8.2.14 的 版 本 升级 而 来 ， 那么 
查看 8.2.14 的 版 本 声明 。 


iB 
请 


E.81.2. 修改 列表 


o 避免 EXPLAIN 党 试 显示 一 个 case 表达 式 的 简单 格式 时 的 失败 (Tom Lane) 


如 果 case 的 测试 表达 式 是 一 个 常量 ， 规 划 器 将 简化 case 为 一 个 混淆 表达 式 显 示 代 码 的 
格式 ， 导 致 "unexpected CASE WHEN clause" 错 误 。 


。 修复 分 配给 数组 切片 的 下 标 在 现 有 范围 之 前 (Tom Lane) 


如 果 在 新 添加 的 下 标 和 已 经 存在 的 下 标 之 间 存 在 间隔 ， 代码 错误 计算 有 多 少 项 需要 从 老 
的 数组 的 空位 图 中 拷贝 ， 潜在 的 导致 数据 损坏 或 月 演 。 


避免 规划 器 中 非常 遥远 的 日 期 值 意外 的 转换 浴 出 (Tom Lane) 


date 类 型 比 timestamp 类 型 可 以 表示 的 日 期 支持 的 范围 更 加 广泛 ， 但 是 规划 器 假设 它 总 
是 可 以 将 日 期 转换 为 时 间 惟 而 不 受 惩罚 。 


修复 启用 standard_conforming_strings 时 ， pg_restore 为 大 对 象 (BLOBs) 的 文本 输出 
(Tom Lane) 


尽管 直接 恢复 到 一 个 数据 库 能 正确 的 工作 ， 但 是 如 果 pg_restore 要 求 SQL 文 本 输出 
和 standard_conforming_strings 已 经 在 源 数据 库 中 启用 了 的 话 ， 字符 串 的 逃逸 是 不 正确 
的 。 


修复 包含 ...& !(subexpression) | ... BY tsquery 值 的 错误 解析 (Tom Lane) 


包含 这 种 操作 符 组 合 的 查询 没有 正确 的 执行 ， 相 同 的 错误 存在 于 contrib/intarray 
的 query_int 类 型 和 contrib/ltree 的 1txtquery 类 型 中 。 


e 为 query_int 类 型 修复 contrib/intarray WA ABBY PR ae (Apple) 


个 错误 是 一 个 安全 风险 ， 因 为 该 画 数 的 返回 地 址 可 能 会 被 重 写 。 感谢 Apple Inc 的 安全 
个 问题 并 且 提 供 该 修复 。 (CVE-2010-4015) 


修复 contrib/seg 的 GiST picksplit 算 法 中 的 bug (Alexander Korotkov) 


这 会 导致 相当 大 的 低 效 ， 尽 管 不 是 真 的 错误 回复 ， 在 seg 字段 的 GiST 索 引 中 。 如 果 你 有 
这 样 的 一 个 索引 ， 考 虑 在 安装 这 个 更 新 之 后 REINDEX 它 。 (这 和 在 以 前 的 更 新 中 
的 contrib/cube 中 修复 的 错 误 相 同 。 ) 


E.82. 版 本 8.2.19 


发 布 日 期 : 2010-12-16 


这 个 版 本 包含 各 种 自 8.2.18 以 来 的 修复 。 关 于 8.2 主 版 本 的 新 特性 信息 ， 请 查看 Section 
E.101; 


E.82.1. 迁移 到 版 本 8.2.19 


运行 8.2.X 的 用 户 不 需要 转 储 /恢复 。 不 过 ， 如 果 你 是 从 一 个 早 于 8.2.14 的 版 本 升级 而 来 ， 那么 
请 查看 8.2.14 的 版 本 声明 。 


E.82.2. 修改 列表 


e 强制 Linux 上 wal sync method 的 缺 省 为 fdatasync (Tom Lane, Marti Raudsepp) 


在 Linux 上 的 该 缺 省 实际 上 是 fdatasync 已 经 很 多 年 了 ， 但 是 最 近 的 内 核 更 改 导致 
PostgreSQL 选 择 了 open_datasync 。 这 个 选择 没有 导致 任何 性 能 改善 ， 并 且 在 某 些 文件 
系统 上 引起 彻底 的 失败 ， 尤其 是 iii data=journal 挂 载 选项 的 ext4 o 


。 为 GIN 索 引 修 复 WAL 重 放 逻 辑 中 的 各 种 错误 (Tom Lane) 
可 能 在 复制 期 间 导致 "bad buffer id: 0" 失 败 或 素 引 内 容 的 损坏 。 


e。 当 开 始 检查 点 WAL 记 录 和 它 的 重 做 点 不 在 相同 的 WAL 段 时 ， 修 复 从 基础 各 份 的 恢复 (Jeff 
Davis) 


。 添加 对 检测 IA64 上 寄存 器 堆栈 浴 出 的 支持 (Tom Lane) 

IA64 体系 结构 有 两 个 硬件 堆栈 。 堆 栈 渝 出 失败 的 全 面 预防 需要 两 个 堆栈 都 检查 。 
e 为 copyobject() 中 的 堆栈 渝 出 添加 检查 (Tom Lane) 

由 于 堆栈 渝 出 给 出 一 个 足够 复杂 的 查询 ， 某 些 代码 路 径 可 能 会 月 淡 。 
。 修复 临时 GiST 索 引 中 页 分 裂 的 检测 (Heikki Linnakangas) 


在 一 个 临时 索引 中 有 "并 发 的 "页 分 裂 是 可 能 的 ， 比 如 说 ， 执行 一 个 插入 时 有 一 个 打开 的 
ees GiST 未 能 检测 这 个 情况 ， 并 且 因此 在 该 游标 的 执行 继续 时 会 交付 错误 的 
结果 。 


e 当 ANALYZE 复杂 索引 表达 式 时 ， 避 人 免 内 存 泄露 (Tom Lane) 
。 确保 使 用 整 行 变 量 的 素 引 仍然 依赖 于 它 的 表 (Tom Lane) 


像 create index i on t (foo(t.*)) 这 这 样 声 BABY SSI, 在 它 的 表 被 删除 时 ， 将 不 会 自 动 被 
W IR. 


不 要 用 多 个 our SR'inline"—SSQLHR (Tom Lane) 


这 避 鲍 了 由 于 丢失 预期 的 结果 行 类 型 的 信息 而 引起 的 可 能 的 月 渍 。 
如 果 ORDER BY 、 LIMIT, FOR UPDATE 或 WITH 附属 于 INSERT ... VALUES 的 vALuES 部 


分 则 正确 的 行为 (Tom Lane) 

修复 coALESCE() FIAT Sis (Tom Lane) 

规划 器 有 时 会 尝试 计算 实际 永远 不 可 能 达到 的 子 表达 式 ， 可 能 导致 意外 的 错误 。 
为 InhRelation 节点 添加 打印 功能 (Tom Lane) 

这 避免 了 启用 debug print_parse 并 且 执 行 了 某 些 类 型 的 查询 时 的 失败 。 

修复 点 到 水 平 线段 的 距离 的 不 正确 的 计算 (Tom Lane) 

这 个 错误 影响 几 个 不 同 的 几何 距离 测量 操作 。 

修复 PL/pgSQL 对 "简单 "表达 式 的 处 理 ， 在 递归 或 错误 恢复 的 情况 下 不 会 失败 (Tom Lane) 
修复 PL/Python 对 设置 返回 范 数 的 处 理 (Jan Urbanski) 

尝试 在 迭代 器 中 调用 SPI 函 数 生成 一 组 结果 将 会 失败 。 

修复 contrip/cube 的 GiST picksplit 算 法 中 的 错误 (Alexander Korotkov) 


会 导致 相当 大 的 低 效 ， 尽 管 不 是 实际 上 不 正确 的 答案 ， 在 一 个 cube 字段 的 GiST 索 引 
i 如 果 你 有 这 样 的 一 个 索引 ， 考 虑 在 安装 这 个 更 新 之 后 REINDEX 它 。 


不 要 在 contrib/dblink 中 发 出 "标识 符 将 被 截断 "的 通知 ， 除非 创建 新 的 连接 (Itagaki 
Takahiro) 


修复 contrip/pgcrypto 中 丢失 的 公共 键 上 潜在 的 内 核 转 储 (Marti Raudsepp) 
修复 contrib/xm12 的 XPath 查询 范 数 中 的 内 存 泄 露 (Tom Lane) 


更 新 时 区 数据 文件 到 tzdata 版 本 20100， 因为 DST 规 律 在 Fijij 和 Samoa 发 生 了 改变 ; 还 为 
Hong kong 做 了 历史 纠正 。 


E.83. 版 本 8.2.18 


发 布 日 期 : 2010-10-04 


这 个 版 本 包含 各 种 自 8.2.17 以 来 的 修复 。 关 于 8.2 主 版 本 的 新 特性 信息 ， 请 查看 Section 
E.101。 


E.83.1. 迁移 到 版 本 8.2.18 


运行 8.2.X 的 用 户 不 需要 转 储 /恢复 。 不 过 ， 如 果 你 是 从 一 个 早 于 8.2.14 的 版 本 升级 而 来 ， 那么 
查看 8.2.14 的 版 本 声明 。 


iB 
请 


E.83.2. 修改 列表 


。 为 每 个 在 PL/Perl 和 PL/Tcl 中 调用 的 SQL userid 使 用 一 个 单独 的 解释 器 (Tom Lane) 


这 个 修改 阻止 了 通过 破坏 稍 后 由 另 一 个 SQL 用 户 身份 在 同一 个 会 话 中 执行 的 Perl 或 Tcl 代 
码 引 起 的 安全 问题 (例如 ， 在 一 个 securtty DEFINER WAH) 。 大 多 数 脚 本 语言 提供 多 
种 可 能 实现 的 方式 ， 比 如 重新 定义 被 目标 函数 调用 的 标准 本 数 或 操作 符 。 没有 这 个 修 
改 ， 任 何 拥有 Perl 或 Tcl 语 言 使 用 权限 的 SQL 用 户 基 本 上 都 可 以 用 目标 函数 所 有 者 的 SQL 
权限 做 任何 事情 。 


这 个 修改 的 代价 是 Perl 和 Tcl 范 数 之 间 有 意 的 沟通 变 得 更 加 困难 。 为 了 提供 一 个 安全 出 
口 ，PL/PerlU 和 PL/TclU 函 数 继 续 每 个 会 话 只 使 用 一 个 解释 器 。 这 不 认为 是 一 个 安全 问 
题 ， 因 为 所 有 这 样 的 函数 都 早已 在 数据 库 超 级 用 户 的 信任 级 别 执行 。 

有 可 能 第 三 方 过 程 语 言 提供 的 受信 任 的 执行 有 相似 的 安全 问题 。 我 们 建议 为 了 安全 鉴定 
的 目的 ， 联 系 任何 你 依赖 的 PL 的 作者 。 

感谢 Tim Bunce 指 出 这 个 问题 (CVE-2010-3433)。 


e 通过 不 允许 pg_get_expr() 被 一 个 不 是 系统 目录 字段 的 参数 调用 ， Bite HABER ARS 
(Heikki Linnakangas, Tom Lane) 


修复 Windows 共 享 内 存 分 配 代码 (Tsutomu Yamada, Magnus Hagander) 


这 个 错误 导致 经 常 报道 "不 能 重新 连接 上 共享 内 存 "错误 消息 。 这 是 一 个 后 向 修复 ， 前 段 
时 间 已 经 应 用 到 了 新 的 分 支 。 


在 Windows 上 将 退出 代码 128( ERROR_WAIT_NO_CHILDREN ) 看 做 非 严 重 错 误 (Magnus 
Hagander) 


在 高 负载 下 ，Windows 进 程 有 时 会 常 有 这 个 错误 代码 在 后 动 时 失败 。 以 前 主 进程 将 它 看 
做 一 个 恐慌 条 件 ， 并 重 后 整个 数据 库 ， 但 是 这 样 看 起 来 像 是 过 度 反应 。 


修复 可 能 的 union ALL 成 员 关 系 的 重复 扫描 (Tom Lane) 
修复 "不 能 义理 未 计划 的 子 查询 "错误 (Tom Lane) 
这 在 子 查询 包含 一 个 扩展 成 包含 另 一 个 子 查询 的 表达 式 的 连接 别名 引用 时 发 生 。 


降低 某 些 偶然 报告 的 btree 失 败 情 况 中 的 PANIC 为 ERROR， 并 在 结果 错误 消息 中 提供 额 
外 的 详细 信息 (Tom Lane) 


会 提高 系统 损坏 素 引 的 和 鲁 棒 性 。 
阻止 show_session_authorization() 在 自动 清理 进程 中 月 溃 (Tom Lane) 
防御 函数 返回 的 记录 集中 不 是 所 有 返回 的 行 都 是 相同 的 行 类 型 (Tom Lane) 
修复 哈 希 一 个 通过 引用 传递 的 函数 结果 时 可 能 的 失败 (Tao Ma, Tom Lane) 
在 写 人 锁 文 件 时 ， 小 心 同 步 锁 文 件 的 内 容 ( postmaster.pid 和 套 接 字 锁 文件 ) (Tom 


Lane) 


如 果 机 器 在 主 进程 启动 之 后 不 久 就 月 演 了 ， 那 么 这 个 政 忽 会 导致 损坏 锁 文件 的 内 容 。 反 
过 来 阻止 随后 启动 主 进程 的 尝试 成 功 ， 直 到 手动 删除 了 锁 文 件 。 


避免 指定 XID 到 深度 和 伐 套 的 子 事务 时 递归 (Andres Freund, Robert Haas) 

如 果 堆 栈 空 间 有 限 ， 那 么 原先 的 代码 会 导致 月 溃 。 

修复 1og_line_prefix 的 %i 逃逸 ， 它 可 能 在 后 端 启动 时 就 产生 垃圾 (Tom Lane) 
修复 启用 为 档 时 ， ALTER TABLE ... SET TABLESPACE 中 可 能 的 数据 损坏 (Jeff Davis) 


人 允许 CREATE DATABASE 和 ALTER DATABASE ... SET TABLESPACE 被 查询 取消 中 断 (Guillaume 
Lelarge) 


在 PL/Python 中 ， 防 御 来 自 pycobject_AsVoidPtr 和 pycobject_Fromvoidptr 的 空 指针 结果 
(Peter Eisentraut) 


改善 contrib/dblink 对 包含 删除 字段 的 表 的 处 理 (Tom Lane) 
修复 contrib/dblink 中 "重复 的 连接 名 " 错误 之 后 的 连接 泄露 (ltagaki Takahiro) 
修复 contrib/dblink ， 正 确 的 处 理 基 于 62 字 节 的 连接 名 (Itagaki Takahiro) 


添加 hstore(text，text) 图 数 到 contrib/hstore (Robert Haas) 


推荐 这 个 函数 作为 现在 废弃 的 zegt; 操作 符 的 蔡 代 品 。 它 是 后 向 修复 的 ， 所 以 不 会 过 时 
的 代码 可 以 使 用 老 的 服务 器 版 本 。 请 注意 ， 该 修复 将 只 在 特定 的 数据 库 中 安装 或 重新 安 


48 contrib/hstore 之 后 生效 。 用 户 可 能 更 喜欢 手动 执行 CREATE FUNCTION 命令 。 


更 新 建立 的 基础 结构 和 文档 ， 反 应 源 代码 资源 库 从 CVS 搬 到 了 Git (Magnus Hagander 
and others) 


更 新 时 区 数据 文件 到 tzdata 版 本 20101， 因为 DST 规 律 在 Egypt 和 Palestine 发 生 了 改变 ; 
还 为 Finland 做 了 历史 纠正 。 


这 个 修改 还 为 两 个 Micronesian 时 区 添加 了 新 的 名 字 : Pacific/Chuuk 现 在 优先 于 
Pacific/Truk (首选 的 缩写 是 CHUT 不 是 TRUT) ， 和 Pacific/Pohnpei 优 先 于 
Pacific/Ponape. 


让 Windows 的 "N. Central Asia Standard Time" 时 区 映射 到 Asia/Novosibirsk， 而 不 是 
Asia/Almaty (Magnus Hagander) 


微软 在 KB976098 的 时 区 更 新 中 修改 了 这 个 时 区 的 DST 行 为 。 Asia/Novosibirsk 是 它 的 新 
行为 的 最 好 的 匹配 。 


E.84. 版 本 8.2.17 


发 布 日 期 : 2010-05-17 


这 个 版 本 包含 各 种 自 8.2.16 以 来 的 修复 。 关 于 8.2 主 版 本 的 新 特性 信息 ， 请 查看 Section 
E.101; 


E.84.1. 迁移 到 版 本 8.2.17 


运行 8.2.X 的 用 户 不 需要 转 储 /恢复 。 不 过 ， 如 果 你 是 从 一 个 早 于 8.2.14 的 版 本 升级 而 来 ， 那么 
请 查看 8.2.14 的 版 本 声明 。 


E.84.2. 修改 列表 


。 使 用 一 个 开放 标记 而 不 是 使 用 safe.pm 应 用 到 整个 解释 器 ， 在 plperl 中 实施 限制 (Tim 
Bunce, Andrew Dunstan) 


ans 向 我 们 证 实 : Safe .pm 不 够 安全 ， 不 能 依赖 它 标记 plperl 是 可 信任 的 。 
个 修改 一 起 删除 了 对 safe.pm 的 使 用 ， 为 了 支持 总 是 使 用 一 个 带 有 开放 代码 标记 的 单 

eae ABATAR- HE : 在 plperl 中 以 自然 的 方式 使 用 Perl 

的 strict 编程 现在 是 可 能 的 了 ， 并 且 Perl 的 sa 和 sb 变量 在 短 例 程 中 像 预 期 的 那样 工 

作 了 ， 并 且 画 数 的 编译 显著 的 更 快 了 。 (CVE-2010-1169) 


e 阻止 PL/Tcl 执 行 来 自 pltcl_ modules 的 不 可 靠 的 代码 (Tom) 


PL/Tcl 从 数据 库 表 自动 加 载 Tcl 代 码 的 特性 会 被 特洛伊 木马 攻击 利用 ， 因为 没有 限制 谁 可 
以 创建 或 插入 到 那个 表 。 这 个 修改 禁用 了 该 特性 ， 除非 pltcl modules 属于 超级 用 户 。 
(不 过 ， 该 表 上 的 权限 是 没有 检查 的 ， 所 以 真实 需要 较 少 安全 模块 表 的 安装 仍然 可 以 赋 
予 适当 的 权限 给 受信 任 的 非 超 级 用 户 。) 另外， 阻止 加 载 代 码 到 无 限制 的 "普通 "Tcl 解 释 
器 ， 除非 我 们 真 的 想 要 执行 pltclu WRX (CVE-2010-1170) 


。 如 果 在 重建 relcache 项 期 间接 收 到 一 个 缓存 重 置 消息 ， 修 复 可 能 的 崩溃 (Heikki) 
这 个 错误 是 在 8.2.16 中 修复 相关 的 失败 的 时 候 引 入 的 。 
。 不 允许 非特 权 的 用 户 重 置 超级 用 户 仅 有 的 参数 设置 (Alvaro) 


以 前 ， 如 果 一 个 非特 权 的 用 户 为 他 自己 运行 ALTER USER ... RESET ALL, 或 为 他 拥有 的 
一 个 数据 库 运 行 ALTER DATABASE ... RESET ALL, 将 会 为 该 用 户 或 数据 库 删 除 所 有 特殊 参 
数 设 置 ， 即 使 是 只 应 该 超级 用 户 修改 的 设置 。 现在 ， ALTER 将 只 删除 该 用 户 有 权限 修改 
的 参数 。 


如 果 关 机 发 生 在 context 添加 到 日 志 项 时 ， 避 人 免 后 端 关 闭 期 间 可 能 的 崩溃 (Tom) 


在 某 些 情 况 下 ， 内 容 打 印 画 数 将 会 失败 ， 因 为 当前 事务 在 它 想 要 打印 日 志 消息 时 早已 回 
滚 了 。 


为 现代 的 Perl 版 本 更 新 pl/perl 的 ppport.h (Andrew) 

修复 pl/python 中 的 各 种 内 存 泄露 (Andreas Freund, Tom) 

当 扩 展 一 个 引用 自身 的 变量 时 ， 阻 止 psql 中 的 无 限 递 轨 (Tom) 

修复 psql 的 \copy , TE \copy (select ...) 的 句点 周围 不 添加 空格 (Tom) 
在 数值 文字 的 小 数 点 周围 添加 空格 会 导致 语法 错误 。 

确保 contrib/pgstattuple 加 数 迅速 响应 取消 中 断 (Tatsuhito Kasahara) 


让 服务 器 启动 正确 的 处 理 shmget() 为 一 个 现 有 的 共享 内 存 段 返回 erva 的 情况 (Tom) 


这 个 行为 已 经 在 BSD 了 驱动 的 内 核 上 (包括 OS X) 观察 到 了 。 它 导 致 一 个 完全 误导 的 启动 


失败 抱怨 : 共享 内 存 请 求 尺 寸 过 大 。 

避免 Windows 上 系统 日 志 处 理 中 可 能 的 月 溃 (Heikki) 

更 强劲 的 处 理 Windows 注 册 中 不 完整 的 时 区 信息 (Magnus) 
更 新 一 组 已 知 的 Windows 时 区 名 (Magnus) 


更 新 时 区 数据 文件 到 tzdata 版 本 2010j， 因为 DST 规 律 在 Argentinaa、Australian 
Antarctic, Bangladesh, Mexico, Morocco, Pakistan, Palestine, Russia, Syria, 
Tunisia 发 生 了 改变 ; 还 为 Taiwan 做 了 历史 纠正 。 


另外 ， 添 加 pksT (Pakistan Summer Time) 到 缺 省 的 时 区 缩写 集合 。 


E.85. 版 本 8.2.16 


发 布 日 期 : 2010-03-15 


这 个 版 本 包含 各 种 自 8.2.15 以 来 的 修复 。 关 于 8.2 主 版 本 的 新 特性 信息 ， 请 查看 Section 
E.101。 


E.85.1. 迁移 到 版 本 8.2.16 


运行 8.2.X 的 用 户 不 需要 转 储 /恢复 。 不 过 ， 如 果 你 是 从 一 个 早 于 8.2.14 的 版 本 升级 而 来 ， 那么 
请 查看 8.2.14 的 版 本 声明 。 


E.85.2. 修改 列表 


e 添加 新 的 配置 参数 ssl_renegotiation_limit , 控制 多 久 为 SSL 连 接 做 一 次 会 话 秘 钥 协商 
(Magnus) 


可 以 设置 为 0 来 完全 茶 用 重新 协商 ， 如 果 使 用 了 一 个 破损 的 库 的 话 是 需要 这 样 的 。 特别 
的 ， 一 些 供应 商 为 CVE-2009-3555 提 供 了 紧急 补丁 ， 引 起 重新 协商 的 尝试 失败 。 


。 修复 后 端 启动 期 间 可 能 的 死 锁 (Tom) 


。 修复 由 于 relcache 重 新 干净 的 加 载 期 间 没 有 处理 错 误 引 起 的 可 能 的 崩溃 (Tom) 
。 修复 在 子 事务 启动 中 尝试 从 一 个 错误 中 恢复 时 可 能 的 崩溃 (Tom) 


。 修复 几 个 与 使 用 保存 点 和 客户 端 编码 与 服务 器 编码 不 同 有 关 的 内 存 港 露 (Tom) 
。 修复 GIST 索 引 页 分 裂 的 最 后 恢复 清理 期 间 不 正确 的 WAL 数 据 发 出 (Yoichi Hirai) 


这 会 导致 素 引 损坏 ， 更 其 至 可 能 在 WAL 重 放 期 间 的 一 个 错误 ， 如 果 我 们 很 不 幸 的 在 完成 
一 个 不 完整 的 GIST 插 入 之 后 最 后 恢复 清 人 


e 让 substring() 对 待 所 有 bit 类 型 的 负 的 长 度 为 "所 有 剩余 的 字符 串 " (Tom) 


以 前 的 代码 只 以 这 种 方式 对 待 -1， 并 且 会 为 其 他 负 值 产生 一 个 无 效 的 结果 值 ， 可 能 导致 
崩溃 (CVE-2010-0442)。 


。 修复 整数 到 位 字符 串 的 转换 ， 当 输出 位 的 宽度 比 给 出 的 整数 宽 ， 不 同 于 8 位 的 倍数 时 ， 1E 
确 的 处 理 第 一 部 分 的 字 节 (Tom) 


。 修复 正则 表达 式 匹 配 病理 上 缓慢 的 一 些 情况 (Tom) 


修复 后 端 历史 文件 中 的 stop wal Location 项 ， 当 结 束 位 置 正好 是 一 个 段 的 边缘 时 ， 报 告 
下 一 个 WAL 段 的 名 字 (Itagaki Takahiro) 


修复 更 多 情况 下 临时 文件 的 泄露 (Heikki) 


这 纠正 了 一 个 在 以 前 的 小 版 本 中 引入 的 问题 。 失败 的 一 个 情况 是 plpgsql 函 数 的 返回 集 在 
另 一 个 辑 数 的 异常 处 理 中 调用 时 。 


改善 约束 排除 处 理 布尔 变量 的 情况 ， 特 别 的 ， 让 他 有 可 能 排除 一 个 有 "bool_column = 
false" 约 束 的 分 区 (Tom) 


当 读 取 pg_hba.conf 和 相关 的 文件 时 ， 如 果 @ 出 现在 双 引 号 标记 内 部 ， 那么 就 不 
将 @something 看 做 一 个 文件 包含 请 求 ; 另外 ， KE @ 本 身 看 做 一 个 文件 包含 请 求 
(Tom) 


这 阻止 了 角色 或 数据 库 名 以 @ 开头 时 的 古怪 行为 。 如 果 你 需要 包括 路 径 名 包含 空格 的 文 
件 ， 你 仍然 可 以 这 样 做 ， 但 是 必须 写 @"/path to/file" 而 不 是 让 双 引 号 包含 整个 构造 。 


如 果 一 个 路 径 被 命名 为 pg_hba.conf 和 相关 文件 中 的 包含 目标 ， 那么 阻止 某 些 平台 上 的 
无 限 循环 (Tom) 


如 果 ssL_read 或 SsL_write 没有 设置 errno 而 失败 ， 则 修复 可 能 的 无 限 循环 (Tom) 
据 报 道 ， 这 在 openss|I 的 某 些 Windows 版 本 中 是 可 能 的 。 


修复 psq| 的 numericlocale 选项 ， 不 要 格式 化 不 应 该 是 latex 和 troff 输 出 格式 的 字符 串 
(Heikki) 


当 ON_ERROR_STOP 和 --single-transaction 都 指定 了 并 且 一 个 错误 发 生 在 隐 合 
BY commit 期 间 时 ， 让 psql 返 回 正确 的 退出 状态 (3) (Bruce) 


修复 一 个 复合 字段 设置 为 NULL 情 况 下 的 plpgsql 失 败 (Tom) 

修复 从 PL/PerIU 调 用 PL/Perl 本 数 或 反 过 来 时 可 能 的 失败 (Tim Bunce) 
在 PL/Python 中 添加 volatile 标记 ， 避 免 可 能 的 编译 器 具体 的 错误 行为 (Zdenek Kotala) 
确保 PL/Tcl 完 全 初始 化 Tc 解释 器 (Tom) 

这 个 玻 忽 唯一 已 知 的 症状 是 如 果 使 用 Tcl 8.5 或 更 高 版 本 ， Tcl clock PA 


ae 
Si 

SN 
a 
X 
o 


阻止 太 多 的 关键 字段 指定 到 一 个 dblink_build_sql_* 图 数 时 ， contribydblink PAN AASS 
(Rushabh Lathia, Joe Conway) 


修复 由 于 粗心 的 内 存 管理 引起 的 contrip/xm12 中 的 各 种 崩溃 (Tom) 
让 contrib/xml2 的 建立 在 Windows 上 更 加 稳健 (Andrew) 


修复 Windows 信 号 处 理 中 的 竞 态 条 件 (Radu llie) 


这 个 错误 一 个 已 知 的 症状 是 pg_listener 中 的 行 在 重负 载 的 情况 下 会 被 删除 。 


。 更 新 时 区 数据 文件 到 tzdata 版 本 2010e， 因为 DST 规 律 在 Bangladesh、Chile、 Fiji, 
Mexico、Paraguay、Samoa 发 生 了 改变 。 


E.86. 版 本 8.2.15 


发 布 日 期 : 2009-12-14 


这 个 版 本 包含 各 种 自 8.2.14 以 来 的 修复 。 关 于 8.2 主 版 本 的 新 特性 信息 ， 请 查看 Section 
E.101。 


E.86.1. 迁移 到 版 本 8.2.15 


运行 8.2.X 的 用 户 不 需要 转 储 /恢复 。 不 过 ， 如 果 你 是 从 一 个 早 于 8.2.14 的 版 本 升级 而 来 ， 那么 
请 查看 8.2.14 的 版 本 声明 。 


E.86.2. 修改 列表 


。 防御 由 于 索引 本 数 改变 会 话 本 地 状态 引起 的 间接 安全 威胁 (Gurjeet Singh, Tom) 
这 个 修改 阻止 了 据说 不 变 的 索引 本 数 有 可 能 破坏 超级 用 户 的 会 话 (CVE-2009-4136)。 
。 拒绝 在 公共 名 (CN) 字段 中 包含 一 个 戏 入 的 空 字 节 的 SSL 认 证 (Magnus) 
这 阻止 了 SSL 校 验 期 间 证 书 到 服务 器 或 客户 端 名 的 无 意 的 匹配 (CVE-2009-4034)。 
。 修复 后 端 启 动 时 缓存 初始 化 期 间 可 能 的 崩溃 (Tom) 
e 阻止 信号 在 不 安全 的 时 间 中 断 vacuum (Alvaro) 


这 个 修复 阻止 了 vacuum FULL 在 它 早已 提交 了 它 的 元 组 活动 之 后 取消 时 的 PANIC， 和 规 
划 vacuum 在 截断 表 之 后 被 打 断 时 的 瞬 态 错误 。 


。 修复 由 于 哈 希 表 大 小 计算 中 整数 浴 出 引起 的 可 能 的 崩溃 (Tom) 
这 在 哈 希 连接 的 结果 的 大 小 有 非常 大 的 规划 器 估计 时 可 能 发 生 。 
。 修复 inet / cidr 比较 中 非常 少见 的 崩溃 (Chris Mikkelson) 
。 确保 没有 忽略 被 预 各 事务 持 有 的 共享 元 组 级 别 锁 (Heikki) 
。 修复 用 于 在 一 个 子 事务 中 存 取 的 游标 的 临时 文件 的 过 早 删 除 (Heikki) 
e 为 GiST 来 引 页 分 裂 修 复 不 正确 的 逻辑 ， 当 分 裂 依赖 于 索引 的 非 第 一 字段 时 (Paul 


Ramsey) 


e 如 果 回 收 或 删除 一 个 老 的 WAL 文件 在 检查 点 的 结束 失败 ， 那 么 不 要 错误 输出 (Heikki) 


最 好 将 这 个 问题 看 做 是 不 重要 的 ， 并 且 人 允许 检查 点 完成 。 示 来 的 检查 点 将 重 试 移 除 。 这 
样 的 问题 在 正常 的 操作 中 不 会 出 现 ， 但 是 已 经 看 到 会 由 错误 设计 Windows 杀 毒 和 备份 软 
件 引 起 。 


确保 WAL 文 件 不 会 在 Windows 上 反复 的 当 档 (Heikki) 
如 果 一 些 其 他 进程 介入 不 再 需要 的 文件 的 删除 中 ， 这 会 是 另外 一 个 可 能 会 发 生 的 现象 。 
修复 PAM 口 邻 处 理 ， 使 其 更 加 强健 (Tom) 


都 知道 以 前 的 代码 在 组 合 Linux pam_krbs PAM 模 块 和 微软 活动 目录 作为 域 控制 器 时 会 失 
Mo 可 能 在 其 他 地 方 也 会 有 问题 ， 因 为 它 关 于 PAM 堆 栈 会 传送 来 什么 参数 做 了 不 正确 的 


假设 。 

修复 CREATE OR REPLACE FUNCTION 期 间 所 有 权 依 赖 关系 的 处 理 (Tom) 

修复 从 plperlu 调用 plperl 或 反 过 来 调用 时 的 bug (Tom) 

从 内 部 画 数 出 错 退 出 会 导致 由 于 未 能 为 外 部 男 数 重新 选择 正确 的 Perl 解 释 器 而 崩溃 。 
修复 PL/Perl 范 数 重 新 定义 了 时 会 话 寿 命 内 存 泄露 (Tom) 


确保 当 通过 设置 返回 PL/Penl 本 数 返回 时 ，Pernl 数 组 正确 的 转换 到 了 PostgreSQL 数 组 
(Andrew Dunstan, Abhijit Menon-Sen) 


FREER BAP OEHR T o 

123 PL/Python > $ 4438p 2 LEHA (Peter) 

确保 psql 的 flex 模 块 是 用 正确 的 系统 头 文件 定义 编译 的 (Tom) 

这 修复 了 在 --enable-largefile 导致 生成 的 代码 中 不 兼容 的 变化 的 平台 上 的 建立 失败 。 


让 主 进程 忽略 连接 请 求 包 中 的 任何 application_name 参数 ， 以 提高 和 未 来 libpq 版 本 的 兼 
容 性 (Tom) 


更 新 时 区 缩写 文件 ， 匹 配 当 前 的 实际 情况 (Joachim Wieland) 
这 包括 添加 mT 和 ser 到 缺 省 的 时 区 缩写 设置 。 


更 新 时 区 数据 文件 到 tzdata 版 本 2009s， 因为 DST 规 律 在 Antarctica、Argentina、 
Bangladesh, Fiji、Novokuznetsk、 Pakistan、Palestine、Samoa、Syria 发 生 了 变化 ; 
还 为 Hong Kong 做 了 历史 纠正 。 


E.87. 版 本 8.2.14 


发 布 日 期 : 2009-09-09 


这 个 版 本 包含 各 种 自 8.2.13 以 来 的 修复 。 关 于 8.2 主 版 本 的 新 特性 信息 ， 请 查看 Section 
E.101; 


E.87.1. 迁移 到 版 本 8.2.14 


运行 8.2.X 的 用 户 不 需要 转 储 /恢复 。 不 过 ， 如 果 你 在 interval 字段 上 有 任何 哈 希 索引 ， 你 必 
须 在 升级 到 8.2.14 之 后 REINDEX 他 们 。 另 外 ， 如果 你 是 从 一 个 早 于 8.2.11 的 版 本 升级 而 来 ， 那 
么 请 查看 8.2.11 的 版 本 声明 。 


E.87.2. 修改 列表 


e 在 pg_start_backup() 期 间 强制 WAL 段 切换 (Heikki) 
这 避免 了 可 能 导致 基础 各 份 不 可 用 的 极端 情况 。 
e 不 允许 RESET ROLE 和 RESET SESSION AUTHORIZATION 在 安全 定义 辑 数 的 内 部 (Tom, Heikki) 


这 包含 了 一 个 在 以 前 的 修补 中 漏 掉 的 情况 ， 以 前 的 修补 是 不 允许 
SET ROLE 和 SET SESSION AUTHORIZATION 在 安全 定义 函数 的 内 部 。 (See CVE-2007- 
6600) 


。 让 一 个 早已 加 载 的 可 加 载 模块 的 Loan 到 一 个 空 操作 (Tom) 


以 前 ， Loa 会 党 试 卸载 并 重新 加 载 该 模块 ， 但 是 这 是 不 安全 的 并 且 不 是 所 有 的 都 有 
用 。 


。 在 LDAP 认 证 期 间 不 允许 空 的 密码 (Magnus) 
。 修复 出 现在 外 部 级 别 聚集 本 数 的 参数 中 的 子 SELECT 的 久 理 (Tom) 
。 修复 与 从 排序 或 物化 规划 节点 抓 取 整 行 值 相关 的 bug (Tom) 


© 当 有 多 于 100 个 子 句 在 AND 或 OR 列表 中 时 ， 恢 复 禁用 部 分 索引 和 约束 排除 优化 的 规划 器 
改变 (Tom) 


e 为 数据 类 型 interval 修复 哈 希 计算 (Tom) 


这 纠正 了 哈 希 连接 在 间隔 值 上 的 错误 结果 。 也 改变 了 哈 希 索引 在 间隔 字段 上 的 内 容 。 如 
果 您 有 任何 这 样 的 索引 ， 您 必须 在 升级 之 后 REINDEX 它们 。 


将 to_char(..., 'TH') 看 做 带 有 wn / 'HH12' 的 大 写字 母 顺 序 的 后 级 (Heikki) 
以 前 作为 'th' ODE) 义理 。 


4 x 超过 2 百 万 并 且 正 在 使 用 整数 日 期 时 间 时 ， 为 INTERVAL '`` xms' 修 复 浴 出 
(Alex Hunsaker) 


修复 点 到 线段 间距 离 的 计算 (Tom) 
这 导致 几 个 几何 运算 符 不 正确 的 结果 。 


修复 money 数据 类 型 ， 在 货币 数量 没有 小 数 点 的 环境 下 工作 ， 比 如 日 本 (Itagaki 
Takahiro) 


适当 的 圆 整 日 期 时 间 输入 ， 像 00:12:57. 9999999999999999999999999999 (Tom) 
修复 GiST R-tree 操 作 符 类 中 页 分 裂 点 的 可 愉 的 选择 (Teodor) 

避免 给 入 值 是 (接近 ) 排序 的 顺序 时 批量 插入 到 GIN 索 引 中 的 性 能 退化 (Tom) 
在 PL/pgSQL 的 某 些 文本 中 正确 的 强制 NOT NULL 域 约束 (Tom) 

修复 plperl 初 始 化 中 的 可 移植 性 问题 (Andrew Dunstan) 

如 果 postgresql.conf 是 空 的 ， 修 复 pg_ctl， 不 要 进入 一 个 无 限 循 环 (Jeff Davis) 


当 一 个 键 或 值 太 长 而 不 适合 它 的 数据 结构 时 ， 让 contrib/hstore 抛 出 一 个 错误 而 不 是 愉 
展 的 截断 它 (Andrew Gierth) 


修复 contrib/xm12 的 xslt_process() ， 正确 的 义理 参数 的 最 大 数量 (20) (Tom) 
提高 libpq 代 码 的 重 棒 性 ， 在 copy From sTDIN 期 间 从 错误 中 恢复 (Tom) 
避免 包含 冲突 的 readline 和 editline 头 文件 当 两 个 库 都 安装 了 时 (Zdenek Kotala) 


更 新 时 区 数据 文件 到 tzdata 版 本 20091， 因为 DST 规 律 在 Bangladesh、Egypt、Jordan、 
Pakistan、Argentina/San_Luis、 Cuba, Jordan (只 是 历史 纠正 )、Mauritius、 
Morocco、Palestine、Syria、 Tunisia 发 生 了 改变 。 


E.88. 版 本 8.2.13 


发 布 日 期 : 2009-03-16 


这 个 版 本 包含 各 种 自 8.2.12 以 来 的 修复 。 关 于 8.2 主 版 本 的 新 特性 信息 ， 请 查看 Section 
E.101; 


E.88.1. 迁移 到 版 本 8.2.13 


运行 8.2.X 的 用 户 不 需要 转 储 /恢复 。 不 过 ， 如 果 你 是 从 一 个 早 于 8.2.11 的 版 本 升级 而 来 ， 那么 
请 查看 8.2.11 的 版 本 声明 。 


E.88.2. 修改 列表 


e 当 编 码 转换 失败 时 ， 阻 止 错误 的 递 当 骨 溃 (Tom) 


这 个 修改 扩展 了 在 最 后 两 个 小 版 本 中 为 相关 的 失败 情节 所 做 的 修复 。 以 前 的 修复 严格 限 
制 在 最 初 的 问题 报告 ， 但 是 我 们 现在 意识 到 编码 转换 函数 抛 出 的 任何 错误 会 潜在 的 在 党 
试 报告 错误 时 导致 无 限 的 着 为。 因此 解决 方法 是 在 我 们 发 现 我 们 进入 一 个 递归 错误 报告 
情况 时 ， 茜 用 翻译 和 编码 转换 ， 并 为 任何 错误 消息 报告 纯 ASCII 格 式 。 (CVE-2009- 
0922) 


为 指定 的 转换 画 数 禁用 带 有 错误 编码 的 create coNVERSION (Heikki) 


这 阻止 了 编码 转换 失败 的 一 个 可 能 的 情节 。 以 前 的 修改 是 为 了 防范 相同 地 区 的 其 他 类 型 
的 失败 。 


修复 给 到 tochar) 的 格式 代码 不 适合 数据 参数 的 类 型 时 的 内 核 转 储 (Tom) 


修复 C 环 境 使 用 多 字 节 编码 时 contrib/tsearch2 中 可 能 的 失败 (Teodor) 


在 wchar_t 比 int 狭 罕 的 平台 上 有 可 能 会 崩溃 ; 尤其 是 Windows。 


修复 contrib/tsearch2 分 析 器 义理 包含 多 个 @ 字符 的 类 似 邮 箱 的 字符 串 时 的 极端 低 效 
(Heikki) 


修复 带 有 隐 式 强制 的 case wHEN 的 反 编 译 (Tom) 


党 试 检 测 或 转 储 一 个 视图 时 ， 这 个 错误 在 启用 断言 的 建立 中 会 导致 断言 失败 ， 或 其 他 
ee A 


修复 可 能 的 TOAST 表 的 行 类 型 所 有 者 的 错误 分 配 (Tom) 


如 果 CLUSTER BK ALTER TABLE 的 一 个 重 写 变 体 被 除 表 所 有 者 之 外 的 一 个 人 执行 ， 那么 该 
表 的 TOAST 表 的 pg_type 项 将 被 标记 为 这 个 人 所 有 而 结束 。 这 没有 造成 直接 的 问题 ， 
为 TOAST 行 类 型 上 的 权限 不 是 被 任何 普通 数据 库 操作 检测 的 。 不 过 ， 如 果 一 个 人 稍 后 党 
试 删 除 发 出 该 命令 的 角色 ， 那 么 它 会 导致 意外 的 失败 〈 在 8.1 或 8.2 中 ) ， 或 在 这 样 做 后 
来 自 pg_dump 的 "数据 类 型 的 所 有 者 看 起 来 无 效 " 警告 (在 8.3 中 ) 。 


修复 PL/pgSQL， 不 要 将 字符 串 中 任何 地 方 的 insert 之 后 的 INTo 看 做 INTO 变 量子 句 ， 
不 只 是 在 字符 串 开 头 的 位 置 ; 特别 的 ， 不 要 在 create RULE 中 的 INSERT INTO 处 失败 
(Tom) 


在 块 完 全 退出 时 清理 PL/pgSQL 的 错误 状态 变量 (Ashesh Vashi 和 Dave Page) 


这 对 于 PL/pgSQL 本 身 来 说 不 是 什么 问题 ， 但 是 该 踊 忽 会 引起 PL/pgSQL 调 试 器 在 检测 一 
个 画 数 的 状态 时 骨 溃 。 


在 Windows 上 重 斌 到 callNamedPipe() 的 失败 的 调用 (Steve Marshall, Magnus) 


看 起 来 这 个 函数 有 时 会 有 暂时 性 的 失败 ; 我 们 以 前 将 任何 失败 看 做 系统 错误 ， 这 会 混 
淆 LIsTEN / NoTIFY 和 其 他 操作 。 


添加 must (Mauritius Island Summer Time) 到 已 知 的 时 区 缩写 的 缺 省 列表 (Xavier 
Bugaud) 


E.89. 版 本 8.2.12 


发 布 日 期 : 2009-02-02 


这 个 版 本 包含 各 种 自 8.2.11 以 来 的 修复 。 关 于 8.2 主 版 本 的 新 特性 信息 ， 请 查看 Section 
E.101; 


E.89.1. 迁移 到 版 本 8.2.12 


运行 8.2.X 的 用 户 不 需要 转 储 /恢复 。 不 过 ， 如 果 你 是 从 一 个 早 于 8.2.11 的 版 本 升级 而 来 ， 那么 
请 查看 8.2.11 的 版 本 声明 。 


E.89.2. 修改 列表 


e 改善 neadline() WR URLĖJ % E (Teodor) 
e CX headline() WREE K 4r BABY X (Teodor) 


。 WSR — TS oa 25 E RAY Hig 05 Fe RE Fe EY 2 2 xt EY, ARA BALE A REBT 
BAM ME 错误 转换 (Tom， Heikki) 


。 如 果 一 个 在 PLUpgSQL 中 执行 的 语句 被 重 写 到 另 一 个 类 型 的 语句 ， 例 如 ， 如 果 一 
个 INSERT 被 重 写 到 一 个 upate ， 那 么 修复 可 能 的 断言 失败 (Heikki) 


。 确保 一 个 快照 可 以 用 于 数据 类 型 输入 函数 (Tom) 


这 主要 影响 用 包含 用 户 定义 的 稳定 或 不 变 的 画 数 的 cHEck 约束 声明 的 域 。 这 样 的 函数 通 
常 在 没有 设置 快照 时 失败 。 


。 让 使 用 了 SPI 的 函数 用 于 数据 类 型 JO 中 更 加 安全 ; 特别 的 ， 用 于 域 检查 约束 中 (Tom) 
。 避免 在 vacuum 中 不 必要 的 锁定 小 表 (Heikki) 

。 修复 一 个 使 得 UPDATE RETURNING tableoid 返回 0 而 不 是 正确 的 OID 的 问题 (Tom) 

。 修复 传递 平等 应 用 到 一 个 外 连接 子 句 时 规划 器 对 选择 性 的 错误 估计 (Tom) 


这 会 导致 像 ... from a left join b on a.al = b.b1 where a.al = 42... 这 样 的 查询 的 不 


好 的 规划 
。 改善 优化 器 处 理 长 的 IN 列表 (Tom) 
这 个 修改 避免 了 在 启用 约束 排除 时 在 这 样 的 列表 上 浪费 大 量 的 时 间 。 


确保 可 持 有 游标 的 内 容 不 依赖 于 TOAST 表 的 内 容 (Tom) 


以 前 ， 游 标 结果 中 大 的 字段 值 可 能 被 表示 为 TOAST 指 针 ， 如 果 引 用 表 在 该 游标 被 读 取 之 
前 被 删除 ， 或 者 如 果 该 大 值 被 删除 然后 清理 了 ， oo 普通 游标 不 会 发 生 这 种 
情况 ， 但 是 在 持 有 过 去 它 创建 的 事务 的 游标 中 会 


修复 设置 返回 画 数 还 没有 读 取 它 的 整个 结果 就 被 截断 时 的 内 存 泄露 (Tom) 

修复 contrib/dblink 的 dblink_get_result(text,bool) JŽ% (Joe) 

修复 来 自 contrib/sslinfo 画 数 的 可 能 的 垃圾 输出 (Tom) 

修复 configure 脚 本 ， 当 不 能 为 PL/Perl 获 取 连 接 信息 时 ， 正 确 的 报告 失败 (Andrew) 


让 所 有 文档 适当 的 引用 pgsql-bugs 和 /或 pgsql-hackers ， 而 不 是 现在 退役 
的 pgsql-ports 和 pgsql-patches 邮件 列表 (Tom) 


更 新 时 区 数据 文件 到 tzdata 版 本 2009a (因为 Kathmandu 和 Switzerland、 Cuba 中 的 历史 
DST 纠 正 ) 


E.90. 版 本 8.2.11 


4 #5 A HA: 2008-11-03 


这 个 版 本 包含 各 种 自 8.2.10 以 来 的 修复 。 关 于 8.2 主 版 本 的 新 特性 信息 ， 请 查看 Section 
E.101; 


E.90.1. 迁移 到 版 本 8.2.11 


运行 8.2.X 的 用 户 不 需要 转 储 /恢复 。 不 过 ， 如 果 你 是 从 一 个 早 于 8.2.7 的 版 本 升级 而 来 ， 那么 
请 查看 8.2.7 的 版 本 声明 。 另外， 如 果 你 正在 运行 一 个 早 于 8.2.X 的 版 本 ， 建议 在 升级 之 
后 REINDEX 所 有 GIST 素 引 。 


E.90.2. 修改 列表 


修复 由 于 在 一 个 删除 之 后 标记 错误 的 索引 项 "dead" 引 起 的 GiST 索 引 损坏 (Teodor) 
这 会 导致 索引 搜索 未 能 找到 它们 应 该 找到 的 行 。 损 坏 的 索引 可 以 使 用 REINDEX 修复 。 
修复 客户 端 编码 不 能 表示 本 地 化 的 错误 消息 时 的 后 端 崩溃 (Tom) 


之 前 我 们 解决 过 类 似 的 问题 ， 但 是 如 果 "character has no equivalent" 消息 本 身 不 能 被 转 
换 的 话 它 将 仍然 会 失败 。 该 修复 是 在 检测 到 这 样 的 情况 时 禁用 本 地 化 并 发 送 纯 ASCII 错 误 
消息 。 


修复 深层 谋 套 的 函数 在 一 个 触发 器 中 调用 时 ， 可 能 的 崩 演 (Tom) 


改善 expression IN ( _expression-list_ ) 查询 的 优化 (Tom, per an idea from Robert 
Haas) 


查询 变量 在 右 侧 的 情况 在 8.2.X 和 8.3.X 中 的 处 理 效 率 比 在 以 前 的 版 本 中 低 。 该 修复 为 这 
样 的 情况 恢复 了 8.1 的 行为 。 


(ESF sELEcT 出 现在 FRoM 中 的 函数 调用 、 一 个 多 行 vALuESs 列表 或 一 个 RETURNING 列 
表 中 时 规则 查询 的 错误 扩展 (Tom) 


这 个 问题 通常 的 症状 是 一 个 "未 识别 的 节点 类 型 "错误 。 
修复 重新 扫描 散 列 的 聚合 计划 期 间 的 内 存 泄 露 (Neil) 
确保 当 一 个 新 定义 的 PL/pgSQL 触 发 器 被 当做 普通 函数 调用 时 报告 一 个 错误 (Tom) 


当 使 用 ALTER SET TABLESPACE 移动 一 个 表 到 另 一 个 表 空 间 时 ， 阻止 可 能 
的 relfilenode 编号 冲突 (Heikki) 


该 命令 尝试 重新 使 用 现 有 的 文件 名 ， 而 不 是 使 用 一 个 在 目标 目录 中 已 知 未 使 用 的 文件 
名 。 


修复 在 一 个 --enable-integer-datetimes 建立 中 使 用 一 个 非 1SO 日 期 类 型 时 ， 间隔 值 中 分 
数秒 的 不 正确 的 显示 (Ron Mayer) 


当 传 递 的 元 组 和 元 组 描述 符 有 不 同 的 字段 数 时 ， 确保 SPI_getvalue 和 SPI_getbinval 1E 
确 的 行为 (Tom) 


当 一 个 表 有 添加 或 删除 的 字段 时 ， 这 个 情况 是 正常 的 ， 但 是 这 两 个 函数 没有 正确 的 处 
理 。 唯一 可 能 的 后 果 是 一 个 不 正确 的 错误 指示 。 


修复 ecpg 对 cREATE ROLE 的 解析 (Michael) 

修复 pg_ctl restart 最 近 的 破损 (Tom) 

确保 pg_control 是 以 二 进 制 模式 打开 的 (Itagaki Takahiro) 
pg_controldata 和 pg_resetxlog 没有 正确 的 做 到 这 点 ， 因 此 在 Windows 上 可 能 会 失败 。 


更 新 时 区 数据 文件 到 tzdata 版 本 2008i (因为 DST 规 律 在 Argentina, Brazil, Mauritius, 
Syria 发 生 了 变化 ) 


E.91. 版 本 8.2.10 


发 布 日 期 : 2008-09-22 


这 个 版 本 包含 各 种 自 8.2.9 以 来 的 修复 。 关 于 8.2 主 版 本 的 新 特性 信息 ， 请 查看 Section 
E.101; 


E.91.1. 迁移 到 版 本 8.2.10 


运行 8.2.X 的 用 户 不 需要 转 储 / 恢 复 。 不 过 ， 如 果 你 是 从 一 个 早 于 8.2.7 的 版 本 升级 而 来 ， 那么 
请 查看 8.2.7 的 版 本 声明 。 


E.91.2. 修改 列表 


。 修复 btree WAL 恢 复 代 码 中 的 bug (Heikki) 
如 果 WAL 在 页 分 裂 操 作 的 中 途 停止 ， 则 恢复 失败 。 
。 修复 潜在 的 datfrozenxid 计算 错误 (Alvaro) 


这 个 错误 可 能 会 解释 一 些 最 近 未 能 删除 老 的 pg_clog 数据 的 报告 。 


扩大 本 地 锁 计 数 器 从 32 到 64 位 (Tom) 
这 个 响应 报告 计数 器 在 足够 长 的 事务 中 可 能 会 浴 出 ， 导 致意 外 的 " 锁 已 经 持 有 "错误 。 


修复 在 GiST 索 引 扫 描 期 间 元 组 可 能 重复 输出 (Teodor) 


修复 一 个 视图 包含 一 个 简单 的 unton ALL 构造 时 ， 丢 失 的 权限 检查 (Heikki) 
正确 的 检查 了 引用 表 的 权限 ， 但 是 视图 本 身 的 权限 没有 检查 。 


e 在 执行 器 启动 中 添加 检查 ， 以 确保 insert 或 UPDATE 产生 的 元 组 籽 匹 配 目标 表 的 当前 行 
类 型 (Tom) 


ALTER COLUMN TYPE ， 跟 着 重新 使 用 一 个 以 前 缓存 的 规划 ， 会 产生 这 种 类 型 的 情况 。 该 检 
查 防 卫 了 可 能 跟着 发 生 的 数据 损坏 和 /或 月 渍 。 


e 修复 DRoP owNED 期 间 可 能 的 重复 删除 (Tom) 
这 通常 会 导致 奇怪 的 错误 ， 上 比如 "关系 NNN 的 缓存 查找 失败 "。 


e 修复 AT TIME zoNE ， 首 先 尝试 解释 它 的 时 区 参数 为 时 区 缩写 ， 并 且 只 在 失败 时 党 试 它 为 
一 个 全 时 区 名 ， 而 不 是 像 以 前 一 样 (Tom) 


ay fa) Bes A BS ELA ne RAY ot EK GRD, Gk AT TIME Zone 这 样 做 也 改善 了 
一 臻 性， 并且 修复 了 一 个 在 8.1 中 引入 的 兼容 性 错误 : 在 模糊 的 情况 下 ， 我 们 现在 和 8.0 
和 以 前 一 样 行为 ， 因 为 在 老 的 版 本 中 ， AT time zone 只 接受 缩写 。 


修复 日 期 时 间 输 入 函数 ， 当 运行 在 一 个 64 位 的 平台 上 时 ， 正 确 的 检测 整数 渝 出 (Tom) 
显示 一 个 拥有 单位 的 配置 参数 时 ， 阻 止 单 位 转换 期 间 的 整数 浴 出 (Tom) 

提高 写 人 非常 长 的 日 志 消 息 到 系统 日 志 的 性 能 (Tom) 

在 pg_hba.conf 中 人 允许 空格 在 LDAP URL 的 前 级 部 分 中 (Tom) 

修复 向 后 扫描 SELECT DISTINCT on 查询 上 的 游标 中 的 错误 (Tom) 

修复 艇 套子 查询 表达 式 的 规划 器 错误 (Tom) 


如 果 外 部 子 查 询 没有 直接 的 依赖 于 父 查询 ， 但 是 内 部 子 查 询 直 接 依赖 于 父 查询 ， 那么 外 
部 的 值 可 能 不 会 为 新 的 父 查询 行 计算 。 


修复 规划 器 ， 估 计 croup BY 表达 式 产 生 的 布尔 结果 总 是 在 两 个 组 中 ， 不 管 表达 式 的 内 容 
是 什么 (Tom) 


这 非常 明显 的 比 为 某 些 布尔 测试 ， 像 col Is nuLL, 的 普通 croup BY 估计 更 精确 。 


修复 PL/pgSQL， 当 ror 循环 的 目标 变量 是 一 个 包含 复合 类 型 字段 的 记录 时 不 要 失败 
(Tom) 


修复 PL/Tcl， 使 其 与 Tcl8.5 正 确 的 行为 ， 并 且 更 加 小 心 数据 发 送 到 或 者 来 自 Tcl 的 编码 
(Tom) 


在 Windows 上 ， 通 过 阻止 libpq 尝 试 发 送 超过 64kB 的 系统 调用 来 绕 开 一 个 Microsoft 错 误 
(Magnus) 


改善 未 能 发 送 一 个 SQL 命令 之 后 ，pg_dump 和 pg _restore 的 错误 报告 (Tom) 
修复 pg_ctl， 在 restart 时 妥善 保存 主 进程 的 命 合 行 参数 (Bruce) 


更 新 时 区 数据 文件 到 tzdata 版 本 2008f (因为 DST 规 律 在 Argentina、Bahamas、 Brazil, 
Mauritius、Morocco、Pakistan、Palestine 和 Paraguay 发 生 了 改变 ) 


E.92. 版 本 8.2.9 


发 布 日 期 : 2008-06-12 


这 个 版 本 包含 8.2.8 的 一 个 严重 的 和 一 个 小 的 错误 修复 。 关 于 8.2 主 版 本 的 新 特性 信息 ， 请 查 
看 Section E.101。 


E.92.1. 迁移 到 版 本 8.2.9 


运行 8.2.X 的 用 户 不 需要 转 储 / 恢 复 。 不 过 ， 如 果 你 是 从 一 个 早 于 8.2.7 的 版 本 升级 而 来 ， 那么 
请 查看 8.2.7 的 版 本 声明 。 


E.92.2. 修改 列表 


e 让 pg_get_ruledef() 给 负 的 常量 加 上 括号 (Tom) 


在 该 修复 之 前 ， 视 图 或 规则 中 负 的 常量 可 能 被 转 储 为 ， 例 如 ， -42::integer, 这 是 微妙 
的 不 正确 的 : 由 于 运算 符 优 先 级 规则 ， 它 应 该 是 (-42)::integer o 通常 这 将 无 关 紧 要 ， 

但 是 它 会 与 另 一 个 最 近 的 补丁 相互 作用 导致 PostgreSQL 拒绝 一 个 有 效 

的 SELECT DISTINCT 视图 查询 。 因 为 这 会 导致 pg_dump 输出 未 能 重 载 ， 所 以 它 被 看 做 一 
个 高 优先 级 修复 。 转 储 输 出 实际 上 不 正确 的 唯一 发 布 版 本 是 8.3.1 和 8.2.7。 


e 让 ALTER AGGREGATE ... OWNER TO 更 新 pg_shdepend (Tom) 


如 果 该 聚集 稍 后 包含 在 一 个 DROP owned 或 REASSIGN owNED 操作 中 ， 3x NPBA S Mie 


是 。 


E.93. 版 本 8.2.8 


发 布 日 期 : 从 未 发 布 


这 个 版 本 包含 各 种 自 8.2.7 以 来 的 修复 。 关 于 8.2 主 版 本 的 新 特性 信息 ， 请 查看 Section 
E.101。 


E.93.1. 迁移 到 版 本 8.2.8 


运行 8.2.X 的 用 户 不 需要 转 储 / 恢 复 。 不 过 ， 如 果 你 是 从 一 个 早 于 8.2.7 的 版 本 升级 而 来 ， 那么 
请 查看 8.2.7 的 版 本 声明 。 


E.93.2. 修改 列表 
。 修复 使 用 一 个 UTF-8 数 据 库 编码 和 一 个 不 同 的 客户 端 编码 时 ， 发 生 在 Windows 上 的 
ERRORDATA_STACK_SIZE exceeded Ax (Tom) 


e 修复 ALTER TABLE ADD COLUMN ... PRIMARY KEY , 这 样 正确 的 检查 新 的 字段 看 看 是 否 初始 
化 为 所 有 非 空 (Brendan Jurd) 


以 前 的 版 本 完全 下 忽 了 检查 这 个 要 求 。 
。 修复 从 继承 自 同一 个 祖先 的 约束 的 多 个 父 关系 中 继承 "相同 的 "约束 时 ， 可 能 


的 CREATE TABLE 失败 (Tom) 
e 修复 pg_get_ruledef() 显示 别名 ， 如 果 有 ， 附 加 uPDaTE 或 DELETE 的 目标 表 (Tom) 
。 修复 可 能 导致 too many LwLocks taken 失败 的 GIN 错 误 (Teodor) 
。 避免 反 编译 损坏 的 数据 时 可 能 的 崩溃 (Zdenek Kotala) 


。 修复 两 个 地 方 ， 在 这 两 个 地 方 SIGTERM 退 出 后 端 可 能 在 共享 内 存 中 留 下 损坏 的 状态 
(Tom) 


如 果 SIGTERM 用 于 关闭 整个 数据 库 集 群 ， 那 么 哪 种 情况 都 不 是 非常 重要 的 ， 但 是 如 果 有 
人 尝试 SIGTERM 单 个 后 端 ， 那 么 就 有 问题 了 。 


。 修复 ISO-8859-5 和 其 他 编码 之 间 的 转换 ， 以 处 理 Cyrillic "Yo" 字 符 (e 和 上 E 带 有 两 个 点 ) 
(Sergey Burladyan) 


。 (ES ILS BAW, DAE arrayin(), 它们 允许 在 它们 的 结果 中 未 使 用 的 字 
节 包 含 未 初始 化 的 、 不 可 预期 的 值 (Tom) 


这 会 导致 两 个 表面 上 相同 的 字面 值 被 看 做 不 等 的 失败 ， 导 致 分 析 器 抱怨 未 匹配 的 


ORDER BY 和 DISTINCT 表达 式 。 


修复 正则 表达 式 子 字符 串 匹 配 中 的 一 个 极端 情况 ( substring( ` ~_string_ from 
_pattern_ )) (Tom) 


这 个 问题 出 现在 整体 匹配 但 是 用 户 已 经 指定 了 一 个 加 上 括号 的 子 表达 式 ， 并 且 该 子 表达 
式 没 有 得 到 一 个 匹配 的 情况 下 。 一 个 例子 是 substring('foo' from 'foo(bar)?') o 这 应 
该 返回 NULL， 因 为 (bar) 没有 匹配 ， 但 是 它 错 误 的 返回 了 整个 模式 匹配 (也 就 


是 foo ) 。 


更 新 时 区 数据 文件 到 tzdata 版 本 2008c (因为 DST 规 律 在 Morocco、lraq、 Choibalsan、 
Pakistan, Syria, Cuba#lArgentina/San_Luis® 4 7 AX) 


修复 ecpg 的 pctyPestimestamp_sub() 豆 数 的 不 正确 结果 (Michael) 
为 contrib/tsearch2 的 tsquery 类 型 修复 破损 的 GiST 上 比较 函数 (Teodor) 
修复 contrib/cube BNSC BREA AAS (Tom) 


当 输 入 查询 返回 一 个 NULL 值 时 ， 修 复 contrib/xml2 BY xpath_table() EXC EI AK He 
(Tom) 


修复 contrib/xm12 的 makefile， 不 要 重 载 cFLA6s (Tom) 
修复 patumGetBool 宏 ， 使 用 gcc 4.3 时 不 要 失败 (Tom) 


这 个 问题 影响 返回 布尔 值 的 "老式 的 " (VO) CHM, AIERESIHRMAT, 但 是 向 后 修 
复 的 需要 在 当时 没有 意识 到 。 


E.94. 版 本 8.2.7 


发 布 日 期 : 2008-03-17 


这 个 版 本 包含 各 种 自 8.2.6 以 来 的 修复 。 关 于 8.2 主 版 本 的 新 特性 信息 ， 请 查看 Section 
E.101; 


E.94.1. 迁移 到 版 本 8.2.7 


运行 8.2.X 的 用 户 不 需要 转 储 /恢复 。 不 过 ， 如 果 你 受 下 列 描 述 的 Windows 环 境 问 题 影响 ， 你 
可 能 需要 在 升级 之 后 REINDEX 在 文本 字段 上 的 索引 。 


E.94.2. 修改 列表 


© 为 认为 不 同 字 符 组 合 为 相等 的 Windows 环 境 修复 字符 串 比 较 (Tom) 


这 个 修复 只 应 用 于 Windows 并 且 是 在 使 用 UTF-8 数 据 库 编码 时 。 两 年 前 为 所 有 其 他 情况 
作 了 相同 的 修复 ， 但 是 使 用 UTF-8 的 Windows 使 用 一 个 单独 的 代码 路 径 ， 所 以 没有 更 
新 。 如 果 你 正在 使 用 一 个 认为 一 些 不 相同 的 字符 串 相 等 的 环境 ， 你 可 能 需要 REINDEX ， 
以 修复 文本 字段 上 现存 的 索引 。 


。 修复 在 不 同 的 系统 目录 上 并 发 vacuum FULL 操作 之 间 潜 在 的 死 锁 (Tom) 
。 修复 长 期 存在 的 Listen / NoTIFY 竞 态 条 件 (Tom) 


在 稀有 情况 下 ， 一 个 刚刚 执行 了 Listen 的 会 话 可 能 不 会 获得 一 个 通知 ， 即使 预期 应 该 有 
一 个 ， 因 为 观察 到 并 发 事务 执行 NoTIFY 在 稍 后 提交 。 


该 修复 的 一 个 副作用 是 一 个 已 经 执行 了 还 未 提交 的 LIsTEN 命令 的 事务 对 于 该 LISTEN 将 
不 会 看 到 任何 pg_listener 中 的 行 ， 而 它 应 该 看 到 ; 以 前 它 能 看 到 。 这 个 行为 从 未 记录 
过 ， 但 是 有 可 能 有 一 些 应 用 依赖 于 老 的 行为 。 


。 不 人 允许 LISTEN 和 UNLISTEN 在 一 个 预备 事务 中 (Tom) 


以 前 是 允许 的 ， 但 是 尝试 这 样 做 会 有 各 种 不 愉快 的 结果 ， 尤 其 是 只 要 uste 保持 未 提 
交 ， 那 么 原始 的 后 端 就 不 会 退出 。 


。 不 人 允许 在 一 个 预 各 事务 中 删除 一 个 临时 表 (Heikki) 
这 在 8.1 中 正确 的 禁用 了 ， 但 是 在 8.2 中 无 意 的 打破 了 检查 。 


。 修复 一 个 错误 发 生 在 查询 使 用 哈 希 索引 期 间 时 的 罕见 前 溃 (Heikki) 


(2S Fe ik 1 ER A ee (Neil) 

修复 公元 前 2 月 29 的 日 期 时 间 值 的 输入 (Tom) 

以 前 的 代码 关于 哪 年 是 头 年 是 错误 的 。 

修复 ALTER owner 的 一 些 变 体 中 的 "未 识别 的 节点 类 型 "错误 (Tom) 

确保 退出 一 个 锁 等 待 时 ， pg_stat_activity . waiting 标记 被 清除 了 (Tom) 
修复 Windows Vista 上 进程 权限 的 处 理 (Dave, Magnus) 

特别 的 ， 这 个 修复 允许 作为 管理 员 用 户 启动 服务 器 。 


更 新 时 区 数据 文件 到 tzdata 版 本 2008a 《特别 的 ， 最 近 智 利 的 变化 ) ; 调整 时 区 缩 
写 vet (Venezuela) 意 为 UTC-4:30， 不 是 UTC-4:00 (Tom) 


修复 pg_ctl， 正 确 的 从 命令 行 选项 中 提取 主 进 程 的 端口 号 (ltagaki Takahiro, Tom) 
以 前 ， pg_ctl start -w 会 在 错误 的 端口 尝试 连接 主 进程 ， 导 致 启动 失败 的 错误 报告 。 
使 用 -fwrapv 来 防御 最 近 的 gcc 版 本 中 可 能 的 错误 优化 (Tom) 

在 使 用 gcc 4.3 或 更 高 版 本 建立 PostgreSQL 时 ， 这 是 必要 的 。 

正确 的 强制 statement_timeout 值 比 INT_MAX 微妙 (大约 35 分 钟 ) E k (Tom) 

这 个 错误 只 影响 使 用 --enable-integer-datetimes 的 建立 。 

修复 常量 折 琶 简化 一 个 子 查询 时 ，" 意 外 的 PARAM_SUBLINK ID" 规 划 器 错误 (Tom) 
修复 约束 排除 处 理 Is NuLL 和 not 表达 式 中 的 逻辑 错误 (Tom) 

规划 器 有 时 会 由 于 NULL 结 果 的 可 能 性 排除 不 应 该 被 排除 的 分 区 。 

修复 另 一 个 导致 "未 能 建立 一 个 N-way 连接 "规划 器 错误 的 原因 (Tom) 

这 在 利用 一 个 连接 子 句 之 前 必须 强制 一 个 缺乏 子 句 的 连接 的 情况 下 会 发 生 。 

修复 外 连接 规划 中 不 正确 的 常数 传播 (Tom) 

规划 器 有 时 不 正确 的 推断 一 个 变量 会 被 迫 等 于 一 个 常量 ， 导 致 错误 的 查询 结果 。 
修复 oRDER BY 和 croup BY 中 常量 表达 式 的 显示 (Tom) 

明确 计算 的 常量 会 不 正确 的 显示 。 这 会 导致 ， 例 如 转 储 或 重 载 期 间 视 图 定义 的 损坏 。 
修复 libpq， 在 COPY OUT 期 间 正 确 的 处 理 NOTICE 消 息 (Tom) 


这 个 失败 只 有 在 一 个 用 户 定义 数据 类 型 的 输出 例 程 发 出 一 个 NOTICE 时 能 观察 到 ， 但 是 
不 保证 它 不 会 由 于 其 他 的 原因 而 发 生 。 


E.95. 版 本 8.2.6 


发 布 日 期 : 2008-01-07 


这 个 版 本 包含 各 种 自 8.2.5 以 来 的 修复 ， 包 括 重 大 安全 问题 的 修复 。 关 于 8.2 主 版 本 的 新 特性 信 


息 ， 


请 查看 Section E.101。 


E.95.1. 迁移 到 版 本 8.2.6 


运行 8.2.X 的 用 户 不 需要 转 储 /恢复 。 


E.95.2. 修改 列表 


阻止 索引 中 的 函数 用 用 户 运行 vacuum, ANALYZE 等 的 权限 执行 (Tom) 


索引 表达 式 和 局 部 索引 谓词 中 使 用 的 函数 是 在 制作 一 个 新 的 表 条 目 时 计算 的 。 一 直 以 来 
大 家 都 明白 ， 如 果 一 个 人 修改 了 一 个 不 可 信用 户 的 表 ， 那 么 会 引起 特洛伊 木马 执行 的 风 
险 。 注意， 触发 器 、 缺 省 、 检 查 约束 等 ， 引 起 相同 类 型 的 风险 。) 但 是 索引 中 的 函数 
会 引起 额外 的 风险 ， 因为 它们 将 被 日 常 维 折 操 作 执 行 ， 比 如 vacuum FULL ， 它 们 通常 自 

动 在 超级 用 户 账户 下 执行 。 例如 ， 一 个 不 法 用 户 可 以 通过 设置 一 个 特洛伊 木马 索引 定义 
并 等 待 下 一 个 日 常 清理 ， 用 超级 用 户 的 权限 执行 代码 。 该 修复 安排 标准 的 维护 操作 ( 包 
插 VACUUM. ANALYZE 、 REINDEX 和 cLusTER ) 作为 表 所 有 者 执行 而 不 是 作为 调用 用 户 

执行 ， 使 用 早已 为 SECURITY DEFINER 豆 数 使 用 的 相同 的 权限 切换 机 制 。 为 了 阻止 绕 开 这 
个 安全 错误 ， SET SESSION AUTHORIZATION 和 SET ROLE 现在 禁止 在 SECURITY DEFINER 内 

容 中 执行 。 (CVE-2007-6600) 


修复 正则 表达 式 包 中 的 各 种 错误 (Tom, Will Drewry) 


适当 配置 的 正则 表达 式 模 式 会 导致 月 溃 、 无 限 或 接近 无 限 循环 和 /或 大 量 的 内 存 消耗 ， 所 
有 这 些 对 于 从 受信 任 的 源 接受 正则 搜索 模式 的 应 用 来 说 都 会 引起 服务 拒绝 的 危害 。 
(CVE-2007-4769, CVE-2007-4772, CVE-2007-6067) 


要 求 使 用 /contrib/dblink 的 非 超 级 用 户 只 使 用 口令 认证 ， 作 为 一 个 安全 措施 (Joe) 


出 现在 8.2.5 中 的 该 修复 是 不 完整 的 ， 因 为 它 只 为 一 些 dblink HABE T isis. (CVE- 
2007-6601, CVE-2007-3278) 


为 GIN 素 引 修 复 WAL 重 放 中 的 错误 (Teodor) 
修复 maintenance_work_mem 是 4GB 或 更 多 时 ，GIN 索 引 建 立正 确 的 工作 (Tom) 


更 新 时 区 数据 文件 到 tzdata 版 本 2007k (特别 的 ， 最 近 的 阿根廷 的 变化 ) (Tom) 


改善 规划 器 在 非 C 环 境 中 对 LIKE/regex 估 计 的 处 理 (Tom) 
为 深层 外 连接 巾 套 修复 规划 速度 问题 ， 和 可 能 的 连接 顺序 的 贫乏 的 选择 (Tom) 
修复 WHERE false AND var IN (SELECT ...) 的 一 些 情况 行 中 的 规划 器 失败 (Tom) 


让 CREATE TABLE ... SERIAL 和 ALTER SEQUENCE ... OWNED BY 不 要 改变 序列 
的 currval() 状态 (Tom) 


保存 ALTER TABLE ... ALTER COLUMN TYPE 重建 的 索引 的 表 空 间 和 存储 参数 (Tom) 


让 兴 档 恢复 总 是 开始 一 个 新 的 WAL 时 间 线 ， 而 不 是 只 在 使 用 恢复 停止 时 间 时 开始 新 的 时 
间 线 (Simon) 


这 避免 了 党 试 重 写 一 个 最 后 WAL 段 的 现 有 六 档 拷贝 的 极端 情况 风险 ， 并 且 看 起 来 比 原先 
的 定义 更 简单 和 干净 。 


让 vacuum 在 表 非 常 小 而 没什么 用 处 时 ， 不 使 用 所 有 的 ”maintenance_work_mem (Alvaro) 
修复 使 用 一 个 多 字 节 数据 库 编码 时 ， translate() 中 潜在 的 崩溃 (Tom) 

让 corr() 为 负 的 关联 值 返回 正确 的 结果 (Neil) 

为 超过 68 年 的 间隔 修复 extract(epoch from interval) 中 的 渝 出 (Tom) 

修复 PL/Perl， 当 在 一 个 信任 的 函数 中 使 用 UTF-8 正 则 表达 式 时 不 要 失败 (Andrew) 
修复 PL/Perl， 以 处 理 平台 的 Perl 定 义 类 型 bool 为 int 而 不 是 char 的 情况 (Tom) 


虽然 理论 上 这 可 能 在 任何 地 方 发 生 ， 但 是 没有 标准 的 Perl 建 立 这 样 做 .….…. 直到 Mac OS X 
10.5。 


修复 PL/Python， 使 其 与 Python 2.5 在 64 位 的 机 器 上 正确 的 工作 (Marko Kreen) 
修复 PL/Python， 在 长 的 意外 消息 上 不 要 月 渍 (Alvaro) 

修复 pg_dump， 正 确 的 处 理 缺 省 表达 式 与 它们 的 父 表 不 同 的 继承 子 表 (Tom) 
修复 PePAssFILE 引用 的 文件 不 是 一 个 纯 文件 时 libpq 的 月 溃 (Martin Pitt) 
ecpg 解 析 器 修复 (Michael) 


让 contrib/pgcrypto 防御 OpenSSL 库 在 键 长 于 128 位 时 失败 } 这 至 少 是 在 一 些 Solaris 版 
本 上 的 情况 (Marko Kreen) 


让 contrib/tablefunc 的 crosstab() 处 理 NULL rowid 为 它 本 身 的 类 别 ， TRA 
(Joe) 


修复 tsvector 和 tsquery 输出 例 程 ， 以 正确 的 逃逸 反 斜 杠 (Teodor, Bruce) 


修复 to_tsvector() FEAWMAS HA BENS (Teodor) 


。 在 重新 生成 configure 脚本 时 ， 要 求 使 用 一 个 特定 的 Autoconf 版 本 (Peter) 


这 只 影响 开发 者 和 打包 者 。 做 这 个 修改 是 为 了 阻止 意外 的 使 用 未 经 测试 的 Autoconf 和 
PostgreSQL 版 本 的 组 合 。 如 果 你 真 的 想 要 使 用 一 个 不 同 的 Autoconf 版 本 ， 你 可 以 删除 版 
本 校 验 ， 但 是 结果 如 何 就 是 你 的 责任 了 。 

e 更 新 gettimeofday 配置 检查 ， 这 样 PostgreSQL 可 以 在 更 新 的 MinGW 版 本 上 建立 
(Magnus) 


E.96. 版 本 8.2.5 


发 布 日 期 : 2007-09-17 


这 个 版 本 包含 各 种 自 8.2.4 以 来 的 修复 。 关 于 8.2 主 版 本 的 新 特性 信息 ， 请 查看 Section 
E.101。 


E.96.1. 迁移 到 版 本 8.2.5 


运行 8.2.X 的 用 户 不 需要 转 储 /恢复 。 


E.96.2. 修改 列表 


。 当 一 个 事务 插入 行 然后 在 接近 相同 表 上 的 并 发 vacuum 的 结尾 退出 时 ， 阻止 素 引 损坏 
(Tom) 


。 为 在 域 中 包含 域 的 情况 修复 ALTER DOMAIN ADD CONSTRAINT (TOM) 
e 让 CREATE DOMAIN ... DEFAULT NULL 正确 的 工作 (Tom) 


。 修复 一 些 外 连接 的 规划 器 问题 ， 尤 其 是 对 tl LEFT JOIN t2 WHERE t2.col IS NULL 的 可 恰 
的 大 小 估计 (Tom) 


e 人 允许 interval 数据 类 型 接受 只 由 毫秒 和 微妙 组 成 的 输入 (Neil) 

e 在 timestamp 输入 中 人 允许 时 区 名 出 现在 年 之 前 (Tom) 

e 修复 /contrib/tsearch2 使 用 的 GIN 索 引 (Teodor) 

e 加 速 rtree 索 引 插 入 (Teodor) 

。 修复 过 度 的 记录 SSL 错 误 消息 (Tom) 

。 修复 日 志 ， 这 样 在 使 用 系统 日 志 进 程 时 日 志 消 息 不 会 交错 (Andrew) 

e 修复 log min_error_statement Hm RAH BIA (Tom) 

。 修复 一 些 外 键 极端 情况 的 不 正确 的 处理 (Tom) 

e 修复 stddev_pop(numeric) 和 var_pop(numeric) (Tom) 

e 阻止 REINDEX 和 cLusteR 由 于 尝试 处 理 其 他 会 话 的 临时 表 而 失败 (Alvaro) 


e 更 新 时 区 数据 规则 ， 特 别 是 新 西 兰 即将 到 来 的 变化 (Tom) 


Windows 套 接 字 和 信号 灯 的 改变 (Magnus) 

让 pg_ctl -w 在 Windows 服 务 器 模式 正确 的 工作 (Dave Page) 

修复 在 Windows 上 使 用 MIT Kerberos 时 的 内 存 分 配 错误 (Magnus) 

抑制 Windows 上 日 志 时 间 惟 中 的 时 区 名 ( xz )， 由 于 可 能 的 编码 错误 匹配 (Tom) 

要 求 使 用 /contrib/dblink 的 非 超级 用 户 只 使 用 口令 认 证 ， 作 为 一 个 安全 措施 (Joe) 
因为 安全 原因 ， 限 制 /contribypgstattuple MA 4 MA > (Tom) 


不 要 让 /contrib/intarray 尝试 使 用 它 自己 的 GIN 操 作 符 类 作为 缺 省 (这 会 在 转 储 /恢复 时 
引起 问题 ) (Tom) 


E.97. 版 本 8.2.4 


发 布 日 期 : 2007-04-23 


这 个 版 本 包含 各 种 自 8.2.3 以 来 的 修复 ， 包 括 一 个 安全 修复 。 关 于 8.2 主 版 本 的 新 特性 信息 ， 请 
查看 Section E.101。 


E.97.1. 迁移 到 版 本 8.2.4 


运行 8.2.X 的 用 户 不 需要 转 储 /恢复 。 


E.97.2. 修改 列表 


e 支持 在 search_path 中 明确 的 布置 临时 表 模 式 ， 并 禁用 函数 和 操作 符 搜索 它 (Tom) 


这 需要 人 允许 一 个 安全 定义 画 数 设置 一 个 search path 的 真正 安全 的 值 。 没有 它 ， 一 个 无 
特权 的 SQL 用 户 可 以 使 用 临时 对 象 用 安全 定义 郴 数 的 权限 执行 代码 (CVE-2007-2138)。 
参阅 CREATE FUNCTION 获取 更 多 信息 。 


。 通过 在 每 个 后 端 中 强制 重 载 ， 为 Windows 修 复 shared_preload_libraries (Korry 
Douglas) 


。 修复 to_char() ， 这 样 它 正 确 的 大 写 / 小 写本 地 化 的 天 或 月 名 (Pavel Stehule) 

e /contrib/tsearch2 ĦA RIZS (Teodor) 

。 要 求 COMMIT PREPARED 在 事务 预 各 的 数据 库 中 执行 (Heikki) 

e 人 允许 pg_dump 在 Windows 上 的 二 进 制 各 份 比 两 千 兆 字 节 大 (Magnus) 

。 新 增 传 统 的 (台湾 ) 中 文 FAQ (Zhou Daojing) 

。 阻止 统计 收集 器 太 频 繁 的 写 入 磁盘 (Tom) 

。 修复 vacuum FuLL 如 何人 处理 uppaTE 链 中 潜在 的 数据 损坏 错误 (Tom, Pavan Deolasee) 
。 修复 使 用 数组 类 型 的 域 中 的 错误 (Tom) 


。 修复 pg_dump ， 这 样 它 可 以 在 不 转 储 拥有 的 表 时 使 用 -t 转 储 一 个 序列 字段 的 序列 
(Tom) 


。 规划 器 修复 ， 包 括 改 善 外 连接 和 位 图 扫描 选择 逻辑 (Tom) 


。 (§SPL/pgSQLig# iXM—~* exception 块 中 RETURN 时 ， 可 能 的 错误 恢复 或 朋 溃 
(Tom) 


。 修复 扩大 哈 希 索引 期 间 的 PANIC (Tom) 


。 修复 POSIX 风 格 的 时 区 规格 ， 以 遵循 新 的 USA DST 规 则 (Tom) 


E.98. 版 本 8.2.3 


发 布 日 期 : 2007-02-07 


这 个 版 本 包含 两 个 8.2.2 的 修复 。 关 于 8.2 主 版 本 的 新 特性 信息 ， 请 查看 Section E.101。 


E.98.1. 迁移 到 版 本 8.2.3 


运行 8.2.X 的 用 户 不 需要 转 储 /恢复 。 


E.98.2. 修改 列表 


。 为 约束 和 功能 索引 中 的 类 型 长 度 删 除 过 度 限 制 的 检查 (Tom) 


。 修复 最 优化 ， 这 样 MIN/MAX 在 子 查询 中 可 以 再 次 使 用 索引 (Tom) 


E.99. 版 本 8.2.2 


发 布 日 期 : 2007-02-05 


这 个 版 本 包含 各 种 自 8.2.1 以 来 的 修复 ， 包 括 一 个 安全 修复 。 关 于 8.2 主 版 本 的 新 特性 信息 ， 请 
查看 Section E.101。 


E.99.1. 迁移 到 版 本 8.2.2 


运行 8.2.X 的 用 户 不 需要 转 储 /恢复 。 


E.99.2. 修改 列表 


。 删除 允许 连接 的 用 户 读 取 后 端 内 存 的 安全 缺陷 (Tom) 


该 缺陷 包括 抑制 SQL 画 数 返回 它 声 明 的 数据 类 型 和 修改 表 字 段 的 数据 类 型 的 正常 检查 
(CVE-2007-0555, CVE-2007-0556)。 这 些 错误 可 以 很 容易 的 被 利用 来 导致 一 个 后 端 月 
#, 并 且 原 理 上 可 能 被 用 来 读 取 该 用 户 不 应 该 能 够 访问 的 数据 库 内 容 。 


。 修复 由 于 选择 一 个 不 可 行 的 分 裂 点 ，btree 索 引 页 分 裂 可 能 失败 的 不 那么 罕见 的 错误 
(Heikki Linnakangas) 


。 修复 Borland C 编 译 脚本 (L Bayuk) 
。 正确 的 处 理 以 00 结束 的 年 的 to_char('cc') (Tom) 
2000 年 是 二 十 世纪 ， 而 不 是 二 十 一 世纪 。 
e /contrib/tsearch2 本 地 化 改善 (Tatsuo, Teodor) 
e 修复 information_schema.key_column_usage 视图 中 不 正确 的 权限 检查 (Tom) 


症状 是 "relation with OID nnnnn does not exist" 错 误 。 要 不 使 用 initdb 来 修复 这 个 错 
误 ， 使 用 CREATE oR REPLACE VIEW 安装 在 share/information_schema.sql 中 找到 的 正确 的 
定义 。 注意 ， 你 将 需要 在 每 个 数据 库 中 执行 。 


。 为 拥有 许多 表 的 数据 库 提高 vacuum 性 能 (Tom) 
。 修复 由 uno 触发 的 罕见 的 Assert() 崩 涡 (Tom) 
。 修复 使 用 Row 不 平等 条 件 的 索引 搜索 中 潜在 的 不 正确 的 结果 (Tom) 


。 为 超过 三 字 节 长 度 的 UTF8 序 列 加 强 多 字 节 字符 处 理 的 安全 (Tom) 


修复 由 于 党 试 同步 早已 删除 的 文件 ， 在 Windows 上 发 生 的 假 的 "没有 权限 "失败 (Magnus, 
Tom) 


修复 可 能 导致 状态 收集 器 在 Windows 上 挂 掉 的 错误 (Magnus) 
这 会 反 过 来 导致 自动 清理 不 工作 。 

修复 一 个 早已 使 用 的 PL/pgSQL 画 数 被 更 新 时 可 能 的 骨 溃 (Tom) 
改善 PL/pgSQL 对 域 类 型 的 处 理 (Sergiy Vyshnevetskiy, Tom) 


修复 处 理 PL/pgSQL 异 常 块 中 可 能 的 错误 (Tom) 


E.100. 版 本 8.2.1 


发 布 日 期 : 2007-01-08 


这 个 版 本 包含 各 种 自 8.2 以 来 的 修复 。 关 于 8.2 主 版 本 的 新 特性 信息 ， 请 查看 Section E.101。 


E.100.1. 迁移 到 版 本 8.2.1 


运行 8.2.X 的 用 户 不 需要 转 储 /恢复 。 


E.100.2. 修改 列表 


e 修复 sELECT ... LIMIT ALL (还 有 LIMIT NULL ) 的 月 淡 (Tom) 
e several /contrib/tsearch2 修复 (Teodor) 
e 在 Windows 上 ， 让 来 自 操作 系统 的 日 志 消 息 使 用 ASCII 编 码 (Hiroshi Saito) 
这 修复 了 操作 系统 和 数据 库 服务 器 的 编码 错误 匹配 时 的 转换 问题 。 
。 修复 使 用 wins2.mak 的 pg_dump 的 Windows 连 接 (Hiroshi Saito) 
。 为 外 连接 查询 修复 规划 器 错误 (Tom) 
。 修复 几 个 包括 子 SELECT 的 查询 中 的 问题 (Tom) 
。 修复 子 事务 退出 期 间 SPI 中 潜在 的 崩溃 (Tom) 
这 影响 所 有 PL 画 数 ， 因 为 他 们 都 使 用 SPl。 
。 提高 PDF 文件 的 建立 速度 (Peter) 
e 重新 添加 JST (Japan) 时 区 缩写 (Tom) 
。 改善 与 素 引 扫描 相关 的 最 优化 决策 (Tom) 
e 让 psql 像 以 前 一 样 输出 多 字 节 组 合 字符 ， 而 不 是 作为 \u 输出 (Tom) 
。 改善 使 用 括号 的 正则 表达 式 的 索引 使 用 (Tom) 
这 也 提高 了 psql \d 性 能 。 


e 当 从 一 个 早 于 8.2 的 服务 器 中 转 储 时 ， 让 pg_dumpall 假 设 数据 库 有 公共 的 connect 权限 
(Tom) 


这 保留 了 以 前 如 果 pg_hba.conf 允许， 那么 任何 人 都 可 以 连接 到 数据 库 的 行为 。 
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E.101. 版 本 8.2 


发 布 日 期 : 2006-12-05 


E.101.1. 概述 


这 个 版 本 添加 了 许多 用 户 要 求 的 功能 和 性 能 改善 ， 包 括 : 


e 查询 语言 增强 包括 INSERT/UPDATE/DELETE RETURNING, 多 行 vALUES 列表 


和 UPDATE / DELETE 中 可 选 的 目标 表 别 名 。 
。 不 带 有 并 发 锁 的 索引 创建 insert / UPDATE / DELETE 操作 
。 许多 查询 最 优化 改善 ， 包 括 对 重新 排序 外 连接 的 支持 
。 提高 降低 内 存 使 用 的 排序 性 能 
。 带 有 更 好 的 并 发 性 的 更 多 有 效 的 锁定 
。 更 有 效 的 清理 
。 简化 热 备 服务 器 的 管理 
。 为 表 和 索引 新 增 FILLFACTOR 支持 
。 监视 、 记 录 和 性 能 调 优 的 添加 
。 对 创建 和 删除 对 象 的 更 多 控制 
。 表 继 承 管理 可 以 为 已 经 存在 的 表 定义 或 从 已 经 存在 的 表 中 删除 
e copy To 可 以 拷贝 任意 sELEcT 语句 的 输出 
。 数组 的 改进 ， 包 括 空 数组 
。 RRM, BS Bin ARRASOQL:2003% it HX 


e 许多 contribs 的 改进 


E.101.2. 迁移 到 版 本 8.2 


想 要 从 任何 以 前 的 版 本 中 迁移 数据 的 用 户 需要 使 用 pg_dump 转 储 /恢复 。 
观察 下 列 的 不 兼容 性 : 


e 缺 省 设置 escape_string warning 为 on (Bruce) 


Jig 


pa = 
Flo 


如 果 反 斜 杠 逃逸 在 非 逃逸 ( 非 E'，) 字 符 串 中 使 用 ， 这 会 发 出 一 个 


修改 行 构造 画 数 语法 (Row...) )， 这 样 列 表 元 素 foo.* 将 被 扩展 到 一 个 他 们 的 成 员 字 段 
的 列表 ， 而 不 是 和 以 前 一 样 创建 一 个 谋 套 的 行 类 型 字段 (Tom) 


新 的 行为 实际 上 更 有 用 ， 因 为 它 人 允许 ， 例 如 ， 触 发 器 用 
IF row(new.*) IS DISTINCT FROM row(old.*) 检查 数据 的 改变 。 通过 省 略 .* ， 仍 然 可 以 
使 用 老 的 行为 。 


让 行 比较 遵循 SQL 标准 语义 ， 并 允许 它们 在 索引 扫描 中 使 用 (Tom) 


以 前 ，row = 和 <> 上 比较 遵循 标准 ， 但 是 < <= > >= 不 遵循 标准 。 行 比较 现在 可 以 用 作 多 字 
段 素 引 的 索引 约束 匹配 行 值 。 


让 row IS [NOT] NULL 测试 遵循 SQL 标准 语义 (Tom) 


前 者 的 行为 在 rs NuLL 的 简单 情况 下 符合 标准 ， 但 是 如 果 任 意 行 字段 是 非 空 的 ， 
IS NOT NULL 将 返回 真 ， 而 标准 认为 只 有 所 有 字段 都 是 非 空 的 时 才 应 该 返回 真 。 


让 SET CONSTRAINT 只 影响 一 个 约束 (Kris Jurka) 


在 以 前 的 版 本 中 ， sET consTRAINT 用 一 个 匹配 的 名 字 修 改 所 有 的 约束 。 在 这 个 版 本 中 ， 
模式 搜索 路 径 只 用 于 修改 第 一 个 匹配 的 约束 。 也 支持 模式 声明 。 这 更 加 符合 SQL 标准 。 


因为 安全 原因 ， 为 表 删 除 ute 权限 (Tom) 
这 个 版 本 ， 只 有 表 的 所 有 者 可 以 为 该 表 创 建 或 修改 规则 。 为 了 向 后 兼容 ， 仍然 接 


SZ GRANT / REVOKE RULE ， 但 是 它 什 么 也 不 做 。 
数组 比较 的 改进 (Tom) 

现在 也 比较 数组 的 维度 。 

修改 数组 连接 ， 以 匹配 记录 的 行为 (Tom) 

这 改变 了 串联 会 修改 数组 下 界 的 以 前 的 行为 。 

让 postmaster 和 postgres 的 命令 行 选 项 相同 (Peter) 


这 人 允许 主 进程 不 使 用 -o 就 能 传递 参数 到 每 个 后 端 。 请 注意 ， 某 些 选项 现在 只 能 用 作 长 
格式 的 选项 ， 因 为 与 单字 母 的 选项 有 冲突 。 


反对 使 用 postmaster 符 号 连接 (Peter) 


postmaster 和 postgres 命 令 现 在 动作 相同 ， 行为 由 命令 行 选项 决定 。 为 了 兼容 性 ， 保 留 
了 postmaster 符 号 连接 ， 但 是 实际 上 不 需要 了 。 


修改 log duration, 使 其 在 查询 没有 输出 的 情况 下 也 输出 (Tom) 
在 以 前 的 版 本 中 ， log_duration 只 在 查询 出 现在 日 志 的 前 面 时 才 输 出 。 


让 to_char(time) 和 to_char(interval) 对 待 HH 和 HH12 为 12 小 时 间隔 
大 多 数 应 用 应 该 使 用 hh24 ， 除 非 它 们 想 要 12 小 时 显示 。 

在 从 INET 到 cron 的 转换 中 有 需 个 未 标记 的 位 (Tom) 

这 确保 了 转换 的 值 对 于 cIDR 实际 有 效 。 

删除 australian_timezones 配置 变量 (Joachim Wieland) 

为 了 配置 时 区 缩写 ， 这 个 变量 被 一 个 更 通用 的 设备 取代 。 

为 局 套 的 循环 索引 扫描 改善 开销 估计 (Tom) 


这 可 以 消除 设置 不 切实 际 的 小 的 random page cost 值 的 需要 。 如 果 你 已 经 使 用 了 一 个 非 
常 小 的 random_page_cost , 请 重新 检查 你 的 测试 用 例 。 


改变 pg_dump -n 和 -t 选项 的 行为 。 (Greg Sabino Mullane) 

请 查看 pg_dump 手册 页 获取 细节 。 

修改 libpq PQdsplen() 以 返回 一 个 有 用 的 值 (Martijn van Oosterhout) 

声明 libpq PQgetss1() 返回 void * ， 而 不 是 ssl * (Martijn van Oosterhout) 
这 人 允许 应 用 不 包括 OpenSSL 头 使 用 函数 。 


为 了 版 本 兼容 性 检查 ，C 语 言 可 加 载 模块 现在 必须 包括 一 个 PG6_MopuLE_MmA6IC 宏 调 用 
(Martijn van Oosterhout) 


AT REE, PL/PerlUA 3 (FA Aye TB BT FF PL/Perlzx 2X (Andrew) 


> Note: xt BRGAEEPL/PerlAAPL/PerlUMAZ i] FBREBHS, 某 些 Perl 安 
装 没有 用 正确 的 允许 多 个 解释 器 存在 于 一 个 进程 中 的 标识 编译 。 在 这 种 情况 下 ，PL/Perl 
和 PL/PerlU 不 能 同时 用 于 一 个 后 端 中 。 解决 办 法 是 获得 一 个 支持 多 个 解释 器 的 Perl 安 


J+ 
To 


在 contrib/xm12/ 中 ， 重 命名 xml_valid() 为 xml_is_well_formed() (Tom) 
为 了 向 后 兼容 ， 将 保留 xml_valid() ， 但 是 它 的 行为 将 在 未 来 的 版 本 中 改变 为 模式 检查 。 
删除 contrib/ora2pg/ ， 现 在 在 http://www.samse.fr/GPL/ora2pg 中 


删除 已 经 迁移 到 PgFoundry 的 贡献 模块 : adddepend ，dbase , dbmirror , 


fulltextindex , mac , userlock 
删除 废弃 的 贡献 模块 : msQL-interface , tips 
删除 QNX 和 BEOS 端 口 (Bruce) 


这 些 端口 不 再 有 活路 的 维护 者 。 


E.101.3. 修改 列表 


下 面 你 将 看 到 PostgreSQL 8.2 和 以 前 的 主 版 本 之 间 详 细 的 变化 。 


E.101.3.1. 性 能 提升 
。 允许 规划 器 在 某 些 情况 下 重新 排序 外 连接 (Tom) 


在 以 前 的 版 本 中 ， 外 连接 总 是 以 在 查询 中 写 入 的 顺序 计算 。 这 个 修改 允许 查询 优化 器 考 
虑 重新 排序 外 连接 ， 在 它 确定 改变 连接 顺序 而 不 改变 查询 的 意思 的 情况 下 。 这 对 于 包含 
多 个 外 连接 或 混合 内 部 和 外 部 连接 的 查询 来 说 ， 会 产生 一 个 可 观 的 性 能 差异 。 


。 提高 IN (表达 式 列表 ) 子 句 的 效率 (Tom) 

。 提高 排序 速度 和 减少 内 存 使 用 (Simon, Tom) 

。 提高 子 事务 性 能 (Alvaro, ltagaki Takahiro, Tom) 

e 添加 FILLFACTOR 到 表 和 索引 创建 (ITAGAKI Takahiro) 


这 在 每 个 表 或 索引 页 中 留 有 额外 的 自由 空间 ， 人 允许 随 着 数据 的 增长 提高 性 能 。 这 对 于 维 
护 集群 来 说 特别 有 价值 。 


e 为 shared_buffers 和 max_fsm_pages 增加 默认 值 (Andrew) 
。 通过 打 断 锁 管 理 器 表 为 部 分 ， 提 高 锁 的 性 能 (Tom) 


这 人 允许 锁定 粒度 更 细 ， 减 少 争 用 。 


减少 序列 扫描 的 锁定 需求 (Qingqing Zhou) 


减少 数据 库 创建 和 销毁 的 锁定 需求 (Tom) 
e 为 LIKE ，ILIKE 和 正则 表达 式 操 作 改 善 优化 器 的 选择 性 估计 。 


改善 连接 的 规划 ， 以 继承 的 表 和 unton ALL 视图 (Tom) 


允许 约束 排除 应 用 于 继承 的 uppATE 和 DELETE 查询 (Tom) 
SELECT 早已 遵循 约束 排除 。 


e 改善 常量 WHERE 子 句 的 规划 ， 比 如 一 个 只 依赖 于 从 一 个 外 部 查询 级 别 继承 的 变量 的 条 件 
(Tom) 


协议 级 别 未 命名 的 预备 语句 是 为 每 个 BIND 值 组 重新 规划 的 (Tom) 
因为 准确 的 参数 值 可 以 在 计划 中 使 用 ， 所 以 提高 了 性 能 。 


加 速 清理 B-Tree 索 引 (Heikki Linnakangas, Tom) 


避免 在 vacuum HA lal aA ta tak A 451 HR (Greg Stark) 
提高 多 字段 GiST 索 引 (Oleg, Teodor) 


在 B-Tree 页 分 裂 之 前 删除 死 的 索引 条 目 (Junji Teramoto) 


E.101.3.2. 服务 器 的 变化 


允许 强制 切换 到 一 个 新 的 事务 日 志文 件 (Simon, Tom) 


这 对 于 保持 热 备份 从 服务 器 与 主 服 务 器 同步 是 有 价值 的 。 事 务 日 志文 件 切换 现在 在 
pg_stop_backup() 期 间 也 自 动 发 生 。 这 确保 了 恢复 所 需要 的 所 有 事务 日 志文 件 可 以 立即 
轨 档 。 


添加 WAL 信 息 函 数 (Simon) 


为 从 pg_stop_backup() 和 相关 画 数 显 示 的 十 六 进 制 WAL 位 置 中 询问 当前 事务 日 志 插 入 点 
和 决定 WAL 文 件 名 添加 函数 。 


改善 WAL 重 放 期 间 从 一 个 崩溃 中 恢复 (Simon) 


服务 器 现在 在 WAL 恢 复 期 间 定 期 的 检查 点 ， 所 以 如 果 有 一 个 月 演 ， 未 来 的 WAL 恢 复 被 缩 
Ho RURA T, 就 消除 了 对 热 备份 服务 器 重 放 自 基础 备份 以 来 的 整个 日 志 的 需 
要 。 


改善 长 期 的 WAL 重 放 的 可 靠 性 (Heikki, Simon, Tom) 


以 前 ， 由 于 XID 包 围 ， 向 前 推进 超过 20 亿 事务 的 尝试 将 不 会 工作 。 这 意味 着 热 备 服务 器 
必须 定期 从 干净 的 基础 备份 中 重 载 。 


添加 archive_timeout , 强制 事务 日 志文 件 在 给 定 的 时 间 间 隔 切换 (Simon) 
这 为 热 备份 服务 器 执行 最 大 的 复制 延迟 。 

添加 本 地 LDAP 认 证 (Magnus Hagander) 

这 对 于 不 支持 PAM 的 平台 ， 上 比如 Windows， 尤 其 有 用 。 

添加 GRANT CONNECT ON DATABASE (Gevik Babakhani) 


给 出 了 数据 库 访 问 的 SQL 级 别 控制 。 它 作为 一 个 额外 的 过 滤器 工作 ， 紧 接着 现 有 的 


pg_hba.conf 控制 。 
添加 对 SSL 证 书 撤销 列表 (CRL) 文件 的 支持 (Libor Hohos) 
服务 器 和 libpq 现 在 都 能 识别 CRL 文 件 。 
GiST 索 引 现 在 是 可 集群 的 (Teodor) 


删除 例 程 自动 清理 服务 器 日 志 条 目 (Bruce) 

pg_stat_activity 现在 显示 自动 清理 活动 。 
在 单独 的 表 而 不 是 整个 数据 库 中 跟踪 最 大 的 XID 寿 命 (Alvaro) 
这 通过 避免 不 必要 的 VACUUM, 减 少 了 阻止 事务 ID 环绕 中 包括 的 开销 。 
添加 最 后 的 清理 和 分 析 时 间 戳 字段 到 状态 收集 器 (Larry Rosenman) 
这 些 值 现 在 出 现在 pg stat * tables 系统 视图 中 。 
提高 统计 监测 的 性 能 ， 尤 其 是 stats_command_string (Tom, Bruce) 


这 个 版 本 缺 省 启用 stats_command_string ， 现 在 它 的 开销 是 最 小 的 。 这 意味 
着 pg stat activity 现在 缺 省 将 显示 所 有 活动 的 查询 。 


添加 一 个 waiting 字段 到 pg_stat_activity (Tom) 
这 允许 pg_stat_activity 显示 所 有 包括 在 ps 显示 中 的 信息 。 
添加 配置 参数 update_process_title , 控制 ps 的 显示 是 否 为 每 个 命令 都 更 新 了 (Bruce) 


在 更 新 ps 显示 昂贵 的 平台 上 ， 有 必要 把 这 个 关 掉 ， 完 全 依赖 于 po stat_activity 显示 状 


态 信息 。 

允许 在 配置 设置 中 指定 单位 (Peter) 

例如 ， 你 现在 可 以 设置 shared_buffers 为 32MB ， 而 不 是 在 心里 转换 大 小 。 
在 postgresql.conf 中 添加 对 包含 指 合 的 支持 (Joachim Wieland) 

改善 协议 级 别 预 各 / 绑 定 /执行 消息 的 记录 (Bruce, Tom) 


这 样 的 日 志 现 在 显示 语句 名 字 、 绑 定 人 参数 值 和 被 执行 查询 的 文本 。 另外， 41K 
过 log_min_error_statement 启用 时 ， 查 询 文 本 正确 的 包含 在 记录 的 错误 消息 中 。 


阻止 max_stack_depth 被 设置 为 不 安全 的 值 


在 我 们 可 以 决定 实际 内 核 堆栈 深度 限制 的 平台 上 (大 多 数 是 ) ， 确 保 max_stack_depth 的 
初始 缺 省 值 是 安全 的 ， 并 拒绝 党 试 设置 它 为 不 安全 的 大 值 。 


在 更 多 情况 下 的 查询 中 启用 突出 显示 错误 位 置 (Tom) 


服务 器 现在 能 够 为 一 些 语义 错误 报告 一 个 具体 的 错误 位 置 (比如 未 识别 的 字段 名 ) ， 而 
不 是 和 以 前 一 样 只 报告 基本 的 语法 错误 。 


修复 vacuum 中 "未 能 重新 找到 父 键 "错误 (Tom) 
在 服务 器 重新 启 动 期 间 清 理 pg_internal.init 缓存 文件 (Simon) 


这 避免 了 PITR 恢 复 之 后 缓存 文件 可 能 包含 陈旧 数据 的 风险 。 
。 修复 通过 vacuum 截断 十 亿 字 节 范 围 的 大 关系 时 的 竞 态 条 件 (Tom) 
。 修复 行 级 别 锁 上 导致 不 需要 的 死 锁 错误 的 bug (Tom) 


。 修复 影响 几 十 亿 字 节 哈 希 索引 的 错误 (Tom) 


> 
j} 
FE 


。 每 进程 现在 是 它 自己 的 进程 组 领导 (Tom) 


这 人 允许 查询 取消 退出 从 一 个 后 端 或 为 档 / 恢 复 进程 中 调用 的 子 进程 。 


E.101.3.3. 查询 的 变化 
e 添加 INSERT / UPDATE / DELETE RETURNING (Jonah Harris, Tom) 


这 人 允许 这 些 命 命 返回 值 ， 上 比如 为 一 个 新 行 计算 序列 键 。 在 uppATE 的 情况 下 ， 返回 来 自行 
的 更 新 版 本 的 值 。 


e 添加 对 多 行 vALuEs 子 句 的 支持 ， 按照 SQL 标准 (Joe, Tom) 


这 允许 INSERT 插入 多 行 常 量 ， 或 查询 使 用 常量 生成 结果 集 。 例 如 ， 
© 


INSERT ... VALUES (...), (...), «++. , and 
(Gee 


SELECT * FROM (VALUES (...), ), ....) AS alias(f1, ...) o 
e 允许 UPDATE 和 DELETE 为 目标 表 使 用 一 个 别名 (Atsushi Ogawa) 


SQL 标准 不 允许 在 它们 的 命令 中 使 用 别名 ， 但 是 许多 数据 库 系 统 为 了 标记 方便 ， 无 论 如 
何 都 允许 一 个 。 


e Sti UPDATE 在 一 个 值 的 列表 中 设置 多 个 字段 值 (Susanne Ebrecht) 


这 基本 上 是 一 个 按 对 分 配 字段 和 值 的 速记 。 语 法 是 UPDATE tab SET (``_column , ...) = 
( _val_, aeo 


o 使 行 比较 按照 标准 工作 (Tom) 


格式 <, <=, >, >= 现 在 按 字母 顺序 比较 行 ， 也 就 是 ， 比 较 第 一 个 元 素 ， 如 果 相 等 则 比较 第 
二 个 元 素 ， 以 此 类 推 。 以 前 它们 在 所 有 的 元 素 上 扩展 成 一 个 AND 条 件 ， 这 既 不 是 标准 也 
不 是 非常 有 用 。 


e 添加 cAscApE 选项 到 TRUNCATE (Joachim Wieland) 


这 导致 truncate 自动 包括 通过 外 键 引 用 指定 的 表 的 所 有 表 。 虽然 方便 ， 但 是 这 是 一 个 危 
险 的 工具 一 小 心 的 使 用 它 ! 


。 在 同一 个 sect 命令 中 支持 FOR UPDATE 和 FOR SHARE (TOM) 


e 添加 Is not DISTINCT FROM (Pavel Stehule) 


这 个 操作 符 类 似 于 等 于 ( = )， 但 是 当 左 侧 和 右 侧 的 操作 数 都 是 nu 时 ， 评估 为 真 ， 当 
只 有 一 侧 为 NULL 时 评估 为 假 ， 而 不 是 在 这 些 情况 下 生成 NULL o 


改善 UNION / intersect / except 使 用 的 长 度 输出 (Tom) 
当 所 有 对 应 的 字段 有 相同 的 定义 长 度 时 ， 该 长 度 用 于 结果 ， 而 不 是 一 个 通用 的 长 度 。 
允许 ILIKE 为 多 字 节 编码 工作 (Tom) 


内 部 的 ， ILIKE 现在 调用 lower() 然后 使 用 LIE 。 地 区 设 定 的 正则 表达 式 模式 在 这 些 
编码 中 仍然 不 工作 。 


使 standard_conforming_strings 能 变 成 on (Kevin Grittner) 


这 人 允许 禁用 字符 串 中 的 反 斜 杠 逃 逸 ， 让 PostgreSQL 更 加 标准 兼容 。 为 了 向 后 兼容 ， 缺 省 
是 off ， 但 是 未 来 的 版 本 将 改 成 缺 省 为 on 。 


不 要 在 子 查询 目标 列表 中 平面 化 包含 volatile HAN F & i4 (Jaime Casanova) 


这 阻止 了 由 于 volatile NER (比如 random() 或 nextval() ) 的 多 次 评估 引起 的 意外 行 
为 。 它 可 能 导致 在 不 需要 标记 为 volatile 的 函数 面前 性 能 退化 。 


添加 系统 视图 pg_prepared_statements 和 pg cursors, 显示 预备 语句 和 打开 的 游标 
(Joachim Wieland, Neil) 


这 在 池 连 接 设置 中 非常 有 用 。 

在 ExPLAIN 和 EXECUTE 中 支持 入 口 参 数 (Tom) 

这 允许， 例如 ，JDBC ? 参数 在 这 些 命 命中 工作 。 

如 果 SQL 级 别 的 prepare 参数 没有 指定 ， 那 么 从 查询 的 内 容 中 推断 它们 的 类 型 (Neil) 
协议 层 PREPARE 早已 这 样 做 了 。 


允许 LIMIT 和 oFFSET 超过 二 十 亿 (Dhanaraj M) 


E.101.3.4. 对 象 操作 的 变化 


添加 TABLESPACE 子 名 到 create TABLE AS (Neil) 

这 人 允许 为 新 表 指 定 表 空间 。 

添加 on commit 子 句 到 create TABLE as (Neil) 

这 人 允许 临时 表 在 事务 提交 时 被 截断 或 删除 。 该 表 缺 省 的 行为 是 保持 到 会 话 结束 。 
添加 INCLUDING CONSTRAINTS 到 CREATE TABLE LIKE (Greg Stark) 


这 人 允许 容易 的 拷贝 cHEck 约束 到 一 个 新 表 。 


。 人 允许 创建 占 位 符 (FH) * 2 (Martijn van Oosterhout) 


一 个 壳 类 型 声明 创建 一 个 类 型 名 ， 没 有 声明 该 类 型 的 任何 细节 。 这 使 得 壳 类 型 是 有 用 
的 ， 因 为 它 允 许 更 干净 的 声明 类 型 的 输入 /输出 画 数 ， 它们 在 该 类 型 被 定义 为 " 真 的 "之 前 


必须 存在 。 语 法 是 CREATE TYPE _typename_ o 
。 聚集 函数 现在 支持 多 个 输入 参数 (Sergey Koposov, Tom) 
。 添加 新 的 聚集 创建 语法 (Tom) 


新 的 语法 是 CREATE AGGREGATE _aggname ( input_type )( parameter_list_ Jo 更 自然 


的 支持 新 的 多 参数 聚集 功能 。 仍 然 支持 以 前 的 语法 。 





e 添加 ALTER ROLE PASSWORD NULL, 删除 以 前 设置 的 角色 密码 (Peter) 
© 为 许多 对 象 类 型 添加 DROP 对 象 IF exists (Andrew) 
这 人 允许 DRoP 操作 一 个 不 存在 的 对 象 时 不 会 生成 错误 。 
e 添加 prop owen, 删除 一 个 角色 拥有 的 所 有 对 象 (Alvaro) 
e 添加 REASSIGN owNED ， 重新 分 配 一 个 角色 拥有 的 所 有 对 象 (Alvaro) 
这 个 和 上 面 的 prop owNED ， 帮 助 删 除 角 色 。 
e 添加 GRANT on SEQUENCE 语法 (Bruce) 


这 是 为 了 设置 特定 于 序列 的 权限 添加 的 。 为 了 后 向 兼容 ， 仍然 支持 序列 


的 GRANT ON TABLE 。 
© 为 序列 添加 usace 权限 ， 只 人 允许 currval() 和 nextval() ， 不 允许 setval() (Bruce) 


USAGE 权限 允许 更 精细 的 控制 序列 访问 。 usAGE 人 允许 用 户 增 加 一 个 序列 ， 但 是 阻止 他 们 
使 用 setval() 设置 该 序列 为 任意 值 。 


e 添加 ALTER TABLE [ NO ] INHERIT (Greg Stark) 


这 允许 继承 动态 调整 ， 而 不 是 只 在 表 创 建 和 销毁 时 。 这 在 使 用 继承 实现 表 分 区 时 是 非常 
有 价值 的 。 


。 人 多 许 在 全 局 对 象 上 的 注释 全 局 存储 (Kris Jurka) 


以 前 ， 附 加 到 数据 库 的 注释 存储 在 单独 的 数据 库 中 ， 使 得 它们 无 效 ， 并 且 没 有 规定 注释 
规则 或 表 空 间 。 这 个 修改 添加 了 一 个 新 的 共享 目录 pg_shdescription 并 在 数据 库 、 角 色 
和 表 空 间 上 存储 注释 。 


E.101.3.5. LTEM DHI sz ib 


。 添加 选项 以 允许 索引 创建 时 不 阻塞 并 发 的 守 入 到 表 (Greg Stark, Tom) 


新 的 语法 是 CREATE INDEX CONCURRENTLY o 缺 省 的 行为 在 索引 被 创建 时 仍然 阻塞 表 的 修 
改 。 


。 提供 咨询 锁 功 能 (Abhijit Menon-Sen, Tom) 


这 是 一 个 新 的 锁 API， 设 计 来 替换 佛经 在 /contrib/userlock 中 的 那个 。 userlock 代 码 现 在 在 
pgfoundry 上 。 


© 人 允许 copy 转 储 SELECT 查询 (Zoltan Boszormenyi, Karel Zak) 
这 人 允许 copy 转 储 任意 的 SQL 查询 。 语法 是 COPY (SELECT ...) TO o 
e 让 copy 命令 返回 一 个 命令 标签 ， 该 标签 包括 拷贝 的 行 数 (Volkan YAZICI) 


e 允许 vacuum 终止 行 ， 而 不 受 其 他 并 发 vacuum 操作 的 影响 (Hannu Krossing, Alvaro, 
Tom) 


e 让 initdb 检测 操作 系统 环境 并 相应 的 设置 缺 省 patestyle (Peter) 
这 使 得 安装 的 postgresql.conf DateStyle 值 更 有 可 能 正 是 所 需要 的 。 


。 减少 initdb 显 示 的 进展 消息 的 数量 (Tom) 


E.101.3.6. 日 期 /时 间 的 变化 
e 在 timestamp 的 输入 值 中 允许 完整 的 时 区 名 (Joachim Wieland) 
例如 ， '2006-05-24 21:11 America/New_York'::timestamptz o 
。 支持 可 配置 的 时 区 缩写 (Joachim Wieland) 
所 需 的 一 组 时 区 缩写 可 以 通过 配置 参数 timezone abbreviations 选择 。 


° 添加 pg_timezone_abbrevs 和 pg_timezone_names 视图 ， 显示 支持 的 时 区 (Magnus 
Hagander) 


° 添加 clock_timestamp() 、 statement_timestamp() 和 transaction_timestamp() (Bruce) 


clock_timestamp() 是 当前 挂钟 的 时 间 ， statement_timestamp() 是 当前 语句 到 达 服 务 器 
的 时 间 ， transaction_timestamp() 是 now() 的 一 个 别名 。 


e Sti to_char() 打印 本 地 化 的 月 和 日 的 名 字 (Euler Taveira de Oliveira) 

e 人 多 许 to_char(time) 和 to_char(interval) 输出 AM/PM 规 格 (Bruce) 
间隔 和 时 间 是 看 做 24 小 时 周期 的 ， 例 如 25 hours 被 认为 是 AM。 

e 添加 新 的 辑 数 justify_interval() ， 调整 间隔 单位 (Mark Dilger) 


。 人 允许 时 区 偏 移 距 离 GMT 达 到 14:59 


Kiribati 使 用 GMT+14， 所 以 我 们 最 好 接受 它 。 


间隔 计算 的 改进 (Michael Glaesemann, Bruce) 


E.101.3.7. 其 他 数据 类 型 和 辑 数 的 变化 


允许 数组 包含 nur 元 素 (Tom) 

允许 分 配 数 组 元 素 和 与 现 有 的 项 不 连续 (Tom) 

介 于 中 间 的 数组 位 置 将 用 null 填 充 。 这 是 符合 SQL 标 准 的 。 

为 数组 子 集 比 较 新 增 内 建 的 操作 符 ( @&gt; 、 &lt;@ 、 && ) (Teodor, Tom) 
这 些 操作 符 可 以 被 使 用 GiST 或 GIN 索引 的 许多 数据 类 型 素 引 。 

在 inet / cIDR 值 上 添加 方便 的 算术 操作 (Stephen R. van den Berg) 


新 增 的 操作 符 是 & (and), | (or) ~ (not), inet + ints. inet - ints 


和 inet - ineto 
从 SQL:2003 添 加 新 的 聚集 函数 (Neil) 


新 增 的 函数 是 var_pop() 、 var_samp() 、 
stddev_pop() 和 stddev_samp() o var_samp() 和 stddev_samp() 只 是 重 命 名 现 有 的 聚 
集 variance() 和 stddev() 。 后 者 的 名 字 为 了 后 向 兼容 仍然 可 用 。 


添加 SQL:2003 统 计 聚 集 (Sergey Koposov) 


SiS NR : regr_intercept() 、 regr_slope() s 
regr_r2() 、 corr() 、 covar_samp() 、 covar_pop() 、 regr_avgx() 、 regr_avgy() 、 


regr_sxy() 、 regr_sxx() 、 regr_syy() s regr_count() o 
允许 domains 基 于 其 他 的 域 (Tom) 
适当 的 加 强 域 的 chEck 约束 (Neil, Tom) 


例如 ， 声 明 返 回 域 类 型 的 用 户 定义 图 数 的 结果 现在 检查 该 域 的 约束 。 这 关闭 了 域 实现 中 
的 一 个 重大 漏洞 。 


修复 转 储 重 命名 的 sERIAL 字段 的 问题 (Tom) 


该 修复 是 通过 明确 的 指定 序列 的 bfFAuLT 和 序列 元 素 转 储 一 个 sERIAL ， 并 且 在 重新 加 载 
时 使 用 一 个 新 的 ALTER SEQUENCE OWNED BY 命令 重新 构造 该 SERIAL 的 字段 。 这 也 人 允许 删 


除 一 个 sERIAL 字段 声明 。 
添加 一 个 服务 器 端 休眠 函数 pg _sleep() (Joachim Wieland) 


为 tid (tuple id) 数据 类 型 添加 所 有 比较 操作 符 (Mark Kirkwood, Greg Stark, Tom) 


E.101.3.8. PL/pgSQL 服 务 器 端 语言 的 变化 
e 添加 TG_table_name 和 TG_table_schema 到 触发 器 参数 (Andrew) 
TG_relname 现在 已 经 废弃 了 。 也 为 其 他 PL 在 触发 器 参数 中 做 了 类 型 的 变化 。 
e sti FOR 语句 返回 标量 值 、 记 录 和 行 类 型 (Pavel Stehule) 
。 添加 一 个 BY 子 句 到 FoR 循环 ， 控 制 迭代 增 量 (Jaime Casanova) 
e 添加 strict 到 sELECT INTO (Matt Miller) 
为 了 Oracle PL/SQL 兼 容 性 ， 如 果 多 于 或 少 于 一 行 被 seLEcT 返回 ， 则 strict 模式 抛 出 


ny, 
一 个 异 单 。 


E.101.3.9. PL/Perl 服 务 器 闯 语 言 的 变化 
e 添加 table_name 和 table_schema 到 触发 器 参数 (Adam Sjøgren) 
。 添加 预 各 查询 (Dmitry Karasik) 
。 让 $ TD 触发 一 个 全 局 变量 的 数据 (Andrew) 
在 以 前 ， 这 是 一 个 词汇 ， 引 起 意外 的 分 享 违规 行为 。 
。 为 了 安全 起 见 ， 在 单独 的 解释 器 中 运行 PL/Perl 和 PL/PerlU (Andrew) 
在 序列 中 ， 它 们 再 也 不 能 分 享 数据 和 加 载 模 块 。 另 外 ， 如 果 Perl 没 有 用 必要 的 标识 编译 
以 允许 多 个 解释 器 ， 那 么 在 任何 给 出 的 后 端 进程 中 ， 只 可 以 使 用 这 些 语言 中 的 一 种 。 
E.101.3.10. PL/Python 服 务 器 端 语 言 的 变化 
。 命名 的 参数 是 作为 普通 变量 传送 的 ， 和 在 args[] 数组 中 一 样 (Sven Suursoho) 
e 添加 table_name 和 table_schema 到 触发 器 参数 (Andrew) 
。 人 允许 返回 复合 类 型 和 结果 集 (Sven Suursoho) 
e 作为 list, iterator 或 generator 返回 结果 集 (Sven Suursoho) 
。 人 允许 图 数 返回 void (Neil) 


。 现在 支持 Python 2.5 了 (Tom) 


E.101.3.11. psql 的 变化 


e MIATA AAD \password ， 用 客户 端 侧 的 口令 加 密 修 改 角色 口令 (Peter) 


。 人 允许 \c 连接 到 一 个 新 的 主机 和 端口 号 (David, Volkan YAZICI) 
。 添加 表 空 间 显 示 到 \1+ (Philip Yarra) 
。 改善 \df 斜 线 命 分 ， 包 含 画 数 的 参数 名 和 模式 ( out 或 INouT ) (David Fetter) 
。 支持 二 进 制 copy (Andreas Pflug) 
。 添加 选项 在 一 个 事务 中 运行 整个 会 话 (Simon) 
使 用 选项 -1 或 --single-transaction 。 
。 支持 使 用 一 个 游标 按 批 次 的 自动 检索 secect 结果 (Chris Mair) 


这 是 使 用 \set FETcH_couNT _n_ 启用 的 。 这 个 特性 允许 在 psql 中 检索 大 的 结果 集 ， 而 
不 用 尝试 在 内 存 中 缓存 整个 结果 集 。 


© 让 多 行 值 对 齐 在 适当 的 字段 内 (Martijn van Oosterhout) 
包含 换行 符 的 字段 值 现在 以 更 可 读 的 方式 显示 。 
e 多 行 语 句 保存 为 一 个 条 目 ， 而 不 是 一 次 一 行 (Sergey E. Koposov) 


这 使 得 向 上 箭头 调 回 查询 更 加 简单 。 (在 Windows 上 是 不 可 用 的 ， 因为 该 平台 使 用 操作 
系统 中 的 本 地 命令 行 编辑 。 ) 


o 让 行 计数 器 是 64 位 的 ， 这 样 它 可 以 处 理 行 数 超过 二 十 亿 的 文件 (David Fetter) 


e 为 INSERT / UPDATE / DELETE RETURNING 报告 返回 的 数据 库 和 命令 状态 标签 (Tom) 


E.101.3.12. pg_dump 的 变化 


。 人 允许 对 象 的 综合 选择 被 pg_dump 包 括 或 排除 (Greg Sabino Mullane) 


pg_dump 现 在 支持 多 个 -n (A) 和 -t (R) 选项 ， 并 且 添 加 了 -n 和 -T 选项 排除 
对 象 。 另外 ， 这 些 开关 的 参数 现在 可 以 是 通配符 表达 式 ， 而 不 是 单个 对 象 名 ， 例 
如 -t 'foo*' ， 并 且 一 个 模式 可 以 是 -t 或 -7 开关 的 一 部 分 ， 比 


如 -t schema1.table1 o 


e 添加 pg _restore --no-data-for-failed-tables 选项 ， 如 果 表 创建 失败 则 阻止 加 载 数据 
(也 就 是 ， 该 表 早 已 存在 ) (Martin Pitt) 


e 添加 pg_restore 选 项 ， 在 单个 事务 中 运行 整个 会 话 (Simon) 
使 用 选项 -1 或 --single-transaction 。 
E.101.3.13. libpq 的 变化 


e 添加 PaencryptPassword() , 用 来 加 密 口令 (Tom) 


这 允许 口令 对 于 像 ALTER ROLE ... PASSWORD 这 样 的 命令 是 预先 加 密 发 送 的 。 
。 YDB poisthreadsafe() (Bruce) 
这 人 允许 应 用 查询 该 库 的 线程 安装 状态 。 


e 添加 PQdescribePrepared() 、 PQdescribePortal() FIFE KBE 时 数 返 回 关 于 以 前 预 各 好 的 
语句 和 打开 的 游标 的 信息 (Volkan YAZICI) 


e 多 许 LDAP 从 pg_service.conf 中 查找 (Laurenz Albe) 
e Sif ~/.pgpass 中 的 主机 名 匹配 缺 省 的 套 接 字 目录 (Bruce) 
一 个 空 的 主机 名 继续 匹配 任何 Unix 套 接 字 连接 ， 但 是 这 个 添加 允许 记录 特定 于 机 器 上 的 


几 个 主 进程 之 一 。 


E.101.3.14. ecpg 的 变化 
e iF show 将 它 的 结果 放 入 一 个 变量 中 (Joachim Wieland) 
e 添加 copy to stoout (Joachim Wieland) 
。 添加 回归 测试 (Joachim Wieland, Michael) 


。 主要 源 代码 清理 (Joachim Wieland, Michael) 


E.101.3.15. Windows iim A 
。 人 允许 MSVC 编 译 PostgreSQL 服 务 器 (Magnus, Hiroshi Saito) 
。 为 实用 命令 和 pg dump 添加 MSVC 支 持 (Hiroshi Saito) 
e 为 Windows 代 码 页 1253, 1254, 1255 和 1257 添加 支持 (Kris Jurka) 
。 在 启动 时 删除 权限 ， 这 样 服务 器 可 以 从 一 个 管理 员 账 号 启动 (Magnus) 
。 稳定 性 修复 (Qingqing Zhou, Magnus) 
。 添加 本 地 信号 灯 实 现 (Qingqing Zhou) 


以 前 的 代码 模仿 SysV 信 号 灯 。 


E.101.3.16. 源 代 码 的 变化 
e 添加 GIN (Generalized Inverted iNdex) 索引 访问 方法 (Teodor, Oleg) 


。 删除 R-tree 索引 (Tom) 


Rtree 已 经 使 用 GiST 重 新 实现 了 。 在 其 他 差异 中 ， 这 意味 着 rtree 索 引 现 在 支持 通过 预 写 
A (WAL) ARSE RE., 


减少 库 不 必要 的 连接 到 后 端 (Martijn van Oosterhout, Tom) 
添加 一 个 配置 标志 ， 人 允许 libedit 优 先 于 GNU readline (Bruce) 
使 用 配置 --with-libedit-preferred 。 

允许 安装 到 包含 空格 的 目录 (Peter) 

提高 重新 定位 安装 目录 的 能 力 (Tom) 


为 使 用 Solaris 编 译 器 的 Solaris x86_64 添加 支持 (Pierre Girard, Theo Schlossnagle, 
Bruce) 


添加 DTrace 支 持 (Robert Lor) 


添加 pc_verston_num ， 供 想 要 使 用 > 和 < 比较 测试 后 端 C 语 言 版 本 第 三 方 应 用 程序 使 用 


(Bruce) 

添加 xLoc_BLcksz ， 独 立 于 BLcksz (Mark Wong) 

添加 LWLock_STATS 定义 ， 报 告 锁定 活动 (Tom) 

为 未 知 的 configure 选 项 发 出 警告 (Martijn van Oosterhout) 

为 "plugin" 库 添加 服务 器 支持 ， 可 以 用 于 附加 任务 ， 上 比如 调试 和 性 能 测量 (Korry Douglas) 


这 由 两 个 功能 组 成 : 一 个 允许 单独 加 载 的 共享 库 沟通 的 "会 合 变量 "的 表 ， 和 一 个 允许 库 
被 加 载 到 特定 会 话 而 不 明确 与 客户 端 应 用 合作 的 新 的 配置 参数 
local_preload_libraries o 这 人 允许 外 部 插件 实现 像 PL/pgSQL 调 试 器 这 样 的 特性 。 


重 命名 现 有 的 配置 参数 preload_libraries 为 shared_preload_libraries (Tom) 
这 样 做 是 为 了 清楚 的 和 local_preload_libraries 比较 。 
添加 新 的 配置 参数 server_version_num (Greg Sabino Mullane) 


这 类 似 于 server_version ， 但 是 这 是 一 个 整数 ， 例 如 so200, 这 人 允许 应 用 更 容易 的 做 版 
本 检查 。 


添加 配置 参数 seq_page_cost (Tom) 
重新 实现 回归 测试 脚本 为 C 程 序 (Magnus, Tom) 
允许 可 加 载 的 模块 分 配 共享 内 存 和 轻 量 级 锁 (Marc Munro) 


添加 动态 加 载 库 的 自动 初始 化 和 终结 (Ralf Engelschall, Tom) 


如 果 库 定义 了 这 文 样 的 符号 ， 则 新 增 的 函数 _PG_init() 和 _PG_fini() 被 调用 。 因此 我 们 
不 再 需要 在 shared_preload_libraries 中 指定 一 个 初始 化 函数 ; 我 们 可 以 假设 库 使 用 
了 _p6_init() 约定 。 


e 添加 Pc_mopuLe_macic 标题 块 到 所 有 共享 的 对 象 文 件 (Martijn van Oosterhout) 
该 魔法 模块 阻止 可 加 载 对 象 文件 和 服务 器 间 的 版 本 错误 匹配 。 
。 为 AIX 添 加 共享 的 库 支持 (Laurenz Albe) 


。 新 增 XML 文 档 章 节 (Bruce) 


E.101.3.17. 贡献 包 的 变化 


。 主要 tsearch2 的 改进 (Oleg, Teodor) 
o 多 字 节 编码 支持 ， 包 括 UTF8 
o 查询 重 写 的 支持 
o 改进 排序 功能 
o 同义词 字典 支持 
o lspell 字 典 现在 识别 MySpell 格 式 ，OpenoOffice 使 用 它 。 
o GIN 支 持 
。 添加 包含 Pgadmin 管 理 功 能 的 adminpack 模 块 (Dave) 
这 些 画 数 提供 了 没有 在 缺 省 的 PostgreSQL 服务 器 中 出 现 的 额外 的 文件 系统 访问 例 程 。 
。 添加 sslinfo 模 块 (Victor Wagner) 
报告 当前 连接 的 SSL 证 书 的 信息 。 
e 添加 pgrowlocks 模 块 (Tatsuo) 
这 为 特定 的 表 显 示 了 行 锁 信息 。 
。 添加 hstore 模 块 (Oleg, Teodor) 
e 添加 isn 模 块 ， 蔡 换 isbn_issn (Jeremy Kronuz) 
这 个 新 的 实现 支持 EAN13、UPC、 ISBN (books), ISMN (music) 和 ISSN (serials). 
。 添加 来 引信 息 函 数 到 pgstattuple (ITAGAKI Takahiro, Satoshi Nagayasu) 
e 添加 pg_freespacemap 模 块 ， 显 示 自 由 空间 映射 信息 (Mark Kirkwood) 


e pgcrypto 现 在 拥有 所 有 计划 的 功能 (Marko Kreen) 


o 4€pgcryptoPaSiMath#, iL aH AMWAY eA. 
o 添加 在 OpenBSD 代 码 中 丢失 的 SHA224 算 法 。 


o 在 老 的 OpenSSL 上 为 SHA224/256/384/512 哈 希 激活 内 建 代 码 ， 让 这 些 算法 总 是 可 
用 。 


o 新 增 画 数 gen_random_bytes()， 返 回 密码 强壮 的 随机 性 。 对 于 生成 加 密 秘 钥 是 有 用 
的 。 
o 删除 digest_exists()、hmac_exists() 和 cipher_exists() 函 数 。 
改进 多 维 数据 集 模块 (Joshua Reich) 
新 增 的 函数 是 cube(float[]) 、 cube(float[], float[]) 和 cube_subset(cube, int4[]) o 
添加 异步 查询 能 力 到 dblink (Kai Londenberg, Joe Conway) 
为 数组 子 集 比 较 新 增 操作 符 ( @&gt; 、 &lt;@ 、 && ) (Tom) 


献 包 已 经 为 它们 的 数据 类 型 有 了 这 些 操作 符 ， 但 是 命名 并 不 一 致 。 我 们 现在 添加 
致命 名 的 数组 子 集 比 较 操作 符 到 内 核 代 码 和 所 有 拥有 这 样 功 能 的 贡献 包 。 (ZWE 
aes 加 有 效 ， 但 是 已 经 废弃 了 。) 


为 所 有 拥有 安装 脚本 的 贡献 包 添 加 卸载 脚本 (David, Josh Drake) 


E.102. 版 本 8.1.23 


发 布 日 期 : 2010-12-16 


这 个 版 本 包含 各 种 自 8.1.22 以 来 的 修复 。 关 于 8.1 主 版 本 的 新 特性 信息 ， 请 查看 Section 
E125; 


这 预计 是 8.1.X 系 列 的 最 后 一 个 PostgreSQL 版 本 。 推荐 用 户 尽快 更 新 到 一 个 新 的 版 本 分 支 。 


E.102.1. 迁移 到 版 本 8.1.23 


运行 8.1.X 的 用 户 不 需要 转 储 /恢复 。 不 过 ， 如 果 你 是 从 一 个 早 于 8.1.18 的 版 本 升级 而 来 ， 那么 
请 查看 8.1.18 的 版 本 声明 。 


E.102.2. 修改 列表 


e 强制 Linux 上 wal sync method 的 缺 省 为 fdatasync (Tom Lane, Marti Raudsepp) 


Linux 上 的 缺 省 实际 上 是 fdatasync 已 经 很 多 年 了 ， 但 是 最 近 的 内 核 改 变 导 致 PostgreSQL 
选择 了 open_datasync 。 这 个 选择 不 会 导致 任何 性 能 提升 ， 并 且 在 某 些 文件 系统 上 引起 了 
彻底 的 失败 ， 尤 其 是 ext4 和 data=journal 挂 载 选项 。 


e 当 起 始 检查 点 WAL 记 录 和 它 的 重 做 点 不 在 同一 个 WAL 段 时 ， 修 复 来 自 基础 备份 的 恢复 
(Jeff Davis) 


。 添加 在 IA64 £4 aE ARSE Hae HH BY Sz 4 (Tom Lane) 

IA64 (ARMA MBE. EM ME AH Kk Se PAB o 
e 添加 对 copyobject() 中 堆栈 浴 出 的 检查 (Tom Lane) 

某 些 的 代码 路 径 可 能 会 由 于 堆栈 浴 出 给 出 一 个 足够 复 末 的 查询 而 骨 溃 。 
。 修复 临时 GiST 索 引 中 的 页 分 裂 检测 (Heikki Linnakangas) 


在 一 个 临时 索引 上 有 一 个 "并 发 的 "页 分 裂 是 可 能 的 ， 如 果 例如 当 完 成 一 个 插入 时 正好 有 一 
个 开放 的 游标 扫描 索引 。GiST 未 能 检测 这 种 情况 ， 并 且 因 此 导致 游标 的 执行 继续 时 给 出 


UR AYE RR. 
e 当 正 在 ANALYzE 复杂 索引 表达 式 时 ， 避 免 内 存 泄露 (Tom Lane) 
。 确保 使 用 整 行 变 量 的 素 引 仍然 依赖 于 它 的 表 (Tom Lane) 


{R create index i ont (foo(t.*)) 这 这 样 的 索引 声明 在 它 的 表 被 删除 时 ， 将 不 会 自动 被 删 
除 。 


不 要 用 多 个 our 参数 "内 联 "一 个 SQL 画 数 (Tom Lane) 

这 避免 了 由 于 丢失 预期 的 结果 行 类 型 的 信息 而 引起 的 可 能 的 崩 汗 。 

修复 coALESCE() 表达 式 的 常量 合并 (Tom Lane) 

规划 器 有 时 尝试 评估 子 表 达 式 而 实际 上 是 不 可 能 的 ， 有 可 能 导致 意 想 不 到 的 错误 。 

为 InhRelation 结 点 添加 打印 功能 (Tom Lane) 

这 避免 了 启用 debug_print_parse 和 执行 某 些 类 型 的 查询 时 的 失败 。 

修复 点 到 水 平 线段 间距 离 的 不 正确 的 计算 (Tom Lane) 

这 个 错误 影响 几 个 不 同 的 几何 距离 测量 操作 符 。 

修复 PL/pgSQL 人 处理 "简单 的 "表达 式 ， 在 北 为 或 错误 恢复 的 情况 下 不 要 失败 (Tom Lane) 
修复 contrip/cube 的 GiST picksplit 算 法 中 的 错误 (Alexander Korotkov) 


这 会 导致 cube 字段 上 GiST 索 引 中 大 量 的 低 效 ， 和 不 完全 正确 的 答案 。 如 果 你 有 这 样 的 
一 个 索引 ， 考 虑 安装 这 个 更 新 之 后 REINDEX 它 。 


不 要 在 contrib/dblink 中 发 出 "标识 符 将 被 截断 "的 通知 ， 除 非 是 在 创建 新 的 连接 (Itagaki 
Takahiro) 


修复 contrib/pgcrypto 中 丢失 的 公共 键 上 潜在 的 内 核 转 储 (Marti Raudsepp) 
修复 contrib/xm12 的 XPath 查询 范 数 中 的 内 存 泄 露 (Tom Lane) 


更 新 时 区 数据 文件 到 tzdata 版 本 20100， 因 为 DST 规 律 在 Fii 和 Samoa 发 生 了 改变 ; 还 有 
xt Hong Kong 的 历史 纠正 。 


E.103. 版 本 8.1.22 


发 布 日 期 : 2010-10-04 


这 个 版 本 包含 各 种 自 8.1.21 以 来 的 修复 。 关 于 8.1 主 版 本 的 新 特性 信息 ， 请 查看 Section 
E125; 


PostgreSQL 社 区 将 在 2010 年 11 月 份 停止 对 8.1.X 版 本 系列 的 更 新 。 建 议 用 户 尽快 升级 到 新 的 
版 本 分 支 。 


E.103.1. 迁移 到 版 本 8.1.22 


运行 8.1.X 的 用 户 不 需要 转 储 /恢复 。 不 过 ， 如 果 你 是 从 一 个 早 于 8.1.18 的 版 本 升级 而 来 ， 那么 
请 查看 8.1.18 的 版 本 声明 。 


E.103.2. 修改 列表 


e 在 PL/Perl/ 和 PL/Tcl 中 为 每 个 调用 的 SQL 用 户 id 使 用 一 个 单独 的 解释 器 (Tom Lane) 


这 个 修改 阻止 了 破坏 稍 后 将 在 同一 个 会 话 中 在 另 一 个 SQL 用 户 身份 下 执行 的 Perl 或 Tcl 代 
码 引 起 的 安全 问题 (例如 ， 在 一 个 securtty DEFINER WAH) 。 大 多 数 脚本 语言 提供 很 
多 可 能 执行 的 方式 ， 上 比如 重新 定义 被 目标 函数 调用 的 标准 函数 或 操作 符 。 如 果 没 有 这 个 
修改 ， 任 何 拥有 Perl 或 Tcl 语 言 使 用 权限 的 SQL 用 户 基本 上 都 可 以 以 目标 男 数 所 有 者 的 
SQL 权 限 做 任何 事情 。 


这 个 修改 的 代价 是 Perl 和 Tc 函数 之 间 有 意 的 沟通 变 得 更 加 困难 。 为 了 提供 一 个 逃逸 出 
口 ，PL/PerlU 和 PL/TclU 函 数 继 续 每 个 会 话 只 使 用 一 个 解释 器 。 这 不 认为 是 一 个 安全 问 
题 ， 因 为 所 有 这 样 的 函数 都 在 数据 库 超 级 用 户 的 信任 级 别 执行 。 


有 可 能 第 三 方程 序 语言 声称 提供 受信 任 的 执行 有 相似 的 安全 问题 。 我 们 建议 为 了 安全 鉴 
定 的 目的 联系 任何 你 依赖 的 PL 的 作者 。 


我 们 感谢 Tim Bunce 指 出 这 个 问题 (CVE-2010-3433)。 


e 阻止 pg_get_expr() 中 可 能 的 骨 溃 ， 通 过 不 允许 它 被 一 个 参数 调用 ， 该 参数 不 是 它 打 算 使 
用 的 系统 目录 字段 之 一 (Heikki Linnakangas, Tom Lane) 


。 修复 "不 能 义理 未 规划 的 子 查询 "错误 (Tom Lane) 


这 在 子 查询 包含 一 个 连接 别名 引用 ， 该 引用 扩展 成 一 个 包含 另 一 个 子 查询 的 表达 式 时 发 
生 。 


阻止 show_session_authorization() 在 自动 清理 进程 中 崩溃 (Tom Lane) 
防止 函数 返回 行 类 型 不 是 完全 相同 的 记录 集 (Tom Lane) 
当 哈 希 一 个 通过 引用 传递 的 函数 结果 时 ， 修 复 可 能 的 失败 (Tao Ma, Tom Lane) 


当 在 写 入 锁 文件 时 ， 小 心 的 同步 它们 的 内 容 ( postmaster.pid 和 套 接 字 锁 文件 ) (Tom 
Lane) 


DOAN ASE EAE BARRA, BARMIBSSRAIMIXEHAA. m 
阻止 随后 的 尝试 成 功 的 启动 主 进程 ， 直 到 手动 移 除 锁 文件 。 


4 ACXID ESR AREFE Aa, 36622 Ja (Andres Freund, Robert Haas) 

QOS AR ll THERE ja], ABD RIGA 3S RNDR. 

修复 log_line_prefix BY %i 逃逸 ， 它 会 导致 在 后 台 和 启动 时 就 产生 垃圾 (Tom Lane) 
修复 启用 为 档 时 ， ALTER TABLE ... SET TABLESPACE 中 可 能 的 数据 损坏 (Jeff Davis) 


人 允许 CREATE DATABASE 和 ALTER DATABASE ... SET TABLESPACE 被 查询 取消 中 断 (Guillaume 


Lelarge) 


在 PL/Python 中 ， 防 止 pycobject_AsvoidPtr 和 pycobject_FromvoidPtr 产生 空 指针 结果 
(Peter Eisentraut) 


改善 contrib/dblink 对 包含 删除 字段 的 表 的 处 理 (Tom Lane) 
修复 contrib/dblink 中 "重复 的 连接 名 "错误 之 后 的 连接 泄露 (ltagaki Takahiro) 
修复 contrib/dblink , EMRE + Kk F62S 4G (Itagaki Takahiro) 


更 新 建立 的 基础 结构 和 文档 ， 以 反映 源 代 码 仓库 从 CVS 搬 到 了 Git (Magnus Hagander 
and others) 


更 新 时 区 数据 文件 到 tzdata 版 本 20101， 因 为 DST 规 律 在 Egypt 和 Paletine 发 生 了 改变 ; 还 
有 对 Finland 的 历史 纠正 。 


这 个 修改 还 为 两 个 Micronesian 时 区 添加 了 新 的 名 字 : Pacific/Chuuk 现 在 比 Pacific/Truk 更 
受 欢 迎 ( 并 且 首 选 的 缩写 是 CHUT， 不 是 TRUT) , Pacific/PohnpeittPacific/Ponape# 
受 


欢迎 。 


E.104. 版 本 8.1.21 


发 布 日 期 : 2010-05-17 


这 个 版 本 包含 各 种 自 8.1.20 以 来 的 修复 。 关 于 8.1 主 版 本 的 新 特性 信息 ， 请 查看 Section 
E.1255 


E.104.1. 迁移 到 版 本 8.1.21 


运行 8.1.X 的 用 户 不 需要 转 储 / 恢 复 。 不 过 ， 如 果 你 是 从 一 个 早 于 8.1.18 的 版 本 升级 而 来 ， 那么 
请 查看 8.1.18 的 版 本 声明 。 


E.104.2. 修改 列表 


。 使 用 一 个 开放 标记 应 用 到 整个 解释 器 强制 plperl 中 的 限制 ， 而 不 是 使 用 safe.pm (Tim 
Bunce, Andrew Dunstan) 


最 近 的 发 展 已 经 向 我 们 证 实 : 依赖 于 Safe ,pm 使 得 plperl F 可 信任 太 不 安全 了 。 这 个 修改 
也 一 起 删除 了 对 safe.pm 的 使 用 ， 为 了 支持 使 用 一 个 总 是 应 用 开放 代码 标记 的 单独 的 解 

释 器 。 这 个 修改 令 人 愉快 的 副作用 包括 : 现在 有 可 能 在 plperl 中 以 自然 的 方式 使 用 Per| 
的 strict 编译 ， 并 且 Perl 的 sa 和 so 变量 在 排序 例 程 中 像 预期 的 那样 工作 ， 并 且 郴 数 

的 编译 显著 的 更 快 了 。(CVE-2010-1169) 


e 阻止 PL/Tcl 执 行 来 自 pltcl_modules 的 不 受信 任 的 代码 (Tom) 


PL/Tcl 自 动 从 数据 库 表 中 加 载 Tcl 代 码 的 特性 可 能 会 被 特洛伊 木马 攻击 利用 ， 因 为 没有 限 
制 谁 可 以 创建 或 插入 到 那个 表 。 这 个 修改 禁用 了 该 特性 ， 除 非 pltcl_modules 是 被 超级 用 
PRE (不 过 ， 该 表 上 的 权限 是 不 检查 的 ， 所 以 实际 上 需要 较 小 安全 模块 的 表 的 安装 
仍然 可 以 赋予 合适 的 权限 到 受信 任 的 非 超级 用 户 。) 另外 ， 阻 止 加 载 代 码 到 不 受 限制 
的 "普通 "Tcl 解 释 器 中 ， 除 非 我 们 真 的 要 执行 一 个 pltclu BR. (CVE-2010-1170) 


。 不 要 人 允许 一 个 非特 权 用 户 重 置 超级 用 户 仅 有 的 参数 设置 (Alvaro) 


以 前 ， 如 果 一 个 非特 权 用 户 为 自己 运行 ALTER USER ... RESET ALL ， 或 为 他 拥有 的 数据 库 
运行 ALTER DATABASE ... RESET ALL ， 将 为 该 用 户 或 数据 库 删 除 所 有 特殊 的 参数 设置 ， 甚 
至 只 应 该 是 超级 用 户 可 改 的 参数 。 现 在 ， ALTER 将 只 删除 该 用 户 有 权限 修改 的 参数 。 


e 如 果 关 闭 发 生 在 context 添加 到 日 志 项 时 ， 避 免 后 端 关闭 期 间 可 能 的 崩溃 (Tom) 


在 某 些 情况 下 ， 上 下 文 打印 函数 将 失败 ， 因 为 当 它 要 输出 一 个 日 志 信 息 时 当前 事务 早已 
回 滚 。 


为 现代 的 Perl 版 本 更 新 pl/perl 的 ppport.h (Andrew) 

修复 pl/python 中 的 各 种 内 存 港 露 (Andreas Freund, Tom) 

当 扩 展 一 个 引用 本 身 的 变量 时 ， 阻 止 psql 中 的 无 限 递 (Tom) 

确保 contrib/pgstattuple 本 数 迅速 的 响应 取消 中 断 (Tatsuhito Kasahara) 

让 服务 器 启动 正确 的 处 理 shmget() 为 一 个 现 有 的 共享 内 存 段 返 回 enva 的 情况 (Tom) 


这 个 行为 在 BSD 驱 动 的 内 核 上 上， 包括 OS X， 已 经 被 观察 到 了 。 它 导致 一 个 完全 误导 的 启 
动 失败 抱怨 共享 内 存 请 求 尺 寸 太 大 。 


更 新 时 区 数据 文件 到 tzdata 版 本 2010j， 因 为 DST 规 律 在 Argentina、Australian 
Antarctic、Bangladesh、Mexico、Morocco、Pakistan、Palestine、Russia、Syria、 
Tunisia 已 经 发 生 了 改变 ; 还 为 Taiwan 做 了 历史 纠正 。 


E.105. 版 本 8.1.20 


发 布 日 期 : 2010-03-15 


这 个 版 本 包含 各 种 自 8.1.19 以 来 的 修复 。 关 于 8.1 主 版 本 的 新 特性 信息 ， 请 查看 Section 
E.1255 


E.105.1. 迁移 到 版 本 8.1.20 


运行 8.1.X 的 用 户 不 需要 转 储 /恢复 。 不 过 ， 如 果 你 是 从 一 个 早 于 8.1.18 的 版 本 升级 而 来 ， 那么 
查看 8.1.18 的 版 本 声明 。 


iB 
请 


E.105.2. 修改 列表 
e。 添加 新 的 配置 参数 ssl_renegotiation_limit ， 控 制 多 久 为 一 个 SSL 连 接 做 一 次 会 话 秘 钥 
协商 (Magnus) 


该 参数 可 以 设置 为 0 来 完全 禁止 重新 协商 ， 如 果 使 用 了 一 个 破碎 的 SSL 库 可 能 需要 这 样 。 
特别 的 ， 一 些 供应 商 为 CVE-2009-3555 做 了 紧急 补丁 ， 导 致 重新 协商 的 党 试 失败 。 


。 修复 党 试 从 一 个 子 事务 启动 失败 中 恢复 时 可 能 的 骨 溃 (Tom) 
。 修复 与 使 用 保存 点 和 客户 端 编码 与 服务 器 编码 不 同 有 关 的 服务 器 内 存 泄露 (Tom) 
e 让 substring() 的 bit 类 型 认为 任何 负 的 长 度 意 为 "所 有 剩余 的 字符 串 " (Tom) 


以 前 的 编码 只 对 待 -1 以 这 个 方式 ， 并 且 会 为 其 他 负 值 产 生 一 个 无 效 的 结果 值 ， 可 能 导致 月 
3% (CVE-2010-0442)。 


修复 整数 到 位 字符 串 的 转换 ， 当 输出 位 宽度 比 给 定 的 整数 宽 时 (不 同 于 8 位 的 倍数 ) ， 正 
确 的 处 理 第 一 个 部 分 的 字 节 (Tom) 


修复 某 些 情况 下 病理 上 慢 的 正则 表达 式 匹配 (Tom) 


修复 后 端 历史 文件 中 的 stop wat Location 入 口 ， 当 结束 位 置 正好 在 一 个 段 的 边界 时 报告 
下 一 个 WAL 段 的 名 字 (Itagaki Takahiro) 


修复 更 多 情况 下 临时 文件 的 泄露 (Heikki) 


这 纠正 了 一 个 在 以 前 的 小 版 本 中 引入 的 问题 。 失 败 的 一 个 案例 是 : 当 plpgsqIl 函 数 返 回 集 
在 另 一 个 汞 数 的 异常 处 理 中 调用 时 。 


当 读 取 pg_hba.cont 和 相关 的 文件 时 ， 如 果 @ 出 现在 双 引 号 标记 的 内 部 ， 不 要 
将 @something 看 做 文件 包含 请 求 ; 另外 ， 永 远 不 要 将 @ 本 身 看 做 一 个 文件 包含 请 求 
(Tom) 


这 阻止 了 角色 或 数据 库 名 字 以 @ 开始 时 的 不 规律 行为 。 如 果 你 需要 包含 一 个 路 径 名 包含 
空格 的 文件 ， 你 可 以 这 样 做 ， 但 是 你 必须 写 @"/path to/file" 而 不 是 让 双 引 号 包含 整个 
结构 。 


如 果 一 个 路 径 以 pg_hba.conf 和 相关 文件 中 的 包含 目标 命名 ， 那 么 阻止 某 些 平台 上 的 无 限 
循环 (Tom) 


修复 psq| 的 numericlocale 选项 ， 不 要 格式 化 它 不 应 该 以 latex 和 troff 输 出 格式 的 字符 串 
(Heikki) 


修复 plpgsql 在 复合 字段 设置 为 NULL 时 的 失败 (Tom) 

在 PL/Python 中 添加 volatile 标记 ， 以 避免 可 能 的 编译 器 特定 不 良 行 为 (Zdenek Kotala) 
确保 PL/Tcl 完 全 初始 化 Tcl 解 释 器 (Tom) 

这 个 足 忽 唯 一 已 知 的 症状 是 : 如 果 使 用 Tcl 8.5 或 更 新 ，Tcl clock 命令 错误 行为 。 


当 太 多 的 关键 字段 指定 到 一 个 gplink_build_sql * Wi#tat, BALE contrib/dblink 中 的 崩 
溃 (Rushabh Lathia, Joe Conway) 


修复 粗心 的 内 存 管理 引起 的 contrib/xm12 中 的 各 种 崩溃 (Tom) 


更 新 时 区 数据 文件 到 tzdata 版 本 2010e， 因 为 DST 规 律 在 Bangladesh、Chile、Fiji、 
Mexico、Paraguay、Samoa 发 生 了 改变 。 


E.106. 版 本 8.1.19 


发 布 日 期 : 2009-12-14 


这 个 版 本 包含 各 种 自 8.1.18 以 来 的 修复 。 关 于 8.1 主 版 本 的 新 特性 信息 ， 请 查看 Section 
E125; 


E.106.1. 迁移 到 版 本 8.1.19 


运行 8.1.X 的 用 户 不 需要 转 储 / 恢 复 。 不 过 ， 如 果 你 是 从 一 个 早 于 8.1.18 的 版 本 升级 而 来 ， 那么 
查看 8.1.18 的 版 本 声明 。 


iB 
请 


E.106.2. 修改 列表 


防御 由 索引 本 数 更 改 会 话 本 地 状态 引起 的 间接 安全 威胁 (Gurjeet Singh, Tom) 


这 个 修改 阻止 了 据 称 是 不 变 的 索引 函数 可 能 破坏 一 个 超级 用 户 的 会 话 (CVE-2009- 
4136). 


拒绝 SSL 认 证 在 公共 名 (CN) 字段 包含 一 个 能 入 的 空 字 节 (Magnus) 


这 阻止 了 SSL 验 证 期 间 无 意识 的 匹配 证 书 到 服务 器 或 客户 端 名 字 (CVE-2009-4034)。 


修复 后 端 启动 缓存 初始 化 期 间 可 能 的 崩溃 (Tom) 
。 阻止 信号 在 不 安全 的 时 间 中 断 vacuum (Alvaro) 


这 个 修改 阻止 了 vacuum FuLL 在 它 早已 提交 它 的 元 组 动作 之 后 取消 时 的 PANIC， 还 有 如 果 
计划 vacuum 在 截断 表 之 后 中 断 的 瞬 态 错误 。 


修复 由 于 哈 希 表 尺寸 计算 中 整数 浴 出 而 引起 的 可 能 的 骨 溃 (Tom) 
这 在 规划 器 估算 哈 希 连接 的 结果 非常 大 时 会 发 生 。 


修复 inet / cidr 比较 中 非常 罕见 的 崩溃 (Chris Mikkelson) 


确保 被 预备 事务 持 有 的 共享 的 元 组 级 别 锁 不 被 忽略 (Heikki) 


修复 过 早 删除 在 一 个 子 事务 中 访问 的 被 游标 使 用 的 临时 文件 (Heikki) 


修复 PAM 口 邻 义理， 使 其 更 加 稳健 (Tom) 


已 知 以 前 的 代码 未 能 组 合 Linux pam_krbs PAM 模 板 和 Microsoft Active Directory 作为 域 
控制 器 。 它 可 能 在 其 他 地 方 也 有 问题 ， 因 为 它 对 于 要 传递 哪个 PAM 堆 栈 参 数 做 了 不 公正 
的 假设 。 


修复 CREATE OR REPLACE FUNCTION 期 间 的 所 有 权 依 赖 关系 的 处 理 (Tom) 


当 通 过 一 个 设置 /返回 PL/Perl 汞 数 返 回 时 ， 确 保 Perl 数 组 正确 的 转换 到 PostgreSQL 数 组 
(Andrew Dunstan, Abhijit Menon-Sen) 


这 对 于 非 设 置 返回 范 数 来 说 早已 正确 的 工作 了 。 

修复 PL/Python 异 常 你 理 中 罕见 的 崩溃 (Peter) 

确保 psql 的 flex 模 块 是 用 正确 的 系统 头 定义 编译 的 (Tom) 

这 修复 了 --enable-largefile 导致 在 生成 的 代码 中 不 兼容 的 改变 的 平台 上 的 建立 失败 。 


让 主 进程 忽略 任何 在 连接 请 求 包 中 的 application name 参数 ， 以 改善 与 未 来 libpq 版 本 的 
兼容 性 (Tom) 


更 新 时 区 数据 文件 到 tzdata 版 本 2009s， 因为 DST 规 律 已 经 在 Antarctica、Argentina、 
Bangladesh, Fiji, Novokuznetsk, Pakistan、Palestine、Samoa、Syria 发 生 了 改变 ; 
还 为 Hong Kong 做 了 历史 纠正 。 


E.107. 版 本 8.1.18 


这 个 


发 布 日 期 : 2009-09-09 


版 本 包含 各 种 自 8.1.17 以 来 的 修复 。 关 于 8.1 主 版 本 的 新 特性 信息 ， 请 查看 Section 


E.1255 


E.107.1. 迁移 到 版 本 8.1.18 


运行 8.1.X 的 用 户 不 需要 转 储 /恢复 。 不 过 ， 如 果 你 在 interval 字段 上 有 任何 哈 希 索引 ， 你 必 
须 在 升级 到 8.1.18 之 后 REINDEX 它们 。 另外 ， 如 果 你 是 从 一 个 早 于 8.1.15 的 版 本 升级 而 来 ， 那 
么 请 查看 8.1.15 的 版 本 声明 。 


E.107.2. 修改 列表 


不 允许 RESET ROLE 和 RESET SESSION AUTHORIZATION 在 安全 定义 图 数 内 部 (Tom, Heikki) 


这 包含 了 在 以 前 的 补丁 中 丢失 的 一 个 情况 ， 不 允许 SET ROLE 
和 SET SESSION AUTHORIZATION 在 安全 定义 函数 内 部 。 (请 参阅 CVE-2007-6600) 


修复 出 现在 一 个 外 部 级 别 聚集 画 数 的 参数 中 的 子 查询 的 处 理 (Tom) 
为 数据 类 型 interval 修复 哈 希 计算 (Tom) 


这 纠正 了 哈 希 连接 在 间隔 值 上 的 错误 结果 。 也 改变 了 哈 希 索引 在 间隔 字段 上 的 内 容 。 如 
果 你 有 任何 这 样 的 索引 ， 你 必须 在 更 新 之 后 REINDEX 它们 。 


JẸ to_char(..., 'TH') 看 做 大 写 的 带 有 'HH' / 'HH12' 的 序号 前 级 (Heikki) 
以 前 是 作为 'th' OE) 处 理 的 。 


修复 x 超过 2 百 万 并 且 正 在 使 用 整数 日 期 时 间 时 ， INTERVAL `x ms' 的 渝 出 (Alex 
Hunsaker) 


修复 点 和 线段 之 间距 离 的 计算 (Tom) 
这 导致 一 些 几何 操作 符 不 正确 的 结果 。 


修复 money 数据 类 型 在 货币 数量 没有 小 数 点 的 环境 (上 比如 日 本 ) 下 工作 (Itagaki 
Takahiro) 


适当 的 圆 整 像 66:12:57.9999999999999999999999999999 这 样 的 日 期 时 间 输 入 (Tom) 


修复 GiST R-tree 操作 符 类 中 可 惟 的 页 分 裂 点 的 选择 (Teodor) 


修复 plperl 初 始 化 中 的 可 移植 性 问题 (Andrew Dunstan) 

修复 pg_ctl， 如 果 postgresql.conf 为 空 时 ， 不 要 进入 无 限 循环 (Jeff Davis) 

修复 contrib/xml2 的 xslt_process() ， 正确 的 义理 参数 的 最 大 数量 (20) (Tom) 
改善 iibpq 代 码 的 和 鲁 棒 性 ， 从 copy From sTDIN 期 间 的 错误 中 恢复 (Tom) 

当 两 个 库 都 安装 了 时 ， 避 免 包含 冲 突 的 readline 和 editline 头 文件 (Zdenek Kotala) 


更 新 时 区 数据 文件 到 tzdata 版 本 20091， 因 为 DST 规 律 在 Bangladesh、Egypt, Jordan、 
Pakistan, Argentina/San_Luis, Cuba, Jordan( 只 是 历史 纠正 )、Mauritius、Morocco、 
Palestine, Syria, Tunisia. 


E.108. 版 本 8.1.17 


发 布 日 期 : 2009-03-16 


这 个 版 本 包含 各 种 自 8.1.16 以 来 的 修复 。 关 于 8.1 主 版 本 的 新 特性 信息 ， 请 查看 Section 
E125; 


E.108.1. 迁移 到 版 本 8.1.17 


运行 8.1.X 的 用 户 不 需要 转 储 /恢复 。 不 过 ， 如 果 你 是 从 一 个 早 于 8.1.15 的 版 本 升级 而 来 ， 那 么 
查看 8.1.15 的 版 本 声明 。 


iB 
请 


E.108.2. 修改 列表 


当 编码 转换 失败 时 ， 阻 止 错误 递归 骨 溃 (Tom) 


这 个 修改 扩展 了 在 最 后 两 个 小 版 本 中 对 相关 失败 情节 的 修复 。 以 前 的 修复 严格 限制 在 原 
始 的 问题 报告 ， 但 是 我 们 现在 意识 到 被 编码 转换 画 数 抛 出 的 任何 错误 都 潜在 的 导致 在 党 
试 报告 该 错误 时 无 限 的 递归 。 因此 如 果 我 们 发 现 我 们 已 经 进入 了 一 个 递归 错误 报告 的 情 
ah, 解决 方法 是 禁用 翻译 和 编码 转换 ， 并 且 报 告 任何 错误 消息 的 纯 ASCII 格 式 。 (CVE- 
2009-0922) 


e 不 允许 CREATE CONVERSION ¥ $KE Bp He EH BN (Be FA Hh iz AY 4 23 (Heikki) 


这 阻止 了 编码 转换 失败 的 一 种 可 能 的 情况 。 以 前 的 修改 是 防范 了 相同 区 域 中 的 其 他 类 型 
的 失败 。 


修复 给 定 to_char() 的 格式 化 代码 不 适合 数据 参数 的 类 型 时 的 内 核 转 储 (Tom) 


修复 case wHEN 带 有 隐 式 强制 时 的 反 编译 (Tom) 


在 党 试 检 查 或 转 储 一 个 视图 时 ， 这 个 错误 在 启用 断言 的 建立 中 会 导致 断言 失败 ， 或 在 其 
他 情况 下 的 一 个 "意外 的 CASE WHEN 子 句 "错误 消息 。 


修复 TOAST 表 行 类 型 的 所 有 者 的 可 能 的 错误 分 配 (Tom) 


如 果 cluster 或 者 ALTER TABLE 的 一 个 重 写 变 体 被 表 所 有 者 之 外 的 其 他 人 执行 ， 该 表 的 
TOAST 表 的 pg type 项 将 被 标记 为 属于 这 个 其 他 人 而 结束 。 这 没有 造成 直接 问题 ， 因 为 
TOAST 行 类 型 的 权限 不 被 任何 普通 数据 库 操作 检查 。 不 过 ， 如 果 一 个 人 稍 后 党 试 删 除 发 
出 该 命令 的 角色 (在 8.1 或 8.2 中 ) ， 它 会 导致 意外 的 失败 ， 或 者 pg_dump 稍 后 也 这 样 做 
时 ， 导 致 "数据 类 型 的 所 有 者 看 起 来 无 效 " 的 警告 (在 8.3 中 ) 。 


。 在 块 退出 时 完全 清理 PL/pgSQL 的 错误 状态 变量 (Ashesh Vashi and Dave Page) 


这 对 于 PL/pgSQL 本 身 来 说 不 是 一 个 问题 ， 但 是 当 检测 一 个 画 数 的 状态 时 ， 政 忽 会 导致 
PL/pgSQL 调 试 器 骨 溃 。 


e 添加 must (Mauritius Island Summer Time) 到 已 知 时 区 缩写 的 缺 省 列表 (Xavier Bugaud) 


E.109. 版 本 8.1.16 


发 布 日 期 : 2009-02-02 


这 个 版 本 包含 各 种 自 8.1.15 以 来 的 修复 。 关 于 8.1 主 版 本 的 新 特性 信息 ， 请 查看 Section 
E.125。 


E.109.1. 迁移 到 版 本 8.1.16 


运行 8.1.X 的 用 户 不 需要 转 储 /恢复 。 不 过 ， 如 果 你 是 从 一 个 早 于 8.1.15 的 版 本 升级 而 来 ， 那 么 
请 查看 8.1.15 的 版 本 声明 。 


E.109.2. 修改 列表 


。 修复 自动 清理 中 的 月 溃 (Alvaro) 


崩溃 只 在 为 反 向 事务 包括 的 目的 清理 整个 数据 库 时 骨 溃 ， 这 意味 着 它 发 生 的 不 频繁 和 难 
a 


e 改善 neadline() WAR URLĖJ & E (Teodor) 


e 改善 headline() KUPE K 4r HAY EB (Teodor) 


HO SR 2s #5 ik E FA RRI AA A E Ea 2 xt EY, ARA BELE ERS Ae BK 
错误 转换 (Tom, Heikki) 


避免 vacuum 中 小 表 的 不 必要 的 锁 (Heikki) 


确保 可 持 有 游标 的 内 容 不 依赖 于 TOAST 表 的 内 容 (Tom) 


以 前 ， 游 标 结果 中 大 的 字段 值 可 能 被 表示 为 TOAST 指 针 ， 如 果 引 用 表 在 该 游标 被 读 取 之 
前 被 删除 ， 或 者 如 果 大 的 值 被 删除 然后 清理 了 ， 那 么 这 就 会 失败 。 这 在 普通 游标 中 不 会 
RE, 但 是 会 发 生 在 保留 了 过 去 的 创建 事务 的 游标 中 。 


e 修复 contrib/tsearch2 的 get_covers() 函数 中 未 初始 化 的 变量 (Teodor) 


修复 不 能 为 PL/Perl 获 取 连 接 信息 时 configure 脚 本 适当 的 报告 失败 (Andrew) 


让 所 有 文档 适当 的 引用 pgsql-bugs 和 /或 pgsql-hackers , 替代 现在 退役 
的 pgsql-ports 和 pgsql-patches 邮件 列表 (Tom) 


更 新 时 区 数据 文件 到 tzdata 版 本 2009a (因为 Kathmandu 和 在 Switzerland、Cuba 历史 的 
DST 纠 正 ) 


E.110. 版 本 8.1.5 


这 个 


发 布 日 期 : 2008-11-03 


版 本 包含 各 种 自 8.1.14 以 来 的 修复 。 关 于 8.1 主 版 本 的 新 特性 信息 ， 请 查看 Section 


E.1255 


E.110.1. 迁移 到 版 本 8.1.15 


运行 8.1.X 的 用 户 不 需要 转 储 /恢复 。 不 过 ， 如 果 你 是 从 一 个 早 于 8.1.2 的 版 本 升级 而 来 ， 那么 
请 查看 8.1.2 的 版 本 声明 。 另外， 如 果 你 正在 运行 一 个 以 前 的 8.1.X 版 本 ， 那么 建议 在 升级 之 
后 REINDEX 所 有 GIST 素 引 。 


E.110.2. 修改 列表 


修复 由 于 在 删除 之 后 标记 错误 的 索引 项 "dead" 引 起 的 GiST 素 引 朋 渍 (Teodor) 
这 会 导致 素 引 搜索 未 能 找到 它们 应 该 能 找到 的 行 。 损 坏 的 索引 可 以 使 用 REINDEX 修复 。 
修复 客户 端 编 码 不 能 表示 本 地 化 错误 消息 时 的 后 端 崩溃 (Tom) 


我 们 以 前 处 理 过 相似 的 问题 ， 但 是 如 果 "character has no equivalent" 消息 本 身 不 能 被 转 
换 ， 那 么 它 仍 将 会 失败 。 修 复 是 在 我 们 检测 到 这 样 一 个 情况 时 ， 禁用 本 地 化 和 发 送 纯 
ASCII 错 误 消息 。 


当 深 层 馈 套 的 函数 在 一 个 触发 器 中 调用 时 ， 修 复 可 能 的 崩 汗 (Tom) 


当 一 个 子 sELECT 出 现在 FROM 、 多 行 values RE RETURNING 列表 中 的 函数 调用 中 时 ， 
修复 规则 查询 的 错误 膨胀 (Tom) 


这 个 问题 的 通常 症状 是 一 个 "未 识别 的 节点 类 型 "错误 。 
当 新 定义 的 PL/pgSQL 鲁 发 器 函数 被 作为 普通 函数 调用 时 ， 确 保 报告 一 个 错误 (Tom) 


当 使 用 ALTER SET TABLESPACE 移动 一 个 表 到 另 一 个 表 空 间 时 ， 阻止 可 能 
的 relfilenode 编号 冲突 (Heikki) 


该 命令 尝试 重新 使 用 现 有 的 文件 名 字 ， 而 不 是 选择 一 个 已 知 在 目标 目录 中 没有 使 用 的 文 
件 名 。 


当 单 个 查询 条 目 匹 配 文本 的 第 一 个 单词 时 ， 修 复 不 正确 的 tsearch2 标 题 生 成 (Sushant 
Sinha) 


当 在 --enable-integer-datetimes 建立 中 使 用 了 一 个 非 1SO 日 期 类 型 时 ， 修复 间 隔 值 中 分 
数秒 的 不 正确 的 显示 (Ron Mayer) 


当 传 递 的 元 组 和 元 组 描述 符 有 不 同 的 字段 编号 时 ， 确 保 sPI_getvalue 
和 sPI_getbinval 正确 的 行为 (Tom) 


当 表 添 加 或 删除 了 行 时 ， 这 个 情况 是 正常 的 ， 但 是 这 两 个 图 数 没有 适当 的 处 理 它 。 唯一 
可 能 的 后 果 是 一 个 不 正确 的 错误 指示 。 


修复 ecpg 对 create ROLE 的 解析 (Michael) 
修复 pg_ctl restart 最 近 的 损坏 (Tom) 


更 新 时 区 数据 文件 到 tzdata 版 本 2008i (因为 DST 规 律 在 Argentina、Brazil, Mauritius, 
Syria 发 生 了 改变 ) 


E.111. 版 本 8.1.14 


发 布 日 期 : 2008-09-22 


这 个 版 本 包含 各 种 自 8.1.13 以 来 的 修复 。 关 于 8.1 主 版 本 的 新 特性 信息 ， 请 查看 Section 
E.1255 


E.111.1. 迁移 到 版 本 8.1.14 


运行 8.1.X 的 用 户 不 需要 转 储 /恢复 。 不 过 ， 如 果 你 是 从 一 个 早 于 8.1.2 的 版 本 升级 而 来 ， 那么 
查看 8.1.2 的 版 本 声明 。 


iB 
请 


E.111.2. 修改 列表 


。 放宽 本 地 锁 计 数 器 从 32 到 64 位 (Tom) 
这 个 响应 报告 了 计数 器 会 在 足够 长 的 事务 中 渝 出 ， 导 致意 外 的 " 锁 已 被 持 有 "错误 。 
。 修复 GiST 索 引 扫描 期 间 可 能 的 元 组 重复 输出 (Teodor) 


。 在 执行 器 启动 时 添加 检查 ， 确 保 Insert 或 UPDATE 产生 的 元 组 将 匹配 目标 表 的 当前 行 类 
型 (Tom) 


ALTER COLUMN TYPE ， 跟 着 以 前 缓存 的 计划 的 重新 使 用 ， 会 产生 这 种 类 型 的 情形 。 检 查 保 
扩 了 可 能 接着 发 生 的 数据 损坏 和 /或 骨 溃 。 


e 修复 AT TIME zoNE ， 首 先 党 试 解释 他 的 时 区 参数 为 时 区 缩写 ， 如 果 失 败 ， 那 么 党 试 它 为 
完整 时 区 名 字 ， 而 不 是 和 以 前 一 样 的 其 他 绕 开 方式 (Tom) 


时 间 惟 输入 画 数 总 是 以 这 个 顺序 解决 模糊 的 时 区 名 字 。 让 AT TIME zone 也 这 样 做 提高 
一 致 性 ， 并 且 修 复 了 一 个 在 8.1 中 引进 的 兼容 性 bug : 在 模糊 情况 下 ， 我 们 现在 的 行为 和 
8.0 及 以 前 的 行为 一 致 ， 因为 更 老 版 本 的 AT time zone 只 接受 缩写 。 


。 修复 日 期 时 间 输入 画 数 ， 以 在 64 位 平台 上 运行 时 能 正确 的 检测 到 整数 浴 出 (Tom) 
。 提高 写 入 非常 长 的 日 志 消 息 到 系统 日 志 的 性 能 (Tom) 

e 修复 SELECT DISTINCT on 查询 上 的 游标 向 后 扫描 中 的 错误 (Tom) 

。 修复 拱 套 子 查询 表达 式 的 规划 器 bug (Tom) 


如 果 外 侧 子 查询 与 父 查 询 没 有 直接 依赖 关系 ， 但 是 内 侧 子 查询 有 ， 那么 外 侧 的 值 可 能 不 
会 为 新 的 父 查询 行 重新 计算 。 


修复 规划 器 估计 croup BY 表达 式 产 生 的 布尔 结果 总 是 在 两 个 组 中 ， 不 管 表 达 式 的 内 容 是 
什么 (Tom) 


对 于 某 些 布尔 测试 像 col rs nuil 来 说 ， 这 比 普通 croup BY 估计 明显 更 加 准确 。 


当 ror 循环 的 目标 变量 是 一 个 包含 复合 类 型 字段 的 记录 时 ， 修复 PL/pgSQL 以 不 失败 
(Tom) 


修复 PL/Tcl 以 与 Tcl 8.5 正 确 的 行为 ， 并 且 更 加 小 心 发 送 到 或 者 来 自 Tcl 的 数据 的 编码 (Tom) 
修复 PL/Python 以 与 Python 2.5 一 起 工作 

这 是 一 个 8.2 开 发 周期 期 间 所 做 的 修复 的 移植 。 

改善 未 能 发 送 一 个 SQL 命令 之 后 ，pg_dump 和 pg_restore 的 错误 报告 (Tom) 

修复 pg_ctl 跨 过 一 个 restart 时 ， 适当 的 保存 主 进程 命令 行 参 数 (Bruce) 


更 新 时 区 数据 文件 的 到 tzdata 版 本 2008f (因为 DST 规 律 在 Argentina、Bahamas、 
Brazil、 Mauritius, Morocco、Pakistan、 Palestine 和 Paraguay 发 生 了 改变 ) 


E.112. 版 本 8.1.13 


发 布 日 期 : 2008-06-12 


这 个 版 本 包含 一 个 严重 的 和 一 个 小 的 针对 8.1.22 的 修复 。 关 于 8.1 主 版 本 的 新 特性 信息 ， 请 查 
看 Section E.125。 


E.112.1. 迁移 到 版 本 8.1.13 


运行 8.1.X 的 用 户 不 需要 转 储 /恢复 。 不 过 ， 如 果 你 是 从 一 个 早 于 8.1.2 的 版 本 升级 而 来 ， 那么 
查看 8.1.2 的 版 本 声明 。 


iB 
请 


E.112.2. 修改 列表 


e 让 pg_get_ruledef() 给 负 的 常量 加 上 括号 (Tom) 


在 该 修复 之 前 ， 在 视图 或 规则 中 的 负 的 常量 可 能 被 作为 ， 例 如 -42::integer 转 储 ， 而 这 
是 不 正确 的 : 它 应 该 为 (-42)::integer ， 因 为 操作 符 优 先 级 规则 。 通常 这 会 导致 小 的 差 
异 ， 但 是 它 会 与 另外 一 个 最 近 的 补丁 相互 作用 导致 PostgreSQL 拒绝 一 个 有 效 

的 SELECT DISTINCT 视图 查询 。 因 为 这 会 导致 pg_dump 输出 不 能 加 载 ， 所 以 它 被 看 做 一 
个 高 优先 级 修复 。 实 际 上 转 储 输出 不 正确 的 发 行 版 本 是 8.3.1 和 8.2.7。 


e 让 ALTER AGGREGATE ... OWNER TO 更 新 pg_shdepend (Tom) 


如 果 聚 集 稍 后 包含 在 一 个 prop owNED 或 REASSIGN OWNED 操作 中 ， 那么 这 个 疏忽 会 导致 问 


是 。 


E.113. 版 本 8.1.12 


发 布 日 期 : 从 未 发 布 


这 个 版 本 包含 各 种 自 8.1.11 以 来 的 修复 。 关 于 8.1 主 版 本 的 新 特性 信息 ， 请 查看 Section 
E125; 


E.113.1. 迁移 到 版 本 8.1.12 


运行 8.1.X 的 用 户 不 需要 转 储 /恢复 。 不 过 ， 如 果 你 是 从 一 个 早 于 8.1.2 的 版 本 升级 而 来 ， 那么 
查看 8.1.2 的 版 本 声明 。 


iB 
请 


E.113.2. 修改 列表 
e 修复 ALTER TABLE ADD COLUMN ... PRIMARY KEY ， 这 样 新 的 字段 正确 的 检查 是 否 它 被 初始 


化 为 所 有 都 是 非 空 (Brendan Jurd) 
以 前 的 版 本 完全 忽略 了 检查 这 个 要 求 。 
。 修复 从 多 个 继承 自 同一 个 祖先 的 约束 的 父 关 系 中 继承 "相同 的 "约束 时 ， 可 能 


的 cREATE TABLE 失败 (Tom) 


。 修复 ISO-8859-5 和 其 他 编码 之 间 的 转换 ， 以 处 理 Cyrillic "Yo" 字 符 ( 。 fle 带 有 两 个 名 
点 ) (Sergey Burladyan) 


。 修复 一 个 新 的 日 期 类 型 输入 函数 ， 人 允许 未 使 用 的 字 节 在 它们 的 结果 中 包含 未 初始 化 的 、 
不 可 预测 的 值 (Tom) 


这 会 导致 两 个 表面 上 相同 的 文字 值 不 被 看 做 相等 的 失败 ， 导致 解析 器 抱怨 不 匹配 


的 oRDER BY 和 DISTINCT 表达 式 。 


。 修复 正则 表达 式 子 串 匹 配 中 的 一 个 极端 情况 ( substring(``_string from _pattern_ )) 
(Tom) 


当 有 一 个 到 模式 的 完全 匹配 ， 但 是 用 户 已 经 指定 了 一 个 加 上 括号 的 子 表 达 式 ， HEAT 
表达 式 没有 获得 一 个 匹配 时 会 发 生 这 个 问题 。 一 个 例子 是 

substring('foo' from 'foo(bar)?') o 这 个 应 该 返回 NULL， 因 为 (bar) 没有 匹配 ， 但 是 
它 错误 的 返回 了 整个 模式 匹配 (也 就 是 foo ) 。 


。 更 新 时 区 数据 文件 到 tzdata 版 本 2008c (因为 DST 规 律 在 Morocco、lraq、Choibalsan、 
Pakistan, Syria, Cuba, Argentina/San_Luis 和 Chile 发 生 了 改变 ) 


修复 ecpg 的 pctyPestimestamp_sub() 图 数 中 的 不 正确 的 结果 (Michael) 


当 输 入 查询 返回 一 个 NULL 值 时 ， 修 复 contrib/xm12 的 xpath_table() 加 数 中 的 内 核 转 储 
(Tom) 


修复 contrib/xm12 的 makefile， 不 要 覆盖 crass (Tom) 
修复 vatumGetBool 宏 ， 不 要 在 使 用 gcc 4.3 时 失败 (Tom) 


这 个 问题 影响 返回 布尔 的 "老式 的 " (V0) CHR, 这 个 修复 在 8.3 中 已 经 有 了 ， 但 是 后 向 修 
复 它 的 需要 在 当时 没有 意识 到 。 


修复 长 期 存在 的 Listen / NoTIFY SARE (Tom) 


在 罕见 的 情况 下 ， 刚 刚 执 行 了 LISTEN 的 会 话 可 能 不 会 获得 一 个 通知 ， 即使 预期 应 该 有 一 
个 通知 ， 因 为 并 发 事务 执行 NoTIFY 是 在 提交 之 后 能 观察 到 。 


该 修复 的 一 个 副作用 是 一 个 刚刚 执行 了 暂 未 提交 的 LIsTEN 命令 的 事务 将 不 会 看 到 
该 LISTEN 的 pg_listener 中 的 任何 行 ， 而 它 应 该 能 看 到 的 ; 以 前 它 是 能 够 看 到 的 。 这 个 
行为 不 管 怎样 都 没有 记录 过 ， 但 是 有 可 能 一 些 应 用 依赖 于 老 的 行为 。 


不 允许 LISTEN 和 UNLISTEN 在 一 个 准备 事务 中 (Tom) 


这 在 以 前 是 允许 的 ， 但 是 党 斌 这 样 做 会 有 各 种 不 愉快 的 后 果 ， 尤其 是 只 要 UNLISTEN 保持 
未 提交 ， 原 始 的 后 端 就 不 能 退出 。 


修复 在 查询 使 用 哈 希 索引 期 间 发 生 错 误 时 的 罕见 的 崩溃 (Heikki) 

修复 公元 前 的 年 中 二 月 29 的 日 期 时 间 值 的 输入 (Tom) 

以 前 的 代码 弄 错 了 哪 一 年 是 头 年 。 

修复 在 某 些 ALTER owNER 的 变 体 中 的 "未 识别 的 节点 类 型 "错误 (Tom) 

修复 pg_ctl， 正 确 的 从 命令 行 选项 中 提取 主 进 程 的 端口 号 (Itagaki Takahiro, Tom) 
以 前 ， pg_ctl start -w 党 试 在 错误 的 端口 连接 主 进 程 ， 导致 启动 失败 的 虚假 的 报告 。 
使 用 -fwrapv 防卫 在 最 近 的 gcc 版 本 中 可 能 的 错误 最 优化 (Tom) 

这 在 用 gcc 4.3 或 更 新 的 版 本 建立 PostgreSQL 时 是 必需 的 。 

修复 oRDER BY 和 GROUP BY 中 常量 表达 式 的 显示 (Tom) 


一 个 显示 转换 的 常量 将 会 不 正确 的 显示 。 这 会 导致 例如 转 储 和 重 载 期 间 视图 定义 的 损 
坏 。 


修复 libpq， 以 在 COPY OUT 期 间 正 确 的 处 理 NOTICE 消 息 (Tom) 


只 有 当 用 户 定义 的 数据 类 型 的 输出 例 程 发 出 一 个 NOTICE 时 ， 这 个 失败 才能 观察 到 ， 但 
是 不 保证 它 不 会 因为 其 他 原因 发 生 。 


E.114. 版 本 8.1.11 


发 布 日 期 : 2008-01-07 


这 个 版 本 包含 各 种 自 8.1.10 以 来 的 修复 ， 包 括 对 重要 安全 问题 的 修复 。 关于 8.1 主 版 本 的 新 特 
性 信息 ， 请 查看 Section E.125。 


这 是 PostgreSQL 社 区 为 Windows 生成 二 进 制 包 的 最 后 一 个 8.1.X 版 本 。 鼓 励 Windows 用 户 迁 
移 到 8.2.X 或 更 高 的 版 本 ， 因为 在 8.2.X 中 有 Windows 特 定 的 不 可 移植 的 修复 。8.1.X 将 继续 支 
持 其 他 平台 。 


E.114.1. 迁移 到 版 本 8.1.11 


运行 8.1.X 的 用 户 不 需要 转 储 / 恢 复 。 不 过 ， 如 果 你 是 从 一 个 早 于 8.1.2 的 版 本 升级 而 来 ， 那么 
请 查看 8.1.2 的 版 本 声明 。 


E.114.2. 修改 列表 


。 阻止 索引 中 的 函数 用 用 户 运 行 vacuum, ANALYZE 等 的 权限 执行 (Tom) 


在 索引 表达 式 和 部 分 索引 谓词 中 使 用 的 函数 在 制作 一 个 新 的 表 条 目 时 评估 。 很 早 我 们 就 
知道 ， 如 果 一 个 人 修改 了 一 个 属于 不 可 信用 户 的 表 ， 那 么 会 引起 特洛伊 木马 执行 的 风 
险 。 〈 请 注意 ， 触 发 器 、 缺 省 、 检 查 约束 等 也 会 引起 相同 类 型 的 风险 。) 但 是 索引 中 的 
函数 还 会 引起 额外 的 危险 ， 因 为 它们 将 被 日 常 维护 操作 执行 ， 比 如 vacuum FULL ， 它 通 
常 是 在 超级 用 户 账 户 下 自动 执行 的 。 例 如 ， 一 个 那 恶 的 用 户 可 以 通过 设置 一 个 特洛伊 木 
马 索 引 定义 并 且 等 待 下 一 个 日 常 清理 ， 使 用 超级 用 户 的 权限 执行 代码 。 该 修复 安排 标准 
的 维护 操作 (包括 vacuum. ANALYZE 、 REINDEX 和 cLusTER ) 作为 表 所 有 者 而 不 是 调 
用 的 用 户 执行 ， 使 用 和 早已 为 SECURITY DEFINER 图 数 使 用 的 一 样 的 权限 转换 机 制 。 为 了 
阻止 绕 开 这 个 安全 机 制 ， sET SESSION AUTHORIZATION 和 SET ROLE 的 执行 现在 禁止 在 一 
个 SECURITY DEFINER AAA, (CVE-2007-6600) 


。 修复 正则 表达 式 包 中 的 各 种 bug (Tom, Will Drewry) 


适当 配置 的 正则 表达 式 模式 可 能 会 引起 崩溃 ， 无 限 的 或 接近 无 限 的 循环 ， 和 /或 大 量 的 内 
存 消 耗 ， 所 有 这 些 都 造成 服务 拒绝 从 不 可 信和 的 源 接 受 正则 搜索 模式 的 应 用 的 危害 。 
(CVE-2007-4769, CVE-2007-4772, CVE-2007-6067) 


e 要 求 使 用 /contrib/dblink 的 非 超 级 用 户 只 使 用 密码 认证 作为 一 个 安全 机 制 (Joe) 


在 8.1.10 中 出 现 的 该 修复 是 不 完整 的 ， 因 为 它 只 堵 住 了 一 些 dblink 画 数 的 漏洞 。 (CVE- 
2007-6601, CVE-2007-3278) 


更 新 时 区 数据 文件 到 tzdata 版 本 2007k (特别 的 ， 最 近 的 Argentina 的 改变 ) (Tom) 

改善 非 C 环 境 中 规划 器 对 LIKE/ 正 则 估计 的 处 理 (Tom) 

修复 一 些 WHERE false AND var IN (SELECT ...) 的 情况 下 规划 器 的 失败 (Tom) 

保留 通过 ALTER TABLE ... ALTER COLUMN TYPE 重建 的 索引 的 表 空 间 (Tom) 

让 办 档 恢 复 总 是 启动 一 个 新 的 WAL 时 间 线 ， 而 不 是 只 在 使 用 恢复 停止 时 间 时 和 启动 (Simon) 


这 避免 了 党 试 重 写 最 后 WAL 段 的 一 个 现 有 兴 档 拷贝 的 极端 情况 的 风险 ， 并 且 看 起 来 比 原 
先 的 定义 更 加 简单 和 干净 。 


让 vAcuuM 在 表 太 小 而 没什么 用 处 时 不 要 使 用 所 有 的 maintenance_work_mem (Alvaro) 
修复 使 用 一 个 多 字 节 数据 库 编码 时 translate() 中 潜在 的 骨 溃 (Tom) 

为 超过 68 年 的 间隔 修复 extract(epoch from interval) 中 的 渝 出 (Tom) 

修复 PL/Perl， 以 在 UTF-8 正 则 表达 式 在 一 个 受信 任 的 函数 中 使 用 时 不 失败 (Andrew) 
修复 PL/Perl 处 理 何 时 平台 的 Perl 定 义 类 型 bool 为 int, 而 不 是 char (Tom) 
理论 上 这 会 在 任何 地 方 发 生 ， 非 标准 的 Perl 建 立 是 这 样 的 .……. 直 到 Mac OS X 10.5。 
修复 PL/Python 在 长 的 异常 消息 上 不 会 月 溃 (Alvaro) 

修复 pg_dump 以 正确 的 处 理 拥有 与 它们 的 父 表 不 同 的 缺 省 表达 式 的 继承 子 表 (Tom) 
修复 PGPAssFILE 引用 一 个 不 是 普通 文件 的 文件 时 libpq 的 月 溃 (Martin Pitt) 
ecpg 解 析 器 修复 (Michael) 


让 contrib/pgcrypto 防止 OpenSSL 库 在 键 长 于 128 位 时 失败 ; 这 至 少 是 在 一 些 Solaris 版 
本 上 的 情况 (Marko Kreen) 


让 contrib/tablefunc 的 crosstab() 义理 NULL 行 id 为 它 本 身 的 一 个 类 别 ， 而 不 是 瑶 满 
(Joe) 


it 


修 复 tsvector 和 tsquery 输出 例 程 ， 以 正确 的 逃逸 反 斜 杠 (Teodor, Bruce) 
修复 to_tsvector() 在 大 的 输入 字符 串 上 的 崩溃 (Teodor) 
当 重 新 生成 configure 脚本 时 ， 要 求 使 用 Autoconf 的 一 个 特定 版 本 (Peten) 


这 只 影响 开发 者 和 打包 者 。 该 修改 是 为 了 阻止 意外 的 使 用 未 测试 的 Autoconf 和 
PostgreSQL 版 本 的 组 合 。 如 果 你 真 的 想 要 使 用 一 个 不 同 的 Autoconf 版 本 ， 你 可 以 删除 
版 本 校 验 ， 但 是 结果 如 何 就 是 你 自己 的 责任 了 。 


E.115. 版 本 8.1.10 


发 布 日 期 : 2007-09-17 


这 个 版 本 包含 各 种 自 8.1.9 以 来 的 修复 。 关 于 8.1 主 版 本 的 新 特性 信息 ， 请 查看 Section 
E.1255 


E.115.1. 迁移 到 版 本 8.1.10 


运行 8.1.X 的 用 户 不 需要 转 储 /恢复 。 不 过 ， 如 果 你 是 从 一 个 早 于 8.1.2 的 版 本 升级 而 来 ， 那么 
查看 8.1.2 的 版 本 声明 。 


iB 
请 


E.115.2. 修改 列表 


。 当 一 个 事务 插入 行 ， 然 后 在 接近 同一 个 表 中 的 并 发 vacuum 的 结尾 退出 时 ， 阻 止 素 引 损坏 
(Tom) 


e 让 CREATE DOMAIN ... DEFAULT NULL 正确 的 工作 (Tom) 

e Sti interval 数据 类 型 接受 只 有 毫秒 或 微妙 组 成 的 输入 (Neil) 
e 加 速 rtree 索 引 插 入 (Teodor) 

。 修复 过 度 的 记录 SSL 错 误 消息 (Tom) 


。 修复 日 志 ， 这 样 日 志 消息 在 使 用 系统 记录 过 程 时 从 不 交叉 (Andrew) 


修复 1og_min_error_statement 记录 耗 完 内 存 时 的 骨 溃 (Tom) 


修复 不 正确 的 处 理 一 些 外 键 极端 情况 (Tom) 
e 阻止 REINDEX 和 cLusteR 由 于 党 试 处 理 其 他 会 话 的 临时 表 而 失败 (Alvaro) 


。 更 新 时 区 数据 库 规则 ， 尤 其 是 New Zealand 即 将 到 来 的 修改 (Tom) 


Windows 套 接 字 改 善 (Magnus) 


在 Windows 上 的 日 志 时 间 惟 中 压缩 时 区 名 ( wz )， 因为 可 能 的 编码 错误 匹配 (Tom) 
。 要 求 使 用 /contrib/dblink 的 非 超 级 用 户 只 使 用 密码 认证 作为 一 个 安全 措施 (Joe) 


E.116. 版 本 8.1.9 


发 布 日 期 : 2007-04-23 


这 个 版 本 包含 各 种 自 8.1.8 以 来 的 修复 ， 包 括 一 个 安全 修复 。 关于 8.1 主 版 本 的 新 特性 信息 ， 请 
查看 Section E.125。 


E.116.1. 迁移 到 版 本 8.1.9 


运行 8.1.X 的 用 户 不 需要 转 储 / 恢 复 。 不 过 ， 如 果 你 是 从 一 个 早 于 8.1.2 的 版 本 升级 而 来 ， 那么 
查看 8.1.2 的 版 本 声明 。 


iB 
请 


E.116.2. 修改 列表 


e。 在 Search_path 中 支持 明确 的 替换 临时 表 模 式 ， 并 且 禁 止 为 函数 和 操作 符 搜索 它 (Tom) 


这 需要 允许 安全 定义 函数 设置 一 个 search_path 的 真实 安全 的 值 。 如 果 没 有 ， 一 个 非特 
权 的 SQL 用 户 可 以 用 安全 定义 函数 的 权限 使 用 临时 对 象 执 行 代 码 (CVE-2007-2138)。 参 
阅 CREATE FUNCTION 获取 更 多 信息 。 


e /contrib/tsearch2 ĦA RIZS (Teodor) 
。 要 求 COMMIT PREPARED 在 和 事务 预 各 的 同一 个 数据 库 中 执行 (Heikki) 


e 在 vacuum FULL 如 何 处 理 uppATE 链 中 修复 潜在 的 数据 损坏 bug (Tom, Pavan Deolasee) 


规划 器 修复 ， 包 括 改 善 外 连接 和 位 图 扫描 选择 逻辑 (Tom) 


修复 扩大 一 个 哈 希 索引 期 间 的 PANIC (在 8.1.6 中 引入 的 bug) 


修复 POSIX 风 格 的 时 区 规格 以 遵从 新 的 USA DST 规 则 (Tom) 


E.117. 版 本 8.1.8 


发 布 日 期 : 2007-02-07 


这 个 版 本 包含 一 个 来 自 8.1.7 的 修复 。 关 于 8.1 主 版 本 的 新 特性 信息 ， 请 查看 Section E.125。 


E.117.1. 迁移 到 版 本 8.1.8 


运行 8.1.X 的 用 户 不 需要 转 储 /恢复 。 不 过 ， 如 果 你 是 从 一 个 早 于 8.1.2 的 版 本 升级 而 来 ， 那么 
请 查看 8.1.2 的 版 本 声明 。 


E.117.2. 修改 列表 


。 在 约束 和 功能 性 素 引 中 为 类 型 长 度 删 除 过 分 限制 的 检查 (Tom) 


E.118. 版 本 8.1.7 


发 布 日 期 : 2007-02-05 


这 个 版 本 包含 各 种 自 8.1.6 以 来 的 修复 ， 包 括 一 个 安全 修复 。 关于 8.1 主 版 本 的 新 特性 信息 ， 请 
查看 Section E.125。 


E.118.1. 迁移 到 版 本 8.1.7 


运行 8.1.X 的 用 户 不 需要 转 储 /恢复 。 不 过 ， 如 果 你 是 从 一 个 早 于 8.1.2 的 版 本 升级 而 来 ， 那么 
查看 8.1.2 的 版 本 声明 。 


iB 
请 


E.118.2. 修改 列表 


。 删除 允许 连接 的 用 户 读 取 后 端 内 存 的 安全 缺陷 (Tom) 


该 缺陷 包括 抑制 一 个 SQL 画 数 返回 它 声明 的 数据 类 型 的 正常 检查 ， 和 修改 一 个 表 字 段 的 
数据 类 型 (CVE-2007-0555, CVE-2007-0556)。 这 些 错 误 可 以 很 容易 的 利用 来 导致 一 个 
imag, 并 且 实 际 上 可 能 被 用 来 读 取 用 户 不 应 该 能 够 访问 的 数据 库 内 容 。 


。 修复 btree 索 引 页 分 裂 中 可 能 会 由 于 选择 一 个 不 可 行 的 分 裂 点 而 失败 的 罕见 bug (Heikki 
Linnakangas) 


。 为 带 有 许多 表 的 数据 库 提高 vacuum 性 能 (Tom) 


修复 自动 清理 以 避免 在 非 可 连接 的 数据 库 中 留 下 非 参数 事务 ID (Alvaro) 


这 个 bug 只 影响 8.1 分 支 。 


修复 由 unroN 触发 的 罕见 的 Assert() 崩 溃 (Tom) 
。 为 超过 三 个 字 节 长 度 的 UTF8 序 列 加 强 多 字 节 字符 处 理 的 安全 (Tom) 


修复 由 于 尝试 同步 早已 删除 的 文件 而 在 Windows 上 发 生 的 伪造 的 "权限 被 拒绝 "失败 
(Magnus, Tom) 


修复 更 新 一 个 早已 在 使 用 的 PL/pgSQL 画 数 时 可 能 的 崩溃 (Tom) 


E.119. 版 本 8.1.6 


4 #5 A HA: 2007-01-08 


这 个 版 本 包含 各 种 自 8.1.5 以 来 的 修复 。 关 于 8.1 主 版 本 的 新 特性 信息 ， 请 查看 Section 
E.125。 


E.119.1. 迁移 到 版 本 8.1.6 


运行 8.1.X 的 用 户 不 需要 转 储 / 恢 复 。 不 过 ， 如 果 你 是 从 一 个 早 于 8.1.2 的 版 本 升级 而 来 ， 那么 
查看 8.1.2 的 版 本 声明 。 


iB 
请 


E.119.2. 修改 列表 


e 改善 在 AIX 上 getaddrinfo() 的 处 理 (Tom) 
这 修复 了 在 其 他 事情 上 开始 统计 收集 器 的 问题 。 
e 修复 pg_restore， 以 处 理 包含 带 有 注释 的 大 对 象 (blobs) 的 tar 格 式 各 份 (Tom) 
。 修复 vacuum 中 的 "未 能 重新 找到 父 键 "错误 (Tom) 
。 在 服务 器 重启 期 间 清 理 pg_internal.init 缓存 文件 (Simon) 
这 避免 了 在 PITR 恢 复 之 后 缓存 文件 可 能 包含 旧 的 数据 的 危险 。 
。 修复 vacuum 截断 一 个 超过 十 亿 字 节 边 界 的 大 关系 的 竞 态 条 件 (Tom) 
© 修复 在 行 级 别 锁 上 引起 不 必要 的 死 锁 错误 的 bug (Tom) 
。 修复 影响 多 个 十 亿 字 节 哈 希 索引 的 bug (Tom) 
。 修复 Windows 信 号 处 理 中 可 能 的 死 锁 (Teodor) 
。 修复 构造 一 个 由 多 个 空 元 素 组 成 的 ARRAY[] 时 的 错误 (Tom) 
。 修复 连接 期 间 ecpg 内 存 泄露 (Michael) 
。 修复 Darwin (OS X) 编 译 (Tom) 


。 对 于 新 的 initdb 安 装 ， to_number() 和 to_char(numeric) 现在 是 STABLE ， 不 
是 IMMUTABLE (Tom) 


这 是 因为 lc_numeric AMARRA x HRA. 


。 改善 索引 对 使 用 括号 的 正则 表达 式 的 使 用 (Tom) 
这 也 提高 了 psql xd 的 性 能 。 
。 更 新 时 区 数据 库 
特别 的 ， 这 影响 了 澳大利亚 和 加 拿 大 的 夏 合 时 规则 。 


E.120. 版 本 8.1.5 


发 布 日 期 : 2006-10-16 


这 个 版 本 包含 各 种 自 8.1.4 以 来 的 修复 。 关 于 8.1 主 版 本 的 新 特性 信息 ， 请 查看 Section 
E.125。 


E.120.1. 迁移 到 版 本 8.1.5 


运行 8.1.X 的 用 户 不 需要 转 储 / 恢 复 。 不 过 ， 如 果 你 是 从 一 个 早 于 8.1.2 的 版 本 升级 而 来 ， 那么 
查看 8.1.2 的 版 本 声明 。 


iB 
请 


E.120.2. 修改 列表 


。 Ri RENAE uar MAP, BRS ZEFSELECTH (Tom) 


这 样 一 个 聚集 的 行为 是 不 可 预知 的 ， 并 且 在 8.1.X 中 会 导致 一 个 崩溃 ， 所 以 已 经 茶 用 了 。 
SQL 标准 也 不 允许 这 样 的 聚集 。 


修复 无 类 型 的 字符 串 看 成 是 ANYARRAY 时 的 内 核 转 储 


修复 执行 一 个 commit BK RoLLBACK 时 ， 扩展 查询 协议 的 时 间 日 志 中 的 内 核 转 储 


修复 查询 包含 一 个 返回 多 行 的 SQL 玉 数 时 AFTER 触 发 器 的 错误 处 理 (Tom) 


修复 ALTER TABLE ... TYPE ， 为 usine 子 句 重新 检查 not NULL (Tom) 


修复 string_to_array() ， 以 处 理 分 隔 符 字符 串 的 重复 匹配 
例如 ， string_to_array('123xx456xxx789', 'xx') o 


。 为 AM / PM 格式 修复 to_timestamp() (Bruce) 


修复 决定 是 否 需 要 ANALYZE 的 自动 清理 的 计算 (Alvaro) 


e 为 psql 的 \d 命令 修复 模式 匹配 中 的 极端 情况 


修复 /contriby/ltree 中 的 索引 损坏 错误 (Teodor) 
。 ecpg 中 的 多 个 稳健 性 修复 (Joachim Wieland) 


修复 /contrib/dbmirror 中 的 反 斜 杠 逃 逸 


/contrib/dblink 和 /contrib/tsearch2 中 的 小 修复 


哈 希 表 和 位 图 索引 扫描 中 的 效率 提升 (Tom) 

修复 Windows 上 统计 收集 器 的 不 稳定 性 (Tom, Andrew) 

修复 statement_timeout ， 使 其 在 Win32 上 使 用 合适 的 单位 (Bruce) 
在 以 前 的 Win32 8.1.X 版 本 中 ， 延 迟 通过 一 个 100 的 因子 关闭 。 
修复 MSVC 和 Borland C++ 编译 器 (Hiroshi Saito) 
修复 AlIX 和 Intel 编 译 器 (Tom) 


修复 连续 为 档 中 少见 的 bug (Tom) 


E.121. 版 本 8.1.4 


发 布 日 期 : 2006-05-23 


这 个 版 本 包含 各 种 自 8.1.3 以 来 的 修复 ， 包 括 对 极其 严重 的 安全 问题 的 修补 。 关于 8.1 主 版 本 的 
新 特性 信息 ， 请 查看 Section E.125。 


E.121.1. 迁移 到 版 本 8.1.4 


运行 8.1.X 的 用 户 不 需要 转 储 / 恢 复 。 不 过 ， 如 果 你 是 从 一 个 早 于 8.1.2 的 版 本 升级 而 来 ， 那么 
请 查看 8.1.2 的 版 本 声明 。 


针对 CVE-2006-2313 和 CVE-2006-2314 中 描述 的 SQL 注 入 攻击 的 完全 安全 可 能 需要 在 应 用 的 
代码 中 修改 。 如 果 你 有 应用 宕 入 了 不 可 信 的 字符 串 到 SQL 命 舍 中 ， 你 应 该 尽快 检测 它们 ， 以 
确保 它们 使 用 推荐 的 逃逸 技术 。 在 大 多 数 情况 下 ， 应 用 应 该 使 用 库 或 驱动 (比如 libpq 

的 Paescapestringconn() ) 提供 的 子 例 程 执行 字符 串 逃 逸 ， 而 不 是 依赖 于 aa hoc 代 码 完 成 逃 
i, 


E.121.2. 修改 列表 


。 修改 服务 器 以 在 所 有 情况 下 都 拒绝 无 效 编码 的 多 字 节 字符 (Tatsuo, Tom) 


虽然 PostgreSQL 已 经 朝 这 个 方向 发 展 了 一 段 时 间 了 ， 但 是 检查 现在 才 一 致 的 应 用 到 所 有 
编码 和 所 有 文本 输入 中 ， 并 且 现 在 总 是 提示 错误 而 不 只 是 警告 。 这 个 修改 防范 了 CVE- 
2006-2313 中 描述 的 SQL 注 入 类 型 的 攻击 。 


。 拒绝 在 字符 串 文 本 中 不 安全 的 使 用 V 


作为 服务 器 端 防范 CVE-2006-2314 中 描述 的 SQL 注 入 类 型 的 攻击 ， 服务 器 现在 只 接 

受 '' 而 不 是 \、 作为 SQL 字 符 串 字 面值 中 ASCll 单 引号 的 表示 。 缺 省 的 ， 只 

在 client_encoding 设置 为 仅 客 户 端的 编码 (SJIS、BIG5、GBK、GB18030 或 UHC) 时 
拒绝 、' ， 这 也 是 SQL 注入 有 可 能 发 生 的 情节 。 一 个 新 的 配置 参数 packslash_quote 可 

用 于 在 需要 时 调整 这 个 行为 。 请 注意 ， 针 对 CVE-2006-2314 的 完全 安全 可 能 需要 客户 端 
侧 的 修改 ; 但 是 backslash_quote 的 目的 是 在 一 定 程度 上 让 不 安全 的 客户 端 明 显 。 


° 修改 libpq 的 字符 串 逃 逸 例 程 ， 意识 到 编码 注意 问题 和 standard_conforming_strings 


这 为 CVE-2006-2313 和 CVE-2006-2314 中 描述 的 安全 问题 修复 了 使 用 libpq 的 应 用 ， 并 且 
也 提前 防范 了 规划 的 到 SQL 标准 字符 串 文 本 语法 的 转换 。 同时 使 用 多 个 PostgreSQL 连 接 
的 应 用 应 该 迁移 到 PQescapeStringCconn( ) 和 PQescapeByteaConn() ， 以 确保 为 每 个 数据 库 


连接 中 使 用 的 设置 做 了 正确 的 逃逸 。 "手动 "做 字符 串 逃 逸 的 应用 应 该 修改 为 依赖 于 库 例 
程 。 


修复 pgcrypto 中 的 弱 键 选择 (Marko Kreen) 


fortuna ENCE ee 错误 会 导致 一 个 可 预知 的 会 话 秘 钥 在 某 些 情况 下 被 
pgp_sym_encrypt() 选择 。 这 只 影 响 没有 使 用 OpenSSL 的 构造 。 


修复 一 些 不 正确 的 编码 转换 图 数 


wini251_to_iso 、 win866_to_iso 、 euc_tw_to_big5 、 euc_tw to _ mic 、 


mic_to_euc_tw 都 在 变化 范围 上 有 损坏 。 

清理 字符 串 中 剩 下 的 \' 的 使 用 (Bruce, Jan) 
让 自动 清理 在 pg_stat_activity 中 可 见 (Alvaro) 
禁用 full_page_writes (Tom) 


在 某 些 情 况 下 ， 让 full page writes 关闭 会 导致 月 涡 恢 复 失败 。 一 个 适当 的 修复 将 在 8.2 
中 出 现 ; 现在 只 是 将 它 禁 用 Ta 


各 种 规划 器 修复 ， 尤 其 是 位 图 索引 扫描 和 MIN/MAX 最 优化 (Tom) 
修复 合并 连接 中 不 正确 的 最 优化 (Tom) 

外 连接 有 时 会 发 出 多 次 未 匹配 行 的 拷贝 。 

修复 在 相同 的 事务 中 使 用 和 修改 plpgsql 画 数 的 月 浅 

修复 B-Tree 索 引 被 截断 情况 下 的 WAL 重 放 

为 包含 | 的 模式 修复 smar to (Tom) 


修复 SELECT INTO 和 CREATE TABLE aS, 以 在 缺 省 表 空 间 中 创建 表 ， 而 不 是 在 基础 目录 中 
(Kris Jurka) 


修复 服务 器 ， 以 正确 的 使 用 自 定义 DH SSL&X (Michael Fuhr) 
改善 快速 排序 性 能 (Dann Corbit) 

目前 这 个 代码 只 在 Solaris 上 使 用 了 。 

修复 x86 系 统 上 的 OS/X Bonjour (Ashley Clark) 

修复 各 种 小 的 内 存 泄 露 

修复 密码 提示 在 某 些 Win32 系 统 上 的 问题 (Robert Kinberg) 


改善 pg_dump 对 域 的 缺 省 值 的 处 理 


。 修复 pg_dumpall 以 合理 的 处 理 命 名 相同 的 用 户 和 组 (只 在 从 早 于 8.1 的 服务 器 上 转 储 时 是 
可 能 的 ) (Tom) 


用 户 和 组 将 带 有 LoGIN 权限 被 合并 到 一 个 角色 中 。 以 前 合并 的 角色 不 会 有 Loci 权限 ， 
使 其 不 能 用 作 一 个 用 户 。 


。 修复 pg_restore -n ， 以 作为 记录 工作 (Tom) 


E.122. 版 本 8.1.3 


发 布 日 期 : 2006-02-14 


这 个 版 本 包含 各 种 自 8.1.2 以 来 的 修复 ， 包 括 一 个 非常 严重 的 安全 问题 。 关于 8.1 主 版 本 的 新 特 
性 信息 ， 请 查看 Section E.125。 


E.122.1. 迁移 到 版 本 8.1.3 


运行 8.1.X 的 用 户 不 需要 转 储 /恢复 。 不 过 ， 如 果 你 是 从 一 个 早 于 8.1.2 的 版 本 升级 而 来 ， 那么 
查看 8.1.2 的 版 本 声明 。 


iB 
请 


E.122.2. 修改 列表 


修复 允许 任何 登陆 的 用 户 为 任何 其 他 数据 库 用 户 id set RoLE 的 错误 (CVE-2006-0553) 


由 于 不 充分 的 有 效 性 检查 ， 用 户 会 开发 特殊 的 情况 ， SET ROLE 通常 用 于 在 错误 之 后 恢复 
以 前 的 角色 设置 。 例 如 ， 这 人 允许 普通 用 户 请 求 超级 用 户 身份 。 权限 的 增加 只 在 8.1.0- 
8.1.2 中 存在 风险 。 不 过 ， 在 所 有 回 退 到 7.3 的 版 本 中 ， 在 SET SESSION AUTHORIZATION 中 
有 一 个 相关 的 错误 ， 允许 非特 权 的 用 户 使 服务 器 骨 溃 ， 如 果 已 经 启用 断言 编译 了 (这 不 
ERAH) 。 感谢 Akio Ishida 报 告 这 个 问题 。 


修复 自动 插入 的 行 中 行 可 见 性 逻辑 的 错误 (Tom) 


在 少数 情况 下 ， 当 前 命令 插入 的 行 可 能 被 看 做 早已 是 有 效 的 ， 而 此 时 不 应 该 是 这 样 的 。 
修复 在 8.0.4、7.4.9 和 7.3.11 版 本 中 创建 的 错误 。 


。 修复 在 pg_clog 和 pg_subtrans 文 件 创建 期 间 会 导致 "文件 早已 存在 " 错误 的 竞 态 条 件 (Tom) 
。 修复 缓存 失效 消息 正好 在 错误 时 间 到 达 导 致 朋 淡 的 情况 (Tom) 
e 为 预备 语句 中 的 unknown 参数 适当 的 检查 domain 约束 (Neil) 


e 确保 ALTER COLUMN TYPE 以 正确 的 顺序 处 理 FOREIGN KEY 、 UNIQUE 和 PRIMARY KEY 约束 
(Nakano Yoshihisa) 


© 修复 以 允许 恢复 拥有 交叉 模式 引用 自 定义 操作 符 或 操作 符 类 的 转 储 (Tom) 


e 人 允许 pg_restore 在 copy 失败 之 后 正确 的 继续 ; 以 前 它 尝试 将 剩余 的 copy 数据 看 做 SQL 
命令 (Stephen Frost) 


。 当 没 有 指定 数据 目录 时 ， 修 复 pg_ctl unregister 的 崩溃 (Magnus) 


修复 libpq PQprint _ HTML 标签 (Christoph Zwerschke) 

修复 在 AMD64 和 PPC 上 的 ecpg 崩 溃 (Neil) 

允许 sEToF 和 %TYPE 一 起 在 函数 结果 类 型 声明 中 使 用 

如 果 错 误 发 生 在 参数 在 PL/python 中 传递 期 间 ， 那 么 正确 的 恢复 (Neil) 
修复 plperl_return_next 中 的 内 存 泄露 (Neil) 

修复 PL/perl 在 Win32 的 环境 上 匹配 后 端的 处 理 (Andrew) 

各 种 优化 器 修复 (Tom) 


修复 log_min_messages 在 Win32 上 设置 为 DEBUG3 或 postgresql.conf 之 外 时 的 月 渍 
(Bruce) 


为 Win32、Cygwin, OS X、AIX 修 复 pgxs -L 的 库 路 径 声 明 (Bruce) 

在 检查 Win32 管 理 员 权限 时 检查 SID 是 否 馈 用 (Magnus) 

适当 的 拒绝 超出 范围 的 数据 输入 (Kris Jurka) 

可 移植 性 修复 ， 以 在 配置 期 间 测 试 finite 和 isinf 的 存在 (Tom) 

通过 避免 每 个 数据 行 的 内 核 调 用 ， 提 高 copy in 经 过 libpq 的 速度 (Alon Goldshuv) 


提高 /contrib/tsearch2 索引 创建 的 速度 (Tom) 


E.123. 版 本 8.1.2 


发 布 日 期 : 2006-01-09 


这 个 版 本 包含 各 种 自 8.1.1 以 来 的 修复 。 关 于 8.1 主 版 本 的 新 特性 信息 ， 请 查看 Section 
E.1255 


E.123.1. 迁移 到 版 本 8.1.2 


运行 8.1.X 的 用 户 不 需要 转 储 /恢复 。 不 过 ， 如 果 你 受到 本 地 环境 或 下 面 描述 的 plperl 问 题 的 影 
响 ， 你 可 能 需要 在 升级 之 后 REINDEX 文本 字段 上 的 索引 。 


E.123.2. 修改 列表 
。 修复 Windows 代 码 ， 这 样 如 果 在 ShmemBackendArray 中 没有 更 多 的 空间 ， Bw 
续 而 不 是 退出 (Magnus) 


如 果 太 多 连接 请 求 差 不 多 一 起 到 达 ， 那 么 以 前 的 代码 行为 业 导 致 拒绝 服务 的 情况 。 这 只 
应 用 到 Windows 端 口 。 


。 修复 在 8.0 中 引入 的 bug， 该 bug 会 允许 读 缓冲 区 返回 一 个 早已 用 过 的 页 面 作为 新 的 页 面 ， 
潜在 的 导致 去 失 最 近 提 交 的 数据 (Tom) 


。 修复 在 一 个 事务 外 部 或 一 个 失败 的 事务 内 部 发 出 的 协议 级 别 的 描述 信息 (Tom) 
。 为 认为 不 同 字符 组 合 相等 的 环境 ， 如 Hungarian， 修 复 字 符 串 比较 (Tom) 

这 可 能 需要 REINDEX 来 修复 文本 字段 上 现 有 的 索引 。 
。 在 主 进 程 启动 期 间 设置 本 地 环境 变量 ， 以 确保 plperl 在 稍 后 不 会 改变 本 地 环境 


这 避免 了 postmaster 启 动 时 的 环境 变量 和 initdb 说 明 的 不 同时 发 生 的 问题 。 在 这 些 条 件 
F, piperi 的 任何 使 用 都 有 可 能 导致 损坏 索引 。 如 果 你 遇 到 了 这 些 ， 你 可 能 需 
要 REINDEX 文本 字段 上 现 有 的 索引 。 


。 人 允许 安装 目录 更 灵活 的 重新 定位 (Tom) 
以 前 的 版 本 只 在 所 有 安装 目录 路 径 都 相同 除了 最 后 一 个 组 件 不 同时 支持 重新 定位 。 
e 阻止 由 于 使 用 Iso-8859-5 和 iso-8859-9 编码 而 引起 的 崩溃 (Tatsuo) 


。 修复 strpos() 和 正则 表达 式 中 处理 某 些 很 少 使 用 的 Asian 多 字 节 字符 集中 长 期 存在 的 bug 
(Tatsuo) 


修复 COPY CSV 模 式 认为 任何 \. 为 结束 拷贝 数据 的 bug 
新 的 代码 要 求 、. 在 每 个 文档 中 都 单独 的 显示 在 一 行 中 。 


让 COPY CSV 模 式 引 用 、. 的 文本 数据 值 ， 以 确保 它 不 会 被 解释 为 结束 数据 的 标记 
(Bruce) 


各 种 修复 返回 Recor AYER (Tom) 
修复 postgresql.conf 的 处 理 ， 这 样 一 个 没有 换行 符 的 最 后 一 行 能 够 正确 的 处 理 (Tom) 


修复 /contrib/pgcrypto gen_salt 中 的 bug， 它 导 致 不 能 为 MD5 和 XDES 算 法 使 用 所 有 可 
用 的 盐 空 间 (Marko Kreen, Solar Designer) 


Blowfish 和 标准 的 DES 的 盐 没 有 受到 影响 。 
修复 处 理 表达 式 索 引 时 自动 清理 的 崩溃 


修复 /contrib/dblink ， 当 指定 的 字段 数量 和 查询 实际 返回 的 数量 不 同时 ， 抛 出 一 个 错误 
Ti ABs (Joe) 


E.124. 版 本 8.1.1 


这 个 


发 布 日 期 : 2005-12-12 


版 本 包含 各 种 自 8.1.0 以 来 的 修复 。 关 于 8.1 主 版 本 的 新 特性 信息 ， 请 查看 Section 


E.1255 


E.124.1. 迁移 到 版 本 8.1.1 


运行 8.1.X 的 用 户 不 需要 转 储 /恢复 。 


E.124.2. 修改 列表 


修复 外 部 链接 条 件 不 正确 的 最 优化 (Tom) 

修复 在 包含 通过 优化 器 优化 了 的 子 查询 的 情况 下 ， 错 误 报告 字段 名 的 问题 (Tom) 
修复 在 包括 CHECK 约 束 、toast 字 段 和 索引 的 情节 中 的 更 新 失败 (Tom) 

修复 从 错误 中 恢复 之 后 的 后 台 写 问题 (Tom) 


发 现 后 台 写 在 写 人 错误 之 后 泄露 缓存 针 。 虽 然 这 在 它 本 身 不 致命 ， 但 是 这 可 能 会 导致 稍 
后 VACUUM 命令 难以 理解 的 堵塞 。 


如 果 客 户 端 在 当前 事务 早已 终止 时 发 送 绑 定 的 协议 消息 ， 阻 止 失败 。 
/contrib/tsearch2 和 /contrib/ltree 修复 (Teodon) 


修复 语言 中 翻译 的 错误 消息 需要 重新 排序 单词 的 问题 ， 比 如 Turkish ; 还 有 输出 字符 串 意 
外 截断 和 最 小 可 能 的 bigint 值 错误 显示 的 问题 (Andrew, Tom) 


这 个 问题 只 在 使 用 了 我 们 的 port/snprintf.c 代码 的 平台 上 出 现 ， 如 果 给 出 
了 --enable-nls 则 该 代码 包括 了 BSD 变 种 ， 可 能 还 有 其 他 。 另外 ， 一 个 不 同形 式 的 翻译 
蕴 误 消息 问题 可 能 会 在 Windows 上 出 现 ， 取决 于 使 用 了 libintl 的 哪个 版 本 。 


为 to_char(time) 和 to_char(interval) 重新 允许 AM / PM, HH 、 HH12 和 D 格式 说 明 
ffo ( to_char(interval) 应 该 可 能 使 用 HH24 。) (Bruce) 


AIX、HPUX 和 MSVC 编 译 修复 (Tom, Hiroshi Saito) 
优化 器 改善 (Tom) 


在 Windows NO_SYSTEM_RESOURCES 错 误 之 后 重新 尝试 文件 读 取 和 写 入 (Qingqing 
Zhou) 


阻止 ANALYZE 表 达 式 索引 期 间 autovacuum 的 月 江 (Alvaro) 
修复 ON COMMIT DELETE ROWS 临 时 表 的 问题 
修复 触发 器 修改 SELECT DISTINCT 查 询 的 输出 时 的 问题 


添加 了 8.1.0 版 本 声明 ， 说 明了 如 何 迁 移 无 效 的 uTF-8 字 节 序列 (Paul Lindner) 


E.125. 版 本 8.1 


发 布 日 期 : 2005-11-08 


E.125.1. 概要 


这 个 版 本 中 的 主要 修改 : 
改善 到 共享 缓冲 区 缓存 的 并 发 访问 (Tom) 


访问 共享 缓冲 区 缓存 被 认定 为 是 一 个 重要 的 可 扩展 性 问题 ， 尤 其 是 在 多 个 CPU 的 系统 上 。 在 
这 个 版 本 中 ， 锁 定 的 方式 是 以 缓冲 区 管理 器 已 经 被 检查 以 减少 锁 征用 和 提高 可 扩展 性 来 完成 
的 。 缓冲 区 管理 器 也 已 经 被 修改 为 使 用 一 个 "时 钟 扫描 "替换 机 制 。 

允许 索引 扫描 使 用 一 个 中 间 内 存 位 图 (Tom) 


在 以 前 的 版 本 中 ， 只 有 单个 索引 可 以 用 来 在 表 上 查找 。 有 了 这 个 特性 ， 如 果 一 个 查询 有 
WHERE tab.coli = 4 and tab.col2 = 9, ##H cola 和 col2 上 没有 多 字段 索引 ， 但 是 

在 col1 上 有 一 个 索引 ， 并 且 在 col2 上 有 另 一 个 索引 ， 那么 有 可 能 搜索 两 个 素 引 并 在 内 存 中 
组 合 结果 ， 然后 为 同时 匹配 cols 和 colz: 限制 条 件 的 行 执行 堆栈 获取 。 这 在 有 许多 非 结构 
化 的 查询 ， 可 能 创建 匹配 所 有 访问 条 件 的 索引 的 环境 中 是 非常 有 用 的 。 即使 是 单个 索引 ， 位 
图 扫 摘 也 是 有 用 的 ， 因 为 他 们 减少 了 所 需要 的 随机 访问 的 数量 ; 位 图 索引 扫描 对 于 检索 完整 
表 的 相当 大 的 分 数 是 高 效 的 ， 而 普通 索引 扫描 则 不 行 。 

添加 了 两 阶段 提交 (Heikki Linnakangas, Alvaro, Tom) 


两 阶段 提交 人 允许 事务 在 几 个 计算 机 上 " 准 各 "， 并 且 一 旦 所 有 计算 机 都 成 功 的 准备 了 它们 的 事务 
(没有 失败 ) ， 那 么 所 有 事务 都 可 以 提交 。 即 使 一 个 机 器 在 准 各 之 后 朋 江 了 ， 准备 的 事务 也 
可 以 在 该 机 器 重启 之 后 提交 。 新 的 语法 包括 PREPARE TRANSACTION 

和 COMMIT/ROLLBACK PREPARED o 还 添加 了 一 个 新 的 系统 视图 pg_prepared_xacts o 


创建 一 个 新 的 替换 用 户 和 组 的 角色 系统 


角色 是 用 户 和 组 的 一 个 组 合 。 像 用 户 ， 它 们 可 以 有 登陆 功能 ， 像 组 ， 一 个 角色 可 以 拥有 其 他 
角色 作为 成 员 。 和 角色 基本 上 删除 了 用 户 和 组 之 间 的 不 同 。 例如 ， 一 个 角色 可 以 : 


© 有 登陆 功能 (可 选 ) 

。 拥有 对 象 

。 持 有 数据 库 对 象 的 访问 权限 

。 从 它 作为 成 员 的 其 他 角色 上 继承 权限 


一 旦 用 户 登 陆 到 一 个 角色 ， 她 获得 了 登陆 角色 加 上 任何 继承 的 角色 的 能 力 ， 并 且 可 以 使 

用 set ROLE 来 切换 到 其 他 角色 (她 在 其 中 是 一 个 成 员 ) 。 这 个 特性 是 SQL 标准 角色 的 概念 的 
一 个 概括 。 这 个 修改 还 用 新 的 角色 能 力 目 录 pg_authid 和 pg_auth_members #3 T 

pg_shadow 和 pg_group 。 老 的 表 被 重新 定义 为 新 角色 表 上 的 只 读 视 图 。 


为 MIN() 和 MAx() 自动 使 用 索引 (Tom) 


在 以 前 的 版 本 中 ， 为 MIN() 或 mxo 使 用 索引 的 唯一 方式 是 重 写 查 
询 SELECT col FROM tab ORDER BY col LIMIT 1 。 索引 使 用 现在 是 自动 发 生 的 。 


移动 /contrib/pg_autovacuum 到 主 服务 器 (Alvaro) 


整合 自动 清理 到 服务 器 ， 人 允许 它 在 数据 库 服 务 器 的 同步 中 自动 启动 和 停止 。 并 人 允许 自动 清理 
在 postgresql.conf 中 配置 。 


使 用 SELECT ... FOR SHARE 添加 共享 的 行 级 别 锁 (Alvaro) 


然而 PostgreSQL 的 MVCC 锁 允许 SELECT 永 不 被 守 入 锁定 ， 并 且 因 此 不 需要 为 典型 的 操作 共 


享 行 锁 ， 共享 的 锁 对 于 请 求 共享 的 行 锁 的 应 用 是 有 用 的 。 特别 是 它 减 少 了 由 于 参照 完整 性 检 
查 增 加 的 锁 请 求 。 


在 共享 的 对 象 上 添加 依赖 性 ， 尤 其 是 角色 (Alvaro) 


依赖 性 机 制 的 扩展 阻止 了 角色 仍然 拥有 数据 库 对 象 时 被 删除 。 以 前 有 可 能 意外 的 "孤儿 "对 象 
被 删除 它们 的 所 有 者 。 虽然 这 可 以 被 恢复 ， 但 是 它 是 杂乱 的 并 且 会 使 人 不 愉快 。 


为 分 区 表 提 升 性 能 (Simon) 
新 的 constraint_exclusion 配置 参数 避免 了 在 约束 表示 没有 匹配 行 存 在 的 子 表 上 查找 。 


这 人 允许 表 分 区 的 基本 类 型 。 如 果子 表 存 储 独立 的 键 范 围 ， 并 且 强 制 使 用 适当 的 cHEck 约束 ， 
那么 优化 器 将 在 约束 保证 在 子 表 中 没有 匹配 的 行 存在 时 跳 过 子 表 访 问 。 


E.125.2. 迁移 到 版 本 8.1 
对 于 那些 想 要 从 任何 以 前 的 版 本 中 迁移 数据 的 用 户 来 说 ， 使 用 pg_dump 的 一 个 转 储 /恢复 是 必 
需 的 。 


8.0 版 本 宣布 间隔 的 to_char() BUSES. 1A MRR Bat, 因为 没有 更 好 的 API 被 推 
荐 ， to_char(interval) 已 经 在 8.1 中 被 加 强 ， 并 且 将 保留 在 服务 器 中 。 


观察 下 列 的 不 兼容 性 : 
e add_missing_from 现在 缺 省 是 假 (Neil) 


缺 省 的 ， 如 果 表 用 在 一 个 没有 FRoM 引用 的 查询 中 ， 我 们 现在 产生 一 个 错误 。 老 的 行为 
仍然 可 用 ， 但 是 参数 必须 设置 为 true'。 


为 了 加 载 一 个 现 有 的 转 储 文件 ， 如 果 转 储 包含 任何 使 用 隐 式 FRoM 语法 创建 的 视图 或 规 
则 ， 那 么 将 add_missing_from 设置 为 true 是 必须 的 。 这 应 该 是 一 个 一 次 性 的 烦恼 ， 因 为 
PostgreSQL 8.1 将 转换 这 样 的 视图 和 规则 到 标准 的 显 式 FRoM 语法 。 随后 的 转 储 将 因此 
不 会 有 这 个 问题 。 


让 float4 / floats / oid SKE FRH('' ) 的 输入 抛 出 一 个 错误 ， 而 不 是 将 它 看 做 需 
(Neil) 


这 个 修改 与 当前 整数 的 需 长 度 宇 符 串 的 处 理 是 一 致 的 。 这 个 修改 计划 在 8.0 中 宣布 。 
default_with_oids 现在 缺 省 为 假 (Neil) 


这 个 选项 设置 为 假 ， 用 户 创建 的 表 不 再 有 一 个 OID 字 段 ， 除 非 在 create TABLE 中 指定 
了 with orps 。 尽 管 OID 已 经 存在 于 PostgreSQL 的 所 有 版 本 中 ， 但 是 因为 它们 只 有 四 字 
人 所 以 它们 的 使 用 是 受 限 制 的 。 唯 一 
标识 行 的 首选 方式 是 通过 序列 和 sERIAL 类 型 ， 这 个 自从 PostgreSQL 6.4 开 始 就 已 经 支 
持 了 。 


添加 € 语法 ， 这 样 最 后 普通 字符 串 可 以 正确 的 对 待 反 斜 杠 (Bruce) 


目前 PostgreSQL 作 为 引入 一 个 特殊 的 逃逸 序列 来 处 理 字 符 串 文本 中 的 反 斜 枉 ， 比 

如 \n 或 oro 。 虽 然 这 人 允许 特殊 值 的 简单 入 口 ， 但 是 它 是 不 标准 的 并 且 使 得 从 其 他 数据 
库 中 移植 应 用 更 加 困难 。 因 为 这 个 原因 ， PostgreSQL 工 程 计 划 删 除 反 斜 杠 在 字符 串 中 的 
特殊 含义 。 为 了 向 后 兼容 和 想 要 特殊 处 理 反 斜 杠 的 用 户 ， 创 建 了 一 个 新 的 字符 串 语法 。 
这 个 新 的 字符 串 语法 的 格式 是 在 开始 字符 串 的 单 引号 之 前 写 一 个 E ， 例如 E'hi\n' o $ 
然 这 个 版 本 没有 改变 反 斜 杠 在 字符 串 中 的 处 理 ， 但 是 它 确实 添加 了 新 的 配置 参数 来 帮助 
用 户 迁 移 点 用 到 未 来 的 版 本 : 


o standard conforming_strings 一 这 也 个 版 本 正确 的 对 待 反 斜 杠 为 普 通 字符 串 ? 
Oo escape_string_warning 一 在 普通 的 字符 串 (JFE) 中 警告 反 斜 杠 


standard_conforming_strings 值 是 只 读 的 。 应 用 可 以 检索 该 值 来 知道 反 斜 枉 是 如 何 义理 
的 。 (参数 的 存在 也 可 以 作为 一 个 支持 E'' 字符 串 语法 的 指示 。) 在 未 来 的 版 本 中 ， 
standard_conforming_strings 将 为 真 ， 意味 着 反 斜 杠 在 非 E 字 符 串 中 将 按照 字面 值 对 待 。 
为 了 准备 这 个 修改 ， 在 需要 特殊 处 理 反 斜 杠 的 地 方 使 用 Ee'' 字符 串 ， 并 且 打 

FF escape_string warning 来 找到 需要 使 用 E'' 转换 的 额外 的 字符 串 。 另外 ， 使 用 两 个 单 
引号 ( '…' ) 在 一 个 字符 串 中 做 入 一 个 字面 的 单 引号 ， 而 不 是 PostgreSQL 支 持 的 反 斜 杠 单 
引号 (\' ) 语 法 。 前 者 是 符合 标准 的 ， 并 且 不 需要 使 用 E'' 字符 串 语法 。 你 也 可 以 使 

用 ss 字符 串 语 法 ， 它 不 特殊 对 待 反 斜 杠 。 


让 REINDEX DATABASE 重新 索引 数据 库 中 的 所 有 索引 (Tom) 


以 前 ， REINDEX DATABASE 只 重建 系统 表 的 索引 。 这 个 新 的 行为 看 起 来 更 加 直观 。 一 个 新 
的 命令 REINDEX SYSTEM 提供 只 重建 系统 表 的 老 的 功能 。 


© 只 读 大 对 象 描述 符 现在 服从 MVCC 快 照 语 义 


当 一 个 大 对 象 是 用 INv_READ (不 是 INv_wRITE ) 打开 的 时 ， 来 自 描述 符 的 数据 读 取 现在 
将 反应 调用 lo_open() 的 查询 使 用 了 事务 快照 时 大 对 象 的 状态 的 "快照 "。 要 获取 总 是 返 
回 最 后 提交 的 数据 的 老 的 行为 ， 在 loopen) 的 模式 标志 中 包含 INV_WRITE o 


。 为 序列 辑 数 的 参数 添加 适当 的 依赖 (Tom) 


在 以 前 的 版 本 中 ， 传 递 到 nextval() 、 currval() 和 setval() 的 序列 名 是 作为 简单 文本 
字符 串 存 储 的 ， 意味 着 重 命名 或 删除 一 个 在 wra 子 句 中 使 用 的 序列 会 使 子 句 无 效 。 
这 个 版 本 将 所 有 新 建 的 序列 函数 参数 作为 内 部 OID 存 储 ， 人 允许 它们 追踪 序列 重 命名 ， 并 
且 添 加 阻止 不 正确 的 序列 删除 的 依赖 关系 信息 。 这 也 使 得 bfFAuLT 子 句 免疫 模式 重 命名 
和 搜索 路 径 改 变 。 


一 些 应 用 可 能 依赖 于 运行 时 查找 序列 名 的 老 的 行为 。 这 通过 明确 的 转换 参数 为 text 仍 
然 可 以 实现 ， 例 如 nextval('myseq'::text) o 


8.1 之 前 的 数据 库 转 储 加 载 到 8.1 将 使 用 老 的 基于 文本 的 表示 ， 并 且 因此 没有 OID 存 储 参数 
的 特性 。 不 过 ， 更 新 包含 基于 文本 的 DEFAULT 子 句 的 数据 库 是 可 能 的 。 首 先 ， 保 存 这 个 
查询 到 一 个 文件 中 ， 上 比如 fixseq.sql : 


SELECT 'ALTER TABLE ' || 
pg_catalog.quote_ident(n.nspname) || '.' || 
pg_catalog.quote_ident(c.relname) | | 
' ALTER COLUMN ' || pg_catalog.quote_ident(a.attname) | | 
' SET DEFAULT ' || 
regexp_replace(d.adsrc, 

$$val\(\(('[A']*'):i:text\)::regclass$$, 
$$val(\1$$, 
'g') Il 


FROM pg_namespace n, pg_class c, pg_attribute a, pg_attrdef d 
WHERE n.oid = c.relnamespace AND 

c.oid = a.attrelid AND 

a.attrelid = d.adrelid AND 

a.attnum = d.adnum AND 

d.adsrc ~ $$val\(\('[A']*'::text\)::regclass$$; 


然后 ， 在 一 个 数据 库 中 运行 该 查询 ， 找 到 需要 哪个 调整 ， 例 如 对 于 数据 库 dbl : 


psql -t -f fixseq.sql db1 


这 将 显示 ALTER TABLE 命令 需要 转换 数据 库 到 新 的 基于 OID 的 表示 。 如 果 命 令 看 起 来 合 
理 ， 运 行 这 个 来 更 新 该 数据 库 : 


psql -t -f fixseq.sql db1 | psql -e db1 


这 个 过 程 必须 在 每 个 要 更 新 的 数据 库 中 重复 进行 。 
。 在 psql 中 ， 将 未 加 引号 的 \{digit}+ 序列 看 做 是 八进制 的 (Bruce) 


在 以 前 的 版 本 中 ， \{digit}+ 序列 被 看 做 是 小 数 点 ， 并 且 只 有 \ofdigity+ 被 看 做 是 八 进 
制 的 。 这 个 修改 是 为 了 一 致 性 。 


为 前 级 和 后 级 % 和 ^ 操作 符 删 除 语 法 生产 

这 些 从 未 记录 和 复杂 的 负数 的 模 数 操作 符 ( % ) 的 使 用 。 

让 多 边 形 的 eeit; 和 sagt; 与 盒子 的 "over" 操 作 符 一 致 (Tom) 

CREATE LANGUAGE 可 以 忽略 提供 的 人 参数， 为 了 支持 来 自 pg_pltemplate 的 信息 


定义 了 一 个 新 的 系统 目录 pg_pltemplate ， 携带 关于 过 程 语言 首选 定义 的 信息 (比如 它 
们 是 否 有 验证 器 加 数 ) 。 当 一 个 条 目 存在 于 创建 语言 的 目录 中 时 ， CREATE LANGUAGE 将 
忽略 所 有 它 的 参数 除了 语言 名 并 使 用 目录 信息 。 采取 这 个 措施 是 因为 废弃 的 语言 定义 被 
老 的 转 储 文件 加 载 而 增加 问题 。 截止 到 8.1，pgaurmp 和 将 只 是 作为 ”cREATE LANGUAGE 
name 转 储 过 程 语言 定义 ， 依 赖 于 加 载 时 模板 条 目的 存在 。 我 们 期 待 这 将 成 为 一 个 更 
加 不 会 过 时 的 表示 。 


让 pg_cancel_backend(int) 返回 一 个 boolean 而 不 是 一 个 integer (Neil) 


一 些 用 户 在 加 载 UTF-8 数 据 到 8.1.X 时 遇 到 问题 。 这 是 因为 以 前 的 版 本 允许 无 效 的 UTF-8 

字 节 序列 输入 到 数据 库 中 ， 而 这 个 版 本 只 接受 有 效 的 UTF-8 序 列 。 纠正 转 储 文件 的 一 个 

方式 是 运行 命令 iconv -c -f UTF-8 -t UTF-8 -o cleanfile.sql dumpfile.sql 。 -c 选项 删 
除 无 效 的 字符 序列 。 两 个 文件 的 差异 将 显示 无 效 的 序列 。 iconv 读 取 整 个 输入 文件 到 内 
A, 这 样 它 可 能 为 了 义理 需要 使 用 split 将 转 储 分 成 多 个 较 小 的 文件 。 


E.125.3. 额外 的 修改 


下 面 你 将 发 现 PostgreSQL 8.1 和 以 前 的 主 版 本 间 详 细 的 额外 的 修改 。 


E.125.3.1. 性 能 改善 


提高 GiST 和 R-tree 索引 性 能 (Neil) 

改善 优化 器 ， 包 括 自 动 调整 哈 希 连接 的 大 小 (Tom) 

彻底 检查 几 个 方面 的 内 部 API 

修改 WAL 记 录 CRC 从 64 位 到 32 位 (Tom) 

我 们 觉得 计算 64 位 CRC 的 额外 开销 非常 大 ， 并 且 获 得 的 可 靠 性 并 不 足以 为 它 辩 解 。 
阻止 在 WAL 页 面 中 写 入 大 的 空间 隙 (Tom) 

改善 SMP 机 器 上 的 自 旋 锁 行为 ， 尤 其 是 Opterons (Tom) 


允许 非 连续 的 索引 字段 在 多 字段 素 引 上 使 用 (Tom) 


例如 ， 这 允许 一 个 在 字段 a、b、c 上 的 索引 在 一 个 带 有 WHERE a = 4 and c = 10 的 查询 
中 使 用 。 


为 CREATE TABLE AS / SELECT INTO 跳 过 WAL 日 志 (Simon) 


因为 cREATE TABLE As 期 间 的 崩溃 会 导致 表 在 恢复 期 间 被 删除 ， 没有 理由 WAL 记 录 该 表 
被 加 载 了 。 (不 过 ， 如 果 启 用 了 WAL 为 档 ， 记 录 仍 然 会 发 生 。) 


人 允许 并 发 的 GiST 索 引 访问 (Teodor, Oleg) 
添加 配置 参数 full_page_writes 控制 守 入 全 部 页 面 到 WAL (Bruce) 


A TERDI AS ARIF REE, PostgreSQL 和 页 面 的 完整 拷贝 来 
WAL 它 在 一 个 检查 点 之 后 被 修改 的 第 一 个 时 间 。 这 个 选项 为 了 更 快 的 速度 关闭 了 该 功 
能 。 这 对 于 使 用 电池 后 各 的 磁盘 缓存 来 说 是 安全 的 ， 这 种 情况 下 部 分 页 面 写 入 不 会 发 

生 。 


当 为 wal_sync_method 使 用 o_sync 时 ， 如 果 可 用 则 使 用 o_pIREcT (Itagaki Takahiro) 
0_DIRECT 导致 磁盘 写 入 绕 过 内 核 缓存 ， 对 于 WAL 写 入 来 说 ， 这 提高 了 性 能 。 
提高 copy From 性 能 (Alon Goldshuv) 

是 通过 在 更 大 的 语 块 中 读 取 copy 输入 完成 的 ， 而 不 是 挨个 读 取 字 符 。 


提高 了 couNT() 、 SUM, AVG() 、 STDDEV() 和 vARIANCE() 的 性 能 (Neil, Tom) 


E.125.3.2. 服务 右 的 变化 


阻止 由 于 事务 ID (XID) 环 绕 式 处 理 引 起 的 问题 (Tom) 


当 事 务 计数 器 达到 环绕 的 点 时 ， 服 务 器 现在 将 发 出 警告 。 如 果 计 数 器 即将 达到 环绕 的 点 
at, 服务 器 将 停止 接受 查询 。 这 保证 了 数据 在 需要 的 清理 执行 之 前 不 会 丢失 。 


修复 OID 计 数 器 已 经 环绕 式 处 理 之 后 ， 对 象 IDs (OIDs) 与 现 有 系统 对 象 冲突 的 问题 (Tom) 
添加 vacuum 期 间 需 要 增加 max_fsm_relations 和 max_fsm_pages 的 警告 (Ron Mayer) 
添加 temp_buffers 配置 参数 ， 允许 用 户 为 临时 表 访 问 确定 本 地 缓存 区 域 的 大 小 (Tom) 
添加 会 话 启 动 时 间 和 客户 端 IP 地 址 到 pg_stat_activity (Magnus) 

为 位 图 扫描 调整 pg_stat 视图 (Tom) 

一 些 字段 的 含义 发 生 了 微妙 的 变化 。 

加 强 了 pg_locks 视图 (Tom) 


客户 端 侧 PREPARE 和 execute 的 日 志 查询 (Simon) 


允许 Kerberos 名 字 和 用 户 名 在 postgresql,conf 的 规定 中 大 小 写 敏感 (Magnus) 


添加 配置 参数 krb_server_hostname ， 这 样 服务 器 主机 名 可 以 作为 服务 主体 的 一 部 分 指定 
(Todd Kover) 


如 果 没 有 设置 ， 任 何 服务 主体 匹配 keytab 中 的 任意 条 目 都 有 可 能 被 使 用 。 这 是 这 个 版 本 
中 的 新 的 Kerberos 匹 配 行为 。 


AE AR m ) 和 远程 主机 ( xh ) 添 加 1og_line_prefix 选项 (Ed L.) 

为 GiST 素 引 添 加 WAL 日 志 (Teodor, Oleg) 

GiST 索 引 现 在 对 于 崩溃 和 时 间 点 恢复 来 说 是 安全 的 。 

当 我 们 执行 pg_stop_packup() 时 ， 删 除 老 的 *.backup 文件 (Bruce) 

这 阻止 了 大 量 的 *.backup 文件 存在 于 pg_xlog/ Po 

添加 配置 参数 为 闲置 、 间 隔 和 计数 控制 TCP/IP 保 持 活动 的 时 间 (Oliver Jowett) 
这 些 值 可 以 修改 来 允许 对 丢失 的 客户 端 连接 更 快速 的 检测 。 

添加 每 用 户 和 每 数据 库 连 接 限制 (Petr Jelinek) 


使 用 ALTER USER 和 ALTER DATABASE ， 现在 可 以 强制 限制 作为 一 个 特殊 用 户 或 作为 一 个 特 
殊 数据 库 并 发 连接 的 最 大 会 话 数 量 。 设置 限制 为 0 禁用 用 户 或 数据 库 连 接 。 


在 64 位 的 机 器 上 人 允许 超过 两 千 兆 字 节 的 共享 内 存 和 每 后 端的 工作 内 存 (Koichi Suzuki) 


新 增 系 统 目 录 pg_pltemplate ， 人 允许 在 转 储 文件 中 重 写 广 弃 的 过 程 语言 定义 (Tom) 


E.125.3.3. 查询 修改 


添加 临时 视图 (Koju lijima, Neil) 

修复 navic 没有 任何 聚集 事 数 或 eRoup BY, 这 样 查询 返回 一 个 组 (Tom) 
以 前 ， 这 样 的 情况 会 将 Having 子 句 看 做 和 wHERE 子 句 相同 。 这 是 不 规范 的 。 
添加 usine 子 句 允许 额外 的 表 指 定 为 weete (Euler Taveira de Oliveira, Neil) 


在 以 前 的 版 本 中 ， 没 有 明确 的 方法 指定 用 于 DELETE 语句 中 的 连接 的 额外 的 表 。 对 于 这 个 
BAY, uPDATE 早已 有 了 一 个 FRoM 子 句 。 


在 后 端 和 ecpg 字 符 串 中 添加 对 \x 十 六 进 制 逃逸 的 支持 (Bruce) 
这 正 像 标 准 C \x 逃逸 语法 。 八 进 制 逃 逸 早 就 支持 了 。 


添加 BETwEEN SYMMETRIC 查询 语法 (Pavel Stehule) 


这 个 特征 允许 BETwEEN 比较 不 请 求 第 一 个 值 小 于 第 二 个 值 。 例 
如 ， 2 BETWEEN [ASYMMETRIC] 3 AND 1 返回 假 ， 而 2 BETWEEN SYMMETRIC 3 AND 1 返回 真 。 
BETWEEN ASYMMETRIC 早 就 支持 了 。 


e 添加 NowAIT 选项 到 SELECT ... FOR UPDATE/SHARE (Hans-Juergen Schoenig) 


当 statement_timeout 配置 参数 允许 一 个 查询 接受 超过 一 定数 量 的 时 间 被 取消 ， 
NOWAIT 选项 允许 查询 在 SELECT ... FOR UPDATE/SHARE 命令 不 能 立即 获得 一 个 行 锁 时 尽快 


被 取消 。 


E.125.3.4. 对 象 操作 的 改变 
。 追踪 共享 对 象 的 依赖 性 (Alvaro) 


PostgreSQL 人 允许 全 局 表 (AP. RHE. RZ) 引用 多 个 数据 库 中 的 信息 。 这 为 全 局 
表 额 外 的 添加 了 依赖 关系 信息 ， 这 样 ， 例 如 ， 用 户 所 有 权 可 以 跨 数据 库 追 踪 ， 一 个 在 任 
意 数 据 库 中 拥有 某 些 东西 的 用 户 不 再 被 删除 。 依赖 关系 追踪 早已 为 数据 库 本 地 对 象 存在 
es 


。 人 允许 受 限制 的 ALTER OWNER 命令 被 对 象 所 有 者 执行 (Stephen Frost) 


以 前 的 版 本 只 允许 超级 用 户 修改 对 象 所 有 者 。 现 在 ， 如 果 执 行 该 命令 的 用 户 拥有 该 对 
象 ， 并 且 可 以 作为 新 的 所 有 者 创建 它 ， 那 么 所 有 权 就 可 以 转移 (也 就 是 说 ， 该 用 户 是 新 
的 拥有 角色 的 一 员 ， 并 且 该 角色 拥有 重新 创建 该 对 象 所 需要 的 CREATE 权 限 ) 。 


。 为 某 些 对 象 类 型 (R, WR. RE) 添加 ALTER 对 象 set scHEMA 能 力 (Bernd Helmle) 
这 人 允许 对 象 迁移 到 不 同 的 模式 中 。 


e 添加 ALTER TABLE ENABLE/DISABLE TRIGGER 禁用 触发 器 (Satoshi Nagayasu) 


E.125.3.5. 工具 命令 的 变化 


e St TRUNCATE 在 一 个 命令 中 截断 多 个 表 (Alvaro) 


由 于 参照 完整 性 检查 ， 不 允许 截断 是 参照 完整 性 约束 的 一 部 分 的 表 。 使 用 这 个 新 功 
BE, TRUNCATE 可 以 用 来 截断 这 个 样 的 表 ， 如 果 两 个 表 都 包含 在 一 个 参照 完整 性 约束 中 ， 


那么 会 在 一 个 TRUNCATE 命令 中 都 被 截断 。 


在 copy csv 模式 中 正确 的 处 理 回 车 和 换行 (Andrew) 


在 版 本 8.0 中 ， csv copy To 中 的 回 车 和 换行 是 以 一 种 不 一 致 的 方式 处 理 的 。 (这 在 
TODO 列 表 中 记录 了。) 


e 添加 copy WITH CSV HEADER ， 人 允许 标题 作为 copy 中 的 第 一 行 (Andrew) 


这 人 允许 处 理 公 共 csv 在 数据 文件 的 第 一 行 放置 字段 名 的 用 法 。 对 于 copy To ， 第 一 行 包 
售 该 字段 和 名， 对 于 copy Fom, 忽略 第 一 行 。 


在 Windows 上 ， 在 EXPLAIN ANALYZE 中 显示 更 好 的 次 秒 级 精度 (Magnus) 


添加 触发 时 间 显 示 到 EXPLAIN ANALYZE 


以 前 的 版 本 包含 触发 器 的 执行 时 间作 为 总 的 执行 时 间 的 一 部 分 ， 但 是 没有 单独 显示 它 。 
现在 有 可 能 看 到 在 每 个 触发 器 中 花费 了 多 少时 间 。 


在 copy 中 添加 对 \x 十 六 进 制 逃逸 的 支持 (Sergey Ten) 

以 前 的 版 本 只 支持 八进制 逃逸 。 

让 sHow ALL 包括 变量 描述 (Matthias Schmidt) 

sow 变量 名 仍然 只 显示 变量 的 值 ， 不 包括 变量 描述 。 

让 initdb 创 建 一 个 新 的 称 为 postgres 的 标准 数据 库 ， 并 转变 工具 为 标准 查询 使 


用 postgres 而 不 是 template1 (Dave) 


在 以 前 的 版 本 中 ， templatea 作为 工具 ( 像 createuser) 的 缺 省 连接 使 用 ， 也 作为 新 数 
据 库 的 模板 。 这 导致 CREATE DATABASE 有 时 会 失败 ， 因 为 如 果 任 何人 连接 了 模板 数据 库 ， 
那么 新 的 数据 库 就 不 能 创建 。 有 了 这 个 改变 ， 缺 省 连接 数据 库 现 在 是 postgres, 意味 
着 在 CREATE DATABASE 期 间 ， 极 少 可 能 有 人 正在 使 用 templatel o 


通过 移动 /contrib/reindexdb 到 服务 器 ， 创建 新 的 reindexdb 命 令 行 工 具 (Euler Taveira 
de Oliveira) 


E.125.3.6. He x Æ Ale Bee % 46 


为 数组 类 型 添加 mAx() 和 MIN() RE (Koju lijima) 


修复 cc 和 YY 字段 都 被 使 用 了 时 ， to_date() 和 to_timestamp() 合理 的 行为 (Karel 
Zak) 


如 果 格 式 声明 包含 cc 并 且 年 的 声明 是 vy 或 更 长 ， 那么 忽略 cc 。 如 果 年 的 声明 
是 YY 或 更 短 ， 那么 解释 cc 为 上 个 世纪 。 


添加 mds(bytea) (Abhijit Menon-Sen) 

md5(text) 早已 存在 了 。 

添加 对 基于 power(numeric，numeric) AY numeric ^ numeric 的 支持 
该 豆 数 早 就 存在 了 ， 但 是 没有 分 配 操 作 符 给 他 。 

通过 正确 的 在 计算 时 截断 商 ， 修 复 numertc 的 模 数 (Bruce) 


在 以 前 的 版 本 中 ， 大 值 的 模 数 有 时 会 因为 商 的 圆 整 返回 负 的 结果 。 
添加 了 一 个 函数 lastval() (Dennis Bjorklund) 


lastval() 是 currval() 的 一 个 简化 版 本 。 它 根 据 当前 会 话 执行 的 最 后 一 
个 nextval() 或 setval() 调用 ， 自 动 的 确定 正确 的 序列 名 。 


添加 了 to_timestamp(DOUBLE PRECISION) (Michael Glaesemann) 

转换 自 1970 年 以 来 的 Unix 秒 到 一 个 TIMESTAMP WITH TIMEZONE 。 

添加 了 pg_postmaster_start_time() 图 数 (Euler Taveira de Oliveira, Matthias Schmidt) 
允许 在 AT TIME zoNE 中 充分 使 用 时 区 名 字 ， 不 只 是 以 前 可 用 的 短 列 表 (Magnus) 


以 前 ， AT TIME zone 只 支持 时 区 名 的 一 个 预定 义 的 列表 。 现在 任何 支持 的 时 区 名 都 可 以 
使 用 ， 例 如 : 


SELECT CURRENT_TIMESTAMP AT TIME ZONE 'Europe/London'; 


在 上 面 的 查询 中 ， 使 用 的 时 区 基于 实际 上 影响 提供 的 日 期 的 夏令 时 规则 调整 。 
添加 GREATEST() 和 LEAST() variadick2X (Pavel Stehule) 

这 些 画 数 接受 可 变数 量 的 参数 并 返回 这 些 参数 的 最 大 或 最 小 值 。 

添加 了 pg_column_size() (Mark Kirkwood) 

这 返回 一 个 字段 的 存储 尺寸 ， 可 能 是 被 压缩 的 


添加 了 regexp_replace() (Atsushi Ogawa) 


si 


这 人 允许 正则 表达 式 蔡 换 ， 像 sed。 一 个 可 选 的 标识 参数 允许 全 局 选择 〈 蔡 换 所 有 ) 和 大 小 
写 敏 感 模式 。 


修复 间隔 除法 和 乘法 (Bruce) 
以 前 的 版 本 有 时 返回 不 正当 的 结果 ， 像 '4 months'::interval / 5 R 


[E] '1 mon -6 days' o 
修复 时 间 戳 、 时 间 和 间隔 输出 中 的 舍 人 行为 (Tom) 
这 修复 了 秒 字段 显示 为 oo 而 不 是 增长 高 阶 字段 的 一 些 情况 。 


添加 一 个 单独 的 天 字段 到 类 型 interval, 这 样 一 天 的 间隔 可 以 不 同 于 24 小 时 的 间隔 
(Michael Glaesemann) 


包含 夏令 时 调整 的 天 不 是 24 小 时 长 ， 通 常 是 23 或 25 小 时 。 这 个 修改 创建 了 一 个 "这 么 多 
天 "的 间隔 和 "这 么 多 小 时 "的 间隔 之 间 概 念 上 的 不 同 。 添加 1 day 到 一 个 时 间 惟 现在 给 出 
和 下 一 天 相同 的 本 地 时 间 ， 即使 丙 天 之 间 有 一 个 夏令 时 调整 ， 而 添加 24 hours 将 给 出 
一 个 不 同 的 本 地 时 间 。 例 如 ， 在 US DST 规 则 下 : 


'2005-04-03 00:00:00-05' + '1 day' = '2005-04-04 00:00:00-04' 
"2005-04-03 00:00:00-05' + '24 hours' = '2005-04-04 01:00:00-04' 


e 添加 了 justify_days() 和 justify_hours() (Michael Glaesemann) 


这 些 函 数 ， 分 别 的 ， 调 整 天 到 一 个 合适 数量 的 全 月 和 日 ， 调整 小 时 到 一 个 合适 数量 的 全 
天 和 小 时 。 


e 移动 /contrib/dbsize 到 后 端 ， 并 重 命名 一 些 范 数 (Dave Page, Andreas Pflug) 
© pg_tablespace_size() 
© pg _database_size() 
o pg_relation_size() 
o pg_total_relation_size() 
© pg_size_pretty() 
pg_total_relation_size() 包括 索引 和 TOAST 表 。 
。 为 访问 集群 目录 的 只 读 文 件 添加 瑞 数 (Dave Page, Andreas Pflug) 
o pg_stat_file() 
o pg_read_file() 
o pg ls_dir() 
e 添加 pg_reload_conf() 强制 配置 文件 的 重 载 (Dave Page, Andreas Pflug) 
e 添加 pg_rotate_logfile() 强制 服务 器 日 志文 件 的 循环 (Dave Page, Andreas Pflug) 


e 修改 pg_stat_* 视图 包含 TOAST 表 (Tom) 


E.125.3.7. 编码 和 环境 的 变化 


命名 一 些 编码 使 其 更 加 一 致 和 遵守 国际 标准 (Bruce) 
© UNICODE 现在 是 UTF8 
o ALT 现在 是 wIN866 


© WIN 现在 是 WIN1251 


o TcvN 现在 是 wIN1258 
原先 的 名 字 仍然 工作 。 
e 添加 对 wIN1252 编码 的 支持 (Roland Volkmann) 
e 添加 对 四 字 节 utes 字符 的 支持 (John Hansen) 
以 前 只 支持 一 、 二 、 三 字 节 ures 字符 。 这 对 于 支持 一 些 汉字 字符 设置 尤其 重要 。 
e cif Euc_ JP 和 suis 之 间 的 直接 转换 ， 以 提高 性 能 (Atsushi Ogawa) 
© 人 允许 UTF8 编 码 在 Windows 上 工作 (Magnus) 


这 是 通过 映射 UTF8 到 Windows 本 地 的 UTF16 实 现 做 到 的 。 
E.125.3.8. 一 般 服 务 器 端 语 言 的 变化 
e 修复 ALTER LANGUAGE RENAME (Sergey Yatskevich) 


。 iF MBAHE, RE RAEI, iit ALTER FUNCTION 来 修改 (Neil) 
。 SNM RM ge ABS EI 100 (Tom) 


Tt i+ SQLAIPL/pgSQLiWZX(FA out 和 Inout 参数 (Tom) 


ouT 是 函数 返回 值 的 一 个 可 替换 的 方式 。 取 代 使 用 return, 可 以 通过 分 配 参数 声明 
为 out 或 mou 来 返回 值 。 这 在 一 些 情况 下 通常 更 简单 ， 尤 其 是 需要 返回 多 个 值 时 。 

从 一 个 函数 中 返回 多 个 值 在 以 前 的 版 本 中 是 可 能 的 ， 这 大 大 的 简化 了 该 过 程 。 (该 特性 
在 未 来 的 版 本 中 将 扩展 为 其 他 服务 器 端 语言 。) 


移动 语言 义理 器 本 数 到 pg_catalog 模式 


如 果 要 求 ， 这 使 得 它 更 容易 删除 公共 模式 。 


添加 sPI_getnspname() 到 SPI (Neil) 


E.125.3.9. PL/pgSQL 服 务 器 端 语言 的 变化 
。 彻底 检查 PL/pgSQL 函 数 的 内 存 管理 (Neil) 


每 个 函数 的 分 析 树 现在 存储 在 一 个 单独 的 内 存 空 间 中 。 当 不 再 需要 它 时 ， 这 人 允许 这 个 内 
存 很 容易 的 回收 利用 。 


e 在 CREATE FUNCTION 时 检查 函数 语法 ， 而 不 是 在 运行 时 (Neil) 
以 前 ， 大 多 数 语法 错误 只 在 该 医 村 数 被 执行 时 报告 。 


e 人 允许 open 打开 非 sELECT 查询， 像 ExPLAIN 和 sHow (Tom) 


。 ABE RAWAM RETUR 语句 (Tom) 


这 是 新 添加 的 out 和 INouT 功能 的 副产品 。 当 不 需要 提供 函数 的 返回 值 时 ， 可 以 省 


略 RETURN o 

e 添加 对 可 选 INTo 子 句 到 PL/pgSQL 的 execute 语句 的 支持 (Pavel Stehule, Neil) 

e 让 CREATE TABLE AS 设置 Row_couNT (Tom) 

e 定义 SQLSTATE 和 SQLERRM 返回 当前 异常 的 sQLsTATE 和 错误 消息 (Pavel Stehule, Neil) 
这 些 变量 只 在 异常 块 中 定义 。 

© 人 允许 到 RAISE 语句 的 参数 为 表达 式 (Pavel Stehule, Neil) 

。 添加 一 个 循环 的 continue 语句 (Pavel Stehule, Neil) 


© 人 允许 块 和 循环 标签 (Pavel Stehule) 


E.125.3.10. PL/Perl 服 务 器 端 语 言 的 变化 
。 人 允许 大 的 结果 集 有 效 的 返回 (Abhijit Menon-Sen) 
这 人 允许 贺 数 使 用 return_next() 来 避免 在 内 存 中 建立 整个 结果 集 。 
© 人 允许 一 次 一 行 检索 查询 结果 (Abhijit Menon-Sen) 
这 人 允许 画 数 使 用 spi_query() 和 spi_fetchrow() 避免 在 内 存 中 累加 整个 结果 集 。 
。 如 果 服 务 器 编码 是 urF8 ， 那 么 强制 PL/Perl 将 字符 串 作为 uTF8 XE (David Kamholz) 
。 为 PL/Perl 添 加 一 个 验证 器 辑 数 (Andrew) 
这 人 允许 语法 错误 在 定义 时 被 报告 ， 而 不 是 在 执行 时 报告 。 
。 当 画 数 返 回 一 个 数组 类 型 时 ， 人 允许 PL/Perl 返 回 一 个 Perl 数 组 (Andrew) 
这 主要 是 映射 PostgreSQL 数 组 到 Perl 数 组 。 
。 人 允许 Perl 非 致命 的 警告 产生 notice 消息 (Andrew) 


e 人 允许 启用 Perl 的 strict 模式 (Andrew) 


E.125.3.11. psql 的 变化 


e 添加 \set ON_ERROR_ROLLBACK 以 允许 事务 中 的 语句 发 生 错 误 而 不 影响 剩余 的 事务 (Greg 
Sabino Mullane) 


这 基本 上 是 通过 包 襄 每 个 语句 在 一 个 子 事务 中 实现 的 。 


在 psql 变 量 中 添加 对 \x 十 六 进 制 字符 串 的 支持 (Bruce) 
八进制 逃逸 早 就 支持 了 。 
。 添加 对 troff -ms 输出 格式 的 支持 (Roger Leigh) 


允许 历史 文件 位 置 通过 HIsTFILE 控制 (Andreas Seltenreich) 
这 人 允许 存储 每 个 数据 库 历史 的 配置 。 
e IE \x (扩展 模式 ) 影响 \d tablename 的 输出 (Neil) 
e 添加 -L 选项 到 psql 以 记录 会 话 (Lorne Sunley) 
添加 这 个 选项 是 因为 一 些 操作 系统 没有 简单 的 命令 行 活动 记录 功能 。 
e 让 \d 显示 索引 的 表 空 间 (Qingqing Zhou) 
e 人 允许 psql 帮 助 ( \h ) 基于 正确 的 帮助 信息 做 一 个 更 好 的 猜测 (Greg Sabino Mullane) 


这 人 允许 用 户 仅仅 添加 \h 到 语法 错误 查询 的 前 面 ， 获 得 支持 的 语法 的 帮助 。 以 前 任何 超 
出 命令 名 的 额外 的 查询 文本 都 必须 使 用 \h 删除 。 


e 添加 \pset numericlocale 以 允许 数字 在 识别 环境 的 格式 中 输出 (Eugen Nedelcu) 


例如 ， 使 用 c 环境 100000 将 被 输出 为 100,000.0, 而 欧洲 环境 可 能 输出 这 个 值 


为 100.000,0 o 
。 当 服 务 器 版 本 号 和 psql 的 版 本 号 不 同时 ， 让 启动 标语 显示 两 者 (Bruce) 
还 有 ， 如 果 服 务 器 和 psql 来 自 不 同 的 主 版 本 ， 那 么 将 会 显示 一 个 警告 。 


E.125.3.12. pg_dump 的 变化 


e 添加 -n / --schema 开关 到 pg _restore (Richard van den Berg) 
这 允许 只 恢复 指定 模式 中 的 对 象 。 
。 人 允许 pg_dump 转 储 大 对 象 ， 即 使 是 在 文本 模式 中 (Tom) 
有 了 这 个 变化 ， 大 对 象 现在 总 是 被 转 储 了 ; 前 者 -b 开关 是 一 个 空 操作 。 
e 人 允许 pg_dump 转 储 大 对 象 的 一 个 一 致 的 快照 (Tom) 
© 为 大 对 象 转 储 的 评论 (Tom) 
e 添加 --encoding 到 pg_dump (Magnus Hagander) 


这 人 允许 数据 库 以 一 个 不 同 于 服务 器 编码 的 编码 转 储 。 这 在 传递 转 储 到 一 个 有 不 同 编码 的 
机 器 时 是 有 价值 的 。 


e 依赖 pg_pltemplate 过 程 语言 (Tom) 


如 果 过 程 语 言 的 调用 义理 器 在 pg_catalog HAH, AApgdump 不 转 储 该 处 理 器 。 相 反 
的 ， 它 使 用 CREATE LANGUAGE `_ name 转 储 该 语言 ， 依 赖 于 pg_pltemplate` 目 录 提 供 语言 的 创 
建 参 数 和 加 载 时 间 。 


E.125.3.13. libpq 的 变化 


e 添加 一 个 PePASSFILE 环境 变量 指定 口 邻 文件 的 文件 名 (Andrew) 
e 添加 lo_create() ， 类 似 于 lo_creat() ， 但 是 允许 指定 大 对 象 的 OID (Tom) 


e 让 libpq 在 malloc() 失败 时 ， 一 致 的 返回 一 个 错误 到 客户 端 应 用 (Neil) 


E.125.3.14. 源 代码 的 变化 
。 修复 pgxs， 以 支持 重 定位 安装 的 建立 
。 为 使 用 Intel 编 译 器 的 ltanium 人 处理 器 添加 自 旋 锁 支持 (Vikram Kalsi) 
。 为 Windows 添 加 Kerberos 5 支持 (Magnus) 
。 添加 了 Chinese FAQ (laser@pgsqldb.com) 
e 重 命 名 Rendezvous 为 Bonjour 以 匹配 OS/X 特 性 重 命名 (Bruce) 
。 在 Darwin 上 添加 对 fsync_writethrough 的 支持 (Chris Campbell) 
。 流 线 化 信息 在 服务 器 、 优 化 器 和 锁 系统 中 的 路 径 (Tom) 
© 人 允许 pg_config 使 用 MSVC 编 译 (Andrew) 
这 在 使 用 MSVC 编 译 DBD::Pg 时 是 需要 的 。 
。 删除 对 Kerberos V4 的 支持 (Magnus) 
Kerberos 4 有 安全 缺陷 并 且 不 再 维护 了 。 
e 代码 清理 (EnterpriseDB 执 行 Coverity 静 态 分 析 ) 
e 修改 postgresql.conf 使 用 文档 缺 省 on/off, 而 不 是 true / false (Bruce) 
e 增强 pg_config， 能 够 报告 更 多 的 构建 时 的 值 (Tom) 
。 人 允许 libpq 在 Windows 上 的 建立 是 线程 安全 的 (Dave Page) 
。 人 允许 IPv6 连 接 在 Windows 上 使 用 (Andrew) 


。 添加 关于 |/O 子 系统 可 靠 性 的 服务 器 管理 文档 (Bruce) 


e 从 gist.h 中 移动 私有 的 声明 到 gist_private.h (Neil) 


在 以 前 的 版 本 中 ， gist.h 包含 公共 的 GiST API (用 来 被 GiST 索 引 实现 的 作者 使 用 ) 和 
一 些 被 GiST 本 身 的 实现 使 用 的 私有 声明 。 后 者 已 经 被 移动 到 一 个 独立 的 文 
件 ， gist_private.h o 大 多 数 GiST 索 引 实现 应 该 是 不 受 影 响 的 。 


。 彻底 检查 GiST 内 存 管理 (Neil) 
GiST 方 法 现在 总 是 在 一 个 短期 存活 的 内 存 空间 中 调用 。 因 此 ， 通 过 palloc() HARD 
配 将 被 自动 回收 利用 ， 所 以 GiST 索 引 实 现 不 需要 通过 pfree() 手动 释放 分 配 的 内 存 。 


E.125.3.15. 贡献 版 的 变化 
e 添加 了 /contrib/pg_buffercache 贡献 版 模板 (Mark Kirkwood) 
这 显示 了 缓冲 区 缓存 的 内 容 ， 为 了 调试 和 性 能 调 优 的 目的 。 
e 删除 了 /contrib/array ， 因 为 它 是 废弃 的 (Tom) 
e 清理 /contrib/lo 模块 (Tom) 
e 移动 /contrib/findoidjoins 到 /src/tools (Tom) 
e 从 /contrib/cube 中 删除 了 alt;alt; 、 &gt;&gt; 、 &&lt; 和 &&gt; 操作 符 
这 些 操作 没什么 用 处 。 
e 改善 /contrib/btree_gist (Janko Richter) 
e 改善 /contrib/pgbench (Tomoaki Sato, Tatsuo) 
现在 有 一 个 设施 测试 用 户 给 出 的 SQL 命令 脚本 ， 而 不 是 只 有 一 个 硬 线 连接 的 命令 序列 。 
e 改善 /contrib/pgcrypto (Marko Kreen) 
o OpenPGP 对 称 秘 钥 和 公共 秘 钥 加 密 的 实现 
RSA 和 Elgamal 公 共 秘 钥 算 法 都 支持 。 
o 独立 构建 : 包括 SHA256/384/512 hashes, Fortuna PRNG 
o OpenSSL 构 建 :支持 3DES， 使 用 内 部 的 AES 带 有 OpenSSL < 0.9.7 
o 从 configure 的 结果 中 获取 构建 参数 (OpenSSL, zlib) 
不 再 需要 编辑 Makefile 。 


o 删除 对 Libmhash 和 libmcrypt 的 支持 


E.126. 版 本 8.0.26 


发 布 日 期 : 2010-10-04 


这 个 版 本 包含 各 种 自 8.0.25 以 来 的 修复 。 关 于 8.0 主 版 本 的 新 特性 信息 ， 请 参阅 Section 
E152: 


这 预计 是 8.0.X 系 列 的 最 后 一 个 PostgreSQL 版 本 。 建议 用 户 尽快 更 新 到 新 版 本 。 


E.126.1. 迁移 到 版 本 8.0.26 


运行 8.0.X 的 用 户 不 需要 转 储 /恢复 。 不 过 ， 如 果 你 是 从 一 个 早 于 8.0.22 的 版 本 升级 而 来 ， 那么 
请 参阅 8.0.22 的 版 本 声明 。 


E.126.2. 修改 列表 


为 每 个 在 PL/Perl 和 PL/Tcl 中 调用 的 SQL userid 使 用 一 个 单独 的 解释 器 (Tom Lane) 


这 个 修改 阻止 由 损坏 另 一 个 SQL 用 户 身份 在 相同 的 会 话 中 稍 后 执行 的 Perl 或 Tcl 代 码 引 起 
的 安全 问题 (例如 ， 在 一 个 sEcuRITY DEFINER MAH) 。 大 多 数 脚本 语言 提供 多 种 方 

式 ， 比如 重 定义 目标 画 数 调 用 的 标准 本 数 或 操作 符 。 如 果 没 有 这 个 修改 ， 任何 拥有 Per| 
或 Tcl 语 言 使 用 权限 的 SQL 用 户 基 本 上 可 以 用 目标 萎 数 的 所 有 者 的 SQL 权 限 做 任何 事情 。 


这 个 修改 的 代价 是 Perl 和 Tcl 东 数 之 间 的 沟通 变 得 更 加 困难 了 。 为 了 提供 一 个 逃逸 出 口 ， 
PL/PerlU 和 PL/TcIU 函 数 继 续 使 用 每 个 会 话 只 有 一 个 解释 器 。 不 认为 这 是 一 个 安全 问题 ， 
因为 所 有 这 样 范 数 的 执行 早已 在 数据 库 超 级 用 户 的 受信 任 级 别 。 


有 可 能 自称 提供 受信 任 的 执行 的 第 三 方 过 程 语言 也 有 相似 的 安全 问题 。 我 们 建议 为 了 安 
全 鉴定 ， 联 系 你 依赖 的 任何 PL 的 作者 。 


感谢 Tim Bunce 指 出 这 个 问题 (CVE-2010-3433)。 


阻止 pg_get_expr() 中 可 能 的 月 浇 ， 通 过 不 人 允许 它 被 非 系 统 目录 字段 的 参数 调用 (Heikki 
Linnakangas, Tom Lane) 


修复 "不 能 处理 未 计划 的 子 查询 "错误 (Tom Lane) 


当 子 查询 包含 一 个 别名 引用 连接 ， 该 引用 连接 扩展 到 一 个 包含 另 一 个 子 查询 的 表达 式 时 
会 发 生 这 个 问题 。 


当 并 非 所 有 返回 的 行 都 是 相同 的 行 类 型 时 ， 防 止 事 数 返 回 一 组 记录 (Tom Lane) 


当 写 fsync 的 锁 文件 内 容 时 ， 要 小 心 ( postmaster.pid 也 是 套 接 字 锁 文件 ) (Tom Lane) 


DOAN ASTEE HIE BARA, BARTMASSRAMANAAA. 随后 会 阻 
止 主 进程 启动 成 功 ， 直 到 手动 删除 锁 文件 。 


当 设 定 XID 为 深度 嵌 套 子 事务 时 ， 避 免 递 归 (Andres Freund, Robert Haas) 

如 果 这 里 限制 堆栈 空间 ， 那 么 原来 的 代码 会 导致 一 个 崩溃 。 

修复 1og_line_prefix 的 %i 逃逸 ， 这 可 能 在 后 台 启 动 时 就 产生 垃圾 (Tom Lane) 
修复 启用 为 档 时 ， ALTER TABLE ... SET TABLESPACE 中 可 能 的 数据 损坏 (Jeff Davis) 


人 允许 CREATE DATABASE 和 ALTER DATABASE ... SET TABLESPACE 被 查询 取消 中 断 (Guillaume 


Lelarge) 


在 PL/Python 中 ， 防 止 从 Pycobject_AsvoidPtr 和 pycobject_Fromvoidptr 中 产生 空 指 针 
(Peter Eisentraut) 


改善 contrib/dblink 对 包含 删除 了 的 字段 的 表 的 钦 理 (Tom Lane) 
修复 contrib/dblink 中 出 现 "重复 的 连接 名 称 " 错误 之 后 的 连接 泄露 (ltagaki Takahiro) 
修复 contrib/dblink ， 正 确 的 义理 连接 名 字 长 于 62 字 节 的 情况 (Itagaki Takahiro) 


更 新 编译 基础 结构 和 文档 ， 以 反映 源 代 码 仓库 从 CVS 搬 到 了 Git (Magnus Hagander and 
others) 


更 新 时 区 数据 文件 到 tzdata 版 本 2010|， 因 为 DST 规 律 在 Egypt 和 Palestine 改 变 了 ; 也 更 
正 了 Finland 的 历史 。 


这 个 改变 也 为 两 个 Micronesian 时 区 添加 了 新 的 名 字 : Pacific/Chuuk 现 在 优先 于 
Pacific/Truk (优先 的 缩写 是 CHUT 不 是 TRUT) ， Pacific/Pohnpei 优 先 于 
Pacific/Ponape. 


E.127. 版 本 8.0.25 


发 布 日 期 : 2010-05-17 


这 个 版 本 包含 各 种 自 8.0.24 以 来 的 修复 。 关 于 8.0 主 版 本 的 新 特性 信息 ， 请 参阅 Section 
E.152。 


PostgreSQL 社 区 将 在 2010 年 7 月 停止 发 放 8.0.X 版 本 系列 的 更 新 。 建议 用 户 尽快 更 新 到 一 个 新 
的 版 本 。 


E.127.1. 迁移 到 版 本 8.0.25 


运行 8.0.X 的 用 户 不 需要 转 储 /恢复 。 不 过 ， 如 果 你 是 从 一 个 早 于 8.0.22 的 版 本 升级 而 来 ， 那么 
请 参阅 8.0.22 的 版 本 声明 。 


E.127.2. 修改 列表 


。 使 用 一 个 开放 标记 应 用 到 整个 解释 器 ， 蔡 代 使 用 safe.pm ， 强制 plperl 中 的 限制 (Tim 
Bunce, Andrew Dunstan) 


最 近 的 发 展 向 我 们 证 实 : 依赖 safe.pm 来 标记 plperl 可 以 信赖 太 不 安全 了 。 这 个 改变 整 
个 删除 了 safe.pm 的 使 用 ， 支持 使 用 一 个 总 是 应 用 开放 代码 标记 的 单独 的 解释 器 。 这 个 
改变 令 人 愉快 的 副作用 包括 : 现在 在 plperl 中 以 普通 方式 使 用 Perl 的 strict 编程 是 可 

能 的 了 ， 并 且 Perl 的 sa 和 so 变量 在 短 例 程 中 像 预期 的 那样 工作 ， 并 且 本 数 编译 明显 的 
更 快 了 。 (CVE-2010-1169) 


e 阻止 PL/Tcl 执 行 pltcl_modules 中 不 受信 任 的 代码 (Tom) 


PL/TcI 自 动 从 数据 库 表 中 加 载 Tcl 代 码 的 特性 可 能 会 被 特洛伊 代码 攻击 利用 ， 因为 没有 谁 
可 以 创建 或 插入 那个 表 的 限制 。 这 个 修改 禁用 了 该 特性 ， 除非 pltcl modules 属于 超级 
AP. (不 过 ， 没 有 对 表 上 的 权限 进行 检查 ， 所 以 实际 需要 一 个 较 小 安全 模块 表 的 安装 
仍然 可 以 获得 合适 的 权限 来 信任 非 超 级 用 户 。) 另外 ， 阻 止 加 载 代 码 到 不 受 限 制 的 " 普 

通 "Tcl 解 释 器 中 ， 除非 我 们 实在 是 想 要 执行 一 个 pltclu WR. (CVE-2010-1170) 


。 不 人 允许 非特 权 用 户 重 置 超级 用 户 人 参数 设置 (Alvaro) 


以 前 ， 如 果 一 个 非特 权 用 户 为 自己 运行 ALTER USER ... RESET ALL, 或 者 为 他 拥有 的 数 
据 库 运行 ALTER DATABASE ... RESET ALL, 会 为 该 用 户 或 该 数据 库 删 除 所 有 特殊 参数 设 
置 ， 即 使 其 中 有 只 支持 超级 用 户 可 改 的 参数 。 现在 ， ALTER 将 只 删除 该 用 户 有 权限 更 改 


如 果 后 端 关 闭 发 生 在 向 日 志 条 目 添加 context 时 ， 避免 后 端 关闭 期 间 可 能 的 崩溃 (Tom) 


目 
在 某 些 情况 下 ， 内 容 输 出 函数 会 失败 ， 因 为 要 输出 一 条 日 志 信 息 时 ， 当 前 事务 早已 回 


Ro 

更 新 pl/perl 的 ppport.h 为 现代 Perl 版 本 (Andrew) 

修复 plpython 中 的 各 种 内 存 泄露 (Andreas Freund, Tom) 

当 展 开 一 个 引用 自身 的 变量 时 ， 阻 止 psql 中 的 无 限 递 (Tom) 

确保 contrib/pgstattuple PHAR AERIS HET (Tatsuhito Kasahara) 

让 服务 器 启动 适当 的 处 理 shmget() 为 一 个 现 有 的 共享 内 存 段 返回 erva 的 情况 (Tom) 


这 个 行为 在 BSD 了 驱动 的 内 核 包 含 OS X 上 观察 到 。 它 导致 一 个 完全 错误 误导 的 启动 失败 ， 
抱怨 共享 内 存 请 求 尺 十 太 大 。 


更 新 时 区 数据 文件 到 tzdata 版 本 2010j， 因 为 DST 规 律 在 Argentina, Australian Antarctic, 
Bangladesh, Mexico, Morocco, Pakistan, Palestine, Russia, Syria, Tunisia 改 变 了 ; 也 为 
Taiwan 做 了 万 史 修 正 。 


E.128. 版 本 8.0.24 


这 个 


发 布 日 期 : 2010-03-15 


版 本 包含 各 种 自 8.0.23 以 来 的 修复 。 关 于 8.0 主 版 本 的 新 特性 信息 ， 请 参阅 Section 


E.152. 


PostgreSQL 社 区 将 在 2010 年 7 月 停止 更 新 8.0.X 版 本 系列 。 鼓励 用 户 尽快 更 新 到 新 的 版 本 。 


E.128.1. 迁移 到 版 本 8.0.24 


运行 8.0.X 的 用 户 不 需要 转 储 /恢复 。 不 过 ， 如 果 你 是 从 一 个 早 于 8.0.22 的 版 本 升级 而 来 ， 那么 
请 参阅 8.0.22 的 版 本 声明 。 


E.128.2. 修改 列表 


添加 新 的 配置 参数 ssl_renegotiation_limit ， 控制 我 们 多 久 做 一 次 SSL 连 接 的 会 话 秘 角 
协商 (Magnus) 


可 以 设置 为 0 来 完全 禁止 协商 ， 如 果 使 用 了 一 个 破碎 的 SSL 库 可 能 需要 这 样 做 。 特别 的 ， 
一 些 供应 商 为 导致 协商 党 试 失败 的 CVE-2009-3555 提 供 了 紧急 补丁 。 


修复 当 党 试 从 子 事务 启动 失败 中 恢复 时 可 能 的 崩溃 (Tom) 
修复 使 用 保存 点 和 客户 端 编码 与 服务 器 编码 不 同时 相关 的 服务 器 内 存 泄露 (Tom) 
让 substring() 的 bit 类 型 对 待 任意 负 的 长 度 为 "所 有 剩余 的 字符 串 " (Tom) 


以 前 的 代码 只 以 这 种 方式 对 待 -1， 并 且 会 为 其 他 负 值 产生 一 个 无 效 的 结果 值 ， 可 能 会 导 
BY ARS (CVE-2010-0442)。 


修复 当 输 出 位 宽度 比 给 定 的 整数 (不 是 8 位 的 倍数 ) HA, integer-to-bit-string 转 换 正 确 
的 处 理 第 一 部 分 的 字 节 (Tom) 


修复 一 些 正 则 表达 式 匹配 慢 的 情况 (Tom) 


修复 各 份 历史 文件 中 的 stop wat Location RAB, 当 结 束 位 置 正好 在 段 边 界 时 报告 下 一 条 
WAL 段 的 名 字 (Itagaki Takahiro) 


当 读 取 pg_hba.conf 和 相关 的 文件 时 ， 如 果 @ 出 现在 双 引 号 中 ， 那么 不 要 
将 @something 当做 文件 包含 请 求 ; 另外 ， 永 不 将 @ 本 身 当 做 文件 包含 请 求 (Tom) 


这 阻止 了 一 个 角色 或 者 数据 库 名 字 以 @ 开头 时 的 奇怪 的 行为 。 如 果 你 需要 包含 一 个 路 径 
名 包含 空格 的 文件 ， 你 也 可 以 这 样 做 ， 但 是 必须 写 @"/path to/file" ， 而 不 是 让 双 引 号 
包围 整个 构造 。 


如 果 一 个 路 径 以 pg_hba.conf 和 相关 文件 中 的 包含 目标 命名 ， 那么 阻止 某 些 平台 上 的 无 
限 循环 (Tom) 


修复 复合 字段 设置 为 NULL 时 的 plpgsql 失 败 (Tom) 

在 PL/Python 中 添加 volatile 标记 ， 以 避免 可 能 的 编译 器 特定 错误 行为 (Zdenek Kotala) 
确保 PL/Tcl 完 全 初始 化 Tcl 解 释 器 (Tom) 

这 个 监督 的 唯一 已 知 症状 是 Tcl clock 命令 在 使 用 Tcl 8.5 或 更 新 时 会 错误 行为 。 


当 指 定 太 多 的 关键 字段 到 dblink_build_sql_* Këta, 阻止 contrib/dblink FAY ARS 
(Rushabh Lathia, Joe Conway) 


修复 粗心 的 内 存 管理 引起 的 contrib/xm12 HAYS PHAR IS (Tom) 


更 新 时 区 文件 到 tzdata 版 本 2010e， 因 为 DST 规 律 在 Bangladesh, Chile, Fiji, Mexico, 
Paraguay, Samoa 发 生 了 变化 。 


E.129. 版 本 8.0.23 


这 个 


发 布 日 期 : 2009-12-14 


版 本 包含 各 种 自 8.0.22 以 来 的 修复 。 关 于 8.0 主 版 本 的 新 特性 信息 ， 请 参阅 Section 


E.152> 


E.129.1. 迁移 到 版 本 8.0.23 


运行 8.0.X 的 用 户 不 需要 转 储 /恢复 。 不 过 ， 如 果 你 是 从 一 个 早 于 8.0.22 的 版 本 升级 而 来 ， 那么 
请 参阅 8.0.22 的 版 本 声明 。 


E.129.2. 修改 列表 


防止 由 素 引 本 数 改变 会 话 本 地 状态 引起 的 间接 安全 风险 (Gurjeet Singh, Tom) 

这 个 修改 阻止 早已 不 变 的 索引 本 数 可 能 破坏 超级 用 户 的 会 话 (CVE-2009-4136)。 
拒绝 SSL 证 书 在 公用 名 (CN) 字段 包含 一 个 能 入 的 空 字 节 (Magnus) 

这 阻止 了 在 SSL 验 证 期 间 无 意识 的 匹配 证 书 到 服务 器 或 客户 端 名 (CVE-2009-4034)。 
修复 后 端 启 动 时 缓存 初始 化 期 间 可 能 的 崩溃 (Tom) 

阻止 信号 在 不 安全 的 时 间 打 断 vacuum (Alvaro) 


这 个 修改 阻止 了 vacuum FULL 在 它 已 经 提交 了 它 的 元 组 移动 之 后 取消 时 的 恐慌 ， 还 有 简 
单 vAcuuM 在 已 经 截断 表 之 后 中 断 时 的 瞬 态 错误 。 


修复 哈 希 表 尺寸 估算 中 由 于 整数 浴 出 引起 的 骨 溃 (Tom) 

这 可 能 在 哈 希 连接 的 结果 有 非常 大 的 规划 器 估算 时 发 生 。 

修复 inet / cidr 比较 中 非常 罕见 的 崩溃 (Chris Mikkelson) 

修复 用 于 在 一 个 子 事务 中 可 以 访问 的 游标 的 临时 文件 过 早 删除 (Heikki) 
修复 PAM 口 令 处 理 ， 使 其 更 加 健壮 (Tom) 


都 知道 以 前 的 代码 未 能 组 合 Linux pam_krbs PAM 模 块 和 Microsoft Active Directory 作为 
域 控 制 器 。 可 能 在 其 他 的 地 方 也 有 问题 ， 因为 它 对 于 将 传递 哪个 PAM 堆 栈 参 数 做 了 不 公 
平 的 假设 。 


修复 PL/Python 中 异常 处 理 时 罕见 的 崩溃 (Peter) 


。 确保 psql 的 flex 模 块 是 用 正确 的 系统 头 定义 编译 的 (Tom) 
这 修复 了 --enable-largefile 导致 在 生成 的 代码 中 有 不 兼容 的 更 改 的 平台 上 编译 失败 的 
问题 。 

。 让 主 进程 忽略 任何 连接 请 求 包 中 的 application_name SM, 以 提升 与 未 来 libpgq 版 本 的 兼 
容 性 (Tom) 


。 更 新 时 区 数据 文件 到 tzdata 版 本 2009s， 因为 DST 规 律 已 经 在 Antarctica, Argentina, 
Bangladesh, Fiji, Novokuznetsk, Pakistan, Palestine, Samoa, Syria% T ; 也 修正 了 
Hong Kong 的 历史 时 间 。 


E.130. 版 本 8.0.22 


发 布 日 期 : 2009-09-09 


这 个 版 本 包含 各 种 自 8.0.21 以 来 的 修复 。 关 于 8.0 主 版 本 的 新 特性 信息 ， 请 参阅 Section 
E152, 


E.130.1. 迁移 到 版 本 8.0.22 


运行 8.0.X 的 用 户 不 需要 转 储 /恢复 。 不 过 ， 如 果 你 在 interval 字段 上 有 任何 哈 希 索引 ， 那么 
必须 在 升级 到 8.0.22 之 后 REINDEX 它们 。 另外 ， 如 果 你 是 从 一 个 早 于 8.0.6 的 版 本 升级 而 来 ， 
那么 请 参阅 8.0.6 的 版 本 声明 。 


E.130.2. 修改 列表 


e 不 允许 RESET ROLE 和 RESET SESSION AUTHORIZATION 在 安全 定义 画 数 内 部 (Tom, Heikki) 


这 包含 了 一 个 在 前 一 个 补丁 中 漏 掉 的 情况 ， 不 允许 SET ROLE 
和 SET SESSION AUTHORIZATION 在 安全 定义 图 数 里 面 。 (参阅 CVE-2007-6600) 


。 修复 出 现在 外 部 级 别 聚 集 画 数 参 数 里 的 子 SELECT 的 处 理 (Tom) 
© 为 数据 类 型 interval 修复 哈 希 计算 (Tom) 


这 纠正 了 哈 希 连接 在 间隔 值 上 的 错误 结果 。 也 改变 了 哈 希 索引 在 间隔 字段 上 的 内 容 。 如 
果 你 有 任何 这 样 的 素 引 ， 你 必须 在 升级 之 后 REINDEX 它们 。 


e 将 to_char(...，'TH') 当做 一 个 带 有 “'HH' / 'HH12' 的 大 写字 母 顺序 后 级 (Heikki) 


以 前 是 作为 'th' (小写) 处 理 的 。 


修复 x 大 于 2 百 万 并 且 使 用 整数 日 期 时 间 时 ， INTERVAL ' x ms' 的 浴 出 (Alex 
Hunsaker) 


修复 点 和 线段 之 间距 离 的 计算 (Tom) 
这 导致 几 个 几何 运算 符 不 正确 的 结果 。 


修复 money 数据 类 型 以 在 货币 数量 没有 小 数 点 的 本 地 环境 下 工作 ， 比如 日 本 (ltagaki 
Takahiro) 


适当 的 圆 整 像 66:12:57.9999999999999999999999999999 这 样 的 日 期 时 间 输 入 (Tom) 


修复 GiST R-tree 操 作 符 类 中 页 分 裂 点 的 选择 很 少 的 问题 (Teodor) 


修复 plperl 初 始 化 中 的 可 移植 性 问题 (Andrew Dunstan) 

修复 如 果 postgresql.conf HZ, pg_ctl 不 要 进入 无 限 循 环 (Jeff Davis) 

修复 contrib/xml2 的 xslt_process() ， 适当 的 处 理 参 数 的 最 大 数量 (twenty) (Tom) 
提高 libpq 代 码 的 鲁 棒 性 ， 以 从 copy FRoM sTDIN 期 间 的 错误 中 恢复 (Tom) 

避免 包括 冲突 的 readline 和 editline 头 文件 ， 当 两 个 库 都 安装 了 时 (Zdenek Kotala) 


更 新 时 区 数据 文件 到 tzdata 版 本 2009I|， 因为 DST 规 律 在 Bangladesh, Egypt, Jordan, 
Pakistan, Argentina/San_Luis, Cuba, Jordan (只 是 历史 纠正 ) , Mauritius, Morocco, 
Palestine, Syria, Tunisia 改 变 了 。 


E.131. 版 本 8.0.21 


发 布 日 期 : 2009-03-16 


这 个 版 本 包含 各 种 自 8.0.20 以 来 的 修复 。 关 于 8.0 主 版 本 的 新 特性 信息 ， 请 参阅 Section 
E.152。 


E.131.1. 迁移 到 版 本 8.0.21 


运行 8.0.X 的 用 户 不 需要 转 储 / 恢 复 。 不 过 ， 如 果 你 是 从 一 个 早 于 8.0.6 的 版 本 升级 而 来 ， 那么 
请 参阅 8.0.6 的 版 本 声明 。 


E.131.2. 修改 列表 


e 当 编 码 转 换 失 几时， 阻止 错误 的 递 及 月 渍 (Tom) 


这 个 修改 扩展 了 在 上 两 个 小 版 本 中 相关 失败 场景 的 修复 。 以 前 的 修复 是 对 于 原始 报告 的 
问题 严密 定做 的 ， 但 是 现在 我 们 意识 到 : 任何 由 编码 转换 函数 抛 出 的 错误 都 可 能 导致 在 
尝试 报告 错误 时 的 无 限 递归 。 因此 如 果 我 们 发 现 我 们 已 经 进入 一 个 递归 的 错误 报告 情景 
中 ， 解决 方法 是 禁用 翻译 和 编码 转换 并 以 纯 ASCII 格 式 报 告 任 何 错误 消息 。 (CVE-2009- 
0922) 

e 不 允许 CREATE CONVERSION 给 指定 的 转换 函数 指定 错误 的 编码 (Heikki) 
这 阻止 了 一 个 编码 转换 失败 的 可 能 的 情形 。 以 前 的 修改 是 防御 相同 情况 中 其 他 类 型 的 失 
败 。 

e 修复 to_char() 给 定 的 格式 代码 不 适合 数据 参数 的 类 型 时 的 内 核 转 储 (Tom) 


e 添加 must (Mauritius Island Summer Time) 到 已 知 时 区 缩写 的 缺 省 列表 (Xavier Bugaud) 


E.132. 版 本 8.0.20 


发 布 日 期 : 2009-02-02 


这 个 版 本 包含 各 种 自 8.0.19 以 来 的 修复 。 关 于 8.0 主 版 本 的 新 特性 信息 ， 请 参阅 Section 
E.152> 


E.132.1. 迁移 到 版 本 8.0.20 


运行 8.0.X 的 用 户 不 需要 转 储 / 恢 复 。 不 过 ， 如 果 你 是 从 一 个 早 于 8.0.6 的 版 本 升级 而 来 ， 那么 
请 参阅 8.0.6 的 版 本 声明 。 


E.132.2. 修改 列表 


。 提高 headline() 画 数 中 URL 的 处 理 (Teodor) 
e 改善 headline() 男 数 中 超 长 标题 的 处 理 (Teodor) 


。 如 果 编 码 转 换 是 用 错误 的 转换 画 数 为 指定 的 编码 对 创建 的 ， 那么 阻止 可 能 的 断言 失败 或 
错误 转换 (Tom, Heikki) 


。 避免 vacuum 中 小 表 的 不 必要 的 锁定 (Heikki) 
e 修复 contrib/tsearch2 的 get_covers() 函数 中 未 初始 化 的 变量 (Teodor) 


e 让 所 有 的 文档 适当 的 引用 pgsql-bugs 和 /或 pgsql-hackers , 代替 现在 停止 使 用 
的 pgsql-ports 和 pgsql-patches 邮件 列表 (Tom) 


e。 更 新 时 区 数据 文件 到 tzdata 版 本 2009a (因为 Kathmandu 和 历史 的 DST 纠 正在 
Switzerland, Cuba) 


E.133. 版 本 8.0.19 


这 个 


发 布 日 期 : 2008-11-03 


版 本 包含 各 种 自 8.0.18 以 来 的 修复 。 关 于 8.0 主 版 本 的 新 特性 信息 ， 请 参阅 Section 


E.152> 


E.133.1. 迁移 到 版 本 8.0.19 


运行 8.0.X 的 用 户 不 需要 转 储 / 恢 复 。 不 过 ， 如 果 你 是 从 一 个 早 于 8.0.6 的 版 本 升级 而 来 ， 那么 
请 参阅 8.0.6 的 版 本 声明 。 


E.133.2. 修改 列表 


修复 客户 端 编码 不 能 表示 本 地 化 的 错误 消息 时 的 后 端 崩溃 (Tom) 


我 们 以 前 也 记录 过 相似 的 问题 ， 但 是 如 果 "character has no equivalent" 消息 本 身 不 能 被 
转换 的 话 仍然 会 失败 。 该 修复 在 检测 到 这 样 的 情形 时 禁用 本 地 化 ， 并 发 送 纯 ASCII 的 错误 
消息 。 


修复 深层 谋 套 函数 从 一 个 触发 器 调用 时 可 能 的 崩溃 (Tom) 
确保 一 个 新 定义 的 PL/pgSQL 触 发 器 范 数 被 作为 一 个 普通 函数 调用 时 报告 一 个 错误 (Tom) 
修复 单个 查询 条 目 匹 配 文 本 的 第 一 个 单词 时 产生 不 正确 的 tsearch2 标 题 (Sushant Sinha) 


修复 在 --enable-integer-datetimes 编译 中 使 用 一 个 非 1SO 的 日 期 风格 时 ， 间 隔 值 中 不 合 
适 的 分 数秒 的 显示 (Ron Mayer) 


确保 传递 的 元 组 和 元 组 描述 符 有 不 同 的 字段 数量 时 ， sPI_getvalue 和 sPI_getbinval 正 
确 的 行为 (Tom) 


当 一 个 表 有 字段 添加 或 删除 时 ， 这 种 情况 是 正常 的 ， 但 是 这 两 个 函数 没有 正确 的 处 理 
它 。 唯一 可 能 的 结果 是 不 正确 的 错误 指示 。 


修复 ecpg 解 析 cREATE user (Michael) 
修复 pg_ctl restart 最 近 的 损坏 (Tom) 


更 新 时 区 数据 文件 到 tzdata 版 本 2008i (因为 DST 规 律 在 Argentina, Brazil, Mauritius， 
Syria 改 变 了 ) 


E.134. 版 本 8.0.18 


发 布 日 期 : 2008-09-22 


这 个 版 本 包含 各 种 自 8.0.17 以 来 的 修复 。 关 于 8.0 主 版 本 的 新 特性 信息 ， 请 参阅 Section 
E152, 


E.134.1. 迁移 到 版 本 8.0.18 


运行 8.0.X 的 用 户 不 需要 转 储 / 恢 复 。 不 过 ， 如 果 你 是 从 一 个 早 于 8.0.6 的 版 本 升级 而 来 ， 那么 
请 参阅 8.0.6 的 版 本 声明 。 


E.134.2. 修改 列表 


。 本 地 锁 计数 器 从 32 扩 大 到 64 位 (Tom) 


这 是 对 于 在 足够 长 的 事务 中 计数 器 会 浴 出 ， 导 致意 外 的 "ock is already held" 错 误 的 报告 
的 回应 。 


。 在 执行 器 启动 中 添加 检查 ， 确 保 Insert 或 UPDATE 产生 的 元 组 将 匹配 目标 表 的 当前 行 类 
型 (Tom) 


ALTER COLUMN TYPE ， 跟 着 以 前 缓存 的 规划 的 重新 使 用 ， 会 产生 这 种 情况 。 检 查 阻 止 了 数 
据 损 坏 和 /或 接着 发 生 的 月 溃 。 


。 修复 日 期 时 间 输 入 函数 ， 以 在 64 位 平台 上 运行 时 正确 的 检测 整数 浴 出 (Tom) 
od 改善 向 系统 日 志 写 入 非常 长 的 日 志 消 息 时 的 性 能 (Tom) 
e 修复 SELECT DISTINCT on 查询 上 后 向 扫描 一 个 游标 中 的 错误 (Tom) 


。 修复 规划 器 估算 croup By 表达 式 ， 不 管 表 达 式 的 内 容 ， 总 是 在 两 个 组 中 生成 布尔 结果 
(Tom) 


这 比 正 规 croup BY 估算 某 些 布尔 测试 ， 像 _col_ Is NULL ， 显 然 更 加 准确 。 


。 修复 PL/Tcl， 使 其 与 Tcl 8.5 正 确 的 行为 ， 并 且 更 加 小 心 关于 发 送 到 或 来 自 Tcl 的 数据 的 编码 
(Tom) 


e 修复 PL/Python， 使 其 与 Python 2.5 一 起 工作 
这 是 在 8.2 开 发 周期 中 做 的 修复 的 后 端 接口 。 


。 改善 在 未 能 发 送 一 个 SQL 命令 之 后 的 pg_dump 和 pg_restore 的 错误 报告 (Tom) 


。 修复 pg_ctl 以 在 restart 时 适当 的 保存 主 进程 命令 行 参数 (Bruce) 


。 更 新 时 区 数据 文件 到 tzdata 版 本 2008f (因为 DST 规 律 在 Argentina, Bahamas, Brazil, 
Mauritius, Morocco, Pakistan, Palestine, 和 Paraguay 改 变 了 ) 


E.135. 版 本 8.0.17 


发 布 日 期 : 2008-06-12 


这 个 版 本 包含 一 系列 对 8.0.16 的 错误 修复 。 关 于 8.0 主 版 本 的 新 特性 信息 ， 请 参阅 Section 
E152, 


E.135.1. 迁移 到 版 本 8.0.17 


运行 8.0.X 的 用 户 不 需要 转 储 / 恢 复 。 不 过 ， 如 果 你 是 从 一 个 早 于 8.0.6 的 版 本 升级 而 来 ， 那么 
请 参阅 8.0.6 的 版 本 声明 。 


E.135.2. 修改 列表 


e 让 pg_get_ruledef() 给 负 的 常数 加 上 括号 (Tom) 


在 这 个 修复 之 前 ， 视 图 或 规则 中 的 一 个 负 的 常量 可 能 被 转 储 为 ， 假 设 -42::integer ， 这 
样 是 不 正确 的 : 它 应 该 为 (-42)::integer ， 因 为 操作 符 的 优先 级 规则 。 通常 这 样 无 关 紧 
要 ， 但 是 它 与 另外 一 个 最 近 的 补丁 相互 影响 ， 导 致 PostgreSQL 拒绝 一 个 佛经 有 效 

的 SELECT DISTINCT 视图 查询 。 因为 这 会 导致 png_dump 输 出 未 能 重 载 ， 因 此 它 被 视 为 高 
优先 级 的 修复 。 转 储 输出 实际 上 不 正确 的 发 布 版 本 是 8.3.1 和 8.2.7。 


E.136. 版 本 8.0.16 


这 个 


发 布 日 期 : never released 


版 本 包含 各 种 自 8.0.15 以 来 的 修复 。 关 于 8.0 主 版 本 的 新 特性 信息 ， 请 参阅 Section 


E.152> 


E.136.1. 迁移 到 版 本 8.0.16 


运行 8.0.X 的 用 户 不 需要 转 储 / 恢 复 。 不 过 ， 如 果 你 是 从 一 个 早 于 8.0.6 的 版 本 升级 而 来 ， 那么 
请 参阅 8.0.6 的 版 本 声明 。 


E.136.2. 修改 列表 


Fi 


修复 ALTER TABLE ADD COLUMN ... PRIMARY KEY, 以 便 新 的 字段 被 正确 的 检查 ， 看 看 是 否 
它 被 初始 化 为 所 有 非 空 (Brendan Jurd) 


以 前 的 版 本 忽略 了 检查 这 个 必要 条 件 。 


修复 从 多 个 来 自 相同 祖先 的 父 关 系 中 继承 "相同 "约束 时 ， 可 能 的 CREATE TABLE 失败 
(Tom) 


修复 ISO-8859-5 和 其 他 编码 之 间 的 转换 ， 以 处 理 Cyrillic "Yo" 字 符 (e Me 带 有 两 个 点 ) 
(Sergey Burladyan) 


修复 一 些 允 许 未 使 用 的 字 节 出 现在 它们 的 结果 中 包含 未 初始 化 的 、 不 可 预计 的 值 的 日 期 
类 型 输入 函数 (Tom) 


这 会 导致 两 个 看 起 来 相同 的 文字 值 不 被 认为 相等 的 失败 ， 导 致 分 析 器 抱怨 不 匹配 的 


ORDER BY 和 DISTINCT 表达 式 。 
修复 正则 表达 式 子 串 匹配 中 的 极端 情况 ( substring(**_string_ from _pattern_ )) (Tom) 


这 个 问题 出 现在 : 有 一 个 到 整个 模式 的 匹配 ， 但 是 用 户 指定 了 一 个 在 括号 中 的 子 表达 
式 ， 并 且 该 子 表达 式 没 有 获得 匹配 的 情况 。 一 个 例子 

是 : substring('foo' from 'foo(bar)?') o 这 应 该 返回 NULL， 因 为 (bar) 没有 匹配 ， 但 
是 它 错误 的 返回 了 整个 模式 匹配 (也 就 是 foo ) 。 


更 新 时 区 数据 文件 到 tzdata 版 本 2008c (因为 DST 规 律 在 Morocco, Iraq, Choibalsan, 
Pakistan, Syria, Cuba, Argentina/San_Luis, 和 Chile 改 变 了 ) 


修复 ecpg 的 pctyPestimestamp_sub() 图 数 中 的 不 正确 的 结果 (Michael) 


修复 输入 查询 返回 一 个 NULL 值 时 ， contrib/xml12 的 xpath_table() PAA AK ES HE 
(Tom) 


修复 contrip/xm12 的 makefile， 以 不 覆盖 cFLAcs (Tom) 
修复 patumGetBool macro, 使 其 不 在 使 用 gcc 4.3 时 失败 (Tom) 


这 个 问题 影响 返回 布尔 值 的 "old style" (VO) CHR, 该 修复 在 8.3 中 就 已 经 有 了 ， 但 是 返 
回 打 补丁 的 需要 在 当时 并 没有 意识 到 。 


修复 长 期 存在 的 LIsTEN / NoTIFY SARE (Tom) 


在 少数 情况 下 ， 一 个 刚刚 执行 了 Listen 的 会 话 可 能 不 会 得 至 
的 ， 因 为 并 发 的 事务 执行 NoTIFY 是 在 提交 后 观察 。 


I 一 个 通知 ， 即使 预计 是 有 


该 修复 的 副作用 是 一 个 执行 了 至 今 未 提交 的 Listen 命令 的 事务 ， 将 不 会 看 到 
该 LISTEN 的 任何 pg_listener 中 的 行 ， 而 它 应 该 选择 查看 的 ; 以 前 的 它 是 查看 的 。 这 个 
行为 从 未 记录 过 ， 但 是 有 可 能 一 些 应 用 依赖 于 老 的 行为 。 


修复 查询 使 用 哈 希 索引 期 间 发 生 错 误 时 的 少见 的 崩溃 (Heikki) 
修复 二 月 29 在 公元 前 的 年 中 的 日 期 时 间 值 的 输入 (Tom) 

中 文 在 此 。。。 

中 文 在 此 。 


o 
o 


中 文 在 此 。 


o 
o 


中 文 在 此 。 
中 文 在 此 。 


o 
o 


o 
o 


中 文 在 此 。 


o 
o 


中 文 在 此 。 


o 
o 


中 文 在 此 。 


o 
o 


中 文 在 此 。 


o 
o 


E.137. 版 本 8.0.15 


发 布 日 期 : 2008-01-07 


这 个 版 本 包含 各 种 自 8.0.14 以 来 的 修复 ， 包 括 对 重大 安全 问题 的 修复 。 关于 8.0 主 版 本 的 新 特 
性 信息 ， 请 参阅 Section E.152。 


中 文 在 此 。。。 


E.137.1. 迁移 到 版 本 8.0.15 


运行 8.0.X 的 用 户 不 需要 转 储 / 恢 复 。 不 过 ， 如 果 你 是 从 一 个 早 于 8.0.6 的 版 本 升级 而 来 ， 那么 
请 参阅 8.0.6 的 版 本 声明 。 


E.137.2. 修改 列表 


。 阻止 索引 中 的 函数 用 用 户 的 权限 执行 vacuum ，ANALYZE 等 (Tom) 


在 索引 表达 式 中 使 用 的 函数 和 局 部 索引 谓词 是 在 制作 一 个 新 的 表 项 时 评估 的 。 一 直 以 来 
认为 ， 如 果 一 个 人 修改 了 属于 不 受信 任用 户 的 表 ， 会 带 来 特洛伊 木马 代码 执行 的 风险 。 
(请 注意 : 触发 器 、 缺 省 、 检 查 约 束 等 ， 构成 相同 类 型 的 风险 。) 但 是 索引 中 的 函数 带 
来 额外 的 风险 ， 因为 它们 将 被 日 常 维护 操作 如 vacuum FuLL 执行 ， 而 日 常 维护 操作 通常 
是 在 超级 用 户 账户 下 自动 执行 的 。 例 如 ， 一 个 不 法 用 户 可 以 通过 设置 特洛伊 木马 索引 定 
义 ， 然 后 等 待 下 一 个 日 常 清理 ， 以 超级 用 户 权 限 执行 代码 。 该 修复 为 标准 的 维护 操作 
(包括 vacuum. ANALYZE 、 REINDEX 和 cLusTER ) 安排 了 作为 表 的 所 有 者 而 不 是 调用 
用 户 执行 ， 相 同 的 权限 切换 机 制 早 已 用 于 sEcURITY DEFINER 阔 数 。 为 了 阻止 绕 过 这 个 安 
全 措施 ， 现在 禁止 在 SECURITY DEFINER 环境 中 执行 

SET SESSION AUTHORIZATION 和 SET ROLE 。 (CVE-2007-6600) 


。 修复 了 正则 表达 式 包 中 的 各 种 bug (Tom, Will Drewry) 


适当 配置 的 正则 表达 式 模式 可 能 会 引起 崩溃 ， 无 限 或 者 接近 无 限 的 循环 ， 和 /或 巨大 的 内 
FA, 所 有 这 些 造成 服务 器 拒绝 接受 来 自 不 可 靠 的 源 的 正则 表达 式 搜索 模式 的 危害 应 
用 (CVE-2007-4769, CVE-2007-4772, CVE-2007-6067) 


。 需要 使 用 /contrib/dblink 的 非 超级 用 户 只 使 用 口令 认证 ， 作 为 一 个 安全 措施 (Joe) 


在 8.0.14 中 出 现 的 这 个 修复 是 不 完整 的 ， 因 为 它 只 堵 住 了 一 些 dblink WRI, 
(CVE-2007-6601, CVE-2007-3278) 


。 更 新 时 区 数据 文件 到 tzdata 版 本 2007k (尤其 是 ， 最 近 的 Argentina 修 改 ) (Tom) 


修复 一 些 wHERE false AND var IN (SELECT ...) 的 规划 器 失败 (Tom) 
保留 ALTER TABLE ... ALTER COLUMN TYPE 重建 的 素 引 的 表 空 间 (Tom) 


让 为 档 恢 复 总 是 启动 一 个 新 的 WAL 时 间 轴 ， 而 不 是 只 在 使 用 恢复 停止 时 间 时 使 用 新 的 时 
间 轴 (Simon) 


这 避免 了 党 试 重 写 一 个 现 有 的 最 后 一 个 WAL 段 的 注 档 拷贝 的 极端 情况 的 风险 ， 并 且 看 起 
来 比 原先 的 定义 更 简单 、 更 干净 。 


当 表 太 小 以 至 于 没什么 用 时 ， 让 vacuum 不 使 用 maintenance_work_mem (Alvaro) 
修复 使 用 多 字 节 数据 库 编码 时 ， translate() 潜在 的 朋 溃 (Tom) 
修复 平台 的 Perl 定 义 类 型 bool 作为 int 而 不 是 char 时 的 PL/Perl 多 理 (Tom) 


虽然 理论 上 会 发 生 在 任何 地 方 ， 但 是 没有 Perl 的 标准 编译 是 这 样 做 的 ... 直 到 Mac OS X 
10.5。 


修复 PL/Python， 使 其 在 长 的 异常 消息 上 不 会 月 淡 (Alvaro) 

修复 pg_dump 以 正确 的 处 理 继 承 的 子 表 和 它们 的 父 表 有 不 同 的 缺 省 表达 式 的 情况 (Tom) 
修复 了 ecpg 分 析 器 (Michael) 

让 contrib/tablefunc 的 crosstab() 作为 一 个 类 义理 空 行 本 身 ， 而 不 是 骨 溃 (Joe) 
修复 tsvector 和 tsquery 输出 例 程 以 正确 的 逃逸 反 斜 杠 (Teodor Bruce) 

修复 to_tsvector() 在 巨大 的 输入 字符 串 上 的 月 淡 (Teodor) 

当 重 新 生成 configure 脚本 时 ， 请 求 一 个 特定 的 Autoconf 版 本 (Peter) 


这 只 影响 开发 者 和 包装 者 。 这 个 修改 是 为 了 阻止 意外 的 使 用 未 测试 的 Autoconf 和 
PostgreSQL 版 本 的 组 合 。 如 果 你 真 的 想 要 使 用 一 个 不 同 的 Autoconf 版 本 ， 你 可 以 删除 
版 本 检查 ， 但 是 结果 如 何 就 是 你 自己 的 责任 了 。 


E.138. 版 本 8.0.14 


发 布 日 期 : 2007-09-17 


这 个 版 本 包含 各 种 自 8.0.13 以 来 的 修复 。 关 于 8.0 主 版 本 的 新 特性 信息 ， 请 参阅 Section 
E152, 


E.138.1. 迁移 到 版 本 8.0.14 


运行 8.0.X 的 用 户 不 需要 转 储 / 恢 复 。 不 过 ， 如 果 你 是 从 一 个 早 于 8.0.6 的 版 本 升级 而 来 ， 那么 
请 参阅 8.0.6 的 版 本 声明 。 


E.138.2. 修改 列表 


。 阻止 事务 插入 行 然后 在 接近 相同 表 中 并 发 的 vacuum 的 结尾 退出 时 的 索引 损坏 (Tom) 


e 让 CREATE DOMAIN ... DEFAULT NULL 正确 的 工作 (Tom) 


修复 过 多 的 记录 SSL 错 误 消 息 (Tom) 


。 修复 日 志 ， 以 便 使 用 系统 日 志 进 程 时 日 志 消 息 从 不 交叉 (Andrew) 


修复 log_min_error_statement H RAXA AAS (Tom) 


修复 一 些 外 键 在 极端 情况 下 不 正确 的 处 理 (Tom) 
e 阻止 cLusTER 由 于 尝试 处 理 其 他 会 话 的 临时 表 而 失败 (Alvaro) 
。 更 新 时 区 数据 库 规 则 ， 尤 其 是 New Zealand 即 将 到 来 的 改变 (Tom) 


Windows 套 接 字 改 善 (Magnus) 


抑制 Windows 上 日 志 时 间 惟 中 的 时 区 名 ( xz )， 因为 可 能 的 编码 错误 匹配 (Tom) 
e 要 求 使 用 /contrib/dblink 的 非 超级 用 户 只 使 用 口令 认证 ， 作 为 一 个 安全 措施 (Joe) 


E.139. 版 本 8.0.13 


发 布 日 期 : 2007-04-23 


这 个 版 本 包含 各 种 自 8.0.12 以 来 的 修复 ， 包 括 一 个 安全 修复 。 关 于 8.0 主 版 本 的 新 特性 信息 ， 
34 BW Section E.152。 


E.139.1. 迁移 到 版 本 8.0.13 


运行 8.0.X 的 用 户 不 需要 转 储 / 恢 复 。 不 过 ， 如 果 你 是 从 一 个 早 于 8.0.6 的 版 本 升级 而 来 ， 那么 
请 参阅 8.0.6 的 版 本 声明 。 


E.139.2. 修改 列表 


e 支持 在 search_path 中 明确 的 布置 临时 表 模 式 ， FARINA EAR (Tom) 


这 需要 人 允许 安全 定义 豆 数 设置 一 个 search_path 的 真正 安全 的 值 。 没有 它 ， 一 个 没有 特 
权 的 SQL 用 户 就 可 以 使 用 临时 对 象 以 安全 定义 函数 的 权限 执行 代码 (CVE-2007-2138)。 
参阅 CREATE FUNCTION 获取 更 多 信息 。 


e /contrib/tsearch2 月 涡 修复 (Teodor) 
。 修复 vacuum FULL 义理 uppate 链 时 潜在 的 数据 损坏 错误 (Tom, Pavan Deolasee) 
。 修复 扩大 哈 希 索引 期 间 的 恐慌 (在 8.0.10 中 引入 的 bug) 


。 修复 POSIX 风 格 规 格 以 遵循 新 的 USA DST 规 则 (Tom) 


E.140. 版 本 8.0.12 


发 布 日 期 : 2007-02-07 


这 个 版 本 包含 各 种 自 8.0.11 以 来 的 修复 。 关 于 8.0 主 版 本 的 新 特性 信息 ， 请 参阅 Section 
E152: 


E.140.1. 迁移 到 版 本 8.0.12 


运行 8.0.X 的 用 户 不 需要 转 储 / 恢 复 。 不 过 ， 如 果 你 是 从 一 个 早 于 8.0.6 的 版 本 升级 而 来 ， 那么 
请 参阅 8.0.6 的 版 本 声明 。 


E.140.2. 修改 列表 


。 删除 约束 和 部 数 素 引 中 过 分 严格 的 类 型 长 度 检查 (Tom) 


E.141. 版 本 8.0.11 


发 布 日 期 : 2007-02-05 


这 个 版 本 包含 各 种 自 8.0.10 以 来 的 修复 ， 包 括 一 个 安全 修复 。 关 于 8.0 主 版 本 的 新 特性 信息 ， 
请 参阅 Section E.152。 


E.141.1. 迁移 到 版 本 8.0.11 


运行 8.0.X 的 用 户 不 需要 转 储 / 恢 复 。 不 过 ， 如 果 你 是 从 一 个 早 于 8.0.6 的 版 本 升级 而 来 ， 那么 
请 参阅 8.0.6 的 版 本 声明 。 


E.141.2. 修改 列表 


。 删除 允许 连接 的 用 户 读 取 后 端 内 存 的 安全 漏洞 (Tom) 


漏洞 包括 抑制 SQL 画 数 返回 它 声明 的 数据 类 型 的 正常 检查 ， 和 改变 表 字 段 的 数据 类 型 
(CVE-2007-0555, CVE-2007-0556)。 这 些 错误 可 以 很 容易 的 被 利用 ， 导致 后 端 朋 溃 ， 并 
且 原 则 上 可 能 被 用 来 读 取 该 用 户 不 能 够 访问 的 数据 库 内 容 。 


。 修复 由 于 选择 一 个 不 可 行 的 分 裂 点 导致 btree 索 引 页 分 裂 可 能 失败 的 少见 的 错误 (Heikki 
Linnakangas) 


e 修复 由 unon 触发 的 少见 的 Assert() 骨 溃 (Tom) 
。 加 强 超过 三 个 字 节 长 度 的 UTF8 序 列 的 多 字 节 字符 处 理 的 安全 (Tom) 


E.142. 版 本 8.0.10 


发 布 日 期 : 2007-01-08 


这 个 版 本 包含 各 种 自 8.0.9 以 来 的 修复 。 关 于 8.0 主 版 本 的 新 特性 信息 ， 请 参阅 Section 
E.152; 


E.142.1. 迁移 到 版 本 8.0.10 


运行 8.0.X 的 用 户 不 需要 转 储 / 恢 复 。 不 过 ， 如 果 你 是 从 一 个 早 于 8.0.6 的 版 本 升级 而 来 ， 那么 
请 参阅 8.0.6 的 版 本 声明 。 


E.142.2. 修改 列表 


e 改善 AIX 上 getaddrinfo() 的 义理 (Tom) 
这 修复 了 在 其 他 事情 上 启动 统计 收集 器 的 问题 。 
。 修复 vacuum 中 "未 能 重新 找到 父 键 "的 错误 (Tom) 
。 修复 通过 vacuum 在 十 亿 字 节 边界 截断 一 个 大 的 关系 的 竞 态 条 件 (Tom) 
。 修复 影响 多 个 十 亿 字 节 哈 希 索 引 的 错误 (Tom) 
。 修复 Windows 信 号 义理 中 可 能 的 死 锁 (Teodor) 


。 修复 构造 一 个 由 多 个 空 元 素 组 成 的 ARRAY[] 时 的 错误 (Tom) 


修复 连接 期 间 ecpg 的 内 存 泄露 (Michael) 


to_number() 和 to_char(numeric) 现在 对 于 新 的 initdb 安 装 来 说 是 STABLE ， 不 
是 IMMUTABLE (Tom) 


这 是 因为 lc_numeric 可 以 潜在 的 改变 这 些 函 数 的 输出 。 


提升 使 用 括号 的 正则 表达 式 的 索引 使 用 (Tom) 


这 也 提升 了 psql \d 的 性 能 。 


更 新 时 区 数据 库 


这 尤其 影响 到 了 Australian 和 Canadian 的 夏令 时 。 


E.143. 版 本 8.0.9 


发 布 日 期 : 2006-10-16 


这 个 版 本 包含 各 种 自 8.0.8 以 来 的 修复 。 关 于 8.0 主 版 本 的 新 特性 信息 ， 请 参阅 Section 
E.152; 


E.143.1. 迁移 到 版 本 8.0.9 


运行 8.0.X 的 用 户 不 需要 转 储 / 恢 复 。 不 过 ， 如 果 你 是 从 一 个 早 于 8.0.6 的 版 本 升级 而 来 ， 那么 
请 参阅 8.0.6 的 版 本 声明 。 


E.143.2. 修改 列表 


。 修复 在 规则 的 WHERE 表达 式 中 引用 new 行 值 时 的 崩溃 (Tom) 
。 修复 无 类 型 的 文字 作为 ANYARRAY 时 的 内 核 转 储 
。 修复 查询 包含 一 个 返回 多 个 行 的 SQL 画 数 时 ，AFTER 触 发 器 的 错误 处 理 (Tom) 
。 修复 ALTER TABLE ... TYPE 以 便 为 USING 子 句 重新 检查 not NULL (Tom) 
e 修复 string_to_array() ， 以 便 为 单独 的 字符 串 处 理 重生 的 匹配 
例如 ， string to array('123xx456xxx789'，'xx') o 
e 为 psql 的 \d 命 邻 修复 模式 匹配 的 极端 情况 
。 修复 /contrib/ltree 中 的 索引 损坏 错误 (Teodor) 
。 修复 ecpg 中 的 很 多 重 棒 性 (Joachim Wieland) 
e 修复 /contrib/dbmirror 中 的 反 斜 杠 逃 逸 
。 修复 Win32 平 台 上 统计 收集 的 稳定 性 (Tom, Andrew) 


。 修复 AIX 和 Intel 编 译 器 (Tom) 


E.144. 版 本 8.0.8 


发 布 日 期 : 2006-05-23 


这 个 版 本 包含 各 种 自 8.0.7 以 来 的 修复 ， 包 括 对 极其 严重 安全 问题 的 修复 。 关于 8.0 主 版 本 的 新 
特性 信息 ， 请 参阅 Section E.152。 


E.144.1. 渤 移 到 版 本 8.0.8 


运行 8.0.X 的 用 户 不 需要 转 储 / 恢 复 。 不 过 ， 如 果 你 是 从 一 个 早 于 8.0.6 的 版 本 升级 而 来 ， 那么 
请 参阅 8.0.6 的 版 本 声明 。 


针对 CVE-2006-2313 中 描述 的 SQL 注 入 攻击 的 完全 安全 和 CVE-2006-2314 可 能 需要 在 应 用 代 
BAKE, MRMRA DARA TRANSFER BSSOLADH, 那么 你 应 该 尽快 检查 他 们 ， 
以 确保 他 们 使 用 的 是 推荐 的 逃逸 技术 。 在 大 多 数 情况 下 ， 应 用 应 该 使 用 库 或 驱动 〈 如 libpq 的 
PQescapeStringConn() ) 提供 的 子 程序 执行 字符 串 逃 逸 ， 而 不 是 依赖 于 ad hoc 代 码 执行 逃 
i. 


E.144.2. 修改 列表 


。 更 改 服务 器 以 拒绝 在 所 有 情况 下 无 效 编码 的 多 字 节 字符 (Tatsuo, Tom) 


PostgreSQL 已 经 朝 这 个 方向 发 展 了 一 段 时 间 了 ， 检查 现在 一 致 的 应 用 到 所 有 编码 和 所 有 
文本 输入 ， 并 且 现 在 总 是 错误 而 不 仅仅 是 警告 。 这 个 修改 防御 了 CVE-2006-2313 中 描述 
的 类 型 的 SQL 注入 攻击 。 


。 拒绝 在 字符 串 文 本 中 不 安全 的 使 用 V 


作为 服务 器 端 防御 CVE-2006-2314 中 描述 的 类 型 的 SQL 注 入 攻击 ， 服务 器 现在 只 接 

受 '' 不 接受 、 作为 SQL 字 符 串 文本 中 ASCll 单 引号 的 表示 。 人 缺 省 的 ， 仪 

当 client_encoding 设置 为 仅 客 户 端的 编码 时 (SJIS, BIG5, GBK, GB18030, 或 UHC), 
拒绝 、' ， 这 是 SQL 注入 有 可 能 会 发 生 的 情况 。 一 个 新 的 配置 参数 backslash_quote 可 以 
用 来 在 需要 时 调整 这 个 行为 。 请 注意 ， 针 对 CVE-2006-2314 的 完全 安全 可 能 需要 客户 端 
侧 的 改变 ; backslash_quote 的 目的 部 分 是 为 了 让 不 安全 的 客户 端 是 不 安全 的 显而易见 。 


修改 libpq 的 字符 串 逃 逸 例 程 ， 意识 到 编码 注意 事项 和 standard_conforming_strings 


这 修复 了 使 用 libpq 的 应 用 在 CVE-2006-2313 和 CVE-2006-2314 中 描述 的 安全 问题 ， 并 且 
也 预防 了 转换 到 SQL 标准 字符 串 文 字 语 法 的 计划 。 使 用 多 个 并 发 的 PostgreSQL 连 接 的 应 
用 应 该 迁移 到 PQescapeStringconn() 和 PQescapeByteaconn() , 以 确保 在 每 个 数据 库 连 接 
中 使 用 的 设置 正确 的 做 了 逃逸 。 "手动 "做 字符 串 逃 逸 的 应 用 应 该 被 修改 为 依赖 库 例 程 。 


修复 一 些 不 正确 的 编码 转换 图 数 


wini251_to_iso , alt_to_iso , euc_ tw to big5 , euc_ tw to _ mic , mic_to_euc_tw 都 中 断 


了 改变 范围 。 

清理 字符 串 中 仅 剩 的 、! 的 使 用 (Bruce, Jan) 

修复 导致 OR'd 索 引 扫 描 有 时 丢失 它们 应 该 返回 的 行 的 bug 
修复 btree 索 引 已 经 被 截断 时 的 WAL 重 放 

为 包含 | 的 模式 修复 SIMILAR To (Tom) 


修复 SELECT INTO 和 CREATE TABLE AS, 以 在 缺 省 表 空 间 中 创建 表 ， 而 不 是 在 基本 目录 中 
(Kris Jurka) 


修复 服务 器 ， 以 正确 的 使 用 自 定义 的 DH SSL 参 数 (Michael Fuhr) 
字符 Intel Macs 中 的 Bonjour (Ashley Clark) 
修复 各 种 小 的 内 存 泄露 


修复 在 一 些 Win32 系 统 上 的 口令 提示 问题 (Robert Kinberg) 


E.145. 版 本 8.0.7 


发 布 日 期 : 2006-02-14 


这 个 版 本 包含 各 种 自 8.0.6 以 来 的 修复 。 关 于 8.0 主 版 本 的 新 特性 信息 ， 请 参阅 Section 
E.152; 


E.145.1. 迁移 到 版 本 8.0.7 


运行 8.0.X 的 用 户 不 需要 转 储 / 恢 复 。 不 过 ， 如 果 你 是 从 一 个 早 于 8.0.6 的 版 本 升级 而 来 ， 那么 
请 参阅 8.0.6 的 版 本 声明 。 


E.145.2. 修改 列表 


e 修复 SET SESSION AUTHORIZATION 中 潜在 的 崩溃 (CVE-2006-0553) 


如 果 服 务 器 已 经 启用 断言 编译 了 〈 这 不 是 缺 省 的 ) ， 那 么 一 个 未 授权 的 用 户 会 导致 服务 
器 进程 骨 溃 ， 导致 临时 拒绝 对 其 他 用 户 的 服务 。 感 谢 Akio lshida 报 告 这 个 问题 。 


。 修复 自动 插入 的 行 中 行 可 见 性 逻辑 的 bug (Tom) 


在 少数 情况 下 ， 一 个 通过 当前 命令 插入 的 行 会 显示 为 早已 有 效 了 ， 而 它 不 应 该 显示 为 这 
样 。 修 复 在 8.0.4、7.4.9 和 7.3.11 版 本 中 创建 的 错误 。 


e 修复 pg_clog 和 pg_subtrans 文 件 创建 期 间 可 能 会 导致 "文件 早已 存在 " 错误 的 竞 态 条 件 
(Tom) 


。 修复 缓存 失效 信息 正好 在 错误 的 时 间 到 达 时 ， 可 能 会 导致 崩溃 的 情况 (Tom) 
© 为 预备 语句 中 的 unknown 参数 适当 的 检查 domain 约束 (Neil) 


e 确保 ALTER COLUMN TYPE 以 正确 的 顺序 处 理 FOREIGN KEY 、 UNIQUE 和 PRIMARY KEY 约束 
(Nakano Yoshihisa) 


。 修复 以 允许 恢复 转 久 有 交叉 模式 引用 自 定义 操作 符 或 操作 符 类 (Tom) 


e 人 多 许 pg_restore 在 copy 失败 之 后 正确 的 继续 ; 以 前 它 尝试 将 剩余 的 copy 数据 当做 SQL 
命令 (Stephen Frost) 


。 当 没 有 指定 数据 目录 时 ， 修 复 pg_ctl unregister AAI (Magnus) 
e 修复 AMD64 和 PPC 上 的 ecpg 朋 溃 (Neil) 


e。 如 果 错 误 发 生 在 PL/python 中 的 参数 传递 期 间 ， 正 确 的 恢复 (Neil) 


($$ PL/perl F#Win32_E AY Kis E, LAP AC etm (Andrew) 


修复 log min messages 设置 为 pesucs 或 在 Win32 上 的 postgresql.conf Pat MAB 
(Bruce) 


e 修复 Win32、Cygwin、OS X、AIX 的 pgxs -L 库 路 径 声明 (Bruce) 
。 当 检 查 Win32 管 理 员 权限 时 检查 是 否 启用 了 SID (Magnus) 

。 适当 的 拒绝 超出 范围 的 日 期 输入 (Kris Jurka) 

。 在 配置 期 间 测 试 finite 和 isinf 的 存在 的 可 移植 性 修复 (Tom) 


E.146. 版 本 8.0.6 


发 布 日 期 : 2006-01-09 


这 个 版 本 包含 各 种 自 8.0.5 以 来 的 修复 。 关 于 8.0 主 版 本 的 新 特性 信息 ， 请 参阅 Section 
E.152; 


E.146.1. 迁移 到 版 本 8.0.6 


运行 8.0.X 的 用 户 不 需要 转 储 /恢复 。 不 过 ， 如 果 你 是 从 一 个 早 于 8.0.3 的 版 本 升级 而 来 ， 那么 
请 参阅 8.0.3 的 版 本 声明 。 另 外 ， 如 果 你 受到 本 地 或 者 下 面 描述 的 plperl 问题 的 影响 ， 你 可 能 
需要 在 升级 之 后 在 文本 字段 上 REINDEX 索引 。 


E.146.2. 修改 列表 
。 修复 Windows 编 码 ， 如 果 在 ShmemBackendArray 中 没有 更 多 的 空间 时 ， 主 进程 将 继续 而 
不 是 退出 (Magnus) 
如 果 过 多 的 连接 请 求 紧密 的 到 达 ， 以 前 的 行为 将 导致 拒绝 服务 的 情况 。 这 只 应 用 到 


Windows 端 口 。 


。 修复 在 8.0 中 引进 的 错误 ， 可 能 允许 ReadBuffer 返 回 一 个 早已 使 用 过 的 页 当做 新 页 ， 潜在 
的 导致 丢失 最 近 提交 的 数据 (Tom) 


。 修复 在 一 个 事务 外 面 或 一 个 失败 的 事务 中 发 出 的 控制 级 别 的 描述 信息 (Tom) 

。 为 认为 不 同 字符 组 合 相 等 的 环境 修复 字符 串 比 较 ， 上 比如 Hungarian (Tom) 
这 可 能 需要 REINDEX 来 修复 在 文本 字段 上 现 有 的 索引 。 

。 在 主 进程 启动 期 间 设 置 本 地 环境 变量 ， 以 确保 plperl 稍 后 不 会 更 改 本 地 环境 


这 修复 了 一 个 postmaster 启 动 时 的 环境 变量 声明 和 initdb 声明 的 不 同时 发 生 的 问题 。 在 这 
个 条 件 下 ， 任 何 对 plperl 的 使 用 都 有 可 能 导致 损坏 索引 。 如 果 你 遇 到 了 这 个 问题 ， 你 可 能 
需要 REINDEX 以 修复 在 文本 字段 上 现 有 的 索引 。 


。 人 多 许 安装 目录 更 灵活 的 重 定位 (Tom) 
以 前 的 版 本 只 在 所 有 安装 目录 路 径 都 相同 (除了 最 后 一 个 组 件 ) 时 ， 才 支持 重 定位 。 


。 修复 strpos() 中 长 期 存在 的 bug 和 在 某 些 很 少 使 用 的 Asian 多 字 节 字符 设置 中 的 正则 表达 式 
处 理 (Tatsuo) 


e 对 返回 RECORD 的 函数 的 各 种 修复 (Tom) 


e 修复 /contrib/pgcrypto gen_salt 中 的 bug， 该 错误 导致 它 没有 为 MD5 和 XDES 算 法 使 用 
所 有 可 用 的 盐 空 间 (Marko Kreen, Solar Designer) 


Blowfish 和 标准 DES 的 盐 没 有 受到 影响 。 


e 修复 /contrib/dblink, 以 在 指定 的 字段 数量 和 查询 实际 返回 的 数量 不 同时 抛 出 一 个 错 
误 ， 而 不 是 骨 溃 (Joe) 


E.147. 版 本 8.0.5 


发 布 日 期 : 2005-12-12 


这 个 版 本 包含 各 种 自 8.0.4 以 来 的 修复 。 关 于 8.0 主 版 本 的 新 特性 信息 ， 2 y Section 
E152, 


E.147.1. 迁移 到 版 本 8.0.5 


运行 8.0.X 的 用 户 不 需要 转 储 /恢复 。 不 过 ， 如 果 你 是 从 一 个 早 于 8.0.3 的 版 本 升级 而 来 ， 那么 
请 参阅 8.0.3 的 版 本 声明 。 


E.147.2. 修改 列表 


修复 事务 日 志 Tine 已 管理 中 的 竞 态 条 件 


有 一 个 狭窄 的 窗口 ，I/O 操 作 可 以 为 错误 的 页 面 初 始 化 ， 导 致 断言 失败 或 数据 损坏 。 
。 修复 从 错误 中 恢复 之 后 的 bgwriter 问 题 (Tom) 


发 现 后 端 写 人 器 在 写 入 错误 之 后 泄露 缓存 针 。 虽然 不 是 致命 的 ， 但 是 可 能 会 导致 稍 后 
VACUUM 命令 奇怪 的 堵塞 。 


阻止 当前 事务 早已 中 止 而 客户 端 发 送 捆绑 的 协议 信息 时 的 失败 


e /contrib/ltree 修复 (Teodor) 


AlIX 和 HPUX 编 译 修复 (Tom) 


e 在 Windows NO_SYSTEM_RESOURCES 错 误 之 后 重新 党 试 文件 读 取 和 写 入 (Qingqing 
Zhou) 


e 修复 log_line_prefix 包含 vi 时 的 间 发 故障 


修复 Windows 上 psql 处 理 长 脚本 时 的 性 能 问题 (Merlin Moncure) 
修复 丢失 的 pg_group 平台 文件 的 更 新 
。 修复 外 连接 中 长 期 存在 的 规划 错误 


这 个 bug 有 时 导致 虚假 的 错误 "RIGHT JOIN 只 被 可 合并 连接 的 连接 条 件 支 持 "。 
推迟 时 区 初始 化 直到 postmaster.pid 创建 之 后 


这 避免 了 混乱 的 启动 脚本 预期 pid 文 件 迅速 出 现 。 


e 当 删 除 一 个 表 时 ， 阻 止 pg_autovacuum 中 的 内 核 转 储 
。 修复 整 行 引 用 ( foo.* ) 子 查询 结果 的 问题 


E.148. 版 本 8.0.4 


发 布 日 期 : 2005-10-04 


这 个 


版 本 包含 各 种 自 8.0.3 以 来 的 修复 。 关 于 8.0 主 版 本 的 新 特性 信息 ， 请 参阅 Section 


E152, 


E.148.1. 迁移 到 版 本 8.0.4 


运行 8.0.X 的 用 户 不 需要 转 储 / 恢 复 。 不 过 ， 如 果 你 是 从 一 个 早 于 8.0.3 的 版 本 升级 而 来 ， 那么 
请 参阅 8.0.3 的 版 本 声明 。 


E.148.2. 修改 列表 


X 


= 


SSH vacuum 删除 ctid 链 太 快 的 错误 ， 并 且 在 跟随 ctid 连接 的 代码 中 添加 更 多 检 


W 


jo 


这 修复 了 在 非常 少 的 情况 下 会 导致 崩溃 的 长 期 存在 的 问题 。 
修复 使 用 多 字 节 字符 设置 时 ， cHAR() 正确 的 填充 空格 到 指定 的 长 度 (Yoshiyuki Asaba) 


在 以 前 的 版 本 中 ， chAR() 的 填充 是 不 正确 的 ， 因为 它 只 填充 到 指定 数量 的 字 节 ， 而 不 考 
虑 存储 多 少 个 字符 。 


在 提交 cREATE DATABASE 之 前 强制 一 个 检查 点 


这 应 该 修复 了 有 崩溃 发 生 在 CREATE DATABASE 之 后 不 久 时 的 最 近 的 "index is not a btree" 失 
败 的 报告 。 


修复 copy 中 的 只 读 事 务 的 意义 上 的 测试 

该 代码 以 前 禁止 copy To ， 而 它 应 该 禁止 copy FROM o 
处 理 copy CSV 模 式 输入 中 连续 冤 入 的 新 行 

为 接近 年 的 结尾 的 日 期 修复 date_trunc(week) 

修复 子 句 上 只 引用 内 侧 关 系 的 外 连接 的 规划 问题 

更 深层 的 修复 x FULL JOIN y ON true 的 极端 情况 
修复 过 分 优化 x IN (SELECT DISTINCT ...) 和 相关 的 情况 


修复 由 于 未 经 深思 熟 虑 "fuzzy" 花 费 比 较 而 使 用 小 的 LiMIT 值 的 查询 的 错误 规划 


让 array_in 和 array_recv 更 偏向 于 验证 它们 的 OID 参 数 
修复 查询 中 丢失 的 行 ， 像 UPDATE a=... WHERE a... with GiST index on column a 
提高 日 期 时 间 分 析 的 鲁 棒 性 

改善 部 分 写 入 WAL 页 的 检查 

提高 启用 SSL 时 的 信号 处 理 的 鲁 棒 性 

改善 MIPS 和 M68K 自 旋 锁 的 代码 

在 主 进程 启动 期 间 不 要 尝试 打开 多 于 max_files_per_process 个 的 文件 
各 种 内 存 泄露 修复 

各 种 可 移植 性 改善 

更 新 时 区 数据 文件 

改善 Windows 上 DDL 加 载 失败 的 处 理 

改善 Windows 上 随机 数 的 生成 

让 psql -f filename 在 打开 文件 失败 时 返回 一 个 非 替 的 退出 代码 

修改 pg_dump 以 更 可 靠 的 处 理 非 继承 的 检查 约束 

修复 Windows 上 pg_restore 中 的 口 命 提示 

修复 PL/ipgSQL， 当 变量 是 通过 引用 传递 类 型 时 ， 正 确 的 处 理 var := var 
修复 PL/Perl %_sHARED ， 以 便 它 实际 上 共享 

修复 contrib/pg_autovacuum ， 以 允许 睡眠 间隔 超过 2000 秒 


更 新 contrib/tsearch2 ， 以 使 用 当前 的 Snowball 代 三 


E.149. 版 本 8.0.3 


发 布 日 期 : 2005-05-09 


这 个 版 本 包含 各 种 自 8.0.2 以 来 的 修复 ， 包 括 几 个 安全 相关 的 问题 。 关于 8.0 主 版 本 的 新 特性 信 
息 ， 请 参阅 Section E.152。 


E.149.1. 迁移 到 版 本 8.0.3 


运行 8.0.X 的 用 户 不 需要 转 储 /恢复 。 不 过 ， 它 是 一 个 处 理 在 8.0.X 系 统 目 录 的 初始 内 容 中 找到 
的 两 个 重要 安全 问题 的 可 能 的 方式 。 使 用 8.0.3 的 initdb 的 dump/initdb/reload 序 列 将 自动 纠正 
这 些 问题 。 


较 大 的 安全 问题 是 内 建 字符 设置 编码 转换 函数 可 以 通过 未 授权 的 用 户 从 SQL 命 命中 调用 ， 但 
是 该 本 数 不 是 设计 来 这 样 使 用 的 ， 并 且 恶 意 选 择 参数 时 时 不 安全 的 。 该 修复 包括 修改 这 些 函 
数 声 明 的 参数 列表 ， 这 样 他 们 可 以 不 再 从 SQL 命令 中 调用 。 (这 不 影响 他 们 通过 编码 转换 机 
制 的 正常 使 用 。) 


较 小 的 问题 是 contrib/tsearch2 模块 创建 了 几 个 错误 的 声明 为 返回 internal 的 函数 ， 而 他 们 
并 不 接受 internal 参数 。 这 破坏 了 所 有 使 用 internal 参数 的 函数 的 类 型 安全 。 


强烈 建议 所 有 安装 修复 这 些 错误 ， 通 过 initdb 或 通过 遵循 下 面 给 出 的 手动 修复 程序 。 该 错误 至 
少 允 许 未 授权 的 数据 库 用 户 骨 溃 他 们 的 服务 器 进程 ， 并 且 可 能 人 允许 未 授权 的 用 户 获得 数据 库 
超级 用 户 的 权限 。 


如 果 你 不 希望 initdb， 执 行 7.4.8 版 本 声明 中 相同 的 手动 修复 程序 。 


E.149.2. 修改 列表 


。 修改 编码 函数 签名 以 阻止 误 用 
e 修改 contrib/tsearch2 s 以 避免 不 安全 的 使 用 INTERNAL 函数 结果 
e 防止 record_out 不 正确 的 第 二 个 参数 


。 修复 古老 的 竞 态 条 件 : 允许 一 个 事务 因为 某 些 目的 (如 SELECT FOR UPDATE) 被 看 做 
比 其 他 目的 提交 的 稍 早 些 


这 是 一 个 极其 严重 的 错误 ， 因 为 它 会 导致 明显 的 数据 不 一 致 短暂 的 被 应 用 可 见 。 


e 修复 关系 扩展 和 VACUUM 之 间 的 竞 态 条 件 


这 理论 上 会 导致 丢失 一 页 最 近 插 入 的 数据 ， 尽 管 这 种 情况 看 起 来 有 非常 小 的 可 能 性 。 
有 已 知 的 情况 导致 超过 一 个 断言 的 失败 。 


修复 TIME WITH TIME ZONE 值 的 比较 


在 使 用 了 --enable-integer-datetimes 配置 开关 的 地 方 ， 该 比较 代码 是 错误 的 。 注意 
果 你 在 TIME WITH TIME ZONE 字段 上 有 一 个 索引 ， 它 将 需要 在 安装 这 个 更 新 之 
后 REINDEX ， 因为 该 修复 纠正 了 字段 值 的 排序 顺序 。 


为 TIME WITH TIME ZONE 值 修复 EXTRACT(EPOCH) 

修复 INTERVAL 值 中 负 的 分 数秒 的 错误 显示 

这 个 错误 只 在 使 用 了 --enable-integer-datetimes 配置 开关 时 发 生 。 
修复 pg_dump 以 正确 的 转 储 包含 % 的 触发 器 名 字 

更 多 contrib/intagg 的 64 位 修复 

阻止 返回 recorp 的 函数 的 不 正确 的 优化 

阻止 在 coALEScE(NULL, NULL) -—EBY ARH 

为 libpq 修 复 Borland makefile 

为 timetz 类 型 修复 contrib/btree_gist (Teodor) 

让 pg ctl 检查 在 postmaster.pid 发 现 的 PID， 看 看 它 是 否 仍然 是 一 个 活动 的 进程 
修复 由 转 储 时 间 玲 的 添加 引起 的 pg_dump / pg_restore 问题 

修复 具体 可 持 有 游标 和 事务 提交 期 间 触 发 延迟 的 处 罚 器 之 间 的 相互 作用 
修复 返回 通过 引用 传递 数据 类 型 的 SQL 画 数 中 的 内 存 泄露 


wal 
/又 


: 如 


E.150. 版 本 8.0.2 


发 布 日 期 : 2005-04-07 


这 个 版 本 包含 各 种 自 8.0.1 以 来 的 修复 。 关 于 8.0 主 版 本 的 新 特性 信息 ， 请 参阅 Section 
E.152; 


E.150.1. 迁移 到 版 本 8.0.2 


运行 8.0.* 的 用 户 不 需要 转 储 / 恢 复 。 这 个 版 本 更 新 PostgreSQL 库 的 主 版 本 号 ， 所 以 如 果 他 们 
不 能 找到 正确 编号 的 共享 库 ， 可 能 需要 重新 连接 一 些 用 户 应 用 。 


E.150.2. 修改 列表 


。 增加 所 有 接口 库 的 主 版 本 号 (Bruce) 


这 应 该 在 8.0.0 中 完成 。 它 需要 7.4.X 版 本 的 PostgreSQL 客 户 端 应 用 ， 像 psql， 可 以 用 在 
和 8.0.X 应 用 相同 的 机 器 上 。 这 可 能 需要 重新 连接 使 用 这 些 库 的 用 户 应 用 。 


e 添加 仅 Windows 的 wal_sync_method 设置 fsync_writethrough (Magnus, Bruce) 


这 个 设置 导致 宇和 WAL 时 PostgreSQL 透 写 任何 磁盘 驱动 的 写 缓存 。 这 个 行为 以 前 称 
为 fsync ， 但 是 已 经 重 命名 了 ， 因为 它 在 其 他 平台 上 表现 的 与 fsync 稍微 有 点 不 同 。 


e 在 Windows 上 启用 wal_sync_method 设置 open_datasync ， 并 让 它 成 为 那个 平台 的 缺 省 
(Magnus, Bruce) 


因为 缺 省 不 再 是 fsync_writethrough ， 如 果 和 磁盘 驱动 启用 了 写 缓 存 ， 那么 在 电源 故障 期 
间 的 数据 丢失 是 有 可 能 的 。 在 Windows 上 要 关闭 写 缓存 ， 从 Device Manager 中 ， 选 择 该 
驱动 属性 ， 然 后 Policies 。 


。 新 增 缓存 管理 算法 2Q 蔡 代 ARC (Tom) 


这 样 做 是 为 了 避免 在 ARC 上 挂 起 US 执照 。 2Q 代 码 比 ARC 对 于 某 些 工作 负载 可 能 有 几 个 
百分点 的 缓慢 。 一 个 更 好 的 缓存 管理 算法 将 在 8.1 中 出 现 。 


。 规划 器 调整 以 改善 自由 创建 的 表 上 的 行为 (Tom) 
。 人 允许 plpgsql 分 配 初 始 为 nur. 的 数组 元 素 (Tom) 


以 前 该 数组 将 保持 NULL ， 但 是 现在 它 变 成 一 个 单元 素数 组 。 在 8.0 中 主要 的 SQL 引擎 改 
变 为 以 这 种 方式 处 理 一 个 空 数组 值 的 uppATE ， 但 是 plpgsql 中 相似 的 情况 则 被 忽视 了 。 


4Eplpython RUA A 444% \r\n 和 \r 为 \n (Michael Fuhr) 
这 阻止 了 plpython 代 码 是 在 Windows 或 Mac 客 户 端 上 写 的 时 的 语法 错误 。 
允许 SPI 游 标 处 理 返回 行 的 工具 命令 ， 比 如 ExPLAIN (Tom) 
修复 ALTER TABLE SET WITHOUT OIDS 之 后 的 cLusTER 失败 (Tom) 
减少 ALTER TABLE ADD COLUMN 的 内 存 使 用 (Neil) 
修复 ALTER LANGUAGE RENAME (Tom) 
记录 仅 Windows 的 pg_ctl 的 register 和 unregister 选项 (Magnus) 
确保 后 端 关 闭 期 间 所 做 的 操作 都 被 统计 收集 器 计数 


这 是 预计 解决 pg_autovacuum 不 够 频繁 的 清理 系统 目录 的 报告 一 没有 告诉 后 端 关闭 期 间 
临时 表 删 除 引 起 的 目录 删除 。 


为 配置 参数 1og_destination 到 eventlog 修改 Windows 缺 省 (Magnus) 


缺 省 的 ， 运 行 在 Windows 上 的 服务 器 现在 将 发 送 日 志 输 出 到 windows 事 件 记 录 器 而 不 是 标 
准 误差 。 


让 Kerberos 认 证 在 Windows 上 工作 (Magnus) 
允许 没有 被 标记 为 拥有 CREATEDB 权 限 的 超级 用 户 ALTER DATABASE RENAME (Tom) 
为 CREATE 和 prop DATABASE 修改 WAL 日 志 条 目 ， 不 指定 绝对 路 径 (Tom) 


这 人 允许 不 同 机 器 上 的 时 间 点 恢复 可 以 有 不 同 的 数据 库 位 置 。 请 注意 
CREATE TABLESPACE 在 这 种 情况 下 仍然 构成 了 风险 。 


修复 后 端 带 有 创建 了 一 个 表 并 且 在 它 上 面 打 开 了 一 个 游标 的 打开 的 事务 退出 时 的 月 渍 
(Tom) 


修复 array_map() ， 这 样 它 可 以 调用 PL 函 数 (Tom) 

几 个 contrib/tsearch2 和 contrib/btree_gist 修复 (Teodor) 
修复 某 些 平台 上 一 些 contrib/pgcrypto WAIA% (Marko Kreen) 

为 64 位 平台 修复 contrib/intagg (Tom) 

修复 解析 cREATE 语句 时 的 ecpg 错 误 (Michael) 

绕 开 在 ecpg 上 导致 问题 的 powerpc 和 amd64 上 的 gcc 错 误 (Christof Petig) 


当 本 地 环境 是 c 时 ， 不 要 使 用 upper() 、 lower() 和 initcap() 的 对 本 地 敏感 的 版 本 


(Bruce) 


RRFRAWAEAM STE c 时 ， 在 为 非 7 位 的 数据 产生 错误 的 平台 上 工作 。 


W 


修复 quote_ident() ， 以 便 给 匹配 关键 字 的 名 字 加 引号 (Tom) 

修复 to_date() ， 以 在 cc 和 YY 字段 都 使 用 了 时 合理 的 行为 (Karel) 
当 给 出 一 个 0 月 的 间隔 时 ， 阻 止 to_char(interval) 失败 (Tom) 

修复 date_trunc('week') 返回 的 错误 星期 

date_trunc('week') 为 一 些 年 份 中 的 一 月 份 的 前 几 天 返回 错误 的 年 份 。 
为 INET 数据 类 型 中 的 类 bp 地 址 使 用 正确 的 缺 省 标记 长 度 (Tom) 


E.151. 版 本 8.0.1 


发 布 日 期 : 2005-01-31 


个 版 本 包含 各 种 自 8.0.0 以 来 的 修复 ， 包 括 几 个 安全 相关 的 问题 。 关于 8.0 主 版 本 的 新 特性 信 
息 ， 请 参阅 Section E.152。 


E.151.1. 迁移 到 版 本 8.0.1 


运行 8.0.0 的 用 户 不 需要 转 储 /恢复 。 


E.151.2. 修改 列表 


© 不 允许 非 超级 用 户 LoAD 


在 平台 上 ， 这 将 自动 执行 一 个 共享 库 的 初始 化 函数 (这 至 少 包 括 Windows 和 基于 ELF 的 
Unix) , Load 可 以 用 来 让 服务 器 执行 任意 的 代码 。 感 谢 NGS Software 报 告 这 个 问题 。 


。 检查 聚集 图 数 的 创建 者 是 否 有 权限 执行 指定 的 转换 男 数 
这 个 跤 忽 使 它 有 可 能 绕 开 函 数 上 的 EXECUTE 权 限 的 拒绝 。 

。 修复 contrib/intagg 中 安全 和 64 位 问题 

。 添加 需要 的 STRICT 标 记 到 某 些 贡献 画 数 (Kris Jurka) 

。 避免 plpgsqI 游 标 声明 有 太 多 的 参数 时 的 缓存 浴 出 (Neil) 

e 让 ALTER TABLE ADD COLUMN 在 所 有 情况 下 都 强制 域 约束 

。 为 FULL 和 RIGHT 外 连接 修复 规划 错误 


连接 的 结果 错误 的 认为 是 和 左 侧 输 入 的 排序 相同 。 这 不 止 会 传递 错误 排序 的 输出 给 用 
户 ， 还 会 在 谋 套 的 合并 连接 情况 下 给 出 完全 错误 的 回复 。 


。 改善 分 组 的 聚集 查询 的 规划 

e ROLLBACK TO _savepoint. 关闭 自 检 查 点 以 来 创建 的 游标 
。 修复 Windows 上 不 合适 的 后 端 栈 大 小 

e 在 Windows 上 避免 SHGetSpecialFolderPath() (Magnus) 


。 修复 作为 一 个 Windows 服 务 运行 pg_autovacuum 时 的 一 些 问 题 (Dave Page) 


e pg_dump/pg_restore 中 的 多 个 小 bug 修 复 


。 修复 用 于 类 型 定义 的 命名 结构 的 ecpg 段 错误 (Michael) 


E.152. 版 本 8.0.0 


发 布 日 期 : 2005-01-19 


E.152.1. 概述 


在 这 个 版 本 中 主要 的 修改 是 : 
Microsoft Windows 本 地 服务 器 


这 是 第 一 个 作为 一 个 服务 器 在 Microsoft Windows® 上 本 地 运行 的 PostgreSQL 版 本 。 它 可 以 
作为 一 个 Windows 服 务 运行 。 这 个 版 本 支持 基于 NT 的 Windows 版 本 ， 像 Windows 2000 
SP4, Windows XP 和 Windows 2003。 老 的 版 本 像 Windows 95, Windows 98 和 Windows 
ME 是 不 支持 的 ， 因为 这 些 操作 系统 没有 支持 PostgreSQL 的 基础 结构 。 已 经 创建 了 一 个 单独 
的 安装 项 目 简化 在 Windows 上 的 安装 一 参阅 http://www.postgresql.org/ftp/win32/。 


尽管 测试 贯穿 了 我 们 的 发 布 周期 ， 但 是 Windows 端 口 并 没有 得 到 多 年 在 生产 环境 中 使 用 的 益 
xs, PostgreSQL 在 Unix 平 台 上 所 拥有 的 。 因此 它 应 该 和 一 个 新 产品 一 样 被 看 做 相同 级 别 的 


以 前 的 版 本 需要 Unix 优 真 工具 箱 Cygwin， 以 便 在 Windows 操 作 系 统 上 运行 服务 器 。 
PostgreSQL 在 Windows 上 支持 本 地 客户 端 已 经 很 多 年 了 。 


检查 点 允许 一 个 事务 的 特定 部 分 在 不 影响 该 事务 剩余 部 分 的 情况 下 中 止 。 以 前 的 版 本 没有 这 
种 能 力 ; 没有 办 法 从 事务 中 的 语句 失败 中 恢复 ， 除了 中 止 整个 事务 。 这 个 特性 对 于 需要 从 复 
条 事务 中 错误 恢复 的 应 用 程序 写 是 有 价值 的 。 


时 间 点 恢复 


在 以 前 的 版 本 中 ， 没 有 办 法 从 磁盘 驱动 的 失败 中 恢复 ， 除了 从 一 个 以 前 的 备份 中 还 原 或 者 使 
用 一 个 各 用 应 用 服务 器 。 时 间 点 恢复 允许 服务 器 的 继续 各 份 。 你 可 以 恢复 到 失败 点 或 者 到 以 
前 的 一 些 事物 。 


表 空 间 


表 空 间 人 允许 管理 员 为 单独 表 、 索 引 和 数据 库 的 存储 选择 不 同 的 文件 系统 。 这 提高 了 性 能 并 且 
控制 了 磁 衣 空间 的 使 用 。 以 前 的 版 本 为 这 样 的 任务 使 用 initlocation 和 人 工 符号 连接 管理 。 


改进 了 缓冲 区 管理 、 CHECKPOINT, VACUUM 


这 个 版 本 有 一 个 更 加 智能 的 缓冲 区 蔡 代 策略 ， 这 将 更 好 的 利用 可 用 的 共享 缓冲 区 和 提高 性 
AE. vacuum 和 检查 点 的 性 能 影响 也 将 减少 。 


更 改 字 段 类 型 
字段 的 数据 类 型 现在 可 以 使 用 ALTER TABLE 来 更 改 。 
新 增 Perl 服 务 器 端 语言 


一 个 新 的 plperl 服 务 器 端 语 言 版 本 现在 支持 一 个 持久 的 共享 存储 区 域 、 触发 器 、 返 回 记录 和 记 
录 的 数组 、 和 SPI 调 用 访问 数据 库 。 


copy 支持 逗号 分 隔 的 值 (CSV) 


copy 现在 可 以 读 取 和 写 入 至 号 分 隔 的 值 的 文件 。 它 也 能 灵活 的 解释 非 标准 的 引用 和 单独 的 
字符 。 


E.152.2. 迁移 到 版 本 8.0.0 


想 要 从 任何 以 前 的 版 本 迁移 数据 的 用 户 需 要 使 用 pg_dump 转 储 /恢复 。 
观察 下 面 的 不 兼容 性 : 


e 在 READ coMMITTED 序列 化 模式 中 ， 不 稳定 的 函数 现在 看 到 并 发 事务 提交 的 结果 一 直到 该 
函数 中 每 个 语句 的 开始 ， 而 不 是 一 直到 调用 该 酚 数 的 交互 命令 的 开始 。 


e 声明 sTABLE 或 IMMUTABLE 的 函数 总 是 使 用 调用 查询 的 快照 ， 并且 因此 看 不 到 在 该 调用 查 
询 开 始 之 后 采取 的 动作 的 影响 ， 不 管 是 在 它们 自己 的 事务 中 还 是 其 他 事务 中 。 这 样 一 个 
Baw aABRith, 意味 着 它 不 能 使 用 任何 SQL 命令 除了 sELECT o 


o 非 延 迟 的 AFTER 触发 器 现在 在 触发 器 查询 完成 之 后 立即 触发 ， 而 不 是 基于 当前 交互 命令 
的 完成 。 这 使 得 触发 器 查询 发 生 在 一 个 画 数 内 部 时 有 所 不 同 : ARR ARTE EY COBY FB 


一 个 操作 之 前 被 调用 。 
° 服务 器 配置 参数 virtual_host 和 tcpip_socket 已 经 用 一 个 更 加 一 般 的 参 


数 listen_addresses RT. 29, 服务 器 现在 缺 省 监听 localhost, 消除 了 在 很 多 情 
节 中 对 -i 参数 开关 的 需要 。 


e 服务 器 配置 参数 sortmem 和 vacuumMem 已 经 被 重 命名 


为 work_mem 和 maintenance_work_mem, 以 更 好 的 反映 它们 的 使 用 。 原 始 的 名 字 在 sET 和 
sHow 中 仍然 支持 。 


e 服务 器 配置 参数 log_pid 、 log_timestamp 和 log_source_port 已 经 用 一 个 更 加 一 般 的 参 
数 log_line_prefix 替代 。 


e 服务 器 配置 参数 syslog 已 经 用 一 个 更 加 合理 的 log destination 变量 替代 ， 以 控制 日 志 
输出 目的 地 。 


服务 器 配置 参数 log statement 已 经 被 改变 了 ， 所 以 它 可 以 有 选择 的 只 记录 数据 库 修 改 
或 数据 定义 语句 。 服务 器 配置 参数 log_duration 现在 只 在 log_statement 输出 该 查询 时 
输出 。 


服务 器 配置 参数 max_expr_depth 已 经 用 max_stack_depth 替换 了 ， max_stack_depth 测量 
物理 堆栈 大 小 ， 而 不 是 表达 式 伐 套 深度 。 这 帮助 了 防止 会 话 由 于 递 为 图 数 引 起 堆栈 渝 出 
而 终止 。 


length() RAAB it CHAR(n) 值 中 的 尾随 空白 。 


转换 一 个 整数 到 BIT(N) ， 选 取 该 整数 的 最 右边 的 N 位 ， 不 是 像 以 前 那样 选择 最 左边 的 N 
位 。 


更 新 一 个 NULL 数 组 值 的 元 素 或 部 分 现在 产生 非 空 的 数组 结果 ， 也 就 是 一 个 数组 只 包含 分 
配 到 的 位 置 。 


数组 输入 值 的 语法 检查 已 经 被 大 大 的 收 紧 了 。 以 前 允许 垃圾 在 一 些 奇怪 的 地 方 带 有 奇怪 
的 结果 ， 现在 导致 一 个 错误 。 空 字符 串 元 素 值 现 在 必须 被 写 为 "" ， 而 不 是 什么 都 不 
写 。 还 改变 了 关于 围绕 着 数组 元 素 的 空格 的 行为 : 现在 忽略 尾随 的 空白 ， 为 了 对 称 带 有 
前 导 的 空白 (也 总 是 被 忽略 ) 。 


现在 检测 整数 算术 操作 符 的 渝 出 并 且 报 告 为 一 个 错误 。 
与 单字 节 "char" 数据 类 型 有 关 的 算术 操作 符 已 经 被 删除 了 。 


extract() PRESI (也 称 为 date_part ) 现在 为 BC 日 期 返回 适当 的 年 份 ， 它 以 前 的 返回 比 
正确 的 年 份 少 一 。 该 函数 现在 也 为 千年 和 世纪 返回 适当 的 值 。 


CIDR 值 现 在 必须 有 它们 的 非 标 记 位 为 0。 例 如 ， 我 们 不 再 允许 204.248.199.1/31 作 
为 CIDR 值 。 这 样 的 值 应 该 决 不 被 PostgreSQL 接 受 并 且 将 是 拒绝 的 。 


EXECUTE 现在 返回 一 个 完成 标签 匹配 执行 的 语句 。 


psql 的 \copy 命 合 现 在 读 取 或 写 入 到 查询 的 stdin/stdout ， 而 不 是 psql 
的 stdin/stdout 。 以 前 的 行为 可 以 通过 新 的 pstdin / pstdout 参数 访问 。 


JDBC 客 户 端 接口 已 经 从 内 核 分 配 中 删除 ， 现在 托管 在 http://jdbc.postgresql.org。 
Tcl 客 户 端 接口 也 被 删除 了 。 有 几 个 Tcl 接 口 现 在 托管 在 http://gborg.postgresql.org。 


服务 器 现在 使 用 它 自己 的 时 区 数据 库 ， 而 不 是 操作 系统 提供 的 那个 。 这 将 在 所 有 平台 
提供 一 致 的 行为 。 在 大 多 数 情况 下 ， 这 频 该 在 时 区 行为 上 没有 明显 的 不 同 ， 除 

了 set / SHOW Timezone 使 用 的 时 区 名 可 能 与 您 的 平台 提供 的 不 同 。 

Configure 的 线程 选项 不 再 需要 用 户 运行 测试 或 编辑 配置 文件 ; 线程 选项 现在 是 自动 检测 
的 。 


请 注意 ， 表 空间 已 经 实现 ，initlocation 已 经 被 删除 。 


。 A PELANGISTREINAPIGARAE T. Union 和 PickSplit 方 法 现在 传递 一 个 指针 到 一 
个 特殊 GistEntryvector 结构 ， 而 不 是 bytea 。 


E.152.3. 废弃 的 特性 

PostgreSQL 行 为 的 一 些 方面 已 经 被 认定 为 是 次 优 的 。 为 了 向 后 兼容 ， 这 些 在 8.0 中 还 没有 被 
删除 ， 但 是 他 们 已 经 被 认为 是 废 奔 的 ， 并 且 将 在 下 一 个 主 版 本 中 删除 。 

o 8.1 版 本 将 为 间隔 删除 to_char() HESA 


e 服务 器 现在 警告 传递 到 oid / float4 / floats 数据 类 型 的 空 字符 串 ， 但 是 仍然 像 以 前 一 
样 将 它们 解释 为 0。 在 下 一 个 主 版 本 中 ， 这 些 数据 类 型 的 空 字 符 串 将 被 认为 是 无 效 的 输 
Ao 


e 缺 省 的 ， 在 PostgreSQL 8.0 和 以 前 的 版 本 中 表 是 带 有 om 创建 的 。 在 下 一 个 版 本 中 ， 闻 
会 是 这 样 情况 了 : 要 创建 一 个 包含 orp 的 表 ， 必 须 指定 wi oms FH, 或 者 必须 设 
置 default_with_oids 配置 人 参数。 如 果 用 户 的 表 需 要 OID 与 PostgreSQL 的 未 来 版 本 兼 
容 ， 那么 鼓励 用 户 明确 的 指定 WITH ors o 


E.152.4. 修改 列表 


下 面 你 将 看 到 一 个 版 本 8.0 和 以 前 的 主 版 本 之 间 的 修改 的 清单 。 


E.152.4.1. 性 能 提升 
。 支持 交叉 数据 类 型 索引 的 使 用 (Tom) 


在 这 个 修改 以 前 ， 如 果 数 据 类 型 不 正好 匹配 那么 许多 查询 不 使 用 索引 。 这 次 改进 使 得 索 
引 的 使 用 更 加 直观 和 一 致 。 


。 新 的 提高 缓存 的 缓冲 区 置换 策略 (Jan) 


以 前 的 版 本 使 用 一 个 最 近 最 少 使 用 的 (LRU) 缓 存在 内 存 中 保存 最 近 引 用 的 页 面 。 LRU 算 
法 不 考虑 一 个 特定 缓存 条 目 被 访问 的 次 数 ， 所 以 大 表 扫 描 可 能 会 占用 有 用 的 缓存 页 面 。 
新 的 缓存 算法 使 用 四 个 单独 的 列表 追踪 最 近 使 用 的 和 最 频繁 使 用 的 缓存 页 面 ， 并 且 动 态 
的 基于 工作 负载 优化 他 们 的 蔡 换 。 这 会 导致 更 加 有 效 的 使 用 共享 的 缓冲 区 缓存 。 在 以 前 
测试 过 共享 缓冲 区 大 小 的 管理 员 应 该 用 这 个 新 的 缓存 著 换 策略 重新 测试 。 


。 添加 子 进程 定期 的 写 脏 的 缓冲 区 ， 以 减少 检查 点 的 写 入 (Jan) 
在 以 前 的 版 本 中 ， 检 查 点 进程 ， 每 几 分 钟 运行 一 次 ， 将 所 有 的 脏 缓冲 区 写 到 操作 系统 的 


缓冲 区 缓存 ， 然 后 刷新 所 有 脏 的 操作 系统 缓冲 区 到 磁盘 。 SERS RATER 
高 峰 经 常 伤害 性 能 。 新 的 代码 使 用 一 个 后 端 书写 器 以 一 个 平稳 的 速度 慢 慢 的 磁盘 宇和 人 ， 


这 样 检查 点 有 少 得 多 的 脏 页 面 写 人 到 磁盘 。 另外， 新 的 代码 不 发 出 一 个 全 局 的 sync() 调 
H, BÆR fsync() 自 最 后 一 个 检查 点 以 来 的 文件 写 人 。 这 会 提高 性 能 并 最 小 化 检查 点 
期 间 的 降级 。 


添加 延长 vacuum 以 减少 性 能 影响 的 能 力 (Jan) 


ENC ERB MHL, vacuum 执行 许多 IO 请 求 ， 这 会 影响 其 他 用 户 的 性 能 。 这 个 版 本 允许 
你 放 缓 vacuum 的 速度 以 减少 它 对 其 他 用 户 的 影响 ， 虽 然 这 样 会 增加 vacuum 的 总 的 存续 
时 间 。 


为 重复 的 键 提高 B-tree 索 引 性 能 (Dmitry Tkach, Tom) 
当 许 多 重复 的 值 存在 于 索引 当中 时 ， 这 改进 了 扫描 索引 的 方式 。 
在 规划 时 使 用 动态 生成 的 表 大 小 估计 (Tom) 


以 前 规划 器 估算 表 的 大 小 使 用 最 后 一 个 vacuum 或 ANALYzE 看 到 的 值 ， 都 是 关于 物理 表 大 
小 (页 数 ) 和 行 数 。 现在 ， 当 前 物理 表 大 小 从 内 核 中 获得 ， ee 

一 个 vacuum 或 analyze 看 到 的 行 密度 (每 页 的 行 数 ) 估计 的 。 这 会 产生 更 加 可 靠 的 估 

it, NOR eRe ee 


FA or 子 句 提 高 素 引 的 使 用 (Tom) 


这 多 许 优 化 器 在 语句 中 使 用 索引 ， 带 有 许多 过 去 没有 被 索引 的 OR 子 句 。 也 可 以 在 第 一 个 
字段 是 指定 的 、 第 二 个 字段 是 一 个 oR 子 句 的 一 部 分 的 地 方 使 用 多 字段 素 引 。 


提高 部 分 素 引 子 句 的 匹配 (Tom) 
服务 器 现在 在 包含 复杂 wHERE 子 句 的 查询 中 使 用 部 分 索引 更 加 智能 。 
提高 GEQO 优 化 器 的 性 能 (Tom) 


GEQO 优 化 器 用 来 规划 包含 许多 表 (〈 缺 省 的 ，12 个 或 更 多 ) 的 查询 。 这 个 版 本 加 速 了 分 
析 查 询 的 方式 ， 以 减少 花费 在 优化 上 的 时 间 。 


其 他 优化 器 改进 
里 没有 列 出 所 有 小 的 改进 ， 但 是 很 多 特殊 情况 比 以 前 的 版 本 运行 的 更 好 了 。 
提高 C 函 数 的 查找 速度 (Tom) 


个 版 本 为 动态 加 载 的 C 男 数 使 用 一 个 哈 希 表 查 找 信 息 。 这 提高 了 它们 的 速度 ， 所 以 它 
Rae rapa THA HR — HFK. 


添加 类 型 特定 的 ANALYzE 统计 能 力 (Mark Cave-Ayland) 
这 个 特性 允许 在 为 非 标准 的 数据 类 型 产生 统计 信息 时 有 更 大 的 灵活 性 。 
ANALYZE 现在 为 表达 式 素 引 收集 统计 信息 (Tom) 


FGA WSS] (也 称 作 功能 性 索引 ) RHA PTRRERSIFR, 2A RAAH RNR 
调用 。 用 这 个 版 本 ， 优 化 器 可 以 收集 和 使 用 关于 表达 式 索 引 内 容 的 统计 信息 。 这 可 以 大 
大 的 提高 表达 式 索 引 相 关 的 查询 的 规划 的 质量 。 


e 为 ANALYZE 新 增 两 阶段 抽样 方法 (Manfred Koizar) 
当 有 效 行 的 密度 与 表 的 不 同 区 域 的 密度 非常 不 同时 ， 这 给 出 了 更 好 的 统计 。 
e 加 速 TRUNCATE (Tom) 


这 找 回 了 一 些 在 7.4 中 观察 到 的 性 能 去 失 ， 而 仍然 保持 TRUNCATE 事务 安全 。 


E.152.4.2. 服务 器 的 变化 
。 添加 WAL 文 件 为 档 和 时 间 点 恢复 (Simon Riggs) 
。 添加 表 空间 ， 这 样 管理 员 可 以 控制 磁盘 布局 (Gavin) 
。 添加 一 个 内 建 的 日 志 循环 程序 (Andreas Pflug) 
现在 可 以 不 用 依赖 于 syslog 或 外 部 日 志 循环 程序 就 可 以 方便 的 记录 服务 器 信息 了 。 
。 添加 新 的 只 读 服务 器 配置 参数 以 显示 服务 器 兼容 的 时 间 设 置 : 


block_size 、 integer_datetimes 、 max_function_args 、 


max_identifier_length 、 max_index_keys (Joe) 


e 让 sameuser 、 samegroup 和 all 的 引用 删除 pg_hba.conf 中 这 些 术 语 的 特殊 含义 
(Andrew) 


。 在 缺 省 的 pg_hba.conf 中 为 localhost 使 用 更 加 清楚 的 IPv6 名 字 : :1/128 (Andrew) 
。 在 pg_hba.conf 示例 中 使 用 CIDR 格 式 (Andrew) 


e 重 命 名 服务 器 配置 参数 SortMem 和 VacuumMem 为 work_mem 和 maintenance_work_mem UD 
然 支持 老 的 名 字 ) (Tom) 


这 个 修改 是 用 来 弄 清 楚 批 量 操作 ， 比 如 用 maintenance_work_mem 创建 的 索引 和 外 键 ， 
而 work_mem 是 在 查询 执行 期 间 使 用 的 工作 空间 。 


° 允许 使 用 服务 器 配置 log_disconnections 记录 会 话 断 开 (Andrew) 


e 添加 新 的 服务 器 配置 参数 log_line_prefix , 以 允许 控制 在 每 个 日 志 行 里 发 出 的 信息 
(Andrew) 


可 用 的 信息 包括 用 户 名 、 数 据 库 名 、 远 程 IP 地 址 和 会 话 启 动 时 间 。 


@ 删除 服务 器 配置 参数 log_pid ~ log_timestamp 、 log_source_port ; 功能 性 上 
被 log_line_prefix 取代 (Andrew) 


e 用 一 个 统一 的 listen_addresses 参数 替代 virtual_host 和 tcpip_socket 参数 (Andrew, 
Tom) 


virtual_host 只 能 指定 要 监听 的 单个 IP 地 址 。 1listen_addresses 人 允许 指定 多 个 地 址 。 


默认 监听 localhost， 减 少 了 在 很 多 情况 下 对 -i 主 进程 开关 的 需要 (Andrew) 


监听 localhost ( 127.0.0.1 ) 不 会 打开 新 的 安全 漏洞 ， 但 是 允许 像 Windows 和 JDBC 那 样 配 
置 ， 不 支持 本 地 套 接 字 ， 不 用 特殊 的 调整 就 能 工作 。 


删除 syslog 服务 器 配置 参数 ， 并 且 添 加 更 多 逻辑 的 log_destination 变量 来 控制 日 志 输 
出 位 置 (Magnus) 


修改 服务 器 配置 参数 log statement 接受 值 all 、 mod. ddl 或 none ， 以 便 选 择 记 录 
哪 条 查询 (Bruce) 


这 人 允许 管理 员 只 记录 数据 定义 修改 或 只 记录 数据 修改 语句 。 


。 一 些 日 志 相关 的 配置 参数 以 前 可 以 通过 普通 用 户 调整 ， 但 是 只 能 是 在 "更 详细 的 "方向 。 
现在 对 待 它 们 更 加 严格 了 : 只 有 超级 用 户 可 以 设置 它们 。 不 过 ， 超级 用 户 可 以 使 
用 acter user 为 非 超 级 用 户 提供 这 些 值 的 每 用 户 设置 。 还 有 ， 现 在 超级 用 户 可 以 通 
过 PGOPTIONS 设置 仅 超级 用 户 的 配置 参数 值 了 。 


允许 配置 文件 放 在 数据 目录 的 外 面 (mlw) 


缺 省 的 ， 配 置 文件 保存 在 集群 的 顶级 目录 中 。 有 了 这 个 添加 ， 配置 文件 可 以 放置 在 该 数 
据 目 录 的 外 面 ， 宽 松 了 管理 。 


。 只 有 在 第 一 次 执行 常量 可 以 用 于 统计 时 计划 预备 查询 (Oliver Jowett) 


预备 语句 规划 查询 一 次 执行 多 次 。 虽 然 预备 查询 避免 了 每 次 使 用 时 重新 规划 的 开支 ， 但 
是 规划 的 质量 不 知道 在 该 查询 中 要 使 用 的 准确 参数 。 在 这 个 版 本 中 ， 未 命名 的 预备 语句 
的 规划 被 推迟 直到 第 一 次 执行 ， 执 行 的 实际 参数 值 用 作 优 化 提示 。 这 人 允许 使 用 行 外 传递 
参数 ， 而 不 会 导致 性 能 损失 。 


e JÙ} DECLARE CURSOR 接受 参数 (Oliver Jowett) 


在 parse 消息 中 用 参数 发 出 DECLARE cURSOR 现在 是 有 用 的 。 在 Bind 时 发 送 参数 值 将 被 
取代 为 游标 查询 的 执行 。 


修复 inet 和 cidr 数据 类 型 的 哈 希 连接 和 聚集 (Tom) 


版 本 7.4 正 确 的 处 理 了 混合 inet 和 cidr 值 的 哈 希 。 (这 个 bug 在 以 前 的 版 本 中 不 存在 ， 
因为 他 们 不 会 尝试 哈 希 任何 一 个 数据 类 型 。) 


e 让 log_duration 只 在 1og_statement 输出 查询 时 输出 (Ed L.) 


E.152.4.3. 查询 的 变化 


添加 了 保存 点 (RENEZ) (Alvaro) 
现在 接受 不 支持 的 隔离 级 别 了 并 且 提 升 为 最 近 支 持 的 级 别 (Peter) 


SQL 规 范 声明 如 果 一 个 数据 库 不 支持 一 个 特定 的 隔离 级 别 ， 它 应 该 使 用 下 一 个 更 加 限制 
的 级 别 。 这 个 修改 符合 那个 建议 。 


人 允许 BEGIN WORK 像 START TRANSACTION 那样 指定 事务 隔离 级 别 (Bruce) 
修复 规则 产生 的 查询 类 型 和 原始 提交 的 查询 类 型 不 同时 的 表 的 权限 检查 (Tom) 
实现 美元 的 引用 以 简化 单 引号 的 使 用 (Andrew, Tom, David Fetter) 


在 以 前 的 版 本 中 ， 因 为 单 引 号 必须 被 用 来 引用 一 个 函数 体 ， 在 函数 文本 的 内 部 使 用 单 引 
号 需要 使 用 两 个 单 引 号 或 其 他 易于 出 错 的 符号 。 和 我 们 添加 了 使 用 “美元 引 
用 "来 引用 一 个 文本 块 的 能 力 。 在 不 同 的 族 套 界 别 使 用 不 同 的 引用 分 隔 符 的 能 力 大 大 的 简 
化 了 恰当 引用 的 工作 ， 尤其 是 在 复 条 的 画 数 中 。 美 元 引用 可 以 用 在 任何 需要 引用 文本 的 
地 方 。 


让 CASE val WHEN compval1 THEN ... 只 评估 val 一 次 (Tom) 

CASE 不 再 多 次 评估 测试 的 表达 式 。 这 在 表达 式 是 复杂 的 或 不 稳定 时 有 益 。 
在 计算 一 个 聚集 查询 的 目标 列表 之 前 测试 HAvING (Tom) 

修复 不 正确 的 失败 案例 ， 


如 SELECT SUM(win)/SUM(lose) ... GROUP BY ... HAVING SUM(lose) &gt; 9 。 这 应 该 能 工作 


(ASL TRS ARS RM AM. 
FA max_stack_depth 参数 替换 max_expr_depth BA, 以 堆栈 大 小 的 千 字 节 测 量 (Tom) 


这 给 出 了 一 个 相当 严密 的 防御 ， 针 对 由 于 逃逸 递 为 画 数 引起 的 月 演 。 RE We Rid HK 
套 的 深度 ， 我 们 现在 直接 测量 执 steal 


允许 任意 行 的 表达 式 (Tom) 


这 个 版 本 人 允许 SQL 表达 式 包 含 任意 的 符合 类 型 ， 也 就 是 说 ， 行 值 。 也 人 允许 图 数 更 容易 的 
接受 行 作为 参数 和 返回 行 值 。 


人 允许 LIKE / ILIKE 在 行 和 子 查 询 比较 中 用 作 操 作 符 (Fabien Coelho) 
避免 特定 于 语言 环境 的 情况 下 在 标识 符 和 关键 字 中 转换 基本 的 ASCII 字 符 (Tom) 


这 解决 了 单词 包含 1 和 i 的 识别 编码 的 "Turkish 问题 "。 在 7 位 ASCII 设 置 之 外 折 秋 字符 
仍然 是 环境 敏感 的 。 


改进 语 法 错误 报告 (Fabien, Tom) 


语法 错误 报告 比 以 前 更 加 有 用 。 


修改 execute ， 返 回 一 个 完成 标签 匹配 执行 语句 (Kris Jurka) 


以 前 的 版 本 为 任何 execute 调用 返回 一 个 execute 标签 。 在 这 个 版 本 中 ， 返 回 的 标签 将 
反应 执行 的 命令 。 


避免 在 规则 列表 中 发 出 NATURAL cRoss JoIN (Tom) 


这 样 一 个 条 款 在 逻辑 上 说 不 通 ， 但 是 在 某 些 情况 下 该 规则 反 编译 以 前 生成 的 这 种 语法 。 


E.152.4.4. 对 象 操作 的 变化 


为 cast、 转 换 、 语 言 、 操 作 符 类 和 大 对 象 添 加 comment on (Christopher) 
添加 新 的 服务 器 配置 参数 default_with_oids ， 控制 表 缺 省 是 不 是 带 有 om 创建 (Neil) 


这 人 允许 管理 员 控 制 CREATE TABLE 命令 缺 省 是 否 带 有 op 字段 创建 表 。 (注意 : 目 
前 default_with_oids 的 出 厂 默认 设置 是 true, 但 是 该 缺 省 将 在 将 来 的 版 本 中 变 
PÈ FALSE o ) 


添加 WITH / wITHOUT oros 子 名 到 cREATE TABLE Aas (Neil) 


人 允许 ALTER TABLE DROP COLUMN 删除 orp 字段 ( ALTER TABLE SET WITHOUT oIDs 仍然 工 


VE) (Tom) 
允许 复合 类 型 作为 表 字 段 (Tom) 
允许 ALTER ... ADD COLUMN 带 有 缺 省 和 not NULL 约束 ; 在 每 个 SQL 规范 上 工作 (Rod) 


ADD COLUMN 创建 一 个 最 初 不 是 填充 为 NULL 的 字段 现在 是 可 能 的 了 ， 但 是 会 带 有 一 个 指 
定 的 缺 省 值 。 


添加 ALTER COLUMN TYPE 改变 字段 的 类 型 (Rod) 
现在 不 用 删除 然后 重新 添加 该 字段 来 修改 一 个 字段 的 数据 类 型 是 可 能 的 了 。 
允许 多 个 ALTER 在 一 个 ALTER TABLE 命令 中 动作 (Rod) 


这 对 于 重 宇 表 的 ALTER 命令 尤其 有 用 (包括 ALTER coLuMN tree 和 带 有 一 个 缺 省 
的 app coLumn ) 。 通 过 一 起 分 组 ALTER MD, 该 表 只 需要 重 写 一 次 。 


人 允许 ALTER TABLE 添加 SERIAL 字段 (Tom) 
这 来 自 为 新 的 字段 指定 缺 省 的 新 能 


允许 修改 聚集 、 转 换 、 数 据 库 、 男 数 、 操 作 符 、 操 作 符 类 、 模 式 、 类 型 和 表 空 间 的 所 有 
者 (Christopher, Euler Taveira de Oliveira) 


以 前 这 些 需 要 直接 修改 系统 表 。 


© 人 允许 临时 对 象 的 创建 局 限于 sEcURITY DEFINER KZ (Sean Chittenden) 
e 添加 ALTER TABLE ... SET WITHOUT CLUSTER (Christopher) 
在 该 版 本 以 前 ， 没 有 方法 清空 一 个 自动 群集 的 规范 ， 除 了 修改 系统 表 。 


e 约束 /索引 / sERIAL 名 字 现 在 是 _table_column_type” ， 附加 上 编号 以 保证 在 模式 中 的 唯一 
性 (Tom) 





SQL 规 范 声明 这 样 的 名 字 应 该 在 一 个 模式 中 唯一 。 

e 添加 pg_get_serial_sequence() 来 返回 一 个 sERIAL 字段 的 序列 名 (Christopher) 
这 允许 自动 化 的 脚本 可 靠 的 找到 sERIAL 序列 名 。 

。 当主 键 /外 键 数据 类 型 不 匹配 需要 昂贵 的 查找 时 警告 

o 新 增 ALTER INDEX 命 合 人 允许 删除 表 空 间 之 间 的 索引 (Gavin) 


e 让 ALTER TABLE OWNER 修改 依赖 的 序列 所 有 权 (Alvaro) 


E.152.4.5. 工具 命令 的 变化 


© JLF CREATE SCHEMA 创建 触发 器 、 索 引 和 序列 (Neil) 
e 添加 ALso 关键 字 到 cREATE RULE (Fabien Coelho) 

这 人 允许 ALso 被 添加 到 规则 创建 ， 与 INSTEAD 规则 对 比 。 
e 添加 NowAIT 选项 到 Lock (Tatsuo) 

这 允许 Lock 命令 在 它 必须 等 待 请 求 的 锁 时 失败 。 
e 人 允许 copy 读 写 喜 号 分 隔 值 (CSV) 的 文件 (Andrew, Bruce) 
e 如 果 copy 分 隔 符 和 NULL 字 符 串 冲突 则 产生 错误 (Bruce) 
e GRANT / REVOKE 行为 更 加 符合 SQL 规范 
e 避免 CREATE INDEX 和 CHECKPOINT 之 间 的 锁 冲 突 (Tom) 


在 7.3 和 7.4 中 ， 一 个 长 期 运行 的 B-tree 索 引 建 立会 阻止 并 发 的 cHEckpPoINT 完成 ， 因此 导 
致 WAL 膨 胀 ， 因 为 WAL 日 志 不 能 重复 利用 。 


。 数据 库 范 围 的 ANALYzE 不 在 表 上 持 有 锁 (Tom) 


这 减少 了 其 他 后 端 想 要 在 表 上 的 排他 锁 时 死 锁 的 可 能 性 。 要 获取 这 个 修改 的 益处 ， 不 要 
在 一 个 事务 块 ( BEGIN 块 ) 中 执行 数据 库 范 围 的 ANALYZE ; 必须 能 够 为 每 个 表 提 交 和 启动 
一 个 新 事务 。 


e REINDEX 不 再 完全 锁 住 索引 的 父 表 


索引 本 身 仍然 是 完全 锁 住 的 ， 但 是 该 表 的 读者 可 以 继续 ， 如 果 他 们 不 使 用 被 重建 的 特定 
索引 。 


。 当 一 个 用 户 重 命名 了 时 ， 擦 除 MD5 用 户口 令 (Bruce) 


当 通过 MD5 解 密 口令 时 ，PostgreSQL 使 用 用 户 的 名 字 作 为 盐 。 当 改变 了 一 个 用 户 的 名 字 
时 ， 盐 将 不 再 匹配 存储 的 MD5 口 令 ， 所 以 存储 的 口令 变 得 无 用 了 。 在 这 个 版 本 中 生成 一 
个 通知 并 且 清 除 口令 。 如 果 该 用 户 能 够 使 用 一 个 口令 登录 ， 那 么 一 个 新 的 口令 必须 被 分 
Ac. 


为 Windows 新 建 pg_ctl kill 选项 (Andrew) 
Windows 没 有 kill 命令 发 送信 号 到 后 端 ， 所 以 这 个 能 力 添加 到 了 pg _ctl。 
。 信息 模式 改善 


e 添加 --pwhile 选项 到 initdb， 这 样 初始 口令 可 以 通过 GUI 工具 设置 (Magnus) 


令 测 initdb 中 的 本 地 环境 /编码 错误 匹配 (Peter) 


。 添加 register 命令 到 pg_ctl， 以 注册 Windows 操 作 系 统 服务 (Dave Page) 


E.152.4.6. 数据 类 型 和 部 数 的 变化 
。 对 复合 类 型 ( 行 类 型 ) 更 加 完整 的 支持 (Tom) 
合 值 可 以 用 在 以 前 只 能 是 标量 值 的 许多 地 方 。 
o 作为 错误 拒绝 非 矩形 的 数组 值 (Joe) 
以 前 ， array_in 将 默默 地 建立 一 个 伟人 惊讶 的 结果 。 
。 现在 检测 到 了 整数 算术 运算 符 的 浴 出 (Tom) 
。 与 单字 节 "char" 数据 类 型 相关 的 算术 操作 符 已 经 删除 了 。 


以 前 ， 解 析 器 将 在 许多 情况 下 选择 这 些 操作 符 ， 而 一 个 "不 能 选择 一 个 操作 符 " 错误 应 该 
更 加 合适 ， 比 如 null * null 。 如 果 你 真 的 想 要 在 一 个 "chars 字段 上 做 算术 ， 你 可 以 将 
它 明 确 的 转换 为 整 型 。 


。 数组 输入 值 的 语法 检查 明显 的 严格 了 (Joe) 


以 前 允许 在 旧 的 位 置 的 带 有 旧 的 结果 的 垃圾 现在 导致 一 个 ERROR ， 例如 ， 紧 跟着 右 括号 
后 面 的 非 空白 。 


。 时 字符 串 数组 元 素 值 现在 必须 写 为 "" ， 而 不 是 什么 都 不 写 (Joe) 


以 前 ， 两 种 书写 空 字 符 串 元 素 值 的 方法 都 是 允许 的 ， 但 是 现在 要 求 用 带 有 引号 的 空 字符 
串 。 在 一 些 未 来 的 版 本 中 ， 什 么 都 不 出 现 的 情况 可 以 考虑 为 一 个 NULL 元 素 值 。 


现在 忽略 数组 元 素 的 尾随 空白 (Joe) 


以 前 忽略 前 导 的 空白 ， 但 是 元 素 值 和 分 隔 符 或 右 括 号 之 间 的 尾随 的 空白 是 有 效 的 。 现在 
尾随 的 空白 也 忽略 了 。 


当下 界 不 是 1 时 ， 用 明确 的 数组 界限 发 出 数组 值 (Joe) 
作为 日 期 字符 串 接受 YYyy-monthname-DD (Tom) 
让 netmask 和 hostmask ŽURE RA KE wih KE (Tom) 
修改 阶乘 函数 以 返回 numeric (Gavin) 
返回 的 numeric Wi MAMA BASE HMMA ALE. 
to_char / to_date() 日 期 转换 的 改善 (Kurt Roeckx, Fabien Coelho) 
让 length() 忽视 cHAR(n) 中 尾随 的 空白 (Gavin) 


这 个 修改 是 为 了 提高 一 致 性 : chAR(n) 数据 中 尾随 的 空白 在 语义 上 是 无 关 紧 要 的 ， 所 以 
它们 不 应 该 被 length) 计数 。 


警告 空 字符 串 被 传递 到 oD / float4 / floats 数据 类 型 (Neil) 

8.1 中 将 抛 出 一 个 错误 。 

允许 前 导 或 尾随 的 空白 在 int2 / int4 / ints / float4 / floats 输入 例 程 中 (Neil) 
在 float4 / floats 中 更 好 的 支持 IEEE infinity 和 nan 值 (Neil) 

这 些 应 该 在 所 有 支持 IEEE 兼 容 浮 点 运算 的 平台 上 工作 。 

添加 week 选项 到 date_trunc() (Robert Creager) 

为 1 Bc 修复 tochar (以 前 它 返回 1 Ap ) (Bruce) 

为 BC 日 期 修复 date_part(year) (以 前 它 返 回 的 比 正确 的 年 份 少 1) (Bruce) 
修复 date_part() 以 返回 正确 的 千年 和 世纪 (Fabien Coelho) 


在 以 前 的 版 本 中 ， 和 与 标准 比较 计算 ， 世 纪 和 生年 的 结果 有 一 个 错误 的 数值 ， 并 且 是 以 错 
误 的 年 份 开始 的 。 

为 了 符合 标准 ， 添 加 ceiling() 作为 ceil() 的 一 个 别名 ， power() 作为 pow() 的 一 个 
别名 (Neil) 


修改 1n() 、 log). power() 和 sqrt() ， 就 像 SQL:2003 中 指定 的 那样 ， 为 确定 的 错 
误 条 件 发 出 正确 的 saLsTATE 错误 代码 (Neil) 


像 SQL:2003 中 定义 的 那样 添加 width_bucket() PAR (Neil) 

添加 generate_series() PAR fj (LAF SEH LE (Joe) 

修复 upper/lower/initcap() 函数 以 与 多 字 节 编码 一 起 工作 (Tom) 
添加 布尔 和 按 位 整数 ANp / oR 聚集 (Fabien Coelho) 

新 增 会 话 信息 函数 ， 为 客户 端 和 服务 器 返回 网 络 地 址 (Sean Chittenden) 

添加 函数 确定 闭合 路 径 的 区 域 (Sean Chittenden) 

添加 函数 发 送 取消 请 求 到 其 他 后 端 (Magnus) 

添加 datetime 加 datetime 操作 符 (Tom) 

相反 的 顺序 ， datetime 加 interval ， 早 已 支持 了 ， 但 是 SQL 标准 两 种 都 需要 。 
转换 一 个 整数 到 BIT(N) ， 选 取 该 整数 的 最 右 侧 的 N 位 (Tom) 


在 以 前 的 版 本 中 ， 选 择 最 左 侧 的 N 位 ， 但 是 这 被 认为 是 没有 帮助 的 ， 更 不 用 说 与 从 位 转 
换 到 整数 的 不 一 致 。 


需要 CIDR 值 让 所 有 非 标记 的 位 为 0 (Kevin Brintnall) 


E.152.4.7. 服务 器 问 语 言 的 变化 


在 READ coMMITTED 序列 化 模式 中 ， 不 稳定 的 函数 现在 看 到 并 发 事务 提交 的 结果 直到 该 茵 
数 中 每 个 语句 的 开始 ， 而 不 是 直到 调用 该 落 数 的 交互 命 合 的 开始 。 


声明 为 STABLE 或 IMMUTABLE 的 画 数 总 是 使 用 调用 查询 的 快照 ， 并 且 因 此 不 能 看 到 调用 查 
询 开始 之 后 采取 的 动作 的 影响 ， 不 管 是 在 它们 自己 的 事务 中 还 是 在 其 他 事务 中 。 这 样 一 

SHAY AHERN, 意味 着 它 不 能 使 用 任何 SQL 命令 ， 除 了 sELEcT 。 声明 一 个 函 

数 STABLE 或 IMMUTABLE 而 不 是 VOLATILE 有 相当 大 的 性 能 增益 。 


非 延 迟 的 AFTER 触发 器 现在 在 触发 器 查询 完成 之 后 立即 触发 ， 而 不 是 根据 当前 交互 命令 
的 完成 。 这 在 触发 查询 发 生 在 一 个 函数 中 时 有 所 不 同 ; 触发 器 在 该 图 数 进行 它 的 下 一 个 
操作 之 前 被 调用 。 例 如 ， 如 果 一 个 画 数 插入 了 一 个 新 行 到 一 个 表 中 ， 任 何 非 延迟 的 外 键 
检查 在 处 理 该 图 数 之 前 发 生 。 


人 允许 图 数 参 数 用 名 字 声 明 (Dennis Bjorklund) 

这 允许 更 好 的 记录 画 数 。 名 字 实 际 上 是 否 做 任何 事情 依赖 于 使 用 的 特定 的 酚 数 语言 。 
人 允许 PL/pgSQL 参 数 名 在 画 数 中 引用 (Dennis Björklund) 

这 基本 上 为 每 个 命名 的 参数 都 创建 了 一 个 自动 的 别名 。 


在 创建 时 做 最 少 的 PL/pgSQL 画 数 的 语法 检查 (Tom) 


这 人 允许 我 们 快速 的 捕捉 简单 的 语法 错误 。 
在 PL/pgSQL 中 更 加 支持 复合 类 型 ( 行 和 记录 变量 ) 
例如 ， 现 在 可 以 将 行 类 型 变量 作为 单个 变量 传递 到 另 一 个 加 数 了 。 
PL/pgSQL 交 量 的 缺 省 变量 现在 可 以 引用 以 前 声明 的 变量 。 
为 循环 改善 PL/pgSQL 的 解析 (Tom) 


解析 现在 是 通过 “".." 的 存在 来 驱动 的 ， 而 不 是 FoR 变量 的 数据 类 型 。 这 对 于 正确 的 函 
数 来 说 没什么 差别 但 是 当 有 一 个 错误 时 ， 会 导致 更 容易 理解 的 错误 消息 。 


主要 检修 了 PL/Perl 服 务 器 端 语言 (Command Prompt, Andrew Dunstan) 


在 PL/Tcl 中 ，SPI 命 令 现 在 在 子 事务 中 运行 。 如 果 发 生 了 一 个 错误 ， 该 子 事务 被 清理 并 且 
该 错误 被 作为 一 个 普通 Tel 错误 报告 ， 可 以 使 用 catch 捕获 。 以 前 ， 捕 获 这 样 的 错误 是 没 
有 可 能 的 。 


在 PL/pgSQL 中 接受 ELsEIF (Neil) 


DABUPL/pgSQLR sei ELsIF ， 但 是 许多 人 习惯 拼写 ELSEIF 关键 字 。 


E.152.4.8. psql 的 变化 


改善 psql 关 于 数据 库 对 象 的 信息 显示 (Christopher) 

人 允许 psql 在 \du 和 \dg 中 显示 组 成 员 (Markus Bertheau) 

阻止 psql \dn 显示 临时 模式 (Bruce) 

人 允许 psq| 为 文件 名 处 理 波浪 符 用 户 扩展 (Zach Irmen) 

人 允许 psql 显 示 提 示 ， 包 括 颜 色 ， 通 过 readline (Reece Hart, Chet Ramey) 
让 psq| \copy 完全 匹配 copy 命令 语法 (Tom) 

显示 语法 错误 的 位 置 (Fabien Coelho, Tom) 

添加 cLusTER 信息 到 psql \d 显示 (Bruce) 

修改 psql \copy stdin/stdout ， 以 便 从 命令 输入 /输出 中 读 取 (Bruce) 
添加 pstdin / pstdout ， 以 便 从 psql 的 stdin / stdout 读 取 (Mark Feit) 
添加 全 局 psql 配 置 文件 ， psqlrc.sample (Bruce) 

这 允许 一 个 可 以 存储 全 局 psql 启 动 命令 的 中 心 文档 。 


让 psql \d+ 表明 表 是 否 有 一 个 or FE (Neil) 


e 在 Windows 上 ， 当 读 取 文 件 时 使 用 二 进 制 模式 ， 这 样 control-Z 不 会 被 看 做 文件 的 结尾 。 
e 让 \dn+ 显示 模式 的 权限 和 描述 (Dennis Bjorklund) 
。 提高 选项 卡 完 成 支持 (Stefan Kaltenbrunn, Greg Sabino Mullane) 


。 人 允许 布尔 设置 使 用 大 写 或 小 写 (Michael Paesold) 


E.152.4.9. pg_dump 的 变化 
。 使 用 依赖 关系 信息 提高 pg_dump 的 可 靠 性 (Tom) 
这 上 应 该 解决 了 相关 的 对 象 有 时 会 以 错误 的 顺序 转 储 的 长 期 存在 的 问题 。 
。 如 果 可 能 ， 让 pg_dump 以 字母 顺序 输出 对 象 (Tom) 
这 将 使 得 它 更 容易 的 识别 出 转 储 文件 间 的 变化 。 
© 人 允许 pg_restore 忽 略 一 些 SQL 错 误 (Fabien Coelho) 


这 使 得 pg_restore 的 行为 类 似 于 输出 pg_dump 输出 脚本 到 psql 的 结果 。 在 大 多 数 情 况 
下 ， 忽略 错误 和 向 前 进行 是 最 有 用 的 事情 。 还 添加 了 一 个 pg_restore 选 项 给 老 的 行为 在 


遇 到 错误 时 退出 。 
。 pg_restore -1 显示 现在 包括 了 对 象 的 模式 名 
e 在 pg_dump 文 本 输出 中 新 增 开始 /结束 标记 (Bruce) 
。 在 详细 模式 为 pg_dump/pg_dumpall 添 加 开始 /结束 时 间 (Bruce) 
。 在 pg_dumpall 中 人 允许 大 部 分 pg_dump 选 项 (Christopher) 


e 让 pg_dump 默 认 使 用 ALTER owNER 而 不 是 SET SESSION AUTHORIZATION (Christopher) 


E.152.4.10. libpq 的 变化 
e 让 libpq 的 siGPIPE 义理 线程 安全 (Bruce) 
e 添加 pombdsplen() ， 返 回 一 个 字符 的 显示 长 度 (Tatsuo) 
© 添加 线程 锁 到 SSL 和 Kerberos 连 接 (Manfred Spraul) 
e 多 许 Paoidvalue() 、 PQcmdTuples() 和 PQoidstatus() 在 EXECUTE 命令 上 工作 (Neil) 
e 添加 PQserverversion() ， 添 加 更 多 到 服务 器 版 本 号 的 方便 的 访问 (Greg Sabino Mullane) 


e 添加 PQprepare/PQsendPrepared() HARREMA, 没有 必要 指定 它们 的 参数 的 数据 类 
# (Abhijit Menon-Sen) 


e 许多 ECPG 改 善 ， 包 括 set vescriptor (Michael) 


E.152.4.11. 源 代码 的 变化 


人 允许 数据 库 服务 器 在 Windows 上 本 地 运行 (Claudio, Magnus, Andrew) 
为 了 Windows 支 持 ，Shell 脚 本 命令 转换 为 C 版 本 (Andrew) 

创建 一 个 扩展 makefile 框 架 (Fabien Coelho, Peter) 

这 简化 了 在 源 代 码 树 的 外 面 建立 扩展 的 任务 。 

支持 重新 定位 安装 (Bruce) 


安装 文件 的 目录 路 径 (比如 /share 目录 ) 现在 是 和 可 执行 文件 的 实际 位 置 相关 的 ， 所 以 
一 个 安装 树 可 以 移动 到 另外 一 个 地 方 而 不 用 重新 配置 和 重新 建立 。 


使 用 --with-docdir 选择 文档 的 安装 位 置 ; 也 人 允许 --infodir (Peter) 
添加 --without-docdir ， 阻 止 文档 的 安装 (Peter) 

升级 到 DocBook V4.2 SGML (Peter) 

新 增 PostgresQL CVS 标 签 (Marc) 


这 样 做 是 为 了 使 它 更 简单 的 组 织 管理 它们 自己 的 PostgreSQL CVS 合 库 。 主 仓库 的 文件 版 
本 邮票 将 不 会 通过 检查 进出 一 个 复制 的 存储 库 而 加 上 参数 。 (File version stamps from 
the master repository will not get munged by checking into or out of a copied 
repository.) 


明确 锁定 代码 (Manfred Koizar) 

缓冲 区 管理 器 清理 (Neil) 

从 CPU 自 旋 锁 代 码 解 耦 平台 测试 (Bruce, Tom) 

在 PA-RISC 上 为 gcc 添 加 在 线 测 试 和 设置 代码 (ViSolve, Tom) 
改善 ji386 自 旋 锁 代码 (Manfred Spraul) 

清理 自 旋 锁 汇 编 代 码 ， 以 避免 来 自 新 的 gcc 版 本 的 警告 (Tom) 
从 源码 树 中 删除 JDBC ; JDBC 现 在 是 一 个 单独 的 项 目 

删除 libpgtcl 客 户 端 接口 ; 它 现 在 是 一 个 单独 的 项 目 

更 准确 的 估计 内 存 和 文件 描述 符 的 使 用 (Tom) 

提高 到 Mac OS X é aI% (Ray A.) 

新 增 fsync() 测试 程序 (Bruce) 


主要 文档 的 改进 (Neil, Peter) 


。 删除 pg_encoding; 不 再 需要 了 

。 删除 pg_id; 不 再 需要 了 

。 删除 initlocation; 不 再 需要 了 

。 自动 检测 线程 标志 〈 不 再 手动 检测 ) (Bruce) 

。 使 用 Olson 的 公共 域 timezone 库 (Magnus) 

。 启用 了 线程 ， 在 Unixware 上 为 后 端 可 执行 文件 使 用 线程 标志 (Bruce) 


Unixware 在 相同 的 可 执行 文件 中 不 能 混合 线程 的 和 非 线程 的 对 象 文 件 ， 所 以 每 个 都 必须 
编译 为 线程 的 。 


。 psd|l 现 在 使 用 一 个 flex 产 生 的 词法 分 析 器 多 理 命令 字符 串 
。 重 装 整个 后 台 使 用 的 链表 数据 结构 (Neil) 
这 通过 允许 附加 列表 和 长 度 操作 符 更 加 高 效 提高 了 性 能 。 
。 人 允许 动态 加 载 的 模块 创建 它们 自己 的 服务 器 配置 参数 (Thomas Hallgren) 
。 新 增 FAQ 的 Brazilian 版 本 (Euler Taveira de Oliveira) 
e 添加 French FAQ (Guillaume Lelarge) 
。 为 Windows 登 陆 新 增 pgevent 


。 让 libpq 和 ECPG 在 OS X 上 作为 适当 共享 的 库 建立 (Tom) 


E.152.4.12. 贡献 版 的 变化 


© 彻底 检查 contrib/dblink (Joe) 

e contrib/dbmirror 改善 (Steven Singer) 

e 新 增 contrib/xm12 (John Gray, Torchbox) 

© 升级 了 contrib/mysql 

e 新 增 contrib/btree_gist 的 版 本 (Teodor) 

e 新 增 contrib/trgm ， 为 PostgreSQL 的 三 元 模型 匹配 (Teodor) 
e 许多 contrib/tsearch2 的 改善 (Teodor) 

。 添加 两 倍 metaphone 到 contrib/fuzzystrmatch (Andrew) 


e 介 许 contrib/pg_autovacuum 作为 Windows 服 务 运行 (Dave Page) 


。 WMA contrib/dbsize (Andreas Pflug) 
° 删除 contrib/pg_logger :被 完整 的 登陆 子 进程 代替 了 


© 删除 contrib/rserv :被 各 种 独立 的 项 目 代替 了 


E.153. 版 本 7.4.30 


发 布 日 期 : 2010-10-04 


这 个 版 本 包含 各 种 自 7.4.29 以 来 的 修复 。 要 想 获 得 关于 7.4 主 版 本 的 新 特性 信息 ， 请 参 
阅 Section E.183。 


这 预计 是 PostgreSQL 7.4.X 系 列 的 最 后 一 个 版 本 。 推荐 用 户 尽快 更 新 到 新 版 本 。 


E.153.1. 迁移 到 版 本 7.4.30 


运行 7.4.X 的 用 户 不 需要 转 储 /恢复 。 不 过 ， 如 果 您 是 从 一 个 早 于 7.4.26 的 版 本 升级 而 来 ， 那么 
请 参考 7.4.26 的 版 本 声明 。 


E.153.2. 修改 列表 


。 为 每 个 在 PL/Perl| 和 PL/Tcl 中 调用 的 SQL userid 使 用 一 个 单独 的 解释 器 (Tom Lane) 


这 个 修改 阻止 可 以 由 破坏 稍 后 在 同一 个 会 话 中 另 一 个 SQL 用 户 身份 执行 的 Perl 或 Tcl 代 码 
引起 的 安全 问题 (例如 ， 在 一 个 SECURITY DEFINER MMH) 。 大 多 数 脚 本 语言 提供 多 种 
可 能 执行 的 方式 ， 比如 重 定义 被 目标 函数 调用 的 标准 本 数 或 操作 符 。 没 有 这 个 修改 ， 任 
意 拥有 Perl 或 Tcl 语 言 使 用 权限 的 SQL 用 户 本 质 上 都 可 以 用 目标 函数 的 所 有 者 的 SQL 权限 
做 任何 事情 。 

这 个 修改 的 成 本 是 Perl 和 Tcl 范 数 之 间 有 意 的 交流 变 得 更 加 困难 。 为 了 提供 一 个 安全 秀 
口 ， PL/PerlU 和 PL/TcIU 画 数 继续 每 个 会 话 只 使 用 有 一 个 解释 器 。 这 不 认为 是 一 个 安全 问 
题 ， 因为 所 有 这 样 的 范 数 都 早已 在 数据 库 超级 用 户 的 信任 级 别 执行 了 。 


有 可 能 要 求 提供 受信 任 的 执行 的 第 三 方 的 过 程 语言 有 相似 的 安全 问题 。 我 们 建议 为 了 关 
键 性 的 安全 目的 ， 联 系 任何 你 依赖 的 PL 的 作者 。 


感谢 Tim Bunce 指 出 这 个 问题 (CVE-2010-3433)。 


e 阻止 bg_get_expr() 中 可 能 的 崩溃 ， 通 过 不 允许 它 被 调用 ， 有 一 个 争论 是 它 尝 试 使 用 多 
个 系统 目录 字段 (Heikki Linnakangas, Tom Lane) 


修复 "cannot handle unplanned sub-select" 错 误 (Tom Lane) 


当 一 个 子 查询 包含 一 个 连接 别名 引用 扩大 为 一 个 表达 式 包含 另 一 个 子 查询 时 会 发 生 这 个 


Aiko 


在 写 锁 文件 (GHE postmaster.pid 和 套 接 字 锁 文件 ) 时 要 小 心 的 同步 锁 文 件 的 内 容 (Tom 


Lane) 


如 果 机 器 在 主 进程 启动 后 很 快 就 月 浇 了 ， 那 么 这 个 下 忽 会 导致 锁 文 件 内 容 损 坏 。 这 会 阻 
止 随后 启动 主 进程 的 尝试 成 功 ， 直 到 手动 的 移 除 锁 文件 。 


改善 contrib/dblink 处 理 含 有 删除 的 字段 的 表 (Tom Lane) 


修复 contrib/dblink 中 出 现 "duplicate connection name" 错误 之 后 的 连接 漏洞 (ltagaki 
Takahiro) 


更 新 基础 构造 和 文档 ， 以 反应 源 代 码 从 CVS 迁 移 到 了 Git (Magnus Hagander and others) 


E.154. 版 本 7.4.29 


发 布 日 期 : 2010-05-17 


这 个 版 本 包含 各 种 自 7.4.28 以 来 的 修复 。 关 于 7.4 主 版 本 的 新 特性 信息 ， 请 参阅 Section 
E.183。 


PostgreSQL 社 区 将 在 2010 年 7 月 份 停止 对 7.4.X 版 本 系列 的 更 新 。 建议 用 户 尽快 更 新 到 最 新 的 
版 本 。 


E.154.1. 迁移 到 版 本 7.4.29 


运行 7.4.X 的 版 本 不 需要 转 储 /恢复 。 不 过 ， 如 果 你 是 从 一 个 早 于 7.4.26 的 版 本 升级 而 来 ， 那么 
请 参阅 7.4.26 的 版 本 声明 。 


E.154.2. 修改 列表 


。 使 用 一 个 opmask 应 用 到 整个 解释 器 ， 执 行 plperl 中 的 限制 条 件 ， 而 不 是 使 用 safe.pm 
(Tim Bunce, Andrew Dunstan) 


最 近 的 发 展 使 我 们 相信 safe.pm 太 不 安全 了 ， 不 能 依赖 它 来 使 得 plperl 可 以 信赖 。 这 个 
修改 完全 删除 了 safe.pm 的 使 用 ， 支持 总 是 使 用 一 个 单独 的 带 有 操作 码 的 解释 器 。 这 个 

修改 伟人 愉快 的 副作用 包括 : 现在 在 plperl 中 以 自然 的 方式 使 用 Perl 的 strict 编译 指 

示 是 可 能 的 了 ， Perl 的 sa 和 sb 变量 在 排序 例 程 中 像 预 期 的 那样 工作 了 ， 并 且 画 数 编译 
更 快 了 。 (CVE-2010-1169) 


e 阻止 PL/Tcl 执 行 pltcl_modules 中 不 可 靠 的 代码 (Tom) 


PL/TcI 自 动 从 数据 库 表 中 加 载 Tcl 代 码 的 特性 可 能 会 被 特洛伊 木马 攻击 利用 ， 因为 没有 谁 
可 以 创建 或 插入 到 那个 表 的 限制 。 这 个 修改 使 该 特性 失效 ， 除非 pltcl_modules 属于 超 
级 用 户 。 (不 过 ， 在 表 上 的 权限 是 不 检查 的 ， 所 以 实际 上 需要 较 少 安全 模块 的 表 的 安装 
仍然 可 以 赋予 合适 的 权限 给 受信 任 的 非 超级 用 户 。) 还 有 ， 阻 止 加 载 代码 到 不 受 限制 
的 "正常 "Tel 解释 器 ， 除非 我 们 真正 要 执行 一 个 pltclu BX. (CVE-2010-1170) 


。 不 允许 非特 权 的 用 户 重 置 超级 用 户 仅 有 的 参数 设置 (Alvaro) 


以 前 ， 如 果 一 个 非特 权 用 户 为 他 自己 运行 ALTER USER ... RESET ALL, 或 者 为 他 拥有 的 
一 个 数据 库 运行 ALTER DATABASE ... RESET ALL, 都 将 为 该 用 户 或 数据 库 删 除 所 有 的 特殊 
参数 设置 ， 即 使 其 中 有 只 支持 超级 用 户 可 以 修改 的 设置 。 现在 ， ALTER 将 只 删除 用 户 有 
权限 修改 的 参数 。 


如 果 关 闭 发 生 在 context AIRRA, EES mK A FA le AREA AR (Tom) 


在 某 些 情况 下 ， 上 下 文 打印 功能 可 能 会 失败 ， 因 为 当 它 要 打印 一 个 日 志 信 息 时 ， 当前 的 
事务 早已 回 滚 了 。 


为 现在 的 Perl 版 本 更 新 pl/perl 的 ppport.h (Andrew) 
修复 pl/python 中 的 各 种 内 存 泄露 (Andreas Freund, Tom) 
确保 contrib/pgstattuple 图 数 响 应 迅速 的 取消 中 断 (Tatsuhito Kasahara) 


使 服务 器 启动 适当 的 义理 shmget() 为 一 个 已 经 存在 的 共享 内 存 段 返回 erva 的 情况 
(Tom) 


这 个 行为 已 经 在 BSD 衍 生 的 核心 程序 包括 OS X 上 观察 到 。 它 导致 一 个 完全 误导 的 启动 失 
w, 抱怨 共享 内 存 请 求 大 小 太 大 。 


E.155. 版 本 7.4.28 


发 布 日 期 : 2010-03-15 


这 个 版 本 包括 各 种 自 7.4.27 以 来 的 修复 。 关 于 7.4 主 版 本 的 新 特性 的 信息 ， 请 参阅 Section 
E182; 


PostgreSQL 社 区 将 在 2010 年 7 月 份 停止 对 7.4.X 版 本 系列 的 更 新 。 建议 用 户 尽快 更 新 到 最 新 的 
版 本 。 


E.155.1. 迁移 到 版 本 7.4.28 


运行 7.4.X 的 用 户 不 需要 转 储 /恢复 。 不 过 ， 如 果 你 是 从 一 个 早 于 7.4.26 的 版 本 升级 而 来 ， 那么 
请 查看 7.4.26 的 版 本 声明 。 


E.155.2. 修改 列表 
e 添加 新 的 配置 参数 ssl_renegotiation_limit ， 控制 多 长 时 间 为 SSL 连 接 做 一 次 会 话 秘 钥 
重新 协商 (Magnus) 


可 以 设置 为 0 来 完全 禁用 重新 协商 ， 如 果 使 用 了 破损 的 SSL 库 可 能 会 需要 这 个 。 特别 的 ， 
一 些 供应 商 提 供 暂 时 的 CVE-2009-3555 的 补丁 导致 重新 协商 的 党 试 失败 。 


o 使 得 substring() 的 bit 类 型 对 待 负 的 长 度 为 意味 着 "所 有 剩余 的 字符 串 " (Tom) 


以 前 的 代码 只 对 待 -1 为 这 种 方式 ， 并 且 会 为 其 它 负 值 生成 一 个 无 效 的 结果 值 ， 有 可 能 会 
导致 月 溃 (CVE-2010-0442) 


。 修复 一 些 正则 表达 式 匹 配 变 慢 的 情况 (Tom) 


e 当 读 取 pg_hba.conf 和 相关 的 文件 时 ， 如 果 @ 出 现在 双 引 号 标记 的 内 部 ， 那么 不 要 
将 @something 当做 文件 包含 查询 ; 还 有 ， 永远 不 要 将 @ 本 身 当 做 文件 包含 查询 (Tom) 


这 阻止 了 当 用 户 或 者 数据 库 名 字 以 @ 开始 时 的 不 规律 行为 。 如 果 你 需要 包括 一 个 文件 的 
整个 路 径 名 (包括 空格 ) ， 你 仍然 可 以 这 样 做 ， 但 是 必须 写 @"/path to/file" 而 不 是 使 


双 引 号 包含 整个 构造 。 


。 如 果 一 个 路 径 命 名 为 pg_hba.conf 和 相关 文件 中 的 包含 目标 ， 阻止 某 些 平台 上 的 无 限 循 
环 (Tom) 


。 确保 PL/Tcl 完 全 初始 化 Tcl 解 释 器 (Tom) 


现在 知道 的 唯一 情况 是 ， 如 果 使 用 Tcl 8.5 或 以 后 的 版 本 ，Tcl clock 命令 会 错误 动作 。 


© 当 太 多 的 关键 字段 在 dblink_build_sql* KHA hA, BELE contrib/dblink 的 崩溃 
(Rushabh Lathia, Joe Conway) 


E.156. 版 本 7.4.27 


发 布 日 期 : 2009-12-14 


这 个 


版 本 包含 各 种 自 7.4.26 以 来 的 修复 。 关 于 7.4 主 版 本 的 新 特性 的 信息 ， 请 参阅 Section 


E.183, 


E.156.1. 迁移 到 版 本 7.4.27 


运行 
请 查 


7.4.X 的 用 户 不 需要 转 储 /恢复 。 不 过 ， 如 果 你 是 从 一 个 早 于 7.4.26 的 版 本 升级 而 来 ， 那么 
看 7.4.26 的 版 本 声明 。 


E.156.2. 修改 列表 


防御 索引 画 数 改变 会 话 环境 状态 引起 的 间接 安全 威胁 (Gurjeet Singh, Tom) 
这 个 修改 阻止 早已 不 变 的 索引 画 数 可 能 破坏 超级 用 户 的 会 话 (CVE-2009-4136)。 
拒绝 SSL 证 书 在 common name (CN) 字段 包含 一 个 戏 入 的 空 字 节 (Magnus) 


这 阻止 了 在 SSL 生 效 期 间 非 故意 的 匹配 一 个 证 书 到 一 个 服务 器 或 客户 端 名 (CVE-2009- 
4034)。 


修复 后 端 启动 时 缓存 初始 化 期 间 可 能 的 骨 溃 (Tom) 
阻止 信号 在 不 安全 的 时 间 打 断 vacuum (Alvaro) 


如 果 vAcuuM FULL 在 它 已 经 提交 的 元 组 动作 之 后 取消 ， 那 么 这 个 修复 阻止 了 一 个 PANIC， 
还 有 如 果 普 通 vAcuu 在 表 截 断 之 后 中 断 时 的 瞬 态 错误 。 


修复 哈 希 表 大 小 计算 中 由 于 整数 浴 出 可 能 的 骨 溃 (Tom) 

这 会 在 规划 器 估算 哈 希 连接 结果 的 尺寸 非常 大 时 发 生 。 
修复 inet / cidr 上 比较 中 非常 罕见 的 崩溃 (Chris Mikkelson) 
修复 PAM 密 码 处 理 更 加 强健 (Tom) 


以 前 的 代码 都 知道 是 在 Linux pam_krb5 PAM 模 块 和 Microsoft Active Directory 组 合 为 域 
控制 器 时 失败 。 也 有 可 能 会 在 其 他 地 方 有 问题 ， 因 为 它 对 于 PAM 堆 传递 哪个 参数 做 了 不 
正确 的 假设 。 


使 得 主 进程 忽略 任意 连接 请 求 包 中 的 application_name 参数 ， 以 提高 与 未 来 libpq 版 本 的 
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E.157. 版 本 7.4.26 


发 布 日 期 : 2009-09-09 


这 个 版 本 包含 各 种 自 7.4.25 以 来 的 修复 。 关 于 7.4 主 版 本 的 新 特性 信息 ， 请 参阅 Section E.183 


E.157.1. 迁移 到 版 本 7.4.26 


运行 7.4.X 版 本 的 用 户 不 需要 转 储 /恢复 。 不 过 ， 如 果 你 在 interval 字段 上 有 任何 哈 希 索引 ， 
你 必须 在 升级 到 7.4.26 以 后 REINDEX 它们 。 还 有 ， 如 果 你 从 一 个 早 于 7.4.11 的 版 本 升级 而 来 ， 
请 查看 7.4.11 的 版 本 声明 。 


E.157.2. 修改 列表 


e 不 允许 RESET ROLE 和 RESET SESSION AUTHORIZATION 在 安全 定义 豆 数 里 面 (Tom, Heikki) 


这 包含 了 以 前 的 补丁 丢失 的 一 个 情况 ， 不 人 允许 RESET ROLE 和 
RESET SESSION AUTHORIZATION 在 安全 定义 函数 里 面 。 (参阅 CVE-2007-6600) 


。 (£2 FSELECTH MENA 2 HARA WARIS HA 2 IB (Tom) 
。 修复 数据 类 型 interval 的 哈 希 计 算 (Tom) 


这 纠正 了 间隔 值 上 的 哈 希 连接 的 错误 结果 。 也 改变 了 间隔 字段 上 的 哈 希 索引 的 内 容 。 如 
果 有 任何 这 样 的 索引 ， 必 须 在 升级 之 后 REINDEX 它们 。 


e 修复 interval x ms' 中 的 x ”超过 2 百 万 ， 并 且 正 在 使 用 整数 时 间 维 度 时 的 渝 出 
(Alex Hunsaker) 


。 修复 点 到 线段 的 距离 的 计算 (Tom) 
这 导致 一 些 几 何 操作 符 的 不 正确 的 结果 。 
。 修复 money 数据 类 型 在 货币 数量 没有 小 数 点 的 环境 中 工作 ， 如 Japan (Itagaki Takahiro) 
。 适当 的 圆 整 日 期 时 间 输入 ， 如 00:12:57. 9999999999999999999999999999 (Tom) 
。 修复 GiST R-tree 操作 符 类 中 页 分 裂 点 的 欠 佳 的 选择 (Teodor) 
。 修复 plperl 初 始 化 中 的 可 移植 性 问题 (Andrew Dunstan) 
e 改善 libpq 的 代码 从 copy From sTDIN 期 间 的 错误 中 恢复 的 稳健 性 (Tom) 


。 避免 包含 readline 和 editline 头 文件 的 冲突 ， 当 两 者 的 库 都 安装 了 时 (Zdenek Kotala) 


E.158. 版 本 7.4.25 


发 布 日 期 : 2009-03-16 


这 个 版 本 包含 各 种 自 7.4.24 以 来 的 修复 。 关 于 7.4 主 版 本 的 新 特性 信息 ， 请 查看 Section 
E.183。 


E.158.1. 迁移 到 版 本 7.4.25 


运行 7.4.X 的 用 户 不 需要 转 储 /恢复 。 不 过 ， 如 果 你 是 从 一 个 早 于 7.4.11 的 版 本 升级 而 来 ， ; 


at 
lò 


看 7.4.11 的 版 本 声明 。 


E.158.2. 修改 列表 


当 编 码 转 换 失 败 时 ， 阻 止 错误 的 递 轨 崩溃 (Tom) 

这 个 修改 扩展 了 在 上 两 个 主 版 本 中 相关 错误 情节 的 修复 。 以 前 的 修复 正好 适合 原始 的 错 
误 报告 ， 但 是 我 们 现在 意识 到 任何 编码 转换 函数 抛 出 的 错误 都 可 能 在 尝试 报告 该 错误 时 
潜在 的 导致 无 限 递 为 。 因此 ， 如 果 我 们 发 现 我 们 已 经 进入 递归 的 错误 报告 情形 ， 解 决 方 
法 是 禁用 翻译 和 编码 转换 ， 并 报告 任何 错误 消息 的 原 ASCII 格 式 。 (CVE-2009-0922) 
不 允许 CREATE CONVERSION 用 错误 的 编码 指定 转换 函数 (Heikki) 

这 防止 了 一 个 编码 转换 失败 的 可 能 的 情形 。 以 前 的 修改 是 支持 防范 在 相同 地 方 的 其 他 类 
型 的 失败 。 

修复 当 to_char() 给 出 的 格式 代码 不 适合 数据 参数 的 类 型 时 的 内 核 转 储 (Tom) 

添加 must (Mauritius Island Summer Time) 到 已 知 的 时 区 缩写 的 缺 省 列表 (Xavier 
Bugaud) 


E.159. 版 本 7.4.24 


发 布 日 期 : 2009-02-02 


这 个 版 本 包含 各 种 自 7.4.23 以 来 的 修复 。 关 于 7.4 主 版 本 的 新 特性 信息 ， 请 参考 Section 
E.183, 


E.159.1. 迁移 到 版 本 7.4.24 


运行 7.4.X 的 用 户 不 需要 转 储 /恢复 。 不 过 ， 如 果 你 是 从 一 个 早 于 7.4.11 的 版 本 升级 而 来 ， ; 
看 7.4.11 的 版 本 声明 。 


ah 
(ò 


E.159.2. 修改 列表 


e 改善 URL 在 headline() HEX HAY 4 (Teodor) 
e 改善 headline() RHE K tr BY QB (Teodor) 


。 如 果 用 错误 的 转换 函数 为 两 个 指定 的 编码 创建 了 一 个 编码 转换 ， 那么 阻止 可 能 的 断言 失 
败 或 错误 转换 (Tom, Heikki) 


。 避免 在 vacuum 中 锁定 不 必要 的 小 表 (Heikki) 
@ 修复 contrib/tsearch2 的 get_covers() KARIRA GHI FS (Teodor) 
e 修复 to_char() 3B m 格式 代码 中 的 bug (Andreas Scherbaum) 


e 使 得 所 有 的 文档 引用 pgsql-bugs 和 /或 pgsql-hackers 是 适当 的 ， 人 代替 现在 不 用 了 
的 pgsql-ports 和 pgsql-patches 邮件 列表 (Tom) 


E.160. 版 本 7.4.23 


发 布 日 期 : 2008-11-03 
这 个 版 本 包含 各 种 自 7.4.22 以 来 的 修复 。 关 于 7.4 主 版 本 的 新 特性 的 信息 ， 请 查阅 Section 
E.183。 


E.160.1. 迁移 到 版 本 7.4.23 


运行 7.4.X 的 用 户 不 需要 转 储 /恢复 。 不 过 ， 如 果 你 是 从 一 个 早 于 7.4.11 的 版 本 升级 而 来 ， ; 
看 7.4.11 的 版 本 声明 。 


ah 
(ò 


E.160.2. 修改 列表 


修复 当 客 户 端 编码 不 能 表示 本 地 化 的 错误 消息 时 的 后 端 崩溃 (Tom) 


我 们 以 前 解决 过 相似 的 问题 ， 但 是 如 果 "character has no equivalent" 消息 本 身 不 能 被 转 
换 时 仍然 会 失败 。 该 修复 是 为 了 在 我 们 检测 到 这 样 一 个 情况 时 禁用 本 地 化 ， 并 且 发 送 纯 
ASCII 消 息 。 


修复 单个 查询 条 目 匹 配 文本 的 第 一 个 单词 时 生成 不 正确 的 tsearch2 标 题 (Sushant Sinha) 


e 当 在 一 个 --enable-integer-datetimes 构造 中 使 用 一 个 非 1SO 日 期 类 型 时 ， 修复 间隔 值 中 
分 数秒 的 不 恰当 的 显示 (Ron Mayer) 


e 当 传递 的 元 组 和 元 组 描述 符 有 不 同 的 字段 数量 时 ， 确 
保 SPI_getvalue 和 SPI_getbinval 正确 的 行为 (Tom) 


4—FA MRIS RSE, BR NSBWZIERN, (BER SSW EYRE 
它 。 唯一 可 能 的 结果 是 一 个 不 正确 的 错误 提示 。 


。 修复 ecpg 的 create user 的 语法 分 析 (Michael) 


E.161. 版 本 7.4.22 


发 布 日 期 : 2008-09-22 
这 个 版 本 包含 各 种 自 7.4.21 以 来 的 修复 。 关 于 7.4 主 版 本 的 新 特性 的 信息 ， 请 查阅 Section 
E182; 


E.161.1. 迁移 到 版 本 7.4.22 


运行 7.4.X 的 用 户 不 需要 转 储 /恢复 。 不 过 ， 如 果 你 是 从 一 个 早 于 7.4.11 的 版 本 升级 而 来 ， ; 
看 7.4.11 的 版 本 声明 。 


at 
lò 


E.161.2. 修改 列表 


。 修复 日 期 时 间 输 入 画 数 ， 当 运行 在 64 位 的 平台 上 时 正确 的 检测 整数 浴 出 (Tom) 
。 提升 向 系统 日 志 写 入 非常 长 的 日 志 信 息 时 的 性 能 (Tom) 
e 修复 SELECT DISTINCT on 查询 上 向 后 扫描 一 个 游标 中 的 bug (Tom) 


。 修复 规划 器 估算 croup BY 表达 式 产生 的 布尔 结果 总 是 在 两 个 组 里 ， 不 管 表 达 式 的 内 容 是 
什么 (Tom) 


这 上 比 普 通 croup BY 估算 确定 的 布尔 测试 UR col. rs nul ) 实质 上 来 说 更 加 精确 。 


。 改善 未 能 发 送 一 个 SQL 命令 之 后 pg_dump 和 pg _restore 的 错误 报告 (Tom) 


E.162. 版 本 7.4.21 


发 布 日 期 : 2008-06-12 
这 个 版 本 包含 一 系列 7.4.20 的 bug 修 复 。 关 于 7.4 主 版 本 的 新 特性 的 信息 ， 请 查阅 Section 
E:183。 


E.162.1. 迁移 到 版 本 7.4.21 


运行 7.4.X 的 用 户 不 需要 转 储 /恢复 。 不 过 ， 如 果 你 是 从 一 个 早 于 7.4.11 的 版 本 升级 而 来 ， ; 
看 7.4.11 的 版 本 声明 。 


at 
ò 


E.162.2. 修改 列表 


。 使 pg_get_ruledef() 将 负 的 常量 加 入 括号 内 (Tom) 


在 这 个 修复 之 前 ， 视 图 或 规则 中 的 一 个 负 的 常量 可 能 会 被 抛弃 ， 说 -42::integer ， 这 是 
不 正确 的 : 应 该 是 (-42)::integer , 因为 操作 符 优 先 的 规则 。 通常 这 会 有 一 点 不 同 ， 但 
是 它 会 与 另外 一 个 最 近 的 路 径 相 互 作用 导致 PostgreSQL 拒绝 一 个 有 效 
的 SELECT DISTINCT 视图 查询 。 因 为 这 会 导致 png_dump 的 输出 未 能 重 载 ， 所 以 被 视 为 一 
个 高 优先 级 的 修复 。 转 储 输 出 实际 上 不 正确 的 发 行 版 本 是 8.3.1 和 8.2.7。 


E.163. 版 本 7.4.20 


发 布 日 期 : 从 未 发 布 
这 个 版 本 包含 各 种 自 7.4.19 以 来 的 修复 。 关 于 7.4 主 版 本 的 新 特性 的 信息 ， 请 查阅 Section 
E182; 


E.163.1. 迁移 到 版 本 7.4.20 


运行 7.4.X 的 用 户 不 需要 转 储 /恢复 。 不 过 ， 如 果 你 是 从 一 个 早 于 7.4.11 的 版 本 升级 而 来 ， ; 
看 7.4.11 的 版 本 声明 。 


at 
lò 


E.163.2. 修改 列表 
。 修复 ISO-8859-5 和 其 他 编码 之 间 的 转换 ， 以 处 理 Cyrillic "Yo" 字 符 〈 带 有 两 个 点 
BJ e #l e ) (Sergey Burladyan) 


。 修复 一 些 数据 类 型 输入 函数 ， 他 们 人 允许 未 使 用 的 字 节 在 他 们 的 结果 中 包含 未 初始 化 的 、 
不 可 预期 的 值 (Tom) 


这 会 导致 两 个 表面 上 一 样 的 字面 值 不 被 认为 相等 的 失败 ， 导 致 分 析 器 抱怨 不 匹配 的 


ORDER BY 和 DISTINCT 表达 式 。 


。 修复 正则 表达 式 子 字符 串 匹 配 中 的 极端 情况 ( substring(**_string_ from _pattern_ )) 
(Tom) 


这 个 问题 发 生 在 有 一 个 完全 匹配 的 模式 的 时 候 ， 但 是 用 户 已 经 指定 了 一 个 加 括号 的 子 表 
达 式 ， 并 且 该 子 表达 式 没有 得 到 匹配 。 一 个 例子 

是 substring('foo' from 'foo(bar)?') o 这 个 应 该 返回 NULL， 因为 (bar) 不 匹配 ， 但 
是 它 错误 的 返回 了 整个 模式 匹配 〈 也 就 是 ， foo ) 。 


e 修复 ecpg 的 PGTYPEStimestamp_sub() 函数 中 不 正确 的 结果 (Michael) 
bd 修复 DatumGetBool 宏 使 用 gcc 4.3 时 不 会 失败 (Tom) 


这 个 问题 影响 "老式 风格 " (VO)MCHAGREA i. 该 修复 已 经 在 8.3 中 ， 但 是 当时 没有 
意识 到 需要 回来 修补 它 。 


。 修复 长 期 存在 的 LISTEN / NoTIFY ŽARI (Tom) 


在 少数 情况 下 ， 刚 刚 执 行 了 一 个 cisten 的 会 话 可 能 不 会 得 到 一 个 通知 ， 即使 应 该 这 样 ， 
因为 并 发 事务 执行 NOTIFY 会 观察 到 提交 以 后 。 


该 修复 的 一 个 副作用 是 一 个 执行 了 还 未 提交 的 Listen 命令 的 事务 将 看 不 到 任何 
在 pg_listener 中 的 行 ， 而 它 应 该 是 能 看 到 的 ; 以 前 它 也 是 能 看 到 的 。 这 个 行为 从 未 有 
过 这 种 或 那 种 的 记录 ， 但 是 一 些 依赖 于 老 的 行为 的 应 用 是 有 可 能 出 现 的 。 


修复 oRDER BY 和 croup BY 中 常数 表达 式 的 显示 (Tom) 
一 个 明确 转换 的 常量 会 不 正确 的 显示 。 这 会 导致 ， 例 如 转 储 和 重 载 期 间 视 图 定义 损坏 。 
修复 libpq 以 正确 的 处 理 COPY OUT 期 间 的 NOTICE 消 息 (Tom) 


这 个 故障 只 在 一 个 用 户 定 义 的 数据 类 型 的 输出 程序 发 出 一 个 NOTICE 时 可 以 观察 到 发 生 ， 
但 是 不 保证 它 不 会 由 于 其 他 原因 发 生 。 


E.164. 版 本 7.4.19 


发 布 日 期 : 2008-01-07 


这 个 版 本 包含 各 种 自 7.4.18 以 来 的 修复 ， 包 括 重 大 安全 问题 的 修复 。 关于 7.4 主 版 本 的 新 特性 
的 信息 ， 请 查阅 Section E.183。 


E.164.1. 迁移 到 版 本 7.4.19 


运行 7.4.X 的 用 户 不 需要 转 储 /恢复 。 不 过 ， 如 果 你 是 从 一 个 早 于 7.4.11 的 版 本 升级 而 来 ， ; 
看 7.4.11 的 版 本 声明 。 


ah 
(ò 


E.164.2. 修改 列表 


e 阻止 索引 中 的 函数 用 用 户 的 权限 执行 vacuum. ANALYZE 等 (Tom) 


在 索引 表达 式 和 部 分 索引 判断 中 使 用 的 画 ee 个 新 的 表 条 目 时 评估 。 早 就 知道 如 
果 某 人 修改 了 一 个 不 受信 任 的 用 户 拥 有 的 表 ， 会 造成 特洛伊 木马 代码 执行 的 风险 。 (请 
注意 ， 触 发 器 、 缺 省 、 检 查 约束 等 ， ERER AEH: ) esl PHAR Z 
外 的 危险 ， 因为 它们 将 被 日 常 维护 操作 (如 vacuum FuLL ) 执行 ， 而 它们 在 超级 用 户 账 
户 下 通常 是 自动 执行 的 。 例 如 ， 一 个 不 法 用 户 通过 设置 一 个 特洛伊 木马 索引 定义 并 等 待 
下 一 个 日 常 清理 ， 可 以 使 用 超级 用 户 权限 执行 代码 。 该 修复 为 标准 的 维护 操作 安排 了 ( 包 
括 VACUUM 、 ANALYZE 、 REINDEX 、 和 cLusTER ) 作 为 表 的 所 有 者 执行 而 不 是 调用 的 用 
È, 相同 的 权限 切换 机 制 早 已 为 SECURITY DEFINER 图 数 使 用 了 。 为 了 阻止 绕 开 这 个 安全 
措施 ， SET SESSION AUTHORIZATION 和 SET ROLE 现在 禁止 在 SECURITY DEFINER 内 容 中 执 
行 。 (CVE-2007-6600) 


。 修复 正则 表达 式 包 中 的 各 种 bug (Tom, Will Drewry) 


适当 配置 的 正则 表达 式 模 式 可 能 会 导致 月 溃 、 无 限 或 接近 无 限 循环 、 和 /或 大 量 的 内 存 消 
耗 ， 所 有 这 些 都 造成 从 不 受信 任 的 源 接受 正则 表达 式 搜 索 模 式 的 应 用 拒绝 服务 的 风险 。 
(CVE-2007-4769, CVE-2007-4772, CVE-2007-6067) 


e 要 求 使 用 /contrib/dblink 的 非 超级 用 户 只 使 用 密码 认证 作为 安全 措施 (Joe) 


在 7.4.18 中 出 现 的 这 个 修复 是 不 完全 的 ， 因 为 它 只 堵 住 了 一 些 dblink BAMA. 
(CVE-2007-6601, CVE-2007-3278) 


e 修复 WHERE false AND var IN (SELECT ...) 的 某 些 情况 下 规划 器 失败 (Tom) 


。 修复 使 用 多 字 节 数据 库 编码 时 translate() P TEASA (Tom) 


修复 PL/Python 在 长 的 异常 消息 时 不 骨 溃 (Alvaro) 
ecpg 语 法 分 析 器 修复 (Michael) 


使 contrib/tablefunc 的 crosstab() 独立 的 将 NULL rowid 作 为 一 个 类 别处 理 ， 而 不 是 朋 
wat (Joe) 


修复 tsvector 和 tsquery 输出 例 程 ， 以 正确 的 逃逸 反 斜 杠 (Teodor, Bruce) 
修复 to_tsvector() FEXAWMAS A BEM (Teodor) 
当 重 新 生成 configure 脚本 时 ， 要 求 指定 要 使 用 的 Autoconf 的 版 本 (Peter) 


这 只 影响 开发 者 和 打包 者 。 这 个 修改 是 为 了 阻止 未 经 测验 的 Autoconf 和 PostgreSQL 版 本 
的 组 合 的 意外 使 用 。 如 果 你 实在 是 想 要 使 用 一 个 不 同 的 Autoconf 版 本 ， 可 以 移 除 版 本 校 
验 ， 但 是 结果 如 何 就 是 你 的 责任 了 。 


E.165. 版 本 7.4.18 


发 布 日 期 : 2007-09-17 


这 个 版 本 包含 自 7.4.17 以 来 的 修复 。 关 于 7.4 主 版 本 的 新 特性 的 信息 ， 请 查阅 Section E.183。 


E.165.1. 迁移 到 版 本 7.4.18 


运行 7.4.X 的 用 户 不 需要 转 储 /恢复 。 不 过 ， 如 果 你 是 从 一 个 早 于 7.4.11 的 版 本 升级 而 来 ， 请 查 
看 7.4.11 的 版 本 声明 。 


E.165.2. 修改 列表 


。 当 一 个 事务 插入 行 然 后 在 接近 相同 表 中 并 发 的 vacuum 的 结尾 退出 时 ， 阻止 索引 损坏 
(Tom) 


e 使 得 CREATE DOMAIN ... DEFAULT NULL 适当 的 运行 (Tom) 

。 修复 SSL 错 误 消息 过 多 的 记录 (Tom) 

e 修复 log min_error_statement 日 志 耗 尽 内 存 时 的 崩溃 (Tom) 

e 阻止 cLusTER 由 于 尝试 处 理 其 他 会 话 的 临时 表 引 起 的 失败 (Alvaro) 

e ZRH /contrib/dblink 的 非 超 级 用 户 只 使 用 密码 认证 ， 作 为 一 个 安全 措施 (Joe) 


E.166. 版 本 7.4.17 


发 布 日 期 : 2007-04-23 


这 个 版 本 包含 自 7.4.16 以 来 的 修复 ， 包 括 一 个 安全 修复 。 关 于 7.4 主 版 本 的 新 特性 的 信息 ， 请 
查阅 Section E.183。 


E.166.1. 迁移 到 版 本 7.4.17 


运行 7.4.X 的 用 户 不 需要 转 储 /恢复 。 不 过 ， 如 果 你 是 从 一 个 早 于 7.4.11 的 版 本 升级 而 来 ， ; 
看 7.4.11 的 版 本 声明 。 


at 
lò 


E.166.2. 修改 列表 
e 支持 在 search_path 中 的 临时 表 模 式 有 明确 的 位 置 ， 并 且 禁 用 函数 和 操作 符 搜 索 它 
(Tom) 


这 需要 允许 安全 定义 函数 设置 真实 的 search path 的 安全 值 。 没有 他 ， 无 特权 的 SQL 用 
户 可 以 使 用 临时 对 象 以 安全 定义 函数 的 权限 执行 代码 (CVE-2007-2138)。 参 
阅 CREATE FUNCTION 获取 更 多 信息 。 


e 修复 /contrib/tsearch2 骨 溃 (Teodor) 
。 修复 vacuum FuLL 如 何 处 理 uppate 链条 中 潜在 的 数据 损坏 bug (Tom, Pavan Deolasee) 


。 修复 哈 希 索引 扩大 时 的 PANIC (在 7.4.15 引 进 的 bug) (Tom) 


E.167. 版 本 7.4.16 


发 布 日 期 : 2007-02-05 


这 个 版 本 包含 各 种 自 7.4.15 以 来 的 修复 ， 包 括 一 个 安全 修复 。 关 于 7.4 主 版 本 的 新 特性 的 信 
息 ， 请 查阅 Section E.183。 


E.167.1. 迁移 到 版 本 7.4.16 


运行 7.4.X 的 用 户 不 需要 转 储 /恢复 。 不 过 ， 如 果 你 是 从 一 个 早 于 7.4.11 的 版 本 升级 而 来 ， ; 
看 7.4.11 的 版 本 声明 。 


ah 
(ò 


E.167.2. 修改 列表 


。 删除 允许 连接 的 用 户 读 取 后 端 内 存 的 安全 漏洞 (Tom) 


弱点 包括 : 抑制 了 SQL 画 数 返 回声 明 的 数据 类 型 的 正常 检查 ， 或 改变 了 用 于 SQL 郴 数 中 
的 表 字 段 的 数据 类 型 (CVE-2007-0555)。 这 个 错误 可 以 轻易 的 被 和 利用， 导致 后 端 朋 溃 ， 
原则 上 ， 可 能 被 用 来 读 取 用 户 不 应 该 可 以 访问 的 数据 库 内 容 。 


。 修复 由 于 选择 了 一 个 不 可 行 的 分 裂 点 引起 的 btree 索 引 页 分 裂 失败 的 少见 bug (Heikki 
Linnakangas) 


e 修复 由 uno 触发 的 少见 的 Assert() 朋 溃 (Tom) 


e。 加 强 超 过 3 字 节 长 度 的 UTF8 序 列 的 多 字 节 字符 处 理 的 安全 (Tom) 


E.168. 版 本 7.4.15 


发 布 日 期 : 2007-01-08 


这 个 版 本 包含 各 种 自 7.4.14 以 来 的 修复 。 关 于 7.4 主 版 本 的 新 特性 的 信息 ， 
E.183, 


E.168.1. 迁移 到 版 本 7.4.15 


运行 7.4.X 的 用 户 不 需要 转 储 /恢复 。 不 过 ， 如 果 你 是 从 一 个 早 于 7.4.11 的 版 本 升级 而 来 ， ; 


看 7.4.11 的 版 本 声明 。 


E.168.2. 修改 列表 


e 改善 getaddrinfo() 在 AIX 上 的 处 理 (Tom) 

这 修复 了 启动 统计 收集 器 的 问题 ， 除 了 别 的 之 外 。 
。 修复 vacuum 中 的 "failed to re-find parent key" 错 误 (Tom) 
。 修复 影响 多 个 干粮 字 节 的 哈 希 索引 的 bug (Tom) 


。 修复 构造 一 个 由 多 个 空 的 元 素 组 成 的 ARRAY[] 时 的 错误 (Tom) 


请 查阅 Section 


ah 


e 对 于 新 的 initdb 安 装 ， to_number() 和 to_char(numeric) 现在 是 STABLE, 不 


是 IMMUTABLE (Tom) 
这 是 因为 lc_numeric 可 以 潜在 的 改变 这 些 函 数 的 输出 。 
© 改善 索引 对 带 括号 的 正则 表达 式 的 使 用 (Tom) 


这 也 改善 了 psql \d 的 性 能 。。 


lor 


E.169. 版 本 7.4.14 


发 布 日 期 : 2006-10-16 


这 个 版 本 包含 各 种 自 7.4.13 以 来 的 修复 。 关 于 7.4 主 版 本 的 新 特性 的 信息 ， 
E.183, 


E.169.1. 迁移 到 版 本 7.4.14 


运行 7.4.X 的 用 户 不 需要 转 储 /恢复 。 不 过 ， 如 果 你 是 从 一 个 早 于 7.4.11 的 版 本 升级 而 来 ， ; 


看 7.4.11 的 版 本 声明 。 


E.169.2. 修改 列表 


© 修复 无 类 型 的 文字 被 当做 是 ANYARRAY 时 的 内 核 转 储 

。 修复 string_to_array() 处 理 分 隔 符 字符 串 的 重生 的 匹配 
例如 ， string to array('123xx456xxx789'，'xx') o 

e 修复 psql 的 \d 命令 中 模式 匹配 的 极端 情况 

e 修复 /contrib/ltree 中 的 索引 损坏 bug (Teodor) 

e (€8/contrib/dbmirror PAY RRL ER 


e 为 最 近 US DST 规 律 中 的 改变 调整 回归 测试 


请 查阅 Section 


at 


lor 


E.170. 版 本 7.4.13 


发 布 日 期 : 2006-05-23 


这 个 版 本 包含 各 种 自 7.4.12 以 来 的 修复 ， 包 括 非 常 严重 的 安全 问题 的 补丁 。 关于 7.4 主 版 本 的 
新 特性 的 信息 ， 请 查阅 Section E.183。 


E.170.1. 迁移 到 版 本 7.4.13 


运行 7.4.X 的 用 户 不 需要 转 储 /恢复 。 不 过 ， 如 果 你 是 从 一 个 早 于 7.4.11 的 版 本 升级 而 来 ， 请 查 
看 7.4.11 的 版 本 声明 。 


针对 CVE-2006-2313 和 CVE-2006-2314 中 描述 的 SQL 注 入 攻击 的 完全 安全 可 能 需要 在 应 用 代 
码 中 改变 。 如 果 你 的 应 用 府 入 了 不 能 信赖 的 字符 串 到 SQL 命 舍 中 ， 你 应 该 尽快 检查 他 们 ， 以 
确保 他 们 使 用 推荐 的 逃逸 技术 。 在 大 多 数 情况 下 ， 应 用 应 该 使 用 库 或 驱动 提供 的 子 程序 (如 
libpq 的 Pgescapestringconn() ) 来 执行 字符 串 逃 逸 ， 而 不 是 依赖 于 ad hoc 代 码 实 现 。 


E.170.2. 修改 列表 


© 改变 服务 器 以 在 任何 情况 下 都 拒绝 无 效 编码 的 多 字 节 字符 (Tatsuo, Tom) 


$ 
PostgreSQL 已 经 朝 这 个 方向 发 展 有 一 段 时 间 了 ， 检查 现在 一 致 的 应 用 于 所 有 的 编码 和 所 
有 的 文本 输入 中 ， 并 且 现 在 总 是 错误 而 不 仅仅 是 警告 。 这 个 改变 防卫 了 CVE-2006-2313 
中 描述 的 SQL 注 入 类 型 的 攻击 。 


。 拒绝 在 字符 串 字 面值 中 不 安全 的 使 用 V 


作为 服务 器 端 防卫 CVE-2006-2314 中 描述 的 类 型 的 SQL 注入 攻击 ， 该 服务 器 现在 在 SQL 
字符 串 字 面值 中 只 接受 '' ， 不 接受 、 作为 ASClI 单 引号 的 表示 。 缺 省 的 ，、\' 只 
在 client_encoding 设置 为 仅 客户 端的 编码 (SJIS,， BIG5, GBK, GB18030, 或 UHC) 时 拒 
绝 ， 这 是 可 能 有 SQL 注 入 的 情况 。 可 用 一 个 新 的 配置 参数 backslash_quote 在 需要 时 调 
节 这 个 行为 。 请 注意 ， 针 对 CVE-2006-2314 的 完全 安全 可 能 要 求 客户 端 侧 的 改变 ; 
backslash_quote 的 目的 是 在 一 定 程 度 上 使 得 不 安全 的 客户 端 变 得 明显 。 

。 修改 libpq 的 字符 串 逃 逸 例 程 ， 知道 编码 注意 事项 和 standard_conforming_strings 
这 修复 了 使 用 libpq 的 应 用 针对 CVE-2006-2313 和 CVE-2006-2314 中 描述 的 安全 问题 ， 也 
预防 了 转换 到 SQL 标准 字符 串 文 字 语法 的 计划 。 使 用 多 个 PostgreSQL 连接 并 发 的 应 用 应 


该 迁移 到 PQescapeStringconn() 和 PQescapeByteaconn() ， 以 确保 每 个 数据 库 连 接 中 使 用 
的 逃逸 设置 正确 的 动作 了 。 "手动 "实现 字符 串 逃 逸 的 应 用 应 该 修改 为 依赖 于 库 例 程 。 


修复 一 些 不 正确 的 编码 转换 图 数 


wini251_to_iso ~ alt_to_iso 、 euc_tw_to_big5 ~ euc_ tw to mic 、 mic_to_euc_tw 在 


转换 内 容 时 都 会 损坏 。 

清理 \' 在 字符 串 中 剩余 的 使 用 (Bruce, Jan) 

修复 有 时 会 导致 where OR 条 件 素 引 扫描 漏 掉 应 该 返回 的 行 的 bug 
修复 btree 索 引 被 截断 情况 下 的 WAL 重 放 

为 包含 | 的 模式 修复 sTMITLAR to (Tom) 

修复 服务 器 正确 的 使 用 自 定义 DH SSL 参 数 (Michael Fuhr) 

修复 Intel Macs 上 的 Bonjour (Ashley Clark) 


修复 各 种 小 的 内 存 泄露 


E.171. 版 本 7.4.12 


发 布 日 期 : 2006-02-14 
这 个 版 本 包含 各 种 自 7.4.11 以 来 的 修复 。 关 于 7.4 主 版 本 的 新 特性 的 信息 ， 请 查阅 Section 
E.183。 


E.171.1. 迁移 到 版 本 7.4.12 


运行 7.4.X 的 用 户 不 需要 转 储 /恢复 。 不 过 ， 如 果 你 是 从 一 个 早 于 7.4.11 的 版 本 升级 而 来 ， ; 
看 7.4.11 的 版 本 声明 。 


ah 
(ò 


E.171.2. 修改 列表 


e 修复 SET SESSION AUTHORIZATION 中 潜在 的 崩溃 (CVE-2006-0553) 


一 个 非特 权 的 用 户 可 能 会 使 服务 器 进程 朋 江 ， 导 致 短暂 的 拒绝 对 其 他 用 户 的 服务 ， 如 果 
服务 器 编译 启用 了 断言 (RAT EHA) 。 感 谢 Akio lshida 报 告 这 个 问题 。 


。 修复 自动 插入 的 行 的 行 可 见 性 逻辑 bug (Tom) 


在 极 少数 情况 下 ， 当 前 命 合 插 入 的 行 可 能 被 视 为 早 就 有 效 了 ， 而 此 时 不 应 该 这 样 。 修复 
了 在 7.4.9 和 7.3.11 版 本 中 创建 的 bug。 


。 修复 在 pg_clog 文 件 创建 期 间 可 能 导致 "文件 早已 存在 "错误 的 竞 态 条 件 (Tom) 
。 在 预备 语句 中 为 unknow 参数 适当 的 检查 domain 约束 (Neil) 

。 修复 以 允许 恢复 的 转 储 有 到 自 定义 操作 的 交叉 模式 引用 (Tom) 

。 修复 配置 期 间 的 可 移植 性 ， 以 测试 finite 和 isinf 的 存在 (Tom) 


E.172. 版 本 7.4.11 


发 布 日 期 : 2006-01-09 


这 个 版 本 包含 各 种 自 7.4.10 以 来 的 修复 。 关 于 7.4 主 版 本 的 新 特性 的 信息 ， 请 查阅 Section 
E182; 


E.172.1. 迁移 到 版 本 7.4.11 


运行 7.4.X 的 用 户 不 需要 转 储 /恢复 。 不 过 ， 如 果 你 是 从 一 个 早 于 7.4.8 的 版 本 升级 而 来 ， 请 查 
看 7.4.8 的 版 本 声明 。 还 有 ， 你 可 能 需要 在 升级 之 后 REINDEX 在 文本 字段 上 的 索引 ， 如 果 你 受 
下 面 描述 的 本 地 或 plper| 问 题 的 影响 。 


E.172.2. 修改 列表 


。 修复 在 一 个 事务 外 部 或 一 个 失败 的 事务 内 部 发 出 的 协议 级 别 描述 信息 (Tom) 
。 修复 字符 串 比 较 认 为 不 同 的 字符 组 合 是 相等 的 环境 ， 如 Hungarian (Tom) 

这 可 能 需要 REINDEX 以 修复 在 文本 字段 上 已 经 有 了 的 索引 。 
。 在 主 进 程 启动 期 间 设置 本 地 环境 变量 ， 以 确保 plperl 不 会 在 稍 后 改变 本 地 环境 


这 修复 了 一 个 问题 ， 该 问题 在 postmaster 以 与 initdb 给 出 的 不 同 的 环境 变量 启动 时 发 生 。 
在 这 种 情况 下 ， 任 何 plperl 的 使 用 都 可 能 导致 素 引 损坏 。 如 果 发 生 了 这 种 情况 ， 你 可 能 需 
要 REINDEX 以 修复 在 文本 字段 上 已 经 存在 的 索引 。 


。 修复 strpos() 和 正则 表达 式 义理 某 些 很 少 使 用 的 Asian 多 字 节 字符 设置 中 长 期 存在 的 bug 
(Tatsuo) 


e 修复 /contrib/pgcrypto gen_salt 中 的 bug， 它 导 致 不 能 使 用 所 有 的 MD5 和 XDES 算 法 的 
盐 空 间 (Marko Kreen, Solar Designer) 


盐 对 Blowfish 和 标准 的 DES 是 没有 影响 的 。 


e 修复 /contrib/dblink 当 指 定 的 字段 数量 与 实际 查询 返回 的 不 同时 ， 抛 出 一 个 错误 ， 而 不 
是 崩溃 (Joe) 


E.173. 版 本 7.4.10 


发 布 日 期 : 2005-12-12 
这 个 版 本 包含 各 种 自 7.4.9 以 来 的 修复 。 关 于 7.4 主 版 本 的 新 特性 的 信息 ， 请 查阅 Section 
E.183。 


E.173.1. 迁移 到 版 本 7.4.10 


运行 7.4.X 的 用 户 不 需要 转 储 /恢复 。 不 过 ， 如 果 你 是 从 一 个 早 于 7.4.8 的 版 本 升级 而 来 ， i 
看 7.4.8 的 版 本 声明 。 


at 
lò 


E.173.2. 修改 列表 


。 修复 事务 日 志 管理 中 的 竞 态 条 件 
有 一 个 罕 的 窗口 ， 在 这 里 错误 的 页 面 可 以 发 起 一 个 MO 操作 ， 导 致 维护 失败 或 数据 损坏 。 
。 当当 前 事务 已 经 中 止 ， 如 果 客 户 端 发 送 捆绑 的 协议 信息 时 ， 阻 止 失败 
e /contrib/ltree 修复 (Teodor) 
。 AIX 和 HPUX 编译 修复 (Tom) 
。 修复 长 期 存在 的 外 连接 的 规划 错误 


这 个 bug 有 时 会 导致 一 个 假 的 错误 "RIGHT JOIN is only supported with merge-joinable 
join conditions", 


当 一 个 表 已 经 被 删除 时 ， 阻 止 pg_autovacuum 中 的 内 核 转 储 


E.174. 版 本 7.4.9 


发 布 日 期 : 2005-10-04 


这 个 版 本 包含 各 种 自 7.4.8 以 来 的 修复 。 关 于 7.4 主 版 本 的 新 特性 的 信息 ， 请 查阅 Section 
E.183。 


E.174.1. 迁移 到 版 本 7.4.9 


运行 7.4.X 的 用 户 不 需要 转 储 /恢复 。 不 过 ， 如 果 你 是 从 一 个 早 于 7.4.8 的 版 本 升级 而 来 ， i 
看 7.4.8 的 版 本 声明 。 


at 
| 


E.174.2. 修改 列表 


ISS iF vacuum WER ctid 链 太 快 的 错误 ， 并 且 在 跟随 ctid 连接 的 代码 中 添加 更 多 检 


X 


e 
一 ~ 


K 


jo 


这 修复 了 一 个 可 能 在 非常 少 的 情况 下 导致 崩溃 的 长 期 存在 的 问题 。 


修复 当 使 用 一 个 多 字 节 字符 设置 时 ， cHAR() 适当 的 填补 空格 到 指定 的 长 度 (Yoshiyuki 
Asaba) 


在 以 前 的 版 本 中 ， charo 的 填补 是 不 正确 的 ， 因 为 它 只 填补 到 指定 的 字 节 数量 ， 而 不 考 
虑 存储 多 少 个 字 节 。 


修复 copy 只 读 事务 测试 的 感觉 


代码 以 前 禁止 copy To ， 实 际 上 应 该 禁止 的 是 coPY From o 


修复 子 句 上 的 外 连接 只 引用 内 侧 关系 的 规划 问题 


进一步 修复 x FULL JOIN y ON true 的 极端 情况 
e 使 得 array_in 和 array_recv 更 执着 的 验证 它们 的 OID 参 数 
e 修复 像 uppATE a=... WHERE a... with GiST index on column a 这 样 的 查询 中 丢失 的 行 


提高 日 期 时 间 解 析 的 鲁 棒 性 


改善 检查 部 分 写 和 人 的 WAL 页 面 
e 改善 当 启 用 了 SSL 时 信号 义理 的 重 棒 性 
在 主 进程 启动 期 间 不 要 党 试 打开 超过 max_files_per_process 的 文件 


修复 各 种 内 存 泄露 

提高 各 种 可 移植 性 

修复 当 变量 是 引用 传递 类 型 时 ，PL/pgSQL 正 确 的 处 理 var := var 
更 新 contrib/tsearch2 以 使 用 现在 的 Snowball 代 码 


E.175. 版 本 7.4.8 


发 布 日 期 : 2005-05-09 


这 个 版 本 包含 各 种 自 7.4.7 以 来 的 修复 ， 包 括 几 个 安全 相关 的 问题 。 关 于 7.4 主 版 本 的 新 特性 的 
信息 ， 请 查阅 Section E.183。 


E.175.1. 迁移 到 版 本 7.4.8 


运行 7.4.X 的 用 户 不 需要 转 储 /恢复 。 不 过 ， 有 可 能 在 7.4.X 系 统 日 志 最 初 的 内 容 中 处 理 两 个 已 
经 发 现 的 重大 安全 问题 。 一 个 使 用 7.4.8 的 dumpyinitdby/reload 序 列 initdb 将 自动 纠正 这 些 问 


是 。 


较 大 的 安全 问题 是 内 建 字 符 集 编码 转换 画 数 可 以 被 非特 权 的 用 户 从 SQL 命令 调用 ， 但 是 该 罚 
数 不 是 设计 来 这 样 使 用 的 ， 并 且 在 恶意 的 选择 参数 时 是 不 安全 的 。 该 修复 包括 改变 这 些 函 数 
声明 的 参数 列表 ， 这 样 他 们 可 以 不 再 从 SQL 命令 调用 。 (这 不 影响 他 们 通过 编码 转换 机 制 的 
正常 使 用 。) 


较 小 的 问题 是 contrib/tsearch2 模块 创建 了 几 个 函数 ， 这 几 个 函数 错误 的 声明 为 返 
E] internal 而 它们 不 接受 internal 参数 。 这 破坏 了 所 有 使 用 internal 参数 的 函数 的 类 型 安 
全 。 


强烈 建议 所 有 的 安装 都 修复 这 些 错误 ， 通 过 initdb 或 者 通过 下 面 给 出 的 手动 修复 程序 。 该 错误 
至 少 人 允许 未 授权 的 数据 库 用 户 骨 溃 他 们 的 服务 器 进程 ， 并 且 可 能 允许 未 授权 的 用 户 获取 数据 
库 超级 用 户 的 权限 。 


如 果 不 想 做 initdb， 那 么 执行 下 面 的 程序 。 作 为 数据 库 超级 用 户 ， 执 行 : 


BEGIN; 
UPDATE pg_proc SET proargtypes[3] = 'internal'::regtype 
WHERE pronamespace = 11 AND pronargs = 5 
AND proargtypes[2] = 'cstring'::regtype; 
- The command should report having updated 90 rows; 
- if not, rollback and investigate instead of committing! 
COMMIT; 


下 一 步 ， 如 果 你 已 经 安装 了 contrib/tsearch2 ， 执 行 : 


BEGIN; 

UPDATE pg_proc SET proargtypes[0] = 'internal'::regtype 

WHERE oid IN ( 
"dex_init(text)'::regprocedure, 
"snb_en_init(text)'::regprocedure, 
"snb_ru_init(text)'::regprocedure, 
"spell_init(text)'::regprocedure, 
"syn_init(text)'::regprocedure 

); 

-- The command should report having updated 5 rows; 

-- if not, rollback and investigate instead of committing! 

COMMIT; 


如 果 这 个 命令 带 有 像 "function "dex_init(text)" does not exist" 这 样 的 消息 失败 ， 那 么 要 么 在 这 
个 数据 库 中 没有 安装 tsearch2 ， 要 么 你 已 经 执行 了 该 更 新 。 


上 面 的 程序 必须 在 每 个 安装 的 数据 库 中 执行 ， 包括 template ， 理想 上 也 包括 templateO o 
如 果 你 没有 修复 模板 数据 库 ， 那么 任何 随后 创建 的 数据 库 都 将 包含 相同 的 错 

iko templatel 的 修复 方式 和 其 他 数据 库 相 同 ， 但 是 修复 templated 需要 额外 的 步骤 。 首 
先 ， 从 任意 数据 库 中 发 出 : 


UPDATE pg_database SET datallowconn = true WHERE datname = 'template0d'; 


下 一 步 ， 连 接 到 templateo ， 并 执行 上 面 的 修复 步骤 。 最 后 ， 执 行 : 


- re-freeze templated: 

VACUUM FREEZE; 

- and protect it against future alterations: 

UPDATE pg_database SET datallowconn = false WHERE datname = 'templateo'; 


E.175.2. 修改 列表 


e 改变 编码 图 数 签名 以 阻止 滥用 
e 修改 contrib/tsearch2 以 避免 不 安全 的 使 用 INTERNAL BAY 


。 修复 允许 一 个 事务 因为 某 些 原因 (如 SELECT FOR UPDATE) 比 其 他 原因 稍 早 的 被 看 做 
是 已 提交 的 过 时 的 竞 态 条 件 


这 是 一 个 非常 严重 的 bug， 因 为 它 会 导致 表面 上 的 数据 不 一 致 被 应 用 短暂 的 看 到 。 
。 修复 关系 扩展 和 VACUUM 之 间 的 竞 态 条 件 


这 理论 上 会 导致 最 近 插 入 的 一 页 数据 丢失 ， 尽 管 这 种 情况 看 起 来 可 能 性 非常 小 。 没有 已 
知 的 情况 说 它 会 引起 超过 一 个 维护 的 失败 。 


e 修复 TIME WITH TIME ZONE 值 的 比较 


当 使 用 了 --enable-integer-datetimes 配置 开关 时 ， 比 较 代 码 是 错误 的 。 注意 : 如 果 你 
在 TIME WITH TIME ZONE 字段 上 有 一 个 索引 ， 它 将 需要 在 安装 这 个 更 新 之 后 REINDEX ， 
为 该 修复 纠正 了 字段 值 的 排序 顺序 。 


为 TIME WITH TIME ZONE 值 修 复 EXTRACT(EPOCH) 

修复 负 的 分 数秒 在 INTERVAL 值 中 的 错误 显示 

这 个 错误 只 在 使 用 了 --enable-integer-datetimes 配置 开关 的 时 候 发 生 。 
确保 在 后 端 关闭 期 间 所 做 的 操作 都 被 统计 收集 器 计数 了 


这 预计 能 解决 pg_autovacuum 清 理 系统 目录 不 够 频繁 的 报告 一 没有 被 告知 在 后 端 退出 期 
间 由 于 临时 表 删 除 引 起 的 目录 删除 。 


在 plpgsql 中 追加 缓冲 区 浴 出 检查 (Neil) 

修复 pg_dump 以 正确 的 转 储 名 字 包 含 % 的 触发 器 (Neil) 
为 更 新 的 OpenSSL 建 立 修复 contrib/pgcrypto (Marko Kreen) 
为 contrib/intagg 更 多 的 64 位 修复 

阻止 返回 recor 的 函数 不 正确 的 最 优化 

阻止 to_char(interval) 转 储 月 相关 格式 的 内 核 

阻止 coALEScE(NULL, NULL) -EAGAR A 

修复 array map 以 正确 的 调用 PL 画 数 

修复 ALTER DATABASE RENAME 中 的 权限 检查 

修复 ALTER LANGUAGE RENAME 

使 得 RemoveFromwaitQueue 清理 它 本 身 


这 修复 了 一 个 锁 管 理 错误 ， 该 错误 只 在 这 种 情况 下 可 以 看 到 : 如 果 一 个 事务 被 从 锁 等 待 
中 踢 出 (通常 通过 查询 取消 ) ， 并 且 然 后 锁 的 持 有 者 在 一 个 非常 小 的 窗口 释放 它 。 


修复 无 类 型 的 参数 出 现在 INSERT ... SELECT 中 的 问题 


修复 ALTER TABLE SET WITHOUT 0IDS 之 后 的 cLusTER 失败 


E.176. 版 本 7.4.7 


4 #5 A HA: 2005-01-31 


这 个 版 本 包含 各 种 自 7.4.6 以 来 的 修复 ， 包 括 几 个 安全 相关 的 问题 。 关 于 7.4 主 版 本 的 新 特性 的 
信息 ， 请 查阅 Section E.183。 


E.176.1. 迁移 到 版 本 7.4.7 


运行 7.4.X 的 用 户 不 需要 转 储 /恢复 。 


E.176.2. 修改 列表 


© 不 允许 非 超级 用 户 LoAD 


在 自动 执行 一 个 共享 库 的 初始 化 函数 的 平台 上 (至 少 包括 Windows 和 ELF-based 
Unixen) , Loan 可 以 用 来 使 服务 器 执行 任意 的 代码 。 感 谢 NGS Software 报 告 这 个 问 


。 检查 聚集 图 数 的 创建 者 是 否 有 权限 执行 指定 的 转换 函数 
这 个 跑 忽 使 得 它 有 可 能 绕 开 一 个 函数 的 EXECUTE 权 限 的 拒绝 。 
。 在 contrib/intagg 中 修复 安全 和 64 位 问题 
。 添加 需要 的 STRICT 标 记 到 一 些 贡 献 事 数 (Kris Jurka) 
e 当 plpgsql 游 标 声明 有 太 多 的 参数 时 ， 避 免 缓冲 区 渝 出 (Neil) 
。 修复 FULL 和 RIGHT 外 连接 的 规划 错误 


连接 的 结果 错误 的 假设 为 和 左 侧 的 输入 排序 相同 。 这 不 只 会 交付 错误 排序 的 输出 给 用 
P, 还 会 在 谋 套 合并 连接 的 情况 下 给 出 完全 错误 的 答案 。 


。 修复 plperl 在 元 组 字段 中 的 引用 标记 
e 修复 负 的 间隔 在 SQL 和 GERMAN 日 期 类 型 中 的 显示 


e 使 age(timestamptz) 用 本 地 时 区 计算 ， 不 是 用 GMT 计 算 


E.177. 版 本 7.4.6 


发 布 日 期 : 2004-10-22 


这 个 版 本 包含 各 种 自 7.4.5 以 来 的 修复 。 关 于 7.4 主 版 本 的 新 特性 的 信息 ， 请 查阅 Section 
E.183。 


E.177.1. 迁移 到 版 本 7.4.6 


运行 7.4.X 的 用 户 不 需要 转 储 /恢复 。 


E.177.2. 修改 列表 


。 修复 在 磁盘 上 更 新 提示 部 分 可 能 的 失 鸡 


CEDRUS ER, ix PHBA S R'could not access transaction status" 失 败 ， 这 使 得 它 成 


为 一 个 潜在 的 数据 丢失 bug。 
© 人 确保 散 列 的 外 连接 不 丢失 元 组 


使 用 散 列 连接 规划 的 非常 大 的 左 连接 可 能 不 能 输出 不 匹配 的 左 侧 行 ， 只 给 出 右 侧 数据 分 
布 。 


e 不 允许 作为 root 运 行 pg _ctl 
这 是 为 了 防卫 任何 可 能 的 安全 问题 。 
o 避免 在 /tmp 中 以 make_oidjoins_check 使 用 临时 文件 


这 已 经 报告 为 一 个 安全 问题 ， 尽 管 它 几乎 不 值得 考虑 ， 因 为 非 开 发 者 没有 理由 使 用 这 个 
脚本 。 


。 阻止 强制 的 后 端 关 闭 重 新 发 出 以 前 的 命令 结果 


在 稀有 情况 下 ， 一 个 客户 端 可 能 认为 它 的 最 后 一 个 命 
强制 数据 库 关闭 而 退出 了 。 


ab 
a 
HN 
= 
= 


而 实际 上 它 已 经 由 于 


e 修复 pg_stat_get_backend_idset 中 的 bug 
这 会 导致 一 些 系 统统 计 视 图 中 的 错误 行为 。 
。 修复 主 进程 中 小 的 内 存 泄露 


e 修复 "expected both swapped tables to have TOAST tables" 错 误 


这 会 在 例如 在 ALTER TABLE DROP COLUMN 之 后 CLUSTER 的 情况 下 出 现 。 
e BHIE pg ctl restart 添加 -D 多 次 
。 修复 NULL 值 在 GiST 索 引 中 的 问题 
。 :: 不 再 看 做 是 一 个 ECPG 预 备 语句 中 的 变量 


E.178. 版 本 7.4.3 


发 布 日 期 : 2004-08-18 


这 个 版 本 包含 一 系列 对 7.4.4 的 错误 修复 。 关 于 7.4 主 版 本 的 新 特性 的 信息 ， 请 查阅 Section 
E.183。 


E.178.1. 迁移 到 版 本 7.4.5 


运行 7.4.X 的 用 户 不 需要 转 储 /恢复 。 


E.178.2. 修改 列表 


。 修复 并 发 的 B-tree 索 引 插 入 期 间 可 能 的 朋 渍 


这 个 补丁 修复 了 并 发 插入 到 B-tree 索 引 可 能 导致 服务 器 恐慌 的 稀有 情况 。 不 会 导致 永久 
的 损坏 ， 但 是 仍然 需要 重新 发 布 。 这 个 错误 在 7.4 以 前 的 版 本 中 不 存在 。 


E.179. 版 本 7.4.4 


发 布 日 期 : 2004-08-16 


这 个 版 本 包含 各 种 自 7.4.3 以 来 的 修复 。 关 于 7.4 主 版 本 的 新 特性 的 信息 ， 请 查阅 Section 
E.183。 


E.179.1. 迁移 到 版 本 7.4.4 


运行 7.4.X 的 用 户 不 需要 转 储 /恢复 。 


E.179.2. 修改 列表 


阻止 崩溃 期 间 丢 失 已 提交 事务 的 可 能 


由 于 事务 提交 和 检查 点 之 间 不 充分 的 连锁 ， 有 可 能 事务 提交 刚好 在 最 近 的 一 个 检查 点 丢 
失 之 前 ， 整体 的 或 部 分 的 ， 跟 随 着 一 个 数据 库 骨 溃 并 且 重 启 。 这 是 自 PostgreSQL 7.1 就 
已 经 存在 的 一 个 严重 的 错误 。 


在 评估 聚合 规划 的 结果 列表 之 前 检查 HAVING 约 束 
避免 会 话 的 当前 用 户 ID 被 删除 时 的 崩溃 

修复 需 行 情况 下 的 散 列 交叉 表 (Joe) 

强制 在 一 个 外 键 中 重 命名 一 个 字段 之 后 更 新 缓存 
正确 的 打印 UNION 查 询 

使 得 psql 在 COPY IN 中 适当 的 处 理 \r\n 新 行 
pg_dump 错 误 的 使 用 授予 的 选项 处 理 ACL 
修复 对 OS X 和 Solaris 的 线性 支持 

使 用 各 种 修复 更 新 JDBC 了 驱动 (build 215) 

修复 ECPG 


更 新 翻译 (各 种 各 样 的 贡献 者 ) 


E.180. 版 本 7.4.3 


发 布 日 期 : 2004-06-14 


这 个 版 本 包含 各 种 自 7.4.2 以 来 的 修复 。 关 于 7.4 主 版 本 的 新 特性 的 信息 ， 请 查阅 Section 
E.183。 


E.180.1. 迁移 到 版 本 7.4.3 


运行 7.4.X 的 用 户 不 需要 转 储 /恢复 。 


E.180.2. 修改 列表 


。 修复 使 用 非 散 列 的 聚集 时 的 临时 内 存 泄露 (Tom) 

。 修复 ECPG， 包 括 一 些 Informix 兼 容 性 (Michael) 

。 修复 线程 安全 的 编译 ， 尤 其 是 Solaris (Bruce) 

。 修复 使 用 老 的 网 络 协议 时 COPY IN 终止 中 的 错误 (ljb) 


e 几 个 pg_autovacuum 的 重要 的 修复 ， 包 括 修复 大 表 、 无 符号 的 oid、 稳 定性 、 临时 表 和 调 
试 模式 (Matthew T. O'Connor) 


。 修复 在 NetBSD 和 BSD/OS 上 读 取 tar 格 式 转 储 的 问题 (Bruce) 
e 几 个 JDBC 修 复 
。 修复 last_value 等 于 重新 开始 值 时 的 ALTER SEQUENCE RESTART (Tom) 
。 修复 未 能 重新 计算 谋 套 的 子 查 询 (Tom) 
。 修复 LIMIT/OFFSET 中 的 非常 数 表达 式 的 问题 
。 支持 没有 连接 子 句 的 FULL JOIN， 比 如 X FULL JOIN Y ON TRUE (Tom) 
。 修复 另 一 个 零 字段 表 错 误 (Tom) 
。 改善 子 查询 的 GROUP BY 子 句 中 非 限定 标 识 符 的 处 理 (Tom) 
子 查询 中 选择 列表 的 别名 的 优先 级 现在 高 于 外 查询 级 别 的 名 字 。 
。 解码 规则 时 不 要 生成 "NATURAL CROSS JOIN" (Tom) 


。 添加 对 二 进 制 COPY 中 无 效 字 段 长 度 的 检查 (Tom) 


这 修复 了 难以 利用 的 安全 漏洞 。 
e 避免 ANALYZE 和 LISTEN / NOTIFY 之 间 的 锁 冲 突 


。 许多 翻译 更 新 (各 种 各 样 的 贡献 者 ) 


E.181. 版 本 7.4.2 


发 布 日 期 : 2004-03-08 


这 个 版 本 包含 各 种 自 7.4.1 以 来 的 修复 。 关 于 7.4 主 版 本 的 新 特性 的 信息 ， 请 查阅 Section 
E.183。 


E.181.1. 迁移 到 版 本 7.4.2 


运行 7.4.X 的 用 oe Rit, 作为 合并 修复 在 最 初 的 7.4.X 系 统 目 录 中 发 现 的 两 
个 错误 的 最 简单 的 方法 ， 这 应 该 会 是 明智 的 。 使 用 7.4.2 的 initdb 的 dump/initdb/reload 序 列 将 
自动 纠正 这 些 问 题 。 


更 严重 的 两 个 错误 是 数据 类 型 anyarray 有 错误 的 对 齐 标签 ; 这 是 一 个 问题 ， 

为 pg_statistic 有 系统 目录 使 用 anyarray 字段 。 贴 错 标 ZABERA 误 估计 甚至 当 包 

& WHERE Re eal eam 的 字段 (如 float8 和 timestamp ) Eat AB Fo 强烈 建 
议 所 有 安装 都 修复 这 个 错误 ， 通 过 initdb 或 遵循 下 面 给 出 的 手动 修复 程序 。 


较 小 的 错误 是 系统 视图 pg_settings 应 该 被 标记 为 有 公共 更 新 访问 ， 以 允 
许 UPDATE pg_settings FAVE set 的 替代 。 这 也 可 以 通过 initdb 或 者 手动 修复 ， 但 是 没有 必要 修 
复 ， 除非 你 想 要 使 用 UPDATE pg_settings o 


如 果 你 不 愿意 做 initdb， 那 么 下 面 的 程序 将 修复 pg statistic, 作为 数据 库 超 级 用 户 ， 执 
T: 
-- clear out old data in pg_statistic: 
DELETE FROM pg_statistic; 
VACUUM pg_statistic; 
- this should update 1 row: 
UPDATE pg_type SET typalign = 'd' WHERE oid = 2277; 
- this should update 6 rows: 
UPDATE pg_attribute SET attalign = 'd' WHERE atttypid = 2277; 
- At this point you MUST start a fresh backend to avoid a crash! 


-- repopulate pg_statistic: 
ANALYZE; 


这 可 以 在 活动 的 数据 库 中 完成 ， 但 是 要 注意 所 有 运行 在 改变 了 的 数据 库 中 的 后 端 都 必须 在 重 
新 填充 pg_statistic 是 安全 的 之 前 重新 启动 


要 修复 pg statistic 错误 ， 只 需要 做 : 


GRANT SELECT, UPDATE ON pg_settings TO PUBLIC; 


上 面 的 程序 必须 在 每 个 安装 的 数据 库 中 执行 ， 包括 template1 , 理想 上 也 包括 templateO o 
如 果 你 没有 修复 模板 数据 库 ， 那么 任何 随后 创建 的 数据 库 都 将 包含 相同 的 错 

iko templatel 的 修复 方式 和 其 他 数据 库 相 同 ， 但 是 修复 templateo 需要 额外 的 步骤 。 首 
先 ， 从 任意 数据 库 中 发 出 : 


UPDATE pg_database SET datallowconn = true WHERE datname = 'template0d'; 


下 一 步 ， 连 接 到 templateo ， 并 执行 上 面 的 修复 步骤 。 最 后 ， 执 行 : 


- re-freeze templated: 

VACUUM FREEZE; 

- and protect it against future alterations: 

UPDATE pg_database SET datallowconn = false WHERE datname = 'template0O'; 


E.181.2. 修改 列表 


版 本 7.4.2 合 并 了 所 有 包含 在 版 本 7.3.6 中 的 修复 ， 加 上 下 面 的 修复 : 


修复 会 使 优化 器 崩溃 的 pg_statistics 对 齐 错误 
关于 这 个 问题 的 详细 信息 请 查看 上 文 。 


° 允许 非 超级 用 户 更 新 pg_settings 


修复 几 个 优化 器 错误 ， 大 多 数 会 导致 "variable not found in subplan target lists" 错 误 


避免 启动 大 的 多 个 索引 扫描 期 间 的 超出 内 存 失 玖 


。 修复 coPY IN 期 间 可 能 导致 "内 存 不 足 "错误 的 多 字 节 问题 
。 修复 没有 OID 的 表 的 SELECT INTO / CREATE TABLE AS 问题 
。 修复 并 行 测试 期 间 alter_table 回归 测试 的 问题 
。 修复 打开 文件 限制 的 问题 ， 尤 其 是 在 OS XL (Tom) 
。 部 分 的 修复 Turkish 区 域 设 置 问题 
initdb 在 Turkish 的 区 域 设 置 现 在 将 成 功 ， 但 是 仍然 有 一 些 与 it 问题 相关 的 不 便 。 
。 使 得 pg_dump 在 恢复 时 设置 客户 端 编码 
e 其 他 较 小 的 pg_dump 修 复 
。 人 允许 ecpg 再 次 使 用 C 关 键 字 作为 字段 名 (Michael) 
e 添加 ecpg WHENEVER NOT_FOUND 到 SELECT/INSERT/UPDATE/DELETE (Michael) 


。 修复 查询 调用 设置 返回 函数 时 的 ecpg 骨 溃 (Michael) 


各 种 其 他 ecpg 修 复 (Michael) 
修复 Borland 编 译 器 

线程 构建 的 改进 (Bruce) 

各 种 其 他 构建 修复 

各 种 JDBC 修 复 


E.182. 版 本 7.4.1 


发 布 日 期 : 2003-12-22 


这 个 版 本 包含 各 种 自 7.4 以 来 的 修复 。 关 于 7.4 主 版 本 的 新 特性 的 信息 ， 请 查阅 Section 
E.183。 


E.182.1. 迁移 到 版 本 7.4.1 


运行 7.4 的 用 户 不 需要 转 储 恢复 。 


如 果 你 想 在 信息 模式 中 安装 该 修复 ， 你 需要 重新 加 载 它 到 数据 库 。 通过 运行 initdp 初始 化 一 
个 新 的 集群 ， 或 者 通过 在 每 个 数据 库 中 〈 理 想 上 包括 template1 ) 作为 超级 用 户 在 psql 中 运 
行 下 面 的 SQL 命令 序列 来 完成 ， 安装 新 的 版 本 之 后 : 


DROP SCHEMA information_schema CASCADE; 
\i /usr/local/pgsql/share/information_schema.sql 


用 第 二 个 命令 蔡 换 你 的 安装 路 径 。 


E.182.2. 修改 列表 


e 用 ECPG 修 复 cREATE scHEMA 解析 器 中 的 bug (Michael) 
。 修复 --enable-thread-safety 和 --with-perl 一 起 使 用 时 的 编译 错误 (Peter) 
。 修复 使 用 哈 希 连接 的 子 查询 (Tom) 
使 用 哈 希 连接 的 某 些 子 查 询 将 会 由 于 不 适当 的 共享 结构 崩溃 。 
。 修复 自由 空间 映射 压缩 错误 (Tom) 
这 修复 了 压缩 自由 空间 映射 会 导致 数据 库 服 务 器 关闭 的 错误 。 


修复 用 libpq 构 造 的 Borland 编 译 器 (Bruce) 

。 修复 netmask() 和 hostmask() 以 返回 最 大 长 度 的 masklen (Tom) 
修复 这 些 函 数 以 返回 和 7.4 以 前 的 版 本 一 致 的 值 。 

e 几 个 contrib/pg_autovacuum 修复 


修复 包括 不 正确 的 变量 初始 化 ， 在 TRUNCATE 之 后 忘记 清理 ， 和 持续 计算 长 的 清理 的 洽 
出 。 


允许 在 Cygwin 下 编译 contrib/cube (Jason Tishler) 

当 没 有 定义 口 舍 时 ， 人 允许 Solaris 使 用 口 命 文件 (Tom) 

修复 没有 定义 口 舍 时 ， 由 于 使 用 任意 类 型 的 口 命 认证 引起 的 Solaris 崩 淡 。 
JDBC 修 复线 程 问 题 ， 和 其 他 的 修复 

修复 bytea 索引 查找 (Joe) 

为 位 数据 类 型 修复 信息 模式 (Peten) 

在 从 WAL 恢 复 期 间 强 制 zero_damaged_pages 为 on 

阻止 一 些 " 变 量 不 在 子 计划 目标 列表 中 "的 模糊 情况 

使 PaescapeBytea 和 byteaout 相互 之 间 一 致 (Joe) 

为 字 节 bytes > Ox7ewbx% bytea 输出 (Joe) 


如 果 不 同 的 客户 端 编 码 用 于 bytea 输出 和 输入 ， 那么 bytea 值 有 可 能 会 被 不 同 的 编码 损 
坏 。 这 个 修复 逃 移 了 所 有 可 能 被 影响 的 字 节 。 


添加 丢失 的 spPI_finish() 调用 到 dblink 的 get_tuple_of_interest() (Joe) 
新 增 Czech FAQ 

为 外 键 修复 信息 模式 视图 constraint_column_usage (Peter) 

ECPG 修 复 (Michael) 

修复 子 查询 中 的 多 个 IN 子 查询 和 连接 的 错误 (Tom) 

允许 couNT('x') 工作 (Tom) 

为 Informix 兼 容 性 安装 ECPG 包 含 文件 到 单独 的 目录 (Peter) 


一 些 Informix 兼 容 性 ECPG 包 含 文件 的 名 字 与 操作 系统 包含 文件 冲突 。 通过 将 他 们 安装 到 
他 们 自己 的 目录 中 ， 名 字 冲 突 就 减少 了 。 


修复 SSL 内 存 泄露 (Neil) 

这 个 版 本 修复 了 7.4 中 SSL 不 释放 任何 它 分 配 到 的 内 存 的 错误 。 
阻止 pg_service.conf 使 用 服务 名 作为 缺 省 的 dbname (Bruce) 
修复 FreeBSD 上 的 本 地 身份 认证 (Tom) 


E.183. 版 本 7.4 


发 布 日 期 : 2003-11-17 


E.183.1. 概述 


这 个 版 本 中 的 主要 变更 : 
IN / NOT IN 子 查询 现在 更 有 效率 


在 以 前 的 版 本 中 ， IN / not IN 子 查询 连接 到 上 面 的 查询 ， 顺 序 的 扫描 子 查询 需 找 一 个 匹 
配 。 7.4 代 码 使 用 普通 连接 使 用 的 相同 的 先进 的 技术 ， 因 此 更 加 快速 。 IN 现在 通常 比 一 个 等 
价 的 exists 子 查 询 相同 速度 或 者 更 快 ; 这 颠倒 了 应 用 于 以 前 版 本 的 传统 观点 。 


通过 使 用 哈 希 桶 提高 GRouP BY 的 义理 


在 以 前 的 版 本 中 ， 被 分 组 的 行 必须 先 排序 。7.4 代 码 可 以 不 用 排序 就 执行 croup By, 通过 累 
加 结果 到 一 个 哈 希 表 ， 每 个 分 组 都 有 一 个 入 口 。 不 过 ， 如 果 该 哈 希 表 被 估计 为 太 大 而 不 适 
合 sort_mem , 那么 将 仍然 使 用 排序 技术 。 


新 增多 键 的 哈 希 连接 能 
在 以 前 的 版 本 中 ， 哈 希 连 接 只 在 单 键 上 发 生 。 这 个 版 本 允许 多 键 的 哈 希 连接 。 
使 用 明确 的 Jorn 语法 的 查询 现在 更 好 的 最 优化 了 


以 前 的 版 本 估算 使 用 明确 的 JoIN 语法 的 查询 只 以 该 语法 暗示 的 顺序 。 7.4 人 允许 全 面 优化 这 些 
查询 ， 意 味 着 优化 考虑 所 有 可 能 的 连接 顺序 ， 并 且 选 择 最 有 效 的 顺序 。 不 过 ， 外 连接 必须 仍 
然 遵 循 声明 的 顺序 。 


更 快 、 更 强大 的 正则 表达 式 编码 


整个 正则 表达 式 模 块 已 经 被 Henry Spencer 用 一 个 新 的 版 本 替代， 最 初 是 为 Tcl| 写 的 。 该 代码 
大 大 的 提高 了 性 能 ， 并 且 支 持 几 种 正则 表达 式 。 


为 简单 的 SQL 轴 数 嵌入 函数 


简单 的 SQL 画 数 现在 可 以 通过 在 主 查询 中 包含 他 们 的 SQL 内 联 。 这 通过 消除 每 个 调用 的 开销 
提升 了 性 能 。 这 意味 着 简单 的 SQL 辑 数 现在 的 行为 就 像 宏 。 


全 面 支 持 IPv6 连 接 和 IPv6 地 址 数据 类 型 


以 前 的 版 本 只 人 允许 IPv4 连 接 ，IP 数 据 类 型 也 只 支持 IPv4 地 址 。 这 个 版 本 在 这 些 区 域 添加 了 完 
全 的 IPv6 支 持 。 


主要 改进 SSL 性 能 和 可 靠 性 
几 个 人 非常 了 解 SSL API 已 经 彻底 检查 了 我 们 的 SSL 代 码 以 改善 SSL 键 谈判 和 错误 恢复 。 
使 得 自由 空间 映射 有 效 的 再 利用 空 的 索引 页 ， 其 他 自由 空间 管理 的 改善 


在 以 前 的 版 本 中 ， 因 为 删除 的 行 只 能 被 索引 值 类 似 于 该 行 以 前 在 该 页 上 的 索引 的 行 再 次 利 
用 ， 所 以 B-tree 索 引 页 都 保留 空白 。 在 7.4 中 ， vacuum 记录 空 的 索引 页 ， 并 且 人 允许 它们 被 任 
意 未 来 的 索引 行 重新 利用 。 


SQL 标准 信息 模式 

该 信息 模式 提供 一 个 标准 且 稳 定 的 方式 访问 关于 在 一 个 数据 库 中 定义 的 模式 对 象 的 信息 。 
游标 更 接近 的 符合 SQL 标 准 

命令 FETCH 和 Move 已 经 被 彻底 检查 ， 更 加 符合 SQL 标准 。 

游标 可 以 在 事务 之 外 退出 

这 些 游标 也 叫做 可 抓 住 的 游标 。 

新 增 客户 端 到 服务 器 的 协议 


新 的 协议 添加 了 错误 代码 ， 更 多 的 状态 信息 ， 更 快 的 启动 ， 更 好 的 支持 二 进 制 数据 传输 ， 参 
数值 从 SQL 命令 中 分 离 ， 预 备 语句 在 协议 级 别 中 有 效 ， 更 干净 的 从 copy 失败 中 恢复 。 服 务 
器 和 客户 端 仍然 支持 老 的 协议 。 


libpq 和 ECPSG 应 用 现在 是 完全 线程 安全 的 


以 前 的 libpq 版 本 就 已 经 支持 了 线程 ， 这 个 版 本 通过 修复 一 些 在 数据 库 连接 启动 期 间 使 用 的 非 
线程 安全 的 代码 提高 了 线程 安全 。 configure 选项 --enable-thread-safety 必须 用 于 启用 这 
个 特性 。 


新 增 全 文本 索引 的 版 本 
一 个 新 的 全 文本 索引 套件 在 contrib/tsearch2 中 可 用 。 
新 增 自动 清理 工具 


contrib/autovacuum 中 新 增 的 自动 清理 工具 见识 数据 库 状 态 表 的 INSERT / UPDATE / DELETE 活 
动 并 在 需要 时 自动 清理 表 。 


改进 了 数组 处 理 并 嵌入 服务 器 内 核 
移 除了 许多 数组 限制 ， 并 且 数 组 表现 的 更 加 全 面 支持 数据 类 型 。 


E.183.2. 迁移 到 版 本 7.4 


想 要 从 以 前 的 版 本 迁移 数据 的 用 户 需 要 使 用 pg_dump 转 储 / 恢 复 。 


观察 下 面 的 不 兼容 性 : 


删除 了 服务 器 端的 自动 提交 设置 ， 并 且 在 客户 端 应 用 和 话 言 中 重新 实现 。 服务 器 端的 自 
动 提 交 导 致 许多 想 要 控制 他 们 自己 的 自动 提交 行为 的 语言 和 应 用 出 现 问题 ， 所 以 从 服务 
器 删除 自动 提交 并 适当 的 添加 到 单独 的 客户 端 API 中 。 

着 误 消息 的 表达 在 这 个 版 本 中 已 经 大 幅度 的 改变 了 。 花 费 了 巨大 的 努力 使 得 消息 更 加 一 
致 和 面向 用 户 。 如 果 您 的 应 用 程序 党 试 通过 分 析 错 误 消息 检测 不 同 的 错误 条 件 ， 强烈 建 
议 您 使 用 新 的 错误 代码 功能 。 


使 用 明确 的 JoIN 语法 的 内 连接 可 能 表现 的 不 一 致 ， 因为 它们 现在 更 好 的 优化 了 。 
一 些 服务 器 配置 参数 已 经 重 命名 的 更 加 清晰 了 ， 主 要 是 那些 与 记录 相关 的 参数 。 


FETCH 6 BK move 9 现在 什么 也 不 做 。 在 以 前 的 版 本 中 ， FETcH 9 将 抓 取 所 有 剩余 的 
行 ， MovE o 将 移动 到 游标 的 最 后 。 


FETCH 和 Move 现在 返回 实际 抓 取 / 移 动 的 行 数 ， 或 者 如 果 在 游标 的 开始 或 结尾 返回 需 。 
以 前 的 版 本 将 返回 传递 给 命令 的 行 计 数 ， 不 是 实际 抓 取 或 移动 的 行 数 。 


copy 现在 可 以 处 理 使 用 回 车 键 或 回 车 键 /换行 符 行 尾 序列 的 文件 。 字面 的 回 车 键 和 换行 
不 再 被 数据 值 接受 ; 使 用 \r 和 \n BKK. 


当 从 类 型 char(`、`_n_ ) 到 varchar(>*_n_ ) 或 text 转换 时 ， 现 在 会 去 除 结 尾 的 空白 。 这 是 
大 多 数 人 们 一 直 想 要 实现 的 。 


数据 类 型 float(``p_) 现 在 以 二 进 制 位 数 测量 p, 不 是 十 进 制 位 数 。 新 的 行为 遵从 
SQL 标 准 。 


模糊 的 日 期 值 现在 必须 匹配 datestyle 设置 指定 的 顺序 。 在 以 前 的 版 本 中 ， 一 
个 10/20/03 的 日 期 声明 理解 为 十 月 中 的 一 个 日 期 ， 即使 duatestyle 声明 了 天 在 前 面 。 如 
果 对 于 当前 的 datestyle 设置 来 说 ， 日 期 声明 是 无 效 的 时 7.4 将 抛 出 一 个 错误 。 


RES oidrand 、 oidsrand 和 userfntest 已 经 移 除 了 。 这 些 函 数 不 再 有 用 To 


字符 串 字面 值 声明 随时 变化 的 日 期 /时 间 值 ， 如 now 或 ‘today’ 在 字段 缺 省 表达 式 中 将 
不 再 像 预期 的 那样 工作 ; 它们 现在 缺 省 是 表 创 建 的 时 间 ， 而 不 是 插入 的 时 间 。 应 该 使 用 
像 now() 、 current_timestamp 或 current_date 这 样 的 函数 。 


在 以 前 的 版 本 中 ， 有 特殊 的 代码 ， 所 以 像 'now' 这 样 的 代码 被 解释 为 Insert 时 间 ， 而 


不 是 表 创 建 的 时 间 ， 但 是 这 个 变通 并 不 涵盖 所 有 的 情况 。 版 本 7.4 现 在 要 求 该 缺 省 使 用 像 
now() 或 current_timestamp 这 样 的 萎 数 正确 的 定义 。 这 将 适用 于 所 有 的 情况 。 


美元 符号 ( $ ) 不 再 允许 用 于 操作 员 名 字 。 它 反而 可 以 成 为 标识 符 中 的 非 首位 字符 。 这 样 
做 是 为 了 提高 和 其 他 数据 库 系 统 的 兼容 性 ， 和 避免 参数 占 位 符 (sn ) 和 操作 符 写 的 很 
近 时 的 语法 问题 。 


E.183.3. 修改 列表 


在 下 面 你 将 发 现 版 本 7.4 和 前 面 的 主要 版 本 之 间 的 详细 的 变化 。 


E.183.3.1. 服务 器 操作 变化 


人 允许 IPv6 服 务 器 连接 (Nigel Kukard, Johan Jordaan, Bruce, Tom, Kurt Roeckx, Andrew 
Dunstan) 


修复 SSL 以 干净 利落 的 处 理 错误 (Nathan Mueller) 

在 以 前 的 版 本 中 ， 某 些 SSL API 错 误 报告 处 理 的 不 正确 。 这 个 版 本 修复 了 那些 问题 。 
SSL 协 议 安 全 和 性 能 改善 (Sean Chittenden) 

SSL 键 重新 谈判 非常 频繁 的 发 生 ， 导 致 SSL 性 能 人 低下。 另外， 改善 了 最 初 的 键 的 处 理 。 
当 检 测 到 死 锁 时 打印 锁 信 息 (Tom) 

这 人 允许 更 容易 的 调试 死 锁 状况 。 

更 新 /tmp 套 接 字 修 改 时 间 ， 定 期 的 避免 他 们 的 移 除 (Tom) 

这 应 该 有 助 于 防止 /tmp 目录 清理 管理 脚本 移 除 服务 器 套 接 字 文 件 。 

为 Mac OS X é FAPAM (Aaron Hillegass) 

使 得 B-tree 素 引 完 全 的 WAL 安 全 (Tom) 


在 以 前 的 版 本 中 ， 在 某 些 稀有 情况 下 ， 服 务 器 崩溃 会 导致 B-tree 索 引 损 坏 。 这 个 版 本 删 
除了 最 后 的 几 个 稀有 情况 。 


人 允许 B-tree 索 引 压 缩 和 空 页 面 重新 利用 (Tom) 
在 第 一 个 根 页面 分 裂 期 间 修 复 不 一 致 的 索引 查找 (Tom) 


在 以 前 的 版 本 中 ， 当 一 个 页 面 索引 分 裂 为 两 个 页 面 时 ， 另 一 个 数据 库 会 话 会 在 短期 内 看 
不 到 索引 项 。 这 个 版 本 修复 了 这 个 稀有 的 失败 情况 。 


改善 自由 空间 映射 分 配 逮 辑 (Tom) 
在 服务 器 重启 时 保留 自由 空间 信息 (Tom) 


在 以 前 的 版 本 中 ， 当 主 进程 停止 时 ， 自 由 空间 映射 是 不 保存 的 ， 所 以 新 启动 的 服务 器 没 
有 自由 空间 信息 。 这 个 版 本 保存 了 自由 空间 映射 ， 并 且 当 服务 器 重新 启动 时 重新 加 载 


它 。 


添加 开始 时 间 到 pg_stat_activity (Neil) 


新 增 代码 检测 损坏 的 磁 瘟 页 ; 删除 zero_damaged_pages (Tom) 

。 新 增 客户 端 /服务 器 协议 : 更 快 、 没 有 用 户 名 长 度 限制 、 人 允许 从 copy 中 干净 的 退出 (Tom) 
。 添加 事务 状态 、 表 ID、 字 上 段 ID 到 客户 端 /服务 器 协议 (Tom) 

。 添加 二 进 制 /O 到 客户 端 /服务 器 协议 (Tom) 

。 删除 自动 提交 服务 器 设置 ; 移动 到 客户 端 应 用 (Tom) 

。 新 的 错误 消息 用 词 、 错 误 代 码 和 三 个 层次 的 错误 详情 (Tom, Joe, Peter) 


E.183.3.2. 性 能 改进 
e 为 GROUP BY 聚集 添加 散 列 (Tom) 
。 使 得 柑 套 循环 连接 关于 多 字段 素 引 更 加 智能 (Tom) 
。 人 允许 多 键 的 哈 希 连接 (Tom) 
。 提高 常量 折 又 (Tom) 
。 添加 内 联 简单 的 SQL 画 数 的 能 力 (Tom) 
减少 使 用 复 灯 回 数 的 查询 的 内 存 使 用 (Tom) 


在 以 前 的 版 本 中 ， 返 回 存 储 器 配置 的 画 数 将 直到 查询 完成 之 后 才 释 放 。 这 个 版 本 允许 调 
用 完成 之 后 就 释放 存储 器 配置 画 数 ， 减 少 函 数 使 用 的 总 内 存 。 


提高 GEQO 优 化 器 性 能 (Tom) 
这 个 版 本 修复 了 几 个 GEQO 优 化 器 管理 潜在 查询 路 径 的 低 效 率 。 
。 多 许 通过 哈 希 表 义理 IN / not IN (Tom) 


。 提高 NOT IN (`、_subquery_) 性 能 (Tom) 


人 允许 大 多 数 IN 子 查 询 作 为 连接 处 理 (Tom) 


模式 匹配 操作 可 以 使 用 索引 ， 无 视 区 域 设 置 (Peter) 


非 ASCII 区 域 设 置 无 法 为 LIKE 比较 使 用 标准 的 索引 。 这 个 版 本 添加 了 为 LIKE 创建 特殊 
索引 的 方法 。 


© 人 允许 主 进程 使 用 preload_libraries 预 加 载 库 (Joe) 


对 于 需要 很 长 时 间 加 载 的 共享 库 ， 这 个 选项 是 可 用 的 ， 这 样 库 可 以 在 主 进程 中 预 加 载 并 
被 所 有 的 数据 库 会 话 继承 。 


。 改善 优化 器 成 本 计算 ， 尤 其 是 子 查询 (Tom) 

。 避免 子 查询 ORDER BY 匹配 上 一 级 查询 时 的 排序 (Tom) 

e 推断 whERE a.x = b.y AND b.y = 42 的 意思 也 为 a.x = 42 (Tom) 
。 人 允许 在 复杂 连接 上 哈 希 /合并 连接 (Tom) 

。 人 允许 为 更 多 数据 类 型 哈 希 连接 (Tom) 

e 人 允许 明确 的 内 连接 最 优化 ， 禁 用 join_collapse_limit (Tom) 

。 添加 参数 from_collapse_limit 控制 子 查 询 到 连接 的 转换 (Tom) 
。 使 用 更 快 更 强大 的 Tcl 正 则 表达 式 代 码 (Henry Spencer, Tom) 

© 在 优化 器 中 使 用 位 映射 关系 设置 (Tom) 


改善 连接 启动 时 间 (Tom) 

新 的 客户 端 /服务 器 协议 需要 较 少 的 网 络 数据 包 开 始 一 个 数据 库 会 话 。 
。 提高 触发 器 /约束 性 能 (Stephan) 

。 提高 col IN (const, const, const, ...) 的 速度 (Tom) 


。 修复 在 稀有 情况 下 损坏 的 哈 希 索引 (Tom) 


改善 哈 希 索引 并 发 性 和 速度 (Tom) 


以 前 版 本 的 哈 希 索引 性 能 欠 佳 ， 尤 其 是 高 并 发 性 的 情况 下 。 这 个 版 本 修复 了 这 个 问题 ， 
并 且 开 发 组 对 于 报告 B-tree 和 哈 希 索引 性 能 的 比较 是 有 兴趣 的 。 


在 32 字 节 的 边界 上 排列 共享 的 缓冲 区 ， 改 善 拷贝 速度 (Manfred Spraul) 


当地 址 是 32 字 节 对 齐 的 时 ， 确 定 的 CPU 执 行 数据 拷贝 更 快 。 


重新 使 用 数据 类 型 numeric ， 以 获取 更 好 的 性 能 (Tom) 
numeric 过 去 是 基于 100 存 储 。 新 的 代码 基于 10000， 大 大 的 改善 性 能 。 


E.183.3.3. 服务 右 配 置 变化 
° 重 命 名 服务 器 参数 server_min_messages 为 log_min_messages (Bruce) 


这 样 做 了 之 后 大 部 分 控制 服务 器 日 志 的 参数 以 log_ 开始 。 


重 命名 show_* stats 为 log * stats (Bruce) 
重 命名 show_source_port 为 log_source_port (Bruce) 


重 命 名 hostname_lookup 为 log_hostname (Bruce) 


添加 checkpoint_warning 警告 过 多 的 检查 点 (Bruce) 
在 以 前 的 版 本 中 ， 很 难 判 断 检 查 点 是 否 发 生 的 太 过 频繁 。 这 个 特性 当 过 多 的 检查 点 发 生 


时 向 服务 器 日 志 添加 一 个 警告 。 
为 本 地 化 新 增 只 读 服务 器 参数 (Tom) 
改变 调试 服务 器 日 志 消 息 使 输出 eeue 而 不 是 Loc (Bruce) 
阻止 服务 器 日 志 变 量 被 非 超级 用 户 关 闭 (Bruce) 
一 个 安全 特性 ， 所 以 非 超 级 用 户 不 能 禁用 管理 员 启用 的 日 志 。 
log_min_messages / client_min_messages 现在 控制 debug_* 输出 (Bruce) 
这 集中 了 客户 端 调试 信息 ， 所 以 所 有 的 调试 输出 都 可 以 发 送 到 客户 端 和 服务 器 日 志 。 
添加 Mac OS X 集 合 点 服务 器 支持 (Chris Campbell) 
这 人 允许 Mac OS X 主 机 为 可 用 的 PostgreSQL 服 务 器 查询 网 络 。 
添加 使 用 10g_min_duration_statement 只 打印 缓慢 的 语句 的 能 力 (Christopher) 
这 是 一 个 经 常 请 求 的 调试 特性 ， 人 允许 管理 员 在 他 们 的 服务 器 日 志 中 只 看 到 绥 慢 的 查询 。 
午 pg_hba.conf 在 CIDR 格 式 中 接受 子 网 掩 码 (Andrew Dunstan) 
这 人 允许 管理 员 在 pg_hpa.conf 中 合并 主机 IP 地 址 和 子 网 掩 码 字 段 为 一 个 CIDR 字 段 。 
新 增 只 读 参 数 is_superuser (Tom) 
新 增 参 数 log_error_verbosity 控制 错误 详情 (Tom) 
与 新 的 错误 报告 特性 一 起 工作 ， 提 供 额 外 的 错误 信息 ， 如 提示 、 文 件 名 和 行 号 。 
postgres --describe-config 现在 转 储 服务 器 配置 变量 (Aizaz Ahmed, Peter) 


这 个 选项 对 于 需要 知道 配置 变量 名 和 它们 的 最 小 、 最 大 、 缺 省 和 描述 的 管理 工具 来 说 是 
有 用 的 。 


在 pg_settings 中 添加 新 的 字段 z: context , type , source , min_val ， max_val (Joe) 


如 果 可 能 ， 使 shared_buffers 缺 省 为 1000， max_connections 缺 省 为 100 (Tom) 


以 前 的 版 本 的 共享 缓冲 区 缺 省 为 64， 所 以 PostgreSQL 甚至 在 非常 老 的 系统 上 也 能 启动 。 
这 个 版 本 测试 平台 允许 的 共享 内 存 的 数量 并 且 如 果 可 以 的 话 选择 更 加 合理 的 缺 省 值 。 当 
然 ， 仍 然 鼓励 用 户 评估 他 们 的 资源 负载 ， 并 且 相 应 的 设 定 shared_buffers 的 尺寸 。 


新 增 pg_hba.conf 记录 类 型 hostnossl 以 阻止 SSL 连 接 (Jon Jensen) 


在 以 前 的 版 本 中 ， 如 果 客 户 端 和 服务 器 都 支持 SSL， 那 么 是 没有 办 法 阻止 SSL 连 接 的 。 
这 个 选项 允许 阻止 SSL 连 接 。 


删除 参数 geqo_random_seed (Tom) 
添加 服务 器 参数 regex_flavor ， 控 制 正则 表达 式 人 处 理 (Tom) 


使 pg_ctl 更 好 的 处 理 非 标 准 的 端口 (Greg) 


E.183.3.4. 查询 的 变化 


新 增 SQL 标 准 信 息 模式 (Peter) 

添加 只 读 事务 (Peter) 

在 外 键 违反 信息 中 输出 键 名 和 值 (Dmitry Tkach) 

允许 用 户 在 pg_stat_activity 中 查看 他 们 自己 的 查询 (Kevin Brown) 


在 以 前 的 版 本 中 ， 只 有 超级 用 户 可 以 使 用 pg_stat_activity 查看 查询 字符 串 。 现在 普通 
用 户 也 可 以 查看 他 们 自己 的 查询 字符 串 了 。 


修复 子 查 询 中 的 聚集 以 匹配 SQL 标准 (Tom) 


SQL 标准 认为 在 一 个 储 套 的 子 查询 中 出 现 的 聚集 本 数 ， 如 果 它 的 参数 只 包含 外 部 查询 的 
变量 ， 那么 它 属于 外 部 的 查询 。 以 前 的 PostgreSQL 版 本 没有 正确 的 处 理 这 点 。 


添加 选项 阻止 查询 中 引用 的 表 的 自动 添加 (Nigel J. Andrews) 


缺 省 的 ， 查 询 中 提 到 的 表 如 果 没 有 在 FRoM 子 句 中 则 自动 添加 进去 。 这 是 和 历史 的 
POSTGRES 行 为 兼容 的 ， 但 是 违反 SQL 标准 。 这 个 选项 允许 选择 标准 兼容 的 行为 。 


人 允许 UPDATE ... SET col = DEFAULT (Rod) 

这 允许 UPDATE 设置 一 个 字段 为 它 声 明 的 缺 省 值 。 

允许 在 LIMIT / oFFSET 中 使 用 表达 式 (Tom) 

在 以 前 的 版 本 中 ， LIMIT / oFFsET 只 能 使 用 约束 ， 不 能 使 用 表达 式 。 


实现 了 CREATE TABLE AS EXECUTE (Neil, Peter) 


E.183.3.5. 对 象 操作 的 改变 


e 使 CREATE SEQUENCE 语法 更 加 符合 SQL:2003 (Neil) 
。 添加 语句 级 别 的 触发 器 (Neil) 


虽然 这 人 允许 触发 器 在 语句 结束 时 触发 ， 但 是 它 不 允许 触发 器 访问 语句 修改 的 所 有 行 。 这 
个 能 力 是 为 未 来 的 版 本 计划 的 。 


。 为 域 添加 检查 约束 (Rod) 
通过 人 允许 域 使 用 检查 约束 ， 大 大 的 增加 了 域 的 有 用 性 。 
ig 


° 
X 


ALTER DOMAIN (Rod) 

这 人 允许 操作 现 有 的 域 。 
。 修复 几 个 雳 字段 表 错 误 (Tom) 

PostgreSQL 支 持 雳 字段 表 。 这 修复 了 各 种 使 用 这 样 的 表 时 发 生 的 错误 。 
e 让 ALTER TABLE ... ADD PRIMARY KEY 添加 非 空 约束 (Rod) 


在 以 前 的 版 本 中 ， ALTER TABLE ... ADD PRIMARY KEY 将 添加 一 个 唯一 索引 ， 但 是 不 添加 
非 空 约束 。 这 在 这 个 版 本 中 修复 了 。 


e 添加 了 ALTER TABLE ... WITHOUT orps (Rod) 

这 多 许 控制 无 论 新 行 还 是 更 新 的 行 都 将 有 一 个 OID 字 段 。 这 对 于 节省 存储 空间 非常 有 用 。 
e 添加 acter sequence 修改 最 小 、 最 大 、 增 量 、 缓 存 、 循 环 值 (Rod) 
e 添加 了 ALTER TABLE ... CLUSTER on (Alvaro Herrera) 


这 个 命令 被 pg_dump 使 用 ， 为 每 个 以 前 集群 的 表 记 录 集 群 字段 。 这 个 信息 被 数据 库 范围 
的 集群 使 用 以 集群 所 有 以 前 集群 的 表 。 


。 为 域 增加 自动 类 型 转换 (Rod, Tom) 
。 人 允许 美元 符号 出 现在 标识 符 中 ， 除 了 作为 第 一 个 字符 (Tom) 
。 不 允许 美元 符号 出 现在 操作 符 名 中 ， 所 以 x=$1 工作 (Tom) 


e 人 允许 使 用 LIKE _subtable 拷贝 表 模 式 ， 这 也 是 SQL:2003 的 特性 INCLUDING DEFAULTS 
(Rod) 


e 添加 WITH GRANT OPTION 子 句 到 erant (Peter) 


这 启用 了 6RANT ， 给 予 其 他 用 户 在 对 象 上 授予 权限 的 能 力 。 


E.183.3.6. 实用 命令 的 改变 


为 临时 表 添 加 on comt 子 句 到 create TABLE (Gavin) 
这 添加 了 在 事务 提交 时 表 被 删除 或 删除 所 有 行 的 能 力 。 
人 允许 游标 使 用 with Hoo 在 事务 之 外 (Neil) 


在 以 前 的 版 本 中 ， 游 标 在 创建 它们 的 事务 的 结束 删除 。 现在 游标 可 以 使 用 WITH HoLD 选 
项 创建 ， 这 人 允许 它们 在 创建 它们 的 事务 提交 之 后 仍然 可 以 被 访问 。 


FETCH 9 和 Move o 现在 什么 也 不 做 (Bruce) 
在 以 前 的 版 本 中 ， FETcH o 抓 取 所 有 现 有 的 行 ， MovE o 移动 到 游标 的 最 后 。 


使 Ferch 和 move 返回 抓 取 /移动 的 行 数 ， 或 者 如 果 在 游标 的 开始 /结束 则 为 雳 ， 按 照 SQL 
标准 (Bruce) 


在 以 前 的 版 本 中 ， FETcH 和 move 返回 的 行 计数 不 能 精确 的 反映 处 理 的 行 数 。 
正确 的 处 理 带 有 游标 的 scRoLL ， 或 者 报告 一 个 错误 (Neil) 


允许 到 某 种 查询 的 随机 访问 (前 向 和 后 向 滚动 ) 不 能 不 带 有 一 些 额 外 的 工作 完成 。 如 
R scroLL 在 游标 创建 时 指定 ， 这 个 额外 的 工作 将 被 执行 。 此 外 ， 如 果 游 标 带 
有 No SCROLL 创建 ， 那 么 不 允许 随机 访问 。 


为 FETCH 和 move 实现 了 SQL 兼容 的 选项 FIRST, LAST. ABSOLUTE _n_, RELATIVE 
_n_ (Tom) 


允许 在 DECLARE CURSOR 上 EXPLAIN (Tom) 

缺 省 允许 cluster 使 用 标记 为 先 于 集群 的 索引 (Alvaro Herrera) 

人 允许 cLUSTER 集群 所 有 的 表 (Alvaro Herrera) 

这 人 允许 一 个 数据 库 中 所 有 以 前 集群 的 表 用 一 个 命令 就 能 重新 集群 。 
阻止 在 局 部 索引 上 cluster (Tom) 

在 copy 文件 中 允许 DOS 和 Mac 行 尾 结束 符 (Bruce) 

不 允许 文字 的 回 车 作为 一 个 数据 值 ， 仍 然 允 许 反 斜 杠 回 车 和 \r (Bruce) 
copy 改变 (二 进 制 , \. ) (Tom) 

干净 的 从 copy 失败 中 恢复 (Tom) 

阻止 copy 中 可 能 的 内 存 泄 露 (Tom) 

使 得 TRuNcATE 事务 安全 (Rod) 


TRUNCATE 现在 可 以 在 一 个 事务 内 部 使 用 了 。 如 果 该 事务 退出 ， TRUNCATE 所 做 的 改变 自 
动 回 滚 。 


人 允许 像 FETCH 和 EXPLAIN 这 样 的 实用 命令 预 各 /捆绑 (Tom) 
添加 了 EXPLAIN EXECUTE (Neil) 

通过 减少 WAL 流 量 提高 索引 上 的 vacuum 性 能 (Tom) 

功能 性 索引 已 经 泛 化 为 表达 式 上 的 索引 (Tom) 


在 以 前 的 版 本 中 ， 功 能 性 素 引 只 支持 一 个 简单 的 应 用 于 一 个 或 更 多 字段 名 的 功能 。 这 个 
版 本 允许 任意 类 型 的 标量 表达 式 。 


让 SHOW TRANSACTION ISOLATION 匹配 输入 到 SET TRANSACTION ISOLATION (Tom) 

让 COMMENT ON DATABASE 在 非 局 部 的 数据 库 上 生成 一 个 警告 ， 而 不 是 一 个 错误 (Rod) 
数据 库 注释 存储 于 数据 库 本 地 表 中 ， 所 以 在 数据 库 上 的 注释 必须 存储 于 每 个 数据 库 中 。 
提高 LISTEN / NoTIFY 的 可 靠 性 (Tom) 

人 允许 REINDEX 可 靠 的 重建 非 共 享 的 系统 目录 索引 (Tom) 


这 人 允许 系统 表 不 用 单独 会 话 的 要 求 就 能 重建 索引 ， 而 这 在 以 前 的 版 本 中 是 必须 的 。 现在 
需要 单独 会 话 重建 索引 的 仅 有 的 表 是 全 局 系统 表 pg_database 、 


pg_shadow 和 pg_group o 


E.183.3.7. 数据 类 型 和 酌 数 的 变化 


新 增 服 务 器 参数 extra_float_digits ， 控制 浮 点 数 的 精度 显示 (Pedro Ferreira, Tom) 
控制 引起 回 兴 测试 问题 的 输出 精度 。 

人 允许 +1300 作为 一 个 数字 时 区 说 明 符 ，FJST (Tom) 

删除 很 少 使 用 的 功能 oidrand 、 oidsrand 和 userfntest (Neil) 

添加 md5() ASIA ABs, CAF contrib/pgcrypto 中 (Joe) 

经 常 请 求 MD5 画 数 。 对 于 更 复杂 的 加 密 要 求 ， 使 用 contrib/pgcrypto o 

增加 timestamp 的 数据 范围 (John Cochran) 


更 改 EXTRACT(EPOCH FROM timestamp) , 这 样 timestamp without time zone 假设 为 本 地 时 
间 ， 而 不 是 GMT (Tom) 


在 操作 系统 不 阻止 除 以 需 的 情况 下 阻止 被 堆 除 (Tom) 
改变 numeric 数据 类 型 内 部 基于 10000 (Tom) 


新 增 hostmask() EBX (Greg Wickham) 


修复 to_char() 和 to_timestamp() (Karel) 


允许 图 数 接受 任意 参数 数据 类 型 并 返回 任意 数据 类 型 ， 使 用 anyelement 和 anyarray 


(Joe) 
RAWAM BAUS SBE HLL. 


数组 现在 可 以 指定 为 ARRAY[1,2,3] ~ ARRAY[['a','b'],['c', 'd']] 
或 ARRAY[ARRAY[ARRAY[2]]] (Joe) 


允许 适当 的 比较 数组 ， 包 括 oRDER BY 和 pIsTINCT 支持 (Joe) 
人 允许 在 数组 字段 上 索引 (Joe) 
允许 用 || 串联 数组 (Joe) 


人 允许 WHERE 限制 expr. _op_ ANY/SOME/ALL ( _array_expr_ ) (Joe) 


这 人 允许 数组 表现 的 像 值 的 列表 ， 对 于 像 SELECT * FROM tab WHERE col IN (array_val) 这 


样 的 目的 。 


新 增 数 组 函 EE array_append , array_cat , array_lower , array_prepend , 


array_to_string , array_upper , string_to_array (Joe) 

人 允许 用 户 定义 的 聚集 使 用 多 ABR (Joe) 

人 允许 分 配给 空 数组 (Joe) 

人 允许 60 在 time 、 timestamp 和 interval 输入 值 的 秒 字 段 (Tom) 
闫 秒 需要 60 秒 。 

人 允许 cidr 数据 类 型 被 转换 为 text (Tom) 

不 允许 无 效 的 时 区 名 出 现在 SET TIMEZONE 

当 char 转换 为 varchar 或 text 时 ， 去 掉 尾 随 的 空白 (Tom) 

使 得 float `p ) 以 二 进 制 数 字 测 量 精度 p_, 而 不 是 十 进 制 数字 (Tom) 
添加 IPv6 支 持 到 inet 和 cidr 数据 类 型 (Michael Graff) 

添加 family() WAR SU ZIPV4 iz ZIPV6 (Michael Graff) 

让 SHOW datestyle 产生 的 输出 类 似 于 SET datestyle 使 用 的 (Tom) 


让 EXTRACT(TIMEZONE) 和 SET/SHOW TIME ZONE 遵从 SQL 时 区 偏 移 量 符号 的 惯例 ， 
UTC 的 东边 (Tom) 


修复 date_trunc('quarter', ...) (Bdjthe Zoltan) 


如 正 数 为 


以 前 的 版 本 为 这 个 函数 调用 返回 不 正确 的 值 。 
e 让 initcap() 与 Oracle 更 加 兼容 (Mike Nolan) 


initcap() 现在 大 写 任 何 出 现在 非 字 母 数 字 字符 后 面 的 字母 ， 不 只 是 在 空白 后 面 的 字 
Et, 


。 日 期 值 只 允许 datestyle 字段 顺序 ， 不 以 ISO-8601 格 式 (Greg) 


e 添加 新 的 datestyle 值 MDY 、 pMY 和 ym 来 设置 输入 字段 顺序 ; 
从 us 和 European 的 向 后 兼容 性 (Tom) 


。 像 'now' 和 ‘today 这 样 的 字符 串 字 面值 不 再 作为 一 个 字段 的 缺 省 。 使 
用 now() 、 current_timestamp 这 样 的 函数 代替 。 (改变 需要 预备 语句 ) (Tom) 


在 min() / max() 中 将 NaN 看 做 大 于 任意 其 他 值 (Tom) 


对 于 大 多 数目 的 ，NaN 早 已 排序 在 普通 数值 的 后 面 ， 但 是 min) 和 max() 没有 获得 这 个 
权利 。 


阻止 间隔 抑制 :ee 秒 的 显示 


ATIBA pg_get_triggerdef(prettyprint) 和 pg_conversion_is_visible() (Christopher) 


。 人 允许 指定 时 间 为 040506 BK 0405 (Tom) 


输入 日 期 顺序 现在 必须 为 YYYY-MM-pp 《年 为 4 位 数 ) 或 匹配 datestyle 


e 让 pg_get_constraintdef 支持 了 唯一、 主键 和 检查 约束 (Christopher) 


E.183.3.8. 服务 器 端 语 言 的 变化 
e 当 RETURN NEXT 用 在 需 行 字段 变量 上 时 阻止 PL/pgSQL 崩 溃 (Tom) 
e 让 PL/Python 的 spi_execute 接口 正确 的 处 理 空 值 (Andrew Bosma) 
e 人 允许 PL/pgSQL 不 用 wRowTYPE 声明 复合 类 型 的 变量 (Tom) 
。 修复 PL/Python 的 _quote() 郴 数 ， 以 义理 大 的 整数 
e 使 PL/Python 语 言 不 可 信 ， 现 在 称 为 plpythonu (Kevin Jacobs, Tom) 


Python 语言 不 再 支持 受 限 制 的 执行 环境 ， 所 以 删除 了 受信 任 的 PL/Python 版 本 。 如 果 这 
个 情况 改变 了 ， 将 阅读 非 超 级 用 户 可 以 使 用 的 PL/Python 的 一 个 版 本 。 


。 2 AMPL/PythonHR (Joe, Tom) 
。 RIS ANWSQLAR (Joe) 
。 用 对 多 态 性 的 全 面 支 持 改进 PL/pgSQL 中 编译 的 函数 缓存 机 制 (Joe) 


e 在 PL/pgSQL 中 添加 新 的 参数 s0 ， 表 示 该 图 数 的 实际 返回 类 型 (Joe) 
e 人 允许 PL/Tcl| 和 PL/Python 在 多 重 表 上 使 用 相同 的 触发 器 (Tom) 
° 修复 PL/TcI 的 spi_prepare 以 在 参数 类 型 列表 中 接受 完全 限定 的 类 型 名 (Jan) 


E.183.3.9. psql 的 变化 
e 添加 \pset pager always 以 总 是 使 用 pager (Greg) 
强制 使 用 pager， 即 使 行 数 少 于 屏幕 高 度 也 是 一 样 。 这 个 对 于 有 几 个 屏幕 的 行 有 帮助 。 
e 改善 tab 补 齐 (Rod, Ross Reedstrom, lan Barwick) 
。 重新 排序 \? 帮助 分 组 (Harald Armin Massa, Bruce) 
。 添加 反 斜 杠 命令 列 出 模式 、 计 算 和 转换 (Christopher) 
e \encoding 现在 根据 服务 器 参数 client_encoding 变化 (Tom) 
在 以 前 的 版 本 中 ， \encoding 不 知道 使 用 sET client_encoding 所 做 的 编码 改变 。 
。 将 编辑 器 缓冲 区 保存 到 readline 历史 (Ross) 
当 使 用 \e 编辑 一 个 查询 时 ， 结 果 被 保存 到 readline 历史 ， 以 使 用 向 上 箭头 键 检 索 。 
e 改善 \d 的 显示 (Christopher) 
。 提高 HTML 模 式 ， 使 其 更 加 符合 标准 (Greg) 
e 新 增 \set AUTOCOMMIT off 能 力 (Tom) 
这 取代 了 删除 的 服务 器 参数 autocommit 。 
e 新 增 \set vERBOSITY 控制 错误 详情 (Tom) 
这 个 控制 新 的 错误 报告 细节 。 
。 新 增 提 示 转 义 序 列 wx ， 显 示 事务 状态 (Tom) 


。 psql 的 长 选项 现在 在 所 有 平台 上 可 用 


E.183.3.10. pg_dump 的 变化 
e 多 重 pg_dump 修 复 ， 包 括 tar 格 式 和 大 对 象 
e 人 允许 pg_dump 转 储 指定 的 模式 (Neil) 
e 让 pg_dump 保 存 字 段 存储 特性 (Christopher) 


这 保存 了 ALTER TABLE ... SET STORAGE 信息 。 


使 pg_dump 保 存 cLusTER 特性 (Christopher) 

让 pg_dumpall 使 用 GRANT / revoke 转 储 数据 库 级 别 的 权限 (Tom) 
允许 pg_dumpall 支 持 pg_dump 的 选项 -a 、 -s 、 -x (Tom) 
阻止 pg_dump 小 写 在 命 合 行 中 指定 的 标识 符 (Tom) 


pg_dump 选 项 --use-set-session-authorization 和 --no-reconnect 现在 什么 也 不 做 ， 所 
有 和 转 储 使 用 SET SESSION AUTHORIZATION 


pg_dump 不 再 重新 连接 到 切换 的 用 户 ， 但 是 反而 总 是 使 用 SET SESSION AUTHORIZATION 。 
这 将 减少 在 恢复 时 的 口令 提示 。 


pg_dump 的 长 选项 现在 在 所 有 平台 上 可 用 


PostgreSQL 现 在 包括 它 自己 的 长 选项 处 理 例 程 。 


E.183.3.11. libpq 的 变化 


WINER Pafreemem 在 Windows 上 释放 内 存 ， 建议 NoTIFY (Bruce) 


Windows 要 求 在 库 中 分 配 的 内 存 通 过 在 相同 库 中 的 一 个 罚 数 释放 ， 因 此 free() 并 不 释放 
libpq 分 配 的 内 存 。 PQfreemem 是 释放 libpq 内 存 的 适当 的 方式 ， 尤其 是 在 Windows 上 ， 也 
推荐 在 其 他 平台 上 使 用 。 


文档 服务 能 力 ， 并 且 添 加 了 样本 文件 (Bruce) 

这 人 允许 客户 查看 客户 端 机 器 上 中 心 文件 的 连接 信息 。 
让 PQsetdbLogin 有 和 Paconnectdb 相同 的 缺 省 (Tom) 
当 结 果 集 太 大 时 ， 人 允许 libpq 彻 底 的 失败 (Tom) 

fe PRX PaunescapeBytea 的 性 能 (Ben Lamb) 


允许 线程 安全 的 libpq 带 有 configure 选项 --enable-thread-safety (Lee Kindness, Philip 
Yarra) 


i HRN pqinternalNotice 接受 一 个 格式 字符 串 和 参数 ， 而 不 只 是 一 个 预定 义 格式 的 信 
息 (Tom, Sean Chittenden) 


用 sslmode 值 disable, allow, prefer 和 require 控制 SSL 协 商 (Jon Jensen) 
允许 新 的 错误 代码 和 文本 级 别 (Tom) 

人 允许 访问 基础 表 和 查询 结果 的 字段 (Tom) 

这 对 于 想 要 知道 和 指定 结果 集 相关 的 基础 表 和 字段 的 查询 生成 器 应 用 是 有 用 的 。 


© 多 许 访 问 当前 事务 状态 (Tom) 
e 添加 传递 二 进 制 数据 直接 到 服务 器 的 能 力 (Tom) 
e 添加 辑 数 paexecPrepared 和 PQsendQueryPrepared , 执行 以 前 预备 语句 的 绑 定 /执行 


(Tom) 


E.183.3.12. JDBC 的 变化 


。 人 允许 在 可 更 新 的 结果 集 上 setNul1 

© 人 允许 在 预备 语句 上 executeBatch (Barry) 
e 支持 SSL 连 接 (Barry) 

。 在 结果 集中 义理 模式 名 (Paul Sorenson) 


。 添加 refcursor 支 持 (Nic Ferrier) 


E.183.3.13. 其 他 接口 的 变化 
。 在 libpgtcl 关 闭 期 间 阻止 可 能 的 内 存 泄露 或 内 核 转 储 (Tom) 
e 添加 到 ECPG 的 Informix 兼 容 性 (Michael) 
这 人 允许 ECPG 钦 理 用 某 些 Informix 扩 展 写 的 钦 入 的 C 程 序 。 
e 为 Informix 添 加 定 长 的 类 型 decimal 到 ECPG (Michael) 


bd Tit RAZR HRA DSOLER #A configure 选项 --enable-thread-safety (Lee 
Kindness, Bruce) 


这 人 允许 同一 时 间 多 线程 访问 数据 库 。 


。 移动 Python 客 户 端 PyGreSQL 到 http://www.pygresql.org (Marc) 


E.183.3.14. 源 代码 的 变化 


。 阻止 对 单独 平台 几何 回 为 结果 文件 的 需要 (Tom) 
。 改进 PPC 的 锁定 原 语 (Reinhard Max) 

。 新 增 画 数 palloce 分 配 和 清理 内 存 (Bruce) 

e 为 S390x CPU (64 位 ) 修 复 锁定 代码 (Tom) 

e 人 允许 OpenBSD 使 用 局 部 鉴别 凭证 (William Ahern) 


使 查询 规划 树 对 于 执行 者 是 只 读 的 (Tom) 


添加 Darwin 和 启动 脚本 (David Wheeler) 

人 允许 libpq 用 Borland C++ 编译 器 编译 (Lester Godwin, Karl Waclawek) 
如 果 需 要 ， 使 用 我 们 自己 的 getopt_long() 版 本 (Peter) 

转换 管理 脚本 为 C (Peter) 

如 果 从 CVS 编 译 ，Bison >= 1.85 现 在 需要 建立 PostgreSQL 语 法 
合并 文档 到 一 本 书 中 (Peter) 

添加 Windows 兼 容 性 函数 (Bruce) 

允许 客户 端 接口 在 MinGW 下 编译 (Bruce) 

为 错误 报告 新 增 ereport() HX (Tom) 

在 Linux 上 支持 Intel 编 译 器 (Peter) 

改善 Linux 和 启动 脚本 (Slawomir Sudnik, Darko Prenosil) 
添加 对 AMD Opteron 和 ltanium 的 支持 (Jeffrey W. Baker, Bruce) 
从 configure 中 删除 - -enable-recode 选项 

不 再 需要 这 个 了 ， 我 们 有 了 CREATE CONVERSION o 

如 果 没 有 找到 自 旋 锁 代 码 ， 那 么 生成 一 个 编译 错误 (Bruce) 


没有 自 旋 锁 代 码 的 平台 现在 将 不 能 编译 ， 而 不 是 默默 的 使 用 信号 灯 。 这 个 失败 可 以 使 用 
一 个 新 的 configure 选项 禁用 。 


E.183.3.15. 贡献 包 的 变化 


改变 dbmirror 许 可 为 BSD 

改善 earthdistance (Bruno Wolff III) 

提高 pgcrypto 的 可 移植 性 (Marko Kreen) 
阻止 xml 中 的 崩溃 (John Gray, Michael Richards) 
更 新 oracle 

更 新 mysql 

更 新 cube (Bruno Wolff Ill) 


更 新 earthdistance 以 使 用 cube (Bruno Wolff III) 


更 新 btree_gist (Oleg) 

新 增 tsearch2 全 文本 搜索 模块 (Oleg, Teodor) 

添加 基于 散 列 的 交叉 表 画 数 到 tablefuncs (Joe) 

添加 连续 的 字段 以 排序 tablefuncs 中 的 connectby() 兄弟 姐妹 (Nabil Sayegh,Joe) 
添加 命名 的 持久 连接 到 dblink (Shridhar Daithanka) 

新 的 pg_autovacuum 人 允许 自动 vacuum (Matthew T. O'Connor) 

让 pgbench 遵 守 环 境 变量 PGHOST 、 PGPORT 、 PGUSER (Tatsuo) 

改进 intarray (Teodor Sigaev) 

改进 pgstattuple (Rod) 

修复 fuzzystrmatch 中 metaphone() 的 错误 

改进 adddepend (Rod) 

更 新 spi/timetravel (Bdjthe Zoltan) 

修复 dbase -s 选项 并 改进 非 ASCII 的 处 理 (Thomas Behr, Marcio Smiderle) 


删除 数组 模块 ， 因 为 现在 默认 情况 下 包括 数组 特性 (Joe) 


E.184. 版 本 7.3.21 


发 布 日 期 : 2008-01-07 
这 个 版 本 包含 7.3.20 的 各 种 补丁 ， 包 括 重 大 安全 问题 的 补丁 。 
预计 这 是 7.3.X 系 列 的 最 后 一 个 PostgreSQL 版 本 。 鼓 励 用 户 尽快 升级 到 一 个 新 的 版 本 分 支 。 


E.184.1. 迁移 到 版 本 7.3.21 


运行 7.3.X 的 不 需要 转 储 /恢复 。 不 过 ， 如 果 从 一 个 7.3.13 更 早 的 版 本 升级 而 来 ， 请 查阅 7.3.13 
的 版 本 说 明 。 


E.184.2. 修改 列表 


e 阻止 用 户 的 权限 运行 vacuum, ANALYZE 等 执行 素 引 里 的 函数 (Tom) 。 


应 用 于 索引 表达 式 和 部 分 素 引 谓 词 的 函数 在 建立 一 个 新 的 表 项 时 被 评估 。 一 直 以 来 以 
为 ， 如 果 一 个 人 修改 了 一 个 未 被 信任 的 用 户 的 表 ， 这 造成 了 特洛伊 木马 代码 扩展 的 风 
险 。 (请 注意 ， 触 发 器 、 缺 省 、 检 查 约束 等 造成 相同 类 型 的 风险 。) 但 是 索引 里 的 函数 
造成 额外 的 威胁 ， 因 为 他 们 将 被 日 常 维护 操作 如 vacuum FuLL 执行 ， 这 些 操 作 通 常 由 一 
个 超级 用 户 账 户 自动 执行 。 例 如 ， 一 个 不 法 用 户 可 以 通过 设置 一 个 特洛伊 木马 索引 定义 
并 等 待 下 一 个 日 常 清理 ， 用 超级 用 户 权限 执行 代码 。 修复 标准 维护 操作 (包括 vacu , 
ANALYZE , REINDEX , 和 CLUSTER ) aN ae gale 使 
FA SECURITY DEFINER 阔 数 已 经 使 用 的 相同 的 权限 切换 机 制 。 为 了 阻止 绕 过 这 个 安全 措 
施 ， 现 在 禁止 SET SESSION AUTHORIZATION 和 SET ROLE 在 SECURITY DEFINER acca 
f. (CVE-2007-6600) 


。 需要 使 用 /contrib/dblink 的 非 超级 用 户 只 使 用 口令 认 证 ， 作 为 一 个 安全 措施 (Joe)。 


在 7.3.20 里 出 现 的 修复 是 不 完整 的 ， 因 为 它 为 了 一 些 dblink WRT ET. (CVE- 
2007-6601, CVE-2007-3278) 


。 当 使 用 一 个 多 字 节 数据 库 编码 时 ， 修 复 translate() 里 的 潜在 冲突 。(Tom) 
e 使 得 contrib/tablefunc 的 crosstab() 处 理 空 rowid 本 身 为 一 个 类 别 ， 而 不 是 冲突 。(Joe) 
。 当 重 新 生成 configure 脚本 时 需要 使 用 一 个 特定 的 Autoconf 版 本 。(Peten) 


这 只 影响 开发 者 和 打包 者 。 这 样 做 是 为 了 阻止 意外 的 使 用 未 经 检验 的 Autoconf 和 
PostgreSQL 版 本 的 组 合 。 如 果 你 真 的 想 要 使 用 一 个 不 同 的 Autoconf 版 本 ， 你 可 以 移 除 版 
本 检查 ， 但 是 结果 如 何 你 自己 负责 。 
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E.185. 版 本 7.3.20 


发 布 日 期 : 2007-09-17 


这 个 版 本 包含 7.3.19 的 补丁 。 


E.185.1. 迁移 到 版 本 7.3.20 


运行 7.3.X 的 不 需要 转 储 /恢复 。 不 过 ， 如 果 从 一 个 7.3.13 更 早 的 版 本 升级 而 来 ， 请 查阅 7.3.13 
的 版 本 说 明 。 


E.185.2. 修改 列表 
。 当 一 个 事务 插入 行 然 后 在 接近 相同 表 上 当前 vacuum 的 结尾 时 终止 时 ， 阻 止 素 引 损 坏 。 
(Tom) 
e 使 CREATE DOMAIN ... DEFAULT NULL 正确 工作 (Tom) 
e 修复 当 log_min_error_statement 日 志 耗 尽 内 存 时 的 崩溃 (Tom) 


。 需要 使 用 /contrib/dblink 的 非 超级 用 户 使 用 唯一 口令 认证 ， 作 为 安全 措施 (Joe) 


E.186. 版 本 7.3.19 


发 布 日 期 : 2007-04-23 


这 个 版 本 包含 7.3.18 的 补丁 ， 包 括 一 个 安全 补丁 。 


E.186.1. 迁移 到 版 本 7.3.19 


运行 7.3.X 的 不 需要 转 储 /恢复 。 不 过 ， 如 果 从 一 个 7.3.13 更 早 的 版 本 升级 而 来 ， 请 查阅 7.3.13 
的 版 本 说 明 。 


E.186.2. 修改 列表 


e 支持 在 search_path 中 对 临时 表 模 式 明确 布局 ， 并 且 禁 用 搜索 函数 和 操作 符 (Tom) 


这 需要 允许 安全 定义 函数 设置 search_path 的 安全 值 。 没 有 这 个 ， 一 个 非特 权 SQL 用 户 
可 以 使 用 临时 对 象 用 安全 定义 图 数 的 权限 执行 代码 (CVE-2007-2138)。 参 
阅 CREATE FUNCTION 获取 更 多 信息 。 


。 修复 vacuum FuLL 义理 uppate 链 时 的 潜在 数据 损坏 臭虫 Tom, Pavan Deolasee) 


E.187. 版 本 7.3.18 


发 布 日 期 : 2007-02-05 


这 个 版 本 包含 各 种 7.3.17 的 补丁 ， 包 括 安 全 补丁 。 


E.187.1. 迁移 到 版 本 7.3.18 


运行 7.3.X 的 不 需要 转 储 /恢复 。 不 过 ， 如 果 从 一 个 7.3.13 更 早 的 版 本 升级 而 来 ， 请 查阅 7.3.13 
的 版 本 说 明 。 


E.187.2. 修改 列表 


。 移 除 了 人 允许 连接 用 户 读 取 后 端 存 储 的 安全 漏洞 (Tom) 


安全 隐患 包括 在 一 个 SQL 画 数 中 改变 表 字 段 的 数据 类 型 (CVE-2007-0555)。 这 个 错误 很 
容易 被 利用 导致 后 端 月 演 ， 并 且 原 理 上 可 能 被 用 来 读 取 该 用 户 不 能 访问 的 数据 库 内 容 。 


。 修复 在 不 可 行 的 分 解 点 拆 分 btree 索 引 页 可 能 失败 的 罕见 bug(Heikki Linnakangas) 


。 加 强 超过 三 个 字 节 长 度 的 UTF8 序 列 的 多 类 型 字符 处 理 的 安全 (Tom) 


E.188. 版 本 7.3.17 


发 布 日 期 : 2007-01-08 


这 个 版 本 包含 各 种 7.3.16 的 补丁 。 


E.188.1. 迁移 到 版 本 7.3.17 


运行 7.3.X 的 不 需要 转 储 /恢复 。 不 过 ， 如 果 从 一 个 7.3.13 更 早 的 版 本 升级 而 来 ， 请 查阅 7.3.13 
的 版 本 说 明 。 


E.188.2. 修改 列表 


e。 对 于 新 initdb 安 装 来 说 ， to_number() 和 to_char(numeric) 现在 是 STABLE 而 不 


是 IMMUTABLE (Tom) 

这 是 因为 1c_numeric 可 以 潜在 的 改变 这 些 函 数 的 输出 。 
。 改善 使 用 圆 括号 的 正则 表达 式 的 索引 使 用 (Tom) 

也 改善 psql \d 的 性 能 


E.189. 版 本 7.3.16 


发 布 日 期 : 2006-10-16 


这 个 版 本 包含 各 种 7.3.15 的 补丁 。 


E.189.1. 迁移 到 版 本 7.3.16 


运行 7.3.X 的 不 需要 转 储 /恢复 。 不 过 ， 如 果 从 一 个 7.3.13 更 早 的 版 本 升级 而 来 ， 请 查阅 7.3.13 
的 版 本 说 明 。 


E.189.2. 修改 列表 


。 修复 模式 中 匹配 psql 的 \d 命令 的 极端 情况 。 

。 修复 /contriby/ltree 里 的 索引 损坏 bug(Teodon) 

。 移植 7.4 自 旋 锁 代 码 以 提升 性 能 和 更 好 的 支持 64 位 架构 
。 修复 libpq 中 的 SSL 相 关 的 内 存 泄露 

e 修复 /contrib/dbmirror 中 的 反 斜 杠 逃 逸 


。 为 最 近 US DST 法 律 的 变化 调整 回 为 测试 


E.190. 版 本 7.3.15 


发 布 日 期 : 2006-05-23 


这 个 版 本 包含 各 种 7.3.14 的 补丁 ， 包 括 极端 严重 的 安全 问题 的 补丁 。 


E.190.1. 迁移 到 版 本 7.3.15 
运行 7.3.X 的 不 需要 转 储 /恢复 。 不 过 ， 如 果 从 一 个 7.3.13 更 早 的 版 本 升级 而 来 ， 请 查阅 7.3.13 
的 版 本 说 明 。 


在 CVE-2006-2313 和 CVE-2006-2314 中 描述 的 针对 SQL 注 入 攻击 的 完全 安全 可 能 需要 在 应 用 
代码 中 改变 。 如 果 你 的 应 用 在 SQL 命 命中 内 入 了 不 能 信任 的 字符 串 ， 那 么 你 应 该 尽快 检查 它 
i, 以 确保 它们 正在 使 用 推荐 的 转 义 技术 。 在 大 多 数 情况 下 ， 应 用 应 该 使 用 库 或 驱动 提供 的 
子 程 序 (如 libpq 的 Paescapestringconn() ) 来 执行 字符 串 转 义 ， 而 不 是 依赖 于 aa hoctt 4. 


E.190.2. 修改 列表 


。 更 改 服务 器 使 在 其 任何 情况 下 都 拒绝 无 用 编码 的 多 字 节 字符 (Tatsuo, Tom) 


当 PostgreSQL 在 某 段 时 间 一 直 朝 着 这 个 方向 移动 时 ， 检查 现在 一 致 的 应 用 到 所 有 的 编码 
和 所 有 的 文本 输入 ， 并 且 现 在 错误 不 仅仅 是 警告 那么 简单 。 这 个 改变 防范 在 CVE-2006- 
2313 里 描述 的 SQL 注入 攻击 类 型 。 


拒绝 字符 串 里 不 安全 的 使 用 \， 


作为 防范 在 CVE-2006-2314 里 描述 的 SQL 注入 攻击 类 型 的 服务 器 端 ， 服 务 器 现在 只 接 
So 而 不 是 \' 作为 SQL 字符 串 字 面值 里 的 ASCII 单 引号 表示 。 缺 省 的 ， 只 

有 client_encoding 设置 为 仅 客户 端的 编码 (SJIS, BIG5, GBK, GB18030, 或 UHC) 时 拒 
绝 、! ， 这 是 可 能 有 SQL 注 入 的 情况 。 一 个 新 的 配置 参数 backslash_quote 可 在 需要 时 用 
于 调整 这 个 行为 。 请 注意 ， 针 对 CVE-2006-2314 的 完全 安全 可 能 需要 客户 端 侧 的 改变 ; 
backslash_quote 的 目的 是 在 某 种 程度 上 使 不 安全 的 客户 端 是 不 安全 的 显 而 易 见 。 


修改 libpq 的 字符 串 逃 逸 例 程 ， 使 其 知道 编码 注意 事项 


libpq 使 用 这 个 补丁 应 用 于 CVE-2006-2313 和 CVE-2006-2314 中 描述 的 安全 问题 。 使 用 
多 个 PostgreSQL 并 发 连接 的 应 用 应 该 迁移 到 Poescapestringconn() 

和 poescapeeyteaconn() ， 以 确保 为 每 个 数据 库 连接 中 使 用 的 设置 正确 的 转 义 。 "手动 " 进 
行 字符 串 转 义 的 应 用 应 该 被 修改 为 依赖 于 库 例 程 。 


。 修复 一 些 不 正确 的 编码 转换 函数 


wini251_to_iso , alt_to_iso , euc_tw_to_big5 , euc_tw_to_mic , mic_to_euc_tw 都 分 配 


为 不 同 的 范围 。 
。 清理 字符 串 中 残留 的 \' 的 使 用 (Bruce, Jan) 
。 正确 的 修复 服务 器 使 用 自 定义 的 DH SSL 参 数 (MichaelFuhn) 


。 修复 各 种 小 内 存 泄露 


E.191. 版 本 7.3.14 


发 布 日 期 : 2006-02-14 


这 个 版 本 包含 各 种 7.3.13 的 补丁 。 


E.191.1. 迁移 到 版 本 7.3.14 


运行 7.3.X 的 不 需要 转 储 /恢复 。 不 过 ， 如 果 从 一 个 7.3.13 更 早 的 版 本 升级 而 来 ， 请 查阅 7.3.13 
的 版 本 说 明 。 


E.191.2. 修改 列表 


e 修复 SET SESSION AUTHORIZATION (CVE-2006-0553) 中 潜在 的 危机 


非特 权 的 用 户 可 能 使 服务 器 进程 崩溃 ， 导 致 短暂 的 拒绝 服务 其 他 用 户 ， 如 果 服 务 器 启用 
维护 编译 GERBE) 。 感 谢 Akio lshida 报 告 了 这 个 问题 。 


。 修复 自 插入 行 的 行 可 见 逻 辑 的 bug(Tom) 


在 罕见 情况 下 ， 通 过 当前 命令 插入 的 行 会 被 看 做 早已 经 有 效 ， 此 时 它 不 应 该 有 效 。 修复 
bug 在 7.3.11 版 本 中 创建 。 


。 修复 在 pg_clog 文 件 创建 时 会 导致 "文件 已 经 存在 "错误 的 竞 态 条 件 。 
。 修复 以 允许 有 交叉 模式 的 恢复 转 储 引 用 自 定 义 操作 符 (Tom) 
。 在 配置 期 间 测 试 finite 和 isinf 的 存在 的 可 移植 性 修复 (Tom) 


E.192. 版 本 7.3.13 


发 布 日 期 : 2006-01-09 


这 个 版 本 包含 各 种 7.3.12 以 来 的 补丁 。 


E.192.1. 迁移 到 版 本 7.3.13 


运行 7.3.X 的 不 需要 转 储 /恢复 。 不 过 ， 如 果 从 一 个 7.3.10 更 早 的 版 本 升级 而 来 ， 请 查阅 7.3.10 
的 版 本 说 明 。 另外 ， 如 果 你 被 下 面 描述 的 本 地 或 plperl 问 题 影响 ， 你 可 能 需要 在 升级 之 
后 REINDEX 在 文本 字段 上 的 索引 。 


E.192.2. 修改 列表 


。 为 本 地 认为 不 同 字 符 组 合 平等 的 想法 修复 字符 串 比 较 ， 如 Hungarian (Tom) 
这 可 能 需要 REINDEX 来 修复 在 文本 字段 上 的 现 有 索引 。 
。 在 主机 和 启动 期 间 设置 本 地 环境 变量 ， 以 确保 plpernl 稍 后 不 会 更 改 本 地 设置 


这 修复 了 postmaster 上 启动 时 不 使 用 initdb 指 定 的 环境 变量 的 问题 。 在 这 种 情况 下 ，plperl 
的 任何 使 用 都 可 能 导致 损坏 索引 。 如 果 发 生 了 这 个 ， 可 能 需要 REINDEX 来 修复 在 文本 字 
有 上 的 现 有 索引 。 


。 修复 在 strpos() 和 在 某 些 很 少 使 用 的 Asian 多 字 节 字符 设置 中 处 理 的 正则 表达 式 中 长 期 存在 
的 bug(Tatsuo) 


e 修复 在 /contrib/pgcrypto gen_salt 中 的 bug， 该 pug 导致 它 不 为 MD5 或 XDES 算 法 使 用 
所 有 可 用 的 salt 空 间 (Marko Kreen, Solar Designer) 


salt 对 Blowfish 和 标准 DES 没 有 影响 。 


。 当 指 定 的 字段 号 不 同 于 查询 实际 返回 的 值 时 ， 修 复 /contrip/dblink 抛 出 一 个 错误 ， 而 不 
是 死机 (Joe) 


E.193. 版 本 7.3.12 


发 布 日 期 : 2005-12-12 


这 个 版 本 包含 各 种 自 7.3.11 以 来 的 补丁 。 


E.193.1. 迁移 到 版 本 7.3.12 


运行 7.3.X 的 不 需要 转 储 /恢复 。 不 过 ， 如 果 从 一 个 7.3.10 更 早 的 版 本 升级 而 来 ， 请 查阅 7.3.10 
的 版 本 说 明 。 


E.193.2. 修改 列表 


。 修复 事务 日 志 管 理 中 的 竞 态 条 件 

这 里 有 一 个 窄 口 ，I/O 操 作 可 以 从 错误 页 开始 ， 导 致 维护 失败 或 数据 损坏 。 
e 修复 了 /contrib/itree (Teodor) 
。 修复 了 对 于 外 连接 长 期 存在 的 规划 错误 

这 个 bug 有 时 会 导致 一 个 假 的 错误 " 右 连 接 只 支持 合并 可 连接 的 连接 条 件 "。 
。 当 一 个 表 已 经 被 删除 时 ， 阻 止 pg_autovacuum 里 的 核心 转 储 。 


E.194. 版 本 7.3.11 


发 布 日 期 : 2005-10-04 


这 个 版 本 包含 自 7.3.10 以 来 的 各 种 补丁 。 


E.194.1. 迁移 到 版 本 7.3.11 


运行 7.3.X 的 不 需要 转 储 /恢复 。 不 过 ， 如 果 从 一 个 7.3.10 更 早 的 版 本 升级 而 来 ， 请 查阅 7.3.10 
的 版 本 说 明 。 


E.194.2. 修改 列表 


。 修复 允许 vacuum 移 除 ctid 链 太 快 的 错误 ， 并 在 代码 中 添加 更 多 跟随 ctid 连接 的 检查 
这 修复 了 在 十 分 罕见 的 情况 下 可 能 导致 死机 的 长 期 存在 的 问题 。 


了 
。 当 使 用 多 字 节 字符 设置 时 ， 修 复 cHAR() 使 其 适当 添加 空白 到 指定 的 长 度 (Yoshiyuki 


在 先前 的 版 本 中 ， chHAR() 的 填充 是 不 正确 的 ， 因为 它 只 填充 指定 的 字 节 数 而 不 考虑 存储 
了 多 少 个 字符 。 


修复 在 类 似 UPDATE a=... WHERE a... with GiST index on column a 的 查询 中 丢失 行 的 


问题 


改善 部 分 写 入 WAL 页 面 的 检查 

。 改善 启用 SSL 时 信号 处 理 的 健壮 性 
。 修复 了 各 种 内 存 泄露 

各 种 可 移植 性 改善 


。 修复 当 变量 类 型 是 通过 参数 传递 


m 


t, PL/pgSQLik fff xE var := var 的 问题 。 


E.195. 版 本 7.3.10 


发 布 日 期 : 2005-05-09 


这 个 版 本 包含 各 种 自 7.3.9 以 来 的 补丁 ， 包 括 几 个 安全 相关 的 问题 。 


E.195.1. 迁移 到 版 本 7.3.10 


运行 7.3.X 的 不 需要 转 储 /恢复 。 不 过 ， 转 储 / 恢 复 是 处 理 在 7.3.X 系 统 目 录 中 的 初始 化 内 容 中 发 
现 的 重大 安全 问题 的 一 种 方式 。 使 用 7.3.10 的 initdb 的 dump/initdb/reload 序 列 将 自动 改正 这 个 
问题 。 


安全 问题 是 非特 权 用 户 可 以 通过 SQL 命 合 引 用 内 建 字 符 设 置 编码 转换 图 数 ， 但 是 该 范 数 不 是 
这 样 使 用 的 ， 并 且 对 于 恶意 的 参数 选择 是 不 安全 的 。 修复 包括 改变 这 些 画 数 声 明 的 参数 列 
表 ， 这 样 它们 可 以 不 再 被 SQL 命令 调 用 。 (这 样 并 不 影响 它们 通过 编码 转换 机 制 的 正常 使 
用 。) 强烈 推荐 所 有 安装 修复 这 个 错误 ， 通 过 initdb 或 通过 下 面 给 出 的 手动 修复 过 程 。 该 错误 
至 少 人 允许 非特 权 数 据 库 用 户 毁 坏 他 们 的 服务 器 进程 ， 其 至 可 能 允许 非特 权 用 户 获得 数据 库 超 
级 用 户 的 权限 。 


如 果 你 希望 不 做 initdb， 那 么 执行 下 列 的 过 程 。 作 为 数据 库 超级 用 户 ， 执 行 : 


BEGIN; 
UPDATE pg_proc SET proargtypes[3] = 'internal'::regtype 
WHERE pronamespace = 11 AND pronargs = 5 
AND proargtypes[2] = 'cstring'::regtype; 
- 该 命令 应 该 报告 已 经 更 新 了 90 行 ， 
-- 如 果 不 是 ， 那 么 回 滚 并 调查 而 不 是 提交 8! 
COMMIT; 


上 面 的 程序 必须 在 每 个 安装 的 数据 库 中 执行 ， 包括 template1 ， 并 且 理 论 上 也 包 

括 templateo 。 如 果 你 不 修复 模板 数据 库 ， 那么 任何 随后 创建 的 数据 库 将 包含 相同 的 错 

误 。 template1 可 以 用 与 任意 其 他 数据 库 相 同 的 方式 修复 ， 但 是 修复 templated 需要 额外 的 
步骤 。 首 先 ， 从 任意 数据 库 发 出 : 


UPDATE pg_database SET datallowconn = true WHERE datname = 'templateQ0'; 


然后 连接 到 templateo 并 执行 以 上 所 述 的 修复 程序 。 最 后 ， 执 行 : 


-- 重新 冻结 template0: 

VACUUM FREEZE; 

-- 保护 它 免 受 未 来 的 变化 : 

UPDATE pg_database SET datallowconn = false WHERE datname = 'templateo'; 


E.195.2. 修改 列表 


。 改变 编码 图 数 签名 以 阻止 滥用 


。 修复 古老 竞 态 条 件 ， 该 条 件 人 允许 一 个 事务 因为 某 些 目的 (如 SELECT FOR UPDATE) 被 视 
作 已 提交 


这 是 一 个 极其 严重 的 bug， 因 为 它 会 导致 表面 数据 的 不 一 致 性 被 应 用 短暂 的 看 到 。 
。 修复 相关 扩展 和 VACUUM 之 间 的 竞 态 条 件 


这 理论 上 可 能 导致 去 失 新 近 插 和 人 的 数据 的 一 个 页 面 ， 尽 管 情 况 看 起 来 概率 很 低 。 RAF 
致 多 于 一 个 维护 失败 的 已 知情 况 。 


e 修复 了 TIME WITH TIME zone 值 的 比较 


当 使 用 --enable-integer-datetimes 配置 开关 时 ， 该 比较 代码 是 错 误 的 。 注意 : : 如 果 你 
在 TIME WITH TIME ZONE 字段 上 有 索引 ， 它 将 需要 在 安装 这 个 更 新 后 REINDEX ， 因 为 这 个 
修复 纠正 了 字段 值 的 顺序 。 


© 为 TIME WITH TIME ZONE 值 修复 了 EXTRACT(EPOCH) 
。 修复 了 INTERVAL 值 中 负 分 数秒 的 错误 显示 
这 个 错误 只 有 在 使 用 了 - -enable-integer-datetimes 配置 开关 的 时 候 发 生 。 
© 在 plpgsql 中 额外 的 缓冲 区 浴 出 检查 (Neil) 
。 修复 pg_dump 转 储 触 发 器 名 字 正 确 的 包含 (Neil) 
e 阻止 to_char(interval) 为 月 份 相 关 的 格式 转 储 内 核 
。 为 更 新 的 OpenSSL 构 建 修复 contrib/pgcrypto (Marko Kreen) 
e 为 contrib/intagg 修复 更 多 的 64 位 问题 


e 阻止 返回 REcoRD 的 画 数 的 不 正确 的 最 优化 


E.196. 版 本 7.3.9 


发 布 日 期 : 2005-01-31 


这 个 版 本 包含 自 7.3.8 以 来 的 各 种 补丁 ， 包 括 几 个 安全 相关 的 问题 。 


E.196.1. 迁移 到 版 本 7.3.9 


运行 7.3.X 的 不 需要 转 储 / 恢 复 。 


E.196.2. 修改 列表 


e 不 允许 Loa 到 非 超级 用 户 


在 平台 上 将 自动 执行 共享 库 (至 少 包括 窗口 和 ELF-based Unixen) 的 初始 化 函数 ， 
LOAD 可 以 用 来 使 服务 器 执行 任意 的 代码 。 感 谢 NGS Software 报 告 这 个 问题 。 


。 检查 聚集 画 数 的 创建 者 有 执行 指定 转换 画 数 的 权利 

这 个 朴 忽 使 其 可 以 绕 过 本 数 上 EXECUTE 权 限 的 拒绝 。 
。 修复 contrib/intagg 中 的 安全 和 64 位 问题 
e AR contrib BUR Fs ZL ASTRICT iz (Kris Jurka) 
e 当 plpgsdI 游 标 声明 有 太 多 的 参数 时 避免 缓冲 区 浴 出 (Neil) 
e 为 FULL 和 RIGHT 外 连接 修复 规划 错误 


连接 的 结果 被 错误 的 认为 和 左 输入 的 排序 相同 。 这 不 止 会 发 送 错误 排序 的 输出 给 用 户 


而 且 在 柑 套 合并 连接 的 情况 下 会 给 出 完全 错误 的 回复 。 
。 修复 plperl 在 元 组 字段 的 双 引 号 标记 


e 修复 SQL 和 GERMAN 数 据 类 型 中 负数 间隔 的 显示 


E.197. 版 本 7.3.8 


发 布 日 期 : 2004-10-22 


这 个 版 本 包含 各 种 自 7.3.7 以 来 的 补丁 。 


E.197.1. 迁移 到 版 本 7.3.8 


运行 7.3.X 的 不 需要 转 储 /恢复 。 


E.197.2. 修改 列表 


。 修复 可 能 未 能 更 新 到 磁盘 上 的 提示 


在 很 少 的 情况 下 ， 这 个 疏忽 会 导致 "不 能 访问 事务 状态 "错误 ， 这 是 一 个 潜在 的 数据 丢失 
bug。 


确保 散 列 的 外 连接 不 丢失 元 组 
使 用 哈 希 连接 规划 的 非常 大 的 左 连接 不 会 输出 不 匹配 的 左 侧 行 只 给 出 正确 的 数据 分 布 。 
e 不 允许 作为 root 运 行 pg_ctl 
这 是 为 了 预防 任何 可 能 的 安全 问题 。 
。 避免 在 make_oidjoins_check 中 使 用 /tmp 中 的 临时 文件 


这 已 经 作为 一 个 安全 问题 报告 了 ， 尽 管 它 几乎 不 值得 关心 ， 因 为 没有 原因 会 使 非 开 发 者 
使 用 这 个 脚本 。 


E.198. 版 本 7.3.7 


发 布 日 期 : 2004-08-16 


这 个 版 本 包括 7.3.6 的 一 个 关键 的 修复 ， 和 一 些小 的 项 目 。 


E.198.1. 迁移 到 版 本 7.3.7 


运行 7.3.X 的 不 需要 转 储 / 恢 复 。 


E.198.2. 修改 列表 


。 在 死机 期 间 阻止 可 能 的 已 提交 事务 的 丢失 


由 于 事务 提交 和 检查 点 之 间 不 充分 的 连锁 ， 正 好 在 最 近 的 检查 点 之 前 提交 的 事务 可 能 会 


用 到 
ZA, 全 部 的 或 部 分 的 ， 在 数据 库 骨 溃 和 重启 后 。 这 是 一 个 自 PostgreSQL 7.1 以 来 就 存 
在 的 严重 bug。 
。 删除 tsearch 中 不 对 称 的 文字 义理 (Teodon) 


。 在 pg_dump 一 个 CAST 时 ， 恰 当 的 模式 限定 画 数 名 


E.199. 版 本 7.3.6 


发 布 日 期 : 2004-03-02 


这 个 版 本 包含 各 种 自 7.3.5 以 来 的 补丁 。 


E.199.1. 迁移 到 版 本 7.3.6 


运行 7.3.* 版 本 的 用 户 不 需要 转 储 /恢复 。 


E.199.2. 修改 列表 


。 修复 规则 权限 检查 中 错误 的 改变 


在 7.3.3 中 应 用 的 补丁 修复 一 个 极端 情况 ， 在 许多 不 是 很 极端 的 情况 下 ， 规则 权限 检查 变 
成 有 茶 用 规则 相关 权限 的 检查 。 这 可 能 比如 允许 用 户 插入 到 他 们 不 希望 有 权限 插入 的 视 
图 中 。 我 们 因此 恢复 7.3.3 补 丁 。 原 始 的 bug 将 在 8.0 中 修复 。 


。 修复 GetNewTransactionld() 中 操作 的 不 正确 的 顺序 


这 个 bug 会 导致 超出 磁 总 空间 条 件 的 失败 ， 包 括 没 有 重启 的 能 力 ， 即 使 磁盘 空间 空闲 之 后 
也 不 行 。 


。 即使 提供 了 一 个 额外 的 值 给 CFLAGS 也 要 确保 配置 选择 fno 严格 的 别名 。 
在 某 些 平台 上 ， 用 -fstrict-aliasing 建 立会 导致 bug。 

e 使 pg_restore 正确 的 处 理 64 位 的 off 
这 个 bug 阻 止 从 超过 4 GB 的 为 档 文 件 中 正确 的 恢复 。 

。 使 contrib/dblink 不 假设 本 地 和 远程 类 型 OID 匹 配 (Joe) 

e 恰当 的 引用 connectby() 的 start_with 参 数 (Joe) 

e 当 plpgsql 辑 数 的 行 类 型 参数 是 NULL 时 不 死机 

。 当 规 划 LIKE 操 作 符 时 避免 在 极端 情况 下 产生 无 效 字符 编码 序列 


。 确保 text_position() 在 多 字 节 情况 下 不 能 扫描 通过 源 字 符 串 的 结尾 (Korea PostgreSQL 
Users' Group) 


。 修复 索引 优化 并 选择 性 的 为 LIKE 操 作 符 的 bytea 字 段 估计 (Joe) 


E.200. 版 本 7.3.5 


发 布 日 期 : 2003-12-03 


有 各 种 自 7.3.4 以 来 的 补丁 。 


E.200.1. 迁移 到 版 本 7.3.5 


运行 7.3.* 版 本 的 用 户 不 需要 转 储 /恢复 。 


E.200.2. 修改 列表 


。 强制 雳 损坏 的 页 面 在 WAL 恢 复 期 间 工 作 

。 阻止 某 些 " 变 量 不 在 子 计划 目录 列表 "的 模糊 情况 

。 强制 统计 过 程 从 共享 内 存 中 分 离 ， 确 保 清 理 关 闭 

e 使 PQescapeBytea 和 byteaout 相 互 一 致 (Joe) 

e 添加 了 和 去 失 的 SPI finish() 调 用 到 dblink 的 get_ tuple_of interest() (Joe) 
。 当 规 则 重 写 INSERT 时 修复 可 能 的 违反 外 键 约束 (Jan) 

e 在 PL/Tcl 的 spi_prepare 命 令 中 支持 合格 的 类 型 名 (Jan) 

。 使 pg_dump 人 处 理 pg_catalog 中 的 过 程 语言 处 理 器 

e 使 pg_dump 处 理 自 定义 操作 符 类 是 另外 一 个 模式 的 情况 

。 使 pg_dump 正 确 的 转 储 二 进 制 兼容 的 转换 

。 修复 包含 子 查 询 的 表达 式 插入 到 规则 中 

。 修复 clusterdb 脚 本 中 不 正确 的 参数 处 理 (Anand Ranganathan) 
。 修复 plpython 触 发 器 中 已 出 除 字段 的 问题 

。 修复 to_char() 读 取 过 去 的 输入 字符 串 结 束 的 问题 (Karel) 

。 修复 GB18030 映 射 错误 (Tatsuo) 

。 修复 几 个 SSL 错 误 处 理 和 异步 SSL /WO 问题 


。 修复 在 JDBC 中 绑 定 一 个 值 的 列表 到 单个 参数 的 能 力 (阻止 可 能 的 SQL 注入 攻击 ) 


e 修复 HAVE_INT64_TIMESTAMP 代 码 路 径 中 的 一 些 错误 


。 修复 btree 索 引 和 第 一 次 根 页 面 分 离 并 行 的 极端 情况 


E.201. 版 本 7.3.4 


发 布 日 期 : 2003-07-24 


有 各 种 自 7.3.3 以 来 的 补丁 。 


E.201.1. 迁移 到 版 本 7.3.4 


运行 7.3.* 版 本 的 用 户 不 需要 转 储 /恢复 。 


E.201.2. 修改 列表 


。 修复 2000 以 前 的 timestamp-to-date 日 期 转换 的 损坏 

。 阻止 极 少 服务 器 启动 失败 的 可 能 性 (Tom) 

。 修复 interval-to-time 转 换 中 的 bug(Tom) 

。 在 pg_dump 中 的 几 个 地 方 添加 约束 名 (Rod) 

。 提高 有 很 多 参数 的 函数 的 性 能 (Tom) 

。 修复 to_ascii() 缓 冲 浴 出 (Tom) 

。 阻止 抛 出 一 个 恢复 数据 库 评 论 的 错误 (Tom) 

。 解决 存在 于 一 些 Solaris 版 本 中 的 多 个 问题 的 strxfrm()(Tom) 


。 恰当 的 逃逸 jdbc setObject() 字 符 串 以 提高 安全 性 (Barry) 


E.202. 版 本 7.3.3 


发 布 日 期 : 2003-05-22 


这 个 版 本 包含 版 本 7.3.2 的 各 种 补丁 。 


E.202.1. 迁移 到 版 本 7.3.3 


运行 7.3.* 版 本 的 用 户 不 需要 转 储 /恢复 。 


E.202.2. 修改 列表 


。 修复 崩溃 后 计算 StartUplD 有 时 不 正确 的 问题 

。 避免 在 一 个 事务 中 大 量 推迟 的 触发 器 迟钝 (Stephan) 

e 当 uppate 不 改变 外 键 的 值 时 不 要 锁 住 引用 的 行 (Jan) 

e 在 Sparc 上 使 用 -fpIc 而 不 是 -fpic (Tom Callaway) 

。 修复 contrib/reindexdb 中 缺少 模式 意识 的 问题 

。 修复 需 元 素 结果 数组 的 contrib/intarray 错 误 (Teodor) 

。 确保 createuser 脚 本 在 control-C 时 退出 (Oliver) 

。 修复 删除 的 字段 类 型 本 身 已 经 被 删除 的 错误 

© CHECKPOINT 在 非 关 键 的 步骤 下 不 会 在 错误 时 引起 数据 库 恐 慌 

。 接受 时 间 惟 、 时 间 、 间 陋 输 入 值 的 秒 字 段 为 60 

e 如 果 TIMESTAMP ，TIME , 或 INTERVAL 精度 太 大 ， 发 出 一 个 通知 而 不 是 错误 。 
。 修复 abstime-to-time 转换 函数 (initdb 后 生效 ) 

。 为 timestampt_izone 修复 pg_proc 条 目 (initdb 后 生效 ) 

e 使 EXTRACT(EPOCH FROM timestamp without time zone) 将 输入 当做 本 地 时 间 
e。 如 果 时 区 改变 在 事务 之 前 那么 'now' : :timestamptz 给 出 错误 回复 

e HAVE_INT64_TIMESTAMP 代码 为 time with timezone 写 满 输入 


e 接受 GLOBAL TEMP/TEMPORARY 作为 TEMPORARY 的 一 个 同义词 


在 外 键 触发 器 中 避免 不 正确 的 模式 权限 检查 失败 

修复 set DEFAULT 动作 中 的 外 键 触 发 器 的 bug 

为 UPDATE 和 DELETE 触发 器 修复 行 抓 取 中 不 正确 的 time-qual 检 查 
外 键 子 句 在 ALTER TABLE ADD COLUMN 中 被 解析 但 是 被 忽略 

修复 多 理 器 函数 已 经 存在 时 createlang 脚 本 损坏 的 情况 
修复 在 pg_dump, COPY, ANALYZE, 其 他 地 方 的 需 字 段 表 的 错误 行为 
修复 func_error() 在 类 型 名 包含 '%' 时 的 错误 行为 

修复 replace() 在 字符 串 包含 '%' 时 的 错误 行为 

规则 表达 式 模 式 包含 确定 的 多 字 节 字符 失败 

在 大 多 数 情况 下 的 连接 大 小 估计 上 为 NuLL 正确 的 解释 

避免 isblank() 函数 或 宏 的 系统 定义 冲突 

修复 EUC_TW 转 换 中 转换 大 代码 点 值 的 失败 

修复 sst_read / sst_write 调用 的 错误 恢复 

不 做 强制 类 型 转换 表达 式 的 早期 常数 合并 

验证 在 任何 页 面 的 页 面 标题 字段 紧 接 阅读 

修复 未 命名 连接 中 的 未 分 组 变量 的 不 正确 检查 

修复 to_ascii 中 的 缓冲 浴 出 (Guido Notari) 

contrib/ltree 修复 (Teodor) 

修复 机 器 上 字符 是 无 符号 的 死 锁 检测 中 的 内 核 转 储 

避免 多 种 方式 索引 扫描 中 耗 尽 内 存 (7.3 中 的 bug) 

修复 规划 者 的 选择 性 估计 男 数 正确 的 处 理 域 

修复 dbmirror 内 存 分 配 bug(Steven Singer) 

阻止 in(numeric) 中 因为 舍 人 错误 无 限 循环 

如 果 有 多 个 相等 的 GROUP BY 条 目 ， 那 么 croup BY 就 会 感到 困惑 
修复 当 继承 的 UPDATE / DELETE 参考 另外 一 个 继承 的 表 时 的 糟糕 规划 
阻止 在 不 完整 (部 分 或 非 NULL 存 储 ) 的 素 引 上 集群 

如 果 服 务 关 闭 请 求 到 达 时 仍然 在 启动 那么 在 适当 的 时 间 处 理 


修复 临时 索引 中 的 左 连接 (可 以 通过 向 后 扫描 错过 入 口 ) 

修复 postgresql.conf 中 不 正确 的 处 理 client_encoding 设 置 (Tatsuo) 
修复 在 Async_NotifyHandler 运 行 之 后 未 能 响应 pg_ctl stop -m fast 
修复 规则 包含 相同 类 型 的 多 个 声明 时 的 SPI 

修复 规则 查询 中 访问 权限 的 错误 类 型 检查 的 问题 

修复 cREATE RULE 中 EXcEPT 的 问题 

预防 删除 带 有 序列 字段 的 临时 表 的 问题 

修复 复杂 视图 中 replace_vars_with_subplan_refs 的 失败 

修复 regexp 在 单字 节 编 码 里 的 缓慢 (Tatsuo) 

在 CREATE CAST 和 DROP CAST 

接受 setor type[] ， 以 前 写作 setor _type 

修复 在 过 程 语言 的 某 些 情况 下 的 pg_dump 内 核 转 储 

为 了 可 移植 性 ， 强 制 在 pg_dump 的 输出 中 使 用 ISO 数据 类 型 (Olivenm) 
pg_dump 未 能 处 理 lo_read 返回 的 错误 (Oleg Drokin) 
pg_dumpall 分 组 失败 ， 分 组 里 面 没 有 成 员 (Nick Eskelinen) 
pg_dumpall 未 能 识别 --globals-only 开关 

如 果 声 明了 -X disable-triggers， 那 么 pg_restore 未 能 存储 二 进 制 大 对 象 
($8 plpgsql F AR NAA Fah 

如 果 给 出 错误 的 参数 ， 那 么 pltcl 的 elog 命令 转 储 内 核 (lan Harding) 
plpython 使 用 了 atttypmod 的 错误 值 (Brad McLean) 

修复 Python 接口 中 布尔 值 的 不 正确 的 引用 (D'Arcy) 

为 IDBC 添 加 addpataType() 方法 到 PGConnection 接 口 

为 JDBC 修 复 可 更 新 的 结果 集 的 各 种 问题 (Shawn Green) 

为 JDBC 修 复 DatabaseMetaData 的 各 种 问题 (Kris Jurka, Peter Royal) 
修复 JDBC 中 分 析 表 ACLs 的 问题 

JDBC 中 为 字符 集 转 换 问题 提供 更 好 的 错误 信息 


E.203. 版 本 7.3.2 


发 布 日 期 : 2003-02-04 


这 个 版 本 包含 自 版 本 7.3.1 以 来 的 各 种 补丁 。 


E.203.1. 迁移 到 版 本 7.3.2 


运行 7.3.* 版 本 的 用 户 不 需要 转 储 /恢复 。 


E.203.2. 修改 列表 


e 恢复 CREATE TABLE AS / SELECT INTO 中 OID 字 段 的 创建 
。 当 转 储 的 视图 有 注释 时 修复 pg_dump 内 核 转 储 

。 适当 的 转 储 DEFERRABLE/INITIALLY DEFERRED 约 束 

。 当 子 表 字 段 编号 与 父 表 不 同时 辅修 UPDATE 

e 增加 max_fsm_relations 的 缺 省 值 

。 为 单行 查询 修复 游标 中 向 后 抓 取 的 问题 

。 使 SELECT DISTINCT 查 询 上 的 游标 向 后 抓 取 时 正确 的 工作 
。 修复 加 载 包含 contrib/lo 用 法 的 pg_dump 文 件 的 问题 

。 修复 所 有 数字 用 户 名 的 问题 

。 修复 libpgtcl 断 开 连 接 期 间 可 能 的 内 存 洽 出 和 内 核 转 储 

e 使 plpython 的 spi_execute 命 邻 正确 的 义理 null (Andrew Bosma) 
。 调整 plpython 错 误 报告 ， 使 其 回 为 测试 再 次 通过 

。 与 bison 1.875 共 事 

e 在 plpgsql 的 %type 中 正确 的 处 理 大 小 写 混合 的 名 字 (Neil) 

e 当 执行 一 个 由 规则 写 出 的 查询 时 修复 pltcl 中 的 内 核 转 储 

e 修复 数组 下 标 浴 出 (来 自 Yichen Xie 的 报告 ) 


。 在 浮 点 数 情况 下 将 MAX_TIME_PRECISION 从 13 降 低 到 10 


在 per-database 和 per-user 设 置 中 正确 的 包含 变量 名 


当 SELECT into record 不 返回 行 时 修复 plpgsql 的 RETURN NEXT 中 的 内 核 转 储 


修复 python 客 户 端 接口 中 pg_type.typprtlen 的 过 时 的 使 用 
正确 的 处 理 JDBC 了 驱动 中 的 timestamps 中 的 小 数秒 

提升 JDBC 中 getlmportedKeys() 的 性 能 

使 共享 库 符 号 链接 在 HPUX 上 标准 的 工作 (Giles) 

为 timestamp, time, interval 修 复 不 一 致 的 舍 入 行为 

SSL 协 商 修复 (Nathan Mueller) 

当 链 接 PQconnectDB 时 ， 使 libpq 的 ~/.pgpass 特征 工作 
更 新 my2pg, ora2pg 

翻译 更 新 

在 contrib/lo 中 添加 类 型 lo 和 oid 之 间 的 转换 


快速 通道 代码 现在 检查 调用 范 数 的 权限 


E.204. 版 本 7.3.1 


发 布 日 期 : 2002-12-18 


这 个 版 本 包含 自 版 本 7.3 以 来 的 各 种 补丁 。 


E.204.1. 迁移 到 版 本 7.3.1 


运行 7.3. 版 本 的 用 户 不 需要 转 储 /恢复 。 不 过 ， 请 注意 在 这 个 版 本 里 ，PostgreSQL 的 接口 


库 ， 


libpq, 有 了 一 个 新 的 主 版 本 号 ， 在 一 些 情况 下 需要 重新 编译 客户 端 代码 。 


E.204.2. 修改 列表 


当 客 户 端 /服务 器 编码 不 匹配 时 修复 COPY TO 的 内 核 转 储 (Tom) 
允许 pg_dump 在 7.2 之 前 的 服务 器 上 工作 (Philip) 

修复 了 contrib/adddepend(Tom) 

修复 删除 per-userper-database 配 置 设置 的 问题 (Tom) 
4% T contrib/vacuumlo (Tom) 

当 pg_shadow 包 含 MD5 口 令 时 允许 'password' 加 密 (Bruce) 
修复 了 contrib/dbmirror (Steven Singer) 

修复 了 优化 器 (Tom) 

修复 了 contrib/tsearch (Teodor Sigaev, Magnus) 

允许 地 区 名 称 混合 大 小 写 (Nicolai Tufar) 

增加 libpq 库 的 主要 版 本 书 数 (Bruce) 

修复 了 pg_hba.conf 错 误 报 告 (Bruce, Neil) 

添加 了 SCO Openserver 5.0.4 作 为 支持 的 平台 (Bruce) 
阻止 崩溃 服务 器 的 EXPLAIN (Tom) 

修复 了 SSL (Nathan Muellen) 


阻止 通过 ALTER TABLE 创 建 混合 字段 (Tom) 


E.205. 版 本 7.3 


发 布 日 期 : 2002-11-27 


E.205.1. 概述 


主要 的 变化 有 : 
模式 


模式 允许 用 户 在 独立 的 命名 空间 中 创建 对 象 ， 所 以 两 个 人 或 应 用 可 以 有 相同 名 字 的 表 。 还 有 
一 个 为 共享 表 提 供 的 公共 模式 。 表 /索引 的 创建 可 以 通过 在 公共 模式 上 删除 权限 来 限制 。 


删除 字段 
PostgreSQL 现 在 支持 ALTER TABLE ... DROP COLUMN 功能 。 
RBM 


返回 多 个 行 和 /或 多 个 列 的 画 数 比 以 前 更 好 用 了 。 你 可 以 在 sELECT From 子 句 中 调用 这 样 的 一 
RAR", 把 它 的 输出 当做 一 个 表 。 还 有 PL/pgSQL 画 数 现 在 可 以 返回 集合 了 。 


预备 查询 
PostgreSQL 现 在 支持 预备 查询 ， 以 提升 性 能 。 
依赖 追踪 


PostgreSQL 现 在 记录 对 象 依 赖 关 系 ， 人 允许 了 在 许多 方面 的 改进 。 DROP 语句 现在 接 
受 cAscApDE BK RESTRICT 来 控制 是 否 删除 依赖 对 象 。 


权限 

本 数 和 过 程 语 言 现 在 有 权限 了 ， 并 且 男 数 可 以 定义 为 用 它们 的 创建 者 的 权限 运行 。 
国际 化 

现在 总 是 启用 多 字 节 和 本 地 支持 。 


各 种 日 志 选 项 都 增强 了 。 
接口 
大 量 的 接口 已 经 移动 到 了 http://gborg.postgresql.org， 在 这 里 它们 可 以 独立 的 开发 和 发 布 。 


函数 /标识 符 


缺 省 的 ， 男 数 现在 可 以 接受 多 达 32 个 参数 ， 标 识 符 可 以 多 达 63 个 字 节 长 度 。 还 
A, opaque 现在 已 经 废弃 了 : 特定 的 "pseudo-datatypes" 在 画 数 参数 和 结果 类 型 中 表 
示 OPAQUE 之 前 的 含义 。 


E.205.2. 迁移 到 版 本 7.3 


那些 想 要 从 任何 先前 的 版 本 中 迁移 数据 的 需要 使 用 pg_dump 的 转 储 /恢复 。 如 果 你 的 应 用 检索 
系统 表 ， 那 么 需要 做 额外 的 改变 ， 由 于 7.3 中 模式 的 引入 ; 要 获取 更 多 信息 ， 请 参 
阅 http://developer.postgresql.org/~momjian/upgrade tips_7.3。 


观察 下 列 的 不 一 致 性 : 
。 不 再 支持 6.3 之 前 的 客户 端 。 
。 pg_hba.conf 现在 有 一 个 用 户 名 和 额外 特征 的 字段 。 现存 的 文件 需要 调整 。 
e 几 个 postgresql.conf 日 志 参 数 已 经 重 命名 了 。 
e LIMIT 4,4 已 经 禁用 了 ， 请 使 用 LIMIT # OFFSET # o 


e 带 有 字段 列表 的 Insert 语句 必须 为 每 个 声明 的 字段 声明 值 。 例 如 ， 
INSERT INTO tab (col1, col2) VALUES ('val1') 现在 是 非法 的 。 如 果 insert 没有 字段 列 
表 ， 那 么 仍然 允许 提供 少 于 期 望 的 字段 。 


© serial 字段 不 再 自动 UNIQUE ; 因此 ， 不 会 自动 创建 一 个 索引 。 
。 现在 在 退出 的 事务 内 部 的 ser PPAR. 


copy 不 再 认为 丢失 的 后 续 字 上段 为 空 。 需 要 指定 所 有 的 字段 。 (不 过 ， 可 以 通过 
在 copy 命令 中 声明 一 个 字段 列表 达到 相似 的 效果 。) 


s 数据 类 型 timestamp 现在 相当 于 timestamp without time zone , 而 不 


是 timestamp with time zone o 


7.3 之 前 的 数据 库 加 载 到 7.3 将 没有 serial 字段 、 唯 一 约束 和 外 键 的 新 对 象 依赖 性 。 参阅 
目录 contrib/adddepend/ 获取 一 个 详细 的 描述 和 一 个 添加 这 样 的 依赖 性 的 脚本 。 


不 再 允许 空 字符 串 ( '' ) 作 为 整数 字段 的 输入 。 原 先 ， 它 被 隐 式 的 解释 为 0。 


E.205.3. 修改 列表 
E.205.3.1. 服务 器 操作 


。 添加 pg_locks 视 图 以 显示 锁 (Neil) 


。 为 密码 协商 内 存 分 配 修复 安全 性 (Neil) 
。 删除 对 版 本 0 FE/BE 协议 的 支持 (PostgreSQL 6.2 和 之 前 的 版 本 ) (Tom) 
。 为 超级 用 户 保留 最 后 几 个 后 端 槽 位 ， 参 数 superuser_reserved_connections 控 制 这 个 


(Nigel J. Andrews) 


.205.3.2. 性 能 


m 


。 通过 一 次 调用 localtime() 改 善 开 始 菜单 (Tom) 

。 为 快速 启动 在 平面 文件 中 缓存 系统 目录 信息 (Tom) 

。 改善 索引 信息 的 缓存 (Tom) 

。 优化 器 改善 (Tom, Fernando Nasser) 

。 目录 缓存 现在 存储 查找 失败 (Tom) 

。 改善 哈 希 郴 数 (Neil) 

。 提高 查询 标记 和 网 络 处 理 的 性 能 (Peten) 

。 为 大 对 象 存储 提高 速度 (Mario Weilguni) 

。 在 第 一 次 查询 时 标记 过 期 的 索引 项 ， 节 省 稍 后 的 heap 抓 取 (Tom) 
。 避免 过 多 的 NULL 位 图 填充 (Manfred Koizar) 

。 为 Solaris 提 升 性 能 添加 BSD 监 听 的 qsort() (Bruce) 

。 通过 4 个 字 节 减少 每 行 开 销 (Manfred Koizar) 

。 修复 GEQO 优 化 器 bug(Neil Conway) 

e {WITHOUT OID 实 际 上 保存 每 行 4 个 字 节 (Manfred Koizar) 

e 添加 default_statistics_target 变 量 以 声明 ANALYZE buckets (Neil) 
。 使 用 本 地 缓冲 区 缓存 临时 表 ， 这 样 没 有 WAL 开 销 (Tom) 

。 在 大 表 上 提升 免费 空间 映射 性 能 (Stephen Marshall, Tom) 

。 提升 了 WAL 写 的 并 发 性 (Tom) 


E.205.3.3. 权限 


。 在 函数 和 过 程 语 言 上 添加 权限 (Peten) 


添加 OWNER 到 CREATE DATABASE， 这 样 超 级 用 户 可 以 代表 非特 权 用 户 创建 数据 库 
(Gavin Sherry, Tom) 


添加 新 对 象 权 限 位 EXECUTE 和 USAGE (Tom) 


添加 SET SESSION AUTHORIZATION DEFAULT 和 RESET SESSION 
AUTHORIZATION (Tom) 


人 允许 用 男 数 所 有 者 的 权限 执行 画 数 (Peten) 


E.205.3.4. ik #48 


现在 服务 器 日 志 信 息 标 记 为 LOG， 不 是 DEBUG (Bruce) 

添加 用 户 字段 到 pg_hba.conf (Bruce) 

log_connections 在 日 志文 件 中 输出 两 行 信息 (Tom) 

从 postgresql.conf 中 移 除 debug_level， 现 在 是 server_min_messages (Bruce) 
为 每 用 户 /数据 库 初 始 化 新 建 ALTER DATABASE/USER .SET 命令 (Peten) 


新 参数 server_min_messages 和 client_min_messages 控 制 哪 条 信息 发 送 给 服务 器 日 志 
和 客户 端 应 用 (Bruce) 


允许 pg_hba.conf 声 明 喜 号 隔 开 的 用 户 / 数 据 库 列表 ， 前 置 + 的 分 组 名 和 前 置 @ 的 文件 名 


(Bruce) 

移 除 二 次 密码 文件 功能 和 pg_password 工 具 (Bruce) 

为 数据 库 本 地 用 户 名 添加 变量 db_user_namespace (Bruce) 
改善 SSL (Bear Giles) 

使 默认 的 存储 密码 加 密 (Bruce) 

人 允许 pg_statistics 通 过 调用 pg_stat_reset() 重 置 (Christopher) 
添加 log_duration 参数 (Bruce) 

将 debug_print_query 重 命名 为 log_statement (Bruce) 

将 show_query_stats 重 命 名 为 show_statement_stats (Bruce) 


添加 了 参数 log_min_error_statement 到 错误 时 输出 到 日 志 的 命令 (Gavin) 


E.205.3.5. 查询 


使 游标 不 敏感 ， 意 味 着 不 改变 它们 的 内 容 (Tom) 


。 禁用 LIMIT ## 语法 ; 现在 只 支持 LIMIT # OFFSET # (Bruce) 

e 增加 标识 符 长 度 为 63(Neil, Bruce) 

。 UNION 修 复 了 合并 不 同 长 度 的 >= 3 字段 (Tom) 

。 添加 DEFAULT 关 键 字 到 INSERT, e.g., INSERT ... (..., DEFAULT, ...) (Rod) 
。 通过 使 用 ALTER COLUMN ... SET DEFAULT 人 允许 视图 有 缺 省 值 (Neil) 


。 未 能 INSERT 没 有 提供 所 有 字段 值 的 字段 列表 ， 如 : INSERT INTO tab (col1, col2) 
VALUES (val1); (Rod) 


。 修复 join 别名 (Tom) 

。 修复 了 FULL OUTER JOINs (Tom) 

。 改善 无 效 标识 符 和 位 置 的 报告 (Tom, Gavin) 

。 修复 OPEN cursor(args) (Tom) 

© 人 允许 'ctid' 在 视图 和 currtid(viewname) 中 使 用 (Hiroshi) 
。 修复 CREATE TABLE AS with UNION (Tom) 

e SQL99 语 法 改善 (Thomas) 

e 添加 statement timeout 变 量 到 取消 查询 (Bruce) 

e 人 允许 预备 查询 PREPARE/EXECUTE (Neil) 

e 人 允许 FOR UPDATE 出 现在 LIMIT/OFFSET 后 面 (Bruce) 


。 添加 变量 自动 提交 (Tom, David Van Wie) 


E.205.3.6. 对 象 操作 


。 在 CREATE DATABASE 中 使 等 号 可 选 (Gavin Sherry) 
e 使 ALTER TABLE OWNER 也 改变 索引 的 所 有 者 (Neil) 


e 新 的 ALTER TABLE tabname ALTER COLUMN colname SET STORAGE controls 
TOAST storage, 4. #%(John Gray) 


e 添加 模式 支持 ， CREATE/DROP SCHEMA (Tom) 
。 为 临时 表 创 建 模式 (Tom) 
。 为 模式 搜索 添加 变量 search_path (Tom) 


e 添加 了 ALTER TABLE SET/DROP NOT NULL (Christopher) 


e 新 建 CREATE FUNCTION 波 动 水 平 (Tom) 

。 使 规则 名 只 在 每 个 表 中 唯一 (Tom) 

e 添加 'ON tablename' 子 句 到 DROP RULE 和 COMMENT ON RULE (Tom) 
。 添加 ALTER TRIGGER RENAME (Joe) 

e 新 加 current_schema() 和 current_schemas() 查 询 功 能 (Tom) 

。 人 允许 图 数 返回 多 行 ( 表 画 数 ) (Joe) 

e 为 了 一 致 性 ， 使 WITH 在 CREATE DATABASE 中 可 选 (Bruce) 

。 添加 对 象 依 赖 追踪 (Rod, Tom) 

e 添加 RESTRICT/CASCADE 到 DROP 命 令 (Rod) 

。 为 非 检 查 约束 添加 ALTER TABLE DROP (Rod) 

。 自动 破坏 带 有 SERIAL 的 表 的 DROP 时 顺序 (Rod) 

© 如 果 字 上 段 被 外 键 使 用 那么 阻止 删除 该 字段 (Rod) 

。 当 删 除了 对 象 时 ， 自 动 删 除 约束 / 辑 数 (Rod) 

。 添加 了 CREATE/DROP OPERATOR CLASS (Bill Studenmund, Tom) 
e 添加 了 ALTER TABLE DROP COLUMN (Christopher, Tom, Hiroshi) 
。 阻止 继承 的 字段 被 删除 或 重 命名 (Alvaro Herrera) 

。 修复 外 键 约束 在 中 间 的 数据 状态 时 没有 错误 (Stephan) 

。 传播 列 或 表 重 命名 为 外 键 约束 

。 添加 CREATE OR REPLACE VIEW (Gavin, Neil, Tom) 

e 添加 CREATE OR REPLACE RULE (Gavin, Neil, Tom) 

。 使 规则 按照 字母 顺序 执行 ， 返 回 更 可 预见 的 值 (Tom) 

。 触发 器 现在 按照 字母 顺序 触发 (Tom) 

e 添加 /contrib/adddepend 以 处 理 7.3 之 前 的 对 象 依赖 (Rod) 


e 当 插 入 /更 新 值 时 人 允许 更 好 的 转换 (Tom) 


E.205.3.7. Aaa 


e COPY TOREA, 8147 A\r 和 \n (Tom) 


允许 COPY FROM 中 的 DELIMITER 是 8 位 的 (Tatsuo) 


为 了 性 能 ， 使 pg_dump 使 用 ALTER TABLE ADD PRIMARY KEY (Neil) 


在 多 重 语句 规则 中 禁用 括号 (Bruce) 

禁止 在 一 个 函数 内 部 调用 VACUUM (Bruce) 

允许 dropdb 和 其 他 脚本 使 用 带 有 空格 的 标识 符 (Bruce) 

限制 数据 库 注 释 更 改 为 当前 数据 库 

允许 在 操作 符 上 注释 ， 不 依赖 于 潜在 的 函数 (Rod) 

在 退出 的 事务 中 回 滚 SET 命令 (Tom) 

EXPLAIN 现 在 作为 查询 输出 (Tom) 

显示 条 件 查 询 和 EXPLAIN 中 排序 键 (Tom) 

为 单个 事务 添加 'SET LOCAL var = value' 以 设置 配置 变量 (Tom) 
人 允许 ANALYZE 运 行 在 一 个 事务 中 (Bruce) 

用 新 的 WITH 子 句 改善 COPY 语 法 ， 保 持 向 后 兼容 性 (Bruce) 
修复 pg_dump 在 非 ASCII 转 储 中 一 致 的 输出 标签 (Bruce) 

使 外 键 约束 在 转 储 文件 中 更 清晰 (Rod) 

添加 COMMENT ON CONSTRAINT (Rod) 

人 允许 COPY TO/FROM 声 明 字 段 名 (Brent Verner) 

将 UNIQUE 和 PRIMARY KEY 24 RF 4 ALTER TABLE 转 储 (Rod) 
SHOW 输出 一 个 查询 结果 (Joe) 

生成 错误 在 短 的 COPY 行 上 而 不 是 在 填充 的 NULL 上 (Neil) 
修复 CLUSTER 保留 所 有 的 表 属 性 (Alvaro Herrera) 

新 建 pg_settings 表 以 查看 /修改 GUC 设 置 (Joe) 

添加 智能 引用 ， 可 移植 性 提升 至 pg_dump 输 出 (Peter) 

作为 SERIAL 转 储 出 序列 字段 (Tom) 

启用 大 文件 支持 ，pg_dump >2G (Peter, Philip Warner, Bruce) 
禁止 在 包含 在 参考 约束 中 的 表 上 TRUNCATE (Rod) 


使 TRUNCATE 也 自动 截断 关系 的 toast 表 (Tom) 


e 添加 clusterdb 实 用 将 自动 集群 基于 先前 CLUSTER 操作 的 全 部 数据 库 (Alvaro Herrera) 
。 彻底 检查 pg_dumpall (Peter) 

。 人 允许 对 TOAST 表 进行 REINDEX (Tom) 

。 应 用 START TRANSACTION， 每 个 SQL99 (Neil) 

© 当 页 分 裂 影响 容量 删除 时 修复 罕见 的 索引 损坏 (Tom) 


。 为 继承 修复 ALTER TABLE ... ADD COLUMN(Alvaro Herrera) 


E.205.3.8. sie x 2B 
e 修复 factorial(0) 返 回 1 (Bruce) 
。 改善 Date/time/timezone (Thomas) 
。 修复 数组 切片 提取 (Tom) 
。 修复 extract/date_part 为 时 间 惟 报告 适当 的 微 秒 (Tatsuo) 
e 人 允许 text_substr() 和 bytea_substr() 更 有 效 的 读 取 TOAST 值 (John Gray) 
。 添加 域 支持 (Rod) 
。 (WITHOUT TIME ZONE 为 TIMESTAMP 和 TIME 数 据 类 型 的 缺 省 (Thomas) 


。 在 配置 中 使 用 --enable-integer-datetimes 人 允许 64 位 整数 交替 日 期 /时 间 类 型 存储 模式 
(Thomas) 


e 使 timezone(timestamptz) 返 回 时 间 戳 而 不 是 一 个 字符 串 (Thomas) 

e 时 间 的 日 期 /时 间 类 型 中 允许 小 数秒 在 1BC 之 前 (Thomas) 

o 限制 时 间 稚 数据 类 型 精度 为 6 个 小 数位 (Thomas) 

。 更 改 时 区 转换 加 数 timetz() 为 timezone() (Thomas) 

。 添加 配置 变量 数据 类 型 和 时 区 (Tom) 

e 添加 OVERLAY()， 人 允许 替换 字符 串 的 子 串 (Thomas) 

e 添加 SIMILAR TO (Thomas, Tom) 

。 添加 正规 表达 式 SUBSTRING(string FROM pat FOR escape) (Thomas) 
e 添加 LOCALTIME 和 LOCALTIMESTAMP exj2X (Thomas) 


。 使 用 CREATE TYPE typename AS (column) 添 加 命名 的 复合 类 型 (Joe) 


。 人 允许 在 表 别 名 子 句 中 定义 复合 类 型 (Joe) 

。 添加 新 的 API| 以 简化 C 语 言 表 函 数 的 创建 (Joe) 

e 从 对 SQL99 画 数 的 调用 中 删除 ODBC 兼 容 的 空 括号 ， 因 为 这 些 括 号 不 匹配 标准 (Thomas) 
。 人 允许 macaddr 数 据 类 型 接受 12 个 带 有 分 隔 符 的 十 六 进 制 数 字 (Mike Wyer) 
。 添加 CREATE/DROP CAST (Peter) 

。 添加 IS DISTINCT FROM 操作 (Thomas) 

e 添加 SQL99 TREAT() 范 数 ，CAST() 的 同义词 (Thomas) 
e 添加 pg_backend_pid() 输 出 后 端 pid (Bruce) 

e 添加 IS OF / IS NOT OF 类 型 谓词 (Thomas) 

。 人 允许 位 字符 串 常量 不 是 完全 指定 的 长 度 (Thomas) 

。 人 允许 在 8 字 节 整数 和 位 字符 串 之 间 转 换 (Thomas) 

© 实现 十 六 进 制 文字 转换 为 位 字符 串 文字 (Thomas) 

。 iH RBM EF REFROMF A (Joe) 

。 增加 本 数 参数 的 最 大 数量 为 32 (Bruce) 

。 不 再 为 SERIAL 字 段 自动 创建 索引 (Tom) 

e 添加 current_database() (Rod) 

。 修复 cash_words() 不 渝 出 缓存 (Tom) 

e 添加 玉 数 replace(), split_part(), to_hex() (Joe) 

。 为 bytea 修 复 LIKE 为 右 参 数 (Joe) 

e 阻止 SELECT cash_out(2)-§ 2A HA z (Tom) 

e 修复 to_char(1,'FM999.99') 返 回 一 个 时 期 (Karel) 


。 修复 返回 OPAQUE 的 触发 器 /类 型 /语言 本 数 返回 合适 的 类 型 (Tom) 


E.205.3.9. 国际 化 


e 添加 额外 的 编码 : Korean (JOHAB), Thai (WIN874), Vietnamese (TCVN), Arabic 
(WIN1256), Simplified Chinese (GBK), Korean (UHC) (Eiji Tokuya) 


。 缺 省 启用 本 地 支持 (Peter) 


在 PQescapeBytea/PQunescapeBytea 中 为 多 字 节 逃逸 byes >= 0x7f (Tatsuo) 
添加 语言 环境 意识 到 规则 表达 式 字符 类 

缺 省 启用 多 字 节 支持 (Tatsuo) 

添加 GB18030 多 字 节 支持 (Bil Huang) 

添加 CREATE/DROP CONVERSION， 人 允许 可 加 载 的 编码 (Tatsuo, Kaori) 
添加 pg_conversion 表 (Tatsuo) 

添加 SQL99 CONVERT ()EN2X(Tatsuo) 

pg_dumpall, pg_controldata, 和 pg_resetxlog 现 在 国家 语言 意识 (Peten) 


新 的 和 更 新 的 翻译 


E.205.3.10. 服务 右 端 语言 


TtiF Ja WSQLE (Peter) 

更 改 PL/Tcl 构 造 以 使 用 配置 的 编译 器 和 Makefile.shlib (Peter) 
彻底 检查 PL/pgSQL FOUND 变量 ， 使 其 更 加 Oracle 兼 容 (Neil, Tom) 
人 允许 PL/pgSQL 处 理 引 用 的 标识 符 (Tom) 

允许 设置 返回 PL/pgSQL 郴 数 (Neil) 

使 PL/pgSQL 意 识 到 模式 (Joe) 


删除 一 些 内 存 浴 出 (Nigel J. Andrews, Tom) 


E.205.3.11. psql 


为 了 与 7.2.0 兼 容 ， 不 要 小 写 psql \connect 数 据 库 名 (Tom) 
添加 psql \timing 到 用 户 查 询 时 间 (Greg Sabino Mullane) 
使 psql \d 7585/13 (Greg Sabino Mullane) 

新 建 psql xdD 显 示 域 (Jonathan Eisler) 

人 允许 psql 在 视图 上 显示 规则 (Paul ?) 

修复 psql 变 量 蔡 换 (Tom) 


允许 psql \d 显 示 临 时 表 结 构 (Tom) 


。 人 允许 psql \d 显 示 外 键 (Rod) 
。 修复 \? 以 纪念 \pset pager (Bruce) 
。 使 psql 在 启动 时 报告 它 的 版 本 号 (Tom) 


。 人 允许 \copy 指 定 字段 名 (Tom) 


E.205.3.12. libpq 


。 添加 ~/.pgpass 存 储 主机 /用 户 密码 组 合 (Alvaro Herrera) 

。 YsdPQunescapeBytea()E BZ Ilippq (Patrick Welche) 

。 修复 在 非 阻 塞 连接 上 发 送 大 查询 (Bernhard Herzog) 

。 修复 libpq 在 Win9X 上 使 用 定时 器 (David Ford) 

。 人 允许 libpq 通 知 用 不 同 长 度 的 标识 符 处 理 服 务 器 (Tom) 

e 添加 libpq PQescapeString() 和 PQescapeBytea() 到 Windows (Bruce) 
。 用 非 阻塞 连接 修复 SSL (Jack Bates) 


。 添加 libpq 连 接 超 时 参数 (Denis A Ustimenko) 


E.205.3.13. JDBC 


e 人 允许 JDBC 用 JDK 1.4 编 译 (Dave) 

。 添加 JDBC 3 支持 (Barry) 

。 人 允许 JDBC 通 过 添加 ?loglevel=X 到 连接 的 URL 来 设置 日 志 级 别 (Barry) 
e 添加 Driver.info() 信 息 ， 输 出 版 本 号 (Barry) 

。 添加 可 更 新 的 结果 集 (Raghu Nidagal, Dave) 

。 添加 对 可 调用 语句 的 支持 (Paul Bethe) 

。 添加 查询 取消 能 

。 添加 立即 刷新 (Dave) 

。 修复 MD5 加 密 处 理 多 字 节 服务 器 (Jun Kawai) 


。 添加 对 预备 语句 的 支持 (Barry) 


E.205.3.14. 各 种 接口 


。 修复 ECPG bug， 关 于 单 引 号 中 的 八进制 数字 (Michael) 

e 引 动 src/interfaces/libpgeasy 到 http:/gborg.postgresdl.org (Marc, Bruce) 
e 改善 Python 接口 (Elliot Lee, Andrew Johnson, Greg Copeland) 

e 添加 libpgtcl 连 接 关 闭 事件 (Gerhard Hintermayer) 

e 移动 src/interfaces/libpq++ 到 http://gborg.postgresql.org (Marc, Bruce) 

e 移动 src/interfaces/odbc 到 http://gborg.postgresql.org (Marc) 

。 移动 src/interfaces/libpgeasy 到 http://gborg.postgresql.org (Marc, Bruce) 
e 移动 src/interfaces/perl5 到 http://gborg.postgresql.org (Marc, Bruce) 

。 从 主干 上 删除 src/bin/pgaccess， 现 在 在 http:Wwww.pgaccess.org (Bruce) 


e 添加 pg_on_connection_ loss 命 令 到 libpgtcl (Gerhard Hintermayer, Tom) 


E.205.3.15. 源码 
。 修复 并 行进 行 (Peten) 
。 AIX 修 复 了 连接 Tcl (Andreas Zeugswetter) 
© 人 允许 PL/Perl 在 Cygwin 下 建立 (Jason Tishler) 
。 改善 MIPS 编 译 (Peter, Oliver Elphick) 
。 需要 Autoconf 版 本 2.53 (Peter) 
。 需要 在 配置 中 缺 省 有 readline 和 zlib (Peter) 


。 为 了 性 能 ， 人 允许 Solaris 使 用 Intimate Shared Memory (ISM) (Scott Brunza, P.J. Josh 
Rovero) 


。 在 编译 时 总 是 启用 系统 日 志 ， 删 除 --enable-syslog 选 项 (Tatsuo) 
。 在 编译 时 总 是 启用 多 字 节 ， 删 除 --enable-multibyte 选 项 (Tatsuo) 
。 在 编译 时 总 是 启用 区 域 设置 ， 删 除 --enable-locale 选 项 (Peter) 

。 修复 Win9x DLL 创 建 (Magnus Naeslund) 

。 通过 WAL 代 码 在 Windows、BeOS 上 修复 link() (Jason Tishler) 
e 添加 sys/types.h 到 c.h， 并 从 主 文件 中 删除 (Peter Bruce) 


。 修复 AIX 挂 在 SMP 机 器 上 (Tomoyuki Niijima) 


AIX SMP 挂 修复 (Tomoyuki Niijima) 

修复 1970 以 前 的 日 期 在 新 的 glibc 库 上 处理 (Tom) 
修复 PowerPC SMP 锁 定 (Tom) 

阻止 使 用 gcc -ffast-math (Peter, Tom) 

Bison >= 1.50 现 在 需要 开发 者 建立 

Kerberos 5 支持 现在 创建 时 带 有 Heimdal (Peter) 
在 列 出 SQL 特性 的 用 户 手 册 中 添加 附录 (Thomas) 
改善 可 加 载 的 模块 连接 到 使 用 RTLD_NOW (Tom) 
新 的 错误 级 别 WARNING, INFO, LOG, DEBUG[1-5] (Bruce) 
新 建 src/port 目 录 保 存 蔡 换 的 libc 画 数 (Peter, Bruce) 
为 模式 新 建 png_namespace 系 统 目录 (Tom) 

为 模式 添加 pg_class.relnamespace(Tom) 

为 模式 添加 pg_type.typnamespace (Tom) 

为 模式 添加 pg_proc.pronamespace (Tom) 


调整 聚合 有 pg_proc 条 目 (Tom) 


系统 关系 现在 有 了 它们 自己 的 命名 空间 ， 不 再 需要 pg_* test (Fernando Nasser) 


重 命名 TOAST 索 引 为 _index 而 不 是 _idx (Neil) 
为 操作 符 、 操 作 符 类 添加 命名 空间 (Tom) 
添加 额外 的 检查 到 服务 器 控制 文件 (Thomas) 
新 增 Polish FAQ (Marcin Mazurek) 

添加 Posix 信 号 灯 支 持 (Tom) 

文档 需要 重建 索引 (Bruce) 


命名 一 些 内 部 的 标识 符 以 简化 Windows 编 译 (Jan, Katherine Ward) 


添加 计算 磁盘 空间 的 文件 (Bruce) 

从 GUC 中 删除 KSQO(Bruce) 

修复 rtree 中 的 内 存 浴 出 (Kenneth Been) 
为 一 致 性 修复 一 些 错误 消息 (Bruce) 


。 删除 未 使 用 的 系统 表 字 段 (Peter) 

。 在 适当 的 地 方 使 系统 字段 为 NOT NULL (Tom) 

。 为 了 支持 snprintf() 清 除 snprintf 的 使 用 (Neil, Jukka Holappa) 
。 删除 OPAQUE 创 建 特定 的 子 类 型 (Tom) 

。 在 数组 内 部 处 理 清理 (Joe, Tom) 

e 不 人 允许 pg_atoi(") (Bruce) 

。 删除 参数 wal_files 因 为 WAL 文 件 现在 回收 利用 了 (Bruce) 


。 添加 版 本 号 到 heap 页 (Tom) 


E.205.3.16. 贡献 包 


/contrib/array 中 人 允许 inet 数 组 (Neil) 


e GiST 修复 (Teodor Sigaev Neil) 


升级 /contrib/mysq| 


添加 /contrib/dbsize， 它 显示 了 没有 vacuum 的 表 大 小 (Peter) 


添加 /contrib/intagg， 整 数 聚 合 器 例 程 (mlw) 


改善 /contrib/oid2name (Neil, Bruce) 


改善 /contrib/tsearch (Oleg, Teodor Sigaev) 


清理 /contrib/rserver (Alexey V. Borzov) 


更 新 /contrib/oracle 转 换 实 用 程序 (Gilles Darold) 


更 新 /contrib/dblink (Joe) 


改善 /contrib/vacuumlo 支 持 的 选项 (Mario Weilguni) 


改善 /contrib/intarray (Oleg, Teodor Sigaev, Andrey Oktyabrski) 


添加 /contrib/reindexdb 实 用 程序 (Shaun Thomas) 


添加 索引 到 /contrib/isbn_issn (Dan Weston) 


添加 /contrib/dbmirror (Steven Singer) 


改善 /contrib/pgbench (Neil) 


添加 /contrib/tablefunc 表 男 数 示例 (Joe) 


为 树 形 结构 添加 /contrib/ltree 数 据 类 型 (Teodor Sigaev, Oleg Bartunov) 
移动 /contrib/pg_controldata, pg_resetxlog 到 主 树 里 (Bruce) 
修复 /contrib/cube (Bruno Wolff) 


改善 /contrib/fulltextindex (Christopher) 


E.206. 版 本 7.2.8 


发 布 日 期 : 2005-05-09 


这 个 版 本 包含 自 7.2.7 以 来 的 各 种 补丁 ， 包 括 一 个 安全 相关 的 问题 。 


E.206.1. 迁移 到 版 本 7.2.8 


运行 7.2.X 的 用 户 不 需要 转 储 /恢复 。 


E.206.2. 修改 列表 


修复 过 时 的 竞 态 条 件 ， 该 条 件 允 许 一 个 事务 因为 某 些 目的 被 视 作 已 提交 (如 SELECT FOR 
UPDATE) 


这 是 一 个 非常 严重 的 bug， 因 为 它 会 导致 表面 上 数据 的 不 一 致 被 应 用 短暂 的 看 到 。 
修复 关系 扩展 和 VACUUM 之 间 的 竞 态 条 件 。 


理论 上 这 可 能 导致 丢失 新 插入 的 一 页 数据 ， 尽 管 该 情况 看 起 来 概率 很 低 。 没有 导致 多 于 
一 个 维护 失败 的 已 知情 况 。 


为 TIME WITH TIME ZONE 值 修复 EXTRACT(EPOCH) 

在 plpgsql 中 额外 的 缓存 浴 出 检查 (Neil) 

修复 pg_dump 以 正确 的 转 储 包含 % 的 索引 名 和 触发 器 名 
阻止 to_char(interval) 转 储 月 份 相关 格式 的 内 核 


为 更 新 的 OpenSSL 构 建 修复 contrib/pgcrypto (Marko Kreen) 


E.207. 版 本 7.2.7 


发 布 日 期 : 2005-01-31 


这 个 版 本 包含 自 7.2.6 以 来 的 各 种 补丁 ， 包 括 几 个 安全 相关 的 问题 。 


E.207.1. 迁移 到 版 本 7.2.7 


运行 7.2.X 的 用 户 不 需要 转 储 /恢复 。 


E.207.2. 修改 列表 


© 不 允许 非 超 级 用 户 LoAD 


在 平台 上 会 自动 执行 共享 库 的 初始 化 函数 (至少 包 括 Windows 和 ELF-based Unixen) , 
LOAD 可 以 用 来 使 服务 器 执行 任意 的 代码 。 感 谢 NGS Software 报 告 这 个 问题 。 


。 添加 需要 的 STRICT 标 记 到 一 些 贡 献 包 功能 (Kris Jurka) 
e 当 plpgsql 的 游标 声明 有 太 多 的 参数 时 避免 缓冲 区 浴 出 (Neil) 
。 修复 全 外 连接 和 右 外 连接 的 规划 错误 


连接 的 结果 错误 的 与 左 输入 有 相同 的 排序 。 这 不 只 是 发 送 错误 排序 的 输出 给 用 户 ， 还 在 
岩 套 的 合并 连接 的 情况 下 给 出 完全 错误 的 回复 。 


e 修复 SQL 和 GERMAN 数 据 类 型 中 负数 间隔 的 显示 


E.208. 版 本 7.2.6 


发 布 日 期 : 2004-10-22 


这 个 版 本 包含 各 种 自 7.2.5 以 来 的 修复 。 


E.208.1. 迁移 到 版 本 7.2.6 


运行 7.2.X 版 本 的 用 户 不 需要 转 储 /恢复 。 


E.208.2. 修改 列表 


。 修复 可 能 未 能 更 新 到 磁盘 上 的 错误 


在 极 少数 情况 下 ， 这 个 疏忽 可 能 会 导致 "不 能 访问 事务 状态 "错误 ， 这 是 一 个 潜在 的 数据 
丢失 bug。 


。 确保 散 列 的 外 连接 不 丢失 元 组 


使 用 哈 希 连接 规划 的 非常 大 的 左 连接 可 能 没有 输出 不 匹配 的 左 侧 行 ， 只 给 出 右 侧 数 据 分 
布 。 


© 不 人 允许 作为 root 运 行 pg_ct| 
这 是 为 了 防范 任何 可 能 的 安全 问题 。 
。 避免 在 /tmp 中 的 make_oidjoins_check 中 使 用 临时 文件 


这 已 经 作为 一 个 安全 问题 上 报 ， 尽 管 它 几乎 不 值得 关心 ， 因 为 非 开 发 者 任何 情况 下 都 没 
有 理由 使 用 这 个 脚本 。 


。 更 新 到 更 新 的 Bison 版 本 


E.209. 版 本 7.2.5 


发 布 日 期 : 2004-08-16 


这 个 版 本 包含 自 7.2.4 以 来 的 各 种 修复 。 


E.209.1. 迁移 到 版 本 7.2.5 


运行 7.2.X 的 用 户 不 需要 转 储 /恢复 。 


E.209.2. 修改 列表 


e 阻止 崩溃 期 间 可 能 的 已 提交 事务 的 丢失。 


由 于 事务 提交 和 检查 点 之 间 连 锁 不 足 ， 正 好 在 最 近 的 检查 点 之 前 提交 的 事务 可 能 会 
K, 全 部 丢失 或 部 分 丢失 ， 紧 跟着 数据 库 骨 省 并 重启 。 这 是 一 个 严重 的 bug， A 
PostgreSQL 7.1 就 已 经 存在 了 。 


。 修复 btree 搜 索 和 第 一 个 root 页 面 分 裂 并 行 的 极端 情况 

。 修复 to_ascii 里 的 缓冲 区 浴 出 (Guido Notari) 

。 修复 机 器 上 无 符号 字符 的 死 锁 检 测 里 的 内 核 转 储 

。 修复 运行 Async_NotifyHandler 之 后 未 能 响应 pg_ctl stop -m fast 
。 修复 pg_dump 中 的 内 存 泄露 


e 避免 与 isblank() 加 数 或 宏 的 系统 定义 冲突 


E.210. 版 本 7.2.4 


发 布 日 期 : 2003-01-30 


这 个 版 本 包含 各 种 自 7.2.3 以 来 的 修复 ， 包 括 阻止 可 能 的 数据 丢失 的 修复 。 


E.210.1. 迁移 到 版 本 7.2.4 


运行 7.2.* 版 本 的 用 户 不 需要 转 储 /恢复 。 


E.210.2. 修改 列表 


。 修复 一 些 VACUUM "No one parent tuple was found" 错 误 的 额外 情况 
e 阻止 VACUUM 在 一 个 函数 内 部 调用 (Bruce) 

。 确保 pg_clog 更 新 在 标记 检查 点 完成 之 前 同步 到 磁 瘟 

。 避免 在 大 的 哈 希 连接 期 间 整 数 浴 出 

e 当 pg_group.grolist 足 够 大 时 使 GROUP 命令 工作 

。 修复 日 期 时 间 表 中 的 错误 ; 一 些 时 区 名 称 不 被 认可 

e 修复 circle_poly(), path_encode(), path_add() 中 的 整数 浴 出 (Neil) 


。 修复 lseg_eq(), lseg_ne(), lseg_center() 中 长 期 存在 的 逻辑 错误 


E.211. 版 本 7.2.3 


发 布 日 期 : 2002-10-01 


这 个 版 本 包含 各 种 自 版 本 7.2.2 以 来 的 修复 ， 包 括 阻 止 可 能 的 数据 丢失 的 修复 。 
E.211.1. 迁移 到 版 本 7.2.3 


运行 7.2.* 版 本 的 用 户 不 需要 转 储 /恢复 。 


E.211.2. 修改 列表 


e 阻止 可 能 的 压缩 事务 日 志 的 丢失 (Tom) 


阻止 非 超 级 用 户 增加 最 近 的 vacuum 信 息 (Tom) 


在 最 新 版 本 的 glibc 中 人 处理 1970 以 前 的 数据 值 (Tom) 
。 修复 服务 器 关闭 期 间 可 能 的 中 止 
。 阻止 自 旋 锁 在 SMP PPC 机 器 上 不 挂 断 (Tomoyuki Niijima) 


。 修复 pg_dump 以 适当 的 转 储 FULL JOIN USING (Tom) 


E.212. 版 本 7.2.2 


发 布 日 期 : 2002-08-23 


这 个 版 本 包含 各 种 自 版 本 7.2.1 以 来 的 修复 。 


E.212.1. 迁移 到 版 本 7.2.2 


运行 7.2.* 版 本 的 用 户 不 需要 转 储 /恢复 。 


E.212.2. 修改 列表 


。 人 允许 在 PL/pgSQL 中 执行 "CREATE TABLE AS ... SELECT" (Tom) 

。 修复 压缩 事务 日 志 id 概 括 (Tom) 

。 修复 PQescapeBytea/PQunescapeBytea 以 便 它们 处 理 字 节 > 0x7f (Tatsuo) 
。 修复 被 不 存在 的 长 选项 调用 时 的 psql 和 pg_dump 骨 溃 (Tatsuo) 

。 修复 调用 几何 运算 符 时 的 死机 (Tom) 

© 人 允许 OPEN 游 标 (参数 ) (Tom) 

。 (8rtree_gist#5| {217 (Teodor) 

。 修复 转 储 用 户 定义 的 聚集 (Tom) 

。 修复 contrib/intarray (Oleg) 

。 修复 使 用 圆 括号 的 复杂 的 UNION/EXCEPT/INTERSECT 查 询 (Tom) 
。 修复 pg_convert (Tatsuo) 

。 修复 长 DATA 字 符 串 的 崩溃 (Thomas, Neil) 


e 修复 repeat(), lpad(), rpad() 和 长 字符 串 (Neil) 


E.213. 版 本 7.2.1 


发 布 日 期 : 2002-03-21 


这 个 版 本 包含 对 版 本 7.2 的 各 种 修复 。 


E.213.1. 迁移 到 版 本 7.2.1 


运行 版 本 7.2 的 用 户 不 需要 转 储 /恢复 。 


E.213.2. 修改 列表 


确保 序列 计数 器 在 崩溃 后 不 要 倒退 (Tom) 

修复 pgaccess kanji-conversion 关 键 字 捆绑 (Tatsuo) 
改善 优化 器 (Tom) 

改善 Cash I/O (Tom) 

新 的 俄罗斯 常见 问题 解答 

编译 修复 丢失 AuthBlockSig (Heiko) 

增加 时 区 和 时 区 修复 (Thomas) 

人 允许 psql \connect 处 理 混合 情况 的 数据 库 和 用 户 名 (Tom) 
在 命令 结 束 时 返回 适当 的 OID， 即 使 是 ON INSERT 规 则 也 一 样 (Tom) 
COPY FROM 使 用 8 位 的 DELIMITERS (Tatsuo) 

为 毫秒 / 微 秒 修复 extract/date_part 里 的 bug (Tatsuo) 

改善 不 同 长 度 的 多 重 UNION 的 处 理 (Tom) 

改善 contrib/btree_gist (Teodor Sigaev) 


改善 contrib/tsearch 字 典 ， 参 阅 README.tsearch 获 取 附 加 的 安装 步骤 (Thomas T. Thai, 
Teodor Sigaev) 


修复 数组 下 标的 处 理 (Tom) 


人 允许 在 PL/pgSQL 中 执行 "CREATE TABLE AS ... SELECT" (Tom) 


F.214. 版 本 7.2 


发 布 日 期 : 2002-02-04 


E.214.1. 概述 


这 个 版 本 改善 了 PostgreSQL 在 高 负荷 环境 下 的 能 力 。 
这 个 版 本 里 的 主要 变化 : 
VACUUM 


Vacuum 不 再 锁 住 表 ， 因 此 就 允许 普通 用 户 在 vacuum 的 时 候 访 问 。 新 的 vacuum FULL MS 
做 的 就 是 老 的 vacuum， 它 先 锁定 该 表 然 后 缩小 表 的 磁盘 文 件 . 


事务 

不 再 有 超过 四 十 亿 次 事务 的 安装 问题 了 。 

OIDs 

OID 现在 是 可 选 的 。 用 户 现在 可 以 不 用 带 OD 创建 表 ， 以 免 过 多 地 使 用 OID。 
优化 器 

系统 现在 在 ANALYzE 的 时 候 计 算 直 方 图 列 统计 ， 这 样 就 允许 选择 更 好 的 优化 器 。 
安全 性 


新 的 MD5 加 密 选 项 允许 我 们 有 更 安全 的 口令 存储 和 传输 。 新 的 Unix 域 套 接 字 认证 选项 可 以 
在 Linux #0 BSD 系统 上 使 用 。 


统计 

管理 员 现 在 可 以 使 用 新 的 表 访 问 统计 模块 获取 有 关 表 和 索引 的 使 用 方面 的 更 细致 的 信息 
国际 化 

程序 和 库 消息 现在 可 以 以 好 几 种 语言 显 


E.214.2. 迁移 到 版 本 7.2 


对 于 使 用 任何 以 前 版 本 的 人 来 说 ， 用 pg_dump 进行 一 次 转 储 /恢复 是 的 。 
观察 下 面 的 不 兼容 性 : 


e 这 个 版 本 里 的 vacuum 命令 的 语义 发 生 了 变化 。 你 可 能 需要 相应 更 新 你 的 维护 程序 。 


。 在 这 个 版 本 里 ， 用 = NuLL 进行 的 比较 将 总 是 返回 假 (或 者 更 准确 地 说 是 NULL)。 以 前 的 
版 本 自动 把 这 个 语法 转换 成 IS NULL 。 你 可 以 使 用 postgresql.conf 参数 重新 打开 原来 
的 行为 。 


e pg_hba.conf 和 pg_ident.conf 配置 现在 只 有 在 收 到 一 个 SIGHUP 信 号 之 后 才 重 新 装载 ， 
而 不 是 每 次 连接 就 重新 装载 。 


e BYR octet_length() 现在 返回 未 压缩 的 数据 长 度 。 


日 期 /时 间 数 值 'current' 不 再 可 用 。 这 方面 你 需要 改写 你 的 应 用 . 


timestamp() , time() , 和 interval() 函数 不 可 再 用 。 应 该 用 timestamp 'string' 或 
cast 代替 timestamp() o 


SELECT ... LIMIT #,# 语法 将 在 下 一 个 版 本 中 删除 。 你 应 该 改 宇 你 的 查询 ， 利 用 LIMIT 和 
OFFSET 子 句 ， 也 就 是 说 LIMIT 10 OFFSET 20 o 


E.214.3. 修改 列表 


E.214.3.1. 服务 器 操作 
。 在 一 个 单独 的 路 径 中 创建 临时 文件 (Bruce) 
。 在 主 进程 启动 时 删除 孤立 的 临时 文件 (Bruce) 
。 添加 唯一 索引 到 一 些 系统 表 (Tom) 


系统 表 操 作 符 重组 (Oleg Bartunov, Teodor Sigaev, Tom) 
。 重 命名 pg_log to pg_clog (Tom) 

。 后 用 SIGTERM, SIGQUIT 以 杀 死 后 端 (Jan) 

。 在 许多 后 端 上 删除 编译 时 间 限 制 (Tom) 

。 更 好 的 清理 信号 灯 资 源 失败 (Tatsuo, Tom) 


。 多 许 安全 事务 ID 概括 (Tom) 


从 一 些 系统 表 中 删除 OID (Tom) 


。 删除 "triggered data change violation" 错 误 校 验 (Tom) 


预备 /保存 规划 的 SPI 入 口 创建 (Jan) 


人 允许 SPI 字 段 画 数 为 系统 字段 工作 (Tom) 


。 改善 长 值 压 缩 (Tom) 

© 统计 收集 表 、 索 引 访问 (Jan) 

。 截断 超 长 的 序列 名 为 合理 的 值 (Tom) 
。 以 毫秒 测量 事务 时 间 (Thomas) 

。 修复 TID 顺 序 扫描 (Hiroshi) 

。 超级 用 户 ID 现 在 固定 在 1 (Peter E) 


e 新 增 pg_ctl "reload" 选 项 (Tom) 


E.214.3.2. 性 能 


。 改善 优化 器 (Tom) 


为 优化 器 新 增 直 方 图 列 统计 (Tom) 

。 重新 使 用 预 写 式 日 志文 件 而 不 是 丢弃 它们 (Tom) 

。 改善 缓存 (Tom) 

e IS NULL, IS NOT NULL 优 化 器 改善 (Tom) 

。 改善 锁 管理 器 以 减少 锁 的 争 用 (Tom) 

。 为 索引 访问 支持 函数 保持 relcache 条 目 (Tom) 

© 人 允许 NUMERIC 中 NaN 和 无 穷 的 更 好 的 选择 性 (Tom) 
e R-tree 性 能 改善 (Kenneth Been) 


e B-tree 分 离 更 高 效 (Tom) 


E.214.3.3. 权限 


。 更 改 UPDATE, DELETE 权 限 为 不 同 的 (Peter E) 

。 新 增 REFERENCES, TRIGGER 权限 (Peter E) 

。 人 允许 一 次 多 于 一 个 用 户 GRANT/REVOKE to/from (Peter E) 
e #i@has_table_privilege()HZX (Joe Conway) 

。 人 允许 非 超 级 用 户 vacuum 数 据 库 (Tom) 

。 新 增 SET SESSION AUTHORIZATION 命 令 (Peter E) 


。 修复 在 新 创建 的 表 上 修改 权限 的 bug (Tom) 


不 允许 非 超级 用 户 访问 pg _statistic， 添 加 用 户 可 访问 的 视图 (Tom) 


E.214.3.4. Z P Imi 


在 做 认证 以 阻止 挂 起 之 前 分 叉 主 进程 (Peter E) 


在 Linux, *BSD 平 台 的 Unix 域 套 接 字 上 添加 标识 符 认 证 (Helge Bahmann, Oliver Elphick, 
Teodor Sigaev, Bruce) 


添加 使 用 MD5 加 密 的 口令 认证 方法 (Bruce) 
允许 存储 的 口令 使 用 MD5 加 密 (Bruce) 
PAM 认证 (Dominic J. Eidson) 


只 在 启动 和 SIGHUP 时 加 载 pg_hba.conf 和 pg_ident.conf (Bruce) 


E.214.3.5. 服务 右 配 置 


现在 在 运行 时 可 设 定 一 些 时 区 缩写 的 解释 为 澳大利亚 而 不 是 北美 (Bruce) 

新 增 参 数 设 置 缺 省 的 事务 隔离 级 别 (Peter E) 

新 增 参 数 启用 "expr = NULL" FI "expr IS NULL" 的 转换 ， 缺 省 为 of (Peter E) 
新 增 参 数控 制 VACUUM 的 内 存 使 用 (Tom) 

新 增 参 数 设 置 客户 端 认 证 超时 (Tom) 


新 增 参 数 设置 打开 文件 的 最 大 数量 (Tom) 


E.214.3.6. 查询 


INSERT 规 则 添加 的 声明 现在 在 INSERT 之 后 执行 (Jan) 

阻止 在 目标 列表 中 的 纯粹 的 关系 名 (Bruce) 

NULL 现 在 在 ORDER BY 中 在 所 有 的 正常 值 之 后 排序 (Tom) 

新 增 IS UNKNOWN, IS NOT UNKNOWN 布 尔 测试 (Tom) 

新 增 SHARE UPDATE EXCLUSIVE 锁 模式 (Tom) 

新 增 EXPLAIN ANALYZE 命 舍 ， 显 示 运 行 时 间 和 行 计 数 (Martjn van Oosterhout) 
修复 LIMIT 和 子 查 询 的 问题 (Tom) 


修复 LIMIT DISTINCT ON 推 入 子 查 询 (Tom) 


{SS #RENEXCEPT/INTERSECT (Tom) 


E.214.3.7. 模式 操作 


修复 临时 表 中 的 SERIAL (Bruce) 

允许 临时 序列 (Bruce) 

序列 现在 内 部 使 用 int8 (Tom) 

新 增 SERIAL8 创 建 带 有 序列 的 int8 字 段 ， 缺 省 仍然 为 SERIAL4 (Tom) 

使 用 WITHOUT OIDS 使 OID 可 选 (Tom) 

添加 %TYPE 话 法 到 CREATE TYPE (lan Lance Taylor) 

为 CHECK 约 束 添 加 ALTER TABLE / DROP CONSTRAINT (Christopher Kings-Lynne) 


新 增 CREATE OR REPLACE FUNCTION 以 改变 现 有 的 辑 数 (保留 函数 OID) (Gavin 
Sherry) 


添加 ALTER TABLE / ADD [ UNIQUE | PRIMARY ] (Christopher Kings-Lynne) 

允许 在 视图 中 重 命名 字段 

使 ALTER TABLE / RENAME COLUMN 更 新 素 引 的 字段 名 (Brent Verner) 

修复 继承 的 表 的 ALTER TABLE /ADD CONSTRAINT ... CHECK (Stephan Szabo) 
ALTER TABLE RENAME 正 确 的 更 新 外 键 触 发 器 参数 (Brent Verner) 

DROP AGGREGATE 和 COMMENT ON AGGREGATE 现 在 接受 一 个 aggtype (Tom) 
为 SQL 图 数 添加 自动 返回 类 型 数据 转换 (Tom) 

允许 GiST 索 引 人 处 理 NULL 和 多 键 的 素 引 (Oleg Bartunov, Teodor Sigaev, Tom) 


启用 部 分 素 引 (Martijn van Oosterhout) 


E.214.3.8. LEMS 


添加 RESET ALL, SHOW ALL (Marko Kreen) 

CREATE/ALTER USER/GROUP 现 在 允许 选项 顺序 任意 (Vince) 

添加 LOCK A, B, C 功 能 (Neil Padgett) 

新 增 ENCRYPTED/UNENCRYPTED 选 项 到 CREATE/ALTER USER (Bruce) 


新 增 轻 型 VACUUM 不 锁定 表 ; 老 的 语义 作为 VACUUM FULL 可 用 (Tom) 


。 在 视图 上 禁用 COPY TO/FROM (Bruce) 
。 COPY DELIMITERS 字 符 串 必须 恰好 是 一 个 字符 (Tom) 
e VACUUM 关于 索引 元 组 少 于 堆 的 警告 现在 只 在 合适 的 时 候 出 现 (Martijn van Oosterhout) 


。 为 CREATE INDEX 修 复权 限 检 查 (Tom) 


不 允许 不 适当 的 使 用 CREATE/DROP INDEX/TRIGGER/VIEW (Tom) 


E.214.3.9. He & ÆA KZ 


。 SUM(), AVG(), COUNT() 现 在 为 了 速度 在 内 部 使 用 int8 (Tom) 

e 添加 convert(), convert2() (Tatsuo) 

。 新 增 函 数 bit_length() (Peter E) 

e 使 "n" 在 CHAR(n)/VARCHAR(n) 中 代表 字母 而 不 是 字 节 (Tatsuo) 

e CHAR(), VARCHAR() 现 在 拒绝 太 长 的 字符 串 (Peter E) 

e BIT VARYING 现 在 拒绝 太 长 的 位 字符 串 (Peter E) 

。 BIT 现在 拒绝 不 匹配 声明 的 尺寸 的 位 字符 串 (Peter E) 

e INET, CIDR 文 本 转换 功能 (Alex Pilosov) 

e INET, CIDR 操 作 符 << 和 <<= 可 索引 (Alex Pilosov) 

。 Bytea 故 # 现 在 需要 有 效 的 三 位 八进制 数字 

e Bytea 比 较 改 善 ， 现 在 支持 =, <>, >, >=, <, 和 <= 

。 Bytea 现 在 支持 B-tree 素 引 

e Bytea 现 在 支持 LIKE, LIKE...ESCAPE, NOT LIKE, NOT LIKE...ESCAPE 
e Bytea 现 在 支持 串联 

e #18byteaky2X : position, substring, trim, btrim, 和 length 

。 新 增 encode() 函 数 模 式 ，"escaped"， 转 换 最 低 限 度 逃 逸 的 bytea to/from 文 本 
e 添加 pg_database_encoding_max_length() (Tatsuo) 

e 添加 pg_client_encoding() 函数 (Tatsuo) 

。 now() 返 回 毫 秒 精度 的 时 间 (Thomas) 


。 新 增 TIMESTAMP WITHOUT TIMEZONE 数据 类 型 (Thomas) 


e 添加 ISO 日 期 /时 间 规 格 : "T", yyyy-mm-ddThh:mm:ss (Thomas) 


e 新 增 xid/int 比较 函数 (Hiroshi) 


添加 精度 到 TIME, TIMESTAMP, 和 INTERVAL 数 据 类 型 (Thomas) 


修改 类 型 强制 逻辑 为 尝试 二 进 制 兼容 函数 优先 (Tom) 


新 增 缺 省 安装 的 encode() 函 数 (Marko Kreen) 


改进 to_*() 转换 画 数 (Karel Zak) 


。 当 使 用 单字 节 编 码 时 优化 LIKE/ILIKE (Tatsuo) 


在 contrib/pgcrypto 中 新 增 函 数 : crypt(), hmac(), encrypt(), gen_salt() (Marko Kreen) 


改正 translate() KAIA (Bruce) 


添加 INTERVAL 参 数 以 SET TIME ZONE (Thomas) 


添加 INTERVAL YEAR TO MONTH (等 等 ) 语 法 (Thomas) 


。 当 使 用 单字 节 编 码 时 优化 长 度 辑 数 (Tatsuo) 


修复 path_inter, path_distance, path_length, dist_ppath 以 处 理 闭合 路 径 (Curtis Barrett, 
Tom) 


octet length(text) 现 在 返回 非 压 缩 的 长 度 (Tatsuo, Bruce) 


在 日 期 /时 间 字 面值 中 处 理 "July" 全 名 (Greg Sabino Mullane) 


一 些 datatype() 函 数 调用 现在 的 评估 不 同 


e 添加 Julian 和 ISO 时间 声明 支持 (Thomas) 


E.214.3.10. 国际 化 
。 在 psql, pg_dump, libpq, 和 server 中 支持 国家 语言 (Peter E) 


e 用 汉语 (简化 了 的 ， 传统 的 ) 、 捷克 语 、 法 语 、 和 德语 、 人 匈牙利 语 、 俄语 、 瑞典 ; 知 番 | 译 消 
息 (Peter E, Serguei A. Mokhov, Karel Zak, Weiping He, Zhenbang Wei, Kovacs Zoltan) 


e 使 trim, ltrim, rtrim, btrim, Ipad, rpad 意 识 到 翻译 多 字 节 (Tatsuo) 
。 添加 LATIN5,6,7,8,9,10 支 持 (Tatsuo) 

e 添加 ISO 8859-5,6,7,8 支 持 (Tatsuo) 

e 改正 LATIN5 意 为 ISO-8859-9, 而 不 是 ISO-8859-5 (Tatsuo) 


e 使 mic2ascii() 没 有 ASCIl 意 识 (Tatsuo) 


。 拒绝 无 效 的 多 字 节 字符 序列 (Tatsuo) 


E.214.3.11. PL/pgSQL 


。 现在 使 用 SELECT 循环 入 口 ， 人 允许 大 的 结果 集 (Jan) 

。 支持 CURSOR 和 REFCURSOR (Jan) 

。 现在 可 以 返回 开放 的 游标 (Jan) 

。 添加 ELSEIF (Klaus Reger) 

e 改善 PL/pgSQL 错 误 报 告 ， 包 括 错误 的 位 置 (Tom) 

。 为 了 兼容 性 ， 在 游标 声明 中 人 允许 IS 或 FOR 关 键 字 (Bruce) 
e 修复 SELECT ... FOR UPDATE (Tom) 

。 修复 PERFORM 返 回 多 行 (Tom) 

。 使 PL/pgSQL 强 制 使 用 服务 器 的 类 型 转换 代码 (Tom) 

。 内 存 泄露 修复 (Jan, Tom) 


。 使 尾随 的 分 号 可 选 (Tom) 


E.214.3.12. PL/Perl 


。 新 增 不 信任 的 PL/Perl (Alex Pilosov) 


。 PL/Perl 现 在 在 一 些 平台 上 建立 ， 即 使 libper| 不 是 共享 的 (Peter E) 


E.214.3.13. PL/Tcl 


e 现在 报告 errorlnfo (Vsevolod Lobko) 


e YMspi_lastoide2X (bob@redivi.com) 


E.214.3.14. PL/Python 


e ... 是 新 增 的 (Andrew Bosma) 


E.214.3.15. psal 
e \d 显示 不 重复 的 索引 ， 主 要 分 组 (Christopher Kings-Lynne) 


。 在 反 斜 杠 命令 里 允许 尾随 的 分 号 (Greg Sabino Mullane) 


e 如 果 可 以 ， 从 /dewv/tty 中 读 取 口 兮 
。 当 改 变 用 户 和 数据 库 时 强制 新 的 口令 提示 (Tatsuo, Tom) 


。 格式 化 正确 的 字段 编号 为 Unicode 


E.214.3.16. libpq 


。 新 增 本 数 PQescapeString() 以 逃逸 命令 字符 串 中 的 引号 (Florian Weimer) 


EK 
。 Pree ePQescapeBytea() > (HASOLFLHBMAUE A Ht HFS 


E.214.3.17. JDBC 
。 返回 INSERT 的 OID (Ken K) 
。 义理 更 多 数据 类 型 (Ken K) 
。 在 字符 串 中 处理 单 引号 和 新 行 (Ken K) 
e 义理 NULL 变 量 (Ken K) 
。 修复 时 区 处 理 (Barry Lind) 
。 改善 Druid 支 持 
。 人 允许 带 有 非 多 字 节 服务 器 的 八 位 字符 (Barry Lind) 
e 支持 BIT BINARY 类 型 (Ned Wolpert) 
。 减少 内 存 使 用 (Michael Stephens, Dave Cramer) 
。 更 新 DatabaseMetaData (Peter E) 
e 添加 DatabaseMetaData.getCatalogs() (Peter E) 
e 编码 修复 (Anders Bengtsson) 


e Get/setCatalog 方 法 (Jason Davies) 


DatabaseMetaData.getColumns() 现 在 返回 列 的 默认 值 (Jason Davies) 


改善 DatabaseMetaData.getColumns() 性 能 (Jeroen van Vianen) 
e 一 些 JDBC1 和 JDBC2 合 并 了 (Anders Bengtsson) 


。 事务 性 能 改进 (Barry Lind) 


数组 修复 (Greg Zoller) 


序列 化 添加 


128 T tt 438 (Rene Pijlman) 


ExecSQL 方 法 重组 (Anders Bengtsson) 


修复 了 GetColumn() (Jeroen van Vianen) 


I% T isWriteable()EI2X (Rene Pijlman) 


改善 JDBC2 一 致 性 测试 的 通道 (Rene Pijlman) 


添加 bytea 类 型 兼容 (Barry Lind) 


添加 isNullable() (Rene Pijlman) 


JDBC 日 期 /时 间 测 试 套件 修复 (Liam Stewart) 


修复 SELECT 'id' AS xxx FROM table (Dave Cramer) 


修复 DatabaseMetaData 以 恰当 的 显示 精度 (Mark Lillywhite) 


#138 getImported/getExported#? (Jason Davies) 


支持 MD5 口 令 加 密 (Jeremy Wohl) 


修复 实际 使 用 类 型 缓存 (Ned Wolpert) 


E.214.3.18. ODBC 
e 删除 查询 大 小 限制 (Hiroshi) 
。 删除 文本 字段 大 小 限制 (Hiroshi) 
。 修复 多 字 节 模式 中 的 SQLPrimaryKeys (Hiroshi) 
。 人 允许 ODBC 程 序 调用 (Hiroshi) 
。 改善 布尔 处 理 (Aidan Mountford) 
。 大 部 分 配置 选项 现在 可 以 通过 DSN 设 置 (Hiroshi) 
。 多 字 节 ， 性 能 修复 (Hiroshi) 
e 人 允许 iODBC 或 unixODBC 使 用 驱动 程序 (Peter E) 
e 支持 MD5 口 令 加 密 (Bruce) 


。 添加 更 多 兼容 函数 到 odbc.sql (Peter E) 


E.214.3.19. ECPG 


e 应 用 了 EXECUTE ... INTO (Christof Petig) 


。 多 重 描述 符 支 持 (e.g. CARDINALITY) (Christof Petig) 
e 修复 GRANT 参数 (Lee Kindness) 

。 修复 INITIALLY DEFERRED bug 

。 各 种 bug 修 复 (Michael, Christof Petig) 


。 自动 分 配 指 示 器 变量 数组 (int *ind_p=NULL) 


自动 分 配 字符 串 数组 (char *foo_pp=NULL) 
e 修复 ECPGfree_auto_mem 


。 所 有 带 有 外 部 链接 的 东 数 名 现在 都 有 ECPG 前 级 


修复 结构 的 数组 (Michael) 


E.214.3.20. 混合 接口 
e Python 修复 fetchone() (Gerhard Haring) 
。 在 Tcl 中 合适 的 地 方 使 用 UTF, Unicode (Vsevolod Lobko, Reinhard Max) 
。 添加 Tcl COPY TO/FROM (lib) 
e 阻止 pg_dump 中 缺 省 索引 op 类 的 输出 (Tom) 


。 修复 libpgeasy 内 存 泄露 (Bruce) 


E.214.3.21. 建立 和 安装 


。 配置 、 动 态 加 载 和 共享 库 的 修复 (Peter E) 


修复 了 QNX 的 四 个 端口 (Bernd Tegge) 


修复 了 Cygwin 和 Windows 端口 (Jason Tishler, Gerhard Haring, Dmitry Yurtaev, Darko 
Prenosil, Mikhail Terekhov) 


修复 了 Windows 接口 通讯 失败 (Magnus, Mikhail Terekhov) 


硬 编译 修复 (Oliver Elphick) 


BeOS 修 复 (Cyril Velter) 


删除 configure --enable-unicode-conversion， 现 在 由 多 字 节 启用 (Tatsuo) 


。 AIX 修复 (Tatsuo, Andreas) 


修复 并 行进 行 (Peter E) 


。 安装 SQL 语言 手册 页 到 OS 指定 的 目录 (Peter E) 
。 重 命名 config.h 为 pg_config.h (Peter E) 


。 整理 头 文件 的 安装 布局 (Peter E) 


E.214.3.22. 源 代码 


。 删除 SEP_CHAR (Bruce) 

e 新 增 GUC hooks (Tom) 

。 合并 GUC 和 命令 行 处 理 (Marko Kreen) 

。 删除 EXTEND INDEX (Martijn van Oosterhout, Tom) 
e 新 增 pgjindent 到 java 代码 缩 进 (Bruce) 


。 在 C++ 下 编译 时 删除 true/false 的 定义 (Leandro Fanzone, Tom) 


pgindent 修复 (Bruce, Tom) 


在 适当 的 地 方 用 strcmp() 替换 strcasecmp() (Peter E) 


e 改善 Dynahash 可 移植 性 (Tom) 


在 自 旋 锁 结 构 中 添加 volatile’ 用 法 


。 改善 信号 处 理 逻 辑 (Tom) 


E.214.3.23. 贡献 包 


e 新 增 contrib/rtree_gist (Oleg Bartunov, Teodor Sigaev) 
e 新 增 contrib/tsearch 全 文本 索引 (Oleg, Teodor Sigaev) 
。 为 远程 数据 库 访问 添加 contrib/dblink (Joe Conway) 

e contrib/ora2pg Oracle 转换 工具 (Gilles Darold) 


e contrib/xml XML 转换 工具 (John Gray) 


contrib/fulltextindex 修复 (Christopher Kings-Lynne) 


#128 contrib/fuzzystrmatch #4 levenshtein 和 metaphone, soundex 合并 (Joe Conway) 


添加 contrib/intarray 布尔 查询 , 二 分 查找 , 修复 (Oleg Bartunov) 


新 增 pg_upgrade 工具 (Bruce) 


添加 新 的 pg_resetxlog 选项 (Bruce, Tom) 
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E.215. 版 本 7.1.3 


发 布 日 期 : 2001-08-15 


E.215.1. 迁移 到 版 本 7.1.3 


运行 7.1.X 版 本 的 系统 不 需要 转 储 /恢复 。 


E.215.2. 修改 列表 


删除 大 事务 未 设置 的 WAL 片段 (Tom) 

Multiaction 规则 修复 (Tom) 

PL/pgSQL 内 存 分 配 修复 (Jan) 

VACUUM 缓冲 区 修复 (Tom) 

回 为 测试 修复 (Tom) 

在 视图 上 为 GRANT/REVOKE/comments 修复 了 pg_dump， 用 户 定义 类 型 (Tom) 
修复 了 带 有 DISTINCT ON 或 LIMIT 的 子 查询 (Tom) 

Beos 修复 

禁用 COPY TO/FROM 一 个 视图 (Tom) 

Cygwin 建立 (Jason Tishler) 


E.216. 版 本 7.1.2 


发 布 日 期 : 2001-05-11 


这 个 版 本 对 7.1.1 有 一 个 修补 。 


E.216.1. 迁移 到 版 本 7.1.2 


运行 7.1.X 的 系统 不 需要 转 储 /恢复 。 


E.216.2. 修改 列表 


当 没 有 返回 行 时 修复 PL/pgSQL SELECTS 
修复 psql REHIA $k tk 
参照 完整 性 权限 修复 

优化 器 修复 

pg_dump 清理 


E.217. 版 本 7.1.1 


发 布 日 期 : 2001-05-05 


这 个 版 本 对 7.1 有 一 些 修补 。 


E.217.1. 迁移 到 版 本 7.1.1 


运行 7.1 的 系统 不 需要 转 储 / 恢 复 。 


E.217.2. 修改 列表 


修复 数值 型 MODULO 操作 符 (Tom) 
pg_dump 修复 (Philip) 

pg_dump 可 以 转 储 7.0 数据 库 (Philip) 
readline 4.2 修复 (Peter E) 

JOIN 修复 (Tom) 

AIX, MSWIN, VAX, N32K 修复 (Tom) 
Multibytes 修复 (Tom) 

Unicode 修复 (Tatsuo) 

优化 器 改善 (Tom) 

修复 函数 中 的 整 行 (Tom) 

修复 pg_ct1 和 带 有 空格 的 选项 字符 串 (Peter E) 
ODBC fixes (Hiroshi) 

EXTRACT 现在 可 以 接受 字符 串 参数 (Thomas) 
Python 修复 (Darcy) 


E.218. 版 本 7.1 


发 布 日 期 : 2001-04-13 


这 个 版 本 集中 在 移 去 多 年 来 存在 于 PostgreSQL 里 的 限制 。 


这 个 版 本 的 主要 修改 : 
预 写 式 日 志 


在 发 生 操 作 系 统 崩 溃 的 情况 下 维持 数据 库 系统 稳定 ， 以 前 版 本 的 PostgreSQL 在 每 次 事务 提 
交 之 前 强迫 所 有 数据 修改 都 冲刷 到 磁 衣 上 。 有 了 WAL, 只 有 一 个 日 志文 件 必 须 冲 刷 到 磁 总 
上 ， 极 大 地 提高 了 性 能 。 如 果 你 在 以 前 的 版 本 便 经 使 用 -F 来 关闭 磁盘 冲刷 ， 那 么 你 可 以 考虑 
不 再 使 用 这 个 选项 。 


TOAST 


TOAST - 以 前 的 版 本 有 一 个 内 编译 的 行 长 度 限制 ， 通 常 是 8k - 32k, 这 个 限制 邻 我 们 很 难 存 
储 长 的 文本 域 。 有 了 TOAST， 任 意 长 度 的 行 都 可 以 以 很 好 的 性 能 存储 。 


外 连接 


我 们 现在 支持 外 连接 。 用 于 外 连接 的 UNION/NOT IN 的 绕 开 现在 不 再 需要 了 。 我 们 使 用 
SQL92 外 连接 语法 。 


函数 管理 器 


以 前 的 C 函数 管理 器 无 法 正确 处 理 NULL， 也 不 支持 64 位 CPU (Alpha), 新 的 函数 管理 器 
可 以 实现 这 些 任务 。 你 仍然 可 以 继续 使 用 你 的 老 的 自 定义 函数 ， 但 是 你 在 将 来 可 能 会 愿意 为 
使 用 新 的 范 数 管理 器 调用 接口 改 守 它们 。 


BRA 


大 量 以 前 版 本 不 支持 的 复杂 查询 现在 可 以 运转 了 。 许 多 视图 ， 聚 集 ，UNION，LIMIT， 游 
标 ， 子 查询 ， 和 继承 表 的 组 合 现在 可 以 正确 工作 了 。 继 承 的 表现 在 缺 省 是 访问 的 。 现 在 支持 
在 FROM 里 的 子 查询 了 。 


E.218.1. 迁移 到 版 本 7.1 


如 果 需 要 从 任何 以 前 版 本 升级 到 这 个 版 本 ， 那 么 要 求 用 pg_dump 做 转 储 /恢复 工作 。 


E.218.2. 修改 列表 


4 Smultibyte/Unicode/locale(fé (Tatsuo and others) 

更 可 靠 的 ALTER TABLE RENAME (Tom) 

Kerberos V 修复 (David Wragg) 

修复 了 有 子 查 询 的 目标 列表 的 INSERT INTO. . .SELECT (Tom) 

标准 错误 提示 用 户 名 /密码 (Tom) 

修复 了 to_char()，to_date()，to_ascii()， 和 to_timestamp() (Karel, 
Daniel Baldoni) 

阻止 查询 表达 式 内 存 泄 露 (Tom) 

允许 UPDATE 数组 元 素 (Tom) 

在 取消 时 唤醒 锁 等 待 (Hiroshi) 

当 使 用 哈 希 连接 时 修复 极 少 情况 的 游标 崩溃 (Tom) 

在 回 滚 的 事务 中 修复 DROP TABLE/INDEX (Hiroshi) 

如 果 启 用 了 MULTIBYTE， 修 复 psql 的 \l+ 崩溃 (Peter E) 

修复 在 CREATE VIEW 运行 时 的 规则 名 截断 (Ross Reedstrom) 

修复 PL/perl (Alex Kapranoff) 

不 允许 LOCK 视图 (Mark Hollomon) 

不 允许 在 视图 上 INSERT/UPDATE/DELETE (Mark Hollomon) 

不 允许 在 视图 上 DROP RULE, CREATE INDEX, TRUNCATE (Mark Hollomon) 

允许 PL/pgSQL 接受 非 ASCII 标 识 符 (Tatsuo) 

允许 视图 适当 人 处理 GROUP BY, aggregates, DISTINCT (Tom) 

修复 TRUNCATE 命令 极 少 的 失败 (Tom) 

允许 ALL， 子 查询 ， 视 图 ，DISTINCT， ORDER BY, SELECT. . .INTO 使 用 UNION/INTERSECT/EXCEPT (Tom) 

修复 在 中 止 事 务 期 间 的 解析 器 错误 (Tom) 

允许 临时 关系 适当 的 清理 索引 (Bruce) 

在 同一 页 中 移动 行 以 修复 VACUUM 问题 (Tom) 

修改 pg_dump 以 更 好 的 处 理 在 templatel1 中 用 户 定义 的 条 目 (Philip) 

允许 在 视图 中 使 用 LIMIT (Tom) 

要 求 游标 准确 的 FETCH LIMIT (Tom) 

允许 在 非 继承 的 字段 上 定义 PRIMARY/FOREIGN 键 (Stephan) 

人 允许 在 子 查询 中 ORDER BY, LIMI (Tom) 

允许 在 CREATE RULE 中 使 用 UNION (Tom) 

使 ALTER/DROP TABLE 可 回 滚 (Vadim, Tom) 

在 pg_control 中 存储 ijnitdb 校对 ， 这 样 校对 不 能 被 改变 (Tom) 

用 规则 修复 INSERT...SELECT (Tom) 

修复 视图 内 的 FOR UPDATE 和子 查询 (Tom) 

按照 SQL92 规则 修复 关于 NULL 的 OVERLAPS 操作 符 (Tom) 

修复 lpad() 和 rpad() 以 义理 长 度 小 于 输入 字符 串 的 情况 (Tom) 

修复 NOTIFY 在 一 些 规则 中 的 使 用 (Tom) 

详细 检查 btree 代码 (Tom) 

用 Pl1/pgSQL 变量 修复 NOT NULL 的 使 用 (Tom) 

详细 检查 GIST 代码 (Oleg) 

修复 CLUSTER MRR RARE FE (Tom) 

改进 了 死 锁 检 测 处 理 (Tom) 

在 一 个 表 中 人 允许 多 个 SERIAL 字段 (Tom) 

阻止 偶然 的 索引 损坏 (Vadim) 








添加 OUTER JOINs (Tom) 

彻底 检查 函数 管理 (Tom) 

允许 在 索引 上 ALTER TABLE RENAME (Tom) 

改善 CLUSTER (Tom) 

为 更 多 平台 改善 ps 状态 显示 (Peter E, Marc) 

改善 CREATE FUNCTION 失败 信息 (Ross) 

JDBC 改进 (Peter, Travis Bauer, Christopher Cain, William Webber, 
Gunnar ) 

重要 的 统一 配置 模式 /GUC。 许 多 选项 现在 可 以 在 data/postgresql.conf, 

postmaster/postgres 标识 ， 或 SET BHR (Peter E) 

改善 文件 描述 符 缓 存 的 处 理 (Tom) 

新 增 关 于 自动 创建 表 别 名 的 警告 代码 (Bruce) 

详细 检查 initdb 进程 (Tom, Peter E) 

详细 检查 继承 的 表 ; 继承 的 表现 在 缺 省 是 可 访问 的 ; 新 增 ONLY 关键 字 阻 止 对 它 的 访问 (Chris Bitmead, Tom) 

ODBC 清理 /改善 (Nick Gorham, Stephan Szabo, Zoltan Kovacs, 
Michael Fork) 

允许 重 命名 临时 表 (Tom) 

详细 检查 内 存 管 理 环境 (Tom) 

pg_dumpall 使 用 CREATE USER 或 CREATE GROUP 而 不 是 COPY (Peter E) 

详细 检查 pg_dump (Philip Warner) 

允许 pg_hba.conf 次 要 的 口令 文件 只 指定 用 户 名 (Peter E) 








在 创建 临时 表 时 允许 TEMPORARY 或 TEMP 关键 字 (Bruce) 

新 增 内 存 泄露 检查 器 (Karel) 

新 增 SET SESSION CHARACTERISTICS (Thomas) 

允许 启 套 的 块 注释 (Thomas) 

添加 WITHOUT TIME ZONE 类 型 限定 符 (Thomas) 

新 增 ALTER TABLE ADD CONSTRAINT (Stephan) 

为 INTEGER 聚集 使 用 NUMERIC 累加 器 (Tom) 

详细 检查 聚集 代码 (Tom) 

新 增 VARIANCE 和 STDDEV() 聚集 

改善 pg_dump 的 依赖 顺序 (Philip) 

新 增 pg_restore 命令 (Philip) 

新 增 pg_dump tar 输出 选项 (Philip) 

新 增 大 对 象 的 pg_dump (Philip) 

新 增 ESCAPE 选项 到 LIKE (Thomas) 

新 增 大 小 写 敏感 的 ”LIKE - ILIKE (Thomas) 

允许 功能 索引 使 用 二 进 制 兼容 的 类 型 (Tom) 

允许 SQL 画 数 在 更 多 的 环境 中 使 用 (Tom) 

新 增 pg_config 工具 (Peter E) 

新 增 PL/pgSQL EXECUTE mS, WAWA SQL 和 工具 语句 (Jan) 

为 SPI 值 访 问 新 增 PL/pgSQL GET DIAGNOSTICS 语句 (Jan) 

新 增 quote_identifiers() 和 quote_literal() MR (Jan) 
新 增 New ALTER TABLE table OWNER 到 user command (Mark Hollomon) 
在 FROM 中 允许 子 查询 ， 如 FROM (SELECT ...) [AS] alias (Tom) 
更 新 PyGreSQL 到 版 本 3.1 (D'Arcy) 

存储 表 为 OID 命名 的 文件 (Vadim) 

新 增 SQL WA setval(seq,val,bool) 适用 于 pg_dump (Philip) 
要 求 DROP VIEW 删除 视图 ， 而 不 是 DROP TABLE (Mark) 

人 允许 DROP VIEW view1, view2 (Mark) 

在 DROP INDEX, DROP RULE, #0 DROP TYPE 中 人 允许 多 个 对 象 (Tom) 
允许 自动 转换 到 /从 Unicode (Tatsuo, Eiji) 

新 增 /contrib/pgcrypto 哈 希 函数 (Marko Kreen) 

新 增 pg_dumpall --globals-only 选项 (Peter E) 

为 创建 新 的 WAL 日 志文 件 的 WAL 新 增 CHECKPOINT #843 (Vadim) 
新 增 AT TIME ZONE 语法 (Thomas) 

允许 配置 Unix 域 套 接 字 的 位 置 (David J. Mackenzie) 

允许 主 进程 监听 一 个 特殊 的 IP 地 址 (David J. MacKenzie) 

允许 通过 前 导 和 斜 线 以 主机 名 指定 套 接 字 路 径 名 (David J. MacKenzie) 
允许 CREATE DATABASE 指定 临时 数据 库 (Tom) 

新 增 工 具 以 转换 MySQL 模式 转 储 为 SQL92 和 PostgreSQL (Thomas) 
新 增 /contrib/rserv 复制 工具 包 (Vadim) 

为 ”COPY BINARY 新 增 文 件 格式 (Tom) 

新 增 /contrib/oid2name 以 映射 数值 文件 到 表 名 (B Palmer) 

新 增 "idle in transaction" ps 状态 信息 (Marc) 

更 新 到 pgaccess 0.98.7 (Constantin Teodorescu) 

pg_ctl 在 关闭 时 现在 缺 省 为 -w (wait), 新 增 -1 (log) 选项 
添加 基本 的 依赖 约束 到 pg_dump (Philip) 


修复 INET/CIDR 类 型 排序 和 添加 新 的 函数 (Tom) 

使 OID 表现 为 一 个 无 符号 的 类 型 (Tom) 

人 允许 BIGINT 作为 INT8 的 同义词 (Peter E) 

新 增 int2 和 ints 上 比较 运算 符 (Tom) 

新 增 BIT 和 BIT VARYING 类 型 (Adriaan Joubert, Tom, Peter E) 
CHAR() “因为 TOAST 而 不 再 比 VARCHAR() IÈ (Tom) 

新 增 GIST seg/cube 示例 (Gene Selkov) 

改进 round(numeric) #2 (Tom) 

修复 CIDR 输出 格式 (Tom) 

新 增 CIDR abbrev() HR (Tom) 





预 写 式 日 志 (WAL) 提供 崩溃 恢复 ， 用 较 少 的 性 能 开销 (Vadim) 
ANALYZE VACUUM 的 阶段 不 再 只 锁 住 表 (Bruce) 

减少 文件 搜索 (Denis Perchine) 

为 复制 键 改 善 BTREE 代码 (Tom) 

在 一 个 单独 的 表 中 存储 所 有 的 大 对 象 (Denis Perchine, Tom) 
改善 内 存 分 配 性 能 (Karel, Tom) 





新 增 画 数 管理 调用 约定 (Tom) 


SGI 可 移植 性 修复 (David Kaelbling) 

新 增 configure --enable-syslog 选项 (Peter E) 

新 增 BSDI README (Bruce) 

配置 脚本 移动 到 项 级， 而 不 是 /src (Peter E) 

新 增 configure --with-python 选项 (Peter E) 
Solaris 清理 (Peter E) 

详细 检查 /contrib Makefiles (Karel) 

新 增 OpenSSL 配置 选项 (Magnus, Peter E) 

AIX (68 (Andreas) 

QNX 修复 (Maurizio) 

新 增 heap_open(), heap_openr() API (Tom) 

删除 colon 和 semi-colon 运算 符 (Thomas) 

为 视图 新 增 pg_class.relkind 值 (Mark Hollomon) 
重 命名 ichar() 为 chr() (Karel) 

新 增 文 件 btrim(), ascii(), chr(), repeat() (Karel) 
修复 NT/Cygwin (Pete Forman) 

AIX 端口 修复 (Andreas) 

新 增 BeOS 端口 (David Reid, Cyril Velter) 

添加 校对 员 的 更 改 到 文档 (Addison-Wesley, Bruce) 

新 增 Alpha 自 旋 锁 代码 (Adriaan Joubert, Compaq) 
详细 检查 Unixware WO (Peter E) 

新 增 Darwin/Mac OS X 端口 (Peter Bierman, Bruce Hartzler) 
新 增 FreeBSD Alpha 端口 (ALfred) 

详细 检查 共享 内 存 段 (Tom ) 

新 增 IBM S/390 支持 (Neale Ferguson) 

移动 macmanuf 到 /contrib (Larry Rosenman) 

Syslog 改善 (Larry Rosenman) 

新 增 不 包含 用 户 附 加 的 templateo AH (Tom) 

新 增 /contrib/cube 和 /contrib/seg GIST 示例 代码 (Gene Selkov) 
允许 NetBSD 的 libedit 而 不 是 readline (Peter) 
改善 汇编 语言 源 代码 格式 (Bruce) 

新 增 contrib/pg_logger 

新 增 --template 选项 到 createdb 

新 增 contrib/pg_control 工具 (Oliver) 

新 增 FreeBSD 工具 ipc_check, start-scripts/freebsd 


SSS as Se 





E.219. 版 本 7.0.3 


发 布 日 期 : 2000-11-11 


有 一 些 对 7.0.2 的 修补 。 


E.219.1. 迁移 到 版 本 7.0.3 


运行 7.0.* 的 系统 不 需要 转 储 /恢复 。 


E.219.2. 修改 列表 


Jdbc 修复 (Peter ) 

大 对 象 修复 (Tom ) 

修复 lean 在 COPY WITH OIDS 时 的 泄露 (Tom) 

修复 backwards-index-scan (Tom) 

修复 SELECT ... FOR UPDATE， 这 样 它 检查 重复 的 键 (Hiroshi) 
添加 --enable-syslog 到 配置 (Marc) 

修复 极 少 情况 下 后 端 退 出 时 的 中 止 事 务 (Tom) 

启用 多 字 节 时 修复 psql \l+ (Tatsuo) 

允许 PL/pgSQL 接受 非 ascii 标 识 符 (Tatsuo) 

使 vacuum 总 是 刷新 缓冲 区 (Tom) 

当 等 待 一 个 锁 时 允许 取消 (Hiroshi) 

侈 复 用 户 认 证 代码 中 的 内 存 分 配 问题 (Tom) 

IRA EAI int4out() 的 使 用 (Tom) 

IS COALESCE 或 BETWEEN 中 的 多 重子 查询 (Tom) 

修复 在 特定 情况 下 打开 的 堆 中 的 触发 器 错误 (Jeroen van Vianen) 
路 复 错误 的 不 相等 的 选择 性 (Tom) 

SS 2269 strcmp() 的 使 用 (Tom) 

修复 存储 管理 访问 条 目 超过 文件 结尾 的 bug (Tom) 

SREMA smgr elog 消息 中 包括 内 核 错误 信息 (Tom) 
修复 在 建立 时 '.' 不 在 PATH 中 (SL Baur) 

侈 复 超 出 文件 描述 符 错误 (Tom) 

ISS pg_dump 为 函数 转 钳 'iscachable' 标记 (Tom) 

获 复 在 附加 节点 的 目标 列表 中 的 子 查询 (Tom) 

修复 合并 连接 规划 (Tom) 

路 复 带 有 索引 的 关系 的 TRUNCATE 失败 (Tom) 

避免 宇 入 误差 时 数据 库 范围 的 重启 (Hiroshi) 

修复 通过 重新 计算 输出 使 nodeMaterial 遵守 chgParam (Tom) 
侈 复 当 行 版 本 的 出 发 点 和 目的 地 位 于 同一 页 面 时 ， 更 新 行 版 本 的 移动 链条 的 VACUUM 问题 (Tom) 
I$ user.c CommandCounterIncrement (Tom) 

(SS AM/PM 在 to_char() 中 的 边界 问题 (Karel Zak) 

SS TIME RRR (Tom) 

ISS to_char() 避免 NULL 输入 的 内 核 转 储 (Tom) 

缓存 修复 (Tom) 

路 复 插入 /拷贝 更 长 的 多 字 节 字符 串 到 char() 数据 类 型 (Tatsuo) 
侈 复 中 止 时 的 后 端 崩溃 (Tom) 





E.220. 版 本 7.0.2 


发 布 日 期 : 2000-06-05 


这 是 对 7.0.1 和 添加 的 文档 的 重新 打包 。 


E.220.1. 迁移 到 版 本 7.0.2 


运行 7.* 的 系统 不 需要 转 储 / 恢 复 。 


E.220.2. 修改 列表 


添加 文档 到 原始 代码 。 


E.221. 版 本 7.0.1 


发 布 日 期 : 2000-06-01 


这 是 一 个 7.0 的 纯净 版 本 。 


E.221.1. 迁移 到 版 本 7.0.1 


运行 7.0 版 本 的 系统 不 需要 转 储 /恢复 。 


E.221.2. 修改 列表 


SB CLUSTER 失败 (Tom) 

人 允许 ALTER TABLE RENAME 在 索引 上 工作 (Tom) 

SS plpgsql 处 理 datetime->timestamp 和 timespan->interval (Bruce) 
新 增 configure --with-setproctitle 开关 以 使 用 setproctitle() (Marc, Bruce) 
路 复 因为 一 个 来 自 6 .5 .3 或 更 多 的 结果 集 的 错误 而 关闭 的 问题 

jdbc 结果 集 修复 (Joseph Shraibman) 

优化 器 优化 (Tom) 

修复 为 pgaccess 创建 用 户 

($= UNLISTEN 失败 

IRIX 修复 (David Kaelbling) 

QNX 修复 (Andreas Kardos) 

降低 COPY IN 锁 级 别 (Tom) 

改变 libpqeasy 以 使 用 PQconnectdb() 风格 参数 (Bruce) 

SS pg_dump 以 处 理 OID 索引 (Tom) 

修复 小 的 内 存 泄露 (Tom) 

修复 Solaris 以 createdb/dropdb (Tatsuo) 

收复 非 阻 塞 连接 (Alfred Perlstein) 

ZS RENAME TABLE 失败 之 后 不 正确 的 恢复 (Tom) 

在 安装 中 拷贝 pg_ident.conf.sample 到 /lib 目录 (Bruce) 

添加 SJIS UDC (NEC selection IBM kanji) 支持 (Eiji Tokuya) 

修复 太 长 的 系统 信息 (Tatsuo) 

路 复 引 用 的 索引 太 长 的 问题 (Tom) 

JDBC ResultSet.getTimestamp() 修复 (Gregory Krasnow & Floyd Marinescu) 
ecpg 改变 (Michael) 











E.222. 版 本 7.0 


发 布 日 期 : 2000-05-08 


这 个 版 本 包含 许多 方面 的 改进 ， 表 现 了 PostgreSQL 的 不 断 成 长 。 在 7.0 中 有 比 任意 以 前 版 本 
更 多 的 改进 和 修复 。 开 发 人 员 相 信 这 是 目前 最 好 的 版 本 ; 我 们 尽力 做 到 只 发 布 稳固 的 版 本 ， 
这 个 版 本 也 不 例外 。 


这 个 版 本 中 的 主要 变化 : 
外 键 


现在 我 们 已 经 实现 了 Foreign keys (外 键 ) ， 只 有 PARTIAL MATCH 外 键 没有 实现 。 许多 用 
户 要 求 增 加 这 个 特性 ， 而 我 们 很 高 兴 现 在 我 们 能 提供 这 个 特性 . 


优化 器 检修 


继续 一 年 前 开始 的 工作 ， 优 化 器 现在 已 经 进步 多 了 ， 人 允许 更 好 的 查询 规划 选择 和 更 好 的 性 
能 ， 而 且 内 存 用 得 更 少 。 


升级 了 psql 

psql， 是 我 们 的 交互 终端 监控 器 ， 升 级 并 增加 了 许多 新 特性 。 参阅 psa 手册 页 获取 细节 。 
连接 语法 

我 们 现在 支持 SQL92 连接 (JOIN) 语法 了 ， 尽 管 目前 的 版 本 只 支持 INNER JOIN 。 


JOIN, NATURAL JOIN, JOIN / USING, JoIN/ on 都 可 用 ， 这 些 是 字段 集合 名 称 . 


E.222.1. 迁移 到 版 本 7.0 


那些 从 任何 以 前 版 本 的 PostgreSQL 移植 的 人 都 需要 用 pg_dump 做 一 次 转 储 / 恢 复工 作 。 对 
于 从 6.5.* 升级 的 用 户 ， 你 可 以 使 用 pg_upgrade 升级 到 这 个 版 本 ; 不 过 ， 升级 最 稳固 的 方 
法 还 是 一 次 完整 的 转 储 / 重 载 安 装 。 
这 个 新 版 本 要 考虑 的 接口 和 兼容 性 问题 包括 : 
e 日 期 /时 间 类 型 datetime 和 timespan 已 经 被 SQL92 定义 类 型 timestamp 和 
interval 取代 了 。 管 我 们 做 了 一 些 努 力 令 PostgreSQL 可 以 识别 这 些 过 时 的 类 型 名 并 把 
它们 转换 成 新 类 型 名 以 简化 类 型 转化 ， 但 是 这 个 机 制 可 能 不 完全 对 你 的 现 有 应 用 透明 。 
。 优化 器 在 查询 开销 计算 方面 已 经 有 了 显著 的 提升 。 有 时 ， 这 样 将 命 查 询 时 间 减 少 ， 因为 
优化 器 做 出 了 查询 规划 的 更 好 选择 。 不 过 ， 有 一 小 部 分 情况 下 ， 通常 是 数据 不 正常 GA 
A) 分 布 时 ， 你 的 查询 时 间 可 能 增加 。 如 果 你 处 理 大 量 的 数据 ， 你 可 能 要 检查 你 的 查询 


以 核实 性 能 . 
e JDBC 和 ODBC 接口 都 升级 和 扩展 了 。 


。 SABHA cHAR_LENGTH 现在 是 一 个 内 部 函数 。 以 前 版 本 是 把 它 转换 成 对 LENGTH 的 调 
用 ， 这 样 做 会 导致 与 其 他 类 型 实现 的 LENGTH 的 混淆 ， 上 比如 几何 类 型 . 


E.222.2. 修改 列表 


阻止 画 数 调用 超出 参数 的 最 大 数目 (Tom) 

改善 CASE 构造 (Tom) 

路 复 SELECT coalesce(f1,0) FROM int4_tbl GROUP BY f1 (Tom) 

修复 SELECT sentence.words[0] FROM sentence GROUP BY sentence.words[®] (Tom) 
I GROUP BY 扫描 bug (Tom) 

改进 SQL 语法 处 理 (Tom) 

收复 包含 在 INSERT ... SELECT ... 里 的 视图 (Tom) 

修复 SELECT a/2, a/2 FROM test_missing_target GROUP BY a/2 (Tom) 
修复 subselects in INSERT ... SELECT (Tom) 

阻止 INSERT ... SELECT ... ORDER BY (Tom) 

ZAF 26B 的 关系 ， 包 括 vacuum 

提高 传播 系统 表 更 改 为 其 他 后 端 (Tom) 

提高 传播 用 户 表 更 改 为 其 他 后 端 (Tom) 

获 复 在 复杂 的 环境 中 处 理 临时 表 (Bruce, Tom) 

在 表 打开 时 允许 表 锁 ， 提 高 并 发 可 靠 性 (Tom) 

在 pg_dump 中 适当 的 引用 序列 名 (Ross J. Reedstrom) 

在 有 其 他 访问 时 阻止 DROP DATABASE 

如 果 没 有 行 被 义理 那么 阻止 GROUP BY 返回 任何 行 (Tom) 





如 果 没 有 行 匹配 WHERE 那么 修复 SELECT COUNT(1) FROM table WHERE ...' (Tom) 
修复 pg_upgrade 使 其 为 MVCC 工作 (Tom) 
(i$ SELECT ... WHERE x IN (SELECT ... HAVING SUM(x) > 1) (Tom) 


修复 "f1 datetime DEFAULT 'now'" (Tom) 

(SS DEFAULT 中 使 用 的 CURRENT_DATE 的 问题 (Tom) 

人 允许 只 有 注释 的 行 ， 也 人 允许 ;;; íT (Tom) 

改进 在 磁盘 满 写 入 磁盘 失败 之 后 的 恢复 (Hiroshi) 

ERE FROM 中 提 到 表 而 没有 连接 该 表 的 情况 (Tom) 

允许 HAVING FOR TARRHM (Tom) 

Se "--" 注释 和 没有 尾随 的 新 行 ， 就 像 在 Perl 接口 中 看 到 的 那样 
改善 pg_dump 失败 错误 报告 (Bruce) 

允许 排序 和 哈 希 超过 2GB 文件 大 小 (Tom) 

ES pg_dump 转 储 非 继承 的 规则 (Tom) 

SS NULL 义理 比较 (Tom) 

修复 由 于 CREATE/DROP 命令 失败 引起 的 不 一 致 的 状态 (Hiroshi) 
修复 带 有 破 折 号 的 dbname 

阻止 DROP INDEX 干扰 其 他 后 端 (Tom) 

IS verify_password() 中 的 文件 描述 符 泄露 

修复 "Unable to identify an operator =$" 问题 

ISS ODBC, HAR AAT Commlog 和 Debug 不 会 有 segfault (Dirk Niggemann) 
修复 递归 的 退出 调用 (Massimo) 

修复 超 长 的 时 区 (Jeroen van Vianen) 

使 pg_dump 保存 主键 信息 (Peter E) 

阻止 带 有 单 引 号 的 数据 库 (Peter E) 

阻止 在 事务 内 部 DROP DATABASE (Peter E) 

ecpg 内 存 泄露 修复 (Stephen Birch) 

修复 SELECT null::text, SELECT int4fac(null) and SELECT 2 + (null) (Tom) 
Y2K ARIES (Massimo) 

I$ VACUUM 'HEAP_MOVED_IN 不 是 预期 的 的 错误 (Tom) 

侈 复 带 有 包含 空格 的 表 / 字 段 的 视图 (Tom) 

阻止 在 索引 上 的 权限 (Peter E) 

修复 产生 错误 时 自 旋 锁 卡 住 的 问题 (Hiroshi) 

修复 Linux 上 的 ipcclean 

修复 NULL 约束 条 件 的 处 理 (Tom) 

SS odbc 了 驱动 中 的 内 存 泄露 (Nick Gorham) 

SS UNION 表 上 的 权限 检查 (Tom) 








修复 以 允许 SELECT 'a' LIKE 'a' (Tom) 

修复 SELECT 1 + NULL (Tom) 

修复 CHAR 

修复 数值 类 型 上 的 log() (Tom) 

反对 ':' 和 “';' 操作 符 

人 允许 vacuum 临时 表 

不 允许 继承 的 字段 和 新 字段 的 名 字 相 同 

当 磁盘 空间 被 耗 尽 时 恢复 或 强制 失败 (Hiroshi) 

SS AS 字段 匹配 结果 字段 的 INSERT INTO ... SELECT 

i INSERT ... SELECT ... GROUP BY 以 目标 字段 分 组 而 不 是 以 源 字段 分 组 (Tom) 
收复 CREATE TABLE test (a char(5) DEFAULT text '', b int4) with INSERT (Tom) 
(4 LIMIT 的 UNION 

Š% CREATE TABLE x AS SELECT 1 UNION SELECT 2 

修复 CREATE TABLE test(col char(2) DEFAULT user) 

1 CREATE TABLE ... DEFAULT 中 不 匹配 的 类 型 

修复 SELECT * FROM pg_class where oid in (0, -1) 

( SELECT COUNT('asdf') FROM pg_class WHERE oid=12 








新 增 CLI 接口 包括 文件 sqlcli.h, HF SQL3/SQL98 

删除 所 有 在 查询 长 度 上 的 限制 ， 行 的 长 度 限 制 仍然 存在 (Tom) 

更 新 jdbc 协议 到 2.0 (Jens Glaser <[jens@jens.de](mailto:jens@jens.de)>) 
添加 TRUNCATE 到 快速 截断 关系 (Mike Mascari) 

修复 以 给 予 超级 用 户 和 createdb 用 户 适 当 更 新 目录 的 权限 (Peter E) 

人 允许 ecpg 布尔 变量 有 NULL 值 (Christof) 

如 果 变 量 的 NULL 值 带 有 非 NULL 指示 符 那 么 发 出 ecpg 错误 (Christof) 
允许 AC 取消 COPY 命令 (Massimo) 

添加 SET FSYNC 和 SHOW PG_OPTIONS 命令 (Massimo) 

为 动态 加 载 的 C KAERRA (Frankpitt) 

添加 CmdTuples() 到 libpgq++(Vince) 

新 增 CREATE CONSTRAINT TRIGGER 和 SET CONSTRAINTS 命令 (Jan) 
人 允许 CREATE FUNCTION/WITH 子 句 用 于 所 有 的 语言 类 型 

configure --enable-debug 添加 -g (Peter E) 

configure --disable-debug 删除 -g (Peter E) 

允许 更 复杂 的 缺 省 表达 式 (Tom) 

第 一 个 真正 的 FOREIGN KEY 约束 触发 器 功能 (Jan) 





添加 FOREIGN KEY ... MATCH FULL ... ON DELETE CASCADE (Jan) 
添加 FOREIGN KEY ... MATCH <unspecified> 参照 操作 (Don Baccus) 


允许 在 ctid( 堆 的 物理 位 置 ) 上 的 WHERE 约束 (Hiroshi) 

从 贡献 包 中 移动 pginterface 到 接口 目录 ， 重 命名 为 pgeasy (Bruce) 

改变 pgeasy connectdb() 参数 顺序 (Bruce) 

要 求 SELECT DISTINCT 目标 列表 拥有 所 有 ORDER BY 字段 (Tom) 

添加 Oracle 的 COMMENT ON 命令 (Mike Mascari <[mascarim@yahoo.com](mailto:mascarim@yahoo.cc 

libpq 的 PQsetNoticeProcessor 画 数 现在 返回 先前 的 hook(Peter E) 

阻止 PQsetNoticeProcessor 被 设置 为 NULL (Peter E) 

在 COPY 选项 中 使 USING 可 选 (Bruce) 

允许 在 目标 列表 中 有 子 查询 (Tom) 

允许 子 查 询 在 比较 操作 符 的 左边 (Tom) 

新 增 并 行 回 汶 测试 (Jan) 

改变 后 端的 COPY 写 入 文件 权限 为 644 而 不 是 666 (Tom) 

强制 PGDATA 目录 上 的 权限 为 安全 的 ， 即 使 它 仍然 存在 (Tom) 

添加 psql LASTOID 变量 以 返回 最 后 继承 的 oid (Peter E) 

允许 并 发 的 vacuum 和 删除 pg_vlock vacuum 锁 文 件 (Tom) 

A vacuum 添加 权限 检查 (Peter E) 

新 增 libpq WAAR HEE : PQconnectStart(), 
PQconnectPoll(), PQresetStart(), PQresetPoll(), PQsetenvStart(), 
PQsetenvPoll(), PQsetenvAbort (Ewan Mellor) 

新 增 libpq PQsetenv() Ez (Ewan Mellor) 

创建 /更 改 用 户 扩展 (Peter E) 

在 $PGDATA 下 新 增 postmaster.pid 和 postmaster.opts (Tatsuo) 

为 创建 /删除 用 户 /数据 库 新 增 脚 本 (Peter E) 

详细 检查 主要 的 psql (Peter E) 

添加 常量 到 libpq 接口 (Peter E) 

新 增 libpq EA PQoidValue (Peter E) 

显示 特定 的 非 聚集 导致 的 GROUP BY 问题 (Tom) 

改变 pg_shadow 重新 创建 pg_pwd 文件 (Peter E) 

添加 aggregate(DISTINCT ...) (Tom) 

允许 标识 控制 ”NULL 的 COPY 输入 /输出 (Peter E) 

使 postgres 用 户 有 缺 省 的 口令 (Peter E) 

添加 CREATE/ALTER/DROP GROUP (Peter E) 

所 有 管理 脚本 现在 支持 --long 选项 (Peter E, Karel) 





Vacuumdb 脚本 现在 支持 --all 选项 (Peter E) 

ecpg 新 增 轻 便 的 FETCH 语法 

添加 ecpg EXEC SQL IFDEF, EXEC SQL IFNDEF, EXEC SQL ELSE, EXEC SQL ELIF 
和 EXEC SQL ENDIF 指令 

添加 pg_ctl 脚本 以 控制 后 端 启动 (Tatsuo) 

添加 postmaster.opts.default 文件 以 存储 启动 标识 (Tatsuo) 

人 允许 --with-mb=SQL_ASCII 

增加 索引 键 的 最 大 数量 到 16 (Bruce) 

增加 函数 参数 的 最 大 数量 到 16 (Bruce) 

允许 配置 索引 键 和 参数 的 最 大 数量 (Bruce) 

允许 非特 权 的 用 户 改变 他 们 的 口令 (Peter E) 

启用 口令 认证 ; 新 用 户 需要 (Peter E) 

不 允许 删除 用 于 数据 库 的 用 户 (Peter E) 

改变 initdb 选项 --with-mb # --enable-multibyte 

添加 initdb 选项 以 为 超级 用 户 提示 口令 (Peter E) 

iR col: :numeric(9,2) 和 col::int2::float8 这 样 的 复杂 类 型 转换 (Tom) 

在 initdb, initlocation, pg_dump, ipcclean 上 升级 用 户 接口 (Peter E) 

新 增 pg_char_to_encoding() 和 pg_encoding_to_char() Wa (Tatsuo) 

libpq 非 阻塞 模式 (Alfred Perlstein) 

改善 在 没有 声明 长 度 的 计算 中 的 类 型 的 转换 

新 增 plperl 内 部 编程 语言 (Mark Hollomon) 

允许 COPY IN 读 取 不 以 一 个 新 行 结束 的 文件 (Tom) 

当 长 的 标识 符 被 截断 时 提示 (Tom) 

允许 聚集 使 用 类 型 等 价 (Peter E) 

人 允许 Oracle 的 to_char(), to_date(), to_datetime(), to_timestamp(), to_number() 443#EN2 (Ki 

添加 SELECT DISTINCT ON (expr [, expr ...]) targetlist ... (Tom) 

检查 以 确保 ORDER BY 和 DISTINCT 操作 一 臻 (Tom) 

添加 NUMERIC 和 ints 类 型 到 ODBC 

A% Append, Group, Agg, Unique 的 EXPLAIN 结果 (Tom) 

添加 ALTER TABLE ... ADD FOREIGN KEY (Stephan Szabo) 

在 PL/pgSQL 中 人 允许 SELECT .. FOR UPDATE (Hiroshi) 

启用 后 端 顺序 扫描 ， 即 使 到 达 了 EOF (Hiroshi) 

添加 布尔 值 的 btree 索引 ，>= 和 <= (Don Baccus) 

当 COPY FROM 失败 时 打印 当前 行 的 编号 (Massimo) 

识别 出 POSIX 时 区 ， 如 "PST+8" 和 "GMT-8" (Thomas) 

添加 DEC 作为 DECIMAL 的 同义词 (Thomas) 

添加 SESSION_USER 作为 SQL92 的 关键 字 ， 和 CURRENT_USER 相同 (Thomas) 

改善 SQL92 字段 别名 (aka 相关 名 字 ) (Thomas) 

改善 SQL92 连接 语法 (Thomas) 

使 INTERVAL 的 保留 字 作为 一 个 字段 标识 符 被 允许 (Thomas) 

实现 REINDEX 命令 (Hiroshi) 

ERM SUM(ALL col) 中 接受 ALL (Tom) 

阻止 GROUP BY 使 用 字段 别名 (Tom) 

新 增 psql \encoding 选项 (Tatsuo) 

当 在 waiting-for-lock 状态 时 允许 PQrequestCancel() 终止 (Hiroshi) 

在 所 有 情况 下 人 允许 负数 的 否定 

添加 ecpg HW (Christof, Michael) 

允许 CREATE VIEW v AS SELECT f1::char(8) FROM tbl 

允许 带 有 长 度 的 转换 ， 如 foo::char(8) 

新 增 libpq Be PQsetClientEncoding(), PQclientEncoding() (Tatsuo) 

添加 SJIS 用 户 定义 字符 支持 (Tatsuo) 

大 的 视图 /规则 支持 

使 libpq 的 PQconndefaults() 线程 安全 (Tom) 

禁用 // 作为 注释 以 符合 ANSI， 应 该 使 用 -- (Tom) 

允许 在 视图 的 CREATE VIEW name 上 使 用 字段 别名 (collist) 

修复 带 有 子 查询 的 视图 (Tom) 

允许 UPDATE table SET fld = (SELECT ...) (Tom) 

SET 命令 选项 不 再 需要 引号 

升级 pgaccess 到 0.98.6 

新 增 SET SEED 命 兮 

新 增 pg _options.sample 文件 

新 增 SET FSYNC 命令 (Massimo) 

当 创建 表 时 人 允许 pg_descriptions 

当 创 建 类 型 、 字 段 和 画 数 时 允许 pg_descriptions 

人 允许 psql \copy 以 允许 分 隔 符 (Peter E) 

允许 psql 打印 null 以 区 别 "" [null] (Peter E) 





修复 了 许多 数组 (Tom) 
允许 空 的 字段 名 作为 数组 的 下 标 (Tom) 
改善 int 和 float 常量 的 类 型 转换 (Tom) 


清理 int8 输入 、 范 围 检 查 和 类 型 转换 (Tom) 

修复 SELECT timespan('21:11:26'::time) (Tom) 
netmask('x.x.x.x/@') 是 255.255.255.255 而 不 是 0.0.0.0 (Oleg Sharoiko) 
在 NUMERIC 上 添加 btree 索引 (Jan) 

含有 NUL 字符 的 大 对 象 的 perl 修复 (Douglas Thomson) 

大 对 象 的 ODBC 修复 (free) 

修复 cidr 数据 类 型 的 索引 

修复 以 太 网 MAC 地 址 (macaddr 类 型 ) 比 较 

当 在 计算 中 发 生 浴 出 时 修复 日 期 /时 间 类 型 (Tom) 

允许 int8 上 的 数组 (Peter E) 

修复 NUMERIC 类 型 的 舍 入 / 浴 出 ， 如 NUMERIC(4,4) (Tom) 

允许 NUMERIC 数组 

修复 NUMERIC ceil() 和 floor() HARA bug (Tom) 

使 char_length()/octet_length 包含 结尾 空白 (Tom) 

使 abstime/reltime 使 用 int4 而 不 是 time_t (Peter E) 

为 压缩 的 文本 字段 新 增 lztext 数据 类 型 

修正 代码 以 处 理 强制 的 int 和 float 常量 (Tom) 

在 新 的 代码 开始 实现 BIT 和 BIT VARYING 类 型 (Adriaan Joubert) 
NUMERIC 现在 接受 科学 计数 法 (Tom) 

NUMERIC 到 int4 的 圆 整 (Tom) 

适当 的 转换 float4/8 到 NUMERIC (Tom) 

允许 NUMERIC 的 类 型 转换 (Thomas) 

使 ISO 数据 类 型 (2000-02-16 09:33) 为 缺 省 (Thomas) 

添加 NATIONAL CHAR [ VARYING ] (Thomas) 

允许 NUMERIC 圆 整 和 截断 以 接受 负 的 标 度 (Tom) 

新 增 TIME WITH TIME ZONE 类 型 (Thomas) 

在 时 间 类 型 上 添加 MAX()/MIN() (Thomas) 

为 int8 添加 abs(), mod(), fac() (Thomas) 

为 floats 重 命名 贺 数 为 round(), sqrt(), cbrt(), pow() (Thomas) 
为 floats RIERA AK (A sin(), acos()) (Thomas) 

为 NUMERIC 类 型 添加 exp() 和 1n() 

重 命名 NUMERIC power() 为 pow() (Thomas) 

改进 了 TRANSLATE() W% (Edwin Ramirez, Tom) 

允许 X=-Y 运算 符 (Tom) 

允许 SELECT float8(COUNT(*))/(SELECT COUNT(*) FROM t) FROM t GROUP BY f1; (Tom) 
允许 LOCALE 在 正则 表达 式 搜索 中 使 用 索引 (Tom) 

允许 功能 性 索引 的 创建 使 用 缺 省 的 类 型 





阻止 带 有 许多 AND 和 OR 的 指数 空间 消耗 (Tom) 

收集 系统 字段 的 属性 选择 值 (Tom) 

减少 聚集 的 内 存 使 用 (Tom) 

修复 LIKE 最 优化 以 使 用 带 有 多 字 节 编码 的 索引 (Tom) 
修复 r-tree 索引 优化 器 选择 性 (Thomas) 

改善 优化 器 选择 性 计算 和 功能 (Tom) 

优化 许多 相等 键 存在 的 btree 搜索 (Tom) 

只 在 索引 存在 时 启用 快速 LIKE 索引 进程 (Tom) 

再 次 利用 带 有 多 重 记录 的 索引 页 的 自由 空间 (Tom) 
改善 哈 希 连接 进程 (Tom) 

如 果 结 果 已 经 排序 ， 那 么 阻止 降序 排序 (Hiroshi) 

允许 索引 扫描 查询 限制 条 件 的 交换 (Tom) 

在 需要 ORDER BY/GROUP BY 的 情况 下 更 喜欢 索引 扫描 (Tom) 
为 性 能 分 配 大 量 内 存 请 求 固定 尺寸 的 块 (Tom) 

通过 减少 内 存 分 配 请 求 修复 vacuum 的 性 能 (Tom) 
实现 常量 表达 式 简化 (Bernard Frankpitt, Tom) 

使 用 使 用 的 第 二 字段 来 决定 素 引 扫描 的 开始 (Hiroshi) 
在 做 内 部 排序 时 阻止 四 倍 的 使 用 磁 瘟 空间 (Tom) 

通过 调用 更 少 的 函数 快速 的 排序 (Tom) 

创建 系统 索引 匹配 所 有 系统 缓存 (Bruce, Hiroshi) 

使 系统 缓存 使 用 系统 索引 (Bruce) 

使 所 有 系统 索引 唯一 (Bruce) 

为 vacuum 速度 提升 改进 pg_statistics BH (Tom) 
较 低 频率 的 刷新 后 端 缓存 (Tom, Hiroshi) 

COPY 现在 重新 使 用 了 先前 的 内 存 分 配 ， 提 高 了 性 能 (Tom) 
改善 优化 成 本 估算 (Tom) 

改善 优化 器 估算 x > lowbound AND x < highbound 的 范围 查询 (Tom) 
在 适当 的 地 方 使 用 DNF 而 不 是 CNF (Tom, Taral) 
进一步 清理 OR-of-AND WHERE-clauses (Tom) 

在 OR 子 句 (x = 1 AND y = 2) OR (x = 2 AND y = 4) 中 使 用 索引 (Tom) 
智能 优化 器 计算 随机 索引 页 访问 (Tom) 

新 增 SET 变量 控制 优化 器 开销 (Tom) 





优化 器 查询 基于 LIMIT, OFFSET, #1 EXISTS 限制 条 件 (Tom) 
减少 优化 器 链接 路 径 的 内 部 开支 以 加 速 (Tom) 

主要 的 子 查询 加 速 (Tom ) 

当 没 有 禁用 fsync 时 较 少 的 fsync SA (Tom) 

改善 LIKE 优化 器 估算 (Tom) 

在 只 有 SELECT 的 查询 中 阻止 fsync (Tom) 

使 索引 创建 使 用 psort 代码 ， 因 为 现在 它 更 快速 (Tom) 

允许 创建 临时 表 > 1 Gig 的 排序 


源 代码 树 的 变化 

修复 linux PPC 编译 

新 增 一 般 的 expression-tree-walker 子 程序 (Tom) 

更 改 form() 为 varargform() 以 阻止 可 能 的 问题 

为 ALphas 上 的 大 整数 改善 范围 检查 

清除 /include 目录 中 的 #include (Bruce) 

为 检查 包含 添加 脚本 (Bruce) 

从 *.c 文件 中 删除 不 需要 的 #include (Bruce) 

EA #include 按 情况 使 用 <> 和 "" (Bruce) 

启用 Windows 的 libpq 编译 

来 自 Uncle George <[gatgul@voicenet.com](mailto:gatgul@voicenet.com)> 的 Alpha 自 旋 锁 修 复 
彻底 检修 优化 器 数据 结构 (Tom ) 

修复 cygipc 库 (Yutaka Tanida) 

人 允许 pgsql 工作 在 新 的 Cygwin 快照 上 (Dan) 

新 增 目录 版 本 号 (Tom) 

添加 Linux ARM 

重 命名 heap_replace 为 heap_update 

更 新 QNX (Dr. Andreas Kardos) 

新 增 特 定 于 平台 的 回 为 处 理 (Tom) 

重 命名 oid8 -> oidvector 和 int28 -> int2vector (Bruce) 
包含 所 有 yacc 和 lex 文件 到 发 布 中 (Peter E.) 

删除 不 再 需要 的 lextest (Peter E) 

修复 在 Windows 上 的 libpq 和 psql (Magnus) 

内 部 改变 datetime 和 timespan 为 timestamp 和 interval (Thomas ) 
在 BSD/OS 上 修复 plpgsql 

添加 SQL_ASCII 测试 案例 到 回 为 测试 (Tatsuo) 

configure --with-mb 现在 废弃 了 (Tatsuo) 

修复 了 NT 

修复 了 NetBSD (Johnny C. Lam <[lamj@stat.cmu.edu] (mailto:lamj@stat.cmu.edu)>) 
修复 Alpha 编译 

新 增多 字 节 编码 


_ 





E.223. 版 本 6.5.3 


发 布 日 期 : 1999-10-13 


这 是 基本 上 是 一 个 6.5.2 的 净化 版 。 我 们 添加 了 一 些 在 6.5.2 中 丢失 的 PgAccess， HABA 
了 一 个 NT 特定 的 补丁 。 


E.223.1. 迁移 到 版 本 6.5.3 


运行 6.5.* 的 用 户 不 需要 转 储 /恢复 。 


E.223.2. 修改 列表 


升级 版 本 的 pgaccess 0.98 
NT 相关 的 补丁 
修补 了 在 继承 表 里 的 转 储 规则 


E.224. 版 本 6.5.2 


发 布 日 期 : 1999-09-15 


这 基本 是 一 个 6.5.1 的 净化 版 。 我 们 修复 了 许多 6.5.1 的 用 户 报告 的 问题 。 


E.224.1. 迁移 到 版 本 6.5.2 


运行 6.5.* 的 用 户 不 需要 转 储 /恢复 。 


E.224.2. 修改 列表 


($7 subselect+CASE (Tom) 

为 solaris_i386 和 solaris_sparc 端口 添加 了 SHLIB_LINK 设置 (Daren Sefcik) 
修复 了 在 WHERE 连接 子 句 中 的 CASE (Tom) 

修复 了 BTScan Pit (Tom) 

收复 对 多 余 的 UNIQUE 和 PRIMARY KEY 索引 的 检查 (Thomas) 

改善 使 其 检查 多 字段 约束 (Thomas ) 

修复 Windows 下 启用 MB 的 问题 (Hiroki Kataoka) 

允许 BSC yacc 和 bison 编译 pl 代码 (Bruce) 

(SS SET NAMES 工作 

BST int8 (Thomas) 

IS vacuum 的 内 存 消耗 (Hiroshi, Tatsuo) 

减少 vacuum 的 总 内 存 消耗 (Tom) 

iS timestamp(datetime) 

MLM AAD bug 修复 (Tom) 

iS mkMakefile.tcldefs.sh.in 和 mkMakefile.tkdefs.sh.in 中 的 引用 问题 (Tom) 
重新 使 用 vacuum 在 索引 页 上 释放 的 空间 (Vadim) 

A pg_dump 记录 -x (Bruce) 

SS MM Wa Nas PAY — TCHR ER (Tom) 

注释 掉 在 mdtruncate() 期 间 超过 分 段 的 FileUnlink (Tom) 

ISS LIKE 中 的 逻辑 错误 : 当 在 到 达 文 本 的 结尾 之 前 到 达 模 式 的 结尾 时 不 应 该 返回 LIKE_ABORT (Tom) 
修复 在 事务 中 止 期 间 对 堆栈 内 存 分 配 的 不 正确 的 清理 (Tom) 

升级 pgaccess 0.98 的 版 本 





E.225. 版 本 6.5.1 


发 布 日 期 : 1999-07-15 


这 基本 上 是 一 个 6.5 的 净化 版 本 。 我 们 修复 了 一 系列 6.5 用 户 报告 的 问题 。 


E.225.1. 迁移 到 版 本 6.5.1 


运行 6.5 的 用 户 不 需要 转 储 / 恢 复 。 


E.225.2. 修改 列表 


添加 NT README 文件 

linux_ppc, IRIX, linux_alpha, OpenBSD, alpha 的 可 移植 性 修复 
删除 QUERY_LIMIT， 使 用 SELECT., .LIMIT 

修复 EXPLAIN 的 继承 (Tom) 

允许 在 多 节 的 表 上 vacuum 的 补丁 (Hiroshi) 
R-Tree 优化 器 选择 性 修复 (Tom) 

ACL 文件 描述 符 泄 露 修复 (Atsushi Ogawa) 

新 增 表 达 式 子 树 代码 (Tom) 

避免 只 读 事务 的 磁盘 写 入 (Vadim) 

如 果 最 后 一 个 事务 失败 了 修复 对 临时 表 的 删除 (Bruce) 
修复 了 阻止 创建 太 大 的 行 (Bruce) 

plpgsql 修复 

允许 端口 号 的 范围 为 32k - 64k(Bruce) 

添加 ^ 优先 级 (Bruce) 

重 命名 分 类 文件 pg_temp 为 pg_sorttemp (Bruce) 
修复 时 间 值 中 的 微 秒 (Tom) 

教程 来 源 清理 

新 增 linux_m68k 端口 

修复 NULL 在 某 些 情况 下 的 排序 (Tom) 
共享 库 依赖 性 修复 (Tom) 

固定 故障 影响 子 查询 中 的 GROUP BY (Tom) 

修复 了 一 些 编译 器 警告 (Tomoaki Nishiyama) 

添加 Win1250 (Czech) 支持 (Pavel Behal) 


E.226. 版 本 6.5 


发 布 日 期 : 1999-06-09 


这 个 版 本 标志 着 开发 队伍 对 从 伯克利 继承 过 来 的 代码 的 掌握 和 理解 达到 了 一 个 新 的 阶段 。 你 
将 看 到 现在 我 们 更 容易 增加 新 的 特性 ， 这 些 得 益 于 我 们 全 世界 开发 队伍 的 不 断 壮大 和 经 验 的 
不 断 丰 富 。 


下 面 是 一 些 最 引 人 注 意 的 改变 的 简介 : 
多 版 本 并 行 控制 (MVCC) 


这 个 东西 废止 了 我 们 老式 的 表 级 别 的 锁 ， 取 而 代 之 的 是 一 个 比 大 多 数 商用 数据 库 系 统 都 先进 

的 锁 系 统 。 在 传统 的 系统 里 ， 每 行 的 修改 是 先 锁 住 ， 直 到 提交 ， 以 此 避免 被 其 他 用 户 读 取 。 

MVCC 利用 PostgreSQL 天 生 的 多 版 本 特性 允许 读者 在 写 活 动 中 继续 读 取 一 致 的 数据 。 写 入 
者 继续 使 用 紧凑 的 pg_log 事务 系统 。 所 有 这 些 都 是 在 不 需要 为 每 行 分 配 一 个 锁 〈 像 传统 的 数 
据 库 系统 那样 ) 的 情况 下 进行 的 。 因此 ， 基 本 上 我 们 不 再 受制 于 简单 的 表 级 别 锁 ; 我 们 有 比 
行 级 别 锁 更 好 的 技术 。 


pg_dump 的 热 各 份 


pg_dump 利用 了 新 的 MVCC 特性 ， 可 以 在 数据 库 保 持 在 线 和 可 以 执行 查询 的 情况 下 ， 进 行 
一 致 的 数据 转 储 /备份 。 


数值 数据 类 型 

我 们 现在 有 了 真正 的 数值 数据 类 型 ， 可 以 由 用 户 定 义 精度 。 

临时 表 

我 们 保证 临时 表 在 一 次 数据 库 会 话 过 程 中 唯一 ， 并 且 在 会 话 结束 时 删除 。 
新 的 SQL 特性 


我 们 现在 有 了 CASE, INTERSECT 和 EXCEPT 语句 支持 。 我 们 有 了 新 的 LIMIT/OFFSET， 
SET TRANSACTION ISOLATION LEVEL, SELECT ... FOR UPDATE 和 一 个 改进 了 的 
LOCK TABLE AS. 


提速 


感谢 我 们 队伍 里 的 许多 联 明 的 头脑 ， 我 们 继续 给 PostgreSQL 提速 。 我 们 加 速 了 存储 器 分 
配 ， 优 化 ， 表 联合 以 及 行 传输 过 程 。 


端口 


我 们 继续 扩展 我 们 的 端口 列表 ， 这 回 包括 了 Windows NT/ix86 and NetBSD/arm32。 


界面 
大 多 数 界面 有 了 新 的 版 本 ， 现 有 的 功能 也 被 改进 了 。 
文档 


在 这 个 文档 里 所 有 地 方 都 有 新 的 和 更 新 了 的 内 容 。 新 的 FAQ 已 经 分 配 到 了 SGI 和 AIX 平 
台 。 教程 里 包含 了 来 自 Stefan Simkovics 的 关于 SQL 的 介绍 性 信息 。 对 于 用 户 手 册 ， 我 们 
包括 了 关于 postmaster 和 更 多 工具 程序 的 参考 内 容 ， 还 有 一 个 描述 日 期 时 间 详 细 特 性 的 附 
件 。 管 理 员 手册 包含 了 一 个 Tom Lane 的 新 的 关于 错误 分 析 的 章节 。 程 序 员 手册 包括 了 
Stefan 写 的 查询 处 理 的 描述 ， 以 及 通过 匿名 CVS 和 CVSup 获 取 PostgreSQL 源码 树 的 详细 
内 容 。 


E.226.1. 迁移 到 版 本 6.5 


要 想 从 以 前 的 PostgreSQL 版 本 迁移 到 新 的 版 本 ， 我 们 需要 用 pgdump 进行 转 储 /恢复 的 工 
VE. 不 能 用 pg_upgrade 升级 到 这 个 版 本 ， 因为 和 以 前 版 本 相 比 ， 表 在 磁盘 上 的 〈 存 储 ) 
结构 已 经 经 过 修改 了 。 


新 的 多 版 本 并 发 控制 (MVCC) 特性 在 多 用 户 环境 里 可 能 有 一 些 不 同 的 表现 。 阅读 并 理解 下 
面 段 落 ， 确 保 你 现 有 的 应 用 将 表现 出 你 所 希望 的 特性 。 


E.226.1.1. 多 版 本 并 发 控制 


因为 不 管事 务 的 隔离 级 别 是 什么 ，6.5 里 的 读 动作 不 锁定 数据 ， 一 个 事务 读 的 数据 可 能 被 其 
他 事务 覆盖 。 换 句 话说 ， 如 果 SELECT 返回 了 一 行 并 不 意味 着 该 行 在 被 返回 的 时 候 (也 就 是 
说 在 语句 或 者 事务 开始 后 的 某 个 时 间 ) 真正 存在 ， 也 不 意味 着 在 当前 事务 做 提交 或 者 回 滚 之 
前 该 行 被 保护 免 于 被 并 行事 务 删除 或 者 修改 。 


要 保证 一 行 的 确实 存在 并 且 保 护 它 免 于 被 并 行 更 新 ， 我 们 必须 使 用 SELECT FoR UPDATE 或 一 
个 合适 的 Lock TABLE 语句 。 我 们 在 从 以 前 的 PostgreSQL 和 其 他 环境 移植 应 用 时 必须 考虑 这 


IWNO 


如 果 你 正 用 contrib/refint.* 触发 器 保证 参考 完整 性 ， 你 就 必须 记 住 上 面 几 条 。 现 在 还 需要 
额外 的 技巧 。 一 个 方法 是 : 如 果 一 个 事务 准 各 更 新 /删除 一 个 主键 时 ， 使 用 
LOCK parent_table IN SHARE ROW EXCLUSIVE MODE AS, 如 果 一 个 事务 准 各 更 新 /插入 一 个 外 


键 时 使 用 Lock parent_table IN SHARE MODE 命令。 








Note: 要 注意 如 果 你 运行 一 个 处 于 SERIALIZABLE 模式 下 的 事务 ， 在 该 事务 里 ， 你 必须 
在 执行 任何 DML 语句 ( SELECT/INSERT/DELETE/UPDATE/FETCH/COPY_TO ) 之 前 执行 上 面 提 


到 的 Lock 命令。 


这 些 不 便 将 在 今后 我 们 实现 了 读 脏 (未 提交 ) 数据 的 能 力 (不 管 什 么 隔离 级 别 ) 和 真正 的 参 
考 完 整 性 后 消失 。 


E.226.2. 修改 列表 


ISS text<->float8 和 text<->float4 $i (Thomas) 
侈 复 带 有 混合 约束 的 情况 创建 表 (Billy) 

改变 exp()/pow() 的 行为 以 在 下 浴 / 浴 出 时 产生 错误 (Jan) 
修复 pg_dump -z 中 的 bug 

内 存 浴 出 清理 (Tatsuo) 

修复 lo_import 崩溃 (Tatsuo) 

ASG BAW RELIES (Thomas) 

使 用 类 型 转换 匹配 字段 和 DEFAULT (Thomas) 

修复 死 锁 ， 这 样 它 只 在 一 秒 钟 的 休眠 之 后 检查 一 次 (Bruce) 
侈 复 聚 集 和 PL/pgsql (Hiroshi) 

SSF MAAR (Vadim) 

SS libpq HR PQfnumber 和 大 小 写 敏 感 的 名 字 (Bahman Rafatjoo) 
收复 大 对 象 的 write-in-middle， 没 有 额外 的 阻塞 、 内 存 消耗 (Tatsuo) 
IS pg_dump -d 或 -D 和 在 INSERT 中 引用 特殊 字符 
iS dynahash 的 严重 的 问题 (Tom) 

(SS INET/CIDR 可 移植 性 问题 

修复 ALTER TABLE ADD COLUMN 中 的 可 选择 性 错误 问题 (Bruce) 
侈 复 执 行 器 使 不 同 字 段 类 型 的 合并 连接 能 够 工作 (Tom) 

iS Alpha OR 选择 性 bug 

ISS OR 索引 选择 性 问题 (Bruce) 

SS so \d 显示 char()/varchar() 的 固有 长 度 (Ryan) 
修复 教程 代码 (Clark) 

提高 destroyuser 检查 (Oliver) 

修复 Kerberos (Rodney McDuff) 

修复 当 缓冲 区 脏 了 时 删除 数据 库 (Bruce) 

修复 nextval() 序列 可 以 大 小 写 敏感 (Bruce) 

SH ! != 运算 符 

在 破坏 数据 库 文件 之 前 删除 缓冲 区 (Bruce) 

路 复 执行 器 估算 函数 两 次 的 情况 (Tatsuo) 

人 允许 序列 的 下 一 行动 作 大 小 写 敏感 (Bruce) 

侈 复 优 化 器 索引 不 为 负数 工作 (Bruce) 

SH fjIsNull 执行 器 内 的 内 存 泄露 

眉 复 聚集 的 内 存 泄露 (Erik Riedel) 

允许 用 户 名 包含 一 个 破 折 号 来 授予 权限 

清理 inet 类 型 中 的 NULL 

清理 系统 表 bug (Tom) 

修复 PAGER 和 \? 命令 的 问题 (Masaaki Sakaida) 
降低 缺 省 多 段 文 件 大 小 限制 为 16B (Peter) 

I CREATE OPERATOR 的 转 储 (Tom) 
修复 游标 的 向 后 扫描 (Hiroshi Inoue) 

修复 使 用 \i 时 的 COPY FROM STDIN (Tom) 

修复 在 一 个 表达 式 之 内 比较 的 subselect (Jan) 

牙 复 返回 行 时 错误 报告 的 处 理 (Tom) 

修复 参考 数组 类 型 的 问题 (Tom, Jan) 

阻止 UPDATE SET oid (Jan) 

(SS pg_dump 使 -t 选项 可 以 处 理 大 小 写 敏 感 的 表 名 

侈 复 特殊 情况 下 的 GROUP BY (Tom, Jan) 

侈 复 失 败 查询 中 的 内 存 泄 露 (Tom) 

DEFAULT 现在 支持 混合 情况 的 标识 符 (Tom) 

IS DROP/RENAME 表 、 索 引 的 多 节 的 使 用 (Ole Gjerde) 
使 用 -o 和 -d 选项 禁用 pg_dump 的 使 用 (Bruce) 

允许 pg_dump 适当 的 转 储 组 权限 (Bruce) 

I INSERT INTO table SELECT * FROM table2 中 的 GROUP BY (Jan) 
侨 复 视图 中 的 计算 (Jan) 

修复 数组 索引 上 的 聚集 (Tom) 

侨 复 在 需要 太 多 引号 的 值 内 DEFAULT 义理 单 引 号 

侈 复 非 超级 用 户 导 和 人 /导出 大 对 象 的 安全 问题 (Tom) 

回 滚 创建 表 被 适当 的 清理 的 事务 (Tom) 

侈 复 允 许 大 表 和 字段 名 产生 适当 的 序列 名 (Tom) 











添加 "vacuumdb" 工具 
通过 更 好 的 分 配 存储 器 加 速 libpq (Tom) 
EXPLAIN 所 有 使 用 的 索引 (Tom) 


实现 CASE, COALESCE, NULLIF 表达 式 (Thomas) 

新 增 pg_dump 表 输 出 格式 (Constantin) 

添加 字符 串 min()/max() BM (Thomas) 

扩展 新 的 类 型 强制 转换 技术 到 聚集 中 (Thomas) 

新 增 moddatetime 贡献 包 (Terry) 

升级 到 pgaccess 0.96 (Constantin) 

为 单字 节 "char" 类 型 添加 例 程 (Thomas ) 

改善 substr() Ba (Thomas) 

改善 多 字 节 处 理 (Tatsuo) 

多 版 本 并 发 控制 /MVCC (Vadim) 

新 增 序列 化 模式 (Vadim) 

修复 超过 2gigs 的 表 (Peter) 

新 增 SET TRANSACTION ISOLATION LEVEL (Vadim) 

新 增 LOCK TABLE IN ... MODE(Vadim) 

升级 ODBC 驱动 程序 (Byron) 

新 增 NUMERIC 数据 类 型 (Jan) 

新 增 SELECT FOR UPDATE(Vadim) 

处 理 输 入 值 的 "NaN" 和 "Infinity" (Jan) 

改善 日 期 /年 的 处理 (Thomas) 

改善 后 端 连 接 的 处 理 (Magnus) 

为 大 文件 新 增 ELOG_TIMESTAMPS 和 USE_SYSLOG 选项 (Massimo) 
新 增 TCL_ARRAYS 选项 (Massimo) 

新 增 INTERSECT 和 EXCEPT (Stefan) 

为 主键 跟踪 新 增 pg_index.indisprimary (D'Arcy) 

新 增 pg_dump 选项 以 允许 在 创建 之 前 删除 表 (Brook) 

加 速 行 输出 例 程 (Tom) 

新 增 READ COMMITTED 隔离 级 别 (Vadim) 

新 增 TEMP 3/3851 (Bruce) 

如 果 结 果 已 经 排序 那么 阻止 排序 (Jan) 

新 增 内 存 分 配 优 化 (Jan) 

允许 psql 做 \p\g (Bruce) 

允许 多 重 的 规则 动作 (Jan) 

添加 了 LIMIT/OFFSET 功能 (Jan) 

改善 了 连接 大 量 的 表 时 的 优化 器 (Bruce) 

新 增 简 介 到 SQL， 来 自 S. Simkovics 的 硕士 论文 (Stefan, Thomas) 
新 增 简 介 到 后 端 处理 ， 来 自 S. Simkovics 的 硕士 论文 (Stefan) 
改进 了 int8 支持 (Ryan Bradetich, Thomas, Tom) 

新 增 转 换 int8 和 text/varchar 类 型 的 例 程 (Thomas ) 

在 连接 了 meta-tables 的 地 方 新 增 了 严密 的 规划 (Bruce) 

缺 省 启用 右边 的 查询 (Bruce) 

允许 在 配置 时 设置 后 端 可 靠 的 最 大 数目 ( - -with-maxbackends and postmaster switch (-N backends)) (Ton 
GEQO 因为 优化 器 加 速 现 在 缺 省 为 10 个 表 (Tom) 

为 了 MS-SQL 可 移植 性 允许 NULL=Var (Michael, Bruce) 

修改 贡献 包 check_primary_key()， 因 此 都 "自动 的 " 或 "依赖 的 " (Anand) 
允许 psql 在 一 个 视图 上 \d 显示 查询 (Ryan) 

为 LIKE 加 速 (Bruce) 

Ecpg 修复 /特性 ， 查 阅 src/interfaces/ecpg/ChangeLog 文件 (Michael) 
JDBC 修复 /特性 ， 查 阅 src/interfaces/jdbc/CHANGELOG (Peter) 
使 % 运算 符 和 / 一 样 有 优先 级 (Bruce) 

添加 新 的 postgres -0 选项 ， 人 允许 改变 系统 表 结 构 (Bruce) 

更 新 contrib/pginterface/findoidjoins 脚本 (Tom) 
主要 的 加 速 在 于 vacuum 的 删除 带 有 索引 的 行 (Vadim) 

允许 非 SQL 画 数 运行 基于 参数 的 不 同 版 本 (Tom) 

添加 -E 选项 显示 由 \dt 和 朋友 们 发 送 的 实际 查询 (Masaaki Sakaida) 
为 psql 在 启动 标题 中 添加 版 本 号 (Masaaki Sakaida) 

新 增 contrib/vacuumlo 删除 没有 引用 的 大 对 象 (Peter) 

新 增 初 始 化 表 的 大 小 ， 这 样 非 真 空 的 表 执 行 的 更 好 (Tom) 

改善 拒绝 连接 时 的 错误 信息 (Tom) 

支持 数组 的 char() 和 varchar() 字段 (Massimo) 

彻底 检修 哈 希 码 以 增强 可 靠 性 和 性 能 (Tom) 

升级 到 PyGreSQL 2.4 (D'Arcy) 

改变 调试 选项 so -d4 和 -d5 产生 不 同 的 节点 显示 (Jan) 

新 增 pg_options: pretty_plan, pretty_parse, pretty_rewritten(Jan) 
系统 表 访 问 的 更 好 的 优化 统计 (Tom) 

非 缺 省 块 大 小 的 更 好 的 处 理 (Massimo) 

改进 GEQO 优化 器 内 存 消耗 (Tom) 

UNION 现在 支持 不 在 目标 列表 中 的 字段 的 ORDER BY (Jan) 
改进 了 主要 的 libpq++ (Vince Vielhaber) 

pg_dump 现在 使 用 -z(ACL's) 作为 缺 省 (Bruce) 

后 端 缓存 、 内 存 加 速 (Tom ) 

让 pg_dump 在 一 个 快照 事务 中 做 任何 事情 (Vadim) 
修复 大 对 象 内 存 泄露 ， 修 复 pg_dumping (Tom) 





INET 类 型 现在 关心 网 络 掩 码 的 比较 

使 VACUUM ANALYZE 只 使 用 一 个 读 锁 (Vadim) 

人 允许 UNIONS 上 的 VIEW (Jan) 

pg_dump 现在 可 以 在 活动 的 数据 库 上 生成 一 致 的 快照 (Vadim) 


源 代码 树 的 变化 

改进 端口 匹配 (Tom) 

Sun0S 的 可 靠 性 修复 

添加 Windows NT 后 端 端口 和 启用 动态 加 载 (Magnus 和 Daniel Horak) 
新 增 端 口 到 Cobalt Qube(Mips) 运行 Linux (Tatsuo) 
到 NetBSD/m68k 的 端口 (Mr. Mutsuki Nakajima) 

到 NetBSD/sun3 的 端口 (Mr. Mutsuki Nakajima) 

到 NetBSD/macppc 的 端口 (Toshimi Aoki) 

修复 tcl/tk 配置 (Vince) 

为 规则 查询 删除 CURRENT 关键 字 (Jan) 

NT 动态 加 载 现在 可 以 运行 了 (Daniel Horak) 

添加 ARM32 支持 (Andrew McMurry) 

对 HP-UX 11 和 Unixware 的 更 好 的 支持 

改进 文件 处 理 使 其 更 统一 ， 阻 止 文件 描述 符 泄露 (Tom) 

新 增 plpgsql 的 安装 命 合 (Jan) 


A 一 一 





E.227. 版 本 6.4.2 


发 布 日 期 : 1998-12-20 


6.4.1 版 本 的 打包 不 正确 。 这 个 版 本 也 有 一 些 bug 修复 。 
E.227.1. 迁移 到 版 本 6.4.2 
运行 6.4.* 的 用 户 不 需要 转 储 /恢复 。 


E.227.2. 修改 列表 


修复 了 某 些 平台 上 日 期 时 间 常 量 的 问题 (Thomas) 


E.228. 版 本 6.4.1 


发 布 日 期 : 1998-12-18 


这 基本 上 是 6.4 的 一 个 净化 版 本 。 我 们 修复 了 一 些 6.4 的 用 户 报告 的 问题 。 


E.228.1. 迁移 到 版 本 6.4.1 


运行 6.4 的 用 户 不 需要 转 储 /恢复 。 


E.228.2. 修改 列表 


添加 pg_dump -N 标识 强制 双 引 号 包围 标识 符 。 这 是 缺 省 (Thomas) 
修复 where 子 句 中 的 NOT 导致 崩溃 (Bruce) 

EXPLAIN VERBOSE 内 核 转 储 修复 (Vadim) 

修复 Linux 上 的 共享 库 问 题 

修复 表 存 在 的 测试 ， 人 允许 在 表 名 中 存在 混合 大 小 宇和 空格 (Thomas) 
修复 了 两 个 pg_dump bug 

配置 更 好 的 匹配 template/.similar 条 目 (Tom) 

更 改 内 建 画 数 名 SPI_* 为 spi_* 

OR WHERE 子 句 修复 (Vadim) 

修复 了 混合 大 小 写 的 表 名 (Billy) 
contrib/linux/postgres.init.csh/sh 修复 (Thomas) 
libpq 内 存 洽 出 修复 

Sunos 修复 (Tom) 

改变 exp() 的 行为 以 在 下 浴 时 产生 错误 (Thomas) 

修复 pg_dump 内 存 泄露 ， 继 承 约束 ， 布 局 改变 

升级 pgaccess 到 0.93 

为 64 位 平台 修复 原型 

多 字 节 修复 (Tatsuo) 

新 增 ecpg 手册 页 

修复 内 存 浴 出 (Tatsuo) 

修复 lo_import() 崩溃 (Bruce) 

安装 程序 更 好 的 搜索 (Tom) 

时 区 修复 (Tom) 

HP-UX 修复 (Tom) 

使 用 隐 式 的 类 型 转换 以 匹配 DEFAULT 值 (Thomas) 

添加 例 程 以 帮助 单字 节 (内 部 的 ) 字符 类 型 (Thomas) 

为 Windows 修复 编辑 libpq (Magnus) 

升级 到 PyGreSQL 2.2 (D'Arcy) 


E.229. 版 本 6.4 


发 布 日 期 : 1998-10-30 


这 个 版 本 有 许多 新 特性 和 改进 。 感 谢 开 发 者 和 维护 者 ， 与 前 一 个 版 本 相 比 ， 几乎 系统 的 每 个 
方面 都 得 到 了 重视 。 下 面 是 一 个 不 完全 的 概要 : 


感谢 Jan Wieck 为 重 写 规 则 系统 添加 的 新 的 代码 ， 视 图 和 规则 现在 可 以 工作 了 。 他 就 此 
还 为 程序 员 手 册 写 了 一 章 。 

与 他 在 上 一 版 本 提供 的 最 初 的 PL/pgTCL 过 程 语言 一 起 ， Jan 还 提供 了 第 二 种 过 程 语 
=, PL/pgSQL. 


我 们 有 了 可 选 的 多 字 节 字符 集 支 持 ， 是 Tatsuo lishi 提供 的 ， 用 以 完善 我 们 现存 的 本 地 支 
持 。 


感谢 Tom Lane 清理 了 Client/server (客户 /服务 器 ) 通讯 部 分 ， 对 异步 消息 和 中 断 有 了 
更 好 的 支持 . 
分 析 器 现在 会 进行 自动 的 类 型 转换 ， 以 与 现 有 的 操作 符 和 画 数 的 参数 相 匹 配 ， 以 及 与 目 
标 字段 的 字段 (类 型 ) 和 表达 式 匹 配 。 这 是 通过 通用 的 机 制 实现 的 ， 该 机 制 支持 
PostgreSQL 的 类 型 扩展 特性 。 在 用 户 手册 中 有 一 章 介绍 这 个 主题 。 
新 增 了 三 种 数据 类 型 。 其 中 两 种 类 型 inet 和 cidr ， 支持 各 种 各 样 的 IP 网 络 ， 子 网 和 
机 器 寻 址 形式 。 而 且 现 在 在 某 些 平台 上 有 8 字 节 整数 支持 了 。 请 参阅 用 户 手册 中 的 数据 类 
型 章节 获取 详细 信息 。 第 四 种 类 型 ， serial ， 现 在 被 分 析 器 当 作 inta 类 型 ， 序 列 

， 和 唯一 索引 的 混合 物 来 支持 。 


号 
增加 了 更 多 SQL92 兼容 的 语法 特性 ， 包 括 INSERT DEFAULT VALUES o 


自动 配置 和 安装 系统 受到 了 一 定 的 重视 ， 现 在 在 更 多 平台 上 应 该 比 以 前 更 坚固 ， 稳 定 
To 


E.229.1. 迁移 到 版 本 6.4 


要 想 从 以 前 的 PostgreSQL 版 本 迁移 到 新 的 版 本 ， 你 需要 用 pg_dump 或 pg_dumpall 进行 一 
个 转 储 /恢复 的 操作 。 


E.229.2. 修改 列表 


ES PQsetdb/PQfinish 中 微小 的 内 存 泄 露 (Bryan) 


使 用 char/varchar 删除 char2-16 数据 类 型 (Darren) 
Pqfn FX NOTICE 信息 (Anders) 

减少 了 许多 后 端 自 旋 锁 的 busywaiting 开销 (dg) 

自 旋 锁 检测 卡 住 (dg) 

SH "ISO-style" 时 间 间 隔 解 码 和 编码 (Thomas) 

获 复 在 事务 回 滚 之 后 删除 表 的 问题 (Vadim) 

更 改 错误 信息 和 删除 非 功能 性 的 升级 信息 (Vadim) 

IS COPY 数组 检测 

( SELECT 1 UNION SELECT NULL 

SSAKxt RAHA HE (Pascal) 

改变 所 有 者 从 oid 到 int4 类 型 (Bruce) 

SS oracle 兼容 性 函数 btrim() ltrim() 和 rtrim() 中 的 一 个 bug 
修复 共享 的 失效 缓存 浴 出 (Massimo) 

阻止 文件 描述 符 泄漏 到 已 失败 的 COPY (Bruce) 

SS libpgtcl 的 pg_select 中 的 内 存 泄露 (Constantin) 
眉 复 用 户 名 /口令 超过 8 个 字符 的 问题 (Tom) 

修复 在 后 端 处 理 异 步 的 NOTIFY 问题 (Tom) 

修复 许多 损坏 了 的 系统 表 条 目 (Tom) 








升级 ecpg 和 ecpglib, BM src/interfaces/ecpc/ChangeLog(Michael) 
显示 在 一 个 EXPLAIN 中 使 用 的 索引 (Zeugswetter ) 

EXPLAIN 调用 规则 系统 并 显示 重 写 查询 的 规划 (Jan) 

通过 配置 ， 多 字 节 意识 到 许多 数据 类 型 和 画 数 (Tatsuo) 

新 增 configure --with-mb 选项 (Tatsuo) 

新 增 initdb --pgencoding 选项 (Tatsuo) 

新 增 createdb -E multibyte 选项 (Tatsuo) 

Select version(); 现在 返回 PostgreSQL 版 本 (Jeroen) 

libpq 现在 允许 异步 的 客户 端 (Tom) 

允许 取消 客户 端的 后 端 查询 (Tom) 

psql 现在 用 Control-C 取消 查询 (Tom) 

libpq 用 户 不 需要 发 出 虚假 的 查询 来 获取 NOTIFY 信息 (Tom) 

NOTIFY 现在 可 以 发 送 发 送 者 的 PID， 所 以 你 可 以 知道 它 是 否 是 你 自己 的 (Tom) 
PGresult 结构 现在 包括 关联 的 错误 信息 ， 如 果 有 的 话 (Tom) 

定义 "tz_hour" 和 "tz_minute" 参数 到 date_part() (Thomas) 
添加 varchar 和 bpchar 之 间 相 互 转换 的 例 程 (Thomas ) 

添加 人 允许 varchar 和 bpchar 的 大 小 到 目标 字段 的 例 程 (Thomas) 

添加 位 标记 以 在 数据 检索 中 支持 时 区 小 时 和 分 钟 (Thomas ) 

允许 更 多 的 变化 在 浮 点 数 上 (如 ".1", "1e6") (Thomas) 

修复 带 有 前 导 空格 的 一 元 符号 语法 分 析 (Thomas) 

实现 了 TIMEZONE_HOUR，TIMEZONE_MINUTE 每 SQL92 规格 (Thomas) 
检查 并 适当 的 忽略 FOREIGN KEY 字段 约束 (Thomas) 

定义 USER 作为 CURRENT_USER 的 同义词 每 SQL92 规格 (Thomas) 
启用 HAVING 子 句 ， 但 是 在 别处 还 没有 修复 

使 "char" 类 型 是 "char(1)" 的 同义词 (实际 上 是 作为 bpchar 来 实现 ) (Thomas) 
如 果 为 DEFAULT 子 句 处 理 指定 则 保存 字符 串 类 型 (Thomas) 

强制 操作 包括 不 同 的 数据 类 型 (Thomas ) 

允许 一 些 索 引用 于 不 同类 型 的 字段 (Thomas) 

为 自动 类 型 转换 添加 功能 (Thomas ) 

清理 大 对 象 ， 因 此 文件 打开 时 被 截断 (Peter) 

Readline 清理 (Tom) 

允许 psql \f \ 将 空格 作为 分 隔 符 (Bruce) 

为 列 字段 长 度 传 送 pg_attribute.atttypmod 到 前 端 (Tom, Bruce) 
Msql 兼容 库 在 /contrib 中 (Aldrin) 

删除 ORDER/GROUP BY 子 句 标识 符 被 包含 在 目标 列表 中 的 要 求 (David) 
转换 字段 以 匹配 UNION 子 句 中 的 字段 (Thomas) 

删除 fork()/exec() 只 进行 fork() (Bruce) 

Jdbc 清理 (Peter) 

在 ps 命令 行 上 显示 后 端 状 态 (只 在 某 些 平台 上 工作 ) (Bruce) 
Pg_hba.conf 现在 在 数据 库 字 段 中 有 一 个 sameuser 选项 

使 lo_unlink 接受 oid 参数 ， 而 不 是 int4 

为 不 能 处 理 我 们 的 宏 命 命 的 编译 器 新 增 DISABLE_COMPLEX_MACRO (Bruce) 
Libpgtcl 现在 把 NOTIFY 当做 一 个 Tol 事件 处 理 ， 不 需要 发 送 脏 查 询 (Tom) 
libpgtcl 清理 (Tom) 

添加 -error 选项 到 libpgtcl 的 pg_result MS (Tom) 

IBA ERE, BM docs/README/locale (Oleg) 

修复 pg_dump， 因 此 CONSTRAINT 和 CHECK 语法 是 不 正确 的 (ccb) 

为 除去 孤立 的 大 对 象 新 增 contrib/lo 代码 (Peter) 

为 多 字 节 特性 新 增 psql 命令 "SET CLIENT_ENCODING TO 'encoding'", 参阅 /doc/README.mb (Tatsuo) 
contrib/noupdate 代码 以 撤销 在 一 个 字段 上 的 更 新 许可 

libpq 现在 可 以 在 Windows 上 编译 (Magnus) 





在 Libpq 里 添加 PQsetdbLogin() 

新 增 8 字 节 整 数 类 型 ， 为 了 OS 支持 由 配置 校对 (Thomas) 

对 引用 表 / 字 段 名 有 了 更 好 的 支持 (Thomas) 

pg_dump 中 的 表 和 字段 名 由 双 引 号 包围 (Thomas ) 

PQreset() 现在 带 有 口令 工作 (Tom) 

处 理 GROUP BY 目标 列表 字段 编号 超出 范围 的 情况 (David) 
允许 在 子 查询 中 UNION 

添加 auto-size 到 屏幕 的 \d? 命令 (Bruce) 

使 用 UNION 显示 一 个 查询 中 所 有 \d? 的 结果 (Bruce) 

添加 \d? 字段 搜索 特性 (Bruce) 

Pg_dump 发 出 少数 \connect 请求 (Tom) 

使 pg_dump -z 标识 工作 的 更 好 ， 在 手册 页 中 记录 它 (Tom) 

添加 全 力 支 持 子 查询 和 联合 的 HAVING 子 句 (Stephan) 

全 文本 搜索 例 程 在 contrib/fulltextindex 中 (Maarten) 

事务 id 现在 存储 在 共享 内 存 中 (Vadim) 

新 增发 出 COPY 命令 时 的 PGCLIENTENCODING (Tatsuo) 

支持 SQL92 语法 "SET NAMES" (Tatsuo) 

支持 LATIN2-5 (Tatsuo) 

添加 UNICODE 回 为 测试 案例 (Tatsuo) 

锁 住 管理 者 清理 ， 为 LLL 新 增 锁 模式 (Vadim) 

允许 索引 和 OR 子 句 一 起 使 用 (Bruce) 

人 允许 "SELECT NULL ORDER BY 1;" 

Explain VERBOSE 打印 规划 ， 现 在 倾向 于 打印 规划 到 主 进程 日 志文 件 (Bruce ) 
添加 索引 显示 到 \d 命令 (Bruce) 

允许 在 函数 上 GROUP BY (Bruce) 

为 大 对 象 新 增 pg_class.relkind (Bruce) 

新 的 方式 发 送 libpq NOTICE 信息 到 不 同 的 位 置 (Tom) 

新 增 w 写 入 命令 到 psql (Bruce) 

新 增 /contrib/findoidjoins 扫描 oid 字段 以 找 出 连接 关系 (Bruce) 
当 为 包含 一 个 常量 的 约束 子 句 检 查 有 效 索 引 时 人 允许 被 认为 是 二 进 制 兼容 的 索引 (Thomas) 
在 /contrib/isbn_issn 中 新 增 ISBN/ISSN 代码 

人 允许 NOT LIKE, IN, NOT IN，BETWEEN， 和 NOT BETWEEN 约束 (Thomas ) 
新 的 重 写 系 统 修复 了 许多 规则 和 视图 的 问题 (Jan) 

关系 上 的 规则 可 以 工作 了 

在 insert/update/delete 上 的 事件 限制 可 以 工作 了 

新 增 OLD 变量 引用 CURRENT, CURRENT 将 在 将 来 删除 

更 新 规则 可 以 在 规则 限制 /动作 中 引用 NEW 和 0LD 

在 视图 上 的 Insert/update/delete 可 以 工作 了 

现在 支持 多 规则 动作 了 ， 由 圆 括号 包围 

固定 用 户 可 以 在 他 们 有 RULE 许可 的 表 上 创建 视图 /规则 

规则 和 视图 继承 创建 者 的 权限 

没有 规则 是 字段 级 别 的 

没有 UPDATE NEW/OLD 的 规则 

新 增 pg_tables, pg_indexes, pg_rules 和 pg_views MAMA 
在 SELECT 规则 上 只 有 一 个 单一 动作 

完全 重 写 改 革 ， 可 能 是 为 了 6 .5 

处 理子 查询 

处 理 视 图 上 的 聚集 

处 理 insert into select from view 工作 了 

系统 索引 现在 是 多 键 的 (Bruce) 

删除 了 Oidint2, oidint4, #1 oidname 类 型 (Bruce) 

为 更 多 系统 表 查 找 使 用 系统 缓存 (Bruce) 

在 backend/pl 中 新 增 后 端 编程 语言 PL/pgSQL (Jan) 

新 增 SERIAL 数据 类 型 ， 自 动 创建 序列 /索引 (Thomas) 

启用 不 带 有 重新 编译 的 维护 检查 (Massimo) 

用 户 锁 增 强 (Massimo) 

新 增 setval() 命令 设置 序列 值 (Massimo) 

如 果 没 有 主 进 程 正在 运行 ， 那 么 在 启动 时 自动 删除 unix 套 接 字 文件 (Massimo) 
ARFHRRAR (Massimo) 

新 增 UNLISTEN 命令 (Massimo) 

psql 和 libpq 现在 在 Windows 下 使 用 win32.mak 编译 (Magnus) 
Lo_read 不 再 存储 尾随 的 NULL (Bruce) 

标识 符 现在 在 内 部 截断 为 31 为 字符 (Bruce) 

Createuser 选项 现在 在 命令 行 中 可 用 

为 64 为 整数 支持 的 编码 添加 了 ， 配 置 测 试 ，int8 类 型 (Thomas) 
阻止 来 自 失 败 COPY 的 文件 描述 符 页 (Bruce) 

新 增 pg_upgrade #43 (Bruce) 

升级 了 /contrib 目录 (Massimo) 

新 增 CREATE TABLE DEFAULT VALUES 声明 可 用 (Thomas) 

新 增 INSERT INTO TABLE DEFAULT VALUES 声明 可 用 (Thomas) 
新 增 DECLARE 和 FETCH 特性 (Thomas) 

现在 不 再 输出 libpq 的 内 部 构件 (Tom) 
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人 允许 多 达 8 个 键 字 索引 (Bruce) 

删除 ARCHIVE 关键 字 ， 不 再 使 用 它 了 (Thomas) 
pg_dump -n 标记 抑制 包围 标识 符 的 引号 

为 视图 禁用 系统 字段 (Jan) 

为 网 络 地 址 新 增 INET 和 CIDR 类 型 (TomH, Paul) 
在 psql 输出 中 不 再 有 双 引 号 

pg_dump 现在 可 以 转 储 视图 了 (Terry) 

新 增 SET QUERY_LIMIT (Tatsuo, Jan) 


源 代码 树 变 化 

/contrib 清理 (Jun) 

为 每 行内 联 一 些小 的 函数 调用 (Bruce) 

Alpha/linux 修复 

HP-UX 清理 (Tom) 

多 宇 节 回 为 测试 (Soonmyung. ) 

从 配置 中 删除 - -disabled 选项 

定义 PGDOC 以 在 缺 省 情况 下 使 用 POSTGRESDIR 

使 回归 可 选 

删除 pgindent 中 多 余 的 花 括号 代码 (Bruce) 

添加 bsdi 共享 库 支 持 (Bruce) 

新 增 --without-CXX 支持 配置 选项 (Brook) 

新 增 FAQ_CVS 

更 新 tools/backend 中 的 后 端 流程 图 (Bruce) 

将 atttypmod 从 int16 更 改 为 int32 (Bruce, Tom) 
修复 平台 上 没有 Getrusage() 的 问题 (Tom) 

添加 PQconnectdb, PGUSER, PGPASSWORD 到 ]ibpq 手 册页 
NS32K 平台 修复 (Phil Nelson, John Buller) 

SCO 7/UnixWare 2.x (%8 (Billy, others) 
Sparc/Solaris 2.5 修复 (Ryan ) 

Pgbuiltin.3 已 经 废 奔 了 ， 移 动 到 了 doc 文件 中 (Thomas) 
更 多 的 文档 (Thomas) 

Nextstep 支持 (Jacek) 

Aix 支持 (David) 

pginterface 手册 页 (Bruce) 

共享 库 都 有 版 本 号 

合并 所 有 OS 特定 的 共享 库 定义 到 一 个 文件 

更 智能 的 TCL/TK ”配置 检测 (Billy) 

更 智能 的 perl 配置 (Brook) 

如 果 没 有 发 现 安装 脚本 ， 那 么 配置 使 用 提供 的 安装 sh (Tom) 
为 共享 库 配置 新 增 Makefile.shlib (Tom) 


有 EREEEE 科 可 


E.230. 版 本 6.3.2 


发 布 日 期 : 1998-04-07 
这 是 一 个 6.3.x 的 bug 修 复 版 本 。 请 参阅 版 本 6.3 的 版 本 信息 获取 新 特性 的 更 完整 的 概述 信息 。 
概要 : 


e 修复 了 对 一 些 平台 (包括 Linux) 的 自动 配置 的 支持 ， 在 v6.3.1 中 由 于 一 些小 错误 带 进 来 
了 这 些 破损 。 


e 正确 地 人 处理 在 BETWEEN 和 LIKE 子 句 左边 的 函数 调用 。 
对 运行 在 6.3 或 6.3.1 上 的 数据 库 不 需要 进行 转 储 /恢复 工作 。 所 要 做 的 所 有 工作 是 


make distclean ， make, 和 make install 。 最 后 一 步 应 该 在 postmaster 停止 运行 后 进 
行 。 你 应 该 用 PostgreSQL 库 对 所 有 用 户 应 用 进行 重新 链接 . 


对 于 从 v6.3 以 前 的 版 本 升级 ， 请 参考 v6.3 的 安装 和 移植 指导 。 


E.230.1. 修改 列表 


改善 了 tcl/tk 的 配置 检测 (Brook Milligan, Alvin) 
改进 了 手册 页 (Bruce) 

I$ 7 BETWEEN 和 LIKE (Thomas) 

ISS FS pg_dump 使 用 的 psql \connect (Oliver Elphick) 
新 增 odbc 驱动 器 

pgaccess, version 0.86 

IRT qsort， 现 在 使 用 libc 版 本 ， 清 理 (Jeroen) 
修复 了 缓存 浴 出 检测 (Maurice 

修复 了 在 libpgtcl 中 的 缓存 浴 出 (Randy Kunkee) 
BST #4 DISTINCT 或 ORDER BY 的 UNION (Bruce) 
gettimeofday 配置 检测 (Doug Winterburn) 

修复 了 "indexes not used" bug(Vadim) 

文档 添加 (Thomas) 

路 复 了 后 端 内 存 泄露 (Bruce) 

libreadline 清理 (Erwan MAS) 

IIR DISTDIR (Bruce) 

Makefile 依赖 清理 (Jeroen van Vianen) 

ASSERT 修复 (Bruce) 





E.231. 版 本 6.3.1 


发 布 日 期 : 1998-03-23 


摘要 : 
e。 对 多 字 节 字符 集 的 附加 支持 。 
。 修复 了 混合 字 节 序 的 服务 器 和 客户 端 环境 的 支持 。 


e 对 人 允许 的 SQL 语法 进行 了 小 的 升级 。 
e。 改善 了 安装 过 程 的 配置 自动 检测 功能 。 


对 那些 运行 着 6.3 版 本 的 应 用 不 需要 进行 转 储 /恢复 操作 。 升 级 工作 只 需 
make distclean ， make ， 和 make install. 最 后 一 步 应 该 在 postmaster 没有 运行 时 进 
行 。 升 级 后 你 应 该 对 所 有 使 用 PostgreSQL 库 的 用 户 应 用 重新 进行 连接 . 


对 于 从 v6.3 以 前 的 版 本 升级 ， 请 参考 v6.3 的 安装 和 移植 指导 。 


E.231.1. 修改 列表 


ecpg 清理 /修复 ， 现 在 的 版 本 是 1.1 (Michael Meskes) 
pg_user 清理 (Bruce) 

pg_dump 和 tclsh 的 大 对 象 修复 (alvin) 

修复 多 个 临近 的 下 划 线 的 LIKE 

($8 BAe LALA (Thomas) 

ultrix4 清理 

升级 到 pg_access 0.83 

更 新 了 CLUSTER 手册 页 

多 字 节 字符 设置 支持 ， 参 阅 doc/README.mb (Tatsuo) 
configure --with-pgport 修复 

pg_ident 修复 

为 后 端 通信 修复 big-endian (Kataoka) 

SUBSTR() 和 substring() 修复 (Jan) 

几 个 jdbc 修复 (Peter ) 

libpgtcl 4#, %ğ libptcl/README (Randy Kunkee) 
修复 了 "Datasize = 0" 错误 (Vadim) 

阻止 \do 打包 (Bruce) 

删除 重复 的 俄语 字符 集 条 目 

Sunos4 清理 

在 LOCK 和 SELECT INTO 中 人 允许 TABLE 关键 字 可 选 (Thomas) 
CREATE SEQUENCE 选项 允许 负 整 数 (Thomas ) 

作为 一 个 允许 的 字段 标识 符 添加 "PASSWORD" (Thomas) 
A” UNION 目标 字段 添加 检查 (Bruce) 

修复 了 Alpha 端口 (Dwayne Bailey) 

修复 了 文本 数组 包含 引号 的 问题 (Doug Gibson) 
Solaris 编译 修复 (Albert Chin-A-Young) 

更 好 的 识别 出 tcl 和 tk 库 和 包含 (Bruce) 


E.232. 版 本 6.3 


发 布 日 期 : 1998-03-01 
在 这 个 版 本 中 有 许多 新 的 特性 和 改进 。 下 面 是 一 个 简短 的 不 完整 的 概要 : 


。 增加 了 许多 新 的 SQL 特性 ， 包 括 完整 的 SQL92 子 查 询 功 能 〈 除 目标 列子 查询 外 所 有 的 
东西 都 实现 了 ) 。 


。 支持 客户 端 环境 变量 声明 时 区 和 日 期 风格 。 


。 用 于 客户 端 /服务 器 联接 的 套 接 字 (Socket) 接口 。 现 在 这 个 是 缺 省 的 值 ， 所 以 你 可 能 
需要 带 -i 参数 运行 postmaster, 


。 更 完善 的 口令 认证 机 制 。 修 改 了 缺 省 的 表 权 限 。 
。 删除 了 老式 的 时 间 跟 踪 (time travel) 特性 。 改 善 了 性 能 。 


Note: Bruce Momjian 写 下 了 下 面 的 介绍 新 版 本 的 文字 。 





我 在 这 里 想 提 一 些 关 于 6.3 的 事情 。 这 些 都 是 一 些 无 法 在 一 句 话 中 描述 的 比较 大 的 课题 。 所 
以 仍 需 要 你 回 过 头 去 看 看 修改 的 详细 列表 。 


首先 ， 我 们 现在 有 了 子 查询 。 既 然 我 们 已 经 拥有 子 查询 了 ， 我 要 很 客观 的 说 ， 如 果 没 有 子 查 
询 ，SQL 就 是 一 种 作用 非常 有 限 的 语言 。 子 查询 是 一 种 很 重要 的 特性 ， 你 应 该 复查 一 下 你 的 
代码 ， 以 便 找 出 子 查询 能 给 你 提供 更 好 解决 方法 的 地 方 。 我 相信 你 会 发 现 子 查询 可 以 应 用 在 
比 你 想象 得 到 多 得 多 的 地 方 。 Vadim 把 我 们 放 在 了 一 个 拥有 完整 功能 的 带子 查询 功能 的 巨大 
的 SQL 前 景 上 面 。 你 不 能 应 用 子 查询 的 唯一 方面 是 目标 列 。 


第 二 ，6.3 使 用 unix 域 套 接 字 作为 缺 省 而 不 是 TCP/IP。 要 允许 从 其 他 机 器 来 的 连接 ， 你 必须 
使 用 新 的 postmaster 的 -i 选项 ， 当 然 你 还 要 编辑 pg_hba.conf 。 同样 ， pg_hba.conf 的 格 
式 也 因此 而 改变 了 。 


第 三 ， 现 在 使 用 char() 字段 笃 比 使 用 varchar() 或 text 时 访问 的 更 快 。 具体 地 说 ， 在 
对 第 一 次 text 和 varchar) 的 字段 进行 访问 之 后 再 对 同类 型 字段 访问 将 有 一 些 访问 延 
Ro char() 原先 也 有 这 种 访问 延迟 ， 但 现在 已 经 没有 了 。 这 或 许 意味 着 你 重新 设计 你 的 一 
些 表 ， 尤 其 是 那些 你 已 经 定义 为 varchar() 或 text 的 短 的 字符 型 字段 。 这 个 和 其 他 的 一 些 
修改 使 6.3 比 早期 的 版 本 有 更 快 的 速度 。 


我 们 现在 有 了 独立 于 任何 Unix 文件 的 可 定义 的 口令 。 现 在 有 了 新 的 SQL USER AS. 参阅 
管理 员 手 册 获 取 更 多 信息 。 同 时 我 们 还 有 了 一 个 新 的 表 ，pg_shadow， 用 来 存放 用 户 信 息 和 
用 户口 舍 ， 并 且 缺 省 时 只 有 postgres 超级 用 户 对 其 有 (SELECT) 查询 权限 。pg_user 现在 
是 pg_shadow 的 一 个 视图 ， 并 且 可 以 被 公众 (PUBLIC) 读 取 (SELECT) 。 你 可 以 在 你 的 
应 用 里 继续 使 用 pg_user 而 不 需 做 任何 更 改 。 


用 户 创建 的 表 缺 省 时 不 再 被 公众 (PUBLIC) 拥有 读 取 (SELECT) 权限 。 这 么 做 是 因为 
ANSI 标准 要 求 这 样 做 。 你 当然 可 以 在 创建 表 后 用 GRANT 赋予 他 人 任何 你 希望 的 权限 。 系 统 
表 仍 然 可 以 被 公众 (PUBLIC) 读 取 (SELECT) 。 


我 们 仍然 有 实时 的 死 锁 检测 代码 。 超 时 时 间 不 超过 60 秒 。 并 且 新 的 锁定 代码 实现 了 更 好 的 
FIFO (先入 先 出 ) ， 所 以 在 重负 荷 时 对 资源 的 需求 会 轻 一 些 。 


在 以 前 的 版 本 中 我 们 听 到 了 许多 关于 缺乏 文档 的 抱 忽 。Thomas 在 这 个 版 本 中 努力 增加 了 许多 
新 的 手册 。 请 查阅 doc/ 目录 . 


出 于 性 能 考虑， 时 间 跟 踪 特 性 取消 了 ， 但 是 可 以 使 用 触发 器 实现 ( 参 

阅 pgsql/contrib/spi/README ) o 请 使 用 新 的 \d 命令 查询 关于 类 型 ， 操作 符 等 的 信息 。 同 
时 ， 视 图 拥有 了 他 们 自己 的 权限 ， 而 不 是 以 它们 依赖 的 表 为 基础 。 所 以 它们 的 权限 应 该 独立 
的 设置 。 请 检查 /pgsql/interfaces 文件 获取 更 多 与 PostgreSQL 对 话 的 方法 。 


这 是 第 一 个 需要 向 已 有 的 用 户 进行 说 明 的 版 本 。 不 管 从 哪个 角度 来 说 ， 我 们 都 需要 做 这 样 的 
说 明 ， 因为 新 版 本 取消 了 许多 限制 ， 因 而 许多 原先 人 们 需要 做 的 许多 防范 性 工作 都 不 再 需要 
了 . 


E.232.1. 迁移 到 版 本 6.3 


任何 希望 从 以 前 的 PostgreSQL 版 本 移植 到 新 版 本 的 数据 库 都 需要 用 pg_dump 或 
pg_dumpall 进行 一 次 转 储 /恢复 工作 。 


E.232.2. 修改 列表 


SS MOVE 实现 毁坏 的 二 进 制 游标 (Vadim) 

SS tcl Ħa (Jan) 

路 复数 组 处 理 ， 来 自 Gerhard Hintermayer 

ISS acl 错误 ， 删 除 重复 的 pqtrace (Bruce) 

为 空 文件 修复 psql \e (Bruce) 

修复 varchar() 字段 上 的 textcat (Bruce) 

修复 DBT Sendproc (Zeugswetter Andres) 

修复 vacuum 分 析 语 法 问题 (Bruce) 

修复 国际 标识 符 (Tatsuo) 

侈 复 在 继承 表 上 的 聚集 (Bruce) 

为 超出 范围 的 数据 修复 substr() 

修复 select 1=1 or 2=2, select 1=1 and 2=2, 和 select sum(2+2) (Bruce) 

修复 notty 输出 显示 状态 的 结果 。-q 选项 仍然 是 将 它 关 闭 (Bruce) 

路 复 带 有 视图 和 多 行 表 和 sum(3) 的 count(*)，aggs (Bruce) 

ISS FS (Bruce) 

几 次 修复 了 PQtrace start/stop (Bruce) 

侈 复 各 种 各 样 的 锁 问 题 ， 像 较 新 的 锁 等 待 在 较 旧 的 锁 等 待 之 前 得 到 锁 ， 

如 果 一 个 写 入 正在 等 待 一 个 锁 使 不 可 读 的 人 员 不 共享 锁 ， 

等 待 写 入 的 没有 获得 比 等 待 读 取 的 更 高 的 优先 权 (Bruce) 

路 复 了 从 外 部 文件 执行 查询 时 psql 中 的 崩溃 (James) 

侨 复 了 有 多 个 命令 列 切 第 一 个 是 NULL 值 的 问题 (Jeroen) 

为 floats 和 int4 使 用 正确 的 哈 希 表 支 持 函 数 (Thomas) 

重新 在 CREATE OPERATOR 语句 中 启用 JOIN= 选项 (Thomas) 

改变 布尔 操作 符 的 优先 级 以 匹配 预期 行为 (Thomas ) 

在 超大 的 整数 上 产生 elog(ERROR) (Bruce) 





在 约束 子 句 中 人 允许 多 个 参数 的 函数 (Thomas) 

检查 布尔 输入 文本 'true','false','yes','no','1','O' 并 在 不 能 识别 时 抛 出 elog(ERROR) (Thomas) 
主要 的 大 对 象 修复 

修复 GROUP BY 显示 重复 的 问题 (Vadim) 

修复 MergeJoin 中 的 索引 扫描 (Vadim) 


带 有 EXISTS, IN, ALL, ANY 关键 字 的 子 查询 (Vadim, Bruce, Thomas) 

新 增 用 户 手 册 (Thomas, others) 

通过 佬 入 一 些 频 繁 调用 的 函数 加 速 

真实 的 死 锁 检 测 ， 不 再 超时 (Bruce) 

添加 SQL92 "constants" CURRENT_DATE, CURRENT_TIME， CURRENT_TIMESTAMP, CURRENT_USER (Thomas 
修改 约束 语法 使 其 SQL92 兼容 (Thomas) 

使 用 索引 实现 SQL92 PRIMARY KEY 和 UNIQUE 子 句 (Thomas) 

为 FOREIGN KEY 识别 出 SQL92 语法 。 抛 出 elog 通知 (Thomas) 

允许 NOT NULL UNIQUE 子 句 (每 个 语句 在 之 前 单独 的 被 允许 ) (Thomas) 

允许 非常 量 PostgreSQ 风格 的 转换 ("::") (Thomas) 

添加 对 SQL3 TRUE 和 FALSE 布尔 常量 的 支持 (Thomas) 

支持 SQL92 语法 IS TRUE/IS FALSE/IS NOT TRUE/IS NOT FALSE (Thomas) 
允许 布尔 字面 值 是 较 短 的 字符 串 (A0 "t", "tr", "tru") (Thomas) 

允许 SQL92 分 隔 标识 符 (Thomas) 

实现 SQL92 二 进 制 和 十 六 进 制 字符 串 编码 (b'10' 和 x'1F') (Thomas) 

支持 SQL92 语法 文字 字符 串 的 类 型 强制 转换 (如 “DATETIME 'now'") (Thomas) 
添加 int2，int4， 和 OID 类 型 和 文本 类 型 之 间 的 转换 (Thomas) 

在 建立 索引 时 使 用 共享 锁 (Vadim) 

在 一 个 用 户 查询 完成 之 后 ， 在 一 个 事务 块 内 部 给 该 查询 分 配 空闲 存储 ， 截 断 为 <= 6.2.1 (Vadim) 
新 增 SQL 语句 CREATE PROCEDURAL LANGUAGE (Jan) 

新 增 PostgreSQL 过 程 语言 (PL) 后 端 接口 (Jan) 

重 命名 pg_dump -H 选项 为 -h (Bruce) 

添加 Java 支持 口令，European AHA (Peter) 

使 用 索引 LIKE 和 ~, !~ 操作 符 (Bruce) 

为 datetime 和 timespan RANMA (Thomas) 

删除 了 Time Travel (Vadim, Bruce) 

为 \d 和 \z 添加 分 页 ， 并 且 修 复 了 \i (Bruce) 

添加 Unix 域 套 接 字 支 持 到 后 端 和 前 端 库 (Goran) 

实现 了 CREATE DATABASE/WITH LOCATION 和 initlocation 工具 (Thomas) 
允许 更 多 SQL92 和 /或 PostgreSQL 保留 字 作为 字段 标识 符 (Thomas) 

增 大 对 SQL92 SET TIME ZONE... 的 支持 (Thomas) 

SET/SHOW/RESET TIME ZONE 使 用 TZ 后 端 环 境 变量 (Thomas) 

实现 了 SET keyword = DEFAULT 和 SET TIME ZONE DEFAULT (Thomas ) 
启用 SET TIME ZONE 使 用 TZ 环境 变量 (Thomas ) 

添加 PGDATESTYLE 环境 变量 到 前 端 和 后 端 初始 化 (Thomas ) 

添加 PGTZ, PGCOSTHEAP, PGCOSTINDEX, PGRPLANS, PGGEQO 前 端 库 初 始 化 环境 变量 (Thomas) 
回 为 测试 时 区 自动 设置 "setenv PGTZ PST8PDT" (Thomas) 

为 表 、 字 段 、 操 作 符 、 类 型 和 聚集 的 信息 添加 pg_description X (Bruce) 
增加 系统 表 / 索 引 名 上 的 16 字符 限制 到 32 个 字符 (Bruce) 

重 命名 系统 索引 (Bruce) 

添加 'GERMAN' 选项 到 SET DATESTYLE (Thomas) 

定义 一 个 带 有 "hh:mm:ss" 字段 的 "ISO-style" 时 间 间 隔 输出 格式 (Thomas) 
允许 时 间 增 量 的 小 数值 (如 '2.5 days') (Thomas) 

为 时 间 增 量 更 细心 的 验证 数值 输入 (Thomas) 

实现 了 一 年 中 的 天 数 作为 date_part() 的 可 能 输入 (Thomas) 

定义 timespan_finite() 和 text_timespan() EH2 (Thomas) 

删除 存档 的 东西 (Bruce) 

允许 pg_password 认证 数据 库 从 系统 口令 文件 中 分 离 出 来 (Todd) 

454% ACLS, GRANT, REVOKE 权限 (Matt) 

定义 text, varchar, #1 bpchar ####KEWR (Thomas) 
修复 继承 的 查询 处 理 ， 和 开销 计算 (Bruce) 

实现 了 CREATE TABLE/AS SELECT (作为 SELECT/INTO 的 替换 ) (Thomas) 
在 约束 中 人 允许 NOT, IS NULL, IS NOT NULL (Thomas) 

为 SELECT 实现 了 UNION (Bruce) 

添加 UNION, GROUP, DISTINCT 到 INSERT (Bruce) 

varchar() 存储 只 需要 磁盘 上 的 字 节 (Bruce) 

修复 了 BLOBs (Peter) 

JDBC... 的 Mega-Patch 参阅 README_6.3 的 修改 列表 (Peter) 

删除 了 PQconnectdb() 中 不 使 用 的 "option" 

新 增 LOCK 命令 和 描述 死 锁 的 锁 手 册页 (Bruce ) 

添加 了 新 的 psql \da, \dd, \df, \do, \dS, #1 \dT 命令 (Bruce) 

增强 了 psql \z 以 显示 序列 (Bruce) 

在 psql \d 的 表 中 显示 NOT NULL 和 DEFAULT (Bruce) 

新 增 psql .psqlrc 文件 启动 (Andrew) 


在 contrib/linux 中 修改 样本 启动 脚本 以 显示 系统 日 志 (Thomas) 

在 contrib/ip_and_mac 中 为 IP 和 MAC 地 址 新 增 类 型 (TomH) 
contrib/unixdate 中 Unix 系统 时 间 和 日 期 /时 间 类 型 的 转换 (Thomas) 
贡献 版 的 更 新 (Massimo) 

添加 Unix 套 接 字 支 持 到 DBD: :Pg (Goran) 

新 增 python 接口 (PyGreSQL 2.0)(D'Arcy) 

新 的 前 端 /后 端 控制 有 一 个 版 本 号 ， 网 络 字 节 顺序 (Phil) 

pg_hba.conf 中 的 安全 特征 加 强 了 也 记录 了 ， 还 有 许多 清理 (Phil) 

CHAR() 现在 比 VARCHAR() 或 TEXT 访问 更 快 

ecpg RAT SQL 预 处 理 器 

减少 系统 字段 开销 (Vadmin) 

删除 pg_time 表 (Vadim) 

添加 pg_type 属性 以 确定 需要 长 度 的 类 型 (bpchar, varchar) 

当 COPY 命令 失败 时 添加 违规 行 的 报告 

允许 VIEW 权限 与 基础 表 的 设置 分 离开 来 。 为 了 安全 ， 根 据 情况 在 视图 上 使 用 GRANT/REVOKE (Jan) 
表现 在 没有 缺 省 的 GRANT SELECT TO PUBLIC。 你 必须 明确 的 赋予 这 样 的 权限 。 
清理 教程 示例 (Darren) 


源 代 码 树 的 变化 

添加 新 的 html 开发 工具 ， 和 在 /tools/backend 中 添加 流程 图 
修复 SCO 编译 

Robert Gillies 层 云 计 算 机 接口 

为 BSD44_derived shlib 添加 支持 & i386_solaris 

使 配置 更 加 自动 化 (Brook ) 

添加 检查 回 为 测试 结果 的 脚本 

分 解 解析 器 函数 为 更 小 的 文件 ， 集 合 到 一 起 (Bruce) 

重 命名 heap_create 为 heap_create_and_catalog， 重 命名 heap_creatr 为 heap_create() (Bruce) 
为 锁定 修补 Sparc/Linux (TomS) 

IRR PORTNAME 并 整理 端口 特定 的 东西 (Marc) 

添加 优化 器 README 文件 (Bruce) 

I 除 优化 器 中 的 一 些 递 为 并 清理 此 处 的 一 些 代码 (Bruce) 

修复 NetBSD 锁定 (Henry) 

SS libptcl 制造 (Tatsuo) 

AIX 修补 (Darren) 

更 改 IS TRUE, IS FALSE, .. ， 到 表达 式 ， 使 用 "=" ATEKA istrue() 或 isfalse() 来 允许 优化 ( 
收复 各 种 NetBSD/Sparc 相关 (TomH) 

Alpha linux 锁定 (Travis, Ryan) 

更 改 elog(WARN) 为 elog(ERROR) (Bruce) 

FreeBSD BY FAQ (Marc) 

引入 PostODBC 源 代码 树 作 为 我 们 的 标准 发 布 的 一 部 分 (Marc) 
HP/UX 10 vs 9 的 小 幅度 修补 (Stan) 

为 type-specific 信息 新 增 pg_attribute.atttypmod， 就 像 varchar KE (Bruce) 
UnixWare 补 J (Billy) 

为 自 旋 锁 asm 新 增 i386 'lock' (Billy) 

多 路 复 用 后 端的 支持 已 经 删除 了 

开启 一 个 OpenBSD 端口 

开启 一 个 AUX 端口 

开启 一 个 Cygnus 端口 

添加 字符 串 画 数 到 回 为 套件 (Thomas) 

扩展 一 些 以 前 被 截断 为 16 个 字符 的 函数 名 (Thomas) 
删除 不 需要 的 malloc() 调用 并 用 palloc() 替换 (Bruce) 


a] =— mae ae 








E.233. 版 本 6.2.1 


发 布 日 期 : 1997-10-17 
6.2.1 是 6.2 的 除 错 版 本 和 增强 可 用 性 版 本 。 
摘要 : 
。 人 允许 字符 串 跨 行 ， 类 似 SQL92。 
。 包括 了 一 个 触发 器 的 样 例 阔 数 ， 用 于 在 更 新 表 时 插入 用 户 名 。 


这 是 对 6.2 的 一 个 小 的 除 错 版 本 。 对 于 从 6.2 以 前 的 系统 上 升级 ， 需要 进行 一 次 完整 的 转 储 / 恢 
复工 作 。 请 参考 6.2 版 本 信息 获取 相关 指导 。 


E.233.1. 从 v6.2 迁移 到 v6.2.1 


这 是 一 次 小 的 除 错 升级 。 从 v6.2 上 升级 不 需要 进行 转 储 /恢复 ， 但 对 任何 v6.2 以 前 的 版 本 是 需 
要 的 。 


当 你 从 v6.2 上 升级 时 ， 如 果 你 选择 了 转 储 /恢复 的 做 法 。 你 将 会 发 现 avg(money) 现在 可 以 正 
确 运 算 了 。 所 有 其 他 的 除 错 在 升级 了 可 执行 程序 后 都 将 生效 。 


另 一 个 避免 转 储 /恢复 的 做 法 是 在 psa 中 使 用 下 面 的 SQL 命令 来 升级 现 有 的 系统 表 : 


update pg_aggregate set aggfinalfn = 'cash_div_fl1ts8' 
where aggname = 'avg' and aggbasetype = 790; 


我 们 需要 对 包括 template1 在 内 的 所 有 现 有 数据 库 进 行 上 面 操作 。 


E.233.2. 修改 列表 


人 允许 TIME 和 TYPE 字段 名 (Thomas) 

人 允许 true/false 的 更 大 范围 作为 布尔 值 (Thomas ) 

支持 "now" 和 "current" 的 输出 (Thomas ) 
适当 的 义理 带 有 NULL 的 INSERT 的 DEFAULT (Vadim) 
修复 缓冲 区 管理 中 的 关系 参考 计数 的 问题 (Vadim) 

允许 字符 串 跨行 ， 如 ANSI (Thomas) 

修复 带 有 ORDER BY 的 向 后 的 游标 (Vadim) 

修复 avg(cash) 计算 (Thomas) 

修复 在 ORDER/GROUP BY 中 指定 一 个 字段 两 次 (Vadim) 

记录 新 的 1ibpq 画 数 返回 受 影响 的 行 ，PQcmdTuples (Bruce) 
INSERT/UPDATE 插入 用 户 名 的 触发 器 函数 (Brook Milligan) 


E.234. 版 本 6.2 


发 布 日 期 : 1997-10-02 


希望 从 以 前 版 本 的 PostgreSQL 升级 到 此 版 本 的 用 户 需 要 对 数据 库 做 一 转 储 /恢复 的 工作 。 


E.234.1. 从 版 本 6.1 迁移 到 版 本 6.2 


这 种 迁移 需要 对 6.1 的 数据 库 进 行 一 次 完全 的 转 储 ， 然 后 再 恢复 到 6.2 的 数据 库 里 面 。 


请 注意 ，6.2 的 pg_dump 和 pg_dumpall 工具 应 该 用 来 转 储 6.1 数据 库 。 


E.234.2. 从 版 本 1， x. EIRA 6.2 


任何 从 早 于 1.* 版 本 的 升级 都 要 首先 升级 到 1.09， 因为 在 1.02 版 本 中 对 COPY 的 输出 格式 
进行 了 改进 。 


E.234.3. 修改 列表 


修复 pg_dump 继承 、 序 列 、 注 档 表 的 问题 (Bruce) 

修复 由 于 Solaris 中 转换 、 无 符号 和 坏 的 原型 引起 的 浴 出 导致 的 编译 错误 (Diab Jerius) 
修复 几何 线 算法 的 bug (损坏 的 交叉 计算 ) (Thomas) 

检查 在 端点 处 的 几何 交叉 以 避免 圆 整 (Thomas) 

捕捉 非 功能 性 的 删除 尝试 (Vadim) 

更 改 时 间 画 数 名 使 其 更 一 致 (Michael Reifenberg) 

检查 需 分 (Michael Reifenberg) 

检查 一 个 命 分 对 其 本 身 可 见 的 行 更 改 / 插 入 〈 这 样 我 们 有 多 个 更 新 行 的 更 新 ， 等 ) 的 非常 老 旧 的 bug (Vadim) 
修复 SELECT null, 'fail' FROM pg_am (Patrick) 

SELECT NULL as EMPTY_FIELD 现在 被 允许 了 (Patrick) 

从 contrib/pginterface 中 删除 不 需要 的 信号 的 东西 

修复 了 OR (where x != 1 or x isnull didn't return rows with x NULL) (Vadim) 
BST time_cmp WA (Vadim) 

修复 了 在 WHERE 子 句 中 处 理 带 有 非 属性 第 一 参数 的 函数 (Vadim) 

路 复 了 记录 的 顺序 和 目标 列表 的 顺序 不 同时 的 GROUP BY (Vadim) 

SS TR EA sfunct 的 聚集 的 pg_dump (Vadim) 





默认 遗传 优化 器 GEQO 参数 现在 是 8 个 (Bruce) 

允许 在 辑 数 中 的 有 聚集 的 目标 列表 中 使 用 参数 (Vadim) 

添加 JDBC 了 驱动 器 作为 一 个 接口 (Adrian & Peter) 

pg_password 工具 

返回 INSERT/UPDATE/DELETE 等 inserted/affected 的 行 数 (Vadim) 
触发 器 由 CREATE TRIGGER 实现 (SQL3)(Vadim) 

SPI (Server Programming Interface) 人 允许 查询 在 C MRAM (Vadim) 
实现 了 NOT NULL (SQL92)(Robson Paniago de Miranda) 

为 字符 串 义 理 、 外 连接 和 联合 包括 保留 字 (Thomas) 

使 用 唯一 状态 实现 了 扩展 的 注释 ("/* ... */") (Thomas) 

添加 "//" 单行 注释 (Bruce) 

删除 操作 符 名 字 里 的 一 些 字符 上 的 限制 (Thomas) 

实现 了 表 的 DEFAULT 和 CONSTRAINT (SQL92)(Thomas) 


AILEE REE AR (SQL92) (Thomas) 

支持 WITH TIME ZONE 语法 (SQL92) (Thomas) 

支持 INTERVAL unit TO unit 语法 (SQL92) (Thomas) 

定义 类 型 DOUBLE PRECISION, INTERVAL, CHARACTER, 和 CHARACTER VARYING (SQL92)(Thomas) 
定义 类 型 FLOAT(p) 和 基本 的 DECIMAL(p,s), NUMERIC(p,s) (SQL92)(Thomas) 
定义 EXTRACT(), POSITION()，SUBSTRING()， 和 TRIM() (SQL92)(Thomas ) 
定义 CURRENT_DATE， CURRENT_TIME， CURRENT_TIMESTAMP (SQL92)(Thomas ) 
为 UNION， HAVING, INNER 和 OUTER JOIN 添加 语法 和 警告 (SQL92) (Thomas ) 
添加 更 多 保留 字 ， 大 部 分 是 SQL92 兼容 的 (Thomas) 

允许 timespan/reltime 类 型 的 hh:mm:ss 时 间 选 项 (Thomas) 

为 lseg, path, polygon 添加 center() 例 程 (Thomas) 

为 circle-polygon, polygon-polygon 添加 distance() 例 程 (Thomas) 
明确 的 检查 使 用 轴线 交叉 算法 的 多 边 形 包含 的 点 和 多 边 形 (Thomas) 

添加 转换 circle-box 的 例 程 (Thomas) 

合并 不 同 几何 数据 类 型 冲突 的 操作 符 (Thomas) 

用 "<->" 替换 距离 操作 符 "<===>" (Thomas) 

用 ">An Bm "above" 操作 符 Wha 和 用 "<A" 替换 "below" 操作 符 wy ie (Thomas ) 
为 文本 在 两 端 截取 、 子 字符 串 和 字符 串 位 置 添加 例 程 (Thomas) 

添加 转换 程序 circle(box) 和 poly(circle) (Thomas) 

允许 以 内 存 而 不 是 文件 排序 的 内 部 排序 (Bruce & Vadim) 

允许 在 内 部 同一 类 型 上 的 函数 和 操作 符 成 功 (Bruce) 

加 速 剖 像 分 析 之 后 的 后 端 启 动 (Bruce) 

A TIERE A Kn RA ASK (Bruce) 

减少 open() 调用 (Bruce) 

psql: 添加 PAGER 为 了 \h 和 \?,\C 修复 

修复 没有 tty 时 的 psql pager (Bruce) 

新 增 entab 工具 (Bruce) 

为 参照 完整 性 添加 一 般 触发 器 函数 (Vadim) 

为 时 间 间 隔 添 加 一 般 触 发 器 范 数 (Vadim) 

为 AUTOINCREMENT/IDENTITY 特性 添加 一 般 触 发 器 男 数 (Vadim) 

MOVE 实现 (Vadim) 


源 代 码 树 的 变化 

HP-UX 10 补丁 (Vladimir Turin) 

添加 SCO 支持 (Daniel Harris) 

MkLinux 补 J (Tatsuo Ishii) 

更 改 几何 盒子 术语 从 "length" 到 "width" (Thomas) 

反对 几何 学 代码 中 临时 的 未 存储 的 斜率 字段 (Thomas) 

从 INSTALL FMRE EHS (Bruce) 

安装 时 首先 查看 /usr/ucb (Bruce) 

修复 c++ 拷贝 示例 代码 (Thomas) 

添加 -o 到 psql 手册 页 (Bruce) 

阻止 未 分 配 字符 串 长 度 的 真实 名 被 拷贝 到 数据 库 (Bruce) 

清理 NAMEDATALEN 的 使 用 (Bruce) 

修复 在 输出 中 超过 15 个 字符 的 pg_proc 名 (Bruce) 

添加 strNcpy() AR (Bruce) 

删除 一 些 不 需要 的 (void) 转换 (Bruce) 

新 增 接 口 路 径 (Marc) 

用 到 fd.c 画 数 的 调用 替换 fopen() 调用 (Bruce) 

Raa NAA (Bruce) 

将 不 适用 的 函数 放 在 #ifdef NOT_USED 中 (Bruce) 
删除 时 间 惟 支持 中 对 difftime() 的 调用 以 修复 Sun0S (Bruce & Thomas) 
修改 Digital Unix 

pg_dumpall 的 可 移植 性 修复 (Bruce) 

重 命名 pg_attribute.attnvals 为 attdispersion (Bruce) 
"intro/unix" 手册 页 现在 是 "pgintro" (Bruce) 
"built-in" 手册 页 现在 是 "pgbuiltin"(Bruce) 

"drop" 手册 页 现在 是 "drop_table"(Bruce) 

添加 "create_trigger"，"drop_trigger" 手册 页 (Thomas) 
添加 约束 回 为 测试 (Vadim & Thomas) 

添加 注释 语法 回 为 测试 (Thomas) 

添加 PGINDENT 并 支持 编程 (Bruce) 

大 量 的 提交 在 所 有 的 *.c 和 *.h 文件 上 运行 PGINDENT (Bruce) 
文件 移动 到 了 /src/tools 目录 (Bruce) 

SPI 和 触发 器 编程 指南 (Vadim & D'Arcy) 


E.235. 版 本 6.1.1 


发 布 日 期 : 1997-07-22 


E.235.1. 从 版 本 6.1 迁移 到 版 本 6.1.1 


这 是 一 个 小 的 除 错 升级 版 本 。 从 v6.1 的 版 本 到 此 版 本 的 升级 不 需要 进行 转 储 /恢复 的 工作 ， 
是 任何 从 早 于 v6.1 的 升级 需要 做 这 个 工作 。 请 参考 v6.1 的 版 本 信息 获取 更 多 细节 。 


E.235.2. 修改 列表 


修复 带 有 选项 的 SET (Thomas) 

允许 pg_dump/pg_dumpall 保留 对 所 有 表 / 对 象 的 所 有 权 (Bruce) 
新 增 psql \connect 选项 允许 改变 用 户 名 而 不 改变 数据 库 
修复 initdb --debug 选项 (Yoshihiko Ichikawa) 
lextest 清理 (Bruce) 

hash 修复 (Vadim) 

修复 日 期 /时 间 月 份 边 界 算法 (Thomas) 

为 一 些 接口 修复 时 区 白天 处 理 (Thomas, Bruce, Tatsuo) 
彻底 检修 了 时 间 惟 ， 以 使 用 标准 画 数 (Thomas ) 

其 他 日 期 /时 间 例 程 中 的 代码 清理 (Thomas) 

psql 的 \d 现在 大 小 写 不 敏感 了 (Bruce) 

psql 的 反 斜 杠 命令 现 有 可 以 有 尾随 的 分 号 (Bruce) 

修复 使 用 \g 时 psal 中 的 内 存 泄露 (Bruce) 

主要 修复 尾数 法 处 理 到 服务 器 的 通信 (Thomas, Tatsuo) 

修复 Solaris 汇编 程序 和 包括 文件 (Yoshihiko Ichikawa) 
允许 在 用 户 名 中 有 下 划 线 (Bruce) 

pg_dumpall 现在 返回 适当 的 状态 ， 可 移植 性 修复 (Bruce) 


但 


E.236. 版 本 6.1 


发 布 日 期 : 1997-06-08 
回 为 测试 已 经 适应 并 且 为 PostgreSQL 版 本 6.1 做 了 大 量 的 修改 。 


增加 了 三 种 新 的 PostgreSQL 内 部 数据 类 型 ( datetime , timespan ,和 circle ) 。 统 一 了 
Points, boxes, paths, 和 polygons 的 输出 格式 。 在 misc.out 中 的 polygon (多 边 形 ) 的 输出 
只 是 相对 原先 的 回 为 测试 输出 进行 了 抽样 检查 。 


PostgreSQL 6.1 提供 了 一 个 可 选 的 使 用 基因 算法 的 优化 器 。 这 些 算法 在 对 包含 多 个 限定 或 多 
个 表 (优化 器 需要 对 评估 的 排序 选择 时 ) 的 查询 输出 进行 排序 时 表现 得 更 为 随机 。 有 好 几 个 
回 为 测试 项 目 显 式 地 修改 了 结果 的 排序 ， 这 样 就 对 优化 器 选择 不 敏感 了 。 有 几 个 对 数据 类 型 
的 回 为 测试 本 来 就 是 乱 序 的 (如 点 和 时 间 间 隔 ) ， 包含 这 些 类 型 的 测试 明显 和 

set geqo to 'off' 和 reset geqo 相等 。 


对 数组 说 明 符 (包围 在 原子 值 周转 的 花 括 号 ) 的 解释 看 起 来 在 回 为 测试 产生 之 后 的 某 个 时 候 
被 改变 了 。 现在 的 ./expected/*.out 文件 反映 了 这 个 新 的 解释 ， 但 却 有 可 能 是 错误 的 ! 


float8 的 回 为 测试 至 少 在 某 些 平台 上 会 失败 。 这 是 因为 对 pow) 和 exp() 的 不 同 的 实现 方 
法 以 及 用 于 渝 出 和 下 渝 (underflow) 条 件 的 信号 机 制 的 不 同 造成 的 。 


在 随机 测试 中 的 "随机 "结果 回 导 致 "随机 "测试 "失败 "， 因为 回 为 测试 是 简单 的 用 diff 进行 比较 
的 。 不 过 ，" 随 机 "在 我 的 机 器 上 (Linux/gcc/i686) 看 起 来 好 象 并 没有 产生 随机 结果 。 


E.236.1. 迁移 到 版 本 6.1 


迁移 需要 对 数据 库 进 行 完整 的 6.0 版 本 的 转 钳 和 6.1 版 本 的 恢复 。 


对 于 早 于 1.* 的 版 本 : 首先 要 升级 到 1.09 版 本 ， 因 为 在 1.02 版 本 中 已 经 改善 了 COPY 的 输出 格 
式 。 


E.236.2. 修改 列表 


在 库 程 序 中 检查 包 的 长 度 

锁 管理 的 优先 级 修补 

检查 floats 的 上 /下 浴 (Bruce) 

多 个 表 连 接 的 修复 (Vadim) 

SIGPIPE 崩溃 修复 (Darren) 

大 对 象 修复 (Sven) 

允许 btree 35/432 NULL (Vadim) 

时 区 修复 (D'Arcy) 

select SUM(x) 可 以 在 没有 行 时 返回 NULL (Thomas) 
内 部 优化 ， 执 行 bug 修复 (Vadim) 


Z < 或 <= 中 的 内 循环 没有 行 的 问题 (Vadim) 

阻止 重新 连接 索引 子 句 (Vadim) 

路 复 多 个 表 的 连接 子 句 (Vadim) 

修复 哈 希 ， 为 数组 hashjoin (Vadim) 

为 abstime 类 型 修复 btree (Vadim) 

大 对 象 修复 (Raymond ) 

移 复 哈 希 索 引 中 的 缓存 泄露 (Vadim) 

SS AFAR aN rtree (Vadim) 

侈 复 用 于 内 部 扫描 的 gist, HE (Vadim, Andrea) 

避免 不 必要 的 本 地 缓冲 区 分 配 (Vadim, Massimo) 

收复 事务 退出 时 本 地 缓冲 区 泄露 (Vadim) 

SSF BANG, E (Vadim, Massimo) 

Sik SARE (Vadim) 

SS btree 重复 处 理 (Vadim) 

修复 由 于 vacuum 导致 已 删除 的 行 重 现 (Vadim) 

ŽS SELECT varchar()/char() INTO TABLE 制造 雾 长 度 的 字段 (Bruce) 
使 用 Purify 修复 许多 psql, pg_dump, #1 libpq AFS (Igor) 





属性 最 优化 统计 (Bruce) 

更 快 的 新 btree 批量 加 载 代 码 (Paul) 

BTREE UNIQUE 添加 到 批量 加 载 代 码 (Vadim) 

新 增 锁 调 试 代 码 (Massimo) 

libpg++ 有 大 量 的 改变 (Leo) 

新 增 GEQO 优化 器 加 速 表 多 个 表 优 化 (Martin) 
新 增 WARN 消息 ， 为 非 唯一 的 数据 插入 到 唯一 键 中 (Marc) 
update x=-3， 没 有 空格 ， 现 在 有 效 了 (Bruce) 
删除 大 小 写 敏感 的 标识 符 的 处 理 (Bruce, Thomas, Dan) 
调试 后 端 现 在 以 树 的 形式 打印 (Darren) 

新 增 Oracle 字符 函数 (Edmund) 

新 增 明文 口令 函数 (Dan) 

no such class 3 insufficient privilege 更 改 为 不 同 的 消息 (Dan) 
新 增 ANSI H BEN (Dan) 

新 增 ANSI 时 间 和 日 期 类 型 (Thomas) 

移动 后 端 中 的 大 的 数据 块 (Martin) 

多 字段 btree 索引 (Vadim) 

新 增 SET var TO value 命令 (Martin) 

在 需要 时 更 新 事务 状态 (Dan) 

为 字符 类 型 新 增 本 地 设置 (Oleg) 

新 增 SEQUENCE 序列 号 生成 器 (Vadim) 

GROUP BY 画 数 现 在 是 可 能 的 (Vadim) 
重组 回 为 测试 (Thomas, Marc) 

新 增 优化 器 操作 加 权 (Vadim) 

新 增 psql \z grant/permit 选项 (Marc) 
新 增 MONEY 数据 类 型 (D'Arcy, Thomas) 

tcp 套 接 字 通信 速度 提升 (Vadim) 

为 属性 状态 和 特定 字段 新 增 VACUUM 选项 (Vadim) 
改善 了 许多 几何 类 型 (Thomas, Keith) 
附加 了 回 为 测试 (Thomas ) 

新 增 datestyle 变量 (Thomas, Vadim, Martin) 
为 排序 类 型 添加 了 更 多 比较 操作 符 (Thomas) 
i844 RES (Thomas) 

新 增 更 多 简洁 的 btree 格式 (Vadim) 

人 允许 pg_dumpall 保存 数据 库 所 有 权 (Bruce) 
新 增 SET GEQO=# 和 R_PLANS 变量 (Vadim) 
IBY (!GEQO) 优化 器 可 以 使 用 右 侧 规划 (Vadim) 
改善 了 SQL 分 析 器 中 的 类 型 检查 (Bruce) 

新 增 SET, SHOW, RESET 命令 (Thomas, Vadim) 
新 增 \connect database USER 选项 

新 增 destroydb -i 选项 (Igor) 

新 增 \dt 和 \di psql 命令 (Darren) 

SELECT "\n" 现在 逃逸 新 行 (A. Duursma) 

新 增 老 的 格式 的 几何 转换 函数 (Thomas) 


源 代码 树 的 改变 

新 增 配置 脚本 (Marc) 

添加 了 readline 配置 选项 (Marc) 
删除 了 OS 特定 的 配置 选项 (Marc) 

新 增 OS 特定 的 模板 文件 (Marc) 

不 再 需要 编辑 Makefile.global (Marc) 





重新 安排 包含 文件 (Marc) 

nextstep 补丁 (Gregor Hoffleit) 

删除 了 Windows 特定 的 代码 (Bruce) 

删除 了 postmaster -e 选项 ， 现 在 只 有 postgres -e 选项 (Bruce) 
合并 front/backends 中 重复 的 库 代 码 (Martin) 

现在 使 用 eBones， international Kerberos(Jun) 
支持 更 多 的 共享 库 

清理 c++ 包含 文件 (Bruce) 

警告 buggy flex (Bruce) 

DG/UX, Ultrix, IRIX, AIX 可 移植 性 修复 


E.237. 版 本 6.0 


发 布 日 期 : 1997-01-29 


对 于 想 从 此 版 本 以 前 的 PostgreSQL 迁移 到 此 版 本 的 都 需要 做 转 储 / 恢 复工 作 。 


E.237.1. 从 版 本 1.09 迁移 到 版 本 6.0 


这 种 迁移 需要 对 1.09 数 据 库 完全 转 储 ， 然 后 在 6.0 里 将 数据 全 部 恢复 回去 。 


E.237.2. 从 1.09 以 前 的 版 本 迁移 到 版 本 6.0 


从 1.* 以 前 的 版 本 迁移 首先 要 升级 到 1.09 版 本 ， 因 为 在 1.02 版 本 中 已 经 改善 了 COPY 的 输 
出 格式 。 


E.237.3. ¥ (6 


ALTER TABLE bug - 运行 postgres 进程 需要 重读 表 定 义 
允许 vacuum 运行 在 一 个 表 或 整个 数据 库 上 (Bruce) 

SS Ba 

修复 数组 内 存 写 入 浴 出 (Kurt) 

Zawi btree range/non-range bug (Dan) 

获 复 在 某 些 类 型 如 时 间 和 日 期 上 的 哈 希 索引 

SS pg log 尺寸 激增 

ISS lo_export() 上 的 权限 (Bruce) 

修复 未 初始 化 的 读 取 内 存 (Kurt) 

修复 ALTER TABLE ... char(3) bug (Bruce) 

修复 一 些小 的 内 存 泄 露 

修复 EXPLAIN 义理 选项 和 改变 了 的 full path 选项 名 
ISH acl 权限 分 组 的 输出 

内 存 泄露 ( 像 Purify 这 样 的 工具 的 破坏 ) (Kurt) 

规则 系统 小 幅度 的 改善 

iS NOTIFY 

为 运行 时 检查 新 增 asserts 

彻底 检查 parser/analyze 代码 以 适当 的 报告 错误 和 提升 速度 
Pg_dump -d 现在 可 以 适当 的 处 理 NULL (Bruce) 

阻止 SELECT NULL 使 服务 器 崩溃 (Bruce) 

当 INSERT ... SELECT columns 不 匹配 时 适当 的 报告 错误 
当 插入 字段 名 不 正确 时 适当 的 报告 错误 

psql \g filename 现在 可 以 工作 了 (Bruce) 

psql 修复 一 行 上 的 多 个 声明 有 多 个 输出 时 的 问题 
删除 了 重复 的 系统 OID 

SELECT * INTO TABLE . GROUP/ORDER BY 如 果 表 已 经 存在 则 给 出 未 连接 的 错误 (Bruce) 
修复 了 几 个 使 后 端 崩 溃 的 查询 

插入 字符 串 中 起 始 引号 错误 (Bruce) 

提交 空 查询 现在 返回 空 状态 ， 不 只 是 " " 查询 (Bruce) 








添加 EXPLAIN 手册 页 (Bruce) 
添加 UNIQUE 索引 功能 (Dan) 


添加 hostname/user 级 别 访问 控制 而 不 只 是 hostname 和 user 
为 <> 添加 同义词 != (Bruce) 

人 允许 "select oid,* from table" 

允许 BY, ORDER BY 通过 编号 指定 字段 ， 或 通过 非 别 名 的 table.column (Bruce) 
允许 从 前 端 COPY (Bryan) 

允许 GROUP BY 使 用 别名 字段 名 (Bruce) 

允许 真实 的 压缩 ， 不 只 是 在 同一 页 上 重新 使 用 (Vadim) 

允许 安装 配置 选项 自动 添加 到 本 地 用 户 (Bryan) 

允许 libpq 区 分 文本 值 '' 和 null (Bruce) 

人 允许 非 postgres 用 户 在 destroydb 上 有 createdb 权限 
允许 限制 谁 可 以 创建 C BRK (Bryan) 

人 允许 限制 谁 可 以 在 后 端 COPY (Bryan) 

可 以 收缩 表 、pg_time 和 pg_log (Vadim & Erich) 

改变 调试 级 别 2 为 只 输出 查询 ， 改 变调 试 标题 布局 (Bruce) 
改变 缺 省 小 数 常量 表示 从 float4 到 floats (Bruce) 

当 postmaster 启动 时 设置 European 日 期 格式 

如 果 没 有 找到 准确 的 大 小 写 情 况 则 执行 小 写 的 函数 名 

修复 aggregate/GROUP 人 处理， 人 允许 'select sum(func(x),sum(x+y) from z' 
Gist 现在 包含 在 发 布 里 (Marc) 

本 地 用 户 的 身份 认证 (Bryan) 

实现 了 BETWEEN 限定 符 (Bruce) 

实现 了 IN 限定 符 (Bruce) 

libpq 有 PQgetisnull() (Bruce) 

改善 了 1ibpq++ 

新 增 选 项 到 initdb (Bryan) 

Pg_dump 人 允许 转 储 OID (Bruce) 

Pg_dump 为 了 速度 在 加 载 表 之 后 创建 索引 (Bruce) 
Pg_dumpall 转 储 所 有 数据 库 ， 和 用 户 表 

为 NULL 值 附 加 Pginterface (Bruce) 

阻止 postmaster 作为 root 运行 

psql \h 和 \? 现在 可 读 (Bruce) 

psal 允许 在 行 中 任何 地 方 有 反 向 斜 线 ， 分 号 (Bruce) 

psal 改变 了 查询 中 或 引号 中 行 的 命令 提示 符 (Bruce) 

psql char(3) 现在 在 \d 输出 中 作为 (bp)char 显示 (Bruce) 
psql 现在 返回 更 精确 的 代码 (Bryan?) 

psql 更 新 帮助 语法 (Bruce) 

重复 访问 和 修复 vacuum (Vadim) 

减少 回归 差 异 的 大 小 ， 删 除 时 区 名 差异 (Bruce) 

删除 编译 时 参数 以 启用 二 进 制 发 布 (Bryan) 

HBA 标记 的 相反 含义 (Bryan) 

本 地 用 户 的 安全 认证 (Bryan) 

加 速 vacuum (Vadim) 

vacuum 现在 有 了 VERBOSE 选项 (Bruce) 


源 代 码 树 的 改变 

所 有 琅 数 现在 有 了 和 调用 相 比 较 的 原型 

允许 维护 可 以 简单 的 在 Makefile.global 中 禁用 (Bruce) 
改变 在 代码 中 使 用 的 oid 常量 为 #define 名 

f sparc 和 solaris 的 定义 (Kurt) 

Gcc -Wall 编译 只 有 来 自 不 固定 结构 的 警告 

主要 包括 文件 reorganization/reduction (Marc) 
Make 现在 在 编译 失败 时 停止 (Bryan) 

Makefile 重组 (Bryan, Marc) 

合并 bsdi 2 1 到 bsdi (Bruce) 

删除 了 监控 程序 

更 改名 字 Postgres95 为 PostgreSQL 

新 增 config.h 文件 (Marc, Bryan) 

PG_VERSION 现在 设置 为 6.0 并 且 被 postmaster 使 用 
可 移植 性 附加 物 ， 包 括 Ultrix, DG/UX, AIX, #1 Solaris 
减少 #define 的 数量 ， 集 中 #define 
删除 系统 表 中 重复 的 OID (Dan) 

删除 重复 的 系统 目录 信息 或 报告 不 匹配 (Dan) 

删除 许多 os 特定 的 #define 

重组 目标 文件 generation/location (Bryan, Marc) 
重组 端口 特定 的 文件 位 置 (Bryan，Marc ) 

未 使 用 的 /未 初始 化 的 变量 纠正 





E.238. 版 本 1.09 


发 布 日 期 : 1996-11-04 


tO, BGR AIBERM 1.02 到 1.09 的 变更 。 有 些 在 6.0 里 列 出 来 的 修改 实际 上 包含 在 
1.02.1 到 1.09 的 版 本 中 。 


E.239. 版 本 1.02 


发 布 日 期 : 1996-08-01 


E.239.1. 从 版 本 1.02 迁移 到 版 本 1.02.1 


本 文 是 用 于 1.02.1 的 新 的 迁移 文件 。 它 包括 'copy' 的 改变 和 一 个 用 于 转换 旧 的 ASCII 文件 的 
脚本 。 


Note: 下 面 的 信息 用 于 帮助 那些 希望 从 Postgres95 1.01 和 1.02 向 Postgres95 1.02.1 
迁移 的 用 户 。 








如 果 你 刚刚 开始 使 用 Postgres95 1.02.1 并 且 不 需要 迁移 旧 的 数据 库 ， 那么 你 不 需要 
读 下 面 的 部 分 。 


x] 


248 MIABY Postgres95 版 本 1.01 或 1.02 数据 库 向 版 本 1.02.1 升级 ， 需要 进行 下 面 步骤 : 
1. 运行 新 的 1.02.1 postmaster 


2. 向 1.01 或 1.02 数据 库 中 增加 1.02.1 的 新 的 内 建 画 数 和 操作 符 。 方法 是 在 你 的 1.01 或 
1.02 的 数据 库 上 运行 新 的 1.02.1 服务 器 然后 应 用 文件 末尾 的 查询 。 这 些 工作 可 以 很 轻松 
的 通过 psa 来 完成 。 如 果 你 的 1.01 或 1.02 数据 库 叫 testo 并 且 你 已 经 把 文件 末尾 
的 命令 剪 切 下 来 并 存 人 到 文件 addfunc.sql 里 ， 那么 


% psql testdb -f addfunc.sql 


那些 从 1.02 数据 库 升 级 的 人 们 在 执行 文件 中 最 后 两 个 语句 时 会 看 到 警告 信息 ， 因为 它们 
已 经 在 1.02 中 出 现 了 。 这 些 警 告 不 会 产生 问题 。 


E.239.2. 转 储 / 重 疙 过程 


HOR AR IX] BR pg_dump 或 文本 模式 ， copy tablename to stdout 会 在 原先 的 版 本 中 生成 ， 
你 将 需要 在 加 载 到 数据 库 之 前 在 ASCII 文件 上 运行 下 面 的 sea 脚本 。 因为 原先 的 格式 用 ', 作 
为 数据 结束 符 ， 而 现在 使 用 "。 同 样 ， 现 在 空 字 符 串 用 "进行 装载 ， 而 不 是 NULL。 请 参阅 
copy 的 手册 页 获取 完整 的 细节 描述 。 


sed 's/^\.$/\\./g' <in_file >out_file 


如 果 你 从 一 个 旧 的 二 进 制 拷贝 或 非 标准 输出 拷贝 中 恢复 数据 ， 就 不 需要 做 上 述 转换 ， 因 为 不 
存在 数据 结束 符 字符 问题 。 


-- agc 添 加 的 下 列 的 行 反 应 不 区 分 大 小 写 
- - 正则 表达 式 搜索 varchar (in 1.02), #1 bpchar (in 1.02.1) 


create operator ~* (leftarg = bpchar, rightarg = text, procedure = texticregexeq); 


create operator !~* (leftarg = bpchar, rightarg text, procedure 
create operator ~* (leftarg = varchar, rightarg text, procedure 
create operator !~* (leftarg = varchar, rightarg = text, procedure = 


E.239.3. 修改 列表 


源 代码 管理 和 开发 
* 世界 各 地 的 志愿 者 团队 
* 源 代 码 树 现在 在 CVS 在 ftp.ki.net 


增强 

* psql (和 底层 的 Libpq 库 ) 现 在 对 格式 化 输出 有 了 更 多 的 选项 ， 包 括 HTML 

* pg_dump 现在 输出 模式 和 /或 数据 ， 带 有 许多 提高 完善 的 修复 。 

* psql 在 管理 shell 脚本 中 用 来 蔡 代 监控 器 。 监 控 器 将 在 下 一 个 版 本 中 停 用 。 

* 日 期 /时 间 画 数 增强 

* NULL 插入 /更 新 /比较 修复 /增强 

* TCL/TK 库 和 shell 修复 以 和 tck7.4/tk4.0 和 tcl7.5/tk4.1 一 起 工作 


Bug 修补 (多 得 说 不 完 ) 
* 索引 
* 存储 管理 
* 在 解除 参考 之 前 检查 NULL 指针 
* Makefile 修复 





新 增 端 口 

* 添加 了 SolarisX86 端口 
* 添加 了 BSD/0S 2.1 端口 
* 添加 了 DG/UX 端口 


texticregexne); 
texticregexeq); 
texticregexne) ; 


E.240. 版 本 1.01 


发 布 日 期 : 1996-02-23 


E.240.1. 从 版 本 1.0 迁移 到 版 本 1.01 


下 面 信息 是 给 那些 希望 将 数据 库 从 Postgres95 1.0 向 Postgres95 1.01 迁移 的 用 户 的 一 些 有 用 
信息 。 


如 果 你 是 刚刚 安装 完成 Postgres95 1.01 并 且 没 有 需要 迁移 的 旧 数 据 库 ， 那么 你 不 需要 阅读 
下 面部 分 。 


如 果 要 把 Postgres95 版 本 1.0 的 数据 库 向 Postgres95 版 本 1.01 迁移 ， 需 要 进行 下 面 的 步 
又 : 


1. 把 文件 src/Makefile.global 里 的 变量 NAMEDATALEN 定义 为 16， OIDNAMELEN 定义 为 
20。 


2. 决定 自己 是 否 需要 以 主机 为 基础 的 认证 (HBA) 。 


i， 如 果 你 需要 这 么 做 ， 你 必须 在 顶级 数据 目录 (通常 是 你 的 环境 变量 speta 的 值 ) 
里 创建 一 个 名 为 pg_hba 的 文件 。 我 们 在 例子 语法 里 用 src/libpq/pg_hba 代表 。 


ii， 如 果 你 不 需要 这 样 以 主机 为 基础 的 认证 ， 你 可 以 把 src/Makefile.global 里 的 下 面 
这 行 注释 掉 
HBA = 1 
要 注意 缺 省 时 以 主机 为 基础 的 认证 (HBA) 是 打开 的 ， 而 且 如 果 你 不 做 上 面 所 说 的 


步骤 A 或 B 中 的 其 中 一 步 ， 其 他 主机 上 (out-of-the-box) 的 1.01 版 本 将 不 允许 你 与 
1.0 的 数据 库 联 接 。 


3. 编译 和 安装 1.01， 但 是 不 要 执行 initdb FH, 
4. 在 进行 下 一 步 之 前 ， 终 止 1.0 的 postmaster 进程 ， 然 后 备份 你 现 有 的 $pGpATA 目录 。 


5. 把 你 的 PGpATA 环境 变量 设置 为 你 的 1.0 的 库 (的 位 置 ) ， 但 是 把 路 径 设 置 成 1.01 的 可 
执行 文件 路 径 。 


6. 把 文件 $pepATA /PG_VERSION 从 5.0 修改 成 5.1 


7. 运行 新 的 1.01 的 postmaster. 


8. 把 1.01 的 新 的 内 建 的 函数 和 操作 符 追 加 到 1.0 的 数据 库 中 去 。 这 一 步 是 通过 在 你 的 1.0 
的 库 上 运行 1.01 的 服务 器 ， 并 且 运 行 附加 的 查询 并 保存 到 文件 1.0 to_1.01.sql 中 。 如 
果 你 的 1.0 数据 库 名 为 testado ， 那 么 我 们 可 以 通过 ps 很 容易 完整 升级 工作 : 


% psql testdb -f 1.0_to_1.01.sql 


然后 执行 下 面 命 舍 〈 可 以 从 下 面 剪 切 和 拷贝 ) 


-- add builtin functions that are new to 1.01 


create function int4eqoid (int4, oid) returns bool as 'foo' 
language 'internal'; 

create function oideqint4 (oid, int4) returns bool as 'foo' 
language 'internal'; 

create function char2icregexeq (char2, text) returns bool as 'foo' 
language 'internal'; 

create function char2icregexne (char2, text) returns bool as 'foo' 
language 'internal'; 

create function char4icregexeq (char4, text) returns bool as 'foo' 
language 'internal'; 

create function char4icregexne (char4, text) returns bool as 'foo' 
language 'internal'; 

create function char8icregexeq (char8, text) returns bool as 'foo' 
language 'internal'; 

create function char8icregexne (char8, text) returns bool as 'foo' 
language 'internal'; 

create function chari6icregexeq (char16, text) returns bool as 'foo' 
language 'internal'; 

create function chari6icregexne (char16, text) returns bool as 'foo' 
language 'internal'; 

create function texticregexeq (text, text) returns bool as 'foo' 
language 'internal'; 

create function texticregexne (text, text) returns bool as 'foo' 
language 'internal'; 


-- add builtin functions that are new to 1.01 


create operator (leftarg int4, rightarg = oid, procedure = int4eqoid); 

create operator (leftarg oid, rightarg = int4, procedure = oideqint4); 

create operator ~* (leftarg = char2, rightarg = text, procedure = char2icregexeq); 
create operator !~* (leftarg = char2, rightarg = text, procedure = char2icregexne); 
create operator ~* (leftarg = char4, rightarg = text, procedure = char4icregexeq); 
create operator !~* (leftarg = char4, rightarg = text, procedure = char4icregexne); 
create operator ~* (leftarg = char8, rightarg = text, procedure = char8icregexeq); 
create operator !~* (leftarg = char8, rightarg text, procedure char8icregexne) ; 
create operator ~* (leftarg = chari6, rightarg text, procedure chari16icregexeq) ; 
create operator !~* (leftarg = chari6, rightarg = text, procedure = chari6icregexne) ; 
create operator ~* (leftarg = text, rightarg = text, procedure = texticregexeq); 
create operator !~* (leftarg = text, rightarg = text, procedure = texticregexne); 


a | 


E.240.2. 修改 列表 


不 兼容 性 : 
* 1.01 向 后 兼容 1.0 数据 库 ， 提 供 了 用 户 指导 步骤 ， 在 MIGRATION_from_1.0_to_1.01 文件 中 概述 。 
如 果 没 有 采取 这 些 步 又，1.01 是 不 与 1.0 数据 库 兼 容 的 。 


增强 : 
* 添加 了 PQdisplayTuples() 到 1ibpq 并 且 为 了 使 用 它 更 改 了 监控 器 和 psql 
* 添加 了 NeXT 端口 (需要 SysVIPC 实现 ) 
添加 了 CAST .. AS ... 语法 
添加 了 ASC 和 DESC 关键 字 
添加 了 'internal' 作为 CREATE FUNCTION 内 部 轴 数 的 可 能 语言 ，CREATE FUNCTION ARKAE C WH, 
已 经 静态 的 连接 到 了 Postgres 后 端 。 
* 为 系统 标识 符 添 加 了 一 个 新 的 类 型 "name" (RE, BEZE) 。 这 个 替换 老 的 char16 类 型 。 
通过 在 src/Makefile.global 中 的 NAMEDATALEN #define 设置 。 
* 一 个 可 读 的 参考 手册 描述 查询 语言 。 
* 添加 了 基于 主机 的 访问 控制 。 一 个 配置 文件 ($PGDATA/pg_hba ) 用 来 保存 配置 数据 。 
如 果 基 于 主机 的 访问 控制 不 再 需要 了 ， 注 释 掉 src/Makefile.global 中 的 HBA=1。 
* 更 改正 则 表达 式 义理 为 统一 的 使 用 Henry Spencer 的 正则 表达 式 代 码 ， 不 管 是 什么 平台 。 
正则 表达 式 代 码 包含 在 发 布 中 。 
为 大 小 写 不 敏感 的 正则 表达 式 添加 函数 和 操作 符 。 操 作 符 是 ~* 和 !~*。 
* pg_dump 为 了 更 好 的 性 能 使 用 COPY 而 不 是 SELECT 循环 


Bug 修复 : 

* 修复 了 一 个 优化 器 bug ， 当 画 数 调用 在 WHERE 子 句 中 用 于 比较 时 会 引起 内 核 转 储 
* 更 改 所 有 getuid 的 使 用 为 geteuid ， 这 样 就 使 用 了 有 效 的 uid 

* psql 在 使 用 -C 发 生 错 误 时 返回 非 需 的 状态 

* 应 用 了 公共 补丁 1-14 


二 "| 


+ 外 + 
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F.241. 版 本 1.0 


发 布 日 期 : 1995-09-05 


E.241.1. 修改 列表 


版 权 修改 : 
* Postgres 1.0 的 版 权 已 经 修改 放宽 到 可 以 自由 修改 和 可 以 为 任何 目的 自由 修改 。 
请 参阅 COPYRIGHT 文件 。 感 谢 Michael Stonebraker 教授 合 这 些 成 为 可 能 。 


不 兼容 性 : 
* 数据 格式 必须 是 MM-DD-YYYY (或 如 果 你 使 用 EUROPEAN STYLE 则 为 DD-MM-YYYY)。 遵 从 SQL-92 规格 。 
* "delimiters" 现在 是 一 个 关键 字 


强 : 

添加 了 sql LIKE 语法 

copy 命令 现在 接受 一 个 选项 USING DELIMITER 。 分 隔 符 可 以 是 任意 的 单字 符 字符 串 。 

添加 了 IRIX 5.3 端口 。 感 谢 Paul Walmsley 和 其 他 人 。 

升级 了 pg_dump， 使 其 可 以 与 新 的 Libpq 一 起 工作 

\d 已 经 加 入 了 psql 中 ， 感 谢 Keith Parks 

由 于 预 编译 模式 的 缓存 ， 使 用 POSIX 正则 表达 式 的 架构 的 正则 表达 式 性 能 已 经 改善 了 。 感 谢 Alistair Crooks 
libpgq++ 的 一 个 新 版 本 。 感 谢 William Wanders 


Bug 修复 : 

* 任意 的 userids 可 以 在 createuser 脚本 中 指定 

\c 连接 到 其 他 现在 正在 psql 中 工作 的 数据 库 。 

修复 了 float4inc() 的 坏 的 pg_proc 记录 

带 有 usecreatedb 字段 设置 的 用 户 现在 可 以 创建 数据 库 ， 不 必 是 超级 用 户 
当 记 录 不 再 有 任何 特权 时 删除 访问 控制 记录 

修复 了 不 方便 的 日 期 时 间 实 现 

添加 了 kerberos 标识 到 src/backend/Makefile 

libpq 现在 与 kerberos 一 起 工作 

用 户 手册 上 的 排版 错误 已 经 纠正 了 

带 有 多 个 索引 的 btree 从 不 工作 ， 现 在 我 们 告诉 你 当 你 尝试 使 用 它们 时 它们 不 会 工作 


EJEA 
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E.242. Postgres95 版 本 0.03 


发 布 日 期 : 1995-07-21 
E.242.1. 修改 列表 


不 兼容 的 变化 : 

* BETA-0.3 与 之 前 版 本 创建 的 数据 库 不 兼容 〈 由 于 系统 目录 和 索引 结构 的 改变 ) 

双 引 号 (") 作为 字符 串 文 本 的 引用 字符 已 经 弃 用 了 ; 你 需要 将 它们 转换 为 单 引 号 (' )。 

聚集 名 (如 int4sum) 为 了 与 SQL 标准 (如 sum) 一 致 已 经 重 命名 了 

CHANGE ACL 语法 被 GRANT/REVOKE 语法 替代 了 

浮 点 值 (如 3.14) 现在 是 float4 类 型 (而 不 是 在 以 前 版 本 中 的 floats) ; 

如 果 你 确定 是 float8， 你 可 能 必须 类 型 转换 。 如 果 你 忘记 了 做 类 型 转换 ， 

并 且 你 分 配 一 个 float 文本 到 一 个 floats 类 型 的 字段 ， 你 可 能 会 得 到 不 正确 的 存储 值 ! 

* LIBPQ 已 经 完全 修补 了 ， 这 样 前 端 应 用 可 以 连接 到 多 个 后 端 

* pg_user 中 的 usesysid 字段 已 经 从 int2 改变 成 int4， 以 允许 Unix AP id 有 更 广泛 的 范围 。 
* netbsd/freebsd/bsd o/s 端口 已 经 合并 到 了 一 个 单一 的 BSD44_derived 端口 。 (感谢 Alistair Crooks 





汪汪 


SQL 标准 兼容 (下 列 详细 的 改变 令 postgres95 与 SQL-92 标准 更 加 兼容 ): 
* 下 列 的 SQL 类 型 现在 是 内 建 的 : smallint, int(eger), float, real, 
char(N), varchar(N), date 和 time。 


下 列 是 现存 postgres 类 型 的 别名 : 
smallint -> int2 
integer, int -> int4 
float, real -> float4 


char(N) 和 varchar(N) 作为 截断 的 文本 类 型 实施 。 另 外 ，char (N) 有 空白 填充 。 


* 单 引号 (' ) 用 于 引用 字符 串 字 面值 ; '' (除了 \') 作为 在 一 个 字符 串 中 插入 一 个 单 引号 的 含义 来 支持 
* 使 用 SQL 标准 聚集 名 (MAX，MIN，AVG，SUM， COUNT) (还 有 ， 聚 集 现 在 可 以 重 载 ， 也 就 是 ， 

你 可 以 定义 你 自己 的 MAX 聚集 来 接受 一 个 用 户 定义 的 类 型 。) 
* 删除 了 CHANGE ACL。 添 加 了 GRANT/REVOKE 语法 。 

- 权限 可 以 通过 使 用 "GROUP" 关键 字 赋 予 一 个 组 。 


例如 : 
GRANT SELECT ON foobar TO GROUP my_group; 


关键 字 'PUBLIC' 也 支持 意 为 所 有 用 户 。 
权限 一 次 只 能 赋予 或 撤销 一 个 用 户 或 组 。 
不 支持 "WITH GRANT OPTION"。 只 有 类 的 所 有 者 可 以 改变 访问 控制 。 


- 缺 省 的 访问 控制 赋予 用 户 只 读 访问 。 你 必须 明确 授予 用 户 insert/update 访问 。 
要 改变 这 个 ， 在 定义 ACL_WORLD_DEFAULT 中 更 改行 : 
src/backend/utils/acl.h 


Bug 修复 : 

* 聚集 在 空 表 你 不 运行 的 bug 已 经 修复 了 。 现 在 ， 聚 集 在 空 表 上 运行 时 会 返回 聚集 的 初始 状态 。 

因此 ， 对 一 个 空 表 COUNT 现在 可 能 会 返回 0。 对 一 个 空 表 MAX/MIN 将 会 返回 一 个 值 为 NULL 的 行 。 
允许 在 监控 器 中 使 用 ON; 

LISTEN/NOTIFY 异步 通知 机 制 现在 可 以 工作 了 

规则 动作 体 中 的 NOTIFY 现在 可 以 工作 了 

哈 希 索引 现在 可 以 工作 了 ， 访 问 方法 一 般 来 说 应 该 执行 的 更 好 了 。 大 的 btree 索引 的 创建 应 该 更 快 了 。 
(感谢 Paul Aoki) 


其 它 修改 和 增强 : 

* 添加 了 用 于 解释 查询 执行 规划 的 EXPLAIN 语句 (如 "EXPLAIN SELECT * FROM EMP" 输 出 该 查询 的 执行 规划 ) o 

* WARN 和 NOTICE 消息 不 在 带 有 时 间 惟 。 要 启用 错误 消息 的 时 间 惟 ， 取 消 src/backend/utils/elog.h 中 下 列 
/* define ELOG_TIMESTAMPS */ 


BN. dee, of Gis 


* 在 违反 访问 控制 时 ， 会 给 出 "Either no such class or insufficient privilege" 消息 。 
当 没有 找到 类 时 给 出 同样 的 消息 。 这 让 没有 权限 的 用 户 猜测 有 权限 的 用 户 的 存在 。 
* 一 些 用 户 不 可 见 的 附加 系统 目录 已 经 做 出 了 改变 。 


libpgtcl 修改 : 

* -oid 选项 已 经 添加 到 了 "pg_result" tcl 命令 中 。pg_result -oid 返回 最 后 插入 的 行 的 oid 
如 果 最 后 的 命 合 不 是 INSERT， 那 么 pg_result -oid 返回 ""。 

* 大 对 象 接口 可 以 作为 pg_lo* tcl 命令 使 用 : pg_lo_open, pg_lo_close, pg_lo_creat, $. 


可 移植 性 增强 和 新 的 端口 : 

* flex/lex 问题 已 经 清理 了 。 现 在 ， 应 该 可 以 在 任意 平台 上 使 用 flex RË lex. 
不 用 再 假设 基于 你 使 用 的 平台 使 用 什么 lexer。 

* 现在 支持 Linux-ELF 端口 了 。 已 经 检验 了 各 种 配置 : 下 列 的 配置 已 知 是 通过 了 的 : 
kernel 1.2.10, gcc 2.6.3, libc 4.7.2, flex 2.5.2, bison 1.24 
任何 东西 都 是 ELF 格式 


新 工具 : 
* ipcclean 添加 到 发 布 
ipcclean 通常 不 需要 运行 ， 但 是 如 果 你 的 后 端 月 江 了 并 且 导 致 共 享 内 存 段 原 地 停留 ，ipcclean 将 为 你 清理 它们 。 


新 文档 : 
* 保留 了 用 户 手 册 并 添加 了 libpg 文档 。 


= 于 实业 





E.243. Postgres95 版 本 0.02 


发 布 日 期 : 1995-05-25 


E.243.1. 修改 列表 


不 兼容 的 更 改 : 

* 创建 一 个 数据 库 的 SQL 语句 是 'CREATE DATABASE' 而 不 是 'CREATEDB'。 相 似 的 ， 
删除 一 个 数据 库 的 是 'DROP DATABASE' 而 不 是 'DESTROYDB'。 不 过 ， 
可 执行 文件 'createdb' 和 'destroydb' 的 名 字 保 持 不 变 


新 工具 : 

* pgperl - a Perl (4.036) 接口 到 Postgres95 

* pg dump - a 工具 转 储 一 个 postgres 数据 库 到 一 个 包含 查询 命令 的 脚本 文件 。 
该 脚本 文件 是 ASCII 格式 的 并 且 可 以 用 来 重建 该 数据 库 ， 即 使 是 在 其 他 机 器 和 其 他 架构 上 。 
(转换 Postgres 4.2 数据 库 到 Postgres95 数据 库 也 是 很 好 的 。) 


下 列 接口 已 经 并 入 postgres95-beta-0.02 中 了 : 

* Alistair Crooks 做 的 NetBSD 接口 

* Mike Tung 做 的 AIX 接口 

* Jon Forrest 做 的 Windows NT 接口 (更 多 东西 但 是 还 未 完成 ) 
* Brian Gallew 做 的 Linux ELF 接口 


下 列 pug 在 postgres95-beta-0.02 中 已 经 被 修复 了 : 

新 行 在 COPY OUT 中 不 逃逸 和 第 一 个 属性 是 一 个 '.' 时 的 COPY OUT 的 问题 
在 createuser 中 不 能 返回 使 用 缺 省 的 用 户 id 

SELECT DISTINCT EARE AAA 

Linux 安装 问题 

监控 器 不 允许 'localhost' 作为 PGHOST 使 用 

当 进 行 \c 或 \L 时 psql 内 核 转 储 

"pgtclsh" 目标 从 src/bin/pgtclsh/Makefile 中 丢失 
libpgtcl 有 一 个 硬 链接 的 缺 省 端口 号 

SELECT DISTINCT INTO TABLE 挂 起 

CREATE TYPE 不 接受 'variable' 作为 internallength 
在 一 个 SELECT 中 错误 的 结果 使 用 多 于 1 的 聚集 
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E.244. Postgres95 版 本 0.01 


发 布 日 期 : 1995-05-01 


最 初 发 布 版 本 。 


Appendix F. 额外 提供 的 模块 


Table of Contents 


e F.1. adminpack 

e F.2. auth_delay 

e F.3. auto_explain 

e F.4. btree_gin 

e F.5. btree_gist 

e F.6. chkpass 
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e F.8. cube 

e F.9. dblink 

e F.10. dict_int 

e F.11. dict_xsyn 

e F.12. dummy_seclabel 
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e F.14. file_fdw 
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e F.23. passwordcheck 
e F.24. pg_buffercache 
e F.25. pgcrypto 
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e F.27. pgrowlocks 

e F.28. pg_stat_statements 
e F.29. pgstattuple 

e F.30. pg_trgm 

e F.31. postgres_fdw 
e F.32. seg 

e F.33. sepgsdql 

e F.34. spi 

e F.35. sslinfo 


e F.36. tablefunc 
e F.37. tcn 

e F.38. test_parser 
e F.39. tsearch2 

e F.40. unaccent 
e F.41. uuid-ossp 
e F.42. xml2 


本 附录 和 下 一 个 包含 可 以 在 PostgreSQL & 7H contrib 目录 中 找到 的 模块 信息 。 这 些 包括 
移植 工具 ， 分 析 工 具 ， 和 不 是 核心 PostgreSQL 系 统 部 分 的 插件 功能 ， 主要 因为 他 们 关注 于 有 
限 的 读者 或 者 太 实验 而 不 是 主要 源码 树 的 一 部 分 。 这 并 不 妨碍 他 们 有 效 性 。 


该 附录 包含 扩展 以 及 在 contrib 中 发 现 的 服务 器 插件 模块 。 Appendix G 包 含 实用 程序 。 


当 从 源码 发 布 中 编译 时 ， 这 些 组 件 不 能 自动 创建 ， 除非 你 建立 "world" 目 标 (参阅 step 2)。 你 
可 以 通过 运行 下 面 命令 创建 和 安装 : 


<kbd class="literal">gmake</kbd> 
<kbd class="literal">gmake install</kbd> 


在 配置 的 源码 树 的 contrib 目录 中 或 编译 和 安装 一 个 选 定 的 模块 ， 在 该 模块 的 子 目 录 做 同样 
的 事 。 许多 模块 可 以 进行 回 为 测试 ， 可 以 通过 运行 下 面 命 命 被 执行 : 


<kbd class="literal">gmake check</kbd> 


在 安装 前 或 者 


<kbd class="literal">gmake installcheck</kbd> 


一 旦 你 有 正 运 行 的 PostgreSQL 服 务 器 。 


如 果 您 使 用 的 是 PostgreSQL 的 预 包装 版 本 ， 这 些 模块 通常 可 以 作为 一 个 单独 的 包 ， 


如 postgresql-contrib 。 
许多 模块 提供 新 的 用 户 自 定义 函数 ， 操 作 符 ， 或 类 型 。 为 了 利用 其 中 一 个 模块 ， 在 你 安装 代 


码 之 后 你 需要 在 数据 库 系 统 中 注册 新 的 SQL 对 象 。 在 PostgreSQL 9.1 和 以 后 版 本 ， 这 是 通过 
执行 CREATE EXTENSION 命 令 来 实现 。 在 一 个 新 的 数据 库 中 ， 你 可 以 简单 地 做 


CREATE EXTENSION _module_name_; 


此 命令 必须 由 数据 库 管 理 员 运 行 。 这 个 在 当前 数据 库 中 注册 新 的 SQL 对 象 ， 所 以 你 需要 在 你 
想 要 该 模 块 的 功能 可 用 的 每 个 数据 库 中 运行 这 个 OT. AM, 在 数据 库 templatel 中 运行 
它 ， 这 样 扩展 将 被 复制 到 缺 省 随后 创建 的 数据 库 中 。 


许多 模块 允许 你 在 你 选择 的 模式 中 安装 对 象 。 要 做 到 这 一 点 ， 添 加 scHEMA 
_schema_name ”到 CREATE EXTENSION MT, 默认 情况 下 ， 该 对 象 业 被 放置 在 当前 创建 的 目标 
模式 中 ， 通 常 puplic 。 


如 果 你 的 数据 库 通 过 转 储 提 出 ， 并 且 从 PostgreSQL9.1 之 前 版 本 恢复 ， 你 在 它 的 模块 的 先前 
9.1 版 本 使 用 过 ， 你 应 该 蔡 代 做 


CREATE EXTENSION _module_name_ FROM unpackaged; 


这 将 更 新 模块 的 9.1 之 前 对 象 到 一 个 适当 的 扩展 对 象 。 通过 ALTER EXTENSION 管 理 未 来 更 
新 模块 。 关于 扩展 更 新 的 更 多 信息 ， 参 见 Section 35.15。 


注意 ， 然 而 ， 这 些 模 块 在 这 个 意义 上 不 是 "扩展 "， 但 在 一 些 其 他 的 方式 中 被 加 载 到 服务 器 ， 
比如 通过 shared preload libraries, 参见 每 个 模块 的 文档 获取 更 多 信息 。 


F.1. adminpack 


adminpack teh  —EpgAdminS R Ae ERAR ， 并 且 管 理工 具 可 以 用 于 提供 额外 的 
功能 ， 比 如 远程 管理 服务 器 的 日 志文 件 。 


通过 adminpack 实现 的 该 函数 只 能 由 超级 用 户 运 行 。 这 里 列 出 了 这 些 本 数 : 


int8 pg_catalog.pg_file_write(fname text, data text, append bool) 

bool pg_catalog.pg_file_rename(oldname text, newname text, archivename text) 
bool pg_catalog.pg_file_rename(oldname text, newname text) 

bool pg_catalog.pg_file_unlink(fname text) 

setof record pg_catalog.pg_logdir_1ls() 

/* 为 了 pgAdmin 兼 容 性 重 命名 已 经 存在 的 后 端 钞 数 */ 

int8 pg_catalog.pg_file_read(fname text, data text, append bool) 

bigint pg_catalog.pg_file_length(text) 

int4 pg_catalog.pg_logfile_rotate() 


F.2. auth_delay 


auth_delay 导致 服务 器 在 报告 认证 失败 之 前 短暂 停止 ， 使 得 暴力 攻击 数据 库 密 码 更 难 。 注 
意 它 并 不 能 防止 拒绝 服务 攻击 ， 其 至 可 能 悉 化 它们 ， 因为 报告 验证 失败 之 前 等 待 的 过 程 将 损 
耗 连接 模 位 。 


为 了 该 图 数 ， 这 个 模块 必须 通过 postgresql.conf 中 的 shared preload libraries 被 加 载 。 


F.2.1. 配置 参数 


auth_delay.milliseconds ( int ) 
报告 认证 失败 之 前 等 待 的 毫秒 数 ， 缺 省 是 0。 


这 些 参数 必须 在 postgresql.conf 中 设置 。 典型 的 用 法 可 能 是 : 


# postgresql.conf 
shared_preload_libraries = 'auth_delay' 


auth_delay.milliseconds = '500' 


F.2.2. 作者 


KaiGai Kohei &1t; [kaigai@ak.jp.nec.com](mailto:kaigai@ak.jp.nec.com)&gt; 


F.3. auto_explain 

auto_explain 模块 自动 提供 一 种 慢 语句 记录 执行 计划 的 方法 没有 手动 运行 EXPLAIN。 这 对 
于 在 大 型 应用 程序 中 跟踪 未 优化 查询 尤其 有 用 。 

该 模块 没有 提供 SQL 访问 画 数 。 为 了 使 用 它 ， 简 单 加 载 它 到 服务 器 中 。 你 可 以 加 载 它 到 独立 
会 话 中 : 


LOAD 'auto_explain'; 


(你 一 定 是 超级 用 户 才能 这 样 做 。) 更 典型 的 用 法 是 预先 加 载 它 到 在 postgresql.conf 中 
shared_preload_libraries 包含 auto_explain 的 所 有 会 话 。 然 后 ， 你 可 以 出 乎 意料 地 跟踪 无 论 
什么 时 候 会 发 生 的 慢 查 询 。 当然 有 价值 开销 。 


F.3.1. 配置 参数 


有 几 个 配置 参数 控制 auto_explain 的 操作 。 注意 ， 缺 省 操作 是 什么 也 不 做 ， 如 果 你 想 要 任何 


结果 ， 那么 你 必须 至 少 设 置 auto_explain.log_min_duration o 
auto_explain.log_min_duration ( integer ) 


auto_explain.log_min_duration 是 最 小 声明 执行 时 间 ， 以 毫秒 为 单位 ， 将 导致 语句 的 计划 被 
记录 。 设 置 它 为 需 记 录 所 有 计划 。 减 一 CRA) 禁止 计划 的 记录 。 比 如 ， 如 果 你 设置 它 

为 256ms ， 那么 运行 250ms 或 者 更 长 时 间 的 所 有 语句 将 被 记录 。 只 有 超级 用 户 可 以 改变 这 个 
设置 。 


auto_explain.log_analyze ( boolean ) 


auto_explain.log_analyze $34 EXPLAIN ANALYZE 输出 ， 而 不 是 ExPLAIN 输出 ， 当 记录 一 个 执 
行 计划 时 ， 被 打印 。 该 参数 缺 省 是 关闭 的 。 只 有 超级 用 户 可 以 改变 这 个 设置 。 
Note: 当 该 参数 打开 时 ， 为 所 有 执行 语句 产生 每 个 计划 节点 时 间 ， 无 论 他 们 是 否 运行 足 
够 长 的 时 间 来 获得 记录 。 这 会 对 性 能 产生 极其 不 利 的 影响 。 





auto_explain.log verbose ( boolean ) 


auto_explain.log_verbose 导致 EXPLAIN VERBOSE 输出 ， 而 不 是 ExPLAIN 输出 ， 当 记录 一 个 执 


行 计划 时 ， 被 打印 。 该 参数 缺 省 是 关闭 的 。 只 有 超级 用 户 可 以 改变 这 个 设置 。 


auto_explain.1og_buffers ( boolean ) 


auto_explain.log_buffers 导致 EXPLAIN(ANALYZE, BUFFERS) 输出 ， 而 不 是 ExPLAIN 输出 ， 当 
记录 一 个 执行 计划 时 ， 被 打印 。 该 参数 缺 省 是 关闭 的 。 只 有 超级 用 户 可 以 改变 这 个 设置 。 该 
参数 不 起 作用 除非 设置 auto_explain.log_analyze BR, 


auto_explain.log format ( enum ) 


auto_explain.log_ format 选择 使 用 ExpPLAIN 输出 格式 。 人 允许 值 是 text , xml, 
json 和 yaml 。 缺 省 是 text。 只 有 超级 用 户 可 以 改变 这 个 设置 。 


auto_explain.log_timing ( boolean ) 


auto_explain.log_timing X EXPLAIN (ANALYZE, TIMING off) 输出 , 而 不 

是 EXPLAIN (ANALYZE) 输出 。 反复 读 取 系统 时 钟 的 开销 可 以 显著 减缓 一 些 系 统 上 的 查询 ， 因 此 
当 计 算 实际 行 时 ， 设 置 该 参数 为 关闭 是 非常 有 用 的 ， 不 需要 确切 时 间 。 AB 

动 auto_explain.1og_analyze 时 ， 该 参数 是 有 效 的 。 缺 省 该 参数 是 打开 的 。 只 有 超级 用 户 可 
以 改变 该 设置 。 


auto_explain.log_nested_statements ( boolean ) 


auto_explain.log_nested_statements #Si@HFMRESD (语句 在 函数 内 执行 ) 。 当 它 是 
关闭 时 ， 只 记录 顶级 查询 计划 。 该 参数 缺 省 是 关闭 的 。 只 有 超级 用 户 可 以 改变 这 个 设置 。 


必须 在 postgresql.conf 中 设置 该 参数 ， 典 型 的 用 户 是 : 
# postgresql.conf 
shared_preload_libraries = 'auto_explain' 


auto_explain.log_min_duration = '3s' 


F.3.2. 例子 


postgres=# LOAD 'auto_explain'; 
postgres=# SET auto_explain.log_min_duration = 0; 
postgres=# SELECT count(*) 

FROM pg_class, pg_index 

WHERE oid = indrelid AND indisunique; 


这 可 能 产生 日 志 输 出 比如 : 


LOG: duration: 3.651 ms plan: 
Query Text: SELECT count(*) 
FROM pg_class, pg_index 
WHERE oid = indrelid AND indisunique; 
Aggregate (cost=16.79..16.80 rows=1 width=0) (actual time=3.626..3.627 rows=1 loops=1) 
-> Hash Join (cost=4.17..16.55 rows=92 width=0) (actual time=3.349..3.594 rows=92 1 
Hash Cond: (pg_class.oid = pg_index.indrelid) 


-> Seq Scan on pg_class (cost=0.00..9.55 rows=255 width=4) (actual time=0.016 
-> Hash (cost=3.02..3.02 rows=92 width=4) (actual time=3.238..3.238 rows=92 1 
Buckets: 1024 Batches: 1 Memory Usage: 4kB 


-> Seq Scan on pg_index (cost=0.00..3.02 rows=92 width=4) (actual time= 
Filter: indisunique 


‘| =e 


F.3.3. 作者 


Takahiro Itagaki 
&1t; [itagaki.takahiro@oss.ntt.co.jp](mailto:itagaki.takahiro@oss.ntt.co.jp)&gt; 








F.4. btree_gin 


btree_gin 提供 简单 的 GIN 操 作 符 类 实现 数据 类 型 int2 , int4 , int8 , float4 ，Tfloat8 ， 


timestamp with time zone , timestamp without time zone , time with time zone , 


time without time zone , date , interval , oid , money , "char" , varchar , text, 


bytea , bit , varbit , macaddr , inet 和 cidr BY B-tree 等 价 操 作 。 


总 的 来 说 ， 这 些 操 作 符 类 不 会 超过 等 值 标准 的 B 树 索引 方法 ， 他 们 缺乏 标准 B 树 代码 的 一 个 主 
要 特点 : 强制 唯一 性 的 能 力 。 然 而 ， 它们 对 GIN 测 试 是 有 用 的 ， 并 且 作 为 开发 其 他 GIN 操 作 符 
类 的 基础 。 同时 ， 对 于 查询 ， 同 时 测试 了 GIN 可 索引 列 和 B 树 可 索引 列 ， 对 于 创建 使 用 这 些 
操作 符 类 之 一 的 多 列 GIN 索 引 比 创建 通过 位 图 与 进行 联合 的 两 个 独立 索引 更 加 有 效 。 


F.4.1. 例子 用 法 


CREATE TABLE test (a int4); 


- 创建 索引 
CREATE INDEX testidx ON test USING gin (a); 


- 查询 
SELECT * FROM test WHERE a < 10; 


F.4.2. 作者 


Teodor Sigaev ( &lt; [teodor@stack.net](mailto:teodor@stack.net)&gt; ) 和 Oleg Bartunov 


( &1t; [oleg@sai.msu.su](mailto:oleg@sai.msu.su)&gt; )。 参阅 
http://www.sai.msu.su/~megera/oddmuse/index.cgi/Gin 获取 额外 信息 。 


F.5. btree_gist 


btree_gist 提供 GiST 索 引 操 作 符 类 实现 数据 类 型 int2 ， int4 , int8 , float4 , floats , 
numeric , timestamp with time zone , timestamp without time zone , time with time zone , 
time without time zone , date , interval , oid , money , char , varchar , text , bytea , 


bit , varbit , macaddr , inet 和 cidr B-tree 等 价 操作 。 


总 的 来 说 ， 这 些 操作 符 类 不 会 超过 等 值 标准 的 B 树 索引 方法 ， 他 们 缺乏 标准 B 树 代码 的 一 个 主 
要 特点 : 强制 唯一 性 的 能 力 。 然 而 ， 它们 提供 一 些 不 可 用 于 B 树 索引 的 其 他 功能 ， 正 如 下 面 描 
述 的 。 另外 当 需 要 多 列 GiST 索 引 时 ， 这 些 操作 符 类 是 有 用 的 ， 其 中 一 些 列 是 唯一 可 以 使 用 
GiST 可 索引 的 数据 类 型 但 是 其 他 列 仅 仅 是 简单 的 数据 类 型 。 最 终 ， 这 些 操作 符 类 对 GiST 测 
试 是 有 用 的 ， 并 且 作 为 开发 其 他 GiST 操 作 符 类 的 基础 。 


除了 典型 的 B 树 搜索 操作 符 ， btree_gist 还 提供 索引 支持 &1t;&gt; ("RS"), 这 可 能 在 与 
exclusion constraint 结 合 中 很 用 ， 正如 下 面 描述 。 


另外 ， 对 于 数据 类 型 是 一 种 天 然 的 距离 度量 ， btree_gist 定义 了 一 个 距离 操作 符 &lt;-&gt; , 
并 且 使 用 该 操作 符 为 最 近 相 邻 搜索 提供 GiST 索 引 支 持 。 为 int2, int4, ints, floata, 
float8 , timestamp with time zone , timestamp without time zone , 


time without time zone , date , interval , oid 和 money 提供 距离 操作 符 。 


F.5.1. 例子 用 法 
使 用 btree_gist 而 不 是 btree 的 简单 例子 : 


CREATE TABLE test (a int4); 
- 创建 索引 
CREATE INDEX testidx ON test USING gist (a); 
- 查询 
SELECT * FROM test WHERE a < 10; 
- 最 近 相 邻 搜索 : 找到 最 接近 "42" 的 十 项 
SELECT *, a <-> 42 AS dist FROM test ORDER BY a <-> 42 LIMIT 10; 


使 用 排斥 约束 可 以 执行 该 规则 动物 园 笼子 里 只 能 包含 一 种 动物 : 


=> CREATE TABLE zoo ( 
cage INTEGER, 
animal TEXT, 
EXCLUDE USING gist (cage WITH =, animal WITH <>) 


Ne 


=> INSERT INTO zoo VALUES(123, 'zebra'); 

INSERT 0 1 

=> INSERT INTO zoo VALUES(123, 'zebra'); 

INSERT 0 1 

=> INSERT INTO zoo VALUES(123, 'lion'); 

ERROR: conflicting key value violates exclusion constraint "zoo_cage_animal_excl" 
DETAIL: Key (cage, animal)=(123, lion) conflicts with existing key (cage, animal)=(123, 
=> INSERT INTO zoo VALUES(124, 'lion'); 

INSERT 0 1 


«| ra 


F.5.2. 作者 


Teodor Sigaev ( &1t; [teodor@stack.net](mailto:teodor@stack.net)&gt; ), Oleg Bartunov 











( &lt;[oleg@sai.msu.su](mailto:oleg@sai.msu.su)&gt; ) 和 Janko Richter 
( &1t; [jankorichter@yahoo.de] (mailto: jankorichter@yahoo.de)&gt; )。 参阅 
http://www.sai.msu.su/~megera/postgres/gist/ 获取 额外 信息 。 


F.6. chkpass 


该 模块 实现 用 于 存储 加 密 密 码 的 数据 类 型 chkpass 。 每 个 密码 自动 转换 为 加 密 进 入 ， 并 且 总 
是 存储 加 密 的 。 为 了 比较 ， 简单 比较 清晰 的 文本 密码 ， 并 且 在 比较 之 前 比较 函数 将 对 它 加 
密 。 


如 果 密 码 容 易 被 破解 ， 那 么 代码 中 有 规定 可 以 报告 错误 。 然而 ， 目 前 只 是 stub， 什 么 都 不 
做 。 


如 果 输 入 字符 串 前 面 加 冒号 ， 它 被 认为 是 一 个 已 加 密 密 码 ， 没 有 进一步 加 密 存 储 。 这 人 允许 先 
前 加 密 密 码 进入 。 


在 输出 上 ， 冒 号 在 前 。 这 可 能 各 份 并 且 重 载 没 有 重新 加 密 的 密码 。 如 果 你 想 要 不 带 冒号 的 加 
密 密 码 ， 那 么 使 用 raw() 函数 。 这 人 允许 你 使 用 带 有 类 似 Apache 的 Auth_PostgresQL 模块 的 类 
型 。 


MAEA EUN crypto, 所 以 它 会 遭受 该 图 数 所 有 常见 局 限 性 ; 值得 注意 的 是 ， 
只 考虑 前 八 个 字符 的 密码 。 


注意 chkpass 数据 类 型 是 不 可 索引 的 。 
示例 用 法 : 


test=# create table test (p chkpass); 
CREATE TABLE 

test=# insert into test values ('hello'); 
INSERT 0 1 

test=# select * from test; 


:dVGkpXdOrE3ko 
(1 row) 


test=# select raw(p) from test; 
raw 


dVGkpxXdOrE3ko 
(1 row) 


test=# select p = 'hello' from test; 
?column? 


(1 row) 


test=# select p = 'goodbye' from test; 
?column? 


F.6.1. 作者 


D'Arcy J.M. Cain ( &1t; [darcy@druid.net](mailto:darcy@druid.net)&gt; ) 


F.7. citext 


citext 模块 提供 不 区 分 大 小 写字 符 串 类 型 ， 
否则 ， 它 的 操作 很 像 text 。 


用 lower o 


F.7.1. 


基本 原理 


citext o 


从 本 质 上 讲 ， 当 比较 值 时 ， 它 内 部 调 


当 比 较 值 时 ， 在 PostgreSQL 中 执行 不 区 分 大 小 写 匹 配 的 标准 方法 佛 使 用 lower 函数 ， 上 比如 


SELECT * FROM tab WHERE lower(col) = LOWER(?); 


这 个 执行 的 相当 好 ， 但 有 一 些 缺 点 : 


。 它 使 你 的 SQL 语句 宛 长 ， 并 且 你 总 是 在 列 和 查询 值 上 使 用 lower o 


。 它 不 使 用 索引 ， 除 非 你 使 用 lower 创建 一 个 函数 索引 。 


e。 如 果 你 声明 列 为 uNIQUE 或 者 PRIMARY KEY ， 隐 式 产 生 的 索引 是 大 小 写 敏 感 的 。 因此 对 
不 区 分 大 小 写 搜索 无 用 ， 并 且 它 不 会 不 区 分 大 小 写 。 


citext 数据 类 型 允许 你 在 SQL 查询 中 删除 调用 lower ， 


写 。 citet 是 区 域 意识 ， 
据 库 的 Lc_cTYPE 设置 规则 。 
通过 数据 类 型 透明 地 完成 ， 


就 像 text ， 


F.7.2. 如 何 使 用 它 


这 是 用 法 的 一 个 简单 例子 : 


CREATE TABLE users ( 
nick CITEXT PRIMARY KEY, 
pass TEXT NOT NULL 


i 


INSERT 
INSERT 
INSERT 
INSERT 
INSERT 


SELECT 


INTO users VALUES 
INTO users VALUES 
INTO users VALUES 
INTO users VALUES 
INTO users VALUES 


( 
( 
( 
( 
( 


‘larry', 
'Tom', 
"Damian', 
'NEAL', 
'Bjørn', 


md5(random(): 
md5(random(): 
md5(random(): 
md5(random(): 
md5(random(): 


* FROM users WHERE nick = 'Larry'; 


并 且 人 允许 主键 不 区 分 大 小 

这 意味 着 大 写字 母 和 小 写字 母 字 符 的 匹配 依赖 于 数 
另外 ， 这 种 操作 与 查询 中 lower 的 使 用 是 相同 的 。 但 是 因为 它 
你 无 须 记得 在 你 的 查询 中 执行 任何 特别 的 。 


:text) 
:text) 
:text) 
:text) 
:text) 


SELECT 语句 将 返回 一 个 元 组 ， 尽管 nick 列 被 设置 为 larry 


wee we ww 
MeN Ne Ne Ne 


， 并 且 查 询 为 Larry 。 


r&n > +5 
F.7.3. 字符 串 比较 操作 
citext 通过 转换 每 个 字符 串 到 小 写 执 行 比较 (尽管 调用 lower) 并 且 然 后 通常 比较 结果 。 
因此 ， 比 如 ， 考 虑 两 个 字符 串 相 等 ， 如 果 lower 为 了 它们 可 能 产生 相同 结果 。 


为 了 尽 可 能 地 模拟 不 区 分 大 小 写 排 序 规 则 ， 有 一 些 字符 串 多 理 操作 符 和 画 数 的 citext 特定 版 
A, 所 以 ， 比 如 ， 当 应 用 于 citext :他 们 不 区 分 大 小 写 匹 配 ， 正则 表达 式 运 算 符 ~ 和 ~* 表 
现 出 相同 操作 。 对 于 !~ and !-* 以 及 LIkE 运算 符 -~ 和 -~-* 和 !~~ 和 !~~* ABS, 
如 果 你 想 要 匹配 大 小 写 敏感 ， 你 可 以 投射 运算 符 的 参数 给 text o 


类 似 地 ， 如 果 它 们 参数 是 citext ， 所 有 下 面 的 画 数 执行 不 区 分 大 小 写 匹 配 : 
e regexp_replace() 
e regexp_split_to_array() 
e regexp_split_to_table() 
e replace() 
e split_part() 
® strpos() 


e translate() 


对 于 正则 表达 式 函 数 ， 如 果 你 想 要 匹配 大 小 写 敏感 ， 你 可 以 声明 "c" 标 记 以 强迫 大 小 写 匹 
配 。 否 则 ， 如 果 你 想 要 大 小 写 敏 感 操 作 ， 你 必须 在 使 用 这 些 画 数 之 一 前 投射 到 text o 


F.7.4. 限制 


e citext AUP SEER RMA 你 的 数据 库 的 Lc_cTYPE 设置 。 当 创建 数据 库 时 ， 决定 如 何 比 
较 值 。 通 过 Unicode 标 准 定义 的 术语 中 不 是 真 的 大 小 写 不 敏感 。 实际 上 ， 这 意味 着 ， 只 
要 你 对 你 的 排序 规则 满意 ， 你 应 该 对 citext 的 比较 感到 满意 。 但 是 如 果 你 有 数据 以 不 
同 语言 存储 在 数据 库 中 ， 如 果 排 序 规则 为 另外 一 种 语言 ， 那么 一 种 语言 的 用 户 可 能 发 现 
查询 结果 不 如 预期 。 


作为 PostgreSQL 9.1, 你 可 以 附属 coLLATE 规范 到 citext 列 或 者 数据 值 。 当 上 比较 折 受 
FE, citext 运算 符 将 接受 非 缺 省 coat 规范 ， 但 小 宇 的 起 初 折 达 总 是 按照 数 
据 库 的 Lc_ctYPE 设置 被 执行 〈 即 ， 即 使 给 定 coLLATE "default" ) o 这 可 能 在 未 来 版 本 
中 被 改变 ， 因 此 这 两 个 步骤 遵循 输入 coLLATE 规范 。 


citext MR text 一 样 有 效 ， 因为 运算 符 函 数 和 B 树 比较 函数 必须 开始 数据 拷贝 ， 并 且 
为 了 比较 将 它 转换 为 小 写 。 然 而 ， 它 比 起 使 用 lower 获取 大 小 写 不 敏感 匹配 更 加 有 效 。 


。 如 果 你 需要 数据 比较 某 些 情况 中 大 小 写 敏 感 和 其 他 情况 中 大 小 写 不 敏感 ， citext 没有 
太 大 帮助 。 当 你 需要 不 区 分 大 小 写 比 较 时 ， 标准 答案 是 使 用 text 类 型 并 且 手 动 使 
用 lower 函数 。 如 果 很 少 需要 不 区 分 大 小 写 比较 ， 那么 它 执 行 正确 。 如 果 你 需要 不 区 
分 大 小 写 行为 大 多 数 时 间 并 且 很 少 不 区 分 大 小 写 ， 当 你 想 要 区 分 大 小 写 比 较 时 ， 考虑 存 
储 数据 为 citext 并 且 明 确 投射 该 列 到 text. 如 果 你 想 要 快速 搜索 的 两 个 类 型 ， 在 这 
两 种 情况 下 ， 你 将 需要 两 个 索引 。 


。 包含 citext 运算 符 的 模式 必须 在 当前 的 search_path (通常 public ) 中 ; 如 果 不 是 ， 相 反 
调用 正常 的 大 小 写 敏感 text 运算 符 。 


F.7.5. 作者 


David E. Wheeler glt;[david@kineticode.com] (mailto:david@kineticode.com)&gt; 


灵感 来 源 于 Donald Fraser 的 最 初 的 citext 模块 。 


F.8. cube 


这 个 模块 为 了 表示 多 维 立方 体 实现 了 数据 类 型 cube o 


F.8.1. 语法 


Table F-1 为 cube 类 型 显示 有 效 外 部 表示 。 _x ，_y 等 表示 浮 点 数 。 


Table F-1. Cube 外 部 表示 








Ze 一 维 点 (或 者 ， 雳 长 度 一 维 间隔 ) 
m) 同上 
vee 7 eee xn n 维 空间 点 ， 内 部 表示 为 需 体 积 立 方 体 
(SS R... xn_ ) 同上 
eS 一 维 间隔 起 始 于 _x_ 并 且 结束 于 y 或 者 反之 亦 然 ; 
顺序 并 不 重要 
EED E 同上 
一 个 n 维 立方 体 通过 一 对 斜 对 角 线 地 对 立 角 表 示 
C E N jia 


它 无 关 立 方 体 的 相对 角 进 入 的 哪个 顺序 。 如 果 需 要 创建 一 个 统一 的 "左下 一 右上 "内 部 表示 ， 
该 cube MAA Hk A. 


忽略 空格 ， 因 此 Cox y )] 和 [( _x ),( _y )] 是 一 样 的 。 


F.8.2. 精确 度 


值 内 部 被 存储 为 64 位 浮 点 数 。 这 意味 着 超过 16 位 有 效 数字 将 被 截断 。 


F.8.3. 用 法 


cube 模块 包含 cube 值 的 GiST 索 引 操作 类 。 通过 GiST 操 作 符 类 支持 的 操作 符 显示 在 Table F- 
2 中 。 


Table F-2. Cube GiST 运算 符 


运算 符 描述 


a=b 立方 体 a 和 b 是 相同 的 。 

a && b 立方 体 a 和 b 重 各 

a @&gt; b 立方 体 a 包 含 立 方 体 b。 

a &lt;@ b 立方 体 a 被 包含 在 立方 体 b 中 。 


(PostgreSQL 8.2 之 前 ， 包含 操作 符 @&gt; 和 &1t;@ 分 别称 为 @ 和 ~ 。 这 些 名 字 仍 然 可 
用 ， 但 是 被 否决 并 且 最 终 被 废弃 。 请 注意 旧 的 名 称 从 先前 遵循 核心 几何 数据 类 型 的 规定 中 被 
有 反 转 1) 


提供 标准 B 树 运算 符 ， 上 比如 


[a, b] alt; [c, d] WF 


[a, b] &gt; [c, d] Uae 


这 些 操作 符 没 有 任何 实际 目的 意义 但 排序 。 这 些 操作 符 首先 比较 (a) 和 (c)， 如 果 是 相等 的 ， 
那么 比较 (b) 和 (d)。 导致 在 某 些 情况 下 合理 排序 ， 如 果 你 想 使 用 这 种 类 型 的 ORDER BY， 那 
么 它 是 有 用 的 。 


Table F-3 2 a5) ABR 


Table F-3. Cubei 2% 


cube(float8) i Elcube 
cube(floats, floats)i&lcube 


cube(float8[] ) 返 回 cube 


cube(float8[]，float8[] ) 返 回 cube 


cube(cube，Tfloat8) 返 回 cube 


cube(cube，float8，float8) 返 回 cube 


cube_dim(cube ) 返 回 int 


两 个 坐标 相同 的 一 维 立方 体 。 cube(1) = 
一 维 立 方 体 。 cube(1,2) == '(1),(2)' 
使 用 数组 定义 的 坐标 的 需 体积 立方 体 。 


通过 两 个 数组 定义 的 右上 和 左下 坐标 的 Y 
cube Gel Ziel O ae ll A lo at 


通过 添加 一 个 维度 到 新 坐标 两 个 音 Bo 48 I 
xt Fk Mit Ba 2 ILA hee 


REBAR, cube('(4,2)',3,4) 


返回 立方 体 的 维 数 


cube_11_coord(cube，int) 返 回 qdouble 


返回 立方 体 左下 角 的 第 n 个 坐标 值 
返回 立方 体 右 上 角 的 第 n 个 坐标 值 
cube_is_point(cube) 返 回 bool 如 果 cube 是 一 点 ， 那 么 返回 真 。 也 就 是 ; 
返回 两 个 立方 体 之 间 的 距离 。 如 果 两 个 : 


从 一 个 已 经 存在 立方 体 构建 新 的 立方 体 ， 
找 单 维 的 LL 和 UR 坐标 ， 上 比如， 

cube_subset(cube('(1,.3,5), (6, 7,8)"), A 
度 ， 或 者 按照 需要 重新 排序 它们 ， 比 如 


cube_subset(cube('(1,3,5),(6, 7,8)" ), A 


cube_ur_coord(cube, int)3i&[ldouble 


cube_distance(cube, cube)i&[ldouble 


cube_subset(cube, int[])i&[&lcube 


cube_union(cube, cube)3&[lcube 产生 两 个 立方 体 并 集 
cube_inter(cube，cube) 返 回 cube 产生 两 个 立方 体 交 集 


通过 至 少 n 维 的 指定 半径 增加 立方 体 大 小 
围 搜 索 临 近 点 创建 边界 区 域 是 很 有 用 的 。 
cube_enlarge(cube c, double r, int n) 返 回 cube 了 r，UR 坐 标 增 加 了 r。 如 果 LL 坐 标 增 加 
RA) 上 比 起 两 个 坐标 系 被 设置 为 平均 来 1 
增加 (r >= 0)， 然后 使 用 0 作为 额外 坐标 i 


F.8.4. 缺 省 
我 相信 这 个 联合 : 


select cube_union('(0,5,2),(2,3,1)', 'O'); 
cube_union 


(1 row) 


select cube“anten(’ (0,-1), 72)", “G2),(2)")+ 
cube_inter 


(9, 0), (4, 0) 
(1 row) 


在 不 同 的 维度 立方 体 的 所 有 二 进 制 运算 中 ， 我 认为 降低 笛 卡 尔 积 投影 维 数 ， 比 如 ， 在 字符 串 
表示 中 忽略 坐标 的 地 方 为 需 。 上 面 例子 等 同 于 : 


cube_union('(0,5,2),(2,3,1)', '(@,0,®),(0,0,®)'); 
cube_inter('(0,-1),(1,1)','(-2,9),(2,0)'); 


下 面 的 包含 谓词 使 用 point 语 法 ， 而 实际 上 第 二 个 参数 通过 box 内 部 表示 。 这 个 语法 没 必要 定 
义 单独 的 point 类 型 以 及 (box,point) 谓 词 图 数 。 


select cube_contains('(0,0),(1,1)', '0.5,0.5'); 
cube_contains 


NS sa 
F.8.5. ) 王 忆 
对 于 用 法 实例 ， 参 阅 回 轨 测试 sql/cube.sql o 


为 了 使 人 们 突破 该 事物 更 加 难 ， 在 立方 体 维度 数量 上 有 100 的 限制 。 如 果 你 需要 大 一 些 的 ， 
可 以 在 cubedata.h 中 设置 。 


F.8.6. 赞扬 
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+, http://best.berkeley.edu/~adong/rtree/index.html, 我 还 要 感谢 所 有 现在 的 和 以 前 的 
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这 个 包 较 小 更 新 是 由 Bruno Wolff Ill &lt;[bruno@wolff.to](mailto:bruno@wolff.to)&gt; 在 2002 
年 八 月 / 九 月 完成 的 。 这 些 包 含 从 单 精度 到 双 精 度 改变 精度 以 及 添加 一 些 新 的 画 数 。 


额外 更 新 是 由 Joshua Reich alt; [josh@root .net](mailto:josh@root.net)&gt; 在 2006 年 7 月 进 
行 的 。 这 些 包含 cube(float8[]，float8[]) 并 且 使 用 V1 调 用 协议 而 不 是 过 时 的 V0 协 议 来 清理 
代码 。 


F.9. dblink 


Table of Contents 


e dblink_connect -- 打开 到 远程 数据 库 的 持久 连接 

e dblink_connect_u -- 危险 的 打开 一 个 到 远程 数据 库 的 持久 连接 

e dblink_disconnect -- 关闭 远程 数据 库 的 持久 连接 

e dblink -- 在 远程 数据 库 中 执行 查询 

e dblink_exec -- 在 远程 数据 库 中 执行 命令 

e dblink_open -- 打开 远程 数据 库 中 的 游标 

e dblink_fetch -- 从 远程 数据 库 中 打开 的 游标 中 返回 行 

。 dblink_close -- 关闭 远程 数据 库 中 的 游标 

e dblink_get_connections -- 返回 所 有 打开 命名 dblink 连 接 的 名 字 

e dblink_error message -- 获取 命名 连接 上 的 最 后 错误 信息 

e dblink_send_query -- 发 送 一 个 异步 查询 到 远程 数据 库 

e dblink_is_busy -- 检查 是 否 连 接 忙于 异步 查询 

e dblink_get_notify -- 在 连接 上 检索 异步 通知 

e dblink_get_result -- 获得 异步 查询 结果 

e dblink_cancel_query -- 取消 在 已 经 命名 连接 上 的 任何 活跃 查询 

e dblink_get_pkey -- 返回 位 置 和 关系 的 主键 字段 的 字段 名 字 

e dblink_build_sql_insert -- 使 用 本 地 元 组 建立 INSERT 语 句 ， 使 用 可 选 的 已 提供 的 值 蔡 换 
主键 字段 

e dblink_build_sql_delete -- 使 用 已 提供 的 值 为 主键 字段 值 建 立 一 个 DELETE 语 名 

e dblink_build_sql_update -- 使 用 本 地 元 组 建立 UPDATE 语 句 ， 使 用 可 选 的 已 提供 的 值 蔡 
换 主键 字段 


dblink 是 一 个 在 数据 库 会 话 中 支持 连接 其 他 PostgreSQL 数据 库 的 模块 。 
参阅 postgres_fdw 使 用 更 现代 且 符 合 标 准 的 基础 设施 提供 了 大 体 一 样 的 功能 。 


dblink_connect 


Name 


dblink_connect -- 打开 到 远程 数据 库 的 持久 连接 


Synopsis 


dblink_connect(text connstr) returns text 
dblink_connect(text connname, text connstr) returns text 


JAR 


dblink_connect() 建立 了 远程 PostgreSQL 数 据 库 的 连接 。 连接 的 服务 器 和 数据 库 是 通过 标准 
libpq 连 接 字 符 串 被 标识 。 随意 的 ， 给 连接 分 配 名 字 。 可 以 一 次 打开 多 个 命名 的 连接 ， 但 是 每 
次 仅仅 允许 一 个 未 命名 连接 。 连接 将 持续 直到 关闭 或 者 数据 库 会 话 结束 为 止 。 


连接 字符 串 也 可 能 是 已 存在 外 服务 器 的 名 字 。 当 定义 外 服务 器 时 ， 推 荐 使 用 外 数据 
包 dblink_fdw 。 请 看 下 面 的 例子 ， 以 及 CREATE SERVER 和 CREATE USER MAPPING, 


参数 


conname 


用 于 连接 的 名 称 ; 如 果 忽 略 ， 那 么 打开 一 个 未 命名 的 连接 ， 蔡 换 任何 已 存在 未 命名 连接 。 


connstr 


如 hostaddr=127.0.0.1 port=5432 dbname=mydb user=postgres password=mypasswd o 更 多 详情 请 


参阅 Section 31.1.1。 另外 ， 外 服务 器 名 称 。 


RIE] (6 


返回 状态 总 是 ok (AAAS RAHM ARMA SIRE) 。 


只 有 超级 用 户 可 能 使 用 dblink_connect 创建 非 口 令 认 证 连接 。 如 果 非 超级 用 户 需要 这 个 能 
力 ， 使 用 dblink_connect_u o 


选择 包含 等 号 的 连接 名 是 不 明智 的 ， 正 如 这 在 其 他 dlink KRHA 与 连接 信息 字符 串 混淆 
的 风险 。 


例子 


SELECT dblink_connect('dbname=postgres' ); 
dblink_connect 


SELECT dblink_connect('myconn', 'dbname=postgres'); 
dblink_connect 


-- 外 数据 封装 功能 
-- ES: 本 地 连接 必须 要 求 密码 认证 工作 正常 
-- 否则 ， 你 将 接收 到 来 自 dblink_connect() 的 下 面 的 错误 : 


ad ERROR: 需要 密码 
= DETAIL: 如 果 服 务 器 不 需要 密码 ， 那 么 非 超级 用 户 无 法 连接 。 
ae HINT: ”必须 改变 目标 服务 器 的 身份 验证 方法 。 


CREATE SERVER fdtest FOREIGN DATA WRAPPER dblink_fdw OPTIONS (hostaddr '127.0.0.1', dbnam 


CREATE USER dblink_regression_test WITH PASSWORD 'secret'; 

CREATE USER MAPPING FOR dblink_regression_test SERVER fdtest OPTIONS (user 'dblink_regres 
GRANT USAGE ON FOREIGN SERVER fdtest TO dblink_regression_test; 

GRANT SELECT ON TABLE foo TO dblink_regression_test; 


\set ORIGINAL_USER :USER 

\c - dblink_regression_test 

SELECT dblink_connect('myconn', 'fdtest'); 
dblink_connect 


OK 
(1 row) 
SELECT * FROM dblink('myconn', 'SELECT * FROM foo') AS t(a int, b text, c text[]); 
a |b | C 
a NE S E E E E 
© | a | {a0, b0, c0} 
1 | b | {a1,b1,c1} 
2 | c | {a2,b2,c2} 
3 | d | {a3,b3,c3} 
4 |e | {a4,b4,c4} 
5 | f | {a5,b5,c5} 
6 | g | {a6,b6, c6} 
7 | h | {a7,b7,c7} 
8 | i | {a8,b8,c8} 
9 | j | {a9,b9,c9} 
10 | k | {a10,b10,c10} 
(11 rows) 


\c - :ORIGINAL_USER 

REVOKE USAGE ON FOREIGN SERVER fdtest FROM dblink_regression_test; 
REVOKE SELECT ON TABLE foo FROM dblink_regression_test; 

DROP USER MAPPING FOR dblink_regression_test SERVER fdtest; 

DROP USER dblink_regression_test; 

DROP SERVER fdtest; 


eee 





dblink_connect_u 


Name 


dblink_connect_u -- 危险 的 打开 一 个 到 远程 数据 库 的 持久 连接 


Synopsis 


dblink_connect_u(text connstr) returns text 
dblink_connect_u(text connname, text connstr) returns text 


摘 述 


dblink_connect_u() 与 dblink_connect() 是 相同 的 ， 除了 它 将 允许 非 超级 用 户 使 用 任何 身份 
验证 方法 进行 连接 。 


如 果 远 程 服务 器 选择 一 个 不 涉及 密码 的 身份 验证 方法 ， 然 后 模拟 并 且 产 生 权 限 的 随后 升级 ， 
因为 该 会 话 将 出 现 于 用 户 ， 正 如 本 地 PostgreSQL 服 务 器 运行 的 那个 。 同时 ， 即 使 远程 服务 器 
人 确实 需要 密码 ， 从 服务 器 环境 提供 密码 是 可 能 的 ， 比 如 ~/ .pgpass 文件 从 属于 服务 器 的 用 
户 。 这 不 仅仅 打开 模拟 风险 ， 而 且 可 能 将 密码 暴露 给 不 信任 的 远程 服务 器 。 

此 ， dblink_connect_u() 初始 安装 从 PUBLIC 撤销 的 所 有 权限 。 使 得 它 不 可 请 求 即 付 只 有 超级 
用 户 可 以 。 在 一 些 情况 下 可 以 为 dblink_connect_u() 指定 可 以 信赖 的 用 户 适 当 授 予 

EXECUTE 权限 ， 但 这 应 该 仔细 的 做 。 推荐 任何 从 属于 服务 器 的 用 户 的 ~/ .pgpass 文件 不 包含 
指定 通配符 主机 名 的 任何 记录 。 


更 多 详情 请 参阅 dblink_connect() o 


dblink_disconnect 


Name 


dblink_disconnect -- 关闭 远程 数据 库 的 持久 连接 


Synopsis 


dblink_disconnect() returns text 
dblink_disconnect(text connname) returns text 


摘 述 


dblink_disconnect() 关闭 先前 通过 dblink_connect() 打开 的 连接 。 无 参数 形式 关闭 一 个 未 命 
名 连接 。 


参数 


conname 


被 关闭 的 命名 连接 的 名 称 。 


RIE (6 


返回 状态 始终 是 ok 《因为 任何 错误 导致 画 数 抛 出 错误 而 不 是 返回 ) 。 


例子 


SELECT dblink_disconnect(); 
dblink_disconnect 


SELECT dblink_disconnect('myconn'); 
dblink_disconnect 


dblink 


Name 


dblink -- 在 远程 数据 库 中 执行 查询 


Synopsis 


dblink(text connname, text sql [, bool fail_on_error]) returns setof record 
dblink(text connstr, text sql [, bool fail_on_error]) returns setof record 
dblink(text sql [, bool fail_on_error]) returns setof record 


摘 述 
dblink 在 远程 数据 库 中 执行 查询 (通常 sect, BEE 可 以 是 任何 返回 行 的 SQL 语句 ) o 


当 给 定 两 个 text 参数 时 ， 第 一 个 作为 持久 连接 名 称 首先 被 查找 ; 如 果 发 现 了 ， 那么 在 连接 
上 执行 该 命令 。 如 果 没 有 发 现 ， 那 么 第 一 个 参数 被 看 作 dblink_connect 的 连接 信息 字符 串 ， 
并 且 指 定 连接 为 了 该 命令 的 整个 时 间 段 。 


参数 
要 使 用 的 连接 名 称 ; 省 略 这 个 参数 使 用 未 命名 连接 。 
connstr 


连接 信息 字符 串 ， 如 先前 描述 的 dblink_connect o 


sql 


你 希望 在 远程 数据 库 中 执行 的 SQL 查 询 ， 比如 select * from foo o 


fail_on_error 


如 果真 (忽略 时 缺 省 ) 那么 在 连接 的 远程 端 抛 出 的 错误 也 会 导致 林地 抛 出 错误 ， BOR, BB 
么 远程 错误 在 本 地 作为 NOTICE 被 报告 ， 并 且 本 数 没有 返回 行 。 


RIE (6 


该 刻本 数 返回 查询 产生 的 行 。 因 为 dblink 可 以 用 于 任何 查询 ， 它 被 声明 为 返 区 回 record ’ 而 不 
是 指定 任何 特定 列 。 这 意味 着 在 调用 查询 中 你 必须 指定 预期 列 ; 否则 PostgreSQL 不 知道 发 
生 什 么 ， 这 有 个 例子 : 


SELECT * 
FROM dblink('dbname=mydb', 'select proname, prosrc from pg_proc') 
AS ti(proname name, prosrc text) 
WHERE proname LIKE 'bytea%'; 


FROM 子 句 的 "alias" 部 分 必须 指定 函数 将 要 返回 的 列 名 和 类 型 。 (在 别名 中 指定 列 名 实际 上 是 
标准 SQL 语法 ， 但 是 指定 列 类 型 是 PostgreSQL 扩 展 。) 这 人 允许 系统 理解 * 应 该 扩展 到 什 
A, ARTE wHERE FAP proname 指向 什么 ， 提 前 尝试 执行 该 图 数 。 在 运行 时 ， 如 果 远 程 数 
据 库 的 实际 查询 结果 没有 FRoM 子 句 中 显示 的 相同 列 数 ， 那 么 将 抛 出 错误 。 列 名 不 需要 匹 
配 ， 然 而 ， dblink 不 坚持 确切 类 型 匹配 。 只 要 返回 的 数据 字符 串 对 于 FRoM 子 句 中 声明 的 列 
类 型 是 有 效 输 入 那么 它 将 成 功 。 


eS 
m FX 


预定 义 查 询 使 用 dblink 的 一 个 便捷 方式 是 创建 视图 。 这 人 允许 将 列 类 型 信息 放 在 视图 中 ， 而 不 
是 在 每 个 查询 中 拼 出 它 。 比 如 ， 
CREATE VIEW myremote_pg_proc AS 
SELECT * 
FROM dblink('dbname=postgres', 'select proname, prosrc from pg_proc') 


AS ti(proname name, prosrc text); 


SELECT * FROM myremote_pg_proc WHERE proname LIKE 'bytea%'; 


例子 


SELECT * FROM dblink('dbname=postgres', 'select proname, 
AS ti(proname name, prosrc text) WHERE proname LIKE 'bytea%'; 


proname 
byteacat 
byteaeq 
bytealt 
byteale 
byteagt 
byteage 
byteane 
byteacmp 
bytealike 
byteanlike 
byteain 
byteaout 
(12 rows) 


prosrc 
byteacat 
byteaeq 
bytealt 
byteale 
byteagt 
byteage 
byteane 
byteacmp 
bytealike 
byteanlike 
byteain 
byteaout 


SELECT dblink_connect('dbname=postgres' ); 
dblink_connect 


prosrc from pg_proc') 


SELECT * FROM dblink('select proname, prosrc from pg_proc') 
AS ti(proname name, prosrc text) WHERE proname LIKE 'bytea%'; 


proname 
byteacat 
byteaeq 
bytealt 
byteale 
byteagt 
byteage 
byteane 
byteacmp 
bytealike 
byteanlike 
byteain 
byteaout 
(12 rows) 


prosrc 
byteacat 
byteaeq 
bytealt 
byteale 
byteagt 
byteage 
byteane 
byteacmp 
bytealike 
byteanlike 
byteain 
byteaout 


SELECT dblink_connect('myconn', 'dbname=regression' ); 
dblink_connect 


SELECT * FROM dblink('myconn', 'select proname, prosrc from pg_proc') 
AS ti(proname name, prosrc text) WHERE proname LIKE 'bytea%'; 


proname 
bytearecv 
byteasend 
byteale 
byteagt 
byteage 
byteane 
byteacmp 
bytealike 
byteanlike 
byteacat 
byteaeq 
bytealt 
byteain 
byteaout 
(14 rows) 


prosrc 
bytearecv 
byteasend 
byteale 
byteagt 
byteage 
byteane 
byteacmp 
bytealike 
byteanlike 
byteacat 
byteaeq 
bytealt 
byteain 
byteaout 


dblink_exec 


Name 


dblink_exec -- 在 远程 数据 库 中 执行 命令 


Synopsis 


dblink_exec(text connname, text sql [, bool fail_on_error]) returns text 
dblink_exec(text connstr, text sql [, bool fail_on_error]) returns text 
dblink_exec(text sql [, bool fail_on_error]) returns text 


摘 述 
dblink_exec 在 远程 数据 库 中 执行 命令 〈 即 不 返回 行 的 任何 SQL 语句 ) 。 


当 给 定 两 个 text 参数 时 ， 第 一 个 作为 持久 连接 名 称 首先 被 查找 ; 如 果 发 现 了 ， 那么 在 连接 
上 执行 该 命令 。 如 果 没 有 发 现 ， 那么 第 一 个 参数 被 看 作 dblink_connect 的 连接 信息 字符 串 ， 
并 且 指 定 连接 为 了 该 命令 的 整个 时 间 段 。 


参数 


conname 


要 使 用 的 连接 名 称 ; 省 略 这 个 参数 使 用 未 命名 连接 。 
connstr 

连接 信息 字符 串 ， 如 先前 描述 的 dblink_connect o 

sql 

你 希望 在 远程 数据 库 中 执行 的 SQL 命 舍 ， 比 

如 insert into foo values(0, 'a','{"a0", "b0", "c0"}') o 
fail_on_error 


如 果真 (ARARA) 那么 在 连接 的 远程 端 抛 出 的 错误 也 会 导致 本 地 抛 出 错误 ， 如 果 假 ， 那 
么 远程 错误 在 本 地 作为 NOTICE 被 报告 ， 并 且 函 数 的 返回 值 设置 为 ERROR o 


返回 值 


回 状态 ， 该 命令 的 状态 字符 串 或 者 ERROR o 


SELECT dblink_connect('dbname=dblink_test_standby'); 
dblink_connect 


SELECT dblink_exec('insert into foo values(21,''z'',''{"ao","bo","cO"}'');'); 
dblink_exec 


INSERT 943366 1 
(1 row) 


SELECT dblink_connect('myconn', 'dbname=regression' ); 
dblink_connect 


SELECT dblink_exec('myconn', ‘insert into foo values(21,''z'',''{"ao","bo","cO"}'');'); 
dblink_exec 


INSERT 6432584 1 
(1 row) 


SELECT dblink_exec('myconn', ‘insert into pg_class values (''foo'')',false); 


NOTICE: sql error 
DETAIL: ERROR: null value in column "relnamespace" violates not-null constraint 


dblink_exec 


dblink_open 


Name 


dblink_open -- 打开 远程 数据 库 中 的 游标 


Synopsis 


dblink_open(text cursorname, text sql [, bool fail_on_error]) returns text 
dblink_open(text connname, text cursorname, text sql [, bool fail_on_error]) returns text 


e a 11 
Ep 


dblink_open() 打开 了 远程 数据 库 中 的 游标 。 游标 可 以 随后 使 
用 dblink_fetch() 和 dblink_close() 被 操作 。 


参数 


要 使 用 的 连接 名 称 ; 省 略 这 个 参数 使 用 未 命名 连接 。 


分 配给 这 个 游标 的 名 称 。 


sql 


你 希望 在 远程 数据 库 中 执行 的 SELECT 语句 ， 比 如 select * from pg_class o 


fail_on_error 


如 果真 (BMRA) 那么 在 连接 的 远程 端 抛 出 的 错误 也 会 导致 本 地 抛 出 错误 ， 如 果 假 ， 那 
么 远程 错误 在 本 地 作为 NOTICE 被 报告 ， 并 且 函 数 的 返回 值 设置 为 ERROR o 


WRI (6 


返回 状态 ， ok 或 者 ERROR o 


AN 一 

ÆA 

因为 游标 只 能 停留 在 事务 块 中 ， 如 果 远 程 端 已 经 不 在 事务 中 ， 那么 dblink open 在 远程 端 开 
始 显 式 事务 块 ( BEGIN ) ， 当 执 行 匹配 的 dblink close 时 ， 则 该 事务 将 再 次 被 关闭 。 注意 


如 果 在 dblink_open 和 dblink_close 之 间 使 用 dblink_exec 改变 数据 ， 那 么 会 产生 错误 或 者 
你 在 dblink_close 之 前 使 用 dblink_disconnect ， 你 的 改变 将 丢失 ， 因 为 终止 了 事务 。 


例子 


SELECT dblink_connect('dbname=postgres' ); 
dblink_connect 


SELECT dblink_open('foo', ‘select proname, prosrc from pg_proc'); 
dblink_open 


dblink_fetch 


Name 


dblink_fetch -- 从 远程 数据 库 中 打开 的 游标 中 返回 行 


Synopsis 


dblink_fetch(text cursorname, int howmany [, bool fail_on_error]) returns setof record 
dblink_fetch(text connname, text cursorname, int howmany [, bool fail_on_error]) returns 





dblink_fetch 通过 dblink_open 预先 建立 的 游标 中 抓 取 行 。 


参数 


要 使 用 的 连接 名 称 ; 省 略 这 个 参数 使 用 未 命名 连接 。 
获取 游标 名 称 。 


howmany 


要 检索 的 最 大 行 数 。 抓 取 下 一 个 howmany 行 ， 从 当前 光标 位 置 开始 ， 向 前 移动 。 一 旦 游标 已 
经 到 达 末 尾 ， 不 会 产生 更 多 行 。 


fail_on_error 


如 果真 (忽略 时 缺 省 ) 那么 在 连接 的 远程 端 抛 出 的 错误 也 会 导致 林地 抛 出 错误 ， 如 果 假 ， 那 
么 远程 错误 在 本 地 作为 NOTICE 被 报告 ， 并 且 函 数 没有 返回 行 。 


返回 值 


该 贺 数 返回 从 游标 中 抓 取 的 行 。 要 使 用 该 娘 数 ， 你 将 需要 指定 预期 的 字段 集 ， 正 如 前 面 讨 论 
的 dblink 。 
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在 FRoM 子 句 上 指定 的 返回 列 数 之 间 的 不 匹配 ， 并 且 通 过 远程 游标 返回 实际 列 数 ， 将 抛 出 一 个 
鞭 误 。 在 这 种 情况 下 ， 远 程 游标 仍然 按照 没有 产生 错误 时 一 样 的 行 增 长 。 同样 的 在 远 
程 FETcH 执行 后 本 地 查询 产生 的 任何 其 他 错误 也 是 这 样 。 


例子 


SELECT dblink_connect('dbname=postgres'); 
dblink_connect 


SELECT dblink_open('foo', 'select proname, prosrc from pg_proc where proname like ''bytea 
dblink_open 


SELECT * FROM dblink_fetch('foo', 5) AS (funcname name, source text); 


funcname | source 
shies See Byes, 站 
byteacat | byteacat 
byteacmp | byteacmp 
byteaeq | byteaed 
byteage | byteage 
byteagt | byteagt 
(5 rows) 


SELECT * FROM dblink_fetch('foo', 5) AS (funcname name, source text); 


funcname | source 
Seis eee Possess sees 
byteain | byteain 
byteale | byteale 
bytealike | bytealike 
bytealt | bytealt 
byteane | byteane 

(5 rows) 


SELECT * FROM dblink_fetch('foo', 5) AS (funcname name, source text); 


funcname | source 
Sheeran espe isis Steves See 
byteanlike | byteanlike 
byteaout | byteaout 
(2 rows) 


SELECT * FROM dblink_fetch('foo', 5) AS (funcname name, source text); 
funcname | source 





dblink_close 


Name 
dblink_close -- 关闭 远程 数据 库 中 的 游标 
Synopsis 


dblink_close(text cursorname [, bool fail_on_error]) returns text 
dblink_close(text connname, text cursorname [, bool fail_on_error]) returns text 


摘 述 


dblink_close 关闭 先前 使 用 dblink_open 打开 的 游标 。 


参数 


要 使 用 的 连接 名 称 ; 省 略 这 个 参数 使 用 未 命名 连接 。 
关闭 的 游标 名 称 。 


fail_on_error 


如 果真 (忽略 时 缺 省 ) 那么 在 连接 的 远程 端 抛 出 的 错误 也 会 导致 林地 抛 出 错误 ， 如 果 假 ， 那 
么 远程 错误 在 本 地 作为 NOTICE 被 报告 ， 并 且 函 数 的 返回 值 被 设置 为 ERROR o 


退回 值 
返回 状态 ， ok 或 者 ERROR 。 
注意 


如 果 dblink_open 启动 了 一 个 显 式 事务 块 ， 并 且 这 是 在 该 连接 中 最 后 保持 打开 的 游标 。 


dblink_close 将 提交 匹配 的 COMMIT o 


例子 


SELECT dblink_connect('dbname=postgres'); 
dblink_connect 


SELECT dblink_open('foo', 'select proname, prosrc from pg_proc'); 
dblink_open 


SELECT dblink_close('foo'); 
dblink_close 


dblink_get_connections 


Name 


dblink_get_connections -- 返回 所 有 打开 命名 dblink 连 接 的 名 字 
Synopsis 
dblink_get_connections() returns text[] 
摘 述 
dblink_get_connections 返回 所 有 打开 已 命名 dplink 连接 的 名 字数 组 。 


返回 值 


返回 连接 名 称 的 文本 数组 ， 如 果 没 有 的 话 返回 NULL。 


例子 


SELECT dblink_get_connections(); 


dblink_error_message 


Name 


dblink_error_message -- 获取 命名 连接 上 的 最 后 错误 信息 
Synopsis 


dblink_error_message(text connname) returns text 


fia ah 


dblink_error_message 抓 取 给 定 连接 的 最 新 远程 错误 信息 。 


参数 


conname 


使 用 连接 的 名 字 。 


返回 最 后 错误 信息 ， 或 者 如 果 在 这 个 连接 中 没有 错误 ， 则 返回 空 字符 串 。 


SELECT dblink_error_message('dtest1i'); 


dblink_send_query 


Name 


dblink_send_query -- 发 送 一 个 异步 查询 到 远程 数据 库 


Synopsis 


dblink_send_query(text connname, text sql) returns int 


fia ah 


dblink_send_query 发 送 异 步 执行 的 查询 ， 也 就 是 说 ， 没 有 立即 等 待 结果 。 在 连接 进行 的 过 程 
中 没有 一 个 异步 查询 。 


在 成 功 调度 异步 查询 之 后 ， 完 成 状态 可 以 用 dblink_is_busy RHA, 结果 最 终 使 
用 dblink_get_result 收集 。 党 试 使 用 dblink_cancel_query 取消 活跃 的 异步 查询 是 可 能 的 。 


参数 


conname 


使 用 的 连接 名 字 。 


sql 


你 希望 在 远程 数据 库 中 执行 的 SQL 语句 ， 比如 select * from pg_class o 
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如 果 查 询 被 成 功 调 度 ， 则 返回 1。 否 则 返回 0。 


例子 


SELECT dblink_send_query('dtest1', 'SELECT * FROM foo WHERE f1 < 3'); 


dblink_is_busy 
Name 
dblink_is_busy -- 检查 是 否 连接 忙于 异步 查询 
Synopsis 

dblink_is_busy(text connname) returns int 
fi ach 
dblink_is_busy 测试 是 否 异步 查询 在 进行 中 。 


参数 


conname 


检查 连接 的 名 字 。 


TRIE) (6 


如 果 连 接 繁 忙 ， 则 返回 1， 如 果 不 繁忙 ， 则 返回 0。 如果 该 画 数 返回 0， 那 么 保 
证 dblink_get_result 将 不 阻塞 。 


例子 


SELECT dblink_is_busy('dtest1i'); 


dblink_get_notify 


Name 


dblink_get_notify -- 在 连接 上 检索 异步 通知 


Synopsis 


dblink_get_notify() returns setof (notify_name text, be_pid int, extra text) 
dblink_get_notify(text connname) returns setof (notify_name text, be_pid int, extra text) 


N See | 
fia aah 
dblink_get_notify 在 未 命名 连接 上 检索 通知 ， 或 者 如 果 指 定 了 则 在 命名 的 连接 上 。 为 了 通过 


dblink 接 收 通知 ， 必 须 首先 使 用 dblink_exec 发 出 Listen, 更 多 详情 请 参阅 LISTEN 和 
NOTIFY. 


参数 


conname 


获取 通知 的 已 命名 连接 名 字 。 


上 运 回 值 


返回 setof (notify_name text, be_pid int, extra text) ， 如 果 没 有 则 返回 空 集 。 


例子 


SELECT dblink_exec('LISTEN virtual'); 
dblink_exec 


LISTEN 
(1 row) 


SELECT * FROM dblink_get_notify(); 
notify_name | be_pid | extra 


NOTIFY virtual; 
NOTIFY 


SELECT * FROM dblink_get_notify(); 
notify_name | be_pid | extra 


virtual | 1229 | 
(1 row) 


dblink_get_result 


Name 


dblink_get_result -- 获得 异步 查询 结果 


Synopsis 


dblink_get_result(text connname [, bool fail_on_error]) returns setof record 


fia ah 


dblink_get_result 收集 先前 使 用 dblink_send_query 发 送 的 异步 查询 结果 。 如 果 还 没完 成 查 
询 ， 那 么 dblink_get_result 将 等 待 它 。 


参数 


conname 


要 使 用 的 连接 名 字 。 


fail_on_error 


如 果真 (忽略 时 缺 省 ) 那么 在 连接 的 远程 端 抛 出 的 错误 也 会 导致 林地 抛 出 错误 ， 如 果 假 ， 那 
么 远程 错误 在 本 地 作为 NOTICE 被 报告 ， 并 且 画 数 没有 返回 行 。 


返回 值 


一 个 异步 查询 (也 就 是 说 ， 返 回 行 的 SQL 语句 ) ， 该 函数 返回 通过 查询 产生 的 行 。 要 使 用 该 
画 数 ， 你 将 需要 指定 预期 的 字段 集 ， 正如 前 面 讨 论 的 dblink o 


一 个 异步 命 舍 〈 也 就 是 说 ， 没 有 返回 行 的 SQL 语句 ) ， 该 画 数 返回 带 有 该 命令 的 状态 字符 串 
的 单 文本 列 的 单一 行 。 声明 结果 将 在 调用 Ro 子 句 中 有 单一 文本 列 。 
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如 果 dblink_send_query 返回 1， 那么 必须 调用 该 函数 。 它 必 须 被 每 一 个 查询 调用 ， 并 且 一 个 
额外 时 间 来 获取 空 集结 果 ， 连接 之 前 可 以 再 次 使 用 。 


当 在 返回 它 到 本 地 查询 义理 器 之 前 使 用 dblink_send_query 和 dblink_get_result , dblink 抓 取 
整个 远程 查询 结果 。 如 果 查 询 返 回 大 量 行 ， 那 么 这 可 以 导致 本 地 会 话 短暂 内 存 膨胀 。 它 可 以 
更 好 的 打开 这 个 查询 比如 使 用 dblink_open 的 游标 ， 然后 抓 取 每 次 可 管理 的 行 数 。 另 外 ， 使 
用 普通 的 dblink() 通过 多 任务 缓冲 处 理 大 量 结果 集 到 磁 瘟 避免 内 存 膨胀 。 


例子 


contrib_regression=# SELECT dblink connect('dtest1', 'dbname=contrib_regression'); 
dblink_connect 


contrib_regression=# SELECT * FROM 

contrib_regression-# dblink_send_query('dtesti', 'select * from foo where f1 < 3') AS t1; 
t1 
1 

(1 row) 


contrib_regression=# SELECT * FROM dblink_get_result('dtest1') AS t1(f1 int, f2 text, f3 
fi | f2 | f3 


EN E 
© | a | {a0,b0,co} 
1 | b | {a1,b1,c1} 
2 | c | {a2,b2,c2} 
(3 rows) 


contrib_regression=# SELECT * FROM dblink_get_result('dtest1') AS t1(f1 int, f2 text, f3 
fe | 2a is 


contrib_regression=# SELECT * FROM 

contrib_regression-# dblink_send_query('dtesti', 'select * from foo where f1 < 3; select 
t1 
1 

(1 row) 


contrib_regression=# SELECT * FROM dblink_get_result('dtest1') AS t1(f1 int, f2 text, f3 
fi | f2 | f3 


有 
O | a | {a0,b0,co} 
1 |b | {a1,b1,c1} 
2 | c | {a2,b2,c2} 
(3 rows) 


contrib_regression=# SELECT * FROM dblink_get_result('dtest1') AS t1(f1 int, f2 text, f3 
fi | f2 | f3 


et ae yes Hho nen ey rn ey ee ene 
7 | h | {a7,b7,c7} 
8 | i | {a8,b8,c8} 
9 | j | {a9,b9,c9} 
10 | k | {a10,b10,c10} 
(4 rows) 


contrib_regression=# SELECT * FROM dblink_get_result('dtest1') AS t1(f1 int, f2 text, f3 
ha | G25) 3 


J — 








dblink_cancel_query 


Name 


dblink_cancel_query -- 取消 在 已 经 命名 连接 上 的 任何 活路 查询 
Synopsis 
dblink_cancel query(text connname) returns text 
摘 述 
dblink_cancel_query 尝试 取消 在 已 命名 连接 上 进行 的 任何 查询 。 注意 这 不 一 定 成 功 (AH, 


比如 远程 查询 可 能 已 经 完成 ) 。 取消 查询 仅仅 提高 了 查询 将 失败 的 可 能 性 。 你 还 必须 完成 正 
常 查询 协议 ， 上 比如 通过 调用 dblink_get_result o 


参数 


conname 


使 用 连接 名 称 。 


Rll (6 


如 果 已 经 发 送 取消 请 求 ， 那 么 返回 ok ， 或 者 失败 的 错误 消息 文本 。 


例子 


SELECT dblink_cancel_query('dtest1'); 


dblink_get_pkey 


Name 


dblink_get_pkey -- 返回 位 置 和 关系 的 主键 字段 的 字段 名 字 
Synopsis 
dblink_get_pkey(text relname) returns setof dblink_pkey_results 


fia ah 


dblink_get_pkey 提供 在 本 地 数据 库 中 关系 的 主键 的 信息 。 有 时 在 生成 被 发 送 到 远程 数据 库 的 
查询 中 有 用 。 


参数 


relname 


本 地 关系 名 字 ， 比如 foo 或 者 myschema.mytab 。 如 果 名 字 是 混合 情况 下 或 者 包含 特殊 字符 ， 
那么 包含 双 引 号 ， 比如 "FooBar" ; 没有 引号 ， 则 字符 串 被 折 且 成 小 写字 母 。 


亿 回 值 
为 每 个 主键 字段 返回 一 行 ， 如 果 关 系 没有 主键 ， 那 么 不 返回 行 。 结 果 行 类 型 被 定义 为 


CREATE TYPE dblink_pkey_results AS (position int, colname text); 


position 列 简 单 的 从 1 到 no 运行 ; 它 是 主键 内 的 字段 数 ， 而 不 是 表 的 列 数 。 


例子 


CREATE TABLE foobar ( 

f1 int, 

f2 int, 

f3 int, 

PRIMARY KEY (f1, f2, f3) 
); 
CREATE TABLE 


SELECT * FROM dblink_get_pkey('foobar'); 
position | colname 


dblink_build_sql_insert 


Name 


dblink_build_sql_insert -- 使 用 本 地 元 组 建立 INSERT 语 句 ， 使 用 可 选 的 已 提供 的 值 替换 主键 
字段 


Synopsis 


dblink_build_sql_insert(text relname, 
int2vector primary_key_attnums, 
integer num_primary_key_atts, 
text[] src_pk_att_vals_array, 
text[] tgt_pk_att_vals_array) returns text 


fi aah 


dblink_build_sql_insert 可 以 用 于 执行 远程 数据 库 本 地 表 的 选择 行 复 制 。 它 从 基于 主键 的 本 
地 表 选 择 行 ， 然 后 建立 一 个 SQL insert 命令 复制 该 行 ， 但 是 随 着 主键 值 被 最 后 参数 中 的 值 
替换 。 (为 了 准确 拷贝 行 ， 请 为 最 后 两 个 参数 指定 同一 值 ) o 


参数 


relname 


本 地 关系 名 称 ， 上 比如 foo 或 者 myschema.mytab 。 如 果 名 字 是 混合 情况 下 或 者 包含 特殊 字符 ， 
那么 包含 双 引 号 ， 比如 "FooBar"” ; 没有 引号 ， 则 字符 串 被 折 和 登 成 小 写字 母 。 


primary_key_attnums 
主键 字段 的 属性 数量 (142) ， 比 如 1 2 。 
num_primary_key_atts 

主键 字段 数 。 

src_pk_att_vals_array 


主键 字段 值 用 于 查找 本 地 元 组 。 每 个 字段 用 文本 形式 表示 。 如 果 在 这 些 主键 值 中 没有 本 地 
行 ， 那 么 抛 出 错误 。 


tgt_pk_att_vals_array 


主键 字段 值 被 放置 在 insert 命令 中 。 每 个 字段 用 文本 形式 表示 。 


返回 值 


作为 文本 返回 所 请 求 的 SQL 语句 。 
NN < 
vt FS 


PostgreSQL 9.0, primary_key_attnums 中 的 属性 号 被 解释 为 逻辑 列 数 ， 对 
应 SELECT * FROM relname 中 的 列 的 位 置 。 先前 版 本 作为 物理 列 位 置 进行 解释 。 如 果 在 整个 表 
周期 中 指定 列 左 侧 的 任何 列 已 经 被 删除 了 ， 那么 这 是 有 区 别 的 。 


例子 


SELECT dblink_build_sql_insert('foo', '1 2', 2, '{"1", "a™}', '{"1", "b'ta"}'); 
dblink_build_sql_insert 

INSERT INTO foo(f1, f2,f3) VALUES('1','b''a', '1') 

(1 row) 


dblink_build_sql_ delete 


Name 


dblink_build_sql_delete -- 使 用 已 提供 的 值 为 主键 字段 值 建 立 一 个 DELETE 语 名 


Synopsis 


dblink_build_sql_delete(text relname, 
int2vector primary_key_attnums, 
integer num_primary_key_atts, 
text[] tgt_pk_att_vals_array) returns text 


Description 


dblink_build_sql_delete 可 以 用 于 执行 远程 数据 库 本 地 表 的 选择 行 复制 。 它 建立 一 个 SQL 
DELETE 命令 将 删除 给 定 主键 值 的 行 。 


参数 


relname 


本 地 关系 名 字 ， 比如 foo 或 者 myschema.mytab 。 如 果 名 字 是 混合 情况 下 或 者 包含 特殊 字符 ， 
那么 包含 双 引 号 ， 比如 "FooBar" ; 没有 引号 ， 则 字符 串 被 折 和 县 成 小 写字 母 。 


primary_key_attnums 


主键 字段 的 属性 数量 (148) ， 比 如 1 2 。 
num_primary_key_atts 

主键 字段 数量 。 

tgt_pk_att_vals_array 


主键 字段 值 用 于 DELETE 命令 。 每 个 字段 用 文本 形式 表示 。 


返回 值 


作为 文本 返回 所 请 求 的 SQL 语句 。 


MAN 
) 王 局 


PostgreSQL 9.0, primary_key_attnums 中 的 属性 号 被 解释 为 逻辑 列 数 ， 对 
应 SELECT * FROM relname 中 的 列 的 位 置 。 先前 版 本 作为 物理 列 位 置 进行 解释 。 如 果 在 整个 表 
周期 中 指定 列 左 侧 的 任何 列 已 经 被 删除 了 ， 那么 这 是 有 区 别 的 。 


例子 


SELECT dblink_build_sql_delete('"MyFoo"', '1 2', 2, '{"1", "b"}'); 
dblink_build_sql_delete 

DELETE FROM "MyFoo" WHERE f1='1' AND f2='b' 

(1 row) 


dblink_build_sql_ update 


Name 


dblink_build_sql_update -- 使 用 本 地 元 组 建立 UPDATE 语 句 ， 使 用 可 选 的 已 提供 的 值 蔡 换 主 
键 字段 


Synopsis 


dblink_build_sql_update(text relname, 
int2vector primary_key_attnums, 
integer num_primary_key_atts, 
text[] src_pk_att_vals_array, 
text[] tgt_pk_att_vals_array) returns text 


fi aah 


dblink_build_sql_update 可 以 用 于 执行 远程 数据 库 本 地 表 的 选择 行 复制 。 它 从 基于 主键 的 本 
地 表 选 择 行 ， 然 后 建立 一 个 SQL uot 命令 复制 该 行 ， 但 是 随 着 主键 值 被 最 后 参数 中 的 值 
替换 。 (为 了 准确 拷贝 行 ， 请 为 最 后 两 个 参数 指定 同一 值 ) 。 uPDATE 命令 总 是 分 配 行 中 所 
有 字段 ; 在 这 个 和 dblink_build_sql_insert 之 间 的 主要 区 别 是 目标 行 已 经 存在 于 远程 表 中 是 


个 假设 。 


参数 


relname 


本 地 关系 名 字 ， 比如 foo 或 者 myschema.mytab 。 如 果 名 字 是 混合 情况 下 或 者 包含 特殊 字符 ， 
那么 包含 双 引 号 ， 比如 "FooBar"” ; 没有 引号 ， 则 字符 串 被 折 和 合 成 小 写字 母 。 


primary_key_attnums 
主键 字段 的 属性 数量 (1 维 ) ， 比 如 1 2 。 
num_primary_key_atts 

主键 字段 数量 。 

src_pk_att_vals_array 


主键 字段 值 用 于 查找 本 地 元 组 。 每 个 字段 用 文本 形式 表示 。 如 果 在 这 些 主键 值 中 没有 本 地 
行 ， 那 么 抛 出 错误 。 


tgt_pk_att_vals_array 


主键 字段 值 被 放置 在 uar 命令 中 。 每 个 字段 用 文本 形式 表示 。 


返回 值 


作为 文本 返回 请 求 的 SQL 语句 。 
‘S>. 一 
amo 


PostgreSQL 9.0, primary_key_attnums 中 的 属性 号 被 解释 为 逻辑 列 数 ， 对 
应 SELECT * FROM relname 中 的 列 的 位 置 。 先前 版 本 作为 物理 列 位 置 进行 解释 。 如 果 在 整个 表 
周期 中 指定 列 左 侧 的 任何 列 已 经 被 删除 了 ， 那么 这 是 有 区 别 的 。 


例子 


SELECT dblink_build_sql_update('foo', '1 2', 2, OI "a™}', '{"1", "b"}'); 
dblink_build_sql_update 

UPDATE foo SET fi1='1', f2='b',f3='1' WHERE f1='1' AND f2='b' 

(1 row) 


F.10. dict _int 


dict_int 是 一 个 全 文 检索 的 扩展 字典 模板 的 示例 。 这 个 示例 字典 的 动机 是 控制 整数 〈《 有 符号 
和 无 符号 ) 的 索引 ， 人 允许 在 防止 唯一 码 的 数量 过 度 增长 时 给 整数 索引 ， 这 将 大 大 的 影响 搜索 
的 性 能 。 


@ maxlen 参数 声明 整数 数字 的 最 大 位 数 。 缺 省 值 是 6。 


e rejectlong 参数 声明 一 个 超 长 的 整数 是 否 应 该 被 截断 或 忽略 。 如 果 rejectlong 
A false (HRA) ， 那 么 字典 返回 该 整数 前 面 的 maxlen 人 位。 如果 
rejectlong 为 true ， 那 么 字典 认为 一 个 超 长 的 整数 是 结束 词 ， 所 以 它 将 不 会 被 索引 。 
请 注意 ， 这 也 意味 着 这 样 一 个 整数 不 能 被 搜索 。 


F.10.2. 用 法 


安装 dict_int 扩展 创建 基于 它 的 一 个 文本 搜索 模板 intdict_template 和 一 个 字典 intdict , 
带 有 缺 省 的 参数 。 你 可 以 修改 这 些 参 数 ， 例 如 


mydb# ALTER TEXT SEARCH DICTIONARY intdict (MAXLEN = 4, REJECTLONG = true); 
ALTER TEXT SEARCH DICTIONARY 


或 创建 新 的 基于 该 模板 的 字典 。 
要 测试 这 个 字典 ， 可 以 党 试 


mydb# select ts_lexize('intdict', '12345678'); 
ts_lexize 


{123456} 


但 是 真实 的 使 用 情况 将 包括 包含 它 在 一 个 文本 搜索 配置 里 ， 就 像 Chapter 12 里 描述 的 那样 。 
可 能 看 起 来 像 这 样 : 


ALTER TEXT SEARCH CONFIGURATION english 
ALTER MAPPING FOR int, uint WITH intdict; 


F.11. dict_xsyn 


dict_xsyn (扩展 的 同义词 词典 ) 是 一 个 全 文本 搜索 的 扩展 字典 模板 的 例子 。 这 个 字典 类 型 
用 它们 的 同义词 组 蔡 代 单词 ， 并 且 因 此 使 得 使 用 任意 它 的 同义词 搜索 这 个 单词 成 为 可 能 。 


F.11.1. ME 


dict_xsyn 字典 接受 下 列 的 选项 : 
e matchorig 控制 字典 是 否 接受 原始 单词 。 缺 省 是 true o 

e matchsynonyms 控制 字典 是 否 接受 同义词 。 缺 省 是 false o 

© keeporig 控制 原始 单词 是 否 包含 在 字典 的 输出 里 。 缺 省 是 true o 
e keepsynonyms 控制 同义词 是 否 包含 在 字典 的 输出 里 。 缺 省 是 true o 


e rules 是 包含 同义词 列表 的 文件 的 基 名 。 这 个 文件 必须 存储 在 SSHAREDIR/tsearch_data/ 
(这 里 的 $sHAREDIR 意思 是 PostgreSQL 安 装 的 共享 数据 目录 ) 里 。 它 的 名 字 必 须 
以 .rules (不 包含 在 rules 参数 中 ) 结束 。 


rules 文 件 有 下 列 的 格式 : 
。 每 行 代 表 着 一 个 单词 的 同义词 组 ， 单 词 在 每 行 的 开头 给 出 。 同 义 词 用 空格 分 开 : 


。 符号 井 号 ( # ) 是 一 个 注释 分 隔 符 。 它 可 能 在 一 行 中 的 任意 位 置 出 现 。 该 行 在 它 后 面 的 部 
分 将 被 跳 过 。 


查看 xsyn_sample.rules (安装 在 $SHAREDIR/tsearch_data/ 里 ) 获取 一 个 实例 。 


F.11.2. 用 法 


安装 dict_xsyn 扩展 创建 基于 它 的 一 个 文本 搜索 模板 xsyn_template 和 一 个 字典 xsyn, FA 
缺 省 的 参数 。 你 可 以 修改 这 些 参数 ， 如 


mydb# ALTER TEXT SEARCH DICTIONARY xsyn (RULES='my_rules', KEEPORIG=false); 
ALTER TEXT SEARCH DICTIONARY 


或 创建 新 的 基于 该 模板 的 字典 。 


要 测试 该 字典 ， 你 可 以 党 试 


mydb=# SELECT ts_lexize('xsyn', 'word'); 
ts_lexize 


{syn1, syn2, syn3} 


mydb# ALTER TEXT SEARCH DICTIONARY xsyn (RULES='my_rules', KEEPORIG=true) ; 
ALTER TEXT SEARCH DICTIONARY 


mydb=# SELECT ts_lexize('xsyn', 'word'); 
ts_lexize 


{word, syn1, syn2, syn3} 


mydb# ALTER TEXT SEARCH DICTIONARY xsyn (RULES='my_rules', KEEPORIG=false, MATCHSYNONYMS= 
ALTER TEXT SEARCH DICTIONARY 


mydb=# SELECT ts_lexize('xsyn', 'syni'); 
ts_lexize 


{syn1, syn2, syn3} 


mydb# ALTER TEXT SEARCH DICTIONARY xsyn (RULES='my_rules', KEEPORIG=true, MATCHORIG=false 
ALTER TEXT SEARCH DICTIONARY 


mydb=# SELECT ts_lexize('xsyn', 'syni'); 
ts_lexize 





实际 的 使 用 情况 包括 包含 它 在 一 个 文本 搜索 配置 (在 Chapter 12 里 描述 ) 里 。 可 能 看 起 来 像 
这 样 ， 


ALTER TEXT SEARCH CONFIGURATION english 
ALTER MAPPING FOR word, asciiword WITH xsyn, english_stem; 


F.12. dummy_seclabel 


dummy_seclabel 模块 的 存在 只 是 为 了 支持 SECURITY LABEL 语句 的 回 愉 测试 。 不 是 为 了 在 生产 
中 使 用 。 


F.12.1. 基本 原理 
SECURITY LABEL 语句 允许 用 户 给 数据 库 对 象 分 配 安全 标签 ; 不 过 ， 安全 标签 只 有 当 可 加 载 模 
块 特别 允许 时 才能 分 配 ， 所 以 这 个 模块 提供 来 允许 合适 的 回归 测试 。 


打算 将 安全 标签 提供 者 用 于 生产 中 将 典型 的 取决 于 特定 于 平台 的 特征 ， 如 SE-Linux。 这 个 模 
块 是 依赖 于 平台 的 ， 并 且 因 此 很 好 的 适合 于 回 为 测试 。 


F.12.2. 用 法 
这 里 是 使 用 的 一 个 例子 : 


# postgresql.conf 
shared_preload_libraries = 'dummy_seclabel' 


postgres=# CREATE TABLE t (a int, b text); 
CREATE TABLE 
postgres=# SECURITY LABEL ON TABLE t IS 'classified'; 


SECURITY LABEL 


dummy_seclabel 模块 只 提供 四 种 硬 编码 标签 : unclassified , classified , secret , and 
top secret. 不 允许 任何 其 他 的 字符 串 作 为 安全 标签 。 


这 些 标签 不 是 用 来 强制 访问 控制 的 。 它 们 只 是 用 来 检查 SECURITY LABEL 语句 是 否 像 预期 的 那 
样 工作 。 


F.12.3. 作者 


KaiGai Kohei &1t; [kaigai@ak.jp.nec.com](mailto:kaigai@ak.jp.nec.com)&gt; 


F.13. earthdistance 


earthdistance 模块 提供 两 个 不 同 的 方法 计算 地 球 表 面 上 的 大 圆 弧 距离 。 描述 的 第 一 个 依赖 
于 cube 模块 (必须 在 earthdistance 可 以 安装 之 前 安装 ) o 第 二 个 基于 内 建 的 point 数据 类 
型 ， 使 用 经 线 和 纬 线 作为 坐标 。 


在 这 个 模块 ， 假 设 地 球 为 完美 的 球形 。 〈 如 果 对 你 来 说 太 不 准确 ， 你 可 能 想 查 阅 PostGIS 项 
目 。 ) 


F.13.1. 基于 立方 体 的 地 球 距 离 


数据 存储 在 立方 体 中 ， 点 用 3 个 坐标 表示 从 地 球 中 心 到 表面 的 x, y, z 的 距离 。 提供 一 个 
在 cube 之 上 的 域 eartn ， 包 含 检查 约束 ， 值 必须 符合 限制 条 件 并 且 合 理 的 接近 地 球 的 实际 
表面 。 


地 球 的 半径 从 earth() BRR UKM. 可 以 通过 改变 模块 使 用 其 他 单元 来 改变 这 个 画 
数 ， 或 者 使 用 你 觉得 更 合适 的 半径 值 。 


这 个 包 也 应 用 到 了 天 文 数据 库 。 天 文学 家 可 能 想 要 改变 earth() ， 使 其 返回 一 个 189/pi() 的 
半径 ， 这 样 距离 可 以 用 角度 表示 。 


提供 函数 支持 经 纬度 (以 角度 方式 ) 输入 、 输 出 、 计 算 两 个 点 之 间 大 圆 弧 的 距离 ， 和 容易 的 
指定 用 于 索引 查询 的 边界 框 。 


提供 的 函数 在 Table F-4 里 显示 。 


Table F-4. 基于 立方 体 的 地 球 距离 函数 


Bae 返回 描述 
earth() floats 返回 地 球 的 假设 半径 。 
将 地 球 表面 两 点 之 间 正 常 的 直线 (E) 


sec_to_ge(floats) Moaie BEBE #8 48 39 AAEE, 

gc_to_sec(floats8) floats a. ae 
11_to_earth(float8, floats) earth 人 os 
latitude(earth) foate 以 角度 形式 返回 地 球 表面 一 个 点 的 纬度 。 
longitude(earth) float8 以 角度 形式 返回 地 球 表 面 一 个 点 的 经 度 。 


earth_distance(earth, earth) float8 返回 地 球 表 面 两 点 之 间 AK Fees. 


返回 一 个 适合 于 索引 搜索 的 立方 体 ， 该 立 
方 体 在 一 个 给 定位 置 的 大 圆 弧 距 离 里 使 用 
点 的 立方 @&gt; 操作 符 。 在 这 个 立方 体 中 
的 某 些 点 可 能 比 指定 的 大 圆 弧 距离 的 位 置 
Bit, 所 以 使 用 earth distance 的 第 二 个 
检查 应 该 包含 在 查询 中 。 


earth_box(earth, floats) cube 


F.13.2. 基于 点 的 地 球 距离 


模块 的 第 二 部 分 依赖 于 用 类 型 为 point 的 值 表示 地 球 距 离 ， 这 里 第 一 个 组 成 部 分 用 来 表示 以 
角度 表示 的 经 度 ， 第 二 个 组 成 部 分 用 来 表示 以 角度 表示 的 纬度 。 点 被 当做 是 (经 度 , 纬度 ) 并 且 
反 过 来 不 行 ， 因 为 经 度 为 X 轴 纬度 为 Y 轴 。 


提供 了 一 个 操作 符 ， 在 Table F-5 中 显示 。 
Table F-5. 基于 点 的 地 球 距离 操作 符 


操作 符 返回 描述 
point &lt;@&gt; point floats 给 出 地 球 表面 两 点 之 间 的 法 定 英里 距离 。 


请 注意 ， 不 像 基于 cube 部 分 的 模块 ， 这 里 的 单元 是 硬 链接 的 : 改变 earth() MARA 
向 这 个 操作 符 的 结果 。 


这 
经 度 /纬度 表示 法 的 一 个 缺点 是 : 你 必须 注意 靠近 两 极 和 接近 +/- 180 度 经 线 的 边界 条 件 。 基 
于 cube 的 表示 法 避免 了 这 些 间 ET Ro 


x 


=) 


F.14. file fdw 


file_fdw 模块 提供 了 外 部 数据 封装 器 file fow, 可 以 用 来 在 服务 器 的 文件 系统 中 访问 数据 
文件 。 数 据 文件 必须 是 copy FRoM 可 读 的 格式 ; 参阅 COPY 获 取 细 节 。 访 问 这 样 的 数据 文件 
当前 只 是 可 读 的 。 

使 用 这 个 封装 器 创建 的 外 部 表 可 以 有 下 列 选 项 : 

filename 

指定 要 读 取 的 文件 。 这 是 必需 的 。 必 须 是 一 个 绝对 路 径 名 。 

format 

指定 文件 的 格式 ， 与 copy 的 FoRMAT 选项 相同 。 

header 

指定 文件 是 否 有 标题 行 ， 和 与 copy 的 HEADER 选项 相同 。 

delimiter 

指定 文件 的 分 隔 符 ， 与 copy 的 DELIMITER 选项 相同 。 

quote 

指定 文件 的 引用 字符 ， 与 copy 的 quote 选项 相同 。 

escape 

指定 文件 的 逃逸 字符 ， 与 copy 的 escape 选项 相同 。 

null 

指定 文件 的 null 字 符 串 ， 和 与 copy 的 NuLL 选项 相同 。 


encoding 
指定 文件 的 编码 ， 和 与 copy 的 ENcopiN6 选项 相同 。 


请 注意 ， 当 copy 人 允许 的 选项 如 OIDS 和 HEADER 不 带 有 相应 的 值 被 声明 时 ， 外 部 数据 封装 器 
语法 在 所 有 的 情况 下 都 需要 一 个 值 。 要 激活 copy 选项 通常 不 提供 值 ， 不 过 你 可 以 传递 值 
TRUE. 

用 这 个 触发 器 创建 的 外 部 表 的 一 个 字段 可 以 有 下 列 的 选项 : 

force_not_null 


这 是 一 个 布尔 选项 。 如 果 为 真 ， 则 声明 字段 的 值 不 应 该 匹配 空 字符 串 (也 就 是 ， 文件 级 
| null 选项 ) 。 这 和 与 列 出 copy 的 FoRcE_NoT_NULL 选项 里 的 字段 有 相同 的 效果 。 


as 


file fdw 目前 不 支持 copy BY oros 和 FORCE QUOTE 选项 。 


这 些 选项 只 能 为 外 部 表 或 它 的 字段 声明 ， 不 是 在 file fi 外 部 数据 封装 器 的 选 也 不 是 
在 使 用 该 封装 器 的 服务 器 或 用 户 映射 的 选项 里 。 


修改 表 级 别 的 选项 需要 超级 用 户 权 限 ， igen 只 有 超级 用 户 能 够 决定 读 哪 个 文件 。 
原则 上 非 超级 用 户 可 以 被 允许 改变 其 他 选项 ， 但 是 目前 还 不 支持 。 


对 于 一 个 使 用 file tow 的 外 部 表 ， ExPLAIN 显示 要 读 取 的 文件 名 。 除非 指定 了 costs oFF ， 
否则 也 显示 文件 大 小 ( 字 节 计 ) 。 


Example F-1. 为 PostgreSQL CSV 日 志 创 建 一 个 外 部 表 


file_fdw 明显 的 用 处 之 一 就 是 使 PostgreSQL 活 动 日 志 可 以 作为 一 个 表 查 询 。 要 做 到 这 点 ， 
首先 必须 登录 到 一 个 CSV 文 件 ， 这 里 我 们 称 为 pglog.csv 。 首先 ， 作 为 一 个 扩展 安 


装 file fdw o 


CREATE EXTENSION file fdw; 


然后 创建 一 个 外 部 服务 器 : 


CREATE SERVER pglog FOREIGN DATA WRAPPER file_fdw; 


现在 已 经 准 各 好 了 创建 外 部 数据 表 。 使 用 CREATE FOREIGN TABLE MS, 需要 为 表 定 义 字 段 、 
CSV 文 件 名 和 它 的 格式 : 


CREATE FOREIGN TABLE pglog ( 
log_time timestamp(3) with time zone, 
user_name text, 
database_name text, 
process_id integer, 
connection_from text, 
session_id text, 
session_line_num bigint, 
command_tag text, 
session_start_time timestamp with time zone, 
virtual_transaction_id text, 
transaction_id bigint, 
error_severity text, 
sql_state_code text, 
message text, 
detail text, 
hint text, 
internal_query text, 
internal_query_pos integer, 
context text, 
query text, 
query_pos integer, 
location text, 
application_name text 
) SERVER pglog 
OPTIONS ( filename '/home/josh/9.1/data/pg_log/pglog.csv', format 'csv' ); 


就 这 样 ， 现 在 可 以 查询 日 志 目录 。 当 然 ， 在 生产 中 需要 定义 一 些 处 理 日 志 回旋 的 方法 。 
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F.15. fuzzystrmatch 


fuzzystrmatch {Rk jE HILT WBS BZ i AE ES. 


Caution 


目前 ， soundex , metaphone ， dmetaphone ,和 dmetaphone_alt 不 适合 多 字 节 编码 (如 
UTF-8) 。 


F.15.1. Soundex 


Soundex 系统 是 一 种 通过 转换 为 相同 代码 匹配 相似 发 音 名 字 的 方法 。 最 初 是 在 1880、1900 
和 1910 年 用 于 美国 的 人 口 普 查 。 注 意 Soundex 对 于 非 英文 的 名 字 不 是 很 有 帮助 。 


fuzzystrmatch 模块 提供 和 Soundex 代 码 一 起 使 用 的 两 个 函数 : 


Soundex(text) returns text 
difference(text, text) returns int 


soundex EX 4s +e HB % Soundex{t 44, difference MARAT SPRBAEIN 
Soundex 代 码 然后 报告 匹配 代码 位 置 的 数量 。 因为 Soundex 代 码 有 四 个 字符 ， 结 果 范 围 从 震 
到 四 ， 雪 表示 没有 匹配 而 四 表示 完全 匹配 。 (因此 ， 这 个 函数 取 名 不 当 ， similarity 本 是 一 
个 好 名 字 。) 


这 里 是 一 些 有 用 的 示例 : 


SELECT soundex('hello world!'); 

SELECT soundex('Anne'), soundex('Ann'), difference('Anne', 'Ann'); 

SELECT soundex('Anne'), soundex('Andrew'), difference('Anne', 'Andrew'); 
SELECT soundex('Anne'), soundex('Margaret'), difference('Anne', 'Margaret'); 
CREATE TABLE s (nm text); 

INSERT INTO s VALUES ('john'); 

INSERT INTO s VALUES ('joan'); 

INSERT INTO s VALUES ('wobbly'); 

INSERT INTO s VALUES ('jack'); 

SELECT * FROM s WHERE soundex(nm) = soundex('john'); 


SELECT * FROM s WHERE difference(s.nm, 'john') > 2; 


F.15.2. Levenshtein 


RSHRMit BRS SHB il] MLevenshteinibs : 


levenshtein(text source, text target, int ins_cost, int del_cost, int sub_cost) returns i 
levenshtein(text source, text target) returns int 

levenshtein_less_equal(text source, text target, int ins_cost, int del_cost, int sub_cost 
levenshtein_less_equal(text source, text target, int max_d) returns int 


‘ rT 
source 和 target 都 可 以 是 任意 非 空 字符 串 ， 最 多 为 255 字 节 。 cost 参 数 声明 对 于 一 个 字符 
插入 、 删 除 或 替换 分 别 改 变 多 少 。 可 以 省 略 cost 参 数 ， 就 像 该 函数 的 第 二 种 语法 ; 这 种 情况 
下 ， 他 们 缺 省 都 是 1。 levenshtein_less_equal 对 于 低 距 离 是 levenshtein 函 数 的 快速 版 本 。 如 
果实 际 距离 小 于 或 等 于 max_d,， 那么 levenshtein_less_equal 返回 实际 值 。 否则 这 个 函数 返 
回 大 于 max_d 的 值 。 








示例 : 


test=# SELECT levenshtein('GUMBO', 'GAMBOL'); 
levenshtein 


(1 row) 


test=# SELECT levenshtein('GUMBO', 'GAMBOL', 2,1,1); 
levenshtein 


(1 row) 


test=# SELECT levenshtein_less_equal('extensive', 'exhaustive',2); 
levenshtein_less_equal 


(1 row) 


test=# SELECT levenshtein_less_equal('extensive', 'exhaustive',4); 
levenshtein_less_equal 


F.15.3. Metaphone 


Metaphone， 类 似 于 Soundex， 基 于 为 输入 字符 串 构 造 一 个 典型 的 代码 的 想法 。 如 果 两 个 字 
符 串 有 相同 的 代码 那么 认为 它们 相似 。 


这 个 函数 计算 输入 字符 串 的 metaphone 代 码 : 


metaphone(text source, int max_output_length) returns text 


source 必须 为 一 个 非 空 字符 串 ， 最 多 为 255 个 字符 。 max_output_length 设置 输出 
metaphone 代 码 的 最 大 长 度 ; 如 果实 际 比 这 长 ， 那 么 输出 截断 为 这 个 长 度 。 


示例 : 


test=# SELECT metaphone('GUMBO', 4); 
metaphone 


F.15.4. Double Metaphone 


Double Metaphone 系 统 为 一 个 给 定 的 输入 字符 串 计 算 两 个 " 听 起 来 像 "的 字符 串 一 一 个 "原先 
的 "和 一 个 "替换 的 "。 大 多 数 情 况 下 它们 相同 ， 但 是 取决 于 发 音 它们 对 于 非 英文 名 有 一 点 不 
同 。 这 些 画 数 计算 原先 的 和 替换 的 代码 : 


dmetaphone(text source) returns text 
dmetaphone_alt(text source) returns text 


这 里 对 于 输入 字符 串 没有 长 度 限 制 。 
示例 : 


test=# select dmetaphone('gumbo'); 
dmetaphone 


F.16. hstore 


这 个 模块 实现 了 hstore 数据 类 型 ， 在 单个 PostgreSQL 值 中 存储 一 组 键 / 值 对 。 这 在 不 同 的 场 
景 中 是 有 用 的 ， 如 很 少 检查 带 有 许多 属性 的 行 ， 或 半 结 构 化 的 数据 。 键 和 值 是 简单 的 文本 字 
符 串 。 


F.16.1. hstore 外 部 表示 


nstore 的 文本 表示 用 于 输入 和 输出 ， 包 括 替 个 或 更 多 由 逗号 分 开 的 _key =agt; 
_value_ 对。 一些 例子 : 


k => v 
foo => bar, baz => whatever 
"1-a" => "anything at all" 


键 / 值 对 的 顺序 不 重要 〈 可 能 不 在 输出 中 复制 ) 。 忽 略 对 和 =&gt; 符号 周围 的 空格 。 包含 空 
B.S. = 或 ggt; 的 键 和 值 要 加 双 引 号 。 要 在 键 或 值 中 包含 一 个 双 引 号 或 反 斜 枉 ， 要 用 
反 斜 杠 逃 逸 。 


hstore 中 的 每 个 键 都 是 唯一 的 。 如 果 你 用 重复 键 声 明 一 个 hstore , 将 只 有 一 个 存储 
在 hstore 中 ， 并 且 不 保证 会 保存 哪 一 个 : 


SELECT 'a=>1,a=>2'::hstore; 
hstore 


一 个 值 (不 是 一 个 键 ) 可 以 是 SQL nut. WM: 


key => NULL 


NULL 关键 字 是 大 小 写 敏感 的 。 要 将 NuLL 当做 普通 的 字符 串 来 对 待 就 要 给 NULL 加 双 引 号 。 


Note: 记 住 hstore 文本 格式 ， 当 用 于 输入 时 ， 在 任何 请 求 的 引用 或 逃逸 之 前 应 用 。 如 果 
通过 一 个 参数 传递 一 个 hstore 文本 ， 那 么 不 需要 额外 的 处 理 。 但 是 如 果 作 为 引用 的 文 
本 常量 传递 ， 那 么 任何 单 引 号 字符 和 (RMA standard_conforming_strings 配置 参数 的 
设置 ) 反 斜 杠 字符 需要 正确 的 逃逸 。 参阅 Section 4.1.2.1 获 取 更 多 义理 字符 串 常量 的 信 
=| 











o 


在 输出 时 ， 键 和 值 总 是 包含 在 双 引 号 中 ， 即 使 并 不 严格 需要 也 是 这 样 。 


F.16.2. hstore 操作 符 和 男 数 


hstore 模块 提供 的 操作 符 显示 在 Table F-6 中 ， 画 数 在 Table F-7 中 。 


Table F-6. hstore 操作 符 


hstore 
&#124;&#124; 
hstore 


hstore ? 
text 


hstore ?& 
text[] 


hstore 
?&#124; 
text [i] 


hstore 
@&gt; 
hstore 


hstore 
&1t;@ 
hstore 


hstore - 
text 


hstore - 
text [] 


%% hstore 


%#  hstore 


描述 


获得 键 的 值 
(如 果 不 存 在 
为 NULL ) 


获得 多 个 键 
的 值 (如 果 不 
存在 

为 NULL ) 
连接 


hstore 


hstore 包 
Shey? 


hstore 包 
含 所 有 指定 
的 键 ? 


hstore 包 
含 任何 指定 
的 键 ? 


左 操作 符 包 
含 右 操作 符 ? 


左 操作 符 包 
含 于 右 操作 
符 ? 


从 左 操 作 符 
中 删除 键 


从 左 操 作 符 
中 删除 键 


从 左 操 作 符 
中 删除 匹配 
对 


用 hstore 里 
匹配 的 值 蔡 
换 record 里 
的 字段 


转 

换 hstore 为 
替换 键 和 值 
的 数组 


转 
换 hstore 为 
两 维 键 / 值 数 
组 














示例 


'a=&gt;x, b=&gt;y'::hstore -&gt; 'a' 


'a=&gt;x, b=&gt;y, c=&gt;z'::hstore -&gt; ARRAY['c','a 


‘a=&gt;b, c=&gt;d'::hstore &#124;&#124; 'c=&gt;x, d=&g 


‘a=&gt;1'::hstore ? 'a' 


"a=&gt;1,b=&gt;2'::hstore ?3& ARRAY['a', 'b'] 


"a=&gt;1,b=&gt;2'::hstore ?&#124; ARRAY['b','c'] 


‘a=&gt;b, b=&gt;1, c=&gt;NULL'::hstore @&gt; 'b=&gt;1' 


‘a=&gt;c'::hstore &lt;@ 'a=&gt;b, b=&gt;1, c=&gt;NULL' 


‘a=&gt;1, b=&gt;2, c=&gt;3'::hstore - 'b'::text 


'a=&gt;1, b=&gt;2, c=&gt;3'::hstore - ARRAY['a','b'] 


"a=&gt;1, b=&gt;2, c=&gt;3'::hstore - 'a=&gt;4, b=&gt; 


查看 示例 章节 


%% ‘a=&gt;foo, b=&gt;bar'::hstore 


%# ‘a=&gt;foo, b=&gt;bar'::hstore 


Note: PostgreSQL 8.2 之 前 ， 包 含 操作 符 @&gt; 和 &lt;@ 分 别 被 称 为 @ M-o REB 


字 现 在 仍然 可 用 ， 但 是 已 经 记 奔 了 并 且 最 终 将 会 被 移 除 。 


除 ， 之 前 跟随 着 核心 几何 数据 类 型 ! 


Table F-7. hstore Xa 


EE 


hstore(record) 


hstore(text[]) 


hstore(text[], text[]) 


hstore(text, text) 


akeys(hstore) 


skeys(hstore) 


avals(hstore) 


svals(hstore) 


hstore_to_array(hstore) 


F.16. hstore 


返回 类 型 


hstore 


hstore 


hstore 


hstore 


texti] 


setof text 


texti] 


setof text 


text[] 


请 注意 ， 旧 的 名 字 从 大 会 移 


描述 


从 一 个 记录 
或 行 构造 一 
个 hstore 
从 一 个 数组 
Wis — 

es hstore , 


Ly 
可 能 是 一 个 


键 / 值 数组 ， 
也 可 能 是 一 
个 两 维 数组 


从 一 个 单独 
的 键 和 值 数 
组 构造 一 

个 hstore 
制作 单一 


项 hstore 


获 

取 hstore 的 
键 作为 一 个 
数组 

获 

取 hstore 的 
Blea 
集合 


获 

取 hstore 的 
值 作为 一 个 
数组 

获 

取 hstore 的 
你 作为 本 个 


取 hstore 的 
键 和 值 作为 
一 个 键 值 交 
蔡 的 数组 


hst 


ake 


Ske 


ava 


sva 


hstore_to_matrix(hstore) 


hstore_to_json(hstore) 


hstore_to_json_loose(hstore) 


slice(hstore, text[]) 


each(hstore) 


exist(hstore, text) 


defined(hstore, text) 


delete(hstore, text) 


delete(hstore, text[]) 


delete(hstore, hstore) 


populate_record(record, hstore) 


texti] 


json 


json 


hstore 


setof(key text, value text) 


boolean 


boolean 


hstore 


hstore 


hstore 


record 


取 hstore BY 
键 和 值 作 为 
一 个 两 维 数 


IR 

EX hstore 作 
为 一 

个 json 值 
获 

取 hstore 作 
J 

个 json 44, 
但 是 试图 区 
分 数值 和 布 
尔 值 ， 所 以 
它们 在 JSON 
中 没有 引号 


提 
取 hstore 的 
一 个 子 集 


获取 
hstore 的 键 
和 值 作为 一 


个 集合 


hstore 包 
含 键 吗 ? 


hstore 包 
合 非 NuLL 值 
的 键 吗 ? 


删除 匹配 键 
的 对 


删除 匹配 键 
的 多 个 对 


删除 匹配 第 
二 个 参数 中 
元 素 的 对 


蔡 

换 record 中 
匹 

Ac hstore 中 
的 值 的 字段 











hst 


hst 


hst 


sli 


sel 


exi 


def 


del 


del 


del 


参阅 


Note: +4 hstore 值 转换 为 json 时 使 用 hstore_to_json HA. 


Note: 22% populate_record 实际 上 是 用 anyelement , 而 不 是 record ， 声 明 为 它 的 第 一 
个 参数 ， 但 是 它 将 用 运行 时 错误 拒绝 非 记 录 类 型 。 


F.16.3. 335] 


hstore 有 GIST 和 GIN 索 引 支 持 @&gt; ，? ，?3& 和 ?| 操作 符 。 例如 


CREATE INDEX hidx ON testhstore USING GIST (h); 


CREATE INDEX hidx ON testhstore USING GIN (h); 


hstore 也 为 = 操作 符 支 持 btree 或 hash 索引 。 这 人 允许 hstore 字段 声明 为 UNIQUE ， 或 
在 GROUP BY , ORDER BY 或 DISTINCT 表达 式 中 使 用 。 为 hstore 值 的 排序 顺序 不 是 很 有 用 ， 
但 是 这 些 索 引 可 能 对 于 等 价 查 找 有 用 人 处。 为 = 比较 创建 索引 如 下 : 


CREATE INDEX hidx ON testhstore USING BTREE (h); 


CREATE INDEX hidx ON testhstore USING HASH (h); 


F.16.4. 例子 


添加 一 个 键 ， 或 用 新 值 更 新 一 个 现 有 的 键 : 


UPDATE tab SET h h || hstore('c', '3'); 


删除 一 个 键 : 


UPDATE tab SET h = delete(h, 'k1'); 


转换 record 为 hstore : 


CREATE TABLE test (coli integer, col2 text, col3 text); 
INSERT INTO test VALUES (123, 'foo', 'bar'); 


SELECT hstore(t) FROM test AS t; 
hstore 


Mex) is Lees boxe ys "col2"=>"foo", Veolst=>"barny 
(1 row) 


转换 hstore 为 一 个 预先 定义 的 record 类 型 : 


CREATE TABLE test (coli integer, col2 text, col3 text); 
SELECT * FROM populate_record(null::test, 
1 "coli"=>"456", 有 1 ye 
coli | col2 | col3 
R ee E lege ee See OTRE 


456 | zzz | 
(1 row) 


使 用 hstore 里 的 值 修 改 现 有 的 记录 : 


CREATE TABLE test (coli integer, col2 text, col3 text); 
INSERT INTO test VALUES (123, 'foo', 'bar'); 


SELECT (r).* FROM (SELECT t #= '"col3"=>"baz"' AS r FROM test t) s; 
coli | col2 | col3 


123 | foo | baz 
(1 row) 


F.16.5. 统计 


hstore 类 型 ， 由 于 其 内 在 的 慷慨 ， 可 以 包含 大 量 不 同 的 键 。 检 查 有 效 的 键 是 应 用 的 任务 。 下 
列 的 例子 演示 几 个 检查 键 和 获取 统计 的 技术 。 


简单 例子 : 


SELECT * FROM each('aaa=>bq, b=>NULL, ""=>1'); 


使 用 一 个 表 : 


SELECT (each(h)).key, (each(h)).value INTO stat FROM testhstore; 


在 线 统计 : 


SELECT key, count(*) FROM 
(SELECT (each(h)).key FROM testhstore) AS stat 
GROUP BY key 
ORDER BY count DESC, key; 


key | count 
re a E ee reas 
line | 883 
query | 207 
pos | 203 
node | 202 
space | 197 
status | 195 
public | 194 
title | 190 
org | 189 


F.16.6. 兼容 性 


自 PostgreSQL 9.0 起 ， hstore 使 用 一 个 不 同 于 以 前 版 本 的 内 部 表示 。 这 样 做 对 于 转 储 /恢复 
升级 没有 什么 障碍 ， 因 为 文本 表示 (在 转 储 中 使 用 的 ) 没有 改变 。 


在 一 个 二 进 制 升级 中 ， 向 上 兼容 是 通过 使 新 代码 认识 老 格 式 的 数据 来 维护 的 。 这 在 处 理 还 未 
被 新 代码 修改 的 数据 时 会 有 一 点 性 能 代 偿 。 通 过 像 下 面 这 祥 的 UPDATE 语句 强制 升级 一 个 表 字 
段 中 的 所 有 值 是 可 能 的 


UPDATE tablename SET hstorecol = hstorecol || ''; 


另 一 个 方法 是 : 


ALTER TABLE tablename ALTER hstorecol TYPE hstore USING hstorecol || ''; 


ALTER TABLE 方法 要 求 在 表 上 的 一 个 排他 锁 ， 但 是 不 会 导致 有 旧 行 版 本 的 表 膨 胀 。 
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F.17. intagg 


intagg 模块 提供 一 个 整数 聚合 器 和 一 个 枚 举 器 。 intagg 现在 已 经 废 奔 了 ， 因 为 内 置 的 函数 
提供 它 的 能 力 的 一 个 超 集 。 不 过 ， 该 模块 仍然 作为 内 置 函 数 的 兼容 性 封装 器 提供 。 


F.17.1. WAX 


聚合 器 是 一 个 生产 正好 包含 输入 的 整数 的 整数 数组 的 聚合 函 
数 int_array_aggregate(integer) 。 这 是 array_agg 的 封装 eas, array_agg 对 于 任意 数组 类 型 
做 相同 的 事情 。 


setof integer 类 型 的 函 RESI int_array_enum(integer[]) o 本 质 上 是 聚合 器 的 反 
向 操作 : 一 个 整数 数组 ， 将 其 展开 为 一 组 行 。 这 是 unnest 的 封装 器 ， unnest 对 于 任意 
Doe chan. 


F.17.2. 示例 使 用 
许多 数据 库 系 统 有 一 到 多 个 表 的 概念 。 这 样 的 一 个 表 通 常 位 于 两 个 索引 表 之 间 ， 例 如 : 


CREATE TABLE left (id INT PRIMARY KEY, ...); 
CREATE TABLE right (id INT PRIMARY KEY, 
CREATE TABLE one_to_many(left INT REFERENCES left, right INT REFERENCES right); 


通常 这 样 使 用 : 


SELECT right.* from right JOIN one_to_many ON (right.id = one_to_many.right) 
WHERE one_to_many.left = _item_; 


这 将 返回 所 有 在 左手 边 的 表 里 有 记录 的 右手 边 表 里 的 条 目 。 这 在 SQL 中 是 一 个 非常 普通 的 构 


造 。 


现在 ， 这 个 方法 在 一 个 有 非常 大 数量 的 记录 的 one_to_many 表 里 是 很 难处 理 的 。 通常 ， 像 这 
样 的 连接 将 会 导致 索引 扫描 和 抓 取 表 中 有 左手 边 记录 的 每 个 右手 边 记录 。 如 果 你 有 一 个 非常 
动态 的 系统 ， 那 么 没有 什么 你 可 以 做 的 。 不 过 ， 如 果 你 有 一 些 静 态 的 数据 ， 你 可 以 使 用 该 聚 
合 器 创建 一 个 汇总 表 。 


CREATE TABLE summary AS 
SELECT left, int_array_aggregate(right) AS right 
FROM one_to_many 
GROUP BY left; 


这 将 创建 一 个 表 ， 这 个 表 有 每 个 左边 的 条 目 和 一 个 左边 条 目的 数组 。 现在 ， 如 果 没 有 使 用 该 
数组 的 方法 则 是 相当 无 用 的 ; 这 就 是 为 什么 有 一 个 数组 枚 举 器 。 你 可 以 


SELECT left, int_array_enum(right) FROM summary WHERE left = _item_; 


上 面 的 查询 使 用 int_array_enu»m 产生 下 面相 同 的 结果 


SELECT left, right FROM one_to_many WHERE left = _item_; 


不 同 之 处 是 针对 summary 表 的 查询 必须 只 从 表 中 获取 一 行 ， 而 针对 one_to_many 的 直接 查询 
必须 索引 打 描 然后 从 每 条 记录 中 获取 一 行 。 


在 一 个 系统 上 ， 一 个 显示 了 消耗 8488 的 查询 的 ExPLAIN 减少 到 消耗 329。 原始 查询 时 一 个 包 
括 one_to_many 表 的 连接 ， 蔡 换 为 : 


SELECT right, count(right) FROM 
( SELECT left, int_array_enum(right) AS right 
FROM summary JOIN (SELECT left FROM left_table WHERE left = _item_) AS lefts 
ON (summary.left = lefts.left) 
) AS list 
GROUP BY right 
ORDER BY count DESC; 


F.18. intarray 

intarray 模块 为 操作 整数 的 null-free 数 组 提供 一 些 有 用 的 画 数 和 操作 符 。 也 支持 使 用 其 中 的 
一 些 操作 符 执行 索引 搜索 。 

如 果 提 供 的 数组 包含 任何 空 元 素 ， 那 么 所 有 这 些 操作 符 都 将 抛 出 一 个 错误 。 


这 些 操作 符 中 的 一 些 只 对 一 维 数组 人 敏感。 尽管 他 们 将 接受 多 个 维 数 的 输入 数组 ， 数据 被 按照 
存储 的 顺序 当做 一 维 数组 。 


F.18.1. intarray KAFIR EIS 


intarray 模块 提供 的 画 数 显示 在 Table F-8 里 ， 操作 符 显示 在 Table F-9 里 。 


数 


E 


Table F-8. intarray 


> Æ 
Ay a 描述 示例 


数组 中 元 
素 的 个 数 


给 数组 排 
p= 
sort(int[], text dir) int[] dir 必须 Soiree al Ses nl 
A asc 
或 desc 


以 升序 顺 
序 排序 


以 升序 顺 
序 排序 


以 降序 顺 
序 排序 


MERHAR 
的 重复 


匹 

Ac item 的 
第 一 个 元 
素 中 的 索 
引 (如 果 没 
有 则 为 0) 


在 start 
位 置 开 始 
的 ， len 
个 元 素 的 
数组 的 一 
部 分 


在 start 
位 置 开 始 
的 数组 的 
一 部 分 


制作 单个 
intset(int) int[] 元 素 的 数 intset(42) 
组 


icount(int[]) int Teont GE (ay 2 Sheen el) 


sort(int[]) int[] sort(array[11, 77,44] ) 


sort_asc(int[]) int[] 





sort_desc(int[]) int[] 


unig(int[]) int[] uNnLg (Some (4a, 2,73) 2 


idx(int[], int item) int idx(array[11, 22, 33, 22,: 


subarray(int[], int start, int len) int[] subarray('{1,2,3,2,1}' 


subarray(int[], int start) int[] subannay({1)72,3,2, 10 


Table F-9. intarray 操作 符 


操作 符 返回 描述 
int[] && int[] boolean ”重复 一 如 果 数组 至 少 有 一 个 共同 元 素 则 为 true 
int[] @&gt; int[] boolean 包含 一 如 果 左 边 的 数组 包含 右边 的 数组 则 为 true 
包含 于 一 如 果 左 边 的 数组 包含 于 右边 的 数组 则 


int[] &lt;@ int[] boolean > ae 

# int[] int 数组 中 元 素 的 个 数 

int[] # int int 索引 (和 idx WAA) 

int[] + int int[] 将 元 素 推 入 数组 中 (将 元 素 添 加 到 数组 的 末尾 ) 
i int[] 数组 串联 (右边 的 数组 添加 到 左边 的 数组 的 后 面 ) 
int[] - int int[] 删除 匹配 右边 数组 中 元 素 的 项 

A int[] 从 左边 数组 中 删除 右边 数组 中 的 元 素 

int[] @#124; int int[] 参数 的 并 集 

int[] &#124; int[] int[] 数组 的 并 集 

int[] & int[] int[] 数组 的 交集 


int[] @@ query_int boolean ”如 果 数 组 满足 查询 则 为 true (WFX) 
query_int ~~ int[] boolean ”如 果 数 组 满足 查询 则 为 true ( @@ 的 交换 子 ) 


(PostgreSQL 8.2 之 前 ， 包 含 操作 符 @&ggt; 和 &lt;@ 分 别称 为 @ 和 -~ 。 这 些 名 字 仍然 可 以 
使 用 ， 但 是 已 经 废 奔 了 并 且 最 终 会 被 撤销 。 请 注意 ， 旧 的 名 字 从 大 会 移 除 ， 之 前 跟随 着 核心 
几何 数据 类 型 ! ) 


操作 符 ae, @agt; 和 alt;@ SAF pose pe aN ety 除了 它们 只 工作 于 整数 
数组 不 包含 空 ， 而 内 建 操作 符 工作 于 任意 数组 类 型 。 这 个 限制 使 它们 在 任何 情况 下 都 比 内 
建 操 作 符 快 的 多 。 


oe 和 ~~ 操作 符 测试 一 个 数组 是 否 满足 一 个 query， 该 查询 表示 为 一 个 专门 的 数据 类 

型 query_int 的 值 。 query 由 针对 数组 元 素 检查 的 整数 值 组 成 ， 可 能 混合 使 用 操作 符 & (5), 
| (或 ), 和 ! ( 非 )。 在 需要 时 可 以 使 用 括号 。 例如 ， 查 询 1&(213) 匹配 包含 1 也 包含 2 或 3 的 
数组 。 


F.18.2. 索引 支持 


intarray 为 && ，Q@&gt; ，&lt;@ ,和 co 操作 符 还 有 普通 数组 相等 提供 素 引 支持 ， 


提供 两 个 GiST 索 引 操 作 符 类 : gist_int_ops (WAEA) 适合 于 小 到 中 等 的 数据 集 ， 
而 gist__intbig_ops 使 用 一 个 大 的 签名 并 且 更 适合 于 索引 大 的 数据 集 (也 就 是 ， 包含 大 量 不 
同 数组 值 的 字段 ) 。 该 实现 使 用 一 个 RD 树 数据 结构 和 内 建 的 有 损 压缩 。 


还 有 一 个 非 缺 省 的 GIN 操 作 符 类 gin_int_ops 支持 相同 的 操作 符 。 


GiST 和 GIN 索 引 的 选择 取决 于 GiST 和 GIN 相 关 的 性 能 特性 ， 这 个 在 别 的 地 方 讨论 。 一 般 来 
说 ，GIN 索 引 比 GiST 索 引 搜索 起 来 更 快 一 些 ， 而 建立 或 更 新 要 慢 一 些 ; 所 以 GIN 更 适合 于 静 
态 数据 ， 而 GiST 更 适合 于 经 常 更 新 的 数据 。 


F.18.3. 示例 


-- 一 个 message 可 以 在 一 个 或 多 个 "sections" 中 
CREATE TABLE message (mid INT PRIMARY KEY, sections INT[], ...); 


-- 创建 专门 的 索引 
CREATE INDEX message_rdtree_idx ON message USING GIST (sections gist__int_ops); 


-- 在 section 1 或 2 中 选择 message -OVERLAP 操 作 符 
SELECT message.mid FROM message WHERE message.sections && '{1,2}'; 


-- 在 section 1 和 2 中 选择 message -CONTAINS 操 作 符 
SELECT message.mid FROM message WHERE message.sections @> '{1,2}'; 


-- 相同 的 ， 使 用 QUERY 操 作 符 
SELECT message.mid FROM message WHERE message.sections @@ '1&2'::query_int; 


F.18.4. 基准 


源 目录 contrib/intarray/bench 包含 一 个 基准 测 斌 套件。 运行 : 


cd .../bench 

createdb TEST 

psql TEST < ../_int.sql 
./create_test.pl | psql TEST 
./bench. pl 


bench.pl 脚本 有 许多 选项 ， 当 它 不 带 任 何 参数 的 运行 时 显示 。 


F.18.5. 作者 


所 有 工作 都 是 Teodor Sigaev ( &lt;[teodor@sigaev.ru](mailto:teodor@sigaev.ru)&gt; ) 和 Oleg 
Bartunov ( &1t; [oleg@sai.msu.su](mailto:oleg@sai.msu.su)&gt; ) 完 成 的 。 参阅 
http://www.sai.msu.su/~megera/postgres/gist/ 获 取 人 额外 的 信息 。 Andrey Oktyabrski 在 添加 新 
的 函数 和 操作 符 上 做 了 一 个 伟大 的 工作 。 


F.19. isn 


isn 模块 为 下 列 的 国际 产品 编号 标准 提供 数据 类 型 : EAN13, UPC, ISBN (books), ISMN 
(music), and ISSN (serials)。 编 号 在 输入 时 是 经 过 确认 的 ， 根 据 一 个 前 级 的 硬 编码 列表 ; 这 
个 前 级 列表 也 用 于 在 输出 时 连接 编号 。 因 为 不 时 地 分 配 新 的 前 级 ， 所 以 前 级 列表 可 能 过 期 。 
希望 这 个 模块 的 将 来 版 本 可 以 根据 需要 ， 从 一 个 或 多 个 可 以 通过 用 户 容易 更 新 的 表 中 获得 前 
级 列表 ; 不 过 ， 目 前 该 列表 只 能 通过 修改 源 代 码 和 重新 编译 来 更 新 。 或 者 ， 在 这 个 模块 的 将 


来 版 本 中 ， 


前 级 确认 或 连接 支持 可 能 会 被 删除 。 


F.19.1. 数据 类 型 


Table F-10 显 示 了 isn 模块 支持 的 数据 类 型 。 


Table F-10. isn 数据 类 型 


数据 类 
型 


EAN13 


ISBN13 


ISMN13 


ISSN13 


ISBN 


ISMN 


ISSN 


UPC 


一 些 各 注 : 


描述 
European Article Numbers (欧洲 文章 号 ) , 总 是 以 EAN13 显示 格式 显示 
International Standard Book Numbers (国际 标准 书号 ) ， 以 新 EAN13 显 示 
格式 显示 
International Standard Music Numbers (国际 标准 音乐 号 ) ， 以 新 EAN13 显 
示 格 式 显 示 
International Standard Serial Numbers (国际 标准 序列 号 ) ， 以 新 EAN13 显 
示 格 式 显 示 


International Standard Book Numbers (国际 标准 书号 ) ， 以 旧 的 短 显 示 格 式 
显示 


International Standard Music Numbers (国际 标准 音乐 号 ) ， 以 旧 的 短 显示 
格式 显示 


International Standard Serial Numbers (国际 标准 序列 号 ) ， 以 旧 的 短 显示 
格式 显示 


Universal Product Codes (通用 产品 条 码 ) 


1. ISBN13, ISMN13, ISSN13 编 号 都 是 EAN13 编 号 。 


2. EAN13 编 号 并 不 总 是 |SBN13, ISMN13 或 ISSN13 (有 些 是 ) 。 


3. 一 些 |SBN13 编 号 可 以 以 |ISBN 显 示 。 


4. 一 些 ISMN13 编 号 可 以 以 ISMN 显 示 。 

5 一些 ISSN13 编 号 可 以 以 ISSN 显示 。 

6. UPC 编 号 是 EAN13 编 号 的 一 个 子 集 (它们 基本 上 是 没有 第 一 个 8 数字 的 EAN13) 。 
7. 所 有 UPC, ISBN, ISMN 和 ISSN 编 号 都 可 以 用 EAN13 编 号 表示 。 


在 内 部 ， 所 有 这 些 类 型 使 用 相同 的 表示 (一 个 64 位 整数 ) ， 并 且 所 有 类 型 相互 之 间 可 以 转 
换 。 提供 多 种 类 型 控制 显示 格式 和 人 允许 对 应 该 表示 一 个 编号 的 特定 类 型 的 输入 更 严格 的 有 效 
性 检查 。 


ISBN, ISMN , 和 ISSN 类 型 将 在 可 能 时 显示 编号 的 短 版 本 (|SxN 10)， 不 适合 端 版 本 的 编号 
显示 ISxN 13 格 式 。 EAN13 , ISBN13 ，ISMN13 和 ISSN13 类 型 总 是 显示 ISxN 的 长 版 本 
(EAN13)。 


F.19.2. 转换 


isn 模块 支持 下 列 的 类 型 转换 对 : 

e ISBN13 <=> EAN13 
e ISMN13 <=> EAN13 
e ISSN13 <=> EAN13 
e ISBN <=> EAN13 

e ISMN <=> EAN13 

e ISSN <=> EAN13 

e UPC <=> EAN13 

e ISBN <=> ISBN13 

e ISMN <=> ISMN13 
e ISSN <=> ISSN13 


HM canis 转换 到 其 他 类 型 时 ， 有 一 个 运行 时 检查 ， 值 在 其 他 类 型 的 领域 内 ， 如 果 不 在 则 抛 
出 一 个 错误 。 其 他 转换 只 是 简单 的 确认 ， 总 是 会 成 功 。 


F.19.3. 函数 和 操作 符 


isn 模块 提供 标准 的 比较 运算 符 ， 加 上 B-tree 和 哈 希 索引 支持 所 有 的 这 些 数据 类 型 。 另外 ， 
有 几 个 专门 的 函数 ; 显示 在 Table F-11 中 。 在 这 个 表 中 ， isn 意 为 模块 的 数据 类 型 之 一 。 


Table F-11. isn WH 


EJZ 返回 描述 
isn_weak(boolean) boolean 设置 weak 输 入 模式 (返回 新 的 设置 ) 
isn_weak() boolean 获取 当前 weak 模式 的 状态 
make_valid(isn) isn 确认 一 个 无 效 数字 (清除 无 效 标识 ) 
is_valid(isn) boolean 检查 无 效 标识 的 存在 


Weak 模 式 用 于 可 以 插入 无 效 数据 到 表 中 。 无 效 的 意思 是 检查 位 为 wrong， 而 不 是 说 它们 是 丢 
失 的 数字 。 


为 什么 想 要 使 用 weak 模 式 ? 很 好 ， 可 能 你 有 一 个 巨大 的 ISBN 编 号 的 采集 ， 其 中 的 一 些 因为 怪 
异 的 原因 有 wrong 检查 位 〈 可 能 编号 是 从 打印 列表 扫描 进来 的 ， 而 OCR (光学 字符 识别 ) 获 
取 编 号 错误 ， 也 或 许 编号 是 手动 捕获 的 .…... 谁 知道 呢 ) 。 无 论 如 何 ， 关 键 是 你 可 能 想 要 清理 
这 个 烂摊子， 但 是 你 又 想 要 在 你 的 数据 库 中 有 所 有 的 编号 ， 或 许 使 用 一 个 额外 的 工具 在 数据 
库 中 定位 无 效 编号 ， 这 样 你 就 可 以 验证 信息 并 使 其 更 容易 的 生效 ; 例如 你 想 要 在 表 中 选择 所 
有 无 效 编号 。 


当 你 使 用 weak 模 式 插 入 无 效 编号 到 一 个 表 中 时 ， 该 编号 将 带 有 修正 的 检查 位 插入 ， (BEER 
示 时 将 在 后 面 带 有 一 个 叹 号 标记 ( ! )， 例 如 o-11-000322-51 o 这 些 无 效 标记 可 以 
用 is_valid HÄR E AmA make_valid 西数 清除 。 


即使 不 在 weak 模 式 下 ， 你 也 可 以 强制 插入 无 效 编号 ， 通 过 在 编号 后 面 附加 ! 字符 。 
另 一 个 特别 特征 是 在 输入 期 间 ， 可 以 在 检查 位 上 写 ? ， 并 且 正 确 的 检查 位 将 自动 插入 。 


F.19.4. 例子 


- -直接 使 用 类 型 : 

SELECT isbn('978-0-393-04002-9'); 
SELECT Isbn13( '0901690546 ); 
SELECT issn('1436-4522'); 


- -转换 类 型 : 

-- 请 注意 ， 你 只 能 从 ean13 转 换 到 另外 一 个 类 型 当 

-- 数字 在 目标 类 型 的 领域 中 将 会 是 有 效 的 ; 

-- 因此 下 列 将 不 会 工作 : select isbn(ean13('0220356483481')); 
-- 但 是 他 们 将 : 

SELECT upc(eani3( '0220356483481')); 
SELECT eani3(upc('220356483481')); 

- -创建 一 个 单个 字段 的 表 以 保持 ISBN 编 码 : 

CREATE TABLE test (id isbn); 

INSERT INTO test VALUES('9780393040029'); 
- -自动 计算 校 验 数位 〈 观 察 '? ' ) : 

INSERT INTO test VALUES('220500896?' ) ; 
INSERT INTO test VALUES('978055215372?'); 


SELECT issn('3251231?'); 
SELECT ismn('979047213542?'); 


- -使 用 weak 模 式 : 

SELECT isn_weak(true); 

INSERT INTO test VALUES('978-@-11-000533-4'); 
INSERT INTO test VALUES('9780141219307'); 
INSERT INTO test VALUES('2-205-00876-X'); 
SELECT isn_weak( false); 


SELECT id FROM test WHERE NOT is_valid(id); 
UPDATE test SET id = make_valid(id) WHERE id = '2-205-00876-X!'; 


SELECT * FROM test; 


SELECT isbni3(id) FROM test; 


F.19.5. 参考 文献 


实施 这 个 模块 的 信息 从 几 个 站 点 收集 而 来 ， 包 括 : 
e http://www.isbn-international.org/ 
e http://www.issn.org/ 
e http://www.ismn-international.org/ 
e http://www.wikipedia.org/ 
用 于 连 字符 的 前 缀 也 从 下 列 编译 而 来 : 
e http://www.gs1.org/productssolutions/idkeys/support/prefix_list.html 
e http://www.isbn-international.org/en/identifiers.html 


e http://www.ismn-international.org/ranges.html 


在 算法 创建 期 间 要 小 心 ， 并 且 他 们 对 在 官方 ISBN, ISMN, ISSN 用 户 手 册 中 建议 的 算法 进行 仔 
细 的 验证 。 


F.19.6. 作者 


German Méndez Bravo (Kronuz), 2004 - 2006 


这 个 模块 的 灵感 来 自 Garrett A. Wollman 的 isbn_issn 代码 。 


F.20. lo 


lo 模块 为 管理 大 对 象 《也 叫做 LO 或 BLOB) 提供 支持 。 包括 数据 类 型 lo 和 触发 


器 lo_manage o 


F.20.1. 原理 


JDBC 了 驱动 的 问题 之 一 (也 影响 ODBC 了 驱动 ) ， 是 规范 假设 BLOB (二 进 制 大 对 象 ) 的 参数 是 
存储 在 一 个 表 内 的 ， 并 且 如 果 该 项 改变 了 ， 那 么 相关 的 BLOB 会 从 数据 库 中 删除 。 


作为 PostgreSQL 标 准 ， 这 个 不 会 发 生 。 大 对 象 被 视 为 对 象 ; 一 个 表 项 可 以 通过 OID 引 用 一 个 
大 对 象 ， 不 过 可 能 多 个 表 项 引用 同一 个 大 对 象 OID， 所 以 系统 不 会 因为 你 改变 或 删除 一 个 表 
项 就 删除 大 对 象 。 


这 对 PostgreSQL 专 有 应 用 来 说 很 好 ， 但 是 使 用 JDBC 或 ODBC 的 标准 代码 不 会 删除 大 对 象 ， 
导致 孤独 的 对 象 一 对 象 不 被 任何 东西 引用 ， 只 是 简单 的 占用 磁 胡 空间 。 


lo 模块 允许 通过 在 包含 LO 引用 字段 的 表 上 附加 一 个 触发 器 修复 这 个 问题 。 该 触发 器 本 质 上 
只 是 在 你 删除 或 修改 一 个 引用 大 对 象 的 值 时 做 lo_unlink 。 当 使 用 这 个 触发 器 时 ， 假 设 只 有 
一 个 数据 库 引 用 被 触发 器 控制 字段 引用 的 任意 的 大 对 象 。 


该 模块 也 支持 数据 类 型 1o ， 该 类 型 实际 上 只 是 一 个 oid 类 型 的 域 。 这 对 于 区 别 持 有 大 对 象 
引用 的 数据 库 字 段 和 那些 其 他 事情 的 OID 有 帮助 。 你 不 必 使 用 10 类 型 来 使 用 该 触发 器 ， 但 
是 使 用 它 会 很 方便 的 记录 你 的 数据 库 中 的 哪个 字段 代表 管理 该 触发 器 的 大 对 象 ， 如 果 你 不 为 
BLOB 字 段 使 用 1o ， 据 说 ODBC 驱 动 器 也 会 感到 迷惑 。 


F.20.2. 怎样 使 用 
这 是 一 个 使 用 的 简单 的 例子 : 


CREATE TABLE image (title TEXT, raster lo); 


CREATE TRIGGER t_raster BEFORE UPDATE OR DELETE ON image 
FOR EACH ROW EXECUTE PROCEDURE 1lo_manage(raster); 


对 于 每 个 将 要 包含 大 对 象 的 唯一 引用 的 字段 ， 创 建 一 个 BEFORE UPDATE OR DELETE 触发 器 ， 并 
将 字段 名 作为 触发 器 唯一 的 参数 。 你 也 可 以 通过 使 用 BEFORE UPDATE OF _column_name_ ”限制 
触发 器 只 在 该 字段 更 新 时 执行 。 如 果 你 在 相同 的 表 中 需要 多 个 lo 字段 ， 那么 为 每 个 字段 创 
建 一 个 单独 的 触发 器 ， 记 得 给 相同 表 上 的 每 个 触发 器 以 不 同 的 名 字 。 


F.20.3. 限制 
。 删除 一 个 表 仍 然 将 孤立 它 包 含 的 任意 对 象 ， 因 为 触发 器 没有 执行 。 你 可 以 通过 
在 DROP TABLE 之 前 DELETE FROM _table 来 避免 这 个 问题 。 
TRUNCATE 有 同样 的 危险 。 


如 果 你 已 经 有 或 者 怀疑 你 有 孤立 的 大 对 象 ， 参 阅 vacuumlo 模块 帮助 你 清除 它们 。 偶 尔 运 
行 vacuumlo 作为 10_manage 触发 器 的 后 各 是 一 个 好 主意 。 


。 一 些 前 端 可 能 创建 他 们 自己 的 表 ， 并 且 不 创建 相关 的 触发 器 。 还 有 ， 用 户 可 能 不 记得 
(或 知道 ) 创建 触发 器 。 


F.20.4. 作者 


Peter Mount &1t;[peter@retep.org.uk](mailto:peter@retep.org.uk)&gt; 


F.21. Itree 


这 个 模块 实现 了 数据 类 型 1tree ， 该 类 型 表示 存储 在 分 层 的 树 形 结构 里 的 数据 的 标签 。 提供 
大 量 的 工具 搜索 标签 树 。 


F.21.1. 定义 


/abe/ 是 一 个 字母 数字 字符 和 下 划 线 的 序列 (例如 ， 在 C 语 言 环境 ， 字符 A-za-z0-9 是 允许 
的 ) 。 标 签 长 度 必 须 少 于 256 字 节 。 


示例 : 42, Personal_Services 
label pa 妨 是 需 个 或 多 个 由 点 分 隔 的 标签 序列 ， 例 如 L1.12.L3 ， 表示 由 树 状 结构 的 根 节 点 到 


具体 节点 的 路 径 。 标 签 路 径 的 长 度 必 须 少 于 65Kb， 但 是 保持 在 2Kb 以 下 是 最 好 的 。 实 际 上 ， 
这 不 是 主要 限制 ; 例如 ， 在 DMOZ 目 录 中 的 最 长 标签 路 径 (http:/www.dmoz.org) 大 约 240 字 
节 。 


示例 : Top.Countries.Europe.Russia 


ltree 模块 提供 几 种 数据 类 型 : 
© Itree 存储 标签 路 径 。 


e lquery 表示 一 个 正规 表达 式 类 似 的 模式 以 匹配 ltree 值 。 在 一 个 路 径 中 一 个 单词 匹配 
那个 标签 。 星 号 ( * ) 匹 配 需 个 或 多 个 标签 。 例 如 : 


foo 准确 匹配 标签 路 径 “foo-、 
* foo.* 匹配 任何 包含 标签 foo ”的 标签 路 径 
* foo 匹配 任何 以 “foo” 结束 的 标签 路 径 


可 以 量化 星 号 来 限制 可 以 匹配 多 少 个 标签 : 


*{n} 准确 匹配 n 个 标签 

*{n,} 至 少 匹 配 n 个 标签 

* {n,m} 至 少 匹 配 n 个 但 不 超过 m 个 标签 
*{,m} 最 多 匹配 m 个 标签 ~ 和 *{0,m 相同 } 


有 几 个 修饰 符 可 以 放 在 lquery 中 非 星 号 标签 的 后 面 ， 使 其 不 只 是 匹配 正好 的 那个 : 


匹配 大 小 写 无 关 ， 例 如 a@ 匹配 A 
匹配 任何 带 有 这 个 前 级 的 标签 ， 例 如 foo* 匹配 foobar 
% 匹配 字 首 下 划 线 分 开 的 单词 


* © 


% 的 行为 稍微 有 点 复杂 。 它 试图 匹配 单词 而 不 是 整个 标签 。 例 如 foo_bar% 匹配 
foo_bar_baz 而 不 是 foo_barbaz 。 如 果 与 * 结合 ， 前 组 匹配 分 别 应 用 到 每 个 单词 ， 例 
如 foo_bar%* 匹配 foo1 bar2_baz 而 不 是 not foo1_br2_baz o 


还 有 ， 可 以 写 几 个 由 | (OR) 分 开 的 标签 以 匹配 任意 这 些 标签 ， 并 且 可 以 在 开始 放置 ， 
(NOT) 以 匹配 任何 不 匹配 任何 可 选 标签 的 标签 。 


这 是 一 个 带 有 评注 的 1query 的 例子 : 


Top.*{0,2}.sport*@. !football|tennis.Russ*|Spain 
a. b. Ce d. en 


这 个 查询 将 匹配 任何 标签 路 径 : 


1， 以 标签 top 开始 


2. 然后 有 0 到 2 个 标签 

3. 然后 是 一 个 带 有 大 小 写 不 敏感 前 级 sport 的 标签 

4. 然后 是 一 个 既 不 匹配 football 也 不 匹配 tennis 的 标签 

5， 然 后 以 一 个 带 有 Russ 或 准确 匹配 spain 开头 的 标签 作为 结束 。 


。 ltxtquery 表示 一 个 匹配 ltree 值 的 全 文本 搜索 风格 模式 。 1ltxtquery 值 包含 单词 ， 可 
能 在 结尾 带 有 修饰 词 8 ，* ，% ， 这 些 修 饰 词 的 含义 和 在 lquery 中 的 含义 相同 。 单 词 
可 以 与 & (AND), | (OR)，! (NOT) 和 圆 括号 结合 。 与 1query 主要 的 不 同 
是 ltxtquery 匹配 单词 时 不 考虑 单词 在 标签 路 径 中 的 位 置 。 


这 是 一 个 ltxtquery 的 例子 : 


Europe & Russia*@ & !Transportation 


这 将 匹配 包含 Europe 标签 和 以 russia (ADETE) 开始 的 标签 的 路 径 ， 但 是 不 匹 
配 包含 Transportation 标签 的 路 径 。 这 些 单 词 在 路 径 中 的 位 置 并 不 重要 。 还 有 ， 当 使 用 
了 % 时 ， 该 单词 能 匹配 标签 中 任何 用 下 划 线 分 隔 单词 ， 不 管 位 置 在 哪 。 


注意 : 1txtquery 人 允许 符号 之 间 有 空格 ， 但 是 ltree 和 lquery 不 人 允许 这 样 做 。 


F.21.2. 操作 符 和 函数 


类 型 ltree 有 平常 的 比较 操作 符 = ，&ltiagt; ，&lt; ，&gt; ，&lt;= ，&gt;= 。 比较 的 优先 
级 以 树 通 历 的 顺序 ， 节 点 的 子 节点 以 标签 文本 排序 。 另 处， 在 Table F-12 中 显示 的 专业 的 操 
作 符 是 可 用 的 。 


Table F-12. itree 操作 符 


操作 符 返回 描述 








ltree @&gt; tree boolean 左边 参数 是 右边 参数 的 上 代 (或 相等 )? 

ltree &lt;@ ltree boolean 左边 参数 是 右边 参数 的 后 代 (或 相等 )? 

ltree ~ lquery boolean ltree 匹配 lquery ? 

lquery ~ ltree boolean ltree 匹配 lquery ? 

ltree 7? lquery[] boolean ltree 匹配 数组 中 的 任意 lquery ? 

lquery[] ? ltree boolean ltree 匹配 数组 中 的 任意 1query ? 

ltree @ ltxtquery boolean ltree PLAC ltxtquery ? 

ltxtquery @ ltree boolean ltree 匹配 ltxtquery ? 

a &#124;&#124; ltree 连接 eS 路 径 

ltree a&#124;8#124; ltree 。 将 文本 转化 成 ltre。 并 连接 

text eh124;84124; ltree 。 将 文本 转化 成 Itree 并 连接 

ltree[] @&gt; ltree boolean 数组 包含 itree 的 祖先 ? 

ltree &lt;@ ltree[] boolean 数组 包含 itree 的 祖先 ? 

ltree[] &1t;@ ltree boolean 数组 包含 itree 的 后 代 ? 

ltree @&gt; ltree[] boolean 数组 包含 itree 的 后 代 ? 

ltree[] ~ 1lquery boolean 数据 包含 任何 匹配 lquery 的 路 径 ? 

lquery ~ ltree[] boolean 数据 包含 任何 匹配 lquery 的 路 径 ? 

ltree[] ? lquery[] boolean Itree 数组 包含 任意 路 径 匹 配 任意 lquery ? 
lquery[] 7?  ltree[] boolean ltree 数组 包含 任意 路 径 匹 配 任意 1query ? 
ltree[] @ 1txtquery boolean 数据 包含 任意 路 径 匹 配 itxtquery ? 
ltxtquery @ ltree[] boolean 数组 包含 任意 路 径 匹 配 1txtquery ? 

ltree[] ?@&gt; 第 一 个 数组 条 目 是 ltree 的 和 祖先? ; 如 果 不 是 
ltree 则 为 NULL 

ltree[] ?&lt;@ ATE 第 一 个 数组 条 目 是 ltree 的 后 代 ?; 如 果 不 是 
ltree 则 为 NULL 

facut aes Sate kre. R lquery ?; 如 果 不 是 则 
ltree[] ?@ TSS 第 一 个 数组 条 目 匹 配 itxtquery 2; 如 果 不 是 
1txtquery 则 为 NULL 


操作 符 alt:@, ，@ggt; ，@ 和 - 类 似 alt;@ ，^@&gt; ，^@ ，^~ ， 除 了 不 用 索引 之 外 都 相 
同 。 这 些 只 是 对 于 测试 目的 有 用 。 


可 用 的 函数 显示 在 Table F-13 中 。 


Table F-13. 1ltree KÆ 


EEs 


subltree(ltree, int start, int end) 


subpath(ltree, int offset, int len) 


subpath(ltree, int offset) 


nlevel(ltree) 


ltree 


ltree 


ltree 


integer 


描述 


ltree 的 
子路 径 ， 
从 位 置 


start 
到 位 置 
end -1 
(从 0 开始 
计算 ) 
ltree 
的 子路 
径 ， 从 位 
E 
offset 
开始 ， 长 
度 为 
len o 


如 果 


offset 
为 负 值 ， 
子路 径 从 
路 径 的 结 
尾 开 始 。 
如 果 

len 是 
负 值 ， 
那么 距离 
路 径 的 结 
尾 多 少 个 


ltree 

的 子路 
径 ， 从 位 
ia 
offset 
开始 ， 一 
直到 路 径 
的 结 
如 果 
offset 
为 负 值 ， 
那么 子路 
径 从 路 径 
的 结尾 开 
始 。 


路 径 中 的 
标签 的 个 


数 


mf 


subltree('Top.Child1.¢ 


subpath('Top.Child1.Cr 


subpath('Top.Child1.Cr 


nlevel( ‘Top)..¢haldt cha 


b 在 

a 中 第 

一 次 出 现 
index(ltree a, ltree b) integer 的 位 置 ; 

如 果 没 

发 现 则 为 

-1 


b 在 

a 中 第 
一 次 出 现 
的 位 置 ， 
从 


offset 


人 
index(ltree a, Itree b, int offset) integer 开始 搜 
R; 负 的 
offset 
意味 从 路 
径 结尾 开 
始 
口 
-offset 
个 标签 


将 text 
text21ltree( text) ltree 转换 为 
ltree 


将 
ltree 


转换 为 


text 


最 低 的 公 
共和 祖先 ， 

路 径 的 最 
长 公共 前 
级 (支持 
多 达 8 个 


参数 ) 


最 低 的 公 
HAASE, 
th E 
lca(ltree[]) ltree PaaS 
生日 J EX 
长 公共 前 
BR 


ltree2text(ltree) text 


lca(litree, ltree, ...) ltree 


F.21.3. 35 


ltree 支持 索引 的 几 个 类 型 ， 可 以 加 速 指出 的 操作 符 : 


e itree 上 的 B-tree 索引 : alt; , alt;=, =, agt;=, &gt; 


lind ex (OT 2 Ono 


neXi(O ON 2 Or ARDS 


Kee OAS An ach: A 2 


Tealarnray mela Ze 2 steel 


e itree ERY GIST 5|: ait; , alt;=, =, &gt;=, &gt; , @&gt; , &lt:@ ， 


创建 这 样 一 个 索引 的 列子 : 


CREATE INDEX path_gist_idx ON test USING GIST (path); 


e 1ltree[] LAY GIST 5|: 1ltree[] &lt;@ ltree , ltree @&%gt; ltree[] , 


创建 这 样 一 个 索引 的 例子 : 


CREATE INDEX path_gist_idx ON test USING GIST (array_path ) ; 


注意 : 这 种 索引 类 型 损耗 很 大 。 


F.21.4. 示例 


这 个 示例 使 用 下 列 的 数据 (在 源 代码 发 布 中 的 contrib/ltree/ltreetest.sql 文件 中 也 可 


FA) 


CREATE TABLE test (path ltree); 

INSERT INTO test VALUES ('Top'); 

INSERT INTO test VALUES ('Top.Science'); 

INSERT INTO test VALUES ('Top.Science.Astronomy' ); 

INSERT INTO test VALUES ('Top.Science.Astronomy.Astrophysics'); 
INSERT INTO test VALUES ('Top.Science.Astronomy.Cosmology'); 

INSERT INTO test VALUES ('Top.Hobbies'); 

INSERT INTO test VALUES ('Top.Hobbies.Amateurs_Astronomy'); 

INSERT INTO test VALUES ('Top.Collections'); 

INSERT INTO test VALUES ('Top.Collections.Pictures'); 

INSERT INTO test VALUES ('Top.Collections.Pictures.Astronomy' ); 
INSERT INTO test VALUES ('Top.Collections.Pictures.Astronomy.Stars'); 
INSERT INTO test VALUES ('Top.Collections.Pictures.Astronomy.Galaxies'); 


INSERT INTO test VALUES ('Top.Collections.Pictures.Astronomy.Astronauts'); 


CREATE INDEX path_gist_idx ON test USING gist(path); 
CREATE INDEX path_idx ON test USING btree(path); 


现在 ， 我 们 有 一 个 表 test ， 由 下 面 显 示 的 数据 描述 层级 构成 : 


Top 
/ PN 
Science Hobbies Collections 
/ | \ 
Astronomy Amateurs_Astronomy Pictures 
ifs N | 
Astrophysics Cosmology Astronomy 
ue || \ 
Galaxies Stars Astronauts 


现在 我 们 可 以 做 继承 : 


@, 


@ , 


? 


ltreetest=> SELECT path FROM test WHERE path <@ 'Top.Science'; 
path 

Top.Science 

Top.Science.Astronomy 

Top.Science.Astronomy.Astrophysics 

Top.Science.Astronomy.Cosmology 

(4 rows) 


这 里 是 一 些 路 径 匹 配 的 例子 : 


ltreetest=> SELECT path FROM test WHERE path ~ '*.Astronomy.*'; 
path 

Top.Science.Astronomy 

Top.Science.Astronomy.Astrophysics 

Top.Science.Astronomy.Cosmology 

Top.Collections.Pictures.Astronomy 

Top.Collections.Pictures.Astronomy.Stars 

Top.Collections.Pictures.Astronomy.Galaxies 

Top.Collections.Pictures.Astronomy.Astronauts 

(7 rows) 


ltreetest=> SELECT path FROM test WHERE path ~ '*.!pictures@.*.Astronomy.*'; 
path 

Top.Science.Astronomy 

Top.Science.Astronomy.Astrophysics 

Top.Science.Astronomy .Cosmology 

(3 rows) 


这 里 是 一 些 全 文本 搜索 的 例子 : 


ltreetest=> SELECT path FROM test WHERE path @ 'Astro*% & !pictures@'; 
path 

Top.Science.Astronomy 

Top.Science.Astronomy.Astrophysics 

Top.Science.Astronomy .Cosmology 

Top.Hobbies.Amateurs_Astronomy 

(4 rows) 


ltreetest=> SELECT path FROM test WHERE path @ 'Astro* & !pictures@'; 
path 

Top.Science.Astronomy 

Top.Science.Astronomy.Astrophysics 

Top.Science.Astronomy .Cosmology 

(3 rows) 


ltreetest=> SELECT subpath(path,0,2)||'Space'||subpath(path,2) FROM test WHERE path <@ 'T 
?column? 

Top.Science.Space.Astronomy 

Top.Science.Space.Astronomy.Astrophysics 

Top.Science.Space.Astronomy.Cosmology 

(3 rows) 


«| m 








我 们 可 以 通过 创建 一 个 SQL 男 数 来 简化 ， 该 落 数 在 路 径 中 的 指定 位 置 插入 一 个 标签 : 


CREATE FUNCTION ins_label(ltree, int, text) RETURNS ltree 
AS ‘select subpath($1,0,$2) || $3 || subpath($1,$2);' 
LANGUAGE SQL IMMUTABLE; 


ltreetest=> SELECT ins_label(path,2,'Space') FROM test WHERE path <@ 'Top.Science.Astrono 
ins_label 
Top.Science.Space.Astronomy 
Top.Science.Space.Astronomy.Astrophysics 
Top.Science.Space.Astronomy.Cosmology 
(3 rows) 





aj 


F.21.5. 作者 


所 有 工作 都 是 Teodor Sigaev ( &lt; [teodor@stack.net](mailto:teodor@stack.net)&gt; ) 和 
Oleg Bartunov ( &1t; [oleg@sai.msu.su] (mailto:oleg@sai.msu.su)&gt; ) 做 的 。 参 阅 
http://www.sai.msu.su/~megera/postgres/gist/ 获 取 额 外 的 信息 。 作者 感谢 Eugeny Rodichev 
的 有 帮助 的 讨论 。 欢 迎 评 论 和 报告 bug。 





F.22. pageinspect 


pageinspect 模块 提供 允许 在 一 个 低 水 平 检 查 数据 库 页 面 的 内 容 的 范 数 ， 这 对 于 调试 目的 很 
有 用 。 所 有 这 些 函 数 只 能 是 超级 用 户 使 用 。 


F.22.1. WAX 


get_raw_page(relname text, fork text, blkno int) returns bytea 


get_raw_page 读 取 命名 表 指 定 的 块 并 返回 一 个 拷贝 作为 bytea 值 。 这 人 允许 获得 一 个 该 块 的 时 
间 一 致 的 拷贝 。 _fork_ 应 该 是 主 数据 派生 的 'main' , 或 自由 空间 映射 的 'fsm' , 或 可 见 映 
射 的 ，vm' o 


get_raw_page(relname text, blkno int) returns bytea 


get_raw_page 的 短 版 本 ， 从 主 分 支 上 读 取 。 等 于 get_raw_page(relname, 'main', blkno) 


page_header(page bytea) returns record 
page_header 显示 了 和 所 有 PostgreSQL 堆 和 索引 页 相同 的 字段 。 


get_raw_page 获得 的 页 图 像 应 该 作为 一 个 参数 传送 。 例 如 : 


test=# SELECT * FROM page_header(get_raw_page('pg_class', 0)); 
lsn | checksum | flags | lower | upper | special | pagesize | version | prune_xid 


0/24A1B50 | 1 | 1 | 232 | 368 | 8192 | 8192 | 4 | 0 





返回 的 列 符合 PageHeaderpata 结构 中 的 字段 。 参阅 src/include/storage/bufpage.h 获取 详细 


信息 
Aso 


heap_page_items(page bytea) returns setof record 


heap_page_items 显示 了 一 个 堆 页 面 中 所 有 的 行 指针 。 对 于 那些 在 使 用 中 的 行 指针 ， 也 显示 元 
组 头 文 件 。 所 有 的 元 组 都 显示 ， 不 管 元 组 在 拷贝 原始 页 面 时 对 MVCC 快 照 是 否 可 见 。 


get_raw_page 获得 的 堆 页 面 图 像 应 该 作为 一 个 参数 传递 。 例 如 : 


test=# SELECT * FROM heap_page_items(get_raw_page('pg_class', 0)); 


参阅 src/include/storage/itemid.h 和 src/include/access/htup_details.h 获取 返回 的 字段 的 
解释 。 


bt_metap(relname text) returns record 


bt_metap JRIEIXFB-tree SINT RANE. GA: 


test=# SELECT * FROM bt_metap('pg_cast_oid_index'); 


-[ RECORD 1 ]----- 
magic | 340322 
version | 2 
root | 
level | © 
fastroot | 1 
fastlevel | 0 


bt_page_stats(relname text, blkno int) returns record 


bt_page_stats 返回 关于 B-tree 索 引 的 单个 页 面 的 摘要 信息 。 例 如 : 


test=# SELECT * FROM bt_page_stats('pg_cast_oid_index', 1); 
-[ RECORD 1 ]-+----- 


blkno at 
type al 
live_items | 256 
dead_items | 0 
avg_item_size | 12 
page_size | 8192 
free_size | 4056 
btpo_prev | 0 
btpo_next | © 
btpo | 0 
btpo_flags | 3 


bt_page_items(relname text, blkno int) returns setof record 


bt_page_items 返回 关于 B-tree 索 引 页 中 的 所 有 条 目的 详细 信息 。 例 如 : 


itemoffset | ctid | itemlen | nulls | vars | data 

本 三 和 e 
1 | (0,1) | 12 | f | f | 23 27 00 00 
2 | (0,2) | 1 e list | 24 27 00 00 
3 | (0,3) | 12 | f lets | 25 27 00 00 
4 | (0,4) | 1 Wl ir | f | 26 27 00 00 
5 | (0,5) | > | SF pte | 27 27 00 00 
6 | (0,6) | 1 |) ar list | 28 27 00 00 
7 | (0,7) | 12 | f lists | 29 27 00 00 
8 | (0,8) | 12 | f f | 2a 27 00 00 


fsm_page_contents(page bytea) returns text 


fsm_page_contents 显示 了 FSM 页 的 内 部 节点 结构 。 输 出 是 多 行 字符 串 ， 在 该 页 中 的 二 叉 树 上 
每 个 节点 一 行 。 这 些 节点 中 只 有 不 是 需 的 才 输 出 。 号 称 "next" 的 指针 ， 指向 下 一 个 从 页 面 中 返 
回 的 位 置 的 指针 ， 也 输出 。 


EB 阅 src/backend/storage/freespace/README 获取 更 多 关于 FSM 页 面 的 结构 的 信息 。 


F.23. passwordcheck 


passwordcheck 模块 当 用 户 设置 CREATE ROLE 或 ALTER ROLE 时 ， 检查 用 户 的 密码 。 如 果 
认为 一 个 密码 太 弱 ， 那么 将 拒绝 该 密码 并 且 命令 将 带 有 错误 终止 。 


要 启用 这 个 模块 ， 在 postgresql.conf 中 添加 
'$libdir/passwordcheck' 到 shared _preload libraries, 然后 重启 服务 器 。 


你 可 以 通过 改变 源码 调整 这 个 模块 为 你 所 需 的 样子 。 例 如 ， 你 可 以 使 用 CrackLib 检查 密码 一 
这 只 需要 在 makefile 文件 中 取消 两 行 的 注释 ， 并 重新 编译 该 模块 。 (因为 许可 证 的 原因 ， 我 
们 缺 省 不 能 包括 CrackLib。) 没有 CrackLib， 该 模块 为 密码 强度 强制 一 些 简 单 的 规则 ， 这 些 
规则 可 以 根据 你 认为 合适 的 去 修改 或 扩展 。 


Caution 


为 了 阻止 未 加 密 的 口令 通过 网 络 发 送出 去 、 写 到 服务 器 日 志 或 被 数据 库 管 理 员 伦 走 ， 
PostgreSQL 允 许 用 户 提供 预先 加 密 的 口令 。 许多 客户 端 程序 使 用 这 个 功能 ， 并 在 发 送 到 
服务 器 之 前 加 密 口 今 。 


这 会 限制 passwordcheck 模块 的 有 用 性 ， 因 为 那 种 情况 下 只 能 党 试 猜测 口 依 。 因为 这 个 原 
因 ， 如 果 你 的 安全 需求 比较 高 ， 那 么 不 建议 使 用 passwordcheck 。 使 用 一 个 额外 的 认证 方法 
(如 Kerberos) (参阅 Chapter 19) 比 依赖 于 数据 库 中 的 密码 更 安全 。 


或 者 ， 你 可 以 修改 passwordcheck 拒绝 预先 加 密 的 口令 ， 但 是 强制 用 户 以 明文 的 方式 设置 他 
们 的 口令 有 其 自身 的 安全 风险 。 | 


F.24. pg_buffercache 


pg_buffercache 模块 提供 实时 检查 共享 缓存 内 发 生 了 什么 的 用 途 。 


该 模块 提供 一 个 C 函 数 pg_buffercache_pages , 3% B Kära, MEL-FAORAWR 
Ey pg_buffercache o 


缺 省 情况 下 取消 这 两 种 的 公共 访问 ， 以 防 隐 藏 的 安全 问题 。 
F.24.1. pg_buffercache 视图 


被 视图 暴露 的 字段 的 定义 显示 在 Table F-14 里 。 


Table F-14. pg_buffercache 字段 


名 字 类 型 引用 描述 
FS integer ID, 范围 为 1.. shared_buffers 
relfilenode oid pg_class.relfilenode 天 系 的 文件 
节点 号 
se 70 
reltablespace oid pg_tablespace.oid 关系 的 表 空 
间 OID 
reldatabase oid pg_database.oid 关系 的 数据 
库 OID 
relblocknumber bigint 关系 的 页 码 
N i= ~ 
relforknumber smallint 关系 的 分 支 编号 ; 参阅 
include/storage/relfilenode.h 
isdirty boolean 页 脏 了 吗 ? 
ed smallint 时 钟 下 摆 访 问 计数 


在 共享 缓存 中 每 个 缓冲 区 都 有 一 行 记录 。 未 使 用 的 缓冲 区 显示 为 所 有 字段 为 空 ， 除 
了 bufferid 。 共享 的 系统 目录 显示 为 属于 数据 库 需 。 


因为 缓存 被 所 有 数据 库 共 享 ， 通 常 有 几 页 的 关系 不 属于 当前 数据 库 。 这 意味 着 某 些 行 
在 pg_class 中 没有 匹配 的 连接 行 ， 或 者 甚至 有 不 正确 的 连接 。 如 果 你 党 试 连接 pg_class , 
限制 连接 到 的 行 的 reldatabase 等 于 当前 数据 库 的 OID 或 0 是 个 好 主意 。 


当 访 问 pg_buffercache 视图 时 ， 认 为 内 部 缓冲 区 锁 管 理 器 足够 长 ， 能 够 拷贝 视图 将 显示 的 所 
有 的 缓冲 区 状态 数据 。 这 保证 了 视图 产生 一 个 一 致 的 结果 集 ， 当 不 再 需要 阻塞 正常 的 缓冲 区 
活动 时 。 但 是 ， 如 果 频 繁 的 阅读 这 个 视图 ， 可 能 会 对 数据 库 性 能 造成 一 些 影响 。 


F.24.2. 示例 输出 


regression=# SELECT c.relname, count(*) AS buffers 
FROM pg_buffercache b INNER JOIN pg_class c 
ON b.relfilenode = pg_relation_filenode(c.oid) AND 
b.reldatabase IN (0, (SELECT oid FROM pg database 
WHERE datname = current_database())) 
GROUP BY c.relname 
ORDER BY 2 DESC 





LIMIT 10; 

relname | buffers 
eed yen a E ea man fd ys ee ef ey enn epee 
tenk2 | 345 
tenk1 | 141 
pg_proc | 46 
pg_class | 45 
pg_attribute | 43 
pg_class_relname_nsp_index | 30 
pg_proc_proname_args_nsp_index | 28 
pg_attribute_relid_attnam_index | 26 
pg_depend | 22 
pg_depend_reference_index | 20 
(10 rows) 
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F.25. pgcrypto 


pgcrypto {R łk 4 PostgreSQLt# KcryptographicH 


F.25.1. 一 般 散 列 函 数 
F.25.1.1. digest() 


digest(data text, type text) returns bytea 
digest(data bytea, type text) returns bytea 


计算 给 定 data 的 二 进 制 散 列 。 type 是 要 使 用 的 算法 。 标准 算法 是 md5 ， shail, sha224 , 
sha256 , sha384 和 sha512 o 如 果 pgcrypto 带 有 OpenSSL 建 立 ， 那 么 更 多 算法 可 用 ， 在 
Table F-18 中 详细 说 明 。 


如 果 你 希望 digest 作 为 一 个 十 六 进 制 字符 串 ， 那 么 在 结果 上 使 用 encode() 。 例如 : 


CREATE OR REPLACE FUNCTION shai(bytea) returns text AS $$ 
SELECT encode(digest($1, 'shai'), 'hex') 
$$ LANGUAGE SQL STRICT IMMUTABLE; 


F.25.1.2. hmac() 


hmac(data text, key text, type text) returns bytea 
hmac(data bytea, key text, type text) returns bytea 


为 带 有 键 key 的 data 计算 散 列 的 MAC。 type 和 在 digest() 中 相同 。 


类 似 于 digest() 但 是 散 列 只 能 在 知道 键 的 时 候 计 算 。 这 样 就 阻止 了 某 个 人 更 改 数据 并 改变 匹 
配 的 散 列 的 情况 。 


如 果 键 比 散 列 块 大 小 要 大 ， 那 么 将 首先 把 键 散 列 然后 散 列 的 结果 作为 键 使 用 。 


F.25.2. O PEU WX 

POX crypt() 和 gen_salt() 是 特别 为 散 列 口令 设计 的 。 crypt() 做 散 列 法 ， gen_salt() 为 
其 准备 算法 参数 。 

crypt() 中 的 算法 与 普通 散 列 算法 (如 MD5 或 SHA1) 有 以 下 方面 的 不 同 : 

1. 他们 的 速度 很 慢 。 因 为 数据 很 少 ， 所 以 这 是 唯一 的 让 蛮 力 破解 口 合 困 难 些 的 方法 。 


2. CHERAB, Masat, 所 以 有 相同 口令 的 用 户 将 会 有 不 同 加 密 了 的 口令 。 也 是 也 对 
反 向 算法 的 附加 防御 。 


3 它们 在 结果 中 包括 算法 类 型 ， 所 以 不 同 算法 的 口 今 散 列 可 以 共存 。 


4. 它们 中 的 一 些 是 自 适 点 的 ， 这 意味 着 当 计算 机 更 快速 时 ， 你 可 以 将 算法 调整 的 慢 一 些 ， 
而 不 会 引入 与 现 有 口令 的 不 相 容 。 


Table F-15 列 出 了 crypto 画 数 支持 的 算法 。 
Table F-15. crypt() 支持 的 算法 


算法 RAOS KE 自 适应 ? Salt 位 描述 

bf 72 yes 128 基于 Blowfish，2a 的 变 体 
md5 unlimited no 48 基于 MD5 加 密 

xdes 8 yes 24 扩展 的 DES 

des 8 no 12 原始 的 UNIX 加 密 


F.25.2.1. crypt() 


crypt(password text, salt text) returns text 


计算 一 个 password 的 crypt(3) 类 型 散 列 。 当 存 储 一 个 新 的 口令 时 ， 需要 使 用 gen_salt() 生成 
一 个 新 的 salt 值 。 要 检查 一 个 口令 ， 作 为 salt 传递 存储 的 散 列 值 ， 然后 检验 结果 是 否 
配 存储 的 值 。 


设置 一 个 新 的 口令 的 示例 : 


UPDATE ... SET pswhash = crypt('new password', gen_salt('md5')); 


认证 的 示例 : 


SELECT pswhash = crypt('entered password', pswhash) FROM ... ; 
如 果 输 入 的 口令 是 正确 的 这 个 就 返回 true o 


F.25.2.2. gen_salt() 


gen_salt(type text [, iter_count integer ]) returns text 


A crypto 的 使 用 生成 一 个 新 的 随机 salt 字 符 串 。 salt 字 符 串 也 告诉 crypt() 使 用 哪 种 算法 。 


type 参数 指定 散 列 算法 。 接受 的 类 型 有 : des , xdes , md5 和 bf o 


iter_count 参数 让 用 户 指定 重复 计数 ， 为 这 一 个 算法 。 计 数值 越 高 ， 拿 它 去 散 列 口令 的 次 数 
越 多 ， 因 此 解 开 它 的 次 数 也 越 多 。 尽 管 太 高 的 计数 来 计算 一 个 散 列 可 能 会 用 几 年 的 时 间 ， 这 
有 点 不 切实 际 。 如 果 省 略 了 iter_count BR, 那么 使 用 缺 省 的 重复 计数 。 iter_count 的 多 
许 值 取决 于 算法 ， 在 Table F-16 中 显示 。 


Table F-16. crypt() 的 重复 计数 
算法 Re 最 小 
xdes 725 1 16777215 
bf 6 4 31 


xil 
S 


对 于 xdes ， 这 里 有 一 个 附加 的 限制 ， 那 就 是 重复 计数 必须 是 奇数 。 


要 选择 一 个 合适 的 重复 计数 ， 考 虑 原始 的 DES 加 密 设计 是 要 在 那个 时 间 的 硬件 上 每 秒 有 4 个 散 
列 的 速度 。 比 4 个 散 列 每 秒 慢 的 可 能 会 降低 可 用 性 。 高 于 100 散 列 每 秒 的 可 能 太 快 了 。 


Table F-17 给 出 了 不 同 散 列 算法 的 相对 缓慢 的 概述 。 该 表 显 示 了 在 8 字符 口令 里 尝试 所 有 字符 
的 组 合 料 会 花费 多 长 时 间 ， 假 设 口令 只 包含 小 写字 母 ， 或 者 包含 大 小 写字 母 和 数字 。 
在 crypt-bf 记录 中 ， 斜 线 后 的 数字 是 gen_salt 的 iter_count BR, 


Table F-17. 散 列 算法 速度 


算法 散 列 /sec 对 于 [a-z] 对 于 [A-za-z0-9] 
crypt-bf/8 28 246 年 251322 年 
crypt-bf/7 5 121 82 26457 E 
crypt-bf/6 112 62 年 62831 年 
crypt-bf/5 211 Sees 3335 作 年 
crypt-md5 2681 2.6 年 2625 年 
crypt-des 362837 13s 19 年 
shal 590223 4 天 12 年 
mad5 2345086 ies 3 年 
注意 


。 使 用 的 这 个 机 器 是 1.5GHz Pentium 4。 


e crypt-des 和 crypt-md5 计算 的 数字 是 从 John the Ripper v1.6.38 -test 的 输出 获得 
的 。 


e md5 数字 来 自 mdcrack 1.2。 


e shat 数字 来 自 Icrack-20031130-beta。 


e crypt-bf 数字 使 用 一 个 简单 的 程序 获得 ， 这 个 程序 重复 超过 1000 次 8 字符 口 依 。 这 样 可 
以 显示 速度 和 不 同 数字 的 迭代 。 例 如 : john -test 显示 了 crypt-bt/5 的 213 次 循环 / 
秒 。 〈 结 果 中 非常 小 的 不 同 与 事实 一 致 ， pgcrypto 中 的 crypt-bf 实现 和 John the 
Ripper 中 使 用 的 是 同一 个 。 ) 


请 注意 ，" 尝 试 所 有 组 合 "是 不 现实 的 。 不 寻常 的 密码 破解 在 字典 的 帮助 下 完成 ， 包含 普通 的 
单词 和 它们 的 各 种 转变 。 所 以 ， 即 使 有 点 类 似 单 词 的 密码 可 能 比 上 述 建 议 的 数字 破解 的 更 
快 ， 而 一 个 6 字符 不 像 单 词 的 密码 可 能 避 开 破解 。 或 者 不 能 。 


F.25.3. PGP 加 密 功能 


该 功能 实现 了 部 分 OpenPGP (RFC 4880) 标 准 的 加 密 。 支 持 对 称 秘 钥 和 公共 秘 钥 的 加 密 。 
一 条 加 密 的 PGP 消 息 包含 2 个 部 分 ， 或 数据 包 : 

。 数据 包 包 含 一 个 会 话 秘 钥 一 加 密 了 的 对 称 秘 钥 或 者 是 公共 秘 钥 。 

。 数据 包 包含 带 有 会 话 秘 钥 的 加 密 数据 。 
当 带 有 对 称 秘 钥 〈 如 一 个 口令 ) 加 密 时 : 


1. 给 定 的 口令 使 用 String2Key (S2K) 算 法 散 列 。 这 和 crypt() 算法 很 相似 一 自觉 地 变 慢 并 
且 带 有 随机 salt 一 但 是 它 产生 一 个 全 长 的 二 进 制 秘 钥 。 


2， 如 果 需 要 一 个 单独 的 会 话 秘 铀 ， 将 会 产生 一 个 新 的 随机 秘 钥 。 否 则 将 直接 使 用 S2K 秘 钥 作 
为 会 话 秘 钥 。 


3 如果 直接 使 用 S2K 秘 钥 ， 那 么 只 有 S2K 设 置 将 被 放 和 人 到 会 话 秘 钥 包 。 否则 会 话 秘 钥 将 用 
S2K 秘 钥 加 密 然 后 放 入 会 话 秘 钥 包 。 


当 使 用 公共 秘 钥 加 密 时 : 

1. 将 会 产生 一 个 新 的 随机 会 话 秘 钥 。 

2.， 它 使 用 公共 密 钥 加 密 并 放 入 会 话 秘 钥 包 中 。 

两 种 情况 下 数据 被 加 密 的 处 理 如 下 : 

1. 可 选 的 数据 操作 : 压缩 ， 转 换 成 UTF-8， 和 /或 行 尾 的 转换 。 
2. 数据 带 有 一 块 随机 字 节 的 前 级 。 这 相当 于 使 用 一 个 随机 的 IV。 
3， 附 加 上 一 个 随机 前 级 和 数据 的 SHA1 散 列 。 

4. 所 有 这 些 都 带 有 会 话 秘 钥 加 密 ， 并 放 入 数据 包 中 。 


F.25.3.1. pgp _sym_encrypt() 


pgp_sym_encrypt(data text, psw text [, options text ]) returns bytea 
pgp_sym_encrypt_bytea(data bytea, psw text [, options text ]) returns bytea 


带 有 一 个 对 称 的 PGP 秘 钥 psw 加 密 data. options 参数 可 以 包含 选项 设置 ， 就 像 下 面 描述 
的 那样 。 


F.25.3.2. pgp_sym_decrypt() 


pgp_sym_decrypt(msg bytea, psw text [, options text ]) returns text 
pgp_sym_decrypt_bytea(msg bytea, psw text [, options text ]) returns bytea 


解密 一 个 对 称 秘 钥 加 密 的 PGP 信 息 。 


用 pgp_sym_decrypt 解密 bytea 数据 是 不 允许 的 。 这 是 为 了 避免 输出 不 合法 的 字符 数据 。 
用 pgp_sym_decrypt_bytea 解密 原始 的 文本 数据 是 可 以 的 。 


options 参数 可 以 包含 选项 设置 ， 就 像 下 面 描述 的 那样 。 


F.25.3.3. pgp_pub_encrypt() 


pgp_pub_encrypt(data text, key bytea [, options text ]) returns bytea 
pgp_pub_encrypt_bytea(data bytea, key bytea [, options text ]) returns bytea 


用 一 个 公共 的 PGP 秘 钥 key 加 密 data. 给 这 个 画 数 一 个 秘密 秘 钥 将 产生 一 个 错误 。 


options 参数 可 以 包含 选项 设置 ， 就 像 下 面 描述 的 那样 。 


F.25.3.4. pgp_pub_decrypt() 


pgp_pub_decrypt(msg bytea, key bytea [, psw text [, options text ]]) returns text 
pgp_pub_decrypt_bytea(msg bytea, key bytea [, psw text [, options text ]]) returns bytea 


ER 


解密 一 个 公共 密 钥 加 密 的 信息 。 key 必须 是 与 用 来 加 密 的 公共 秘 钥 对 应 的 秘密 秘 钥 。 如 果 该 
秘密 秘 钥 是 密码 保护 的 ， 你 必须 在 psw 中 给 出 密码 。 如 果 没 有 密码 ， 但 是 你 希望 指定 选项 ， 
你 需要 给 出 一 个 空 的 密码 。 


用 pgp_pub_decrypt 解密 bytea 数据 是 不 允许 的 。 这 是 为 了 避免 输出 不 合法 的 字符 数据 。 
用 pgp_pub_decrypt_bytea 解密 原始 的 文本 数据 是 可 以 的 。 


options 参数 可 以 包含 选项 设置 ， 就 像 下 面 描述 的 那样 。 


F.25.3.5. pgp _key_id() 


pgp_key_id(bytea) returns text 
pgp_key_id 摘 取 一 个 PGP 公 共 或 秘密 秘 钥 的 秘 钥 ID。 或 如 果 给 出 一 个 加 密 的 信息 ， 它 给 出 
用 于 加 密 数 据 的 秘 钥 ID. 
它 可 以 返回 两 个 特殊 的 秘 钥 ID : 
© SYMKEY 
该 信息 是 用 对 称 秘 钥 加 密 的 。 
© ANYKEY 


该 信息 是 公共 秘 钥 加 密 的 ， 但 是 秘 钥 ID 已 经 删除 了 。 这 意味 着 你 将 要 尝试 所 有 你 的 秘密 
秘 钥 ， 看 看 哪个 能 解密 它 。 pgcrypto 本 身 并 不 产生 这 样 的 信息 。 


请 注意 ， 不 同 的 秘 钥 可 能 有 相同 的 ID。 这 是 稀少 的 ， 但 是 是 一 个 普通 事件 。 然后 客户 端 应 用 
应 该 党 试 解密 每 一 个 ， 看 看 哪个 合适 一 类 似 义理 ANYKkEY o 


F.25.3.6. armor() , dearmor() 


armor(data bytea) returns text 
dearmor(data text) returns bytea 


这 些 功 能 打包 / 解 包 二 进 制 数据 到 PGP ASCll-armortg§xt, 这 些 基本 上 是 带 有 CRC 的 Base64 
和 额外 的 格式 。 


F.25.3.7. PGP 功 能 的 选项 
选项 的 命名 类 似 于 GnuPG。 选 项 的 值 应 该 在 等 号 后 面 给 出 ; 选项 之 间 用 到 号 隔 开 。 例 如 : 


pgp_sym_encrypt(data, psw, 'compress-algo=1, cipher-algo=aes256' ) 


除了 convert-crlf 之 外 的 所 有 选项 只 应 用 到 加 密 函 数 。 解密 函数 从 PGP 数 据 中 获得 参数 。 


最 有 趣 的 选项 可 能 就 是 compress-algo 和 unicode-mode JS. 其 余 的 应 该 有 合理 的 默认 值 。 


F.25.3.7.1. cipher-algo 
要 使 用 的 密码 算法 。 


值 : bf, aes128, aes192, aes256 (OpenSSL-only: sdes ，cast5 ) 缺 省 : aes128 适用 于 : 
pgp_sym_encrypt, pgp_pub_encrypt 


F.25.3.7.2. compress-algo 
要 使 用 的 压缩 算法 。 只 有 PostgreSQL 带 有 zlib 建 立时 可 以 使 用 。 


值 : 0 - 没有 压缩 1-ZIP 压缩 2-ZLIB 压缩 (= ZIP 加 上 元 数据 和 块 CRCs) RA: 0 适用 于 : 
pgp_sym_encrypt, pgp_pub_encrypt 


44: 0, 1-9 ERA: 6 适用 于 : pgp _sym_encrypt, pgp_pub_ encrypt 


F.25.3.7.4. 转换 crlf 


MB SAM \n 转换 为 \r\n MAB SAH \r\n 转换 为 \n o RFC 4880 指 定 文 本 数 
据 应 该 使 用 \r\n 换行 存储 。 使 用 这 个 获得 全 部 的 RFC 兼 容 性 能 。 


值 : 0, 1 RA: 0 适用 于 : pgp_sym_encrypt, pgp_pub_encrypt, pgp_sym_decrypt, 
pgp_pub_ decrypt 


F.25.3.7.5. 禁用 mdc 


不 要 用 SHA-1 保 护 数据 。 唯 一 使 用 这 个 选项 的 理由 是 为 了 实现 与 古老 的 PGP 产 品 的 兼容 ， 该 
产品 早 于 SHA-1 受 保护 的 包 添 加 到 RFC 4880。 最 近 的 gnupg.org 和 pgp.com 软 件 也 很 好 的 支持 


它 。 
值 : 0, 1 RA: 0 适用 于 : pgp_sym_encrypt, pgp_pub_encrypt 


F.25.3.7.6. 启用 会 话 秘 钥 


使 用 单独 的 会 话 秘 钥 。 公 共 秘 钥 加 密 总 是 使 用 一 个 单独 的 会 话 秘 钥 ; 这 是 为 了 对 称 秘 钥 加 
密 ， 这 在 默认 情况 下 是 直接 使 用 S2K 秘 钥 的 。 


值 : 0, 1 RA: 0 适用 于 : pgp_sym_encrypt 
F.25.3.7.7. s2k 模式 
使 用 S2K 算 法 。 


值 : 0 - 没有 salt。 危险 的 ! 1 - 有 salt 但 是 带 有 固定 的 重复 计数 。 3 - 变量 重复 计数 。 缺 省 : 3 适 
用 于 : pgp_sym_encrypt 


F.25.3.7.8. s2k 摘要 算法 
在 S2K 计 算 中 使 用 哪个 摘要 算法 。 


值 : md5, sha1 缺 省 : sha1 适用 于 : pgp_sym_encrypt 


F.25.3.7.9. s2k 密码 算法 
加 密 单 独 的 会 话 秘 钥 使 用 哪个 密码 。 


值 : bf, aes, aes128, aes192, aes256 ik: use cipher-algo 适用 于 : pgp_sym_encrypt 


F.25.3.7.10. unicode 模式 


是 否 要 转换 文本 数据 从 数据 库 内 部 编码 到 UTF-8 及 以 前 。 如 果 你 的 数据 库 已 经 是 UTF-8， 将 
不 需要 转换 ， 但 是 消息 将 被 标记 为 UTF-8。 没 有 这 个 选项 将 不 会 这 样 。 


值 : 0, 1 RA: 0 适用 于 : pgp_sym_encrypt, pgp_pub_encrypt 
F.25.3.8. 用 GnuPG 产生 PGP 秘 铀 
要 生成 一 个 新 的 秘 钥 : 

gpg --gen-key 


首选 的 秘 钥 类 型 是 "DSA and Elgamal"。 


对 于 RSA 加 密 ， 你 必须 创建 DSA 或 RSA 唯 一 签署 秘 钥 作为 主 秘 钥 ， 然 后 用 gpg --edit-key 添 
加 一 个 RSA 加 密 子 秘 钥 。 


要 列 出 秘 钥 : 


gpg --list-secret-keys 


以 ASCII-armor 格 式 导 出 一 个 公共 秘 钥 : 


gpg -a --export KEYID > public.key 


以 ASCll-armor 格 式 导 出 一 个 秘密 秘 钥 : 


gpg -a --export-secret-keys KEYID > secret.key 


在 将 它们 送 给 PGP 辑 数 之 前 需要 在 这 些 秘 钥 上 使 用 dearmor() 。 或 者 如 果 你 可 以 处 理 二 进 制 
数据 ， 你 可 以 从 命令 行 中 删除 -a o 


要 获取 更 多 详细 信息 ， 请 参阅 man gpg, The GNU Privacy Handbook 和 其 他 
http://www.gnupg.org 上 的 文档 。 


F.25.3.9. PGP 代码 的 限制 


。 不 支持 签名 。 这 也 意味 着 不 检查 加 密 子 秘 钥 是 否 属于 主 秘 钥 。 
。 不 支持 加 密 秘 钥 作为 主 秘 钥 。 因 为 通常 不 建议 这 样 的 做 法 ， 这 应 该 不 是 一 个 问题 。 


。 不 支持 几 个 子 秘 钥 。 这 可 能 看 起 来 像 是 一 个 问题 ， 因 为 这 是 习惯 的 做 法 。 另 一 方面 ， 不 
应 该 使 用 带 有 pgcrypto 的 定期 GPG/PGP 秘 钥 ， 而 是 创建 一 个 新 的 秘 钥 ， 因为 使 用 场景 
相当 不 同 。 


F.25.4. 行 加 密 功 能 


这 些 功 能 在 数据 上 只 运行 一 个 密码 ; 它们 没有 任何 比 PGP 加 密 更 先进 的 特性 。 因此 它们 有 一 
些 主要 的 问题 : 

1. 它们 使 用 用 户 秘 钥 直 接 作 为 加 密 秘 钥 。 

2. 它们 不 提供 任何 完整 性 检查 ， 来 看 看 加 密 的 数据 是 否 被 修改 了 。 

3， 它 们 希望 用 户 自己 管理 所 有 加 密 参 数 ， 即 使 是 IV。 

4， 它 们 不 处 理 文 本 。 


所 以 ， 随 着 PGP 加 密 的 引入 ， 不 建议 使 用 行 加 密 功能 


encrypt(data bytea, key bytea, type text) returns bytea 
decrypt(data bytea, key bytea, type text) returns bytea 


encrypt_iv(data bytea, key bytea, iv bytea, type text) returns bytea 
decrypt_iv(data bytea, key bytea, iv bytea, type text) returns bytea 


加 密 / 解 密 数 据 使 用 type 指定 的 加 密 方 法 。 type 字符 串 的 语法 是 : 


_algorithm_ [ `-` ~_mode_~ ] [ /pad:. ~_padding_~ ] 


而 _algorithm 是 下 列 之 一 : 
e bf — Blowfish 
e aes — AES (Rijndael-128) 
_mode_ 是 下 列 之 一 : 
e cbc 一 下 一 个 块 取决 于 前 一 个 块 缺 省 ) 
e ech — 每 个 块 单独 加 密 (只 为 了 测试 ) 
_padding_ 是 下 列 之 一 : 
e pkcs 一 数据 可 以 是 任意 长 度 (RA) 


e none — 数据 必须 是 加 密 块 尺寸 的 几 倍 
所 以 ， 例 如 ， 这 些 是 相等 的 : 


encrypt(data, 'fooz', 'bf') 
encrypt(data, 'fooz', 'bf-cbc/pad:pkcs') 


在 encrypt_iv 和 decrypt_iv 中 ， 工 V 参数 是 CBC 模 式 的 初始 值 ; 在 ECB 中 忽略 。 如 果 不 正 
好 是 块 的 大 小 则 截断 或 用 0 补 齐 。 在 没有 这 个 参数 的 函数 里 缺 省 全 部 为 0。 


F.25.5. 随机 数据 函数 


gen_random_bytes(count integer) returns bytea 


密码 强 随机 字 节 的 返回 count 。 一 次 最 多 可 以 提取 1024 个 字 节 。 这 是 为 了 避免 排 干 随机 发 生 
器 池 。 


F.25.6. 注意 


F.25.6.1. 配置 


pgcrypto 根据 主 PostgreSQL configure 脚本 的 调查 结果 配置 它 本 身 。 影响 它 的 选项 


是 --with-zlib 和 --with-openssl o 
当 用 zlib 编 译 时 ，PGP 加 密 函 数 可 以 在 加 密 之 前 压缩 数据 。 


当 用 OpenSSL 编 译 时 ， 有 更 多 算法 可 用 。 公 共 秘 钥 加 密 函 数 也 会 更 快 ， 因为 OpenSSL 有 更 
多 优化 了 的 BIGNUM 郴 数 。 


Table F-18. 带 有 和 不 带 有 OpenSSL 的 功能 性 总 结 


功能 性 内 建 带 有 OpenSSL 


MD5 yes yes 
SHA1 yes yes 
SHA224/256/384/512 yes yes (注意 1) 
其 他 摘要 算法 no yes (注意 2) 
Blowfish yes yes 
AES yes yes (注意 3) 
DES/3DES/CAST5 no yes 
行 加 密 yes yes 
PGP 对 称 加 密 yes yes 
PGP 公共 秘 钥 加 密 yes yes 


Vo ag — A 
ES: 


1. SHA2 算 法 在 版 本 0.9.8 的 时 候 添 加 到 了 OpenSSL。 对 于 更 老 的 版 本 ， pgcrypto 使 用 内 
建 的 代码 。 


2. 任何 OpenSSL 支 持 的 摘要 算法 是 自动 获得 的 。 这 对 于 密码 来 说 是 不 可 能 的 ， 密 码 需要 明 
确 的 支持 。 


3，AES 自 版 本 0.9.7 以 来 包含 在 OpenSSL 中 了 。 对 于 更 老 的 版 本 ， pgcrypto 使 用 内 建 的 代 
码 。 


F.25.6.2. NULL 义理 


就 像 SQL 中 的 标准 ， 如 果 任 一 参数 是 NULL， 那 么 所 有 函数 都 返回 NULL。 这 在 粗心 的 使 用 中 
可 能 会 造成 安全 风险 。 


F.25.6.3. 安全 限制 


所 有 pgcrypto 汞 数 在 数据 库 服务 器 内 部 运行 。 这 意味 着 pgcrypto 和 客户 端 应 用 之 间 的 所 有 
数据 和 口令 移动 都 是 以 明文 的 形式 。 因 此 必须 : 


1. 本 地 连接 或 使 用 SSL 连 接 。 
2. 同时 信任 系统 和 数据 库 管理 员 。 
如 果 你 做 不 到 ， 那 么 最 好 在 客户 端 应 用 内 部 做 crypto。 


F.25.6.4. 有 用 的 阅读 


| 


PostgreSQL 中 文 文档 9.3 





e http://www.gnupg.org/gph/en/manual.html 
GNU 隐私 手册 。 
e http://www.openwall.com/crypt/ 
crypt-blowfish 算 法 描述 。 
e http://www.stack.nl/~galactus/remailers/passphrase-faq.html 
如 何 选择 一 个 好 的 密码 。 
e http://world.std.com/~reinhold/diceware.html 
选择 密码 的 有 趣 想法 。 
e http://www.interhack.net/people/cmcurtin/snake-oil-faq.html 


描述 密码 学 的 优 劣 。 


F.25.6.5. 技术 参考 文献 


e http://www.ietf.org/rfc/rfc4880.txt 
OpenPGP 消息 格式 。 

e http://www.ietf.org/rfc/rfc1321.txt 
MD5 消息 摘要 算法 。 

e http://www.ietf.org/rfc/rfc2104.txt 
HMAC: 散 列 的 消息 认证 。 

e http://www.usenix.org/events/usenix99/provos.html 
crypt-des、crypt-md5 和 bcrypt 算 法 的 比较 。 

e http://csrc.nist.gov/cryptval/des.htm 
DES、3DES 和 AES 标 准 。 

e http://en.wikipedia.org/wiki/Fortuna_(PRNG)) 
Fortuna CSPRNG 的 描述 。 

e http://jlcooke.ca/random/ 
基于 Jean-Luc Cooke Fortuna 的 Linux /dev/random 了 驱动器。 


e http://research.cyber.ee/~lipmaa/crypto/ 


F.25. pgcrypto 3269 


密码 学 指针 集合 。 


F.25.7. 作者 


Marko Kreen ait; [markokr@gmail.com](mailto:markokr@gmail.com)&gt; 


pgcrypto 使 用 来 自 下 列 源码 的 代码 : 


算法 作者 起 源 
DES 加 密 David Burren 和 其 他 人 FreeBSD libcrypt 
MD5 加 密 Poul-Henning Kamp FreeBSD libcrypt 
Blowfish 加 密 Solar Designer www.openwall.com 
Blowfish 密码 Simon Tatham PuTTY 
Rijndael 密码 Brian Gladman OpenBSD sys/crypto 
MD5 和 SHA1 WIDE Project KAME kame/sys/crypto 
SHA256/384/512 Aaron D. Gifford OpenBSD sys/crypto 


BIGNUM math Michael J. Fromberger dartmouth.edu/~sting/sw/imath 


F.26. pg_freespacemap 


pg_freespacemap 模块 提供 一 种 检查 自由 空间 映射 (FSM) 的 手段 。 它 提供 一 个 名 
为 pg_freespace 的 函数 ， 或 精确 的 说 是 两 个 重 载 本 数 。 该 函数 在 一 个 给 定 的 页 面 或 关系 中 的 
所 有 页 面 的 自由 空间 映射 内 显示 记录 的 值 。 


缺 省 的 公共 访问 在 该 画 数 中 取消 了 ， 只 是 因为 潜藏 的 安全 问题 。 


F.26.1. WAX 


pg_freespace(rel regclass IN, blkno bigint IN) returns int2 
返回 关系 的 页 面 上 的 自由 空间 的 数量 ， 通 过 plkno 指定 ， 根 据 FSM。 
pg_freespace(rel regclass IN, blkno OUT bigint, avail OUT int2) 


在 关系 的 每 个 页 面 上 显示 自 由 空间 的 数量 ， 根据 FSM。 返回 一 组 (blkno bigint, avail int2) 
元 组 ， 在 关系 中 每 个 页 面 一 个 元 组 。 


存储 在 自由 空间 映射 中 的 数据 是 不 精确 的 。 它 们 圆 整 到 1/256 的 BLcksz 〈 缺 省 32 字 节 ) 的 精 
度 ， 并 且 它 们 不 保持 全 部 的 元 组 是 最 新 的 (插入 了 和 更 新 了 ) 。 


对 于 索引 ， 跟 踪 的 是 完全 未 使 用 的 页 面 ， 而 不 是 页 面 中 的 自由 空间 。 因 此 ， 该 值 是 没有 意义 


的 ， 只 表示 一 个 页 面 是 否 为 空 。 


Note: 接口 在 版 本 8.4 中 改变 了 ， 为 了 反映 在 相同 版 本 中 引进 的 新 的 FSM 实 现 。 





F.26.2. 示例 输出 


postgres=# SELECT * FROM pg_freespace('foo'); 
blkno | avail 


9 | 0 
aL || 0 
2 | 0 
3 | 32 
4 | 704 
5 | 704 
6 | 704 
7 | 1216 
8 | 704 
9 | 704 
10 | 704 
11 | 704 
12 | 704 
13 | 704 
14 | 704 
15 | 704 
16 | 704 
17 | 704 
18 | 704 
19 | 3648 
(20 rows) 


postgres=# SELECT * FROM pg_freespace('foo', 7); 
pg_freespace 


F.26.3. 作者 


Mark Kirkwood a&1t;[markir@paradise.net.nz](mailto:markir@paradise.net.nz)agt; 制作 的 原 
始 版 本 。 在 版 本 8.4 中 重 写 ， 以 适应 Heikki Linnakangas 
&1t; [heikki@enterprisedb.com](mailto:heikki@enterprisedb.com)&gt; 制作 的 新 的 FSM 实 现 。 


F.27. pgrowlocks 


pgrowlocks 模块 提供 一 个 显示 指定 的 表 的 行 锁定 信息 的 函数 。 


F.27.1. 概述 


pgrowlocks(text) returns setof record 


该 参数 是 一 个 表 的 名 字 。 结 果 是 一 组 记录 ， 一 行 代表 表 中 的 一 个 锁定 的 行 。 输出 字段 在 Table 
F-19 中 显示 。 


Table F-19. pgrowlocks 输出 字段 


locked_row tid 锁定 的 行 的 元 组 ID (TID) 
locker xid 锁定 的 事务 ID， 或 如 果 是 多 事务 则 为 multixact ID 
multi boolean 如 果 锁 定 的 是 多 事务 则 为 真 
xids xid[] 锁定 的 事务 ID( 如 果 有 多 个 事务 则 为 多 个 ) 
锁定 的 锁 模 式 (如 果 有 多 个 事务 则 为 多 个 )， 一 些 
lock_type text[] Key Share, Share, For No Key Update , 
No Key Update , For Update , Update o 
pids integer[] 锁定 后 端的 过 程 ID (如 果 有 多 个 事务 则 为 多 个 ) 


pgrowlocks 将 AccessShareLock 作为 目标 表 ， 并 且 一 行 一 行 的 读 取 行 以 采集 行 锁 的 信息 。 这 
对 于 大 表 来 说 不 是 非常 快 。 请 注意 ; 


1， 如 果 表 作为 一 个 整体 是 被 他 人 排他 锁 的 ， 那 么 pgrowlocks 将 被 阻塞 。 


2. pgrowlocks 不 保证 生成 一 个 自我 一 致 的 快照 。 在 执行 期 间 ， 获 得 一 个 新 的 行 锁 或 释放 一 
个 旧 锁 都 是 可 能 的 。 


pgrowlocks 并 不 显示 锁定 的 行 的 内 容 。 如 果 你 希望 同一 时 间 查看 行 的 内 容 ， 你 可 以 像 下 面 这 
样 做 : 


SELECT * FROM accounts AS a, pgrowlocks('accounts') AS p 
WHERE p.locked_row = a.ctid; 


不 论 如 何 都 要 小 心 ( 自 PostgreSQL 8.3 起 )， 这 样 一 个 查询 将 会 是 非常 低 效 率 的 。 


F.27.2. 示例 输出 


test=# SELECT * FROM pgrowlocks('t1'); 


(0,1) | Shared | 

(0,2) | Shared | 

(0,3) | Exclusive | 

(0,4) | Exclusive | 
(4 rows) 


F.27.3. 作者 


Tatsuo Ishii 


| xids | pids 
(eae Se Ses a= 0 
| {804,805} | {29066, 29068} 
| {804,805} | {29066, 29068} 
| {804} | {29066} 

| {804} | {29066} 


F.28. pg stat_statements 


pg_stat_statements 模块 提供 一 种 跟踪 执行 统计 服 务 器 执行 的 所 有 SQL 语句 的 手段 。 


该 模块 必须 通过 在 postgresql.conf 中 添加 pg_stat_statements 到 shared_preload libraries 来 
加 载 ， 因 为 它 需 要 额外 的 共享 内 存 。 这 意味 着 添加 或 删除 这 个 模块 都 需要 重启 服务 器 。 


F.28.1. pg_stat_statements 视图 


该 模块 聚集 的 统计 通过 一 个 名 为 pg_stat_statements 的 系统 视图 使 其 可 用 。 这 个 模块 为 每 个 
不 同 的 查询 、 数 据 库 ID 和 用 户 ID (取决 于 该 模块 可 以 追踪 的 不 同 语句 的 最 大 值 ) 包含 一 行 。 
视图 的 字段 显示 在 Table F-20 中 。 


Table F-20. pg_stat_statements 字段 


userid 


dbid 


query 


calls 


total_time 


rows 


shared_blks_hit 


shared_blks_read 
shared_blks_dirtied 


shared_blks_written 


local_blks_hit 


local_blks_read 
local_blks_dirtied 
local_blks_written 
temp_blks_read 


temp_blks_written 


blk_read_time 


blk_write_time 


类 型 
oid 
oid 
text 
bigint 


double precision 


bigint 


bigint 


bigint 


bigint 


bigint 


bigint 


bigint 


bigint 


bigint 


bigint 


bigint 


double precision 


double precision 


pg_authid .oid 


pg_database .Oid 


有 代表 性 的 语句 的 文本 (Bid 


track_activity_query_size = 
节 ) 


执行 的 次 数 


该 语句 花费 的 总 时 间 ， 以 毫 
秒 计 


该 语句 恢复 或 影响 的 行 的 总 
数 

该 语句 命中 的 共享 块 缓存 的 
总 数 

该 语句 读 取 的 共享 块 的 总 数 
该 语句 弄 脏 的 共享 块 的 总 数 
该 语句 写 入 的 共享 块 的 总 数 


该 语句 命中 的 本 地 块 缓存 的 
总 数 


该 语句 读 取 的 本 地 块 的 总 数 
该 语句 弄 脏 的 本 地 块 的 总 数 
该 语句 宇和 的 本 地 块 的 总 数 
该 语句 读 取 的 临时 块 的 总 数 
该 语句 写 和 人 的 临时 块 的 总 数 
该 语句 读 取 块 花费 的 总 时 

间 ， 以 毫秒 计 GIR BAT 
track_io_timing, 440) 
该 语句 写 入 块 花费 的 总 时 


间 ， 以 毫秒 计 GIR BAT 
track_io_timing, 440) 


描述 


执行 该 
语句 的 
用 户 的 
OID 


执行 该 
语句 的 
AUE 
的 OID 


这 个 视图 和 西数 pg_stat_statements_reset ， 只 有 在 通过 安装 pg_stat_statements 扩展 特别 


安装 到 的 数据 库 中 可 用 。 不 过 ， 当 pg_stat_statements 模块 加 载 到 服务 器 中 时 ， 
服务 器 中 的 所 有 数据 库 ， 不 管 该 视图 是 否 存 在 。 


统计 跟踪 该 


为 了 安全 起 见 ， 不 允许 非 超级 用 户 查 看 其 它 用 户 执行 的 查询 的 文本 。 不 过 ， 如 果 视 图 已 经 安 
装 到 他 们 的 数据 库 中 ， 那 么 他 们 可 以 看 到 统计 。 

可 计划 的 查询 (也 就 是 ， sELECT ，INSERT ，UPDATE , 和 DELETE ) 组 合成 为 一 

个 pg_stat_statements, 当 它 们 根据 一 个 内 部 哈 希 计 算 有 相同 的 查询 结构 时 。 典 型 的 ， 如 果 
两 个 查询 语义 上 相等 ， 除了 查询 中 字面 常量 的 值 之 外 ， 我 们 认为 这 两 个 查询 相同 。 工 具 命 命 
(也 就 是 ， 所 有 其 他 命令 ) 是 直接 基于 它们 的 文本 查询 字符 串 比 较 的 。 

当 一 个 常量 的 值 为 了 匹配 其 他 查询 而 忽略 时 ， 该 常量 在 pg_stat_statements 的 显示 中 被 ? 蔡 
代 。 查 询 文 本 的 剩余 部 分 是 第 一 个 查询 特定 散 列 值 与 pg_stat_statements 相关 条 目 。 

在 一 些 情况 下 ， 带 有 明显 不 同文 本 的 查询 可 能 合并 到 一 个 pg_stat_statements 。 通常 这 只 在 
语义 相等 的 查询 上 发 生 ， 但 是 有 很 小 的 可 能 哈 希 冲突 导致 不 相关 的 查询 被 合并 到 一 个 条 目 。 
(不 过 ， 这 对 于 属于 不 同 用 户 或 数据 库 的 查询 来 说 是 不 会 发 生 的 。) 

因为 哈 希 值 是 基于 分 析 查 询 的 表示 法 之 后 来 计算 的 ， 相 反 的 也 是 可 能 的 : 带 有 相同 文本 的 查 
询 可 能 表现 为 单独 的 条 目 ， 如 果 它 们 因为 一 个 因素 的 结果 有 不 同 的 含义 ， 比如 不 同 


的 search_path 设置 。 


F.28.2. HR 
pg_stat_statements_reset() returns void 


pg_stat_statements_reset 抛 奔 所 有 pg_stat_statements 到 目前 为 止 收 集 的 统计 。 缺 省 的 ， 
这 个 函数 只 能 被 超级 用 户 执行 。 


F.28.3. 配置 参数 


pg_stat_statements.max ( integer ) 


pg_stat_statements.max 是 该 模块 追踪 语句 的 最 大 值 (也 就 是 ， pg_stat_statements 视图 中 
的 最 大 行 数 ) 。 如 果 观 察 了 上 比 这 更 多 的 不 同 的 语句 ， 则 会 抛弃 执行 最 少 的 语句 的 信息 。 RA 
值 是 1000。 这 个 参数 只 能 在 服务 器 启动 时 设置 。 


pg_stat_statements. track ( enum ) 


pg_stat_statements.track 控制 哪个 语句 可 以 被 该 模块 计数 。 声明 top 来 跟踪 顶级 的 语句 
(直接 通过 客户 端 发 出 的 语句 ) 。 all 也 跟踪 蔡 套 的 语句 (上 比如 包含 在 画 数 中 的 语句 ) , 
或 none 茶 用 语句 状态 收集 。 TRAE top 。 只 有 超级 用 户 可 以 更 改 这 个 设置 。 
pg_stat_statements.track_utility ( boolean ) 

pg_stat_statements.track_utility 控制 该 模块 是 否 追 踪 工具 命 命 。 工具 命令 是 除了 SELECT , 
INSERT , UPDATE 和 DELETE 的 所 有 命令 。 缺 省 值 是 on 。 只 有 超级 用 户 可 以 更 改 这 个 设置 。 


pg_stat_statements.save ( boolean ) 


pg_stat_statements.save 指定 在 服务 器 关闭 时 是 否 保存 语句 状态 。 


如 果 是 off ， 那 么 在 服务 


器 关闭 时 不 保存 状态 ， 在 服务 器 启动 时 也 不 重新 加 载 。 缺 省 值 是 on 。 这 个 参数 只 可 以 


在 postgresql.conf 文件 中 或 者 服务 器 命令 行 中 设置 。 


该 模块 需要 额外 的 共享 内 存 总 计 大 约 为 pg_stat_statements.max * 
这 个 内 存在 该 模块 加 载 时 被 消耗 ， 即 


使 pg_stat_statements.track 设置 为 none o 


track_activity_ query_size 字 节 。 请 注意 ， 


这 些 参数 必须 在 postgresql.conf 中 设置 。 典 型 的 用 法 是 : 


# postgresql.conf 


shared_preload_libraries = 'pg_stat_statements' 
pg_stat_statements.max = 10000 
pg_stat_statements.track = all 


F.28.4. 示例 输出 


bench=# SELECT pg_stat_statements_reset(); 


$ pgbench -i bench 
$ pgbench -c10 -t300 bench 


bench=# \x 


bench=# SELECT query, calls, total_time, 


rows, 100.0 * shared_blks_hit / 
nullif(shared_blks_hit + shared_blks_read, ©) AS hit_percent 


FROM pg_stat_statements ORDER BY total_time DESC LIMIT 5; 


PERECORDA II e n 
query UPDATE pgbench_branches SET bbalance = bbalance + ? WHERE bid = ?; 
calls 3000 


total_time 
rows 
hit_percent 


9609 . 00100000002 
2836 
99.9778970000200936 


REGORD E200 cocenesearensencsreoneresessscssenosesssnssseocas 
query | UPDATE pgbench_tellers SET tbalance = tbalance + ? WHERE tid = ?; 
calls | 3000 
total_time | 8015.156 
rows | 2990 
hit_percent | 99.9731126579631345 
RECORDES3 | eE 
query | copy pgbench_accounts from stdin 
calls | a 
total_time | 310.624 
rows | 100000 
hit_percent | 0.30395136778115501520 
all RECON) 4) | some osososesssreeeasade 
query | UPDATE pgbench_accounts SET abalance = abalance + ? WHERE aid = ?; 
calls | 3000 
total_time | 271.741999999997 
rows | 3000 
hit_percent | 93.7968855088209426 
NRECORDES EE ee 
query | alter table pgbench_accounts add primary key (aid) 
calls | a 
total_time | 81.42 
rows | © 
| 


hit_percent 


34.4947735191637631 


F.28.5. 作者 


Takahiro Itagaki 
&lt; [itagaki.takahiro@oss.ntt.co.jp](mailto:itagaki.takahiro@oss.ntt.co.jp)&gt; o Peter 


Geoghegan alt; [peter@2ndquadrant .com](mailto:peter@2ndquadrant.com)agt; 添加 了 查询 正常 


化 。 


F.29. pgstattuple 
pgstattuple 模块 提供 tS AP Bg 数 以 获得 元 组 级 别 的 状态 。 


F.29.1. WAX 


pgstattuple(text) returns record 


pgstattuple 7% WR 一 个 关系 的 实际 长 度 ， "JERS" 元 组 的 百分比 ， AE 其 他 信息 。 这 帮助 用 户 确定 
one 该 参数 是 目标 关系 的 名 字 (可 以 有 模式 限定 ) 。 例 如 : 


test=&gt; SELECT * FROM pgstattuple('pg_catalog.pg_proc'); 


-[ RECORD 1 ]------ flee bee 
table_len | 458752 
tuple_count | 1470 
tuple_len | 438896 
tuple_percent | 95.67 
dead_tuple_count | alt 
dead_tuple_len | 3157 
dead_tuple_percent | 0.69 
free_space | 8932 
free_percent | 1.95 


输出 字段 在 Table F-21 中 描述 。 


Table F-21. pgstattuple 输出 字段 





字段 类 型 描述 
table_len bigint 实际 关系 长 度 以 字 节 计 
tuple_count bigint 活 的 元 组 的 数量 
tuple_len bigint 活 的 元 组 的 总 长 度 ， 以 字 节 计 
tuple_percent floats 活 的 元 组 的 百分比 
dead_tuple_count bigint 死 的 元 组 的 数量 
dead_tuple_len bigint 和 死 的 元 组 的 总 长 度 ， 以 字 节 计 
dead_tuple_percent floats 死 的 元 组 的 百分比 
free_space bigint 总 的 空闲 空间 ， 以 字 节 计 
free_percent float8 空闲 空间 的 百分比 


pgstattuple 只 获取 关系 中 的 读 锁 。 所 以 结果 并 不 反映 一 个 瞬间 的 快照 ;并 发 的 更 新 将 影响 


它们 。 


如 果 HeapTupleSatisfiesNow 返回 假 ， 那么 pgstattuple 判断 一 个 元 组 是 否 是 " 死 的 "。 


pgstattuple(oid) returns record 


这 和 pgstattuple(text) 一 样 ， 除 了 目标 关系 是 通过 OID 指 定之 外 。 


pgstatindex(text) returns record 
pgstatindex 返回 一 个 显示 关于 B-tree 索 引信 息 的 记录 。 例如 : 


test=&gt; SELECT * FROM pgstatindex('pg_cast_oid_index'); 


-[ RECORD 1 ]------ ee ee 
version [E2 
tree_level | 9 
index_size | 8192 
root_block_no at 
internal_pages | © 
leaf_pages et 
empty_pages | © 
deleted_pages | © 
avg_leaf_density | 50.27 
leaf_fragmentation | 0 

输出 字段 是 : 

字段 类 型 描述 

version integer B-tree 版 本 号 
tree_level integer 根 页 面 的 树 级 别 
index_size bigint 索引 中 页 面 的 总 数量 
root_block_no bigint 根 块 的 位 置 
internal_pages bigint "internal" (上 一 级 ) 页 面 的 数量 
leaf_pages bigint 叶子 页 面 的 数量 
empty_pages bigint 空白 页 面 的 数量 
deleted_pages bigint 已 删除 页 面 的 数量 
avg_leaf_density floats 叶子 页 面 的 平均 密度 
leaf_fragmentation floats 叶子 页 面 碎片 


与 pgstattuple 一 样 ， 结 果 是 一 页 一 页 的 累积 的 ， 不 应 该 期 望 代表 整个 索引 的 一 个 瞬间 快 


JNO 


pgstatginindex(regclass) returns record 
pgstatginindex 返回 一 个 显示 关于 GIN 索 引信 息 的 记录 。 例 如 : 


test=&gt; SELECT * FROM pgstatginindex('test_gin_index'); 
-[ RECORD 1 ]--+-- 
version | eat 
pending_pages | 0 
pending_tuples | 0 


输出 字段 是 : 


字段 类 型 
version integer 
pending_pages integer 
pending_tuples bigint 


pg_relpages(text) returns bigint 


pg_relpages 返回 关系 中 页 面 的 数量 。 


F.29.2. 作者 


Tatsuo Ishii 和 Satoshi Nagayasu 


描述 
GIN 版 本 号 
等 待 列 表 中 页 面 的 数量 
等 待 列 表 中 元 组 的 数量 


F.30. pg_trgm 


pg_trgm F RRRA RFT EFAS RABTSTRH LAA, 还 有 支持 快 
速 搜索 相似 字符 串 的 索引 操作 符 类 。 


F.30.1. 三 元 模型 概念 
三 元 模型 是 一 组 从 一 个 字符 串 中 获得 的 三 个 连续 的 字符 。 我 们 可 以 通过 计数 两 个 字符 串 共 享 
的 三 元 模型 的 数量 来 测量 它们 的 相似 性 。 这 个 简单 的 想法 证 明 在 测量 许多 自然 语言 词汇 的 相 
似 性 时 是 非常 有 效 的 。 
Note: pg trn 从 一 个 字符 串 提 取 三 元 模型 时 忽略 非 文 字 字 符 (〈 非 字母 ) 。 SMES 
在 字符 串 中 的 三 元 模型 集合 时 ， 每 个 单词 被 认为 有 两 个 空格 前 级 和 一 个 空格 后 级 。 例 





如 ， 字 符 串 " cat "中 的 三 元 模型 的 集合 是 " c", " ca "，" cat "和 " at "。 字符 
eB" foo|bar "中 的 三 元 模型 的 集合 是 " F Ps " fo " foo a " 00 1 " b i " ba W 
" bar "和 " Ye " 


F.30.2. 函数 和 操作 符 


pg_trgm 模块 提供 的 函数 在 Table F-22 中 显示 ， 提 供 的 操作 符 在 Table F-23 中 显示 。 


Table F-22. pg_trgm 回 数 


BE 返回 描述 
返回 一 个 数字 表明 两 个 参数 是 多 么 相似 。 结 果 的 
similarity(text, text) real = $8 BO (表明 两 个 字符 串 完全 不 相似 ) 到 


1 (表明 两 个 字符 串 是 完全 相同 的 ) 。 
返回 一 个 给 定 字 符 串 中 所 有 三 元 模型 的 数组 。 


Sa rexel] (实际 上 这 个 除了 调试 之 外 很 少 有 用 。) 
返回 % 操作 符 使 用 的 当前 相似 性 冰 值 。 例 如 ， 这 
show_limit() real 个 设置 两 个 单词 间 的 最 小 相似 性 ， 这 两 个 单词 被 


认为 足够 相似 以 致 相互 之 间 拼 写 错 误 。 


设置 % REREAD SRE. Awa 
set_limit (real) real 须 在 0 和 1 之 间 ( 缺 省 是 0.3) 。 返回 传递 进来 的 
相同 的 值 。 


Table F-23. pg_trgm 操作 符 


操作 符 返回 描述 
如 果 它 的 参数 的 相似 性 高 于 set_limit 设置 的 当前 相 


% bool i 

text % text cod {UME 5] A GRE] true o 

text 类 离 

ex real 返回 参数 之 间 的 "距离 "， 这 是 1 减 去 similarity() 值 。 


&1lt;-&gt; text 


F.30.3. 索引 支持 


pg_trgm 模块 提供 GiST 和 GIN 索 引 操 作 符 类 ， 该 操作 符 类 人 允许 你 为 了 非常 快速 的 相似 性 搜索 

在 文本 字段 上 创建 一 个 素 引 。 这 些 索引 类 型 支持 上 面 描述 的 相似 性 操作 符 ， 并 且 人 额外 支持 基 
于 三 元 模型 的 索引 搜索 : LIKE, ILIKE, ~ 和 ~* 查询 。 (这 些 索引 并 不 支持 相等 也 不 
支持 简单 的 比较 操作 符 ， 所 以 你 可 能 也 需要 一 个 普通 的 B-tree 索 引 。 ) 


示例 : 


CREATE TABLE test_trgm (t text); 
CREATE INDEX trgm_idx ON test_trgm USING gist (t gist trgm ops); 


> 
口 


CREATE INDEX trgm_idx ON test_trgm USING gin (t gin trgm ops); 


在 这 一 点 ， 你 将 有 一 个 在 t 列 上 的 索引 ， 你 可 以 用 它 来 做 相似 性 搜索 。 一 个 典型 的 查询 是 : 


SELECT t, similarity(t, '_word_') AS sml 
FROM test_trgm 
WHERE t % '_word_' 
ORDER BY sml DESC, t; 


这 将 返回 文本 列 上 和 与 word 足够 相似 的 所 有 值 ， 从 最 佳 匹 配 到 最 坏 匹配 排序 。 该 索引 将 用 来 
做 一 个 快速 操作 ， 即 使 是 在 非常 大 的 数据 集 上 面 。 


上 面 查询 的 一 个 变 体 是 : 


SELECT t, t <-> '_word_' AS dist 
FROM test_trgm 
ORDER BY dist LIMIT 10; 


这 个 可 以 通过 GiST 索 引 更 有 效 的 实现 ， 而 不 是 GIN 素 引 。 当 只 想 要 少量 最 靠近 的 匹配 时 ， 通 
常会 使 用 第 一 个 公式 。 


MPostgreSQL 9.1 开 始 ， 这 些 素 引 类 型 也 支持 LIKE 和 re 索引 搜索 ， 例 如 


SELECT * FROM test_trgm WHERE t LIKE '%foo%bar'; 


该 索引 搜索 通过 从 搜索 字符 串 中 提取 三 元 模型 然后 在 索引 中 查找 这 些 三 元 模型 来 工作 。 搜索 
字符 串 中 的 三 元 模型 越 多 ， 索 引 搜索 越 有 效率 。 不 像 基于 B-tree 的 搜索 ， 搜索 字符 串 不 需要 
是 左边 固定 的 。 


从 PostgreSQL 9.3 开 始 ， 这 些 索 引 类 型 也 支持 正则 表达 式 匹 配 的 索引 搜索 ( ~ 和 ~* 操作 
符 ) ， 例 如 


SELECT * FROM test_trgm WHERE t ~ '(foo|bar)'; 


该 索引 搜索 通过 从 正则 表达 式 中 提取 三 元 模型 然后 在 索引 中 查找 这 些 三 元 模型 来 工作 。 ME 
则 表达 式 中 提取 出 来 的 三 元 模型 越 多 ， 索 引 搜索 越 有 效率 。 不 像 基于 B-tree 的 搜索 ， 搜索 字 
符 串 不 需要 是 左边 固定 的 。 


对 于 LIKE 和 正则 表达 式 搜索 ， 请 记 住 ， 没 有 可 提取 的 三 元 模型 将 降级 为 全 文 索 引 搜 索 。 


选择 GiST 还 是 GIN 索 引 取 决 于 GiST 和 GIN 的 相对 性 能 特征 ， 这 个 在 别 的 地 方 讨论 。 一 般 来 
说 ，GIN 素 引 比 GiST 素 引 搜 索 起 来 要 快 ， 但 是 在 建立 或 更 新 时 要 慢 ; 索引 GIN 更 适合 于 静态 
数据 而 GiST 适 合 于 经 常 更 新 的 数据 。 


F.30.4. 文本 搜索 集成 


三 元 模型 匹配 在 用 于 和 与 全 文本 索引 相 协 调 时 是 一 个 非常 有 用 的 工具 。 尤其 是 它 可 以 帮助 识别 
错误 拼写 的 输入 单词 ， 这 样 的 单词 将 不 能 直接 通过 全 文本 搜索 机 制 匹 配 。 


第 一 步 是 要 生成 一 个 包含 文档 中 的 所 有 唯一 词 的 辅助 表 : 


CREATE TABLE words AS SELECT word FROM 
ts_stat('SELECT to_tsvector(''simple'', bodytext) FROM documents'); 


这 里 的 documents 是 含有 我 们 希望 搜索 的 文本 字段 bodytext 的 表 。 使 用 simple 配 
E to_tsvector 画 数 的 原因 ， 不 是 使 用 一 个 语言 特定 的 配置 ， 是 我 们 想 要 一 个 原始 (RE 
改 ) 词 的 列表 。 


下 一 步 ， 在 该 词 的 列 上 创建 一 个 三 元 模型 索引 : 


CREATE INDEX words_idx ON words USING gin(word gin_trgm_ops); 


现在 ， 一 个 类 似 于 之 前 示例 的 seLEcT 查询 可 以 用 来 在 用 户 搜索 词 中 建议 错误 拼写 的 词 的 拼 
写 。 需要 一 个 有 用 的 额外 的 文本 ， 选 中 的 词 和 错误 拼写 的 词 有 相似 的 长 度 。 








Note: 因为 words 表 是 作为 一 个 单独 的 、 静 态 表 生成 的 ， 它 需要 定期 的 重新 生成 ， 这 样 
它 才 能 与 文档 集合 保持 合理 的 更 新 。 通 常 不 需要 使 它 恰 好 是 当前 的 。 
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F.31. postgres fdw 
postgres_fdw 模块 提供 外 部 数据 封装 器 的 功能 ，PostgreSQL 通 过 它 可 以 访问 存储 在 外 部 的 
PostgreSQL 服 务 器 上 的 数据 。 


本 模块 提供 的 功能 不 但 酒 盖 老 版 本 中 dblink 模 块 实现 的 功能 ， 而 且 postgres_fdw 提 供 更 加 透明 
和 符合 标准 的 语法 来 访问 远程 表 ， 并 在 许多 情况 下 提供 更 好 的 性 能 。 


使 用 postgres_fdw 模块 做 远程 访问 的 准备 : 
1. 使 用 CREATE EXTENSION 语 句 安装 postgres_fdw . 


2. 使 用 CREATE SERVER 语句 ,为 每 个 需要 连接 的 远程 数据 库 创建 一 个 外 部 服务 器 对 象 。 指 
定 除 了 user 和 password 以 外 的 连接 信息 作为 服务 器 对 象 的 选项 。 


3. 使 用 CREATE USER MAPPING 语 句 ， 为 每 个 需要 通过 外 部 服务 器 访问 的 数据 库 创 建 用 
户 映 射 。 指 定 远程 的 和 密码 作为 映射 用 户 的 user 和 password 。 


4. 使 用 CREATE FOREIGN TABLE 语句， 为 每 个 需要 访问 的 远程 表 创 建 外 部 表 。 创建 的 外 
部 表 的 对 应 列 必 须 与 远程 表 匹 配 。 也 可 以 在 外 部 表 中 使 用 与 远程 表 不 同 的 表 名 和 列 名 ， 
但 前 提 是 你 必须 将 正确 的 远程 对 象 名 作为 创建 外 部 表 对 象 的 选项 。 


上 面 的 操作 成 功 后 就 可 以 使 用 sELEcT 外 部 表 的 方式 访问 存储 在 远程 表 中 的 数据 了 。 同 
样 INSERT ，UPDATE 和 DELETE 操作 都 是 可 以 执行 的 。 (映射 的 远程 用 户 需 要 有 能 做 这 些 操作 
的 权限 ) 


建议 外 部 表 的 字段 和 相关 联 的 远程 表 使 用 相同 的 数据 类 型 和 校对 规则 ， 虽 然 postgres_fdw Jd 
许 在 需要 的 时 候 进 行 字 符 类 型 的 转换 ， 但 当 数据 类 型 和 校对 规则 不 匹配 的 时 候 ， 由 于 远程 服 
务 器 和 本 地 服务 器 对 于 wer 条 件 的 不 同 解释 ， 也 许 会 造成 语义 的 错误 。 


需要 注意 的 是 一 个 外 部 表 可 以 声明 比 和 他 关联 的 远程 表 更 少 的 列 ， 列 的 排序 也 可 以 不 同 。 和 
远程 表 列 的 关联 用 的 是 列 名 ， 和 列 的 位 置 无 关 。 


F.31.1. postgres_ fdw 中 FDW 选 项 


F.31.1.1. 连接 选项 


一 个 作为 封装 外 部 数据 使 用 的 外 部 服务 器 ， 可 以 使 用 libpq 接 受 的 连接 字符 串 ， 详 见 Section 
31.1.2， 除 了 下 面 的 选项 是 不 允许 使 用 的 : 


e user 和 password (将 在 用 户 映 射 中 指定 ) 
e client_encoding (根据 本 地 服务 器 编码 自动 设 定 ) 


e fallback_application_name ( 设 定 为 postgres_fdw ) 


只 有 超级 用 户 连接 到 外 部 服务 器 是 不 需要 密码 的 ， 所 以 需要 为 映射 的 普通 用 户 指定 


password o 


F.31.1.2. 对 象 名 称 选 项 


这 些 设置 选项 被 用 来 控制 被 发 往 远程 postgres 服 务 器 中 的 sql 语 句 对 象 名 称 。 在 外 部 表 的 名 和 
关联 的 远程 表 名 不 同时 ， 用 于 设置 关联 。 


schema_name 


这 个 选项 可 以 为 外 部 表 指 定 模 式 名 ， 和 远程 服务 器 上 的 表 做 关联 。 如 果 忽 略 这 个 选项 ， 远 程 
表 本 身 的 模式 名 会 被 外 部 表 使 用 。 


table_name 


这 个 选项 可 以 为 外 部 表 指 定 表 名 ， 和 远程 服务 器 上 的 表 做 关联 。 如 果 忽 略 这 个 选项 ， 远 程 表 
本 身 的 表 名 会 被 外 部 表 使 用 。 


column_name 


这 个 选项 可 以 为 外 部 表 列 指定 表 名 ， 和 远程 服务 器 上 的 列 做 关联 。 如 果 忽 略 这 个 选项 ， 远 程 
表 本 身 的 列 名 会 被 外 部 表 使 用 。 


F.31.1.3. 成 本 估算 选项 


postgres_fdw 检索 数据 是 在 远程 服务 器 上 执行 的 ， 所 以 成 本 的 估算 不 只 是 远程 服务 器 扫描 外 

部 表 的 效率 ， 还 应 该 加 上 网 络 通信 的 开销 。 想 要 获得 预期 结果 最 可 靠 的 方式 是 对 远程 服务 器 
做 请 求 增加 开销 ， 但 是 对 于 一 些 简单 查询 来 说 可 能 不 值得 这 样 做 ， 所 postgres_fdw 提供 如 下 
选项 做 成 本 估算 : 


use_remote_estimate 
外 部 表 或 者 外 部 服务 器 可 以 指定 该 选项 ， 用 来 控制 postgres_fdw 是 否 发 出 远程 的 EXPLAIN fp 
使 来 获取 成 本 估算 。 表 的 设 定 优先 于 服务 器 的 设 定 ， 但 只 限于 设 定 的 表 。 默 认 值 的 false。 


fdw_startup_cost 


外 部 服务 器 可 以 指定 该 选项 ， 该 数值 类 型 的 选项 会 在 每 个 外 部 表 的 查询 开始 前 加 入 一 个 数值 
成 本 。 用 这 个 值 代表 建立 连接 ， 在 远程 端的 查询 分 析 和 规划 的 额外 开销 。 默认 值 是 100 。 


fdw_tuple_cost 
外 部 服务 器 可 以 指定 该 选项 ， 该 数值 类 型 的 选项 会 根据 外 部 表 打 描 结果 为 每 行 加 入 一 个 额外 


的 成 本 。 这 个 代表 服务 器 间 传 输 数 据 的 额外 的 网 络 开销 。 可 以 用 这 个 数值 的 高 低 来 反应 到 远 
程 服务 器 的 网 络 延 迟 。 上 默认 值 是 0.01 © 


use_remote_estimate 值 为 真 的 时 候 ， 成 本 估算 的 方法 是 postgres_fdw 获取 远程 服务 器 的 语 
句 执 行 操 作成 本 估算 值 加 上 fdw_startup_cost 和 use_remote_estimate o 当 值 为 假 的 时 候 ， 
成 本 估算 方法 只 能 是 按照 语句 本 地 的 执行 成 本 加 上 

fdw_startup_cost 和 use_remote_estimate 。 除非 本 地 表 的 统计 信息 和 远程 表 统 计 信息 的 相 
同 ， 否 则 本 地 的 估算 一 般 是 不 精确 的 。 在 外 部 表 执 行 ANALYZE 操 作 来 刷新 远程 表 的 统计 信 
A, 这 个 操作 会 扫描 远程 表 ， 使 计算 和 存储 统计 信息 就 像 在 本 地 一 样 。 在 本 地 保存 统计 信息 
可 以 减少 远程 表 的 每 个 查询 的 执行 计划 都 造成 系统 开销 。 但 是 如 果 远 程 表 被 更 新 的 频率 A 
高 ， 本 地 的 统计 信息 也 会 很 快 失 去 应 有 的 作用 。 


F.31.1.4. 更 新 选 型 


默认 情况 下 ， 所 有 postgres_fdw 相关 外 部 表 都 假设 是 可 以 更 新 的 。 应 用 时 优先 下 面 的 选项 功 
BE: 


updatable 


这 个 选项 用 来 控制 外 部 表 是 否 可 以 用 Insert , uppate 和 DELETE 来 修改 。 该 选项 可 以 被 外 部 
表 或 者 外 部 服务 器 指定 。 表 级 别 的 选项 优先 于 服务 器 级 别 的。 默认 值 是 true o 


当然 如 果 一 个 远程 表 本 身 是 不 能 用 增删 改 的 ， 那 将 会 报错 。 错 误 直 接 会 在 本 地 抛 出 。 注 
意 information_schema 将 会 根据 这 个 选项 的 设置 显示 一 个 外 部 表 是 否 可 以 增删 改 ， 而 不 会 去 
检查 远程 服务 器 。 


F.31.2. 连接 管理 


postgres_fdw 会 在 第 一 个 查询 外 部 服务 器 关联 的 外 部 表 时 建立 和 外 部 服务 器 的 连接 。 这 个 连 
接 会 一 直 保 持 ， 而 且 在 同一 个 会 话 中 被 重用 。 如 果 涉 及 多 个 用 户 (用 户 映射 ) 访问 外 部 服务 
器 时 ， 每 个 用 户 映 射 都 户 建立 一 个 连接 。 


F.31.3. 事务 管理 


当 查 询 涉 及 外 部 服务 器 的 远程 表 时 ， 将 在 本 地 开启 一 个 对 应 的 事务 ，postgres_fdw 将 会 在 远程 
服务 器 也 开启 事 务 。 远程 事务 会 和 本 地 事务 提交 终 保 持 同步 。 保 存 点 也 是 一 样 。 


当 本 地 的 事务 隔离 级 别 为 SERIALIZABLE 时 ， 远 程 的 事务 隔离 级 别 也 使 用 SERIALIZABLE 。 否 者 
远程 的 隔离 级 别 将 是 REPEATABLE READ, 这 是 为 了 保证 如 果 一 个 查询 涉及 远程 服 器 上 多 个 表 的 
扫描 ， 所 有 的 扫描 都 会 得 到 一 致 的 快照 结果 。 这 样 产生 的 结果 是 即使 远程 服务 器 上 的 数据 由 

于 其 他 的 操作 在 更 新 ， 单 个 事务 查询 返回 的 结果 也 是 一 样 的。 上 述 结果 在 本 地 事务 隔离 级 别 

SERIALIZABLE 和 REPEATABLE READ 无 论 怎样 都 是 可 以 实现 的 ， 但 是 在 READ coMMITTED 下 可 能 
会 得 到 意 想不到 的 结果 。 未 来 的 PostgreSQL 发 行 版 本 也 许 会 修改 这 些 规则 。 


F.31.4. 远程 查询 优化 


postgres_fdw 党 试 优化 远程 查询 ， 以 减少 从 外 部 服务 器 的 数据 传输 量 。 通 用 将 带 WHERE 查询 
条 件 的 语句 传 到 远程 服务 器 上 执行 和 不 取 回 与 查询 结果 不 相关 的 列 来 实现 。 为 了 减少 查询 未 
被 执行 的 风险 , whERE 从 名 中 都 是 内 建 的 数据 类 型 操作 和 男 数 的 时 候 才 会 被 传 到 远程 服务 器 
上 。 在 从 句 中 的 操作 和 郴 数 必 须 是 不 可 变 的 。 


EXPLAIN VERBOSE 可 以 用 来 检查 被 送 到 远程 服务 器 上 的 查询 执行 的 实际 状况 。 


F.31.5. 版 本 兼容 


postgres_fdw 可 以 将 PostgreSQL8.3 版 本 以 后 的 服务 器 作为 远程 服务 器 使 用 。8.1,8,2 的 服务 

器 只 能 提供 读 的 功能 。 有 这 样 个 问题 由 于 版 本 的 差异 将 where 中 的 内 建 本 数 送 到 远程 服务 器 
上 执行 的 时 候 ， 远 程 服务 器 由 于 版 本 低 无 法 识别 会 报 "function does not exist" 或 者 相似 的 错 
误 。 可 以 用 从 写 sql 的 方式 解决 ， 我 们 找 入 一 个 子 查询 sub- SELECT with oFFSET o ,将 有 问题 
的 函数 和 操作 移 出 sub- SELECT o 
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F.32. seg 


这 个 模块 为 定义 线段 和 浮 点 类 型 的 时 间 间 隔 提供 了 一 种 数据 类 型 seg, 这 种 数据 类 型 由 于 可 
以 代表 不 确定 终点 的 区 间 ， 所 以 在 做 实验 测量 的 时 候 特 别 有 用 。 


F.32.1. <--!Rationale--> 原 理 


几何 学 测量 要 比 测 量 连 续 的 点 复 末 的 多 ， 测 量 出 的 结果 通常 是 一 些 模糊 限制 的 连续 值 组 成 的 
区 间 值 。 这 种 区 间 的 产生 可 能 是 由 于 测量 出 结果 的 不 确定 性 ， 随 机 性 ， 也 可 能 要 测量 的 值 本 
身 就 是 以 区 间 的 形式 作为 条 件 的 ， 如 测量 蛋白 质 稳 定性 的 温度 范围 。 


一 般 来 说 ， 用 这 个 数据 类 型 存储 区 间 值 比 用 双 引 号 更 方便 。 实 际 上 ， 在 大 部 分 的 应 用 PRA 
使 用 也 更 有 效率 。 


进一步 说 ， 传 统 数 值 类 型 存储 数据 可 能 对 一 些 模糊 限制 的 值 产 生 偏差 ， 你 获取 的 会 值 是 6.50 
并 且 存 人 数据 库 ， 当 你 读 出 的 时 候 会 是 什么 ， 看 下 面 例子 : 


test=> select 6.50 :: float8 as "pH"; 
pH 

6.5 

(1 row) 


在 精确 测量 中 ，6.50 和 6.5 代 表 的 意思 是 不 一 样 的 ， 而 且 有 时 差异 会 很 大 。 测 量 者 记 下 或 者 公 
布 6.50 代 表 了 一 个 更 大 甚至 更 模糊 的 区 间 值 ，6.5 只 是 代表 了 6.50 的 一 个 中 心 点 。 像 这 种 不 同 
数据 的 同化 表达 是 我 们 绝对 不 想 看 到 的 。 


本 章 的 特殊 数据 类 型 可 以 用 来 记录 任意 可 变 精度 的 间隔 值 ， 而 且 记 录 的 每 个 数据 都 可 以 使 用 
自己 的 精度 。 


查看 结果 : 


test=> select '6.25 .. 6.50'::seg as "pH"; 
pH 


6.25 .. 6.50 
(1 row) 


F.32.2. 语法 


使 用 一 个 或 者 二 个 精度 数 代表 一 个 区 间 , 连 接 格 式 ( .. 或 ... ) 。 另 外 也 可 以 用 值 和 偏 移 符 
号 表示 (alt;, &gt; 或 - ) 。 (正确 的 符号 会 被 所 有 内 建 的 操作 忽略 。) 表 Table F-24 
和 Table F-25 给 出 了 区 间 表 示 的 方法 和 一 些 例子 。 


在 表 Table F-24 中 


delta 代表 双 精 度数 。 可 以 在 EX 





操作 符 。 


Table F-24. seg External Representations 


单个 值 〈 间 陋 为 0) 
区 间 x By 
区 间 x - delta to x + _delta 
x 开 区 间 无 下 限 
x 开 区 间 无 上 限 





Table F-25. Examples of Valid seg Input 


5.0 雳 长 度 的 区 间 (一 个 点 ) 

=S ~ 作为 一 个 标记 存在 ，5.0 的 点 和 记录 
&lt;5.0 alt; 作为 一 保留 个 标记 存在 ， 比 点 5.0 小 的 
&gt;5.0 agt; 作为 一 个 保留 标记 存在 ， 比 点 5.0 大 的 
5(+-)0.3 同 区 间 4.7... 5.3 (+-) 不 是 保留 标记 
50 .. 区 间 大 于 50 

.0 区 间 小 于 0 


表示 区 间 0.015 .. 


2 2A EAE 


在 数据 源 中 ... 被 广泛 使 用 ， 他 的 作用 和 另外 一 种 拼写 .. 
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2,1..2 表达 区 间 相 同 (空格 会 被 忽略 ) 


相同 。 但 这 可 能 产生 歧义 


如 0...23 是 表示 23 还 是 0.23 . 所 以 在 seg 数据 类 型 中 所 有 十 进 制 小 数 的 小 数 点 前 都 需要 


有 一 个 数字 。 


seg 不 人 允许 表示 的 区 间 由 大 到 小 表示 ， 如 5.. 


F.32.3. 精度 


seg 存储 的 值 使 用 32- 位 的 浮 点 数 。 精 度 不 超过 7 位 。 
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精度 小 于 7 位 ， 保 留 本 身 的 精度 。 换 句 话说 如 果 你 的 返回 值 是 0.00， 那 么 这 是 数值 本 身 带 的 精 
度 而 不 是 格式 化 处 理 的 。 数 值 前 的 0 不 作为 精度 : 值 0.0067 的 精度 被 视 为 2。 


F.32.4. 使 用 


seg 模块 包含 可 以 在 GiST 索 引 中 操作 seg 数据 类 型 值 的 类 ， 该 类 支持 表 Table F-26 中 的 操 
作 。 


Table F-26. Seg GiST Operators 


操作 描述 


[a,b] 的 范围 完全 在 [c,d] 的 左 侧 。 换 句 话说 ，b < c 那 么 [a,b] 
<< [c, d] 为 真 ， 否 则 为 假 。 


[a,b] 的 范围 全 部 在 [c,d] 的 右 侧 。 换 名 话说 ，a > dH [a,b] 


m 
w 
ay 

t 


gle ert e d] 


>]e E SWAB 

[a, b] &&lt; [c, d] 左 包含 ， 或 者 解读 为 取 值 范围 不 超过 右边 ，b <= d 时 为 真 。 
[a, b] &&gt; [c, d] 右 包含 ， 或 者 解读 为 取 值 范围 不 超过 左边 ，a >= c 时 为 真 。 
[a, b] = [c, d] [a, bl] 和 [c, d] 相 同 ， 当 a=c 并 且 b=d 时 为 真 。 

[a, b] && [c, d] [a, bl 和 [c, j= 4B 

[a, b] @&gt; [c, d] [a, b] 包 含 [c, d, ARA a <= c 并 且 b >= d, 

[a, b] &1t;@ [c, d] [a, b] 被 [c, d] 包 含 ， 意 味 着 a >= cand b <= d, 


PostgresSQL 8.2 之 前 的 版 本 中 ， G@agt; 和 &lt;@ DAA @ 和 ~ 表示 。 但 那 种 表示 方式 会 
在 将 来 完全 被 替代 ， 所 以 不 赞成 使 用 。 注 意 旧 的 名 称 会 随 着 代表 几何 的 数据 类 型 转换 为 惯例 
的 格式 。 


提供 标准 的 B-tree 操 作 ， 例 如 


操作 描述 
[amo et [ies cll 小 于 
[a, b] &gt; [c, d] DR 


这 些 操作 除了 做 排序 以 外 没有 别 的 用 处 ， 首 先是 (a) 和 (c) 比 较 大 小 ， 如 果 相等 在 比较 (b) 和 
(d)。 如 果 使 用 这 种 类 型 排序 ， 得 到 的 的 结果 在 大 多 数 情 况 下 是 合理 的 。 


F.32.5. 注意 
使 用 例子 ， 参 看 回归 测试 sql/seg.sql o 


使 用 (+-) 机 制 转 换 数字 的 时 候 可 能 得 到 不 确定 的 精度 。 举 个 例子 他 可 能 为 较 低 的 边界 值 增 
加 额外 的 精度 : 


postgres=> select '10(+-)1'::seg as seg; 
seg 


SaO ao lal Bo Jee S) ao alah 


R-tree 索引 的 性 能 很 大 程度 上 依赖 初始 输入 值 的 排序 。 在 输入 表 的 seg 类 型 列 上 排序 可 能 是 
非常 有 效果 的 ; 参考 脚本 sort-segments.pl 。 
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F.33. sepgsql 


sepgsql 是 一 个 可 加 载 的 模块 ， 支持 基于 标签 的 强制 访问 控制 (MAC)， 以 SELinux 安 全 策略 为 
基础 。 


Warning 


当前 的 实现 有 很 大 的 局 限 性 ， 并 不 为 所 有 的 动作 都 执行 强制 访问 控制 。 参阅 Section 
RoT: 


F.33.1. 概述 


这 个 模块 与 SELinux 结 合 ， 提 供 一 个 PostgreSQL 正常 提供 的 安全 检查 的 附加 层 。 从 SELinux 
来 看 ， 这 个 模块 允许 PostgreSQL 起 到 用 户 空间 对 象 管理 者 的 作用 。 DML 查 询 发 起 的 每 个 表 
和 男 数 访问 都 将 针对 系统 安全 策略 做 检查 。 这 个 检查 是 PostgreSQL 执 行 的 通常 的 SQL 权 限 检 
查 之 外 的 东西 。 


SELinux 访 问 控制 决策 利用 安全 标签 ， 以 字符 串 表 示 ， 

如 system_u:object_r:sepgsql_table_t:so, 每 个 访问 控制 决策 包含 两 个 标签 : 尝试 执行 动作 
的 主题 的 标签 ， 和 要 被 执行 操作 的 对 象 的 标签 。 因 为 这 些 标签 可 以 用 于 任意 类 型 的 对 象 ， 所 
以 存储 在 数据 库 中 的 对 象 的 访问 控制 决策 会 〈 用 这 个 模块 是 这 样 的 ) 和 任意 其 他 类 型 的 对 象 
(比如 ， 文 件 ) 一 样 使 用 通用 标准 。 这 个 设计 是 为 了 人 允许 集中 的 安全 策略 保护 信息 资产 独立 
于 这 些 资 产 的 存储 细节 。 


SECURITY LABEL 语 句 允 许 分 配 安全 标签 给 数据 库 对 象 。 


F.33.2. 安装 


sepgsql 只 能 用 于 Linux 2.6.28 或 更 高 的 启用 SELinux 的 系统 。 在 其 他 的 平台 上 不 能 使 用 。 也 
需要 libselinux 2.1.10 或 更 高 版 本 和 selinux-policy 3.9.13 或 更 高 版 本 (尽管 一 些 分 支 可 以 移植 
需要 的 规则 到 老 的 政策 版 本 ) o 


sestatus 命令 允许 检查 SELinux 的 状态 。 一 个 典型 的 显示 是 : 


$ sestatus 


SELinux status: enabled 
SELinuxfs mount: /selinux 
Current mode: enforcing 
Mode from config file: enforcing 
Policy version: 24 

Policy from config file: targeted 


如 果 禁 用 了 SELinux 或 者 没有 安装 SELinux， 那么 必须 在 安装 这 个 模块 之 前 先 配置 该 产品 。 


要 建立 这 个 模块 ， 在 你 的 PostgreSQL configure 命令 中 包含 选项 --with-selinux o MARTE 
建立 时 已 经 安装 了 libselinux-devel RPM. 


要 使 用 这 个 模块 ， 必 须 在 postgresql.conf 的 shared preload libraries 参 数 中 包含 

了 sepgsql o 如 果 以 任何 其 他 方式 加 载 ， 该 模块 将 不 会 正确 的 运行 。 一 旦 加 载 了 该 模块 ， 你 
应 该 在 每 个 数据 库 中 执行 sepgsql.sql o 这 将 安装 安全 标签 管理 需要 的 函数 ， 并 且 分 配 最 初 
的 安全 标签 。 


这 里 是 一 个 示例 ， 显 示 如 何 用 sepgsql 汞 数 和 安装 的 安全 标签 初始 化 新 的 数据 库 集群 。 为 你 
的 安装 适当 的 调整 显示 的 路 径 : 


$ export PGDATA=/path/to/data/directory 


$ initdb 
$ vi $PGDATA/postgresql.conf 
change 
#shared_preload_libraries = '' # (change requires restart) 
to 
shared_preload_libraries = 'sepgsql' # (change requires restart) 


$ for DBNAME in templateO templatei postgres; do 
postgres --single -F -c exit_on_error=true $DBNAME \ 
</usr/local/pgsql/share/contrib/sepgsql.sql >/dev/null 
done 


请 注意 ， 你 可 能 会 看 到 一 些 或 者 所 有 下 列 的 通知 ， 取 决 于 你 的 libselinux 和 selinux-policy 版 


+ ï 


/etc/selinux/targeted/contexts/sepgsql_contexts: line 33 has invalid object type db_blob 
/etc/selinux/targeted/contexts/sepgsql_contexts: line 36 has invalid object type db_lang 
/etc/selinux/targeted/contexts/sepgsql_contexts: line 37 has invalid object type db_lang 
/etc/selinux/targeted/contexts/sepgsql_contexts: line 38 has invalid object type db_lang 
/etc/selinux/targeted/contexts/sepgsql_contexts: line 39 has invalid object type db_lang 
/etc/selinux/targeted/contexts/sepgsql_contexts: line 40 has invalid object type db_lang 


SSS eee 


这 些 信 息 是 无 害 的 ， 应 该 忽略 。 





如 果 安 装 进程 没有 错误 的 完成 了 ， 那 么 你 现在 可 以 正常 的 启动 服务 器 。 


F.33.3. 回 为 测试 


由 于 SELinux 的 性 质 ， 为 sepgsql 运行 回 为 测试 需要 几 个 额外 的 配置 步骤 ， 其 中 一 些 必须 作 
为 root 用 户 完 成 。 回归 测试 不 通过 一 个 普通 的 make check 或 make installcheck MPRA 
行 ; 你 必须 设置 配置 ， 然 后 手动 的 调用 测试 脚本 。 测试 必须 在 配置 的 PostgreSQL 构 造 树 
的 contrib/sepgsql 目录 中 运行 。 尽管 他 们 需要 一 个 构造 树 ， 但 是 测试 的 目的 是 针对 一 个 已 经 
安装 的 服务 器 执行 的 ， 这 点 他 们 可 以 与 make installcheck 作 上 比较 。 


nr WR 请 注意 ， 当 前 
的 操作 系统 用 户 必须 能 够 作为 超级 用 户 不 需要 密码 认证 的 连接 到 数据 库 。 


第 二 步 ， 为 回 为 测试 建立 和 安装 策略 包 。 sepgsql-regtest 策略 是 一 个 特定 用 途 的 策略 包 ， 提 
供 了 一 组 在 回归 测试 期 间 被 允许 的 规则 。 应 该 从 策略 源 文 件 sepgsql-regtest.te 中 建立 ， 使 

用 make 和 SELinux 提 供 的 Makefile 来 实现 。 你 需要 在 你 的 系统 上 定位 适当 的 Makefile ; FA 

显示 的 路 径 只 是 一 | 示例 。 一 旦 建立 ， 使 用 semodule 命令 安装 这 个 策略 包 ， 它 加 载 提 供 的 

策略 包 到 内 核 中 。 如 果 策 略 包 正确 的 安装 了 ， 那么 semodule -| 应 该 会 业 sepgsql-regtest 作 
为 一 个 可 用 的 策略 包 列 出 : 


$ cd .../contrib/sepgsql 

$ make -f /usr/share/selinux/devel/Makefile 
$ sudo semodule -u sepgsql-regtest.pp 

$ sudo semodule -1 | grep sepgsql 
sepgsql-regtest 1.07 


第 三 步 ， 打 开 sepgsql_regression_test_mode, 出 于 安全 考虑 ， sepgsql-regtest HANH) ik 
省 是 不 启用 的 ; sepgsql_regression_test_mode 参数 启用 需要 发 出 回归 测试 的 规则 。 可 以 使 


用 setsebool 命令 打开 : 


$ sudo setsebool sepgsql_regression_test_mode on 
$ getsebool sepgsql_regression_test_mode 
sepgsql_regression_test_mode --> on 


第 四 步 ， 验 证 你 的 shell 是 在 unconfined_t 域 中 运行 : 


$ id -Z 
unconfined_u:unconfined_r:unconfined_t:s0-s0:c0.c1023 


如 果 需 要 ， 请 参阅 Section F33.8 获 取 调 整 你 的 工作 域 的 详细 信息 。 


最 后 ， 运 行 回 愉 测 试 脚 本 : 


$ ./test_sepgsql 


这 个 脚本 将 尝试 验证 你 已 经 正确 的 做 了 所 有 的 配置 步骤 ， 然后 它 将 为 sepgsql 模块 运行 为 回 
测试 。 


完成 测试 之 后 ， 建 议 你 禁用 sepgsql_regression_test_mode 参数 : 


$ sudo setsebool sepgsql_regression_test_mode off 


你 可 能 想 要 彻底 删除 sepgsql-regtest 策略 : 


$ sudo semodule -r sepgsql-regtest 


F.33.4. GUC 参数 


sepgsql.permissive ( boolean ) 


这 个 参数 使 得 sepgsql 能 够 在 许可 的 模式 运行 ， 无 视 系 统 的 设置 。 缺 省 为 of。 这 个 参数 只 能 
在 postgresql.conf 文件 中 或 者 在 服务 器 的 命令 行 设置 。 


当 这 个 参数 为 on 时 ， sepgsql 男 数 在 许可 模式 ， 即使 SELinux 通 常 运行 在 强制 模式 。 这 个 参 
数 对 于 测试 目的 尤其 有 用 。 


sepgsql.debug_audit ( boolean ) 


这 个 参数 启用 审计 信息 的 打印 ， 无 视 系 统 策略 设置 。 缺 省 是 of， 意味 着 信息 将 根据 系统 设置 


SELinux 的 安全 策略 也 有 规则 控制 是 否 记录 特殊 的 访问 。 缺 省 的 ， 只 记录 违规 的 访问 。 
这 个 参数 强制 打开 所 有 可 能 的 记录 ， 无 视 系 统 的 策略 。 


F.33.5. 特性 


F.33.5.1. 控制 对 象 类 


SELinux 的 安全 模型 描述 了 所 有 的 访问 控制 规则 ， 作为 主题 的 实体 (通常 ， 数 据 库 的 一 个 客 
Pim) 和 对 象 的 实体 (上 比如 一 个 数据 库 对 象 ) 的 关系 ， 每 一 个 都 由 安全 标签 来 鉴别 。 如 果 尝 
试 访问 一 个 没有 标签 的 对 象 ， 那么 该 对 象 被 当做 是 分 配 了 unlabeled_t 标签 。 


目前 ， sepgsql 人 允许 分 配 安全 标签 给 模式 、 表 、 字 段 、 序 列 、 视图 和 画 数 。 当 正在 使 

用 sepgsql 时 ， 自动 分 配 安 全 标签 给 在 创建 时 支持 的 数据 库 对 象 。 这 个 标签 被 称 为 缺 省 的 安 
全 标签 ， 并 且 是 根据 系统 的 安全 策略 决定 的 ， 数 据 库 会 拿 这 个 系统 的 安全 策略 输入 来 当 作 创 
建 人 的 标签 ， 该 标签 分 配给 新 对 象 的 父 对 象 ， 并 且 可 以 选择 以 构造 对 象 名 来 命名 。 


一 个 新 的 数据 库 对 象 基本 上 继承 父 对 象 的 安全 标签 ， 除 了 安全 策略 有 特殊 的 类 型 转换 规则 
时 ， 会 应 用 一 个 不 同 的 标签 。 对 于 模式 来 说 ， 父 对 象 是 当前 数据 库 ; 对 于 表 、 序 列 、 视 图 和 
BM, 是 包含 的 模式 ; 对 于 字段 ， 是 包含 的 表 。 


F.33.5.2. DML 权限 


对 于 表 ， db_table:select 、 db_table:insert 、 db_table:update 或 db_table:delete , 根据 
语句 的 类 型 ， 为 所 有 引用 的 目标 表 做 检查 ; BA, db_table:select 也 为 所 有 

在 whERE 或 RETURNING 子 句 中 的 包含 字段 引用 的 表 做 检查 ， upPDATE 的 数据 源 也 是 如 此 ， 等 
等 。 


也 将 为 每 个 引用 的 字段 检查 字段 级 别 的 权限 。 db_column:select 不 只 是 检查 被 sELEcT 读 取 
的 字段 ， 也 检查 在 其 他 DML 语 句 中 引用 的 字段 ; db_column:update 或 db_column:insert 也 将 
检查 被 UPDATE 或 INSERT 修改 的 字段 。 


例如 ， 考 虑 : 


UPDATE t1 SET x = 2, y = md5sum(y) WHERE z = 100; 


这 里 ， db_column:update 将 为 t1.x 做 检查 ， 因为 它 被 更 新 了 ， db_column: {select update} 
将 为 tiy 做 检查 ， 因 为 它 被 更 新 和 引用 了 ， db_column:select 将 为 t1.z 做 检查 ， 因为 它 
被 引用 了 。 db_table:{select update} 也 将 在 表 级 别 做 检查 。 


对 于 序列 ， 当 我 们 使 用 sELEcT 引用 一 个 序列 对 象 时 ， 对 db_sequence:get_value 做 检查 ; 不 
过 ， 请 注意 ， 我 们 当前 不 检查 执行 对 应 的 范 数 的 权限 ， 如 lastval() o 


对 于 视图 ， 将 检查 db_view:expand, 然后 任何 其 他 需要 的 权限 都 将 分 别 在 从 视图 扩展 的 对 象 
上 做 检查 。 


对 于 画 数 ， 当 用 户 党 试 将 函数 作为 查询 的 一 部 分 执行 ， 或 使 用 快速 路 径 调 用 时 ， 会 

对 db_procedure: {execute} 做 检查 。 如 果 这 个 画 数 是 一 个 受信 任 的 程序 ， 那么 也 会 检 

查 db_procedure: {entrypoint} 的 权限 ， 看 看 它 是 否 可 以 作为 受信 任 的 程序 的 入 口 点 来 执行 。 

为 了 访问 任意 模式 对 象 ， 在 包含 的 模式 上 需要 db_schema:search 权限 。 当 不 带 有 模式 限定 的 
引用 一 个 对 象 时 ， 这 个 模式 的 权限 没有 出 现 将 不 会 被 搜索 〈 就 好 像 用 户 在 这 个 模式 上 没 

有 usace 权限 ) 。 如 果 给 出 了 明确 的 模式 限定 ， 如 果 用 户 在 命名 的 模式 上 没有 必需 的 权限 ， 

那么 将 会 出 现 一 个 错误 。 

客户 端 必须 被 允许 访问 所 有 引用 的 表 和 字段 ， 即 使 它们 起 源 于 随后 扩张 的 视图 ， 所 以 我 们 应 
用 一 致 的 访问 控制 规则 ， 独 立 于 引用 表 内 容 的 方式 。 

缺 省 的 数据 库 权 限 系统 允许 数据 库 超级 用 户 使 用 DML 命 邻 修 改 系 统 目录 ， 引用 和 修改 toast 

表 。 当 启用 sepgsql 时 ， 禁 止 这 些 操作 。 


F.33.5.3. DDL 权限 


SELinux 为 每 个 对 象 类 型 定义 了 几 个 控制 一 般 操作 的 权限 ; 比如 创建 、 HECK, MIRA AT 
安全 标签 。 另 外 ， 几 个 对 象 类 型 有 特殊 的 权限 控制 它们 的 典型 操作 ; 如 在 一 个 特别 的 模式 中 
添加 或 删除 名 字 入 口 。 


创建 一 个 新 的 数据 库 对 象 需 要 create 权限 。SELinux 将 根据 客户 端的 安全 标签 授予 或 拒绝 这 
个 权限 ， 并 且 为 新 的 对 象 拟 建安 全 标签 。 在 某 些 情况 下 ， 需 要 额外 的 权限 : 


e CREATE DATABASE 还 需要 源 或 模板 数据 库 的 getattr 权限 。 
。 创建 一 个 模式 对 象 还 需要 在 父 模 式 上 有 add_name 权限 。 


。 创建 一 个 表 还 需要 有 权限 创建 每 个 单独 的 表 字 段 ， 就 好 像 每 个 表 字 段 是 一 个 独立 的 顶级 
对 象 。 


。 创建 一 个 标记 为 LEAKPROOF 的 函数 还 需要 install 权限 。 ( 当 为 一 个 现 有 的 函数 设 
E LEAKPRooF 时 ， 也 需要 检查 这 个 权限 。) 


当 执 行 prop 命令 时 ， 将 在 要 被 删除 的 对 象 上 检查 drop. 也 要 检查 通过 cAscADpE 直接 删除 的 
对 象 的 权限 。 包含 在 特定 模式 ( 表 、 视 图 、 序 列 和 程序 ) 中 对 象 的 删除 还 需要 在 该 模式 上 


的 remove_name o 


当 执行 ALTER 命令 时 ， 将 为 每 个 对 象 类 型 的 被 修改 的 对 象 检 查 setattr ， 除了 附属 的 对 象 ， 
如 表 的 素 引 或 触发 器 ， 这 里 的 权限 是 在 父 对 象 上 检查 的 。 在 某 些 情况 下 ， 需 要 额外 的 权限 : 


。 移动 一 个 对 象 到 新 的 模式 还 需要 在 旧 的 模式 上 有 remove_name AIR, 和 在 新 的 模式 上 
有 add_name 权限 。 


。 在 一 个 函数 上 设置 LEAKPRooF 属性 需要 install 权限 。 


。 在 一 个 对 象 上 使 用 SECURITY LABEL 还 需要 在 与 老 的 安全 标签 结合 的 对 象 上 有 
relabelfrom 权限 ， 和 在 与 新 的 安全 标签 结合 的 对 象 上 有 relabelto 权限 。 【在 安装 了 
多 个 标签 提供 者 和 用 户 党 试 设置 一 个 安全 标签 ， 但 不 被 SELinux 管理 的 情况 下 ， 只 应 该 
检查 setattr 。 这 是 由 于 实现 的 限制 ， 目 前 没有 做 到 的 。 ) 


F.33.5.4. 受信 任 的 程序 


受信 任 的 程序 类 似 于 安全 定义 函数 或 setuid 命 令 。SELinux 提供 一 个 特性 ， 人 允许 受信 任 的 代码 
使 用 一 个 不 同 于 客户 端的 安全 标签 运行 ， 通常 是 为 了 提供 到 敏感 数据 的 高 度 控 制 的 访问 ( 例 
如 ， 可 能 会 忽略 行 ， 或 者 存储 值 的 精度 可 能 会 减少 ) 。 一 个 函数 是 否 作为 受信 任 的 程序 动 
作 ， 是 由 它 的 安全 标签 和 操作 系统 安全 策略 控制 的 。 例 如 : 


postgres=# CREATE TABLE customer ( 
cid int primary key, 
cname text, 
credit text 


) ; 
CREATE TABLE 
postgres=# SECURITY LABEL ON COLUMN customer.credit 
IS 'system_u:object_r:sepgsql_secret_table_t:s0'; 
SECURITY LABEL 
postgres=# CREATE FUNCTION show_credit(int) RETURNS text 
AS 'SELECT regexp_replace(credit, ''-[@-9]+$'', ''-xxxx'', ''g'') 
FROM customer WHERE cid = $1' 
LANGUAGE sql; 
CREATE FUNCTION 
postgres=# SECURITY LABEL ON FUNCTION show_credit(int) 
IS 'system_u:object_r:sepgsql_trusted_proc_exec_t:s0'; 
SECURITY LABEL 





以 上 的 操作 应 该 由 管理 员 用 户 执行 。 


postgres=# SELECT * FROM customer; 
ERROR: SELinux: security policy violation 
postgres=# SELECT cid, cname, show_credit(cid) FROM customer; 


cid | cname | show_credit 
Sete RY Pes Ny E E me a ee A 
1 | taro | 1111-2222-3333-xxxx 
2 | hanako | 5555-6666-7777-xxxx 
(2 rows) 


在 这 种 情况 下 ， 普 通用 户 不 能 直接 引用 customer.credit , 但 是 一 个 受信 任 的 程 
Æ show_credit 人 允许 他 带 有 一 些 数字 标记 的 打印 客户 的 信用 卡号 码 。 


F.33.5.5. 动态 域 转换 


使 用 SELinux 的 动态 域 转 换 特性 来 转换 客户 端 程序 、 客 户 端 域 的 安全 标签 到 一 个 新 的 内 容 是 可 
能 的 ， 如 果 安 全 策略 允许 这 人 么 做 。 客 户 端 域 需要 setcurrent 权限 ， 还 有 从 老 的 都 新 的 域 
的 dyntransition 权限 。 


动态 域 转换 应 该 仔细 考虑 ， 因 为 他 们 人 允许 用 户 转换 他 们 的 标签 ， 并 且 因此 他 们 在 选项 上 的 权 
限 不 受 系统 的 授权 (在 受信 任 的 程序 的 情况 下 ) o 因此 ， dyntransition 权限 只 在 用 于 转换 
一 个 域 到 更 小 的 权限 集合 时 认为 是 安全 的 。 例如 : 


regression=# select sepgsql_getcon(); 
sepgsql_getcon 


unconfined_u:unconfined_r:unconfined_t:s0-s0:cQ.c1023 
(1 row) 


regression=# SELECT sepgsql_setcon('unconfined_u:unconfined_r:unconfined_t:s0-s0:c1.c4'); 
sepgsql_setcon 


regression=# SELECT sepgsql_setcon('unconfined_u:unconfined_r:unconfined_t:s0-s0:c1.c1023 
ERROR: SELinux: security policy violation 


BE 


在 上 面 的 例子 中 ， 人 允许 我 们 从 较 大 的 MCS 范 围 c1.c1923 转换 到 较 小 的 范围 c1.c4 ， 但 是 反 
过 来 转换 就 被 拒绝 了 。 


动态 域 转换 和 受信 任 的 程序 的 组 合 使 得 一 个 有 趣 的 用 例 满足 连接 池 软 件 的 典型 的 生命 周期 过 
程 。 尽管 你 的 连接 池 软 件 不 能 运行 大 多 数 的 SQL 命 伟 ， 但 是 你 可 以 允许 它 使 

用 sepgsql_setcon() 画 数 从 一 个 受信 任 的 程序 里 面 切换 客户 端的 安全 标签 ; 可 能 需要 一 些 证 
书 批准 切换 客户 端 标签 的 请 求 。 之 后 ， 这 个 会 话 将 会 拥有 目标 用 户 的 权限 ， 而 不 是 连接 池 的 
权限 。 该 连接 池 可 以 稍 后 使 用 eA NULL 参数 的 sepgsql_setcon() HAWKS LEAH 
变 ， 再 次 从 受信 任 的 程序 里 面 用 适当 的 权限 检查 调用 。 这 里 的 要 点 是 只 有 那个 受信 任 的 程序 
实际 上 拥有 改变 有 效 的 安全 标签 的 权限 ， 并 且 给 出 适当 的 证 书 。 当然 ， 对 于 安全 的 操作 ， 证 
书 的 存储 ( 表 、 过 程 定义 或 其 他 东西 ) 必须 防止 越权 访问 。 





F.33.5.6. 其 他 


我 们 拒绝 LOAD 命 命 包括 一 切 ， 因为 加 载 的 任何 模块 都 能 很 容易 的 绕 开 安全 策略 实施 。 


F.33.6. Sepgsql HX 


Table F-27 显 示 了 可 用 的 函数 。 
Table F-27. Sepgsql 2X 


| sepgsql_getcon() returns text | 返回 客户 端的 域 ， 客户 端 当前 的 安全 标签 。 || 
sepgsql_setcon(text) returns bool | 如 果 安 全 策略 允许 ， 则 切换 当前 会 话 的 客户 端的 域 到 一 
个 新 的 域 。 也 接受 NULL 输入 作为 转换 到 客户 端 原来 的 域 的 一 个 请 求 。 | | 
sepgsql_mcstrans_in(text) returns text | 如 果 mcstrans 进 程 正在 运行 ， 则 转化 给 出 的 限定 
MLS/MCS 范 围 为 行 格式 。 | | sepgsql_mcstrans_out(text) returns text | 如 果 mcstrans 进 程 
正在 运行 ， 则 转化 给 出 的 行 MCS/MCS 范 围 为 限定 的 格式 。 | | 

sepgsql_restorecon(text) returns bool | 为 当前 数据 库 中 所 有 的 对 象 设置 初始 的 安全 标签 。 
参数 可 以 是 NULL， 或 特定 文件 的 名 字 用 于 系统 默认 的 选择 。 | 


F.33.7. 限制 


数据 定义 语言 (DDL) 权限 

由 于 实现 的 限制 ， 一 些 DDL 操 作 不 检查 权限 。 

数据 控制 语言 (DCL) 权限 

由 于 实现 的 限制 ，DCL 操 作 不 检查 权限 。 

行 级 别 的 访问 控制 

PostgreSQL 不 支持 行 级 别 的 访问 ; 因此 sepgsql 也 不 支持 。 

隐藏 通道 

sepgsql 没有 试图 隐藏 某 一 对 象 的 存在 ， 即 使 不 允许 用 户 访问 它 。 例如 ， 我 们 可 以 推断 一 个 
不 可 见 对 象 的 存在 ， 根 据 主键 冲突 、 外 键 冲突 等 ， 虽然 我 们 不 能 获得 该 对 象 的 内 容 。 最 高 机 
密 表 的 存在 不 能 被 隐藏 ; 我 们 只 希望 能 隐藏 它 的 内 容 。 

F.33.8. 外 部 资源 

SE-PostgreSQL 介绍 


这 个 wiki 页 提供 了 一 个 简要 概述 、 安 全 设计 、 构 造 、 管 理 和 即将 到 来 的 特性 。 


Fedora SELinux 用 户 指南 


这 个 文档 提供 了 在 你 的 系统 上 管理 SELinux 的 广泛 的 知识 。 它 主要 集中 于 Fedora， 但 是 不 局 
限于 Fedora。 


Fedora SELinux FAQ 


这 个 文档 回答 了 关于 SELinux 的 常见 问题 。 它 主要 集中 于 Fedora， 但 是 不 局 限于 Fedora。 


F.33.9. 作者 


KaiGai Kohei &lt; [kaigai@ak.jp.nec.com](mailto:kaigai@ak.jp.nec.com)&gt; 


F.34. spi 


spi 模 块 提供 几 个 使 用 SPI 和 人 触发 器 的 可 行 的 示例 。 当 这 些 画 数 是 它们 自己 正确 的 某 些 值 时 ， 
它们 对 于 你 自己 的 目的 是 更 有 用 的 修改 的 例子 。 该 琅 数 一 般 足 够 任意 的 表 使 用 ， 但 是 你 在 创 
建 一 个 触发 器 时 必须 指定 表 和 字段 名 (正如 下 面 描述 ) 。 


下 面 描述 的 每 一 组 档 数 都 是 作为 一 个 独立 可 安装 的 扩展 提供 的 。 


F.34.1. refint 一 实现 参照 完整 性 的 函数 


check_primary_key() 和 check_foreign_key() 用 来 检查 外 键 约束 。 (这 个 功能 早已 被 内 置 的 
外 键 机 制 取 代 ， 但 是 该 模块 作为 一 个 例子 仍然 是 有 用 的 。) 


check_primary_key() 检查 引用 表 。 为 了 使 用 该 娘 数 ， 创 建 一 个 BEFORE INSERT OR UPDATE f 

器 ， 该 触发 器 在 一 个 表 上 使 用 这 个 函数 引用 另 一 个 表 。 作为 触发 器 参数 指定 : 来 自 外 键 的 
ee 被 引用 的 表 名 ， 来 自主 /唯一 键 的 被 引用 表 的 字段 名 。 要 处理 多 个 外 键 ， 为 
每 个 引用 创建 一 个 外 键 。 


check_foreign_key() 检查 被 引用 的 表 。 为 了 使 用 该 落 数 ， 创 建 一 

BEFORE DELETE OR UPDATE 触发 器 ， 该 触发 器 在 一 个 表 上 使 用 这 个 画 ore VE 
为 触发 器 参数 指定 : ARRUA WTE ES ARRE, URAM—TSIA NATE 

( cascade 一 删除 引用 行 ， restrict 一 如 果 引 用 键 退 出 则 退出 事务 ， setnull — 设置 引 
用 键 字段 为 空 ) ， 来 自主 /唯一 键 的 被 触发 表 的 字段 名 ， 然 后 是 引用 表 名 和 字段 名 (重复 引用 
表 的 次 数 和 第 一 个 参数 指定 的 一 样 多 ) 。 请 注意 ， 主 / 唯 一 键 字段 应 该 标记 为 NOT NULL 并 且 
应 该 有 一 个 唯一 索引 。 


示例 在 refint.example o 


F.34.2. timetravel 一 实现 时 间 行 程 的 函数 


很 久 以 前 ，PostgreSQL 有 一 个 内 置 的 时 间 行 程 特性 ， 保持 为 每 个 元 组 插入 和 删除 时 间 。 这 个 
特性 可 以 使 用 这 些 画 数 模 仿 。 要 使 用 这 些 函 数 ， 必 须 添加 两 个 abstime 类 型 的 字段 到 一 个 
表 ， 用 来 存储 一 个 元 组 插入 (start_date) 和 更 改 /删除 (stop_date) 的 日 期 : 


CREATE TABLE mytab ( 


start_date abstime, 
stop_date abstime 


该 字段 可 以 随 你 喜欢 任意 命名 ， 但 是 在 这 个 讨论 中 我 们 将 它们 称 作 start_date 和 stop_date。 


当 插入 一 个 新 行 时 ，start_date 通 常设 置 为 当前 时 间 ，stop_date 设 置 为 infinity. 如 果 插 入 
的 数据 在 这 些 字 段 中 包含 空 ， 那 么 触发 器 将 自动 的 替换 这 些 值 。 通常 只 应 该 在 重新 加 载 转 储 
的 数据 时 在 这 些 字 段 中 明确 的 插入 非 空 数据 。 


stop_date 等 于 infinity 的 元 组 是 "现在 有 效 的 "， 可 以 修改 。 带 有 限定 的 stop_date 的 元 组 不 
能 再 被 修改 一 触发 器 将 阻止 修改 。 《如果 需 要 修改 ， 可 以 像 下 面 显示 的 那样 关闭 时 间 行 
程 。) 


对 于 可 修改 的 行 ， 在 更 新 时 只 有 被 更 新 的 元 组 内 的 stop_date 被 更 改 (为 当前 时 间 ) 并 且 插 入 
一 个 带 有 修改 数据 的 新 的 元 组 。 在 这 个 新 元 组 内 的 Start_date 设 置 为 当前 时 间 ， stop_date 设 
置 为 infinity o 


删除 并 不 实际 删除 元 组 ， 只 是 设置 它 的 stop_date 为 当前 时 间 。 


要 查询 元 组 的 "现在 有 效 "， 在 查询 的 WHERE 条 件 中 包括 stop_date = 'infinity' o (你 可 能 
希望 体现 到 一 个 视图 中 。) 相似 的 ， 你 可 以 用 合适 的 start _ date 和 stop_date 条 件 查询 任意 过 
去 时 间 的 元 组 有 效 性 。 


timetravel() 是 支持 这 个 行为 的 常规 触发 器 画 数 。 在 每 个 时 间 行 程 表 上 创建 一 个 使 用 这 个 函 
数 的 BEFORE INSERT OR UPDATE OR DELETE 触发 器 。 指定 两 个 触发 器 参数 : start_date 和 
stop_date 字 段 的 实际 名 字 。 可 选 的 ， 你 可 以 再 指定 一 到 三 个 参数 ， 这 些 参数 必须 引用 类 型 
为 text 的 字段 。 触发 器 将 存储 当前 用 户 名 到 这 些 字段 中 ， 在 INSERT 期 间 存 储 到 第 一 个 中 ， 
在 UPDATE 期 间 存 储 到 第 二 个 中 ， 在 DELETE 期 间 存 储 到 第 三 个 中 。 


set_timetravel() 人 允许 为 一 个 表 打 开 或 关闭 时 间 行 程 。 set_timetravel('mytab'，1) 将 为 

表 mytab 返回 TT ON。 set_timetravel('mytab', 0) 将 为 表 mytab 返回 TT OFF. 两 种 情况 下 
都 报道 老 的 状态 。 当 TT 为 off 是 ， 可 以 自由 修改 start_date 和 stop_date 字 段 。 请 注意 ，on/off 状 
态 对 于 当前 数据 库 会 话 来 说 是 局 部 的 一 新 的 会 话 将 对 于 所 有 表 来 说 总 是 以 TT ON 开始 。 


get_timetravel() 为 一 个 表 返 回 TT 的 状态 而 不 会 改变 这 个 表 。 


在 timetravel.example 中 有 一 个 示例 。 


F.34.3. autoinc — 自 增 字段 函数 


autoinc() 是 一 个 存储 序列 的 下 一 个 值 到 一 个 整数 字段 的 触发 器 。 与 内 置 的 "序列 字段 "特性 有 
些 重 县 ， 但 是 并 不 相同 : autoinc() 在 插入 时 重 写 蔡 代 一 个 不 同 的 字段 值 的 尝试 ， 并 且 可 选 
BY, 它 也 可 以 用 于 在 更 新 时 增加 字段 。 

要 使 用 该 加 数 ， 创 建 一 个 使 用 该 琅 数 的 BEFORE INSERT (或 者 可 选择 

的 BEFORE INSERT OR UPDATE ) 触发 器 。 指定 两 个 触发 器 参数 : 要 被 修改 的 整数 字段 的 名 字 ， 
和 将 要 填充 值 的 序列 对 象 名 。 (实际 上 ， 可 以 指定 任意 数量 的 这 样 的 名 字 对 ， 如 果 想 要 更 新 
多 个 自 增 字段 。) 


在 autoinc.example 中 有 一 个 示例 。 


F.34.4. insert_username 一 追踪 谁 改 交 了 表 的 函数 


insert_username() 是 一 个 存储 当前 用 户 名 到 一 个 文本 字段 的 触发 器 。 这 对 于 追踪 谁 最 后 修改 


了 表 中 指定 的 行 是 有 用 的 。 
要 使 用 该 男 数 ， 创 建 一 个 使 用 该 函数 的 BEFORE INSERT 和 /或 uppATE 触发 器 。 
参数 : 要 修改 的 文本 字段 名 。 


指定 一 个 触发 器 


在 insert_username.example 中 有 一 个 示例 。 


F.34.5. moddatetime 一 追踪 最 后 修改 时 间 的 函数 
moddatetime() 是 一 个 存储 当前 时 间 到 timestamp 字段 的 触发 器 。 这 对 于 追踪 一 个 表 中 指定 
的 行 的 最 后 修改 时 间 是 有 用 的 。 

要 使 用 该 男 数 ， 创 建 一 个 使 用 这 个 函数 的 BEFORE UPDATE 触发 器 。 指定 一 个 触发 器 参数 : 要 


修改 的 字段 名 。 该 字段 必须 是 timestamp 或 timestamp with time zone 类 型 。 


在 moddatetime.example 中 有 一 个 示例 。 


F.35. sslinfo 


sslinfo 模块 提供 关于 连接 到 PostgreSQL 时 当前 客户 端 提供 的 SSL 认 证 的 信息 。 如 果 当 前 连 
接 没有 使 用 SSL， 那么 该 模块 是 无 用 的 (大 部 分 函数 将 返回 NULL) 。 


这 个 扩展 不 会 建立 ， 除 非 安装 时 配置 带 有 --with-openssl o 


F.35.1. 提供 的 函数 


ssl_is_used() returns boolean 


如 果 当 前 到 服务 器 的 连接 使 用 了 SSL 则 返回 TRUE， 否 则 返回 FALSE。 


ssl_version() returns text 


返回 SSL 连 接 使 用 的 协议 名 (如 SSLv2，SSLv3， 或 TLSv1) 


ssl_cipher() returns text 


返回 SSL 连 接 使 用 的 密码 名 称 (如 DHE-RSA-AES256-SHA) 。 

ssl_client_cert_present() returns boolean 

如 果 当 前 客户 端 提 供 了 一 个 有 效 的 SSL 客 户 端 证 书 到 服务 器 则 返回 TRUE， 否 则 返回 FALSE。 
(服务 器 可 能 或 可 能 没有 被 配置 为 需要 一 个 客户 端 证 书 。) 

ssl_client_serial() returns numeric 

返回 当前 客 户 端 证 书 的 序列 号 。 证 书 序列 号 和 证 书 发 行者 的 组 合 保证 为 唯一 的 标识 一 个 证 书 
(但 不 是 它 的 所 有 者 一 所 有 者 应 该 定期 的 改变 它 的 秘 钥 ， 并 从 发 行者 处 获得 新 的 证 书 。) 
所 以 ， 如 果 你 运行 自己 的 CA 并 且 只 人 允许 来 自 这 个 CA 的 证 书 被 服务 器 接受 ， 那么 序列 编号 是 
识别 一 个 用 户 最 可 靠 (虽然 不 是 很 帮助 记忆 ) 的 手段 。 

ssl_client_dn() returns text 

返回 当前 客户 端 认 证 的 全 部 科目 ， 转 换 字符 数据 为 当前 数据 库 编码 。 假设 如 果 在 证 书 名 里 使 
用 非 ASCII 字 符 ， 那 么 数据 库 也 可 以 表示 这 些 字符 。 如 果 数 据 库 使 用 SQL_ASCII 编 码 ， 那 么 
名 字 中 的 非 ASCll 字 符 将 用 UTF-8 序 列表 示 。 

结果 看 起 来 像 /CN=Somebody /C=Some country/0=Some organization o 

ssl_issuer_dn() returns text 

返回 当前 客户 端 认 证 的 全 部 发 行者 名 字 ， 转 换 字符 数据 为 当前 数据 库 编码 。 编码 转换 的 义理 
和 ssl_client_dn 相同 。 


这 个 函数 的 返回 值 的 组 合 和 证 书 序列 编号 唯一 的 标识 该 证 书 。 


只 有 你 有 多 于 一 个 信任 的 CA 证 书 在 服务 器 的 root.crt 文件 时 ， 或 者 如 果 这 个 CA 已 经 发 布 了 
一 些 中 级 证 书 授权 证 书 ， 这 个 函数 才 真 正 的 有 用 。 


ssl_client_dn_field(fieldname text) returns text 


这 个 事 数 返回 证 书 主 题 中 的 指定 字段 值 ， 或 者 如 果 该 字段 不 存在 则 为 NULL。 为 字符 串 常量 的 
字段 名 转换 为 使 用 OpenSSL 对 象 数 据 库 的 ASN1 对 象 标 识 符 。 下 列 的 值 是 可 接受 的 : 


commonName (alias CN) 
surname (alias SN) 

name 

givenName (alias GN) 
countryName (alias C) 
localityName (alias L) 
stateOrProvinceName (alias ST) 
organizationName (alias 0) 
organizationUnitName (alias OU) 
title 

description 

initials 

postalCode 

streetAddress 
generationQualifier 
description 

dnQualifier 
x500Uniqueldentifier 
pseudonym 

role 

emailAddress 


所 有 这 些 字段 都 是 可 选 的， 除了 commonName 。 它 完全 取决 于 你 的 证 书 的 政策 将 包括 或 不 包 
括 。 不 过 ， 这 些 字段 的 含义 严格 的 由 X.500 和 X.509 标 准 定义 ， 所 以 不 能 任意 分 配 它们 的 含 
Slo 


ssl_issuer_field(fieldname text) returns text 


和 ssl_client_dn_field 相同 ， 除 了 是 证 书 发 行者 而 不 是 证 书 主题 。 


F.35.2. 作者 


Victor Wagner &lt;[vitus@cryptocom.ru](mailto:vitus@cryptocom.ru)&gt; , Cryptocom LTD 


Cryptocom OpenSSL 开 发 团队 的 E- 


Mail : &lt;[openssl@cryptocom.ru](mailto:openssl@cryptocom.ru)&gt; 


F.36. tablefunc 


tablefun 扩展 包括 了 返回 表 记 录 ( 即 :多 行 ) 的 一 系列 函数 . 这 些 函 数 在 数据 记录 的 义理 和 运用 
CHREST ek 中 是 非常 有 用 的 


F.36.1. KAIR 


Table F-28 列 出 了 tablefunc 扩展 提供 的 函数 


Table F-28. tablefunc 2X 


normal_rand(int numvals, float8 mean, float8 stddev) 


crosstab(text sql) 


crosstab N (text sql) 


crosstab(text source_sql, text category_sql) 


crosstab(text sql, int N) 
connectby(text relname, text keyid_fld, text parent_keyid_fld [, text orderby_fld ], tex 


F.36.1.1. normal_rand 


normal_rand(int numvals, float8 mean, float8 stddev) returns setof floats 


normal 函 数 返回 一 系列 正 态 分 布 的 随机 值 (高 斯 分 布 ) 
numvals 是 这 个 函数 返回 值 的 数目 ,mean 时 正 态 分 布 的 平均 值 ,stddev 是 正 态 分 布 的 方差 
例如 :这 个 查询 返回 1000 个 均值 为 5, 方 差 为 3 的 值 


test=# SELECT * FROM normal_rand(1000, 5, 3); 
normal_rand 
1.56556322244898 
9.10040991424657 
5.36957140345079 
-0.369151492880995 
0.283600703686639 


4.82992125404908 

9.71308014517282 

2 . 49639286969028 
(1000 rows) 


F.36.1.2. crosstab(text) 


crosstab(text sql) 
crosstab(text sql, int N) 


crosstabE žok oO -DZER REAREA AAFAA, AA: 我 们 已 有 数据 如 
F: 

row1 valii 

row1 val12 


row val13 


row2 val21 


row2 val22 
row2 val23 


而 我 们 想 要 按 如 下 输出 : 


row val11 val12 val13 
row2 val21 val22 val23 


crosstab ii 2X (# FA —TSSQL& iF HER RLD ERRI ER 


sql 参 数 用 来 产生 一 组 数据 源 ,这 个 语句 必须 返回 1 个 row_name 列 ,一 个 category 列 ,一 个 value 列 . 
N 是 一 个 废弃 的 参数 ， 


例如 ,一 个 查询 需要 产生 如 下 形式 的 数据 : 


row_name cat value 


pal ae pm Rees eee ae ee ee 
row cat1 vali 
row cat2 val2 
row cat3 val3 
row cat4 val4 
row2 cat1 val5 
row2 cat2 val6 
row2 cat3 val7 
row2 cat4 val8 


crosstab 豆 数 返 回 一 系列 记录 ,输出 列 的 实际 名 字 和 类 型 必须 定义 在 FROM 字 句 中 ,例如 |: 


SELECT * FROM crosstab('...') AS ct(row_name text, category_1 text, category_2 text); 


This example produces a set something like: 


<== value columns ==> 
row_name category_1 category_2 
+ 


FROM 字句 必须 定义 一 个 row_name( 和 你 查询 返回 第 一 列 具 有 相同 数据 类 型 ) 列 和 一 个 和 N 个 
value 列 (和 查询 返回 第 三 列 的 类 型 匹配 ). 由 你 来 定义 输出 列 的 名 字 和 数量 . 

crosstab 画 数 对 于 有 具有 相同 row_name 的 一 组 数据 返回 一 行 . 它 使 用 这 些 行 从 左 到 右 填 充 输出 
到 二 维 表 . 如 果 这 组 数据 少 于 输出 的 列 数 , 则 使 用 null 填 充 , 如 果 有 多 余 的 行 数 , 则 额外 的 输入 将 
被 忽略 

SQL 查 询 应 该 一 直 指 定 ORDER BY1,2 来 确保 输入 的 数据 时 有 序 的 , 即 , 具有 相同 row_name 的 
行 是 连续 的 并 且 在 一 行 的 输出 中 是 有 序 的 .注意 crosstab 不 关注 第 二 列 查询 的 结果 ; 它 只 是 用 来 
保证 第 三 列 的 值 在 输出 中 的 排序 . 


这 是 一 个 完整 的 例子 : 


CREATE TABLE ct(id SERIAL, rowid TEXT, attribute TEXT, value TEXT); 

INSERT INTO ct(rowid, attribute, value) VALUES('test1i', 'att1', 'val1'); 
INSERT INTO ct(rowid, attribute, value) VALUES('test1i', 'att2', 'val2'); 
INSERT INTO ct(rowid, attribute, value) VALUES('test1i', 'att3', 'val3'); 
INSERT INTO ct(rowid, attribute, value) VALUES('test1i', 'att4', 'val4'); 
INSERT INTO ct(rowid, attribute, value) VALUES('test2', 'att1', 'val5'); 
INSERT INTO ct(rowid, attribute, value) VALUES('test2', 'att2', 'val6'); 
INSERT INTO ct(rowid, attribute, value) VALUES('test2', 'att3','val7'); 
INSERT INTO ct(rowid, attribute, value) VALUES('test2', 'att4', 'val8'); 


SELECT * 
FROM crosstab( 
"select rowid, attribute, value 
from ct 
where attribute = ''att2'' or attribute = ''att3'' 
order by 1,2') 
AS ct(row_name text, category_1 text, category_2 text, category_3 text); 


row_name | category_1 | category 2 | category_3 
es Poe 
test1 | val2 | val3 | 
test2 | val6 | val7 | 


A Lit EL —~ScrosstabW MAE LES KH MSH RRS REFROM 字句 中 制定 输 
出 列 的 值 和 类 型 .这 将 在 下 一 节 中 讲解 .另外 一 种 方式 是 在 定义 视图 的 FROM 字句 中 制定 . 


F.36.1.3. crosstab N (text) 


crosstab_N_ (text sql) 


crosstabN Ee crosstab by By Ht 38 BY — PF ZEB FBSELECT & 344 (a LAA HB EUR AD 
%ž Æ tablefunc3 RÆ l T crosstab2,crosstab3,crosstab4 NAH IIAY KMS. 


CREATE TYPE tablefunc_crosstab_N AS ( 
row_name TEXT, 
category_1 TEXT, 
category_2 TEXT, 


category_N TEXT 
); 


当 输 入 查询 返回 text 类 型 的 row_name 并 且 你 有 2,3,4 列 输出 值 时 你 可 以 直接 使 用 这 些 画 数 .其 
他 情况 需要 像 上 面 的 定义 crosstab 男 数 一 样 . 


例如 ,上 面 的 例子 也 可 以 像 下 面 一 样 运行 . 


SELECT * 
FROM crosstab3( 
"select rowid, attribute, value 
from ct 
where attribute = ''att2'' or attribute = ''att3'' 
order by 1,2'); 


A ERRAKORE A T SONAR ARG LAR a crosstabbi NE L RBBB 型 的 BRAK. x 
里 有 两 种 方法 来 实现 


。 定义 一 个 复合 类 型 的 输出 列 类 似 于 contrib/tablefunc/tablefunc--1.0.sql 中 的 例子 . 按照 
crosstab 豆 数 定义 的 方式 ,定义 一 个 唯一 函数 名 来 接收 一 个 text 类 型 的 参数 ,返回 setof 
your_type_name. 例如 ,你 的 数据 源 返回 一 个 text 类 型 的 row_name,values 字 段 为 float8 类 
型 ,并 且 你 需要 5 列 : 


CREATE TYPE my_crosstab_float8_5 cols AS ( 
my_row_name text, 
my_category_1 floats, 
my_category_2 floats, 
my_category_3 floats, 
my_category_4 floats, 
my_category_5 floats 


); 


CREATE OR REPLACE FUNCTION crosstab_float8_5 cols(text) 
RETURNS setof my_crosstab_float8_5 cols 
AS '$libdir/tablefunc', 'crosstab' LANGUAGE C STABLE STRICT; 


e 使 用 OUT 参 数 定义 返回 值 类 型 .上 面 的 例子 可 以 像 下 面 定 义 : 


CREATE OR REPLACE FUNCTION crosstab_float8_5_cols( 

IN text, 
OUT my_row_name text, 
OUT my_category_1 floats, 
OUT my_category_2 floats, 
OUT my_category_3 floats, 
OUT my_category_4 floats, 
OUT my_category_5 floats) 

RETURNS setof record 

AS '$libdir/tablefunc', 'crosstab' LANGUAGE C STABLE STRICT; 


F.36.1.4. crosstab(text, text) 


crosstab(text source_sql, text category_sql) 


ea ae 半数 的 主要 限制 是 处 理 一 组 记录 时 插入 每 一 个 值 到 第 一 个 列 中 . 如 果 你 想 插 
值 到 指定 的 数据 属性 中 ,一 些 数据 可 能 没有 该 属性 的 值 ,这 样 它 将 不 能 很 好 的 义理 .两 个 参数 
Aviad 过 提供 一 个 指定 的 属性 列表 能 较 好 的 处 理 该 类 问题 . 


source_sql 语 句 返 回 一 组 数据 源 .这 个 语句 返回 一 个 row_name 列 ,一 个 category 列 ,和 一 个 value 
列 , 它 也 可 能 有 一 个 或 多 个 extra 列 .row_name 必 须 是 第 一 列 .category 和 value 列 必须 是 最 后 两 
列 .任何 在 在 row_name 和 category 中 间 的 列 被 认为 时 extra 列 . 有 相同 row_name 的 extra 列 被 认 
为 是 相同 的 . 


例如 ,source_sql 可 能 返回 下 面 的 一 系列 记录 : 


SELECT row_name, extra_col, cat, value FROM foo ORDER BY 1; 


row_name extra_col cat value 

GES DOSE e E E E 
row1 extral catı vali 
row extral cat2 val2 
row extral cat4 val4 
row2 extra2 catı val5 
row2 extra2 cat2 val6 
row2 extra2 cat3 val7 
row2 extra2 cat4 val8 


category_sql 返 回 categories 记 录 . 这 个 语句 只 能 返回 一 列 . 它 必 须 最 少 返 回 一 行 ,否则 会 报错 . 它 
也 不 能 返回 重复 的 值 ,否则 会 报错 .category_sql 必 须 如 下 面 : 


SELECT DISTINCT cat FROM foo ORDER BY 1; 
cat 


crosstab 28 E]— Wiz z, NBA A k E A EL HESELECTHBYFROM A. 


SELECT * FROM crosstab('...', '...') 
AS ct(row_name text, extra text, cati text, cat2 text, cat3 text, cat4 text); 


这 将 返回 如 下 记录 : 
<== Value columns ==> 
row_name extra catı cat2 cat3 cat4 
Sees ASR Pee e a os eae Seabee Sct 
row extrai vall val2 val4 
row2 extra2 val5 val6 val7 val8 


FROM 字 句 必须 定义 类 型 匹配 的 适当 数量 的 列 .如 果 在 source_sql 中 返回 N 列 ,前 面 的 N-2 列 必 
须 匹 配 前 N-2 列 . 剩 下 的 列 必 须 和 source_sql 返 回 的 列 类 型 匹配 ,并 且 返 回 的 行 数 需要 和 
category_sql 返 回 的 相同 . 


crosstab 本 数 对 于 具有 相同 row_name 的 一 组 连续 记录 返回 一 行 输出 .复制 这 组 记录 的 第 一 行 
到 row_name 和 extra 列 .记录 中 匹配 category 的 值 填 充 到 value 列 中 . 如 果 一 行 的 category 不 能 匹 
配 任何 category_sql 返 回 的 结果 , 它 的 值 将 被 忽略 . 如 果 输 入 行 中 的 category 不 匹配 任何 
category_sql 的 返回 结果 ,这 一 个 输出 列 将 被 填充 为 null. 


实际 上 source_sql 一 直 使 用 ORDER BY 1 去 确保 具有 相同 row_name 的 行 连续 .然而 ， 
categories 排 序 不 是 必须 . 它 实际 上 时 为 了 保证 匹配 category_sql 的 记录 有 序 . 


这 有 两 个 完整 的 例子 : 


create table sales(year int, month int, qty int); 
insert into sales values(2007, 1, 1000); 

insert into sales values(2007, 2, 1500); 

insert into sales values(2007, 7, 500); 

insert into sales values(2007, 11, 1500); 

insert into sales values(2007, 12, 2000); 

insert into sales values(2008, 1, 1000); 


select * from crosstab( 

"select year, month, qty from sales order by 1', 

"select m from generate_series(1,12) m' 
) as ( 

year int, 

"Jan" int, 

"Feb" int, 

"Mar" int, 

"Apr" int, 

"May" int, 

"Jun" int, 

WIE unite, 

"Aug" int, 

"Sep" int, 

"Oct" int, 

"Nov" int, 

"Dec" int 


year | Jan | Feb | Mar | Apr | May | Jun | Jul | Aug | Sep | Oct | Nov | Dec 


2007 | 1000 | 1500 | | | | | 500 | | | | 1500 | 2000 
2008 | 1000 | | | | | | | | | | | 


CREATE TABLE cth(rowid text, rowdt timestamp, attribute text, val text); 

INSERT INTO cth VALUES('test1', '01 March 2003', 'temperature', '42'); 

INSERT INTO cth VALUES('test1', '01 March 2003', 'test_result', 'PASS'); 

INSERT INTO cth VALUES('test1', '01 March 2003', 'volts', '2.6987'); 

INSERT INTO cth VALUES('test2','02 March 2003', 'temperature', '53'); 

INSERT INTO cth VALUES('test2','02 March 2003', 'test_result', 'FAIL'); 

INSERT INTO cth VALUES('test2', '02 March 2003', 'test_startdate','01 March 2003'); 
INSERT INTO cth VALUES('test2', '02 March 2003', 'volts', '3.1234'); 


SELECT * FROM crosstab 


"SELECT rowid, rowdt, attribute, val FROM cth ORDER BY 1', 
"SELECT DISTINCT attribute FROM cth ORDER BY 1' 


) 
AS 


( 
rowid text, 
rowdt timestamp, 
temperature int4, 
test_result text, 
test_startdate timestamp, 
volts floats 


rowid | rowdt | temperature | test_result | test_startdate 
testi | Sat Mar 01 00:00:00 2003 | 42 | PASS 


test2 | Sun Mar 02 00:00:00 2003 | 53 | FAIL | Sat Mar 01 00:00:00 2003 
(2 rows) 


SSS 


你 能 预定 义 一 个 函数 来 避免 在 每 一 个 查询 中 都 指定 输出 列 的 名 字 和 类 型 . 查看 前 面部 分 的 例子 . 
构成 这 种 形式 的 crosstab 被 命名 为 crosstab_hash. 





F.36.1.5. connectby 


connectby(text relname, text keyid_fld, text parent_keyid_fld 
[, text orderby_fld ], text start_with, int max_depth 
[, text branch_delim ]) 


connectby 画 数 返 回 一 个 表 的 分 层 显 示 . 这 个 表 必 须 有 一 个 键 值 去 唯一 的 标识 一 行 , 并 且 有 一 个 
父 节 点 键 值 去 关联 每 一 行 .connectby 能 从 任意 一 行列 出 一 个 子 树 
Table F-29 explains the parameters. 


Table F-29. connectby 参数 


relname RANA S 

keyid_fld 键 值 的 名 字 
parent_keyid_fld 父 节 点 键 值 的 名 字 
orderby_f1d 排序 兄弟 的 字段 名 字 
start _ with 键 值 开始 值 

max_depth 最 大 深度 ,0 表示 深度 无 限 
branch_delim 每 个 分 支 的 独立 键 值 


键 值 和 父 节点 键 值 可 以 是 相同 的 任意 类 型 ,注意 start_with 必 须 是 一 个 字符 串 , 无 论 key 的 类 型 . 


connectby 豆 数 返 回 一 系列 记录 ,所 以 输出 列 的 名 字 和 类 型 必须 定义 在 SELECT 的 FROM 字 句 
中 ,例如 : 


SELECT * FROM connectby('connectby_tree', 'keyid', 'parent_keyid', 'pos', 'row2', ©, '~') 
AS t(keyid text, parent_keyid text, level int, branch text, pos int); 


er ee ee a ae | 
输出 的 前 两 列 做 为 现在 行 的 键 值 和 父 节 点 的 键 值 ;他 们 必须 和 表 的 键 值 类 型 匹配 .第 三 列 为 节点 
在 树 中 的 深度 必须 为 整形 .如 果 给 出 branch_delim 参 数 ,下 一 列 是 一 个 text 类 型 的 分 支 列 ,最 后 如 
果 给 出 orderby_fld 参 数 最 后 一 列 是 一 个 整形 的 自 增值 . 

branch 列 给 出 键 值 到 达 当 前 行 的 路 径 . 键 值 被 branch_delim 字 段 给 出 的 字符 分 割 开 . 如 果 不 想 显 
示 分 支 , 在 每 一 个 输出 列表 中 忽略 branch_delim 和 branch 参 数 . 


如 果 想 要 排序 同一 个 父 节 点 的 兄弟 节点 ,指定 orderby_fld 参 数 来 指定 需要 排序 兄弟 节点 的 字段 . 
如 果 orderby_fld 被 指定 ,输出 列 一 定 包括 一 个 整形 自 增 的 列 . 


表 和 字段 值 的 参数 被 connectby 函 数 自动 的 复制 到 查询 语句 中 .因此 如 果 名 字 包 含 特殊 字符 或 
者 混合 字段 请 使 用 "", 你 可 能 也 需要 使 用 模式 来 限定 表 名 . 


在 大 的 表 中 ,除非 在 父 节 点 的 键 值 上 有 一 个 索引 ,否则 效率 将 会 很 差 . 


在 键 值 中 不 出 现 branch_delim 参 数 是 很 重要 的 ,否则 connectby 可 能 错误 的 报告 一 个 死 循 环 的 错 
误 . 如 果 不 使 用 branch_delim 参 数 ,为 了 递归 检查 将 使 用 ~ 来 作为 默认 值 . 


下 面 是 一 个 例子 : 


CREATE TABLE connectby_tree(keyid text, parent_keyid text, pos int); 


INSERT INTO connectby_tree VALUES('row1i',NULL, 0); 

INSERT INTO connectby_tree VALUES('row2', 'row1', 0); 
INSERT INTO connectby_tree VALUES('row3', 'row1', 0); 
INSERT INTO connectby_tree VALUES('row4', 'row2', 1); 
INSERT INTO connectby_tree VALUES('row5', 'row2', 0); 
INSERT INTO connectby_tree VALUES('row6', 'row4', ©); 
INSERT INTO connectby_tree VALUES('row7', 'row3', 0); 
INSERT INTO connectby_tree VALUES('row8', 'row6', ©); 
INSERT INTO connectby_tree VALUES('row9', 'row5', 0); 


-- with branch, without orderby_fld (order of results is not guaranteed) 


SELECT * FROM connectby('connectby_tree', 'keyid', 'parent_keyid', 'row2', ©, '~') 
AS t(keyid text, parent_keyid text, level int, branch text); 
keyid | parent_keyid | level | branch 

Staeeee 站 
row2 | | © | row2 
row4 | row2 | 1 | row2~row4 
row6 | row4 | 2 | row2~row4~row6 
row8 | row6 | 3 | row2~row4~row6~row8s 
row5 | row2 | 1 | row2~row5 
row9 | row5 | 2 | row2~row5~row9 

(6 rows) 


-- without branch, without orderby_fld (order of results is not guaranteed) 
SELECT * FROM connectby('connectby_tree', 'keyid', 'parent_keyid', 'row2', 0) 
AS t(keyid text, parent_keyid text, level int); 

keyid | parent_keyid | level 


a 区 
row2 | | 0 
row4 | row2 | 1 
row6 | row4 | 2 
row8 | row6 | 3 
row5 | row2 | 1 
row9 | row5 | 2 

(6 rows) 


-- with branch, with orderby_fld (notice that row5 comes before row4) 


SELECT * FROM connectby('connectby_tree', 'keyid', 'parent_keyid', 'pos', 'row2', ©, '~') 
AS t(keyid text, parent_keyid text, level int, branch text, pos int); 
keyid | parent_keyid | level | branch | pos 

本 (bo Gor ceeoSeen sation Ss Hees see Sper eases ee se eee ose 
row2 | | © | row2 | 1 
row5 | row2 | 1 | row2~row5 | 2 
row9 | row5 | 2 | row2~row5~row9 | 3 
row4 | row2 | 1 | row2~row4 | 4 
row6 | row4 | 2 | row2~row4~row6 | 5 
row8 | row6 | 3 | row2~row4~row6~row8 | 6 

(6 rows) 


-- without branch, with orderby_fld (notice that row5 comes before row4) 
SELECT * FROM connectby('connectby_tree', 'keyid', 'parent_keyid', 'pos', 'row2', 0) 
AS t(keyid text, parent_keyid text, level int, pos int); 

keyid | parent_keyid | level | pos 


Saacan deed pa Rose oH maadhs soe Getbooaae 
row2 | | © | 1 
row5 | row2 | 1 | 2 
row9 | row5 | 2 | 3 
row4 | row2 | 1 | 4 
row6 | row4 | 2 | 5 
row8 | row6 | 3 | 6 

(6 rows) 


F.36.2. Author 


PostgreSQL 中 文 文档 9.3 


Joe Conway 


F.36. tablefunc 3319 


F.37. tecn 


The tcn module provides a trigger function that notifies listeners of changes to any table 
on which it is attached. It must be used as an AFTER trigger FOR EACH ROW . 


Only one parameter may be supplied to the function in a CREATE TRIGGER Statement, and 
that is optional. If supplied it will be used for the channel name for the notifications. If omitted 
tcn will be used for the channel name. 


The payload of the notifications consists of the table name, a letter to indicate which type of 
operation was performed, and column name/value pairs for primary key columns. Each part 
is separated from the next by a comma. For ease of parsing using regular expressions, table 
and column names are always wrapped in double quotes, and data values are always 
wrapped in single quotes. Embedded quotes are doubled. 


A brief example of using the extension follows. 


test=# create table tcndata 


test-# ( 

test (# a int not null, 
test (# b date not null, 
test (# C text, 

test (# primary key (a, b) 
test (# He 


CREATE TABLE 

test=# create trigger tcndata_tcn_trigger 

test-# after insert or update or delete on tcndata 

test-# for each row execute procedure triggered_change_notification(); 
CREATE TRIGGER 

test=# listen tcn; 


LISTEN 

test=# insert into tcndata values (1, date '2012-12-22', 'one'), 
test-# (1, date '2012-12-23', 'another'), 
test-# (2, date '2012-12-23', 'two'); 
INSERT 0 3 


Asynchronous notification "tcn" with payload ""tcndata",I,"a"='1',"b"='2012-12-22'" recei 
Asynchronous notification "tcn" with payload ""tcndata",I,"a"='1',"b"='2012-12-23'" recei 
Asynchronous notification "tcn" with payload ""tcndata",I,"a"='2',"b"='2012-12-23'" recei 
test=# update tcndata set c = 'uno' where a = 1; 

UPDATE 2 

Asynchronous notification "tcn" with payload ""tcndata",U,"a"='1',"b"='2012-12-22'" recei 
Asynchronous notification "tcn" with payload ""tcndata",U,"a"='1',"b"='2012-12-23'" recei 
test=# delete from tcndata where a = 1 and b = date '2012-12-22'; 

DELETE 1 

Asynchronous notification "tcn" with payload ""tcndata",D,"a"='1',"b"='2012-12-22'" recei 


国王 = 于 





F.38. test_parser 

test_parser 是 一 个 自 定 义 的 全 文 搜索 解析 器 的 例子 。 它 不 做 特别 有 用 的 工作 ， 但 是 可 以 作 
为 开发 一 个 自己 的 解析 器 的 起 点 。 

test_parser 识别 以 空格 分 隔 的 单词 ， 并 且 返 回 两 种 使 牌 类 型 : 


mydb=# SELECT * FROM ts_token_type('testparser'); 
tokid | alias | description 
ay sen ean Ca eines Sie Sens ern eee 

3 | word | Word 


12 | blank | Space symbols 
(2 rows) 


这 些 合 牌 数字 被 选择 来 兼容 默认 的 解析 器 编号 。 这 人 允许 我 们 可 以 使 用 headline() W, Mim 
保持 例子 的 简单 。 


F.38.1. 用 法 


安装 test_parser 扩展 ， 创 建 一 个 文本 搜索 的 解析 器 testparser。 它 没有 用 户 可 配置 参数 。 


你 可 以 像 下 面 的 例子 这 样 测试 该 解析 器 ， 


mydb=# SELECT * FROM ts_parse('testparser', 'That''s my first own parser'); 
tokid | token 


pea ne open ep pees 
3 | That's 
12 | 
3 | my 
12 | 
3 | first 
12 | 
3 | own 
12 | 
3 | parser 


实际 使 用 需要 配置 一 个 文本 搜索 配置 项 来 使 用 这 个 解析 器 。 例 如 ， 


mydb=# CREATE TEXT SEARCH CONFIGURATION testcfg ( PARSER = testparser ); 
CREATE TEXT SEARCH CONFIGURATION 


mydb=# ALTER TEXT SEARCH CONFIGURATION testcfg 
mydb-# ADD MAPPING FOR word WITH english_stem; 
ALTER TEXT SEARCH CONFIGURATION 


mydb=# SELECT to_tsvector('testcfg', 'That''s my first own parser'); 
to_tsvector 
'that':1 'first':3 'parser':5 
(1 row) 


mydb=# SELECT ts_headline('testcfg', 'Supernovae stars are the brightest phenomena in gal 
mydb(# to_tsquery('testcfg', 'star')); 
ts_headline 
Supernovae <b>stars</b> are the brightest phenomena in galaxies 
(1 row) 


sd 





F.39. tsearch2 


The tsearch2 module provides backwards-compatible text search functionality for 
applications that used tsearch2 before text searching was integrated into core PostgreSQL 
in release 8.3. 


F.39.1. Portability Issues 


Although the built-in text search features were based on tsearch2 and are largely similar to 
it, there are numerous small differences that will create portability issues for existing 
applications: 


e Some functions' names were changed, for example rank to ts_rank . The 
replacement tsearch2 module provides aliases having the old names. 


e The built-in text search data types and functions all exist within the system schema 
pg_catalog . In an installation using tsearch2, these objects would usually have been in 
the public schema, though some users chose to place them in a separate schema of 
their own. Explicitly schema-qualified references to the objects will therefore fail in either 
case. The replacement tsearch2 module provides alias objects that are stored in 
public (or another schema if necessary) so that such references will still work. 


e There is no concept of a "current parser" or "current dictionary" in the built-in text search 
features, only of a current search configuration (set by the default_text_search_config 
parameter). While the current parser and current dictionary were used only by functions 
intended for debugging, this might still pose a porting obstacle in some cases. The 
replacement tsearch2 module emulates these additional state variables and provides 
backwards-compatible functions for setting and retrieving them. 


There are some issues that are not addressed by the replacement tsearch2 module, and 
will therefore require application code changes in any case: 


e The old tsearch2 trigger function allowed items in its argument list to be names of 
functions to be invoked on the text data before it was converted to tsvector format. 
This was removed as being a security hole, since it was not possible to guarantee that 
the function invoked was the one intended. The recommended approach if the data 
must be massaged before being indexed is to write a custom trigger that does the work 
for itself. 


e Text search configuration information has been moved into core system catalogs that 


are noticeably different from the tables used by tsearch2. Any applications that 
examined or modified those tables will need adjustment. 


If an application used any custom text search configurations, those will need to be set 
up in the core catalogs using the new text search configuration SQL commands. The 
replacement tsearch2 module offers a little bit of support for this by making it possible 
to load an old set of tsearch2 configuration tables into PostgreSQL 8.3. (Without the 
module, it is not possible to load the configuration data because values in the 

regprocedure columns cannot be resolved to functions.) While those configuration 
tables won't actually do anything, at least their contents will be available to be consulted 
while setting up an equivalent custom configuration in 8.3. 


The old reset_tsearch() and get_covers() functions are not supported. 


The replacement tsearch2 module does not define any alias operators, relying entirely 
on the built-in ones. This would only pose an issue if an application used explicitly 
schema-qualified operator names, which is very uncommon. 


F.39.2. Converting a pre-8.3 Installation 


The recommended way to update a pre-8.3 installation that uses tsearch2 is: 


1. 


5. 


Make a dump from the old installation in the usual way, but be sure not to use -c 
( --clean ) option of pg_dump or pg_dumpall. 


In the new installation, create empty database(s) and install the replacement tsearch2 
module into each database that will use text search. This must be done before loading 
the dump data! If your old installation had the tsearch2 objects in a schema other than 

public , be sure to adjust the CREATE EXTENSION Command so that the replacement 
objects are created in that same schema. 


Load the dump data. There will be quite a few errors reported due to failure to recreate 
the original tsearch2 objects. These errors can be ignored, but this means you cannot 
restore the dump in a single transaction (eg, you cannot use pg_restore's -1 switch). 


Examine the contents of the restored tsearch2 configuration tables ( pg_ts_cfg and so 
on), and create equivalent built-in text search configurations as needed. You may drop 
the old configuration tables once you've extracted all the useful information from them. 


Test your application. 


At a later time you may wish to rename application references to the alias text search 


objects, so that you can eventually uninstall the replacement tsearch2 module. 


F.39.3. References 


Tsearch2 Development Site http://www.sai.msu.su/~megera/postgres/gist/tsearch/V2/ 


F.40. unaccent 


unaccent 是 一 个 文本 搜索 字典 ， 它 从 词汇 中 去 掉 重 音符 号 〈 变 音标 志 符 号 ) 。 这 是 一 个 过 
滤 词 典 ， 这 意味 着 它 的 输出 总 是 传递 给 下 一 个 字典 (如 果 存 在 的 话 ) ， 而 不 像 常规 行为 的 字 
典 。 这 人 允许 对 全 文 搜索 进行 重音 不 敏感 的 义理 。 


unaccent 的 当前 实现 不 能 用 作 一 个 thesaurus 字典 的 规范 字典 。 


F.40.1. Ace 


一 个 unaccent 字典 接受 下 面 的 操作 : 


。 RULES 是 包含 翻译 规则 列表 的 文件 的 基本 名 称 。 这 个 文件 必须 存储 在 
$SHAREDIR/tsearch_data/ 文件 夹 下 ( $sHAREDIR 是 指 PostgreSQL 安 装 时 的 数据 共享 文 
件 )。 它 的 名 字 必 须 以 rules 为 后 级 (这 个 后 级 无 须 出 现在 RULES 参数 中 )。 
规则 文件 的 格式 如 下 : 


。 每 一 个 行 代表 一 个 字符 对 ， 由 带 重 音符 号 的 字符 跟着 一 个 不 带 重 音符 号 的 字符 组 成 。 第 
一 个 字符 将 被 翻译 为 第 二 个 字符 。 例 如 : 


a DD Di D> 
PFT, 


一 个 对 大 多 数 欧 洲 语言 都 直接 有 用 的 更 完整 的 例子 ， 可 以 在 unaccent.rules 中 找到 ， 这 个 文 
件 在 Unaccent 模块 被 安装 时 就 被 置 于 $SHAREDIR/tsearch data/ MER F. 


F.40.2. 用 法 


在 安装 unaccent 扩展 的 时 候 ， 会 创建 一 个 unaccent 文本 搜索 模版 和 一 个 基于 这 个 模版 的 字 
典 。 这 个 unaccent 字典 有 一 个 默认 的 参数 设置 RuLEs='unaccent' ， 这 使 得 标准 
的 unaccent.rules 配置 可 以 立即 生效 。 如 果 有 需要 ， 你 也 可 以 改变 这 个 参数 ， 例如 ， 


mydb=# ALTER TEXT SEARCH DICTIONARY unaccent (RULES='my_rules'); 


或 者 创建 基于 unaccent 模版 的 新 字典 。 
你 可 以 试 斌 下面 的 sql， 来 测试 这 个 字典 ， 


mydb=# select ts_lexize('unaccent', 'H6étel'); 
ts_lexize 
{Hotel} 

(1 row) 


这 里 有 一 个 例子 ， 演 示 如 何 将 unaccent 字典 增加 到 文本 搜索 配置 中 : 


mydb=# CREATE TEXT SEARCH CONFIGURATION fr ( COPY = french ); 
mydb=# ALTER TEXT SEARCH CONFIGURATION fr 
ALTER MAPPING FOR hword, hword_part, word 
WITH unaccent, french_stem; 
mydb=# select to_tsvector('fr','Hétels de la Mer'); 
to_tsvector 
"hotel':1 'mer':4 
(1 row) 


mydb=# select to_tsvector('fr','Hdtel de la Mer') @@ to_tsquery('fr','Hotels'); 
?column? 


mydb=# select ts_headline('fr','Hdtel de la Mer',to_tsquery('fr', 'Hotels')); 
ts_headline 


<b>H6tel</b> de la Mer 
(1 row) 


F.40.3. 函数 


unaccent() 图 数 从 一 个 给 定 的 字符 串 中 去 掉 重 音符 号 〈 变 音标 志 符 号 ) 。 基 本 上 ， 它 是 一 
个 unaccent 字典 的 包装 ， 但 它 可 以 超出 正常 文本 搜索 的 上 下 文 使 用 。 


unaccent([°~_dictionary_~, ] _string_) returns text 





例如 ， 


SELECT unaccent('unaccent', 'Hdtel'); 
SELECT unaccent('H6tel'); 


F.41. uuid-ossp 
uuid-ossp 模块 提供 了 一 些 函 数 用 来 生成 通用 唯一 识别 码 (UUID)， 它 支 持 几 种 UUID 产生 的 
标准 算法 。 同 时 它 还 提供 了 一 些 本 数 用 来 产生 革 些 特定 的 UUID 常 量 。 


这 个 模块 依赖 于 OSSP UUID &, _http://www.ossp.org/pkg/lib/uuid/. 


F.41.1. uuid-ossp iz 


Table F-30 中 的 函数 用 来 产生 UUID。 相关 标准 ITU-T Rec. X.667, ISO/IEC 9834-8:2005 和 
RFC 4122 定义 了 四 种 生成 UUID 的 算法 , 分 别 在 版 本 1, 3, 4 和 5 中 定义 ( 没 用 版 本 2 算法 ) 每 个 
算法 适合 于 不 同 种 类 的 应 用 使 用 。 


Table F-30. UUID 生成 画 数 


数 描述 


这 个 男 数 生成 版 本 1 的 UUID。 它 的 算法 使 
uuid_generate_v1() A. SERRA UUID 泄露 了 生成 它 的 计算 ; 
它 可 能 不 太 适 合 对 安全 性 要 求 较 高 的 应 用 . 


这 个 画 数 生成 一 个 版 本 1 的 UUID， 但 是 使 
不 是 计算 机 的 真实 的 MAC 地 址 。 


这 个 函数 使 用 给 定 的 输入 名 字 (name) 在 给 
生成 一 个 版 本 3 的 UUID。 给 定 的 命名 空间 
的 函数 uuid_ns_*() 返回 的 常量 。 (理论 A 


ELN EAJ oo; 
uuid_generate_v3(namespace uuid, name text) name ze . | 选 定 命名 空间 (namespace)4 
SELECT uuid_generate_v3(uuid_ns_url(), 


参数 name 会 被 使 用 MD5 SKM, F 
向 获得 明文 。 利用 这 个 方法 生成 的 UUID 
行 相关 的 环境 因素 ， 因 此 生成 过 程 是 可 重 


uuid_generate_v4() 这 个 函数 生成 一 个 版 本 4 的 UUID， 它 完 


这 个 函数 生成 一 个 版 本 5 的 UUID， 它 个 工 
uuid_generate_v5(namespace uuid, name text) UUID, 但 是 它 使 用 的 SHA-1 的 哈 希 算法 。 
MD5 算法 更 安全 ， 所 有 应 该 尽量 使 用 版 本 


uuid_generate_vimc() 


Table F-31. 返回 UUID 常量 的 函数 


uuid_nil() 一 个 "nil" UUID 常量 , 它 不 应 该 看 作 一 个 真正 的 UUID。 
uuid_ns_dns() 代表 DNS 命令 空间 的 UUID 常量 。 
uuid_ns_url() 代表 URL 命名 空间 的 UUID 常量 。 


代表 ISO 对 象 标 识 符 (OID) 命 名 空间 的 UUID 常量 。( 它 是 ASN.1 的 
OID， 和 PostgreSQL 用 的 OID 没有 关系 ) 。 


uuid_ns_x500() 代表 X.500 识别 名 字 (DN) 命 名 空间 的 UUID 常量 


uuid_ns_oid() 


F.41.2. 作者 


Peter Eisentraut a1t;[peter_e@gmx.net](mailto:peter_e@gmx.net )&gt; 


F.42. xml2 


xml2 模块 提供 XPath 查询 和 XSLT 功 能 。 


F.42.1. FFA Al 


MPostgreSQL 8.3 开 始 ， 在 内 核 服务 器 中 有 一 个 基于 SQL/XML 标 准 的 XML 相关 的 功能 。 这 个 
功能 包含 了 XML 语法 检查 和 XPath 查询 ， 这 也 是 这 个 模块 的 包含 的 ， 甚 至 更 多 ， 不 过 API 一 点 
也 不 兼容 。 计划 在 未 来 的 PostgreSQL 版 本 中 删除 这 个 模块 ， 支 持 新 的 标准 的 API， 所 以 鼓励 
你 尝试 转换 你 的 应 用 。 如 果 你 发 现 这 个 模块 的 某 些 功 能 在 一 个 适当 形式 的 更 新 的 API 中 不 可 
用 ， 请 解释 你 的 问题 

到 &1t; [pgsql-hackers@postgresql.org](mailto:pgsql-hackers@postgresql.org)&gt; ， 以 便 解 决 
这 个 缺陷 。 


F.42.2. 功能 说 明 


Table F-32 显 示 了 这 个 模块 提供 的 函数 。 这 些 函 数 提供 了 简单 的 XMP 解 析 和 和 XPath 查询 。 所 有 
参数 都 是 text 类 型 的 ， 所 以 为 了 简 化 没有 显示 。 


Table F-32. Ei 2X 


EE 返回 


xml_is_well_formed(document ) bool 
xpath_string(document, query) text 
xpath_number(document, query) float4 
xpath_bool(document, query) bool 
xpath_nodeset(document, query, toptag, itemtag) text 
xpath_nodeset(document, query) text 
xpath_nodeset(document, query, itemtag) text 
xpath_list(document, query, separator) text 
xpath_list(document, query) text 


F.42.3. xpath_table 


xpath_table(text key, text document, text relation, text xpaths, 
El _ o B 


并 作为 一 个 表 返 回 结果 
一 个 字段 返回 ， 因此 结果 集 可 以 容易 的 用 于 连接 。 参 数 


xpath_table 是 一 个 表 琅 数 ， 在 每 一 组 文档 上 计算 一 组 XPath 查 询 ， 


原始 文档 表 的 主键 字段 作为 结果 的 第 
在 Table F-33 中 描述 。 


Table F-33. xpath_table 参数 


参数 描述 
"key" 字 段 的 名 字 一 这 只 是 用 作 输 出 表 的 第 


一 个 字段 ， 也 就 是 ， 


解析 它 的 参数 中 的 文件 正 
Re (注意 : 在 Postgre: 

各 因为 在 XI 
仍然 可 ， 但 是 已 经 废弃 


这 个 函数 在 提供 的 文件 上 


在 文件 上 评估 查询 并 将 结 
么 输出 将 看 起 来 像 : alt; 
&lt;itemtag&gt;Value 1 v 
&lt;itemtag&gt;Value 2.. 


se toptag 或 itemtag FAB 


UF xpath_nodeset (doc 
略 两 个 标签 。 

类 似 于 xpath_nodeset(doc 
略 toptag。 


这 个 函数 返回 由 指定 的 分 


回 值 是 value 1,Value 2,V 


文 是 一 个 对 于 使 用 ， 作 关 


text criteria) returns s 





它 识 别 每 个 


s 传 来 的 输出 行 的 记录 (请 参见 下 面 关于 多 行 值 的 注释 ) 

document 包含 XML 文档 的 字段 名 

relation 包含 文档 的 表 或 视图 的 名 字 

xpaths 一 个 或 多 个 XPath 表达 式 ， 由 &#124; 分 隔 

criteria ， WHERE 子 句 的 内 容 。 这 个 不 能 省 略 ， 所 以 如 果 你 想 要 在 关系 中 处 理 所 有 的 


行 ， 那么 使 用 Erue 或 1=1 


这 些 参数 (除了 XPath 字符 串 ) 只 是 代替 一 个 纯 SQL SELECT 语句 ， 所 以 你 有 一 些 灵 活性 一 


SELECT &lt;key&gt;, &lt;document&gt; FROM &lt;relation&gt; WHERE &lt;criteria&gt; 


所 以 这 些 参 数 可 以 是 任何 在 这 些 特定 位 置 的 有 效 值 。 这 个 SELECT 的 结果 需要 返回 正好 两 个 
字段 (除非 你 尝试 为 key 或 document 列 出 多 个 字段 )。 注意 这 个 简单 的 方法 需要 验证 任何 用 
户 提供 的 值 ， 以 避免 SQL 注 入 攻击 。 


该 图 数 必须 用 于 FRoM 表达 式 中 ， 用 一 个 As 子 句 指定 输出 字段 ; 例如 


SELECT * FROM 
xpath_table('article_id', 
‘article_xml', 
‘articles', 
'/article/author |/article/pages|/article/title', 
‘date_entered > ''2003-01-01'' ') 
AS t(article_id integer, author text, page_count integer, title text); 


As 子 句 定义 输出 表 中 字段 的 名 字 和 类 型 。 第 一 个 是 "key" 字 段 ， 剩余 的 对 应 于 XPath 查询 。 
如 果 XPath 查 询 多 于 结果 字段 ， 那 么 额外 的 查询 将 被 忽略 。 如 果 结 果 字 段 多 于 XPath 查询 ， 那 
么 额外 的 字段 将 为 空 。 


请 注意 ， 这 个 示例 定义 page_count 的 结果 字段 为 一 个 整数 。 该 男 数 内 部 处 理 字符 串 的 表示 ， 
所 以 当 你 说 你 在 输出 中 想 要 一 个 整数 时 ， 它 将 接收 XPath 结果 的 字符 串 表 示 ， 并 使 用 
PostgreSQL 输 入 画 数 将 它 转换 为 一 个 整数 (或 者 任何 As 子 句 要 求 的 类 型 ) 。 如 果 它 不 能 这 
么 做 则 导致 一 个 错误 一 例如， 如 果 结 果 为 空 一 所 以 如 果 你 认为 你 的 数据 有 任何 问题 ， 你 可 能 
想 要 坚持 text 作为 该 字段 的 类 型 。 


调用 的 sELEcT 语句 不 需要 只 是 SELECT * 一 它 可 以 通过 名 字 或 链接 输出 字段 到 其 他 的 表 引 用 
输出 字段 。 该 图 数 产 生 一 个 虚拟 表 ， 用 该 虚拟 表 你 可 以 执行 任何 你 想 要 的 操作 (例如 ， 聚 
集 、 链 接 、 排 序 等 等 ) 。 所 以 我 们 也 可 以 将 : 


SELECT t.title, p.fullname, p.email 
FROM xpath_table('article_id', 'article_xml', 'articles', 
'/article/title|/article/author/@id', 
'xpath_string(article xml,''/article/@date'') > ''2003-03-20'' ') 
AS t(article_id integer, title text, author_id integer), 
tblPeopleInfo AS p 
WHERE t.author_id = p.person_id; 


作为 一 个 更 复杂 的 示例 。 当 然 ， 为 了 方便 ， 你 可 以 将 所 有 这 些 包装 到 一 个 视图 中 。 


F.42.3.1. 多 值 的 结 


xpath_table 图 数 假设 每 个 XPath 查 询 的 结果 可 能 是 多 值 的 ， 所 以 该 函数 返回 的 行 数 可 能 和 输 
入 文档 的 行 数 不 同 。 返回 的 第 一 行 包含 每 个 查询 的 第 一 个 结果 ， 第 二 行 包含 每 个 查询 的 第 二 
个 结果 。 如 果 其 中 的 一 个 查询 比 其 他 查询 的 值 少 ， 那 么 将 返回 空 值 。 


在 某 些 情况 下 ， 用 户 知道 一 个 给 定 的 XPath 查 询 将 只 返回 一 个 结果 (可 能 是 一 个 唯一 文档 标识 
F) 一 如 果 和 返回 多 个 结果 的 XPath 查询 一 起 使 用 ， 那 么 唯一 值 结果 将 只 在 结果 的 第 一 行 出 


现 。 这 个 问题 的 解决 方法 是 使 用 该 关键 字段 作为 一 个 更 简单 的 XPath 查询 连接 的 一 部 分 。 示 
例 : 


CREATE TABLE test ( 
id int PRIMARY KEY, 
xml text 


); 


INSERT INTO test VALUES (1, '<doc num="C1"> 

<line num="L1"><a>1</a><b>2</b><c>3</c></line> 
<line num="L2"><a>11</a><b>22</b><c>33</c></line> 
</doc>'); 


INSERT INTO test VALUES (2, '<doc num="C2"> 

<line num="L1i"><a>111</a><b>222</b><c>333</c></line> 
<line num="L2"><a>111</a><b>222</b><c>333</c></line> 
</doc>'); 


SELECT * FROM 
xpath_table('id','xml','test', 
'/doc/@num|/doc/line/@num|/doc/line/a|/doc/line/b|/doc/line/c', 
"true') 
AS t(id int, doc_num varchar(10), line_num varchar(10), vali int, val2 int, val3 int) 
WHERE id = 1 ORDER BY doc_num, line_num 


id | doc_num | line_num | vali | val2 | val3 


要 在 每 个 行 上 获得 doc_num ， 解 决 方法 是 使 用 两 个 xpathtable 的 调用 并 连接 结 


SELECT t.*,i.doc_num FROM 
xpath_table('id', 'xml', ‘'test', 
'/doc/line/@num|/doc/line/a|/doc/line/b|/doc/line/c', 
"true') 
AS t(id int, line_num varchar(10), vali int, val2 int, val3 int), 
xpath_table('id', 'xml', 'test', '/doc/@num', 'true') 
AS i(id int, doc_num varchar (10) ) 
WHERE i.id=t.id AND i.id=1 
ORDER BY doc_num, line_num; 


id | line_num | vali | val2 | val3 | doc_num 


Sr die ios Cee ee to Moe ae 
a, {| (kal | 1 | 2 | 3 | C1 
1 | L2 | ae [| 22] e 

(2 rows) 


F.42.4. XSLT 函数 


如 果 安 装 了 libxslt， 那 么 下 列 的 函数 是 可 用 的 : 


F.42.4.1. xslt_process 


xslt_process(text document, text stylesheet, text paramlist) returns text 


ANKA FAXSL ARE CFR T ARo paramlist 是 一 个 在 转换 中 使 用 的 参 
数 分 配 列表 ， 以 格式 a=1,b=2 指定 。 请 注意 ， 参 数 分 析 是 非常 简单 的 : 参数 值 不 能 包含 过 


= | 
7J 


也 有 一 个 两 参数 的 xslt process 版 本 ， 不 传递 任何 参数 到 转换 。 


F.42.5. 作者 


John Gray &lt; [jgray@azuli.co.uk] (mailto: jgray@azuli.co.uk)&gt; 


这 个 模块 的 发 展 是 由 Torchbox Ltd. (www.torchbox.com)# BK). 它 和 PostgreSQL 有 一 样 的 
BSD 许 可 证 。 


Appendix G. 额外 提供 的 程序 


Table of Contents 


。 G.1. 客户 端 应 用 程序 
。 G.2. 服务 器 端 应 用 程序 


本 附录 和 前 一 个 包含 可 以 在 PostgreSQL 发布 的 contrib 目录 中 发 现 的 有 关 模 块 的 信息 。 参 
阅 Appendix F 获 取 更 多 关于 contrib 部 分 和 服务 器 扩展 以 及 特别 在 contrib 中 发 现 的 插件 的 
更 多 详细 信息 。 


本 附录 包括 在 contrib 中 发 现 的 实用 程序 。 一 旦 安装 ， 无 论 来 自 源 或 包装 系统 ， 它们 在 
PostgreSQL 安 装 的 bin 目录 中 被 发 现 可 用 于 类 似 的 任何 其 他 程序 。 


G.1. & P tin HIE 


Table of Contents 


e oid2name -- 解析 PostgreSQL 数据 目录 里 的 OID 和 文件 节点 
e pgbench -- run a benchmark test on PostgreSQL 
e vacuumlo -- 从 PostgreSQL 数据 库 移 除 孤 立 的 大 对 象 


这 部 分 在 contrib 中 包含 PostgreSQL 客 户 端 应 用 程序 。 它 们 可 以 从 任何 地 方 允许 ， 数据 库 
服务 器 独立 的 地 方 。 参 阅 Reference Il, PostgreSQL 客户 端 应 用 程序 获取 关于 核心 
PostgreSQL 发 布 部 分 客户 端 应 用 程序 的 信息 。 


oid2name 


Name 


oid2name -- 解析 PostgreSQL 数据 目录 里 的 OID 和 文件 节点 


Synopsis 


oid2name [ _ 选项 _.…| 


fia aah 


oid2nameoid2name 是 一 个 帮助 管理 员 检 查 PostgreSQL 使 用 的 文件 结构 的 工具 程序 。 要 使 用 
这 个 工具 ， 你 必须 熟悉 数据 库 文 件 结 构 ， 在 第 58 章 描述 Chapter 58. 


Note: “oid2name" 很 有 历史 了 ,但 是 实际 上 有 相当 的 误导 ，, 因 为 大 多 数 你 使 用 它 的 时 候 ， 
你 将 真正 和 的 filenode numbers'( 他 们 的 文件 名 在 数据 库 目录 中 是 可 见 的 ) 连 接 。 请 确保 
你 明白 表 的 OID 和 表 filenodes 之 间 的 区 别 














oid2name 连接 到 一 个 目标 数据 库 并 且 提 取 OID， 文 件 节点 ， 和 /或 表 名 信息 你 也 可 以 展示 数 
据 库 的 OID 和 表 空 间 的 OID 


选项 


oid2name 接 收 下 面 的 命令 行 参数 : 

-f _filenode_ 

展示 文件 节点 是 _filenode 的 表 的 信息 
在 这 个 列表 中 包含 索引 和 序列 

-o _oid_ 

展示 OID 是 _oid 的 表 的 信息 

-q 

省 略 表 头 ( 对 脚本 很 有 用 ) 


aS 


展示 表 空 间 的 OID 
-S 
包含 在 ( information_schema , pg_toast and pg_catalog schemas) 里 的 系统 对 象 


-t _tablename_ pattern_ 


展示 匹配 _tablename_pattern_ 的 表 信 息 


-V``--version 


打印 oid2name 版 本 并 退出 . 


列 出 每 一 个 被 展示 的 对 象 的 更 多 信息 : tablespace name, schema name, and OID 
-? --help 

显示 关于 oid2name 命 邻 行 的 帮助 信息 和 参数 ， 并 退出 
oid2name 在 连接 的 时 候 也 接受 下 面 的 命令 行 参 数 : 

-d _database_ 

连接 哪 台 数据 库 

-H _host_ 

数据 库 服务 器 的 地 址 

-p poe 

数据 库 服务 器 的 端口 

-U _username_ 

连接 数据 库 的 用 户 

-Pp _password_ 

密码 (但 是 不 建议 这 么 做 ， 因 为 把 密码 放 在 命 合 行 存在 安全 隐患 ) 


要 展示 特定 的 表 , 选择 要 展示 的 数据 库 使 用 -。，-f 和 /或 -t ，-。 需 要 一 个 OID，-f 需要 
一 个 filenode，-t 需要 一 个 表 名 (事实 上 ， 它 是 一 个 LIKE nein 所 以 你 可 以 使 用 类 似 
foo% 的 参数 ). 只 要 你 喜欢 ， 你 可 以 使 用 更 多 的 选项 ， 列 表 将 包含 所 有 的 匹配 这 些 选 项 的 对 象 . 
但 是 请 注意 这 些 选 项 只 能 展示 -d 指派 的 数据 库 里 的 对 象 . 


如 果 你 没有 提供 -o, -f or -t 中 的 任何 参数 , 但 是 给 了 -d 参数 , 它 将 列 出 以 -a 指派 的 数 
据 库 的 所 有 的 表 . 在 这 种 模式 下 ， -s 和 -i 选项 控制 着 列表 的 显示 内 容 


如 果 你 也 没有 指定 -d 它 将 展示 数据 库 列表 的 OID. 或 者 你 可 以 通过 -s 参数 去 得 到 表 空 间 
的 列表 


一 
) 王 局 


oid2name 需 要 一 个 正在 运行 的 且 系统 的 catalogs 没 有 被 破坏 的 数据 库 服 务 器 ， 因 此 ， 从 遭受 
灾难 性 破坏 的 数据 库 中 恢复 数据 ， 将 会 很 有 限 。 


例子 


$ # 数据 库 服 务 器 上 都 有 哪些 数据 库 ? 
$ oid2name 
All databases: 
Oid Database Name Tablespace 


17228 alvherre pg_default 
17255 regression pg_default 
17227 templateO pg_default 

1 template1 pg_default 


$ oid2name -s 
All tablespaces: 
Oid Tablespace Name 


1663 pg_default 
1664 pg_global 
155151 fastdisk 
155152 bigdisk 


$ # 好 ， 让 我 们 进入 alvherre 数 据 库 的 目录 
$ cd $PGDATA/base/17228 


$ # 获取 缺 省 表 空 间 的 前 十 个 数据 库 对 象 ， 并 且 以 size 排 序 
$ 1s -1S * | head -10 


-rw------- 1 alvherre alvherre 136536064 sep 14 09:51 155173 
-rw------- 1 alvherre alvherre 17965056 sep 14 09:51 1155291 
-rw------- 1 alvherre alvherre 1204224 sep 14 09:51 16717 
-rw------- 1 alvherre alvherre 581632 sep 6 17:51 1255 
-rw------- 1 alvherre alvherre 237568 sep 14 09:50 16674 
-rw------- 1 alvherre alvherre 212992 sep 14 09:51 1249 
-rw------- 1 alvherre alvherre 204800 sep 14 09:51 16684 
-rw------- 1 alvherre alvherre 196608 sep 14 09:50 16700 
-rw------- 1 alvherre alvherre 163840 sep 14 09:50 16699 
-rw------- 1 alvherre alvherre 122880 sep 6 17:51 16751 


$ # 我 想 知道 155173 这 个 文件 是 什么 

$ oid2name -d alvherre -f 155173 

From database "alvherre": 
Filenode Table Name 


155173 accounts 


$ # 你 也 可 以 请 求 更 多 的 对 象 
$ oid2name -d alvherre -f 155173 -f 1155291 
From database "alvherre": 
Filenode Table Name 
155173 accounts 
1155291 accounts_pkey 


$ # 你 可 以 混合 这 些 选项 ， 通 过 -x 获取 更 多 的 详细 信息 
$ oid2name -d alvherre -t accounts -f 1155291 -x 


From database "alvherre": 
Filenode Table Name Oid Schema Tablespace 
155173 accounts 155173 public pg_default 
1155291 accounts_pkey 1155291 public pg_default 


$ # 展示 每 个 数据 库 对 象 所 占 的 磁盘 空间 
$ du [0-9]* | 

> while read SIZE FILENODE 

> 
> 


do 
echo "$SIZE “oid2name -q -d alvherre -i -f $FILENODE™" 
> done 
16 1155287 branches_pkey 
16 1155289 tellers_pkey 


17561 1155291 accounts_pkey 


$ # 和 上 面 一 样 ， 但 是 按照 大 小 排序 

$ du [0-9]* | sort -rn | while read SIZE FN 
> 

> 


do 
echo "$SIZE “oid2name -q -d alvherre -f $FN " 
> done 
133466 155173 accounts 
17561 1155291 accounts_pkey 


1177 16717 pg_proc_proname_args_nsp_index 


$ # 如 果 你 想 看 表 空 间 里 有 什么 ， 使 用 pg_tblspc 目录 
$ cd $PGDATA/pg_tblspc 
$ oid2name -s 
All tablespaces: 
Oid Tablespace Name 


1663 pg_default 
1664 pg_global 
155151 fastdisk 
155152 bigdisk 


$ # 数 据 库 在 "fastdisk" 表 空间 都 有 什么 ? ? 
$ ls -d 155151/* 
155151/17228/ 155151/PG_VERSION 


$ # 这 个 数据 库 17228 又 是 什么 ? 
$ oid2name 
All databases: 
Oid Database Name Tablespace 


17228 alvherre pg_default 
17255 regression pg_default 
17227 templateO pg_default 

1 template1 pg_default 


$ # 让 我 们 看 看 这 个 数据 库 在 表 空 间 里 都 有 什么 
$ cd 155151/17228 


$ 1s -1 
total 0 
mW 1 postgres postgres 0 sep 13 23:20 155156 


$# 这 个 是 一 个 很 不 错 的 小 表 ， 但 是 它 是 什么 表 呢 ? 
$ oid2name -d alvherre -f 155156 
From database "alvherre": 

Filenode Table Name 


155156 foo 


作者 


B. Palmer &1t;[bpalmer@crimelabs.net](mailto:bpalmer@crimelabs.net)&gt; 


pgbench 


Name 


pgbench -- run a benchmark test on PostgreSQL 


Synopsis 





pgbench -i [ _option_ ...] [ _dbname_ ] 


pgbench [ _option_ ...] [ _dbname_ ] 





Description 


pgbench is a simple program for running benchmark tests on PostgreSQL. It runs the same 
sequence of SQL commands over and over, possibly in multiple concurrent database 
sessions, and then calculates the average transaction rate (transactions per second). By 
default, pgbench tests a scenario that is loosely based on TPC-B, involving five SELECT , 

UPDATE , and INSERT commands per transaction. However, it is easy to test other cases by 
writing your own transaction script files. 


Typical output from pgbench looks like: 


transaction type: TPC-B (sort of) 

scaling factor: 10 

query mode: simple 

number of clients: 10 

number of threads: 1 

number of transactions per client: 1000 

number of transactions actually processed: 10000/10000 
tps = 85.184871 (including connections establishing) 
tps = 85.296346 (excluding connections establishing) 


The first six lines report some of the most important parameter settings. The next line reports 
the number of transactions completed and intended (the latter being just the product of 
number of clients and number of transactions per client); these will be equal unless the run 
failed before completion. (In -t mode, only the actual number of transactions is printed.) 
The last two lines report the number of transactions per second, figured with and without 
counting the time to start database sessions. 


The default TPC-B-like transaction test requires specific tables to be set up beforehand. 
pgbench should be invoked with the -i (initialize) option to create and populate these 
tables. (When you are testing a custom script, you don't need this step, but will instead need 
to do whatever setup your test needs.) Initialization looks like: 


pgbench -i [ ~_other-options_~ ] _dbname_ 


where _dbname_ is the name of the already-created database to test in. (You may also need 
-h , -p , and/or -u options to specify how to connect to the database server.) 
Caution 


pgbench -i creates four tables pgbench_accounts , pgbench_branches 
pgbench_history , and pgbench_tellers , destroying any existing tables of these names. 
Be very careful to use another database if you have tables having these names! 


At the default "scale factor" of 1, the tables initially contain this many rows: 


table # of rows 
pgbench_branches 1 
pgbench_tellers 10 
pgbench_accounts 100000 
pgbench_history 0 


You can (and, for most purposes, probably should) increase the number of rows by using the 
-s (scale factor) option. The -F (fillfactor) option might also be used at this point. 


Once you have done the necessary setup, you can run your benchmark with a command 
that doesn't include -i ,that is 


pgbench [ ~_options_~ ] _dbname_ 


In nearly all cases, you'll need some options to make a useful test. The most important 
options are -c (number of clients), -t (number of transactions), -t (time limit), and -f 
(specify a custom script file). See below for a full list. 


Options 


The following is divided into three subsections: Different options are used during database 
initialization and while running benchmarks, some options are useful in both cases. 


Initialization Options 


pgbench accepts the following command-line initialization arguments: 


-i 
Required to invoke initialization mode. 
-F  _fillfactor_ 


Create the pgbench_accounts , pgbench_tellers and pgbench_branches tables with the given 
fillfactor. Default is 100. 


-n 
Perform no vacuuming after initialization. 
-q 


Switch logging to quiet mode, producing only one progress message per 5 seconds. The 
default logging prints one message each 100000 rows, which often outputs many lines per 
second (especially on good hardware). 


-S scale_factor 





Multiply the number of rows generated by the scale factor. For example, -s 100 will create 
10,000,000 rows in the pgbench_accounts table. Default is 1. When the scale is 20,000 or 
larger, the columns used to hold account identifiers ( aid columns) will switch to using 
larger integers ( bigint ), in order to be big enough to hold the range of account identifiers. 


--foreign-keys 
Create foreign key constraints between the standard tables. 


--index-tablespace="~_index_tablespace_ 


Create indexes in the specified tablespace, rather than the default tablespace. 


--tablespace="~_tablespace_ 


Create tables in the specified tablespace, rather than the default tablespace. 


--unlogged-tables 


Create all tables as unlogged tables, rather than permanent tables. 


Benchmarking Options 


pgbench accepts the following command-line benchmarking arguments: 
-c _clients_ 


Number of clients simulated, that is, number of concurrent database sessions. Default is 1. 


-C 


Establish a new connection for each transaction, rather than doing it just once per client 
session. This is useful to measure the connection overhead. 


-d 
Print debugging output. 
-D  _varname_**=**_value_ 
Define a variable for use by a custom script (see below). Multiple -b options are allowed. 
-f _filename_ 


Read transaction script from _filename_ . See below for details. -n , -s ,and -f are 
mutually exclusive. 


-j  _threads_ 


Number of worker threads within pgbench. Using more than one thread can be helpful on 
multi-CPU machines. The number of clients must be a multiple of the number of threads, 
since each thread is given the same number of client sessions to manage. Default is 1. 


il 
Write the time taken by each transaction to a log file. See below for details. 
-M _querymode_ 
Protocol to use for submitting queries to the server: 
e simple : use simple query protocol. 
e extended : use extended query protocol. 
e prepared : use extended query protocol with prepared statements. 
The default is simple query protocol. (See Chapter 48 for more information.) 
-n 


Perform no vacuuming before running the test. This option is necessary if you are running a 
custom test scenario that does not include the standard tables pgbench_accounts , 


pgbench_branches , pgbench_history , and pgbench_tellers . 

-N 
Do not update pgbench_tellers and pgbench_branches . This will avoid update contention on 
these tables, but it makes the test case even less like TPC-B. 


-r 


Report the average per-statement latency (execution time from the perspective of the client) 
of each command after the benchmark finishes. See below for details. 


-S scale_factor 





Report the specified scale factor in pgbench's output. With the built-in tests, this is not 
necessary; the correct scale factor will be detected by counting the number of rows in the 

pgbench_branches table. However, when testing custom benchmarks ( -f option), the scale 
factor will be reported as 1 unless this option is used. 


-S 
Perform select-only transactions instead of TPC-B-like test. 
-t _transactions_ 
Number of transactions each client runs. Default is 10. 
-T _seconds_ 


Run the test for this many seconds, rather than a fixed number of transactions per client. 
-t and -T are mutually exclusive. 
-vV 
Vacuum all four standard tables before running the test. With neither -n nor -v , pgbench 


will vacuum the pgbench_tellers and pgbench_branches tables, and will truncate 


pgbench_history . 

--aggregate-interval= ~_seconds_ 
Length of aggregation interval (in seconds). May be used only together with -| - with this 
option, the log contains per-interval summary (number of transactions, min/max latency and 
two additional fields useful for variance estimation). 
This option is not currently supported on Windows. 

--sampling-rate=~_rate_ 
Sampling rate, used when writing data into the log, to reduce the amount of log generated. If 


this option is given, only the specified fraction of transactions are logged. 1.0 means all 
transactions will be logged, 0.05 means only 5% of the transactions will be logged. 


Remember to take the sampling rate into account when processing the log file. For example, 
when computing tps values, you need to multiply the numbers accordingly (e.g. with 0.01 
sample rate, you'll only get 1/100 of the actual tps). 


Common Options 


pgbench accepts the following command-line common arguments: 
-h _hostname_ 

The database server's host name 
-p _port_ 

The database server's port number 
-U _login_ 


The user name to connect as 


-V``--version 
Print the pgbench version and exit. 
-? --help 


Show help about pgbench command line arguments, and exit. 


Notes 


What is the "Transaction" Actually Performed in pgbench? 


The default transaction script issues seven commands per transaction: 


1. BEGIN; 


2. UPDATE pgbench_accounts SET abalance = abalance + :delta WHERE aid = :aid; 


3. SELECT abalance FROM pgbench_accounts WHERE aid = :aid; 


4. UPDATE pgbench_tellers SET tbalance = tbalance + :delta WHERE tid = :tid; 


5. UPDATE pgbench_branches SET bbalance = bbalance + :delta WHERE bid = :bid; 


6. INSERT INTO pgbench_history (tid, bid, aid, delta, mtime) VALUES (:tid, 


T. END; 


If you specify -n , steps 4 and 5 aren't included in the transaction. If you specify -s , only 


the SELECT is issued. 


Custom Scripts 


:aid, 


:0d 


pgbench has support for running custom benchmark scenarios by replacing the default 
transaction script (described above) with a transaction script read from a file ( -f option). In 
this case a "transaction" counts as one execution of a script file. You can even specify 
multiple scripts (multiple -f options), in which case a random one of the scripts is chosen 
each time a client session starts a new transaction. 


The format of a script file is one SQL command per line; multiline SQL commands are not 
supported. Empty lines and lines beginning with -- are ignored. Script file lines can also be 
"meta commands", which are interpreted by pgbench itself, as described below. 


There is a simple variable-substitution facility for script files. Variables can be set by the 
command-line -D option, explained above, or by the meta commands explained below. In 
addition to any variables preset by -p command-line options, the variable scale is preset 
to the current scale factor. Once set, a variable's value can be inserted into a SQL command 
by writing :>*_variablename_ . When running more than one client session, each session 
has its own set of variables. 


Script file meta commands begin with a backslash ( \ ). Arguments to a meta command are 
separated by white space. These meta commands are supported: 


\set _varname_ _operand1_ [ _operator_ _operand2_ ] 


Sets variable _varname_ to a calculated integer value. Each _operand_ is either an integer 


constant ora :*°_variablename_ reference to a variable having an integer value. The 
_operator_ canbe +, -, *,or/s. 
Example: 


\set ntellers 10 * :scale 


\setrandom -_varname min max 





Sets variable _varname_ to a random integer value between the limits _min and _max_ 


inclusive. Each limit can be either an integer constant or a :°*_variablename_ reference toa 
variable having an integer value. 


Example: 


\setrandom aid 1 :naccounts 


\sleep _number_ [uS|ms]|s] 


Causes script execution to sleep for the specified duration in microseconds ( us ), 
milliseconds ( ms ) or seconds ( s ). If the unit is omitted then seconds are the default. 
_number_ can be either an integer constant ora :**_variablename_ reference to a variable 


having an integer value. 


Example: 


\sleep 10 ms 


\setshell _varname_ _command_ [| _argument_ ... ] 


Sets variable _varname_ to the result of the shell command _command_ . The command must 
return an integer value through its standard output. 


_argument_ Can be either a text constant or a :**_variablename_ reference to a variable of 
any types. If you want to use _argument_ starting with colons, you need to add an additional 
colon at the beginning of _argument_ . 


Example: 


\setshell variable_to_be_assigned command literal_argument :variable ::literal_starting_w 


E] 





\shell _command_ [ _argument_ ... ] 
Same as \setshell , but the result is ignored. 


Example: 


\shell command literal_argument :variable ::literal_starting_with_colon 


As an example, the full definition of the built-in TPC-B-like transaction is: 


\set nbranches :scale 

\set ntellers 10 * :scale 

\set naccounts 100000 * :scale 

\setrandom aid 1 :naccounts 

\setrandom bid 1 :nbranches 

\setrandom tid 1 :ntellers 

\setrandom delta -5000 5000 

BEGIN; 

UPDATE pgbench_accounts SET abalance = abalance + :delta WHERE aid = :aid; 
SELECT abalance FROM pgbench_accounts WHERE aid = :aid; 

UPDATE pgbench_tellers SET tbalance = tbhalance + :delta WHERE tid = :tid; 
UPDATE pgbench_branches SET bbalance = bbalance + :delta WHERE bid = :bid; 
INSERT INTO pgbench_history (tid, bid, aid, delta, mtime) VALUES (:tid, :bid, :aid, :delt 
END; 


1 F 





This script allows each iteration of the transaction to reference different, randomly-chosen 
rows. (This example also shows why it's important for each client session to have its own 
variables — otherwise they'd not be independently touching different rows.) 


Per-Transaction Logging 


With the -1 option but without the --aggregate-interval , pgbench writes the time taken by 
each transaction to a log file. The log file will be named pgbench_log.**_nnn_ , where _nnn_ 
is the PID of the pgbench process. If the -j option is 2 or higher, creating multiple worker 
threads, each will have its own log file. The first worker will use the same name for its log file 
as in the standard single worker case. The additional log files for the other workers will be 





named pgbench_log.**_nnn_ . _mmm_ , where _mmm_ is a Sequential number for each worker 
starting with 1. 


The format of the log is: 


_client_id_ _transaction_no time file_no time_epoch time_us 





where _time_ is the total elapsed transaction time in microseconds, _file_no_ identifies 
which script file was used (useful when multiple scripts were specified with -f ), and 
time_epoch_ / _time_us_ are a UNIX epoch format timestamp and an offset in 





microseconds (suitable for creating a ISO 8601 timestamp with fractional seconds) showing 
when the transaction completed. 


Here are example outputs: 


9 199 2241 0 1175850568 995598 
9 200 2465 © 1175850568 998079 
9 201 2513 0 1175850569 608 

9 202 2038 0 1175850569 2663 


When running a long test on hardware that can handle a lot of transactions, the log files can 
become very large. The --sampling-rate option can be used to log only a random sample 
of transactions. 


Aggregated Logging 


With the --aggregate-interval option, the logs use a bit different format: 





_interval_start num_of_transactions_ _latency_sum_ _latency_2_sum_ _min_latency_ _max_l 





where _interval_start_ is the start of the interval (UNIX epoch format timestamp), 
_num_of_transactions_ is the number of transactions within the interval, _latency_sum_ is a 
sum of latencies (so you can compute average latency easily). The following two fields are 
useful for variance estimation - _latency_sum_ is a sum of latencies and _latency_2_sum_ İS 


a sum of 2nd powers of latencies. The last two fields are _min_latency_ -a minimum 


latency within the interval, and _max_latency_ - maximum latency within the interval. A 


transaction is counted into the interval when it was committed. 


Here is example outputs: 


1345828501 
1345828503 
1345828505 
1345828507 
1345828509 


5601 1542744 483552416 61 2573 
7884 1979812 565806736 60 1479 
7208 1979422 567277552 59 1391 
7685 1980268 569784714 60 1398 
7073 1979779 573489941 236 1411 


Notice that while the plain (unaggregated) log file contains index of the custom script files, 


the aggregated log does not. Therefore if you need per script data, you need to aggregate 


the data on your own. 


Per-Statement Latencies 


With the -r option, pgbench collects the elapsed transaction time of each statement 


executed by every client. It then reports an average of those values, referred to as the 


latency for each statement, after the benchmark has finished. 


For the default script, the output will look similar to this: 


starting vacuum...end. 


transaction type: TPC-B (sort of) 


scaling factor: 1 
query mode: simple 
clients: 
threads: 


number of 
number of 
number of 
number of 
tps = 618. 
tps = 622. 
statement 

0. 


FPFONDTOOO0QO0Q0000 


JE 


transactions per client: 1000 

transactions actually processed: 10000/10000 
764555 (including connections establishing) 
977698 (excluding connections establishing) 
latencies in milliseconds: 


004386 


. 001343 
.001212 
. 001310 
.001073 
. 001005 
.001078 
. 326152 
. 603376 
. 454643 
.528491 
. 335435 
. 371851 
.212976 


\set nbranches 1 * :scale 

\set ntellers 10 * :scale 

\set naccounts 100000 * :scale 

\setrandom aid 1 :naccounts 

\setrandom bid 1 :nbranches 

\setrandom tid 1 :ntellers 

\setrandom delta -5000 5000 

BEGIN; 

UPDATE pgbench_accounts SET abalance = abalance + :delta WHERE ai 
SELECT abalance FROM pgbench_accounts WHERE aid = :aid; 

UPDATE pgbench_tellers SET tbalance = tbalance + :delta WHERE tid 
UPDATE pgbench_branches SET bbalance = bbalance + :delta WHERE bi 
INSERT INTO pgbench_history (tid, bid, aid, delta, mtime) VALUES 
END; 





If multiple script files are specified, the averages are reported separately for each script file. 


Note that collecting the additional timing information needed for per-statement latency 
computation adds some overhead. This will slow average execution speed and lower the 
computed TPS. The amount of slowdown varies significantly depending on platform and 
hardware. Comparing average TPS values with and without latency reporting enabled is a 
good way to measure if the timing overhead is significant. 


Good Practices 


It is very easy to use pgbench to produce completely meaningless numbers. Here are some 
guidelines to help you get useful results. 


In the first place, never believe any test that runs for only a few seconds. Use the -t or 

-T option to make the run last at least a few minutes, so as to average out noise. In some 
cases you could need hours to get numbers that are reproducible. It's a good idea to try the 
test run a few times, to find out if your numbers are reproducible or not. 


For the default TPC-B-like test scenario, the initialization scale factor ( -s ) should be at 
least as large as the largest number of clients you intend to test ( -c ); else you'll mostly be 
measuring update contention. There are only -s rows in the pgbench_branches table, and 
every transaction wants to update one of them, so -c values in excess of -s will 
undoubtedly result in lots of transactions blocked waiting for other transactions. 


The default test scenario is also quite sensitive to how long it's been since the tables were 
initialized: accumulation of dead rows and dead space in the tables changes the results. To 
understand the results you must keep track of the total number of updates and when 
vacuuming happens. If autovacuum is enabled it can result in unpredictable changes in 
measured performance. 


A limitation of pgbench is that it can itself become the bottleneck when trying to test a large 
number of client sessions. This can be alleviated by running pgbench on a different machine 
from the database server, although low network latency will be essential. It might even be 
useful to run several pgbench instances concurrently, on several client machines, against 
the same database server. 


vacuumlo 


Name 


vacuumlo -- 从 PostgreSQL 数据 库 移 除 孤立 的 大 对 象 


Synopsis 


vacuumlo [ _option_...] _dbname_ ... 





vacuumlo 是 一 个 "A" M PostgreSQL 数据 库 移 除 所 有 孤立 的 大 对 象 的 简单 程序 . 一 个 大 对 象 
(LO) 被 认为 是 DID 不 在 任何 数据 库 的 数据 列 的 oid 或 者 or lo 中 的 LO. 


当 摸 使 用 它 , 你 可 能 会 对 lo 模块 中 的 lo_manage 触发 器 感 兴趣 .1lo_manage 在 一 开始 党 试 避免 
创造 孤立 的 LOs 是 非常 有 用 的 . 


使 行 中 出 现 的 数据 库 都 是 处 理 过 的 . 


选项 


vacuumlo 接受 下 面 的 命令 行 参数 : 
-1 RAL 


每 个 事务 移 除 不 超过 BRA 数量 的 大 对 象 (默认 1000). 如 果 服 务 每 移 除 一 个 LO 就 获得 一 个 
锁 , 在 一 个 事务 中 移 除 太 多 的 LOs 是 非常 危险 的 max locks_per transaction. 如 果 你 想 要 所 有 
移 除 在 一 个 单独 的 事务 设置 限制 为 0. 


=n 


不 移 除 任何 未 西 ,只 是 显示 什么 将 要 被 执行 . 


=M 


输 H= 系列 的 进度 信息 


-V > --version 


打印 vacuumlo 版 本 并 且 退 出 . 


-?  --help 


显示 vacuumlo 的 命令 行 参 数 , 并 且 


vacuumlo 也 接受 下 面 的 命令 行 参数 作为 连接 参 : 


-h ME 
数据 库 服务 器 的 主机 . 

-p "O 
数据 库 服务 器 的 端口 . 

-U  _ 用 户 名 _ 
作为 连接 服务 器 的 用 户 名 . 

-w --no-password 


从 来 不 发 出 密码 提示 . 如 果 服 务 器 要 求 密 码 认 证 并 且 通 过 其 他 方法 比如 .pgpass 文件 中 不 能 获 
AY, 连接 党 试 将 会 失败 . 在 批 处 理 任 务 或 脚本 中 没有 用 户 输入 密码 的 时 候 这 个 选项 将 会 变 得 很 
有 用 . 


-w 
在 连接 数据 库 之 前 强制 Vacuumlo 提示 密码 输入 . 


这 个 选项 不 是 必要 的 , 因为 vacuumlo 将 会 自 (RO ade ican lair 
然而 , vacuumlo 将 会 浪费 一 个 连接 党 试 去 找 出 服务 器 是 否 需 要 密码 . 在 某 些 情况 下 使 用 -w 选 
项 来 避免 额外 的 连接 党 试 是 值得 的 . 


说 明 


vacuumlo 以 下 面 的 方法 工作 : 首先 , vacuumlo 创建 一 个 包含 所 有 选择 数据 库 的 大 对 象 OIDs 的 
临时 表 . 然后 扫描 数据 库 中 是 oid 或 者 lo 类 型 的 所 有 列 , 然后 从 临时 表 中 移 除 匹配 的 记录 . 

(注意 : 只 有 这 些 名 字 的 类 型 才 被 者 虑 ; 特别 是 , 超过 它们 范围 的 不 被 考虑 .) 临时 表 中 剩 下 的 记录 
被 认证 维 LOs 对 象 .它们 将 会 被 移 除 . 


作者 


Peter Mount &1t;[peter@retep.org.uk](mailto:peter@retep.org.uk)&gt; 


G.2. 服务 器 新 应 用 程序 


Table of Contents 


pg_archivecleanup -- clean up PostgreSQL WAL archive files 

pg_standby -- supports the creation of a PostgreSQL warm standby server 
pg_test_fsync -- determine fastest wal_sync_method for PostgreSQL 
pg_test_timing -- measure timing overhead 

pg_upgrade -- 升级 PostgreSQL 数据 库 实例 

pg_xlogdump -- 显示 人 类 易 读 泻 染 的 PostgreSQL 数据 库 集合 实例 的 预 写 日 志 


这 部 分 在 contrib 中 包含 PostgreSQL 服 务 器 相关 应 用 程序 。 它 们 通常 运行 在 数据 库 服务 器 
存在 的 主机 上 。 参 阅 Reference Ill, PostgreSQL 服务 器 应 用 程序 获取 关于 核心 PostgreSQL 
发 布 部 分 服务 器 端 应 用 程序 的 信息 。 


pg_archivecleanup 


Name 


pg_archivecleanup -- clean up PostgreSQL WAL archive files 


Synopsis 





pg_archivecleanup [ option P| archivelocation_ _oldestkeptwalfile_ 


Description 


pg_archivecleanup is designed to be used as an archive_cleanup_command to clean up WAL 
file archives when running as a standby server (see Section 25.2). pg_archivecleanup can 
also be used as a standalone program to clean WAL file archives. 


To configure a standby server to use pg_archivecleanup, put this into its recovery.conf 
configuration file: 


archive_cleanup_command = 'pg_archivecleanup _archivelocation_ %r' 


where _archivelocation_ is the directory from which WAL segment files should be 
removed. 


When used within archive_cleanup_ command, all WAL files logically preceding the value of 
the %r argument will be removed from _archivelocation_ . This minimizes the number of 
files that need to be retained, while preserving crash-restart capability. Use of this parameter 
is appropriate if the _archivelocation_ is a transient staging area for this particular standby 
server, but not when the _archivelocation_ is intended as a long-term WAL archive area, or 
when multiple standby servers are recovering from the same archive location. 


When used as a standalone program all WAL files logically preceding the 
_oldestkeptwalfile_ will be removed from _archivelocation_ . In this mode, if you specify a 
.backup file name, then only the file prefix will be used as the _oldestkeptwalfile_ . This 

allows you to remove all WAL files archived prior to a specific base backup without error. For 

example, the following example will remove all files older than WAL file name 


000000010000003700000010 


pg_archivecleanup -d archive 000000010000003700000010.00000020. backup 


pg_archivecleanup: keep WAL file "archive/000000010000003700000010" and later 
pg_archivecleanup: removing file "archive/00000001000000370000000F" 
pg_archivecleanup: removing file "archive/00000001000000370000000E" 


pgarchivecleanup assumes that ‘_archivelocation is a directory readable and writable by 
the server-owning user. 


Options 
pg_archivecleanup accepts the following command-line arguments: 
-d 
Print lots of debug logging output on stderr . 
-n 
Print the names of the files that would have been removed on stdout (performs a dry run). 
-V``--version 
Print the pg_archivecleanup version and exit. 
-x _extension_ 


When using the program as a standalone utility, provide an extension that will be stripped 
from all file names before deciding if they should be deleted. This is typically useful for 
cleaning up archives that have been compressed during storage, and therefore have had an 
extension added by the compression program. For example: -x .gz . 


Note that the .backup file name passed to the program should not include the extension. 
-?  --help 


Show help about pg_archivecleanup command line arguments, and exit. 


Notes 


pg_archivecleanup is designed to work with PostgreSQL 8.0 and later when used as a 
standalone utility, or with PostgreSQL 9.0 and later when used as an archive cleanup 
command. 


pg_archivecleanup is written in C and has an easy-to-modify source code, with specifically 
designated sections to modify for your own needs 


Examples 
On Linux or Unix systems, you might use: 


archive_cleanup_command = 'pg_archivecleanup -d /mnt/standby/archive %r 2>>cleanup.log' 


a] = ;| 








where the archive directory is physically located on the standby server, so that the 
archive_command is accessing it across NFS, but the files are local to the standby. This will: 


e produce debugging output in cleanup.log 


e remove no-longer-needed files from the archive directory 


Author 


Simon Riggs &1t; [simon@2ndquadrant .com] (mailto:simon@2ndquadrant.com)&gt; 


See Also 


pg_standby 


pg_standby 


Name 


pg_ standby -- supports the creation of a PostgreSQL warm standby server 


Synopsis 





pg_standby [ option | archivelocation_ -_nextwalfile_ _xlogfilepath_ 


[ _restartwalfile_ ] 


Description 


pg_standby supports creation of a "warm standby" database server. It is designed to be a 
production-ready program, as well as a customizable template should you require specific 
modifications. 


pg_standby is designed to be a waiting restore_command , which is needed to turn a 
standard archive recovery into a warm standby operation. Other configuration is required as 
well, all of which is described in the main server manual (See Section 25.2). 


To configure a standby server to use pg_standby, put this into its recovery.conf 
configuration file: 


restore_command = 'pg_standby _archiveDir_ %f %p %r' 


where _archiveDir_ is the directory from which WAL segment files should be restored. 


If _restartwalfile_ is specified, normally by using the %r macro, then all WAL files 
logically preceding this file will be removed from _archivelocation_ . This minimizes the 
number of files that need to be retained, while preserving crash-restart capability. Use of this 
parameter is appropriate if the _archivelocation_ is a transient staging area for this 
particular standby server, but not when the _archivelocation_ is intended as a long-term 
WAL archive area. 


pgstandby assumes that 
‘_archivelocation is a directory readable by the server-owning user. If restartwalfile (or - 
k ) is specified, the archivelocation directory must be writable too. 


There are two ways to fail over to a "warm standby" database server when the master server 
fails: 


Smart Failover 


In smart failover, the server is brought up after applying all WAL files available in the archive. 
This results in zero data loss, even if the standby server has fallen behind, but if there is a lot 
of unapplied WAL it can be a long time before the standby server becomes ready. To trigger 
a smart failover, create a trigger file containing the word smart , or just create it and leave it 
empty. 


Fast Failover 


In fast failover, the server is brought up immediately. Any WAL files in the archive that have 
not yet been applied will be ignored, and all transactions in those files are lost. To trigger a 
fast failover, create a trigger file and write the word fast into it. pg_ standby can also be 
configured to execute a fast failover automatically if no new WAL file appears within a 
defined interval. 


Options 


pg_standby accepts the following command-line arguments: 


=C 


Use cp or copy command to restore WAL files from archive. This is the only supported 
behavior so this option is useless. 


-d 


Print lots of debug logging output on stderr . 


-k 


Remove files from _archivelocation_ so that no more than this many WAL files before the 
current one are kept in the archive. Zero (the default) means not to remove any files from 
_archivelocation_ . This parameter will be silently ignored if _restartwalfile_ is specified, 
since that specification method is more accurate in determining the correct archive cut-off 
point. Use of this parameter is deprecated as of PostgreSQL 8.3; it is safer and more 
efficient to specify a _restartwalfile_ parameter. A too small setting could result in removal 
of files that are still needed for a restart of the standby server, while a too large setting 
wastes archive space. 


-r  _maxretries_ 


Set the maximum number of times to retry the copy command if it fails (default 3). After each 
failure, we wait for _sleeptime_ * _num_retries_ so that the wait time increases 
progressively. So by default, we will wait 5 secs, 10 secs, then 15 secs before reporting the 
failure back to the standby server. This will be interpreted as end of recovery and the 
standby will come up fully as a result. 


-s _sleeptime_ 


Set the number of seconds (up to 60, default 5) to sleep between tests to see if the WAL file 
to be restored is available in the archive yet. The default setting is not necessarily 
recommended; consult Section 25.2 for discussion. 


-t _triggerfile_ 


Specify a trigger file whose presence should cause failover. It is recommended that you use 
a structured file name to avoid confusion as to which server is being triggered when multiple 
servers exist on the same system; for example /tmp/pgsql.trigger.5432 . 


-V``--version 
Print the pg_standby version and exit. 
-w _maxwaittime_ 


Set the maximum number of seconds to wait for the next WAL file, after which a fast failover 
will be performed. A setting of zero (the default) means wait forever. The default setting is 
not necessarily recommended; consult Section 25.2 for discussion. 


-? --help 


Show help about pg_standby command line arguments, and exit. 


Notes 


pg_standby is designed to work with PostgreSQL 8.2 and later. 


PostgreSQL 8.3 provides the %r macro, which is designed to let pg_standby know the last 
file it needs to keep. With PostgreSQL 8.2, the -k option must be used if archive cleanup is 
required. This option remains available in 8.3, but its use is deprecated. 


PostgreSQL 8.4 provides the recovery_end_command option. Without this option a leftover 
trigger file can be hazardous. 


pg_standby is written in C and has an easy-to-modify source code, with specifically 
designated sections to modify for your own needs 


Examples 


On Linux or Unix systems, you might use: 


archive_command = "cp %p .../archive/%f' 
restore_command = 'pg_standby -d -s 2 -t /tmp/pgsql.trigger.5442 .../archive %f %p %r 2>> 
recovery_end_command = 'rm -f /tmp/pgsql.trigger.5442' 


J Sa a 








where the archive directory is physically located on the standby server, so that the 
archive_command is accessing it across NFS, but the files are local to the standby (enabling 
use of 1n ). This will: 


e produce debugging output in standby.1og 
e sleep for 2 seconds between checks for next WAL file availability 


e stop waiting only when a trigger file called /tmp/pgsql.trigger.5442 appears, and 
perform failover according to its content 


e remove the trigger file when recovery ends 
e remove no-longer-needed files from the archive directory 


On Windows, you might use: 


archive_command = 'copy %p ...\\archive\\%f' 
restore_command = 'pg_standby -d -s 5 -t C:\pgsql.trigger.5442 ...\archive %f %p %r 2>>st 


recovery_end_command = 'del C:\pgsql.trigger.5442' 





Note that backslashes need to be doubled in the archive_command , but notin the 


restore_command Or recovery_end_command . This will: 

e use the copy command to restore WAL files from archive 

e produce debugging output in standby.1log 

e sleep for 5 seconds between checks for next WAL file availability 


e stop waiting only when a trigger file called c:\pgsql.trigger.5442 appears, and perform 
failover according to its content 


e remove the trigger file when recovery ends 


e remove no-longer-needed files from the archive directory 


The copy command on Windows sets the final file size before the file is completely copied, 
which would ordinarily confuse pg_standby. Therefore pg_standby waits sleeptime 
seconds once it sees the proper file size. GNUWin32's cp sets the file size only after the 
file copy is complete. 


Since the Windows example uses copy at both ends, either or both servers might be 
accessing the archive directory across the network. 


Author 


Simon Riggs &1t; [simon@2ndquadrant .com] (mailto: simon@2ndquadrant .com)&gt; 


See Also 


pg_archivecleanup 


pg_test_fsync 


Name 


pg_test_fsync -- determine fastest wal_sync_method for PostgreSQL 


Synopsis 


pg_test_fsync [ _option_ ...] 


Description 


pg_test_fsync is intended to give you a reasonable idea of what the fastest 
wal_sync_method is on your specific system, as well as supplying diagnostic information in 
the event of an identified I/O problem. However, differences shown by pg_test_fsync might 
not make any significant difference in real database throughput, especially since many 
database servers are not speed-limited by their transaction logs. pg_test_fsync reports 
average file sync operation time in microseconds for each wal_sync_method , which can also 
be used to inform efforts to optimize the value of commit_delay. 


Options 


pg_test_fsync accepts the following command-line options: 


-f° --filename 


Specifies the file name to write test data in. This file should be in the same file system that 
the pg_xlog directory is or will be placed in. ( pg_xlog contains the WAL files.) The default 
iS pg_test_fsync.out in the current directory. 


-S f secs- per test 


Specifies the number of seconds for each test. The more time per test, the greater the test's 
accuracy, but the longer it takes to run. The default is 5 seconds, which allows the program 
to complete in under 2 minutes. 


-V --version 


Print the pg_test_fsync version and exit. 


-?  --help 


Show help about pg_test_fsync command line arguments, and exit. 


Author 


Bruce Momjian &1t; [bruce@momjian.us](mailto:bruce@momjian.us)&gt; 


See Also 


postgres 


pg_test_timing 


Name 


pg_test_timing -- measure timing overhead 


Synopsis 


pg_test_timing [ _option_ ...] 


Description 


pg_test_timing is a tool to measure the timing overhead on your system and confirm that the 
system time never moves backwards. Systems that are slow to collect timing data can give 
less accurate EXPLAIN ANALYZE results. 


Options 


pg_test_timing accepts the following command-line options: 
-d _duration_~~--duration=°~_duration_ 


Specifies the test duration, in seconds. Longer durations give slightly better accuracy, and 
are more likely to discover problems with the system clock moving backwards. The default 
test duration is 3 seconds. 


-V --version 
Print the pg_test_timing version and exit. 
-?  --help 


Show help about pg_test_timing command line arguments, and exit. 


Usage 


Interpreting results 


Good results will show most (>90%) individual timing calls take less than one microsecond. 
Average per loop overhead will be even lower, below 100 nanoseconds. This example from 
an Intel i7-860 system using a TSC clock source shows excellent performance: 


Testing timing overhead for 3 seconds. 
Per loop time including overhead: 35.96 nsec 
Histogram of timing durations: 


< usec % of total count 
al 96.40465 80435604 
2 3.59518 2999652 
4 0.00015 126 
8 0.00002 13 
16 0.00000 2 


Note that different units are used for the per loop time than the histogram. The loop can 
have resolution within a few nanoseconds (nsec), while the individual timing calls can only 
resolve down to one microsecond (usec). 


Measuring executor timing overhead 


When the query executor is running a statement using EXPLAIN ANALYZE , individual 
operations are timed as well as showing a summary. The overhead of your system can be 
checked by counting rows with the psql program: 


CREATE TABLE t AS SELECT * FROM generate_series(1,100000) ; 
\timing 

SELECT COUNT(*) FROM t; 

EXPLAIN ANALYZE SELECT COUNT(*) FROM t; 


The i7-860 system measured runs the count query in 9.8 ms while the EXPLAIN ANALYZE 
version takes 16.6 ms, each processing just over 100,000 rows. That 6.8 ms difference 
means the timing overhead per row is 68 ns, about twice what pg_test_timing estimated it 
would be. Even that relatively small amount of overhead is making the fully timed count 
statement take almost 70% longer. On more substantial queries, the timing overhead would 
be less problematic. 


Changing time sources 


On some newer Linux systems, it's possible to change the clock source used to collect 
timing data at any time. Asecond example shows the slowdown possible from switching to 
the slower acpi_pm time source, on the same system used for the fast results above: 


# cat /sys/devices/system/clocksource/clocksource@/available_clocksource 

tsc hpet acpi_pm 

# echo acpi_pm > /sys/devices/system/clocksource/clocksourceO/current_clocksource 
# pg_test_timing 

Per loop time including overhead: 722.92 nsec 

Histogram of timing durations: 


< usec % of total count 
a, 27.84870 1155682 

2 72.05956 2990371 

4 0.07810 3241 

8 0.01357 563 

16 0.00007 3 


In this configuration, the sample EXPLAIN ANALYZE above takes 115.9 ms. That's 1061 nsec 
of timing overhead, again a small multiple of what's measured directly by this utility. That 
much timing overhead means the actual query itself is only taking a tiny fraction of the 
accounted for time, most of it is being consumed in overhead instead. In this configuration, 
any EXPLAIN ANALYZE totals involving many timed operations would be inflated significantly 
by timing overhead. 


FreeBSD also allows changing the time source on the fly, and it logs information about the 
timer selected during boot: 


# dmesg | grep "Timecounter" 

Timecounter "ACPI-fast" frequency 3579545 Hz quality 900 
Timecounter "i8254" frequency 1193182 Hz quality 0 
Timecounters tick every 10.000 msec 

Timecounter "TSC" frequency 2531787134 Hz quality 800 

# sysctl kern.timecounter.hardware=TSC 
kern.timecounter.hardware: ACPI-fast -> TSC 


Other systems may only allow setting the time source on boot. On older Linux systems the 
"clock" kernel setting is the only way to make this sort of change. And even on some more 
recent ones, the only option you'll see for a clock source is "jiffies". Jiffies are the older Linux 
software clock implementation, which can have good resolution when it's backed by fast 
enough timing hardware, as in this example: 


$ cat /sys/devices/system/clocksource/clocksource0/available_clocksource 
jiffies 

$ dmesg | grep time.c 

time.c: Using 3.579545 MHz WALL PM GTOD PIT/TSC timer. 

time.c: Detected 2400.153 MHz processor. 

$ pg_test_timing 

Testing timing overhead for 3 seconds. 

Per timing duration including loop overhead: 97.75 ns 

Histogram of timing durations: 


< usec % of total count 
al 90.23734 27694571 

2 9.75277 2993204 

4 0.00981 3010 

8 0.00007 22 

16 0.00000 al 

32 0.00000 all 


Clock hardware and timing accuracy 


Collecting accurate timing information is normally done on computers using hardware clocks 
with various levels of accuracy. With some hardware the operating systems can pass the 
system clock time almost directly to programs. A system clock can also be derived from a 
chip that simply provides timing interrupts, periodic ticks at some known time interval. In 
either case, operating system kernels provide a clock source that hides these details. But 
the accuracy of that clock source and how quickly it can return results varies based on the 
underlying hardware. 


Inaccurate time keeping can result in system instability. Test any change to the clock source 
very carefully. Operating system defaults are sometimes made to favor reliability over best 
accuracy. And if you are using a virtual machine, look into the recommended time sources 
compatible with it. Virtual hardware faces additional difficulties when emulating timers, and 
there are often per operating system settings suggested by vendors. 


The Time Stamp Counter (TSC) clock source is the most accurate one available on current 
generation CPUs. It's the preferred way to track the system time when it's supported by the 
operating system and the TSC clock is reliable. There are several ways that TSC can fail to 
provide an accurate timing source, making it unreliable. Older systems can have a TSC 
clock that varies based on the CPU temperature, making it unusable for timing. Trying to use 
TSC on some older multicore CPUs can give a reported time that's inconsistent among 
multiple cores. This can result in the time going backwards, a problem this program checks 
for. And even the newest systems can fail to provide accurate TSC timing with very 
aggressive power saving configurations. 


Newer operating systems may check for the known TSC problems and switch to a slower, 
more stable clock source when they are seen. If your system supports TSC time but doesn't 
default to that, it may be disabled for a good reason. And some operating systems may not 
detect all the possible problems correctly, or will allow using TSC even in situations where 
it's Known to be inaccurate. 


The High Precision Event Timer (HPET) is the preferred timer on systems where it's 
available and TSC is not accurate. The timer chip itself is programmable to allow up to 100 
nanosecond resolution, but you may not see that much accuracy in your system clock. 


Advanced Configuration and Power Interface (ACPI) provides a Power Management (PM) 
Timer, which Linux refers to as the acpi_pm. The clock derived from acpi_pm will at best 
provide 300 nanosecond resolution. 


Timers used on older PC hardware include the 8254 Programmable Interval Timer (PIT), the 
real-time clock (RTC), the Advanced Programmable Interrupt Controller (APIC) timer, and 
the Cyclone timer. These timers aim for millisecond resolution. 


Author 


Ants Aasma 4l1t;[ants.aasma@eesti.ee](mailto:ants.aasma@eesti.ee)&gt; 


See Also 


EXPLAIN 


pg_upgrade 


Name 


pg_upgrade -- 升级 PostgreSQL 数据 库 实例 


Synopsis 


pg_upgrade -b -_oldbindir_ -B _newbindir -d -_olddatadir_ -D _newdatadir 


[ _option_ ...] 


pg_upgrade (原名 称 为 pg_migrator) 允许 数据 在 PostgreSQL 数据 文件 中 升级 到 PostgreSQL 
新 的 大 版 本 而 不 需要 数据 的 备份/ 还原， 通常 适用 在 升级 大 版 本 时 ， 例 如 从 8.4.7 升 级 到 当前 
PostgreSQL 的 新 最 新 版 本 。 在 小 版 本 之 间 升 级 往往 是 不 需要 的 ， 例如 从 9.0.1 升 级 到 9.0.4。 


PostgreSQL 大 版 本 更 新 会 定期 增加 新 的 功能 ， 这 往往 导致 系统 表 结 构 布局 经 常 改变 ， 但 是 内 
部 的 数据 的 存储 格式 很 少 改动 。 针对 这 种 情况 pg_upgrade 通过 建立 新 的 系统 表 和 简易 的 利 
用 旧 的 用 户 数据 文件 高 效 的 完成 升级 。 如 果 未 来 一 个 新 的 主要 版 本 改变 了 数据 存储 结构 这 将 
导致 日 数据 结构 无 法 读 取 ， pg_upgrade 将 不 能 完成 升级 。 (社区 会 试图 避免 这 种 情况 的 发 
生 。) 


pg_upgrade 能 很 好 的 完成 新 旧 实 例 的 二 进 制 兼容 ， 例 如 包括 32/64 二 进 制 的 兼容 性 编译 时 间 
设置 检查 。 检 查 任 何 一 个 外 部 模块 的 二 进 制 兼容 是 很 有 必要 的 ， 然 而 不 能 通过 pg_upgrade 来 
检查 。 


pg_upgrade 支持 从 8.3.X 升 级 到 最 近 的 PostgreSQL 主 要 发 行 版 本 ， 包括 快照 和 alpha 版 本 。 


选项 


pg_upgrade 可 以 使 用 下 面 命令 行 参数 : 
-b _old_bindir_**--old-bindir=**_old_bindir_ 

旧 的 数据 实例 的 可 执行 文件 目录 ; 环境 变量 PGBINOLD 
-B _new bindir  --new-bindir=**_new_bindir_ 


新 的 数据 实例 的 可 执行 文件 目录 ; 环境 变量 PGBINNEW 


-c --check 
仅 检 查实 例 ， 不 做 任何 数据 更 新 

-d _old datadir --old-datadir=``_old_datadir_ 

旧 的 群集 数据 目录 ;环境 变量 PGDATAOLD 

-D _new datadir  --new-datadir=**_new_datadir_ 

新 的 群集 数据 目录 ;环境 变量 PGDATANEW 

-j --jobs 

同时 使 用 的 进程 或 者 线程 数 

-k --link 

使 用 硬 链接 蔡 代 拷贝 文件 到 新 的 数据 库 实 例 (在 windows 使 用 NTFS 的 接点 ) 
-o _options_ --old-options _options_ 

options to be passed directly to the old postgres Command 

-0 _options_ --new-options _options_ 

options to be passed directly to the new postgres Command 


-p old_port_number --old-port=* ~_old_portnum_ 





旧 数 据 库 实例 的 端口 ;环境 变量 PGPORTOLD 


-P new_port_number --new-port=° ~_new_portnum_ 





新 数据 库 实例 的 端口 ;环境 变量 PEPORTNEW 
-r --retain 
即使 在 升级 成 功 也 保存 相关 的 SQL 和 日 志文 件 。 
数据 实例 的 超级 管理 员 名 ; 环境 变量 PGUSER 
-v --verbose 
启用 详细 的 内 部 日 志 信息 
-v --version 
打印 版 本 信息 ， 然 后 退出 


-? -h --help 


用 法 


用 pg_upgrade 进 行 升 级 的 步骤: 


1: 


选择 性 的 移动 实例 的 安装 目录 


如 果 你 用 了 指定 版 本 的 安装 目 录 ， 例如 /opt/PostgreSQL/9.1 , 你 不 需要 再 移动 旧 的 安装 
目录 。 图 形 化 安装 工具 都 是 指定 安装 目录 的 。 


如 果 你 的 安装 目录 不 是 版 本 指定 的 ， 例 如 /usr/local/pgsql , 这 就 有 必要 移动 当前 的 安 
装 目录 ， 这 样 就 避免 影响 了 新 的 PostgreSQL 的 安装 。 当 PostgreSQL 数据 库 服务 停止 
la, 重 命令 PostgreSQL 的 安装 目录 的 操作 是 安全 的 ;假如 旧 安 装 目录 是 
/usr/local/pgsql , 你 可 以 用 命 兮 : 


mv /usr/local/pgsql /usr/local/pgsql.old 


来 重 命令 当前 目录 名 。 
用 源码 安装 ， 构 建 一 个 新 的 版 本 


用 兼容 旧 的 数据 库 实 例 configure 选项 来 构建 新 的 PostgreSQL。 在 开始 升级 之 前 
pg_upgrade 将 会 检查 pg_controldata 来 确保 所 有 的 设置 都 兼容 。 


安装 新 的 二 进 制 文件 
安装 新 服务 器 的 二 进 制 可 执行 文件 和 支持 文件 。 
用 源码 安装 时 ， 如 果 你 想 要 在 自 定 义 目 录 安 装 新 服务 器 ， 可 以 使 用 prefix 变量 : 


gmake prefix=/usr/local/pgsql.new install 


Install pg_upgrade and pg_upgrade_support 


在 新 PostgreSQL 的 安装 中 ， 安 装 pg upgrade 二 进 制 文件 and pg _upgrade_support# X 
件 。 


初始 化 新 的 数据 库 实例 


使 用 initdb 命令 初始 化 新 的 数据 库 实例 。 并 且 ， 要 用 兼容 的 旧 数 据 库 实 例 的 initdb 选 
项 。 很 多 预 构建 安装 会 自动 完成 这 一 部 。 不 需要 去 启动 新 的 数据 库 实 例 。 


安装 自 定义 的 共享 对 象 文 件 


安装 所 以 旧 数 据 库 实例 用 到 的 自 定义 共享 对 象 文 件 〈 或 者 是 DLL 文件 ) ,例如 
pgcrypto.so , 无 论 他 们 来 自 contrib 或 者 其 它 的 源 。 不 需要 安装 一 类 模式 的 定义 ， 例 
如 pgcrypto.sql ,因为 这 些 也 会 从 旧 数 据 库 实例 中 升级 。 

.调整 连接 认证 


pg_upgrade 会 数 次 连 到 新 旧 数 据 库 实例 ， 所 以 你 修改 pg_hba.conf ,可 以 把 认证 设置 成 
trust 或 者 是 peer ， 另 外 也 可 以 使 用 mas 的 认证 方式 ， 同时 使 用 -/.pgpass 密码 
文件 (参考 Section 31.15). 


.停止 新 旧 数 据 库 
确保 两 个 数据 库 都 停止 使 用 ， 在 类 Unix 操 作 系 统 中 使 用 例如 : 


pg_ctl -D /opt/PostgreSQL/8.4 stop 
pg_ctl -D /opt/PostgreSQL/9.0 stop 


在 Windows 中 ， 使 用 windows 可 用 的 服务 名 : 


NET STOP postgresql-8.4 
NET STOP postgresql-9.0 


或 者 


NET STOP pgsql-8.3 (8.3 和 更 早 版 本 的 PostgreSQL 使 用 了 不 同 的 服务 器 ) 


. 1447 pg_upgrade 


运行 新 数据 库 的 可 执行 命令 pg upgrade, 而 不 是 旧 数 据 库 的 。 pg_upgrade 需要 指定 
新 旧 数 据 库 实例 的 数据 目录 和 可 执行 的 ( bin ) 目录 。 当然 你 还 可 以 指定 用 户 和 端口 ， 指 
定 是 否 使 用 数据 硬 链接 代替 使 用 数据 复制 (默认 方式 ) 。 


如 果 你 使 用 链接 模式 ， 升 级 将 会 非常 快 〈 没 有 文件 拷贝 ) 并 且 占 用 更 少 的 硬盘 ， 但 是 你 
不 能 再 访问 你 的 旧 数 据 库 当 你 升级 完成 启动 新 的 数据 库 实 例 。 链接 模式 还 需要 新 旧 数 据 
库 数据 目录 使 用 相同 的 文件 系统 。 (REHM pg_xlog 可 以 在 不 同 的 文件 系统 。) S 
考 pg_upgrade --help 查看 完整 的 帮助 选项 列表 。 


--jobs 选项 可 以 在 拷贝 /链接 数据 文件 时 使 用 多 CPU 核心 并 且 可 以 并 行 的 还 原 数据 库 模 
式 ; 一 个 好 的 值 是 CPU 核 数 和 表 空 间 的 最 大 值 。 在 一 个 多 核 数 据 库 机 器 上 升级 一 个 多 数据 
库 服 务 器 时 这 个 选项 能 大 量 的 节约 时 间 。 


For Windows users, you must be logged into an administrative account, and 对 于 
Windows 用 户 来 说 ， 你 必要 登录 一 个 管理 员 的 帐号 ， 并 且 用 postgres 用 户 来 启动 一 个 
终端 设置 可 用 的 PATH 


10. 


11. 


RUNAS /USER:postgres "CMD.EXE" 
SET PATH=%PATH%;C:\Program Files\PostgreSQL\9.0\bin; 


然后 运行 pg_upgrade 带 上 引号 ， 例如 : 


pg_upgrade.exe 
--old-datadir "C:/Program Files/PostgreSQL/8.4/data" 
--new-datadir "C:/Program Files/PostgreSQL/9.0/data" 
--oOld-bindir "C:/Program Files/PostgreSQL/8.4/bin" 
--new-bindir "C:/Program Files/PostgreSQL/9.0/bin" 


开始 以 后 ， pg_upgrade 会 验证 两 个 数据 库 实 例 是 兼容 的 然后 开始 升级 。 你 可 以 使 用 
pg_upgrade --check 去 执行 检查 工作 ， 甚 至 是 旧 数 据 库 实例 仍 在 运 

行 。 pg_upgrade --check 会 概述 一 些 自 定义 的 调整 你 需要 在 升级 后 去 查看 。 如 果 你 使 用 
了 链接 模式 ， 你 必需 要 要 用 --1link 参数 和 --check 来 启用 指定 链接 模式 的 检查 。 
pg_upgrade 需要 对 当前 目录 有 可 写 权 限 。 


在 数据 库 升 级 过 程 中 不 能 访问 数据 库 实例 这 是 显而易见 的 。pg_upgrade 默认 在 端口 
50432 运 行 来 避免 预期 之 外 的 数据 库 连 接 。 当 你 在 升级 的 时 候 你 可 以 在 新 旧 数 据 库 实例 
上 使 用 同一 个 端口 因为 新 旧 数 据 库 实例 不 会 同时 运行 然而 ， 当 查 检 旧 数据 库 实例 时 ， 新 
旧 数 据 库 实例 的 端口 必需 不 同 。 


如 果 在 还 原 数 据 库 模式 时 出 现 错误 时 ， pg_upgrade 将 会 退出 你 必需 参照 step 14 的 概要 
信息 还 原 旧 实 例 再 一 次 使 用 pg_upgrade ， 你 可 能 需要 修改 旧 实 例 以 让 旧 数 据 库 模 式 A 
级 成 功 。 如 果 问 题 出 现在 某 个 外 部 模块 上 ， 你 可 能 需要 从 旧 实 例 上 和 扼 载 这 些 外 部 模块 然 
后 在 升级 成 功 后 再 在 新 实例 上 安装 它们 ， 假 设 模块 没有 被 用 于 储存 用 户 数据 。 


还 原 pg_hba.conf 


如 果 你 修改 pg_hba.conf 成 trust 的 方式 ， 还原 它 的 原来 的 认证 设置 。 还 有 可 能 需 
去 调整 其 它 的 配置 文件 去 和 旧 的 数据 库 实例 相 匹 配 ， 例 如 。 postgresql.conf . 


升级 后 的 处 理 


如 果 有 升级 后 续 操作 需要 执行 ，pg_upgrade 会 在 完成 后 发 布 出 警告 信息 。 同时 它 会 生成 
由 管理 员 运 行 脚本 文件 。 脚本 会 连 到 新 旧 数 据 库 执行 后 续 操作 。 脚本 可 以 用 下 面 命令 执 
行 : 


psql --username postgres --file script.sql postgres 


脚本 可 以 任意 顺序 执行 ， 执 行 完 后 可 以 被 删除 。 
Caution 


通常 情况 下 在 重建 脚本 运行 结束 之 前 不 允许 访问 被 引用 的 表 ; 这 样 做 可 能 会 出 现 意 想不到 
的 错误 结果 或 者 是 性 能 不 佳 。 不 引用 的 表 可 以 被 立 限 访问 。 


1. 统计 


因为 优化 统计 结果 不 会 被 pg_upgrade 传递 ， 你 需要 指定 去 运行 命令 去 在 升级 完成 后 生 
成 一 些 新 的 信息 。 你 可 能 需要 设置 连接 参数 去 匹配 新 的 数据 库 实 例 。 


2， 删 除 旧 的 数据 库 实例 


当 pg_upgrade 成 功 的 升级 完成 后 ， 你 可 能 要 运行 脚本 的 方法 删除 旧 的 数据 库 实例 的 数 
据 目 录 你 可 以 删除 旧 安 装 目 录 (例如 。 bin, share )。 


3. 还 原 到 旧 实 例 
如 果 ， 运 行 pg_upgrade A, 你 希望 回复 到 旧 实 例 ， 下 面 是 一 些 选项 : 


o 如 果 你 运行 了 加 - -check 参数 的 pg_upgrade ， 不 会 对 旧 数 据 实 例 产 生 影 响 可 以 随 
时 更 新 实用 。 


o 如 果 你 运行 了 加 --1ink 参数 的 pg_upgrade 数据 文件 会 被 新 旧 数 据 实例 所 共用 ， 如 
果 你 启动 了 新 数据 实例 ， 新 的 数据 库 会 写 到 那些 共享 文件 上 ， 这 对 旧 实 例 是 不 安全 
的 。 

o 如 果 你 运行 了 不 加 --1ink 参数 的 pg_upgrade 或 者 没有 启动 新 的 数据 库 ， 旧 实例 并 
没有 被 修改 过 ， 如 果 链 接 开 始 ， .old 后 级 会 出 现在 $PGDATA/global/pg_control H 


录 下 。 为 了 重新 旧 数 据 实例 ， 可 以 从 $PGDATA/global/pg_control 目 录 下 移 
除 .old 后 级 的 文件 ;然后 你 可 以 重启 旧 实 例 。 


注意 事项 


pg_upgrade 不 支持 包含 有 reg* 类 型 的 OID- 引 用 比如 以 下 类 型 : regproc ，regprocedure , 
regoper , regoperator , regconfig ,and regdictionary Lei regtype 可 以 被 升级 。 ) 


所 有 失败 ， Be, 和 重建 索引 会 影响 到 你 升级 都 会 被 pg_upgrade 报 告 。 升级 后 的 重建 表 和 
索引 会 自动 生成 。 如 果 你 党 试 自动 升级 多 个 实例 ， 你 应 该 找到 相同 的 数据 模式 需要 相同 的 升 
级 后 步骤 对 所 以 的 实例 升级 ;这 是 因为 升级 后 的 步骤 是 基于 数据 库 模式 的 ， 而 不 是 用 户 数据 。 


部 署 测试 ， 可 以 创建 一 个 只 读 的 模式 从 旧 数 据 实例 复制 ， 插 和 一些 虚拟 的 数据 ， 然后 升级 他 
们 。 

如 果 你 升级 PostgreSQL 9.2 版 本 之 前 只 用 一 个 仅 配 置 目 录 的 的 数据 库 ， 你 必要 传递 真 的 数据 
目录 给 pg_upgrade, 并 且 给 数据 库 传 递 配置 目录 ， 例如 。 


-d /real-data-directory -o '-D /configuration-directory' o 


如 果 用 一 个 9.1 之 前 用 了 非 默认 的 Unix 域 socket 目 录 或 者 默认 的 位 置 和 新 实例 默认 位 置 不 一 
致 ， 要 设置 pcHosT 来 指定 旧 数 据 库 的 socket 位 置 。 (在 Windows 下 不 需要 。) 


一 个 日 志 同 步 的 数据 库 (Section 25.2) 不 能 被 升级 原因 是 升级 数据 库 必需 要 允许 写 。 很 简单 
的 方式 是 升级 方 库 然后 用 rsync 去 重新 建 备份。 你 可 以 运行 rsync 当主 库 停 用 后 ， 或 者 作为 
一 次 基础 各 份 (Section 24.3.2) 去 覆盖 旧 的 数据 库 各 份 。 


如 果 你 想 要 用 link 方 式 并 且 当 新 实例 启动 后 你 不 想 要 你 的 旧 数据 库 实例 数据 被 修改 用 rsync 
从 运行 中 的 旧 实 例 新 建 一 个 脏 的 数据 复制 ， 然 后 关闭 旧 实 例 再 一 次 运行 rsync 保证 所 有 的 数 
据 更 改 保 持 一 致 的 。 你 可 能 需要 排除 一 些 文件 ， 例如 。 postmaster.pid , 还 有 在 Section 
24.3.3 提 到 的 文件 。 


从 PostgreSQL 8.3 升 级 的 局 限 性 


从 PostgreSQL 8.3 升级 有 一 些 额 外 的 条 件 没 有 被 提 及 当 升 级 到 以 后 的 PostgreSQL 发 行 版 
A, 举 个 例子 ， 在 8.3 版 本 中 如 果 用 户 字段 中 定义 了 : 


。 一 个 tsquery 数据 类 型 

© 数据 类 型 name 并 不 是 第 一 个 字段 pg_upgrade 将 不 支持 升级 。 
你 必需 要 删除 任何 这 样 的 字段 并 且 手 动 升 级 他 们 。 
如 果 ltree 模块 被 安装 到 数据 库 中 ，pg_upgradebu 将 不 支持 。 
pg_upgrade 会 需要 重建 表 如 果 表 : 

。 一 个 字段 的 数据 类 型 是 tsvector 
pg_upgrade 会 需要 重建 索引 如 果 : 

。 一 个 索引 的 类 型 是 hash 或 者 GIN 

e 一 个 使 用 了 bpchar_pattern_ops 的 索引 


Elh, PostgreSQL 8.3 之 后 的 版 本 默认 的 日 期 存储 格式 更 改 到 整 型 。 pg_upgrade 会 查 检 日 
期 存储 格式 让 新 旧 数 据 库 实例 匹配 。 确 保 你 的 新 实例 是 构建 时 configure 带 上 

了 --disable-integer-datetimes BR, 

对 于 Windows 用 户 ， 要 注意 的 不 同 的 整 型 的 日 期 类 型 设置 是 在 图 形 华 和 MSI 安 装 程序 中 ， 它 

仅仅 可 能 从 版 本 8.3 的 安装 版 到 8.4 升 级 或 者 最 近 的 安装 版 。 不 可 能 从 MSI 安 装 程序 到 升级 新 的 
图 形 化 安装 程序 中 。 


参考 


initdb, pg_ctl, pg_dump, postgres 


pg_xlogdump 


Name 


pg_xlogdump -- 显示 人 类 易 读 泻 染 的 PostgreSQL 数据 库 集 合 实例 的 预 写 日 志 


Synopsis 


pg_xlogdump [ option ...] [ startseg [ endseg ] ] 


Fea aah 
pg_xlogdump 显示 预 写 日 志 (WAL) 并 且 主 要 用 于 调试 或 者 教学 演示 。 
这 个 实用 工具 只 能 被 安装 数据 库 的 用 户 来 运行 ， 因 为 这 需要 只 读 的 方式 访问 数据 字典 。 


选项 


以 下 的 命令 行 参数 控制 了 输出 的 位 置 和 格式 : 


_startseg_ 


开始 从 指定 WAL 段 文件 读 取 。 这 隐 式 的 确定 了 搜索 文件 和 使 用 的 时 间 线 。 


_endseg_ 


指定 到 哪个 WAL 段 文件 停止 读 取 。 


-b``--bkp-details 
输出 关于 各 份 数 据 块 的 详细 信息 。 

-e _end --end=``_end_ 

指定 停止 读 取 的 日 志 位 置 ， 代 蔡 读 取 的 日 志 流 的 结尾 。 
-n _limit_ --limit=``_limit_ 

指定 显示 记录 的 条 目 数 。 

-p _path --path=``_path_ 


指定 搜索 WAL 段 文件 的 目录 。 默 认 从 当前 目录 的 pg_xlog 子 目 录 去 搜索 它们 。 


-rr  _rmgr_ --rmgr=``_rmgr_ 


过 滤 由 指定 资源 管理 器 产生 的 记录 。 如 果 list 一 个 指定 一 个 名 字 ， 打印 一 列 合法 的 资源 管 
理 器 的 名 字 的 记录 ， 然 后 退出 。 


-s _start_ --start=>~_start_ 
开始 读 取 日 志 的 位 置 。 黑 认 是 从 最 早 的 文件 搜索 到 的 第 一 个 有 效 的 日 志 记 录 开 始 。 
-t _timeline  --timelime=``_timeline_ 


从 哪个 时 间 线 读 取 日 志 记 录 。 如 果 startseg 的 值 被 指定 默认 就 使 用 startseg; 否则 默认 值 是 
Ts 


-v --version 
打印 出 pg_xlogdump 版 本 并 且 退 出 。 
-x _xid --xid=``_xid_ 

仅 显 示 指 定 事务 ID 的 记录 。 

-2 --help 


显示 pg_xlogdump 命令 参数 帮助 ， 然 后 退出 。 


Sa N 
yt FS 
能 在 系统 运行 时 得 到 错误 结果 。 


仅 显 示 指 定时 间 线 的 记录 (如 果 未 指定， 就 用 默认 值 ) 。 其 它 时 间 线 的 记录 将 被 忽略 。 


参考 


Section 29.5 


Appendix H. 外 部 项 目 


Table of Contents 


。 H.1. 客户 端 接口 
e H.2. 管理 工具 
e H.3. 过 程 语言 
。 H.4. 扩展 


PostgreSQL 是 一 项 复 末 的 软件 项 目 ， 管 理 它 是 一 项 困难 的 工作 。 我 们 发 现 许 多 PostgreSQL 
的 增强 可 以 通过 独立 于 主 项 目的 方式 更 好 地 开发 。 


H.1. & P imiz O 


在 基本 的 PostgreSQL 发 布 中 仅 包 含 两 个 客户 端 接口 : 
。 libpq 被 包含 的 原因 是 它 是 主 C 语 言 接口 ， 许多 其 它 客 户 端 接口 都 依赖 于 它 。 


e ECPG 被 包含 的 原因 是 它 是 它 依赖 于 服务 器 端 SQL 语 法 ， 因此 对 PostgreSQL 自 身 的 变化 
非常 敏感 。 


除 此 以 外 的 所 有 其 它 语言 的 接口 都 是 外 部 项 目 并 独立 发 布 ，Table H-1 列 出 了 其 中 的 一 些 。 需 
要 注意 的 是 其 中 的 一 些 发 布 许可 证 与 PostgreSQL 不 同 。 要 了 解 更 多 关于 每 种 语言 的 接口 细节 
以 及 许可 证 等 信息 ， 请 参考 它们 各 自 的 文档 。 


Table H-1. 外 部 客户 端 接口 


名 字 语言 注释 网 站 
DBD::Pg Perl Perl DBI 了 驱动 http://search.cpan.org/dist/DBD-Pg/ 
JDBC JDBC 类 型 4 JDBC 了 驱动 http://jdbc.postgresql.org/ 
libpgxx C++ 新 型 C++ 接口 http://pqxx.org/ 
Npgsql .NET .NET 数 据 提供 者 http://npgsql.projects.postgresql.org/ 
pgtclng Tel http://sourceforge.net/projects/pgtcing/ 
psqlODBC ODBC ODBC 了 驱动 http://psqlodbc.projects.postgresql.org/ 


psycopg Python DB API 2.0- 兼 容 http://initd.org/psycopg/ 


H.2. EHIE 


有 几 个 PostgreSQL 可 用 的 管理 工具 。 最 受 欢迎 的 是 pgAdmin Ill, 还 有 一 些 商 业 上 可 用 的 。 


H.3. HAS 


PostgreSQL 在 基本 发 布 中 包含 PL/pgSQL，PL/Tcl， PL/Perl 和 PL/Python 过 程 语 言 。 


除 此 之 外 ， 还 有 一 些 在 基本 PostgreSQL 发 布 之 外 开发 和 维护 的 过 程 语言 ， Table H-2 列 出 了 
其 中 的 一 些 。 需要 注意 的 是 其 中 的 一 些 发 布 许可 证 与 PostgreSQL 不 同 。 要 了 解 更 多 关于 每 
种 过 程 语言 的 细节 以 及 许可 证 等 信息 ， 请 参考 它们 各 自 的 文档 。 


Table H-2. 外 部 维 扩 的 过 程 语言 


名 字 语言 
PL/Java Java 
PL/PHP PHP 
PL/Py Python 
PL/R R 
PL/Ruby Ruby 


PL/Scheme Scheme 
PL/sh Unix shell 


网 站 
http://pljava. projects.postgresql.org/ 
http://www.commandprompt.com/community/plphp/ 
http://python.projects.postgresql.org/backend/ 
http://www. joeconway.com/plr/ 
http://raa.ruby-lang.org/project/pl-ruby/ 
http://plscheme. projects. postgresql.org/ 
http://plsh.projects. postgresql.org/ 


H.4. 7 E 


PostgreSQL 很 容易 设计 成 可 以 扩展 的 。 因此 ， 加 载 到 数据 库 的 扩展 可 以 像 编译 特性 一 

样 。 contrib/ 目录 附带 包含 若干 扩展 的 源 代码 。 在 Appendix F 中 被 描述 。 其 它 扩展 是 独立 开 
发 的 ， 比如 PostGIS。 甚至 PostgreSQL 的 复制 方案 也 是 在 外 部 开发 的 。 比如 Slony-| 是 一 个 
流行 的 主 /从 复制 方案 ， 它 就 是 独立 在 核心 项 目 之 外 开发 的 。 


Appendix I. 源 代码 库 


PostgreSQL 的 源 代码 存放 和 管理 是 通过 Git 版 本 控制 系统 。 主 源 代码 库 的 公共 镜像 是 可 用 
的 ; 它 会 在 一 分 钟 内 从 主 源 代码 库 同 步 所 有 更 新 。 


在 我 们 的 wiki, http://wiki.postgresql.org/wiki/Working_with_Git， 上 面 有 一 些 关 于 使 用 Git 的 使 
用 说 明 。 


注意 : 从 源 代码 库 构 建 PostgreSQL 需要 合理 最 新 版 本 的 bison， flex, 和 Perl 工 具 。 当 从 
版 本 发 行 包 构 建 PostgreSQL 并 不 需要 这 些 工具 ， 因为 这 些 文件 已 经 包含 在 发 行 包 里面 。 其 
它 工 具 需 求 和 以 下 显示 一 样 Chapter 15, 


st JB: ` ~ < = 
1.1. 获得 源 代 码 通过 Git 
使 用 Git 你 可 以 从 源 代 码 库 复制 一 份 完整 源 代 码 到 你 的 本 机 上 ， 这 样 你 就 可 以 离线 访问 所 有 
的 代码 历史 和 分 支 。 这 是 开发 或 者 测试 补丁 最 为 快捷 并 且 灵 活 的 方式 。 
Git 


1. 你 将 需要 一 个 已 经 安装 的 Git， 你 可 以 从 http://git-scm.com 得 到 。 大 多 数 操作 系统 已 经 
默认 安 装 有 最 新 版 的 Git, 或 者 在 软件 包 管 理 系 统 里 提供 了 下 载 安 装 。 


2. 为 了 开始 使 用 Git 源 码 库 ， 从 官方 的 镜像 里 制作 一 份 克隆 : 


git clone git://git.postgresql.org/git/postgresql.git 


这 将 会 完全 拷贝 源 到 你 的 本 地 机 器 上 ， 所 以 直到 拷贝 完成 会 花费 一 段 时 间 ， 尤其 当 你 的 
网 络 连接 非常 慢 时 候 。 代码 文件 会 放置 在 当前 目录 一 个 新 的 名 为 postgresql 的 子 目录 
里 。 


Git 的 镜像 同样 可 以 通过 HTTP 协 议 来 获取 ， 假如 你 的 防火 墙 阻止 你 通过 Git 协 议 访问 。 
仅 需 要 修改 URL 的 协议 为 http, 例如 : 


git clone http://git.postgresql.org/git/postgresql.git 


HTTP 协 议 是 效率 较 低 的 相 比 于 Git 协 议 ， 所 以 使 用 起 来 会 更 慢 。 


3. 每 当 你 想 在 系统 得 到 最 近 更 新 时 ， cd 到 源 目 录 ， 运行 : 
git fetch 
Git 不 仅仅 获取 资源 ， 还 能 做 很 多 其 它 的 事情 。 更 多 详情 ， 参考 Git 手册 页 ， 或 者 查看 网 站 
http://git-scm.com. 
Legal Notice 
PostgreSQL is Copyright © 1996-2013 by the PostgreSQL Global Development Group. 
Postgres95 is Copyright © 1994-5 by the Regents of the University of California. 


Permission to use, copy, modify, and distribute this software and its documentation for any 
purpose, without fee, and without a written agreement is hereby granted, provided that the 
above copyright notice and this paragraph and the following two paragraphs appear in all 
copies. 


IN NO EVENT SHALL THE UNIVERSITY OF CALIFORNIA BE LIABLE TO ANY PARTY 
FOR DIRECT, INDIRECT, SPECIAL, INCIDENTAL, OR CONSEQUENTIAL DAMAGES, 
INCLUDING LOST PROFITS, ARISING OUT OF THE USE OF THIS SOFTWARE AND ITS 
DOCUMENTATION, EVEN IF THE UNIVERSITY OF CALIFORNIA HAS BEEN ADVISED 
OF THE POSSIBILITY OF SUCH DAMAGE. 


THE UNIVERSITY OF CALIFORNIA SPECIFICALLY DISCLAIMS ANY WARRANTIES, 
INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF 
MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE SOFTWARE 
PROVIDED HEREUNDER IS ON AN "AS-IS" BASIS, AND THE UNIVERSITY OF 
CALIFORNIA HAS NO OBLIGATIONS TO PROVIDE MAINTENANCE, SUPPORT, 
UPDATES, ENHANCEMENTS, OR MODIFICATIONS. 


Appendix J. 文档 


Table of Contents 


e J.1. DocBook 
。 J.2. 工具 集 

e J.3. 制作 文档 
。 J.4. 文档 写作 
e J.5. 风格 指导 


PostgreSQL 有 四 种 主要 的 文档 格式 : 

。 纯 文本 ， 用 于 安装 前 信息 的 纯 文 本 格式 。 
。 HTML， 用 于 在 线 浏览 和 参考 。 

。 PDF 或 PostScript， 用 于 打印 。 

。 手册 页 ， 用 于 快速 参考 。 


另外 ， 在 PostgreSQL 源 码 树 里 面 还 有 许多 README 风格 的 文件 ， 它 们 记录 了 许多 与 实现 有 关 
的 东西 。 


HTML 文 档 和 手册 页 (man pages) 是 标准 版 本 的 一 部 分 并 且 缺 省 时 安装 。 PDF 和 PostScript 格 
式 的 文档 可 以 独立 地 下 载 。 


J.1. DocBook 


文档 源 文件 是 用 DocBook 写 的 ， 它 是 一 种 标记 语言 ， 类 似 HTML。 这 两 种 语言 都 是 SGML ( 标 
准 通用 标记 语言 ) 的 应 用 ， 它 实际 上 是 描述 另外 一 种 语言 的 语言 。 也 就 是 说 ， 术 语 上 
DocBook 和 SGML 都 可 以 用 ， 而 技术 上 是 不 能 互 换 的 。 


DocBook 人 允许 作者 不 用 考虑 表现 细节 地 描述 一 份 技 术 文档 的 结构 和 内 容 。 一 份 文档 风格 定义 
该 内 容 如 何 呈现 为 几 种 最 终 形式 之 一 。DocBook 是 由 OASIS 工作 组 组 维护 的 。 DocBook 官 
方 网 站 有 很 好 的 介绍 和 参考 手册 以 及 一 整 本 O'Reilly 的 书 可 供 你 在 线 阅 读 。 NewbieDoc 
Docbook Guide 非 常 适合 初学 者 阅读 。 FreeBSD Documentation Project 也 使 用 DocBook 并 
且 有 一 些 很 好 的 信息 ， 包括 一 些 很 值得 考虑 的 风格 向 导 。 


J.2. 工具 


下 面 的 工具 用 于 处理 此 文档 。 有 些 可 能 是 可 选 的 ， 在 文中 标注 了 。 
DocBook DTD 


这 是 DocBook 本 身 的 定义 。 目 前 使 用 版 本 4.2 ; 你 不 能 使 用 更 新 或 者 早 些 的 版 本 。 你 需要 
SGML 版 本 的 DocBook DTD， 但 是 建立 手册 页 也 需要 XML 版 本 的 相同 版 本 。 


ISO 8879 character entities 

这 是 DocBook 需要 的 ， 但 是 独立 发 布 ， 因 为 它们 是 由 ISO 维 扩 的 。 
DocBook DSSSL Stylesheets 

这 些 东 西 包含 把 DocBook 源 代码 转换 成 其 它 格 式 ( 比 如 HTML) 的 处 理 指令 。 
DocBook XSL Stylesheets 


这 是 另外 一 个 转化 DocBook 到 其 他 格式 的 样式 表 。 我 们 当前 使 用 它 来 生成 手册 页 和 可 选 的 
HTML 帮 助 。 你 也 可 以 使 用 这 个 工具 生成 HTML 或 PDF 输 出 ， 但 是 官方 的 PostgresSQL 发 布 使 
用 DSSSL stylesheets。 


当前 所 需 的 最 小 版 本 是 1.74.0。 
OpenJade 


这 是 处 理 SGML 的 基本 包 。 它 包含 一 个 SGML 分 析 器 ， 一 个 DSSSL 人 处 理 器 (也 就 是 一 个 用 
DSSSL 风 格 表 把 SGML 转 换 成 其 它 格式 的 程序 )， 还 有 一 系列 相关 工具 。 现 在 Jade 由 
OpenJade 组 维护 ， 而 不 再 是 James Clark 了 。 


Libxslt for xsLtproc 


这 是 和 XSLT stylesheets 一 起 使 用 的 处 理工 具 (类 似 jade ， 是 处 理 DSSSL stylesheets 的 工 
具 ) 


o 


JadeTeX 


如 果 你 需要 ， 你 还 可 以 安装 JadeTeX 把 TeX 用 做 Jade 的 一 种 格式 化 后 端 。JadeTeX 可 以 生成 
Postscript 或 者 PDF 文件 (后 者 带 书签 )。 


不 过 ，JadeTeX 的 输出 比 RTF 后 端 稍 差 一 点 的 打印 输出 。 主要 是 表 的 格式 和 各 种 坚 直 和 水 平 
的 空白 效果 。 而 且 ， 你 还 没有 机 会 手工 润色 输出 结果 。 


我 们 已 经 在 文档 中 记录 了 几 种 安装 义理 此 文档 所 需 的 各 种 工具 的 方法 。 它 们 在 下 面 描述 。 也 
可 能 有 其 它 包 发 布 这 些 工 具 。 请 向 doc 邮件 列表 报告 那些 包 的 状态 ， 就 会 在 这 里 包括 那些 信 
息 。 


J.2.1. Linux RPM 安装 


许多 供应 商 在 它们 的 版 本 里 提供 了 一 整套 处 理 DocBook 的 RPM 包 ， 请 检查 一 下 "SGML" 选 

项 ， 或 者 下 列 包 之 一 : sgml-common ， docbook , stylesheets , openjade (或 jade Jo 可 能 还 
需要 sgml-tools 和 xsltproc 或 libxslt 。 如 果 你 的 版 本 没有 提供 这 些 东 西 ， 那 么 你 应 该 可 

以 使 用 来 自 一 些 其 它 合理 兼容 的 发 行商 的 包 。 


J.2.2. FreeBSD 安装 


FreeBSD 文档 计划 本 身 就 非常 频繁 地 使 用 DocBook, 所 以 在 FreeBSD 里 有 一 整套 可 以 用 
的 文档 工具 的 "ports" 就 一 点 也 不 奇怪 了 。 要 在 FreeBSD 里 制作 文档 ， 你 必须 安装 下 面 的 port 


@ textproc/sp 
e textproc/openjade 
e textproc/iso8879 
@ textproc/dsssl-docbook-modular 
® textproc/docbook-420 
很 多 东西 来 自 /usr/ports/print ( tex , jadetex ) 你 也 可 能 会 安装 。 


这 些 port 很 可 能 不 会 更 新 位 于 /usr/local/share/sgml/catalog.ports 的 主 目录 文件 或 顺序 不 
合适 。 确 保 文件 的 开头 有 下 面 这 几 行 : 


CATALOG "openjade/catalog" 

CATALOG "iso8879/catalog" 

CATALOG "docbook/dsssl/modular/catalog" 
CATALOG "docbook/4.2/catalog" 


如 果 你 不 想 编 辑 文 件 ， 还 可 以 把 环境 变量 seML_cATALoG_FILES 设置 为 一 个 冒号 分 隔 的 目录 文 
件 列表 (比如 上 面 那样 的 )。 


你 可 以 在 FreeBSD Documentation Project's instructions 里 找到 更 多 有 关 FreeBSD 文档 工具 
的 信息 。 


J.2.3. Debian 包 


Debian GNU/Linux 里 面 也 有 一 整套 可 以 用 的 文档 工具 的 包 。 安装 时 ， 只 需要 用 下 面 的 命令 : 


apt-get install docbook docbook-dsssl docbook-xsl openjade1.3 opensp xsltproc 


J.2.4. Mac OS X 
如 果 你 使 用 MacPorts， 你 将 使 用 以 下 命令 来 设置 : 

sudo port install docbook-dsssl docbook-sgml-4.2 docbook-xml-4.2 docbook-xsl libxslt open 
‘| =e | 
J.2.5. 从 源 程 序 手工 安装 
DocBook 工具 的 手工 安装 过 程 有 些 复杂 ， 因 此 如 果 你 有 预先 制作 好 的 包 ， 最 好 还 是 用 它们 。 


在 这 里 只 描述 一 个 标准 的 安装 ， 而 且 安 装 到 标准 的 路 径 里 ， 并 且 没 有 "神奇 "的 特性 。 相关 的 
更 多 的 细节 ， 你 应 该 学 习 相 关 包 的 文档 ， 并 且 阅 读 SGML 介 绍 性 材料 。 








J.2.5.1. Z3 OpenJade 


1. OpenJade 提供 了 一 个 GNU 风格 的 ./configure; make; make install 制作 过 程 。 你 可 以 
在 OpenJade 源 程序 包 里 找到 详细 内 容 。 在 shell 里 : 


./configure --enable-default-catalog=/usr/local/share/sgml/catalog 
make 
make install 


确保 你 记 住 了 "default catalog" 的 位 置 ， 后 面 还 会 需要 它 。 也 可 以 不 用 注 明 这 句 话 ， 但 是 
稍 后 使 用 jade 的 时 候 ， 你 就 不 得 不 把 环境 变量 SGML_CATALOG_FILES 设置 为 指向 该 文件 的 
WE. WR OpenJade 已 经 安装 ， 并 且 你 想 在 本 地 安装 其 它 工 具 的 时 候 ， 这 也 是 个 可 选 
的 方法 。 


> Note: 一 些 用 户 已 经 报告 了 使 用 OpenJade 1.4devel 建 立 PDF 时 的 分 段 错误 ， 信 息 如 
下 : >> 


&gt; openjade: ./stylesheet.ds1:664:2:E: flow object not accepted by port; only display 
> > 使 用 低级 的 OpenJade 1.3 应 该 某 解 决 这 个 错误 。 


2. 另外 ， 你 应 该 从 dsssl 目录 里 把 dsssl.dtd , fot.dtd , style-sheet.dtd ，catalog 文件 
安装 上 ， 可 能 是 安装 到 /usr/local/share/sgml/dsssl 吧 。 最 简 单 的 可 能 就 是 复制 整个 目 
录 : 


cp -R dsssl /usr/local/share/sgml 


3. 最 后 ， 创建 文件 /usr/local/share/sgml/catalog 并 且 把 下 面 行 加 入 其 中 : 


CATALOG "dsssl/catalog" 


这 是 一 个 相对 路 径 ， 指 向 在 step 2 里 安装 的 文件 。 请 根据 你 自己 的 安装 布局 进行 调整 。 


J.2.5.2. 安装 DocBook DTD 工具 箱 


1， 获 取 DocBook V4.2 发 布 


2. 创建 目录 /usr/local/share/sgml/docbook-4.2 并 且 进 入 该 目录 。 实际 的 位 置 并 非 关 键 ， 
上 面 这 个 只 是 在 这 里 的 布局 的 比较 合理 的 位 置 。 


&lt;samp class="literal"&gt;$&lt;/samp&gt; &lt;kbd class="literal"&gt;mkdir /usr/locé 
&1t;samp class="literal"&gt;$&lt;/samp&gt; &lt;kbd class="literal"&gt;cd /usr/local/: 


EJ 
3. feats : 





&lt;samp class="literal"&gt;$&lt;/samp&gt; &lt;kbd class="literal"&gt;unzip -a ..... / 
.了 — 
这 个 归档 将 把 它 的 文件 解 开 到 当前 目录 。 





4. 编辑 /usr/local/share/sgml/catalog 文件 (或 者 任何 安装 的 时 候 你 告诉 jade 的 东西 ) HA 
把 类 似 下 面 的 行 放 到 该 文件 里 面 : 


CATALOG "docbook-4.2/docbook.cat" 


5. FAISO 8879 字符 记录 为 档 ， 解 开 它 ， 然 后 把 文件 放 到 DocBook 文件 的 同一 个 目录 
里 。 


6. 在 装 有 DocBook 和 ISO 文件 的 目录 里 运行 下 面 的 命令 : 


perl -pi -e 's/iso-(.*).gml/ISO\1/g' docbook.cat 


这 个 动作 修补 了 一 个 小 毛病 ， 这 个 毛病 把 DocBook 目录 文件 里 使 用 的 名 字 和 ISO FHS 
体 文 件 的 名 字 混 淆 了 。 


J.2.5.3. @3 DocBook 的 DSSSL 样 式 表 


要 安装 样式 表 ， 解 开发 布 的 工具 包 ， 然 后 把 它 挪 到 一 个 合适 的 地 方 ( 比 
如 /usr/local/share/sgml )。 为 档 会 自动 生成 一 个 子 目录 。 


<samp class="literal">$</samp> <kbd class="literal">gunzip docbook-dsssl-1. xx_ .tar.gz< 
<samp class="literal">$</samp> <kbd class="literal">tar -C /usr/local/share/sgml -xf docb 


«| = 








你 也 可 以 在 /usr/local/share/sgml/catalog 里 制作 常用 的 目 RB : 


CATALOG "docbook-dsssl-1._xx_/catalog" 


因为 样式 表 变 化 频繁 ， 因 此 有 时 候 多 实验 几 个 版 本 也 挺 好 ，PostgreSQL 并 不 使 用 这 个 表 项 。 
参阅 Section J.2.6 获 取 有 关 如 何 选 择 样式 表 的 信息 。 


J.2.5.4. 安装 JadeTeX 


要 安装 和 使 用 JadeTeX， 就 需要 一 套 能 用 的 TeX 和 LaTeX2e， 包 括 支持 的 工具 和 AKA. 

Babel. AMS 字体 、AMS-LaTeX 、 PSNFSS 扩 展 、"the 35 fonts" 工 具 箱 、 用 于 生成 

PostScript 的 dvips 程 序 ， 宏 包 fancyhdr。 hyperref, minitoc, url ，ot2enc， 所 有 这 些 你 都 

可 以 在 你 最 近 的 CTAN 镜像 站 点 找到 。 基本 TeX 系 统 的 安装 远 远 超出 了 这 份 介绍 的 范围 。 你 
应 该 可 以 在 任何 可 以 运行 TeX 的 系统 上 找到 二 进 制 包 。 


在 你 开始 使 用 JadeTeX 人 处 理 PostgreSQL 文 档 之 前 ， 你 需要 增 大 TeX 的 内 部 数据 结构 的 尺寸 。 
关于 这 些 事情 的 细节 可 以 在 JadeTeX 的 安装 指导 里 找到 。 


一 旦 完成 了 这 些 你 就 可 以 安装 JadeTeX 了 : 


<samp class="literal">$</samp> <kbd class="literal">gunzip jadetex- xxx_ .tar.gz</kbd> 
<samp class="literal">$</samp> <kbd class="literal">tar xf jadetex-~_xxx_>.tar</kbd> 
<samp class="literal">$</samp> <kbd class="literal">cd jadetex</kbd> 

<samp class="literal">$</samp> <kbd class="literal">make install</kbd> 

<samp class="literal">$</samp> <kbd class="literal">mktexlsr</kbd> 


| 
最 后 两 步 需要 以 root 身 份 处 理 。 


J.2.6. configure 检测 


在 你 制作 文档 之 前 ， Eee here ett ae 支行 configure WMA, 检查 运行 结尾 处 的 输 
出 ， 应 该 看 起 来 像 这 样 


<samp class="literal">checking for onsgmls... onsgmls 

checking for openjade... openjade 

checking for DocBook V4.2... yes 

checking for DocBook stylesheets... /usr/share/sgm1/docbook/stylesheet/dsssl/modular 
checking for collateindex.pl... /usr/bin/collateindex.pl 

checking for xsltproc... xsltproc 

checking for osx... osx</samp> 


如 果 onsgmls 和 nsgmls 都 没有 找到 ， 那么 下 面 的 测试 将 被 跳 过 。 nsgmls 是 Jade 包 的 一 部 
分 。 可 以 通过 传递 环境 变量 JADE 和 NscMLs 给 configure 来 指定 这 些 程序 的 位 置 。 如 果 没 有 
找到 "DocBook V4.2"， 那么 就 是 你 没有 把 DocBook DTD 工具 箱 装 到 jade 可 以 找到 的 地 方 ， 


或 者 你 没有 正确 设置 目录 文件 。 参阅 上 面 的 安装 提示 。 配 置 脚 本 会 在 一 些 比较 标准 的 位 置 寻 
找 DocBook 样式 表 ， 但 如 果 你 把 它们 放 在 其 它 位 置 ， 那 么 就 应 该 设置 环境 变量 
DOCBOOKSTYLE 为 该 位 置 并 且 重 新 运行 configure 脚本 。 


J.3. 制作 文档 


一 旦 把 所 有 的 东西 都 设置 好 了 ， 进 入 目录 doc/src/sgml 然后 运行 下 面 其 中 一 
GNU make) : 


W 
=) 
ab 
rat 
ai 
HE 
pat 


J.3.1. HTML 


制作 HTML 版 本 的 文档 : 


<samp class="literal">doc/src/sgml$</samp> <kbd class="literal">gmake html</kbd> 


这 也 是 缺 省 目标 。 在 子 目录 htm 里 输出 。 


要 创建 一 个 适当 的 索引 ， 可 能 处 理 几 个 相同 的 阶段 。 如 果 你 不 关心 该 索引 ， 只 是 想 校对 输 
出 ， 使 用 draft : 


<samp class="literal">doc/src/sgml$</samp> <kbd class="literal">gmake draft</kbd> 


要 建立 文档 为 一 个 HTML 页 ， 使 用 : 


<samp class="literal">doc/src/sgml$</samp> <kbd class="literal">gmake postgres.html</kbd> 


a 了 睛 "| 


J.3.2. 手册 页 


用 DocBook XSL 样 式 表 把 DocBook 的 refentry 页 面 转换 成 适 于 做 手册 页 的 *roff 输出 。 这 些 
手册 页 也 是 以 tar 为 档 的 形式 发 布 的 ， 与 HTML 版 本 类 似 。 要 创建 手册 页 包 ， 用 命令 : 


cd doc/src/sgml 
gmake man 


J.3.3. 用 JadeTeX 生 成 的 打印 输出 


如 果 你 想 用 JadeTex 生 成 一 个 可 打印 的 文档 ， 可 以 用 下 面 的 命令 : 
。 使 用 DVI 生成 一 个 A4 格 式 的 PostScript : 


&lt;samp class="literal"&gt;doc/src/sgml$&lt;/samp&gt; &lt;kbd class="literal"&gt;gmz 








U.S. 信 件 的 格式 : 


&lt;samp class="literal"&gt;doc/src/sgm1$&1t;/samp&gt; &lt;kbd class="literal"&gt;gmé 


“| = 








e 制作 一 个 PDF : 


&lt;samp class="literal"&gt;doc/src/sgml1$&1t;/samp&gt; &lt;kbd class="literal"&gt;gmz 





‘| 





> 
或 . 
一 . 


&lt;samp class="literal"&gt;doc/src/sgml$&lt;/samp&gt; &lt;kbd class="literal"&gt; gmé 


本 -— 





当然 ， 你 也 可 以 从 Postscript 里 制作 PDF 版 本 ， 但 是 如 果 你 直接 生成 PDF， 那么 它 会 有 
超 链 接 和 其 它 增强 的 特性 。 


当 使 用 JadeTeX 生成 PostgreSQL 文档 时 ， 你 可 能 需要 增 大 一 些 TeX 的 内 部 参数 。 通过 设置 文 
件 texmf ,cnf 来 实现 。 下 面 的 设置 立即 生效 : : 


hash_extra.jadetex = 200000 
hash_extra.pdfjadetex = 200000 
pool_size.jadetex = 2000000 
pool_size.pdfjadetex = 2000000 
string_vacancies.jadetex = 150000 
string_vacancies.pdfjadetex = 150000 
max_strings.jadetex = 300000 
max_strings.pdfjadetex = 300000 
save_size.jadetex = 15000 
save_size.pdfjadetex = 15000 


J.3.4. Ya Hi SCAN 


{aR CANBY SFT soe, FARRER, BHT ERR KR, BON, FPO 
的 文本 ， 宽 表 格 。 过 宽 的 文本 在 TeX 日 志 输 出 文件 中 产生 "Overfull hbox" 信 息 ， 例 如 ， 
postgres-US.log 或 postgres-A4.1og 。 一 英寸 有 72 个 点 ， 所 以 任何 超过 72 个 点 的 报告 都 太 
宽 ， 可 能 不 适合 打印 页 〈 假 设 一 英寸 ) 。 要 找到 导致 浴 出 的 SGML 文 本 ， 首 先 找到 上 面 提 到 
的 浴 出 信息 的 首页 码 ， 例 如 ， [50 ###] (page 50)， 然 后 在 PDF 文件 中 查找 其 后 的 页 码 (例如 
页 51)， 查看 瀹 出 文本 并 相应 的 调整 SGML。 


J.3.5. 通过 RTF 生 成 打印 输出 


你 也 可 以 通过 把 它 转换 成 RTF 并 且 用 一 个 办 公 套 件 进行 格式 微调 的 办 法 来 创建 一 个 
PostgreSQL 文 档 的 可 打印 的 版 本 。 根 据 你 使 用 的 不 同 的 办 公 套 件 ， 然后 你 就 可 以 分 别 把 文档 
转换 成 PDF 格式 的 Postscript。 下 面 的 步骤 演示 了 使 用 Applixware 实 现 的 过 程 。 


Note: 目前 看 来 PostgreSQL 的 当前 版 本 的 文档 碰 到 了 OpenJade 的 大 小 限制 的 一 些 毛 
病 。 如 果 制 作 RTF 版 本 的 时 候 停 住 了 好 长 时 间 ， 而 输出 文件 还 是 0， 那么 你 很 有 可 能 碰 
到 了 这 个 毛病 。 不 过 ， 正 常 的 制作 要 花 5 到 10 分 钟 ， 因 此 不 要 太 快 退出 。 











Applixware RTF 清理 


OpenJade 忽 略 了 声明 文本 主体 的 缺 省 风格 。 以 前 ， 这 个 未 经 查 明 的 问题 导致 目录 生成 的 长 时 
ja] HB, Ait, ÆApplixware 的 工作 人 员 的 全 力 帮 助 下 ， 这 个 病症 被 诊断 出 来 并 且 找 到 了 绕 
开 的 办 法 。 


1， 键 和 人 下 面 命令 生成 RTF 版 本 : 


&lt;samp class="literal"&gt;doc/src/sgml$&l1t;/samp&gt; &lt;kbd class="literal"&gt; gmé 
E = 
2. 修复 RIF 文件 ， 以 正确 声明 所 有 风格 ， 尤 其 是 缺 省 风格 。 如 果 文 档 包 含 refentry Fx, 


那么 还 必须 把 和 前 面 的 段落 与 当前 段落 绑 定 的 格式 化 暗示 蔡 换 为 当前 的 段落 和 后 面 的 段 
落 绑 定 。 在 doc/src/sgml 里 有 一 个 fixrtf 用 于 完成 这 样 的 修补 : 





&lt;samp class="literal"&gt;doc/src/sgml$&1t;/samp&gt; &lt;kbd class="literal"&gt; ./1 
e E: 
该 脚本 把 {\se Normal;} BIA SAIS MAR. MHS Applixware, RTF 标准 会 茶 止 增 


加 一 种 隐 含 的 老 级 风格 ， KE Microsoft Word 碰巧 可 以 处 理 这 种 情况 。 为 了 修 
复 refentry 段落 ， 该 脚本 把 \keepn 标记 替换 为 \keep o 





3. 在 Applixware Words 里 打开 新 的 文档 ， 然 后 输入 该 RTF 文 件 。 
4， 用 Applixware 生 成 一 个 新 的 目录 (ToC)。 


. 选择 现 有 的 ToC 行 ， 从 第 一 行 第 一 个 字符 到 最 后 一 行 最 后 一 个 字符 。 


ii. FATools->Book Building-> 制 作 一 个 新 的 ToC。 选 择 头 三 层 头 用 于 包含 在 ToC 里 。 这 
将 用 本 地 的 Applixware ToC REM RTF 里 输入 进来 的 行 。 


iii， 使 用 Format->Style 调整 ToC 格式 ， 选 择 每 三 种 ToC 风格 ， 然 后 为 First 和 Left 
调整 边 距 。 使 用 下 面 的 值 : 


风格 第 一 边 距 (英寸 ) 左边 距 (英寸 ) 


TOC-Heading 1 0.4 0.4 
TOC-Heading 2 0.8 0.8 
TOC-Heading 3 1m2 Ley? 


5， 对 文档 进行 加 工 : 
o 调整 分 页 符 
o RRIF 


6. 用 正确 的 值 蔡 换 ToC 里 例子 和 图 片 部 分 右 对 齐 的 页 数 。 这 些 对 每 个 文档 只 需要 花 几 分 
钟 。 


7. WRASSE, BAMA HIRE. 
8. 重新 生成 并 调整 目录 。 
选择 ToC FER. 
ii. 选择 Tools->Book Building->Create Table of Contents. 
通过 选择 Tools->Field Editing->Unprotect 解 除 ToC. 
iv. MER ToC 中 的 第 一 行 ， 它 是 指向 ToC 本 身 的 一 条 记录 。 
9. 把 该 文档 保存 为 Applixware Words 本 地 文档 格式 以 便于 最 后 的 编辑 。 


—_ 


0. 把 该 文档 以 PostScript 格式 "打印 "到 一 个 文件 。 


J.3.6. 纯 文 本 文件 


有 好 几 个 文件 是 以 纯 文本 的 模式 发 布 的 ， 主 要 是 为 了 在 安装 过 程 中 阅读 。 instar 文件 对 应 
Chapter 15， 只 有 一 点 用 于 不 同 环境 的 修改 。 要 重建 这 个 文件 ， 进入 目录 doc/src/sgml 然后 
lax A<kbd class="literal">gmake INSTALL</kbd>。 这 样 就 会 创建 一 个 叫 INSTALL.html 的 文 
件 ， 你 可 以 用 Netscape Navigator 把 它 另 存 为 一 个 文本 文件 ， 然 后 把 它 找到 现存 文件 的 位 
ia. 好 像 Netscape 提 供 了 最 高 的 HTML 到 文本 的 转换 质量 ( 比 lynx 和 w3m 好 )。 


文件 HIsToRY 可 以 用 类 似 方 法 创建 ， 用 的 命令 是 <kbd class="literal">gmake 
HISTORY</kbd>。 对 于 src/test/regress/README 文件 ， 命 令 是 <kbd class="literal">gmake 
regress README</kbd>, 


J.3.7. 语法 检查 


制作 文档 可 能 需要 很 长 时 间 。 但 是 有 一 个 方法 用 于 只 检查 文档 文件 的 语法 正确 性 ， 只 要 花 几 
秒 钟 : 


<Samp class="literal">doc/src/sgml$</samp> <kbd class="literal">gmake check</kbd> 


J.4. 文档 写作 


SGML 和 DocBook 没 有 受到 过 多 的 开放 源码 写作 工具 的 影响 。 最 常用 的 工具 集 是 带 有 合适 编 
辑 模 式 的 Emacs/XEmacs 编辑 器 。 在 一 些 系 统 上 这 些 工具 在 典型 的 完全 安装 时 是 一 并 安装 
的 。 


J.4.1. Emacs/PSGML 


PSGML 是 最 常用 和 最 强大 的 编辑 SGML 文 档 的 工具 。 如 果 正 确 的 做 了 配置 ， 它 将 允许 你 使 用 
Emacs 插 入 标签 和 检查 标记 一 致 性 。 你 也 可 以 把 它 用 于 HTML。 看 看 PSGML 站 点 获取 下 载 、 
安装 指导 、 详 细 文 档 。 


关于 PSGML 有 一 件 比较 重要 的 事情 要 注意 : 它 的 作者 假设 你 的 主 SGML DTD 目 录 

是 /usr/local/lib/sgml 。 如 果 你 像 本 文 的 例子 那样 放 在 susr/local/share/sgml ， 就 得 补偿 
这 个 问题 ， 要 么 是 设置 sGML_cATALoG_FILES 环境 变量 ， 要 么 是 自 定义 你 的 PSGML 安装 ( 它 的 
手册 告诉 你 怎么 做 )。 


把 下 面 这 几 行 放 到 你 的 ~/ .emacs 环境 文件 里 (根据 你 的 系统 调整 路 径 名 ) : 


p ********** for SGML mode (psgml) 


(setq sgml-omittag t) 

(setq sgml-shorttag t) 

(setq sgml-minimize-attributes nil) 

(setq sgml-always-quote-attributes t) 

(setq sgml-indent-step 1) 

(setq sgml-indent-data t) 

(setq sgml-parent-document nil) 

(setq sgml-exposed-tags nil) 

(setq sgml-catalog-files '("/usr/local/share/sgml/catalog") ) 


(autoload 'sgml-mode "psgml" "Major mode to edit SGML files." t ) 


并 且 在 同一 个 文件 里 增加 一 条 记录 ， 把 SGML 加 入 自动 模式 别名 的 定义 中 


( auto-mode-alist ) : 


(setq 
auto-mode-alist 
'(("\\.sgml$" . sgml-mode) 
)) 


当 使 用 PSGML 时 ， 有 一 个 让 自己 在 这 些 分 离 的 文件 上 干 活 方便 些 的 办 法 : 就 是 你 在 编辑 它们 
的 时 候 插 入 合适 的 pocTYPE 定义 。 例 如 ， 如 果 你 在 这 个 源 文件 上 干 活 ， 这 是 一 个 附录 章节 ， 
因此 你 将 通过 把 第 一 行 标记 成 像 下 面 的 样子 从 而 把 这 个 文档 声明 为 一 个 DocBook 文档 的 " 附 
x: 


<!DOCTYPE appendix PUBLIC "-//OASIS//DTD DocBook V4.2//EN"> 


这 意味 着 任何 或 所 有 读 取 SGML 的 软件 将 能 正确 读 取 这 份 文 件 ， 并 且 我 可 以 
用 nsgmls -s docguide.sgml 校 验 此 文档 (不 过 你 在 制作 整个 文档 集 的 时 候 要 把 这 行 拿 走 )。 


J.4.2. 其 它 Emacs 模式 


GNU Emacs 带 有 不 同 的 SGML 模 式 ， 不 过 并 不 像 PSGML 那 么 强大 ， 但 是 它 比 较 少 让 人 混淆 
的 东西 而 且 比 较 小 巧 。 同样 ， 它 也 提供 语法 高 之 (字体 锁 )， 也 是 很 有 帮助 
的 。 src/tools/editors/emacs.samples 包含 这 个 模式 的 相同 设置 。 


Norm Walsh 提供 一 个 用 于 DocBook 的 major mode， 也 有 字体 锁 和 一 些 可 以 减少 击 键 的 特 
性 。 


J.5. 风格 指导 


J.5.1. 参考 页 


参考 页 应 该 遵循 标准 的 布局 。 这 样 就 允许 用 户 更 快 地 找 出 自己 需要 的 信息 ， 并 且 也 可 以 鼓励 
作者 把 一 条 命令 的 所 有 相关 方面 都 记录 在 案 。 一 致 性 不 仅仅 是 PostgreSQL 参 考 页 的 需求 ， 也 
是 操作 系统 和 其 它 页 面 提供 的 东西 。 因此 设计 了 下 面 的 指导 方针 。 它 们 在 大 多 数 时 候 是 与 各 
种 操作 系统 建立 起 来 的 类 似 的 风格 是 一 致 的 。 


描述 可 执行 命令 的 参考 页 应 该 包含 下 面 的 小 节 ， 并 且 是 按照 这 里 的 顺序 。 不 适用 的 小 节 可 以 
忽略 。 额 外 的 项 级 小 节 应 该 只 用 在 特殊 的 环境 下 ; 通常 那些 信息 属于 "用 法 "小 节 。 


名 字 (Name) 
这 个 小 节 是 自动 生成 的 。 它 包含 命令 名 和 一 个 半 句 话 的 摘要 ， 介 绍 该 命令 的 功能 。 
纲要 (Synopsis) 


这 个 小 节 包 含 该 命令 的 语法 图 表 。 大 纲 通 常 不 应 该 列 出 每 个 命令 行 选项 ; 那些 东西 在 后 面 
做 。 大 纲 应 该 列 出 命令 行 的 主要 组 件 ， 比 如 应 该 把 输入 和 输出 文件 放 在 哪里 等 。 


描述 (Description) 

几 个 段落 ， 用 于 描述 该 命 爷 是 做 什么 的 。 

选项 (Options) 

一 个 列表 ， 描 述 每 个 命令 行 选 项 。 如 果 有 许多 选项 ， 可 以 用 子 小 节 。 
退出 状态 (Exit Status) 


如 果 程 序 用 0 表示 成 功 ， 非 雳 表示 失败 ， 那 么 你 不 需要 为 此 宇文 档 。 如 果 在 每 个 非 需 值 的 后 
面 有 不 同 的 含义 ， 那 么 在 这 里 列 出 它们 。 


用 法 (Usage) 


描述 任意 子 语言 或 者 程序 的 运行 时 接口 。 如 果 程 序 不 是 交互 的 ， 那 么 本 节 通 常 可 以 省 略 。 A 
则 ， 本 节 是 用 于 描述 所 有 运行 时 特性 的 地 方 。 如 果 合适 ， 可 以 使 用 子 小 节 。 


环境 (Environment) 


列 出 所 有 程序 可 能 使 用 的 环境 变量 。 尽 量 完 整 ; 即使 是 那些 看 起 来 很 琐碎 的 变量 ， 比 
如 SHELL 都 可 能 让 读者 感 兴趣 。 


文件 (Files) 


列 出 所 有 程序 可 能 隐 含 访问 的 文件 。 也 就 是 说 ， 不 要 列 出 在 命令 行 上 声明 的 输入 和 输出 文 
件 。 但 是 列 出 配置 文件 等 等 。 


诊断 (Diagnostics) 


解释 任何 程序 可 能 生成 的 不 正常 的 输出 。 避 人 免 列 出 所 有 可 能 的 错误 信息 。 这 样 做 工作 量 很 大 
但 没有 太 多 实际 用 途 。 但 是 如 果 说 错误 信息 有 一 种 用 户 可 以 分 析 的 标准 格式 ， 那么 这 里 可 能 
就 是 解释 它 的 地 方 。 


注意 (Notes) 

任何 在 其 它 地 方 放 都 不 合适 的 未 西 ， 尤 其 是 臭虫 、 实 现 缺 陷 、 安 全 考量 、 兼 容 性 问题 等 。 
例子 (Examples) 

例子 

历史 (History) 


如 果 在 程序 的 历史 中 有 一 些 主要 的 里 程 碑 ， 那 么 可 以 在 这 里 列 出 。 通 常 ， 这 个 小 节 可 以 省 
HE. 


作者 (Author) 
作者 (只 在 普通 发 布 版 中 使 用 ) 
又 见 (See Also) 


交叉 引用 ， 按 照 下 面 的 顺序 列 出 : 其 它 PostgreSQL 命令 的 参考 页 PostgreSQL SQL 命令 参考 
页 、 PostgreSQL 手册 的 引用 、 其 它 引 用 页 面 (比如 ， 操作 系统 、 其 它 包 )、 其 它 文 档 。 在 同一 
组 里 的 条 目 按照 字母 顺序 列 出 。 


描述 SQL 命令 的 参考 页 应 该 包含 下 面 的 小 节 : 名字、 大纲、 描述、 参数、 输出 、 注 意 、 例 
子 、 兼容 性 、 历史 、 又 见 。 参 数 小 节 类 似 选 项 小 节 ， 但 是 有 更 多 自由 可 以 选择 该 命令 的 哪个 
子 句 可 以 列 出 。 输出 小 节 只 在 命令 有 返回 的 时 候 需 要 ， 而 不 是 缺 省 的 命令 结束 标签 。 兼容 性 
小 节 应 该 解释 此 命令 遵循 SQL 标准 的 哪个 扩展 ， 或 者 它 兼容 哪 种 其 它 数 据 库 系 统 。 SQL 命 
兮 的 "又 见 "小 节 应 该 在 交叉 引用 其 它 程序 之 前 列 出 SQL HB. 
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Appendix K. 首 字 母 缩 略 词 


这 是 一 个 在 PostgreSQL 使 用 说 明 和 PostgreSQL 讨 论 中 经 常用 到 的 首 字 母 缩 略 图 。 


ANSI 

American National Standards Institute 
API 

Application Programming Interface 
ASCII 

American Standard Code for Information Interchange 
BKI 

Backend Interface 

CA 

Certificate Authority 

CIDR 

Classless Inter-Domain Routing 
CPAN 

Comprehensive Perl Archive Network 
CRL 

Certificate Revocation List 

CSV 

Comma Separated Values 

CTE 

Common Table Expression 

CVE 

Common Vulnerabilities and Exposures 


DBA 
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Database Administrator 

DBI 

Database Interface (Perl) 
DBMS 

Database Management System 
DDL 

Data Definition Language,SQL 命 合 比 如 CREATE TABLE , ALTER USER 
DML 

Data Manipulation Language, SQL 命令 比如 INSERT , UPDATE , DELETE 
DST 

Daylight Saving Time 

ECPG 

Embedded C for PostgreSQL 
ESQL 

Embedded SQL 

FAQ 

Frequently Asked Questions 
FSM 

Free Space Map 

GEQO 

Genetic Query Optimizer 

GIN 

Generalized Inverted Index 
GiST 

Generalized Search Tree 

Git 


Git) 
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GMT 

Greenwich Mean Time 

GSSAPI 

Generic Security Services Application Programming Interface 
GUC 

Grand Unified Configuration, 处 理 服 务 器 配置 的 PostgreSQL 子 系统 。 
HBA 

Host-Based Authentication 

HOT 

Heap-Only Tuples 

IEC 

International Electrotechnical Commission 
IEEE 

Institute of Electrical and Electronics Engineers 
IPC 

Inter-Process Communication 

ISO 

International Organization for Standardization 
ISSN 

International Standard Serial Number 

JDBC 

Java Database Connectivity 

LDAP 

Lightweight Directory Access Protocol 

MSVC 

Microsoft Visual C 


MVCC 
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Multi-Version Concurrency Control 
NLS 

National Language Support 

ODBC 

Open Database Connectivity 

OID 

Object Identifier 

OLAP 

Online Analytical Processing 
OLTP 

Online Transaction Processing 
ORDBMS 

Object-Relational Database Management System 
PAM 

Pluggable Authentication Modules 
PGSQL 

PostgreSQL 

PGXS 

PostgreSQL Extension System 
PID 

Process Identifier 

PITR 

Point-In-Time Recovery (## 2 Ja t4) 
PL 

Procedural Languages (server-side) 
POSIX 


Portable Operating System Interface 
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RDBMS 

Relational Database Management System 
RFC 

Request For Comments 

SGML 

Standard Generalized Markup Language 
SPI 

Server Programming Interface 

SP-GiST 

Space-Partitioned Generalized Search Tree 
SQL 

Structured Query Language 

SRF 

Set-Returning Function 

SSH 

Secure Shell 

SSL 

Secure Sockets Layer 

SSPI 

Security Support Provider Interface 

SYSV 

Unix System V 

TCP/IP 

Transmission Control Protocol (TCP) / Internet Protocol (IP) 
TID 

Tuple Identifier 


TOAST 
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The Oversized-Attribute Storage Technique 
TPC 

Transaction Processing Performance Council 
URL 

Uniform Resource Locator 

UTC 

Coordinated Universal Time 

UTF 

Unicode Transformation Format 

UTF8 

Eight-Bit Unicode Transformation Format 
UUID 

Universally Unique Identifier 

WAL 

Write-Ahead Log 

XID 

Transaction Identifier 

XML 


Extensible Markup Language 
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参考 书目 


选择 一 些 SQL 和 PostgreSQL 的 参考 和 读物 。 
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.pg_service.conf, 连接 服务 的 文件 
,类 型 转换 

_PG fini, 动态 加 载 

_PG init, 动态 加 载 

版 本 

兼容 性 , 升级 一 个 PostgreSQL 集群 
保存 点 

定义 , SAVEPOINT 

回 滚 , ROLLBACK TO SAVEPOINT 
释放 , RELEASE SAVEPOINT 
备份 , SADE Hil BL 

比较 

操作 符 , 比较 操作 符 

逐 行 , 行 和 数组 比较 

子 查询 结果 行 , 子 查询 表达 式 

编译 

libpq 应 用 , 制作 libpq 程 序 

see 别名 

表 , 表 的 基本 概念 

创建 , 表 的 基本 概念 

分 区 , 分 区 

删除 , 表 的 基本 概念 

修改 , (EK 

重 命名 , EMAR 
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表 空 间 , 表 空 间 

别名 

在 FROM 子 句 中 , 表 和 列 别 名 

在 选择 列表 中 , 字段 标签 

并 集 , 组 合 查询 

不 带 时 区 的 时 间 戳 , 日 期 /时 间 类 型 
不 是 一 个 数字 

数值 (数据 类 型 ), 任意 精度 数值 

双 精 度 , 浮 点 数 类 型 

不 同 , Soundex 

布尔 

操作 符 

see 操作 符 , 逻辑 

参照 完整 性 , 外 键 

操作 符 , 函数 和 操作 符 
调用 中 的 类 型 解析 , 操作 符 

逻辑 , 逻辑 操作 符 

APEL, 用 户 定义 操作 符 

操作 符 类 , 操作 符 类 和 操作 符 族 , 索引 方法 和 操作 符 类 
操作 符 族 , 操作 符 类 和 操作 符 族 , 操作 符 类 和 操作 符 族 
测试 , 回 为 测试 

查询 , 查询 

查询 树 , 查询 树 

ER, 组 合 查询 

长 度 
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二 进 制 字 符 串 

see 二 进 制 字符 串 ， 长 度 

of a character string 

see 字符 串 ， 长 度 

超级 用 户 , 角色 属性 

撤销 , 权限 

触发 器 

与 规则 比较 , 规则 与 触发 器 的 比较 
在 PL/Tcl 里 , PL/Tcl 里 的 触发 器 过 程 
AMEE 

Az, 窗口 函数 

执行 顺序 , BO E 

创建 数据 库 , 创建 一 个 数据 库 
磁盘 驱动 器 , WAL 内 部 

磁盘 使 用 , 判断 磁 瘟 的 使 用 量 
存储 参数 , 存储 参数 

Pika, 连接 状态 函数 

az at EBV at Be, 日 期 /时 间 类 型 
登陆 权限 , 角色 属性 

点 , 点 

对 象 标识 符 

数据 类 型 , 对 象 标识 符 类 型 

多 边 形 , 多 边 形 

二 进 制 数据 , 二 进 制 数据 类 型 
PRAM, 二 进 制 字 符 串 函数 和 操作 符 
二 进 制 字 符 串 

KE, 二 进 制 字符 串 画 数 和 操作 符 
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连接 , 二 进 制 字符 串 函 数 和 操作 符 

RERAH NM 

WA, 返回 集合 的 函数 

范围 表 , 查询 树 

范围 类 型 , 范围 类 型 

不 包含 , 范围 上 的 约束 

的 索引 , 索引 

非 空 约束 , 非 空 约束 

非 阻塞 连接 , BYE EM, 异步 命令 义理 

分 区 , 分 区 

服务 器 欺骗 , 防止 服务 器 欺骗 

浮 点 数 , 浮 点 数 类 型 

复制 , DISTINCT 

概要 , 概述 

格式 化 , 格式 化 , 数据 类 型 格式 化 函数 

共享 内 存 , 共享 内 存 和 信号 灯 

关闭 , 关闭 服务 器 

关键 字 

列表 , SQL 关 键 字 

规则 , 规则 系统 

for DELETE, 在 INSERT, UPDATE, 和 DELETE 上 的 规则 
for INSERT, 在 INSERT, UPDATE, 和 DELETE 上 的 规则 
for SELECT, SELECT 规 则 如 何 运转 

与 触发 器 比较 , 规则 与 触发 器 的 比较 

for UPDATE, 在 INSERT, UPDATE, 和 DELETE 上 的 规则 
和 视图 , 视图 和 规则 系统 


和 物化 视图 , 物化 视图 
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的 处 理 器 , 书写 一 个 过 程 语言 处 理 器 
哈 希 

see 索引 

PRL, 函数 和 操作 符 
调用 中 的 类 型 解析 , 函数 
在 FROM 子 句 中 , KKZ 


BKM, GROUP BY 和 HAVING 子 句 


后 台 工 作 程 序 , 后 台 工作 进程 
环境 变量 , 环境 变量 
回 为 测试 , 回忆 测试 
会 话 用 户 , 系统 信息 函数 
集合 并 , 组 合 查询 
集合 差 , 组 合 查询 
集合 交 , 组 合 查询 
合 运算 , 组 合 查 询 
级 联 
WIR, 依赖 性 跟踪 
外 键 操作 , 外 键 
WE, 加 密 选 项 , 行 加 密 功 能 
为 特定 字段 , pgcrypto 
间隔 , 日 期 /时 间 类 型 , 间隔 输入 
输出 格式 , 间隔 输出 
see also 格式 
检查 点 , WAL 配置 


检查 约束 , 检查 约束 
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交叉 连接 , 连接 表 

交集 , 组 合 查询 

角色 , 数据 库 和 角色 

MA, 角色 成 员 

创建 权限 , 角色 属性 

可 用 的 , applicable_roles 
启动 复制 权限 , 角色 属性 
解密 , 行 加 密 功 能 

FENG, 矩形 

和 矩形 (数据 类 型 ), 和 矩形 

可 更 新 的 视图 , 可 更 新 的 视图 
可 推迟 的 事务 

设置 , SET TRANSACTION 
可 信 的 

PL/Perl, 可 信 的 和 不 可 信 的 PL/Perl 
可 用 的 角色 , applicable_roles 
空 值 

在 libpq 中 , 检索 查询 结果 信息 
Ot, 角色 属性 
认证 , 口令 认证 

口 倒 文 件 , 口令 文件 

快速 通道 , 捷径 接口 

see 数据 类 型 

连接 , 连接 表 
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交叉 , 连接 表 

外 , 连接 表 

A, 连接 表 

自然 , 连接 表 

左 , 连接 表 

连接 服务 的 文件 , 连接 服务 的 文件 
列 , 表 的 基本 概念 
路 径 (数据 类 型 ), 路 径 
逻辑 非 , 逻辑 操作 符 
逻辑 或 , 逻辑 操作 符 
逻辑 与 , 逻辑 操作 符 
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字 
受 修饰 的 , 创建 模式 

未 修饰 的 , 模式 搜索 路 径 
模式 , 模式 

public, Public 模式 


创建 , 创建 模式 


当前 , 模式 搜索 路 径 , RASH 


删除 , 创建 模式 
模式 匹配 , 模式 匹配 
目标 列 , 查询 树 

内 存 环 境 

SPIN, 内 存 管理 
匿名 代码 块 , DO 
排除 约束 , 排除 约束 
排序 , 行 排序 


Index 


3420 


PostgreSQL 中 文 文档 9.3 


配置 

服务 器 

EM, 配置 设置 函数 

启动 

启动 服务 器 时 , 启动 数据 库 服务 器 
区 域 , 创建 数据 库 集 群 

取消 

SQL ÈS, 取消 正在 处 理 的 查询 
权限 , 权限 

和 规则 , 规则 和 权限 

对 于 模式 , 模式 和 权限 

和 视图 , 规则 和 权限 

查询 , 系统 信息 函数 

全 局 量 

在 PL/Tcl 里 , PL/Tcl 里 的 全 局 量 
全 文 检索 

图 数 和 操作 符 , 文本 搜索 类 型 
数据 类 型 , 文本 搜索 类 型 
RA a, 缺 省 值 

改变 , 改变 字段 的 缺 省 值 

任意 精度 数值 , 任意 精度 数值 
日 期 , 日 期 /时 间 类 型 , 日 期 
常量 , 特殊 值 

当前 , 当前 日 期 /时 间 

输出 格式 , 日 期 /时 间 输 出 

see also 格式 


设置 , MEREKA 
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升级 , 升级 一 个 PostgreSQL 集群 
时 间 , 日 期 /时 间 类 型 , 时 间 
常量 , 特殊 值 

当前 , 当前 日 期 /时 间 

输出 格式 , 日 期 /时 间 输 出 

see also 格式 

ay ja] Bk, 日 期 /时 间 类 型 , at ia 
时 间 间 隔 , 日 期 /时 间 类 型 

时 区 , 时 区 

转换 , AT TIME ZONE 

事件 触发 器 , 事件 触发 器 

FAC, ACh BEHR & 25 RX 
事件 日 志 


事件 日 志 , 在 Windows 上 注册 事件 日 志 


事务 隔离 级 别 

设置 , SET TRANSACTION 
事务 日 志 

see WAL 

视图 

更 新 , 与 视图 合作 

通过 规则 实现 , 视图 和 规则 系统 
物化 , 物化 视图 

授权 , 权限 

受 修饰 的 名 字 , 创建 模式 
数据 库 , 管理 数据 库 

创建 , 创建 一 个 数据 库 
创建 权限 , 角色 属性 
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数据 库 集 群 , 创建 数据 库 集群 
数据 类 型 , 数据 类 型 

枚 举 (enum), 枚 举 类 型 

数值 , 数值 类 型 

转换 ,类 型 转换 


数据 区 

see 数据 库 集 群 

数值 (数据 类 型 ), 任意 精度 数值 
数组 


VO, 数组 输入 和 输出 语法 
常量 , 数组 值 输入 

访问 , 访问 数组 

检索 , 在 数组 中 检索 

声明 , 数组 类 型 的 声明 
修改 , 修改 数组 

双 精 度 , 浮 点 数 类 型 

顺序 操作 符 , 操作 符 类 的 系统 相关 性 
搜索 路 径 , 模式 搜索 路 径 
当前 , 系统 信息 函数 
对 象 可 见 性 , 系统 信息 函数 
索引 , 索引 

B-tree, 索引 类 型 

表达 式 上 , 表达 式 上 的 索引 
GIN, #451 # 2, GIN 索 引 
GIST, 索引 类 型 , GiST#S5| 


SP-GiST, 索引 类 型 , SP-GiST 索 引 
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部 分 , 部 分 索引 

查询 使 用 , 检查 索引 的 使 用 
BFR, 多 字段 索引 

哈 希 , 索引 类 型 

和 ORDER BY, 素 引 和 ORDER BY 
唯一 , 唯一 索引 

用 户 定义 数据 类 型 , 扩展 索引 接口 
组 合 多 个 索引 , 组 合 多 个 索引 
所 有 者 , 权限 

逃逸 字符 串 

在 libpq 中 , 逃逸 包含 在 SQL 命令 中 的 字符 串 
条 件 表 达 式 , 条 件 表 达 式 
通用 表 表 达 式 

see WITH 

同步 提交 , 异步 提交 

Rit, RAHM 

外 部 表 , 外 部 数据 

外 部 数据 , 外 部 数据 

外 键 , 外 键 

外 连接 , 连接 表 

外 数据 封装 

handler for, 写 一 个 外 数据 包 
网 络 

数据 类 型 , 网 络 地 址 类 型 

网 络 附 加 存储 (NAS) 

see 网 络 文件 系统 

网 络 文件 系统 , 网 络 文件 系统 


唯一 约束 , 唯一 约束 

未 修饰 的 名 字 , 模式 搜索 路 径 
位 串 

BRAK, (0 ES SN AERE 
数据 类 型 , 位 串 类 型 
位 图 扫描 , 组 合 多 个 索引 
文本 检索 

图 数 和 操作 符 , 文本 搜索 类 型 
文本 搜索 

数据 类 型 , 文本 搜索 类 型 
无 时 区 , 日 期 /时 间 类 型 
无 时 区 的 时 间 戳 , ot ja Bh 
无 时 区 时 间 , 时 间 

物化 视图 

通过 规则 实现 , 物化 视图 
系统 表 

模式 , 系统 表 模 式 

显示 , MEERA 

限制 

删除 , 依赖 性 跟踪 

外 键 操作 , 外 键 

线程 

在 libpq 中 , 在 多 线程 程序 里 的 行为 
线段 , 线段 

线性 回归 , RERA 

小 数 

See 数值 
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协议 


前 /后 端 , 前 /后 端 协 议 
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后 端 进程 , 服务 器 信号 函数 
信号 灯 , 共享 内 存 和 信号 灯 
信息 模式 , 信息 模式 

行 , 表 的 基本 概念 

许可 

see 权限 

序列 , Fr URE EX 

序列 类 型 , 序列 号 类 型 


选择 , 查询 


AP, RHR, 数据 库 角 色 


当前 , RAB 

用 户 名 映射 , 用 户 名 映射 
用 户 认 证 ,用户 认证 

用 户 映 射 , 外 部 数据 
游标 

DECLARE, DECLARE 
FETCH, FETCH 
MOVE, MOVE 

显示 查询 计划 , EXPLAIN 
有 时 区 , 日 期 /时 间 类 型 
有 时 区 的 时 间 惟 , ot E 
有 时 区 时 间 , 时 间 
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右 连 接 , 连接 表 


预备 语句 


创建 , PREPARE 
删除 , DEALLOCATE 
显示 查询 计划 , EXPLAIN 


执行 , EXECUTE 


ial, 
约束 ， 
非 空 ， 
检查 ， 


主键 ， 


约束 排除 , 分 区 和 约束 排除 


整数 ， 


正则 表达 式 , SIMILAR TO 正则 表达 式 , POSIX 正则 表达 式 


see also 模式 匹配 


约束 
非 空 约束 
检查 约束 


, 检查 约束 


排除 约束 


R, HBR YR 
,外 键 

, 唯一 约束 
, 增加 约束 


主键 


整数 类 型 


以 及 区 域 , 行为 


证 书 ， 


DD 


NI 
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逐 行 比较 , 行 和 数组 比较 
主机 名 , 参数 关键 字 
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注释 

关于 数据 库 对 象 , 系统 信息 函数 
注意 信息 义理 

在 libpq 中 , 注意 信息 义理 

注意 信息 处 理 器 , 注意 信息 处 理 
注意 信息 接收 器 , 注意 信息 处 理 
准备 一 个 查询 

在 PL/Tcl 里 , 在 PL/Tcl 里 访问 数据 库 
子 查 询 , 子 查 询 

子 字符 串 , SIMILAR TO 正则 表达 式 
自然 连接 , 连接 表 

自 增 

see 序列 号 

字段 

MER, 删除 字段 

系统 字段 , 系统 字段 

增加 , 增加 字段 

重 命名 , 重 命名 字段 

字段 数据 类 型 

修改 , 修改 字段 的 数据 类 型 

字符 变化 , 字符 类 型 

字符 串 

see 字符 串 
长 度 , FRB 
连接 , SRS WAAR 


El 


AER TE FF 


图 


DADA 
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字符 类 型 
数据 关 型 , 字符 类 型 
左 链 接 , 连接 表 
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abbrev, 网 络 地 址 函数 和 操作 符 
ABORT, ABORT 

abs, 数学 函数 和 操作 符 

acos, 数学 函数 和 操作 符 
administration tools 

externally maintained, 管理 工具 
adminpack, adminpack 

advisory lock, 咨询 锁 

age, 时 间 / 日 期 画 数 和 操作 符 
aggregate function, 聚集 西数 
invocation, 聚集 表达 式 
user-defined, 用 户 定义 聚集 

AIX 

installation on, AlX 

IPC 配置 , 共享 内 存 和 信号 灯 
akeys, hstore 操作 符 和 函数 
alias 

for table name in query, 在 表 间 连接 
ALL, 子 查询 表达 式 , 行 和 数组 比较 


allow_system_table_mods configuration parameter, 开发 人 员 选 项 


ALTER AGGREGATE, ALTER AGGREGATE 


ALTER COLLATION, ALTER COLLATION 


ALTER CONVERSION, ALTER CONVERSION 

ALTER DATABASE, ALTER DATABASE 

ALTER DEFAULT PRIVILEGES, ALTER DEFAULT PRIVILEGES 

ALTER DOMAIN, ALTER DOMAIN 

ALTER EVENT TRIGGER, ALTER EVENT TRIGGER 

ALTER EXTENSION, ALTER EXTENSION 

ALTER FOREIGN DATA WRAPPER, ALTER FOREIGN DATA WRAPPER 
ALTER FOREIGN TABLE, ALTER FOREIGN TABLE 

ALTER FUNCTION, ALTER FUNCTION 

ALTER GROUP, ALTER GROUP 

ALTER INDEX, ALTER INDEX 

ALTER LANGUAGE, ALTER LANGUAGE 

ALTER LARGE OBJECT, ALTER LARGE OBJECT 

ALTER MATERIALIZED VIEW, ALTER MATERIALIZED VIEW 

ALTER OPERATOR, ALTER OPERATOR 

ALTER OPERATOR CLASS, ALTER OPERATOR CLASS 

ALTER OPERATOR FAMILY, ALTER OPERATOR FAMILY 

ALTER ROLE, 角色 属性 , ALTER ROLE 

ALTER RULE, ALTER RULE 

ALTER SCHEMA, ALTER SCHEMA 

ALTER SEQUENCE, ALTER SEQUENCE 

ALTER SERVER, ALTER SERVER 

ALTER TABLE, ALTER TABLE 

ALTER TABLESPACE, ALTER TABLESPACE 

ALTER TEXT SEARCH CONFIGURATION, ALTER TEXT SEARCH CONFIGURATION 
ALTER TEXT SEARCH DICTIONARY, ALTER TEXT SEARCH DICTIONARY 


ALTER TEXT SEARCH PARSER, ALTER TEXT SEARCH PARSER 


ALTER TEXT SEARCH TEMPLATE, ALTER TEXT SEARCH TEMPLATE 
ALTER TRIGGER, ALTER TRIGGER 

ALTER TYPE, ALTER TYPE 

ALTER USER, ALTER USER 

ALTER USER MAPPING, ALTER USER MAPPING 

ALTER VIEW, ALTER VIEW 

ANALYZE, 更 新 规划 器 统计 , ANALYZE 

AND (操作 符 ), 逻辑 操作 符 

any, 伪 类 型 , RRRA, 子 查询 表达 式 , 行 和 数组 比较 
anyarray, 4% 3 24 

anyelement, 44 # Z! 

anyenum, 44 2 Æ 

anynonarray, 4 2 2! 

anyrange, 伪 类 型 

application_name configuration parameter, 记录 什么 
archive_cleanup_command recovery parameter, 轨 档 恢复 设置 
archive_command configuration parameter, J344 
archive_mode configuration parameter, J344 
archive_timeout configuration parameter, J344 

area, 几何 函数 和 操作 符 

armor, armor(), dearmor() 

ARRAY, 数组 构造 器 , Arrays 

constructor, 数组 构造 器 

of user-defined type, 用 户 定 义 类 型 

确定 结果 类 型 , UNION, CASE 和 相关 构造 
array_agg, 聚集 函数 , HX 


array_append, 2428 ENB AER EFT 


array_cat, 数组 函数 和 操作 符 

array_dims, 数组 函数 和 操作 符 

array_fill, 数组 函数 和 操作 符 

array_length, 数组 函数 和 操作 符 
array_lower, 数组 函数 和 操作 符 
array_ndims, 数组 函数 和 操作 符 
array_nulls configuration parameter, 以 前 的 PostgreSQL 版 本 
array_prepend, 数组 函数 和 操作 符 
array_remove, 数组 函数 和 操作 符 
array_replace, 数组 函数 和 操作 符 
array_to_json, JSON 画 数 和 操作 符 
array_to_string, 数组 函数 和 操作 符 
array_upper, 数组 函数 和 操作 符 

ascii, FIFE KRAER EIF 

asin, 数学 函数 和 操作 符 

AT TIME ZONE, AT TIME ZONE 

atan, 数学 函数 和 操作 符 

atan2, SF Ee BAER EE 
authentication_timeout configuration parameter, 安全 和 认证 
auth_delay, auth_delay 
auth_delay.milliseconds 配 置 参 数 , 配置 参数 
autocommit 

bulk-loading data, 关闭 自动 提交 

psql, Variables 

autovacuum 

configuration parameters, 自动 清理 


general information, Autovacuum 守 护 进 程 


Index 


autovacuum configuration parameter, 自动 清理 
autovacuum_analyze_scale_factor configuration parameter, 自动 清理 
autovacuum_analyze_threshold configuration parameter, 自动 清理 
autovacuum_freeze_max_age configuration parameter, 自动 清理 
autovacuum_max_workers configuration parameter, 自动 清理 
autovacuum_naptime configuration parameter, 自动 清理 
autovacuum_vacuum_cost_delay configuration parameter, 自动 清理 
autovacuum_vacuum_cost_limit configuration parameter, 自动 清理 
autovacuum_vacuum_scale_factor configuration parameter, 自动 清理 
autovacuum_vacuum_threshold configuration parameter, 自动 清理 
auto_explain, auto_ explain 

auto_explain.log_analyze 配 置 参 数 , 配置 参数 
auto_explain.log_buffers 配 置 参数 , 配置 参数 
auto_explain.log_format 配 置 参 数 , 配置 参数 
auto_explain.log_min_duration 配 置 参数 , 配置 参数 
auto_explain.log_nested_statements 配 置 参数 , 配置 参数 
auto_explain.log_timing 配 置 参 数 , 配置 参数 
auto_explain.log_verbose 配 置 参数 , 配置 参数 

avals, hstore RF FTA RIŽ 

average, 聚集 函数 


avg, RRNA 


B 


B-tree 
see 索引 
backslash escapes, C 风 格 的 逃逸 字符 串 常 量 


backslash_quote configuration parameter, 以 前 的 PostgreSQL 版 本 


backup, 各 份 与 恢复 

base type, PostgreSQL 类 型 系统 

BEGIN, BEGIN 

BETWEEN, 比较 操作 符 

BETWEEN SYMMETRIC, 比较 操作 符 
bgwriter_delay configuration parameter, 后 端 写 进程 
bgwriter_lru_maxpages configuration parameter, 后 端 写 进程 
bgwriter_lru_multiplier configuration parameter, Alm S vf 
bigint, 数值 常量 , 整数 类 型 

bigserial, 序列 号 类 型 

bison, 要 求 

bit string 

constant, 位 串 常 量 

bitmap scan, 规划 器 方法 配置 

bit_and, 聚集 函数 

bit_length, 字符 串 画 数 和 操作 符 

bit_or, RRMA 

BLOB 

see large object 

block_size configuration parameter, 预 重 选项 

bonjour configuration parameter, 连接 设置 

bonjour_name configuration parameter, 连接 设置 
bool_and, 有 聚集 函数 

bool_or, 聚集 西数 

box, 几何 函数 和 操作 符 

broadcast, 网 络 地 址 函数 和 操作 符 


btree_gin, btree_gin 
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btree_gist, btree_gist 

btrim, 字符 串 画 数 和 操作 符 , 二 进 制 字符 串 画 数 和 操作 符 
bt_metap, 函数 

bt_page_items, 西数 

bt_page_stats, 西数 

bytea, 二 进 制 数据 类 型 


bytea_output configuration parameter, 语句 行为 


C 


C, libpq - C È, ECPG - EC HERASQAL 

C++, 使 用 C++ 的 可 扩展 性 

Cascading Replication, 高 可 用 性 与 负载 均衡 ， 复 制 
CASE, 条 件 表 达 式 

确定 结果 类 型 , UNION, CASE 和 相关 构造 

case Sensitivity 

of SQL commands, 标识 符 和 关键 字 

cast 

I/O conversion, CREATE CAST 

cbrt, 数学 函数 和 操作 符 

ceil, 数学 函数 和 操作 符 

ceiling, 数学 函数 和 操作 符 

center, 几何 函数 和 操作 符 

char, 字符 类 型 

character set, 区 域 和 格式 化 , 预 置 选项 , 字符 集 支 持 
character string 

constant, 字符 串 常量 


char_length, 字符 串 函 数 和 操作 符 


Index 3435 


CHECKPOINT, CHECKPOINT 
checkpoint_completion_target configuration parameter, 检查 点 
checkpoint_segments configuration parameter, 检查 点 
checkpoint_timeout configuration parameter, 检查 点 
checkpoint_warning configuration parameter, 检查 点 
check_function_bodies configuration parameter, 语句 行为 
chkpass, chkpass 

chr, FFB KAREI 

cid, 对 象 标识 符 类 型 

cidr, cidr 

circle, 几何 函数 和 操作 符 

citext, citext 

client authentication 

timeout during, 安全 和 认证 

client encoding configuration parameter, 区 域 和 格式 化 
client_min_messages configuration parameter, 什么 时 候 记 录 日 志 
clock_timestamp, 时 间 / 日 期 男 数 和 操作 符 

CLOSE, CLOSE 

CLUSTER, CLUSTER 

of databases 

see database cluster 

clusterdb, clusterdb 

clustering, 高 可 用 性 与 负载 均衡 ， 复 制 

cmax, 系统 字段 

cmin, 系统 字段 

COALESCE, COALESCE 


COLLATE, 排序 规则 表达 式 


collation, 排序 规则 支持 

in PL/pgSQL, PL/pgSQL 变 量 的 排序 规则 

in SQL functions, 带 有 排序 规则 的 SQL 画 数 
collation for, 系统 信息 函数 

column, 概念 

column reference, 字段 引用 

col_description, 系统 信息 西数 

COMMENT COMMENT 

in SQL, 注释 

COMMIT COMMIT 

COMMIT PREPARED, COMMIT PREPARED 
commit_delay configuration parameter, 设置 
commit_siblings configuration parameter, izi= 
composite type, 复合 类 型 , PostgreSQL # ERA 
constant, 复合 类 型 值 输入 

constructor, 行 构造 器 

computed field, 复合 类 型 上 的 SQL 函数 
concat, 字符 串 函 数 和 操作 符 

concat_ws, 字符 串 画 数 和 操作 符 
concurrency, 并 发 控制 

configuration 

of recovery 

of a standby server, 恢复 配置 

of the server, fk 4288018 

configure, 安装 过 程 

config_file configuration parameter, 文件 位 置 


connectby, 函数 列表 , connectby 


conninfo, 连接 字符 串 

constant, 常量 

constraint exclusion, 其 它 规划 器 选 

constraint_exclusion configuration parameter, 其 它 规划 器 选项 
CONTINUE 

in PL/pgSQL, CONTINUE 

continuous archiving, 各 份 与 恢复 

control file, 扩展 文件 

convert, 字符 串 函 数 和 操作 符 

convert_from, 字符 串 函 数 和 操作 符 

convert_to, 字符 串 函 数 和 操作 符 

COPY, 向 表 中 添加 行 , COPY 

with libpq, 与 COPY 命 令 相 关 的 函数 

corr, EH 

correlation, 聚集 西数 

cos, 数学 函数 和 操作 符 

cot, 数学 函数 和 操作 符 

count, 2252 Ee 

covariance 

population, 聚集 函数 

sample, 聚集 函数 

covar_pop, 聚集 函数 

covar_samp, 聚集 西数 

cpu_index_tuple_cost configuration parameter, 规划 器 开销 常量 
cpu_operator_cost configuration parameter, 规划 器 开销 常量 
cpu_tuple_cost configuration parameter, 规划 器 开销 常量 


CREATE AGGREGATE, CREATE AGGREGATE 


CREATE CAST, CREATE CAST 

CREATE COLLATION, CREATE COLLATION 

CREATE CONVERSION, CREATE CONVERSION 

CREATE DATABASE, CREATE DATABASE 

CREATE DOMAIN, CREATE DOMAIN 

CREATE EVENT TRIGGER, CREATE EVENT TRIGGER 
CREATE EXTENSION, CREATE EXTENSION 

CREATE FOREIGN DATA WRAPPER, CREATE FOREIGN DATA WRAPPER 
CREATE FOREIGN TABLE, CREATE FOREIGN TABLE 
CREATE FUNCTION, CREATE FUNCTION 

CREATE GROUP, CREATE GROUP 

CREATE INDEX, CREATE INDEX 

CREATE LANGUAGE, CREATE LANGUAGE 

CREATE MATERIALIZED VIEW, CREATE MATERIALIZED VIEW 
CREATE OPERATOR, CREATE OPERATOR 

CREATE OPERATOR CLASS, CREATE OPERATOR CLASS 
CREATE OPERATOR FAMILY, CREATE OPERATOR FAMILY 
CREATE ROLE, 数据 库 角 色 , CREATE ROLE 

CREATE RULE, CREATE RULE 

CREATE SCHEMA, CREATE SCHEMA 

CREATE SEQUENCE, CREATE SEQUENCE 

CREATE SERVER, CREATE SERVER 

CREATE TABLE, 创建 新 表 , CREATE TABLE 

CREATE TABLE AS, CREATE TABLE AS 

CREATE TABLESPACE, 表 空 间 , CREATE TABLESPACE 
CREATE TEXT SEARCH CONFIGURATION, CREATE TEXT SEARCH CONFIGURATION 


CREATE TEXT SEARCH DICTIONARY, CREATE TEXT SEARCH DICTIONARY 





PostgreSQL 中 文 文档 9.3 


CREATE TEXT SEARCH PARSER, CREATE TEXT SEARCH PARSER 
CREATE TEXT SEARCH TEMPLATE, CREATE TEXT SEARCH TEMPLATE 
CREATE TRIGGER, CREATE TRIGGER 
CREATE TYPE, CREATE TYPE 
CREATE USER, CREATE USER 
CREATE USER MAPPING, CREATE USER MAPPING 
CREATE VIEW, CREATE VIEW 
createdb, 创建 一 个 数据 库 , 创建 一 个 数据 库 , createdb 
createlang, createlang 
createuser, 数据 库 角 色 , createuser 
cross compilation, 安装 过 程 
crosstab, crosstab(text), crosstabN(text), crosstab(text, text) 
crypt, crypt() 
cstring, 4 % Æ 
ctid, 系统 字段 , JE SELECT 语句 的 视图 规则 
cube, cube 
cume_dist, 窗口 函数 
current_catalog, 系统 信息 函数 
current_database, 系统 信息 函数 
current_date, 时 间 /日 期 西数 和 操作 符 
current_query, 系统 信息 函数 
current_schema, 系统 信息 函数 
current_schemas, 系统 信息 函数 
current_setting, 配置 设置 西数 
current_time, 时 间 / 日 期 画 数 和 操作 符 
current_timestamp, 时 间 / 日 期 西数 和 操作 符 


current_user, 系统 信息 函数 


Index 


currval, 序列 操作 函数 

cursor 

CLOSE, CLOSE 

in PL/pgSQL, 游标 

cursor_tuple_fraction configuration parameter, 其 它 规划 器 选项 
Cygwin 


installation on, Cygwin 


D 


data partitioning, 高 可 用 性 与 负载 均衡 ， 复 制 
data type 

base, PostgreSQL 类 型 系统 

composite, PostgreSQL 类 型 系统 

constant, 类 型 的 常 

internal organization, 基本 类 型 的 C 语 言 琅 数 
type cast, 类 型 转换 

user-defined, 用 户 定 义 类 型 

database activity 

monitoring, 监控 数据 库 的 活动 

database cluster, 概念 

data_directory configuration parameter, 文件 位 置 
DateStyle configuration parameter, 区 域 和 格式 化 
date_part, 时 间 / 日 期 画 数 和 操作 符 , EXTRACT, date_part 
date_trunc, 时 间 / 日 期 沙 数 和 操作 符 , date_trunc 
dblink, dblink, dblink 

dblink_build_sql_delete, dblink_build_sql_delete 


dblink_build_sql_insert, dblink_build_sql!_insert 


dblink_build_sql_update, dblink_build_sq! update 
dblink_cancel_query, dblink_cancel_query 

dblink_close, dblink_close 

dblink_connect, dblink_connect 

dblink_connect_u, dblink_connect_u 

dblink_disconnect, dblink_disconnect 
dblink_error_message, dblink_error message 
dblink_exec, dblink_exec 

dblink_fetch, dblink_fetch 

dblink_get_connections, dblink_get_connections 
dblink_get_notify, dblink_get_notify 

dblink_get_pkey, dblink_get_pkey 

dblink_get_result, dblink_get_result 

dblink_is_busy, dblink_is busy 

dblink_open, dblink_open 

dblink_send_query, dblink_send_query 
db_user_namespace configuration parameter, 安全 和 认证 
deadlock, 死 锁 

timeout during, 锁 管 理 

deadlock_timeout configuration parameter, 锁 管 理 
DEALLOCATE, DEALLOCATE 

dearmor, armor(), dearmor() 

debug_assertions configuration parameter, 开发 人 员 选 项 
debug_deadlocks configuration parameter, 开发 人 员 选 项 
debug_pretty_print configuration parameter, 记录 什么 
debug_print_parse configuration parameter, 记录 什么 


debug_print_plan configuration parameter, 记录 什么 


debug_print_rewritten configuration parameter, 记录 什么 
DECLARE, DECLARE 

decode, 字符 串 函 数 和 操作 符 , 二 进 制 字 符 串 函数 和 操作 符 
decode_bytea 

in PL/Perl, PL/Perl E B93 A 2X 

decrypt_iv, 行 加 窗 功 能 

default_statistics_target configuration parameter, 其 它 规划 器 选项 
default_tablespace configuration parameter, 语句 行为 
default_text_search_config configuration parameter, 区 域 和 格式 化 
default_transaction_deferrable configuration parameter, 语句 行为 
default_transaction_isolation configuration parameter, 语句 行为 
default_transaction_read_only configuration parameter, 语句 行为 
default_with_oids configuration parameter, 以 前 的 PostgreSQL 版 本 
deferrable transaction 

setting default, 语句 行为 

defined, hstore 操作 符 和 郴 数 

degrees, 数学 函数 和 操作 符 

delay, 延 时 执行 

DELETE, 删除 , 删除 数据 , DELETE, hstore 操作 符 和 画 数 
deleting, 删除 数据 

dense_rank, 窗口 西数 

diameter, 几何 函数 和 操作 符 

dict_int, dict_int 

dict_xsyn, dict_xsyn 

digest, digest() 

Digital UNIX 


see Tru64 UNIX 


dirty read, 事务 隔离 

DISCARD, DISCARD 

disk space, 恢复 磁盘 空间 

DISTINCT 查询 一 个 表 , DISTINCT 

div, 数学 函数 和 操作 符 

dmetaphone, Double Metaphone 

dmetaphone_alt, Double Metaphone 

DO, DO 

document 

text search, 文档 是 什么 ? 

dollar quoting, 美元 符 引 用 字符 串 常 量 

DROP AGGREGATE, DROP AGGREGATE 

DROP CAST, DROP CAST 

DROP COLLATION, DROP COLLATION 

DROP CONVERSION, DROP CONVERSION 
DROP DATABASE, 删除 数据 库 , DROP DATABASE 
DROP DOMAIN, DROP DOMAIN 

DROP EVENT TRIGGER, DROP EVENT TRIGGER 
DROP EXTENSION, DROP EXTENSION 

DROP FOREIGN DATA WRAPPER, DROP FOREIGN DATA WRAPPER 
DROP FOREIGN TABLE, DROP FOREIGN TABLE 
DROP FUNCTION, DROP FUNCTION 

DROP GROUP, DROP GROUP 

DROP INDEX, DROP INDEX 

DROP LANGUAGE, DROP LANGUAGE 

DROP MATERIALIZED VIEW, DROP MATERIALIZED VIEW 


DROP OPERATOR, DROP OPERATOR 


DROP OPERATOR CLASS, DROP OPERATOR CLASS 

DROP OPERATOR FAMILY, DROP OPERATOR FAMILY 

DROP OWNED, DROP OWNED 

DROP ROLE, 数据 库 角 色 , DROP ROLE 

DROP RULE, DROP RULE 

DROP SCHEMA, DROP SCHEMA 

DROP SEQUENCE, DROP SEQUENCE 

DROP SERVER, DROP SERVER 

DROP TABLE, 创建 新 表 , DROP TABLE 

DROP TABLESPACE, DROP TABLESPACE 

DROP TEXT SEARCH CONFIGURATION, DROP TEXT SEARCH CONFIGURATION 
DROP TEXT SEARCH DICTIONARY, DROP TEXT SEARCH DICTIONARY 
DROP TEXT SEARCH PARSER, DROP TEXT SEARCH PARSER 
DROP TEXT SEARCH TEMPLATE, DROP TEXT SEARCH TEMPLATE 
DROP TRIGGER, DROP TRIGGER 

DROP TYPE, DROP TYPE 

DROP USER, DROP USER 

DROP USER MAPPING, DROP USER MAPPING 

DROP VIEW, DROP VIEW 

dropdb, 删除 数据 库 , dropdb 

droplang, droplang 

dropuser, 数据 库 角 色 , dropuser 

DTD, 创建 XML 值 

DTrace, 安装 过 程 , 动态 跟踪 

dummy_seclabel, dummy_seclabe! 

duplicate, 查询 一 个 表 


dynamic loading, 其 他 缺 省 , 动态 加 载 


dynamic_library_path, 动态 加 载 


dynamic_library_path configuration parameter, 其 他 缺 省 


E 


each, hstore #2/F FFA EEX 

earth, 基于 立方 体 的 地 球 距 离 

earthdistance, earthdistance 

earth_box, 基于 立方 体 的 地 球 距离 

earth_distance, 基于 立方 体 的 地 球 距离 

ECPG, ECPG - EC Hi ASQL, ecpg 

effective_cache_size configuration parameter, 规划 器 开销 常量 
effective_io_concurrency configuration parameter, Asynchronous Behavior 
elog, 报告 服务 器 里 的 错误 

in PL/Perl, PL/Perl 里 的 效用 函数 

in PL/Python, Utility Functions 

in PL/Tel, 在 PL/Tcl 里 访问 数据 库 

embedded SQL 

in C, ECPG - EC HERASQL 

enabled role, enabled_roles 

enable_bitmapscan configuration parameter, 规划 器 方法 配置 
enable_hashagg configuration parameter, 规划 器 方法 配置 
enable_hashjoin configuration parameter, 规划 器 方法 配置 
enable_indexonlyscan configuration parameter, 规划 器 方法 配置 
enable_indexscan configuration parameter, 规划 器 方法 配置 
enable_material configuration parameter, 规划 器 方法 配置 
enable_mergejoin configuration parameter, 规划 器 方法 配置 


enable_nestloop configuration parameter, 规划 器 方法 配置 


enable_seqscan configuration parameter, 规划 器 方法 配置 
enable_sort configuration parameter, 规划 器 方法 配置 
enable_tidscan configuration parameter, 规划 器 方法 配置 
encode, +f ES AAR VER, 二 进 制 字 符 串 函 数 和 操作 符 
encode array_constructor 

in PL/Perl, PL/Perl 里 的 效用 函数 

encode_array_literal 

in PL/Perl, PL/Perl 里 的 效用 函数 

encode_bytea 

in PL/Perl, PL/Perl 里 的 效用 函数 

encode typed literal 

in PL/Perl, PL/Perl E U3 FA 2 

encrypt_iv, 行 加 窗 功 能 
END, END 
enum_first, MAW 

enum_last, 支持 枚 举 函 数 

enum_range, iFM AWA 

ereport, 报告 服务 器 里 的 错误 

error codes 

libpq, ERR 

list of, PostgreSQL 错误 代码 

escape string syntax, C 风 格 的 逃逸 字符 串 常 量 

escape_string_warning configuration parameter, 以 前 的 PostgreSQL 版 本 
event_source configuration parameter, 在 哪里 记录 日 志 

every, 聚集 西数 


exceptions 


in PL/pgSQL, 捕获 错误 


EXECUTE, EXECUTE 

exist, hstore #2/F FF #1 AX 

EXISTS, 子 查询 表达 式 

EXIT 

in PL/pgSQL, 退出 

exit_on_error configuration parameter, Error Handling 
exp, 数学 函数 和 操作 符 

EXPLAIN, 使 用 EXPLAIN, EXPLAIN 

expression 

order of evaluation, 表达 式 计算 规则 

syntax, 值 表 达 式 

extending SQL, 扩展 SQL 

extension, 包装 相关 对 象 到 一 个 扩展 

externally maintained, 扩展 

external_pid_file configuration parameter, 文件 位 置 
extract, #t H/H RAB ER AERVE FT, EXTRACT, date_part 


extra_float_digits configuration parameter, 区 域 和 格式 化 


F 


failover, 高 可 用 性 与 负载 均衡 ， 复 制 
false, 布尔 类 型 

family, Pa) 2s He tit By aA ER VE 
fdw_handler, 4% % 24 

FETCH, FETCH 

field 

computed, #4 ž Œ EAVSQLENE 


field selection, 字段 选择 


file_fdw, file_fdw 

first_value, 窗口 西数 

flex, 要 求 

float4 

see real 

float8 

see double precision 

floating-point 

display, 区域 和 格式 化 

floor, 数学 函数 和 操作 符 

foreign key, 外 键 

format, #5 EXE AER ET 

use in PL/pgSQL, 执行 动态 命令 
format_type, 系统 信息 函数 

Free Space Map, 自由 空间 映射 

FreeBSD 

IPC 配置 , 共享 内 存 和 信号 灯 

shared library, 编译 和 链接 动态 加 载 的 函数 
启动 脚本 , 启动 数据 库 服务 器 
from_collapse_limit configuration parameter, 其 它 规划 器 选项 
FSM 

see Free Space Map 
fsm_page_contents, 2% 

fsync configuration parameter, izi= 

full text search, 全 文 检索 
full_page_writes configuration parameter, 设置 


function 


default values for arguments, 具有 参数 缺 省 值 的 SQL 郴 数 
internal, A REIZ 

invocation, 函数 调用 

mixed notation, 使 用 混合 表示 法 

named argument, Arguments for SQL Functions 

named notation, 使 用 名 称 表示 法 

output parameter, 带 输 出 参数 的 SQL 男 数 

polymorphic, 多 态 类 型 

positional notation, 使 用 位 置 表示 法 

RETURNS TABLE, 返回 TABLE 的 SQL 函数 


user-defined, 用 户 定义 的 函数 


= 


in C, C-i2 SH? 
in SQL, 414345 (SQL)HR 

variadic, 带 有 参数 可 变数 量 的 SQL 
with SETOF, 返回 集合 的 SQL 本 数 


fuzzystrmatch, fuzzystrmatch 


G 


gc_to_sec, 基于 立方 体 的 地 球 距离 
generate_series, 返回 集合 的 函数 
generate_subscripts, 返回 集合 的 函数 
genetic query optimization, 基因 查询 优化 器 
gen_random_bytes, 随机 数据 函数 

gen_salt, gen_salt() 

GEQO 

see genetic query optimization 


geqo configuration parameter, 基因 查询 优化 器 


Index 


geqo_ effort configuration parameter, 基因 坦 询 优化 器 
geqo_generations configuration parameter, 基因 查询 优化 器 
geqo_pool size configuration parameter, 基因 查询 优化 器 
geqo_seed configuration parameter, 基因 查询 优化 器 
geqo_selection_bias configuration parameter, 基因 查询 优化 器 
geqo_threshold configuration parameter, 基因 查询 优化 器 
get_bit, 二 进 制 字符 串 男 数 和 操作 符 

get_byte, 二 进 制 字 符 串 函数 和 操作 符 
get_current_ts_config, 文本 检索 函数 和 操作 符 
get_raw_page, 西数 

GIN 

see 索引 

gin_fuzzy_search_limit configuration parameter, 其 他 缺 省 
GiST 

see 索引 

global data 

in PL/Python, Sharing Data 

GRANT, GRANT 

GREATEST, GREATEST and LEAST 

确定 结果 类 型 , UNION, CASE 和 相关 构造 

Gregorian calendar, 单位 历史 

GROUP BY, 聚集 函数 , GROUP BY 和 HAVING 子 名 
grouping, GROUP BY 和 HAVING 子 名 

GSSAPI, GSSAPI 认证 


GUID, UUID 类 型 


H 


has_any_column_privilege, 系统 信息 画 数 
has_column_privilege, 系统 信息 画 数 
has_database_privilege, 系统 信息 男 数 
has_foreign_data_wrapper_privilege, 系统 信息 画 数 
has_function_privilege, 系统 信息 画 数 
has_language_privilege, 系统 信息 画 数 
has_schema_privilege, 系统 信息 函数 
has_sequence_privilege, 系统 信息 画 数 
has_server_privilege, 系统 信息 画 数 
has_tablespace_privilege, 系统 信息 函数 
has_table_privilege, 系统 信息 函数 

HAVING, 225268 2%, GROUP BY 和 HAVING 子 名 
hba_file configuration parameter, 文件 位 置 
heap_page_items, 西数 

height, 几何 函数 和 操作 符 

hierarchical database, 概念 

high availability, 高 可 用 性 与 负载 均衡 ， 复 制 
history 

of PostgreSQL, PostgreSQL 简 史 

hmac, hmac() 

host, 网 络 地 址 画 数 和 操作 符 

hostmask, 网 络 地 址 函数 和 操作 符 

Hot Standby, 高 可 用 性 与 负载 均衡 ， 复 制 
hot_standby configuration parameter, 备用 服务 器 
hot_standby_feedback configuration parameter, % HRR 4-25 
HP-UX 


installation on, HP-UX 


IPC 配置 , 共享 内 存 和 信号 灯 

shared library, 编译 和 链接 动态 加 载 的 范 数 
hstore, hstore, hstore 操作 符 和 画 数 
hstore_to_array, hstore 操作 符 和 郴 数 
hstore_to_json, hstore 操作 符 和 男 数 
hstore_to_json_loose, hstore 操作 符 和 男 数 


hstore to_matrix, hstore 操作 符 和 函数 


icount, intarray 函数 和 操作 符 

ident, Ident 认证 

identifier 

length, 标识 符 和 关键 字 

syntax of, 标识 符 和 关键 字 

ident_file configuration parameter, 文件 位 置 

idx, intarray 函数 和 操作 符 

IFNULL, COALESCE 

ignore_checksum_failure configuration parameter, 开发 人 员 选 项 
ignore_system_indexes configuration parameter, 开发 人 员 选 项 
IMMUTABLE, 函数 易 失 性 范畴 

IN, 子 查询 表达 式 , 行 和 数组 比较 

include 

in configuration file, 配置 文件 包含 

include dir 

in configuration file, 配置 文件 包含 

include_if_exists 


in configuration file, 配置 文件 包含 
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index, 操作 符 和 函数 

building concurrently, 并 发 建立 索引 
GIN 

text search, GiST 和 GIN 索 引 类 型 

GiST 

text search, GiST 和 GIN 索 引 类 型 
locks, 锁 和 索引 

index scan, 规划 器 方法 配置 
index-only scan, 规划 器 方法 配置 

inet (数据 类 型 ), inet 

inet_client_addr, 系统 信息 函数 
inet_client_port, 系统 信息 函数 
inet_server_addr, 系统 信息 函数 
inet_server_port, 系统 信息 函数 
inheritance, 继承 , 以 前 的 PostgreSQL 版 本 
initcap, A BN BAER Ea 

initdb, 创建 数据 库 集 群 ,initdb 
Initialization Fork, 初始 化 分 支 

input function, 用 户 定义 类 型 

INSERT, 向 表 中 添加 行 , 插入 数据 , INSERT 
inserting, 插入 数据 

installation, 源码 安装 

on Windows, Windows 下 用 源 代码 安装 
instr, 移植 祥 例 

int2 

see smallint 


int4 
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see integer 

int8 

see bigint 
intagg, intagg 
intarray, intarray 
integer, 数值 常量 

integer_datetimes configuration parameter, ti iE + 
interfaces 

externally maintained, 客户 端 接口 

internal, 伪 类 型 

IntervalStyle configuration parameter, 区 域 和 格式 化 
intset, intarray 范 数 和 操作 符 

int_array_aggregate, 西数 

int_array_enum, 西数 

IRIX 

installation on, IRIX 

shared library, 编译 和 和 链接 动态 加 载 的 函数 

IS DISTINCT FROM, 比较 操作 符 , 行 和 数组 比较 

IS DOCUMENT, IS DOCUMENT 

IS FALSE, 比较 操作 符 

IS NOT DISTINCT FROM, 比较 操作 符 , 行 和 数组 比较 
IS NOT FALSE, 比较 操作 符 

IS NOT NULL, 比较 操作 符 

IS NOT TRUE, 比较 操作 符 

IS NOT UNKNOWN, 比较 操作 符 

IS NULL, 比较 操作 符 , 平台 和 客户 端 兼容 


IS TRUE, 比较 操作 符 


PostgreSQL 中 文 文档 9.3 


IS UNKNOWN, 比较 操作 符 
isclosed, 几何 画 数 和 操作 符 
isempty, 3 A AER VE FF 
isfinite, 时 间 / 日 期 画 数 和 操作 符 
isn, isn 

ISNULL, 比较 操作 符 

isn_weak, 函数 和 操作 符 
isopen, 几何 函数 和 操作 符 
is_array_ref 

in PL/Perl, PL/Perl E AY3i A Ea 2X 


is_valid, EX aX AIRES 


J 


join, 在 表 间 连接 

controlling the order, 用 明确 的 JOIN 控 制 规 划 器 
outer, 在 表 间 连接 

self, 在 表 间 连接 

join_collapse_limit configuration parameter, 其 它 规 划 器 选项 
JSON, JSON 类 型 

函数 和 操作 符 , ISON 函数 和 操作 符 

json_agg, HX 

json_array_elements, JSON AFAR EF 
json_array_length, JSON 函数 和 操作 符 
json_each, JSON 函数 和 操作 符 
json_each_text, JSON 函数 和 操作 符 
json_extract_path, JSON 画 数 和 操作 符 


json_extract_path_text, JSON 男 数 和 操作 符 
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json_object_keys, JSON 函数 和 操作 符 
json_populate_record, JSON 西数 和 操作 符 
json_populate_recordset, JSON 西数 和 操作 符 
Julian date, 单位 历史 

justify_days, 时 间 / 日 期 画 数 和 操作 符 
justify_hours, 时 间 / 日 期 画 数 和 操作 符 


justify_interval, 时 间 / 日 期 范 数 和 操作 符 


K 


Kerberos, Kerberos 认证 

key word 

syntax of, 标识 符 和 关键 字 

krb_caseins_users configuration parameter, 安全 和 认证 
krb_server_keyfile configuration parameter, 安全 和 认证 


krb_srvname configuration parameter, 安全 和 认证 


L 


lag, 窗口 函数 

language_handler, 伪 类 型 

large object, 大 对 和 象 

lastval, Fr FUER FSX 

last_value, 窗口 西数 

LATERAL 

在 FROM 子 句 中 , LATERAL 子 查询 
latitude, 基于 立方 体 的 地 球 距离 
Ica, ERIE FF ALES Z 


Ic_collate configuration parameter, 预 置 选项 


Ic_ctype configuration parameter, #i iE i m 
Ic_messages configuration parameter, 区 域 和 格式 化 
Ic_monetary configuration parameter, 区 域 和 格式 化 
Ic_numeric configuration parameter, 区 域 和 格式 化 
Ic_time configuration parameter, 区 域 和 格式 化 
LDAP, 安装 过 程 , LDAP 认证 

LDAP 连 接 参 数 查 找 , LDAP 坦 找 连接 参数 

ldconfig, 共享 库 

lead, 窗口 函数 

LEAST, GREATEST and LEAST 

确定 结果 类 型 , UNION, CASE 和 相关 构造 

left, FB Es BAER EF 


length, Ft SAR VER, 二 进 制 字 符 串 画 数 和 操作 符 , 几何 函数 和 操作 符 , 文本 检索 函数 
和 操作 符 


length(tsvector), 操作 文档 
levenshtein, Levenshtein 
levenshtein_less_equal, Levenshtein 
lex, 要 求 

libedit, 要 求 

libperl, 要 求 

libpq, libpq - C È 

单行 模式 , 逐 行 检 索 查 询 结 

libpq-fe.h, libpq - C 库 , 连接 状态 函数 
libpq-int.h, 连接 状态 函数 

libpython, 要 求 

library finalization function, 动态 加 载 


library initialization function, 4) J13, 


Index DARQ 
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LIKE, LIKE 

以 及 区 域 , 行为 

LIMIT, LIMIT 和 OFFSET 

Linux 

IPC 配置 , 共享 内 存 和 信号 灯 

shared library, 编译 和 和 链接 动态 加 载 的 函数 

启动 脚本 , 启动 数据 库 服务 器 

LISTEN, LISTEN 

listen_addresses configuration parameter, 连接 设置 
ll_to_earth, 基于 立方 体 的 地 球 距离 

In, 数学 函数 和 操作 符 

lo, lo 

LOAD, LOAD 

load balancing, 高 可 用 性 与 负载 均衡 ， 复 制 

locale, 区 域 支 持 

localtime, 时 间 / 日 期 画 数 和 操作 符 

localtimestamp, 时 间 / 日 期 男 数 和 操作 符 
local_preload_libraries configuration parameter, 其 他 缺 省 
lock, 明确 锁定 , 表 级 锁 , LOCK 

advisory, 咨询 锁 

monitoring, 查看 锁 

lock_timeout configuration parameter, 语句 行为 

log, 数学 函数 和 操作 符 

log shipping, 高 可 用 性 与 负载 均衡 ， 复 制 
logging_collector configuration parameter, 在 哪里 记录 日 志 
log_autovacuum_min_duration configuration parameter, 自动 清理 


log_btree_build_stats configuration parameter, 开发 人 员 选 项 


log_checkpoints configuration parameter, 记录 什么 
log_connections configuration parameter, 记录 什么 
log_destination configuration parameter, 在 哪里 记录 日 志 
log_directory configuration parameter, 在 哪里 记录 日 志 
log_disconnections configuration parameter, 记录 什么 
log_duration configuration parameter, 记录 什么 
log_error_verbosity configuration parameter, 记录 什么 
log_executor_stats configuration parameter, 统计 监控 
log_filename configuration parameter, 在 哪里 记录 日 志 
log_file_mode configuration parameter, 在 哪里 记录 日 志 
log_hostname configuration parameter, 记录 什么 

log_line_prefix configuration parameter, 记录 什么 

log_lock_waits configuration parameter, 记录 什么 
log_min_duration_statement configuration parameter, 什么 时 候 记 录 日 志 
log_min_error_statement configuration parameter, 什么 时 候 记 录 日 志 
log_min_messages configuration parameter, 什么 时 候 记 录 日 志 
log_parser_stats configuration parameter, 统计 监控 
log_planner_stats configuration parameter, 统计 监控 
log_rotation_age configuration parameter, 在 哪里 记录 日 志 
log_rotation_size configuration parameter, 在 哪里 记录 日 志 
log_statement configuration parameter, 记录 什么 
log_statement_stats configuration parameter, 统计 监控 
log_temp_files configuration parameter, 记录 什么 

log_timezone configuration parameter, 记录 什么 
log_truncate_on_rotation configuration parameter, 在 哪里 记录 日 志 
longitude, 基于 立方 体 的 地 球 距离 


looks_like_number 
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in PL/Perl, PL/Perl 里 的 效用 部 数 

loop 

in PL/pgSQL, 简单 循环 

lower, 字符 串 函 数 和 操作 符 , 范围 函数 和 操作 符 
和 区 域 , 行为 


K 


AER VE 
g 数 和 操作 符 
lo_close, 关闭 一 个 大 对 象 描述 符 


lower_inc, 范围 


K 


lower_inf, 范围 


lo_compat_privileges configuration parameter, 以 前 的 PostgreSQL 版 本 


lo_creat, 创建 大 对 象 , 服务 器 端 画 数 


lo_create, 创建 大 对 象 , 服务 器 端 画 数 
lo_export, 输出 大 对 象 , 服务 器 端 画 数 
lo_import, 输入 大 对 象 , 服务 器 端 画 数 


lo_import_with_oid, 输入 大 对 象 

lo_lseek, 大 对 象 中 查找 

lo_lseek64, 大 对 象 中 查找 

lo_open, 打开 一 个 现 有 的 大 对 象 

lo_read, 从 大 对 象 中 读 取 数 据 

lo_tell, 获取 一 个 大 对 象 的 当前 索引 位 置 
lo_tell64, 获取 一 个 大 对 象 的 当前 索引 位 置 
lo_truncate, 截断 一 个 大 对 象 
lo_truncate64, 截断 一 个 大 对 象 
lo_unlink, 删除 一 个 大 对 象 , 服务 器 端 画 数 
lo_write, 向 大 对 象 中 写 数 据 

Ipad, 字符 串 画 数 和 操作 符 

Iseg, 线段 , 几何 函数 和 操作 符 


Itree, Itree 
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Itree2text, 操作 符 和 函数 
ltrim, 字符 串 函 数 和 操作 符 


Mac OS X 

IPC 配置 , 共享 内 存 和 信号 灯 

shared library, 编译 和 链接 动态 加 载 的 函数 

MAC 地 址 

see macaddr 

macaddr (数据 类 型 ) macaddr 

magic block, 动态 加 载 

maintenance, 日 常数 据 库 维护 工作 
maintenance_work_mem configuration parameter, 内 存 
make, 要 求 

make_valid, 西数 和 操作 符 

MANPATH, 环境 变量 

masklen, 网 络 地 址 函数 和 操作 符 

materialized views, pg_matviews 

max, RREZ 

max_connections configuration parameter, 连接 设置 
max_files_per_process configuration parameter, 内 核资 源 使 用 
max_function_args configuration parameter, 预 置 选项 
max_identifier_length configuration parameter, 预 置 选项 
max_index_keys configuration parameter, 预 置 选项 
max_locks_per_transaction configuration parameter, 锁 管 理 
max_pred_locks_per_transaction configuration parameter, 锁 管 理 


max_prepared_transactions configuration parameter, 内 存 


max_stack_depth configuration parameter, 内 存 
max_standby_archive_delay configuration parameter, 各 用 服务 妖 
max_standby_streaming_delay configuration parameter, 4 FSi 425 
max_wal_senders configuration parameter, 发 送 服务 器 

md5, 字符 串 画 数 和 操作 符 , 二 进 制 字 符 串 函数 和 操作 符 , 口令 认证 
metaphone, Metaphone 

min, 聚集 西数 

MinGW 

installation on, MinGW/Native Windows 

mod, 数学 函数 和 操作 符 

monitoring 

database activity, 监控 数据 库 的 活动 

MOVE, MOVE 

Multiversion Concurrency Control, 介绍 


MVCC, 介绍 


N 


name 
syntax of, 标识 符 和 关键 字 

NaN 

see not a number 

NetBSD 

IPC 配置 , 共享 内 存 和 信号 灯 

shared library, 编译 和 链接 动态 加 载 的 范 数 
启动 脚本 , 启动 数据 库 服务 器 

netmask, 网 络 地 址 函数 和 操作 符 

network, 网 络 地 址 函数 和 操作 符 


nextval, Fr FER (FX 

NFS 

see 网 络 文件 系统 

nlevel, 操作 符 和 男 数 
non-durable, 非 持久 性 设置 
nonrepeatable read, 事务 隔离 
normal_rand, normal_rand 
NOT (操作 符 ), 逻辑 操作 符 
NOT IN, 子 查询 表达 式 , 行 和 数组 比较 
notation 

functions, 调用 函数 

NOTIFY, NOTIFY 

在 libpq 中 , 异步 通知 
NOTNULL, 比较 操作 符 

now, 时 间 / 日 期 画 数 和 操作 符 
npoints, SLITERE IF 
nth_value, 窗口 函数 

ntile, 窗口 函数 

null value 

comparing, 比较 操作 符 

in PL/Perl, PL/Perl 函数 和 参数 
in PL/Python, Null, None 

null 44 

HEAR, 检查 约束 

in DISTINCT, DISTINCT 
唯一 约束 , 唯一 约束 

缺 省 值 , 缺 省 值 


Index 
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NULLIF, NULLIF 

number 

constant, 数值 常量 

numeric, 数值 常量 

numnode, 文本 检索 函数 和 操作 符 , 处 理 查 询 


NVL, COALESCE 


O 


object-oriented database, 概念 
obj_description, 系统 信息 函数 
octet_length, 字符 串 画 数 和 操作 符 , 二 进 制 字 符 串 函数 和 操作 符 
OFFSET, LIMIT 和 OFFSET 

oid, 对 象 标识 符 类 型 

in libpq, 检索 其 它 命令 的 结果 信息 

字段 , 系统 字段 

oid2name, oid2name 

ONLY, FROM 子 名 

opaque, 伪 类 型 

OpenBSD 

IPC 配置 , 共享 内 存 和 信号 灯 

shared library, 编译 和 链接 动态 加 载 的 函数 
启动 脚本 , 启动 数据 库 服务 器 

OpenSSL, 安装 过 程 

see also SSL 

operator 

invocation, 操作 符 调用 


precedence, 操作 符 优先 级 
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syntax, #2 /F 

OR (操作 符 ), 逻辑 操作 符 

Oracle 

porting from PL/SQL to PL/pgSQL, 从 Oracle PL/SQL 进 行 移植 
ORDER BY, 查询 一 个 表 , 行 排序 

和 区 域 , 行为 

output function, 用 户 定 义 类 型 

OVER clause, 窗口 调用 函数 

overlay, 字符 串 函 数 和 操作 符 , 二 进 制 字 符 串 画 数 和 操作 符 
overloading 

functions, HABA 


operators, 用 户 定 义 操 作 符 
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pageinspect, pageinspect 
page_header, 西数 

palloc, 书写 代码 

PAM, 安装 过 程 , PAM 认证 
parameter 

syntax, 位 置 参 数 

parenthesis, 值 表达 式 

password 

of the superuser, 创建 数据 库 集群 
passwordcheck, passwordcheck 
password_encryption configuration parameter, 安全 和 认证 
path, 几何 函数 和 操作 符 , 环境 变量 


for schemas, 语句 行为 


patterns 

in psql and pg_dump, Patterns 
pause_at_recovery_target recovery parameter, 恢复 目标 设置 
pclose, 几何 函数 和 操作 符 

peer, Peer 认证 

percent_rank, 窗口 西数 
performance, 性 能 提升 技巧 

perl, 要 求 , PL/Perl - Perl 过 程 语言 
pfree, 书写 代码 

PGAPPNAME, 环境 变量 
pgbench, pgbench 

PGcancel, 取消 正在 义理 的 查询 
PGCLIENTENCODING, 环境 变量 
PGconn, 数据 库 连 接 控制 画 数 
PGCONNECT_TIMEOUT, 环境 变量 
pgcrypto, pgcrypto 

PGDATA, 创建 数据 库 集 群 
PGDATABASE, 环境 变量 
PGDATESTYLE, 环境 变量 
PGEventProc, 事件 回调 过 程 
PGGEQO, 环境 变量 

PGGSSLIB, 环境 变量 

PGHOST, 环境 变量 
PGHOSTADDR, 环境 变量 
PGKRBSRVNAME, 环境 变量 
PGLOCALEDIR, 环境 变量 


PGOPTIONS, 环境 变量 


PGPASSFILE, 环境 变量 

PGPASSWORD, 环境 变量 

PGPORT, #184 = 

pgp_key_id, pgp_key_id() 
pgp_pub_decrypt, pgp_pub_decrypt() 
pgp_pub_decrypt_bytea, pgp_pub_decrypt() 
Ppgp_pub_encrypt, pgp_pub_encrypt() 
pgp_pub_encrypt_bytea, pgp_pub_encrypt() 
pgp_sym_decrypt, pgp_sym_decrypt() 
pgp_sym_decrypt_bytea, pgp_sym_decrypi() 
pgp_sym_encrypt, pgp_sym_encrypt() 
pgp_sym_encrypt_bytea, pgp_sym_encrypt() 
PGREALM, 环境 变量 

PGREQUIREPEER, 环境 变量 
PGREQUIRESSL, 环境 变量 

PGresult, È KJ 

pgrowlocks, pgrowlocks, 概述 

PGSERVICE, 环境 变量 

PGSERVICEFILE, 环境 变量 

PGSSLCERT, 环境 变量 
PGSSLCOMPRESSION, 环境 变量 
PGSSLCRL, 环境 变量 

PGSSLKEY, 环境 变量 

PGSSLMODE, 环境 变量 
PGSSLROOTCERT, 环境 变量 
pgstatginindex, H2% 


pgstatindex, 西数 


pgstattuple, pgstattuple, 2X 
PGSYSCONFDIR, 环境 变量 

PGTZ, 环境 变量 

PGUSER, 环境 变量 

pgxs, 扩展 基础 设施 建设 

pg_advisory_lock, 咨询 锁 函 数 
pg_advisory_lock_shared, 4 i4#i HX 
pg_advisory_unlock, 咨询 锁 函 数 
pg_advisory_unlock_all, 咨询 锁 西 数 
pg_advisory_unlock_shared, 咨询 锁 函 数 
pg_advisory_xact_lock, 4 j4) 4% HAN 
pg_advisory_xact_lock_shared, 4 ii HŽ 
pg_aggregate, pg_aggregate 

pg_am, pg_am 

pg_amop, pg_amop 

pg_amproc, pg_amproc 
pg_archivecleanup, pg_archivecleanup 
pg_attrdef, pg_attrdef 

pg_attribute, pg_attribute 

pg_authid, pg_authid 

pg_auth_members, pg_ auth members 
pg_available_extensions, pg_available extensions 
pg_available_extension_versions, pg_available_extension_versions 
pg_backend_pid, 系统 信息 函数 
pg_backup_start_time, 各 份 控制 函数 
pg_basebackup, pg_basebackup 


pg_buffercache, pg_buffercache 


pg_buffercache_pages, pg_buffercache 
pg_cancel_backend, 服务 器 信号 函数 
pg_cast, pg_cast 

pg_class, pg_class 

pg_client_encoding, FS WAAR ER 
pg_collation, pg_collation 
pg_collation_is visible, 系统 信息 函数 
pg_column_size, 数据 库 对 象 管理 函数 
pg_config, pg_config 

和 ecpg, 义理 代入 的 SQL 程序 

with libpq, 制作 libpq 程 序 

with user-defined C functions, 书写 代码 
pg_conf load time, 系统 信息 函数 
pg_constraint, pg_constraint 
pg_controldata, pg_controldata 
pg_conversion, pg_conversion 
pg_conversion_is visible, 系统 信息 男 数 
pg_create_restore_point, 各 份 控制 男 数 
pg_ctl, 创建 数据 库 集群 , 启动 数据 库 服务 器 , pg_ct 
pg_current_xlog_insert_location, 各 份 控制 西数 
pg_current_xlog_location, 各 份 控制 函数 
pg_cursors, pg_cursors 

pg_database, 模板 数据 库 , pg_database 
pg_database_size, 数据 库 对 象 管理 函数 
pg_db_role_ setting, pg_ db role setting 
pg_default_acl, pg_default_acl 


pg_depend, pg_depend 
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pg_describe_object, 系统 信息 函数 
pg_description, pg_description 
pg_dump, pg_ dump 
pg_dumpall, pg_dumpall 

在 升级 期 间 使 用 , 通过 pg_dump 升 级 数据 

pg_enum, pg_enum 

pg_event_trigger, pg_event trigger 
pg_event_trigger_dropped_objects, 事件 触发 函数 
pg_export_snapshot, 快照 同步 男 数 

pg_extension, pg_extension 
pg_extension_config_dump, 扩展 配置 表 
pg_foreign_data_wrapper, pg_foreign_data_wrapper 
pg_foreign_server, pg_foreign_server 
pg_foreign_table, pg_foreign_table 

pg_freespace, 函数 

pg_freespacemap, pg_freespacemap 
pg_function_is_ visible, 系统 信息 函数 
pg_get_constraintdef, 系统 信息 函数 

pg_get_expr, 系统 信息 函数 

pg_get_functiondef, #24/5 SNM 
pg_get_function_arguments, 系统 信息 函数 
pg_get_function_identity_arguments, 系统 信息 函数 
pg_get_function_result, 系统 信息 函数 
pg_get_indexdef, 系统 信息 函数 

pg_get_keywords, R218 BEŽI 

pg_get_ruledef, 系统 信息 函数 


we 


pg_get_serial_sequence, 系统 信息 画 数 


pg_get_triggerdef, 系统 信息 函数 
pg_get_userbyid, 系统 信息 函数 
pg_get_viewdef, 系统 信息 函数 

pg_group, pg_group 

pg_has_role, 系统 信息 函数 

pg_hba.conf, pg_hba.conf 文 件 
pg_ident.conf, 用 户 名 映射 
pg_identify_object, #24/5 SKY 

pg_index, pg_index 

pg_indexes, pg_indexes 

pg_indexes_ size, 数据 库 对 象 管理 函数 
pg_inherits, pg_inherits 

pg_isready, pg_isready 

pg_is_in_backup, 4(7 FEHI 2% 
pg_is_in_recovery, 恢复 控制 西数 
pg_is_other_ temp_schema, 系统 信息 函数 
pg_is_xlog_replay_paused, 恢复 控制 西数 
pg_language, pg_language 

pg_largeobject, pg_largeobject 
pg_largeobject_metadata, pg_largeobject_metadata 
pg_last_xact_replay_timestamp, 恢复 控制 西数 
pg_last_xlog_receive_location, 恢复 控制 函数 
pg_last_xlog_replay_location, 恢复 控制 函数 
pg_listening_channels, 系统 信息 函数 
pg_locks, pg_locks 

pg_ls_dir #8 FASC iz i] EX 


pg_matviews, pg_matviews 


pg_my_temp_schema, 系统 信息 画 数 
pg_namespace, pg_namespace 
pg_notify pg_notify 

pg_opclass, pg_opclass 
pg_opclass_is_visible, 系统 信息 函数 
pg_operator pg_operator 
pg_operator is_visible, 系统 信息 函数 
pg_opfamily pg_opfamily 
pg_opfamily_is_visible, 系统 信息 函数 
pg_options_to_table, 系统 信息 函数 
pg_pltemplate, pg_pltemplate 


pg_postmaster_start_time, 系统 信息 西 


pg_prepared_statements, pg_prepared_statements 


pg_prepared_xacts, pg_prepared_xacts 


Pg_proc, pg_ proc 


pg_range, pg_range 


pg_read_binary_file, 38-334 i% j>)| EX 


pg_read_file, #8 A X> i] EX 
pg_receivexlog, pg_receivexlog 
pg_relation_filenode, 数据 库 对 象 管理 区 
pg_relation_filepath, 数据 库 对 象 管理 区 
pg_relation_size, 数据 库 对 象 管理 函数 
pg_reload_conf, 服务 器 信号 函数 
pg_relpages, 西数 

pg_resetxlog, pg_resetxlog 
pg_restore, pg_restore 


pg_rewrite, pg_rewrite 


E 


E 


pg_roles, pg_roles 

pg_rotate_logfile, IR 42718 5 NX 

pg_rules, pg_rules 

pg_seclabel, pg_seclabel 

pg_seclabels, pg_seclabels 

pg_service.conf, 连接 服务 的 文件 

pg_settings, pg_settings 

pg_shadow, pg_shadow 

pg_shdepend, pg_shdepend 

pg_shdescription, pg_shdescription 
pg_shseclabel, pg_shseclabe| 

pg_size_pretty, 数据 库 对 象 管理 函数 

pg_sleep, 延 时 执行 

pg_standby, pg_standby 

pg_start_backup, 各 份 控制 西数 
pg_statio_all_indexes, 查看 收集 到 的 统计 信息 
pg_statio_all_sequences, 查看 收集 到 的 统计 信息 
pg_statio_all_tables, 查看 收集 到 的 统计 信息 
pg_statio_sys_indexes, 查看 收集 到 的 统计 信息 
pg_statio_sys_sequences, 查看 收集 到 的 统计 信息 
pg_statio_sys_tables, 查看 收集 到 的 统计 信息 
pg_statio_user_indexes, 查看 收集 到 的 统计 信息 
pg_statio_user_sequences, 查看 收集 到 的 统计 信息 
pg_statio_user_tables, 查看 收集 到 的 统计 信息 
pg_statistic, 规划 器 使 用 的 统计 信息 , pg_statistic 
pg_stats, 规划 器 使 用 的 统计 信息 , pg_stats 


pg_stat_activity, 查看 收集 到 的 统计 信息 
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pg_stat_all_indexes, 查看 收集 到 的 统计 信息 
pg_stat_all_tables, 查看 收集 到 的 统计 信息 
pg_stat_bgwriter, 查看 收集 到 的 统计 信息 
pg_stat_clear_snapshot, 统计 西数 
pg_stat_database, 查看 收集 到 的 统计 信息 
pg_stat_database_conflicts, 查看 收集 到 的 统计 信息 
pg _stat file, 通用 文件 访问 函数 
pg_stat_get_activity, 统计 函数 
pg_stat_replication, 查看 收集 到 的 统计 信息 
pg_stat_reset, 统计 函数 

pg_stat_reset_shared, 4 i+ 2% 
pg_stat_reset_single_function_counters, 统计 函数 
pg_stat_reset_single_table_counters, 统计 西数 
pg_stat_statements, pg_stat_statemenis 
pg_stat_statements_reset, 52% 
pg_stat_sys_indexes, 查看 收集 到 的 统计 信息 
pg_stat_sys tables, 查看 收集 到 的 统计 信息 
pg_stat_user_functions, 查看 收集 到 的 统计 信息 
pg_stat_user_indexes, 查看 收集 到 的 统计 信息 
pg_stat_user_tables, 查看 收集 到 的 统计 信息 
pg_stat_xact_all_tables, 查看 收集 到 的 统计 信息 
pg_stat_xact_sys tables, 查看 收集 到 的 统计 信息 
pg_stat_xact_user_functions, 查看 收集 到 的 统计 信息 
pg_stat_xact_user_tables, 查看 收集 到 的 统计 信息 
pg_stop_backup, 各 份 控制 函数 

pg_switch_xlog, 各 份 控制 西数 


pg_tables, pg_tables 


pg_tablespace, pg_tablespace 
pg_tablespace_databases, 44/5 SMX 
pg_tablespace_location, 系统 信息 函数 
pg_tablespace_size, 数据 库 对 象 管理 函数 
pg_table_is visible, 系统 信息 函数 
pg_table_size, 数据 库 对 象 管理 函数 
pg_temp, 语句 行为 

HA, 编写 安全 的 SECURITY DEFINER EX 
pg_terminate_backend, 服务 器 信号 函数 
pg_test_fsync, pg_ test fsync 
pg_test_timing, pg_test_timing 
pg_timezone_abbrevs, pg_timezone_abbrevs 
pg_timezone_names, pg_timezone_names 
pg_total_relation_size, 数据 库 对 象 管理 函数 
pg_trgm, pg_trgm 
pg_trigger, pg_trigger 
pg_try_advisory_lock, %34 44 2X 
pg_try_advisory_lock_shared, %34 i 2X 
pg_try_advisory_xact_lock, 4i4 44 IŽ% 
pg_try_advisory_xact_lock_shared, 4 i442 
pg_ts config, pg_ts_config 
pg_ts_config_is visible, 系统 信息 函数 
pg_ts_config map, pg_ts config map 
pg_ts_dict, pg_ts dict 
pg_ts_dict_is visible, 系统 信息 函数 
pg_ts_parser, pg_ts_parser 


pg _ts parser_is visible, 系统 信息 函数 


pg_ts template, pg_ ts template 

pg_ts template_is visible, 系统 信息 函数 
pg_type, pg_type 

pg_typeof, 系统 信息 函数 

pg_type_is visible, 42/5 SX 
pg_upgrade, pg_ upgrade 

pg_user, pg_user 

pg_user_mapping, pg_user_mapping 
pg_user_mappings, pg_user_mappings 
pg_views, pg_views 

pg_xlogdump, pg_xlogdump 
pg_xlogfile_ name, 备份 控制 函数 
pg_xlogfile_name_offset, 各 份 控制 西数 
pg_xlog_location_diff, 各 份 控制 西数 
pg_xlog_replay_pause, 恢复 控制 函数 
pg_xlog_replay_resume, 恢复 控制 画 数 
phantom read, 事务 隔离 

pi, 数学 函数 和 操作 符 

PIC, 编译 和 链接 动态 加 载 的 函数 

PID 

确定 服务 器 进程 的 PID 

在 libpq 中 , 连接 状态 函数 

PITR, 各 份 与 恢复 

PITR standby, 高 可 用 性 与 负载 均衡 ， 复 制 
pkg-config 

和 ecpg, 义理 做 入 的 SQL 程序 


with libpq, 制作 libpq 程 序 


PL/Perl, PL/Perl - Perl 过 程 语言 

PL/PerlU, 可 信 的 和 不 可 信 的 PL/Perl 

PL/pgSQL, PL/pgSQL - SQL 过 程 语言 
PL/Python, PL/Python - Python it i245 
PL/SQL (Oracle) 

porting to PL/pgSQL, 从 Oracle PL/SQL 进行 移植 
PL/Tcl, PL/Tcl - Tcl 过 程 语 言 

plainto_tsquery, 文本 检索 函数 和 操作 符 , 解析 查询 
plperl.on_init 配置 参数 , 配置 
plperl.on_plperlu_init 配置 参数 , 配置 
plperl.on_plperl_init 配置 参数 , 配置 
plperl.use_strict 配置 参数 , 配置 
plpgsql.variable_conflict configuration parameter, 变量 蔡 换 
point, 几何 函数 和 操作 符 

point-in-time recovery, 各 份 与 恢复 

polygon, 几何 函数 和 操作 符 

polymorphic function, 多 态 类 型 

polymorphic type, 多 态 类 型 

popen, 几何 函数 和 操作 符 

populate_record, hstore 操作 符 和 男 数 

port, 参数 关键 字 

port configuration parameter, 连接 设置 

position, FERARI, 二 进 制 字 符 串 函数 和 操作 符 


POSTGRES, Berkeley 的 POSTGRES 项 目 , 体系 基本 概念 ， 
库 , postgres 


postgres 用 户 , PostgreSQL 用 户 账户 


Postgres95, Postgres95 
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启动 数据 库 服务 器 , 创建 一 个 数据 


postgresql.conf, 通过 配置 文件 设置 参数 
postgres_ fdw, postgres fdw 


postmaster, postmaster 


power, 数学 函数 和 操作 符 

PQbackendPID, 连接 状态 函数 
PQbinaryTuples, 检索 查询 结果 信息 

with COPY, 与 COPY 命 令 相 关 的 函数 
PQcancel, 取消 正在 处 理 的 查询 

PQclear, 主 西 数 

PQclientEncoding, 控制 西数 

PQcmdStatus, 检索 其 它 命令 的 结果 信息 
PQcmdTuples, 检索 其 它 命令 的 结果 信息 
PQconndefaults, 数据 库 连 接 控制 丁 数 
PQconnectdb, 数据 库 连 接 控制 函数 
PQconnectdbParams, 数据 库 连 接 控制 函数 
PQconnectionNeedsPassword, 连接 状态 范 数 
PQconnectionUsedPassword, 连接 状态 男 数 
PQconnectPoll, 数据 库 连 接 控制 函数 
PQconnectStart, 数据 库 连 接 控 制 函数 
PQconnectStartParams, 数据 库 连 接 控制 函数 
PQconninfo, 数据 库 连 接 控 制 西数 
PQconninfoFree, 各 种 函数 
PQconninfoParse, 数据 库 连 接 控制 函数 
PQconsumelnput, 异步 命令 义理 
PQcopyResult, 各 种 函数 


PQdb, 连接 状态 男 数 


post_auth_delay configuration parameter, 开发 人 员 选 项 
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PQdescribePortal, + KJ% 

PQdescribePrepared, = FIŻ% 

PQencryptPassword, 各 种 函数 

PQendcopy, 用 于 COPY 的 废弃 的 函数 
PQerrorMessage, 连接 状态 函数 

PQescapeBytea, 逃逸 包含 在 SQL 命令 中 的 字符 串 
PQescapeByteaConn, 逃逸 包含 在 SQL 命令 中 的 字符 串 
PQescapeldentifier, 逃逸 包含 在 SQL 命令 中 的 字符 串 
PQescapeLiteral, 逃逸 包含 在 SQL 命令 中 的 字符 串 
PQescapeString, 逃逸 包含 在 SQL 命令 中 的 字符 串 
PQescapeStringConn, 逃逸 包含 在 SQL 命令 中 的 字符 串 
PQexec, 主 西 数 

PQexecParams, 主 西数 

PQexecPrepared, 主 西 数 

PQfformat, 检索 查询 结果 信息 

with COPY, 与 COPY 命 令 相 关 的 函数 

PQfinish, 数据 库 连 接 控制 函数 
PQfireResultCreateEvents, 各 种 男 数 

PQflush, 异步 命 分 处 理 

PQfmod, 检索 查询 结果 信息 

PQfn, 捷径 接口 

PQfname, 检索 查询 结果 信息 

PQfnumber, 检索 查询 结果 信息 

PQfreeCancel, 取消 正在 处 理 的 查询 

PQfreemem, 各 种 函数 

PQfsize, 检索 查询 结果 信息 


PQftable, 检索 查询 结果 信息 
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PQftablecol, 检索 查询 结果 信息 
POftype, 检索 查询 结果 信息 
PQgetCancel, 取消 正在 处 理 的 查询 
PQgetCopyData, 用 于 接收 COPY 数 据 的 函数 
PQgetisnull, 检索 查询 结果 信息 
PQgetlength, 检索 查询 结果 信息 
PQgetline, 用 于 COPY 的 废弃 的 函数 
PQgetlineAsync, 用 于 COPY 的 废弃 的 函数 
PQgetResult, 异步 命令 处 理 

PQgetssl, 连接 状态 函数 

PQgetvalue, 检索 查询 结果 信息 
PQhost, 连接 状态 函数 
PQinitOpenSSL, SSL 库 初 始 化 
PQinitSSL, SSL 库 初 始 化 
PQinstanceData, 事件 支持 函数 
PQisBusy, 异步 命 全 处 理 
PQisnonblocking, 异步 命 全 处 理 
PQisthreadsafe, 在 多 线程 程序 里 的 行为 
PQlibVersion, 各 种 函数 

see also PQserverVersion 
PQmakeEmptyPGresult, 各 种 函数 
PQnfields, 检索 查询 结果 信息 

with COPY, 与 COPY 命 令 相 关 的 函数 
PQnotifies, 异步 通知 

PQnparams, 检索 查询 结果 信息 
PQntuples, 检索 查询 结果 信息 


PQoidStatus, 检索 其 它 命 合 的 结果 信息 
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PQoidValue, 检索 其 它 命令 的 结果 信息 
PQoptions, 连接 状态 函数 
PQparameterStatus, 连接 状态 函数 
PQparamtype, 检索 查询 结果 信息 
PQpass, 连接 状态 函数 

PQping, 数据 库 连 接 控制 函数 
PQpingParams, 数据 库 连 接 控制 函数 
PQport, 连接 状态 函数 

PQprepare, 主 西 数 

PQprint, 检索 查询 结果 信息 
PQprotocolVersion, 连接 状态 函数 
PQputCopyData, 用 于 发 送 COPY 数 据 的 函数 
PQputCopyEnd, 用 于 发 送 COPY 数 据 的 函数 
PQputline, 用 于 COPY 的 废弃 的 函数 
PQputnbytes, 用 于 COPY 的 文 弃 的 函数 
PQregisterEventProc, 事件 支持 函数 
PQrequestCancel, 取消 正在 处 理 的 查询 
PQreset, 数据 库 连 接 控制 函数 
PQresetPoll, 数据 库 连 接 控 制 画 数 
PQresetStart, 数据 库 连 接 控制 丁 数 
PQresStatus, = 2% 

PQresultAlloc, 各 种 西数 
PQresultErrorField, = 52% 
PQresultErrorMessage, = i 2% 
PQresultInstanceData, 事件 支持 函数 
PQresultSetlnstanceData, 事件 支持 函数 


PQresultStatus, = HŽ% 


PQsendDescribePortal, 异步 命令 处 理 
PQsendDescribePrepared, = 27 tira wE 
PQsendPrepare, 异步 命令 义理 
PQsendQuery, 异步 命 分 处 理 
PQsendQueryParams, =27 MA 32 
PQsendQueryPrepared, 异步 命令 义理 
PQserverVersion, 连接 状态 函数 
PQsetClientEncoding, 控制 西数 
PQsetdb, 数据 库 连 接 控制 函数 
PQsetdbLogin, 数据 库 连 接 控 制 画 数 
PQsetErrorVerbosity, 控制 函数 
PQsetInstanceData, 事件 支持 函数 
PQsetnonblocking, FEAA xE 
PQsetNoticeProcessor, 注意 信息 处 理 
PQsetNoticeReceiver, 注意 信息 人 处理 
PQsetResultAttrs, 各 种 函数 
PQsetSingleRowMode, 逐 行 检索 查询 结果 
PQsetvalue, 各 种 函数 

PQsocket, 连接 状态 画 数 

PQstatus, 连接 状态 函数 

PQtrace, 控制 函数 

PQtransactionStatus, 连接 状态 函数 
PQtty, 连接 状态 画 数 

PQunescapeBytea, 逃逸 包含 在 SQL 命令 中 的 字符 串 
PQuntrace, 控制 辑 数 

PQuser, 连接 状态 函数 


predicate locking, 可 串 行 化 隔离 级 别 


PREPARE, PREPARE 

PREPARE TRANSACTION, PREPARE TRANSACTION 
preparing a query 

in PL/pgSQL, 计划 缓存 

in PL/Python, Database Access Functions 
pre_auth_delay configuration parameter, 开发 人 员 选 项 


primary_conninfo recovery parameter, 各 用 服务 右 设 年 


j 


procedural language, 过 程 语 


a 


externally maintained, 过 程 语 
ps 

to monitor activity, 标准 Unix 工 上 县 
psql, 访问 数据 库 , psql 


Python, PL/Python - Python 过 程 语 言 


Q 


query, 查询 一 个 表 

query plan, 使 用 EXPLAIN 

querytree, 文本 检索 范 数 和 操作 符 , 处 理 查询 
duotation marks 

and identifiers, 标识 符 和 关键 字 

escaping, 字符 串 常 量 

quote_all_identifiers configuration parameter, 以 前 的 PostgreSQL 版 本 
quote_ident, 字符 串 画 数 和 操作 符 

in PL/Perl, PL/Perl E KIR FA EH aX 

use in PL/pgSQL, 执行 动态 命 命 

quote_literal, 字符 串 函 数 和 操作 符 


in PL/Perl, PL/Perl 里 的 效用 函数 


use in PL/pgSQL, 执行 动态 命令 
quote_nullable, 字符 串 函 数 和 操作 符 
in PL/Perl, PL/Perl 里 的 效用 函数 


use in PL/pgSQL, 执行 动态 命令 


R 


radians, 数学 函数 和 操作 符 

radius, 几何 函数 和 操作 符 , RADIUS 认证 

RAISE, 错误 和 消息 

random, 数学 函数 和 操作 符 

random_page_cost configuration parameter, 规划 器 开销 常量 
rank, 窗口 函数 

read committed, 读 已 提交 隔离 级 别 

read-only transaction 

setting default, 语句 行为 

readline, 要 求 

real, 浮 点 数 类 型 

REASSIGN OWNED, REASSIGN OWNED 

record, 伪 类 型 

recovery.conf, 恢复 配置 

recovery_end_command recovery parameter, 当 档 恢复 设置 
recovery_target_inclusive recovery parameter, 恢复 目标 设置 
recovery_target_name recovery parameter, 恢复 目标 设置 
recovery_target_time recovery parameter, 恢复 目标 设置 
recovery_target_timeline recovery parameter, 恢复 目标 设置 
recovery_target_xid recovery parameter, 恢复 目标 设置 


referential integrity 外 键 
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REFRESH MATERIALIZED VIEW, REFRESH MATERIALIZED VIEW 


regclass, 对 象 标识 符 类 

regconfig, 对 象 标 识 符 类 型 

regdictionary, 对 象 标识 符 类 型 

regexp_matches, 字符 串 函 数 和 操作 符 , POSIX 正则 表达 式 
regexp_replace, 字符 串 画 数 和 操作 符 , POSIX 正则 表达 式 
regexp_split_to_array, 字符 串 函 数 和 操作 符 , POSIX 正则 表达 式 
regexp_split_to_table, 字符 串 函 数 和 操作 符 , POSIX 正则 表达 式 
regoper, 对 象 标识 符 类 

regoperator, 对 象 标识 符 类 型 

regproc, 对 象 标识 符 类 

regprocedure, 对 象 标识 符 类 型 

regression intercept, 聚集 函数 

regression slope, 聚集 函数 

regression test, 安装 过 程 

regr_avgx, 聚集 西数 

regr_avgy, 聚集 西数 
regr_count, 聚集 函数 
regr_intercept, 聚集 西数 
regr_r2, 聚集 函数 
regr_slope, 聚集 函数 
regr_sxx, 聚集 函数 
regr_sxy, 聚集 函数 

regr_syy, 聚集 函数 

regtype, 对 象 标识 符 类 型 

reindex, 经 常 重建 索引 , REINDEX 


reindexdb, reindexdpb 
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relation, 概念 

relational database, 概念 

RELEASE SAVEPOINT, RELEASE SAVEPOINT 
repeat, 43 Es ARE 

repeatable read, 可 重复 读 隔离 级 别 

replace, 字符 串 画 数 和 操作 符 

replication, 高 可 用 性 与 负载 均衡 ， 复 制 

reporting errors 

in PL/pgSQL, 错误 和 消息 

RESET, RESET 

restartpoint, WAL 配置 

restart_after_crash configuration parameter, Error Handling 
restore_command recovery parameter, 当 档 恢复 设置 
RETURN NEXT 

in PL/pgSQL, RETURN NEXT 和 RETURN QUERY 
RETURN QUERY 

in PL/pgSQL, RETURN NEXT 和 RETURN QUERY 
RETURNING INTO 

in PL/pgSQL, 执行 一 个 仅 有 单行 结果 的 查询 
reverse, FIFE RAIRE IF 

REVOKE, REVOKE 

right, 字符 串 画 数 和 操作 符 

role 

enabled, enabled_roles 

ROLLBACK, ROLLBACK 

psql, Variables 


ROLLBACK PREPARED, ROLLBACK PREPARED 


ROLLBACK TO SAVEPOINT, ROLLBACK TO SAVEPOINT 
round, 数学 函数 和 操作 符 

routine maintenance, 日 常数 据 库 维护 工作 

row, 概念 , 行 构造 器 

row estimation 

planner, 行 预期 的 例子 

row type, 复合 类 型 

constructor, 行 构造 器 

row_number, 窗口 函数 

row_to_json, JSON 函数 和 操作 符 

rpad, FIFE RRR EIF 


rtrim, AFB ES AER EI 


S 


SAVEPOINT SAVEPOINT 

scalar 

see expression 

SCO 

installation on, SCO OpenServer 和 SCO UnixWare 
SCO OpenServer 

IPC 配置 , 共享 内 存 和 信号 灯 

search_path configuration parameter, 语句 行为 
search_path 配置 参数 

ERE WA, 编写 安全 的 SECURITY DEFINER ERX 
search_path 配 置 参 数 , 模式 搜索 路 径 

SECURITY LABEL, SECURITY LABEL 


sec to_gc, 基于 立方 体 的 地 球 距离 
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seg, seg 
segment_size configuration parameter, 预 置 选项 
SELECT, 查询 一 个 表 , SELECT 

SELECT INTO, SELECT INTO 

in PL/pgSQL, 执行 一 个 仅 有 单行 结果 的 查询 

sepgsql, sepgsdql 

sepgsql.debug_audit 配置 参数 , GUC 参数 
sepgsql.permissive 配置 参数 , GUC 参数 

sequential scan, 规划 器 方法 配置 

seq_page_cost configuration parameter, 规划 器 开销 常量 
serial, 序列 号 类 型 

serial2, 序列 号 类 型 

serial4, 序列 号 类 型 

serial8, 序列 号 类 型 

serializable, 可 串 行 化 隔离 级 别 

Serializable Snapshot Isolation, 介绍 

serialization anomaly, 可 串 行 化 隔离 级 别 

server log, 错误 报告 和 日 志 

log file maintenance, 日 志文 件 维护 

server_encoding configuration parameter, 预 置 选项 
server_version configuration parameter, i E4 27 
server_version_num configuration parameter, 预 置 选项 
session_replication_role configuration parameter, 语句 行为 
SET, SET 

SET CONSTRAINTS, SET CONSTRAINTS 

SET ROLE, SET ROLE 


SET SESSION AUTHORIZATION, SET SESSION AUTHORIZATION 
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SET TRANSACTION, SET TRANSACTION 
SET XML OPTION, 语句 行为 

setseed, 数学 函数 和 操作 符 

setval, Fe JERE ES AX 

setweight, 文本 检索 函数 和 操作 符 , 操作 文档 
set_bit, 二 进 制 字符 串 函 数 和 操作 符 
set_byte, 二 进 制 字符 串 函 数 和 操作 符 
set_config, 配置 设置 西数 

set_limit, 函数 和 操作 符 

set_masklen, 网 络 地 址 函数 和 操作 符 

shared library, 共享 库 , 编译 和 链接 动态 加 载 的 函数 
shared_buffers configuration parameter, 内 存 
shared_preload_libraries, 共享 内 存 和 LWLocks 
shared_preload_libraries configuration parameter, 内 核资 源 使 用 
shobj_description, 系统 信息 函数 

SHOW, SHOW 

show limit, ZX AIRE FF 

show_trgm, EX 2X FER VE 

SIGHUP, pg_hba.conf 文 件 , 用 户 名 映射 
SIGINT, 关闭 服务 器 

sign, 数学 函数 和 操作 符 

significant digits, 区 域 和 格式 化 

SIGQUIT 关闭 服务 器 

SIGTERM, 关闭 服务 器 

SIMILAR TO, SIMILAR TO 正则 表达 式 
similarity, 函数 和 操作 符 

sin, 数学 函数 和 操作 符 
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skeys, hstore 操作 符 和 郴 数 
sleep, 延 时 执行 

slice, hstore #R/E TF AEX 
sliced bread 

see TOAST 

smallint, 整数 类 型 
smallserial, 序列 号 类 型 
Solaris 

installation on, Solaris 


IPC 配置 , 共享 内 存 和 信号 灯 


shared library, 编译 和 链接 动态 加 载 的 范 数 


启动 脚本 , 启动 数据 库 服务 器 


SOME, RRK, 子 查询 表达 式 , 行 和 数组 比较 


sort, intarray 函数 和 操作 符 
sort_asc, intarray 函数 和 操作 符 
sort_desc, intarray 函数 和 操作 符 
soundex, Soundex 

SP-GiST 

see 索引 

SPI, 服务 器 编程 接口 

例子 , spi 

SPI_connect, SPI_connect 

SPI copytuple, SPI_copytuple 

SPI_ cursor_close, SP|_cursor_close 
in PL/Perl, 从 PL/Perl 访 问 数据 库 
SPI_cursor_fetch, SPI| cursor _ fetch 


SPI_cursor find, SPl_cursor_find 
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SPl_cursor_move, SPI_cursor_move 

SPI_cursor_open, SP|_cursor_open 
SPI_cursor_open_with_args, SP| cursor open with args 
SPI_cursor_open_with_paramlist, SPI| cursor_open_with_paramiist 
SPI_exec, SP| exec 

SPI_execp, SPI_execp 

SPI_execute, SP| execute 

SPI_execute_plan, SPI_execute plan 
SPI_execute_plan_with_paramlist, SP!_execute_plan_with_paramlist 
SPI_execute_with_args, SP!|_execute_with_args 
spi_exec_prepared 

in PL/Perl, 从 PL/Perl 访 问 数据 库 

spi_exec_query 

in PL/Perl, 从 PL/Perl 访 问 数据 库 

spi_fetchrow 

in PL/Perl, 从 PL/Perl 访 问 数据 库 

SPI_finish, SPI_finish 

SPI_fname, SPI fname 

SPI fnumber, SPI_fnumber 

SPI freeplan, SPI freeplan 

in PL/Perl, 从 PL/Perl 访 问 数据 库 

SPI freetuple, SPI_freetuple 

SPI_freetuptable, SP|_ freetuptable 

SPI_getargcount, SPI_ getargcount 

SPI_getargtypeid, SP| getargtypeid 

SPI_getbinval, SP|_ getbinval 


SPI_getnspname, SPI_getnspname 


SPI_getrelname, SPI_ getrelname 
SPI_gettype, SPI_gettype 

SPI_gettypeid, SPI_gettypeid 

SPI_getvalue, SPI getvalue 
SPI_is_cursor_plan, SPI_is_cursor_plan 
SPI_keepplan, SPI keepplan 

spi_lastoid, 在 PL/Tcl 里 访问 数据 库 
SPI_modifytuple, SPI modifytuple 
SPI_palloc, SPI_palloc 

SPI_pfree, SPI_pfree 

SPI_pop, SPI_pop 

SPI_prepare, SPI_prepare 

in PL/Perl, 从 PL/Perl 访 问 数据 库 
SPI_prepare_cursor, SPI_prepare_cursor 
SPI_prepare_params, SPI_prepare_params 
SPI_push, SPI_push 

spi_query 

in PL/Perl, 从 PL/Perl 访 问 数据 库 
spi_query_prepared 

in PL/Perl, 从 PL/Perl 访 问 数据 库 
SPI_repalloc, SPI_repalloc 

SPI_returntuple, SPI_returntuple 
SPI_saveplan, SPI saveplan 
SPI_scroll_cursor_fetch, SPI_ scroll_cursor fetch 
SPI_scroll_cursor_move, SP| scroll _ cursor move 
split_part, 字符 串 画 数 和 操作 符 


SQL/CLI, SQL 兼容 性 
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SQL/Foundation, SQL 兼容 性 

SQL/Framework, SQL 兼容 性 

SQL/JRT, SQL 兼容 性 

SQL/MED, SQL 兼容 性 

SQL/OLB, SQL 兼容 性 

SQL/PSM, SQL 兼容 性 

SQL/Schemata, SQL 兼容 性 

SQL/XML, SQL 兼容 性 

sql_inheritance configuration parameter, 以 前 的 PostgreSQL 版 本 
sqrt, FES AER ET 

ssh, 用 SSH 险 道 进行 安全 TCP/IP 连接 

SSI, 介绍 

SSL, 用 SSL 进行 安全 的 TCP/IP 连接 , SSL 支持 
with libpq, 参数 关键 字 , 连接 状态 函数 

ssl configuration parameter, 安全 和 认证 

sslinfo, sslinfo 

ssl_ca_file configuration parameter, 安全 和 认证 
ssl_cert_file configuration parameter, 安全 和 认证 
ssl_cipher, 提供 的 函数 

ssl_ciphers configuration parameter, 安全 和 认证 
ssl_client_cert_present, 提供 的 西数 
ssl_client_dn, 提供 的 函数 

ssl_client_dn_field, 提供 的 函数 
ssl_client_serial, 提供 的 函数 

ssl_crl_file configuration parameter, 安全 和 认证 
ssl_issuer_dn, 提供 的 函数 


ssl issuer field, 提供 的 函数 


ssl_is_used, 提供 的 函数 

ssl_key file configuration parameter, 安全 和 认证 
ssl_renegotiation limit configuration parameter, 安全 和 认证 
ssl_version, 提供 的 函数 

SSPI, SSPI 认证 

STABLE, 函数 易 失 性 范畴 

standard deviation, 聚集 西数 

population, 聚集 函数 

sample, Re HA 

standard_conforming_strings configuration parameter, 以 前 的 PostgreSQL 版 本 
standby server, 高 可 用 性 与 负载 均衡 ， 复 制 

standby_mode recovery parameter, 各 用 服务 右 设 置 
START TRANSACTION, START TRANSACTION 
statement_timeout configuration parameter, 语句 行为 
statement_timestamp, #4 0) / A BAR AN ARE 

statistics, 统计 收集 器 

of the planner, 规划 器 使 用 的 统计 信息 , 更 新 规划 器 统计 
stats_temp_directory configuration parameter, 查询 和 索引 统计 收集 器 
stddev, 聚集 函数 

stddev_pop, 聚集 西数 

stddev_samp, 聚集 西数 

STONITH, 高 可 用 性 与 负载 均衡 ， 复 制 

Streaming Replication, 高 可 用 性 与 负载 均衡 ， 复 制 

strings 

backslash quotes, 以 前 的 PostgreSQL 版 本 

escape warning, 以 前 的 PostgreSQL 版 本 


standard conforming, 以 前 的 PostgreSQL 版 本 


string_agg, 聚集 函数 

string_to_array, 数组 函数 和 操作 符 

strip, 文本 检索 函数 和 操作 符 , 操作 文档 

strpos, 字符 串 函 数 和 操作 符 

subarray, intarray RAPE VE 

subltree, 操作 符 和 画 数 

subpath, 操作 符 和 男 数 

subquery, RRMA, 标量 子 查询 , 子 查询 表达 式 

subscript, 下 标 

substr, 字符 串 画 数 和 操作 符 

substring, 字符 串 函 数 和 操作 符 , 二 进 制 字符 串 函 数 和 操作 符 , POSIX 正则 表达 式 
sum, 聚集 函数 

superuser, 访问 数据 库 

superuser_reserved_connections configuration parameter, 连接 设置 
suppress_redundant_updates trigger, 触发 器 函数 

svals, hstore REFFI HEX 

synchronize_seqscans configuration parameter, 以 前 的 PostgreSQL 版 本 
Synchronous Replication, 高 可 用 性 与 负载 均 衔 ， 复 制 
synchronous_commit configuration parameter, 设置 
synchronous_standby_names configuration parameter, 主 服务 器 
syntax 

SQL, SQL 语法 

syslog_facility configuration parameter, 在 哪里 记录 日 志 


syslog_identity configuration parameter, 在 哪里 记录 日 志 


T 


table, 概念 


TABLE command, SELECT 

tablefunc, tablefunc 

tableoid, 系统 字段 

tablespace 

default, 语句 行为 

temporary, 语句 行为 

tan, 数学 函数 和 操作 符 

Tcl, PL/Tcl - Tel 过 程 语 言 

tcn, tcn 

tcp_keepalives_count configuration parameter, 连接 设置 
tcp_keepalives_idle configuration parameter, 连接 设置 
tcp_keepalives_interval configuration parameter, 连接 设置 
templated, 模板 数据 库 

template1, 创建 一 个 数据 库 , 模板 数据 库 
temp_buffers configuration parameter, 内 存 
temp_file_limit configuration parameter, 4 & 
temp_tablespaces configuration parameter, 语句 行为 
test_parser, test parser 

text, 字符 类 型 , 网 络 地 址 函数 和 操作 符 

text search, 全 文 检索 

indexes, GiST 和 GIN 索 引 类 型 

text2ltree, H/F AF AEX 

tid, 对 象 标 识 符 类 

time zone, 区 域 和 格式 化 

input abbreviations, 日 期 /时 间 配 置 文件 

time zone data, 安装 过 程 


time zone names, 区 域 和 格式 化 


timelines, 备份 与 恢复 

timeofday, 时 间 / 日 期 范 数 和 操作 符 

timeout 

client authentication, 安全 和 认证 

deadlock, 锁 管理 

timestamptz, 日 期 /时 间 类 型 

TimeZone configuration parameter, 区 域 和 格式 化 
timezone_abbreviations configuration parameter, 区 域 和 格式 化 
TOAST, TOAST 

and user-defined types, 用 户 定 义 类 型 

per-column storage settings, 描述 

versus large objects, 介绍 

token, 词法 结构 

to_ascii, 字符 串 画 数 和 操作 符 

to_char, 数据 类 型 格式 化 画 数 

and locales, 行为 

to_date, 数据 类 型 格式 化 函数 

to_hex, 字符 串 画 数 和 操作 符 

to_json, JSON KNR IE 

to_number, 数据 类 型 格式 化 函数 

to_timestamp, 数据 类 型 格式 化 函数 

to_tsquery, 文本 检索 范 数 和 操作 符 , 解析 查询 
to_tsvector, 文本 检索 函数 和 操作 符 , 解析 文档 
trace_locks configuration parameter, 开发 人 员 选 项 
trace_lock_oidmin configuration parameter, 开发 人 员 选 项 
trace_lock_table configuration parameter, 开发 人 员 选 项 


trace_lwlocks configuration parameter, 开发 人 员 选 项 


trace_notify configuration parameter, 开发 人 员 选 项 
trace_recovery_messages configuration parameter, 开发 人 员 选 项 
trace_sort configuration parameter, 开发 人 员 选 项 
trace_userlocks configuration parameter, 开发 人 员 选 项 
track_activities configuration parameter, 查询 和 索引 统计 收集 器 
track_activity_query_size configuration parameter, 查询 和 索引 统计 收集 器 
track_counts configuration parameter, 查询 和 索引 统计 收集 器 
track_functions configuration parameter, 查询 和 索引 统计 收集 器 
track_io_timing configuration parameter, 查询 和 索引 统计 收集 器 
transaction, 事务 

transaction ID 

wraparound, HRE 41D 4 je AB j] 2 

transaction isolation, 事务 隔离 

transaction isolation level, 事务 隔离 

read committed, 读 已 提交 隔离 级 别 

repeatable read, 可 重复 读 隔离 级 别 

serializable, 可 串 行 化 隔离 级 别 

setting default, 语句 行为 

transaction_timestamp, 时 间 / 日 期 丁 数 和 操作 符 
transform_null_equals configuration parameter, 平台 和 客户 端 兼容 
translate, FF ERRIRE 

trigger, 14 % Æ, 触发 器 

arguments for trigger functions, 触发 器 行为 概述 

for updating a derived tsvector column, 自动 更 新 的 触发 器 

in C, ACS Ak & 25 

in PL/pgSQL, 触发 器 过 程 


in PL/Python, Trigger Functions 
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triggered_change_notification, tcn 

trigger_file recovery parameter, 备用 服务 器 设置 
trim, 字符 串 函 数 和 操作 符 , 二 进 制 字符 串 函 数 和 操作 符 
Tru64 UNIX 

shared library, 编译 和 链接 动态 加 载 的 范 数 

true, 布尔 类 型 

trunc, 数学 函数 和 操作 符 , 网 络 地 址 画 数 和 操作 符 
TRUNCATE, TRUNCATE 

tsearch2, tsearch2 

tsquery (数据 类 型 ), tsquery 

tsvector (数据 类 型 ), tsvector 

tsvector concatenation, 操作 文档 
tsvector_update_trigger, 文本 检索 函数 和 操作 符 
tsvector_update_trigger_column, 文本 检索 函数 和 操作 符 
ts_debug, 文本 检索 函数 和 操作 符 , 配置 测试 
ts_headline, 文本 检索 图 数 和 操作 符 , 强调 结果 
ts_lexize, MAH SRR ET, 词典 测试 
ts_parse, 文本 检索 函数 和 操作 符 , 解析 器 测试 

ts_rank, 文本 检索 函数 和 操作 符 , 查询 结果 关注 度 
ts_rank_cd, MA REKREI, 查询 结果 关注 度 
ts_rewrite, RARE MARIA, 查询 重 写 
ts_stat, 文本 检索 函数 和 操作 符 , 收集 文献 统计 
ts_token_type, 文本 检索 函数 和 操作 符 , 解析 器 测试 
txid_current, 系统 信息 函数 

txid_current_snapshot, 系统 信息 函数 
txid_snapshot_xip, 系统 信息 函数 


txid_snapshot_xmax, 系统 信息 函数 
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txid_snapshot_xmin, 系统 信息 函数 
txid_visible_in_snapshot, 系统 信息 画 数 
type 


polymorphic, 多 态 类 型 


type cast, 数值 常量 , 类 型 转换 


U 


UESCAPE, 标识 符 和 关键 字 , Unicode 逃 逸 字符 串 常 量 
unaccent, unaccent, EN 2 
Unicode escape 


in identifiers, 标识 符 和 关键 字 


fala 


in string constants, Unicode kt FAES 
UNION 

确定 结果 类 型 , UNION, CASE 和 相关 构造 
uniq, intarray EEX AER EFT 

Unix HERS, 参数 天 键 字 

UnixWare 

installation on, SCO OpenServer 和 SCO UnixWare 

IPC 配置 , 共享 内 存 和 信号 灯 

shared library, 编译 和 链接 动态 加 载 的 函数 
unix_socket_directories configuration parameter, 连接 设置 
unix_socket_group configuration parameter, 连接 设置 
unix_socket_permissions configuration parameter, 连接 设置 
UNLISTEN, UNLISTEN 

unnest, 数组 函数 和 操作 符 

UPDATE, 更 新 , 更 新 数据 , UPDATE 


update_process_title configuration parameter, 查询 和 索引 统计 收集 器 


updating, 更 新 数据 

upper, 字符 串 函 数 和 操作 符 , 范围 画 数 和 操作 符 
和 区 域 , 行为 

upper_inc, 范围 男 数 和 操作 符 

upper_inf, 范围 画 数 和 操作 符 

URI, 连接 字符 串 

UUID, UUID 类 型 , 安装 过 程 

uuid-ossp, uuid-ossp 

uuid_generate_v1, uuid-ossp AX 
uuid_generate_v1mc, uuid-ossp 2% 


uuid_generate_v3, uuid-ossp AX 


V 


vacuum, 日 常 清理 , VACUUM 

vacuumdb, vacuumdb 

vacuumlo, vacuumlo 

vacuum_cost_delay configuration parameter, 基于 开销 的 清理 延迟 
vacuum_cost_limit configuration parameter, 基于 开销 的 清理 延迟 
vacuum_cost_page_dirty configuration parameter, 基于 开销 的 清理 延迟 
vacuum_cost_page_hit configuration parameter, 基于 开销 的 清理 延迟 
vacuum_cost_page_miss configuration parameter, 基于 开销 的 清理 延迟 
vacuum_defer_cleanup_age configuration parameter, 主 服 务 器 
vacuum_freeze_min_age configuration parameter, 语句 行为 
vacuum_freeze_table_age configuration parameter, 语句 行为 

value expression, 值 表达 式 

VALUES, VALUES 列 表 , VALUES 


确定 结果 类 型 , UNION, CASE 和 相关 构造 


varchar, 字符 类 型 

variadic function, 带 有 参数 可 变数 量 的 SQL 
variance, 聚集 西数 

population, 聚集 函数 

sample, 聚集 函数 

var_pop, 聚集 西数 

var_samp, 聚集 西数 

version, 访问 数据 库 , 系统 信息 函数 
view, 视图 

Visibility Map, 可 见 映射 

VM 

see Visibility Map 

void, 伪 类 型 

VOLATILE, 函数 易 失 性 范畴 
volatility 

functions, HAA AMS 


VPATH, 安装 过 程 


W 


WAL, 可 靠 性 和 预 写 式 日 志 

wal_block_size configuration parameter, 预 秆 选项 

wal_buffers configuration parameter, 设置 

wal_debug configuration parameter, 开发 人 员 选 项 
wal_keep_segments configuration parameter, 发 送 服务 器 
wal_level configuration parameter, izi= 
wal_receiver_status_interval configuration parameter, 4 lz 425 


wal_receiver_timeout configuration parameter, 4 FH fk 425 


wal_segment_size configuration parameter, #i is i 27 
wal_sender_timeout configuration parameter, 发 送 服务 器 
wal_sync_method configuration parameter, 设置 
wal_writer_delay configuration parameter, 设置 
warm standby, 高 可 用 性 与 负载 均衡 ， 复 制 

WHERE, WHERE 子 句 

where to log, 在 哪里 记录 日 志 

WHILE 

in PL/pgSQL, WHILE 

width, 几何 函数 和 操作 符 

width_bucket, 数学 函数 和 操作 符 

window function, 窗口 函数 

invocation, 窗口 调用 函数 

WITH 

in SELECT, WITH 查询 (通用 表 表 达 式 ), SELECT 
witness server, 高 可 用 性 与 负载 均衡 ， 复 制 


work_mem configuration parameter, 内 存 


X 


xid, 对 象 标识 符 类 型 

xmax, 系统 字段 

xmin, 系统 字段 

XML, XML 类 型 

XML option, 创建 XML 值 , 语句 行为 
XML 导出 , 到 XML 的 映射 表 

xml2, xml2 


xmlagg, xmlagg, 聚集 函数 


xmlbinary configuration parameter, 语句 行为 
xmlcomment, xmicomment 

xmlconcat, xmlconcat 

xmlelement, xmlelement 

XMLEXISTS, XMLEXISTS 

xmlforest, xmlforest 

xmloption configuration parameter, 语句 行为 
xmiparse, 创建 XML 值 

xmlpi, xmlpi 

xmlroot, xmlroot 

xmliserialize, 创建 XML 值 

xml_is_well_formed, xml_is_well_formed 
xml_is_well_formed_content, xml is_well formed 
xml_is_well_formed_document, xml_is_well_formed 
XPath, 义理 XML 

xpath_exists, 处 理 XML 

xpath_table, xpath_table 


xslt_process, xslt_process 


yacc, 要 求 


zero_damaged_pages configuration parameter, 开发 人 员 选 项 


zlib, 要 求 


